From 5d42a2ec64357e8ffbca439b50c3a59840640738 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 15 Jul 2021 12:25:56 +0200
Subject: [PATCH 0001/1227] add modules for ps enhancements

---
 .gitmodules                    |  8 +++++++-
 tools/build.ps1                | 13 +++++++++----
 vendor/powershell/BurntToast   |  1 +
 vendor/powershell/PSWriteColor |  1 +
 vendor/powershell/README.md    |  0
 5 files changed, 18 insertions(+), 5 deletions(-)
 create mode 160000 vendor/powershell/BurntToast
 create mode 160000 vendor/powershell/PSWriteColor
 create mode 100644 vendor/powershell/README.md

diff --git a/.gitmodules b/.gitmodules
index 52f2fc0750..6c12c76b16 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -9,4 +9,10 @@
 	url = https://bitbucket.org/ftrack/ftrack-python-api.git
 [submodule "openpype/modules/ftrack/python2_vendor/arrow"]
 	path = openpype/modules/ftrack/python2_vendor/arrow
-	url = https://github.com/arrow-py/arrow.git
\ No newline at end of file
+	url = https://github.com/arrow-py/arrow.git
+[submodule "vendor/powershell/BurntToast"]
+    path = vendor/powershell/BurntToast
+    url = https://github.com/Windos/BurntToast.git
+[submodule "vendor/powershell/PSWriteColor"]
+    path = vendor/powershell/PSWriteColor
+    url = "https://github.com/EvotecIT/PSWriteColor.git"
\ No newline at end of file
diff --git a/tools/build.ps1 b/tools/build.ps1
index cc4253fe24..00cec54927 100644
--- a/tools/build.ps1
+++ b/tools/build.ps1
@@ -28,6 +28,13 @@ if($arguments -eq "--no-submodule-update") {
     $disable_submodule_update=$true
 }
 
+$current_dir = Get-Location
+$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+$openpype_root = (Get-Item $script_dir).parent.FullName
+
+# Install PSWriteColor to support colorized output to terminal
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+
 function Start-Progress {
     param([ScriptBlock]$code)
     $scroll = "/-\|/-\|"
@@ -110,10 +117,6 @@ Write-Host $art -ForegroundColor DarkGreen
 # Enable if PS 7.x is needed.
 # Show-PSWarning
 
-$current_dir = Get-Location
-$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
-$openpype_root = (Get-Item $script_dir).parent.FullName
-
 $env:_INSIDE_OPENPYPE_TOOL = "1"
 
 if (-not (Test-Path 'env:POETRY_HOME')) {
@@ -201,6 +204,8 @@ Write-Host "restoring current directory"
 Set-Location -Path $current_dir
 
 $endTime = [int][double]::Parse((Get-Date -UFormat %s))
+New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype build complete!", "All done in $($endTime - $startTime) secs. You will find OpenPype and build log in build directory."
+
 Write-Host "*** " -NoNewline -ForegroundColor Cyan
 Write-Host "All done in $($endTime - $startTime) secs. You will find OpenPype and build log in " -NoNewLine
 Write-Host "'.\build'" -NoNewline -ForegroundColor Green
diff --git a/vendor/powershell/BurntToast b/vendor/powershell/BurntToast
new file mode 160000
index 0000000000..ae0acdd870
--- /dev/null
+++ b/vendor/powershell/BurntToast
@@ -0,0 +1 @@
+Subproject commit ae0acdd870a2fd8d9f0d147de22dc36d6c5e399e
diff --git a/vendor/powershell/PSWriteColor b/vendor/powershell/PSWriteColor
new file mode 160000
index 0000000000..12eda384eb
--- /dev/null
+++ b/vendor/powershell/PSWriteColor
@@ -0,0 +1 @@
+Subproject commit 12eda384ebd7a7954e15855e312215c009c97114
diff --git a/vendor/powershell/README.md b/vendor/powershell/README.md
new file mode 100644
index 0000000000..e69de29bb2

From 0e6f4e330daa343b16a4b9bb1f6427eebf7706c0 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Fri, 16 Jul 2021 17:53:44 +0200
Subject: [PATCH 0002/1227] PS enhancement I.

---
 tools/build.ps1               | 63 ++++++++++--------------------
 tools/build_win_installer.ps1 | 50 ++++++++++++------------
 tools/create_env.ps1          | 72 ++++++++++++++++-------------------
 3 files changed, 79 insertions(+), 106 deletions(-)

diff --git a/tools/build.ps1 b/tools/build.ps1
index 00cec54927..89d2eac3a4 100644
--- a/tools/build.ps1
+++ b/tools/build.ps1
@@ -79,17 +79,14 @@ function Exit-WithCode($exitcode) {
 
 function Show-PSWarning() {
     if ($PSVersionTable.PSVersion.Major -lt 7) {
-        Write-Host "!!! " -NoNewline -ForegroundColor Red
-        Write-Host "You are using old version of PowerShell. $($PSVersionTable.PSVersion.Major).$($PSVersionTable.PSVersion.Minor)"
-        Write-Host "Please update to at least 7.0 - " -NoNewline -ForegroundColor Gray
-        Write-Host "https://github.com/PowerShell/PowerShell/releases" -ForegroundColor White
+        Write-Color -Text "!!! ", "You are using old version of PowerShell - ",  "$($PSVersionTable.PSVersion.Major).$($PSVersionTable.PSVersion.Minor)" -Color Red, Yellow, White
+        Write-Color -Text "    Please update to at least 7.0 - ", "https://github.com/PowerShell/PowerShell/releases" -Color Yellow, White
         Exit-WithCode 1
     }
 }
 
 function Install-Poetry() {
-    Write-Host ">>> " -NoNewline -ForegroundColor Green
-    Write-Host "Installing Poetry ... "
+    Write-Color -Text ">>> ", "Installing Poetry ... " -Color Green, Gray
     $env:POETRY_HOME="$openpype_root\.poetry"
     (Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py -UseBasicParsing).Content | python -
 }
@@ -129,8 +126,7 @@ $version_file = Get-Content -Path "$($openpype_root)\openpype\version.py"
 $result = [regex]::Matches($version_file, '__version__ = "(?<version>\d+\.\d+.\d+.*)"')
 $openpype_version = $result[0].Groups['version'].Value
 if (-not $openpype_version) {
-  Write-Host "!!! " -ForegroundColor yellow -NoNewline
-  Write-Host "Cannot determine OpenPype version."
+  Write-Color -Text "!!! ", "Cannot determine OpenPype version." -Color Yellow, Gray
   Exit-WithCode 1
 }
 
@@ -139,74 +135,57 @@ if (-not (Test-Path -PathType Container -Path "$($openpype_root)\build")) {
     New-Item -ItemType Directory -Force -Path "$($openpype_root)\build"
 }
 
-Write-Host "--- " -NoNewline -ForegroundColor yellow
-Write-Host "Cleaning build directory ..."
+Write-Color -Text "--- ", "Cleaning build directory ..." -Color Yellow, Gray
 try {
     Remove-Item -Recurse -Force "$($openpype_root)\build\*"
 }
 catch {
-    Write-Host "!!! " -NoNewline -ForegroundColor Red
-    Write-Host "Cannot clean build directory, possibly because process is using it."
-    Write-Host $_.Exception.Message
+    Write-Color -Text "!!! ", "Cannot clean build directory, possibly because process is using it." -Color Red, Gray
+    Write-Color -Text $_.Exception.Message -Color Red
     Exit-WithCode 1
 }
 if (-not $disable_submodule_update) {
-    Write-Host ">>> " -NoNewLine -ForegroundColor green
-    Write-Host "Making sure submodules are up-to-date ..."
-    git submodule update --init --recursive
+    Write-Color -Text ">>> ", "Making sure submodules are up-to-date ..." -Color Green, Gray
+    & git submodule update --init --recursive
 } else {
-     Write-Host "*** " -NoNewLine -ForegroundColor yellow
-    Write-Host "Not updating submodules ..."
+    Write-Color -Text "*** ", "Not updating submodules ..." -Color Green, Gray
 }
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "OpenPype [ " -NoNewline -ForegroundColor white
-Write-host $openpype_version  -NoNewline -ForegroundColor green
-Write-Host " ]" -ForegroundColor white
+Write-Color -Text ">>> ", "OpenPype [ ", $openpype_version, " ]" -Color Green, White, Cyan, White
 
-Write-Host ">>> " -NoNewline -ForegroundColor Green
-Write-Host "Reading Poetry ... " -NoNewline
+Write-Color -Text ">>> ", "Reading Poetry ... " -Color Green, Gray -NoNewline
 if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
-    Write-Host "NOT FOUND" -ForegroundColor Yellow
-    Write-Host "*** " -NoNewline -ForegroundColor Yellow
-    Write-Host "We need to install Poetry create virtual env first ..."
+    Write-Color -Text "NOT FOUND" -Color Yellow
+    Write-Color -Text "*** ", "We need to install Poetry create virtual env first ..." -Color Yellow, Gray
     & "$openpype_root\tools\create_env.ps1"
 } else {
-    Write-Host "OK" -ForegroundColor Green
+    Write-Color -Text "OK" -Color Green
 }
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "Cleaning cache files ... " -NoNewline
+Write-Color -Text ">>> ", "Cleaning cache files ... " -Color Green, Gray -NoNewline
 Get-ChildItem $openpype_root -Filter "*.pyc" -Force -Recurse | Where-Object { $_.FullName -inotmatch 'build' } | Remove-Item -Force
 Get-ChildItem $openpype_root -Filter "*.pyo" -Force -Recurse | Where-Object { $_.FullName -inotmatch 'build' } | Remove-Item -Force
 Get-ChildItem $openpype_root -Filter "__pycache__" -Force -Recurse | Where-Object { $_.FullName -inotmatch 'build' } | Remove-Item -Force -Recurse
-Write-Host "OK" -ForegroundColor green
+Write-Color -Text "OK" -Color green
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "Building OpenPype ..."
+Write-Color -Text ">>> ", "Building OpenPype ..." -Color Green, White
 $startTime = [int][double]::Parse((Get-Date -UFormat %s))
 
 $out = &  "$($env:POETRY_HOME)\bin\poetry" run python setup.py build 2>&1
 Set-Content -Path "$($openpype_root)\build\build.log" -Value $out
 if ($LASTEXITCODE -ne 0)
 {
-    Write-Host "!!! " -NoNewLine -ForegroundColor Red
-    Write-Host "Build failed. Check the log: " -NoNewline
-    Write-Host ".\build\build.log" -ForegroundColor Yellow
+    Write-Color -Text "!!! ", "Build failed. Check the log: ", ".\build\build.log" -Color Red, Yellow, White
     Exit-WithCode $LASTEXITCODE
 }
 
 Set-Content -Path "$($openpype_root)\build\build.log" -Value $out
 & "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\tools\build_dependencies.py"
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "restoring current directory"
+Write-Color -Text ">>> ", "Restoring current directory" -Color Green, Gray
 Set-Location -Path $current_dir
 
 $endTime = [int][double]::Parse((Get-Date -UFormat %s))
 New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype build complete!", "All done in $($endTime - $startTime) secs. You will find OpenPype and build log in build directory."
 
-Write-Host "*** " -NoNewline -ForegroundColor Cyan
-Write-Host "All done in $($endTime - $startTime) secs. You will find OpenPype and build log in " -NoNewLine
-Write-Host "'.\build'" -NoNewline -ForegroundColor Green
-Write-Host " directory."
+Write-Color -Text "*** ", "All done in ", $($endTime - $startTime), " secs. You will find OpenPype and build log in ", "'.\build'", " directory." -Color Green, Gray, White, Gray, White, Gray
diff --git a/tools/build_win_installer.ps1 b/tools/build_win_installer.ps1
index a0832e0135..287e5c751f 100644
--- a/tools/build_win_installer.ps1
+++ b/tools/build_win_installer.ps1
@@ -11,6 +11,12 @@
 PS> .\build_win_installer.ps1
 
 #>
+$current_dir = Get-Location
+$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+$openpype_root = (Get-Item $script_dir).parent.FullName
+
+# Install PSWriteColor to support colorized output to terminal
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
 
 function Start-Progress {
     param([ScriptBlock]$code)
@@ -44,7 +50,6 @@ function Start-Progress {
   #>
 }
 
-
 function Exit-WithCode($exitcode) {
    # Only exit this host process if it's a child of another PowerShell parent process...
    $parentPID = (Get-CimInstance -ClassName Win32_Process -Filter "ProcessId=$PID" | Select-Object -Property ParentProcessId).ParentProcessId
@@ -56,10 +61,8 @@ function Exit-WithCode($exitcode) {
 
 function Show-PSWarning() {
     if ($PSVersionTable.PSVersion.Major -lt 7) {
-        Write-Host "!!! " -NoNewline -ForegroundColor Red
-        Write-Host "You are using old version of PowerShell. $($PSVersionTable.PSVersion.Major).$($PSVersionTable.PSVersion.Minor)"
-        Write-Host "Please update to at least 7.0 - " -NoNewline -ForegroundColor Gray
-        Write-Host "https://github.com/PowerShell/PowerShell/releases" -ForegroundColor White
+        Write-Color -Text "!!! ", "You are using old version of PowerShell - ",  "$($PSVersionTable.PSVersion.Major).$($PSVersionTable.PSVersion.Minor)" -Color Red, Yellow, White
+        Write-Color -Text "    Please update to at least 7.0 - ", "https://github.com/PowerShell/PowerShell/releases" -Color Yellow, White
         Exit-WithCode 1
     }
 }
@@ -87,9 +90,6 @@ Write-Host $art -ForegroundColor DarkGreen
 # Enable if PS 7.x is needed.
 # Show-PSWarning
 
-$current_dir = Get-Location
-$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
-$openpype_root = (Get-Item $script_dir).parent.FullName
 
 Set-Location -Path $openpype_root
 
@@ -97,16 +97,15 @@ $version_file = Get-Content -Path "$($openpype_root)\openpype\version.py"
 $result = [regex]::Matches($version_file, '__version__ = "(?<version>\d+\.\d+.\d+.*)"')
 $openpype_version = $result[0].Groups['version'].Value
 if (-not $openpype_version) {
-  Write-Host "!!! " -ForegroundColor yellow -NoNewline
-  Write-Host "Cannot determine OpenPype version."
+  Write-Color -Text "!!! ", "Cannot determine OpenPype version." -Color Yellow, Gray
   Exit-WithCode 1
 }
+
 $env:BUILD_VERSION = $openpype_version
 
 iscc 
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "Creating OpenPype installer ... " -ForegroundColor white
+Write-Color -Text ">>> ", "Creating OpenPype installer ... " -Color Green, White
 
 $build_dir_command = @"
 import sys
@@ -115,24 +114,25 @@ print('exe.{}-{}'.format(get_platform(), sys.version[0:3]))
 "@
 
 $build_dir = & python -c $build_dir_command
-Write-Host "Build directory ... ${build_dir}" -ForegroundColor white
+Write-Color -Text "--- ", "Build directory ", "${build_dir}" -Color Green, Gray, White
 $env:BUILD_DIR = $build_dir
 
-if (Get-Command iscc -errorAction SilentlyContinue -ErrorVariable ProcessError)
-{
-  iscc "$openpype_root\inno_setup.iss"
-}else {
-  Write-Host "!!! Cannot find Inno Setup command" -ForegroundColor red
-  Write-Host "!!! You can download it at https://jrsoftware.org/" -ForegroundColor red
+if (-not (Get-Command iscc -errorAction SilentlyContinue -ErrorVariable ProcessError)) {
+  Write-Color -Text "!!! ", "Cannot find Inno Setup command" -Color Red, Yellow
+  Write-Color "!!! You can download it at https://jrsoftware.org/" -ForegroundColor red
   Exit-WithCode 1
 }
 
+& iscc "$openpype_root\inno_setup.iss"
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "restoring current directory"
+if ($LASTEXITCODE -ne 0) {
+    Write-Color -Text "!!! ", "Creating installer failed." -Color Red, Yellow
+    Exit-WithCode 1
+}
+
+Write-Color -Text ">>> ", "Restoring current directory" -Color Green, Gray
 Set-Location -Path $current_dir
 
-Write-Host "*** " -NoNewline -ForegroundColor Cyan
-Write-Host "All done. You will find OpenPype installer in " -NoNewLine
-Write-Host "'.\build'" -NoNewline -ForegroundColor Green
-Write-Host " directory."
+New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype build complete!", "All done. You will find You will find OpenPype installer in '.\build' directory."
+
+Write-Color -Text "*** ", "All done. You will find OpenPype installer in ", "'.\build'", " directory." -Color Green, Gray, White, Gray
diff --git a/tools/create_env.ps1 b/tools/create_env.ps1
index 6c8124ccb2..6315b7b27c 100644
--- a/tools/create_env.ps1
+++ b/tools/create_env.ps1
@@ -24,6 +24,13 @@ if($arguments -eq "--verbose") {
     $poetry_verbosity="-vvv"
 }
 
+$current_dir = Get-Location
+$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+$openpype_root = (Get-Item $script_dir).parent.FullName
+
+# Install PSWriteColor to support colorized output to terminal
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+
 function Exit-WithCode($exitcode) {
    # Only exit this host process if it's a child of another PowerShell parent process...
    $parentPID = (Get-CimInstance -ClassName Win32_Process -Filter "ProcessId=$PID" | Select-Object -Property ParentProcessId).ParentProcessId
@@ -36,28 +43,24 @@ function Exit-WithCode($exitcode) {
 
 function Show-PSWarning() {
     if ($PSVersionTable.PSVersion.Major -lt 7) {
-        Write-Host "!!! " -NoNewline -ForegroundColor Red
-        Write-Host "You are using old version of PowerShell. $($PSVersionTable.PSVersion.Major).$($PSVersionTable.PSVersion.Minor)"
-        Write-Host "Please update to at least 7.0 - " -NoNewline -ForegroundColor Gray
-        Write-Host "https://github.com/PowerShell/PowerShell/releases" -ForegroundColor White
+        Write-Color -Text "!!! ", "You are using old version of PowerShell - ",  "$($PSVersionTable.PSVersion.Major).$($PSVersionTable.PSVersion.Minor)" -Color Red, Yellow, White
+        Write-Color -Text "    Please update to at least 7.0 - ", "https://github.com/PowerShell/PowerShell/releases" -Color Yellow, White
         Exit-WithCode 1
     }
 }
 
 
 function Install-Poetry() {
-    Write-Host ">>> " -NoNewline -ForegroundColor Green
-    Write-Host "Installing Poetry ... "
+    Write-Color -Text ">>> ", "Installing Poetry ... " -Color Green, Gray
     $env:POETRY_HOME="$openpype_root\.poetry"
     (Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py -UseBasicParsing).Content | python -
 }
 
 
 function Test-Python() {
-    Write-Host ">>> " -NoNewline -ForegroundColor green
-    Write-Host "Detecting host Python ... " -NoNewline
+    Write-Color -Text ">>> ", "Detecting host Python ... " -Color Green, Gray -NoNewline
     if (-not (Get-Command "python" -ErrorAction SilentlyContinue)) {
-        Write-Host "!!! Python not detected" -ForegroundColor red
+        Write-Color -Text "!!! ",  "Python not detected" -Color Red, Yellow
         Set-Location -Path $current_dir
         Exit-WithCode 1
     }
@@ -70,28 +73,24 @@ print('{0}.{1}'.format(sys.version_info[0], sys.version_info[1]))
     $env:PYTHON_VERSION = $p
     $m = $p -match '(\d+)\.(\d+)'
     if(-not $m) {
-      Write-Host "!!! Cannot determine version" -ForegroundColor red
-      Set-Location -Path $current_dir
-      Exit-WithCode 1
+        Write-Color -Text "FAILED " -Color Red
+        Write-Color -Text "!!! ", "Cannot determine version" -Color Red, Yellow
+        Set-Location -Path $current_dir
+        Exit-WithCode 1
     }
     # We are supporting python 3.7 only
     if (($matches[1] -lt 3) -or ($matches[2] -lt 7)) {
-      Write-Host "FAILED Version [ $p ] is old and unsupported" -ForegroundColor red
+      Write-Color -Text "FAILED ", "Version ", "[", $p ,"]",  "is old and unsupported" -Color Red, Yellow, Cyan, White, Cyan, Yellow
       Set-Location -Path $current_dir
       Exit-WithCode 1
     } elseif (($matches[1] -eq 3) -and ($matches[2] -gt 7)) {
-        Write-Host "WARNING Version [ $p ] is unsupported, use at your own risk." -ForegroundColor yellow
-        Write-Host "*** " -NoNewline -ForegroundColor yellow
-        Write-Host "OpenPype supports only Python 3.7" -ForegroundColor white
+        Write-Color -Text "WARNING Version ", "[",  $p, "]",  " is unsupported, use at your own risk." -Color Yellow, Cyan, White, Cyan, Yellow
+        Write-Color -Text "*** ", "OpenPype supports only Python 3.7" -Color Yellow, White
     } else {
-        Write-Host "OK [ $p ]" -ForegroundColor green
+        Write-Color "OK ", "[",  $p, "]" -Color Green, Cyan, White, Cyan
     }
 }
 
-$current_dir = Get-Location
-$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
-$openpype_root = (Get-Item $script_dir).parent.FullName
-
 if (-not (Test-Path 'env:POETRY_HOME')) {
     $env:POETRY_HOME = "$openpype_root\.poetry"
 }
@@ -129,41 +128,36 @@ $version_file = Get-Content -Path "$($openpype_root)\openpype\version.py"
 $result = [regex]::Matches($version_file, '__version__ = "(?<version>\d+\.\d+.\d+.*)"')
 $openpype_version = $result[0].Groups['version'].Value
 if (-not $openpype_version) {
-  Write-Host "!!! " -ForegroundColor yellow -NoNewline
-  Write-Host "Cannot determine OpenPype version."
+  Write-Color -Text "!!! ", "Cannot determine OpenPype version." -Color Red, Yellow
   Set-Location -Path $current_dir
   Exit-WithCode 1
 }
-Write-Host ">>> " -NoNewline -ForegroundColor Green
-Write-Host "Found OpenPype version " -NoNewline
-Write-Host "[ $($openpype_version) ]" -ForegroundColor Green
+Write-Color -Text ">>> ", "Found OpenPype version ", "[ ", $($openpype_version), " ]" -Color Green, Gray, Cyan, White, Cyan
 
 Test-Python
 
-Write-Host ">>> " -NoNewline -ForegroundColor Green
-Write-Host "Reading Poetry ... " -NoNewline
+Write-Color -Text ">>> ", "Reading Poetry ... " -Color Green, Gray -NoNewline
 if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
-    Write-Host "NOT FOUND" -ForegroundColor Yellow
+    Write-Color -Text "NOT FOUND" -Color Yellow
     Install-Poetry
-    Write-Host "INSTALLED" -ForegroundColor Cyan
+    Write-Color -Text "INSTALLED" -Color Cyan
 } else {
-    Write-Host "OK" -ForegroundColor Green
+    Write-Color -Text "OK" -Color Green
 }
 
 if (-not (Test-Path -PathType Leaf -Path "$($openpype_root)\poetry.lock")) {
-    Write-Host ">>> " -NoNewline -ForegroundColor green
-    Write-Host "Installing virtual environment and creating lock."
+    Write-Color -Text ">>> ", "Installing virtual environment and creating lock." -Color Green, Gray
 } else {
-    Write-Host ">>> " -NoNewline -ForegroundColor green
-    Write-Host "Installing virtual environment from lock."
+    Write-Color -Text ">>> ", "Installing virtual environment from lock." -Color Green, Gray
 }
 & "$env:POETRY_HOME\bin\poetry" install --no-root $poetry_verbosity --ansi
 if ($LASTEXITCODE -ne 0) {
-    Write-Host "!!! " -ForegroundColor yellow -NoNewline
-    Write-Host "Poetry command failed."
+    Write-Color -Text "!!! ", "Poetry command failed." -Color Red, Yellow
     Set-Location -Path $current_dir
     Exit-WithCode 1
 }
 Set-Location -Path $current_dir
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "Virtual environment created."
+
+New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype", "Virtual environment created."
+
+Write-Color -Text ">>> ", "Virtual environment created." -Color Green, White

From e7e9f461eeed634f0cba4b931fe8ea33814f26b4 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 2 Sep 2021 14:55:04 +0200
Subject: [PATCH 0003/1227] remove submodules

---
 openpype/modules/ftrack/python2_vendor/arrow             | 1 -
 openpype/modules/ftrack/python2_vendor/ftrack-python-api | 1 -
 2 files changed, 2 deletions(-)
 delete mode 160000 openpype/modules/ftrack/python2_vendor/arrow
 delete mode 160000 openpype/modules/ftrack/python2_vendor/ftrack-python-api

diff --git a/openpype/modules/ftrack/python2_vendor/arrow b/openpype/modules/ftrack/python2_vendor/arrow
deleted file mode 160000
index b746fedf72..0000000000
--- a/openpype/modules/ftrack/python2_vendor/arrow
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit b746fedf7286c3755a46f07ab72f4c414cd41fc0
diff --git a/openpype/modules/ftrack/python2_vendor/ftrack-python-api b/openpype/modules/ftrack/python2_vendor/ftrack-python-api
deleted file mode 160000
index d277f474ab..0000000000
--- a/openpype/modules/ftrack/python2_vendor/ftrack-python-api
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit d277f474ab016e7b53479c36af87cb861d0cc53e

From 757af0d36eee3a35d0f2de5ce131fc4e3a9327c5 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 2 Sep 2021 23:31:34 +0200
Subject: [PATCH 0004/1227] yet more scripts

---
 tools/run_mongo.ps1           | 22 +++++++--------
 tools/run_project_manager.ps1 | 15 +++++-----
 tools/run_settings.ps1        | 15 +++++-----
 tools/run_tests.ps1           | 53 +++++++++++++----------------------
 tools/run_tray.ps1            | 13 +++++----
 5 files changed, 54 insertions(+), 64 deletions(-)

diff --git a/tools/run_mongo.ps1 b/tools/run_mongo.ps1
index 32f6cfed17..0f26e86579 100644
--- a/tools/run_mongo.ps1
+++ b/tools/run_mongo.ps1
@@ -11,6 +11,13 @@ PS> .\run_mongo.ps1
 
 #>
 
+$current_dir = Get-Location
+$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+$openpype_root = (Get-Item $script_dir).parent.FullName
+
+# Install PSWriteColor to support colorized output to terminal
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+
 $art = @"
 
              . .   ..     .    ..
@@ -43,8 +50,7 @@ function Exit-WithCode($exitcode) {
 
 function Find-Mongo ($preferred_version) {
     $defaultPath = "C:\Program Files\MongoDB\Server"
-    Write-Host ">>> " -NoNewLine -ForegroundColor Green
-    Write-Host "Detecting MongoDB ... " -NoNewline
+    Write-Color -Text ">>> ", "Detecting MongoDB ... " -Color Geen, Gray -NoNewline
     if (-not (Get-Command "mongod" -ErrorAction SilentlyContinue)) {
         if(Test-Path "$($defaultPath)\*\bin\mongod.exe" -PathType Leaf) {
         # we have mongo server installed on standard Windows location
@@ -52,17 +58,14 @@ function Find-Mongo ($preferred_version) {
         # $preferred_version.
         $mongoVersions = Get-ChildItem -Directory 'C:\Program Files\MongoDB\Server' | Sort-Object -Property {$_.Name -as [int]}
         if(Test-Path "$($mongoVersions[-1])\bin\mongod.exe" -PathType Leaf) {
-            Write-Host "OK" -ForegroundColor Green
+            Write-Color -Text "OK" -Color Green
             $use_version = $mongoVersions[-1]
             foreach ($v in $mongoVersions) {
-                Write-Host "  - found [ " -NoNewline
-                Write-Host $v -NoNewLine -ForegroundColor Cyan
-                Write-Host " ]" -NoNewLine
-
+                Write-Color -Text "  - found [ ", $v, " ]" - Color Cyan, White, Cyan -NoNewLine
                 $version = Split-Path $v -Leaf
 
                 if ($preferred_version -eq $version) {
-                    Write-Host " *" -ForegroundColor Green
+                    Write-Color -Text " *" -Color Green
                     $use_version = $v
                 } else {
                     Write-Host ""
@@ -104,9 +107,6 @@ function Find-Mongo ($preferred_version) {
   #>
 }
 
-$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
-$openpype_root = (Get-Item $script_dir).parent.FullName
-
 # mongodb port
 $port = 2707
 
diff --git a/tools/run_project_manager.ps1 b/tools/run_project_manager.ps1
index a9cfbb1e7b..2932358c2a 100644
--- a/tools/run_project_manager.ps1
+++ b/tools/run_project_manager.ps1
@@ -35,6 +35,9 @@ $current_dir = Get-Location
 $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
+# Install PSWriteColor to support colorized output to terminal
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+
 $env:_INSIDE_OPENPYPE_TOOL = "1"
 
 # make sure Poetry is in PATH
@@ -45,15 +48,13 @@ $env:PATH = "$($env:PATH);$($env:POETRY_HOME)\bin"
 
 Set-Location -Path $openpype_root
 
-Write-Host ">>> " -NoNewline -ForegroundColor Green
-Write-Host "Reading Poetry ... " -NoNewline
+Write-Color -Text ">>> ", "Reading Poetry ... " -Color Green, Gray -NoNewline
 if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
-    Write-Host "NOT FOUND" -ForegroundColor Yellow
-    Write-Host "*** " -NoNewline -ForegroundColor Yellow
-    Write-Host "We need to install Poetry create virtual env first ..."
-    & "$openpype_root\tools\create_env.ps1"
+    Write-Color -Text "NOT FOUND" -Color Yellow
+    Install-Poetry
+    Write-Color -Text "INSTALLED" -Color Cyan
 } else {
-    Write-Host "OK" -ForegroundColor Green
+    Write-Color -Text "OK" -Color Green
 }
 
 & "$env:POETRY_HOME\bin\poetry" run python "$($openpype_root)\start.py" projectmanager
diff --git a/tools/run_settings.ps1 b/tools/run_settings.ps1
index 1c0aa6e8f3..918ea367ab 100644
--- a/tools/run_settings.ps1
+++ b/tools/run_settings.ps1
@@ -15,6 +15,9 @@ $current_dir = Get-Location
 $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
+# Install PSWriteColor to support colorized output to terminal
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+
 $env:_INSIDE_OPENPYPE_TOOL = "1"
 
 # make sure Poetry is in PATH
@@ -25,15 +28,13 @@ $env:PATH = "$($env:PATH);$($env:POETRY_HOME)\bin"
 
 Set-Location -Path $openpype_root
 
-Write-Host ">>> " -NoNewline -ForegroundColor Green
-Write-Host "Reading Poetry ... " -NoNewline
+Write-Color -Text ">>> ", "Reading Poetry ... " -Color Green, Gray -NoNewline
 if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
-    Write-Host "NOT FOUND" -ForegroundColor Yellow
-    Write-Host "*** " -NoNewline -ForegroundColor Yellow
-    Write-Host "We need to install Poetry create virtual env first ..."
-    & "$openpype_root\tools\create_env.ps1"
+    Write-Color -Text "NOT FOUND" -Color Yellow
+    Install-Poetry
+    Write-Color -Text "INSTALLED" -Color Cyan
 } else {
-    Write-Host "OK" -ForegroundColor Green
+    Write-Color -Text "OK" -Color Green
 }
 
 & "$env:POETRY_HOME\bin\poetry" run python "$($openpype_root)\start.py" settings --dev
diff --git a/tools/run_tests.ps1 b/tools/run_tests.ps1
index e631cb72df..7995c6a8e9 100644
--- a/tools/run_tests.ps1
+++ b/tools/run_tests.ps1
@@ -11,6 +11,13 @@ PS> .\run_test.ps1
 
 #>
 
+$current_dir = Get-Location
+$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+$openpype_root = (Get-Item $script_dir).parent.FullName
+
+# Install PSWriteColor to support colorized output to terminal
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+
 function Exit-WithCode($exitcode) {
    # Only exit this host process if it's a child of another PowerShell parent process...
    $parentPID = (Get-CimInstance -ClassName Win32_Process -Filter "ProcessId=$PID" | Select-Object -Property ParentProcessId).ParentProcessId
@@ -22,10 +29,8 @@ function Exit-WithCode($exitcode) {
 
 function Show-PSWarning() {
     if ($PSVersionTable.PSVersion.Major -lt 7) {
-        Write-Host "!!! " -NoNewline -ForegroundColor Red
-        Write-Host "You are using old version of PowerShell. $($PSVersionTable.PSVersion.Major).$($PSVersionTable.PSVersion.Minor)"
-        Write-Host "Please update to at least 7.0 - " -NoNewline -ForegroundColor Gray
-        Write-Host "https://github.com/PowerShell/PowerShell/releases" -ForegroundColor White
+        Write-Color -Text "!!! ", "You are using old version of PowerShell - ",  "$($PSVersionTable.PSVersion.Major).$($PSVersionTable.PSVersion.Minor)" -Color Red, Yellow, White
+        Write-Color -Text "    Please update to at least 7.0 - ", "https://github.com/PowerShell/PowerShell/releases" -Color Yellow, White
         Exit-WithCode 1
     }
 }
@@ -53,10 +58,6 @@ Write-Host $art -ForegroundColor DarkGreen
 # Enable if PS 7.x is needed.
 # Show-PSWarning
 
-$current_dir = Get-Location
-$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
-$openpype_root = (Get-Item $script_dir).parent.FullName
-
 $env:_INSIDE_OPENPYPE_TOOL = "1"
 
 if (-not (Test-Path 'env:POETRY_HOME')) {
@@ -69,46 +70,32 @@ $version_file = Get-Content -Path "$($openpype_root)\openpype\version.py"
 $result = [regex]::Matches($version_file, '__version__ = "(?<version>\d+\.\d+.\d+.*)"')
 $openpype_version = $result[0].Groups['version'].Value
 if (-not $openpype_version) {
-  Write-Host "!!! " -ForegroundColor yellow -NoNewline
-  Write-Host "Cannot determine OpenPype version."
+  Write-Color -Text "!!! ", "Cannot determine OpenPype version." -Color Yellow, Gray
   Exit-WithCode 1
 }
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "OpenPype [ " -NoNewline -ForegroundColor white
-Write-host $openpype_version  -NoNewline -ForegroundColor green
-Write-Host " ] ..." -ForegroundColor white
+Write-Color -Text ">>> ", "OpenPype [ ", $openpype_version, " ]" -Color Green, White, Cyan, White
 
-Write-Host ">>> " -NoNewline -ForegroundColor Green
-Write-Host "Reading Poetry ... " -NoNewline
+Write-Color -Text ">>> ", "Reading Poetry ... " -Color Green, Gray -NoNewline
 if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
-    Write-Host "NOT FOUND" -ForegroundColor Yellow
-    Write-Host "*** " -NoNewline -ForegroundColor Yellow
-    Write-Host "We need to install Poetry create virtual env first ..."
+    Write-Color -Text "NOT FOUND" -Color Yellow
+    Write-Color -Text "*** ", "We need to install Poetry create virtual env first ..." -Color Yellow, Gray
     & "$openpype_root\tools\create_env.ps1"
 } else {
-    Write-Host "OK" -ForegroundColor Green
+    Write-Color -Text "OK" -Color Green
 }
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "Cleaning cache files ... " -NoNewline
+Write-Color -Text ">>> ", "Cleaning cache files ... " -Color Green, Gray -NoNewline
 Get-ChildItem $openpype_root -Filter "*.pyc" -Force -Recurse | Where-Object { $_.FullName -inotmatch 'build' } | Remove-Item -Force
+Get-ChildItem $openpype_root -Filter "*.pyo" -Force -Recurse | Where-Object { $_.FullName -inotmatch 'build' } | Remove-Item -Force
 Get-ChildItem $openpype_root -Filter "__pycache__" -Force -Recurse | Where-Object { $_.FullName -inotmatch 'build' } | Remove-Item -Force -Recurse
-Write-Host "OK" -ForegroundColor green
+Write-Color -Text "OK" -Color green
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "Testing OpenPype ..."
+Write-Color -Text ">>> ", "Testing OpenPype ..." -Color Green, White
 $original_pythonpath = $env:PYTHONPATH
 $env:PYTHONPATH="$($openpype_root);$($env:PYTHONPATH)"
 & "$env:POETRY_HOME\bin\poetry" run pytest -x --capture=sys --print -W ignore::DeprecationWarning "$($openpype_root)/tests"
 $env:PYTHONPATH = $original_pythonpath
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "restoring current directory"
+Write-Color -Text ">>> ", "Restoring current directory" -Color Green, Gray
 Set-Location -Path $current_dir
-
-
-
-
-
-
diff --git a/tools/run_tray.ps1 b/tools/run_tray.ps1
index 872c1524a6..7dee3d0064 100644
--- a/tools/run_tray.ps1
+++ b/tools/run_tray.ps1
@@ -14,6 +14,9 @@ $current_dir = Get-Location
 $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
+# Install PSWriteColor to support colorized output to terminal
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+
 $env:_INSIDE_OPENPYPE_TOOL = "1"
 
 # make sure Poetry is in PATH
@@ -24,15 +27,13 @@ $env:PATH = "$($env:PATH);$($env:POETRY_HOME)\bin"
 
 Set-Location -Path $openpype_root
 
-Write-Host ">>> " -NoNewline -ForegroundColor Green
-Write-Host "Reading Poetry ... " -NoNewline
+Write-Color -Text ">>> ", "Reading Poetry ... " -Color Green, Gray -NoNewline
 if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
-    Write-Host "NOT FOUND" -ForegroundColor Yellow
-    Write-Host "*** " -NoNewline -ForegroundColor Yellow
-    Write-Host "We need to install Poetry create virtual env first ..."
+    Write-Color -Text "NOT FOUND" -Color Yellow
+    Write-Color -Text "*** ", "We need to install Poetry create virtual env first ..." -Color Yellow, Gray
     & "$openpype_root\tools\create_env.ps1"
 } else {
-    Write-Host "OK" -ForegroundColor Green
+    Write-Color -Text "OK" -Color Green
 }
 
 & "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\start.py" tray --debug

From cd468f567331cc8125318b92a62259cf621e48db Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Fri, 3 Sep 2021 12:10:55 +0200
Subject: [PATCH 0005/1227] rest of the scripts converted

---
 tools/create_zip.ps1            | 40 +++++++++++++++------------------
 tools/fetch_thirdparty_libs.ps1 | 13 ++++++-----
 tools/make_docs.ps1             | 27 ++++++++++++----------
 tools/run_mongo.ps1             | 33 ++++++++-------------------
 4 files changed, 49 insertions(+), 64 deletions(-)

diff --git a/tools/create_zip.ps1 b/tools/create_zip.ps1
index c27857b480..3796186dd0 100644
--- a/tools/create_zip.ps1
+++ b/tools/create_zip.ps1
@@ -19,6 +19,13 @@ PS> .\create_zip.ps1 --path C:\OpenPype
 
 #>
 
+$current_dir = Get-Location
+$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+$openpype_root = (Get-Item $script_dir).parent.FullName
+
+# Install PSWriteColor to support colorized output to terminal
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+
 function Exit-WithCode($exitcode) {
    # Only exit this host process if it's a child of another PowerShell parent process...
    $parentPID = (Get-CimInstance -ClassName Win32_Process -Filter "ProcessId=$PID" | Select-Object -Property ParentProcessId).ParentProcessId
@@ -31,18 +38,12 @@ function Exit-WithCode($exitcode) {
 
 function Show-PSWarning() {
     if ($PSVersionTable.PSVersion.Major -lt 7) {
-        Write-Host "!!! " -NoNewline -ForegroundColor Red
-        Write-Host "You are using old version of PowerShell. $($PSVersionTable.PSVersion.Major).$($PSVersionTable.PSVersion.Minor)"
-        Write-Host "Please update to at least 7.0 - " -NoNewline -ForegroundColor Gray
-        Write-Host "https://github.com/PowerShell/PowerShell/releases" -ForegroundColor White
+        Write-Color -Text "!!! ", "You are using old version of PowerShell - ",  "$($PSVersionTable.PSVersion.Major).$($PSVersionTable.PSVersion.Minor)" -Color Red, Yellow, White
+        Write-Color -Text "    Please update to at least 7.0 - ", "https://github.com/PowerShell/PowerShell/releases" -Color Yellow, White
         Exit-WithCode 1
     }
 }
 
-$current_dir = Get-Location
-$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
-$openpype_root = (Get-Item $script_dir).parent.FullName
-
 $env:_INSIDE_OPENPYPE_TOOL = "1"
 
 if (-not (Test-Path 'env:POETRY_HOME')) {
@@ -78,31 +79,26 @@ $version_file = Get-Content -Path "$($openpype_root)\openpype\version.py"
 $result = [regex]::Matches($version_file, '__version__ = "(?<version>\d+\.\d+.\d+.*)"')
 $openpype_version = $result[0].Groups['version'].Value
 if (-not $openpype_version) {
-  Write-Host "!!! " -ForegroundColor yellow -NoNewline
-  Write-Host "Cannot determine OpenPype version."
+  Write-Color -Text "!!! ", "Cannot determine OpenPype version." -Color Yellow, Gray
   Exit-WithCode 1
 }
 
-Write-Host ">>> " -NoNewline -ForegroundColor Green
-Write-Host "Reading Poetry ... " -NoNewline
+Write-Color -Text ">>> ", "Reading Poetry ... " -Color Green, Gray -NoNewline
 if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
-    Write-Host "NOT FOUND" -ForegroundColor Yellow
-    Write-Host "*** " -NoNewline -ForegroundColor Yellow
-    Write-Host "We need to install Poetry create virtual env first ..."
+    Write-Color -Text "NOT FOUND" -Color Yellow
+    Write-Color -Text "*** ", "We need to install Poetry create virtual env first ..." -Color Yellow, Gray
     & "$openpype_root\tools\create_env.ps1"
 } else {
-    Write-Host "OK" -ForegroundColor Green
+    Write-Color -Text "OK" -Color Green
 }
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "Cleaning cache files ... " -NoNewline
+Write-Color -Text ">>> ", "Cleaning cache files ... " -Color Green, Gray -NoNewline
 Get-ChildItem $openpype_root -Filter "*.pyc" -Force -Recurse | Where-Object { $_.FullName -inotmatch 'build' } | Remove-Item -Force
 Get-ChildItem $openpype_root -Filter "*.pyo" -Force -Recurse | Where-Object { $_.FullName -inotmatch 'build' } | Remove-Item -Force
-Get-ChildItem $openpype_root -Filter "__pycache__" -Force -Recurse|  Where-Object { $_.FullName -inotmatch 'build' } | Remove-Item -Force -Recurse
-Write-Host "OK" -ForegroundColor green
+Get-ChildItem $openpype_root -Filter "__pycache__" -Force -Recurse | Where-Object { $_.FullName -inotmatch 'build' } | Remove-Item -Force -Recurse
+Write-Color -Text "OK" -Color green
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "Generating zip from current sources ..."
+Write-Color -Text ">>> ", "Generating zip from current sources ..." -Color Green, Gray
 $env:PYTHONPATH="$($openpype_root);$($env:PYTHONPATH)"
 $env:OPENPYPE_ROOT="$($openpype_root)"
 & "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\tools\create_zip.py" $ARGS
diff --git a/tools/fetch_thirdparty_libs.ps1 b/tools/fetch_thirdparty_libs.ps1
index 16f7b70e7a..0226a35bfb 100644
--- a/tools/fetch_thirdparty_libs.ps1
+++ b/tools/fetch_thirdparty_libs.ps1
@@ -15,6 +15,9 @@ $current_dir = Get-Location
 $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
+# Install PSWriteColor to support colorized output to terminal
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+
 $env:_INSIDE_OPENPYPE_TOOL = "1"
 
 if (-not (Test-Path 'env:POETRY_HOME')) {
@@ -23,15 +26,13 @@ if (-not (Test-Path 'env:POETRY_HOME')) {
 
 Set-Location -Path $openpype_root
 
-Write-Host ">>> " -NoNewline -ForegroundColor Green
-Write-Host "Reading Poetry ... " -NoNewline
+Write-Color -Text ">>> ", "Reading Poetry ... " -Color Green, Gray -NoNewline
 if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
-    Write-Host "NOT FOUND" -ForegroundColor Yellow
-    Write-Host "*** " -NoNewline -ForegroundColor Yellow
-    Write-Host "We need to install Poetry create virtual env first ..."
+    Write-Color -Text "NOT FOUND" -Color Yellow
+    Write-Color -Text "*** ", "We need to install Poetry create virtual env first ..." -Color Yellow, Gray
     & "$openpype_root\tools\create_env.ps1"
 } else {
-    Write-Host "OK" -ForegroundColor Green
+    Write-Color -Text "OK" -Color Green
 }
 
 & "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\tools\fetch_thirdparty_libs.py"
diff --git a/tools/make_docs.ps1 b/tools/make_docs.ps1
index 45a11171ae..d356f081de 100644
--- a/tools/make_docs.ps1
+++ b/tools/make_docs.ps1
@@ -44,27 +44,30 @@ $art = @"
 
 "@
 
+$current_dir = Get-Location
+$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+$openpype_root = (Get-Item $script_dir).parent.FullName
+
+# Install PSWriteColor to support colorized output to terminal
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+
 Write-Host $art -ForegroundColor DarkGreen
 
-Write-Host ">>> " -NoNewline -ForegroundColor Green
-Write-Host "Reading Poetry ... " -NoNewline
+Write-Color -Text ">>> ", "Reading Poetry ... " -Color Green, Gray -NoNewline
 if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
-    Write-Host "NOT FOUND" -ForegroundColor Yellow
-    Write-Host "*** " -NoNewline -ForegroundColor Yellow
-    Write-Host "We need to install Poetry create virtual env first ..."
-    & "$openpype_root\tools\create_env.ps1"
+    Write-Color -Text "NOT FOUND" -Color Yellow
+    Install-Poetry
+    Write-Color -Text "INSTALLED" -Color Cyan
 } else {
-    Write-Host "OK" -ForegroundColor Green
+    Write-Color -Text "OK" -Color Green
 }
 
-Write-Host "This will not overwrite existing source rst files, only scan and add new."
+Write-Color -Text "... ", "This will not overwrite existing source rst files, only scan and add new." -Color Yellow, Gray
 Set-Location -Path $openpype_root
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "Running apidoc ..."
+Write-Color -Text ">>> ", "Running apidoc ..." -Color Green, Gray
 & "$env:POETRY_HOME\bin\poetry" run sphinx-apidoc -M -e -d 10  --ext-intersphinx --ext-todo --ext-coverage --ext-viewcode -o "$($openpype_root)\docs\source" igniter
 & "$env:POETRY_HOME\bin\poetry" run sphinx-apidoc.exe -M -e -d 10 --ext-intersphinx --ext-todo --ext-coverage --ext-viewcode -o "$($openpype_root)\docs\source" openpype vendor, openpype\vendor
 
-Write-Host ">>> " -NoNewline -ForegroundColor green
-Write-Host "Building html ..."
+Write-Color -Text ">>> ", "Building html ..." -Color Green, Gray
 & "$env:POETRY_HOME\bin\poetry" run python "$($openpype_root)\setup.py" build_sphinx
 Set-Location -Path $current_dir
diff --git a/tools/run_mongo.ps1 b/tools/run_mongo.ps1
index 0f26e86579..a840200252 100644
--- a/tools/run_mongo.ps1
+++ b/tools/run_mongo.ps1
@@ -74,27 +74,20 @@ function Find-Mongo ($preferred_version) {
 
             $env:PATH = "$($env:PATH);$($use_version)\bin\"
 
-            Write-Host "  - auto-added from [ " -NoNewline
-            Write-Host "$($use_version)\bin\mongod.exe" -NoNewLine -ForegroundColor Cyan
-            Write-Host " ]"
+            Write-Color -Text "  - auto-added from [ ", "$($use_version)\bin\mongod.exe", " ]" -Color Cyan, White, Cyan
             return "$($use_version)\bin\mongod.exe"
         } else {
-            Write-Host "FAILED " -NoNewLine -ForegroundColor Red
-            Write-Host "MongoDB not detected" -ForegroundColor Yellow
-            Write-Host "Tried to find it on standard location " -NoNewline -ForegroundColor Gray
-            Write-Host " [ " -NoNewline -ForegroundColor Cyan
-            Write-Host "$($mongoVersions[-1])\bin\mongod.exe" -NoNewline -ForegroundColor White
-            Write-Host " ] " -NoNewLine -ForegroundColor Cyan
-            Write-Host "but failed." -ForegroundColor Gray
+            Write-Color -Text "FAILED " -Color Red  -NoNewLine
+            Write-Color -Text "MongoDB not detected" -Color Yellow
+            Write-Color -Text "Tried to find it on standard location ", "[ ", "$($mongoVersions[-1])\bin\mongod.exe", " ]", " but failed." -Color Gray, Cyan, White, Cyan, Gray -NoNewline
             Exit-WithCode 1
         }
     } else {
-        Write-Host "FAILED " -NoNewLine -ForegroundColor Red
-        Write-Host "MongoDB not detected in PATH" -ForegroundColor Yellow
+        Write-Color -Text "FAILED ", "MongoDB not detected in PATH" -Color Red, Yellow
         Exit-WithCode 1
     }
   } else {
-        Write-Host "OK" -ForegroundColor Green
+        Write-Color -Text "OK" -Color Green
         return Get-Command "mongod" -ErrorAction SilentlyContinue
   }
   <#
@@ -116,15 +109,7 @@ $dbpath = (Get-Item $openpype_root).parent.FullName + "\mongo_db_data"
 $preferred_version = "4.0"
 
 $mongoPath = Find-Mongo $preferred_version
-Write-Host ">>> " -NoNewLine -ForegroundColor Green
-Write-Host "Using DB path: " -NoNewLine
-Write-Host " [ " -NoNewline -ForegroundColor Cyan
-Write-Host "$($dbpath)" -NoNewline -ForegroundColor White
-Write-Host " ] "-ForegroundColor Cyan
-Write-Host ">>> " -NoNewLine -ForegroundColor Green
-Write-Host "Port: " -NoNewLine
-Write-Host " [ " -NoNewline -ForegroundColor Cyan
-Write-Host "$($port)" -NoNewline -ForegroundColor White
-Write-Host " ] " -ForegroundColor Cyan
-Start-Process -FilePath $mongopath "--dbpath $($dbpath) --port $($port)" -PassThru | Out-Null
+Write-Color -Text ">>> ", "Using DB path: ", "[ ", "$($dbpath)", " ]" -Color Green, Gray, Cyan, White, Cyan
+Write-Color -Text ">>> ", "Port: ", "[ ", "$($port)", " ]", -Color Green, Gray, Cyan, White, Cyan
 
+Start-Process -FilePath $mongopath "--dbpath $($dbpath) --port $($port)" -PassThru | Out-Null

From bf39fc72a550ce8ac6fc8d4c07bc2359ec9cdfa8 Mon Sep 17 00:00:00 2001
From: "felix.wang" <felix.wang@igg.com>
Date: Wed, 19 Jan 2022 18:31:24 -0800
Subject: [PATCH 0006/1227] Update submodules.

---
 openpype/modules/default_modules/ftrack/python2_vendor/arrow    | 2 +-
 .../default_modules/ftrack/python2_vendor/ftrack-python-api     | 2 +-
 repos/avalon-core                                               | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/default_modules/ftrack/python2_vendor/arrow b/openpype/modules/default_modules/ftrack/python2_vendor/arrow
index b746fedf72..4c4689c6d9 160000
--- a/openpype/modules/default_modules/ftrack/python2_vendor/arrow
+++ b/openpype/modules/default_modules/ftrack/python2_vendor/arrow
@@ -1 +1 @@
-Subproject commit b746fedf7286c3755a46f07ab72f4c414cd41fc0
+Subproject commit 4c4689c6d97ed2b1f37a67b96c561266c66ee088
diff --git a/openpype/modules/default_modules/ftrack/python2_vendor/ftrack-python-api b/openpype/modules/default_modules/ftrack/python2_vendor/ftrack-python-api
index d277f474ab..ddf943a5dc 160000
--- a/openpype/modules/default_modules/ftrack/python2_vendor/ftrack-python-api
+++ b/openpype/modules/default_modules/ftrack/python2_vendor/ftrack-python-api
@@ -1 +1 @@
-Subproject commit d277f474ab016e7b53479c36af87cb861d0cc53e
+Subproject commit ddf943a5dcc44d2cecf29896d2075f5198b699aa
diff --git a/repos/avalon-core b/repos/avalon-core
index ffe9e910f1..047fe1f5bb 160000
--- a/repos/avalon-core
+++ b/repos/avalon-core
@@ -1 +1 @@
-Subproject commit ffe9e910f1f382e222d457d8e4a8426c41ed43ae
+Subproject commit 047fe1f5bba425b8b41c2197961925c1e2ec5fdf

From 48fd45ed1aedfba8ac8afdc1f947970c2d76dc85 Mon Sep 17 00:00:00 2001
From: "felix.wang" <felix.wang@igg.com>
Date: Mon, 24 Jan 2022 14:42:58 -0800
Subject: [PATCH 0007/1227] Revert "Update submodules."

This reverts commit bf39fc72a550ce8ac6fc8d4c07bc2359ec9cdfa8.
---
 openpype/modules/default_modules/ftrack/python2_vendor/arrow    | 2 +-
 .../default_modules/ftrack/python2_vendor/ftrack-python-api     | 2 +-
 repos/avalon-core                                               | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/default_modules/ftrack/python2_vendor/arrow b/openpype/modules/default_modules/ftrack/python2_vendor/arrow
index 4c4689c6d9..b746fedf72 160000
--- a/openpype/modules/default_modules/ftrack/python2_vendor/arrow
+++ b/openpype/modules/default_modules/ftrack/python2_vendor/arrow
@@ -1 +1 @@
-Subproject commit 4c4689c6d97ed2b1f37a67b96c561266c66ee088
+Subproject commit b746fedf7286c3755a46f07ab72f4c414cd41fc0
diff --git a/openpype/modules/default_modules/ftrack/python2_vendor/ftrack-python-api b/openpype/modules/default_modules/ftrack/python2_vendor/ftrack-python-api
index ddf943a5dc..d277f474ab 160000
--- a/openpype/modules/default_modules/ftrack/python2_vendor/ftrack-python-api
+++ b/openpype/modules/default_modules/ftrack/python2_vendor/ftrack-python-api
@@ -1 +1 @@
-Subproject commit ddf943a5dcc44d2cecf29896d2075f5198b699aa
+Subproject commit d277f474ab016e7b53479c36af87cb861d0cc53e
diff --git a/repos/avalon-core b/repos/avalon-core
index 047fe1f5bb..ffe9e910f1 160000
--- a/repos/avalon-core
+++ b/repos/avalon-core
@@ -1 +1 @@
-Subproject commit 047fe1f5bba425b8b41c2197961925c1e2ec5fdf
+Subproject commit ffe9e910f1f382e222d457d8e4a8426c41ed43ae

From 1b184a09f9d3c9ac656f45a2bacded0125399795 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@gmail.com>
Date: Fri, 18 Feb 2022 10:31:09 +0100
Subject: [PATCH 0008/1227] add root keys and project keys

---
 openpype/lib/path_tools.py | 88 ++++++++++++++++++++++++++------------
 1 file changed, 60 insertions(+), 28 deletions(-)

diff --git a/openpype/lib/path_tools.py b/openpype/lib/path_tools.py
index c0b78c5724..181417c38c 100644
--- a/openpype/lib/path_tools.py
+++ b/openpype/lib/path_tools.py
@@ -6,11 +6,12 @@ import logging
 import six
 
 from openpype.settings import get_project_settings
-from openpype.settings.lib import get_site_local_overrides
 
 from .anatomy import Anatomy
 from .profiles_filtering import filter_profiles
 
+import avalon.api
+
 log = logging.getLogger(__name__)
 
 
@@ -130,45 +131,75 @@ def get_last_version_from_path(path_dir, filter):
     return None
 
 
-def compute_paths(basic_paths_items, project_root):
+def concatenate_splitted_paths(split_paths, anatomy):
     pattern_array = re.compile(r"\[.*\]")
-    project_root_key = "__project_root__"
     output = []
-    for path_items in basic_paths_items:
+    for path_items in split_paths:
         clean_items = []
+        if isinstance(path_items, str):
+            path_items = [path_items]
+
         for path_item in path_items:
-            matches = re.findall(pattern_array, path_item)
-            if len(matches) > 0:
-                path_item = path_item.replace(matches[0], "")
-            if path_item == project_root_key:
-                path_item = project_root
+            if not re.match(r"{.+}", path_item):
+                path_item = re.sub(pattern_array, "", path_item)
             clean_items.append(path_item)
+
+        # backward compatibility
+        if "__project_root__" in path_items:
+            for root, root_path in anatomy.roots.items():
+                if not os.path.exists(str(root_path)):
+                    log.debug("Root {} path path {} not exist on \
+                        computer!".format(root, root_path))
+                    continue
+                clean_items = [f"{{root[{root}]}}", "{project[name]}"] \
+                    + clean_items[1:]
+                output.append(os.path.normpath(os.path.sep.join(clean_items)))
+            continue
+
         output.append(os.path.normpath(os.path.sep.join(clean_items)))
+
     return output
 
 
+def get_format_data(anatomy):
+    dbcon = avalon.api.AvalonMongoDB()
+    dbcon.Session["AVALON_PROJECT"] = anatomy.project_name
+    project_doc = dbcon.find_one({"type": "project"})
+    project_code = project_doc["data"]["code"]
+
+    return {
+        "root": anatomy.roots,
+        "project": {
+            "name": anatomy.project_name,
+            "code": project_code
+        },
+    }
+
+
+def fill_paths(path_list, anatomy):
+    format_data = get_format_data(anatomy)
+    filled_paths = []
+
+    for path in path_list:
+        new_path = path.format(**format_data)
+        filled_paths.append(new_path)
+
+    return filled_paths
+
+
 def create_project_folders(basic_paths, project_name):
     anatomy = Anatomy(project_name)
-    roots_paths = []
-    if isinstance(anatomy.roots, dict):
-        for root in anatomy.roots.values():
-            roots_paths.append(root.value)
-    else:
-        roots_paths.append(anatomy.roots.value)
 
-    for root_path in roots_paths:
-        project_root = os.path.join(root_path, project_name)
-        full_paths = compute_paths(basic_paths, project_root)
-        # Create folders
-        for path in full_paths:
-            full_path = path.format(project_root=project_root)
-            if os.path.exists(full_path):
-                log.debug(
-                    "Folder already exists: {}".format(full_path)
-                )
-            else:
-                log.debug("Creating folder: {}".format(full_path))
-                os.makedirs(full_path)
+    concat_paths = concatenate_splitted_paths(basic_paths, anatomy)
+    filled_paths = fill_paths(concat_paths, anatomy)
+
+    # Create folders
+    for path in filled_paths:
+        if os.path.exists(path):
+            log.debug("Folder already exists: {}".format(path))
+        else:
+            log.debug("Creating folder: {}".format(path))
+            os.makedirs(path)
 
 
 def _list_path_items(folder_structure):
@@ -267,6 +298,7 @@ class HostDirmap:
             on_dirmap_enabled: run host code for enabling dirmap
             do_dirmap: run host code to do actual remapping
     """
+
     def __init__(self, host_name, project_settings, sync_module=None):
         self.host_name = host_name
         self.project_settings = project_settings

From 075b80563b84e720d1bd18a070b0a194a322a9a8 Mon Sep 17 00:00:00 2001
From: BenoitConnan <benoitconnan.pro@gmail.com>
Date: Mon, 28 Feb 2022 15:09:16 +0100
Subject: [PATCH 0009/1227] add python 2 compatibility to path_tools

---
 openpype/lib/path_tools.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/lib/path_tools.py b/openpype/lib/path_tools.py
index 181417c38c..916e392eb2 100644
--- a/openpype/lib/path_tools.py
+++ b/openpype/lib/path_tools.py
@@ -151,8 +151,8 @@ def concatenate_splitted_paths(split_paths, anatomy):
                     log.debug("Root {} path path {} not exist on \
                         computer!".format(root, root_path))
                     continue
-                clean_items = [f"{{root[{root}]}}", "{project[name]}"] \
-                    + clean_items[1:]
+                clean_items = ["{{root[{}]}}".format(root),
+                               r"{project[name]}"] + clean_items[1:]
                 output.append(os.path.normpath(os.path.sep.join(clean_items)))
             continue
 

From d88ed919e6a4a566b8ff8b289415c471de454b00 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 16 Mar 2022 22:09:23 +0100
Subject: [PATCH 0010/1227] First draft pass of refactoring the Integrator

---
 openpype/plugins/publish/integrate_new.py | 1076 ++++++++++-----------
 1 file changed, 508 insertions(+), 568 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index e8dab089af..e4986e3b3f 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -7,9 +7,8 @@ import clique
 import errno
 import six
 import re
-import shutil
 
-from pymongo import DeleteOne, InsertOne
+from pymongo import DeleteOne, InsertOne, UpdateOne
 import pyblish.api
 from avalon import io
 from avalon.api import format_template_with_optional_keys
@@ -31,6 +30,17 @@ else:
 log = logging.getLogger(__name__)
 
 
+def get_frame_padded(frame, padding):
+    """Return frame number as string with `padding` amount of padded zeros"""
+    return "{frame:0{padding}d}".format(padding=padding, frame=frame)
+
+
+def get_first_frame_padded(collection):
+    """Return first frame as padded number from `clique.Collection`"""
+    start_frame = next(iter(collection.indexes))
+    return get_frame_padded(start_frame, padding=collection.padding)
+
+
 class IntegrateAssetNew(pyblish.api.InstancePlugin):
     """Resolve any dependency issues
 
@@ -108,7 +118,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     exclude_families = ["clip"]
     db_representation_context_keys = [
         "project", "asset", "task", "subset", "version", "representation",
-        "family", "hierarchy", "task", "username"
+        "family", "hierarchy", "task", "username", "frame", "udim"
     ]
     default_template_name = "publish"
 
@@ -116,38 +126,40 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     TMP_FILE_EXT = 'tmp'
 
     # file_url : file_size of all published and uploaded files
-    integrated_file_sizes = {}
+    destinations = list()
 
     # Attributes set by settings
     template_name_profiles = None
     subset_grouping_profiles = None
 
     def process(self, instance):
-        self.integrated_file_sizes = {}
-        if [ef for ef in self.exclude_families
-                if instance.data["family"] in ef]:
+        self.destinations = []
+
+        # Exclude instances that also contain families from exclude families
+        families = set(
+            # Consider family and families data
+            [instance.data["family"]] + instance.data.get("families", [])
+        )
+        if families & set(self.exclude_families):
             return
 
         try:
             self.register(instance)
             self.log.info("Integrated Asset in to the database ...")
-            self.log.info("instance.data: {}".format(instance.data))
-            self.handle_destination_files(self.integrated_file_sizes,
+            self.handle_destination_files(self.destinations,
                                           'finalize')
         except Exception:
             # clean destination
             self.log.critical("Error when registering", exc_info=True)
-            self.handle_destination_files(self.integrated_file_sizes, 'remove')
+            self.handle_destination_files(self.destinations, 'remove')
             six.reraise(*sys.exc_info())
 
-    def register(self, instance):
-        # Required environment variables
-        anatomy_data = instance.data["anatomyData"]
-
-        io.install()
+    def prepare_anatomy(self, instance):
+        """Prepare anatomy data used to define representation destinations"""
 
         context = instance.context
 
+        anatomy_data = instance.data["anatomyData"]
         project_entity = instance.data["projectEntity"]
 
         context_asset_name = None
@@ -206,8 +218,36 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         # Fill family in anatomy data
         anatomy_data["family"] = instance.data.get("family")
 
-        stagingdir = instance.data.get("stagingDir")
-        if not stagingdir:
+        intent_value = instance.context.data.get("intent")
+        if intent_value and isinstance(intent_value, dict):
+            intent_value = intent_value.get("value")
+
+        if intent_value:
+            anatomy_data["intent"] = intent_value
+
+        # Get profile
+        key_values = {
+            "families": self.main_family_from_instance(instance),
+            "tasks": task_name,
+            "hosts": instance.context.data["hostName"],
+            "task_types": task_type
+        }
+        profile = filter_profiles(
+            self.template_name_profiles,
+            key_values,
+            logger=self.log
+        )
+
+        template_name = "publish"
+        if profile:
+            template_name = profile["template_name"]
+
+        return template_name, anatomy_data
+
+    def register(self, instance):
+
+        instance_stagingdir = instance.data.get("stagingDir")
+        if not instance_stagingdir:
             self.log.info((
                 "{0} is missing reference to staging directory."
                 " Will try to get it from representation."
@@ -215,7 +255,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         else:
             self.log.debug(
-                "Establishing staging directory @ {0}".format(stagingdir)
+                "Establishing staging directory "
+                "@ {0}".format(instance_stagingdir)
             )
 
         # Ensure at least one file is set up for transfer in staging dir.
@@ -227,28 +268,74 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             )
         )
 
-        subset = self.get_subset(asset_entity, instance)
-        instance.data["subsetEntity"] = subset
+        subset = self.register_subset(instance)
+
+        version = self.register_version(instance, subset)
+        instance.data["versionEntity"] = version
+        instance.data['version'] = version['name']
+
+        existing_repres = list(io.find({
+            "parent": version["_id"],
+            "type": "archived_representation"
+        }))
+
+        # Find the representations to transfer amongst the files
+        # Each should be a single representation (as such, a single extension)
+        template_name, anatomy_data = self.prepare_anatomy(instance)
+        published_representations = {}
+        representations = []
+        for repre in instance.data["representations"]:
+
+            if "delete" in repre.get("tags", []):
+                self.log.debug("Skipping representation marked for deletion: "
+                               "{}".format(repre))
+                continue
+
+            prepared = self.prepare_representation(repre,
+                                                   anatomy_data,
+                                                   template_name,
+                                                   existing_repres,
+                                                   version,
+                                                   instance_stagingdir,
+                                                   instance)
+
+            # todo: simplify this?
+            representation = prepared["representation"]
+            representations.append(representation)
+            published_representations[representation["_id"]] = prepared
+
+        # Remove old representations if there are any (before insertion of new)
+        if existing_repres:
+            repre_ids_to_remove = [repre["_id"] for repre in existing_repres]
+            io.delete_many({"_id": {"$in": repre_ids_to_remove}})
+
+        # Write the new representations to the database
+        io.insert_many(representations)
+
+        instance.data["published_representations"] = published_representations
+
+        self.log.info("Registered {} representations"
+                      "".format(len(representations)))
+
+    def register_version(self, instance, subset):
 
         version_number = instance.data["version"]
         self.log.debug("Next version: v{}".format(version_number))
 
-        version_data = self.create_version_data(context, instance)
-
+        version_data = self.create_version_data(instance)
         version_data_instance = instance.data.get('versionData')
         if version_data_instance:
             version_data.update(version_data_instance)
 
-        # TODO rename method from `create_version` to
-        # `prepare_version` or similar...
-        version = self.create_version(
-            subset=subset,
-            version_number=version_number,
-            data=version_data
-        )
-
-        self.log.debug("Creating version ...")
+        version = {
+            "schema": "openpype:version-3.0",
+            "type": "version",
+            "parent": subset["_id"],
+            "name": version_number,
+            "data": version_data
+        }
 
+        repres = instance.data.get("representations", [])
         new_repre_names_low = [_repre["name"].lower() for _repre in repres]
 
         existing_version = io.find_one({
@@ -258,29 +345,28 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         })
 
         if existing_version is None:
+            self.log.debug("Creating new version ...")
             version_id = io.insert_one(version).inserted_id
         else:
+            self.log.debug("Updating existing version ...")
             # Check if instance have set `append` mode which cause that
             # only replicated representations are set to archive
             append_repres = instance.data.get("append", False)
+            bulk_writes = []
 
             # Update version data
-            # TODO query by _id and
-            io.update_many({
-                'type': 'version',
-                'parent': subset["_id"],
-                'name': version_number
+            version_id = existing_version['_id']
+            bulk_writes.append(UpdateOne({
+                '_id': version_id
             }, {
                 '$set': version
-            })
-            version_id = existing_version['_id']
+            }))
 
             # Find representations of existing version and archive them
-            current_repres = list(io.find({
+            current_repres = io.find({
                 "type": "representation",
                 "parent": version_id
-            }))
-            bulk_writes = []
+            })
             for repre in current_repres:
                 if append_repres:
                     # archive only duplicated representations
@@ -304,346 +390,248 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 )
 
         version = io.find_one({"_id": version_id})
-        instance.data["versionEntity"] = version
+        return version
 
-        existing_repres = list(io.find({
-            "parent": version_id,
-            "type": "archived_representation"
-        }))
+    def prepare_representation(self, repre,
+                               anatomy_data,
+                               template_name,
+                               existing_repres,
+                               version,
+                               instance_stagingdir,
+                               instance):
 
-        instance.data['version'] = version['name']
+        # create template data for Anatomy
+        template_data = copy.deepcopy(anatomy_data)
 
-        intent_value = instance.context.data.get("intent")
-        if intent_value and isinstance(intent_value, dict):
-            intent_value = intent_value.get("value")
+        # pre-flight validations
+        if repre["ext"].startswith("."):
+            raise ValueError("Extension must not start with a dot '.': "
+                             "{}".format(repre["ext"]))
 
-        if intent_value:
-            anatomy_data["intent"] = intent_value
+        if repre.get("transfers"):
+            raise ValueError("Representation is not allowed to have transfers"
+                             "data before integration. "
+                             "Got: {}".format(repre["transfers"]))
 
-        anatomy = instance.context.data['anatomy']
+        # required representation keys
+        files = repre['files']
+        template_data["representation"] = repre["name"]
+        template_data["ext"] = repre["ext"]
 
-        # Find the representations to transfer amongst the files
-        # Each should be a single representation (as such, a single extension)
-        representations = []
-        destination_list = []
+        # optionals
+        # retrieve additional anatomy data from representation if exists
+        for representation_key, anatomy_key in {
+            # Representation Key: Anatomy data key
+            "resolutionWidth": "resolution_width",
+            "resolutionHeight": "resolution_height",
+            "fps": "fps",
+            "outputName": "output",
+        }.items():
+            value = repre.get(representation_key)
+            if value:
+                template_data[anatomy_key] = value
 
-        orig_transfers = []
-        if 'transfers' not in instance.data:
-            instance.data['transfers'] = []
+        if repre.get('stagingDir'):
+            stagingdir = repre['stagingDir']
         else:
-            orig_transfers = list(instance.data['transfers'])
+            # Fall back to instance staging dir if not explicitly
+            # set for representation in the instance
+            self.log.debug("Representation uses instance staging dir: "
+                           "{}".format(instance_stagingdir))
+            stagingdir = instance_stagingdir
 
-        family = self.main_family_from_instance(instance)
+        self.log.debug("Anatomy template name: {}".format(template_name))
+        anatomy = instance.context.data['anatomy']
+        template = os.path.normpath(
+            anatomy.templates[template_name]["path"])
 
-        key_values = {
-            "families": family,
-            "tasks": task_name,
-            "hosts": instance.context.data["hostName"],
-            "task_types": task_type
-        }
-        profile = filter_profiles(
-            self.template_name_profiles,
-            key_values,
-            logger=self.log
-        )
+        is_sequence_representation = isinstance(files, (list, tuple))
+        if is_sequence_representation:
+            # Collection of files (sequence)
+            # Get the sequence as a collection. The files must be of a single
+            # sequence and have no remainder outside of the collections.
+            collections, remainder = clique.assemble(files,
+                                                     minimum_items=1)
+            if not collections:
+                raise ValueError("No collections found in files: "
+                                 "{}".format(files))
+            if remainder:
+                raise ValueError("Files found not detected as part"
+                                 " of a sequence: {}".format(remainder))
+            if len(collections) > 1:
+                raise ValueError("Files in sequence are not part of a"
+                                 " single sequence collection: "
+                                 "{}".format(collections))
+            src_collection = collections[0]
 
-        template_name = "publish"
-        if profile:
-            template_name = profile["template_name"]
-
-        published_representations = {}
-        for idx, repre in enumerate(instance.data["representations"]):
-            # reset transfers for next representation
-            # instance.data['transfers'] is used as a global variable
-            # in current codebase
-            instance.data['transfers'] = list(orig_transfers)
-
-            if "delete" in repre.get("tags", []):
-                continue
-
-            published_files = []
-
-            # create template data for Anatomy
-            template_data = copy.deepcopy(anatomy_data)
-            if intent_value is not None:
-                template_data["intent"] = intent_value
-
-            resolution_width = repre.get("resolutionWidth")
-            resolution_height = repre.get("resolutionHeight")
-            fps = instance.data.get("fps")
-
-            if resolution_width:
-                template_data["resolution_width"] = resolution_width
-            if resolution_width:
-                template_data["resolution_height"] = resolution_height
-            if resolution_width:
-                template_data["fps"] = fps
-
-            files = repre['files']
-            if repre.get('stagingDir'):
-                stagingdir = repre['stagingDir']
-
-            if repre.get("outputName"):
-                template_data["output"] = repre['outputName']
-
-            template_data["representation"] = repre["name"]
-
-            ext = repre["ext"]
-            if ext.startswith("."):
-                self.log.warning((
-                    "Implementaion warning: <\"{}\">"
-                    " Representation's extension stored under \"ext\" key "
-                    " started with dot (\"{}\")."
-                ).format(repre["name"], ext))
-                ext = ext[1:]
-            repre["ext"] = ext
-            template_data["ext"] = ext
-
-            self.log.info(template_name)
-            template = os.path.normpath(
-                anatomy.templates[template_name]["path"])
-
-            sequence_repre = isinstance(files, list)
-            repre_context = None
-            if sequence_repre:
-                self.log.debug(
-                    "files: {}".format(files))
-                src_collections, remainder = clique.assemble(files)
-                self.log.debug(
-                    "src_tail_collections: {}".format(str(src_collections)))
-                src_collection = src_collections[0]
-
-                # Assert that each member has identical suffix
-                src_head = src_collection.format("{head}")
-                src_tail = src_collection.format("{tail}")
-
-                # fix dst_padding
-                valid_files = [x for x in files if src_collection.match(x)]
-                padd_len = len(
-                    valid_files[0].replace(src_head, "").replace(src_tail, "")
-                )
-                src_padding_exp = "%0{}d".format(padd_len)
-
-                test_dest_files = list()
-                for i in [1, 2]:
-                    template_data["representation"] = repre['ext']
-                    if not repre.get("udim"):
-                        template_data["frame"] = src_padding_exp % i
-                    else:
-                        template_data["udim"] = src_padding_exp % i
-
-                    anatomy_filled = anatomy.format(template_data)
-                    template_filled = anatomy_filled[template_name]["path"]
-                    if repre_context is None:
-                        repre_context = template_filled.used_values
-                    test_dest_files.append(
-                        os.path.normpath(template_filled)
-                    )
-                if not repre.get("udim"):
-                    template_data["frame"] = repre_context["frame"]
-                else:
-                    template_data["udim"] = repre_context["udim"]
-
-                self.log.debug(
-                    "test_dest_files: {}".format(str(test_dest_files)))
-
-                dst_collections, remainder = clique.assemble(test_dest_files)
-                dst_collection = dst_collections[0]
-                dst_head = dst_collection.format("{head}")
-                dst_tail = dst_collection.format("{tail}")
-
-                index_frame_start = None
+            # If the representation has `frameStart` set it renumbers the
+            # frame indices of the published collection. It will start from
+            # that `frameStart` index instead. Thus if that frame start
+            # differs from the collection we want to shift the destination
+            # frame indices from the source collection.
+            destination_indexes = list(src_collection.indexes)
+            destination_padding = len(get_first_frame_padded(src_collection))
+            if repre.get("frameStart") is not None:
+                index_frame_start = int(repre.get("frameStart"))
 
                 # TODO use frame padding from right template group
-                if repre.get("frameStart") is not None:
-                    frame_start_padding = int(
-                        anatomy.templates["render"].get(
-                            "frame_padding",
-                            anatomy.templates["render"].get("padding")
-                        )
+                render_template = anatomy.templates["render"]
+                frame_start_padding = int(
+                    render_template.get(
+                        "frame_padding",
+                        render_template.get("padding")
                     )
-
-                    index_frame_start = int(repre.get("frameStart"))
-
-                # exception for slate workflow
-                if index_frame_start and "slate" in instance.data["families"]:
-                    index_frame_start -= 1
-
-                dst_padding_exp = src_padding_exp
-                dst_start_frame = None
-                collection_start = list(src_collection.indexes)[0]
-                for i in src_collection.indexes:
-                    # TODO 1.) do not count padding in each index iteration
-                    # 2.) do not count dst_padding from src_padding before
-                    #   index_frame_start check
-                    frame_number = i - collection_start
-                    src_padding = src_padding_exp % i
-
-                    src_file_name = "{0}{1}{2}".format(
-                        src_head, src_padding, src_tail)
-
-                    dst_padding = src_padding_exp % frame_number
-
-                    if index_frame_start is not None:
-                        dst_padding_exp = "%0{}d".format(frame_start_padding)
-                        dst_padding = dst_padding_exp % (index_frame_start + frame_number)  # noqa: E501
-                    elif repre.get("udim"):
-                        dst_padding = int(i)
-
-                    dst = "{0}{1}{2}".format(
-                        dst_head,
-                        dst_padding,
-                        dst_tail
-                    )
-
-                    self.log.debug("destination: `{}`".format(dst))
-                    src = os.path.join(stagingdir, src_file_name)
-
-                    self.log.debug("source: {}".format(src))
-                    instance.data["transfers"].append([src, dst])
-
-                    published_files.append(dst)
-
-                    # for adding first frame into db
-                    if not dst_start_frame:
-                        dst_start_frame = dst_padding
-
-                # Store used frame value to template data
-                if repre.get("frame"):
-                    template_data["frame"] = dst_start_frame
-
-                dst = "{0}{1}{2}".format(
-                    dst_head,
-                    dst_start_frame,
-                    dst_tail
-                )
-                repre['published_path'] = dst
-
-            else:
-                # Single file
-                #  _______
-                # |      |\
-                # |       |
-                # |       |
-                # |       |
-                # |_______|
-                #
-                template_data.pop("frame", None)
-                fname = files
-                assert not os.path.isabs(fname), (
-                    "Given file name is a full path"
                 )
 
-                template_data["representation"] = repre['ext']
-                # Store used frame value to template data
-                if repre.get("udim"):
-                    template_data["udim"] = repre["udim"][0]
-                src = os.path.join(stagingdir, fname)
-                anatomy_filled = anatomy.format(template_data)
-                template_filled = anatomy_filled[template_name]["path"]
-                repre_context = template_filled.used_values
-                dst = os.path.normpath(template_filled)
-
-                instance.data["transfers"].append([src, dst])
-
-                published_files.append(dst)
-                repre['published_path'] = dst
-                self.log.debug("__ dst: {}".format(dst))
+                # Shift destination sequence to the start frame
+                src_start_frame = next(iter(src_collection.indexes))
+                shift = index_frame_start - src_start_frame
+                if shift:
+                    destination_indexes = [
+                        frame + shift for frame in destination_indexes
+                    ]
+                destination_padding = frame_start_padding
 
+            # To construct the destination template with anatomy we require
+            # a Frame or UDIM tile set for the template data. We use the first
+            # index of the destination for that because that could've shifted
+            # from the source indexes, etc.
+            first_index_padded = get_frame_padded(frame=destination_indexes[0],
+                                                  padding=destination_padding)
             if repre.get("udim"):
-                repre_context["udim"] = repre.get("udim")  # store list
+                # UDIM representations handle ranges in a different manner
+                template_data["udim"] = first_index_padded
+            else:
+                template_data["frame"] = first_index_padded
 
-            repre["publishedFiles"] = published_files
+            # Construct destination collection from template
+            anatomy_filled = anatomy.format(template_data)
+            template_filled = anatomy_filled[template_name]["path"]
+            repre_context = template_filled.used_values
+            self.log.debug("Template filled: {}".format(str(template_filled)))
+            dst_collections, _remainder = clique.assemble(
+                [os.path.normpath(template_filled)], minimum_items=1
+            )
+            assert not _remainder, "This is a bug"
+            assert len(dst_collections) == 1, "This is a bug"
+            dst_collection = dst_collections[0]
 
-            for key in self.db_representation_context_keys:
-                value = template_data.get(key)
-                if not value:
-                    continue
-                repre_context[key] = template_data[key]
+            # Update the destination indexes and padding
+            dst_collection.indexes = destination_indexes
+            dst_collection.padding = destination_padding
+            assert len(src_collection) == len(dst_collection), "This is a bug"
 
-            # Use previous representation's id if there are any
-            repre_id = None
-            repre_name_low = repre["name"].lower()
-            for _repre in existing_repres:
-                # NOTE should we check lowered names?
-                if repre_name_low == _repre["name"]:
-                    repre_id = _repre["orig_id"]
-                    break
+            transfers = []
+            for src_file_name, dst in zip(src_collection, dst_collection):
+                src = os.path.join(stagingdir, src_file_name)
+                self.log.debug("source: {}".format(src))
+                self.log.debug("destination: `{}`".format(dst))
+                transfers.append(src, dst)
 
-            # Create new id if existing representations does not match
-            if repre_id is None:
-                repre_id = io.ObjectId()
+            # Store first frame as published path
+            # todo: remove `published_path` since it can be retrieved from
+            #       `transfers` by taking the first destination transfers[0][1]
+            repre['published_path'] = next(iter(dst_collection))
+            repre["transfers"].extend(transfers)
 
-            data = repre.get("data") or {}
-            data.update({'path': dst, 'template': template})
-            representation = {
-                "_id": repre_id,
-                "schema": "openpype:representation-2.0",
-                "type": "representation",
-                "parent": version_id,
-                "name": repre['name'],
-                "data": data,
-                "dependencies": instance.data.get("dependencies", "").split(),
+        else:
+            # Single file
+            template_data.pop("frame", None)
+            fname = files
+            assert not os.path.isabs(fname), (
+                "Given file name is a full path"
+            )
+            # Store used frame value to template data
+            if repre.get("udim"):
+                template_data["udim"] = repre["udim"][0]
+            src = os.path.join(stagingdir, fname)
+            anatomy_filled = anatomy.format(template_data)
+            template_filled = anatomy_filled[template_name]["path"]
+            repre_context = template_filled.used_values
+            dst = os.path.normpath(template_filled)
 
-                # Imprint shortcut to context
-                # for performance reasons.
-                "context": repre_context
-            }
+            # Single file transfer
+            self.log.debug("source: {}".format(src))
+            self.log.debug("destination: `{}`".format(dst))
+            repre["transfers"] = [src, dst]
 
-            if repre.get("outputName"):
-                representation["context"]["output"] = repre['outputName']
+            repre['published_path'] = dst
 
-            if sequence_repre and repre.get("frameStart") is not None:
-                representation['context']['frame'] = (
-                    dst_padding_exp % int(repre.get("frameStart"))
-                )
+        if repre.get("udim"):
+            repre_context["udim"] = repre.get("udim")  # store list
 
-            # any file that should be physically copied is expected in
-            # 'transfers' or 'hardlinks'
-            if instance.data.get('transfers', False) or \
-               instance.data.get('hardlinks', False):
-                # could throw exception, will be caught in 'process'
-                # all integration to DB is being done together lower,
-                # so no rollback needed
-                self.log.debug("Integrating source files to destination ...")
-                self.integrated_file_sizes.update(self.integrate(instance))
-                self.log.debug("Integrated files {}".
-                               format(self.integrated_file_sizes))
+        for key in self.db_representation_context_keys:
+            value = template_data.get(key)
+            if not value:
+                continue
+            repre_context[key] = template_data[key]
 
-            # get 'files' info for representation and all attached resources
-            self.log.debug("Preparing files information ...")
-            representation["files"] = self.get_files_info(
-                instance,
-                self.integrated_file_sizes)
+        # Use previous representation's id if there are any
+        repre_id = None
+        repre_name_lower = repre["name"].lower()
+        for _existing_repre in existing_repres:
+            # NOTE should we check lowered names?
+            if repre_name_lower == _existing_repre["name"].lower():
+                repre_id = _existing_repre["orig_id"]
+                break
 
-            self.log.debug("__ representation: {}".format(representation))
-            destination_list.append(dst)
-            self.log.debug("__ destination_list: {}".format(destination_list))
-            instance.data['destination_list'] = destination_list
-            representations.append(representation)
-            published_representations[repre_id] = {
-                "representation": representation,
-                "anatomy_data": template_data,
-                "published_files": published_files
-            }
-            self.log.debug("__ representations: {}".format(representations))
+        # Create new id if existing representations does not match
+        if repre_id is None:
+            repre_id = io.ObjectId()
 
-        # Remove old representations if there are any (before insertion of new)
-        if existing_repres:
-            repre_ids_to_remove = []
-            for repre in existing_repres:
-                repre_ids_to_remove.append(repre["_id"])
-            io.delete_many({"_id": {"$in": repre_ids_to_remove}})
+        # todo: `repre` is not the actual `representation` entity
+        #       we should simplify/clarify difference between data above
+        #       and the actual representation entity for the database
+        data = repre.get("data") or {}
+        data.update({'path': dst, 'template': template})
+        representation = {
+            "_id": repre_id,
+            "schema": "openpype:representation-2.0",
+            "type": "representation",
+            "parent": version["_id"],
+            "name": repre['name'],
+            "data": data,
+            "dependencies": instance.data.get("dependencies", "").split(),
 
-        for rep in instance.data["representations"]:
-            self.log.debug("__ rep: {}".format(rep))
+            # Imprint shortcut to context for performance reasons.
+            "context": repre_context
+        }
 
-        io.insert_many(representations)
-        instance.data["published_representations"] = (
-            published_representations
+        if repre.get("outputName"):
+            representation["context"]["output"] = repre['outputName']
+
+        if is_sequence_representation and repre.get("frameStart") is not None:
+            representation['context']['frame'] = template_data["frame"]
+
+        # any file that should be physically copied is expected in
+        # 'transfers' or 'hardlinks'
+        integrated_files = []
+        if instance.data.get('transfers', False) or \
+                instance.data.get('hardlinks', False):
+            # could throw exception, will be caught in 'process'
+            # all integration to DB is being done together lower,
+            # so no rollback needed
+            # todo: separate the actual integrating of the files onto its own
+            #       taking just a list of transfers as inputs (potentially
+            #       with copy mode flag, like hardlink/copy, etc.)
+            self.log.debug("Integrating source files to destination ...")
+            integrated_files = self.integrate(instance)
+            self.log.debug("Integrated files {}".format(integrated_files))
+
+        # get 'files' info for representation and all attached resources
+        self.log.debug("Preparing files information ...")
+        representation["files"] = self.get_files_info(
+            instance,
+            integrated_files
         )
-        # self.log.debug("Representation: {}".format(representations))
-        self.log.info("Registered {} items".format(len(representations)))
+
+        return {
+            "representation": representation,
+            "anatomy_data": template_data,
+            # todo: avoid the need for 'published_files'?
+            # backwards compatibility
+            "published_files": [transfer[1] for transfer in repre["transfers"]]
+        }
 
     def integrate(self, instance):
         """ Move the files.
@@ -653,92 +641,93 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             Args:
                 instance: the instance to integrate
             Returns:
-                integrated_file_sizes: dictionary of destination file url and
-                its size in bytes
+                list: destination full paths of integrated files
         """
-        # store destination url and size for reporting and rollback
-        integrated_file_sizes = {}
+        # store destinations for potential rollback and measuring sizes
+        destinations = []
         transfers = list(instance.data.get("transfers", list()))
         for src, dest in transfers:
-            if os.path.normpath(src) != os.path.normpath(dest):
+            src = os.path.normpath(src)
+            dest = os.path.normpath(dest)
+            if src != dest:
                 dest = self.get_dest_temp_url(dest)
                 self.copy_file(src, dest)
-                # TODO needs to be updated during site implementation
-                integrated_file_sizes[dest] = os.path.getsize(dest)
+                destinations.append(dest)
 
         # Produce hardlinked copies
-        # Note: hardlink can only be produced between two files on the same
-        # server/disk and editing one of the two will edit both files at once.
-        # As such it is recommended to only make hardlinks between static files
-        # to ensure publishes remain safe and non-edited.
         hardlinks = instance.data.get("hardlinks", list())
         for src, dest in hardlinks:
             dest = self.get_dest_temp_url(dest)
-            self.log.debug("Hardlinking file ... {} -> {}".format(src, dest))
             if not os.path.exists(dest):
                 self.hardlink_file(src, dest)
 
-            # TODO needs to be updated during site implementation
-            integrated_file_sizes[dest] = os.path.getsize(dest)
+            destinations.append(dest)
 
-        return integrated_file_sizes
+        return destinations
+
+    def _create_folder_for_file(self, path):
+        dirname = os.path.dirname(path)
+        try:
+            os.makedirs(dirname)
+        except OSError as e:
+            if e.errno == errno.EEXIST:
+                pass
+            else:
+                self.log.critical("An unexpected error occurred.")
+                six.reraise(*sys.exc_info())
 
     def copy_file(self, src, dst):
-        """ Copy given source to destination
+        """Copy source filepath to destination filepath
 
         Arguments:
             src (str): the source file which needs to be copied
-            dst (str): the destination of the sourc file
+            dst (str): the destination filepath
+
+        Returns:
+            None
+
+        """
+        self._create_folder_for_file(dst)
+        self.log.debug("Copying file ... {} -> {}".format(src, dst))
+        copyfile(src, dst)
+
+    def hardlink_file(self, src, dst):
+        """Hardlink source filepath to destination filepath.
+
+        Note:
+            Hardlink can only be produced between two files on the same
+            server/disk and editing one of the two will edit both files at
+            once. As such it is recommended to only make hardlinks between
+            static files to ensure publishes remain safe and non-edited.
+
+        Arguments:
+            src (str): the source file which needs to be hardlinked
+            dst (str): the destination filepath
+
         Returns:
             None
         """
-        src = os.path.normpath(src)
-        dst = os.path.normpath(dst)
-        self.log.debug("Copying file ... {} -> {}".format(src, dst))
-        dirname = os.path.dirname(dst)
-        try:
-            os.makedirs(dirname)
-        except OSError as e:
-            if e.errno == errno.EEXIST:
-                pass
-            else:
-                self.log.critical("An unexpected error occurred.")
-                six.reraise(*sys.exc_info())
-
-        # copy file with speedcopy and check if size of files are simetrical
-        while True:
-            if not shutil._samefile(src, dst):
-                copyfile(src, dst)
-            else:
-                self.log.critical(
-                    "files are the same {} to {}".format(src, dst)
-                )
-                os.remove(dst)
-                try:
-                    shutil.copyfile(src, dst)
-                    self.log.debug("Copying files with shutil...")
-                except OSError as e:
-                    self.log.critical("Cannot copy {} to {}".format(src, dst))
-                    self.log.critical(e)
-                    six.reraise(*sys.exc_info())
-            if str(getsize(src)) in str(getsize(dst)):
-                break
-
-    def hardlink_file(self, src, dst):
-        dirname = os.path.dirname(dst)
-
-        try:
-            os.makedirs(dirname)
-        except OSError as e:
-            if e.errno == errno.EEXIST:
-                pass
-            else:
-                self.log.critical("An unexpected error occurred.")
-                six.reraise(*sys.exc_info())
-
+        self._create_folder_for_file(dst)
+        self.log.debug("Hardlinking file ... {} -> {}".format(src, dst))
         create_hard_link(src, dst)
 
-    def get_subset(self, asset, instance):
+    def _get_instance_families(self, instance):
+        """Get all families of the instance"""
+        # todo: move this to lib?
+        family = instance.data.get("family")
+        families = []
+        if family:
+            families.append(family)
+
+        for _family in (instance.data.get("families") or []):
+            if _family not in families:
+                families.append(_family)
+
+        return families
+
+    def register_subset(self, instance):
+        # todo: rely less on self.prepare_anatomy to create this value
+        asset = instance.data.get("assetEntity") # <- from prepare_anatomy :(
         subset_name = instance.data["subset"]
         subset = io.find_one({
             "type": "subset",
@@ -748,18 +737,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         if subset is None:
             self.log.info("Subset '%s' not found, creating ..." % subset_name)
-            self.log.debug("families.  %s" % instance.data.get('families'))
-            self.log.debug(
-                "families.  %s" % type(instance.data.get('families')))
-
-            family = instance.data.get("family")
-            families = []
-            if family:
-                families.append(family)
-
-            for _family in (instance.data.get("families") or []):
-                if _family not in families:
-                    families.append(_family)
+            families = self._get_instance_families(instance)
 
             _id = io.insert_one({
                 "schema": "openpype:subset-3.0",
@@ -773,8 +751,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
             subset = io.find_one({"_id": _id})
 
-        # QUESTION Why is changing of group and updating it's
-        #   families in 'get_subset'?
+        # Update subset group
         self._set_subset_group(instance, subset["_id"])
 
         # Update families on subset.
@@ -838,7 +815,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             self.subset_grouping_profiles,
             filtering_criteria
         )
-        # Skip if there is not matchin profile
+        # Skip if there is not matching profile
         if not matching_profile:
             return None
 
@@ -867,41 +844,17 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         return filled_template
 
-    def create_version(self, subset, version_number, data=None):
-        """ Copy given source to destination
-
-        Args:
-            subset (dict): the registered subset of the asset
-            version_number (int): the version number
-
-        Returns:
-            dict: collection of data to create a version
-        """
-
-        return {"schema": "openpype:version-3.0",
-                "type": "version",
-                "parent": subset["_id"],
-                "name": version_number,
-                "data": data}
-
-    def create_version_data(self, context, instance):
+    def create_version_data(self, instance):
         """Create the data collection for the version
 
         Args:
-            context: the current context
             instance: the current instance being published
 
         Returns:
             dict: the required information with instance.data as key
         """
 
-        families = []
-        current_families = instance.data.get("families", list())
-        instance_family = instance.data.get("family", None)
-
-        if instance_family is not None:
-            families.append(instance_family)
-        families += current_families
+        context = instance.context
 
         # create relative source path for DB
         if "source" in instance.data:
@@ -910,10 +863,10 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             source = context.data["currentFile"]
             anatomy = instance.context.data["anatomy"]
             source = self.get_rootless_path(anatomy, source)
-
         self.log.debug("Source: {}".format(source))
+
         version_data = {
-            "families": families,
+            "families": self._get_instance_families(instance),
             "time": context.data["time"],
             "author": context.data["user"],
             "source": source,
@@ -924,7 +877,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             )
         }
 
-        intent_value = instance.context.data.get("intent")
+        intent_value = context.data.get("intent")
         if intent_value and isinstance(intent_value, dict):
             intent_value = intent_value.get("value")
 
@@ -944,10 +897,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
     def main_family_from_instance(self, instance):
         """Returns main family of entered instance."""
-        family = instance.data.get("family")
-        if not family:
-            family = instance.data["families"][0]
-        return family
+        return self._get_instance_families(instance)[0]
 
     def get_rootless_path(self, anatomy, path):
         """  Returns, if possible, path without absolute portion from host
@@ -976,7 +926,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             ).format(path))
         return path
 
-    def get_files_info(self, instance, integrated_file_sizes):
+    def get_files_info(self, instance):
         """ Prepare 'files' portion for attached resources and main asset.
             Combining records from 'transfers' and 'hardlinks' parts from
             instance.
@@ -991,27 +941,18 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             output_resources: array of dictionaries to be added to 'files' key
             in representation
         """
+        # todo: refactor to use transfers/hardlinks of representations
+        #       currently broken logic
         resources = list(instance.data.get("transfers", []))
         resources.extend(list(instance.data.get("hardlinks", [])))
+        self.log.debug("get_files_info.resources:{}".format(resources))
 
-        self.log.debug("get_resource_files_info.resources:{}".
-                       format(resources))
+        sites = self.compute_resource_sync_sites(instance)
 
         output_resources = []
         anatomy = instance.context.data["anatomy"]
         for _src, dest in resources:
-            path = self.get_rootless_path(anatomy, dest)
-            dest = self.get_dest_temp_url(dest)
-            file_hash = openpype.api.source_hash(dest)
-            if self.TMP_FILE_EXT and \
-               ',{}'.format(self.TMP_FILE_EXT) in file_hash:
-                file_hash = file_hash.replace(',{}'.format(self.TMP_FILE_EXT),
-                                              '')
-
-            file_info = self.prepare_file_info(path,
-                                               integrated_file_sizes[dest],
-                                               file_hash,
-                                               instance=instance)
+            file_info = self.prepare_file_info(dest, anatomy, sites=sites)
             output_resources.append(file_info)
 
         return output_resources
@@ -1031,8 +972,11 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             dest += '.{}'.format(self.TMP_FILE_EXT)
         return dest
 
-    def prepare_file_info(self, path, size=None, file_hash=None,
-                          sites=None, instance=None):
+    def get_dest_final_url(self, temp_file_url):
+        """Temporary destination file url to final destination file url"""
+        return re.sub(r'\.{}$'.format(self.TMP_FILE_EXT), '', temp_file_url)
+
+    def prepare_file_info(self, path, anatomy, sites):
         """ Prepare information for one file (asset or resource)
 
         Arguments:
@@ -1042,74 +986,78 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             sites(optional): array of published locations,
                             [ {'name':'studio', 'created_dt':date} by default
                                 keys expected ['studio', 'site1', 'gdrive1']
-            instance(dict, optional): to get collected settings
         Returns:
             rec: dictionary with filled info
         """
+        file_hash = openpype.api.source_hash(path)
+
+        # todo: Avoid this logic
+        # Strip the temporary file extension from the file hash
+        if self.TMP_FILE_EXT and ',{}'.format(self.TMP_FILE_EXT) in file_hash:
+            file_hash = file_hash.replace(',{}'.format(self.TMP_FILE_EXT), '')
+
+        return {
+            "_id": io.ObjectId(),
+            "path": self.get_rootless_path(anatomy, path),
+            "size": os.path.getsize(path),
+            "hash": file_hash,
+            "sites": sites
+        }
+
+    def compute_resource_sync_sites(self, instance):
+        """Get available resource sync sites"""
+        # Sync server logic
+        # TODO: Clean up sync settings
         local_site = 'studio'  # default
         remote_site = None
-        always_accesible = []
+        always_accessible = []
         sync_project_presets = None
 
-        rec = {
-            "_id": io.ObjectId(),
-            "path": path
-        }
-        if size:
-            rec["size"] = size
+        system_sync_server_presets = (
+            instance.context.data["system_settings"]
+                                 ["modules"]
+                                 ["sync_server"])
+        log.debug("system_sett:: {}".format(system_sync_server_presets))
 
-        if file_hash:
-            rec["hash"] = file_hash
-
-        if sites:
-            rec["sites"] = sites
-        else:
-            system_sync_server_presets = (
-                instance.context.data["system_settings"]
-                                     ["modules"]
+        if system_sync_server_presets["enabled"]:
+            sync_project_presets = (
+                instance.context.data["project_settings"]
+                                     ["global"]
                                      ["sync_server"])
-            log.debug("system_sett:: {}".format(system_sync_server_presets))
 
-            if system_sync_server_presets["enabled"]:
-                sync_project_presets = (
-                    instance.context.data["project_settings"]
-                                         ["global"]
-                                         ["sync_server"])
+        if sync_project_presets and sync_project_presets["enabled"]:
+            local_site, remote_site = self._get_sites(sync_project_presets)
+            always_accessible = sync_project_presets["config"]. \
+                get("always_accessible_on", [])
 
-            if sync_project_presets and sync_project_presets["enabled"]:
-                local_site, remote_site = self._get_sites(sync_project_presets)
+        already_attached_sites = {}
+        meta = {"name": local_site, "created_dt": datetime.now()}
+        sites = [meta]
+        already_attached_sites[meta["name"]] = meta["created_dt"]
 
-                always_accesible = sync_project_presets["config"]. \
-                    get("always_accessible_on", [])
+        if sync_project_presets and sync_project_presets["enabled"]:
+            if remote_site and \
+                    remote_site not in already_attached_sites.keys():
+                # add remote
+                meta = {"name": remote_site.strip()}
+                sites.append(meta)
+                already_attached_sites[meta["name"]] = None
 
-            already_attached_sites = {}
-            meta = {"name": local_site, "created_dt": datetime.now()}
-            rec["sites"] = [meta]
-            already_attached_sites[meta["name"]] = meta["created_dt"]
-
-            if sync_project_presets and sync_project_presets["enabled"]:
-                if remote_site and \
-                        remote_site not in already_attached_sites.keys():
-                    # add remote
-                    meta = {"name": remote_site.strip()}
-                    rec["sites"].append(meta)
+            # add skeleton for site where it should be always synced to
+            for always_on_site in always_accessible:
+                if always_on_site not in already_attached_sites.keys():
+                    meta = {"name": always_on_site.strip()}
+                    sites.append(meta)
                     already_attached_sites[meta["name"]] = None
 
-                # add skeleton for site where it should be always synced to
-                for always_on_site in always_accesible:
-                    if always_on_site not in already_attached_sites.keys():
-                        meta = {"name": always_on_site.strip()}
-                        rec["sites"].append(meta)
-                        already_attached_sites[meta["name"]] = None
+            # add alternative sites
+            alt = self._add_alternative_sites(system_sync_server_presets,
+                                              already_attached_sites)
+            sites.extend(alt)
 
-                # add alternative sites
-                rec = self._add_alternative_sites(system_sync_server_presets,
-                                                  already_attached_sites,
-                                                  rec)
+        log.debug("final sites:: {}".format(sites))
 
-            log.debug("final sites:: {}".format(rec["sites"]))
-
-        return rec
+        return sites
 
     def _get_sites(self, sync_project_presets):
         """Returns tuple (local_site, remote_site)"""
@@ -1129,14 +1077,14 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
     def _add_alternative_sites(self,
                                system_sync_server_presets,
-                               already_attached_sites,
-                               rec):
+                               already_attached_sites):
         """Loop through all configured sites and add alternatives.
 
             See SyncServerModule.handle_alternate_site
         """
         conf_sites = system_sync_server_presets.get("sites", {})
 
+        alternative_sites = []
         for site_name, site_info in conf_sites.items():
             alt_sites = set(site_info.get("alternative_sites", []))
             already_attached_keys = list(already_attached_sites.keys())
@@ -1149,12 +1097,12 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                     # alt site inherits state of 'created_dt'
                     if real_created:
                         meta["created_dt"] = real_created
-                    rec["sites"].append(meta)
+                    alternative_sites.append(meta)
                     already_attached_sites[meta["name"]] = real_created
 
-        return rec
+        return alternative_sites
 
-    def handle_destination_files(self, integrated_file_sizes, mode):
+    def handle_destination_files(self, destinations, mode):
         """ Clean destination files
             Called when error happened during integrating to DB or to disk
             OR called to rename uploaded files from temporary name to final to
@@ -1162,46 +1110,38 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             Used to clean unwanted files
 
         Arguments:
-            integrated_file_sizes: dictionary, file urls as keys, size as value
+            destinations (list): file paths
             mode: 'remove' - clean files,
                   'finalize' - rename files,
                                remove TMP_FILE_EXT suffix denoting temp file
         """
-        if integrated_file_sizes:
-            for file_url, _file_size in integrated_file_sizes.items():
-                if not os.path.exists(file_url):
+        if not destinations:
+            return
+
+        for file_url in destinations:
+            if not os.path.exists(file_url):
+                self.log.debug(
+                    "File {} was not found.".format(file_url)
+                )
+                continue
+
+            try:
+                if mode == 'remove':
+                    self.log.debug("Removing file {}".format(file_url))
+                    os.remove(file_url)
+                if mode == 'finalize':
+
+                    new_name = self.get_dest_final_url(file_url)
+                    if os.path.exists(new_name):
+                        self.log.debug("Removing existing "
+                                       "file: {}".format(new_name))
+                        os.remove(new_name)
+
                     self.log.debug(
-                        "File {} was not found.".format(file_url)
+                        "Renaming file {} to {}".format(file_url, new_name)
                     )
-                    continue
-
-                try:
-                    if mode == 'remove':
-                        self.log.debug("Removing file {}".format(file_url))
-                        os.remove(file_url)
-                    if mode == 'finalize':
-                        new_name = re.sub(
-                            r'\.{}$'.format(self.TMP_FILE_EXT),
-                            '',
-                            file_url
-                        )
-
-                        if os.path.exists(new_name):
-                            self.log.debug(
-                                "Overwriting file {} to {}".format(
-                                    file_url, new_name
-                                )
-                            )
-                            shutil.copy(file_url, new_name)
-                            os.remove(file_url)
-                        else:
-                            self.log.debug(
-                                "Renaming file {} to {}".format(
-                                    file_url, new_name
-                                )
-                            )
-                            os.rename(file_url, new_name)
-                except OSError:
-                    self.log.error("Cannot {} file {}".format(mode, file_url),
-                                   exc_info=True)
-                    six.reraise(*sys.exc_info())
+                    os.rename(file_url, new_name)
+            except OSError:
+                self.log.error("Cannot {} file {}".format(mode, file_url),
+                               exc_info=True)
+                six.reraise(*sys.exc_info())

From ae1a9ff4cf996445bd74dcd7641639ed8342592e Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 17 Mar 2022 11:49:12 +0100
Subject: [PATCH 0011/1227] More refactoring + draft (untested) implementation
 for separating File Transaction logic

---
 openpype/plugins/publish/integrate_new.py | 421 +++++++++++-----------
 1 file changed, 215 insertions(+), 206 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index e4986e3b3f..500456eaed 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -1,12 +1,10 @@
 import os
-from os.path import getsize
 import logging
 import sys
 import copy
 import clique
 import errno
 import six
-import re
 
 from pymongo import DeleteOne, InsertOne, UpdateOne
 import pyblish.api
@@ -14,7 +12,6 @@ from avalon import io
 from avalon.api import format_template_with_optional_keys
 import openpype.api
 from datetime import datetime
-# from pype.modules import ModulesManager
 from openpype.lib.profiles_filtering import filter_profiles
 from openpype.lib import (
     prepare_template_data,
@@ -41,6 +38,160 @@ def get_first_frame_padded(collection):
     return get_frame_padded(start_frame, padding=collection.padding)
 
 
+class FileTransaction(object):
+    """
+
+    The file transaction is a three step process.
+
+    1) Rename any existing files to a "temporary backup" during `process()`
+    2) Copy the files to final destination during `process()`
+    3) Remove any backed up files (*no rollback possible!) during `finalize()`
+
+    Step 3 is done during `finalize()`. If not called the .bak files will
+    remain on disk.
+
+    These steps try to ensure that we don't overwrite half of any existing
+    files e.g. if they are currently in use.
+
+    Note:
+        A regular filesystem is *not* a transactional file system and even
+        though this implementation tries to produce a 'safe copy' with a
+        potential rollback do keep in mind that it's inherently unsafe due
+        to how filesystem works and a myriad of things could happen during
+        the transaction that break the logic. A file storage could go down,
+        permissions could be changed, other machines could be moving or writing
+        files. A lot can happen.
+
+    Warning:
+        Any folders created during the transfer will not be removed.
+
+    """
+
+    MODE_COPY = 0
+    MODE_HARDLINK = 1
+
+    def __init__(self, log=None):
+
+        if log is None:
+            log = logging.getLogger("FileTransaction")
+
+        self.log = log
+
+        # The transfer queue
+        # todo: make this an actual FIFO queue?
+        self._transfers = {}
+
+        # Destination file paths that a file was transferred to
+        self._transferred = []
+
+        # Backup file location mapping to original locations
+        self._backup_to_original = {}
+
+    def add(self, src, dst, mode=MODE_COPY):
+        """Add a new file to transfer queue"""
+        opts = {"mode": mode}
+
+        src = os.path.normpath(src)
+        dst = os.path.normpath(dst)
+
+        if dst in self._transfers:
+            queued_src = self._transfers[dst][0]
+            if src == queued_src:
+                self.log.debug("File transfer was already "
+                               "in queue: {} -> {}".format(src, dst))
+                return
+            else:
+                self.log.warning("File transfer in queue overwritten")
+
+        self._transfers[dst] = (src, opts)
+
+    def process(self):
+
+        # Backup any existing files
+        for dst in self._transfers.keys():
+            if os.path.exists(dst):
+                # Backup original file
+                # todo: add timestamp or uuid to ensure unique
+                backup = dst + ".bak"
+                self._backup_to_original[backup] = dst
+                self.log.debug("Backup existing file: "
+                               "{} -> {}".format(dst, backup))
+                os.rename(dst, backup)
+
+        # Copy the files to transfer
+        for dst, (src, opts) in self._transfers.items():
+            self._create_folder_for_file(dst)
+
+            if opts["mode"] == self.MODE_COPY:
+                self.log.debug("Copying file ... {} -> {}".format(src, dst))
+                copyfile(src, dst)
+            elif opts["mode"] == self.MODE_HARDLINK:
+                self.log.debug("Hardlinking file ... {} -> {}".format(src, dst))
+                create_hard_link(src, dst)
+
+            self._transferred.append(dst)
+
+    def finalize(self):
+        # Delete any backed up files
+        for backup in self._backup_to_original.keys():
+            try:
+                os.remove(backup)
+            except OSError:
+                self.log.error("Failed to remove backup file: "
+                               "{}".format(backup),
+                               exc_info=True)
+
+    def rollback(self):
+
+        errors = 0
+
+        # Rollback any transferred files
+        for path in self._transferred:
+            try:
+                os.remove(path)
+            except OSError:
+                errors += 1
+                self.log.error("Failed to rollback created file: "
+                               "{}".format(path),
+                               exc_info=True)
+
+        # Rollback the backups
+        for backup, original in self._backup_to_original.items():
+            try:
+                os.rename(backup, original)
+            except OSError:
+                errors +=1
+                self.log.error("Failed to restore original file: "
+                               "{} -> {}".format(backup, original),
+                               exc_info=True)
+
+        if errors:
+            self.log.error("{} errors occurred during "
+                           "rollback.".format(errors), exc_info=True)
+            six.reraise(*sys.exc_info())
+
+    @property
+    def transferred(self):
+        """Return the processed transfers destination paths"""
+        return list(self._transferred)
+
+    @property
+    def backups(self):
+        """Return the backup file paths"""
+        return list(self._backup_to_original.keys())
+
+    def _create_folder_for_file(self, path):
+        dirname = os.path.dirname(path)
+        try:
+            os.makedirs(dirname)
+        except OSError as e:
+            if e.errno == errno.EEXIST:
+                pass
+            else:
+                self.log.critical("An unexpected error occurred.")
+                six.reraise(*sys.exc_info())
+
+
 class IntegrateAssetNew(pyblish.api.InstancePlugin):
     """Resolve any dependency issues
 
@@ -122,18 +273,11 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     ]
     default_template_name = "publish"
 
-    # suffix to denote temporary files, use without '.'
-    TMP_FILE_EXT = 'tmp'
-
-    # file_url : file_size of all published and uploaded files
-    destinations = list()
-
     # Attributes set by settings
     template_name_profiles = None
     subset_grouping_profiles = None
 
     def process(self, instance):
-        self.destinations = []
 
         # Exclude instances that also contain families from exclude families
         families = set(
@@ -143,17 +287,20 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         if families & set(self.exclude_families):
             return
 
+        file_transactions = FileTransaction(log=self.log)
         try:
-            self.register(instance)
-            self.log.info("Integrated Asset in to the database ...")
-            self.handle_destination_files(self.destinations,
-                                          'finalize')
+            self.register(instance, file_transactions)
         except Exception:
             # clean destination
+            # todo: rollback any registered entities? (or how safe are we?)
+            file_transactions.rollback()
             self.log.critical("Error when registering", exc_info=True)
-            self.handle_destination_files(self.destinations, 'remove')
             six.reraise(*sys.exc_info())
 
+        # Finalizing can't be rollbacked safely so no use for moving it to
+        # the try, except.
+        file_transactions.finalize()
+
     def prepare_anatomy(self, instance):
         """Prepare anatomy data used to define representation destinations"""
 
@@ -244,7 +391,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         return template_name, anatomy_data
 
-    def register(self, instance):
+    def register(self, instance, file_transactions):
 
         instance_stagingdir = instance.data.get("stagingDir")
         if not instance_stagingdir:
@@ -272,9 +419,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         version = self.register_version(instance, subset)
         instance.data["versionEntity"] = version
-        instance.data['version'] = version['name']
 
-        existing_repres = list(io.find({
+        archived_repres = list(io.find({
             "parent": version["_id"],
             "type": "archived_representation"
         }))
@@ -294,19 +440,47 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             prepared = self.prepare_representation(repre,
                                                    anatomy_data,
                                                    template_name,
-                                                   existing_repres,
+                                                   archived_repres,
                                                    version,
                                                    instance_stagingdir,
                                                    instance)
+            representation = prepared["representation"]
+
+            # todo: register the file transfers correctly
+            for src, dst in representation["transfers"]:
+                file_transactions.add(src, dst,
+                                      mode=file_transactions.MODE_COPY)
+            for src, dst in representation["hardlinks"]:
+                file_transactions.add(src, dst,
+                                      mode=file_transactions.MODE_HARDLINK)
 
             # todo: simplify this?
-            representation = prepared["representation"]
             representations.append(representation)
             published_representations[representation["_id"]] = prepared
 
+        # could throw exception, will be caught in 'process'
+        # all integration to DB is being done together lower,
+        # so no rollback needed
+        self.log.debug("Integrating source files to destination ...")
+        file_transactions.process()
+        self.log.debug("Backup files "
+                       "{}".format(file_transactions.backups))
+        self.log.debug("Integrated files "
+                       "{}".format(file_transactions.transferred))
+
+        # todo: fix get file info for transferred files per representation
+        #       currently it'd set all files for all representations
+        # get 'files' info for representation and all attached resources
+        integrated_files = file_transactions.transferred
+        self.log.debug("Preparing files information ...")
+        representation["files"] = self.get_files_info(
+            instance,
+            integrated_files
+        )
+
         # Remove old representations if there are any (before insertion of new)
-        if existing_repres:
-            repre_ids_to_remove = [repre["_id"] for repre in existing_repres]
+        if archived_repres:
+            repre_ids_to_remove = [repre["_id"] for repre in archived_repres]
             io.delete_many({"_id": {"$in": repre_ids_to_remove}})
 
         # Write the new representations to the database
@@ -395,7 +569,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     def prepare_representation(self, repre,
                                anatomy_data,
                                template_name,
-                               existing_repres,
+                               archived_repres,
                                version,
                                instance_stagingdir,
                                instance):
@@ -439,11 +613,13 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             self.log.debug("Representation uses instance staging dir: "
                            "{}".format(instance_stagingdir))
             stagingdir = instance_stagingdir
+        if not stagingdir:
+            raise ValueError("No staging directory set for representation: "
+                             "{}".format(repre))
 
         self.log.debug("Anatomy template name: {}".format(template_name))
         anatomy = instance.context.data['anatomy']
-        template = os.path.normpath(
-            anatomy.templates[template_name]["path"])
+        template = os.path.normpath(anatomy.templates[template_name]["path"])
 
         is_sequence_representation = isinstance(files, (list, tuple))
         if is_sequence_representation:
@@ -566,24 +742,21 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 continue
             repre_context[key] = template_data[key]
 
-        # Use previous representation's id if there are any
-        repre_id = None
-        repre_name_lower = repre["name"].lower()
-        for _existing_repre in existing_repres:
-            # NOTE should we check lowered names?
-            if repre_name_lower == _existing_repre["name"].lower():
-                repre_id = _existing_repre["orig_id"]
-                break
+        # Define representation id
+        repre_id = io.ObjectId()
 
-        # Create new id if existing representations does not match
-        if repre_id is None:
-            repre_id = io.ObjectId()
+        # Use previous representation's id if there is a name match
+        repre_name_lower = repre["name"].lower()
+        for _archived_repres in archived_repres:
+            if repre_name_lower == _archived_repres["name"].lower():
+                repre_id = _archived_repres["orig_id"]
+                break
 
         # todo: `repre` is not the actual `representation` entity
         #       we should simplify/clarify difference between data above
         #       and the actual representation entity for the database
         data = repre.get("data") or {}
-        data.update({'path': dst, 'template': template})
+        data.update({'path': repre["published_path"], 'template': template})
         representation = {
             "_id": repre_id,
             "schema": "openpype:representation-2.0",
@@ -597,34 +770,14 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "context": repre_context
         }
 
+        # todo: simplify/streamline which additional data makes its way into
+        #       the representation context
         if repre.get("outputName"):
             representation["context"]["output"] = repre['outputName']
 
         if is_sequence_representation and repre.get("frameStart") is not None:
             representation['context']['frame'] = template_data["frame"]
 
-        # any file that should be physically copied is expected in
-        # 'transfers' or 'hardlinks'
-        integrated_files = []
-        if instance.data.get('transfers', False) or \
-                instance.data.get('hardlinks', False):
-            # could throw exception, will be caught in 'process'
-            # all integration to DB is being done together lower,
-            # so no rollback needed
-            # todo: separate the actual integrating of the files onto its own
-            #       taking just a list of transfers as inputs (potentially
-            #       with copy mode flag, like hardlink/copy, etc.)
-            self.log.debug("Integrating source files to destination ...")
-            integrated_files = self.integrate(instance)
-            self.log.debug("Integrated files {}".format(integrated_files))
-
-        # get 'files' info for representation and all attached resources
-        self.log.debug("Preparing files information ...")
-        representation["files"] = self.get_files_info(
-            instance,
-            integrated_files
-        )
-
         return {
             "representation": representation,
             "anatomy_data": template_data,
@@ -633,84 +786,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "published_files": [transfer[1] for transfer in repre["transfers"]]
         }
 
-    def integrate(self, instance):
-        """ Move the files.
-
-            Through `instance.data["transfers"]`
-
-            Args:
-                instance: the instance to integrate
-            Returns:
-                list: destination full paths of integrated files
-        """
-        # store destinations for potential rollback and measuring sizes
-        destinations = []
-        transfers = list(instance.data.get("transfers", list()))
-        for src, dest in transfers:
-            src = os.path.normpath(src)
-            dest = os.path.normpath(dest)
-            if src != dest:
-                dest = self.get_dest_temp_url(dest)
-                self.copy_file(src, dest)
-                destinations.append(dest)
-
-        # Produce hardlinked copies
-        hardlinks = instance.data.get("hardlinks", list())
-        for src, dest in hardlinks:
-            dest = self.get_dest_temp_url(dest)
-            if not os.path.exists(dest):
-                self.hardlink_file(src, dest)
-
-            destinations.append(dest)
-
-        return destinations
-
-    def _create_folder_for_file(self, path):
-        dirname = os.path.dirname(path)
-        try:
-            os.makedirs(dirname)
-        except OSError as e:
-            if e.errno == errno.EEXIST:
-                pass
-            else:
-                self.log.critical("An unexpected error occurred.")
-                six.reraise(*sys.exc_info())
-
-    def copy_file(self, src, dst):
-        """Copy source filepath to destination filepath
-
-        Arguments:
-            src (str): the source file which needs to be copied
-            dst (str): the destination filepath
-
-        Returns:
-            None
-
-        """
-        self._create_folder_for_file(dst)
-        self.log.debug("Copying file ... {} -> {}".format(src, dst))
-        copyfile(src, dst)
-
-    def hardlink_file(self, src, dst):
-        """Hardlink source filepath to destination filepath.
-
-        Note:
-            Hardlink can only be produced between two files on the same
-            server/disk and editing one of the two will edit both files at
-            once. As such it is recommended to only make hardlinks between
-            static files to ensure publishes remain safe and non-edited.
-
-        Arguments:
-            src (str): the source file which needs to be hardlinked
-            dst (str): the destination filepath
-
-        Returns:
-            None
-        """
-        self._create_folder_for_file(dst)
-        self.log.debug("Hardlinking file ... {} -> {}".format(src, dst))
-        create_hard_link(src, dst)
-
     def _get_instance_families(self, instance):
         """Get all families of the instance"""
         # todo: move this to lib?
@@ -727,7 +802,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
     def register_subset(self, instance):
         # todo: rely less on self.prepare_anatomy to create this value
-        asset = instance.data.get("assetEntity") # <- from prepare_anatomy :(
+        asset = instance.data.get("assetEntity")  # stored by prepare_anatomy
         subset_name = instance.data["subset"]
         subset = io.find_one({
             "type": "subset",
@@ -957,25 +1032,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         return output_resources
 
-    def get_dest_temp_url(self, dest):
-        """ Enhance destination path with TMP_FILE_EXT to denote temporary
-            file.
-            Temporary files will be renamed after successful registration
-            into DB and full copy to destination
-
-        Arguments:
-            dest: destination url of published file (absolute)
-        Returns:
-            dest: destination path + '.TMP_FILE_EXT'
-        """
-        if self.TMP_FILE_EXT and '.{}'.format(self.TMP_FILE_EXT) not in dest:
-            dest += '.{}'.format(self.TMP_FILE_EXT)
-        return dest
-
-    def get_dest_final_url(self, temp_file_url):
-        """Temporary destination file url to final destination file url"""
-        return re.sub(r'\.{}$'.format(self.TMP_FILE_EXT), '', temp_file_url)
-
     def prepare_file_info(self, path, anatomy, sites):
         """ Prepare information for one file (asset or resource)
 
@@ -991,11 +1047,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         """
         file_hash = openpype.api.source_hash(path)
 
-        # todo: Avoid this logic
-        # Strip the temporary file extension from the file hash
-        if self.TMP_FILE_EXT and ',{}'.format(self.TMP_FILE_EXT) in file_hash:
-            file_hash = file_hash.replace(',{}'.format(self.TMP_FILE_EXT), '')
-
         return {
             "_id": io.ObjectId(),
             "path": self.get_rootless_path(anatomy, path),
@@ -1004,6 +1055,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "sites": sites
         }
 
+    # region sync sites
     def compute_resource_sync_sites(self, instance):
         """Get available resource sync sites"""
         # Sync server logic
@@ -1101,47 +1153,4 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                     already_attached_sites[meta["name"]] = real_created
 
         return alternative_sites
-
-    def handle_destination_files(self, destinations, mode):
-        """ Clean destination files
-            Called when error happened during integrating to DB or to disk
-            OR called to rename uploaded files from temporary name to final to
-            highlight publishing in progress/broken
-            Used to clean unwanted files
-
-        Arguments:
-            destinations (list): file paths
-            mode: 'remove' - clean files,
-                  'finalize' - rename files,
-                               remove TMP_FILE_EXT suffix denoting temp file
-        """
-        if not destinations:
-            return
-
-        for file_url in destinations:
-            if not os.path.exists(file_url):
-                self.log.debug(
-                    "File {} was not found.".format(file_url)
-                )
-                continue
-
-            try:
-                if mode == 'remove':
-                    self.log.debug("Removing file {}".format(file_url))
-                    os.remove(file_url)
-                if mode == 'finalize':
-
-                    new_name = self.get_dest_final_url(file_url)
-                    if os.path.exists(new_name):
-                        self.log.debug("Removing existing "
-                                       "file: {}".format(new_name))
-                        os.remove(new_name)
-
-                    self.log.debug(
-                        "Renaming file {} to {}".format(file_url, new_name)
-                    )
-                    os.rename(file_url, new_name)
-            except OSError:
-                self.log.error("Cannot {} file {}".format(mode, file_url),
-                               exc_info=True)
-                six.reraise(*sys.exc_info())
+    # endregion

From 9f6cc5df3a11031fb18155c97e0a73bb6f3f6108 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 17 Mar 2022 11:51:06 +0100
Subject: [PATCH 0012/1227] Fix hound

---
 openpype/plugins/publish/integrate_new.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 500456eaed..e74b528ae7 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -126,7 +126,8 @@ class FileTransaction(object):
                 self.log.debug("Copying file ... {} -> {}".format(src, dst))
                 copyfile(src, dst)
             elif opts["mode"] == self.MODE_HARDLINK:
-                self.log.debug("Hardlinking file ... {} -> {}".format(src, dst))
+                self.log.debug("Hardlinking file ... {} -> {}".format(src,
+                                                                      dst))
                 create_hard_link(src, dst)
 
             self._transferred.append(dst)
@@ -160,7 +161,7 @@ class FileTransaction(object):
             try:
                 os.rename(backup, original)
             except OSError:
-                errors +=1
+                errors += 1
                 self.log.error("Failed to restore original file: "
                                "{} -> {}".format(backup, original),
                                exc_info=True)

From 56bcd8cec35f201ead80a18c09f6c070b76209c1 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 17 Mar 2022 16:30:49 +0100
Subject: [PATCH 0013/1227] Continue refactor, restore functionality - now can
 correctly publish as before (rudimentary tested only)

---
 openpype/plugins/publish/integrate_new.py | 136 +++++++++++-----------
 1 file changed, 70 insertions(+), 66 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index e74b528ae7..c550c1011c 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -101,7 +101,10 @@ class FileTransaction(object):
                                "in queue: {} -> {}".format(src, dst))
                 return
             else:
-                self.log.warning("File transfer in queue overwritten")
+                self.log.warning("File transfer in queue replaced..")
+                self.log.debug("Removed from queue: "
+                               "{} -> {}".format(queued_src, dst))
+                self.log.debug("Added to queue: {} -> {}".format(src, dst))
 
         self._transfers[dst] = (src, opts)
 
@@ -298,7 +301,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             self.log.critical("Error when registering", exc_info=True)
             six.reraise(*sys.exc_info())
 
-        # Finalizing can't be rollbacked safely so no use for moving it to
+        # Finalizing can't rollback safely so no use for moving it to
         # the try, except.
         file_transactions.finalize()
 
@@ -426,11 +429,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "type": "archived_representation"
         }))
 
-        # Find the representations to transfer amongst the files
-        # Each should be a single representation (as such, a single extension)
+        # Prepare all representations
         template_name, anatomy_data = self.prepare_anatomy(instance)
-        published_representations = {}
-        representations = []
+        prepared_representations = []
         for repre in instance.data["representations"]:
 
             if "delete" in repre.get("tags", []):
@@ -438,6 +439,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                                "{}".format(repre))
                 continue
 
+            # todo: reduce/simplify what is returned from this function
             prepared = self.prepare_representation(repre,
                                                    anatomy_data,
                                                    template_name,
@@ -445,23 +447,23 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                                                    version,
                                                    instance_stagingdir,
                                                    instance)
-            representation = prepared["representation"]
 
-            # todo: register the file transfers correctly
-            for src, dst in representation["transfers"]:
-                file_transactions.add(src, dst,
-                                      mode=file_transactions.MODE_COPY)
-            for src, dst in representation["hardlinks"]:
-                file_transactions.add(src, dst,
-                                      mode=file_transactions.MODE_HARDLINK)
+            for src, dst in prepared["transfers"]:
+                # todo: add support for hardlink transfers
+                file_transactions.add(src, dst)
 
-            # todo: simplify this?
-            representations.append(representation)
-            published_representations[representation["_id"]] = prepared
+            prepared_representations.append(prepared)
 
-        # could throw exception, will be caught in 'process'
-        # all integration to DB is being done together lower,
-        # so no rollback needed
+        # Each instance can also have pre-defined transfers not explicitly
+        # part of a representation - like texture resources used by a
+        # .ma representation. Those destination paths are pre-defined, etc.
+        # todo: should we move or simplify this logic?
+        for src, dst in instance.data.get("transfers", []):
+            file_transactions.add(src, dst, mode=FileTransaction.MODE_COPY)
+        for src, dst in instance.data.get("hardlinks", []):
+            file_transactions.add(src, dst, mode=FileTransaction.MODE_HARDLINK)
+
+        # Process all file transfers of all integrations now
         self.log.debug("Integrating source files to destination ...")
         file_transactions.process()
         self.log.debug("Backup files "
@@ -469,17 +471,21 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         self.log.debug("Integrated files "
                        "{}".format(file_transactions.transferred))
 
-        # todo: fix get file info for transferred files per representation
-        #       currently it'd set all files for all representations
-        # get 'files' info for representation and all attached resources
-        integrated_files = file_transactions.transferred
-        self.log.debug("Preparing files information ...")
-        representation["files"] = self.get_files_info(
-            instance,
-            integrated_files
-        )
+        # Finalize the representations now the published files are integrated
+        # Get 'files' info for representations and its attached resources
+        self.log.debug("Retrieving Representation files information ...")
+        sites = self.compute_resource_sync_sites(instance)
+        anatomy = instance.context.data["anatomy"]
+        representations = []
+        for prepared in prepared_representations:
+            transfers = prepared["transfers"]
+            representation = prepared["representation"]
+            representation["files"] = self.get_files_info(
+                transfers, sites, anatomy
+            )
+            representations.append(representation)
 
-        # Remove old representations if there are any (before insertion of new)
+        # Remove all archived representations
         if archived_repres:
             repre_ids_to_remove = [repre["_id"] for repre in archived_repres]
             io.delete_many({"_id": {"$in": repre_ids_to_remove}})
@@ -487,7 +493,11 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         # Write the new representations to the database
         io.insert_many(representations)
 
-        instance.data["published_representations"] = published_representations
+        # Backwards compatibility
+        # todo: can we avoid the need to store this?
+        instance.data["published_representations"] = {
+            p["representation"]["_id"]: p for p in prepared_representations
+        }
 
         self.log.info("Registered {} representations"
                       "".format(len(representations)))
@@ -495,7 +505,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     def register_version(self, instance, subset):
 
         version_number = instance.data["version"]
-        self.log.debug("Next version: v{}".format(version_number))
+        self.log.debug("Version: v{0:03d}".format(version_number))
 
         version_data = self.create_version_data(instance)
         version_data_instance = instance.data.get('versionData')
@@ -565,6 +575,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 )
 
         version = io.find_one({"_id": version_id})
+
+        self.log.info("Registered version: v{0:03d}".format(version["name"]))
+
         return version
 
     def prepare_representation(self, repre,
@@ -585,7 +598,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         if repre.get("transfers"):
             raise ValueError("Representation is not allowed to have transfers"
-                             "data before integration. "
+                             "data before integration. They are computed in "
+                             "the integrator"
                              "Got: {}".format(repre["transfers"]))
 
         # required representation keys
@@ -698,18 +712,11 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             dst_collection.padding = destination_padding
             assert len(src_collection) == len(dst_collection), "This is a bug"
 
+            # Multiple file transfers
             transfers = []
             for src_file_name, dst in zip(src_collection, dst_collection):
                 src = os.path.join(stagingdir, src_file_name)
-                self.log.debug("source: {}".format(src))
-                self.log.debug("destination: `{}`".format(dst))
-                transfers.append(src, dst)
-
-            # Store first frame as published path
-            # todo: remove `published_path` since it can be retrieved from
-            #       `transfers` by taking the first destination transfers[0][1]
-            repre['published_path'] = next(iter(dst_collection))
-            repre["transfers"].extend(transfers)
+                transfers.append((src, dst))
 
         else:
             # Single file
@@ -728,11 +735,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             dst = os.path.normpath(template_filled)
 
             # Single file transfer
-            self.log.debug("source: {}".format(src))
-            self.log.debug("destination: `{}`".format(dst))
-            repre["transfers"] = [src, dst]
-
-            repre['published_path'] = dst
+            transfers = [(src, dst)]
 
         if repre.get("udim"):
             repre_context["udim"] = repre.get("udim")  # store list
@@ -753,11 +756,16 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 repre_id = _archived_repres["orig_id"]
                 break
 
+        # Backwards compatibility:
+        # Store first transferred destination as published path data
+        # todo: can we remove this?
+        published_path = transfers[0][1]
+
         # todo: `repre` is not the actual `representation` entity
         #       we should simplify/clarify difference between data above
         #       and the actual representation entity for the database
         data = repre.get("data") or {}
-        data.update({'path': repre["published_path"], 'template': template})
+        data.update({'path': published_path, 'template': template})
         representation = {
             "_id": repre_id,
             "schema": "openpype:representation-2.0",
@@ -782,9 +790,10 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         return {
             "representation": representation,
             "anatomy_data": template_data,
-            # todo: avoid the need for 'published_files'?
+            "transfers": transfers,
+            # todo: avoid the need for 'published_files' used by Integrate Hero
             # backwards compatibility
-            "published_files": [transfer[1] for transfer in repre["transfers"]]
+            "published_files": [transfer[1] for transfer in transfers]
         }
 
     def _get_instance_families(self, instance):
@@ -805,6 +814,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         # todo: rely less on self.prepare_anatomy to create this value
         asset = instance.data.get("assetEntity")  # stored by prepare_anatomy
         subset_name = instance.data["subset"]
+        self.log.debug("Subset: {}".format(subset_name))
+
         subset = io.find_one({
             "type": "subset",
             "parent": asset["_id"],
@@ -838,6 +849,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             {"$set": {"data.families": families}}
         )
 
+        self.log.info("Registered subset: {}".format(subset_name))
+
         return subset
 
     def _set_subset_group(self, instance, subset_id):
@@ -871,9 +884,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         if not self.subset_grouping_profiles:
             return None
 
+        # TODO: Resolve below questions
         # QUESTION
-        #   - is there a chance that task name is not filled in anatomy
-        #       data?
+        #   - is there a chance that task name is not filled in anatomy data?
         #   - should we use context task in that case?
         anatomy_data = instance.data["anatomyData"]
         task_name = None
@@ -1002,7 +1015,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             ).format(path))
         return path
 
-    def get_files_info(self, instance):
+    def get_files_info(self, transfers, sites, anatomy):
         """ Prepare 'files' portion for attached resources and main asset.
             Combining records from 'transfers' and 'hardlinks' parts from
             instance.
@@ -1017,21 +1030,12 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             output_resources: array of dictionaries to be added to 'files' key
             in representation
         """
-        # todo: refactor to use transfers/hardlinks of representations
-        #       currently broken logic
-        resources = list(instance.data.get("transfers", []))
-        resources.extend(list(instance.data.get("hardlinks", [])))
-        self.log.debug("get_files_info.resources:{}".format(resources))
-
-        sites = self.compute_resource_sync_sites(instance)
-
-        output_resources = []
-        anatomy = instance.context.data["anatomy"]
-        for _src, dest in resources:
+        file_infos = []
+        for _src, dest in transfers:
             file_info = self.prepare_file_info(dest, anatomy, sites=sites)
-            output_resources.append(file_info)
+            file_infos.append(file_info)
 
-        return output_resources
+        return file_infos
 
     def prepare_file_info(self, path, anatomy, sites):
         """ Prepare information for one file (asset or resource)

From 75838df107193f24fab2db52ce66ed04e976bfbd Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Tue, 22 Mar 2022 13:54:45 +0100
Subject: [PATCH 0014/1227] Handle timecode and audio state

---
 .../plugins/publish/extract_review_slate.py   | 122 ++++++++++++++++--
 1 file changed, 110 insertions(+), 12 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 505ae75169..a21751aecc 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -10,7 +10,6 @@ from openpype.lib import (
     get_ffmpeg_format_args,
 )
 
-
 class ExtractReviewSlate(openpype.api.Extractor):
     """
     Will add slate frame at the start of the video files
@@ -58,6 +57,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
         pixel_aspect = inst_data.get("pixelAspect", 1)
         fps = inst_data.get("fps")
+        self.log.debug("fps {} ".format(fps))
 
         for idx, repre in enumerate(inst_data["representations"]):
             self.log.debug("repre ({}): `{}`".format(idx + 1, repre))
@@ -82,12 +82,55 @@ class ExtractReviewSlate(openpype.api.Extractor):
             # - there may be a better way (checking `codec_type`?)
             input_width = None
             input_height = None
+            input_timecode = None
+            input_frame_rate = None
+            input_audio = False
+            audio_channels = None
+            audio_sample_rate = None
+            audio_channel_layout = None
             for stream in video_streams:
-                if "width" in stream and "height" in stream:
-                    input_width = int(stream["width"])
-                    input_height = int(stream["height"])
-                    break
-
+                self.log.debug("__ ffprobe: {}".format(stream))
+                if "codec_type" in stream:
+                    if stream["codec_type"] == "video":
+                        if stream["tags"]["timecode"]:
+                            # get timecode of the first frame
+                            input_timecode = stream["tags"]["timecode"]
+                            self.log.debug("__Video Timecode : {}".format(input_timecode))
+                        if "width" in stream and "height" in stream:
+                            input_width = int(stream["width"])
+                            input_height = int(stream["height"])
+                        if "r_frame_rate" in stream:
+                            # get frame rate in a form of x/y, like 24000/1001 for 23.976
+                            input_frame_rate = str(stream["r_frame_rate"])
+                    if stream["codec_type"] == "audio":
+                        # get audio details for generating silent audio track for slate
+                        if stream["channels"]:
+                            audio_channels = str(stream["channels"])
+                        if stream["sample_rate"]:
+                            audio_sample_rate = stream["sample_rate"]
+                        if stream["channel_layout"]:
+                            audio_channel_layout = stream["channel_layout"]
+            # calculate duration of one frame in seconds
+            if input_frame_rate:
+                # it is divided by two to make sure audio will be shorter then video
+                one_frame_duration = str( float(1.0 / eval(input_frame_rate)) / 2 )
+            else:
+                # same sane default (1 frame @ 25 fps)
+                one_frame_duration = 0.04
+            self.log.debug(
+                "One frame duration is {} sec".format(one_frame_duration))
+            # confirm we gathered all needed audio parameters
+            if audio_channel_layout:
+                if audio_sample_rate:
+                    if audio_channels:
+                        input_audio = True
+                        self.log.debug("__Audio : channels {}".format(
+                            audio_channels))
+                        self.log.debug("__Audio : sample_rate {}".format(
+                            audio_sample_rate))
+                        self.log.debug("__Audio : channel_layout {}".format(
+                            audio_channel_layout))
+            
             # Raise exception of any stream didn't define input resolution
             if input_width is None:
                 raise AssertionError((
@@ -144,18 +187,34 @@ class ExtractReviewSlate(openpype.api.Extractor):
             input_args = []
             output_args = []
 
+            # if input has audio, add silent audio to the slate
+            if input_audio:
+                input_args.extend(
+                    ["-f lavfi -i anullsrc=r={}:cl={}:d={}".format(
+                        audio_sample_rate,
+                        audio_channel_layout,
+                        one_frame_duration
+                    )]
+                )
             # preset's input data
             if use_legacy_code:
                 input_args.extend(repre["_profile"].get('input', []))
             else:
                 input_args.extend(repre["outputDef"].get('input', []))
-            input_args.append("-loop 1 -i {}".format(
+            # enforce framerate before -i
+            input_args.append("-framerate {} -i {}".format(
+                input_frame_rate,
                 path_to_subprocess_arg(slate_path)
             ))
-            input_args.extend([
-                "-r {}".format(fps),
-                "-t 0.04"
-            ])
+            # add timecode from source to the slate, substract one frame
+            if input_timecode:
+                offset_timecode = self._tc_offset(
+                    str(input_timecode),
+                    framerate=fps,
+                    frame_offset=-1
+                )
+                self.log.debug("Timecode: `{}`".format(offset_timecode))
+                input_args.extend(["-timecode {}".format(offset_timecode)])
 
             if use_legacy_code:
                 codec_args = repre["_profile"].get('codec', [])
@@ -213,11 +272,16 @@ class ExtractReviewSlate(openpype.api.Extractor):
                     width_scale, height_scale, to_width, to_height,
                     width_half_pad, height_half_pad
                 )
-
+            # add output frame rate as a filter, just in case
+            scaling_arg += ",fps={}".format(input_frame_rate)
             vf_back = self.add_video_filter_args(output_args, scaling_arg)
             # add it to output_args
             output_args.insert(0, vf_back)
 
+            # use video duration for silent audio duration
+            if input_audio:
+                output_args.append("-shortest")
+
             # overrides output file
             output_args.append("-y")
 
@@ -371,3 +435,37 @@ class ExtractReviewSlate(openpype.api.Extractor):
         )
 
         return codec_args
+
+    def _tc_offset(self, timecode='00:00:00:00', framerate=24.0, frame_offset=-1):
+        """Offsets timecode by frame"""
+        def _seconds(value, framerate):
+            if isinstance(value, str):
+                _zip_ft = zip((3600, 60, 1, 1/framerate), value.split(':'))
+                _s = sum(f * float(t) for f,t in _zip_ft)
+            elif isinstance(value, (int, float)):
+                _s = value / framerate
+            else:
+                _s = 0
+            return _s
+
+        def _frames(seconds, framerate, frame_offset):
+            _f = seconds * framerate + frame_offset
+            if _f < 0:
+                _f = framerate * 60 * 60 * 24 + _f
+            return _f
+
+        def _timecode(seconds, framerate):
+            return '{h:02d}:{m:02d}:{s:02d}:{f:02d}' \
+                    .format(h=int(seconds/3600),
+                            m=int(seconds/60%60),
+                            s=int(seconds%60),
+                            f=int(round((seconds-int(seconds))*framerate)))
+        drop = False
+        if ';' in timecode:
+            timecode = timecode.replace(';', ':')
+            drop = True
+        frames = _frames(_seconds(timecode, framerate), framerate, frame_offset)
+        tc = _timecode(_seconds(frames, framerate), framerate)
+        if drop:
+            tc = ';'.join(tc.rsplit(':', 1))
+        return tc
\ No newline at end of file

From 2dd38c74c04814c33356a05dfda32efeda470ffd Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Tue, 22 Mar 2022 14:13:00 +0100
Subject: [PATCH 0015/1227] fix hound

---
 .../plugins/publish/extract_review_slate.py   | 33 ++++++++++++-------
 1 file changed, 21 insertions(+), 12 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index a21751aecc..5cfb0997a5 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -95,15 +95,18 @@ class ExtractReviewSlate(openpype.api.Extractor):
                         if stream["tags"]["timecode"]:
                             # get timecode of the first frame
                             input_timecode = stream["tags"]["timecode"]
-                            self.log.debug("__Video Timecode : {}".format(input_timecode))
+                            self.log.debug("__Video Timecode : {}".format(
+                                input_timecode))
                         if "width" in stream and "height" in stream:
                             input_width = int(stream["width"])
                             input_height = int(stream["height"])
                         if "r_frame_rate" in stream:
-                            # get frame rate in a form of x/y, like 24000/1001 for 23.976
+                            # get frame rate in a form of
+                            # x/y, like 24000/1001 for 23.976
                             input_frame_rate = str(stream["r_frame_rate"])
                     if stream["codec_type"] == "audio":
-                        # get audio details for generating silent audio track for slate
+                        # get audio details 
+                        # for generating silent audio track for slate
                         if stream["channels"]:
                             audio_channels = str(stream["channels"])
                         if stream["sample_rate"]:
@@ -112,8 +115,10 @@ class ExtractReviewSlate(openpype.api.Extractor):
                             audio_channel_layout = stream["channel_layout"]
             # calculate duration of one frame in seconds
             if input_frame_rate:
-                # it is divided by two to make sure audio will be shorter then video
-                one_frame_duration = str( float(1.0 / eval(input_frame_rate)) / 2 )
+                # it is halved to make sure audio will be shorter then video
+                one_frame_duration = str(
+                    float(1.0 / eval(input_frame_rate)) / 2 
+                )
             else:
                 # same sane default (1 frame @ 25 fps)
                 one_frame_duration = 0.04
@@ -436,7 +441,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
         return codec_args
 
-    def _tc_offset(self, timecode='00:00:00:00', framerate=24.0, frame_offset=-1):
+    def _tc_offset(self, timecode, framerate=24.0, frame_offset=-1):
         """Offsets timecode by frame"""
         def _seconds(value, framerate):
             if isinstance(value, str):
@@ -456,16 +461,20 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
         def _timecode(seconds, framerate):
             return '{h:02d}:{m:02d}:{s:02d}:{f:02d}' \
-                    .format(h=int(seconds/3600),
-                            m=int(seconds/60%60),
-                            s=int(seconds%60),
-                            f=int(round((seconds-int(seconds))*framerate)))
+                    .format(h=int(seconds / 3600),
+                            m=int(seconds / 60 % 60),
+                            s=int(seconds % 60),
+                            f=int(round((seconds -int(seconds)) * framerate)))
         drop = False
         if ';' in timecode:
             timecode = timecode.replace(';', ':')
             drop = True
-        frames = _frames(_seconds(timecode, framerate), framerate, frame_offset)
+        frames = _frames(
+            _seconds(timecode, framerate),
+            framerate,
+            frame_offset
+        )
         tc = _timecode(_seconds(frames, framerate), framerate)
         if drop:
             tc = ';'.join(tc.rsplit(':', 1))
-        return tc
\ No newline at end of file
+        return tc

From c67a5504516b2eddea46d230a1d7d6f9c7ec71c5 Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Tue, 22 Mar 2022 14:17:56 +0100
Subject: [PATCH 0016/1227] Fix Hound2

---
 openpype/plugins/publish/extract_review_slate.py | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 5cfb0997a5..d6857c7915 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -105,7 +105,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
                             # x/y, like 24000/1001 for 23.976
                             input_frame_rate = str(stream["r_frame_rate"])
                     if stream["codec_type"] == "audio":
-                        # get audio details 
+                        # get audio details
                         # for generating silent audio track for slate
                         if stream["channels"]:
                             audio_channels = str(stream["channels"])
@@ -117,7 +117,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
             if input_frame_rate:
                 # it is halved to make sure audio will be shorter then video
                 one_frame_duration = str(
-                    float(1.0 / eval(input_frame_rate)) / 2 
+                    float(1.0 / eval(input_frame_rate)) / 2
                 )
             else:
                 # same sane default (1 frame @ 25 fps)
@@ -460,11 +460,11 @@ class ExtractReviewSlate(openpype.api.Extractor):
             return _f
 
         def _timecode(seconds, framerate):
-            return '{h:02d}:{m:02d}:{s:02d}:{f:02d}' \
-                    .format(h=int(seconds / 3600),
-                            m=int(seconds / 60 % 60),
-                            s=int(seconds % 60),
-                            f=int(round((seconds -int(seconds)) * framerate)))
+            return '{h:02d}:{m:02d}:{s:02d}:{f:02d}'.format(
+                h = int(seconds / 3600),
+                m = int(seconds / 60 % 60),
+                s = int(seconds % 60),
+                f = int(round((seconds - int(seconds)) * framerate)))
         drop = False
         if ';' in timecode:
             timecode = timecode.replace(';', ':')

From 406575ebd8c7056febce78b0575e85204458d10b Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Tue, 22 Mar 2022 14:22:27 +0100
Subject: [PATCH 0017/1227] Hound3

---
 .../projects_schema/schemas/schema_representation_tags.json    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
index 7607e1a8c1..484fbf9d07 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
@@ -24,6 +24,9 @@
         },
         {
             "sequence": "Output as image sequence"
+        },
+        {
+            "no-audio": "Do not add audio"
         }
     ]
 }

From 16817c30f67476578d30130b1aa721c66b7aa2dc Mon Sep 17 00:00:00 2001
From: Jiri Sindelar <45896205+jrsndl@users.noreply.github.com>
Date: Tue, 22 Mar 2022 14:25:07 +0100
Subject: [PATCH 0018/1227] remove no-audio tag settings

---
 .../schemas/schema_representation_tags.json   | 32 -------------------
 1 file changed, 32 deletions(-)
 delete mode 100644 openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
deleted file mode 100644
index 484fbf9d07..0000000000
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
+++ /dev/null
@@ -1,32 +0,0 @@
-{
-    "key": "tags",
-    "label": "Tags",
-    "type": "enum",
-    "multiselection": true,
-    "enum_items": [
-        {
-            "burnin": "Add burnins"
-        },
-        {
-            "review": "Create review"
-        },
-        {
-            "ftrackreview": "Add review to Ftrack"
-        },
-        {
-            "delete": "Delete output"
-        },
-        {
-            "slate-frame": "Add slate frame"
-        },
-        {
-            "no-handles": "Skip handle frames"
-        },
-        {
-            "sequence": "Output as image sequence"
-        },
-        {
-            "no-audio": "Do not add audio"
-        }
-    ]
-}

From f866bf2a757540c925a95864ccd2d9ac4d9b3a03 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakub@orbi.tools>
Date: Tue, 22 Mar 2022 16:36:41 +0100
Subject: [PATCH 0019/1227] adding back `schema_representation_tags`

---
 .../schemas/schema_representation_tags.json   | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
new file mode 100644
index 0000000000..7607e1a8c1
--- /dev/null
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
@@ -0,0 +1,29 @@
+{
+    "key": "tags",
+    "label": "Tags",
+    "type": "enum",
+    "multiselection": true,
+    "enum_items": [
+        {
+            "burnin": "Add burnins"
+        },
+        {
+            "review": "Create review"
+        },
+        {
+            "ftrackreview": "Add review to Ftrack"
+        },
+        {
+            "delete": "Delete output"
+        },
+        {
+            "slate-frame": "Add slate frame"
+        },
+        {
+            "no-handles": "Skip handle frames"
+        },
+        {
+            "sequence": "Output as image sequence"
+        }
+    ]
+}

From 8996280224aa30ad800e955ff165bdbe48bb8296 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 23 Mar 2022 23:38:05 +0100
Subject: [PATCH 0020/1227] Reduce duplicated logic by implementing
 `resolve_profile` method

---
 openpype/plugins/publish/integrate_new.py | 107 ++++++++++------------
 1 file changed, 48 insertions(+), 59 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 2142920a09..e43afbf7f6 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -359,17 +359,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "short": task_code
             }
 
-        elif "task" in anatomy_data:
-            # Just set 'task_name' variable to context task
-            task_name = anatomy_data["task"]["name"]
-            task_type = anatomy_data["task"]["type"]
-
-        else:
-            task_name = None
-            task_type = None
-
         # Fill family in anatomy data
-        anatomy_data["family"] = instance.data.get("family")
+        anatomy_data["family"] = self.main_family_from_instance(instance)
 
         intent_value = instance.context.data.get("intent")
         if intent_value and isinstance(intent_value, dict):
@@ -378,25 +369,44 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         if intent_value:
             anatomy_data["intent"] = intent_value
 
-        # Get profile
-        key_values = {
-            "families": self.main_family_from_instance(instance),
-            "tasks": task_name,
-            "hosts": instance.context.data["hostName"],
-            "task_types": task_type
-        }
-        profile = filter_profiles(
-            self.template_name_profiles,
-            key_values,
-            logger=self.log
-        )
-
+        profile, _ = self.resolve_profile(self.template_name_profiles,
+                                          instance)
         template_name = "publish"
         if profile:
             template_name = profile["template_name"]
 
         return template_name, anatomy_data
 
+    def resolve_profile(self, profiles, instance):
+        """Resolve profile by family, task name, host name and task type"""
+
+        # Anatomy data is pre-filled by Collectors and `self.prepare_anatomy`
+        anatomy_data = instance.data["anatomyData"]
+
+        # TODO: Resolve below questions
+        # QUESTION
+        #   - is there a chance that task name is not filled in anatomy data?
+        #   - should we use context task in that case?
+        # Task can be optional in anatomy data
+        task = anatomy_data.get("task", {})
+
+        filter_criteria = {
+            "families": anatomy_data["family"],
+            "tasks": task.get("name"),
+            "hosts": anatomy_data["host"],
+            "task_types": task.get("type")
+        }
+        # Get profile
+        profile = filter_profiles(
+            profiles,
+            filter_criteria,
+            logger=self.log
+        )
+
+        # TODO: See if we can simplify to avoid needing to return filter
+        #       criteria used in `self._get_subset_group`
+        return profile, filter_criteria
+
     def register(self, instance, file_transactions):
 
         instance_stagingdir = instance.data.get("stagingDir")
@@ -886,50 +896,29 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         if not self.subset_grouping_profiles:
             return None
 
-        # TODO: Resolve below questions
-        # QUESTION
-        #   - is there a chance that task name is not filled in anatomy data?
-        #   - should we use context task in that case?
-        anatomy_data = instance.data["anatomyData"]
-        task_name = None
-        task_type = None
-        if "task" in anatomy_data:
-            task_name = anatomy_data["task"]["name"]
-            task_type = anatomy_data["task"]["type"]
-        filtering_criteria = {
-            "families": instance.data["family"],
-            "hosts": instance.context.data["hostName"],
-            "tasks": task_name,
-            "task_types": task_type
-        }
-        matching_profile = filter_profiles(
-            self.subset_grouping_profiles,
-            filtering_criteria
-        )
-        # Skip if there is not matching profile
-        if not matching_profile:
+        # Skip if there is no matching profile
+        profile, criteria = self.resolve_profile(self.subset_grouping_profiles,
+                                                 instance)
+        if not profile:
             return None
 
-        filled_template = None
-        template = matching_profile["template"]
-        fill_pairs = (
-            ("family", filtering_criteria["families"]),
-            ("task", filtering_criteria["tasks"]),
-            ("host", filtering_criteria["hosts"]),
-            ("subset", instance.data["subset"]),
-            ("renderlayer", instance.data.get("renderlayer"))
-        )
-        fill_pairs = prepare_template_data(fill_pairs)
+        template = profile["template"]
 
+        fill_pairs = prepare_template_data({
+            "family": criteria["families"],
+            "task": criteria["tasks"],
+            "host": criteria["hosts"],
+            "subset": instance.data["subset"],
+            "renderlayer": instance.data.get("renderlayer")
+        })
+
+        filled_template = None
         try:
             filled_template = StringTemplate.format_strict_template(
                 template, fill_pairs
             )
         except (KeyError, TemplateUnsolved):
-            keys = []
-            if fill_pairs:
-                keys = fill_pairs.keys()
-
+            keys = fill_pairs.keys()
             msg = "Subset grouping failed. " \
                   "Only {} are expected in Settings".format(','.join(keys))
             self.log.warning(msg)

From 177e244bd80bf0b1d472948cba45f40dfecd672e Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 23 Mar 2022 23:45:24 +0100
Subject: [PATCH 0021/1227] Remove prepare anatomy data logic that is already
 collected/generated in CollectAnatomyContextData and
 CollectAnatomyInstanceData.

This currently was duplicated logic and should not be handled in the Integrator
---
 openpype/plugins/publish/integrate_new.py | 51 +----------------------
 1 file changed, 1 insertion(+), 50 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index e43afbf7f6..a1a116bd43 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -310,58 +310,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     def prepare_anatomy(self, instance):
         """Prepare anatomy data used to define representation destinations"""
 
-        context = instance.context
-
         anatomy_data = instance.data["anatomyData"]
-        project_entity = instance.data["projectEntity"]
-
-        context_asset_name = None
-        context_asset_doc = context.data.get("assetEntity")
-        if context_asset_doc:
-            context_asset_name = context_asset_doc["name"]
-
-        asset_name = instance.data["asset"]
-        asset_entity = instance.data.get("assetEntity")
-        if not asset_entity or asset_entity["name"] != context_asset_name:
-            asset_entity = io.find_one({
-                "type": "asset",
-                "name": asset_name,
-                "parent": project_entity["_id"]
-            })
-            assert asset_entity, (
-                "No asset found by the name \"{0}\" in project \"{1}\""
-            ).format(asset_name, project_entity["name"])
-
-            instance.data["assetEntity"] = asset_entity
-
-            # update anatomy data with asset specific keys
-            # - name should already been set
-            hierarchy = ""
-            parents = asset_entity["data"]["parents"]
-            if parents:
-                hierarchy = "/".join(parents)
-            anatomy_data["hierarchy"] = hierarchy
-
-        # Make sure task name in anatomy data is same as on instance.data
-        asset_tasks = (
-            asset_entity.get("data", {}).get("tasks")
-        ) or {}
-        task_name = instance.data.get("task")
-        if task_name:
-            task_info = asset_tasks.get(task_name) or {}
-            task_type = task_info.get("type")
-
-            project_task_types = project_entity["config"]["tasks"]
-            task_code = project_task_types.get(task_type, {}).get("short_name")
-            anatomy_data["task"] = {
-                "name": task_name,
-                "type": task_type,
-                "short": task_code
-            }
-
-        # Fill family in anatomy data
-        anatomy_data["family"] = self.main_family_from_instance(instance)
 
+        # TODO: This logic should move to CollectAnatomyContextData
         intent_value = instance.context.data.get("intent")
         if intent_value and isinstance(intent_value, dict):
             intent_value = intent_value.get("value")

From 3fd2d020149e5b33c0be0ab7000376a0f30ed96f Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 23 Mar 2022 23:55:40 +0100
Subject: [PATCH 0022/1227] Move logic to clarify what should be removed/moved
 and bring logic closer to where it's used

---
 openpype/plugins/publish/integrate_new.py | 36 ++++++++++-------------
 1 file changed, 16 insertions(+), 20 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index a1a116bd43..e57fbaf294 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -293,6 +293,10 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         if families & set(self.exclude_families):
             return
 
+        # TODO: Avoid the need to do any adjustments to anatomy data
+        #       Best case scenario that's all handled by collectors
+        self.prepare_anatomy(instance)
+
         file_transactions = FileTransaction(log=self.log)
         try:
             self.register(instance, file_transactions)
@@ -309,24 +313,12 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
     def prepare_anatomy(self, instance):
         """Prepare anatomy data used to define representation destinations"""
-
-        anatomy_data = instance.data["anatomyData"]
-
         # TODO: This logic should move to CollectAnatomyContextData
         intent_value = instance.context.data.get("intent")
         if intent_value and isinstance(intent_value, dict):
             intent_value = intent_value.get("value")
-
-        if intent_value:
-            anatomy_data["intent"] = intent_value
-
-        profile, _ = self.resolve_profile(self.template_name_profiles,
-                                          instance)
-        template_name = "publish"
-        if profile:
-            template_name = profile["template_name"]
-
-        return template_name, anatomy_data
+            if intent_value:
+                instance.data["anatomyData"]["intent"] = intent_value
 
     def resolve_profile(self, profiles, instance):
         """Resolve profile by family, task name, host name and task type"""
@@ -382,6 +374,13 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             )
         )
 
+        # Define publish template name from profiles
+        profile, _ = self.resolve_profile(self.template_name_profiles,
+                                          instance)
+        template_name = "publish"
+        if profile:
+            template_name = profile["template_name"]
+
         subset = self.register_subset(instance)
 
         version = self.register_version(instance, subset)
@@ -393,7 +392,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         }))
 
         # Prepare all representations
-        template_name, anatomy_data = self.prepare_anatomy(instance)
         prepared_representations = []
         for repre in instance.data["representations"]:
 
@@ -404,7 +402,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
             # todo: reduce/simplify what is returned from this function
             prepared = self.prepare_representation(repre,
-                                                   anatomy_data,
                                                    template_name,
                                                    archived_repres,
                                                    version,
@@ -544,16 +541,12 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         return version
 
     def prepare_representation(self, repre,
-                               anatomy_data,
                                template_name,
                                archived_repres,
                                version,
                                instance_stagingdir,
                                instance):
 
-        # create template data for Anatomy
-        template_data = copy.deepcopy(anatomy_data)
-
         # pre-flight validations
         if repre["ext"].startswith("."):
             raise ValueError("Extension must not start with a dot '.': "
@@ -565,6 +558,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                              "the integrator"
                              "Got: {}".format(repre["transfers"]))
 
+        # create template data for Anatomy
+        template_data = copy.deepcopy(instance.data["anatomyData"])
+
         # required representation keys
         files = repre['files']
         template_data["representation"] = repre["name"]

From 8edfb3f7d3f926539f7f060725b3b7e0b1d697e5 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 00:10:59 +0100
Subject: [PATCH 0023/1227] Simplify profile filtering

---
 openpype/plugins/publish/integrate_new.py | 42 +++++++++--------------
 1 file changed, 16 insertions(+), 26 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index e57fbaf294..bdc045d1db 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -320,35 +320,21 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             if intent_value:
                 instance.data["anatomyData"]["intent"] = intent_value
 
-    def resolve_profile(self, profiles, instance):
-        """Resolve profile by family, task name, host name and task type"""
-
-        # Anatomy data is pre-filled by Collectors and `self.prepare_anatomy`
+    def get_profile_filter_criteria(self, instance):
+        """Return filter criteria for `filter_profiles`"""
+        # Anatomy data is pre-filled by Collectors
         anatomy_data = instance.data["anatomyData"]
 
-        # TODO: Resolve below questions
-        # QUESTION
-        #   - is there a chance that task name is not filled in anatomy data?
-        #   - should we use context task in that case?
         # Task can be optional in anatomy data
         task = anatomy_data.get("task", {})
 
-        filter_criteria = {
+        # Return filter criteria
+        return {
             "families": anatomy_data["family"],
             "tasks": task.get("name"),
             "hosts": anatomy_data["host"],
             "task_types": task.get("type")
         }
-        # Get profile
-        profile = filter_profiles(
-            profiles,
-            filter_criteria,
-            logger=self.log
-        )
-
-        # TODO: See if we can simplify to avoid needing to return filter
-        #       criteria used in `self._get_subset_group`
-        return profile, filter_criteria
 
     def register(self, instance, file_transactions):
 
@@ -375,8 +361,10 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         )
 
         # Define publish template name from profiles
-        profile, _ = self.resolve_profile(self.template_name_profiles,
-                                          instance)
+        filter_criteria = self.get_profile_filter_criteria(instance)
+        profile = filter_profiles(self.template_name_profiles,
+                                  filter_criteria,
+                                  logger=self.log)
         template_name = "publish"
         if profile:
             template_name = profile["template_name"]
@@ -844,17 +832,19 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             return None
 
         # Skip if there is no matching profile
-        profile, criteria = self.resolve_profile(self.subset_grouping_profiles,
-                                                 instance)
+        filter_criteria = self.get_profile_filter_criteria(instance)
+        profile = filter_profiles(self.subset_grouping_profiles,
+                                  filter_criteria,
+                                  logger=self.log)
         if not profile:
             return None
 
         template = profile["template"]
 
         fill_pairs = prepare_template_data({
-            "family": criteria["families"],
-            "task": criteria["tasks"],
-            "host": criteria["hosts"],
+            "family": filter_criteria["families"],
+            "task": filter_criteria["tasks"],
+            "host": filter_criteria["hosts"],
             "subset": instance.data["subset"],
             "renderlayer": instance.data.get("renderlayer")
         })

From 79286ead4b91504afa30df711e8f751451f53552 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 00:16:32 +0100
Subject: [PATCH 0024/1227] Re-use get families logic

---
 openpype/plugins/publish/integrate_new.py | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index bdc045d1db..e66a71c483 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -286,10 +286,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     def process(self, instance):
 
         # Exclude instances that also contain families from exclude families
-        families = set(
-            # Consider family and families data
-            [instance.data["family"]] + instance.data.get("families", [])
-        )
+        families = set(self._get_instance_families(instance))
         if families & set(self.exclude_families):
             return
 

From d6c682723de6eb025b21768ced54b2756373fba6 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 00:19:16 +0100
Subject: [PATCH 0025/1227] Remove todo since assetEntity already comes from
 Collectors + re-use families variable

---
 openpype/plugins/publish/integrate_new.py | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index e66a71c483..856f8af163 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -755,8 +755,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         return families
 
     def register_subset(self, instance):
-        # todo: rely less on self.prepare_anatomy to create this value
-        asset = instance.data.get("assetEntity")  # stored by prepare_anatomy
+        asset = instance.data.get("assetEntity")
         subset_name = instance.data["subset"]
         self.log.debug("Subset: {}".format(subset_name))
 
@@ -766,9 +765,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "name": subset_name
         })
 
+        families = self._get_instance_families(instance)
         if subset is None:
             self.log.info("Subset '%s' not found, creating ..." % subset_name)
-            families = self._get_instance_families(instance)
 
             _id = io.insert_one({
                 "schema": "openpype:subset-3.0",
@@ -786,8 +785,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         self._set_subset_group(instance, subset["_id"])
 
         # Update families on subset.
-        families = [instance.data["family"]]
-        families.extend(instance.data.get("families", []))
         io.update_many(
             {"type": "subset", "_id": ObjectId(subset["_id"])},
             {"$set": {"data.families": families}}

From 47259f8ef7b177892c76a8dbfde6d147cf664d39 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 00:21:44 +0100
Subject: [PATCH 0026/1227] Add todo to move get subset group logic

---
 openpype/plugins/publish/integrate_new.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 856f8af163..91d2f3a943 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -821,6 +821,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         Attribute 'subset_grouping_profiles' is defined by OpenPype settings.
         """
+        # TODO: This logic is better suited for a Collector to just store
+        #       instance.data["subsetGroup"]
         # Skip if 'subset_grouping_profiles' is empty
         if not self.subset_grouping_profiles:
             return None

From b128e0addffc77991e5ff25f2d219d8ed8613136 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 14:21:32 +0100
Subject: [PATCH 0027/1227] Override stored repre context `udim` for backwards
 compatibility

---
 openpype/plugins/publish/integrate_new.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 91d2f3a943..e3abb8f04f 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -275,7 +275,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     exclude_families = ["clip"]
     db_representation_context_keys = [
         "project", "asset", "task", "subset", "version", "representation",
-        "family", "hierarchy", "task", "username", "frame", "udim"
+        "family", "hierarchy", "task", "username", "frame"
     ]
     default_template_name = "publish"
 
@@ -681,15 +681,17 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             # Single file transfer
             transfers = [(src, dst)]
 
-        if repre.get("udim"):
-            repre_context["udim"] = repre.get("udim")  # store list
-
         for key in self.db_representation_context_keys:
             value = template_data.get(key)
             if not value:
                 continue
             repre_context[key] = template_data[key]
 
+        # Explicitly store the full list even though template data might
+        # have a different value
+        if repre.get("udim"):
+            repre_context["udim"] = repre.get("udim")  # store list
+
         # Define representation id
         repre_id = ObjectId()
 

From 9997acbbeae32f1473c39df6cf78a8bfa7257aff Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 14:22:49 +0100
Subject: [PATCH 0028/1227] Encapsulate version data completely into its own
 function

---
 openpype/plugins/publish/integrate_new.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index e3abb8f04f..6e92f81b8b 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -452,17 +452,12 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         version_number = instance.data["version"]
         self.log.debug("Version: v{0:03d}".format(version_number))
 
-        version_data = self.create_version_data(instance)
-        version_data_instance = instance.data.get('versionData')
-        if version_data_instance:
-            version_data.update(version_data_instance)
-
         version = {
             "schema": "openpype:version-3.0",
             "type": "version",
             "parent": subset["_id"],
             "name": version_number,
-            "data": version_data
+            "data": self.create_version_data(instance)
         }
 
         repres = instance.data.get("representations", [])
@@ -909,6 +904,11 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             if key in instance.data:
                 version_data[key] = instance.data[key]
 
+        # Include instance.data[versionData] directly
+        version_data_instance = instance.data.get('versionData')
+        if version_data_instance:
+            version_data.update(version_data_instance)
+
         return version_data
 
     def main_family_from_instance(self, instance):

From 5b1f6eb30c459011fa685dcf325f39c4af72838e Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 14:23:27 +0100
Subject: [PATCH 0029/1227] Move logic closer to where it's used

---
 openpype/plugins/publish/integrate_new.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 6e92f81b8b..a787f8d50d 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -460,9 +460,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "data": self.create_version_data(instance)
         }
 
-        repres = instance.data.get("representations", [])
-        new_repre_names_low = [_repre["name"].lower() for _repre in repres]
-
         existing_version = io.find_one({
             'type': 'version',
             'parent': subset["_id"],
@@ -488,6 +485,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             }))
 
             # Find representations of existing version and archive them
+            repres = instance.data.get("representations", [])
+            new_repre_names_low = [_repre["name"].lower() for _repre in repres]
             current_repres = io.find({
                 "type": "representation",
                 "parent": version_id

From 3369c15bdf837d6d8e83a8c054794e95fccd061b Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 14:25:15 +0100
Subject: [PATCH 0030/1227] Preparation to delay Version document write to
 database closer to representation write

---
 openpype/plugins/publish/integrate_new.py | 24 ++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index a787f8d50d..8dd2d57959 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -466,15 +466,16 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             'name': version_number
         })
 
+        bulk_writes = []
         if existing_version is None:
             self.log.debug("Creating new version ...")
-            version_id = io.insert_one(version).inserted_id
+            version["_id"] = ObjectId()
+            bulk_writes.append(InsertOne(version))
         else:
             self.log.debug("Updating existing version ...")
             # Check if instance have set `append` mode which cause that
             # only replicated representations are set to archive
             append_repres = instance.data.get("append", False)
-            bulk_writes = []
 
             # Update version data
             version_id = existing_version['_id']
@@ -484,6 +485,12 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 '$set': version
             }))
 
+            # Instead of directly writing and querying we reproduce what
+            # the resulting version would look like so we can hold off making
+            # changes to the database to avoid the need for 'rollback'
+            version = copy.deepcopy(version)
+            version["_id"] = existing_version["_id"]
+
             # Find representations of existing version and archive them
             repres = instance.data.get("representations", [])
             new_repre_names_low = [_repre["name"].lower() for _repre in repres]
@@ -507,13 +514,12 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 repre["type"] = "archived_representation"
                 bulk_writes.append(InsertOne(repre))
 
-            # bulk updates
-            if bulk_writes:
-                io._database[io.Session["AVALON_PROJECT"]].bulk_write(
-                    bulk_writes
-                )
-
-        version = io.find_one({"_id": version_id})
+        # bulk updates
+        # todo: Try to avoid writing already until after we've prepared
+        #       representations to allow easier rollback?
+        io._database[io.Session["AVALON_PROJECT"]].bulk_write(
+            bulk_writes
+        )
 
         self.log.info("Registered version: v{0:03d}".format(version["name"]))
 

From 42175ff6f829ce30ef61538243d7bd4b804c8e28 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 14:41:56 +0100
Subject: [PATCH 0031/1227] Fix `get_profile_filter_criteria` anatomy data key
 for app name

---
 openpype/plugins/publish/integrate_new.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 8dd2d57959..e3dcfcc93c 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -329,7 +329,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         return {
             "families": anatomy_data["family"],
             "tasks": task.get("name"),
-            "hosts": anatomy_data["host"],
+            "hosts": anatomy_data["app"],
             "task_types": task.get("type")
         }
 

From 7713af5a1dac4b0080dc6006f08811dcd9fc9d04 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 17:23:02 +0100
Subject: [PATCH 0032/1227] Fix sequence functionality

---
 openpype/plugins/publish/integrate_new.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index e3dcfcc93c..b5986a62ee 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -645,16 +645,20 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             repre_context = template_filled.used_values
             self.log.debug("Template filled: {}".format(str(template_filled)))
             dst_collections, _remainder = clique.assemble(
-                [os.path.normpath(template_filled)], minimum_items=1
+                [os.path.normpath(template_filled)],
+                minimum_items=1,
+                patterns=[clique.PATTERNS["frames"]]
             )
             assert not _remainder, "This is a bug"
             assert len(dst_collections) == 1, "This is a bug"
             dst_collection = dst_collections[0]
 
             # Update the destination indexes and padding
-            dst_collection.indexes = destination_indexes
+            dst_collection.indexes.clear()
+            dst_collection.indexes.update(set(destination_indexes))
             dst_collection.padding = destination_padding
-            assert len(src_collection) == len(dst_collection), "This is a bug"
+            assert len(src_collection.indexes) == \
+                   len(dst_collection.indexes), "This is a bug"
 
             # Multiple file transfers
             transfers = []

From 229626bffdbc7e59c2206798b5bb3066a5602228 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 17:36:01 +0100
Subject: [PATCH 0033/1227] Reformat code

---
 openpype/plugins/publish/integrate_new.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index b5986a62ee..9e3e9de77c 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -657,8 +657,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             dst_collection.indexes.clear()
             dst_collection.indexes.update(set(destination_indexes))
             dst_collection.padding = destination_padding
-            assert len(src_collection.indexes) == \
-                   len(dst_collection.indexes), "This is a bug"
+            assert (
+                len(src_collection.indexes) == len(dst_collection.indexes)
+            ), "This is a bug"
 
             # Multiple file transfers
             transfers = []

From e1eb0887e0bdaaf012e95f289bdaddcf9089d65c Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 24 Mar 2022 20:26:10 +0100
Subject: [PATCH 0034/1227] Reduce database calls for register subset + prepare
 for bulk writes logic

---
 openpype/plugins/publish/integrate_new.py | 72 ++++++++++-------------
 1 file changed, 31 insertions(+), 41 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 9e3e9de77c..44768df368 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -766,63 +766,53 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         subset_name = instance.data["subset"]
         self.log.debug("Subset: {}".format(subset_name))
 
+        # Get existing subset if it exists
         subset = io.find_one({
             "type": "subset",
             "parent": asset["_id"],
             "name": subset_name
         })
 
-        families = self._get_instance_families(instance)
-        if subset is None:
-            self.log.info("Subset '%s' not found, creating ..." % subset_name)
+        # Define subset data
+        data = {
+            "families": self._get_instance_families(instance)
+        }
 
-            _id = io.insert_one({
+        subset_group = instance.data.get("subsetGroup")
+        if not subset_group:
+            # todo: move _get_subset_group fallback to its own collector
+            subset_group = self._get_subset_group(instance)
+        if subset_group:
+            data["subsetGroup"] = subset_group
+
+        if subset is None:
+            # Create a new subset
+            self.log.info("Subset '%s' not found, creating ..." % subset_name)
+            subset = {
+                "_id": ObjectId(),
                 "schema": "openpype:subset-3.0",
                 "type": "subset",
                 "name": subset_name,
-                "data": {
-                    "families": families
-                },
+                "data": data,
                 "parent": asset["_id"]
-            }).inserted_id
+            }
+            io.insert_one(subset)
 
-            subset = io.find_one({"_id": _id})
-
-        # Update subset group
-        self._set_subset_group(instance, subset["_id"])
-
-        # Update families on subset.
-        io.update_many(
-            {"type": "subset", "_id": ObjectId(subset["_id"])},
-            {"$set": {"data.families": families}}
-        )
+        else:
+            # Update existing subset data with new data and set in database.
+            # We also change the found subset  in-place so we don't need to
+            # re-query the subset afterwards
+            subset["data"].update(data)
+            io.update_many(
+                {"type": "subset", "_id": subset["_id"]},
+                {"$set": {
+                    "data": subset["data"]
+                }}
+            )
 
         self.log.info("Registered subset: {}".format(subset_name))
-
         return subset
 
-    def _set_subset_group(self, instance, subset_id):
-        """
-            Mark subset as belonging to group in DB.
-
-            Uses Settings > Global > Publish plugins > IntegrateAssetNew
-
-            Args:
-                instance (dict): processed instance
-                subset_id (str): DB's subset _id
-
-        """
-        # Fist look into instance data
-        subset_group = instance.data.get("subsetGroup")
-        if not subset_group:
-            subset_group = self._get_subset_group(instance)
-
-        if subset_group:
-            io.update_many({
-                'type': 'subset',
-                '_id': ObjectId(subset_id)
-            }, {'$set': {'data.subsetGroup': subset_group}})
-
     def _get_subset_group(self, instance):
         """Look into subset group profiles set by settings.
 

From b906365f593025bf7bbba67ea6d8a907b717c98e Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 25 Mar 2022 21:42:39 +0100
Subject: [PATCH 0035/1227] Separate site sync logic further from Integrator
 plug-in (Draft)

---
 openpype/plugins/publish/integrate_new.py | 154 ++++++++++++----------
 1 file changed, 88 insertions(+), 66 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 44768df368..138a4fcc06 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -419,7 +419,12 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         # Finalize the representations now the published files are integrated
         # Get 'files' info for representations and its attached resources
         self.log.debug("Retrieving Representation files information ...")
-        sites = self.compute_resource_sync_sites(instance)
+        sites = SiteSync.compute_resource_sync_sites(
+            system_settings=instance.context.data["system_settings"],
+            project_settings=instance.context.data["project_settings"]
+        )
+        log.debug("final sites:: {}".format(sites))
+
         anatomy = instance.context.data["anatomy"]
         representations = []
         for prepared in prepared_representations:
@@ -987,63 +992,65 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "sites": sites
         }
 
-    # region sync sites
-    def compute_resource_sync_sites(self, instance):
+
+class SiteSync(object):
+    """Logic for Site Sync Module functionality"""
+
+    @classmethod
+    def compute_resource_sync_sites(cls,
+                                    system_settings,
+                                    project_settings):
         """Get available resource sync sites"""
-        # Sync server logic
-        # TODO: Clean up sync settings
-        local_site = 'studio'  # default
-        remote_site = None
-        always_accessible = []
-        sync_project_presets = None
 
-        system_sync_server_presets = (
-            instance.context.data["system_settings"]
-                                 ["modules"]
-                                 ["sync_server"])
+        def create_metadata(name, created=True):
+            """Create sync site metadata for site with `name`"""
+            metadata = {"name": name}
+            if created:
+                metadata["created_dt"] = datetime.now()
+            return metadata
+
+        default_sites = [create_metadata("studio")]
+
+        # If sync site module is disabled return default fallback site
+        system_sync_server_presets = system_settings["modules"]["sync_server"]
         log.debug("system_sett:: {}".format(system_sync_server_presets))
+        if not system_sync_server_presets["enabled"]:
+            return default_sites
 
-        if system_sync_server_presets["enabled"]:
-            sync_project_presets = (
-                instance.context.data["project_settings"]
-                                     ["global"]
-                                     ["sync_server"])
+        # If sync site module is disabled in current
+        # project return default fallback site
+        sync_project_presets = project_settings["global"]["sync_server"]
+        if not sync_project_presets["enabled"]:
+            return default_sites
 
-        if sync_project_presets and sync_project_presets["enabled"]:
-            local_site, remote_site = self._get_sites(sync_project_presets)
-            always_accessible = sync_project_presets["config"]. \
-                get("always_accessible_on", [])
+        local_site, remote_site = cls._get_sites(sync_project_presets)
 
-        already_attached_sites = {}
-        meta = {"name": local_site, "created_dt": datetime.now()}
-        sites = [meta]
-        already_attached_sites[meta["name"]] = meta["created_dt"]
+        # Attached sites metadata by site name
+        # That is the local site, remote site, the always accesible sites
+        # and their alternate sites (alias of sites with different protocol)
+        attached_sites = dict()
+        attached_sites[local_site] = create_metadata(local_site)
 
-        if sync_project_presets and sync_project_presets["enabled"]:
-            if remote_site and \
-                    remote_site not in already_attached_sites.keys():
-                # add remote
-                meta = {"name": remote_site.strip()}
-                sites.append(meta)
-                already_attached_sites[meta["name"]] = None
+        if remote_site and remote_site != local_site:
+            attached_sites[remote_site] = create_metadata(remote_site,
+                                                          created=False)
 
-            # add skeleton for site where it should be always synced to
-            for always_on_site in always_accessible:
-                if always_on_site not in already_attached_sites.keys():
-                    meta = {"name": always_on_site.strip()}
-                    sites.append(meta)
-                    already_attached_sites[meta["name"]] = None
+        # add skeleton for sites where it should be always synced to
+        always_accessible_sites = (
+            sync_project_presets["config"].get("always_accessible_on", [])
+        )
+        for site in always_accessible_sites:
+            site = site.strip()
+            if site not in attached_sites:
+                attached_sites[site] = create_metadata(site, created=False)
 
-            # add alternative sites
-            alt = self._add_alternative_sites(system_sync_server_presets,
-                                              already_attached_sites)
-            sites.extend(alt)
+        # add alternative sites
+        cls._add_alternative_sites(system_sync_server_presets, attached_sites)
 
-        log.debug("final sites:: {}".format(sites))
+        return list(attached_sites.values())
 
-        return sites
-
-    def _get_sites(self, sync_project_presets):
+    @staticmethod
+    def _get_sites(sync_project_presets):
         """Returns tuple (local_site, remote_site)"""
         local_site_id = openpype.api.get_local_site_id()
         local_site = sync_project_presets["config"]. \
@@ -1053,36 +1060,51 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             local_site = local_site_id
 
         remote_site = sync_project_presets["config"].get("remote_site")
+        if remote_site:
+            remote_site.strip()
 
         if remote_site == 'local':
             remote_site = local_site_id
 
         return local_site, remote_site
 
-    def _add_alternative_sites(self,
-                               system_sync_server_presets,
-                               already_attached_sites):
+    @staticmethod
+    def _add_alternative_sites(system_sync_server_presets,
+                               attached_sites):
         """Loop through all configured sites and add alternatives.
 
+        For all sites if an alternative site is detected that has an
+        accessible site then we can also register to that alternative site
+        with the same "created" state. So we match the existing data.
+
             See SyncServerModule.handle_alternate_site
         """
         conf_sites = system_sync_server_presets.get("sites", {})
 
-        alternative_sites = []
         for site_name, site_info in conf_sites.items():
-            alt_sites = set(site_info.get("alternative_sites", []))
-            already_attached_keys = list(already_attached_sites.keys())
-            for added_site in already_attached_keys:
-                if added_site in alt_sites:
-                    if site_name in already_attached_keys:
-                        continue
-                    meta = {"name": site_name}
-                    real_created = already_attached_sites[added_site]
-                    # alt site inherits state of 'created_dt'
-                    if real_created:
-                        meta["created_dt"] = real_created
-                    alternative_sites.append(meta)
-                    already_attached_sites[meta["name"]] = real_created
 
-        return alternative_sites
-    # endregion
+            # Skip if already defined
+            if site_name in attached_sites:
+                continue
+
+            # Get alternate sites (stripped names) for this site name
+            alt_sites = site_info.get("alternative_sites", [])
+            alt_sites = [site.strip() for site in alt_sites]
+            alt_sites = set(alt_sites)
+
+            # If no alternative sites we don't need to add
+            if not alt_sites:
+                continue
+
+            # Take a copy of data of the first alternate site that is already
+            # defined as an attached site to match the same state.
+            match_meta = next((attached_sites[site] for site in alt_sites
+                               if site in attached_sites), None)
+            if not match_meta:
+                continue
+
+            alt_site_meta = copy.deepcopy(match_meta)
+            alt_site_meta["name"] = site_name
+
+            # Note: We change mutable `attached_site` dict in-place
+            attached_sites[site_name] = alt_site_meta

From e0aaa5f6cc2fd2a2e6fa708364136d9d6235163d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 14:20:13 +0100
Subject: [PATCH 0036/1227] Move FileTransaction into lib

---
 openpype/lib/file_transaction.py          | 171 ++++++++++++++++++++++
 openpype/plugins/publish/integrate_new.py | 167 +--------------------
 2 files changed, 172 insertions(+), 166 deletions(-)
 create mode 100644 openpype/lib/file_transaction.py

diff --git a/openpype/lib/file_transaction.py b/openpype/lib/file_transaction.py
new file mode 100644
index 0000000000..57592e297f
--- /dev/null
+++ b/openpype/lib/file_transaction.py
@@ -0,0 +1,171 @@
+import os
+import logging
+import sys
+import errno
+import six
+
+from openpype.lib import create_hard_link
+
+# this is needed until speedcopy for linux is fixed
+if sys.platform == "win32":
+    from speedcopy import copyfile
+else:
+    from shutil import copyfile
+
+
+class FileTransaction(object):
+    """
+
+    The file transaction is a three step process.
+
+    1) Rename any existing files to a "temporary backup" during `process()`
+    2) Copy the files to final destination during `process()`
+    3) Remove any backed up files (*no rollback possible!) during `finalize()`
+
+    Step 3 is done during `finalize()`. If not called the .bak files will
+    remain on disk.
+
+    These steps try to ensure that we don't overwrite half of any existing
+    files e.g. if they are currently in use.
+
+    Note:
+        A regular filesystem is *not* a transactional file system and even
+        though this implementation tries to produce a 'safe copy' with a
+        potential rollback do keep in mind that it's inherently unsafe due
+        to how filesystem works and a myriad of things could happen during
+        the transaction that break the logic. A file storage could go down,
+        permissions could be changed, other machines could be moving or writing
+        files. A lot can happen.
+
+    Warning:
+        Any folders created during the transfer will not be removed.
+
+    """
+
+    MODE_COPY = 0
+    MODE_HARDLINK = 1
+
+    def __init__(self, log=None):
+
+        if log is None:
+            log = logging.getLogger("FileTransaction")
+
+        self.log = log
+
+        # The transfer queue
+        # todo: make this an actual FIFO queue?
+        self._transfers = {}
+
+        # Destination file paths that a file was transferred to
+        self._transferred = []
+
+        # Backup file location mapping to original locations
+        self._backup_to_original = {}
+
+    def add(self, src, dst, mode=MODE_COPY):
+        """Add a new file to transfer queue"""
+        opts = {"mode": mode}
+
+        src = os.path.normpath(src)
+        dst = os.path.normpath(dst)
+
+        if dst in self._transfers:
+            queued_src = self._transfers[dst][0]
+            if src == queued_src:
+                self.log.debug("File transfer was already "
+                               "in queue: {} -> {}".format(src, dst))
+                return
+            else:
+                self.log.warning("File transfer in queue replaced..")
+                self.log.debug("Removed from queue: "
+                               "{} -> {}".format(queued_src, dst))
+                self.log.debug("Added to queue: {} -> {}".format(src, dst))
+
+        self._transfers[dst] = (src, opts)
+
+    def process(self):
+
+        # Backup any existing files
+        for dst in self._transfers.keys():
+            if os.path.exists(dst):
+                # Backup original file
+                # todo: add timestamp or uuid to ensure unique
+                backup = dst + ".bak"
+                self._backup_to_original[backup] = dst
+                self.log.debug("Backup existing file: "
+                               "{} -> {}".format(dst, backup))
+                os.rename(dst, backup)
+
+        # Copy the files to transfer
+        for dst, (src, opts) in self._transfers.items():
+            self._create_folder_for_file(dst)
+
+            if opts["mode"] == self.MODE_COPY:
+                self.log.debug("Copying file ... {} -> {}".format(src, dst))
+                copyfile(src, dst)
+            elif opts["mode"] == self.MODE_HARDLINK:
+                self.log.debug("Hardlinking file ... {} -> {}".format(src,
+                                                                      dst))
+                create_hard_link(src, dst)
+
+            self._transferred.append(dst)
+
+    def finalize(self):
+        # Delete any backed up files
+        for backup in self._backup_to_original.keys():
+            try:
+                os.remove(backup)
+            except OSError:
+                self.log.error("Failed to remove backup file: "
+                               "{}".format(backup),
+                               exc_info=True)
+
+    def rollback(self):
+
+        errors = 0
+
+        # Rollback any transferred files
+        for path in self._transferred:
+            try:
+                os.remove(path)
+            except OSError:
+                errors += 1
+                self.log.error("Failed to rollback created file: "
+                               "{}".format(path),
+                               exc_info=True)
+
+        # Rollback the backups
+        for backup, original in self._backup_to_original.items():
+            try:
+                os.rename(backup, original)
+            except OSError:
+                errors += 1
+                self.log.error("Failed to restore original file: "
+                               "{} -> {}".format(backup, original),
+                               exc_info=True)
+
+        if errors:
+            self.log.error("{} errors occurred during "
+                           "rollback.".format(errors), exc_info=True)
+            six.reraise(*sys.exc_info())
+
+    @property
+    def transferred(self):
+        """Return the processed transfers destination paths"""
+        return list(self._transferred)
+
+    @property
+    def backups(self):
+        """Return the backup file paths"""
+        return list(self._backup_to_original.keys())
+
+    def _create_folder_for_file(self, path):
+        dirname = os.path.dirname(path)
+        try:
+            os.makedirs(dirname)
+        except OSError as e:
+            if e.errno == errno.EEXIST:
+                pass
+            else:
+                self.log.critical("An unexpected error occurred.")
+                six.reraise(*sys.exc_info())
diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 138a4fcc06..92976e6151 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -3,7 +3,6 @@ import logging
 import sys
 import copy
 import clique
-import errno
 import six
 
 from bson.objectid import ObjectId
@@ -13,19 +12,13 @@ from avalon import io
 import openpype.api
 from datetime import datetime
 from openpype.lib.profiles_filtering import filter_profiles
+from openpype.lib.file_transaction import FileTransaction
 from openpype.lib import (
     prepare_template_data,
-    create_hard_link,
     StringTemplate,
     TemplateUnsolved
 )
 
-# this is needed until speedcopy for linux is fixed
-if sys.platform == "win32":
-    from speedcopy import copyfile
-else:
-    from shutil import copyfile
-
 log = logging.getLogger(__name__)
 
 
@@ -40,164 +33,6 @@ def get_first_frame_padded(collection):
     return get_frame_padded(start_frame, padding=collection.padding)
 
 
-class FileTransaction(object):
-    """
-
-    The file transaction is a three step process.
-
-    1) Rename any existing files to a "temporary backup" during `process()`
-    2) Copy the files to final destination during `process()`
-    3) Remove any backed up files (*no rollback possible!) during `finalize()`
-
-    Step 3 is done during `finalize()`. If not called the .bak files will
-    remain on disk.
-
-    These steps try to ensure that we don't overwrite half of any existing
-    files e.g. if they are currently in use.
-
-    Note:
-        A regular filesystem is *not* a transactional file system and even
-        though this implementation tries to produce a 'safe copy' with a
-        potential rollback do keep in mind that it's inherently unsafe due
-        to how filesystem works and a myriad of things could happen during
-        the transaction that break the logic. A file storage could go down,
-        permissions could be changed, other machines could be moving or writing
-        files. A lot can happen.
-
-    Warning:
-        Any folders created during the transfer will not be removed.
-
-    """
-
-    MODE_COPY = 0
-    MODE_HARDLINK = 1
-
-    def __init__(self, log=None):
-
-        if log is None:
-            log = logging.getLogger("FileTransaction")
-
-        self.log = log
-
-        # The transfer queue
-        # todo: make this an actual FIFO queue?
-        self._transfers = {}
-
-        # Destination file paths that a file was transferred to
-        self._transferred = []
-
-        # Backup file location mapping to original locations
-        self._backup_to_original = {}
-
-    def add(self, src, dst, mode=MODE_COPY):
-        """Add a new file to transfer queue"""
-        opts = {"mode": mode}
-
-        src = os.path.normpath(src)
-        dst = os.path.normpath(dst)
-
-        if dst in self._transfers:
-            queued_src = self._transfers[dst][0]
-            if src == queued_src:
-                self.log.debug("File transfer was already "
-                               "in queue: {} -> {}".format(src, dst))
-                return
-            else:
-                self.log.warning("File transfer in queue replaced..")
-                self.log.debug("Removed from queue: "
-                               "{} -> {}".format(queued_src, dst))
-                self.log.debug("Added to queue: {} -> {}".format(src, dst))
-
-        self._transfers[dst] = (src, opts)
-
-    def process(self):
-
-        # Backup any existing files
-        for dst in self._transfers.keys():
-            if os.path.exists(dst):
-                # Backup original file
-                # todo: add timestamp or uuid to ensure unique
-                backup = dst + ".bak"
-                self._backup_to_original[backup] = dst
-                self.log.debug("Backup existing file: "
-                               "{} -> {}".format(dst, backup))
-                os.rename(dst, backup)
-
-        # Copy the files to transfer
-        for dst, (src, opts) in self._transfers.items():
-            self._create_folder_for_file(dst)
-
-            if opts["mode"] == self.MODE_COPY:
-                self.log.debug("Copying file ... {} -> {}".format(src, dst))
-                copyfile(src, dst)
-            elif opts["mode"] == self.MODE_HARDLINK:
-                self.log.debug("Hardlinking file ... {} -> {}".format(src,
-                                                                      dst))
-                create_hard_link(src, dst)
-
-            self._transferred.append(dst)
-
-    def finalize(self):
-        # Delete any backed up files
-        for backup in self._backup_to_original.keys():
-            try:
-                os.remove(backup)
-            except OSError:
-                self.log.error("Failed to remove backup file: "
-                               "{}".format(backup),
-                               exc_info=True)
-
-    def rollback(self):
-
-        errors = 0
-
-        # Rollback any transferred files
-        for path in self._transferred:
-            try:
-                os.remove(path)
-            except OSError:
-                errors += 1
-                self.log.error("Failed to rollback created file: "
-                               "{}".format(path),
-                               exc_info=True)
-
-        # Rollback the backups
-        for backup, original in self._backup_to_original.items():
-            try:
-                os.rename(backup, original)
-            except OSError:
-                errors += 1
-                self.log.error("Failed to restore original file: "
-                               "{} -> {}".format(backup, original),
-                               exc_info=True)
-
-        if errors:
-            self.log.error("{} errors occurred during "
-                           "rollback.".format(errors), exc_info=True)
-            six.reraise(*sys.exc_info())
-
-    @property
-    def transferred(self):
-        """Return the processed transfers destination paths"""
-        return list(self._transferred)
-
-    @property
-    def backups(self):
-        """Return the backup file paths"""
-        return list(self._backup_to_original.keys())
-
-    def _create_folder_for_file(self, path):
-        dirname = os.path.dirname(path)
-        try:
-            os.makedirs(dirname)
-        except OSError as e:
-            if e.errno == errno.EEXIST:
-                pass
-            else:
-                self.log.critical("An unexpected error occurred.")
-                six.reraise(*sys.exc_info())
-
-
 class IntegrateAssetNew(pyblish.api.InstancePlugin):
     """Resolve any dependency issues
 

From d3cb32ebe1df79408ff03fddef4d74a55fa1f4b6 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 14:32:34 +0100
Subject: [PATCH 0037/1227] Collect subset group in a Collector instead of
 during Integrator

---
 .../plugins/publish/collect_subset_group.py   | 100 ++++++++++++++++++
 openpype/plugins/publish/integrate_new.py     |  50 ---------
 2 files changed, 100 insertions(+), 50 deletions(-)
 create mode 100644 openpype/plugins/publish/collect_subset_group.py

diff --git a/openpype/plugins/publish/collect_subset_group.py b/openpype/plugins/publish/collect_subset_group.py
new file mode 100644
index 0000000000..60c1c04e70
--- /dev/null
+++ b/openpype/plugins/publish/collect_subset_group.py
@@ -0,0 +1,100 @@
+"""Produces instance.data["subsetGroup"] data used during integration.
+
+Requires:
+    dict -> context["anatomyData"] *(pyblish.api.CollectorOrder + 0.49)
+
+Provides:
+    instance -> subsetGroup (str)
+
+"""
+import pyblish.api
+
+from openpype.lib.profiles_filtering import filter_profiles
+from openpype.lib import (
+    prepare_template_data,
+    StringTemplate,
+    TemplateUnsolved
+)
+
+
+class CollectSubsetGroup(pyblish.api.ContextPlugin):
+    """Collect Subset Group for publish."""
+
+    # Run after CollectAnatomyInstanceData
+    order = pyblish.api.CollectorOrder + 0.495
+    label = "Collect Subset Group"
+
+    def process(self, instance):
+        """Look into subset group profiles set by settings.
+
+        Attribute 'subset_grouping_profiles' is defined by OpenPype settings.
+        """
+
+        # TODO: Move this setting to this Collector instead of Integrator
+        project_settings = instance.context.data["project_settings"]
+        subset_grouping_profiles = (
+            project_settings["global"]
+                            ["publish"]
+                            ["IntegrateAssetNew"]
+                            ["subset_grouping_profiles"]
+        )
+
+        # Skip if 'subset_grouping_profiles' is empty
+        if not subset_grouping_profiles:
+            return
+
+        # Skip if there is no matching profile
+        filter_criteria = self.get_profile_filter_criteria(instance)
+        profile = filter_profiles(subset_grouping_profiles,
+                                  filter_criteria,
+                                  logger=self.log)
+        if not profile:
+            return
+
+        if instance.data.get("subsetGroup"):
+            # If subsetGroup is already set then allow that value to remain
+            self.log.debug("Skipping collect subset group due to existing "
+                           "value: {}".format(instance.data["subsetGroup"]))
+            return
+
+        template = profile["template"]
+
+        fill_pairs = prepare_template_data({
+            "family": filter_criteria["families"],
+            "task": filter_criteria["tasks"],
+            "host": filter_criteria["hosts"],
+            "subset": instance.data["subset"],
+            "renderlayer": instance.data.get("renderlayer")
+        })
+
+        filled_template = None
+        try:
+            filled_template = StringTemplate.format_strict_template(
+                template, fill_pairs
+            )
+        except (KeyError, TemplateUnsolved):
+            keys = fill_pairs.keys()
+            msg = "Subset grouping failed. " \
+                  "Only {} are expected in Settings".format(','.join(keys))
+            self.log.warning(msg)
+
+        if filled_template:
+            instance.data["subsetGroup"] = filled_template
+
+    def get_profile_filter_criteria(self, instance):
+        """Return filter criteria for `filter_profiles`"""
+        # TODO: This logic is used in much more plug-ins in one way or another
+        #       Maybe better suited for lib?
+        # Anatomy data is pre-filled by Collectors
+        anatomy_data = instance.data["anatomyData"]
+
+        # Task can be optional in anatomy data
+        task = anatomy_data.get("task", {})
+
+        # Return filter criteria
+        return {
+            "families": anatomy_data["family"],
+            "tasks": task.get("name"),
+            "hosts": anatomy_data["app"],
+            "task_types": task.get("type")
+        }
diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 92976e6151..284e110916 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -13,11 +13,6 @@ import openpype.api
 from datetime import datetime
 from openpype.lib.profiles_filtering import filter_profiles
 from openpype.lib.file_transaction import FileTransaction
-from openpype.lib import (
-    prepare_template_data,
-    StringTemplate,
-    TemplateUnsolved
-)
 
 log = logging.getLogger(__name__)
 
@@ -619,9 +614,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         }
 
         subset_group = instance.data.get("subsetGroup")
-        if not subset_group:
-            # todo: move _get_subset_group fallback to its own collector
-            subset_group = self._get_subset_group(instance)
         if subset_group:
             data["subsetGroup"] = subset_group
 
@@ -653,48 +645,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         self.log.info("Registered subset: {}".format(subset_name))
         return subset
 
-    def _get_subset_group(self, instance):
-        """Look into subset group profiles set by settings.
-
-        Attribute 'subset_grouping_profiles' is defined by OpenPype settings.
-        """
-        # TODO: This logic is better suited for a Collector to just store
-        #       instance.data["subsetGroup"]
-        # Skip if 'subset_grouping_profiles' is empty
-        if not self.subset_grouping_profiles:
-            return None
-
-        # Skip if there is no matching profile
-        filter_criteria = self.get_profile_filter_criteria(instance)
-        profile = filter_profiles(self.subset_grouping_profiles,
-                                  filter_criteria,
-                                  logger=self.log)
-        if not profile:
-            return None
-
-        template = profile["template"]
-
-        fill_pairs = prepare_template_data({
-            "family": filter_criteria["families"],
-            "task": filter_criteria["tasks"],
-            "host": filter_criteria["hosts"],
-            "subset": instance.data["subset"],
-            "renderlayer": instance.data.get("renderlayer")
-        })
-
-        filled_template = None
-        try:
-            filled_template = StringTemplate.format_strict_template(
-                template, fill_pairs
-            )
-        except (KeyError, TemplateUnsolved):
-            keys = fill_pairs.keys()
-            msg = "Subset grouping failed. " \
-                  "Only {} are expected in Settings".format(','.join(keys))
-            self.log.warning(msg)
-
-        return filled_template
-
     def create_version_data(self, instance):
         """Create the data collection for the version
 

From d7c5ad1f7c9913a39b43087cebbbee7971844f8c Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 14:33:37 +0100
Subject: [PATCH 0038/1227] Remove duplicate "source" in families

---
 openpype/plugins/publish/integrate_new.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 284e110916..08088479d0 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -86,7 +86,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "source",
                 "matchmove",
                 "image",
-                "source",
                 "assembly",
                 "fbx",
                 "textures",

From 8fffc60b5016d63d6fad2b8c3b399537a3736171 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 14:37:23 +0100
Subject: [PATCH 0039/1227] Move remainder of prepare anatomy data to the
 Collector

---
 .../plugins/publish/collect_anatomy_context_data.py |  6 ++++++
 openpype/plugins/publish/integrate_new.py           | 13 -------------
 2 files changed, 6 insertions(+), 13 deletions(-)

diff --git a/openpype/plugins/publish/collect_anatomy_context_data.py b/openpype/plugins/publish/collect_anatomy_context_data.py
index bd8d9e50c4..346caf6b83 100644
--- a/openpype/plugins/publish/collect_anatomy_context_data.py
+++ b/openpype/plugins/publish/collect_anatomy_context_data.py
@@ -91,5 +91,11 @@ class CollectAnatomyContextData(pyblish.api.ContextPlugin):
                 }
             })
 
+        intent = context.data.get("intent")
+        if intent and isinstance(intent, dict):
+            intent_value = intent.get("value")
+            if intent_value:
+                context_data["intent"] = intent_value
+
         self.log.info("Global anatomy Data collected")
         self.log.debug(json.dumps(context_data, indent=4))
diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 08088479d0..f598c540e5 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -119,10 +119,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         if families & set(self.exclude_families):
             return
 
-        # TODO: Avoid the need to do any adjustments to anatomy data
-        #       Best case scenario that's all handled by collectors
-        self.prepare_anatomy(instance)
-
         file_transactions = FileTransaction(log=self.log)
         try:
             self.register(instance, file_transactions)
@@ -137,15 +133,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         # the try, except.
         file_transactions.finalize()
 
-    def prepare_anatomy(self, instance):
-        """Prepare anatomy data used to define representation destinations"""
-        # TODO: This logic should move to CollectAnatomyContextData
-        intent_value = instance.context.data.get("intent")
-        if intent_value and isinstance(intent_value, dict):
-            intent_value = intent_value.get("value")
-            if intent_value:
-                instance.data["anatomyData"]["intent"] = intent_value
-
     def get_profile_filter_criteria(self, instance):
         """Return filter criteria for `filter_profiles`"""
         # Anatomy data is pre-filled by Collectors

From 177e83ec8bf55e28ca551affefc4ac775570fe98 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 14:43:00 +0100
Subject: [PATCH 0040/1227] Restore "published_path" backwards compatibility
 for IntegrateFtrackInstance on Farm

---
 openpype/plugins/publish/integrate_new.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index f598c540e5..05cbb357e3 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -532,6 +532,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         # Store first transferred destination as published path data
         # todo: can we remove this?
         published_path = transfers[0][1]
+        repre["published_path"] = published_path  # Backwards compatibility
 
         # todo: `repre` is not the actual `representation` entity
         #       we should simplify/clarify difference between data above

From 7189954a3c29ca00139a9a50b58606a3c335de04 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 14:44:19 +0100
Subject: [PATCH 0041/1227] Use `os.path.abspath` instead of `os.path.normpath`
 when adding a transfer

---
 openpype/lib/file_transaction.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/lib/file_transaction.py b/openpype/lib/file_transaction.py
index 57592e297f..1626bec6b6 100644
--- a/openpype/lib/file_transaction.py
+++ b/openpype/lib/file_transaction.py
@@ -66,8 +66,8 @@ class FileTransaction(object):
         """Add a new file to transfer queue"""
         opts = {"mode": mode}
 
-        src = os.path.normpath(src)
-        dst = os.path.normpath(dst)
+        src = os.path.abspath(src)
+        dst = os.path.abspath(dst)
 
         if dst in self._transfers:
             queued_src = self._transfers[dst][0]

From 8f8b578f0ce660b1c8182ad2486aca21ed1828e2 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 19:58:55 +0100
Subject: [PATCH 0042/1227] Move Subset Grouping Profiles settings to Collect
 Subset Group

- This is moved from the Integrate Asset New settings
---
 .../plugins/publish/collect_subset_group.py   |  16 +--
 openpype/plugins/publish/integrate_new.py     |   1 -
 .../defaults/project_settings/global.json     |  20 ++--
 .../schemas/schema_global_publish.json        | 101 ++++++++++--------
 4 files changed, 71 insertions(+), 67 deletions(-)

diff --git a/openpype/plugins/publish/collect_subset_group.py b/openpype/plugins/publish/collect_subset_group.py
index 60c1c04e70..075699e304 100644
--- a/openpype/plugins/publish/collect_subset_group.py
+++ b/openpype/plugins/publish/collect_subset_group.py
@@ -24,28 +24,22 @@ class CollectSubsetGroup(pyblish.api.ContextPlugin):
     order = pyblish.api.CollectorOrder + 0.495
     label = "Collect Subset Group"
 
+    # Defined in OpenPype settings
+    subset_grouping_profiles = None
+
     def process(self, instance):
         """Look into subset group profiles set by settings.
 
         Attribute 'subset_grouping_profiles' is defined by OpenPype settings.
         """
 
-        # TODO: Move this setting to this Collector instead of Integrator
-        project_settings = instance.context.data["project_settings"]
-        subset_grouping_profiles = (
-            project_settings["global"]
-                            ["publish"]
-                            ["IntegrateAssetNew"]
-                            ["subset_grouping_profiles"]
-        )
-
         # Skip if 'subset_grouping_profiles' is empty
-        if not subset_grouping_profiles:
+        if not self.subset_grouping_profiles:
             return
 
         # Skip if there is no matching profile
         filter_criteria = self.get_profile_filter_criteria(instance)
-        profile = filter_profiles(subset_grouping_profiles,
+        profile = filter_profiles(self.subset_grouping_profiles,
                                   filter_criteria,
                                   logger=self.log)
         if not profile:
diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 05cbb357e3..4706d4d093 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -110,7 +110,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
     # Attributes set by settings
     template_name_profiles = None
-    subset_grouping_profiles = None
 
     def process(self, instance):
 
diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index 30a71b044a..528df111f0 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -20,6 +20,17 @@
             ],
             "skip_hosts_headless_publish": []
         },
+        "CollectSubsetGroup": {
+            "subset_grouping_profiles": [
+                {
+                    "families": [],
+                    "hosts": [],
+                    "task_types": [],
+                    "tasks": [],
+                    "template": ""
+                }
+            ]
+        },
         "ValidateEditorialAssetName": {
             "enabled": true,
             "optional": false
@@ -193,15 +204,6 @@
                     "tasks": [],
                     "template_name": "render"
                 }
-            ],
-            "subset_grouping_profiles": [
-                {
-                    "families": [],
-                    "hosts": [],
-                    "task_types": [],
-                    "tasks": [],
-                    "template": ""
-                }
             ]
         },
         "CleanUp": {
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
index 12043d4205..ab968037f6 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
@@ -39,6 +39,61 @@
                 }
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "CollectSubsetGroup",
+            "label": "Collect Subset Group",
+            "is_group": true,
+            "children": [
+                {
+                    "type": "list",
+                    "key": "subset_grouping_profiles",
+                    "label": "Subset grouping profiles",
+                    "use_label_wrap": true,
+                    "object_type": {
+                        "type": "dict",
+                        "children": [
+                            {
+                                "type": "label",
+                                "label": "Set all published instances as a part of specific group named according to 'Template'. <br>Implemented all variants of placeholders [{task},{family},{host},{subset},{renderlayer}]"
+                            },
+                            {
+                                "key": "families",
+                                "label": "Families",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "hosts-enum",
+                                "key": "hosts",
+                                "label": "Hosts",
+                                "multiselection": true
+                            },
+                            {
+                                "key": "task_types",
+                                "label": "Task types",
+                                "type": "task-types-enum"
+                            },
+                            {
+                                "key": "tasks",
+                                "label": "Task names",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "separator"
+                            },
+                            {
+                                "type": "text",
+                                "key": "template",
+                                "label": "Template"
+                            }
+                        ]
+                    }
+                }
+            ]
+        },
         {
             "type": "dict",
             "collapsible": true,
@@ -603,52 +658,6 @@
                             }
                         ]
                     }
-                },
-                {
-                    "type": "list",
-                    "key": "subset_grouping_profiles",
-                    "label": "Subset grouping profiles",
-                    "use_label_wrap": true,
-                    "object_type": {
-                        "type": "dict",
-                        "children": [
-                            {
-                                "type": "label",
-                                "label": "Set all published instances as a part of specific group named according to 'Template'. <br>Implemented all variants of placeholders [{task},{family},{host},{subset},{renderlayer}]"
-                            },
-                            {
-                                "key": "families",
-                                "label": "Families",
-                                "type": "list",
-                                "object_type": "text"
-                            },
-                            {
-                                "type": "hosts-enum",
-                                "key": "hosts",
-                                "label": "Hosts",
-                                "multiselection": true
-                            },
-                            {
-                                "key": "task_types",
-                                "label": "Task types",
-                                "type": "task-types-enum"
-                            },
-                            {
-                                "key": "tasks",
-                                "label": "Task names",
-                                "type": "list",
-                                "object_type": "text"
-                            },
-                            {
-                                "type": "separator"
-                            },
-                            {
-                                "type": "text",
-                                "key": "template",
-                                "label": "Template"
-                            }
-                        ]
-                    }
                 }
             ]
         },

From 6ff7167d54e8a70441300ba4d21acb5a01eb5071 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 20:09:08 +0100
Subject: [PATCH 0043/1227] Separate get_template_name into its own method +
 use `self.default_template_name`

---
 openpype/plugins/publish/integrate_new.py | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 4706d4d093..c1fa7ccaf2 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -172,14 +172,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             )
         )
 
-        # Define publish template name from profiles
-        filter_criteria = self.get_profile_filter_criteria(instance)
-        profile = filter_profiles(self.template_name_profiles,
-                                  filter_criteria,
-                                  logger=self.log)
-        template_name = "publish"
-        if profile:
-            template_name = profile["template_name"]
+        template_name = self._get_template_name(instance)
 
         subset = self.register_subset(instance)
 
@@ -582,6 +575,19 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         return families
 
+    def _get_template_name(self, instance):
+        """Return anatomy template name to use for integration"""
+
+        # Define publish template name from profiles
+        filter_criteria = self.get_profile_filter_criteria(instance)
+        profile = filter_profiles(self.template_name_profiles,
+                                  filter_criteria,
+                                  logger=self.log)
+        template_name = self.default_template_name
+        if profile:
+            template_name = profile["template_name"]
+        return template_name
+
     def register_subset(self, instance):
         asset = instance.data.get("assetEntity")
         subset_name = instance.data["subset"]

From 821293d3b855acf2cadd914328a975fd619acd56 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 20:09:31 +0100
Subject: [PATCH 0044/1227] Match comment from Integrator for consistency

---
 openpype/plugins/publish/collect_subset_group.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/collect_subset_group.py b/openpype/plugins/publish/collect_subset_group.py
index 075699e304..5756563ed3 100644
--- a/openpype/plugins/publish/collect_subset_group.py
+++ b/openpype/plugins/publish/collect_subset_group.py
@@ -24,7 +24,7 @@ class CollectSubsetGroup(pyblish.api.ContextPlugin):
     order = pyblish.api.CollectorOrder + 0.495
     label = "Collect Subset Group"
 
-    # Defined in OpenPype settings
+    # Attributes set by settings
     subset_grouping_profiles = None
 
     def process(self, instance):

From c3e0162c436a081ccf809cd429f5b828202569d0 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 20:11:31 +0100
Subject: [PATCH 0045/1227] Debug log when exclude family was found for the
 instance

---
 openpype/plugins/publish/integrate_new.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index c1fa7ccaf2..8a71c0d5aa 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -115,7 +115,10 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         # Exclude instances that also contain families from exclude families
         families = set(self._get_instance_families(instance))
-        if families & set(self.exclude_families):
+        exclude = families & set(self.exclude_families)
+        if exclude:
+            self.log.debug("Instance not integrated due to exclude "
+                           "families found: {}".format(", ".join(exclude)))
             return
 
         file_transactions = FileTransaction(log=self.log)

From fbdb385e5b855c0762583256311501b78a2ca730 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 20:20:00 +0100
Subject: [PATCH 0046/1227] Perform database registering of Subset and Version
 in a single Bulk Write

---
 openpype/plugins/publish/integrate_new.py | 30 +++++++++++------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 8a71c0d5aa..6f1d745b9a 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -177,11 +177,17 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         template_name = self._get_template_name(instance)
 
-        subset = self.register_subset(instance)
-
-        version = self.register_version(instance, subset)
+        subset, subset_writes = self.register_subset(instance)
+        version, version_writes = self.register_version(instance, subset)
         instance.data["versionEntity"] = version
 
+        # Bulk write to the database
+        # todo: Try to avoid writing already until after we've prepared
+        #       representations to allow easier rollback?
+        io._database[io.Session["AVALON_PROJECT"]].bulk_write(
+            subset_writes + version_writes
+        )
+
         archived_repres = list(io.find({
             "parent": version["_id"],
             "type": "archived_representation"
@@ -330,16 +336,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 repre["type"] = "archived_representation"
                 bulk_writes.append(InsertOne(repre))
 
-        # bulk updates
-        # todo: Try to avoid writing already until after we've prepared
-        #       representations to allow easier rollback?
-        io._database[io.Session["AVALON_PROJECT"]].bulk_write(
-            bulk_writes
-        )
-
         self.log.info("Registered version: v{0:03d}".format(version["name"]))
 
-        return version
+        return version, bulk_writes
 
     def prepare_representation(self, repre,
                                template_name,
@@ -612,6 +611,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         if subset_group:
             data["subsetGroup"] = subset_group
 
+        bulk_writes = []
         if subset is None:
             # Create a new subset
             self.log.info("Subset '%s' not found, creating ..." % subset_name)
@@ -623,22 +623,22 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "data": data,
                 "parent": asset["_id"]
             }
-            io.insert_one(subset)
+            bulk_writes.append(InsertOne(subset))
 
         else:
             # Update existing subset data with new data and set in database.
             # We also change the found subset  in-place so we don't need to
             # re-query the subset afterwards
             subset["data"].update(data)
-            io.update_many(
+            bulk_writes.append(UpdateOne(
                 {"type": "subset", "_id": subset["_id"]},
                 {"$set": {
                     "data": subset["data"]
                 }}
-            )
+            ))
 
         self.log.info("Registered subset: {}".format(subset_name))
-        return subset
+        return subset, bulk_writes
 
     def create_version_data(self, instance):
         """Create the data collection for the version

From 1844281c68d0e357eccdc8c277db278ef0651f31 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 26 Mar 2022 20:41:22 +0100
Subject: [PATCH 0047/1227] Match assertion for collection of files (allow no
 absolute paths) similar to single files

---
 openpype/plugins/publish/integrate_new.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 6f1d745b9a..ead00452da 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -398,6 +398,10 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         is_sequence_representation = isinstance(files, (list, tuple))
         if is_sequence_representation:
             # Collection of files (sequence)
+            assert not any(os.path.isabs(fname) for fname in files), (
+                "Given file names contain full paths"
+            )
+
             # Get the sequence as a collection. The files must be of a single
             # sequence and have no remainder outside of the collections.
             collections, remainder = clique.assemble(files,

From 8e0161bec7353bff8bc581d4d676b3ba7c090ba8 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 28 Mar 2022 15:04:24 +0200
Subject: [PATCH 0048/1227] Also Bulk Write representation changes + more
 cleanup

- Don't create intermediate archived representations
- Move writing of Subset + Version to database to just before file transactions
- Perform ReplaceOne for version instead of update with "$set" for the full version
---
 openpype/plugins/publish/integrate_new.py | 166 ++++++++++------------
 1 file changed, 79 insertions(+), 87 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index ead00452da..7a3ca2bdf7 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -6,7 +6,7 @@ import clique
 import six
 
 from bson.objectid import ObjectId
-from pymongo import DeleteOne, InsertOne, UpdateOne
+from pymongo import DeleteMany, ReplaceOne, InsertOne, UpdateOne
 import pyblish.api
 from avalon import io
 import openpype.api
@@ -28,6 +28,11 @@ def get_first_frame_padded(collection):
     return get_frame_padded(start_frame, padding=collection.padding)
 
 
+def bulk_write(writes):
+    """Convenience function to bulk write into active project database"""
+    return io._database[io.Session["AVALON_PROJECT"]].bulk_write(writes)
+
+
 class IntegrateAssetNew(pyblish.api.InstancePlugin):
     """Resolve any dependency issues
 
@@ -177,21 +182,17 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         template_name = self._get_template_name(instance)
 
-        subset, subset_writes = self.register_subset(instance)
-        version, version_writes = self.register_version(instance, subset)
+        subset, subset_writes = self.prepare_subset(instance)
+        version, version_writes = self.prepare_version(instance, subset)
         instance.data["versionEntity"] = version
 
-        # Bulk write to the database
-        # todo: Try to avoid writing already until after we've prepared
-        #       representations to allow easier rollback?
-        io._database[io.Session["AVALON_PROJECT"]].bulk_write(
-            subset_writes + version_writes
-        )
-
-        archived_repres = list(io.find({
-            "parent": version["_id"],
-            "type": "archived_representation"
-        }))
+        # Get existing representations (if any)
+        existing_repres_by_name = {
+            repres["name"].lower(): repres for repres in io.find({
+                "parent": version["_id"],
+                "type": "representation"
+            })
+        }
 
         # Prepare all representations
         prepared_representations = []
@@ -205,7 +206,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             # todo: reduce/simplify what is returned from this function
             prepared = self.prepare_representation(repre,
                                                    template_name,
-                                                   archived_repres,
+                                                   existing_repres_by_name,
                                                    version,
                                                    instance_stagingdir,
                                                    instance)
@@ -225,40 +226,70 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         for src, dst in instance.data.get("hardlinks", []):
             file_transactions.add(src, dst, mode=FileTransaction.MODE_HARDLINK)
 
+        # Bulk write to the database
+        # todo: Can we move this even to after the file transfers?
+        bulk_write(subset_writes + version_writes)
+        self.log.info("Subset {subset[name]} and Version {version[name]} "
+                      "written to database..".format(subset=subset,
+                                                     version=version))
+
         # Process all file transfers of all integrations now
         self.log.debug("Integrating source files to destination ...")
         file_transactions.process()
-        self.log.debug("Backup files "
+        self.log.debug("Backed up existing files: "
                        "{}".format(file_transactions.backups))
-        self.log.debug("Integrated files "
+        self.log.debug("Transferred files: "
                        "{}".format(file_transactions.transferred))
 
         # Finalize the representations now the published files are integrated
         # Get 'files' info for representations and its attached resources
-        self.log.debug("Retrieving Representation files information ...")
+        self.log.debug("Retrieving Representation Site Sync information ...")
         sites = SiteSync.compute_resource_sync_sites(
             system_settings=instance.context.data["system_settings"],
             project_settings=instance.context.data["project_settings"]
         )
-        log.debug("final sites:: {}".format(sites))
+        self.log.debug("final sites:: {}".format(sites))
 
         anatomy = instance.context.data["anatomy"]
-        representations = []
+        representation_writes = []
+        new_repre_names_low = set()
         for prepared in prepared_representations:
             transfers = prepared["transfers"]
             representation = prepared["representation"]
             representation["files"] = self.get_files_info(
                 transfers, sites, anatomy
             )
-            representations.append(representation)
 
-        # Remove all archived representations
-        if archived_repres:
-            repre_ids_to_remove = [repre["_id"] for repre in archived_repres]
-            io.delete_many({"_id": {"$in": repre_ids_to_remove}})
+            # Set up representation for writing to the database. Since
+            # we *might* be overwriting an existing entry if the version
+            # already existed we'll use ReplaceOnce with `upsert=True`
+            representation_writes.append(ReplaceOne(
+                filter={"_id": representation["_id"]},
+                replacement=representation,
+                upsert=True
+            ))
 
-        # Write the new representations to the database
-        io.insert_many(representations)
+            new_repre_names_low.add(representation["name"].lower())
+
+        # Delete any existing representations that didn't get any new data
+        # if the instance is not set to append mode
+        if not instance.data.get("append", False):
+            delete_names = set()
+            for name, existing_repres in existing_repres_by_name.items():
+                if name not in new_repre_names_low:
+                    # We add the exact representation name because `name` is
+                    # lowercase for name matching only and not in the database
+                    delete_names.add(existing_repres["name"])
+            if delete_names:
+                representation_writes.append(DeleteMany(
+                    filter={
+                        "parent": version["_id"],
+                        "name": {"$in": list(delete_names)}
+                    }
+                ))
+
+        # Write representations to the database
+        bulk_write(representation_writes)
 
         # Backwards compatibility
         # todo: can we avoid the need to store this?
@@ -267,12 +298,11 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         }
 
         self.log.info("Registered {} representations"
-                      "".format(len(representations)))
+                      "".format(len(prepared_representations)))
 
-    def register_version(self, instance, subset):
+    def prepare_version(self, instance, subset):
 
         version_number = instance.data["version"]
-        self.log.debug("Version: v{0:03d}".format(version_number))
 
         version = {
             "schema": "openpype:version-3.0",
@@ -288,61 +318,26 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             'name': version_number
         })
 
-        bulk_writes = []
-        if existing_version is None:
+        if existing_version:
+            self.log.debug("Updating existing version ...")
+            version["_id"] = existing_version["_id"]
+        else:
             self.log.debug("Creating new version ...")
             version["_id"] = ObjectId()
-            bulk_writes.append(InsertOne(version))
-        else:
-            self.log.debug("Updating existing version ...")
-            # Check if instance have set `append` mode which cause that
-            # only replicated representations are set to archive
-            append_repres = instance.data.get("append", False)
 
-            # Update version data
-            version_id = existing_version['_id']
-            bulk_writes.append(UpdateOne({
-                '_id': version_id
-            }, {
-                '$set': version
-            }))
+        bulk_writes = [ReplaceOne(
+            filter={"_id": version["_id"]},
+            replacement=version,
+            upsert=True
+        )]
 
-            # Instead of directly writing and querying we reproduce what
-            # the resulting version would look like so we can hold off making
-            # changes to the database to avoid the need for 'rollback'
-            version = copy.deepcopy(version)
-            version["_id"] = existing_version["_id"]
-
-            # Find representations of existing version and archive them
-            repres = instance.data.get("representations", [])
-            new_repre_names_low = [_repre["name"].lower() for _repre in repres]
-            current_repres = io.find({
-                "type": "representation",
-                "parent": version_id
-            })
-            for repre in current_repres:
-                if append_repres:
-                    # archive only duplicated representations
-                    if repre["name"].lower() not in new_repre_names_low:
-                        continue
-                # Representation must change type,
-                # `_id` must be stored to other key and replaced with new
-                # - that is because new representations should have same ID
-                repre_id = repre["_id"]
-                bulk_writes.append(DeleteOne({"_id": repre_id}))
-
-                repre["orig_id"] = repre_id
-                repre["_id"] = ObjectId()
-                repre["type"] = "archived_representation"
-                bulk_writes.append(InsertOne(repre))
-
-        self.log.info("Registered version: v{0:03d}".format(version["name"]))
+        self.log.info("Prepared version: v{0:03d}".format(version["name"]))
 
         return version, bulk_writes
 
     def prepare_representation(self, repre,
                                template_name,
-                               archived_repres,
+                               existing_repres_by_name,
                                version,
                                instance_stagingdir,
                                instance):
@@ -516,15 +511,12 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         if repre.get("udim"):
             repre_context["udim"] = repre.get("udim")  # store list
 
-        # Define representation id
-        repre_id = ObjectId()
-
         # Use previous representation's id if there is a name match
-        repre_name_lower = repre["name"].lower()
-        for _archived_repres in archived_repres:
-            if repre_name_lower == _archived_repres["name"].lower():
-                repre_id = _archived_repres["orig_id"]
-                break
+        existing = existing_repres_by_name.get(repre["name"].lower())
+        if existing:
+            repre_id = existing["_id"]
+        else:
+            repre_id = ObjectId()
 
         # Backwards compatibility:
         # Store first transferred destination as published path data
@@ -594,7 +586,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             template_name = profile["template_name"]
         return template_name
 
-    def register_subset(self, instance):
+    def prepare_subset(self, instance):
         asset = instance.data.get("assetEntity")
         subset_name = instance.data["subset"]
         self.log.debug("Subset: {}".format(subset_name))
@@ -631,7 +623,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         else:
             # Update existing subset data with new data and set in database.
-            # We also change the found subset  in-place so we don't need to
+            # We also change the found subset in-place so we don't need to
             # re-query the subset afterwards
             subset["data"].update(data)
             bulk_writes.append(UpdateOne(
@@ -641,7 +633,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 }}
             ))
 
-        self.log.info("Registered subset: {}".format(subset_name))
+        self.log.info("Prepared subset: {}".format(subset_name))
         return subset, bulk_writes
 
     def create_version_data(self, instance):

From ba2c6e6f084e5829f32250735f13f045cabca800 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 28 Mar 2022 15:43:57 +0200
Subject: [PATCH 0049/1227] Fix class type

---
 openpype/plugins/publish/collect_subset_group.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/collect_subset_group.py b/openpype/plugins/publish/collect_subset_group.py
index 5756563ed3..56cd7de94e 100644
--- a/openpype/plugins/publish/collect_subset_group.py
+++ b/openpype/plugins/publish/collect_subset_group.py
@@ -17,7 +17,7 @@ from openpype.lib import (
 )
 
 
-class CollectSubsetGroup(pyblish.api.ContextPlugin):
+class CollectSubsetGroup(pyblish.api.InstancePlugin):
     """Collect Subset Group for publish."""
 
     # Run after CollectAnatomyInstanceData

From ef0210a98aba43e8a17ba23dc0a1cf57ad38034f Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Mon, 28 Mar 2022 16:48:01 +0200
Subject: [PATCH 0050/1227] Error Handling, ffmpeg fixes

---
 igniter/3}                                    |   0
 .../plugins/publish/extract_review_slate.py   | 172 +++++++++---------
 2 files changed, 90 insertions(+), 82 deletions(-)
 create mode 100644 igniter/3}

diff --git a/igniter/3} b/igniter/3}
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index d6857c7915..2854108022 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -1,4 +1,5 @@
 import os
+import shutil
 import openpype.api
 import pyblish
 from openpype.lib import (
@@ -73,74 +74,72 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 os.path.normpath(stagingdir), repre["files"])
             self.log.debug("__ input_path: {}".format(input_path))
 
-            video_streams = get_ffprobe_streams(
+            streams = get_ffprobe_streams(
                 input_path, self.log
             )
-
-            # Try to find first stream with defined 'width' and 'height'
-            # - this is to avoid order of streams where audio can be as first
-            # - there may be a better way (checking `codec_type`?)
-            input_width = None
-            input_height = None
-            input_timecode = None
-            input_frame_rate = None
-            input_audio = False
-            audio_channels = None
-            audio_sample_rate = None
-            audio_channel_layout = None
-            for stream in video_streams:
-                self.log.debug("__ ffprobe: {}".format(stream))
+            # get video metadata
+            for stream in streams:
+                input_timecode = None
+                input_width = None
+                input_height = None
+                input_frame_rate = None
                 if "codec_type" in stream:
                     if stream["codec_type"] == "video":
-                        if stream["tags"]["timecode"]:
-                            # get timecode of the first frame
-                            input_timecode = stream["tags"]["timecode"]
-                            self.log.debug("__Video Timecode : {}".format(
-                                input_timecode))
+                        self.log.debug("__Ffprobe Video: {}".format(stream))
+                        tags = stream.get("tags") or {}
+                        input_timecode = tags.get("timecode") or ""
                         if "width" in stream and "height" in stream:
-                            input_width = int(stream["width"])
-                            input_height = int(stream["height"])
+                            input_width = int(stream.get("width"))
+                            input_height = int(stream.get("height"))
                         if "r_frame_rate" in stream:
                             # get frame rate in a form of
                             # x/y, like 24000/1001 for 23.976
-                            input_frame_rate = str(stream["r_frame_rate"])
-                    if stream["codec_type"] == "audio":
-                        # get audio details
-                        # for generating silent audio track for slate
-                        if stream["channels"]:
-                            audio_channels = str(stream["channels"])
-                        if stream["sample_rate"]:
-                            audio_sample_rate = stream["sample_rate"]
-                        if stream["channel_layout"]:
-                            audio_channel_layout = stream["channel_layout"]
-            # calculate duration of one frame in seconds
-            if input_frame_rate:
-                # it is halved to make sure audio will be shorter then video
-                one_frame_duration = str(
-                    float(1.0 / eval(input_frame_rate)) / 2
-                )
-            else:
-                # same sane default (1 frame @ 25 fps)
-                one_frame_duration = 0.04
-            self.log.debug(
-                "One frame duration is {} sec".format(one_frame_duration))
-            # confirm we gathered all needed audio parameters
-            if audio_channel_layout:
-                if audio_sample_rate:
-                    if audio_channels:
-                        input_audio = True
-                        self.log.debug("__Audio : channels {}".format(
-                            audio_channels))
-                        self.log.debug("__Audio : sample_rate {}".format(
-                            audio_sample_rate))
-                        self.log.debug("__Audio : channel_layout {}".format(
-                            audio_channel_layout))
-            
+                            input_frame_rate = str(stream.get("r_frame_rate"))
+                        if (
+                            input_timecode
+                            and input_width
+                            and input_height
+                            and input_frame_rate
+                        ):
+                            break
             # Raise exception of any stream didn't define input resolution
             if input_width is None:
                 raise AssertionError((
                     "FFprobe couldn't read resolution from input file: \"{}\""
                 ).format(input_path))
+            # Get audio metadata
+            for stream in streams:
+                audio_channels = None
+                audio_sample_rate = None
+                audio_channel_layout = None
+                input_audio = False
+                if stream["codec_type"] == "audio":
+                    self.log.debug("__Ffprobe Audio: {}".format(stream))
+                    if stream["channels"]:
+                        audio_channels = str(stream.get("channels"))
+                    if stream["sample_rate"]:
+                        audio_sample_rate = str(stream.get("sample_rate"))
+                    if stream["channel_layout"]:
+                        audio_channel_layout = str(stream.get("channel_layout"))
+                    if (
+                        audio_channels
+                        and audio_sample_rate
+                        and audio_channel_layout
+                    ):
+                        input_audio = True
+                        break
+            # Get duration of one frame in micro seconds
+            one_frame_duration = "40000us"
+            if input_frame_rate:
+                items = input_frame_rate.split("/")
+                if len(items) == 1:
+                    one_frame_duration = float(1.0) / float(items[0])
+                elif len(items) == 2:
+                    one_frame_duration = float(items[1]) / float(items[0])
+                one_frame_duration *= 1000000
+                one_frame_duration = str(int(one_frame_duration))+"us"
+            self.log.debug(
+                "One frame duration is {}".format(one_frame_duration))
 
             # values are set in ExtractReview
             if use_legacy_code:
@@ -192,7 +191,16 @@ class ExtractReviewSlate(openpype.api.Extractor):
             input_args = []
             output_args = []
 
-            # if input has audio, add silent audio to the slate
+            # preset's input data
+            if use_legacy_code:
+                input_args.extend(repre["_profile"].get('input', []))
+            else:
+                input_args.extend(repre["outputDef"].get('input', []))
+
+            input_args.append("-loop 1 -i {}".format(
+            openpype.lib.path_to_subprocess_arg(slate_path)
+            ))
+            # if input has an audio, add silent audio to the slate
             if input_audio:
                 input_args.extend(
                     ["-f lavfi -i anullsrc=r={}:cl={}:d={}".format(
@@ -201,16 +209,9 @@ class ExtractReviewSlate(openpype.api.Extractor):
                         one_frame_duration
                     )]
                 )
-            # preset's input data
-            if use_legacy_code:
-                input_args.extend(repre["_profile"].get('input', []))
-            else:
-                input_args.extend(repre["outputDef"].get('input', []))
-            # enforce framerate before -i
-            input_args.append("-framerate {} -i {}".format(
-                input_frame_rate,
-                path_to_subprocess_arg(slate_path)
-            ))
+
+            input_args.extend(["-r {}".format(input_frame_rate)])
+            input_args.extend(["-frames:v 1"])
             # add timecode from source to the slate, substract one frame
             if input_timecode:
                 offset_timecode = self._tc_offset(
@@ -218,9 +219,14 @@ class ExtractReviewSlate(openpype.api.Extractor):
                     framerate=fps,
                     frame_offset=-1
                 )
-                self.log.debug("Timecode: `{}`".format(offset_timecode))
-                input_args.extend(["-timecode {}".format(offset_timecode)])
-
+                self.log.debug("Slate Timecode: `{}`".format(
+                    offset_timecode
+                ))
+                if offset_timecode:
+                    input_args.extend(["-timecode {}".format(offset_timecode)])
+                else:
+                    # fall back to input timecode if offset fails
+                    input_args.extend(["-timecode {}".format(input_timecode)])
             if use_legacy_code:
                 codec_args = repre["_profile"].get('codec', [])
                 output_args.extend(codec_args)
@@ -283,10 +289,6 @@ class ExtractReviewSlate(openpype.api.Extractor):
             # add it to output_args
             output_args.insert(0, vf_back)
 
-            # use video duration for silent audio duration
-            if input_audio:
-                output_args.append("-shortest")
-
             # overrides output file
             output_args.append("-y")
 
@@ -334,17 +336,23 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 "-f", "concat",
                 "-safe", "0",
                 "-i", conc_text_path,
-                "-c", "copy",
+                "-c:v", "copy",
                 output_path
             ]
-
-            # ffmpeg concat subprocess
-            self.log.debug(
-                "Executing concat: {}".format(" ".join(concat_args))
-            )
-            openpype.api.run_subprocess(
-                concat_args, logger=self.log
-            )
+            if not input_audio:
+                # ffmpeg concat subprocess
+                self.log.debug(
+                    "Executing concat: {}".format(" ".join(concat_args))
+                )
+                openpype.api.run_subprocess(
+                    concat_args, logger=self.log
+                )
+            else:
+                self.log.warning("Audio found. Creating slate with audio"
+                " is not supported at this time. Outputing slate-less"
+                ":\n{}".format(input_file))
+                # skip concatenating slate, use slate-less file instead
+                shutil.copyfile(input_path, output_path)     
 
             self.log.debug("__ repre[tags]: {}".format(repre["tags"]))
             repre_update = {

From 027081700e47ef4c5eddee20cb30d885b9a3c8d7 Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Mon, 28 Mar 2022 19:14:46 +0200
Subject: [PATCH 0051/1227] hound

---
 openpype/plugins/publish/extract_review_slate.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 2854108022..d2a7b9a12a 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -120,7 +120,8 @@ class ExtractReviewSlate(openpype.api.Extractor):
                     if stream["sample_rate"]:
                         audio_sample_rate = str(stream.get("sample_rate"))
                     if stream["channel_layout"]:
-                        audio_channel_layout = str(stream.get("channel_layout"))
+                        audio_channel_layout = str(
+                            stream.get("channel_layout"))
                     if (
                         audio_channels
                         and audio_sample_rate

From 90e29c6f521bd78d84444c357171b6f7b499a8bf Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Mon, 28 Mar 2022 19:35:25 +0200
Subject: [PATCH 0052/1227] hound2

---
 openpype/plugins/publish/extract_review_slate.py | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index d2a7b9a12a..037535342d 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -138,7 +138,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 elif len(items) == 2:
                     one_frame_duration = float(items[1]) / float(items[0])
                 one_frame_duration *= 1000000
-                one_frame_duration = str(int(one_frame_duration))+"us"
+                one_frame_duration = str(int(one_frame_duration)) + "us"
             self.log.debug(
                 "One frame duration is {}".format(one_frame_duration))
 
@@ -199,8 +199,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 input_args.extend(repre["outputDef"].get('input', []))
 
             input_args.append("-loop 1 -i {}".format(
-            openpype.lib.path_to_subprocess_arg(slate_path)
-            ))
+                openpype.lib.path_to_subprocess_arg(slate_path)))
             # if input has an audio, add silent audio to the slate
             if input_audio:
                 input_args.extend(
@@ -350,10 +349,10 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 )
             else:
                 self.log.warning("Audio found. Creating slate with audio"
-                " is not supported at this time. Outputing slate-less"
-                ":\n{}".format(input_file))
+                    " is not supported at this time. Outputing slate-less"
+                    ":\n{}".format(input_file))
                 # skip concatenating slate, use slate-less file instead
-                shutil.copyfile(input_path, output_path)     
+                shutil.copyfile(input_path, output_path)
 
             self.log.debug("__ repre[tags]: {}".format(repre["tags"]))
             repre_update = {

From e6665e579ee069b30a02b1034e53d48c85553761 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 28 Mar 2022 20:32:46 +0200
Subject: [PATCH 0053/1227] Restructure code and more cleanup

---
 openpype/plugins/publish/integrate_new.py | 250 +++++++++++-----------
 1 file changed, 123 insertions(+), 127 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 7a3ca2bdf7..6401806394 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -17,6 +17,21 @@ from openpype.lib.file_transaction import FileTransaction
 log = logging.getLogger(__name__)
 
 
+def get_instance_families(instance):
+    """Get all families of the instance"""
+    # todo: move this to lib?
+    family = instance.data.get("family")
+    families = []
+    if family:
+        families.append(family)
+
+    for _family in (instance.data.get("families") or []):
+        if _family not in families:
+            families.append(_family)
+
+    return families
+
+
 def get_frame_padded(frame, padding):
     """Return frame number as string with `padding` amount of padded zeros"""
     return "{frame:0{padding}d}".format(padding=padding, frame=frame)
@@ -119,7 +134,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     def process(self, instance):
 
         # Exclude instances that also contain families from exclude families
-        families = set(self._get_instance_families(instance))
+        families = set(get_instance_families(instance))
         exclude = families & set(self.exclude_families)
         if exclude:
             self.log.debug("Instance not integrated due to exclude "
@@ -140,22 +155,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         # the try, except.
         file_transactions.finalize()
 
-    def get_profile_filter_criteria(self, instance):
-        """Return filter criteria for `filter_profiles`"""
-        # Anatomy data is pre-filled by Collectors
-        anatomy_data = instance.data["anatomyData"]
-
-        # Task can be optional in anatomy data
-        task = anatomy_data.get("task", {})
-
-        # Return filter criteria
-        return {
-            "families": anatomy_data["family"],
-            "tasks": task.get("name"),
-            "hosts": anatomy_data["app"],
-            "task_types": task.get("type")
-        }
-
     def register(self, instance, file_transactions):
 
         instance_stagingdir = instance.data.get("stagingDir")
@@ -171,16 +170,16 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "@ {0}".format(instance_stagingdir)
             )
 
-        # Ensure at least one file is set up for transfer in staging dir.
+        # Ensure at least one representation is set up for registering.
         repres = instance.data.get("representations")
-        assert repres, "Instance has no files to transfer"
+        assert repres, "Instance has representations data"
         assert isinstance(repres, (list, tuple)), (
-            "Instance 'files' must be a list, got: {0} {1}".format(
+            "Instance 'repres' must be a list, got: {0} {1}".format(
                 str(type(repres)), str(repres)
             )
         )
 
-        template_name = self._get_template_name(instance)
+        template_name = self.get_template_name(instance)
 
         subset, subset_writes = self.prepare_subset(instance)
         version, version_writes = self.prepare_version(instance, subset)
@@ -300,6 +299,56 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         self.log.info("Registered {} representations"
                       "".format(len(prepared_representations)))
 
+    def prepare_subset(self, instance):
+        asset = instance.data.get("assetEntity")
+        subset_name = instance.data["subset"]
+        self.log.debug("Subset: {}".format(subset_name))
+
+        # Get existing subset if it exists
+        subset = io.find_one({
+            "type": "subset",
+            "parent": asset["_id"],
+            "name": subset_name
+        })
+
+        # Define subset data
+        data = {
+            "families": get_instance_families(instance)
+        }
+
+        subset_group = instance.data.get("subsetGroup")
+        if subset_group:
+            data["subsetGroup"] = subset_group
+
+        bulk_writes = []
+        if subset is None:
+            # Create a new subset
+            self.log.info("Subset '%s' not found, creating ..." % subset_name)
+            subset = {
+                "_id": ObjectId(),
+                "schema": "openpype:subset-3.0",
+                "type": "subset",
+                "name": subset_name,
+                "data": data,
+                "parent": asset["_id"]
+            }
+            bulk_writes.append(InsertOne(subset))
+
+        else:
+            # Update existing subset data with new data and set in database.
+            # We also change the found subset in-place so we don't need to
+            # re-query the subset afterwards
+            subset["data"].update(data)
+            bulk_writes.append(UpdateOne(
+                {"type": "subset", "_id": subset["_id"]},
+                {"$set": {
+                    "data": subset["data"]
+                }}
+            ))
+
+        self.log.info("Prepared subset: {}".format(subset_name))
+        return subset, bulk_writes
+
     def prepare_version(self, instance, subset):
 
         version_number = instance.data["version"]
@@ -559,91 +608,14 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "published_files": [transfer[1] for transfer in transfers]
         }
 
-    def _get_instance_families(self, instance):
-        """Get all families of the instance"""
-        # todo: move this to lib?
-        family = instance.data.get("family")
-        families = []
-        if family:
-            families.append(family)
-
-        for _family in (instance.data.get("families") or []):
-            if _family not in families:
-                families.append(_family)
-
-        return families
-
-    def _get_template_name(self, instance):
-        """Return anatomy template name to use for integration"""
-
-        # Define publish template name from profiles
-        filter_criteria = self.get_profile_filter_criteria(instance)
-        profile = filter_profiles(self.template_name_profiles,
-                                  filter_criteria,
-                                  logger=self.log)
-        template_name = self.default_template_name
-        if profile:
-            template_name = profile["template_name"]
-        return template_name
-
-    def prepare_subset(self, instance):
-        asset = instance.data.get("assetEntity")
-        subset_name = instance.data["subset"]
-        self.log.debug("Subset: {}".format(subset_name))
-
-        # Get existing subset if it exists
-        subset = io.find_one({
-            "type": "subset",
-            "parent": asset["_id"],
-            "name": subset_name
-        })
-
-        # Define subset data
-        data = {
-            "families": self._get_instance_families(instance)
-        }
-
-        subset_group = instance.data.get("subsetGroup")
-        if subset_group:
-            data["subsetGroup"] = subset_group
-
-        bulk_writes = []
-        if subset is None:
-            # Create a new subset
-            self.log.info("Subset '%s' not found, creating ..." % subset_name)
-            subset = {
-                "_id": ObjectId(),
-                "schema": "openpype:subset-3.0",
-                "type": "subset",
-                "name": subset_name,
-                "data": data,
-                "parent": asset["_id"]
-            }
-            bulk_writes.append(InsertOne(subset))
-
-        else:
-            # Update existing subset data with new data and set in database.
-            # We also change the found subset in-place so we don't need to
-            # re-query the subset afterwards
-            subset["data"].update(data)
-            bulk_writes.append(UpdateOne(
-                {"type": "subset", "_id": subset["_id"]},
-                {"$set": {
-                    "data": subset["data"]
-                }}
-            ))
-
-        self.log.info("Prepared subset: {}".format(subset_name))
-        return subset, bulk_writes
-
     def create_version_data(self, instance):
-        """Create the data collection for the version
+        """Create the data dictionary for the version
 
         Args:
             instance: the current instance being published
 
         Returns:
-            dict: the required information with instance.data as key
+            dict: the required information for version["data"]
         """
 
         context = instance.context
@@ -658,7 +630,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         self.log.debug("Source: {}".format(source))
 
         version_data = {
-            "families": self._get_instance_families(instance),
+            "families": get_instance_families(instance),
             "time": context.data["time"],
             "author": context.data["user"],
             "source": source,
@@ -692,28 +664,52 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         return version_data
 
-    def main_family_from_instance(self, instance):
-        """Returns main family of entered instance."""
-        return self._get_instance_families(instance)[0]
+    def get_template_name(self, instance):
+        """Return anatomy template name to use for integration"""
+
+        # Define publish template name from profiles
+        filter_criteria = self.get_profile_filter_criteria(instance)
+        profile = filter_profiles(self.template_name_profiles,
+                                  filter_criteria,
+                                  logger=self.log)
+        template_name = self.default_template_name
+        if profile:
+            template_name = profile["template_name"]
+        return template_name
+
+    def get_profile_filter_criteria(self, instance):
+        """Return filter criteria for `filter_profiles`"""
+        # Anatomy data is pre-filled by Collectors
+        anatomy_data = instance.data["anatomyData"]
+
+        # Task can be optional in anatomy data
+        task = anatomy_data.get("task", {})
+
+        # Return filter criteria
+        return {
+            "families": anatomy_data["family"],
+            "tasks": task.get("name"),
+            "hosts": anatomy_data["app"],
+            "task_types": task.get("type")
+        }
 
     def get_rootless_path(self, anatomy, path):
-        """  Returns, if possible, path without absolute portion from host
-             (eg. 'c:\' or '/opt/..')
-             This information is host dependent and shouldn't be captured.
-             Example:
-                 'c:/projects/MyProject1/Assets/publish...' >
-                 '{root}/MyProject1/Assets...'
+        """Returns, if possible, path without absolute portion from root
+            (eg. 'c:\' or '/opt/..')
+
+         This information is platform dependent and shouldn't be captured.
+         Example:
+             'c:/projects/MyProject1/Assets/publish...' >
+             '{root}/MyProject1/Assets...'
 
         Args:
-                anatomy: anatomy part from instance
-                path: path (absolute)
+            anatomy: anatomy part from instance
+            path: path (absolute)
         Returns:
-                path: modified path if possible, or unmodified path
-                + warning logged
+            path: modified path if possible, or unmodified path
+            + warning logged
         """
-        success, rootless_path = (
-            anatomy.find_root_template_from_path(path)
-        )
+        success, rootless_path = anatomy.find_root_template_from_path(path)
         if success:
             path = rootless_path
         else:
@@ -731,9 +727,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             Context info.
 
         Arguments:
-            instance: the current instance being published
-            integrated_file_sizes: dictionary of destination path (absolute)
-            and its file size
+            transfers (list): List of transferred files (source, destination)
+            sites (list): array of published locations
+            anatomy: anatomy part from instance
         Returns:
             output_resources: array of dictionaries to be added to 'files' key
             in representation
@@ -749,14 +745,14 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         """ Prepare information for one file (asset or resource)
 
         Arguments:
-            path: destination url of published file (rootless)
-            size(optional): size of file in bytes
-            file_hash(optional): hash of file for synchronization validation
-            sites(optional): array of published locations,
-                            [ {'name':'studio', 'created_dt':date} by default
-                                keys expected ['studio', 'site1', 'gdrive1']
+            path: destination url of published file
+            anatomy: anatomy part from instance
+            sites: array of published locations,
+                [ {'name':'studio', 'created_dt':date} by default
+                keys expected ['studio', 'site1', 'gdrive1']
+
         Returns:
-            rec: dictionary with filled info
+            dict: file info dictionary
         """
         file_hash = openpype.api.source_hash(path)
 

From 2777c36eb52e7390b15accc93c9b9a9a771ba21d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 28 Mar 2022 20:34:16 +0200
Subject: [PATCH 0054/1227] Rely on `instance.data["fps"] over
 `context.data["fps"]` if available

---
 openpype/plugins/publish/integrate_new.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 6401806394..00922b0ed3 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -636,9 +636,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "source": source,
             "comment": context.data.get("comment"),
             "machine": context.data.get("machine"),
-            "fps": context.data.get(
-                "fps", instance.data.get("fps")
-            )
+            "fps": instance.data.get("fps", context.data.get("fps"))
         }
 
         intent_value = context.data.get("intent")

From 13f6b03637e7d696ad45418856c6576883c9892f Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Mon, 28 Mar 2022 20:38:47 +0200
Subject: [PATCH 0055/1227] hound3

---
 openpype/plugins/publish/extract_review_slate.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 037535342d..c8ee2ec7ed 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -348,7 +348,8 @@ class ExtractReviewSlate(openpype.api.Extractor):
                     concat_args, logger=self.log
                 )
             else:
-                self.log.warning("Audio found. Creating slate with audio"
+                self.log.warning(
+                    "Audio found. Creating slate with audio"
                     " is not supported at this time. Outputing slate-less"
                     ":\n{}".format(input_file))
                 # skip concatenating slate, use slate-less file instead

From 0db0fa0de9fe085f48f62d2b1ffe766edf95e897 Mon Sep 17 00:00:00 2001
From: Jiri Sindelar <45896205+jrsndl@users.noreply.github.com>
Date: Tue, 29 Mar 2022 09:27:33 +0200
Subject: [PATCH 0056/1227] stray empty file?

---
 igniter/3} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 igniter/3}

diff --git a/igniter/3} b/igniter/3}
deleted file mode 100644
index e69de29bb2..0000000000

From add4958d4c9078b6ecad131f6e40beb66ecdd348 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 29 Mar 2022 09:43:27 +0200
Subject: [PATCH 0057/1227] Fix message

---
 openpype/plugins/publish/integrate_new.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 00922b0ed3..f6aa720dbb 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -172,7 +172,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         # Ensure at least one representation is set up for registering.
         repres = instance.data.get("representations")
-        assert repres, "Instance has representations data"
+        assert repres, "Instance has no representations data"
         assert isinstance(repres, (list, tuple)), (
             "Instance 'repres' must be a list, got: {0} {1}".format(
                 str(type(repres)), str(repres)

From 77b5c24370b61615b2380fdc464137d3eba13ab9 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 29 Mar 2022 11:44:30 +0200
Subject: [PATCH 0058/1227] Fix message

---
 openpype/plugins/publish/integrate_new.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index f6aa720dbb..020b1d2b9c 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -174,7 +174,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         repres = instance.data.get("representations")
         assert repres, "Instance has no representations data"
         assert isinstance(repres, (list, tuple)), (
-            "Instance 'repres' must be a list, got: {0} {1}".format(
+            "Instance 'representations' must be a list, got: {0} {1}".format(
                 str(type(repres)), str(repres)
             )
         )

From 127f19873f876d58a2c954c4a56c73ddd4d4d4af Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 29 Mar 2022 11:58:52 +0200
Subject: [PATCH 0059/1227] Streamlining some code, optimize some database
 queries with projection

---
 openpype/plugins/publish/integrate_new.py | 36 ++++++++++++-----------
 1 file changed, 19 insertions(+), 17 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 020b1d2b9c..d869a1b6be 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -187,10 +187,14 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         # Get existing representations (if any)
         existing_repres_by_name = {
-            repres["name"].lower(): repres for repres in io.find({
-                "parent": version["_id"],
-                "type": "representation"
-            })
+            repres["name"].lower(): repres for repres in io.find(
+                {
+                    "parent": version["_id"],
+                    "type": "representation"
+                },
+                # Only care about id and name of existing representations
+                projection={"_id": True, "name": True}
+            )
         }
 
         # Prepare all representations
@@ -239,16 +243,17 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                        "{}".format(file_transactions.backups))
         self.log.debug("Transferred files: "
                        "{}".format(file_transactions.transferred))
-
-        # Finalize the representations now the published files are integrated
-        # Get 'files' info for representations and its attached resources
         self.log.debug("Retrieving Representation Site Sync information ...")
+
+        # Get the accessible sites for Site Sync
         sites = SiteSync.compute_resource_sync_sites(
             system_settings=instance.context.data["system_settings"],
             project_settings=instance.context.data["project_settings"]
         )
-        self.log.debug("final sites:: {}".format(sites))
+        self.log.debug("Site Sync Sites: {}".format(sites))
 
+        # Finalize the representations now the published files are integrated
+        # Get 'files' info for representations and its attached resources
         anatomy = instance.context.data["anatomy"]
         representation_writes = []
         new_repre_names_low = set()
@@ -365,7 +370,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             'type': 'version',
             'parent': subset["_id"],
             'name': version_number
-        })
+        }, projection={"_id": True})
 
         if existing_version:
             self.log.debug("Updating existing version ...")
@@ -576,7 +581,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         # todo: `repre` is not the actual `representation` entity
         #       we should simplify/clarify difference between data above
         #       and the actual representation entity for the database
-        data = repre.get("data") or {}
+        data = repre.get("data", {})
         data.update({'path': published_path, 'template': template})
         representation = {
             "_id": repre_id,
@@ -664,16 +669,15 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
     def get_template_name(self, instance):
         """Return anatomy template name to use for integration"""
-
         # Define publish template name from profiles
         filter_criteria = self.get_profile_filter_criteria(instance)
         profile = filter_profiles(self.template_name_profiles,
                                   filter_criteria,
                                   logger=self.log)
-        template_name = self.default_template_name
         if profile:
-            template_name = profile["template_name"]
-        return template_name
+            return profile["template_name"]
+        else:
+            return self.default_template_name
 
     def get_profile_filter_criteria(self, instance):
         """Return filter criteria for `filter_profiles`"""
@@ -752,13 +756,11 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         Returns:
             dict: file info dictionary
         """
-        file_hash = openpype.api.source_hash(path)
-
         return {
             "_id": ObjectId(),
             "path": self.get_rootless_path(anatomy, path),
             "size": os.path.getsize(path),
-            "hash": file_hash,
+            "hash": openpype.api.source_hash(path),
             "sites": sites
         }
 

From 0c2c60d37b05411193acf8c60f6a2562463ba558 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 29 Mar 2022 12:23:24 +0200
Subject: [PATCH 0060/1227] Unify usage of `clique.assemble`

---
 openpype/plugins/publish/integrate_new.py | 60 ++++++++++++++---------
 1 file changed, 37 insertions(+), 23 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index d869a1b6be..1ceb99e9fe 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -17,6 +17,41 @@ from openpype.lib.file_transaction import FileTransaction
 log = logging.getLogger(__name__)
 
 
+def assemble(files):
+    """Convenience `clique.assemble` wrapper for files of a single collection.
+
+    Unlike `clique.assemble` this wrapper does not allow more than a single
+    Collection nor any remainder files. Errors will be raised when not only
+    a single collection is assembled.
+
+    Returns:
+        clique.Collection: A single sequence Collection
+
+    Raises:
+        ValueError: Error is raised when files do not result in a single
+                    collected Collection.
+
+    """
+    # todo: move this to lib?
+    # Get the sequence as a collection. The files must be of a single
+    # sequence and have no remainder outside of the collections.
+    patterns = [clique.PATTERNS["frames"]]
+    collections, remainder = clique.assemble(files,
+                                             minimum_items=1,
+                                             patterns=patterns)
+    if not collections:
+        raise ValueError("No collections found in files: "
+                         "{}".format(files))
+    if remainder:
+        raise ValueError("Files found not detected as part"
+                         " of a sequence: {}".format(remainder))
+    if len(collections) > 1:
+        raise ValueError("Files in sequence are not part of a"
+                         " single sequence collection: "
+                         "{}".format(collections))
+    return collections[0]
+
+
 def get_instance_families(instance):
     """Get all families of the instance"""
     # todo: move this to lib?
@@ -451,21 +486,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "Given file names contain full paths"
             )
 
-            # Get the sequence as a collection. The files must be of a single
-            # sequence and have no remainder outside of the collections.
-            collections, remainder = clique.assemble(files,
-                                                     minimum_items=1)
-            if not collections:
-                raise ValueError("No collections found in files: "
-                                 "{}".format(files))
-            if remainder:
-                raise ValueError("Files found not detected as part"
-                                 " of a sequence: {}".format(remainder))
-            if len(collections) > 1:
-                raise ValueError("Files in sequence are not part of a"
-                                 " single sequence collection: "
-                                 "{}".format(collections))
-            src_collection = collections[0]
+            src_collection = assemble(files)
 
             # If the representation has `frameStart` set it renumbers the
             # frame indices of the published collection. It will start from
@@ -512,14 +533,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             template_filled = anatomy_filled[template_name]["path"]
             repre_context = template_filled.used_values
             self.log.debug("Template filled: {}".format(str(template_filled)))
-            dst_collections, _remainder = clique.assemble(
-                [os.path.normpath(template_filled)],
-                minimum_items=1,
-                patterns=[clique.PATTERNS["frames"]]
-            )
-            assert not _remainder, "This is a bug"
-            assert len(dst_collections) == 1, "This is a bug"
-            dst_collection = dst_collections[0]
+            dst_collection = assemble([os.path.normpath(template_filled)])
 
             # Update the destination indexes and padding
             dst_collection.indexes.clear()

From 44d6199a9e4ea7342fb2ef6bd583e0e373da2545 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 29 Mar 2022 12:28:47 +0200
Subject: [PATCH 0061/1227] Organize single file code more like sequence file
 code

---
 openpype/plugins/publish/integrate_new.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 1ceb99e9fe..1592789390 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -551,21 +551,24 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         else:
             # Single file
-            template_data.pop("frame", None)
             fname = files
             assert not os.path.isabs(fname), (
                 "Given file name is a full path"
             )
-            # Store used frame value to template data
+
+            # Manage anatomy template data
+            template_data.pop("frame", None)
             if repre.get("udim"):
                 template_data["udim"] = repre["udim"][0]
-            src = os.path.join(stagingdir, fname)
+
+            # Construct destination filepath from template
             anatomy_filled = anatomy.format(template_data)
             template_filled = anatomy_filled[template_name]["path"]
             repre_context = template_filled.used_values
             dst = os.path.normpath(template_filled)
 
             # Single file transfer
+            src = os.path.join(stagingdir, fname)
             transfers = [(src, dst)]
 
         for key in self.db_representation_context_keys:

From a2a77b8a2099b902e01816ec66a2f308e43004d1 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 29 Mar 2022 12:51:08 +0200
Subject: [PATCH 0062/1227] Cleanup `get_files_info` docstring

---
 openpype/plugins/publish/integrate_new.py | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 1592789390..0ee2a6286f 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -739,11 +739,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         return path
 
     def get_files_info(self, transfers, sites, anatomy):
-        """ Prepare 'files' portion for attached resources and main asset.
-            Combining records from 'transfers' and 'hardlinks' parts from
-            instance.
-            All attached resources should be added, currently without
-            Context info.
+        """Prepare 'files' info portion for representations.
 
         Arguments:
             transfers (list): List of transferred files (source, destination)

From 6fe6841c996594871a535daf2c21914e5cc32575 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 29 Mar 2022 13:18:04 +0200
Subject: [PATCH 0063/1227] Capture edge case where all "representations" are
 tagged for delete

---
 openpype/plugins/publish/integrate_new.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 0ee2a6286f..80e1909687 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -255,6 +255,12 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
             prepared_representations.append(prepared)
 
+        if not prepared_representations:
+            # Even though we check `instance.data["representations"]` earlier
+            # this could still happen if all representations were tagged with
+            # "delete" and thus are skipped for integration
+            raise RuntimeError("No representations prepared to publish.")
+
         # Each instance can also have pre-defined transfers not explicitly
         # part of a representation - like texture resources used by a
         # .ma representation. Those destination paths are pre-defined, etc.

From a7a908d1348381ab0c4df9c29861d7c02be635cb Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 29 Mar 2022 13:20:51 +0200
Subject: [PATCH 0064/1227] Improve docstring

---
 openpype/plugins/publish/integrate_new.py | 39 +++++++++++------------
 1 file changed, 18 insertions(+), 21 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 80e1909687..8e666f3400 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -84,29 +84,26 @@ def bulk_write(writes):
 
 
 class IntegrateAssetNew(pyblish.api.InstancePlugin):
-    """Resolve any dependency issues
+    """Register publish in the database and transfer files to destinations.
 
-    This plug-in resolves any paths which, if not updated might break
-    the published file.
+    Steps:
+        1) Register the subset and version
+        2) Transfer the representation files to the destination
+        3) Register the representation
 
-    The order of families is important, when working with lookdev you want to
-    first publish the texture, update the texture paths in the nodes and then
-    publish the shading network. Same goes for file dependent assets.
-
-    Requirements for instance to be correctly integrated
-
-    instance.data['representations'] - must be a list and each member
-    must be a dictionary with following data:
-        'files': list of filenames for sequence, string for single file.
-                 Only the filename is allowed, without the folder path.
-        'stagingDir': "path/to/folder/with/files"
-        'name': representation name (usually the same as extension)
-        'ext': file extension
-    optional data
-        "frameStart"
-        "frameEnd"
-        'fps'
-        "data": additional metadata for each representation.
+    Requires:
+        instance.data['representations'] - must be a list and each member
+        must be a dictionary with following data:
+            'files': list of filenames for sequence, string for single file.
+                     Only the filename is allowed, without the folder path.
+            'stagingDir': "path/to/folder/with/files"
+            'name': representation name (usually the same as extension)
+            'ext': file extension
+        optional data
+            "frameStart"
+            "frameEnd"
+            'fps'
+            "data": additional metadata for each representation.
     """
 
     label = "Integrate Asset New"

From c5aa315c30413cc4e78cf113bff159a00f51164d Mon Sep 17 00:00:00 2001
From: "felix.wang" <icyvapor@gmail.com>
Date: Tue, 29 Mar 2022 11:30:00 -0700
Subject: [PATCH 0065/1227] Add toggle button for Loaders' family filter
 widget.

---
 openpype/tools/libraryloader/app.py | 11 +++++++++--
 openpype/tools/loader/app.py        |  9 ++++++++-
 openpype/tools/loader/widgets.py    |  6 ++++++
 3 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/openpype/tools/libraryloader/app.py b/openpype/tools/libraryloader/app.py
index b73b415128..6825b3c975 100644
--- a/openpype/tools/libraryloader/app.py
+++ b/openpype/tools/libraryloader/app.py
@@ -84,11 +84,15 @@ class LibraryLoaderWindow(QtWidgets.QDialog):
         families_filter_view = FamilyListView(
             dbcon, self.family_config_cache, left_side_splitter
         )
+        families_toggle_button = QtWidgets.QPushButton("Toggle All")
+
         left_side_splitter.addWidget(projects_combobox)
         left_side_splitter.addWidget(assets_widget)
         left_side_splitter.addWidget(families_filter_view)
-        left_side_splitter.setStretchFactor(1, 65)
-        left_side_splitter.setStretchFactor(2, 35)
+        left_side_splitter.addWidget(families_toggle_button)
+        left_side_splitter.setStretchFactor(0, 65)
+        left_side_splitter.setStretchFactor(1, 30)
+        left_side_splitter.setStretchFactor(2, 5)
 
         # --- Middle part ---
         # Subsets widget
@@ -163,6 +167,9 @@ class LibraryLoaderWindow(QtWidgets.QDialog):
         families_filter_view.active_changed.connect(
             self._on_family_filter_change
         )
+        families_toggle_button.clicked.connect(
+            families_filter_view.toggle_all
+        )
         assets_widget.selection_changed.connect(self.on_assetschanged)
         assets_widget.refresh_triggered.connect(self.on_assetschanged)
         subsets_widget.active_changed.connect(self.on_subsetschanged)
diff --git a/openpype/tools/loader/app.py b/openpype/tools/loader/app.py
index 923a1fabdb..68a59e1ccc 100644
--- a/openpype/tools/loader/app.py
+++ b/openpype/tools/loader/app.py
@@ -67,10 +67,14 @@ class LoaderWindow(QtWidgets.QDialog):
         families_filter_view = FamilyListView(
             io, self.family_config_cache, left_side_splitter
         )
+        families_toggle_button = QtWidgets.QPushButton("Toggle All")
+
         left_side_splitter.addWidget(assets_widget)
         left_side_splitter.addWidget(families_filter_view)
+        left_side_splitter.addWidget(families_toggle_button)
         left_side_splitter.setStretchFactor(0, 65)
-        left_side_splitter.setStretchFactor(1, 35)
+        left_side_splitter.setStretchFactor(1, 30)
+        left_side_splitter.setStretchFactor(2, 5)
 
         # --- Middle part ---
         # Subsets widget
@@ -147,6 +151,9 @@ class LoaderWindow(QtWidgets.QDialog):
         families_filter_view.active_changed.connect(
             self._on_family_filter_change
         )
+        families_toggle_button.clicked.connect(
+            families_filter_view.toggle_all
+        )
         assets_widget.selection_changed.connect(self.on_assetschanged)
         assets_widget.refresh_triggered.connect(self.on_assetschanged)
         subsets_widget.active_changed.connect(self.on_subsetschanged)
diff --git a/openpype/tools/loader/widgets.py b/openpype/tools/loader/widgets.py
index 42fb62b632..b5f1df1e36 100644
--- a/openpype/tools/loader/widgets.py
+++ b/openpype/tools/loader/widgets.py
@@ -1070,6 +1070,12 @@ class FamilyListView(QtWidgets.QListView):
     def set_all_checked(self):
         self._set_checkstates(True, self._get_all_indexes())
 
+    def toggle_all(self):
+        if self.get_enabled_families():
+            self.set_all_unchecked()
+        else:
+            self.set_all_checked()
+
     def _get_all_indexes(self):
         indexes = []
         model = self._family_model

From ea84c18d2f1d6a1c11fca506512a4ce7e164a114 Mon Sep 17 00:00:00 2001
From: "felix.wang" <icyvapor@gmail.com>
Date: Tue, 29 Mar 2022 11:53:13 -0700
Subject: [PATCH 0066/1227] Fix left splitter indexing.

---
 openpype/tools/libraryloader/app.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/tools/libraryloader/app.py b/openpype/tools/libraryloader/app.py
index 6825b3c975..59f4aa4d7a 100644
--- a/openpype/tools/libraryloader/app.py
+++ b/openpype/tools/libraryloader/app.py
@@ -90,9 +90,9 @@ class LibraryLoaderWindow(QtWidgets.QDialog):
         left_side_splitter.addWidget(assets_widget)
         left_side_splitter.addWidget(families_filter_view)
         left_side_splitter.addWidget(families_toggle_button)
-        left_side_splitter.setStretchFactor(0, 65)
-        left_side_splitter.setStretchFactor(1, 30)
-        left_side_splitter.setStretchFactor(2, 5)
+        left_side_splitter.setStretchFactor(1, 65)
+        left_side_splitter.setStretchFactor(2, 30)
+        left_side_splitter.setStretchFactor(3, 5)
 
         # --- Middle part ---
         # Subsets widget

From 3ec9684239b7afc326cad7e184a7c6ed4e7a6058 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 11:28:13 +0200
Subject: [PATCH 0067/1227] Only add `frame` to context if used by the
 destination template

---
 openpype/plugins/publish/integrate_new.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 3543786949..99a915af73 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -158,7 +158,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     exclude_families = ["clip"]
     db_representation_context_keys = [
         "project", "asset", "task", "subset", "version", "representation",
-        "family", "hierarchy", "task", "username", "frame"
+        "family", "hierarchy", "task", "username"
     ]
     default_template_name = "publish"
 

From 6733df77f1f693b89078f216457621d129eb4f71 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 11:30:23 +0200
Subject: [PATCH 0068/1227] Remove double entry of "task"

---
 openpype/plugins/publish/integrate_new.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 99a915af73..da4dafb133 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -158,7 +158,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     exclude_families = ["clip"]
     db_representation_context_keys = [
         "project", "asset", "task", "subset", "version", "representation",
-        "family", "hierarchy", "task", "username"
+        "family", "hierarchy", "username"
     ]
     default_template_name = "publish"
 

From c95c9f92b92f37eca20b1dbc82c3ef0620f8f753 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 11:34:52 +0200
Subject: [PATCH 0069/1227] Add comment

---
 openpype/plugins/publish/integrate_new.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index da4dafb133..a2943e2972 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -577,6 +577,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             transfers = [(src, dst)]
 
         for key in self.db_representation_context_keys:
+            # Also add these values to the context even if not used by the
+            # destination template
             value = template_data.get(key)
             if not value:
                 continue

From 65691bf5207cf57b679dd4b36b3abb6ae57e0be5 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 11:36:32 +0200
Subject: [PATCH 0070/1227] Explain why we write subset+version first

---
 openpype/plugins/publish/integrate_new.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index a2943e2972..bab46803cb 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -270,7 +270,10 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             file_transactions.add(src, dst, mode=FileTransaction.MODE_HARDLINK)
 
         # Bulk write to the database
-        # todo: Can we move this even to after the file transfers?
+        # We write the subset and version to the database before the File
+        # Transaction to reduce the chances of another publish trying to
+        # publish to the same version number since that chance can greatly
+        # increase if the file transaction takes a long time.
         bulk_write(subset_writes + version_writes)
         self.log.info("Subset {subset[name]} and Version {version[name]} "
                       "written to database..".format(subset=subset,

From 0d83f3c76c880d088de718a416370e69529ad4a5 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 11:38:43 +0200
Subject: [PATCH 0071/1227] Add to do for potential erroneous case

---
 openpype/plugins/publish/integrate_new.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index bab46803cb..84adccb633 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -602,6 +602,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         # Backwards compatibility:
         # Store first transferred destination as published path data
         # todo: can we remove this?
+        # todo: We shouldn't change data that makes its way back into
+        #       instance.data[] until we know the publish actually succeeded
+        #       otherwise `published_path` might not actually be valid?
         published_path = transfers[0][1]
         repre["published_path"] = published_path  # Backwards compatibility
 

From 89376a97e4ef85069a3afdfd5e3115b33bd27284 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 20:47:00 +0200
Subject: [PATCH 0072/1227] Also include file infos of resource files like
 textures into each representation

- This should fix Site Sync for lookdev textures, etc.
---
 openpype/plugins/publish/integrate_new.py | 29 ++++++++++++++++-------
 1 file changed, 21 insertions(+), 8 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 84adccb633..25ab7817c9 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -264,10 +264,13 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         # part of a representation - like texture resources used by a
         # .ma representation. Those destination paths are pre-defined, etc.
         # todo: should we move or simplify this logic?
+        resource_destinations = set()
         for src, dst in instance.data.get("transfers", []):
             file_transactions.add(src, dst, mode=FileTransaction.MODE_COPY)
+            resource_destinations.add(os.path.abspath(dst))
         for src, dst in instance.data.get("hardlinks", []):
             file_transactions.add(src, dst, mode=FileTransaction.MODE_HARDLINK)
+            resource_destinations.add(os.path.abspath(dst))
 
         # Bulk write to the database
         # We write the subset and version to the database before the File
@@ -295,18 +298,29 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         )
         self.log.debug("Site Sync Sites: {}".format(sites))
 
+        # Compute the resource file infos once (files belonging to the
+        # version instance instead of an individual representation) so
+        # we can re-use those file infos per representation
+        anatomy = instance.context.data["anatomy"]
+        resource_file_infos = self.prepare_file_info(resource_destinations,
+                                                     sites=sites,
+                                                     anatomy=anatomy)
+
         # Finalize the representations now the published files are integrated
         # Get 'files' info for representations and its attached resources
-        anatomy = instance.context.data["anatomy"]
         representation_writes = []
         new_repre_names_low = set()
         for prepared in prepared_representations:
-            transfers = prepared["transfers"]
             representation = prepared["representation"]
+            transfers = prepared["transfers"]
+            destinations = [dst for src, dst in transfers]
             representation["files"] = self.get_files_info(
-                transfers, sites, anatomy
+                destinations, sites=sites, anatomy=anatomy
             )
 
+            # Add the version resource file infos to each representation
+            representation["files"] += resource_file_infos
+
             # Set up representation for writing to the database. Since
             # we *might* be overwriting an existing entry if the version
             # already existed we'll use ReplaceOnce with `upsert=True`
@@ -751,11 +765,11 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             ).format(path))
         return path
 
-    def get_files_info(self, transfers, sites, anatomy):
+    def get_files_info(self, destinations, sites, anatomy):
         """Prepare 'files' info portion for representations.
 
         Arguments:
-            transfers (list): List of transferred files (source, destination)
+            destinations (list): List of transferred file destinations
             sites (list): array of published locations
             anatomy: anatomy part from instance
         Returns:
@@ -763,10 +777,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             in representation
         """
         file_infos = []
-        for _src, dest in transfers:
-            file_info = self.prepare_file_info(dest, anatomy, sites=sites)
+        for file_path in destinations:
+            file_info = self.prepare_file_info(file_path, anatomy, sites=sites)
             file_infos.append(file_info)
-
         return file_infos
 
     def prepare_file_info(self, path, anatomy, sites):

From e6209555b01a0330186bc9176c8331a130325186 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 20:50:13 +0200
Subject: [PATCH 0073/1227] Match behavior more with what integrator did before
 refactor

---
 openpype/plugins/publish/collect_anatomy_context_data.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/collect_anatomy_context_data.py b/openpype/plugins/publish/collect_anatomy_context_data.py
index 346caf6b83..c3fabba2ce 100644
--- a/openpype/plugins/publish/collect_anatomy_context_data.py
+++ b/openpype/plugins/publish/collect_anatomy_context_data.py
@@ -93,9 +93,9 @@ class CollectAnatomyContextData(pyblish.api.ContextPlugin):
 
         intent = context.data.get("intent")
         if intent and isinstance(intent, dict):
-            intent_value = intent.get("value")
-            if intent_value:
-                context_data["intent"] = intent_value
+            intent = intent.get("value")
+        if intent:
+            context_data["intent"] = intent
 
         self.log.info("Global anatomy Data collected")
         self.log.debug(json.dumps(context_data, indent=4))

From 52fd21d85494dacd0071a3b08d79dbdd04789b30 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 20:51:56 +0200
Subject: [PATCH 0074/1227] Add todo/question regarding `intent`

---
 openpype/plugins/publish/collect_anatomy_context_data.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/plugins/publish/collect_anatomy_context_data.py b/openpype/plugins/publish/collect_anatomy_context_data.py
index c3fabba2ce..3f7e65ecd3 100644
--- a/openpype/plugins/publish/collect_anatomy_context_data.py
+++ b/openpype/plugins/publish/collect_anatomy_context_data.py
@@ -91,6 +91,8 @@ class CollectAnatomyContextData(pyblish.api.ContextPlugin):
                 }
             })
 
+        # todo: some code actually expects the dict itself and others doesn't
+        #       question: what should it be?
         intent = context.data.get("intent")
         if intent and isinstance(intent, dict):
             intent = intent.get("value")

From 4c78976d3d834a5cb1fd0bce44f465cbf3ac6375 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 20:55:40 +0200
Subject: [PATCH 0075/1227] Add todo

---
 openpype/plugins/publish/integrate_new.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 25ab7817c9..e0c0632548 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -688,6 +688,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "fps": instance.data.get("fps", context.data.get("fps"))
         }
 
+        # todo: preferably we wouldn't need this "if dict" etc. logic and
+        #       instead be able to rely what the input value is if it's set.
         intent_value = context.data.get("intent")
         if intent_value and isinstance(intent_value, dict):
             intent_value = intent_value.get("value")

From 3e095bc7554a24ef13282ccfd87e0327eb3b8745 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 20:57:38 +0200
Subject: [PATCH 0076/1227] Use template name for frame padding anatomy
 template

---
 openpype/plugins/publish/integrate_new.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index e0c0632548..0f3b11a025 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -520,8 +520,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             if repre.get("frameStart") is not None:
                 index_frame_start = int(repre.get("frameStart"))
 
-                # TODO use frame padding from right template group
-                render_template = anatomy.templates["render"]
+                render_template = anatomy.templates[template_name]
                 frame_start_padding = int(
                     render_template.get(
                         "frame_padding",

From b12b1c80f2facbe343333ba3d70dcbe463383538 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 21:00:10 +0200
Subject: [PATCH 0077/1227] Never shift udim sequences

---
 openpype/plugins/publish/integrate_new.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 0f3b11a025..fd0d57c646 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -501,6 +501,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         anatomy = instance.context.data['anatomy']
         template = os.path.normpath(anatomy.templates[template_name]["path"])
 
+        is_udim = bool(repre.get("udim"))
         is_sequence_representation = isinstance(files, (list, tuple))
         if is_sequence_representation:
             # Collection of files (sequence)
@@ -517,7 +518,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             # frame indices from the source collection.
             destination_indexes = list(src_collection.indexes)
             destination_padding = len(get_first_frame_padded(src_collection))
-            if repre.get("frameStart") is not None:
+            if repre.get("frameStart") is not None and not is_udim:
                 index_frame_start = int(repre.get("frameStart"))
 
                 render_template = anatomy.templates[template_name]
@@ -543,7 +544,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             # from the source indexes, etc.
             first_index_padded = get_frame_padded(frame=destination_indexes[0],
                                                   padding=destination_padding)
-            if repre.get("udim"):
+            if is_udim:
                 # UDIM representations handle ranges in a different manner
                 template_data["udim"] = first_index_padded
             else:
@@ -579,7 +580,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
             # Manage anatomy template data
             template_data.pop("frame", None)
-            if repre.get("udim"):
+            if is_udim:
                 template_data["udim"] = repre["udim"][0]
 
             # Construct destination filepath from template

From f7d35c4fed0885c6656da03eb852706c6bf20117 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 21:01:09 +0200
Subject: [PATCH 0078/1227] add todo/question

---
 openpype/plugins/publish/integrate_new.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index fd0d57c646..52c7686473 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -522,6 +522,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 index_frame_start = int(repre.get("frameStart"))
 
                 render_template = anatomy.templates[template_name]
+                # todo: should we ALWAYS manage the frame padding even when not
+                #       having `frameStart` set?
                 frame_start_padding = int(
                     render_template.get(
                         "frame_padding",

From 70bfdd09b40936efc45efa6bbd1ea029447058f2 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 2 Apr 2022 21:07:02 +0200
Subject: [PATCH 0079/1227] Remove old "dependencies" data

---
 openpype/plugins/publish/integrate_new.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 52c7686473..37c68ffa6d 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -636,7 +636,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "parent": version["_id"],
             "name": repre['name'],
             "data": data,
-            "dependencies": instance.data.get("dependencies", "").split(),
 
             # Imprint shortcut to context for performance reasons.
             "context": repre_context

From 45745cc514236d64cc7f2feddbff9e6217b720fa Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sun, 3 Apr 2022 20:37:28 +0200
Subject: [PATCH 0080/1227] Improve clarity of comment

---
 openpype/plugins/publish/integrate_new.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 37c68ffa6d..cb469251e6 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -604,7 +604,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             repre_context[key] = template_data[key]
 
         # Explicitly store the full list even though template data might
-        # have a different value
+        # have a different value because it uses just a single udim tile
         if repre.get("udim"):
             repre_context["udim"] = repre.get("udim")  # store list
 

From fe72197a9feb413c8f6c5f9e02339ed891fdda07 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sun, 3 Apr 2022 20:40:25 +0200
Subject: [PATCH 0081/1227] Add comment

---
 openpype/plugins/publish/integrate_new.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index cb469251e6..f1cceb9ca7 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -156,11 +156,14 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "usdOverride"
                 ]
     exclude_families = ["clip"]
+    default_template_name = "publish"
+
+    # Representation context keys that should always be written to
+    # the database even if not used by the destination template
     db_representation_context_keys = [
         "project", "asset", "task", "subset", "version", "representation",
         "family", "hierarchy", "username"
     ]
-    default_template_name = "publish"
 
     # Attributes set by settings
     template_name_profiles = None

From c3c8281e0134222677b32f91ec644322dd996a74 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sun, 3 Apr 2022 20:41:34 +0200
Subject: [PATCH 0082/1227] tweak comment

---
 openpype/plugins/publish/integrate_new.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index f1cceb9ca7..238ae82bba 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -183,7 +183,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             self.register(instance, file_transactions)
         except Exception:
             # clean destination
-            # todo: rollback any registered entities? (or how safe are we?)
+            # todo: preferably we'd also rollback *any* changes to the database
             file_transactions.rollback()
             self.log.critical("Error when registering", exc_info=True)
             six.reraise(*sys.exc_info())

From 0e96071996c20199e028df715d6fc9005d100991 Mon Sep 17 00:00:00 2001
From: Vic Bartel <vbartel@yanport.com>
Date: Fri, 18 Mar 2022 17:20:58 +0100
Subject: [PATCH 0083/1227] Add shotgrid module

---
 .editorconfig                                 |  19 ++
 .pre-commit-config.yaml                       |  26 +++
 mypy.ini                                      |   5 +
 .../plugins/publish/submit_maya_deadline.py   |   1 +
 .../plugins/publish/submit_publish_job.py     |   1 +
 openpype/modules/shotgrid/README.md           |  19 ++
 openpype/modules/shotgrid/__init__.py         |   5 +
 openpype/modules/shotgrid/aop/patch.py        |  50 +++++
 .../shotgrid/hooks/post_shotgrid_changes.py   |   9 +
 openpype/modules/shotgrid/lib/const.py        |   1 +
 openpype/modules/shotgrid/lib/credentials.py  | 125 +++++++++++
 openpype/modules/shotgrid/lib/record.py       |  18 ++
 openpype/modules/shotgrid/lib/server.py       |  27 +++
 openpype/modules/shotgrid/lib/settings.py     |  39 ++++
 .../publish/collect_shotgrid_entities.py      | 103 +++++++++
 .../publish/collect_shotgrid_session.py       | 132 ++++++++++++
 .../publish/integrate_shotgrid_publish.py     |  77 +++++++
 .../publish/integrate_shotgrid_version.py     |  92 ++++++++
 .../plugins/publish/validate_shotgrid_user.py |  36 ++++
 openpype/modules/shotgrid/server/README.md    |   5 +
 openpype/modules/shotgrid/shotgrid_module.py  |  62 ++++++
 .../tests/shotgrid/lib/test_credentials.py    |  34 +++
 .../shotgrid/tray/credential_dialog.py        | 202 ++++++++++++++++++
 .../modules/shotgrid/tray/shotgrid_tray.py    |  76 +++++++
 openpype/resources/app_icons/shotgrid.png     | Bin 0 -> 45744 bytes
 .../defaults/project_settings/shotgrid.json   |  22 ++
 .../defaults/system_settings/modules.json     |   9 +-
 openpype/settings/entities/__init__.py        |   2 +
 openpype/settings/entities/enum_entity.py     | 116 ++++++----
 .../schemas/projects_schema/schema_main.json  |   4 +
 .../schema_project_shotgrid.json              |  98 +++++++++
 .../schemas/schema_representation_tags.json   |   3 +
 .../schemas/system_schema/schema_modules.json |  54 +++++
 pyproject.toml                                |   1 +
 34 files changed, 1433 insertions(+), 40 deletions(-)
 create mode 100644 .editorconfig
 create mode 100644 .pre-commit-config.yaml
 create mode 100644 mypy.ini
 create mode 100644 openpype/modules/shotgrid/README.md
 create mode 100644 openpype/modules/shotgrid/__init__.py
 create mode 100644 openpype/modules/shotgrid/aop/patch.py
 create mode 100644 openpype/modules/shotgrid/hooks/post_shotgrid_changes.py
 create mode 100644 openpype/modules/shotgrid/lib/const.py
 create mode 100644 openpype/modules/shotgrid/lib/credentials.py
 create mode 100644 openpype/modules/shotgrid/lib/record.py
 create mode 100644 openpype/modules/shotgrid/lib/server.py
 create mode 100644 openpype/modules/shotgrid/lib/settings.py
 create mode 100644 openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
 create mode 100644 openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
 create mode 100644 openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_publish.py
 create mode 100644 openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_version.py
 create mode 100644 openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py
 create mode 100644 openpype/modules/shotgrid/server/README.md
 create mode 100644 openpype/modules/shotgrid/shotgrid_module.py
 create mode 100644 openpype/modules/shotgrid/tests/shotgrid/lib/test_credentials.py
 create mode 100644 openpype/modules/shotgrid/tray/credential_dialog.py
 create mode 100644 openpype/modules/shotgrid/tray/shotgrid_tray.py
 create mode 100644 openpype/resources/app_icons/shotgrid.png
 create mode 100644 openpype/settings/defaults/project_settings/shotgrid.json
 create mode 100644 openpype/settings/entities/schemas/projects_schema/schema_project_shotgrid.json

diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000000..aeb5534872
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,19 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+
+[*.{js,py}]
+charset = utf-8
+
+[*.py]
+indent_style = space
+indent_size = 4
+
+[*.yml]
+indent_style = space
+indent_size = 2
+
+[Makefile]
+indent_style = tab
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
new file mode 100644
index 0000000000..6a986c7dd9
--- /dev/null
+++ b/.pre-commit-config.yaml
@@ -0,0 +1,26 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v3.2.0
+    hooks:
+    -   id: trailing-whitespace
+    -   id: end-of-file-fixer
+    -   id: check-yaml
+    -   id: check-added-large-files
+-   repo: https://github.com/ambv/black
+    rev: 21.4b0
+    hooks:
+    - id: black
+      language_version: "3"
+      args:
+        - "--config"
+        - "./pyproject.toml"
+-   repo: https://github.com/pycqa/flake8
+    rev: "3.9.2"  # pick a git hash / tag to point to
+    hooks:
+    -   id: flake8
+-   repo: https://github.com/pre-commit/mirrors-mypy
+    rev: 'v0.902'
+    hooks:
+    -   id: mypy
+        args: [--no-strict-optional, --ignore-missing-imports]
+        additional_dependencies: [tokenize-rt==3.2.0]
diff --git a/mypy.ini b/mypy.ini
new file mode 100644
index 0000000000..90cde26676
--- /dev/null
+++ b/mypy.ini
@@ -0,0 +1,5 @@
+[mypy]
+python_version = 3.7
+ignore_missing_imports = false
+check_untyped_defs = true
+follow_imports = silent
diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
index 34147712bc..f59fd3af1c 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
@@ -476,6 +476,7 @@ class MayaSubmitDeadline(pyblish.api.InstancePlugin):
             "FTRACK_API_KEY",
             "FTRACK_API_USER",
             "FTRACK_SERVER",
+            "OPENPYPE_SG_USER",
             "AVALON_PROJECT",
             "AVALON_ASSET",
             "AVALON_TASK",
diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 3c4e0d2913..e1e1ea6b94 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -113,6 +113,7 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
                   "celaction": [r".*"]}
 
     enviro_filter = [
+        "OPENPYPE_SG_USER",
         "FTRACK_API_USER",
         "FTRACK_API_KEY",
         "FTRACK_SERVER",
diff --git a/openpype/modules/shotgrid/README.md b/openpype/modules/shotgrid/README.md
new file mode 100644
index 0000000000..cbee0e9bf4
--- /dev/null
+++ b/openpype/modules/shotgrid/README.md
@@ -0,0 +1,19 @@
+## Shotgrid Module
+
+### Pre-requisites
+
+Install and launch a [shotgrid leecher](https://github.com/Ellipsanime/shotgrid-leecher) server
+
+### Quickstart
+
+The goal of this tutorial is to synchronize an already existing shotgrid project with OpenPype.
+
+- Activate the shotgrid module in the **system settings** and inform the shotgrid leecher server API url
+
+- Create a new OpenPype project with the **project manager**
+
+- Inform the shotgrid authentication infos (url, script name, api key) and the shotgrid project ID related to this OpenPype project in the **project settings**
+
+- Use the batch interface (Tray > shotgrid > Launch batch), select your project and click "batch"
+
+- You can now access your shotgrid entities within the **avalon launcher** and publish informations to shotgrid with **pyblish**
diff --git a/openpype/modules/shotgrid/__init__.py b/openpype/modules/shotgrid/__init__.py
new file mode 100644
index 0000000000..f1337a9492
--- /dev/null
+++ b/openpype/modules/shotgrid/__init__.py
@@ -0,0 +1,5 @@
+from .shotgrid_module import (
+    ShotgridModule,
+)
+
+__all__ = ("ShotgridModule",)
diff --git a/openpype/modules/shotgrid/aop/patch.py b/openpype/modules/shotgrid/aop/patch.py
new file mode 100644
index 0000000000..6ca81033e2
--- /dev/null
+++ b/openpype/modules/shotgrid/aop/patch.py
@@ -0,0 +1,50 @@
+from copy import copy
+from typing import Any, Iterator, Dict, Set
+
+from avalon.api import AvalonMongoDB
+
+from openpype.api import Logger
+from openpype.modules.shotgrid.lib import (
+    credentials,
+    settings,
+    server,
+)
+
+_LOG = Logger().get_logger("ShotgridModule.patch")
+
+
+def _patched_projects(
+    self: Any, projection: Any = None, only_active: bool = True
+) -> Iterator[Dict[str, Any]]:
+    all_projects = list(self._prev_projects(projection, only_active))
+    if (
+        not credentials.get_local_login()
+        or not settings.filter_projects_by_login()
+    ):
+        return all_projects
+    try:
+        linked_names = _fetch_linked_project_names() or set()
+        return [x for x in all_projects if _upper(x["name"]) in linked_names]
+    except Exception as e:
+        print(e)
+        return all_projects
+
+
+def _upper(x: Any) -> str:
+    return str(x).strip().upper()
+
+
+def _fetch_linked_project_names() -> Set[str]:
+    return {
+        _upper(x["project_name"])
+        for x in server.find_linked_projects(credentials.get_local_login())
+    }
+
+
+def patch_avalon_db() -> None:
+    _LOG.debug("Run avalon patching")
+    if AvalonMongoDB.projects is _patched_projects:
+        return None
+    _LOG.debug("Patch Avalon.projects method")
+    AvalonMongoDB._prev_projects = copy(AvalonMongoDB.projects)
+    AvalonMongoDB.projects = _patched_projects
diff --git a/openpype/modules/shotgrid/hooks/post_shotgrid_changes.py b/openpype/modules/shotgrid/hooks/post_shotgrid_changes.py
new file mode 100644
index 0000000000..e8369ad3cb
--- /dev/null
+++ b/openpype/modules/shotgrid/hooks/post_shotgrid_changes.py
@@ -0,0 +1,9 @@
+from openpype.lib import PostLaunchHook
+
+
+class PostShotgridHook(PostLaunchHook):
+    order = None
+
+    def execute(self, *args, **kwargs):
+        print(args, kwargs)
+        pass
diff --git a/openpype/modules/shotgrid/lib/const.py b/openpype/modules/shotgrid/lib/const.py
new file mode 100644
index 0000000000..2a34800fac
--- /dev/null
+++ b/openpype/modules/shotgrid/lib/const.py
@@ -0,0 +1 @@
+MODULE_NAME = "shotgrid"
diff --git a/openpype/modules/shotgrid/lib/credentials.py b/openpype/modules/shotgrid/lib/credentials.py
new file mode 100644
index 0000000000..a334968cda
--- /dev/null
+++ b/openpype/modules/shotgrid/lib/credentials.py
@@ -0,0 +1,125 @@
+from typing import Tuple, Optional
+from urllib.parse import urlparse
+
+import shotgun_api3
+from shotgun_api3.shotgun import AuthenticationFault
+
+from openpype.lib import OpenPypeSecureRegistry, OpenPypeSettingsRegistry
+from openpype.modules.shotgrid.lib.record import Credentials
+
+
+def _get_shotgrid_secure_key(hostname: str, key: str) -> str:
+    """Secure item key for entered hostname."""
+    return f"shotgrid/{hostname}/{key}"
+
+
+def _get_secure_value_and_registry(
+    hostname: str,
+    name: str,
+) -> Tuple[str, OpenPypeSecureRegistry]:
+    key = _get_shotgrid_secure_key(hostname, name)
+    registry = OpenPypeSecureRegistry(key)
+    return registry.get_item(name, None), registry
+
+
+def get_shotgrid_hostname(shotgrid_url: str) -> str:
+
+    if not shotgrid_url:
+        raise Exception("Shotgrid url cannot be a null")
+    valid_shotgrid_url = (
+        f"//{shotgrid_url}" if "//" not in shotgrid_url else shotgrid_url
+    )
+    return urlparse(valid_shotgrid_url).hostname
+
+
+# Credentials storing function (using keyring)
+
+
+def get_credentials(shotgrid_url: str) -> Optional[Credentials]:
+    hostname = get_shotgrid_hostname(shotgrid_url)
+    if not hostname:
+        return None
+    login_value, _ = _get_secure_value_and_registry(
+        hostname,
+        Credentials.login_key_prefix(),
+    )
+    password_value, _ = _get_secure_value_and_registry(
+        hostname,
+        Credentials.password_key_prefix(),
+    )
+    return Credentials(login_value, password_value)
+
+
+def save_credentials(login: str, password: str, shotgrid_url: str):
+    hostname = get_shotgrid_hostname(shotgrid_url)
+    _, login_registry = _get_secure_value_and_registry(
+        hostname,
+        Credentials.login_key_prefix(),
+    )
+    _, password_registry = _get_secure_value_and_registry(
+        hostname,
+        Credentials.password_key_prefix(),
+    )
+    clear_credentials(shotgrid_url)
+    login_registry.set_item(Credentials.login_key_prefix(), login)
+    password_registry.set_item(Credentials.password_key_prefix(), password)
+
+
+def clear_credentials(shotgrid_url: str):
+    hostname = get_shotgrid_hostname(shotgrid_url)
+    login_value, login_registry = _get_secure_value_and_registry(
+        hostname,
+        Credentials.login_key_prefix(),
+    )
+    password_value, password_registry = _get_secure_value_and_registry(
+        hostname,
+        Credentials.password_key_prefix(),
+    )
+
+    if login_value is not None:
+        login_registry.delete_item(Credentials.login_key_prefix())
+
+    if password_value is not None:
+        password_registry.delete_item(Credentials.password_key_prefix())
+
+
+# Login storing function (using json)
+
+
+def get_local_login() -> Optional[str]:
+    reg = OpenPypeSettingsRegistry()
+    try:
+        return str(reg.get_item("shotgrid_login"))
+    except Exception:
+        return None
+
+
+def save_local_login(login: str):
+    reg = OpenPypeSettingsRegistry()
+    reg.set_item("shotgrid_login", login)
+
+
+def clear_local_login():
+    reg = OpenPypeSettingsRegistry()
+    reg.delete_item("shotgrid_login")
+
+
+def check_credentials(
+    login: str,
+    password: str,
+    shotgrid_url: str,
+) -> bool:
+
+    if not shotgrid_url or not login or not password:
+        return False
+    try:
+        session = shotgun_api3.Shotgun(
+            shotgrid_url,
+            login=login,
+            password=password,
+        )
+        session.preferences_read()
+        session.close()
+    except AuthenticationFault:
+        return False
+    return True
diff --git a/openpype/modules/shotgrid/lib/record.py b/openpype/modules/shotgrid/lib/record.py
new file mode 100644
index 0000000000..1796e6c019
--- /dev/null
+++ b/openpype/modules/shotgrid/lib/record.py
@@ -0,0 +1,18 @@
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class Credentials:
+    login: str
+    password: str
+
+    def is_empty(self) -> bool:
+        return not (self.login and self.password)
+
+    @staticmethod
+    def login_key_prefix() -> str:
+        return "login"
+
+    @staticmethod
+    def password_key_prefix() -> str:
+        return "password"
diff --git a/openpype/modules/shotgrid/lib/server.py b/openpype/modules/shotgrid/lib/server.py
new file mode 100644
index 0000000000..0fe4b8429e
--- /dev/null
+++ b/openpype/modules/shotgrid/lib/server.py
@@ -0,0 +1,27 @@
+import traceback
+
+import requests
+from typing import Dict, Any, List
+
+from openpype.api import Logger
+from openpype.modules.shotgrid.lib import (
+    settings as settings_lib,
+)
+
+_LOG = Logger().get_logger("ShotgridModule.server")
+
+
+def find_linked_projects(email: str) -> List[Dict[str, Any]]:
+    url = "".join(
+        [
+            settings_lib.get_leecher_backend_url(),
+            "/user/",
+            email,
+            "/project-user-links",
+        ]
+    )
+    try:
+        return requests.get(url).json()
+    except requests.exceptions.RequestException as e:
+        _LOG.error(e)
+        traceback.print_stack()
diff --git a/openpype/modules/shotgrid/lib/settings.py b/openpype/modules/shotgrid/lib/settings.py
new file mode 100644
index 0000000000..0f4fc235cc
--- /dev/null
+++ b/openpype/modules/shotgrid/lib/settings.py
@@ -0,0 +1,39 @@
+import os
+from typing import Tuple, Dict, List, Any
+
+from pymongo import MongoClient
+from openpype.api import get_system_settings, get_project_settings
+from openpype.modules.shotgrid.lib.const import MODULE_NAME
+
+
+def get_project_list() -> List[str]:
+    mongo_url = os.getenv("OPENPYPE_MONGO")
+    client = MongoClient(mongo_url)
+    db = client['avalon']
+    return db.list_collection_names()
+
+
+def get_shotgrid_project_settings(project: str) -> Dict[str, Any]:
+    return get_project_settings(project).get(MODULE_NAME, {})
+
+
+def get_shotgrid_settings() -> Dict[str, Any]:
+    return get_system_settings().get("modules", {}).get(MODULE_NAME, {})
+
+
+def get_shotgrid_servers() -> Dict[str, Any]:
+    return get_shotgrid_settings().get("shotgrid_settings", {})
+
+
+def get_leecher_backend_url() -> str:
+    return get_shotgrid_settings().get("leecher_backend_url")
+
+
+def filter_projects_by_login() -> bool:
+    return bool(get_shotgrid_settings().get("filter_projects_by_login", False))
+
+
+def get_shotgrid_event_mongo_info() -> Tuple[str, str]:
+    database_name = os.environ["OPENPYPE_DATABASE_NAME"]
+    collection_name = "shotgrid_events"
+    return database_name, collection_name
diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
new file mode 100644
index 0000000000..b89dda3a80
--- /dev/null
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
@@ -0,0 +1,103 @@
+import os
+import pyblish.api
+from pymongo import MongoClient
+from openpype.api import get_project_settings
+
+
+class CollectShotgridEntities(pyblish.api.ContextPlugin):
+    """Collect shotgrid entities according to the current context"""
+
+    order = pyblish.api.CollectorOrder + 0.499
+    label = "Shotgrid entities"
+
+    def process(self, context):
+
+        avalon_project = context.data.get("projectEntity")
+        avalon_asset = context.data.get("assetEntity")
+        avalon_task_name = os.getenv("AVALON_TASK")
+
+        self.log.info(avalon_project)
+        self.log.info(avalon_asset)
+
+        sg_project = _get_shotgrid_project(avalon_project)
+        sg_task = _get_shotgrid_task(
+            avalon_project, avalon_asset, avalon_task_name
+        )
+        sg_entity = _get_shotgrid_entity(avalon_project, avalon_asset)
+
+        if sg_project:
+            context.data["shotgridProject"] = sg_project
+            self.log.info(
+                "Collected correspondig shotgrid project : {}".format(
+                    sg_project
+                )
+            )
+
+        if sg_task:
+            context.data["shotgridTask"] = sg_task
+            self.log.info(
+                "Collected correspondig shotgrid task : {}".format(sg_task)
+            )
+
+        if sg_entity:
+            context.data["shotgridEntity"] = sg_entity
+            self.log.info(
+                "Collected correspondig shotgrid entity : {}".format(sg_entity)
+            )
+
+    def _find_existing_version(self, code, context):
+
+        filters = [
+            ["project", "is", context.data.get("shotgridProject")],
+            ["sg_task", "is", context.data.get("shotgridTask")],
+            ["entity", "is", context.data.get("shotgridEntity")],
+            ["code", "is", code],
+        ]
+
+        sg = context.data.get("shotgridSession")
+        return sg.find_one("Version", filters, [])
+
+
+def _get_shotgrid_collection(project):
+    mongo_url = os.getenv("OPENPYPE_MONGO")
+    client = MongoClient(mongo_url)
+    return client.get_database("shotgrid_openpype").get_collection(project)
+
+
+def _get_shotgrid_project_settings(project):
+    return get_project_settings(project).get("shotgrid", {})
+
+
+def _get_shotgrid_project(avalon_project):
+    proj_settings = _get_shotgrid_project_settings(avalon_project["name"])
+    shotgrid_project_id = proj_settings.get("shotgrid_project_id")
+    if shotgrid_project_id:
+        return {"type": "Project", "id": shotgrid_project_id}
+    return {}
+
+
+def _get_shotgrid_task(avalon_project, avalon_asset, avalon_task):
+    sg_col = _get_shotgrid_collection(avalon_project["name"])
+    shotgrid_task_hierarchy_row = sg_col.find_one(
+        {
+            "type": "Task",
+            "_id": {"$regex": "^" + avalon_task + "_[0-9]*"},
+            "parent": {"$regex": ".*," + avalon_asset["name"] + ","},
+        }
+    )
+    if shotgrid_task_hierarchy_row:
+        return {"type": "Task", "id": shotgrid_task_hierarchy_row["src_id"]}
+    return {}
+
+
+def _get_shotgrid_entity(avalon_project, avalon_asset):
+    sg_col = _get_shotgrid_collection(avalon_project["name"])
+    shotgrid_entity_hierarchy_row = sg_col.find_one(
+        {"_id": avalon_asset["name"]}
+    )
+    if shotgrid_entity_hierarchy_row:
+        return {
+            "type": shotgrid_entity_hierarchy_row["type"],
+            "id": shotgrid_entity_hierarchy_row["src_id"],
+        }
+    return {}
diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
new file mode 100644
index 0000000000..65a5de9f22
--- /dev/null
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
@@ -0,0 +1,132 @@
+import os
+import sys
+import pyblish.api
+import shotgun_api3
+from shotgun_api3.shotgun import AuthenticationFault
+from openpype.lib import OpenPypeSettingsRegistry
+from openpype.api import get_project_settings, get_system_settings
+
+
+class CollectShotgridSession(pyblish.api.ContextPlugin):
+    """Collect shotgrid session using user credentials"""
+
+    order = pyblish.api.CollectorOrder
+    label = "Shotgrid user session"
+
+    def process(self, context):
+
+        certificate_path = os.getenv("SHOTGUN_API_CACERTS")
+        if certificate_path is None or not os.path.exists(certificate_path):
+            self.log.info(
+                "SHOTGUN_API_CACERTS does not contains a valid \
+                path: {}".format(
+                    certificate_path
+                )
+            )
+            certificate_path = get_shotgrid_certificate()
+            self.log.info("Get Certificate from shotgrid_api")
+
+        if not os.path.exists(certificate_path):
+            self.log.error(
+                "Could not find certificate in shotgun_api3: \
+                {}".format(
+                    certificate_path
+                )
+            )
+            return
+
+        set_shotgrid_certificate(certificate_path)
+        self.log.info("Set Certificate: {}".format(certificate_path))
+
+        avalon_project = os.getenv("AVALON_PROJECT")
+
+        shotgrid_settings = get_shotgrid_settings(avalon_project)
+        self.log.info("shotgrid settings: {}".format(shotgrid_settings))
+        shotgrid_servers_settings = get_shotgrid_servers()
+        self.log.info(
+            "shotgrid_servers_settings: {}".format(shotgrid_servers_settings)
+        )
+
+        shotgrid_server = shotgrid_settings.get("shotgrid_server", "")
+        if not shotgrid_server:
+            self.log.error(
+                "No Shotgrid server found, please choose a credential"
+                "in script name and script key in OpenPype settings"
+            )
+
+        shotgrid_server_setting = shotgrid_servers_settings.get(
+            shotgrid_server, {}
+        )
+        shotgrid_url = shotgrid_server_setting.get("shotgrid_url", "")
+
+        shotgrid_script_name = shotgrid_server_setting.get(
+            "shotgrid_script_name", ""
+        )
+        shotgrid_script_key = shotgrid_server_setting.get(
+            "shotgrid_script_key", ""
+        )
+        if not shotgrid_script_name and not shotgrid_script_key:
+            self.log.error(
+                "No Shotgrid api credential found, please enter "
+                "script name and script key in OpenPype settings"
+            )
+
+        login = get_login() or os.getenv("OPENPYPE_SG_USER")
+
+        if not login:
+            self.log.error(
+                "No Shotgrid login found, please "
+                "login to shotgrid withing openpype Tray"
+            )
+
+        session = shotgun_api3.Shotgun(
+            base_url=shotgrid_url,
+            script_name=shotgrid_script_name,
+            api_key=shotgrid_script_key,
+            sudo_as_login=login,
+        )
+
+        try:
+            session.preferences_read()
+        except AuthenticationFault:
+            raise ValueError(
+                "Could not connect to shotgrid {} with user {}".format(
+                    shotgrid_url, login
+                )
+            )
+
+        self.log.info(
+            "Logged to shotgrid {} with user {}".format(shotgrid_url, login)
+        )
+        context.data["shotgridSession"] = session
+        context.data["shotgridUser"] = login
+
+
+def get_shotgrid_certificate():
+    shotgun_api_path = os.path.dirname(shotgun_api3.__file__)
+    return os.path.join(shotgun_api_path, "lib", "certifi", "cacert.pem")
+
+
+def set_shotgrid_certificate(certificate):
+    os.environ["SHOTGUN_API_CACERTS"] = certificate
+
+
+def get_shotgrid_settings(project):
+    return get_project_settings(project).get("shotgrid", {})
+
+
+def get_shotgrid_servers():
+    return (
+        get_system_settings()
+        .get("modules", {})
+        .get("shotgrid", {})
+        .get("shotgrid_settings", {})
+    )
+
+
+def get_login():
+    reg = OpenPypeSettingsRegistry()
+    try:
+        return str(reg.get_item("shotgrid_login"))
+    except Exception as e:
+        return None
diff --git a/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_publish.py b/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_publish.py
new file mode 100644
index 0000000000..cfd2d10fd9
--- /dev/null
+++ b/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_publish.py
@@ -0,0 +1,77 @@
+import os
+import pyblish.api
+
+
+class IntegrateShotgridPublish(pyblish.api.InstancePlugin):
+    """
+    Create published Files from representations and add it to version. If
+    representation is tagged add shotgrid review, it will add it in
+    path to movie for a movie file or path to frame for an image sequence.
+    """
+
+    order = pyblish.api.IntegratorOrder + 0.499
+    label = "Shotgrid Published Files"
+
+    def process(self, instance):
+
+        context = instance.context
+
+        self.sg = context.data.get("shotgridSession")
+
+        shotgrid_version = instance.data.get("shotgridVersion")
+
+        for representation in instance.data.get("representations", []):
+
+            local_path = representation.get("published_path")
+            code = os.path.basename(local_path)
+
+            if representation.get("tags", []):
+                continue
+
+            published_file = self._find_existing_publish(
+                code, context, shotgrid_version
+            )
+
+            published_file_data = {
+                "project": context.data.get("shotgridProject"),
+                "code": code,
+                "entity": context.data.get("shotgridEntity"),
+                "task": context.data.get("shotgridTask"),
+                "version": shotgrid_version,
+                "path": {"local_path": local_path},
+            }
+            if not published_file:
+                published_file = self._create_published(published_file_data)
+                self.log.info(
+                    "Create Shotgrid PublishedFile: {}".format(published_file)
+                )
+            else:
+                self.sg.update(
+                    published_file["type"],
+                    published_file["id"],
+                    published_file_data,
+                )
+                self.log.info(
+                    "Update Shotgrid PublishedFile: {}".format(published_file)
+                )
+
+            if instance.data["family"] == "image":
+                self.sg.upload_thumbnail(
+                    published_file["type"], published_file["id"], local_path
+                )
+            instance.data["shotgridPublishedFile"] = published_file
+
+    def _find_existing_publish(self, code, context, shotgrid_version):
+
+        filters = [
+            ["project", "is", context.data.get("shotgridProject")],
+            ["task", "is", context.data.get("shotgridTask")],
+            ["entity", "is", context.data.get("shotgridEntity")],
+            ["version", "is", shotgrid_version],
+            ["code", "is", code],
+        ]
+        return self.sg.find_one("PublishedFile", filters, [])
+
+    def _create_published(self, published_file_data):
+
+        return self.sg.create("PublishedFile", published_file_data)
diff --git a/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_version.py b/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_version.py
new file mode 100644
index 0000000000..a1b7140e22
--- /dev/null
+++ b/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_version.py
@@ -0,0 +1,92 @@
+import os
+import pyblish.api
+
+
+class IntegrateShotgridVersion(pyblish.api.InstancePlugin):
+    """Integrate Shotgrid Version"""
+
+    order = pyblish.api.IntegratorOrder + 0.497
+    label = "Shotgrid Version"
+
+    sg = None
+
+    def process(self, instance):
+
+        context = instance.context
+        self.sg = context.data.get("shotgridSession")
+
+        # TODO: Use path template solver to build version code from settings
+        anatomy = instance.data.get("anatomyData", {})
+        code = "_".join(
+            [
+                anatomy["project"]["code"],
+                anatomy["parent"],
+                anatomy["asset"],
+                anatomy["task"]["name"],
+                "v{:03}".format(int(anatomy["version"])),
+            ]
+        )
+
+        version = self._find_existing_version(code, context)
+
+        if not version:
+            version = self._create_version(code, context)
+            self.log.info("Create Shotgrid version: {}".format(version))
+        else:
+            self.log.info("Use existing Shotgrid version: {}".format(version))
+
+        data_to_update = {}
+        status = context.data.get("intent", {}).get("value")
+        if status:
+            data_to_update["sg_status_list"] = status
+
+        for representation in instance.data.get("representations", []):
+            local_path = representation.get("published_path")
+            code = os.path.basename(local_path)
+
+            if "shotgridreview" in representation.get("tags", []):
+
+                if representation["ext"] in ["mov", "avi"]:
+                    self.log.info(
+                        "Upload review: {} for version shotgrid {}".format(
+                            local_path, version.get("id")
+                        )
+                    )
+                    self.sg.upload(
+                        "Version",
+                        version.get("id"),
+                        local_path,
+                        field_name="sg_uploaded_movie",
+                    )
+
+                    data_to_update["sg_path_to_movie"] = local_path
+
+                elif representation["ext"] in ["jpg", "png", "exr", "tga"]:
+                    path_to_frame = local_path.replace("0000", "#")
+                    data_to_update["sg_path_to_frames"] = path_to_frame
+
+        self.log.info("Update Shotgrid version with {}".format(data_to_update))
+        self.sg.update("Version", version["id"], data_to_update)
+
+        instance.data["shotgridVersion"] = version
+
+    def _find_existing_version(self, code, context):
+
+        filters = [
+            ["project", "is", context.data.get("shotgridProject")],
+            ["sg_task", "is", context.data.get("shotgridTask")],
+            ["entity", "is", context.data.get("shotgridEntity")],
+            ["code", "is", code],
+        ]
+        return self.sg.find_one("Version", filters, [])
+
+    def _create_version(self, code, context):
+
+        version_data = {
+            "project": context.data.get("shotgridProject"),
+            "sg_task": context.data.get("shotgridTask"),
+            "entity": context.data.get("shotgridEntity"),
+            "code": code,
+        }
+
+        return self.sg.create("Version", version_data)
diff --git a/openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py b/openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py
new file mode 100644
index 0000000000..7343c47808
--- /dev/null
+++ b/openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py
@@ -0,0 +1,36 @@
+import pyblish.api
+import openpype.api
+
+
+class ValidateShotgridUser(pyblish.api.ContextPlugin):
+    """
+        Check if user is valid and have access to the project.
+    """
+
+    label = "Validate Shotgrid User"
+    order = openpype.api.ValidateContentsOrder
+
+    def process(self, context):
+        sg = context.data.get('shotgridSession')
+
+        login = context.data.get('shotgridUser')
+        self.log.info("Login shotgrid set in OpenPype is {}".format(login))
+        project = context.data.get("shotgridProject")
+        self.log.info("Current shotgun project is {}".format(project))
+
+        if not (login and sg and project):
+            raise KeyError()
+
+        user = sg.find_one(
+            "HumanUser",
+            [["login", "is", login]],
+            ["projects"]
+        )
+
+        self.log.info(user)
+        self.log.info(login)
+        user_projects_id = [p["id"] for p in user.get("projects", [])]
+        if not project.get('id') in user_projects_id:
+            raise PermissionError("Login {} don't have access to the project {}".format(login, project))
+
+        self.log.info("Login {} have access to the project {}".format(login, project))
diff --git a/openpype/modules/shotgrid/server/README.md b/openpype/modules/shotgrid/server/README.md
new file mode 100644
index 0000000000..15e056ff3e
--- /dev/null
+++ b/openpype/modules/shotgrid/server/README.md
@@ -0,0 +1,5 @@
+
+### Shotgrid server
+
+Please refer to the external project that covers Openpype/Shotgrid communication:
+  - https://github.com/Ellipsanime/shotgrid-leecher
diff --git a/openpype/modules/shotgrid/shotgrid_module.py b/openpype/modules/shotgrid/shotgrid_module.py
new file mode 100644
index 0000000000..75d5f843c5
--- /dev/null
+++ b/openpype/modules/shotgrid/shotgrid_module.py
@@ -0,0 +1,62 @@
+import os
+import threading
+from typing import Optional, Dict, Any
+
+from openpype_interfaces import (
+    ITrayModule,
+    IPluginPaths,
+    ILaunchHookPaths,
+)
+
+from openpype.modules import OpenPypeModule
+from .aop.patch import patch_avalon_db
+from .tray.shotgrid_tray import (
+    ShotgridTrayWrapper,
+)
+
+SHOTGRID_MODULE_DIR = os.path.dirname(os.path.abspath(__file__))
+
+
+class ShotgridModule(
+    OpenPypeModule, ITrayModule, IPluginPaths, ILaunchHookPaths
+):
+    leecher_manager_url: str
+    name: str = "shotgrid"
+    enabled: bool = False
+    project_id: Optional[str] = None
+    tray_wrapper: ShotgridTrayWrapper
+
+    def initialize(self, modules_settings: Dict[str, Any]):
+        patch_avalon_db()
+        threading.Timer(10.0, patch_avalon_db).start()
+        shotgrid_settings = modules_settings.get(self.name, dict())
+        self.enabled = shotgrid_settings.get("enabled", False)
+        self.leecher_manager_url = shotgrid_settings.get(
+            "leecher_manager_url", ""
+        )
+
+    def connect_with_modules(self, enabled_modules):
+        pass
+
+    def get_global_environments(self) -> Dict[str, Any]:
+        return {"PROJECT_ID": self.project_id}
+
+    def get_plugin_paths(self) -> Dict[str, Any]:
+        return {
+            "publish": [os.path.join(SHOTGRID_MODULE_DIR, "plugins", "publish")]
+        }
+
+    def get_launch_hook_paths(self) -> str:
+        return os.path.join(SHOTGRID_MODULE_DIR, "hooks")
+
+    def tray_init(self):
+        self.tray_wrapper = ShotgridTrayWrapper(self)
+
+    def tray_start(self):
+        return self.tray_wrapper.validate()
+
+    def tray_exit(self, *args, **kwargs):
+        return self.tray_wrapper
+
+    def tray_menu(self, tray_menu):
+        return self.tray_wrapper.tray_menu(tray_menu)
diff --git a/openpype/modules/shotgrid/tests/shotgrid/lib/test_credentials.py b/openpype/modules/shotgrid/tests/shotgrid/lib/test_credentials.py
new file mode 100644
index 0000000000..1f78cf77c9
--- /dev/null
+++ b/openpype/modules/shotgrid/tests/shotgrid/lib/test_credentials.py
@@ -0,0 +1,34 @@
+import pytest
+from assertpy import assert_that
+
+import openpype.modules.shotgrid.lib.credentials as sut
+
+
+def test_missing_shotgrid_url():
+    with pytest.raises(Exception) as ex:
+        # arrange
+        url = ""
+        # act
+        sut.get_shotgrid_hostname(url)
+        # assert
+        assert_that(ex).is_equal_to("Shotgrid url cannot be a null")
+
+
+def test_full_shotgrid_url():
+    # arrange
+    url = "https://shotgrid.com/myinstance"
+    # act
+    actual = sut.get_shotgrid_hostname(url)
+    # assert
+    assert_that(actual).is_not_empty()
+    assert_that(actual).is_equal_to("shotgrid.com")
+
+
+def test_incomplete_shotgrid_url():
+    # arrange
+    url = "shotgrid.com/myinstance"
+    # act
+    actual = sut.get_shotgrid_hostname(url)
+    # assert
+    assert_that(actual).is_not_empty()
+    assert_that(actual).is_equal_to("shotgrid.com")
diff --git a/openpype/modules/shotgrid/tray/credential_dialog.py b/openpype/modules/shotgrid/tray/credential_dialog.py
new file mode 100644
index 0000000000..8d7d587c6a
--- /dev/null
+++ b/openpype/modules/shotgrid/tray/credential_dialog.py
@@ -0,0 +1,202 @@
+import os
+from typing import Any
+from Qt import QtCore, QtWidgets, QtGui
+
+from openpype import style
+from openpype import resources
+from openpype.modules.shotgrid.lib import settings, credentials
+
+
+class CredentialsDialog(QtWidgets.QDialog):
+    SIZE_W = 450
+    SIZE_H = 200
+
+    _module: Any = None
+    _is_logged: bool = False
+    url_label: QtWidgets.QLabel
+    login_label: QtWidgets.QLabel
+    password_label: QtWidgets.QLabel
+    url_input: QtWidgets.QComboBox
+    login_input: QtWidgets.QLineEdit
+    password_input: QtWidgets.QLineEdit
+    input_layout: QtWidgets.QFormLayout
+    login_button: QtWidgets.QPushButton
+    buttons_layout: QtWidgets.QHBoxLayout
+    main_widget: QtWidgets.QVBoxLayout
+
+    login_changed: QtCore.Signal = QtCore.Signal()
+
+    def __init__(self, module, parent=None):
+        super(CredentialsDialog, self).__init__(parent)
+
+        self._module = module
+        self._is_logged = False
+
+        self.setWindowTitle("OpenPype - Shotgrid Login")
+
+        icon = QtGui.QIcon(resources.get_openpype_icon_filepath())
+        self.setWindowIcon(icon)
+
+        self.setWindowFlags(
+            QtCore.Qt.WindowCloseButtonHint
+            | QtCore.Qt.WindowMinimizeButtonHint
+        )
+        self.setMinimumSize(QtCore.QSize(self.SIZE_W, self.SIZE_H))
+        self.setMaximumSize(QtCore.QSize(self.SIZE_W + 100, self.SIZE_H + 100))
+        self.setStyleSheet(style.load_stylesheet())
+
+        self.ui_init()
+
+    def ui_init(self):
+        self.url_label = QtWidgets.QLabel("Shotgrid server:")
+        self.login_label = QtWidgets.QLabel("Login:")
+        self.password_label = QtWidgets.QLabel("Password:")
+
+        self.url_input = QtWidgets.QComboBox()
+        # self.url_input.setReadOnly(True)
+
+        self.login_input = QtWidgets.QLineEdit()
+        self.login_input.setPlaceholderText("login")
+
+        self.password_input = QtWidgets.QLineEdit()
+        self.password_input.setPlaceholderText("password")
+        self.password_input.setEchoMode(QtWidgets.QLineEdit.Password)
+
+        self.error_label = QtWidgets.QLabel("")
+        self.error_label.setStyleSheet("color: red;")
+        self.error_label.setWordWrap(True)
+        self.error_label.hide()
+
+        self.input_layout = QtWidgets.QFormLayout()
+        self.input_layout.setContentsMargins(10, 15, 10, 5)
+
+        self.input_layout.addRow(self.url_label, self.url_input)
+        self.input_layout.addRow(self.login_label, self.login_input)
+        self.input_layout.addRow(self.password_label, self.password_input)
+        self.input_layout.addRow(self.error_label)
+
+        self.login_button = QtWidgets.QPushButton("Login")
+        self.login_button.setToolTip("Log in shotgrid instance")
+        self.login_button.clicked.connect(self._on_shotgrid_login_clicked)
+
+        self.logout_button = QtWidgets.QPushButton("Logout")
+        self.logout_button.setToolTip("Log out shotgrid instance")
+        self.logout_button.clicked.connect(self._on_shotgrid_logout_clicked)
+
+        self.buttons_layout = QtWidgets.QHBoxLayout()
+        self.buttons_layout.addWidget(self.logout_button)
+        self.buttons_layout.addWidget(self.login_button)
+
+        self.main_widget = QtWidgets.QVBoxLayout(self)
+        self.main_widget.addLayout(self.input_layout)
+        self.main_widget.addLayout(self.buttons_layout)
+        self.setLayout(self.main_widget)
+
+    def show(self, *args, **kwargs):
+        super(CredentialsDialog, self).show(*args, **kwargs)
+        self._fill_shotgrid_url()
+        self._fill_shotgrid_login()
+
+    def _fill_shotgrid_url(self):
+        servers = settings.get_shotgrid_servers()
+
+        if servers:
+            for _, v in servers.items():
+                self.url_input.addItem("{}".format(v.get('shotgrid_url')))
+            self._valid_input(self.url_input)
+            self.login_button.show()
+            self.logout_button.show()
+            enabled = True
+        else:
+            self.set_error("Ask your admin to add shotgrid server in settings")
+            self._invalid_input(self.url_input)
+            self.login_button.hide()
+            self.logout_button.hide()
+            enabled = False
+
+        self.login_input.setEnabled(enabled)
+        self.password_input.setEnabled(enabled)
+
+    def _fill_shotgrid_login(self):
+        login = credentials.get_local_login()
+
+        if login:
+            self.login_input.setText(login)
+
+    def _clear_shotgrid_login(self):
+        self.login_input.setText("")
+        self.password_input.setText("")
+
+    def _on_shotgrid_login_clicked(self):
+        login = self.login_input.text().strip()
+        password = self.password_input.text().strip()
+        missing = []
+
+        if login == "":
+            missing.append("login")
+            self._invalid_input(self.login_input)
+
+        if password == "":
+            missing.append("password")
+            self._invalid_input(self.password_input)
+
+        url = self.url_input.currentText()
+        if url == "":
+            missing.append("url")
+            self._invalid_input(self.url_input)
+
+        if len(missing) > 0:
+            self.set_error("You didn't enter {}".format(" and ".join(missing)))
+            return
+
+        # if credentials.check_credentials(
+        #     login=login,
+        #     password=password,
+        #     shotgrid_url=url,
+        # ):
+        credentials.save_local_login(
+            login=login
+        )
+        os.environ['OPENPYPE_SG_USER'] = login
+        self._on_login()
+
+        self.set_error("CANT LOGIN")
+
+    def _on_shotgrid_logout_clicked(self):
+        credentials.clear_local_login()
+        del os.environ['OPENPYPE_SG_USER']
+        self._clear_shotgrid_login()
+        self._on_logout()
+
+    def set_error(self, msg: str):
+        self.error_label.setText(msg)
+        self.error_label.show()
+
+    def _on_login(self):
+        self._is_logged = True
+        self.login_changed.emit()
+        self._close_widget()
+
+    def _on_logout(self):
+        self._is_logged = False
+        self.login_changed.emit()
+
+    def _close_widget(self):
+        self.hide()
+
+    def _valid_input(self, input_widget: QtWidgets.QLineEdit):
+        input_widget.setStyleSheet("")
+
+    def _invalid_input(self, input_widget: QtWidgets.QLineEdit):
+        input_widget.setStyleSheet("border: 1px solid red;")
+
+    def login_with_credentials(
+        self, url: str, login: str, password: str
+    ) -> bool:
+        verification = credentials.check_credentials(url, login, password)
+        if verification:
+            credentials.save_credentials(login, password, False)
+            self._module.set_credentials_to_env(login, password)
+            self.set_credentials(login, password)
+            self.login_changed.emit()
+        return verification
diff --git a/openpype/modules/shotgrid/tray/shotgrid_tray.py b/openpype/modules/shotgrid/tray/shotgrid_tray.py
new file mode 100644
index 0000000000..0be58e3b20
--- /dev/null
+++ b/openpype/modules/shotgrid/tray/shotgrid_tray.py
@@ -0,0 +1,76 @@
+import os
+import webbrowser
+from typing import Any
+
+from Qt import QtWidgets
+
+from openpype.modules.shotgrid.lib import credentials
+from openpype.modules.shotgrid.tray.credential_dialog import (
+    CredentialsDialog,
+)
+
+
+class ShotgridTrayWrapper:
+    module: Any
+    credentials_dialog: CredentialsDialog
+    logged_user_label: QtWidgets.QAction
+
+    def __init__(self, module) -> None:
+        self.module = module
+        self.credentials_dialog = CredentialsDialog(module)
+        self.credentials_dialog.login_changed.connect(self.set_login_label)
+        self.logged_user_label = QtWidgets.QAction("")
+        self.logged_user_label.setDisabled(True)
+        self.set_login_label()
+
+    def show_batch_dialog(self):
+        if self.module.leecher_manager_url:
+            webbrowser.open(self.module.leecher_manager_url)
+
+    def show_connect_dialog(self):
+        self.show_credential_dialog()
+
+    def show_credential_dialog(self):
+        self.credentials_dialog.show()
+        self.credentials_dialog.activateWindow()
+        self.credentials_dialog.raise_()
+
+    def set_login_label(self):
+        login = credentials.get_local_login()
+        if login:
+            self.logged_user_label.setText("{}".format(login))
+        else:
+            self.logged_user_label.setText(
+                "No User logged in {0}".format(login)
+            )
+
+    def tray_menu(self, tray_menu):
+        # Add login to user menu
+        menu = QtWidgets.QMenu("Shotgrid", tray_menu)
+        show_connect_action = QtWidgets.QAction("Connect to Shotgrid", menu)
+        show_connect_action.triggered.connect(self.show_connect_dialog)
+        menu.addAction(self.logged_user_label)
+        menu.addSeparator()
+        menu.addAction(show_connect_action)
+        tray_menu.addMenu(menu)
+
+        # Add manager to Admin menu
+        for m in tray_menu.findChildren(QtWidgets.QMenu):
+            if m.title() == "Admin":
+                shotgrid_manager_action = QtWidgets.QAction(
+                    "Shotgrid manager", menu
+                )
+                shotgrid_manager_action.triggered.connect(
+                    self.show_batch_dialog
+                )
+                m.addAction(shotgrid_manager_action)
+
+    def validate(self) -> bool:
+        login = credentials.get_local_login()
+
+        if not login:
+            self.show_credential_dialog()
+        else:
+            os.environ["OPENPYPE_SG_USER"] = login
+
+        return True
diff --git a/openpype/resources/app_icons/shotgrid.png b/openpype/resources/app_icons/shotgrid.png
new file mode 100644
index 0000000000000000000000000000000000000000..6d0cc047f9ed86e0db45ea557404ab7edb2f5bf2
GIT binary patch
literal 45744
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
N8$~sR3OTc&{{b(fTU!7C

literal 0
HcmV?d00001

diff --git a/openpype/settings/defaults/project_settings/shotgrid.json b/openpype/settings/defaults/project_settings/shotgrid.json
new file mode 100644
index 0000000000..83b6f69074
--- /dev/null
+++ b/openpype/settings/defaults/project_settings/shotgrid.json
@@ -0,0 +1,22 @@
+{
+    "shotgrid_project_id": 0,
+    "shotgrid_server": "",
+    "event": {
+        "enabled": false
+    },
+    "fields": {
+        "asset": {
+            "type": "sg_asset_type"
+        },
+        "sequence": {
+            "episode_link": "episode"
+        },
+        "shot": {
+            "episode_link": "sg_episode",
+            "sequence_link": "sg_sequence"
+        },
+        "task": {
+            "step": "step"
+        }
+    }
+}
diff --git a/openpype/settings/defaults/system_settings/modules.json b/openpype/settings/defaults/system_settings/modules.json
index d74269922f..a5746e930b 100644
--- a/openpype/settings/defaults/system_settings/modules.json
+++ b/openpype/settings/defaults/system_settings/modules.json
@@ -137,6 +137,13 @@
             }
         }
     },
+    "shotgrid": {
+        "enabled": true,
+        "filter_projects_by_login": true,
+        "leecher_manager_url": "http://127.0.0.1:3000",
+        "leecher_backend_url": "http://127.0.0.1:8090",
+        "shotgrid_settings": {}
+    },
     "timers_manager": {
         "enabled": true,
         "auto_stop": true,
@@ -205,4 +212,4 @@
             "linux": ""
         }
     }
-}
\ No newline at end of file
+}
diff --git a/openpype/settings/entities/__init__.py b/openpype/settings/entities/__init__.py
index a173e2454f..b2cb2204f4 100644
--- a/openpype/settings/entities/__init__.py
+++ b/openpype/settings/entities/__init__.py
@@ -107,6 +107,7 @@ from .enum_entity import (
     TaskTypeEnumEntity,
     DeadlineUrlEnumEntity,
     AnatomyTemplatesEnumEntity,
+    ShotgridUrlEnumEntity
 )
 
 from .list_entity import ListEntity
@@ -171,6 +172,7 @@ __all__ = (
     "ToolsEnumEntity",
     "TaskTypeEnumEntity",
     "DeadlineUrlEnumEntity",
+    "ShotgridUrlEnumEntity",
     "AnatomyTemplatesEnumEntity",
 
     "ListEntity",
diff --git a/openpype/settings/entities/enum_entity.py b/openpype/settings/entities/enum_entity.py
index 92a397afba..643bd5735d 100644
--- a/openpype/settings/entities/enum_entity.py
+++ b/openpype/settings/entities/enum_entity.py
@@ -1,10 +1,7 @@
 import copy
 from .input_entities import InputEntity
 from .exceptions import EntitySchemaError
-from .lib import (
-    NOT_SET,
-    STRING_TYPE
-)
+from .lib import NOT_SET, STRING_TYPE
 
 
 class BaseEnumEntity(InputEntity):
@@ -26,15 +23,13 @@ class BaseEnumEntity(InputEntity):
         for item in self.enum_items:
             key = tuple(item.keys())[0]
             if key in enum_keys:
-                reason = "Key \"{}\" is more than once in enum items.".format(
-                    key
-                )
+                reason = 'Key "{}" is more than once in enum items.'.format(key)
                 raise EntitySchemaError(self, reason)
 
             enum_keys.add(key)
 
             if not isinstance(key, STRING_TYPE):
-                reason = "Key \"{}\" has invalid type {}, expected {}.".format(
+                reason = 'Key "{}" has invalid type {}, expected {}.'.format(
                     key, type(key), STRING_TYPE
                 )
                 raise EntitySchemaError(self, reason)
@@ -59,7 +54,7 @@ class BaseEnumEntity(InputEntity):
         for item in check_values:
             if item not in self.valid_keys:
                 raise ValueError(
-                    "{} Invalid value \"{}\". Expected one of: {}".format(
+                    '{} Invalid value "{}". Expected one of: {}'.format(
                         self.path, item, self.valid_keys
                     )
                 )
@@ -84,7 +79,7 @@ class EnumEntity(BaseEnumEntity):
         self.valid_keys = set(all_keys)
 
         if self.multiselection:
-            self.valid_value_types = (list, )
+            self.valid_value_types = (list,)
             value_on_not_set = []
             if enum_default:
                 if not isinstance(enum_default, list):
@@ -109,7 +104,7 @@ class EnumEntity(BaseEnumEntity):
                         self.value_on_not_set = key
                         break
 
-            self.valid_value_types = (STRING_TYPE, )
+            self.valid_value_types = (STRING_TYPE,)
 
         # GUI attribute
         self.placeholder = self.schema_data.get("placeholder")
@@ -152,6 +147,7 @@ class HostsEnumEntity(BaseEnumEntity):
     Host name is not the same as application name. Host name defines
     implementation instead of application name.
     """
+
     schema_types = ["hosts-enum"]
     all_host_names = [
         "aftereffects",
@@ -169,7 +165,7 @@ class HostsEnumEntity(BaseEnumEntity):
         "tvpaint",
         "unreal",
         "standalonepublisher",
-        "webpublisher"
+        "webpublisher",
     ]
 
     def _item_initialization(self):
@@ -210,7 +206,7 @@ class HostsEnumEntity(BaseEnumEntity):
         self.valid_keys = valid_keys
 
         if self.multiselection:
-            self.valid_value_types = (list, )
+            self.valid_value_types = (list,)
             self.value_on_not_set = []
         else:
             for key in valid_keys:
@@ -218,7 +214,7 @@ class HostsEnumEntity(BaseEnumEntity):
                     self.value_on_not_set = key
                     break
 
-            self.valid_value_types = (STRING_TYPE, )
+            self.valid_value_types = (STRING_TYPE,)
 
         # GUI attribute
         self.placeholder = self.schema_data.get("placeholder")
@@ -226,14 +222,10 @@ class HostsEnumEntity(BaseEnumEntity):
     def schema_validations(self):
         if self.hosts_filter:
             enum_len = len(self.enum_items)
-            if (
-                enum_len == 0
-                or (enum_len == 1 and self.use_empty_value)
-            ):
-                joined_filters = ", ".join([
-                    '"{}"'.format(item)
-                    for item in self.hosts_filter
-                ])
+            if enum_len == 0 or (enum_len == 1 and self.use_empty_value):
+                joined_filters = ", ".join(
+                    ['"{}"'.format(item) for item in self.hosts_filter]
+                )
                 reason = (
                     "All host names were removed after applying"
                     " host filters. {}"
@@ -246,24 +238,25 @@ class HostsEnumEntity(BaseEnumEntity):
                     invalid_filters.add(item)
 
             if invalid_filters:
-                joined_filters = ", ".join([
-                    '"{}"'.format(item)
-                    for item in self.hosts_filter
-                ])
-                expected_hosts = ", ".join([
-                    '"{}"'.format(item)
-                    for item in self.all_host_names
-                ])
-                self.log.warning((
-                    "Host filters containt invalid host names:"
-                    " \"{}\" Expected values are {}"
-                ).format(joined_filters, expected_hosts))
+                joined_filters = ", ".join(
+                    ['"{}"'.format(item) for item in self.hosts_filter]
+                )
+                expected_hosts = ", ".join(
+                    ['"{}"'.format(item) for item in self.all_host_names]
+                )
+                self.log.warning(
+                    (
+                        "Host filters containt invalid host names:"
+                        ' "{}" Expected values are {}'
+                    ).format(joined_filters, expected_hosts)
+                )
 
         super(HostsEnumEntity, self).schema_validations()
 
 
 class AppsEnumEntity(BaseEnumEntity):
     """Enum of applications for project anatomy attributes."""
+
     schema_types = ["apps-enum"]
 
     def _item_initialization(self):
@@ -271,7 +264,7 @@ class AppsEnumEntity(BaseEnumEntity):
         self.value_on_not_set = []
         self.enum_items = []
         self.valid_keys = set()
-        self.valid_value_types = (list, )
+        self.valid_value_types = (list,)
         self.placeholder = None
 
     def _get_enum_values(self):
@@ -352,7 +345,7 @@ class ToolsEnumEntity(BaseEnumEntity):
         self.value_on_not_set = []
         self.enum_items = []
         self.valid_keys = set()
-        self.valid_value_types = (list, )
+        self.valid_value_types = (list,)
         self.placeholder = None
 
     def _get_enum_values(self):
@@ -409,10 +402,10 @@ class TaskTypeEnumEntity(BaseEnumEntity):
     def _item_initialization(self):
         self.multiselection = self.schema_data.get("multiselection", True)
         if self.multiselection:
-            self.valid_value_types = (list, )
+            self.valid_value_types = (list,)
             self.value_on_not_set = []
         else:
-            self.valid_value_types = (STRING_TYPE, )
+            self.valid_value_types = (STRING_TYPE,)
             self.value_on_not_set = ""
 
         self.enum_items = []
@@ -507,7 +500,8 @@ class DeadlineUrlEnumEntity(BaseEnumEntity):
         enum_items_list = []
         for server_name, url_entity in deadline_urls_entity.items():
             enum_items_list.append(
-                {server_name: "{}: {}".format(server_name, url_entity.value)})
+                {server_name: "{}: {}".format(server_name, url_entity.value)}
+            )
             valid_keys.add(server_name)
         return enum_items_list, valid_keys
 
@@ -530,6 +524,50 @@ class DeadlineUrlEnumEntity(BaseEnumEntity):
                 self._current_value = tuple(self.valid_keys)[0]
 
 
+class ShotgridUrlEnumEntity(BaseEnumEntity):
+    schema_types = ["shotgrid_url-enum"]
+
+    def _item_initialization(self):
+        self.multiselection = False
+
+        self.enum_items = []
+        self.valid_keys = set()
+
+        self.valid_value_types = (STRING_TYPE,)
+        self.value_on_not_set = ""
+
+        # GUI attribute
+        self.placeholder = self.schema_data.get("placeholder")
+
+    def _get_enum_values(self):
+        shotgrid_settings = self.get_entity_from_path(
+            "system_settings/modules/shotgrid/shotgrid_settings"
+        )
+
+        valid_keys = set()
+        enum_items_list = []
+        for server_name, settings in shotgrid_settings.items():
+            enum_items_list.append(
+                {
+                    server_name: "{}: {}".format(
+                        server_name, settings["shotgrid_url"].value
+                    )
+                }
+            )
+            valid_keys.add(server_name)
+        return enum_items_list, valid_keys
+
+    def set_override_state(self, *args, **kwargs):
+        super(ShotgridUrlEnumEntity, self).set_override_state(*args, **kwargs)
+
+        self.enum_items, self.valid_keys = self._get_enum_values()
+        if not self.valid_keys:
+            self._current_value = ""
+
+        elif self._current_value not in self.valid_keys:
+            self._current_value = tuple(self.valid_keys)[0]
+
+
 class AnatomyTemplatesEnumEntity(BaseEnumEntity):
     schema_types = ["anatomy-templates-enum"]
 
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_main.json b/openpype/settings/entities/schemas/projects_schema/schema_main.json
index 8e4eba86ef..521c066964 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_main.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_main.json
@@ -62,6 +62,10 @@
                     "type": "schema",
                     "name": "schema_project_ftrack"
                 },
+                {
+                    "type": "schema",
+                    "name": "schema_project_shotgrid"
+                },
                 {
                     "type": "schema",
                     "name": "schema_project_deadline"
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_shotgrid.json b/openpype/settings/entities/schemas/projects_schema/schema_project_shotgrid.json
new file mode 100644
index 0000000000..4faeca89f3
--- /dev/null
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_shotgrid.json
@@ -0,0 +1,98 @@
+{
+    "type": "dict",
+    "key": "shotgrid",
+    "label": "Shotgrid",
+    "collapsible": true,
+    "is_file": true,
+    "children": [
+        {
+            "type": "number",
+            "key": "shotgrid_project_id",
+            "label": "Shotgrid project id"
+        },
+        {
+            "type": "shotgrid_url-enum",
+            "key": "shotgrid_server",
+            "label": "Shotgrid Server"
+        },
+        {
+            "type": "dict",
+            "key": "event",
+            "label": "Event Handler",
+            "collapsible": true,
+            "checkbox_key": "enabled",
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                }
+            ]
+        },
+        {
+            "type": "dict",
+            "key": "fields",
+            "label": "Fields Template",
+            "collapsible": true,
+            "children": [
+                {
+                    "type": "dict",
+                    "key": "asset",
+                    "label": "Asset",
+                    "collapsible": true,
+                    "children": [
+                        {
+                            "type": "text",
+                            "key": "type",
+                            "label": "Asset Type"
+                        }
+                    ]
+                },
+                {
+                    "type": "dict",
+                    "key": "sequence",
+                    "label": "Sequence",
+                    "collapsible": true,
+                    "children": [
+                        {
+                            "type": "text",
+                            "key": "episode_link",
+                            "label": "Episode link"
+                        }
+                    ]
+                },
+                {
+                    "type": "dict",
+                    "key": "shot",
+                    "label": "Shot",
+                    "collapsible": true,
+                    "children": [
+                        {
+                            "type": "text",
+                            "key": "episode_link",
+                            "label": "Episode link"
+                        },
+                        {
+                            "type": "text",
+                            "key": "sequence_link",
+                            "label": "Sequence link"
+                        }
+                    ]
+                },
+                {
+                    "type": "dict",
+                    "key": "task",
+                    "label": "Task",
+                    "collapsible": true,
+                    "children": [
+                        {
+                            "type": "text",
+                            "key": "step",
+                            "label": "Step link"
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+}
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
index 484fbf9d07..a4b28f47bc 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
@@ -13,6 +13,9 @@
         {
             "ftrackreview": "Add review to Ftrack"
         },
+        {
+            "shotgridreview": "Add review to Shotgrid"
+        },
         {
             "delete": "Delete output"
         },
diff --git a/openpype/settings/entities/schemas/system_schema/schema_modules.json b/openpype/settings/entities/schemas/system_schema/schema_modules.json
index 52595914ed..dacbc8c3a1 100644
--- a/openpype/settings/entities/schemas/system_schema/schema_modules.json
+++ b/openpype/settings/entities/schemas/system_schema/schema_modules.json
@@ -44,6 +44,60 @@
             "type": "schema",
             "name": "schema_ftrack"
         },
+        {
+            "type": "dict",
+            "key": "shotgrid",
+            "label": "Shotgrid",
+            "collapsible": true,
+            "checkbox_key": "enabled",
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                },
+                {
+                    "type": "text",
+                    "key": "leecher_manager_url",
+                    "label": "Shotgrid Leecher Manager URL"
+                },
+                {
+                    "type": "text",
+                    "key": "leecher_backend_url",
+                    "label": "Shotgrid Leecher Backend URL"
+                },
+                {
+                    "type": "boolean",
+                    "key": "filter_projects_by_login",
+                    "label": "Filter projects by SG login"
+                },
+                {
+                    "type": "dict-modifiable",
+                    "key": "shotgrid_settings",
+                    "label": "Shotgrid Servers",
+                    "object_type": {
+                        "type": "dict",
+                        "children": [
+                            {
+                                "key": "shotgrid_url",
+                                "label": "Server URL",
+                                "type": "text"
+                            },
+                            {
+                                "key": "shotgrid_script_name",
+                                "label": "Script Name",
+                                "type": "text"
+                            },
+                            {
+                                "key": "shotgrid_script_key",
+                                "label": "Script api key",
+                                "type": "text"
+                            }
+                        ]
+                    }
+                }
+            ]
+        },
         {
             "type": "dict",
             "key": "timers_manager",
diff --git a/pyproject.toml b/pyproject.toml
index 006f6eb4e5..8d9eb8b050 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -40,6 +40,7 @@ clique = "1.6.*"
 Click = "^7"
 dnspython = "^2.1.0"
 ftrack-python-api = "2.0.*"
+shotgun_api3 = {git = "https://github.com/shotgunsoftware/python-api.git", rev = "v3.3.3"}
 google-api-python-client = "^1.12.8" # sync server google support (should be separate?)
 jsonschema = "^2.6.0"
 keyring = "^22.0.1"

From 00285cacc0d01dea62495cdb04f7155cb5d3da1d Mon Sep 17 00:00:00 2001
From: Vic Bartel <vbartel@yanport.com>
Date: Fri, 18 Mar 2022 17:47:29 +0100
Subject: [PATCH 0084/1227] Fix hound complaints

---
 .../publish/collect_shotgrid_session.py       |  3 +--
 .../plugins/publish/validate_shotgrid_user.py | 24 ++++++++++---------
 openpype/modules/shotgrid/shotgrid_module.py  |  4 +++-
 openpype/settings/entities/enum_entity.py     |  4 +++-
 4 files changed, 20 insertions(+), 15 deletions(-)

diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
index 65a5de9f22..b9eead6244 100644
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
@@ -1,5 +1,4 @@
 import os
-import sys
 import pyblish.api
 import shotgun_api3
 from shotgun_api3.shotgun import AuthenticationFault
@@ -128,5 +127,5 @@ def get_login():
     reg = OpenPypeSettingsRegistry()
     try:
         return str(reg.get_item("shotgrid_login"))
-    except Exception as e:
+    except Exception as _:
         return None
diff --git a/openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py b/openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py
index 7343c47808..c14c980e2a 100644
--- a/openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py
+++ b/openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py
@@ -4,16 +4,16 @@ import openpype.api
 
 class ValidateShotgridUser(pyblish.api.ContextPlugin):
     """
-        Check if user is valid and have access to the project.
+    Check if user is valid and have access to the project.
     """
 
     label = "Validate Shotgrid User"
     order = openpype.api.ValidateContentsOrder
 
     def process(self, context):
-        sg = context.data.get('shotgridSession')
+        sg = context.data.get("shotgridSession")
 
-        login = context.data.get('shotgridUser')
+        login = context.data.get("shotgridUser")
         self.log.info("Login shotgrid set in OpenPype is {}".format(login))
         project = context.data.get("shotgridProject")
         self.log.info("Current shotgun project is {}".format(project))
@@ -21,16 +21,18 @@ class ValidateShotgridUser(pyblish.api.ContextPlugin):
         if not (login and sg and project):
             raise KeyError()
 
-        user = sg.find_one(
-            "HumanUser",
-            [["login", "is", login]],
-            ["projects"]
-        )
+        user = sg.find_one("HumanUser", [["login", "is", login]], ["projects"])
 
         self.log.info(user)
         self.log.info(login)
         user_projects_id = [p["id"] for p in user.get("projects", [])]
-        if not project.get('id') in user_projects_id:
-            raise PermissionError("Login {} don't have access to the project {}".format(login, project))
+        if not project.get("id") in user_projects_id:
+            raise PermissionError(
+                "Login {} don't have access to the project {}".format(
+                    login, project
+                )
+            )
 
-        self.log.info("Login {} have access to the project {}".format(login, project))
+        self.log.info(
+            "Login {} have access to the project {}".format(login, project)
+        )
diff --git a/openpype/modules/shotgrid/shotgrid_module.py b/openpype/modules/shotgrid/shotgrid_module.py
index 75d5f843c5..222c4c2e1f 100644
--- a/openpype/modules/shotgrid/shotgrid_module.py
+++ b/openpype/modules/shotgrid/shotgrid_module.py
@@ -43,7 +43,9 @@ class ShotgridModule(
 
     def get_plugin_paths(self) -> Dict[str, Any]:
         return {
-            "publish": [os.path.join(SHOTGRID_MODULE_DIR, "plugins", "publish")]
+            "publish": [
+                os.path.join(SHOTGRID_MODULE_DIR, "plugins", "publish")
+            ]
         }
 
     def get_launch_hook_paths(self) -> str:
diff --git a/openpype/settings/entities/enum_entity.py b/openpype/settings/entities/enum_entity.py
index 643bd5735d..3b3dd47e61 100644
--- a/openpype/settings/entities/enum_entity.py
+++ b/openpype/settings/entities/enum_entity.py
@@ -23,7 +23,9 @@ class BaseEnumEntity(InputEntity):
         for item in self.enum_items:
             key = tuple(item.keys())[0]
             if key in enum_keys:
-                reason = 'Key "{}" is more than once in enum items.'.format(key)
+                reason = 'Key "{}" is more than once in enum items.'.format(
+                    key
+                )
                 raise EntitySchemaError(self, reason)
 
             enum_keys.add(key)

From feae04f0c34abdd87bcb6703962ac66c98e33831 Mon Sep 17 00:00:00 2001
From: Vic Bartel <vbartel@yanport.com>
Date: Fri, 18 Mar 2022 17:49:42 +0100
Subject: [PATCH 0085/1227] Fix hound Exception complaints

---
 .../shotgrid/plugins/publish/collect_shotgrid_session.py        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
index b9eead6244..edf804a892 100644
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
@@ -127,5 +127,5 @@ def get_login():
     reg = OpenPypeSettingsRegistry()
     try:
         return str(reg.get_item("shotgrid_login"))
-    except Exception as _:
+    except Exception:
         return None

From 521b56289dea9c7697dfc44bf8d8095278e377c9 Mon Sep 17 00:00:00 2001
From: Vic Bartel <vbartel@yanport.com>
Date: Fri, 25 Mar 2022 10:07:49 +0100
Subject: [PATCH 0086/1227] Add fixes after first PR

---
 .editorconfig                                 | 19 --------------
 .gitignore                                    |  3 +++
 .pre-commit-config.yaml                       | 26 -------------------
 mypy.ini                                      |  5 ----
 .../plugins/publish/submit_publish_job.py     |  1 -
 openpype/modules/shotgrid/lib/settings.py     |  3 +++
 .../publish/collect_shotgrid_session.py       | 10 +------
 7 files changed, 7 insertions(+), 60 deletions(-)
 delete mode 100644 .editorconfig
 delete mode 100644 .pre-commit-config.yaml
 delete mode 100644 mypy.ini

diff --git a/.editorconfig b/.editorconfig
deleted file mode 100644
index aeb5534872..0000000000
--- a/.editorconfig
+++ /dev/null
@@ -1,19 +0,0 @@
-root = true
-
-[*]
-end_of_line = lf
-insert_final_newline = true
-
-[*.{js,py}]
-charset = utf-8
-
-[*.py]
-indent_style = space
-indent_size = 4
-
-[*.yml]
-indent_style = space
-indent_size = 2
-
-[Makefile]
-indent_style = tab
diff --git a/.gitignore b/.gitignore
index fa3fae1ad2..f90549d0c0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -100,3 +100,6 @@ website/.docusaurus
 
 .poetry/
 .python-version
+.editorconfig
+.pre-commit-config.yaml
+mypy.ini
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
deleted file mode 100644
index 6a986c7dd9..0000000000
--- a/.pre-commit-config.yaml
+++ /dev/null
@@ -1,26 +0,0 @@
-repos:
--   repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v3.2.0
-    hooks:
-    -   id: trailing-whitespace
-    -   id: end-of-file-fixer
-    -   id: check-yaml
-    -   id: check-added-large-files
--   repo: https://github.com/ambv/black
-    rev: 21.4b0
-    hooks:
-    - id: black
-      language_version: "3"
-      args:
-        - "--config"
-        - "./pyproject.toml"
--   repo: https://github.com/pycqa/flake8
-    rev: "3.9.2"  # pick a git hash / tag to point to
-    hooks:
-    -   id: flake8
--   repo: https://github.com/pre-commit/mirrors-mypy
-    rev: 'v0.902'
-    hooks:
-    -   id: mypy
-        args: [--no-strict-optional, --ignore-missing-imports]
-        additional_dependencies: [tokenize-rt==3.2.0]
diff --git a/mypy.ini b/mypy.ini
deleted file mode 100644
index 90cde26676..0000000000
--- a/mypy.ini
+++ /dev/null
@@ -1,5 +0,0 @@
-[mypy]
-python_version = 3.7
-ignore_missing_imports = false
-check_untyped_defs = true
-follow_imports = silent
diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index e1e1ea6b94..3c4e0d2913 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -113,7 +113,6 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
                   "celaction": [r".*"]}
 
     enviro_filter = [
-        "OPENPYPE_SG_USER",
         "FTRACK_API_USER",
         "FTRACK_API_KEY",
         "FTRACK_SERVER",
diff --git a/openpype/modules/shotgrid/lib/settings.py b/openpype/modules/shotgrid/lib/settings.py
index 0f4fc235cc..b34407fbf5 100644
--- a/openpype/modules/shotgrid/lib/settings.py
+++ b/openpype/modules/shotgrid/lib/settings.py
@@ -1,4 +1,5 @@
 import os
+from functools import lru_cache
 from typing import Tuple, Dict, List, Any
 
 from pymongo import MongoClient
@@ -13,10 +14,12 @@ def get_project_list() -> List[str]:
     return db.list_collection_names()
 
 
+@lru_cache(maxsize=64)
 def get_shotgrid_project_settings(project: str) -> Dict[str, Any]:
     return get_project_settings(project).get(MODULE_NAME, {})
 
 
+@lru_cache(maxsize=64)
 def get_shotgrid_settings() -> Dict[str, Any]:
     return get_system_settings().get("modules", {}).get(MODULE_NAME, {})
 
diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
index edf804a892..60071ad2fc 100644
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
@@ -4,6 +4,7 @@ import shotgun_api3
 from shotgun_api3.shotgun import AuthenticationFault
 from openpype.lib import OpenPypeSettingsRegistry
 from openpype.api import get_project_settings, get_system_settings
+from openpype.modules.shotgrid.lib.settings import get_shotgrid_servers
 
 
 class CollectShotgridSession(pyblish.api.ContextPlugin):
@@ -114,15 +115,6 @@ def get_shotgrid_settings(project):
     return get_project_settings(project).get("shotgrid", {})
 
 
-def get_shotgrid_servers():
-    return (
-        get_system_settings()
-        .get("modules", {})
-        .get("shotgrid", {})
-        .get("shotgrid_settings", {})
-    )
-
-
 def get_login():
     reg = OpenPypeSettingsRegistry()
     try:

From 68941da3c8c08c5995c933d8b21317de6ddb73cc Mon Sep 17 00:00:00 2001
From: Vic Bartel <vbartel@yanport.com>
Date: Fri, 25 Mar 2022 10:33:23 +0100
Subject: [PATCH 0087/1227] Add fixes for hound

---
 .../plugins/publish/collect_shotgrid_entities.py   | 10 ++++------
 .../plugins/publish/collect_shotgrid_session.py    | 14 +++++++-------
 2 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
index b89dda3a80..6778b26550 100644
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
@@ -1,7 +1,9 @@
 import os
+
 import pyblish.api
 from pymongo import MongoClient
-from openpype.api import get_project_settings
+
+from openpype.modules.shotgrid.lib.settings import get_shotgrid_project_settings
 
 
 class CollectShotgridEntities(pyblish.api.ContextPlugin):
@@ -64,12 +66,8 @@ def _get_shotgrid_collection(project):
     return client.get_database("shotgrid_openpype").get_collection(project)
 
 
-def _get_shotgrid_project_settings(project):
-    return get_project_settings(project).get("shotgrid", {})
-
-
 def _get_shotgrid_project(avalon_project):
-    proj_settings = _get_shotgrid_project_settings(avalon_project["name"])
+    proj_settings = get_shotgrid_project_settings(avalon_project["name"])
     shotgrid_project_id = proj_settings.get("shotgrid_project_id")
     if shotgrid_project_id:
         return {"type": "Project", "id": shotgrid_project_id}
diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
index 60071ad2fc..9d5d2271bf 100644
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
@@ -1,10 +1,14 @@
 import os
+
 import pyblish.api
 import shotgun_api3
 from shotgun_api3.shotgun import AuthenticationFault
+
 from openpype.lib import OpenPypeSettingsRegistry
-from openpype.api import get_project_settings, get_system_settings
-from openpype.modules.shotgrid.lib.settings import get_shotgrid_servers
+from openpype.modules.shotgrid.lib.settings import (
+    get_shotgrid_servers,
+    get_shotgrid_project_settings,
+)
 
 
 class CollectShotgridSession(pyblish.api.ContextPlugin):
@@ -40,7 +44,7 @@ class CollectShotgridSession(pyblish.api.ContextPlugin):
 
         avalon_project = os.getenv("AVALON_PROJECT")
 
-        shotgrid_settings = get_shotgrid_settings(avalon_project)
+        shotgrid_settings = get_shotgrid_project_settings(avalon_project)
         self.log.info("shotgrid settings: {}".format(shotgrid_settings))
         shotgrid_servers_settings = get_shotgrid_servers()
         self.log.info(
@@ -111,10 +115,6 @@ def set_shotgrid_certificate(certificate):
     os.environ["SHOTGUN_API_CACERTS"] = certificate
 
 
-def get_shotgrid_settings(project):
-    return get_project_settings(project).get("shotgrid", {})
-
-
 def get_login():
     reg = OpenPypeSettingsRegistry()
     try:

From 1214cb995de0ae33ed52ab788c3df00f4655ac8d Mon Sep 17 00:00:00 2001
From: Vic Bartel <vbartel@yanport.com>
Date: Fri, 25 Mar 2022 10:36:27 +0100
Subject: [PATCH 0088/1227] Remove an empty line

---
 repos/avalon-core | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/repos/avalon-core b/repos/avalon-core
index 2fa14cea6f..2200525320 160000
--- a/repos/avalon-core
+++ b/repos/avalon-core
@@ -1 +1 @@
-Subproject commit 2fa14cea6f6a9d86eec70bbb96860cbe4c75c8eb
+Subproject commit 2200525320923f17df3b4c3b19ebd737c8a7e625

From d106ba4694ab542f4c496d2b1cc2e5d693386657 Mon Sep 17 00:00:00 2001
From: Vic Bartel <vbartel@yanport.com>
Date: Fri, 25 Mar 2022 10:38:12 +0100
Subject: [PATCH 0089/1227] Reformat code after hound barking

---
 .../shotgrid/plugins/publish/collect_shotgrid_entities.py     | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
index 6778b26550..a770c1eb87 100644
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
@@ -3,7 +3,9 @@ import os
 import pyblish.api
 from pymongo import MongoClient
 
-from openpype.modules.shotgrid.lib.settings import get_shotgrid_project_settings
+from openpype.modules.shotgrid.lib.settings import (
+    get_shotgrid_project_settings,
+)
 
 
 class CollectShotgridEntities(pyblish.api.ContextPlugin):

From 3c1ecfb36e1e29a7d3eb0b3845356dd9f8cda155 Mon Sep 17 00:00:00 2001
From: Vic Bartel <vbartel@yanport.com>
Date: Fri, 8 Apr 2022 15:12:29 +0200
Subject: [PATCH 0090/1227] Drawn back to the obsolete version of python

---
 openpype/modules/shotgrid/aop/patch.py        |  11 +-
 openpype/modules/shotgrid/lib/credentials.py  |  30 +-
 openpype/modules/shotgrid/lib/record.py       |  18 +-
 openpype/modules/shotgrid/lib/server.py       |   3 +-
 openpype/modules/shotgrid/lib/settings.py     |  15 +-
 openpype/modules/shotgrid/shotgrid_module.py  |  19 +-
 .../shotgrid/tray/credential_dialog.py        |  37 +-
 .../modules/shotgrid/tray/shotgrid_tray.py    |  11 +-
 poetry.lock                                   | 812 +++++++++---------
 9 files changed, 493 insertions(+), 463 deletions(-)

diff --git a/openpype/modules/shotgrid/aop/patch.py b/openpype/modules/shotgrid/aop/patch.py
index 6ca81033e2..208ca715d3 100644
--- a/openpype/modules/shotgrid/aop/patch.py
+++ b/openpype/modules/shotgrid/aop/patch.py
@@ -1,5 +1,4 @@
 from copy import copy
-from typing import Any, Iterator, Dict, Set
 
 from avalon.api import AvalonMongoDB
 
@@ -14,8 +13,8 @@ _LOG = Logger().get_logger("ShotgridModule.patch")
 
 
 def _patched_projects(
-    self: Any, projection: Any = None, only_active: bool = True
-) -> Iterator[Dict[str, Any]]:
+    self, projection=None, only_active=True
+):
     all_projects = list(self._prev_projects(projection, only_active))
     if (
         not credentials.get_local_login()
@@ -30,18 +29,18 @@ def _patched_projects(
         return all_projects
 
 
-def _upper(x: Any) -> str:
+def _upper(x):
     return str(x).strip().upper()
 
 
-def _fetch_linked_project_names() -> Set[str]:
+def _fetch_linked_project_names():
     return {
         _upper(x["project_name"])
         for x in server.find_linked_projects(credentials.get_local_login())
     }
 
 
-def patch_avalon_db() -> None:
+def patch_avalon_db():
     _LOG.debug("Run avalon patching")
     if AvalonMongoDB.projects is _patched_projects:
         return None
diff --git a/openpype/modules/shotgrid/lib/credentials.py b/openpype/modules/shotgrid/lib/credentials.py
index a334968cda..337c4f6ecb 100644
--- a/openpype/modules/shotgrid/lib/credentials.py
+++ b/openpype/modules/shotgrid/lib/credentials.py
@@ -1,4 +1,4 @@
-from typing import Tuple, Optional
+
 from urllib.parse import urlparse
 
 import shotgun_api3
@@ -8,21 +8,21 @@ from openpype.lib import OpenPypeSecureRegistry, OpenPypeSettingsRegistry
 from openpype.modules.shotgrid.lib.record import Credentials
 
 
-def _get_shotgrid_secure_key(hostname: str, key: str) -> str:
+def _get_shotgrid_secure_key(hostname, key):
     """Secure item key for entered hostname."""
     return f"shotgrid/{hostname}/{key}"
 
 
 def _get_secure_value_and_registry(
-    hostname: str,
-    name: str,
-) -> Tuple[str, OpenPypeSecureRegistry]:
+    hostname,
+    name,
+):
     key = _get_shotgrid_secure_key(hostname, name)
     registry = OpenPypeSecureRegistry(key)
     return registry.get_item(name, None), registry
 
 
-def get_shotgrid_hostname(shotgrid_url: str) -> str:
+def get_shotgrid_hostname(shotgrid_url):
 
     if not shotgrid_url:
         raise Exception("Shotgrid url cannot be a null")
@@ -35,7 +35,7 @@ def get_shotgrid_hostname(shotgrid_url: str) -> str:
 # Credentials storing function (using keyring)
 
 
-def get_credentials(shotgrid_url: str) -> Optional[Credentials]:
+def get_credentials(shotgrid_url):
     hostname = get_shotgrid_hostname(shotgrid_url)
     if not hostname:
         return None
@@ -50,7 +50,7 @@ def get_credentials(shotgrid_url: str) -> Optional[Credentials]:
     return Credentials(login_value, password_value)
 
 
-def save_credentials(login: str, password: str, shotgrid_url: str):
+def save_credentials(login, password, shotgrid_url):
     hostname = get_shotgrid_hostname(shotgrid_url)
     _, login_registry = _get_secure_value_and_registry(
         hostname,
@@ -65,7 +65,7 @@ def save_credentials(login: str, password: str, shotgrid_url: str):
     password_registry.set_item(Credentials.password_key_prefix(), password)
 
 
-def clear_credentials(shotgrid_url: str):
+def clear_credentials(shotgrid_url):
     hostname = get_shotgrid_hostname(shotgrid_url)
     login_value, login_registry = _get_secure_value_and_registry(
         hostname,
@@ -86,7 +86,7 @@ def clear_credentials(shotgrid_url: str):
 # Login storing function (using json)
 
 
-def get_local_login() -> Optional[str]:
+def get_local_login():
     reg = OpenPypeSettingsRegistry()
     try:
         return str(reg.get_item("shotgrid_login"))
@@ -94,7 +94,7 @@ def get_local_login() -> Optional[str]:
         return None
 
 
-def save_local_login(login: str):
+def save_local_login(login):
     reg = OpenPypeSettingsRegistry()
     reg.set_item("shotgrid_login", login)
 
@@ -105,10 +105,10 @@ def clear_local_login():
 
 
 def check_credentials(
-    login: str,
-    password: str,
-    shotgrid_url: str,
-) -> bool:
+    login,
+    password,
+    shotgrid_url,
+):
 
     if not shotgrid_url or not login or not password:
         return False
diff --git a/openpype/modules/shotgrid/lib/record.py b/openpype/modules/shotgrid/lib/record.py
index 1796e6c019..f62f4855d5 100644
--- a/openpype/modules/shotgrid/lib/record.py
+++ b/openpype/modules/shotgrid/lib/record.py
@@ -1,18 +1,20 @@
-from dataclasses import dataclass
 
-
-@dataclass(frozen=True)
 class Credentials:
-    login: str
-    password: str
+    login = None
+    password = None
 
-    def is_empty(self) -> bool:
+    def __init__(self, login, password) -> None:
+        super().__init__()
+        self.login = login
+        self.password = password
+
+    def is_empty(self):
         return not (self.login and self.password)
 
     @staticmethod
-    def login_key_prefix() -> str:
+    def login_key_prefix():
         return "login"
 
     @staticmethod
-    def password_key_prefix() -> str:
+    def password_key_prefix():
         return "password"
diff --git a/openpype/modules/shotgrid/lib/server.py b/openpype/modules/shotgrid/lib/server.py
index 0fe4b8429e..50645d4089 100644
--- a/openpype/modules/shotgrid/lib/server.py
+++ b/openpype/modules/shotgrid/lib/server.py
@@ -1,7 +1,6 @@
 import traceback
 
 import requests
-from typing import Dict, Any, List
 
 from openpype.api import Logger
 from openpype.modules.shotgrid.lib import (
@@ -11,7 +10,7 @@ from openpype.modules.shotgrid.lib import (
 _LOG = Logger().get_logger("ShotgridModule.server")
 
 
-def find_linked_projects(email: str) -> List[Dict[str, Any]]:
+def find_linked_projects(email):
     url = "".join(
         [
             settings_lib.get_leecher_backend_url(),
diff --git a/openpype/modules/shotgrid/lib/settings.py b/openpype/modules/shotgrid/lib/settings.py
index b34407fbf5..954b96f3c2 100644
--- a/openpype/modules/shotgrid/lib/settings.py
+++ b/openpype/modules/shotgrid/lib/settings.py
@@ -1,13 +1,12 @@
 import os
 from functools import lru_cache
-from typing import Tuple, Dict, List, Any
 
 from pymongo import MongoClient
 from openpype.api import get_system_settings, get_project_settings
 from openpype.modules.shotgrid.lib.const import MODULE_NAME
 
 
-def get_project_list() -> List[str]:
+def get_project_list():
     mongo_url = os.getenv("OPENPYPE_MONGO")
     client = MongoClient(mongo_url)
     db = client['avalon']
@@ -15,28 +14,28 @@ def get_project_list() -> List[str]:
 
 
 @lru_cache(maxsize=64)
-def get_shotgrid_project_settings(project: str) -> Dict[str, Any]:
+def get_shotgrid_project_settings(project):
     return get_project_settings(project).get(MODULE_NAME, {})
 
 
 @lru_cache(maxsize=64)
-def get_shotgrid_settings() -> Dict[str, Any]:
+def get_shotgrid_settings():
     return get_system_settings().get("modules", {}).get(MODULE_NAME, {})
 
 
-def get_shotgrid_servers() -> Dict[str, Any]:
+def get_shotgrid_servers():
     return get_shotgrid_settings().get("shotgrid_settings", {})
 
 
-def get_leecher_backend_url() -> str:
+def get_leecher_backend_url():
     return get_shotgrid_settings().get("leecher_backend_url")
 
 
-def filter_projects_by_login() -> bool:
+def filter_projects_by_login():
     return bool(get_shotgrid_settings().get("filter_projects_by_login", False))
 
 
-def get_shotgrid_event_mongo_info() -> Tuple[str, str]:
+def get_shotgrid_event_mongo_info():
     database_name = os.environ["OPENPYPE_DATABASE_NAME"]
     collection_name = "shotgrid_events"
     return database_name, collection_name
diff --git a/openpype/modules/shotgrid/shotgrid_module.py b/openpype/modules/shotgrid/shotgrid_module.py
index 222c4c2e1f..1f05ae5a52 100644
--- a/openpype/modules/shotgrid/shotgrid_module.py
+++ b/openpype/modules/shotgrid/shotgrid_module.py
@@ -1,6 +1,5 @@
 import os
 import threading
-from typing import Optional, Dict, Any
 
 from openpype_interfaces import (
     ITrayModule,
@@ -20,13 +19,13 @@ SHOTGRID_MODULE_DIR = os.path.dirname(os.path.abspath(__file__))
 class ShotgridModule(
     OpenPypeModule, ITrayModule, IPluginPaths, ILaunchHookPaths
 ):
-    leecher_manager_url: str
-    name: str = "shotgrid"
-    enabled: bool = False
-    project_id: Optional[str] = None
-    tray_wrapper: ShotgridTrayWrapper
+    leecher_manager_url = None
+    name = "shotgrid"
+    enabled = False
+    project_id = None
+    tray_wrapper = None
 
-    def initialize(self, modules_settings: Dict[str, Any]):
+    def initialize(self, modules_settings):
         patch_avalon_db()
         threading.Timer(10.0, patch_avalon_db).start()
         shotgrid_settings = modules_settings.get(self.name, dict())
@@ -38,17 +37,17 @@ class ShotgridModule(
     def connect_with_modules(self, enabled_modules):
         pass
 
-    def get_global_environments(self) -> Dict[str, Any]:
+    def get_global_environments(self):
         return {"PROJECT_ID": self.project_id}
 
-    def get_plugin_paths(self) -> Dict[str, Any]:
+    def get_plugin_paths(self):
         return {
             "publish": [
                 os.path.join(SHOTGRID_MODULE_DIR, "plugins", "publish")
             ]
         }
 
-    def get_launch_hook_paths(self) -> str:
+    def get_launch_hook_paths(self):
         return os.path.join(SHOTGRID_MODULE_DIR, "hooks")
 
     def tray_init(self):
diff --git a/openpype/modules/shotgrid/tray/credential_dialog.py b/openpype/modules/shotgrid/tray/credential_dialog.py
index 8d7d587c6a..9d841d98be 100644
--- a/openpype/modules/shotgrid/tray/credential_dialog.py
+++ b/openpype/modules/shotgrid/tray/credential_dialog.py
@@ -1,5 +1,4 @@
 import os
-from typing import Any
 from Qt import QtCore, QtWidgets, QtGui
 
 from openpype import style
@@ -11,20 +10,20 @@ class CredentialsDialog(QtWidgets.QDialog):
     SIZE_W = 450
     SIZE_H = 200
 
-    _module: Any = None
-    _is_logged: bool = False
-    url_label: QtWidgets.QLabel
-    login_label: QtWidgets.QLabel
-    password_label: QtWidgets.QLabel
-    url_input: QtWidgets.QComboBox
-    login_input: QtWidgets.QLineEdit
-    password_input: QtWidgets.QLineEdit
-    input_layout: QtWidgets.QFormLayout
-    login_button: QtWidgets.QPushButton
-    buttons_layout: QtWidgets.QHBoxLayout
-    main_widget: QtWidgets.QVBoxLayout
+    _module = None
+    _is_logged = False
+    url_label = None
+    login_label = None
+    password_label = None
+    url_input = None
+    login_input = None
+    password_input = None
+    input_layout = None
+    login_button = None
+    buttons_layout = None
+    main_widget = None
 
-    login_changed: QtCore.Signal = QtCore.Signal()
+    login_changed = QtCore.Signal()
 
     def __init__(self, module, parent=None):
         super(CredentialsDialog, self).__init__(parent)
@@ -168,7 +167,7 @@ class CredentialsDialog(QtWidgets.QDialog):
         self._clear_shotgrid_login()
         self._on_logout()
 
-    def set_error(self, msg: str):
+    def set_error(self, msg):
         self.error_label.setText(msg)
         self.error_label.show()
 
@@ -184,15 +183,15 @@ class CredentialsDialog(QtWidgets.QDialog):
     def _close_widget(self):
         self.hide()
 
-    def _valid_input(self, input_widget: QtWidgets.QLineEdit):
+    def _valid_input(self, input_widget):
         input_widget.setStyleSheet("")
 
-    def _invalid_input(self, input_widget: QtWidgets.QLineEdit):
+    def _invalid_input(self, input_widget):
         input_widget.setStyleSheet("border: 1px solid red;")
 
     def login_with_credentials(
-        self, url: str, login: str, password: str
-    ) -> bool:
+        self, url, login, password
+    ):
         verification = credentials.check_credentials(url, login, password)
         if verification:
             credentials.save_credentials(login, password, False)
diff --git a/openpype/modules/shotgrid/tray/shotgrid_tray.py b/openpype/modules/shotgrid/tray/shotgrid_tray.py
index 0be58e3b20..4038d77b03 100644
--- a/openpype/modules/shotgrid/tray/shotgrid_tray.py
+++ b/openpype/modules/shotgrid/tray/shotgrid_tray.py
@@ -1,6 +1,5 @@
 import os
 import webbrowser
-from typing import Any
 
 from Qt import QtWidgets
 
@@ -11,11 +10,11 @@ from openpype.modules.shotgrid.tray.credential_dialog import (
 
 
 class ShotgridTrayWrapper:
-    module: Any
-    credentials_dialog: CredentialsDialog
-    logged_user_label: QtWidgets.QAction
+    module = None
+    credentials_dialog = None
+    logged_user_label = None
 
-    def __init__(self, module) -> None:
+    def __init__(self, module):
         self.module = module
         self.credentials_dialog = CredentialsDialog(module)
         self.credentials_dialog.login_changed.connect(self.set_login_label)
@@ -65,7 +64,7 @@ class ShotgridTrayWrapper:
                 )
                 m.addAction(shotgrid_manager_action)
 
-    def validate(self) -> bool:
+    def validate(self):
         login = credentials.get_local_login()
 
         if not login:
diff --git a/poetry.lock b/poetry.lock
index 7998ede693..4372f34ff7 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -94,7 +94,7 @@ python-dateutil = ">=2.7.0"
 
 [[package]]
 name = "astroid"
-version = "2.9.3"
+version = "2.11.2"
 description = "An abstract syntax tree for Python with inference support."
 category = "dev"
 optional = false
@@ -104,7 +104,7 @@ python-versions = ">=3.6.2"
 lazy-object-proxy = ">=1.4.0"
 typed-ast = {version = ">=1.4.0,<2.0", markers = "implementation_name == \"cpython\" and python_version < \"3.8\""}
 typing-extensions = {version = ">=3.10", markers = "python_version < \"3.10\""}
-wrapt = ">=1.11,<1.14"
+wrapt = ">=1.11,<2"
 
 [[package]]
 name = "async-timeout"
@@ -236,7 +236,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
 
 [[package]]
 name = "charset-normalizer"
-version = "2.0.11"
+version = "2.0.12"
 description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet."
 category = "main"
 optional = false
@@ -295,7 +295,7 @@ python-versions = "*"
 
 [[package]]
 name = "coverage"
-version = "6.3.1"
+version = "6.3.2"
 description = "Code coverage measurement for Python"
 category = "dev"
 optional = false
@@ -309,7 +309,7 @@ toml = ["tomli"]
 
 [[package]]
 name = "cryptography"
-version = "36.0.1"
+version = "36.0.2"
 description = "cryptography is a package which provides cryptographic recipes and primitives to Python developers."
 category = "main"
 optional = false
@@ -346,9 +346,20 @@ category = "dev"
 optional = false
 python-versions = "*"
 
+[[package]]
+name = "dill"
+version = "0.3.4"
+description = "serialize all of python"
+category = "dev"
+optional = false
+python-versions = ">=2.7, !=3.0.*"
+
+[package.extras]
+graph = ["objgraph (>=1.7.2)"]
+
 [[package]]
 name = "dnspython"
-version = "2.2.0"
+version = "2.2.1"
 description = "DNS toolkit"
 category = "main"
 optional = false
@@ -364,7 +375,7 @@ wmi = ["wmi (>=1.5.1,<2.0.0)"]
 
 [[package]]
 name = "docutils"
-version = "0.18.1"
+version = "0.17.1"
 description = "Docutils -- Python Documentation Utilities"
 category = "dev"
 optional = false
@@ -372,7 +383,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
 
 [[package]]
 name = "dropbox"
-version = "11.26.0"
+version = "11.29.0"
 description = "Official Dropbox API Client"
 category = "main"
 optional = false
@@ -397,7 +408,7 @@ prefixed = ">=0.3.2"
 
 [[package]]
 name = "evdev"
-version = "1.4.0"
+version = "1.5.0"
 description = "Bindings to the Linux input handling subsystem"
 category = "main"
 optional = false
@@ -464,7 +475,7 @@ smmap = ">=3.0.1,<6"
 
 [[package]]
 name = "gitpython"
-version = "3.1.26"
+version = "3.1.27"
 description = "GitPython is a python library used to interact with Git repositories"
 category = "dev"
 optional = false
@@ -476,7 +487,7 @@ typing-extensions = {version = ">=3.7.4.3", markers = "python_version < \"3.8\""
 
 [[package]]
 name = "google-api-core"
-version = "2.4.0"
+version = "2.7.1"
 description = "Google API client core library"
 category = "main"
 optional = false
@@ -495,7 +506,7 @@ grpcio-gcp = ["grpcio-gcp (>=0.2.2)"]
 
 [[package]]
 name = "google-api-python-client"
-version = "1.12.10"
+version = "1.12.11"
 description = "Google API Client Library for Python"
 category = "main"
 optional = false
@@ -511,7 +522,7 @@ uritemplate = ">=3.0.0,<4dev"
 
 [[package]]
 name = "google-auth"
-version = "2.6.0"
+version = "2.6.3"
 description = "Google Authentication Library"
 category = "main"
 optional = false
@@ -543,7 +554,7 @@ six = "*"
 
 [[package]]
 name = "googleapis-common-protos"
-version = "1.54.0"
+version = "1.56.0"
 description = "Common protobufs used in Google APIs"
 category = "main"
 optional = false
@@ -557,7 +568,7 @@ grpc = ["grpcio (>=1.0.0)"]
 
 [[package]]
 name = "httplib2"
-version = "0.20.2"
+version = "0.20.4"
 description = "A comprehensive HTTP client library."
 category = "main"
 optional = false
@@ -584,7 +595,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "importlib-metadata"
-version = "4.10.1"
+version = "4.11.3"
 description = "Read metadata from Python packages"
 category = "main"
 optional = false
@@ -595,9 +606,9 @@ typing-extensions = {version = ">=3.6.4", markers = "python_version < \"3.8\""}
 zipp = ">=0.5"
 
 [package.extras]
-docs = ["sphinx", "jaraco.packaging (>=8.2)", "rst.linker (>=1.9)"]
+docs = ["sphinx", "jaraco.packaging (>=9)", "rst.linker (>=1.9)"]
 perf = ["ipython"]
-testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "packaging", "pyfakefs", "flufl.flake8", "pytest-perf (>=0.9.2)", "pytest-black (>=0.3.7)", "pytest-mypy", "importlib-resources (>=1.3)"]
+testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "packaging", "pyfakefs", "flufl.flake8", "pytest-perf (>=0.9.2)", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)", "importlib-resources (>=1.3)"]
 
 [[package]]
 name = "iniconfig"
@@ -637,14 +648,14 @@ testing = ["colorama", "docopt", "pytest (>=3.1.0)"]
 
 [[package]]
 name = "jeepney"
-version = "0.7.1"
+version = "0.8.0"
 description = "Low-level, pure Python DBus protocol wrapper."
 category = "main"
 optional = false
-python-versions = ">=3.6"
+python-versions = ">=3.7"
 
 [package.extras]
-test = ["pytest", "pytest-trio", "pytest-asyncio", "testpath", "trio", "async-timeout"]
+test = ["pytest", "pytest-trio", "pytest-asyncio (>=0.17)", "testpath", "trio", "async-timeout"]
 trio = ["trio", "async-generator"]
 
 [[package]]
@@ -722,11 +733,11 @@ pymongo = "*"
 
 [[package]]
 name = "markupsafe"
-version = "2.0.1"
+version = "2.1.1"
 description = "Safely add untrusted strings to HTML/XML markup."
 category = "dev"
 optional = false
-python-versions = ">=3.6"
+python-versions = ">=3.7"
 
 [[package]]
 name = "mccabe"
@@ -777,7 +788,7 @@ pyparsing = ">=2.0.2,<3.0.5 || >3.0.5"
 
 [[package]]
 name = "paramiko"
-version = "2.10.1"
+version = "2.10.3"
 description = "SSH2 protocol library"
 category = "main"
 optional = false
@@ -809,7 +820,7 @@ testing = ["docopt", "pytest (<6.0.0)"]
 
 [[package]]
 name = "pathlib2"
-version = "2.3.6"
+version = "2.3.7.post1"
 description = "Object-oriented filesystem paths"
 category = "main"
 optional = false
@@ -820,15 +831,19 @@ six = "*"
 
 [[package]]
 name = "pillow"
-version = "9.0.0"
+version = "9.1.0"
 description = "Python Imaging Library (Fork)"
 category = "main"
 optional = false
 python-versions = ">=3.7"
 
+[package.extras]
+docs = ["olefile", "sphinx (>=2.4)", "sphinx-copybutton", "sphinx-issues (>=3.0.1)", "sphinx-removed-in", "sphinx-rtd-theme (>=1.0)", "sphinxext-opengraph"]
+tests = ["check-manifest", "coverage", "defusedxml", "markdown2", "olefile", "packaging", "pyroma", "pytest", "pytest-cov", "pytest-timeout"]
+
 [[package]]
 name = "platformdirs"
-version = "2.4.1"
+version = "2.5.1"
 description = "A small Python module for determining appropriate platform-specific dirs, e.g. a \"user data dir\"."
 category = "dev"
 optional = false
@@ -871,11 +886,11 @@ python-versions = "*"
 
 [[package]]
 name = "protobuf"
-version = "3.19.4"
+version = "3.20.0"
 description = "Protocol Buffers"
 category = "main"
 optional = false
-python-versions = ">=3.5"
+python-versions = ">=3.7"
 
 [[package]]
 name = "py"
@@ -966,21 +981,25 @@ python-versions = ">=3.5"
 
 [[package]]
 name = "pylint"
-version = "2.12.2"
+version = "2.13.5"
 description = "python code static checker"
 category = "dev"
 optional = false
 python-versions = ">=3.6.2"
 
 [package.dependencies]
-astroid = ">=2.9.0,<2.10"
+astroid = ">=2.11.2,<=2.12.0-dev0"
 colorama = {version = "*", markers = "sys_platform == \"win32\""}
+dill = ">=0.2"
 isort = ">=4.2.5,<6"
-mccabe = ">=0.6,<0.7"
+mccabe = ">=0.6,<0.8"
 platformdirs = ">=2.2.0"
-toml = ">=0.9.2"
+tomli = {version = ">=1.1.0", markers = "python_version < \"3.11\""}
 typing-extensions = {version = ">=3.10.0", markers = "python_version < \"3.10\""}
 
+[package.extras]
+testutil = ["gitpython (>3)"]
+
 [[package]]
 name = "pymongo"
 version = "3.12.3"
@@ -1031,7 +1050,7 @@ six = "*"
 
 [[package]]
 name = "pyobjc-core"
-version = "8.2"
+version = "8.4.1"
 description = "Python<->ObjC Interoperability Module"
 category = "main"
 optional = false
@@ -1039,39 +1058,39 @@ python-versions = ">=3.6"
 
 [[package]]
 name = "pyobjc-framework-applicationservices"
-version = "8.2"
+version = "8.4.1"
 description = "Wrappers for the framework ApplicationServices on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.2"
-pyobjc-framework-Cocoa = ">=8.2"
-pyobjc-framework-Quartz = ">=8.2"
+pyobjc-core = ">=8.4.1"
+pyobjc-framework-Cocoa = ">=8.4.1"
+pyobjc-framework-Quartz = ">=8.4.1"
 
 [[package]]
 name = "pyobjc-framework-cocoa"
-version = "8.2"
+version = "8.4.1"
 description = "Wrappers for the Cocoa frameworks on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.2"
+pyobjc-core = ">=8.4.1"
 
 [[package]]
 name = "pyobjc-framework-quartz"
-version = "8.2"
+version = "8.4.1"
 description = "Wrappers for the Quartz frameworks on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.2"
-pyobjc-framework-Cocoa = ">=8.2"
+pyobjc-core = ">=8.4.1"
+pyobjc-framework-Cocoa = ">=8.4.1"
 
 [[package]]
 name = "pyparsing"
@@ -1175,7 +1194,7 @@ python-versions = "*"
 
 [[package]]
 name = "pytz"
-version = "2021.3"
+version = "2022.1"
 description = "World timezone definitions, modern and historical"
 category = "dev"
 optional = false
@@ -1287,6 +1306,21 @@ category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
+[[package]]
+name = "shotgun-api3"
+version = "3.3.3"
+description = "Shotgun Python API"
+category = "main"
+optional = false
+python-versions = "*"
+develop = false
+
+[package.source]
+type = "git"
+url = "https://github.com/shotgunsoftware/python-api.git"
+reference = "v3.3.3"
+resolved_reference = "b9f066c0edbea6e0733242e18f32f75489064840"
+
 [[package]]
 name = "six"
 version = "1.16.0"
@@ -1297,7 +1331,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*"
 
 [[package]]
 name = "slack-sdk"
-version = "3.13.0"
+version = "3.15.2"
 description = "The Slack API Platform SDK for Python"
 category = "main"
 optional = false
@@ -1305,7 +1339,7 @@ python-versions = ">=3.6.0"
 
 [package.extras]
 optional = ["aiodns (>1.0)", "aiohttp (>=3.7.3,<4)", "boto3 (<=2)", "SQLAlchemy (>=1,<2)", "websockets (>=10,<11)", "websocket-client (>=1,<2)"]
-testing = ["pytest (>=6.2.5,<7)", "pytest-asyncio (<1)", "Flask-Sockets (>=0.2,<1)", "Flask (>=1,<2)", "Werkzeug (<2)", "pytest-cov (>=2,<3)", "codecov (>=2,<3)", "flake8 (>=4,<5)", "black (==21.12b0)", "psutil (>=5,<6)", "databases (>=0.3)", "boto3 (<=2)", "moto (<2)"]
+testing = ["pytest (>=6.2.5,<7)", "pytest-asyncio (<1)", "Flask-Sockets (>=0.2,<1)", "Flask (>=1,<2)", "Werkzeug (<2)", "itsdangerous (==2.0.1)", "pytest-cov (>=2,<3)", "codecov (>=2,<3)", "flake8 (>=4,<5)", "black (==22.1.0)", "psutil (>=5,<6)", "databases (>=0.5)", "boto3 (<=2)", "moto (>=3,<4)"]
 
 [[package]]
 name = "smmap"
@@ -1325,7 +1359,7 @@ python-versions = "*"
 
 [[package]]
 name = "speedcopy"
-version = "2.1.2"
+version = "2.1.3"
 description = "Replacement or alternative for python copyfile() utilizing server side copy on network shares for faster copying."
 category = "main"
 optional = false
@@ -1333,18 +1367,19 @@ python-versions = "*"
 
 [[package]]
 name = "sphinx"
-version = "3.5.3"
+version = "4.5.0"
 description = "Python documentation generator"
 category = "dev"
 optional = false
-python-versions = ">=3.5"
+python-versions = ">=3.6"
 
 [package.dependencies]
 alabaster = ">=0.7,<0.8"
 babel = ">=1.3"
 colorama = {version = ">=0.3.5", markers = "sys_platform == \"win32\""}
-docutils = ">=0.12"
+docutils = ">=0.14,<0.18"
 imagesize = "*"
+importlib-metadata = {version = ">=4.4", markers = "python_version < \"3.10\""}
 Jinja2 = ">=2.3"
 packaging = "*"
 Pygments = ">=2.0"
@@ -1352,19 +1387,19 @@ requests = ">=2.5.0"
 snowballstemmer = ">=1.1"
 sphinxcontrib-applehelp = "*"
 sphinxcontrib-devhelp = "*"
-sphinxcontrib-htmlhelp = "*"
+sphinxcontrib-htmlhelp = ">=2.0.0"
 sphinxcontrib-jsmath = "*"
 sphinxcontrib-qthelp = "*"
-sphinxcontrib-serializinghtml = "*"
+sphinxcontrib-serializinghtml = ">=1.1.5"
 
 [package.extras]
 docs = ["sphinxcontrib-websupport"]
-lint = ["flake8 (>=3.5.0)", "isort", "mypy (>=0.800)", "docutils-stubs"]
+lint = ["flake8 (>=3.5.0)", "isort", "mypy (>=0.931)", "docutils-stubs", "types-typed-ast", "types-requests"]
 test = ["pytest", "pytest-cov", "html5lib", "cython", "typed-ast"]
 
 [[package]]
 name = "sphinx-qt-documentation"
-version = "0.3"
+version = "0.4"
 description = "Plugin for proper resolve intersphinx references for Qt elements"
 category = "dev"
 optional = false
@@ -1374,16 +1409,22 @@ python-versions = ">=3.6"
 docutils = "*"
 sphinx = "*"
 
+[package.extras]
+dev = ["pre-commit"]
+lint = ["black", "flake8", "pylint"]
+test = ["pytest (>=3.0.0)", "pytest-cov"]
+
 [[package]]
 name = "sphinx-rtd-theme"
-version = "0.5.1"
+version = "1.0.0"
 description = "Read the Docs theme for Sphinx"
 category = "dev"
 optional = false
-python-versions = "*"
+python-versions = ">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*"
 
 [package.dependencies]
-sphinx = "*"
+docutils = "<0.18"
+sphinx = ">=1.6"
 
 [package.extras]
 dev = ["transifex-client", "sphinxcontrib-httpdomain", "bump2version"]
@@ -1504,7 +1545,7 @@ python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*"
 
 [[package]]
 name = "tomli"
-version = "2.0.0"
+version = "2.0.1"
 description = "A lil' TOML parser"
 category = "dev"
 optional = false
@@ -1520,7 +1561,7 @@ python-versions = ">=3.6"
 
 [[package]]
 name = "typing-extensions"
-version = "4.0.1"
+version = "4.1.1"
 description = "Backported and Experimental Type Hints for Python 3.6+"
 category = "main"
 optional = false
@@ -1536,14 +1577,14 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "urllib3"
-version = "1.26.8"
+version = "1.26.9"
 description = "HTTP library with thread-safe connection pooling, file post, and more."
 category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, <4"
 
 [package.extras]
-brotli = ["brotlipy (>=0.6.0)"]
+brotli = ["brotlicffi (>=0.8.0)", "brotli (>=1.0.9)", "brotlipy (>=0.6.0)"]
 secure = ["pyOpenSSL (>=0.14)", "cryptography (>=1.3.4)", "idna (>=2.0.0)", "certifi", "ipaddress"]
 socks = ["PySocks (>=1.5.6,!=1.5.7,<2.0)"]
 
@@ -1568,7 +1609,7 @@ six = "*"
 
 [[package]]
 name = "wrapt"
-version = "1.13.3"
+version = "1.14.0"
 description = "Module for decorators, wrappers and monkey patching."
 category = "dev"
 optional = false
@@ -1606,20 +1647,20 @@ typing-extensions = {version = ">=3.7.4", markers = "python_version < \"3.8\""}
 
 [[package]]
 name = "zipp"
-version = "3.7.0"
+version = "3.8.0"
 description = "Backport of pathlib-compatible object wrapper for zip files"
 category = "main"
 optional = false
 python-versions = ">=3.7"
 
 [package.extras]
-docs = ["sphinx", "jaraco.packaging (>=8.2)", "rst.linker (>=1.9)"]
-testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "jaraco.itertools", "func-timeout", "pytest-black (>=0.3.7)", "pytest-mypy"]
+docs = ["sphinx", "jaraco.packaging (>=9)", "rst.linker (>=1.9)"]
+testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "jaraco.itertools", "func-timeout", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)"]
 
 [metadata]
 lock-version = "1.1"
 python-versions = "3.7.*"
-content-hash = "b02313c8255a1897b0f0617ad4884a5943696c363512921aab1cb2dd8f4fdbe0"
+content-hash = "5df45b7a0d0505ca0db8e62f5a4e945601c53908c54ab752d5362552596bd69c"
 
 [metadata.files]
 acre = []
@@ -1722,8 +1763,8 @@ arrow = [
     {file = "arrow-0.17.0.tar.gz", hash = "sha256:ff08d10cda1d36c68657d6ad20d74fbea493d980f8b2d45344e00d6ed2bf6ed4"},
 ]
 astroid = [
-    {file = "astroid-2.9.3-py3-none-any.whl", hash = "sha256:506daabe5edffb7e696ad82483ad0228245a9742ed7d2d8c9cdb31537decf9f6"},
-    {file = "astroid-2.9.3.tar.gz", hash = "sha256:1efdf4e867d4d8ba4a9f6cf9ce07cd182c4c41de77f23814feb27ca93ca9d877"},
+    {file = "astroid-2.11.2-py3-none-any.whl", hash = "sha256:cc8cc0d2d916c42d0a7c476c57550a4557a083081976bf42a73414322a6411d9"},
+    {file = "astroid-2.11.2.tar.gz", hash = "sha256:8d0a30fe6481ce919f56690076eafbb2fb649142a89dc874f1ec0e7a011492d0"},
 ]
 async-timeout = [
     {file = "async-timeout-4.0.2.tar.gz", hash = "sha256:2163e1640ddb52b7a8c80d0a67a08587e5d245cc9c553a74a847056bc2976b15"},
@@ -1830,8 +1871,8 @@ chardet = [
     {file = "chardet-4.0.0.tar.gz", hash = "sha256:0d6f53a15db4120f2b08c94f11e7d93d2c911ee118b6b30a04ec3ee8310179fa"},
 ]
 charset-normalizer = [
-    {file = "charset-normalizer-2.0.11.tar.gz", hash = "sha256:98398a9d69ee80548c762ba991a4728bfc3836768ed226b3945908d1a688371c"},
-    {file = "charset_normalizer-2.0.11-py3-none-any.whl", hash = "sha256:2842d8f5e82a1f6aa437380934d5e1cd4fcf2003b06fed6940769c164a480a45"},
+    {file = "charset-normalizer-2.0.12.tar.gz", hash = "sha256:2857e29ff0d34db842cd7ca3230549d1a697f96ee6d3fb071cfa6c7393832597"},
+    {file = "charset_normalizer-2.0.12-py3-none-any.whl", hash = "sha256:6881edbebdb17b39b4eaaa821b438bf6eddffb4468cf344f09f89def34a8b1df"},
 ]
 click = [
     {file = "click-7.1.2-py2.py3-none-any.whl", hash = "sha256:dacca89f4bfadd5de3d7489b7c8a566eee0d3676333fbb50030263894c38c0dc"},
@@ -1854,69 +1895,69 @@ coolname = [
     {file = "coolname-1.1.0.tar.gz", hash = "sha256:410fe6ea9999bf96f2856ef0c726d5f38782bbefb7bb1aca0e91e0dc98ed09e3"},
 ]
 coverage = [
-    {file = "coverage-6.3.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:eeffd96882d8c06d31b65dddcf51db7c612547babc1c4c5db6a011abe9798525"},
-    {file = "coverage-6.3.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:621f6ea7260ea2ffdaec64fe5cb521669984f567b66f62f81445221d4754df4c"},
-    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:84f2436d6742c01136dd940ee158bfc7cf5ced3da7e4c949662b8703b5cd8145"},
-    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:de73fca6fb403dd72d4da517cfc49fcf791f74eee697d3219f6be29adf5af6ce"},
-    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:78fbb2be068a13a5d99dce9e1e7d168db880870f7bc73f876152130575bd6167"},
-    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:f5a4551dfd09c3bd12fca8144d47fe7745275adf3229b7223c2f9e29a975ebda"},
-    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:7bff3a98f63b47464480de1b5bdd80c8fade0ba2832c9381253c9b74c4153c27"},
-    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:a06c358f4aed05fa1099c39decc8022261bb07dfadc127c08cfbd1391b09689e"},
-    {file = "coverage-6.3.1-cp310-cp310-win32.whl", hash = "sha256:9fff3ff052922cb99f9e52f63f985d4f7a54f6b94287463bc66b7cdf3eb41217"},
-    {file = "coverage-6.3.1-cp310-cp310-win_amd64.whl", hash = "sha256:276b13cc085474e482566c477c25ed66a097b44c6e77132f3304ac0b039f83eb"},
-    {file = "coverage-6.3.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:56c4a409381ddd7bbff134e9756077860d4e8a583d310a6f38a2315b9ce301d0"},
-    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9eb494070aa060ceba6e4bbf44c1bc5fa97bfb883a0d9b0c9049415f9e944793"},
-    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5e15d424b8153756b7c903bde6d4610be0c3daca3986173c18dd5c1a1625e4cd"},
-    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:61d47a897c1e91f33f177c21de897267b38fbb45f2cd8e22a710bcef1df09ac1"},
-    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:25e73d4c81efa8ea3785274a2f7f3bfbbeccb6fcba2a0bdd3be9223371c37554"},
-    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:fac0bcc5b7e8169bffa87f0dcc24435446d329cbc2b5486d155c2e0f3b493ae1"},
-    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:72128176fea72012063200b7b395ed8a57849282b207321124d7ff14e26988e8"},
-    {file = "coverage-6.3.1-cp37-cp37m-win32.whl", hash = "sha256:1bc6d709939ff262fd1432f03f080c5042dc6508b6e0d3d20e61dd045456a1a0"},
-    {file = "coverage-6.3.1-cp37-cp37m-win_amd64.whl", hash = "sha256:618eeba986cea7f621d8607ee378ecc8c2504b98b3fdc4952b30fe3578304687"},
-    {file = "coverage-6.3.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:d5ed164af5c9078596cfc40b078c3b337911190d3faeac830c3f1274f26b8320"},
-    {file = "coverage-6.3.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:352c68e233409c31048a3725c446a9e48bbff36e39db92774d4f2380d630d8f8"},
-    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:448d7bde7ceb6c69e08474c2ddbc5b4cd13c9e4aa4a717467f716b5fc938a734"},
-    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9fde6b90889522c220dd56a670102ceef24955d994ff7af2cb786b4ba8fe11e4"},
-    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e647a0be741edbb529a72644e999acb09f2ad60465f80757da183528941ff975"},
-    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:6a5cdc3adb4f8bb8d8f5e64c2e9e282bc12980ef055ec6da59db562ee9bdfefa"},
-    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:2dd70a167843b4b4b2630c0c56f1b586fe965b4f8ac5da05b6690344fd065c6b"},
-    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:9ad0a117b8dc2061ce9461ea4c1b4799e55edceb236522c5b8f958ce9ed8fa9a"},
-    {file = "coverage-6.3.1-cp38-cp38-win32.whl", hash = "sha256:e92c7a5f7d62edff50f60a045dc9542bf939758c95b2fcd686175dd10ce0ed10"},
-    {file = "coverage-6.3.1-cp38-cp38-win_amd64.whl", hash = "sha256:482fb42eea6164894ff82abbcf33d526362de5d1a7ed25af7ecbdddd28fc124f"},
-    {file = "coverage-6.3.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:c5b81fb37db76ebea79aa963b76d96ff854e7662921ce742293463635a87a78d"},
-    {file = "coverage-6.3.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:a4f923b9ab265136e57cc14794a15b9dcea07a9c578609cd5dbbfff28a0d15e6"},
-    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:56d296cbc8254a7dffdd7bcc2eb70be5a233aae7c01856d2d936f5ac4e8ac1f1"},
-    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1245ab82e8554fa88c4b2ab1e098ae051faac5af829efdcf2ce6b34dccd5567c"},
-    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f2b05757c92ad96b33dbf8e8ec8d4ccb9af6ae3c9e9bd141c7cc44d20c6bcba"},
-    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:9e3dd806f34de38d4c01416344e98eab2437ac450b3ae39c62a0ede2f8b5e4ed"},
-    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:d651fde74a4d3122e5562705824507e2f5b2d3d57557f1916c4b27635f8fbe3f"},
-    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:704f89b87c4f4737da2860695a18c852b78ec7279b24eedacab10b29067d3a38"},
-    {file = "coverage-6.3.1-cp39-cp39-win32.whl", hash = "sha256:2aed4761809640f02e44e16b8b32c1a5dee5e80ea30a0ff0912158bde9c501f2"},
-    {file = "coverage-6.3.1-cp39-cp39-win_amd64.whl", hash = "sha256:9976fb0a5709988778ac9bc44f3d50fccd989987876dfd7716dee28beed0a9fa"},
-    {file = "coverage-6.3.1-pp36.pp37.pp38-none-any.whl", hash = "sha256:463e52616ea687fd323888e86bf25e864a3cc6335a043fad6bbb037dbf49bbe2"},
-    {file = "coverage-6.3.1.tar.gz", hash = "sha256:6c3f6158b02ac403868eea390930ae64e9a9a2a5bbfafefbb920d29258d9f2f8"},
+    {file = "coverage-6.3.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:9b27d894748475fa858f9597c0ee1d4829f44683f3813633aaf94b19cb5453cf"},
+    {file = "coverage-6.3.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:37d1141ad6b2466a7b53a22e08fe76994c2d35a5b6b469590424a9953155afac"},
+    {file = "coverage-6.3.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f9987b0354b06d4df0f4d3e0ec1ae76d7ce7cbca9a2f98c25041eb79eec766f1"},
+    {file = "coverage-6.3.2-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:26e2deacd414fc2f97dd9f7676ee3eaecd299ca751412d89f40bc01557a6b1b4"},
+    {file = "coverage-6.3.2-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4dd8bafa458b5c7d061540f1ee9f18025a68e2d8471b3e858a9dad47c8d41903"},
+    {file = "coverage-6.3.2-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:46191097ebc381fbf89bdce207a6c107ac4ec0890d8d20f3360345ff5976155c"},
+    {file = "coverage-6.3.2-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:6f89d05e028d274ce4fa1a86887b071ae1755082ef94a6740238cd7a8178804f"},
+    {file = "coverage-6.3.2-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:58303469e9a272b4abdb9e302a780072c0633cdcc0165db7eec0f9e32f901e05"},
+    {file = "coverage-6.3.2-cp310-cp310-win32.whl", hash = "sha256:2fea046bfb455510e05be95e879f0e768d45c10c11509e20e06d8fcaa31d9e39"},
+    {file = "coverage-6.3.2-cp310-cp310-win_amd64.whl", hash = "sha256:a2a8b8bcc399edb4347a5ca8b9b87e7524c0967b335fbb08a83c8421489ddee1"},
+    {file = "coverage-6.3.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:f1555ea6d6da108e1999b2463ea1003fe03f29213e459145e70edbaf3e004aaa"},
+    {file = "coverage-6.3.2-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e5f4e1edcf57ce94e5475fe09e5afa3e3145081318e5fd1a43a6b4539a97e518"},
+    {file = "coverage-6.3.2-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7a15dc0a14008f1da3d1ebd44bdda3e357dbabdf5a0b5034d38fcde0b5c234b7"},
+    {file = "coverage-6.3.2-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:21b7745788866028adeb1e0eca3bf1101109e2dc58456cb49d2d9b99a8c516e6"},
+    {file = "coverage-6.3.2-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:8ce257cac556cb03be4a248d92ed36904a59a4a5ff55a994e92214cde15c5bad"},
+    {file = "coverage-6.3.2-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:b0be84e5a6209858a1d3e8d1806c46214e867ce1b0fd32e4ea03f4bd8b2e3359"},
+    {file = "coverage-6.3.2-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:acf53bc2cf7282ab9b8ba346746afe703474004d9e566ad164c91a7a59f188a4"},
+    {file = "coverage-6.3.2-cp37-cp37m-win32.whl", hash = "sha256:8bdde1177f2311ee552f47ae6e5aa7750c0e3291ca6b75f71f7ffe1f1dab3dca"},
+    {file = "coverage-6.3.2-cp37-cp37m-win_amd64.whl", hash = "sha256:b31651d018b23ec463e95cf10070d0b2c548aa950a03d0b559eaa11c7e5a6fa3"},
+    {file = "coverage-6.3.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:07e6db90cd9686c767dcc593dff16c8c09f9814f5e9c51034066cad3373b914d"},
+    {file = "coverage-6.3.2-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:2c6dbb42f3ad25760010c45191e9757e7dce981cbfb90e42feef301d71540059"},
+    {file = "coverage-6.3.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c76aeef1b95aff3905fb2ae2d96e319caca5b76fa41d3470b19d4e4a3a313512"},
+    {file = "coverage-6.3.2-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:8cf5cfcb1521dc3255d845d9dca3ff204b3229401994ef8d1984b32746bb45ca"},
+    {file = "coverage-6.3.2-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8fbbdc8d55990eac1b0919ca69eb5a988a802b854488c34b8f37f3e2025fa90d"},
+    {file = "coverage-6.3.2-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:ec6bc7fe73a938933d4178c9b23c4e0568e43e220aef9472c4f6044bfc6dd0f0"},
+    {file = "coverage-6.3.2-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:9baff2a45ae1f17c8078452e9e5962e518eab705e50a0aa8083733ea7d45f3a6"},
+    {file = "coverage-6.3.2-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:fd9e830e9d8d89b20ab1e5af09b32d33e1a08ef4c4e14411e559556fd788e6b2"},
+    {file = "coverage-6.3.2-cp38-cp38-win32.whl", hash = "sha256:f7331dbf301b7289013175087636bbaf5b2405e57259dd2c42fdcc9fcc47325e"},
+    {file = "coverage-6.3.2-cp38-cp38-win_amd64.whl", hash = "sha256:68353fe7cdf91f109fc7d474461b46e7f1f14e533e911a2a2cbb8b0fc8613cf1"},
+    {file = "coverage-6.3.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:b78e5afb39941572209f71866aa0b206c12f0109835aa0d601e41552f9b3e620"},
+    {file = "coverage-6.3.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:4e21876082ed887baed0146fe222f861b5815455ada3b33b890f4105d806128d"},
+    {file = "coverage-6.3.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:34626a7eee2a3da12af0507780bb51eb52dca0e1751fd1471d0810539cefb536"},
+    {file = "coverage-6.3.2-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1ebf730d2381158ecf3dfd4453fbca0613e16eaa547b4170e2450c9707665ce7"},
+    {file = "coverage-6.3.2-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dd6fe30bd519694b356cbfcaca9bd5c1737cddd20778c6a581ae20dc8c04def2"},
+    {file = "coverage-6.3.2-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:96f8a1cb43ca1422f36492bebe63312d396491a9165ed3b9231e778d43a7fca4"},
+    {file = "coverage-6.3.2-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:dd035edafefee4d573140a76fdc785dc38829fe5a455c4bb12bac8c20cfc3d69"},
+    {file = "coverage-6.3.2-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5ca5aeb4344b30d0bec47481536b8ba1181d50dbe783b0e4ad03c95dc1296684"},
+    {file = "coverage-6.3.2-cp39-cp39-win32.whl", hash = "sha256:f5fa5803f47e095d7ad8443d28b01d48c0359484fec1b9d8606d0e3282084bc4"},
+    {file = "coverage-6.3.2-cp39-cp39-win_amd64.whl", hash = "sha256:9548f10d8be799551eb3a9c74bbf2b4934ddb330e08a73320123c07f95cc2d92"},
+    {file = "coverage-6.3.2-pp36.pp37.pp38-none-any.whl", hash = "sha256:18d520c6860515a771708937d2f78f63cc47ab3b80cb78e86573b0a760161faf"},
+    {file = "coverage-6.3.2.tar.gz", hash = "sha256:03e2a7826086b91ef345ff18742ee9fc47a6839ccd517061ef8fa1976e652ce9"},
 ]
 cryptography = [
-    {file = "cryptography-36.0.1-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:73bc2d3f2444bcfeac67dd130ff2ea598ea5f20b40e36d19821b4df8c9c5037b"},
-    {file = "cryptography-36.0.1-cp36-abi3-macosx_10_10_x86_64.whl", hash = "sha256:2d87cdcb378d3cfed944dac30596da1968f88fb96d7fc34fdae30a99054b2e31"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:74d6c7e80609c0f4c2434b97b80c7f8fdfaa072ca4baab7e239a15d6d70ed73a"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:6c0c021f35b421ebf5976abf2daacc47e235f8b6082d3396a2fe3ccd537ab173"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5d59a9d55027a8b88fd9fd2826c4392bd487d74bf628bb9d39beecc62a644c12"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0a817b961b46894c5ca8a66b599c745b9a3d9f822725221f0e0fe49dc043a3a3"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_24_x86_64.whl", hash = "sha256:94ae132f0e40fe48f310bba63f477f14a43116f05ddb69d6fa31e93f05848ae2"},
-    {file = "cryptography-36.0.1-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:7be0eec337359c155df191d6ae00a5e8bbb63933883f4f5dffc439dac5348c3f"},
-    {file = "cryptography-36.0.1-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:e0344c14c9cb89e76eb6a060e67980c9e35b3f36691e15e1b7a9e58a0a6c6dc3"},
-    {file = "cryptography-36.0.1-cp36-abi3-win32.whl", hash = "sha256:4caa4b893d8fad33cf1964d3e51842cd78ba87401ab1d2e44556826df849a8ca"},
-    {file = "cryptography-36.0.1-cp36-abi3-win_amd64.whl", hash = "sha256:391432971a66cfaf94b21c24ab465a4cc3e8bf4a939c1ca5c3e3a6e0abebdbcf"},
-    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:bb5829d027ff82aa872d76158919045a7c1e91fbf241aec32cb07956e9ebd3c9"},
-    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ebc15b1c22e55c4d5566e3ca4db8689470a0ca2babef8e3a9ee057a8b82ce4b1"},
-    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:596f3cd67e1b950bc372c33f1a28a0692080625592ea6392987dba7f09f17a94"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:30ee1eb3ebe1644d1c3f183d115a8c04e4e603ed6ce8e394ed39eea4a98469ac"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:ec63da4e7e4a5f924b90af42eddf20b698a70e58d86a72d943857c4c6045b3ee"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ca238ceb7ba0bdf6ce88c1b74a87bffcee5afbfa1e41e173b1ceb095b39add46"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:ca28641954f767f9822c24e927ad894d45d5a1e501767599647259cbf030b903"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:39bdf8e70eee6b1c7b289ec6e5d84d49a6bfa11f8b8646b5b3dfe41219153316"},
-    {file = "cryptography-36.0.1.tar.gz", hash = "sha256:53e5c1dc3d7a953de055d77bef2ff607ceef7a2aac0353b5d630ab67f7423638"},
+    {file = "cryptography-36.0.2-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:4e2dddd38a5ba733be6a025a1475a9f45e4e41139d1321f412c6b360b19070b6"},
+    {file = "cryptography-36.0.2-cp36-abi3-macosx_10_10_x86_64.whl", hash = "sha256:4881d09298cd0b669bb15b9cfe6166f16fc1277b4ed0d04a22f3d6430cb30f1d"},
+    {file = "cryptography-36.0.2-cp36-abi3-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:ea634401ca02367c1567f012317502ef3437522e2fc44a3ea1844de028fa4b84"},
+    {file = "cryptography-36.0.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:7be666cc4599b415f320839e36367b273db8501127b38316f3b9f22f17a0b815"},
+    {file = "cryptography-36.0.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8241cac0aae90b82d6b5c443b853723bcc66963970c67e56e71a2609dc4b5eaf"},
+    {file = "cryptography-36.0.2-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7b2d54e787a884ffc6e187262823b6feb06c338084bbe80d45166a1cb1c6c5bf"},
+    {file = "cryptography-36.0.2-cp36-abi3-manylinux_2_24_x86_64.whl", hash = "sha256:c2c5250ff0d36fd58550252f54915776940e4e866f38f3a7866d92b32a654b86"},
+    {file = "cryptography-36.0.2-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:ec6597aa85ce03f3e507566b8bcdf9da2227ec86c4266bd5e6ab4d9e0cc8dab2"},
+    {file = "cryptography-36.0.2-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:ca9f686517ec2c4a4ce930207f75c00bf03d94e5063cbc00a1dc42531511b7eb"},
+    {file = "cryptography-36.0.2-cp36-abi3-win32.whl", hash = "sha256:f64b232348ee82f13aac22856515ce0195837f6968aeaa94a3d0353ea2ec06a6"},
+    {file = "cryptography-36.0.2-cp36-abi3-win_amd64.whl", hash = "sha256:53e0285b49fd0ab6e604f4c5d9c5ddd98de77018542e88366923f152dbeb3c29"},
+    {file = "cryptography-36.0.2-pp37-pypy37_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:32db5cc49c73f39aac27574522cecd0a4bb7384e71198bc65a0d23f901e89bb7"},
+    {file = "cryptography-36.0.2-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d2b3d199647468d410994dbeb8cec5816fb74feb9368aedf300af709ef507e3e"},
+    {file = "cryptography-36.0.2-pp37-pypy37_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:da73d095f8590ad437cd5e9faf6628a218aa7c387e1fdf67b888b47ba56a17f0"},
+    {file = "cryptography-36.0.2-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:0a3bf09bb0b7a2c93ce7b98cb107e9170a90c51a0162a20af1c61c765b90e60b"},
+    {file = "cryptography-36.0.2-pp38-pypy38_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:8897b7b7ec077c819187a123174b645eb680c13df68354ed99f9b40a50898f77"},
+    {file = "cryptography-36.0.2-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:82740818f2f240a5da8dfb8943b360e4f24022b093207160c77cadade47d7c85"},
+    {file = "cryptography-36.0.2-pp38-pypy38_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:1f64a62b3b75e4005df19d3b5235abd43fa6358d5516cfc43d87aeba8d08dd51"},
+    {file = "cryptography-36.0.2-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:e167b6b710c7f7bc54e67ef593f8731e1f45aa35f8a8a7b72d6e42ec76afd4b3"},
+    {file = "cryptography-36.0.2.tar.gz", hash = "sha256:70f8f4f7bb2ac9f340655cbac89d68c527af5bb4387522a8413e841e3e6628c9"},
 ]
 cx-freeze = [
     {file = "cx_Freeze-6.9-cp310-cp310-win32.whl", hash = "sha256:776d4fb68a4831691acbd3c374362b9b48ce2e568514a73c3d4cb14d5dcf1470"},
@@ -1946,25 +1987,29 @@ cx-logging = [
     {file = "cx_Logging-3.0-cp39-cp39-win_amd64.whl", hash = "sha256:302e9c4f65a936c288a4fa59a90e7e142d9ef994aa29676731acafdcccdbb3f5"},
     {file = "cx_Logging-3.0.tar.gz", hash = "sha256:ba8a7465facf7b98d8f494030fb481a2e8aeee29dc191e10383bb54ed42bdb34"},
 ]
+dill = [
+    {file = "dill-0.3.4-py2.py3-none-any.whl", hash = "sha256:7e40e4a70304fd9ceab3535d36e58791d9c4a776b38ec7f7ec9afc8d3dca4d4f"},
+    {file = "dill-0.3.4.zip", hash = "sha256:9f9734205146b2b353ab3fec9af0070237b6ddae78452af83d2fca84d739e675"},
+]
 dnspython = [
-    {file = "dnspython-2.2.0-py3-none-any.whl", hash = "sha256:081649da27ced5e75709a1ee542136eaba9842a0fe4c03da4fb0a3d3ed1f3c44"},
-    {file = "dnspython-2.2.0.tar.gz", hash = "sha256:e79351e032d0b606b98d38a4b0e6e2275b31a5b85c873e587cc11b73aca026d6"},
+    {file = "dnspython-2.2.1-py3-none-any.whl", hash = "sha256:a851e51367fb93e9e1361732c1d60dab63eff98712e503ea7d92e6eccb109b4f"},
+    {file = "dnspython-2.2.1.tar.gz", hash = "sha256:0f7569a4a6ff151958b64304071d370daa3243d15941a7beedf0c9fe5105603e"},
 ]
 docutils = [
-    {file = "docutils-0.18.1-py2.py3-none-any.whl", hash = "sha256:23010f129180089fbcd3bc08cfefccb3b890b0050e1ca00c867036e9d161b98c"},
-    {file = "docutils-0.18.1.tar.gz", hash = "sha256:679987caf361a7539d76e584cbeddc311e3aee937877c87346f31debc63e9d06"},
+    {file = "docutils-0.17.1-py2.py3-none-any.whl", hash = "sha256:cf316c8370a737a022b72b56874f6602acf974a37a9fba42ec2876387549fc61"},
+    {file = "docutils-0.17.1.tar.gz", hash = "sha256:686577d2e4c32380bb50cbb22f575ed742d58168cee37e99117a854bcd88f125"},
 ]
 dropbox = [
-    {file = "dropbox-11.26.0-py2-none-any.whl", hash = "sha256:abd29587fa692bde0c3a48ce8efb56c24d8df92c5f402bbcdd78f3089d5ced5c"},
-    {file = "dropbox-11.26.0-py3-none-any.whl", hash = "sha256:84becf043a63007ae67620946acb0fa164669ce691c7f1dbfdabb6712a258b29"},
-    {file = "dropbox-11.26.0.tar.gz", hash = "sha256:dd79e3dfc216688020959462aefac54ffce7c07a45e89f4fb258348885195a73"},
+    {file = "dropbox-11.29.0-py2-none-any.whl", hash = "sha256:2200ad5f42e00ae00d45db4a050fa199fe701ddc979fd1396d2c3e8912476c60"},
+    {file = "dropbox-11.29.0-py3-none-any.whl", hash = "sha256:bf81a822e662bd337f4cd33fe39580c0b6ee4781d018ef1b31dcef2f402986f2"},
+    {file = "dropbox-11.29.0.tar.gz", hash = "sha256:09b59f962ac28ce5b80d5f870c00c5fe7a637c4ac8d095c7c72fdab1e07376fc"},
 ]
 enlighten = [
     {file = "enlighten-1.10.2-py2.py3-none-any.whl", hash = "sha256:b237fe562b320bf9f1d4bb76d0c98e0daf914372a76ab87c35cd02f57aa9d8c1"},
     {file = "enlighten-1.10.2.tar.gz", hash = "sha256:7a5b83cd0f4d095e59d80c648ebb5f7ffca0cd8bcf7ae6639828ee1ad000632a"},
 ]
 evdev = [
-    {file = "evdev-1.4.0.tar.gz", hash = "sha256:8782740eb1a86b187334c07feb5127d3faa0b236e113206dfe3ae8f77fb1aaf1"},
+    {file = "evdev-1.5.0.tar.gz", hash = "sha256:5b33b174f7c84576e7dd6071e438bf5ad227da95efd4356a39fe4c8355412fe6"},
 ]
 flake8 = [
     {file = "flake8-3.9.2-py2.py3-none-any.whl", hash = "sha256:bf8fd333346d844f616e8d47905ef3a3384edae6b4e9beb0c5101e25e3110907"},
@@ -2043,32 +2088,32 @@ gitdb = [
     {file = "gitdb-4.0.9.tar.gz", hash = "sha256:bac2fd45c0a1c9cf619e63a90d62bdc63892ef92387424b855792a6cabe789aa"},
 ]
 gitpython = [
-    {file = "GitPython-3.1.26-py3-none-any.whl", hash = "sha256:26ac35c212d1f7b16036361ca5cff3ec66e11753a0d677fb6c48fa4e1a9dd8d6"},
-    {file = "GitPython-3.1.26.tar.gz", hash = "sha256:fc8868f63a2e6d268fb25f481995ba185a85a66fcad126f039323ff6635669ee"},
+    {file = "GitPython-3.1.27-py3-none-any.whl", hash = "sha256:5b68b000463593e05ff2b261acff0ff0972df8ab1b70d3cdbd41b546c8b8fc3d"},
+    {file = "GitPython-3.1.27.tar.gz", hash = "sha256:1c885ce809e8ba2d88a29befeb385fcea06338d3640712b59ca623c220bb5704"},
 ]
 google-api-core = [
-    {file = "google-api-core-2.4.0.tar.gz", hash = "sha256:ba8787b7c61632cd0340f095e1c036bef9426b2594f10afb290ba311ae8cb2cb"},
-    {file = "google_api_core-2.4.0-py2.py3-none-any.whl", hash = "sha256:58e2c1171a3d51778bf4e428fbb4bf79cbd05007b4b44deaa80cf73c80eebc0f"},
+    {file = "google-api-core-2.7.1.tar.gz", hash = "sha256:b0fa577e512f0c8e063386b974718b8614586a798c5894ed34bedf256d9dae24"},
+    {file = "google_api_core-2.7.1-py3-none-any.whl", hash = "sha256:6be1fc59e2a7ba9f66808bbc22f976f81e4c3e7ab20fa0620ce42686288787d0"},
 ]
 google-api-python-client = [
-    {file = "google-api-python-client-1.12.10.tar.gz", hash = "sha256:1cb773647e7d97048d9d1c7fa746247fbad39fd1a3b5040f2cb2645dd7156b11"},
-    {file = "google_api_python_client-1.12.10-py2.py3-none-any.whl", hash = "sha256:5a8742b9b604b34e13462cc3d6aedbbf11d3af1ef558eb95defe74a29ebc5c28"},
+    {file = "google-api-python-client-1.12.11.tar.gz", hash = "sha256:1b4bd42a46321e13c0542a9e4d96fa05d73626f07b39f83a73a947d70ca706a9"},
+    {file = "google_api_python_client-1.12.11-py2.py3-none-any.whl", hash = "sha256:7e0a1a265c8d3088ee1987778c72683fcb376e32bada8d7767162bd9c503fd9b"},
 ]
 google-auth = [
-    {file = "google-auth-2.6.0.tar.gz", hash = "sha256:ad160fc1ea8f19e331a16a14a79f3d643d813a69534ba9611d2c80dc10439dad"},
-    {file = "google_auth-2.6.0-py2.py3-none-any.whl", hash = "sha256:218ca03d7744ca0c8b6697b6083334be7df49b7bf76a69d555962fd1a7657b5f"},
+    {file = "google-auth-2.6.3.tar.gz", hash = "sha256:d65bb0e3701eaaa64fd2aa85e1325580524b0bddc6dc5db3ab89c481b6a20141"},
+    {file = "google_auth-2.6.3-py2.py3-none-any.whl", hash = "sha256:5e079eb4d21df1853d55cf2b6766b77ef36f7f7bdaf7d4a70434aa97c7578d60"},
 ]
 google-auth-httplib2 = [
     {file = "google-auth-httplib2-0.1.0.tar.gz", hash = "sha256:a07c39fd632becacd3f07718dfd6021bf396978f03ad3ce4321d060015cc30ac"},
     {file = "google_auth_httplib2-0.1.0-py2.py3-none-any.whl", hash = "sha256:31e49c36c6b5643b57e82617cb3e021e3e1d2df9da63af67252c02fa9c1f4a10"},
 ]
 googleapis-common-protos = [
-    {file = "googleapis-common-protos-1.54.0.tar.gz", hash = "sha256:a4031d6ec6c2b1b6dc3e0be7e10a1bd72fb0b18b07ef9be7b51f2c1004ce2437"},
-    {file = "googleapis_common_protos-1.54.0-py2.py3-none-any.whl", hash = "sha256:e54345a2add15dc5e1a7891c27731ff347b4c33765d79b5ed7026a6c0c7cbcae"},
+    {file = "googleapis-common-protos-1.56.0.tar.gz", hash = "sha256:4007500795bcfc269d279f0f7d253ae18d6dc1ff5d5a73613ffe452038b1ec5f"},
+    {file = "googleapis_common_protos-1.56.0-py2.py3-none-any.whl", hash = "sha256:60220c89b8bd5272159bed4929ecdc1243ae1f73437883a499a44a1cbc084086"},
 ]
 httplib2 = [
-    {file = "httplib2-0.20.2-py3-none-any.whl", hash = "sha256:6b937120e7d786482881b44b8eec230c1ee1c5c1d06bce8cc865f25abbbf713b"},
-    {file = "httplib2-0.20.2.tar.gz", hash = "sha256:e404681d2fbcec7506bcb52c503f2b021e95bee0ef7d01e5c221468a2406d8dc"},
+    {file = "httplib2-0.20.4-py3-none-any.whl", hash = "sha256:8b6a905cb1c79eefd03f8669fd993c36dc341f7c558f056cb5a33b5c2f458543"},
+    {file = "httplib2-0.20.4.tar.gz", hash = "sha256:58a98e45b4b1a48273073f905d2961666ecf0fbac4250ea5b47aef259eb5c585"},
 ]
 idna = [
     {file = "idna-2.10-py2.py3-none-any.whl", hash = "sha256:b97d804b1e9b523befed77c48dacec60e6dcb0b5391d57af6a65a312a90648c0"},
@@ -2079,8 +2124,8 @@ imagesize = [
     {file = "imagesize-1.3.0.tar.gz", hash = "sha256:cd1750d452385ca327479d45b64d9c7729ecf0b3969a58148298c77092261f9d"},
 ]
 importlib-metadata = [
-    {file = "importlib_metadata-4.10.1-py3-none-any.whl", hash = "sha256:899e2a40a8c4a1aec681feef45733de8a6c58f3f6a0dbed2eb6574b4387a77b6"},
-    {file = "importlib_metadata-4.10.1.tar.gz", hash = "sha256:951f0d8a5b7260e9db5e41d429285b5f451e928479f19d80818878527d36e95e"},
+    {file = "importlib_metadata-4.11.3-py3-none-any.whl", hash = "sha256:1208431ca90a8cca1a6b8af391bb53c1a2db74e5d1cef6ddced95d4b2062edc6"},
+    {file = "importlib_metadata-4.11.3.tar.gz", hash = "sha256:ea4c597ebf37142f827b8f39299579e31685c31d3a438b59f469406afd0f2539"},
 ]
 iniconfig = [
     {file = "iniconfig-1.1.1-py2.py3-none-any.whl", hash = "sha256:011e24c64b7f47f6ebd835bb12a743f2fbe9a26d4cecaa7f53bc4f35ee9da8b3"},
@@ -2095,8 +2140,8 @@ jedi = [
     {file = "jedi-0.13.3.tar.gz", hash = "sha256:2bb0603e3506f708e792c7f4ad8fc2a7a9d9c2d292a358fbbd58da531695595b"},
 ]
 jeepney = [
-    {file = "jeepney-0.7.1-py3-none-any.whl", hash = "sha256:1b5a0ea5c0e7b166b2f5895b91a08c14de8915afda4407fb5022a195224958ac"},
-    {file = "jeepney-0.7.1.tar.gz", hash = "sha256:fa9e232dfa0c498bd0b8a3a73b8d8a31978304dcef0515adc859d4e096f96f4f"},
+    {file = "jeepney-0.8.0-py3-none-any.whl", hash = "sha256:c0a454ad016ca575060802ee4d590dd912e35c122fa04e70306de3d076cce755"},
+    {file = "jeepney-0.8.0.tar.gz", hash = "sha256:5efe48d255973902f6badc3ce55e2aa6c5c3b3bc642059ef3a91247bcfcc5806"},
 ]
 jinja2 = [
     {file = "Jinja2-2.11.3-py2.py3-none-any.whl", hash = "sha256:03e47ad063331dd6a3f04a43eddca8a966a26ba0c5b7207a9a9e4e08f1b29419"},
@@ -2157,75 +2202,46 @@ log4mongo = [
     {file = "log4mongo-1.7.0.tar.gz", hash = "sha256:dc374617206162a0b14167fbb5feac01dbef587539a235dadba6200362984a68"},
 ]
 markupsafe = [
-    {file = "MarkupSafe-2.0.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:d8446c54dc28c01e5a2dbac5a25f071f6653e6e40f3a8818e8b45d790fe6ef53"},
-    {file = "MarkupSafe-2.0.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:36bc903cbb393720fad60fc28c10de6acf10dc6cc883f3e24ee4012371399a38"},
-    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2d7d807855b419fc2ed3e631034685db6079889a1f01d5d9dac950f764da3dad"},
-    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:add36cb2dbb8b736611303cd3bfcee00afd96471b09cda130da3581cbdc56a6d"},
-    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:168cd0a3642de83558a5153c8bd34f175a9a6e7f6dc6384b9655d2697312a646"},
-    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:4dc8f9fb58f7364b63fd9f85013b780ef83c11857ae79f2feda41e270468dd9b"},
-    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:20dca64a3ef2d6e4d5d615a3fd418ad3bde77a47ec8a23d984a12b5b4c74491a"},
-    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:cdfba22ea2f0029c9261a4bd07e830a8da012291fbe44dc794e488b6c9bb353a"},
-    {file = "MarkupSafe-2.0.1-cp310-cp310-win32.whl", hash = "sha256:99df47edb6bda1249d3e80fdabb1dab8c08ef3975f69aed437cb69d0a5de1e28"},
-    {file = "MarkupSafe-2.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:e0f138900af21926a02425cf736db95be9f4af72ba1bb21453432a07f6082134"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:f9081981fe268bd86831e5c75f7de206ef275defcb82bc70740ae6dc507aee51"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux1_i686.whl", hash = "sha256:0955295dd5eec6cb6cc2fe1698f4c6d84af2e92de33fbcac4111913cd100a6ff"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux1_x86_64.whl", hash = "sha256:0446679737af14f45767963a1a9ef7620189912317d095f2d9ffa183a4d25d2b"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2010_i686.whl", hash = "sha256:f826e31d18b516f653fe296d967d700fddad5901ae07c622bb3705955e1faa94"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2010_x86_64.whl", hash = "sha256:fa130dd50c57d53368c9d59395cb5526eda596d3ffe36666cd81a44d56e48872"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2014_aarch64.whl", hash = "sha256:905fec760bd2fa1388bb5b489ee8ee5f7291d692638ea5f67982d968366bef9f"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bf5d821ffabf0ef3533c39c518f3357b171a1651c1ff6827325e4489b0e46c3c"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:0d4b31cc67ab36e3392bbf3862cfbadac3db12bdd8b02a2731f509ed5b829724"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:baa1a4e8f868845af802979fcdbf0bb11f94f1cb7ced4c4b8a351bb60d108145"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:deb993cacb280823246a026e3b2d81c493c53de6acfd5e6bfe31ab3402bb37dd"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:63f3268ba69ace99cab4e3e3b5840b03340efed0948ab8f78d2fd87ee5442a4f"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:8d206346619592c6200148b01a2142798c989edcb9c896f9ac9722a99d4e77e6"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-win32.whl", hash = "sha256:6c4ca60fa24e85fe25b912b01e62cb969d69a23a5d5867682dd3e80b5b02581d"},
-    {file = "MarkupSafe-2.0.1-cp36-cp36m-win_amd64.whl", hash = "sha256:b2f4bf27480f5e5e8ce285a8c8fd176c0b03e93dcc6646477d4630e83440c6a9"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:0717a7390a68be14b8c793ba258e075c6f4ca819f15edfc2a3a027c823718567"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux1_i686.whl", hash = "sha256:6557b31b5e2c9ddf0de32a691f2312a32f77cd7681d8af66c2692efdbef84c18"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux1_x86_64.whl", hash = "sha256:49e3ceeabbfb9d66c3aef5af3a60cc43b85c33df25ce03d0031a608b0a8b2e3f"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2010_i686.whl", hash = "sha256:d7f9850398e85aba693bb640262d3611788b1f29a79f0c93c565694658f4071f"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2010_x86_64.whl", hash = "sha256:6a7fae0dd14cf60ad5ff42baa2e95727c3d81ded453457771d02b7d2b3f9c0c2"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2014_aarch64.whl", hash = "sha256:b7f2d075102dc8c794cbde1947378051c4e5180d52d276987b8d28a3bd58c17d"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e9936f0b261d4df76ad22f8fee3ae83b60d7c3e871292cd42f40b81b70afae85"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:2a7d351cbd8cfeb19ca00de495e224dea7e7d919659c2841bbb7f420ad03e2d6"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:60bf42e36abfaf9aff1f50f52644b336d4f0a3fd6d8a60ca0d054ac9f713a864"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:d6c7ebd4e944c85e2c3421e612a7057a2f48d478d79e61800d81468a8d842207"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:f0567c4dc99f264f49fe27da5f735f414c4e7e7dd850cfd8e69f0862d7c74ea9"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:89c687013cb1cd489a0f0ac24febe8c7a666e6e221b783e53ac50ebf68e45d86"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-win32.whl", hash = "sha256:a30e67a65b53ea0a5e62fe23682cfe22712e01f453b95233b25502f7c61cb415"},
-    {file = "MarkupSafe-2.0.1-cp37-cp37m-win_amd64.whl", hash = "sha256:611d1ad9a4288cf3e3c16014564df047fe08410e628f89805e475368bd304914"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:5bb28c636d87e840583ee3adeb78172efc47c8b26127267f54a9c0ec251d41a9"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:be98f628055368795d818ebf93da628541e10b75b41c559fdf36d104c5787066"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux1_i686.whl", hash = "sha256:1d609f577dc6e1aa17d746f8bd3c31aa4d258f4070d61b2aa5c4166c1539de35"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux1_x86_64.whl", hash = "sha256:7d91275b0245b1da4d4cfa07e0faedd5b0812efc15b702576d103293e252af1b"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2010_i686.whl", hash = "sha256:01a9b8ea66f1658938f65b93a85ebe8bc016e6769611be228d797c9d998dd298"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2010_x86_64.whl", hash = "sha256:47ab1e7b91c098ab893b828deafa1203de86d0bc6ab587b160f78fe6c4011f75"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2014_aarch64.whl", hash = "sha256:97383d78eb34da7e1fa37dd273c20ad4320929af65d156e35a5e2d89566d9dfb"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6fcf051089389abe060c9cd7caa212c707e58153afa2c649f00346ce6d260f1b"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:5855f8438a7d1d458206a2466bf82b0f104a3724bf96a1c781ab731e4201731a"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:3dd007d54ee88b46be476e293f48c85048603f5f516008bee124ddd891398ed6"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:aca6377c0cb8a8253e493c6b451565ac77e98c2951c45f913e0b52facdcff83f"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:04635854b943835a6ea959e948d19dcd311762c5c0c6e1f0e16ee57022669194"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:6300b8454aa6930a24b9618fbb54b5a68135092bc666f7b06901f897fa5c2fee"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-win32.whl", hash = "sha256:023cb26ec21ece8dc3907c0e8320058b2e0cb3c55cf9564da612bc325bed5e64"},
-    {file = "MarkupSafe-2.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:984d76483eb32f1bcb536dc27e4ad56bba4baa70be32fa87152832cdd9db0833"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:2ef54abee730b502252bcdf31b10dacb0a416229b72c18b19e24a4509f273d26"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:3c112550557578c26af18a1ccc9e090bfe03832ae994343cfdacd287db6a6ae7"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux1_i686.whl", hash = "sha256:53edb4da6925ad13c07b6d26c2a852bd81e364f95301c66e930ab2aef5b5ddd8"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux1_x86_64.whl", hash = "sha256:f5653a225f31e113b152e56f154ccbe59eeb1c7487b39b9d9f9cdb58e6c79dc5"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2010_i686.whl", hash = "sha256:4efca8f86c54b22348a5467704e3fec767b2db12fc39c6d963168ab1d3fc9135"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2010_x86_64.whl", hash = "sha256:ab3ef638ace319fa26553db0624c4699e31a28bb2a835c5faca8f8acf6a5a902"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2014_aarch64.whl", hash = "sha256:f8ba0e8349a38d3001fae7eadded3f6606f0da5d748ee53cc1dab1d6527b9509"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c47adbc92fc1bb2b3274c4b3a43ae0e4573d9fbff4f54cd484555edbf030baf1"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:37205cac2a79194e3750b0af2a5720d95f786a55ce7df90c3af697bfa100eaac"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:1f2ade76b9903f39aa442b4aadd2177decb66525062db244b35d71d0ee8599b6"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:4296f2b1ce8c86a6aea78613c34bb1a672ea0e3de9c6ba08a960efe0b0a09047"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:9f02365d4e99430a12647f09b6cc8bab61a6564363f313126f775eb4f6ef798e"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5b6d930f030f8ed98e3e6c98ffa0652bdb82601e7a016ec2ab5d7ff23baa78d1"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-win32.whl", hash = "sha256:10f82115e21dc0dfec9ab5c0223652f7197feb168c940f3ef61563fc2d6beb74"},
-    {file = "MarkupSafe-2.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:693ce3f9e70a6cf7d2fb9e6c9d8b204b6b39897a2c4a1aa65728d5ac97dcc1d8"},
-    {file = "MarkupSafe-2.0.1.tar.gz", hash = "sha256:594c67807fb16238b30c44bdf74f36c02cdf22d1c8cda91ef8a0ed8dabf5620a"},
+    {file = "MarkupSafe-2.1.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:86b1f75c4e7c2ac2ccdaec2b9022845dbb81880ca318bb7a0a01fbf7813e3812"},
+    {file = "MarkupSafe-2.1.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:f121a1420d4e173a5d96e47e9a0c0dcff965afdf1626d28de1460815f7c4ee7a"},
+    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a49907dd8420c5685cfa064a1335b6754b74541bbb3706c259c02ed65b644b3e"},
+    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:10c1bfff05d95783da83491be968e8fe789263689c02724e0c691933c52994f5"},
+    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b7bd98b796e2b6553da7225aeb61f447f80a1ca64f41d83612e6139ca5213aa4"},
+    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:b09bf97215625a311f669476f44b8b318b075847b49316d3e28c08e41a7a573f"},
+    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:694deca8d702d5db21ec83983ce0bb4b26a578e71fbdbd4fdcd387daa90e4d5e"},
+    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:efc1913fd2ca4f334418481c7e595c00aad186563bbc1ec76067848c7ca0a933"},
+    {file = "MarkupSafe-2.1.1-cp310-cp310-win32.whl", hash = "sha256:4a33dea2b688b3190ee12bd7cfa29d39c9ed176bda40bfa11099a3ce5d3a7ac6"},
+    {file = "MarkupSafe-2.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:dda30ba7e87fbbb7eab1ec9f58678558fd9a6b8b853530e176eabd064da81417"},
+    {file = "MarkupSafe-2.1.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:671cd1187ed5e62818414afe79ed29da836dde67166a9fac6d435873c44fdd02"},
+    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3799351e2336dc91ea70b034983ee71cf2f9533cdff7c14c90ea126bfd95d65a"},
+    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e72591e9ecd94d7feb70c1cbd7be7b3ebea3f548870aa91e2732960fa4d57a37"},
+    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6fbf47b5d3728c6aea2abb0589b5d30459e369baa772e0f37a0320185e87c980"},
+    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:d5ee4f386140395a2c818d149221149c54849dfcfcb9f1debfe07a8b8bd63f9a"},
+    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:bcb3ed405ed3222f9904899563d6fc492ff75cce56cba05e32eff40e6acbeaa3"},
+    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:e1c0b87e09fa55a220f058d1d49d3fb8df88fbfab58558f1198e08c1e1de842a"},
+    {file = "MarkupSafe-2.1.1-cp37-cp37m-win32.whl", hash = "sha256:8dc1c72a69aa7e082593c4a203dcf94ddb74bb5c8a731e4e1eb68d031e8498ff"},
+    {file = "MarkupSafe-2.1.1-cp37-cp37m-win_amd64.whl", hash = "sha256:97a68e6ada378df82bc9f16b800ab77cbf4b2fada0081794318520138c088e4a"},
+    {file = "MarkupSafe-2.1.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:e8c843bbcda3a2f1e3c2ab25913c80a3c5376cd00c6e8c4a86a89a28c8dc5452"},
+    {file = "MarkupSafe-2.1.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:0212a68688482dc52b2d45013df70d169f542b7394fc744c02a57374a4207003"},
+    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8e576a51ad59e4bfaac456023a78f6b5e6e7651dcd383bcc3e18d06f9b55d6d1"},
+    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4b9fe39a2ccc108a4accc2676e77da025ce383c108593d65cc909add5c3bd601"},
+    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:96e37a3dc86e80bf81758c152fe66dbf60ed5eca3d26305edf01892257049925"},
+    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:6d0072fea50feec76a4c418096652f2c3238eaa014b2f94aeb1d56a66b41403f"},
+    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:089cf3dbf0cd6c100f02945abeb18484bd1ee57a079aefd52cffd17fba910b88"},
+    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:6a074d34ee7a5ce3effbc526b7083ec9731bb3cbf921bbe1d3005d4d2bdb3a63"},
+    {file = "MarkupSafe-2.1.1-cp38-cp38-win32.whl", hash = "sha256:421be9fbf0ffe9ffd7a378aafebbf6f4602d564d34be190fc19a193232fd12b1"},
+    {file = "MarkupSafe-2.1.1-cp38-cp38-win_amd64.whl", hash = "sha256:fc7b548b17d238737688817ab67deebb30e8073c95749d55538ed473130ec0c7"},
+    {file = "MarkupSafe-2.1.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:e04e26803c9c3851c931eac40c695602c6295b8d432cbe78609649ad9bd2da8a"},
+    {file = "MarkupSafe-2.1.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:b87db4360013327109564f0e591bd2a3b318547bcef31b468a92ee504d07ae4f"},
+    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:99a2a507ed3ac881b975a2976d59f38c19386d128e7a9a18b7df6fff1fd4c1d6"},
+    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:56442863ed2b06d19c37f94d999035e15ee982988920e12a5b4ba29b62ad1f77"},
+    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3ce11ee3f23f79dbd06fb3d63e2f6af7b12db1d46932fe7bd8afa259a5996603"},
+    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:33b74d289bd2f5e527beadcaa3f401e0df0a89927c1559c8566c066fa4248ab7"},
+    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:43093fb83d8343aac0b1baa75516da6092f58f41200907ef92448ecab8825135"},
+    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:8e3dcf21f367459434c18e71b2a9532d96547aef8a871872a5bd69a715c15f96"},
+    {file = "MarkupSafe-2.1.1-cp39-cp39-win32.whl", hash = "sha256:d4306c36ca495956b6d568d276ac11fdd9c30a36f1b6eb928070dc5360b22e1c"},
+    {file = "MarkupSafe-2.1.1-cp39-cp39-win_amd64.whl", hash = "sha256:46d00d6cfecdde84d40e572d63735ef81423ad31184100411e6e3388d405e247"},
+    {file = "MarkupSafe-2.1.1.tar.gz", hash = "sha256:7f91197cc9e48f989d12e4e6fbc46495c446636dfc81b9ccf50bb0ec74b91d4b"},
 ]
 mccabe = [
     {file = "mccabe-0.6.1-py2.py3-none-any.whl", hash = "sha256:ab8a6258860da4b6677da4bd2fe5dc2c659cff31b3ee4f7f5d64e79735b80d42"},
@@ -2298,54 +2314,60 @@ packaging = [
     {file = "packaging-21.3.tar.gz", hash = "sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb"},
 ]
 paramiko = [
-    {file = "paramiko-2.10.1-py2.py3-none-any.whl", hash = "sha256:f6cbd3e1204abfdbcd40b3ecbc9d32f04027cd3080fe666245e21e7540ccfc1b"},
-    {file = "paramiko-2.10.1.tar.gz", hash = "sha256:443f4da23ec24e9a9c0ea54017829c282abdda1d57110bf229360775ccd27a31"},
+    {file = "paramiko-2.10.3-py2.py3-none-any.whl", hash = "sha256:ac6593479f2b47a9422eca076b22cff9f795495e6733a64723efc75dd8c92101"},
+    {file = "paramiko-2.10.3.tar.gz", hash = "sha256:ddb1977853aef82804b35d72a0e597b244fa326c404c350bd00c5b01dbfee71a"},
 ]
 parso = [
     {file = "parso-0.8.3-py2.py3-none-any.whl", hash = "sha256:c001d4636cd3aecdaf33cbb40aebb59b094be2a74c556778ef5576c175e19e75"},
     {file = "parso-0.8.3.tar.gz", hash = "sha256:8c07be290bb59f03588915921e29e8a50002acaf2cdc5fa0e0114f91709fafa0"},
 ]
 pathlib2 = [
-    {file = "pathlib2-2.3.6-py2.py3-none-any.whl", hash = "sha256:3a130b266b3a36134dcc79c17b3c7ac9634f083825ca6ea9d8f557ee6195c9c8"},
-    {file = "pathlib2-2.3.6.tar.gz", hash = "sha256:7d8bcb5555003cdf4a8d2872c538faa3a0f5d20630cb360e518ca3b981795e5f"},
+    {file = "pathlib2-2.3.7.post1-py2.py3-none-any.whl", hash = "sha256:5266a0fd000452f1b3467d782f079a4343c63aaa119221fbdc4e39577489ca5b"},
+    {file = "pathlib2-2.3.7.post1.tar.gz", hash = "sha256:9fe0edad898b83c0c3e199c842b27ed216645d2e177757b2dd67384d4113c641"},
 ]
 pillow = [
-    {file = "Pillow-9.0.0-cp310-cp310-macosx_10_10_universal2.whl", hash = "sha256:113723312215b25c22df1fdf0e2da7a3b9c357a7d24a93ebbe80bfda4f37a8d4"},
-    {file = "Pillow-9.0.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:bb47a548cea95b86494a26c89d153fd31122ed65255db5dcbc421a2d28eb3379"},
-    {file = "Pillow-9.0.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:31b265496e603985fad54d52d11970383e317d11e18e856971bdbb86af7242a4"},
-    {file = "Pillow-9.0.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d154ed971a4cc04b93a6d5b47f37948d1f621f25de3e8fa0c26b2d44f24e3e8f"},
-    {file = "Pillow-9.0.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:80fe92813d208ce8aa7d76da878bdc84b90809f79ccbad2a288e9bcbeac1d9bd"},
-    {file = "Pillow-9.0.0-cp310-cp310-win32.whl", hash = "sha256:d5dcea1387331c905405b09cdbfb34611050cc52c865d71f2362f354faee1e9f"},
-    {file = "Pillow-9.0.0-cp310-cp310-win_amd64.whl", hash = "sha256:52abae4c96b5da630a8b4247de5428f593465291e5b239f3f843a911a3cf0105"},
-    {file = "Pillow-9.0.0-cp37-cp37m-macosx_10_10_x86_64.whl", hash = "sha256:72c3110228944019e5f27232296c5923398496b28be42535e3b2dc7297b6e8b6"},
-    {file = "Pillow-9.0.0-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:97b6d21771da41497b81652d44191489296555b761684f82b7b544c49989110f"},
-    {file = "Pillow-9.0.0-cp37-cp37m-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:72f649d93d4cc4d8cf79c91ebc25137c358718ad75f99e99e043325ea7d56100"},
-    {file = "Pillow-9.0.0-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7aaf07085c756f6cb1c692ee0d5a86c531703b6e8c9cae581b31b562c16b98ce"},
-    {file = "Pillow-9.0.0-cp37-cp37m-win32.whl", hash = "sha256:03b27b197deb4ee400ed57d8d4e572d2d8d80f825b6634daf6e2c18c3c6ccfa6"},
-    {file = "Pillow-9.0.0-cp37-cp37m-win_amd64.whl", hash = "sha256:a09a9d4ec2b7887f7a088bbaacfd5c07160e746e3d47ec5e8050ae3b2a229e9f"},
-    {file = "Pillow-9.0.0-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:490e52e99224858f154975db61c060686df8a6b3f0212a678e5d2e2ce24675c9"},
-    {file = "Pillow-9.0.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:500d397ddf4bbf2ca42e198399ac13e7841956c72645513e8ddf243b31ad2128"},
-    {file = "Pillow-9.0.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0ebd8b9137630a7bbbff8c4b31e774ff05bbb90f7911d93ea2c9371e41039b52"},
-    {file = "Pillow-9.0.0-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:fd0e5062f11cb3e730450a7d9f323f4051b532781026395c4323b8ad055523c4"},
-    {file = "Pillow-9.0.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9f3b4522148586d35e78313db4db0df4b759ddd7649ef70002b6c3767d0fdeb7"},
-    {file = "Pillow-9.0.0-cp38-cp38-win32.whl", hash = "sha256:0b281fcadbb688607ea6ece7649c5d59d4bbd574e90db6cd030e9e85bde9fecc"},
-    {file = "Pillow-9.0.0-cp38-cp38-win_amd64.whl", hash = "sha256:b5050d681bcf5c9f2570b93bee5d3ec8ae4cf23158812f91ed57f7126df91762"},
-    {file = "Pillow-9.0.0-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:c2067b3bb0781f14059b112c9da5a91c80a600a97915b4f48b37f197895dd925"},
-    {file = "Pillow-9.0.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:2d16b6196fb7a54aff6b5e3ecd00f7c0bab1b56eee39214b2b223a9d938c50af"},
-    {file = "Pillow-9.0.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:98cb63ca63cb61f594511c06218ab4394bf80388b3d66cd61d0b1f63ee0ea69f"},
-    {file = "Pillow-9.0.0-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:bc462d24500ba707e9cbdef436c16e5c8cbf29908278af053008d9f689f56dee"},
-    {file = "Pillow-9.0.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3586e12d874ce2f1bc875a3ffba98732ebb12e18fb6d97be482bd62b56803281"},
-    {file = "Pillow-9.0.0-cp39-cp39-win32.whl", hash = "sha256:68e06f8b2248f6dc8b899c3e7ecf02c9f413aab622f4d6190df53a78b93d97a5"},
-    {file = "Pillow-9.0.0-cp39-cp39-win_amd64.whl", hash = "sha256:6579f9ba84a3d4f1807c4aab4be06f373017fc65fff43498885ac50a9b47a553"},
-    {file = "Pillow-9.0.0-pp37-pypy37_pp73-macosx_10_10_x86_64.whl", hash = "sha256:47f5cf60bcb9fbc46011f75c9b45a8b5ad077ca352a78185bd3e7f1d294b98bb"},
-    {file = "Pillow-9.0.0-pp37-pypy37_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2fd8053e1f8ff1844419842fd474fc359676b2e2a2b66b11cc59f4fa0a301315"},
-    {file = "Pillow-9.0.0-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6c5439bfb35a89cac50e81c751317faea647b9a3ec11c039900cd6915831064d"},
-    {file = "Pillow-9.0.0-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:95545137fc56ce8c10de646074d242001a112a92de169986abd8c88c27566a05"},
-    {file = "Pillow-9.0.0.tar.gz", hash = "sha256:ee6e2963e92762923956fe5d3479b1fdc3b76c83f290aad131a2f98c3df0593e"},
+    {file = "Pillow-9.1.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:af79d3fde1fc2e33561166d62e3b63f0cc3e47b5a3a2e5fea40d4917754734ea"},
+    {file = "Pillow-9.1.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:55dd1cf09a1fd7c7b78425967aacae9b0d70125f7d3ab973fadc7b5abc3de652"},
+    {file = "Pillow-9.1.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:66822d01e82506a19407d1afc104c3fcea3b81d5eb11485e593ad6b8492f995a"},
+    {file = "Pillow-9.1.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a5eaf3b42df2bcda61c53a742ee2c6e63f777d0e085bbc6b2ab7ed57deb13db7"},
+    {file = "Pillow-9.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:01ce45deec9df310cbbee11104bae1a2a43308dd9c317f99235b6d3080ddd66e"},
+    {file = "Pillow-9.1.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:aea7ce61328e15943d7b9eaca87e81f7c62ff90f669116f857262e9da4057ba3"},
+    {file = "Pillow-9.1.0-cp310-cp310-win32.whl", hash = "sha256:7a053bd4d65a3294b153bdd7724dce864a1d548416a5ef61f6d03bf149205160"},
+    {file = "Pillow-9.1.0-cp310-cp310-win_amd64.whl", hash = "sha256:97bda660702a856c2c9e12ec26fc6d187631ddfd896ff685814ab21ef0597033"},
+    {file = "Pillow-9.1.0-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:21dee8466b42912335151d24c1665fcf44dc2ee47e021d233a40c3ca5adae59c"},
+    {file = "Pillow-9.1.0-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6b6d4050b208c8ff886fd3db6690bf04f9a48749d78b41b7a5bf24c236ab0165"},
+    {file = "Pillow-9.1.0-cp37-cp37m-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5cfca31ab4c13552a0f354c87fbd7f162a4fafd25e6b521bba93a57fe6a3700a"},
+    {file = "Pillow-9.1.0-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ed742214068efa95e9844c2d9129e209ed63f61baa4d54dbf4cf8b5e2d30ccf2"},
+    {file = "Pillow-9.1.0-cp37-cp37m-win32.whl", hash = "sha256:c9efef876c21788366ea1f50ecb39d5d6f65febe25ad1d4c0b8dff98843ac244"},
+    {file = "Pillow-9.1.0-cp37-cp37m-win_amd64.whl", hash = "sha256:de344bcf6e2463bb25179d74d6e7989e375f906bcec8cb86edb8b12acbc7dfef"},
+    {file = "Pillow-9.1.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:17869489de2fce6c36690a0c721bd3db176194af5f39249c1ac56d0bb0fcc512"},
+    {file = "Pillow-9.1.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:25023a6209a4d7c42154073144608c9a71d3512b648a2f5d4465182cb93d3477"},
+    {file = "Pillow-9.1.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8782189c796eff29dbb37dd87afa4ad4d40fc90b2742704f94812851b725964b"},
+    {file = "Pillow-9.1.0-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:463acf531f5d0925ca55904fa668bb3461c3ef6bc779e1d6d8a488092bdee378"},
+    {file = "Pillow-9.1.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f42364485bfdab19c1373b5cd62f7c5ab7cc052e19644862ec8f15bb8af289e"},
+    {file = "Pillow-9.1.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:3fddcdb619ba04491e8f771636583a7cc5a5051cd193ff1aa1ee8616d2a692c5"},
+    {file = "Pillow-9.1.0-cp38-cp38-win32.whl", hash = "sha256:4fe29a070de394e449fd88ebe1624d1e2d7ddeed4c12e0b31624561b58948d9a"},
+    {file = "Pillow-9.1.0-cp38-cp38-win_amd64.whl", hash = "sha256:c24f718f9dd73bb2b31a6201e6db5ea4a61fdd1d1c200f43ee585fc6dcd21b34"},
+    {file = "Pillow-9.1.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:fb89397013cf302f282f0fc998bb7abf11d49dcff72c8ecb320f76ea6e2c5717"},
+    {file = "Pillow-9.1.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:c870193cce4b76713a2b29be5d8327c8ccbe0d4a49bc22968aa1e680930f5581"},
+    {file = "Pillow-9.1.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:69e5ddc609230d4408277af135c5b5c8fe7a54b2bdb8ad7c5100b86b3aab04c6"},
+    {file = "Pillow-9.1.0-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:35be4a9f65441d9982240e6966c1eaa1c654c4e5e931eaf580130409e31804d4"},
+    {file = "Pillow-9.1.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:82283af99c1c3a5ba1da44c67296d5aad19f11c535b551a5ae55328a317ce331"},
+    {file = "Pillow-9.1.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:a325ac71914c5c043fa50441b36606e64a10cd262de12f7a179620f579752ff8"},
+    {file = "Pillow-9.1.0-cp39-cp39-win32.whl", hash = "sha256:a598d8830f6ef5501002ae85c7dbfcd9c27cc4efc02a1989369303ba85573e58"},
+    {file = "Pillow-9.1.0-cp39-cp39-win_amd64.whl", hash = "sha256:0c51cb9edac8a5abd069fd0758ac0a8bfe52c261ee0e330f363548aca6893595"},
+    {file = "Pillow-9.1.0-pp37-pypy37_pp73-macosx_10_9_x86_64.whl", hash = "sha256:a336a4f74baf67e26f3acc4d61c913e378e931817cd1e2ef4dfb79d3e051b481"},
+    {file = "Pillow-9.1.0-pp37-pypy37_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:eb1b89b11256b5b6cad5e7593f9061ac4624f7651f7a8eb4dfa37caa1dfaa4d0"},
+    {file = "Pillow-9.1.0-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:255c9d69754a4c90b0ee484967fc8818c7ff8311c6dddcc43a4340e10cd1636a"},
+    {file = "Pillow-9.1.0-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:5a3ecc026ea0e14d0ad7cd990ea7f48bfcb3eb4271034657dc9d06933c6629a7"},
+    {file = "Pillow-9.1.0-pp38-pypy38_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c5b0ff59785d93b3437c3703e3c64c178aabada51dea2a7f2c5eccf1bcf565a3"},
+    {file = "Pillow-9.1.0-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c7110ec1701b0bf8df569a7592a196c9d07c764a0a74f65471ea56816f10e2c8"},
+    {file = "Pillow-9.1.0-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:8d79c6f468215d1a8415aa53d9868a6b40c4682165b8cb62a221b1baa47db458"},
+    {file = "Pillow-9.1.0.tar.gz", hash = "sha256:f401ed2bbb155e1ade150ccc63db1a4f6c1909d3d378f7d1235a44e90d75fb97"},
 ]
 platformdirs = [
-    {file = "platformdirs-2.4.1-py3-none-any.whl", hash = "sha256:1d7385c7db91728b83efd0ca99a5afb296cab9d0ed8313a45ed8ba17967ecfca"},
-    {file = "platformdirs-2.4.1.tar.gz", hash = "sha256:440633ddfebcc36264232365d7840a970e75e1018d15b4327d11f91909045fda"},
+    {file = "platformdirs-2.5.1-py3-none-any.whl", hash = "sha256:bcae7cab893c2d310a711b70b24efb93334febe65f8de776ee320b517471e227"},
+    {file = "platformdirs-2.5.1.tar.gz", hash = "sha256:7535e70dfa32e84d4b34996ea99c5e432fa29a708d0f4e394bbcb2a8faa4f16d"},
 ]
 pluggy = [
     {file = "pluggy-1.0.0-py2.py3-none-any.whl", hash = "sha256:74134bbf457f031a36d68416e1509f34bd5ccc019f0bcc952c7b909d06b37bd3"},
@@ -2360,32 +2382,30 @@ prefixed = [
     {file = "prefixed-0.3.2.tar.gz", hash = "sha256:ca48277ba5fa8346dd4b760847da930c7b84416387c39e93affef086add2c029"},
 ]
 protobuf = [
-    {file = "protobuf-3.19.4-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:f51d5a9f137f7a2cec2d326a74b6e3fc79d635d69ffe1b036d39fc7d75430d37"},
-    {file = "protobuf-3.19.4-cp310-cp310-manylinux2014_aarch64.whl", hash = "sha256:09297b7972da685ce269ec52af761743714996b4381c085205914c41fcab59fb"},
-    {file = "protobuf-3.19.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:072fbc78d705d3edc7ccac58a62c4c8e0cec856987da7df8aca86e647be4e35c"},
-    {file = "protobuf-3.19.4-cp310-cp310-win32.whl", hash = "sha256:7bb03bc2873a2842e5ebb4801f5c7ff1bfbdf426f85d0172f7644fcda0671ae0"},
-    {file = "protobuf-3.19.4-cp310-cp310-win_amd64.whl", hash = "sha256:f358aa33e03b7a84e0d91270a4d4d8f5df6921abe99a377828839e8ed0c04e07"},
-    {file = "protobuf-3.19.4-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:1c91ef4110fdd2c590effb5dca8fdbdcb3bf563eece99287019c4204f53d81a4"},
-    {file = "protobuf-3.19.4-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c438268eebb8cf039552897d78f402d734a404f1360592fef55297285f7f953f"},
-    {file = "protobuf-3.19.4-cp36-cp36m-win32.whl", hash = "sha256:835a9c949dc193953c319603b2961c5c8f4327957fe23d914ca80d982665e8ee"},
-    {file = "protobuf-3.19.4-cp36-cp36m-win_amd64.whl", hash = "sha256:4276cdec4447bd5015453e41bdc0c0c1234eda08420b7c9a18b8d647add51e4b"},
-    {file = "protobuf-3.19.4-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:6cbc312be5e71869d9d5ea25147cdf652a6781cf4d906497ca7690b7b9b5df13"},
-    {file = "protobuf-3.19.4-cp37-cp37m-manylinux2014_aarch64.whl", hash = "sha256:54a1473077f3b616779ce31f477351a45b4fef8c9fd7892d6d87e287a38df368"},
-    {file = "protobuf-3.19.4-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:435bb78b37fc386f9275a7035fe4fb1364484e38980d0dd91bc834a02c5ec909"},
-    {file = "protobuf-3.19.4-cp37-cp37m-win32.whl", hash = "sha256:16f519de1313f1b7139ad70772e7db515b1420d208cb16c6d7858ea989fc64a9"},
-    {file = "protobuf-3.19.4-cp37-cp37m-win_amd64.whl", hash = "sha256:cdc076c03381f5c1d9bb1abdcc5503d9ca8b53cf0a9d31a9f6754ec9e6c8af0f"},
-    {file = "protobuf-3.19.4-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:69da7d39e39942bd52848438462674c463e23963a1fdaa84d88df7fbd7e749b2"},
-    {file = "protobuf-3.19.4-cp38-cp38-manylinux2014_aarch64.whl", hash = "sha256:48ed3877fa43e22bcacc852ca76d4775741f9709dd9575881a373bd3e85e54b2"},
-    {file = "protobuf-3.19.4-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bd95d1dfb9c4f4563e6093a9aa19d9c186bf98fa54da5252531cc0d3a07977e7"},
-    {file = "protobuf-3.19.4-cp38-cp38-win32.whl", hash = "sha256:b38057450a0c566cbd04890a40edf916db890f2818e8682221611d78dc32ae26"},
-    {file = "protobuf-3.19.4-cp38-cp38-win_amd64.whl", hash = "sha256:7ca7da9c339ca8890d66958f5462beabd611eca6c958691a8fe6eccbd1eb0c6e"},
-    {file = "protobuf-3.19.4-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:36cecbabbda242915529b8ff364f2263cd4de7c46bbe361418b5ed859677ba58"},
-    {file = "protobuf-3.19.4-cp39-cp39-manylinux2014_aarch64.whl", hash = "sha256:c1068287025f8ea025103e37d62ffd63fec8e9e636246b89c341aeda8a67c934"},
-    {file = "protobuf-3.19.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:96bd766831596d6014ca88d86dc8fe0fb2e428c0b02432fd9db3943202bf8c5e"},
-    {file = "protobuf-3.19.4-cp39-cp39-win32.whl", hash = "sha256:84123274d982b9e248a143dadd1b9815049f4477dc783bf84efe6250eb4b836a"},
-    {file = "protobuf-3.19.4-cp39-cp39-win_amd64.whl", hash = "sha256:3112b58aac3bac9c8be2b60a9daf6b558ca3f7681c130dcdd788ade7c9ffbdca"},
-    {file = "protobuf-3.19.4-py2.py3-none-any.whl", hash = "sha256:8961c3a78ebfcd000920c9060a262f082f29838682b1f7201889300c1fbe0616"},
-    {file = "protobuf-3.19.4.tar.gz", hash = "sha256:9df0c10adf3e83015ced42a9a7bd64e13d06c4cf45c340d2c63020ea04499d0a"},
+    {file = "protobuf-3.20.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:9d0f3aca8ca51c8b5e204ab92bd8afdb2a8e3df46bd0ce0bd39065d79aabcaa4"},
+    {file = "protobuf-3.20.0-cp310-cp310-manylinux2014_aarch64.whl", hash = "sha256:001c2160c03b6349c04de39cf1a58e342750da3632f6978a1634a3dcca1ec10e"},
+    {file = "protobuf-3.20.0-cp310-cp310-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:5b5860b790498f233cdc8d635a17fc08de62e59d4dcd8cdb6c6c0d38a31edf2b"},
+    {file = "protobuf-3.20.0-cp310-cp310-win32.whl", hash = "sha256:0b250c60256c8824219352dc2a228a6b49987e5bf94d3ffcf4c46585efcbd499"},
+    {file = "protobuf-3.20.0-cp310-cp310-win_amd64.whl", hash = "sha256:a1eebb6eb0653e594cb86cd8e536b9b083373fca9aba761ade6cd412d46fb2ab"},
+    {file = "protobuf-3.20.0-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:bc14037281db66aa60856cd4ce4541a942040686d290e3f3224dd3978f88f554"},
+    {file = "protobuf-3.20.0-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:47257d932de14a7b6c4ae1b7dbf592388153ee35ec7cae216b87ae6490ed39a3"},
+    {file = "protobuf-3.20.0-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:fbcbb068ebe67c4ff6483d2e2aa87079c325f8470b24b098d6bf7d4d21d57a69"},
+    {file = "protobuf-3.20.0-cp37-cp37m-manylinux2014_aarch64.whl", hash = "sha256:542f25a4adf3691a306dcc00bf9a73176554938ec9b98f20f929a044f80acf1b"},
+    {file = "protobuf-3.20.0-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:fd7133b885e356fa4920ead8289bb45dc6f185a164e99e10279f33732ed5ce15"},
+    {file = "protobuf-3.20.0-cp37-cp37m-win32.whl", hash = "sha256:8d84453422312f8275455d1cb52d850d6a4d7d714b784e41b573c6f5bfc2a029"},
+    {file = "protobuf-3.20.0-cp37-cp37m-win_amd64.whl", hash = "sha256:52bae32a147c375522ce09bd6af4d2949aca32a0415bc62df1456b3ad17c6001"},
+    {file = "protobuf-3.20.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:25d2fcd6eef340082718ec9ad2c58d734429f2b1f7335d989523852f2bba220b"},
+    {file = "protobuf-3.20.0-cp38-cp38-manylinux2014_aarch64.whl", hash = "sha256:88c8be0558bdfc35e68c42ae5bf785eb9390d25915d4863bbc7583d23da77074"},
+    {file = "protobuf-3.20.0-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:38fd9eb74b852e4ee14b16e9670cd401d147ee3f3ec0d4f7652e0c921d6227f8"},
+    {file = "protobuf-3.20.0-cp38-cp38-win32.whl", hash = "sha256:7dcd84dc31ebb35ade755e06d1561d1bd3b85e85dbdbf6278011fc97b22810db"},
+    {file = "protobuf-3.20.0-cp38-cp38-win_amd64.whl", hash = "sha256:1eb13f5a5a59ca4973bcfa2fc8fff644bd39f2109c3f7a60bd5860cb6a49b679"},
+    {file = "protobuf-3.20.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:1d24c81c2310f0063b8fc1c20c8ed01f3331be9374b4b5c2de846f69e11e21fb"},
+    {file = "protobuf-3.20.0-cp39-cp39-manylinux2014_aarch64.whl", hash = "sha256:8be43a91ab66fe995e85ccdbdd1046d9f0443d59e060c0840319290de25b7d33"},
+    {file = "protobuf-3.20.0-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:7a53d4035427b9dbfbb397f46642754d294f131e93c661d056366f2a31438263"},
+    {file = "protobuf-3.20.0-cp39-cp39-win32.whl", hash = "sha256:32bf4a90c207a0b4e70ca6dd09d43de3cb9898f7d5b69c2e9e3b966a7f342820"},
+    {file = "protobuf-3.20.0-cp39-cp39-win_amd64.whl", hash = "sha256:6efe066a7135233f97ce51a1aa007d4fb0be28ef093b4f88dac4ad1b3a2b7b6f"},
+    {file = "protobuf-3.20.0-py2.py3-none-any.whl", hash = "sha256:4eda68bd9e2a4879385e6b1ea528c976f59cd9728382005cc54c28bcce8db983"},
+    {file = "protobuf-3.20.0.tar.gz", hash = "sha256:71b2c3d1cd26ed1ec7c8196834143258b2ad7f444efff26fdc366c6f5e752702"},
 ]
 py = [
     {file = "py-1.11.0-py2.py3-none-any.whl", hash = "sha256:607c53218732647dff4acdfcd50cb62615cedf612e72d1724fb1a0cc6405b378"},
@@ -2450,8 +2470,8 @@ pygments = [
     {file = "Pygments-2.11.2.tar.gz", hash = "sha256:4e426f72023d88d03b2fa258de560726ce890ff3b630f88c21cbb8b2503b8c6a"},
 ]
 pylint = [
-    {file = "pylint-2.12.2-py3-none-any.whl", hash = "sha256:daabda3f7ed9d1c60f52d563b1b854632fd90035bcf01443e234d3dc794e3b74"},
-    {file = "pylint-2.12.2.tar.gz", hash = "sha256:9d945a73640e1fec07ee34b42f5669b770c759acd536ec7b16d7e4b87a9c9ff9"},
+    {file = "pylint-2.13.5-py3-none-any.whl", hash = "sha256:c149694cfdeaee1aa2465e6eaab84c87a881a7d55e6e93e09466be7164764d1e"},
+    {file = "pylint-2.13.5.tar.gz", hash = "sha256:dab221658368c7a05242e673c275c488670144123f4bd262b2777249c1c0de9b"},
 ]
 pymongo = [
     {file = "pymongo-3.12.3-cp27-cp27m-macosx_10_14_intel.whl", hash = "sha256:c164eda0be9048f83c24b9b2656900041e069ddf72de81c17d874d0c32f6079f"},
@@ -2580,40 +2600,40 @@ pynput = [
     {file = "pynput-1.7.6.tar.gz", hash = "sha256:3a5726546da54116b687785d38b1db56997ce1d28e53e8d22fc656d8b92e533c"},
 ]
 pyobjc-core = [
-    {file = "pyobjc-core-8.2.tar.gz", hash = "sha256:6afb8ee1dd0647cbfaaf99906eca3b43ce045b27e3d4510462d04e7e5361c89b"},
-    {file = "pyobjc_core-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:311e45556c3afa8831713b89017e0204562f51f35661d76c07ffe04985f44e1d"},
-    {file = "pyobjc_core-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:711f361e83382e405e4273ff085178b0cf730901ccf6801f834e7037e50278f9"},
-    {file = "pyobjc_core-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:bdd2e2960ec73214bcfe2d86bb4ca94f5f5119db86d129fa32d3c003b6532c50"},
-    {file = "pyobjc_core-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b879f91fc614c399aafa1d08cf5e279c267510e904bad5c336c3a6064c0eb3aa"},
-    {file = "pyobjc_core-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:b4ef4bdb99a330f5e15cc6273098964276fccbc432453cdba3c2963292bc066c"},
-    {file = "pyobjc_core-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:fd8e5be0955790ff8f9d17a0f356b6eb7eb1ce4995e0c94355c462dd52d22d6d"},
+    {file = "pyobjc-core-8.4.1.tar.gz", hash = "sha256:df98669e957adb33566d9ef46773a5ac876a81afe8849c282d6a80448e35dd74"},
+    {file = "pyobjc_core-8.4.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:9a89cac910fbd64728fe7ec0c7a3a7cf20959bc1d7e2f41db4d7800556e47745"},
+    {file = "pyobjc_core-8.4.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:2cf1d4348cb99fcba04fa38199a46e35263b2fe7bb66e6dfbd4f19bc2602998d"},
+    {file = "pyobjc_core-8.4.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:a130324b25c0f5f4cfe30b6a28b8e70865d6e1eee158caababb603906ef431d2"},
+    {file = "pyobjc_core-8.4.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:c31195d1a8f00da99abf79643f902d09c709dbbe9c9b6feb6b585303c57d720c"},
+    {file = "pyobjc_core-8.4.1-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:e7fd2aefb53a96a8f688c8bb36c6ebd5446250a7251bfa6b688a045e05afc60b"},
+    {file = "pyobjc_core-8.4.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:b3191173ce268e23c84d84f036fc94c3a8749a6726fc7fe73baf27dbac14f7d0"},
 ]
 pyobjc-framework-applicationservices = [
-    {file = "pyobjc-framework-ApplicationServices-8.2.tar.gz", hash = "sha256:f901b2ebb278b7d00033b45cf9ee9d43f651e096ff4c4defa261509238138da8"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:b5be1757a8df944a58449c628ed68fc76dd746fcd1e96ebb6db0f734e94cdfc8"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:32657c4b89983a98fbe831a14884954710719e763197968a20ac07e1daa21f1e"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:6ce2c9701590f752a75151b2fe1e462e7a7ad67dec3119a796711ea93ea01031"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:28124bc892045222305cf8953b163495bf662c401e54f48905dafb1104d9c1d1"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:d5c60d66c6ed2569cb042a6c14dd5b9f4d01e182a464b893cd6002ce445b4ddf"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:e1727fccc1d48922fa28a4cebf4a6d287d633f451cb03779968df60de8cb1bd0"},
+    {file = "pyobjc-framework-ApplicationServices-8.4.1.tar.gz", hash = "sha256:b058466266412d2bf24b0303785c91538961367f26db616bf2f9f45c498a83a3"},
+    {file = "pyobjc_framework_ApplicationServices-8.4.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:362d178c624a617fc60c3a35397550193d82da9a59272b215cf1dc6fb68c011c"},
+    {file = "pyobjc_framework_ApplicationServices-8.4.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:41f0f6be6d343f91de92cab053be4a983e3936b364ca267a94c6e06bc34ff7fe"},
+    {file = "pyobjc_framework_ApplicationServices-8.4.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:73287b758a70a037b6e74a60036f4adb1677407dfeaddee94102074d92539e6e"},
+    {file = "pyobjc_framework_ApplicationServices-8.4.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:287b541b66c5c931a11dde90d7be69ddd2e5c3624c2e980e679f5242ec3ee0da"},
+    {file = "pyobjc_framework_ApplicationServices-8.4.1-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:780fbe2e3b02237f79e2f5780094dd95b7308ecdb265c062b78a507b9564eb4d"},
+    {file = "pyobjc_framework_ApplicationServices-8.4.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:092c4835e73e5dab1f3c498511b28b2e96503671fc7c1bc25f732c5e687b7214"},
 ]
 pyobjc-framework-cocoa = [
-    {file = "pyobjc-framework-Cocoa-8.2.tar.gz", hash = "sha256:f0901998e2f18415ef6d1f8a12b083f69fc93bd56b3e88040002e3c09bd8c304"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:5af73f150e242542735e0663bb5504f88aabaec2a54c60e856cfca3ff6dd9712"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:d1de3763ee01850c311da74de5c82c85ec199120e85ab45acaf203accc37a470"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:86d69bf667f99f3c43184d8830567195fff94c675fe7f60f899dd90553d9b265"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:9dbadb22826392c48b00087359f66579f8404a4f4f77498f31f9869c54bb0fa9"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:7adf8b57da1c1292c24375b8e74b6dd45f99a4d3c10ba925a9b38f63a97ba782"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:bc8279c8c1544087d46a7e99324f093029df89b8c527c5da2a682bad4cb3197e"},
+    {file = "pyobjc-framework-Cocoa-8.4.1.tar.gz", hash = "sha256:dc596bac0f5d424f67944e95b2d0d7c94a07c4166359d7b4a4d4ae4f8e112822"},
+    {file = "pyobjc_framework_Cocoa-8.4.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:cfbe038a0108ae1b45f8f7067af70af5811b8352d2dc3d86a7bcb4484ff5d56e"},
+    {file = "pyobjc_framework_Cocoa-8.4.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:118225562064d991bafb41d0913899d6b3d723984d1888cb7181e4dba63b22c2"},
+    {file = "pyobjc_framework_Cocoa-8.4.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:d117a1eb24fd317e9f63792ac6a8703ed899de5d42e8a861c7bf885625668c31"},
+    {file = "pyobjc_framework_Cocoa-8.4.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:3af8577acbd6b980d3b9270ec99bc0164f66ef8397351a72fcdee527f23c1a34"},
+    {file = "pyobjc_framework_Cocoa-8.4.1-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:91fdc964acb4dee4d37ae81fb603d48397739dbbfcc1eadbe0cdafaa8144b6e6"},
+    {file = "pyobjc_framework_Cocoa-8.4.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:197dd28668e786b55d7d4139afd85c285f780564ebbccc166e84a24be31de34f"},
 ]
 pyobjc-framework-quartz = [
-    {file = "pyobjc-framework-Quartz-8.2.tar.gz", hash = "sha256:219d8797235bf071723f8b0f30a681de0b12875e2d04ae902a3a269f72de0b66"},
-    {file = "pyobjc_framework_Quartz-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e5ab3117201a494b11bb1b80febf5dd288111a196b35731815b656ae30ee6ce3"},
-    {file = "pyobjc_framework_Quartz-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:4941b3039ab7bcf89cb4255c381358de2383c1ab45c9e00c3b64655f271a3b32"},
-    {file = "pyobjc_framework_Quartz-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:ab75a50dea84ec794641522d9f035fc6c19ec4eb37a56c9186b9943575fbc7ab"},
-    {file = "pyobjc_framework_Quartz-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:8cb687b20ebfc467034868b38945b573d1c50f237e379cf86c4f557c9766b759"},
-    {file = "pyobjc_framework_Quartz-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:8b5c3ca1fef900fa66aafe82fff07bc352c60ea7dceed2bb9b5b1db0957b4fea"},
-    {file = "pyobjc_framework_Quartz-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:7bca7e649da77056348d71032def44e345043319d71b0c592197888d92e3eec1"},
+    {file = "pyobjc-framework-Quartz-8.4.1.tar.gz", hash = "sha256:f8acebf0b526f0687e79ea6946e8f2528ced4ef02d0ed3fbf7116124b2749e52"},
+    {file = "pyobjc_framework_Quartz-8.4.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:a82d9eab3b2a6fca46602465f731815026d06e4fd0ba65b5b5211f1a0472b861"},
+    {file = "pyobjc_framework_Quartz-8.4.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:1bd0a506385141b81330464b6e2537a7056cdca56deb98222b6926a04f72a3e6"},
+    {file = "pyobjc_framework_Quartz-8.4.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:64cc616386b7a387dce53d3adb8c12a8461c2720861ab36aeeb53768cd0ba7e4"},
+    {file = "pyobjc_framework_Quartz-8.4.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:a2dff998c4d1286998390f58a3131b99bdc9dbf5c3d881562b33f168098bbe2e"},
+    {file = "pyobjc_framework_Quartz-8.4.1-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:a98c58e1b265d5b413f5ecc6ec186b9e305fb6e37909d8b4b97fd681176f5f1c"},
+    {file = "pyobjc_framework_Quartz-8.4.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:39f55426ef883cbe12a53969f90886f71e2a94513c98cf3730efdf404cdc5c83"},
 ]
 pyparsing = [
     {file = "pyparsing-2.4.7-py2.py3-none-any.whl", hash = "sha256:ef9d7589ef3c200abe66653d3f1ab1033c3c419ae9b9bdb1240a85b024efc88b"},
@@ -2646,8 +2666,8 @@ python3-xlib = [
     {file = "python3-xlib-0.15.tar.gz", hash = "sha256:dc4245f3ae4aa5949c1d112ee4723901ade37a96721ba9645f2bfa56e5b383f8"},
 ]
 pytz = [
-    {file = "pytz-2021.3-py2.py3-none-any.whl", hash = "sha256:3672058bc3453457b622aab7a1c3bfd5ab0bdae451512f6cf25f64ed37f5b87c"},
-    {file = "pytz-2021.3.tar.gz", hash = "sha256:acad2d8b20a1af07d4e4c9d2e9285c5ed9104354062f275f3fcd88dcef4f1326"},
+    {file = "pytz-2022.1-py2.py3-none-any.whl", hash = "sha256:e68985985296d9a66a881eb3193b0906246245294a881e7c8afe623866ac6a5c"},
+    {file = "pytz-2022.1.tar.gz", hash = "sha256:1e760e2fe6a8163bc0b3d9a19c4f84342afa0a2affebfaa84b01b978a02ecaa7"},
 ]
 pywin32 = [
     {file = "pywin32-301-cp35-cp35m-win32.whl", hash = "sha256:93367c96e3a76dfe5003d8291ae16454ca7d84bb24d721e0b74a07610b7be4a7"},
@@ -2697,13 +2717,14 @@ semver = [
     {file = "semver-2.13.0-py2.py3-none-any.whl", hash = "sha256:ced8b23dceb22134307c1b8abfa523da14198793d9787ac838e70e29e77458d4"},
     {file = "semver-2.13.0.tar.gz", hash = "sha256:fa0fe2722ee1c3f57eac478820c3a5ae2f624af8264cbdf9000c980ff7f75e3f"},
 ]
+shotgun-api3 = []
 six = [
     {file = "six-1.16.0-py2.py3-none-any.whl", hash = "sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254"},
     {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"},
 ]
 slack-sdk = [
-    {file = "slack_sdk-3.13.0-py2.py3-none-any.whl", hash = "sha256:54f2a5f7419f1ab932af9e3200f7f2f93db96e0f0eb8ad7d3b4214aa9f124641"},
-    {file = "slack_sdk-3.13.0.tar.gz", hash = "sha256:aae6ce057e286a5e7fe7a9f256e85b886eee556def8e04b82b08f699e64d7f67"},
+    {file = "slack_sdk-3.15.2-py2.py3-none-any.whl", hash = "sha256:e1fa26786169176e707676decc287fd9d3d547bbc43c0a1a4f99eb373b07da94"},
+    {file = "slack_sdk-3.15.2.tar.gz", hash = "sha256:128f3bb0b5b91454a3d5f140a61f3db370a0e1b50ffe0a8d9e9ebe0e894faed7"},
 ]
 smmap = [
     {file = "smmap-5.0.0-py3-none-any.whl", hash = "sha256:2aba19d6a040e78d8b09de5c57e96207b09ed71d8e55ce0959eeee6c8e190d94"},
@@ -2714,20 +2735,20 @@ snowballstemmer = [
     {file = "snowballstemmer-2.2.0.tar.gz", hash = "sha256:09b16deb8547d3412ad7b590689584cd0fe25ec8db3be37788be3810cbf19cb1"},
 ]
 speedcopy = [
-    {file = "speedcopy-2.1.2-py3-none-any.whl", hash = "sha256:91e271b84c00952812dbf669d360b2610fd8fa198670373e02acf2a04db89a4c"},
-    {file = "speedcopy-2.1.2.tar.gz", hash = "sha256:1b2d779fadebd53a59384f7d286c40b2ef382e0d000fa53011699fcd3190d33f"},
+    {file = "speedcopy-2.1.3-py3-none-any.whl", hash = "sha256:ecbd71b7fcd2a01ce444268fb50db6bf843845aa494018571b6726f5b37c7869"},
+    {file = "speedcopy-2.1.3.tar.gz", hash = "sha256:8e14a2b94352b91229c2c0712ea39ed265ce9ec780f899e43e9f2cf5435cf959"},
 ]
 sphinx = [
-    {file = "Sphinx-3.5.3-py3-none-any.whl", hash = "sha256:3f01732296465648da43dec8fb40dc451ba79eb3e2cc5c6d79005fd98197107d"},
-    {file = "Sphinx-3.5.3.tar.gz", hash = "sha256:ce9c228456131bab09a3d7d10ae58474de562a6f79abb3dc811ae401cf8c1abc"},
+    {file = "Sphinx-4.5.0-py3-none-any.whl", hash = "sha256:ebf612653238bcc8f4359627a9b7ce44ede6fdd75d9d30f68255c7383d3a6226"},
+    {file = "Sphinx-4.5.0.tar.gz", hash = "sha256:7bf8ca9637a4ee15af412d1a1d9689fec70523a68ca9bb9127c2f3eeb344e2e6"},
 ]
 sphinx-qt-documentation = [
-    {file = "sphinx_qt_documentation-0.3-py3-none-any.whl", hash = "sha256:bee247cb9e4fc03fc496d07adfdb943100e1103320c3e5e820e0cfa7c790d9b6"},
-    {file = "sphinx_qt_documentation-0.3.tar.gz", hash = "sha256:f09a0c9d9e989172ba3e282b92bf55613bb23ad47315ec5b0d38536b343ac6c8"},
+    {file = "sphinx_qt_documentation-0.4-py3-none-any.whl", hash = "sha256:fa131093f75cd1bd48699cd132e18e4d46ba9eaadc070e6026867cea75ecdb7b"},
+    {file = "sphinx_qt_documentation-0.4.tar.gz", hash = "sha256:f43ba17baa93e353fb94045027fb67f9d935ed158ce8662de93f08b88eec6774"},
 ]
 sphinx-rtd-theme = [
-    {file = "sphinx_rtd_theme-0.5.1-py2.py3-none-any.whl", hash = "sha256:fa6bebd5ab9a73da8e102509a86f3fcc36dec04a0b52ea80e5a033b2aba00113"},
-    {file = "sphinx_rtd_theme-0.5.1.tar.gz", hash = "sha256:eda689eda0c7301a80cf122dad28b1861e5605cbf455558f3775e1e8200e83a5"},
+    {file = "sphinx_rtd_theme-1.0.0-py2.py3-none-any.whl", hash = "sha256:4d35a56f4508cfee4c4fb604373ede6feae2a306731d533f409ef5c3496fdbd8"},
+    {file = "sphinx_rtd_theme-1.0.0.tar.gz", hash = "sha256:eec6d497e4c2195fa0e8b2016b337532b8a699a68bcb22a512870e16925c6a5c"},
 ]
 sphinxcontrib-applehelp = [
     {file = "sphinxcontrib-applehelp-1.0.2.tar.gz", hash = "sha256:a072735ec80e7675e3f432fcae8610ecf509c5f1869d17e2eecff44389cdbc58"},
@@ -2770,8 +2791,8 @@ toml = [
     {file = "toml-0.10.2.tar.gz", hash = "sha256:b3bda1d108d5dd99f4a20d24d9c348e91c4db7ab1b749200bded2f839ccbe68f"},
 ]
 tomli = [
-    {file = "tomli-2.0.0-py3-none-any.whl", hash = "sha256:b5bde28da1fed24b9bd1d4d2b8cba62300bfb4ec9a6187a957e8ddb9434c5224"},
-    {file = "tomli-2.0.0.tar.gz", hash = "sha256:c292c34f58502a1eb2bbb9f5bbc9a5ebc37bee10ffb8c2d6bbdfa8eb13cc14e1"},
+    {file = "tomli-2.0.1-py3-none-any.whl", hash = "sha256:939de3e7a6161af0c887ef91b7d41a53e7c5a1ca976325f429cb46ea9bc30ecc"},
+    {file = "tomli-2.0.1.tar.gz", hash = "sha256:de526c12914f0c550d15924c62d72abc48d6fe7364aa87328337a31007fe8a4f"},
 ]
 typed-ast = [
     {file = "typed_ast-1.5.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:183b183b7771a508395d2cbffd6db67d6ad52958a5fdc99f450d954003900266"},
@@ -2800,16 +2821,16 @@ typed-ast = [
     {file = "typed_ast-1.5.2.tar.gz", hash = "sha256:525a2d4088e70a9f75b08b3f87a51acc9cde640e19cc523c7e41aa355564ae27"},
 ]
 typing-extensions = [
-    {file = "typing_extensions-4.0.1-py3-none-any.whl", hash = "sha256:7f001e5ac290a0c0401508864c7ec868be4e701886d5b573a9528ed3973d9d3b"},
-    {file = "typing_extensions-4.0.1.tar.gz", hash = "sha256:4ca091dea149f945ec56afb48dae714f21e8692ef22a395223bcd328961b6a0e"},
+    {file = "typing_extensions-4.1.1-py3-none-any.whl", hash = "sha256:21c85e0fe4b9a155d0799430b0ad741cdce7e359660ccbd8b530613e8df88ce2"},
+    {file = "typing_extensions-4.1.1.tar.gz", hash = "sha256:1a9462dcc3347a79b1f1c0271fbe79e844580bb598bafa1ed208b94da3cdcd42"},
 ]
 uritemplate = [
     {file = "uritemplate-3.0.1-py2.py3-none-any.whl", hash = "sha256:07620c3f3f8eed1f12600845892b0e036a2420acf513c53f7de0abd911a5894f"},
     {file = "uritemplate-3.0.1.tar.gz", hash = "sha256:5af8ad10cec94f215e3f48112de2022e1d5a37ed427fbd88652fa908f2ab7cae"},
 ]
 urllib3 = [
-    {file = "urllib3-1.26.8-py2.py3-none-any.whl", hash = "sha256:000ca7f471a233c2251c6c7023ee85305721bfdf18621ebff4fd17a8653427ed"},
-    {file = "urllib3-1.26.8.tar.gz", hash = "sha256:0e7c33d9a63e7ddfcb86780aac87befc2fbddf46c58dbb487e0855f7ceec283c"},
+    {file = "urllib3-1.26.9-py2.py3-none-any.whl", hash = "sha256:44ece4d53fb1706f667c9bd1c648f5469a2ec925fcf3a776667042d645472c14"},
+    {file = "urllib3-1.26.9.tar.gz", hash = "sha256:aabaf16477806a5e1dd19aa41f8c2b7950dd3c746362d7e3223dbe6de6ac448e"},
 ]
 wcwidth = [
     {file = "wcwidth-0.2.5-py2.py3-none-any.whl", hash = "sha256:beb4802a9cebb9144e99086eff703a642a13d6a0052920003a230f3294bbe784"},
@@ -2820,57 +2841,70 @@ websocket-client = [
     {file = "websocket_client-0.59.0-py2.py3-none-any.whl", hash = "sha256:2e50d26ca593f70aba7b13a489435ef88b8fc3b5c5643c1ce8808ff9b40f0b32"},
 ]
 wrapt = [
-    {file = "wrapt-1.13.3-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:e05e60ff3b2b0342153be4d1b597bbcfd8330890056b9619f4ad6b8d5c96a81a"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux1_i686.whl", hash = "sha256:85148f4225287b6a0665eef08a178c15097366d46b210574a658c1ff5b377489"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux1_x86_64.whl", hash = "sha256:2dded5496e8f1592ec27079b28b6ad2a1ef0b9296d270f77b8e4a3a796cf6909"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux2010_i686.whl", hash = "sha256:e94b7d9deaa4cc7bac9198a58a7240aaf87fe56c6277ee25fa5b3aa1edebd229"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux2010_x86_64.whl", hash = "sha256:498e6217523111d07cd67e87a791f5e9ee769f9241fcf8a379696e25806965af"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux1_i686.whl", hash = "sha256:ec7e20258ecc5174029a0f391e1b948bf2906cd64c198a9b8b281b811cbc04de"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux1_x86_64.whl", hash = "sha256:87883690cae293541e08ba2da22cacaae0a092e0ed56bbba8d018cc486fbafbb"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux2010_i686.whl", hash = "sha256:f99c0489258086308aad4ae57da9e8ecf9e1f3f30fa35d5e170b4d4896554d80"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux2010_x86_64.whl", hash = "sha256:6a03d9917aee887690aa3f1747ce634e610f6db6f6b332b35c2dd89412912bca"},
-    {file = "wrapt-1.13.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:936503cb0a6ed28dbfa87e8fcd0a56458822144e9d11a49ccee6d9a8adb2ac44"},
-    {file = "wrapt-1.13.3-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:f9c51d9af9abb899bd34ace878fbec8bf357b3194a10c4e8e0a25512826ef056"},
-    {file = "wrapt-1.13.3-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:220a869982ea9023e163ba915077816ca439489de6d2c09089b219f4e11b6785"},
-    {file = "wrapt-1.13.3-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:0877fe981fd76b183711d767500e6b3111378ed2043c145e21816ee589d91096"},
-    {file = "wrapt-1.13.3-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:43e69ffe47e3609a6aec0fe723001c60c65305784d964f5007d5b4fb1bc6bf33"},
-    {file = "wrapt-1.13.3-cp310-cp310-win32.whl", hash = "sha256:78dea98c81915bbf510eb6a3c9c24915e4660302937b9ae05a0947164248020f"},
-    {file = "wrapt-1.13.3-cp310-cp310-win_amd64.whl", hash = "sha256:ea3e746e29d4000cd98d572f3ee2a6050a4f784bb536f4ac1f035987fc1ed83e"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux1_i686.whl", hash = "sha256:8c73c1a2ec7c98d7eaded149f6d225a692caa1bd7b2401a14125446e9e90410d"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux1_x86_64.whl", hash = "sha256:086218a72ec7d986a3eddb7707c8c4526d677c7b35e355875a0fe2918b059179"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux2010_i686.whl", hash = "sha256:e92d0d4fa68ea0c02d39f1e2f9cb5bc4b4a71e8c442207433d8db47ee79d7aa3"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux2010_x86_64.whl", hash = "sha256:d4a5f6146cfa5c7ba0134249665acd322a70d1ea61732723c7d3e8cc0fa80755"},
-    {file = "wrapt-1.13.3-cp35-cp35m-win32.whl", hash = "sha256:8aab36778fa9bba1a8f06a4919556f9f8c7b33102bd71b3ab307bb3fecb21851"},
-    {file = "wrapt-1.13.3-cp35-cp35m-win_amd64.whl", hash = "sha256:944b180f61f5e36c0634d3202ba8509b986b5fbaf57db3e94df11abee244ba13"},
-    {file = "wrapt-1.13.3-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:2ebdde19cd3c8cdf8df3fc165bc7827334bc4e353465048b36f7deeae8ee0918"},
-    {file = "wrapt-1.13.3-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:610f5f83dd1e0ad40254c306f4764fcdc846641f120c3cf424ff57a19d5f7ade"},
-    {file = "wrapt-1.13.3-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:5601f44a0f38fed36cc07db004f0eedeaadbdcec90e4e90509480e7e6060a5bc"},
-    {file = "wrapt-1.13.3-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:e6906d6f48437dfd80464f7d7af1740eadc572b9f7a4301e7dd3d65db285cacf"},
-    {file = "wrapt-1.13.3-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:766b32c762e07e26f50d8a3468e3b4228b3736c805018e4b0ec8cc01ecd88125"},
-    {file = "wrapt-1.13.3-cp36-cp36m-win32.whl", hash = "sha256:5f223101f21cfd41deec8ce3889dc59f88a59b409db028c469c9b20cfeefbe36"},
-    {file = "wrapt-1.13.3-cp36-cp36m-win_amd64.whl", hash = "sha256:f122ccd12fdc69628786d0c947bdd9cb2733be8f800d88b5a37c57f1f1d73c10"},
-    {file = "wrapt-1.13.3-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:46f7f3af321a573fc0c3586612db4decb7eb37172af1bc6173d81f5b66c2e068"},
-    {file = "wrapt-1.13.3-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:778fd096ee96890c10ce96187c76b3e99b2da44e08c9e24d5652f356873f6709"},
-    {file = "wrapt-1.13.3-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:0cb23d36ed03bf46b894cfec777eec754146d68429c30431c99ef28482b5c1df"},
-    {file = "wrapt-1.13.3-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:96b81ae75591a795d8c90edc0bfaab44d3d41ffc1aae4d994c5aa21d9b8e19a2"},
-    {file = "wrapt-1.13.3-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:7dd215e4e8514004c8d810a73e342c536547038fb130205ec4bba9f5de35d45b"},
-    {file = "wrapt-1.13.3-cp37-cp37m-win32.whl", hash = "sha256:47f0a183743e7f71f29e4e21574ad3fa95676136f45b91afcf83f6a050914829"},
-    {file = "wrapt-1.13.3-cp37-cp37m-win_amd64.whl", hash = "sha256:fd76c47f20984b43d93de9a82011bb6e5f8325df6c9ed4d8310029a55fa361ea"},
-    {file = "wrapt-1.13.3-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b73d4b78807bd299b38e4598b8e7bd34ed55d480160d2e7fdaabd9931afa65f9"},
-    {file = "wrapt-1.13.3-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:ec9465dd69d5657b5d2fa6133b3e1e989ae27d29471a672416fd729b429eb554"},
-    {file = "wrapt-1.13.3-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:dd91006848eb55af2159375134d724032a2d1d13bcc6f81cd8d3ed9f2b8e846c"},
-    {file = "wrapt-1.13.3-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:ae9de71eb60940e58207f8e71fe113c639da42adb02fb2bcbcaccc1ccecd092b"},
-    {file = "wrapt-1.13.3-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:51799ca950cfee9396a87f4a1240622ac38973b6df5ef7a41e7f0b98797099ce"},
-    {file = "wrapt-1.13.3-cp38-cp38-win32.whl", hash = "sha256:4b9c458732450ec42578b5642ac53e312092acf8c0bfce140ada5ca1ac556f79"},
-    {file = "wrapt-1.13.3-cp38-cp38-win_amd64.whl", hash = "sha256:7dde79d007cd6dfa65afe404766057c2409316135cb892be4b1c768e3f3a11cb"},
-    {file = "wrapt-1.13.3-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:981da26722bebb9247a0601e2922cedf8bb7a600e89c852d063313102de6f2cb"},
-    {file = "wrapt-1.13.3-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:705e2af1f7be4707e49ced9153f8d72131090e52be9278b5dbb1498c749a1e32"},
-    {file = "wrapt-1.13.3-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:25b1b1d5df495d82be1c9d2fad408f7ce5ca8a38085e2da41bb63c914baadff7"},
-    {file = "wrapt-1.13.3-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:77416e6b17926d953b5c666a3cb718d5945df63ecf922af0ee576206d7033b5e"},
-    {file = "wrapt-1.13.3-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:865c0b50003616f05858b22174c40ffc27a38e67359fa1495605f96125f76640"},
-    {file = "wrapt-1.13.3-cp39-cp39-win32.whl", hash = "sha256:0a017a667d1f7411816e4bf214646d0ad5b1da2c1ea13dec6c162736ff25a374"},
-    {file = "wrapt-1.13.3-cp39-cp39-win_amd64.whl", hash = "sha256:81bd7c90d28a4b2e1df135bfbd7c23aee3050078ca6441bead44c42483f9ebfb"},
-    {file = "wrapt-1.13.3.tar.gz", hash = "sha256:1fea9cd438686e6682271d36f3481a9f3636195578bab9ca3382e2f5f01fc185"},
+    {file = "wrapt-1.14.0-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:5a9a1889cc01ed2ed5f34574c90745fab1dd06ec2eee663e8ebeefe363e8efd7"},
+    {file = "wrapt-1.14.0-cp27-cp27m-manylinux1_i686.whl", hash = "sha256:9a3ff5fb015f6feb78340143584d9f8a0b91b6293d6b5cf4295b3e95d179b88c"},
+    {file = "wrapt-1.14.0-cp27-cp27m-manylinux1_x86_64.whl", hash = "sha256:4b847029e2d5e11fd536c9ac3136ddc3f54bc9488a75ef7d040a3900406a91eb"},
+    {file = "wrapt-1.14.0-cp27-cp27m-manylinux2010_i686.whl", hash = "sha256:9a5a544861b21e0e7575b6023adebe7a8c6321127bb1d238eb40d99803a0e8bd"},
+    {file = "wrapt-1.14.0-cp27-cp27m-manylinux2010_x86_64.whl", hash = "sha256:88236b90dda77f0394f878324cfbae05ae6fde8a84d548cfe73a75278d760291"},
+    {file = "wrapt-1.14.0-cp27-cp27mu-manylinux1_i686.whl", hash = "sha256:f0408e2dbad9e82b4c960274214af533f856a199c9274bd4aff55d4634dedc33"},
+    {file = "wrapt-1.14.0-cp27-cp27mu-manylinux1_x86_64.whl", hash = "sha256:9d8c68c4145041b4eeae96239802cfdfd9ef927754a5be3f50505f09f309d8c6"},
+    {file = "wrapt-1.14.0-cp27-cp27mu-manylinux2010_i686.whl", hash = "sha256:22626dca56fd7f55a0733e604f1027277eb0f4f3d95ff28f15d27ac25a45f71b"},
+    {file = "wrapt-1.14.0-cp27-cp27mu-manylinux2010_x86_64.whl", hash = "sha256:65bf3eb34721bf18b5a021a1ad7aa05947a1767d1aa272b725728014475ea7d5"},
+    {file = "wrapt-1.14.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:09d16ae7a13cff43660155383a2372b4aa09109c7127aa3f24c3cf99b891c330"},
+    {file = "wrapt-1.14.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:debaf04f813ada978d7d16c7dfa16f3c9c2ec9adf4656efdc4defdf841fc2f0c"},
+    {file = "wrapt-1.14.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:748df39ed634851350efa87690c2237a678ed794fe9ede3f0d79f071ee042561"},
+    {file = "wrapt-1.14.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1807054aa7b61ad8d8103b3b30c9764de2e9d0c0978e9d3fc337e4e74bf25faa"},
+    {file = "wrapt-1.14.0-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:763a73ab377390e2af26042f685a26787c402390f682443727b847e9496e4a2a"},
+    {file = "wrapt-1.14.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:8529b07b49b2d89d6917cfa157d3ea1dfb4d319d51e23030664a827fe5fd2131"},
+    {file = "wrapt-1.14.0-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:68aeefac31c1f73949662ba8affaf9950b9938b712fb9d428fa2a07e40ee57f8"},
+    {file = "wrapt-1.14.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:59d7d92cee84a547d91267f0fea381c363121d70fe90b12cd88241bd9b0e1763"},
+    {file = "wrapt-1.14.0-cp310-cp310-win32.whl", hash = "sha256:3a88254881e8a8c4784ecc9cb2249ff757fd94b911d5df9a5984961b96113fff"},
+    {file = "wrapt-1.14.0-cp310-cp310-win_amd64.whl", hash = "sha256:9a242871b3d8eecc56d350e5e03ea1854de47b17f040446da0e47dc3e0b9ad4d"},
+    {file = "wrapt-1.14.0-cp35-cp35m-manylinux1_i686.whl", hash = "sha256:a65bffd24409454b889af33b6c49d0d9bcd1a219b972fba975ac935f17bdf627"},
+    {file = "wrapt-1.14.0-cp35-cp35m-manylinux1_x86_64.whl", hash = "sha256:9d9fcd06c952efa4b6b95f3d788a819b7f33d11bea377be6b8980c95e7d10775"},
+    {file = "wrapt-1.14.0-cp35-cp35m-manylinux2010_i686.whl", hash = "sha256:db6a0ddc1282ceb9032e41853e659c9b638789be38e5b8ad7498caac00231c23"},
+    {file = "wrapt-1.14.0-cp35-cp35m-manylinux2010_x86_64.whl", hash = "sha256:14e7e2c5f5fca67e9a6d5f753d21f138398cad2b1159913ec9e9a67745f09ba3"},
+    {file = "wrapt-1.14.0-cp35-cp35m-win32.whl", hash = "sha256:6d9810d4f697d58fd66039ab959e6d37e63ab377008ef1d63904df25956c7db0"},
+    {file = "wrapt-1.14.0-cp35-cp35m-win_amd64.whl", hash = "sha256:d808a5a5411982a09fef6b49aac62986274ab050e9d3e9817ad65b2791ed1425"},
+    {file = "wrapt-1.14.0-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:b77159d9862374da213f741af0c361720200ab7ad21b9f12556e0eb95912cd48"},
+    {file = "wrapt-1.14.0-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:36a76a7527df8583112b24adc01748cd51a2d14e905b337a6fefa8b96fc708fb"},
+    {file = "wrapt-1.14.0-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a0057b5435a65b933cbf5d859cd4956624df37b8bf0917c71756e4b3d9958b9e"},
+    {file = "wrapt-1.14.0-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3a0a4ca02752ced5f37498827e49c414d694ad7cf451ee850e3ff160f2bee9d3"},
+    {file = "wrapt-1.14.0-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:8c6be72eac3c14baa473620e04f74186c5d8f45d80f8f2b4eda6e1d18af808e8"},
+    {file = "wrapt-1.14.0-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:21b1106bff6ece8cb203ef45b4f5778d7226c941c83aaaa1e1f0f4f32cc148cd"},
+    {file = "wrapt-1.14.0-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:493da1f8b1bb8a623c16552fb4a1e164c0200447eb83d3f68b44315ead3f9036"},
+    {file = "wrapt-1.14.0-cp36-cp36m-win32.whl", hash = "sha256:89ba3d548ee1e6291a20f3c7380c92f71e358ce8b9e48161401e087e0bc740f8"},
+    {file = "wrapt-1.14.0-cp36-cp36m-win_amd64.whl", hash = "sha256:729d5e96566f44fccac6c4447ec2332636b4fe273f03da128fff8d5559782b06"},
+    {file = "wrapt-1.14.0-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:891c353e95bb11abb548ca95c8b98050f3620a7378332eb90d6acdef35b401d4"},
+    {file = "wrapt-1.14.0-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:23f96134a3aa24cc50614920cc087e22f87439053d886e474638c68c8d15dc80"},
+    {file = "wrapt-1.14.0-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6807bcee549a8cb2f38f73f469703a1d8d5d990815c3004f21ddb68a567385ce"},
+    {file = "wrapt-1.14.0-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6915682f9a9bc4cf2908e83caf5895a685da1fbd20b6d485dafb8e218a338279"},
+    {file = "wrapt-1.14.0-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:f2f3bc7cd9c9fcd39143f11342eb5963317bd54ecc98e3650ca22704b69d9653"},
+    {file = "wrapt-1.14.0-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:3a71dbd792cc7a3d772ef8cd08d3048593f13d6f40a11f3427c000cf0a5b36a0"},
+    {file = "wrapt-1.14.0-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:5a0898a640559dec00f3614ffb11d97a2666ee9a2a6bad1259c9facd01a1d4d9"},
+    {file = "wrapt-1.14.0-cp37-cp37m-win32.whl", hash = "sha256:167e4793dc987f77fd476862d32fa404d42b71f6a85d3b38cbce711dba5e6b68"},
+    {file = "wrapt-1.14.0-cp37-cp37m-win_amd64.whl", hash = "sha256:d066ffc5ed0be00cd0352c95800a519cf9e4b5dd34a028d301bdc7177c72daf3"},
+    {file = "wrapt-1.14.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:d9bdfa74d369256e4218000a629978590fd7cb6cf6893251dad13d051090436d"},
+    {file = "wrapt-1.14.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:2498762814dd7dd2a1d0248eda2afbc3dd9c11537bc8200a4b21789b6df6cd38"},
+    {file = "wrapt-1.14.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5f24ca7953f2643d59a9c87d6e272d8adddd4a53bb62b9208f36db408d7aafc7"},
+    {file = "wrapt-1.14.0-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5b835b86bd5a1bdbe257d610eecab07bf685b1af2a7563093e0e69180c1d4af1"},
+    {file = "wrapt-1.14.0-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b21650fa6907e523869e0396c5bd591cc326e5c1dd594dcdccac089561cacfb8"},
+    {file = "wrapt-1.14.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:354d9fc6b1e44750e2a67b4b108841f5f5ea08853453ecbf44c81fdc2e0d50bd"},
+    {file = "wrapt-1.14.0-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:1f83e9c21cd5275991076b2ba1cd35418af3504667affb4745b48937e214bafe"},
+    {file = "wrapt-1.14.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:61e1a064906ccba038aa3c4a5a82f6199749efbbb3cef0804ae5c37f550eded0"},
+    {file = "wrapt-1.14.0-cp38-cp38-win32.whl", hash = "sha256:28c659878f684365d53cf59dc9a1929ea2eecd7ac65da762be8b1ba193f7e84f"},
+    {file = "wrapt-1.14.0-cp38-cp38-win_amd64.whl", hash = "sha256:b0ed6ad6c9640671689c2dbe6244680fe8b897c08fd1fab2228429b66c518e5e"},
+    {file = "wrapt-1.14.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:b3f7e671fb19734c872566e57ce7fc235fa953d7c181bb4ef138e17d607dc8a1"},
+    {file = "wrapt-1.14.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:87fa943e8bbe40c8c1ba4086971a6fefbf75e9991217c55ed1bcb2f1985bd3d4"},
+    {file = "wrapt-1.14.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4775a574e9d84e0212f5b18886cace049a42e13e12009bb0491562a48bb2b758"},
+    {file = "wrapt-1.14.0-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9d57677238a0c5411c76097b8b93bdebb02eb845814c90f0b01727527a179e4d"},
+    {file = "wrapt-1.14.0-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:00108411e0f34c52ce16f81f1d308a571df7784932cc7491d1e94be2ee93374b"},
+    {file = "wrapt-1.14.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:d332eecf307fca852d02b63f35a7872de32d5ba8b4ec32da82f45df986b39ff6"},
+    {file = "wrapt-1.14.0-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:01f799def9b96a8ec1ef6b9c1bbaf2bbc859b87545efbecc4a78faea13d0e3a0"},
+    {file = "wrapt-1.14.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:47045ed35481e857918ae78b54891fac0c1d197f22c95778e66302668309336c"},
+    {file = "wrapt-1.14.0-cp39-cp39-win32.whl", hash = "sha256:2eca15d6b947cfff51ed76b2d60fd172c6ecd418ddab1c5126032d27f74bc350"},
+    {file = "wrapt-1.14.0-cp39-cp39-win_amd64.whl", hash = "sha256:bb36fbb48b22985d13a6b496ea5fb9bb2a076fea943831643836c9f6febbcfdc"},
+    {file = "wrapt-1.14.0.tar.gz", hash = "sha256:8323a43bd9c91f62bb7d4be74cc9ff10090e7ef820e27bfe8815c57e68261311"},
 ]
 wsrpc-aiohttp = [
     {file = "wsrpc-aiohttp-3.2.0.tar.gz", hash = "sha256:f467abc51bcdc760fc5aeb7041abdeef46eeca3928dc43dd6e7fa7a533563818"},
@@ -2951,6 +2985,6 @@ yarl = [
     {file = "yarl-1.7.2.tar.gz", hash = "sha256:45399b46d60c253327a460e99856752009fcee5f5d3c80b2f7c0cae1c38d56dd"},
 ]
 zipp = [
-    {file = "zipp-3.7.0-py3-none-any.whl", hash = "sha256:b47250dd24f92b7dd6a0a8fc5244da14608f3ca90a5efcd37a3b1642fac9a375"},
-    {file = "zipp-3.7.0.tar.gz", hash = "sha256:9f50f446828eb9d45b267433fd3e9da8d801f614129124863f9c51ebceafb87d"},
+    {file = "zipp-3.8.0-py3-none-any.whl", hash = "sha256:c4f6e5bbf48e74f7a38e7cc5b0480ff42b0ae5178957d564d18932525d5cf099"},
+    {file = "zipp-3.8.0.tar.gz", hash = "sha256:56bf8aadb83c24db6c4b577e13de374ccfb67da2078beba1d037c17980bf43ad"},
 ]

From 3a3e552b0aeb353a1e74144993faab84b0a2c395 Mon Sep 17 00:00:00 2001
From: BenoitConnan <benoitconnan.pro@gmail.com>
Date: Fri, 8 Apr 2022 16:28:28 +0200
Subject: [PATCH 0091/1227] Make the publish work under maya 2018

---
 openpype/modules/shotgrid/aop/patch.py       | 15 +++++++++------
 openpype/modules/shotgrid/lib/__init__.py    |  0
 openpype/modules/shotgrid/lib/settings.py    |  6 +++---
 openpype/modules/shotgrid/shotgrid_module.py | 13 +++++++------
 4 files changed, 19 insertions(+), 15 deletions(-)
 create mode 100644 openpype/modules/shotgrid/lib/__init__.py

diff --git a/openpype/modules/shotgrid/aop/patch.py b/openpype/modules/shotgrid/aop/patch.py
index 208ca715d3..580aa2341f 100644
--- a/openpype/modules/shotgrid/aop/patch.py
+++ b/openpype/modules/shotgrid/aop/patch.py
@@ -1,6 +1,5 @@
 from copy import copy
 
-from avalon.api import AvalonMongoDB
 
 from openpype.api import Logger
 from openpype.modules.shotgrid.lib import (
@@ -42,8 +41,12 @@ def _fetch_linked_project_names():
 
 def patch_avalon_db():
     _LOG.debug("Run avalon patching")
-    if AvalonMongoDB.projects is _patched_projects:
-        return None
-    _LOG.debug("Patch Avalon.projects method")
-    AvalonMongoDB._prev_projects = copy(AvalonMongoDB.projects)
-    AvalonMongoDB.projects = _patched_projects
+    try:
+        from avalon.api import AvalonMongoDB
+        if AvalonMongoDB.projects is _patched_projects:
+            return None
+        _LOG.debug("Patch Avalon.projects method")
+        AvalonMongoDB._prev_projects = copy(AvalonMongoDB.projects)
+        AvalonMongoDB.projects = _patched_projects
+    except e:
+        _LOG.error("Unable to patch avalon db "+ e)
diff --git a/openpype/modules/shotgrid/lib/__init__.py b/openpype/modules/shotgrid/lib/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/modules/shotgrid/lib/settings.py b/openpype/modules/shotgrid/lib/settings.py
index 954b96f3c2..4c21501b99 100644
--- a/openpype/modules/shotgrid/lib/settings.py
+++ b/openpype/modules/shotgrid/lib/settings.py
@@ -1,5 +1,5 @@
 import os
-from functools import lru_cache
+# from functools import lru_cache
 
 from pymongo import MongoClient
 from openpype.api import get_system_settings, get_project_settings
@@ -13,12 +13,12 @@ def get_project_list():
     return db.list_collection_names()
 
 
-@lru_cache(maxsize=64)
+# @lru_cache(maxsize=64)
 def get_shotgrid_project_settings(project):
     return get_project_settings(project).get(MODULE_NAME, {})
 
 
-@lru_cache(maxsize=64)
+# @lru_cache(maxsize=64)
 def get_shotgrid_settings():
     return get_system_settings().get("modules", {}).get(MODULE_NAME, {})
 
diff --git a/openpype/modules/shotgrid/shotgrid_module.py b/openpype/modules/shotgrid/shotgrid_module.py
index 1f05ae5a52..009f0028f0 100644
--- a/openpype/modules/shotgrid/shotgrid_module.py
+++ b/openpype/modules/shotgrid/shotgrid_module.py
@@ -8,10 +8,6 @@ from openpype_interfaces import (
 )
 
 from openpype.modules import OpenPypeModule
-from .aop.patch import patch_avalon_db
-from .tray.shotgrid_tray import (
-    ShotgridTrayWrapper,
-)
 
 SHOTGRID_MODULE_DIR = os.path.dirname(os.path.abspath(__file__))
 
@@ -26,8 +22,6 @@ class ShotgridModule(
     tray_wrapper = None
 
     def initialize(self, modules_settings):
-        patch_avalon_db()
-        threading.Timer(10.0, patch_avalon_db).start()
         shotgrid_settings = modules_settings.get(self.name, dict())
         self.enabled = shotgrid_settings.get("enabled", False)
         self.leecher_manager_url = shotgrid_settings.get(
@@ -51,8 +45,15 @@ class ShotgridModule(
         return os.path.join(SHOTGRID_MODULE_DIR, "hooks")
 
     def tray_init(self):
+        from .tray.shotgrid_tray import ShotgridTrayWrapper
+        from .aop.patch import patch_avalon_db
+
+        patch_avalon_db()
+        threading.Timer(10.0, patch_avalon_db).start()
+
         self.tray_wrapper = ShotgridTrayWrapper(self)
 
+
     def tray_start(self):
         return self.tray_wrapper.validate()
 

From e6fd10925db80eeb73038a06330617325e318aab Mon Sep 17 00:00:00 2001
From: Paolo Berto Durante <pberto@gmail.com>
Date: Sun, 10 Apr 2022 20:17:22 +0900
Subject: [PATCH 0092/1227] plugins: modified labels for multiverse
 creators/publishers/loader

---
 openpype/hosts/maya/plugins/create/create_multiverse_usd.py   | 4 ++--
 .../hosts/maya/plugins/create/create_multiverse_usd_over.py   | 2 +-
 openpype/hosts/maya/plugins/load/load_multiverse_usd.py       | 4 ++--
 openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py | 4 ++--
 .../hosts/maya/plugins/publish/extract_multiverse_usd_over.py | 2 +-
 5 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
index b2266e5a57..ff08bf3015 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
@@ -2,10 +2,10 @@ from openpype.hosts.maya.api import plugin, lib
 
 
 class CreateMultiverseUsd(plugin.Creator):
-    """Multiverse USD data"""
+    """Multiverse USD asset data"""
 
     name = "usdMain"
-    label = "Multiverse USD"
+    label = "Multiverse USD Asset"
     family = "usd"
     icon = "cubes"
 
diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
index bb82ab2039..22c9ce1890 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
@@ -2,7 +2,7 @@ from openpype.hosts.maya.api import plugin, lib
 
 
 class CreateMultiverseUsdOver(plugin.Creator):
-    """Multiverse USD data"""
+    """Multiverse USD Override"""
 
     name = "usdOverrideMain"
     label = "Multiverse USD Override"
diff --git a/openpype/hosts/maya/plugins/load/load_multiverse_usd.py b/openpype/hosts/maya/plugins/load/load_multiverse_usd.py
index c03f2c5d92..ed0ffc8ef1 100644
--- a/openpype/hosts/maya/plugins/load/load_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/load/load_multiverse_usd.py
@@ -14,13 +14,13 @@ from openpype.hosts.maya.api.pipeline import containerise
 
 
 class MultiverseUsdLoader(load.LoaderPlugin):
-    """Load the USD by Multiverse"""
+    """Read USD data in a Multiverse Compound"""
 
     families = ["model", "usd", "usdComposition", "usdOverride",
                 "pointcache", "animation"]
     representations = ["usd", "usda", "usdc", "usdz", "abc"]
 
-    label = "Read USD by Multiverse"
+    label = "Load USD to Multiverse"
     order = -10
     icon = "code-fork"
     color = "orange"
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
index 4e4efdc32c..678a4eb7df 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
@@ -8,9 +8,9 @@ from openpype.hosts.maya.api.lib import maintained_selection
 
 
 class ExtractMultiverseUsd(openpype.api.Extractor):
-    """Extractor for USD by Multiverse."""
+    """Extractor for Multiverse USD asset data."""
 
-    label = "Extract Multiverse USD"
+    label = "Extract Multiverse USD Asset"
     hosts = ["maya"]
     families = ["usd"]
 
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
index ce0e8a392a..4a78635c8b 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
@@ -7,7 +7,7 @@ from maya import cmds
 
 
 class ExtractMultiverseUsdOverride(openpype.api.Extractor):
-    """Extractor for USD Override by Multiverse."""
+    """Extractor for Multiverse USD Override."""
 
     label = "Extract Multiverse USD Override"
     hosts = ["maya"]

From 70fe3f87127b7476f6c3d84437e292dba5022459 Mon Sep 17 00:00:00 2001
From: Paolo Berto Durante <pberto@gmail.com>
Date: Sun, 10 Apr 2022 20:17:55 +0900
Subject: [PATCH 0093/1227] documentation: added initial multiverse docs

---
 website/docs/artist_hosts_maya.md | 163 ++++++++++++++++++++++++++++++
 1 file changed, 163 insertions(+)

diff --git a/website/docs/artist_hosts_maya.md b/website/docs/artist_hosts_maya.md
index 73e89384e8..84285bc6dd 100644
--- a/website/docs/artist_hosts_maya.md
+++ b/website/docs/artist_hosts_maya.md
@@ -598,6 +598,169 @@ about customizing review process refer to [admin section](project_settings/setti
 If you don't move `modelMain` into `reviewMain`, review will be generated but it will
 be published as separate entity.
 
+
+## Working with Multiverse in OpenPype
+
+OpenPype supports creating, publishing and loading of [Multiverse | USD](
+https://multi-verse.io) data.
+
+More specifically it is possible to:
+
+- Create USD Assets, USD compositions and USD Overrides. This _creates_ OpenPype
+  instances as Maya set nodes that contain information for published USD data.
+- Publish USD Assets, USD compositions and USD Overrides. This _writes_ USD
+  files to disk and _publishes_ information to the OpenPype database.
+- Load any USD data into Multiverse "Compound" shape nodes. This _reads_ USD
+  files (and also Alembic files) into Maya by streaming them to the viewport.
+- Rendering USD data procedurally with 3Delight<sup>NSI</sup>, Arnold, Redshift,
+  RenderMan and VRay. This reads USD files by streaming them procedurally to the renderer, at render time.
+
+USD files written by Multiverse are 100% native USD data, they can be exchanged
+with any other DCC applications able to interchange USD. Likewise, Multiverse
+can read native USD data created by other applications. All the extensions are
+supported: `.usd`, `.usdc`, `.usda`, `.usdz`. Sequences of USD files can also be
+read, as USD clips.
+
+It is also possible to load Alembic data (`.abc`) in Multiverse Compounds,
+further compose it & override it in other USD files, and render it procedurally.
+Alembic data is always converted on the fly (in memory) to USD data. USD clip
+from Alembic data are also supported.
+
+### Configuration
+
+To configure Multiverse in OpenPype, a user with admin privileges needs to setup
+a new tool in OpenPype Project Settings, using a similar configuration as
+depicted here:
+
+![Maya - Multiverse Setup](assets/maya-multiverse_setup.png)
+
+For more information about setup of Multiverse please refer to: LINK.
+
+
+### Understanding Assets, Compositions and Overrides
+
+In Multiverse there are three main concepts for representing USD data.
+
+
+#### Assets
+
+In Multiverse, the term "asset" refers to a USD file that contains a hierarchy
+of primitives (transforms and shapes). In Maya this is typically a hierarchy of
+nodes, as it can be seen in Outliner, that is written out to a USD file. Once
+loaded, the same hierarchy will be visible in MEOW (Multiverse Explore and
+Override Window).
+
+![Maya - Outliner vs MEOW](assets/maya-multiverse_asset_outliner_meow.png)
+
+An asset typically contains static or animated data such as: poly meshes, blend
+shapes, reference objects, particles/points, curves, joint, subdivision surfaces
+and other attributes such as normals, UVs, color sets, tangents, skin weights,
+material assignment and shading networks, cameras, lights etc. It is also
+possible to specify Maya data to be part of variants and to be used as proxies
+by tagging them with attributes.
+
+An asset is typically read back into Maya into a Multiverse Compound shape
+node and it can be composed and overridden.
+
+![Maya - Multiverse Compound Shape(assets/maya-multiverse_compound.png)
+
+
+#### Composition
+
+In Multiverse, the term "composition" refers to a USD file that contains a
+hierarchy of Multiverse Compounds shape nodes and Maya transform nodes, as it
+can be seen in Outliner. This hierarchy is written out to a USD file that
+effectively contains a static or animated composition of other USD files written
+as references or payloads (according to the relative setting in the Compound).
+
+![Maya - Multiverse Composition](assets/maya-multiverse_composition_outliner_meow.png)
+
+A Composition is is typically read back into Maya into a Multiverse Compound
+shape and it can be further composed and overridden.
+
+
+#### Override
+
+In Multiverse, the term "override" refers to a USD file that contains static or animated overrides for a USD hierarchy. Overrides are set in MEOW, they can be:
+
+- render visibility overrides
+- transform overrides
+- attribute overrides
+- material assignment overrides
+- variant and variant definition overrides
+- Instancing state overrides
+- activity state overrides
+
+![Maya - Multiverse Override](assets/maya-multiverse_override_meow.png)
+
+Overrides are written out to a USD file that effectively contains a static or
+animated hierarchy of overrides that can be "layered" on top of Assets,
+Compositions and other Overrides.
+
+![Maya - Multiverse Override](assets/maya-multiverse_override_compound_layer.png)
+
+An Override is is typically read back into Maya as a layer of a Multiverse
+Compound shape and it can be further composed and overridden.
+
+
+### Creators
+
+It is possible to create OpenPype "instances" (Maya sets) for publishing
+Multiverse USD Asset, Composition and Override.
+
+![Maya - Multiverse Creators](assets/maya-multiverse_openpype_creator.png)
+
+When creating OpenPype instances for Multiverse USD asset, compositions and
+overrides the creator plug-in will put the relative selected data in a Maya set
+node which holds the properties used by the Multiverse data writer for
+publishing.
+
+
+### Publishers
+
+The relative publishers for Asset, Composition and Overrides are available. They
+all write USD files to disk and communicate publish info to the OpenPype
+database.
+
+![Maya - Multiverse Creators](assets/maya-multiverse_openpype_publisher.png)
+
+
+### Loader
+
+The loader creates a Multiverse Compound shape node reading the USD file of
+choice. All data is streamed to the viewport and not contained in Maya. Thanks
+to the various viewport load options the user can strategically decide how to
+minimize the cost of viewport draw effectively being able to load any data, this
+allows to bring into Maya scenes of virtually unlimited complexity.
+
+![Maya - Multiverse Loader](assets/maya-multiverse_openpype_loader.png)
+
+:::tip Note
+When using the Loader, Multiverse, by design, never "imports" USD data into the
+Maya scene as Maya data. Instead, when desired, Multiverse permits to import
+specific USD primitives into the Maya scene as Maya data selectively from MEOW,
+it also tracks what is being imported, so upon modification, it is possible to
+write (create & publish) the modifies data as a USD file for being layered on
+top of its relative Compound. See LINK.
+:::
+
+### Rendering
+
+Multiverse offers procedural rendering with all the major production renderers:
+
+- 3Delight<sup>NSI</sup>
+- Arnold
+- Redshift
+- RenderMan
+- VRay
+
+This is completely transparent to the user: Multiverse Compound nodes present in
+the scene, once a render is launched, will stream data to the renderer in a
+procedural fashion.
+
+![Maya - Multiverse Rendering](assets/maya-multiverse_rendering.png)
+
+
 ## Working with Yeti in OpenPype
 
 OpenPype can work with [Yeti](https://peregrinelabs.com/yeti/) in two data modes.

From df1a42c5306b855b893a88a10db2f2713c497620 Mon Sep 17 00:00:00 2001
From: Paolo Berto Durante <pberto@gmail.com>
Date: Sun, 10 Apr 2022 20:18:25 +0900
Subject: [PATCH 0094/1227] website: added jcube as a contributor to homepage

---
 website/src/pages/index.js           |  10 +++++++---
 website/static/img/jcube_logo_bw.png | Bin 0 -> 11762 bytes
 2 files changed, 7 insertions(+), 3 deletions(-)
 create mode 100644 website/static/img/jcube_logo_bw.png

diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index 791b309bbc..1f4a645f61 100644
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -68,6 +68,10 @@ const collab = [
     title: 'Ellipse Studio',
     image: '/img/ellipse-studio.png',
     infoLink: 'http://www.dargaudmedia.com'
+  }, {
+    title: 'J Cube Inc',
+    image: '/img/jcube_logo_bw.png',
+    infoLink: 'https://j-cube.jp'
   }
 ];
 
@@ -224,7 +228,7 @@ function Home() {
               Get Support
             </Link>
           </div>
-          
+
           <p>
           OpenPYPE is developed, maintained and supported by <b><a href="https://pype.club">PYPE.club</a></b> </p>
 
@@ -285,7 +289,7 @@ function Home() {
             </div>
           </div>
         </section>
-        
+
         <section className={classnames(styles.gallery, "center darkBackground")}>
           <div className="container">
               <h2>Integrations</h2>
@@ -334,7 +338,7 @@ function Home() {
                   <img src="/img/app_aftereffects.png" alt="" title=""></img>
                   <span className="caption">After Effects</span>
                 </a>
-                
+
                 <a className="link" href="https://www.unrealengine.com">
                   <img src="/img/app_unreal.png" alt="" title=""></img>
                   <span className="caption">Unreal Engine (Beta)</span>
diff --git a/website/static/img/jcube_logo_bw.png b/website/static/img/jcube_logo_bw.png
new file mode 100644
index 0000000000000000000000000000000000000000..76b897a865f52e1c38b68509d3f08c64481f0145
GIT binary patch
literal 11762
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

literal 0
HcmV?d00001


From 0c85093937829c0c626456a00a30d0a23c8cbcfd Mon Sep 17 00:00:00 2001
From: Vic Bartel <vbartel@yanport.com>
Date: Mon, 11 Apr 2022 10:35:39 +0200
Subject: [PATCH 0095/1227] Add memoize implementation for settings purposes

---
 openpype/modules/shotgrid/lib/settings.py |  6 +++---
 openpype/modules/shotgrid/lib/tools.py    | 16 ++++++++++++++++
 2 files changed, 19 insertions(+), 3 deletions(-)
 create mode 100644 openpype/modules/shotgrid/lib/tools.py

diff --git a/openpype/modules/shotgrid/lib/settings.py b/openpype/modules/shotgrid/lib/settings.py
index 4c21501b99..4a772de5b7 100644
--- a/openpype/modules/shotgrid/lib/settings.py
+++ b/openpype/modules/shotgrid/lib/settings.py
@@ -1,9 +1,9 @@
 import os
-# from functools import lru_cache
 
 from pymongo import MongoClient
 from openpype.api import get_system_settings, get_project_settings
 from openpype.modules.shotgrid.lib.const import MODULE_NAME
+from openpype.modules.shotgrid.lib.tools import memoize
 
 
 def get_project_list():
@@ -13,12 +13,12 @@ def get_project_list():
     return db.list_collection_names()
 
 
-# @lru_cache(maxsize=64)
+@memoize
 def get_shotgrid_project_settings(project):
     return get_project_settings(project).get(MODULE_NAME, {})
 
 
-# @lru_cache(maxsize=64)
+@memoize
 def get_shotgrid_settings():
     return get_system_settings().get("modules", {}).get(MODULE_NAME, {})
 
diff --git a/openpype/modules/shotgrid/lib/tools.py b/openpype/modules/shotgrid/lib/tools.py
new file mode 100644
index 0000000000..6305e9ca50
--- /dev/null
+++ b/openpype/modules/shotgrid/lib/tools.py
@@ -0,0 +1,16 @@
+from functools import wraps
+
+
+def memoize(function):
+    memo = {}
+
+    @wraps(function)
+    def wrapper(*args):
+        try:
+            return memo[args]
+        except KeyError:
+            rv = function(*args)
+            memo[args] = rv
+            return rv
+
+    return wrapper

From 16dc4337ad467629b7ea9d984d616e33f2dd5c39 Mon Sep 17 00:00:00 2001
From: Vic Bartel <vbartel@yanport.com>
Date: Mon, 11 Apr 2022 10:39:10 +0200
Subject: [PATCH 0096/1227] Fix after hound notes

---
 openpype/modules/shotgrid/aop/patch.py       |  4 ++--
 openpype/modules/shotgrid/shotgrid_module.py | 15 +++------------
 2 files changed, 5 insertions(+), 14 deletions(-)

diff --git a/openpype/modules/shotgrid/aop/patch.py b/openpype/modules/shotgrid/aop/patch.py
index 580aa2341f..56477f3bf9 100644
--- a/openpype/modules/shotgrid/aop/patch.py
+++ b/openpype/modules/shotgrid/aop/patch.py
@@ -48,5 +48,5 @@ def patch_avalon_db():
         _LOG.debug("Patch Avalon.projects method")
         AvalonMongoDB._prev_projects = copy(AvalonMongoDB.projects)
         AvalonMongoDB.projects = _patched_projects
-    except e:
-        _LOG.error("Unable to patch avalon db "+ e)
+    except Exception as e:
+        _LOG.error("Unable to patch avalon db {}".format(e))
diff --git a/openpype/modules/shotgrid/shotgrid_module.py b/openpype/modules/shotgrid/shotgrid_module.py
index 009f0028f0..06a07cc4f7 100644
--- a/openpype/modules/shotgrid/shotgrid_module.py
+++ b/openpype/modules/shotgrid/shotgrid_module.py
@@ -12,9 +12,7 @@ from openpype.modules import OpenPypeModule
 SHOTGRID_MODULE_DIR = os.path.dirname(os.path.abspath(__file__))
 
 
-class ShotgridModule(
-    OpenPypeModule, ITrayModule, IPluginPaths, ILaunchHookPaths
-):
+class ShotgridModule(OpenPypeModule, ITrayModule, IPluginPaths, ILaunchHookPaths):
     leecher_manager_url = None
     name = "shotgrid"
     enabled = False
@@ -24,9 +22,7 @@ class ShotgridModule(
     def initialize(self, modules_settings):
         shotgrid_settings = modules_settings.get(self.name, dict())
         self.enabled = shotgrid_settings.get("enabled", False)
-        self.leecher_manager_url = shotgrid_settings.get(
-            "leecher_manager_url", ""
-        )
+        self.leecher_manager_url = shotgrid_settings.get("leecher_manager_url", "")
 
     def connect_with_modules(self, enabled_modules):
         pass
@@ -35,11 +31,7 @@ class ShotgridModule(
         return {"PROJECT_ID": self.project_id}
 
     def get_plugin_paths(self):
-        return {
-            "publish": [
-                os.path.join(SHOTGRID_MODULE_DIR, "plugins", "publish")
-            ]
-        }
+        return {"publish": [os.path.join(SHOTGRID_MODULE_DIR, "plugins", "publish")]}
 
     def get_launch_hook_paths(self):
         return os.path.join(SHOTGRID_MODULE_DIR, "hooks")
@@ -53,7 +45,6 @@ class ShotgridModule(
 
         self.tray_wrapper = ShotgridTrayWrapper(self)
 
-
     def tray_start(self):
         return self.tray_wrapper.validate()
 

From 57386db03c9980c107488def4ad7a8155ede52a2 Mon Sep 17 00:00:00 2001
From: Vic Bartel <vbartel@yanport.com>
Date: Mon, 11 Apr 2022 10:45:02 +0200
Subject: [PATCH 0097/1227] Fix after hound notes, part 2

---
 openpype/modules/shotgrid/shotgrid_module.py | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/shotgrid/shotgrid_module.py b/openpype/modules/shotgrid/shotgrid_module.py
index 06a07cc4f7..6e0cbe987b 100644
--- a/openpype/modules/shotgrid/shotgrid_module.py
+++ b/openpype/modules/shotgrid/shotgrid_module.py
@@ -12,7 +12,9 @@ from openpype.modules import OpenPypeModule
 SHOTGRID_MODULE_DIR = os.path.dirname(os.path.abspath(__file__))
 
 
-class ShotgridModule(OpenPypeModule, ITrayModule, IPluginPaths, ILaunchHookPaths):
+class ShotgridModule(
+    OpenPypeModule, ITrayModule, IPluginPaths, ILaunchHookPaths
+):
     leecher_manager_url = None
     name = "shotgrid"
     enabled = False
@@ -22,7 +24,9 @@ class ShotgridModule(OpenPypeModule, ITrayModule, IPluginPaths, ILaunchHookPaths
     def initialize(self, modules_settings):
         shotgrid_settings = modules_settings.get(self.name, dict())
         self.enabled = shotgrid_settings.get("enabled", False)
-        self.leecher_manager_url = shotgrid_settings.get("leecher_manager_url", "")
+        self.leecher_manager_url = shotgrid_settings.get(
+            "leecher_manager_url", ""
+        )
 
     def connect_with_modules(self, enabled_modules):
         pass
@@ -31,7 +35,11 @@ class ShotgridModule(OpenPypeModule, ITrayModule, IPluginPaths, ILaunchHookPaths
         return {"PROJECT_ID": self.project_id}
 
     def get_plugin_paths(self):
-        return {"publish": [os.path.join(SHOTGRID_MODULE_DIR, "plugins", "publish")]}
+        return {
+            "publish": [
+                os.path.join(SHOTGRID_MODULE_DIR, "plugins", "publish")
+            ]
+        }
 
     def get_launch_hook_paths(self):
         return os.path.join(SHOTGRID_MODULE_DIR, "hooks")

From 2e2deb349d082096d056f878a5cf629c2f95e12c Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 14 Apr 2022 13:06:14 +0200
Subject: [PATCH 0098/1227] Match changes that were made to original
 IntegrateAsset

Changes of:
- https://github.com/pypeclub/OpenPype/commit/312d0309ab92de834629c58587f1a758d1d1e90c
- https://github.com/pypeclub/OpenPype/commit/507f3615ab8f42f5664afcac01d339e0517afdf5
- https://github.com/pypeclub/OpenPype/commit/29dca65202d45a79e66c619b95d3408e227a9c05
---
 openpype/plugins/publish/integrate_new.py | 61 ++++++++++++++++++-----
 1 file changed, 49 insertions(+), 12 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 9e8dfefc9e..768c413bf9 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -4,6 +4,7 @@ import sys
 import copy
 import clique
 import six
+from collections import deque, defaultdict
 
 from bson.objectid import ObjectId
 from pymongo import DeleteMany, ReplaceOne, InsertOne, UpdateOne
@@ -871,18 +872,18 @@ class SiteSync(object):
             attached_sites[remote_site] = create_metadata(remote_site,
                                                           created=False)
 
+        # add alternative sites
+        cls._add_alternative_sites(system_sync_server_presets, attached_sites)
+
         # add skeleton for sites where it should be always synced to
         always_accessible_sites = (
             sync_project_presets["config"].get("always_accessible_on", [])
         )
-        for site in always_accessible_sites:
+        for site in set(always_accessible_sites):
             site = site.strip()
             if site not in attached_sites:
                 attached_sites[site] = create_metadata(site, created=False)
 
-        # add alternative sites
-        cls._add_alternative_sites(system_sync_server_presets, attached_sites)
-
         return list(attached_sites.values())
 
     @staticmethod
@@ -904,8 +905,9 @@ class SiteSync(object):
 
         return local_site, remote_site
 
-    @staticmethod
-    def _add_alternative_sites(system_sync_server_presets,
+    @classmethod
+    def _add_alternative_sites(cls,
+                               system_sync_server_presets,
                                attached_sites):
         """Loop through all configured sites and add alternatives.
 
@@ -916,18 +918,14 @@ class SiteSync(object):
             See SyncServerModule.handle_alternate_site
         """
         conf_sites = system_sync_server_presets.get("sites", {})
+        alt_site_pairs = cls._get_alt_site_pairs(conf_sites)
 
-        for site_name, site_info in conf_sites.items():
+        for site_name, alt_sites in alt_site_pairs.items():
 
             # Skip if already defined
             if site_name in attached_sites:
                 continue
 
-            # Get alternate sites (stripped names) for this site name
-            alt_sites = site_info.get("alternative_sites", [])
-            alt_sites = [site.strip() for site in alt_sites]
-            alt_sites = set(alt_sites)
-
             # If no alternative sites we don't need to add
             if not alt_sites:
                 continue
@@ -944,3 +942,42 @@ class SiteSync(object):
 
             # Note: We change mutable `attached_site` dict in-place
             attached_sites[site_name] = alt_site_meta
+
+        @staticmethod
+        def _get_alt_site_pairs(conf_sites):
+            """Returns dict of site and its alternative sites.
+            If `site` has alternative site, it means that alt_site has
+            'site' as
+            alternative site
+            Args:
+                conf_sites (dict)
+            Returns:
+                (dict): {'site': [alternative sites]...}
+            """
+            alt_site_pairs = defaultdict(list)
+            for site_name, site_info in conf_sites.items():
+                alt_sites = set(site_info.get("alternative_sites", []))
+                alt_site_pairs[site_name].extend(alt_sites)
+
+                for alt_site in alt_sites:
+                    alt_site_pairs[alt_site].append(site_name)
+
+            for site_name, alt_sites in alt_site_pairs.items():
+                sites_queue = deque(alt_sites)
+                while sites_queue:
+                    alt_site = sites_queue.popleft()
+
+                    # safety against wrong config
+                    # {"SFTP": {"alternative_site": "SFTP"}
+                    if alt_site == site_name or alt_site not in alt_site_pairs:
+                        continue
+
+                    for alt_alt_site in alt_site_pairs[alt_site]:
+                        if (
+                                alt_alt_site != site_name
+                                and alt_alt_site not in alt_sites
+                        ):
+                            alt_sites.append(alt_alt_site)
+                            sites_queue.append(alt_alt_site)
+
+            return alt_site_pairs

From 0fdd4f1aecd3b5fa09496d4aa48ee605a003e61d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 14 Apr 2022 13:07:33 +0200
Subject: [PATCH 0099/1227] Fix indentation

---
 openpype/plugins/publish/integrate_new.py | 66 +++++++++++------------
 1 file changed, 33 insertions(+), 33 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 768c413bf9..4eccce4e81 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -943,41 +943,41 @@ class SiteSync(object):
             # Note: We change mutable `attached_site` dict in-place
             attached_sites[site_name] = alt_site_meta
 
-        @staticmethod
-        def _get_alt_site_pairs(conf_sites):
-            """Returns dict of site and its alternative sites.
-            If `site` has alternative site, it means that alt_site has
-            'site' as
-            alternative site
-            Args:
-                conf_sites (dict)
-            Returns:
-                (dict): {'site': [alternative sites]...}
-            """
-            alt_site_pairs = defaultdict(list)
-            for site_name, site_info in conf_sites.items():
-                alt_sites = set(site_info.get("alternative_sites", []))
-                alt_site_pairs[site_name].extend(alt_sites)
+    @staticmethod
+    def _get_alt_site_pairs(conf_sites):
+        """Returns dict of site and its alternative sites.
+        If `site` has alternative site, it means that alt_site has
+        'site' as
+        alternative site
+        Args:
+            conf_sites (dict)
+        Returns:
+            (dict): {'site': [alternative sites]...}
+        """
+        alt_site_pairs = defaultdict(list)
+        for site_name, site_info in conf_sites.items():
+            alt_sites = set(site_info.get("alternative_sites", []))
+            alt_site_pairs[site_name].extend(alt_sites)
 
-                for alt_site in alt_sites:
-                    alt_site_pairs[alt_site].append(site_name)
+            for alt_site in alt_sites:
+                alt_site_pairs[alt_site].append(site_name)
 
-            for site_name, alt_sites in alt_site_pairs.items():
-                sites_queue = deque(alt_sites)
-                while sites_queue:
-                    alt_site = sites_queue.popleft()
+        for site_name, alt_sites in alt_site_pairs.items():
+            sites_queue = deque(alt_sites)
+            while sites_queue:
+                alt_site = sites_queue.popleft()
 
-                    # safety against wrong config
-                    # {"SFTP": {"alternative_site": "SFTP"}
-                    if alt_site == site_name or alt_site not in alt_site_pairs:
-                        continue
+                # safety against wrong config
+                # {"SFTP": {"alternative_site": "SFTP"}
+                if alt_site == site_name or alt_site not in alt_site_pairs:
+                    continue
 
-                    for alt_alt_site in alt_site_pairs[alt_site]:
-                        if (
-                                alt_alt_site != site_name
-                                and alt_alt_site not in alt_sites
-                        ):
-                            alt_sites.append(alt_alt_site)
-                            sites_queue.append(alt_alt_site)
+                for alt_alt_site in alt_site_pairs[alt_site]:
+                    if (
+                            alt_alt_site != site_name
+                            and alt_alt_site not in alt_sites
+                    ):
+                        alt_sites.append(alt_alt_site)
+                        sites_queue.append(alt_alt_site)
 
-            return alt_site_pairs
+        return alt_site_pairs

From 1a03bbe48a37cc62918152985488a0bd99d43473 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 14 Apr 2022 13:11:57 +0200
Subject: [PATCH 0100/1227] Store alt sites in a `set`

---
 openpype/plugins/publish/integrate_new.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 4eccce4e81..2795b59482 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -954,13 +954,13 @@ class SiteSync(object):
         Returns:
             (dict): {'site': [alternative sites]...}
         """
-        alt_site_pairs = defaultdict(list)
+        alt_site_pairs = defaultdict(set)
         for site_name, site_info in conf_sites.items():
             alt_sites = set(site_info.get("alternative_sites", []))
-            alt_site_pairs[site_name].extend(alt_sites)
+            alt_site_pairs[site_name].update(alt_sites)
 
             for alt_site in alt_sites:
-                alt_site_pairs[alt_site].append(site_name)
+                alt_site_pairs[alt_site].add(site_name)
 
         for site_name, alt_sites in alt_site_pairs.items():
             sites_queue = deque(alt_sites)
@@ -977,7 +977,7 @@ class SiteSync(object):
                             alt_alt_site != site_name
                             and alt_alt_site not in alt_sites
                     ):
-                        alt_sites.append(alt_alt_site)
+                        alt_sites.add(alt_alt_site)
                         sites_queue.append(alt_alt_site)
 
         return alt_site_pairs

From 5dadfb29386ff242ad335dccc14b2ef5df49297e Mon Sep 17 00:00:00 2001
From: Jiri Sindelar <45896205+jrsndl@users.noreply.github.com>
Date: Thu, 14 Apr 2022 19:00:58 +0200
Subject: [PATCH 0101/1227] fix merge conflict

---
 .../plugins/publish/extract_review_slate.py   | 2393 +++--------------
 1 file changed, 400 insertions(+), 1993 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 3ecea1f8bd..c8ee2ec7ed 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -1,1755 +1,387 @@
 import os
-import re
-import copy
-import json
 import shutil
-
-from abc import ABCMeta, abstractmethod
-import six
-
-import clique
-
-import pyblish.api
 import openpype.api
+import pyblish
 from openpype.lib import (
-    get_ffmpeg_tool_path,
-    get_ffprobe_streams,
-
     path_to_subprocess_arg,
-
-    should_convert_for_ffmpeg,
-    convert_for_ffmpeg,
-    get_transcode_temp_directory
+    get_ffmpeg_tool_path,
+    get_ffprobe_data,
+    get_ffprobe_streams,
+    get_ffmpeg_codec_args,
+    get_ffmpeg_format_args,
 )
-import speedcopy
 
-
-class ExtractReview(pyblish.api.InstancePlugin):
-    """Extracting Review mov file for Ftrack
-
-    Compulsory attribute of representation is tags list with "review",
-    otherwise the representation is ignored.
-
-    All new representations are created and encoded by ffmpeg following
-    presets found in OpenPype Settings interface at
-    `project_settings/global/publish/ExtractReview/profiles:outputs`.
+class ExtractReviewSlate(openpype.api.Extractor):
+    """
+    Will add slate frame at the start of the video files
     """
 
-    label = "Extract Review"
-    order = pyblish.api.ExtractorOrder + 0.02
-    families = ["review"]
-    hosts = [
-        "nuke",
-        "maya",
-        "shell",
-        "hiero",
-        "premiere",
-        "harmony",
-        "standalonepublisher",
-        "fusion",
-        "tvpaint",
-        "resolve",
-        "webpublisher",
-        "aftereffects",
-        "flame"
-    ]
+    label = "Review with Slate frame"
+    order = pyblish.api.ExtractorOrder + 0.031
+    families = ["slate", "review"]
+    match = pyblish.api.Subset
 
-    # Supported extensions
-    image_exts = ["exr", "jpg", "jpeg", "png", "dpx"]
-    video_exts = ["mov", "mp4"]
-    supported_exts = image_exts + video_exts
-
-    alpha_exts = ["exr", "png", "dpx"]
-
-    # FFmpeg tools paths
-    ffmpeg_path = get_ffmpeg_tool_path("ffmpeg")
-
-    # Preset attributes
-    profiles = None
+    hosts = ["nuke", "shell"]
+    optional = True
 
     def process(self, instance):
-        self.log.debug(str(instance.data["representations"]))
-        # Skip review when requested.
-        if not instance.data.get("review", True):
-            return
+        inst_data = instance.data
+        if "representations" not in inst_data:
+            raise RuntimeError("Burnin needs already created mov to work on.")
 
-        # Run processing
-        self.main_process(instance)
-
-        # Make sure cleanup happens and pop representations with "delete" tag.
-        for repre in tuple(instance.data["representations"]):
-            tags = repre.get("tags") or []
-            if "delete" in tags and "thumbnail" not in tags:
-                instance.data["representations"].remove(repre)
-
-    def _get_outputs_for_instance(self, instance):
-        host_name = instance.context.data["hostName"]
-        task_name = os.environ["AVALON_TASK"]
-        family = self.main_family_from_instance(instance)
-
-        self.log.info("Host: \"{}\"".format(host_name))
-        self.log.info("Task: \"{}\"".format(task_name))
-        self.log.info("Family: \"{}\"".format(family))
-
-        profile = self.find_matching_profile(
-            host_name, task_name, family
-        )
-        if not profile:
-            self.log.info((
-                "Skipped instance. None of profiles in presets are for"
-                " Host: \"{}\" | Family: \"{}\" | Task \"{}\""
-            ).format(host_name, family, task_name))
-            return
-
-        self.log.debug("Matching profile: \"{}\"".format(json.dumps(profile)))
-
-        subset_name = instance.data.get("subset")
-        instance_families = self.families_from_instance(instance)
-        filtered_outputs = self.filter_output_defs(
-            profile, subset_name, instance_families
-        )
-        # Store `filename_suffix` to save arguments
-        profile_outputs = []
-        for filename_suffix, definition in filtered_outputs.items():
-            definition["filename_suffix"] = filename_suffix
-            profile_outputs.append(definition)
-
-        if not filtered_outputs:
-            self.log.info((
-                "Skipped instance. All output definitions from selected"
-                " profile does not match to instance families. \"{}\""
-            ).format(str(instance_families)))
-        return profile_outputs
-
-    def _get_outputs_per_representations(self, instance, profile_outputs):
-        outputs_per_representations = []
-        for repre in instance.data["representations"]:
-            repre_name = str(repre.get("name"))
-            tags = repre.get("tags") or []
-            if "review" not in tags:
-                self.log.debug((
-                    "Repre: {} - Didn't found \"review\" in tags. Skipping"
-                ).format(repre_name))
-                continue
-
-            if "thumbnail" in tags:
-                self.log.debug((
-                    "Repre: {} - Found \"thumbnail\" in tags. Skipping"
-                ).format(repre_name))
-                continue
-
-            if "passing" in tags:
-                self.log.debug((
-                    "Repre: {} - Found \"passing\" in tags. Skipping"
-                ).format(repre_name))
-                continue
-
-            input_ext = repre["ext"]
-            if input_ext.startswith("."):
-                input_ext = input_ext[1:]
-
-            if input_ext not in self.supported_exts:
-                self.log.info(
-                    "Representation has unsupported extension \"{}\"".format(
-                        input_ext
-                    )
-                )
-                continue
-
-            # Filter output definition by representation tags (optional)
-            outputs = self.filter_outputs_by_tags(profile_outputs, tags)
-            if not outputs:
-                self.log.info((
-                    "Skipped representation. All output definitions from"
-                    " selected profile does not match to representation's"
-                    " tags. \"{}\""
-                ).format(str(tags)))
-                continue
-            outputs_per_representations.append((repre, outputs))
-        return outputs_per_representations
-
-    @staticmethod
-    def get_instance_label(instance):
-        return (
-            getattr(instance, "label", None)
-            or instance.data.get("label")
-            or instance.data.get("name")
-            or str(instance)
-        )
-
-    def main_process(self, instance):
-        instance_label = self.get_instance_label(instance)
-        self.log.debug("Processing instance \"{}\"".format(instance_label))
-        profile_outputs = self._get_outputs_for_instance(instance)
-        if not profile_outputs:
-            return
-
-        # Loop through representations
-        outputs_per_repres = self._get_outputs_per_representations(
-            instance, profile_outputs
-        )
-        fill_data = copy.deepcopy(instance.data["anatomyData"])
-        for repre, outputs in outputs_per_repres:
-            # Check if input should be preconverted before processing
-            # Store original staging dir (it's value may change)
-            src_repre_staging_dir = repre["stagingDir"]
-            # Receive filepath to first file in representation
-            first_input_path = None
-            if not self.input_is_sequence(repre):
-                first_input_path = os.path.join(
-                    src_repre_staging_dir, repre["files"]
-                )
-            else:
-                for filename in repre["files"]:
-                    first_input_path = os.path.join(
-                        src_repre_staging_dir, filename
-                    )
-                    break
-
-            # Skip if file is not set
-            if first_input_path is None:
-                self.log.warning((
-                    "Representation \"{}\" have empty files. Skipped."
-                ).format(repre["name"]))
-                continue
-
-            # Determine if representation requires pre conversion for ffmpeg
-            do_convert = should_convert_for_ffmpeg(first_input_path)
-            # If result is None the requirement of conversion can't be
-            #   determined
-            if do_convert is None:
-                self.log.info((
-                    "Can't determine if representation requires conversion."
-                    " Skipped."
-                ))
-                continue
-
-            # Do conversion if needed
-            #   - change staging dir of source representation
-            #   - must be set back after output definitions processing
-            if do_convert:
-                new_staging_dir = get_transcode_temp_directory()
-                repre["stagingDir"] = new_staging_dir
-
-                frame_start = instance.data["frameStart"]
-                frame_end = instance.data["frameEnd"]
-                convert_for_ffmpeg(
-                    first_input_path,
-                    new_staging_dir,
-                    frame_start,
-                    frame_end,
-                    self.log
-                )
-
-            for _output_def in outputs:
-                output_def = copy.deepcopy(_output_def)
-                # Make sure output definition has "tags" key
-                if "tags" not in output_def:
-                    output_def["tags"] = []
-
-                if "burnins" not in output_def:
-                    output_def["burnins"] = []
-
-                # Create copy of representation
-                new_repre = copy.deepcopy(repre)
-                # Make sure new representation has origin staging dir
-                #   - this is because source representation may change
-                #       it's staging dir because of ffmpeg conversion
-                new_repre["stagingDir"] = src_repre_staging_dir
-
-                # Remove "delete" tag from new repre if there is
-                if "delete" in new_repre["tags"]:
-                    new_repre["tags"].remove("delete")
-
-                # Add additional tags from output definition to representation
-                for tag in output_def["tags"]:
-                    if tag not in new_repre["tags"]:
-                        new_repre["tags"].append(tag)
-
-                # Add burnin link from output definition to representation
-                for burnin in output_def["burnins"]:
-                    if burnin not in new_repre.get("burnins", []):
-                        if not new_repre.get("burnins"):
-                            new_repre["burnins"] = []
-                        new_repre["burnins"].append(str(burnin))
-
-                self.log.debug(
-                    "Linked burnins: `{}`".format(new_repre.get("burnins"))
-                )
-
-                self.log.debug(
-                    "New representation tags: `{}`".format(
-                        new_repre.get("tags"))
-                )
-
-                temp_data = self.prepare_temp_data(
-                    instance, repre, output_def)
-                files_to_clean = []
-                if temp_data["input_is_sequence"]:
-                    self.log.info("Filling gaps in sequence.")
-                    files_to_clean = self.fill_sequence_gaps(
-                        temp_data["origin_repre"]["files"],
-                        new_repre["stagingDir"],
-                        temp_data["frame_start"],
-                        temp_data["frame_end"])
-
-                # create or update outputName
-                output_name = new_repre.get("outputName", "")
-                output_ext = new_repre["ext"]
-                if output_name:
-                    output_name += "_"
-                output_name += output_def["filename_suffix"]
-                if temp_data["without_handles"]:
-                    output_name += "_noHandles"
-
-                # add outputName to anatomy format fill_data
-                fill_data.update({
-                    "output": output_name,
-                    "ext": output_ext
-                })
-
-                try:  # temporary until oiiotool is supported cross platform
-                    ffmpeg_args = self._ffmpeg_arguments(
-                        output_def, instance, new_repre, temp_data, fill_data
-                    )
-                except ZeroDivisionError:
-                    if 'exr' in temp_data["origin_repre"]["ext"]:
-                        self.log.debug("Unsupported compression on input " +
-                                       "files. Skipping!!!")
-                        return
-                    raise NotImplementedError
-
-                subprcs_cmd = " ".join(ffmpeg_args)
-
-                # run subprocess
-                self.log.debug("Executing: {}".format(subprcs_cmd))
-
-                openpype.api.run_subprocess(
-                    subprcs_cmd, shell=True, logger=self.log
-                )
-
-                # delete files added to fill gaps
-                if files_to_clean:
-                    for f in files_to_clean:
-                        os.unlink(f)
-
-                new_repre.update({
-                    "name": "{}_{}".format(output_name, output_ext),
-                    "outputName": output_name,
-                    "outputDef": output_def,
-                    "frameStartFtrack": temp_data["output_frame_start"],
-                    "frameEndFtrack": temp_data["output_frame_end"],
-                    "ffmpeg_cmd": subprcs_cmd
-                })
-
-                # Force to pop these key if are in new repre
-                new_repre.pop("preview", None)
-                new_repre.pop("thumbnail", None)
-                if "clean_name" in new_repre.get("tags", []):
-                    new_repre.pop("outputName")
-
-                # adding representation
-                self.log.debug(
-                    "Adding new representation: {}".format(new_repre)
-                )
-                instance.data["representations"].append(new_repre)
-
-            # Cleanup temp staging dir after procesisng of output definitions
-            if do_convert:
-                temp_dir = repre["stagingDir"]
-                shutil.rmtree(temp_dir)
-                # Set staging dir of source representation back to previous
-                #   value
-                repre["stagingDir"] = src_repre_staging_dir
-
-    def input_is_sequence(self, repre):
-        """Deduce from representation data if input is sequence."""
-        # TODO GLOBAL ISSUE - Find better way how to find out if input
-        # is sequence. Issues( in theory):
-        # - there may be multiple files ant not be sequence
-        # - remainders are not checked at all
-        # - there can be more than one collection
-        return isinstance(repre["files"], (list, tuple))
-
-    def prepare_temp_data(self, instance, repre, output_def):
-        """Prepare dictionary with values used across extractor's process.
-
-        All data are collected from instance, context, origin representation
-        and output definition.
-
-        There are few required keys in Instance data: "frameStart", "frameEnd"
-        and "fps".
-
-        Args:
-            instance (Instance): Currently processed instance.
-            repre (dict): Representation from which new representation was
-                copied.
-            output_def (dict): Definition of output of this plugin.
-
-        Returns:
-            dict: All data which are used across methods during process.
-                Their values should not change during process but new keys
-                with values may be added.
-        """
-
-        frame_start = instance.data["frameStart"]
-        frame_end = instance.data["frameEnd"]
-
-        # Try to get handles from instance
-        handle_start = instance.data.get("handleStart")
-        handle_end = instance.data.get("handleEnd")
-        # If even one of handle values is not set on instance use
-        # handles from context
-        if handle_start is None or handle_end is None:
-            handle_start = instance.context.data["handleStart"]
-            handle_end = instance.context.data["handleEnd"]
-
-        frame_start_handle = frame_start - handle_start
-        frame_end_handle = frame_end + handle_end
-
-        # Change output frames when output should be without handles
-        without_handles = bool("no-handles" in output_def["tags"])
-        if without_handles:
-            output_frame_start = frame_start
-            output_frame_end = frame_end
-        else:
-            output_frame_start = frame_start_handle
-            output_frame_end = frame_end_handle
-
-        handles_are_set = handle_start > 0 or handle_end > 0
-
-        with_audio = True
-        if (
-            # Check if has `no-audio` tag
-            "no-audio" in output_def["tags"]
-            # Check if instance has ny audio in data
-            or not instance.data.get("audio")
-        ):
-            with_audio = False
-
-        input_is_sequence = self.input_is_sequence(repre)
-        input_allow_bg = False
-        if input_is_sequence and repre["files"]:
-            ext = os.path.splitext(repre["files"][0])[1].replace(".", "")
-            if ext in self.alpha_exts:
-                input_allow_bg = True
-
-        return {
-            "fps": float(instance.data["fps"]),
-            "frame_start": frame_start,
-            "frame_end": frame_end,
-            "handle_start": handle_start,
-            "handle_end": handle_end,
-            "frame_start_handle": frame_start_handle,
-            "frame_end_handle": frame_end_handle,
-            "output_frame_start": int(output_frame_start),
-            "output_frame_end": int(output_frame_end),
-            "pixel_aspect": instance.data.get("pixelAspect", 1),
-            "resolution_width": instance.data.get("resolutionWidth"),
-            "resolution_height": instance.data.get("resolutionHeight"),
-            "origin_repre": repre,
-            "input_is_sequence": input_is_sequence,
-            "input_allow_bg": input_allow_bg,
-            "with_audio": with_audio,
-            "without_handles": without_handles,
-            "handles_are_set": handles_are_set
-        }
-
-    def _ffmpeg_arguments(
-        self, output_def, instance, new_repre, temp_data, fill_data
-    ):
-        """Prepares ffmpeg arguments for expected extraction.
-
-        Prepares input and output arguments based on output definition and
-        input files.
-
-        Args:
-            output_def (dict): Currently processed output definition.
-            instance (Instance): Currently processed instance.
-            new_repre (dict): Representation representing output of this
-                process.
-            temp_data (dict): Base data for successful process.
-        """
-
-        # Get FFmpeg arguments from profile presets
-        out_def_ffmpeg_args = output_def.get("ffmpeg_args") or {}
-
-        _ffmpeg_input_args = out_def_ffmpeg_args.get("input") or []
-        _ffmpeg_output_args = out_def_ffmpeg_args.get("output") or []
-        _ffmpeg_video_filters = out_def_ffmpeg_args.get("video_filters") or []
-        _ffmpeg_audio_filters = out_def_ffmpeg_args.get("audio_filters") or []
-
-        # Cleanup empty strings
-        ffmpeg_input_args = [
-            value for value in _ffmpeg_input_args if value.strip()
-        ]
-        ffmpeg_video_filters = [
-            value for value in _ffmpeg_video_filters if value.strip()
-        ]
-        ffmpeg_audio_filters = [
-            value for value in _ffmpeg_audio_filters if value.strip()
-        ]
-
-        ffmpeg_output_args = []
-        for value in _ffmpeg_output_args:
-            value = value.strip()
-            if not value:
-                continue
-            try:
-                value = value.format(**fill_data)
-            except Exception:
-                self.log.warning(
-                    "Failed to format ffmpeg argument: {}".format(value),
-                    exc_info=True
-                )
-                pass
-            ffmpeg_output_args.append(value)
-
-        # Prepare input and output filepaths
-        self.input_output_paths(new_repre, output_def, temp_data)
-
-        # Set output frames len to 1 when ouput is single image
-        if (
-            temp_data["output_ext_is_image"]
-            and not temp_data["output_is_sequence"]
-        ):
-            output_frames_len = 1
-
-        else:
-            output_frames_len = (
-                temp_data["output_frame_end"]
-                - temp_data["output_frame_start"]
-                + 1
-            )
-
-        duration_seconds = float(output_frames_len / temp_data["fps"])
-
-        if temp_data["input_is_sequence"]:
-            # Set start frame of input sequence (just frame in filename)
-            # - definition of input filepath
-            ffmpeg_input_args.append(
-                "-start_number {}".format(temp_data["output_frame_start"])
-            )
-
-            # TODO add fps mapping `{fps: fraction}` ?
-            # - e.g.: {
-            #     "25": "25/1",
-            #     "24": "24/1",
-            #     "23.976": "24000/1001"
-            # }
-            # Add framerate to input when input is sequence
-            ffmpeg_input_args.append(
-                "-framerate {}".format(temp_data["fps"])
-            )
-
-        if temp_data["output_is_sequence"]:
-            # Set start frame of output sequence (just frame in filename)
-            # - this is definition of an output
-            ffmpeg_output_args.append(
-                "-start_number {}".format(temp_data["output_frame_start"])
-            )
-
-        # Change output's duration and start point if should not contain
-        # handles
-        start_sec = 0
-        if temp_data["without_handles"] and temp_data["handles_are_set"]:
-            # Set start time without handles
-            # - check if handle_start is bigger than 0 to avoid zero division
-            if temp_data["handle_start"] > 0:
-                start_sec = float(temp_data["handle_start"]) / temp_data["fps"]
-                ffmpeg_input_args.append("-ss {:0.10f}".format(start_sec))
-
-            # Set output duration inn seconds
-            ffmpeg_output_args.append("-t {:0.10}".format(duration_seconds))
-
-        # Set frame range of output when input or output is sequence
-        elif temp_data["output_is_sequence"]:
-            ffmpeg_output_args.append("-frames:v {}".format(output_frames_len))
-
-        # Add duration of an input sequence if output is video
-        if (
-            temp_data["input_is_sequence"]
-            and not temp_data["output_is_sequence"]
-        ):
-            ffmpeg_input_args.append("-to {:0.10f}".format(
-                duration_seconds + start_sec
-            ))
-
-        # Add video/image input path
-        ffmpeg_input_args.append(
-            "-i {}".format(
-                path_to_subprocess_arg(temp_data["full_input_path"])
-            )
-        )
-
-        # Add audio arguments if there are any. Skipped when output are images.
-        if not temp_data["output_ext_is_image"] and temp_data["with_audio"]:
-            audio_in_args, audio_filters, audio_out_args = self.audio_args(
-                instance, temp_data, duration_seconds
-            )
-            ffmpeg_input_args.extend(audio_in_args)
-            ffmpeg_audio_filters.extend(audio_filters)
-            ffmpeg_output_args.extend(audio_out_args)
-
-        res_filters = self.rescaling_filters(temp_data, output_def, new_repre)
-        ffmpeg_video_filters.extend(res_filters)
-
-        ffmpeg_input_args = self.split_ffmpeg_args(ffmpeg_input_args)
-
-        lut_filters = self.lut_filters(new_repre, instance, ffmpeg_input_args)
-        ffmpeg_video_filters.extend(lut_filters)
-
-        bg_alpha = 0
-        bg_color = output_def.get("bg_color")
-        if bg_color:
-            bg_red, bg_green, bg_blue, bg_alpha = bg_color
-
-        if bg_alpha > 0:
-            if not temp_data["input_allow_bg"]:
-                self.log.info((
-                    "Output definition has defined BG color input was"
-                    " resolved as does not support adding BG."
-                ))
-            else:
-                bg_color_hex = "#{0:0>2X}{1:0>2X}{2:0>2X}".format(
-                    bg_red, bg_green, bg_blue
-                )
-                bg_color_alpha = float(bg_alpha) / 255
-                bg_color_str = "{}@{}".format(bg_color_hex, bg_color_alpha)
-
-                self.log.info("Applying BG color {}".format(bg_color_str))
-                color_args = [
-                    "split=2[bg][fg]",
-                    "[bg]drawbox=c={}:replace=1:t=fill[bg]".format(
-                        bg_color_str
-                    ),
-                    "[bg][fg]overlay=format=auto"
-                ]
-                # Prepend bg color change before all video filters
-                # NOTE at the time of creation it is required as video filters
-                #   from settings may affect color of BG
-                #   e.g. `eq` can remove alpha from input
-                for arg in reversed(color_args):
-                    ffmpeg_video_filters.insert(0, arg)
-
-        # Add argument to override output file
-        ffmpeg_output_args.append("-y")
-
-        # NOTE This must be latest added item to output arguments.
-        ffmpeg_output_args.append(
-            path_to_subprocess_arg(temp_data["full_output_path"])
-        )
-
-        return self.ffmpeg_full_args(
-            ffmpeg_input_args,
-            ffmpeg_video_filters,
-            ffmpeg_audio_filters,
-            ffmpeg_output_args
-        )
-
-    def split_ffmpeg_args(self, in_args):
-        """Makes sure all entered arguments are separated in individual items.
-
-        Split each argument string with " -" to identify if string contains
-        one or more arguments.
-        """
-        splitted_args = []
-        for arg in in_args:
-            sub_args = arg.split(" -")
-            if len(sub_args) == 1:
-                if arg and arg not in splitted_args:
-                    splitted_args.append(arg)
-                continue
-
-            for idx, arg in enumerate(sub_args):
-                if idx != 0:
-                    arg = "-" + arg
-
-                if arg and arg not in splitted_args:
-                    splitted_args.append(arg)
-        return splitted_args
-
-    def ffmpeg_full_args(
-        self, input_args, video_filters, audio_filters, output_args
-    ):
-        """Post processing of collected FFmpeg arguments.
-
-        Just verify that output arguments does not contain video or audio
-        filters which may cause issues because of duplicated argument entry.
-        Filters found in output arguments are moved to list they belong to.
-
-        Args:
-            input_args (list): All collected ffmpeg arguments with inputs.
-            video_filters (list): All collected video filters.
-            audio_filters (list): All collected audio filters.
-            output_args (list): All collected ffmpeg output arguments with
-                output filepath.
-
-        Returns:
-            list: Containing all arguments ready to run in subprocess.
-        """
-        output_args = self.split_ffmpeg_args(output_args)
-
-        video_args_dentifiers = ["-vf", "-filter:v"]
-        audio_args_dentifiers = ["-af", "-filter:a"]
-        for arg in tuple(output_args):
-            for identifier in video_args_dentifiers:
-                if arg.startswith("{} ".format(identifier)):
-                    output_args.remove(arg)
-                    arg = arg.replace(identifier, "").strip()
-                    video_filters.append(arg)
-
-            for identifier in audio_args_dentifiers:
-                if arg.startswith("{} ".format(identifier)):
-                    output_args.remove(arg)
-                    arg = arg.replace(identifier, "").strip()
-                    audio_filters.append(arg)
-
-        all_args = []
-        all_args.append(path_to_subprocess_arg(self.ffmpeg_path))
-        all_args.extend(input_args)
-        if video_filters:
-            all_args.append("-filter:v")
-            all_args.append("\"{}\"".format(",".join(video_filters)))
-
-        if audio_filters:
-            all_args.append("-filter:a")
-            all_args.append("\"{}\"".format(",".join(audio_filters)))
-
-        all_args.extend(output_args)
-
-        return all_args
-
-    def fill_sequence_gaps(self, files, staging_dir, start_frame, end_frame):
-        # type: (list, str, int, int) -> list
-        """Fill missing files in sequence by duplicating existing ones.
-
-        This will take nearest frame file and copy it with so as to fill
-        gaps in sequence. Last existing file there is is used to for the
-        hole ahead.
-
-        Args:
-            files (list): List of representation files.
-            staging_dir (str): Path to staging directory.
-            start_frame (int): Sequence start (no matter what files are there)
-            end_frame (int): Sequence end (no matter what files are there)
-
-        Returns:
-            list of added files. Those should be cleaned after work
-                is done.
-
-        Raises:
-            AssertionError: if more then one collection is obtained.
-
-        """
-        start_frame = int(start_frame)
-        end_frame = int(end_frame)
-        collections = clique.assemble(files)[0]
-        assert len(collections) == 1, "Multiple collections found."
-        col = collections[0]
-
-        # do nothing if no gap is found in input range
-        not_gap = True
-        for fr in range(start_frame, end_frame + 1):
-            if fr not in col.indexes:
-                not_gap = False
-
-        if not_gap:
-            return []
-
-        holes = col.holes()
-
-        # generate ideal sequence
-        complete_col = clique.assemble(
-            [("{}{:0" + str(col.padding) + "d}{}").format(
-                col.head, f, col.tail
-            ) for f in range(start_frame, end_frame)]
-        )[0][0]  # type: clique.Collection
-
-        new_files = {}
-        last_existing_file = None
-
-        for idx in holes.indexes:
-            # get previous existing file
-            test_file = os.path.normpath(os.path.join(
-                staging_dir,
-                ("{}{:0" + str(complete_col.padding) + "d}{}").format(
-                    complete_col.head, idx - 1, complete_col.tail)))
-            if os.path.isfile(test_file):
-                new_files[idx] = test_file
-                last_existing_file = test_file
-            else:
-                if not last_existing_file:
-                    # previous file is not found (sequence has a hole
-                    # at the beginning. Use first available frame
-                    # there is.
-                    try:
-                        last_existing_file = list(col)[0]
-                    except IndexError:
-                        # empty collection?
-                        raise AssertionError(
-                            "Invalid sequence collected")
-                new_files[idx] = os.path.normpath(
-                    os.path.join(staging_dir, last_existing_file))
-
-        files_to_clean = []
-        if new_files:
-            # so now new files are dict with missing frame as a key and
-            # existing file as a value.
-            for frame, file in new_files.items():
-                self.log.info(
-                    "Filling gap {} with {}".format(frame, file))
-
-                hole = os.path.join(
-                    staging_dir,
-                    ("{}{:0" + str(col.padding) + "d}{}").format(
-                        col.head, frame, col.tail))
-                speedcopy.copyfile(file, hole)
-                files_to_clean.append(hole)
-
-        return files_to_clean
-
-    def input_output_paths(self, new_repre, output_def, temp_data):
-        """Deduce input nad output file paths based on entered data.
-
-        Input may be sequence of images, video file or single image file and
-        same can be said about output, this method helps to find out what
-        their paths are.
-
-        It is validated that output directory exist and creates if not.
-
-        During process are set "files", "stagingDir", "ext" and
-        "sequence_file" (if output is sequence) keys to new representation.
-        """
-
-        repre = temp_data["origin_repre"]
-        src_staging_dir = repre["stagingDir"]
-        dst_staging_dir = new_repre["stagingDir"]
-
-        if temp_data["input_is_sequence"]:
-            collections = clique.assemble(repre["files"])[0]
-            full_input_path = os.path.join(
-                src_staging_dir,
-                collections[0].format("{head}{padding}{tail}")
-            )
-
-            filename = collections[0].format("{head}")
-            if filename.endswith("."):
-                filename = filename[:-1]
-
-            # Make sure to have full path to one input file
-            full_input_path_single_file = os.path.join(
-                src_staging_dir, repre["files"][0]
-            )
-
-        else:
-            full_input_path = os.path.join(
-                src_staging_dir, repre["files"]
-            )
-            filename = os.path.splitext(repre["files"])[0]
-
-            # Make sure to have full path to one input file
-            full_input_path_single_file = full_input_path
-
-        filename_suffix = output_def["filename_suffix"]
-
-        output_ext = output_def.get("ext")
-        # Use input extension if output definition do not specify it
-        if output_ext is None:
-            output_ext = os.path.splitext(full_input_path)[1]
-
-        # TODO Define if extension should have dot or not
-        if output_ext.startswith("."):
-            output_ext = output_ext[1:]
-
-        # Store extension to representation
-        new_repre["ext"] = output_ext
-
-        self.log.debug("New representation ext: `{}`".format(output_ext))
-
-        # Output is image file sequence witht frames
-        output_ext_is_image = bool(output_ext in self.image_exts)
-        output_is_sequence = bool(
-            output_ext_is_image
-            and "sequence" in output_def["tags"]
-        )
-        if output_is_sequence:
-            new_repre_files = []
-            frame_start = temp_data["output_frame_start"]
-            frame_end = temp_data["output_frame_end"]
-
-            filename_base = "{}_{}".format(filename, filename_suffix)
-            # Temporary tempalte for frame filling. Example output:
-            # "basename.%04d.exr" when `frame_end` == 1001
-            repr_file = "{}.%{:0>2}d.{}".format(
-                filename_base, len(str(frame_end)), output_ext
-            )
-
-            for frame in range(frame_start, frame_end + 1):
-                new_repre_files.append(repr_file % frame)
-
-            new_repre["sequence_file"] = repr_file
-            full_output_path = os.path.join(
-                dst_staging_dir, filename_base, repr_file
-            )
-
-        else:
-            repr_file = "{}_{}.{}".format(
-                filename, filename_suffix, output_ext
-            )
-            full_output_path = os.path.join(dst_staging_dir, repr_file)
-            new_repre_files = repr_file
-
-        # Store files to representation
-        new_repre["files"] = new_repre_files
-
-        # Make sure stagingDire exists
-        dst_staging_dir = os.path.normpath(os.path.dirname(full_output_path))
-        if not os.path.exists(dst_staging_dir):
-            self.log.debug("Creating dir: {}".format(dst_staging_dir))
-            os.makedirs(dst_staging_dir)
-
-        # Store stagingDir to representaion
-        new_repre["stagingDir"] = dst_staging_dir
-
-        # Store paths to temp data
-        temp_data["full_input_path"] = full_input_path
-        temp_data["full_input_path_single_file"] = full_input_path_single_file
-        temp_data["full_output_path"] = full_output_path
-
-        # Store information about output
-        temp_data["output_ext_is_image"] = output_ext_is_image
-        temp_data["output_is_sequence"] = output_is_sequence
-
-        self.log.debug("Input path {}".format(full_input_path))
-        self.log.debug("Output path {}".format(full_output_path))
-
-    def audio_args(self, instance, temp_data, duration_seconds):
-        """Prepares FFMpeg arguments for audio inputs."""
-        audio_in_args = []
-        audio_filters = []
-        audio_out_args = []
-        audio_inputs = instance.data.get("audio")
-        if not audio_inputs:
-            return audio_in_args, audio_filters, audio_out_args
-
-        for audio in audio_inputs:
-            # NOTE modified, always was expected "frameStartFtrack" which is
-            # STRANGE?!!! There should be different key, right?
-            # TODO use different frame start!
-            offset_seconds = 0
-            frame_start_ftrack = instance.data.get("frameStartFtrack")
-            if frame_start_ftrack is not None:
-                offset_frames = frame_start_ftrack - audio["offset"]
-                offset_seconds = offset_frames / temp_data["fps"]
-
-            if offset_seconds > 0:
-                audio_in_args.append(
-                    "-ss {}".format(offset_seconds)
-                )
-
-            elif offset_seconds < 0:
-                audio_in_args.append(
-                    "-itsoffset {}".format(abs(offset_seconds))
-                )
-
-            # Audio duration is offset from `-ss`
-            audio_duration = duration_seconds + offset_seconds
-
-            # Set audio duration
-            audio_in_args.append("-to {:0.10f}".format(audio_duration))
-
-            # Add audio input path
-            audio_in_args.append("-i {}".format(
-                path_to_subprocess_arg(audio["filename"])
-            ))
-
-        # NOTE: These were changed from input to output arguments.
-        # NOTE: value in "-ac" was hardcoded to 2, changed to audio inputs len.
-        # Need to merge audio if there are more than 1 input.
-        if len(audio_inputs) > 1:
-            audio_out_args.append("-filter_complex amerge")
-            audio_out_args.append("-ac {}".format(len(audio_inputs)))
-
-        return audio_in_args, audio_filters, audio_out_args
-
-    def get_letterbox_filters(
-        self,
-        letter_box_def,
-        output_width,
-        output_height
-    ):
-        output = []
-
-        ratio = letter_box_def["ratio"]
-        fill_color = letter_box_def["fill_color"]
-        f_red, f_green, f_blue, f_alpha = fill_color
-        fill_color_hex = "{0:0>2X}{1:0>2X}{2:0>2X}".format(
-            f_red, f_green, f_blue
-        )
-        fill_color_alpha = float(f_alpha) / 255
-
-        line_thickness = letter_box_def["line_thickness"]
-        line_color = letter_box_def["line_color"]
-        l_red, l_green, l_blue, l_alpha = line_color
-        line_color_hex = "{0:0>2X}{1:0>2X}{2:0>2X}".format(
-            l_red, l_green, l_blue
-        )
-        line_color_alpha = float(l_alpha) / 255
-
-        # test ratios and define if pillar or letter boxes
-        output_ratio = float(output_width) / float(output_height)
-        self.log.debug("Output ratio: {} LetterBox ratio: {}".format(
-            output_ratio, ratio
-        ))
-        pillar = output_ratio > ratio
-        need_mask = format(output_ratio, ".3f") != format(ratio, ".3f")
-        if not need_mask:
-            return []
-
-        if not pillar:
-            if fill_color_alpha > 0:
-                top_box = (
-                    "drawbox=0:0:{width}"
-                    ":round(({height}-({width}/{ratio}))/2)"
-                    ":t=fill:c={color}@{alpha}"
-                ).format(
-                    width=output_width,
-                    height=output_height,
-                    ratio=ratio,
-                    color=fill_color_hex,
-                    alpha=fill_color_alpha
-                )
-
-                bottom_box = (
-                    "drawbox=0"
-                    ":{height}-round(({height}-({width}/{ratio}))/2)"
-                    ":{width}"
-                    ":round(({height}-({width}/{ratio}))/2)"
-                    ":t=fill:c={color}@{alpha}"
-                ).format(
-                    width=output_width,
-                    height=output_height,
-                    ratio=ratio,
-                    color=fill_color_hex,
-                    alpha=fill_color_alpha
-                )
-                output.extend([top_box, bottom_box])
-
-            if line_color_alpha > 0 and line_thickness > 0:
-                top_line = (
-                    "drawbox=0"
-                    ":round(({height}-({width}/{ratio}))/2)-{l_thick}"
-                    ":{width}:{l_thick}:t=fill:c={l_color}@{l_alpha}"
-                ).format(
-                    width=output_width,
-                    height=output_height,
-                    ratio=ratio,
-                    l_thick=line_thickness,
-                    l_color=line_color_hex,
-                    l_alpha=line_color_alpha
-                )
-                bottom_line = (
-                    "drawbox=0"
-                    ":{height}-round(({height}-({width}/{ratio}))/2)"
-                    ":{width}:{l_thick}:t=fill:c={l_color}@{l_alpha}"
-                ).format(
-                    width=output_width,
-                    height=output_height,
-                    ratio=ratio,
-                    l_thick=line_thickness,
-                    l_color=line_color_hex,
-                    l_alpha=line_color_alpha
-                )
-                output.extend([top_line, bottom_line])
-
-        else:
-            if fill_color_alpha > 0:
-                left_box = (
-                    "drawbox=0:0"
-                    ":round(({width}-({height}*{ratio}))/2)"
-                    ":{height}"
-                    ":t=fill:c={color}@{alpha}"
-                ).format(
-                    width=output_width,
-                    height=output_height,
-                    ratio=ratio,
-                    color=fill_color_hex,
-                    alpha=fill_color_alpha
-                )
-
-                right_box = (
-                    "drawbox="
-                    "{width}-round(({width}-({height}*{ratio}))/2)"
-                    ":0"
-                    ":round(({width}-({height}*{ratio}))/2)"
-                    ":{height}"
-                    ":t=fill:c={color}@{alpha}"
-                ).format(
-                    width=output_width,
-                    height=output_height,
-                    ratio=ratio,
-                    color=fill_color_hex,
-                    alpha=fill_color_alpha
-                )
-                output.extend([left_box, right_box])
-
-            if line_color_alpha > 0 and line_thickness > 0:
-                left_line = (
-                    "drawbox=round(({width}-({height}*{ratio}))/2)"
-                    ":0:{l_thick}:{height}:t=fill:c={l_color}@{l_alpha}"
-                ).format(
-                    width=output_width,
-                    height=output_height,
-                    ratio=ratio,
-                    l_thick=line_thickness,
-                    l_color=line_color_hex,
-                    l_alpha=line_color_alpha
-                )
-
-                right_line = (
-                    "drawbox={width}-round(({width}-({height}*{ratio}))/2)"
-                    ":0:{l_thick}:{height}:t=fill:c={l_color}@{l_alpha}"
-                ).format(
-                    width=output_width,
-                    height=output_height,
-                    ratio=ratio,
-                    l_thick=line_thickness,
-                    l_color=line_color_hex,
-                    l_alpha=line_color_alpha
-                )
-                output.extend([left_line, right_line])
-
-        return output
-
-    def rescaling_filters(self, temp_data, output_def, new_repre):
-        """Prepare vieo filters based on tags in new representation.
-
-        It is possible to add letterboxes to output video or rescale to
-        different resolution.
-
-        During this preparation "resolutionWidth" and "resolutionHeight" are
-        set to new representation.
-        """
-        filters = []
-
-        # if reformat input video file is already reforamted from upstream
-        reformat_in_baking = bool("reformated" in new_repre["tags"])
-        self.log.debug("reformat_in_baking: `{}`".format(reformat_in_baking))
-
-        # Get instance data
-        pixel_aspect = temp_data["pixel_aspect"]
-
-        if reformat_in_baking:
-            self.log.debug((
-                "Using resolution from input. It is already "
-                "reformated from upstream process"
-            ))
-            pixel_aspect = 1
-
-        # NOTE Skipped using instance's resolution
-        full_input_path_single_file = temp_data["full_input_path_single_file"]
-        try:
-            streams = get_ffprobe_streams(
-                full_input_path_single_file, self.log
-            )
-        except Exception as exc:
-            raise AssertionError((
-                "FFprobe couldn't read information about input file: \"{}\"."
-                " Error message: {}"
-            ).format(full_input_path_single_file, str(exc)))
+        suffix = "_slate"
+        slate_path = inst_data.get("slateFrame")
+        ffmpeg_path = get_ffmpeg_tool_path("ffmpeg")
 
+        slate_streams = get_ffprobe_streams(slate_path, self.log)
         # Try to find first stream with defined 'width' and 'height'
         # - this is to avoid order of streams where audio can be as first
-        # - there may be a better way (checking `codec_type`?)
-        input_width = None
-        input_height = None
-        output_width = None
-        output_height = None
-        for stream in streams:
-            if "width" in stream and "height" in stream:
-                input_width = int(stream["width"])
-                input_height = int(stream["height"])
+        # - there may be a better way (checking `codec_type`?)+
+        slate_width = None
+        slate_height = None
+        for slate_stream in slate_streams:
+            if "width" in slate_stream and "height" in slate_stream:
+                slate_width = int(slate_stream["width"])
+                slate_height = int(slate_stream["height"])
                 break
 
-        # Get instance data
-        pixel_aspect = temp_data["pixel_aspect"]
-
-        if reformat_in_baking:
-            self.log.debug((
-                "Using resolution from input. It is already "
-                "reformated from upstream process"
-            ))
-            pixel_aspect = 1
-            output_width = input_width
-            output_height = input_height
-
         # Raise exception of any stream didn't define input resolution
-        if input_width is None:
+        if slate_width is None:
             raise AssertionError((
                 "FFprobe couldn't read resolution from input file: \"{}\""
-            ).format(full_input_path_single_file))
+            ).format(slate_path))
 
-        # NOTE Setting only one of `width` or `heigth` is not allowed
-        # - settings value can't have None but has value of 0
-        output_width = output_def.get("width") or output_width or None
-        output_height = output_def.get("height") or output_height or None
+        if "reviewToWidth" in inst_data:
+            use_legacy_code = True
+        else:
+            use_legacy_code = False
 
-        # Overscal color
-        overscan_color_value = "black"
-        overscan_color = output_def.get("overscan_color")
-        if overscan_color:
-            bg_red, bg_green, bg_blue, _ = overscan_color
-            overscan_color_value = "#{0:0>2X}{1:0>2X}{2:0>2X}".format(
-                bg_red, bg_green, bg_blue
+        pixel_aspect = inst_data.get("pixelAspect", 1)
+        fps = inst_data.get("fps")
+        self.log.debug("fps {} ".format(fps))
+
+        for idx, repre in enumerate(inst_data["representations"]):
+            self.log.debug("repre ({}): `{}`".format(idx + 1, repre))
+
+            p_tags = repre.get("tags", [])
+            if "slate-frame" not in p_tags:
+                continue
+
+            # get repre file
+            stagingdir = repre["stagingDir"]
+            input_file = "{0}".format(repre["files"])
+            input_path = os.path.join(
+                os.path.normpath(stagingdir), repre["files"])
+            self.log.debug("__ input_path: {}".format(input_path))
+
+            streams = get_ffprobe_streams(
+                input_path, self.log
             )
-        self.log.debug("Overscan color: `{}`".format(overscan_color_value))
-
-        # Convert overscan value video filters
-        overscan_crop = output_def.get("overscan_crop")
-        overscan = OverscanCrop(
-            input_width, input_height, overscan_crop, overscan_color_value
-        )
-        overscan_crop_filters = overscan.video_filters()
-        # Add overscan filters to filters if are any and modify input
-        #   resolution by it's values
-        if overscan_crop_filters:
-            filters.extend(overscan_crop_filters)
-            input_width = overscan.width()
-            input_height = overscan.height()
-            # Use output resolution as inputs after cropping to skip usage of
-            #   instance data resolution
-            if output_width is None or output_height is None:
-                output_width = input_width
-                output_height = input_height
-
-        # Make sure input width and height is not an odd number
-        input_width_is_odd = bool(input_width % 2 != 0)
-        input_height_is_odd = bool(input_height % 2 != 0)
-        if input_width_is_odd or input_height_is_odd:
-            # Add padding to input and make sure this filter is at first place
-            filters.append("pad=width=ceil(iw/2)*2:height=ceil(ih/2)*2")
-
-            # Change input width or height as first filter will change them
-            if input_width_is_odd:
-                self.log.info((
-                    "Converting input width from odd to even number. {} -> {}"
-                ).format(input_width, input_width + 1))
-                input_width += 1
-
-            if input_height_is_odd:
-                self.log.info((
-                    "Converting input height from odd to even number. {} -> {}"
-                ).format(input_height, input_height + 1))
-                input_height += 1
-
-        self.log.debug("pixel_aspect: `{}`".format(pixel_aspect))
-        self.log.debug("input_width: `{}`".format(input_width))
-        self.log.debug("input_height: `{}`".format(input_height))
-
-        # Use instance resolution if output definition has not set it.
-        if output_width is None or output_height is None:
-            output_width = temp_data["resolution_width"]
-            output_height = temp_data["resolution_height"]
-
-        # Use source's input resolution instance does not have set it.
-        if output_width is None or output_height is None:
-            self.log.debug("Using resolution from input.")
-            output_width = input_width
-            output_height = input_height
-
-        output_width = int(output_width)
-        output_height = int(output_height)
-
-        # Make sure output width and height is not an odd number
-        # When this can happen:
-        # - if output definition has set width and height with odd number
-        # - `instance.data` contain width and height with odd numbeer
-        if output_width % 2 != 0:
-            self.log.warning((
-                "Converting output width from odd to even number. {} -> {}"
-            ).format(output_width, output_width + 1))
-            output_width += 1
-
-        if output_height % 2 != 0:
-            self.log.warning((
-                "Converting output height from odd to even number. {} -> {}"
-            ).format(output_height, output_height + 1))
-            output_height += 1
-
-        self.log.debug(
-            "Output resolution is {}x{}".format(output_width, output_height)
-        )
-
-        letter_box_def = output_def["letter_box"]
-        letter_box_enabled = letter_box_def["enabled"]
-
-        # Skip processing if resolution is same as input's and letterbox is
-        # not set
-        if (
-            output_width == input_width
-            and output_height == input_height
-            and not letter_box_enabled
-            and pixel_aspect == 1
-        ):
+            # get video metadata
+            for stream in streams:
+                input_timecode = None
+                input_width = None
+                input_height = None
+                input_frame_rate = None
+                if "codec_type" in stream:
+                    if stream["codec_type"] == "video":
+                        self.log.debug("__Ffprobe Video: {}".format(stream))
+                        tags = stream.get("tags") or {}
+                        input_timecode = tags.get("timecode") or ""
+                        if "width" in stream and "height" in stream:
+                            input_width = int(stream.get("width"))
+                            input_height = int(stream.get("height"))
+                        if "r_frame_rate" in stream:
+                            # get frame rate in a form of
+                            # x/y, like 24000/1001 for 23.976
+                            input_frame_rate = str(stream.get("r_frame_rate"))
+                        if (
+                            input_timecode
+                            and input_width
+                            and input_height
+                            and input_frame_rate
+                        ):
+                            break
+            # Raise exception of any stream didn't define input resolution
+            if input_width is None:
+                raise AssertionError((
+                    "FFprobe couldn't read resolution from input file: \"{}\""
+                ).format(input_path))
+            # Get audio metadata
+            for stream in streams:
+                audio_channels = None
+                audio_sample_rate = None
+                audio_channel_layout = None
+                input_audio = False
+                if stream["codec_type"] == "audio":
+                    self.log.debug("__Ffprobe Audio: {}".format(stream))
+                    if stream["channels"]:
+                        audio_channels = str(stream.get("channels"))
+                    if stream["sample_rate"]:
+                        audio_sample_rate = str(stream.get("sample_rate"))
+                    if stream["channel_layout"]:
+                        audio_channel_layout = str(
+                            stream.get("channel_layout"))
+                    if (
+                        audio_channels
+                        and audio_sample_rate
+                        and audio_channel_layout
+                    ):
+                        input_audio = True
+                        break
+            # Get duration of one frame in micro seconds
+            one_frame_duration = "40000us"
+            if input_frame_rate:
+                items = input_frame_rate.split("/")
+                if len(items) == 1:
+                    one_frame_duration = float(1.0) / float(items[0])
+                elif len(items) == 2:
+                    one_frame_duration = float(items[1]) / float(items[0])
+                one_frame_duration *= 1000000
+                one_frame_duration = str(int(one_frame_duration)) + "us"
             self.log.debug(
-                "Output resolution is same as input's"
-                " and \"letter_box\" key is not set. Skipping reformat part."
-            )
-            new_repre["resolutionWidth"] = input_width
-            new_repre["resolutionHeight"] = input_height
-            return filters
+                "One frame duration is {}".format(one_frame_duration))
 
-        # defining image ratios
-        input_res_ratio = (
-            (float(input_width) * pixel_aspect) / input_height
-        )
-        output_res_ratio = float(output_width) / float(output_height)
-        self.log.debug("input_res_ratio: `{}`".format(input_res_ratio))
-        self.log.debug("output_res_ratio: `{}`".format(output_res_ratio))
-
-        # Round ratios to 2 decimal places for comparing
-        input_res_ratio = round(input_res_ratio, 2)
-        output_res_ratio = round(output_res_ratio, 2)
-
-        # get scale factor
-        scale_factor_by_width = (
-            float(output_width) / (input_width * pixel_aspect)
-        )
-        scale_factor_by_height = (
-            float(output_height) / input_height
-        )
-
-        self.log.debug(
-            "scale_factor_by_with: `{}`".format(scale_factor_by_width)
-        )
-        self.log.debug(
-            "scale_factor_by_height: `{}`".format(scale_factor_by_height)
-        )
-
-        # scaling none square pixels and 1920 width
-        if (
-            input_height != output_height
-            or input_width != output_width
-            or pixel_aspect != 1
-        ):
-            if input_res_ratio < output_res_ratio:
-                self.log.debug(
-                    "Input's resolution ratio is lower then output's"
-                )
-                width_scale = int(input_width * scale_factor_by_height)
-                width_half_pad = int((output_width - width_scale) / 2)
-                height_scale = output_height
-                height_half_pad = 0
+            # values are set in ExtractReview
+            if use_legacy_code:
+                to_width = inst_data["reviewToWidth"]
+                to_height = inst_data["reviewToHeight"]
             else:
-                self.log.debug("Input is heigher then output")
-                width_scale = output_width
-                width_half_pad = 0
-                height_scale = int(input_height * scale_factor_by_width)
-                height_half_pad = int((output_height - height_scale) / 2)
+                to_width = input_width
+                to_height = input_height
 
-            self.log.debug("width_scale: `{}`".format(width_scale))
-            self.log.debug("width_half_pad: `{}`".format(width_half_pad))
-            self.log.debug("height_scale: `{}`".format(height_scale))
-            self.log.debug("height_half_pad: `{}`".format(height_half_pad))
+            self.log.debug("to_width: `{}`".format(to_width))
+            self.log.debug("to_height: `{}`".format(to_height))
 
-            filters.extend([
-                "scale={}x{}:flags=lanczos".format(
-                    width_scale, height_scale
-                ),
-                "pad={}:{}:{}:{}:{}".format(
-                    output_width, output_height,
-                    width_half_pad, height_half_pad,
-                    overscan_color_value
-                ),
-                "setsar=1"
+            # defining image ratios
+            resolution_ratio = (
+                (float(slate_width) * pixel_aspect) / slate_height
+            )
+            delivery_ratio = float(to_width) / float(to_height)
+            self.log.debug("resolution_ratio: `{}`".format(resolution_ratio))
+            self.log.debug("delivery_ratio: `{}`".format(delivery_ratio))
+
+            # get scale factor
+            scale_factor_by_height = float(to_height) / slate_height
+            scale_factor_by_width = float(to_width) / (
+                slate_width * pixel_aspect
+            )
+
+            # shorten two decimals long float number for testing conditions
+            resolution_ratio_test = float("{:0.2f}".format(resolution_ratio))
+            delivery_ratio_test = float("{:0.2f}".format(delivery_ratio))
+
+            self.log.debug("__ scale_factor_by_width: `{}`".format(
+                scale_factor_by_width
+            ))
+            self.log.debug("__ scale_factor_by_height: `{}`".format(
+                scale_factor_by_height
+            ))
+
+            _remove_at_end = []
+
+            ext = os.path.splitext(input_file)[1]
+            output_file = input_file.replace(ext, "") + suffix + ext
+
+            _remove_at_end.append(input_path)
+
+            output_path = os.path.join(
+                os.path.normpath(stagingdir), output_file)
+            self.log.debug("__ output_path: {}".format(output_path))
+
+            input_args = []
+            output_args = []
+
+            # preset's input data
+            if use_legacy_code:
+                input_args.extend(repre["_profile"].get('input', []))
+            else:
+                input_args.extend(repre["outputDef"].get('input', []))
+
+            input_args.append("-loop 1 -i {}".format(
+                openpype.lib.path_to_subprocess_arg(slate_path)))
+            # if input has an audio, add silent audio to the slate
+            if input_audio:
+                input_args.extend(
+                    ["-f lavfi -i anullsrc=r={}:cl={}:d={}".format(
+                        audio_sample_rate,
+                        audio_channel_layout,
+                        one_frame_duration
+                    )]
+                )
+
+            input_args.extend(["-r {}".format(input_frame_rate)])
+            input_args.extend(["-frames:v 1"])
+            # add timecode from source to the slate, substract one frame
+            if input_timecode:
+                offset_timecode = self._tc_offset(
+                    str(input_timecode),
+                    framerate=fps,
+                    frame_offset=-1
+                )
+                self.log.debug("Slate Timecode: `{}`".format(
+                    offset_timecode
+                ))
+                if offset_timecode:
+                    input_args.extend(["-timecode {}".format(offset_timecode)])
+                else:
+                    # fall back to input timecode if offset fails
+                    input_args.extend(["-timecode {}".format(input_timecode)])
+            if use_legacy_code:
+                codec_args = repre["_profile"].get('codec', [])
+                output_args.extend(codec_args)
+                # preset's output data
+                output_args.extend(repre["_profile"].get('output', []))
+            else:
+                # Codecs are copied from source for whole input
+                codec_args = self._get_codec_args(repre)
+                output_args.extend(codec_args)
+
+            # make sure colors are correct
+            output_args.extend([
+                "-vf scale=out_color_matrix=bt709",
+                "-color_primaries bt709",
+                "-color_trc bt709",
+                "-colorspace bt709"
             ])
 
-        # letter_box
-        if letter_box_enabled:
-            filters.extend(
-                self.get_letterbox_filters(
-                    letter_box_def,
-                    output_width,
-                    output_height
+            # scaling none square pixels and 1920 width
+            if (
+                # Always scale slate if not legacy
+                not use_legacy_code or
+                # Legacy code required reformat tag
+                (use_legacy_code and "reformat" in p_tags)
+            ):
+                if resolution_ratio_test < delivery_ratio_test:
+                    self.log.debug("lower then delivery")
+                    width_scale = int(slate_width * scale_factor_by_height)
+                    width_half_pad = int((to_width - width_scale) / 2)
+                    height_scale = to_height
+                    height_half_pad = 0
+                else:
+                    self.log.debug("heigher then delivery")
+                    width_scale = to_width
+                    width_half_pad = 0
+                    height_scale = int(slate_height * scale_factor_by_width)
+                    height_half_pad = int((to_height - height_scale) / 2)
+
+                self.log.debug(
+                    "__ width_scale: `{}`".format(width_scale)
                 )
+                self.log.debug(
+                    "__ width_half_pad: `{}`".format(width_half_pad)
+                )
+                self.log.debug(
+                    "__ height_scale: `{}`".format(height_scale)
+                )
+                self.log.debug(
+                    "__ height_half_pad: `{}`".format(height_half_pad)
+                )
+
+                scaling_arg = ("scale={0}x{1}:flags=lanczos,"
+                               "pad={2}:{3}:{4}:{5}:black,setsar=1").format(
+                    width_scale, height_scale, to_width, to_height,
+                    width_half_pad, height_half_pad
+                )
+            # add output frame rate as a filter, just in case
+            scaling_arg += ",fps={}".format(input_frame_rate)
+            vf_back = self.add_video_filter_args(output_args, scaling_arg)
+            # add it to output_args
+            output_args.insert(0, vf_back)
+
+            # overrides output file
+            output_args.append("-y")
+
+            slate_v_path = slate_path.replace(".png", ext)
+            output_args.append(
+                path_to_subprocess_arg(slate_v_path)
+            )
+            _remove_at_end.append(slate_v_path)
+
+            slate_args = [
+                path_to_subprocess_arg(ffmpeg_path),
+                " ".join(input_args),
+                " ".join(output_args)
+            ]
+            slate_subprocess_cmd = " ".join(slate_args)
+
+            # run slate generation subprocess
+            self.log.debug(
+                "Slate Executing: {}".format(slate_subprocess_cmd)
+            )
+            openpype.api.run_subprocess(
+                slate_subprocess_cmd, shell=True, logger=self.log
             )
 
-        new_repre["resolutionWidth"] = output_width
-        new_repre["resolutionHeight"] = output_height
+            # create ffmpeg concat text file path
+            conc_text_file = input_file.replace(ext, "") + "_concat" + ".txt"
+            conc_text_path = os.path.join(
+                os.path.normpath(stagingdir), conc_text_file)
+            _remove_at_end.append(conc_text_path)
+            self.log.debug("__ conc_text_path: {}".format(conc_text_path))
 
-        return filters
+            new_line = "\n"
+            with open(conc_text_path, "w") as conc_text_f:
+                conc_text_f.writelines([
+                    "file {}".format(
+                        slate_v_path.replace("\\", "/")),
+                    new_line,
+                    "file {}".format(input_path.replace("\\", "/"))
+                ])
 
-    def lut_filters(self, new_repre, instance, input_args):
-        """Add lut file to output ffmpeg filters."""
-        filters = []
-        # baking lut file application
-        lut_path = instance.data.get("lutPath")
-        if not lut_path or "bake-lut" not in new_repre["tags"]:
-            return filters
-
-        # Prepare path for ffmpeg argument
-        lut_path = lut_path.replace("\\", "/").replace(":", "\\:")
-
-        # Remove gamma from input arguments
-        if "-gamma" in input_args:
-            input_args.remove("-gamme")
-
-        # Prepare filters
-        filters.append("lut3d=file='{}'".format(lut_path))
-        # QUESTION hardcoded colormatrix?
-        filters.append("colormatrix=bt601:bt709")
-
-        self.log.info("Added Lut to ffmpeg command.")
-
-        return filters
-
-    def main_family_from_instance(self, instance):
-        """Returns main family of entered instance."""
-        family = instance.data.get("family")
-        if not family:
-            family = instance.data["families"][0]
-        return family
-
-    def families_from_instance(self, instance):
-        """Returns all families of entered instance."""
-        families = []
-        family = instance.data.get("family")
-        if family:
-            families.append(family)
-
-        for family in (instance.data.get("families") or tuple()):
-            if family not in families:
-                families.append(family)
-        return families
-
-    def compile_list_of_regexes(self, in_list):
-        """Convert strings in entered list to compiled regex objects."""
-        regexes = []
-        if not in_list:
-            return regexes
-
-        for item in in_list:
-            if not item:
-                continue
-
-            try:
-                regexes.append(re.compile(item))
-            except TypeError:
-                self.log.warning((
-                    "Invalid type \"{}\" value \"{}\"."
-                    " Expected string based object. Skipping."
-                ).format(str(type(item)), str(item)))
-
-        return regexes
-
-    def validate_value_by_regexes(self, value, in_list):
-        """Validates in any regex from list match entered value.
-
-        Args:
-            in_list (list): List with regexes.
-            value (str): String where regexes is checked.
-
-        Returns:
-            int: Returns `0` when list is not set or is empty. Returns `1` when
-                any regex match value and returns `-1` when none of regexes
-                match value entered.
-        """
-        if not in_list:
-            return 0
-
-        output = -1
-        regexes = self.compile_list_of_regexes(in_list)
-        for regex in regexes:
-            if re.match(regex, value):
-                output = 1
-                break
-        return output
-
-    def profile_exclusion(self, matching_profiles):
-        """Find out most matching profile byt host, task and family match.
-
-        Profiles are selectively filtered. Each profile should have
-        "__value__" key with list of booleans. Each boolean represents
-        existence of filter for specific key (host, tasks, family).
-        Profiles are looped in sequence. In each sequence are split into
-        true_list and false_list. For next sequence loop are used profiles in
-        true_list if there are any profiles else false_list is used.
-
-        Filtering ends when only one profile left in true_list. Or when all
-        existence booleans loops passed, in that case first profile from left
-        profiles is returned.
-
-        Args:
-            matching_profiles (list): Profiles with same values.
-
-        Returns:
-            dict: Most matching profile.
-        """
-        self.log.info(
-            "Search for first most matching profile in match order:"
-            " Host name -> Task name -> Family."
-        )
-        # Filter all profiles with highest points value. First filter profiles
-        # with matching host if there are any then filter profiles by task
-        # name if there are any and lastly filter by family. Else use first in
-        # list.
-        idx = 0
-        final_profile = None
-        while True:
-            profiles_true = []
-            profiles_false = []
-            for profile in matching_profiles:
-                value = profile["__value__"]
-                # Just use first profile when idx is greater than values.
-                if not idx < len(value):
-                    final_profile = profile
-                    break
-
-                if value[idx]:
-                    profiles_true.append(profile)
-                else:
-                    profiles_false.append(profile)
-
-            if final_profile is not None:
-                break
-
-            if profiles_true:
-                matching_profiles = profiles_true
-            else:
-                matching_profiles = profiles_false
-
-            if len(matching_profiles) == 1:
-                final_profile = matching_profiles[0]
-                break
-            idx += 1
-
-        final_profile.pop("__value__")
-        return final_profile
-
-    def find_matching_profile(self, host_name, task_name, family):
-        """ Filter profiles by Host name, Task name and main Family.
-
-        Filtering keys are "hosts" (list), "tasks" (list), "families" (list).
-        If key is not find or is empty than it's expected to match.
-
-        Args:
-            profiles (list): Profiles definition from presets.
-            host_name (str): Current running host name.
-            task_name (str): Current context task name.
-            family (str): Main family of current Instance.
-
-        Returns:
-            dict/None: Return most matching profile or None if none of profiles
-                match at least one criteria.
-        """
-
-        matching_profiles = None
-        if not self.profiles:
-            return matching_profiles
-
-        highest_profile_points = -1
-        # Each profile get 1 point for each matching filter. Profile with most
-        # points is returned. For cases when more than one profile will match
-        # are also stored ordered lists of matching values.
-        for profile in self.profiles:
-            profile_points = 0
-            profile_value = []
-
-            # Host filtering
-            host_names = profile.get("hosts")
-            match = self.validate_value_by_regexes(host_name, host_names)
-            if match == -1:
-                self.log.debug(
-                    "\"{}\" not found in {}".format(host_name, host_names)
-                )
-                continue
-            profile_points += match
-            profile_value.append(bool(match))
-
-            # Task filtering
-            task_names = profile.get("tasks")
-            match = self.validate_value_by_regexes(task_name, task_names)
-            if match == -1:
-                self.log.debug(
-                    "\"{}\" not found in {}".format(task_name, task_names)
-                )
-                continue
-            profile_points += match
-            profile_value.append(bool(match))
-
-            # Family filtering
-            families = profile.get("families")
-            match = self.validate_value_by_regexes(family, families)
-            if match == -1:
-                self.log.debug(
-                    "\"{}\" not found in {}".format(family, families)
-                )
-                continue
-            profile_points += match
-            profile_value.append(bool(match))
-
-            if profile_points < highest_profile_points:
-                continue
-
-            if profile_points > highest_profile_points:
-                matching_profiles = []
-                highest_profile_points = profile_points
-
-            if profile_points == highest_profile_points:
-                profile["__value__"] = profile_value
-                matching_profiles.append(profile)
-
-        if not matching_profiles:
-            self.log.warning((
-                "None of profiles match your setup."
-                " Host \"{}\" | Task: \"{}\" | Family: \"{}\""
-            ).format(host_name, task_name, family))
-            return
-
-        if len(matching_profiles) == 1:
-            # Pop temporary key `__value__`
-            matching_profiles[0].pop("__value__")
-            return matching_profiles[0]
-
-        self.log.warning((
-            "More than one profile match your setup."
-            " Host \"{}\" | Task: \"{}\" | Family: \"{}\""
-        ).format(host_name, task_name, family))
-
-        return self.profile_exclusion(matching_profiles)
-
-    def families_filter_validation(self, families, output_families_filter):
-        """Determines if entered families intersect with families filters.
-
-        All family values are lowered to avoid unexpected results.
-        """
-        if not output_families_filter:
-            return True
-
-        single_families = []
-        combination_families = []
-        for family_filter in output_families_filter:
-            if not family_filter:
-                continue
-            if isinstance(family_filter, (list, tuple)):
-                _family_filter = []
-                for family in family_filter:
-                    if family:
-                        _family_filter.append(family.lower())
-                combination_families.append(_family_filter)
-            else:
-                single_families.append(family_filter.lower())
-
-        for family in single_families:
-            if family in families:
-                return True
-
-        for family_combination in combination_families:
-            valid = True
-            for family in family_combination:
-                if family not in families:
-                    valid = False
-                    break
-
-            if valid:
-                return True
-        return False
-
-    def filter_output_defs(self, profile, subset_name, families):
-        """Return outputs matching input instance families.
-
-        Output definitions without families filter are marked as valid.
-
-        Args:
-            profile (dict): Profile from presets matching current context.
-            families (list): All families of current instance.
-
-        Returns:
-            list: Containg all output definitions matching entered families.
-        """
-        outputs = profile.get("outputs") or []
-        if not outputs:
-            return outputs
-
-        # lower values
-        # QUESTION is this valid operation?
-        families = [family.lower() for family in families]
-
-        filtered_outputs = {}
-        for filename_suffix, output_def in outputs.items():
-            output_filters = output_def.get("filter")
-            # If no filter on output preset, skip filtering and add output
-            # profile for farther processing
-            if not output_filters:
-                filtered_outputs[filename_suffix] = output_def
-                continue
-
-            families_filters = output_filters.get("families")
-            if not self.families_filter_validation(families, families_filters):
-                continue
-
-            # Subsets name filters
-            subset_filters = [
-                subset_filter
-                for subset_filter in output_filters.get("subsets", [])
-                # Skip empty strings
-                if subset_filter
+            # concat slate and videos together
+            concat_args = [
+                ffmpeg_path,
+                "-y",
+                "-f", "concat",
+                "-safe", "0",
+                "-i", conc_text_path,
+                "-c:v", "copy",
+                output_path
             ]
-            if subset_name and subset_filters:
-                match = False
-                for subset_filter in subset_filters:
-                    compiled = re.compile(subset_filter)
-                    if compiled.search(subset_name):
-                        match = True
-                        break
+            if not input_audio:
+                # ffmpeg concat subprocess
+                self.log.debug(
+                    "Executing concat: {}".format(" ".join(concat_args))
+                )
+                openpype.api.run_subprocess(
+                    concat_args, logger=self.log
+                )
+            else:
+                self.log.warning(
+                    "Audio found. Creating slate with audio"
+                    " is not supported at this time. Outputing slate-less"
+                    ":\n{}".format(input_file))
+                # skip concatenating slate, use slate-less file instead
+                shutil.copyfile(input_path, output_path)
 
-                if not match:
-                    continue
+            self.log.debug("__ repre[tags]: {}".format(repre["tags"]))
+            repre_update = {
+                "files": output_file,
+                "name": repre["name"],
+                "tags": [x for x in repre["tags"] if x != "delete"]
+            }
+            inst_data["representations"][idx].update(repre_update)
+            self.log.debug(
+                "_ representation {}: `{}`".format(
+                    idx, inst_data["representations"][idx]))
 
-            filtered_outputs[filename_suffix] = output_def
+            # removing temp files
+            for f in _remove_at_end:
+                os.remove(f)
+                self.log.debug("Removed: `{}`".format(f))
 
-        return filtered_outputs
+        # Remove any representations tagged for deletion.
+        for repre in inst_data.get("representations", []):
+            if "delete" in repre.get("tags", []):
+                self.log.debug("Removing representation: {}".format(repre))
+                inst_data["representations"].remove(repre)
 
-    def filter_outputs_by_tags(self, outputs, tags):
-        """Filter output definitions by entered representation tags.
-
-        Output definitions without tags filter are marked as valid.
-
-        Args:
-            outputs (list): Contain list of output definitions from presets.
-            tags (list): Tags of processed representation.
-
-        Returns:
-            list: Containg all output definitions matching entered tags.
-        """
-        filtered_outputs = []
-        repre_tags_low = [tag.lower() for tag in tags]
-        for output_def in outputs:
-            valid = True
-            output_filters = output_def.get("filter")
-            if output_filters:
-                # Check tag filters
-                tag_filters = output_filters.get("tags")
-                if tag_filters:
-                    tag_filters_low = [tag.lower() for tag in tag_filters]
-                    valid = False
-                    for tag in repre_tags_low:
-                        if tag in tag_filters_low:
-                            valid = True
-                            break
-
-                    if not valid:
-                        continue
-
-            if valid:
-                filtered_outputs.append(output_def)
-
-        return filtered_outputs
+        self.log.debug(inst_data["representations"])
 
     def add_video_filter_args(self, args, inserting_arg):
         """
-        Fixing video filter arguments to be one long string
+        Fixing video filter argumets to be one long string
 
         Args:
             args (list): list of string arguments
@@ -1784,299 +416,74 @@ class ExtractReview(pyblish.api.InstancePlugin):
 
         return vf_back
 
+    def _get_codec_args(self, repre):
+        """Detect possible codec arguments from representation."""
+        codec_args = []
 
-@six.add_metaclass(ABCMeta)
-class _OverscanValue:
-    def __repr__(self):
-        return "<{}> {}".format(self.__class__.__name__, str(self))
+        # Get one filename of representation files
+        filename = repre["files"]
+        # If files is list then pick first filename in list
+        if isinstance(filename, (tuple, list)):
+            filename = filename[0]
+        # Get full path to the file
+        full_input_path = os.path.join(repre["stagingDir"], filename)
 
-    @abstractmethod
-    def copy(self):
-        """Create a copy of object."""
-        pass
-
-    @abstractmethod
-    def size_for(self, value):
-        """Calculate new value for passed value."""
-        pass
-
-
-class PixValueExplicit(_OverscanValue):
-    def __init__(self, value):
-        self._value = int(value)
-
-    def __str__(self):
-        return "{}px".format(self._value)
-
-    def copy(self):
-        return PixValueExplicit(self._value)
-
-    def size_for(self, value):
-        if self._value == 0:
-            return value
-        return self._value
-
-
-class PercentValueExplicit(_OverscanValue):
-    def __init__(self, value):
-        self._value = float(value)
-
-    def __str__(self):
-        return "{}%".format(abs(self._value))
-
-    def copy(self):
-        return PercentValueExplicit(self._value)
-
-    def size_for(self, value):
-        if self._value == 0:
-            return value
-        return int((value / 100) * self._value)
-
-
-class PixValueRelative(_OverscanValue):
-    def __init__(self, value):
-        self._value = int(value)
-
-    def __str__(self):
-        sign = "-" if self._value < 0 else "+"
-        return "{}{}px".format(sign, abs(self._value))
-
-    def copy(self):
-        return PixValueRelative(self._value)
-
-    def size_for(self, value):
-        return value + self._value
-
-
-class PercentValueRelative(_OverscanValue):
-    def __init__(self, value):
-        self._value = float(value)
-
-    def __str__(self):
-        return "{}%".format(self._value)
-
-    def copy(self):
-        return PercentValueRelative(self._value)
-
-    def size_for(self, value):
-        if self._value == 0:
-            return value
-
-        offset = int((value / 100) * self._value)
-
-        return value + offset
-
-
-class PercentValueRelativeSource(_OverscanValue):
-    def __init__(self, value, source_sign):
-        self._value = float(value)
-        if source_sign not in ("-", "+"):
-            raise ValueError(
-                "Invalid sign value \"{}\" expected \"-\" or \"+\"".format(
-                    source_sign
-                )
+        try:
+            # Get information about input file via ffprobe tool
+            ffprobe_data = get_ffprobe_data(full_input_path, self.log)
+        except Exception:
+            self.log.warning(
+                "Could not get codec data from input.",
+                exc_info=True
             )
-        self._source_sign = source_sign
+            return codec_args
 
-    def __str__(self):
-        return "{}%{}".format(self._value, self._source_sign)
-
-    def copy(self):
-        return PercentValueRelativeSource(self._value, self._source_sign)
-
-    def size_for(self, value):
-        if self._value == 0:
-            return value
-        return int((value * 100) / (100 - self._value))
-
-
-class OverscanCrop:
-    """Helper class to read overscan string and calculate output resolution.
-
-    It is possible to enter single value for both width and heigh or two values
-    for width and height. Overscan string may have a few variants. Each variant
-    define output size for input size.
-
-    ### Example
-    For input size: 2200px
-
-    | String   | Output | Description                                     |
-    |----------|--------|-------------------------------------------------|
-    | ""       | 2200px | Empty string does nothing.                      |
-    | "10%"    | 220px  | Explicit percent size.                          |
-    | "-10%"   | 1980px | Relative percent size (decrease).               |
-    | "+10%"   | 2420px | Relative percent size (increase).               |
-    | "-10%+"  | 2000px | Relative percent size to output size.           |
-    | "300px"  | 300px  | Explicit output size cropped or expanded.       |
-    | "-300px" | 1900px | Relative pixel size (decrease).                 |
-    | "+300px" | 2500px | Relative pixel size (increase).                 |
-    | "300"    | 300px  | Value without "%" and "px" is used as has "px". |
-
-    Value without sign (+/-) in is always explicit and value with sign is
-    relative. Output size for "200px" and "+200px" are not the same.
-    Values "0", "0px" or "0%" are ignored.
-
-    All values that cause output resolution smaller than 1 pixel are invalid.
-
-    Value "-10%+" is a special case which says that input's resolution is
-    bigger by 10% than expected output.
-
-    It is possible to combine these variants to define different output for
-    width and height.
-
-    Resolution: 2000px 1000px
-
-    | String        | Output        |
-    |---------------|---------------|
-    | "100px 120px" | 2100px 1120px |
-    | "-10% -200px" | 1800px 800px  |
-    """
-
-    item_regex = re.compile(r"([\+\-])?([0-9]+)(.+)?")
-    relative_source_regex = re.compile(r"%([\+\-])")
-
-    def __init__(
-        self, input_width, input_height, string_value, overscal_color=None
-    ):
-        # Make sure that is not None
-        string_value = string_value or ""
-
-        self.input_width = input_width
-        self.input_height = input_height
-        self.overscal_color = overscal_color
-
-        width, height = self._convert_string_to_values(string_value)
-        self._width_value = width
-        self._height_value = height
-
-        self._string_value = string_value
-
-    def __str__(self):
-        return "{}".format(self._string_value)
-
-    def __repr__(self):
-        return "<{}>".format(self.__class__.__name__)
-
-    def width(self):
-        """Calculated width."""
-        return self._width_value.size_for(self.input_width)
-
-    def height(self):
-        """Calculated height."""
-        return self._height_value.size_for(self.input_height)
-
-    def video_filters(self):
-        """FFmpeg video filters to achieve expected result.
-
-        Filter may be empty, use "crop" filter, "pad" filter or combination of
-        "crop" and "pad".
-
-        Returns:
-            list: FFmpeg video filters.
-        """
-        # crop=width:height:x:y - explicit start x, y position
-        # crop=width:height     - x, y are related to center by width/height
-        # pad=width:heigth:x:y  - explicit start x, y position
-        # pad=width:heigth      - x, y are set to 0 by default
-
-        width = self.width()
-        height = self.height()
-
-        output = []
-        if self.input_width == width and self.input_height == height:
-            return output
-
-        # Make sure resolution has odd numbers
-        if width % 2 == 1:
-            width -= 1
-
-        if height % 2 == 1:
-            height -= 1
-
-        if width <= self.input_width and height <= self.input_height:
-            output.append("crop={}:{}".format(width, height))
-
-        elif width >= self.input_width and height >= self.input_height:
-            output.append(
-                "pad={}:{}:(iw-ow)/2:(ih-oh)/2:{}".format(
-                    width, height, self.overscal_color
-                )
+        source_ffmpeg_cmd = repre.get("ffmpeg_cmd")
+        codec_args.extend(
+            get_ffmpeg_format_args(ffprobe_data, source_ffmpeg_cmd)
+        )
+        codec_args.extend(
+            get_ffmpeg_codec_args(
+                ffprobe_data, source_ffmpeg_cmd, logger=self.log
             )
-
-        elif width > self.input_width and height < self.input_height:
-            output.append("crop=iw:{}".format(height))
-            output.append("pad={}:ih:(iw-ow)/2:(ih-oh)/2:{}".format(
-                width, self.overscal_color
-            ))
-
-        elif width < self.input_width and height > self.input_height:
-            output.append("crop={}:ih".format(width))
-            output.append("pad=iw:{}:(iw-ow)/2:(ih-oh)/2:{}".format(
-                height, self.overscal_color
-            ))
-
-        return output
-
-    def _convert_string_to_values(self, orig_string_value):
-        string_value = orig_string_value.strip().lower()
-        if not string_value:
-            return [PixValueRelative(0), PixValueRelative(0)]
-
-        # Replace "px" (and spaces before) with single space
-        string_value = re.sub(r"([ ]+)?px", " ", string_value)
-        string_value = re.sub(r"([ ]+)%", "%", string_value)
-        # Make sure +/- sign at the beggining of string is next to number
-        string_value = re.sub(r"^([\+\-])[ ]+", "\g<1>", string_value)
-        # Make sure +/- sign in the middle has zero spaces before number under
-        #   which belongs
-        string_value = re.sub(
-            r"[ ]([\+\-])[ ]+([0-9])",
-            r" \g<1>\g<2>",
-            string_value
         )
-        string_parts = [
-            part
-            for part in string_value.split(" ")
-            if part
-        ]
 
-        error_msg = "Invalid string for rescaling \"{}\"".format(
-            orig_string_value
-        )
-        if 1 > len(string_parts) > 2:
-            raise ValueError(error_msg)
+        return codec_args
 
-        output = []
-        for item in string_parts:
-            groups = self.item_regex.findall(item)
-            if not groups:
-                raise ValueError(error_msg)
-
-            relative_sign, value, ending = groups[0]
-            if not relative_sign:
-                if not ending:
-                    output.append(PixValueExplicit(value))
-                else:
-                    output.append(PercentValueExplicit(value))
+    def _tc_offset(self, timecode, framerate=24.0, frame_offset=-1):
+        """Offsets timecode by frame"""
+        def _seconds(value, framerate):
+            if isinstance(value, str):
+                _zip_ft = zip((3600, 60, 1, 1/framerate), value.split(':'))
+                _s = sum(f * float(t) for f,t in _zip_ft)
+            elif isinstance(value, (int, float)):
+                _s = value / framerate
             else:
-                source_sign_group = self.relative_source_regex.findall(ending)
-                if not ending:
-                    output.append(PixValueRelative(int(relative_sign + value)))
+                _s = 0
+            return _s
 
-                elif source_sign_group:
-                    source_sign = source_sign_group[0]
-                    output.append(PercentValueRelativeSource(
-                        float(relative_sign + value), source_sign
-                    ))
-                else:
-                    output.append(
-                        PercentValueRelative(float(relative_sign + value))
-                    )
+        def _frames(seconds, framerate, frame_offset):
+            _f = seconds * framerate + frame_offset
+            if _f < 0:
+                _f = framerate * 60 * 60 * 24 + _f
+            return _f
 
-        if len(output) == 1:
-            width = output.pop(0)
-            height = width.copy()
-        else:
-            width, height = output
-
-        return width, height
+        def _timecode(seconds, framerate):
+            return '{h:02d}:{m:02d}:{s:02d}:{f:02d}'.format(
+                h = int(seconds / 3600),
+                m = int(seconds / 60 % 60),
+                s = int(seconds % 60),
+                f = int(round((seconds - int(seconds)) * framerate)))
+        drop = False
+        if ';' in timecode:
+            timecode = timecode.replace(';', ':')
+            drop = True
+        frames = _frames(
+            _seconds(timecode, framerate),
+            framerate,
+            frame_offset
+        )
+        tc = _timecode(_seconds(frames, framerate), framerate)
+        if drop:
+            tc = ';'.join(tc.rsplit(':', 1))
+        return tc

From 8abc3ff7953001b687af2d860e0892a3d968c0a6 Mon Sep 17 00:00:00 2001
From: Jiri Sindelar <45896205+jrsndl@users.noreply.github.com>
Date: Thu, 14 Apr 2022 19:19:28 +0200
Subject: [PATCH 0102/1227] hound

---
 openpype/plugins/publish/extract_review_slate.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index c8ee2ec7ed..13526ece66 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -454,8 +454,8 @@ class ExtractReviewSlate(openpype.api.Extractor):
         """Offsets timecode by frame"""
         def _seconds(value, framerate):
             if isinstance(value, str):
-                _zip_ft = zip((3600, 60, 1, 1/framerate), value.split(':'))
-                _s = sum(f * float(t) for f,t in _zip_ft)
+                _zip_ft = zip((3600, 60, 1, 1 / framerate), value.split(':'))
+                _s = sum(f * float(t) for f, t in _zip_ft)
             elif isinstance(value, (int, float)):
                 _s = value / framerate
             else:
@@ -470,10 +470,10 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
         def _timecode(seconds, framerate):
             return '{h:02d}:{m:02d}:{s:02d}:{f:02d}'.format(
-                h = int(seconds / 3600),
-                m = int(seconds / 60 % 60),
-                s = int(seconds % 60),
-                f = int(round((seconds - int(seconds)) * framerate)))
+                h=int(seconds / 3600),
+                m=int(seconds / 60 % 60),
+                s=int(seconds % 60),
+                f=int(round((seconds - int(seconds)) * framerate)))
         drop = False
         if ';' in timecode:
             timecode = timecode.replace(';', ':')

From 8a970b123c1697d7db28f31debf4f7113c3c3177 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 21 Apr 2022 11:24:49 +0200
Subject: [PATCH 0103/1227] Use logic directly from Sync Server module

---
 openpype/plugins/publish/integrate_new.py | 165 +---------------------
 1 file changed, 6 insertions(+), 159 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 2795b59482..cc6856e407 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -4,14 +4,13 @@ import sys
 import copy
 import clique
 import six
-from collections import deque, defaultdict
 
 from bson.objectid import ObjectId
 from pymongo import DeleteMany, ReplaceOne, InsertOne, UpdateOne
 import pyblish.api
 from avalon import io
 import openpype.api
-from datetime import datetime
+from openpype.modules import ModulesManager
 from openpype.lib.profiles_filtering import filter_profiles
 from openpype.lib.file_transaction import FileTransaction
 
@@ -299,11 +298,12 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         self.log.debug("Retrieving Representation Site Sync information ...")
 
         # Get the accessible sites for Site Sync
-        sites = SiteSync.compute_resource_sync_sites(
-            system_settings=instance.context.data["system_settings"],
-            project_settings=instance.context.data["project_settings"]
+        manager = ModulesManager()
+        sync_server_module = manager.modules_by_name["sync_server"]
+        sites = sync_server_module.compute_resource_sync_sites(
+            project_name=instance.data["projectEntity"]["name"]
         )
-        self.log.debug("Site Sync Sites: {}".format(sites))
+        self.log.debug("Sync Server Sites: {}".format(sites))
 
         # Compute the resource file infos once (files belonging to the
         # version instance instead of an individual representation) so
@@ -828,156 +828,3 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             "hash": openpype.api.source_hash(path),
             "sites": sites
         }
-
-
-class SiteSync(object):
-    """Logic for Site Sync Module functionality"""
-
-    @classmethod
-    def compute_resource_sync_sites(cls,
-                                    system_settings,
-                                    project_settings):
-        """Get available resource sync sites"""
-
-        def create_metadata(name, created=True):
-            """Create sync site metadata for site with `name`"""
-            metadata = {"name": name}
-            if created:
-                metadata["created_dt"] = datetime.now()
-            return metadata
-
-        default_sites = [create_metadata("studio")]
-
-        # If sync site module is disabled return default fallback site
-        system_sync_server_presets = system_settings["modules"]["sync_server"]
-        log.debug("system_sett:: {}".format(system_sync_server_presets))
-        if not system_sync_server_presets["enabled"]:
-            return default_sites
-
-        # If sync site module is disabled in current
-        # project return default fallback site
-        sync_project_presets = project_settings["global"]["sync_server"]
-        if not sync_project_presets["enabled"]:
-            return default_sites
-
-        local_site, remote_site = cls._get_sites(sync_project_presets)
-
-        # Attached sites metadata by site name
-        # That is the local site, remote site, the always accesible sites
-        # and their alternate sites (alias of sites with different protocol)
-        attached_sites = dict()
-        attached_sites[local_site] = create_metadata(local_site)
-
-        if remote_site and remote_site != local_site:
-            attached_sites[remote_site] = create_metadata(remote_site,
-                                                          created=False)
-
-        # add alternative sites
-        cls._add_alternative_sites(system_sync_server_presets, attached_sites)
-
-        # add skeleton for sites where it should be always synced to
-        always_accessible_sites = (
-            sync_project_presets["config"].get("always_accessible_on", [])
-        )
-        for site in set(always_accessible_sites):
-            site = site.strip()
-            if site not in attached_sites:
-                attached_sites[site] = create_metadata(site, created=False)
-
-        return list(attached_sites.values())
-
-    @staticmethod
-    def _get_sites(sync_project_presets):
-        """Returns tuple (local_site, remote_site)"""
-        local_site_id = openpype.api.get_local_site_id()
-        local_site = sync_project_presets["config"]. \
-            get("active_site", "studio").strip()
-
-        if local_site == 'local':
-            local_site = local_site_id
-
-        remote_site = sync_project_presets["config"].get("remote_site")
-        if remote_site:
-            remote_site.strip()
-
-        if remote_site == 'local':
-            remote_site = local_site_id
-
-        return local_site, remote_site
-
-    @classmethod
-    def _add_alternative_sites(cls,
-                               system_sync_server_presets,
-                               attached_sites):
-        """Loop through all configured sites and add alternatives.
-
-        For all sites if an alternative site is detected that has an
-        accessible site then we can also register to that alternative site
-        with the same "created" state. So we match the existing data.
-
-            See SyncServerModule.handle_alternate_site
-        """
-        conf_sites = system_sync_server_presets.get("sites", {})
-        alt_site_pairs = cls._get_alt_site_pairs(conf_sites)
-
-        for site_name, alt_sites in alt_site_pairs.items():
-
-            # Skip if already defined
-            if site_name in attached_sites:
-                continue
-
-            # If no alternative sites we don't need to add
-            if not alt_sites:
-                continue
-
-            # Take a copy of data of the first alternate site that is already
-            # defined as an attached site to match the same state.
-            match_meta = next((attached_sites[site] for site in alt_sites
-                               if site in attached_sites), None)
-            if not match_meta:
-                continue
-
-            alt_site_meta = copy.deepcopy(match_meta)
-            alt_site_meta["name"] = site_name
-
-            # Note: We change mutable `attached_site` dict in-place
-            attached_sites[site_name] = alt_site_meta
-
-    @staticmethod
-    def _get_alt_site_pairs(conf_sites):
-        """Returns dict of site and its alternative sites.
-        If `site` has alternative site, it means that alt_site has
-        'site' as
-        alternative site
-        Args:
-            conf_sites (dict)
-        Returns:
-            (dict): {'site': [alternative sites]...}
-        """
-        alt_site_pairs = defaultdict(set)
-        for site_name, site_info in conf_sites.items():
-            alt_sites = set(site_info.get("alternative_sites", []))
-            alt_site_pairs[site_name].update(alt_sites)
-
-            for alt_site in alt_sites:
-                alt_site_pairs[alt_site].add(site_name)
-
-        for site_name, alt_sites in alt_site_pairs.items():
-            sites_queue = deque(alt_sites)
-            while sites_queue:
-                alt_site = sites_queue.popleft()
-
-                # safety against wrong config
-                # {"SFTP": {"alternative_site": "SFTP"}
-                if alt_site == site_name or alt_site not in alt_site_pairs:
-                    continue
-
-                for alt_alt_site in alt_site_pairs[alt_site]:
-                    if (
-                            alt_alt_site != site_name
-                            and alt_alt_site not in alt_sites
-                    ):
-                        alt_sites.add(alt_alt_site)
-                        sites_queue.append(alt_alt_site)
-
-        return alt_site_pairs

From ae1acb950bbb69b203c36f19d40e3952eca46bfd Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 21 Apr 2022 14:08:53 +0200
Subject: [PATCH 0104/1227] Fix: refactor to use correct function

---
 openpype/plugins/publish/integrate_new.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index cc6856e407..419e2b4e4b 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -309,9 +309,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         # version instance instead of an individual representation) so
         # we can re-use those file infos per representation
         anatomy = instance.context.data["anatomy"]
-        resource_file_infos = self.prepare_file_info(resource_destinations,
-                                                     sites=sites,
-                                                     anatomy=anatomy)
+        resource_file_infos = self.get_files_info(resource_destinations,
+                                                  sites=sites,
+                                                  anatomy=anatomy)
 
         # Finalize the representations now the published files are integrated
         # Get 'files' info for representations and its attached resources

From b74774d02fc4cf2efc8fc00c482845ab1b2dbdaa Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 25 Apr 2022 18:09:35 +0200
Subject: [PATCH 0105/1227] Implement `get_visible_in_frame_range` for
 extracting Alembics

---
 openpype/hosts/maya/api/lib.py                | 204 ++++++++++++++++++
 .../maya/plugins/publish/extract_animation.py |  13 +-
 .../plugins/publish/extract_pointcache.py     |  13 +-
 3 files changed, 228 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 801cdb16f4..5304112dcf 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -3176,3 +3176,207 @@ def parent_nodes(nodes, parent=None):
                 node[0].setParent(node[1])
         if delete_parent:
             pm.delete(parent_node)
+
+
+@contextlib.contextmanager
+def maintained_time():
+    ct = cmds.currentTime(query=True)
+    try:
+        yield
+    finally:
+        cmds.currentTime(ct, edit=True)
+
+
+def get_visible_in_frame_range(nodes, start, end):
+    """Return nodes that are visible in start-end frame range.
+
+    - Ignores intermediateObjects completely.
+    - Considers animated visibility attributes + upstream visibilities.
+
+    This is optimized for large scenes where some nodes in the parent
+    hierarchy might have some input connections to the visibilities,
+    e.g. key, driven keys, connections to other attributes, etc.
+
+    This only does a single time step to `start` if current frame is
+    not inside frame range since the assumption is made that changing
+    a frame isn't so slow that it beats querying all visibility
+    plugs through MDGContext on another frame.
+
+    Args:
+        nodes (list): List of node names to consider.
+        start (int): Start frame.
+        end (int): End frame.
+
+    Returns:
+        list: List of node names. These will be long full path names so
+            might have a longer name than the input nodes.
+
+    """
+    # States we consider per node
+    VISIBLE = 1  # always visible
+    INVISIBLE = 0  # always invisible
+    ANIMATED = -1  # animated visibility
+
+    # Ensure integers
+    start = int(start)
+    end = int(end)
+
+    # Consider only non-intermediate dag nodes and use the "long" names.
+    nodes = cmds.ls(nodes, long=True, noIntermediate=True, type="dagNode")
+    if not nodes:
+        return []
+
+    with maintained_time():
+        # Go to first frame of the range if we current time is outside of
+        # the queried range. This is to do a single query on which are at
+        # least visible at a time inside the range, (e.g those that are
+        # always visible)
+        current_time = cmds.currentTime(query=True)
+        if not (start <= current_time <= end):
+            cmds.currentTime(start)
+
+        visible = cmds.ls(nodes, long=True, visible=True)
+        if len(visible) == len(nodes) or start == end:
+            # All are visible on frame one, so they are at least visible once
+            # inside the frame range.
+            return visible
+
+    # For the invisible ones check whether its visibility and/or
+    # any of its parents visibility attributes are animated. If so, it might
+    # get visible on other frames in the range.
+    def memodict(f):
+        """Memoization decorator for a function taking a single argument.
+
+        See: http://code.activestate.com/recipes/
+             578231-probably-the-fastest-memoization-decorator-in-the-/
+        """
+
+        class memodict(dict):
+            def __missing__(self, key):
+                ret = self[key] = f(key)
+                return ret
+
+        return memodict().__getitem__
+
+    @memodict
+    def get_state(node):
+        plug = node + ".visibility"
+        connections = cmds.listConnections(plug,
+                                           source=True,
+                                           destination=False)
+        if connections:
+            return ANIMATED
+        else:
+            return VISIBLE if cmds.getAttr(plug) else INVISIBLE
+
+    visible = set(visible)
+    invisible = [node for node in nodes if node not in visible]
+    always_invisible = set()
+    # Iterate over the nodes by short to long names, so we iterate the highest
+    # in hierarcy nodes first. So the collected data can be used from the
+    # cache for parent queries in next iterations.
+    node_dependencies = dict()
+    for node in sorted(invisible, key=len):
+
+        state = get_state(node)
+        if state == INVISIBLE:
+            always_invisible.add(node)
+            continue
+
+        # If not always invisible by itself we should go through and check
+        # the parents to see if any of them are always invisible. For those
+        # that are "ANIMATED" we consider that this node is dependent on
+        # that attribute, we store them as dependency.
+        dependencies = set()
+        if state == ANIMATED:
+            dependencies.add(node)
+
+        traversed_parents = list()
+        for parent in iter_parents(node):
+
+            if not parent:
+                # Workaround bug in iter_parents
+                continue
+
+            if parent in always_invisible or get_state(parent) == INVISIBLE:
+                # When parent is always invisible then consider this parent,
+                # this node we started from and any of the parents we
+                # have traversed in-between to be *always invisible*
+                always_invisible.add(parent)
+                always_invisible.add(node)
+                always_invisible.update(traversed_parents)
+                break
+
+            # If we have traversed the parent before and its visibility
+            # was dependent on animated visibilities then we can just extend
+            # its dependencies for to those for this node and break further
+            # iteration upwards.
+            parent_dependencies = node_dependencies.get(parent, None)
+            if parent_dependencies is not None:
+                dependencies.update(parent_dependencies)
+                break
+
+            state = get_state(parent)
+            if state == ANIMATED:
+                dependencies.add(parent)
+
+            traversed_parents.append(parent)
+
+        if node not in always_invisible and dependencies:
+            node_dependencies[node] = dependencies
+
+    if not node_dependencies:
+        return list(visible)
+
+    # Now we only have to check the visibilities for nodes that have animated
+    # visibility dependencies upstream. The fastest way to check these
+    # visibility attributes across different frames is with Python api 2.0
+    # so we do that.
+    @memodict
+    def get_visibility_mplug(node):
+        """Return api 2.0 MPlug with cached memoize decorator"""
+        sel = om.MSelectionList()
+        sel.add(node)
+        dag = sel.getDagPath(0)
+        return om.MFnDagNode(dag).findPlug("visibility", True)
+
+    # We skip the first frame as we already used that frame to check for
+    # overall visibilities. And end+1 to include the end frame.
+    scene_units = om.MTime.uiUnit()
+    for frame in range(start + 1, end + 1):
+
+        mtime = om.MTime(frame, unit=scene_units)
+        context = om.MDGContext(mtime)
+
+        # Build little cache so we don't query the same MPlug's value
+        # again if it was checked on this frame and also is a dependency
+        # for another node
+        frame_visibilities = {}
+
+        for node, dependencies in list(node_dependencies.items()):
+
+            for dependency in dependencies:
+
+                dependency_visible = frame_visibilities.get(dependency, None)
+                if dependency_visible is None:
+                    mplug = get_visibility_mplug(dependency)
+                    dependency_visible = mplug.asBool(context)
+                    frame_visibilities[dependency] = dependency_visible
+
+                if not dependency_visible:
+                    # One dependency is not visible, thus the
+                    # node is not visible.
+                    break
+
+            else:
+                # All dependencies are visible.
+                visible.add(node)
+                # Remove node with dependencies for next iterations
+                # because it was visible at least once.
+                node_dependencies.pop(node)
+
+        # If no more nodes to process break the frame iterations..
+        if not node_dependencies:
+            break
+
+    return list(visible)
diff --git a/openpype/hosts/maya/plugins/publish/extract_animation.py b/openpype/hosts/maya/plugins/publish/extract_animation.py
index 8a8bd67cd8..b63cebde04 100644
--- a/openpype/hosts/maya/plugins/publish/extract_animation.py
+++ b/openpype/hosts/maya/plugins/publish/extract_animation.py
@@ -6,7 +6,8 @@ import openpype.api
 from openpype.hosts.maya.api.lib import (
     extract_alembic,
     suspended_refresh,
-    maintained_selection
+    maintained_selection,
+    get_visible_in_frame_range
 )
 
 
@@ -70,6 +71,16 @@ class ExtractAnimation(openpype.api.Extractor):
             # Since Maya 2017 alembic supports multiple uv sets - write them.
             options["writeUVSets"] = True
 
+        if instance.data.get("visibleOnly", False):
+            # If we only want to include nodes that are visible in the frame
+            # range then we need to do our own check. Alembic's `visibleOnly`
+            # flag does not filter out those that are only hidden on some
+            # frames as it counts "animated" or "connected" visibilities as
+            # if it's always visible.
+            nodes = get_visible_in_frame_range(nodes,
+                                               start=start,
+                                               end=end)
+
         with suspended_refresh():
             with maintained_selection():
                 cmds.select(nodes, noExpand=True)
diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index 60502fdde1..4510943a48 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -6,7 +6,8 @@ import openpype.api
 from openpype.hosts.maya.api.lib import (
     extract_alembic,
     suspended_refresh,
-    maintained_selection
+    maintained_selection,
+    get_visible_in_frame_range
 )
 
 
@@ -73,6 +74,16 @@ class ExtractAlembic(openpype.api.Extractor):
             # Since Maya 2017 alembic supports multiple uv sets - write them.
             options["writeUVSets"] = True
 
+        if instance.data.get("visibleOnly", False):
+            # If we only want to include nodes that are visible in the frame
+            # range then we need to do our own check. Alembic's `visibleOnly`
+            # flag does not filter out those that are only hidden on some
+            # frames as it counts "animated" or "connected" visibilities as
+            # if it's always visible.
+            nodes = get_visible_in_frame_range(nodes,
+                                               start=start,
+                                               end=end)
+
         with suspended_refresh():
             with maintained_selection():
                 cmds.select(nodes, noExpand=True)

From ddddb86e77939214d818a54efc7a0eda5587588d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Mon, 25 Apr 2022 18:56:20 +0200
Subject: [PATCH 0106/1227] wip on ue5 support

---
 openpype/hosts/unreal/lib.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/unreal/lib.py b/openpype/hosts/unreal/lib.py
index d4a776e892..c0b4c7061c 100644
--- a/openpype/hosts/unreal/lib.py
+++ b/openpype/hosts/unreal/lib.py
@@ -74,7 +74,7 @@ def get_editor_executable_path(engine_path: Path) -> Path:
     """Get UE4 Editor executable path."""
     ue4_path = engine_path / "Engine/Binaries"
     if platform.system().lower() == "windows":
-        ue4_path /= "Win64/UE4Editor.exe"
+        ue4_path /= "Win64/UnrealEditor.exe"
 
     elif platform.system().lower() == "linux":
         ue4_path /= "Linux/UE4Editor"
@@ -420,7 +420,7 @@ class {1}_API A{0}GameModeBase : public AGameModeBase
         f.write(game_mode_h)
 
     u_build_tool = Path(
-        engine_path / "Engine/Binaries/DotNET/UnrealBuildTool.exe")
+        engine_path / "Engine/Binaries/DotNET/UnrealBuildTool/UnrealBuildTool.exe")
     u_header_tool = None
 
     arch = "Win64"

From 66f8ebbd0f175e275bae7ae4b555f55b7fe12163 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 26 Apr 2022 09:10:03 +0200
Subject: [PATCH 0107/1227] Use MDGContext as context manager

- Functionality added in Maya 2018
- Usage without `MDGContext.makeCurrent()` is deprecated since Maya 2022
---
 openpype/hosts/maya/api/lib.py | 51 +++++++++++++++++++---------------
 1 file changed, 29 insertions(+), 22 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 5304112dcf..82de105d16 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -3340,40 +3340,47 @@ def get_visible_in_frame_range(nodes, start, end):
         dag = sel.getDagPath(0)
         return om.MFnDagNode(dag).findPlug("visibility", True)
 
+    @contextlib.contextmanager
+    def dgcontext(mtime):
+        """MDGContext context manager"""
+        context = om.MDGContext(mtime)
+        try:
+            previous = context.makeCurrent()
+            yield context
+        finally:
+            previous.makeCurrent()
+
     # We skip the first frame as we already used that frame to check for
     # overall visibilities. And end+1 to include the end frame.
     scene_units = om.MTime.uiUnit()
     for frame in range(start + 1, end + 1):
-
         mtime = om.MTime(frame, unit=scene_units)
-        context = om.MDGContext(mtime)
 
         # Build little cache so we don't query the same MPlug's value
         # again if it was checked on this frame and also is a dependency
         # for another node
         frame_visibilities = {}
+        with dgcontext(mtime) as context:
+            for node, dependencies in list(node_dependencies.items()):
+                for dependency in dependencies:
+                    dependency_visible = frame_visibilities.get(dependency,
+                                                                None)
+                    if dependency_visible is None:
+                        mplug = get_visibility_mplug(dependency)
+                        dependency_visible = mplug.asBool(context)
+                        frame_visibilities[dependency] = dependency_visible
 
-        for node, dependencies in list(node_dependencies.items()):
+                    if not dependency_visible:
+                        # One dependency is not visible, thus the
+                        # node is not visible.
+                        break
 
-            for dependency in dependencies:
-
-                dependency_visible = frame_visibilities.get(dependency, None)
-                if dependency_visible is None:
-                    mplug = get_visibility_mplug(dependency)
-                    dependency_visible = mplug.asBool(context)
-                    frame_visibilities[dependency] = dependency_visible
-
-                if not dependency_visible:
-                    # One dependency is not visible, thus the
-                    # node is not visible.
-                    break
-
-            else:
-                # All dependencies are visible.
-                visible.add(node)
-                # Remove node with dependencies for next iterations
-                # because it was visible at least once.
-                node_dependencies.pop(node)
+                else:
+                    # All dependencies are visible.
+                    visible.add(node)
+                    # Remove node with dependencies for next frame iterations
+                    # because it was visible at least once.
+                    node_dependencies.pop(node)
 
         # If no more nodes to process break the frame iterations..
         if not node_dependencies:

From 338bb1560a33582364f3a45724cf2ff19f89a2da Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 26 Apr 2022 09:43:16 +0200
Subject: [PATCH 0108/1227] Fix bug in `iter_parents`

Previously an empty string could be yielded for e.g. `"|cube"` splitting to `["", "cube"]`
---
 openpype/hosts/maya/api/lib.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 82de105d16..901b8c4a4c 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -1876,7 +1876,7 @@ def iter_parents(node):
     """
     while True:
         split = node.rsplit("|", 1)
-        if len(split) == 1:
+        if len(split) == 1 or not split[0]:
             return
 
         node = split[0]

From b7d52214101960e8e821efdca417306ab99957e8 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 26 Apr 2022 09:43:56 +0200
Subject: [PATCH 0109/1227] Remove redundant workaround

---
 openpype/hosts/maya/api/lib.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 901b8c4a4c..52e84c00ab 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -3294,10 +3294,6 @@ def get_visible_in_frame_range(nodes, start, end):
         traversed_parents = list()
         for parent in iter_parents(node):
 
-            if not parent:
-                # Workaround bug in iter_parents
-                continue
-
             if parent in always_invisible or get_state(parent) == INVISIBLE:
                 # When parent is always invisible then consider this parent,
                 # this node we started from and any of the parents we

From faff541bc73529f1a2ebe16ff4b496d01d77f1af Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 26 Apr 2022 16:43:19 +0200
Subject: [PATCH 0110/1227] Removed submodule repos/avalon-core

---
 .gitmodules       | 0
 repos/avalon-core | 1 -
 2 files changed, 1 deletion(-)
 delete mode 100644 .gitmodules
 delete mode 160000 repos/avalon-core

diff --git a/.gitmodules b/.gitmodules
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/repos/avalon-core b/repos/avalon-core
deleted file mode 160000
index 2fa14cea6f..0000000000
--- a/repos/avalon-core
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 2fa14cea6f6a9d86eec70bbb96860cbe4c75c8eb

From 4c259c443e1c9a96c92bf48113eda9d31bff309b Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 28 Apr 2022 17:30:21 +0200
Subject: [PATCH 0111/1227] Improve comments

---
 openpype/hosts/maya/api/lib.py | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 52e84c00ab..79f2442d16 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -3227,10 +3227,9 @@ def get_visible_in_frame_range(nodes, start, end):
         return []
 
     with maintained_time():
-        # Go to first frame of the range if we current time is outside of
-        # the queried range. This is to do a single query on which are at
-        # least visible at a time inside the range, (e.g those that are
-        # always visible)
+        # Go to first frame of the range if the current time is outside
+        # the queried range so can directly query all visible nodes on
+        # that frame.
         current_time = cmds.currentTime(query=True)
         if not (start <= current_time <= end):
             cmds.currentTime(start)
@@ -3272,8 +3271,8 @@ def get_visible_in_frame_range(nodes, start, end):
     visible = set(visible)
     invisible = [node for node in nodes if node not in visible]
     always_invisible = set()
-    # Iterate over the nodes by short to long names, so we iterate the highest
-    # in hierarcy nodes first. So the collected data can be used from the
+    # Iterate over the nodes by short to long names to iterate the highest
+    # in hierarchy nodes first. So the collected data can be used from the
     # cache for parent queries in next iterations.
     node_dependencies = dict()
     for node in sorted(invisible, key=len):

From fb2327ad3b6a71278def4632de287b16560b7142 Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Fri, 29 Apr 2022 13:25:23 +0200
Subject: [PATCH 0112/1227] concat timecode fix

---
 .../plugins/publish/extract_review_slate.py   | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 13526ece66..71a1fccf53 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -213,7 +213,9 @@ class ExtractReviewSlate(openpype.api.Extractor):
             input_args.extend(["-r {}".format(input_frame_rate)])
             input_args.extend(["-frames:v 1"])
             # add timecode from source to the slate, substract one frame
+            offset_timecode = "00:00:00:00"
             if input_timecode:
+                offset_timecode = str(input_timecode)
                 offset_timecode = self._tc_offset(
                     str(input_timecode),
                     framerate=fps,
@@ -222,11 +224,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 self.log.debug("Slate Timecode: `{}`".format(
                     offset_timecode
                 ))
-                if offset_timecode:
-                    input_args.extend(["-timecode {}".format(offset_timecode)])
-                else:
-                    # fall back to input timecode if offset fails
-                    input_args.extend(["-timecode {}".format(input_timecode)])
+                input_args.extend(["-timecode {}".format(offset_timecode)])
             if use_legacy_code:
                 codec_args = repre["_profile"].get('codec', [])
                 output_args.extend(codec_args)
@@ -283,11 +281,12 @@ class ExtractReviewSlate(openpype.api.Extractor):
                     width_scale, height_scale, to_width, to_height,
                     width_half_pad, height_half_pad
                 )
-            # add output frame rate as a filter, just in case
-            scaling_arg += ",fps={}".format(input_frame_rate)
-            vf_back = self.add_video_filter_args(output_args, scaling_arg)
-            # add it to output_args
-            output_args.insert(0, vf_back)
+                # add output frame rate as a filter, just in case
+                scaling_arg += ",fps={}".format(input_frame_rate)
+
+                vf_back = self.add_video_filter_args(output_args, scaling_arg)
+                # add it to output_args
+                output_args.insert(0, vf_back)
 
             # overrides output file
             output_args.append("-y")
@@ -336,7 +335,8 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 "-f", "concat",
                 "-safe", "0",
                 "-i", conc_text_path,
-                "-c:v", "copy",
+                "-c", "copy",
+                "-timecode",  offset_timecode,
                 output_path
             ]
             if not input_audio:

From 5d8cea50461e9190ca1838fca55779235010333a Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Fri, 29 Apr 2022 13:27:14 +0200
Subject: [PATCH 0113/1227] hound

---
 openpype/plugins/publish/extract_review_slate.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 71a1fccf53..46bd4f3a7b 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -336,7 +336,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 "-safe", "0",
                 "-i", conc_text_path,
                 "-c", "copy",
-                "-timecode",  offset_timecode,
+                "-timecode", offset_timecode,
                 output_path
             ]
             if not input_audio:

From 49725781f4e8afc97f43f711dc3effb8d3ded7e0 Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Fri, 29 Apr 2022 17:43:02 +0200
Subject: [PATCH 0114/1227] Fix concatenating metadata

Slate concatenation didn't pass metadata to output
---
 .../plugins/publish/extract_review_slate.py   | 19 +++++++++++++++++--
 openpype/scripts/otio_burnin.py               |  1 +
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 46bd4f3a7b..d5741273a8 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -77,7 +77,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
             streams = get_ffprobe_streams(
                 input_path, self.log
             )
-            # get video metadata
+            # Get video metadata
             for stream in streams:
                 input_timecode = None
                 input_width = None
@@ -337,8 +337,23 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 "-i", conc_text_path,
                 "-c", "copy",
                 "-timecode", offset_timecode,
-                output_path
             ]
+            # Use arguments from ffmpeg preset
+            source_ffmpeg_cmd = repre.get("ffmpeg_cmd")
+            if source_ffmpeg_cmd:
+                copy_args = (
+                    "-metadata",
+                    "-metadata:s:v:0",
+                )
+                args = source_ffmpeg_cmd.split(" ")
+                for indx, arg in enumerate(args):
+                    if arg in copy_args:
+                        concat_args.append(arg)
+                        # assumes arg has one parameter
+                        concat_args.append(args[indx + 1])
+            # add output
+            concat_args.append(output_path)
+                    
             if not input_audio:
                 # ffmpeg concat subprocess
                 self.log.debug(
diff --git a/openpype/scripts/otio_burnin.py b/openpype/scripts/otio_burnin.py
index 1f57891b84..4c3a5de2ec 100644
--- a/openpype/scripts/otio_burnin.py
+++ b/openpype/scripts/otio_burnin.py
@@ -568,6 +568,7 @@ def burnins_from_data(
         if source_ffmpeg_cmd:
             copy_args = (
                 "-metadata",
+                "-metadata:s:v:0",
             )
             args = source_ffmpeg_cmd.split(" ")
             for idx, arg in enumerate(args):

From a80d37847dad918a0b8f401a0432a9c9f5faf1b5 Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Fri, 29 Apr 2022 17:46:34 +0200
Subject: [PATCH 0115/1227] hound

---
 openpype/plugins/publish/extract_review_slate.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index d5741273a8..59150e9d4a 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -353,7 +353,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
                         concat_args.append(args[indx + 1])
             # add output
             concat_args.append(output_path)
-                    
+
             if not input_audio:
                 # ffmpeg concat subprocess
                 self.log.debug(

From 590ece0ed898b7265e5198b82f54be1e5741cd45 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Mon, 2 May 2022 18:11:35 +0200
Subject: [PATCH 0116/1227] fix image prefix warning

---
 .../maya/plugins/publish/validate_rendersettings.py  | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_rendersettings.py b/openpype/hosts/maya/plugins/publish/validate_rendersettings.py
index 023e27de17..dc2a9c5d1c 100644
--- a/openpype/hosts/maya/plugins/publish/validate_rendersettings.py
+++ b/openpype/hosts/maya/plugins/publish/validate_rendersettings.py
@@ -92,6 +92,7 @@ class ValidateRenderSettings(pyblish.api.InstancePlugin):
     def get_invalid(cls, instance):
 
         invalid = False
+        multipart = False
 
         renderer = instance.data['renderer']
         layer = instance.data['setMembers']
@@ -111,6 +112,7 @@ class ValidateRenderSettings(pyblish.api.InstancePlugin):
             "{aov_separator}", instance.data.get("aovSeparator", "_"))
 
         required_prefix = "maya/<scene>"
+        default_prefix = cls.ImagePrefixTokens[renderer]
 
         if not anim_override:
             invalid = True
@@ -211,14 +213,20 @@ class ValidateRenderSettings(pyblish.api.InstancePlugin):
                     cls.log.error("Wrong image prefix [ {} ] - "
                                   "You can't use '<renderpass>' token "
                                   "with merge AOVs turned on".format(prefix))
+                default_prefix = re.sub(
+                    cls.R_AOV_TOKEN, "", default_prefix)
+                # remove aov token from prefix to pass validation
+                # first resolve it and then remove if dangling
+                default_prefix = default_prefix.replace(
+                    "{aov_separator}", instance.data.get("aovSeparator", "_"))
+                default_prefix = default_prefix.rstrip(
+                    instance.data.get("aovSeparator", "_"))
             elif not re.search(cls.R_AOV_TOKEN, prefix):
                 invalid = True
                 cls.log.error("Wrong image prefix [ {} ] - "
                               "doesn't have: '<renderpass>' or "
                               "token".format(prefix))
 
-        # prefix check
-        default_prefix = cls.ImagePrefixTokens[renderer]
         default_prefix = default_prefix.replace(
             "{aov_separator}", instance.data.get("aovSeparator", "_"))
         if prefix.lower() != default_prefix.lower():

From 25fd05df9ea82f4698cc03d113b3b149d9bf2536 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Tue, 3 May 2022 16:29:45 +0100
Subject: [PATCH 0117/1227] Updated plugin for UE5

---
 .../Source/OpenPype/OpenPype.Build.cs         |   2 +
 .../Source/OpenPype/Private/OpenPype.cpp      | 110 ++++++++----------
 .../OpenPype/Private/OpenPypeCommands.cpp     |  13 +++
 .../Source/OpenPype/Private/OpenPypeStyle.cpp |  53 ++++-----
 .../Source/OpenPype/Public/OpenPype.h         |   8 +-
 .../Source/OpenPype/Public/OpenPypeCommands.h |  24 ++++
 .../Source/OpenPype/Public/OpenPypeStyle.h    |  12 +-
 7 files changed, 116 insertions(+), 106 deletions(-)
 create mode 100644 openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeCommands.cpp
 create mode 100644 openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeCommands.h

diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/OpenPype.Build.cs b/openpype/hosts/unreal/integration/Source/OpenPype/OpenPype.Build.cs
index c30835b63d..fcfd268234 100644
--- a/openpype/hosts/unreal/integration/Source/OpenPype/OpenPype.Build.cs
+++ b/openpype/hosts/unreal/integration/Source/OpenPype/OpenPype.Build.cs
@@ -36,7 +36,9 @@ public class OpenPype : ModuleRules
 			{
 				"Projects",
 				"InputCore",
+				"EditorFramework",
 				"UnrealEd",
+				"ToolMenus",
 				"LevelEditor",
 				"CoreUObject",
 				"Engine",
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPype.cpp b/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPype.cpp
index 15c46b3862..b3bd9a81b3 100644
--- a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPype.cpp
+++ b/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPype.cpp
@@ -1,7 +1,10 @@
 #include "OpenPype.h"
-#include "LevelEditor.h"
-#include "OpenPypePythonBridge.h"
 #include "OpenPypeStyle.h"
+#include "OpenPypeCommands.h"
+#include "OpenPypePythonBridge.h"
+#include "LevelEditor.h"
+#include "Misc/MessageDialog.h"
+#include "ToolMenus.h"
 
 
 static const FName OpenPypeTabName("OpenPype");
@@ -11,82 +14,61 @@ static const FName OpenPypeTabName("OpenPype");
 // This function is triggered when the plugin is staring up
 void FOpenPypeModule::StartupModule()
 {
-
 	FOpenPypeStyle::Initialize();
-	FOpenPypeStyle::SetIcon("Logo", "openpype40");
+	FOpenPypeStyle::ReloadTextures();
+	FOpenPypeCommands::Register();
 
-	// Create the Extender that will add content to the menu
-	FLevelEditorModule& LevelEditorModule = FModuleManager::LoadModuleChecked<FLevelEditorModule>("LevelEditor");
-	
-	TSharedPtr<FExtender> MenuExtender = MakeShareable(new FExtender());
-	TSharedPtr<FExtender> ToolbarExtender = MakeShareable(new FExtender());
+	PluginCommands = MakeShareable(new FUICommandList);
 
-	MenuExtender->AddMenuExtension(
-		"LevelEditor",
-		EExtensionHook::After,
-		NULL,
-		FMenuExtensionDelegate::CreateRaw(this, &FOpenPypeModule::AddMenuEntry)
-	);
-	ToolbarExtender->AddToolBarExtension(
-		"Settings",
-		EExtensionHook::After,
-		NULL,
-		FToolBarExtensionDelegate::CreateRaw(this, &FOpenPypeModule::AddToobarEntry));
-
-
-	LevelEditorModule.GetMenuExtensibilityManager()->AddExtender(MenuExtender);
-	LevelEditorModule.GetToolBarExtensibilityManager()->AddExtender(ToolbarExtender);
+	PluginCommands->MapAction(
+		FOpenPypeCommands::Get().OpenPypeTools,
+		FExecuteAction::CreateRaw(this, &FOpenPypeModule::MenuPopup),
+		FCanExecuteAction());
+	PluginCommands->MapAction(
+		FOpenPypeCommands::Get().OpenPypeToolsDialog,
+		FExecuteAction::CreateRaw(this, &FOpenPypeModule::MenuDialog),
+		FCanExecuteAction());
 
+	UToolMenus::RegisterStartupCallback(FSimpleMulticastDelegate::FDelegate::CreateRaw(this, &FOpenPypeModule::RegisterMenus));
 }
 
 void FOpenPypeModule::ShutdownModule()
 {
+	UToolMenus::UnRegisterStartupCallback(this);
+
+	UToolMenus::UnregisterOwner(this);
+
 	FOpenPypeStyle::Shutdown();
+
+	FOpenPypeCommands::Unregister();
 }
 
-
-void FOpenPypeModule::AddMenuEntry(FMenuBuilder& MenuBuilder)
+void FOpenPypeModule::RegisterMenus()
 {
-	// Create Section
-	MenuBuilder.BeginSection("OpenPype", TAttribute<FText>(FText::FromString("OpenPype")));
+	// Owner will be used for cleanup in call to UToolMenus::UnregisterOwner
+	FToolMenuOwnerScoped OwnerScoped(this);
+
 	{
-		// Create a Submenu inside of the Section
-		MenuBuilder.AddMenuEntry(
-			FText::FromString("Tools..."),
-			FText::FromString("Pipeline tools"),
-			FSlateIcon(FOpenPypeStyle::GetStyleSetName(), "OpenPype.Logo"),
-			FUIAction(FExecuteAction::CreateRaw(this, &FOpenPypeModule::MenuPopup))
-		);
-
-		MenuBuilder.AddMenuEntry(
-			FText::FromString("Tools dialog..."),
-			FText::FromString("Pipeline tools dialog"),
-			FSlateIcon(FOpenPypeStyle::GetStyleSetName(), "OpenPype.Logo"),
-			FUIAction(FExecuteAction::CreateRaw(this, &FOpenPypeModule::MenuDialog))
-		);
-
+		UToolMenu* Menu = UToolMenus::Get()->ExtendMenu("LevelEditor.MainMenu.Tools");
+		{
+			// FToolMenuSection& Section = Menu->FindOrAddSection("OpenPype");
+			FToolMenuSection& Section = Menu->AddSection(
+				"OpenPype",
+				TAttribute<FText>(FText::FromString("OpenPype")),
+				FToolMenuInsert("Programming", EToolMenuInsertType::Before)
+			);
+			Section.AddMenuEntryWithCommandList(FOpenPypeCommands::Get().OpenPypeTools, PluginCommands);
+			Section.AddMenuEntryWithCommandList(FOpenPypeCommands::Get().OpenPypeToolsDialog, PluginCommands);
+		}
+		UToolMenu* ToolbarMenu = UToolMenus::Get()->ExtendMenu("LevelEditor.LevelEditorToolBar.PlayToolBar");
+		{
+			FToolMenuSection& Section = ToolbarMenu->FindOrAddSection("PluginTools");
+			{
+				FToolMenuEntry& Entry = Section.AddEntry(FToolMenuEntry::InitToolBarButton(FOpenPypeCommands::Get().OpenPypeTools));
+				Entry.SetCommandList(PluginCommands);
+			}
+		}
 	}
-	MenuBuilder.EndSection();
-}
-
-void FOpenPypeModule::AddToobarEntry(FToolBarBuilder& ToolbarBuilder)
-{
-	ToolbarBuilder.BeginSection(TEXT("OpenPype"));
-	{
-		ToolbarBuilder.AddToolBarButton(
-			FUIAction(
-				FExecuteAction::CreateRaw(this, &FOpenPypeModule::MenuPopup),
-				NULL,
-				FIsActionChecked()
-
-			),
-			NAME_None,
-			LOCTEXT("OpenPype_label", "OpenPype"),
-			LOCTEXT("OpenPype_tooltip", "OpenPype Tools"),
-			FSlateIcon(FOpenPypeStyle::GetStyleSetName(), "OpenPype.Logo")
-		);
-	}
-	ToolbarBuilder.EndSection();
 }
 
 
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeCommands.cpp b/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeCommands.cpp
new file mode 100644
index 0000000000..6187bd7c7e
--- /dev/null
+++ b/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeCommands.cpp
@@ -0,0 +1,13 @@
+// Copyright Epic Games, Inc. All Rights Reserved.
+
+#include "OpenPypeCommands.h"
+
+#define LOCTEXT_NAMESPACE "FOpenPypeModule"
+
+void FOpenPypeCommands::RegisterCommands()
+{
+	UI_COMMAND(OpenPypeTools, "OpenPype Tools", "Pipeline tools", EUserInterfaceActionType::Button, FInputChord());
+	UI_COMMAND(OpenPypeToolsDialog, "OpenPype Tools Dialog", "Pipeline tools dialog", EUserInterfaceActionType::Button, FInputChord());
+}
+
+#undef LOCTEXT_NAMESPACE
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeStyle.cpp b/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeStyle.cpp
index a51c2d6aa5..4a53af26b5 100644
--- a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeStyle.cpp
+++ b/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeStyle.cpp
@@ -1,10 +1,14 @@
+#include "OpenPype.h"
 #include "OpenPypeStyle.h"
 #include "Framework/Application/SlateApplication.h"
-#include "Styling/SlateStyle.h"
 #include "Styling/SlateStyleRegistry.h"
+#include "Slate/SlateGameResources.h"
+#include "Interfaces/IPluginManager.h"
+#include "Styling/SlateStyleMacros.h"
 
+#define RootToContentDir Style->RootToContentDir
 
-TUniquePtr< FSlateStyleSet > FOpenPypeStyle::OpenPypeStyleInstance = nullptr;
+TSharedPtr<FSlateStyleSet> FOpenPypeStyle::OpenPypeStyleInstance = nullptr;
 
 void FOpenPypeStyle::Initialize()
 {
@@ -17,11 +21,9 @@ void FOpenPypeStyle::Initialize()
 
 void FOpenPypeStyle::Shutdown()
 {
-	if (OpenPypeStyleInstance.IsValid())
-	{
-		FSlateStyleRegistry::UnRegisterSlateStyle(*OpenPypeStyleInstance);
-		OpenPypeStyleInstance.Reset();
-	}
+	FSlateStyleRegistry::UnRegisterSlateStyle(*OpenPypeStyleInstance);
+	ensure(OpenPypeStyleInstance.IsUnique());
+	OpenPypeStyleInstance.Reset();
 }
 
 FName FOpenPypeStyle::GetStyleSetName()
@@ -30,41 +32,30 @@ FName FOpenPypeStyle::GetStyleSetName()
 	return StyleSetName;
 }
 
-FName FOpenPypeStyle::GetContextName()
-{
-	static FName ContextName(TEXT("OpenPype"));
-	return ContextName;
-}
-
-#define IMAGE_BRUSH(RelativePath, ...) FSlateImageBrush( Style->RootToContentDir( RelativePath, TEXT(".png") ), __VA_ARGS__ )
-
+const FVector2D Icon16x16(16.0f, 16.0f);
+const FVector2D Icon20x20(20.0f, 20.0f);
 const FVector2D Icon40x40(40.0f, 40.0f);
 
-TUniquePtr< FSlateStyleSet > FOpenPypeStyle::Create()
+TSharedRef< FSlateStyleSet > FOpenPypeStyle::Create()
 {
-	TUniquePtr< FSlateStyleSet > Style = MakeUnique<FSlateStyleSet>(GetStyleSetName());
-	Style->SetContentRoot(FPaths::ProjectPluginsDir() / TEXT("OpenPype/Resources"));
+	TSharedRef< FSlateStyleSet > Style = MakeShareable(new FSlateStyleSet("OpenPypeStyle"));
+	Style->SetContentRoot(IPluginManager::Get().FindPlugin("OpenPype")->GetBaseDir() / TEXT("Resources"));
+
+	Style->Set("OpenPype.OpenPypeTools", new IMAGE_BRUSH(TEXT("openpype40"), Icon40x40));
+	Style->Set("OpenPype.OpenPypeToolsDialog", new IMAGE_BRUSH(TEXT("openpype40"), Icon40x40));
 
 	return Style;
 }
 
-void FOpenPypeStyle::SetIcon(const FString& StyleName, const FString& ResourcePath)
+void FOpenPypeStyle::ReloadTextures()
 {
-	FSlateStyleSet* Style = OpenPypeStyleInstance.Get();
-
-	FString Name(GetContextName().ToString());
-	Name = Name + "." + StyleName;
-	Style->Set(*Name, new FSlateImageBrush(Style->RootToContentDir(ResourcePath, TEXT(".png")), Icon40x40));
-
-
-	FSlateApplication::Get().GetRenderer()->ReloadTextureResources();
+	if (FSlateApplication::IsInitialized())
+	{
+		FSlateApplication::Get().GetRenderer()->ReloadTextureResources();
+	}
 }
 
-#undef IMAGE_BRUSH
-
 const ISlateStyle& FOpenPypeStyle::Get()
 {
-	check(OpenPypeStyleInstance);
-	return *OpenPypeStyleInstance;
 	return *OpenPypeStyleInstance;
 }
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPype.h b/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPype.h
index db3f299354..3ee5eaa65f 100644
--- a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPype.h
+++ b/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPype.h
@@ -2,7 +2,8 @@
 
 #pragma once
 
-#include "Engine.h"
+#include "CoreMinimal.h"
+#include "Modules/ModuleManager.h"
 
 
 class FOpenPypeModule : public IModuleInterface
@@ -12,10 +13,11 @@ public:
 	virtual void ShutdownModule() override;
 
 private:
+	void RegisterMenus();
 
-	void AddMenuEntry(FMenuBuilder& MenuBuilder);
-	void AddToobarEntry(FToolBarBuilder& ToolbarBuilder);
 	void MenuPopup();
 	void MenuDialog();
 
+private:
+	TSharedPtr<class FUICommandList> PluginCommands;
 };
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeCommands.h b/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeCommands.h
new file mode 100644
index 0000000000..62ffb8de33
--- /dev/null
+++ b/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeCommands.h
@@ -0,0 +1,24 @@
+// Copyright Epic Games, Inc. All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "Framework/Commands/Commands.h"
+#include "OpenPypeStyle.h"
+
+class FOpenPypeCommands : public TCommands<FOpenPypeCommands>
+{
+public:
+
+	FOpenPypeCommands()
+		: TCommands<FOpenPypeCommands>(TEXT("OpenPype"), NSLOCTEXT("Contexts", "OpenPype", "OpenPype Tools"), NAME_None, FOpenPypeStyle::GetStyleSetName())
+	{
+	}
+
+	// TCommands<> interface
+	virtual void RegisterCommands() override;
+
+public:
+	TSharedPtr< FUICommandInfo > OpenPypeTools;
+	TSharedPtr< FUICommandInfo > OpenPypeToolsDialog;
+};
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeStyle.h b/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeStyle.h
index fbc8bcdd5b..ae704251e1 100644
--- a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeStyle.h
+++ b/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeStyle.h
@@ -1,22 +1,18 @@
 #pragma once
 #include "CoreMinimal.h"
-
-class FSlateStyleSet;
-class ISlateStyle;
-
+#include "Styling/SlateStyle.h"
 
 class FOpenPypeStyle
 {
 public:
 	static void Initialize();
 	static void Shutdown();
+	static void ReloadTextures();
 	static const ISlateStyle& Get();
 	static FName GetStyleSetName();
-	static FName GetContextName();
 
-	static void SetIcon(const FString& StyleName, const FString& ResourcePath);
 
 private:
-	static TUniquePtr< FSlateStyleSet > Create();
-	static TUniquePtr< FSlateStyleSet > OpenPypeStyleInstance;
+	static TSharedRef< class FSlateStyleSet > Create();
+	static TSharedPtr< class FSlateStyleSet > OpenPypeStyleInstance;
 };
\ No newline at end of file

From e2076c0f2fa264f4dc7ae6959c3292b60616ca91 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 3 Feb 2022 19:03:16 +0100
Subject: [PATCH 0118/1227] Module: Kitsu module

---
 .../modules/default_modules/kitsu/__init__.py |  15 ++
 .../default_modules/kitsu/kitsu_module.py     | 147 ++++++++++++++++++
 .../kitsu/plugins/publish/example_plugin.py   |   9 ++
 .../schemas/project_schemas/main.json         |  30 ++++
 .../schemas/project_schemas/the_template.json |  30 ++++
 .../modules/default_modules/kitsu/widgets.py  |  31 ++++
 .../defaults/project_settings/kitsu.json      |   3 +
 .../defaults/system_settings/modules.json     |   4 +
 .../schemas/projects_schema/schema_main.json  |   4 +
 .../projects_schema/schema_project_kitsu.json |  17 ++
 .../module_settings/schema_kitsu.json         |  23 +++
 .../schemas/system_schema/schema_modules.json |   4 +
 12 files changed, 317 insertions(+)
 create mode 100644 openpype/modules/default_modules/kitsu/__init__.py
 create mode 100644 openpype/modules/default_modules/kitsu/kitsu_module.py
 create mode 100644 openpype/modules/default_modules/kitsu/plugins/publish/example_plugin.py
 create mode 100644 openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/main.json
 create mode 100644 openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/the_template.json
 create mode 100644 openpype/modules/default_modules/kitsu/widgets.py
 create mode 100644 openpype/settings/defaults/project_settings/kitsu.json
 create mode 100644 openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
 create mode 100644 openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json

diff --git a/openpype/modules/default_modules/kitsu/__init__.py b/openpype/modules/default_modules/kitsu/__init__.py
new file mode 100644
index 0000000000..cd0c2ea8af
--- /dev/null
+++ b/openpype/modules/default_modules/kitsu/__init__.py
@@ -0,0 +1,15 @@
+""" Addon class definition and Settings definition must be imported here.
+
+If addon class or settings definition won't be here their definition won't
+be found by OpenPype discovery.
+"""
+
+from .kitsu_module import (
+    AddonSettingsDef,
+    KitsuModule
+)
+
+__all__ = (
+    "AddonSettingsDef",
+    "KitsuModule"
+)
diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
new file mode 100644
index 0000000000..81d7e56a81
--- /dev/null
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -0,0 +1,147 @@
+"""Addon definition is located here.
+
+Import of python packages that may not be available should not be imported
+in global space here until are required or used.
+- Qt related imports
+- imports of Python 3 packages
+    - we still support Python 2 hosts where addon definition should available
+"""
+
+import os
+import click
+
+from openpype.modules import (
+    JsonFilesSettingsDef,
+    OpenPypeModule,
+    ModulesManager
+)
+# Import interface defined by this addon to be able find other addons using it
+from openpype_interfaces import (
+    IPluginPaths,
+    ITrayAction
+)
+
+
+# Settings definition of this addon using `JsonFilesSettingsDef`
+# - JsonFilesSettingsDef is prepared settings definition using json files
+#   to define settings and store default values
+class AddonSettingsDef(JsonFilesSettingsDef):
+    # This will add prefixes to every schema and template from `schemas`
+    #   subfolder.
+    # - it is not required to fill the prefix but it is highly
+    #   recommended as schemas and templates may have name clashes across
+    #   multiple addons
+    # - it is also recommended that prefix has addon name in it
+    schema_prefix = "kitsu"
+
+    def get_settings_root_path(self):
+        """Implemented abstract class of JsonFilesSettingsDef.
+
+        Return directory path where json files defying addon settings are
+        located.
+        """
+        return os.path.join(
+            os.path.dirname(os.path.abspath(__file__)),
+            "settings"
+        )
+
+
+class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
+    """This Addon has defined it's settings and interface.
+
+    This example has system settings with an enabled option. And use
+    few other interfaces:
+    - `IPluginPaths` to define custom plugin paths
+    - `ITrayAction` to be shown in tray tool
+    """
+    label = "Kitsu"
+    name = "kitsu"
+
+    def initialize(self, settings):
+        """Initialization of addon."""
+        module_settings = settings[self.name]
+        # Enabled by settings
+        self.enabled = module_settings.get("enabled", False)
+
+        # Prepare variables that can be used or set afterwards
+        self._connected_modules = None
+        # UI which must not be created at this time
+        self._dialog = None
+
+    def tray_init(self):
+        """Implementation of abstract method for `ITrayAction`.
+
+        We're definitely  in tray tool so we can pre create dialog.
+        """
+
+        self._create_dialog()
+
+    def _create_dialog(self):
+        # Don't recreate dialog if already exists
+        if self._dialog is not None:
+            return
+
+        from .widgets import MyExampleDialog
+
+        self._dialog = MyExampleDialog()
+
+    def show_dialog(self):
+        """Show dialog with connected modules.
+
+        This can be called from anywhere but can also crash in headless mode.
+        There is no way to prevent addon to do invalid operations if he's
+        not handling them.
+        """
+        # Make sure dialog is created
+        self._create_dialog()
+        # Show dialog
+        self._dialog.open()
+
+    def get_connected_modules(self):
+        """Custom implementation of addon."""
+        names = set()
+        if self._connected_modules is not None:
+            for module in self._connected_modules:
+                names.add(module.name)
+        return names
+
+    def on_action_trigger(self):
+        """Implementation of abstract method for `ITrayAction`."""
+        self.show_dialog()
+
+    def get_plugin_paths(self):
+        """Implementation of abstract method for `IPluginPaths`."""
+        current_dir = os.path.dirname(os.path.abspath(__file__))
+
+        return {
+            "publish": [os.path.join(current_dir, "plugins", "publish")]
+        }
+
+    def cli(self, click_group):
+        click_group.add_command(cli_main)
+
+
+@click.group(KitsuModule.name, help="Kitsu dynamic cli commands.")
+def cli_main():
+    pass
+
+
+@cli_main.command()
+def nothing():
+    """Does nothing but print a message."""
+    print("You've triggered \"nothing\" command.")
+
+
+@cli_main.command()
+def show_dialog():
+    """Show ExampleAddon dialog.
+
+    We don't have access to addon directly through cli so we have to create
+    it again.
+    """
+    from openpype.tools.utils.lib import qt_app_context
+
+    manager = ModulesManager()
+    example_addon = manager.modules_by_name[KitsuModule.name]
+    with qt_app_context():
+        example_addon.show_dialog()
diff --git a/openpype/modules/default_modules/kitsu/plugins/publish/example_plugin.py b/openpype/modules/default_modules/kitsu/plugins/publish/example_plugin.py
new file mode 100644
index 0000000000..61602f4e78
--- /dev/null
+++ b/openpype/modules/default_modules/kitsu/plugins/publish/example_plugin.py
@@ -0,0 +1,9 @@
+import pyblish.api
+
+
+class CollectExampleAddon(pyblish.api.ContextPlugin):
+    order = pyblish.api.CollectorOrder + 0.4
+    label = "Collect Kitsu"
+
+    def process(self, context):
+        self.log.info("I'm in Kitsu's plugin!")
diff --git a/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/main.json b/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/main.json
new file mode 100644
index 0000000000..82e58ce9ab
--- /dev/null
+++ b/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/main.json
@@ -0,0 +1,30 @@
+{
+    "type": "dict",
+    "key": "kitsu",
+    "label": " Kitsu",
+    "collapsible": true,
+    "children": [
+        {
+            "type": "number",
+            "key": "number",
+            "label": "This is your lucky number:",
+            "minimum": 7,
+            "maximum": 7,
+            "decimals": 0
+        },
+        {
+            "type": "template",
+            "name": "kitsu/the_template",
+            "template_data": [
+                {
+                    "name": "color_1",
+                    "label": "Color 1"
+                },
+                {
+                    "name": "color_2",
+                    "label": "Color 2"
+                }
+            ]
+        }
+    ]
+}
diff --git a/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/the_template.json b/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/the_template.json
new file mode 100644
index 0000000000..af8fd9dae4
--- /dev/null
+++ b/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/the_template.json
@@ -0,0 +1,30 @@
+[
+    {
+        "type": "list-strict",
+        "key": "{name}",
+        "label": "{label}",
+        "object_types": [
+            {
+                "label": "Red",
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1,
+                "decimal": 3
+            },
+            {
+                "label": "Green",
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1,
+                "decimal": 3
+            },
+            {
+                "label": "Blue",
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1,
+                "decimal": 3
+            }
+        ]
+    }
+]
diff --git a/openpype/modules/default_modules/kitsu/widgets.py b/openpype/modules/default_modules/kitsu/widgets.py
new file mode 100644
index 0000000000..de232113fe
--- /dev/null
+++ b/openpype/modules/default_modules/kitsu/widgets.py
@@ -0,0 +1,31 @@
+from Qt import QtWidgets
+
+from openpype.style import load_stylesheet
+
+
+class MyExampleDialog(QtWidgets.QDialog):
+    def __init__(self, parent=None):
+        super(MyExampleDialog, self).__init__(parent)
+
+        self.setWindowTitle("Connected modules")
+
+        msg = "This is example dialog of Kitsu."
+        label_widget = QtWidgets.QLabel(msg, self)
+
+        ok_btn = QtWidgets.QPushButton("OK", self)
+        btns_layout = QtWidgets.QHBoxLayout()
+        btns_layout.addStretch(1)
+        btns_layout.addWidget(ok_btn)
+
+        layout = QtWidgets.QVBoxLayout(self)
+        layout.addWidget(label_widget)
+        layout.addLayout(btns_layout)
+
+        ok_btn.clicked.connect(self._on_ok_clicked)
+
+        self._label_widget = label_widget
+
+        self.setStyleSheet(load_stylesheet())
+
+    def _on_ok_clicked(self):
+        self.done(1)
diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
new file mode 100644
index 0000000000..b4d2ccc611
--- /dev/null
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -0,0 +1,3 @@
+{
+    "number": 0
+}
\ No newline at end of file
diff --git a/openpype/settings/defaults/system_settings/modules.json b/openpype/settings/defaults/system_settings/modules.json
index d74269922f..9cfaddecbe 100644
--- a/openpype/settings/defaults/system_settings/modules.json
+++ b/openpype/settings/defaults/system_settings/modules.json
@@ -137,6 +137,10 @@
             }
         }
     },
+    "kitsu": {
+        "enabled": false,
+        "kitsu_server": ""
+    },
     "timers_manager": {
         "enabled": true,
         "auto_stop": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_main.json b/openpype/settings/entities/schemas/projects_schema/schema_main.json
index dbddd18c80..6c07209de3 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_main.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_main.json
@@ -62,6 +62,10 @@
                     "type": "schema",
                     "name": "schema_project_ftrack"
                 },
+                {
+                    "type": "schema",
+                    "name": "schema_project_kitsu"
+                },
                 {
                     "type": "schema",
                     "name": "schema_project_deadline"
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
new file mode 100644
index 0000000000..93976cc03b
--- /dev/null
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -0,0 +1,17 @@
+{
+    "type": "dict",
+    "key": "kitsu",
+    "label": "Kitsu",
+    "collapsible": true,
+    "is_file": true,
+    "children": [
+        {
+            "type": "number",
+            "key": "number",
+            "label": "This is your lucky number:",
+            "minimum": 7,
+            "maximum": 7,
+            "decimals": 0
+        }
+    ]
+}
diff --git a/openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json b/openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json
new file mode 100644
index 0000000000..8e496dc783
--- /dev/null
+++ b/openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json
@@ -0,0 +1,23 @@
+{
+    "type": "dict",
+    "key": "kitsu",
+    "label": "Kitsu",
+    "collapsible": true,
+    "require_restart": true,
+    "checkbox_key": "enabled",
+    "children": [
+        {
+            "type": "boolean",
+            "key": "enabled",
+            "label": "Enabled"
+        },
+        {
+            "type": "text",
+            "key": "kitsu_server",
+            "label": "Server"
+        },
+        {
+            "type": "splitter"
+        }
+    ]
+}
diff --git a/openpype/settings/entities/schemas/system_schema/schema_modules.json b/openpype/settings/entities/schemas/system_schema/schema_modules.json
index 52595914ed..d22b9016a7 100644
--- a/openpype/settings/entities/schemas/system_schema/schema_modules.json
+++ b/openpype/settings/entities/schemas/system_schema/schema_modules.json
@@ -44,6 +44,10 @@
             "type": "schema",
             "name": "schema_ftrack"
         },
+        {
+            "type": "schema",
+            "name": "schema_kitsu"
+        },
         {
             "type": "dict",
             "key": "timers_manager",

From 70440290cafcf02753f8c499951cc164b011c132 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 8 Feb 2022 15:38:02 +0100
Subject: [PATCH 0119/1227] Fist step to sync from Zou to local

---
 .../default_modules/kitsu/kitsu_module.py     | 125 +++++++++++++++++-
 .../defaults/system_settings/modules.json     |   4 +-
 .../module_settings/schema_kitsu.json         |  12 +-
 3 files changed, 135 insertions(+), 6 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 81d7e56a81..55e4640fa2 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -6,20 +6,27 @@ in global space here until are required or used.
 - imports of Python 3 packages
     - we still support Python 2 hosts where addon definition should available
 """
-
+import collections
 import os
 import click
 
+from avalon.api import AvalonMongoDB
+import gazu
+from openpype.api import get_project_basic_paths, create_project_folders
+from openpype.lib import create_project
+from openpype.lib.anatomy import Anatomy
 from openpype.modules import (
     JsonFilesSettingsDef,
     OpenPypeModule,
     ModulesManager
 )
+from openpype.tools.project_manager.project_manager.model import AssetItem, ProjectItem, TaskItem
 # Import interface defined by this addon to be able find other addons using it
 from openpype_interfaces import (
     IPluginPaths,
     ITrayAction
 )
+from pymongo import UpdateOne, DeleteOne
 
 
 # Settings definition of this addon using `JsonFilesSettingsDef`
@@ -60,9 +67,27 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
     def initialize(self, settings):
         """Initialization of addon."""
         module_settings = settings[self.name]
+
         # Enabled by settings
         self.enabled = module_settings.get("enabled", False)
 
+        # Add API URL schema
+        kitsu_url = module_settings["server"].strip()
+        if kitsu_url:
+            # Ensure web url
+            if not kitsu_url.startswith("http"):
+                kitsu_url = "https://" + kitsu_url
+
+            # Check for "/api" url validity
+            if not kitsu_url.endswith("api"):
+                kitsu_url = f"{kitsu_url}{'' if kitsu_url.endswith('/') else '/'}api"
+
+        self.server_url = kitsu_url
+
+        # Set credentials
+        self.script_login = module_settings["script_login"]
+        self.script_pwd = module_settings["script_pwd"]
+
         # Prepare variables that can be used or set afterwards
         self._connected_modules = None
         # UI which must not be created at this time
@@ -76,6 +101,14 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
 
         self._create_dialog()
 
+    def get_global_environments(self):
+        """Kitsu's global environments."""
+        return {
+            "KITSU_SERVER": self.server_url,
+            "KITSU_LOGIN": self.script_login,
+            "KITSU_PWD": self.script_pwd
+        }
+
     def _create_dialog(self):
         # Don't recreate dialog if already exists
         if self._dialog is not None:
@@ -127,10 +160,94 @@ def cli_main():
 
 
 @cli_main.command()
-def nothing():
-    """Does nothing but print a message."""
-    print("You've triggered \"nothing\" command.")
+def sync_local():
+    """Synchronize local database from Zou sever database."""
 
+    # Connect to server
+    gazu.client.set_host(os.environ["KITSU_SERVER"])
+
+    # Authenticate
+    gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
+
+    # Iterate projects
+    dbcon = AvalonMongoDB()
+    dbcon.install()
+    all_projects = gazu.project.all_projects()
+    for project in all_projects:
+        # Create project locally
+        # Try to find project document
+        project_name = project["name"]
+        project_code = project_name
+        dbcon.Session["AVALON_PROJECT"] = project_name
+        project_doc = dbcon.find_one({
+            "type": "project"
+        })
+        
+        # Get all assets from zou
+        all_assets = gazu.asset.all_assets_for_project(project)
+
+        # Query all assets of the local project
+        project_col = dbcon.database[project_code]
+        asset_docs_zou_ids = {
+            asset_doc["data"]["zou_id"]
+            for asset_doc in project_col.find({"type": "asset"})
+        }
+
+        # Create project if is not available
+        # - creation is required to be able set project anatomy and attributes
+        if not project_doc:
+            print(f"Creating project '{project_name}'")
+            project_doc = create_project(project_name, project_code, dbcon=dbcon)
+
+        # Create project item
+        insert_list = []
+
+        bulk_writes = []
+        for zou_asset in all_assets:
+            doc_data = {"zou_id": zou_asset["id"]}
+
+            # Create Asset
+            new_doc = {
+                "name": zou_asset["name"],
+                "type": "asset",
+                "schema": "openpype:asset-3.0",
+                "data": doc_data,
+                "parent": project_doc["_id"]
+            }
+
+            if zou_asset["id"] not in asset_docs_zou_ids:  # Item is new
+                insert_list.append(new_doc)
+
+            # TODO tasks
+
+            # elif item.data(REMOVED_ROLE): # TODO removal
+            #     if item.data(HIERARCHY_CHANGE_ABLE_ROLE):
+            #         bulk_writes.append(DeleteOne(
+            #             {"_id": item.asset_id}
+            #         ))
+            #     else:
+            #         bulk_writes.append(UpdateOne(
+            #             {"_id": item.asset_id},
+            #             {"$set": {"type": "archived_asset"}}
+            #         ))
+
+            # else: TODO update data
+            #     update_data = new_item.update_data()
+            #     if update_data:
+            #         bulk_writes.append(UpdateOne(
+            #             {"_id": new_item.asset_id},
+            #             update_data
+            #         ))
+
+        # Insert new docs if created
+        if insert_list:
+            project_col.insert_many(insert_list)
+
+        # Write into DB TODO
+        # if bulk_writes:
+        #     project_col.bulk_write(bulk_writes)
+
+    dbcon.uninstall()
 
 @cli_main.command()
 def show_dialog():
diff --git a/openpype/settings/defaults/system_settings/modules.json b/openpype/settings/defaults/system_settings/modules.json
index 9cfaddecbe..ddb2edc360 100644
--- a/openpype/settings/defaults/system_settings/modules.json
+++ b/openpype/settings/defaults/system_settings/modules.json
@@ -139,7 +139,9 @@
     },
     "kitsu": {
         "enabled": false,
-        "kitsu_server": ""
+        "server": "",
+        "script_login": "",
+        "script_pwd": ""
     },
     "timers_manager": {
         "enabled": true,
diff --git a/openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json b/openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json
index 8e496dc783..ae2b52df0d 100644
--- a/openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json
+++ b/openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json
@@ -13,9 +13,19 @@
         },
         {
             "type": "text",
-            "key": "kitsu_server",
+            "key": "server",
             "label": "Server"
         },
+        {
+            "type": "text",
+            "key": "script_login",
+            "label": "Script Login"
+        },
+        {
+            "type": "text",
+            "key": "script_pwd",
+            "label": "Script Password"
+        },
         {
             "type": "splitter"
         }

From 719afdcc8ae5f8710537d55da24040bd7ccfcd95 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 8 Feb 2022 15:41:02 +0100
Subject: [PATCH 0120/1227] black

---
 .../default_modules/kitsu/kitsu_module.py     | 37 ++++++-------------
 1 file changed, 11 insertions(+), 26 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 55e4640fa2..6eb37dfaed 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -6,27 +6,17 @@ in global space here until are required or used.
 - imports of Python 3 packages
     - we still support Python 2 hosts where addon definition should available
 """
-import collections
 import os
 import click
 
 from avalon.api import AvalonMongoDB
 import gazu
-from openpype.api import get_project_basic_paths, create_project_folders
 from openpype.lib import create_project
 from openpype.lib.anatomy import Anatomy
-from openpype.modules import (
-    JsonFilesSettingsDef,
-    OpenPypeModule,
-    ModulesManager
-)
-from openpype.tools.project_manager.project_manager.model import AssetItem, ProjectItem, TaskItem
+from openpype.modules import JsonFilesSettingsDef, OpenPypeModule, ModulesManager
+
 # Import interface defined by this addon to be able find other addons using it
-from openpype_interfaces import (
-    IPluginPaths,
-    ITrayAction
-)
-from pymongo import UpdateOne, DeleteOne
+from openpype_interfaces import IPluginPaths, ITrayAction
 
 
 # Settings definition of this addon using `JsonFilesSettingsDef`
@@ -47,10 +37,7 @@ class AddonSettingsDef(JsonFilesSettingsDef):
         Return directory path where json files defying addon settings are
         located.
         """
-        return os.path.join(
-            os.path.dirname(os.path.abspath(__file__)),
-            "settings"
-        )
+        return os.path.join(os.path.dirname(os.path.abspath(__file__)), "settings")
 
 
 class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
@@ -61,6 +48,7 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
     - `IPluginPaths` to define custom plugin paths
     - `ITrayAction` to be shown in tray tool
     """
+
     label = "Kitsu"
     name = "kitsu"
 
@@ -106,7 +94,7 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
         return {
             "KITSU_SERVER": self.server_url,
             "KITSU_LOGIN": self.script_login,
-            "KITSU_PWD": self.script_pwd
+            "KITSU_PWD": self.script_pwd,
         }
 
     def _create_dialog(self):
@@ -146,9 +134,7 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
         """Implementation of abstract method for `IPluginPaths`."""
         current_dir = os.path.dirname(os.path.abspath(__file__))
 
-        return {
-            "publish": [os.path.join(current_dir, "plugins", "publish")]
-        }
+        return {"publish": [os.path.join(current_dir, "plugins", "publish")]}
 
     def cli(self, click_group):
         click_group.add_command(cli_main)
@@ -179,10 +165,8 @@ def sync_local():
         project_name = project["name"]
         project_code = project_name
         dbcon.Session["AVALON_PROJECT"] = project_name
-        project_doc = dbcon.find_one({
-            "type": "project"
-        })
-        
+        project_doc = dbcon.find_one({"type": "project"})
+
         # Get all assets from zou
         all_assets = gazu.asset.all_assets_for_project(project)
 
@@ -212,7 +196,7 @@ def sync_local():
                 "type": "asset",
                 "schema": "openpype:asset-3.0",
                 "data": doc_data,
-                "parent": project_doc["_id"]
+                "parent": project_doc["_id"],
             }
 
             if zou_asset["id"] not in asset_docs_zou_ids:  # Item is new
@@ -249,6 +233,7 @@ def sync_local():
 
     dbcon.uninstall()
 
+
 @cli_main.command()
 def show_dialog():
     """Show ExampleAddon dialog.

From 7c63d3a374637ee8630d293b8ac8dcc8a34ffb95 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 8 Feb 2022 16:28:06 +0100
Subject: [PATCH 0121/1227] Add tasks to asset

---
 .../default_modules/kitsu/kitsu_module.py     | 37 +++++++++++++++----
 1 file changed, 29 insertions(+), 8 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 6eb37dfaed..9730437ec2 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -187,22 +187,43 @@ def sync_local():
         insert_list = []
 
         bulk_writes = []
-        for zou_asset in all_assets:
-            doc_data = {"zou_id": zou_asset["id"]}
+        for asset in all_assets:
+            asset_data = {"zou_id": asset["id"]}
+
+            # Set tasks
+            asset_tasks = gazu.task.all_tasks_for_asset(asset)
+            asset_data["tasks"] = {
+                t["task_type_name"]: {"type": t["task_type_name"]} for t in asset_tasks
+            }
 
             # Create Asset
-            new_doc = {
-                "name": zou_asset["name"],
+            asset_doc = {
+                "name": asset["name"],
                 "type": "asset",
                 "schema": "openpype:asset-3.0",
-                "data": doc_data,
+                "data": asset_data,
                 "parent": project_doc["_id"],
             }
 
-            if zou_asset["id"] not in asset_docs_zou_ids:  # Item is new
-                insert_list.append(new_doc)
+            if asset["id"] not in asset_docs_zou_ids:  # Item is new
+                insert_list.append(asset_doc)
+            else:
+                asset_doc = project_col.find_one({"data": {"zou_id": asset["id"]}})
 
-            # TODO tasks
+                # TODO update
+            # for task in asset_tasks:
+            #     # print(task)
+            #     task_data = {"zou_id": task["id"]}
+
+            #     # Create Task
+            #     task_doc = {
+            #         "name": task["name"],
+            #         "type": "task",
+            #         "schema": "openpype:asset-3.0",
+            #         "data": task_data,
+            #         "parent": asset_doc["_id"],
+            #     }
+            #     insert_list.append(task_doc)
 
             # elif item.data(REMOVED_ROLE): # TODO removal
             #     if item.data(HIERARCHY_CHANGE_ABLE_ROLE):

From 9a1dd4fc0630f94cff1ef554fd31ede714b8ad49 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 8 Feb 2022 19:26:26 +0100
Subject: [PATCH 0122/1227] All bulk write. Updating assets

---
 .../default_modules/kitsu/kitsu_module.py     | 68 ++++++++-----------
 1 file changed, 29 insertions(+), 39 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 9730437ec2..1a71a05a7e 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -12,10 +12,8 @@ import click
 from avalon.api import AvalonMongoDB
 import gazu
 from openpype.lib import create_project
-from openpype.lib.anatomy import Anatomy
 from openpype.modules import JsonFilesSettingsDef, OpenPypeModule, ModulesManager
-
-# Import interface defined by this addon to be able find other addons using it
+from pymongo import DeleteOne, InsertOne, UpdateOne
 from openpype_interfaces import IPluginPaths, ITrayAction
 
 
@@ -183,9 +181,6 @@ def sync_local():
             print(f"Creating project '{project_name}'")
             project_doc = create_project(project_name, project_code, dbcon=dbcon)
 
-        # Create project item
-        insert_list = []
-
         bulk_writes = []
         for asset in all_assets:
             asset_data = {"zou_id": asset["id"]}
@@ -196,34 +191,33 @@ def sync_local():
                 t["task_type_name"]: {"type": t["task_type_name"]} for t in asset_tasks
             }
 
-            # Create Asset
-            asset_doc = {
-                "name": asset["name"],
-                "type": "asset",
-                "schema": "openpype:asset-3.0",
-                "data": asset_data,
-                "parent": project_doc["_id"],
-            }
+            # Update or create asset
+            if asset["id"] in asset_docs_zou_ids:  # Update asset
+                asset_doc = project_col.find_one({"data.zou_id": asset["id"]})
 
-            if asset["id"] not in asset_docs_zou_ids:  # Item is new
-                insert_list.append(asset_doc)
-            else:
-                asset_doc = project_col.find_one({"data": {"zou_id": asset["id"]}})
+                # Override all 'data' TODO filter data to update?
+                diff_data = {
+                    k: asset_data[k]
+                    for k in asset_data.keys()
+                    if asset_doc["data"].get(k) != asset_data[k]
+                }
+                if diff_data:
+                    bulk_writes.append(
+                        UpdateOne(
+                            {"_id": asset_doc["_id"]}, {"$set": {"data": asset_data}}
+                        )
+                    )
+            else:  # Create
+                asset_doc = {
+                    "name": asset["name"],
+                    "type": "asset",
+                    "schema": "openpype:asset-3.0",
+                    "data": asset_data,
+                    "parent": project_doc["_id"],
+                }
 
-                # TODO update
-            # for task in asset_tasks:
-            #     # print(task)
-            #     task_data = {"zou_id": task["id"]}
-
-            #     # Create Task
-            #     task_doc = {
-            #         "name": task["name"],
-            #         "type": "task",
-            #         "schema": "openpype:asset-3.0",
-            #         "data": task_data,
-            #         "parent": asset_doc["_id"],
-            #     }
-            #     insert_list.append(task_doc)
+                # Insert new doc
+                bulk_writes.append(InsertOne(asset_doc))
 
             # elif item.data(REMOVED_ROLE): # TODO removal
             #     if item.data(HIERARCHY_CHANGE_ABLE_ROLE):
@@ -244,13 +238,9 @@ def sync_local():
             #             update_data
             #         ))
 
-        # Insert new docs if created
-        if insert_list:
-            project_col.insert_many(insert_list)
-
-        # Write into DB TODO
-        # if bulk_writes:
-        #     project_col.bulk_write(bulk_writes)
+        # Write into DB
+        if bulk_writes:
+            project_col.bulk_write(bulk_writes)
 
     dbcon.uninstall()
 

From 206bf9f3c18873a6f81734841779eeab4f8829d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 9 Feb 2022 09:45:11 +0100
Subject: [PATCH 0123/1227] Delete assets

---
 .../default_modules/kitsu/kitsu_module.py     | 40 +++++++++----------
 1 file changed, 18 insertions(+), 22 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 1a71a05a7e..1ce1bef6a2 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -170,10 +170,13 @@ def sync_local():
 
         # Query all assets of the local project
         project_col = dbcon.database[project_code]
-        asset_docs_zou_ids = {
-            asset_doc["data"]["zou_id"]
+        asset_doc_ids = {
+            asset_doc["_id"]: asset_doc
             for asset_doc in project_col.find({"type": "asset"})
         }
+        asset_docs_zou_ids = {
+            asset_doc["data"]["zou_id"] for asset_doc in asset_doc_ids.values()
+        }
 
         # Create project if is not available
         # - creation is required to be able set project anatomy and attributes
@@ -182,6 +185,7 @@ def sync_local():
             project_doc = create_project(project_name, project_code, dbcon=dbcon)
 
         bulk_writes = []
+        sync_assets = set()
         for asset in all_assets:
             asset_data = {"zou_id": asset["id"]}
 
@@ -195,13 +199,13 @@ def sync_local():
             if asset["id"] in asset_docs_zou_ids:  # Update asset
                 asset_doc = project_col.find_one({"data.zou_id": asset["id"]})
 
-                # Override all 'data' TODO filter data to update?
-                diff_data = {
+                # Override all 'data'
+                updated_data = {
                     k: asset_data[k]
                     for k in asset_data.keys()
                     if asset_doc["data"].get(k) != asset_data[k]
                 }
-                if diff_data:
+                if updated_data:
                     bulk_writes.append(
                         UpdateOne(
                             {"_id": asset_doc["_id"]}, {"$set": {"data": asset_data}}
@@ -219,24 +223,16 @@ def sync_local():
                 # Insert new doc
                 bulk_writes.append(InsertOne(asset_doc))
 
-            # elif item.data(REMOVED_ROLE): # TODO removal
-            #     if item.data(HIERARCHY_CHANGE_ABLE_ROLE):
-            #         bulk_writes.append(DeleteOne(
-            #             {"_id": item.asset_id}
-            #         ))
-            #     else:
-            #         bulk_writes.append(UpdateOne(
-            #             {"_id": item.asset_id},
-            #             {"$set": {"type": "archived_asset"}}
-            #         ))
+            # Keep synchronized asset for diff
+            sync_assets.add(asset_doc["_id"])
 
-            # else: TODO update data
-            #     update_data = new_item.update_data()
-            #     if update_data:
-            #         bulk_writes.append(UpdateOne(
-            #             {"_id": new_item.asset_id},
-            #             update_data
-            #         ))
+        # Delete from diff of assets in OP and synchronized assets to detect deleted assets
+        diff_assets = set(asset_doc_ids.keys()) - sync_assets
+        if diff_assets:
+            # Delete doc
+            bulk_writes.extend(
+                [DeleteOne(asset_doc_ids[asset_id]) for asset_id in diff_assets]
+            )
 
         # Write into DB
         if bulk_writes:

From e882de52f04d2ca79e30fb23801257cefd085e56 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 10 Feb 2022 17:35:03 +0100
Subject: [PATCH 0124/1227] Assets hierarchy

---
 .../default_modules/kitsu/kitsu_module.py     | 165 ++++++++++++------
 1 file changed, 114 insertions(+), 51 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 1ce1bef6a2..92d724be67 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -7,13 +7,15 @@ in global space here until are required or used.
     - we still support Python 2 hosts where addon definition should available
 """
 import os
+from typing import Dict, List, Set
 import click
 
 from avalon.api import AvalonMongoDB
 import gazu
 from openpype.lib import create_project
 from openpype.modules import JsonFilesSettingsDef, OpenPypeModule, ModulesManager
-from pymongo import DeleteOne, InsertOne, UpdateOne
+from pymongo import DeleteOne, UpdateOne
+from pymongo.collection import Collection
 from openpype_interfaces import IPluginPaths, ITrayAction
 
 
@@ -144,8 +146,8 @@ def cli_main():
 
 
 @cli_main.command()
-def sync_local():
-    """Synchronize local database from Zou sever database."""
+def sync_openpype():
+    """Synchronize openpype database from Zou sever database."""
 
     # Connect to server
     gazu.client.set_host(os.environ["KITSU_SERVER"])
@@ -167,69 +169,61 @@ def sync_local():
 
         # Get all assets from zou
         all_assets = gazu.asset.all_assets_for_project(project)
-
-        # Query all assets of the local project
-        project_col = dbcon.database[project_code]
-        asset_doc_ids = {
-            asset_doc["_id"]: asset_doc
-            for asset_doc in project_col.find({"type": "asset"})
-        }
-        asset_docs_zou_ids = {
-            asset_doc["data"]["zou_id"] for asset_doc in asset_doc_ids.values()
-        }
+        all_episodes = gazu.shot.all_episodes_for_project(project)
+        all_seqs = gazu.shot.all_sequences_for_project(project)
+        all_shots = gazu.shot.all_shots_for_project(project)
 
         # Create project if is not available
         # - creation is required to be able set project anatomy and attributes
+        to_insert = []
         if not project_doc:
             print(f"Creating project '{project_name}'")
             project_doc = create_project(project_name, project_code, dbcon=dbcon)
 
-        bulk_writes = []
-        sync_assets = set()
-        for asset in all_assets:
-            asset_data = {"zou_id": asset["id"]}
+        # Query all assets of the local project
+        project_col = dbcon.database[project_code]
+        asset_doc_ids = {
+            asset_doc["data"]["zou_id"]: asset_doc
+            for asset_doc in project_col.find({"type": "asset"})
+            if asset_doc["data"].get("zou_id")
+        }
+        asset_doc_ids[project["id"]] = project_doc
 
-            # Set tasks
-            asset_tasks = gazu.task.all_tasks_for_asset(asset)
-            asset_data["tasks"] = {
-                t["task_type_name"]: {"type": t["task_type_name"]} for t in asset_tasks
-            }
-
-            # Update or create asset
-            if asset["id"] in asset_docs_zou_ids:  # Update asset
-                asset_doc = project_col.find_one({"data.zou_id": asset["id"]})
-
-                # Override all 'data'
-                updated_data = {
-                    k: asset_data[k]
-                    for k in asset_data.keys()
-                    if asset_doc["data"].get(k) != asset_data[k]
-                }
-                if updated_data:
-                    bulk_writes.append(
-                        UpdateOne(
-                            {"_id": asset_doc["_id"]}, {"$set": {"data": asset_data}}
-                        )
-                    )
-            else:  # Create
-                asset_doc = {
-                    "name": asset["name"],
+        # Create
+        to_insert.extend(
+            [
+                {
+                    "name": item["name"],
                     "type": "asset",
                     "schema": "openpype:asset-3.0",
-                    "data": asset_data,
-                    "parent": project_doc["_id"],
+                    "data": {"zou_id": item["id"], "tasks": {}},
                 }
+                for item in all_episodes + all_assets + all_seqs + all_shots
+                if item["id"] not in asset_doc_ids.keys()
+            ]
+        )
+        if to_insert:
+            # Insert in doc
+            project_col.insert_many(to_insert)
 
-                # Insert new doc
-                bulk_writes.append(InsertOne(asset_doc))
+            # Update existing docs
+            asset_doc_ids.update(
+                {
+                    asset_doc["data"]["zou_id"]: asset_doc
+                    for asset_doc in project_col.find({"type": "asset"})
+                    if asset_doc["data"].get("zou_id")
+                }
+            )
 
-            # Keep synchronized asset for diff
-            sync_assets.add(asset_doc["_id"])
+        # Update
+        all_entities = all_assets + all_episodes + all_seqs + all_shots
+        bulk_writes = update_op_assets(project_col, all_entities, asset_doc_ids)
 
-        # Delete from diff of assets in OP and synchronized assets to detect deleted assets
-        diff_assets = set(asset_doc_ids.keys()) - sync_assets
+        # Delete
+        diff_assets = set(asset_doc_ids.keys()) - {
+            e["id"] for e in all_entities + [project]
+        }
         if diff_assets:
-            # Delete doc
             bulk_writes.extend(
                 [DeleteOne(asset_doc_ids[asset_id]) for asset_id in diff_assets]
             )
@@ -241,6 +235,75 @@ def sync_local():
     dbcon.uninstall()
 
 
+def update_op_assets(
+    project_col: Collection, items_list: List[dict], asset_doc_ids: Dict[str, dict]
+) -> List[UpdateOne]:
+    """Update OpenPype assets.
+    Set 'data' and 'parent' fields.
+
+    :param project_col: Project collection to query data from
+    :param items_list: List of zou items to update
+    :param asset_doc_ids: Dicts of [{zou_id: asset_doc}, ...]
+    :return: List of UpdateOne objects
+    """
+    bulk_writes = []
+    for item in items_list:
+        # Update asset
+        item_doc = project_col.find_one({"data.zou_id": item["id"]})
+        item_data = item_doc["data"].copy()
+
+        # Tasks
+        tasks_list = None
+        if item["type"] == "Asset":
+            tasks_list = gazu.task.all_tasks_for_asset(item)
+        elif item["type"] == "Shot":
+            tasks_list = gazu.task.all_tasks_for_shot(item)
+        if tasks_list:
+            item_data["tasks"] = {
+                t["task_type_name"]: {"type": t["task_type_name"]} for t in tasks_list
+            }
+
+        # Visual parent for hierarchy
+        direct_parent_id = item["parent_id"] or item["source_id"]
+        if direct_parent_id:
+            visual_parent_doc = asset_doc_ids[direct_parent_id]
+            item_data["visualParent"] = visual_parent_doc["_id"]
+
+        # Add parents for hierarchy
+        parent_zou_id = item["parent_id"]
+        item_data["parents"] = []
+        while parent_zou_id is not None:
+            parent_doc = asset_doc_ids[parent_zou_id]
+            item_data["parents"].insert(0, parent_doc["name"])
+
+            parent_zou_id = next(
+                i for i in items_list if i["id"] == parent_doc["data"]["zou_id"]
+            )["parent_id"]
+
+        # TODO create missing tasks before
+
+        # Update 'data' different in zou DB
+        updated_data = {
+            k: item_data[k]
+            for k in item_data.keys()
+            if item_doc["data"].get(k) != item_data[k]
+        }
+        if updated_data or not item_doc.get("parent"):
+            bulk_writes.append(
+                UpdateOne(
+                    {"_id": item_doc["_id"]},
+                    {
+                        "$set": {
+                            "data": item_data,
+                            "parent": asset_doc_ids[item["project_id"]]["_id"],
+                        }
+                    },
+                )
+            )
+
+    return bulk_writes
+
+
 @cli_main.command()
 def show_dialog():
     """Show ExampleAddon dialog.

From ee281f740d58821ab4d5e190e6b4863af5c2ac44 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 10 Feb 2022 18:03:27 +0100
Subject: [PATCH 0125/1227] Project tasks

---
 .../default_modules/kitsu/kitsu_module.py     | 23 +++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 92d724be67..84709bc0a2 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -160,6 +160,8 @@ def sync_openpype():
     dbcon.install()
     all_projects = gazu.project.all_projects()
     for project in all_projects:
+        bulk_writes = []
+
         # Create project locally
         # Try to find project document
         project_name = project["name"]
@@ -180,6 +182,23 @@ def sync_openpype():
             print(f"Creating project '{project_name}'")
             project_doc = create_project(project_name, project_code, dbcon=dbcon)
 
+            # Project tasks
+            bulk_writes.append(
+                UpdateOne(
+                    {"_id": project_doc["_id"]},
+                    {
+                        "$set": {
+                            "config.tasks": {
+                                t["name"]: {
+                                    "short_name": t.get("short_name", t["name"])
+                                }
+                                for t in gazu.task.all_task_types_for_project(project)
+                            }
+                        }
+                    },
+                )
+            )
+
         # Query all assets of the local project
         project_col = dbcon.database[project_code]
         asset_doc_ids = {
@@ -217,7 +236,7 @@ def sync_openpype():
 
         # Update
         all_entities = all_assets + all_episodes + all_seqs + all_shots
-        bulk_writes = update_op_assets(project_col, all_entities, asset_doc_ids)
+        bulk_writes.extend(update_op_assets(project_col, all_entities, asset_doc_ids))
 
         # Delete
         diff_assets = set(asset_doc_ids.keys()) - {
@@ -228,7 +247,7 @@ def sync_openpype():
                 [DeleteOne(asset_doc_ids[asset_id]) for asset_id in diff_assets]
             )
 
-        # Write into DB
+        # Write into DB # TODO make it common for all projects
         if bulk_writes:
             project_col.bulk_write(bulk_writes)
 

From d63c5fcae8ec1ee8c49c4a21dea86b3e9da157d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Fri, 11 Feb 2022 09:29:08 +0100
Subject: [PATCH 0126/1227] Optim: bulkwrite and queries mutualization

---
 .../default_modules/kitsu/kitsu_module.py      | 18 +++++++-----------
 1 file changed, 7 insertions(+), 11 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 84709bc0a2..89312a344c 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -159,9 +159,8 @@ def sync_openpype():
     dbcon = AvalonMongoDB()
     dbcon.install()
     all_projects = gazu.project.all_projects()
+    bulk_writes = []
     for project in all_projects:
-        bulk_writes = []
-
         # Create project locally
         # Try to find project document
         project_name = project["name"]
@@ -236,7 +235,7 @@ def sync_openpype():
 
         # Update
         all_entities = all_assets + all_episodes + all_seqs + all_shots
-        bulk_writes.extend(update_op_assets(project_col, all_entities, asset_doc_ids))
+        bulk_writes.extend(update_op_assets(all_entities, asset_doc_ids))
 
         # Delete
         diff_assets = set(asset_doc_ids.keys()) - {
@@ -247,20 +246,19 @@ def sync_openpype():
                 [DeleteOne(asset_doc_ids[asset_id]) for asset_id in diff_assets]
             )
 
-        # Write into DB # TODO make it common for all projects
-        if bulk_writes:
-            project_col.bulk_write(bulk_writes)
+    # Write into DB
+    if bulk_writes:
+        project_col.bulk_write(bulk_writes)
 
     dbcon.uninstall()
 
 
 def update_op_assets(
-    project_col: Collection, items_list: List[dict], asset_doc_ids: Dict[str, dict]
+    items_list: List[dict], asset_doc_ids: Dict[str, dict]
 ) -> List[UpdateOne]:
     """Update OpenPype assets.
     Set 'data' and 'parent' fields.
 
-    :param project_col: Project collection to query data from
     :param items_list: List of zou items to update
     :param asset_doc_ids: Dicts of [{zou_id: asset_doc}, ...]
     :return: List of UpdateOne objects
@@ -268,7 +266,7 @@ def update_op_assets(
     bulk_writes = []
     for item in items_list:
         # Update asset
-        item_doc = project_col.find_one({"data.zou_id": item["id"]})
+        item_doc = asset_doc_ids[item["id"]]
         item_data = item_doc["data"].copy()
 
         # Tasks
@@ -299,8 +297,6 @@ def update_op_assets(
                 i for i in items_list if i["id"] == parent_doc["data"]["zou_id"]
             )["parent_id"]
 
-        # TODO create missing tasks before
-
         # Update 'data' different in zou DB
         updated_data = {
             k: item_data[k]

From 4e68bcf55fd2552f53904dcd0a6c47b56946c927 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Fri, 11 Feb 2022 09:31:14 +0100
Subject: [PATCH 0127/1227] cleaning

---
 openpype/modules/default_modules/kitsu/kitsu_module.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 89312a344c..e52d18b84b 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -15,7 +15,6 @@ import gazu
 from openpype.lib import create_project
 from openpype.modules import JsonFilesSettingsDef, OpenPypeModule, ModulesManager
 from pymongo import DeleteOne, UpdateOne
-from pymongo.collection import Collection
 from openpype_interfaces import IPluginPaths, ITrayAction
 
 

From 294b93f65a97d17f503a82962f121c3202002a51 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Sat, 12 Feb 2022 15:06:22 +0100
Subject: [PATCH 0128/1227] Create episode

---
 .../default_modules/kitsu/kitsu_module.py     | 226 +++++++++++++++++-
 .../defaults/project_settings/kitsu.json      |   6 +-
 .../projects_schema/schema_project_kitsu.json |  26 +-
 3 files changed, 243 insertions(+), 15 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index e52d18b84b..c4f627d5ad 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -6,12 +6,14 @@ in global space here until are required or used.
 - imports of Python 3 packages
     - we still support Python 2 hosts where addon definition should available
 """
-import os
-from typing import Dict, List, Set
 import click
+import os
+import re
+from typing import Dict, List
 
 from avalon.api import AvalonMongoDB
 import gazu
+from openpype.api import get_project_settings
 from openpype.lib import create_project
 from openpype.modules import JsonFilesSettingsDef, OpenPypeModule, ModulesManager
 from pymongo import DeleteOne, UpdateOne
@@ -145,8 +147,8 @@ def cli_main():
 
 
 @cli_main.command()
-def sync_openpype():
-    """Synchronize openpype database from Zou sever database."""
+def sync_zou():
+    """Synchronize Zou server database (Kitsu backend) with openpype database."""
 
     # Connect to server
     gazu.client.set_host(os.environ["KITSU_SERVER"])
@@ -157,8 +159,108 @@ def sync_openpype():
     # Iterate projects
     dbcon = AvalonMongoDB()
     dbcon.install()
-    all_projects = gazu.project.all_projects()
+
+    op_projects = [p for p in dbcon.projects()]
     bulk_writes = []
+    for op_project in op_projects:
+        # Create project locally
+        # Try to find project document
+        project_name = op_project["name"]
+        project_code = op_project["data"]["code"]
+        dbcon.Session["AVALON_PROJECT"] = project_name
+
+        # Get all entities from zou
+        zou_project = gazu.project.get_project_by_name(project_name)
+
+        # Create project
+        if zou_project is None:
+            raise RuntimeError(
+                f"Project '{project_name}' doesn't exist in Zou database, please create it in Kitsu and add logged user to it before running synchronization."
+            )
+
+        # Update project settings and data
+        zou_project.update(
+            {
+                "code": op_project["data"]["code"],
+                "fps": op_project["data"]["fps"],
+                "resolution": f"{op_project['data']['resolutionWidth']}x{op_project['data']['resolutionHeight']}",
+            }
+        )
+        gazu.project.update_project(zou_project)
+        gazu.project.update_project_data(zou_project, data=op_project["data"])
+
+        all_assets = gazu.asset.all_assets_for_project(zou_project)
+        all_episodes = gazu.shot.all_episodes_for_project(zou_project)
+        all_seqs = gazu.shot.all_sequences_for_project(zou_project)
+        all_shots = gazu.shot.all_shots_for_project(zou_project)
+        print(zou_project["name"])
+        all_entities_ids = {
+            e["id"] for e in all_episodes + all_seqs + all_shots + all_assets
+        }
+
+        project_module_settings = get_project_settings(project_name)["kitsu"]
+
+        # Create new assets
+        # Query all assets of the local project
+        project_col = dbcon.database[project_name]
+        asset_docs = [asset_doc for asset_doc in project_col.find({"type": "asset"})]
+
+        new_assets_docs = [
+            doc
+            for doc in asset_docs
+            if doc["data"].get("zou_id") not in all_entities_ids
+        ]
+        naming_pattern = project_module_settings["entities_naming_pattern"]
+        regex_ep = re.compile(
+            r"({})|({})|({})".format(
+                naming_pattern["episode"].replace("#", "\d"),
+                naming_pattern["sequence"].replace("#", "\d"),
+                naming_pattern["shot"].replace("#", "\d"),
+            ),
+            re.IGNORECASE,
+        )
+        for doc in new_assets_docs:
+            match = regex_ep.match(doc["name"])
+            if not match:
+                # TODO asset
+                continue
+
+            print(doc)
+            if match.group(1):  # Episode
+                new_episode = gazu.shot.new_episode(zou_project, doc["name"])
+
+                # Update doc with zou id
+                bulk_writes.append(
+                    UpdateOne(
+                        {"_id": doc["_id"]},
+                        {"$set": {"data.zou_id": new_episode["id"]}},
+                    )
+                )
+            elif match.group(2):  # Sequence
+                # TODO match zou episode
+                new_sequence = gazu.shot.new_sequence(zou_project, doc["name"])
+
+                # Update doc with zou id
+                bulk_writes.append(
+                    UpdateOne(
+                        {"_id": doc["_id"]},
+                        {"$set": {"data.zou_id": new_sequence["id"]}},
+                    )
+                )
+            elif match.group(3):  # Shot
+                pass
+
+        # Delete
+        # if gazu.
+
+        # Write into DB
+        if bulk_writes:
+            project_col.bulk_write(bulk_writes)
+
+    dbcon.uninstall()
+
+    return
+
     for project in all_projects:
         # Create project locally
         # Try to find project document
@@ -245,9 +347,117 @@ def sync_openpype():
                 [DeleteOne(asset_doc_ids[asset_id]) for asset_id in diff_assets]
             )
 
-    # Write into DB
-    if bulk_writes:
-        project_col.bulk_write(bulk_writes)
+
+@cli_main.command()
+def sync_openpype():
+    """Synchronize openpype database from Zou sever database."""
+
+    # Connect to server
+    gazu.client.set_host(os.environ["KITSU_SERVER"])
+
+    # Authenticate
+    gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
+
+    # Iterate projects
+    dbcon = AvalonMongoDB()
+    dbcon.install()
+    all_projects = gazu.project.all_projects()
+    bulk_writes = []
+    for project in all_projects:
+        # Create project locally
+        # Try to find project document
+        project_name = project["name"]
+        project_code = project_name
+        dbcon.Session["AVALON_PROJECT"] = project_name
+        project_doc = dbcon.find_one({"type": "project"})
+
+        # Get all assets from zou
+        all_assets = gazu.asset.all_assets_for_project(project)
+        all_episodes = gazu.shot.all_episodes_for_project(project)
+        all_seqs = gazu.shot.all_sequences_for_project(project)
+        all_shots = gazu.shot.all_shots_for_project(project)
+
+        # Create project if is not available
+        # - creation is required to be able set project anatomy and attributes
+        to_insert = []
+        if not project_doc:
+            print(f"Creating project '{project_name}'")
+            project_doc = create_project(project_name, project_code, dbcon=dbcon)
+
+        # Project data and tasks
+        bulk_writes.append(
+            UpdateOne(
+                {"_id": project_doc["_id"]},
+                {
+                    "$set": {
+                        "config.tasks": {
+                            t["name"]: {"short_name": t.get("short_name", t["name"])}
+                            for t in gazu.task.all_task_types_for_project(project)
+                        },
+                        "data": project["data"].update(
+                            {
+                                "code": project["code"],
+                                "fps": project_code["fps"],
+                                "resolutionWidth": project["resolution"].split("x")[0],
+                                "resolutionHeight": project["resolution"].split("x")[1],
+                            }
+                        ),
+                    }
+                },
+            )
+        )
+
+        # Query all assets of the local project
+        project_col = dbcon.database[project_code]
+        asset_doc_ids = {
+            asset_doc["data"]["zou_id"]: asset_doc
+            for asset_doc in project_col.find({"type": "asset"})
+            if asset_doc["data"].get("zou_id")
+        }
+        asset_doc_ids[project["id"]] = project_doc
+
+        # Create
+        to_insert.extend(
+            [
+                {
+                    "name": item["name"],
+                    "type": "asset",
+                    "schema": "openpype:asset-3.0",
+                    "data": {"zou_id": item["id"], "tasks": {}},
+                }
+                for item in all_episodes + all_assets + all_seqs + all_shots
+                if item["id"] not in asset_doc_ids.keys()
+            ]
+        )
+        if to_insert:
+            # Insert in doc
+            project_col.insert_many(to_insert)
+
+            # Update existing docs
+            asset_doc_ids.update(
+                {
+                    asset_doc["data"]["zou_id"]: asset_doc
+                    for asset_doc in project_col.find({"type": "asset"})
+                    if asset_doc["data"].get("zou_id")
+                }
+            )
+
+        # Update
+        all_entities = all_assets + all_episodes + all_seqs + all_shots
+        bulk_writes.extend(update_op_assets(all_entities, asset_doc_ids))
+
+        # Delete
+        diff_assets = set(asset_doc_ids.keys()) - {
+            e["id"] for e in all_entities + [project]
+        }
+        if diff_assets:
+            bulk_writes.extend(
+                [DeleteOne(asset_doc_ids[asset_id]) for asset_id in diff_assets]
+            )
+
+        # Write into DB
+        if bulk_writes:
+            project_col.bulk_write(bulk_writes)
 
     dbcon.uninstall()
 
diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
index b4d2ccc611..435814a9d1 100644
--- a/openpype/settings/defaults/project_settings/kitsu.json
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -1,3 +1,7 @@
 {
-    "number": 0
+    "entities_naming_pattern": {
+        "episode": "E##",
+        "sequence": "SQ##",
+        "shot": "SH##"
+    }
 }
\ No newline at end of file
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index 93976cc03b..a504959001 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -6,12 +6,26 @@
     "is_file": true,
     "children": [
         {
-            "type": "number",
-            "key": "number",
-            "label": "This is your lucky number:",
-            "minimum": 7,
-            "maximum": 7,
-            "decimals": 0
+            "type": "dict",
+            "key": "entities_naming_pattern",
+            "label": "Entities naming pattern",
+            "children": [
+                {
+                    "type": "text",
+                    "key": "episode",
+                    "label": "Episode:"
+                },
+                {
+                    "type": "text",
+                    "key": "sequence",
+                    "label": "Sequence:"
+                },
+                {
+                    "type": "text",
+                    "key": "shot",
+                    "label": "Shot:"
+                }
+            ]
         }
     ]
 }

From bad16651e1b2ed2d307496941ac95adb1224040a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Mon, 14 Feb 2022 17:58:06 +0100
Subject: [PATCH 0129/1227] Create asset, ep, seq and shot in zou

---
 .../default_modules/kitsu/kitsu_module.py     | 123 +++++++++++++-----
 1 file changed, 93 insertions(+), 30 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index c4f627d5ad..453d1c5315 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -189,6 +189,7 @@ def sync_zou():
         gazu.project.update_project(zou_project)
         gazu.project.update_project_data(zou_project, data=op_project["data"])
 
+        all_asset_types = gazu.asset.all_asset_types()
         all_assets = gazu.asset.all_assets_for_project(zou_project)
         all_episodes = gazu.shot.all_episodes_for_project(zou_project)
         all_seqs = gazu.shot.all_sequences_for_project(zou_project)
@@ -199,15 +200,17 @@ def sync_zou():
         }
 
         project_module_settings = get_project_settings(project_name)["kitsu"]
+        project_col = dbcon.database[project_name]
+        asset_docs = {
+            asset_doc["_id"]: asset_doc
+            for asset_doc in project_col.find({"type": "asset"})
+        }
 
         # Create new assets
         # Query all assets of the local project
-        project_col = dbcon.database[project_name]
-        asset_docs = [asset_doc for asset_doc in project_col.find({"type": "asset"})]
-
         new_assets_docs = [
             doc
-            for doc in asset_docs
+            for doc in asset_docs.values()
             if doc["data"].get("zou_id") not in all_entities_ids
         ]
         naming_pattern = project_module_settings["entities_naming_pattern"]
@@ -220,37 +223,95 @@ def sync_zou():
             re.IGNORECASE,
         )
         for doc in new_assets_docs:
+            visual_parent_id = doc["data"]["visualParent"]
+
             match = regex_ep.match(doc["name"])
-            if not match:
-                # TODO asset
-                continue
-
-            print(doc)
-            if match.group(1):  # Episode
-                new_episode = gazu.shot.new_episode(zou_project, doc["name"])
-
-                # Update doc with zou id
-                bulk_writes.append(
-                    UpdateOne(
-                        {"_id": doc["_id"]},
-                        {"$set": {"data.zou_id": new_episode["id"]}},
-                    )
+            if not match:  # Asset
+                new_entity = gazu.asset.new_asset(
+                    zou_project, all_asset_types[0], doc["name"]
                 )
+
+            elif match.group(1):  # Episode
+                new_entity = gazu.shot.new_episode(zou_project, doc["name"])
+
             elif match.group(2):  # Sequence
-                # TODO match zou episode
-                new_sequence = gazu.shot.new_sequence(zou_project, doc["name"])
-
-                # Update doc with zou id
-                bulk_writes.append(
-                    UpdateOne(
-                        {"_id": doc["_id"]},
-                        {"$set": {"data.zou_id": new_sequence["id"]}},
-                    )
+                parent_doc = asset_docs[visual_parent_id]
+                new_entity = gazu.shot.new_sequence(
+                    zou_project, doc["name"], episode=parent_doc["data"]["zou_id"]
                 )
-            elif match.group(3):  # Shot
-                pass
 
-        # Delete
+            elif match.group(3):  # Shot
+                # Match and check parent doc
+                parent_doc = asset_docs[visual_parent_id]
+                zou_parent_id = parent_doc["data"]["zou_id"]
+                if parent_doc["data"].get("zou", {}).get("type") != "Sequence":
+                    # Warn
+                    print(
+                        f"Shot {doc['name']} must be parented to a Sequence in Kitsu. Creating automatically one substitute sequence..."
+                    )
+
+                    # Create new sequence
+                    digits_padding = naming_pattern["sequence"].count("#")
+                    substitute_sequence_name = f'{naming_pattern["sequence"].replace("#" * digits_padding, "1".zfill(digits_padding))}'
+                    new_sequence = gazu.shot.new_sequence(
+                        zou_project, substitute_sequence_name, episode=zou_parent_id
+                    )
+
+                    # Insert doc
+                    inserted = project_col.insert_one(
+                        {
+                            "name": substitute_sequence_name,
+                            "type": "asset",
+                            "schema": "openpype:asset-3.0",
+                            "data": {
+                                "zou_id": new_sequence["id"],
+                                "tasks": {},
+                                "parents": parent_doc["data"]["parents"]
+                                + [parent_doc["name"]],
+                                "visualParent": parent_doc["_id"],
+                            },
+                            "parent": parent_doc["_id"],
+                        }
+                    )
+                    visual_parent_id = inserted.inserted_id
+
+                    # Update parent ID
+                    zou_parent_id = new_sequence["id"]
+
+                # Create shot
+                new_entity = gazu.shot.new_shot(
+                    zou_project,
+                    zou_parent_id,
+                    doc["name"],
+                    frame_in=doc["data"]["frameStart"],
+                    frame_out=doc["data"]["frameEnd"],
+                    nb_frames=doc["data"]["frameEnd"] - doc["data"]["frameStart"],
+                )
+
+            # Update doc with zou id
+            doc["data"].update(
+                {
+                    "zou_id": new_entity["id"],
+                    "visualParent": visual_parent_id,
+                    "zou": new_entity,
+                }
+            )
+            bulk_writes.append(
+                UpdateOne(
+                    {"_id": doc["_id"]},
+                    {
+                        "$set": {
+                            "data.zou_id": new_entity["id"],
+                            "data.visualParent": visual_parent_id,
+                            "data.zou": new_entity,
+                        }
+                    },
+                )
+            )
+
+        # TODO update / tasks
+
+        # Delete TODO
         # if gazu.
 
         # Write into DB
@@ -477,6 +538,7 @@ def update_op_assets(
         # Update asset
         item_doc = asset_doc_ids[item["id"]]
         item_data = item_doc["data"].copy()
+        item_data["zou"] = item
 
         # Tasks
         tasks_list = None
@@ -484,6 +546,7 @@ def update_op_assets(
             tasks_list = gazu.task.all_tasks_for_asset(item)
         elif item["type"] == "Shot":
             tasks_list = gazu.task.all_tasks_for_shot(item)
+            # TODO frame in and out
         if tasks_list:
             item_data["tasks"] = {
                 t["task_type_name"]: {"type": t["task_type_name"]} for t in tasks_list

From 9af6264d1e02f92244d678964da5c5902428016f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 15 Feb 2022 18:21:26 +0100
Subject: [PATCH 0130/1227] Update and delete in zou

---
 .../default_modules/kitsu/kitsu_module.py     | 146 +++++++-----------
 1 file changed, 53 insertions(+), 93 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 453d1c5315..e42edbc52b 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -6,6 +6,8 @@ in global space here until are required or used.
 - imports of Python 3 packages
     - we still support Python 2 hosts where addon definition should available
 """
+from asyncio import all_tasks
+from turtle import update
 import click
 import os
 import re
@@ -170,6 +172,7 @@ def sync_zou():
         dbcon.Session["AVALON_PROJECT"] = project_name
 
         # Get all entities from zou
+        print(f"Synchronizing {project_name}...")
         zou_project = gazu.project.get_project_by_name(project_name)
 
         # Create project
@@ -194,11 +197,11 @@ def sync_zou():
         all_episodes = gazu.shot.all_episodes_for_project(zou_project)
         all_seqs = gazu.shot.all_sequences_for_project(zou_project)
         all_shots = gazu.shot.all_shots_for_project(zou_project)
-        print(zou_project["name"])
         all_entities_ids = {
             e["id"] for e in all_episodes + all_seqs + all_shots + all_assets
         }
 
+        # Query all assets of the local project
         project_module_settings = get_project_settings(project_name)["kitsu"]
         project_col = dbcon.database[project_name]
         asset_docs = {
@@ -207,7 +210,6 @@ def sync_zou():
         }
 
         # Create new assets
-        # Query all assets of the local project
         new_assets_docs = [
             doc
             for doc in asset_docs.values()
@@ -225,6 +227,7 @@ def sync_zou():
         for doc in new_assets_docs:
             visual_parent_id = doc["data"]["visualParent"]
 
+            # Match asset type by it's name
             match = regex_ep.match(doc["name"])
             if not match:  # Asset
                 new_entity = gazu.asset.new_asset(
@@ -269,6 +272,7 @@ def sync_zou():
                                 "parents": parent_doc["data"]["parents"]
                                 + [parent_doc["name"]],
                                 "visualParent": parent_doc["_id"],
+                                "zou": new_sequence,
                             },
                             "parent": parent_doc["_id"],
                         }
@@ -309,10 +313,54 @@ def sync_zou():
                 )
             )
 
-        # TODO update / tasks
+        # Update assets
+        all_tasks_types = {t["name"]: t for t in gazu.task.all_task_types()}
+        assets_docs_to_update = [
+            doc
+            for doc in asset_docs.values()
+            if doc["data"].get("zou_id") in all_entities_ids
+        ]
+        for doc in assets_docs_to_update:
+            zou_id = doc["data"].get("zou", {}).get("id")
+            if zou_id:
+                # Data
+                entity_data = {}
+                frame_in = doc["data"].get("frameStart")
+                frame_out = doc["data"].get("frameEnd")
+                if frame_in or frame_out:
+                    entity_data.update(
+                        {
+                            "data": {"frame_in": frame_in, "frame_out": frame_out},
+                            "nb_frames": frame_out - frame_in,
+                        }
+                    )
+                entity = gazu.raw.update("entities", zou_id, entity_data)
 
-        # Delete TODO
-        # if gazu.
+                # Tasks
+                all_tasks_func = getattr(
+                    gazu.task, f"all_tasks_for_{entity['type'].lower()}"
+                )
+                entity_tasks = {t["name"] for t in all_tasks_func(entity)}
+                for task_name in doc["data"]["tasks"].keys():
+                    # Create only if new
+                    if task_name not in entity_tasks:
+                        task_type = all_tasks_types.get(task_name)
+
+                        # Create non existing task
+                        if not task_type:
+                            task_type = gazu.task.new_task_type(task_name)
+                            all_tasks_types[task_name] = task_type
+
+                        # New task for entity
+                        gazu.task.new_task(entity, task_type)
+
+        # Delete
+        deleted_entities = all_entities_ids - {
+            asset_doc["data"].get("zou", {}).get("id")
+            for asset_doc in asset_docs.values()
+        }
+        for entity_id in deleted_entities:
+            gazu.raw.delete(f"data/entities/{entity_id}")
 
         # Write into DB
         if bulk_writes:
@@ -320,94 +368,6 @@ def sync_zou():
 
     dbcon.uninstall()
 
-    return
-
-    for project in all_projects:
-        # Create project locally
-        # Try to find project document
-        project_name = project["name"]
-        project_code = project_name
-        dbcon.Session["AVALON_PROJECT"] = project_name
-        project_doc = dbcon.find_one({"type": "project"})
-
-        # Get all assets from zou
-        all_assets = gazu.asset.all_assets_for_project(project)
-        all_episodes = gazu.shot.all_episodes_for_project(project)
-        all_seqs = gazu.shot.all_sequences_for_project(project)
-        all_shots = gazu.shot.all_shots_for_project(project)
-
-        # Create project if is not available
-        # - creation is required to be able set project anatomy and attributes
-        to_insert = []
-        if not project_doc:
-            print(f"Creating project '{project_name}'")
-            project_doc = create_project(project_name, project_code, dbcon=dbcon)
-
-            # Project tasks
-            bulk_writes.append(
-                UpdateOne(
-                    {"_id": project_doc["_id"]},
-                    {
-                        "$set": {
-                            "config.tasks": {
-                                t["name"]: {
-                                    "short_name": t.get("short_name", t["name"])
-                                }
-                                for t in gazu.task.all_task_types_for_project(project)
-                            }
-                        }
-                    },
-                )
-            )
-
-        # Query all assets of the local project
-        project_col = dbcon.database[project_code]
-        asset_doc_ids = {
-            asset_doc["data"]["zou_id"]: asset_doc
-            for asset_doc in project_col.find({"type": "asset"})
-            if asset_doc["data"].get("zou_id")
-        }
-        asset_doc_ids[project["id"]] = project_doc
-
-        # Create
-        to_insert.extend(
-            [
-                {
-                    "name": item["name"],
-                    "type": "asset",
-                    "schema": "openpype:asset-3.0",
-                    "data": {"zou_id": item["id"], "tasks": {}},
-                }
-                for item in all_episodes + all_assets + all_seqs + all_shots
-                if item["id"] not in asset_doc_ids.keys()
-            ]
-        )
-        if to_insert:
-            # Insert in doc
-            project_col.insert_many(to_insert)
-
-            # Update existing docs
-            asset_doc_ids.update(
-                {
-                    asset_doc["data"]["zou_id"]: asset_doc
-                    for asset_doc in project_col.find({"type": "asset"})
-                    if asset_doc["data"].get("zou_id")
-                }
-            )
-
-        # Update
-        all_entities = all_assets + all_episodes + all_seqs + all_shots
-        bulk_writes.extend(update_op_assets(all_entities, asset_doc_ids))
-
-        # Delete
-        diff_assets = set(asset_doc_ids.keys()) - {
-            e["id"] for e in all_entities + [project]
-        }
-        if diff_assets:
-            bulk_writes.extend(
-                [DeleteOne(asset_doc_ids[asset_id]) for asset_id in diff_assets]
-            )
-
 
 @cli_main.command()
 def sync_openpype():

From b2ce0ac07a04ebdc2e61b4289ec2c2fcde624c63 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 15 Feb 2022 18:29:43 +0100
Subject: [PATCH 0131/1227] Shot naming matching

---
 .../default_modules/kitsu/kitsu_module.py     | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index e42edbc52b..a67f0e2d58 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -233,16 +233,7 @@ def sync_zou():
                 new_entity = gazu.asset.new_asset(
                     zou_project, all_asset_types[0], doc["name"]
                 )
-
-            elif match.group(1):  # Episode
-                new_entity = gazu.shot.new_episode(zou_project, doc["name"])
-
-            elif match.group(2):  # Sequence
-                parent_doc = asset_docs[visual_parent_id]
-                new_entity = gazu.shot.new_sequence(
-                    zou_project, doc["name"], episode=parent_doc["data"]["zou_id"]
-                )
-
+            # Match case in shot<sequence<episode order to support composed names like 'ep01_sq01_sh01'
             elif match.group(3):  # Shot
                 # Match and check parent doc
                 parent_doc = asset_docs[visual_parent_id]
@@ -292,6 +283,15 @@ def sync_zou():
                     nb_frames=doc["data"]["frameEnd"] - doc["data"]["frameStart"],
                 )
 
+            elif match.group(2):  # Sequence
+                parent_doc = asset_docs[visual_parent_id]
+                new_entity = gazu.shot.new_sequence(
+                    zou_project, doc["name"], episode=parent_doc["data"]["zou_id"]
+                )
+
+            elif match.group(1):  # Episode
+                new_entity = gazu.shot.new_episode(zou_project, doc["name"])
+
             # Update doc with zou id
             doc["data"].update(
                 {

From 9dcfab2b56c919cfa95abe57c49f8c7ac34d4a87 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 15 Feb 2022 18:30:06 +0100
Subject: [PATCH 0132/1227] cleaning

---
 openpype/modules/default_modules/kitsu/kitsu_module.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index a67f0e2d58..47af25ce60 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -6,8 +6,6 @@ in global space here until are required or used.
 - imports of Python 3 packages
     - we still support Python 2 hosts where addon definition should available
 """
-from asyncio import all_tasks
-from turtle import update
 import click
 import os
 import re

From a8611c07a8d56942950a2294a95f06f07aa87d94 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 16 Feb 2022 15:42:23 +0100
Subject: [PATCH 0133/1227] Clean sync zou

---
 .../default_modules/kitsu/kitsu_module.py     | 138 +++++++++---------
 1 file changed, 72 insertions(+), 66 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 47af25ce60..ce4c579607 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -13,6 +13,24 @@ from typing import Dict, List
 
 from avalon.api import AvalonMongoDB
 import gazu
+from gazu.asset import all_assets_for_project, all_asset_types, new_asset
+from gazu.shot import (
+    all_episodes_for_project,
+    all_sequences_for_project,
+    all_shots_for_project,
+    new_episode,
+    new_sequence,
+    new_shot,
+    update_sequence,
+)
+from gazu.task import (
+    all_tasks_for_asset,
+    all_tasks_for_shot,
+    all_task_types,
+    all_task_types_for_project,
+    new_task,
+    new_task_type,
+)
 from openpype.api import get_project_settings
 from openpype.lib import create_project
 from openpype.modules import JsonFilesSettingsDef, OpenPypeModule, ModulesManager
@@ -176,7 +194,7 @@ def sync_zou():
         # Create project
         if zou_project is None:
             raise RuntimeError(
-                f"Project '{project_name}' doesn't exist in Zou database, please create it in Kitsu and add logged user to it before running synchronization."
+                f"Project '{project_name}' doesn't exist in Zou database, please create it in Kitsu and add OpenPype user to it before running synchronization."
             )
 
         # Update project settings and data
@@ -190,11 +208,11 @@ def sync_zou():
         gazu.project.update_project(zou_project)
         gazu.project.update_project_data(zou_project, data=op_project["data"])
 
-        all_asset_types = gazu.asset.all_asset_types()
-        all_assets = gazu.asset.all_assets_for_project(zou_project)
-        all_episodes = gazu.shot.all_episodes_for_project(zou_project)
-        all_seqs = gazu.shot.all_sequences_for_project(zou_project)
-        all_shots = gazu.shot.all_shots_for_project(zou_project)
+        asset_types = all_asset_types()
+        all_assets = all_assets_for_project(zou_project)
+        all_episodes = all_episodes_for_project(zou_project)
+        all_seqs = all_sequences_for_project(zou_project)
+        all_shots = all_shots_for_project(zou_project)
         all_entities_ids = {
             e["id"] for e in all_episodes + all_seqs + all_shots + all_assets
         }
@@ -211,14 +229,14 @@ def sync_zou():
         new_assets_docs = [
             doc
             for doc in asset_docs.values()
-            if doc["data"].get("zou_id") not in all_entities_ids
+            if doc["data"].get("zou", {}).get("id") not in all_entities_ids
         ]
         naming_pattern = project_module_settings["entities_naming_pattern"]
         regex_ep = re.compile(
-            r"({})|({})|({})".format(
-                naming_pattern["episode"].replace("#", "\d"),
-                naming_pattern["sequence"].replace("#", "\d"),
-                naming_pattern["shot"].replace("#", "\d"),
+            r"(.*{}.*)|(.*{}.*)|(.*{}.*)".format(
+                naming_pattern["shot"].replace("#", ""),
+                naming_pattern["sequence"].replace("#", ""),
+                naming_pattern["episode"].replace("#", ""),
             ),
             re.IGNORECASE,
         )
@@ -228,51 +246,38 @@ def sync_zou():
             # Match asset type by it's name
             match = regex_ep.match(doc["name"])
             if not match:  # Asset
-                new_entity = gazu.asset.new_asset(
-                    zou_project, all_asset_types[0], doc["name"]
-                )
+                new_entity = new_asset(zou_project, asset_types[0], doc["name"])
             # Match case in shot<sequence<episode order to support composed names like 'ep01_sq01_sh01'
-            elif match.group(3):  # Shot
+            elif match.group(1):  # Shot
                 # Match and check parent doc
                 parent_doc = asset_docs[visual_parent_id]
-                zou_parent_id = parent_doc["data"]["zou_id"]
+                zou_parent_id = parent_doc["data"]["zou"]["id"]
                 if parent_doc["data"].get("zou", {}).get("type") != "Sequence":
+                    # Substitute name
+                    digits_padding = naming_pattern["sequence"].count("#")
+                    substitute_sequence_name = (
+                        f'{naming_pattern["episode"].replace("#" * digits_padding, "1".zfill(digits_padding))}_'  # Episode
+                        f'{naming_pattern["sequence"].replace("#" * digits_padding, "1".zfill(digits_padding))}'  # Sequence
+                    )
+
                     # Warn
                     print(
-                        f"Shot {doc['name']} must be parented to a Sequence in Kitsu. Creating automatically one substitute sequence..."
+                        f"Shot {doc['name']} must be parented to a Sequence in Kitsu. "
+                        f"Creating automatically one substitute sequence called {substitute_sequence_name} in Kitsu..."
                     )
 
-                    # Create new sequence
-                    digits_padding = naming_pattern["sequence"].count("#")
-                    substitute_sequence_name = f'{naming_pattern["sequence"].replace("#" * digits_padding, "1".zfill(digits_padding))}'
-                    new_sequence = gazu.shot.new_sequence(
+                    # Create new sequence and set it as substitute
+                    created_sequence = new_sequence(
                         zou_project, substitute_sequence_name, episode=zou_parent_id
                     )
-
-                    # Insert doc
-                    inserted = project_col.insert_one(
-                        {
-                            "name": substitute_sequence_name,
-                            "type": "asset",
-                            "schema": "openpype:asset-3.0",
-                            "data": {
-                                "zou_id": new_sequence["id"],
-                                "tasks": {},
-                                "parents": parent_doc["data"]["parents"]
-                                + [parent_doc["name"]],
-                                "visualParent": parent_doc["_id"],
-                                "zou": new_sequence,
-                            },
-                            "parent": parent_doc["_id"],
-                        }
-                    )
-                    visual_parent_id = inserted.inserted_id
+                    created_sequence["is_substitute"] = True
+                    update_sequence(created_sequence)
 
                     # Update parent ID
-                    zou_parent_id = new_sequence["id"]
+                    zou_parent_id = created_sequence["id"]
 
                 # Create shot
-                new_entity = gazu.shot.new_shot(
+                new_entity = new_shot(
                     zou_project,
                     zou_parent_id,
                     doc["name"],
@@ -283,17 +288,16 @@ def sync_zou():
 
             elif match.group(2):  # Sequence
                 parent_doc = asset_docs[visual_parent_id]
-                new_entity = gazu.shot.new_sequence(
-                    zou_project, doc["name"], episode=parent_doc["data"]["zou_id"]
+                new_entity = new_sequence(
+                    zou_project, doc["name"], episode=parent_doc["data"]["zou"]["id"]
                 )
 
-            elif match.group(1):  # Episode
-                new_entity = gazu.shot.new_episode(zou_project, doc["name"])
+            elif match.group(3):  # Episode
+                new_entity = new_episode(zou_project, doc["name"])
 
             # Update doc with zou id
             doc["data"].update(
                 {
-                    "zou_id": new_entity["id"],
                     "visualParent": visual_parent_id,
                     "zou": new_entity,
                 }
@@ -303,7 +307,6 @@ def sync_zou():
                     {"_id": doc["_id"]},
                     {
                         "$set": {
-                            "data.zou_id": new_entity["id"],
                             "data.visualParent": visual_parent_id,
                             "data.zou": new_entity,
                         }
@@ -312,14 +315,14 @@ def sync_zou():
             )
 
         # Update assets
-        all_tasks_types = {t["name"]: t for t in gazu.task.all_task_types()}
+        all_tasks_types = {t["name"]: t for t in all_task_types()}
         assets_docs_to_update = [
             doc
             for doc in asset_docs.values()
-            if doc["data"].get("zou_id") in all_entities_ids
+            if doc["data"].get("zou", {}).get("id") in all_entities_ids
         ]
         for doc in assets_docs_to_update:
-            zou_id = doc["data"].get("zou", {}).get("id")
+            zou_id = doc["data"]["zou"]["id"]
             if zou_id:
                 # Data
                 entity_data = {}
@@ -346,11 +349,11 @@ def sync_zou():
 
                         # Create non existing task
                         if not task_type:
-                            task_type = gazu.task.new_task_type(task_name)
+                            task_type = new_task_type(task_name)
                             all_tasks_types[task_name] = task_type
 
                         # New task for entity
-                        gazu.task.new_task(entity, task_type)
+                        new_task(entity, task_type)
 
         # Delete
         deleted_entities = all_entities_ids - {
@@ -364,6 +367,8 @@ def sync_zou():
         if bulk_writes:
             project_col.bulk_write(bulk_writes)
 
+    # TODO Create events daemons
+
     dbcon.uninstall()
 
 
@@ -391,10 +396,10 @@ def sync_openpype():
         project_doc = dbcon.find_one({"type": "project"})
 
         # Get all assets from zou
-        all_assets = gazu.asset.all_assets_for_project(project)
-        all_episodes = gazu.shot.all_episodes_for_project(project)
-        all_seqs = gazu.shot.all_sequences_for_project(project)
-        all_shots = gazu.shot.all_shots_for_project(project)
+        all_assets = all_assets_for_project(project)
+        all_episodes = all_episodes_for_project(project)
+        all_seqs = all_sequences_for_project(project)
+        all_shots = all_shots_for_project(project)
 
         # Create project if is not available
         # - creation is required to be able set project anatomy and attributes
@@ -411,7 +416,7 @@ def sync_openpype():
                     "$set": {
                         "config.tasks": {
                             t["name"]: {"short_name": t.get("short_name", t["name"])}
-                            for t in gazu.task.all_task_types_for_project(project)
+                            for t in all_task_types_for_project(project)
                         },
                         "data": project["data"].update(
                             {
@@ -429,9 +434,9 @@ def sync_openpype():
         # Query all assets of the local project
         project_col = dbcon.database[project_code]
         asset_doc_ids = {
-            asset_doc["data"]["zou_id"]: asset_doc
+            asset_doc["data"]["zou"]["id"]: asset_doc
             for asset_doc in project_col.find({"type": "asset"})
-            if asset_doc["data"].get("zou_id")
+            if asset_doc["data"].get("zou", {}).get("id")
         }
         asset_doc_ids[project["id"]] = project_doc
 
@@ -442,10 +447,11 @@ def sync_openpype():
                     "name": item["name"],
                     "type": "asset",
                     "schema": "openpype:asset-3.0",
-                    "data": {"zou_id": item["id"], "tasks": {}},
+                    "data": {"zou": item, "tasks": {}},
                 }
                 for item in all_episodes + all_assets + all_seqs + all_shots
                 if item["id"] not in asset_doc_ids.keys()
+                and not item.get("is_substitute")
             ]
         )
         if to_insert:
@@ -455,9 +461,9 @@ def sync_openpype():
             # Update existing docs
             asset_doc_ids.update(
                 {
-                    asset_doc["data"]["zou_id"]: asset_doc
+                    asset_doc["data"]["zou"]["id"]: asset_doc
                     for asset_doc in project_col.find({"type": "asset"})
-                    if asset_doc["data"].get("zou_id")
+                    if asset_doc["data"].get("zou")
                 }
             )
 
@@ -501,9 +507,9 @@ def update_op_assets(
         # Tasks
         tasks_list = None
         if item["type"] == "Asset":
-            tasks_list = gazu.task.all_tasks_for_asset(item)
+            tasks_list = all_tasks_for_asset(item)
         elif item["type"] == "Shot":
-            tasks_list = gazu.task.all_tasks_for_shot(item)
+            tasks_list = all_tasks_for_shot(item)
             # TODO frame in and out
         if tasks_list:
             item_data["tasks"] = {
@@ -524,7 +530,7 @@ def update_op_assets(
             item_data["parents"].insert(0, parent_doc["name"])
 
             parent_zou_id = next(
-                i for i in items_list if i["id"] == parent_doc["data"]["zou_id"]
+                i for i in items_list if i["id"] == parent_doc["data"]["zou"]["id"]
             )["parent_id"]
 
         # Update 'data' different in zou DB

From c74b62c7d45a9d83d734e72abd6c1122d1f6c4a1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 16 Feb 2022 17:30:35 +0100
Subject: [PATCH 0134/1227] Fix sync

---
 .../default_modules/kitsu/kitsu_module.py     | 36 +++++++++++--------
 1 file changed, 21 insertions(+), 15 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index ce4c579607..266aaa9139 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -184,7 +184,6 @@ def sync_zou():
         # Create project locally
         # Try to find project document
         project_name = op_project["name"]
-        project_code = op_project["data"]["code"]
         dbcon.Session["AVALON_PROJECT"] = project_name
 
         # Get all entities from zou
@@ -198,15 +197,16 @@ def sync_zou():
             )
 
         # Update project settings and data
-        zou_project.update(
-            {
-                "code": op_project["data"]["code"],
-                "fps": op_project["data"]["fps"],
-                "resolution": f"{op_project['data']['resolutionWidth']}x{op_project['data']['resolutionHeight']}",
-            }
-        )
+        if op_project["data"]:
+            zou_project.update(
+                {
+                    "code": op_project["data"]["code"],
+                    "fps": op_project["data"]["fps"],
+                    "resolution": f"{op_project['data']['resolutionWidth']}x{op_project['data']['resolutionHeight']}",
+                }
+            )
+            gazu.project.update_project_data(zou_project, data=op_project["data"])
         gazu.project.update_project(zou_project)
-        gazu.project.update_project_data(zou_project, data=op_project["data"])
 
         asset_types = all_asset_types()
         all_assets = all_assets_for_project(zou_project)
@@ -270,8 +270,9 @@ def sync_zou():
                     created_sequence = new_sequence(
                         zou_project, substitute_sequence_name, episode=zou_parent_id
                     )
-                    created_sequence["is_substitute"] = True
-                    update_sequence(created_sequence)
+                    gazu.shot.update_sequence_data(
+                        created_sequence, {"is_substitute": True}
+                    )
 
                     # Update parent ID
                     zou_parent_id = created_sequence["id"]
@@ -395,11 +396,18 @@ def sync_openpype():
         dbcon.Session["AVALON_PROJECT"] = project_name
         project_doc = dbcon.find_one({"type": "project"})
 
+        print(f"Synchronizing {project_name}...")
+
         # Get all assets from zou
         all_assets = all_assets_for_project(project)
         all_episodes = all_episodes_for_project(project)
         all_seqs = all_sequences_for_project(project)
         all_shots = all_shots_for_project(project)
+        all_entities = [
+            e
+            for e in all_assets + all_episodes + all_seqs + all_shots
+            if not e["data"].get("is_substitute")
+        ]
 
         # Create project if is not available
         # - creation is required to be able set project anatomy and attributes
@@ -421,7 +429,7 @@ def sync_openpype():
                         "data": project["data"].update(
                             {
                                 "code": project["code"],
-                                "fps": project_code["fps"],
+                                "fps": project["fps"],
                                 "resolutionWidth": project["resolution"].split("x")[0],
                                 "resolutionHeight": project["resolution"].split("x")[1],
                             }
@@ -449,9 +457,8 @@ def sync_openpype():
                     "schema": "openpype:asset-3.0",
                     "data": {"zou": item, "tasks": {}},
                 }
-                for item in all_episodes + all_assets + all_seqs + all_shots
+                for item in all_entities
                 if item["id"] not in asset_doc_ids.keys()
-                and not item.get("is_substitute")
             ]
         )
         if to_insert:
@@ -468,7 +475,6 @@ def sync_openpype():
             )
 
         # Update
-        all_entities = all_assets + all_episodes + all_seqs + all_shots
         bulk_writes.extend(update_op_assets(all_entities, asset_doc_ids))
 
         # Delete

From 93fb1ac0f1331439852104189733671386366861 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 17 Feb 2022 11:12:13 +0100
Subject: [PATCH 0135/1227] Use substitutes id

---
 .../default_modules/kitsu/kitsu_module.py     | 27 +++++++++++++------
 1 file changed, 19 insertions(+), 8 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 266aaa9139..0529d38a0e 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -242,6 +242,7 @@ def sync_zou():
         )
         for doc in new_assets_docs:
             visual_parent_id = doc["data"]["visualParent"]
+            parent_substitutes = []
 
             # Match asset type by it's name
             match = regex_ep.match(doc["name"])
@@ -273,6 +274,7 @@ def sync_zou():
                     gazu.shot.update_sequence_data(
                         created_sequence, {"is_substitute": True}
                     )
+                    parent_substitutes.append(created_sequence)
 
                     # Update parent ID
                     zou_parent_id = created_sequence["id"]
@@ -310,6 +312,7 @@ def sync_zou():
                         "$set": {
                             "data.visualParent": visual_parent_id,
                             "data.zou": new_entity,
+                            "data.parent_substitutes": parent_substitutes,
                         }
                     },
                 )
@@ -494,17 +497,17 @@ def sync_openpype():
 
 
 def update_op_assets(
-    items_list: List[dict], asset_doc_ids: Dict[str, dict]
+    entities_list: List[dict], asset_doc_ids: Dict[str, dict]
 ) -> List[UpdateOne]:
     """Update OpenPype assets.
     Set 'data' and 'parent' fields.
 
-    :param items_list: List of zou items to update
+    :param entities_list: List of zou entities to update
     :param asset_doc_ids: Dicts of [{zou_id: asset_doc}, ...]
     :return: List of UpdateOne objects
     """
     bulk_writes = []
-    for item in items_list:
+    for item in entities_list:
         # Update asset
         item_doc = asset_doc_ids[item["id"]]
         item_data = item_doc["data"].copy()
@@ -523,20 +526,28 @@ def update_op_assets(
             }
 
         # Visual parent for hierarchy
-        direct_parent_id = item["parent_id"] or item["source_id"]
-        if direct_parent_id:
-            visual_parent_doc = asset_doc_ids[direct_parent_id]
+        substitute_parent_item = (
+            item_data["parent_substitutes"][0]
+            if item_data.get("parent_substitutes")
+            else None
+        )
+        parent_zou_id = item["parent_id"] or item["source_id"]
+        if substitute_parent_item:
+            parent_zou_id = (
+                substitute_parent_item["parent_id"]
+                or substitute_parent_item["source_id"]
+            )
+            visual_parent_doc = asset_doc_ids[parent_zou_id]
             item_data["visualParent"] = visual_parent_doc["_id"]
 
         # Add parents for hierarchy
-        parent_zou_id = item["parent_id"]
         item_data["parents"] = []
         while parent_zou_id is not None:
             parent_doc = asset_doc_ids[parent_zou_id]
             item_data["parents"].insert(0, parent_doc["name"])
 
             parent_zou_id = next(
-                i for i in items_list if i["id"] == parent_doc["data"]["zou"]["id"]
+                i for i in entities_list if i["id"] == parent_doc["data"]["zou"]["id"]
             )["parent_id"]
 
         # Update 'data' different in zou DB

From c058ba54c2763b4563f5912f8a8a8930cceafc1e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 22 Feb 2022 18:27:06 +0100
Subject: [PATCH 0136/1227] Project sync and code DRYing

---
 .../modules/default_modules/kitsu/__init__.py | 10 +--
 .../default_modules/kitsu/kitsu_module.py     | 52 ++++++----------
 .../default_modules/kitsu/listeners.py        | 61 +++++++++++++++++++
 .../default_modules/kitsu/utils/__init__.py   |  0
 .../default_modules/kitsu/utils/openpype.py   | 47 ++++++++++++++
 5 files changed, 128 insertions(+), 42 deletions(-)
 create mode 100644 openpype/modules/default_modules/kitsu/listeners.py
 create mode 100644 openpype/modules/default_modules/kitsu/utils/__init__.py
 create mode 100644 openpype/modules/default_modules/kitsu/utils/openpype.py

diff --git a/openpype/modules/default_modules/kitsu/__init__.py b/openpype/modules/default_modules/kitsu/__init__.py
index cd0c2ea8af..dc7c2dad50 100644
--- a/openpype/modules/default_modules/kitsu/__init__.py
+++ b/openpype/modules/default_modules/kitsu/__init__.py
@@ -4,12 +4,6 @@ If addon class or settings definition won't be here their definition won't
 be found by OpenPype discovery.
 """
 
-from .kitsu_module import (
-    AddonSettingsDef,
-    KitsuModule
-)
+from .kitsu_module import AddonSettingsDef, KitsuModule
 
-__all__ = (
-    "AddonSettingsDef",
-    "KitsuModule"
-)
+__all__ = ("AddonSettingsDef", "KitsuModule")
diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 0529d38a0e..3fddc48ee9 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -11,7 +11,6 @@ import os
 import re
 from typing import Dict, List
 
-from avalon.api import AvalonMongoDB
 import gazu
 from gazu.asset import all_assets_for_project, all_asset_types, new_asset
 from gazu.shot import (
@@ -21,7 +20,6 @@ from gazu.shot import (
     new_episode,
     new_sequence,
     new_shot,
-    update_sequence,
 )
 from gazu.task import (
     all_tasks_for_asset,
@@ -31,11 +29,15 @@ from gazu.task import (
     new_task,
     new_task_type,
 )
+from pymongo import DeleteOne, UpdateOne
+
+from avalon.api import AvalonMongoDB
 from openpype.api import get_project_settings
 from openpype.lib import create_project
 from openpype.modules import JsonFilesSettingsDef, OpenPypeModule, ModulesManager
-from pymongo import DeleteOne, UpdateOne
+from openpype.modules.default_modules.kitsu.utils.openpype import sync_project
 from openpype_interfaces import IPluginPaths, ITrayAction
+from .listeners import add_listeners
 
 
 # Settings definition of this addon using `JsonFilesSettingsDef`
@@ -371,8 +373,6 @@ def sync_zou():
         if bulk_writes:
             project_col.bulk_write(bulk_writes)
 
-    # TODO Create events daemons
-
     dbcon.uninstall()
 
 
@@ -412,35 +412,8 @@ def sync_openpype():
             if not e["data"].get("is_substitute")
         ]
 
-        # Create project if is not available
-        # - creation is required to be able set project anatomy and attributes
-        to_insert = []
-        if not project_doc:
-            print(f"Creating project '{project_name}'")
-            project_doc = create_project(project_name, project_code, dbcon=dbcon)
-
-        # Project data and tasks
-        bulk_writes.append(
-            UpdateOne(
-                {"_id": project_doc["_id"]},
-                {
-                    "$set": {
-                        "config.tasks": {
-                            t["name"]: {"short_name": t.get("short_name", t["name"])}
-                            for t in all_task_types_for_project(project)
-                        },
-                        "data": project["data"].update(
-                            {
-                                "code": project["code"],
-                                "fps": project["fps"],
-                                "resolutionWidth": project["resolution"].split("x")[0],
-                                "resolutionHeight": project["resolution"].split("x")[1],
-                            }
-                        ),
-                    }
-                },
-            )
-        )
+        # Sync project. Create if doesn't exist
+        bulk_writes.append(sync_project(project, dbcon))
 
         # Query all assets of the local project
         project_col = dbcon.database[project_code]
@@ -452,6 +425,7 @@ def sync_openpype():
         asset_doc_ids[project["id"]] = project_doc
 
         # Create
+        to_insert = []
         to_insert.extend(
             [
                 {
@@ -572,6 +546,16 @@ def update_op_assets(
     return bulk_writes
 
 
+@cli_main.command()
+def listen():
+    """Show ExampleAddon dialog.
+
+    We don't have access to addon directly through cli so we have to create
+    it again.
+    """
+    add_listeners()
+
+
 @cli_main.command()
 def show_dialog():
     """Show ExampleAddon dialog.
diff --git a/openpype/modules/default_modules/kitsu/listeners.py b/openpype/modules/default_modules/kitsu/listeners.py
new file mode 100644
index 0000000000..5303933bce
--- /dev/null
+++ b/openpype/modules/default_modules/kitsu/listeners.py
@@ -0,0 +1,61 @@
+from turtle import update
+import gazu
+import os
+
+from pymongo import DeleteOne, UpdateOne
+
+from avalon.api import AvalonMongoDB
+from openpype.modules.default_modules.kitsu.utils.openpype import sync_project
+
+
+def add_listeners():
+    # Connect to server
+    gazu.client.set_host(os.environ["KITSU_SERVER"])
+
+    # Authenticate
+    gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
+    gazu.set_event_host(os.environ["KITSU_SERVER"].replace("api", "socket.io"))
+
+    # Connect to DB
+    dbcon = AvalonMongoDB()
+    dbcon.install()
+
+    def new_project(data):
+        """Create new project into DB."""
+
+        # Use update process to avoid duplicating code
+        update_project(data)
+
+    def update_project(data):
+        """Update project into DB."""
+        # Get project entity
+        project = gazu.project.get_project(data["project_id"])
+        project_name = project["name"]
+        dbcon.Session["AVALON_PROJECT"] = project_name
+
+        update_project = sync_project(project, dbcon)
+
+        # Write into DB
+        if update_project:
+            project_col = dbcon.database[project_name]
+            project_col.bulk_write([update_project])
+
+    def delete_project(data):
+        # Get project entity
+        print(data)  # TODO check bugfix
+        project = gazu.project.get_project(data["project_id"])
+
+        # Delete project collection
+        project_col = dbcon.database[project["name"]]
+        project_col.drop()
+
+    def new_asset(data):
+        print("Asset created %s" % data)
+
+    event_client = gazu.events.init()
+    gazu.events.add_listener(event_client, "project:new", new_project)
+    gazu.events.add_listener(event_client, "project:update", update_project)
+    gazu.events.add_listener(event_client, "project:delete", delete_project)
+    gazu.events.add_listener(event_client, "asset:new", new_asset)
+    gazu.events.run_client(event_client)
+    print("ll")
diff --git a/openpype/modules/default_modules/kitsu/utils/__init__.py b/openpype/modules/default_modules/kitsu/utils/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/modules/default_modules/kitsu/utils/openpype.py b/openpype/modules/default_modules/kitsu/utils/openpype.py
new file mode 100644
index 0000000000..9e795bb8ca
--- /dev/null
+++ b/openpype/modules/default_modules/kitsu/utils/openpype.py
@@ -0,0 +1,47 @@
+import gazu
+
+from pymongo import DeleteOne, UpdateOne
+
+from avalon.api import AvalonMongoDB
+from openpype.lib import create_project
+
+
+def sync_project(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
+    """Sync project with database.
+    Create project if doesn't exist.
+
+    :param project: Gazu project
+    :param dbcon: DB to create project in
+    :return: Update instance for the project
+    """
+    project_name = project["name"]
+    project_doc = dbcon.find_one({"type": "project"})
+    if not project_doc:
+        print(f"Creating project '{project_name}'")
+        project_doc = create_project(project_name, project_name, dbcon=dbcon)
+
+    print(f"Synchronizing {project_name}...")
+
+    # Project data and tasks
+    if not project["data"]:  # Sentinel
+        project["data"] = {}
+
+    return UpdateOne(
+        {"_id": project_doc["_id"]},
+        {
+            "$set": {
+                "config.tasks": {
+                    t["name"]: {"short_name": t.get("short_name", t["name"])}
+                    for t in gazu.task.all_task_types_for_project(project)
+                },
+                "data": project["data"].update(
+                    {
+                        "code": project["code"],
+                        "fps": project["fps"],
+                        "resolutionWidth": project["resolution"].split("x")[0],
+                        "resolutionHeight": project["resolution"].split("x")[1],
+                    }
+                ),
+            }
+        },
+    )

From 0d38ccc5127bd00157aa9d19157f5d7c3ec3e20f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 23 Feb 2022 15:14:38 +0100
Subject: [PATCH 0137/1227] Listen asset and DRY

---
 .../default_modules/kitsu/kitsu_module.py     | 117 ++++--------------
 .../default_modules/kitsu/listeners.py        |  70 +++++++++--
 .../default_modules/kitsu/utils/openpype.py   | 114 +++++++++++++++++
 3 files changed, 198 insertions(+), 103 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 3fddc48ee9..0bdd4b12e6 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -22,10 +22,7 @@ from gazu.shot import (
     new_shot,
 )
 from gazu.task import (
-    all_tasks_for_asset,
-    all_tasks_for_shot,
     all_task_types,
-    all_task_types_for_project,
     new_task,
     new_task_type,
 )
@@ -33,9 +30,12 @@ from pymongo import DeleteOne, UpdateOne
 
 from avalon.api import AvalonMongoDB
 from openpype.api import get_project_settings
-from openpype.lib import create_project
 from openpype.modules import JsonFilesSettingsDef, OpenPypeModule, ModulesManager
-from openpype.modules.default_modules.kitsu.utils.openpype import sync_project
+from openpype.modules.default_modules.kitsu.utils.openpype import (
+    create_op_asset,
+    sync_project,
+    update_op_assets,
+)
 from openpype_interfaces import IPluginPaths, ITrayAction
 from .listeners import add_listeners
 
@@ -417,33 +417,28 @@ def sync_openpype():
 
         # Query all assets of the local project
         project_col = dbcon.database[project_code]
-        asset_doc_ids = {
+        zou_ids_and_asset_docs = {
             asset_doc["data"]["zou"]["id"]: asset_doc
             for asset_doc in project_col.find({"type": "asset"})
             if asset_doc["data"].get("zou", {}).get("id")
         }
-        asset_doc_ids[project["id"]] = project_doc
+        zou_ids_and_asset_docs[project["id"]] = project_doc
 
         # Create
         to_insert = []
         to_insert.extend(
             [
-                {
-                    "name": item["name"],
-                    "type": "asset",
-                    "schema": "openpype:asset-3.0",
-                    "data": {"zou": item, "tasks": {}},
-                }
+                create_op_asset(item)
                 for item in all_entities
-                if item["id"] not in asset_doc_ids.keys()
+                if item["id"] not in zou_ids_and_asset_docs.keys()
             ]
         )
         if to_insert:
-            # Insert in doc
+            # Insert doc in DB
             project_col.insert_many(to_insert)
 
             # Update existing docs
-            asset_doc_ids.update(
+            zou_ids_and_asset_docs.update(
                 {
                     asset_doc["data"]["zou"]["id"]: asset_doc
                     for asset_doc in project_col.find({"type": "asset"})
@@ -452,15 +447,23 @@ def sync_openpype():
             )
 
         # Update
-        bulk_writes.extend(update_op_assets(all_entities, asset_doc_ids))
+        bulk_writes.extend(
+            [
+                UpdateOne({"_id": id}, update)
+                for id, update in update_op_assets(all_entities, zou_ids_and_asset_docs)
+            ]
+        )
 
         # Delete
-        diff_assets = set(asset_doc_ids.keys()) - {
+        diff_assets = set(zou_ids_and_asset_docs.keys()) - {
             e["id"] for e in all_entities + [project]
         }
         if diff_assets:
             bulk_writes.extend(
-                [DeleteOne(asset_doc_ids[asset_id]) for asset_id in diff_assets]
+                [
+                    DeleteOne(zou_ids_and_asset_docs[asset_id])
+                    for asset_id in diff_assets
+                ]
             )
 
         # Write into DB
@@ -470,82 +473,6 @@ def sync_openpype():
     dbcon.uninstall()
 
 
-def update_op_assets(
-    entities_list: List[dict], asset_doc_ids: Dict[str, dict]
-) -> List[UpdateOne]:
-    """Update OpenPype assets.
-    Set 'data' and 'parent' fields.
-
-    :param entities_list: List of zou entities to update
-    :param asset_doc_ids: Dicts of [{zou_id: asset_doc}, ...]
-    :return: List of UpdateOne objects
-    """
-    bulk_writes = []
-    for item in entities_list:
-        # Update asset
-        item_doc = asset_doc_ids[item["id"]]
-        item_data = item_doc["data"].copy()
-        item_data["zou"] = item
-
-        # Tasks
-        tasks_list = None
-        if item["type"] == "Asset":
-            tasks_list = all_tasks_for_asset(item)
-        elif item["type"] == "Shot":
-            tasks_list = all_tasks_for_shot(item)
-            # TODO frame in and out
-        if tasks_list:
-            item_data["tasks"] = {
-                t["task_type_name"]: {"type": t["task_type_name"]} for t in tasks_list
-            }
-
-        # Visual parent for hierarchy
-        substitute_parent_item = (
-            item_data["parent_substitutes"][0]
-            if item_data.get("parent_substitutes")
-            else None
-        )
-        parent_zou_id = item["parent_id"] or item["source_id"]
-        if substitute_parent_item:
-            parent_zou_id = (
-                substitute_parent_item["parent_id"]
-                or substitute_parent_item["source_id"]
-            )
-            visual_parent_doc = asset_doc_ids[parent_zou_id]
-            item_data["visualParent"] = visual_parent_doc["_id"]
-
-        # Add parents for hierarchy
-        item_data["parents"] = []
-        while parent_zou_id is not None:
-            parent_doc = asset_doc_ids[parent_zou_id]
-            item_data["parents"].insert(0, parent_doc["name"])
-
-            parent_zou_id = next(
-                i for i in entities_list if i["id"] == parent_doc["data"]["zou"]["id"]
-            )["parent_id"]
-
-        # Update 'data' different in zou DB
-        updated_data = {
-            k: item_data[k]
-            for k in item_data.keys()
-            if item_doc["data"].get(k) != item_data[k]
-        }
-        if updated_data or not item_doc.get("parent"):
-            bulk_writes.append(
-                UpdateOne(
-                    {"_id": item_doc["_id"]},
-                    {
-                        "$set": {
-                            "data": item_data,
-                            "parent": asset_doc_ids[item["project_id"]]["_id"],
-                        }
-                    },
-                )
-            )
-
-    return bulk_writes
-
-
 @cli_main.command()
 def listen():
     """Show ExampleAddon dialog.
diff --git a/openpype/modules/default_modules/kitsu/listeners.py b/openpype/modules/default_modules/kitsu/listeners.py
index 5303933bce..fd4cf6dd3d 100644
--- a/openpype/modules/default_modules/kitsu/listeners.py
+++ b/openpype/modules/default_modules/kitsu/listeners.py
@@ -5,7 +5,12 @@ import os
 from pymongo import DeleteOne, UpdateOne
 
 from avalon.api import AvalonMongoDB
-from openpype.modules.default_modules.kitsu.utils.openpype import sync_project
+from openpype.modules.default_modules.kitsu.utils.openpype import (
+    create_op_asset,
+    set_op_project,
+    sync_project,
+    update_op_assets,
+)
 
 
 def add_listeners():
@@ -15,19 +20,22 @@ def add_listeners():
     # Authenticate
     gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
     gazu.set_event_host(os.environ["KITSU_SERVER"].replace("api", "socket.io"))
+    event_client = gazu.events.init()
 
     # Connect to DB
     dbcon = AvalonMongoDB()
     dbcon.install()
 
+    # == Project ==
+
     def new_project(data):
-        """Create new project into DB."""
+        """Create new project into OP DB."""
 
         # Use update process to avoid duplicating code
         update_project(data)
 
     def update_project(data):
-        """Update project into DB."""
+        """Update project into OP DB."""
         # Get project entity
         project = gazu.project.get_project(data["project_id"])
         project_name = project["name"]
@@ -41,6 +49,7 @@ def add_listeners():
             project_col.bulk_write([update_project])
 
     def delete_project(data):
+        """Delete project."""
         # Get project entity
         print(data)  # TODO check bugfix
         project = gazu.project.get_project(data["project_id"])
@@ -49,13 +58,58 @@ def add_listeners():
         project_col = dbcon.database[project["name"]]
         project_col.drop()
 
-    def new_asset(data):
-        print("Asset created %s" % data)
-
-    event_client = gazu.events.init()
     gazu.events.add_listener(event_client, "project:new", new_project)
     gazu.events.add_listener(event_client, "project:update", update_project)
     gazu.events.add_listener(event_client, "project:delete", delete_project)
+
+    # == Asset ==
+
+    def new_asset(data):
+        """Create new asset into OP DB."""
+        # Get project entity
+        project_col = set_op_project(dbcon, data["project_id"])
+
+        # Get gazu entity
+        asset = gazu.asset.get_asset(data["asset_id"])
+
+        # Insert doc in DB
+        project_col.insert_one(create_op_asset(asset))
+
+        # Update
+        update_asset(data)
+
+    def update_asset(data):
+        """Update asset into OP DB."""
+        project_col = set_op_project(dbcon, data["project_id"])
+        project_doc = dbcon.find_one({"type": "project"})
+
+        # Get gazu entity
+        asset = gazu.asset.get_asset(data["asset_id"])
+
+        # Find asset doc
+        # Query all assets of the local project
+        zou_ids_and_asset_docs = {
+            asset_doc["data"]["zou"]["id"]: asset_doc
+            for asset_doc in project_col.find({"type": "asset"})
+            if asset_doc["data"].get("zou", {}).get("id")
+        }
+        zou_ids_and_asset_docs[asset["project_id"]] = project_doc
+
+        # Update
+        asset_doc_id, asset_update = update_op_assets([asset], zou_ids_and_asset_docs)[
+            0
+        ]
+        project_col.update_one({"_id": asset_doc_id}, asset_update)
+
+    def delete_asset(data):
+        """Delete asset of OP DB."""
+        project_col = set_op_project(dbcon, data["project_id"])
+
+        # Delete
+        project_col.delete_one({"type": "asset", "data.zou.id": data["asset_id"]})
+
     gazu.events.add_listener(event_client, "asset:new", new_asset)
+    gazu.events.add_listener(event_client, "asset:update", update_asset)
+    gazu.events.add_listener(event_client, "asset:delete", delete_asset)
+
     gazu.events.run_client(event_client)
-    print("ll")
diff --git a/openpype/modules/default_modules/kitsu/utils/openpype.py b/openpype/modules/default_modules/kitsu/utils/openpype.py
index 9e795bb8ca..8ef987898d 100644
--- a/openpype/modules/default_modules/kitsu/utils/openpype.py
+++ b/openpype/modules/default_modules/kitsu/utils/openpype.py
@@ -1,11 +1,125 @@
+from typing import Dict, List
 import gazu
 
 from pymongo import DeleteOne, UpdateOne
+from pymongo.collection import Collection
+
+from gazu.task import (
+    all_tasks_for_asset,
+    all_tasks_for_shot,
+)
 
 from avalon.api import AvalonMongoDB
 from openpype.lib import create_project
 
 
+def create_op_asset(gazu_entity: dict) -> dict:
+    """Create OP asset dict from gazu entity.
+
+    :param gazu_entity:
+    """
+    return {
+        "name": gazu_entity["name"],
+        "type": "asset",
+        "schema": "openpype:asset-3.0",
+        "data": {"zou": gazu_entity, "tasks": {}},
+    }
+
+
+def set_op_project(dbcon, project_id) -> Collection:
+    """Set project context.
+
+    :param dbcon: Connection to DB.
+    :param project_id: Project zou ID
+    """
+    project = gazu.project.get_project(project_id)
+    project_name = project["name"]
+    dbcon.Session["AVALON_PROJECT"] = project_name
+
+    return dbcon.database[project_name]
+
+
+def update_op_assets(
+    entities_list: List[dict], asset_doc_ids: Dict[str, dict]
+) -> List[Dict[str, dict]]:
+    """Update OpenPype assets.
+    Set 'data' and 'parent' fields.
+
+    :param entities_list: List of zou entities to update
+    :param asset_doc_ids: Dicts of [{zou_id: asset_doc}, ...]
+    :return: List of (doc_id, update_dict) tuples
+    """
+    assets_with_update = []
+    for item in entities_list:
+        # Update asset
+        item_doc = asset_doc_ids[item["id"]]
+        item_data = item_doc["data"].copy()
+        item_data["zou"] = item
+
+        # Tasks
+        tasks_list = []
+        if item["type"] == "Asset":
+            tasks_list = all_tasks_for_asset(item)
+        elif item["type"] == "Shot":
+            tasks_list = all_tasks_for_shot(item)
+            # TODO frame in and out
+        item_data["tasks"] = {
+            t["task_type_name"]: {"type": t["task_type_name"]} for t in tasks_list
+        }
+
+        # Get zou parent id for correct hierarchy
+        # Use parent substitutes if existing
+        substitute_parent_item = (
+            item_data["parent_substitutes"][0]
+            if item_data.get("parent_substitutes")
+            else None
+        )
+        if substitute_parent_item:
+            parent_zou_id = substitute_parent_item["id"]
+        else:
+            parent_zou_id = (
+                item.get("parent_id") or item.get("episode_id") or item.get("source_id")
+            )  # TODO check consistency
+
+        # Visual parent for hierarchy
+        visual_parent_doc_id = (
+            asset_doc_ids[parent_zou_id]["_id"] if parent_zou_id else None
+        )
+        item_data["visualParent"] = visual_parent_doc_id
+
+        # Add parents for hierarchy
+        item_data["parents"] = []
+        while parent_zou_id is not None:
+            parent_doc = asset_doc_ids[parent_zou_id]
+            item_data["parents"].insert(0, parent_doc["name"])
+
+            # Get parent entity
+            parent_entity = parent_doc["data"]["zou"]
+            parent_zou_id = parent_entity["parent_id"]
+
+        # Update 'data' different in zou DB
+        updated_data = {
+            k: item_data[k]
+            for k in item_data.keys()
+            if item_doc["data"].get(k) != item_data[k]
+        }
+        if updated_data or not item_doc.get("parent"):
+            assets_with_update.append(
+                (
+                    item_doc["_id"],
+                    {
+                        "$set": {
+                            "name": item["name"],
+                            "data": item_data,
+                            "parent": asset_doc_ids[item["project_id"]]["_id"],
+                        }
+                    },
+                )
+            )
+
+    return assets_with_update
+
+
 def sync_project(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
     """Sync project with database.
     Create project if doesn't exist.

From fe5486886712a77cd40f37cac6ec41d329c17748 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 23 Feb 2022 17:04:21 +0100
Subject: [PATCH 0138/1227] Listen Episode, Sequence and Shot

---
 .../default_modules/kitsu/listeners.py        | 147 ++++++++++++++++++
 .../default_modules/kitsu/utils/openpype.py   |   2 +-
 2 files changed, 148 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/default_modules/kitsu/listeners.py b/openpype/modules/default_modules/kitsu/listeners.py
index fd4cf6dd3d..bb217452df 100644
--- a/openpype/modules/default_modules/kitsu/listeners.py
+++ b/openpype/modules/default_modules/kitsu/listeners.py
@@ -112,4 +112,151 @@ def add_listeners():
     gazu.events.add_listener(event_client, "asset:update", update_asset)
     gazu.events.add_listener(event_client, "asset:delete", delete_asset)
 
+    # == Episode ==
+    def new_episode(data):
+        """Create new episode into OP DB."""
+        # Get project entity
+        project_col = set_op_project(dbcon, data["project_id"])
+
+        # Get gazu entity
+        episode = gazu.shot.get_episode(data["episode_id"])
+
+        # Insert doc in DB
+        project_col.insert_one(create_op_asset(episode))
+
+        # Update
+        update_episode(data)
+
+    def update_episode(data):
+        """Update episode into OP DB."""
+        project_col = set_op_project(dbcon, data["project_id"])
+        project_doc = dbcon.find_one({"type": "project"})
+
+        # Get gazu entity
+        episode = gazu.shot.get_episode(data["episode_id"])
+
+        # Find asset doc
+        # Query all assets of the local project
+        zou_ids_and_asset_docs = {
+            asset_doc["data"]["zou"]["id"]: asset_doc
+            for asset_doc in project_col.find({"type": "asset"})
+            if asset_doc["data"].get("zou", {}).get("id")
+        }
+        zou_ids_and_asset_docs[episode["project_id"]] = project_doc
+
+        # Update
+        asset_doc_id, asset_update = update_op_assets(
+            [episode], zou_ids_and_asset_docs
+        )[0]
+        project_col.update_one({"_id": asset_doc_id}, asset_update)
+
+    def delete_episode(data):
+        """Delete shot of OP DB."""
+        project_col = set_op_project(dbcon, data["project_id"])
+        print("delete episode")  # TODO check bugfix
+
+        # Delete
+        project_col.delete_one({"type": "asset", "data.zou.id": data["episode_id"]})
+
+    gazu.events.add_listener(event_client, "episode:new", new_episode)
+    gazu.events.add_listener(event_client, "episode:update", update_episode)
+    gazu.events.add_listener(event_client, "episode:delete", delete_episode)
+
+    # == Sequence ==
+    def new_sequence(data):
+        """Create new sequnce into OP DB."""
+        # Get project entity
+        project_col = set_op_project(dbcon, data["project_id"])
+
+        # Get gazu entity
+        sequence = gazu.shot.get_sequence(data["sequence_id"])
+
+        # Insert doc in DB
+        project_col.insert_one(create_op_asset(sequence))
+
+        # Update
+        update_sequence(data)
+
+    def update_sequence(data):
+        """Update sequence into OP DB."""
+        project_col = set_op_project(dbcon, data["project_id"])
+        project_doc = dbcon.find_one({"type": "project"})
+
+        # Get gazu entity
+        sequence = gazu.shot.get_sequence(data["sequence_id"])
+
+        # Find asset doc
+        # Query all assets of the local project
+        zou_ids_and_asset_docs = {
+            asset_doc["data"]["zou"]["id"]: asset_doc
+            for asset_doc in project_col.find({"type": "asset"})
+            if asset_doc["data"].get("zou", {}).get("id")
+        }
+        zou_ids_and_asset_docs[sequence["project_id"]] = project_doc
+
+        # Update
+        asset_doc_id, asset_update = update_op_assets(
+            [sequence], zou_ids_and_asset_docs
+        )[0]
+        project_col.update_one({"_id": asset_doc_id}, asset_update)
+
+    def delete_sequence(data):
+        """Delete sequence of OP DB."""
+        project_col = set_op_project(dbcon, data["project_id"])
+        print("delete sequence")  # TODO check bugfix
+
+        # Delete
+        project_col.delete_one({"type": "asset", "data.zou.id": data["sequence_id"]})
+
+    gazu.events.add_listener(event_client, "sequence:new", new_sequence)
+    gazu.events.add_listener(event_client, "sequence:update", update_sequence)
+    gazu.events.add_listener(event_client, "sequence:delete", delete_sequence)
+
+    # == Shot ==
+    def new_shot(data):
+        """Create new shot into OP DB."""
+        # Get project entity
+        project_col = set_op_project(dbcon, data["project_id"])
+
+        # Get gazu entity
+        shot = gazu.shot.get_shot(data["shot_id"])
+
+        # Insert doc in DB
+        project_col.insert_one(create_op_asset(shot))
+
+        # Update
+        update_shot(data)
+
+    def update_shot(data):
+        """Update shot into OP DB."""
+        project_col = set_op_project(dbcon, data["project_id"])
+        project_doc = dbcon.find_one({"type": "project"})
+
+        # Get gazu entity
+        shot = gazu.shot.get_shot(data["shot_id"])
+
+        # Find asset doc
+        # Query all assets of the local project
+        zou_ids_and_asset_docs = {
+            asset_doc["data"]["zou"]["id"]: asset_doc
+            for asset_doc in project_col.find({"type": "asset"})
+            if asset_doc["data"].get("zou", {}).get("id")
+        }
+        zou_ids_and_asset_docs[shot["project_id"]] = project_doc
+
+        # Update
+        asset_doc_id, asset_update = update_op_assets([shot], zou_ids_and_asset_docs)[0]
+        project_col.update_one({"_id": asset_doc_id}, asset_update)
+
+    def delete_shot(data):
+        """Delete shot of OP DB."""
+        project_col = set_op_project(dbcon, data["project_id"])
+
+        # Delete
+        project_col.delete_one({"type": "asset", "data.zou.id": data["shot_id"]})
+
+    gazu.events.add_listener(event_client, "shot:new", new_shot)
+    gazu.events.add_listener(event_client, "shot:update", update_shot)
+    gazu.events.add_listener(event_client, "shot:delete", delete_shot)
+
     gazu.events.run_client(event_client)
diff --git a/openpype/modules/default_modules/kitsu/utils/openpype.py b/openpype/modules/default_modules/kitsu/utils/openpype.py
index 8ef987898d..809748fa78 100644
--- a/openpype/modules/default_modules/kitsu/utils/openpype.py
+++ b/openpype/modules/default_modules/kitsu/utils/openpype.py
@@ -75,7 +75,7 @@ def update_op_assets(
             else None
         )
         if substitute_parent_item:
-            parent_zou_id = substitute_parent_item["id"]
+            parent_zou_id = substitute_parent_item["parent_id"]
         else:
             parent_zou_id = (
                 item.get("parent_id") or item.get("episode_id") or item.get("source_id")

From de153a0450d9cbdcf9229775fa8fa9afa94eef79 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 24 Feb 2022 15:53:03 +0100
Subject: [PATCH 0139/1227] Listen tasks, clean code

---
 .../default_modules/kitsu/kitsu_module.py     |  1 -
 .../default_modules/kitsu/listeners.py        | 55 ++++++++++++++++++-
 .../default_modules/kitsu/utils/openpype.py   |  2 +-
 3 files changed, 53 insertions(+), 5 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 0bdd4b12e6..10cbe76db2 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -9,7 +9,6 @@ in global space here until are required or used.
 import click
 import os
 import re
-from typing import Dict, List
 
 import gazu
 from gazu.asset import all_assets_for_project, all_asset_types, new_asset
diff --git a/openpype/modules/default_modules/kitsu/listeners.py b/openpype/modules/default_modules/kitsu/listeners.py
index bb217452df..16c4e0e69e 100644
--- a/openpype/modules/default_modules/kitsu/listeners.py
+++ b/openpype/modules/default_modules/kitsu/listeners.py
@@ -1,9 +1,6 @@
-from turtle import update
 import gazu
 import os
 
-from pymongo import DeleteOne, UpdateOne
-
 from avalon.api import AvalonMongoDB
 from openpype.modules.default_modules.kitsu.utils.openpype import (
     create_op_asset,
@@ -259,4 +256,56 @@ def add_listeners():
     gazu.events.add_listener(event_client, "shot:update", update_shot)
     gazu.events.add_listener(event_client, "shot:delete", delete_shot)
 
+    # == Task ==
+    def new_task(data):
+        """Create new task into OP DB."""
+        print("new", data)
+        # Get project entity
+        project_col = set_op_project(dbcon, data["project_id"])
+
+        # Get gazu entity
+        task = gazu.task.get_task(data["task_id"])
+
+        # Find asset doc
+        asset_doc = project_col.find_one(
+            {"type": "asset", "data.zou.id": task["entity"]["id"]}
+        )
+
+        # Update asset tasks with new one
+        asset_tasks = asset_doc["data"].get("tasks")
+        task_type_name = task["task_type"]["name"]
+        asset_tasks[task_type_name] = {"type": task_type_name, "zou": task}
+        project_col.update_one(
+            {"_id": asset_doc["_id"]}, {"$set": {"data.tasks": asset_tasks}}
+        )
+
+    def update_task(data):
+        """Update task into OP DB."""
+        # TODO is it necessary?
+        pass
+
+    def delete_task(data):
+        """Delete task of OP DB."""
+        project_col = set_op_project(dbcon, data["project_id"])
+
+        # Find asset doc
+        asset_docs = [doc for doc in project_col.find({"type": "asset"})]
+        for doc in asset_docs:
+            # Match task
+            for name, task in doc["data"]["tasks"].items():
+                if task.get("zou") and data["task_id"] == task["zou"]["id"]:
+                    # Pop task
+                    asset_tasks = doc["data"].get("tasks")
+                    asset_tasks.pop(name)
+
+                    # Delete task in DB
+                    project_col.update_one(
+                        {"_id": doc["_id"]}, {"$set": {"data.tasks": asset_tasks}}
+                    )
+                    return
+
+    gazu.events.add_listener(event_client, "task:new", new_task)
+    gazu.events.add_listener(event_client, "task:update", update_task)
+    gazu.events.add_listener(event_client, "task:delete", delete_task)
+
     gazu.events.run_client(event_client)
diff --git a/openpype/modules/default_modules/kitsu/utils/openpype.py b/openpype/modules/default_modules/kitsu/utils/openpype.py
index 809748fa78..edcf233ea8 100644
--- a/openpype/modules/default_modules/kitsu/utils/openpype.py
+++ b/openpype/modules/default_modules/kitsu/utils/openpype.py
@@ -1,7 +1,7 @@
 from typing import Dict, List
 import gazu
 
-from pymongo import DeleteOne, UpdateOne
+from pymongo import UpdateOne
 from pymongo.collection import Collection
 
 from gazu.task import (

From 6cf38e1a35ba73a5df64969befb71728ffec4813 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Fri, 25 Feb 2022 16:23:14 +0100
Subject: [PATCH 0140/1227] Publish comment to kitsu

---
 .../default_modules/kitsu/kitsu_module.py     |  2 +-
 .../kitsu/plugins/publish/example_plugin.py   | 40 +++++++++++++++++++
 .../default_modules/kitsu/utils/openpype.py   | 24 +++++------
 3 files changed, 53 insertions(+), 13 deletions(-)

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index 10cbe76db2..f62a86f04d 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -408,7 +408,7 @@ def sync_openpype():
         all_entities = [
             e
             for e in all_assets + all_episodes + all_seqs + all_shots
-            if not e["data"].get("is_substitute")
+            if e["data"] and not e["data"].get("is_substitute")
         ]
 
         # Sync project. Create if doesn't exist
diff --git a/openpype/modules/default_modules/kitsu/plugins/publish/example_plugin.py b/openpype/modules/default_modules/kitsu/plugins/publish/example_plugin.py
index 61602f4e78..614d9ecc38 100644
--- a/openpype/modules/default_modules/kitsu/plugins/publish/example_plugin.py
+++ b/openpype/modules/default_modules/kitsu/plugins/publish/example_plugin.py
@@ -1,9 +1,49 @@
+import os
+
+import gazu
+
 import pyblish.api
 
+import debugpy
+
 
 class CollectExampleAddon(pyblish.api.ContextPlugin):
     order = pyblish.api.CollectorOrder + 0.4
     label = "Collect Kitsu"
 
     def process(self, context):
+        debugpy.breakpoint()
         self.log.info("I'm in Kitsu's plugin!")
+
+
+class IntegrateRig(pyblish.api.InstancePlugin):
+    """Copy files to an appropriate location where others may reach it"""
+
+    order = pyblish.api.IntegratorOrder
+    families = ["model"]
+
+    def process(self, instance):
+        print(instance.data["version"])
+
+        # Connect to server
+        gazu.client.set_host(os.environ["KITSU_SERVER"])
+
+        # Authenticate
+        gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
+
+        asset_data = instance.data["assetEntity"]["data"]
+
+        # TODO Set local settings for login and password
+
+        # Get task
+        task_type = gazu.task.get_task_type_by_name(instance.data["task"])
+        entity_task = gazu.task.get_task_by_entity(asset_data["zou"], task_type)
+
+        # Comment entity
+        gazu.task.add_comment(
+            entity_task,
+            entity_task["task_status_id"],
+            comment=f"Version {instance.data['version']} has been published!",
+        )
+
+        self.log.info("Copied successfully!")
diff --git a/openpype/modules/default_modules/kitsu/utils/openpype.py b/openpype/modules/default_modules/kitsu/utils/openpype.py
index edcf233ea8..518872a71c 100644
--- a/openpype/modules/default_modules/kitsu/utils/openpype.py
+++ b/openpype/modules/default_modules/kitsu/utils/openpype.py
@@ -134,11 +134,18 @@ def sync_project(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
         print(f"Creating project '{project_name}'")
         project_doc = create_project(project_name, project_name, dbcon=dbcon)
 
-    print(f"Synchronizing {project_name}...")
-
     # Project data and tasks
-    if not project["data"]:  # Sentinel
-        project["data"] = {}
+    project_data = project["data"] or {}
+
+    # Update data
+    project_data.update(
+        {
+            "code": project["code"],
+            "fps": project["fps"],
+            "resolutionWidth": project["resolution"].split("x")[0],
+            "resolutionHeight": project["resolution"].split("x")[1],
+        }
+    )
 
     return UpdateOne(
         {"_id": project_doc["_id"]},
@@ -148,14 +155,7 @@ def sync_project(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
                     t["name"]: {"short_name": t.get("short_name", t["name"])}
                     for t in gazu.task.all_task_types_for_project(project)
                 },
-                "data": project["data"].update(
-                    {
-                        "code": project["code"],
-                        "fps": project["fps"],
-                        "resolutionWidth": project["resolution"].split("x")[0],
-                        "resolutionHeight": project["resolution"].split("x")[1],
-                    }
-                ),
+                "data": project_data,
             }
         },
     )

From cb01f8338c3b651897d626479a1a1bd306a7e05f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 1 Mar 2022 17:56:08 +0100
Subject: [PATCH 0141/1227] Sign in dialog, credentials as local setting and
 cleaning

---
 .../default_modules/kitsu/kitsu_module.py     |  72 +++----
 .../default_modules/kitsu/kitsu_widgets.py    | 193 ++++++++++++++++++
 .../{example_plugin.py => kitsu_plugin.py}    |   8 +-
 .../schemas/project_schemas/main.json         |  30 ---
 .../schemas/project_schemas/the_template.json |  30 ---
 .../kitsu/{ => utils}/listeners.py            |   2 +-
 .../modules/default_modules/kitsu/widgets.py  |  31 ---
 .../defaults/system_settings/modules.json     |   4 +-
 .../module_settings/schema_kitsu.json         |  10 -
 pyproject.toml                                |   3 +-
 10 files changed, 224 insertions(+), 159 deletions(-)
 create mode 100644 openpype/modules/default_modules/kitsu/kitsu_widgets.py
 rename openpype/modules/default_modules/kitsu/plugins/publish/{example_plugin.py => kitsu_plugin.py} (85%)
 delete mode 100644 openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/main.json
 delete mode 100644 openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/the_template.json
 rename openpype/modules/default_modules/kitsu/{ => utils}/listeners.py (99%)
 delete mode 100644 openpype/modules/default_modules/kitsu/widgets.py

diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/default_modules/kitsu/kitsu_module.py
index f62a86f04d..51ab8aaa42 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/default_modules/kitsu/kitsu_module.py
@@ -1,11 +1,5 @@
-"""Addon definition is located here.
+"""Kitsu module."""
 
-Import of python packages that may not be available should not be imported
-in global space here until are required or used.
-- Qt related imports
-- imports of Python 3 packages
-    - we still support Python 2 hosts where addon definition should available
-"""
 import click
 import os
 import re
@@ -35,20 +29,12 @@ from openpype.modules.default_modules.kitsu.utils.openpype import (
     sync_project,
     update_op_assets,
 )
+from openpype.settings.lib import get_local_settings
 from openpype_interfaces import IPluginPaths, ITrayAction
-from .listeners import add_listeners
+from .utils.listeners import start_listeners
 
 
-# Settings definition of this addon using `JsonFilesSettingsDef`
-# - JsonFilesSettingsDef is prepared settings definition using json files
-#   to define settings and store default values
 class AddonSettingsDef(JsonFilesSettingsDef):
-    # This will add prefixes to every schema and template from `schemas`
-    #   subfolder.
-    # - it is not required to fill the prefix but it is highly
-    #   recommended as schemas and templates may have name clashes across
-    #   multiple addons
-    # - it is also recommended that prefix has addon name in it
     schema_prefix = "kitsu"
 
     def get_settings_root_path(self):
@@ -61,20 +47,15 @@ class AddonSettingsDef(JsonFilesSettingsDef):
 
 
 class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
-    """This Addon has defined it's settings and interface.
-
-    This example has system settings with an enabled option. And use
-    few other interfaces:
-    - `IPluginPaths` to define custom plugin paths
-    - `ITrayAction` to be shown in tray tool
-    """
+    """Kitsu module class."""
 
     label = "Kitsu"
     name = "kitsu"
 
     def initialize(self, settings):
-        """Initialization of addon."""
+        """Initialization of module."""
         module_settings = settings[self.name]
+        local_kitsu_settings = get_local_settings().get("kitsu", {})
 
         # Enabled by settings
         self.enabled = module_settings.get("enabled", False)
@@ -93,8 +74,8 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
         self.server_url = kitsu_url
 
         # Set credentials
-        self.script_login = module_settings["script_login"]
-        self.script_pwd = module_settings["script_pwd"]
+        self.kitsu_login = local_kitsu_settings["login"]
+        self.kitsu_password = local_kitsu_settings["password"]
 
         # Prepare variables that can be used or set afterwards
         self._connected_modules = None
@@ -113,8 +94,8 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
         """Kitsu's global environments."""
         return {
             "KITSU_SERVER": self.server_url,
-            "KITSU_LOGIN": self.script_login,
-            "KITSU_PWD": self.script_pwd,
+            "KITSU_LOGIN": self.kitsu_login,
+            "KITSU_PWD": self.kitsu_password,
         }
 
     def _create_dialog(self):
@@ -122,9 +103,9 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
         if self._dialog is not None:
             return
 
-        from .widgets import MyExampleDialog
+        from .kitsu_widgets import PasswordDialog
 
-        self._dialog = MyExampleDialog()
+        self._dialog = PasswordDialog()
 
     def show_dialog(self):
         """Show dialog with connected modules.
@@ -376,7 +357,10 @@ def sync_zou():
 
 
 @cli_main.command()
-def sync_openpype():
+@click.option(
+    "-l", "--listen", is_flag=True, help="Listen Kitsu server after synchronization."
+)
+def sync_openpype(listen: bool):
     """Synchronize openpype database from Zou sever database."""
 
     # Connect to server
@@ -471,27 +455,23 @@ def sync_openpype():
 
     dbcon.uninstall()
 
+    # Run listening
+    if listen:
+        start_listeners()
+
 
 @cli_main.command()
 def listen():
-    """Show ExampleAddon dialog.
-
-    We don't have access to addon directly through cli so we have to create
-    it again.
-    """
-    add_listeners()
+    """Listen to Kitsu server."""
+    start_listeners()
 
 
 @cli_main.command()
-def show_dialog():
-    """Show ExampleAddon dialog.
-
-    We don't have access to addon directly through cli so we have to create
-    it again.
-    """
+def sign_in():
+    """Show credentials dialog."""
     from openpype.tools.utils.lib import qt_app_context
 
     manager = ModulesManager()
-    example_addon = manager.modules_by_name[KitsuModule.name]
+    kitsu_addon = manager.modules_by_name[KitsuModule.name]
     with qt_app_context():
-        example_addon.show_dialog()
+        kitsu_addon.show_dialog()
diff --git a/openpype/modules/default_modules/kitsu/kitsu_widgets.py b/openpype/modules/default_modules/kitsu/kitsu_widgets.py
new file mode 100644
index 0000000000..6bd436f460
--- /dev/null
+++ b/openpype/modules/default_modules/kitsu/kitsu_widgets.py
@@ -0,0 +1,193 @@
+import os
+
+import gazu
+from Qt import QtWidgets, QtCore, QtGui
+
+from openpype import style
+from openpype.resources import get_resource
+from openpype.settings.lib import (
+    get_local_settings,
+    get_system_settings,
+    save_local_settings,
+)
+
+from openpype.widgets.password_dialog import PressHoverButton
+
+
+class PasswordDialog(QtWidgets.QDialog):
+    """Stupidly simple dialog to compare password from general settings."""
+
+    finished = QtCore.Signal(bool)
+
+    def __init__(self, parent=None):
+        super(PasswordDialog, self).__init__(parent)
+
+        self.setWindowTitle("Kitsu Credentials")
+        self.resize(300, 120)
+
+        system_settings = get_system_settings()
+        kitsu_settings = get_local_settings().get("kitsu", {})
+        remembered = kitsu_settings.get("remember")
+
+        self._final_result = None
+        self._connectable = bool(
+            system_settings["modules"].get("kitsu", {}).get("server")
+        )
+
+        # Server label
+        server_label = QtWidgets.QLabel(
+            f"Server: {system_settings['modules']['kitsu']['server'] if self._connectable else 'no server url set in Studio Settings...'}",
+            self,
+        )
+
+        # Login input
+        login_widget = QtWidgets.QWidget(self)
+
+        login_label = QtWidgets.QLabel("Login:", login_widget)
+
+        login_input = QtWidgets.QLineEdit(
+            login_widget, text=kitsu_settings.get("login") if remembered else None
+        )
+        login_input.setPlaceholderText("Your Kitsu account login...")
+
+        login_layout = QtWidgets.QHBoxLayout(login_widget)
+        login_layout.setContentsMargins(0, 0, 0, 0)
+        login_layout.addWidget(login_label)
+        login_layout.addWidget(login_input)
+
+        # Password input
+        password_widget = QtWidgets.QWidget(self)
+
+        password_label = QtWidgets.QLabel("Password:", password_widget)
+
+        password_input = QtWidgets.QLineEdit(
+            password_widget, text=kitsu_settings.get("password") if remembered else None
+        )
+        password_input.setPlaceholderText("Your password...")
+        password_input.setEchoMode(QtWidgets.QLineEdit.Password)
+
+        show_password_icon_path = get_resource("icons", "eye.png")
+        show_password_icon = QtGui.QIcon(show_password_icon_path)
+        show_password_btn = PressHoverButton(password_widget)
+        show_password_btn.setObjectName("PasswordBtn")
+        show_password_btn.setIcon(show_password_icon)
+        show_password_btn.setFocusPolicy(QtCore.Qt.ClickFocus)
+
+        password_layout = QtWidgets.QHBoxLayout(password_widget)
+        password_layout.setContentsMargins(0, 0, 0, 0)
+        password_layout.addWidget(password_label)
+        password_layout.addWidget(password_input)
+        password_layout.addWidget(show_password_btn)
+
+        # Message label
+        message_label = QtWidgets.QLabel("", self)
+
+        # Buttons
+        buttons_widget = QtWidgets.QWidget(self)
+
+        remember_checkbox = QtWidgets.QCheckBox("Remember", buttons_widget)
+        remember_checkbox.setObjectName("RememberCheckbox")
+        remember_checkbox.setChecked(remembered if remembered is not None else True)
+
+        ok_btn = QtWidgets.QPushButton("Ok", buttons_widget)
+        cancel_btn = QtWidgets.QPushButton("Cancel", buttons_widget)
+
+        buttons_layout = QtWidgets.QHBoxLayout(buttons_widget)
+        buttons_layout.setContentsMargins(0, 0, 0, 0)
+        buttons_layout.addWidget(remember_checkbox)
+        buttons_layout.addStretch(1)
+        buttons_layout.addWidget(ok_btn)
+        buttons_layout.addWidget(cancel_btn)
+
+        # Main layout
+        layout = QtWidgets.QVBoxLayout(self)
+        layout.addSpacing(5)
+        layout.addWidget(server_label, 0)
+        layout.addSpacing(5)
+        layout.addWidget(login_widget, 0)
+        layout.addWidget(password_widget, 0)
+        layout.addWidget(message_label, 0)
+        layout.addStretch(1)
+        layout.addWidget(buttons_widget, 0)
+
+        ok_btn.clicked.connect(self._on_ok_click)
+        cancel_btn.clicked.connect(self._on_cancel_click)
+        show_password_btn.change_state.connect(self._on_show_password)
+
+        self.login_input = login_input
+        self.password_input = password_input
+        self.remember_checkbox = remember_checkbox
+        self.message_label = message_label
+
+        self.setStyleSheet(style.load_stylesheet())
+
+    def result(self):
+        return self._final_result
+
+    def keyPressEvent(self, event):
+        if event.key() in (QtCore.Qt.Key_Return, QtCore.Qt.Key_Enter):
+            self._on_ok_click()
+            return event.accept()
+        super(PasswordDialog, self).keyPressEvent(event)
+
+    def closeEvent(self, event):
+        super(PasswordDialog, self).closeEvent(event)
+        self.finished.emit(self.result())
+
+    def _on_ok_click(self):
+        # Check if is connectable
+        if not self._connectable:
+            self.message_label.setText("Please set server url in Studio Settings!")
+            return
+
+        # Collect values
+        login_value = self.login_input.text()
+        pwd_value = self.password_input.text()
+        remember = self.remember_checkbox.isChecked()
+
+        # Connect to server
+        gazu.client.set_host(os.environ["KITSU_SERVER"])
+
+        # Authenticate
+        gazu.log_in(login_value, pwd_value)
+
+        # Set logging-in env vars
+        os.environ["KITSU_LOGIN"] = login_value
+        os.environ["KITSU_PWD"] = pwd_value
+
+        # Get settings
+        local_settings = get_local_settings()
+        local_settings.setdefault("kitsu", {})
+
+        # Remember password cases
+        if remember:
+            # Set local settings
+            local_settings["kitsu"]["login"] = login_value
+            local_settings["kitsu"]["password"] = pwd_value
+        else:
+            # Clear local settings
+            local_settings["kitsu"]["login"] = None
+            local_settings["kitsu"]["password"] = None
+
+            # Clear input fields
+            self.login_input.clear()
+            self.password_input.clear()
+
+        # Keep 'remember' parameter
+        local_settings["kitsu"]["remember"] = remember
+
+        # Save settings
+        save_local_settings(local_settings)
+
+        self._final_result = True
+        self.close()
+
+    def _on_show_password(self, show_password):
+        if show_password:
+            echo_mode = QtWidgets.QLineEdit.Normal
+        else:
+            echo_mode = QtWidgets.QLineEdit.Password
+        self.password_input.setEchoMode(echo_mode)
+
+    def _on_cancel_click(self):
+        self.close()
diff --git a/openpype/modules/default_modules/kitsu/plugins/publish/example_plugin.py b/openpype/modules/default_modules/kitsu/plugins/publish/kitsu_plugin.py
similarity index 85%
rename from openpype/modules/default_modules/kitsu/plugins/publish/example_plugin.py
rename to openpype/modules/default_modules/kitsu/plugins/publish/kitsu_plugin.py
index 614d9ecc38..86ba40a5f4 100644
--- a/openpype/modules/default_modules/kitsu/plugins/publish/example_plugin.py
+++ b/openpype/modules/default_modules/kitsu/plugins/publish/kitsu_plugin.py
@@ -4,15 +4,12 @@ import gazu
 
 import pyblish.api
 
-import debugpy
-
 
 class CollectExampleAddon(pyblish.api.ContextPlugin):
     order = pyblish.api.CollectorOrder + 0.4
     label = "Collect Kitsu"
 
     def process(self, context):
-        debugpy.breakpoint()
         self.log.info("I'm in Kitsu's plugin!")
 
 
@@ -23,7 +20,6 @@ class IntegrateRig(pyblish.api.InstancePlugin):
     families = ["model"]
 
     def process(self, instance):
-        print(instance.data["version"])
 
         # Connect to server
         gazu.client.set_host(os.environ["KITSU_SERVER"])
@@ -33,8 +29,6 @@ class IntegrateRig(pyblish.api.InstancePlugin):
 
         asset_data = instance.data["assetEntity"]["data"]
 
-        # TODO Set local settings for login and password
-
         # Get task
         task_type = gazu.task.get_task_type_by_name(instance.data["task"])
         entity_task = gazu.task.get_task_by_entity(asset_data["zou"], task_type)
@@ -46,4 +40,4 @@ class IntegrateRig(pyblish.api.InstancePlugin):
             comment=f"Version {instance.data['version']} has been published!",
         )
 
-        self.log.info("Copied successfully!")
+        self.log.info("Version published to Kitsu successfully!")
diff --git a/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/main.json b/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/main.json
deleted file mode 100644
index 82e58ce9ab..0000000000
--- a/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/main.json
+++ /dev/null
@@ -1,30 +0,0 @@
-{
-    "type": "dict",
-    "key": "kitsu",
-    "label": " Kitsu",
-    "collapsible": true,
-    "children": [
-        {
-            "type": "number",
-            "key": "number",
-            "label": "This is your lucky number:",
-            "minimum": 7,
-            "maximum": 7,
-            "decimals": 0
-        },
-        {
-            "type": "template",
-            "name": "kitsu/the_template",
-            "template_data": [
-                {
-                    "name": "color_1",
-                    "label": "Color 1"
-                },
-                {
-                    "name": "color_2",
-                    "label": "Color 2"
-                }
-            ]
-        }
-    ]
-}
diff --git a/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/the_template.json b/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/the_template.json
deleted file mode 100644
index af8fd9dae4..0000000000
--- a/openpype/modules/default_modules/kitsu/settings/schemas/project_schemas/the_template.json
+++ /dev/null
@@ -1,30 +0,0 @@
-[
-    {
-        "type": "list-strict",
-        "key": "{name}",
-        "label": "{label}",
-        "object_types": [
-            {
-                "label": "Red",
-                "type": "number",
-                "minimum": 0,
-                "maximum": 1,
-                "decimal": 3
-            },
-            {
-                "label": "Green",
-                "type": "number",
-                "minimum": 0,
-                "maximum": 1,
-                "decimal": 3
-            },
-            {
-                "label": "Blue",
-                "type": "number",
-                "minimum": 0,
-                "maximum": 1,
-                "decimal": 3
-            }
-        ]
-    }
-]
diff --git a/openpype/modules/default_modules/kitsu/listeners.py b/openpype/modules/default_modules/kitsu/utils/listeners.py
similarity index 99%
rename from openpype/modules/default_modules/kitsu/listeners.py
rename to openpype/modules/default_modules/kitsu/utils/listeners.py
index 16c4e0e69e..c99870fa36 100644
--- a/openpype/modules/default_modules/kitsu/listeners.py
+++ b/openpype/modules/default_modules/kitsu/utils/listeners.py
@@ -2,7 +2,7 @@ import gazu
 import os
 
 from avalon.api import AvalonMongoDB
-from openpype.modules.default_modules.kitsu.utils.openpype import (
+from .openpype import (
     create_op_asset,
     set_op_project,
     sync_project,
diff --git a/openpype/modules/default_modules/kitsu/widgets.py b/openpype/modules/default_modules/kitsu/widgets.py
deleted file mode 100644
index de232113fe..0000000000
--- a/openpype/modules/default_modules/kitsu/widgets.py
+++ /dev/null
@@ -1,31 +0,0 @@
-from Qt import QtWidgets
-
-from openpype.style import load_stylesheet
-
-
-class MyExampleDialog(QtWidgets.QDialog):
-    def __init__(self, parent=None):
-        super(MyExampleDialog, self).__init__(parent)
-
-        self.setWindowTitle("Connected modules")
-
-        msg = "This is example dialog of Kitsu."
-        label_widget = QtWidgets.QLabel(msg, self)
-
-        ok_btn = QtWidgets.QPushButton("OK", self)
-        btns_layout = QtWidgets.QHBoxLayout()
-        btns_layout.addStretch(1)
-        btns_layout.addWidget(ok_btn)
-
-        layout = QtWidgets.QVBoxLayout(self)
-        layout.addWidget(label_widget)
-        layout.addLayout(btns_layout)
-
-        ok_btn.clicked.connect(self._on_ok_clicked)
-
-        self._label_widget = label_widget
-
-        self.setStyleSheet(load_stylesheet())
-
-    def _on_ok_clicked(self):
-        self.done(1)
diff --git a/openpype/settings/defaults/system_settings/modules.json b/openpype/settings/defaults/system_settings/modules.json
index ddb2edc360..537e287366 100644
--- a/openpype/settings/defaults/system_settings/modules.json
+++ b/openpype/settings/defaults/system_settings/modules.json
@@ -139,9 +139,7 @@
     },
     "kitsu": {
         "enabled": false,
-        "server": "",
-        "script_login": "",
-        "script_pwd": ""
+        "server": ""
     },
     "timers_manager": {
         "enabled": true,
diff --git a/openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json b/openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json
index ae2b52df0d..15a2ccc58d 100644
--- a/openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json
+++ b/openpype/settings/entities/schemas/system_schema/module_settings/schema_kitsu.json
@@ -16,16 +16,6 @@
             "key": "server",
             "label": "Server"
         },
-        {
-            "type": "text",
-            "key": "script_login",
-            "label": "Script Login"
-        },
-        {
-            "type": "text",
-            "key": "script_pwd",
-            "label": "Script Password"
-        },
         {
             "type": "splitter"
         }
diff --git a/pyproject.toml b/pyproject.toml
index f32e385e80..93caa5ca70 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -40,6 +40,7 @@ clique = "1.6.*"
 Click = "^7"
 dnspython = "^2.1.0"
 ftrack-python-api = "2.0.*"
+gazu = "^0.8"
 google-api-python-client = "^1.12.8" # sync server google support (should be separate?)
 jsonschema = "^2.6.0"
 keyring = "^22.0.1"
@@ -64,7 +65,7 @@ jinxed = [
 python3-xlib = { version="*", markers = "sys_platform == 'linux'"}
 enlighten = "^1.9.0"
 slack-sdk = "^3.6.0"
-requests = "2.25.1"
+requests = "^2.25.1"
 pysftp = "^0.2.9"
 dropbox = "^11.20.0"
 

From 6b3987708711e72d984b39096efec9a0421ffd0e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 1 Mar 2022 18:11:42 +0100
Subject: [PATCH 0142/1227] Moved to modules

---
 openpype/modules/{default_modules => }/kitsu/__init__.py       | 0
 openpype/modules/{default_modules => }/kitsu/kitsu_module.py   | 2 +-
 openpype/modules/{default_modules => }/kitsu/kitsu_widgets.py  | 0
 .../kitsu/plugins/publish/kitsu_plugin.py                      | 0
 openpype/modules/{default_modules => }/kitsu/utils/__init__.py | 0
 .../modules/{default_modules => }/kitsu/utils/listeners.py     | 3 ++-
 openpype/modules/{default_modules => }/kitsu/utils/openpype.py | 0
 7 files changed, 3 insertions(+), 2 deletions(-)
 rename openpype/modules/{default_modules => }/kitsu/__init__.py (100%)
 rename openpype/modules/{default_modules => }/kitsu/kitsu_module.py (99%)
 rename openpype/modules/{default_modules => }/kitsu/kitsu_widgets.py (100%)
 rename openpype/modules/{default_modules => }/kitsu/plugins/publish/kitsu_plugin.py (100%)
 rename openpype/modules/{default_modules => }/kitsu/utils/__init__.py (100%)
 rename openpype/modules/{default_modules => }/kitsu/utils/listeners.py (99%)
 rename openpype/modules/{default_modules => }/kitsu/utils/openpype.py (100%)

diff --git a/openpype/modules/default_modules/kitsu/__init__.py b/openpype/modules/kitsu/__init__.py
similarity index 100%
rename from openpype/modules/default_modules/kitsu/__init__.py
rename to openpype/modules/kitsu/__init__.py
diff --git a/openpype/modules/default_modules/kitsu/kitsu_module.py b/openpype/modules/kitsu/kitsu_module.py
similarity index 99%
rename from openpype/modules/default_modules/kitsu/kitsu_module.py
rename to openpype/modules/kitsu/kitsu_module.py
index 51ab8aaa42..a17b509047 100644
--- a/openpype/modules/default_modules/kitsu/kitsu_module.py
+++ b/openpype/modules/kitsu/kitsu_module.py
@@ -24,7 +24,7 @@ from pymongo import DeleteOne, UpdateOne
 from avalon.api import AvalonMongoDB
 from openpype.api import get_project_settings
 from openpype.modules import JsonFilesSettingsDef, OpenPypeModule, ModulesManager
-from openpype.modules.default_modules.kitsu.utils.openpype import (
+from openpype.modules.kitsu.utils.openpype import (
     create_op_asset,
     sync_project,
     update_op_assets,
diff --git a/openpype/modules/default_modules/kitsu/kitsu_widgets.py b/openpype/modules/kitsu/kitsu_widgets.py
similarity index 100%
rename from openpype/modules/default_modules/kitsu/kitsu_widgets.py
rename to openpype/modules/kitsu/kitsu_widgets.py
diff --git a/openpype/modules/default_modules/kitsu/plugins/publish/kitsu_plugin.py b/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
similarity index 100%
rename from openpype/modules/default_modules/kitsu/plugins/publish/kitsu_plugin.py
rename to openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
diff --git a/openpype/modules/default_modules/kitsu/utils/__init__.py b/openpype/modules/kitsu/utils/__init__.py
similarity index 100%
rename from openpype/modules/default_modules/kitsu/utils/__init__.py
rename to openpype/modules/kitsu/utils/__init__.py
diff --git a/openpype/modules/default_modules/kitsu/utils/listeners.py b/openpype/modules/kitsu/utils/listeners.py
similarity index 99%
rename from openpype/modules/default_modules/kitsu/utils/listeners.py
rename to openpype/modules/kitsu/utils/listeners.py
index c99870fa36..961aa1691b 100644
--- a/openpype/modules/default_modules/kitsu/utils/listeners.py
+++ b/openpype/modules/kitsu/utils/listeners.py
@@ -10,7 +10,8 @@ from .openpype import (
 )
 
 
-def add_listeners():
+def start_listeners():
+    """Start listeners to keep OpenPype up-to-date with Kitsu."""
     # Connect to server
     gazu.client.set_host(os.environ["KITSU_SERVER"])
 
diff --git a/openpype/modules/default_modules/kitsu/utils/openpype.py b/openpype/modules/kitsu/utils/openpype.py
similarity index 100%
rename from openpype/modules/default_modules/kitsu/utils/openpype.py
rename to openpype/modules/kitsu/utils/openpype.py

From a33b3d3b5cdfa37204da8570d175997be3544001 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 2 Mar 2022 09:30:33 +0100
Subject: [PATCH 0143/1227] Remove AddonSettingsDef

---
 openpype/modules/kitsu/__init__.py     |  4 ++--
 openpype/modules/kitsu/kitsu_module.py | 12 ------------
 2 files changed, 2 insertions(+), 14 deletions(-)

diff --git a/openpype/modules/kitsu/__init__.py b/openpype/modules/kitsu/__init__.py
index dc7c2dad50..6cb62bbb15 100644
--- a/openpype/modules/kitsu/__init__.py
+++ b/openpype/modules/kitsu/__init__.py
@@ -4,6 +4,6 @@ If addon class or settings definition won't be here their definition won't
 be found by OpenPype discovery.
 """
 
-from .kitsu_module import AddonSettingsDef, KitsuModule
+from .kitsu_module import KitsuModule
 
-__all__ = ("AddonSettingsDef", "KitsuModule")
+__all__ = "KitsuModule"
diff --git a/openpype/modules/kitsu/kitsu_module.py b/openpype/modules/kitsu/kitsu_module.py
index a17b509047..9efcac9714 100644
--- a/openpype/modules/kitsu/kitsu_module.py
+++ b/openpype/modules/kitsu/kitsu_module.py
@@ -34,18 +34,6 @@ from openpype_interfaces import IPluginPaths, ITrayAction
 from .utils.listeners import start_listeners
 
 
-class AddonSettingsDef(JsonFilesSettingsDef):
-    schema_prefix = "kitsu"
-
-    def get_settings_root_path(self):
-        """Implemented abstract class of JsonFilesSettingsDef.
-
-        Return directory path where json files defying addon settings are
-        located.
-        """
-        return os.path.join(os.path.dirname(os.path.abspath(__file__)), "settings")
-
-
 class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
     """Kitsu module class."""
 

From 4907ce1362602efef2692253d9b93fbc79d2e522 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 2 Mar 2022 09:31:02 +0100
Subject: [PATCH 0144/1227] Moved up module 'base' changes

---
 openpype/modules/base.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/modules/base.py b/openpype/modules/base.py
index 0dd512ee8b..d77189be6c 100644
--- a/openpype/modules/base.py
+++ b/openpype/modules/base.py
@@ -860,6 +860,7 @@ class TrayModulesManager(ModulesManager):
     modules_menu_order = (
         "user",
         "ftrack",
+        "kitsu",
         "muster",
         "launcher_tool",
         "avalon",

From a15c4d2895a5eaf433ec9d3912200a271cac16a9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 2 Mar 2022 09:48:39 +0100
Subject: [PATCH 0145/1227] import gazu only at start

---
 openpype/modules/kitsu/kitsu_module.py    | 63 ++++++++++-------------
 openpype/modules/kitsu/utils/listeners.py |  3 +-
 openpype/modules/kitsu/utils/openpype.py  | 13 ++---
 3 files changed, 35 insertions(+), 44 deletions(-)

diff --git a/openpype/modules/kitsu/kitsu_module.py b/openpype/modules/kitsu/kitsu_module.py
index 9efcac9714..502ed8ff96 100644
--- a/openpype/modules/kitsu/kitsu_module.py
+++ b/openpype/modules/kitsu/kitsu_module.py
@@ -4,34 +4,19 @@ import click
 import os
 import re
 
-import gazu
-from gazu.asset import all_assets_for_project, all_asset_types, new_asset
-from gazu.shot import (
-    all_episodes_for_project,
-    all_sequences_for_project,
-    all_shots_for_project,
-    new_episode,
-    new_sequence,
-    new_shot,
-)
-from gazu.task import (
-    all_task_types,
-    new_task,
-    new_task_type,
-)
 from pymongo import DeleteOne, UpdateOne
 
 from avalon.api import AvalonMongoDB
 from openpype.api import get_project_settings
-from openpype.modules import JsonFilesSettingsDef, OpenPypeModule, ModulesManager
-from openpype.modules.kitsu.utils.openpype import (
+from openpype.modules import OpenPypeModule, ModulesManager
+from openpype.settings.lib import get_local_settings
+from openpype_interfaces import IPluginPaths, ITrayAction
+from .utils.listeners import start_listeners
+from .utils.openpype import (
     create_op_asset,
     sync_project,
     update_op_assets,
 )
-from openpype.settings.lib import get_local_settings
-from openpype_interfaces import IPluginPaths, ITrayAction
-from .utils.listeners import start_listeners
 
 
 class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
@@ -137,6 +122,7 @@ def cli_main():
 @cli_main.command()
 def sync_zou():
     """Synchronize Zou server database (Kitsu backend) with openpype database."""
+    import gazu
 
     # Connect to server
     gazu.client.set_host(os.environ["KITSU_SERVER"])
@@ -178,11 +164,11 @@ def sync_zou():
             gazu.project.update_project_data(zou_project, data=op_project["data"])
         gazu.project.update_project(zou_project)
 
-        asset_types = all_asset_types()
-        all_assets = all_assets_for_project(zou_project)
-        all_episodes = all_episodes_for_project(zou_project)
-        all_seqs = all_sequences_for_project(zou_project)
-        all_shots = all_shots_for_project(zou_project)
+        asset_types = gazu.asset.all_asset_types()
+        all_assets = gazu.asset.all_assets_for_project(zou_project)
+        all_episodes = gazu.shot.all_episodes_for_project(zou_project)
+        all_seqs = gazu.shot.all_sequences_for_project(zou_project)
+        all_shots = gazu.shot.all_shots_for_project(zou_project)
         all_entities_ids = {
             e["id"] for e in all_episodes + all_seqs + all_shots + all_assets
         }
@@ -217,7 +203,9 @@ def sync_zou():
             # Match asset type by it's name
             match = regex_ep.match(doc["name"])
             if not match:  # Asset
-                new_entity = new_asset(zou_project, asset_types[0], doc["name"])
+                new_entity = gazu.asset.new_asset(
+                    zou_project, asset_types[0], doc["name"]
+                )
             # Match case in shot<sequence<episode order to support composed names like 'ep01_sq01_sh01'
             elif match.group(1):  # Shot
                 # Match and check parent doc
@@ -238,7 +226,7 @@ def sync_zou():
                     )
 
                     # Create new sequence and set it as substitute
-                    created_sequence = new_sequence(
+                    created_sequence = gazu.shot.new_sequence(
                         zou_project, substitute_sequence_name, episode=zou_parent_id
                     )
                     gazu.shot.update_sequence_data(
@@ -250,7 +238,7 @@ def sync_zou():
                     zou_parent_id = created_sequence["id"]
 
                 # Create shot
-                new_entity = new_shot(
+                new_entity = gazu.shot.new_shot(
                     zou_project,
                     zou_parent_id,
                     doc["name"],
@@ -261,12 +249,12 @@ def sync_zou():
 
             elif match.group(2):  # Sequence
                 parent_doc = asset_docs[visual_parent_id]
-                new_entity = new_sequence(
+                new_entity = gazu.shot.new_sequence(
                     zou_project, doc["name"], episode=parent_doc["data"]["zou"]["id"]
                 )
 
             elif match.group(3):  # Episode
-                new_entity = new_episode(zou_project, doc["name"])
+                new_entity = gazu.shot.new_episode(zou_project, doc["name"])
 
             # Update doc with zou id
             doc["data"].update(
@@ -289,7 +277,7 @@ def sync_zou():
             )
 
         # Update assets
-        all_tasks_types = {t["name"]: t for t in all_task_types()}
+        all_tasks_types = {t["name"]: t for t in gazu.task.all_task_types()}
         assets_docs_to_update = [
             doc
             for doc in asset_docs.values()
@@ -323,11 +311,11 @@ def sync_zou():
 
                         # Create non existing task
                         if not task_type:
-                            task_type = new_task_type(task_name)
+                            task_type = gazu.task.new_task_type(task_name)
                             all_tasks_types[task_name] = task_type
 
                         # New task for entity
-                        new_task(entity, task_type)
+                        gazu.task.new_task(entity, task_type)
 
         # Delete
         deleted_entities = all_entities_ids - {
@@ -350,6 +338,7 @@ def sync_zou():
 )
 def sync_openpype(listen: bool):
     """Synchronize openpype database from Zou sever database."""
+    import gazu
 
     # Connect to server
     gazu.client.set_host(os.environ["KITSU_SERVER"])
@@ -373,10 +362,10 @@ def sync_openpype(listen: bool):
         print(f"Synchronizing {project_name}...")
 
         # Get all assets from zou
-        all_assets = all_assets_for_project(project)
-        all_episodes = all_episodes_for_project(project)
-        all_seqs = all_sequences_for_project(project)
-        all_shots = all_shots_for_project(project)
+        all_assets = gazu.asset.all_assets_for_project(project)
+        all_episodes = gazu.shot.all_episodes_for_project(project)
+        all_seqs = gazu.shot.all_sequences_for_project(project)
+        all_shots = gazu.shot.all_shots_for_project(project)
         all_entities = [
             e
             for e in all_assets + all_episodes + all_seqs + all_shots
diff --git a/openpype/modules/kitsu/utils/listeners.py b/openpype/modules/kitsu/utils/listeners.py
index 961aa1691b..18f67b13e3 100644
--- a/openpype/modules/kitsu/utils/listeners.py
+++ b/openpype/modules/kitsu/utils/listeners.py
@@ -1,4 +1,3 @@
-import gazu
 import os
 
 from avalon.api import AvalonMongoDB
@@ -12,6 +11,8 @@ from .openpype import (
 
 def start_listeners():
     """Start listeners to keep OpenPype up-to-date with Kitsu."""
+    import gazu
+
     # Connect to server
     gazu.client.set_host(os.environ["KITSU_SERVER"])
 
diff --git a/openpype/modules/kitsu/utils/openpype.py b/openpype/modules/kitsu/utils/openpype.py
index 518872a71c..2443323893 100644
--- a/openpype/modules/kitsu/utils/openpype.py
+++ b/openpype/modules/kitsu/utils/openpype.py
@@ -1,14 +1,8 @@
 from typing import Dict, List
-import gazu
 
 from pymongo import UpdateOne
 from pymongo.collection import Collection
 
-from gazu.task import (
-    all_tasks_for_asset,
-    all_tasks_for_shot,
-)
-
 from avalon.api import AvalonMongoDB
 from openpype.lib import create_project
 
@@ -32,6 +26,8 @@ def set_op_project(dbcon, project_id) -> Collection:
     :param dbcon: Connection to DB.
     :param project_id: Project zou ID
     """
+    import gazu
+
     project = gazu.project.get_project(project_id)
     project_name = project["name"]
     dbcon.Session["AVALON_PROJECT"] = project_name
@@ -49,6 +45,11 @@ def update_op_assets(
     :param asset_doc_ids: Dicts of [{zou_id: asset_doc}, ...]
     :return: List of (doc_id, update_dict) tuples
     """
+    from gazu.task import (
+        all_tasks_for_asset,
+        all_tasks_for_shot,
+    )
+
     assets_with_update = []
     for item in entities_list:
         # Update asset

From 44100b0da7d30bc34af0635b5e577e2a6df03c01 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 2 Mar 2022 09:52:26 +0100
Subject: [PATCH 0146/1227] line length to 79

---
 openpype/modules/kitsu/kitsu_module.py        | 33 ++++++++++++++-----
 openpype/modules/kitsu/kitsu_widgets.py       | 14 +++++---
 .../kitsu/plugins/publish/kitsu_plugin.py     |  4 ++-
 openpype/modules/kitsu/utils/listeners.py     | 29 +++++++++++-----
 openpype/modules/kitsu/utils/openpype.py      |  7 ++--
 5 files changed, 63 insertions(+), 24 deletions(-)

diff --git a/openpype/modules/kitsu/kitsu_module.py b/openpype/modules/kitsu/kitsu_module.py
index 502ed8ff96..a7b3b17eb5 100644
--- a/openpype/modules/kitsu/kitsu_module.py
+++ b/openpype/modules/kitsu/kitsu_module.py
@@ -42,7 +42,9 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
 
             # Check for "/api" url validity
             if not kitsu_url.endswith("api"):
-                kitsu_url = f"{kitsu_url}{'' if kitsu_url.endswith('/') else '/'}api"
+                kitsu_url = (
+                    f"{kitsu_url}{'' if kitsu_url.endswith('/') else '/'}api"
+                )
 
         self.server_url = kitsu_url
 
@@ -161,7 +163,9 @@ def sync_zou():
                     "resolution": f"{op_project['data']['resolutionWidth']}x{op_project['data']['resolutionHeight']}",
                 }
             )
-            gazu.project.update_project_data(zou_project, data=op_project["data"])
+            gazu.project.update_project_data(
+                zou_project, data=op_project["data"]
+            )
         gazu.project.update_project(zou_project)
 
         asset_types = gazu.asset.all_asset_types()
@@ -227,7 +231,9 @@ def sync_zou():
 
                     # Create new sequence and set it as substitute
                     created_sequence = gazu.shot.new_sequence(
-                        zou_project, substitute_sequence_name, episode=zou_parent_id
+                        zou_project,
+                        substitute_sequence_name,
+                        episode=zou_parent_id,
                     )
                     gazu.shot.update_sequence_data(
                         created_sequence, {"is_substitute": True}
@@ -244,13 +250,16 @@ def sync_zou():
                     doc["name"],
                     frame_in=doc["data"]["frameStart"],
                     frame_out=doc["data"]["frameEnd"],
-                    nb_frames=doc["data"]["frameEnd"] - doc["data"]["frameStart"],
+                    nb_frames=doc["data"]["frameEnd"]
+                    - doc["data"]["frameStart"],
                 )
 
             elif match.group(2):  # Sequence
                 parent_doc = asset_docs[visual_parent_id]
                 new_entity = gazu.shot.new_sequence(
-                    zou_project, doc["name"], episode=parent_doc["data"]["zou"]["id"]
+                    zou_project,
+                    doc["name"],
+                    episode=parent_doc["data"]["zou"]["id"],
                 )
 
             elif match.group(3):  # Episode
@@ -293,7 +302,10 @@ def sync_zou():
                 if frame_in or frame_out:
                     entity_data.update(
                         {
-                            "data": {"frame_in": frame_in, "frame_out": frame_out},
+                            "data": {
+                                "frame_in": frame_in,
+                                "frame_out": frame_out,
+                            },
                             "nb_frames": frame_out - frame_in,
                         }
                     )
@@ -334,7 +346,10 @@ def sync_zou():
 
 @cli_main.command()
 @click.option(
-    "-l", "--listen", is_flag=True, help="Listen Kitsu server after synchronization."
+    "-l",
+    "--listen",
+    is_flag=True,
+    help="Listen Kitsu server after synchronization.",
 )
 def sync_openpype(listen: bool):
     """Synchronize openpype database from Zou sever database."""
@@ -410,7 +425,9 @@ def sync_openpype(listen: bool):
         bulk_writes.extend(
             [
                 UpdateOne({"_id": id}, update)
-                for id, update in update_op_assets(all_entities, zou_ids_and_asset_docs)
+                for id, update in update_op_assets(
+                    all_entities, zou_ids_and_asset_docs
+                )
             ]
         )
 
diff --git a/openpype/modules/kitsu/kitsu_widgets.py b/openpype/modules/kitsu/kitsu_widgets.py
index 6bd436f460..1a32182795 100644
--- a/openpype/modules/kitsu/kitsu_widgets.py
+++ b/openpype/modules/kitsu/kitsu_widgets.py
@@ -46,7 +46,8 @@ class PasswordDialog(QtWidgets.QDialog):
         login_label = QtWidgets.QLabel("Login:", login_widget)
 
         login_input = QtWidgets.QLineEdit(
-            login_widget, text=kitsu_settings.get("login") if remembered else None
+            login_widget,
+            text=kitsu_settings.get("login") if remembered else None,
         )
         login_input.setPlaceholderText("Your Kitsu account login...")
 
@@ -61,7 +62,8 @@ class PasswordDialog(QtWidgets.QDialog):
         password_label = QtWidgets.QLabel("Password:", password_widget)
 
         password_input = QtWidgets.QLineEdit(
-            password_widget, text=kitsu_settings.get("password") if remembered else None
+            password_widget,
+            text=kitsu_settings.get("password") if remembered else None,
         )
         password_input.setPlaceholderText("Your password...")
         password_input.setEchoMode(QtWidgets.QLineEdit.Password)
@@ -87,7 +89,9 @@ class PasswordDialog(QtWidgets.QDialog):
 
         remember_checkbox = QtWidgets.QCheckBox("Remember", buttons_widget)
         remember_checkbox.setObjectName("RememberCheckbox")
-        remember_checkbox.setChecked(remembered if remembered is not None else True)
+        remember_checkbox.setChecked(
+            remembered if remembered is not None else True
+        )
 
         ok_btn = QtWidgets.QPushButton("Ok", buttons_widget)
         cancel_btn = QtWidgets.QPushButton("Cancel", buttons_widget)
@@ -137,7 +141,9 @@ class PasswordDialog(QtWidgets.QDialog):
     def _on_ok_click(self):
         # Check if is connectable
         if not self._connectable:
-            self.message_label.setText("Please set server url in Studio Settings!")
+            self.message_label.setText(
+                "Please set server url in Studio Settings!"
+            )
             return
 
         # Collect values
diff --git a/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py b/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
index 86ba40a5f4..24f1e4e80c 100644
--- a/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
+++ b/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
@@ -31,7 +31,9 @@ class IntegrateRig(pyblish.api.InstancePlugin):
 
         # Get task
         task_type = gazu.task.get_task_type_by_name(instance.data["task"])
-        entity_task = gazu.task.get_task_by_entity(asset_data["zou"], task_type)
+        entity_task = gazu.task.get_task_by_entity(
+            asset_data["zou"], task_type
+        )
 
         # Comment entity
         gazu.task.add_comment(
diff --git a/openpype/modules/kitsu/utils/listeners.py b/openpype/modules/kitsu/utils/listeners.py
index 18f67b13e3..3768b4e8e6 100644
--- a/openpype/modules/kitsu/utils/listeners.py
+++ b/openpype/modules/kitsu/utils/listeners.py
@@ -95,9 +95,9 @@ def start_listeners():
         zou_ids_and_asset_docs[asset["project_id"]] = project_doc
 
         # Update
-        asset_doc_id, asset_update = update_op_assets([asset], zou_ids_and_asset_docs)[
-            0
-        ]
+        asset_doc_id, asset_update = update_op_assets(
+            [asset], zou_ids_and_asset_docs
+        )[0]
         project_col.update_one({"_id": asset_doc_id}, asset_update)
 
     def delete_asset(data):
@@ -105,7 +105,9 @@ def start_listeners():
         project_col = set_op_project(dbcon, data["project_id"])
 
         # Delete
-        project_col.delete_one({"type": "asset", "data.zou.id": data["asset_id"]})
+        project_col.delete_one(
+            {"type": "asset", "data.zou.id": data["asset_id"]}
+        )
 
     gazu.events.add_listener(event_client, "asset:new", new_asset)
     gazu.events.add_listener(event_client, "asset:update", update_asset)
@@ -155,7 +157,9 @@ def start_listeners():
         print("delete episode")  # TODO check bugfix
 
         # Delete
-        project_col.delete_one({"type": "asset", "data.zou.id": data["episode_id"]})
+        project_col.delete_one(
+            {"type": "asset", "data.zou.id": data["episode_id"]}
+        )
 
     gazu.events.add_listener(event_client, "episode:new", new_episode)
     gazu.events.add_listener(event_client, "episode:update", update_episode)
@@ -205,7 +209,9 @@ def start_listeners():
         print("delete sequence")  # TODO check bugfix
 
         # Delete
-        project_col.delete_one({"type": "asset", "data.zou.id": data["sequence_id"]})
+        project_col.delete_one(
+            {"type": "asset", "data.zou.id": data["sequence_id"]}
+        )
 
     gazu.events.add_listener(event_client, "sequence:new", new_sequence)
     gazu.events.add_listener(event_client, "sequence:update", update_sequence)
@@ -244,7 +250,9 @@ def start_listeners():
         zou_ids_and_asset_docs[shot["project_id"]] = project_doc
 
         # Update
-        asset_doc_id, asset_update = update_op_assets([shot], zou_ids_and_asset_docs)[0]
+        asset_doc_id, asset_update = update_op_assets(
+            [shot], zou_ids_and_asset_docs
+        )[0]
         project_col.update_one({"_id": asset_doc_id}, asset_update)
 
     def delete_shot(data):
@@ -252,7 +260,9 @@ def start_listeners():
         project_col = set_op_project(dbcon, data["project_id"])
 
         # Delete
-        project_col.delete_one({"type": "asset", "data.zou.id": data["shot_id"]})
+        project_col.delete_one(
+            {"type": "asset", "data.zou.id": data["shot_id"]}
+        )
 
     gazu.events.add_listener(event_client, "shot:new", new_shot)
     gazu.events.add_listener(event_client, "shot:update", update_shot)
@@ -302,7 +312,8 @@ def start_listeners():
 
                     # Delete task in DB
                     project_col.update_one(
-                        {"_id": doc["_id"]}, {"$set": {"data.tasks": asset_tasks}}
+                        {"_id": doc["_id"]},
+                        {"$set": {"data.tasks": asset_tasks}},
                     )
                     return
 
diff --git a/openpype/modules/kitsu/utils/openpype.py b/openpype/modules/kitsu/utils/openpype.py
index 2443323893..8aabba6de0 100644
--- a/openpype/modules/kitsu/utils/openpype.py
+++ b/openpype/modules/kitsu/utils/openpype.py
@@ -65,7 +65,8 @@ def update_op_assets(
             tasks_list = all_tasks_for_shot(item)
             # TODO frame in and out
         item_data["tasks"] = {
-            t["task_type_name"]: {"type": t["task_type_name"]} for t in tasks_list
+            t["task_type_name"]: {"type": t["task_type_name"]}
+            for t in tasks_list
         }
 
         # Get zou parent id for correct hierarchy
@@ -79,7 +80,9 @@ def update_op_assets(
             parent_zou_id = substitute_parent_item["parent_id"]
         else:
             parent_zou_id = (
-                item.get("parent_id") or item.get("episode_id") or item.get("source_id")
+                item.get("parent_id")
+                or item.get("episode_id")
+                or item.get("source_id")
             )  # TODO check consistency
 
         # Visual parent for hierarchy

From c26c2f09a8f271419e76cd7407f35b19d579d851 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 2 Mar 2022 09:54:47 +0100
Subject: [PATCH 0147/1227] fix import

---
 openpype/modules/kitsu/utils/openpype.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/modules/kitsu/utils/openpype.py b/openpype/modules/kitsu/utils/openpype.py
index 8aabba6de0..56c99effff 100644
--- a/openpype/modules/kitsu/utils/openpype.py
+++ b/openpype/modules/kitsu/utils/openpype.py
@@ -132,6 +132,8 @@ def sync_project(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
     :param dbcon: DB to create project in
     :return: Update instance for the project
     """
+    import gazu
+
     project_name = project["name"]
     project_doc = dbcon.find_one({"type": "project"})
     if not project_doc:

From e8831947e6c2de902470e0fffdb69cad6429ce32 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 2 Mar 2022 09:57:00 +0100
Subject: [PATCH 0148/1227] Fix __all__

---
 openpype/modules/kitsu/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/__init__.py b/openpype/modules/kitsu/__init__.py
index 6cb62bbb15..9737a054f6 100644
--- a/openpype/modules/kitsu/__init__.py
+++ b/openpype/modules/kitsu/__init__.py
@@ -6,4 +6,4 @@ be found by OpenPype discovery.
 
 from .kitsu_module import KitsuModule
 
-__all__ = "KitsuModule"
+__all__ = ("KitsuModule", )

From cde925c09b06130f6b4e1f36d993d21aba0fd7bb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 2 Mar 2022 11:38:47 +0100
Subject: [PATCH 0149/1227] Use OpenPypeSecureRegistry for authentication

---
 openpype/modules/kitsu/__init__.py      |  2 +-
 openpype/modules/kitsu/kitsu_module.py  | 22 ++++++++++++++---
 openpype/modules/kitsu/kitsu_widgets.py | 33 +++++++++++--------------
 3 files changed, 33 insertions(+), 24 deletions(-)

diff --git a/openpype/modules/kitsu/__init__.py b/openpype/modules/kitsu/__init__.py
index 9737a054f6..9220cb1762 100644
--- a/openpype/modules/kitsu/__init__.py
+++ b/openpype/modules/kitsu/__init__.py
@@ -6,4 +6,4 @@ be found by OpenPype discovery.
 
 from .kitsu_module import KitsuModule
 
-__all__ = ("KitsuModule", )
+__all__ = ("KitsuModule",)
diff --git a/openpype/modules/kitsu/kitsu_module.py b/openpype/modules/kitsu/kitsu_module.py
index a7b3b17eb5..ebfa0dbeea 100644
--- a/openpype/modules/kitsu/kitsu_module.py
+++ b/openpype/modules/kitsu/kitsu_module.py
@@ -8,6 +8,7 @@ from pymongo import DeleteOne, UpdateOne
 
 from avalon.api import AvalonMongoDB
 from openpype.api import get_project_settings
+from openpype.lib.local_settings import OpenPypeSecureRegistry
 from openpype.modules import OpenPypeModule, ModulesManager
 from openpype.settings.lib import get_local_settings
 from openpype_interfaces import IPluginPaths, ITrayAction
@@ -28,7 +29,9 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
     def initialize(self, settings):
         """Initialization of module."""
         module_settings = settings[self.name]
-        local_kitsu_settings = get_local_settings().get("kitsu", {})
+
+        # Get user registry
+        user_registry = OpenPypeSecureRegistry("kitsu_user")
 
         # Enabled by settings
         self.enabled = module_settings.get("enabled", False)
@@ -49,8 +52,8 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
         self.server_url = kitsu_url
 
         # Set credentials
-        self.kitsu_login = local_kitsu_settings["login"]
-        self.kitsu_password = local_kitsu_settings["password"]
+        self.kitsu_login = user_registry.get_item("login", None)
+        self.kitsu_password = user_registry.get_item("password", None)
 
         # Prepare variables that can be used or set afterwards
         self._connected_modules = None
@@ -359,7 +362,13 @@ def sync_openpype(listen: bool):
     gazu.client.set_host(os.environ["KITSU_SERVER"])
 
     # Authenticate
-    gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
+    kitsu_login = os.environ.get("KITSU_LOGIN")
+    kitsu_pwd = os.environ.get("KITSU_PWD")
+    if not kitsu_login or not kitsu_pwd:  # Sentinel to log-in
+        log_in_dialog()
+        return
+
+    gazu.log_in(kitsu_login, kitsu_pwd)
 
     # Iterate projects
     dbcon = AvalonMongoDB()
@@ -462,6 +471,11 @@ def listen():
 
 @cli_main.command()
 def sign_in():
+    """Sign-in command."""
+    log_in_dialog()
+
+
+def log_in_dialog():
     """Show credentials dialog."""
     from openpype.tools.utils.lib import qt_app_context
 
diff --git a/openpype/modules/kitsu/kitsu_widgets.py b/openpype/modules/kitsu/kitsu_widgets.py
index 1a32182795..1a48e6dbc0 100644
--- a/openpype/modules/kitsu/kitsu_widgets.py
+++ b/openpype/modules/kitsu/kitsu_widgets.py
@@ -4,11 +4,10 @@ import gazu
 from Qt import QtWidgets, QtCore, QtGui
 
 from openpype import style
+from openpype.lib.local_settings import OpenPypeSecureRegistry
 from openpype.resources import get_resource
 from openpype.settings.lib import (
-    get_local_settings,
     get_system_settings,
-    save_local_settings,
 )
 
 from openpype.widgets.password_dialog import PressHoverButton
@@ -26,8 +25,11 @@ class PasswordDialog(QtWidgets.QDialog):
         self.resize(300, 120)
 
         system_settings = get_system_settings()
-        kitsu_settings = get_local_settings().get("kitsu", {})
-        remembered = kitsu_settings.get("remember")
+        user_registry = OpenPypeSecureRegistry("kitsu_user")
+        remembered = bool(
+            user_registry.get_item("login", None)
+            or user_registry.get_item("password", None)
+        )
 
         self._final_result = None
         self._connectable = bool(
@@ -47,7 +49,7 @@ class PasswordDialog(QtWidgets.QDialog):
 
         login_input = QtWidgets.QLineEdit(
             login_widget,
-            text=kitsu_settings.get("login") if remembered else None,
+            text=user_registry.get_item("login") if remembered else None,
         )
         login_input.setPlaceholderText("Your Kitsu account login...")
 
@@ -63,7 +65,7 @@ class PasswordDialog(QtWidgets.QDialog):
 
         password_input = QtWidgets.QLineEdit(
             password_widget,
-            text=kitsu_settings.get("password") if remembered else None,
+            text=user_registry.get_item("password") if remembered else None,
         )
         password_input.setPlaceholderText("Your password...")
         password_input.setEchoMode(QtWidgets.QLineEdit.Password)
@@ -161,30 +163,23 @@ class PasswordDialog(QtWidgets.QDialog):
         os.environ["KITSU_LOGIN"] = login_value
         os.environ["KITSU_PWD"] = pwd_value
 
-        # Get settings
-        local_settings = get_local_settings()
-        local_settings.setdefault("kitsu", {})
+        # Get user registry
+        user_registry = OpenPypeSecureRegistry("kitsu_user")
 
         # Remember password cases
         if remember:
             # Set local settings
-            local_settings["kitsu"]["login"] = login_value
-            local_settings["kitsu"]["password"] = pwd_value
+            user_registry.set_item("login", login_value)
+            user_registry.set_item("password", pwd_value)
         else:
             # Clear local settings
-            local_settings["kitsu"]["login"] = None
-            local_settings["kitsu"]["password"] = None
+            user_registry.delete_item("login")
+            user_registry.delete_item("password")
 
             # Clear input fields
             self.login_input.clear()
             self.password_input.clear()
 
-        # Keep 'remember' parameter
-        local_settings["kitsu"]["remember"] = remember
-
-        # Save settings
-        save_local_settings(local_settings)
-
         self._final_result = True
         self.close()
 

From c9ea0b3bb262484b43ebd5c1c5d649dcdaf75d7e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 2 Mar 2022 11:49:49 +0100
Subject: [PATCH 0150/1227] Line length max 79

---
 openpype/modules/kitsu/kitsu_module.py  | 28 +++++++++++++++++--------
 openpype/modules/kitsu/kitsu_widgets.py |  7 ++++++-
 2 files changed, 25 insertions(+), 10 deletions(-)

diff --git a/openpype/modules/kitsu/kitsu_module.py b/openpype/modules/kitsu/kitsu_module.py
index ebfa0dbeea..6a2e517832 100644
--- a/openpype/modules/kitsu/kitsu_module.py
+++ b/openpype/modules/kitsu/kitsu_module.py
@@ -10,7 +10,6 @@ from avalon.api import AvalonMongoDB
 from openpype.api import get_project_settings
 from openpype.lib.local_settings import OpenPypeSecureRegistry
 from openpype.modules import OpenPypeModule, ModulesManager
-from openpype.settings.lib import get_local_settings
 from openpype_interfaces import IPluginPaths, ITrayAction
 from .utils.listeners import start_listeners
 from .utils.openpype import (
@@ -126,7 +125,7 @@ def cli_main():
 
 @cli_main.command()
 def sync_zou():
-    """Synchronize Zou server database (Kitsu backend) with openpype database."""
+    """Synchronize Zou database (Kitsu backend) with openpype database."""
     import gazu
 
     # Connect to server
@@ -154,7 +153,9 @@ def sync_zou():
         # Create project
         if zou_project is None:
             raise RuntimeError(
-                f"Project '{project_name}' doesn't exist in Zou database, please create it in Kitsu and add OpenPype user to it before running synchronization."
+                f"Project '{project_name}' doesn't exist in Zou database, "
+                "please create it in Kitsu and add OpenPype user to it before "
+                "running synchronization."
             )
 
         # Update project settings and data
@@ -163,7 +164,8 @@ def sync_zou():
                 {
                     "code": op_project["data"]["code"],
                     "fps": op_project["data"]["fps"],
-                    "resolution": f"{op_project['data']['resolutionWidth']}x{op_project['data']['resolutionHeight']}",
+                    "resolution": f"{op_project['data']['resolutionWidth']}"
+                    f"x{op_project['data']['resolutionHeight']}",
                 }
             )
             gazu.project.update_project_data(
@@ -213,7 +215,8 @@ def sync_zou():
                 new_entity = gazu.asset.new_asset(
                     zou_project, asset_types[0], doc["name"]
                 )
-            # Match case in shot<sequence<episode order to support composed names like 'ep01_sq01_sh01'
+            # Match case in shot<sequence<episode order to support
+            # composed names like 'ep01_sq01_sh01'
             elif match.group(1):  # Shot
                 # Match and check parent doc
                 parent_doc = asset_docs[visual_parent_id]
@@ -221,15 +224,22 @@ def sync_zou():
                 if parent_doc["data"].get("zou", {}).get("type") != "Sequence":
                     # Substitute name
                     digits_padding = naming_pattern["sequence"].count("#")
+                    episode_name = naming_pattern["episode"].replace(
+                        "#" * digits_padding, "1".zfill(digits_padding)
+                    )
+                    sequence_name = naming_pattern["sequence"].replace(
+                        "#" * digits_padding, "1".zfill(digits_padding)
+                    )
                     substitute_sequence_name = (
-                        f'{naming_pattern["episode"].replace("#" * digits_padding, "1".zfill(digits_padding))}_'  # Episode
-                        f'{naming_pattern["sequence"].replace("#" * digits_padding, "1".zfill(digits_padding))}'  # Sequence
+                        f"{episode_name}_{sequence_name}"
                     )
 
                     # Warn
                     print(
-                        f"Shot {doc['name']} must be parented to a Sequence in Kitsu. "
-                        f"Creating automatically one substitute sequence called {substitute_sequence_name} in Kitsu..."
+                        f"Shot {doc['name']} must be parented to a Sequence "
+                        "in Kitsu. "
+                        f"Creating automatically one substitute sequence "
+                        f"called {substitute_sequence_name} in Kitsu..."
                     )
 
                     # Create new sequence and set it as substitute
diff --git a/openpype/modules/kitsu/kitsu_widgets.py b/openpype/modules/kitsu/kitsu_widgets.py
index 1a48e6dbc0..4beb14fa97 100644
--- a/openpype/modules/kitsu/kitsu_widgets.py
+++ b/openpype/modules/kitsu/kitsu_widgets.py
@@ -37,8 +37,13 @@ class PasswordDialog(QtWidgets.QDialog):
         )
 
         # Server label
+        server_message = (
+            system_settings["modules"]["kitsu"]["server"]
+            if self._connectable
+            else "no server url set in Studio Settings..."
+        )
         server_label = QtWidgets.QLabel(
-            f"Server: {system_settings['modules']['kitsu']['server'] if self._connectable else 'no server url set in Studio Settings...'}",
+            f"Server: {server_message}",
             self,
         )
 

From ae783773cd2c58c9762b9ddedd0f4a650de3f251 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 2 Mar 2022 12:11:05 +0100
Subject: [PATCH 0151/1227] Rename module to Kitsu Connect

---
 openpype/modules/kitsu/kitsu_module.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/kitsu_module.py b/openpype/modules/kitsu/kitsu_module.py
index 6a2e517832..d5e744ceb5 100644
--- a/openpype/modules/kitsu/kitsu_module.py
+++ b/openpype/modules/kitsu/kitsu_module.py
@@ -22,7 +22,7 @@ from .utils.openpype import (
 class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
     """Kitsu module class."""
 
-    label = "Kitsu"
+    label = "Kitsu Connect"
     name = "kitsu"
 
     def initialize(self, settings):

From c39bdee4330b1578cfe821d0506dbc7b59373621 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 3 Mar 2022 15:50:35 +0100
Subject: [PATCH 0152/1227] Refactor for login system following
 recommendations.

---
 openpype/modules/kitsu/kitsu_module.py        | 457 ++----------------
 openpype/modules/kitsu/kitsu_widgets.py       |  59 +--
 .../kitsu/plugins/publish/kitsu_plugin.py     |   2 +-
 openpype/modules/kitsu/utils/credentials.py   |  92 ++++
 .../utils/{listeners.py => sync_service.py}   | 238 +++++----
 .../{openpype.py => update_op_with_zou.py}    | 153 +++++-
 .../modules/kitsu/utils/update_zou_with_op.py | 262 ++++++++++
 7 files changed, 717 insertions(+), 546 deletions(-)
 create mode 100644 openpype/modules/kitsu/utils/credentials.py
 rename openpype/modules/kitsu/utils/{listeners.py => sync_service.py} (54%)
 rename openpype/modules/kitsu/utils/{openpype.py => update_op_with_zou.py} (52%)
 create mode 100644 openpype/modules/kitsu/utils/update_zou_with_op.py

diff --git a/openpype/modules/kitsu/kitsu_module.py b/openpype/modules/kitsu/kitsu_module.py
index d5e744ceb5..dca6133e88 100644
--- a/openpype/modules/kitsu/kitsu_module.py
+++ b/openpype/modules/kitsu/kitsu_module.py
@@ -2,21 +2,9 @@
 
 import click
 import os
-import re
 
-from pymongo import DeleteOne, UpdateOne
-
-from avalon.api import AvalonMongoDB
-from openpype.api import get_project_settings
-from openpype.lib.local_settings import OpenPypeSecureRegistry
-from openpype.modules import OpenPypeModule, ModulesManager
+from openpype.modules import OpenPypeModule
 from openpype_interfaces import IPluginPaths, ITrayAction
-from .utils.listeners import start_listeners
-from .utils.openpype import (
-    create_op_asset,
-    sync_project,
-    update_op_assets,
-)
 
 
 class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
@@ -29,9 +17,6 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
         """Initialization of module."""
         module_settings = settings[self.name]
 
-        # Get user registry
-        user_registry = OpenPypeSecureRegistry("kitsu_user")
-
         # Enabled by settings
         self.enabled = module_settings.get("enabled", False)
 
@@ -44,66 +29,58 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
 
             # Check for "/api" url validity
             if not kitsu_url.endswith("api"):
-                kitsu_url = (
-                    f"{kitsu_url}{'' if kitsu_url.endswith('/') else '/'}api"
+                kitsu_url = "{}{}api".format(
+                    kitsu_url, "" if kitsu_url.endswith("/") else "/"
                 )
 
         self.server_url = kitsu_url
 
-        # Set credentials
-        self.kitsu_login = user_registry.get_item("login", None)
-        self.kitsu_password = user_registry.get_item("password", None)
-
-        # Prepare variables that can be used or set afterwards
-        self._connected_modules = None
         # UI which must not be created at this time
         self._dialog = None
 
     def tray_init(self):
-        """Implementation of abstract method for `ITrayAction`.
-
-        We're definitely  in tray tool so we can pre create dialog.
-        """
+        """Tray init."""
 
         self._create_dialog()
 
+    def tray_start(self):
+        """Tray start."""
+        from .utils.credentials import (
+            load_credentials,
+            validate_credentials,
+            set_credentials_envs,
+        )
+
+        username, password = load_credentials()
+
+        # Check credentials, ask them if needed
+        if validate_credentials(username, password):
+            set_credentials_envs(username, password)
+        else:
+            self.show_dialog()
+
     def get_global_environments(self):
         """Kitsu's global environments."""
-        return {
-            "KITSU_SERVER": self.server_url,
-            "KITSU_LOGIN": self.kitsu_login,
-            "KITSU_PWD": self.kitsu_password,
-        }
+        return {"KITSU_SERVER": self.server_url}
 
     def _create_dialog(self):
         # Don't recreate dialog if already exists
         if self._dialog is not None:
             return
 
-        from .kitsu_widgets import PasswordDialog
+        from .kitsu_widgets import KitsuPasswordDialog
 
-        self._dialog = PasswordDialog()
+        self._dialog = KitsuPasswordDialog()
 
     def show_dialog(self):
-        """Show dialog with connected modules.
+        """Show dialog to log-in."""
 
-        This can be called from anywhere but can also crash in headless mode.
-        There is no way to prevent addon to do invalid operations if he's
-        not handling them.
-        """
         # Make sure dialog is created
         self._create_dialog()
+
         # Show dialog
         self._dialog.open()
 
-    def get_connected_modules(self):
-        """Custom implementation of addon."""
-        names = set()
-        if self._connected_modules is not None:
-            for module in self._connected_modules:
-                names.add(module.name)
-        return names
-
     def on_action_trigger(self):
         """Implementation of abstract method for `ITrayAction`."""
         self.show_dialog()
@@ -124,372 +101,36 @@ def cli_main():
 
 
 @cli_main.command()
-def sync_zou():
-    """Synchronize Zou database (Kitsu backend) with openpype database."""
-    import gazu
-
-    # Connect to server
-    gazu.client.set_host(os.environ["KITSU_SERVER"])
-
-    # Authenticate
-    gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
-
-    # Iterate projects
-    dbcon = AvalonMongoDB()
-    dbcon.install()
-
-    op_projects = [p for p in dbcon.projects()]
-    bulk_writes = []
-    for op_project in op_projects:
-        # Create project locally
-        # Try to find project document
-        project_name = op_project["name"]
-        dbcon.Session["AVALON_PROJECT"] = project_name
-
-        # Get all entities from zou
-        print(f"Synchronizing {project_name}...")
-        zou_project = gazu.project.get_project_by_name(project_name)
-
-        # Create project
-        if zou_project is None:
-            raise RuntimeError(
-                f"Project '{project_name}' doesn't exist in Zou database, "
-                "please create it in Kitsu and add OpenPype user to it before "
-                "running synchronization."
-            )
-
-        # Update project settings and data
-        if op_project["data"]:
-            zou_project.update(
-                {
-                    "code": op_project["data"]["code"],
-                    "fps": op_project["data"]["fps"],
-                    "resolution": f"{op_project['data']['resolutionWidth']}"
-                    f"x{op_project['data']['resolutionHeight']}",
-                }
-            )
-            gazu.project.update_project_data(
-                zou_project, data=op_project["data"]
-            )
-        gazu.project.update_project(zou_project)
-
-        asset_types = gazu.asset.all_asset_types()
-        all_assets = gazu.asset.all_assets_for_project(zou_project)
-        all_episodes = gazu.shot.all_episodes_for_project(zou_project)
-        all_seqs = gazu.shot.all_sequences_for_project(zou_project)
-        all_shots = gazu.shot.all_shots_for_project(zou_project)
-        all_entities_ids = {
-            e["id"] for e in all_episodes + all_seqs + all_shots + all_assets
-        }
-
-        # Query all assets of the local project
-        project_module_settings = get_project_settings(project_name)["kitsu"]
-        project_col = dbcon.database[project_name]
-        asset_docs = {
-            asset_doc["_id"]: asset_doc
-            for asset_doc in project_col.find({"type": "asset"})
-        }
-
-        # Create new assets
-        new_assets_docs = [
-            doc
-            for doc in asset_docs.values()
-            if doc["data"].get("zou", {}).get("id") not in all_entities_ids
-        ]
-        naming_pattern = project_module_settings["entities_naming_pattern"]
-        regex_ep = re.compile(
-            r"(.*{}.*)|(.*{}.*)|(.*{}.*)".format(
-                naming_pattern["shot"].replace("#", ""),
-                naming_pattern["sequence"].replace("#", ""),
-                naming_pattern["episode"].replace("#", ""),
-            ),
-            re.IGNORECASE,
-        )
-        for doc in new_assets_docs:
-            visual_parent_id = doc["data"]["visualParent"]
-            parent_substitutes = []
-
-            # Match asset type by it's name
-            match = regex_ep.match(doc["name"])
-            if not match:  # Asset
-                new_entity = gazu.asset.new_asset(
-                    zou_project, asset_types[0], doc["name"]
-                )
-            # Match case in shot<sequence<episode order to support
-            # composed names like 'ep01_sq01_sh01'
-            elif match.group(1):  # Shot
-                # Match and check parent doc
-                parent_doc = asset_docs[visual_parent_id]
-                zou_parent_id = parent_doc["data"]["zou"]["id"]
-                if parent_doc["data"].get("zou", {}).get("type") != "Sequence":
-                    # Substitute name
-                    digits_padding = naming_pattern["sequence"].count("#")
-                    episode_name = naming_pattern["episode"].replace(
-                        "#" * digits_padding, "1".zfill(digits_padding)
-                    )
-                    sequence_name = naming_pattern["sequence"].replace(
-                        "#" * digits_padding, "1".zfill(digits_padding)
-                    )
-                    substitute_sequence_name = (
-                        f"{episode_name}_{sequence_name}"
-                    )
-
-                    # Warn
-                    print(
-                        f"Shot {doc['name']} must be parented to a Sequence "
-                        "in Kitsu. "
-                        f"Creating automatically one substitute sequence "
-                        f"called {substitute_sequence_name} in Kitsu..."
-                    )
-
-                    # Create new sequence and set it as substitute
-                    created_sequence = gazu.shot.new_sequence(
-                        zou_project,
-                        substitute_sequence_name,
-                        episode=zou_parent_id,
-                    )
-                    gazu.shot.update_sequence_data(
-                        created_sequence, {"is_substitute": True}
-                    )
-                    parent_substitutes.append(created_sequence)
-
-                    # Update parent ID
-                    zou_parent_id = created_sequence["id"]
-
-                # Create shot
-                new_entity = gazu.shot.new_shot(
-                    zou_project,
-                    zou_parent_id,
-                    doc["name"],
-                    frame_in=doc["data"]["frameStart"],
-                    frame_out=doc["data"]["frameEnd"],
-                    nb_frames=doc["data"]["frameEnd"]
-                    - doc["data"]["frameStart"],
-                )
-
-            elif match.group(2):  # Sequence
-                parent_doc = asset_docs[visual_parent_id]
-                new_entity = gazu.shot.new_sequence(
-                    zou_project,
-                    doc["name"],
-                    episode=parent_doc["data"]["zou"]["id"],
-                )
-
-            elif match.group(3):  # Episode
-                new_entity = gazu.shot.new_episode(zou_project, doc["name"])
-
-            # Update doc with zou id
-            doc["data"].update(
-                {
-                    "visualParent": visual_parent_id,
-                    "zou": new_entity,
-                }
-            )
-            bulk_writes.append(
-                UpdateOne(
-                    {"_id": doc["_id"]},
-                    {
-                        "$set": {
-                            "data.visualParent": visual_parent_id,
-                            "data.zou": new_entity,
-                            "data.parent_substitutes": parent_substitutes,
-                        }
-                    },
-                )
-            )
-
-        # Update assets
-        all_tasks_types = {t["name"]: t for t in gazu.task.all_task_types()}
-        assets_docs_to_update = [
-            doc
-            for doc in asset_docs.values()
-            if doc["data"].get("zou", {}).get("id") in all_entities_ids
-        ]
-        for doc in assets_docs_to_update:
-            zou_id = doc["data"]["zou"]["id"]
-            if zou_id:
-                # Data
-                entity_data = {}
-                frame_in = doc["data"].get("frameStart")
-                frame_out = doc["data"].get("frameEnd")
-                if frame_in or frame_out:
-                    entity_data.update(
-                        {
-                            "data": {
-                                "frame_in": frame_in,
-                                "frame_out": frame_out,
-                            },
-                            "nb_frames": frame_out - frame_in,
-                        }
-                    )
-                entity = gazu.raw.update("entities", zou_id, entity_data)
-
-                # Tasks
-                all_tasks_func = getattr(
-                    gazu.task, f"all_tasks_for_{entity['type'].lower()}"
-                )
-                entity_tasks = {t["name"] for t in all_tasks_func(entity)}
-                for task_name in doc["data"]["tasks"].keys():
-                    # Create only if new
-                    if task_name not in entity_tasks:
-                        task_type = all_tasks_types.get(task_name)
-
-                        # Create non existing task
-                        if not task_type:
-                            task_type = gazu.task.new_task_type(task_name)
-                            all_tasks_types[task_name] = task_type
-
-                        # New task for entity
-                        gazu.task.new_task(entity, task_type)
-
-        # Delete
-        deleted_entities = all_entities_ids - {
-            asset_doc["data"].get("zou", {}).get("id")
-            for asset_doc in asset_docs.values()
-        }
-        for entity_id in deleted_entities:
-            gazu.raw.delete(f"data/entities/{entity_id}")
-
-        # Write into DB
-        if bulk_writes:
-            project_col.bulk_write(bulk_writes)
-
-    dbcon.uninstall()
-
-
-@cli_main.command()
+@click.option("--login", envvar="KITSU_LOGIN", help="Kitsu login")
 @click.option(
-    "-l",
-    "--listen",
-    is_flag=True,
-    help="Listen Kitsu server after synchronization.",
+    "--password", envvar="KITSU_PWD", help="Password for kitsu username"
 )
-def sync_openpype(listen: bool):
-    """Synchronize openpype database from Zou sever database."""
-    import gazu
+def push_to_zou(login: str, password: str):
+    """Synchronize Zou database (Kitsu backend) with openpype database.
 
-    # Connect to server
-    gazu.client.set_host(os.environ["KITSU_SERVER"])
+    Args:
+        login (str): Kitsu user login
+        password (str): Kitsu user password
+    """
+    from .utils.update_zou_with_op import sync_zou
 
-    # Authenticate
-    kitsu_login = os.environ.get("KITSU_LOGIN")
-    kitsu_pwd = os.environ.get("KITSU_PWD")
-    if not kitsu_login or not kitsu_pwd:  # Sentinel to log-in
-        log_in_dialog()
-        return
-
-    gazu.log_in(kitsu_login, kitsu_pwd)
-
-    # Iterate projects
-    dbcon = AvalonMongoDB()
-    dbcon.install()
-    all_projects = gazu.project.all_projects()
-    bulk_writes = []
-    for project in all_projects:
-        # Create project locally
-        # Try to find project document
-        project_name = project["name"]
-        project_code = project_name
-        dbcon.Session["AVALON_PROJECT"] = project_name
-        project_doc = dbcon.find_one({"type": "project"})
-
-        print(f"Synchronizing {project_name}...")
-
-        # Get all assets from zou
-        all_assets = gazu.asset.all_assets_for_project(project)
-        all_episodes = gazu.shot.all_episodes_for_project(project)
-        all_seqs = gazu.shot.all_sequences_for_project(project)
-        all_shots = gazu.shot.all_shots_for_project(project)
-        all_entities = [
-            e
-            for e in all_assets + all_episodes + all_seqs + all_shots
-            if e["data"] and not e["data"].get("is_substitute")
-        ]
-
-        # Sync project. Create if doesn't exist
-        bulk_writes.append(sync_project(project, dbcon))
-
-        # Query all assets of the local project
-        project_col = dbcon.database[project_code]
-        zou_ids_and_asset_docs = {
-            asset_doc["data"]["zou"]["id"]: asset_doc
-            for asset_doc in project_col.find({"type": "asset"})
-            if asset_doc["data"].get("zou", {}).get("id")
-        }
-        zou_ids_and_asset_docs[project["id"]] = project_doc
-
-        # Create
-        to_insert = []
-        to_insert.extend(
-            [
-                create_op_asset(item)
-                for item in all_entities
-                if item["id"] not in zou_ids_and_asset_docs.keys()
-            ]
-        )
-        if to_insert:
-            # Insert doc in DB
-            project_col.insert_many(to_insert)
-
-            # Update existing docs
-            zou_ids_and_asset_docs.update(
-                {
-                    asset_doc["data"]["zou"]["id"]: asset_doc
-                    for asset_doc in project_col.find({"type": "asset"})
-                    if asset_doc["data"].get("zou")
-                }
-            )
-
-        # Update
-        bulk_writes.extend(
-            [
-                UpdateOne({"_id": id}, update)
-                for id, update in update_op_assets(
-                    all_entities, zou_ids_and_asset_docs
-                )
-            ]
-        )
-
-        # Delete
-        diff_assets = set(zou_ids_and_asset_docs.keys()) - {
-            e["id"] for e in all_entities + [project]
-        }
-        if diff_assets:
-            bulk_writes.extend(
-                [
-                    DeleteOne(zou_ids_and_asset_docs[asset_id])
-                    for asset_id in diff_assets
-                ]
-            )
-
-        # Write into DB
-        if bulk_writes:
-            project_col.bulk_write(bulk_writes)
-
-    dbcon.uninstall()
-
-    # Run listening
-    if listen:
-        start_listeners()
+    sync_zou(login, password)
 
 
 @cli_main.command()
-def listen():
-    """Listen to Kitsu server."""
-    start_listeners()
+@click.option("-l", "--login", envvar="KITSU_LOGIN", help="Kitsu login")
+@click.option(
+    "-p", "--password", envvar="KITSU_PWD", help="Password for kitsu username"
+)
+def sync_service(login: str, password: str):
+    """Synchronize openpype database from Zou sever database.
 
+    Args:
+        login (str): Kitsu user login
+        password (str): Kitsu user password
+    """
+    from .utils.update_op_with_zou import sync_all_project
+    from .utils.sync_service import start_listeners
 
-@cli_main.command()
-def sign_in():
-    """Sign-in command."""
-    log_in_dialog()
-
-
-def log_in_dialog():
-    """Show credentials dialog."""
-    from openpype.tools.utils.lib import qt_app_context
-
-    manager = ModulesManager()
-    kitsu_addon = manager.modules_by_name[KitsuModule.name]
-    with qt_app_context():
-        kitsu_addon.show_dialog()
+    sync_all_project(login, password)
+    start_listeners(login, password)
diff --git a/openpype/modules/kitsu/kitsu_widgets.py b/openpype/modules/kitsu/kitsu_widgets.py
index 4beb14fa97..65baed9665 100644
--- a/openpype/modules/kitsu/kitsu_widgets.py
+++ b/openpype/modules/kitsu/kitsu_widgets.py
@@ -1,10 +1,13 @@
-import os
-
-import gazu
 from Qt import QtWidgets, QtCore, QtGui
 
 from openpype import style
-from openpype.lib.local_settings import OpenPypeSecureRegistry
+from openpype.modules.kitsu.utils.credentials import (
+    clear_credentials,
+    load_credentials,
+    save_credentials,
+    set_credentials_envs,
+    validate_credentials,
+)
 from openpype.resources import get_resource
 from openpype.settings.lib import (
     get_system_settings,
@@ -13,23 +16,20 @@ from openpype.settings.lib import (
 from openpype.widgets.password_dialog import PressHoverButton
 
 
-class PasswordDialog(QtWidgets.QDialog):
-    """Stupidly simple dialog to compare password from general settings."""
+class KitsuPasswordDialog(QtWidgets.QDialog):
+    """Kitsu login dialog."""
 
     finished = QtCore.Signal(bool)
 
     def __init__(self, parent=None):
-        super(PasswordDialog, self).__init__(parent)
+        super(KitsuPasswordDialog, self).__init__(parent)
 
         self.setWindowTitle("Kitsu Credentials")
         self.resize(300, 120)
 
         system_settings = get_system_settings()
-        user_registry = OpenPypeSecureRegistry("kitsu_user")
-        remembered = bool(
-            user_registry.get_item("login", None)
-            or user_registry.get_item("password", None)
-        )
+        user_login, user_pwd = load_credentials()
+        remembered = bool(user_login or user_pwd)
 
         self._final_result = None
         self._connectable = bool(
@@ -54,7 +54,7 @@ class PasswordDialog(QtWidgets.QDialog):
 
         login_input = QtWidgets.QLineEdit(
             login_widget,
-            text=user_registry.get_item("login") if remembered else None,
+            text=user_login if remembered else None,
         )
         login_input.setPlaceholderText("Your Kitsu account login...")
 
@@ -70,7 +70,7 @@ class PasswordDialog(QtWidgets.QDialog):
 
         password_input = QtWidgets.QLineEdit(
             password_widget,
-            text=user_registry.get_item("password") if remembered else None,
+            text=user_pwd if remembered else None,
         )
         password_input.setPlaceholderText("Your password...")
         password_input.setEchoMode(QtWidgets.QLineEdit.Password)
@@ -96,9 +96,7 @@ class PasswordDialog(QtWidgets.QDialog):
 
         remember_checkbox = QtWidgets.QCheckBox("Remember", buttons_widget)
         remember_checkbox.setObjectName("RememberCheckbox")
-        remember_checkbox.setChecked(
-            remembered if remembered is not None else True
-        )
+        remember_checkbox.setChecked(remembered)
 
         ok_btn = QtWidgets.QPushButton("Ok", buttons_widget)
         cancel_btn = QtWidgets.QPushButton("Cancel", buttons_widget)
@@ -139,10 +137,10 @@ class PasswordDialog(QtWidgets.QDialog):
         if event.key() in (QtCore.Qt.Key_Return, QtCore.Qt.Key_Enter):
             self._on_ok_click()
             return event.accept()
-        super(PasswordDialog, self).keyPressEvent(event)
+        super(KitsuPasswordDialog, self).keyPressEvent(event)
 
     def closeEvent(self, event):
-        super(PasswordDialog, self).closeEvent(event)
+        super(KitsuPasswordDialog, self).closeEvent(event)
         self.finished.emit(self.result())
 
     def _on_ok_click(self):
@@ -158,28 +156,19 @@ class PasswordDialog(QtWidgets.QDialog):
         pwd_value = self.password_input.text()
         remember = self.remember_checkbox.isChecked()
 
-        # Connect to server
-        gazu.client.set_host(os.environ["KITSU_SERVER"])
-
         # Authenticate
-        gazu.log_in(login_value, pwd_value)
-
-        # Set logging-in env vars
-        os.environ["KITSU_LOGIN"] = login_value
-        os.environ["KITSU_PWD"] = pwd_value
-
-        # Get user registry
-        user_registry = OpenPypeSecureRegistry("kitsu_user")
+        if validate_credentials(login_value, pwd_value):
+            set_credentials_envs(login_value, pwd_value)
+        else:
+            self.message_label.setText("Authentication failed...")
+            return
 
         # Remember password cases
         if remember:
-            # Set local settings
-            user_registry.set_item("login", login_value)
-            user_registry.set_item("password", pwd_value)
+            save_credentials(login_value, pwd_value)
         else:
             # Clear local settings
-            user_registry.delete_item("login")
-            user_registry.delete_item("password")
+            clear_credentials()
 
             # Clear input fields
             self.login_input.clear()
diff --git a/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py b/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
index 24f1e4e80c..b556f2b91f 100644
--- a/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
+++ b/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
@@ -40,6 +40,6 @@ class IntegrateRig(pyblish.api.InstancePlugin):
             entity_task,
             entity_task["task_status_id"],
             comment=f"Version {instance.data['version']} has been published!",
-        )
+        )  # TODO add comment from pyblish
 
         self.log.info("Version published to Kitsu successfully!")
diff --git a/openpype/modules/kitsu/utils/credentials.py b/openpype/modules/kitsu/utils/credentials.py
new file mode 100644
index 0000000000..b4dd5ee4a2
--- /dev/null
+++ b/openpype/modules/kitsu/utils/credentials.py
@@ -0,0 +1,92 @@
+"""Kitsu credentials functions."""
+
+import os
+from typing import Tuple
+import gazu
+
+from openpype.lib.local_settings import OpenPypeSecureRegistry
+
+
+def validate_credentials(
+    login: str, password: str, kitsu_url: str = os.environ.get("KITSU_SERVER")
+) -> bool:
+    """Validate credentials by trying to connect to Kitsu host URL.
+
+    :param login: Kitsu Login
+    :param password: Kitsu Password
+    :param kitsu_url: Kitsu host URL
+    :return: Are credentials valid?
+    """
+    # Connect to server
+    validate_host(kitsu_url)
+
+    # Authenticate
+    try:
+        gazu.log_in(login, password)
+    except gazu.exception.AuthFailedException:
+        return False
+
+    return True
+
+
+def validate_host(kitsu_url: str) -> bool:
+    """Validate credentials by trying to connect to Kitsu host URL.
+
+    :param kitsu_url: Kitsu host URL
+    :return: Is host valid?
+    """
+    # Connect to server
+    gazu.set_host(kitsu_url)
+
+    # Test host
+    if gazu.client.host_is_valid():
+        return True
+    else:
+        raise gazu.exception.HostException(f"Host '{kitsu_url}' is invalid.")
+
+
+def clear_credentials():
+    """Clear credentials in Secure Registry."""
+    # Get user registry
+    user_registry = OpenPypeSecureRegistry("kitsu_user")
+
+    # Set local settings
+    user_registry.delete_item("login")
+    user_registry.delete_item("password")
+
+
+def save_credentials(login: str, password: str):
+    """Save credentials in Secure Registry.
+
+    :param login: Kitsu Login
+    :param password: Kitsu Password
+    """
+    # Get user registry
+    user_registry = OpenPypeSecureRegistry("kitsu_user")
+
+    # Set local settings
+    user_registry.set_item("login", login)
+    user_registry.set_item("password", password)
+
+
+def load_credentials() -> Tuple[str, str]:
+    """Load registered credentials.
+
+    :return: Login, Password
+    """
+    # Get user registry
+    user_registry = OpenPypeSecureRegistry("kitsu_user")
+
+    return user_registry.get_item("login", None), user_registry.get_item(
+        "password", None
+    )
+
+
+def set_credentials_envs(login: str, password: str):
+    """Set environment variables with Kitsu login and password.
+
+    :param login: Kitsu Login
+    :param password: Kitsu Password
+    """
+    os.environ["KITSU_LOGIN"] = login
+    os.environ["KITSU_PWD"] = password
diff --git a/openpype/modules/kitsu/utils/listeners.py b/openpype/modules/kitsu/utils/sync_service.py
similarity index 54%
rename from openpype/modules/kitsu/utils/listeners.py
rename to openpype/modules/kitsu/utils/sync_service.py
index 3768b4e8e6..831673ec0d 100644
--- a/openpype/modules/kitsu/utils/listeners.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -1,72 +1,143 @@
 import os
 
+import gazu
+
 from avalon.api import AvalonMongoDB
-from .openpype import (
+from .credentials import load_credentials, validate_credentials
+from .update_op_with_zou import (
     create_op_asset,
     set_op_project,
-    sync_project,
+    write_project_to_op,
     update_op_assets,
 )
 
 
-def start_listeners():
-    """Start listeners to keep OpenPype up-to-date with Kitsu."""
-    import gazu
+class Listener:
+    """Host Kitsu listener."""
 
-    # Connect to server
-    gazu.client.set_host(os.environ["KITSU_SERVER"])
+    def __init__(self, login, password):
+        """Create client and add listeners to events without starting it.
 
-    # Authenticate
-    gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
-    gazu.set_event_host(os.environ["KITSU_SERVER"].replace("api", "socket.io"))
-    event_client = gazu.events.init()
+            Run `listener.start()` to actually start the service.
 
-    # Connect to DB
-    dbcon = AvalonMongoDB()
-    dbcon.install()
+        Args:
+            login (str): Kitsu user login
+            password (str): Kitsu user password
+
+        Raises:
+            AuthFailedException: Wrong user login and/or password
+        """
+        self.dbcon = AvalonMongoDB()
+        self.dbcon.install()
+
+        gazu.client.set_host(os.environ["KITSU_SERVER"])
+
+        # Authenticate
+        if not validate_credentials(login, password):
+            raise gazu.exception.AuthFailedException(
+                f"Kitsu authentication failed for login: '{login}'..."
+            )
+
+        gazu.set_event_host(
+            os.environ["KITSU_SERVER"].replace("api", "socket.io")
+        )
+        self.event_client = gazu.events.init()
+
+        gazu.events.add_listener(
+            self.event_client, "project:new", self._new_project
+        )
+        gazu.events.add_listener(
+            self.event_client, "project:update", self._update_project
+        )
+        gazu.events.add_listener(
+            self.event_client, "project:delete", self._delete_project
+        )
+
+        gazu.events.add_listener(
+            self.event_client, "asset:new", self._new_asset
+        )
+        gazu.events.add_listener(
+            self.event_client, "asset:update", self._update_asset
+        )
+        gazu.events.add_listener(
+            self.event_client, "asset:delete", self._delete_asset
+        )
+
+        gazu.events.add_listener(
+            self.event_client, "episode:new", self._new_episode
+        )
+        gazu.events.add_listener(
+            self.event_client, "episode:update", self._update_episode
+        )
+        gazu.events.add_listener(
+            self.event_client, "episode:delete", self._delete_episode
+        )
+
+        gazu.events.add_listener(
+            self.event_client, "sequence:new", self._new_sequence
+        )
+        gazu.events.add_listener(
+            self.event_client, "sequence:update", self._update_sequence
+        )
+        gazu.events.add_listener(
+            self.event_client, "sequence:delete", self._delete_sequence
+        )
+
+        gazu.events.add_listener(self.event_client, "shot:new", self._new_shot)
+        gazu.events.add_listener(
+            self.event_client, "shot:update", self._update_shot
+        )
+        gazu.events.add_listener(
+            self.event_client, "shot:delete", self._delete_shot
+        )
+
+        gazu.events.add_listener(self.event_client, "task:new", self._new_task)
+        gazu.events.add_listener(
+            self.event_client, "task:update", self._update_task
+        )
+        gazu.events.add_listener(
+            self.event_client, "task:delete", self._delete_task
+        )
+
+    def start(self):
+        gazu.events.run_client(self.event_client)
 
     # == Project ==
-
-    def new_project(data):
+    def _new_project(self, data):
         """Create new project into OP DB."""
 
         # Use update process to avoid duplicating code
-        update_project(data)
+        self._update_project(data)
 
-    def update_project(data):
+    def _update_project(self, data):
         """Update project into OP DB."""
         # Get project entity
         project = gazu.project.get_project(data["project_id"])
         project_name = project["name"]
-        dbcon.Session["AVALON_PROJECT"] = project_name
 
-        update_project = sync_project(project, dbcon)
+        update_project = write_project_to_op(project, self.dbcon)
 
         # Write into DB
         if update_project:
-            project_col = dbcon.database[project_name]
+            project_col = self.dbcon.database[project_name]
             project_col.bulk_write([update_project])
 
-    def delete_project(data):
+    def _delete_project(self, data):
         """Delete project."""
         # Get project entity
         print(data)  # TODO check bugfix
         project = gazu.project.get_project(data["project_id"])
 
         # Delete project collection
-        project_col = dbcon.database[project["name"]]
+        project_col = self.dbcon.database[project["name"]]
         project_col.drop()
 
-    gazu.events.add_listener(event_client, "project:new", new_project)
-    gazu.events.add_listener(event_client, "project:update", update_project)
-    gazu.events.add_listener(event_client, "project:delete", delete_project)
-
     # == Asset ==
 
-    def new_asset(data):
+    def _new_asset(self, data):
         """Create new asset into OP DB."""
         # Get project entity
-        project_col = set_op_project(dbcon, data["project_id"])
+        project_col = set_op_project(self.dbcon, data["project_id"])
 
         # Get gazu entity
         asset = gazu.asset.get_asset(data["asset_id"])
@@ -75,12 +146,12 @@ def start_listeners():
         project_col.insert_one(create_op_asset(asset))
 
         # Update
-        update_asset(data)
+        self._update_asset(data)
 
-    def update_asset(data):
+    def _update_asset(self, data):
         """Update asset into OP DB."""
-        project_col = set_op_project(dbcon, data["project_id"])
-        project_doc = dbcon.find_one({"type": "project"})
+        project_col = set_op_project(self.dbcon, data["project_id"])
+        project_doc = self.dbcon.find_one({"type": "project"})
 
         # Get gazu entity
         asset = gazu.asset.get_asset(data["asset_id"])
@@ -100,24 +171,20 @@ def start_listeners():
         )[0]
         project_col.update_one({"_id": asset_doc_id}, asset_update)
 
-    def delete_asset(data):
+    def _delete_asset(self, data):
         """Delete asset of OP DB."""
-        project_col = set_op_project(dbcon, data["project_id"])
+        project_col = set_op_project(self.dbcon, data["project_id"])
 
         # Delete
         project_col.delete_one(
             {"type": "asset", "data.zou.id": data["asset_id"]}
         )
 
-    gazu.events.add_listener(event_client, "asset:new", new_asset)
-    gazu.events.add_listener(event_client, "asset:update", update_asset)
-    gazu.events.add_listener(event_client, "asset:delete", delete_asset)
-
     # == Episode ==
-    def new_episode(data):
+    def _new_episode(self, data):
         """Create new episode into OP DB."""
         # Get project entity
-        project_col = set_op_project(dbcon, data["project_id"])
+        project_col = set_op_project(self.dbcon, data["project_id"])
 
         # Get gazu entity
         episode = gazu.shot.get_episode(data["episode_id"])
@@ -126,12 +193,12 @@ def start_listeners():
         project_col.insert_one(create_op_asset(episode))
 
         # Update
-        update_episode(data)
+        self._update_episode(data)
 
-    def update_episode(data):
+    def _update_episode(self, data):
         """Update episode into OP DB."""
-        project_col = set_op_project(dbcon, data["project_id"])
-        project_doc = dbcon.find_one({"type": "project"})
+        project_col = set_op_project(self.dbcon, data["project_id"])
+        project_doc = self.dbcon.find_one({"type": "project"})
 
         # Get gazu entity
         episode = gazu.shot.get_episode(data["episode_id"])
@@ -151,9 +218,9 @@ def start_listeners():
         )[0]
         project_col.update_one({"_id": asset_doc_id}, asset_update)
 
-    def delete_episode(data):
+    def _delete_episode(self, data):
         """Delete shot of OP DB."""
-        project_col = set_op_project(dbcon, data["project_id"])
+        project_col = set_op_project(self.dbcon, data["project_id"])
         print("delete episode")  # TODO check bugfix
 
         # Delete
@@ -161,15 +228,11 @@ def start_listeners():
             {"type": "asset", "data.zou.id": data["episode_id"]}
         )
 
-    gazu.events.add_listener(event_client, "episode:new", new_episode)
-    gazu.events.add_listener(event_client, "episode:update", update_episode)
-    gazu.events.add_listener(event_client, "episode:delete", delete_episode)
-
     # == Sequence ==
-    def new_sequence(data):
+    def _new_sequence(self, data):
         """Create new sequnce into OP DB."""
         # Get project entity
-        project_col = set_op_project(dbcon, data["project_id"])
+        project_col = set_op_project(self.dbcon, data["project_id"])
 
         # Get gazu entity
         sequence = gazu.shot.get_sequence(data["sequence_id"])
@@ -178,12 +241,12 @@ def start_listeners():
         project_col.insert_one(create_op_asset(sequence))
 
         # Update
-        update_sequence(data)
+        self._update_sequence(data)
 
-    def update_sequence(data):
+    def _update_sequence(self, data):
         """Update sequence into OP DB."""
-        project_col = set_op_project(dbcon, data["project_id"])
-        project_doc = dbcon.find_one({"type": "project"})
+        project_col = set_op_project(self.dbcon, data["project_id"])
+        project_doc = self.dbcon.find_one({"type": "project"})
 
         # Get gazu entity
         sequence = gazu.shot.get_sequence(data["sequence_id"])
@@ -203,9 +266,9 @@ def start_listeners():
         )[0]
         project_col.update_one({"_id": asset_doc_id}, asset_update)
 
-    def delete_sequence(data):
+    def _delete_sequence(self, data):
         """Delete sequence of OP DB."""
-        project_col = set_op_project(dbcon, data["project_id"])
+        project_col = set_op_project(self.dbcon, data["project_id"])
         print("delete sequence")  # TODO check bugfix
 
         # Delete
@@ -213,15 +276,11 @@ def start_listeners():
             {"type": "asset", "data.zou.id": data["sequence_id"]}
         )
 
-    gazu.events.add_listener(event_client, "sequence:new", new_sequence)
-    gazu.events.add_listener(event_client, "sequence:update", update_sequence)
-    gazu.events.add_listener(event_client, "sequence:delete", delete_sequence)
-
     # == Shot ==
-    def new_shot(data):
+    def _new_shot(self, data):
         """Create new shot into OP DB."""
         # Get project entity
-        project_col = set_op_project(dbcon, data["project_id"])
+        project_col = set_op_project(self.dbcon, data["project_id"])
 
         # Get gazu entity
         shot = gazu.shot.get_shot(data["shot_id"])
@@ -230,12 +289,12 @@ def start_listeners():
         project_col.insert_one(create_op_asset(shot))
 
         # Update
-        update_shot(data)
+        self._update_shot(data)
 
-    def update_shot(data):
+    def _update_shot(self, data):
         """Update shot into OP DB."""
-        project_col = set_op_project(dbcon, data["project_id"])
-        project_doc = dbcon.find_one({"type": "project"})
+        project_col = set_op_project(self.dbcon, data["project_id"])
+        project_doc = self.dbcon.find_one({"type": "project"})
 
         # Get gazu entity
         shot = gazu.shot.get_shot(data["shot_id"])
@@ -255,25 +314,20 @@ def start_listeners():
         )[0]
         project_col.update_one({"_id": asset_doc_id}, asset_update)
 
-    def delete_shot(data):
+    def _delete_shot(self, data):
         """Delete shot of OP DB."""
-        project_col = set_op_project(dbcon, data["project_id"])
+        project_col = set_op_project(self.dbcon, data["project_id"])
 
         # Delete
         project_col.delete_one(
             {"type": "asset", "data.zou.id": data["shot_id"]}
         )
 
-    gazu.events.add_listener(event_client, "shot:new", new_shot)
-    gazu.events.add_listener(event_client, "shot:update", update_shot)
-    gazu.events.add_listener(event_client, "shot:delete", delete_shot)
-
     # == Task ==
-    def new_task(data):
+    def _new_task(self, data):
         """Create new task into OP DB."""
-        print("new", data)
         # Get project entity
-        project_col = set_op_project(dbcon, data["project_id"])
+        project_col = set_op_project(self.dbcon, data["project_id"])
 
         # Get gazu entity
         task = gazu.task.get_task(data["task_id"])
@@ -291,14 +345,14 @@ def start_listeners():
             {"_id": asset_doc["_id"]}, {"$set": {"data.tasks": asset_tasks}}
         )
 
-    def update_task(data):
+    def _update_task(self, data):
         """Update task into OP DB."""
         # TODO is it necessary?
         pass
 
-    def delete_task(data):
+    def _delete_task(self, data):
         """Delete task of OP DB."""
-        project_col = set_op_project(dbcon, data["project_id"])
+        project_col = set_op_project(self.dbcon, data["project_id"])
 
         # Find asset doc
         asset_docs = [doc for doc in project_col.find({"type": "asset"})]
@@ -307,7 +361,7 @@ def start_listeners():
             for name, task in doc["data"]["tasks"].items():
                 if task.get("zou") and data["task_id"] == task["zou"]["id"]:
                     # Pop task
-                    asset_tasks = doc["data"].get("tasks")
+                    asset_tasks = doc["data"].get("tasks", {})
                     asset_tasks.pop(name)
 
                     # Delete task in DB
@@ -317,8 +371,20 @@ def start_listeners():
                     )
                     return
 
-    gazu.events.add_listener(event_client, "task:new", new_task)
-    gazu.events.add_listener(event_client, "task:update", update_task)
-    gazu.events.add_listener(event_client, "task:delete", delete_task)
 
-    gazu.events.run_client(event_client)
+def start_listeners(login: str, password: str):
+    """Start listeners to keep OpenPype up-to-date with Kitsu.
+
+    Args:
+        login (str): Kitsu user login
+        password (str): Kitsu user password
+    """
+
+    # Connect to server
+    listener = Listener(login, password)
+    listener.start()
+
+
+if __name__ == "__main__":
+    # TODO not sure when this can be run and if this system is reliable
+    start_listeners(load_credentials())
diff --git a/openpype/modules/kitsu/utils/openpype.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
similarity index 52%
rename from openpype/modules/kitsu/utils/openpype.py
rename to openpype/modules/kitsu/utils/update_op_with_zou.py
index 56c99effff..eb675ad09e 100644
--- a/openpype/modules/kitsu/utils/openpype.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -1,10 +1,17 @@
+"""Functions to update OpenPype data using Kitsu DB (a.k.a Zou)."""
 from typing import Dict, List
 
-from pymongo import UpdateOne
+from pymongo import DeleteOne, UpdateOne
 from pymongo.collection import Collection
+import gazu
+from gazu.task import (
+    all_tasks_for_asset,
+    all_tasks_for_shot,
+)
 
 from avalon.api import AvalonMongoDB
 from openpype.lib import create_project
+from openpype.modules.kitsu.utils.credentials import validate_credentials
 
 
 def create_op_asset(gazu_entity: dict) -> dict:
@@ -26,8 +33,6 @@ def set_op_project(dbcon, project_id) -> Collection:
     :param dbcon: Connection to DB.
     :param project_id: Project zou ID
     """
-    import gazu
-
     project = gazu.project.get_project(project_id)
     project_name = project["name"]
     dbcon.Session["AVALON_PROJECT"] = project_name
@@ -45,11 +50,6 @@ def update_op_assets(
     :param asset_doc_ids: Dicts of [{zou_id: asset_doc}, ...]
     :return: List of (doc_id, update_dict) tuples
     """
-    from gazu.task import (
-        all_tasks_for_asset,
-        all_tasks_for_shot,
-    )
-
     assets_with_update = []
     for item in entities_list:
         # Update asset
@@ -124,18 +124,19 @@ def update_op_assets(
     return assets_with_update
 
 
-def sync_project(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
-    """Sync project with database.
+def write_project_to_op(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
+    """Write gazu project to OP database.
     Create project if doesn't exist.
 
-    :param project: Gazu project
-    :param dbcon: DB to create project in
-    :return: Update instance for the project
-    """
-    import gazu
+    Args:
+        project (dict): Gazu project
+        dbcon (AvalonMongoDB): DB to create project in
 
+    Returns:
+        UpdateOne: Update instance for the project
+    """
     project_name = project["name"]
-    project_doc = dbcon.find_one({"type": "project"})
+    project_doc = dbcon.database[project_name].find_one({"type": "project"})
     if not project_doc:
         print(f"Creating project '{project_name}'")
         project_doc = create_project(project_name, project_name, dbcon=dbcon)
@@ -165,3 +166,123 @@ def sync_project(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
             }
         },
     )
+
+
+def sync_all_project(login: str, password: str):
+    """Update all OP projects in DB with Zou data.
+
+    Args:
+        login (str): Kitsu user login
+        password (str): Kitsu user password
+
+    Raises:
+        gazu.exception.AuthFailedException: Wrong user login and/or password
+    """
+
+    # Authenticate
+    if not validate_credentials(login, password):
+        raise gazu.exception.AuthFailedException(
+            f"Kitsu authentication failed for login: '{login}'..."
+        )
+
+    # Iterate projects
+    dbcon = AvalonMongoDB()
+    dbcon.install()
+    all_projects = gazu.project.all_projects()
+    for project in all_projects:
+        sync_project_from_kitsu(project["name"], dbcon, project)
+
+
+def sync_project_from_kitsu(
+    project_name: str, dbcon: AvalonMongoDB, project: dict = None
+):
+    """Update OP project in DB with Zou data.
+
+    Args:
+        project_name (str): Name of project to sync
+        dbcon (AvalonMongoDB): MongoDB connection
+        project (dict, optional): Project dict got using gazu.
+                                  Defaults to None.
+    """
+    bulk_writes = []
+
+    # Get project from zou
+    if not project:
+        project = gazu.project.get_project_by_name(project_name)
+    project_code = project_name
+
+    # Try to find project document
+    project_col = dbcon.database[project_code]
+    project_doc = project_col.find_one({"type": "project"})
+
+    print(f"Synchronizing {project_name}...")
+
+    # Get all assets from zou
+    all_assets = gazu.asset.all_assets_for_project(project)
+    all_episodes = gazu.shot.all_episodes_for_project(project)
+    all_seqs = gazu.shot.all_sequences_for_project(project)
+    all_shots = gazu.shot.all_shots_for_project(project)
+    all_entities = [
+        e
+        for e in all_assets + all_episodes + all_seqs + all_shots
+        if e["data"] and not e["data"].get("is_substitute")
+    ]
+
+    # Sync project. Create if doesn't exist
+    bulk_writes.append(write_project_to_op(project, dbcon))
+
+    # Query all assets of the local project
+    zou_ids_and_asset_docs = {
+        asset_doc["data"]["zou"]["id"]: asset_doc
+        for asset_doc in project_col.find({"type": "asset"})
+        if asset_doc["data"].get("zou", {}).get("id")
+    }
+    zou_ids_and_asset_docs[project["id"]] = project_doc
+
+    # Create
+    to_insert = []
+    to_insert.extend(
+        [
+            create_op_asset(item)
+            for item in all_entities
+            if item["id"] not in zou_ids_and_asset_docs.keys()
+        ]
+    )
+    if to_insert:
+        # Insert doc in DB
+        project_col.insert_many(to_insert)
+
+        # Update existing docs
+        zou_ids_and_asset_docs.update(
+            {
+                asset_doc["data"]["zou"]["id"]: asset_doc
+                for asset_doc in project_col.find({"type": "asset"})
+                if asset_doc["data"].get("zou")
+            }
+        )
+
+    # Update
+    bulk_writes.extend(
+        [
+            UpdateOne({"_id": id}, update)
+            for id, update in update_op_assets(
+                all_entities, zou_ids_and_asset_docs
+            )
+        ]
+    )
+
+    # Delete
+    diff_assets = set(zou_ids_and_asset_docs.keys()) - {
+        e["id"] for e in all_entities + [project]
+    }
+    if diff_assets:
+        bulk_writes.extend(
+            [
+                DeleteOne(zou_ids_and_asset_docs[asset_id])
+                for asset_id in diff_assets
+            ]
+        )
+
+    # Write into DB
+    if bulk_writes:
+        project_col.bulk_write(bulk_writes)
diff --git a/openpype/modules/kitsu/utils/update_zou_with_op.py b/openpype/modules/kitsu/utils/update_zou_with_op.py
new file mode 100644
index 0000000000..d1fcde5601
--- /dev/null
+++ b/openpype/modules/kitsu/utils/update_zou_with_op.py
@@ -0,0 +1,262 @@
+"""Functions to update Kitsu DB (a.k.a Zou) using OpenPype Data."""
+
+import re
+from typing import List
+
+import gazu
+from pymongo import UpdateOne
+
+from avalon.api import AvalonMongoDB
+from openpype.api import get_project_settings
+from openpype.modules.kitsu.utils.credentials import validate_credentials
+
+
+def sync_zou(login: str, password: str):
+    """Synchronize Zou database (Kitsu backend) with openpype database.
+    This is an utility function to help updating zou data with OP's, it may not
+    handle correctly all cases, a human intervention might
+    be required after all.
+    Will work better if OP DB has been previously synchronized from zou/kitsu.
+
+    Args:
+        login (str): Kitsu user login
+        password (str): Kitsu user password
+
+    Raises:
+        gazu.exception.AuthFailedException: Wrong user login and/or password
+    """
+
+    # Authenticate
+    if not validate_credentials(login, password):
+        raise gazu.exception.AuthFailedException(
+            f"Kitsu authentication failed for login: '{login}'..."
+        )
+
+    # Iterate projects
+    dbcon = AvalonMongoDB()
+    dbcon.install()
+
+    op_projects = [p for p in dbcon.projects()]
+    for project_doc in op_projects:
+        sync_zou_from_op_project(project_doc["name"], dbcon, project_doc)
+
+
+def sync_zou_from_op_project(
+    project_name: str, dbcon: AvalonMongoDB, project_doc: dict = None
+) -> List[UpdateOne]:
+    """Update OP project in DB with Zou data.
+
+    Args:
+        project_name (str): Name of project to sync
+        dbcon (AvalonMongoDB): MongoDB connection
+        project_doc (str, optional): Project doc to sync
+    """
+    # Get project doc if not provided
+    if not project_doc:
+        project_doc = dbcon.database[project_name].find_one(
+            {"type": "project"}
+        )
+
+    # Get all entities from zou
+    print(f"Synchronizing {project_name}...")
+    zou_project = gazu.project.get_project_by_name(project_name)
+
+    # Create project
+    if zou_project is None:
+        raise RuntimeError(
+            f"Project '{project_name}' doesn't exist in Zou database, "
+            "please create it in Kitsu and add OpenPype user to it before "
+            "running synchronization."
+        )
+
+    # Update project settings and data
+    if project_doc["data"]:
+        zou_project.update(
+            {
+                "code": project_doc["data"]["code"],
+                "fps": project_doc["data"]["fps"],
+                "resolution": f"{project_doc['data']['resolutionWidth']}"
+                f"x{project_doc['data']['resolutionHeight']}",
+            }
+        )
+        gazu.project.update_project_data(zou_project, data=project_doc["data"])
+    gazu.project.update_project(zou_project)
+
+    asset_types = gazu.asset.all_asset_types()
+    all_assets = gazu.asset.all_assets_for_project(zou_project)
+    all_episodes = gazu.shot.all_episodes_for_project(zou_project)
+    all_seqs = gazu.shot.all_sequences_for_project(zou_project)
+    all_shots = gazu.shot.all_shots_for_project(zou_project)
+    all_entities_ids = {
+        e["id"] for e in all_episodes + all_seqs + all_shots + all_assets
+    }
+
+    # Query all assets of the local project
+    project_module_settings = get_project_settings(project_name)["kitsu"]
+    project_col = dbcon.database[project_name]
+    asset_docs = {
+        asset_doc["_id"]: asset_doc
+        for asset_doc in project_col.find({"type": "asset"})
+    }
+
+    # Create new assets
+    new_assets_docs = [
+        doc
+        for doc in asset_docs.values()
+        if doc["data"].get("zou", {}).get("id") not in all_entities_ids
+    ]
+    naming_pattern = project_module_settings["entities_naming_pattern"]
+    regex_ep = re.compile(
+        r"(.*{}.*)|(.*{}.*)|(.*{}.*)".format(
+            naming_pattern["shot"].replace("#", ""),
+            naming_pattern["sequence"].replace("#", ""),
+            naming_pattern["episode"].replace("#", ""),
+        ),
+        re.IGNORECASE,
+    )
+    bulk_writes = []
+    for doc in new_assets_docs:
+        visual_parent_id = doc["data"]["visualParent"]
+        parent_substitutes = []
+
+        # Match asset type by it's name
+        match = regex_ep.match(doc["name"])
+        if not match:  # Asset
+            new_entity = gazu.asset.new_asset(
+                zou_project, asset_types[0], doc["name"]
+            )
+        # Match case in shot<sequence<episode order to support
+        # composed names like 'ep01_sq01_sh01'
+        elif match.group(1):  # Shot
+            # Match and check parent doc
+            parent_doc = asset_docs[visual_parent_id]
+            zou_parent_id = parent_doc["data"]["zou"]["id"]
+            if parent_doc["data"].get("zou", {}).get("type") != "Sequence":
+                # Substitute name
+                digits_padding = naming_pattern["sequence"].count("#")
+                episode_name = naming_pattern["episode"].replace(
+                    "#" * digits_padding, "1".zfill(digits_padding)
+                )
+                sequence_name = naming_pattern["sequence"].replace(
+                    "#" * digits_padding, "1".zfill(digits_padding)
+                )
+                substitute_sequence_name = f"{episode_name}_{sequence_name}"
+
+                # Warn
+                print(
+                    f"Shot {doc['name']} must be parented to a Sequence "
+                    "in Kitsu. "
+                    f"Creating automatically one substitute sequence "
+                    f"called {substitute_sequence_name} in Kitsu..."
+                )
+
+                # Create new sequence and set it as substitute
+                created_sequence = gazu.shot.new_sequence(
+                    zou_project,
+                    substitute_sequence_name,
+                    episode=zou_parent_id,
+                )
+                gazu.shot.update_sequence_data(
+                    created_sequence, {"is_substitute": True}
+                )
+                parent_substitutes.append(created_sequence)
+
+                # Update parent ID
+                zou_parent_id = created_sequence["id"]
+
+            # Create shot
+            new_entity = gazu.shot.new_shot(
+                zou_project,
+                zou_parent_id,
+                doc["name"],
+                frame_in=doc["data"]["frameStart"],
+                frame_out=doc["data"]["frameEnd"],
+                nb_frames=doc["data"]["frameEnd"] - doc["data"]["frameStart"],
+            )
+
+        elif match.group(2):  # Sequence
+            parent_doc = asset_docs[visual_parent_id]
+            new_entity = gazu.shot.new_sequence(
+                zou_project,
+                doc["name"],
+                episode=parent_doc["data"]["zou"]["id"],
+            )
+
+        elif match.group(3):  # Episode
+            new_entity = gazu.shot.new_episode(zou_project, doc["name"])
+
+        # Update doc with zou id
+        doc["data"].update(
+            {
+                "visualParent": visual_parent_id,
+                "zou": new_entity,
+            }
+        )
+        bulk_writes.append(
+            UpdateOne(
+                {"_id": doc["_id"]},
+                {
+                    "$set": {
+                        "data.visualParent": visual_parent_id,
+                        "data.zou": new_entity,
+                        "data.parent_substitutes": parent_substitutes,
+                    }
+                },
+            )
+        )
+
+    # Update assets
+    all_tasks_types = {t["name"]: t for t in gazu.task.all_task_types()}
+    assets_docs_to_update = [
+        doc
+        for doc in asset_docs.values()
+        if doc["data"].get("zou", {}).get("id") in all_entities_ids
+    ]
+    for doc in assets_docs_to_update:
+        zou_id = doc["data"]["zou"]["id"]
+        if zou_id:
+            # Data
+            entity_data = {}
+            frame_in = doc["data"].get("frameStart")
+            frame_out = doc["data"].get("frameEnd")
+            if frame_in or frame_out:
+                entity_data.update(
+                    {
+                        "data": {
+                            "frame_in": frame_in,
+                            "frame_out": frame_out,
+                        },
+                        "nb_frames": frame_out - frame_in,
+                    }
+                )
+            entity = gazu.raw.update("entities", zou_id, entity_data)
+
+            # Tasks
+            all_tasks_func = getattr(
+                gazu.task, f"all_tasks_for_{entity['type'].lower()}"
+            )
+            entity_tasks = {t["name"] for t in all_tasks_func(entity)}
+            for task_name in doc["data"]["tasks"].keys():
+                # Create only if new
+                if task_name not in entity_tasks:
+                    task_type = all_tasks_types.get(task_name)
+
+                    # Create non existing task
+                    if not task_type:
+                        task_type = gazu.task.new_task_type(task_name)
+                        all_tasks_types[task_name] = task_type
+
+                    # New task for entity
+                    gazu.task.new_task(entity, task_type)
+
+    # Delete
+    deleted_entities = all_entities_ids - {
+        asset_doc["data"].get("zou", {}).get("id")
+        for asset_doc in asset_docs.values()
+    }
+    for entity_id in deleted_entities:
+        gazu.raw.delete(f"data/entities/{entity_id}")
+
+    # Write into DB
+    if bulk_writes:
+        project_col.bulk_write(bulk_writes)

From f6e271615a2d7e11c73742d69f0025ac5e9110d0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 3 Mar 2022 15:55:56 +0100
Subject: [PATCH 0153/1227] Cleaning.

---
 openpype/modules/kitsu/utils/credentials.py | 36 ++++++++++++++-------
 1 file changed, 24 insertions(+), 12 deletions(-)

diff --git a/openpype/modules/kitsu/utils/credentials.py b/openpype/modules/kitsu/utils/credentials.py
index b4dd5ee4a2..0529380d6d 100644
--- a/openpype/modules/kitsu/utils/credentials.py
+++ b/openpype/modules/kitsu/utils/credentials.py
@@ -8,15 +8,21 @@ from openpype.lib.local_settings import OpenPypeSecureRegistry
 
 
 def validate_credentials(
-    login: str, password: str, kitsu_url: str = os.environ.get("KITSU_SERVER")
+    login: str, password: str, kitsu_url: str = None
 ) -> bool:
     """Validate credentials by trying to connect to Kitsu host URL.
 
-    :param login: Kitsu Login
-    :param password: Kitsu Password
-    :param kitsu_url: Kitsu host URL
-    :return: Are credentials valid?
+    Args:
+        login (str): Kitsu user login
+        password (str): Kitsu user password
+        kitsu_url (str, optional): Kitsu host URL. Defaults to None.
+
+    Returns:
+        bool: Are credentials valid?
     """
+    if kitsu_url is None:
+        kitsu_url = os.environ.get("KITSU_SERVER")
+
     # Connect to server
     validate_host(kitsu_url)
 
@@ -32,8 +38,11 @@ def validate_credentials(
 def validate_host(kitsu_url: str) -> bool:
     """Validate credentials by trying to connect to Kitsu host URL.
 
-    :param kitsu_url: Kitsu host URL
-    :return: Is host valid?
+    Args:
+        kitsu_url (str, optional): Kitsu host URL.
+
+    Returns:
+        bool: Is host valid?
     """
     # Connect to server
     gazu.set_host(kitsu_url)
@@ -58,8 +67,9 @@ def clear_credentials():
 def save_credentials(login: str, password: str):
     """Save credentials in Secure Registry.
 
-    :param login: Kitsu Login
-    :param password: Kitsu Password
+    Args:
+        login (str): Kitsu user login
+        password (str): Kitsu user password
     """
     # Get user registry
     user_registry = OpenPypeSecureRegistry("kitsu_user")
@@ -72,7 +82,8 @@ def save_credentials(login: str, password: str):
 def load_credentials() -> Tuple[str, str]:
     """Load registered credentials.
 
-    :return: Login, Password
+    Returns:
+        Tuple[str, str]: (Login, Password)
     """
     # Get user registry
     user_registry = OpenPypeSecureRegistry("kitsu_user")
@@ -85,8 +96,9 @@ def load_credentials() -> Tuple[str, str]:
 def set_credentials_envs(login: str, password: str):
     """Set environment variables with Kitsu login and password.
 
-    :param login: Kitsu Login
-    :param password: Kitsu Password
+    Args:
+        login (str): Kitsu user login
+        password (str): Kitsu user password
     """
     os.environ["KITSU_LOGIN"] = login
     os.environ["KITSU_PWD"] = password

From 5db0c1dfa7cbf483976b6e52f6d4cde5813daedc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Fri, 4 Mar 2022 10:12:08 +0100
Subject: [PATCH 0154/1227] Python 2 compat and cleaning

---
 openpype/modules/kitsu/kitsu_module.py       | 4 ++--
 openpype/modules/kitsu/utils/sync_service.py | 5 -----
 2 files changed, 2 insertions(+), 7 deletions(-)

diff --git a/openpype/modules/kitsu/kitsu_module.py b/openpype/modules/kitsu/kitsu_module.py
index dca6133e88..53edfddf9a 100644
--- a/openpype/modules/kitsu/kitsu_module.py
+++ b/openpype/modules/kitsu/kitsu_module.py
@@ -105,7 +105,7 @@ def cli_main():
 @click.option(
     "--password", envvar="KITSU_PWD", help="Password for kitsu username"
 )
-def push_to_zou(login: str, password: str):
+def push_to_zou(login, password):
     """Synchronize Zou database (Kitsu backend) with openpype database.
 
     Args:
@@ -122,7 +122,7 @@ def push_to_zou(login: str, password: str):
 @click.option(
     "-p", "--password", envvar="KITSU_PWD", help="Password for kitsu username"
 )
-def sync_service(login: str, password: str):
+def sync_service(login, password):
     """Synchronize openpype database from Zou sever database.
 
     Args:
diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 831673ec0d..6bf98cf308 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -383,8 +383,3 @@ def start_listeners(login: str, password: str):
     # Connect to server
     listener = Listener(login, password)
     listener.start()
-
-
-if __name__ == "__main__":
-    # TODO not sure when this can be run and if this system is reliable
-    start_listeners(load_credentials())

From 8c3b510887564d52d7230c7114a17f9044157be5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Fri, 4 Mar 2022 10:12:58 +0100
Subject: [PATCH 0155/1227] Cleaning

---
 openpype/modules/kitsu/utils/sync_service.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 6bf98cf308..2e8fbf77f5 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -3,7 +3,7 @@ import os
 import gazu
 
 from avalon.api import AvalonMongoDB
-from .credentials import load_credentials, validate_credentials
+from .credentials import validate_credentials
 from .update_op_with_zou import (
     create_op_asset,
     set_op_project,

From e5ae5459e135d10d01e1549f8ac3f8a8cb83e689 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Fri, 4 Mar 2022 15:58:06 +0100
Subject: [PATCH 0156/1227] Kitsu docs

---
 website/docs/artist_kitsu.md                  |  17 ++++++++
 .../docs/assets/kitsu/kitsu_credentials.png   | Bin 0 -> 15798 bytes
 website/docs/module_kitsu.md                  |  37 ++++++++++++++++++
 website/sidebars.js                           |   2 +
 4 files changed, 56 insertions(+)
 create mode 100644 website/docs/artist_kitsu.md
 create mode 100644 website/docs/assets/kitsu/kitsu_credentials.png
 create mode 100644 website/docs/module_kitsu.md

diff --git a/website/docs/artist_kitsu.md b/website/docs/artist_kitsu.md
new file mode 100644
index 0000000000..9ef782c297
--- /dev/null
+++ b/website/docs/artist_kitsu.md
@@ -0,0 +1,17 @@
+---
+id: artist_kitsu
+title: Kitsu
+sidebar_label: Kitsu
+---
+
+# How to use Kitsu in OpenPype
+
+## Login to Kitsu module in OpenPype
+1. Launch OpenPype, the `Kitsu Credentials` window will open automatically, if not, or if you want to log-in with another account, go to systray OpenPype icon and click on `Kitsu Connect`.
+2. Enter your credentials and press *Ok*:
+
+    ![kitsu-login](assets/kitsu/kitsu_credentials.png)
+
+:::tip
+In Kitsu, All the publish actions executed by `pyblish` will be attributed to the currently logged-in user.
+:::
\ No newline at end of file
diff --git a/website/docs/assets/kitsu/kitsu_credentials.png b/website/docs/assets/kitsu/kitsu_credentials.png
new file mode 100644
index 0000000000000000000000000000000000000000..25c1ad93c4d966a083d1fbdcd15e78a54e659b76
GIT binary patch
literal 15798
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

literal 0
HcmV?d00001

diff --git a/website/docs/module_kitsu.md b/website/docs/module_kitsu.md
new file mode 100644
index 0000000000..ec38cce5e1
--- /dev/null
+++ b/website/docs/module_kitsu.md
@@ -0,0 +1,37 @@
+---
+id: module_kitsu
+title: Kitsu Administration
+sidebar_label: Kitsu
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+Kitsu is a great open source production tracker and can be used for project management instead of Ftrack. This documentation assumes that you are familiar with Kitsu and it's basic principles. If you're new to Kitsu, we recommend having a thorough look at [Kitsu Official Documentation](https://kitsu.cg-wire.com/).
+
+## Prepare Kitsu for OpenPype
+
+### Server URL
+If you want to connect Kitsu to OpenPype you have to set the `Server` url in Kitsu settings. And that's all!
+This setting is available for all the users of the OpenPype instance.
+
+## Synchronize
+Updating OP with Kitsu data is executed running the `sync-service`, which requires to provide your Kitsu credentials with `-l, --login` and `-p, --password` or by setting the environment variables `KITSU_LOGIN` and `KITSU_PWD`. This process will request data from Kitsu and create/delete/update OP assets.
+Once this sync is done, the thread will automatically start a loop to listen to Kitsu events.
+
+```bash
+openpype_console module kitsu sync-service -l me@domain.ext -p my_password
+```
+
+### Events listening
+Listening to Kitsu events is the key to automation of many tasks like _project/episode/sequence/shot/asset/task create/update/delete_ and some more. Events listening should run at all times to perform the required processing as it is not possible to catch some of them retrospectively with strong reliability. If such timeout has been encountered, you must relaunch the `sync-service` command to run the synchronization step again.
+
+### Push to Kitsu
+An utility function is provided to help update Kitsu data (a.k.a Zou database) with OpenPype data if the publishing to the production tracker hasn't been possible for some time. Running `push-to-zou` will create the data on behalf of the user.
+:::caution
+This functionality cannot deal with all cases and is not error proof, some intervention by a human being might be required.
+:::
+
+```bash
+openpype_console module kitsu push-to-zou -l me@domain.ext -p my_password
+```
diff --git a/website/sidebars.js b/website/sidebars.js
index 105afc30eb..eecdcc6e9a 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -28,6 +28,7 @@ module.exports = {
                 "artist_hosts_photoshop",
                 "artist_hosts_tvpaint",
                 "artist_hosts_unreal",
+                "artist_kitsu",
                 {
                     type: "category",
                     label: "Ftrack",
@@ -75,6 +76,7 @@ module.exports = {
             label: "Modules",
             items: [
                 "module_ftrack",
+                "module_kitsu",
                 "module_site_sync",
                 "module_deadline",
                 "module_muster",

From 05158585c778a3bed91c023626bcf5ee3baf29a9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 8 Mar 2022 09:22:16 +0100
Subject: [PATCH 0157/1227] Add pyblish comment to kitsu

---
 openpype/modules/kitsu/kitsu_module.py                 | 6 +++---
 openpype/modules/kitsu/plugins/publish/kitsu_plugin.py | 6 ++++--
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/openpype/modules/kitsu/kitsu_module.py b/openpype/modules/kitsu/kitsu_module.py
index 53edfddf9a..8e7ab6f78c 100644
--- a/openpype/modules/kitsu/kitsu_module.py
+++ b/openpype/modules/kitsu/kitsu_module.py
@@ -51,11 +51,11 @@ class KitsuModule(OpenPypeModule, IPluginPaths, ITrayAction):
             set_credentials_envs,
         )
 
-        username, password = load_credentials()
+        login, password = load_credentials()
 
         # Check credentials, ask them if needed
-        if validate_credentials(username, password):
-            set_credentials_envs(username, password)
+        if validate_credentials(login, password):
+            set_credentials_envs(login, password)
         else:
             self.show_dialog()
 
diff --git a/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py b/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
index b556f2b91f..5fce123d7e 100644
--- a/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
+++ b/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
@@ -39,7 +39,9 @@ class IntegrateRig(pyblish.api.InstancePlugin):
         gazu.task.add_comment(
             entity_task,
             entity_task["task_status_id"],
-            comment=f"Version {instance.data['version']} has been published!",
-        )  # TODO add comment from pyblish
+            comment=f"Version {instance.data['version']} has been published!\n"
+            "\n"  # Add written comment in Pyblish
+            f"{instance.data['versionEntity']['data']['comment']}".strip(),
+        )
 
         self.log.info("Version published to Kitsu successfully!")

From 1591b91c54611e2bfe55902ad31929e72416515f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 8 Mar 2022 09:57:37 +0100
Subject: [PATCH 0158/1227] Python2 compat

---
 openpype/modules/kitsu/plugins/publish/kitsu_plugin.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py b/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
index 5fce123d7e..5d6c76bc3f 100644
--- a/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
+++ b/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
@@ -39,9 +39,11 @@ class IntegrateRig(pyblish.api.InstancePlugin):
         gazu.task.add_comment(
             entity_task,
             entity_task["task_status_id"],
-            comment=f"Version {instance.data['version']} has been published!\n"
-            "\n"  # Add written comment in Pyblish
-            f"{instance.data['versionEntity']['data']['comment']}".strip(),
+            comment="Version {} has been published!\n".format(
+                instance.data["version"]
+            )
+            # Add written comment in Pyblish
+            + "\n{}".format(instance.data["versionEntity"]["data"]["comment"]),
         )
 
         self.log.info("Version published to Kitsu successfully!")

From 9c0c43a0612c70fa7fa26e71c1f91b7605b3792d Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Tue, 15 Mar 2022 18:01:04 +0100
Subject: [PATCH 0159/1227] fix first sync crash

---
 .../modules/kitsu/utils/update_op_with_zou.py | 31 +++++++++----------
 1 file changed, 14 insertions(+), 17 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index eb675ad09e..e76d54d1ad 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -145,14 +145,15 @@ def write_project_to_op(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
     project_data = project["data"] or {}
 
     # Update data
-    project_data.update(
-        {
-            "code": project["code"],
-            "fps": project["fps"],
-            "resolutionWidth": project["resolution"].split("x")[0],
-            "resolutionHeight": project["resolution"].split("x")[1],
-        }
-    )
+    if project_data:
+        project_data.update(
+            {
+                "code": project["code"],
+                "fps": project["fps"],
+                "resolutionWidth": project["resolution"].split("x")[0],
+                "resolutionHeight": project["resolution"].split("x")[1],
+            }
+        )
 
     return UpdateOne(
         {"_id": project_doc["_id"]},
@@ -211,10 +212,6 @@ def sync_project_from_kitsu(
         project = gazu.project.get_project_by_name(project_name)
     project_code = project_name
 
-    # Try to find project document
-    project_col = dbcon.database[project_code]
-    project_doc = project_col.find_one({"type": "project"})
-
     print(f"Synchronizing {project_name}...")
 
     # Get all assets from zou
@@ -222,15 +219,15 @@ def sync_project_from_kitsu(
     all_episodes = gazu.shot.all_episodes_for_project(project)
     all_seqs = gazu.shot.all_sequences_for_project(project)
     all_shots = gazu.shot.all_shots_for_project(project)
-    all_entities = [
-        e
-        for e in all_assets + all_episodes + all_seqs + all_shots
-        if e["data"] and not e["data"].get("is_substitute")
-    ]
+    all_entities = all_assets + all_episodes + all_seqs + all_shots
 
     # Sync project. Create if doesn't exist
     bulk_writes.append(write_project_to_op(project, dbcon))
 
+    # Try to find project document
+    project_col = dbcon.database[project_code]
+    project_doc = project_col.find_one({"type": "project"})
+
     # Query all assets of the local project
     zou_ids_and_asset_docs = {
         asset_doc["data"]["zou"]["id"]: asset_doc

From 17dd018aa060f8fbaf043e19e86a9a0e318f14dd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 16 Mar 2022 17:01:30 +0100
Subject: [PATCH 0160/1227] Build project code

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index e76d54d1ad..98f263efe1 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -144,11 +144,20 @@ def write_project_to_op(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
     # Project data and tasks
     project_data = project["data"] or {}
 
+    # Build project code and update Kitsu
+    project_code = project.get("code")
+    if not project_code:
+        project_code = project["name"].replace(" ", "_").lower()
+        project["code"] = project_code
+
+        # Update Zou
+        gazu.project.update_project(project)
+
     # Update data
     if project_data:
         project_data.update(
             {
-                "code": project["code"],
+                "code": project_code,
                 "fps": project["fps"],
                 "resolutionWidth": project["resolution"].split("x")[0],
                 "resolutionHeight": project["resolution"].split("x")[1],

From 093e801b0b02074e4d5bd7ecd0ff6d791ba6ea92 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 16 Mar 2022 17:31:22 +0100
Subject: [PATCH 0161/1227] Sync project FPS and resolution

---
 .../modules/kitsu/utils/update_op_with_zou.py   | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 98f263efe1..cb2c79b942 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -154,15 +154,14 @@ def write_project_to_op(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
         gazu.project.update_project(project)
 
     # Update data
-    if project_data:
-        project_data.update(
-            {
-                "code": project_code,
-                "fps": project["fps"],
-                "resolutionWidth": project["resolution"].split("x")[0],
-                "resolutionHeight": project["resolution"].split("x")[1],
-            }
-        )
+    project_data.update(
+        {
+            "code": project_code,
+            "fps": project["fps"],
+            "resolutionWidth": project["resolution"].split("x")[0],
+            "resolutionHeight": project["resolution"].split("x")[1],
+        }
+    )
 
     return UpdateOne(
         {"_id": project_doc["_id"]},

From bd06809ffaf8ff8ae8bde463a5ad990b486288c7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 16 Mar 2022 18:44:26 +0100
Subject: [PATCH 0162/1227] Fix shot syncs

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index cb2c79b942..6aea2e3930 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -1,4 +1,5 @@
 """Functions to update OpenPype data using Kitsu DB (a.k.a Zou)."""
+from copy import deepcopy
 from typing import Dict, List
 
 from pymongo import DeleteOne, UpdateOne
@@ -54,9 +55,14 @@ def update_op_assets(
     for item in entities_list:
         # Update asset
         item_doc = asset_doc_ids[item["id"]]
-        item_data = item_doc["data"].copy()
+        item_data = deepcopy(item_doc["data"])
+        item_data.update(item.get("data") or {})
         item_data["zou"] = item
 
+        # Asset settings
+        item_data["frameStart"] = item_data.get("frame_in")
+        item_data["frameEnd"] = item_data.get("frame_out")
+
         # Tasks
         tasks_list = []
         if item["type"] == "Asset":
@@ -103,9 +109,7 @@ def update_op_assets(
 
         # Update 'data' different in zou DB
         updated_data = {
-            k: item_data[k]
-            for k in item_data.keys()
-            if item_doc["data"].get(k) != item_data[k]
+            k: v for k, v in item_data.items() if item_doc["data"].get(k) != v
         }
         if updated_data or not item_doc.get("parent"):
             assets_with_update.append(

From 84a13e4eb6ff99b433ea1d2fddce32d106381e61 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 17 Mar 2022 15:52:14 +0100
Subject: [PATCH 0163/1227] shots and assets custom folders root

---
 openpype/modules/kitsu/utils/sync_service.py  |  8 +-
 .../modules/kitsu/utils/update_op_with_zou.py | 82 +++++++++++++++++--
 .../defaults/project_settings/kitsu.json      |  4 +
 .../projects_schema/schema_project_kitsu.json | 17 ++++
 4 files changed, 99 insertions(+), 12 deletions(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 2e8fbf77f5..746cb843e9 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -167,7 +167,7 @@ class Listener:
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            [asset], zou_ids_and_asset_docs
+            project_col[asset], zou_ids_and_asset_docs
         )[0]
         project_col.update_one({"_id": asset_doc_id}, asset_update)
 
@@ -214,7 +214,7 @@ class Listener:
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            [episode], zou_ids_and_asset_docs
+            project_col, [episode], zou_ids_and_asset_docs
         )[0]
         project_col.update_one({"_id": asset_doc_id}, asset_update)
 
@@ -262,7 +262,7 @@ class Listener:
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            [sequence], zou_ids_and_asset_docs
+            project_col, [sequence], zou_ids_and_asset_docs
         )[0]
         project_col.update_one({"_id": asset_doc_id}, asset_update)
 
@@ -310,7 +310,7 @@ class Listener:
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            [shot], zou_ids_and_asset_docs
+            project_col, [shot], zou_ids_and_asset_docs
         )[0]
         project_col.update_one({"_id": asset_doc_id}, asset_update)
 
diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 6aea2e3930..e2ad29bfa0 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -11,6 +11,7 @@ from gazu.task import (
 )
 
 from avalon.api import AvalonMongoDB
+from openpype.api import get_project_settings
 from openpype.lib import create_project
 from openpype.modules.kitsu.utils.credentials import validate_credentials
 
@@ -42,15 +43,23 @@ def set_op_project(dbcon, project_id) -> Collection:
 
 
 def update_op_assets(
-    entities_list: List[dict], asset_doc_ids: Dict[str, dict]
+    project_col: Collection,
+    entities_list: List[dict],
+    asset_doc_ids: Dict[str, dict],
 ) -> List[Dict[str, dict]]:
     """Update OpenPype assets.
     Set 'data' and 'parent' fields.
 
-    :param entities_list: List of zou entities to update
-    :param asset_doc_ids: Dicts of [{zou_id: asset_doc}, ...]
-    :return: List of (doc_id, update_dict) tuples
+    Args:
+        project_col (Collection): Mongo project collection to sync
+        entities_list (List[dict]): List of zou entities to update
+        asset_doc_ids (Dict[str, dict]): Dicts of [{zou_id: asset_doc}, ...]
+
+    Returns:
+        List[Dict[str, dict]]: List of (doc_id, update_dict) tuples
     """
+    project_name = project_col.name
+
     assets_with_update = []
     for item in entities_list:
         # Update asset
@@ -65,9 +74,10 @@ def update_op_assets(
 
         # Tasks
         tasks_list = []
-        if item["type"] == "Asset":
+        item_type = item["type"]
+        if item_type == "Asset":
             tasks_list = all_tasks_for_asset(item)
-        elif item["type"] == "Shot":
+        elif item_type == "Shot":
             tasks_list = all_tasks_for_shot(item)
             # TODO frame in and out
         item_data["tasks"] = {
@@ -91,10 +101,39 @@ def update_op_assets(
                 or item.get("source_id")
             )  # TODO check consistency
 
-        # Visual parent for hierarchy
+        # Substitute Episode and Sequence by Shot
+        project_module_settings = get_project_settings(project_name)["kitsu"]
+        substitute_item_type = (
+            "shots"
+            if item_type in ["Episode", "Sequence"]
+            else f"{item_type.lower()}s"
+        )
+        entity_parent_folders = [
+            f
+            for f in project_module_settings["entities_root"]
+            .get(substitute_item_type)
+            .split("/")
+            if f
+        ]
+
+        # Root parent folder if exist
         visual_parent_doc_id = (
             asset_doc_ids[parent_zou_id]["_id"] if parent_zou_id else None
         )
+        if visual_parent_doc_id is None:
+            # Find root folder doc
+            root_folder_doc = project_col.find_one(
+                {
+                    "type": "asset",
+                    "name": entity_parent_folders[-1],
+                    "data.root_of": substitute_item_type,
+                },
+                ["_id"],
+            )
+            if root_folder_doc:
+                visual_parent_doc_id = root_folder_doc["_id"]
+
+        # Visual parent for hierarchy
         item_data["visualParent"] = visual_parent_doc_id
 
         # Add parents for hierarchy
@@ -107,6 +146,9 @@ def update_op_assets(
             parent_entity = parent_doc["data"]["zou"]
             parent_zou_id = parent_entity["parent_id"]
 
+        # Set root folders parents
+        item_data["parents"] = entity_parent_folders + item_data["parents"]
+
         # Update 'data' different in zou DB
         updated_data = {
             k: v for k, v in item_data.items() if item_doc["data"].get(k) != v
@@ -248,6 +290,30 @@ def sync_project_from_kitsu(
     }
     zou_ids_and_asset_docs[project["id"]] = project_doc
 
+    # Create entities root folders
+    project_module_settings = get_project_settings(project_name)["kitsu"]
+    for entity_type, root in project_module_settings["entities_root"].items():
+        parent_folders = root.split("/")
+        direct_parent_doc = None
+        for i, folder in enumerate(parent_folders, 1):
+            parent_doc = project_col.find_one(
+                {"type": "asset", "name": folder, "data.root_of": entity_type}
+            )
+            if not parent_doc:
+                direct_parent_doc = project_col.insert_one(
+                    {
+                        "name": folder,
+                        "type": "asset",
+                        "schema": "openpype:asset-3.0",
+                        "data": {
+                            "root_of": entity_type,
+                            "parents": parent_folders[:i],
+                            "visualParent": direct_parent_doc,
+                            "tasks": {},
+                        },
+                    }
+                )
+
     # Create
     to_insert = []
     to_insert.extend(
@@ -275,7 +341,7 @@ def sync_project_from_kitsu(
         [
             UpdateOne({"_id": id}, update)
             for id, update in update_op_assets(
-                all_entities, zou_ids_and_asset_docs
+                project_col, all_entities, zou_ids_and_asset_docs
             )
         ]
     )
diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
index 435814a9d1..a37146e1d2 100644
--- a/openpype/settings/defaults/project_settings/kitsu.json
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -1,4 +1,8 @@
 {
+    "entities_root": {
+        "assets": "Assets",
+        "shots": "Shots"
+    },
     "entities_naming_pattern": {
         "episode": "E##",
         "sequence": "SQ##",
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index a504959001..8d71d0ecd6 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -5,6 +5,23 @@
     "collapsible": true,
     "is_file": true,
     "children": [
+        {
+            "type": "dict",
+            "key": "entities_root",
+            "label": "Entities root folder",
+            "children": [
+                {
+                    "type": "text",
+                    "key": "assets",
+                    "label": "Assets:"
+                },
+                {
+                    "type": "text",
+                    "key": "shots",
+                    "label": "Shots (includes Episodes & Sequences if any):"
+                }
+            ]
+        },
         {
             "type": "dict",
             "key": "entities_naming_pattern",

From 3970229ce5908abfd62c90a88b656f08f232dbfc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 17 Mar 2022 16:09:15 +0100
Subject: [PATCH 0164/1227] Fix fps fallback to project's value

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index e2ad29bfa0..288efe30da 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -71,6 +71,10 @@ def update_op_assets(
         # Asset settings
         item_data["frameStart"] = item_data.get("frame_in")
         item_data["frameEnd"] = item_data.get("frame_out")
+        # Sentinel for fps, fallback to project's value when entity fps is deleted
+        if not item_data.get("fps") and item_doc["data"].get("fps"):
+            project_doc = project_col.find_one({"type": "project"})
+            item_data["fps"] = project_doc["data"]["fps"]
 
         # Tasks
         tasks_list = []

From 78bda28da4ec26cf4b8b8673cabc01316f578678 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 17 Mar 2022 16:49:13 +0100
Subject: [PATCH 0165/1227] frame_in/out fallbacks

---
 .../modules/kitsu/utils/update_op_with_zou.py   | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 288efe30da..f5c6406722 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -68,10 +68,19 @@ def update_op_assets(
         item_data.update(item.get("data") or {})
         item_data["zou"] = item
 
-        # Asset settings
-        item_data["frameStart"] = item_data.get("frame_in")
-        item_data["frameEnd"] = item_data.get("frame_out")
-        # Sentinel for fps, fallback to project's value when entity fps is deleted
+        # == Asset settings ==
+        # Frame in, fallback on 0
+        frame_in = int(item_data.get("frame_in") or 0)
+        item_data["frameStart"] = frame_in
+        # Frame out, fallback on frame_in + duration
+        frames_duration = int(item.get("nb_frames") or 1)
+        frame_out = (
+            item_data["frame_out"]
+            if item_data.get("frame_out")
+            else frame_in + frames_duration
+        )
+        item_data["frameEnd"] = int(frame_out)
+        # Fps, fallback to project's value when entity fps is deleted
         if not item_data.get("fps") and item_doc["data"].get("fps"):
             project_doc = project_col.find_one({"type": "project"})
             item_data["fps"] = project_doc["data"]["fps"]

From 527f4a710dbddd21feac630bdafb7b986a354c5a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Fri, 25 Mar 2022 10:03:22 +0100
Subject: [PATCH 0166/1227] Sync only open projects
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Clément Hector <clement.hector@gmail.com>
---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index f5c6406722..f43223cdf7 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -256,7 +256,7 @@ def sync_all_project(login: str, password: str):
     # Iterate projects
     dbcon = AvalonMongoDB()
     dbcon.install()
-    all_projects = gazu.project.all_projects()
+    all_projects = gazu.project.all_open_projects()
     for project in all_projects:
         sync_project_from_kitsu(project["name"], dbcon, project)
 

From 63096b4e6b819081bfc3ea962ea82ab8d2ef507e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 4 May 2022 18:26:58 +0200
Subject: [PATCH 0167/1227] change avalon API

---
 openpype/modules/kitsu/utils/sync_service.py       | 2 +-
 openpype/modules/kitsu/utils/update_op_with_zou.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 746cb843e9..01596e2667 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -2,7 +2,7 @@ import os
 
 import gazu
 
-from avalon.api import AvalonMongoDB
+from openpype.pipeline import AvalonMongoDB
 from .credentials import validate_credentials
 from .update_op_with_zou import (
     create_op_asset,
diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index f43223cdf7..25c89800d4 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -10,7 +10,7 @@ from gazu.task import (
     all_tasks_for_shot,
 )
 
-from avalon.api import AvalonMongoDB
+from openpype.pipeline import AvalonMongoDB
 from openpype.api import get_project_settings
 from openpype.lib import create_project
 from openpype.modules.kitsu.utils.credentials import validate_credentials

From 0359ec6da4e03bf9c7df49060a423c028195d86c Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Thu, 7 Apr 2022 15:46:40 +0200
Subject: [PATCH 0168/1227] create kitsu collector

---
 .../publish/collect_kitsu_credential.py       | 18 ++++++
 .../plugins/publish/collect_kitsu_entities.py | 64 +++++++++++++++++++
 2 files changed, 82 insertions(+)
 create mode 100644 openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
 create mode 100644 openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
new file mode 100644
index 0000000000..bd0af16c8b
--- /dev/null
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
@@ -0,0 +1,18 @@
+import os
+
+import gazu
+
+import pyblish.api
+
+
+class CollectKitsuSession(pyblish.api.ContextPlugin):
+    """Collect Kitsu session using user credentials"""
+
+    order = pyblish.api.CollectorOrder
+    label = "Kitsu user session"
+
+
+    def process(self, context):
+
+        gazu.client.set_host(os.environ["KITSU_SERVER"])
+        gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
\ No newline at end of file
diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
new file mode 100644
index 0000000000..e4773f7b2a
--- /dev/null
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
@@ -0,0 +1,64 @@
+import os
+
+import gazu
+
+import pyblish.api
+
+
+class CollectKitsuEntities(pyblish.api.ContextPlugin):
+    """Collect Kitsu entities according to the current context"""
+
+    order = pyblish.api.CollectorOrder + 0.499
+    label = "Kitsu entities"
+
+    def process(self, context):
+
+        os.environ["AVALON_PROJECT"],
+        os.environ["AVALON_ASSET"],
+        os.environ["AVALON_TASK"],
+        os.environ["AVALON_APP_NAME"]
+
+        asset_data = context.data["assetEntity"]["data"]
+        zoo_asset_data = asset_data.get("zou")
+        if not zoo_asset_data:
+            raise
+
+        kitsu_project = gazu.project.get_project(zoo_asset_data["project_id"])
+        if not kitsu_project:
+            raise
+        context.data["kitsu_project"] = kitsu_project
+
+        kitsu_asset = gazu.asset.get_asset(zoo_asset_data["entity_type_id"])
+        if not kitsu_asset:
+            raise
+        context.data["kitsu_asset"] = kitsu_asset
+
+        # kitsu_task_type = gazu.task.get_task_type_by_name(instance.data["task"])
+        # if not kitsu_task_type:
+        #     raise
+        # context.data["kitsu_task_type"] = kitsu_task_type
+
+        zoo_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get("zou")
+        kitsu_task = gazu.task.get_task(
+            asset_data["zou"],
+            kitsu_task_type
+        )
+        if not kitsu_task:
+            raise
+        context.data["kitsu_task"] = kitsu_task
+
+        wip = gazu.task.get_task_status_by_short_name("wip")
+
+        task = gazu.task.get_task_by_name(asset, modeling)
+        comment = gazu.task.add_comment(task, wip, "Change status to work in progress")
+
+        person = gazu.person.get_person_by_desktop_login("john.doe")
+
+        # task_type = gazu.task.get_task_type_by_name(instance.data["task"])
+
+        # entity_task = gazu.task.get_task_by_entity(
+        #     asset_data["zou"],
+        #     task_type
+        # )
+
+        raise
\ No newline at end of file

From 196c81ab78dffdafcca28c00657d11c799a9d7f4 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Fri, 8 Apr 2022 12:03:43 +0200
Subject: [PATCH 0169/1227] collect all kitsu entities in context

---
 .../plugins/publish/collect_kitsu_entities.py | 51 ++++++-------------
 1 file changed, 15 insertions(+), 36 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
index e4773f7b2a..f599fd0c14 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
@@ -13,52 +13,31 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
 
     def process(self, context):
 
-        os.environ["AVALON_PROJECT"],
-        os.environ["AVALON_ASSET"],
-        os.environ["AVALON_TASK"],
-        os.environ["AVALON_APP_NAME"]
-
         asset_data = context.data["assetEntity"]["data"]
         zoo_asset_data = asset_data.get("zou")
         if not zoo_asset_data:
-            raise
+            raise AssertionError("Zoo asset data not found in OpenPype!")
+        self.log.debug("Collected zoo asset data: {}".format(zoo_asset_data))
+
+        zoo_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get("zou")
+        if not zoo_task_data:
+            raise AssertionError("Zoo task data not found in OpenPype!")
+        self.log.debug("Collected zoo task data: {}".format(zoo_task_data))
 
         kitsu_project = gazu.project.get_project(zoo_asset_data["project_id"])
         if not kitsu_project:
-            raise
+            raise AssertionError("Project not not found in kitsu!")
         context.data["kitsu_project"] = kitsu_project
+        self.log.debug("Collect kitsu project: {}".format(kitsu_project))
 
-        kitsu_asset = gazu.asset.get_asset(zoo_asset_data["entity_type_id"])
+        kitsu_asset = gazu.asset.get_asset(zoo_asset_data["id"])
         if not kitsu_asset:
-            raise
+            raise AssertionError("Asset not not found in kitsu!")
         context.data["kitsu_asset"] = kitsu_asset
+        self.log.debug("Collect kitsu asset: {}".format(kitsu_asset))
 
-        # kitsu_task_type = gazu.task.get_task_type_by_name(instance.data["task"])
-        # if not kitsu_task_type:
-        #     raise
-        # context.data["kitsu_task_type"] = kitsu_task_type
-
-        zoo_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get("zou")
-        kitsu_task = gazu.task.get_task(
-            asset_data["zou"],
-            kitsu_task_type
-        )
+        kitsu_task = gazu.task.get_task(zoo_task_data["id"]) 
         if not kitsu_task:
-            raise
+            raise AssertionError("Task not not found in kitsu!")
         context.data["kitsu_task"] = kitsu_task
-
-        wip = gazu.task.get_task_status_by_short_name("wip")
-
-        task = gazu.task.get_task_by_name(asset, modeling)
-        comment = gazu.task.add_comment(task, wip, "Change status to work in progress")
-
-        person = gazu.person.get_person_by_desktop_login("john.doe")
-
-        # task_type = gazu.task.get_task_type_by_name(instance.data["task"])
-
-        # entity_task = gazu.task.get_task_by_entity(
-        #     asset_data["zou"],
-        #     task_type
-        # )
-
-        raise
\ No newline at end of file
+        self.log.debug("Collect kitsu task: {}".format(kitsu_task))

From eb288959f50666e0c9a4751d7908decd540de9de Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Sat, 9 Apr 2022 11:13:48 +0200
Subject: [PATCH 0170/1227] integrate note and status

---
 .../publish/collect_kitsu_credential.py       |  2 +-
 .../plugins/publish/integrate_kitsu_note.py   | 36 +++++++++++++++++++
 .../plugins/publish/integrate_kitsu_review.py | 16 +++++++++
 .../plugins/publish/validate_kitsu_intent.py  | 27 ++++++++++++++
 4 files changed, 80 insertions(+), 1 deletion(-)
 create mode 100644 openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
 create mode 100644 openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
 create mode 100644 openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
index bd0af16c8b..c9d94d128a 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
@@ -10,7 +10,7 @@ class CollectKitsuSession(pyblish.api.ContextPlugin):
 
     order = pyblish.api.CollectorOrder
     label = "Kitsu user session"
-
+    # families = ["kitsu"]
 
     def process(self, context):
 
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
new file mode 100644
index 0000000000..5601dea586
--- /dev/null
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -0,0 +1,36 @@
+import gazu
+import pyblish.api
+
+
+class IntegrateKitsuNote(pyblish.api.ContextPlugin):
+    """Integrate Kitsu Note"""
+
+    order = pyblish.api.IntegratorOrder
+    label = "Kitsu Note and Status"
+    # families = ["kitsu"]
+    optional = True
+
+    def process(self, context):
+
+        publish_comment = context.data.get("comment")
+        if not publish_comment:
+            self.log.info("Comment is not set.")
+
+        publish_status = context.data.get("intent", {}).get("value")
+        if not publish_status:
+            self.log.info("Status is not set.")
+
+        self.log.debug("Comment is `{}`".format(publish_comment))
+        self.log.debug("Status is `{}`".format(publish_status))
+
+        kitsu_status = context.data.get("kitsu_status")
+        if not kitsu_status:
+            self.log.info("The status will not be changed")
+            kitsu_status = context.data["kitsu_task"].get("task_status")
+        self.log.debug("Kitsu status: {}".format(kitsu_status))
+
+        gazu.task.add_comment(
+            context.data["kitsu_task"], 
+            kitsu_status, 
+            comment = publish_comment
+        )
\ No newline at end of file
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
new file mode 100644
index 0000000000..1853bf569f
--- /dev/null
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -0,0 +1,16 @@
+# import gazu
+import pyblish.api
+
+
+class IntegrateKitsuVersion(pyblish.api.InstancePlugin):
+    """Integrate Kitsu Review"""
+
+    order = pyblish.api.IntegratorOrder
+    label = "Kitsu Review"
+    # families = ["kitsu"]
+
+    def process(self, instance):
+        pass
+
+        # gazu.task.upload_preview_file(preview, file_path, normalize_movie=True, client=<gazu.client.KitsuClient object>)
+        # gazu.task.add_preview(task, comment, preview_file_path, normalize_movie=True, client=<gazu.client.KitsuClient object>)
\ No newline at end of file
diff --git a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
new file mode 100644
index 0000000000..9708ebb0dd
--- /dev/null
+++ b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
@@ -0,0 +1,27 @@
+from typing import Optional
+import pyblish.api
+import gazu
+
+
+class IntegrateKitsuNote(pyblish.api.ContextPlugin):
+    """Integrate Kitsu Note"""
+
+    order = pyblish.api.ValidatorOrder
+    label = "Kitsu Intent/Status"
+    # families = ["kitsu"]
+    optional = True
+    
+    def process(self, context):
+
+        publish_status = context.data.get("intent", {}).get("value")
+        if not publish_status:
+            self.log.info("Status is not set.")
+
+        kitsu_status = gazu.task.get_task_status_by_short_name(publish_status)
+        if not kitsu_status:
+            raise AssertionError(
+                "Status `{}` not not found in kitsu!".format(kitsu_status)
+            )
+        self.log.debug("Collect kitsu status: {}".format(kitsu_status))
+
+        context.data["kitsu_status"] = kitsu_status
\ No newline at end of file

From ff6c8a6a54b2146fce11b78ea7dccf048536d1e8 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Sun, 10 Apr 2022 10:47:11 +0200
Subject: [PATCH 0171/1227] Add kitsu log out

---
 .../plugins/publish/collect_kitsu_credential.py  |  4 ++--
 .../plugins/publish/collect_kitsu_entities.py    |  2 +-
 .../plugins/publish/integrate_kitsu_file.py      |  1 +
 .../plugins/publish/integrate_kitsu_note.py      |  1 +
 .../plugins/publish/integrate_kitsu_review.py    |  3 ++-
 .../kitsu/plugins/publish/other_kitsu_log_out.py | 16 ++++++++++++++++
 6 files changed, 23 insertions(+), 4 deletions(-)
 create mode 100644 openpype/modules/kitsu/plugins/publish/integrate_kitsu_file.py
 create mode 100644 openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
index c9d94d128a..4a27117e03 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
@@ -1,11 +1,11 @@
+# -*- coding: utf-8 -*-
 import os
 
 import gazu
-
 import pyblish.api
 
 
-class CollectKitsuSession(pyblish.api.ContextPlugin):
+class CollectKitsuSession(pyblish.api.ContextPlugin): #rename log in
     """Collect Kitsu session using user credentials"""
 
     order = pyblish.api.CollectorOrder
diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
index f599fd0c14..c5df20b349 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
@@ -1,7 +1,7 @@
+# -*- coding: utf-8 -*-
 import os
 
 import gazu
-
 import pyblish.api
 
 
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_file.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_file.py
new file mode 100644
index 0000000000..7c68785e9d
--- /dev/null
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_file.py
@@ -0,0 +1 @@
+# -*- coding: utf-8 -*-
\ No newline at end of file
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 5601dea586..8844581237 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -1,3 +1,4 @@
+# -*- coding: utf-8 -*-
 import gazu
 import pyblish.api
 
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index 1853bf569f..a800ca9b57 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -1,4 +1,5 @@
-# import gazu
+# -*- coding: utf-8 -*-
+import gazu
 import pyblish.api
 
 
diff --git a/openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py b/openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py
new file mode 100644
index 0000000000..ff76d9c4f6
--- /dev/null
+++ b/openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py
@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+"""."""
+import gazu
+import pyblish.api
+
+
+class KitsuLogOut(pyblish.api.ContextPlugin):
+    """
+    Log out from Kitsu API
+    """
+
+    order = pyblish.api.IntegratorOrder + 10
+    label = "Kitsu Log Out"
+
+    def process(self, context):
+        gazu.client.log_out()

From ed8c01c2639321126b43d84ad83bd06496cb1bad Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Wed, 20 Apr 2022 11:57:33 +0200
Subject: [PATCH 0172/1227] upload file to kitsu

---
 .../plugins/publish/integrate_kitsu_note.py   |  8 ++++---
 .../plugins/publish/integrate_kitsu_review.py | 24 +++++++++++++++----
 .../plugins/publish/validate_kitsu_intent.py  |  5 ++--
 3 files changed, 27 insertions(+), 10 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 8844581237..afe388fd82 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -9,7 +9,7 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     order = pyblish.api.IntegratorOrder
     label = "Kitsu Note and Status"
     # families = ["kitsu"]
-    optional = True
+    # optional = True
 
     def process(self, context):
 
@@ -30,8 +30,10 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             kitsu_status = context.data["kitsu_task"].get("task_status")
         self.log.debug("Kitsu status: {}".format(kitsu_status))
 
-        gazu.task.add_comment(
+        kitsu_comment = gazu.task.add_comment(
             context.data["kitsu_task"], 
             kitsu_status, 
             comment = publish_comment
-        )
\ No newline at end of file
+        )
+
+        context.data["kitsu_comment"] = kitsu_comment
\ No newline at end of file
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index a800ca9b57..e69937e9bf 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -1,4 +1,5 @@
 # -*- coding: utf-8 -*-
+import os
 import gazu
 import pyblish.api
 
@@ -6,12 +7,27 @@ import pyblish.api
 class IntegrateKitsuVersion(pyblish.api.InstancePlugin):
     """Integrate Kitsu Review"""
 
-    order = pyblish.api.IntegratorOrder
+    order = pyblish.api.IntegratorOrder + 0.01
     label = "Kitsu Review"
     # families = ["kitsu"]
 
     def process(self, instance):
-        pass
 
-        # gazu.task.upload_preview_file(preview, file_path, normalize_movie=True, client=<gazu.client.KitsuClient object>)
-        # gazu.task.add_preview(task, comment, preview_file_path, normalize_movie=True, client=<gazu.client.KitsuClient object>)
\ No newline at end of file
+        context = instance.context
+        task = context.data["kitsu_task"]
+        comment = context.data["kitsu_comment"]
+
+        for representation in instance.data.get("representations", []):
+
+            local_path = representation.get("published_path")
+            self.log.info("*"*40)
+            self.log.info(local_path)
+            self.log.info(representation.get("tags", []))
+
+            # code = os.path.basename(local_path)
+
+            if representation.get("tags", []):
+                continue
+            
+            # gazu.task.upload_preview_file(preview, file_path, normalize_movie=True)
+            gazu.task.add_preview(task, comment, local_path, normalize_movie=True)
\ No newline at end of file
diff --git a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
index 9708ebb0dd..0597e8546a 100644
--- a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
+++ b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
@@ -1,10 +1,9 @@
-from typing import Optional
 import pyblish.api
 import gazu
 
 
-class IntegrateKitsuNote(pyblish.api.ContextPlugin):
-    """Integrate Kitsu Note"""
+class ValidateKitsuIntent(pyblish.api.ContextPlugin):
+    """Validate Kitsu Status"""
 
     order = pyblish.api.ValidatorOrder
     label = "Kitsu Intent/Status"

From 2e0f6ce42d631674d910dc3caffc1654b6d781f2 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Wed, 20 Apr 2022 17:47:17 +0200
Subject: [PATCH 0173/1227] use task type if no task data in OP

---
 .../plugins/publish/collect_kitsu_entities.py | 33 +++++++++++++++----
 1 file changed, 27 insertions(+), 6 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
index c5df20b349..c907c22e0f 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
@@ -21,7 +21,7 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
 
         zoo_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get("zou")
         if not zoo_task_data:
-            raise AssertionError("Zoo task data not found in OpenPype!")
+            self.log.warning("Zoo task data not found in OpenPype!")
         self.log.debug("Collected zoo task data: {}".format(zoo_task_data))
 
         kitsu_project = gazu.project.get_project(zoo_asset_data["project_id"])
@@ -36,8 +36,29 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
         context.data["kitsu_asset"] = kitsu_asset
         self.log.debug("Collect kitsu asset: {}".format(kitsu_asset))
 
-        kitsu_task = gazu.task.get_task(zoo_task_data["id"]) 
-        if not kitsu_task:
-            raise AssertionError("Task not not found in kitsu!")
-        context.data["kitsu_task"] = kitsu_task
-        self.log.debug("Collect kitsu task: {}".format(kitsu_task))
+        if zoo_task_data:
+            kitsu_task = gazu.task.get_task(zoo_task_data["id"]) 
+            if not kitsu_task:
+                raise AssertionError("Task not not found in kitsu!")
+            context.data["kitsu_task"] = kitsu_task
+            self.log.debug("Collect kitsu task: {}".format(kitsu_task))
+        
+        else:
+            kitsu_task_type = gazu.task.get_task_type_by_name(
+                os.environ["AVALON_TASK"]
+            )
+            if not kitsu_task_type:
+                raise AssertionError(
+                    "Task type {} not found in Kitsu!".format(
+                        os.environ["AVALON_TASK"]
+                    )
+                )
+
+            kitsu_task = gazu.task.get_task_by_name(
+                kitsu_asset,
+                kitsu_task_type
+            )
+            if not kitsu_task:
+                raise AssertionError("Task not not found in kitsu!")
+            context.data["kitsu_task"] = kitsu_task
+            self.log.debug("Collect kitsu task: {}".format(kitsu_task))
\ No newline at end of file

From f72cb8ba9e6201be23f09515e3e3190408fc30a0 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Wed, 20 Apr 2022 17:56:39 +0200
Subject: [PATCH 0174/1227] fix log out

---
 openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py b/openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py
index ff76d9c4f6..d7e1616f8d 100644
--- a/openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py
+++ b/openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py
@@ -13,4 +13,4 @@ class KitsuLogOut(pyblish.api.ContextPlugin):
     label = "Kitsu Log Out"
 
     def process(self, context):
-        gazu.client.log_out()
+        gazu.log_out()

From 3d6a6fcbf065c5ed000aea43c7ce4b5db91cd47a Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Wed, 20 Apr 2022 18:10:58 +0200
Subject: [PATCH 0175/1227] upload review

---
 .../plugins/publish/integrate_kitsu_review.py | 22 +++++++++++--------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index e69937e9bf..23ee4a668e 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -1,15 +1,17 @@
 # -*- coding: utf-8 -*-
 import os
+from typing import Optional
 import gazu
 import pyblish.api
 
 
-class IntegrateKitsuVersion(pyblish.api.InstancePlugin):
+class IntegrateKitsuReview(pyblish.api.InstancePlugin):
     """Integrate Kitsu Review"""
 
     order = pyblish.api.IntegratorOrder + 0.01
     label = "Kitsu Review"
     # families = ["kitsu"]
+    optional = True
 
     def process(self, instance):
 
@@ -20,14 +22,16 @@ class IntegrateKitsuVersion(pyblish.api.InstancePlugin):
         for representation in instance.data.get("representations", []):
 
             local_path = representation.get("published_path")
-            self.log.info("*"*40)
-            self.log.info(local_path)
-            self.log.info(representation.get("tags", []))
 
-            # code = os.path.basename(local_path)
-
-            if representation.get("tags", []):
+            if 'review' not in representation.get("tags", []):
                 continue
             
-            # gazu.task.upload_preview_file(preview, file_path, normalize_movie=True)
-            gazu.task.add_preview(task, comment, local_path, normalize_movie=True)
\ No newline at end of file
+            self.log.debug("Found review at: {}".format(local_path))
+
+            gazu.task.add_preview(
+                task,
+                comment,
+                local_path,
+                normalize_movie=True
+            )
+            self.log.info("Review upload on comment")

From db8719b895cf553de6f24ad80f610fff28acfc21 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Wed, 20 Apr 2022 18:11:38 +0200
Subject: [PATCH 0176/1227] remove unused import

---
 .../modules/kitsu/plugins/publish/integrate_kitsu_review.py     | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index 23ee4a668e..59b3bcf53e 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -1,6 +1,4 @@
 # -*- coding: utf-8 -*-
-import os
-from typing import Optional
 import gazu
 import pyblish.api
 

From 7787056c969b0ca91f2f1eee1d58c6c92de2e4f8 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Wed, 20 Apr 2022 18:14:14 +0200
Subject: [PATCH 0177/1227] Do some cleanup

---
 .../plugins/publish/collect_kitsu_entities.py | 37 +++++++-------
 .../plugins/publish/integrate_kitsu_file.py   |  1 -
 .../plugins/publish/integrate_kitsu_note.py   |  5 +-
 .../plugins/publish/integrate_kitsu_review.py |  8 +--
 .../kitsu/plugins/publish/kitsu_plugin.py     | 49 -------------------
 .../plugins/publish/other_kitsu_log_out.py    |  1 -
 .../plugins/publish/validate_kitsu_intent.py  |  5 +-
 7 files changed, 28 insertions(+), 78 deletions(-)
 delete mode 100644 openpype/modules/kitsu/plugins/publish/integrate_kitsu_file.py
 delete mode 100644 openpype/modules/kitsu/plugins/publish/kitsu_plugin.py

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
index c907c22e0f..935b020641 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
@@ -14,35 +14,36 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
     def process(self, context):
 
         asset_data = context.data["assetEntity"]["data"]
-        zoo_asset_data = asset_data.get("zou")
-        if not zoo_asset_data:
-            raise AssertionError("Zoo asset data not found in OpenPype!")
-        self.log.debug("Collected zoo asset data: {}".format(zoo_asset_data))
+        zou_asset_data = asset_data.get("zou")
+        if not zou_asset_data:
+            raise AssertionError("Zou asset data not found in OpenPype!")
+        self.log.debug("Collected zou asset data: {}".format(zou_asset_data))
 
-        zoo_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get("zou")
-        if not zoo_task_data:
-            self.log.warning("Zoo task data not found in OpenPype!")
-        self.log.debug("Collected zoo task data: {}".format(zoo_task_data))
+        zou_task_data = asset_data["tasks"][
+            os.environ["AVALON_TASK"]].get("zou")
+        if not zou_task_data:
+            self.log.warning("Zou task data not found in OpenPype!")
+        self.log.debug("Collected zou task data: {}".format(zou_task_data))
 
-        kitsu_project = gazu.project.get_project(zoo_asset_data["project_id"])
+        kitsu_project = gazu.project.get_project(zou_asset_data["project_id"])
         if not kitsu_project:
-            raise AssertionError("Project not not found in kitsu!")
+            raise AssertionError("Project not found in kitsu!")
         context.data["kitsu_project"] = kitsu_project
         self.log.debug("Collect kitsu project: {}".format(kitsu_project))
 
-        kitsu_asset = gazu.asset.get_asset(zoo_asset_data["id"])
+        kitsu_asset = gazu.asset.get_asset(zou_asset_data["id"])
         if not kitsu_asset:
-            raise AssertionError("Asset not not found in kitsu!")
+            raise AssertionError("Asset not found in kitsu!")
         context.data["kitsu_asset"] = kitsu_asset
         self.log.debug("Collect kitsu asset: {}".format(kitsu_asset))
 
-        if zoo_task_data:
-            kitsu_task = gazu.task.get_task(zoo_task_data["id"]) 
+        if zou_task_data:
+            kitsu_task = gazu.task.get_task(zou_task_data["id"])
             if not kitsu_task:
-                raise AssertionError("Task not not found in kitsu!")
+                raise AssertionError("Task not found in kitsu!")
             context.data["kitsu_task"] = kitsu_task
             self.log.debug("Collect kitsu task: {}".format(kitsu_task))
-        
+
         else:
             kitsu_task_type = gazu.task.get_task_type_by_name(
                 os.environ["AVALON_TASK"]
@@ -59,6 +60,6 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
                 kitsu_task_type
             )
             if not kitsu_task:
-                raise AssertionError("Task not not found in kitsu!")
+                raise AssertionError("Task not found in kitsu!")
             context.data["kitsu_task"] = kitsu_task
-            self.log.debug("Collect kitsu task: {}".format(kitsu_task))
\ No newline at end of file
+            self.log.debug("Collect kitsu task: {}".format(kitsu_task))
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_file.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_file.py
deleted file mode 100644
index 7c68785e9d..0000000000
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_file.py
+++ /dev/null
@@ -1 +0,0 @@
-# -*- coding: utf-8 -*-
\ No newline at end of file
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index afe388fd82..61e4d2454c 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -9,7 +9,6 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     order = pyblish.api.IntegratorOrder
     label = "Kitsu Note and Status"
     # families = ["kitsu"]
-    # optional = True
 
     def process(self, context):
 
@@ -31,8 +30,8 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
         self.log.debug("Kitsu status: {}".format(kitsu_status))
 
         kitsu_comment = gazu.task.add_comment(
-            context.data["kitsu_task"], 
-            kitsu_status, 
+            context.data["kitsu_task"],
+            kitsu_status,
             comment = publish_comment
         )
 
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index 59b3bcf53e..c38f14e8a4 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -19,17 +19,17 @@ class IntegrateKitsuReview(pyblish.api.InstancePlugin):
 
         for representation in instance.data.get("representations", []):
 
-            local_path = representation.get("published_path")
+            review_path = representation.get("published_path")
 
             if 'review' not in representation.get("tags", []):
                 continue
-            
-            self.log.debug("Found review at: {}".format(local_path))
+
+            self.log.debug("Found review at: {}".format(review_path))
 
             gazu.task.add_preview(
                 task,
                 comment,
-                local_path,
+                review_path,
                 normalize_movie=True
             )
             self.log.info("Review upload on comment")
diff --git a/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py b/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
deleted file mode 100644
index 5d6c76bc3f..0000000000
--- a/openpype/modules/kitsu/plugins/publish/kitsu_plugin.py
+++ /dev/null
@@ -1,49 +0,0 @@
-import os
-
-import gazu
-
-import pyblish.api
-
-
-class CollectExampleAddon(pyblish.api.ContextPlugin):
-    order = pyblish.api.CollectorOrder + 0.4
-    label = "Collect Kitsu"
-
-    def process(self, context):
-        self.log.info("I'm in Kitsu's plugin!")
-
-
-class IntegrateRig(pyblish.api.InstancePlugin):
-    """Copy files to an appropriate location where others may reach it"""
-
-    order = pyblish.api.IntegratorOrder
-    families = ["model"]
-
-    def process(self, instance):
-
-        # Connect to server
-        gazu.client.set_host(os.environ["KITSU_SERVER"])
-
-        # Authenticate
-        gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
-
-        asset_data = instance.data["assetEntity"]["data"]
-
-        # Get task
-        task_type = gazu.task.get_task_type_by_name(instance.data["task"])
-        entity_task = gazu.task.get_task_by_entity(
-            asset_data["zou"], task_type
-        )
-
-        # Comment entity
-        gazu.task.add_comment(
-            entity_task,
-            entity_task["task_status_id"],
-            comment="Version {} has been published!\n".format(
-                instance.data["version"]
-            )
-            # Add written comment in Pyblish
-            + "\n{}".format(instance.data["versionEntity"]["data"]["comment"]),
-        )
-
-        self.log.info("Version published to Kitsu successfully!")
diff --git a/openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py b/openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py
index d7e1616f8d..c4a5b390e0 100644
--- a/openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py
+++ b/openpype/modules/kitsu/plugins/publish/other_kitsu_log_out.py
@@ -1,5 +1,4 @@
 # -*- coding: utf-8 -*-
-"""."""
 import gazu
 import pyblish.api
 
diff --git a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
index 0597e8546a..c82130b33b 100644
--- a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
+++ b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
@@ -1,3 +1,4 @@
+# -*- coding: utf-8 -*-
 import pyblish.api
 import gazu
 
@@ -9,7 +10,7 @@ class ValidateKitsuIntent(pyblish.api.ContextPlugin):
     label = "Kitsu Intent/Status"
     # families = ["kitsu"]
     optional = True
-    
+
     def process(self, context):
 
         publish_status = context.data.get("intent", {}).get("value")
@@ -19,7 +20,7 @@ class ValidateKitsuIntent(pyblish.api.ContextPlugin):
         kitsu_status = gazu.task.get_task_status_by_short_name(publish_status)
         if not kitsu_status:
             raise AssertionError(
-                "Status `{}` not not found in kitsu!".format(kitsu_status)
+                "Status `{}` not found in kitsu!".format(kitsu_status)
             )
         self.log.debug("Collect kitsu status: {}".format(kitsu_status))
 

From d9062b762ab82b85fb048084ef27ebf863a92366 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 5 May 2022 11:49:16 +0200
Subject: [PATCH 0178/1227] Update
 openpype/modules/kitsu/utils/update_zou_with_op.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/modules/kitsu/utils/update_zou_with_op.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_zou_with_op.py b/openpype/modules/kitsu/utils/update_zou_with_op.py
index d1fcde5601..526159d101 100644
--- a/openpype/modules/kitsu/utils/update_zou_with_op.py
+++ b/openpype/modules/kitsu/utils/update_zou_with_op.py
@@ -6,7 +6,7 @@ from typing import List
 import gazu
 from pymongo import UpdateOne
 
-from avalon.api import AvalonMongoDB
+from openpype.pipeline import AvalonMongoDB
 from openpype.api import get_project_settings
 from openpype.modules.kitsu.utils.credentials import validate_credentials
 

From 19b6cb7b6cbee03b60cf3d152af322a914f35514 Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Thu, 5 May 2022 18:05:22 +0200
Subject: [PATCH 0179/1227] concatenation output formats fix

---
 .../plugins/publish/extract_review_slate.py   | 25 +++++++++++--------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 59150e9d4a..77b40b785d 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -226,13 +226,15 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 ))
                 input_args.extend(["-timecode {}".format(offset_timecode)])
             if use_legacy_code:
+                format_args = []
                 codec_args = repre["_profile"].get('codec', [])
                 output_args.extend(codec_args)
                 # preset's output data
                 output_args.extend(repre["_profile"].get('output', []))
             else:
                 # Codecs are copied from source for whole input
-                codec_args = self._get_codec_args(repre)
+                format_args, codec_args = self._get_format_codec_args(repre)
+                output_args.extend(format_args)
                 output_args.extend(codec_args)
 
             # make sure colors are correct
@@ -338,6 +340,11 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 "-c", "copy",
                 "-timecode", offset_timecode,
             ]
+            # NOTE: Added because of OP Atom demuxers
+            # Add format arguments if there are any
+            # - keep format of output
+            if format_args:
+                concat_args.extend(format_args)
             # Use arguments from ffmpeg preset
             source_ffmpeg_cmd = repre.get("ffmpeg_cmd")
             if source_ffmpeg_cmd:
@@ -351,7 +358,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
                         concat_args.append(arg)
                         # assumes arg has one parameter
                         concat_args.append(args[indx + 1])
-            # add output
+            # add final output path
             concat_args.append(output_path)
 
             if not input_audio:
@@ -431,7 +438,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
         return vf_back
 
-    def _get_codec_args(self, repre):
+def _get_format_codec_args(self, repre):
         """Detect possible codec arguments from representation."""
         codec_args = []
 
@@ -454,16 +461,12 @@ class ExtractReviewSlate(openpype.api.Extractor):
             return codec_args
 
         source_ffmpeg_cmd = repre.get("ffmpeg_cmd")
-        codec_args.extend(
-            get_ffmpeg_format_args(ffprobe_data, source_ffmpeg_cmd)
-        )
-        codec_args.extend(
-            get_ffmpeg_codec_args(
-                ffprobe_data, source_ffmpeg_cmd, logger=self.log
-            )
+        format_args = get_ffmpeg_format_args(ffprobe_data, source_ffmpeg_cmd)
+        codec_args = get_ffmpeg_codec_args(
+            ffprobe_data, source_ffmpeg_cmd, logger=self.log
         )
 
-        return codec_args
+        return format_args, codec_args
 
     def _tc_offset(self, timecode, framerate=24.0, frame_offset=-1):
         """Offsets timecode by frame"""

From 2e7c82316a24d98c152d5571e20bcde512a1924e Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Thu, 5 May 2022 18:06:43 +0200
Subject: [PATCH 0180/1227] mad dog fix

---
 openpype/plugins/publish/extract_review_slate.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 77b40b785d..17ac4b68bc 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -438,6 +438,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
         return vf_back
 
+
 def _get_format_codec_args(self, repre):
         """Detect possible codec arguments from representation."""
         codec_args = []

From fe514cf385bf99683ef87d0fa78bd022f9fa69dd Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Thu, 5 May 2022 19:30:38 +0200
Subject: [PATCH 0181/1227] more fixes

---
 openpype/plugins/publish/extract_review_slate.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 17ac4b68bc..832799601c 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -439,7 +439,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
         return vf_back
 
 
-def _get_format_codec_args(self, repre):
+    def _get_format_codec_args(self, repre):
         """Detect possible codec arguments from representation."""
         codec_args = []
 

From e9afd17b296677b1558b83469cdf68cd3cf4e555 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 6 May 2022 10:02:20 +0200
Subject: [PATCH 0182/1227] converted event to be able create multiple
 independent event systems

---
 openpype/lib/events.py | 76 +++++++++++++++++++++++++++++++++---------
 1 file changed, 61 insertions(+), 15 deletions(-)

diff --git a/openpype/lib/events.py b/openpype/lib/events.py
index 7bec6ee30d..3762cec9f9 100644
--- a/openpype/lib/events.py
+++ b/openpype/lib/events.py
@@ -11,6 +11,10 @@ except Exception:
     from openpype.lib.python_2_comp import WeakMethod
 
 
+class MissingEventSystem(Exception):
+    pass
+
+
 class EventCallback(object):
     """Callback registered to a topic.
 
@@ -179,13 +183,14 @@ class Event(object):
     """
     _data = {}
 
-    def __init__(self, topic, data=None, source=None):
+    def __init__(self, topic, data=None, source=None, event_system=None):
         self._id = str(uuid4())
         self._topic = topic
         if data is None:
             data = {}
         self._data = data
         self._source = source
+        self._event_system = event_system
 
     def __getitem__(self, key):
         return self._data[key]
@@ -211,28 +216,69 @@ class Event(object):
 
     def emit(self):
         """Emit event and trigger callbacks."""
-        StoredCallbacks.emit_event(self)
+        if self._event_system is None:
+            raise MissingEventSystem(
+                "Can't emit event {}. Does not have set event system.".format(
+                    str(repr(self))
+                )
+            )
+        self._event_system.emit_event(self)
 
 
-class StoredCallbacks:
-    _registered_callbacks = []
+class EventSystem(object):
+    def __init__(self):
+        self._registered_callbacks = []
 
-    @classmethod
-    def add_callback(cls, topic, callback):
+    def add_callback(self, topic, callback):
         callback = EventCallback(topic, callback)
-        cls._registered_callbacks.append(callback)
+        self._registered_callbacks.append(callback)
         return callback
 
-    @classmethod
-    def emit_event(cls, event):
+    def create_event(self, topic, data, source):
+        return Event(topic, data, source, self)
+
+    def emit(self, topic, data, source):
+        event = self.create_event(topic, data, source)
+        event.emit()
+        return event
+
+    def emit_event(self, event):
         invalid_callbacks = []
-        for callback in cls._registered_callbacks:
+        for callback in self._registered_callbacks:
             callback.process_event(event)
             if not callback.is_ref_valid:
                 invalid_callbacks.append(callback)
 
         for callback in invalid_callbacks:
-            cls._registered_callbacks.remove(callback)
+            self._registered_callbacks.remove(callback)
+
+
+class GlobalEvent(Event):
+    def __init__(self, topic, data=None, source=None):
+        event_system = GlobalEventSystem.get_global_event_system()
+
+        super(GlobalEvent, self).__init__(topic, data, source, event_system)
+
+
+class GlobalEventSystem:
+    _global_event_system = None
+
+    @classmethod
+    def get_global_event_system(cls):
+        if cls._global_event_system is None:
+            cls._global_event_system = EventSystem()
+        return cls._global_event_system
+
+    @classmethod
+    def add_callback(cls, topic, callback):
+        event_system = cls.get_global_event_system()
+        return event_system.add_callback(topic, callback)
+
+    @classmethod
+    def emit(cls, topic, data, source):
+        event = GlobalEvent(topic, data, source)
+        event.emit()
+        return event
 
 
 def register_event_callback(topic, callback):
@@ -249,7 +295,8 @@ def register_event_callback(topic, callback):
             enable/disable listening to a topic or remove the callback from
             the topic completely.
     """
-    return StoredCallbacks.add_callback(topic, callback)
+
+    return GlobalEventSystem.add_callback(topic, callback)
 
 
 def emit_event(topic, data=None, source=None):
@@ -263,6 +310,5 @@ def emit_event(topic, data=None, source=None):
     Returns:
         Event: Object of event that was emitted.
     """
-    event = Event(topic, data, source)
-    event.emit()
-    return event
+
+    return GlobalEventSystem.emit(topic, data, source)

From 40d487221aa0ff0c60e89132db6aad7b95a31aa4 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Sat, 7 May 2022 08:05:59 +0900
Subject: [PATCH 0183/1227] OP/MV: Export correct node , export composition
 with absolute path.

---
 .../maya/plugins/publish/extract_multiverse_usd.py   |  6 ------
 .../plugins/publish/extract_multiverse_usd_comp.py   | 12 ++++++------
 2 files changed, 6 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
index 4e4efdc32c..9726c7e14c 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
@@ -149,12 +149,6 @@ class ExtractMultiverseUsd(openpype.api.Extractor):
 
         with maintained_selection():
             members = instance.data("setMembers")
-            members = cmds.ls(members,
-                              dag=True,
-                              shapes=True,
-                              type=("mesh"),
-                              noIntermediate=True,
-                              long=True)
             self.log.info('Collected object {}'.format(members))
 
             import multiverse
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
index 8fccc412e6..685e3d4592 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
@@ -90,12 +90,6 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
 
         with maintained_selection():
             members = instance.data("setMembers")
-            members = cmds.ls(members,
-                              dag=True,
-                              shapes=True,
-                              type="mvUsdCompoundShape",
-                              noIntermediate=True,
-                              long=True)
             self.log.info('Collected object {}'.format(members))
 
             import multiverse
@@ -119,6 +113,12 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
                 time_opts.framePerSecond = fps
 
             comp_write_opts = multiverse.CompositionWriteOptions()
+            if not hasattr(comp_write_opts,"forceAbsolutePaths"):
+                self.log.warning("multiverse.CompositionWriteOptions is " +
+                    "missing forceAbsolutePaths', extract will yield " +
+                    "inccorect reference paths.")
+            else:
+                comp_write_opts.forceAbsolutePaths = True
             options_discard_keys = {
                 'numTimeSamples',
                 'timeSamplesSpan',

From b796c2563decaf953f130e93df75d79d8dae54d2 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Mon, 9 May 2022 16:52:51 +0900
Subject: [PATCH 0184/1227] PEP Formatting and typo fixing.

---
 .../maya/plugins/publish/extract_multiverse_usd_comp.py     | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
index 685e3d4592..7bd7768da6 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
@@ -113,10 +113,10 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
                 time_opts.framePerSecond = fps
 
             comp_write_opts = multiverse.CompositionWriteOptions()
-            if not hasattr(comp_write_opts,"forceAbsolutePaths"):
+            if not hasattr(comp_write_opts, "forceAbsolutePaths"):
                 self.log.warning("multiverse.CompositionWriteOptions is " +
-                    "missing forceAbsolutePaths', extract will yield " +
-                    "inccorect reference paths.")
+                                 "missing 'forceAbsolutePaths', extract " +
+                                 "will yield incorrect reference paths.")
             else:
                 comp_write_opts.forceAbsolutePaths = True
             options_discard_keys = {

From 8bb0c2779113aaa4ec1b8681a3d89232912fface Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Mon, 9 May 2022 17:21:47 +0900
Subject: [PATCH 0185/1227] Removing attr check and explaining in a comment.

---
 .../publish/extract_multiverse_usd_comp.py     | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
index 7bd7768da6..e6bc0c68b5 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
@@ -113,12 +113,18 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
                 time_opts.framePerSecond = fps
 
             comp_write_opts = multiverse.CompositionWriteOptions()
-            if not hasattr(comp_write_opts, "forceAbsolutePaths"):
-                self.log.warning("multiverse.CompositionWriteOptions is " +
-                                 "missing 'forceAbsolutePaths', extract " +
-                                 "will yield incorrect reference paths.")
-            else:
-                comp_write_opts.forceAbsolutePaths = True
+
+            """ 
+            OP tells MV to write to a staging directory, and then moves the
+            file to it's final publish directory. By default, MV write relative
+            paths, but these paths will break when the referencing file moves.
+            This option forces writes to absolute paths, which is ok within OP
+            because all published assets have static paths, and MV can only 
+            reference published assets. When a proper UsdAssetResolver is used,
+            this won't be needed.
+            """
+            comp_write_opts.forceAbsolutePaths = True
+
             options_discard_keys = {
                 'numTimeSamples',
                 'timeSamplesSpan',

From 7cf7f5ee7434c0a818a161de74677422f0a4f667 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Tue, 10 May 2022 12:18:52 +0900
Subject: [PATCH 0186/1227] Adding support for choosing .usd/.usda/.usdz. Fix a
 bug in extract override where it was selecting a locator that shouldn't be
 selected.

---
 .../plugins/create/create_multiverse_usd.py   |  3 ++-
 .../create/create_multiverse_usd_comp.py      |  1 +
 .../create/create_multiverse_usd_over.py      |  3 ++-
 .../plugins/publish/extract_multiverse_usd.py | 18 ++++++++++-----
 .../publish/extract_multiverse_usd_comp.py    | 18 ++++++++++-----
 .../publish/extract_multiverse_usd_over.py    | 22 +++++++++++++------
 6 files changed, 46 insertions(+), 19 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
index b2266e5a57..e64d7d90b8 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
@@ -2,7 +2,7 @@ from openpype.hosts.maya.api import plugin, lib
 
 
 class CreateMultiverseUsd(plugin.Creator):
-    """Multiverse USD data"""
+    """Create Multiverse USD Asset"""
 
     name = "usdMain"
     label = "Multiverse USD"
@@ -15,6 +15,7 @@ class CreateMultiverseUsd(plugin.Creator):
         # Add animation data first, since it maintains order.
         self.data.update(lib.collect_animation_data(True))
 
+        self.data["fileFormat"] = ["usd", "usda", "usdz"]
         self.data["stripNamespaces"] = False
         self.data["mergeTransformAndShape"] = False
         self.data["writeAncestors"] = True
diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
index 77b808c459..accdffad46 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
@@ -15,6 +15,7 @@ class CreateMultiverseUsdComp(plugin.Creator):
         # Add animation data first, since it maintains order.
         self.data.update(lib.collect_animation_data(True))
 
+        self.data["fileFormat"] = ["usd", "usda"]
         self.data["stripNamespaces"] = False
         self.data["mergeTransformAndShape"] = False
         self.data["flattenContent"] = False
diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
index bb82ab2039..25892f68bb 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
@@ -2,7 +2,7 @@ from openpype.hosts.maya.api import plugin, lib
 
 
 class CreateMultiverseUsdOver(plugin.Creator):
-    """Multiverse USD data"""
+    """Create Multiverse USD Override"""
 
     name = "usdOverrideMain"
     label = "Multiverse USD Override"
@@ -15,6 +15,7 @@ class CreateMultiverseUsdOver(plugin.Creator):
         # Add animation data first, since it maintains order.
         self.data.update(lib.collect_animation_data(True))
 
+        self.data["fileFormat"] = ["usd", "usda"]
         self.data["writeAll"] = False
         self.data["writeTransforms"] = True
         self.data["writeVisibility"] = True
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
index 9726c7e14c..74fcf2bee7 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
@@ -13,6 +13,8 @@ class ExtractMultiverseUsd(openpype.api.Extractor):
     label = "Extract Multiverse USD"
     hosts = ["maya"]
     families = ["usd"]
+    scene_type = "usd"
+    file_formats = ["usd", "usda", "usdz"]
 
     @property
     def options(self):
@@ -129,13 +131,19 @@ class ExtractMultiverseUsd(openpype.api.Extractor):
 
         return options
 
+    def get_file_format(self, instance):
+        fileFormat = instance.data["fileFormat"]
+        if fileFormat in range(len(self.file_formats)):
+            self.scene_type = self.file_formats[fileFormat]
+
     def process(self, instance):
-        # Load plugin firstly
+        # Load plugin first
         cmds.loadPlugin("MultiverseForMaya", quiet=True)
 
         # Define output file path
         staging_dir = self.staging_dir(instance)
-        file_name = "{}.usd".format(instance.name)
+        self.get_file_format(instance)
+        file_name = "{0}.{1}".format(instance.name, self.scene_type)
         file_path = os.path.join(staging_dir, file_name)
         file_path = file_path.replace('\\', '/')
 
@@ -193,10 +201,10 @@ class ExtractMultiverseUsd(openpype.api.Extractor):
             instance.data["representations"] = []
 
         representation = {
-            'name': 'usd',
-            'ext': 'usd',
+            'name': self.scene_type,
+            'ext': self.scene_type,
             'files': file_name,
-            "stagingDir": staging_dir
+            'stagingDir': staging_dir
         }
         instance.data["representations"].append(representation)
 
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
index e6bc0c68b5..c686b2a600 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
@@ -12,6 +12,8 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
     label = "Extract Multiverse USD Composition"
     hosts = ["maya"]
     families = ["usdComposition"]
+    scene_type = "usd"
+    file_formats = ["usd", "usda"]
 
     @property
     def options(self):
@@ -70,13 +72,19 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
 
         return options
 
+    def get_file_format(self, instance):
+        fileFormat = instance.data["fileFormat"]
+        if fileFormat in range(len(self.file_formats)):
+            self.scene_type = self.file_formats[fileFormat]
+
     def process(self, instance):
-        # Load plugin firstly
+        # Load plugin first
         cmds.loadPlugin("MultiverseForMaya", quiet=True)
 
         # Define output file path
         staging_dir = self.staging_dir(instance)
-        file_name = "{}.usd".format(instance.name)
+        self.get_file_format(instance)
+        file_name = "{0}.{1}".format(instance.name, self.scene_type)
         file_path = os.path.join(staging_dir, file_name)
         file_path = file_path.replace('\\', '/')
 
@@ -146,10 +154,10 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
             instance.data["representations"] = []
 
         representation = {
-            'name': 'usd',
-            'ext': 'usd',
+            'name': self.scene_type,
+            'ext': self.scene_type,
             'files': file_name,
-            "stagingDir": staging_dir
+            'stagingDir': staging_dir
         }
         instance.data["representations"].append(representation)
 
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
index ce0e8a392a..77680d09f9 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
@@ -12,6 +12,8 @@ class ExtractMultiverseUsdOverride(openpype.api.Extractor):
     label = "Extract Multiverse USD Override"
     hosts = ["maya"]
     families = ["usdOverride"]
+    scene_type = "usd"
+    file_formats = ["usd", "usda"]
 
     @property
     def options(self):
@@ -57,13 +59,19 @@ class ExtractMultiverseUsdOverride(openpype.api.Extractor):
             "timeSamplesSpan": 0.0
         }
 
+    def get_file_format(self, instance):
+        fileFormat = instance.data["fileFormat"]
+        if fileFormat in range(len(self.file_formats)):
+            self.scene_type = self.file_formats[fileFormat]
+
     def process(self, instance):
-        # Load plugin firstly
+        # Load plugin first
         cmds.loadPlugin("MultiverseForMaya", quiet=True)
 
         # Define output file path
         staging_dir = self.staging_dir(instance)
-        file_name = "{}.usda".format(instance.name)
+        self.get_file_format(instance)
+        file_name = "{0}.{1}".format(instance.name, self.scene_type)
         file_path = os.path.join(staging_dir, file_name)
         file_path = file_path.replace("\\", "/")
 
@@ -78,7 +86,7 @@ class ExtractMultiverseUsdOverride(openpype.api.Extractor):
             members = instance.data("setMembers")
             members = cmds.ls(members,
                               dag=True,
-                              shapes=True,
+                              shapes=False,
                               type="mvUsdCompoundShape",
                               noIntermediate=True,
                               long=True)
@@ -128,10 +136,10 @@ class ExtractMultiverseUsdOverride(openpype.api.Extractor):
             instance.data["representations"] = []
 
         representation = {
-            "name": "usd",
-            "ext": "usd",
-            "files": file_name,
-            "stagingDir": staging_dir
+            'name': self.scene_type,
+            'ext': self.scene_type,
+            'files': file_name,
+            'stagingDir': staging_dir
         }
         instance.data["representations"].append(representation)
 

From f7fc6a3e7007d80d0f75ccedcf381267c676f089 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 10 May 2022 16:52:13 +0200
Subject: [PATCH 0187/1227] flame: fixing attr_name issue

---
 openpype/hosts/flame/api/lib.py           |  2 +-
 openpype/hosts/flame/otio/flame_export.py | 91 +++++------------------
 2 files changed, 21 insertions(+), 72 deletions(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index c7c444c1fb..2e9b535764 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -560,7 +560,7 @@ def get_segment_attributes(segment):
         if not hasattr(segment, attr_name):
             continue
         attr = getattr(segment, attr_name)
-        segment_attrs_data[attr] = str(attr).replace("+", ":")
+        segment_attrs_data[attr_name] = str(attr).replace("+", ":")
 
         if attr_name in ["record_in", "record_out"]:
             clip_data[attr_name] = attr.relative_frame
diff --git a/openpype/hosts/flame/otio/flame_export.py b/openpype/hosts/flame/otio/flame_export.py
index 4fe05ec1d8..d84ee98256 100644
--- a/openpype/hosts/flame/otio/flame_export.py
+++ b/openpype/hosts/flame/otio/flame_export.py
@@ -94,83 +94,30 @@ def create_otio_time_range(start_frame, frame_duration, fps):
 
 def _get_metadata(item):
     if hasattr(item, 'metadata'):
-        if not item.metadata:
-            return {}
-        return {key: value for key, value in dict(item.metadata)}
+        return dict(dict(item.metadata)) if item.metadata else {}
     return {}
 
 
-def create_time_effects(otio_clip, item):
-    # todo #2426: add retiming effects to export
-    # get all subtrack items
-    # subTrackItems = flatten(track_item.parent().subTrackItems())
-    # speed = track_item.playbackSpeed()
+# def create_time_effects(otio_clip, clip_data):
+#     otio_effect = None
 
-    # otio_effect = None
-    # # retime on track item
-    # if speed != 1.:
-    #     # make effect
-    #     otio_effect = otio.schema.LinearTimeWarp()
-    #     otio_effect.name = "Speed"
-    #     otio_effect.time_scalar = speed
-    #     otio_effect.metadata = {}
+#     # retime on track item
+#     if speed != 1.:
+#         # make effect
+#         otio_effect = otio.schema.LinearTimeWarp()
+#         otio_effect.name = "Speed"
+#         otio_effect.time_scalar = speed
+#         otio_effect.metadata = {}
 
-    # # freeze frame effect
-    # if speed == 0.:
-    #     otio_effect = otio.schema.FreezeFrame()
-    #     otio_effect.name = "FreezeFrame"
-    #     otio_effect.metadata = {}
+#     # freeze frame effect
+#     if speed == 0.:
+#         otio_effect = otio.schema.FreezeFrame()
+#         otio_effect.name = "FreezeFrame"
+#         otio_effect.metadata = {}
 
-    # if otio_effect:
-    #     # add otio effect to clip effects
-    #     otio_clip.effects.append(otio_effect)
-
-    # # loop through and get all Timewarps
-    # for effect in subTrackItems:
-    #     if ((track_item not in effect.linkedItems())
-    #             and (len(effect.linkedItems()) > 0)):
-    #         continue
-    #     # avoid all effect which are not TimeWarp and disabled
-    #     if "TimeWarp" not in effect.name():
-    #         continue
-
-    #     if not effect.isEnabled():
-    #         continue
-
-    #     node = effect.node()
-    #     name = node["name"].value()
-
-    #     # solve effect class as effect name
-    #     _name = effect.name()
-    #     if "_" in _name:
-    #         effect_name = re.sub(r"(?:_)[_0-9]+", "", _name)  # more numbers
-    #     else:
-    #         effect_name = re.sub(r"\d+", "", _name)  # one number
-
-    #     metadata = {}
-    #     # add knob to metadata
-    #     for knob in ["lookup", "length"]:
-    #         value = node[knob].value()
-    #         animated = node[knob].isAnimated()
-    #         if animated:
-    #             value = [
-    #                 ((node[knob].getValueAt(i)) - i)
-    #                 for i in range(
-    #                     track_item.timelineIn(),
-    #                     track_item.timelineOut() + 1)
-    #             ]
-
-    #         metadata[knob] = value
-
-    #     # make effect
-    #     otio_effect = otio.schema.TimeEffect()
-    #     otio_effect.name = name
-    #     otio_effect.effect_name = effect_name
-    #     otio_effect.metadata = metadata
-
-    #     # add otio effect to clip effects
-    #     otio_clip.effects.append(otio_effect)
-    pass
+#     if otio_effect:
+#         # add otio effect to clip effects
+#         otio_clip.effects.append(otio_effect)
 
 
 def _get_marker_color(flame_colour):
@@ -363,6 +310,8 @@ def create_otio_clip(clip_data):
     if MARKERS_INCLUDE:
         create_otio_markers(otio_clip, segment)
 
+    create_time_effects(otio_clip, clip_data)
+
     return otio_clip
 
 

From 21b83e341b754506d982c8ec05cb28d647c296cd Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 10 May 2022 16:59:20 +0200
Subject: [PATCH 0188/1227] flame" adding empty families to workfile instance

---
 openpype/hosts/flame/plugins/publish/collect_timeline_otio.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_otio.py b/openpype/hosts/flame/plugins/publish/collect_timeline_otio.py
index f2ae1f62a9..0a9b0db334 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_otio.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_otio.py
@@ -39,7 +39,8 @@ class CollecTimelineOTIO(pyblish.api.ContextPlugin):
                 "name": subset_name,
                 "asset": asset_doc["name"],
                 "subset": subset_name,
-                "family": "workfile"
+                "family": "workfile",
+                "families": []
             }
 
             # create instance with workfile

From 9483adc91eaa0958f14090ba8af3e773b80247f9 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 10 May 2022 16:59:39 +0200
Subject: [PATCH 0189/1227] Flame: commenting out effects - not yet implemented

---
 openpype/hosts/flame/otio/flame_export.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/otio/flame_export.py b/openpype/hosts/flame/otio/flame_export.py
index d84ee98256..fc960b670c 100644
--- a/openpype/hosts/flame/otio/flame_export.py
+++ b/openpype/hosts/flame/otio/flame_export.py
@@ -310,7 +310,7 @@ def create_otio_clip(clip_data):
     if MARKERS_INCLUDE:
         create_otio_markers(otio_clip, segment)
 
-    create_time_effects(otio_clip, clip_data)
+    # create_time_effects(otio_clip, clip_data)
 
     return otio_clip
 

From de31b8d1df9458f1daa1ac9a385e648f588f4cf6 Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Tue, 10 May 2022 20:14:02 +0200
Subject: [PATCH 0190/1227] add silent audio to slate

---
 .../plugins/publish/extract_review_slate.py   | 74 ++++++++++++-------
 1 file changed, 47 insertions(+), 27 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 832799601c..2ef5308225 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -1,5 +1,4 @@
 import os
-import shutil
 import openpype.api
 import pyblish
 from openpype.lib import (
@@ -11,6 +10,7 @@ from openpype.lib import (
     get_ffmpeg_format_args,
 )
 
+
 class ExtractReviewSlate(openpype.api.Extractor):
     """
     Will add slate frame at the start of the video files
@@ -122,10 +122,14 @@ class ExtractReviewSlate(openpype.api.Extractor):
                     if stream["channel_layout"]:
                         audio_channel_layout = str(
                             stream.get("channel_layout"))
+                    if stream["codec_name"]:
+                        audio_codec = str(
+                            stream.get("codec_name"))
                     if (
                         audio_channels
                         and audio_sample_rate
                         and audio_channel_layout
+                        and audio_codec
                     ):
                         input_audio = True
                         break
@@ -200,16 +204,6 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
             input_args.append("-loop 1 -i {}".format(
                 openpype.lib.path_to_subprocess_arg(slate_path)))
-            # if input has an audio, add silent audio to the slate
-            if input_audio:
-                input_args.extend(
-                    ["-f lavfi -i anullsrc=r={}:cl={}:d={}".format(
-                        audio_sample_rate,
-                        audio_channel_layout,
-                        one_frame_duration
-                    )]
-                )
-
             input_args.extend(["-r {}".format(input_frame_rate)])
             input_args.extend(["-frames:v 1"])
             # add timecode from source to the slate, substract one frame
@@ -314,6 +308,41 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 slate_subprocess_cmd, shell=True, logger=self.log
             )
 
+            # Create slate with silent audio track
+            if input_audio:
+                # silent slate output path
+                slate_silent_path = slate_path.replace(".png", "Silent" + ext)
+                _remove_at_end.append(slate_silent_path)
+
+                slate_silent_args = [
+                    ffmpeg_path,
+                    "-i", slate_v_path,
+                    "-f", "lavfi", "-i",
+                    "anullsrc=r={}:cl={}:d={}".format(
+                        audio_sample_rate,
+                        audio_channel_layout,
+                        one_frame_duration
+                    ),
+                    "-c:v", "copy",
+                    "-c:a", audio_codec,
+                    "-map", "0:v",
+                    "-map", "1:a",
+                    "-shortest",
+                    "-y",
+                    slate_silent_path
+                ]
+                slate_silent_subprocess_cmd = " ".join(slate_silent_args)
+                # run slate generation subprocess
+                self.log.debug(
+                    "Silent Slate Executing: {}".format(slate_silent_subprocess_cmd)
+                )
+                openpype.api.run_subprocess(
+                    slate_silent_subprocess_cmd, shell=True, logger=self.log
+                )
+
+                # replace slate with silent slate for concat
+                slate_v_path = slate_silent_path
+
             # create ffmpeg concat text file path
             conc_text_file = input_file.replace(ext, "") + "_concat" + ".txt"
             conc_text_path = os.path.join(
@@ -361,21 +390,13 @@ class ExtractReviewSlate(openpype.api.Extractor):
             # add final output path
             concat_args.append(output_path)
 
-            if not input_audio:
-                # ffmpeg concat subprocess
-                self.log.debug(
-                    "Executing concat: {}".format(" ".join(concat_args))
-                )
-                openpype.api.run_subprocess(
-                    concat_args, logger=self.log
-                )
-            else:
-                self.log.warning(
-                    "Audio found. Creating slate with audio"
-                    " is not supported at this time. Outputing slate-less"
-                    ":\n{}".format(input_file))
-                # skip concatenating slate, use slate-less file instead
-                shutil.copyfile(input_path, output_path)
+            # ffmpeg concat subprocess
+            self.log.debug(
+                "Executing concat: {}".format(" ".join(concat_args))
+            )
+            openpype.api.run_subprocess(
+                concat_args, logger=self.log
+            )
 
             self.log.debug("__ repre[tags]: {}".format(repre["tags"]))
             repre_update = {
@@ -438,7 +459,6 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
         return vf_back
 
-
     def _get_format_codec_args(self, repre):
         """Detect possible codec arguments from representation."""
         codec_args = []

From b0c9e8a29d4c16d3276989fee37c8d8762d67809 Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Tue, 10 May 2022 20:35:04 +0200
Subject: [PATCH 0191/1227] hound

---
 openpype/plugins/publish/extract_review_slate.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 2ef5308225..d3f8934620 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -334,8 +334,8 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 slate_silent_subprocess_cmd = " ".join(slate_silent_args)
                 # run slate generation subprocess
                 self.log.debug(
-                    "Silent Slate Executing: {}".format(slate_silent_subprocess_cmd)
-                )
+                    "Silent Slate Executing: {}".format(
+                        slate_silent_subprocess_cmd))
                 openpype.api.run_subprocess(
                     slate_silent_subprocess_cmd, shell=True, logger=self.log
                 )

From ff37e6135b6a2e22fede236268683ae3e5e1936c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 10 May 2022 20:51:28 +0200
Subject: [PATCH 0192/1227] global: removing `clip` family from excluded -
 obsolete

---
 openpype/plugins/publish/integrate_new.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index bf13a4050e..353314fff2 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -113,7 +113,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "usdOverride",
                 "simpleUnrealTexture"
                 ]
-    exclude_families = ["clip", "render.farm"]
+    exclude_families = ["render.farm"]
     db_representation_context_keys = [
         "project", "asset", "task", "subset", "version", "representation",
         "family", "hierarchy", "task", "username"

From ba1587efb6faf0e8cf21bf949fa36dbc5061d780 Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Wed, 11 May 2022 12:22:34 +0200
Subject: [PATCH 0193/1227] safer code

---
 .../plugins/publish/extract_review_slate.py   | 32 +++++++++++--------
 1 file changed, 19 insertions(+), 13 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index d3f8934620..b84dbbc2ac 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -79,7 +79,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
             )
             # Get video metadata
             for stream in streams:
-                input_timecode = None
+                input_timecode = ""
                 input_width = None
                 input_height = None
                 input_frame_rate = None
@@ -89,18 +89,20 @@ class ExtractReviewSlate(openpype.api.Extractor):
                         tags = stream.get("tags") or {}
                         input_timecode = tags.get("timecode") or ""
                         if "width" in stream and "height" in stream:
-                            input_width = int(stream.get("width"))
-                            input_height = int(stream.get("height"))
+                            input_width = stream.get("width")
+                            input_height = stream.get("height")
                         if "r_frame_rate" in stream:
                             # get frame rate in a form of
                             # x/y, like 24000/1001 for 23.976
-                            input_frame_rate = str(stream.get("r_frame_rate"))
+                            input_frame_rate = stream.get("r_frame_rate")
                         if (
-                            input_timecode
-                            and input_width
+                            input_width
                             and input_height
                             and input_frame_rate
                         ):
+                            input_width = int(input_width)
+                            input_height = int(input_height)
+                            input_frame_rate = str(input_frame_rate)
                             break
             # Raise exception of any stream didn't define input resolution
             if input_width is None:
@@ -131,7 +133,10 @@ class ExtractReviewSlate(openpype.api.Extractor):
                         and audio_channel_layout
                         and audio_codec
                     ):
-                        input_audio = True
+                        input_audio = str(input_audio)
+                        audio_sample_rate = str(audio_sample_rate)
+                        audio_channel_layout = str(audio_channel_layout)
+                        audio_codec = str(audio_codec)
                         break
             # Get duration of one frame in micro seconds
             one_frame_duration = "40000us"
@@ -207,7 +212,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
             input_args.extend(["-r {}".format(input_frame_rate)])
             input_args.extend(["-frames:v 1"])
             # add timecode from source to the slate, substract one frame
-            offset_timecode = "00:00:00:00"
+            offset_timecode = ""
             if input_timecode:
                 offset_timecode = str(input_timecode)
                 offset_timecode = self._tc_offset(
@@ -311,7 +316,8 @@ class ExtractReviewSlate(openpype.api.Extractor):
             # Create slate with silent audio track
             if input_audio:
                 # silent slate output path
-                slate_silent_path = slate_path.replace(".png", "Silent" + ext)
+                slate_silent_path = "_silent".join(
+                    os.path.splitext(slate_v_path))
                 _remove_at_end.append(slate_silent_path)
 
                 slate_silent_args = [
@@ -331,13 +337,12 @@ class ExtractReviewSlate(openpype.api.Extractor):
                     "-y",
                     slate_silent_path
                 ]
-                slate_silent_subprocess_cmd = " ".join(slate_silent_args)
                 # run slate generation subprocess
                 self.log.debug(
                     "Silent Slate Executing: {}".format(
-                        slate_silent_subprocess_cmd))
+                        " ".join(slate_silent_args)))
                 openpype.api.run_subprocess(
-                    slate_silent_subprocess_cmd, shell=True, logger=self.log
+                    slate_silent_args, logger=self.log
                 )
 
                 # replace slate with silent slate for concat
@@ -367,8 +372,9 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 "-safe", "0",
                 "-i", conc_text_path,
                 "-c", "copy",
-                "-timecode", offset_timecode,
             ]
+            if offset_timecode:
+                concat_args.extend(["-timecode", offset_timecode])
             # NOTE: Added because of OP Atom demuxers
             # Add format arguments if there are any
             # - keep format of output

From 26fcd19a5d8bed9849c924c62a949b25e62c6189 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 11 May 2022 12:29:30 +0200
Subject: [PATCH 0194/1227] use dbcon.Session instead of collection

---
 openpype/modules/kitsu/utils/sync_service.py  | 83 +++++++++----------
 .../modules/kitsu/utils/update_op_with_zou.py | 42 +++++-----
 .../modules/kitsu/utils/update_zou_with_op.py |  6 +-
 3 files changed, 63 insertions(+), 68 deletions(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 01596e2667..ad18e1f391 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -119,8 +119,8 @@ class Listener:
 
         # Write into DB
         if update_project:
-            project_col = self.dbcon.database[project_name]
-            project_col.bulk_write([update_project])
+            self.dbcon = self.dbcon.database[project_name]
+            self.dbcon.bulk_write([update_project])
 
     def _delete_project(self, data):
         """Delete project."""
@@ -129,28 +129,27 @@ class Listener:
         project = gazu.project.get_project(data["project_id"])
 
         # Delete project collection
-        project_col = self.dbcon.database[project["name"]]
-        project_col.drop()
+        # self.dbcon = self.dbcon.database[project["name"]]
 
     # == Asset ==
 
     def _new_asset(self, data):
         """Create new asset into OP DB."""
         # Get project entity
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
 
         # Get gazu entity
         asset = gazu.asset.get_asset(data["asset_id"])
 
         # Insert doc in DB
-        project_col.insert_one(create_op_asset(asset))
+        self.dbcon.insert_one(create_op_asset(asset))
 
         # Update
         self._update_asset(data)
 
     def _update_asset(self, data):
         """Update asset into OP DB."""
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
         project_doc = self.dbcon.find_one({"type": "project"})
 
         # Get gazu entity
@@ -160,23 +159,23 @@ class Listener:
         # Query all assets of the local project
         zou_ids_and_asset_docs = {
             asset_doc["data"]["zou"]["id"]: asset_doc
-            for asset_doc in project_col.find({"type": "asset"})
+            for asset_doc in self.dbcon.find({"type": "asset"})
             if asset_doc["data"].get("zou", {}).get("id")
         }
         zou_ids_and_asset_docs[asset["project_id"]] = project_doc
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            project_col[asset], zou_ids_and_asset_docs
+            self.dbcon[asset], zou_ids_and_asset_docs
         )[0]
-        project_col.update_one({"_id": asset_doc_id}, asset_update)
+        self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
     def _delete_asset(self, data):
         """Delete asset of OP DB."""
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
 
         # Delete
-        project_col.delete_one(
+        self.dbcon.delete_one(
             {"type": "asset", "data.zou.id": data["asset_id"]}
         )
 
@@ -184,20 +183,20 @@ class Listener:
     def _new_episode(self, data):
         """Create new episode into OP DB."""
         # Get project entity
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
 
         # Get gazu entity
         episode = gazu.shot.get_episode(data["episode_id"])
 
         # Insert doc in DB
-        project_col.insert_one(create_op_asset(episode))
+        self.dbcon.insert_one(create_op_asset(episode))
 
         # Update
         self._update_episode(data)
 
     def _update_episode(self, data):
         """Update episode into OP DB."""
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
         project_doc = self.dbcon.find_one({"type": "project"})
 
         # Get gazu entity
@@ -207,24 +206,24 @@ class Listener:
         # Query all assets of the local project
         zou_ids_and_asset_docs = {
             asset_doc["data"]["zou"]["id"]: asset_doc
-            for asset_doc in project_col.find({"type": "asset"})
+            for asset_doc in self.dbcon.find({"type": "asset"})
             if asset_doc["data"].get("zou", {}).get("id")
         }
         zou_ids_and_asset_docs[episode["project_id"]] = project_doc
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            project_col, [episode], zou_ids_and_asset_docs
+            self.dbcon, [episode], zou_ids_and_asset_docs
         )[0]
-        project_col.update_one({"_id": asset_doc_id}, asset_update)
+        self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
     def _delete_episode(self, data):
         """Delete shot of OP DB."""
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
         print("delete episode")  # TODO check bugfix
 
         # Delete
-        project_col.delete_one(
+        self.dbcon.delete_one(
             {"type": "asset", "data.zou.id": data["episode_id"]}
         )
 
@@ -232,20 +231,20 @@ class Listener:
     def _new_sequence(self, data):
         """Create new sequnce into OP DB."""
         # Get project entity
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
 
         # Get gazu entity
         sequence = gazu.shot.get_sequence(data["sequence_id"])
 
         # Insert doc in DB
-        project_col.insert_one(create_op_asset(sequence))
+        self.dbcon.insert_one(create_op_asset(sequence))
 
         # Update
         self._update_sequence(data)
 
     def _update_sequence(self, data):
         """Update sequence into OP DB."""
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
         project_doc = self.dbcon.find_one({"type": "project"})
 
         # Get gazu entity
@@ -255,24 +254,24 @@ class Listener:
         # Query all assets of the local project
         zou_ids_and_asset_docs = {
             asset_doc["data"]["zou"]["id"]: asset_doc
-            for asset_doc in project_col.find({"type": "asset"})
+            for asset_doc in self.dbcon.find({"type": "asset"})
             if asset_doc["data"].get("zou", {}).get("id")
         }
         zou_ids_and_asset_docs[sequence["project_id"]] = project_doc
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            project_col, [sequence], zou_ids_and_asset_docs
+            self.dbcon, [sequence], zou_ids_and_asset_docs
         )[0]
-        project_col.update_one({"_id": asset_doc_id}, asset_update)
+        self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
     def _delete_sequence(self, data):
         """Delete sequence of OP DB."""
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
         print("delete sequence")  # TODO check bugfix
 
         # Delete
-        project_col.delete_one(
+        self.dbcon.delete_one(
             {"type": "asset", "data.zou.id": data["sequence_id"]}
         )
 
@@ -280,20 +279,20 @@ class Listener:
     def _new_shot(self, data):
         """Create new shot into OP DB."""
         # Get project entity
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
 
         # Get gazu entity
         shot = gazu.shot.get_shot(data["shot_id"])
 
         # Insert doc in DB
-        project_col.insert_one(create_op_asset(shot))
+        self.dbcon.insert_one(create_op_asset(shot))
 
         # Update
         self._update_shot(data)
 
     def _update_shot(self, data):
         """Update shot into OP DB."""
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
         project_doc = self.dbcon.find_one({"type": "project"})
 
         # Get gazu entity
@@ -303,23 +302,23 @@ class Listener:
         # Query all assets of the local project
         zou_ids_and_asset_docs = {
             asset_doc["data"]["zou"]["id"]: asset_doc
-            for asset_doc in project_col.find({"type": "asset"})
+            for asset_doc in self.dbcon.find({"type": "asset"})
             if asset_doc["data"].get("zou", {}).get("id")
         }
         zou_ids_and_asset_docs[shot["project_id"]] = project_doc
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            project_col, [shot], zou_ids_and_asset_docs
+            self.dbcon, [shot], zou_ids_and_asset_docs
         )[0]
-        project_col.update_one({"_id": asset_doc_id}, asset_update)
+        self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
     def _delete_shot(self, data):
         """Delete shot of OP DB."""
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
 
         # Delete
-        project_col.delete_one(
+        self.dbcon.delete_one(
             {"type": "asset", "data.zou.id": data["shot_id"]}
         )
 
@@ -327,13 +326,13 @@ class Listener:
     def _new_task(self, data):
         """Create new task into OP DB."""
         # Get project entity
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
 
         # Get gazu entity
         task = gazu.task.get_task(data["task_id"])
 
         # Find asset doc
-        asset_doc = project_col.find_one(
+        asset_doc = self.dbcon.find_one(
             {"type": "asset", "data.zou.id": task["entity"]["id"]}
         )
 
@@ -341,7 +340,7 @@ class Listener:
         asset_tasks = asset_doc["data"].get("tasks")
         task_type_name = task["task_type"]["name"]
         asset_tasks[task_type_name] = {"type": task_type_name, "zou": task}
-        project_col.update_one(
+        self.dbcon.update_one(
             {"_id": asset_doc["_id"]}, {"$set": {"data.tasks": asset_tasks}}
         )
 
@@ -352,10 +351,10 @@ class Listener:
 
     def _delete_task(self, data):
         """Delete task of OP DB."""
-        project_col = set_op_project(self.dbcon, data["project_id"])
+        set_op_project(self.dbcon, data["project_id"])
 
         # Find asset doc
-        asset_docs = [doc for doc in project_col.find({"type": "asset"})]
+        asset_docs = [doc for doc in self.dbcon.find({"type": "asset"})]
         for doc in asset_docs:
             # Match task
             for name, task in doc["data"]["tasks"].items():
@@ -365,7 +364,7 @@ class Listener:
                     asset_tasks.pop(name)
 
                     # Delete task in DB
-                    project_col.update_one(
+                    self.dbcon.update_one(
                         {"_id": doc["_id"]},
                         {"$set": {"data.tasks": asset_tasks}},
                     )
diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 25c89800d4..6e82ffbd05 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -29,18 +29,17 @@ def create_op_asset(gazu_entity: dict) -> dict:
     }
 
 
-def set_op_project(dbcon, project_id) -> Collection:
+def set_op_project(dbcon: AvalonMongoDB, project_id: str):
     """Set project context.
 
-    :param dbcon: Connection to DB.
-    :param project_id: Project zou ID
+    Args:
+        dbcon (AvalonMongoDB): Connection to DB.
+        project_id (str): Project zou ID
     """
     project = gazu.project.get_project(project_id)
     project_name = project["name"]
     dbcon.Session["AVALON_PROJECT"] = project_name
 
-    return dbcon.database[project_name]
-
 
 def update_op_assets(
     project_col: Collection,
@@ -258,28 +257,25 @@ def sync_all_project(login: str, password: str):
     dbcon.install()
     all_projects = gazu.project.all_open_projects()
     for project in all_projects:
-        sync_project_from_kitsu(project["name"], dbcon, project)
+        sync_project_from_kitsu(dbcon, project)
 
 
 def sync_project_from_kitsu(
-    project_name: str, dbcon: AvalonMongoDB, project: dict = None
+    dbcon: AvalonMongoDB, project: dict
 ):
     """Update OP project in DB with Zou data.
 
     Args:
-        project_name (str): Name of project to sync
         dbcon (AvalonMongoDB): MongoDB connection
-        project (dict, optional): Project dict got using gazu.
-                                  Defaults to None.
+        project (dict): Project dict got using gazu.
     """
     bulk_writes = []
 
     # Get project from zou
     if not project:
-        project = gazu.project.get_project_by_name(project_name)
-    project_code = project_name
+        project = gazu.project.get_project_by_name(project["name"])
 
-    print(f"Synchronizing {project_name}...")
+    print(f"Synchronizing {project['name']}...")
 
     # Get all assets from zou
     all_assets = gazu.asset.all_assets_for_project(project)
@@ -292,28 +288,28 @@ def sync_project_from_kitsu(
     bulk_writes.append(write_project_to_op(project, dbcon))
 
     # Try to find project document
-    project_col = dbcon.database[project_code]
-    project_doc = project_col.find_one({"type": "project"})
+    dbcon.Session["AVALON_PROJECT"] = project["name"]
+    project_doc = dbcon.find_one({"type": "project"})
 
     # Query all assets of the local project
     zou_ids_and_asset_docs = {
         asset_doc["data"]["zou"]["id"]: asset_doc
-        for asset_doc in project_col.find({"type": "asset"})
+        for asset_doc in dbcon.find({"type": "asset"})
         if asset_doc["data"].get("zou", {}).get("id")
     }
     zou_ids_and_asset_docs[project["id"]] = project_doc
 
     # Create entities root folders
-    project_module_settings = get_project_settings(project_name)["kitsu"]
+    project_module_settings = get_project_settings(project["name"])["kitsu"]
     for entity_type, root in project_module_settings["entities_root"].items():
         parent_folders = root.split("/")
         direct_parent_doc = None
         for i, folder in enumerate(parent_folders, 1):
-            parent_doc = project_col.find_one(
+            parent_doc = dbcon.find_one(
                 {"type": "asset", "name": folder, "data.root_of": entity_type}
             )
             if not parent_doc:
-                direct_parent_doc = project_col.insert_one(
+                direct_parent_doc = dbcon.insert_one(
                     {
                         "name": folder,
                         "type": "asset",
@@ -338,13 +334,13 @@ def sync_project_from_kitsu(
     )
     if to_insert:
         # Insert doc in DB
-        project_col.insert_many(to_insert)
+        dbcon.insert_many(to_insert)
 
         # Update existing docs
         zou_ids_and_asset_docs.update(
             {
                 asset_doc["data"]["zou"]["id"]: asset_doc
-                for asset_doc in project_col.find({"type": "asset"})
+                for asset_doc in dbcon.find({"type": "asset"})
                 if asset_doc["data"].get("zou")
             }
         )
@@ -354,7 +350,7 @@ def sync_project_from_kitsu(
         [
             UpdateOne({"_id": id}, update)
             for id, update in update_op_assets(
-                project_col, all_entities, zou_ids_and_asset_docs
+                dbcon, all_entities, zou_ids_and_asset_docs
             )
         ]
     )
@@ -373,4 +369,4 @@ def sync_project_from_kitsu(
 
     # Write into DB
     if bulk_writes:
-        project_col.bulk_write(bulk_writes)
+        dbcon.bulk_write(bulk_writes)
diff --git a/openpype/modules/kitsu/utils/update_zou_with_op.py b/openpype/modules/kitsu/utils/update_zou_with_op.py
index 526159d101..81d421206f 100644
--- a/openpype/modules/kitsu/utils/update_zou_with_op.py
+++ b/openpype/modules/kitsu/utils/update_zou_with_op.py
@@ -93,10 +93,10 @@ def sync_zou_from_op_project(
 
     # Query all assets of the local project
     project_module_settings = get_project_settings(project_name)["kitsu"]
-    project_col = dbcon.database[project_name]
+    dbcon.Session["AVALON_PROJECT"] = project_name
     asset_docs = {
         asset_doc["_id"]: asset_doc
-        for asset_doc in project_col.find({"type": "asset"})
+        for asset_doc in dbcon.find({"type": "asset"})
     }
 
     # Create new assets
@@ -259,4 +259,4 @@ def sync_zou_from_op_project(
 
     # Write into DB
     if bulk_writes:
-        project_col.bulk_write(bulk_writes)
+        dbcon.bulk_write(bulk_writes)

From 765546e6f96cf8ba480c20e65ad3f19cc8a24267 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 11 May 2022 12:31:08 +0200
Subject: [PATCH 0195/1227] fix unused var

---
 openpype/modules/kitsu/utils/sync_service.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index ad18e1f391..8c7ce730a7 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -126,7 +126,7 @@ class Listener:
         """Delete project."""
         # Get project entity
         print(data)  # TODO check bugfix
-        project = gazu.project.get_project(data["project_id"])
+        # project = gazu.project.get_project(data["project_id"])
 
         # Delete project collection
         # self.dbcon = self.dbcon.database[project["name"]]

From 43baf02d98e2fa899ec84ab163cb97d8453167d8 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 11 May 2022 13:22:42 +0200
Subject: [PATCH 0196/1227] flame: refactory MediaInfo class

- to be able match collection if sequence with holes
- also make code more explicit about input arguments
---
 openpype/hosts/flame/api/lib.py | 119 ++++++++++++++++++++++++++++----
 1 file changed, 105 insertions(+), 14 deletions(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index 2e9b535764..15e6f8ae80 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -3,6 +3,7 @@ import os
 import re
 import json
 import pickle
+import clique
 import tempfile
 import itertools
 import contextlib
@@ -773,17 +774,24 @@ class MediaInfoFile(object):
         self._validate_media_script_path()
 
         # derivate other feed variables
-        self.feed_basename = os.path.basename(path)
-        self.feed_dir = os.path.dirname(path)
-        self.feed_ext = os.path.splitext(self.feed_basename)[1][1:].lower()
+        feed_basename = os.path.basename(path)
+        feed_dir = os.path.dirname(path)
+        feed_ext = os.path.splitext(feed_basename)[1][1:].lower()
 
         with maintained_temp_file_path(".clip") as tmp_path:
             self.log.info("Temp File: {}".format(tmp_path))
-            self._generate_media_info_file(tmp_path)
+            self._generate_media_info_file(tmp_path, feed_ext, feed_dir)
+
+            if os.path.exists(os.path.join(feed_dir, feed_basename)):
+                test_fname = feed_basename
+            else:
+                # get collection containing feed_basename from path
+                test_fname = self._get_collection(feed_basename, feed_dir, feed_ext)
 
             # get clip data and make them single if there is multiple
             # clips data
-            xml_data = self._make_single_clip_media_info(tmp_path)
+            xml_data = self._make_single_clip_media_info(
+                tmp_path, feed_basename, test_fname)
             self.log.debug("xml_data: {}".format(xml_data))
             self.log.debug("type: {}".format(type(xml_data)))
 
@@ -794,6 +802,73 @@ class MediaInfoFile(object):
             self.log.debug("drop frame: {}".format(self.drop_mode))
             self.clip_data = xml_data
 
+    def _get_collection(self, feed_basename, feed_dir, feed_ext):
+        partialname = self._separate_file_head(feed_basename, feed_ext)
+        log.debug("__ partialname: {}".format(partialname))
+
+        # make sure partial input basename is having correct extensoon
+        if not partialname:
+            raise IOError("File doesnt exists. Basename - {}, Ext - {}".format(
+                feed_basename, feed_ext
+            ))
+
+        # get all related files
+        files = [
+            f for f in os.listdir(feed_dir)
+            if partialname == self._separate_file_head(f, feed_ext)
+        ]
+
+        # ignore reminders as we dont need them
+        collections = clique.assemble(files)[0]
+
+        # if no collection rise
+        if not collections:
+            raise IOError("_get_collection is failing on: {} {} {}".format(
+                feed_basename, feed_dir, feed_ext
+            ))
+        else:
+            # we expect only one collection
+            collection = collections[0]
+
+        if collection.is_contiguous():
+            # if no holes then return collection
+            return collection.format("{head}[{range}]{tail}")
+
+        # add `[` in front to make sure it want capture
+        # shot name with the same number
+        number_from_path = "[" + self._separate_number(feed_basename, feed_ext)
+        # convert to multiple collections
+        _continues_colls = collection.separate()
+        for _coll in _continues_colls:
+            coll_to_text = _coll.format("{head}[{range}]{tail}")
+            log.debug("__ coll_to_text: {}".format(coll_to_text))
+            if number_from_path in coll_to_text:
+                return coll_to_text
+
+    def _separate_file_head(self, basename, extension):
+        # in case sequence file
+        found = re.findall(
+            r"(.*)[._][\d]*(?=.{})".format(extension),
+            basename,
+        )
+        if found:
+            return found.pop()
+
+        # in case single file
+        name, ext = os.path.splitext(basename)
+
+        if extension == ext[1:]:
+            return name
+
+    def _separate_number(self, basename, extension):
+        # in case sequence file
+        found = re.findall(
+            r"[._]([\d]*)(?=.{})".format(extension),
+            basename,
+        )
+        if found:
+            return found.pop()
+
     @property
     def clip_data(self):
         """Clip's xml clip data
@@ -851,13 +926,13 @@ class MediaInfoFile(object):
             raise IOError("Media Scirpt does not exist: `{}`".format(
                 self.MEDIA_SCRIPT_PATH))
 
-    def _generate_media_info_file(self, fpath):
+    def _generate_media_info_file(self, fpath, feed_ext, feed_dir):
         # Create cmd arguments for gettig xml file info file
         cmd_args = [
             self.MEDIA_SCRIPT_PATH,
-            "-e", self.feed_ext,
+            "-e", feed_ext,
             "-o", fpath,
-            self.feed_dir
+            feed_dir
         ]
 
         try:
@@ -867,7 +942,7 @@ class MediaInfoFile(object):
             raise TypeError(
                 "Error creating `{}` due: {}".format(fpath, error))
 
-    def _make_single_clip_media_info(self, fpath):
+    def _make_single_clip_media_info(self, fpath, feed_basename, path_pattern):
         with open(fpath) as f:
             lines = f.readlines()
             _added_root = itertools.chain(
@@ -878,14 +953,32 @@ class MediaInfoFile(object):
         xml_clips = new_root.findall("clip")
         matching_clip = None
         for xml_clip in xml_clips:
-            if xml_clip.find("name").text in self.feed_basename:
-                matching_clip = xml_clip
+            clip_name = xml_clip.find("name").text
+            log.debug("__ clip_name: `{}`".format(clip_name))
+            if clip_name not in feed_basename:
+                continue
+
+            # test path pattern
+            for out_track in xml_clip.iter("track"):
+                for out_feed in out_track.iter("feed"):
+                    for span in out_feed.iter("span"):
+                        # start frame
+                        span_path = span.find("path")
+                        if not span_path:
+                            continue
+                        log.debug(
+                            "__ span_path.text: {}, path_pattern: {}".format(
+                                span_path.text, path_pattern
+                            )
+                        )
+                        if path_pattern in span_path.text:
+                            matching_clip = xml_clip
 
         if matching_clip is None:
             # return warning there is missing clip
             raise ET.ParseError(
                 "Missing clip in `{}`. Available clips {}".format(
-                    self.feed_basename, [
+                    feed_basename, [
                         xml_clip.find("name").text
                         for xml_clip in xml_clips
                     ]
@@ -912,8 +1005,6 @@ class MediaInfoFile(object):
                         'startTimecode/dropMode')
                     self.drop_mode = out_feed_drop_mode_obj.text
                     break
-                else:
-                    continue
         except Exception as msg:
             self.log.warning(msg)
 

From c34ecfd9127004e0c739be7bb0efdb11d162c447 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 11 May 2022 13:35:35 +0200
Subject: [PATCH 0197/1227] flame: fixing logger

---
 openpype/hosts/flame/api/lib.py           | 8 ++++----
 openpype/hosts/flame/otio/flame_export.py | 4 +++-
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index 15e6f8ae80..6fff3edc30 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -804,7 +804,7 @@ class MediaInfoFile(object):
 
     def _get_collection(self, feed_basename, feed_dir, feed_ext):
         partialname = self._separate_file_head(feed_basename, feed_ext)
-        log.debug("__ partialname: {}".format(partialname))
+        self.log.debug("__ partialname: {}".format(partialname))
 
         # make sure partial input basename is having correct extensoon
         if not partialname:
@@ -841,7 +841,7 @@ class MediaInfoFile(object):
         _continues_colls = collection.separate()
         for _coll in _continues_colls:
             coll_to_text = _coll.format("{head}[{range}]{tail}")
-            log.debug("__ coll_to_text: {}".format(coll_to_text))
+            self.log.debug("__ coll_to_text: {}".format(coll_to_text))
             if number_from_path in coll_to_text:
                 return coll_to_text
 
@@ -954,7 +954,7 @@ class MediaInfoFile(object):
         matching_clip = None
         for xml_clip in xml_clips:
             clip_name = xml_clip.find("name").text
-            log.debug("__ clip_name: `{}`".format(clip_name))
+            self.log.debug("__ clip_name: `{}`".format(clip_name))
             if clip_name not in feed_basename:
                 continue
 
@@ -966,7 +966,7 @@ class MediaInfoFile(object):
                         span_path = span.find("path")
                         if not span_path:
                             continue
-                        log.debug(
+                        self.log.debug(
                             "__ span_path.text: {}, path_pattern: {}".format(
                                 span_path.text, path_pattern
                             )
diff --git a/openpype/hosts/flame/otio/flame_export.py b/openpype/hosts/flame/otio/flame_export.py
index fc960b670c..c54ebb43d3 100644
--- a/openpype/hosts/flame/otio/flame_export.py
+++ b/openpype/hosts/flame/otio/flame_export.py
@@ -280,7 +280,9 @@ def create_otio_clip(clip_data):
     segment = clip_data["PySegment"]
 
     # calculate source in
-    media_info = MediaInfoFile(clip_data["fpath"])
+    media_info = MediaInfoFile(clip_data["fpath"], **{
+        "logger": log
+    })
     media_timecode_start = media_info.start_frame
     media_fps = media_info.fps
 

From 27d9e9bd3e9a9ef03489290101535aeb79617e23 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 11 May 2022 14:08:05 +0200
Subject: [PATCH 0198/1227] Fix delete project

---
 openpype/modules/kitsu/utils/sync_service.py       | 9 +++++----
 openpype/modules/kitsu/utils/update_op_with_zou.py | 1 +
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 8c7ce730a7..8d1ffb199d 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -124,12 +124,13 @@ class Listener:
 
     def _delete_project(self, data):
         """Delete project."""
-        # Get project entity
-        print(data)  # TODO check bugfix
-        # project = gazu.project.get_project(data["project_id"])
+        project_doc = self.dbcon.find_one(
+            {"type": "project", "data.zou_id": data["project_id"]}
+        )
 
         # Delete project collection
-        # self.dbcon = self.dbcon.database[project["name"]]
+        self.dbcon.database[project_doc["name"]].drop()
+
 
     # == Asset ==
 
diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 6e82ffbd05..03a10e76a6 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -218,6 +218,7 @@ def write_project_to_op(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
             "fps": project["fps"],
             "resolutionWidth": project["resolution"].split("x")[0],
             "resolutionHeight": project["resolution"].split("x")[1],
+            "zou_id": project["id"],
         }
     )
 

From aac7797f06934dfc123c8a97e53106b6c442c54b Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 11 May 2022 14:26:36 +0200
Subject: [PATCH 0199/1227] flame: check collection first

---
 openpype/hosts/flame/api/lib.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index 6fff3edc30..8e2ef2d624 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -782,11 +782,15 @@ class MediaInfoFile(object):
             self.log.info("Temp File: {}".format(tmp_path))
             self._generate_media_info_file(tmp_path, feed_ext, feed_dir)
 
-            if os.path.exists(os.path.join(feed_dir, feed_basename)):
+            # get collection containing feed_basename from path
+            test_fname = self._get_collection(
+                feed_basename, feed_dir, feed_ext)
+
+            if (
+                not test_fname
+                and os.path.exists(os.path.join(feed_dir, feed_basename))
+            ):
                 test_fname = feed_basename
-            else:
-                # get collection containing feed_basename from path
-                test_fname = self._get_collection(feed_basename, feed_dir, feed_ext)
 
             # get clip data and make them single if there is multiple
             # clips data

From 82e62230fa78520d6cf167b0eaaec8095e5d18a6 Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Wed, 11 May 2022 14:35:38 +0200
Subject: [PATCH 0200/1227] int back

---
 openpype/plugins/publish/extract_review_slate.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index b84dbbc2ac..7b2df4dc5f 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -89,8 +89,8 @@ class ExtractReviewSlate(openpype.api.Extractor):
                         tags = stream.get("tags") or {}
                         input_timecode = tags.get("timecode") or ""
                         if "width" in stream and "height" in stream:
-                            input_width = stream.get("width")
-                            input_height = stream.get("height")
+                            input_width = int(stream.get("width"))
+                            input_height = int(stream.get("height"))
                         if "r_frame_rate" in stream:
                             # get frame rate in a form of
                             # x/y, like 24000/1001 for 23.976
@@ -100,8 +100,6 @@ class ExtractReviewSlate(openpype.api.Extractor):
                             and input_height
                             and input_frame_rate
                         ):
-                            input_width = int(input_width)
-                            input_height = int(input_height)
                             input_frame_rate = str(input_frame_rate)
                             break
             # Raise exception of any stream didn't define input resolution

From b7f7af46fbd00e8b62822efd8b999f28fdb5bf6b Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 11 May 2022 14:47:34 +0200
Subject: [PATCH 0201/1227] flame: redundant condition

---
 openpype/hosts/flame/api/lib.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index 8e2ef2d624..660466b0aa 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -968,8 +968,6 @@ class MediaInfoFile(object):
                     for span in out_feed.iter("span"):
                         # start frame
                         span_path = span.find("path")
-                        if not span_path:
-                            continue
                         self.log.debug(
                             "__ span_path.text: {}, path_pattern: {}".format(
                                 span_path.text, path_pattern

From 7f1b8f7f038d63cd53ee36e6d419aff62271adb3 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 11 May 2022 16:00:30 +0200
Subject: [PATCH 0202/1227] flame: adding docstrings

---
 openpype/hosts/flame/api/lib.py | 39 ++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index 660466b0aa..7125a540a0 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -807,12 +807,26 @@ class MediaInfoFile(object):
             self.clip_data = xml_data
 
     def _get_collection(self, feed_basename, feed_dir, feed_ext):
+        """ Get collection string
+
+        Args:
+            feed_basename (str): file base name
+            feed_dir (str): file's directory
+            feed_ext (str): file extension
+
+        Raises:
+            AttributeError: feed_ext is not matching feed_basename
+            IOError: Failing on not correct input data
+
+        Returns:
+            str: collection basename with range of sequence
+        """
         partialname = self._separate_file_head(feed_basename, feed_ext)
         self.log.debug("__ partialname: {}".format(partialname))
 
         # make sure partial input basename is having correct extensoon
         if not partialname:
-            raise IOError("File doesnt exists. Basename - {}, Ext - {}".format(
+            raise AttributeError("Wrong input attributes. Basename - {}, Ext - {}".format(
                 feed_basename, feed_ext
             ))
 
@@ -850,6 +864,15 @@ class MediaInfoFile(object):
                 return coll_to_text
 
     def _separate_file_head(self, basename, extension):
+        """ Get only head with out sequence and extension
+
+        Args:
+            basename (str): file base name
+            extension (str): file extension
+
+        Returns:
+            str: file head
+        """
         # in case sequence file
         found = re.findall(
             r"(.*)[._][\d]*(?=.{})".format(extension),
@@ -865,6 +888,15 @@ class MediaInfoFile(object):
             return name
 
     def _separate_number(self, basename, extension):
+        """ Get only sequence number as string
+
+        Args:
+            basename (str): file base name
+            extension (str): file extension
+
+        Returns:
+            str: number with padding
+        """
         # in case sequence file
         found = re.findall(
             r"[._]([\d]*)(?=.{})".format(extension),
@@ -989,6 +1021,11 @@ class MediaInfoFile(object):
         return matching_clip
 
     def _get_time_info_from_origin(self, xml_data):
+        """Set time info to class attributes
+
+        Args:
+            xml_data (ET.Element): clip data
+        """
         try:
             for out_track in xml_data.iter('track'):
                 for out_feed in out_track.iter('feed'):

From ac16e1f8bb6f79a3dca750848b5d7450571ff6b3 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 11 May 2022 16:05:22 +0200
Subject: [PATCH 0203/1227] flame: adding more docstring

---
 openpype/hosts/flame/api/lib.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index 7125a540a0..03e3d117a3 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -963,6 +963,16 @@ class MediaInfoFile(object):
                 self.MEDIA_SCRIPT_PATH))
 
     def _generate_media_info_file(self, fpath, feed_ext, feed_dir):
+        """ Generate media info xml .clip file
+
+        Args:
+            fpath (str): .clip file path
+            feed_ext (str): file extension to be filtered
+            feed_dir (str): look up directory
+
+        Raises:
+            TypeError: Type error if it fails
+        """
         # Create cmd arguments for gettig xml file info file
         cmd_args = [
             self.MEDIA_SCRIPT_PATH,
@@ -979,6 +989,19 @@ class MediaInfoFile(object):
                 "Error creating `{}` due: {}".format(fpath, error))
 
     def _make_single_clip_media_info(self, fpath, feed_basename, path_pattern):
+        """ Separate only relative clip object form .clip file
+
+        Args:
+            fpath (str): clip file path
+            feed_basename (str): search basename
+            path_pattern (str): search file pattern (file.[1-2].exr)
+
+        Raises:
+            ET.ParseError: if nothing found
+
+        Returns:
+            ET.Element: xml element data of matching clip
+        """
         with open(fpath) as f:
             lines = f.readlines()
             _added_root = itertools.chain(

From af77d5a888f371c3bab4c2e38483ecaa7e7c6023 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 11 May 2022 16:37:17 +0200
Subject: [PATCH 0204/1227] fix wrong name entities makes crash: they are
 skipped

---
 openpype/modules/kitsu/utils/sync_service.py      |  2 +-
 .../modules/kitsu/utils/update_op_with_zou.py     | 15 +++++++++++----
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 8d1ffb199d..46d3422727 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -131,7 +131,6 @@ class Listener:
         # Delete project collection
         self.dbcon.database[project_doc["name"]].drop()
 
-
     # == Asset ==
 
     def _new_asset(self, data):
@@ -150,6 +149,7 @@ class Listener:
 
     def _update_asset(self, data):
         """Update asset into OP DB."""
+        # TODO check if asset doesn't exist, create it (case where name wasn't valid)
         set_op_project(self.dbcon, data["project_id"])
         project_doc = self.dbcon.find_one({"type": "project"})
 
diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 03a10e76a6..fbc23cf52e 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -1,5 +1,6 @@
 """Functions to update OpenPype data using Kitsu DB (a.k.a Zou)."""
 from copy import deepcopy
+import re
 from typing import Dict, List
 
 from pymongo import DeleteOne, UpdateOne
@@ -16,6 +17,10 @@ from openpype.lib import create_project
 from openpype.modules.kitsu.utils.credentials import validate_credentials
 
 
+# Accepted namin pattern for OP
+naming_pattern = re.compile("^[a-zA-Z0-9_.]*$")
+
+
 def create_op_asset(gazu_entity: dict) -> dict:
     """Create OP asset dict from gazu entity.
 
@@ -261,9 +266,7 @@ def sync_all_project(login: str, password: str):
         sync_project_from_kitsu(dbcon, project)
 
 
-def sync_project_from_kitsu(
-    dbcon: AvalonMongoDB, project: dict
-):
+def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
     """Update OP project in DB with Zou data.
 
     Args:
@@ -283,7 +286,11 @@ def sync_project_from_kitsu(
     all_episodes = gazu.shot.all_episodes_for_project(project)
     all_seqs = gazu.shot.all_sequences_for_project(project)
     all_shots = gazu.shot.all_shots_for_project(project)
-    all_entities = all_assets + all_episodes + all_seqs + all_shots
+    all_entities = [
+        item
+        for item in all_assets + all_episodes + all_seqs + all_shots
+        if naming_pattern.match(item["name"])
+    ]
 
     # Sync project. Create if doesn't exist
     bulk_writes.append(write_project_to_op(project, dbcon))

From ea54b0dc2512eeb428b1f3ea702a10a55ac6ccf3 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 9 May 2022 10:28:09 +0200
Subject: [PATCH 0205/1227] refactor

---
 openpype/hosts/nuke/startup/menu.py           | 31 +++++++++++++++++++
 .../defaults/project_settings/nuke.json       |  4 +++
 .../projects_schema/schema_project_maya.json  |  2 +-
 .../projects_schema/schema_project_nuke.json  |  4 +++
 ...riptsmenu.json => schema_scriptsmenu.json} |  0
 5 files changed, 40 insertions(+), 1 deletion(-)
 rename openpype/settings/entities/schemas/projects_schema/schemas/{schema_maya_scriptsmenu.json => schema_scriptsmenu.json} (100%)

diff --git a/openpype/hosts/nuke/startup/menu.py b/openpype/hosts/nuke/startup/menu.py
index 9ed43b2110..dee1d9d868 100644
--- a/openpype/hosts/nuke/startup/menu.py
+++ b/openpype/hosts/nuke/startup/menu.py
@@ -1,5 +1,7 @@
 import nuke
+import os
 
+import avalon.api
 from openpype.api import Logger
 from openpype.pipeline import install_host
 from openpype.hosts.nuke import api
@@ -9,6 +11,7 @@ from openpype.hosts.nuke.api.lib import (
     WorkfileSettings,
     dirmap_file_name_filter
 )
+from openpype.settings import get_project_settings
 
 log = Logger.get_logger(__name__)
 
@@ -28,3 +31,31 @@ nuke.addOnScriptLoad(WorkfileSettings().set_context_settings)
 nuke.addFilenameFilter(dirmap_file_name_filter)
 
 log.info('Automatic syncing of write file knob to script version')
+
+
+def add_scripts_menu():
+    try:
+        from scriptsmenu import launchfornuke
+    except ImportError:
+        log.warning(
+            "Skipping studio.menu install, because "
+            "'scriptsmenu' module seems unavailable."
+        )
+        return
+
+    # load configuration of custom menu
+    project_settings = get_project_settings(os.getenv("AVALON_PROJECT"))
+    config = project_settings["nuke"]["scriptsmenu"]["definition"]
+    _menu = project_settings["nuke"]["scriptsmenu"]["name"]
+
+    if not config:
+        log.warning("Skipping studio menu, no definition found.")
+        return
+
+    # run the launcher for Maya menu
+    studio_menu = launchfornuke.main(title=_menu.title())
+
+    # apply configuration
+    studio_menu.build_from_configuration(studio_menu, config)
+
+add_scripts_menu()
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 128d440732..a9d284873c 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -15,6 +15,10 @@
             "destination-path": []
         }
     },
+    "scriptsmenu": {
+        "name": "OpenPype Tools",
+        "definition": []
+    },
     "create": {
         "CreateWriteRender": {
             "fpath_template": "{work}/renders/nuke/{subset}/{subset}.{frame}.{ext}",
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json b/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
index cc70516c72..0c7943447b 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
@@ -49,7 +49,7 @@
         },
         {
             "type": "schema",
-            "name": "schema_maya_scriptsmenu"
+            "name": "schema_scriptsmenu"
         },
         {
             "type": "schema",
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json b/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
index bc572cbdc8..1ae4efd8ea 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
@@ -79,6 +79,10 @@
                 }
             ]
         },
+        {
+            "type": "schema",
+            "name": "schema_scriptsmenu"
+        },
         {
             "type": "dict",
             "collapsible": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_scriptsmenu.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_scriptsmenu.json
similarity index 100%
rename from openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_scriptsmenu.json
rename to openpype/settings/entities/schemas/projects_schema/schemas/schema_scriptsmenu.json

From 8a1f7c10061387b03674eb0e21faf05f0bf8fbd5 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 11 May 2022 17:12:54 +0200
Subject: [PATCH 0206/1227] flame: fix for single file use

---
 openpype/hosts/flame/api/lib.py | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index 03e3d117a3..933cfbe267 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -839,14 +839,13 @@ class MediaInfoFile(object):
         # ignore reminders as we dont need them
         collections = clique.assemble(files)[0]
 
-        # if no collection rise
+        # in case no collection found return None
+        # it is probably just single file
         if not collections:
-            raise IOError("_get_collection is failing on: {} {} {}".format(
-                feed_basename, feed_dir, feed_ext
-            ))
-        else:
-            # we expect only one collection
-            collection = collections[0]
+            return
+
+        # we expect only one collection
+        collection = collections[0]
 
         if collection.is_contiguous():
             # if no holes then return collection

From f7d4cbecfe36826865cb3aba3e33da10fd0aeb71 Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Mon, 2 May 2022 17:17:29 +0200
Subject: [PATCH 0207/1227] add the scriptsmenu schema to nuke

---
 .../projects_schema/schema_project_nuke.json  |  4 ++++
 .../schemas/schema_nuke_scriptsmenu.json      | 22 +++++++++++++++++++
 2 files changed, 26 insertions(+)
 create mode 100644 openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsmenu.json

diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json b/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
index 1ae4efd8ea..1fc925557b 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
@@ -290,6 +290,10 @@
                 }
             ]
         },
+        {
+            "type": "schema",
+            "name": "schema_nuke_scriptsmenu"
+        },
         {
             "type": "schema",
             "name": "schema_nuke_publish",
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsmenu.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsmenu.json
new file mode 100644
index 0000000000..e841d6ba77
--- /dev/null
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsmenu.json
@@ -0,0 +1,22 @@
+{
+  "type": "dict",
+  "collapsible": true,
+  "key": "scriptsmenu",
+  "label": "Scripts Menu Definition",
+  "children": [
+    {
+      "type": "text",
+      "key": "name",
+      "label": "Menu Name"
+    },
+    {
+      "type": "splitter"
+    },
+    {
+      "type": "raw-json",
+      "key": "definition",
+      "label": "Menu definition",
+      "is_list": true
+    }
+  ]
+}
\ No newline at end of file

From eb5605a3ade0e4f59b8ffb21a7914c446b75372d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 11 May 2022 17:24:11 +0200
Subject: [PATCH 0208/1227] fix updated asset skipped because of wrong name

---
 openpype/modules/kitsu/utils/sync_service.py  |  9 ++++---
 .../modules/kitsu/utils/update_op_with_zou.py | 24 ++++++++++++-------
 2 files changed, 20 insertions(+), 13 deletions(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 46d3422727..6c003942f8 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -149,7 +149,6 @@ class Listener:
 
     def _update_asset(self, data):
         """Update asset into OP DB."""
-        # TODO check if asset doesn't exist, create it (case where name wasn't valid)
         set_op_project(self.dbcon, data["project_id"])
         project_doc = self.dbcon.find_one({"type": "project"})
 
@@ -167,7 +166,7 @@ class Listener:
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            self.dbcon[asset], zou_ids_and_asset_docs
+            self.dbcon, project_doc, [asset], zou_ids_and_asset_docs
         )[0]
         self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
@@ -214,7 +213,7 @@ class Listener:
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            self.dbcon, [episode], zou_ids_and_asset_docs
+            self.dbcon, project_doc, [episode], zou_ids_and_asset_docs
         )[0]
         self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
@@ -262,7 +261,7 @@ class Listener:
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            self.dbcon, [sequence], zou_ids_and_asset_docs
+            self.dbcon, project_doc, [sequence], zou_ids_and_asset_docs
         )[0]
         self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
@@ -310,7 +309,7 @@ class Listener:
 
         # Update
         asset_doc_id, asset_update = update_op_assets(
-            self.dbcon, [shot], zou_ids_and_asset_docs
+            self.dbcon, project_doc, [shot], zou_ids_and_asset_docs
         )[0]
         self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index fbc23cf52e..fa0bee8365 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -38,7 +38,7 @@ def set_op_project(dbcon: AvalonMongoDB, project_id: str):
     """Set project context.
 
     Args:
-        dbcon (AvalonMongoDB): Connection to DB.
+        dbcon (AvalonMongoDB): Connection to DB
         project_id (str): Project zou ID
     """
     project = gazu.project.get_project(project_id)
@@ -47,7 +47,8 @@ def set_op_project(dbcon: AvalonMongoDB, project_id: str):
 
 
 def update_op_assets(
-    project_col: Collection,
+    dbcon: AvalonMongoDB,
+    project_doc: dict,
     entities_list: List[dict],
     asset_doc_ids: Dict[str, dict],
 ) -> List[Dict[str, dict]]:
@@ -55,19 +56,27 @@ def update_op_assets(
     Set 'data' and 'parent' fields.
 
     Args:
-        project_col (Collection): Mongo project collection to sync
+        dbcon (AvalonMongoDB): Connection to DB
         entities_list (List[dict]): List of zou entities to update
         asset_doc_ids (Dict[str, dict]): Dicts of [{zou_id: asset_doc}, ...]
 
     Returns:
         List[Dict[str, dict]]: List of (doc_id, update_dict) tuples
     """
-    project_name = project_col.name
+    project_name = project_doc["name"]
 
     assets_with_update = []
     for item in entities_list:
+        # Check asset exists
+        item_doc = asset_doc_ids.get(item["id"])
+        if not item_doc:  # Create asset
+            op_asset = create_op_asset(item)
+            insert_result = dbcon.insert_one(op_asset)
+            item_doc = dbcon.find_one(
+                {"type": "asset", "_id": insert_result.inserted_id}
+            )
+
         # Update asset
-        item_doc = asset_doc_ids[item["id"]]
         item_data = deepcopy(item_doc["data"])
         item_data.update(item.get("data") or {})
         item_data["zou"] = item
@@ -86,7 +95,6 @@ def update_op_assets(
         item_data["frameEnd"] = int(frame_out)
         # Fps, fallback to project's value when entity fps is deleted
         if not item_data.get("fps") and item_doc["data"].get("fps"):
-            project_doc = project_col.find_one({"type": "project"})
             item_data["fps"] = project_doc["data"]["fps"]
 
         # Tasks
@@ -139,7 +147,7 @@ def update_op_assets(
         )
         if visual_parent_doc_id is None:
             # Find root folder doc
-            root_folder_doc = project_col.find_one(
+            root_folder_doc = dbcon.find_one(
                 {
                     "type": "asset",
                     "name": entity_parent_folders[-1],
@@ -358,7 +366,7 @@ def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
         [
             UpdateOne({"_id": id}, update)
             for id, update in update_op_assets(
-                dbcon, all_entities, zou_ids_and_asset_docs
+                dbcon, project_doc, all_entities, zou_ids_and_asset_docs
             )
         ]
     )

From c90a949076a1c8d2237fcc6ec118549344a50343 Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Tue, 3 May 2022 12:41:37 +0200
Subject: [PATCH 0209/1227] call the launchfornuke module from the nuke menu.py
 to generate custom menu

---
 openpype/hosts/nuke/startup/menu.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/nuke/startup/menu.py b/openpype/hosts/nuke/startup/menu.py
index dee1d9d868..3a0bfdb28f 100644
--- a/openpype/hosts/nuke/startup/menu.py
+++ b/openpype/hosts/nuke/startup/menu.py
@@ -58,4 +58,5 @@ def add_scripts_menu():
     # apply configuration
     studio_menu.build_from_configuration(studio_menu, config)
 
+
 add_scripts_menu()

From a18c4d3d16e5454f86cd1b4f539c6e3031bd7c9c Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Tue, 3 May 2022 17:27:32 +0200
Subject: [PATCH 0210/1227] add a function in the nuke menu.py module to also
 add gizmos

---
 openpype/hosts/nuke/startup/menu.py | 58 +++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/openpype/hosts/nuke/startup/menu.py b/openpype/hosts/nuke/startup/menu.py
index 3a0bfdb28f..bb81ee7fac 100644
--- a/openpype/hosts/nuke/startup/menu.py
+++ b/openpype/hosts/nuke/startup/menu.py
@@ -1,5 +1,6 @@
 import nuke
 import os
+import json
 
 import avalon.api
 from openpype.api import Logger
@@ -59,4 +60,61 @@ def add_scripts_menu():
     studio_menu.build_from_configuration(studio_menu, config)
 
 
+def add_gizmos():
+    """ Build a custom gizmo menu from a yaml description file.
+    """
+    quad_plugin_path = os.environ.get("QUAD_PLUGIN_PATH")
+    gizmos_folder = os.path.join(quad_plugin_path, 'nuke/gizmos')
+    icons_folder = os.path.join(quad_plugin_path, 'nuke/icons')
+    json_file = os.path.join(quad_plugin_path, 'nuke/toolbar.json')
+
+    if os.path.isdir(gizmos_folder):
+        for p in os.listdir(gizmos_folder):
+            if os.path.isdir(os.path.join(gizmos_folder, p)):
+                nuke.pluginAddPath(os.path.join(gizmos_folder, p))
+        nuke.pluginAddPath(gizmos_folder)
+
+    with open(json_file, 'rb') as fd:
+        try:
+            data = json.loads(fd.read())
+        except Exception as e:
+            print(f"Problem occurs when reading toolbar file: {e}")
+            return
+
+        if data is None or not isinstance(data, list):
+            # return early if the json file is empty or not well structured
+            return
+
+        bar = nuke.menu("Nodes")
+        menu = bar.addMenu(
+            "FixStudio",
+            icon=os.path.join(icons_folder, 'fixstudio.png')
+        )
+
+        # populate the menu
+        for entry in data:
+            # make fail if the name or command key doesn't exists
+            name = entry['name']
+
+            command = entry.get('command', "")
+
+            if command.find('{pipe_path}') > -1:
+                command = command.format(pipe_path=os.environ['QUAD_PLUGIN_PATH'])
+
+            hotkey = entry.get('hotkey', "")
+            icon = entry.get('icon', "")
+
+            parent_name = os.path.dirname(name)
+
+            if 'separator' in name:
+                current = menu.findItem(parent_name)
+                if current:
+                    current.addSeparator()
+            else:
+                menu.addCommand(
+                    name, command=command, shortcut=hotkey, icon=icon,
+                )
+
+
+add_gizmos()
 add_scripts_menu()

From f479dd8635b95c1463bab44d79c85d19fc72095e Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Tue, 3 May 2022 17:54:30 +0200
Subject: [PATCH 0211/1227] Revert "add a function in the nuke menu.py module
 to also add gizmos"

This reverts commit 2f3bafb2fb8cbf247c354a8904acbc78ae081731.
---
 openpype/hosts/nuke/startup/menu.py | 58 -----------------------------
 1 file changed, 58 deletions(-)

diff --git a/openpype/hosts/nuke/startup/menu.py b/openpype/hosts/nuke/startup/menu.py
index bb81ee7fac..3a0bfdb28f 100644
--- a/openpype/hosts/nuke/startup/menu.py
+++ b/openpype/hosts/nuke/startup/menu.py
@@ -1,6 +1,5 @@
 import nuke
 import os
-import json
 
 import avalon.api
 from openpype.api import Logger
@@ -60,61 +59,4 @@ def add_scripts_menu():
     studio_menu.build_from_configuration(studio_menu, config)
 
 
-def add_gizmos():
-    """ Build a custom gizmo menu from a yaml description file.
-    """
-    quad_plugin_path = os.environ.get("QUAD_PLUGIN_PATH")
-    gizmos_folder = os.path.join(quad_plugin_path, 'nuke/gizmos')
-    icons_folder = os.path.join(quad_plugin_path, 'nuke/icons')
-    json_file = os.path.join(quad_plugin_path, 'nuke/toolbar.json')
-
-    if os.path.isdir(gizmos_folder):
-        for p in os.listdir(gizmos_folder):
-            if os.path.isdir(os.path.join(gizmos_folder, p)):
-                nuke.pluginAddPath(os.path.join(gizmos_folder, p))
-        nuke.pluginAddPath(gizmos_folder)
-
-    with open(json_file, 'rb') as fd:
-        try:
-            data = json.loads(fd.read())
-        except Exception as e:
-            print(f"Problem occurs when reading toolbar file: {e}")
-            return
-
-        if data is None or not isinstance(data, list):
-            # return early if the json file is empty or not well structured
-            return
-
-        bar = nuke.menu("Nodes")
-        menu = bar.addMenu(
-            "FixStudio",
-            icon=os.path.join(icons_folder, 'fixstudio.png')
-        )
-
-        # populate the menu
-        for entry in data:
-            # make fail if the name or command key doesn't exists
-            name = entry['name']
-
-            command = entry.get('command', "")
-
-            if command.find('{pipe_path}') > -1:
-                command = command.format(pipe_path=os.environ['QUAD_PLUGIN_PATH'])
-
-            hotkey = entry.get('hotkey', "")
-            icon = entry.get('icon', "")
-
-            parent_name = os.path.dirname(name)
-
-            if 'separator' in name:
-                current = menu.findItem(parent_name)
-                if current:
-                    current.addSeparator()
-            else:
-                menu.addCommand(
-                    name, command=command, shortcut=hotkey, icon=icon,
-                )
-
-
-add_gizmos()
 add_scripts_menu()

From 4e694a3f36f740fe9b5488cf75ba421e4b520d97 Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Mon, 9 May 2022 11:27:51 +0200
Subject: [PATCH 0212/1227] changes from comments

---
 .../entities/schemas/projects_schema/schema_project_nuke.json | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json b/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
index 1fc925557b..1ae4efd8ea 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
@@ -290,10 +290,6 @@
                 }
             ]
         },
-        {
-            "type": "schema",
-            "name": "schema_nuke_scriptsmenu"
-        },
         {
             "type": "schema",
             "name": "schema_nuke_publish",

From 2eea2522be0ecce65c8fc5876a628b15169f3189 Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Mon, 9 May 2022 11:31:05 +0200
Subject: [PATCH 0213/1227] delete schema_nuke_scriptsmenu.json since we use a
 schema_scriptsmenu.json for both maya and nuke

---
 .../schemas/schema_nuke_scriptsmenu.json      | 22 -------------------
 1 file changed, 22 deletions(-)
 delete mode 100644 openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsmenu.json

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsmenu.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsmenu.json
deleted file mode 100644
index e841d6ba77..0000000000
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsmenu.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-  "type": "dict",
-  "collapsible": true,
-  "key": "scriptsmenu",
-  "label": "Scripts Menu Definition",
-  "children": [
-    {
-      "type": "text",
-      "key": "name",
-      "label": "Menu Name"
-    },
-    {
-      "type": "splitter"
-    },
-    {
-      "type": "raw-json",
-      "key": "definition",
-      "label": "Menu definition",
-      "is_list": true
-    }
-  ]
-}
\ No newline at end of file

From f081fe3521158cba9425f86a866fd50fc8106f6f Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Mon, 9 May 2022 11:58:28 +0200
Subject: [PATCH 0214/1227] add nuke doc for custom menu

---
 website/docs/admin_hosts_nuke.md               |  14 ++++++++++++++
 website/docs/assets/nuke-admin_scriptsmenu.png | Bin 0 -> 21712 bytes
 website/sidebars.js                            |   1 +
 3 files changed, 15 insertions(+)
 create mode 100644 website/docs/admin_hosts_nuke.md
 create mode 100644 website/docs/assets/nuke-admin_scriptsmenu.png

diff --git a/website/docs/admin_hosts_nuke.md b/website/docs/admin_hosts_nuke.md
new file mode 100644
index 0000000000..46f596a2dc
--- /dev/null
+++ b/website/docs/admin_hosts_nuke.md
@@ -0,0 +1,14 @@
+---
+id: admin_hosts_nuke
+title: Nuke
+sidebar_label: Nuke
+---
+
+## Custom Menu
+You can add your custom tools menu into Nuke by extending definitions in **Nuke -> Scripts Menu Definition**.
+![Custom menu definition](assets/nuke-admin_scriptsmenu.png)
+
+:::note Work in progress
+This is still work in progress. Menu definition will be handled more friendly with widgets and not
+raw json.
+:::
diff --git a/website/docs/assets/nuke-admin_scriptsmenu.png b/website/docs/assets/nuke-admin_scriptsmenu.png
new file mode 100644
index 0000000000000000000000000000000000000000..cad2a4411d058a35995863a57bdbcc4cd2793457
GIT binary patch
literal 21712
zcmb@u2UJsCw=T?UL#cvNl%|m;(xq3C(3^CmcaTo#grYCf1q6i9kuFAh?;^c7>5xbZ
zz4y@W;=SjbanHHm{m1z4J&ZVZvJHE$z1CcFKJ%H+B=n843?bfQJRBSxLOEHe8V=5l
z1{|EfRPWvZXO5WvUI&MpF0bV@?%usSJ*V;qe0=08rQ@pZXzA)<0<*xea&WY_U~@5p
zSy(u@SUb9I-)s`Y!Fhrs2bIw9Oxc+AFjil};_fV)^U94x^Q}5OpQW05jnDS=?w1@?
z_(H7{4ok>QGNw%JA_C_*vN!d|%Uad%L;ilxYEd!xTJLM@7Wq^zoL*^|XW_V`nQ~Zy
zxsCk9@A9eFz**z6C=*j(i{Q2(@dL7CC>R(H-yagy*36-e<lzC>9XC#JhI7%?rUEmb
zB0-G{KI!Y-=Ld)P1^+#VI|2^(@isAisTZBkj;9q`q4bp$1IfbEBO?tR-Otq-QGV0q
zA85c0ar8yCmwav_T0&_a`SN<-0Yi{zT{n9xEBhHbZ|sLudmbJpZ?{^$rtc=}G?+MY
z>Yeq0&DjHi7IIlDoISI#UC&i)>@tL$uI8m;uvzoc(o(?}r7lJa3bw-&LzkB=t_HQe
zy(0_^78g^@;C9t4SRwQqJ>=bcM3Ld)5#iy4_lOD$G$$rjC(GJ|47Ba^3CwDtO0iuJ
z@Bg8D3EA6;Hj9W*B8kpuxp_`ZEuf*VA;j+W=?!zaa|F2B4#mm~hc_&m!XBGy&ox<c
zY?ccR<a4^)l@Glol^y(ye>yQSbu`*eO-@Fr(5kDc8ER?CK@DkXMc6%tvy(G3f7R$m
z#>Psb`~Jeg`BU_J+zk)=%+=UPU%4u`{`^;GXEDh$$Q83mNQj95l)kv^<+uwBX7}#h
z{{B8msMO<%pb%YM-Q#WXR(4HW9z+?iP@L*oc2N$sd<_H3!B^1i?csF6*yW|Au0{*9
zzyJLCSv+XWU(>5!P*U=4xxYa=z(jwK67s!3Q#MD<(NP5#SMJS@Q$Vv*&H8Py4#;KF
zWvW7`goLWA#z!4iNTz!Zchgs90fC=gT^T!ep>=gB1!mldLT;(=I+PWYc%IS=aB>t4
z8bU&&=(-kmABNQ;`T4+*R&W_v_@0{%Ssy8_S_uXSKL+P0ZG<Xx_iaTuNWllYz-sXP
z|6PYRXd5Hp5hb|bpQ-ozgy3lWqV-=LP)mGwDYx1hzZKfkt~7)1{ro(VKbmB;;Bymv
zn80)XZ#=A(?&}h=ilvKtYy4<xO8=?+)y`2IM&HnwF=z8bmffY{;%F6qbm@NS(>J<8
z2Zk=q`Po@gR`!j3!RvgDNtF4okJ%=Eje%AJeEe13-qkPSy8ogk2E!!y@!=B{J!x>_
z%X#;$DGRfeCvifj#QUPLu^#hKJ`yr=^0K99)j2Lz5`Ffn>TK3$&(tw%uxa}d7;IlM
zAfWaDD;ca#7Umt=>i6q}zNWXLz`%>=(9_IJz57cjTY-JQGLdPC=UJqYW209}R235m
z8ChJel{wKLOW*}(itl*(1++?VyR;MF;)b%trKYBaek<J*L9~$IZGL<$%#L6})J4jL
zi2DjH??jh(hP*K{qJx-HN@Lb)w|_o0W#;1x3W<p&J@r9tiQ;OojGj1$+651(&WX@A
z6&JUfbH~NU(+N18C_4CQXjCJSuEzWiz~r>^B<xdBnuc_m^W3?GRiR9WLLV`ehCGFY
zMMYVxSIed%M{OWNdK&uL+UPfEW;bU>2r;ooP>Z5cO<<3O05!W_jby>4+kjte=&c(P
zPH*1V)lmhvJcX3#{1~;yHNgkgSjcgcn*ZAumgyq(;<87J4trsH-A2dM34CrbUPBzh
z{-Yj`LcXczxxieXKvE0CLlhZJLrf@xLc+oo22%RVHr`~7B`89nb0*D~mwwZJQ*y1n
z*fRpluY6$9{<QOb9)GUElCvpslZ2Ot54<8C^KuLD4Ens2RMnG#nwVr99nG7x_}p?o
z-y&3ER4;fvx4gW->J}rPTHhdAz~WR*4T+K6c=k&Y+awCCz^MdSL0FhP`?@6_1iN|M
z;ueOTAW;pymz9*H2Ydw8<0Q3_VPD^dT%~mC$B)fTRi3!UCdH$E{}yqcKe@-x5DI;b
z%xP=0C@9!`&>k^r%}ZnBCSG+N7}(pvelpMsct2;j5xzEsL2}Z9vy{3*75@Dst@{u#
zS3k8vsKB}Zu0wr~{TnSq7vA=3ryxn!|F7Z_JKRt5rxVAKl$-tjD`F5eaDq~l3&zeL
zFaNiU1aXnF`q$Hk_Z*W2*;rX;rl;$$K5mA7D2!6_)buplx)ZRWD5i&UCq9>739en(
z4^Gt*ImGCn?tS%Jx3S{;2QMR)BjW?@3+%TWj<*tDTGftIOe=hZoLv^+gRd8Uw(!F%
zOwQZ3;Ek83nV^u5%cWZ<5BsQqU@gIW93sp7u)QNn$jR8>$|`R(vyh!8%CTb!#>O%&
zdOqm;Od3jt_~O1=+j=w~Oj|FL@l8EnsJ4j9qPrDDj4~;PN`mcvVF#th$@hi1g_xP&
zhrF}4rq5hlY%L!AQ(79<Go=REJKQD53#6f0>#?_fw=wZC|M`Q>w)yWa%b~I?Zr*<`
z>lRGSU@m(R(q>oKjbrk^aDEbYejQIXB3?WX`uzC`h!kiyhh)J5_~1_%%pKbydVEkV
zi(GyB<PS`s<XIMn$7jUv!9mZH&XV@_+!8bCz>l{`RV|ik=3`3zT*<_3vg_*3yMxVn
z9{bjFq+oUrcli<(wI@uPs_x?8I5^!DY?6RDCkQ@s_$QuzuM#pbne#okPeL+eRwIEP
zZ7BYKg##2<f4hGh1*ibLz*dWXmI+`6*iM13>%zjme|i2uPj@;cmAch*cVOB>Mmn$q
zD&<r&14jSplOn(dkH}~rJYv6pH!Ms+5n9NurcLqA=e)D1aq3C*L=+wWm=e3X+c!1!
zmk-?z;~Pdt`9B5+`c#=HAPU!yrgI+*9nsYFN!r-h#CMtZ_eX*~*Vu?UJS5!Oa=6Ax
zDzz5%;lHKEClj5y>&nYTgoGe0+~?<~Yjc+^-)(J(Y2|q-35dl#9p8H8<mCw?Iz+t}
zPipo@<MqIN21264!(B9&Y9xb46dBd6Wp}=*J`)xa($$^LR<r8y1@p^a{a0i9>-i^%
zf@acmRy6eu4QJL{3kxG=UQtYo18HnytF@*JrU?oc$J6HAw{M+vd<rpFp@%|)h=_N@
zo&LOWR$Z-L<a(V^+@W>o7C{;+ih!$HlhKg%FYMyuD=fmsx$f=esVq~A#gIQDSzBLU
zU_?a8g%k;Cr+Twy)k>>sXh=i7P6LJA&*h<Aa-qtRkuoF06{)p)j7ooCg7FP;@mgSi
zIjX2+ykU;5(bCY+Ez~ID=i%i&^@QKM<>TQ|m6Rk@sh>5L!p1sTw*1Oh(rkF*R^=O3
z@`@Ll?>e~8FD`D}yqJ7V>~WgW@@~_<doddtWWp+ZyuaTy@S?Zx`CS6)tu021ySL0b
z+N;XTF%%C^vEBxz12=$`V~QHnGiz&wI5~@}a+U|uw@Xr5R-ZNwtrH5?obEb53lEn+
zGt5s-ojqCPVqjRZu!w^$F3mMBz?hV3Lrp?@mIMR^t=TMnbbiEvaNsf&#p?ELv}tS7
zkz3VO@fJy2M@Q)ryP8!%*@uu}74x;a18D2=ZpgPR$=Tn(6`{1WTenZG6cl<0y)Uxm
z_-m?V+2GG0IciJm%Y6&ZkAk|{BdG+amEGJ5s;UsW1*$BX7%G))wRf_zUt?n*AbRHZ
zPem>RRm#5p`Jp@>_nDHz#f>df4f0*cNL^doNXsyqhfl)V%4*U}4-S9p6{xZHkcx_}
zlH!pPBRj%_k!kz<^sx#te|~uRwl8o~{9pcxq|%VrM2|nm!^g*lQ0?vS!&#U2yz9wE
zz95V!A3fqTg)Y)D5Rh;Y1c%%rZ;Dh_j$~uA_wy5jl*nd{-B(pmSiigop2)FL8h9Wg
zDl+p$UK7z~ejhUYjW@mw-*561+1T?6nkr=A>3Nq#RV9{~GH5R0=KY`y@&2zmM_O81
zB-EsxCJDK@mT|*2V!`>fxqK`vKafb|ntnx%>%mGiz$QJ!;(@nt85twF(>>;3)ldU!
zA~UgypG!_5AuZq^J5gY*s{s^*yp@DYYf}h>`*D#g1mIhJt2=u_f$}*U!q!hRX__`1
zZ0*;bRrPGAfs^;vrzZ`CvyOYL4y1JL@9mkROSvSRoQ!p>i<9*&3&$oV%3YQXvzj^C
zy$DD~$5^t}@~f)y0s`onJ*%6Ii#J9LS&8o5OX5DYtm!@MO{_=pLH|o!_c_9ZbD2rs
zzI_`C{kTTxoi((wv`X^u;VURFZ`gaBtDisTqDf31SL9Yy%zkefF2yU6UEJK%G*lh+
zb#rqglzwn}c9tr9y!`wTd$0mQjcm?`4=rpjq8^h`QBavN6`KV^p#XR^H~*E9A;F@F
zTZix-nHsj_q=Y~uFM>}`{|H^rfZdaYpv=se#(+DJVH@G`9|j{R%L`<eSX1-bkP2%_
z!^aMagE12ciD+yT-LHSpzx4!X`scx~zsmekp6~u0`=6Y82j9ZQERm5vBya18O5wK1
zOrF8|;nwKKr+oSI=ZPTfz;kYL9yK;SIQS(gertW5*B-k#IQS&COG7<Nz*op4A>Bw#
z?S|1${zPW}qMsup_O9o$K_+VIBXKNCC(dTKZd^Jx(Ust7g?!7&si>&Xq$kz-qU~;!
zI%NH$pkRcGz|HLt^XsLcmk;e#ZgNZyTT+4|BSc-p6{<N}Gh7O*EG{W|?yz__<4r<*
z{LnOc3CLMiSKm6oyc8A9^{V~={NUgeurtF1A;sHtsB@FHw*D3sHE_DW3^Faamm$3o
zb7_-v8ik<qyr&gYhrPDb)oWK*=&zM(;PQ=&6XdWv0mm4!6j3kkGZ<V!F43Cl{>F)g
zN>c|&A;$meSr#Mgcgd}o>Sq(TD`TCz2W96T`buEQ?Bw*>6AmY$!oVTVY;kJqP9j6o
z@UYyLz2EkiZ7EGfL}tS6;D+P?Xg|5b<bd-61PB1>y5(Q&;rA0A>2!`tJ$_7T$Nd;N
zFm7&jytC*C@;?*8ez$ANqFPJGFz*$uJ$PG8Hh+zf{{J6FEyS&Af7D}aK3%6mL1HQ3
z1~@o+PaXc(gTc{xP>594Bt=g862XBn_%Gv52{A=*Tp|9KdDs8tNn}sIE$@5EAUW9(
zVj@~)#@tG+-RW%^5ab-=QmJVi8r-HXFPg?j`Q44Wm-aHVekrH+Z<@Jzpq!CqW&0VD
zG79o9LYPHZd7i&>H8UFlaouP)SAS*3ocnp)_xkg))6+mvtpz86Sf<&<r6tr<uAQAV
zY3RqZBf5>67GXzWcqKi5)hiY^n6vY9HZ~@Jr=TUWzx6;q@*Zi=xp0ThvFKZ8asByg
zw_sg*(nAuS`_Z}uU40zZw%Ug?aZ$@53EvtQ?f~}_fkGMD&HPzk9zA}{p)DzC<|h$d
z6g57<m34qE%*-6#a?9>l28ckg=Js-b>N2cG#IWd0T)gO8W5$P&*OCD=G}IH-8Kryr
zbV^{73oHLRBf-0OFGiNS*HM$jLRD1`t@IHh3}Jcx+|ka?RDqg4#(9Bsb`hqO=e~_X
zlS+3~l~)Q13x>4KmzRH1b$*uoI9a$NwF)gJ%2f4)p82cfYzfHCh*}<{iv)En_azIT
zEp~0R=VG$6Z^28d3jn0O44`4D@QNUe=mU>J(BdSZ&!KXR#ol2@C_weu`QL3=`(K&V
zvKv@pR%2pHS5`tkfBu=<ZYeIFJ~meAi%azGcT$ZDZKqgVY^pCK3pXp5^Y1FO{n)B2
zreFB?8u*o%7;ZRxx07T@N-9TdHa<Qc?X&L*35&#AcA}KQ#myK5^TcA&4b2*2ei*8+
zpMqo=pb<*3<W2-nhoMMwbNUSZ7|c!Z(s65pM)(N4FIA!^J=<MqukEt<PNZpL6O>ul
z*zp(f?_dz-em*WfC9J3j`~2rmb@c>zfj3jSZ4AjN;zn7cHjb%@+$;|Ch@NMe*^9TV
z@?C7Eb~DQu<a5G8fRTBL_?cw5-JO3@g1(wIDbb;(<5$ZXN<$WMQ65ZJZL_mH4-bvx
zNwhvLIt!QY9;LDA(TX@Ee4UZ1!E(3<+uqo)vA4JCc?OXT#ytU<?zif1u7H!tcq0q#
zS5~I6>1&n*Zq`;u_VZ?4W@Di$q+}W9HCqSLdj)7mWO{E`UzOeb@^Wmtc0#iHeM*6u
zS*1%W?L$I)`|jG>pv`Fy{;JA^p4eDYutTD9b8Lm(suYucF2M@Te*)X#dtAIvDE|*@
z_0p>MNoH!Ddr1@4cf`6}+!39cKq+o&{slQ>F_4B9nVH?k?=KxE(V?+9EP@{;E7Bus
zbSv4|pKCL(+1RX`7Zw^A7(9*`GtUlcXM}u5+J+qNQHrv#zgRCH4GduqXl%^r>X=rC
zl!$v2CYexH&h)edbSx<+xjtyQkLYoR)jG}7^Ya^J4Y|9!hqcZ3Oi)k<nNSj$%@$;3
zWfy45K{q!y<E<n@z7;ey{HTA;;uaPWK|UScyJS-#U9>&C>PqOJ5@X`!SxvE+&c?>Z
zzj7GMIJ-CxX~_Hw_^t`dCmiu*88^><wKKA4c6_)QEE5q%L-OD`X(+gdrbO1*fxx{F
z9ZUB~5G^J@^xkM4tzs~k>S~gaT&1a_k^cC2t$j#)tA_UY$%&_+fNUg<xM1%<M?DBf
zZdaF*8@3hF3m8VGf0zJP+@Eut*KFOoSr+i%*O12$-JqvUfuK!xEqTFBN)nwv&1mq+
zgfh}ghKqpYQG{I&?HvL@$iBaGBBq$5W&t1MG=*xw)J%1BitCaU^G4oPOtlBKfBiZq
zA@LW;t{8}pe9I#~5#Zmucd&P4cb(j^r$+WH+`+}I?piX*Xs%`VbufI|!bu8WR|ZP~
zfEUzMRmr}frnpk;X`FmRgD4F(y+m^h;T_4S7o*>J{Tfk!wFKYBz3pmb!$BVW@s?7e
zPnkZ(8>5)EIeVluKDxx}hIf~eF<O6u{GXV8_wEic0X6L-l3Z2WUJCtdH}t*P$4?So
zH{3C8+nX@-I%D<&nkZQ@_jfsgTd=o2%=FdQrXk}EWI^dO6W4nA{O)ccNvMSd*`~ZE
zOf6G?iv>}qoanQk(0URxytkI5iwq(pi~uGTHYMbXK<OtSv~}L-Jfstc0b0rdCU`gx
z#XN_XT&#SoF0+Cs>^(>H02+y!nqDT7mP16(4qoN^qEr0EAAE4OEmNFBG&?u<g=RPK
z0C#Vlqy5B(n?h~@A_m6wPul+Enw*pZ<fOKV2!at&gYr8&5QX~*8yUQ0zK(p=8UIk_
z;~V=B4z6ob1m_Nlm+G3A_-V8?1wS#CG#gnq^5LJzy8bfB-2WSac+C}Fvnqu6|6gRr
zxFPLkMz1-yvjBC5Z10>CE}RwI{KATJ1*|HfaO69+bIW_KL|OXy6}MVUt`GpL6D{Df
zE8=2CPe>=j8HjA+hD)!%G`Hu8WjD~%TQDZRo)dXDx7FHOSJK$fo&~A{0}QO!k&^SZ
zaE96>_dm}^$(cly^UB!j?cdcVKRKz1*j2z-4_l3SoCGKW@g&(Dj43VWe#tB>$RsJe
zZuy&n-RHNVsehm-6JuoU+16WvmSRUM#q{~bMbALrYYy>E(ENE&{MguBOR$Aynko9u
z?OPz%Ba|I*cmI25XYl;|*I%mzj)m-n_-Q)#$;lmf9=+t|zC1%;tq8eYtlJy~5GyBg
zOJ%9r@=S3woy_+pzPz9vg>N@8#npmb>>bbJROKqSb>cdY%|>%%TR6q`Y#l!nQyv;{
z-0#<0-h84W@NSUKa)Y_s*xEn93nV}cxfv!zlRSDvOHSUq1S{oML41i<NfS}c(U8kg
zCW?&t^yvrS2uQe82@ozUX9Og(UgK!@?WsI1WS^*&MQUUe-CJE<)a2=M1Oq=>q<?fY
zZeW>K*gX?OY$)_wU0q%3n<phz9IUJ{Jr+bnG3*U<<FjXqjIpCQ*om-ZBORafiITV%
z+N47%H7<01C(&1z%i<R(Cba+YEUEz>5D;MGbvWwfvV2sRPGRI39b)LSnq%a#Elmy9
zA7RVfP6$<$d-vAK_-9w|2FN5zhr<BWhQMI12gk=}yB#$8?8j;FZRVnHrncLcZcPDD
zZh*$a#O1xS#;o!1`Wfk4=>%ge*+sk$stt=gV6OFE^C#WiF3`or#hv|uIw)kWg&5s5
zcgAMFxjB-j<nG}y@{L#PCg%ZnM)Sac3M6`Cq9nlgY?B{-j$TgpKU_jQU{WTyN9g9{
z<m4PpE9hf>cC<-NWOe!X?aRwcXt~2|?f33(urmBSd?zO-olAQWRD71^<_UFd?Cj(_
zx0RLqktl--<4Ye%SV%~MTL%pjH}{WPhRk;(xhhFM_)#6xwQlP}&t%}!OmlN{QDR4w
z=>r@bFN}`6bPe(f;rH}LMn@0ZD2yIXOmY$Ik0m=+R#qN0RQ-kX2m2Db5VW_~J?)t6
z%>7dM$>7z`M)YKL^GMHZTidClf3gJBoadg@YsmL}&HK@6IUqg2Zp4CeOv1)S%Gp-k
zOL6q5Id=&|NeNefzcS;4$w`BijKV^cIX5UIL=w5_!OsFOrCwWE$sqr7{U+qCAB{kG
zNO=XG7AWW0T3b80xIBY6auhKr!~=FIN({@)%jUKiGSMCsq#}Mw&&j+qBtz%Ba5z56
z_#(dObI+1Oe7)r(etJg6vC(mm2aRcr-@1J}?#mZ?dPZ6Wg@s*Dt=YZP^VZgn2tyya
zC-;B6Ejv0XS@3RXJQEPq@6WWNxY&>I9~&JNJ>O}mnsq;`v=`Tnv%8oJ#<!)5^_*`F
zEzqmN+qiYnhygouygcI(|K~#Wys>W$^&(2rvC?PDyn%o~{QcXtC+SYW>GJ2NkOybP
zBqY1lqP<ui%7c!mbV_kQf@ymYxEdNR8hxAa1Kk0zj4j9-HxdXp=DhS0`jGl&(if+J
zE4r(;6$;hRd1K9;c;M}8=;vqr%2>m7acAzY5@%-ul3@7U^H{GMFDT#<|NLP#QJ_r_
zJ=-p`)YQ~$xI)39t|y%tz#?N}VpMl`^(yU@mE|kf#w6weuCDWG!-H@q5h(X7D@BO*
zl0?^ZPfvdVX)_d121Ap?{bI0_5Y13QhtBR^T`YFp6n<vpzVT`X@aSfbGo5de#KnI>
z!+Ji(GL`i)R8+X_W|_WxsbX89TcTqp=-jNBHCkKO6)H<lDkvy?JmDfI_tsT08-ZXV
z32lW`rkk{!vkTJe-TC=FKi`r=wD`oQQIXNs`WsW&;vUB>Txz0V(dCl4vu!pNmiy7l
zR+pNM_ivZ%Q}vP!N9CcNJ5tY%w;iqR%m=(&w~utDN(RKQ>bKeEVS?nlgd=95iLWy}
zw<fI|YnI|Yv<h^wQ?`VJguWg`V7bztdeG&*_43Mj!_3N2#DgfWsIW>C;k6wrI7Y#j
zmH4C9OEiJ)A;b3%9zB<nyB9&&fC_Xz=;X>seIF7w5RW}O>q~M&W@QCPXRX3zD+%6%
zxgH%F;xfY!1eplv_XiM*dV&coEM$j-g+6Lt*!}o=E+m1(!os3P&`Uj6an4B)N*^bG
zM*BWdIx9avzvkkoDJLhVltF72L$L__zq6~;Mx9>Z>$%0nm8~sh=t4}ai_3m3BH@Lw
zEcJo+MVctQw6v5p3j(63^EIO$AR4s(v7xoZ(7FE{nC)R`Ab!B#0g8+xT@RQh&p1Iv
zRr(Y4>c;g?J$!u2$ZxWF4u<K2^RTn`8*@^NxmxdI`r`RTFM%Tx7ji^x;L`mlLY9f3
zUqQRNx&}m#&u0W(rs6hd>liZSVwu47(=f*7S5~^8mRiKyvu)?y#V1Y{_ZK5cMG7^!
z&p!Ugoe0y*Fy+Cw8?=$5Jp5HYJI!a+8h_z9J#*UM*?d!xjD|Q+a%wqCMyaW(>06Wn
zU#5S$c7A?N>wmtRqktf?s{(#HUeTP==-;&fKjwon;HmSq7Nuz%lj5<ADwh{kXxw@|
zkXed70T;Uy@L_=B{Pv3&`5dIU?&j+1?pZUM!vIt|zBYM^d}#9xhgK_dy+64j94mny
z8xxth3F15@<?E7$)IpFs?ti!|faWx=bxpkyJu%c3*g;e4Q3dw*#NQnc?zSBfMY6|B
z+$3CD=GPDZ&BBn*;S}%XM2Q)$02c{j36OB)r2I|(67n{L>W+>!q7aGC&kTst!+Yb;
z!E^jy)O`F`UD8vsOPgSB;P(fK?b#w4*nXY<Lr{zwc{gT6od9a;|3o(YXX@c!e!9pR
z@U7iSRAjs={zhWP6tck(APOjy_m{SX+RXjh7;0fV&Hn2eargT|amELIKE{SFzV=g>
zG>_wKih}{%8}#QUF8Z^g`t;d?--&C5h2VJKh(~d|YwEp_kh#5to8lKLMI(eqI$)HA
zA-XvtM(*()%fbS6<$PnwJzPyDKU?V|6{e4SjHAFL8~=Q0o-4yduNQy4lCR-#{WLI^
z^-$eW_80-3c>USx4|AOA<5$m&y{l_lUv&AeVg2vs%zx0mt<tNan>4%tdH30FrYV<+
zHEl(--QQDQC&~@773D$X!~l8wg-LH-aH^=P8w`cN8tEr46`VP1|IuS|>&8)m%#Whd
z+C!V7FH5|Zo^zOucKzGqksV9U@E_{6FN=_p9dj->as&A>W2CAViAg9Hqr#iQ{7Ok)
z1MgkI0&qUmKdf#Zv{+Gd3!7zF6N>wZik##2cB824wDS3?5+mNS@a0PPTc-%cORG=0
zQf#|U_iMuxJQl~&^ADRCK31oM`36G2oOCa$r)RrY+D=rO*3f$^gQCvZ{GG~=bDVR>
z?Q-=gA<X_}xeYTC<ePKUe;~WAW41zp{qr$Kd+qFr!x}nFyRHvqH~M{|3mx7BqPX^a
zZ1SgN>12%F{lc&Mve`{h8#2*7{N(M5!81Xh$UPrhlt*GayW}xO8@>&Um*Ba7^ZA`z
zzV#HVdODJt4zF<wO^|Iy>##f1&AFY=qPbCLq9@x!)TqE{^CA_|!*@1+3RHbP9*exl
z-Fu~q6+RPQV?XzVM?T86SGB6Y(gTxNTqix2Duh;>_<ZHdNabF<K^@o^c=&cbQj3P=
zF!jDQJI5)5_UzYQ&#S6-pEkNI%S>8DfeZhRVH9e5@;i;Yf)ice*$(P#yGW-drlZA$
z8vt%^r_qHwK^a)}QHN*sp`C1Fd6&NhEA=1K$9f7eig>7>t1ooQ-oSlIQt^=gesu0z
zwqlBd*@D=n@=I4<5?;(`DMO)z!<KX7y#X|}`>`xh(>OjMn-n25``w#KLA<jSqZP<l
zetA+m5k$>A&E=kZ-4BfAjSt3M$fC7FZ#@=Z@dVEPZC3$@YlZ#p5j?FCpBPiu2CS%l
zTWC{UI(3)kmaPBUMut9xaFcNPv(E1oNK(g!g4#Q0qJq4~;_vkQO*rSBhPfz&BHgF}
zb-Vf2$pG)f6hNbYY7Z!8gY!E@=q?7Wr7&JDatd-;J|7XlltMPBr9>--^MwM{NJ#Ec
zZ?tYv%;F9kPOgzJ$UzI|w(R88<r+L-IB=5eDk8Yq??<<YURSay%ubjrKY7@-5!(3-
zl~+^UcszD(`C&~fweXAlwH^4v#0z{@w}9_<+7iFQA1Fzy@qaHB7o3trj*N=QU6$Z?
ztd0s<j7oW!JiPD}@<vf!JvWIs#S7>Mta}Fwjc@kCrC^^q_o$^t()OR?Kvl;d;s&Yb
z*x&Q%F6<8z6$R1epHhI<fQEOIL0HA`QW{L1zT@X~)1Nc@i{VB;bZy?kjF)p~hHIq;
zL|*Dhg6&`Z+QrDQ^4%;PQ{`z$4+i^xl9jZKTJTV!;a9%@NMZ_!Peki#)8Jc^&9vYu
zKi@Z>1|jcuaRSIH6!7n28I#Ym9%$d=S^uklJk3u=;Gtt*J)z|FK4>STx&wa#ZpSAv
z!<le$qfxqmc0=_)-M+<mZ)fKXOI(2HHCqfgT}qyzp&`fm-GK-yexjpS;3UxHm<$4p
z#R@;OpHT!mYW#jHVL*OvWxE9A(f@Y2wY4?U>1pC4=70N5&Q&3|w{PDP_oj*d6OfAU
z?U@jjZZ}@I7YBo{7{B<JY%&-}Efg{|M(6)2imt+Lk{dGbBv?{Xa<OH9D1$UJHTA=u
zS_PS~*Ayy*(eZ})a+&=4D7;-i(#}OsPhWpJrbjHk*C~2DV`c`3SxUA0`~-lN$}KD`
z1aP^cA}-|h>({+aV;6%{Q@YyP+Io7n+=<{?jk~Akb=$S!zNyjCC63!-(;dc^XPtlH
z7_a=icqpk03Q;aD>RuLsKb1KhQ6h=@wA9r4hK7dv`aZ^2eh}SCyGewR-|6oWm2@Gu
zZnQsTI)@Gb)k;cAYWWANdFj!z^!A(fNb&PG1zL!>xT?xZOG``AXei`u(`8u)oxh@e
zblY@2JA^b8TEu2xV`bIB*;|K16%-ZW6BGOUT>50Z0l-TYu#5K}R<F%^Tva(|>9c#d
zxy@EPn|XSkWJQU#FYovCbdUR%YK`aXHDI&U^HfexPX&d9d`_B!!IOir#F3Fz@bXUe
z_e)Fxp2A70+99p+8el;+Uc=ni9B)orX=%l4A=x?y_$djx-8HSOmg|sO6_u6!DO~%5
z8Iq>(U9?pn_GsD>Xc|!V)0Ot9^3V{6G|&Ce2TU08663R@bbg1Km9_cD<mB<`>He65
zcLB|x<Km>C-T{UMTIr(jvAvl9F9T@y_`15fy2m!k9u#RbH2e%v(>*A|8q>BbK8N0c
zo)^rlvWl|$=jZ!)fe=nkP}p6jSZumDn(jfcotgB+4-S5wYq^QHx4+%6joJkG_}vI&
z0E$z{#MRxsQabB7E9(!i;7BCZ1PzE}+HxD!dV9**iRgKsmWsUW?AE?nB|8pUGI17B
z(Ns2b|LwBUQir+=K1f*DCzyu|6Xe6I&*|w_qX9$4GYxPLI;4}kd*k-yS)luCZEZwY
zw|t`F7%KNie*RNPK=WWjW3MI(m1~~$AxkEz-_Pl2jLz>#W_`T~M2-33GnpfQO8{*M
zXhNt8<vOD1=y+{hU%&npxj8*a%8r;G9c^23>T11D(lS_Dg|4h8aDI#FPesI~dhHws
zm~})(d<uiCnXu$Aup`VM`}yJGFV<aa@ud(eU;`BrCQx|w4chP)va@fjw*(V0FfwAX
zSaLG55{4}4C`e|BoSamf6!c4Mvas8l#`QjmjEvMWaIQ{y^wP>npurCd5~Mz*J}8g3
z>kSfKK3)M~VYsLF{peRuR(`t+2@1bOAwUT}C53u+b~e;n9|m(MJbV;MD|#|0`9b0X
zp92uH65Iw4_6Srlxob9BMv+S}FHOxj1Y#U0UMBA038k|0@N5JSiz_NCPnGZbLk|uS
zMp7~zKh73oqr?p#JbY+A8mB|wc-4se@wJKL`qbtAfC{UAwds=l(bUHwWBoGBg0`WT
z+h(mB@N`v%MJnQHjh35Jtz2dkSjO1ZtSB+>rBQ7y|MDqK#_1BXIyOBXlV7(2Uk^1k
z0CyGecW9W>;|(r-rY*0%HV!Seiyp1xy&jJ3iIQia77@~TzK0Zap*`)<5`98VLzDit
z+<J1_k@(v8edYKMzb$}vQi8d=A06#JXJ)S6xqO@=I*39=eg(cbDZndwJk9@nfsS7#
z<ph0op4Y)70B)==3T8z#ncopr?^R~el_Ep?D7yr>@rc|16*LDG_VlTG1s2l38)JB2
zaFiNRR+o@K`Qg<o==0~#k7qrM#DjRiRfM-2*Dr|0LPA1TWLyA;M*=d2^-`FI;nSXn
zhzqAKD8kojVPmVXZX1JtazQ%~__X55F(b}ToR<2|r+wTq7K)0!GhX|jq|HFS1uV_o
z&Dqy`=q1pJ=BO2%o|px`-kq{7vY#r?&(4NExqp7P5S6Y|{Dgs_O_MP^DoR{iv%-CI
z>J%R%Bh$f2(6G1nf}ll*vDe4=$d0dVX+Zqqe6WR>Edk6a1Ol;~b?ylL^y%~98(dsm
z3X0X}7MV&%v@#TM>FGSD<g`(MjvLF8iPUAN^*PB1K9p`bM*CW!?)TWGq@|_dQ?T3F
zH~?i#L_`GL)fqaf*DJfUv^!;P9~hC2=R`6PBA$EJmNv}x^w>_8S^&e_$!MYCvwM=c
zI+CZ7&J|#i5YTkh=(et<qB6il&TjY4A-Y!f&;U#JB7Xf4ySDZ?PX4W-RuBlI#yB9{
z3}0?HT`^=9=z(nuuHawlV4$iR{ZsiB6x@2T>LxA`oftJ8ow$GV-&H7|vJP5CrKE#l
zd=9=U9^g!Nyv~`(S^vOl?gW?&xePd<O7n}q?ri&~^SWSq38@;R!os{ya}Xicdy8EX
z5)upy4EI7qJBEinMbfGe<1q{h)%sh2;{j#y?&bXl4;~nL?=pONRczTewa^jC&&vzk
zY+wEG!s@E@g4AkJ;{}FlA9G*TNw)L5*FMloW=e&(M^Jg33<5&I|Ig3M3sZOrQnAu&
zBp1YOezZ@S<Y;tE%>2Uo*>E^Vl49;*dI7r9K3QWehMRXOuq~YMPRrg>4=@TKYy0)<
z7j3F=k-=o6^-$)-!~|gNsKxz0g}_`~ihgz6z;Rmm<rZe!-W-5?y;HCUt9Cc?i+6U)
z%XuK(y}bl?@2(VRN=tjYD7+*Il=(;}<Qj4*YyF7q(cz#ZF@U?UnG<KCNTPTpB09k@
zDJhE3toenJm&2joioXt;bFUs^>(9@BzW>>|BWom%UV5Q*zTd|m!59!*7CR~rR7tGt
z>|17f{i#S`w9qecab(ogGiE_5Wnj%gAY484mMZwwHThgbMC8Q_y}Xe}1VLsUQBqP;
zKz3$fQCFH8@(?eu?Du5+#XZ2116}a=r-OrozkmJx)<3zzbg7$yoCD)rATI18E$=S<
zRAI8PerIj|UZ~c+mzxYn{)H=^SQ?L+8vm=yp!RkmO<WS^Q+;=m;1&}mW@-iDqtoT|
zW4NB@4898mWq%+vY4)X0lABG1KT$Fz@Z4N-^S`74{q%Nh_4p_7EsnsY^f|dY**V%?
zVUvpj-Q6M4%uGy7&!2~e%+JqvcXxv_SAhXL;(=<E$Nh(7X*B$PA|!z5Cki%;;~e2`
z%lS|AioKbs^p2-U#v1{MB@`eoKM6n6c~B;mfdIl_b{t56$w^6vJ1S2I_hY*(pkKax
z0V;OIS#BS98({+jeYjn6axxVi9n<~00@VEzTxND%4PBhQG2`(&r`kM2K;3v3$iSa^
zpnSCz6+d;E%PT33TJsqB?4It2Q=pxfQ(59{Hj{Xv<@*SuG@rHnWQWGL8E>q49wRY;
z=LI#Yw{;FQBn>48heb{2Yl&9mN@?6}=G?x!r^{flc40k^O&5F@C%eyriN%j+_A#Lm
zqobpa7wbm-{r%Hbj*d1qkW8gy{sR5O$S(8mU|vw0d_%1tp$!s_{kyXUUS6kWQKDOO
zbE;ZeNl8iaP_0K|{uge?wh9PZAx|Lu82WCnq|}#YbnI8{U13-x4m;VIEDHpl#&=uD
zgV-Zc(ZNd@U~DYzDJO2PQ3~<?_iLHc`ECb--9R3?q4bD~-;VNIzo@8ax;J)pJf5|L
zrK)#Fus9|*)&h14d>_vr(VIB>$3ON==6!A+7!NOYHC-K@rElX3eb7426Mt)ULj7jr
zIZ&Wi!$PS3Kma6+@NXO%9Nan7HoCBQAr+*8^WOG$p*lgr`s%eT2d8IE==N3~c=I1p
z3lqPVK?c&$#<R;avL5Z;q{CytB*CgvNVuMrmX(FBfY58CQ=dS|jbJsb_uNJ`2nq^n
zr2<6Un;=+LU$2iGvID;TOc&FaJU)fubMKwt5W5lqF|cQ;KT+5N>`dw)bwk6;Ri<?2
zhhdiy=`C~T)%JS!_H4l|fG9gXh*g=8(L5Re{25U9glQp{_D?{i?G&?KbT*Vc+I|EF
z9VPs%DUOu2U>brxeoRm|Xexu{3|W`6u12sWvasz-UoND<Q&Lmu{5ML1X?>i)AUT@$
z!Xgrj;J=55_geqHji2uMtGU@^I9u*wEBNrj1KkH0GeCoQz+g$DaCdR<S22n>?_Ye}
zCzMPQq|5zZuz0=CX{qLRqp<(wLOcV8(bwubNFLnA4LlmLYe)=M%j;R5Qu5J(x(Y~1
zpkKTXRu;QrvobRuQ&AOg>pYH-Mv~<KaYOJepp%r#86L?~_Px3|#%NL!1Oe|-Q&U%D
zcrhfr{R0Tk7WPlq#m_b(a*8-SO+RQ>nV6VF^(M9~?}NsSM(keC))^Gw@2l0ktBdU`
zPy?wVXz4ZL6zAaql{(*xQSHgeNqzQl?oB|)qD9^f(`OAO#3$8y?OW1!-2%yC2vrbI
zk57W0{|Oh1P<M)&+IW5$%ToxkN>t-ZO|35ofLvN&Wbt0lfK$5DkkQaETVGyUIy^m{
z2ke|Bz(UnIdNeGgbHH%|SyXSzohW9|<Ogv2l=z<fgu+H_OiY#i^jL-(h(aK)uvxZ-
zyv$RfQj$hGMA3>0Z4b#@oeuE-rdb<Ddp=_o`BD6}_{?F*rs9zBaBFJ|WQWl5l|-v-
zwbk#M+hY3%BM%&sj1!MsFrO0f$$R-9N7#|7{`+GTzQ8EPL0c`q+u7Ka{uul{(`q@i
z5#43Z&D2rKnjQX92iVAtmk*MRMAgqQZ3tAb+k@`NFv%2Xy@-<+H)t|Mj&7l=IQAF2
zy1T;=hTdM_Da_jGX_b^VQT9L{A5}FloKy4wq)@ADQnyJ;Oe8$bTQktaq(E}0V4<0V
z=4{#t*^$J(QatloT!|(F;iUL5IF?D-@Nx?jIc)(x<JXSKSDVei>{Uk+McOIbKpyki
z>0r8If2-f=*?IvK1(<O=HF<ZxfSTfxj3H~z&c)Ks&Tj)_{)~v8IuGPGq=BjPqa2wd
zQaA+#qP<<3Hu%iSQqi5Zy{(MvI!=p=H-S<^WN7H={5}V}l@$)oD`HNLy`+p$8+`+P
zEPIW4uDrJP_@eUyR;LHJClTy~ncZ4viCKq`uyC2xAuvrtm{fxxY;k4Q<031&8d@~&
zv0YhGqRLun<?=49&GcygZ?aJ6Uhm6r_pKRF=p0x~kyBQNK&-5+#EqK1ce5bN)4{U=
z7T<RKM?_>;$r`R4_g^^Jzkol##_Ytset&@H&@R*&(v!2dw?`+kTwDZ$&MM2bp{#}i
ziylm$3#R{K;OYXQsG+G@v6kvFvHno&5i5{|qhG8k*{lr-x`_F2U*Jd4uA??_x0{;&
zgffAS3T?#JW);d|%Z{(g*Z63oZmTibBmqrCJyB}$l7vRU>4|`VXWvu>mi;0x-7j<V
zw{Fgb&s+}0=Eg?IihuH@6))+v9j)MsSb6`{?-)qjVhgYk=Ooylw7T+I%V%;En#FOS
zCYFu4hhvPt*z)nRIwns*Cyb6P9g%LEc8}}L?9t5_^BXt^H|Ou1th0LAhw5W0eF6(8
zcmeJ3O=1QIp`{03g;U#=n4X3qhuCm%&Mln8uRZTS><j@}cp5yu0pG*A6fx1X-!F`*
zqVqX<3a{$tWpeIKm?Rbx;DOg|HSGMtZwV%*+fdafX(g0I$kI<?7ov7|v*IUx5DP|s
zhB|1eURtt}6kJ-n0r;&Vel@c&BaLiUN#LC87v84cY1Zd1&~_x}Fzgk}nqmcF;>NQr
zst}0_vc~hZ7s!|`J=Z>GAZ$F?VP#>dHSa_5@jZPy*H?wgG!#?XADRcHP9WNjB9Z<m
z^Kg-(xTwvv#IOhmiZ*1#wUhPP{q5fw9lJ|OOD`@jy^T+38owB9s8aYhGDR<SG8n1t
zA|QJ8@o<5orAhp90@UccY~r8!o6h|zF6N{<O9$CYss~yM3Suz-71zdD(aLAQ2d$KL
z2Mhi#udD>+n9;GZQew|yQ{IzLpFa7*j|n$$Ktsf=$L#1fMwH;}F?Q{!xCcI!Y1=(f
zBG(Z~Qx`*vJt@_pWn1WoI^Nygl(`~_j;=YS@O#qI@(d3T56j<=EXdDaEgKj+R(;CK
zT3=io+{<w>5{0tsT7t{j>HgVT(mp|CIL1FigKQFbF+M)?*j-Xp@bk*}38E)Q;ew2&
zl#>G{`*OL39)eVi(kD7zl^Ou;ZE^Ayn1v`Zyteta@Z_ZAhK71jn*r5M<pj>=wzegx
zbUTQRpq}(vvW1?AG*PkA|ElrN*ZVd4xtkmMHKu_>)+s`6Yro%(c#0U>*sSGVT@-cn
z#vjkXw@;iGboKOjb?qIL*-7I56}wZQbu4gl?*U_VZLPyhwe#Ux6bv?Sg2lpW>LqcB
z8R!{3Jw1IunH&U%a0(6wJG+D3U1w*vi@k6TfW0S`Diu8v0f=Xb1?us1<aae&p1&kM
zAW^=@{#5*yR#p#&y5nAq|9A^1mHlA_j;hLv^X0Ou*49?VG?AqiV)5c`lpM5cp<VP~
zr^PgSC00e;;;IUWi5ozfG+(0@K3+&8?5<O|j=s7)J^&feKteNTZ!_8-4P4Qb+d8fP
z23L?tBdC)eru%t=+CDC==hw!JMrBog50psO(8SD4{l;chj@s&oiuki=*{P{%E&r2@
z*w~SqWmYaV`bI|RyfmM^*<%zyFWZ12lY-v(@U==zB~9SnWT<Yz*04ukqA)+BkTi0%
z{&)-C$JRGnWxYG!29TY9`eBv5xP!3QeD>1NJO&dV6SD^{a)!kg8dPmHPnJzjPouq-
zQ~irhPcGrx`@4rryPifqmtKGf()3nC`u_481j><FVku-)Ov_xaQSnbSIz42pKu=rq
zZH?#dd{FxxIy$-<{YK}Oc3{MR{`>*DABN2L@83_B(VdSsp&*&Tbbi(K_2)ZtE!&M}
zhS*RrMY&BEMgE6Jz9wZ&r9}<(_3><ajIljLbVBteEkQDvUX!SJwEvks_TbUu0?YG{
zyJ+9D0?kZq)0G;l^q1Qo=I2d&ZVE#n^TBkL#TPQt1}7@+SA71!E|gQnmX?>7S5|iB
zaOuXz#&jzHB?y+zx7?eTWY%RsbV}L&jqxBuoka&`YwPmh<p3+tf^4CmKmZIhqYRqO
z+(O&-EcmRC6+j=-(q5jNpT5r6SsBV|+Cp8-hjZX<Y)}Syt@rWk>FM<~)YR4{QTT#t
zgaX>rxB2{ZLpd3UE7rv?e%HIUg^|VA_%w(#utstHTOMs|AJ=8RM7AWK!@|iqI5~Nm
z>Y>HQ$D`{v18mWw|5;S=p<a?+HoKZH!mllC2{V8N_SwAz+b5}W-_%7mJS~180subf
zaTp!t6`?JvGIIn;WYw&nFrw#T56Q7zzd*F#x!jvt2ADy>Iw4cXd}X~G(v;eJB0>9$
zOJidr85vo;zf{rFf5S<!j7p`w2i0I5L2wc9IdSswIX}ORkMiDEf(*O4vl}(~oS*Cx
ziyjRAVoKvoR8053Y$Fywe+5l5Oe<o03p7Xvhy3W?^sDMjt&+tGhNl@%18)c764TC<
zSrG@fT(h%m$^7b7z46>NKEUz^#Lig3SUvk5yW64t_9MJL+C*T_wwqou{oD}qd})=x
z59-oQC+FdScK8$-dd+A8vjI=kb14N>>OBaK<DDHHu#;3oPZzW0Vprx}5gUG<tAP~B
zdPxA%0YApkbP!XsKQlA46LJ?6%I6_*Kx%M7Z0ewV%##5cde^*H+bDc}d<?<5gKZTP
zGBZ1C<aKI68+AOlHu|n(n00(<X({!;WcNwQN#J`7q;jd5?0oD;6D4MIBqU7*7n>Qu
zv{>`m+RRMI(bGv{(Y+lETQVL#9`FQjUt0A83D64oF4}v)4}7{mbhIg+?7!?PWKiU5
zIMW5J{=~=6&|wQ<<iiDgBYdmwctk~P)j6E>!GkpY6Z7LNi=}Qd{B$tN`T2!@@-!Mj
zn7OWQQh4}_^qyD&*);gkTcY5WC72*}B-pJzzNV<nYr5ww!}?HFImJ`KOtK{}-G`L&
z;mJx?RO2po-EJDBKR_VFpkUb3+4;H40%X+<z7+cU2A=w;tbI(P0w8BZ?6Exi)7nN}
zZQN(bsG@BJjz*v{8S}5ahQd^QK8|9#K0dxKF0d#%am?!KySV5I(1{Hrru=kg{{vg`
zgB{O$kl|1Jd+MB27EEIsPW#oC0Z#S@@V#mV)^qS^WODI&d;z)Wey>@Sc)#ByDDT$S
z*=W8o{u}`xHKlm#A5fk;HCS9+W;H+>jV?CPLa%RicsV-{T?=s53;aia{|0iO{E^%=
z0cTUNRqM#d&T()aDqR0vfE&Ue3e{zx7!+v-y)OIr{K9*9ctFW5C#xtDA8%RlJEaE!
z{22Tq)9gn<1se~KYk!Iik4+!&(|#aj1!994zq8E;j%n2vJ@K?r5yi#DGRyt8+Lau-
z<)GPiY_CjNPL7MN1h9)*aI@h>xlQ{`B+9E}eB1*7GEw)fr6p0|x0cg=m8bKUoCM72
zk*uw=9=dRN^5|#f6oF>O1&iko@jQqDuZ7pslzCkd8YcjO)?{vO!~cZ)<x9W~g%q^-
zeOO<ol2?$QwAt)-&ybacTH)h^K2}>>TXnP8Os!@ukS{T2e*E~6%dBIq*3~prhn`#&
z?6c<P=ETHA?*_x7@v^JuC8j)-*HwarpyE89b*i;d8k!A!85tRORS7>a5-<*;;Af<v
zwRv^)nV&wn_Rz5@)OdLTa8V@Y-&p!xo;|i_X%BFwAZ|^GDlwC!3i&35^rwptfPUS*
zy*+|E0nNspeSL%kcgyv)K@8T?;ybJU{y%9W3}z`XFu2EJ4``zMlX$~h<~q$wr>3R?
zaEZmrtcUuI`~;o;;E+g3N!QfXJOGq==fJ?T%%r5peAZ7ON4>#IC-99jI1|(rd+-h-
zucE?#<?fEoY=9phd6om=VnIPcA@}&iL^Yk?1h@Of1U3kpnOVlm%L_VKPM0aJP8P<%
z1oQJ(ZLP}HZC}w|2QY3HA;4X{pQsiH3Tas?b=!mOhkVP(Xl_>h<&Y|kT-_|5gVoge
zO}={z15Dse+@oWyD-f(UBwNWU@R+Qaa?~cxc#)reynFX99{xV07uVfd)>?Jw?GbPK
zK-B|0&}u_w?`KG>XSLWlu~h(Ie1Bp}^fMXIX>(r{v<^qi>aJZ9vaqm(eX4fK%|1J>
zJ#$7456}EZDdclpV#UGXc-zrY)5b(|J0S-3gPcYT#w;jUlbvm@;d36(mP|uWq(%6a
zJF$0-($>}<`Te_^$G1@M5E&~`P4A*rqZ@q30EDt*5d*%D)vZz&yIfU0jk-&8Pw?by
z8|u0>Q-iI=(h3t3;|qK3Wml>zKt&D7R~tu$hljDWG13Jjc!3S}{e!{Pb5qW{qaL(X
z!2|v0)Y3r3G89>&-^%!<wm5{6gQKYKYBvf{e%CDrA=4~n3@ztgn={7eWnNe3g0c<G
zu#eEziv>rz;1;e#MbYd!dbP^q^P8`rfwynFEce^n*mU=I1KneIL<9(lVAbY8dusMQ
z3(EGj`Ajc(-}<#&%Z(D!-PiR<n6GPkdVN-NJ5m8i)RbACvomJ?SLV@@QupX+8q>oM
zSgD4K_lHAynoL>&OtFXM1pDMAO(DNWhGGy1eu(AAhK3WsT^x(=yz<oX1l@LqMMkx*
z@AUO&Tn5B}By+o`r>9^zHa9!l6@4X28>U6aKw^J#dG_fOL5~o5@FPhm=+K8`$j)X|
zo(tR}=VxWsq$m&qJ+PR9sw6bK-=$ZNS>4F|21Rmeg^bptw*^P9yuE8{ETQJ+D7vz%
zza?LXg@@tV?DwJVkXpe})U^B#Df(NMX-6gsRTTCHD(J7B-<bI**Df2j{8C2R>Xb9y
zh#YT}UAs+Tq!yd+W<^lY9T!Kf@c*QB+j!#!#F4BB!{5to9SM1Pc@|@o`&LsOy%Igx
zS#jHal4)N@&ejA40_mFuB62IgN<8x4sfcctD-g)hle^gj&wtXTGBI4_ZDAQPQ&v`1
zQzIp5Yik2`bXcbcyoH+#ZZg|1(8Jv!)F##D?Ch-1uKnab6nb#~(B+?6*a2VFq<fZh
z1S7=X-ygW1QJcEFy7C`0`J1jV_tJCQ;mOJTQ5&<&ES1!5KuV^Gc;VGqdH13oQBcT0
zQ79D9XNi)~Ja_;i*=_f~J3E<?21);!QiZwfgQ$8l;6~^-gUK{smb0Vj%lPXa4v?M$
z4{YSWUoqIPOi#MBh*3@zikp?fjIcDU77Wk|n{=dq{`^Km|MxU`qMNub%moIjC~2{=
zX6IK&TRh+MUq;+KQMf?@{lf5yK;A$nOvfp*+L)$-{ovCXYE9=uWu-M-UsaXbKGD5B
zqOIa9gq@}!O^e0dTe_q4)@O1%-Du6Q(k{~w4Rie0+;r@@9$QND47YA#uTuSr9bsq@
z4+%OLqDk$o=G)bE;W;4N-50~$`0$D)&amF8*(Ez~%X7Ff-ZxJvz0etURM=aSDs0wH
zK$|X8j{B|KoS0e)@>=#H%Ud{u=IO_dh1F`qi>V6R^|3<DD;dYf6Du;|po_R-{o9A=
z&hCjD2RFf=hk41t6s6nk(i$=|Lv25;)ii3w;dbU;8Q!xqB$hQYG9sY7{<2+$l^n@r
zesyd2)CbT#Yip`U1H5MfMR7f#8&K+|)W`cDUKx)L0Iqm*Z4}fCTsuEMJ(#5A;N|Dn
z*3#-v72a--a6Lk<u^O?HRHwFGCQD3@F|)8d=67Iy3I&ay<<xMGt%ul?lQ)6)ZryOl
z<AP_2mc7Qsl}S`=rvx=-zbN;|g-k8SgbjC|t?n*%O++N~vFVosH#WC3VoP-3l((X6
zrmpS@g#!H~AicluiUJwr+r&g%B3dv)Hdbcyri>yf^it1dQp%SfyB_n(lXV{HQbysR
zgiNaBj5zS9tf;s+SWpQDwI}$|hKl&5EForTv9`9Rvb-D=KkfzoYHfvPGBB1mHu`O&
zd@<x0nJDUv_`bfbi;c2@AK2roOEkJ?35K=O)Y3A%7^n#8>;$T3jnM4k;`jG6)t)<|
z8<p-x%jZZ)Ac?6%ARk$EODB4I6mrx+OF2J3e|n@asQA^czO?+N@jvRg&aftvH5!FQ
z6j7QG76?lXf&{Q2p&M9wQ6v;mLWzi=fW`zPC9Gh91tAE6bdeTNnvEWsG=X5Dn*ahz
zi4;jd0>L}DyZ7#&n_v09OlC6k<(c=LbIyB;?^jd+42gBozO`*(NZ2Y<TR!T!%9*3R
zovEg($xdi=T<F&qzyB$rCKj_4wn2G4?4Q?Wcm{yz^p79yUcVMb<xwr1pIk4j{MO)d
zh*623zYn(`86DXN({H^8&!^4Kj8|QoeJ5Lr86>E@3qJ2~^;7vo%ROo22!nyJv;?O#
z`H(@00|%<BYo@0^cgc3)a5%$_%@wedw28l$;`&-9TfDp-^*t7b+x)I&CSPKqm>al*
z{RchQcXo_Q<?#0K+tXU}O#l8j<zI3Z7Za<gsVR<6xL~Jud4!ez(3Q9@!xh|schKqF
zfGg&>maXc6>luK-(p1EzQz#b!#io>>4|ocKwe?EN9sH}x!0M{1q6;g(PTP{Ag%VZC
zmxjuhF_`eq@cyXOqGzFaY43AmgRCpI%hiM00VBXKz}4xDyUR&qeoxsDke?f!rNV@T
zFM4@hRYf55^wP<wZiX*l8b6$yP%Eo*aB}K`UL*CN8@663Hii{6)in}RY3&8J>80-V
zY4;ybaH1s~FmD=agBKqmRzsU+Ua3(8zL}s<H566th3F>;1mc+wO;-pXA=Es%EdMxn
z;OV)NuRWZn4Q=^8y=fQwX>-lD1a8>BDfei)$uVaeDQ@*8Tk7<FW->RMcF8jP))k{u
z5=u(uL8~?9a0~Q@rpgS5R3;&TtFKrgqF~Cbv-R^6@N-yyZz)+)=MegugaIM{ETXKK
zLI@@$bB?X8kGm9p=`cbBKy|OF;GcR87WUVR#naLcPsc5BH)?g%>ENLNhOtIxcl+@6
zj+T^)EuzUs)lvQW%RO6)j4(B<o}MS^d>Nb7fS_0y#E@EG@zDe9jyTvaVLTC6fNTW3
zptUhs)5h4O3hO@Rw^u3sBrx@Rv9U7?_R<C;@FjX<(iB!^tzd2f7ik#kG<r!}TN_w4
zC3Rv8UH5B$jd2gA=9&Q<tqt+0Bq*!dBPa_HLGJpoD`HjI;2i+u$F^CRvyTF2s-fh>
zOxuLh=E}vVU9RQ5I^}wKqou_>7P{PR#V-eg!2pz1NXtM9OX&q}=`WyXb4s6`ew##i
zNdU>s1zI?f)BP~saH~pfjT939E4%-e0LB!M>87-_V;jQ)K}W*t7B@<qB>lAOXBn>{
z5b3{%<S2E#eLV5kcq5;9C6irNpY3JTAweonn(h*u9{_F>j6r7_uX`Mx(A73>3oxXu
zEj1pVoxt^Flgm@%VCLlWc`heMy~*vfMyfq2yjQ?@4Z#N)=U+R`@}0A=JR!To;6$$_
zleJZh2CAgB1%}>LR!~W9e@jcG7OKZM{&qS5zFznb`uY1yN=8`aCwBSO2CpI5@p}vk
z$)|S9VY{XdN=iyrBau-F?Sk?4nYz=mLJ4H@Bh234YVDf$98rua=TYA+2O=kz!>+wL
zy@yS`@N=a?R1tP6VwHnrt;n_^dn@iFXDlX$DI={N$fyiiGxGQI>+bH(_4Xnxe0S@c
z`;Gp-7%usBQWOdW<g|;syPZKjSti5xg8wT5R~JYP9@?yS!fR(NV;%b><XUMoS`VEL
zxYU6GWprX%LV|~<r*Mt;u4I#{U>alBem`kx>6?+q)6*XMoIg(t3AuBL-qkU2$<NP=
z=>-_#oWPm4Gvq{)V#hLZexPjh1<u*lHjYaDk%7cbPHJeGHLTYt+)9KA9tYYQzXb9Q
z6|zOq6K%G_`59y!(~2+VwUW}>2Mti0aW_*p{MeudU&5)v>}*+u?w|-Z#4JaNebTdH
zC^{S-=I>u(ql^m*0$RLSeBJ45cVwbF?{Xb!3gUm>*&hrz;RhBD$~LJ&va*ZQUo*qz
zA2_g?7b(rx^%-;hCq_{(JF%7H;~vF<9=qUtynK0zaJaHEC;~ZQ7YUYv6}PA;4)*#?
z+81+BOFL$fGT8M4CSGt-#pioZs&?4OI_}FR&rX0m$C%0!0pm_FRU<?xdrR;D_&v;I
zQQ`TsG7>AbrbG|;I=t3Xb5Nqh3ggFegcW#B%9Ax2jU5-U?^kskxn7WAsON2_u{H5>
zJ1z$u<+=wg<t@`=(=$X)jUBQ_b);5!Q}5o}sxMtwnlOnECjrGn&G|P2px|eDvOPb)
z5clwbYBz(i^{DRN4PI_fc3@3am56Oq^c;D0m0%{W6c)GVn}DM#8X#8z?u;eRmeJ9X
z6m?7hqy1xV@5{XBNkX3%7J%W%3I5LR?hK^A_}iowzz+z`NZpV%%r@U>e`h**Hz0Oz
zW3Tv0S7Np<+gS22)?%95Rrq37l&7O@-;obc-_D}e?rs|uF_61Nq2xkjhL31^8SRz>
zp_^4$`Ju}%`Ri9y$Rn_`rOrS@LP8MlMO4Y(W^bck24fd1BSmN3jLk(9#+W}|&ebk9
zz`4_3rt+{D42DKlpgb&kYMbvPnkk$Hft>qeUOq$+zt0W8`w=_1GBPr|<wP+gVA_{r
zkn3*ceN<Y3CxPn<;H`J$krV*^&d*!Z(>#Z1SM#YqlB0O%l)!qw=%*BD^(6{{XaW2v
zbZ`SUKt2M?UhC}&2B)DS4OQrT(dFA00A24^d3`qUcj_tlZ#s4x<4rtZ3H9{!P<J{0
z2M9r4o)ejaa682)e%_sCA`10<8XAEBNd`eSP-789n0@82rIT9;Lco>4Wlj*})rN+K
zQ3<CWo8d#9E?fm_r>gBl$Sgd(LHCY2I2~f$_~r8Io_yLQuc#)+X#HzC&%SgM9WfYZ
z=fa9aP|gbCfYJ9Q6Dj|6!ue59?{@g`;SXhV5<Erf&G&M_#6*N)4L5qy@&oJh9Vh`l
zbp7zn)Hb}MYVwFrpSpp8x~3*!Y%44?&57a&Ga@kGmzTG*+3UZo?>r%!dr(IUu`tD9
zOFcN`>fq)Ua!C1hR;xwX#1?lW`}QqYH#fMVB7l*i-lRB}xdLkxIM>zhvbQZi@_@uE
z&&f8B%zT-~^U75!97UFDKq3OJ_dai8J@{gSqd}NYvP69^HsX(JX+=jPSC`vmfkKin
zR`4FwzR~Pd^hpcSDaS`gh5`iW4M?4;+LE0SDZ8?c2-2Z?!?>O5g6K})?6=iK<a7VS
zu@yH*5GG+(iXzL`^-&!|S0=5jt+TCdAxnwP#66IwFYg4rlF$v^+HYdUPuLYN3<I$X
zhzfy}lO|Uz3~~3-vG>%hpVr@Iu7Y*!f$$7+12yJxG?Gt{bM#Pb4F!0O<v1III{-Je
zw2VHjO!Z`<Kr0Z}JZwPuK1dteN<pBDP-6jk0;KT(htK=Q$0e7k8DFOAKkWb_+S-a;
zd7$2g0L*EGC`+(yYGUF9|1dRh?8q2U)AWhv1ZpY+)0(+Czy4=g@}QKt&m`xkRYYmu
zap-+;5X;SfJ%k1w2Hk3C^5xqP)5niIPf8N=mH>k{9{8piS5Q|MYVKQ9Q34vx@P_^q
zcEJ?{^l|MmD9(}9xgNyWT>tqi8a0E$OpYh!<vmwDb7!B7*OV@3xR-ZqyCfIlJhSZq
z_OCgCtMNTyK&-tz{`M;UFRp`&{|=zx*6@T<Jv?*^+=KFENess+9y}=0isgYc3jDvW
zBZ=R0%v40AYPUtyk-{+<Q^(LOVU{4@X&kkc{-*ustf8?l>b>#A-C<FSnnC5{7~<Ox
zNhx+2^%i~ROBU`Md1z1ORq%BdTnvd6#BZ!%#FfJ~4upNgPGu`YO9~|31?|_MT`6;O
zSv^9K0}VO%2OZHVV{g_EW@_F0YeLQJe;y$Ce0+|?(ii{ryWy_wIYTUew=*q8dEERD
D639>t

literal 0
HcmV?d00001

diff --git a/website/sidebars.js b/website/sidebars.js
index 105afc30eb..0e33bed949 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -88,6 +88,7 @@ module.exports = {
             items: [
                 "admin_hosts_blender",
                 "admin_hosts_maya",
+                "admin_hosts_nuke",
                 "admin_hosts_resolve",
                 "admin_hosts_harmony",
                 "admin_hosts_aftereffects",

From 70bb0fd7bc5c37447e6f7d7d9dcdce5f940de919 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 11 May 2022 17:38:46 +0200
Subject: [PATCH 0215/1227] fix flake

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index fa0bee8365..10349a999c 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -4,7 +4,6 @@ import re
 from typing import Dict, List
 
 from pymongo import DeleteOne, UpdateOne
-from pymongo.collection import Collection
 import gazu
 from gazu.task import (
     all_tasks_for_asset,

From d5fa437912b8f03dfa705967c60fe2212065996a Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 11 May 2022 17:51:11 +0200
Subject: [PATCH 0216/1227] flame: thumbnail frame number if not `Sequence
 Publish`

---
 .../flame/plugins/publish/extract_subset_resources.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index fd0ece2590..7dcaec7eee 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -236,6 +236,17 @@ class ExtractSubsetResources(openpype.api.Extractor):
 
             # define kwargs based on preset type
             if "thumbnail" in unique_name:
+                if export_type != "Sequence Publish":
+                    # if not sequence preset
+                    in_mark = int(source_start_handles - source_first_frame)
+
+                self.log.debug("__ in_mark: {}".format(in_mark))
+                self.log.debug("__ source_duration_handles: {}".format(
+                    source_duration_handles))
+                self.log.debug("__ thumb_frame_number: {}".format(
+                    int(in_mark + (source_duration_handles / 2))
+                ))
+
                 export_kwargs["thumb_frame_number"] = int(in_mark + (
                     source_duration_handles / 2))
             else:

From 8f24a764fd3f5061573931757e0eb6817949e77f Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Wed, 11 May 2022 18:02:22 +0200
Subject: [PATCH 0217/1227] remove avalon.api import

---
 openpype/hosts/nuke/startup/menu.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/nuke/startup/menu.py b/openpype/hosts/nuke/startup/menu.py
index 3a0bfdb28f..49edb22a89 100644
--- a/openpype/hosts/nuke/startup/menu.py
+++ b/openpype/hosts/nuke/startup/menu.py
@@ -1,7 +1,6 @@
 import nuke
 import os
 
-import avalon.api
 from openpype.api import Logger
 from openpype.pipeline import install_host
 from openpype.hosts.nuke import api

From 8892422b0edb6182a119dc848bdfa534e344744b Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 11 May 2022 21:22:01 +0200
Subject: [PATCH 0218/1227] flame: attempt to solve issue with single frame
 imported clip

---
 openpype/hosts/flame/api/lib.py               | 24 ++++++++++++++----
 .../publish/extract_subset_resources.py       | 25 ++++++++++++++-----
 2 files changed, 38 insertions(+), 11 deletions(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index 933cfbe267..80818fbbfd 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -763,6 +763,7 @@ class MediaInfoFile(object):
     _start_frame = None
     _fps = None
     _drop_mode = None
+    _file_pattern = None
 
     def __init__(self, path, **kwargs):
 
@@ -778,24 +779,25 @@ class MediaInfoFile(object):
         feed_dir = os.path.dirname(path)
         feed_ext = os.path.splitext(feed_basename)[1][1:].lower()
 
+
         with maintained_temp_file_path(".clip") as tmp_path:
             self.log.info("Temp File: {}".format(tmp_path))
             self._generate_media_info_file(tmp_path, feed_ext, feed_dir)
 
             # get collection containing feed_basename from path
-            test_fname = self._get_collection(
+            self.file_pattern = self._get_collection(
                 feed_basename, feed_dir, feed_ext)
 
             if (
-                not test_fname
+                not self.file_pattern
                 and os.path.exists(os.path.join(feed_dir, feed_basename))
             ):
-                test_fname = feed_basename
+                self.file_pattern = feed_basename
 
             # get clip data and make them single if there is multiple
             # clips data
             xml_data = self._make_single_clip_media_info(
-                tmp_path, feed_basename, test_fname)
+                tmp_path, feed_basename, self.file_pattern)
             self.log.debug("xml_data: {}".format(xml_data))
             self.log.debug("type: {}".format(type(xml_data)))
 
@@ -816,7 +818,6 @@ class MediaInfoFile(object):
 
         Raises:
             AttributeError: feed_ext is not matching feed_basename
-            IOError: Failing on not correct input data
 
         Returns:
             str: collection basename with range of sequence
@@ -956,6 +957,19 @@ class MediaInfoFile(object):
     def drop_mode(self, text):
         self._drop_mode = str(text)
 
+    @property
+    def file_pattern(self):
+        """Clips file patter
+
+        Returns:
+            str: file pattern. ex. file.[1-2].exr
+        """
+        return self._file_pattern
+
+    @file_pattern.setter
+    def file_pattern(self, fpattern):
+        self._file_pattern = fpattern
+
     def _validate_media_script_path(self):
         if not os.path.isfile(self.MEDIA_SCRIPT_PATH):
             raise IOError("Media Scirpt does not exist: `{}`".format(
diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 7dcaec7eee..d8cc14a506 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -6,6 +6,7 @@ from copy import deepcopy
 import pyblish.api
 import openpype.api
 from openpype.hosts.flame import api as opfapi
+from openpype.hosts.flame.api import MediaInfoFile
 
 import flame
 
@@ -67,6 +68,7 @@ class ExtractSubsetResources(openpype.api.Extractor):
             instance.data["representations"] = []
 
         # flame objects
+        self.project = instance.context.data["flameProject"]
         segment = instance.data["item"]
         asset_name = instance.data["asset"]
         segment_name = segment.name.get_value()
@@ -239,16 +241,18 @@ class ExtractSubsetResources(openpype.api.Extractor):
                 if export_type != "Sequence Publish":
                     # if not sequence preset
                     in_mark = int(source_start_handles - source_first_frame)
+                    thumb_frame_number = int(in_mark + (
+                        source_duration_handles / 2))
+                else:
+                    thumb_frame_number = int(in_mark + (
+                        (clip_out - clip_in) / 2))
 
                 self.log.debug("__ in_mark: {}".format(in_mark))
-                self.log.debug("__ source_duration_handles: {}".format(
-                    source_duration_handles))
                 self.log.debug("__ thumb_frame_number: {}".format(
-                    int(in_mark + (source_duration_handles / 2))
+                    thumb_frame_number
                 ))
 
-                export_kwargs["thumb_frame_number"] = int(in_mark + (
-                    source_duration_handles / 2))
+                export_kwargs["thumb_frame_number"] = thumb_frame_number
             else:
                 export_kwargs.update({
                     "in_mark": in_mark,
@@ -419,7 +423,16 @@ class ExtractSubsetResources(openpype.api.Extractor):
         """
         Import clip from path
         """
-        clips = flame.import_clips(path)
+        media_info = MediaInfoFile(path, **{
+            "logger": self.log
+        })
+        file_pattern = media_info.file_pattern
+        self.log.debug("__ file_pattern: {}".format(file_pattern))
+
+        project_desktop = self.project.current_workspace.desktop
+        reel = project_desktop.reel_groups[0].reels[0]
+
+        clips = flame.import_clips(file_pattern, reel)
         self.log.info("Clips [{}] imported from `{}`".format(clips, path))
         if not clips:
             self.log.warning("Path `{}` is not having any clips".format(path))

From 12abc9e2bec0715836bd7d0ad3fe740b92e6eab4 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 11 May 2022 21:31:12 +0200
Subject: [PATCH 0219/1227] flame: thumbnails and mov presets are created
 correctly now

---
 .../flame/plugins/publish/extract_subset_resources.py     | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index d8cc14a506..6098f2e1e9 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -423,17 +423,19 @@ class ExtractSubsetResources(openpype.api.Extractor):
         """
         Import clip from path
         """
+        dir_path = os.path.dirname(path)
         media_info = MediaInfoFile(path, **{
             "logger": self.log
         })
         file_pattern = media_info.file_pattern
         self.log.debug("__ file_pattern: {}".format(file_pattern))
 
-        project_desktop = self.project.current_workspace.desktop
-        reel = project_desktop.reel_groups[0].reels[0]
+        # rejoin the pattern to dir path
+        new_path = os.path.join(dir_path, file_pattern)
 
-        clips = flame.import_clips(file_pattern, reel)
+        clips = flame.import_clips(new_path)
         self.log.info("Clips [{}] imported from `{}`".format(clips, path))
+
         if not clips:
             self.log.warning("Path `{}` is not having any clips".format(path))
             return None

From df1b5c6e66cdf48f5f26fca6812d208ad24dd5b3 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 12 May 2022 08:57:04 +0200
Subject: [PATCH 0220/1227] flame: reducing code redundancy

---
 .../publish/extract_subset_resources.py       | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 6098f2e1e9..176629fbfc 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -68,7 +68,6 @@ class ExtractSubsetResources(openpype.api.Extractor):
             instance.data["representations"] = []
 
         # flame objects
-        self.project = instance.context.data["flameProject"]
         segment = instance.data["item"]
         asset_name = instance.data["asset"]
         segment_name = segment.name.get_value()
@@ -182,15 +181,15 @@ class ExtractSubsetResources(openpype.api.Extractor):
                 name_patern_xml = (
                     "<segment name>_<shot name>_{}.").format(
                         unique_name)
+
+                # change in/out marks to timeline in/out
+                in_mark = clip_in
+                out_mark = clip_out
             else:
                 exporting_clip = self.import_clip(clip_path)
                 exporting_clip.name.set_value("{}_{}".format(
                     asset_name, segment_name))
 
-            # change in/out marks to timeline in/out
-            in_mark = clip_in
-            out_mark = clip_out
-
             # add xml tags modifications
             modify_xml_data.update({
                 "exportHandles": True,
@@ -238,14 +237,8 @@ class ExtractSubsetResources(openpype.api.Extractor):
 
             # define kwargs based on preset type
             if "thumbnail" in unique_name:
-                if export_type != "Sequence Publish":
-                    # if not sequence preset
-                    in_mark = int(source_start_handles - source_first_frame)
-                    thumb_frame_number = int(in_mark + (
-                        source_duration_handles / 2))
-                else:
-                    thumb_frame_number = int(in_mark + (
-                        (clip_out - clip_in) / 2))
+                thumb_frame_number = int(in_mark + (
+                    source_duration_handles / 2))
 
                 self.log.debug("__ in_mark: {}".format(in_mark))
                 self.log.debug("__ thumb_frame_number: {}".format(

From 987b5df1ddf44a0feabe27feca8930782a05d18b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 12 May 2022 09:16:49 +0200
Subject: [PATCH 0221/1227] optim get_project_settings

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 10349a999c..0c72537c94 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -63,6 +63,7 @@ def update_op_assets(
         List[Dict[str, dict]]: List of (doc_id, update_dict) tuples
     """
     project_name = project_doc["name"]
+    project_module_settings = get_project_settings(project_name)["kitsu"]
 
     assets_with_update = []
     for item in entities_list:
@@ -126,7 +127,6 @@ def update_op_assets(
             )  # TODO check consistency
 
         # Substitute Episode and Sequence by Shot
-        project_module_settings = get_project_settings(project_name)["kitsu"]
         substitute_item_type = (
             "shots"
             if item_type in ["Episode", "Sequence"]

From e0bd8777d1b9563d292a72ff592e461eb47e50f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 12 May 2022 09:42:51 +0200
Subject: [PATCH 0222/1227] pop useless item_data

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 0c72537c94..673a195747 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -85,6 +85,7 @@ def update_op_assets(
         # Frame in, fallback on 0
         frame_in = int(item_data.get("frame_in") or 0)
         item_data["frameStart"] = frame_in
+        item_data.pop("frame_in")
         # Frame out, fallback on frame_in + duration
         frames_duration = int(item.get("nb_frames") or 1)
         frame_out = (
@@ -93,6 +94,7 @@ def update_op_assets(
             else frame_in + frames_duration
         )
         item_data["frameEnd"] = int(frame_out)
+        item_data.pop("frame_out")
         # Fps, fallback to project's value when entity fps is deleted
         if not item_data.get("fps") and item_doc["data"].get("fps"):
             item_data["fps"] = project_doc["data"]["fps"]

From ae69db29cac488410fa00c547042126831d3be0e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 12 May 2022 09:59:02 +0200
Subject: [PATCH 0223/1227] black pyblish

---
 .../plugins/publish/collect_kitsu_credential.py  |  4 ++--
 .../plugins/publish/collect_kitsu_entities.py    | 16 ++++------------
 .../plugins/publish/integrate_kitsu_note.py      |  6 ++----
 .../plugins/publish/integrate_kitsu_review.py    |  9 ++-------
 .../plugins/publish/validate_kitsu_intent.py     |  6 ++----
 5 files changed, 12 insertions(+), 29 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
index 4a27117e03..b7f6f67a40 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_credential.py
@@ -5,7 +5,7 @@ import gazu
 import pyblish.api
 
 
-class CollectKitsuSession(pyblish.api.ContextPlugin): #rename log in
+class CollectKitsuSession(pyblish.api.ContextPlugin):  # rename log in
     """Collect Kitsu session using user credentials"""
 
     order = pyblish.api.CollectorOrder
@@ -15,4 +15,4 @@ class CollectKitsuSession(pyblish.api.ContextPlugin): #rename log in
     def process(self, context):
 
         gazu.client.set_host(os.environ["KITSU_SERVER"])
-        gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
\ No newline at end of file
+        gazu.log_in(os.environ["KITSU_LOGIN"], os.environ["KITSU_PWD"])
diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
index 935b020641..66c35e54c4 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
@@ -19,8 +19,7 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
             raise AssertionError("Zou asset data not found in OpenPype!")
         self.log.debug("Collected zou asset data: {}".format(zou_asset_data))
 
-        zou_task_data = asset_data["tasks"][
-            os.environ["AVALON_TASK"]].get("zou")
+        zou_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get("zou")
         if not zou_task_data:
             self.log.warning("Zou task data not found in OpenPype!")
         self.log.debug("Collected zou task data: {}".format(zou_task_data))
@@ -45,20 +44,13 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
             self.log.debug("Collect kitsu task: {}".format(kitsu_task))
 
         else:
-            kitsu_task_type = gazu.task.get_task_type_by_name(
-                os.environ["AVALON_TASK"]
-            )
+            kitsu_task_type = gazu.task.get_task_type_by_name(os.environ["AVALON_TASK"])
             if not kitsu_task_type:
                 raise AssertionError(
-                    "Task type {} not found in Kitsu!".format(
-                        os.environ["AVALON_TASK"]
-                    )
+                    "Task type {} not found in Kitsu!".format(os.environ["AVALON_TASK"])
                 )
 
-            kitsu_task = gazu.task.get_task_by_name(
-                kitsu_asset,
-                kitsu_task_type
-            )
+            kitsu_task = gazu.task.get_task_by_name(kitsu_asset, kitsu_task_type)
             if not kitsu_task:
                 raise AssertionError("Task not found in kitsu!")
             context.data["kitsu_task"] = kitsu_task
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 61e4d2454c..99d891d514 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -30,9 +30,7 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
         self.log.debug("Kitsu status: {}".format(kitsu_status))
 
         kitsu_comment = gazu.task.add_comment(
-            context.data["kitsu_task"],
-            kitsu_status,
-            comment = publish_comment
+            context.data["kitsu_task"], kitsu_status, comment=publish_comment
         )
 
-        context.data["kitsu_comment"] = kitsu_comment
\ No newline at end of file
+        context.data["kitsu_comment"] = kitsu_comment
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index c38f14e8a4..65179bc0bf 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -21,15 +21,10 @@ class IntegrateKitsuReview(pyblish.api.InstancePlugin):
 
             review_path = representation.get("published_path")
 
-            if 'review' not in representation.get("tags", []):
+            if "review" not in representation.get("tags", []):
                 continue
 
             self.log.debug("Found review at: {}".format(review_path))
 
-            gazu.task.add_preview(
-                task,
-                comment,
-                review_path,
-                normalize_movie=True
-            )
+            gazu.task.add_preview(task, comment, review_path, normalize_movie=True)
             self.log.info("Review upload on comment")
diff --git a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
index c82130b33b..e0fad3b79f 100644
--- a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
+++ b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
@@ -19,9 +19,7 @@ class ValidateKitsuIntent(pyblish.api.ContextPlugin):
 
         kitsu_status = gazu.task.get_task_status_by_short_name(publish_status)
         if not kitsu_status:
-            raise AssertionError(
-                "Status `{}` not found in kitsu!".format(kitsu_status)
-            )
+            raise AssertionError("Status `{}` not found in kitsu!".format(kitsu_status))
         self.log.debug("Collect kitsu status: {}".format(kitsu_status))
 
-        context.data["kitsu_status"] = kitsu_status
\ No newline at end of file
+        context.data["kitsu_status"] = kitsu_status

From 3583d85cd2a7d25abf184411c23a273b0f8671c0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 12 May 2022 09:59:35 +0200
Subject: [PATCH 0224/1227] black pyblish

---
 .../plugins/publish/collect_kitsu_entities.py    | 16 ++++++++++++----
 .../plugins/publish/integrate_kitsu_review.py    |  4 +++-
 .../plugins/publish/validate_kitsu_intent.py     |  4 +++-
 3 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
index 66c35e54c4..84c400bde9 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
@@ -19,7 +19,9 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
             raise AssertionError("Zou asset data not found in OpenPype!")
         self.log.debug("Collected zou asset data: {}".format(zou_asset_data))
 
-        zou_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get("zou")
+        zou_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get(
+            "zou"
+        )
         if not zou_task_data:
             self.log.warning("Zou task data not found in OpenPype!")
         self.log.debug("Collected zou task data: {}".format(zou_task_data))
@@ -44,13 +46,19 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
             self.log.debug("Collect kitsu task: {}".format(kitsu_task))
 
         else:
-            kitsu_task_type = gazu.task.get_task_type_by_name(os.environ["AVALON_TASK"])
+            kitsu_task_type = gazu.task.get_task_type_by_name(
+                os.environ["AVALON_TASK"]
+            )
             if not kitsu_task_type:
                 raise AssertionError(
-                    "Task type {} not found in Kitsu!".format(os.environ["AVALON_TASK"])
+                    "Task type {} not found in Kitsu!".format(
+                        os.environ["AVALON_TASK"]
+                    )
                 )
 
-            kitsu_task = gazu.task.get_task_by_name(kitsu_asset, kitsu_task_type)
+            kitsu_task = gazu.task.get_task_by_name(
+                kitsu_asset, kitsu_task_type
+            )
             if not kitsu_task:
                 raise AssertionError("Task not found in kitsu!")
             context.data["kitsu_task"] = kitsu_task
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index 65179bc0bf..08fa4ee010 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -26,5 +26,7 @@ class IntegrateKitsuReview(pyblish.api.InstancePlugin):
 
             self.log.debug("Found review at: {}".format(review_path))
 
-            gazu.task.add_preview(task, comment, review_path, normalize_movie=True)
+            gazu.task.add_preview(
+                task, comment, review_path, normalize_movie=True
+            )
             self.log.info("Review upload on comment")
diff --git a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
index e0fad3b79f..6b2635bf05 100644
--- a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
+++ b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
@@ -19,7 +19,9 @@ class ValidateKitsuIntent(pyblish.api.ContextPlugin):
 
         kitsu_status = gazu.task.get_task_status_by_short_name(publish_status)
         if not kitsu_status:
-            raise AssertionError("Status `{}` not found in kitsu!".format(kitsu_status))
+            raise AssertionError(
+                "Status `{}` not found in kitsu!".format(kitsu_status)
+            )
         self.log.debug("Collect kitsu status: {}".format(kitsu_status))
 
         context.data["kitsu_status"] = kitsu_status

From 2a94ac1248446d8735bf34ebda62356af5658358 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Thu, 12 May 2022 10:10:57 +0200
Subject: [PATCH 0225/1227] Add doc to default value

---
 openpype/settings/defaults/project_settings/nuke.json | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index a9d284873c..7f916424ed 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -17,7 +17,15 @@
     },
     "scriptsmenu": {
         "name": "OpenPype Tools",
-        "definition": []
+        "definition": [
+            {
+                "type": "action",
+                "sourcetype": "python",
+                "title": "OpenPype Docs",
+                "command": "import webbrowser;webbrowser.open(url='https://openpype.io/docs/artist_hosts_nuke_tut')",
+                "tooltip": "Open the OpenPype Nuke user doc page"
+            }
+        ]
     },
     "create": {
         "CreateWriteRender": {

From 687f7260ceef7c0c3b2966f387e0f678a0fa0f8e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 12 May 2022 10:57:18 +0200
Subject: [PATCH 0226/1227] optim publish status intent

---
 .../modules/kitsu/plugins/publish/validate_kitsu_intent.py     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
index 6b2635bf05..e2023b171e 100644
--- a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
+++ b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
@@ -12,10 +12,11 @@ class ValidateKitsuIntent(pyblish.api.ContextPlugin):
     optional = True
 
     def process(self, context):
-
+        # Check publish status exists
         publish_status = context.data.get("intent", {}).get("value")
         if not publish_status:
             self.log.info("Status is not set.")
+            return
 
         kitsu_status = gazu.task.get_task_status_by_short_name(publish_status)
         if not kitsu_status:

From 20f819c1dd2eab2e6401a80c3996c3a93ca0a089 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 12 May 2022 12:36:47 +0200
Subject: [PATCH 0227/1227] change intent wrongly used as status choice

---
 .../plugins/publish/collect_kitsu_entities.py | 16 +++--------
 .../plugins/publish/integrate_kitsu_note.py   | 20 ++++++++-----
 .../plugins/publish/integrate_kitsu_review.py | 21 ++++++++------
 .../plugins/publish/validate_kitsu_intent.py  | 28 -------------------
 4 files changed, 30 insertions(+), 55 deletions(-)
 delete mode 100644 openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
index 84c400bde9..66c35e54c4 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
@@ -19,9 +19,7 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
             raise AssertionError("Zou asset data not found in OpenPype!")
         self.log.debug("Collected zou asset data: {}".format(zou_asset_data))
 
-        zou_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get(
-            "zou"
-        )
+        zou_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get("zou")
         if not zou_task_data:
             self.log.warning("Zou task data not found in OpenPype!")
         self.log.debug("Collected zou task data: {}".format(zou_task_data))
@@ -46,19 +44,13 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
             self.log.debug("Collect kitsu task: {}".format(kitsu_task))
 
         else:
-            kitsu_task_type = gazu.task.get_task_type_by_name(
-                os.environ["AVALON_TASK"]
-            )
+            kitsu_task_type = gazu.task.get_task_type_by_name(os.environ["AVALON_TASK"])
             if not kitsu_task_type:
                 raise AssertionError(
-                    "Task type {} not found in Kitsu!".format(
-                        os.environ["AVALON_TASK"]
-                    )
+                    "Task type {} not found in Kitsu!".format(os.environ["AVALON_TASK"])
                 )
 
-            kitsu_task = gazu.task.get_task_by_name(
-                kitsu_asset, kitsu_task_type
-            )
+            kitsu_task = gazu.task.get_task_by_name(kitsu_asset, kitsu_task_type)
             if not kitsu_task:
                 raise AssertionError("Task not found in kitsu!")
             context.data["kitsu_task"] = kitsu_task
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 99d891d514..980589365d 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -11,24 +11,30 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     # families = ["kitsu"]
 
     def process(self, context):
+        # Check if work version for user
+        is_work_version = bool(context.data.get("intent", {}).get("value"))
+        if is_work_version:
+            self.log.info("Work version, nothing pushed to Kitsu.")
+            return
 
+        # Get comment text body
         publish_comment = context.data.get("comment")
         if not publish_comment:
             self.log.info("Comment is not set.")
 
-        publish_status = context.data.get("intent", {}).get("value")
-        if not publish_status:
-            self.log.info("Status is not set.")
-
         self.log.debug("Comment is `{}`".format(publish_comment))
-        self.log.debug("Status is `{}`".format(publish_status))
 
-        kitsu_status = context.data.get("kitsu_status")
+        # Get Waiting for Approval status
+        kitsu_status = gazu.task.get_task_status_by_short_name("wfa")
         if not kitsu_status:
-            self.log.info("The status will not be changed")
+            self.log.info(
+                "Cannot find 'Waiting For Approval' status."
+                "The status will not be changed"
+            )
             kitsu_status = context.data["kitsu_task"].get("task_status")
         self.log.debug("Kitsu status: {}".format(kitsu_status))
 
+        # Add comment to kitsu task
         kitsu_comment = gazu.task.add_comment(
             context.data["kitsu_task"], kitsu_status, comment=publish_comment
         )
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index 08fa4ee010..76cfe62988 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -15,18 +15,23 @@ class IntegrateKitsuReview(pyblish.api.InstancePlugin):
 
         context = instance.context
         task = context.data["kitsu_task"]
-        comment = context.data["kitsu_comment"]
+        comment = context.data.get("kitsu_comment")
 
-        for representation in instance.data.get("representations", []):
+        # Check comment has been created
+        if not comment:
+            self.log.debug("Comment not created, review not pushed to preview.")
+            return
+
+        # Add review representations as preview of comment
+        for representation in [
+            r
+            for r in instance.data.get("representations", [])
+            if "review" in representation.get("tags", [])
+        ]:
 
             review_path = representation.get("published_path")
 
-            if "review" not in representation.get("tags", []):
-                continue
-
             self.log.debug("Found review at: {}".format(review_path))
 
-            gazu.task.add_preview(
-                task, comment, review_path, normalize_movie=True
-            )
+            gazu.task.add_preview(task, comment, review_path, normalize_movie=True)
             self.log.info("Review upload on comment")
diff --git a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py b/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
deleted file mode 100644
index e2023b171e..0000000000
--- a/openpype/modules/kitsu/plugins/publish/validate_kitsu_intent.py
+++ /dev/null
@@ -1,28 +0,0 @@
-# -*- coding: utf-8 -*-
-import pyblish.api
-import gazu
-
-
-class ValidateKitsuIntent(pyblish.api.ContextPlugin):
-    """Validate Kitsu Status"""
-
-    order = pyblish.api.ValidatorOrder
-    label = "Kitsu Intent/Status"
-    # families = ["kitsu"]
-    optional = True
-
-    def process(self, context):
-        # Check publish status exists
-        publish_status = context.data.get("intent", {}).get("value")
-        if not publish_status:
-            self.log.info("Status is not set.")
-            return
-
-        kitsu_status = gazu.task.get_task_status_by_short_name(publish_status)
-        if not kitsu_status:
-            raise AssertionError(
-                "Status `{}` not found in kitsu!".format(kitsu_status)
-            )
-        self.log.debug("Collect kitsu status: {}".format(kitsu_status))
-
-        context.data["kitsu_status"] = kitsu_status

From 330d4340cc082307bd2a5bda951d7f2e491279f4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 12 May 2022 12:39:03 +0200
Subject: [PATCH 0228/1227] black

---
 .../plugins/publish/collect_kitsu_entities.py    | 16 ++++++++++++----
 .../plugins/publish/integrate_kitsu_review.py    | 10 +++++++---
 2 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
index 66c35e54c4..84c400bde9 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
@@ -19,7 +19,9 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
             raise AssertionError("Zou asset data not found in OpenPype!")
         self.log.debug("Collected zou asset data: {}".format(zou_asset_data))
 
-        zou_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get("zou")
+        zou_task_data = asset_data["tasks"][os.environ["AVALON_TASK"]].get(
+            "zou"
+        )
         if not zou_task_data:
             self.log.warning("Zou task data not found in OpenPype!")
         self.log.debug("Collected zou task data: {}".format(zou_task_data))
@@ -44,13 +46,19 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
             self.log.debug("Collect kitsu task: {}".format(kitsu_task))
 
         else:
-            kitsu_task_type = gazu.task.get_task_type_by_name(os.environ["AVALON_TASK"])
+            kitsu_task_type = gazu.task.get_task_type_by_name(
+                os.environ["AVALON_TASK"]
+            )
             if not kitsu_task_type:
                 raise AssertionError(
-                    "Task type {} not found in Kitsu!".format(os.environ["AVALON_TASK"])
+                    "Task type {} not found in Kitsu!".format(
+                        os.environ["AVALON_TASK"]
+                    )
                 )
 
-            kitsu_task = gazu.task.get_task_by_name(kitsu_asset, kitsu_task_type)
+            kitsu_task = gazu.task.get_task_by_name(
+                kitsu_asset, kitsu_task_type
+            )
             if not kitsu_task:
                 raise AssertionError("Task not found in kitsu!")
             context.data["kitsu_task"] = kitsu_task
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index 76cfe62988..57e0286b00 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -19,19 +19,23 @@ class IntegrateKitsuReview(pyblish.api.InstancePlugin):
 
         # Check comment has been created
         if not comment:
-            self.log.debug("Comment not created, review not pushed to preview.")
+            self.log.debug(
+                "Comment not created, review not pushed to preview."
+            )
             return
 
         # Add review representations as preview of comment
         for representation in [
             r
             for r in instance.data.get("representations", [])
-            if "review" in representation.get("tags", [])
+            if "review" in r.get("tags", [])
         ]:
 
             review_path = representation.get("published_path")
 
             self.log.debug("Found review at: {}".format(review_path))
 
-            gazu.task.add_preview(task, comment, review_path, normalize_movie=True)
+            gazu.task.add_preview(
+                task, comment, review_path, normalize_movie=True
+            )
             self.log.info("Review upload on comment")

From dd77f7cd9bff9bfa5405ba13aa5760675b1b2a89 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 12 May 2022 13:37:34 +0200
Subject: [PATCH 0229/1227] flame: fixing padding in collection ranges

---
 openpype/hosts/flame/api/lib.py | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index 80818fbbfd..f2f5db184b 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -848,9 +848,10 @@ class MediaInfoFile(object):
         # we expect only one collection
         collection = collections[0]
 
+        self.log.debug("__ collection: {}".format(collection))
+
         if collection.is_contiguous():
-            # if no holes then return collection
-            return collection.format("{head}[{range}]{tail}")
+            return self._format_collection(collection)
 
         # add `[` in front to make sure it want capture
         # shot name with the same number
@@ -858,11 +859,25 @@ class MediaInfoFile(object):
         # convert to multiple collections
         _continues_colls = collection.separate()
         for _coll in _continues_colls:
-            coll_to_text = _coll.format("{head}[{range}]{tail}")
+            coll_to_text = self._format_collection(_coll)
             self.log.debug("__ coll_to_text: {}".format(coll_to_text))
             if number_from_path in coll_to_text:
                 return coll_to_text
 
+    @staticmethod
+    def _format_collection(collection):
+        # if no holes then return collection
+        head = collection.format("{head}")
+        tail = collection.format("{tail}")
+        range_template = "[{{:0{0}d}}-{{:0{0}d}}]".format(
+            len(str(max(collection.indexes))))
+        ranges = range_template.format(
+            min(collection.indexes),
+            max(collection.indexes)
+        )
+        # if no holes then return collection
+        return "{}{}{}".format(head, ranges, tail)
+
     def _separate_file_head(self, basename, extension):
         """ Get only head with out sequence and extension
 

From aeff57dab75cb1a37d0f971b96d36b3cebd0ef0e Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 12 May 2022 15:08:38 +0200
Subject: [PATCH 0230/1227] flame: expanding retiming features

---
 openpype/hosts/flame/otio/flame_export.py | 74 ++++++++++++++---------
 1 file changed, 47 insertions(+), 27 deletions(-)

diff --git a/openpype/hosts/flame/otio/flame_export.py b/openpype/hosts/flame/otio/flame_export.py
index c54ebb43d3..e3801a0a4f 100644
--- a/openpype/hosts/flame/otio/flame_export.py
+++ b/openpype/hosts/flame/otio/flame_export.py
@@ -98,26 +98,26 @@ def _get_metadata(item):
     return {}
 
 
-# def create_time_effects(otio_clip, clip_data):
-#     otio_effect = None
+def create_time_effects(otio_clip, speed):
+    otio_effect = None
 
-#     # retime on track item
-#     if speed != 1.:
-#         # make effect
-#         otio_effect = otio.schema.LinearTimeWarp()
-#         otio_effect.name = "Speed"
-#         otio_effect.time_scalar = speed
-#         otio_effect.metadata = {}
+    # retime on track item
+    if speed != 1.:
+        # make effect
+        otio_effect = otio.schema.LinearTimeWarp()
+        otio_effect.name = "Speed"
+        otio_effect.time_scalar = speed
+        otio_effect.metadata = {}
 
-#     # freeze frame effect
-#     if speed == 0.:
-#         otio_effect = otio.schema.FreezeFrame()
-#         otio_effect.name = "FreezeFrame"
-#         otio_effect.metadata = {}
+    # freeze frame effect
+    if speed == 0.:
+        otio_effect = otio.schema.FreezeFrame()
+        otio_effect.name = "FreezeFrame"
+        otio_effect.metadata = {}
 
-#     if otio_effect:
-#         # add otio effect to clip effects
-#         otio_clip.effects.append(otio_effect)
+    if otio_effect:
+        # add otio effect to clip effects
+        otio_clip.effects.append(otio_effect)
 
 
 def _get_marker_color(flame_colour):
@@ -205,7 +205,7 @@ def create_otio_markers(otio_item, item):
         otio_item.markers.append(otio_marker)
 
 
-def create_otio_reference(clip_data, fps=None):
+def create_otio_reference(clip_data, duration, fps=None):
     metadata = _get_metadata(clip_data)
 
     # get file info for path and start frame
@@ -220,7 +220,6 @@ def create_otio_reference(clip_data, fps=None):
     # get padding and other file infos
     log.debug("_ path: {}".format(path))
 
-    frame_duration = clip_data["source_duration"]
     otio_ex_ref_item = None
 
     is_sequence = frame_number = utils.get_frame_from_filename(file_name)
@@ -247,7 +246,7 @@ def create_otio_reference(clip_data, fps=None):
                 rate=fps,
                 available_range=create_otio_time_range(
                     frame_start,
-                    frame_duration,
+                    duration,
                     fps
                 )
             )
@@ -263,7 +262,7 @@ def create_otio_reference(clip_data, fps=None):
             target_url=reformated_path,
             available_range=create_otio_time_range(
                 frame_start,
-                frame_duration,
+                duration,
                 fps
             )
         )
@@ -286,19 +285,39 @@ def create_otio_clip(clip_data):
     media_timecode_start = media_info.start_frame
     media_fps = media_info.fps
 
-    # create media reference
-    media_reference = create_otio_reference(clip_data, media_fps)
-
     # define first frame
     first_frame = media_timecode_start or utils.get_frame_from_filename(
         clip_data["fpath"]) or 0
 
-    source_in = int(clip_data["source_in"]) - int(first_frame)
+    _clip_source_in = int(clip_data["source_in"])
+    _clip_source_out = int(clip_data["source_out"])
+    _clip_record_duration = int(clip_data["record_duration"])
+
+    # first solve if the reverse timing
+    speed = 1
+    if clip_data["source_in"] > clip_data["source_out"]:
+        source_in = _clip_source_out - int(first_frame)
+        source_out = _clip_source_in - int(first_frame)
+        speed = -1
+    else:
+        source_in = _clip_source_in - int(first_frame)
+        source_out = _clip_source_out - int(first_frame)
+
+    source_duration = (source_out - source_in + 1)
+
+    # secondly check if any change of speed
+    if source_duration != _clip_record_duration:
+        retime_speed = source_duration / _clip_record_duration
+        speed *= retime_speed
+
+    # create media reference
+    media_reference = create_otio_reference(
+        clip_data, source_duration, media_fps)
 
     # creatae source range
     source_range = create_otio_time_range(
         source_in,
-        clip_data["record_duration"],
+        _clip_record_duration,
         CTX.get_fps()
     )
 
@@ -312,7 +331,8 @@ def create_otio_clip(clip_data):
     if MARKERS_INCLUDE:
         create_otio_markers(otio_clip, segment)
 
-    # create_time_effects(otio_clip, clip_data)
+    if speed != 1:
+        create_time_effects(otio_clip, speed)
 
     return otio_clip
 

From ce250a6749cd0f6d6f220ada9830ed154ef4e481 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 12 May 2022 15:10:17 +0200
Subject: [PATCH 0231/1227] flame: debug logging

---
 openpype/hosts/flame/otio/flame_export.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/openpype/hosts/flame/otio/flame_export.py b/openpype/hosts/flame/otio/flame_export.py
index e3801a0a4f..500b1a3eb1 100644
--- a/openpype/hosts/flame/otio/flame_export.py
+++ b/openpype/hosts/flame/otio/flame_export.py
@@ -305,6 +305,11 @@ def create_otio_clip(clip_data):
 
     source_duration = (source_out - source_in + 1)
 
+    log.debug("_ source_in: {}".format(source_in))
+    log.debug("_ source_out: {}".format(source_out))
+    log.debug("_ speed: {}".format(speed))
+    log.debug("_ source_duration: {}".format(source_duration))
+
     # secondly check if any change of speed
     if source_duration != _clip_record_duration:
         retime_speed = source_duration / _clip_record_duration

From ee274f81e33fdb8a9741f2c2d397355702de5699 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 12 May 2022 15:12:03 +0200
Subject: [PATCH 0232/1227] flame: solving issue with frame longer renders

---
 .../hosts/flame/plugins/publish/extract_subset_resources.py     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 176629fbfc..0e04336211 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -160,7 +160,7 @@ class ExtractSubsetResources(openpype.api.Extractor):
             # get frame range with handles for representation range
             frame_start_handle = frame_start - handle_start
             source_duration_handles = (
-                source_end_handles - source_start_handles) + 1
+                source_end_handles - source_start_handles)
 
             # define in/out marks
             in_mark = (source_start_handles - source_first_frame) + 1

From 3f917055c135be7b6ba984a6c1245384b3389c79 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 12 May 2022 15:21:15 +0200
Subject: [PATCH 0233/1227] flame: improving logging

---
 openpype/hosts/flame/otio/flame_export.py | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/flame/otio/flame_export.py b/openpype/hosts/flame/otio/flame_export.py
index 500b1a3eb1..8562a766e9 100644
--- a/openpype/hosts/flame/otio/flame_export.py
+++ b/openpype/hosts/flame/otio/flame_export.py
@@ -305,15 +305,17 @@ def create_otio_clip(clip_data):
 
     source_duration = (source_out - source_in + 1)
 
+    # secondly check if any change of speed
+    if source_duration != _clip_record_duration:
+        retime_speed = source_duration / _clip_record_duration
+        log.debug("_ retime_speed: {}".format(retime_speed))
+        speed *= retime_speed
+
     log.debug("_ source_in: {}".format(source_in))
     log.debug("_ source_out: {}".format(source_out))
     log.debug("_ speed: {}".format(speed))
     log.debug("_ source_duration: {}".format(source_duration))
-
-    # secondly check if any change of speed
-    if source_duration != _clip_record_duration:
-        retime_speed = source_duration / _clip_record_duration
-        speed *= retime_speed
+    log.debug("_ _clip_record_duration: {}".format(_clip_record_duration))
 
     # create media reference
     media_reference = create_otio_reference(

From 71bd7eb337bfc372b66973a10ff00d32c838a628 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 12 May 2022 15:24:38 +0200
Subject: [PATCH 0234/1227] flame: retime is float value

---
 openpype/hosts/flame/otio/flame_export.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/otio/flame_export.py b/openpype/hosts/flame/otio/flame_export.py
index 8562a766e9..08478d4b98 100644
--- a/openpype/hosts/flame/otio/flame_export.py
+++ b/openpype/hosts/flame/otio/flame_export.py
@@ -307,7 +307,7 @@ def create_otio_clip(clip_data):
 
     # secondly check if any change of speed
     if source_duration != _clip_record_duration:
-        retime_speed = source_duration / _clip_record_duration
+        retime_speed = float(source_duration / _clip_record_duration)
         log.debug("_ retime_speed: {}".format(retime_speed))
         speed *= retime_speed
 

From 334ef56d63bebea8167776c9c6776719f8adc939 Mon Sep 17 00:00:00 2001
From: pberto <pberto@gmail.com>
Date: Fri, 13 May 2022 13:17:09 +0900
Subject: [PATCH 0235/1227] docs: finished multiverse documentation

---
 website/docs/artist_hosts_maya.md             | 222 ++++++++++--------
 ...maya-multiverse_openpype_asset_creator.png | Bin 0 -> 193795 bytes
 ...ultiverse_openpype_composition_creator.png | Bin 0 -> 114263 bytes
 .../maya-multiverse_openpype_loader.png       | Bin 0 -> 80108 bytes
 .../maya-multiverse_openpype_look_creator.png | Bin 0 -> 26190 bytes
 ...a-multiverse_openpype_override_creator.png | Bin 0 -> 125997 bytes
 .../maya-multiverse_openpype_publishers.png   | Bin 0 -> 182542 bytes
 website/docs/assets/maya-multiverse_setup.png | Bin 0 -> 164855 bytes
 8 files changed, 128 insertions(+), 94 deletions(-)
 create mode 100644 website/docs/assets/maya-multiverse_openpype_asset_creator.png
 create mode 100644 website/docs/assets/maya-multiverse_openpype_composition_creator.png
 create mode 100644 website/docs/assets/maya-multiverse_openpype_loader.png
 create mode 100644 website/docs/assets/maya-multiverse_openpype_look_creator.png
 create mode 100644 website/docs/assets/maya-multiverse_openpype_override_creator.png
 create mode 100644 website/docs/assets/maya-multiverse_openpype_publishers.png
 create mode 100644 website/docs/assets/maya-multiverse_setup.png

diff --git a/website/docs/artist_hosts_maya.md b/website/docs/artist_hosts_maya.md
index 84285bc6dd..7f7f360b82 100644
--- a/website/docs/artist_hosts_maya.md
+++ b/website/docs/artist_hosts_maya.md
@@ -602,134 +602,116 @@ be published as separate entity.
 ## Working with Multiverse in OpenPype
 
 OpenPype supports creating, publishing and loading of [Multiverse | USD](
-https://multi-verse.io) data.
+https://multi-verse.io) data. The minimum Multiverse version supported is v6.7,
+and version 7.0 is recommended.
 
-More specifically it is possible to:
+In a nutshell it is possible to:
+
+- Create USD Assets, USD compositions, USD Overrides.
+
+  This _creates_ OpenPype instances as Maya set nodes that contain information
+  for published USD data.
+
+- Create Multiverse Looks.
+
+  This _creates_ OpenPype instances as Maya set nodes that contain information
+  for published Maya shading networks data.
+
+- Publish USD Assets, USD compositions and USD Overrides.
+
+  This _writes_ USD files to disk and _publishes_ information to the OpenPype
+  database.
+
+- Publish Multiverse Looks.
+
+  This _writes_ Maya files to disk and _publishes_ information to the OpenPype
+  database.
+
+
+- Load any USD data into Multiverse "Compound" shape nodes.
+
+  This _reads_ USD files (and also Alembic files) into Maya by _streaming_ them
+  to the viewport.
 
-- Create USD Assets, USD compositions and USD Overrides. This _creates_ OpenPype
-  instances as Maya set nodes that contain information for published USD data.
-- Publish USD Assets, USD compositions and USD Overrides. This _writes_ USD
-  files to disk and _publishes_ information to the OpenPype database.
-- Load any USD data into Multiverse "Compound" shape nodes. This _reads_ USD
-  files (and also Alembic files) into Maya by streaming them to the viewport.
 - Rendering USD data procedurally with 3Delight<sup>NSI</sup>, Arnold, Redshift,
-  RenderMan and VRay. This reads USD files by streaming them procedurally to the renderer, at render time.
+  RenderMan and VRay.
+
+  This reads USD files by _streaming_ them procedurally to the renderer, at
+  render time.
 
 USD files written by Multiverse are 100% native USD data, they can be exchanged
 with any other DCC applications able to interchange USD. Likewise, Multiverse
-can read native USD data created by other applications. All the extensions are
-supported: `.usd`, `.usdc`, `.usda`, `.usdz`. Sequences of USD files can also be
-read, as USD clips.
+can read native USD data created by other applications. The USD extensions are
+supported: `.usd` (binary), `.usda` (ASCII), `.usdz`. (zipped, optionally with
+textures). Sequences of USD files can also be read via "USD clips".
 
 It is also possible to load Alembic data (`.abc`) in Multiverse Compounds,
 further compose it & override it in other USD files, and render it procedurally.
 Alembic data is always converted on the fly (in memory) to USD data. USD clip
 from Alembic data are also supported.
 
+
 ### Configuration
 
-To configure Multiverse in OpenPype, a user with admin privileges needs to setup
-a new tool in OpenPype Project Settings, using a similar configuration as
-depicted here:
+To configure Multiverse in OpenPype, an admin privileges needs to setup a new
+OpenPype tool in the OpenPype Project Settings, using a similar configuration as
+the one depicted here:
 
 ![Maya - Multiverse Setup](assets/maya-multiverse_setup.png)
 
-For more information about setup of Multiverse please refer to: LINK.
+For more information about setup of Multiverse please refer to the relative page
+on the [Multiverse official documentation](https://multi-verse.io/docs).
 
 
-### Understanding Assets, Compositions and Overrides
+### Understanding Assets, Compounds, Compositions, Overrides and Layering
 
-In Multiverse there are three main concepts for representing USD data.
+In Multiverse we use some terminology that relates to USD I/O: terms like
+"Assets", "Compounds", "Compositions", "Overrides" and "Layering".
 
-
-#### Assets
-
-In Multiverse, the term "asset" refers to a USD file that contains a hierarchy
-of primitives (transforms and shapes). In Maya this is typically a hierarchy of
-nodes, as it can be seen in Outliner, that is written out to a USD file. Once
-loaded, the same hierarchy will be visible in MEOW (Multiverse Explore and
-Override Window).
-
-![Maya - Outliner vs MEOW](assets/maya-multiverse_asset_outliner_meow.png)
-
-An asset typically contains static or animated data such as: poly meshes, blend
-shapes, reference objects, particles/points, curves, joint, subdivision surfaces
-and other attributes such as normals, UVs, color sets, tangents, skin weights,
-material assignment and shading networks, cameras, lights etc. It is also
-possible to specify Maya data to be part of variants and to be used as proxies
-by tagging them with attributes.
-
-An asset is typically read back into Maya into a Multiverse Compound shape
-node and it can be composed and overridden.
-
-![Maya - Multiverse Compound Shape(assets/maya-multiverse_compound.png)
-
-
-#### Composition
-
-In Multiverse, the term "composition" refers to a USD file that contains a
-hierarchy of Multiverse Compounds shape nodes and Maya transform nodes, as it
-can be seen in Outliner. This hierarchy is written out to a USD file that
-effectively contains a static or animated composition of other USD files written
-as references or payloads (according to the relative setting in the Compound).
-
-![Maya - Multiverse Composition](assets/maya-multiverse_composition_outliner_meow.png)
-
-A Composition is is typically read back into Maya into a Multiverse Compound
-shape and it can be further composed and overridden.
-
-
-#### Override
-
-In Multiverse, the term "override" refers to a USD file that contains static or animated overrides for a USD hierarchy. Overrides are set in MEOW, they can be:
-
-- render visibility overrides
-- transform overrides
-- attribute overrides
-- material assignment overrides
-- variant and variant definition overrides
-- Instancing state overrides
-- activity state overrides
-
-![Maya - Multiverse Override](assets/maya-multiverse_override_meow.png)
-
-Overrides are written out to a USD file that effectively contains a static or
-animated hierarchy of overrides that can be "layered" on top of Assets,
-Compositions and other Overrides.
-
-![Maya - Multiverse Override](assets/maya-multiverse_override_compound_layer.png)
-
-An Override is is typically read back into Maya as a layer of a Multiverse
-Compound shape and it can be further composed and overridden.
+Please hop to the new [Multiverse Introduction](
+https://j-cube.jp/solutions/multiverse/docs/usage/introduction) page on the
+official documentation to understand them before reading the next sections.
 
 
 ### Creators
 
-It is possible to create OpenPype "instances" (Maya sets) for publishing
-Multiverse USD Asset, Composition and Override.
+It is possible to create OpenPype "instances" (resulting in Maya set containers)
+for publishing Multiverse USD Assets, Compositions, Overrides and Looks.
 
-![Maya - Multiverse Creators](assets/maya-multiverse_openpype_creator.png)
-
-When creating OpenPype instances for Multiverse USD asset, compositions and
-overrides the creator plug-in will put the relative selected data in a Maya set
-node which holds the properties used by the Multiverse data writer for
+When creating OpenPype instances for Multiverse USD Asset, Composition,
+Override and Look, the creator plug-in will put the relative selected data in a
+Maya set node which holds the properties used by the Multiverse data writer for
 publishing.
 
+You can choose the USD file format in the Creators' set nodes:
+
+- Assets: `.usd` or `.usda` or `.usdz`
+- Compositions: `.usd` or `.usda`
+- Overrides: `.usd` or `.usda`
+- Looks: `.ma`
+
+![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_asset_creator.png)
+
+![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_composition_creator.png)
+
+![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_override_creator.png)
+
+![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_look_creator.png)
 
 ### Publishers
 
-The relative publishers for Asset, Composition and Overrides are available. They
-all write USD files to disk and communicate publish info to the OpenPype
-database.
+The relative publishers for Multiverse USD Asset, Composition, Override and Look
+are available. The first three write USD files to disk, while look writes a maya
+file. All communicate publish info to the OpenPype database.
 
-![Maya - Multiverse Creators](assets/maya-multiverse_openpype_publisher.png)
+![Maya - Multiverse Publisher](assets/maya-multiverse_openpype_publishers.png)
 
 
 ### Loader
 
-The loader creates a Multiverse Compound shape node reading the USD file of
-choice. All data is streamed to the viewport and not contained in Maya. Thanks
-to the various viewport load options the user can strategically decide how to
+The loader creates a Multiverse "Compound" shape node reading the USD file of
+choice. All data is _streamed_ to the viewport and not contained in Maya. Thanks
+to the various viewport draw options the user can strategically decide how to
 minimize the cost of viewport draw effectively being able to load any data, this
 allows to bring into Maya scenes of virtually unlimited complexity.
 
@@ -741,9 +723,44 @@ Maya scene as Maya data. Instead, when desired, Multiverse permits to import
 specific USD primitives into the Maya scene as Maya data selectively from MEOW,
 it also tracks what is being imported, so upon modification, it is possible to
 write (create & publish) the modifies data as a USD file for being layered on
-top of its relative Compound. See LINK.
+top of its relative Compound. See the [Multiverse Importer](
+https://j-cube.jp/solutions/multiverse/docs/usage/importer)) documentation.
 :::
 
+### Look
+
+In OpenPype a Multiverse Look is a Maya file that contains shading networks that
+are assigned to the items of a Multiverse Compound.
+
+Multiverse Looks are typically Maya-referenced in the lighting and shot scenes.
+
+Materials are assigned to the USD items in the Compound via the "material
+assignment" information that is output in the lookdev stage by a Multiverse
+Override. Once published the override can be Layered on the Compound so that 
+materials will be assigned to items. Finally, an attribute Override on the root
+item of the Compound is used to define the `namespace` with which the shading
+networks were referenced in Maya. At this point the renderer knows which
+material to assign to which item and it is possible to render and edit the
+materials as usual. Because the material exists in Maya you can perform IPR and
+tune the materials as you please.
+
+As of Multiverse 7 it is also possible to write shading networks inside the USD
+files: that is achieved by using either the Asset writer (if material are
+defined in the modeling stage) and the Override writer (if materials are
+defined in the lookdev or later stage). Shading networks in USD can then be
+rendered in 3Delight NSI or used for interchange with DCC apps.
+
+Some interesting consequences of USD shading networks in Multiverse:
+
+1. they can be overridden by a shading network in Maya by assigning in MEOW a
+   Maya material as an override
+2. they are available for assignment in MEOW, so you can assign a USD material
+   to an item as an override
+3. From Hypershade you can use the Multiverse USD shading network write File>
+   Export option to write USD shading network libraries to then layer on an asset
+   and perform 2. again.
+
+
 ### Rendering
 
 Multiverse offers procedural rendering with all the major production renderers:
@@ -754,11 +771,28 @@ Multiverse offers procedural rendering with all the major production renderers:
 - RenderMan
 - VRay
 
+Procedural rendering effectively means that data is _streamed_ to the renderer
+at render-time, without the need to store the data in the Maya scene (this
+effectively means small .ma/.mb files that load fast) nor in the renderer native
+file format scene description file (this effectively means tiny `.nsi` / `.ass`
+/ `.vrscene` / `.rib` files that load fast).
+
 This is completely transparent to the user: Multiverse Compound nodes present in
 the scene, once a render is launched, will stream data to the renderer in a
 procedural fashion.
 
-![Maya - Multiverse Rendering](assets/maya-multiverse_rendering.png)
+
+### Example Multiverse Pipeline and API
+
+An example diagram of the data flow in a Maya pipeline using Multiverse is
+available, see the [Multiverse Pipeline](
+https://j-cube.jp/solutions/multiverse/docs/pipeline) documentation.
+
+
+A very easy to use Python API to automate any task is available, the API is
+user friendly and does not require any knowledge of the vast and complex USD
+APIs. See the [Multiverse Python API](
+https://j-cube.jp/solutions/multiverse/docs/dev/python-api.html) documentation.
 
 
 ## Working with Yeti in OpenPype
diff --git a/website/docs/assets/maya-multiverse_openpype_asset_creator.png b/website/docs/assets/maya-multiverse_openpype_asset_creator.png
new file mode 100644
index 0000000000000000000000000000000000000000..0426e9f82302f0306a53005fcba6c22b960f2368
GIT binary patch
literal 193795
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

literal 0
HcmV?d00001

diff --git a/website/docs/assets/maya-multiverse_openpype_composition_creator.png b/website/docs/assets/maya-multiverse_openpype_composition_creator.png
new file mode 100644
index 0000000000000000000000000000000000000000..eb0e5e33487b804e405d5a27d8048a485693ed6f
GIT binary patch
literal 114263
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

literal 0
HcmV?d00001

diff --git a/website/docs/assets/maya-multiverse_openpype_loader.png b/website/docs/assets/maya-multiverse_openpype_loader.png
new file mode 100644
index 0000000000000000000000000000000000000000..0579e0dcde1e8281fd7fca032a4e1a777ec3e5cd
GIT binary patch
literal 80108
zcmdqIXH-*P@HR>dMVb^NNK-lzq)D$z5ftfFqzkBoW~6tdR{=$lUKA0901`Tcu9Sd^
zBoL}}2m}ZaAOvpE|L=Y8y`SE7Ki*j@z&f1lv-j+o*)z{PC(+pO4&#L@7s$xS81?nE
zP07dr>||t=H)*L!R|eiyEs~LuM?KNfGKQGmxqVe%M@wE>NnTz;=7uyGnP`Sz#)!DK
z346bW><gAs6A%a#2fZEsN>5CHQBL3Gl|!z=$cZtoZ=+4&Nv#DeiIuAZcme>wt~b@b
zn_Vj`zpCV|oBC*La|YKm8-iGyf^_oSuY6}S4tUTf!(Z&^=;nW8F03T)Le71L>z^u^
zjSS<&lxDnrl@6M_zgtXVXHD8T6fAr!E-+U#JJF@n#an@<=OyNY<=%rX6w)?unHFuQ
zmiAvb!T8j|3z@ine4}mjh^74Qz)k3VIxrfuwDk4y+UH}lbR4ULs;rt2%*IkcnB_JV
zofJY;VDHCpBqr?ns8)HND9h~Y^g>4)XNw8HXB?mm!C0M^k2c?VFXvuVyCHiYv354w
z{w{H*;I_ZR#Q{D~Lj9%I-0gZNG#?F&=to;Xqd3C8@CILec7HFmWW1K<R8Fx?^l6Q!
zqHTO!h@JGS*2Rn^L&3Qvj;C(LTNgep)2k7hR#urxDt9g3K<nr||6m;ssollgmoqpr
zcS(Cf=c8u>AtPhzIscHq7H8rjBfCnbuYJorFb^{w^p^d1Q~!>)5gtP+D|1!l@gp<%
zCD$JxeJL+p2FfKS>fc0ue&^v|NB%>*ZYozh>+Pa$YM)%EP&A8+!B}HtQc`sET-ObX
z1u{y8p`ZBlh9q?hyEcX)>JxRN;~K)4l12HaW|ch^tP+hjNhS@QR$084j+;PKnKKJ6
zL9nI^*33gR&Di-Jye@zWdrR0WKbpZWDY84tNz;ax@ZE1Hbm><E!tr_qex;UaD>>nx
z=#@ib%;AD`s(J6Xij1cPw_mHNo^DaG&-zY=x-qABC@80n9U)ySkgH=V*S>BV%w2L6
z=_DM<Y%|W0m2WBk#1fv)-I@!5Qx!GFu0RJSkUA1zbOF0DI}1xjo2mP0@)y!`Fd>G3
z=0_;`_dEpYi-WfxGMmT4rU5sdqN@5QYm5j<lH_$!0(v9zs;r0CE)LeDtHXofa&Q4_
z*y@ij==&@rnXtPcnv{^B7jm7t&mARS&qLVJ2P;AXe!j4s1zeAsvHp;|D9Ln^FxDaM
zK;}l)L2=4>(}f)Uj$yNq%&VKCDK~F--kxyn%Z$tUXisXi?*wR)w0J;|b-LAT3c`Wi
z9uscCMX^U{cs&1sFQ7u{61Go<HY}d9T(Q4d<emdH#T%t+4Wp-zu>x=oQ>|xwl!gK8
z>SQ41P47lCcbaV#Fs+9ISah4tzN2uT*F$SlBMKmYnGzDoI>$PvIL9~_(Ha~U$sCeS
z0YV*lJ5~j#T6tH`?94Q&t*FVzN$QGo#ZJ3JF(YhHr;+x8M`!pIMwA@2N<Sp3BiOT<
zBET6b6x#l!__BXnA2}o33@%GWnOmh5SqH_NX@K;aISysFZ)p>?q7qS|nc}U%6LGIz
z*u9uXwW<C@pF!aFP$9zs7k%3CCrpl%+1HeRqYnhC&v)ir^vYL8iW`B4x%k$&y<(^X
z4kkz0Aso!q%VT)-(U>rzgf4&#bVEeLSy8&jd0|_jA>J|e8k?=BCOt|s%V0cZ4qtEF
z{doMW-f><yeXD1+Be_DuNJKBi^N~kuxEIC5FcqyfWsubC!GfXUz-%+iWWY;^?}~9A
zdks;RYGeVWdNA=*i9JGZPtHS78FHY&xh_&ewm4CIO!DLS^-Z$yxmKo;V(T=3Txr@4
zMQ4!c$a7d2JAI~tqHF)6FXOp8oQpC*qsW@(;oa--oebl)mDXL6C_a__2P#E@Y|z(^
zK5pXB-VlRpYDIyZoki&?+RYsFSC7#Blq(k*mRnO?m5+(u{E7}`e8ynv0_Ocq;kgK{
zurOA7_3;qbH_C)#(~rc6)_A_D&)qUobrV^U&Lg8cE93$YZb>W6nwN8bZXg#?d|yFD
zfqoxHRG=aA9bWL-r*<nLXn$us);F5GJGE?inOpPt&&_${e5AAV_QyI;F5pXt<yUP9
z0G?|c#-SN|jt6jV<hfm*OW7|Ut0484=0(d^hWV$4`I2l5MfLugEMP?_7kG_#(n_%i
z73+BM=kS4YznDWJ<FMVvtFZ4CDl=jcU1AQJP>sQwAa2RswEeQWO|)T4m9<pOP{?$w
z<5i47`PSvUUE6P7Mpi+muB)M$@HTB`m-s1i9a{TRG-Qu&msymFb|2SKL*^DR$7~oR
z(b?2b4+UE(+=GgAYSwC4tuh);2%Bn+GmA8qG;$fAyfSNlHzu`91<X5WxW7Fx9a(br
zmM#<+GTZR{HTc})NRq*{K+R6C&o~|S#{9#qRi1JfEw!VvmL|)bk>P|<esh505|Sb;
zAL*y5^LRF#?1^|q6V<figbHdZxym+wGdHR_>w;91;q&!29jUC^7<1^xegdpYjZqZH
zrY0CjBbB<R<FiXAI<qkrBzWiS+F9fu^KyH}&LXD@t7UJ#0#^-b3~`ewy`u|#kZA^F
ziZg`3n#g;(@^?3Gd){~k8{Qu1BJcGU;OFQ68TWOdj^r3$-%!be*}$~R^D~f$v}X56
zx#x(8!bY30%g*G25mB78g|yVl_iEslUvM0Ap5l~D$%=?VeFyTRGwA%VqfLTFckQ(Z
z11XMm-VidFR6@iQUJoF}ynpb^(%&&BN5qL--hoAGI^?T4^U6_kO8o;we!4Gj_WT-}
z3FK$rqSYHhG26YY_%IP*72urQe0Z{<1{VvFe|~brdAu|;SbZ^+c{;E7tX)u^x#HZ7
zbJtSN950g;9fs6G;Be3sZ4FvB`=chINf}LQdFJB6Tk;oep9HE_F!YGDZNA8t2UrUi
z6MW7#EexBtySN>1ecVB{Cbr)|O-0Z{End*^sId5gtvHXw_>X6k-<MfVAr{3z9=p#$
zxSx1p!s#QkNWiTy@du;wZ?y7O?g_xWeF~U&PE{BNo!h9n+NYQYPahft>$;P7ru^Ez
zJLvsr^-YN6J-V4Y_%OD8-eAcRK9Z{Wzg*8~AqDmXy-FK~)<l3iq90hj9S@&DMiXNw
z6Nm?`9yUTX3_Tug$Z)B#fJ*!<z;NP<sg_A;E04)Iw+S^cPldY0ZMKWzU0_%v3;kqM
ze*w*jRb1GuU|^X?6R!2*V4p45Ct1NgWo}WNP*em(X^la<GbTKp`ZVJ`b5%NdTOP6w
z2Y!>@khc;h0K*3q5N`b_eECjg#}3RpxB><JjBvzvAyWW{!6DV@f{GE#qYT6cWO;wo
zI;d?oRR+crY7Ma0{#iKb#EVvmcdoEHkS!l7tRBtBZzB=@0ZcjpHCdJUySE)P>Lifd
zNouqRg%u|K*i|L=&gksZ5)mUu@=igR^4CJK@z-+~TAD1)<L0=N3cr<xGvwa+;a%4&
z&b9VRj)fr*rkyvJ)H|E_5l8P%xLqE~(0Mfvz4F?SD*(|8hKLs2-fr)>d(53;vYW59
z^UJX9H`Pij#^|ZgreMYE?^cSgvp(xqEDu{(u2+Xvkz9bm9t(!lnMJI=(#Uv!rXIl5
zYY{X?G9Z=-fq}mV_`!h!=qh!^eDe`QKsc`=GUPM}G`c76!}$Zp;#Nx@$Y<+!1*CZ7
z0aovlu$lbQB{SMbDWK<CF@5j48CVuZ8?Qk#b02<2#_ZVbz`TnnPMf=noH$_`Tt88%
zxVr4--r{heoV{bS$+N)(j>_$DAs^9-6tgD76@dCZx`510Qz1kFM;Rakfh?D6XTdNm
zAmdd9+^XhtPm^^~!-Pszp-%I6G;k>tMDQhp(GKV%V4l`+IkP@@;gw9@n|&MIFRYEL
zMSziQ^et}hQC-5P>)*T`A)(O#U1HH%4QhL521O8kDtZJ039w<5XOgA~#i;8;CIvll
zair7J!4bb`QC)q9{IW}>X-A>cUwb{b*^u`i8G03=Gh#;0IM!nsSJCimV|`(*E2<-}
zi)rP-@=rBp`5|%qsA$l<{K9QNroOnJ&3^B0S5G@SS26SkAr5q-Z6Nxf+~EKaP-@s8
zjDP3$^AZ;#cP*HZ9s*@BnH|ABX0wk9wBz-(e0hZ;k6A%W`d2q!`)LjL{yVMycJ;4e
z<+u}`m8QaC>qLNa>A|L(L)^;9iKRAiyKOJtR9wr1bbd^}2D+Yy-Ggy$AKuo>v<UQ@
z?^r!R)I)lx5@7bpExz^?S7NN(;$!?pAos4sH4b>sMn4_O*diigtD{Mtg<Cjp@a{@b
zp85Dg*=@V%O5u)3iI`oPil)6Omui9F`8UvE_z$>uLP3_d(sqY+c3#NvvXfSPDY!?5
zqk3fFP^HFTB)8^L=^e7Ofzs)%MlQt{tG)I!aEiXI8h1yV!uH#kE7LKIM@${@^5h~}
zr@VMso6_Z<RJoNq&%ief3qvFwy5c^Z=c!*?LYIrqU2MWmAc_@x6l&U8VP6)PTGd}W
zA4;juc*i~p(D_ge3b-5WOs=N!!dt2$2xE_5PrLe>^GF^zw)@&C`4K}m#pC3fYs~_A
z>hb7EMvKjLwOP#rO*c9pD*4a=*=+qI3TSu5!odztv^YJ1sjJFW4hY6wZuky+=M4a|
zbEimj)m~|#xo<P6tprE+I~I*^M8KS20F>O7t$Mpy#@}{Ydp=90w1(Yg>C?!32~7Eh
zUUW{D$vErKvUtz2+Ru${e$cO*>%m9jMtm=(Us&k@sELFo)|T0JQ%6vCXET*;Tgybq
zG*5_8>$~FWuo}#->loa&a3{d^linAGX-yv;pK~4jA4&!>^Y8Y5|IFP;Vf(091J;b)
zfLGI1wO+5SPH?Kco=$ao;Y4;s-l0!jB!ZmRyKZJPBn{BMrZ!6!T1-j!X_LpC2T-M)
z%DzLaguZSh=cU>Lmxd>jwu2;8DgEII>IncHxFu^ir|s+Uu$#eX<*vXvx|N+3ru94S
zR%8#!PMCpH!8Eoe_!0Xc{pAmYwgtU5<g5Vx?sqbmJb4e=DimlU|IYfPgtrs=8r&#S
zB+3=_=_e%0HYy9H!ba2VT=`W*|4U^4U|U($yq_mh4sN-BaMtlBMqWMp-!z^(+d=vM
z=+9YzH~`yX(NR6FaEiHNrqxoc`cKNdZe^%OQ|P5bMkyFi`UG2G%-+VLy7Dfszdwyj
zRGuL8rK9mW119{`>f`XWvZ~EWOn%hov|1JNUW&N~wH^Ig@Y$#V%PntPaf)$g;w&}y
z%R9LT45C0XT$_sobrSk8@H`ffvITu&(pdTrF~g(#hDWn{0Da}_)~0~5tmEQM{AN7Q
zSmDE9GDd4YjbDcSpZjDMr-}yT9a*5$Vl5x@kLwz)079>DEn|bPw1mqFOmc73uOYK}
z&@`Kdnmg`gG|V263Xva-k06?@el1hW)K0UU0?#b=zPgjLrf$T}hlcK*zqz7zS=O5V
zI?W-4=|tkip=SiTQDjJrtZ7osQA-*>jv3Ei9+qKcNybf`N53~vT3zUSjMFHKP9FTm
zyNF@TOJuyane*QMQg)O-h1AtM4%eg1qB?ETh_i+f9e3AHT4LAt`<L&j0O@JB5*?KL
z!DQ<9o__P<=AsUk&8bWJg9_t*^WHFJtm##VE8XWaHYkqHA<KRSCQVA@Y!mA`OshW+
zRjNdt$b4<4D0hr{8%i-l6HMSuZqs<!YZ!5?xTK|ThmP0sld1RZjS`4j_>P@CMplq1
zQYg~2^i9N7UZyCG`c*Sxsoq^b?Sk*D`p%ANW8DuD3pielaCqLUuE6&FG$(<avc@Cg
zEk2k+f?kwYN9yt6g#-JYj*x*U4Hky$;Xlyh-D@Ehai{x!yspKbH00$ON07<bJ-lWj
zvLg`{P&iA24=LjEAL-NCyQUi2eo=99BmS%{NTrD~NqWwB?ooB&L=W^cx(<2`VS-$z
z!v^jLVT}Ii{y@4=WM6CVb~Q%Ik*Sk!af=kH2`nI&%9#lm9hV^&)2EbY>!A!>mdAN!
z{^7h~VM7%fOm8<^)o++LsBF{B4JVvxQ0A@v7VnCFFPU{^d0hh-9Oh>i36Pp<-iVsb
zJf5Eg&|_j{-=FmJSdVTRp{C-tU~Y2`*6^bDOw|6$gyv5G&v=S6GMM6K1LavCg<_Ry
zIYP2V)AUdk=+gP-dNf{w4lEdGcV0Hp&^x!@*?#v>OA58w!qCFERc}v!lCcN374k2f
zxk@ZhO$TJ{Ao{~J`db&k36J0O0Iw^H?M=#Y1hS(HwkOr203M`W%jc>g`}1dX$C5JZ
z_U4VQEeD=8<gsu`b^ZoD+=FFhJf_Wo`T2Tt6j2(kK-=z}iMlOMsnx&wVt8R~JU1C2
zY0GMyw>&l*2l(FQTvn@}g$lWdVP*-RU}M?TjXB0&0~sIPbF_GjX8kD}R_zbN!)MIA
z`g}O$XI)qWe{8G-=!JO|@*f`Eb-wj%R=a3?Vx0CQdXA5kl)zsAX8`d;bPSPvt-H9n
zJF<lzQBTgLu8yi8Tyk%bDbV@5X9u!g(EbtKW93f1toeRx(BO6MRv$j^i$h+|D3b!R
zcm<Wz?`VW%UAXe4KYTF)@#L)1m?-i+oT<AlxMSD^d)vKm#Ytmsns3Q#Is{tur;MA>
zN@**m^6NksBwO)beG}utww4o_!)*{u))@wdTdE#3k*E7nQF3p&T>8=3A_%3VAJ>#B
zYK(S_oD4Hy-Y5J7g&8{A#CQqMVYv7E1NTWQ`NO?g3t*=SUU^lqsS6^EuJCSzfjPX*
zTQ<w0Rrs!{acrq?i8K^0EA~gcyl}Ufyw?D)kO;t>$oIn0oa;@U3!xNA%!>Qo2vaPZ
zVcWj-HiD5uKI=3-olhBkwz+?nZ5)w%dqiXFYXD^uk|k8qdw*SZ?JLpg@hm<=sp##d
zdJA%tQ8e4JbJ~DdEpW*kBt*c&fgrZu0Wa$|CI1EBZ{Y&Bo~Cs?Fzse%?u)yoZnRFb
z@Wp<D3M@J$?2aylKLVkDFiNSea1Szy9;bVv(x-D4d7UwC-BatY_k|B%OpaW{0F@Co
zsEfTWP`;Cf%-Zn^{H5v{T5!T*cUfFYI4ym2lb?9aP`g$BZn{g<7#-ZS{3IfOV+Fy9
zOmMaJ?~nU*`f_jXaeFuhgRf9U_s~)YTn=2>)}PZbJW@90jF^wS!{(#rBj4FHHAV1~
z-zFFzHMA1*Ij=`>aeY!NaCB_U9;4uLp{2Gujbx-d1p>=(gAtp1O`T#L7h8~boXGcD
z^xMw5NrwWaeR}Pc#{Kp10^R4D(z;SUC!Yd5HKL~Z6i`ddUs5mF+o!k1d-HRQw)c79
z=*uxCAP%*QA%)Y)jK0I~MWhBdX0L);5InVog7t?#+;1;=Kp7D9H5iA0+(Na$ppPfQ
zpl$URb79{_iVoAv&bVyWd4S3v_{s`bUfHdUr90WgpTh3ZhGSckUAeOzk>h9TkFUz@
z&7SME9#y~pqR=D)V;uuvs}_W4{_w<;ZwrBBeJnq=ldAK2vr~!#9<#Wxj-w@Ppx-o}
z2m}X)Gh@=#G<vrz-k$MXMhsl~n^$CnSv#0&TwT!t2go*8`45ad8)(RQ$HoG}jW7lu
z;$mVclW??5r9-`p6ph`bE6PjdA+C0G)VWncataQpXXP{bWh36JgfcVl@W<#i1k6EY
zNm6-fs{};D)(UhG3S<mG8bq&TrbiXGGx);%x@#9tJQrGbec;{0tm2(AH7B0;Xc6Tr
z)D96VuSw4mQQ9ZO!0hH;M~sN&aw(UmE1_q02a;&1V<K)XGa!64e<*Z|F-s1xUNXj9
zUT<l+azt+Za(s5#J(2X~fY`JJ>epL41L3U7v)fYZ(-xXiEzdq#@iK`PY<^wioAj@;
zI+ZNP%oZ;+lK*%}-ur3vv|FpA?)N@n%@DVpVs=Jb9x4kI4E-iX0N#r5fgPEN#!x0H
zWU4!S2w~2JZmfsvmQW<MX}K2qt@qQNI`uG$Hb>0maIg2XAz(A8uPk02H-zxc^64s`
z1JA}t3Z7V5d}pSst^LSh>4t7i8DKNbub?Ag_-x5G#&!3w3&M5Wo&c!amHswiq*ie>
zO2+%VzyU)Hkd?Q}#kRojf(Vk_Qh5uiXNvNR*oLx^Gx>oad)kviT;tG$eD>5#@3Q|M
zkvUsv&+`E6`yzNHsGa;S-rlQ6CM{Hss?I<*KR1MVy@o-nuyAP|@*?7OnFkXOBo)7X
zl=IoEWBS+;(sraC1E>mcz9lgm;et)vcw*z&A~dBQuDLCHK;G#%&Qa2KF_`!jH|6ko
zna^+{9y+qPU|rNABwovx=K76DL2o%@<dfj>0l%D#z`dq=5gpDq&9LZm03PF$m3eZZ
z4RN5(Ow)LRpI0kW7hll(vbbsJ?IQ`~2++X0(1mZM(|XdQBZpm@1@7@-h4$kk!CjnF
zTXJCjK;}@p8iuE{K~x0njTkxLprQRr+YR`sF_fV(dMM(huSV{CZz?IU9|WDF#NSQ_
z@)x$hq}2axqL0%izO<WH)sS}%k%f_Iw|CK(szw1G*u!fdhi2&$xASjHWkIhTssk~H
zF=nTi=DZObrr@Zg_i$!Cz@sS$Z=x&h5p%$;Xan(+=1i3FL~pS_(y6nrPGE9z!D8iT
zE~P%Y3opZs`sOFu38eG&gcNkJPiA{OUJQ;Ve+t#H3O$AX24g$#TN_WT(8S&l=IE*H
zszuCn#x26+8`5$59We3ym7J<g@nWP266*`n#8SU9>ZC|L<A;oYsZO>EAeWyy?Wn=;
z1!>cS*?H&#ie>ht<6J$CyU2UCLj-drP$4}Ef@V5DH7HL59!hiu2}y1ruZE|2cT#wH
zy~L<S7lz=|g-i+wRyE*Fusxz?dd0ruL3C6^LVMgDRt8ar+t4#FXbm&)Q1!)}`{~s=
zYD_xSJmBHgKy0Zc6$uNNC>MHWMT!j*BA&hl4UZZhq~cmtoeAU!++@OLY8g$cOk&1>
zDixQh%5|;j8`e@@!UtM-MbNiHO4H;dbFv1P&ODKtt3yYqm%VGKE*cUlCfiCpDVSqk
z5ve%>l#VU=Sps{mB<7<7^Z^>pPRWMcT7%J5FL{kY!Xf_bn4`9sIl@OFbjkDXQxqEW
zswu}ee7iQz{H4$o_I7l44lx|*cq=0jb+_|$bWR4tTiv%j43=oB^0d(A>mFYY`kV`e
zAO5z6ek;W8J_38Sr)w)vf~~7G?BGD~{!WC8&DQ|dp&oSpsZbm7SSunV7Iw!j7d+Fo
zd_Xz)X{g6ePgGwDatt(0u6P&;uxH+}m+X{zl3aro)1coK1|=)p4MeG-x|Et0&1j+v
zOK+g$ARQhh?H$wD&w|;hT!`(xqgzK-HCH!Xt^2+fwoT9vF7xV2UEFem!uINJ{Hq^A
zDsGi6cN{}{4h%>b`!BHw;js@?gG{)F!ui)N5Ygoe&zjQs6$4Pm3GpiKvy?1^1Sfj`
zM#wl(uzN?B?V+9v%qsj+&WI8l3BS2lH<s+u$rw<-SiKU&@J2<%jrGum*Hc(|e^#WP
zmJ#I_@_i!wwN=5BAGC!kvrFz;=&7UAt%HFsh-foGT(B{EGq8Hf?qn%$R5~vHz>3Fr
zMjF$$R`rx%>uswJ5uLd_IjfJ5*U%bKt7fE%U+IG~*hUbLt-IUYNnSusDl5l`n}1s2
zaXu~LYzkRwzkKS=@DIvcIS8Rg=#wDLX(jejnO6?}u!sTiT<oh@E4TKa6WJprpjn~7
zRKw(tzr@Gz+x6Gs6e;=`X6|44&9l$f)iz#52&K0-K|~P<<9-sXHOPW4Rd?vV?OGl)
z*;uF)!PLvq>EUC^OANR~QP>?_aH@WT?zium2LC!ln4iDa=+{eklJz<?P3VNlj^D*|
zRLtitK*_Yofsu#O6)Cm%wQ0B?{8>QYF4qi|ZFlp03It|9c}`yOIbRUQ`iYBbm(smZ
zSW)mf?{;oNu-8RjZWu>Qi{mYBdT=8|vbi%OOOH{5J5IuK-W@FGl<eII(Q1xr3;l9U
z(P$1?W6)X(C78tyzdq11)dH_%Ug4eUMq4iCk1W~SLOl+#)2qL>4mp8j_Z+n{r;A_F
zx1BYUmkib@(YjdojY;N_Iw>};c2Im~Vbj~5xTBf*v0=aAX@XMR+$W^TSwU!lxn}JZ
z`teIaej4|#|B~0=Zm%Ds0_(WU63Qg6W<Jq2OqnB~@{xONsP%;}o%!L8CHRDlW=V-1
z@#u+w1{bY%jTpO?bms_bAHvq@Eh^BrV-ajn-q@cT_o>br|AcR87zIZ*B+cQCY=hp+
z8Si>$4t(U+*}JW(9}W2)p1OxUvM&Q7IO6~lMEqUK?4}JS6Xporlj0c_I=97hOgACn
zn>xY)@HKl6z(hjHq8ZQV-I=`TUX${f*?fjxifGP98sCho*>f94Ha%FmSPyUdaLGR$
zv0FlpJV!?nIl_6lW{$1`sdhKQepkMM%dAh~Y*Sqa)by_tb_B~EX6b%Aq%k5xW5?to
zSQ{_p(o}!1*cj;usIaOA9=cS~Q*&Qg?>Iwo2CMyef?FDuk0?-Xz~BvuFodyzb7x9w
zaczqpz?B}_Ydy6o-sbN$L1#}anAz~Oe!1ii-T^8Q1{`iFo5hv1T!40XvdDvH?2e`w
zPeQMa39nC{7Meu_$gq3k>?M0Gh1#b>wvZtO7+#-suf7iqff8fsf+5+(ilo?u#$uO^
zZPYoF96J%)r!s2cxlVlZzsHFhsxcd_Y@cMA2@5?qR9nD{Tu%~sctBjqR&d64Z2OUV
zKfI}Jd_>P-RKTznD(oqL{pd)LeLkagBw^gxA*(D-^92A)#Exxu>HUi%wdpN!dslNM
zZ8dA?v*+3NDce~F&7aqm_=^+;nm+Eh<5odXD4(g*#t%lE<e7gMP6O?`v2tI(BBJ*4
zN_ZpvW$qM!UY8&6(UV!K&~)=YbSgqVKyD4p)KBqd;&_dkeE~%%lGd6=YaxpzD3g-u
zm@eV@==BRdysyGEjm!%bSh(G0WVO`JcDPJAOLHia=%Neh@EKx79Q|>3<0<n`7nq_U
zVq5x}((60&IV;@zsltj=GZC$6UqUe*Gg*=RC}+v}IV*u|lU15d9HVHoE4rQMhxb_x
zU{DhQ`?<eRET6@{zSm0;kdwCH7Tn-UT4n{t2frh{Ewr-lS4`wF^qGv@?skwqZUy=I
zYwzvzyA%GNT+B~QfTR#mNW4Vv7)5;RAD=ms?kaWrc;NGC`o0EvIfVceQ>}yQ0@B~!
zM><8ReruJ|w66H&cBe<(t^*!!O>lG6dP(C*pZvKu+QNwKq482T>h_HnHS?Krs1gQA
zr-{4zu|b2Z|8W7zz1ZZx?xv$&&b!n&b`z|Dzlc<qb%SWQc*B$qO4Z}O6dg+erBu5;
z9AaIO5}k3EI_5ClBj!{3dnYeVPGT=1I)MwT>2`zr)?~|0(OSm2&`Z#>^?J@kBH?ic
zvQXqU!CTPJ;cD2e3>AHVSQq`Es?K%mEB2inpnC^Yn0Kk&h!FXM_NgnMTDWuXdC36T
zRoLnCTA5A&gI@bz`hlWKY_?4>u7iSyDXvycT4`1)D=SrbQwd?Z>gm%2-kF^O>TD&?
zsaW}UP^T5yn&S5Yt&oQ?cF1kx72#;4e5>;=J;MKtc*=w2)^)+oQ()S@QnfJU07G|%
zyQ}v5Yl?_&V9^u4HV9`TBlaLZSMvEWH0e1Bm)I+id^Qk~*oIY4Vno_qI6+jJE%Jz1
zIoORj*_4VnA^oU;&+QZ1um#t`0J~7mGD|%#;b4=3->7<?7ZQ6nFSPVwNzcnMoDM3h
z8s^e&i8mjAJa&B~N8P~|ipRRwV5b@z3TGW>(<xiSV=t!!U*clbU<#S#O%1D>=|4UE
zQ~m6W<KR@Ck?X=VfRG~5sUAU3_v}UWypqm8OyCjU<?d)*eN4PZI_CF#o=cfm28eH%
zw(i+JlVvZZFz5f-#Bf#4PP08?_2U23N<&voHJH5D=i2oKq{}EgMf`jmCNn9L_(Lv7
zs82jFr9bZ>o(IA3)k+j}6c3&6__=fJ*j+OsNKo|&Q30^)9Pr+8I&-KgI9c)gSAdbY
z2^N2u4hi4v?<CirfBktLUQYsS@+*U9g4v)Ch$FMT=;lIm&>O%6Tct-)D0tMJ*B1XI
z!~g4RbNSV`Bz}jtT!ni6bZ6N4KfdS6u%9pTk@rn*+ng{l;9EA*)eL{r(H}g27xSc8
zQHthJ!6%#s|M$L*(#VqYXUF&*yskGQKlXbrqAKlw7A)7`cIO;GnM@`vlLUS88j^=I
zsm4pF?<z_$asW;6<#1Uzn<k47HO#SBc+PW<x(HNa$Iy83kaAlY$`nX@C_gG>j(>pV
zIE@xHYjX*m+s8`Jbr;J!;3icm_o&h+PopHZYOXY1`gpMJPhRkB-6&}ltB}8`Kp7A+
zg55zZWx+$iTOB%ZyuQTsKX=K_04JP*G}h!(^r1N?<qb+yZ=<FQe`^ZB9EUWb>S(El
zoKeJ+YyRmlGVwMX@ycj_Maa!<i8(B)-j03<mnL^}EM6Ve_Kp!uW)BEY{}Qu#h4SQQ
z(B{k=K2rJQv=HSG7*^T2wSkYi#o|XF1*!39rA0A}QF@b|(eEWah6qa0w|wwug~gNA
z+Z>xSgz`4BSu?dJx7{Ieb~@&<y@-f+_+W0>_K;h3+qphT^38sU6~rdax$}`cjrMop
z68P+X91N$=eBE%+Cq;0ZFZxz*hcY@m<NdUlVeYKrQbbR*-u$t*Q>QM}@q@#u&&O(j
z^+m+&>3zo<+;JZRG3ceEPc<36pxgS{^x|dnP|%=yru8TSPvrK~SpVG;IfPfEd$@q9
z6M+h9wYklil1L{?2SE<mkfE=lgDZ6yZyuk=k2Ol4<()kMd)=9R0*568W6A0Bk)*1f
z4ur~I<7l|ZaQ(*qz?)!#Z}pEe*CtY0^-uB<O`2>KbA1ozm_W%0Nn2(H-^oVuUcu}i
zeq3v}s>So<9i9y+kRe^7h9Xp!NLbX_l}Rg!Y|g_%<0E>~;$mQ)Jrw@<_<@M^-x_E!
z4>Bg71G&D5@fg<?38qbVF(5;*y1Dwy#E4}6?h-rz3ho845Wg=AI?@1pj^+K;3VjZ0
zer-f>59;j=dUsPiLxv!qN@QCk;U}vVNLaWO&!FM7{?l*IY(91vQNAI!a^dt3H{KC|
z>w$71`DSNI)fl(x*&J;EyT)A-vYG0-*HkH4O->zmuultRAPqXw(f0&WYE?}(_;qhE
z!131noz|7Dn(4?te0jSKk=|s5-7?<9-6w{`_l8X&1^RQ%Amq7ooJ-lSBb5qxA5U5B
zMiQNyI}!ebM1D}9XlvW$0K#z%5+p_4${oz#l`+kUL__C4kqREwsV9(Bv-W&*;kR7I
zQ&C@JFocRaPx@>ppa_Q|kpxGqklG7vG73e9)W++tMWC9WJ3L`lydoT`#|d?3GuERw
z5*Y`F@3^k|UFs}C#@7^;giNcmJ~i7^byyf9Jj)I)SKL=8yPM}(_#D<0Wuma1E0M68
zbU{>o?G-U<j8K>7_;SmG%1<b4riasz=+2Ljpfm7aFXWqCreVJaCHv|Sp7+b`Y6Yfy
zCI4ANwf>wixY0jvEX4kNwZ9)T>5wAI6LIP2&X*ldolH>8-;AXEf%ek|3uuF}db1P(
z(}FtMa(2$m(7@Mb76L&ZX@EssoW3ayHIZc_YPxiz5+%c`(NW3`_W{6BkFGdf!j0`y
zuI^><9#PEs4DZ-!06k*h3xFL><aO&Y5@w=ZsgGCGDCk$ox#IvdkO_*t-l_?95PZMA
zu1(V4bJl-=x0|B(PEfUiGJ08M#Jgu}=?UtnWnWim#G#Ag&1q0$a`vO(bWD|^PYP}_
zEW!&Az5(XqdfLJnqQMh4yc5U*jM>}YKixpEHN7yG;=lyo)ZW|hG3_2xaKs}zc(wGV
zvr6><`F3@YlFpp3?sKMH`yaRXDaK<U<?$)vF@c1DT``SVeJ;yhO;^v!TQlNYTnkRW
z*Gg>UOqvhE2ggqy;^vz;lNw?t&EqDyv9Iw0a*HkG^oG0}V-VThDF&U6LUo1QFTC^v
zVV?jiJWL5q&eqwpwcLd56<yVw)gu9S@)!9;roLr524rsXwCt?Iu4??1^7|f-MAK+D
zJ3>C51|eX-%VbzJVgM!qnN8K$V83d}z$x30^2_;~;c<U1*I^V+wq-r08G0ob1C-89
z*WaOC{Or8X_tiY`$190qq}PEB=bDz@H95XQZ`)NrfzBbQFi0v}zmb{DJI-E2U_B-_
zKEn$?d9*URN~*$OR|l0)9WBBvd6K(cAjLNxXInu8PWP=KZ;{uDoUV7WJsl{+ms{<V
zzg%o($mN5&e>`Qg{;+a$ZlMej#190ib$Yb0(+7re(Pv%?+1GX9eB&NWcsAlf*@@Ay
z8f!zdZ4qQSYa;MOn|UIh3=CM+YDL~hjV`#?Z0seDs!tIb<w}^j_y?voY8bg{3-!$p
z<_RpW|HZ73Sbh+6+1-%m(qwo}ooBJxmYe9zrKgbEI!{XA&?iB;>W8vE#=Kz=S@v$5
zmu<9eQ97=o>O4;&dLQq{)(zX`ElHw`pPcR27^*2~`RYDCJ6i&WAjDM$#43e?4?Wap
zo*m%aP071BV59dGwSLG^*)sI1;jwqdHey{jnjkVW3!a1mvuw}TZdRmC@@L!+(ffG%
z8X+G+f~IbJ>MHJQEWhgDs!4wUep^opJjRUfq6KrWz6f+ET_o+1*nj+tcmG=a1BTH!
zhUTb3D%jI6-nZhy40<dz51Qz!4wIX~6!y3QXLz|RM!a?PTLFibkGgJy1D4DWv7uB}
zJCp`s+AruxV+=~&)hA7t0#vk$dr@7j)L$XkI2SLD4(g90M|cGAc4pm1!=rob@{r!n
zQS%N;uBWY0TT@wBr%L$<rIHz0!-*z%6bsSd;?NX&QI(nb{Rq+x^mZLGTc`tf&qtmT
za97JQ646oHMmpTx(-A_QI^eWx!Cr%xYetw*^@=JbX?%L;l#{iKS9U?9P4ZlO3jQW(
zJ-2ps&K10mE^XVT{#i#AW(NfrySdmzmaCw7{R?Jwo~k!Jv6jNz010@JN%7LR=Qp9<
zS=syJ02(pFZ7bAaZt?5K$#p|lIbI&K<-}X@rP!7CLt{Os40I#TQmy+I-Xl(Lbk$1I
zx4Gogr~)2l%q!lvh7LL8EpAvtpDK1*RD`KP=ZETQH0NZhF`)9a!nP)M+qX-FGdSmH
zh}QA`vJ-t<C@rC3%^4K3<A9R-qgA5=R!;@E?;LD6;3NYHRsC_&5klQfx=mMF;vA8W
zIe;J4^3CCmyoVY16W8+1YpC_bd(hAD9TvhFP4<_-m-u68M`7UOl;-x+oh^~qEWwfo
z_8rW*-Z)3_>In#}*z`AhI4`MJtRC5$m(Vp{H=pI%J+X}QXJ+Gm!a~`eyQHXZ+9`^{
zT^q?cmMa|N7rznU3p{HLiC=HjDv;egi!;up^6^N+wM&<1R8_k_ZeVPj4kDU>_y2(V
zAFStDd1eQ5=>cBtOtxmb%(CSji(KS3#M+-3bZHfI&L~6-JsYA1^XfZX25E9w;7#1o
zErz+tv@;=RHLSTI(yEJ`Ag$dkZsbC6d3&7d|L}{ysk>9a$nG!#_pBLDcsMSZAQ?qZ
z6}A~2Q}Myl+mPt)Cw7;e#kX(ltSh*5R?^VAy(9wZk6V)^?*3Vy2Zvn#ct9c({u!wm
zf;Y4w2irF1uXR;*sBH43p|+^mMS}XbtC69O%4^AEkpRn%1lRT>2(P?Ta^;kvREzXo
zhL*l?<EJ#+-k?>>rPm$F5+Jkr{1tQ=MKC(js&%&t5nkOHM@6W-hV6+9nvDfmcQ-rb
zM5brFvxV}uyg_EQD-LOUM}%w4(1gERQk}i(XVi@gDu^E*T&1~X<&5nX;6M1qN6+iE
zvtC6Ro&w11*xJ-k?O&z>v3=#V)m(9MyqGP$fnR%NoU15Lvp}?u$ed}aqV^(Bd%mtd
zk14OO_4!wMkf^J%9BY*t@gzPXR(VOn?s-|>c>YW;NmU3jNul7_r&i>^lU=mKMH6@5
zxJ?N)>;?ab0?aP(s|0*`XV5|;&h?;v(Vjif^O>C$RMXzva&_z53UMvDp{S~wL@EbK
z`~VC`oWqUzG0XpmU5oBtH`6vHK6m&jr2jHK+S^Dj1G?Cx0`A*F&Z?THEM%U3m-7&A
zRJ<!p;we=Ny|W$t&>l-bd=SEpd;pH^Z+>rkvL;93c(Xi_{a3DhO~utXjcd_WZ4vH2
zP@w&rBmS)V%L8Y5!qrWCW0f4nikse?{adSKjQ=Yz^w1xB<9fy^CCM9{===W1!vFvL
z3ln86lVjljT;%+u{VR{K#{X4eBz2M~gz<k%tAFQJrUI!*{O?Xd?|-WPs~^1?)~4&B
z&@h$M;o%-<X)<Tc6pop*&qEW`(#|t5!O{B0M#g4||4u!Ao@?%!zQpk_;7`@%oR6Ox
zW>WpBp=f5mY<e+yGZ^gsR8Ti1@N?u(?YuwQd5=uV&y%^ok`bnlh;-I6W3%<gJenYE
zJW1<K>~&`EV`IQt-1k*ARJDY|mW8*1HYAe%&<(K0a!-6oGNIu`@e<F2`oAIkU&$6d
z&Pg0@Z4Z{S<;vXq^ogIvXtb{6mA&2dqN1FY*@(g%Y^zp~6U%#m@7+vFrB8R#?X*h%
z*SeKkIAz@yExaecKJlE&%FdB?p?>2KuGAKSPn&A@-+XYo9k22AK?mf<K&FB4le@wb
z<D+o#!P#Ojf;{ZE_sS-t+)d%!iHWfuOv7wRO+{kg2Vr^783TT|Ti+h>@>t7<P|LbW
zdc>N2N6NU3G{y$W<wIr%-9{Yy7(%8pJ?{*<$-4A`CvgL=zbB5*>A~mn^Y*WDBk$MB
zo1Vk(<Q_sc>p$DI$a|tE>phy5Cp~QH-0oNMNM;)d*Yy#BpTp8Eaus&wqOF2f-&-lp
zYrR<gT`%q`B$THfD!S1yzBBAzP+U{?R_4OT>WZb7^1`l|Q=(W(Kc}_D>!1}mT;p-A
z<PJwUE;qN@<$1%n@)y^kf*p3Xs>Yknh3VT(sCsVL9%sAE$NDtnT|!k(KTpH({Fh;}
zdqJ*S8KDG3bv&XtE~sJZTi$(-xBC{2!bc$p@J>{%U12uNGxhX8Z+qTq4bn|Bwz2n{
z%;mdDb$E(zZxA<=HajX9$S>CW33L$?EvmWNx3Mv9+Tuztmn*+>(7dnOJSVr_;1wH3
zeMKFmT@o%byhHIWQ$JJb8N0{w^pKfa)#3oJkuRk31H%p1@x9y}w6INrr^mL^ueb7^
zSAKo4`@XHi{75~%vs=-vA-z@vDWZi|TTlOQPME5hwh$Z<8^-Kt^}*Q|z;-QNi9Ji7
zL@s`4Or{eHM%Cp1DWS@30K3iaUTWQ*<o_u8-of=!rH6u<iGAO}2Vt(=ycG8d2qTWy
zx@TJ-DVtG#M5M%hRKgiFAECXPGL*!>EK6TDa`{vAQKra^w_!?=MqE8Ext!5uCq*S^
z<gVqE;)}^&l5Ueds=ok~glB0{j5_U*(<;V_FlEnUBSpc%)3o_NPuMsYT@QU3h6*E!
ztd`g0m0w8*Uj6-qGiI72Z0)8lj<(RnH+<z1G-bjBDN<WK?-4FNl{4c%^1rN!KV*RU
zx;@E?S|}1nk2|%$i4^H&E<ehA1ftf7WoPf<{8`NhaR_@IFl#%A@I;G>i~T7pXlwM?
zK^upWsa)ZbsFb!nb{|&dwZ56Bj|?c~%Hjy$q#UYL%93p%C)sb<xM?4^lA?virxcRy
z_{u`o?#+6^f7(o`Vl~rdzuc=ynUMV;>#@L*#?3G`w6wg|FuD-84RstG&6V0x)(xPC
zRpb!ZaZ%ke2cF!>RQrL?YrlfdTCAQua$0^3eKXu1rPD34vu4RfU2s3H-SUnd<Uik^
zIv58S9=MTwb-DJQq$_4eglv0C)~F#^ie;Bpw9f_bid|Tb9mpyPDsyyKYir?w7l#qH
z$2{oQOdkx)wTE#|mC__`s!Z5e-ga?eyZ?RpvsQt}vKqW(KC7{v3;tM`u_K$yO>$xA
z9`&u^T+jo$%b|n|H}*?|M((`&O<D=pvT?+c>mI;SJpj?1vQgFc*5=pjJXHL{lExdS
z;fG%BPHG}I^7}08mluA!KZJjFeIs+M$Z-?H@fQ1D6cLfsBq#N*Y3hW`;23%H1}Bvq
zu4=gee%cjg+viv62}xg&be+sG`Eh&jLg@D9Q$)_zBT1O{BUrKbMYi(TDx+bZA7N?=
zf8NET|FuKT-?f2~B9>SC5>P#4;yu|^=%B>j+OKk=Ec?9+Y<r@T<zLGZN<3Abd_?Q!
z36{n)l4lBLNu3l$-RxQDx!{a>>{T)`XbeVh7(ML6a4kbKO}+AVRLSJTtz=f>Y(OoG
z*Qptm<JVS(iruy(hThiw<_hLE>C>HA(PTPUc=lpszSgCgoXa*`=&Ag!dcV{VbEY5H
zaAN=G#m-dgNUvj1Hq%zO<EOPBXZhy2r)(Sw-@Kpk_iw+d>o5r07}@U3iB4>gYUo=w
zZT-4$S@HdbnS%gUi|}0ke@>_auK`uC!@Lq(lwEfrI*h4T`xg0<jt;wmNaC09!YaGL
zHB)oF!hyR8E)_Scwq9&?d6SgkvjrM<1$mP^y^8|CwqLGwjZQy&gzd5~y!GRfO{7zp
z{r=h2%J+BCkB7>hH|20%PJMe^jYluV-yS9=)Yg4cy11$_f8hfl+WQ`9Rm~QVt2moh
z2E?8Wd*QnXhVFJJV*aT)v)hbx>cUgr`Q2OxgL<1Fk&zpO3ol3pqw4+*(lEV>uAML_
ztj}0`B5vQ{W3lYz|K)-ImPr`TtMK7V=jqa4Su>ZBfd4^Mpx)i;%_G;D{h`JrDD8FA
z?o;Ket&M(dQDkNyxwNB)7Ul0tOQCx)(wLOXKF>!AUR}CGI%AncZ{+%kV2v8%p8Pt|
zu_k*O_-H>PG-6z)O4(gn)>OPm3M>T$`v==JNI&#<Wv<Fqf5GX}s>TD6{w2)hhLRS~
z$?`P;dgmg`&SJzHpMTxlSYDGwsd9X@8SYyshfG{`oVXZ=@5ohgADYY9r5-1=tjWg>
z8lDLKDj%84?=-ewdZg=yv0e6fD2pdw{tR*-N|k;40<DnSumerTF^Dd+x2tm=D}(;1
zm(^RuoU_Nz<$&i1K}6*k6sqS3@@D{VKEM1lM?Flr<BW*4T?*VG*{#ut<@}3H^b@ex
z2P;>rG>(&NOkAVsf3%}lkR2o0eY#iP<>ok;bw@2NF<_>%9@%h~681hoiz1_~QwB0K
zzlM#29}aek7`Q#`FfIT3YMoNNLW1+#_i2UgMGucJUuP#m*Z&BtTH@S-Ij1>ff~9KY
zDkm`54<qw=s*f(J9fOx&JUFZ8icMxo7D`Zwuj0P>uJm}{_1kJE*cLW)V4<8x-x0(T
z|Au1vSXL1h_d7SrzTfxYyB25gn8}{_X5Y(h0@S~LzY_WV@-zRAa0ayrG;pHfsdLTK
zYQybj@N9c(ZJ<=2N0@l>V>aAC+~_WcOT*|sC;K$=BjM%vxW;k8-d{AFq^h!oUKzpu
zCPVe3N2Jdp3~NB&y7%*5=>Dfle%XsH&)2$s+~FI}^=_YdN=y@~yV1+w{d>%K7NrMr
zqkKy|Q?Gpn$i2d)1Z{j9u(7UK()=!e_<pNROOEXE{zB0WJJEz*4r7~%>pcG(=}&tD
z`3AWK(k&@+w7SZI?I;cA{&vi>|B9Vm>SJwYQrGP(S;Kqcl|_QQBR50-g86?>RZQ<Q
zH&HKA7C7;RHQD~DkW3^;vWd;Z);m1^89GY_Lcm?~KO4~2?y>s+mY@F1{r~z-Myptn
z=)c5?^fTz*)E>cBxtaOj6$;JTQkARxJi_CoX2f?}aF5Bt-kJ6Px;yhSV-Tr*_fP&`
z1DXBbrn&p!U(4d}Di`nn?-Z8Q{rEr3sQ(``7V<AQk;xI{O=n9NN$7R{GA)uZ{WA|N
zJdsz{)Rg#0X5z>6MER<$Bx#~Q)%U7V+4tlXe&rctj$z42os~K+5)K|4t8-I+t4wL)
z^I3nEVK?*hOTbINP@|d<h#3w3u|x4lD`~QNgdZBP2iJkg8G^bdPArV6jDoqjD$V!!
z`3bE+8g_d6<i}oKAKJrPT%*?pA1EgVsv3eUH9<fD6YCxX&kyq6=xB<hq<gK$o>`u6
zNcr#6r_SzSZGd@YUyWx!+|SWjZRNV?XvLanjv8w~Y@)OO)@SVMjl={D?g6_oC_#iY
zyc>F4;-;MZSBpYz|9fU;Y@<EnUveuxeiY<28XX(s_-J-fyr{L6UPtKtChIqG1NPc_
zuX_)qs_XUyE{83j=jmm29$sG2ZYax!oZY0m7ykIZ%f0zPU%O1A{;^4RNf$rNv$E7A
z3b5AmF83X({Y#p*lgT9P&rj2V0dYOSN&g#gQtrv0QS`Yr`p?gwhUoN%dpYOzLq?kp
z1R}eSZZPH8Q6aq-`M@e!hJ9ft@Il`jJ@>IOl%6WDk+`IUc>KXbb3tI~*U!<LXqf*%
z_+rUl)h1x>U*Y0P=!cvQsjU`~rzjumB_-PeL#JvWB9e%R*nnBPnie~D61V9qn5oy=
z09XFqzF293JLl+)9y=_=fi-b2-Nt?Gj^XjpIh^s$UNFaCS&riI`XWSWH-QB_@eo-;
z4A^|od5e-}8+S(B-|{!nepCqMVxi7xv$_|5`7#jrY*LKx!yWw7ac|T&jkA5eD_0)K
zpD3)ql~}vu<a8~bk!z?(i|IpaD?{WL+lHFCdZbOe^CdF1W~(~4%@B#L_;YjqcDj04
z)4wy0#_rC|@_L!H;6_w(7y5boN6;S~NUtL$%QK4}V16h2VcQxuj`|q69)rg&-knf+
z^*US1@8<*qW;T6E+-e5{k%U&nlJ}~qgp0YSX~g=v=t{4?d?6}{qew!7iW=vBBcGrq
z;J0Y@SJE41dSRPr^cU}(=LaL9_^s)R%F5Dq`^vw-Fs3>wISB=I5-`$Gk*q#`|NcD&
zRr7)^jj!9OJMOD5w!~cKPm0-E^I>>FDz~Rvq_0_A?a@xZwKaMs%)^tCL*YGh<yLMo
zb$0S|`!B4<pFe#nX)F^ohLyG#Oin%sKEUK$xUq-%{$cU~Y5T;)#I9xN8CxN1*>P#G
zh67uFBmNB3r5<rfadewgcS{8n`ck$(A|~A~P@T+3P3_G-*Hg09A8lMNchdhrowOdK
zCNw`^?aRkc&3cjdwjIej*xB9Ja?z@!W>*<(I>)*7HYz`327*@ddizqjaEEG+Q60s0
z(eFJRzOmB|SzQw7H~N4*0Fn1rxI=@_UyY}c@){5grWqLDz8w$Pqn7eouNfjmqB1j&
z*Q<K2uJG3vl>g%byeGb$dDlMI-R!qff;P9fo!PcUb2u~UJwf1>-j(`b_)bqti&B;^
z5JfNQMO9>kE!bO|P8QJRrH03)%56?I5Z7c2)5DIY&b|1+eaY3;Ks|zg<$fNVraspi
zKSNM@U`^^}{>I~mcKz4>6mUw#iS?(=&qav`_OD^dEi8DDB9_~jAze#9M`mro2FrU5
zpDHT{IrQ`dS);C{TUc0_TUgrIfMDWvbl`+CZ!^!$DiD9f>LWk=7AYRolC~2ref|1%
z(dv&0U@pXm-3Hg|BV*|XL<Ed)qJ?B$&&FfS$PWp5{kTuRfHovxI2EsUD8;OHk`A9r
z4GYGXe5&=R<ZBR8K9((9gIwly%hwb9xHS`IHD2bh%!~X|jRl+sc5*IY7-GWR=OE^n
zz94Js$$-b+s(ro{T269mB<zgtjU~yR794l39P_HM6ZV^9g%DCppIFKvpR#5+hQOa)
zAV_J0oS*$6JYX*NA>|ar%g>K`4!@^hTi$9+vrgGtSm<w75%-*aFW4&XjTM`NZMqiD
zthGHAD}Ak+W`%E_G(S~bFxu?m!VkOZ@FK~ZN9!+q94@ayzmWh1IWdOCcedIQSu$Y8
zqvJHI6Ls!0-P$bySVNs4rMa^?EGNo{<R7?6BYpjyDwvRvkhxWP#G3o{k>Barm^%mR
zcT!YS?%gOD5V~ySx?WZ%CN9nhmJ}C1|2yFKjw}_rD;jCPa?s+o`>pist}X3{;^HWg
z!h*rgfZ;{bRT*4V{6u>jgsO6KLAG!ca#=l`6e-<D=G+@gTDyYm+cy-C?a!O|6CHxA
zbj?-)_r%lt7g98c><A4!=<dCHfyWa~C$7scz|$~K<}}ORZ#!mhmBXpRPiM&mMjY1<
z=e3t9nYg>hDqJ|`*!MZ*qbZ-kzC7yT%;MDei8hss-YF&?F0uVzRJ~<bT+Pxo90Gv^
zO#;Cs1b25!aCb;>cXx(CgF6Iwx8Uv&++}bd+<kz-c_;U|pL4$N@9b-KOI592U8}lx
zR3MJoS`xN(S^4U=0KuQ8k~nxT`Q=V<65C_P!ue6G?Z9twX79rvh^DRRDvyFKCr&!G
z_IhQ{@n3z!@)_zhgAB#Q-f))=+Lo7&a6eWyG$alWOCKH`xtVa^3Ed|#>B;Np5QU2V
z%n=DzR#vW|E2YW|sr8sW9Q2yw8K9$~F&Lc8`Q!L86ahBDWxDOWF+{3LN*^>b%Sn`;
z#_M3-n2?aj>T)UC;&#?RSNua=efUirmE&dT7BwA%&Ga2I0Y1L_Hps_hrQ<Kgo-ZBQ
zxITJ1Z<`5D@A2wI%0;%aVmGR*GTX0z<+NUiap?SaPNBV94&$lz_(*7ke?)3YHdc4&
z;9zXPb2}e1nfFe+#r0%3oT<Hg6)N}#c;txYCV${`Y+OjV-|4tVR+deN0=N<!$t>06
zipkPtO@xCk9W4b$JAj2N7kv>1UX1DC9hPjpqf)$=DOPX063m!4L1O$Tg_~-T`rR{v
zWgQ#pr&>+#e$P3aD^Ri7{?S%%^6UBSeRWWi2tdhL&q+IIq(iB~cxqYeXL#8&c~m2s
zFk5|sS0fX&@&X9XBt;0%8%S|^pRcmv0>Ikp`SlZyW8Hhw6lBjwKgP$3P#*j)FCFip
zM<M_K&zm>ZD`@0JySwBrE?OG(9%x!*g|C*g>cGgDJn`}I?-j_YG0=1vE2+WP{+`nn
zoxk!?FaS5R^YgU^TjCx!hf-coQ99qEWq0nb$g-YB)-1ZLD%l{<i?SK~pdij@A(weh
z=rwFfNddeZbD|vH_55B%9ePvAD9yL_4gTI?GkBoJvyV3Oal*-FDygA{D(g<*X{Fg^
zRY-In_zi}B#xJoURNPLF7O4B+q_9g?+fInCdb#e%0?WW92!#^V4&>7H@nUgXbs`!0
zUS?gtRiTlNAEwo6iRPknuXxaojt)4DYd`4*(C^9+a{B7OxBHWWdhj|tICD5Y=ari3
zWUz>YdUx1pXGsQ;{o_mr)`{kNK~x_keWM2+-Q=y^<xyaX*DRy<Xe#3#s1x~;$SmEJ
zQL94~3<o-4)2*%Rur}Oi<62~;?-V>Pg}JGbc=YCil7!RbpJ&zhBuqMU2;A?7Kw~F1
z*z^M2`lNN;Hz;-mUkvqIDxaiUM{|-Z3n%3ksvOAp4&9DDG7cyc;^QZ4%_aule1YY6
zFo&`pMoEHxeE*K4k*Oebx!QT`)nEf2A4MWYT==9KQRehwZ7O(fpJqannE214-x{Px
zuU8#54|Zo$98mWY45Zo18iPTKb)2{HbZpjLqUWh*4Xaz>)9&>A>PgmLn&BK#xGSFN
zd5BjiD;Vrx6m4WC0uRZ|nh?X0%~i<KZF{<DU2&L@#b(l2+Vql`$Vu+;Ws%L`O{}P7
zFpi#gT2vm`)nT#(oPZumP|oUHKUp;p8hvZ~^oq{?rsLC}cZB@)m91<I)}|BAC&C{0
z(RG0^=1Q5#k%>~2IbjftPC*>)=A3jRB_}8Mm#MY5Rqp02Mo+G+tblYZ-H1|i_May!
zD=Ukts~s9y0bw#>FlMk(-njO<Ehl*`-Qs!k{quRh2s%%|<>jT$07{bGN)wBjP&cGj
z?4+ooBI@^V+QY*`b8Bl<{-kjREyZeqpP@>YTsEfDg)=YV(0$#pP^yTHUd;X~?;i2Y
zv<Ji1YZHaKIWxiKy^4}*7G~>~n%}JDUSeW>6~_a}Oj}hQ9fDil*X^HS8-SWK3v27m
zoZvmhAF6|QdzpPwRKyc7UT6CC#k))cLhQB%B&nqTkqne5H(CE7e^MKCR0y6Zg~^6n
z2Oo>4%ogl_KX0Ku5wWBi&~H4S8`9COt&cHyE!1pZ=!pCxn`JZ}N7-{Ym>DWd#;Z4%
zL4-Y)8#fvak=DJw5z=3wzPHxsS<&>BvtFAD?0BNx(6Ph4+$VK5uo;;!al2>re5;cT
z?j}0ni{f=8Ptv=gxrd&mwbmRrxbu&1kOix#sSORQl_tMT{fs(QZau2<-JC1eDygU_
zG^^BYRTo=rav&1`-k_q=IDgk0GnRNlhtV<>x+==J)|yahY3ZpTVY}594kLh(k<pxY
zz{Bdo0&X*j{=D$}`ucjmy{S8~H=p>vBsY0Ki6e(2<8fz`khGqAuIW@G`x39VvbbJR
zzdC&$fo~n=tDSosHM@U&ZN1VI3p17u9X-`1NYCjRDi(;z9FfZV4UF=4U-(dAv)lk#
z2S3XjeCguBq+-tY5#qEi-pK3}{IddReUW&8U7wJmu7R%cj40DUIN+c{$%ZS5)wRoD
z8^}>+NUu_ax&y!N8!NK-c$+o#9Z;b&m@W~$^Rq-HnRNz?TmR*X5?jziXd>MkajQu9
zOb0Ileji@6Qg{8tXIGIjLgB<`eM1M}wd=L^{QdlR%c|+Bjz;!C14UJ7wLa=kiQ>R+
z1t499u^uIbjm^Cx&|+Z82MY`9JTzLTSl^Hjf3lMV$LCmB*L$b_iBX2dTmS5N8d9#U
zsyaH?a;3fZgT6nCi0?V8oiEzzr~|Y8<pXY8cHb8VdQQHuF3yFhz>8DSUh;AWMf)XQ
zsRG&Q{IRKVwsxnzH8ayw7!Mq6pH6v@<zsU*ZBa<#JE@zLY9UA9lAm6H8zA7!?&VDG
zOSD0FI{-%(I!h15koxS0@Y=uk(yLR~dno<d&3n&n9CUZsI0*&|c~b=bWNciHtM-05
zJ3FK5*SdDK*Y{mp(`{*O4b^L5*T2p@J#{#W;$UX>70&tGzfAQNhEHBzUe0cAn3$Nb
z;wXK%?4qLJ<wm>UbadI|sOp2$vonn53<?K_tLvL7Fqq`r=L6n5X*9Qc__TalwZp3U
zPB!MRB6(=Ow*?oEr>mD1NSFh<TyX^=em~VpPdA?8KFw&`e&*y1vhFc;wO$^cW6&U{
zD&I96Gx2siMzCx5O7G}cm$Rdi88F^G<PZW~FE1~T{Ay~71!QDoT!EWKk{V5OgmbbX
zu6u*`Pj08@7v);0XlO%T-`<i2yf=h<dqd1TSG(Jz-D$A*q+)h(cD8p|f7ILGKQ%u;
zuzW_imEkt>(;LIf9BeyRA+=>DlvO;EBiJ&~#@eK1X>oWp+6w4{`c$r^vCl0X96yF=
zQA?eB?>Nt;uUo57aaAr{(0hj;)^bV7DgnNi?)37RHL*+;xKYW~e{Wt~9vGuzxB|!R
zfA6f$injUQ%+v62CeK&jphYj&mgN4}prRrpS8fLYyGlf#?Ix6Rs|~Fj$yu3gy^DIB
zo1ZWs;Yzdn_H(LrOt&IaperG5ZOfQK3!Pu~r5QZcVO(RBLOy}(Q#N)2k9+l$etS}2
z-|D2z{1LPM@!;htxOZScp`$99rSyB{=J(1@DTRqm{1}yL9^jdM6ABge?27ZKwppF<
zXyJpi#nw-Q(m3U!wv10BNwqXq@JW`3g*t52<s4Or2HXdd@>3U}@@Tjpt&|DnS~ZfA
zKj2_)!9}87ym61l=XSc1;>t@&HsAJM7&hg}c0b#ZBCe0-y}J`i=iQ$o$;hT>EICSO
zq}a8ahclkn!PQy(s()ILPWMz41i11nbhYOUpMyI|cdo%(XGKdB+xhI)-Uk!6wKLG$
z%NJ;x7>?pfe0^-z%T+K)zCZVBv{o;_@W!z&?t_w(X}lTf7Xx>9+(2QL0+$w`2lsc2
z_EIl-Dk6sRsMr@S-D;3~ALj{sfOPOboqHb+8k+uu+hDt^0a4l7H6b8IZO)V~-`+k5
zTa-;r&gB3KjYW}z_2?FBKx3_)ZB6?>Ltl;fqtYH$wr_Egc-q4yEi;@28z@s_6|2(L
zG};=N#5~`5sh1^lpW)=vyuk_%4i1fsG_kk0Z<r$MjR*-1HF4+u0lDSt?GtObcdL4S
zwI}`mnJWcDL&KiKfn%Ib+Kr`p0(u?Z`m=2>uc!3NRBsb_xDKVFO7OMfTuy^mqFWEK
zf$7Em;o&aWTe<guZO^`0N0Og~ANftO8tu*LVjmroxA#=`i6Lu&@8<gY=W3Zv@}|$b
zZ4{)#77A`S4u{+mI;0<if)5Ueg=o*Ur3Q?*Q*r(p>^&rOPeA{YWU5l9wX5FhqjOl4
zJmd4tceaLlf+Fw0^r0ay_l++?KG)x`M9qCcf%z%w72ql(PjigrnnrOx9w+fpRcvBH
zT>Zt%fY>gifaKCdCIx+cea}uRF988(w`M$C+~ir>wVs|HR8-W-)ty47K{Q}Rz7ebA
z7z(U;;gCCH*k7w&hY8bjawHv*C%fao;K-uMkz;8nS*7rY$OZa^Oj7liZ(@3OT>kLz
z;kG}lS={=1dp}|lh<H9a8g6YKoDulc65<o*j+|_c{~<CoGzv{A!2c-%YZ4883cNg`
z7*ja!L_ri6Yo+^l$iky8EG*T%y}j={oq1$7HxG`EqFjFkBs<;T-{)ln04h86E+@h9
z4~lJ0MOhTp4!!i>S=rgii2z|dJzRrBzna`nR}L^VID><N_fJBflOmdbMTHJ>Fu~sZ
z_JhTxj@2O+HC7e5Esfjhl@vBIsVIUhAbu~W>st^al17d3J6MyUiWv67vX<uVAsacQ
zh?H+B!%E`*)44B>+gisnXc%ZLuqL}iNdrQ%X^^nI_{sXE!C1od*#A!3-&n(7$LGL1
zIFgi+`&K&po&;y&&-!QiqHy(K|DYhcy46Q>>4ez)HRWszB&@*y1i(KbN|(r>HGG<}
zyx2?@97(_m`@2DbE5(I_18Nik)^c&FUH;NN9F=@#PJ27q(okj+c{cUmk^P;xx1_rq
z<*pQ2wDjwLs7Oq<f>2>D{Canwx7U6`Aaun^;Y(T#XARH{onX%FJX|lqe%6(NH#Bpg
z5KFOb8qB42@LpK-tM=oRIn_V-{7-k3XbXPrWj@g>c<sK&kMx+@`Gow2hGvK#a#hq!
z#S&}h1w~phuTg0GRR=(4F7P$<@j0_D5PACn?xP~szrCuCp~gba<X82*OHqi6iD52q
z+1lD16gsC~6%crQdby|6(b1`m9}c84y%hW3Py&*HoVJ7OP7{J`JNmf_va+a!0~j&T
z!5+5snm~qbFKSDTS`$nu+D<7(J{Oz{2fmtjAA|!)buHPEKd2@xOZ{}bEW|S0(6HX~
zt|qFCaT5GgoA4c_`kPKtYaBuW<<d|{a-e4$<YXa#xgk&?N74RvI*|N89X#v$*8s3Z
zi4a(sUQuzHJtAu&y5INtC!82V8alt&8a6|i?}3Q5YI}dQf=;-$a=?3oSjs73gn2M{
zWcXGMBp(#=v(NPuXZZq|XHSI`@Tp_@$t(OY`0zi?k!LrZmur_8_?(W;(62NZ2xt&+
z*;mwfh&MD&ioxzENYn{-%kzLrv;lkUE_aLEcm7~U&AV=*HfTx&&*=W&oWjfvH#JSN
zz6Lx?iM8qL@2@d>;Cx3NL<8$4nsh;UQ0<x1+%8u$5G6QsWE%uOoDC<o^XKzTi<>)C
zSYnXj$cf>2m%Y!V!2$9SjS}6s#9@}OU}ni18vGwe`o|8rr+yFfxr)@3ddw>)2WMH;
zHVn=mPDNNkj;H`zCs^^MrWn@ady`M-v`q0xl_kmMe~ejw^$E=A-XcD;h<H^54v=`i
zisTKiyRH47H;@MW_^kR{5tM(RL@R=E{KbnJG0gjG^_IwZ$CJVSodAa8{t!F+d-m*P
zbLQ%_>9)CMq&U(KN7a9_4O;8tms~XR$INs87cipi*Ei$VLMiQDQ)i}4hPfHOt#Kg+
zcC<HfJMmdHaW(T_bHUnL8Xx)!)D=sGZU5`oFqjdNyV>PwZx6KgM#8!lN6%jZw62J^
zUSo}w+~Hn><m3MvRRPI1F4vJw+NXGnbLZ#GYO^G=%s%3-wfdt+zPW;2S+e!1qn;?c
zkFu(Vvgq5=qDucpBaGtYJnZLbrI(ha#@Z~VY2B{(gtOI@_vsVETEunhNl~WD)Wzhh
zO3d_I6(`UCUm#akp`oK+l2kt7Cq0~6(x9WEU6kr|N=ZmeZupA52a&{^q<Z>SdzKf!
zT^>{wxab$^Gj@-&8w?p29{omhOwXR37kT&#!Y;<gBRpzFW4wzusCZvN)!cy{UA^aB
zk#cl^=@h-v*{dBVyz32*Cyk_Lr*0VS>Uf%(I{JhWmvfw(b1Yz)L38Zc?Hd*7=xJC1
zOXPQleWJr9B+M@@1<r{}3F>K#9oZ3fT`u;(_?o;GLD9IXqVoM*fCZuW68}TE{a2+x
z={%DHSLD(FT*W^9C3v&vQKsa#`gxD2p0md5W^+c8l1d>O*^7hY=`Q>6nL?|loSJkK
zD$97|!?1>PU%``{gJe6I%{hN1mFCqSw=++F>6KN9OMx=u4gV>L`c0-fI?Uz5k@7&&
zRb1ydi=&ucek3FN$8Bu@QMe86BlOd7l#Z#Xos7|hmvO-f{bwy4!@?eEDKY11D$_Wy
zmu-s)-#)~HbhY!#6Mgc8=QqX|3!NsS@|pQr12=J6Jc7Xyxy$&WSg+qhqa%IAkG^zl
z*!BbjGZ3&3ue2MP$-t56EnuVZtnD@NeEkJMDOdK7{q|kc!`m5xg_O8cXw-Ukea)0p
z`ZvfAdgF@=hvUJ;{$05g^Ljein!66;W@h7=X$jvH?jO$1&%`Q!B^U3+MelsT!SOD(
za(7R*JPLk1!tfp)i?$teU&5|=i-=X}bki0tLE;rAqS7o=5zrrovSnL#GN&BIwAjyJ
zOGlUMtg@~%tgbs6J04X+rSbNIWNmC474qPSM)1^XkXDIksQ+b<J$zVga^0vla@M4h
zE(1)qW3Xg};+!|3uS9WrMl#}8jLyjzv(*no+Y=1%``l%|u%|>Tn%iT3cgds#H_NZe
zZ(t%RYQ99)7_qev>}LYyc3oWy;i;7lKPpZIE^pk#-}RTqt4c0vS1C8D+={|UIp-LY
z30x-u%)+3JfiG=QSGD?rkT=bLPVCna<E1H@h}dT+9LmU9yQt)L$*`~wsT=RlDpQt>
zIyX4W*?s`+tQ9Acd?U9%5r5rtCpap5gJqWD0S^d#v%Qm_=gil3_SPnz%j0!e7i^kU
z9UNrbFJnTxe|o}}4*i3v0#pnPr=u;`2EnFKk{2KgTI6>#&(894^yh0Nq5cEsi%<!Y
zjlU4;oN;<eET75SQ`+fCbcBRs$}fkag8;jzh5I3VUhz~?oae4PFV&J;?}F4wt6EDY
z{3nwgU6H$NI!Il;_jWSxz2UI36ZNQ0@RUKp{uu3wGzBjOJ2$Dh6UCVLrQ>`Kp;mYo
z+V6~L#bTLPE%vHvN(OGPEvH;<$+VKzbtdgHDFa8-QCZ{H0H>V4=_aOU-lfi*Wa_#4
zMXbC=&RDnQ?qa#?|B{;<9#lh?4#5^mg35`;HD{#f&r*9~eCuT8cYNY5Q;lPBL~9~a
zr#(`&KA%N)Z3HnZll=&kPVxOnVTlWQy;(}SRsIGfwST0vLP1rZ5ZQ#LHMEw}&D7r6
zQgi}?jPOHgJ6#2P42aN+Nd>tht9qXE51JDDz$Pk09%w3->n^UiWl#XUUIi*E>qmZY
z-|NJ8dMbS%q%Gk%W1v%lQx1wxrg-(QDop#6#t!1ohAw4AMV90zybA6`$?!1jDBR4D
z&mv~nQyzh@NVDei9u!S%shEte&G7_wzZ<cPIug4Rjd{u?pCbUV1LTeVuo>do^A-Ot
zyPBJVa4NX`DEZ=V12-S@3#~)bz!nLu1K;4)VfB2>3+HV9=>lgB!+y8Y$%7!ag{^|F
z%TMJJG7~e#=H}=;=f<f^kBmKH)&{_7lcrZ5Ky`O6Hm(A)ebQ{op2D-e@9aGR26;~A
z@50DM3y5{`-Dy82VJT62bjkUe*{sn>mXG&%S?Cm@BJm1dnF4fmdLW;QBe>0)C^Od~
zZvEu>QTB%}Wo%1E_lolbpRg2#ZNV@kYLZ8Zn2&0)=!~17<jatjdY*>77&jL3n=E&0
zA*POVo?p(T@P(BvP~uGLK{J@6dP0`Ld-stkFN+tyPw>GnAcZE!+5U=*<)Njf%-Pa2
zqoH4*$$8k~L*la{-;+?9URkz#3p|^ibT{druE7;;7=m0wVMkm<q0|A%QW=@})R||T
z<ugQ9g@(qaF}u=-XxjoCPkkJpeRIf+I)9NDpl6^HmRM>F(dDSuXLM7c|0;J@Tzw^l
zCyj5bu4DkU2KvY&N<|^!OMVeSvKUgloQ6=d(~tu@jf<6)B~|<%Ohui<L*B2D)vHL3
zkxmr%?AX3BLBx~hvasY5@_MR)iWR@|Ckte63?nc2SYXS+tt_cg`Gukn(ip{wKVz%;
zIR6eLI;moX{@YGn3D|#7{;BShX+i(W=A4F>oIj9madBDdL9Mpv4sc^>@AK89925M+
zG9yqnboOYqBDI}Q*LDAaf?@dGS!mwg8pO>Ys!Ih(NWojcw|_IeB2^rpt?DtXqA5!U
zzF(br&6rWY*A9Kgb?vCbuvgJ@SUUq$v6$Z%s&t6#rG)TzI(n7i*F251xjmDE;ghcb
z<z#$JIDzs!n&PYFo~5|}<A;rSi0=`#C7hT~hglbb1**GvJ}~nGK9|t-n;GP%${d7v
z-i$r`-zpxJq(r=g?B*+Z-<rB#-|XebZJX!A!5&Hbad~To3b^nEBSQqBNgk4#mAM;v
zzo}<)k8|rQej%R)mOGd)oa+&PA#>v^c^)_e^Sf!6cYye(nq2Y#z=}o8LC%W)9oL8v
ztw`QLV+Hm(6-u=ZRvy=^%ua!w2^P&~&pV!iExFGYBItZxIuhp2TXZY3F}r^*V*;dk
zB9sq!UM#B7&jeP1?bg$NJ$^l_ocQUew9bILIR!c@A@ZV;Gor3<s~5wuX5FbXp%89k
zJR+WP@jBZ#c*C>QF6%e#T#~X5@=KX<V={W~jGvSDnJ6iP6!`Dowzs!?KC}wu&w@C&
zEN)?Jr|o8htGLEnayRHYzmPmGx!B}j${i6AasSvEG_@oxvh~T*@@W6)2*YQqb_QwN
zlfw?l<b$xN-xEKD$pO|bF16=tW#{V|4pk+V9jcbJL?@GUC%VOp-f3eqAz9s7;LN>c
zMbj#~s+!a3C9<|FRsLxa^E^bxT50G5zN8^=gAHpNd)@tvzq2;0sLR3k*m;6!W#HIX
zro$w}T<SAfqc8a@!uUqr!V*kgD>@#|x8>#KF_&*A1Z$&@R|to7p(qVUtct{U7}A=b
zO<vfr@(Bj}q(NyWO$p1?>;!{@W27h7LzcL_B?6{>1`876<KpaQjBzP(QNK9lB~N-&
z<^d_g{fsqeh^~bl-!PYl=KPj5PfBc(TD-b}3zBRW8GdN9RNObFbhZ*~`Kdp_m;;yK
z=QOpZi#08OYoU^RHR-5UQXU+cF5Vg^&fGg4C*$E>)nT_L0Oc2|*-GtYCV!t442Y+*
z{C%6cuoK?E_+0|%i2$U^j+7WGH4OOUg2mC5_2%m&JE9<&Bj6?_cyN4m99a3l;Wt|V
ztjIBy9D=k4Ne|o8IZ@Z)iu>D_@W9P03h=r{Xp1B)sIU#r(R8hfdAWSrW28dp>=gCe
zlSmDoq;VlH-I!ASRlru2bBHh?{Rp|?A3)5W-M~$1bOlmeM|svvx0<`3y*=ZEAJ>O!
zygZimMurguc3gfB^^%5?7w9dXKMHWpaVe!rjQIQI|Nc(Hv->k%oBqv#@t*bh%Cw3T
z^-3Y6lqI?Qxw|~z@Hz3_Fv<o3)=5I%+1tQ1w*YY%w3-$3%X=AbvL248P;f`LON45P
zNv~~TSpx?lYxb_T@!wg9lnZ(OuNJ^^l~+K|;{Y%<FTlLvSY2I>Mfgbm*IA(tFZ}}~
z6Oa2iA|fK}?Akdw8^|!?pjbN73xp42OiJtM=+GeeY|0YroBQ4nIkm(c^0uzbsHgvA
zn?JTIsGr>alfns(jT>3Qz_=6q{y2<TCVf?|!KbAyam|k_m!Sft#Vw7XHEDk>wB1ID
zVeR?K*`fFKdt5wnhFPiupwzE9HEl;sMN|W)+-0x5Gu;ieZKIi(SSDH``<cv$qqtoT
z7(dJ+7elB@BBUTjRVKxd{aK)En!Y#}JH()9(bsl`x65U&L!#b@1Zlc<Xy&WD$7}Aj
zq>5Ljede`$5waW>zgfmIRH!<FBh_sz@>;gvQgkHU&%B5BvaqKd?Ek4OyFD#09U4@9
zumMjabZmai2E}}@igGUah-Q>FI*~{de^v#N6%8xG6KYC08f4H86n|I6n_co^%*#gw
z)a5G{d?x;s5kZ$1pff(8Eun;Ytg+6<8EKUDVeS0a)U=K7i-+0(ZHaw%Dm&(z18D{C
z^wKwmixwB!B9^{0`5-Im)jyn`^D*N<w2Y#q>L}|~-UbuCl6LLRuioJ<Fbbi+R!CXG
z4@j%%(XyAgY?xk*SpH6_l`4XW$dQ7Vw{w<W^yp$DAm1Rr$Kazf#LrdklHk3{XZ=|r
z=@dsboqOzg*@7Av9fqGRFQWU6_dq%U>VcQGhRDtb8Ir_^&3`v6<DObV&GUNfz<MEB
zMBbnU%qJYeKb~3^agPo`P8gtThAWdADfsNgAw^@U{|#&5jnV9HAmAc!qT1-8p(-&t
zJbY_NgtDa-cn9iyiXYead&G0x8-GR8I1<xd`wf;V3!zcWJ7|;bs~(w|Z3M}}B_0P4
zji7=+O&*U-6<=eRM0IZ<@ogpfQc0pqQ8rknWksZg37XJbF+MABUOw!0U}c(JLWQxk
zk1w1lC2PBn?24`xDdREVl$EA_QP-8OFOmipg}E(}{z%h9ix_y)_USQ&xwU=s$2>+)
zuCBCCX?($&f(rtp-@;#HEQ*1fXN76fQ1d_8(_%4NNA#_&mkiJ+>M3h-CLqUTpjLBc
z2H&6Q2rf9C8#3dLhuU@cvVeQy_rLV;Qe5$foQTBaV$8ZiSS$!1BHrR{xNQ+TnX9w}
zSq@W|T<D72NUu>V0Zy6tYH75yzKN9iFVVRAF%z(-EUv}&64eFpCj3@3DYemFBc>gt
zN)sQZr5s+CJVd4^u#j0uIl@sy<r~w<6Jq6AW%E{mCM2B~gSd~1xpgIU{Cgl#Rb$Yo
z_s`e3isD|6-jZr1AAgop=F*dr`b}tL?#5*eisUE;w6E0^$N+Xrs18m}cBq6Ncyx4D
zYm<jlNbB+8rM@b?{m?OUf@P~EU)yT4oz$<ys89}H5M={c#&h;}1bT${8uIc0mNhoi
zYsglola#H(F=4w9<MqOv;b94jqan^RN+S{EHqbgi327yYj=io)@%JxD>7R4HI5HG?
zJj;tI2o;GQmV3P@f$zWmZshSXB0y79=Z*Vb!}hw><~R4Zo}S>L!D~*pOiZs(2E`83
zi35x{v?hX533&P&`!fSS;Wf+w1T2BBQ5WNUA=$NY1O=7JD}?OGpgT=6ms9|yX)q<*
z{Parm1p>u@mU!VqYQ>&Ohtx?5jVA^!v@Me#4W%aiA;L?X+~V{Z?}I%Whcft3ykIIe
z-ygem@41E;2W{5Iv(8jt5itY${4sK`*F5W|bVgJ>Jv{FUdwd2|T^W*4K5M<4wZ))y
z)QzJ4km}0CYhIj5ZHGBHc#+>VyTn`}ix}TYM8_|eIi28Zv^%1=V1Zs<+W?1jG#Q!C
z6=;L0#+jbo7Lc@if@R87w0QFNG75$V(Nv6iWbsD}9YVnfjbWqC3VIRcW01#Gy|0P%
z8r?-%><+hV!6DJ%X_xo!-o4|u@(zP3U154ppI{JO8zar4^*68iHj6Se{pn$_3sX_`
zFrNFjgoH{3b*r%WDQ`^{_2;3J{uA4RuJ+W3>Sc!}0|~}JX(C>o`9V&0KBqx8T8H|E
z%{dwez6wP^1>P~E^qRKZ#<LBUU`}q%EX1%xnbUEa?>?{n6gle3#dsS#+fl@-S>$z?
z;b|4u<hmr4h}q{xdk$MM97d%5?x$SAlc&t0vWw45`21rTdDDx}hAd0RJlV}`?pFBn
zo){?Narm2=lG5uxJDzQv*r+|f4DtQ=N-%3eY8gF&G(F13LNK!?_#>zKP=J<JJgXdE
zj`7XGk@&qO+8*%h`JM~z(2tOv6|)t#ZZGJ>+XsNOw7N=ilAJ-#uOMtL>3Z~pOJth?
zx=<+?*G~2=?eo)0@?8c=n#_1R<DaM~mZ<#9i>;~g7$<>T<1EOEX^`PH9~k3c$84W=
zpSVu0&qcmO@g%nUAr9~=tO@4y5U~l`r5)ls<QF|843R`K#gXkWWpoQ?G(PeaGxBvW
zrZD;#<O42kRF#!Y{?v?pHON5^&ijzmgO-!Zub`+KMTC)uA?EUt2LLk-%YBq0$9>d$
z_GoZQQ$&<;DM36RNseMOe!+NTo^*>{3LR|Q19*t!hXS+2I4+8XFsICC_@O*(?d@KV
zoAY+|d*gpl3zbJH-%%rzcAHh^Z;vf|=k>a56kkTZ-Os<d{UDuwG)dDA!N<3!;E3x=
z05JvF5pM)-A<ypbpGRHo7yr&}z+|sCA=K(vf`r$$r)Ul&#4<J34@CL4CZJ|imWZ&~
zLK9+>h6|k}sPQgO2v$DIVtv?aMnsI)VUJ+&{)@#t?8@G&=yc^Plp^!HPu<7uoaO{~
zuU9p+#D~7VK8=lx)G@8;6tJ+gaPcRFlc+~9Fx4`%!K1KSQkvo@><@GL1^iLvw6~~R
z3^ZK7%&ZA!^G7Xkd-!KFAHCS&vv?)%q}Lq&jOky*mtMmIxXYxU5GDV+h)ZE|_qX)|
zhaXM&Pwac{h~FOq1PJr#BN_5G5+T()EK`*3*a6a83udCF3F^E<lRV<l<=bz$>?7h|
z#+O*7Ps!J9uUdm%CtmE%H(3>fYR{IS+zqmOZax-Q&-x#vGLJkze?|udE`z?BWcWZo
zXYNSzPD_la8^JT`u;H;sc@GfAN%(Rpa^Bn>Wi{$oatjaX-`}$Ga0*2e`N_Xr?q&aW
zq$T5jh-wT+d?B#gGl@z-&2|Pxn@q7kM9uo}ty!G*`<|^xx9$<P5~&}qGO!nH=}<jh
ze#HLk!u@Szs?kyS#Qf1zG<jr8#X{;5acAv0Ez;udnPfF+7?+ngSt5=19j$9~?NIW|
zZpg&c>a^T}o%hK4`g&bMt+NF`jH1<I$H!w&_+h2hLW43WbWU4OoP|eH8PX&#&*auj
zicY&ZY{5H;f$!sF6fFyzJSQ{J1AkoE@}@Q^Bw?Qz%Sy(z#G(!Havn2%{=T;^^t?gh
zZq_lsnF7Dt)0`z0e&QaO4k?LgLk1g;l)^Ifv3v~~k6qBLfj>x(=LKgD9;sRf_{$gj
zuNwuZ(q5jP>|j88a`qH+=6NQ;RzvdiWOZlfbD6c+3N+=rX!gzv^|{-Hy6>$*3up8;
z1fb-GFfGn%KA(k~ThgoN)38E%u31o;;>!k!XDCkRd2=>I*Zly4TTeqE?;-8z%MTHy
zkwSQd*hVoKeXflEpU5B_@<u)`MJ9)ZC}XOfITZo<Z=yb=xD~nvyxm0U9LUt+Gxc1C
zHFa?rJ~6$#JP;aJ)Pqc0SPAr<@cbPk0f~UA8*KdiqiV|>>fpw(?>=|Dun=U+l;8N!
z<-4irO0*VvxJq(yiq<)lmbIAxuf?sqjOV!yjY2PJ|C^bXRVr$a3UhL`i~BR;1}ang
zo8*Qa%w#vhQL6X6bM&5g#6rU0=PdY;QDoS2@7!^9iE?#wqwLT@yX}Y^_|s-li$w^6
zcS#I@>9N_&uwPs-_5m9(oBQmccRpUHtu#BCsZX^mz(kPZZzawk`x~$ErAJCPyNyYw
z6n>Adc<kB5gt)!BQ1mn1{SZ~*foTF33r1y28;s<1b7qInGLfab`%M6t=p@SiPiWcH
zsr(~mun>)@w&9ig{S;+}Z3Fl<Zn+hRyno%^-fFDQCyr@&9_%npF3%4H<1oIFlc{hZ
zNi;*RbsA{M?ivH0wFfhKK5KXYfdI(h^7LsE2&|fFz=X&Gl7BU?aM{0%(*$xzTkd);
zUmeJS*ZP6iM}FwUfQ4JPRhS}&c!fCqPk;UuwNU(obJk;5g595;OlN3kx9LWGiI!{c
zrbd{m7=UyvEO|L}^_qQgfzgniBt8B4@$`3A(v%bj?iYc3?#Cbr({k}0L+mG|Og_Qw
z<7JYdOfckgaHgyX{8p;qgXP<M_AJKS6|D!QEGq*y<gMMnRCJGsM1gz+jkPwuH}z~J
zwFU603M$&Wi&Fp5QRqicUH_}2R4>?g*|RbETtLXFsKlH*F-}(Hw6$SZq_itI$<WDc
zZ7sIZgu`boC@BA8EVC)oN$ZD6+L@V|#PV$<x}6bU_(2%d<5=w<YS-ka!SO~g)1;v~
zt7}=1w8~Z;kQ*{<Fyq<6%AH@8!^QR0mMdDDh%NZGbt;k)sl59?!O1X3qm?r<N$-(g
zBZc5ghh3m>*Iya5Nzh+ig5cufqD&`l_!or=iit^n<(3Rn=T{#eAu~GKA|h2n@t?8J
zyDnd=S2d-pXCHzE(YHErK`K!Upg)CJ?kCG)ZKq&8Bl(bnP(;~8_SB9WqOkIln0@_K
zE(YA|oyVrK5H@i(3poiI#+Hv=d6@somN0D>9j2!0c|JQGFW1ujKKRkB+%uez+Pc)A
zD5ueOIfVkduSUftBRiq&?Q$DBH6kZKo+!hBuBfT*m49EiBSD^jVL)mHShf(E(PYPH
z{Pkq+mq587(W)VRI>U=YN11CaQsLMmql>W7<}ALaN9SgLv@|MgR-V0$xc|Zt%H2Y5
z@y<w+!QHU|GP?JdY>b{edMY5Dp2yvr=Q{#$L16>q(ohO?*Y2y5U9UAuZnb80WX8O0
zL0vIskqHKkIZN{BSC)dg_tS9N@|}qzL_cK09U_;j-iL>KYP|o#-Yke+2@@+R+&gXu
zc`&lJ)o!u1bQ!j{G86_9v)fuVZNk;8t?3o8wvD{+*=hxIoycjhkZ+EczUkSKygZJb
zIqdvK@H*{>4WC%D9s+*J50U;1I{y^mZigKjO5U(c%~S&y>Unr1RQSg}eu@AgOV=@0
z(~NdJH7}EL;#)BXh|o;)e`?tc9?9AWN|q0Hq`1IcHzWd9<}}|F4fC>&yHyg{(HO#;
z7S?Q;?6*i*YQ^lD>Xt=SVZ6OD+YR9}ywI9uLj!>-a^iHxGye7uPS0Vne&4TV9EX=a
zcz6Jj3JQQ#KVT;`dE1;aW{4U3me3ne>SMB^7i&oMVRb71MyPN|py9|az3%hoo|K$a
zl&i9-987o4dK4vY_ww@G0}6G6T-lbSQj@;mDz=R;LKum?u4vHZ3WBbr&C8mYy+501
z@$?nY4PGIR@|6`}fu$kz^K0^abmBM+belF-eETA@NM!|L#j`-kcfSy{03Z73YTjZm
z)g|CK<=2u868^6rcccs)flTdJuhY0p#QA7yZHInQBqLwKHaS~*KDS1K&p-Mnl7Igd
zg&b~hDsxt1BOGZ<IcDuUHbrcs(?C)6b#F^w$V(e{v&+*r^%LHT$U#T1I0MmhSEVgt
zIrizbG(fk4g#QhH(%p9_!wGHYcV+-{@ToZ!h2iGb=IvFS!X#`ViGDsQa^|Hvpwdd^
zM+&iy+dDdgoL+~V{!iu<4ydwTR2F==Dgxww_UVe)C#*0TNxU3YQJ8`igeiF6IJLC2
z<YnXoj2sfM{yWIGaPIe*^zM(ZcFhEPYD{GEGSZ7BB_-Ek<v;vSDO4H_)*5wjY<8ny
zrOd$hkQGf=FH@?PP;7@r#p@fX)GrC-|Gw#mDDhHb+FzWmTS@@QORHM2TV_6_r>u1d
zdfy#=gb8dBTH>1gNWWnDoG;R+X7d}txX*nLD{pz3KFwcX&v_#1z7!yQ>RaJVzW=;B
zREmq6GBq}p7+zM@nww1fpGJh2VP#I=bv-jVEJ{G~!|C>C0-=AW3uchK{3`}TBqZ4I
zco+=f`V#2sW0w-%e+l4&7Xit4<1(l|U2@1rrDcvR^{~uzJ_$mJyhEtSKB&&%Q!gMD
zNte^7J1k%0j#;pON(#p1x2(AXv3{Ta6c%-w5e<rM3j<XWuJ$(ezBdz+(q{ifzN0Zp
z2g7yt)UfT9F%%e}0R^Bqco-_M+K<Zkcye9u3qXVQc$lm5Zan#_rS4<*-u}S}Or|6>
zGdHhj7nvY}De;CM?)K*fV4aI^s>s^DVp^Zv2zI~pjmv8D@*7`V(#VC2d&l^Iq+f@K
ze95Ntz_42;F#O@j^BriPMf1jS7)KvOKr^X*F7uLn=hn)Vm$FL3Xc?Wz${6kmSo93q
zyd1jWtUXBelDc|>fC;BQnbj5^l`--Y0gFr#s5A^o&*n%ToKTIFKc{=a9D|o+Pv(v(
z=vQ-!S3VNPSl(wzg*sXmz7F#sqa5oKi?LJ6<xtfBsril?@zdebwHyh^Gj)@7S!XP~
z_nB&Gw~hjzdB<$S4N3bP+ES7}P?8C0)^`x7#YT)2A48eY81!;yLJs@_gGi^j{DRBj
zf2fg!#+_79LAjG6D|PsL!zgLfWwXr9*ps2Jtc$@UhH~U?m0X4m$t;5Jhcd?533j}h
z_C50O;z(JxA6pA1>h)PunD-9-N7;hYxz<Jt={(dy^$-?Yq`UcQ$hUszFl%@|zl0xg
z-eRx$N0LA0EC!SEoD)vgrg3oXU7~&lERUb9@;njYyY96|z6^1(%<nrfkXGn;{ox>X
z$4EYHlRWmxwHg0h?)N%8*1m&uR6&I&T7_@V>6_?qNU{=a9rU~@QBX1WNMBf3FsCvb
zm)3*6g5^2iz(ARWRql1T-<Or(+_2dLj4IkLJLP$~3XX=&C~M(>_fAV3<IkH<v2a?v
zm5Z=1%^}T{T}~RY+jSr4k;z+Sf7X+Wgzn6!SlK#9?y~j8FXO6cjfmM~ytvlm%9_fS
z;M}dbwT~dJLT$x4Pk!(0OWH6qAWjQ58B>`w+L4T<)7X9)v&)FBL(uWImg@|?;p%e8
z70-L~gw3`qP*ThXVM$wVug?+R19Gy@8sX~^fOM^>IKUy#E@^u9U!z&{BHQQ0!oV2W
zMpovLg^NNu8z*kw8sB^_;a3c-oy=(_oXYtXWW&4S6~Y9n5{u^azX;8agW^1H3YU29
zUvQjO(lT#XDh+3R;OT-UA#G`vjfu*wjNx_mahRk=R^u>ogsfcnktO-2n}V+d=vg0g
zoK9o;Wvs@mZWN)cR6Oo&9g^1k0T0*7I$-fem#RaW85Uc2mW-bgL@M4uPO)ajJx3GK
zJ5vQbB1oY`rx$m2JyItYd?jg*Y0rqK@MdUsOaYpnaP>p!MyE{EJo6~*S#3XcTSGgn
zIzo)r90~0n(^#PXG~+0-25c=aH}4t%ZYiP`u`X9<E*H2j7Hl56St3HnW7(mXKF5Ic
z;ToqwZ7<W%3s?b{JO2yj4?$q^&WH*7){yn^(jXm^fP#V@)9f4u3^IABesW-`?L+y+
zPczG{Jtoh<nFE8XsaVa%Fi7w_N`Kn1YGb*qd@V7#)7H6p|6-YD{%89kLCdc9F~ILa
z=+Fb6o{Y|t<rrdx{F_6uN=t4Gw9b^CdCh=zd%_LU?>1yzztiFT;6J3&Lk)Vdd(lfK
zVKzi>ZZiY!#_AnWE$R(!q5cvg-BY+uZnGdvIooJa9maDtx_k)Kw1O4zz^b)^rGvSI
z#G~f_v8h4KCI9>|B>zgh)8_uhs=pZN$|Aqzcm+3<W69i7J+4Nb?}Go2x~{B4$)}lT
zwAXu|+h1IcCgNW5?hc-oJLe+T_LE-L@VS@tkD@ZuE=KNM&9eXSE1eXIqEe3Rdr2L+
z=>&Rt8Z~S@@l~y8y*~BwJIJj3*gpRY>~J=A`QT^wd(R_hH!irmjQX~|RDrC|V((t^
z>!7$wZP*M)=yVoN=#xU-7+!o6=O-7Z>26fY?wRo|tcg4A_o1v`OoLv(0lJ>7hckIb
z_4Wor<vbdU35d5xU}RK%H^`jIWIR+KO^hgw1Q_$lOmELK4ZMvc*i{70cY6MvR-s?o
ztgQ@Gddni937__BW7ZA_62xHd@vS2@wGv0k`s7s|Zbwa$!ox0A1%=w`sGW$K+7v!D
zbCKc8ePjEP|J?bf=bLCbTzSoQj;NX9YGqC90(gcf7w~qp;|9}9mZ1V#zD+6f(|59a
zyIV`yJ0^^!CE(q1C#L~5?La^I1By$!xAjh6`cQq$oOAr<Cf!<zcjdH-Amt=4>`ok<
z$o-eq%B&7~x`LvOQc8HCdg3B@Sb$TeOT0u8&_NOMOL}1Jy7K2wLE^vc8nbNC2=_q;
zHJ?8^<Od*A5ovCUjk_~7TFGZ6PQBc(Jw<-}u{i;~{oSW=2dff}&?;pjk2ON3*%P>V
zn-zrla%2wmC@c*Ns@Mjkn~SW-^Q0HM*rG(a@pdv3Q_li|7Z*~{#VfEoDCC(cZr-pq
z;gdtZ`AvM}7rRBt(H>)|yaOw6&cYIUDEge&^iL(dC>z+dX~cTDr1k{lQO)E1<H4dm
z-*3}|SPZyLuIJcOgWKwbtUA;QADjGWGL8aM72-e$ox5uICs%uN1@dO(H!M1#u+>hb
zn&fG*8;x3?B0A4Yu=i&JtO9Pa-HH!dnb4B2lA}ny&~AlPd37^2Jxy@3JxcQdm6}$g
zIyamEM{wP+6uf=v?0D_rdaUt*J-f-!JS1&?+`hsAo3AoUc9=6_SbX@Xjmz!YBLbtG
zEPLlBAubOR_}<CCJUw^nbq#~5y7o1JuW)A|z2#kS>?;|hxw!f!&cNnXha-{T>yKlH
zMH)vq80H<@D6-D>J*Thx3P8K@8S?3es_OSPuFin{s?7YkJ3Xmsc-fjx#Q~mAFw^cg
z8IZW4zG}FH*`@`<|Au?OORl8D#9zd3<PB`QlEDnvICkrbyCm$uqo2U6NpR|SN%qXk
z<g(_xYQ8gW9#`D9Flhb!hVxzKW6O2hbA!|B=~X-)_~G1!N?wgNRcb!)=IG{KQbxQt
zTMBJcd_pu2%GdBPEKa<SUD&rji7#)j(uVSbd<c1bUCW9r#VczaAUUfZp{BFbWhoO5
zzC%&VbjMEZiVzz7EAdfan~8G=CxHUHKC9Nkl!i1YAHIP>(P+ZR%{h(?yWxaq(Y!wV
zl;A2tks6EN&@)7fWTKVtq%7<?n?4GInr~GyZ6uIyL1<Oo5t^SDVfZnwk!XA48dG&c
zy?k%Oe_1k0`&YpG9P`I}&EqP^{HBo0Qs$1uIfSK3Be%jB4n5w)%u|PPY%Ly%lalSd
zL(txCoTU&?haPYHhmim|tT&%`0F3c_?-r?rH2poIKfo4(yOM=y538e9*G=V;r=R+o
z?3VVf4GR2rj3|q}Jj3dUM@DX_Npa(`LcCRphzAPJ6~tM|FT5E|GnSns^dCXRU9*cU
zPk`8km$E4%b}i<LI%Q2&-l7MjHY=5(t>O%fYFu(kOB2z(*7vaE9bToUk*=(}@ozDP
zKL(V>h8GctOq@wkaoKUaW3D);_2}t2*5bmqY`g2yQso3bXQeyEl$YXhG0iwjQtn-p
zuizNp`D>kt9IOp=4d_hXz}czIsXV9MgCg^LYfd@~;zogWvI0l}@26b}id4jg@fox)
zIImZdLXpoRzm|$E8|1YuAe!IJ%=`QtvX3XT)6NbmS~Qzf-idTRXf)2<EHi6Ir;`}x
zzT5Id>9+#ozf4)6)O0vt(8%*qoo%8x3{%1{8LjOm1$h}OkCbxyO5NZba+hyGbLIky
zx7hLqjPo9gGm5gR^~L4J+yn-&CLf~L2K`j|e6EZ7R5vW5EYrQ8^4<s!LsnppTAM&r
zuv=2Zf^X3HJMsI7HJrslZZNH#(|(yTAIBVelR#HnGwkEb&rl(n+>Z(>vx9n#8QeOS
z%JY=npX@MK+BJ&b9_Oo-UzGY8v`Ut<eKH#Z#hNyJlXLcjZ6z<+foP$s9*sHRUx8t4
zIeUAjq<toPGlW9rn5oB2W`;l%(k#j?fzvUM;ySocM9u<sr=cbEjOlbUx+3lsX|L(k
zmoku1-R;lNoO`IwSIXg+>OB?~7UVsVx1@zs_i%kFzuF@GhivMev%?bOZ3x*b26VoY
zEWnEu9~3X@^AGkM>CDWwwsD{fEF%Z=T5t?=1|whwhQPjXahTwVVw$nn=a|qxB#HFS
zgDmm!6PcXv)r|e{5<1ZdAy4WAohiz$?8M4#g7*=?sxn@4G?~FvxgzQm#I{tHK-Q;$
zl`K9#Z>Qo^-E_++PVBllgIk@<Cg2r>$GO3OuXA=oxd?7}KQOfPXQf3E{tk&Hjq5ft
z?1*nWMW7J<ND8)}U^;ev`YD9k0Jr?cQU|zb#90gXqXsJ-(l8&Qp4i|i>UK$s*rVBz
zcAHpgB<_v~<86)n3dKFcv1|&EFcYryyS4orzA{)>qZbYPJwHjZXIEUzhNYRW5t_nG
z;l$L+fISB<v)P4rL2ThUABtByj_HokB>!qTP;+o%z<P0=XlGH{;((YQ#w+Q;?=DGr
zmKrw^2L5I|sO<?Zo*!%)l{Mo-huHPM97z3NEdZ}xR{4gZ66mo4Fl$?IWiD75z<YXN
zZAZF0ZQOQeUj2g^=p(AAM~mM~B5S8hej_9UgQMM5`+o6ZViZ$5oRJ)Hy(}o@=u7Jl
z^|z$C^fw*(b)Cp=8+=b*(`%sN1PyENW4M-y%x=yEC3R=5p;<R2K#PMmNw^mYIJ-Ir
z1gVtszpzKNu~P&6`ZY3*L35YAUG!Kn%+@*k29_dP>n`fh&wi@^qATPCyDsk=C&{pc
z4)Eu2i?|^dp|RZb#2qM>7GG<?Gf=s5uUdppL-PXrOgr3AC|Womr?u5gdIUViA=Lb^
z=)#>ar<a*;u{3hCY2NZinnDI{KWAgc;gAR&pAmNGy=FGQD2g+nRmUeC9Iuz>w&G#G
z)n?Xy?}60*s<F}ubSj+jej#Suq;v3kxt;rvz@bFtN4>N2awp?8$!HFe#FJPB_(rBY
zFB2wZc(fgmfAF^udMb)OzxY`1HYXPKQkZVlzP6Qa?n4@lxz0JyG_$oIxNOt7AFj2@
zW16&@h7Eo^Ae!E1ai4EK%>XZlmUbcy+{LAzYZ;JZ*n+pQrQ<uibol#A2pSz`9vV1O
zPeX57g&UC*SV@Opf<Wm0u7hI&88&69S9+LIH>G9xnyjXLEY2>@c~j-Px@X`hjESj3
z*NrCE@GjuBv7IcwhIiEtJ=Jg9k6gCx2)vBIIV&574@I(HIqbua8j++lGO(%?Z1oDf
zJ_l7KVoR?5frm!eKDeE6FlWntEztIp#*_IzqPB!2J|F4C<@B`m3_9uam@a`m;Q4bs
z(kM9vylL$9N`UMnc)~QCbj%Z`Z3oJ1<(p|+t3oTO*Zw-Iy;dBVM#Q$z!agn^j{$ZM
zR27~V7Uyf!Uo~x6D4&YV@y^rMKx6GzXV83>IkBhEEp4J?>rAka+G~Fjy@FXH%!HZ~
z$LNDmt5KI_zy@wn#e-g>Ao7{lQTL!r=_`+=$5TIK#Vg+8&UKyd4rxa?M-EpJdR+F4
z#DsD%4eoav^h_6Do;WYZ##yV;&Rf(+J009!@kydRqeBgP&k=dLrEVmE{xYx`Ffh+%
zOTZ;atPk`c8IUP=p7hUqMwWN^4Hme9eO-9K`{Z@Rm|c^@GcFoB652JoN1<m0j-_BE
z?AXM^z1X1yaxxW3(pu|qTy#4+Etq!4f7y+V>ElC|d79g|(r;c5;_FUC_KQprX${P>
zJN)vH^ociY8sesko{u%=RHV7T;^N$E&M(ZVjFddK#=w(Phas-4U!?y%59ij*N2Ny{
z@No8mI`KFmaksDcoM}`Z$0XE!PUw^37I*fvrL@#PifnzEE<671jYQ`q{CMfSk>|bv
zCwZg3-30+N#mrS?){f7!-jTUy>9E#_Vjtp`p!);UZPAu|L+8~5p}l8hC!iJ}`+ClZ
z-#y0WH|?6oH3BPTc=C~8%k@QkVrQC_w`22T(WV01V>q;#<)8*ydt{F)G3qlgq#>(x
zRkn3^_KaClDcJQrT8xhYGU6(N%@7rxn}JG-oo>8JJFaDwn-Rf7|DosmbK*<&u1)64
zmL5}?e)4-^`p@r%`(_KqZ_=%wq0mme6JvU5rnW02ScPX4Y!WP=VLWZIzsrAFac(}^
z&hogd=#k5|g%~{SRs6$l6e&ts7srtIYtnLMv^b8-j>JJ~6`B((4-!U=oZ3WaBY84)
z?~KmYG1Hm^&P@%20RnNKAvv5Fsi|&_ty*0i^Byewa4diERM1y7G_>4@Qf8X*_t=AI
zGAyCY0w8#Bw()$(TH9pJUOPwSahEVuFID2xDt?qh$u@l<dE&sR6p{kabrmIXIQ~D*
z-U29(V2c_IAwYoOPLKqL;O-=7aCdiicY?dSySoQ>*Wm8%&WG-hy!Yzgt=g)st(v0v
z_-2Og+kJ0$pL1?^Z!7j)TuciZ0ezv|L&RHCY_(}^?tiD{4J>LLThP>qa3I(XbO7K_
zwYV2+AT=U=zeB|(x?y;`j|zZa1AEDVLpVPm$5Oo4v5k=?`H->tXF&c=p`P0VkqZ$8
z)<TmsWN?Y~e&Q0qb)$a=*R7(tG)?seU6$c+CXRR7w|OA0sJXAnURCC8P;k~p_(U9W
z<#2M;Tc5A{od1BmGv^xUEK6s45=uhn4Lo;-90jUL=eRHw9C@DgH_<}~kbA>Zs~_t0
zm-i2(4P{bNG+J9fc~LSdUMPTU@Xj5w_KSHsRnyqV3vH=MCE_C}7iB=`q(`Zd$U5v&
ziZAFQI|`?;(Z2D;4Nj)L?1FqLRB~<hb}&$X0YtiXK#HCt<z<)%_YY7M1Zb}Lq29ID
z?#t1;DjkZFy0q+F9l|Z$NQuLtwd^rZnY4zf?p=yi7zJ6{X}foB;#odce`jo7`h1o`
zZ<x8x%V%sHex#i5S%E*YA~Uo9Rs$1lfn+=!fwiGga1#BE$w*9qgggZ%kbGjt$T~Vi
zg>O{ei2ce67l8j|*I{09lPp62eG<`jyd%v6Kr%7$u;2UVr2R#s#j?vzNKVVGar=Ul
zcTW$yCT9Uol|S{vzm&BeRz5x-AfcBIpcN~7PyjeNkga0t)?6Zk4Fl-M>;)2vR*w#b
zKsu;()g5u(vwS1$+QC`MZMZ`Dw1lhr*Pf9?6Q*Ne6n)xI^vI||+cVg%$<Onl@qDSd
zB+p>Dbv_GLQo+F={ewo>vl&;aDxji5fp3p+aV#6q=+T@(!}F?aqQb#7r+H)!ik19(
zjkCQf>$f7F2$}H1As}1<sj-8DtHFXf;SM(FexF&6pQc#aL`{!2kJe~(+{sqkR*;I+
zp}!go;Ct-c8QQrP*M5>K!Yce@_V)iTg~x9yhu6A~mP^Ht_gq{#Nz2I$Yt3M-8)_j@
zK!>8J2}=gnH2=`pA!tJyQKk|l4*+3RsQ8hz$)A+`i{hpUI1w`DU&$mvsaF{xQ8zxY
zKw^jI$W%avp6slkj;=0%977meSw)60B{-j8R9tliV7x)$z`m2KpB)I}sqZ#Ry2yKY
zqcf+)j6oQhPVt^EeGP_YuY<1eWApXC?|z>C9&<Jw%^fE0LAbyGm8m^Ck>9ON^=smb
zXP598yg*>pLBia27Rh|OWLQyh3EdTEjfmHQOJ)Op1#skU*nENbbUx3!f@7{{$ESlM
zhSVm0@ch<v`l;}A()L^Z>TtJ!cB&L7o+UWt)P@xuWAEUdWd3-P!XRa2Qt+C$KE~2^
zUL<+h{?e~0z=0)QMZ_Gh-dtZ}D+GU6A<mbS$&W-hex5|j$r!qHvbz{YLNO+9b9?Lz
z2??O)rG<gVWaDo!Czev3UTis9JD&RDDLfvLhrcslqTIbD)>}MHj;SoO#M4C`_9)Dt
zI#q}bnKPQn78x#4%*t8qyEK3bMm)&S>3(YrD*@%R=&Yt~Hu#1t=Hw}Ha02;J5anxb
z22adF`(da?)MAf~H-Ze!vTl#~46*>~$%A5ll|*ZLazLjdHvg?<2|IzAOK@02VzkpM
z8vq$KZG+Clk+)NJ`^ag3m>0!4n8o7TU&by3wv90FUH;7`W6;&Iii{~3(|KMeFfJM-
zLqR6WWaaY@@VEZmT*=ZfQ8xh95d@?|{nIRXDqAlUHCu%(MTrLj?jn#|!sGvtGJOB1
z8~<VjrDXpw;_FurBeh8Drt9D6V&Z5u_)?$90rZX6<nDf5GrQB5t!xP;b_$!UGLd$<
zyl)ZD?Q?T-Fj+f$H9Z8n6fQI#<;>^NMAXqK1hQQfT643$30vr+#AN3OH3kw{3i5=d
z{FzTqZi{BI7;qDeWwB$_?xz;4&wF1@6vj#&j>t_k-LP|B`sazV-{J(N5s;dxR&EN6
z#y#)R0E@(nL!}c~hQxO?-XngNuejKfog+wiV{}5sZo-}9L<1UEkq|;5vDz#5&|jZc
z-KWaaSlPG)uPg))KQx)J9V&K9nbJm`DN@m93T9TsryB~G9G%jW15j)8M#DJT)e&N6
z$?jAyD*n|;JNn*PyLa!hc-T#t7q&Toz+a`yO{akpM^9*FVyrf|aEJekAirYU0*i5z
z<2q^?RFA1XX5(3GvH?X|hWuIW^IEXNNuxT<+npF4gip~Xa3q(qC#$uPc-{MK7tAT#
zheY3aQ0ngH6|hI|6(2sSanCzE9V|pc*S%s}eZZtz)xCl6K!HoVoKd^H^(-8(`*3<?
z7iGBgh7Bt_iNxBvB^fu^6oDe<b$@<XYAme&7fH2~${Gs3%vK+rTgctUq;l=tjVFnm
z{-P?KG*QMn*4#!0jH`nrtVZ`;r|aEmo6-=rVaY2$6=aOxd%n$m4>%G^V706j!lU)Z
z=;ABSg&OOrQ~A5Mt#2~cY4)GWMg11QU%kWy5VW+;q__yWQu%zR7Ox{2a>MzsLE0wY
zSuGtFLstDe%|BDQ3zk#q>kB_U#QQAWTdl>CIh{|~`sn&2jWV_L@LfXD84O~6Md|H_
zC1#vIa>!|XFe9Z^HzprtTzFrAHA?d7B`F`^UvA4QSRnJY8Tncsr^8=bSxm)}jQ9Lk
z1cs7nhrRyQ`3HZce>P;^AA#<LJGP_Oy#J-1ilqLSm4W}HQ{fumNW)+C=-i4FvrCZI
zX7b*J5TFKr4KrrsJ25|SBLf3+4)cM_MA2y_a}~aBQ;Mc%C2|0R1(09{6hWf*<;GI>
zxD2j<$<43*Sr^4WMj_nsdq7>RPKl$lJ7=FKU3LLZO2zHUTu95237wlhO-5VFwVe{1
zOzGBz8tiUtN$70`YbSd>>@+(<Og_}BiC6ul&e*ofPg8ag>kG8Ai_?s2U?aC$85is}
z6Z&)6BWv~v9a{4)=j*e^Dx2|Icm|_IL0)HoLLXm$GT|0{wqC6SQvr8nNJ|CTe#2dS
zerkKAGs5LO7iSQ3|J@K|MPdA{z2C8Iqs;#I2~QO{md3L~m7yxP?)Y=#$$k7(W|#1u
zT-z=Y_I&L73iswfulUVXl~5+lZ}|YQNd!s7Q2*IME~S9^XTm=Vzhv`}4d2AHTsXjF
z9r}OzU+S$;S%v_RZ2P{A8(RuT)U-n{bSu=(in<5YXrcPZLqWXurz9y8zD6%n5mAu9
z#swv*wWz=GVc^~k0%MCxYcz*X&9rcx2dwh+C4vW1GyD;8@{D8+Gtxfh(l(pDw>?K?
zdTDRnfd%sPue#bqiGqfpQ*gl%^h~4ZOah724Nl)~)>SRD9YZS*dwj?f>u_By%i^@0
zwd&5SN(3_#vz=6HT#~iIJ-8G&cMERiat71|FLTuaneMz1w~?fGL50G^!<jdba%t1)
z*QQ<O-wFzAz05+A&=fnBkIY5NGK@GJL4-vBi~Z;QCv@0h^Yvo3Lr{43nivVw)7HRU
z+#9fXT0QblL_nu;4IYe(Z*zNs0H9;ek$jT*S--5odii~Vz?F00oCO~c2<+B)zdqvd
zMoa?SPX=N8&S<l&6hKd@vbQiH4U^wS;FO2-CuZ~|4t?eggf@1zN=V<Rss94TN2Tge
zmiwqf+N5rETnf;|BfqUV(yJkf6L5wLO;qSyJA175!<0q@8D|fh-8^ci4jy=pTV0)E
z_LA108K6))qA4eRee^2>NjsS#i4oo2@uwitDw*>NTjeID9nh|fjvUV&sHLr(I-WQ<
zaxj>;FB~w{oYck`??$HC)yoKXM~dzAAR>Fe?<0x)7)s0wwx9&b=dCYF@_{Ab452kz
zV=&qb3pDWDOs!tMx@X5T{*C9X<gpb&Dt{_Q!L*?3%t5e^!95Vf!F<>%bb%v6s!OcD
zXaOI(12J}%PkydhxTKfu!yfvJg!6|?<26avRQMl=<%s6N;dpk~{Jl;YL!yc6n0vO5
ze)|zKC%s!Xh{0(7&^IMbFfK-Rw<z`Uvbl{oK0bZgk3sckq@nTJlImF|<*j&X;U2uV
z*ukid=2n~78^<?IOE#$(AATSLm+wVr7HeOkoOQvUUUY1dT`5YB81CUjG5ei$4#FY+
z9|OrAEoEnyeUXY#_!E+k<UB0siB63sY$1IrsOsb#ED6<L_Hb!*uC@$BY*#BHsfMq8
zd@V=UM|PT>%Jsp@aIg9`lJ+gTMX`?LJI}@9v4eTR*j>S5{L1>?iA#`56vU8dlG!c|
z(KF@}1n!Bw)4iE!bgk20H<c}ya&gz8>~519vLd9=u39L`B5sAqQ7EuU!?kELzSy#W
z(JHOcEt%RBPwL5wkow6t`NwE2Dlxifj?m9+kPy$JtE8w;r%I~qViFZjb<?u@bGQ;V
zd)(Eg9s87F_3Y8)R{x0|@ZtRMkieQoXju|it4sIfsku{@_BK+w^dkrPVWyOHdV%p+
z1b`QG3pbZjBeP6;LgMdC7rz%zrWg(=mClk7W&QDueUj4P3VwmK;FGRHE9#qBwJGQ>
z(1RO(Sn@6xEnGCp9_YZ94I<hOXo$^ezNi!JMrH-LdYbj?*jznnLs6lt62Zr8c^6Ah
zXHWX(m4}|&dVYlw_%T2Sh`I)j%Fchr1qCRsY_CaZYHO83PQ_K*GSuR7j@xI}n!v{Q
zf~Rs%j|6S6tu)CvcxbaVeJgM-w`W}%>@{1h3TDx~wDJh$$M84wcqv$R92a`hz1mZ1
zTSvdT;u&>TFf>n!mSz=kgq3Ir5Hw`FQQ)Yr{+V>}gUT><EYN#w&7Ve1G;Fl*xucW~
zG1vs)60lPafjnr-6irNmR0Fs6rJ!M>UV{c{^x;o#G@>-WH|adY(U0w~0)>rfb8gt<
zoC1)D<)p*lmU#2rK;Vgw%dDE#1ucD`r533MxRjHZs8JU1ALG(3n$M6k8yFy$p&_Ka
zttop4vk-y{u(MfxrHHT9a9ELj@#>uB75?#tTbB@Aj7=t0MYCMGrGvRlOdEL%Q?Q+@
zNVi)BqfpHh;^*N!4wUqYpX&vp?vtQxnUpJuLl1HmP<&Uvl;^Xj*DqDZ2|*6xR|}FT
z#Q!?;lU}ad7g+!ev=+|PKA++0R<NunW0Hr=KiyNTE+^!;SI>_~jQZgW5a$vdxR4W7
zXS#7ktnhdayb4}Bg$|o@&bjQ=5B2FjiMfYk1I~c2!42s;xJ{gLm3YFI@oD>sgWzLV
ztd__(R221e`M(}EglhW}{A9;|ehBQ^h%CFy?474z3`|GF67*gCoDTOffqJ6A55#H#
zA?F$J;9x!>=eVG)f{M@-ney60X@^zEusVE=?Vexhxz$w1%Wepw<E=dJ{Wj6yPai|W
z>0;zC$s4%Gw&w8ntdF*qRf!)EIIPg}D4;j3*}T}ZwUM6#(ijD(&Yvt&%blyLH6md5
zpn8K-%!pRAj<%c(3}3ZL!(k&YWwso*?7s7=MQ9*|nLsGe{-n7=9@Y$s7gDpaEE-*)
zZn8G`xwy%5+(W0B=IoLPf;T=}-zqnfMF^9C!r-H#+tIJ+_q)=$mc4Yj-n7Qu>4GSe
zS&LZOAec^(sPDNn@;pTd-nWn*#z^u}kR6?nO<soLo1ONY7mlgcI(U>u2?_(vKmy?|
zrz(+<p3wuRj{4KvYc>V+%UfH8b=l`Dmc5ATLt@!z3R{ZA(TnReJfcEAqXP}#=r%xp
z7PYjT;>vn2b9y`Yr&wrVP#z@xEtDfqUUgo&4zsn7e{h6(#?gu{#c{g2{xSA4(grET
z(TLUEfrj)!NR=6H%kYpPVB3r)sZ`GvuZCkU=9e`n{G&H5c~TRMKyR<|-o>Z7<ewO-
z12JEBrIc{@$Sw&9Q!h4J@f!$LwBbCr?@=g8q{(1-Ek4>b&ESj9Be$*gKjzuW5?QMB
z?Di*271R?<$5mg!LZr%2z9)?Lzd%orz**PwYK;5(4m?%D8p`!xSw5c2EdTm@%ps&B
zQVM>$<lgVkl=3s`QX0d$cfG`+Vc;E{F!tX)!Aw~yyldu^>J^wAD8BvtTCj|n`a`!l
zT;Kl(_L4nYgG6XAk(lsy@+OvXlF*Fo1YZtAk^W(Lwl`7V{b(^~OzJ^$ZX`{J2lAY`
zQFCU$pKarX4*qjvTGHHD8YigsXaiq`W#uB&G`T#3-y08u3QkhDrV*sUh-p^=l|VSE
z#t@cNl(wnfS(Oob>XG-#>3Ubx!W2KIb(OIuN<Jv^PF%0T^{m*WqS@bdO<u%7uJ3kC
zloZ~Iwphxbty(hQ#MNiY5=Z{_Z>UObn>R!?EqE_+a`k-%-JzltO1;s4g#%J9o-1S_
z)!_I~F_lt$Po8A#H{R-ADIHw<H5OL)O^V^u02W<zw;)}Vwt->U!6ur{<YUMJ&pc|J
z(ckHtM|7X&T7`_iF-vE27k=Bh5-q>@6M;~v3Bub`<Qm=GY)#dQ)i*x<Y{Ty1>CbH$
z@N#v$Qn1MM=ahKLSL`UG3zlTbmK$pT<j9ZcOWrvhmQ~o3ws>Z>ZpS)*CNJ<y1Vfcf
zb|eeYw?&*a?j;poh*!a|tem!$5^{yirwi6QGWm-+pAJR74$#?34a*h{1r>+Ja7zfQ
z8bb{n3PP{sIu=J&=auo~-<c>iGf&<?X1<y+SWw8{5b#h?)n4rGeA>jQFmR;AOH>hr
zGi9+9jx_!OdSIl7`Mp~P3-Pqp0M}x#4NQ9wNn$gB2B}kZ9=m9^ZsIH|Q>)SYG0AJE
zSe`HS4z<$ZDyO(r9MqBn<UoE_EE&S60$ms>+bj)$r%c<U+2tL(x!L<;hGNfJcrdml
z9EmJog_*0Sp0Y=QZJ9Xq>uizSl&NWMx|1YG*12oO*tJq>o$wtV>DTYM6jultj5Xk`
z|MuDY!N60M>GV~!Tk)bFl~-}UkuyVIAbBz&tp7ggVdU$<U9>ST^B&zWU{K76v%oJO
zV`8l9rKU3{56GtxG#UJvM|Tf+d}!oE>sH3xJ4)R?3Y3*h^`Zj-b3ool9nJP5ZxpLg
z>$>ID4|QDT$L9(6(C23~=!Lw=l*xJyD`7-|ABk$H@zpMLPuC#uW9Y(gpdKJUP^!!B
zyK!eIulKVa`e^NO%iM11t)%M#DWV{uih!dx+t@s;-eWv14*3?(wT^P`$#Y{GR)U&K
z$cg1SD?z9>>8&&ZrF7_O>OGR4Q(_0J2fArrKl0w{)!U3NkWrikFYyD78gQ0%6$Wk`
z`))|1;f!-`azec&_*DbK^XU~gP-&rby7~%XB=#jk&NZWnigI6hMAFk#?{OP63*K0Q
zm$!XMm%dccgEPg|F@_6!aKGfvxd-QS>h7`S8d3dwzS~)y95@MH($mF@Oa0)n^^^;H
zZ7T#QBgYV4#W(Te&v2%miuPPsGVriNj+Z&Fjp=ok8H$vVBy_-xfSVIIwEa=#5Co>2
zc2v}cmm|P{uO3V`!7kppKm129a&+T<A(T$Ve?>GOY@zgmKLY`n5>jFc`RS0Bk#=!j
z4#aTAkB;(wP32kbizJzBlnvIPDGcX`qppu6w;lOfR!^dzO4z>i%XW2wGKkI_Ppu-b
zx#o))dlM(8V`Y4RgPFDm#&w3NL51VHU{Phi44x}N%Xvsv>n_RH;4Jl2OXHl^SM^?%
zw1DT>OAxW5GYEv|#8{<~J$%K5)!THf@g#I{b832RiXJ^`iw+bGTHwuvRGq#|kMQXK
zM726Fv#WsJYIg%~#B^MMg`3cf^f(J?@H<*jWSGT`-*i=$e^+o?p?&xK4r0GCU}gu~
zNV*&)!cyDgi@Q!Bf5M(C@?+n4M(?68+eLlG%i~mBxBZy_HJVvpu1^+AV@&AAZUOD4
zE!WJPF1@sw!JW!ZGpqbcpHO3hm}&I*R#*_45aNfgpZlb<=6@W8v}dko5tDCb>SqoQ
z1H<;gXBk9jybStNxu$vE?p`*LyJ?S~oCG|4yn@i)v}_aTJ?d2t<284AU=R43y)wOU
zaPXBZDKGEwG}@ldoJviQFbee-c7C>Wf0&~L^qqjB*mYcTt>DP}%g66Tq21`rrenav
zIWdI!2`+1r{T*=fn`vMYIBsDt)UiqyEc<KHMQWsY5E`O#6zC}nt-5u`7hU_%Ynhs|
znKHqqWYgb0owTm?DRCYz`eTI~6GG7zQv0Df@PXGaFtkyRrwKW=+Nueme$ZB7_^#>1
zJsb?P9=+MrGV2>|8l|HS2K(?f$|6X0$iAL<R@XdXx@vNa8{_R<?LgF0C<Nzy6Wccu
zr4vMeLQvmnz+dXJ*tI<@2!>5>61gzJQ?&`>0j+|m1T|WkkDX2iefijhss#+hoW*4C
z{7I;>@FDj<OKk?J%cxo5%bYyIAl-fUD~C;mU*mgq?borWFAk>MZ|~}KS9}L2`P}e|
z^jo6v2rG{3rJ4Np9=OkdA%kXaqPSMLF+G=}qFC>sg9%<70%FMOYFNNi)|g8$g#HXF
zII9kJBCgtHkV(S18xdPyIU!(A@PUVQ@uEMpH%5yFONhSA^U`_Rm}K4UqxYB4@S>C*
zWyBA^zTt4%g;~03!!~0Gq6Xg?S@v+{2ag`VbhRYHN|Af4Ui)Y9jI8q2xourg9k<bB
zOO4De|2#6bUvW*IY6qn#L2B%MTSb)&Y^Jty(L#&wZ;%2TNrrH@StI?}W!K%9yb__<
z6@(XGzS4DC7u8)<O%Q?0h2yq`z2<Z;?LZ@Q`<(my_@vCksn&gpOF}$+<$Q}*x_#%s
zIduA%<JuU_*5t(0j4#n9L3DEU3ouzlS2f?lmLacZt;nnM?WyQ7$A-%v&-B(uF<`3&
z8X78^^%Zxhe18E2;M+FoZk9izmW<EhJ2#kAL+mfBTdMQ8@9gqW)7`^758q>&FF1wr
z2%<{*x9Z^xHoi1SD*~$>?<D8(%}vXQ+RF+k%djjmz*bBkkfXl*YbTV#q|4JuYFGvN
zi#}{@-hZ_K!0roNCB@e*Ylj7f^YI6V@HQYDM3`OMgv*7yTWGg4sEf3dES9y7VB(8V
z+twG9W7Ct3-AIRZ9{2ZakFEFAw>BtVoG#!PjhOE(;3jzPO{p{3dyiHw@RM2A&Nf$0
z!9L#D#DR>i2>X2uCC?4+;HWi^rK7*YSzVZ6Bv^tyB@bi7dE~g|4sZavP2@?p<?)^L
zJ5rTTKN1}%mF-v(9=Y`tUT_T7m=cshwgca$WiZ>~8$H3E6Jl-|FTH+HKhE@DZMqu7
zs!q1jAY5iY>J`@?HW}YOBWykzok9Ju*clIx4XC)VxU;9$Z0Rc-Kaek<Y~L+z4;dy>
zC#4pwK%wC69Khoty`*!xC9-rtAai|Mk8FEx#h2B^)_d)|QZtMk#sCMxUbU5kTWE%4
zl9MBOc|yVT+_2gBjhtpgRJ4%goq*dJ0!0Slk<;9JcRgIon?IL*(h|NF1!kOm<I{WQ
zncu!+G_iZP>NQ1<I^+CZkeqWw6XKCIC&YJKO4MR{)0z*eg1(;^5|+8?YO(XMqxv3<
zKY45Ch!LO9tUZf++~*kDFuz16n-@zCgGPDiuNFR{1;@!d<GiHIMV;q)Clj-9ux(tx
zYf2;fmMWQ2@A<xh?~csTDjI5yxlu6~jFQmMSY`{PY#S*(Hn)!>#MhqBJFX=gh|mL(
zyr}mSSM`3)^Y$bNoewdeYV(rvW7h|yZM%|;W+A19vO3QX!9s5k1*WD*Nxhab@-r}9
zdbB*hY&$TpCI$TQqjzK=87jn&#4p~pb&vrSByWF{^#>v#XUA}vB8dv(KY)Wy05$mS
zZs4L7d7G>}@xy-o_i-$=hF5z0&kzi{sa!x8*sAGKrllJM(m!P6KR>lmLvwhgC3|N{
zog4GLdsSvOq`dAJ+t)$6;TI?ZZxG7=E?;SDRTzOX1yKPIj6~a(wv|=m_4#n2%ce9Q
z*-!QsC+LvNF`I!oNiz8wEvrwZ7~)FDXuip6PA;~qzyB5RKR?A(Ekv`F%qTaHG#~kH
z@tx8%Tkb190UJbT)rWiQ>FdN2A32%rZBE1VwsF5dYwbHSCy!=Hq?|ViEe8MUMks@v
zTsdF*K_#HVlvZ^?rJTO#nA`uV(sLfL`~M1?4<ACQnQVlVkJd`{NUGv%4CH&31)=}K
zYM27{NJ2S2+B)!TPg&6fnWJNV$~h|3f<WNBBukNLb>JS<RsBXTW}!=~Tc=8QWN8T5
zt=$z(E69&z%=}4_<l|IGh35%^?Pc5J1=S_>8Jj1@2km1grxlZTFKIX0?;OtN3C@7O
zzg^t=t2KGwbK(@?HEXW+Xjz>^HP}2x$1)g-&m7BtQ^EF@fA_+F*~fD5+-U%vcpCEM
zkgsQWJ}@-VXpY6Xy+frW7laBbA9rE6nXy`T#5oo<);H?XsmLOGpxf4OALc7A9*p;2
z>Bnh&_UaTXqx(Lk$?BBD^2e}kr&&pir;E>@-Z}@}H`W)tonZOqTNhYN%do4&D#Q;=
z4vQPlj?p8<M(Z2ojZ@f9AI4BlRU}xg(ybDNS9jF^UhXpOJa>Ogl{Fu`&RUWlVGnV~
z!hXF3p=&SFwSVVu%d`GsxdUF85msx{M8j)c6}9%9wzes%S-Mv@x4Is{<Kds4ULst_
zd?7UU3Uy_a+j5EQ`4E;dS;TGNlxX?vgptAh*nYo?$f65waD=bbaD7oux=CTK)P}=J
zol1?+$~n^D@jIjg|CRgI?W=H>QMFcQr>4hTnCB?|MU5x^rsvZOkL`~G(8lYF=;7EC
z{94Pk>cOy#DJz6_SCVGtaB-X2OP8Ku+3!>oyfglguOFwv>vnB4Jg=w>Mw3U6pV&r{
znNqMAF1=cU(8b^Sji6Y4yC*s|GrXoSCLQ<&;+#tpiAtz(KUYZbZ@Nf&qxHt<7|L;V
zbuf+l-uCJ;i*K5%7sMJ)7n-tUsJ3Fjl2I3FiORuDzyo=c6njMJq}T3wXKh1n1Ojfi
z;$p>8g^tA)HH6n*kvbJ`$H$mCzP(DTD@?OMAcmkiN3bA3OrQMZ3j`23g7__IrJ5(Z
zN|kGL`z=;mf*!->K>Il<C}c_h^`frn&3YX&L2_pFi|sMok#wdIcbZq5<G7%A03yL=
z)r5A$9|NJv=$~awtnXy30K&U-Sv;7<R8A(?&F(Y<AT1#crb~WaU~Fru>M_cFslqi|
zco8^F=0Naj-W}7OB24*hdb$i9Z*iE(qFSZgw>Y!x+iUOxXAvmhn}=y%+AP8JKAt_o
zwcX--X7sn|>8}m9Z})pXqLg1>Z}Zk8ZSWj-8~`gx#%>pmS+kmKz<ZC4JsPhAKAP4Q
z`_e+%seHVHVn~1n!d8qwu^^%9QTu?p?H)ZXqJifYjkEI^&HUQED0h={ff7k^oSg`A
zRcTCenD!-IYm!R|mizIR6B+e?3iAV#s$u6+O|I7W%`cU&*1?~K$5Wp)`^SHKxTh|=
z!$E#(ZMELpd_mmUUwdJ=pBE@w=nw|>TdFPc&$jZ~)pO4n>{8J6;(5;ZiQ!kvq1s1&
zP&W3C5s8iu&bC<OYMsc)5(BE8h{_)qgzs_xwLc}|Qnmfj6?(^UG;MhHf#z~@6hXIN
z@C34qMOIVMpPe6wg8Vs#Pk4+;l+48;(eMrp>vk!X^QOiQO&7XdIt|FIrv#rTuMNK0
zH#wx^A~&!?VU8%3S<UWz4a9ep4ODl4C27c@!~EMV0ekx{ZP%j)V~0WdbavFd-s8|b
z>Ck|Kv)B;Nodb3~-0ejRc41g_fP$B-K-R4KR5IgV#(8Nvc<mL=0N+3HX#}V=Z=KxI
z$uiW)P=J&i!@^PLj9kEqMgML@1ky$InB3dgBF0!_FsieKfv0UQ4`+#QYM?&)@Zrv&
z+ZzHE)u@v5=_mg$rz<|7k3`tl9kF?ovT^uj4|<!sa_#aWq=)FzCPf8T4TjfcLeEWv
z;9B(eFH8J1o60v~y)7$^jm#n5XA8b7X|7C6@28oQ|4*Dwv|Ennt!jRx=XsiBXt_FV
zUT$Jy6+4kokyOjKJ3)r2#?o7-2M(^HBbqa_q-h-q@q~A=YRx9n&%%fphMtzrPYk|C
z;Fv$VB!l_MV^I(yg}86OWj7i!1M8y3%0s5m7t&+QI2)G}6t<yIN=zU3*4t1<)g4Fk
zuG=1Uhj_iZEAY2-QdpFA7^@GWMr+etFs54bjxC>v-8(g4ZXi!ps|bdpt`p0cOZyl&
zA5jdGp+re2>rHg}e6;b!sS!Gr9&aY_G7H&FHZa49uwf7BRFBADh*a1QM->i3!Q}C+
zdD}=*$6)#Tps3inJ{d<6sXB@lvn3W%g0HPT#w^Msn#d>vH&4$QU$7I-b?b!;Dy>1!
zrfR#L5yN3zueUzI6_2`{i;^Mz*I;IV!RT<{ZA<g)ed{=k+%GUt?F@>fK56bgT})jQ
z<KHz~8%(bXpn9ao>U%81dp@|}$@jkzB-5>WlqesxG2^A{Y;i;A<*^z^H~{r?ynLM1
z9=++UnZfo>Z>*oRzpc+0c5Bju3Dv5nm|<RdzgeBE<!N`05<K>Z!m(F3&_Tg!W(1QC
zn8w_!LL%a9Qoi!PuGRk<^j=x!tJ#Yb0W<FY^Xi@~NU6upvPZP=$>8v0#m=1t1eO%E
z2{_Yp_q8!FtbYD|V7JAhT<Jb3_R4{Wd_s%{aXcj2$kiG(el$F>DLVuG2kYZSj|>Vq
zW9GlP%~Y%oGiQ}=M@X5SSS^{~j@gnMzRDN7Tf~ZVES+8ZJt?W7WE-cmduK=zm3ZME
zb8^(0{Hu=@j^RgvK-X3gDRj{R&uDe>6(t`I^+ixOIFN8Mt{_A6Tc%C@d|gOO*<E<D
z`<-1=3kWYMQ5|;~oki1=DeZlCFEwaa(g*?G?^J4?tk?+A16<bj?pHHZ={S~;ZR-#p
zByiEEzG^6xKAH^k*1DM%+7o!ym%^t|m3M{oSc?(5R+~NG#lOz`_ijtrG0h%LAQF_c
z=(;eViLUz@rXu~G(VaEE@L0<#4ZypaGXdGi*uLgjFn)vmH%CiUvMXJDfCz31pqRP-
zhOaF;i3Wdsx4Vy27<D6Ann&CZ(;L0mU!;=l_A%pgR10xk#H7^c-I?9*@WescS$gVd
zeYs2Lt2Iy;8n`|i775-mvz#Bmq{&FEmXy<h;3+t+zq;@UtATgPE`gBX?D&fGAj*7x
zKX!u}QAZ}MY(NTiIMPC%h?o=*WgMO3-~)fFv6qvA-?yCE|4Ej3=bp7#h82?Q#LhH~
zQdVE=)FR^BN1ybZdtL$5ly~hZ`Cd`%#79-evbZ}N@yk8OO!6}25aP<X%qeiH>TD{Z
zv4$D%UC2CG;1vT!n&DDL1>I}MzaAm=*iK_emXa+0O01kOIBm1(*9Q7aGFFK1+1pSN
z*A*8rQCUZM(55Q1GuyvVFO!l#WAxGLx_2wo4_9GhNN8T(6vz5mf9I}qf$!M)B9E?8
zVp{5Qf-sgw4wr&Ve>8uzRJnZcLa9rMt_}Td;;f8#$~jbpu~9_|)O{9_XC;Fm-K6~I
z0DVa$fvM%;y^XFPJA);R%wTFcX-L>%wvk#}Zr46%v#J$5$8T-D<n3HrpEfEN4rpJz
zyya5EwX7<u@tZA+%c_#jV9=UcX*mP3(Sz{fjU+A~9e7sc;VT6)BvI_Lb7h9rB4#Ls
z-QxYLC;(m8WK@<V6MRZ6bLjZ7^|6<J-^SUNdiz5w)=@pobOT7+vY6=mf=-uCN!~(K
zj(e|OXE8?%_;26X{n2UF&OH%$!!O^7^m=D)P9k5!_AfA3`mOM8*A#%|Y(~+zG%%G7
z>&sFcP+p6PH5=2d-*cmnygD1m&B>^LCWUr?{z?H0?1Q#dg%&SeLm+m9;68LBP4_un
z2_-_*{fRhSEf`OecU>#7dh{+!p7MjeNlB;g1B4OmSL8dYs&W1!Ufh!Ua)>pw;Mo<7
z2yypwdkNCs&?6&{AaK#Ss$QpPuE*By+At+O1u8I@*@?;<2K^DS>d^2bLj;@c+RLm=
zpOmHc9)BS1*8bw-+&d*PP=4?{Uuh#mj(@cMx2!97^ir~~I{QvO9fP`dJz^g%bIgB`
zo6Z&v`C}UIN|dLlo2$L55yNsD?QHkn6W)67FeUQbai<HLp^?9}u$WBz`T7_s=xLF-
z0~yar2VAt@)+q)eWhGeI+*_Mg*0Mnxi-iH3=M?9;gW0@Vw@#(X9GjxWIEKo6L1~B)
zZ<)!F`fYlm%aO5Nl_ptT_Y%@@wwWq6!KW)4c**X1c;?>@N26b=sQjEn$%N|n-mduc
zcL>GiY`)8t%h37cZUp>Bwx7vinL;rWce2e*ch{Of3ywT5yKY6_SCu_(Ug?lQUtR3r
z_`ck}mNv>4aOn!62>gbrps9n7l9Fx{=3I@4A^PYHfg?NYuB@*}v3`TTt77gFl(5f@
zw)c@;wS#yKfoQ(gJ+*`3qb7ZN^(5|4gmi{m0b)vKldhqY@&AFS*_K2}z5y86@fb)?
zORbGC#%n!k&KPb@XjDY~IMHK=FV;_zV%C*i!Q7qFqD)Dtub#A+42-~HB%(^xe50{8
zSY34(6MMOL;DHn`OQwH<Te|d9L;SaAqoU;pC*Jm;ouq;K6RYZNuU}WGoXcaQoA$vw
z*+2_M^iZM0iYV6@Gu>sza@8im9f|0&vBSjARsK*<H(#1Jgd;whj*rF`8Oj;zRJ(p2
zkoq>_S2BMtRYbA&GdJS{?3i$%5*ds)E%ZU=O)p`UFV!<Hn9HmQmPrMpg0eweF2<r@
zy1U>?L&O9=ci8Bv_?+X?1YC+ci~6k^3c4zty7<?jqoE0ZcgEijMPk;JUm4D<lB@#;
zXFs1q(9SB;wr(pvTd`;tO(CEAkq^n1c`b;jD?jlj%qz;}i!B5Nq?TF(VULCF>EXxj
zuF5Y~-!FIxC<!b6qZT>)IxR%i7I@fcJJYHs^FsvK{8K(EW2|Y#_Ap3)lq;8p_8~s)
z!tjdo1SLRmH737zyBahx0(qRyvg~I~%7=`iCs5t6T~F=$sK=2w_2YBwTELv!rQt4R
zYjkw1G)XPnFX(k@u+SKE>UD|M6kvF_GBVFx)S8SubxB1J+Y*)3I*!XptFL|iz}1LT
zu$gf-+JEU2m*_+;jAhheR_1s6t}nR|O~wmd2&4Bl`5w=HB&x9j(`!}EoG<E3kA~mF
z?AxQq^{_szZrRkIQ>$(gj`~A_+AMan+svWreqZ9z`F!!)o}-?sEa>=XDu3jo!bkWG
z4)hKsuu(eLww@|z=LMd)(nsXdL0;jx^vTpC@;1Egi6iTc<_1nWxsd-YN%;UmO0_Md
z_nMG1w3>3%d&ll+^^^PRDgiM`y;yUC7|LHDawPwhh+uCmN>~^}C?WuKyK5hd;~WMb
ztlSRb=Iz%E?qR2-)LlXm{rGgQId7Yf593M(deJS_Tomai_Ugr~;|8`}LJet?*UWN*
zZn>AF*}%q@;^wu<@bcJEyq~Jz;ngoutcs=l9ulFb8G2oEM!xI$I>sJ<f)%u*)l~l)
zYWOO;{|&zzleH)PSzStL)Du%79>;1%a(#DCxe~EadMH`^?!0r=bA6zf7FEq~1D}%@
z)FrFd3_}~?oVvHY5eT9ABLV%<az@JL9(8V@+T4n+y}_R8uEje27clgeCJD{0`b5<m
zk%2Zvigkw_Qrt_H1b<JCjjokvn{70=xHHlBJ&RgeofgE*u_N{H0;rR)FlpHv!^Z0z
zoT4XS6vn-yP(1?gURa`+6vh;4kQC+-s&{hJnw%>K4Jc%4zt>%E&+B!jBX&zk^CxF}
zE)_+DYfJICvuIZ>RTB4Pia1iTw`=Q-v1<5Qx%Lc=7Q48VvZxm2`-N7;C#Y5u58%a-
zN2e)K)c|WmW?>y^kLyWs_?AtP!13Sh7YVv3G?Qn22UeSHiN&;m{X3b`H=-S$^F?}2
z;ZrMkuRm6Rh8Lr_(>xR`ft!r(>|ODkkLsHlh*(0B?<jo5qfj*=u!gT=Iy{Tb{ux&H
zChyq{RH=mYfrfbxF!R)sv;xidE<NFilyatSjFOO}wUOxE^n{D2<)|=T10JYru(9JN
zC7)vi>Kw_?Ss&!gw;qQknkF|!rVT?+u&sYboVY*a9`V;-yc0j<qARl8u~mE7zT5_h
zIeZ$b6JTmzy!<+s9+mON5+z;WJFMF|e^1eK)}fH77P*_6DeG*UrhTZsz~qt5U?Y0g
zpcfz5<uq^}BL&~Oz)hmGW6U6`-GnXGgrQXLk4Mv1Nr{_|5>=GS2OABhnK<v+Vl-<*
zfD0jyP-cW*H<c#`QR5npztEyda!PcgMAV4ugD`auV1`)x>Exff)|2k`XDRcQ<Xe|8
z&RFK{lOhHAf>&keH|q&wiCNqRMn89S?O^V8EpJjVn=Ov`GZByMSOm+@y3cWJ!8H5|
zG5omPk}^((Bd}z8W@~%Oxtmp+7jvfr(@u-KDxuT<#b&XgYi6qDv2%s9(uVHcU1@38
zz4qg_m{blg<r|>b7Ro$q#%O9;%%SRuv0|1rk2;d-uJ{V^LaTeLM%e2&e(A^)Oc8)5
zVQc0~A3>yQ*$y>FcOO18@_K_q5QtY(=Pfn$x+$YA-o@yHhcQ-o;YE%=yrx7OHAGBD
z&S5>?`gC7{F7`_Arq&-sa0vMftd3=4M?bfU)~<yyoK$25B2%eX>rZ5#I9{<l{)rPp
z9dJsa?>oP4PBZq11X*)DlfOvZurd9J2#NPEs8U{bqoLq`BlnFJCL@w&31vCNl#XX6
zE{}67?a=;c(aLJR$;N6J*Vy1xI2qYFuXWZBFK?czAYS@C?fGLDOt}MYBq<X;Vu$F(
zSI|Fk4TB~XsS-WdThLNoD}B&I!ZyoEQsIf?3pcb&Z*`hpF3+r7TskMZTY2h*ZiRf3
zf(h<>8Q?XB&MhZWDoMw}&w?Orb=EMW%Si`!v}irU&OD}qe=p=HeG%6|J(4`rWS1RB
z7&uguya6Z%b}DRMK6q2Rhsgwe-6=LaT|l%3FvZ`QO*tp`_y$Juws2S<o$II3ZDW~?
z#_=`_7n^8t6ngXEC+lDJd8;mIzuME@bJJ9`VUj%cU<XfBn;hwO47a!#92d|PDI0aM
z-nnxs{_^V>MF?7}3OHbWVP_F4)@x3y-&(yxb0g&_Tv6f^KB5zuT^_xOq4{P_L<;aV
z0Oj?t>9}PzbLF+t*Af!NY8{rYMLB$|No<%@HqiDOe~vP(EY@;-*I#|c{?y?Ub^QB8
zACUCC`*d;q+rta7EoV@qL9QRwKV~7;xWy^L!x1*?thB$Brzfj0WoqqVqpD{ESv{S>
z&_{GY!j1g<Pg5}@1OuD5l~$vk`xp$Dfhn#&Hu!EH7!FTL$9>!n1nK~e(^I;5HM=dd
zq!y6_4m=;Ml2Hl$c32@uILGC~`h>CXA1@cTs9oK^@?z_%zy^N^SsDA@*VL_}BAf)d
zIDAwY2fjZk#qYQ9E?|XK{U-6mVfSH*)c>cQGc(C;SVFsk>LIhMysNDZ+w~g~cC2$C
zH-Yepg~t!+Z$OBF2H>)=OZC)Zi!H)s(R`-CJ?s4%32m9l-btT5r_JGrDp<HSPcA%b
zN61DybWJC^jhX-*>P{^3>8!J(&4CbguW*`|1BChdOQ~$$i$BV4Zb8X$?3^MQ#C4`*
zFq#|liTcH2-A)75R!pCn<vSMU;y#dIK)X4yur#ZntoVS%e)$X=A17m_VojydhD?ad
zsEMn*RIAqd(~HLH)dmhDuKq5TQkQzw$r=7JoZjjJbB}pZsRkZ><R}v~5;x*5{+>UJ
z>|@t80R}K3DsAm0@i(YtLX+iZIq?YWiM*=L8}mMJt|T&C8%^Y5IUv_x)K#X9Hf!}@
z5&!kdyF!A3JFWeRaRWMf-^8F=t3i3fc{R;p_PsRA{-D6Nn)*oNe5;cONF-Q~d`r{?
zb|5vJo*+b6JDV2JEmonrSh1-AB(0)$F=n%{@64laj}GgxP|(h-<bVcW6tc>DWcAA&
z>M`~R!^M-JF4jqWg3_5{yn3t&<FCv3IPO>ip^4HFbn#+ct$L+E(3O}6Aqt9|k1XAL
z>=_q31>hH>1-Nr-thC4blj7xQ3rr6&+V|<di!axm+XeB5#9N2QGYHQX0k^ncaMzoM
z-Tf|=;d>0BnTppR=>nF=3)Q^fi%g7WCwm<)dIIyb+fwLEunJ}de2g%CT{0pTsk;L~
zvPi=%z^v7+**h$Sxh9L1qJmxbGQf@15@@YBGMHXuZcdP;$bywQ1Fcnh3~9-Hwh4#n
zYJhdZp7suQ{#kdBxupa7LK@VV?dA3(XIs_#G4_BnQ{*pz%n>o4wwSU81C?d{M&D>Z
z9QEjC-$#1KHywBFm0ZCVC5)zFLm%U4)MZr~l`)F4rYy=qWOlWnL7DC`2Dxn>P=%(8
zb$d2KpT#s+DrKr{ZTT79s(XH3wUQ=swV;mu{-Ujici|MpkKK%YJU_AdEZhS_shrg~
zgSo!++B?YMwfe+FnbQD=>`$D%JRldpDzAdrhk}CcDhEc(Xgzp8AxQ?vK}X(Upkgd9
z+AtD9de0onIsAD83<Y^t^Al6dKly<1Rp2*tBVf*7Jnt2;u)s-^SujD~Pg%0F3ik-G
z)RR7puj^ve8Gw_<G3O82FxKYMtjY07vwpw&>tgL{*DP_fy0v6i8UUv1(V>-}U6|q^
zNpl@hO{tq0h7-nPAoiDSt$i8Xo7775y85aokO555+>+qOh{^vvu(iJG*CsQOPd|f&
zx81t{^WH%2-F|Kd=Jt_a49~*$gzjA!f$Z@1Z=ath8v~FU4khZA?Aw7?e40oSxn`)i
z;ys=^H|I#v+?|n<8)QqRTtLp>I++70oiN(npb8<!+8`-zI@^Bx)3<QaYM1`&srgr+
z-`YaV<h)<fqF`TJzJoL#>-b=|A}YofEp9)8&1H;}!Jg>}6q^m2#dhx5wQbYw%i~BI
zM}%xYsUv+n+20Tg!vHK!2t{!29AIx8;HtJ8{9Tn-_xeD=Lnn;;SylQNlBE4^pRI3~
zk&v(T;@Ltjywh`>+8^MGyJ;?O<ht&c&izb_sumjY6PciR`MN<Ly{!tgtF>z6`9d<X
zu{oHDuT6?e2Xuw()*7@`QJo`WE6>1RnDM7)v}@KX^qg<kZDzC@-UOj{oW!=ZgWgmd
z>`??*k*}ZHq^M>bIPSn|F2ADUR?hhhN6kC7sibQlPzzxxn6@ncgN>&v2M%x6O^UY;
z?5;kGd&)WkqJrvhhi2RqWLxDWyyteTe_Xj(@c*dt#4m4+MJ!Q38PY@>v3{SYaGN`F
znySV!<rG!@;i0AFVRIrGca)}gr3THryB2qmBnD^-=|$pU#@KI82nDv!Y5mKefz!y8
z>dgstN#9&8AciMHvNR^r?SlD1Vo8Bd7(~C%&V3M5#sB}t$$Of;?uiz<bPdF{3JKdU
z;3}^~>>oV5gMmo|?-2KxaSOBs4um@tBXxJA%ALk^^gZHm3{+gkbz{uMRbxjoc05%>
zzz4gwx7l_3Xg;}8#lGCaf7Rxh$E5xG8km09ZNvlp=c(_<>X9ri4~EwHDFlUL%MWf=
z&+zntcXssxui?Up8}n8Zj7Mhw)dJ8Xu;5+Wr)Sk5+!tn?uZz1#;Ovx*-RI0ixQton
z*C0HUUw}cNl7Zi(Is5F2x?iUr$t}}Q+pOm9rT(!rON+fRJXWsWx1hdj;ejWF?n>*8
z7I54;YwQWdVn|}M1yXB9h=6m6mmJA2UU5G{Ek=j$AT5Az^<R0VD8_LKvPIrWBkV24
zwh~lCj4|x(|7NQ-*I5BlR$3)BehDtX@@y&!t*t96Zn@v6yJmDQ)DZ4$yfb94n6Rbp
zC~M{^Sj4v!xa}W5&8k&$Pjm87T=788E+jb#dN#M5SjJjGv4lT({Bskbtm+cNM~(2q
z;*ag=`>$nD&3irlPR2t$&7vBXjdq)G9y3$j6=OG63`c*(M!wrSlXK4gwp^2zGJ3ds
zZW6x>?h6BADw<el969v2=sfbdEy16E-bEh(nmX&)H@Ir}>?i!-?VaQ=gZVGmyy&0c
zS2z1Ql$1z}$dna(TSP0iQV50`0L`(op|-v;R!OkOC`SN-EjMdoRqxaLmE4K(oiew~
z+nOkaHagnXC?1F(1H@Ob)wZg*ORpgDr>Lu8x7$r58SYfkOy6Qsg9)QYO&nalAm5^X
z6<an^&egvpKCbELPRq-#>Kk*o0J2SFGG%5k*hZ4ZfIgtpdRe@?ugQA^4SBAzw8rWI
z$f9hdndd8|S}Ge>RwV9ULeZZEe-KX~Yu?#vNa-q%lpbSCZQX@KNH8*VCtaXdH@9#U
z-r5-*P@L?)Asv+1)+@t=Qk*crySnam7WE3)(P>2^eiQU~>@n6fqP#If!U8aJo8-ek
zSK3MO|Arm!{aky?VyjNz8E;y7KpKs!|Edk`^jAI5bqxr5-oAMIPUI;7H}FB~jnDJt
z2*X05^7=2k`0ox`C_v`>pPT>lh)&O&K<GbQ1n^Y4(eCm%_hV=hgCV`{E+ueCH;Gbl
zk$8Ply<b#R2G3so<NbAwB<Of*{Qi1M^8UDHyxM~1ZA|>%J5HS-yS}aiQi`Fytq7>E
zGzismH6ObYk>%aisHOEm088ukbfkH8P>`WFqw&A8|1D0(@dC*0;h@0ndU7;yXSN_i
zqV}gZEy+kKTTDv}*7nX0ov8!2Ps7{1h&Oy7h0ZqnubP1*@a@~t#KAZJp|d3c{O4WI
ziRc@@*EW*K79z>>9E)J-3)<e&l&od-rp<S|93<@^U2a6m&ivj#l2miQ9TOq6{I@W<
z`h8*x1VCj@<p?B82}ODbME{nt>zc&Vf&2Lx7-C|Bx^R06GTgdG5uhga(e?7AVkyV}
z534R;00n0F<`?`$41*hVuWK+iGR7zUf3K;tGctp8BOwT|WzCoo^-C!5d{-?I4^PHS
z2}NQ|Mn=_YS?3RlGz&xE*x6K~w|?>WN?Z)|%YJKWs-&2V@uoV2%ZWv(LCGw+k@4}p
ztU82hixZ!23S7S+A<KH5n#4XQR21|Szbd@{sy_1B-+C0#J&Yq%qz$@sYIJ5Lb2(i`
z6h0HqAyCkN?&C#exKUtunD4)kQu|L=>6#W)d*c>-jYm_T7D`ngzb{@&@_;bI^1aSG
zI!@qn|1zWs_GH_p*^?+OtsXTUdR5Zuv38Zs5Cu!Vy&9r5Q(^ch=*@8*)))(c@x^DS
z=%f~}f!MMYrm|&z0QnSt(H&Jcmr^!;u;_ey{u6Q-8CWc!jWuz8cuSh88n)=%zGZ;S
zdE@&2+Ufh7F~tx?l^b-aU>W40H8)m#`agyy{OrQ*EbG*?J-o&O^3ey!#|x@;AWZR;
zdV#ZZ@zu_7)eA^q>rZYHVY!^BcNJDkd*=1}RVI9gV>l6b0D9AIr}}IM-E6qqHyulZ
z&bWHMa@RgW<+sVA99(}}T-<xR+7Dbp7asN)=u=ns0y$)Vo$kv=a-_E=LFtj1Jt^Fn
za_^TRV~dxm%LzPBQ6yUhd##s@4dy)sPC(o~K{-Rl!~8BQ)zLaE`sO-LMkhWk?we`S
zWN3t^%?evs>CeLKAshh0$wUX<UKv4>5TI51>|%r<C5KyQ^=Zr0W&`^F10hLL((T(O
zj<53)4!{@LQqzE8<BWCebDk3^na!94YoG1s&02$diM|IS8XTGr+Tu}Y>SNu%tY%n^
z=#+fP1#&iJH4A!=?6wRG1@z4{pyPA@AM9mBhJDe$`0+)In8^RF_5*0ED|Z!7HUmc=
zxcEy^_(V<b|Ab?QZc(d#EordSwQpjzeGsW<0Zxe2##mB}tE$rGB7R4ytIOx_uocu6
zeX{foOCwg8=;{M4E9=0ZqonQ8EES&0<ChH8Nc~LifAl4Z5Vk-nUd@a|E5*A^0MEh;
zSu*S}tJAJYrYjsWcOc%)8q6;Kd_t3Q@8h+(%gG3-9c>25aC2)G9qqd>nP;nN5j33f
zD?2!sjdX;8+SOW`Mg65mmv0xKQsm2$PC_o)w#bIol=!%IZ-Oii5px+3yBg&-$-?o8
z&CKS%3|i&GJjhR5YBG77h5)sX{3e!iJbxTDmkWJkR;^XHRJBkRBSfODh6D?QLlUYD
z(SD;9D9vT*?gZw5`-M)2hkkQAF2EQ*H5E1#eqFhGeBhGipC<1Wppg8QO~OyuM4;aO
zk>L8t^a=9gynwuPVhxnc^o(M)yC_!jslqMJ0nQGpf^<9XSlb`wX)-G5=nqLZCG}MT
z`o?`H1GEqWK!-Q$bsrfVH|%|G?<`YoV0}_x$N-|<0Q-OGP*1i0pL8hY@&7@GidB7(
z3;chQp$Dfa6L*)c2adgESZ^TGK5M=krKfJEZwkw@gbMQl`KgSm#43l~7}wq9R)q@f
zv*@3eYj(y1)P#eHlp>|~G@M(ZrAaPr_9`uFj%0hh5g^k#H@2eRuQDvjaem65$d>Vj
z=jWwHtGI-0P#UWBz;BuyumhHS{U)<2^d23~TWwqtO^4HhJZ_ll%O?=IA62>>X<az`
zcDA0L%EGmW>2KJu`p5mN4jt*~m$4)2%dPgb03R<4d2(+Nx<Oph>Qhmac>0VI?Btef
z(>R!a`jIxVY~D=Y=;Kt{TDYoC@3QsZ;2RU$%UQWKtTam*{`9;9>`*8cVY~x#j;l4E
zj^VUZ8}WZJ_ugSmb=}(_j|eD;SU{w!^xk_Fr1uhfQR%%C=_&#W1e7Yhw}jqnusnc-
z5_&HphLQl05|BOzmFIomnRn)o`F`Iub1wc!G-scE&RKh{d)@cidp9a=DNNRRQsQPB
zhpL`Ty{(BSB^`BN=+dWA_j-W+V$#)BJUSl5teRa+*+@vV#kNKM86Q7GBAC#6=+^em
zj<@LR(s-{RS`a&JSe9Q)y;5?i#%jyVQdC{e3L9MKW+%%BVB+QD0xkbt=V=3F|0Y|T
z9v!6z>34(xLdQkK#TVtkuO|~vK1ewyMzQ}?r-pIH<((1k%c<Gz<#Xl+#?0y@)j<=<
z`KVC(fp)NujKYB84Wur^qInGaEMaC_{R$hMIJzIWff=JW^2T>VHE6(FqkEvlviam)
zIxf}i%Q~S02Faz!9?=ky7*Iz-LZ7qLVav<s+a8m5I*4kgKv{R++#TI_5}^@EPkJ}I
zU05hfek7Qfo5mOXduZHG5rbomxt^#4!gxi+5KA+&64x<8f#?~^$7<a>X}tSIiK1ms
z05w7Zv104uQu0)_&eIqa2Ylok_PzJ$AXz}@2?LR(D&i;1_}Vu~rN-(A=mWXh*ocj6
zkFQBL)|N(?V*{IkE%wM#d5<pLZFI}|o{|Y=80oEY85`apsb%5~wtD0Jy7#U>`tI_2
z^SaHO-Rh|6JUq>X&=;a%??k*sLee43vQ*>Wyf|(_itj4w>&R7mUahqop!H{M&%7)j
zr{^|aiybuPie~^P#95FU_MI(1_04=IH=;evQKjFl(<jGPP;>lix+}HnHAP_-62EkU
z%$2!Wd!_4px3!MW3gwHZ8G*@(nJ2GY$H>{K3O@o0aiq{{JecObS`A7A3=O^v_zI)2
zMjGoeVq5JN4NMkZSA_4@v&^fm!VWk&KF|yw{5>=HDh&<dN-1|M4py>|*V(#q#bs7e
zVeFPrF1OU!4Fi+C#47%cNyg0VmN-86xLXWrkhXSIoi^-;$(}Y5r_2cly0K(H@l(C6
z&`LmBMS}c~QCJ4BW`=RFj+LsbZX<fyRQ|N<tfwo!V~Ly!@sjE=qhQJYvoTI`?MvM$
zyOe>FxzP>1yxg+k%kE6+bkuwk(DK{v*}yct;++T7@;_tW_<qa$qx3cZy>*|TA~Mga
zyy2@^1gg|^6!wii*~K9zBq>Wp>Tg1{QFr!pjFD^p{X14wuOOtPQb{~4i9l!|B{f#l
zqfnYD4hYB)stBRLRU1d&l%F?pEQ~q?y{ReBPg>r*7EGF|;MJTpCTt5$k65&QqtW>#
z-a|Cysc3nokFPV|9c?h?#mqe*NoRiKZ;|$1<W!_BvDy-MWzwcJmyJ9}-?!4p;AR{{
ziD+f<H3nA>@V7hA(nizL@t+P78TsiV=k$z$?rKbX%|Mq+P1V@l9974K?=*)Qrmzu+
z-WNddb?*Ny_!?f@2^ibA_;<ZGTB=;zmxrS_V%GeZ-V4`71QO}iyeQV|lHsz!?O8}s
z%w+GD&BLP!aWW<~59?Q;OHC||puNLH-+T&=sVpbiXrsr#??#nr){Jyz<KIKB?x>>~
zC5j8g$6=S%69b{QQYZXyZIR|?HR2N^zL^hxE(E;D?(m|nQ*Bjy^NxA(IeL2fW^)72
zm_1ML=n509EKL`5LA8g^Sqk0q>D7%l-gIwl-@9A|@bdE>myb@6?uT_#<;LZA`ig9v
z<?)v_w?bSDIg{`E>fOGs9K<7J%Nc38bj{AGS6J@-=H@P(3XptuSYWqkbeS<MBX1{1
zBMOyJ0Xdx|>M<1bj+Ad)UHQyz9oCxm$9SlHVp9GkS=9JsY<*0iNc@_cZ-b9<C=@p6
zMBI8NX#553MQXpF%~E33$slxh?GV;sANRDs#0qzGe30$3v|cTOy87c*Ov{MWk;dpZ
z-T*4guC53|u9gv@O<gW7E$|cL_ULaPoY(z3$z0U9a{zlmd*Y;LkHQGKn3dO7b<nS-
z9b8_>&cKPg9Yr4!o3yuQ44!rX+6U+m9>4PZY3_~@FB>Yn?DVsfpA93)bFFBW@R65F
z#YB%j#;5(KP8@GC2~>Gx1i<LbOdf?f1nBfq73(Jri9J%W|LDe<Ps#V5^NR2ZlO_G`
zS0~~h{j9KD)DgSD{WwD(GDwA~OGA^(S}nKzhyR$gOk5h>{%fjn2q<~wCRi(-%ny|I
zl`eGseJlHiUlWZ3{=x@i<UJ>B69@w5r1As>eora3JfG=oD!lM7AvsRUQCkrh(Z|P$
z+qpI(G-m<Q%mu^;IS<uoAc0!9A88}EJC-pti!)~@;jfeW@ku66yD|LI3BN>@T_ero
zAK(e=!>J#JE~kx_IliBHqVS1+`tQ=Bx!;{&E6-kJXX`x;KYdI|qaOPedw218H|b4q
zj`p;5Lhr+lL$aR(q7BuDla43}L4qM8r3&uQ6M3{hJ}{|ktwrneyUl4Rcb|DOXKVi(
z`ZF!obm8P3{<Wd>@<~4>m$KIVhHrWV_cV;`rfohOTB(LtU(wWvq-UYMep77kQcB2f
zgclMhoLSInx0SY4RO|G3zqx1Y)7jTDGO~fwGXRAbl@La+9lUxrN$AaOOMP#>u+!eg
zUYEl*<Zqa@vnxT@0|<Ii_q_*LvR4QqW|1{{0%|$viaYv(9oN%wFKj4d8@Cc$&ks($
zv$D|Qjh%WB!}%){N8FOySlXU|JutjM1I<BIIuvA_8B|}BNY>RI)jV30VJm%1AalCE
z2LHPuEt3n<tQ#R7$R+OoCW69@+PJasb#3TrdE%xg6?^I9aKbiQGY2+&wu0x(iIp6$
zVw<?=lufUmI10mXZu2%2^<8*GSsRy~^{i5tbJTgTOQZY@i`(zM#G~4Zt^l|}JmeeQ
za>=**%PTA1*zNdPvSnZjG~QV0=HAO^=GSv#9V%!530AY>@9&Ir8}tF#s5&gJNo+dN
zc(Y>^VhBS$=kygwR_VBIo@?-~{-lYH=Yb-+gR#a@c<dTDI}PssU<ceE-CsGe^y%QC
zXJ68E=;Ryg3W;>Dzv~b44tZ(-j?t696JpCWuxLcX^*(E#6BTu9f5`zT$TL@N_IOCc
zPDZ$9o2BN*su>j_RGs-?hTy4a_b(y1?X6(>#_oe5X0e^dq8S<x9$_>275w?8Udzze
zRb46)tz*w-RD$|7d?T4#&dQ%978~NN4pqI{9t&7ikwQAI6t91jeXV&<%qLEhE%GZn
z@7&diRQ4|(JBD|+nzJe}LN^m#zLs(@zwQz8rs>F6k%?o_Diix;3@k|w(|5bsx+Pri
zc{Rs_ijxyD*oBo#yc=ouG*`GKc*6&WVXH9K#;L^k<8S;#z>JI8^8ymytXNZbHnn<B
z&S+3tY0fBCR@}`Od6a`<O92>2lV*5YUY=9Kw69NN;4{a+P30KJL?jibZ@`o99Qt+|
zBvRxKCF)uf7ak>zs^W#0hW(oT(Q;XPsr}fN!w{4Q8~51DmRP&e@F{d!PPG+~p&4TD
z+58C8zsZs)5bi_dUhiaLQJ)nLR(>aRk5+FAhx0@yQC?vM4|~4Cp9}qzOxnBpm_+df
z{yUf6sn{eElS749!lq+n`|@?vSL~CXg1z3-GTeN?e+z42`ANZ<;W0obsH7hs9}ltG
z026PE+S#MnJ`6LP5pqw5h=$hkTKNB6Na?QMWy2NHDA=E136$W<b}p34*w2U-WMnIY
zB!MEARI$Lg-qg|X$gTo~tq1?iv6d>|eJf*q$wq=Qb@~Y~qXAg_z}uccB9qMosZUBX
zm?<ILoTac@_qqEOG0ZxgP#+r_6}?lCp3R5Tttf})Ft64<lIOJHNatBvShF!-%Hu*4
z>)*cJSv^9V*IIbBSoTUwVObel<X%Z<_FuL2EcAg5oiA$np*rS@?I%5xVKY7sO^*^p
z`&u|i6~_Rnx=iXds9EwTO}a|PLirsLTub)yG}5D#K`v6!>f<H{sRN=!nC4lJ>~P&6
zbyS_qo}@XgD>l!{sE_anyJM3|c)rrX^PBt38cM%pIP#*~VD<O1u&D^crTkL-D-GU;
zJC||7rt;jO6bHJKLjxvRIewt~*sfbm2GvZoIpX=l_xh&rd8<}N+%(QgUlfa6{u#}f
z$w*n5pIN*3;1e95UlirD^UOK)Ict{7SN6JRXO^Bj>YJP+v@h8afN2f_4g?{V#QejJ
zD91`samcof3Y9JKs8#~0nlD6afN(F=5z)F9&^IoD5F+eT#}^Cni)@KFuNrcLc3YQ4
zyJc{%mCIorlFRMYb)U<gRr3D0e$!|SqA+X=5k7hKNlmIcI*P<ilZyJ*%YnQh=sH#Y
z(ZbXOFj0}6y@yZM*1gQ6e1)!%Yy?ptEz%rhO`*8B`J_THA!BhlGy1gXvjl0R02b(;
z7Ew-RK~RrvTk%VvsGiF@TluGd_vKjLm<(V#dJsJ>+)Jj24!GV8|83iXvWnR9Q>~Wv
zjSNq5gS|Jvk`~Go!E<$D=GBp3Le7}&QZZ~W>dh?^hAcbYMW#mk`c`kCMrynm`*CnV
z@t*mM>bzJ1)GY@c3pC@Cw>3JK{1`s3d2w<d_wmh8gnwf@yv0KI%TKF~3~h!fPvmZ$
zFm$#<!vtlxTVX=9XD{-ONwSJOk;LdmY+f!`-d(}+aW6Y$);rrij2HqLYWXqr=h;;2
z*;lcFqk$a;9U;f)jEKQxa&f_XbB2anc#nrUR?7bR?&?xn^UYv#iW8fK@+n4pr4&3}
zm}9AS->>scw?URhnVS@gq(g2?`eG2Br8|B831z-LU#M8v-S{l=0oFk2{&Q6}LDw6C
z_B!9LKd1LpM8rP}-Mz;5lV4Dp{2|`x5vY(O|7dOHKnDNiEt!z4kdW2<!xDHIZ#OB0
z(WxmiSeOy3EYby$N65~LY$B|XX!np~`(5KD&cp9oixx=n<NB<l1Xf^=DQh~{&|>ph
zQ^UNFwm6x>xDfT>!TlcNpEYU=QKG05w_;FqpnK#-hh+Uhe&t@MF~XwYh`47)M6GNr
z&D|`T<S@OfiT-F+Kj6{uB4bpDYD=x+s&lB`h_>`WV#xQ_Jh`pYkNwz>$K%HfD%vuo
z3<s->{rXwFk3!FY{f$n(9GS@~Y_KX<%9eCE+W2KHAPA)QQT@TR{L^Q#?Kvy(jPX>4
z>83NwnZenVv(F!8QhibKyVzu{9eC2|W*4$FWqD=wS3`}X$6#m7cZ}QqX8hK|W=qJa
zdoK6&*T7o4x~if9yiWxZl2YC@2qGbEIV6JRUp=ZeV)CHLA}1><7SUrmXeu@}+;$xY
zWX~1poZcXrf{CA7G#T+jNuQobcsd!dGv+?Z%T-cv3f!_@pdRae6alUdqz^*=DE=mL
zI^ZnoS51!By7A>5cyH_!Cu+G+sK&JRO6KQc0sJJ13bdd$LnG?5)DLPG6D%h&s!(sK
zsMiVb_O%T4KTU7(vWTz1Afi*qsa5Afg#uh~>7f;}$4*C*w<mo3;bU-AOGVpV3$ykh
zRiik#+5SR_qm1cU<yh}dfal4Jy%n>wBj5+dV~``P`%LV9T7~8GU3=Vi&~8XP#+lfv
zwF0#xczB3{K>RB${j0?-E5*$xlF+@wTd&d@>wQj<xNk|E0b89ZJ{Ijxj<Dv#n%K6Z
z7bV#kqumty=;=xl@`W8>gJ$;wR6EZScS{8-+S_z?OE7k`zrWwnZH4ed#m~)1`oYFK
zFbN-|bj!+*Cv+_<^rU4LV<5VTtz|0#=N<htcv}%CujRa#&B*h-j@q=)4q;x4j&05U
zdW*YFr}35<9c3U=6;sz!y1LJ`>C=`#|3IX)vh&BSn=O_Zsl%d`b(`uiUW+kjtQhT_
z`=}7u-^9qWY_01A>t?3ie1LtbI*jhMSOy21F{EHBG5BN)gV~|DmxewTMwZ8t;axyt
zH@+~$tF?9}{R3M+bLg+0a#nNT-|<Xw;^@?Jp*(xU4j+FQjS6o#Q+h4aosWfwo-CBF
zAWy3;jW>KN&9aZc$06&69Y^YI$fmP~*GoSZPserW#JvnAET=;Fw4xnb5wVZXSR4$Z
z(od1|`<jP`L|Dld)I7`-{!G<~24;G_5<T4tR}WK?-<N$myq|GsnMoU9LSkh$3gr?H
zaqjijtUc&&)tl~yTt6}ExGyUCAYXX7uhB>BBn(jyi@4iXG_@A!yWGu^BsD!q(y>1y
zLDR<JJnRl1sXn<Uqh5SAp}oquM27imN!a29c2=+g-^=zr<>e{yTMraI{4nnCd&)Ik
zX>|g#7X@l&Wq{?wth<Sh5GRCP^qEamja&6benB7aKF9wyxpivk7<$s>cG^7`xvL$z
z-!YbMl{%z{Y+&7;j3irYK07rMu8pQx{Oa$s`{YE?|4C&p-ll}?<G5AXBs-s<bjm*8
zS0#Oa(qRX46(Y&Q!(VGjo+<`A{nW-SogFdEfu7vOo7J56uj?S7=#HfcaBSXjXC*r$
z>nIGJk(z4Svd<olJ8j+Rmn@Pw=Cm3;`+2$wn`Q`-KO4cCPajt~A|!-!hraJ)V$yYe
z2E7!|CgP;aD@SE>vU`HnWZ%CnNIU&%FH^zWz#PT!b1LIBZnX%$<sNF>;p5hRFZgug
z^i900b(;2Zo6J#9ccPAF=wTqpR%ZJ>uzxYm`D{1Er-Da%izKu_JBW{ZMK<Ky(qX20
zd><J`(CXN;-720MiD?Yo^u}P-T(Z57+78?2G4y-$VPvFW($U7Jy@JoBy-XH<B4Xg2
zb~7s-+Z%U3GUDO2em*?XF7>?&6Dq(mT*a|k!R6jx!E<Nibj~%6Tw@wGY4)?&DNlHx
zASv~D+KW|>7`9{D(pFSYGLi=WVP)HzYR4OqXLOY?&CFqyh#~qqSI^Iimn+Nlbu6S=
zcgNN&S!?R1>NdokU8Xl_jo5mGG}r!~JdBcm%y~%>FYtQ}d@HFp(Bd*4UgKj$-XLEk
zd;e-GyteX3Pb?%PzB8r1TY*ur6(t!ckTTb?AJWwLc7^Ie2b>)}K|@){qcqrU=CS2;
zvserVrJX_Gx+*g>vmm_fqg{@e6g06qq((jCfv{DA%+C<^cavgs&CXeqLCYtqs&8&)
z?nxIKF=t8@j<A=;4Q+|Y=Ul<V!`r<Pv?1Fjt!+Yt=W<02L8*+=jN!=CV0$;fmLK7i
zl($`|5U^{ljXv4fFye8(pD0ioBe2$hfkZfs`S(j38C!`P^HL`AQcHMqpe0iW*rrNK
zw{b7GA^SZ?U#$5R+FKBqwHy&G@TLrZ(zYVx+0Y{YnuejH@MuXt#$}U$&P%o^v}uG`
zqpkcV+a;hsK#vTJn%^eeQBKloXt)#!<<@{1&>Qss<UQn6g@iAY@S|-hw#5mqD!kdt
z{QTrDK@@854920uo~<u7F%C8c*|rqaxUAti^yT%+Pu?ZfWc7B8&yKfk@$o0dUDN{H
zihayceC%9m$3Oza7NWwo?UcM0PFL*4m7;Bgv*$<~b-ll)HUYKE-IlajsV=qVoMY#H
ze8Z>aSYKeBiO3qjR*o<_cfOV{>D+k?_FyBy`|9S=N@n}lrX4Nf65cbj1Hc7OVs4$^
z&R5rPxtn+%kAsg2TL`bu)vitVr;GaT^o!!UXeu%Nq6>rl>D83q@Q=Da&{tkQ9)AkL
zk0cc0yKyoCB?eA^dxiWjJfg|%-kF8=?d5d$RmjA`AQ<kg;NG@HHy5;1^r+}{m>q)+
zcz@R0IC4{*JUr?s_a1QKI?d%MJc)oE$i#lj<sA2+sK3)Cd>rIj{EexbRI^^=+dpRb
z4#vmFmk{z$Y4O(=T?kTO+5ygUxUX}0P<NMv$)jqv&0in*uSh~dArGYVgUcU3*6qLf
z_PpSQ0)D(3dbuCC4T$J|3)A`4ZUa|)-l~QPcE`sr2Xo$H`*v^oNKV(OJaLwx9{9oI
zvwJ$1@n(Gq_dbW{e&t?7@&W(2#|w;z4;HbH34t$oZp8|L7Uv&;<9S#Z@YH@CaxOsA
zzmKPkKpVe~8#FH-{QmTO^85+?I{sGrWzxXsdm=!?zmMt*yTW@7`Cn?X;qyiBK3IGf
zvdz3Z@*{`5f_u$NT<64ax-QK$nUJ}>oB#@Tx;*>jqRWk8s4pkE`iJm@Vj&lmCrt&t
zj8-E?-pm9ib?=x`Yv#)6&raEN%-Lk}?XQwoYv1@Y2HI?kTqaWXZS>wKY1Z!KMhH@6
zYLPitH56!T6Y$Td2ylzvmMstrF<g7(vo;vByPnlgIvMll?sD=S3Lj6uHAvSDak8e%
z6<*^^NF?W3U9V#YOO?K&hLU?DLb*q)WGX_lR5_N!Yl<!r6wy^ez)JS?$S+r%q0I4W
zn^UtdGCcvaK0o9ri#8BDQvO+t&L>dj?w#-cS>`i|W!1}0pP+Um%mfcj3ctOij!&db
za^<k3QB`1#EOgR6IF4}w`$6TnE*=Ek7%0mvJY>ns^i3Y>5$yJuj%^E9rV9IXCaqIB
zuHy5UPA(IB;S+TM>pI=`vK23Jl(#=cQL<lXzz6Pg%Q-(*^DKEB8dy|SZCUak4W-e>
zH9VNGGhmw#7IJt5p~)RLC95b?d{}TxfRF;FDP*ZyD8O3v`0T;O*+rIy_tnUg`owB%
z5cH6F7vps9*Xv~Nq8DA1zO3KBPsO5aJJXOSRb4c-e4m@sd8o^l`5I{hJvFt9o2MI_
zdGrLK*p&;53%IJ*?}}uHwA>zA<fx}gN{f`4=-uhZH%P<EC)#9buup$CAJe;0N$PRq
z;?3@omk609B<cj%Ji4k{KNUYN_yPBUzcdEh>l^GpRbr7ZK<64AJ3=UicOC2d$F7MU
z@_`IcJ=r=E@7_{VWM(>9>D?_!<mFhCuF&X85anRLrI#-P3#y=y>T<+i2NtyW^|bIj
zFEgXO_c>fuh$+V#B`X)Q5S*2Y1gZ+lgKyECoK8a8FE)!c&EhyvJ1tD5O4F}{Z62==
zy-D|^u?h@t47)@$RlO9}PE)^VPY<;B;o%q-EBgx|_^&lU+|!ECxXr-#OLc#3z9M3v
z9<Mk0G`Zm)`Fl`)aJ|FI#-#E0L&g7{1M+{v82_(LZv3#M{QX2dZoE$}uO7O|3|S7Z
zf+B)cQIEBITTXy=G(-xWs&l-8E2BS#Jo<CbgVCrjI~EW~k!?wlPDDI0&fco&=#nCk
z!}znGtnFNmnxy*U!{m&B(LS-Jp;tfEw#{phFE_+z;2i#@h}r&W&<MJ7YAya{3zLc0
zu_v>$VA@!TK)(`XI;M#Cnv+XjGn&5)Dq!Ih@vL!M!yr<cA6oasr_$QhAfGYfmf7_C
z<b1)Yo6JmwweU8I(rO)p7dAItFRZtP-?e#3wN!U#%3LelmGc(2cor{qD<-C@Ibi6D
zZD!(jhl$=j_1KlQFky8=Yn{(m6_f<n$G9?SX-0eYsnwVg)SyLCROoGNGN=P(AC&1I
zWKfE3TNW-GO7yE>q#X~ANaV|tDf_H`xLf-oLPMQZ|Eek}6)U&NzA6MI{j;yS@*fu?
zs=%740obX}lj4p3WJca}U4aacOt!vE_K3@S0~Sng_4G8evhcIqoFJLvr-iwX1oB6U
z#|=2XCnEcy$toO~zN4oqR!AX?O5_e=#S8f3Foe*dzc@TA&yklY4yw*mdQjT8)S#it
z`A~I7Sd|#Wt`uA)anr0?{&$r5%FVZ-%gijyp-53QpdMc_1sCWkP;%8bCA$wx<4!by
zs*{<)W#YB!q`i#?x&_o&u93Q-+vDuZo-n6tGb?o^y(4!G(sG*AGovE~MG+(os0%D`
z?=w2K%kr1pS4}~`82?lPYP!qT)H_f1X67Qc<)kMG3p4eotQD|Zw4ewAbH^K`Xe!D#
zKMB&HQ7^Y`UE46#Q}&bSJa`eGpS#?v3lE<jU^0>vF`rF8<cOST_a4gSQX19~OVBTs
zDpzAH_mSWPZ@-tPI@FQ4Us`k^*=!;9UcYeb{ct>WJwd;f<;d5sReJ1>rP!p1h~YR%
zFFn0y{#vN#uE<Hb3)2PV=<yVPr!u;2qCH=_`jz7I+pM#h47C;YbAV{8jPn27uVCVo
z#=UINl3*4Q7QfwGAhqx5KcBOlk_TAto!t$2RZsP+JO&2p#YqE)0`jGPdq!8ttFK;I
zJQ>dG;X%Dl^h32b<DGm4%x?=?5aAgH44`Sgw0&q=rd#;47itG>Jf$u4=<-AoM2B5T
zb=7cNO?`j4ls<qDQ>dfWSRptOh{qH4>|Bm=9@7b6{m*?<1pC?HYf}rMm$<IyOpgEf
zGh0_t=fA3YW9b;y=SoOr&v6dkb!bTFnYiEVpn9)*s{v_MhxE_Es*3hoXRc|He${t=
zk9a&V)&C5V2&iHS_J=b%&yXt5e{X=fTO~72i0rozuM7NX|2aKZcf!iS%x8t(cPls8
z8jKU*1CszCBJ`VDZ0Gsio3Hmu`gt5DcTnabN`*Q4oa(W%6*ib&kB9aowqw?Hu3Y3G
zwu!*qCkQ{*f&-}D5~G?*JT$GJ+p%dQby}ms#JXdnabm2!QYY!@LsWn_g*^*9V;^G2
zs9-u~8z`h@qkUZVCs@AD6-m$!aeTH?j*QRy(4R8XAdjrG@UJM}NPphg2$|@93*eKL
zX=<mlX>k4NYgAkKo>><|4XOeOcD9;Zj%=mk{DaD#UNu0Vc5_1)d(+K_iyJH8g09V{
zRmn0t{;1x5+^aopOlq;k)QD{+4D3#05&A%h;VKmerrF%YH??IO-i^Ded}wqgQ0!$f
zOthJDgrqgeb}e^W&p#P&>9dtSrh(JK3hqr#r`YgxXlI|ODvx86eM2~kO}a;Z=;<EJ
z7Frx!e;oQa{C8ZEGk>Uh5af;78MloZe?M$G=wl{l%!`C2tE~M!9{yUgZlgGEI*602
z%(<Fct=_*}wuYKR<1Y0mcU@ywqL#{=cV$uwDJhzqxdloy*G;EZ)uFtGjgatGh6}T1
zcv)&`mQB{AR8o)QH8kM)-r6R3%U#*U{};f;TUDPKU(rliF&NTMtJ2JL=Q*oo=}vMn
z5N@xjkKS-S+O!tE><xXz9!}EPZ&uB$x~1hVLWpfW@qJ<ipz>cfuxg~ECv&!s+m%JC
zEI3%gQb1n{Q7u_*@7PXi>FGwzd5T@9%-hT4-OS+~Ln0EW<~SKY1>pM=Z;K69@%>xo
zB`Q;8QfGnUr~@89WEhs})L^!2!GEKRC;8IjMmq8B0r>QeAQ^D2uQ}-b{cJ|%SoAdK
zlNCaId{c|IoX#<bIxHF_OlVjy27c%r4U4xN+wN2+h9uI9O}lt+Wn^)?w0V1c26z^L
z0R!IHP}}x&@4{#&Dj-gVkjY|VyAxtc$kZNydRiN?`soAC)}pPdWDGvzUa8)a3tMO_
zK^Zmf*B_WT;tEr6(~|SK`SGJAZZR){Hzv0}!Udkcs8(im>v9d+NUEQQ;H{f=$L{Z^
znTIT&LnT^+lhaf0^`_jE<P^VB>c^phKXMm0UmV^!Ps)BB|2y)6|B4y@*HVrDu_pbV
zRsII?cpuyZY+FqVA-{(Hq2)waSnQu@a*uGNMp#55uVAR{h9M}Gx0H5$Ij3RPMQyB+
z{POi4Kk1Vt8_lyV|4WK(z8BE4-8fciVQkXDG{TA4maSALbT534lw5NrX{B(t`0|TM
z<$o{+a8<aLeLS>(IVm)knjk77*YuuhGHs}N&veW{1*!8>rou<AN(ZHK0^C!#^VMkj
zZ6QxUwIj>~{T_pLbeaWvYIWrSE_0&X%JwyYJ5#d{_UF{I&MlE|p0BksiJjd_yaj|c
z+xiwFH=+wq>ZW0~`ApBrz(*uS|H(|$qdyqNPOR)r-Th!|lLPjit^a^4How76qN0R^
zw?rYId3=m6@T8Kd(2XIDW%oyhdkp0D6uMN^$Ak5(n}sbKL%7A^yu1mCPQqi<V~`KG
znn=Y^RKE-?Cq4JJ8Vgf6Nz0&XptnGNbv+5kcW*?>ONVqHk$fMq${?O%;P2^}&N-;b
zQ%0lWvp65^Z+B9S-BJa1-{JZ<fZ|Gw3c!YND_gRZK5{iY2+|5K?Ii{u34WR(zHqK?
z(P?(x{wTAf*zBLW%<14;j7tcW{_<{BQnUC=`r}s>u71`DU}7c}PPqvn7B%Puez|bM
z2M>OoL1Mv;#fp=(uzWQ&Cxa*sjm#9GVz73|qqTkPx6!SJ-{cS;-e5l>jXK_@z-Ks-
z$5)EB5L%dX)Wd!ryle8nyr!{ISaw^XN?>s{T#^~Dr+&v?`9A*N4=-SZW_#J1ngUik
zZnbU&GvB<bbBEE9Eu*J&)RD%AuUKt~zmQqji6pI~t?1*&Cxv>$diU1e@Y}{;U2}&*
z`}#^kzRh|0t$)!u^i<YTBj!bx&gL()EQ9n-dwdKxzw?I&R0{OaNfNsCNRz?sf9iYE
zgs#-nv>FpXpY!|vMe@iAiIf6f%JVSj!a`^)tvJ-V(kEc#E7UUJAY$GZs|q;{yP7F+
zU@7f|Cfda>rXQj~$qw!;xMgjZrP=NDe>P-t#4%g6Z}CX)ej(cZS(<QIkr1~^bec}K
zHd-2Jz%Etk-kW$59I8zw^&^LnL85dYz8_H#iF-aY9(Paz$6}draIAl&mW-Dgws|jw
zqyN}-Kg38ucz!=vLRcVApLGGY|2}uzO{!!RU(|s8jzI_s=Y3DGgkMlq<+bM&f3i5~
z(Ov@7ggiGPJF_X}XPqRu_)AIK{uX+mbV|-~5YP9*uDs!%asJ*H)Qj??JZ$XQp}{AX
z`6Bty)9B$INXSb)t%C{W(SWv_WxJb3FVvbdV(iL+^kI485&@%LIN#02j~^!UZ;LL8
z!1oZ-ZsV68r_f2tOd19LKe$vLPM=1}y6AIS=lp2uy-05V-%%|8a#EAnGF7Won-aD2
zT&h=dBsrZ<H%}!0*ucZATiDg8SoxapohXhvLO007xZB7{xv#Io1Uk?HcIt-gq-!-h
zksK|d-<O0?23t+LMUY6Cu{p0ed9+sj!T32uy<6W~Dx|un7qcn_={DO7`B{VgE4X|8
ze7oq;vmRf@sTOpRL!$My-+xw!wA6opR^d{MJZ+uDSah(@_@cz5mnS@>^cyg1BBATA
zUtGK({?R*7HCs9pB;mAiq(e^+HI)06+I5$@xt7C907S9#o%>yAy3tZ<18k%e9m|OU
zussJ^oWrvnMG7wzq>@4A!OBFJ&6){;=S*q?iynv~RJ_<5=RmKVVgKDY8*~tqvhpo<
zuKcvYzm=88xg~yh4FUtGqhZLhQ%}VbsUzQz4(hCjJv1cpuPSHb+;dtN5ATM8nAKoe
z7pj4KNzm1Zs^6hy8uhUE-GnK~UVPi!4A>*j?}W~1ia=i+MPl2d;?gnIB?WBLU^dM^
zh?yLqHWVmx@|6B~t<FH5&G+fitxmTSaO*^U$jCU={;NAA1Qy0K0lgbdXpfy|`#pRG
zHeD$zN82nW&}YRL#_)Hwq2UulL>bY`A{Vg1lj?#_ZcPl3)ij&$WK*#(ebKW(eTw<?
zZe8iI-E`XBtHOaW?1`XjW>1j;cXA6+l-Ud^^)!2t#<lCdp__(X^Oi9#6JtHS1k#Ng
z?QeXONSZSj6q{Y!fVANyf^*2VcT4o8**Zsq6#lQf|C?N+pDoBvzQJE>h1``!=BQcj
zP&s|Zb$&a;36oP$J2oOA?YK5|?=8wE>AL-Hp_zDZXB{d4u2oKv$mzRw&#g5it949<
z*(4!r_I3*Br#X3^TX5jhc5@weLvCOcHT16}oJGr=@>?m}sS&$jr^F^-UKoTY0dr<~
zk<WCsjkpOjY-C0|*lpokTRVPI6p4U9h0931w>sx>!RiePtASu!3NOhFsX5r3X-UMB
zRXEPCh>*0jy5SbEzP2^C;2`!9W3G?LG&F;b-zLVU(S-mT+V&V)qV|52Pn{f0cL6(H
zUZ{0K^-QcR#|J-YnI&<vO4t-OqYl>Po7Vi=XM-s7F&x%ht1j7`$9cEY%>FXd%4EO}
z^SswrWTbYU36M@JbA+2?heBtoB}t05IqLS<v5$8o$&c<LrAiZrbehHsN!>^;p6qU}
zWtJg|Rkl>)=h5L*W^yk9fLL!Me!}VB`TTrME+XQaBVP?I&ZbVWlNnhdmR01u*B&E8
z!zRAjOB2VV%&OY$YGj!EJ_&oYeMwcJA?9FtXD&;>uUax{{@tXXTP?lJHwO(x6iEtG
zYQQHP?j5>K?crd1vap$(pUslR+kSEK$;~#*rvDG=&)HEkKP4;YCOh@;)*Bd==coSD
zYkmKsYZ1u2KKuBw94wl$u8Cu9OgLP$!ujBM0$1NTw%Sl&RB1js`wd!m7+-;Iie-S%
zTeNy;jYI?BwW(yx4h-ua-qxl`I|N$|uA{Z^-RJ_fC{wH;aC+**>Hw2yvn*!=UKjXy
z{T$5HGQdO`8!D&FymnYKaOU}tw`}j37Jv7q;o101d<AdEWZM}JDYZMg!?IK<+qTiv
zO{zc{UTku9NP8-W3~g1QTV4G>;aiIFnBNp!aQ({vg@JQSfleV3Pe!uG&qT~ek+LW2
z+-<Tqo7(Av9GU`i-~?t_zp2B`*W)jk6l%1&*v|kHk0F>0yg+c^(I`ZCC3JAV_x6jE
z7k{AO*VxIBdsjVf&`o3h0A@T|+KV&r{y$~k|HmNlzchk>BlO|+(_Sn}i9&h2G*3Wd
zYw-wNJ2%NB$;GYDy>Bo_PNa5^2z*MD|NJ%=dRix+^SY7sAHd0_Y$;L>fV4CFQ)lAa
z5%CcQCXVx>0877wfl*Qz3QJn(>7+27r|ShkKAuFbqAQn5r~ANsa7x|;XPExqp)e*B
zCL&m_r?U{^KGO7I^Pdc`2wtS4Cm&x|&@7)be5eVa+ulH_+vS#txdk^766~nZ+5)*`
zTI2{3uC1c(Qs;d$`?k<Ln+>vEh+)pE|Ka2Qc&h8p4_s9ij15E7yrit`=@~$3xu0|d
zuB{z(WE!$piEM&age#vwibh3vssjIk@>hS!gVI^=R#aINcvnAts#60<1l&`lo^iAy
z)#2NHe%l(jlNC4nD(jTGolt{;!TpXBCGN>t@S-y@P5e7P15$K6?laB4mw3OkF~hcO
zMcgc+NiO@J3lJM1Rth?AW*&wp-<~h&;$SVTUl`4hh87ek6_$J&^;aDho-txc9W8N%
zb`-u8?qA+UH12W9ZspSiQx3ShIgxQr9cRCJ=V{BNNRypF-7vb+Bp3Qm>jJjpy&M#X
zwDd|RU3dsbLXz`}Fqm_0&i>2fmJ&$aeUaexFI;QDsPQ+?h0wIx<@Fu10PC!RR#hJu
zw*QM?Gp<94XTCKU32NqX<PKnYr`P4X8=xQ{BQzYuU`_Th-YGx>K&cghF6|8cD+a{N
z298oibpWIIa3^I#NKCBEK+W`l&c9zrD);I>gOhyy>f^+M+-VoxaIfH{lc*_O|9Ouc
zo#ZsTXz`>=s>B8yhKU13Nn63Bk-5~1@f?tX;r1?4;Kk?<wbGnC3D0Gsf(A(z4<Gy&
zO72o*&13L|8s>95F%fA2dK#SVRWjY@Bgj_<GykHB1M(ibuqx=(nqdj$9CAWAQ78?`
z)5obnpyvFLa|rKTD=0uG->brHcI6zD74R9@2G6#Q8XE+h*ySiS$-RGVA<DP6`gea5
zq_VxHA-x`N(zZL6Y;P<p+y6W+6M;H9&S)jwRtr&u7Er>;1;Ak$Pgq{HZj}9B!jp1b
z$+Qb8)^m%x0HTBQBEde9k@I@5N6J1Yxi(li9|drZB)3lZHqN-?c5AdT%ok)zPvXY>
z0iSL>K)pGW&E*bhOu3~z*HIWc+4JI3&T@9{R_0Qkw+wQ~TyG2rm@3BIy3nYFm}cle
z#(kya>)-g28Nrc4yyk2i*_@7|k+JJH?lzn&FN&Z~+!Ilt!WzlSyjm@YN>VeVMY6Bb
zo$ip|)hG)KrnNSc1|!A;G|eg&O#RW|GJhm`<H8f)OV(LLZ^k~>Je2V6He{S<f#rUB
zmHW|ERAVYXf`d}zTh)wkN9JKQKq{UCSjm{`_AJT5m9|Ki%&CTYe=K?f^)J=phq2f3
z6K)Cxh@Eoc6-u859Yc#>8Mt9B4zq#W2wF(nMcKv+d@7R)RfP7l$<|A2)UX6YDkuOp
zaiU{@X}YVL)<6GAOn_gSg7wbhB5t4>hTA2EGTqTxs5)n@K?0n$uuSbNNCT5A2k`rM
zrIh;AjASjJ(~LhzS4>HIh#7$IF`6e}npScj_`D;%B(k+kzM^fY=d<$n<LUQY(yi6h
zo{<6jB!(ByxIcbLk@K6#c%~xO#3ghg*Rj<VOS$eVOAkmWnhoPMCSFoTZZm;o<vrtj
zQ<h5`LXn#IJvg_M_IE|nxjxpGb30Ys!q@BR<cBxrVkEB=c_Anf@$Z`I1Gva%9XT&*
z0qmE)rfXS)%SwBtp7LoI*^DNOxVpyfA8e3bbj0Uo`BO=DYk1DE+EHdf1X1r{Ia0*v
zI8}Q!bT6`gHx<dbpz%WEs2JBbQn9{PGtiSfvvF#mRU2EpSeUontWJly%EP6i4e1&7
zCrHkZu@joPJMo@56DHc&bLwg0JF;o19ULjXy12}yJGnY*WO#pKsr?<Nt+bJl5c;U4
z(Um#h*XhyXamu)nJ)vYjGU(}!{Zk&y;=&J<F*89?`B1@bV0Q1?)ZSLuv+NN=Gt9d@
z3dq5@{6h?#SIFGELLTeToX@~j#Nv4O4&iAH12+25I~{fGI<uwoCoeA~g_PU`H7d%w
z2KG6}5`npf%qePpQ<B5624-8_cAL|iVxOlf!@<&<-5RlIl>eBFIDNTF25pMnSv@iJ
z*hn!KdzDaHnG=8_Eza*nCH@+qIMMeO861p`w3FqQR<bANe$0irQgTBI3lSaItt#On
zANe$f9t6$1g8R&gfJ;{cmNF%=w>g5(Q>Z}9ru^pev--`l^l3z2UbhCf%)8P*Oi4?J
z$!P-seP;Jz_wn)Gl?#;9Qj$V~ScxW97HyzV_B(r<e4W4%o;+OQ+S~Ie((kgqpkCKI
zTL?SdUae-s2<@dLJD8f?Q<oWG*Jcxior77WulCc_!gquyS;?GVnVOwFRYb|l5c6X;
zV2qJAt@GvCH`?{3H_S2`(L#QWX%hYU`Fo(8@cxC`5Sb3?55&I<4W3(~qoENIgstUF
z*OveAyH>KVZOnU=KqH*-h5@tg0)$wMu13zVONmvQhwWVw4#Ie}H}oz;lH?P%jFX9>
z@hMB34>?q?kNwOJG~V$8rOC54B1wC_*3CiZYIwS#d)i(}e0^qEzvd3fvcXk-V#+AY
zOpT}nzwJ1FlGh6+eTLH{UUW=*wOaN5%4j})@6eh7sN<)P)(V9y5!loo1g1W!@q?d6
zS}a$OwAuD-NxHLR_YO9QE?`dMIZ@2RJ%RfUdGsa|x0<u;)ojN%ih+|~u*Q;E+qCs&
zZ?pQ?s(*wp*S=W3bM55srreb?%^S5@^e^ML5A+Y4FunQ}*4#6xHLQLiXA64=Ng%eE
z-hEN0m`nXH5rDWChz(#!=1AkI+{KCemb1RsXU@>++Q+>v_^ez|<@?3AxLVSpveG9@
zIXE(aS8}`UpX?#)wN}LD@xcb=MTdh)3=ov$Zl-HS=aNt&FdxJe4pjEkhL1}U2hITt
z?P?taD%b6ZcW!)6N#r$8x-)&mQ}P3>XDe-n5uVrbHr8#{d2498v4da*R-c2~kN8=s
zTQla`b<|0JpONV}m!z&)oA;DMFur5H*sfZA@l02i+&P)zoWu!l=Zyrkj<${-+yi@P
zU#rK%7V0aOrd(WIJ|OIy(H)B;1cIex-MSuDM&Mr|alG~B^I*(5)c+5b-MX8!y{>Jv
zFuasC<a9)$U2oXiYQqz~<+}Gb@A12k2f7BiK@V%2<M+7iYH0nJifvkp4GzNNFkl|x
z%9FR8_9Z3Rz~*ndI*uprWzPC?;9t*L2C$&=jXg8z_VtJDWHLf!&XupKXKF8~kYWdd
zui*0RD?uxl3)_e#xdUfz4-t2%9bNhWR7@QO9H|ZgNv;R>CDQd*6K4S?xmVgCznPQ|
zGo2e&xmRY}4=r+^IZ!(PsZ#Jrxj?9R|E)S_PjVy~BU!W85<9c#mexB%{wI0;ki~D?
z3J@*If`INd`|-*^9jc`vAc+~!yYJ%M1HNBJ5;V^JO99((R%yVfCA~!82FlCy8TC*L
zoDRX#K#j{a5c}qj49DL7ST<dt^o3(`8q`<glIdBfmRrVSt6BrFIZ&js?|XoRVeIPK
zpmUm(prn<$(7Prl{sh(sV&^2$W-R9kSNBBf^?g4h@A_{#GZXXUW6?7!FT)})vV03b
zpi`QN;t)!?WSRgMcteosT0UQU9w&F4f9rCKRppsn;(*o_m8(?CsP+mVq#Ru6%bHts
zNNARN>V(sb2X~VTU)P5Nsk`!c?ZX)-S#_;(9oPE?UXMq(T1M;n-5#`*A{N|^$VH^B
z(tAqlgl`MEY8F5_PQA2N^2n5a^FwpSic?Q`#EdV9pTTg))@>Fu*hwA;{3|@FT2;7m
z1Tf_Bg00_J?yeuUUO89#k@dm_bieYN@$m3p0W)M~eAxq@V*(NFp1;eRPo-%jiW|(Y
zSUpX}9Tly=xk;6o#enuGi4rceF&_ICkoh9n>1v@?-9+P#xkuFn>*I6N-1zOVweE8}
zafE|XE#xM|WccvT{8|mVh<k!zT#pA}z$s7kjYlSn6x8FX>A3)@PwPMv*hcn~(h9tW
zxOuh<{YVi@du;{$EM?KuB;16(mi;a*$e7Eqy4|9(1*o+ENRGpkmk5D07zOy5jFo{{
zi}cUY$1{Six58*1+I2U7mAf!RpkOG=h+CWkC|Bz7bZp4^6jZXy&N=-l{XA5ql<^nV
z`%AjFOI4aaD7=kHHDx4b5QRKu%fz8<fe_i~#@ry3Y}gIHPN*+PtjsbV_VJAY$i8t?
zaT7GraO9g*OgZWhDs!J%sb)LK3dsLn#Zzx!99HJNKYsjo2K>NOEx&=A^)?;bEscH^
zD&=G#^i3k~%mV;VYXbjQFlumN7IB48lcZr1KmI3q)LNU_bkoW8B$^_L<X{7<V@@*0
zcWtgQ<l|`0ec^G#G^@S$B-gK9<e?QnY*Q#?orTD8z1Q!&n<UAf=g~k;7j>(zH1DQn
zUHR;9xzX3Z(CjRiqtgMlHO=0!5e$iUjN>rD+%YEPpn$2_2K$>Rkc87U+}?*e7atWX
zi8SyM0UVEBlg{j<K)bD(-;tPg`L?E6evfHgfZ({fhmHqA@E7YQNA@wCV67+S7KxPu
z;nRPM4&FT${|YTv^L~exXZKA3Ei+V&0UYd)V3)0D34D4Eb6ViuRsTUT5u#0uOv0ZU
zGVF+MGEiL;ZIGJi<sk1uHO|G!4}MzqAIlF3T1cT(p{}v*Yi#gHuU>u`wwOh<Ab4Eb
z1nJnBhFEYBd~lQW`kwipRElye?HEwDG(hS$JLv3QvD#UAX5U_Q3@tFKzoX_}VLo`!
z(FDkm%xfTStG0qcm9-c7L)I`#BmlKQVfZl94Cnfkf)}gJl=;rE=oBB^>Pf)Ydg$_<
z4l~)~Eq;r`jWaV|mpK+`zMQd65>xY}U3A(fnu+?LQ_SJ?H?&fv5swp(6EMJx>f3f}
z2xD1C+sb=GJ+*jwcrl&Py#b&~r-P>;QTnEijqfWoEr<QfQsXP+IPcw4qP&m_Ud%BA
zWm<ilPZr7EEKsNwY>S6)9j7%LGxKwr)484IugS*qY6qC~e=BzA=dKCS$PTsBvHB5e
zv9jNi+=vETvc>Ah$cR=Vv{}_3G3&7vkdcSCNDlBdr!QZ+FtQUiHulg)CJ*q4`3H97
zulJ6J_w6EK{;$3t@1M%d=V3kP{=F}Y6p+w3Tfqu{|I-GbDb9Wrr$FE=*1GE~GU@q8
zjoIKhez%nJ`m~1G_1CvtH3P<+H4hO?3P6R8tMfRz5|9Q)x#|Csw!y@3f{1N>&qle#
zvtZ~QUAl5);G9`Wu9;PP*Hp^F{@s6^W0>$7CPuoB^8|3;QWMFxt&O%ZGleS|K;pCo
zEK+vpA=O;LiJY28cm-vydANgxjX1B@2XD-w(VcF=z6|yqAqz|YloL>n7o5w0H|<ad
zoUX7wz}Yv&_xl0KkJ`sBK_Cxe_?-u#m7yslP${Xr#k)8c3*5N#tlr>3K(Y9`)C%D6
zwv|}P7~btTTi5KCwUlqbxDApJ5;a+*)6*tiH4#oEx$*cL<)Rb$K$XXg5rdm4GZl2Z
z(M%b0ENx;xou&c;9iuV^#`5iB#gJdBWm<zN3V|%vuoS&a@v3M8?E{6@ju@`MM*}nF
z7r^=rlK1<KlBnJLTcK04@ez`JwKLgqGvOCOEm#ncYiGw1HTTWjoa?htU!rlA9V&cD
z`f#1(m`B(yGn3dh%OzkN_FmdQ$x=(in|Sg8N+FnMv#UCu<_t(lFs;I`w0O!be{c1)
z%SlFm@9)<!T1aqO+@H81bJw9XSqJ?n5<A&|<fZPe4%i*D&Um)4e}BrYF5a``1hbbE
zH+R}re|FFW`RBbU@+FOwEjd0bEeYDx^BD?~uaGS(L<U(Ncv%Rf;C{IO^eT(LG&1g>
zci4_Z?Yaa`-&r3-a-Sy#jdzGmv2S-Uv0T1X`}lMf>3-efL7v6p&O5dCHSC~hD`2jX
zQ+e5^vR(Cxa^56lDG%_JpjAIB>z^$=TM1xF{a1-f0=KBM!=m89a<KlMw)QGR_j~O@
z%kMe4uRgijvJgfVxVk?DXq5N5KQ#<veR&R#HOy`UXfm{-tOez_39IyMQT?K0f<z&p
zy`xF{(iPfb!yShy%?^c27o{x_LodJMouTg6?HBQMx0hO9;(mXe4GN+%{Pvcb)2K*c
zY5aD$U`?<UmN<aHe7LgT%=A~9wB!e*N!K5yoHGh5m{HS*&F=#p!%C^bks4n_kZb1N
zoIj?J1jDjU&NdMCa)J}58GF!q@yjzc)(ED#MqG#mYK=fxX(kIRmThe7#|AH$`q446
zrmBu4e8I&E^AXGERcxKdzMc+po&ldv(xQI9Fqzd3l*kkaO&-@Q0fzLN`;S9t%=;&5
zty=iv05cyC#6$quRM7_9UA2+BEVFCFP`g;%her;eFPkfYf|baGbjhn~5@wofb=Eyz
zHEM>%OR_U@Vml`P8S*52s7nmWzI*|ycze#ZA|Mm@#lWzhZebSF-`XfHl<}v0gra%(
z&$Ws3Y8u=|Ge$$-PFjbZQbho_XmyY`Fi8U=7sZY6{(F{m)z8#<L;@0MB58H@na6w5
zaiHe=&vL%%g)o^*Nl~ES@9b7t*SL=j>%O^-Om%(C;0RE=-B7yI9{|7$W*U%YrHbj)
z;%VtkW}()tptys&I6*trm2|WB$_c{#V1E`i3XngVT|7ar%Xko5&$3WnS%2E?Sj}QV
zYPrf-Wf5A{d;SP7GV;i;@`?z+vn;fFe)D`{4#)P;IF^f%fB>Pmf!2R2aAG0ezBF%b
zTP-r=a5kEzuk@A{+tSgmX@7c?4y2<`X0;|ToS7>+3%TRHu~NK@{e)_<N84$YvN3^C
z9srez&<@c{{jra$l?0M};0@K8gY)SzLl65=X;@-|UlG?Cw*TdEiPF)I#d57<##2K$
zwwHv7bV^`3urJrr@X0cJa34*IU5ImjM@8@)u%>Jo>KQx&n`(GqUfE#gbF|}0Gq>|K
zFhZ81aSLqO>UqS8=h033e^X;LLpJDO61-;Hz84E#EnyOdrkNc#B=Z{jF1<LK(V~L?
zst!8qXb&XaM7Ql+K1+K09Pd_g(_Nz5j9~ZhXxH!RFCe6AXss)R;!9ezm+M4(c6|zA
zjZkO50Q<wv@zG5!*CIbri=?&EQgkXDq%A?u_lz}j?NU%rT_ZmHmDpWAqlC#@{FDcm
zE?tfJ%VIB_=QV7Afw3Z6o5J=K>7TW89D9uegIN$SE)0Ac5{yV4Vhpq#*ukWGeS5hg
z?q!!yQ$st|DjjI5W!^T(2yAE+)ARnOG(((Qpm^nmbbPXOptsF;#l7~)XIkdR)LP~_
z<M|e)GTX3gT+J(k4Le-}@S^!8*4Uzr@2rkfyG|mzJZ$P--%h04ts-wbPVHz-L$Q6Y
zZrVGY45h(Wh_Y0A0~v~3G(Z7lD@L-R;vEi-J-mB$*8-&3CF9#?_6tytkp4<B*@NC$
z+NL#Y2f|YU)y}IkN1q!E!1c@ZDWMs2%7igiyXFM@;@E{i%`U@i6-;GFsx)^t(*YBA
z;6M-rd76g1mKZ!7FFmuj{H5?T$Q(c|aa3k{ggSo66Yth&Et!z@)vpQ9G2^QMlomgd
z1j@!{OVmyd?04Uzg9f+fZ-BhT(E_0djHy8b4nuAqU>GGRPR}hF!#4M~sy+`@Np`Qg
z$vJ{}{>g{!6ZfO@@^KGX)0QOpB6{ezj(zP<k+jbH-{XQ!<9BfhIm>Sjm-zN?x-k6e
zuX@AhpMG-#a!-E4l^nj`Y3Bb=PA|(#?D-rSM+=qsb=Nd<sxO|Re%w?55uJbc!1w6=
z1*HF{dV7AkV(m=ea?fEoUO!(uTb#>!9$}p9I#Ryqgj^_o6Y;O-^`RJ*Y=7Q`f1a1I
zYNHfuPZ-&3cB){J?PS%Huz`*B^}g85*4nlH{u65peLK`oy4%B3vR+c3$=r}7`_t;&
z1m{gOA=IvucWmv}7#JFU&sT^f%9IQ-ccl;ddivLkZ*&LG_S{ilfD?ygF-tLGVq8hs
z_IQL|bn`7I%m|;TziWT;wUA$wnujx|xK0~(KJ_5F;}i+ZM1-hob8+@&Op&2x&eqNF
z30YAIwV(cGqDo2t_YJ(8V&uKSW*NTOnRdwKrsDV893Ja16Gfp=sDrOzWIJy9JBlkB
zEhl?@sV6!Tl9KwCmf!gyx4m5U+$|m-Q-gVbX`c4%;ySb%uCAKNA~Hz_asB=2W(^^T
zS_q;?6740iLKx+n+7V<oZE2jq9qbxjk8?CO&ZOfUFJ@PrqfA~|?6Ego4-Hlv7sd6b
zzk~iC?Okb9ljpY9Qp@Q<pr<Mn5ojxe$`B+XGNyx8ks&HV1PoLeA~FgxCLvI(w4f-n
z3`tZF1d>n)VF)D9A|NCrG81NmBtjrz5Ml@<_Y3yid(T<xuDjO#an`+S-G3x+@_jq|
zd*8jE=h^SO(RcKYp=}>^QtaJK@_uyy&4?O&d^~=k63SZvVUC-ciulVjPpQ8)n62em
zme2!RFSwvJK!teVKt>@xKy|&`J{%sppq-1jCI4e|fQ`*q_^M*(R9V=`yuqiZBIkZV
zU6c87s{LRNHn(437Q3oUSTNj`Y$atio|H`hz~SHl)4JbAH<?96c4CC_YH=yKQ(MCW
z!H<Ona&y}pZ@S4-qSgk3-3%0uZal)Q^81xxA&F5>U$G6kx=I-s8Yro$u}IS}do@ho
z^iS6fWvF}D72;{tM<*sGVARR$1w#mKL2)BOvTEW@w^LoG(Nd$u{s}QWicDIfj$j1a
zf`6_;DKw&_!tQ|RBRHGrV@6OMb6=Wf>Fm4tMM#`E<6sLeJw2U(+Gr$9EiVkJ?+dSV
zh!U*Mn0k`m+!)P;WOkK1qT6cpjmf+PkDYz6R#?Wu1r&dx6eU+Su93I?j^h5>9-rXp
z_e1)j40ranIYgF{*WcS4|6E|#*;`A2@mWoqxXh6?lb14WLU6EKVJX44`fFntftg;d
zg2WY$)Y>;$9F7vO?cmkI$=w2lJCdBJ1hsY&Nf@%l(bjT6#nFLTeP0h&DBq05;3)#1
zS6x|UX4N$Yht(4w?~8RlclIgPf%VHB7k=}MwPQhz>@HfeeV0)aaw#~o!1;@@7~T+<
zD)Fp~xV#w_LSm4b>z-R$j~7^iOqe2&Z*BnCD@(sknY6Qm#jJepo9fC+<9$Z1uLhcg
z-Lh@v8d=V;#jUM|kjYICLl^2cp%EB72ZIeKW!%wPCu7cub@p8%q^!i<(;H7r{$?ej
zj^LR=(Lqn#C30$bgU!;g=z`3-<(WgQ7c!0u#4|$^i7$-XpyK?DryRY~5_fdGX$=oW
za94pWF2AoXmWZdMVaJS(S9_o0l1K!C2{#~M-p=^c;&EU}yW)kfAo5}eJ@SB3Ug*2W
z)doEfAR&C_4y+^d+J8s`O2hTPW|hvpude$8=$CO}YYgEL$h#k;buwh+NfbuHh^_JC
z3oq3xoW6_X2CUh_$?+nW@G#v}FU4C)g7E;_2U6N#nKSV8io;@!&tFv)L*x4A&;Nzd
zt&9l+at9FG)*}BYgc9abzIKR{6PS->lI%Qn+?kl@=m0*co*c9`1oq1kbyeGTloey<
zfMC=BE*9$<Q}!z^G<^(+KBxrAu-nCp8Q-UP0Z}aMs*7%eoDM{>C2QI1@VVuZsE^un
zSNBfI`!DBuF(19?BAih-s)FE&n$(vC(wey6YcCrFP0>t4`#S=rDqwxt<@v*>>_b6t
ze;vgw#y<uEr3h<%7_)B0_Mg=*G_$S(TujzW__9R|#p{|UAYF?N7#eoHC@Ok)K@D<Z
z^`qoBl(#<3reqC!+#)@~{EAh$<3T<pVB#K6-wj-~LT{!o<ecD=n87GJ>Es6r5wUj6
z`hp1v#8%cz%r528G_g_ArF~%jQ{_Gm$MfybTYuE3-qr(^`@Z25X<Y;P{h9EoE^=j^
zetton`w}OXn5GDeNtGpY-`p~%SXu_57P^?ocQYZAHA`-|(95o_1qJ=qwigJ6_4?q^
z#3Blfm=wL1>+d=!Y;F(|YYn>wI%{tK;4R`Se!Xp$RHI(~aUSq@9AbkukgKIq`n&=i
z>vMHDG3HZR{V9YPN)BIb%LiLK4i=ff2XZurDF)@|qg^uBsGqYZW91!#oYz}NTMj8a
z81Vq!TW|MJ3vB3%tocf%<y~P=y!_6gF#AXY=u{Pt-r4_t1Wv=32Kvm-de**OVOGp*
zl>>IB1y1DR_+OcIy`d{P-VC(IJx>!lv0uUSha2=CqzPSI%%1S*CSg}I<J~|Wj_gnt
zndOaQ(JjRRw`Tpyo9+iI5?zv@3kYYxzS6JP^pN_tu{7*MH65Xz)JXLq|JQb3R`MMY
zU)k8B?549K21EPPC%W9gZh59b1)Dc`a|q6egRR)vMOIBQBnMs&5T}jxc}0cGo~*E%
z#k3YCnKp6Xk}UgjN>bbj7OdB=J|sG>a-6lAOffP98lHx(o*G~V0~Y#Cb&tB!ChmG;
zaz;I!ECQyS;$z@$nV_o;tp!MO+%(<Nv{4Gp^Pe1m^$pnR`|hNVhGU9AFQhiD_LSuX
zb`9g4U3x;x2?XXJdwiKNe8{Wbx{a+o1fHP{nJN+rg~ssk%#vsU>(Kkf`^*YQ;OwvC
zNe6ti?HG6)SMJzD%U|IraT+O>`8MGG8sjSUIH&W1AuPw&(i$%i9SdQThNo=!>D&ru
z-{16|G@V)WJhNF3ZaElCJXT(?@!TZzYUXp5(z0Xtp8IRwT8cn4eJ|2eC$-EK%Q7;8
z2CmGiL{f_nE34@;`>NzIHa0e^iwk;zZIxB(o{t~v2TkN+mFWdqWTDe~QN`k>fOmot
z<}BkDmyh{igO+T`HI`iiUmFEO$9h#BSRvXvs`D-R)dQi41}@KsMkaH?WuZMo(Utv^
zR~H-=^J;oC(lhx@lS@y0urz&3XoWF?n#dwY#~udE{qnc?KyH*o1d{9P=wM+~R@4dL
zdK+7XXLX^`z?6SoR1$qQ#vN^+rdxhq+96v1IH||B#um!W@U)C4%lDW?Su~<CKDHu*
zV@ednuv6t)$Z)drcAit;sc>JJ=+fx^!dU-U>0GTyc1uniQdkoKZXhUffh`2-=XMXK
z#_ngd;8rLU$qdFjivrp@Wdy}iUv`Vv@^c@qu9U3IAF1u{)ava+4Qb<~Cqk!kP`6?#
zV&pCf7ELq`z3EtsZP_u1w4aA_B#za@48Ak*snvHXTc-~<(rw0IMAxT9RgxTnmnC>g
zF#t3#(oj9%T_3PSO(7Fjm~{KExNGejA6CHSuH@@57|hW13w)D<xN#8@VP4g|*?(UT
zV&*+Hn&DUvwF?%${B*W|aM1F{x$XNh38Yk-{`p7kcWgml94VCy61-xMaA-uaB!$SK
z3MB-j6=!hVs+{jJJLi-?DNTILQ>|QkL!~1Og+2G&*=0+FN1}6eB%}jc-92RVHygGG
z`e?tj4jm9ZL;;{j!t`cxi-=QCy%}SuNp)3tui<$1M3j8|4|UtExj7?AEM^sZ`SRtt
z*H3XTiHd~w_+rxBu3Z|>9Z!FInHw;_xM&kDYq(`O|Mu;xmiI9EX1Dv^t92QNf5<%{
ze_yTQ@FS2Nrm0p5%#qLeF#erf@x2!Z8|W@YCk#3tQV!sJBU9dhjd6_o^LS{yWE%8K
zB7jjA$Jb-Zy%omn8ZOUNYIiBD5A5d=zrVP1HX{P7-Q4q;V(<yfQ73f*j{SE!aOCKP
z#RZd%ut3G=G;i*oF?v^ceByGl6dcu2yI1>U$m>Qd7R#xQiakkdY{U?Py9tL{{Jvw^
zJ=lQ+xQil6o|mGhz^;g#oI^(vXXgWeCI9MdikiAj>{i35-TT&UrH|TeS63FNx-)DI
z=a~IpKma(?c1bd6Ty8>nZ2Yv&K{YCCcqpW68g{$*1!IfrwmO-*9z-R~?p*d7kh#SZ
zwqVT4u-sbPihgVU*MNY0u=FWPibn^xPM4q}J%Hs}9J!j#v9>_Y?fIy^@-^*>8@^q&
zi<F#vJrsRVgLQ5&30SheuL?}9&d*)RlQ4KZ3cdBWu*8EMVR{$j)}4y*@Z<^LN1)L?
zYWeq+`1*3mvna!fL?n-ycm#04Q4nbLamT0DC#Cgf=839QO#u(Vd3J9cGnN}dzt&#|
zKtE1~H~}(<z80^+hko*LDnd^|z>=N;30c|A+dJ#|189KEFKUgKOT@2+DD0&cu^N-F
z!+9WlejOnDLJn6Fp>2OGEWTZ$R!aX^wX>5jQ@5+CUTu~Z^`l2};o*39GyvSou65UK
zNid68435h5m7Uv!PSk-x8?jbHrSxlIHGaNAR7v<lv}8V2Y!T2}AoDUi)neN8iO;Zs
zxanndsf}N778RL?;Iw7AP1Kn)a_bGHzU*#%k@aNMvrAR;;|CSaXmGy@q(RsNt*kNt
zqwC67HT(Nk6V>!|D_)lWGqETsWBm5ifx;&WKHaM+1`%Ag$F<6ZkgNE6XDi5pyE&Sl
z?n5ed?$#b2vf4XRX}GS+AQPTCSSmq4dKUzq6s&EF7=<1_K9Z<OW2vCfW(my$!8YPk
zipO7{31IR=){&>_=JM*rk!oW-9h(8j#vDw8Zwxi*PF7N0+eUblR8-u21Xj)XZ#fBl
z))LQ{t3b!kUnj;Yc$R~K2rY(ekf1jOa&!5{L+wlQ(cEU#DaVRSSX0lY>rQHACq+}+
zH)MQCmwcmz^mhI&G6Ho_mM1Bfs-tz1l=wyz+fMG346j=5+vwn;<=>J9=kHP=VLZz>
z_o#^WD93nmUWX{%Kb$>KH;$DrBiG!-^;Z39z<&|hwd=^68k_x?B_S0h&~C}<Fz|H>
zb#Vc}G5N;KPpBn;(!K4i+xoGcEa7Mu_DxKnp9@S&gU}u%>jGphh+V^F^k0}7bArV}
zOA!bkf%@JZa^&_t2gD~r)xtR$+wQTvC?)D{vFNSJs2V~<uk)9ugX@*`f}FhFqdR!t
zt!1@&`!Glww&3Ta)<n%F)}?HeOV<od%4+)1KtmNEg>ef5<wbV!7ElwP$LalLWcl>(
zCc#??K+3FH<?w3~+bUrYpxeqOlgLP^_wPw94)T_rGb~d)=}ZE%;CEK<X60hI@1y*6
ziliwoJZZ8Ca8hnC{0oH(tSbKpw995S0e5!<b0<19^k#qdy0M2pH#LWIJmwlZYF}X;
z0v6~mOmd}Dk;(+yW`kg#aK^j43=2#v{P%6MTA9j2|41o)t73h%DsYtvW*;UH@rCo8
z{3Vw?8%-n8KHsd5jF~k{K7;Suv9AoUZ*gIP)q$sF%(SKOwV@!!`&$%A6-F%fY!coD
zJhSk*vA4zQbc*$@&Yy4ZADst)|Hy5YHZH5=sK9q5Z_2m9gkeZAEbsccIusEGCjmrU
z<t#RSUt|oIVoL0q86w1AyOxNN)R+|ZX635tHJGK41A0;k^R&Bht4aLNH=6C^orVaH
zarf?l1p=X7;gYcjD%DE2zASWc%f#EEm@oNx9o)b12WG*3>PxA8T!w%NM_?#*OXoGr
zm^ECy-f}LV?xdR<tN`BAftDd}blhYQpJhSuHu>SQhYT{34T{_vSvh1IV>02Wrel*0
z^PPG;lao_k-bj=W^C5D`T(T6wl|rucBJcT?pW3)}k3z%$O<K5`|1E}w?F|oSysC@(
zzI$I#yr?bvL3#Ht`dvnn_DT?6Q&jKIuA^C7L;?!udAaIq>l!}Su7!Toh~=HPwZI2H
zVQMOA$K@8C%RG!EqkX+AIxpiXeo}fU2RV1zYoj@<Zow9O?PY$H{D#Za+8#zG3Q#`B
zYQ*O@&$>3Z7>y|_6h&{uO}DA#LhJR-f<qOH9MNe;-4;eLR5pKF6zy}fCCvwsS#y}v
zgob*#>YsIZZ(erH7)feG`$A2(JDple$yLePUCT3voeD6U16^NL0E)nmH*z-D*uZ;{
zTUW+Da|ifluU|)Q_U^yue!IlQ8?tRNy|BAG6?OZC6+mj8;ypcWny9Qo$baIpW>;Sm
zxx=eO`Ma{lsP%mk7Gs#I5w@qeGkfD0cD6HJ?V>^``Mz=hkNM$YIZN48q<YaZ0$q42
z=)7ZcLRY<=d<ks)ANjati)*V$$p4W2!^2pmR#xg~OzWQvg?N%JL?=}pc4jY0IdA=v
z1}Pht*Q%Jztq-1+d{d2jytUJ!AS}SZ;O7AD9f;M=%ZB(I-w&JgleAO*lt%w$R5#~B
zl&=OPv$;-41jITR17IS}V5tW!vs6WgZWgQvM$;Y_BA>*Gm|Bv`mUu($sgc`V@c{rB
z*nX`fp<y=PCH0O)y&;$%cl?1nSCSI>{%MBhU-nmhC%)c8^Q=9>u{1BLYy_ogIy(Vq
zKx#!|-Qztqo(+i&@R@Ck-+q?-X3tH<T>x1VkV%@G?etLZFBTMteQvXs>Y>b{6y0+O
z1mdZ8an?!@X4&ck3Mg~PeXgR{GZEC?gbsrDpgqSQ`wtHO^?*3At%9}KbkJLoOTYQ_
z0|s!*>L|l8o6qX8c&1|xT#mxba%*gqQv07I-X2d>`o3k)Acr$H2m^RH54FKem8rFn
zsp@0oV0P=;kpIv#gM8RJO7;fy2@V-M+Om!G9F6-@D#PoP`@DNT-YD<%Y+855{MbY2
zT;q000i0XkSMY%)vnQHF9=yC!3qL?apomy$g3(C!o{r3l%ftFXIs_hl&F2OLFn3o&
z4e6~nuJgWDR+T;H(Ouuop4w*lw`%pejhSV7(>qE4`Q|5k2geJ~Ja`y*Gt(Ju0x(>s
zo_ImRM{Q@eRe~)98S{v+P*S5+8vk;@aO)EbM=u4X)XuV|AzgPqtrH=e{4#POe+ncV
zD^?I=lu7h<G{_pU)ZVd43V&1pYSdHMa@F%sQId&S%us+{K$L92EaFet;fype*2-#h
zydL2Sw&J+^ouZ&$2F44u@Gi0`h%dG!+yRMN`DtNsYjVM^iDK#K61WXj=hsUgLc8WF
zlsFue@YAdlB8CigJk~X|=iyMOv$VzYQM}u*xTu9U$;1xf9>}HMLBxDK<VG`CgcgC2
z8!v*oCNNa}wNiR!DNkP#QhI+P7a}Lq`Fe>nU;CX2rdy@`-EM0|-i)1qOL+ZG<hfvI
zX(_J`P_F}Legg3-p(p2Vcq3&DGMoDVAMP3(E6yR+Kjy*6H{ssGAb_|&P@;-US<KqS
zZo&2vz+*NyNwvNm6015WBM<5Ixtmq^x22Tu#m1hv1*UT)&@=^o)JZ$ffBvWW@@@pU
zxTWnk`z9ZVIN+G(L8s~h<q4pQ0;pg`Kqdo3`r8iH@fK-%zK{BKbgUzmf6PtXt_O6@
z3<OMWuI+=~UP$@XuaZ6f$@r$n5b36q_w1sxkY;eo6HB>+EncTBhRd%DiwcVJgf292
zR{t<<q(~LC#M0EXE1>G>uW2~5WO=d$rgr|=SmZmVBRP6vq1H;Q=RDS1H2a;OLBm|4
z!k7r|RgWj{!`z}KN9l)Kq&-tz`_fv9Ha7gUtgoNOc}lLzqzs7T*|Yo{(%PZ3{X;%E
zwh&kr4t88@4~xLCX9@}iYEL5CDtP*q@vHJph6z>loB$^uZd$vno9~`wg|w9|2=j3j
zA&Z{FRMTLqI{ui7E}OuM@_FBP%81iI#SntpoH*N*GK+8@i?W-sH~~`S{95{A7`|v@
z0wScHk+|K|E#Vo{KFq^E0`{cB;S&lVX3-oOhx3uG->)L}sLRI+2<Vwk>-dEM0}nc$
zU5m<oX!HR3LAK51MNKXj=_AQA&$lHTKN)x?AfZoAC5DV8jV0;z^zA9$EZkcb80&)(
zoa;-_5BBwX6mDhK)fZ%cHU*}BWq53&{@P5j=lGSJ`E7tG2pu-h<IpoXVE8WzmObkx
ziJ2|(pY_Fls`n?C4r$eOluAGeM=PSoo(I$Wq>Av<YLI>Ch(e)!^YcohAPUcr0jRmV
z64LX2WwvIWsFQzN`jX6ZEi!k2!{JIlOtRnN<$hGrk*_Y;HLQJ<d>y)6PxA8;g|ZZM
zdi?~=8_UxVvd<j4zkr`;z83AX=rYXm$vZ)-v8gQhWPE0P>pTuVnA@&Wibboe$M1%R
zzmI!M=Cs_JUQ<VQR8|HeR^y{ZJItF%$*zv7S|2X}QT|-)0pf8;{c@Wc#9HDgo4})t
z4jedOefxzG3&6xq@$sHEwoO2C1yoaoTmzB~wtNtZ=YGl95sLfm#(}IiJ*s6N81m~{
z<=VFl<oB0VuTB}d7G%zLj{cPmYW#jB{{TCn;~l%K8MUl=x&<iV#0V3b222%`GD!fa
z4{u6)ycJ6B(-#UsVpju8buw`0{Ojw=618?Ai3QZSb_RB5?+5&<fwbBwuth}uvrPPd
zx~%yB#_#&SSr7jI2lrn*xFm0%*x1;6s@gF`Mp7lI8Fhu))O6k(e0rzpz_>Y3z6BGW
zt$O9{hQZIA2>@O?d41S|7#5G!(b1CR_Z}U7{>qdG#%p2I)B6qnY%f~h%wqMIzj(oX
z(d%A*$ia@w{d!-R50~3^>7r-;#o|gZAu^77e(?g~i)U0t+z9&uD05n)H!mN%=U%!6
z_UjuQ%mMW9V7SKKUu$Y=^c~M|mx~<G6>|`Q!Jbs0v~My$*ZQDm3OMaH?a?>L$tST`
zfZSN}EHbW}6#cFFX)3j;Z(=Yfo$;4_S)VJlch4L?Ke?;nmSkt|L@E#|GjCrNSWHv7
z$%@<W`d_+_;a@aw55RSdNYSdhVDM=7=*+pfuB_pP&w)bvSeF|@F1~W+OuJ>p$J1{B
zuQ?2g%joNE_f(sHa);X<z?L~EfSTtWe&Qz$obeTbTb914MJ}V5e!Od1BbKl<;)y@&
z;SMi8zspSc(x~&p*NcBhZveio1Mn0+n)DWU&g!4Bw-I`~4@Zz2m+Hnc^@&8{2MfFr
z2)-viJXfeQ%>(Lal5#p^ov3&GO^51!MtAon#(l4ydBmI6&#FZYKmM)3^BtukFAte*
zva6MHTgWb!N%uDB=H%p{D@0JVApE81mge65%J=SSZlduj4|b2g*p#vR9=z{41kit=
leP!6kAGL#%uV-$_Uw&NR>y{V1rkEOzXIxK{zWec~e*?putgHY4

literal 0
HcmV?d00001

diff --git a/website/docs/assets/maya-multiverse_openpype_look_creator.png b/website/docs/assets/maya-multiverse_openpype_look_creator.png
new file mode 100644
index 0000000000000000000000000000000000000000..14541e9e398fc99e3910d50a5286bdd8906b9f1a
GIT binary patch
literal 26190
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
XNN#wif}p^6lEBGJD?=(?y$$*wxlGVg

literal 0
HcmV?d00001

diff --git a/website/docs/assets/maya-multiverse_openpype_override_creator.png b/website/docs/assets/maya-multiverse_openpype_override_creator.png
new file mode 100644
index 0000000000000000000000000000000000000000..d7b1299ba652208c3842add85501e590453f4992
GIT binary patch
literal 125997
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

literal 0
HcmV?d00001

diff --git a/website/docs/assets/maya-multiverse_openpype_publishers.png b/website/docs/assets/maya-multiverse_openpype_publishers.png
new file mode 100644
index 0000000000000000000000000000000000000000..b83fa5f59cd95ac8f6feab2e043fb9514ab257a7
GIT binary patch
literal 182542
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

literal 0
HcmV?d00001

diff --git a/website/docs/assets/maya-multiverse_setup.png b/website/docs/assets/maya-multiverse_setup.png
new file mode 100644
index 0000000000000000000000000000000000000000..8aa89ef7e504272e7b5f9abbfea0ec0ca3d1d783
GIT binary patch
literal 164855
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
CH}}2(

literal 0
HcmV?d00001


From 2487c1f1cd8e759977d1ced49e4ed78a91d4dace Mon Sep 17 00:00:00 2001
From: pberto <pberto@gmail.com>
Date: Fri, 13 May 2022 13:28:35 +0900
Subject: [PATCH 0236/1227] cosmetics: removed two trailing whitespaces

---
 .../hosts/maya/plugins/publish/extract_multiverse_usd_comp.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
index c686b2a600..0e5074f127 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
@@ -122,12 +122,12 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
 
             comp_write_opts = multiverse.CompositionWriteOptions()
 
-            """ 
+            """
             OP tells MV to write to a staging directory, and then moves the
             file to it's final publish directory. By default, MV write relative
             paths, but these paths will break when the referencing file moves.
             This option forces writes to absolute paths, which is ok within OP
-            because all published assets have static paths, and MV can only 
+            because all published assets have static paths, and MV can only
             reference published assets. When a proper UsdAssetResolver is used,
             this won't be needed.
             """

From ababf4053e8de157b9edcc9227d662e476f3e497 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 13 May 2022 11:24:36 +0200
Subject: [PATCH 0237/1227] flame: splitting function into smaller parts

---
 .../publish/extract_subset_resources.py       | 80 +++++++++----------
 1 file changed, 40 insertions(+), 40 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 0e04336211..9ad3b21687 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -60,12 +60,7 @@ class ExtractSubsetResources(openpype.api.Extractor):
     export_presets_mapping = {}
 
     def process(self, instance):
-        if (
-            self.keep_original_representation
-            and "representations" not in instance.data
-            or not self.keep_original_representation
-        ):
-            instance.data["representations"] = []
+        self._make_representation_data(instance)
 
         # flame objects
         segment = instance.data["item"]
@@ -92,7 +87,6 @@ class ExtractSubsetResources(openpype.api.Extractor):
         handles = max(handle_start, handle_end)
 
         # get media source range with handles
-        source_end_handles = instance.data["sourceEndH"]
         source_start_handles = instance.data["sourceStartH"]
         source_end_handles = instance.data["sourceEndH"]
 
@@ -109,27 +103,7 @@ class ExtractSubsetResources(openpype.api.Extractor):
         for unique_name, preset_config in export_presets.items():
             modify_xml_data = {}
 
-            # get activating attributes
-            activated_preset = preset_config["active"]
-            filter_path_regex = preset_config.get("filter_path_regex")
-
-            self.log.info(
-                "Preset `{}` is active `{}` with filter `{}`".format(
-                    unique_name, activated_preset, filter_path_regex
-                )
-            )
-            self.log.debug(
-                "__ clip_path: `{}`".format(clip_path))
-
-            # skip if not activated presete
-            if not activated_preset:
-                continue
-
-            # exclude by regex filter if any
-            if (
-                filter_path_regex
-                and not re.search(filter_path_regex, clip_path)
-            ):
+            if self._should_skip(preset_config, clip_path, unique_name):
                 continue
 
             # get all presets attributes
@@ -147,18 +121,10 @@ class ExtractSubsetResources(openpype.api.Extractor):
                 )
             )
 
-            # get attribures related loading in integrate_batch_group
-            load_to_batch_group = preset_config.get(
-                "load_to_batch_group")
-            batch_group_loader_name = preset_config.get(
-                "batch_group_loader_name")
-
-            # convert to None if empty string
-            if batch_group_loader_name == "":
-                batch_group_loader_name = None
-
             # get frame range with handles for representation range
             frame_start_handle = frame_start - handle_start
+
+            # calculate duration with handles
             source_duration_handles = (
                 source_end_handles - source_start_handles)
 
@@ -272,8 +238,10 @@ class ExtractSubsetResources(openpype.api.Extractor):
                 "data": {
                     "colorspace": color_out
                 },
-                "load_to_batch_group": load_to_batch_group,
-                "batch_group_loader_name": batch_group_loader_name
+                "load_to_batch_group": preset_config.get(
+                    "load_to_batch_group"),
+                "batch_group_loader_name": preset_config.get(
+                    "batch_group_loader_name") or None
             }
 
             # collect all available content of export dir
@@ -328,6 +296,38 @@ class ExtractSubsetResources(openpype.api.Extractor):
         self.log.debug("All representations: {}".format(
             pformat(instance.data["representations"])))
 
+    def _should_skip(self, preset_config, clip_path, unique_name):
+        # get activating attributes
+        activated_preset = preset_config["active"]
+        filter_path_regex = preset_config.get("filter_path_regex")
+
+        self.log.info(
+            "Preset `{}` is active `{}` with filter `{}`".format(
+                unique_name, activated_preset, filter_path_regex
+            )
+        )
+        self.log.debug(
+            "__ clip_path: `{}`".format(clip_path))
+
+        # skip if not activated presete
+        if not activated_preset:
+            return True
+
+        # exclude by regex filter if any
+        if (
+            filter_path_regex
+            and not re.search(filter_path_regex, clip_path)
+        ):
+            return True
+
+    def _make_representation_data(self, instance):
+        if (
+            self.keep_original_representation
+            and "representations" not in instance.data
+            or not self.keep_original_representation
+        ):
+            instance.data["representations"] = []
+
     def _unfolds_nested_folders(self, stage_dir, files_list, ext):
         """Unfolds nested folders
 

From 0ae531d4cec91870774169f51ce373bb73e7261f Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 13 May 2022 11:25:29 +0200
Subject: [PATCH 0238/1227] flame: fixing small hickups

removing frame range input form reference
---
 openpype/hosts/flame/otio/flame_export.py | 7 ++++---
 openpype/lib/editorial.py                 | 8 ++++----
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/flame/otio/flame_export.py b/openpype/hosts/flame/otio/flame_export.py
index 08478d4b98..ffb82b97c2 100644
--- a/openpype/hosts/flame/otio/flame_export.py
+++ b/openpype/hosts/flame/otio/flame_export.py
@@ -205,8 +205,9 @@ def create_otio_markers(otio_item, item):
         otio_item.markers.append(otio_marker)
 
 
-def create_otio_reference(clip_data, duration, fps=None):
+def create_otio_reference(clip_data, fps=None):
     metadata = _get_metadata(clip_data)
+    duration = int(clip_data["source_duration"])
 
     # get file info for path and start frame
     frame_start = 0
@@ -307,7 +308,7 @@ def create_otio_clip(clip_data):
 
     # secondly check if any change of speed
     if source_duration != _clip_record_duration:
-        retime_speed = float(source_duration / _clip_record_duration)
+        retime_speed = float(source_duration) / float(_clip_record_duration)
         log.debug("_ retime_speed: {}".format(retime_speed))
         speed *= retime_speed
 
@@ -319,7 +320,7 @@ def create_otio_clip(clip_data):
 
     # create media reference
     media_reference = create_otio_reference(
-        clip_data, source_duration, media_fps)
+        clip_data, media_fps)
 
     # creatae source range
     source_range = create_otio_time_range(
diff --git a/openpype/lib/editorial.py b/openpype/lib/editorial.py
index 1ee21deedc..4979bac159 100644
--- a/openpype/lib/editorial.py
+++ b/openpype/lib/editorial.py
@@ -269,16 +269,16 @@ def get_media_range_with_retimes(otio_clip, handle_start, handle_end):
             "retime": True,
             "speed": time_scalar,
             "timewarps": time_warp_nodes,
-            "handleStart": handle_start,
-            "handleEnd": handle_end
+            "handleStart": round(handle_start),
+            "handleEnd": round(handle_end)
         }
     }
 
     returning_dict = {
         "mediaIn": media_in_trimmed,
         "mediaOut": media_out_trimmed,
-        "handleStart": handle_start,
-        "handleEnd": handle_end
+        "handleStart": round(handle_start),
+        "handleEnd": round(handle_end)
     }
 
     # add version data only if retime

From 43aee1989c197b74ce692b64581b233371aa8003 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 13 May 2022 11:55:03 +0200
Subject: [PATCH 0239/1227] flame: fixing padding if it is higher then needed

---
 openpype/hosts/flame/api/lib.py | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index f2f5db184b..6dc7d3d887 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -855,22 +855,24 @@ class MediaInfoFile(object):
 
         # add `[` in front to make sure it want capture
         # shot name with the same number
-        number_from_path = "[" + self._separate_number(feed_basename, feed_ext)
+        number_from_path = self._separate_number(feed_basename, feed_ext)
+        search_number_pattern = "[" + number_from_path
         # convert to multiple collections
         _continues_colls = collection.separate()
         for _coll in _continues_colls:
-            coll_to_text = self._format_collection(_coll)
+            coll_to_text = self._format_collection(_coll, len(number_from_path))
             self.log.debug("__ coll_to_text: {}".format(coll_to_text))
-            if number_from_path in coll_to_text:
+            if search_number_pattern in coll_to_text:
                 return coll_to_text
 
     @staticmethod
-    def _format_collection(collection):
+    def _format_collection(collection, padding=None):
+        padding = padding or collection.padding
         # if no holes then return collection
         head = collection.format("{head}")
         tail = collection.format("{tail}")
         range_template = "[{{:0{0}d}}-{{:0{0}d}}]".format(
-            len(str(max(collection.indexes))))
+            padding)
         ranges = range_template.format(
             min(collection.indexes),
             max(collection.indexes)

From 30123edb55ddbda74259318c6b85e0df19da0cd8 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 13 May 2022 20:10:51 +0200
Subject: [PATCH 0240/1227] flame: adding xml element if it is missing and its
 path possible

---
 openpype/hosts/flame/api/render_utils.py | 41 +++++++++++++++++++++---
 1 file changed, 37 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/flame/api/render_utils.py b/openpype/hosts/flame/api/render_utils.py
index 473fb2f985..9957550af9 100644
--- a/openpype/hosts/flame/api/render_utils.py
+++ b/openpype/hosts/flame/api/render_utils.py
@@ -1,5 +1,8 @@
 import os
 from xml.etree import ElementTree as ET
+import openpype.api as openpype
+
+log = openpype.Logger.get_logger(__name__)
 
 
 def export_clip(export_path, clip, preset_path, **kwargs):
@@ -143,10 +146,40 @@ def modify_preset_file(xml_path, staging_dir, data):
 
     # change xml following data keys
     with open(xml_path, "r") as datafile:
-        tree = ET.parse(datafile)
+        _root = ET.parse(datafile)
+
         for key, value in data.items():
-            for element in tree.findall(".//{}".format(key)):
-                element.text = str(value)
-        tree.write(temp_path)
+            try:
+                if "/" in key:
+                    if not key.startswith("./"):
+                        key = ".//" + key
+
+                    split_key_path = key.split("/")
+                    element_key = split_key_path[-1]
+                    parent_obj_path = "/".join(split_key_path[:-1])
+
+                    parent_obj = _root.find(parent_obj_path)
+                    element_obj = parent_obj.find(element_key)
+                    if not element_obj:
+                        append_element(parent_obj, element_key, value)
+                else:
+                    finds = _root.findall(".//{}".format(key))
+                    if not finds:
+                        raise AttributeError
+                    for element in finds:
+                        element.text = str(value)
+            except AttributeError:
+                log.warning(
+                    "Cannot create attribute: {}: {}. Skipping".format(
+                        key, value
+                    ))
+        _root.write(temp_path)
 
     return temp_path
+
+
+def append_element(root_element_obj, key, value):
+    new_element_obj = ET.Element(key)
+    log.debug("__ new_element_obj: {}".format(new_element_obj))
+    new_element_obj.text = str(value)
+    root_element_obj.insert(0, new_element_obj)

From 851df8155f43d4fd6639ee71ab3a3f023e06c7a5 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 13 May 2022 20:11:20 +0200
Subject: [PATCH 0241/1227] flame: treat thumbnail as poster frame

---
 .../publish/extract_subset_resources.py        | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 9ad3b21687..eea575ea88 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -168,10 +168,6 @@ class ExtractSubsetResources(openpype.api.Extractor):
                 # add any xml overrides collected form segment.comment
                 modify_xml_data.update(instance.data["xml_overrides"])
 
-                self.log.debug("__ modify_xml_data: {}".format(pformat(
-                    modify_xml_data
-                )))
-
             export_kwargs = {}
             # validate xml preset file is filled
             if preset_file == "":
@@ -198,11 +194,13 @@ class ExtractSubsetResources(openpype.api.Extractor):
                 preset_dir, preset_file
             ))
 
-            preset_path = opfapi.modify_preset_file(
-                preset_orig_xml_path, staging_dir, modify_xml_data)
-
             # define kwargs based on preset type
             if "thumbnail" in unique_name:
+                modify_xml_data.update({
+                    "video/posterFrame": True,
+                    "video/useFrameAsPoster": 1,
+                    "namePattern": "__thumbnail"
+                })
                 thumb_frame_number = int(in_mark + (
                     source_duration_handles / 2))
 
@@ -218,6 +216,12 @@ class ExtractSubsetResources(openpype.api.Extractor):
                     "out_mark": out_mark
                 })
 
+            self.log.debug("__ modify_xml_data: {}".format(
+                pformat(modify_xml_data)
+            ))
+            preset_path = opfapi.modify_preset_file(
+                preset_orig_xml_path, staging_dir, modify_xml_data)
+
             # get and make export dir paths
             export_dir_path = str(os.path.join(
                 staging_dir, unique_name

From d7454044c92f54392b3c8108a466bb6a5758b830 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?G=C3=A1bor=20Marinov?= <gabor.marinov@moonrock.eu>
Date: Fri, 13 May 2022 21:02:44 +0200
Subject: [PATCH 0242/1227] Nuke: add pointcache and animation to loader

---
 openpype/hosts/nuke/plugins/load/load_model.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/load/load_model.py b/openpype/hosts/nuke/plugins/load/load_model.py
index 9788bb25d2..89b58585ef 100644
--- a/openpype/hosts/nuke/plugins/load/load_model.py
+++ b/openpype/hosts/nuke/plugins/load/load_model.py
@@ -15,13 +15,13 @@ from openpype.hosts.nuke.api import (
 
 class AlembicModelLoader(load.LoaderPlugin):
     """
-    This will load alembic model into script.
+    This will load alembic model or anim into script.
     """
 
-    families = ["model"]
+    families = ["model","pointcache","animation"]
     representations = ["abc"]
 
-    label = "Load Alembic Model"
+    label = "Load Alembic Model or Anim"
     icon = "cube"
     color = "orange"
     node_color = "0x4ecd91ff"

From dfb3e53743b3bc4229b1c82beb1ff0ecbffc7323 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?G=C3=A1bor=20Marinov?= <gabor.marinov@moonrock.eu>
Date: Fri, 13 May 2022 21:07:45 +0200
Subject: [PATCH 0243/1227] fix missing whitespaces

---
 openpype/hosts/nuke/plugins/load/load_model.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/plugins/load/load_model.py b/openpype/hosts/nuke/plugins/load/load_model.py
index 89b58585ef..8aaa7221eb 100644
--- a/openpype/hosts/nuke/plugins/load/load_model.py
+++ b/openpype/hosts/nuke/plugins/load/load_model.py
@@ -18,7 +18,7 @@ class AlembicModelLoader(load.LoaderPlugin):
     This will load alembic model or anim into script.
     """
 
-    families = ["model","pointcache","animation"]
+    families = ["model", "pointcache", "animation"]
     representations = ["abc"]
 
     label = "Load Alembic Model or Anim"

From 631ccf6318916d9c7ad98830dba3007c073e70db Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Mon, 16 May 2022 10:24:39 +0200
Subject: [PATCH 0244/1227] Update
 openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../kitsu/plugins/publish/integrate_kitsu_review.py      | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index 57e0286b00..a036f5f9cc 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -25,12 +25,9 @@ class IntegrateKitsuReview(pyblish.api.InstancePlugin):
             return
 
         # Add review representations as preview of comment
-        for representation in [
-            r
-            for r in instance.data.get("representations", [])
-            if "review" in r.get("tags", [])
-        ]:
-
+        for representation in instance.data.get("representations", []):
+            if "review" not in r.get("tags", []):
+                continue
             review_path = representation.get("published_path")
 
             self.log.debug("Found review at: {}".format(review_path))

From 15aa5709ae18c3cca83e73fef9eaa557684a0a5b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Mon, 16 May 2022 10:25:41 +0200
Subject: [PATCH 0245/1227] cleaning

---
 .../modules/kitsu/plugins/publish/integrate_kitsu_review.py   | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index a036f5f9cc..bf80095225 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -26,8 +26,10 @@ class IntegrateKitsuReview(pyblish.api.InstancePlugin):
 
         # Add review representations as preview of comment
         for representation in instance.data.get("representations", []):
-            if "review" not in r.get("tags", []):
+            # Skip if not tagged as review
+            if "review" not in representation.get("tags", []):
                 continue
+
             review_path = representation.get("published_path")
 
             self.log.debug("Found review at: {}".format(review_path))

From 7d13de97f694ee735ffc4de63749c285c898b7e0 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 16 May 2022 11:14:02 +0200
Subject: [PATCH 0246/1227] Flame: add handles including to settings

---
 openpype/settings/defaults/project_settings/flame.json       | 3 ++-
 .../schemas/projects_schema/schema_project_flame.json        | 5 +++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/flame.json b/openpype/settings/defaults/project_settings/flame.json
index dd8c05d460..a7836b9c1f 100644
--- a/openpype/settings/defaults/project_settings/flame.json
+++ b/openpype/settings/defaults/project_settings/flame.json
@@ -16,7 +16,8 @@
             "vSyncOn": false,
             "workfileFrameStart": 1001,
             "handleStart": 5,
-            "handleEnd": 5
+            "handleEnd": 5,
+            "includeHandles": false
         }
     },
     "publish": {
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_flame.json b/openpype/settings/entities/schemas/projects_schema/schema_project_flame.json
index ace404b47a..ca62679b3d 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_flame.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_flame.json
@@ -123,6 +123,11 @@
                                 "type": "number",
                                 "key": "handleEnd",
                                 "label": "Handle end (tail)"
+                            },
+                            {
+                                "type": "boolean",
+                                "key": "includeHandles",
+                                "label": "Enable handles including"
                             }
                           ]
                         }

From 3895008eae62c2ebba2afe60b0f0320bc7604cc0 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 16 May 2022 11:26:14 +0200
Subject: [PATCH 0247/1227] flame: implementing handles include switch

---
 openpype/hosts/flame/api/plugin.py | 3 +++
 openpype/version.py                | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/api/plugin.py b/openpype/hosts/flame/api/plugin.py
index 11108ba49f..efbabb6a55 100644
--- a/openpype/hosts/flame/api/plugin.py
+++ b/openpype/hosts/flame/api/plugin.py
@@ -360,6 +360,7 @@ class PublishableClip:
     driving_layer_default = ""
     index_from_segment_default = False
     use_shot_name_default = False
+    include_handles_default = False
 
     def __init__(self, segment, **kwargs):
         self.rename_index = kwargs["rename_index"]
@@ -493,6 +494,8 @@ class PublishableClip:
             "reviewTrack", {}).get("value") or self.review_track_default
         self.audio = self.ui_inputs.get(
             "audio", {}).get("value") or False
+        self.include_handles = self.ui_inputs.get(
+            "includeHandles", {}).get("value") or self.include_handles_default
 
         # build subset name from layer name
         if self.subset_name == "[ track name ]":
diff --git a/openpype/version.py b/openpype/version.py
index 662adf28ca..fe2a90bdd1 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.10.0-nightly.2"
+__version__ = "3.10.0-nightly.2-upp220513-1+staging"

From 5c4541ca0ae6af1561ecd2e405d840579d4264ae Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 16 May 2022 11:31:06 +0200
Subject: [PATCH 0248/1227] flame: implementing handles including

---
 openpype/hosts/flame/api/plugin.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/openpype/hosts/flame/api/plugin.py b/openpype/hosts/flame/api/plugin.py
index 11108ba49f..efbabb6a55 100644
--- a/openpype/hosts/flame/api/plugin.py
+++ b/openpype/hosts/flame/api/plugin.py
@@ -360,6 +360,7 @@ class PublishableClip:
     driving_layer_default = ""
     index_from_segment_default = False
     use_shot_name_default = False
+    include_handles_default = False
 
     def __init__(self, segment, **kwargs):
         self.rename_index = kwargs["rename_index"]
@@ -493,6 +494,8 @@ class PublishableClip:
             "reviewTrack", {}).get("value") or self.review_track_default
         self.audio = self.ui_inputs.get(
             "audio", {}).get("value") or False
+        self.include_handles = self.ui_inputs.get(
+            "includeHandles", {}).get("value") or self.include_handles_default
 
         # build subset name from layer name
         if self.subset_name == "[ track name ]":

From 45c445d438106b1ed3d989224778884f7796974b Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 16 May 2022 11:33:35 +0200
Subject: [PATCH 0249/1227] removing version change by excident

---
 openpype/version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/version.py b/openpype/version.py
index fe2a90bdd1..662adf28ca 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.10.0-nightly.2-upp220513-1+staging"
+__version__ = "3.10.0-nightly.2"

From e6286166fba934945756357ee08b5d6d89f95cde Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Mon, 16 May 2022 11:33:35 +0200
Subject: [PATCH 0250/1227] remove default intent effect on review integration

---
 .../modules/kitsu/plugins/publish/integrate_kitsu_note.py    | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 980589365d..9e067a8ecb 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -11,11 +11,6 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     # families = ["kitsu"]
 
     def process(self, context):
-        # Check if work version for user
-        is_work_version = bool(context.data.get("intent", {}).get("value"))
-        if is_work_version:
-            self.log.info("Work version, nothing pushed to Kitsu.")
-            return
 
         # Get comment text body
         publish_comment = context.data.get("comment")

From 5e68cfad86cb3781f3acdc66f681651a11b84945 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?G=C3=A1bor=20Marinov?= <gabor.marinov@moonrock.eu>
Date: Mon, 16 May 2022 11:43:44 +0200
Subject: [PATCH 0251/1227] More straightforward label

---
 openpype/hosts/nuke/plugins/load/load_model.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/plugins/load/load_model.py b/openpype/hosts/nuke/plugins/load/load_model.py
index 8aaa7221eb..2f54595cb0 100644
--- a/openpype/hosts/nuke/plugins/load/load_model.py
+++ b/openpype/hosts/nuke/plugins/load/load_model.py
@@ -21,7 +21,7 @@ class AlembicModelLoader(load.LoaderPlugin):
     families = ["model", "pointcache", "animation"]
     representations = ["abc"]
 
-    label = "Load Alembic Model or Anim"
+    label = "Load Alembic"
     icon = "cube"
     color = "orange"
     node_color = "0x4ecd91ff"

From 3b15167adb602394ad32dcdbeec7f8f0bbb242a3 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 16 May 2022 11:54:29 +0200
Subject: [PATCH 0252/1227] Flame: adding new attribute to ui

includeHandles
---
 openpype/hosts/flame/plugins/create/create_shot_clip.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/openpype/hosts/flame/plugins/create/create_shot_clip.py b/openpype/hosts/flame/plugins/create/create_shot_clip.py
index 11c00dab42..fa239ea420 100644
--- a/openpype/hosts/flame/plugins/create/create_shot_clip.py
+++ b/openpype/hosts/flame/plugins/create/create_shot_clip.py
@@ -268,6 +268,14 @@ class CreateShotClip(opfapi.Creator):
                         "target": "tag",
                         "toolTip": "Handle at end of clip",  # noqa
                         "order": 2
+                    },
+                    "includeHandles": {
+                        "value": False,
+                        "type": "QCheckBox",
+                        "label": "Include handles",
+                        "target": "tag",
+                        "toolTip": "By default handles are excluded",  # noqa
+                        "order": 3
                     }
                 }
             }

From 3ef846b1623dabfdbcb6cb464c097ec6b19bd473 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 16 May 2022 12:59:55 +0200
Subject: [PATCH 0253/1227] flame: fixing head and tail calculation

---
 .../publish/collect_timeline_instances.py     | 45 ++++++++++++-------
 1 file changed, 28 insertions(+), 17 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
index 5174f9db48..306d2da203 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
@@ -58,12 +58,16 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
             clip_name = clip_data["segment_name"]
             self.log.debug("clip_name: {}".format(clip_name))
 
+            # get otio clip data
+            otio_data = self._get_otio_clip_instance_data(clip_data) or {}
+            self.log.debug("__ otio_data: {}".format(pformat(otio_data)))
+
             # get file path
             file_path = clip_data["fpath"]
 
             first_frame = opfapi.get_frame_from_filename(file_path) or 0
 
-            head, tail = self._get_head_tail(clip_data, first_frame)
+            head, tail = self._get_head_tail(clip_data, otio_data["otioClip"])
 
             # solve handles length
             marker_data["handleStart"] = min(
@@ -76,6 +80,9 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
             # add marker data to instance data
             inst_data = dict(marker_data.items())
 
+            # add ocio_data to instance data
+            inst_data.update(otio_data)
+
             asset = marker_data["asset"]
             subset = marker_data["subset"]
 
@@ -105,13 +112,6 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
                     task["name"]: {"type": task["type"]}
                     for task in self.add_tasks}
             })
-
-            # get otio clip data
-            otio_data = self._get_otio_clip_instance_data(clip_data) or {}
-            self.log.debug("__ otio_data: {}".format(pformat(otio_data)))
-
-            # add to instance data
-            inst_data.update(otio_data)
             self.log.debug("__ inst_data: {}".format(pformat(inst_data)))
 
             # add resolution
@@ -236,20 +236,31 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
 
         return split_comments
 
-    def _get_head_tail(self, clip_data, first_frame):
+    def _get_head_tail(self, clip_data, otio_clip):
         # calculate head and tail with forward compatibility
         head = clip_data.get("segment_head")
         tail = clip_data.get("segment_tail")
+        self.log.debug("__ head: `{}`".format(head))
+        self.log.debug("__ tail: `{}`".format(tail))
 
         # HACK: it is here to serve for versions bellow 2021.1
-        if not head:
-            head = int(clip_data["source_in"]) - int(first_frame)
-        if not tail:
-            tail = int(
-                clip_data["source_duration"] - (
-                    head + clip_data["record_duration"]
-                )
-            )
+        if not any([head, tail]):
+            otio_source_range = otio_clip.source_range
+            otio_avalable_range = otio_clip.available_range()
+            range_convert = openpype.lib.otio_range_to_frame_range
+            src_start, src_end = range_convert(otio_source_range)
+            av_start, av_end = range_convert(otio_avalable_range)
+            av_range = av_end - av_start
+            av_tail = av_range - src_end
+
+            self.log.debug("__ src_start: `{}`".format(src_start))
+            self.log.debug("__ src_end: `{}`".format(src_end))
+            self.log.debug("__ av_range: `{}`".format(av_range))
+            self.log.debug("__ av_tail: `{}`".format(av_tail))
+
+            head = src_start
+            tail = av_tail
+
         return head, tail
 
     def _get_resolution_to_data(self, data, context):

From 05cb2e4bd938ee1c533bb39625f4d3bbb7b2dad4 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 16 May 2022 13:49:39 +0200
Subject: [PATCH 0254/1227] waiting approval status can be set in project
 settings

---
 .../plugins/publish/integrate_kitsu_note.py   |  9 ++++---
 .../defaults/project_settings/kitsu.json      |  5 ++++
 .../projects_schema/schema_project_kitsu.json | 25 +++++++++++++++++++
 3 files changed, 36 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 9e067a8ecb..876eb6bf29 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -9,6 +9,7 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     order = pyblish.api.IntegratorOrder
     label = "Kitsu Note and Status"
     # families = ["kitsu"]
+    waiting_for_approval_status = "wfa"
 
     def process(self, context):
 
@@ -20,11 +21,13 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
         self.log.debug("Comment is `{}`".format(publish_comment))
 
         # Get Waiting for Approval status
-        kitsu_status = gazu.task.get_task_status_by_short_name("wfa")
+        kitsu_status = gazu.task.get_task_status_by_short_name(
+            self.waiting_for_approval_status
+        )
         if not kitsu_status:
             self.log.info(
-                "Cannot find 'Waiting For Approval' status."
-                "The status will not be changed"
+                "Cannot find {} status. The status will not be "
+                "changed!".format(self.waiting_for_approval_status)
             )
             kitsu_status = context.data["kitsu_task"].get("task_status")
         self.log.debug("Kitsu status: {}".format(kitsu_status))
diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
index a37146e1d2..2f1566d89a 100644
--- a/openpype/settings/defaults/project_settings/kitsu.json
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -7,5 +7,10 @@
         "episode": "E##",
         "sequence": "SQ##",
         "shot": "SH##"
+    },
+    "publish": {
+        "IntegrateKitsuNote": {
+            "waiting_for_approval_status": "wfa"
+        }
     }
 }
\ No newline at end of file
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index 8d71d0ecd6..cffd7ff578 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -43,6 +43,31 @@
                     "label": "Shot:"
                 }
             ]
+        },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "publish",
+            "label": "Publish plugins",
+            "children": [
+                {
+                    "type": "label",
+                    "label": "Integrator"
+                },
+                {
+                    "type": "dict",
+                    "collapsible": true,
+                    "key": "IntegrateKitsuNote",
+                    "label": "Integrate Kitsu Note",
+                    "children": [
+                        {
+                            "type": "text",
+                            "key": "waiting_for_approval_status",
+                            "label": "Waiting for Aproval Status:"
+                        }
+                    ]
+                }
+            ]
         }
     ]
 }

From 83de346d990ac9e86c10cf85548483d5db17e176 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 16 May 2022 14:59:37 +0200
Subject: [PATCH 0255/1227] Implement update, remove, switch + fix vdb sequence
 support

---
 .../maya/plugins/load/load_vdb_to_redshift.py | 87 +++++++++++++++++--
 1 file changed, 81 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/maya/plugins/load/load_vdb_to_redshift.py b/openpype/hosts/maya/plugins/load/load_vdb_to_redshift.py
index 70bd9d22e2..7867f49bd1 100644
--- a/openpype/hosts/maya/plugins/load/load_vdb_to_redshift.py
+++ b/openpype/hosts/maya/plugins/load/load_vdb_to_redshift.py
@@ -1,11 +1,21 @@
 import os
 
 from openpype.api import get_project_settings
-from openpype.pipeline import load
+from openpype.pipeline import (
+    load,
+    get_representation_path
+)
 
 
 class LoadVDBtoRedShift(load.LoaderPlugin):
-    """Load OpenVDB in a Redshift Volume Shape"""
+    """Load OpenVDB in a Redshift Volume Shape
+
+    Note that the RedshiftVolumeShape is created without a RedshiftVolume
+    shader assigned. To get the Redshift volume to render correctly assign
+    a RedshiftVolume shader (in the Hypershade) and set the density, scatter
+    and emission channels to the channel names of the volumes in the VDB file.
+
+    """
 
     families = ["vdbcache"]
     representations = ["vdb"]
@@ -55,7 +65,7 @@ class LoadVDBtoRedShift(load.LoaderPlugin):
 
         # Root group
         label = "{}:{}".format(namespace, name)
-        root = cmds.group(name=label, empty=True)
+        root = cmds.createNode("transform", name=label)
 
         settings = get_project_settings(os.environ['AVALON_PROJECT'])
         colors = settings['maya']['load']['colors']
@@ -74,9 +84,7 @@ class LoadVDBtoRedShift(load.LoaderPlugin):
                                       name="{}RVSShape".format(label),
                                       parent=root)
 
-        cmds.setAttr("{}.fileName".format(volume_node),
-                     self.fname,
-                     type="string")
+        self._apply_settings(volume_node, path=self.fname)
 
         nodes = [root, volume_node]
         self[:] = nodes
@@ -87,3 +95,70 @@ class LoadVDBtoRedShift(load.LoaderPlugin):
             nodes=nodes,
             context=context,
             loader=self.__class__.__name__)
+
+    def _apply_settings(self,
+                        grid_node,
+                        path):
+        """Apply the settings for the VDB path to the VRayVolumeGrid"""
+        from maya import cmds
+
+        # The path points to a single file. However the vdb files could be
+        # either just that single file or a sequence in a folder so we check
+        # whether it's a sequence
+        folder = os.path.dirname(path)
+        files = os.listdir(folder)
+        is_single_file = len(files) == 1
+        if is_single_file:
+            filename = path
+        else:
+            # The path points to the publish .vdb sequence filepath so we
+            # find the first file in there that ends with .vdb
+            files = sorted(files)
+            first = next((x for x in files if x.endswith(".vdb")), None)
+            if first is None:
+                raise RuntimeError("Couldn't find first .vdb file of "
+                                   "sequence in: %s" % path)
+            filename = os.path.join(path, first)
+
+        # Tell Redshift whether it should load as sequence or single file
+        cmds.setAttr(grid_node + ".useFrameExtension", not is_single_file)
+
+        # Set file path
+        cmds.setAttr(grid_node + ".fileName", filename, type="string")
+
+    def update(self, container, representation):
+        from maya import cmds
+
+        path = get_representation_path(representation)
+
+        # Find VRayVolumeGrid
+        members = cmds.sets(container['objectName'], query=True)
+        grid_nodes = cmds.ls(members, type="RedshiftVolumeShape", long=True)
+        assert len(grid_nodes) == 1, "This is a bug"
+
+        # Update the VRayVolumeGrid
+        self._apply_settings(grid_nodes[0], path=path)
+
+        # Update container representation
+        cmds.setAttr(container["objectName"] + ".representation",
+                     str(representation["_id"]),
+                     type="string")
+
+    def remove(self, container):
+        from maya import cmds
+
+        # Get all members of the avalon container, ensure they are unlocked
+        # and delete everything
+        members = cmds.sets(container['objectName'], query=True)
+        cmds.lockNode(members, lock=False)
+        cmds.delete([container['objectName']] + members)
+
+        # Clean up the namespace
+        try:
+            cmds.namespace(removeNamespace=container['namespace'],
+                           deleteNamespaceContent=True)
+        except RuntimeError:
+            pass
+
+    def switch(self, container, representation):
+        self.update(container, representation)

From 0699906344a8399eeb0f7c10c6b61963ce3eb3e2 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 16 May 2022 15:20:57 +0200
Subject: [PATCH 0256/1227] Flame: implementing handles inclusion to publishing

---
 .../plugins/publish/collect_timeline_instances.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
index 306d2da203..4bca0dcf93 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
@@ -36,6 +36,7 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
         for segment in selected_segments:
             # get openpype tag data
             marker_data = opfapi.get_segment_data_marker(segment)
+
             self.log.debug("__ marker_data: {}".format(
                 pformat(marker_data)))
 
@@ -75,6 +76,8 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
             marker_data["handleEnd"] = min(
                 marker_data["handleEnd"], abs(tail))
 
+            workfile_start = self._set_workfile_start(marker_data)
+
             with_audio = bool(marker_data.pop("audio"))
 
             # add marker data to instance data
@@ -105,6 +108,7 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
                 "families": families,
                 "publish": marker_data["publish"],
                 "fps": self.fps,
+                "workfileFrameStart": workfile_start,
                 "sourceFirstFrame": int(first_frame),
                 "path": file_path,
                 "flameAddTasks": self.add_tasks,
@@ -145,6 +149,17 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
             if marker_data.get("reviewTrack") is not None:
                 instance.data["reviewAudio"] = True
 
+    @staticmethod
+    def _set_workfile_start(data):
+        include_handles = data.get("includeHandles")
+        workfile_start = data["workfileFrameStart"]
+        handle_start = data["handleStart"]
+
+        if include_handles:
+            workfile_start += handle_start
+
+        return workfile_start
+
     def _get_comment_attributes(self, segment):
         comment = segment.comment.get_value()
 

From 0b0a9ca2815251ba423f543e376a38e5805c0aba Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 16 May 2022 15:46:47 +0200
Subject: [PATCH 0257/1227] by default use task status if not specified in
 config

---
 .../plugins/publish/integrate_kitsu_note.py   | 34 ++++++++++++-------
 .../defaults/project_settings/kitsu.json      |  3 +-
 .../projects_schema/schema_project_kitsu.json |  9 +++--
 3 files changed, 31 insertions(+), 15 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 876eb6bf29..ae559e660e 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -1,4 +1,5 @@
 # -*- coding: utf-8 -*-
+from distutils.log import debug
 import gazu
 import pyblish.api
 
@@ -9,7 +10,8 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     order = pyblish.api.IntegratorOrder
     label = "Kitsu Note and Status"
     # families = ["kitsu"]
-    waiting_for_approval_status = "wfa"
+    set_status_note = False
+    note_status_shortname = "wfa"
 
     def process(self, context):
 
@@ -20,21 +22,29 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
 
         self.log.debug("Comment is `{}`".format(publish_comment))
 
-        # Get Waiting for Approval status
-        kitsu_status = gazu.task.get_task_status_by_short_name(
-            self.waiting_for_approval_status
-        )
-        if not kitsu_status:
-            self.log.info(
-                "Cannot find {} status. The status will not be "
-                "changed!".format(self.waiting_for_approval_status)
+        # Get note status, by default uses the task status for the note 
+        # if it is not specified in the configuration
+        note_status = context.data["kitsu_task"]["task_status_id"]
+        if self.set_status_note:
+            kitsu_status = gazu.task.get_task_status_by_short_name(
+                self.note_status_shortname
             )
-            kitsu_status = context.data["kitsu_task"].get("task_status")
-        self.log.debug("Kitsu status: {}".format(kitsu_status))
+            if not kitsu_status:
+                self.log.info(
+                    "Cannot find {} status. The status will not be "
+                    "changed!".format(self.note_status_shortname)
+                )
+            else:
+                note_status = kitsu_status
+                self.log.info("Note Kitsu status: {}".format(note_status))
 
         # Add comment to kitsu task
+        self.log.debug("Add new note in taks id {}".format(
+            context.data["kitsu_task"]['id']))
         kitsu_comment = gazu.task.add_comment(
-            context.data["kitsu_task"], kitsu_status, comment=publish_comment
+            context.data["kitsu_task"], 
+            note_status, 
+            comment=publish_comment
         )
 
         context.data["kitsu_comment"] = kitsu_comment
diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
index 2f1566d89a..ba02d8d259 100644
--- a/openpype/settings/defaults/project_settings/kitsu.json
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -10,7 +10,8 @@
     },
     "publish": {
         "IntegrateKitsuNote": {
-            "waiting_for_approval_status": "wfa"
+            "set_status_note": false,
+            "note_status_shortname": "wfa"
         }
     }
 }
\ No newline at end of file
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index cffd7ff578..014a1b7886 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -60,10 +60,15 @@
                     "key": "IntegrateKitsuNote",
                     "label": "Integrate Kitsu Note",
                     "children": [
+                        {
+                            "type": "boolean",
+                            "key": "set_status_note",
+                            "label": "Set status on note"
+                        },
                         {
                             "type": "text",
-                            "key": "waiting_for_approval_status",
-                            "label": "Waiting for Aproval Status:"
+                            "key": "note_status_shortname",
+                            "label": "Note shortname"
                         }
                     ]
                 }

From 196182f5c5ffdc5bb02d86dedf46fb27b704f64e Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 16 May 2022 20:57:51 +0200
Subject: [PATCH 0258/1227] general: expose lib editorial function to lib init

---
 openpype/lib/__init__.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/lib/__init__.py b/openpype/lib/__init__.py
index 3c1d71ecd5..8d4e733b7d 100644
--- a/openpype/lib/__init__.py
+++ b/openpype/lib/__init__.py
@@ -203,6 +203,7 @@ from .editorial import (
     is_overlapping_otio_ranges,
     otio_range_to_frame_range,
     otio_range_with_handles,
+    get_media_range_with_retimes,
     convert_to_padded_path,
     trim_media_range,
     range_from_frames,
@@ -382,6 +383,7 @@ __all__ = [
     "otio_range_with_handles",
     "convert_to_padded_path",
     "otio_range_to_frame_range",
+    "get_media_range_with_retimes",
     "trim_media_range",
     "range_from_frames",
     "frames_to_secons",

From 6ee42b1d19b890ee583f4a10f8efab81ebec043e Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 16 May 2022 20:58:20 +0200
Subject: [PATCH 0259/1227] flame: make head and tail with retimed value

---
 .../publish/collect_timeline_instances.py     | 34 +++++++++----------
 1 file changed, 16 insertions(+), 18 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
index 4bca0dcf93..012cb110ec 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
@@ -1,8 +1,8 @@
 import re
 import pyblish
-import openpype
 import openpype.hosts.flame.api as opfapi
 from openpype.hosts.flame.otio import flame_export
+import openpype.lib as oplib
 
 # # developer reload modules
 from pprint import pformat
@@ -68,7 +68,12 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
 
             first_frame = opfapi.get_frame_from_filename(file_path) or 0
 
-            head, tail = self._get_head_tail(clip_data, otio_data["otioClip"])
+            head, tail = self._get_head_tail(
+                clip_data,
+                otio_data["otioClip"],
+                marker_data["handleStart"],
+                marker_data["handleEnd"]
+            )
 
             # solve handles length
             marker_data["handleStart"] = min(
@@ -251,7 +256,7 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
 
         return split_comments
 
-    def _get_head_tail(self, clip_data, otio_clip):
+    def _get_head_tail(self, clip_data, otio_clip, handle_start, handle_end):
         # calculate head and tail with forward compatibility
         head = clip_data.get("segment_head")
         tail = clip_data.get("segment_tail")
@@ -260,21 +265,14 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
 
         # HACK: it is here to serve for versions bellow 2021.1
         if not any([head, tail]):
-            otio_source_range = otio_clip.source_range
-            otio_avalable_range = otio_clip.available_range()
-            range_convert = openpype.lib.otio_range_to_frame_range
-            src_start, src_end = range_convert(otio_source_range)
-            av_start, av_end = range_convert(otio_avalable_range)
-            av_range = av_end - av_start
-            av_tail = av_range - src_end
+            retimed_attributes = oplib.get_media_range_with_retimes(
+                otio_clip, handle_start, handle_end)
+            self.log.debug(
+                ">> retimed_attributes: {}".format(retimed_attributes))
 
-            self.log.debug("__ src_start: `{}`".format(src_start))
-            self.log.debug("__ src_end: `{}`".format(src_end))
-            self.log.debug("__ av_range: `{}`".format(av_range))
-            self.log.debug("__ av_tail: `{}`".format(av_tail))
-
-            head = src_start
-            tail = av_tail
+            # retimed head and tail
+            head = int(retimed_attributes["handleStart"])
+            tail = int(retimed_attributes["handleEnd"])
 
         return head, tail
 
@@ -366,7 +364,7 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
                 continue
             if otio_clip.name not in segment.name.get_value():
                 continue
-            if openpype.lib.is_overlapping_otio_ranges(
+            if oplib.is_overlapping_otio_ranges(
                     parent_range, timeline_range, strict=True):
 
                 # add pypedata marker to otio_clip metadata

From 257c58988181a9dcd39bf85e143a08eb686115a7 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 16 May 2022 20:58:44 +0200
Subject: [PATCH 0260/1227] flame: change editorial function to lib

---
 openpype/plugins/publish/collect_otio_subset_resources.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/openpype/plugins/publish/collect_otio_subset_resources.py b/openpype/plugins/publish/collect_otio_subset_resources.py
index 7c11462ef0..53d327a51d 100644
--- a/openpype/plugins/publish/collect_otio_subset_resources.py
+++ b/openpype/plugins/publish/collect_otio_subset_resources.py
@@ -10,8 +10,7 @@ import os
 import clique
 import opentimelineio as otio
 import pyblish.api
-import openpype
-from openpype.lib import editorial
+import openpype.lib as oplib
 
 
 class CollectOtioSubsetResources(pyblish.api.InstancePlugin):
@@ -43,7 +42,7 @@ class CollectOtioSubsetResources(pyblish.api.InstancePlugin):
         available_duration = otio_avalable_range.duration.value
 
         # get available range trimmed with processed retimes
-        retimed_attributes = editorial.get_media_range_with_retimes(
+        retimed_attributes = oplib.get_media_range_with_retimes(
             otio_clip, handle_start, handle_end)
         self.log.debug(
             ">> retimed_attributes: {}".format(retimed_attributes))
@@ -145,7 +144,7 @@ class CollectOtioSubsetResources(pyblish.api.InstancePlugin):
                 # in case it is file sequence but not new OTIO schema
                 # `ImageSequenceReference`
                 path = media_ref.target_url
-                collection_data = openpype.lib.make_sequence_collection(
+                collection_data = oplib.make_sequence_collection(
                     path, trimmed_media_range_h, metadata)
                 self.staging_dir, collection = collection_data
 

From 056b92599ec28afb7de04d5c53021f716f056dfe Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 16 May 2022 21:09:00 +0200
Subject: [PATCH 0261/1227] global: fixing false editorial namespace

---
 openpype/plugins/publish/collect_otio_subset_resources.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/collect_otio_subset_resources.py b/openpype/plugins/publish/collect_otio_subset_resources.py
index 53d327a51d..78e2a6428c 100644
--- a/openpype/plugins/publish/collect_otio_subset_resources.py
+++ b/openpype/plugins/publish/collect_otio_subset_resources.py
@@ -64,7 +64,7 @@ class CollectOtioSubsetResources(pyblish.api.InstancePlugin):
         a_frame_end_h = media_out + handle_end
 
         # create trimmed otio time range
-        trimmed_media_range_h = editorial.range_from_frames(
+        trimmed_media_range_h = oplib.range_from_frames(
             a_frame_start_h, (a_frame_end_h - a_frame_start_h + 1),
             media_fps
         )

From d636a4144dd4cfff4517dd6b39f6d9524160ed0d Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 17 May 2022 12:35:06 +0300
Subject: [PATCH 0262/1227] Replace plugin name with more descriptive one.

---
 openpype/plugins/publish/extract_jpeg_exr.py                  | 2 +-
 openpype/settings/defaults/project_settings/global.json       | 2 +-
 .../projects_schema/schemas/schema_global_publish.json        | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index ae29f8b95b..84cdd186dc 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -15,7 +15,7 @@ from openpype.lib import (
 import shutil
 
 
-class ExtractJpegEXR(pyblish.api.InstancePlugin):
+class ExtractThumbnail(pyblish.api.InstancePlugin):
     """Create jpg thumbnail from sequence using ffmpeg"""
 
     label = "Extract Jpeg EXR"
diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index 7b223798f1..cedd0eed99 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -33,7 +33,7 @@
             "enabled": false,
             "profiles": []
         },
-        "ExtractJpegEXR": {
+        "ExtractThumbnail": {
             "enabled": true,
             "ffmpeg_args": {
                 "input": [
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
index 061874e31c..a3cbf0cfcd 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
@@ -126,8 +126,8 @@
             "type": "dict",
             "collapsible": true,
             "checkbox_key": "enabled",
-            "key": "ExtractJpegEXR",
-            "label": "ExtractJpegEXR",
+            "key": "ExtractThumbnail",
+            "label": "ExtractThumbnail",
             "is_group": true,
             "children": [
                 {

From 78c70819156fc0ad6896619abc8b4d2cc017e589 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 17 May 2022 12:38:04 +0300
Subject: [PATCH 0263/1227] Change label name.

---
 openpype/plugins/publish/extract_jpeg_exr.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 84cdd186dc..11dfca8eb2 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -18,7 +18,7 @@ import shutil
 class ExtractThumbnail(pyblish.api.InstancePlugin):
     """Create jpg thumbnail from sequence using ffmpeg"""
 
-    label = "Extract Jpeg EXR"
+    label = "Extract Thumbnail"
     order = pyblish.api.ExtractorOrder
     families = [
         "imagesequence", "render", "render2d",

From 5059c0cedff88d33f7c0044f0020fa03d1cdca48 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Cl=C3=A9ment=20Hector?= <clement.hector@gmail.com>
Date: Tue, 17 May 2022 11:43:28 +0200
Subject: [PATCH 0264/1227] Update
 openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Félix David <felixg.david@gmail.com>
---
 .../modules/kitsu/plugins/publish/integrate_kitsu_note.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index ae559e660e..78c5170856 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -29,14 +29,14 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             kitsu_status = gazu.task.get_task_status_by_short_name(
                 self.note_status_shortname
             )
-            if not kitsu_status:
+            if kitsu_status:
+                note_status = kitsu_status
+                self.log.info("Note Kitsu status: {}".format(note_status))
+            else:
                 self.log.info(
                     "Cannot find {} status. The status will not be "
                     "changed!".format(self.note_status_shortname)
                 )
-            else:
-                note_status = kitsu_status
-                self.log.info("Note Kitsu status: {}".format(note_status))
 
         # Add comment to kitsu task
         self.log.debug("Add new note in taks id {}".format(

From 667cff319d70ea699ded5d009872588f5d5ffee2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 17 May 2022 11:49:54 +0200
Subject: [PATCH 0265/1227] black

---
 .../kitsu/plugins/publish/integrate_kitsu_note.py   | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 78c5170856..3cd1f450ca 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -22,7 +22,7 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
 
         self.log.debug("Comment is `{}`".format(publish_comment))
 
-        # Get note status, by default uses the task status for the note 
+        # Get note status, by default uses the task status for the note
         # if it is not specified in the configuration
         note_status = context.data["kitsu_task"]["task_status_id"]
         if self.set_status_note:
@@ -39,12 +39,13 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                 )
 
         # Add comment to kitsu task
-        self.log.debug("Add new note in taks id {}".format(
-            context.data["kitsu_task"]['id']))
+        self.log.debug(
+            "Add new note in taks id {}".format(
+                context.data["kitsu_task"]["id"]
+            )
+        )
         kitsu_comment = gazu.task.add_comment(
-            context.data["kitsu_task"], 
-            note_status, 
-            comment=publish_comment
+            context.data["kitsu_task"], note_status, comment=publish_comment
         )
 
         context.data["kitsu_comment"] = kitsu_comment

From 6976546505590a59072095f675778c9e8a71fe03 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 17 May 2022 11:51:58 +0200
Subject: [PATCH 0266/1227] cleaning

---
 openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 3cd1f450ca..ea98e0b7cc 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -1,5 +1,4 @@
 # -*- coding: utf-8 -*-
-from distutils.log import debug
 import gazu
 import pyblish.api
 

From ea00dc0c6a41c21d7744b996c40a4eca84e1dcb8 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Tue, 17 May 2022 17:07:33 +0200
Subject: [PATCH 0267/1227] fix support for plugin location

---
 openpype/hosts/unreal/__init__.py                       | 3 ++-
 openpype/hosts/unreal/hooks/pre_workfile_preparation.py | 8 +++++++-
 openpype/hosts/unreal/lib.py                            | 6 +++---
 3 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/unreal/__init__.py b/openpype/hosts/unreal/__init__.py
index 533f315df3..bedf5a29f7 100644
--- a/openpype/hosts/unreal/__init__.py
+++ b/openpype/hosts/unreal/__init__.py
@@ -9,7 +9,8 @@ def add_implementation_envs(env, _app):
         os.path.dirname(os.path.abspath(openpype.hosts.__file__)),
         "unreal", "integration"
     )
-    env["OPENPYPE_UNREAL_PLUGIN"] = unreal_plugin_path
+    if not env.get("OPENPYPE_UNREAL_PLUGIN"):
+        env["OPENPYPE_UNREAL_PLUGIN"] = unreal_plugin_path
 
     # Set default environments if are not set via settings
     defaults = {
diff --git a/openpype/hosts/unreal/hooks/pre_workfile_preparation.py b/openpype/hosts/unreal/hooks/pre_workfile_preparation.py
index f07e96551c..fa0562a3a0 100644
--- a/openpype/hosts/unreal/hooks/pre_workfile_preparation.py
+++ b/openpype/hosts/unreal/hooks/pre_workfile_preparation.py
@@ -25,7 +25,7 @@ class UnrealPrelaunchHook(PreLaunchHook):
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
 
-        self.signature = "( {} )".format(self.__class__.__name__)
+        self.signature = f"( {self.__class__.__name__} )"
 
     def _get_work_filename(self):
         # Use last workfile if was found
@@ -99,6 +99,7 @@ class UnrealPrelaunchHook(PreLaunchHook):
                 f"character ({unreal_project_name}). Appending 'P'"
             ))
             unreal_project_name = f"P{unreal_project_name}"
+            unreal_project_filename = f'{unreal_project_name}.uproject'
 
         project_path = Path(os.path.join(workdir, unreal_project_name))
 
@@ -138,6 +139,11 @@ class UnrealPrelaunchHook(PreLaunchHook):
             ))
             # Set "OPENPYPE_UNREAL_PLUGIN" to current process environment for
             # execution of `create_unreal_project`
+            if self.launch_context.env.get("OPENPYPE_UNREAL_PLUGIN"):
+                self.log.info((
+                    f"{self.signature} using OpenPype plugin from "
+                    f"{self.launch_context.env.get('OPENPYPE_UNREAL_PLUGIN')}"
+                ))
             env_key = "OPENPYPE_UNREAL_PLUGIN"
             if self.launch_context.env.get(env_key):
                 os.environ[env_key] = self.launch_context.env[env_key]
diff --git a/openpype/hosts/unreal/lib.py b/openpype/hosts/unreal/lib.py
index 906002b38f..fdf3acb37b 100644
--- a/openpype/hosts/unreal/lib.py
+++ b/openpype/hosts/unreal/lib.py
@@ -280,7 +280,7 @@ def create_unreal_project(project_name: str,
     python_path = None
     if platform.system().lower() == "windows":
         python_path = engine_path / ("Engine/Binaries/ThirdParty/"
-                                     "Python3/Win64/pythonw.exe")
+                                     "Python3/Win64/python.exe")
 
     if platform.system().lower() == "linux":
         python_path = engine_path / ("Engine/Binaries/ThirdParty/"
@@ -294,8 +294,8 @@ def create_unreal_project(project_name: str,
         raise NotImplementedError("Unsupported platform")
     if not python_path.exists():
         raise RuntimeError(f"Unreal Python not found at {python_path}")
-    subprocess.run(
-        [python_path.as_posix(), "-m", "pip", "install", "pyside2"])
+    out = subprocess.check_call(
+        [python_path.as_posix(), "-m", "pip", "install", "--user", "pyside2"])
 
     if dev_mode or preset["dev_mode"]:
         _prepare_cpp_project(project_file, engine_path)

From 55cdecd95137a197664c9ed6307d746d2d7e95b6 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 17 May 2022 17:24:00 +0200
Subject: [PATCH 0268/1227] Implement support for Redshift Proxy export in
 Houdini

Tested with Houdini 19.0.589 + Redshift 3.5.01
---
 openpype/hosts/houdini/api/lib.py             |  2 +
 .../plugins/create/create_redshift_proxy.py   | 49 +++++++++++++++++++
 .../houdini/plugins/publish/collect_frames.py |  2 +-
 .../plugins/publish/collect_output_node.py    |  3 ++
 .../plugins/publish/extract_redshift_proxy.py | 48 ++++++++++++++++++
 5 files changed, 103 insertions(+), 1 deletion(-)
 create mode 100644 openpype/hosts/houdini/plugins/create/create_redshift_proxy.py
 create mode 100644 openpype/hosts/houdini/plugins/publish/extract_redshift_proxy.py

diff --git a/openpype/hosts/houdini/api/lib.py b/openpype/hosts/houdini/api/lib.py
index 603519069a..96ca019f8f 100644
--- a/openpype/hosts/houdini/api/lib.py
+++ b/openpype/hosts/houdini/api/lib.py
@@ -130,6 +130,8 @@ def get_output_parameter(node):
     elif node_type == "arnold":
         if node.evalParm("ar_ass_export_enable"):
             return node.parm("ar_ass_file")
+    elif node_type == "Redshift_Proxy_Output":
+        return node.parm("RS_archive_file")
 
     raise TypeError("Node type '%s' not supported" % node_type)
 
diff --git a/openpype/hosts/houdini/plugins/create/create_redshift_proxy.py b/openpype/hosts/houdini/plugins/create/create_redshift_proxy.py
new file mode 100644
index 0000000000..52c81240fa
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/create/create_redshift_proxy.py
@@ -0,0 +1,49 @@
+import hou
+from openpype.hosts.houdini.api import plugin
+
+
+class CreateRedshiftProxy(plugin.Creator):
+    """Redshift Proxy"""
+
+    label = "Redshift Proxy"
+    family = "redshiftproxy"
+    icon = "magic"
+
+    def __init__(self, *args, **kwargs):
+        super(CreateRedshiftProxy, self).__init__(*args, **kwargs)
+
+        # Remove the active, we are checking the bypass flag of the nodes
+        self.data.pop("active", None)
+
+        # Redshift provides a `Redshift_Proxy_Output` node type which shows
+        # a limited set of parameters by default and is set to extract a
+        # Redshift Proxy. However when "imprinting" extra parameters needed
+        # for OpenPype it starts showing all its parameters again. It's unclear
+        # why this happens.
+        # TODO: Somehow enforce so that it only shows the original limited
+        #       attributes of the Redshift_Proxy_Output node type
+        self.data.update({"node_type": "Redshift_Proxy_Output"})
+
+    def _process(self, instance):
+        """Creator main entry point.
+
+        Args:
+            instance (hou.Node): Created Houdini instance.
+
+        """
+        parms = {
+            "RS_archive_file": '$HIP/pyblish/`chs("subset")`.$F4.rs',
+        }
+
+        if self.nodes:
+            node = self.nodes[0]
+            path = node.path()
+            parms["RS_archive_sopPath"] = path
+
+        instance.setParms(parms)
+
+        # Lock some Avalon attributes
+        to_lock = ["family", "id"]
+        for name in to_lock:
+            parm = instance.parm(name)
+            parm.lock(True)
diff --git a/openpype/hosts/houdini/plugins/publish/collect_frames.py b/openpype/hosts/houdini/plugins/publish/collect_frames.py
index fac40b4d2b..9bd43d8a09 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_frames.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_frames.py
@@ -20,7 +20,7 @@ class CollectFrames(pyblish.api.InstancePlugin):
 
     order = pyblish.api.CollectorOrder
     label = "Collect Frames"
-    families = ["vdbcache", "imagesequence", "ass"]
+    families = ["vdbcache", "imagesequence", "ass", "redshiftproxy"]
 
     def process(self, instance):
 
diff --git a/openpype/hosts/houdini/plugins/publish/collect_output_node.py b/openpype/hosts/houdini/plugins/publish/collect_output_node.py
index 938ee81cc3..0130c0a8da 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_output_node.py
@@ -12,6 +12,7 @@ class CollectOutputSOPPath(pyblish.api.InstancePlugin):
         "imagesequence",
         "usd",
         "usdrender",
+        "redshiftproxy"
     ]
 
     hosts = ["houdini"]
@@ -54,6 +55,8 @@ class CollectOutputSOPPath(pyblish.api.InstancePlugin):
             else:
                 out_node = node.parm("loppath").evalAsNode()
 
+        elif node_type == "Redshift_Proxy_Output":
+            out_node = node.parm("RS_archive_sopPath").evalAsNode()
         else:
             raise ValueError(
                 "ROP node type '%s' is" " not supported." % node_type
diff --git a/openpype/hosts/houdini/plugins/publish/extract_redshift_proxy.py b/openpype/hosts/houdini/plugins/publish/extract_redshift_proxy.py
new file mode 100644
index 0000000000..eb7e0d5677
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/publish/extract_redshift_proxy.py
@@ -0,0 +1,48 @@
+import os
+
+import pyblish.api
+import openpype.api
+from openpype.hosts.houdini.api.lib import render_rop
+
+
+class ExtractRedshiftProxy(openpype.api.Extractor):
+
+    order = pyblish.api.ExtractorOrder + 0.1
+    label = "Extract Redshift Proxy"
+    families = ["redshiftproxy"]
+    hosts = ["houdini"]
+
+    def process(self, instance):
+
+        ropnode = instance[0]
+
+        # Get the filename from the filename parameter
+        # `.evalParm(parameter)` will make sure all tokens are resolved
+        output = ropnode.evalParm("RS_archive_file")
+        staging_dir = os.path.normpath(os.path.dirname(output))
+        instance.data["stagingDir"] = staging_dir
+        file_name = os.path.basename(output)
+
+        self.log.info("Writing Redshift Proxy '%s' to '%s'" % (file_name,
+                                                               staging_dir))
+
+        render_rop(ropnode)
+
+        output = instance.data["frames"]
+
+        if "representations" not in instance.data:
+            instance.data["representations"] = []
+
+        representation = {
+            "name": "rs",
+            "ext": "rs",
+            "files": output,
+            "stagingDir": staging_dir,
+        }
+
+        # A single frame may also be rendered without start/end frame.
+        if "frameStart" in instance.data and "frameEnd" in instance.data:
+            representation["frameStart"] = instance.data["frameStart"]
+            representation["frameEnd"] = instance.data["frameEnd"]
+
+        instance.data["representations"].append(representation)
\ No newline at end of file

From be1453b4e7971ad3f20f87de0167865b38746340 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 17 May 2022 17:27:40 +0200
Subject: [PATCH 0269/1227] Fix new line

---
 .../hosts/houdini/plugins/publish/extract_redshift_proxy.py     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/houdini/plugins/publish/extract_redshift_proxy.py b/openpype/hosts/houdini/plugins/publish/extract_redshift_proxy.py
index eb7e0d5677..c754d60c59 100644
--- a/openpype/hosts/houdini/plugins/publish/extract_redshift_proxy.py
+++ b/openpype/hosts/houdini/plugins/publish/extract_redshift_proxy.py
@@ -45,4 +45,4 @@ class ExtractRedshiftProxy(openpype.api.Extractor):
             representation["frameStart"] = instance.data["frameStart"]
             representation["frameEnd"] = instance.data["frameEnd"]
 
-        instance.data["representations"].append(representation)
\ No newline at end of file
+        instance.data["representations"].append(representation)

From 0f84e7d92a661f99e347bedb110928f014b37eec Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 17 May 2022 17:28:40 +0200
Subject: [PATCH 0270/1227] Remove unused import

---
 openpype/hosts/houdini/plugins/create/create_redshift_proxy.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_redshift_proxy.py b/openpype/hosts/houdini/plugins/create/create_redshift_proxy.py
index 52c81240fa..da4d80bf2b 100644
--- a/openpype/hosts/houdini/plugins/create/create_redshift_proxy.py
+++ b/openpype/hosts/houdini/plugins/create/create_redshift_proxy.py
@@ -1,4 +1,3 @@
-import hou
 from openpype.hosts.houdini.api import plugin
 
 

From 606ef6415d229e7ee29f2776749fc33b288e0dd8 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 17 May 2022 17:42:55 +0200
Subject: [PATCH 0271/1227] Fix popping of `handles`

---
 openpype/hosts/maya/plugins/create/create_yeti_cache.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/create/create_yeti_cache.py b/openpype/hosts/maya/plugins/create/create_yeti_cache.py
index 86e13b95b2..e8c3203f21 100644
--- a/openpype/hosts/maya/plugins/create/create_yeti_cache.py
+++ b/openpype/hosts/maya/plugins/create/create_yeti_cache.py
@@ -22,7 +22,8 @@ class CreateYetiCache(plugin.Creator):
         # Add animation data without step and handles
         anim_data = lib.collect_animation_data()
         anim_data.pop("step")
-        anim_data.pop("handles")
+        anim_data.pop("handleStart")
+        anim_data.pop("handleEnd")
         self.data.update(anim_data)
 
         # Add samples

From e4d54aaa7a8304b426b67b707565451ce5e5599d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 17 May 2022 17:44:27 +0200
Subject: [PATCH 0272/1227] Fix invalid refactored usage

---
 openpype/hosts/maya/plugins/publish/extract_yeti_rig.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py b/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py
index d12567a55a..6b5054a198 100644
--- a/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py
+++ b/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py
@@ -167,7 +167,7 @@ class ExtractYetiRig(openpype.api.Extractor):
         resources = instance.data.get("resources", {})
         with disconnect_plugs(settings, members):
             with yetigraph_attribute_values(resources_dir, resources):
-                with maya.attribute_values(attr_value):
+                with lib.attribute_values(attr_value):
                     cmds.select(nodes, noExpand=True)
                     cmds.file(maya_path,
                               force=True,

From 0f97c9f3d388a8973dce13e68fb9d263c0441b48 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 17 May 2022 17:50:41 +0200
Subject: [PATCH 0273/1227] Time values are required for exporting without
 errors

---
 openpype/hosts/maya/plugins/publish/extract_yeti_cache.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_yeti_cache.py b/openpype/hosts/maya/plugins/publish/extract_yeti_cache.py
index 0d85708789..b0a60b77f4 100644
--- a/openpype/hosts/maya/plugins/publish/extract_yeti_cache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_yeti_cache.py
@@ -29,9 +29,9 @@ class ExtractYetiCache(openpype.api.Extractor):
         data_file = os.path.join(dirname, "yeti.fursettings")
 
         # Collect information for writing cache
-        start_frame = instance.data.get("frameStartHandle")
-        end_frame = instance.data.get("frameEndHandle")
-        preroll = instance.data.get("preroll")
+        start_frame = instance.data["frameStartHandle"]
+        end_frame = instance.data["frameEndHandle"]
+        preroll = instance.data["preroll"]
         if preroll > 0:
             start_frame -= preroll
 

From 6fb9bb1558401273e2437e3e50a18877c296851e Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 17 May 2022 17:54:41 +0200
Subject: [PATCH 0274/1227] Allow empty input_SET

---
 openpype/hosts/maya/plugins/publish/extract_yeti_rig.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py b/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py
index 6b5054a198..f981c4fe50 100644
--- a/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py
+++ b/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py
@@ -157,7 +157,7 @@ class ExtractYetiRig(openpype.api.Extractor):
         input_set = next(i for i in instance if i == "input_SET")
 
         # Get all items
-        set_members = cmds.sets(input_set, query=True)
+        set_members = cmds.sets(input_set, query=True) or []
         set_members += cmds.listRelatives(set_members,
                                           allDescendents=True,
                                           fullPath=True) or []

From 2a2dbd243408f4eed8863fd86967a39080b4931d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 17 May 2022 17:56:45 +0200
Subject: [PATCH 0275/1227] Force required frame values for a single frame
 cache extract for `yetiRig` family.

---
 .../hosts/maya/plugins/publish/collect_yeti_rig.py    | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_yeti_rig.py b/openpype/hosts/maya/plugins/publish/collect_yeti_rig.py
index 029432223b..bc15edd9e0 100644
--- a/openpype/hosts/maya/plugins/publish/collect_yeti_rig.py
+++ b/openpype/hosts/maya/plugins/publish/collect_yeti_rig.py
@@ -43,11 +43,12 @@ class CollectYetiRig(pyblish.api.InstancePlugin):
 
         instance.data["resources"] = yeti_resources
 
-        # Force frame range for export
-        instance.data["frameStart"] = cmds.playbackOptions(
-                                        query=True, animationStartTime=True)
-        instance.data["frameEnd"] = cmds.playbackOptions(
-                                        query=True, animationStartTime=True)
+        # Force frame range for yeti cache export for the rig
+        start = cmds.playbackOptions(query=True, animationStartTime=True)
+        for key in ["frameStart", "frameEnd",
+                    "frameStartHandle", "frameEndHandle"]:
+            instance.data[key] = start
+        instance.data["preroll"] = 0
 
     def collect_input_connections(self, instance):
         """Collect the inputs for all nodes in the input_SET"""

From 8e1cc8cef675b909223db7c5d5d39d5aac7deb13 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Wed, 18 May 2022 16:58:59 +0900
Subject: [PATCH 0276/1227] Added mvLook publish.

This extracts the look information from the UsdCompoundShape - it generates
"OP look" compatible data structures and lets the rest of the OP publish
as normal. It also generates a .usda file with the overrides containing
material assignments as needed.
---
 .../plugins/create/create_multiverse_look.py  |  14 +
 .../publish/collect_multiverse_look.py        | 323 ++++++++++++++++++
 .../maya/plugins/publish/extract_look.py      |   2 +-
 .../publish/extract_multiverse_look.py        | 134 ++++++++
 .../plugins/publish/collect_resources_path.py |   1 +
 openpype/plugins/publish/integrate_new.py     |   1 +
 6 files changed, 474 insertions(+), 1 deletion(-)
 create mode 100644 openpype/hosts/maya/plugins/create/create_multiverse_look.py
 create mode 100644 openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
 create mode 100644 openpype/hosts/maya/plugins/publish/extract_multiverse_look.py

diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_look.py b/openpype/hosts/maya/plugins/create/create_multiverse_look.py
new file mode 100644
index 0000000000..b2b9b5bb29
--- /dev/null
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_look.py
@@ -0,0 +1,14 @@
+from openpype.hosts.maya.api import plugin, lib
+
+
+class CreateMultiverseLook(plugin.Creator):
+    """Create Multiverse Look"""
+
+    name = "mvLook"
+    label = "Multiverse Look"
+    family = "mvLook"
+    icon = "cubes"
+
+    def __init__(self, *args, **kwargs):
+        super(CreateMultiverseLook, self).__init__(*args, **kwargs)
+        self.data["fileFormat"] = ["usda", "usd"]
diff --git a/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
new file mode 100644
index 0000000000..9c1569e216
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
@@ -0,0 +1,323 @@
+import glob
+import os
+import re
+
+from maya import cmds
+import pyblish.api
+from openpype.hosts.maya.api import lib
+
+def get_look_attrs(node):
+    """Returns attributes of a node that are important for the look.
+
+    These are the "changed" attributes (those that have edits applied
+    in the current scene).
+
+    Returns:
+        list: Attribute names to extract
+
+    """
+    # When referenced get only attributes that are "changed since file open"
+    # which includes any reference edits, otherwise take *all* user defined
+    # attributes
+    is_referenced = cmds.referenceQuery(node, isNodeReferenced=True)
+    result = cmds.listAttr(node, userDefined=True,
+                           changedSinceFileOpen=is_referenced) or []
+
+    # `cbId` is added when a scene is saved, ignore by default
+    if "cbId" in result:
+        result.remove("cbId")
+
+    # For shapes allow render stat changes
+    if cmds.objectType(node, isAType="shape"):
+        attrs = cmds.listAttr(node, changedSinceFileOpen=True) or []
+        for attr in attrs:
+            if attr in SHAPE_ATTRS:
+                result.append(attr)
+            elif attr.startswith('ai'):
+                result.append(attr)
+
+    return result
+
+
+def node_uses_image_sequence(node):
+    """Return whether file node uses an image sequence or single image.
+
+    Determine if a node uses an image sequence or just a single image,
+    not always obvious from its file path alone.
+
+    Args:
+        node (str): Name of the Maya node
+
+    Returns:
+        bool: True if node uses an image sequence
+
+    """
+
+    # useFrameExtension indicates an explicit image sequence
+    node_path = get_file_node_path(node).lower()
+
+    # The following tokens imply a sequence
+    patterns = ["<udim>", "<tile>", "<uvtile>", "u<u>_v<v>", "<frame0"]
+
+    return (cmds.getAttr('%s.useFrameExtension' % node) or
+            any(pattern in node_path for pattern in patterns))
+
+
+def seq_to_glob(path):
+    """Takes an image sequence path and returns it in glob format,
+    with the frame number replaced by a '*'.
+
+    Image sequences may be numerical sequences, e.g. /path/to/file.1001.exr
+    will return as /path/to/file.*.exr.
+
+    Image sequences may also use tokens to denote sequences, e.g.
+    /path/to/texture.<UDIM>.tif will return as /path/to/texture.*.tif.
+
+    Args:
+        path (str): the image sequence path
+
+    Returns:
+        str: Return glob string that matches the filename pattern.
+
+    """
+
+    if path is None:
+        return path
+
+    # If any of the patterns, convert the pattern
+    patterns = {
+        "<udim>": "<udim>",
+        "<tile>": "<tile>",
+        "<uvtile>": "<uvtile>",
+        "#": "#",
+        "u<u>_v<v>": "<u>|<v>",
+        "<frame0": "<frame0\d+>",
+        "<f>": "<f>"
+    }
+
+    lower = path.lower()
+    has_pattern = False
+    for pattern, regex_pattern in patterns.items():
+        if pattern in lower:
+            path = re.sub(regex_pattern, "*", path, flags=re.IGNORECASE)
+            has_pattern = True
+
+    if has_pattern:
+        return path
+
+    base = os.path.basename(path)
+    matches = list(re.finditer(r'\d+', base))
+    if matches:
+        match = matches[-1]
+        new_base = '{0}*{1}'.format(base[:match.start()],
+                                    base[match.end():])
+        head = os.path.dirname(path)
+        return os.path.join(head, new_base)
+    else:
+        return path
+
+
+def get_file_node_path(node):
+    """Get the file path used by a Maya file node.
+
+    Args:
+        node (str): Name of the Maya file node
+
+    Returns:
+        str: the file path in use
+
+    """
+    # if the path appears to be sequence, use computedFileTextureNamePattern,
+    # this preserves the <> tag
+    if cmds.attributeQuery('computedFileTextureNamePattern',
+                           node=node,
+                           exists=True):
+        plug = '{0}.computedFileTextureNamePattern'.format(node)
+        texture_pattern = cmds.getAttr(plug)
+
+        patterns = ["<udim>",
+                    "<tile>",
+                    "u<u>_v<v>",
+                    "<f>",
+                    "<frame0",
+                    "<uvtile>"]
+        lower = texture_pattern.lower()
+        if any(pattern in lower for pattern in patterns):
+            return texture_pattern
+
+    if cmds.nodeType(node) == 'aiImage':
+        return cmds.getAttr('{0}.filename'.format(node))
+    if cmds.nodeType(node) == 'RedshiftNormalMap':
+        return cmds.getAttr('{}.tex0'.format(node))
+
+    # otherwise use fileTextureName
+    return cmds.getAttr('{0}.fileTextureName'.format(node))
+
+
+def get_file_node_files(node):
+    """Return the file paths related to the file node
+
+    Note:
+        Will only return existing files. Returns an empty list
+        if not valid existing files are linked.
+
+    Returns:
+        list: List of full file paths.
+
+    """
+
+    path = get_file_node_path(node)
+    path = cmds.workspace(expandName=path)
+    if node_uses_image_sequence(node):
+        glob_pattern = seq_to_glob(path)
+        return glob.glob(glob_pattern)
+    elif os.path.exists(path):
+        return [path]
+    else:
+        return []
+
+
+class CollectMultiverseLookData(pyblish.api.InstancePlugin):
+    """Collect Multiverse Look
+
+    """
+
+    order = pyblish.api.CollectorOrder + 0.2
+    label = 'Collect Multiverse Look'
+    families = ["mvLook"]
+
+    def process(self, instance):
+        # Load plugin first
+        cmds.loadPlugin("MultiverseForMaya", quiet=True)
+        import multiverse
+
+        self.log.info("Processing mvLook for '{}' / '{}'".format(
+            instance, instance.data['name']))
+
+        nodes = set()
+        for node in instance:
+            # We want only mvUsdCompoundShape nodes.
+            nodes_of_interest = cmds.ls(node,
+                              dag=True,
+                              shapes=False,
+                              type="mvUsdCompoundShape",
+                              noIntermediate=True,
+                              long=True)
+            nodes.update(nodes_of_interest)
+    
+        files = []
+        sets = {}
+        instance.data["resources"] = []
+
+        for node in nodes:
+            self.log.info("Getting resources for '{}'".format(node))
+
+            # We know what nodes 
+            overrides = multiverse.ListMaterialOverridePrims(node)
+            for override in overrides:
+                matOver = multiverse.GetMaterialOverride(node, override)
+
+                if isinstance(matOver, multiverse.MaterialSourceShadingGroup):
+                    shadingGroup = matOver.shadingGroupName
+                    self.log.debug("ShadingGroup = '{}'".format(shadingGroup))
+                    sets[shadingGroup] = {"uuid": lib.get_id(shadingGroup), "members": list()}
+
+                    history = cmds.listHistory(shadingGroup)
+                    files = cmds.ls(history, type="file", long=True)
+
+                    for f in files:
+                        resources = self.collect_resource(f)
+                        instance.data["resources"].append(resources)
+
+                elif  isinstance(matOver, multiverse.MaterialSourceUsdPath):
+                    # TODO: Handle this later.
+                    pass
+                else:
+                    # TODO: What to do here?
+                    pass
+
+        # Store data on the instance
+        instance.data["lookData"] = {
+            "attributes": [],
+            "relationships": sets
+        }
+
+        self.log.info("-------------------------")
+        self.log.info("Instance: {},{}".format(type(instance),instance))
+        self.log.info("Instance.data: {},{}".format(type(instance.data),instance.data))
+        for k in instance.data.keys():
+            v = instance.data[k]
+            self.log.info(" data: {},{}".format(k,v))
+        self.log.info("-------------------------")
+
+
+    def collect_resource(self, node):
+        """Collect the link to the file(s) used (resource)
+        Args:
+            node (str): name of the node
+
+        Returns:
+            dict
+        """
+
+        self.log.debug("processing: {}".format(node))
+        if cmds.nodeType(node) not in ["file", "aiImage", "RedshiftNormalMap"]:
+            self.log.error(
+                "Unsupported file node: {}".format(cmds.nodeType(node)))
+            raise AssertionError("Unsupported file node")
+
+        if cmds.nodeType(node) == 'file':
+            self.log.debug("  - file node")
+            attribute = "{}.fileTextureName".format(node)
+            computed_attribute = "{}.computedFileTextureNamePattern".format(node)
+        elif cmds.nodeType(node) == 'aiImage':
+            self.log.debug("aiImage node")
+            attribute = "{}.filename".format(node)
+            computed_attribute = attribute
+        elif cmds.nodeType(node) == 'RedshiftNormalMap':
+            self.log.debug("RedshiftNormalMap node")
+            attribute = "{}.tex0".format(node)
+            computed_attribute = attribute
+
+        source = cmds.getAttr(attribute)
+        self.log.info("  - file source: {}".format(source))
+        color_space_attr = "{}.colorSpace".format(node)
+        try:
+            color_space = cmds.getAttr(color_space_attr)
+        except ValueError:
+            # node doesn't have colorspace attribute
+            color_space = "Raw"
+        # Compare with the computed file path, e.g. the one with the <UDIM>
+        # pattern in it, to generate some logging information about this
+        # difference
+        # computed_attribute = "{}.computedFileTextureNamePattern".format(node)
+        computed_source = cmds.getAttr(computed_attribute)
+        if source != computed_source:
+            self.log.debug("Detected computed file pattern difference "
+                           "from original pattern: {0} "
+                           "({1} -> {2})".format(node,
+                                                 source,
+                                                 computed_source))
+
+        # We replace backslashes with forward slashes because V-Ray
+        # can't handle the UDIM files with the backslashes in the
+        # paths as the computed patterns
+        source = source.replace("\\", "/")
+
+        files = get_file_node_files(node)
+        if len(files) == 0:
+            self.log.error("No valid files found from node `%s`" % node)
+
+        self.log.info("collection of resource done:")
+        self.log.info("  - node: {}".format(node))
+        self.log.info("  - attribute: {}".format(attribute))
+        self.log.info("  - source: {}".format(source))
+        self.log.info("  - file: {}".format(files))
+        self.log.info("  - color space: {}".format(color_space))
+
+        # Define the resource
+        return {"node": node,
+                "attribute": attribute,
+                "source": source,  # required for resources
+                "files": files,
+                "color_space": color_space}  # required for resources
\ No newline at end of file
diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py
index 881705b92c..c427eacd98 100644
--- a/openpype/hosts/maya/plugins/publish/extract_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_look.py
@@ -146,7 +146,7 @@ class ExtractLook(openpype.api.Extractor):
 
     label = "Extract Look (Maya Scene + JSON)"
     hosts = ["maya"]
-    families = ["look"]
+    families = ["look","mvLook"]
     order = pyblish.api.ExtractorOrder + 0.2
     scene_type = "ma"
     look_data_type = "json"
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py
new file mode 100644
index 0000000000..34c72f0915
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py
@@ -0,0 +1,134 @@
+import os
+import six
+
+from maya import cmds
+
+import openpype.api
+from openpype.hosts.maya.api.lib import maintained_selection
+
+
+class ExtractMultiverseLook(openpype.api.Extractor):
+    """Extractor for Multiverse USD look data into a Maya Scene."""
+
+    label = "Extract Multiverse USD Look"
+    hosts = ["maya"]
+    families = ["mvLook"]
+    scene_type = "usda"
+    file_formats = ["usda", "usd"]
+
+    @property
+    def options(self):
+        """Overridable options for Multiverse USD Export
+
+        Given in the following format
+            - {NAME: EXPECTED TYPE}
+
+        If the overridden option's type does not match,
+        the option is not included and a warning is logged.
+
+        """
+
+        return {
+            "writeAll": bool,
+            "writeTransforms": bool,
+            "writeVisibility": bool,
+            "writeAttributes": bool,
+            "writeMaterials": bool,
+            "writeVariants": bool,
+            "writeVariantsDefinition": bool,
+            "writeActiveState": bool,
+            "writeNamespaces": bool,
+            "numTimeSamples": int,
+            "timeSamplesSpan": float
+        }
+
+    @property
+    def default_options(self):
+        """The default options for Multiverse USD extraction."""
+
+        return {
+            "writeAll": False,
+            "writeTransforms": False,
+            "writeVisibility": False,
+            "writeAttributes": False,
+            "writeMaterials": True,
+            "writeVariants": False,
+            "writeVariantsDefinition": False,
+            "writeActiveState": False,
+            "writeNamespaces": False,
+            "numTimeSamples": 1,
+            "timeSamplesSpan": 0.0
+        }
+
+    def get_file_format(self, instance):
+        fileFormat = instance.data["fileFormat"]
+        if fileFormat in range(len(self.file_formats)):
+            self.scene_type = self.file_formats[fileFormat]
+
+    def process(self, instance):
+        # Load plugin first
+        cmds.loadPlugin("MultiverseForMaya", quiet=True)
+
+        # Define output file path
+        staging_dir = self.staging_dir(instance)
+        self.get_file_format(instance)
+        file_name = "{0}.{1}".format(instance.name, self.scene_type)
+        file_path = os.path.join(staging_dir, file_name)
+        file_path = file_path.replace('\\', '/')
+
+        # Parse export options
+        options = self.default_options
+        self.log.info("Export options: {0}".format(options))
+
+        # Perform extraction
+        self.log.info("Performing extraction ...")
+
+        with maintained_selection():
+            members = instance.data("setMembers")
+            members = cmds.ls(members,
+                              dag=True,
+                              shapes=False,
+                              type="mvUsdCompoundShape",
+                              noIntermediate=True,
+                              long=True)
+            self.log.info('Collected object {}'.format(members))
+            if len(members) > 1:
+                self.log.error('More than one member: {}'.format(members))
+
+            import multiverse
+
+            over_write_opts = multiverse.OverridesWriteOptions()
+            options_discard_keys = {
+                "numTimeSamples",
+                "timeSamplesSpan",
+                "frameStart",
+                "frameEnd",
+                "handleStart",
+                "handleEnd",
+                "step",
+                "fps"
+            }
+            for key, value in options.items():
+                if key in options_discard_keys:
+                    continue
+                setattr(over_write_opts, key, value)
+
+            for member in members:
+                # @TODO: Make sure there is only one here.
+
+                self.log.debug("Writing Override for '{}'".format(member))
+                multiverse.WriteOverrides(file_path, member, over_write_opts)
+
+        if "representations" not in instance.data:
+            instance.data["representations"] = []
+
+        representation = {
+            'name': self.scene_type,
+            'ext': self.scene_type,
+            'files': file_name,
+            'stagingDir': staging_dir
+        }
+        instance.data["representations"].append(representation)
+
+        self.log.info("Extracted instance {} to {}".format(
+            instance.name, file_path))
diff --git a/openpype/plugins/publish/collect_resources_path.py b/openpype/plugins/publish/collect_resources_path.py
index 89df031fb0..8bdf70b529 100644
--- a/openpype/plugins/publish/collect_resources_path.py
+++ b/openpype/plugins/publish/collect_resources_path.py
@@ -41,6 +41,7 @@ class CollectResourcesPath(pyblish.api.InstancePlugin):
                 "rig",
                 "plate",
                 "look",
+                "mvLook",
                 "yetiRig",
                 "yeticache",
                 "nukenodes",
diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index bf13a4050e..4712c2e6bb 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -106,6 +106,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "effect",
                 "xgen",
                 "hda",
+                "mvLook",
                 "usd",
                 "staticMesh",
                 "skeletalMesh",

From b62627bf558e09f7e8e2b127a82486517a608488 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Wed, 18 May 2022 17:08:17 +0900
Subject: [PATCH 0277/1227] Change the default of composition/override to usda.

---
 .../hosts/maya/plugins/create/create_multiverse_usd_comp.py    | 3 ++-
 .../hosts/maya/plugins/create/create_multiverse_usd_over.py    | 3 ++-
 .../hosts/maya/plugins/publish/extract_multiverse_usd_comp.py  | 3 ++-
 .../hosts/maya/plugins/publish/extract_multiverse_usd_over.py  | 3 ++-
 4 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
index accdffad46..0a8219938b 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
@@ -15,7 +15,8 @@ class CreateMultiverseUsdComp(plugin.Creator):
         # Add animation data first, since it maintains order.
         self.data.update(lib.collect_animation_data(True))
 
-        self.data["fileFormat"] = ["usd", "usda"]
+        # Order of `fileFormat` must match extract_multiverse_usd_comp.py
+        self.data["fileFormat"] = ["usda", "usd"]
         self.data["stripNamespaces"] = False
         self.data["mergeTransformAndShape"] = False
         self.data["flattenContent"] = False
diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
index 25892f68bb..9477cd7fed 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
@@ -15,7 +15,8 @@ class CreateMultiverseUsdOver(plugin.Creator):
         # Add animation data first, since it maintains order.
         self.data.update(lib.collect_animation_data(True))
 
-        self.data["fileFormat"] = ["usd", "usda"]
+        # Order of `fileFormat` must match extract_multiverse_usd_over.py
+        self.data["fileFormat"] = ["usda", "usd"]
         self.data["writeAll"] = False
         self.data["writeTransforms"] = True
         self.data["writeVisibility"] = True
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
index c686b2a600..695ea9a33f 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
@@ -13,7 +13,8 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
     hosts = ["maya"]
     families = ["usdComposition"]
     scene_type = "usd"
-    file_formats = ["usd", "usda"]
+    # Order of `fileFormat` must match create_multiverse_usd_comp.py
+    file_formats = ["usda", "usd"]
 
     @property
     def options(self):
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
index be0a7be52f..3b101ab6cf 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
@@ -13,7 +13,8 @@ class ExtractMultiverseUsdOverride(openpype.api.Extractor):
     hosts = ["maya"]
     families = ["usdOverride"]
     scene_type = "usd"
-    file_formats = ["usd", "usda"]
+    # Order of `fileFormat` must match create_multiverse_usd_over.py
+    file_formats = ["usda", "usd"]
 
     @property
     def options(self):

From 229852dfb52187ee22282427fd0282b81a65edba Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Wed, 18 May 2022 18:27:21 +0900
Subject: [PATCH 0278/1227] Adding new asset/composition options to the
 creators.

---
 openpype/hosts/maya/plugins/create/create_multiverse_usd.py     | 1 +
 .../hosts/maya/plugins/create/create_multiverse_usd_comp.py     | 1 +
 openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py   | 2 ++
 .../hosts/maya/plugins/publish/extract_multiverse_usd_comp.py   | 2 ++
 4 files changed, 6 insertions(+)

diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
index 1d53328760..a82a73cbdb 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
@@ -46,6 +46,7 @@ class CreateMultiverseUsd(plugin.Creator):
         self.data["writeShadingNetworks"] = False
         self.data["writeTransformMatrix"] = True
         self.data["writeUsdAttributes"] = False
+        self.data["writeInstancesAsReferences"] = False
         self.data["timeVaryingTopology"] = False
         self.data["customMaterialNamespace"] = ''
         self.data["numTimeSamples"] = 1
diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
index 0a8219938b..9d00ad1cfa 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
@@ -20,6 +20,7 @@ class CreateMultiverseUsdComp(plugin.Creator):
         self.data["stripNamespaces"] = False
         self.data["mergeTransformAndShape"] = False
         self.data["flattenContent"] = False
+        self.data["writeAsCompoundLayers"] = False
         self.data["writePendingOverrides"] = False
         self.data["numTimeSamples"] = 1
         self.data["timeSamplesSpan"] = 0.0
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
index 1748dd00dc..4bc0322fa8 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
@@ -59,6 +59,7 @@ class ExtractMultiverseUsd(openpype.api.Extractor):
             "writeShadingNetworks": bool,
             "writeTransformMatrix": bool,
             "writeUsdAttributes": bool,
+            "writeInstancesAsReferences": bool,
             "timeVaryingTopology": bool,
             "customMaterialNamespace": str,
             "numTimeSamples": int,
@@ -100,6 +101,7 @@ class ExtractMultiverseUsd(openpype.api.Extractor):
             "writeShadingNetworks": False,
             "writeTransformMatrix": True,
             "writeUsdAttributes": False,
+            "writeInstancesAsReferences": False,
             "timeVaryingTopology": False,
             "customMaterialNamespace": str(),
             "numTimeSamples": 1,
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
index 695ea9a33f..54f23ae774 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
@@ -32,6 +32,7 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
             "stripNamespaces": bool,
             "mergeTransformAndShape": bool,
             "flattenContent": bool,
+            "writeAsCompoundLayers": bool,
             "writePendingOverrides": bool,
             "numTimeSamples": int,
             "timeSamplesSpan": float
@@ -45,6 +46,7 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
             "stripNamespaces": True,
             "mergeTransformAndShape": False,
             "flattenContent": False,
+            "writeAsCompoundLayers": False,
             "writePendingOverrides": False,
             "numTimeSamples": 1,
             "timeSamplesSpan": 0.0

From 9fc70adfffeb0569f8c0f32f52eb80c722f923b7 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 18 May 2022 13:07:33 +0200
Subject: [PATCH 0279/1227] flame: abs number only if not 0

---
 .../plugins/publish/collect_timeline_instances.py      | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
index 012cb110ec..0aca7c38d5 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
@@ -75,11 +75,17 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
                 marker_data["handleEnd"]
             )
 
+            # make sure value is absolute
+            if head != 0:
+                head = abs(head)
+            if tail != 0:
+                tail = abs(tail)
+
             # solve handles length
             marker_data["handleStart"] = min(
-                marker_data["handleStart"], abs(head))
+                marker_data["handleStart"], head)
             marker_data["handleEnd"] = min(
-                marker_data["handleEnd"], abs(tail))
+                marker_data["handleEnd"], tail)
 
             workfile_start = self._set_workfile_start(marker_data)
 

From 8f7428dd95d7fe461151821f901fa3059ff5309a Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 18 May 2022 15:07:53 +0300
Subject: [PATCH 0280/1227] Add OIIO

---
 openpype/plugins/publish/extract_jpeg_exr.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 11dfca8eb2..2d3ad1e8a8 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -3,6 +3,7 @@ import os
 import pyblish.api
 from openpype.lib import (
     get_ffmpeg_tool_path,
+    get_oiio_tools_path,
 
     run_subprocess,
     path_to_subprocess_arg,
@@ -29,6 +30,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
 
     # presetable attribute
     ffmpeg_args = None
+    oiio_args = None
 
     def process(self, instance):
         self.log.info("subset {}".format(instance.data['subset']))
@@ -119,7 +121,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             jpeg_items.append(path_to_subprocess_arg(full_output_path))
 
             subprocess_command = " ".join(jpeg_items)
-
+            
             # run subprocess
             self.log.debug("{}".format(subprocess_command))
             try:  # temporary until oiiotool is supported cross platform

From a64b3f5b7696534b3384a21143be9842397da482 Mon Sep 17 00:00:00 2001
From: "felix.wang" <icyvapor@gmail.com>
Date: Wed, 18 May 2022 16:31:14 -0700
Subject: [PATCH 0281/1227] Revert "Add toggle button for Loaders' family
 filter widget."

This reverts commit c5aa315c30413cc4e78cf113bff159a00f51164d.
---
 openpype/tools/libraryloader/app.py | 9 +--------
 openpype/tools/loader/app.py        | 9 +--------
 openpype/tools/loader/widgets.py    | 6 ------
 3 files changed, 2 insertions(+), 22 deletions(-)

diff --git a/openpype/tools/libraryloader/app.py b/openpype/tools/libraryloader/app.py
index 99dfce36e3..7fda6bd6f9 100644
--- a/openpype/tools/libraryloader/app.py
+++ b/openpype/tools/libraryloader/app.py
@@ -82,15 +82,11 @@ class LibraryLoaderWindow(QtWidgets.QDialog):
         families_filter_view = FamilyListView(
             dbcon, self.family_config_cache, left_side_splitter
         )
-        families_toggle_button = QtWidgets.QPushButton("Toggle All")
-
         left_side_splitter.addWidget(projects_combobox)
         left_side_splitter.addWidget(assets_widget)
         left_side_splitter.addWidget(families_filter_view)
-        left_side_splitter.addWidget(families_toggle_button)
         left_side_splitter.setStretchFactor(1, 65)
-        left_side_splitter.setStretchFactor(2, 30)
-        left_side_splitter.setStretchFactor(3, 5)
+        left_side_splitter.setStretchFactor(2, 35)
 
         # --- Middle part ---
         # Subsets widget
@@ -165,9 +161,6 @@ class LibraryLoaderWindow(QtWidgets.QDialog):
         families_filter_view.active_changed.connect(
             self._on_family_filter_change
         )
-        families_toggle_button.clicked.connect(
-            families_filter_view.toggle_all
-        )
         assets_widget.selection_changed.connect(self.on_assetschanged)
         assets_widget.refresh_triggered.connect(self.on_assetschanged)
         subsets_widget.active_changed.connect(self.on_subsetschanged)
diff --git a/openpype/tools/loader/app.py b/openpype/tools/loader/app.py
index 57baeae061..bb589c199d 100644
--- a/openpype/tools/loader/app.py
+++ b/openpype/tools/loader/app.py
@@ -71,14 +71,10 @@ class LoaderWindow(QtWidgets.QDialog):
         families_filter_view = FamilyListView(
             legacy_io, self.family_config_cache, left_side_splitter
         )
-        families_toggle_button = QtWidgets.QPushButton("Toggle All")
-
         left_side_splitter.addWidget(assets_widget)
         left_side_splitter.addWidget(families_filter_view)
-        left_side_splitter.addWidget(families_toggle_button)
         left_side_splitter.setStretchFactor(0, 65)
-        left_side_splitter.setStretchFactor(1, 30)
-        left_side_splitter.setStretchFactor(2, 5)
+        left_side_splitter.setStretchFactor(1, 35)
 
         # --- Middle part ---
         # Subsets widget
@@ -159,9 +155,6 @@ class LoaderWindow(QtWidgets.QDialog):
         families_filter_view.active_changed.connect(
             self._on_family_filter_change
         )
-        families_toggle_button.clicked.connect(
-            families_filter_view.toggle_all
-        )
         assets_widget.selection_changed.connect(self.on_assetschanged)
         assets_widget.refresh_triggered.connect(self.on_assetschanged)
         subsets_widget.active_changed.connect(self.on_subsetschanged)
diff --git a/openpype/tools/loader/widgets.py b/openpype/tools/loader/widgets.py
index b5f1df1e36..42fb62b632 100644
--- a/openpype/tools/loader/widgets.py
+++ b/openpype/tools/loader/widgets.py
@@ -1070,12 +1070,6 @@ class FamilyListView(QtWidgets.QListView):
     def set_all_checked(self):
         self._set_checkstates(True, self._get_all_indexes())
 
-    def toggle_all(self):
-        if self.get_enabled_families():
-            self.set_all_unchecked()
-        else:
-            self.set_all_checked()
-
     def _get_all_indexes(self):
         indexes = []
         model = self._family_model

From 6b9983fdede5e7e086e62798abddabdec3afcb85 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Thu, 19 May 2022 14:19:30 +0100
Subject: [PATCH 0282/1227] Added support for both UE4 and 5

Plugin won't compile in UE4 yet. UE5 needs different modules, not available in UE4.
---
 .../unreal/hooks/pre_workfile_preparation.py  | 12 ++---
 openpype/hosts/unreal/lib.py                  | 48 ++++++++++++-------
 2 files changed, 36 insertions(+), 24 deletions(-)

diff --git a/openpype/hosts/unreal/hooks/pre_workfile_preparation.py b/openpype/hosts/unreal/hooks/pre_workfile_preparation.py
index fa0562a3a0..5be04fc841 100644
--- a/openpype/hosts/unreal/hooks/pre_workfile_preparation.py
+++ b/openpype/hosts/unreal/hooks/pre_workfile_preparation.py
@@ -71,7 +71,7 @@ class UnrealPrelaunchHook(PreLaunchHook):
             if int(engine_version.split(".")[0]) < 4 and \
                     int(engine_version.split(".")[1]) < 26:
                 raise ApplicationLaunchFailed((
-                    f"{self.signature} Old unsupported version of UE4 "
+                    f"{self.signature} Old unsupported version of UE "
                     f"detected - {engine_version}"))
         except ValueError:
             # there can be string in minor version and in that case
@@ -104,14 +104,14 @@ class UnrealPrelaunchHook(PreLaunchHook):
         project_path = Path(os.path.join(workdir, unreal_project_name))
 
         self.log.info((
-            f"{self.signature} requested UE4 version: "
+            f"{self.signature} requested UE version: "
             f"[ {engine_version} ]"
         ))
 
         detected = unreal_lib.get_engine_versions(self.launch_context.env)
         detected_str = ', '.join(detected.keys()) or 'none'
         self.log.info((
-            f"{self.signature} detected UE4 versions: "
+            f"{self.signature} detected UE versions: "
             f"[ {detected_str} ]"
         ))
         if not detected:
@@ -124,10 +124,10 @@ class UnrealPrelaunchHook(PreLaunchHook):
                 f"detected [ {engine_version} ]"
             ))
 
-        ue4_path = unreal_lib.get_editor_executable_path(
-            Path(detected[engine_version]))
+        ue_path = unreal_lib.get_editor_executable_path(
+            Path(detected[engine_version]), engine_version)
 
-        self.launch_context.launch_args = [ue4_path.as_posix()]
+        self.launch_context.launch_args = [ue_path.as_posix()]
         project_path.mkdir(parents=True, exist_ok=True)
 
         project_file = project_path / unreal_project_filename
diff --git a/openpype/hosts/unreal/lib.py b/openpype/hosts/unreal/lib.py
index fdf3acb37b..f220d8dedf 100644
--- a/openpype/hosts/unreal/lib.py
+++ b/openpype/hosts/unreal/lib.py
@@ -70,19 +70,22 @@ def get_engine_versions(env=None):
     return OrderedDict()
 
 
-def get_editor_executable_path(engine_path: Path) -> Path:
-    """Get UE4 Editor executable path."""
-    ue4_path = engine_path / "Engine/Binaries"
+def get_editor_executable_path(engine_path: Path, engine_version: str) -> Path:
+    """Get UE Editor executable path."""
+    ue_path = engine_path / "Engine/Binaries"
     if platform.system().lower() == "windows":
-        ue4_path /= "Win64/UnrealEditor.exe"
+        if engine_version.split(".")[0] == "4":
+            ue_path /= "Win64/UE4Editor.exe"
+        elif engine_version.split(".")[0] == "5":
+            ue_path /= "Win64/UnrealEditor.exe"
 
     elif platform.system().lower() == "linux":
-        ue4_path /= "Linux/UE4Editor"
+        ue_path /= "Linux/UE4Editor"
 
     elif platform.system().lower() == "darwin":
-        ue4_path /= "Mac/UE4Editor"
+        ue_path /= "Mac/UE4Editor"
 
-    return ue4_path
+    return ue_path
 
 
 def _win_get_engine_versions():
@@ -208,22 +211,26 @@ def create_unreal_project(project_name: str,
     # created in different UE4 version. When user convert such project
     # to his UE4 version, Engine ID is replaced in uproject file. If some
     # other user tries to open it, it will present him with similar error.
-    ue4_modules = Path()
+    ue_modules = Path()
     if platform.system().lower() == "windows":
-        ue4_modules = Path(os.path.join(engine_path, "Engine", "Binaries",
-                                        "Win64", "UE4Editor.modules"))
+        ue_modules_path = engine_path / "Engine/Binaries/Win64"
+        if ue_version.split(".")[0] == "4":
+            ue_modules_path /= "UE4Editor.modules"
+        elif ue_version.split(".")[0] == "5":
+            ue_modules_path /= "UnrealEditor.modules"
+        ue_modules = Path(ue_modules_path)
 
     if platform.system().lower() == "linux":
-        ue4_modules = Path(os.path.join(engine_path, "Engine", "Binaries",
+        ue_modules = Path(os.path.join(engine_path, "Engine", "Binaries",
                                         "Linux", "UE4Editor.modules"))
 
     if platform.system().lower() == "darwin":
-        ue4_modules = Path(os.path.join(engine_path, "Engine", "Binaries",
+        ue_modules = Path(os.path.join(engine_path, "Engine", "Binaries",
                                         "Mac", "UE4Editor.modules"))
 
-    if ue4_modules.exists():
+    if ue_modules.exists():
         print("--- Loading Engine ID from modules file ...")
-        with open(ue4_modules, "r") as mp:
+        with open(ue_modules, "r") as mp:
             loaded_modules = json.load(mp)
 
         if loaded_modules.get("BuildId"):
@@ -298,10 +305,11 @@ def create_unreal_project(project_name: str,
         [python_path.as_posix(), "-m", "pip", "install", "--user", "pyside2"])
 
     if dev_mode or preset["dev_mode"]:
-        _prepare_cpp_project(project_file, engine_path)
+        _prepare_cpp_project(project_file, engine_path, ue_version)
 
 
-def _prepare_cpp_project(project_file: Path, engine_path: Path) -> None:
+def _prepare_cpp_project(
+        project_file: Path, engine_path: Path, ue_version: str) -> None:
     """Prepare CPP Unreal Project.
 
     This function will add source files needed for project to be
@@ -420,8 +428,12 @@ class {1}_API A{0}GameModeBase : public AGameModeBase
     with open(sources_dir / f"{project_name}GameModeBase.h", mode="w") as f:
         f.write(game_mode_h)
 
-    u_build_tool = Path(
-        engine_path / "Engine/Binaries/DotNET/UnrealBuildTool/UnrealBuildTool.exe")
+    u_build_tool_path = engine_path / "Engine/Binaries/DotNET"
+    if ue_version.split(".")[0] == "4":
+        u_build_tool_path /= "UnrealBuildTool.exe"
+    elif ue_version.split(".")[0] == "5":
+        u_build_tool_path /= "UnrealBuildTool/UnrealBuildTool.exe"
+    u_build_tool = Path(u_build_tool_path)
     u_header_tool = None
 
     arch = "Win64"

From 13b4b18d162ed4307408e9d2f64869403c740724 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 19 May 2022 17:05:55 +0200
Subject: [PATCH 0283/1227] OP-2787 - WIP implementation

---
 openpype/api.py                               |   2 +
 openpype/hosts/maya/api/pipeline.py           |   7 +
 .../maya/plugins/create/create_animation.py   |   4 +
 .../maya/plugins/create/create_pointcache.py  |   4 +
 .../maya/plugins/publish/collect_animation.py |   3 +
 .../plugins/publish/collect_pointcache.py     |  14 ++
 .../maya/plugins/publish/extract_animation.py |   8 +
 .../plugins/publish/extract_pointcache.py     |   8 +
 openpype/lib/remote_publish.py                |   2 +-
 .../submit_maya_remote_publish_deadline.py    | 137 ++++++++++++++++++
 openpype/plugin.py                            |  12 ++
 openpype/plugins/publish/integrate_new.py     |   3 +
 openpype/scripts/remote_publish.py            |  11 ++
 13 files changed, 214 insertions(+), 1 deletion(-)
 create mode 100644 openpype/hosts/maya/plugins/publish/collect_pointcache.py
 create mode 100644 openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
 create mode 100644 openpype/scripts/remote_publish.py

diff --git a/openpype/api.py b/openpype/api.py
index 9ce745b653..e049a683c6 100644
--- a/openpype/api.py
+++ b/openpype/api.py
@@ -44,6 +44,7 @@ from . import resources
 
 from .plugin import (
     Extractor,
+    Integrator,
 
     ValidatePipelineOrder,
     ValidateContentsOrder,
@@ -86,6 +87,7 @@ __all__ = [
 
     # plugin classes
     "Extractor",
+    "Integrator",
     # ordering
     "ValidatePipelineOrder",
     "ValidateContentsOrder",
diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index b0e8fac635..b75af29523 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -71,8 +71,15 @@ def install():
     if lib.IS_HEADLESS:
         log.info(("Running in headless mode, skipping Maya "
                  "save/open/new callback installation.."))
+
+        # Register default "local" target
+        print("Registering pyblish target: farm")
+        pyblish.api.register_target("farm")
         return
 
+    print("Registering pyblish target: local")
+    pyblish.api.register_target("local")
+
     _set_project()
     _register_callbacks()
 
diff --git a/openpype/hosts/maya/plugins/create/create_animation.py b/openpype/hosts/maya/plugins/create/create_animation.py
index 11a668cfc8..5cd1f7090a 100644
--- a/openpype/hosts/maya/plugins/create/create_animation.py
+++ b/openpype/hosts/maya/plugins/create/create_animation.py
@@ -38,3 +38,7 @@ class CreateAnimation(plugin.Creator):
 
         # Default to exporting world-space
         self.data["worldSpace"] = True
+
+        # Default to not send to farm.
+        self.data["farm"] = False
+        self.data["priority"] = 50
diff --git a/openpype/hosts/maya/plugins/create/create_pointcache.py b/openpype/hosts/maya/plugins/create/create_pointcache.py
index ede152f1ef..e876015adb 100644
--- a/openpype/hosts/maya/plugins/create/create_pointcache.py
+++ b/openpype/hosts/maya/plugins/create/create_pointcache.py
@@ -28,3 +28,7 @@ class CreatePointCache(plugin.Creator):
         # Add options for custom attributes
         self.data["attr"] = ""
         self.data["attrPrefix"] = ""
+
+        # Default to not send to farm.
+        self.data["farm"] = False
+        self.data["priority"] = 50
diff --git a/openpype/hosts/maya/plugins/publish/collect_animation.py b/openpype/hosts/maya/plugins/publish/collect_animation.py
index 9b1e38fd0a..b442113fbc 100644
--- a/openpype/hosts/maya/plugins/publish/collect_animation.py
+++ b/openpype/hosts/maya/plugins/publish/collect_animation.py
@@ -55,3 +55,6 @@ class CollectAnimationOutputGeometry(pyblish.api.InstancePlugin):
 
         # Store data in the instance for the validator
         instance.data["out_hierarchy"] = hierarchy
+
+        if instance.data.get("farm"):
+            instance.data["families"].append("deadline")
diff --git a/openpype/hosts/maya/plugins/publish/collect_pointcache.py b/openpype/hosts/maya/plugins/publish/collect_pointcache.py
new file mode 100644
index 0000000000..b55babe372
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/collect_pointcache.py
@@ -0,0 +1,14 @@
+import pyblish.api
+
+
+class CollectPointcache(pyblish.api.InstancePlugin):
+    """Collect pointcache data for instance."""
+
+    order = pyblish.api.CollectorOrder + 0.4
+    families = ["pointcache"]
+    label = "Collect Pointcache"
+    hosts = ["maya"]
+
+    def process(self, instance):
+        if instance.data.get("farm"):
+            instance.data["families"].append("deadline")
\ No newline at end of file
diff --git a/openpype/hosts/maya/plugins/publish/extract_animation.py b/openpype/hosts/maya/plugins/publish/extract_animation.py
index 8a8bd67cd8..87f2d35192 100644
--- a/openpype/hosts/maya/plugins/publish/extract_animation.py
+++ b/openpype/hosts/maya/plugins/publish/extract_animation.py
@@ -23,6 +23,14 @@ class ExtractAnimation(openpype.api.Extractor):
     families = ["animation"]
 
     def process(self, instance):
+        if instance.data.get("farm"):
+            path = os.path.join(
+                os.path.dirname(instance.context.data["currentFile"]),
+                "cache",
+                instance.data["name"] + ".abc"
+            )
+            instance.data["expectedFiles"] = [os.path.normpath(path)]
+            return
 
         # Collect the out set nodes
         out_sets = [node for node in instance if node.endswith("out_SET")]
diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index 60502fdde1..7ad4c6dfa9 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -25,6 +25,14 @@ class ExtractAlembic(openpype.api.Extractor):
                 "vrayproxy"]
 
     def process(self, instance):
+        if instance.data.get("farm"):
+            path = os.path.join(
+                os.path.dirname(instance.context.data["currentFile"]),
+                "cache",
+                instance.data["name"] + ".abc"
+            )
+            instance.data["expectedFiles"] = [os.path.normpath(path)]
+            return
 
         nodes = instance[:]
 
diff --git a/openpype/lib/remote_publish.py b/openpype/lib/remote_publish.py
index 8a42daf4e9..da2497e1a5 100644
--- a/openpype/lib/remote_publish.py
+++ b/openpype/lib/remote_publish.py
@@ -228,7 +228,7 @@ def _get_close_plugin(close_plugin_name, log):
             if plugin.__name__ == close_plugin_name:
                 return plugin
 
-    log.warning("Close plugin not found, app might not close.")
+    log.debug("Close plugin not found, app might not close.")
 
 
 def get_task_data(batch_dir):
diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
new file mode 100644
index 0000000000..761bc8cc95
--- /dev/null
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
@@ -0,0 +1,137 @@
+import os
+import requests
+
+from maya import cmds
+
+from openpype.pipeline import legacy_io
+
+import pyblish.api
+
+
+class MayaSubmitRemotePublishDeadline(pyblish.api.ContextPlugin):
+    """Submit Maya scene to perform a local publish in Deadline.
+
+    Publishing in Deadline can be helpful for scenes that publish very slow.
+    This way it can process in the background on another machine without the
+    Artist having to wait for the publish to finish on their local machine.
+
+    Submission is done through the Deadline Web Service.
+
+    Different from `ProcessSubmittedJobOnFarm` which creates publish job
+    depending on metadata json containing context and instance data of
+    rendered files.
+    """
+
+    label = "Submit Scene to Deadline"
+    order = pyblish.api.IntegratorOrder
+    hosts = ["maya"]
+    families = ["deadline"]
+
+    # custom deadline attributes
+    deadline_department = ""
+    deadline_pool = ""
+    deadline_pool_secondary = ""
+    deadline_group = ""
+    deadline_chunk_size = 1
+    deadline_priority = 50
+
+    def process(self, context):
+
+        # Ensure no errors so far
+        assert all(result["success"] for result in context.data["results"]), (
+            "Errors found, aborting integration..")
+
+        # Note that `publish` data member might change in the future.
+        # See: https://github.com/pyblish/pyblish-base/issues/307
+        actives = [i for i in context if i.data["publish"]]
+        instance_names = sorted(instance.name for instance in actives)
+
+        if not instance_names:
+            self.log.warning("No active instances found. "
+                             "Skipping submission..")
+            return
+
+        scene = context.data["currentFile"]
+        scenename = os.path.basename(scene)
+
+        # Get project code
+        project_name = legacy_io.Session["AVALON_PROJECT"]
+
+        job_name = "{scene} [PUBLISH]".format(scene=scenename)
+        batch_name = "{code} - {scene}".format(code=project_name,
+                                               scene=scenename)
+
+        # Generate the payload for Deadline submission
+        payload = {
+            "JobInfo": {
+                "Plugin": "MayaBatch",
+                "BatchName": batch_name,
+                "Priority": 50,
+                "Name": job_name,
+                "UserName": context.data["user"],
+                # "Comment": instance.context.data.get("comment", ""),
+                # "InitialStatus": state
+                "Department": self.deadline_department,
+                "ChunkSize": self.deadline_chunk_size,
+                "Priority": self.deadline_priority,
+
+                "Group": self.deadline_group,
+
+            },
+            "PluginInfo": {
+
+                "Build": None,  # Don't force build
+                "StrictErrorChecking": True,
+                "ScriptJob": True,
+
+                # Inputs
+                "SceneFile": scene,
+                "ScriptFilename": "{OPENPYPE_ROOT}/scripts/remote_publish.py",
+
+                # Mandatory for Deadline
+                "Version": cmds.about(version=True),
+
+                # Resolve relative references
+                "ProjectPath": cmds.workspace(query=True,
+                                              rootDirectory=True),
+
+            },
+
+            # Mandatory for Deadline, may be empty
+            "AuxFiles": []
+        }
+
+        # Include critical environment variables with submission + api.Session
+        keys = [
+            "FTRACK_API_USER",
+            "FTRACK_API_KEY",
+            "FTRACK_SERVER"
+        ]
+        environment = dict({key: os.environ[key] for key in keys
+                            if key in os.environ}, **legacy_io.Session)
+
+        # TODO replace legacy_io with context.data ?
+        environment["AVALON_PROJECT"] = legacy_io.Session["AVALON_PROJECT"]
+        environment["AVALON_ASSET"] = legacy_io.Session["AVALON_ASSET"]
+        environment["AVALON_TASK"] = legacy_io.Session["AVALON_TASK"]
+        environment["AVALON_APP_NAME"] = os.environ.get("AVALON_APP_NAME")
+        environment["OPENPYPE_LOG_NO_COLORS"] = "1"
+        environment["OPENPYPE_USERNAME"] = context.data["user"]
+        environment["OPENPYPE_PUBLISH_JOB"] = "1"
+        environment["OPENPYPE_RENDER_JOB"] = "0"
+        environment["PYBLISH_ACTIVE_INSTANCES"] = ",".join(instance_names)
+
+        payload["JobInfo"].update({
+            "EnvironmentKeyValue%d" % index: "{key}={value}".format(
+                key=key,
+                value=environment[key]
+            ) for index, key in enumerate(environment)
+        })
+
+        self.log.info("Submitting Deadline job ...")
+        deadline_url = context.data["defaultDeadline"]
+        assert deadline_url, "Requires Deadline Webservice URL"
+        url = "{}/api/jobs".format(deadline_url)
+        response = requests.post(url, json=payload, timeout=10)
+        if not response.ok:
+            raise Exception(response.text)
diff --git a/openpype/plugin.py b/openpype/plugin.py
index bb9bc2ff85..f1ee626ffb 100644
--- a/openpype/plugin.py
+++ b/openpype/plugin.py
@@ -18,6 +18,16 @@ class InstancePlugin(pyblish.api.InstancePlugin):
         super(InstancePlugin, cls).process(cls, *args, **kwargs)
 
 
+class Integrator(InstancePlugin):
+    """Integrator base class.
+
+    Wraps pyblish instance plugin. Targets set to "local" which means all
+    integrators should run on "local" publishes, by default.
+    "farm" targets could be used for integrators that should run on a farm.
+    """
+    targets = ["local"]
+
+
 class Extractor(InstancePlugin):
     """Extractor base class.
 
@@ -28,6 +38,8 @@ class Extractor(InstancePlugin):
 
     """
 
+    targets = ["local"]
+
     order = 2.0
 
     def staging_dir(self, instance):
diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index bf13a4050e..1a4112107a 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -139,6 +139,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                     ef, instance.data["family"], instance.data["families"]))
                 return
 
+        if "deadline" in instance.data["families"]:
+            return
+
         self.integrated_file_sizes = {}
         try:
             self.register(instance)
diff --git a/openpype/scripts/remote_publish.py b/openpype/scripts/remote_publish.py
new file mode 100644
index 0000000000..b54c8d931b
--- /dev/null
+++ b/openpype/scripts/remote_publish.py
@@ -0,0 +1,11 @@
+try:
+    from openpype.api import Logger
+    import openpype.lib.remote_publish
+except ImportError as exc:
+    # Ensure Deadline fails by output an error that contains "Fatal Error:"
+    raise ImportError("Fatal Error: %s" % exc)
+
+if __name__ == "__main__":
+    # Perform remote publish with thorough error checking
+    log = Logger.get_logger(__name__)
+    openpype.lib.remote_publish.publish(log)

From 0b7e3b6606a5e369e7aa2d9d4ae465d218f38016 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Fri, 20 May 2022 10:34:53 +0900
Subject: [PATCH 0284/1227] Fixed formatting errors, removed unneeded code,
 added comments.

---
 .../publish/collect_multiverse_look.py        | 46 ++++++++-----------
 1 file changed, 20 insertions(+), 26 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
index 9c1569e216..643a3eae61 100644
--- a/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
@@ -6,6 +6,7 @@ from maya import cmds
 import pyblish.api
 from openpype.hosts.maya.api import lib
 
+
 def get_look_attrs(node):
     """Returns attributes of a node that are important for the look.
 
@@ -191,20 +192,19 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
         cmds.loadPlugin("MultiverseForMaya", quiet=True)
         import multiverse
 
-        self.log.info("Processing mvLook for '{}' / '{}'".format(
-            instance, instance.data['name']))
+        self.log.info("Processing mvLook for '{}'".format(instance))
 
         nodes = set()
         for node in instance:
             # We want only mvUsdCompoundShape nodes.
             nodes_of_interest = cmds.ls(node,
-                              dag=True,
-                              shapes=False,
-                              type="mvUsdCompoundShape",
-                              noIntermediate=True,
-                              long=True)
+                                        dag=True,
+                                        shapes=False,
+                                        type="mvUsdCompoundShape",
+                                        noIntermediate=True,
+                                        long=True)
             nodes.update(nodes_of_interest)
-    
+
         files = []
         sets = {}
         instance.data["resources"] = []
@@ -212,16 +212,21 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
         for node in nodes:
             self.log.info("Getting resources for '{}'".format(node))
 
-            # We know what nodes 
+            # We know what nodes need to be collected, now we need to
+            # extract the materials overrides.
             overrides = multiverse.ListMaterialOverridePrims(node)
             for override in overrides:
                 matOver = multiverse.GetMaterialOverride(node, override)
 
                 if isinstance(matOver, multiverse.MaterialSourceShadingGroup):
+                    # We now need to grab the shadingGroup so add it to the
+                    # sets we pass down the pipe.
                     shadingGroup = matOver.shadingGroupName
                     self.log.debug("ShadingGroup = '{}'".format(shadingGroup))
-                    sets[shadingGroup] = {"uuid": lib.get_id(shadingGroup), "members": list()}
+                    sets[shadingGroup] = {"uuid": lib.get_id(
+                        shadingGroup), "members": list()}
 
+                    # The SG may reference files, add those too!
                     history = cmds.listHistory(shadingGroup)
                     files = cmds.ls(history, type="file", long=True)
 
@@ -229,28 +234,16 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
                         resources = self.collect_resource(f)
                         instance.data["resources"].append(resources)
 
-                elif  isinstance(matOver, multiverse.MaterialSourceUsdPath):
+                elif isinstance(matOver, multiverse.MaterialSourceUsdPath):
                     # TODO: Handle this later.
                     pass
-                else:
-                    # TODO: What to do here?
-                    pass
 
-        # Store data on the instance
+        # Store data on the instance for validators, extractos, etc.
         instance.data["lookData"] = {
             "attributes": [],
             "relationships": sets
         }
 
-        self.log.info("-------------------------")
-        self.log.info("Instance: {},{}".format(type(instance),instance))
-        self.log.info("Instance.data: {},{}".format(type(instance.data),instance.data))
-        for k in instance.data.keys():
-            v = instance.data[k]
-            self.log.info(" data: {},{}".format(k,v))
-        self.log.info("-------------------------")
-
-
     def collect_resource(self, node):
         """Collect the link to the file(s) used (resource)
         Args:
@@ -269,7 +262,8 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
         if cmds.nodeType(node) == 'file':
             self.log.debug("  - file node")
             attribute = "{}.fileTextureName".format(node)
-            computed_attribute = "{}.computedFileTextureNamePattern".format(node)
+            computed_attribute = "{}.computedFileTextureNamePattern".format(
+                node)
         elif cmds.nodeType(node) == 'aiImage':
             self.log.debug("aiImage node")
             attribute = "{}.filename".format(node)
@@ -320,4 +314,4 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
                 "attribute": attribute,
                 "source": source,  # required for resources
                 "files": files,
-                "color_space": color_space}  # required for resources
\ No newline at end of file
+                "color_space": color_space}  # required for resources

From fe40624135dae296d0f4099edbdaf8be38742b79 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Fri, 20 May 2022 10:38:45 +0900
Subject: [PATCH 0285/1227] Minor cleanup.

---
 .../maya/plugins/publish/collect_multiverse_look.py | 13 ++++++++++++-
 openpype/hosts/maya/plugins/publish/extract_look.py |  2 +-
 .../maya/plugins/publish/extract_multiverse_look.py |  1 -
 3 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
index 643a3eae61..c5ea6a2253 100644
--- a/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
@@ -6,6 +6,17 @@ from maya import cmds
 import pyblish.api
 from openpype.hosts.maya.api import lib
 
+SHAPE_ATTRS = ["castsShadows",
+               "receiveShadows",
+               "motionBlur",
+               "primaryVisibility",
+               "smoothShading",
+               "visibleInReflections",
+               "visibleInRefractions",
+               "doubleSided",
+               "opposite"]
+
+SHAPE_ATTRS = set(SHAPE_ATTRS)
 
 def get_look_attrs(node):
     """Returns attributes of a node that are important for the look.
@@ -92,7 +103,7 @@ def seq_to_glob(path):
         "<uvtile>": "<uvtile>",
         "#": "#",
         "u<u>_v<v>": "<u>|<v>",
-        "<frame0": "<frame0\d+>",
+        "<frame0": "<frame0\d+>", #noqa - copied from collect_look.py
         "<f>": "<f>"
     }
 
diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py
index c427eacd98..afb2c3b3d6 100644
--- a/openpype/hosts/maya/plugins/publish/extract_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_look.py
@@ -146,7 +146,7 @@ class ExtractLook(openpype.api.Extractor):
 
     label = "Extract Look (Maya Scene + JSON)"
     hosts = ["maya"]
-    families = ["look","mvLook"]
+    families = ["look", "mvLook"]
     order = pyblish.api.ExtractorOrder + 0.2
     scene_type = "ma"
     look_data_type = "json"
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py
index 34c72f0915..5ba840f2b7 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py
@@ -1,5 +1,4 @@
 import os
-import six
 
 from maya import cmds
 

From d46c919281145a7d07ffb5aca1ef16f7407c6e46 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 12 May 2022 11:46:55 +0200
Subject: [PATCH 0286/1227] general: calculation of duration should not exclude
 one frame


From ddfee503677c3ad6e653c9346cd742520667d0d9 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 12 May 2022 11:47:23 +0200
Subject: [PATCH 0287/1227] hiero: fitting new duration calculation


From f4ebcdb27856888794c59c142c43806b863cb61b Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 12:22:35 +0200
Subject: [PATCH 0288/1227] Hiero: small bugs

- track name was not equal and was catching similar names too
- publish action in timeline submenu was broken
- parse_container was returning false data even it should not
---
 openpype/hosts/hiero/api/lib.py      | 7 ++++---
 openpype/hosts/hiero/api/pipeline.py | 5 +++++
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 2a4cd03b76..be02c7c793 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -118,7 +118,7 @@ def get_current_track(sequence, name, audio=False):
     # get track by name
     track = None
     for _track in tracks:
-        if _track.name() in name:
+        if _track.name() == name:
             track = _track
 
     if not track:
@@ -126,6 +126,7 @@ def get_current_track(sequence, name, audio=False):
             track = hiero.core.VideoTrack(name)
         else:
             track = hiero.core.AudioTrack(name)
+
         sequence.addTrack(track)
 
     return track
@@ -497,7 +498,7 @@ class PyblishSubmission(hiero.exporters.FnSubmission.Submission):
         from . import publish
         # Add submission to Hiero module for retrieval in plugins.
         hiero.submission = self
-        publish()
+        publish(hiero.ui.mainWindow())
 
 
 def add_submission():
@@ -527,7 +528,7 @@ class PublishAction(QtWidgets.QAction):
         # from getting picked up when not using the "Export" dialog.
         if hasattr(hiero, "submission"):
             del hiero.submission
-        publish()
+        publish(hiero.ui.mainWindow())
 
     def eventHandler(self, event):
         # Add the Menu to the right-click menu
diff --git a/openpype/hosts/hiero/api/pipeline.py b/openpype/hosts/hiero/api/pipeline.py
index 8025ebff05..9b628ec70b 100644
--- a/openpype/hosts/hiero/api/pipeline.py
+++ b/openpype/hosts/hiero/api/pipeline.py
@@ -143,6 +143,11 @@ def parse_container(track_item, validate=True):
     """
     # convert tag metadata to normal keys names
     data = lib.get_track_item_pype_data(track_item)
+    if (
+        not data
+        or data.get("id") != "pyblish.avalon.container"
+    ):
+        return
 
     if validate and data and data.get("schema"):
         schema.validate(data)

From c09038984190085b6182cf075455d503692e10ca Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 19:46:34 +0200
Subject: [PATCH 0289/1227] Hiero: add new `get_timeline_selection` function

---
 openpype/hosts/hiero/api/__init__.py | 2 ++
 openpype/hosts/hiero/api/lib.py      | 6 ++++++
 2 files changed, 8 insertions(+)

diff --git a/openpype/hosts/hiero/api/__init__.py b/openpype/hosts/hiero/api/__init__.py
index f3c32b268c..fc2d017f04 100644
--- a/openpype/hosts/hiero/api/__init__.py
+++ b/openpype/hosts/hiero/api/__init__.py
@@ -27,6 +27,7 @@ from .lib import (
     get_track_items,
     get_current_project,
     get_current_sequence,
+    get_timeline_selection,
     get_current_track,
     get_track_item_pype_tag,
     set_track_item_pype_tag,
@@ -80,6 +81,7 @@ __all__ = [
     "get_track_items",
     "get_current_project",
     "get_current_sequence",
+    "get_timeline_selection",
     "get_current_track",
     "get_track_item_pype_tag",
     "set_track_item_pype_tag",
diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index be02c7c793..115a926d84 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -96,6 +96,12 @@ def get_current_sequence(name=None, new=False):
     return sequence
 
 
+def get_timeline_selection():
+    active_sequence = hiero.ui.activeSequence()
+    timeline_editor = hiero.ui.getTimelineEditor(active_sequence)
+    return list(timeline_editor.selection())
+
+
 def get_current_track(sequence, name, audio=False):
     """
     Get current track in context of active project.

From 9dd13425c36511873aeefb46f88f721381d91cc6 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 19:47:15 +0200
Subject: [PATCH 0290/1227] Hiero: removing event slowing down work with
 timeline

---
 openpype/hosts/hiero/api/events.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/hiero/api/events.py b/openpype/hosts/hiero/api/events.py
index 7fab3edfc8..59fd278a81 100644
--- a/openpype/hosts/hiero/api/events.py
+++ b/openpype/hosts/hiero/api/events.py
@@ -109,8 +109,9 @@ def register_hiero_events():
     # hiero.core.events.registerInterest("kShutdown", shutDown)
     # hiero.core.events.registerInterest("kStartup", startupCompleted)
 
-    hiero.core.events.registerInterest(
-        ("kSelectionChanged", "kTimeline"), selection_changed_timeline)
+    # INFO: was disabled because it was slowing down timeline operations
+    # hiero.core.events.registerInterest(
+    #     ("kSelectionChanged", "kTimeline"), selection_changed_timeline)
 
     # workfiles
     try:

From c70c6d99110dce5f7d880cc0d285e2a03dfbf583 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 19:48:12 +0200
Subject: [PATCH 0291/1227] Hiero: fixing one frame difference otio clip and
 media

---
 openpype/hosts/hiero/api/otio/hiero_export.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/hiero/api/otio/hiero_export.py b/openpype/hosts/hiero/api/otio/hiero_export.py
index 64fb81aed4..46e1204324 100644
--- a/openpype/hosts/hiero/api/otio/hiero_export.py
+++ b/openpype/hosts/hiero/api/otio/hiero_export.py
@@ -151,7 +151,7 @@ def create_otio_reference(clip):
     padding = media_source.filenamePadding()
     file_head = media_source.filenameHead()
     is_sequence = not media_source.singleFile()
-    frame_duration = media_source.duration() - 1
+    frame_duration = media_source.duration()
     fps = utils.get_rate(clip) or self.project_fps
     extension = os.path.splitext(path)[-1]
 
@@ -277,7 +277,7 @@ def create_otio_clip(track_item):
     # flip if speed is in minus
     source_in = track_item.sourceIn() if speed > 0 else track_item.sourceOut()
 
-    duration = int(track_item.duration())
+    duration = int(track_item.duration()) - 1
 
     fps = utils.get_rate(track_item) or self.project_fps
     name = track_item.name()

From cf6ea949acca41fcd04a0155134252c21816939a Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 19:48:40 +0200
Subject: [PATCH 0292/1227] global: hierarchy fps should be taken from
 instance.data

---
 openpype/plugins/publish/collect_hierarchy.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/collect_hierarchy.py b/openpype/plugins/publish/collect_hierarchy.py
index a96d444be6..8398a2815a 100644
--- a/openpype/plugins/publish/collect_hierarchy.py
+++ b/openpype/plugins/publish/collect_hierarchy.py
@@ -62,7 +62,7 @@ class CollectHierarchy(pyblish.api.ContextPlugin):
                 "frameEnd": instance.data["frameEnd"],
                 "clipIn": instance.data["clipIn"],
                 "clipOut": instance.data["clipOut"],
-                'fps': instance.context.data["fps"],
+                "fps": instance.data["fps"],
                 "resolutionWidth": instance.data["resolutionWidth"],
                 "resolutionHeight": instance.data["resolutionHeight"],
                 "pixelAspect": instance.data["pixelAspect"]

From 191444167c025f0f1bf20b6d15dbd480eff1243e Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 19:49:52 +0200
Subject: [PATCH 0293/1227] Hiero: moving order bit lower under core plugins

---
 openpype/hosts/hiero/plugins/publish/precollect_workfile.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/hiero/plugins/publish/precollect_workfile.py b/openpype/hosts/hiero/plugins/publish/precollect_workfile.py
index b9f58c15f6..c9bfb86810 100644
--- a/openpype/hosts/hiero/plugins/publish/precollect_workfile.py
+++ b/openpype/hosts/hiero/plugins/publish/precollect_workfile.py
@@ -16,7 +16,7 @@ class PrecollectWorkfile(pyblish.api.ContextPlugin):
     """Inject the current working file into context"""
 
     label = "Precollect Workfile"
-    order = pyblish.api.CollectorOrder - 0.5
+    order = pyblish.api.CollectorOrder - 0.491
 
     def process(self, context):
 
@@ -84,6 +84,7 @@ class PrecollectWorkfile(pyblish.api.ContextPlugin):
             "colorspace": self.get_colorspace(project),
             "fps": fps
         }
+        self.log.debug("__ context_data: {}".format(pformat(context_data)))
         context.data.update(context_data)
 
         self.log.info("Creating instance: {}".format(instance))

From b55bf81d352790c46ba748a7781bc75cda88afb1 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 19:50:50 +0200
Subject: [PATCH 0294/1227] Hiero: adding timeline selected to precollector

---
 .../hosts/hiero/plugins/publish/precollect_instances.py    | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/hiero/plugins/publish/precollect_instances.py b/openpype/hosts/hiero/plugins/publish/precollect_instances.py
index 46f0b2440e..1ef7e5f538 100644
--- a/openpype/hosts/hiero/plugins/publish/precollect_instances.py
+++ b/openpype/hosts/hiero/plugins/publish/precollect_instances.py
@@ -19,9 +19,12 @@ class PrecollectInstances(pyblish.api.ContextPlugin):
 
     def process(self, context):
         self.otio_timeline = context.data["otioTimeline"]
-
+        timeline_selection = phiero.get_timeline_selection()
         selected_timeline_items = phiero.get_track_items(
-            selected=True, check_tagged=True, check_enabled=True)
+            selection=timeline_selection,
+            check_tagged=True,
+            check_enabled=True
+        )
 
         # only return enabled track items
         if not selected_timeline_items:

From 68439301dc5f24372ccd69202bcea3a3040ce733 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 19:51:21 +0200
Subject: [PATCH 0295/1227] Hiero: one frame diff fix, with code improvements

---
 .../hosts/hiero/plugins/publish/precollect_instances.py     | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/hiero/plugins/publish/precollect_instances.py b/openpype/hosts/hiero/plugins/publish/precollect_instances.py
index 1ef7e5f538..e54d050f0d 100644
--- a/openpype/hosts/hiero/plugins/publish/precollect_instances.py
+++ b/openpype/hosts/hiero/plugins/publish/precollect_instances.py
@@ -295,9 +295,9 @@ class PrecollectInstances(pyblish.api.ContextPlugin):
         for otio_clip in self.otio_timeline.each_clip():
             track_name = otio_clip.parent().name
             parent_range = otio_clip.range_in_parent()
-            if ti_track_name not in track_name:
+            if ti_track_name != track_name:
                 continue
-            if otio_clip.name not in track_item.name():
+            if otio_clip.name != track_item.name():
                 continue
             self.log.debug("__ parent_range: {}".format(parent_range))
             self.log.debug("__ timeline_range: {}".format(timeline_range))
@@ -317,7 +317,7 @@ class PrecollectInstances(pyblish.api.ContextPlugin):
         speed = track_item.playbackSpeed()
         timeline = phiero.get_current_sequence()
         frame_start = int(track_item.timelineIn())
-        frame_duration = int(track_item.sourceDuration() / speed)
+        frame_duration = int((track_item.duration() - 1) / speed)
         fps = timeline.framerate().toFloat()
 
         return hiero_export.create_otio_time_range(

From 2798469e36c3f915692cb0cfdea5e0cb5f16900a Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 19:54:17 +0200
Subject: [PATCH 0296/1227] Hiero: refactory of get_track_items with better
 validation

---
 openpype/hosts/hiero/api/lib.py | 140 ++++++++++++++++++++------------
 1 file changed, 89 insertions(+), 51 deletions(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 115a926d84..15142daa09 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -1,7 +1,10 @@
 """
 Host specific functions where host api is connected
 """
+
+import contextlib
 import os
+from pprint import pformat
 import re
 import sys
 import platform
@@ -139,7 +142,7 @@ def get_current_track(sequence, name, audio=False):
 
 
 def get_track_items(
-        selected=False,
+        selection=False,
         sequence_name=None,
         track_item_name=None,
         track_name=None,
@@ -150,7 +153,7 @@ def get_track_items(
     """Get all available current timeline track items.
 
     Attribute:
-        selected (bool)[optional]: return only selected items on timeline
+        selection (list)[optional]: list of selected track items
         sequence_name (str)[optional]: return only clips from input sequence
         track_item_name (str)[optional]: return only item with input name
         track_name (str)[optional]: return only items from track name
@@ -162,32 +165,33 @@ def get_track_items(
     Return:
         list or hiero.core.TrackItem: list of track items or single track item
     """
-    return_list = list()
-    track_items = list()
+    track_type = track_type or "video"
+    selection = selection or []
+    return_list = []
 
     # get selected track items or all in active sequence
-    if selected:
-        try:
-            selected_items = list(hiero.selection)
-            for item in selected_items:
-                if track_name and track_name in item.parent().name():
-                    # filter only items fitting input track name
-                    track_items.append(item)
-                elif not track_name:
-                    # or add all if no track_name was defined
-                    track_items.append(item)
-        except AttributeError:
-            pass
+    if selection:
+        with contextlib.suppress(AttributeError):
+            for track_item in selection:
+                log.info("___ track_item: {}".format(track_item))
+                # make sure only trackitems are selected
+                if not isinstance(track_item, hiero.core.TrackItem):
+                    continue
+
+                if _validate_all_atrributes(
+                    track_item,
+                    track_item_name,
+                    track_name,
+                    track_type,
+                    check_enabled,
+                    check_tagged
+                ):
+                    log.info("___ valid trackitem: {}".format(track_item))
+                    return_list.append(track_item)
 
-    # check if any collected track items are
-    # `core.Hiero.Python.TrackItem` instance
-    if track_items:
-        any_track_item = track_items[0]
-        if not isinstance(any_track_item, hiero.core.TrackItem):
-            selected_items = []
 
     # collect all available active sequence track items
-    if not track_items:
+    if not return_list:
         sequence = get_current_sequence(name=sequence_name)
         # get all available tracks from sequence
         tracks = list(sequence.audioTracks()) + list(sequence.videoTracks())
@@ -198,42 +202,76 @@ def get_track_items(
             if check_enabled and not track.isEnabled():
                 continue
             # and all items in track
-            for item in track.items():
-                if check_tagged and not item.tags():
+            for track_item in track.items():
+                # make sure no subtrackitem is also track items
+                if not isinstance(track_item, hiero.core.TrackItem):
                     continue
 
-                # check if track item is enabled
-                if check_enabled:
-                    if not item.isEnabled():
-                        continue
-                if track_item_name:
-                    if track_item_name in item.name():
-                        return item
-                # make sure only track items with correct track names are added
-                if track_name and track_name in track.name():
-                    # filter out only defined track_name items
-                    track_items.append(item)
-                elif not track_name:
-                    # or add all if no track_name is defined
-                    track_items.append(item)
+                if not _validate_all_atrributes(
+                    track_item,
+                    track_item_name,
+                    track_name,
+                    track_type,
+                    check_enabled,
+                    check_tagged
+                ):
+                    return_list.append(track_item)
 
-    # filter out only track items with defined track_type
-    for track_item in track_items:
-        if track_type and track_type == "video" and isinstance(
+    return return_list
+
+
+def _validate_all_atrributes(
+    track_item,
+    track_item_name,
+    track_name,
+    track_type,
+    check_enabled,
+    check_tagged
+):
+    def _validate_correct_name_track_item():
+        if track_item_name and track_item_name in track_item.name():
+            return True
+        elif not track_item_name:
+            return True
+
+    def _validate_tagged_track_item():
+        if check_tagged and track_item.tags():
+            return True
+        elif not check_tagged:
+            return True
+
+    def _validate_enabled_track_item():
+        if check_enabled and track_item.isEnabled():
+            return True
+        elif not check_enabled:
+            return True
+
+    def _validate_parent_track_item():
+        if track_name and track_name in track_item.parent().name():
+            # filter only items fitting input track name
+            return True
+        elif not track_name:
+            # or add all if no track_name was defined
+            return True
+
+    def _validate_type_track_item():
+        if track_type == "video" and isinstance(
                 track_item.parent(), hiero.core.VideoTrack):
             # only video track items are allowed
-            return_list.append(track_item)
-        elif track_type and track_type == "audio" and isinstance(
+            return True
+        elif track_type == "audio" and isinstance(
                 track_item.parent(), hiero.core.AudioTrack):
             # only audio track items are allowed
-            return_list.append(track_item)
-        elif not track_type:
-            # add all if no track_type is defined
-            return_list.append(track_item)
+            return True
 
-    # return output list but make sure all items are TrackItems
-    return [_i for _i in return_list
-            if type(_i) == hiero.core.TrackItem]
+    # check if track item is enabled
+    return all([
+        _validate_enabled_track_item(),
+        _validate_type_track_item(),
+        _validate_tagged_track_item(),
+        _validate_parent_track_item(),
+        _validate_correct_name_track_item()
+    ])
 
 
 def get_track_item_pype_tag(track_item):

From 13599837176687e49a57762414aad97e56e9125a Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 19:55:16 +0200
Subject: [PATCH 0297/1227] Hiero: fixing events

---
 openpype/hosts/hiero/api/lib.py | 27 +++++++++++++++------------
 1 file changed, 15 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 15142daa09..d3e6441705 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -1027,7 +1027,7 @@ def sync_clip_name_to_data_asset(track_items_list):
             print("asset was changed in clip: {}".format(ti_name))
 
 
-def check_inventory_versions():
+def check_inventory_versions(track_items=None):
     """
     Actual version color idetifier of Loaded containers
 
@@ -1038,14 +1038,15 @@ def check_inventory_versions():
     """
     from . import parse_container
 
+    track_item = track_items or get_track_items()
     # presets
     clip_color_last = "green"
     clip_color = "red"
 
     # get all track items from current timeline
-    for track_item in get_track_items():
+    for track_item in track_item:
         container = parse_container(track_item)
-
+        log.info("___> container: {}".format(pformat(container)))
         if container:
             # get representation from io
             representation = legacy_io.find_one({
@@ -1083,29 +1084,31 @@ def selection_changed_timeline(event):
     timeline_editor = event.sender
     selection = timeline_editor.selection()
 
-    selection = [ti for ti in selection
-                 if isinstance(ti, hiero.core.TrackItem)]
+    track_items = get_track_items(
+        selection=selection,
+        track_type="video",
+        check_enabled=True,
+        check_locked=True,
+        check_tagged=True
+    )
 
     # run checking function
-    sync_clip_name_to_data_asset(selection)
-
-    # also mark old versions of loaded containers
-    check_inventory_versions()
+    sync_clip_name_to_data_asset(track_items)
 
 
 def before_project_save(event):
     track_items = get_track_items(
-        selected=False,
         track_type="video",
         check_enabled=True,
         check_locked=True,
-        check_tagged=True)
+        check_tagged=True
+    )
 
     # run checking function
     sync_clip_name_to_data_asset(track_items)
 
     # also mark old versions of loaded containers
-    check_inventory_versions()
+    check_inventory_versions(track_items)
 
 
 def get_main_window():

From 733ad125b5798d01fe9dac9d3d24e6256d614386 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 19:56:15 +0200
Subject: [PATCH 0298/1227] Hiero: one frame diff during loading

---
 openpype/hosts/hiero/api/plugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/hiero/api/plugin.py b/openpype/hosts/hiero/api/plugin.py
index 54e66bf99a..35e9d54810 100644
--- a/openpype/hosts/hiero/api/plugin.py
+++ b/openpype/hosts/hiero/api/plugin.py
@@ -500,7 +500,7 @@ class ClipLoader:
         track_item.setSource(clip)
         track_item.setSourceIn(self.handle_start)
         track_item.setTimelineIn(self.timeline_in)
-        track_item.setSourceOut(self.media_duration - self.handle_end)
+        track_item.setSourceOut((self.media_duration + 1) - self.handle_end)
         track_item.setTimelineOut(self.timeline_out)
         track_item.setPlaybackSpeed(1)
         self.active_track.addTrackItem(track_item)

From 91af28612e367d412e70a20ece03481ed4b976e9 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 20 May 2022 11:21:16 +0200
Subject: [PATCH 0299/1227] Hiero: poping found clip

---
 openpype/hosts/hiero/plugins/load/load_clip.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/hiero/plugins/load/load_clip.py b/openpype/hosts/hiero/plugins/load/load_clip.py
index da4326c8c1..a3365253b3 100644
--- a/openpype/hosts/hiero/plugins/load/load_clip.py
+++ b/openpype/hosts/hiero/plugins/load/load_clip.py
@@ -3,10 +3,6 @@ from openpype.pipeline import (
     get_representation_path,
 )
 import openpype.hosts.hiero.api as phiero
-# from openpype.hosts.hiero.api import plugin, lib
-# reload(lib)
-# reload(plugin)
-# reload(phiero)
 
 
 class LoadClip(phiero.SequenceLoader):
@@ -106,7 +102,7 @@ class LoadClip(phiero.SequenceLoader):
         name = container['name']
         namespace = container['namespace']
         track_item = phiero.get_track_items(
-            track_item_name=namespace)
+            track_item_name=namespace).pop()
         version = legacy_io.find_one({
             "type": "version",
             "_id": representation["parent"]
@@ -157,7 +153,7 @@ class LoadClip(phiero.SequenceLoader):
         # load clip to timeline and get main variables
         namespace = container['namespace']
         track_item = phiero.get_track_items(
-            track_item_name=namespace)
+            track_item_name=namespace).pop()
         track = track_item.parent()
 
         # remove track item from track

From 053287bc616f1370602383f2aa4891fe80358599 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 20:00:01 +0200
Subject: [PATCH 0300/1227] Hiero: better logging and improving code

---
 openpype/hosts/hiero/api/plugin.py | 25 ++++++++++++++++++++-----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/hiero/api/plugin.py b/openpype/hosts/hiero/api/plugin.py
index 35e9d54810..174a25102f 100644
--- a/openpype/hosts/hiero/api/plugin.py
+++ b/openpype/hosts/hiero/api/plugin.py
@@ -1,4 +1,5 @@
 import os
+from pprint import pformat
 import re
 from copy import deepcopy
 
@@ -400,7 +401,8 @@ class ClipLoader:
 
         # inject asset data to representation dict
         self._get_asset_data()
-        log.debug("__init__ self.data: `{}`".format(self.data))
+        log.info("__init__ self.data: `{}`".format(pformat(self.data)))
+        log.info("__init__ options: `{}`".format(pformat(options)))
 
         # add active components to class
         if self.new_sequence:
@@ -482,7 +484,9 @@ class ClipLoader:
 
         """
         asset_name = self.context["representation"]["context"]["asset"]
-        self.data["assetData"] = openpype.get_asset(asset_name)["data"]
+        asset_doc = openpype.get_asset(asset_name)
+        log.debug("__ asset_doc: {}".format(pformat(asset_doc)))
+        self.data["assetData"] = asset_doc["data"]
 
     def _make_track_item(self, source_bin_item, audio=False):
         """ Create track item with """
@@ -527,7 +531,8 @@ class ClipLoader:
         if self.sequencial_load:
             last_track_item = lib.get_track_items(
                 sequence_name=self.active_sequence.name(),
-                track_name=self.active_track.name())
+                track_name=self.active_track.name()
+            )
             if len(last_track_item) == 0:
                 last_timeline_out = 0
             else:
@@ -541,6 +546,8 @@ class ClipLoader:
             self.timeline_in = int(self.data["assetData"]["clipIn"])
             self.timeline_out = int(self.data["assetData"]["clipOut"])
 
+        log.debug("__ self.timeline_in: {}".format(self.timeline_in))
+        log.debug("__ self.timeline_out: {}".format(self.timeline_out))
         # check if slate is included
         # either in version data families or by calculating frame diff
         slate_on = next(
@@ -553,6 +560,7 @@ class ClipLoader:
                 (self.timeline_out - self.timeline_in + 1)
                 + self.handle_start + self.handle_end) < self.media_duration)
 
+        log.debug("__ slate_on: {}".format(slate_on))
         # if slate is on then remove the slate frame from beginning
         if slate_on:
             self.media_duration -= 1
@@ -599,8 +607,8 @@ class Creator(LegacyCreator):
     rename_index = None
 
     def __init__(self, *args, **kwargs):
-        import openpype.hosts.hiero.api as phiero
         super(Creator, self).__init__(*args, **kwargs)
+        import openpype.hosts.hiero.api as phiero
         self.presets = openpype.get_current_project_settings()[
             "hiero"]["create"].get(self.__class__.__name__, {})
 
@@ -609,7 +617,10 @@ class Creator(LegacyCreator):
         self.sequence = phiero.get_current_sequence()
 
         if (self.options or {}).get("useSelection"):
-            self.selected = phiero.get_track_items(selected=True)
+            timeline_selection = phiero.get_timeline_selection()
+            self.selected = phiero.get_track_items(
+                selection=timeline_selection
+            )
         else:
             self.selected = phiero.get_track_items()
 
@@ -716,6 +727,10 @@ class PublishClip:
         else:
             self.tag_data.update({"reviewTrack": None})
 
+        log.debug("___ self.tag_data: {}".format(
+            pformat(self.tag_data)
+        ))
+
         # create pype tag on track_item and add data
         lib.imprint(self.track_item, self.tag_data)
 

From d27448e7e36d751f16b458bde328065706378092 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 20:42:29 +0200
Subject: [PATCH 0301/1227] Hiero: handles and slate detection

- handles should be int
- slate only if in families on version
---
 openpype/hosts/hiero/api/plugin.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/hiero/api/plugin.py b/openpype/hosts/hiero/api/plugin.py
index 174a25102f..e3ec6f3cf1 100644
--- a/openpype/hosts/hiero/api/plugin.py
+++ b/openpype/hosts/hiero/api/plugin.py
@@ -524,9 +524,12 @@ class ClipLoader:
         self.handle_start = self.data["versionData"].get("handleStart")
         self.handle_end = self.data["versionData"].get("handleEnd")
         if self.handle_start is None:
-            self.handle_start = int(self.data["assetData"]["handleStart"])
+            self.handle_start = self.data["assetData"]["handleStart"]
         if self.handle_end is None:
-            self.handle_end = int(self.data["assetData"]["handleEnd"])
+            self.handle_end = self.data["assetData"]["handleEnd"]
+
+        self.handle_start = int(self.handle_start)
+        self.handle_end = int(self.handle_end)
 
         if self.sequencial_load:
             last_track_item = lib.get_track_items(
@@ -556,9 +559,7 @@ class ClipLoader:
              if "slate" in f),
             # if nothing was found then use default None
             # so other bool could be used
-            None) or bool(int(
-                (self.timeline_out - self.timeline_in + 1)
-                + self.handle_start + self.handle_end) < self.media_duration)
+            None)
 
         log.debug("__ slate_on: {}".format(slate_on))
         # if slate is on then remove the slate frame from beginning

From cac79e69031f5c9a0e082ad0b4117ce3b5339a78 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 20:42:53 +0200
Subject: [PATCH 0302/1227] Hiero: fix timewarp lookup to be list

---
 openpype/lib/editorial.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/lib/editorial.py b/openpype/lib/editorial.py
index 1ee21deedc..5fe498bf6a 100644
--- a/openpype/lib/editorial.py
+++ b/openpype/lib/editorial.py
@@ -218,6 +218,7 @@ def get_media_range_with_retimes(otio_clip, handle_start, handle_end):
                 "name": name
             }
             tw_node.update(metadata)
+            tw_node["lookup"] = list(lookup)
 
             # get first and last frame offsets
             offset_in += lookup[0]

From ffe1bff6599e0de5c0e07b30b4878714bd26e91a Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 21:06:11 +0200
Subject: [PATCH 0303/1227] Hiero: fix by reversing validation

---
 openpype/hosts/hiero/api/lib.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index d3e6441705..4dc8d26c2a 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -207,7 +207,7 @@ def get_track_items(
                 if not isinstance(track_item, hiero.core.TrackItem):
                     continue
 
-                if not _validate_all_atrributes(
+                if _validate_all_atrributes(
                     track_item,
                     track_item_name,
                     track_name,
@@ -1046,7 +1046,6 @@ def check_inventory_versions(track_items=None):
     # get all track items from current timeline
     for track_item in track_item:
         container = parse_container(track_item)
-        log.info("___> container: {}".format(pformat(container)))
         if container:
             # get representation from io
             representation = legacy_io.find_one({

From 15726cfef92bb465a794d7ccd3acb8cdc3e828bd Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 21:06:42 +0200
Subject: [PATCH 0304/1227] Hiero: simplify code for slate detection

---
 openpype/hosts/hiero/api/plugin.py | 14 ++++----------
 1 file changed, 4 insertions(+), 10 deletions(-)

diff --git a/openpype/hosts/hiero/api/plugin.py b/openpype/hosts/hiero/api/plugin.py
index e3ec6f3cf1..8c61baa04b 100644
--- a/openpype/hosts/hiero/api/plugin.py
+++ b/openpype/hosts/hiero/api/plugin.py
@@ -551,17 +551,11 @@ class ClipLoader:
 
         log.debug("__ self.timeline_in: {}".format(self.timeline_in))
         log.debug("__ self.timeline_out: {}".format(self.timeline_out))
-        # check if slate is included
-        # either in version data families or by calculating frame diff
-        slate_on = next(
-            # check iterate if slate is in families
-            (f for f in self.context["version"]["data"]["families"]
-             if "slate" in f),
-            # if nothing was found then use default None
-            # so other bool could be used
-            None)
 
+        # check if slate is included
+        slate_on = "slate" in self.context["version"]["data"]["families"]
         log.debug("__ slate_on: {}".format(slate_on))
+
         # if slate is on then remove the slate frame from beginning
         if slate_on:
             self.media_duration -= 1
@@ -581,7 +575,7 @@ class ClipLoader:
         # there were some cases were hiero was not creating it
         source_bin_item = None
         for item in self.active_bin.items():
-            if self.data["clip_name"] in item.name():
+            if self.data["clip_name"] == item.name():
                 source_bin_item = item
         if not source_bin_item:
             log.warning("Problem with created Source clip: `{}`".format(

From 38d4c3fa67effbc25847ee8706c7a1714cfa54a8 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 21:17:14 +0200
Subject: [PATCH 0305/1227] Hiero: lib code refactory

---
 openpype/hosts/hiero/api/lib.py | 37 +++++++++++++--------------------
 1 file changed, 15 insertions(+), 22 deletions(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 4dc8d26c2a..758df43968 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -4,7 +4,6 @@ Host specific functions where host api is connected
 
 import contextlib
 import os
-from pprint import pformat
 import re
 import sys
 import platform
@@ -92,7 +91,7 @@ def get_current_sequence(name=None, new=False):
         if not sequence:
             # if nothing found create new with input name
             sequence = get_current_sequence(name, True)
-    elif not name and not new:
+    else:
         # if name is none and new is False then return current open sequence
         sequence = hiero.ui.activeSequence()
 
@@ -189,7 +188,6 @@ def get_track_items(
                     log.info("___ valid trackitem: {}".format(track_item))
                     return_list.append(track_item)
 
-
     # collect all available active sequence track items
     if not return_list:
         sequence = get_current_sequence(name=sequence_name)
@@ -311,7 +309,7 @@ def set_track_item_pype_tag(track_item, data=None):
         "editable": "0",
         "note": "OpenPype data container",
         "icon": "openpype_icon.png",
-        "metadata": {k: v for k, v in data.items()}
+        "metadata": dict(data.items())
     }
     # get available pype tag if any
     _tag = get_track_item_pype_tag(track_item)
@@ -369,7 +367,7 @@ def get_track_item_pype_data(track_item):
             log.warning(msg)
             value = v
 
-        data.update({key: value})
+        data[key] = value
 
     return data
 
@@ -938,32 +936,32 @@ def apply_colorspace_clips():
 
 
 def is_overlapping(ti_test, ti_original, strict=False):
-    covering_exp = bool(
+    covering_exp = (
         (ti_test.timelineIn() <= ti_original.timelineIn())
         and (ti_test.timelineOut() >= ti_original.timelineOut())
     )
-    inside_exp = bool(
+    inside_exp = (
         (ti_test.timelineIn() >= ti_original.timelineIn())
         and (ti_test.timelineOut() <= ti_original.timelineOut())
     )
-    overlaying_right_exp = bool(
+    overlaying_right_exp = (
         (ti_test.timelineIn() < ti_original.timelineOut())
         and (ti_test.timelineOut() >= ti_original.timelineOut())
     )
-    overlaying_left_exp = bool(
+    overlaying_left_exp = (
         (ti_test.timelineOut() > ti_original.timelineIn())
         and (ti_test.timelineIn() <= ti_original.timelineIn())
     )
 
-    if not strict:
+    if strict:
+        return covering_exp
+    else:
         return any((
             covering_exp,
             inside_exp,
             overlaying_right_exp,
             overlaying_left_exp
         ))
-    else:
-        return covering_exp
 
 
 def get_sequence_pattern_and_padding(file):
@@ -981,17 +979,12 @@ def get_sequence_pattern_and_padding(file):
     """
     foundall = re.findall(
         r"(#+)|(%\d+d)|(?<=[^a-zA-Z0-9])(\d+)(?=\.\w+$)", file)
-    if foundall:
-        found = sorted(list(set(foundall[0])))[-1]
-
-        if "%" in found:
-            padding = int(re.findall(r"\d+", found)[-1])
-        else:
-            padding = len(found)
-
-        return found, padding
-    else:
+    if not foundall:
         return None, None
+    found = sorted(list(set(foundall[0])))[-1]
+
+    padding = int(re.findall(r"\d+", found)[-1]) if "%" in found else len(found)
+    return found, padding
 
 
 def sync_clip_name_to_data_asset(track_items_list):

From 90948931b08dba9e4698ffc45f6a3be307996853 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 19 May 2022 19:49:08 +0200
Subject: [PATCH 0306/1227] Hiero: removing old code


From 61be6857603c8061283bcbed938f07c5bd525eee Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 20 May 2022 12:35:46 +0200
Subject: [PATCH 0307/1227] replaced persistent editors with added ability of
 any edit trigger

---
 .../tools/project_manager/project_manager/view.py     | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/openpype/tools/project_manager/project_manager/view.py b/openpype/tools/project_manager/project_manager/view.py
index 25174232bc..6f5b9dc3f7 100644
--- a/openpype/tools/project_manager/project_manager/view.py
+++ b/openpype/tools/project_manager/project_manager/view.py
@@ -139,6 +139,7 @@ class HierarchyView(QtWidgets.QTreeView):
         self.setAlternatingRowColors(True)
         self.setSelectionMode(HierarchyView.ExtendedSelection)
         self.setContextMenuPolicy(QtCore.Qt.CustomContextMenu)
+        self.setEditTriggers(HierarchyView.AllEditTriggers)
 
         column_delegates = {}
         column_key_to_index = {}
@@ -301,16 +302,6 @@ class HierarchyView(QtWidgets.QTreeView):
     def rowsInserted(self, parent_index, start, end):
         super(HierarchyView, self).rowsInserted(parent_index, start, end)
 
-        for row in range(start, end + 1):
-            for key, column in self._column_key_to_index.items():
-                if key not in self.persistent_columns:
-                    continue
-                col_index = self._source_model.index(row, column, parent_index)
-                if bool(
-                    self._source_model.flags(col_index)
-                    & QtCore.Qt.ItemIsEditable
-                ):
-                    self.openPersistentEditor(col_index)
 
         # Expand parent on insert
         if not self.isExpanded(parent_index):

From 7c3fdcc633f80b73084b0fbf4ba6f51d4c8c8a71 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 20 May 2022 12:59:38 +0200
Subject: [PATCH 0308/1227] Hiero: tag should use deepcopy for metadata

---
 openpype/hosts/hiero/api/lib.py  | 7 ++++---
 openpype/hosts/hiero/api/tags.py | 2 +-
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 758df43968..5b2f6c814d 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -3,6 +3,7 @@ Host specific functions where host api is connected
 """
 
 import contextlib
+from copy import deepcopy
 import os
 import re
 import sys
@@ -288,7 +289,7 @@ def get_track_item_pype_tag(track_item):
         return None
     for tag in _tags:
         # return only correct tag defined by global name
-        if tag.name() in self.pype_tag_name:
+        if tag.name() == self.pype_tag_name:
             return tag
 
 
@@ -344,9 +345,9 @@ def get_track_item_pype_data(track_item):
         return None
 
     # get tag metadata attribute
-    tag_data = tag.metadata()
+    tag_data = deepcopy(dict(tag.metadata()))
     # convert tag metadata to normal keys names and values to correct types
-    for k, v in dict(tag_data).items():
+    for k, v in tag_data.items():
         key = k.replace("tag.", "")
 
         try:
diff --git a/openpype/hosts/hiero/api/tags.py b/openpype/hosts/hiero/api/tags.py
index 8877b92b9d..8c6ff2a77b 100644
--- a/openpype/hosts/hiero/api/tags.py
+++ b/openpype/hosts/hiero/api/tags.py
@@ -86,7 +86,7 @@ def update_tag(tag, data):
 
     # due to hiero bug we have to make sure keys which are not existent in
     # data are cleared of value by `None`
-    for _mk in mtd.keys():
+    for _mk in mtd.dict().keys():
         if _mk.replace("tag.", "") not in data_mtd.keys():
             mtd.setValue(_mk, str(None))
 

From be9f6cf5c5ddd7e833f5dd5c31e690706767e493 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 20 May 2022 15:08:56 +0200
Subject: [PATCH 0309/1227] Hiero: frame difference issue

---
 openpype/hosts/hiero/api/otio/hiero_export.py             | 2 +-
 openpype/hosts/hiero/api/plugin.py                        | 2 +-
 openpype/lib/editorial.py                                 | 2 +-
 openpype/plugins/publish/collect_otio_frame_ranges.py     | 8 ++++----
 openpype/plugins/publish/collect_otio_subset_resources.py | 2 +-
 5 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/hiero/api/otio/hiero_export.py b/openpype/hosts/hiero/api/otio/hiero_export.py
index 46e1204324..1e4088d9c0 100644
--- a/openpype/hosts/hiero/api/otio/hiero_export.py
+++ b/openpype/hosts/hiero/api/otio/hiero_export.py
@@ -277,7 +277,7 @@ def create_otio_clip(track_item):
     # flip if speed is in minus
     source_in = track_item.sourceIn() if speed > 0 else track_item.sourceOut()
 
-    duration = int(track_item.duration()) - 1
+    duration = int(track_item.duration())
 
     fps = utils.get_rate(track_item) or self.project_fps
     name = track_item.name()
diff --git a/openpype/hosts/hiero/api/plugin.py b/openpype/hosts/hiero/api/plugin.py
index 8c61baa04b..add416d04e 100644
--- a/openpype/hosts/hiero/api/plugin.py
+++ b/openpype/hosts/hiero/api/plugin.py
@@ -504,7 +504,7 @@ class ClipLoader:
         track_item.setSource(clip)
         track_item.setSourceIn(self.handle_start)
         track_item.setTimelineIn(self.timeline_in)
-        track_item.setSourceOut((self.media_duration + 1) - self.handle_end)
+        track_item.setSourceOut((self.media_duration) - self.handle_end)
         track_item.setTimelineOut(self.timeline_out)
         track_item.setPlaybackSpeed(1)
         self.active_track.addTrackItem(track_item)
diff --git a/openpype/lib/editorial.py b/openpype/lib/editorial.py
index 5fe498bf6a..2c877b9d0d 100644
--- a/openpype/lib/editorial.py
+++ b/openpype/lib/editorial.py
@@ -255,7 +255,7 @@ def get_media_range_with_retimes(otio_clip, handle_start, handle_end):
         media_in + source_in + offset_in)
     media_out_trimmed = (
         media_in + source_in + (
-            (source_range.duration.value * abs(
+            ((source_range.duration.value - 1) * abs(
                 time_scalar)) + offset_out))
 
     # calculate available handles
diff --git a/openpype/plugins/publish/collect_otio_frame_ranges.py b/openpype/plugins/publish/collect_otio_frame_ranges.py
index ee7b7957ad..8eaf9d6f29 100644
--- a/openpype/plugins/publish/collect_otio_frame_ranges.py
+++ b/openpype/plugins/publish/collect_otio_frame_ranges.py
@@ -55,13 +55,13 @@ class CollectOtioFrameRanges(pyblish.api.InstancePlugin):
             "frameStart": frame_start,
             "frameEnd": frame_end,
             "clipIn": tl_start,
-            "clipOut": tl_end,
+            "clipOut": tl_end - 1,
             "clipInH": tl_start_h,
-            "clipOutH": tl_end_h,
+            "clipOutH": tl_end_h - 1,
             "sourceStart": src_starting_from + src_start,
-            "sourceEnd": src_starting_from + src_end,
+            "sourceEnd": src_starting_from + src_end - 1,
             "sourceStartH": src_starting_from + src_start_h,
-            "sourceEndH": src_starting_from + src_end_h,
+            "sourceEndH": src_starting_from + src_end_h - 1,
         }
         instance.data.update(data)
         self.log.debug(
diff --git a/openpype/plugins/publish/collect_otio_subset_resources.py b/openpype/plugins/publish/collect_otio_subset_resources.py
index 7c11462ef0..b89a076a44 100644
--- a/openpype/plugins/publish/collect_otio_subset_resources.py
+++ b/openpype/plugins/publish/collect_otio_subset_resources.py
@@ -66,7 +66,7 @@ class CollectOtioSubsetResources(pyblish.api.InstancePlugin):
 
         # create trimmed otio time range
         trimmed_media_range_h = editorial.range_from_frames(
-            a_frame_start_h, (a_frame_end_h - a_frame_start_h + 1),
+            a_frame_start_h, (a_frame_end_h - a_frame_start_h) + 1,
             media_fps
         )
         trimmed_duration = trimmed_media_range_h.duration.value

From f35079aaed7eb74ccca74645c800d20d8f225801 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 20 May 2022 16:18:39 +0200
Subject: [PATCH 0310/1227] global: remove exclude family for `clip`

---
 openpype/plugins/publish/integrate_new.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index bf13a4050e..353314fff2 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -113,7 +113,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "usdOverride",
                 "simpleUnrealTexture"
                 ]
-    exclude_families = ["clip", "render.farm"]
+    exclude_families = ["render.farm"]
     db_representation_context_keys = [
         "project", "asset", "task", "subset", "version", "representation",
         "family", "hierarchy", "task", "username"

From 87182f5a3e66cbae791f49c2f8cc0692f8dff3bf Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 20 May 2022 17:00:48 +0200
Subject: [PATCH 0311/1227] global: otio duration is one frame longer

---
 openpype/plugins/publish/extract_otio_trimming_video.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_otio_trimming_video.py b/openpype/plugins/publish/extract_otio_trimming_video.py
index 30b57e2c69..e8e2994f36 100644
--- a/openpype/plugins/publish/extract_otio_trimming_video.py
+++ b/openpype/plugins/publish/extract_otio_trimming_video.py
@@ -80,7 +80,7 @@ class ExtractOTIOTrimmingVideo(openpype.api.Extractor):
         video_path = input_file_path
         frame_start = otio_range.start_time.value
         input_fps = otio_range.start_time.rate
-        frame_duration = (otio_range.duration.value + 1)
+        frame_duration = otio_range.duration.value - 1
         sec_start = openpype.lib.frames_to_secons(frame_start, input_fps)
         sec_duration = openpype.lib.frames_to_secons(frame_duration, input_fps)
 

From 7b65184389640165d7268996dc069600722fe60f Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 20 May 2022 17:45:15 +0200
Subject: [PATCH 0312/1227] OP-2787 - replaced target farm with remote

Target farm is being used for rendering, this should better differentiate it.
---
 openpype/hosts/maya/api/pipeline.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index b75af29523..c2fe8a95a5 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -73,8 +73,8 @@ def install():
                  "save/open/new callback installation.."))
 
         # Register default "local" target
-        print("Registering pyblish target: farm")
-        pyblish.api.register_target("farm")
+        print("Registering pyblish target: remote")
+        pyblish.api.register_target("remote")
         return
 
     print("Registering pyblish target: local")

From c3e13a9e198a7082439588d6b3f6550bbdf98675 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 20 May 2022 18:07:26 +0200
Subject: [PATCH 0313/1227] modules have ability to modify environments before
 launch

---
 openpype/lib/applications.py | 33 ++++++++++++++++++++++++++++-----
 openpype/modules/base.py     | 19 +++++++++++++++++++
 2 files changed, 47 insertions(+), 5 deletions(-)

diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index 6ade33b59c..a81bdeca0f 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -1282,7 +1282,13 @@ class EnvironmentPrepData(dict):
 
 
 def get_app_environments_for_context(
-    project_name, asset_name, task_name, app_name, env_group=None, env=None
+    project_name,
+    asset_name,
+    task_name,
+    app_name,
+    env_group=None,
+    env=None,
+    modules_manager=None
 ):
     """Prepare environment variables by context.
     Args:
@@ -1293,10 +1299,12 @@ def get_app_environments_for_context(
             by ApplicationManager.
         env (dict): Initial environment variables. `os.environ` is used when
             not passed.
+        modules_manager (ModulesManager): Initialized modules manager.
 
     Returns:
         dict: Environments for passed context and application.
     """
+
     from openpype.pipeline import AvalonMongoDB
 
     # Avalon database connection
@@ -1311,6 +1319,11 @@ def get_app_environments_for_context(
         "name": asset_name
     })
 
+    if modules_manager is None:
+        from openpype.modules import ModulesManager
+
+        modules_manager = ModulesManager()
+
     # Prepare app object which can be obtained only from ApplciationManager
     app_manager = ApplicationManager()
     app = app_manager.applications[app_name]
@@ -1334,7 +1347,7 @@ def get_app_environments_for_context(
         "env": env
     })
 
-    prepare_app_environments(data, env_group)
+    prepare_app_environments(data, env_group, modules_manager)
     prepare_context_environments(data, env_group)
 
     # Discard avalon connection
@@ -1355,9 +1368,12 @@ def _merge_env(env, current_env):
     return result
 
 
-def _add_python_version_paths(app, env, logger):
+def _add_python_version_paths(app, env, logger, modules_manager):
     """Add vendor packages specific for a Python version."""
 
+    for module in modules_manager.get_enabled_modules():
+        module.modify_application_launch_arguments(app, env)
+
     # Skip adding if host name is not set
     if not app.host_name:
         return
@@ -1390,7 +1406,9 @@ def _add_python_version_paths(app, env, logger):
     env["PYTHONPATH"] = os.pathsep.join(python_paths)
 
 
-def prepare_app_environments(data, env_group=None, implementation_envs=True):
+def prepare_app_environments(
+    data, env_group=None, implementation_envs=True, modules_manager=None
+):
     """Modify launch environments based on launched app and context.
 
     Args:
@@ -1403,7 +1421,12 @@ def prepare_app_environments(data, env_group=None, implementation_envs=True):
     log = data["log"]
     source_env = data["env"].copy()
 
-    _add_python_version_paths(app, source_env, log)
+    if modules_manager is None:
+        from openpype.modules import ModulesManager
+
+        modules_manager = ModulesManager()
+
+    _add_python_version_paths(app, source_env, log, modules_manager)
 
     # Use environments from local settings
     filtered_local_envs = {}
diff --git a/openpype/modules/base.py b/openpype/modules/base.py
index 5b49649359..d591df6768 100644
--- a/openpype/modules/base.py
+++ b/openpype/modules/base.py
@@ -370,6 +370,7 @@ def _load_modules():
 
 class _OpenPypeInterfaceMeta(ABCMeta):
     """OpenPypeInterface meta class to print proper string."""
+
     def __str__(self):
         return "<'OpenPypeInterface.{}'>".format(self.__name__)
 
@@ -388,6 +389,7 @@ class OpenPypeInterface:
     OpenPype modules which means they have to have implemented methods defined
     in the interface. By default interface does not have any abstract parts.
     """
+
     pass
 
 
@@ -432,10 +434,12 @@ class OpenPypeModule:
         It is not recommended to override __init__ that's why specific method
         was implemented.
         """
+
         pass
 
     def connect_with_modules(self, enabled_modules):
         """Connect with other enabled modules."""
+
         pass
 
     def get_global_environments(self):
@@ -443,8 +447,22 @@ class OpenPypeModule:
 
         Environment variables that can be get only from system settings.
         """
+
         return {}
 
+    def modify_application_launch_arguments(self, app, env):
+        """Give option to modify launch environments before application launch.
+
+        Implementation is optional. To change environments modify passed
+        dictionary of environments.
+
+        Args:
+            app (Application): Application that is launcher.
+            env (dict): Current environemnt variables.
+        """
+
+        pass
+
     def cli(self, module_click_group):
         """Add commands to click group.
 
@@ -465,6 +483,7 @@ class OpenPypeModule:
         def mycommand():
             print("my_command")
         """
+
         pass
 
 

From 6fc240734c799a37c349f7a6e8945f7feea50ab5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 20 May 2022 18:10:40 +0200
Subject: [PATCH 0314/1227] ftrack module modify application launch
 environments in module instead of in prelaunch hook

---
 openpype/modules/base.py                      |  4 +-
 openpype/modules/ftrack/ftrack_module.py      | 34 +++++++++++++++
 .../ftrack/launch_hooks/pre_python2_vendor.py | 43 -------------------
 3 files changed, 36 insertions(+), 45 deletions(-)
 delete mode 100644 openpype/modules/ftrack/launch_hooks/pre_python2_vendor.py

diff --git a/openpype/modules/base.py b/openpype/modules/base.py
index d591df6768..96c1b84a54 100644
--- a/openpype/modules/base.py
+++ b/openpype/modules/base.py
@@ -450,14 +450,14 @@ class OpenPypeModule:
 
         return {}
 
-    def modify_application_launch_arguments(self, app, env):
+    def modify_application_launch_arguments(self, application, env):
         """Give option to modify launch environments before application launch.
 
         Implementation is optional. To change environments modify passed
         dictionary of environments.
 
         Args:
-            app (Application): Application that is launcher.
+            application (Application): Application that is launched.
             env (dict): Current environemnt variables.
         """
 
diff --git a/openpype/modules/ftrack/ftrack_module.py b/openpype/modules/ftrack/ftrack_module.py
index 5c38df2e03..f99e189082 100644
--- a/openpype/modules/ftrack/ftrack_module.py
+++ b/openpype/modules/ftrack/ftrack_module.py
@@ -88,6 +88,40 @@ class FtrackModule(
         """Implementation of `ILaunchHookPaths`."""
         return os.path.join(FTRACK_MODULE_DIR, "launch_hooks")
 
+    def modify_application_launch_arguments(self, application, env):
+        if not application.use_python_2:
+            return
+
+        self.log.info("Adding Ftrack Python 2 packages to PYTHONPATH.")
+
+        # Prepare vendor dir path
+        python_2_vendor = os.path.join(FTRACK_MODULE_DIR, "python2_vendor")
+
+        # Add Python 2 modules
+        python_paths = [
+            # `python-ftrack-api`
+            os.path.join(python_2_vendor, "ftrack-python-api", "source"),
+            # `arrow`
+            os.path.join(python_2_vendor, "arrow"),
+            # `builtins` from `python-future`
+            # - `python-future` is strict Python 2 module that cause crashes
+            #   of Python 3 scripts executed through OpenPype
+            #   (burnin script etc.)
+            os.path.join(python_2_vendor, "builtins"),
+            # `backports.functools_lru_cache`
+            os.path.join(
+                python_2_vendor, "backports.functools_lru_cache"
+            )
+        ]
+
+        # Load PYTHONPATH from current launch context
+        python_path = env.get("PYTHONPATH")
+        if python_path:
+            python_paths.append(python_path)
+
+        # Set new PYTHONPATH to launch context environments
+        env["PYTHONPATH"] = os.pathsep.join(python_paths)
+
     def connect_with_modules(self, enabled_modules):
         for module in enabled_modules:
             if not hasattr(module, "get_ftrack_event_handler_paths"):
diff --git a/openpype/modules/ftrack/launch_hooks/pre_python2_vendor.py b/openpype/modules/ftrack/launch_hooks/pre_python2_vendor.py
deleted file mode 100644
index 0dd894bebf..0000000000
--- a/openpype/modules/ftrack/launch_hooks/pre_python2_vendor.py
+++ /dev/null
@@ -1,43 +0,0 @@
-import os
-from openpype.lib import PreLaunchHook
-from openpype_modules.ftrack import FTRACK_MODULE_DIR
-
-
-class PrePython2Support(PreLaunchHook):
-    """Add python ftrack api module for Python 2 to PYTHONPATH.
-
-    Path to vendor modules is added to the beggining of PYTHONPATH.
-    """
-
-    def execute(self):
-        if not self.application.use_python_2:
-            return
-
-        self.log.info("Adding Ftrack Python 2 packages to PYTHONPATH.")
-
-        # Prepare vendor dir path
-        python_2_vendor = os.path.join(FTRACK_MODULE_DIR, "python2_vendor")
-
-        # Add Python 2 modules
-        python_paths = [
-            # `python-ftrack-api`
-            os.path.join(python_2_vendor, "ftrack-python-api", "source"),
-            # `arrow`
-            os.path.join(python_2_vendor, "arrow"),
-            # `builtins` from `python-future`
-            # - `python-future` is strict Python 2 module that cause crashes
-            #   of Python 3 scripts executed through OpenPype (burnin script etc.)
-            os.path.join(python_2_vendor, "builtins"),
-            # `backports.functools_lru_cache`
-            os.path.join(
-                python_2_vendor, "backports.functools_lru_cache"
-            )
-        ]
-
-        # Load PYTHONPATH from current launch context
-        python_path = self.launch_context.env.get("PYTHONPATH")
-        if python_path:
-            python_paths.append(python_path)
-
-        # Set new PYTHONPATH to launch context environments
-        self.launch_context.env["PYTHONPATH"] = os.pathsep.join(python_paths)

From feb07912c50728054a5078c23a870f445969f947 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 20 May 2022 18:27:50 +0200
Subject: [PATCH 0315/1227] Fix yeti publish and load for caches

---
 .../maya/plugins/load/load_yeti_cache.py      | 244 +++++++++---------
 .../plugins/publish/extract_yeti_cache.py     |  38 +--
 .../maya/plugins/publish/extract_yeti_rig.py  |   4 +-
 3 files changed, 146 insertions(+), 140 deletions(-)

diff --git a/openpype/hosts/maya/plugins/load/load_yeti_cache.py b/openpype/hosts/maya/plugins/load/load_yeti_cache.py
index fb903785ae..9752188551 100644
--- a/openpype/hosts/maya/plugins/load/load_yeti_cache.py
+++ b/openpype/hosts/maya/plugins/load/load_yeti_cache.py
@@ -1,15 +1,13 @@
 import os
 import json
 import re
-import glob
 from collections import defaultdict
-from pprint import pprint
 
+import clique
 from maya import cmds
 
 from openpype.api import get_project_settings
 from openpype.pipeline import (
-    legacy_io,
     load,
     get_representation_path
 )
@@ -17,7 +15,15 @@ from openpype.hosts.maya.api import lib
 from openpype.hosts.maya.api.pipeline import containerise
 
 
+def set_attribute(node, attr, value):
+    """Wrapper of set attribute which ignores None values"""
+    if value is None:
+        return
+    lib.set_attribute(node, attr, value)
+
+
 class YetiCacheLoader(load.LoaderPlugin):
+    """Load Yeti Cache with one or more Yeti nodes"""
 
     families = ["yeticache", "yetiRig"]
     representations = ["fur"]
@@ -28,6 +34,16 @@ class YetiCacheLoader(load.LoaderPlugin):
     color = "orange"
 
     def load(self, context, name=None, namespace=None, data=None):
+        """Loads a .fursettings file defining how to load .fur sequences
+
+        A single yeticache or yetiRig can have more than a single pgYetiMaya
+        nodes and thus load more than a single yeti.fur sequence.
+
+        The .fursettings file defines what the node names should be and also
+        what "cbId" attribute they should receive to match the original source
+        and allow published looks to also work for Yeti rigs and its caches.
+
+        """
 
         try:
             family = context["representation"]["context"]["family"]
@@ -43,22 +59,11 @@ class YetiCacheLoader(load.LoaderPlugin):
         if not cmds.pluginInfo("pgYetiMaya", query=True, loaded=True):
             cmds.loadPlugin("pgYetiMaya", quiet=True)
 
-        # Get JSON
-        fbase = re.search(r'^(.+)\.(\d+|#+)\.fur', self.fname)
-        if not fbase:
-            raise RuntimeError('Cannot determine fursettings file path')
-        settings_fname = "{}.fursettings".format(fbase.group(1))
-        with open(settings_fname, "r") as fp:
-            fursettings = json.load(fp)
-
-        # Check if resources map exists
-        # Get node name from JSON
-        if "nodes" not in fursettings:
-            raise RuntimeError("Encountered invalid data, expect 'nodes' in "
-                               "fursettings.")
-
-        node_data = fursettings["nodes"]
-        nodes = self.create_nodes(namespace, node_data)
+        # Create Yeti cache nodes according to settings
+        settings = self.read_settings(self.fname)
+        nodes = []
+        for node in settings["nodes"]:
+            nodes.extend(self.create_node(namespace, node))
 
         group_name = "{}:{}".format(namespace, name)
         group_node = cmds.group(nodes, name=group_name)
@@ -111,28 +116,14 @@ class YetiCacheLoader(load.LoaderPlugin):
 
     def update(self, container, representation):
 
-        legacy_io.install()
         namespace = container["namespace"]
         container_node = container["objectName"]
 
-        fur_settings = legacy_io.find_one(
-            {"parent": representation["parent"], "name": "fursettings"}
-        )
-
-        pprint({"parent": representation["parent"], "name": "fursettings"})
-        pprint(fur_settings)
-        assert fur_settings is not None, (
-            "cannot find fursettings representation"
-        )
-
-        settings_fname = get_representation_path(fur_settings)
         path = get_representation_path(representation)
-        # Get all node data
-        with open(settings_fname, "r") as fp:
-            settings = json.load(fp)
+        settings = self.read_settings(path)
 
         # Collect scene information of asset
-        set_members = cmds.sets(container["objectName"], query=True)
+        set_members = lib.get_container_members(container)
         container_root = lib.get_container_transforms(container,
                                                       members=set_members,
                                                       root=True)
@@ -147,7 +138,7 @@ class YetiCacheLoader(load.LoaderPlugin):
         # Re-assemble metadata with cbId as keys
         meta_data_lookup = {n["cbId"]: n for n in settings["nodes"]}
 
-        # Compare look ups and get the nodes which ar not relevant any more
+        # Delete nodes by "cbId" that are not in the updated version
         to_delete_lookup = {cb_id for cb_id in scene_lookup.keys() if
                             cb_id not in meta_data_lookup}
         if to_delete_lookup:
@@ -163,25 +154,18 @@ class YetiCacheLoader(load.LoaderPlugin):
                                                 fullPath=True) or []
                 to_remove.extend(shapes + transforms)
 
-                # Remove id from look uop
+                # Remove id from lookup
                 scene_lookup.pop(_id, None)
 
             cmds.delete(to_remove)
 
-        # replace frame in filename with %04d
-        RE_frame = re.compile(r"(\d+)(\.fur)$")
-        file_name = re.sub(RE_frame, r"%04d\g<2>", os.path.basename(path))
-        for cb_id, data in meta_data_lookup.items():
-
-            # Update cache file name
-            data["attrs"]["cacheFileName"] = os.path.join(
-                os.path.dirname(path), file_name)
+        for cb_id, node_settings in meta_data_lookup.items():
 
             if cb_id not in scene_lookup:
-
+                # Create new nodes
                 self.log.info("Creating new nodes ..")
 
-                new_nodes = self.create_nodes(namespace, [data])
+                new_nodes = self.create_node(namespace, node_settings)
                 cmds.sets(new_nodes, addElement=container_node)
                 cmds.parent(new_nodes, container_root)
 
@@ -218,14 +202,8 @@ class YetiCacheLoader(load.LoaderPlugin):
                                                     children=True)
                     yeti_node = yeti_nodes[0]
 
-                    for attr, value in data["attrs"].items():
-                        # handle empty attribute strings. Those are reported
-                        # as None, so their type is NoneType and this is not
-                        # supported on attributes in Maya. We change it to
-                        # empty string.
-                        if value is None:
-                            value = ""
-                        lib.set_attribute(attr, value, yeti_node)
+                    for attr, value in node_settings["attrs"].items():
+                        set_attribute(attr, value, yeti_node)
 
         cmds.setAttr("{}.representation".format(container_node),
                      str(representation["_id"]),
@@ -235,7 +213,6 @@ class YetiCacheLoader(load.LoaderPlugin):
         self.update(container, representation)
 
     # helper functions
-
     def create_namespace(self, asset):
         """Create a unique namespace
         Args:
@@ -253,100 +230,129 @@ class YetiCacheLoader(load.LoaderPlugin):
 
         return namespace
 
-    def validate_cache(self, filename, pattern="%04d"):
-        """Check if the cache has more than 1 frame
+    def get_cache_node_filepath(self, root, node_name):
+        """Get the cache file path for one of the yeti nodes.
 
-        All caches with more than 1 frame need to be called with `%04d`
-        If the cache has only one frame we return that file name as we assume
+        All caches with more than 1 frame need cache file name set with `%04d`
+        If the cache has only one frame we return the file name as we assume
         it is a snapshot.
 
+        This expects the files to be named after the "node name" through
+        exports with <Name> in Yeti.
+
         Args:
-            filename(str)
-            pattern(str)
+            root(str): Folder containing cache files to search in.
+            node_name(str): Node name to search cache files for
 
         Returns:
-            str
+            str: Cache file path value needed for cacheFileName attribute
 
         """
 
-        glob_pattern = filename.replace(pattern, "*")
+        name = node_name.replace(":", "_")
+        pattern = r"^({name})(\.[0-4]+)?(\.fur)$".format(name=re.escape(name))
 
-        escaped = re.escape(filename)
-        re_pattern = escaped.replace(pattern, "-?[0-9]+")
-
-        files = glob.glob(glob_pattern)
-        files = [str(f) for f in files if re.match(re_pattern, f)]
+        files = [fname for fname in os.listdir(root) if re.match(pattern,
+                                                                 fname)]
+        if not files:
+            self.log.error("Could not find cache files for '{}' "
+                           "with pattern {}".format(node_name, pattern))
+            return
 
         if len(files) == 1:
-            return files[0]
-        elif len(files) == 0:
-            self.log.error("Could not find cache files for '%s'" % filename)
+            # Single file
+            return os.path.join(root, files[0])
 
-        return filename
+        # Get filename for the sequence with padding
+        collections, remainder = clique.assemble(files)
+        assert not remainder, "This is a bug"
+        assert len(collections) == 1, "This is a bug"
+        collection = collections[0]
 
-    def create_nodes(self, namespace, settings):
+        # Assume padding from the first frame since clique returns 0 if the
+        # sequence contains no files padded with a zero at the start (e.g.
+        # a sequence starting at 1001)
+        padding = len(str(collection.indexes[0]))
+
+        fname = "{head}%0{padding}d{tail}".format(collection.head,
+                                                  padding,
+                                                  collection.tail)
+
+        return os.path.join(root, fname)
+
+    def create_node(self, namespace, node_settings):
         """Create nodes with the correct namespace and settings
 
         Args:
             namespace(str): namespace
-            settings(list): list of dictionaries
+            node_settings(dict): Single "nodes" entry from .fursettings file.
 
         Returns:
-             list
+             list: Created nodes
 
         """
-
         nodes = []
-        for node_settings in settings:
 
-            # Create pgYetiMaya node
-            original_node = node_settings["name"]
-            node_name = "{}:{}".format(namespace, original_node)
-            yeti_node = cmds.createNode("pgYetiMaya", name=node_name)
+        # Get original names and ids
+        orig_transform_name = node_settings["transform"]["name"]
+        orig_shape_name = node_settings["name"]
 
-            # Create transform node
-            transform_node = node_name.rstrip("Shape")
+        # Add namespace
+        transform_name = "{}:{}".format(namespace, orig_transform_name)
+        shape_name = "{}:{}".format(namespace, orig_shape_name)
 
-            lib.set_id(transform_node, node_settings["transform"]["cbId"])
-            lib.set_id(yeti_node, node_settings["cbId"])
+        # Create pgYetiMaya node
+        transform_node = cmds.createNode("transform",
+                                         name=transform_name)
+        yeti_node = cmds.createNode("pgYetiMaya",
+                                    name=shape_name,
+                                    parent=transform_node)
 
-            nodes.extend([transform_node, yeti_node])
+        lib.set_id(transform_node, node_settings["transform"]["cbId"])
+        lib.set_id(yeti_node, node_settings["cbId"])
 
-            # Ensure the node has no namespace identifiers
-            attributes = node_settings["attrs"]
+        nodes.extend([transform_node, yeti_node])
 
-            # Check if cache file name is stored
+        # Update attributes with defaults
+        attributes = node_settings["attrs"]
+        attributes.update({
+            "viewportDensity": 0.1,
+            "verbosity": 2,
+            "fileMode": 1,
 
-            # get number of # in path and convert it to C prinf format
-            # like %04d expected by Yeti
-            fbase = re.search(r'^(.+)\.(\d+|#+)\.fur', self.fname)
-            if not fbase:
-                raise RuntimeError('Cannot determine file path')
-            padding = len(fbase.group(2))
-            if "cacheFileName" not in attributes:
-                cache = "{}.%0{}d.fur".format(fbase.group(1), padding)
+            # Fix render stats, like Yeti's own
+            # ../scripts/pgYetiNode.mel script
+            "visibleInReflections": True,
+            "visibleInRefractions": True
+        })
 
-                self.validate_cache(cache)
-                attributes["cacheFileName"] = cache
+        # Apply attributes to pgYetiMaya node
+        for attr, value in attributes.items():
+            set_attribute(attr, value, yeti_node)
 
-            # Update attributes with requirements
-            attributes.update({"viewportDensity": 0.1,
-                               "verbosity": 2,
-                               "fileMode": 1})
-
-            # Apply attributes to pgYetiMaya node
-            for attr, value in attributes.items():
-                if value is None:
-                    continue
-                lib.set_attribute(attr, value, yeti_node)
-
-            # Fix for : YETI-6
-            # Fixes the render stats (this is literally taken from Perigrene's
-            # ../scripts/pgYetiNode.mel script)
-            cmds.setAttr("{}.visibleInReflections".format(yeti_node), True)
-            cmds.setAttr("{}.visibleInRefractions".format(yeti_node), True)
-
-            # Connect to the time node
-            cmds.connectAttr("time1.outTime", "%s.currentTime" % yeti_node)
+        # Connect to the time node
+        cmds.connectAttr("time1.outTime", "%s.currentTime" % yeti_node)
 
         return nodes
+
+    def read_settings(self, path):
+        """Read .fursettings file and compute some additional attributes"""
+
+        with open(path, "r") as fp:
+            fur_settings = json.load(fp)
+
+        if "nodes" not in fur_settings:
+            raise RuntimeError("Encountered invalid data, "
+                               "expected 'nodes' in fursettings.")
+
+        # Compute the cache file name values we want to set for the nodes
+        root = os.path.dirname(path)
+        for node in fur_settings["nodes"]:
+            cache_filename = self.get_cache_node_filepath(
+                root=root, node_name=node["name"])
+
+            attrs = node.get("attrs", {})       # allow 'attrs' to not exist
+            attrs["cacheFileName"] = cache_filename
+            node["attrs"] = attrs
+
+        return fur_settings
diff --git a/openpype/hosts/maya/plugins/publish/extract_yeti_cache.py b/openpype/hosts/maya/plugins/publish/extract_yeti_cache.py
index b0a60b77f4..cf6db00e9a 100644
--- a/openpype/hosts/maya/plugins/publish/extract_yeti_cache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_yeti_cache.py
@@ -25,9 +25,6 @@ class ExtractYetiCache(openpype.api.Extractor):
         # Define extract output file path
         dirname = self.staging_dir(instance)
 
-        # Yeti related staging dirs
-        data_file = os.path.join(dirname, "yeti.fursettings")
-
         # Collect information for writing cache
         start_frame = instance.data["frameStartHandle"]
         end_frame = instance.data["frameEndHandle"]
@@ -57,32 +54,35 @@ class ExtractYetiCache(openpype.api.Extractor):
         cache_files = [x for x in os.listdir(dirname) if x.endswith(".fur")]
 
         self.log.info("Writing metadata file")
-        settings = instance.data.get("fursettings", None)
-        if settings is not None:
-            with open(data_file, "w") as fp:
-                json.dump(settings, fp, ensure_ascii=False)
+        settings = instance.data["fursettings"]
+        fursettings_path = os.path.join(dirname, "yeti.fursettings")
+        with open(fursettings_path, "w") as fp:
+            json.dump(settings, fp, ensure_ascii=False)
 
         # build representations
         if "representations" not in instance.data:
             instance.data["representations"] = []
 
         self.log.info("cache files: {}".format(cache_files[0]))
-        instance.data["representations"].append(
-            {
-                'name': 'fur',
-                'ext': 'fur',
-                'files': cache_files[0] if len(cache_files) == 1 else cache_files,
-                'stagingDir': dirname,
-                'frameStart': int(start_frame),
-                'frameEnd': int(end_frame)
-            }
-        )
+
+        # Workaround: We do not explicitly register these files with the
+        # representation solely so that we can write multiple sequences
+        # a single Subset without renaming - it's a bit of a hack
+        # TODO: Implement better way to manage this sort of integration
+        if 'transfers' not in instance.data:
+            instance.data['transfers'] = []
+
+        publish_dir = instance.data["publishDir"]
+        for cache_filename in cache_files:
+            src = os.path.join(dirname, cache_filename)
+            dst = os.path.join(publish_dir, os.path.basename(cache_filename))
+            instance.data['transfers'].append([src, dst])
 
         instance.data["representations"].append(
             {
-                'name': 'fursettings',
+                'name': 'fur',
                 'ext': 'fursettings',
-                'files': os.path.basename(data_file),
+                'files': os.path.basename(fursettings_path),
                 'stagingDir': dirname
             }
         )
diff --git a/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py b/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py
index f981c4fe50..6e21bffa4e 100644
--- a/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py
+++ b/openpype/hosts/maya/plugins/publish/extract_yeti_rig.py
@@ -124,8 +124,8 @@ class ExtractYetiRig(openpype.api.Extractor):
         settings_path = os.path.join(dirname, "yeti.rigsettings")
 
         # Yeti related staging dirs
-        maya_path = os.path.join(
-            dirname, "yeti_rig.{}".format(self.scene_type))
+        maya_path = os.path.join(dirname,
+                                 "yeti_rig.{}".format(self.scene_type))
 
         self.log.info("Writing metadata file")
 

From 87f7fa5470ed5fb74433633810bf379d92a3b58e Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 20 May 2022 18:32:02 +0200
Subject: [PATCH 0316/1227] Format name correctly for sequences on load

---
 openpype/hosts/maya/plugins/load/load_yeti_cache.py | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/maya/plugins/load/load_yeti_cache.py b/openpype/hosts/maya/plugins/load/load_yeti_cache.py
index 9752188551..8435ba2493 100644
--- a/openpype/hosts/maya/plugins/load/load_yeti_cache.py
+++ b/openpype/hosts/maya/plugins/load/load_yeti_cache.py
@@ -269,15 +269,8 @@ class YetiCacheLoader(load.LoaderPlugin):
         assert len(collections) == 1, "This is a bug"
         collection = collections[0]
 
-        # Assume padding from the first frame since clique returns 0 if the
-        # sequence contains no files padded with a zero at the start (e.g.
-        # a sequence starting at 1001)
-        padding = len(str(collection.indexes[0]))
-
-        fname = "{head}%0{padding}d{tail}".format(collection.head,
-                                                  padding,
-                                                  collection.tail)
-
+        # Formats name as {head}%d{tail} like cache.%04d.fur
+        fname = collection.format("{head}{padding}{tail}")
         return os.path.join(root, fname)
 
     def create_node(self, namespace, node_settings):

From 38d58182fc9f7d908eca61ab573b7562d1e8af97 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 20 May 2022 18:44:11 +0200
Subject: [PATCH 0317/1227] OP-2787 - added updating of script url

Remote publish requires path to script which is known only on DL node. Injection of env var is required for remote publish.
---
 .../repository/custom/plugins/GlobalJobPreLoad.py    | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py b/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
index eeb1f7744c..bcd853f374 100644
--- a/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
+++ b/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
@@ -87,6 +87,13 @@ def inject_openpype_environment(deadlinePlugin):
             for key, value in contents.items():
                 deadlinePlugin.SetProcessEnvironmentVariable(key, value)
 
+        script_url = job.GetJobPluginInfoKeyValue("ScriptFilename")
+        if script_url:
+
+            script_url = script_url.format(**contents).replace("\\", "/")
+            print(">>> Setting script path {}".format(script_url))
+            job.SetJobPluginInfoKeyValue("ScriptFilename", script_url)
+
         print(">>> Removing temporary file")
         os.remove(export_url)
 
@@ -196,16 +203,19 @@ def __main__(deadlinePlugin):
         job.GetJobEnvironmentKeyValue('OPENPYPE_RENDER_JOB') or '0'
     openpype_publish_job = \
         job.GetJobEnvironmentKeyValue('OPENPYPE_PUBLISH_JOB') or '0'
+    openpype_remote_job = \
+        job.GetJobEnvironmentKeyValue('OPENPYPE_REMOTE_JOB') or '0'
 
     print("--- Job type - render {}".format(openpype_render_job))
     print("--- Job type - publish {}".format(openpype_publish_job))
+    print("--- Job type - remote {}".format(openpype_remote_job))
     if openpype_publish_job == '1' and openpype_render_job == '1':
         raise RuntimeError("Misconfiguration. Job couldn't be both " +
                            "render and publish.")
 
     if openpype_publish_job == '1':
         inject_render_job_id(deadlinePlugin)
-    elif openpype_render_job == '1':
+    elif openpype_render_job == '1' or openpype_remote_job == '1':
         inject_openpype_environment(deadlinePlugin)
     else:
         pype(deadlinePlugin)  # backward compatibility with Pype2

From 529c31c4f912d66bece87a17eb597c1ec5dd86ad Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 20 May 2022 19:02:17 +0200
Subject: [PATCH 0318/1227] OP-2787 - updated validator

Checks for exactly 1 out set.
---
 .../hosts/maya/plugins/publish/validate_animation_content.py  | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/validate_animation_content.py b/openpype/hosts/maya/plugins/publish/validate_animation_content.py
index bcea761a01..7638c44b87 100644
--- a/openpype/hosts/maya/plugins/publish/validate_animation_content.py
+++ b/openpype/hosts/maya/plugins/publish/validate_animation_content.py
@@ -30,6 +30,10 @@ class ValidateAnimationContent(pyblish.api.InstancePlugin):
 
         assert 'out_hierarchy' in instance.data, "Missing `out_hierarchy` data"
 
+        out_sets = [node for node in instance if node.endswith("out_SET")]
+        msg = "Couldn't find exactly one out_SET: {0}".format(out_sets)
+        assert len(out_sets) == 1, msg
+
         # All nodes in the `out_hierarchy` must be among the nodes that are
         # in the instance. The nodes in the instance are found from the top
         # group, as such this tests whether all nodes are under that top group.

From 62ac633da95772488f94ea4b9d53c2c5a74e9b9c Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 20 May 2022 19:05:35 +0200
Subject: [PATCH 0319/1227] OP-2787 - used settings from
 ProcessSubmittedJobOnFarm

---
 .../submit_maya_remote_publish_deadline.py    | 67 +++++++++----------
 1 file changed, 32 insertions(+), 35 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
index 761bc8cc95..b11698f8e8 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
@@ -4,18 +4,22 @@ import requests
 from maya import cmds
 
 from openpype.pipeline import legacy_io
+from openpype.settings import get_project_settings
 
 import pyblish.api
 
 
-class MayaSubmitRemotePublishDeadline(pyblish.api.ContextPlugin):
+class MayaSubmitRemotePublishDeadline(pyblish.api.InstancePlugin):
     """Submit Maya scene to perform a local publish in Deadline.
 
     Publishing in Deadline can be helpful for scenes that publish very slow.
     This way it can process in the background on another machine without the
     Artist having to wait for the publish to finish on their local machine.
 
-    Submission is done through the Deadline Web Service.
+    Submission is done through the Deadline Web Service. DL then triggers
+    `openpype/scripts/remote_publish.py`.
+
+    Each publishable instance creates its own full publish job.
 
     Different from `ProcessSubmittedJobOnFarm` which creates publish job
     depending on metadata json containing context and instance data of
@@ -27,31 +31,24 @@ class MayaSubmitRemotePublishDeadline(pyblish.api.ContextPlugin):
     hosts = ["maya"]
     families = ["deadline"]
 
-    # custom deadline attributes
-    deadline_department = ""
-    deadline_pool = ""
-    deadline_pool_secondary = ""
-    deadline_group = ""
-    deadline_chunk_size = 1
-    deadline_priority = 50
-
-    def process(self, context):
+    def process(self, instance):
+        settings = get_project_settings(os.getenv("AVALON_PROJECT"))
+        # use setting for publish job on farm, no reason to have it separately
+        deadline_publish_job_sett = (settings["deadline"]
+                                     ["publish"]
+                                     ["ProcessSubmittedJobOnFarm"])
 
         # Ensure no errors so far
-        assert all(result["success"] for result in context.data["results"]), (
-            "Errors found, aborting integration..")
+        assert (all(result["success"]
+                    for result in instance.context.data["results"]),
+                    ("Errors found, aborting integration.."))
 
-        # Note that `publish` data member might change in the future.
-        # See: https://github.com/pyblish/pyblish-base/issues/307
-        actives = [i for i in context if i.data["publish"]]
-        instance_names = sorted(instance.name for instance in actives)
-
-        if not instance_names:
+        if not instance.data["publish"]:
             self.log.warning("No active instances found. "
                              "Skipping submission..")
             return
 
-        scene = context.data["currentFile"]
+        scene = instance.context.data["currentFile"]
         scenename = os.path.basename(scene)
 
         # Get project code
@@ -66,17 +63,15 @@ class MayaSubmitRemotePublishDeadline(pyblish.api.ContextPlugin):
             "JobInfo": {
                 "Plugin": "MayaBatch",
                 "BatchName": batch_name,
-                "Priority": 50,
                 "Name": job_name,
-                "UserName": context.data["user"],
-                # "Comment": instance.context.data.get("comment", ""),
+                "UserName": instance.context.data["user"],
+                "Comment": instance.context.data.get("comment", ""),
                 # "InitialStatus": state
-                "Department": self.deadline_department,
-                "ChunkSize": self.deadline_chunk_size,
-                "Priority": self.deadline_priority,
-
-                "Group": self.deadline_group,
-
+                "Department": deadline_publish_job_sett["deadline_department"],
+                "ChunkSize": deadline_publish_job_sett["deadline_chunk_size"],
+                "Priority": deadline_publish_job_sett["deadline_priority"],
+                "Group": deadline_publish_job_sett["deadline_group"],
+                "Pool": deadline_publish_job_sett["deadline_pool"],
             },
             "PluginInfo": {
 
@@ -86,7 +81,7 @@ class MayaSubmitRemotePublishDeadline(pyblish.api.ContextPlugin):
 
                 # Inputs
                 "SceneFile": scene,
-                "ScriptFilename": "{OPENPYPE_ROOT}/scripts/remote_publish.py",
+                "ScriptFilename": "{OPENPYPE_REPOS_ROOT}/openpype/scripts/remote_publish.py",   # noqa
 
                 # Mandatory for Deadline
                 "Version": cmds.about(version=True),
@@ -116,10 +111,9 @@ class MayaSubmitRemotePublishDeadline(pyblish.api.ContextPlugin):
         environment["AVALON_TASK"] = legacy_io.Session["AVALON_TASK"]
         environment["AVALON_APP_NAME"] = os.environ.get("AVALON_APP_NAME")
         environment["OPENPYPE_LOG_NO_COLORS"] = "1"
-        environment["OPENPYPE_USERNAME"] = context.data["user"]
-        environment["OPENPYPE_PUBLISH_JOB"] = "1"
-        environment["OPENPYPE_RENDER_JOB"] = "0"
-        environment["PYBLISH_ACTIVE_INSTANCES"] = ",".join(instance_names)
+        environment["OPENPYPE_REMOTE_JOB"] = "1"
+        environment["OPENPYPE_USERNAME"] = instance.context.data["user"]
+        environment["OPENPYPE_PUBLISH_SUBSET"] = instance.data["subset"]
 
         payload["JobInfo"].update({
             "EnvironmentKeyValue%d" % index: "{key}={value}".format(
@@ -129,7 +123,10 @@ class MayaSubmitRemotePublishDeadline(pyblish.api.ContextPlugin):
         })
 
         self.log.info("Submitting Deadline job ...")
-        deadline_url = context.data["defaultDeadline"]
+        deadline_url = instance.context.data["defaultDeadline"]
+        # if custom one is set in instance, use that
+        if instance.data.get("deadlineUrl"):
+            deadline_url = instance.data.get("deadlineUrl")
         assert deadline_url, "Requires Deadline Webservice URL"
         url = "{}/api/jobs".format(deadline_url)
         response = requests.post(url, json=payload, timeout=10)

From bf75d18a7b6852415cbb71b69a8a6a05c0ea3754 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 20 May 2022 19:07:21 +0200
Subject: [PATCH 0320/1227] OP-2787 - added collector for remote publishable
 instances

Filters instances from a workfile and marks only these that should be published on a farm.
---
 .../publish/collect_publishable_instances.py  | 39 +++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 openpype/modules/deadline/plugins/publish/collect_publishable_instances.py

diff --git a/openpype/modules/deadline/plugins/publish/collect_publishable_instances.py b/openpype/modules/deadline/plugins/publish/collect_publishable_instances.py
new file mode 100644
index 0000000000..9a467428fd
--- /dev/null
+++ b/openpype/modules/deadline/plugins/publish/collect_publishable_instances.py
@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*-
+"""Collect instances that should be processed and published on DL.
+
+"""
+import os
+
+import pyblish.api
+
+
+class CollectDeadlinePublishableInstances(pyblish.api.InstancePlugin):
+    """Collect instances that should be processed and published on DL.
+
+    Some long running publishes (not just renders) could be offloaded to DL,
+    this plugin compares theirs name against env variable, marks only
+    publishable by farm.
+
+    Triggered only when running only in headless mode, eg on a farm.
+    """
+
+    order = pyblish.api.CollectorOrder + 0.499
+    label = "Collect Deadline Publishable Instance"
+    targets = ["remote"]
+
+    def process(self, instance):
+        self.log.debug("CollectDeadlinePublishableInstances")
+        publish_inst = os.environ.get("OPENPYPE_PUBLISH_SUBSET", '')
+        assert (publish_inst,
+                "OPENPYPE_PUBLISH_SUBSET env var required for "
+                "remote publishing")
+
+        subset_name = instance.data["subset"]
+        if subset_name == publish_inst:
+            self.log.debug("Publish {}".format(subset_name))
+            instance.data["publish"] = True
+            instance.data["farm"] = False
+            instance.data["families"].remove("deadline")
+        else:
+            self.log.debug("Skipping {}".format(subset_name))
+            instance.data["publish"] = False

From 72d8633266048ba19b78d425c879aa0325ba042b Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 20 May 2022 19:09:35 +0200
Subject: [PATCH 0321/1227] OP-2787 - changed flag from family to farm

It probably makes more sense to check specific flag than a family.
---
 openpype/plugins/publish/integrate_new.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 1a4112107a..b5a7f11904 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -139,7 +139,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                     ef, instance.data["family"], instance.data["families"]))
                 return
 
-        if "deadline" in instance.data["families"]:
+        # instance should be published on a farm
+        if instance.data["farm"]:
             return
 
         self.integrated_file_sizes = {}

From 6b71ff1909c3d32e5bebc0595580f1dcde1c1180 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 20 May 2022 19:25:55 +0200
Subject: [PATCH 0322/1227] OP-2787 - removed deadline family

deadline family is not used anymore anywhere, filtering on integrate is being done on instance.data["farm"] flag.
---
 .../maya/plugins/publish/collect_animation.py      |  3 ---
 .../maya/plugins/publish/collect_pointcache.py     | 14 --------------
 2 files changed, 17 deletions(-)
 delete mode 100644 openpype/hosts/maya/plugins/publish/collect_pointcache.py

diff --git a/openpype/hosts/maya/plugins/publish/collect_animation.py b/openpype/hosts/maya/plugins/publish/collect_animation.py
index b442113fbc..9b1e38fd0a 100644
--- a/openpype/hosts/maya/plugins/publish/collect_animation.py
+++ b/openpype/hosts/maya/plugins/publish/collect_animation.py
@@ -55,6 +55,3 @@ class CollectAnimationOutputGeometry(pyblish.api.InstancePlugin):
 
         # Store data in the instance for the validator
         instance.data["out_hierarchy"] = hierarchy
-
-        if instance.data.get("farm"):
-            instance.data["families"].append("deadline")
diff --git a/openpype/hosts/maya/plugins/publish/collect_pointcache.py b/openpype/hosts/maya/plugins/publish/collect_pointcache.py
deleted file mode 100644
index b55babe372..0000000000
--- a/openpype/hosts/maya/plugins/publish/collect_pointcache.py
+++ /dev/null
@@ -1,14 +0,0 @@
-import pyblish.api
-
-
-class CollectPointcache(pyblish.api.InstancePlugin):
-    """Collect pointcache data for instance."""
-
-    order = pyblish.api.CollectorOrder + 0.4
-    families = ["pointcache"]
-    label = "Collect Pointcache"
-    hosts = ["maya"]
-
-    def process(self, instance):
-        if instance.data.get("farm"):
-            instance.data["families"].append("deadline")
\ No newline at end of file

From a176228396083c4eefc1de798c579c67ff65fd4d Mon Sep 17 00:00:00 2001
From: Jiri Sindelar <45896205+jrsndl@users.noreply.github.com>
Date: Mon, 23 May 2022 13:19:53 +0200
Subject: [PATCH 0323/1227] Update
 openpype/plugins/publish/extract_review_slate.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/plugins/publish/extract_review_slate.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 832799601c..52d988a6b0 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -130,8 +130,9 @@ class ExtractReviewSlate(openpype.api.Extractor):
                         input_audio = True
                         break
             # Get duration of one frame in micro seconds
-            one_frame_duration = "40000us"
-            if input_frame_rate:
+            if not input_frame_rate:
+                one_frame_duration = "40000us"
+            else:
                 items = input_frame_rate.split("/")
                 if len(items) == 1:
                     one_frame_duration = float(1.0) / float(items[0])

From bf80eee17816bf1876d32d0d37c486ec9db54aa3 Mon Sep 17 00:00:00 2001
From: Jiri Sindelar <45896205+jrsndl@users.noreply.github.com>
Date: Mon, 23 May 2022 13:20:10 +0200
Subject: [PATCH 0324/1227] Update
 openpype/plugins/publish/extract_review_slate.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/plugins/publish/extract_review_slate.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 52d988a6b0..3bf7d00f7b 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -138,6 +138,8 @@ class ExtractReviewSlate(openpype.api.Extractor):
                     one_frame_duration = float(1.0) / float(items[0])
                 elif len(items) == 2:
                     one_frame_duration = float(items[1]) / float(items[0])
+                else:
+                    one_frame_duration = 0
                 one_frame_duration *= 1000000
                 one_frame_duration = str(int(one_frame_duration)) + "us"
             self.log.debug(

From 9244389b585b654f92dbf76a8e5ed2692ac4cb3b Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 23 May 2022 17:16:44 +0200
Subject: [PATCH 0325/1227] OP-2790 - safer querying of farm flag

---
 openpype/plugins/publish/integrate_new.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index b5a7f11904..fa0582c65a 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -140,7 +140,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 return
 
         # instance should be published on a farm
-        if instance.data["farm"]:
+        if instance.data.get("farm"):
             return
 
         self.integrated_file_sizes = {}

From 5d6ce5592dfcb02444e9d7f86e9feab6eaebf53d Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 23 May 2022 17:47:54 +0200
Subject: [PATCH 0326/1227] Hiero: rolled back py3 compatible code make it py27
 working

---
 openpype/hosts/hiero/api/lib.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 5b2f6c814d..ae0aef9e9b 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -171,7 +171,7 @@ def get_track_items(
 
     # get selected track items or all in active sequence
     if selection:
-        with contextlib.suppress(AttributeError):
+        try:
             for track_item in selection:
                 log.info("___ track_item: {}".format(track_item))
                 # make sure only trackitems are selected
@@ -188,6 +188,8 @@ def get_track_items(
                 ):
                     log.info("___ valid trackitem: {}".format(track_item))
                     return_list.append(track_item)
+        except AttributeError:
+            pass
 
     # collect all available active sequence track items
     if not return_list:

From 2e5acf6221e5063517870c93046979e79b243e49 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 23 May 2022 17:50:09 +0200
Subject: [PATCH 0327/1227] hound

---
 openpype/hosts/hiero/api/lib.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index ae0aef9e9b..d19cefd2da 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -2,7 +2,6 @@
 Host specific functions where host api is connected
 """
 
-import contextlib
 from copy import deepcopy
 import os
 import re
@@ -986,7 +985,8 @@ def get_sequence_pattern_and_padding(file):
         return None, None
     found = sorted(list(set(foundall[0])))[-1]
 
-    padding = int(re.findall(r"\d+", found)[-1]) if "%" in found else len(found)
+    padding = int(
+        re.findall(r"\d+", found)[-1]) if "%" in found else len(found)
     return found, padding
 
 

From c0ee519dba5f24c8040bc08f910c7024697b621d Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 24 May 2022 12:59:33 +0200
Subject: [PATCH 0328/1227] Hound

---
 openpype/hosts/flame/api/lib.py | 12 +++++++-----
 openpype/hosts/hiero/api/lib.py |  3 ++-
 2 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index 6dc7d3d887..d59308ad6c 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -779,7 +779,6 @@ class MediaInfoFile(object):
         feed_dir = os.path.dirname(path)
         feed_ext = os.path.splitext(feed_basename)[1][1:].lower()
 
-
         with maintained_temp_file_path(".clip") as tmp_path:
             self.log.info("Temp File: {}".format(tmp_path))
             self._generate_media_info_file(tmp_path, feed_ext, feed_dir)
@@ -827,9 +826,11 @@ class MediaInfoFile(object):
 
         # make sure partial input basename is having correct extensoon
         if not partialname:
-            raise AttributeError("Wrong input attributes. Basename - {}, Ext - {}".format(
-                feed_basename, feed_ext
-            ))
+            raise AttributeError(
+                "Wrong input attributes. Basename - {}, Ext - {}".format(
+                    feed_basename, feed_ext
+                )
+            )
 
         # get all related files
         files = [
@@ -860,7 +861,8 @@ class MediaInfoFile(object):
         # convert to multiple collections
         _continues_colls = collection.separate()
         for _coll in _continues_colls:
-            coll_to_text = self._format_collection(_coll, len(number_from_path))
+            coll_to_text = self._format_collection(
+                _coll, len(number_from_path))
             self.log.debug("__ coll_to_text: {}".format(coll_to_text))
             if search_number_pattern in coll_to_text:
                 return coll_to_text
diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 5b2f6c814d..5a9f38bf92 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -984,7 +984,8 @@ def get_sequence_pattern_and_padding(file):
         return None, None
     found = sorted(list(set(foundall[0])))[-1]
 
-    padding = int(re.findall(r"\d+", found)[-1]) if "%" in found else len(found)
+    padding = int(
+        re.findall(r"\d+", found)[-1]) if "%" in found else len(found)
     return found, padding
 
 

From 0e0bbd56992a8ee8e7c32d90e56606623bb3781c Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Tue, 24 May 2022 15:31:01 +0100
Subject: [PATCH 0329/1227] Fix camera in UE5

---
 .../hosts/unreal/plugins/load/load_camera.py  | 31 +++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/unreal/plugins/load/load_camera.py b/openpype/hosts/unreal/plugins/load/load_camera.py
index b33e45b6e9..0072dd9e73 100644
--- a/openpype/hosts/unreal/plugins/load/load_camera.py
+++ b/openpype/hosts/unreal/plugins/load/load_camera.py
@@ -57,6 +57,33 @@ class CameraLoader(plugin.Loader):
                 min_frame_j,
                 max_frame_j + 1)
 
+    def _import_camera(
+        self, world, sequence, bindings, import_fbx_settings, import_filename
+    ):
+        ue_version = unreal.SystemLibrary.get_engine_version().split('.')
+        ue_major = int(ue_version[0])
+        ue_minor = int(ue_version[1])
+
+        if ue_major == 4 and ue_minor <= 26:
+            unreal.SequencerTools.import_fbx(
+                world,
+                sequence,
+                bindings,
+                import_fbx_settings,
+                import_filename
+            )
+        elif (ue_major == 4 and ue_minor >= 27) or ue_major == 5:
+            unreal.SequencerTools.import_level_sequence_fbx(
+                world,
+                sequence,
+                bindings,
+                import_fbx_settings,
+                import_filename
+            )
+        else:
+            raise NotImplementedError(
+                f"Unreal version {ue_major} not supported")
+
     def load(self, context, name, namespace, data):
         """
         Load and containerise representation into Content Browser.
@@ -228,7 +255,7 @@ class CameraLoader(plugin.Loader):
         settings.set_editor_property('reduce_keys', False)
 
         if cam_seq:
-            unreal.SequencerTools.import_fbx(
+            self._import_camera(
                 EditorLevelLibrary.get_editor_world(),
                 cam_seq,
                 cam_seq.get_bindings(),
@@ -388,7 +415,7 @@ class CameraLoader(plugin.Loader):
 
         sub_scene.set_sequence(new_sequence)
 
-        unreal.SequencerTools.import_fbx(
+        self._import_camera(
             EditorLevelLibrary.get_editor_world(),
             new_sequence,
             new_sequence.get_bindings(),

From 9c72873a9a8ac462abf463cc86c1c04dcfecaf8b Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Tue, 24 May 2022 15:32:29 +0100
Subject: [PATCH 0330/1227] Fix animations in UE5

---
 openpype/hosts/unreal/plugins/load/load_animation.py | 12 ++++++++----
 openpype/hosts/unreal/plugins/load/load_layout.py    |  6 ++++--
 2 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/unreal/plugins/load/load_animation.py b/openpype/hosts/unreal/plugins/load/load_animation.py
index 60c1526d3d..54b43c500c 100644
--- a/openpype/hosts/unreal/plugins/load/load_animation.py
+++ b/openpype/hosts/unreal/plugins/load/load_animation.py
@@ -77,13 +77,15 @@ class AnimationFBXLoader(plugin.Loader):
         task.options.anim_sequence_import_data.set_editor_property(
             'import_meshes_in_bone_hierarchy', False)
         task.options.anim_sequence_import_data.set_editor_property(
-            'use_default_sample_rate', True)
+            'use_default_sample_rate', False)
+        task.options.anim_sequence_import_data.set_editor_property(
+            'custom_sample_rate', 25.0) # TODO: get from database
         task.options.anim_sequence_import_data.set_editor_property(
             'import_custom_attribute', True)
         task.options.anim_sequence_import_data.set_editor_property(
             'import_bone_tracks', True)
         task.options.anim_sequence_import_data.set_editor_property(
-            'remove_redundant_keys', True)
+            'remove_redundant_keys', False)
         task.options.anim_sequence_import_data.set_editor_property(
             'convert_scene', True)
 
@@ -279,13 +281,15 @@ class AnimationFBXLoader(plugin.Loader):
         task.options.anim_sequence_import_data.set_editor_property(
             'import_meshes_in_bone_hierarchy', False)
         task.options.anim_sequence_import_data.set_editor_property(
-            'use_default_sample_rate', True)
+            'use_default_sample_rate', False)
+        task.options.anim_sequence_import_data.set_editor_property(
+            'custom_sample_rate', 25.0) # TODO: get from database
         task.options.anim_sequence_import_data.set_editor_property(
             'import_custom_attribute', True)
         task.options.anim_sequence_import_data.set_editor_property(
             'import_bone_tracks', True)
         task.options.anim_sequence_import_data.set_editor_property(
-            'remove_redundant_keys', True)
+            'remove_redundant_keys', False)
         task.options.anim_sequence_import_data.set_editor_property(
             'convert_scene', True)
 
diff --git a/openpype/hosts/unreal/plugins/load/load_layout.py b/openpype/hosts/unreal/plugins/load/load_layout.py
index 412f77e3a9..49611c6c05 100644
--- a/openpype/hosts/unreal/plugins/load/load_layout.py
+++ b/openpype/hosts/unreal/plugins/load/load_layout.py
@@ -262,13 +262,15 @@ class LayoutLoader(plugin.Loader):
         task.options.anim_sequence_import_data.set_editor_property(
             'import_meshes_in_bone_hierarchy', False)
         task.options.anim_sequence_import_data.set_editor_property(
-            'use_default_sample_rate', True)
+            'use_default_sample_rate', False)
+        task.options.anim_sequence_import_data.set_editor_property(
+            'custom_sample_rate', 25.0) # TODO: get from database
         task.options.anim_sequence_import_data.set_editor_property(
             'import_custom_attribute', True)
         task.options.anim_sequence_import_data.set_editor_property(
             'import_bone_tracks', True)
         task.options.anim_sequence_import_data.set_editor_property(
-            'remove_redundant_keys', True)
+            'remove_redundant_keys', False)
         task.options.anim_sequence_import_data.set_editor_property(
             'convert_scene', True)
 

From 1b76f86d6691b0106ce2ae9022666979103cf57d Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Tue, 24 May 2022 15:35:47 +0100
Subject: [PATCH 0331/1227] Fix render create in  UE5

---
 openpype/hosts/unreal/plugins/create/create_render.py | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/unreal/plugins/create/create_render.py b/openpype/hosts/unreal/plugins/create/create_render.py
index 3b6c7a9f1e..a3e125a94e 100644
--- a/openpype/hosts/unreal/plugins/create/create_render.py
+++ b/openpype/hosts/unreal/plugins/create/create_render.py
@@ -22,17 +22,24 @@ class CreateRender(Creator):
 
         ar = unreal.AssetRegistryHelpers.get_asset_registry()
 
+        # The asset name is the the third element of the path which contains
+        # the map.
+        # The index of the split path is 3 because the first element is an
+        # empty string, as the path begins with "/Content".
+        a = unreal.EditorUtilityLibrary.get_selected_assets()[0]
+        asset_name = a.get_path_name().split("/")[3]
+
         # Get the master sequence and the master level.
         # There should be only one sequence and one level in the directory.
         filter = unreal.ARFilter(
             class_names=["LevelSequence"],
-            package_paths=[f"/Game/OpenPype/{self.data['asset']}"],
+            package_paths=[f"/Game/OpenPype/{asset_name}"],
             recursive_paths=False)
         sequences = ar.get_assets(filter)
         ms = sequences[0].get_editor_property('object_path')
         filter = unreal.ARFilter(
             class_names=["World"],
-            package_paths=[f"/Game/OpenPype/{self.data['asset']}"],
+            package_paths=[f"/Game/OpenPype/{asset_name}"],
             recursive_paths=False)
         levels = ar.get_assets(filter)
         ml = levels[0].get_editor_property('object_path')

From 5ee40df9c13b0eaddd94810b5177061d2a1dde87 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 24 May 2022 17:25:30 +0200
Subject: [PATCH 0332/1227] Nuke: passing bake presets to instance data for
 downstream processing

---
 .../nuke/plugins/publish/extract_review_data_mov.py    | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py b/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
index 2a79d600ba..384ed5f2ef 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
@@ -1,4 +1,5 @@
 import os
+from pprint import pformat
 import re
 import pyblish.api
 import openpype
@@ -50,6 +51,7 @@ class ExtractReviewDataMov(openpype.api.Extractor):
         with maintained_selection():
             generated_repres = []
             for o_name, o_data in self.outputs.items():
+                self.log.debug("o_name: {}, o_data: {}".format(o_name, pformat(o_data)))
                 f_families = o_data["filter"]["families"]
                 f_task_types = o_data["filter"]["task_types"]
                 f_subsets = o_data["filter"]["subsets"]
@@ -88,7 +90,13 @@ class ExtractReviewDataMov(openpype.api.Extractor):
                 # check if settings have more then one preset
                 # so we dont need to add outputName to representation
                 # in case there is only one preset
-                multiple_presets = bool(len(self.outputs.keys()) > 1)
+                multiple_presets = len(self.outputs.keys()) > 1
+
+                # adding bake presets to instance data for other plugins
+                if not instance.data.get("bakePresets"):
+                    instance.data["bakePresets"] = {}
+                # add preset to bakePresets
+                instance.data["bakePresets"][o_name] = o_data
 
                 # create exporter instance
                 exporter = plugin.ExporterReviewMov(

From 3da82c845ff13a85884744988a529cc9ca4abb52 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 24 May 2022 17:26:05 +0200
Subject: [PATCH 0333/1227] Nuke: multi bake stream slate creation

---
 .../plugins/publish/extract_slate_frame.py    | 70 +++++++++++++------
 1 file changed, 48 insertions(+), 22 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
index fb52fc18b4..ed936abb91 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
@@ -1,4 +1,5 @@
 import os
+from pprint import pformat
 import nuke
 import copy
 
@@ -15,7 +16,7 @@ class ExtractSlateFrame(openpype.api.Extractor):
 
     """
 
-    order = pyblish.api.ExtractorOrder - 0.001
+    order = pyblish.api.ExtractorOrder + 0.011
     label = "Extract Slate Frame"
 
     families = ["slate"]
@@ -40,15 +41,33 @@ class ExtractSlateFrame(openpype.api.Extractor):
             self.log.debug("instance.data[families]: {}".format(
                 instance.data["families"]))
 
-            self.render_slate(instance)
+            if instance.data.get("bakePresets"):
+                for o_name, o_data in instance.data["bakePresets"].items():
+                    self.log.info("_ o_name: {}, o_data: {}".format(o_name, pformat(o_data)))
+                    self.render_slate(instance, o_name, **o_data)
+            else:
+                viewer_process_swithes = {
+                    "bake_viewer_process": True,
+                    "bake_viewer_input_process": True
+                }
+                self.render_slate(instance, None, **viewer_process_swithes)
+
+    def render_slate(self, instance, output_name=None, **kwargs):
+        # solve output name if any is set
+        _output_name = output_name or ""
+        if _output_name:
+            _output_name = "_" + _output_name
+
+        bake_viewer_process = kwargs["bake_viewer_process"]
+        bake_viewer_input_process_node = kwargs[
+            "bake_viewer_input_process"]
 
-    def render_slate(self, instance):
         node_subset_name = instance.data.get("name", None)
         node = instance[0]  # group node
         self.log.info("Creating staging dir...")
 
         if "representations" not in instance.data:
-            instance.data["representations"] = list()
+            instance.data["representations"] = []
 
         staging_dir = os.path.normpath(
             os.path.dirname(instance.data['path']))
@@ -76,7 +95,7 @@ class ExtractSlateFrame(openpype.api.Extractor):
                 "{head}{padding}{tail}"))
             fhead = collection.format("{head}")
 
-            collected_frames_len = int(len(collection.indexes))
+            collected_frames_len = len(collection.indexes)
 
             # get first and last frame
             first_frame = min(collection.indexes) - 1
@@ -100,24 +119,34 @@ class ExtractSlateFrame(openpype.api.Extractor):
 
         previous_node = node
 
-        # get input process and connect it to baking
-        ipn = self.get_view_process_node()
-        if ipn is not None:
-            ipn.setInput(0, previous_node)
-            previous_node = ipn
-            temporary_nodes.append(ipn)
+        # only create colorspace baking if toggled on
+        if bake_viewer_process:
+            if bake_viewer_input_process_node:
+                # get input process and connect it to baking
+                ipn = self.get_view_process_node()
+                if ipn is not None:
+                    ipn.setInput(0, previous_node)
+                    previous_node = ipn
+                    temporary_nodes.append(ipn)
 
-        if not self.viewer_lut_raw:
-            dag_node = nuke.createNode("OCIODisplay")
-            dag_node.setInput(0, previous_node)
-            previous_node = dag_node
-            temporary_nodes.append(dag_node)
+            if not self.viewer_lut_raw:
+                dag_node = nuke.createNode("OCIODisplay")
+                dag_node.setInput(0, previous_node)
+                previous_node = dag_node
+                temporary_nodes.append(dag_node)
 
         # create write node
         write_node = nuke.createNode("Write")
-        file = fhead + "slate.png"
+        file = fhead[:-1] + _output_name + "_slate.png"
         path = os.path.join(staging_dir, file).replace("\\", "/")
-        instance.data["slateFrame"] = path
+
+        # add slate path to `slateFrames` instance data attr
+        if not instance.data.get("slateFrames"):
+            instance.data["slateFrames"] = {}
+
+        instance.data["slateFrames"][output_name or "*"] = path
+
+        # create write node
         write_node["file"].setValue(path)
         write_node["file_type"].setValue("png")
         write_node["raw"].setValue(1)
@@ -132,9 +161,6 @@ class ExtractSlateFrame(openpype.api.Extractor):
         # also render slate as sequence frame
         nuke.execute(node_subset_name, int(first_frame), int(last_frame))
 
-        self.log.debug(
-            "slate frame path: {}".format(instance.data["slateFrame"]))
-
         # Clean up
         for node in temporary_nodes:
             nuke.delete(node)
@@ -221,5 +247,5 @@ class ExtractSlateFrame(openpype.api.Extractor):
                 ))
             except NameError:
                 self.log.warning((
-                    "Failed to set value \"{}\" on node attribute \"{}\""
+                    "Failed to set value \"{0}\" on node attribute \"{0}\""
                 ).format(value))

From 05b96bd0237c663adb14311ef83d4981aae7a14d Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 24 May 2022 17:26:41 +0200
Subject: [PATCH 0334/1227] Nuke: multi bake stream thumbnail creation

---
 .../nuke/plugins/publish/extract_thumbnail.py | 51 +++++++++++++------
 1 file changed, 35 insertions(+), 16 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
index ef6d486ca2..03ae57f281 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
@@ -17,7 +17,7 @@ class ExtractThumbnail(openpype.api.Extractor):
 
     """
 
-    order = pyblish.api.ExtractorOrder + 0.01
+    order = pyblish.api.ExtractorOrder + 0.011
     label = "Extract Thumbnail"
 
     families = ["review"]
@@ -35,9 +35,26 @@ class ExtractThumbnail(openpype.api.Extractor):
             self.log.debug("instance.data[families]: {}".format(
                 instance.data["families"]))
 
-            self.render_thumbnail(instance)
+            if instance.data.get("bakePresets"):
+                for o_name, o_data in instance.data["bakePresets"].items():
+                    self.render_thumbnail(instance, o_name, **o_data)
+            else:
+                viewer_process_swithes = {
+                    "bake_viewer_process": True,
+                    "bake_viewer_input_process": True
+                }
+                self.render_thumbnail(instance, None, **viewer_process_swithes)
+
+    def render_thumbnail(self, instance, output_name=None, **kwargs):
+        # solve output name if any is set
+        output_name = output_name or ""
+        if output_name:
+            output_name = "_" + output_name
+
+        bake_viewer_process = kwargs["bake_viewer_process"]
+        bake_viewer_input_process_node = kwargs[
+            "bake_viewer_input_process"]
 
-    def render_thumbnail(self, instance):
         node = instance[0]  # group node
         self.log.info("Creating staging dir...")
 
@@ -89,15 +106,7 @@ class ExtractThumbnail(openpype.api.Extractor):
         else:
             previous_node = node
 
-        # get input process and connect it to baking
-        ipn = self.get_view_process_node()
-        if ipn is not None:
-            ipn.setInput(0, previous_node)
-            previous_node = ipn
-            temporary_nodes.append(ipn)
-
         reformat_node = nuke.createNode("Reformat")
-
         ref_node = self.nodes.get("Reformat", None)
         if ref_node:
             for k, v in ref_node:
@@ -110,14 +119,24 @@ class ExtractThumbnail(openpype.api.Extractor):
         previous_node = reformat_node
         temporary_nodes.append(reformat_node)
 
-        dag_node = nuke.createNode("OCIODisplay")
-        dag_node.setInput(0, previous_node)
-        previous_node = dag_node
-        temporary_nodes.append(dag_node)
+        # only create colorspace baking if toggled on
+        if bake_viewer_process:
+            if bake_viewer_input_process_node:
+                # get input process and connect it to baking
+                ipn = self.get_view_process_node()
+                if ipn is not None:
+                    ipn.setInput(0, previous_node)
+                    previous_node = ipn
+                    temporary_nodes.append(ipn)
+
+            dag_node = nuke.createNode("OCIODisplay")
+            dag_node.setInput(0, previous_node)
+            previous_node = dag_node
+            temporary_nodes.append(dag_node)
 
         # create write node
         write_node = nuke.createNode("Write")
-        file = fhead + "jpg"
+        file = fhead[:-1] + output_name + ".jpg"
         name = "thumbnail"
         path = os.path.join(staging_dir, file).replace("\\", "/")
         instance.data["thumbnail"] = path

From 6b90f0a2c1a66583d73d525f7c5d33eebc3ed197 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 24 May 2022 17:27:19 +0200
Subject: [PATCH 0335/1227] Global: multi bake stream slate processing

---
 .../plugins/publish/extract_review_slate.py   | 68 +++++++++++++------
 1 file changed, 49 insertions(+), 19 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 49f0eac41d..af1d2b2983 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -1,4 +1,6 @@
 import os
+from pprint import pformat
+import re
 import openpype.api
 import pyblish
 from openpype.lib import (
@@ -30,27 +32,11 @@ class ExtractReviewSlate(openpype.api.Extractor):
             raise RuntimeError("Burnin needs already created mov to work on.")
 
         suffix = "_slate"
-        slate_path = inst_data.get("slateFrame")
+        slates_data = inst_data["slateFrames"]
+        self.log.info("_ slates_data: {}".format(pformat(slates_data)))
+
         ffmpeg_path = get_ffmpeg_tool_path("ffmpeg")
 
-        slate_streams = get_ffprobe_streams(slate_path, self.log)
-        # Try to find first stream with defined 'width' and 'height'
-        # - this is to avoid order of streams where audio can be as first
-        # - there may be a better way (checking `codec_type`?)+
-        slate_width = None
-        slate_height = None
-        for slate_stream in slate_streams:
-            if "width" in slate_stream and "height" in slate_stream:
-                slate_width = int(slate_stream["width"])
-                slate_height = int(slate_stream["height"])
-                break
-
-        # Raise exception of any stream didn't define input resolution
-        if slate_width is None:
-            raise AssertionError((
-                "FFprobe couldn't read resolution from input file: \"{}\""
-            ).format(slate_path))
-
         if "reviewToWidth" in inst_data:
             use_legacy_code = True
         else:
@@ -77,6 +63,12 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 input_path, self.log
             )
 
+            # get slate data
+            slate_path = self._get_slate_path(input_file, slates_data)
+            self.log.info("_ slate_path: {}".format(slate_path))
+
+            slate_width, slate_height = self._get_slates_resolution(slate_path)
+
             # Try to find first stream with defined 'width' and 'height'
             # - this is to avoid order of streams where audio can be as first
             # - there may be a better way (checking `codec_type`?)
@@ -309,6 +301,44 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
         self.log.debug(inst_data["representations"])
 
+    def _get_slate_path(self, input_file, slates_data):
+        slate_path = None
+        for sl_n, _slate_path in slates_data.items():
+            if "*" in sl_n:
+                slate_path = _slate_path
+                break
+            elif re.search(sl_n, input_file):
+                slate_path = _slate_path
+                break
+
+        if not slate_path:
+            raise AttributeError(
+                "Missing slates paths: {}".format(slates_data))
+
+        return slate_path
+
+
+    def _get_slates_resolution(self, slate_path):
+        slate_streams = get_ffprobe_streams(slate_path, self.log)
+        # Try to find first stream with defined 'width' and 'height'
+        # - this is to avoid order of streams where audio can be as first
+        # - there may be a better way (checking `codec_type`?)+
+        slate_width = None
+        slate_height = None
+        for slate_stream in slate_streams:
+            if "width" in slate_stream and "height" in slate_stream:
+                slate_width = int(slate_stream["width"])
+                slate_height = int(slate_stream["height"])
+                break
+
+        # Raise exception of any stream didn't define input resolution
+        if slate_width is None:
+            raise AssertionError((
+                "FFprobe couldn't read resolution from input file: \"{}\""
+            ).format(slate_path))
+
+        return (slate_width, slate_height)
+
     def add_video_filter_args(self, args, inserting_arg):
         """
         Fixing video filter argumets to be one long string

From 8453f9710f1fb305d917723eeee4cfea5c007062 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 25 May 2022 06:27:52 +0300
Subject: [PATCH 0336/1227] Add profiles handling in schema aand for extractor

---
 openpype/plugins/publish/extract_jpeg_exr.py  | 27 ++++++++++++-
 .../defaults/project_settings/deadline.json   |  2 +-
 .../defaults/project_settings/global.json     | 12 +++++-
 .../schemas/schema_global_publish.json        | 38 +++++++++++++++++++
 4 files changed, 76 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 2d3ad1e8a8..c0363caf5b 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -1,10 +1,15 @@
 import os
 
 import pyblish.api
+from openpype.pipeline import ( 
+    legacy_io,
+    KnownPublishError
+)
 from openpype.lib import (
     get_ffmpeg_tool_path,
     get_oiio_tools_path,
 
+    filter_profiles,
     run_subprocess,
     path_to_subprocess_arg,
 
@@ -33,6 +38,26 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
     oiio_args = None
 
     def process(self, instance):
+        task_name = instance.data.get("task", legacy_io.Session["AVALON_TASK"])
+        host_name = legacy_io.Session["AVALON_APP"]
+        family = instance.data["family"]
+        filtering_criteria = {
+            "hosts": host_name,
+            "families": family,
+            "tasks": task_name
+        }
+        profile = filter_profiles(self.profiles, filtering_criteria,
+                                  logger=self.log)
+        if not profile:
+            return
+
+        oiio_path = get_oiio_tools_path()
+        # Raise an exception when oiiotool is not available
+        
+        if not os.path.exists(oiio_path):
+            KnownPublishError(
+                "OpenImageIO tool is not available on this machine."
+            )
         self.log.info("subset {}".format(instance.data['subset']))
 
         # skip crypto passes.
@@ -121,7 +146,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             jpeg_items.append(path_to_subprocess_arg(full_output_path))
 
             subprocess_command = " ".join(jpeg_items)
-            
+
             # run subprocess
             self.log.debug("{}".format(subprocess_command))
             try:  # temporary until oiiotool is supported cross platform
diff --git a/openpype/settings/defaults/project_settings/deadline.json b/openpype/settings/defaults/project_settings/deadline.json
index f0b2a7e555..5c5a14bf21 100644
--- a/openpype/settings/defaults/project_settings/deadline.json
+++ b/openpype/settings/defaults/project_settings/deadline.json
@@ -98,4 +98,4 @@
             }
         }
     }
-}
+}
\ No newline at end of file
diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index cedd0eed99..4ad56d8086 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -40,7 +40,17 @@
                     "-apply_trc gamma22"
                 ],
                 "output": []
-            }
+            },
+            "thumbnail_extraction_profiles": [
+                {
+                    "families": [
+                        ""
+                    ],
+                    "hosts": [],
+                    "task_types": [],
+                    "tasks": []
+                }
+            ]
         },
         "ExtractReview": {
             "enabled": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
index a3cbf0cfcd..4149c99348 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
@@ -152,6 +152,44 @@
                             "label": "FFmpeg output arguments"
                         }
                     ]
+                },
+                {
+                    "type": "list",
+                    "key": "thumbnail_extraction_profiles",
+                    "label": "Thumbnail Extraction profiles",
+                    "use_label_wrap": true,
+                    "object_type": {
+                        "type": "dict",
+                        "children": [
+                            {
+                                "type": "label",
+                                "label": ""
+                            },
+                            {
+                                "key": "families",
+                                "label": "Families",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "hosts-enum",
+                                "key": "hosts",
+                                "label": "Hosts",
+                                "multiselection": true
+                            },
+                            {
+                                "key": "task_types",
+                                "label": "Task types",
+                                "type": "task-types-enum"
+                            },
+                            {
+                                "key": "tasks",
+                                "label": "Task names",
+                                "type": "list",
+                                "object_type": "text"
+                            }
+                        ]
+                    }
                 }
             ]
         },

From 0040f02ef71bd6156139c184170041d94f146a40 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 25 May 2022 06:58:22 +0300
Subject: [PATCH 0337/1227] Style fix

---
 openpype/plugins/publish/extract_jpeg_exr.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index c0363caf5b..0ad39aa720 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -53,7 +53,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
 
         oiio_path = get_oiio_tools_path()
         # Raise an exception when oiiotool is not available
-        
+
         if not os.path.exists(oiio_path):
             KnownPublishError(
                 "OpenImageIO tool is not available on this machine."

From 8e0b0156cad9fdf8d2c439bb4dc4078f50d468df Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 25 May 2022 12:24:20 +0300
Subject: [PATCH 0338/1227] Fix comment typo

---
 openpype/lib/transcoding.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/lib/transcoding.py b/openpype/lib/transcoding.py
index adb9bb2c3a..ee9a0f08de 100644
--- a/openpype/lib/transcoding.py
+++ b/openpype/lib/transcoding.py
@@ -533,7 +533,7 @@ def convert_input_paths_for_ffmpeg(
     output_dir,
     logger=None
 ):
-    """Contert source file to format supported in ffmpeg.
+    """Convert source file to format supported in ffmpeg.
 
     Currently can convert only exrs. The input filepaths should be files
     with same type. Information about input is loaded only from first found

From 043ba41de7ba619be04b98e321deaa16487407d5 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 25 May 2022 12:59:53 +0300
Subject: [PATCH 0339/1227] Remove whitespace

---
 openpype/plugins/publish/extract_jpeg_exr.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 0ad39aa720..070e9e1e08 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -144,7 +144,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
 
             # output file
             jpeg_items.append(path_to_subprocess_arg(full_output_path))
-
             subprocess_command = " ".join(jpeg_items)
 
             # run subprocess

From 73a0d6fc70c847ab6114b1985dd0013282fb9a9a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 25 May 2022 12:08:01 +0200
Subject: [PATCH 0340/1227] extracted some functionality into separated
 functions

---
 .../plugins/publish/extract_review_slate.py   | 275 +++++++++++-------
 1 file changed, 171 insertions(+), 104 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 7b2df4dc5f..a42fbbbfe1 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -78,76 +78,26 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 input_path, self.log
             )
             # Get video metadata
-            for stream in streams:
-                input_timecode = ""
-                input_width = None
-                input_height = None
-                input_frame_rate = None
-                if "codec_type" in stream:
-                    if stream["codec_type"] == "video":
-                        self.log.debug("__Ffprobe Video: {}".format(stream))
-                        tags = stream.get("tags") or {}
-                        input_timecode = tags.get("timecode") or ""
-                        if "width" in stream and "height" in stream:
-                            input_width = int(stream.get("width"))
-                            input_height = int(stream.get("height"))
-                        if "r_frame_rate" in stream:
-                            # get frame rate in a form of
-                            # x/y, like 24000/1001 for 23.976
-                            input_frame_rate = stream.get("r_frame_rate")
-                        if (
-                            input_width
-                            and input_height
-                            and input_frame_rate
-                        ):
-                            input_frame_rate = str(input_frame_rate)
-                            break
+            (
+                input_width,
+                input_height,
+                input_timecode,
+                input_frame_rate
+            ) = self._get_video_metadata(streams)
+
             # Raise exception of any stream didn't define input resolution
             if input_width is None:
                 raise AssertionError((
                     "FFprobe couldn't read resolution from input file: \"{}\""
                 ).format(input_path))
-            # Get audio metadata
-            for stream in streams:
-                audio_channels = None
-                audio_sample_rate = None
-                audio_channel_layout = None
-                input_audio = False
-                if stream["codec_type"] == "audio":
-                    self.log.debug("__Ffprobe Audio: {}".format(stream))
-                    if stream["channels"]:
-                        audio_channels = str(stream.get("channels"))
-                    if stream["sample_rate"]:
-                        audio_sample_rate = str(stream.get("sample_rate"))
-                    if stream["channel_layout"]:
-                        audio_channel_layout = str(
-                            stream.get("channel_layout"))
-                    if stream["codec_name"]:
-                        audio_codec = str(
-                            stream.get("codec_name"))
-                    if (
-                        audio_channels
-                        and audio_sample_rate
-                        and audio_channel_layout
-                        and audio_codec
-                    ):
-                        input_audio = str(input_audio)
-                        audio_sample_rate = str(audio_sample_rate)
-                        audio_channel_layout = str(audio_channel_layout)
-                        audio_codec = str(audio_codec)
-                        break
-            # Get duration of one frame in micro seconds
-            one_frame_duration = "40000us"
-            if input_frame_rate:
-                items = input_frame_rate.split("/")
-                if len(items) == 1:
-                    one_frame_duration = float(1.0) / float(items[0])
-                elif len(items) == 2:
-                    one_frame_duration = float(items[1]) / float(items[0])
-                one_frame_duration *= 1000000
-                one_frame_duration = str(int(one_frame_duration)) + "us"
-            self.log.debug(
-                "One frame duration is {}".format(one_frame_duration))
+
+            (
+                audio_codec,
+                audio_channels,
+                audio_sample_rate,
+                audio_channel_layout,
+                input_audio
+            ) = self._get_audio_metadata(streams)
 
             # values are set in ExtractReview
             if use_legacy_code:
@@ -205,14 +155,16 @@ class ExtractReviewSlate(openpype.api.Extractor):
             else:
                 input_args.extend(repre["outputDef"].get('input', []))
 
-            input_args.append("-loop 1 -i {}".format(
-                openpype.lib.path_to_subprocess_arg(slate_path)))
-            input_args.extend(["-r {}".format(input_frame_rate)])
-            input_args.extend(["-frames:v 1"])
+            input_args.extend([
+                "-loop", "1",
+                "-i", openpype.lib.path_to_subprocess_arg(slate_path),
+                "-r", str(input_frame_rate),
+                "-frames:v",  "1",
+            ])
+
             # add timecode from source to the slate, substract one frame
             offset_timecode = ""
             if input_timecode:
-                offset_timecode = str(input_timecode)
                 offset_timecode = self._tc_offset(
                     str(input_timecode),
                     framerate=fps,
@@ -221,7 +173,8 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 self.log.debug("Slate Timecode: `{}`".format(
                     offset_timecode
                 ))
-                input_args.extend(["-timecode {}".format(offset_timecode)])
+                input_args.extend(["-timecode", str(offset_timecode)])
+
             if use_legacy_code:
                 format_args = []
                 codec_args = repre["_profile"].get('codec', [])
@@ -236,10 +189,10 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
             # make sure colors are correct
             output_args.extend([
-                "-vf scale=out_color_matrix=bt709",
-                "-color_primaries bt709",
-                "-color_trc bt709",
-                "-colorspace bt709"
+                "-vf", "scale=out_color_matrix=bt709",
+                "-color_primaries", "bt709",
+                "-color_trc", "bt709",
+                "-colorspace", "bt709",
             ])
 
             # scaling none square pixels and 1920 width
@@ -275,13 +228,20 @@ class ExtractReviewSlate(openpype.api.Extractor):
                     "__ height_half_pad: `{}`".format(height_half_pad)
                 )
 
-                scaling_arg = ("scale={0}x{1}:flags=lanczos,"
-                               "pad={2}:{3}:{4}:{5}:black,setsar=1").format(
-                    width_scale, height_scale, to_width, to_height,
-                    width_half_pad, height_half_pad
+                scaling_arg = (
+                    "scale={0}x{1}:flags=lanczos"
+                    ",pad={2}:{3}:{4}:{5}:black"
+                    ",setsar=1"
+                    ",fps={6}"
+                ).format(
+                    width_scale,
+                    height_scale,
+                    to_width,
+                    to_height,
+                    width_half_pad,
+                    height_half_pad,
+                    input_frame_rate
                 )
-                # add output frame rate as a filter, just in case
-                scaling_arg += ",fps={}".format(input_frame_rate)
 
                 vf_back = self.add_video_filter_args(output_args, scaling_arg)
                 # add it to output_args
@@ -317,30 +277,14 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 slate_silent_path = "_silent".join(
                     os.path.splitext(slate_v_path))
                 _remove_at_end.append(slate_silent_path)
-
-                slate_silent_args = [
+                self._create_silent_slate(
                     ffmpeg_path,
-                    "-i", slate_v_path,
-                    "-f", "lavfi", "-i",
-                    "anullsrc=r={}:cl={}:d={}".format(
-                        audio_sample_rate,
-                        audio_channel_layout,
-                        one_frame_duration
-                    ),
-                    "-c:v", "copy",
-                    "-c:a", audio_codec,
-                    "-map", "0:v",
-                    "-map", "1:a",
-                    "-shortest",
-                    "-y",
-                    slate_silent_path
-                ]
-                # run slate generation subprocess
-                self.log.debug(
-                    "Silent Slate Executing: {}".format(
-                        " ".join(slate_silent_args)))
-                openpype.api.run_subprocess(
-                    slate_silent_args, logger=self.log
+                    slate_v_path,
+                    slate_silent_path,
+                    audio_codec,
+                    audio_channels,
+                    audio_sample_rate,
+                    audio_channel_layout,
                 )
 
                 # replace slate with silent slate for concat
@@ -426,6 +370,129 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
         self.log.debug(inst_data["representations"])
 
+    def _get_video_metadata(self, streams):
+        input_timecode = ""
+        input_width = None
+        input_height = None
+        input_frame_rate = None
+        for stream in streams:
+            if stream.get("codec_type") != "video":
+                continue
+            self.log.debug("FFprobe Video: {}".format(stream))
+
+            if "width" not in stream or "height" not in stream:
+                continue
+            width = int(stream["width"])
+            height = int(stream["height"])
+            if not width or not height:
+                continue
+
+            # Make sure that width and height are captured even if frame rate
+            #    is not available
+            input_width = width
+            input_height = height
+
+            tags = stream.get("tags") or {}
+            input_timecode = tags.get("timecode") or ""
+
+            input_frame_rate = stream.get("r_frame_rate")
+            if input_frame_rate is not None:
+                break
+        return (
+            input_width,
+            input_height,
+            input_timecode,
+            input_frame_rate
+        )
+
+    def _get_audio_metadata(self, streams):
+        # Get audio metadata
+        audio_codec = None
+        audio_channels = None
+        audio_sample_rate = None
+        audio_channel_layout = None
+        input_audio = False
+
+        for stream in streams:
+            if stream.get("codec_type") != "audio":
+                continue
+            self.log.debug("__Ffprobe Audio: {}".format(stream))
+
+            if all(
+                stream.get(key)
+                for key in (
+                    "codec_name",
+                    "channels",
+                    "sample_rate",
+                    "channel_layout",
+                )
+            ):
+                audio_codec = stream["codec_name"]
+                audio_channels = stream["channels"]
+                audio_sample_rate = stream["sample_rate"]
+                audio_channel_layout = stream["channel_layout"]
+                input_audio = True
+                break
+
+        return (
+            audio_codec,
+            audio_channels,
+            audio_sample_rate,
+            audio_channel_layout,
+            input_audio,
+        )
+
+    def _create_silent_slate(
+        self,
+        ffmpeg_path,
+        src_path,
+        dst_path,
+        audio_codec,
+        audio_channels,
+        audio_sample_rate,
+        audio_channel_layout,
+    ):
+        # Get duration of one frame in micro seconds
+        items = audio_sample_rate.split("/")
+        if len(items) == 1:
+            one_frame_duration = 1.0 / float(items[0])
+        elif len(items) == 2:
+            one_frame_duration = float(items[1]) / float(items[0])
+        else:
+            one_frame_duration = None
+
+        if one_frame_duration is None:
+            one_frame_duration = "40000us"
+        else:
+            one_frame_duration *= 1000000
+            one_frame_duration = str(int(one_frame_duration)) + "us"
+        self.log.debug("One frame duration is {}".format(one_frame_duration))
+
+        slate_silent_args = [
+            ffmpeg_path,
+            "-i", src_path,
+            "-f", "lavfi", "-i",
+            "anullsrc=r={}:cl={}:d={}".format(
+                audio_sample_rate,
+                audio_channel_layout,
+                one_frame_duration
+            ),
+            "-c:v", "copy",
+            "-c:a", audio_codec,
+            "-map", "0:v",
+            "-map", "1:a",
+            "-shortest",
+            "-y",
+            dst_path
+        ]
+        # run slate generation subprocess
+        self.log.debug("Silent Slate Executing: {}".format(
+            " ".join(slate_silent_args)
+        ))
+        openpype.api.run_subprocess(
+            slate_silent_args, logger=self.log
+        )
+
     def add_video_filter_args(self, args, inserting_arg):
         """
         Fixing video filter argumets to be one long string

From 4c3914c6c263efe68d466a542c26908a1e12739d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 25 May 2022 12:12:46 +0200
Subject: [PATCH 0341/1227] fix double space

---
 openpype/plugins/publish/extract_review_slate.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index a42fbbbfe1..a2cbc1b704 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -159,7 +159,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 "-loop", "1",
                 "-i", openpype.lib.path_to_subprocess_arg(slate_path),
                 "-r", str(input_frame_rate),
-                "-frames:v",  "1",
+                "-frames:v", "1",
             ])
 
             # add timecode from source to the slate, substract one frame

From c9b0bb0e54cbd3390f06ee8ea3135ffd5e9413e5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 25 May 2022 13:32:45 +0200
Subject: [PATCH 0342/1227] make sure chunk size is at least 1

---
 openpype/modules/ftrack/lib/avalon_sync.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/ftrack/lib/avalon_sync.py b/openpype/modules/ftrack/lib/avalon_sync.py
index 124787e467..e4ba651bfd 100644
--- a/openpype/modules/ftrack/lib/avalon_sync.py
+++ b/openpype/modules/ftrack/lib/avalon_sync.py
@@ -143,14 +143,17 @@ def create_chunks(iterable, chunk_size=None):
         list<list>: Chunked items.
     """
     chunks = []
-    if not iterable:
-        return chunks
 
     tupled_iterable = tuple(iterable)
+    if not tupled_iterable:
+        return chunks
     iterable_size = len(tupled_iterable)
     if chunk_size is None:
         chunk_size = 200
 
+    if chunk_size < 1:
+        chunk_size = 1
+
     for idx in range(0, iterable_size, chunk_size):
         chunks.append(tupled_iterable[idx:idx + chunk_size])
     return chunks

From 0b9bdbf1e61d586b9d29799cc01fbbb8f6c78ca6 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 25 May 2022 16:56:46 +0200
Subject: [PATCH 0343/1227] Nuke: abstracting functions used in plugins

---
 openpype/hosts/nuke/api/__init__.py |  9 ++++++-
 openpype/hosts/nuke/api/lib.py      | 39 +++++++++++++++++++++++++++++
 2 files changed, 47 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/api/__init__.py b/openpype/hosts/nuke/api/__init__.py
index b571c4098c..77fe4503d3 100644
--- a/openpype/hosts/nuke/api/__init__.py
+++ b/openpype/hosts/nuke/api/__init__.py
@@ -26,7 +26,11 @@ from .pipeline import (
     update_container,
 )
 from .lib import (
-    maintained_selection
+    maintained_selection,
+    reset_selection,
+    get_view_process_node,
+    duplicate_node
+
 )
 
 from .utils import (
@@ -58,6 +62,9 @@ __all__ = (
     "update_container",
 
     "maintained_selection",
+    "reset_selection",
+    "get_view_process_node",
+    "duplicate_node",
 
     "colorspace_exists_on_node",
     "get_colorspace_list"
diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index ba8aa7a8db..3871381451 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -707,6 +707,20 @@ def get_imageio_input_colorspace(filename):
     return preset_clrsp
 
 
+def get_view_process_node():
+    reset_selection()
+
+    ipn_orig = None
+    for v in nuke.allNodes(filter="Viewer"):
+        ipn = v['input_process_node'].getValue()
+        if "VIEWER_INPUT" not in ipn:
+            ipn_orig = nuke.toNode(ipn)
+            ipn_orig.setSelected(True)
+
+    if ipn_orig:
+        return duplicate_node(ipn_orig)
+
+
 def on_script_load():
     ''' Callback for ffmpeg support
     '''
@@ -2549,6 +2563,31 @@ class DirmapCache:
         return cls._sync_module
 
 
+def duplicate_node(node):
+    reset_selection()
+
+    # select required node for duplication
+    node_orig = nuke.toNode(node.name())
+    node_orig.setSelected(True)
+
+    # copy selected to clipboard
+    nuke.nodeCopy("%clipboard%")
+
+    # reset selection
+    reset_selection()
+
+    # paste node and selection is on it only
+    nuke.nodePaste("%clipboard%")
+
+    # assign to variable
+    dupli_node = nuke.selectedNode()
+
+    # reset selection
+    reset_selection()
+
+    return dupli_node
+
+
 def dirmap_file_name_filter(file_name):
     """Nuke callback function with single full path argument.
 

From 6477257d4241446ce06bf09f7b840b4804c4bbfe Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 25 May 2022 16:59:33 +0200
Subject: [PATCH 0344/1227] Nuke: connecting to abstracted functions

---
 openpype/hosts/nuke/api/plugin.py             | 41 +++----------------
 .../nuke/plugins/publish/extract_thumbnail.py | 34 +++------------
 2 files changed, 10 insertions(+), 65 deletions(-)

diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index 2bad6f2c78..f2e17a4c89 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -14,11 +14,11 @@ from openpype.pipeline import (
 from .lib import (
     Knobby,
     check_subsetname_exists,
-    reset_selection,
     maintained_selection,
     set_avalon_knob_data,
     add_publish_knob,
-    get_nuke_imageio_settings
+    get_nuke_imageio_settings,
+    get_view_process_node
 )
 
 
@@ -215,37 +215,6 @@ class ExporterReview(object):
 
         self.data["representations"].append(repre)
 
-    def get_view_input_process_node(self):
-        """
-        Will get any active view process.
-
-        Arguments:
-            self (class): in object definition
-
-        Returns:
-            nuke.Node: copy node of Input Process node
-        """
-        reset_selection()
-        ipn_orig = None
-        for v in nuke.allNodes(filter="Viewer"):
-            ip = v["input_process"].getValue()
-            ipn = v["input_process_node"].getValue()
-            if "VIEWER_INPUT" not in ipn and ip:
-                ipn_orig = nuke.toNode(ipn)
-                ipn_orig.setSelected(True)
-
-        if ipn_orig:
-            # copy selected to clipboard
-            nuke.nodeCopy("%clipboard%")
-            # reset selection
-            reset_selection()
-            # paste node and selection is on it only
-            nuke.nodePaste("%clipboard%")
-            # assign to variable
-            ipn = nuke.selectedNode()
-
-            return ipn
-
     def get_imageio_baking_profile(self):
         from . import lib as opnlib
         nuke_imageio = opnlib.get_nuke_imageio_settings()
@@ -310,7 +279,7 @@ class ExporterReviewLut(ExporterReview):
         self._temp_nodes = []
         self.log.info("Deleted nodes...")
 
-    def generate_lut(self):
+    def generate_lut(self, **kwargs):
         bake_viewer_process = kwargs["bake_viewer_process"]
         bake_viewer_input_process_node = kwargs[
             "bake_viewer_input_process"]
@@ -328,7 +297,7 @@ class ExporterReviewLut(ExporterReview):
         if bake_viewer_process:
             # Node View Process
             if bake_viewer_input_process_node:
-                ipn = self.get_view_input_process_node()
+                ipn = get_view_process_node()
                 if ipn is not None:
                     # connect
                     ipn.setInput(0, self.previous_node)
@@ -519,7 +488,7 @@ class ExporterReviewMov(ExporterReview):
         if bake_viewer_process:
             if bake_viewer_input_process_node:
                 # View Process node
-                ipn = self.get_view_input_process_node()
+                ipn = get_view_process_node()
                 if ipn is not None:
                     # connect
                     ipn.setInput(0, self.previous_node)
diff --git a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
index 03ae57f281..4b1c42cd12 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
@@ -3,7 +3,10 @@ import os
 import nuke
 import pyblish.api
 import openpype
-from openpype.hosts.nuke.api.lib import maintained_selection
+from openpype.hosts.nuke.api import (
+    maintained_selection,
+    get_view_process_node
+)
 
 
 if sys.version_info[0] >= 3:
@@ -123,7 +126,7 @@ class ExtractThumbnail(openpype.api.Extractor):
         if bake_viewer_process:
             if bake_viewer_input_process_node:
                 # get input process and connect it to baking
-                ipn = self.get_view_process_node()
+                ipn = get_view_process_node()
                 if ipn is not None:
                     ipn.setInput(0, previous_node)
                     previous_node = ipn
@@ -174,30 +177,3 @@ class ExtractThumbnail(openpype.api.Extractor):
         # Clean up
         for node in temporary_nodes:
             nuke.delete(node)
-
-    def get_view_process_node(self):
-
-        # Select only the target node
-        if nuke.selectedNodes():
-            [n.setSelected(False) for n in nuke.selectedNodes()]
-
-        ipn_orig = None
-        for v in [n for n in nuke.allNodes()
-                  if "Viewer" == n.Class()]:
-            ip = v['input_process'].getValue()
-            ipn = v['input_process_node'].getValue()
-            if "VIEWER_INPUT" not in ipn and ip:
-                ipn_orig = nuke.toNode(ipn)
-                ipn_orig.setSelected(True)
-
-        if ipn_orig:
-            nuke.nodeCopy('%clipboard%')
-
-            # Deselect all
-            [n.setSelected(False) for n in nuke.selectedNodes()]
-
-            nuke.nodePaste('%clipboard%')
-
-            ipn = nuke.selectedNode()
-
-            return ipn

From 3b021e155e92abb8d1a0847e2dde9c409ba61d06 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 25 May 2022 17:00:05 +0200
Subject: [PATCH 0345/1227] Nuke: refactory extract slate frame

to bake viewer process only to thumbnail image
---
 .../plugins/publish/extract_slate_frame.py    | 179 +++++++++---------
 1 file changed, 89 insertions(+), 90 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
index ed936abb91..576f8b3440 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
@@ -6,7 +6,11 @@ import copy
 import pyblish.api
 
 import openpype
-from openpype.hosts.nuke.api.lib import maintained_selection
+from openpype.hosts.nuke.api import (
+    maintained_selection,
+    duplicate_node,
+    get_view_process_node
+)
 
 
 class ExtractSlateFrame(openpype.api.Extractor):
@@ -30,11 +34,20 @@ class ExtractSlateFrame(openpype.api.Extractor):
         "f_vfx_scope_of_work": [False, ""]
     }
 
+    # constants
+    SLATE_TO_SEQUENCE_DONE = None
+
     def process(self, instance):
-        if hasattr(self, "viewer_lut_raw"):
-            self.viewer_lut_raw = self.viewer_lut_raw
-        else:
-            self.viewer_lut_raw = False
+        self.fpath = instance.data["path"]
+        self.first_frame = instance.data["frameStartHandle"]
+        self.last_frame = instance.data["frameEndHandle"]
+
+        self.log.info("Creating staging dir...")
+
+        if "representations" not in instance.data:
+            instance.data["representations"] = []
+
+        self._create_staging_dir(instance)
 
         with maintained_selection():
             self.log.debug("instance: {}".format(instance))
@@ -43,7 +56,8 @@ class ExtractSlateFrame(openpype.api.Extractor):
 
             if instance.data.get("bakePresets"):
                 for o_name, o_data in instance.data["bakePresets"].items():
-                    self.log.info("_ o_name: {}, o_data: {}".format(o_name, pformat(o_data)))
+                    self.log.info("_ o_name: {}, o_data: {}".format(
+                        o_name, pformat(o_data)))
                     self.render_slate(instance, o_name, **o_data)
             else:
                 viewer_process_swithes = {
@@ -52,7 +66,21 @@ class ExtractSlateFrame(openpype.api.Extractor):
                 }
                 self.render_slate(instance, None, **viewer_process_swithes)
 
+    def _create_staging_dir(self, instance):
+        staging_dir = os.path.normpath(
+            os.path.dirname(self.fpath))
+
+        instance.data["stagingDir"] = staging_dir
+
+        self.log.info(
+            "StagingDir `{0}`...".format(instance.data["stagingDir"]))
+
     def render_slate(self, instance, output_name=None, **kwargs):
+        slate_node = instance.data["slateNode"]
+
+        # fill slate node with comments
+        self.add_comment_slate_node(instance, slate_node)
+
         # solve output name if any is set
         _output_name = output_name or ""
         if _output_name:
@@ -62,31 +90,8 @@ class ExtractSlateFrame(openpype.api.Extractor):
         bake_viewer_input_process_node = kwargs[
             "bake_viewer_input_process"]
 
-        node_subset_name = instance.data.get("name", None)
-        node = instance[0]  # group node
-        self.log.info("Creating staging dir...")
+        slate_first_frame = self.first_frame - 1
 
-        if "representations" not in instance.data:
-            instance.data["representations"] = []
-
-        staging_dir = os.path.normpath(
-            os.path.dirname(instance.data['path']))
-
-        instance.data["stagingDir"] = staging_dir
-
-        self.log.info(
-            "StagingDir `{0}`...".format(instance.data["stagingDir"]))
-
-        frame_start = instance.data["frameStart"]
-        frame_end = instance.data["frameEnd"]
-        handle_start = instance.data["handleStart"]
-        handle_end = instance.data["handleEnd"]
-
-        frame_length = int(
-            (frame_end - frame_start + 1) + (handle_start + handle_end)
-        )
-
-        temporary_nodes = []
         collection = instance.data.get("collection", None)
 
         if collection:
@@ -94,51 +99,61 @@ class ExtractSlateFrame(openpype.api.Extractor):
             fname = os.path.basename(collection.format(
                 "{head}{padding}{tail}"))
             fhead = collection.format("{head}")
-
-            collected_frames_len = len(collection.indexes)
-
-            # get first and last frame
-            first_frame = min(collection.indexes) - 1
-            self.log.info('frame_length: {}'.format(frame_length))
-            self.log.info(
-                'len(collection.indexes): {}'.format(collected_frames_len)
-            )
-            if ("slate" in instance.data["families"]) \
-                    and (frame_length != collected_frames_len):
-                first_frame += 1
-
-            last_frame = first_frame
         else:
-            fname = os.path.basename(instance.data.get("path", None))
+            fname = os.path.basename(self.fpath)
             fhead = os.path.splitext(fname)[0] + "."
-            first_frame = instance.data.get("frameStartHandle", None) - 1
-            last_frame = first_frame
 
         if "#" in fhead:
             fhead = fhead.replace("#", "")[:-1]
 
-        previous_node = node
+        self.log.debug("__ self.first_frame: {}".format(self.first_frame))
+        self.log.debug("__ slate_first_frame: {}".format(slate_first_frame))
+
+        # Read node
+        r_node = nuke.createNode("Read")
+        r_node["file"].setValue(self.fpath)
+        r_node["first"].setValue(self.first_frame)
+        r_node["origfirst"].setValue(self.first_frame)
+        r_node["last"].setValue(self.last_frame)
+        r_node["origlast"].setValue(self.last_frame)
+        r_node["colorspace"].setValue(instance.data["colorspace"])
+        previous_node = r_node
+        temporary_nodes = [previous_node]
 
         # only create colorspace baking if toggled on
         if bake_viewer_process:
             if bake_viewer_input_process_node:
                 # get input process and connect it to baking
-                ipn = self.get_view_process_node()
+                ipn = get_view_process_node()
                 if ipn is not None:
                     ipn.setInput(0, previous_node)
                     previous_node = ipn
                     temporary_nodes.append(ipn)
 
-            if not self.viewer_lut_raw:
-                dag_node = nuke.createNode("OCIODisplay")
-                dag_node.setInput(0, previous_node)
-                previous_node = dag_node
-                temporary_nodes.append(dag_node)
+            # add duplicate slate node and connect to previous
+            duply_slate_node = duplicate_node(slate_node)
+            duply_slate_node.setInput(0, previous_node)
+            previous_node = duply_slate_node
+            temporary_nodes.append(duply_slate_node)
+
+            # add viewer display transformation node
+            dag_node = nuke.createNode("OCIODisplay")
+            dag_node.setInput(0, previous_node)
+            previous_node = dag_node
+            temporary_nodes.append(dag_node)
+
+        else:
+            # add duplicate slate node and connect to previous
+            duply_slate_node = duplicate_node(slate_node)
+            duply_slate_node.setInput(0, previous_node)
+            previous_node = duply_slate_node
+            temporary_nodes.append(duply_slate_node)
 
         # create write node
         write_node = nuke.createNode("Write")
         file = fhead[:-1] + _output_name + "_slate.png"
-        path = os.path.join(staging_dir, file).replace("\\", "/")
+        path = os.path.join(
+            instance.data["stagingDir"], file).replace("\\", "/")
 
         # add slate path to `slateFrames` instance data attr
         if not instance.data.get("slateFrames"):
@@ -153,47 +168,31 @@ class ExtractSlateFrame(openpype.api.Extractor):
         write_node.setInput(0, previous_node)
         temporary_nodes.append(write_node)
 
-        # fill slate node with comments
-        self.add_comment_slate_node(instance)
-
         # Render frames
-        nuke.execute(write_node.name(), int(first_frame), int(last_frame))
-        # also render slate as sequence frame
-        nuke.execute(node_subset_name, int(first_frame), int(last_frame))
+        nuke.execute(
+            write_node.name(), int(slate_first_frame), int(slate_first_frame))
 
-        # Clean up
-        for node in temporary_nodes:
-            nuke.delete(node)
+        # also render image to sequence
+        self._render_slate_to_sequence(instance, slate_first_frame)
 
-    def get_view_process_node(self):
-        # Select only the target node
-        if nuke.selectedNodes():
-            [n.setSelected(False) for n in nuke.selectedNodes()]
+        # # Clean up
+        # for node in temporary_nodes:
+        #     nuke.delete(node)
 
-        ipn_orig = None
-        for v in [n for n in nuke.allNodes()
-                  if "Viewer" in n.Class()]:
-            ip = v['input_process'].getValue()
-            ipn = v['input_process_node'].getValue()
-            if "VIEWER_INPUT" not in ipn and ip:
-                ipn_orig = nuke.toNode(ipn)
-                ipn_orig.setSelected(True)
+    def _render_slate_to_sequence(self, instance, slate_first_frame):
+        if not self.SLATE_TO_SEQUENCE_DONE:
+            node_subset_name = instance.data["name"]
+            # also render slate as sequence frame
+            nuke.execute(
+                node_subset_name,
+                int(slate_first_frame),
+                int(slate_first_frame)
+            )
 
-        if ipn_orig:
-            nuke.nodeCopy('%clipboard%')
+            # mark as done
+            self.SLATE_TO_SEQUENCE_DONE = True
 
-            [n.setSelected(False) for n in nuke.selectedNodes()]  # Deselect all
-
-            nuke.nodePaste('%clipboard%')
-
-            ipn = nuke.selectedNode()
-
-            return ipn
-
-    def add_comment_slate_node(self, instance):
-        node = instance.data.get("slateNode")
-        if not node:
-            return
+    def add_comment_slate_node(self, instance, node):
 
         comment = instance.context.data.get("comment")
         intent = instance.context.data.get("intent")

From 4213f11e34ad4d917a0d48a3634f9b8a5159d1e8 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 25 May 2022 17:00:56 +0200
Subject: [PATCH 0346/1227] Nuke: refactory slate frame concat

 to work backward compatible and with slate generator
---
 openpype/plugins/publish/extract_review_slate.py | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index af1d2b2983..01492476be 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -23,6 +23,8 @@ class ExtractReviewSlate(openpype.api.Extractor):
     families = ["slate", "review"]
     match = pyblish.api.Subset
 
+    SUFFIX = "_slate"
+
     hosts = ["nuke", "shell"]
     optional = True
 
@@ -31,8 +33,15 @@ class ExtractReviewSlate(openpype.api.Extractor):
         if "representations" not in inst_data:
             raise RuntimeError("Burnin needs already created mov to work on.")
 
-        suffix = "_slate"
-        slates_data = inst_data["slateFrames"]
+        # get slates frame from upstream
+        slates_data = inst_data.get("slateFrames")
+        if not slates_data:
+            # make it backward compatible and open for slates generator
+            # premium plugin
+            slates_data = {
+                "*": inst_data["slateFrame"]
+            }
+
         self.log.info("_ slates_data: {}".format(pformat(slates_data)))
 
         ffmpeg_path = get_ffmpeg_tool_path("ffmpeg")
@@ -125,7 +134,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
             _remove_at_end = []
 
             ext = os.path.splitext(input_file)[1]
-            output_file = input_file.replace(ext, "") + suffix + ext
+            output_file = input_file.replace(ext, "") + self.SUFFIX + ext
 
             _remove_at_end.append(input_path)
 

From 7513b2b2f5d2fc6990e06a2c8d8351a06a403615 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 25 May 2022 17:06:03 +0200
Subject: [PATCH 0347/1227] Deadline: making sure slate frames data are
 transfered to metadata.json

---
 openpype/modules/deadline/plugins/publish/submit_publish_job.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 78ab935e42..ed502f8fd2 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -145,7 +145,7 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
     # mapping of instance properties to be transfered to new instance for every
     # specified family
     instance_transfer = {
-        "slate": ["slateFrame"],
+        "slate": ["slateFrames"],
         "review": ["lutPath"],
         "render2d": ["bakingNukeScripts", "version"],
         "renderlayer": ["convertToScanline"]

From e258bfcc26a04347089941f881758009a885c803 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 25 May 2022 17:17:29 +0200
Subject: [PATCH 0348/1227] hound

---
 openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py | 3 ++-
 openpype/plugins/publish/extract_review_slate.py               | 1 -
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py b/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
index 384ed5f2ef..5ea7c352b9 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
@@ -51,7 +51,8 @@ class ExtractReviewDataMov(openpype.api.Extractor):
         with maintained_selection():
             generated_repres = []
             for o_name, o_data in self.outputs.items():
-                self.log.debug("o_name: {}, o_data: {}".format(o_name, pformat(o_data)))
+                self.log.debug(
+                    "o_name: {}, o_data: {}".format(o_name, pformat(o_data)))
                 f_families = o_data["filter"]["families"]
                 f_task_types = o_data["filter"]["task_types"]
                 f_subsets = o_data["filter"]["subsets"]
diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 01492476be..f2aed22c0e 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -326,7 +326,6 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
         return slate_path
 
-
     def _get_slates_resolution(self, slate_path):
         slate_streams = get_ffprobe_streams(slate_path, self.log)
         # Try to find first stream with defined 'width' and 'height'

From ce882641e7baec3c7edca957e2024331943ab9af Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 25 May 2022 17:27:40 +0200
Subject: [PATCH 0349/1227] Vendor: updating scriptmenu to 1.5.2

---
 openpype/vendor/python/common/scriptsmenu/action.py        | 3 ++-
 openpype/vendor/python/common/scriptsmenu/launchfornuke.py | 7 ++-----
 openpype/vendor/python/common/scriptsmenu/scriptsmenu.py   | 3 +--
 openpype/vendor/python/common/scriptsmenu/version.py       | 2 +-
 4 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/openpype/vendor/python/common/scriptsmenu/action.py b/openpype/vendor/python/common/scriptsmenu/action.py
index dc4d775f6a..5e68628406 100644
--- a/openpype/vendor/python/common/scriptsmenu/action.py
+++ b/openpype/vendor/python/common/scriptsmenu/action.py
@@ -119,7 +119,8 @@ module.{module_name}()"""
         """
 
         # get the current application and its linked keyboard modifiers
-        modifiers = QtWidgets.QApplication.keyboardModifiers()
+        app = QtWidgets.QApplication.instance()
+        modifiers = app.keyboardModifiers()
 
         # If the menu has a callback registered for the current modifier
         # we run the callback instead of the action itself.
diff --git a/openpype/vendor/python/common/scriptsmenu/launchfornuke.py b/openpype/vendor/python/common/scriptsmenu/launchfornuke.py
index 23e4ed1b4d..72302a79a6 100644
--- a/openpype/vendor/python/common/scriptsmenu/launchfornuke.py
+++ b/openpype/vendor/python/common/scriptsmenu/launchfornuke.py
@@ -8,7 +8,7 @@ def _nuke_main_window():
         if (obj.inherits('QMainWindow') and
                     obj.metaObject().className() == 'Foundry::UI::DockMainWindow'):
             return obj
-        raise RuntimeError('Could not find Nuke MainWindow instance')
+    raise RuntimeError('Could not find Nuke MainWindow instance')
 
 
 def _nuke_main_menubar():
@@ -22,9 +22,6 @@ def _nuke_main_menubar():
 
 
 def main(title="Scripts"):
-    # Register control + shift callback to add to shelf (Nuke behavior)
-    # modifiers = QtCore.Qt.ControlModifier | QtCore.Qt.ShiftModifier
-    # menu.register_callback(modifiers, to_shelf)
     nuke_main_bar = _nuke_main_menubar()
     for nuke_bar in nuke_main_bar.children():
         if isinstance(nuke_bar, scriptsmenu.ScriptsMenu):
@@ -33,4 +30,4 @@ def main(title="Scripts"):
                 return menu
 
     menu = scriptsmenu.ScriptsMenu(title=title, parent=nuke_main_bar)
-    return menu
\ No newline at end of file
+    return menu
diff --git a/openpype/vendor/python/common/scriptsmenu/scriptsmenu.py b/openpype/vendor/python/common/scriptsmenu/scriptsmenu.py
index e2b7ff96c7..9e7c094902 100644
--- a/openpype/vendor/python/common/scriptsmenu/scriptsmenu.py
+++ b/openpype/vendor/python/common/scriptsmenu/scriptsmenu.py
@@ -264,8 +264,7 @@ class ScriptsMenu(QtWidgets.QMenu):
                 action.setVisible(True)
         else:
             for action in self._script_actions:
-                if not action.has_tag(search.lower()):
-                    action.setVisible(False)
+                action.setVisible(action.has_tag(search.lower()))
 
         # Set visibility for all submenus
         for action in self.actions():
diff --git a/openpype/vendor/python/common/scriptsmenu/version.py b/openpype/vendor/python/common/scriptsmenu/version.py
index 73f9426c2d..52ec49c845 100644
--- a/openpype/vendor/python/common/scriptsmenu/version.py
+++ b/openpype/vendor/python/common/scriptsmenu/version.py
@@ -1,6 +1,6 @@
 VERSION_MAJOR = 1
 VERSION_MINOR = 5
-VERSION_PATCH = 1
+VERSION_PATCH = 2
 
 
 version = '{}.{}.{}'.format(VERSION_MAJOR, VERSION_MINOR, VERSION_PATCH)

From d17ae6d6a588be1c700be664f3e746975661034a Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Wed, 25 May 2022 19:10:32 +0200
Subject: [PATCH 0350/1227] Change icon path and add nukestudio icon.

---
 openpype/resources/app_icons/nukestudio.png     | Bin 0 -> 46080 bytes
 .../defaults/system_settings/applications.json  |   4 ++--
 2 files changed, 2 insertions(+), 2 deletions(-)
 create mode 100644 openpype/resources/app_icons/nukestudio.png

diff --git a/openpype/resources/app_icons/nukestudio.png b/openpype/resources/app_icons/nukestudio.png
new file mode 100644
index 0000000000000000000000000000000000000000..99c95f59ff858d67fb92263f594f4b71bda87a66
GIT binary patch
literal 46080
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
HIsgA3TR*cj

literal 0
HcmV?d00001

diff --git a/openpype/settings/defaults/system_settings/applications.json b/openpype/settings/defaults/system_settings/applications.json
index 2b0de44fa9..29c8a1cccc 100644
--- a/openpype/settings/defaults/system_settings/applications.json
+++ b/openpype/settings/defaults/system_settings/applications.json
@@ -292,7 +292,7 @@
     "nukex": {
         "enabled": true,
         "label": "Nuke X",
-        "icon": "{}/app_icons/nuke.png",
+        "icon": "{}/app_icons/nukex.png",
         "host_name": "nuke",
         "environment": {
             "NUKE_PATH": [
@@ -431,7 +431,7 @@
     "nukestudio": {
         "enabled": true,
         "label": "Nuke Studio",
-        "icon": "{}/app_icons/nuke.png",
+        "icon": "{}/app_icons/nukestudio.png",
         "host_name": "hiero",
         "environment": {
             "WORKFILES_STARTUP": "0",

From d9a9981fefacc42a9e9466f6af6769f1605d4396 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 25 May 2022 19:37:14 +0200
Subject: [PATCH 0351/1227] Fix - Harmony 21.1 messed up Javascript Qt API

QDataStream is missing, different way to get codec used.
QApplication.activeWindow() also returned null, replaced by topLevelWidgets
---
 openpype/hosts/harmony/api/TB_sceneOpened.js | 31 +++++++++++---------
 1 file changed, 17 insertions(+), 14 deletions(-)

diff --git a/openpype/hosts/harmony/api/TB_sceneOpened.js b/openpype/hosts/harmony/api/TB_sceneOpened.js
index 6a403fa65e..29473bcc93 100644
--- a/openpype/hosts/harmony/api/TB_sceneOpened.js
+++ b/openpype/hosts/harmony/api/TB_sceneOpened.js
@@ -279,19 +279,13 @@ function Client() {
     };
 
     self._send = function(message) {
-        var data = new QByteArray();
-        var outstr = new QDataStream(data, QIODevice.WriteOnly);
-        outstr.writeInt(0);
-        data.append('UTF-8');
-        outstr.device().seek(0);
-        outstr.writeInt(data.size() - 4);
-        var codec = QTextCodec.codecForUtfText(data);
-        var msg = codec.fromUnicode(message);
-        var l = msg.size();
-        var coded = new QByteArray('AH').append(self.pack(l));
-        coded = coded.append(msg);
-        self.socket.write(new QByteArray(coded));
-        self.logDebug('Sent.');
+      var codec_name = new QByteArray().append("ISO-8859-1");
+      var codec = QTextCodec.codecForName(codec_name);
+      var msg = codec.fromUnicode(message);
+      var l = msg.size();
+      var coded = new QByteArray().append('AH').append(self.pack(l)).append(msg);
+      self.socket.write(new QByteArray(coded));
+      self.logDebug('Sent.');
     };
 
     self.waitForLock = function() {
@@ -343,6 +337,7 @@ function start() {
     var host = '127.0.0.1';
     /** port of the server */
     var port = parseInt(System.getenv('AVALON_HARMONY_PORT'));
+    MessageLog.trace("port " + port.toString());
 
     // Attach the client to the QApplication to preserve.
     var app = QCoreApplication.instance();
@@ -351,7 +346,15 @@ function start() {
         app.avalonClient = new Client();
         app.avalonClient.socket.connectToHost(host, port);
     }
-    var menuBar = QApplication.activeWindow().menuBar();
+    var mainWindow = null;
+    var widgets = QApplication.topLevelWidgets();
+    for (var i = 0 ; i < widgets.length; i++) {
+      if (widgets[i] instanceof QMainWindow){
+        MessageLog.trace('(DEBUG): START Main window ');
+          mainWindow = widgets[i];
+      }
+    }
+    var menuBar = mainWindow.menuBar();
     var actions = menuBar.actions();
     app.avalonMenu = null;
 

From f213a33f130d336ca8345ab64bbc6d1105c3a379 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 25 May 2022 19:40:40 +0200
Subject: [PATCH 0352/1227] Fix - Harmony 21.1 messed up Javascript Qt API

Removed missed logging
---
 openpype/hosts/harmony/api/TB_sceneOpened.js | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/hosts/harmony/api/TB_sceneOpened.js b/openpype/hosts/harmony/api/TB_sceneOpened.js
index 29473bcc93..610b0a73bb 100644
--- a/openpype/hosts/harmony/api/TB_sceneOpened.js
+++ b/openpype/hosts/harmony/api/TB_sceneOpened.js
@@ -337,7 +337,6 @@ function start() {
     var host = '127.0.0.1';
     /** port of the server */
     var port = parseInt(System.getenv('AVALON_HARMONY_PORT'));
-    MessageLog.trace("port " + port.toString());
 
     // Attach the client to the QApplication to preserve.
     var app = QCoreApplication.instance();
@@ -350,7 +349,6 @@ function start() {
     var widgets = QApplication.topLevelWidgets();
     for (var i = 0 ; i < widgets.length; i++) {
       if (widgets[i] instanceof QMainWindow){
-        MessageLog.trace('(DEBUG): START Main window ');
           mainWindow = widgets[i];
       }
     }

From c50cab558c80664e332d9831798d2754df1b89e1 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 26 May 2022 02:22:33 +0300
Subject: [PATCH 0353/1227] initial refactoring

---
 openpype/plugins/publish/extract_jpeg_exr.py | 191 +++++++++++--------
 1 file changed, 107 insertions(+), 84 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 070e9e1e08..52a678e9ef 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -8,6 +8,7 @@ from openpype.pipeline import (
 from openpype.lib import (
     get_ffmpeg_tool_path,
     get_oiio_tools_path,
+    is_oiio_supported,
 
     filter_profiles,
     run_subprocess,
@@ -89,99 +90,121 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
 
             full_input_path = os.path.join(stagingdir, input_file)
             self.log.info("input {}".format(full_input_path))
-
-            do_convert = should_convert_for_ffmpeg(full_input_path)
-            # If result is None the requirement of conversion can't be
-            #   determined
-            if do_convert is None:
-                self.log.info((
-                    "Can't determine if representation requires conversion."
-                    " Skipped."
-                ))
-                continue
-
-            # Do conversion if needed
-            #   - change staging dir of source representation
-            #   - must be set back after output definitions processing
-            convert_dir = None
-            if do_convert:
-                convert_dir = get_transcode_temp_directory()
-                filename = os.path.basename(full_input_path)
-                convert_input_paths_for_ffmpeg(
-                    [full_input_path],
-                    convert_dir,
-                    self.log
-                )
-                full_input_path = os.path.join(convert_dir, filename)
-
-            filename = os.path.splitext(input_file)[0]
-            if not filename.endswith('.'):
-                filename += "."
-            jpeg_file = filename + "jpg"
-            full_output_path = os.path.join(stagingdir, jpeg_file)
-
-            self.log.info("output {}".format(full_output_path))
-
-            ffmpeg_path = get_ffmpeg_tool_path("ffmpeg")
-            ffmpeg_args = self.ffmpeg_args or {}
-
-            jpeg_items = []
-            jpeg_items.append(path_to_subprocess_arg(ffmpeg_path))
-            # override file if already exists
-            jpeg_items.append("-y")
-            # use same input args like with mov
-            jpeg_items.extend(ffmpeg_args.get("input") or [])
-            # input file
-            jpeg_items.append("-i {}".format(
-                path_to_subprocess_arg(full_input_path)
-            ))
-            # output arguments from presets
-            jpeg_items.extend(ffmpeg_args.get("output") or [])
-
-            # If its a movie file, we just want one frame.
+            # If it's a movie file, use ffmpeg 
             if repre["ext"] == "mov":
+                do_convert = should_convert_for_ffmpeg(full_input_path)
+                # If result is None the requirement of conversion can't be
+                #   determined
+                if do_convert is None:
+                    self.log.info((
+                        "Can't determine if representation requires conversion."
+                        " Skipped."
+                    ))
+                    continue
+
+                # Do conversion if needed
+                #   - change staging dir of source representation
+                #   - must be set back after output definitions processing
+                convert_dir = None
+                if do_convert:
+                    convert_dir = get_transcode_temp_directory()
+                    filename = os.path.basename(full_input_path)
+                    convert_input_paths_for_ffmpeg(
+                        [full_input_path],
+                        convert_dir,
+                        self.log
+                    )
+                    full_input_path = os.path.join(convert_dir, filename)
+
+                filename = os.path.splitext(input_file)[0]
+                if not filename.endswith('.'):
+                    filename += "."
+                jpeg_file = filename + "jpg"
+                full_output_path = os.path.join(stagingdir, jpeg_file)
+
+                self.log.info("output {}".format(full_output_path))
+
+                ffmpeg_path = get_ffmpeg_tool_path("ffmpeg")
+                ffmpeg_args = self.ffmpeg_args or {}
+
+                jpeg_items = []
+                jpeg_items.append(path_to_subprocess_arg(ffmpeg_path))
+                # override file if already exists
+                jpeg_items.append("-y")
+                # use same input args like with mov
+                jpeg_items.extend(ffmpeg_args.get("input") or [])
+                # input file
+                jpeg_items.append("-i {}".format(
+                    path_to_subprocess_arg(full_input_path)
+                ))
+                # output arguments from presets
+                jpeg_items.extend(ffmpeg_args.get("output") or [])
+                # we just want one frame from movie files
                 jpeg_items.append("-vframes 1")
 
-            # output file
-            jpeg_items.append(path_to_subprocess_arg(full_output_path))
-            subprocess_command = " ".join(jpeg_items)
+                # output file
+                jpeg_items.append(path_to_subprocess_arg(full_output_path))
+                subprocess_command = " ".join(jpeg_items)
 
-            # run subprocess
-            self.log.debug("{}".format(subprocess_command))
-            try:  # temporary until oiiotool is supported cross platform
-                run_subprocess(
-                    subprocess_command, shell=True, logger=self.log
-                )
-            except RuntimeError as exp:
-                if "Compression" in str(exp):
-                    self.log.debug(
-                        "Unsupported compression on input files. Skipping!!!"
+                # run subprocess
+                self.log.debug("{}".format(subprocess_command))
+                try:  # temporary until oiiotool is supported cross platform
+                    run_subprocess(
+                        subprocess_command, shell=True, logger=self.log
                     )
-                    return
-                self.log.warning("Conversion crashed", exc_info=True)
-                raise
+                except RuntimeError as exp:
+                    if "Compression" in str(exp):
+                        self.log.debug(
+                            "Unsupported compression on input files. Skipping!"
+                        )
+                        return
+                    self.log.warning("Conversion crashed", exc_info=True)
+                    raise
 
-            new_repre = {
-                "name": "thumbnail",
-                "ext": "jpg",
-                "files": jpeg_file,
-                "stagingDir": stagingdir,
-                "thumbnail": True,
-                "tags": ["thumbnail"]
-            }
+                new_repre = {
+                    "name": "thumbnail",
+                    "ext": "jpg",
+                    "files": jpeg_file,
+                    "stagingDir": stagingdir,
+                    "thumbnail": True,
+                    "tags": ["thumbnail"]
+                }
 
-            # adding representation
-            self.log.debug("Adding: {}".format(new_repre))
-            instance.data["representations"].append(new_repre)
+                # adding representation
+                self.log.debug("Adding: {}".format(new_repre))
+                instance.data["representations"].append(new_repre)
 
-            # Cleanup temp folder
-            if convert_dir is not None and os.path.exists(convert_dir):
-                shutil.rmtree(convert_dir)
+                # Cleanup temp folder
+                if convert_dir is not None and os.path.exists(convert_dir):
+                    shutil.rmtree(convert_dir)
 
-            # Create only one representation with name 'thumbnail'
-            # TODO maybe handle way how to decide from which representation
-            #   will be thumbnail created
-            break
+            elif repre["ext"] == "exr":
+                oiio_support = is_oiio_supported()
+                
+                if oiio_support:
+                    oiio_tool_path = get_oiio_tools_path()
+                    args = [oiio_tool_path]
+
+                    ext = os.path.splitext(input_path)[1][1:]
+                    if ext in self.movie_extensions:
+                        args.extend(["--subimage", str(int(input_frame))])
+                    else:
+                        args.extend(["--frames", str(int(input_frame))])
+
+                    if ext == "exr":
+                        args.extend(["--powc", "0.45,0.45,0.45,1.0"])
+
+                    args.extend([input_path, "-o", output_path])
+                    output = openpype.api.run_subprocess(args)
+
+                    failed_output = "oiiotool produced no output."
+                    if failed_output in output:
+                    raise ValueError(
+                        "oiiotool processing failed. Args: {}".format(args)
+                # Create only one representation with name 'thumbnail'
+                # TODO maybe handle way how to decide from which representation
+                #   will be thumbnail created
+                break
 
     def _get_filtered_repres(self, instance):
         filtered_repres = []

From d992935468c488fdd4fe783cd7ce797d6f27ca50 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 26 May 2022 02:31:56 +0300
Subject: [PATCH 0354/1227] name probesize and duration to max_int

---
 openpype/plugins/publish/extract_jpeg_exr.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 52a678e9ef..066272fd01 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -1,4 +1,5 @@
 import os
+from urllib.parse import MAX_CACHE_SIZE
 
 import pyblish.api
 from openpype.pipeline import ( 
@@ -131,6 +132,10 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                 jpeg_items.append(path_to_subprocess_arg(ffmpeg_path))
                 # override file if already exists
                 jpeg_items.append("-y")
+                # flag for large file sizes
+                max_int = 2147483647
+                jpeg_items.append("-analyzeduration {}".format(max_int))
+                jpeg_items.append("-probesize {}".format(max_int))
                 # use same input args like with mov
                 jpeg_items.extend(ffmpeg_args.get("input") or [])
                 # input file

From cc4efe7638340e0ab64857f6e00b676cfa4bb77e Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 26 May 2022 06:02:00 +0300
Subject: [PATCH 0355/1227] style fix

---
 openpype/plugins/publish/extract_jpeg_exr.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 066272fd01..52457ebb31 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -185,7 +185,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
 
             elif repre["ext"] == "exr":
                 oiio_support = is_oiio_supported()
-                
+
                 if oiio_support:
                     oiio_tool_path = get_oiio_tools_path()
                     args = [oiio_tool_path]

From 70c5366134ccafb066c40097907b958496392190 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 26 May 2022 07:25:09 +0300
Subject: [PATCH 0356/1227] Additional oiiotool conversion refactoring, some
 style fixes

---
 openpype/plugins/publish/extract_jpeg_exr.py | 123 +++++++++++--------
 1 file changed, 69 insertions(+), 54 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 52457ebb31..bb3b80b7ef 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -91,38 +91,41 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
 
             full_input_path = os.path.join(stagingdir, input_file)
             self.log.info("input {}".format(full_input_path))
-            # If it's a movie file, use ffmpeg 
+           
+            
+            # Presumably the following is not needed since we are being
+            # explicit
+            # TODO: Test cases, cleanup.
+            # do_convert = should_convert_for_ffmpeg(full_input_path)
+            # # If result is None the requirement of conversion can't be
+            # #   determined
+            # if do_convert is None:
+            #     self.log.info((
+            #         "Can't determine if representation requires conversion." # noqa
+            #         " Skipped."
+            #     ))
+            #     continue
+            #
+            # # Do conversion if needed
+            # #   - change staging dir of source representation
+            # #   - must be set back after output definitions processing
+            # convert_dir = None
+            # if do_convert:
+            #     convert_dir = get_transcode_temp_directory()
+            #     filename = os.path.basename(full_input_path)
+            #     convert_input_paths_for_ffmpeg(
+            #         [full_input_path],
+            #         convert_dir,
+            #         self.log
+            #     )
+            #     full_input_path = os.path.join(convert_dir, filename)
+            filename = os.path.splitext(input_file)[0]
+            if not filename.endswith('.'):
+                filename += "."
+            jpeg_file = filename + "jpg"
+            full_output_path = os.path.join(stagingdir, jpeg_file)
+            # If it's a movie file, use ffmpeg
             if repre["ext"] == "mov":
-                do_convert = should_convert_for_ffmpeg(full_input_path)
-                # If result is None the requirement of conversion can't be
-                #   determined
-                if do_convert is None:
-                    self.log.info((
-                        "Can't determine if representation requires conversion."
-                        " Skipped."
-                    ))
-                    continue
-
-                # Do conversion if needed
-                #   - change staging dir of source representation
-                #   - must be set back after output definitions processing
-                convert_dir = None
-                if do_convert:
-                    convert_dir = get_transcode_temp_directory()
-                    filename = os.path.basename(full_input_path)
-                    convert_input_paths_for_ffmpeg(
-                        [full_input_path],
-                        convert_dir,
-                        self.log
-                    )
-                    full_input_path = os.path.join(convert_dir, filename)
-
-                filename = os.path.splitext(input_file)[0]
-                if not filename.endswith('.'):
-                    filename += "."
-                jpeg_file = filename + "jpg"
-                full_output_path = os.path.join(stagingdir, jpeg_file)
-
                 self.log.info("output {}".format(full_output_path))
 
                 ffmpeg_path = get_ffmpeg_tool_path("ffmpeg")
@@ -178,37 +181,49 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                 # adding representation
                 self.log.debug("Adding: {}".format(new_repre))
                 instance.data["representations"].append(new_repre)
-
-                # Cleanup temp folder
-                if convert_dir is not None and os.path.exists(convert_dir):
-                    shutil.rmtree(convert_dir)
-
             elif repre["ext"] == "exr":
                 oiio_support = is_oiio_supported()
-
                 if oiio_support:
+                    # TODO: Add resolution checking, possibly check for other
+                    # places where things may break
                     oiio_tool_path = get_oiio_tools_path()
+                    full_output_path = os.path.join(stagingdir, jpeg_file)
                     args = [oiio_tool_path]
+                    oiio_cmd = [oiio_tool_path,
+                                full_input_path, "-o",
+                                full_output_path
+                                ]
+                    subprocess_exr = " ".join(oiio_cmd)
+                    self.log.info(f"running: {subprocess_exr}")
+                    run_subprocess(subprocess_exr, logger=self.log)
 
-                    ext = os.path.splitext(input_path)[1][1:]
-                    if ext in self.movie_extensions:
-                        args.extend(["--subimage", str(int(input_frame))])
-                    else:
-                        args.extend(["--frames", str(int(input_frame))])
-
-                    if ext == "exr":
-                        args.extend(["--powc", "0.45,0.45,0.45,1.0"])
-
-                    args.extend([input_path, "-o", output_path])
-                    output = openpype.api.run_subprocess(args)
-
+                    # raise error if there is no ouptput
+                    if not os.path.exists(full_input_path):
+                        self.log.error(
+                            ("File {} was not converted "
+                             "by oiio tool!").format(full_input_path))
+                        raise AssertionError("OIIO tool conversion failed")
                     failed_output = "oiiotool produced no output."
+                    output = run_subprocess(args)
                     if failed_output in output:
-                    raise ValueError(
-                        "oiiotool processing failed. Args: {}".format(args)
-                # Create only one representation with name 'thumbnail'
-                # TODO maybe handle way how to decide from which representation
-                #   will be thumbnail created
+                        raise ValueError(
+                            "oiiotool processing failed. Args: {}".format(args))
+
+                    new_repre = {
+                        "name": "thumbnail",
+                        "ext": "jpg",
+                        "files": jpeg_file,
+                        "stagingDir": stagingdir,
+                        "thumbnail": True,
+                        "tags": ["thumbnail"]
+                    }
+                    # adding representation
+                    self.log.debug("Adding: {}".format(new_repre))
+                    instance.data["representations"].append(new_repre)
+
+                    # Create only one representation with name 'thumbnail'
+                    # TODO maybe handle way how to decide from which repre
+                    # will be thumbnail created
                 break
 
     def _get_filtered_repres(self, instance):

From 78ddd548287c00eb99aaeb99624d380314172052 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 26 May 2022 10:42:31 +0200
Subject: [PATCH 0357/1227] init file for tvpaint worker also has set path to
 not existing file in guidelines

---
 openpype/hosts/tvpaint/worker/init_file.tvpp | Bin 59333 -> 59973 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/openpype/hosts/tvpaint/worker/init_file.tvpp b/openpype/hosts/tvpaint/worker/init_file.tvpp
index 572d278fdb49c619d3cf040f59238377d1062d6a..22170b45bc728d3d46193a35fa5216e5c739e8cf 100644
GIT binary patch
delta 627
zcmZ`!&r94u6n-1o7WW`Zp|ppVoa$-UWMbA$V4$EB5B?|x5xnSZcA6b`HWPLdQ4j>h
zOHVDi6%=}`g_aV$mEuM4=0(uIz|#H|eTnu`^ufFz-+SNt=AE7oon8#RfBgJU-PvFA
zf4m&KJluxSm2XF1ptOhE7+!pzoHw4j-~)jsm|%g2xl?)qUjETIFe*;gsvbWYhFK7x
zApr#g*n&FP*<97TgFJ;RY#`ZTb@2`sxrbE<qa?Dl)5NR+E&Pa$zWCY*ETJ|><>gYp
z2h-361`&jaR)FL)4}MD{{hCeaH6xwNKj_^`O`pA5d@~QAPx5E!yS6drWS=k3t1J~A
zmF-<k?pUi##$85<>(*}bzUpvFib`vt6KY`^C@ER2Ikj&JHK3Mhla`6R;vxE0inyHZ
ziKs)T5Rt6SC0$U7$v1J4h(c5JS;!mfaagof(A(jilGA5{5SKR*R_%2jpz5vFi};`W
z*Td<UC0#o0Pu!~#D=iYCBI<b!*Q}G`fPqR_iCN=V>43?b!*s;r^1=<FMY{w8l|~7*
j^Pg9<BTrnPG)>F%9nU9TO){MXT^5Br`*cmR*T2%g@OG;2

delta 199
zcmX?lh56`t<_ThQ&(|8ahFa}$5WGIGhCv`|{i@XrV8A8<q*OMV_%cnlW)fnzWUyi|
zW-#15i)k(sqv2!=)~%C6*;NEh8H^b87%YL%9E^=8cd;un8g5?0{xXNDWZLBEB?(L=
zCYyhjG%<1&ZE*7s@?~HsTCusctSgC0Kzg#^&GX#F`K5U&3YmEYr6rS}-ZWuP2J%a6
r4K~}|_TZB+u`)DLFa(m8R>p>0If=z3$r*`x>8X<yUm8um@Uj#Dj&VR;


From c9c6fe34fe63fff1e4ba57d73bab6c361e7203ca Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 26 May 2022 10:42:37 +0200
Subject: [PATCH 0358/1227] OP-2787 - changed assert to
 PublishXmlValidationError

---
 .../help/submit_maya_remote_publish_deadline.xml | 16 ++++++++++++++++
 .../submit_maya_remote_publish_deadline.py       |  8 ++++----
 2 files changed, 20 insertions(+), 4 deletions(-)
 create mode 100644 openpype/hosts/maya/plugins/publish/help/submit_maya_remote_publish_deadline.xml

diff --git a/openpype/hosts/maya/plugins/publish/help/submit_maya_remote_publish_deadline.xml b/openpype/hosts/maya/plugins/publish/help/submit_maya_remote_publish_deadline.xml
new file mode 100644
index 0000000000..e92320ccdc
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/help/submit_maya_remote_publish_deadline.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<root>
+<error id="main">
+<title>Errors found</title>
+<description>
+## Publish process has errors
+
+At least one plugin failed before this plugin, job won't be sent to Deadline for processing before all issues are fixed.
+
+### How to repair?
+
+Check all failing plugins (should be highlighted in red) and fix issues if possible.
+</description>
+
+</error>
+</root>
\ No newline at end of file
diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
index b11698f8e8..be8c50d7b3 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
@@ -3,7 +3,7 @@ import requests
 
 from maya import cmds
 
-from openpype.pipeline import legacy_io
+from openpype.pipeline import legacy_io, PublishXmlValidationError
 from openpype.settings import get_project_settings
 
 import pyblish.api
@@ -39,9 +39,9 @@ class MayaSubmitRemotePublishDeadline(pyblish.api.InstancePlugin):
                                      ["ProcessSubmittedJobOnFarm"])
 
         # Ensure no errors so far
-        assert (all(result["success"]
-                    for result in instance.context.data["results"]),
-                    ("Errors found, aborting integration.."))
+        if not (all(result["success"]
+                for result in instance.context.data["results"])):
+            raise PublishXmlValidationError("Publish process has errors")
 
         if not instance.data["publish"]:
             self.log.warning("No active instances found. "

From 4ca419f0b63c2782d8955b8012674ca131a57ad9 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 26 May 2022 11:36:49 +0200
Subject: [PATCH 0359/1227] Revert "OP-2787 - removed deadline family"

This reverts commit 6b71ff19
---
 .../maya/plugins/publish/collect_animation.py      |  3 +++
 .../maya/plugins/publish/collect_pointcache.py     | 14 ++++++++++++++
 2 files changed, 17 insertions(+)
 create mode 100644 openpype/hosts/maya/plugins/publish/collect_pointcache.py

diff --git a/openpype/hosts/maya/plugins/publish/collect_animation.py b/openpype/hosts/maya/plugins/publish/collect_animation.py
index 9b1e38fd0a..b442113fbc 100644
--- a/openpype/hosts/maya/plugins/publish/collect_animation.py
+++ b/openpype/hosts/maya/plugins/publish/collect_animation.py
@@ -55,3 +55,6 @@ class CollectAnimationOutputGeometry(pyblish.api.InstancePlugin):
 
         # Store data in the instance for the validator
         instance.data["out_hierarchy"] = hierarchy
+
+        if instance.data.get("farm"):
+            instance.data["families"].append("deadline")
diff --git a/openpype/hosts/maya/plugins/publish/collect_pointcache.py b/openpype/hosts/maya/plugins/publish/collect_pointcache.py
new file mode 100644
index 0000000000..b55babe372
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/collect_pointcache.py
@@ -0,0 +1,14 @@
+import pyblish.api
+
+
+class CollectPointcache(pyblish.api.InstancePlugin):
+    """Collect pointcache data for instance."""
+
+    order = pyblish.api.CollectorOrder + 0.4
+    families = ["pointcache"]
+    label = "Collect Pointcache"
+    hosts = ["maya"]
+
+    def process(self, instance):
+        if instance.data.get("farm"):
+            instance.data["families"].append("deadline")
\ No newline at end of file

From c96ea856425550835c7c5dfc42b1965a54ca0902 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 26 May 2022 11:40:19 +0200
Subject: [PATCH 0360/1227] OP-2787 - change families to more generic

Not only Deadline could be used for remote publish. DL plugin will be picked only if DL module is enabled.
---
 openpype/hosts/maya/plugins/publish/collect_animation.py        | 2 +-
 openpype/hosts/maya/plugins/publish/collect_pointcache.py       | 2 +-
 .../plugins/publish/submit_maya_remote_publish_deadline.py      | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_animation.py b/openpype/hosts/maya/plugins/publish/collect_animation.py
index b442113fbc..549098863f 100644
--- a/openpype/hosts/maya/plugins/publish/collect_animation.py
+++ b/openpype/hosts/maya/plugins/publish/collect_animation.py
@@ -57,4 +57,4 @@ class CollectAnimationOutputGeometry(pyblish.api.InstancePlugin):
         instance.data["out_hierarchy"] = hierarchy
 
         if instance.data.get("farm"):
-            instance.data["families"].append("deadline")
+            instance.data["families"].append("publish.farm")
diff --git a/openpype/hosts/maya/plugins/publish/collect_pointcache.py b/openpype/hosts/maya/plugins/publish/collect_pointcache.py
index b55babe372..a841341f72 100644
--- a/openpype/hosts/maya/plugins/publish/collect_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/collect_pointcache.py
@@ -11,4 +11,4 @@ class CollectPointcache(pyblish.api.InstancePlugin):
 
     def process(self, instance):
         if instance.data.get("farm"):
-            instance.data["families"].append("deadline")
\ No newline at end of file
+            instance.data["families"].append("publish.farm")
diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
index be8c50d7b3..210fefb520 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
@@ -29,7 +29,7 @@ class MayaSubmitRemotePublishDeadline(pyblish.api.InstancePlugin):
     label = "Submit Scene to Deadline"
     order = pyblish.api.IntegratorOrder
     hosts = ["maya"]
-    families = ["deadline"]
+    families = ["publish.farm"]
 
     def process(self, instance):
         settings = get_project_settings(os.getenv("AVALON_PROJECT"))

From 0d03e3e2f836476310b899a21aec5b49dbd2a7c8 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 26 May 2022 11:40:50 +0200
Subject: [PATCH 0361/1227] OP-2787 - removed obsolete part of code

Doesn't do anything.
---
 openpype/hosts/maya/plugins/publish/extract_animation.py  | 7 +------
 openpype/hosts/maya/plugins/publish/extract_pointcache.py | 7 +------
 2 files changed, 2 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_animation.py b/openpype/hosts/maya/plugins/publish/extract_animation.py
index 87f2d35192..1ccc8f5cfe 100644
--- a/openpype/hosts/maya/plugins/publish/extract_animation.py
+++ b/openpype/hosts/maya/plugins/publish/extract_animation.py
@@ -24,12 +24,7 @@ class ExtractAnimation(openpype.api.Extractor):
 
     def process(self, instance):
         if instance.data.get("farm"):
-            path = os.path.join(
-                os.path.dirname(instance.context.data["currentFile"]),
-                "cache",
-                instance.data["name"] + ".abc"
-            )
-            instance.data["expectedFiles"] = [os.path.normpath(path)]
+            self.log.debug("Should be processed on farm, skipping.")
             return
 
         # Collect the out set nodes
diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index 7ad4c6dfa9..ff3d97ded1 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -26,12 +26,7 @@ class ExtractAlembic(openpype.api.Extractor):
 
     def process(self, instance):
         if instance.data.get("farm"):
-            path = os.path.join(
-                os.path.dirname(instance.context.data["currentFile"]),
-                "cache",
-                instance.data["name"] + ".abc"
-            )
-            instance.data["expectedFiles"] = [os.path.normpath(path)]
+            self.log.debug("Should be processed on farm, skipping.")
             return
 
         nodes = instance[:]

From de161da68b4035c4fde2e376dc8da1ab2b79d093 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 26 May 2022 11:45:29 +0200
Subject: [PATCH 0362/1227] OP-2787 - created explicit env var HEADLESS_PUBLISH

Env var created to differentiate launch of Maya on the farm. lib.IS_HEADLESS might be triggered locally, it is not precise enough.

Added same env var to all commands to standardize it a bit.
---
 openpype/hosts/maya/api/pipeline.py            |  5 ++++-
 .../submit_maya_remote_publish_deadline.py     |  2 ++
 openpype/pype_commands.py                      | 18 +++++++++++++-----
 3 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index c2fe8a95a5..6fc93e864f 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -72,7 +72,10 @@ def install():
         log.info(("Running in headless mode, skipping Maya "
                  "save/open/new callback installation.."))
 
-        # Register default "local" target
+        return
+
+    if os.environ.get("HEADLESS_PUBLISH"):
+        # Maya launched on farm, lib.IS_HEADLESS might be triggered locally too
         print("Registering pyblish target: remote")
         pyblish.api.register_target("remote")
         return
diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
index 210fefb520..8f50878db4 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
@@ -114,6 +114,8 @@ class MayaSubmitRemotePublishDeadline(pyblish.api.InstancePlugin):
         environment["OPENPYPE_REMOTE_JOB"] = "1"
         environment["OPENPYPE_USERNAME"] = instance.context.data["user"]
         environment["OPENPYPE_PUBLISH_SUBSET"] = instance.data["subset"]
+        environment["HEADLESS_PUBLISH"] = "1"
+
 
         payload["JobInfo"].update({
             "EnvironmentKeyValue%d" % index: "{key}={value}".format(
diff --git a/openpype/pype_commands.py b/openpype/pype_commands.py
index d945a1f697..90c582a319 100644
--- a/openpype/pype_commands.py
+++ b/openpype/pype_commands.py
@@ -144,6 +144,7 @@ class PypeCommands:
             pyblish.api.register_target("farm")
 
         os.environ["OPENPYPE_PUBLISH_DATA"] = os.pathsep.join(paths)
+        os.environ["HEADLESS_PUBLISH"] = 'true'  # to use in app lib
 
         log.info("Running publish ...")
 
@@ -173,9 +174,11 @@ class PypeCommands:
                              user_email, targets=None):
         """Opens installed variant of 'host' and run remote publish there.
 
+        Eventually should be yanked out to Webpublisher cli.
+
         Currently implemented and tested for Photoshop where customer
         wants to process uploaded .psd file and publish collected layers
-        from there.
+        from there. Triggered by Webpublisher.
 
         Checks if no other batches are running (status =='in_progress). If
         so, it sleeps for SLEEP (this is separate process),
@@ -273,7 +276,8 @@ class PypeCommands:
     def remotepublish(project, batch_path, user_email, targets=None):
         """Start headless publishing.
 
-        Used to publish rendered assets, workfiles etc.
+        Used to publish rendered assets, workfiles etc via Webpublisher.
+        Eventually should be yanked out to Webpublisher cli.
 
         Publish use json from passed paths argument.
 
@@ -309,6 +313,7 @@ class PypeCommands:
         os.environ["AVALON_PROJECT"] = project
         os.environ["AVALON_APP"] = host_name
         os.environ["USER_EMAIL"] = user_email
+        os.environ["HEADLESS_PUBLISH"] = 'true'  # to use in app lib
 
         pyblish.api.register_host(host_name)
 
@@ -331,9 +336,12 @@ class PypeCommands:
         log.info("Publish finished.")
 
     @staticmethod
-    def extractenvironments(
-        output_json_path, project, asset, task, app, env_group
-    ):
+    def extractenvironments(output_json_path, project, asset, task, app,
+                            env_group):
+        """Produces json file with environment based on project and app.
+
+        Called by Deadline plugin to propagate environment into render jobs.
+        """
         if all((project, asset, task, app)):
             from openpype.api import get_app_environments_for_context
             env = get_app_environments_for_context(

From 8cda0ebbeef23ceccc7f1a9d9963eecc93219012 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 26 May 2022 12:09:13 +0200
Subject: [PATCH 0363/1227] OP-2787 - Hound

---
 .../plugins/publish/collect_publishable_instances.py       | 7 ++++---
 .../plugins/publish/submit_maya_remote_publish_deadline.py | 1 -
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/collect_publishable_instances.py b/openpype/modules/deadline/plugins/publish/collect_publishable_instances.py
index 9a467428fd..741a2a5af8 100644
--- a/openpype/modules/deadline/plugins/publish/collect_publishable_instances.py
+++ b/openpype/modules/deadline/plugins/publish/collect_publishable_instances.py
@@ -5,6 +5,7 @@
 import os
 
 import pyblish.api
+from openpype.pipeline import PublishValidationError
 
 
 class CollectDeadlinePublishableInstances(pyblish.api.InstancePlugin):
@@ -24,9 +25,9 @@ class CollectDeadlinePublishableInstances(pyblish.api.InstancePlugin):
     def process(self, instance):
         self.log.debug("CollectDeadlinePublishableInstances")
         publish_inst = os.environ.get("OPENPYPE_PUBLISH_SUBSET", '')
-        assert (publish_inst,
-                "OPENPYPE_PUBLISH_SUBSET env var required for "
-                "remote publishing")
+        if not publish_inst:
+            raise PublishValidationError("OPENPYPE_PUBLISH_SUBSET env var "
+                                         "required for remote publishing")
 
         subset_name = instance.data["subset"]
         if subset_name == publish_inst:
diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
index 8f50878db4..196adc5906 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
@@ -116,7 +116,6 @@ class MayaSubmitRemotePublishDeadline(pyblish.api.InstancePlugin):
         environment["OPENPYPE_PUBLISH_SUBSET"] = instance.data["subset"]
         environment["HEADLESS_PUBLISH"] = "1"
 
-
         payload["JobInfo"].update({
             "EnvironmentKeyValue%d" % index: "{key}={value}".format(
                 key=key,

From cd975beeec54fc6c13a808db8ae085c5cc9560b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Je=C5=BEek?= <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 14:00:41 +0200
Subject: [PATCH 0364/1227] Update
 openpype/hosts/nuke/plugins/publish/extract_slate_frame.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../hosts/nuke/plugins/publish/extract_slate_frame.py     | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
index 576f8b3440..2d20c1747c 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
@@ -75,7 +75,13 @@ class ExtractSlateFrame(openpype.api.Extractor):
         self.log.info(
             "StagingDir `{0}`...".format(instance.data["stagingDir"]))
 
-    def render_slate(self, instance, output_name=None, **kwargs):
+    def render_slate(
+        self,
+        instance,
+        bake_viewer_process,
+        bake_viewer_input_process,
+        output_name=None
+    ):
         slate_node = instance.data["slateNode"]
 
         # fill slate node with comments

From 15822591793cb94ea730941358abb0a06dac211c Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 26 May 2022 14:07:30 +0200
Subject: [PATCH 0365/1227] :truck: split versions of integration plugin

---
 openpype/hosts/unreal/__init__.py             |  10 +-
 .../integration/{ => UE_4.7}/.gitignore       |   0
 .../Content/Python/init_unreal.py             |   0
 .../integration/{ => UE_4.7}/OpenPype.uplugin |   0
 .../unreal/integration/{ => UE_4.7}/README.md |   2 +-
 .../{ => UE_4.7}/Resources/openpype128.png    | Bin
 .../{ => UE_4.7}/Resources/openpype40.png     | Bin
 .../{ => UE_4.7}/Resources/openpype512.png    | Bin
 .../UE_4.7/Source/OpenPype/OpenPype.Build.cs  |  57 +++++++++
 .../OpenPype/Private/AssetContainer.cpp       |   0
 .../Private/AssetContainerFactory.cpp         |   0
 .../Source/OpenPype/Private/OpenPype.cpp      | 103 ++++++++++++++++
 .../Source/OpenPype/Private/OpenPypeLib.cpp   |   0
 .../Private/OpenPypePublishInstance.cpp       |   0
 .../OpenPypePublishInstanceFactory.cpp        |   0
 .../OpenPype/Private/OpenPypePythonBridge.cpp |   0
 .../Source/OpenPype/Private/OpenPypeStyle.cpp |  70 +++++++++++
 .../Source/OpenPype/Public/AssetContainer.h   |   0
 .../OpenPype/Public/AssetContainerFactory.h   |   0
 .../UE_4.7/Source/OpenPype/Public/OpenPype.h  |  21 ++++
 .../Source/OpenPype/Public/OpenPypeLib.h      |   0
 .../OpenPype/Public/OpenPypePublishInstance.h |   0
 .../Public/OpenPypePublishInstanceFactory.h   |   0
 .../OpenPype/Public/OpenPypePythonBridge.h    |   0
 .../Source/OpenPype/Public/OpenPypeStyle.h    |  22 ++++
 .../unreal/integration/UE_5.0/.gitignore      |  35 ++++++
 .../UE_5.0/Content/Python/__init__.py         |   0
 .../UE_5.0/Content/Python/init_unreal.py      |  28 +++++
 .../integration/UE_5.0/Content/__init__.py    |   0
 .../integration/UE_5.0/OpenPype.uplugin       |  24 ++++
 .../hosts/unreal/integration/UE_5.0/README.md |  11 ++
 .../UE_5.0/Resources/openpype128.png          | Bin 0 -> 14594 bytes
 .../UE_5.0/Resources/openpype40.png           | Bin 0 -> 4884 bytes
 .../UE_5.0/Resources/openpype512.png          | Bin 0 -> 85856 bytes
 .../Source/OpenPype/OpenPype.Build.cs         |   0
 .../OpenPype/Private/AssetContainer.cpp       | 115 ++++++++++++++++++
 .../Private/AssetContainerFactory.cpp         |  20 +++
 .../Source/OpenPype/Private/OpenPype.cpp      |   0
 .../OpenPype/Private/OpenPypeCommands.cpp     |   0
 .../Source/OpenPype/Private/OpenPypeLib.cpp   |  48 ++++++++
 .../Private/OpenPypePublishInstance.cpp       | 108 ++++++++++++++++
 .../OpenPypePublishInstanceFactory.cpp        |  20 +++
 .../OpenPype/Private/OpenPypePythonBridge.cpp |  13 ++
 .../Source/OpenPype/Private/OpenPypeStyle.cpp |   0
 .../Source/OpenPype/Public/AssetContainer.h   |  39 ++++++
 .../OpenPype/Public/AssetContainerFactory.h   |  21 ++++
 .../Source/OpenPype/Public/OpenPype.h         |   0
 .../Source/OpenPype/Public/OpenPypeCommands.h |   0
 .../Source/OpenPype/Public/OpenPypeLib.h      |  19 +++
 .../OpenPype/Public/OpenPypePublishInstance.h |  21 ++++
 .../Public/OpenPypePublishInstanceFactory.h   |  19 +++
 .../OpenPype/Public/OpenPypePythonBridge.h    |  20 +++
 .../Source/OpenPype/Public/OpenPypeStyle.h    |   0
 .../system_settings/applications.json         |  12 +-
 repos/avalon-core                             |   1 -
 55 files changed, 854 insertions(+), 5 deletions(-)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/.gitignore (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Content/Python/init_unreal.py (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/OpenPype.uplugin (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/README.md (91%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Resources/openpype128.png (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Resources/openpype40.png (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Resources/openpype512.png (100%)
 create mode 100644 openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/OpenPype.Build.cs
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Private/AssetContainer.cpp (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Private/AssetContainerFactory.cpp (100%)
 create mode 100644 openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPype.cpp
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Private/OpenPypeLib.cpp (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Private/OpenPypePublishInstance.cpp (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Private/OpenPypePublishInstanceFactory.cpp (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Private/OpenPypePythonBridge.cpp (100%)
 create mode 100644 openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypeStyle.cpp
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Public/AssetContainer.h (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Public/AssetContainerFactory.h (100%)
 create mode 100644 openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPype.h
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Public/OpenPypeLib.h (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Public/OpenPypePublishInstance.h (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Public/OpenPypePublishInstanceFactory.h (100%)
 rename openpype/hosts/unreal/integration/{ => UE_4.7}/Source/OpenPype/Public/OpenPypePythonBridge.h (100%)
 create mode 100644 openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypeStyle.h
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/.gitignore
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Content/Python/__init__.py
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Content/Python/init_unreal.py
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Content/__init__.py
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/OpenPype.uplugin
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/README.md
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Resources/openpype128.png
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Resources/openpype40.png
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Resources/openpype512.png
 rename openpype/hosts/unreal/integration/{ => UE_5.0}/Source/OpenPype/OpenPype.Build.cs (100%)
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/AssetContainer.cpp
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/AssetContainerFactory.cpp
 rename openpype/hosts/unreal/integration/{ => UE_5.0}/Source/OpenPype/Private/OpenPype.cpp (100%)
 rename openpype/hosts/unreal/integration/{ => UE_5.0}/Source/OpenPype/Private/OpenPypeCommands.cpp (100%)
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypeLib.cpp
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePublishInstance.cpp
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePublishInstanceFactory.cpp
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePythonBridge.cpp
 rename openpype/hosts/unreal/integration/{ => UE_5.0}/Source/OpenPype/Private/OpenPypeStyle.cpp (100%)
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/AssetContainer.h
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/AssetContainerFactory.h
 rename openpype/hosts/unreal/integration/{ => UE_5.0}/Source/OpenPype/Public/OpenPype.h (100%)
 rename openpype/hosts/unreal/integration/{ => UE_5.0}/Source/OpenPype/Public/OpenPypeCommands.h (100%)
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypeLib.h
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePublishInstance.h
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePublishInstanceFactory.h
 create mode 100644 openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePythonBridge.h
 rename openpype/hosts/unreal/integration/{ => UE_5.0}/Source/OpenPype/Public/OpenPypeStyle.h (100%)
 delete mode 160000 repos/avalon-core

diff --git a/openpype/hosts/unreal/__init__.py b/openpype/hosts/unreal/__init__.py
index bedf5a29f7..ae9b113acd 100644
--- a/openpype/hosts/unreal/__init__.py
+++ b/openpype/hosts/unreal/__init__.py
@@ -1,13 +1,19 @@
 import os
 import openpype.hosts
+from openpype.lib.applications import Application
 
 
-def add_implementation_envs(env, _app):
+def add_implementation_envs(env: dict, _app: Application) -> None:
     """Modify environments to contain all required for implementation."""
     # Set OPENPYPE_UNREAL_PLUGIN required for Unreal implementation
+
+    engine_version = _app.name.split("/")[-1].replace("-", ".")
+    major_version = int(engine_version.split(".")[0])
+
+    ue_plugin = "UE_4.7" if major_version == 4 else "UE_5.0"
     unreal_plugin_path = os.path.join(
         os.path.dirname(os.path.abspath(openpype.hosts.__file__)),
-        "unreal", "integration"
+        "unreal", "integration", ue_plugin
     )
     if not env.get("OPENPYPE_UNREAL_PLUGIN"):
         env["OPENPYPE_UNREAL_PLUGIN"] = unreal_plugin_path
diff --git a/openpype/hosts/unreal/integration/.gitignore b/openpype/hosts/unreal/integration/UE_4.7/.gitignore
similarity index 100%
rename from openpype/hosts/unreal/integration/.gitignore
rename to openpype/hosts/unreal/integration/UE_4.7/.gitignore
diff --git a/openpype/hosts/unreal/integration/Content/Python/init_unreal.py b/openpype/hosts/unreal/integration/UE_4.7/Content/Python/init_unreal.py
similarity index 100%
rename from openpype/hosts/unreal/integration/Content/Python/init_unreal.py
rename to openpype/hosts/unreal/integration/UE_4.7/Content/Python/init_unreal.py
diff --git a/openpype/hosts/unreal/integration/OpenPype.uplugin b/openpype/hosts/unreal/integration/UE_4.7/OpenPype.uplugin
similarity index 100%
rename from openpype/hosts/unreal/integration/OpenPype.uplugin
rename to openpype/hosts/unreal/integration/UE_4.7/OpenPype.uplugin
diff --git a/openpype/hosts/unreal/integration/README.md b/openpype/hosts/unreal/integration/UE_4.7/README.md
similarity index 91%
rename from openpype/hosts/unreal/integration/README.md
rename to openpype/hosts/unreal/integration/UE_4.7/README.md
index a32d89aab8..a08c1ada39 100644
--- a/openpype/hosts/unreal/integration/README.md
+++ b/openpype/hosts/unreal/integration/UE_4.7/README.md
@@ -1,4 +1,4 @@
-# OpenPype Unreal Integration plugin
+# OpenPype Unreal Integration plugin - UE 4.x
 
 This is plugin for Unreal Editor, creating menu for [OpenPype](https://github.com/getavalon) tools to run.
 
diff --git a/openpype/hosts/unreal/integration/Resources/openpype128.png b/openpype/hosts/unreal/integration/UE_4.7/Resources/openpype128.png
similarity index 100%
rename from openpype/hosts/unreal/integration/Resources/openpype128.png
rename to openpype/hosts/unreal/integration/UE_4.7/Resources/openpype128.png
diff --git a/openpype/hosts/unreal/integration/Resources/openpype40.png b/openpype/hosts/unreal/integration/UE_4.7/Resources/openpype40.png
similarity index 100%
rename from openpype/hosts/unreal/integration/Resources/openpype40.png
rename to openpype/hosts/unreal/integration/UE_4.7/Resources/openpype40.png
diff --git a/openpype/hosts/unreal/integration/Resources/openpype512.png b/openpype/hosts/unreal/integration/UE_4.7/Resources/openpype512.png
similarity index 100%
rename from openpype/hosts/unreal/integration/Resources/openpype512.png
rename to openpype/hosts/unreal/integration/UE_4.7/Resources/openpype512.png
diff --git a/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/OpenPype.Build.cs b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/OpenPype.Build.cs
new file mode 100644
index 0000000000..c30835b63d
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/OpenPype.Build.cs
@@ -0,0 +1,57 @@
+// Copyright 1998-2019 Epic Games, Inc. All Rights Reserved.
+
+using UnrealBuildTool;
+
+public class OpenPype : ModuleRules
+{
+	public OpenPype(ReadOnlyTargetRules Target) : base(Target)
+	{
+		PCHUsage = ModuleRules.PCHUsageMode.UseExplicitOrSharedPCHs;
+		
+		PublicIncludePaths.AddRange(
+			new string[] {
+				// ... add public include paths required here ...
+			}
+			);
+				
+		
+		PrivateIncludePaths.AddRange(
+			new string[] {
+				// ... add other private include paths required here ...
+			}
+			);
+			
+		
+		PublicDependencyModuleNames.AddRange(
+			new string[]
+			{
+				"Core",
+				// ... add other public dependencies that you statically link with here ...
+			}
+			);
+			
+		
+		PrivateDependencyModuleNames.AddRange(
+			new string[]
+			{
+				"Projects",
+				"InputCore",
+				"UnrealEd",
+				"LevelEditor",
+				"CoreUObject",
+				"Engine",
+				"Slate",
+				"SlateCore",
+				// ... add private dependencies that you statically link with here ...	
+			}
+			);
+		
+		
+		DynamicallyLoadedModuleNames.AddRange(
+			new string[]
+			{
+				// ... add any modules that your module loads dynamically here ...
+			}
+			);
+	}
+}
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/AssetContainer.cpp b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/AssetContainer.cpp
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Private/AssetContainer.cpp
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/AssetContainer.cpp
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/AssetContainerFactory.cpp b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/AssetContainerFactory.cpp
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Private/AssetContainerFactory.cpp
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/AssetContainerFactory.cpp
diff --git a/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPype.cpp b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPype.cpp
new file mode 100644
index 0000000000..15c46b3862
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPype.cpp
@@ -0,0 +1,103 @@
+#include "OpenPype.h"
+#include "LevelEditor.h"
+#include "OpenPypePythonBridge.h"
+#include "OpenPypeStyle.h"
+
+
+static const FName OpenPypeTabName("OpenPype");
+
+#define LOCTEXT_NAMESPACE "FOpenPypeModule"
+
+// This function is triggered when the plugin is staring up
+void FOpenPypeModule::StartupModule()
+{
+
+	FOpenPypeStyle::Initialize();
+	FOpenPypeStyle::SetIcon("Logo", "openpype40");
+
+	// Create the Extender that will add content to the menu
+	FLevelEditorModule& LevelEditorModule = FModuleManager::LoadModuleChecked<FLevelEditorModule>("LevelEditor");
+	
+	TSharedPtr<FExtender> MenuExtender = MakeShareable(new FExtender());
+	TSharedPtr<FExtender> ToolbarExtender = MakeShareable(new FExtender());
+
+	MenuExtender->AddMenuExtension(
+		"LevelEditor",
+		EExtensionHook::After,
+		NULL,
+		FMenuExtensionDelegate::CreateRaw(this, &FOpenPypeModule::AddMenuEntry)
+	);
+	ToolbarExtender->AddToolBarExtension(
+		"Settings",
+		EExtensionHook::After,
+		NULL,
+		FToolBarExtensionDelegate::CreateRaw(this, &FOpenPypeModule::AddToobarEntry));
+
+
+	LevelEditorModule.GetMenuExtensibilityManager()->AddExtender(MenuExtender);
+	LevelEditorModule.GetToolBarExtensibilityManager()->AddExtender(ToolbarExtender);
+
+}
+
+void FOpenPypeModule::ShutdownModule()
+{
+	FOpenPypeStyle::Shutdown();
+}
+
+
+void FOpenPypeModule::AddMenuEntry(FMenuBuilder& MenuBuilder)
+{
+	// Create Section
+	MenuBuilder.BeginSection("OpenPype", TAttribute<FText>(FText::FromString("OpenPype")));
+	{
+		// Create a Submenu inside of the Section
+		MenuBuilder.AddMenuEntry(
+			FText::FromString("Tools..."),
+			FText::FromString("Pipeline tools"),
+			FSlateIcon(FOpenPypeStyle::GetStyleSetName(), "OpenPype.Logo"),
+			FUIAction(FExecuteAction::CreateRaw(this, &FOpenPypeModule::MenuPopup))
+		);
+
+		MenuBuilder.AddMenuEntry(
+			FText::FromString("Tools dialog..."),
+			FText::FromString("Pipeline tools dialog"),
+			FSlateIcon(FOpenPypeStyle::GetStyleSetName(), "OpenPype.Logo"),
+			FUIAction(FExecuteAction::CreateRaw(this, &FOpenPypeModule::MenuDialog))
+		);
+
+	}
+	MenuBuilder.EndSection();
+}
+
+void FOpenPypeModule::AddToobarEntry(FToolBarBuilder& ToolbarBuilder)
+{
+	ToolbarBuilder.BeginSection(TEXT("OpenPype"));
+	{
+		ToolbarBuilder.AddToolBarButton(
+			FUIAction(
+				FExecuteAction::CreateRaw(this, &FOpenPypeModule::MenuPopup),
+				NULL,
+				FIsActionChecked()
+
+			),
+			NAME_None,
+			LOCTEXT("OpenPype_label", "OpenPype"),
+			LOCTEXT("OpenPype_tooltip", "OpenPype Tools"),
+			FSlateIcon(FOpenPypeStyle::GetStyleSetName(), "OpenPype.Logo")
+		);
+	}
+	ToolbarBuilder.EndSection();
+}
+
+
+void FOpenPypeModule::MenuPopup() {
+	UOpenPypePythonBridge* bridge = UOpenPypePythonBridge::Get();
+	bridge->RunInPython_Popup();
+}
+
+void FOpenPypeModule::MenuDialog() {
+	UOpenPypePythonBridge* bridge = UOpenPypePythonBridge::Get();
+	bridge->RunInPython_Dialog();
+}
+
+IMPLEMENT_MODULE(FOpenPypeModule, OpenPype)
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeLib.cpp b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypeLib.cpp
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeLib.cpp
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypeLib.cpp
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypePublishInstance.cpp b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypePublishInstance.cpp
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypePublishInstance.cpp
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypePublishInstance.cpp
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypePublishInstanceFactory.cpp b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypePublishInstanceFactory.cpp
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypePublishInstanceFactory.cpp
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypePublishInstanceFactory.cpp
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypePythonBridge.cpp b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypePythonBridge.cpp
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypePythonBridge.cpp
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypePythonBridge.cpp
diff --git a/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypeStyle.cpp b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypeStyle.cpp
new file mode 100644
index 0000000000..a51c2d6aa5
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Private/OpenPypeStyle.cpp
@@ -0,0 +1,70 @@
+#include "OpenPypeStyle.h"
+#include "Framework/Application/SlateApplication.h"
+#include "Styling/SlateStyle.h"
+#include "Styling/SlateStyleRegistry.h"
+
+
+TUniquePtr< FSlateStyleSet > FOpenPypeStyle::OpenPypeStyleInstance = nullptr;
+
+void FOpenPypeStyle::Initialize()
+{
+	if (!OpenPypeStyleInstance.IsValid())
+	{
+		OpenPypeStyleInstance = Create();
+		FSlateStyleRegistry::RegisterSlateStyle(*OpenPypeStyleInstance);
+	}
+}
+
+void FOpenPypeStyle::Shutdown()
+{
+	if (OpenPypeStyleInstance.IsValid())
+	{
+		FSlateStyleRegistry::UnRegisterSlateStyle(*OpenPypeStyleInstance);
+		OpenPypeStyleInstance.Reset();
+	}
+}
+
+FName FOpenPypeStyle::GetStyleSetName()
+{
+	static FName StyleSetName(TEXT("OpenPypeStyle"));
+	return StyleSetName;
+}
+
+FName FOpenPypeStyle::GetContextName()
+{
+	static FName ContextName(TEXT("OpenPype"));
+	return ContextName;
+}
+
+#define IMAGE_BRUSH(RelativePath, ...) FSlateImageBrush( Style->RootToContentDir( RelativePath, TEXT(".png") ), __VA_ARGS__ )
+
+const FVector2D Icon40x40(40.0f, 40.0f);
+
+TUniquePtr< FSlateStyleSet > FOpenPypeStyle::Create()
+{
+	TUniquePtr< FSlateStyleSet > Style = MakeUnique<FSlateStyleSet>(GetStyleSetName());
+	Style->SetContentRoot(FPaths::ProjectPluginsDir() / TEXT("OpenPype/Resources"));
+
+	return Style;
+}
+
+void FOpenPypeStyle::SetIcon(const FString& StyleName, const FString& ResourcePath)
+{
+	FSlateStyleSet* Style = OpenPypeStyleInstance.Get();
+
+	FString Name(GetContextName().ToString());
+	Name = Name + "." + StyleName;
+	Style->Set(*Name, new FSlateImageBrush(Style->RootToContentDir(ResourcePath, TEXT(".png")), Icon40x40));
+
+
+	FSlateApplication::Get().GetRenderer()->ReloadTextureResources();
+}
+
+#undef IMAGE_BRUSH
+
+const ISlateStyle& FOpenPypeStyle::Get()
+{
+	check(OpenPypeStyleInstance);
+	return *OpenPypeStyleInstance;
+	return *OpenPypeStyleInstance;
+}
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/AssetContainer.h b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/AssetContainer.h
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Public/AssetContainer.h
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/AssetContainer.h
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/AssetContainerFactory.h b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/AssetContainerFactory.h
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Public/AssetContainerFactory.h
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/AssetContainerFactory.h
diff --git a/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPype.h b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPype.h
new file mode 100644
index 0000000000..db3f299354
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPype.h
@@ -0,0 +1,21 @@
+// Copyright 1998-2019 Epic Games, Inc. All Rights Reserved.
+
+#pragma once
+
+#include "Engine.h"
+
+
+class FOpenPypeModule : public IModuleInterface
+{
+public:
+	virtual void StartupModule() override;
+	virtual void ShutdownModule() override;
+
+private:
+
+	void AddMenuEntry(FMenuBuilder& MenuBuilder);
+	void AddToobarEntry(FToolBarBuilder& ToolbarBuilder);
+	void MenuPopup();
+	void MenuDialog();
+
+};
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeLib.h b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypeLib.h
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeLib.h
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypeLib.h
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypePublishInstance.h b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypePublishInstance.h
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypePublishInstance.h
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypePublishInstance.h
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypePublishInstanceFactory.h b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypePublishInstanceFactory.h
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypePublishInstanceFactory.h
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypePublishInstanceFactory.h
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypePythonBridge.h b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypePythonBridge.h
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypePythonBridge.h
rename to openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypePythonBridge.h
diff --git a/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypeStyle.h b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypeStyle.h
new file mode 100644
index 0000000000..fbc8bcdd5b
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_4.7/Source/OpenPype/Public/OpenPypeStyle.h
@@ -0,0 +1,22 @@
+#pragma once
+#include "CoreMinimal.h"
+
+class FSlateStyleSet;
+class ISlateStyle;
+
+
+class FOpenPypeStyle
+{
+public:
+	static void Initialize();
+	static void Shutdown();
+	static const ISlateStyle& Get();
+	static FName GetStyleSetName();
+	static FName GetContextName();
+
+	static void SetIcon(const FString& StyleName, const FString& ResourcePath);
+
+private:
+	static TUniquePtr< FSlateStyleSet > Create();
+	static TUniquePtr< FSlateStyleSet > OpenPypeStyleInstance;
+};
\ No newline at end of file
diff --git a/openpype/hosts/unreal/integration/UE_5.0/.gitignore b/openpype/hosts/unreal/integration/UE_5.0/.gitignore
new file mode 100644
index 0000000000..b32a6f55e5
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/.gitignore
@@ -0,0 +1,35 @@
+# Prerequisites
+*.d
+
+# Compiled Object files
+*.slo
+*.lo
+*.o
+*.obj
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Compiled Dynamic libraries
+*.so
+*.dylib
+*.dll
+
+# Fortran module files
+*.mod
+*.smod
+
+# Compiled Static libraries
+*.lai
+*.la
+*.a
+*.lib
+
+# Executables
+*.exe
+*.out
+*.app
+
+/Binaries
+/Intermediate
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Content/Python/__init__.py b/openpype/hosts/unreal/integration/UE_5.0/Content/Python/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Content/Python/init_unreal.py b/openpype/hosts/unreal/integration/UE_5.0/Content/Python/init_unreal.py
new file mode 100644
index 0000000000..4bb03b07ed
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Content/Python/init_unreal.py
@@ -0,0 +1,28 @@
+import unreal
+
+openpype_detected = True
+try:
+    from openpype.pipeline import install_host
+    from openpype.hosts.unreal import api as openpype_host
+except ImportError as exc:
+    openpype_host = None
+    openpype_detected = False
+    unreal.log_error("OpenPype: cannot load OpenPype [ {} ]".format(exc))
+
+if openpype_detected:
+    install_host(openpype_host)
+
+
+@unreal.uclass()
+class OpenPypeIntegration(unreal.OpenPypePythonBridge):
+    @unreal.ufunction(override=True)
+    def RunInPython_Popup(self):
+        unreal.log_warning("OpenPype: showing tools popup")
+        if openpype_detected:
+            openpype_host.show_tools_popup()
+
+    @unreal.ufunction(override=True)
+    def RunInPython_Dialog(self):
+        unreal.log_warning("OpenPype: showing tools dialog")
+        if openpype_detected:
+            openpype_host.show_tools_dialog()
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Content/__init__.py b/openpype/hosts/unreal/integration/UE_5.0/Content/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/hosts/unreal/integration/UE_5.0/OpenPype.uplugin b/openpype/hosts/unreal/integration/UE_5.0/OpenPype.uplugin
new file mode 100644
index 0000000000..4c7a74403c
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/OpenPype.uplugin
@@ -0,0 +1,24 @@
+{
+	"FileVersion": 3,
+	"Version": 1,
+	"VersionName": "1.0",
+	"FriendlyName": "OpenPype",
+	"Description": "OpenPype Integration",
+	"Category": "OpenPype.Integration",
+	"CreatedBy": "Ondrej Samohel",
+	"CreatedByURL": "https://openpype.io",
+	"DocsURL": "https://openpype.io/docs/artist_hosts_unreal",
+	"MarketplaceURL": "",
+	"SupportURL": "https://pype.club/",
+	"CanContainContent": true,
+	"IsBetaVersion": true,
+	"IsExperimentalVersion": false,
+	"Installed": false,
+	"Modules": [
+		{
+			"Name": "OpenPype",
+			"Type": "Editor",
+			"LoadingPhase": "Default"
+		}
+	]
+}
\ No newline at end of file
diff --git a/openpype/hosts/unreal/integration/UE_5.0/README.md b/openpype/hosts/unreal/integration/UE_5.0/README.md
new file mode 100644
index 0000000000..cf0aa622c2
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/README.md
@@ -0,0 +1,11 @@
+# OpenPype Unreal Integration plugin - UE 5.x
+
+This is plugin for Unreal Editor, creating menu for [OpenPype](https://github.com/getavalon) tools to run.
+
+## How does this work
+
+Plugin is creating basic menu items in **Window/OpenPype** section of Unreal Editor main menu and a button
+on the main toolbar with associated menu. Clicking on those menu items is calling callbacks that are
+declared in C++ but needs to be implemented during Unreal Editor
+startup in `Plugins/OpenPype/Content/Python/init_unreal.py` - this should be executed by Unreal Editor
+automatically.
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Resources/openpype128.png b/openpype/hosts/unreal/integration/UE_5.0/Resources/openpype128.png
new file mode 100644
index 0000000000000000000000000000000000000000..abe8a807ef40f00b75d7446d020a2437732c7583
GIT binary patch
literal 14594
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
D^D)By

literal 0
HcmV?d00001

diff --git a/openpype/hosts/unreal/integration/UE_5.0/Resources/openpype40.png b/openpype/hosts/unreal/integration/UE_5.0/Resources/openpype40.png
new file mode 100644
index 0000000000000000000000000000000000000000..f983e7a1f20510a816efb56bdb20715af3599de2
GIT binary patch
literal 4884
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

literal 0
HcmV?d00001

diff --git a/openpype/hosts/unreal/integration/UE_5.0/Resources/openpype512.png b/openpype/hosts/unreal/integration/UE_5.0/Resources/openpype512.png
new file mode 100644
index 0000000000000000000000000000000000000000..97c4d4326bc16ba6dfb45d35c4362d8bc15900ae
GIT binary patch
literal 85856
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
bCJFu@j}?W0K?Ok;00000NkvXXu0mjf9`4Bp

literal 0
HcmV?d00001

diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/OpenPype.Build.cs b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/OpenPype.Build.cs
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/OpenPype.Build.cs
rename to openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/OpenPype.Build.cs
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/AssetContainer.cpp b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/AssetContainer.cpp
new file mode 100644
index 0000000000..c766f87a8e
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/AssetContainer.cpp
@@ -0,0 +1,115 @@
+// Fill out your copyright notice in the Description page of Project Settings.
+
+#include "AssetContainer.h"
+#include "AssetRegistryModule.h"
+#include "Misc/PackageName.h"
+#include "Engine.h"
+#include "Containers/UnrealString.h"
+
+UAssetContainer::UAssetContainer(const FObjectInitializer& ObjectInitializer)
+: UAssetUserData(ObjectInitializer)
+{
+	FAssetRegistryModule& AssetRegistryModule = FModuleManager::LoadModuleChecked<FAssetRegistryModule>("AssetRegistry");
+	FString path = UAssetContainer::GetPathName();
+	UE_LOG(LogTemp, Warning, TEXT("UAssetContainer %s"), *path);
+	FARFilter Filter;
+	Filter.PackagePaths.Add(FName(*path));
+	
+	AssetRegistryModule.Get().OnAssetAdded().AddUObject(this, &UAssetContainer::OnAssetAdded);
+	AssetRegistryModule.Get().OnAssetRemoved().AddUObject(this, &UAssetContainer::OnAssetRemoved);
+	AssetRegistryModule.Get().OnAssetRenamed().AddUObject(this, &UAssetContainer::OnAssetRenamed);
+}
+
+void UAssetContainer::OnAssetAdded(const FAssetData& AssetData)
+{
+	TArray<FString> split;
+
+	// get directory of current container
+	FString selfFullPath = UAssetContainer::GetPathName();
+	FString selfDir = FPackageName::GetLongPackagePath(*selfFullPath);
+
+	// get asset path and class
+	FString assetPath = AssetData.GetFullName();
+	FString assetFName = AssetData.AssetClass.ToString();
+	
+	// split path
+	assetPath.ParseIntoArray(split, TEXT(" "), true);
+
+	FString assetDir = FPackageName::GetLongPackagePath(*split[1]);
+	
+	// take interest only in paths starting with path of current container
+	if (assetDir.StartsWith(*selfDir))
+	{
+		// exclude self
+		if (assetFName != "AssetContainer")
+		{
+			assets.Add(assetPath);
+			assetsData.Add(AssetData);
+			UE_LOG(LogTemp, Log, TEXT("%s: asset added to %s"), *selfFullPath, *selfDir);
+		}
+	}
+}
+
+void UAssetContainer::OnAssetRemoved(const FAssetData& AssetData)
+{
+	TArray<FString> split;
+
+	// get directory of current container
+	FString selfFullPath = UAssetContainer::GetPathName();
+	FString selfDir = FPackageName::GetLongPackagePath(*selfFullPath);
+
+	// get asset path and class
+	FString assetPath = AssetData.GetFullName();
+	FString assetFName = AssetData.AssetClass.ToString();
+
+	// split path
+	assetPath.ParseIntoArray(split, TEXT(" "), true);
+
+	FString assetDir = FPackageName::GetLongPackagePath(*split[1]);
+
+	// take interest only in paths starting with path of current container
+	FString path = UAssetContainer::GetPathName();
+	FString lpp = FPackageName::GetLongPackagePath(*path);
+
+	if (assetDir.StartsWith(*selfDir))
+	{
+		// exclude self
+		if (assetFName != "AssetContainer")
+		{
+			// UE_LOG(LogTemp, Warning, TEXT("%s: asset removed"), *lpp);
+			assets.Remove(assetPath);
+			assetsData.Remove(AssetData);
+		}
+	}
+}
+
+void UAssetContainer::OnAssetRenamed(const FAssetData& AssetData, const FString& str)
+{
+	TArray<FString> split;
+
+	// get directory of current container
+	FString selfFullPath = UAssetContainer::GetPathName();
+	FString selfDir = FPackageName::GetLongPackagePath(*selfFullPath);
+
+	// get asset path and class
+	FString assetPath = AssetData.GetFullName();
+	FString assetFName = AssetData.AssetClass.ToString();
+
+	// split path
+	assetPath.ParseIntoArray(split, TEXT(" "), true);
+
+	FString assetDir = FPackageName::GetLongPackagePath(*split[1]);
+	if (assetDir.StartsWith(*selfDir))
+	{
+		// exclude self
+		if (assetFName != "AssetContainer")
+		{
+
+			assets.Remove(str);
+			assets.Add(assetPath);
+			assetsData.Remove(AssetData);
+			// UE_LOG(LogTemp, Warning, TEXT("%s: asset renamed %s"), *lpp, *str);
+		}
+	}
+}
+
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/AssetContainerFactory.cpp b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/AssetContainerFactory.cpp
new file mode 100644
index 0000000000..b943150bdd
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/AssetContainerFactory.cpp
@@ -0,0 +1,20 @@
+#include "AssetContainerFactory.h"
+#include "AssetContainer.h"
+
+UAssetContainerFactory::UAssetContainerFactory(const FObjectInitializer& ObjectInitializer)
+	: UFactory(ObjectInitializer)
+{
+	SupportedClass = UAssetContainer::StaticClass();
+	bCreateNew = false;
+	bEditorImport = true;
+}
+
+UObject* UAssetContainerFactory::FactoryCreateNew(UClass* Class, UObject* InParent, FName Name, EObjectFlags Flags, UObject* Context, FFeedbackContext* Warn)
+{
+	UAssetContainer* AssetContainer = NewObject<UAssetContainer>(InParent, Class, Name, Flags);
+	return AssetContainer;
+}
+
+bool UAssetContainerFactory::ShouldShowInNewMenu() const {
+	return false;
+}
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPype.cpp b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPype.cpp
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPype.cpp
rename to openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPype.cpp
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeCommands.cpp b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypeCommands.cpp
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeCommands.cpp
rename to openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypeCommands.cpp
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypeLib.cpp b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypeLib.cpp
new file mode 100644
index 0000000000..5facab7b8b
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypeLib.cpp
@@ -0,0 +1,48 @@
+#include "OpenPypeLib.h"
+#include "Misc/Paths.h"
+#include "Misc/ConfigCacheIni.h"
+#include "UObject/UnrealType.h"
+
+/**
+ * Sets color on folder icon on given path
+ * @param InPath - path to folder
+ * @param InFolderColor - color of the folder
+ * @warning This color will appear only after Editor restart. Is there a better way?
+ */
+
+void UOpenPypeLib::CSetFolderColor(FString FolderPath, FLinearColor FolderColor, bool bForceAdd)
+{
+	auto SaveColorInternal = [](FString InPath, FLinearColor InFolderColor)
+	{
+		// Saves the color of the folder to the config
+		if (FPaths::FileExists(GEditorPerProjectIni))
+		{
+			GConfig->SetString(TEXT("PathColor"), *InPath, *InFolderColor.ToString(), GEditorPerProjectIni);
+		}
+
+	};
+
+	SaveColorInternal(FolderPath, FolderColor);
+
+}
+/**
+ * Returns all poperties on  given object
+ * @param cls - class
+ * @return TArray of properties
+ */
+TArray<FString> UOpenPypeLib::GetAllProperties(UClass* cls)
+{
+	TArray<FString> Ret;
+	if (cls != nullptr)
+	{
+		for (TFieldIterator<FProperty> It(cls); It; ++It)
+		{
+			FProperty* Property = *It;
+			if (Property->HasAnyPropertyFlags(EPropertyFlags::CPF_Edit))
+			{
+				Ret.Add(Property->GetName());
+			}
+		}
+	}
+	return Ret;
+}
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePublishInstance.cpp b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePublishInstance.cpp
new file mode 100644
index 0000000000..4f1e846c0b
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePublishInstance.cpp
@@ -0,0 +1,108 @@
+#pragma once
+
+#include "OpenPypePublishInstance.h"
+#include "AssetRegistryModule.h"
+
+
+UOpenPypePublishInstance::UOpenPypePublishInstance(const FObjectInitializer& ObjectInitializer)
+	: UObject(ObjectInitializer)
+{
+	FAssetRegistryModule& AssetRegistryModule = FModuleManager::LoadModuleChecked<FAssetRegistryModule>("AssetRegistry");
+	FString path = UOpenPypePublishInstance::GetPathName();
+	FARFilter Filter;
+	Filter.PackagePaths.Add(FName(*path));
+
+	AssetRegistryModule.Get().OnAssetAdded().AddUObject(this, &UOpenPypePublishInstance::OnAssetAdded);
+	AssetRegistryModule.Get().OnAssetRemoved().AddUObject(this, &UOpenPypePublishInstance::OnAssetRemoved);
+	AssetRegistryModule.Get().OnAssetRenamed().AddUObject(this, &UOpenPypePublishInstance::OnAssetRenamed);
+}
+
+void UOpenPypePublishInstance::OnAssetAdded(const FAssetData& AssetData)
+{
+	TArray<FString> split;
+
+	// get directory of current container
+	FString selfFullPath = UOpenPypePublishInstance::GetPathName();
+	FString selfDir = FPackageName::GetLongPackagePath(*selfFullPath);
+
+	// get asset path and class
+	FString assetPath = AssetData.GetFullName();
+	FString assetFName = AssetData.AssetClass.ToString();
+
+	// split path
+	assetPath.ParseIntoArray(split, TEXT(" "), true);
+
+	FString assetDir = FPackageName::GetLongPackagePath(*split[1]);
+
+	// take interest only in paths starting with path of current container
+	if (assetDir.StartsWith(*selfDir))
+	{
+		// exclude self
+		if (assetFName != "OpenPypePublishInstance")
+		{
+			assets.Add(assetPath);
+			UE_LOG(LogTemp, Log, TEXT("%s: asset added to %s"), *selfFullPath, *selfDir);
+		}
+	}
+}
+
+void UOpenPypePublishInstance::OnAssetRemoved(const FAssetData& AssetData)
+{
+	TArray<FString> split;
+
+	// get directory of current container
+	FString selfFullPath = UOpenPypePublishInstance::GetPathName();
+	FString selfDir = FPackageName::GetLongPackagePath(*selfFullPath);
+
+	// get asset path and class
+	FString assetPath = AssetData.GetFullName();
+	FString assetFName = AssetData.AssetClass.ToString();
+
+	// split path
+	assetPath.ParseIntoArray(split, TEXT(" "), true);
+
+	FString assetDir = FPackageName::GetLongPackagePath(*split[1]);
+
+	// take interest only in paths starting with path of current container
+	FString path = UOpenPypePublishInstance::GetPathName();
+	FString lpp = FPackageName::GetLongPackagePath(*path);
+
+	if (assetDir.StartsWith(*selfDir))
+	{
+		// exclude self
+		if (assetFName != "OpenPypePublishInstance")
+		{
+			// UE_LOG(LogTemp, Warning, TEXT("%s: asset removed"), *lpp);
+			assets.Remove(assetPath);
+		}
+	}
+}
+
+void UOpenPypePublishInstance::OnAssetRenamed(const FAssetData& AssetData, const FString& str)
+{
+	TArray<FString> split;
+
+	// get directory of current container
+	FString selfFullPath = UOpenPypePublishInstance::GetPathName();
+	FString selfDir = FPackageName::GetLongPackagePath(*selfFullPath);
+
+	// get asset path and class
+	FString assetPath = AssetData.GetFullName();
+	FString assetFName = AssetData.AssetClass.ToString();
+
+	// split path
+	assetPath.ParseIntoArray(split, TEXT(" "), true);
+
+	FString assetDir = FPackageName::GetLongPackagePath(*split[1]);
+	if (assetDir.StartsWith(*selfDir))
+	{
+		// exclude self
+		if (assetFName != "AssetContainer")
+		{
+
+			assets.Remove(str);
+			assets.Add(assetPath);
+			// UE_LOG(LogTemp, Warning, TEXT("%s: asset renamed %s"), *lpp, *str);
+		}
+	}
+}
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePublishInstanceFactory.cpp b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePublishInstanceFactory.cpp
new file mode 100644
index 0000000000..e61964c689
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePublishInstanceFactory.cpp
@@ -0,0 +1,20 @@
+#include "OpenPypePublishInstanceFactory.h"
+#include "OpenPypePublishInstance.h"
+
+UOpenPypePublishInstanceFactory::UOpenPypePublishInstanceFactory(const FObjectInitializer& ObjectInitializer)
+	: UFactory(ObjectInitializer)
+{
+	SupportedClass = UOpenPypePublishInstance::StaticClass();
+	bCreateNew = false;
+	bEditorImport = true;
+}
+
+UObject* UOpenPypePublishInstanceFactory::FactoryCreateNew(UClass* Class, UObject* InParent, FName Name, EObjectFlags Flags, UObject* Context, FFeedbackContext* Warn)
+{
+	UOpenPypePublishInstance* OpenPypePublishInstance = NewObject<UOpenPypePublishInstance>(InParent, Class, Name, Flags);
+	return OpenPypePublishInstance;
+}
+
+bool UOpenPypePublishInstanceFactory::ShouldShowInNewMenu() const {
+	return false;
+}
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePythonBridge.cpp b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePythonBridge.cpp
new file mode 100644
index 0000000000..8113231503
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypePythonBridge.cpp
@@ -0,0 +1,13 @@
+#include "OpenPypePythonBridge.h"
+
+UOpenPypePythonBridge* UOpenPypePythonBridge::Get()
+{
+	TArray<UClass*> OpenPypePythonBridgeClasses;
+	GetDerivedClasses(UOpenPypePythonBridge::StaticClass(), OpenPypePythonBridgeClasses);
+	int32 NumClasses = OpenPypePythonBridgeClasses.Num();
+	if (NumClasses > 0)
+	{
+		return Cast<UOpenPypePythonBridge>(OpenPypePythonBridgeClasses[NumClasses - 1]->GetDefaultObject());
+	}
+	return nullptr;
+};
\ No newline at end of file
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeStyle.cpp b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypeStyle.cpp
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Private/OpenPypeStyle.cpp
rename to openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Private/OpenPypeStyle.cpp
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/AssetContainer.h b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/AssetContainer.h
new file mode 100644
index 0000000000..3c2a360c78
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/AssetContainer.h
@@ -0,0 +1,39 @@
+// Fill out your copyright notice in the Description page of Project Settings.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "UObject/NoExportTypes.h"
+#include "Engine/AssetUserData.h"
+#include "AssetData.h"
+#include "AssetContainer.generated.h"
+
+/**
+ * 
+ */
+UCLASS(Blueprintable)
+class OPENPYPE_API UAssetContainer : public UAssetUserData
+{
+	GENERATED_BODY()
+	
+public:
+
+	UAssetContainer(const FObjectInitializer& ObjectInitalizer);
+	// ~UAssetContainer();
+
+	UPROPERTY(EditAnywhere, BlueprintReadOnly)
+		TArray<FString> assets;
+
+	// There seems to be no reflection option to expose array of FAssetData
+	/*
+	UPROPERTY(Transient, BlueprintReadOnly, Category = "Python", meta=(DisplayName="Assets Data"))
+		TArray<FAssetData> assetsData;
+	*/
+private:
+	TArray<FAssetData> assetsData;
+	void OnAssetAdded(const FAssetData& AssetData);
+	void OnAssetRemoved(const FAssetData& AssetData);
+	void OnAssetRenamed(const FAssetData& AssetData, const FString& str);
+};
+
+
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/AssetContainerFactory.h b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/AssetContainerFactory.h
new file mode 100644
index 0000000000..331ce6bb50
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/AssetContainerFactory.h
@@ -0,0 +1,21 @@
+// Fill out your copyright notice in the Description page of Project Settings.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "Factories/Factory.h"
+#include "AssetContainerFactory.generated.h"
+
+/**
+ * 
+ */
+UCLASS()
+class OPENPYPE_API UAssetContainerFactory : public UFactory
+{
+	GENERATED_BODY()
+
+public:
+	UAssetContainerFactory(const FObjectInitializer& ObjectInitializer);
+	virtual UObject* FactoryCreateNew(UClass* Class, UObject* InParent, FName Name, EObjectFlags Flags, UObject* Context, FFeedbackContext* Warn) override;
+	virtual bool ShouldShowInNewMenu() const override;
+};
\ No newline at end of file
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPype.h b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPype.h
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPype.h
rename to openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPype.h
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeCommands.h b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypeCommands.h
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeCommands.h
rename to openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypeCommands.h
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypeLib.h b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypeLib.h
new file mode 100644
index 0000000000..59e9c8bd76
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypeLib.h
@@ -0,0 +1,19 @@
+#pragma once
+
+#include "Engine.h"
+#include "OpenPypeLib.generated.h"
+
+
+UCLASS(Blueprintable)
+class OPENPYPE_API UOpenPypeLib : public UObject
+{
+
+	GENERATED_BODY()
+
+public: 
+	UFUNCTION(BlueprintCallable, Category = Python)
+		static void CSetFolderColor(FString FolderPath, FLinearColor FolderColor, bool bForceAdd);
+
+	UFUNCTION(BlueprintCallable, Category = Python)
+		static TArray<FString> GetAllProperties(UClass* cls);
+};
\ No newline at end of file
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePublishInstance.h b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePublishInstance.h
new file mode 100644
index 0000000000..0a27a078d7
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePublishInstance.h
@@ -0,0 +1,21 @@
+#pragma once
+
+#include "Engine.h"
+#include "OpenPypePublishInstance.generated.h"
+
+
+UCLASS(Blueprintable)
+class OPENPYPE_API UOpenPypePublishInstance : public UObject
+{
+	GENERATED_BODY()
+
+public:
+	UOpenPypePublishInstance(const FObjectInitializer& ObjectInitalizer);
+
+	UPROPERTY(EditAnywhere, BlueprintReadOnly)
+		TArray<FString> assets;
+private:
+	void OnAssetAdded(const FAssetData& AssetData);
+	void OnAssetRemoved(const FAssetData& AssetData);
+	void OnAssetRenamed(const FAssetData& AssetData, const FString& str);
+};
\ No newline at end of file
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePublishInstanceFactory.h b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePublishInstanceFactory.h
new file mode 100644
index 0000000000..a2b3abe13e
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePublishInstanceFactory.h
@@ -0,0 +1,19 @@
+#pragma once
+
+#include "CoreMinimal.h"
+#include "Factories/Factory.h"
+#include "OpenPypePublishInstanceFactory.generated.h"
+
+/**
+ *
+ */
+UCLASS()
+class OPENPYPE_API UOpenPypePublishInstanceFactory : public UFactory
+{
+	GENERATED_BODY()
+
+public:
+	UOpenPypePublishInstanceFactory(const FObjectInitializer& ObjectInitializer);
+	virtual UObject* FactoryCreateNew(UClass* Class, UObject* InParent, FName Name, EObjectFlags Flags, UObject* Context, FFeedbackContext* Warn) override;
+	virtual bool ShouldShowInNewMenu() const override;
+};
\ No newline at end of file
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePythonBridge.h b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePythonBridge.h
new file mode 100644
index 0000000000..692aab2e5e
--- /dev/null
+++ b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypePythonBridge.h
@@ -0,0 +1,20 @@
+#pragma once
+#include "Engine.h"
+#include "OpenPypePythonBridge.generated.h"
+
+UCLASS(Blueprintable)
+class UOpenPypePythonBridge : public UObject
+{
+	GENERATED_BODY()
+
+public:
+	UFUNCTION(BlueprintCallable, Category = Python)
+		static UOpenPypePythonBridge* Get();
+
+	UFUNCTION(BlueprintImplementableEvent, Category = Python)
+		void RunInPython_Popup() const;
+
+	UFUNCTION(BlueprintImplementableEvent, Category = Python)
+		void RunInPython_Dialog() const;
+
+};
diff --git a/openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeStyle.h b/openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypeStyle.h
similarity index 100%
rename from openpype/hosts/unreal/integration/Source/OpenPype/Public/OpenPypeStyle.h
rename to openpype/hosts/unreal/integration/UE_5.0/Source/OpenPype/Public/OpenPypeStyle.h
diff --git a/openpype/settings/defaults/system_settings/applications.json b/openpype/settings/defaults/system_settings/applications.json
index 2b0de44fa9..d17674ea2c 100644
--- a/openpype/settings/defaults/system_settings/applications.json
+++ b/openpype/settings/defaults/system_settings/applications.json
@@ -1243,9 +1243,19 @@
         "host_name": "unreal",
         "environment": {},
         "variants": {
-            "4-26": {
+            "4-27": {
                 "use_python_2": false,
                 "environment": {}
+            },
+            "5-0": {
+                "use_python_2": false,
+                "environment": {
+                    "UE_PYTHONPATH": "{PYTHONPATH}"
+                }
+            },
+            "__dynamic_keys_labels__": {
+                "4-27": "4.27",
+                "5-0": "5.0"
             }
         }
     },
diff --git a/repos/avalon-core b/repos/avalon-core
deleted file mode 160000
index 2fa14cea6f..0000000000
--- a/repos/avalon-core
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 2fa14cea6f6a9d86eec70bbb96860cbe4c75c8eb

From 2b1079be32264ae78d4cb70a10e9c10960db7d6e Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 26 May 2022 14:10:46 +0200
Subject: [PATCH 0366/1227] :recycle: simplify version determination

---
 openpype/hosts/unreal/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/unreal/__init__.py b/openpype/hosts/unreal/__init__.py
index ae9b113acd..9c0768b78e 100644
--- a/openpype/hosts/unreal/__init__.py
+++ b/openpype/hosts/unreal/__init__.py
@@ -10,7 +10,7 @@ def add_implementation_envs(env: dict, _app: Application) -> None:
     engine_version = _app.name.split("/")[-1].replace("-", ".")
     major_version = int(engine_version.split(".")[0])
 
-    ue_plugin = "UE_4.7" if major_version == 4 else "UE_5.0"
+    ue_plugin = "UE_5.0" if _app.name[:1] == "5" else "UE_4.7"
     unreal_plugin_path = os.path.join(
         os.path.dirname(os.path.abspath(openpype.hosts.__file__)),
         "unreal", "integration", ue_plugin

From 067058f5d344a9ab940cd33ff0f3ab4436e74dbb Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 26 May 2022 14:13:25 +0200
Subject: [PATCH 0367/1227] :recycle: hound fixes

---
 openpype/hosts/unreal/__init__.py | 1 -
 openpype/hosts/unreal/lib.py      | 4 ++--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/unreal/__init__.py b/openpype/hosts/unreal/__init__.py
index 9c0768b78e..e0e1f0bc3d 100644
--- a/openpype/hosts/unreal/__init__.py
+++ b/openpype/hosts/unreal/__init__.py
@@ -8,7 +8,6 @@ def add_implementation_envs(env: dict, _app: Application) -> None:
     # Set OPENPYPE_UNREAL_PLUGIN required for Unreal implementation
 
     engine_version = _app.name.split("/")[-1].replace("-", ".")
-    major_version = int(engine_version.split(".")[0])
 
     ue_plugin = "UE_5.0" if _app.name[:1] == "5" else "UE_4.7"
     unreal_plugin_path = os.path.join(
diff --git a/openpype/hosts/unreal/lib.py b/openpype/hosts/unreal/lib.py
index f220d8dedf..8c453b38b9 100644
--- a/openpype/hosts/unreal/lib.py
+++ b/openpype/hosts/unreal/lib.py
@@ -301,8 +301,8 @@ def create_unreal_project(project_name: str,
         raise NotImplementedError("Unsupported platform")
     if not python_path.exists():
         raise RuntimeError(f"Unreal Python not found at {python_path}")
-    out = subprocess.check_call(
-        [python_path.as_posix(), "-m", "pip", "install", "--user", "pyside2"])
+    subprocess.check_call(
+        [python_path.as_posix(), "-m", "pip", "install", "pyside2"])
 
     if dev_mode or preset["dev_mode"]:
         _prepare_cpp_project(project_file, engine_path, ue_version)

From 9a5dce42af1d1d9befc021ca1326f2e2a3a2fdc7 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 26 May 2022 14:17:41 +0200
Subject: [PATCH 0368/1227] :recycle: hound fixes #2 :dog:

---
 openpype/hosts/unreal/__init__.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/hosts/unreal/__init__.py b/openpype/hosts/unreal/__init__.py
index e0e1f0bc3d..10e9c5100e 100644
--- a/openpype/hosts/unreal/__init__.py
+++ b/openpype/hosts/unreal/__init__.py
@@ -7,8 +7,6 @@ def add_implementation_envs(env: dict, _app: Application) -> None:
     """Modify environments to contain all required for implementation."""
     # Set OPENPYPE_UNREAL_PLUGIN required for Unreal implementation
 
-    engine_version = _app.name.split("/")[-1].replace("-", ".")
-
     ue_plugin = "UE_5.0" if _app.name[:1] == "5" else "UE_4.7"
     unreal_plugin_path = os.path.join(
         os.path.dirname(os.path.abspath(openpype.hosts.__file__)),

From e4878eac8aecf8993b5b690401539fba88bb182c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 14:25:51 +0200
Subject: [PATCH 0369/1227] Flame: make sure repre name is first segment from
 tokenizable str

---
 .../flame/plugins/publish/extract_subset_resources.py     | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index eea575ea88..1bfe980a01 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -232,10 +232,14 @@ class ExtractSubsetResources(openpype.api.Extractor):
             opfapi.export_clip(
                 export_dir_path, exporting_clip, preset_path, **export_kwargs)
 
+            # make sure only first segment is used if underscore in name
+            # HACK: `ftrackreview_withLUT` will result only in `ftrackreview`
+            repr_name = unique_name.split("_")[0]
+
             # create representation data
             representation_data = {
-                "name": unique_name,
-                "outputName": unique_name,
+                "name": repr_name,
+                "outputName": repr_name,
                 "ext": extension,
                 "stagingDir": export_dir_path,
                 "tags": repre_tags,

From 4fbdefdb6c95b461cbe43e70a0e3de6c6ec7992e Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 26 May 2022 14:43:48 +0200
Subject: [PATCH 0370/1227] :recycle: fps from asset, few style changes

---
 .../unreal/plugins/load/load_animation.py     | 25 +++++-------
 .../hosts/unreal/plugins/load/load_layout.py  | 39 +++++++++----------
 2 files changed, 29 insertions(+), 35 deletions(-)

diff --git a/openpype/hosts/unreal/plugins/load/load_animation.py b/openpype/hosts/unreal/plugins/load/load_animation.py
index 54b43c500c..da2830bc52 100644
--- a/openpype/hosts/unreal/plugins/load/load_animation.py
+++ b/openpype/hosts/unreal/plugins/load/load_animation.py
@@ -14,6 +14,7 @@ from openpype.pipeline import (
 )
 from openpype.hosts.unreal.api import plugin
 from openpype.hosts.unreal.api import pipeline as unreal_pipeline
+from openpype.api import get_asset
 
 
 class AnimationFBXLoader(plugin.Loader):
@@ -79,7 +80,7 @@ class AnimationFBXLoader(plugin.Loader):
         task.options.anim_sequence_import_data.set_editor_property(
             'use_default_sample_rate', False)
         task.options.anim_sequence_import_data.set_editor_property(
-            'custom_sample_rate', 25.0) # TODO: get from database
+            'custom_sample_rate', get_asset()["data"].get("fps"))
         task.options.anim_sequence_import_data.set_editor_property(
             'import_custom_attribute', True)
         task.options.anim_sequence_import_data.set_editor_property(
@@ -141,22 +142,18 @@ class AnimationFBXLoader(plugin.Loader):
         root = "/Game/OpenPype"
         asset = context.get('asset').get('name')
         suffix = "_CON"
-        if asset:
-            asset_name = "{}_{}".format(asset, name)
-        else:
-            asset_name = "{}".format(name)
-
+        asset_name = f"{asset}_{name}" if asset else f"{name}"
         tools = unreal.AssetToolsHelpers().get_asset_tools()
         asset_dir, container_name = tools.create_unique_asset_name(
             f"{root}/Animations/{asset}/{name}", suffix="")
 
         ar = unreal.AssetRegistryHelpers.get_asset_registry()
 
-        filter = unreal.ARFilter(
+        _filter = unreal.ARFilter(
             class_names=["World"],
             package_paths=[f"{root}/{hierarchy[0]}"],
             recursive_paths=False)
-        levels = ar.get_assets(filter)
+        levels = ar.get_assets(_filter)
         master_level = levels[0].get_editor_property('object_path')
 
         hierarchy_dir = root
@@ -164,11 +161,11 @@ class AnimationFBXLoader(plugin.Loader):
             hierarchy_dir = f"{hierarchy_dir}/{h}"
         hierarchy_dir = f"{hierarchy_dir}/{asset}"
 
-        filter = unreal.ARFilter(
+        _filter = unreal.ARFilter(
             class_names=["World"],
             package_paths=[f"{hierarchy_dir}/"],
             recursive_paths=True)
-        levels = ar.get_assets(filter)
+        levels = ar.get_assets(_filter)
         level = levels[0].get_editor_property('object_path')
 
         unreal.EditorLevelLibrary.save_all_dirty_levels()
@@ -235,8 +232,7 @@ class AnimationFBXLoader(plugin.Loader):
             "parent": context["representation"]["parent"],
             "family": context["representation"]["context"]["family"]
         }
-        unreal_pipeline.imprint(
-            "{}/{}".format(asset_dir, container_name), data)
+        unreal_pipeline.imprint(f"{asset_dir}/{container_name}", data)
 
         imported_content = EditorAssetLibrary.list_assets(
             asset_dir, recursive=True, include_folder=False)
@@ -283,7 +279,7 @@ class AnimationFBXLoader(plugin.Loader):
         task.options.anim_sequence_import_data.set_editor_property(
             'use_default_sample_rate', False)
         task.options.anim_sequence_import_data.set_editor_property(
-            'custom_sample_rate', 25.0) # TODO: get from database
+            'custom_sample_rate', get_asset()["data"].get("fps"))
         task.options.anim_sequence_import_data.set_editor_property(
             'import_custom_attribute', True)
         task.options.anim_sequence_import_data.set_editor_property(
@@ -300,8 +296,7 @@ class AnimationFBXLoader(plugin.Loader):
 
         # do import fbx and replace existing data
         unreal.AssetToolsHelpers.get_asset_tools().import_asset_tasks([task])
-        container_path = "{}/{}".format(container["namespace"],
-                                        container["objectName"])
+        container_path = f'{container["namespace"]}/{container["objectName"]}'
         # update metadata
         unreal_pipeline.imprint(
             container_path,
diff --git a/openpype/hosts/unreal/plugins/load/load_layout.py b/openpype/hosts/unreal/plugins/load/load_layout.py
index 49611c6c05..0632c3c0b5 100644
--- a/openpype/hosts/unreal/plugins/load/load_layout.py
+++ b/openpype/hosts/unreal/plugins/load/load_layout.py
@@ -20,6 +20,7 @@ from openpype.pipeline import (
     AVALON_CONTAINER_ID,
     legacy_io,
 )
+from openpype.api import get_asset
 from openpype.hosts.unreal.api import plugin
 from openpype.hosts.unreal.api import pipeline as unreal_pipeline
 
@@ -87,7 +88,8 @@ class LayoutLoader(plugin.Loader):
 
         return None
 
-    def _get_data(self, asset_name):
+    @staticmethod
+    def _get_data(asset_name):
         asset_doc = legacy_io.find_one({
             "type": "asset",
             "name": asset_name
@@ -95,8 +97,9 @@ class LayoutLoader(plugin.Loader):
 
         return asset_doc.get("data")
 
+    @staticmethod
     def _set_sequence_hierarchy(
-        self, seq_i, seq_j, max_frame_i, min_frame_j, max_frame_j, map_paths
+        seq_i, seq_j, max_frame_i, min_frame_j, max_frame_j, map_paths
     ):
         # Get existing sequencer tracks or create them if they don't exist
         tracks = seq_i.get_master_tracks()
@@ -165,8 +168,9 @@ class LayoutLoader(plugin.Loader):
             hid_section.set_row_index(index)
             hid_section.set_level_names(maps)
 
+    @staticmethod
     def _process_family(
-        self, assets, class_name, transform, sequence, inst_name=None
+        assets, class_name, transform, sequence, inst_name=None
     ):
         ar = unreal.AssetRegistryHelpers.get_asset_registry()
 
@@ -264,7 +268,7 @@ class LayoutLoader(plugin.Loader):
         task.options.anim_sequence_import_data.set_editor_property(
             'use_default_sample_rate', False)
         task.options.anim_sequence_import_data.set_editor_property(
-            'custom_sample_rate', 25.0) # TODO: get from database
+            'custom_sample_rate', get_asset()["data"].get("fps"))
         task.options.anim_sequence_import_data.set_editor_property(
             'import_custom_attribute', True)
         task.options.anim_sequence_import_data.set_editor_property(
@@ -313,11 +317,8 @@ class LayoutLoader(plugin.Loader):
             for binding in bindings:
                 tracks = binding.get_tracks()
                 track = None
-                if not tracks:
-                    track = binding.add_track(
-                        unreal.MovieSceneSkeletalAnimationTrack)
-                else:
-                    track = tracks[0]
+                track = tracks[0] if tracks else binding.add_track(
+                    unreal.MovieSceneSkeletalAnimationTrack)
 
                 sections = track.get_sections()
                 section = None
@@ -337,11 +338,11 @@ class LayoutLoader(plugin.Loader):
                             curr_anim.get_path_name()).parent
                         ).replace('\\', '/')
 
-                        filter = unreal.ARFilter(
+                        _filter = unreal.ARFilter(
                             class_names=["AssetContainer"],
                             package_paths=[anim_path],
                             recursive_paths=False)
-                        containers = ar.get_assets(filter)
+                        containers = ar.get_assets(_filter)
 
                         if len(containers) > 0:
                             return
@@ -352,6 +353,7 @@ class LayoutLoader(plugin.Loader):
                 sec_params = section.get_editor_property('params')
                 sec_params.set_editor_property('animation', animation)
 
+    @staticmethod
     def _generate_sequence(self, h, h_dir):
         tools = unreal.AssetToolsHelpers().get_asset_tools()
 
@@ -585,10 +587,7 @@ class LayoutLoader(plugin.Loader):
             hierarchy_dir_list.append(hierarchy_dir)
         asset = context.get('asset').get('name')
         suffix = "_CON"
-        if asset:
-            asset_name = "{}_{}".format(asset, name)
-        else:
-            asset_name = "{}".format(name)
+        asset_name = f"{asset}_{name}" if asset else asset_name = name
 
         tools = unreal.AssetToolsHelpers().get_asset_tools()
         asset_dir, container_name = tools.create_unique_asset_name(
@@ -802,7 +801,7 @@ class LayoutLoader(plugin.Loader):
                 lc for lc in layout_containers
                 if asset in lc.get('loaded_assets')]
 
-            if len(layouts) == 0:
+            if not layouts:
                 EditorAssetLibrary.delete_directory(str(Path(asset).parent))
 
         # Remove the Level Sequence from the parent.
@@ -812,17 +811,17 @@ class LayoutLoader(plugin.Loader):
         namespace = container.get('namespace').replace(f"{root}/", "")
         ms_asset = namespace.split('/')[0]
         ar = unreal.AssetRegistryHelpers.get_asset_registry()
-        filter = unreal.ARFilter(
+        _filter = unreal.ARFilter(
             class_names=["LevelSequence"],
             package_paths=[f"{root}/{ms_asset}"],
             recursive_paths=False)
-        sequences = ar.get_assets(filter)
+        sequences = ar.get_assets(_filter)
         master_sequence = sequences[0].get_asset()
-        filter = unreal.ARFilter(
+        _filter = unreal.ARFilter(
             class_names=["World"],
             package_paths=[f"{root}/{ms_asset}"],
             recursive_paths=False)
-        levels = ar.get_assets(filter)
+        levels = ar.get_assets(_filter)
         master_level = levels[0].get_editor_property('object_path')
 
         sequences = [master_sequence]

From 0c2d0bdd75961d8a685c810c6cbbf6d36591669d Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 26 May 2022 14:45:17 +0200
Subject: [PATCH 0371/1227] :bug: fix wrong assignment

---
 openpype/hosts/unreal/plugins/load/load_layout.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/unreal/plugins/load/load_layout.py b/openpype/hosts/unreal/plugins/load/load_layout.py
index 0632c3c0b5..c65cd25ac8 100644
--- a/openpype/hosts/unreal/plugins/load/load_layout.py
+++ b/openpype/hosts/unreal/plugins/load/load_layout.py
@@ -587,7 +587,7 @@ class LayoutLoader(plugin.Loader):
             hierarchy_dir_list.append(hierarchy_dir)
         asset = context.get('asset').get('name')
         suffix = "_CON"
-        asset_name = f"{asset}_{name}" if asset else asset_name = name
+        asset_name = f"{asset}_{name}" if asset else name
 
         tools = unreal.AssetToolsHelpers().get_asset_tools()
         asset_dir, container_name = tools.create_unique_asset_name(

From d3179847d266be44a96ab08e9b9b7fdffe5b3173 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 14:59:08 +0200
Subject: [PATCH 0372/1227] General: editorial otio_range in collection was one
 frame longer

---
 openpype/lib/editorial.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/lib/editorial.py b/openpype/lib/editorial.py
index 2c877b9d0d..7b2d22f738 100644
--- a/openpype/lib/editorial.py
+++ b/openpype/lib/editorial.py
@@ -168,7 +168,7 @@ def make_sequence_collection(path, otio_range, metadata):
     first, last = otio_range_to_frame_range(otio_range)
     collection = clique.Collection(
         head=head, tail=tail, padding=metadata["padding"])
-    collection.indexes.update([i for i in range(first, (last + 1))])
+    collection.indexes.update([i for i in range(first, last)])
     return dir_path, collection
 
 

From f96318cddd5e4cee2f66fa01ca85ccfb6bddb769 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Je=C5=BEek?= <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 15:01:56 +0200
Subject: [PATCH 0373/1227] Update openpype/hosts/flame/otio/flame_export.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/hosts/flame/otio/flame_export.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/otio/flame_export.py b/openpype/hosts/flame/otio/flame_export.py
index ffb82b97c2..9756d0442e 100644
--- a/openpype/hosts/flame/otio/flame_export.py
+++ b/openpype/hosts/flame/otio/flame_export.py
@@ -94,7 +94,7 @@ def create_otio_time_range(start_frame, frame_duration, fps):
 
 def _get_metadata(item):
     if hasattr(item, 'metadata'):
-        return dict(dict(item.metadata)) if item.metadata else {}
+        return dict(item.metadata) if item.metadata else {}
     return {}
 
 

From 95f836f41175128e548f9369d5e50c148e180e93 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Je=C5=BEek?= <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 15:02:17 +0200
Subject: [PATCH 0374/1227] Update openpype/hosts/flame/api/render_utils.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/hosts/flame/api/render_utils.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/flame/api/render_utils.py b/openpype/hosts/flame/api/render_utils.py
index 9957550af9..da22f117a7 100644
--- a/openpype/hosts/flame/api/render_utils.py
+++ b/openpype/hosts/flame/api/render_utils.py
@@ -1,8 +1,8 @@
 import os
 from xml.etree import ElementTree as ET
-import openpype.api as openpype
+import openpype.api import Logger
 
-log = openpype.Logger.get_logger(__name__)
+log = Logger.get_logger(__name__)
 
 
 def export_clip(export_path, clip, preset_path, **kwargs):

From 2d1f7b9873022ece16f822690a4269a15fb979c3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Je=C5=BEek?= <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 15:02:41 +0200
Subject: [PATCH 0375/1227] Update openpype/hosts/flame/otio/flame_export.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/hosts/flame/otio/flame_export.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/openpype/hosts/flame/otio/flame_export.py b/openpype/hosts/flame/otio/flame_export.py
index 9756d0442e..1e4ef866ed 100644
--- a/openpype/hosts/flame/otio/flame_export.py
+++ b/openpype/hosts/flame/otio/flame_export.py
@@ -280,9 +280,7 @@ def create_otio_clip(clip_data):
     segment = clip_data["PySegment"]
 
     # calculate source in
-    media_info = MediaInfoFile(clip_data["fpath"], **{
-        "logger": log
-    })
+    media_info = MediaInfoFile(clip_data["fpath"], logger=log)
     media_timecode_start = media_info.start_frame
     media_fps = media_info.fps
 

From db5d85080a418ed8e78908bb72339a0a41011b5c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Je=C5=BEek?= <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 15:03:29 +0200
Subject: [PATCH 0376/1227] Update
 openpype/hosts/flame/plugins/publish/extract_subset_resources.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../hosts/flame/plugins/publish/extract_subset_resources.py   | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 1bfe980a01..6319f4b041 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -425,9 +425,7 @@ class ExtractSubsetResources(openpype.api.Extractor):
         Import clip from path
         """
         dir_path = os.path.dirname(path)
-        media_info = MediaInfoFile(path, **{
-            "logger": self.log
-        })
+        media_info = MediaInfoFile(path, logger=self.log)
         file_pattern = media_info.file_pattern
         self.log.debug("__ file_pattern: {}".format(file_pattern))
 

From 024874b4f653725e56223fba8a2a7f47404c30f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Je=C5=BEek?= <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 15:06:16 +0200
Subject: [PATCH 0377/1227] Update
 openpype/hosts/flame/plugins/publish/extract_subset_resources.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../hosts/flame/plugins/publish/extract_subset_resources.py    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 6319f4b041..9265d3517c 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -60,7 +60,8 @@ class ExtractSubsetResources(openpype.api.Extractor):
     export_presets_mapping = {}
 
     def process(self, instance):
-        self._make_representation_data(instance)
+        if "representations" not in instance.data:
+            instance.data["representations"] = []
 
         # flame objects
         segment = instance.data["item"]

From a2289429a850061484300e81eaed99413a87ef38 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 26 May 2022 15:57:52 +0200
Subject: [PATCH 0378/1227] :sparkles: added collector for FBX camera export

---
 .../plugins/publish/collect_fbx_camera.py     | 20 +++++++++++++++++++
 .../defaults/project_settings/maya.json       |  3 +++
 .../schemas/schema_maya_publish.json          | 14 +++++++++++++
 3 files changed, 37 insertions(+)
 create mode 100644 openpype/hosts/maya/plugins/publish/collect_fbx_camera.py

diff --git a/openpype/hosts/maya/plugins/publish/collect_fbx_camera.py b/openpype/hosts/maya/plugins/publish/collect_fbx_camera.py
new file mode 100644
index 0000000000..bfa5bccbb9
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/collect_fbx_camera.py
@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+from maya import cmds  # noqa
+import pyblish.api
+
+
+class CollectFbxCamera(pyblish.api.InstancePlugin):
+    """Collect Camera for FBX export."""
+
+    order = pyblish.api.CollectorOrder + 0.2
+    label = "Collect Camera for FBX export"
+    families = ["camera"]
+
+    def process(self, instance):
+        if not instance.data.get("families"):
+            instance.data["families"] = []
+
+        if "fbx" not in instance.data["families"]:
+            instance.data["families"].append("fbx")
+
+        instance.data["cameras"] = True
diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 4cdfe1ca5d..e03bdcecc3 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -165,6 +165,9 @@
         "CollectMayaRender": {
             "sync_workfile_version": false
         },
+        "CollectFbxCamera": {
+            "enabled": false
+        },
         "ValidateInstanceInContext": {
             "enabled": true,
             "optional": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
index 2e5bc64e1c..9877b5ff0d 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
@@ -21,6 +21,20 @@
                 }
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "CollectFbxCamera",
+            "label": "Collect Camera for FBX export",
+            "checkbox_key": "enabled",
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                }
+            ]
+        },
         {
             "type": "splitter"
         },

From ab8068858cf62422b6838b7e526d723f1b81230a Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 16:32:25 +0200
Subject: [PATCH 0379/1227] flame: removing unneeded code

---
 .../flame/plugins/publish/extract_subset_resources.py    | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 9265d3517c..b91aec15c8 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -51,7 +51,6 @@ class ExtractSubsetResources(openpype.api.Extractor):
             "path_regex": ".*"
         }
     }
-    keep_original_representation = False
 
     # hide publisher during exporting
     hide_ui_on_process = True
@@ -329,14 +328,6 @@ class ExtractSubsetResources(openpype.api.Extractor):
         ):
             return True
 
-    def _make_representation_data(self, instance):
-        if (
-            self.keep_original_representation
-            and "representations" not in instance.data
-            or not self.keep_original_representation
-        ):
-            instance.data["representations"] = []
-
     def _unfolds_nested_folders(self, stage_dir, files_list, ext):
         """Unfolds nested folders
 

From 24c289a0d5088c708d9e6754dd8ebbc033e0e491 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 17:18:00 +0200
Subject: [PATCH 0380/1227] nuke: use framerange used as list but it is bool

---
 openpype/hosts/nuke/api/lib.py | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index ba8aa7a8db..f40425eefc 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -373,7 +373,7 @@ def add_write_node_legacy(name, **kwarg):
     Returns:
         node (obj): nuke write node
     """
-    frame_range = kwarg.get("use_range_limit", None)
+    use_range_limit = kwarg.get("use_range_limit", None)
 
     w = nuke.createNode(
         "Write",
@@ -391,10 +391,10 @@ def add_write_node_legacy(name, **kwarg):
             log.debug(e)
             continue
 
-    if frame_range:
+    if use_range_limit:
         w["use_limit"].setValue(True)
-        w["first"].setValue(frame_range[0])
-        w["last"].setValue(frame_range[1])
+        w["first"].setValue(kwarg["frame_range"][0])
+        w["last"].setValue(kwarg["frame_range"][1])
 
     return w
 
@@ -409,7 +409,7 @@ def add_write_node(name, file_path, knobs, **kwarg):
     Returns:
         node (obj): nuke write node
     """
-    frame_range = kwarg.get("use_range_limit", None)
+    use_range_limit = kwarg.get("use_range_limit", None)
 
     w = nuke.createNode(
         "Write",
@@ -420,10 +420,10 @@ def add_write_node(name, file_path, knobs, **kwarg):
     # finally add knob overrides
     set_node_knobs_from_settings(w, knobs, **kwarg)
 
-    if frame_range:
+    if use_range_limit:
         w["use_limit"].setValue(True)
-        w["first"].setValue(frame_range[0])
-        w["last"].setValue(frame_range[1])
+        w["first"].setValue(kwarg["frame_range"][0])
+        w["last"].setValue(kwarg["frame_range"][1])
 
     return w
 

From 693efa272fefee7c09aaa93eb78ffa07b3c198f2 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Thu, 26 May 2022 16:23:50 +0100
Subject: [PATCH 0381/1227] Camera creates master level if layout is missing

---
 .../hosts/unreal/plugins/load/load_camera.py  | 44 ++++++++++++-------
 1 file changed, 29 insertions(+), 15 deletions(-)

diff --git a/openpype/hosts/unreal/plugins/load/load_camera.py b/openpype/hosts/unreal/plugins/load/load_camera.py
index b33e45b6e9..c6061bc5c1 100644
--- a/openpype/hosts/unreal/plugins/load/load_camera.py
+++ b/openpype/hosts/unreal/plugins/load/load_camera.py
@@ -5,6 +5,7 @@ from pathlib import Path
 import unreal
 from unreal import EditorAssetLibrary
 from unreal import EditorLevelLibrary
+from unreal import EditorLevelUtils
 
 from openpype.pipeline import (
     AVALON_CONTAINER_ID,
@@ -84,10 +85,10 @@ class CameraLoader(plugin.Loader):
         hierarchy = context.get('asset').get('data').get('parents')
         root = "/Game/OpenPype"
         hierarchy_dir = root
-        hierarchy_list = []
+        hierarchy_dir_list = []
         for h in hierarchy:
             hierarchy_dir = f"{hierarchy_dir}/{h}"
-            hierarchy_list.append(hierarchy_dir)
+            hierarchy_dir_list.append(hierarchy_dir)
         asset = context.get('asset').get('name')
         suffix = "_CON"
         if asset:
@@ -121,27 +122,40 @@ class CameraLoader(plugin.Loader):
         asset_dir, container_name = tools.create_unique_asset_name(
             f"{hierarchy_dir}/{asset}/{name}_{unique_number:02d}", suffix="")
 
+        asset_path = Path(asset_dir)
+        asset_path_parent = str(asset_path.parent.as_posix())
+
         container_name += suffix
 
-        current_level = EditorLevelLibrary.get_editor_world().get_full_name()
+        EditorAssetLibrary.make_directory(asset_dir)
+
+        # Create map for the shot, and create hierarchy of map. If the maps
+        # already exist, we will use them.
+        h_dir = hierarchy_dir_list[0]
+        h_asset = hierarchy[0]
+        master_level = f"{h_dir}/{h_asset}_map.{h_asset}_map"
+        if not EditorAssetLibrary.does_asset_exist(master_level):
+            EditorLevelLibrary.new_level(f"{h_dir}/{h_asset}_map")
+
+        level = f"{asset_path_parent}/{asset}_map.{asset}_map"
+        if not EditorAssetLibrary.does_asset_exist(level):
+            EditorLevelLibrary.new_level(f"{asset_path_parent}/{asset}_map")
+
+            EditorLevelLibrary.load_level(master_level)
+            EditorLevelUtils.add_level_to_world(
+                EditorLevelLibrary.get_editor_world(),
+                level,
+                unreal.LevelStreamingDynamic
+            )
         EditorLevelLibrary.save_all_dirty_levels()
-
-        ar = unreal.AssetRegistryHelpers.get_asset_registry()
-        filter = unreal.ARFilter(
-            class_names=["World"],
-            package_paths=[f"{hierarchy_dir}/{asset}/"],
-            recursive_paths=True)
-        maps = ar.get_assets(filter)
-
-        # There should be only one map in the list
-        EditorLevelLibrary.load_level(maps[0].get_full_name())
+        EditorLevelLibrary.load_level(level)
 
         # Get all the sequences in the hierarchy. It will create them, if
         # they don't exist.
         sequences = []
         frame_ranges = []
         i = 0
-        for h in hierarchy_list:
+        for h in hierarchy_dir_list:
             root_content = EditorAssetLibrary.list_assets(
                 h, recursive=False, include_folder=False)
 
@@ -256,7 +270,7 @@ class CameraLoader(plugin.Loader):
             "{}/{}".format(asset_dir, container_name), data)
 
         EditorLevelLibrary.save_all_dirty_levels()
-        EditorLevelLibrary.load_level(current_level)
+        EditorLevelLibrary.load_level(master_level)
 
         asset_content = EditorAssetLibrary.list_assets(
             asset_dir, recursive=True, include_folder=True

From c5787b899257433f0873f61c9aa1408cd68c0bee Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 17:23:51 +0200
Subject: [PATCH 0382/1227] Flame: small bugs

---
 openpype/hosts/flame/api/render_utils.py                  | 2 +-
 openpype/plugins/publish/collect_otio_subset_resources.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/flame/api/render_utils.py b/openpype/hosts/flame/api/render_utils.py
index da22f117a7..a29d6be695 100644
--- a/openpype/hosts/flame/api/render_utils.py
+++ b/openpype/hosts/flame/api/render_utils.py
@@ -1,6 +1,6 @@
 import os
 from xml.etree import ElementTree as ET
-import openpype.api import Logger
+from openpype.api import Logger
 
 log = Logger.get_logger(__name__)
 
diff --git a/openpype/plugins/publish/collect_otio_subset_resources.py b/openpype/plugins/publish/collect_otio_subset_resources.py
index fb4cc6ee5e..40d4f35bdc 100644
--- a/openpype/plugins/publish/collect_otio_subset_resources.py
+++ b/openpype/plugins/publish/collect_otio_subset_resources.py
@@ -64,7 +64,7 @@ class CollectOtioSubsetResources(pyblish.api.InstancePlugin):
         a_frame_end_h = media_out + handle_end
 
         # create trimmed otio time range
-        trimmed_media_range_h = editorial.range_from_frames(
+        trimmed_media_range_h = oplib.range_from_frames(
             a_frame_start_h, (a_frame_end_h - a_frame_start_h) + 1,
             media_fps
         )

From ae233ce80cc9ecf549d2fdbebbc50d1ca29b8b98 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 17:26:00 +0200
Subject: [PATCH 0383/1227] hiero: PR suggestion

https://github.com/pypeclub/OpenPype/pull/3224#discussion_r882588237
---
 openpype/hosts/hiero/api/lib.py | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 5a9f38bf92..999dae5488 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -941,6 +941,10 @@ def is_overlapping(ti_test, ti_original, strict=False):
         (ti_test.timelineIn() <= ti_original.timelineIn())
         and (ti_test.timelineOut() >= ti_original.timelineOut())
     )
+
+    if strict:
+        return covering_exp
+
     inside_exp = (
         (ti_test.timelineIn() >= ti_original.timelineIn())
         and (ti_test.timelineOut() <= ti_original.timelineOut())
@@ -954,15 +958,12 @@ def is_overlapping(ti_test, ti_original, strict=False):
         and (ti_test.timelineIn() <= ti_original.timelineIn())
     )
 
-    if strict:
-        return covering_exp
-    else:
-        return any((
-            covering_exp,
-            inside_exp,
-            overlaying_right_exp,
-            overlaying_left_exp
-        ))
+    return any((
+        covering_exp,
+        inside_exp,
+        overlaying_right_exp,
+        overlaying_left_exp
+    ))
 
 
 def get_sequence_pattern_and_padding(file):

From 4cd4124e0128cac24938cf3d0098de04b9e5f58c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 17:40:27 +0200
Subject: [PATCH 0384/1227] flame: fixing frame range from editorial

---
 openpype/lib/editorial.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/lib/editorial.py b/openpype/lib/editorial.py
index 0de266725f..9f55d1fcb1 100644
--- a/openpype/lib/editorial.py
+++ b/openpype/lib/editorial.py
@@ -168,7 +168,7 @@ def make_sequence_collection(path, otio_range, metadata):
     first, last = otio_range_to_frame_range(otio_range)
     collection = clique.Collection(
         head=head, tail=tail, padding=metadata["padding"])
-    collection.indexes.update([i for i in range(first, (last + 1))])
+    collection.indexes.update(list(range(first, last)))
     return dir_path, collection
 
 

From 6d4c057a04291da0381af2a1339ec3c68319d50f Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 17:40:42 +0200
Subject: [PATCH 0385/1227] flame: removing default preset

---
 .../plugins/publish/extract_subset_resources.py   | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index b91aec15c8..0bad3f7cfc 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -34,21 +34,6 @@ class ExtractSubsetResources(openpype.api.Extractor):
             "representation_add_range": False,
             "representation_tags": ["thumbnail"],
             "path_regex": ".*"
-        },
-        "ftrackpreview": {
-            "active": True,
-            "ext": "mov",
-            "xml_preset_file": "Apple iPad (1920x1080).xml",
-            "xml_preset_dir": "",
-            "export_type": "Movie",
-            "parsed_comment_attrs": False,
-            "colorspace_out": "Output - Rec.709",
-            "representation_add_range": True,
-            "representation_tags": [
-                "review",
-                "delete"
-            ],
-            "path_regex": ".*"
         }
     }
 

From a4c32639d7bcd1aae3735f763fadd7a334968df9 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 26 May 2022 17:51:25 +0200
Subject: [PATCH 0386/1227] nuke: adding frame range to plugin

---
 openpype/hosts/nuke/plugins/create/create_write_prerender.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/hosts/nuke/plugins/create/create_write_prerender.py b/openpype/hosts/nuke/plugins/create/create_write_prerender.py
index 32ee1fd86f..fec97167fb 100644
--- a/openpype/hosts/nuke/plugins/create/create_write_prerender.py
+++ b/openpype/hosts/nuke/plugins/create/create_write_prerender.py
@@ -27,6 +27,10 @@ class CreateWritePrerender(plugin.AbstractWriteRender):
         # add fpath_template
         write_data["fpath_template"] = self.fpath_template
         write_data["use_range_limit"] = self.use_range_limit
+        write_data["frame_range"] = (
+            nuke.root()["first_frame"].value(),
+            nuke.root()["last_frame"].value()
+        )
 
         if not self.is_legacy():
             return create_write_node(

From b8cade1009bf4863b12c467fa0cbdef7b8d864e4 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 26 May 2022 18:43:00 +0200
Subject: [PATCH 0387/1227] Fix - Harmony message length

Harmony 21.1 doesn't have QDataStream anymore.

      This means we aren't able to write bytes into QByteArray so we had
      modify how content lenght is sent do the server.
      Content lenght is sent as string of 8 char convertible into integer
      (instead of 0x00000001[4 bytes] > "000000001"[8 bytes])
---
 openpype/hosts/harmony/api/TB_sceneOpened.js | 21 ++++++++++++++++----
 openpype/hosts/harmony/api/server.py         | 12 +++++++----
 2 files changed, 25 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/harmony/api/TB_sceneOpened.js b/openpype/hosts/harmony/api/TB_sceneOpened.js
index 610b0a73bb..e7cd555332 100644
--- a/openpype/hosts/harmony/api/TB_sceneOpened.js
+++ b/openpype/hosts/harmony/api/TB_sceneOpened.js
@@ -35,7 +35,11 @@ function Client() {
     self.pack = function(num) {
         var ascii='';
         for (var i = 3; i >= 0; i--) {
-            ascii += String.fromCharCode((num >> (8 * i)) & 255);
+          var hex = ((num >> (8 * i)) & 255).toString(16);
+          if (hex.length < 2){
+            ascii += "0";
+          }
+          ascii += hex;
         }
         return ascii;
     };
@@ -279,12 +283,21 @@ function Client() {
     };
 
     self._send = function(message) {
-      var codec_name = new QByteArray().append("ISO-8859-1");
+      /** Harmony 21.1 doesn't have QDataStream anymore.
+
+      This means we aren't able to write bytes into QByteArray so we had
+      modify how content lenght is sent do the server.
+      Content lenght is sent as string of 8 char convertible into integer
+      (instead of 0x00000001[4 bytes] > "000000001"[8 bytes]) */
+      var codec_name = new QByteArray().append("UTF-8");
+
       var codec = QTextCodec.codecForName(codec_name);
       var msg = codec.fromUnicode(message);
       var l = msg.size();
-      var coded = new QByteArray().append('AH').append(self.pack(l)).append(msg);
-      self.socket.write(new QByteArray(coded));
+      var header = new QByteArray().append('AH').append(self.pack(l));
+      var coded = msg.prepend(header);
+
+      self.socket.write(coded);
       self.logDebug('Sent.');
     };
 
diff --git a/openpype/hosts/harmony/api/server.py b/openpype/hosts/harmony/api/server.py
index 88cfe54521..0de359ec61 100644
--- a/openpype/hosts/harmony/api/server.py
+++ b/openpype/hosts/harmony/api/server.py
@@ -88,21 +88,25 @@ class Server(threading.Thread):
         """
         current_time = time.time()
         while True:
-
+            self.log.info("wait ttt")
             # Receive the data in small chunks and retransmit it
             request = None
-            header = self.connection.recv(6)
+            header = self.connection.recv(10)
             if len(header) == 0:
                 # null data received, socket is closing.
                 self.log.info(f"[{self.timestamp()}] Connection closing.")
                 break
+
             if header[0:2] != b"AH":
                 self.log.error("INVALID HEADER")
-            length = struct.unpack(">I", header[2:])[0]
+            content_length_str = header[2:].decode()
+
+            length = int(content_length_str, 16)
             data = self.connection.recv(length)
             while (len(data) < length):
                 # we didn't received everything in first try, lets wait for
                 # all data.
+                self.log.info("loop")
                 time.sleep(0.1)
                 if self.connection is None:
                     self.log.error(f"[{self.timestamp()}] "
@@ -113,7 +117,7 @@ class Server(threading.Thread):
                     break
 
                 data += self.connection.recv(length - len(data))
-
+            self.log.debug("data:: {} {}".format(data, type(data)))
             self.received += data.decode("utf-8")
             pretty = self._pretty(self.received)
             self.log.debug(

From bc3a8bbe2ff52903e0d9ab7f029c51407cd70ec3 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Thu, 26 May 2022 18:37:41 +0000
Subject: [PATCH 0388/1227] [Automated] Bump version

---
 CHANGELOG.md        | 37 +++++++++++++++++++------------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 21 insertions(+), 20 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3dd410391a..8437540a49 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## [3.10.0-nightly.5](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.10.0-nightly.6](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.9.8...HEAD)
 
@@ -10,14 +10,17 @@
 - General: Creator plugins from addons can be registered [\#3179](https://github.com/pypeclub/OpenPype/pull/3179)
 - Ftrack: Single image reviewable [\#3157](https://github.com/pypeclub/OpenPype/pull/3157)
 - Nuke: Expose write attributes to settings [\#3123](https://github.com/pypeclub/OpenPype/pull/3123)
-- Hiero: Initial frame publish support [\#3106](https://github.com/pypeclub/OpenPype/pull/3106)
 
 **🚀 Enhancements**
 
+- Maya: FBX camera export [\#3253](https://github.com/pypeclub/OpenPype/pull/3253)
+- General: updating common vendor `scriptmenu` to 1.5.2 [\#3246](https://github.com/pypeclub/OpenPype/pull/3246)
 - Project Manager: Allow to paste Tasks into multiple assets at the same time [\#3226](https://github.com/pypeclub/OpenPype/pull/3226)
 - Project manager: Sped up project load [\#3216](https://github.com/pypeclub/OpenPype/pull/3216)
 - Loader UI: Speed issues of loader with sync server [\#3199](https://github.com/pypeclub/OpenPype/pull/3199)
+- Looks: add basic support for Renderman [\#3190](https://github.com/pypeclub/OpenPype/pull/3190)
 - Maya: added clean\_import option to Import loader [\#3181](https://github.com/pypeclub/OpenPype/pull/3181)
+- Add the scripts menu definition to nuke [\#3168](https://github.com/pypeclub/OpenPype/pull/3168)
 - Maya: add maya 2023 to default applications [\#3167](https://github.com/pypeclub/OpenPype/pull/3167)
 - Compressed bgeo publishing in SAP and Houdini loader [\#3153](https://github.com/pypeclub/OpenPype/pull/3153)
 - General: Add 'dataclasses' to required python modules [\#3149](https://github.com/pypeclub/OpenPype/pull/3149)
@@ -28,24 +31,26 @@
 - General: Simplified OP modules/addons import [\#3137](https://github.com/pypeclub/OpenPype/pull/3137)
 - Terminal: Tweak coloring of TrayModuleManager logging enabled states [\#3133](https://github.com/pypeclub/OpenPype/pull/3133)
 - General: Cleanup some Loader docstrings [\#3131](https://github.com/pypeclub/OpenPype/pull/3131)
-- Nuke: render instance with subset name filtered overrides [\#3117](https://github.com/pypeclub/OpenPype/pull/3117)
 - Unreal: Layout and Camera update and remove functions reimplemented and improvements [\#3116](https://github.com/pypeclub/OpenPype/pull/3116)
-- Settings: Remove environment groups from settings [\#3115](https://github.com/pypeclub/OpenPype/pull/3115)
-- TVPaint: Match renderlayer key with other hosts [\#3110](https://github.com/pypeclub/OpenPype/pull/3110)
-- Tray publisher: Simple families from settings [\#3105](https://github.com/pypeclub/OpenPype/pull/3105)
 
 **🐛 Bug fixes**
 
+- nuke: use framerange issue [\#3254](https://github.com/pypeclub/OpenPype/pull/3254)
+- Ftrack: Chunk sizes for queries has minimal condition [\#3244](https://github.com/pypeclub/OpenPype/pull/3244)
+- Maya: renderman displays needs to be filtered [\#3242](https://github.com/pypeclub/OpenPype/pull/3242)
 - Ftrack: Validate that the user exists on ftrack [\#3237](https://github.com/pypeclub/OpenPype/pull/3237)
+- Maya: Fix support for multiple resolutions [\#3236](https://github.com/pypeclub/OpenPype/pull/3236)
 - TVPaint: Look for more groups than 12 [\#3228](https://github.com/pypeclub/OpenPype/pull/3228)
-- Project Manager: Fix persistent editors on project change [\#3218](https://github.com/pypeclub/OpenPype/pull/3218)
+- Hiero: debugging frame range and other 3.10 [\#3222](https://github.com/pypeclub/OpenPype/pull/3222)
 - Deadline: instance data overwrite fix [\#3214](https://github.com/pypeclub/OpenPype/pull/3214)
 - Ftrack: Push hierarchical attributes action works [\#3210](https://github.com/pypeclub/OpenPype/pull/3210)
 - Standalone Publisher: Always create new representation for thumbnail [\#3203](https://github.com/pypeclub/OpenPype/pull/3203)
 - Photoshop: skip collector when automatic testing [\#3202](https://github.com/pypeclub/OpenPype/pull/3202)
 - Nuke: render/workfile version sync doesn't work on farm [\#3185](https://github.com/pypeclub/OpenPype/pull/3185)
 - Ftrack: Review image only if there are no mp4 reviews [\#3183](https://github.com/pypeclub/OpenPype/pull/3183)
+- Ftrack: Locations deepcopy issue [\#3177](https://github.com/pypeclub/OpenPype/pull/3177)
 - General: Avoid creating multiple thumbnails [\#3176](https://github.com/pypeclub/OpenPype/pull/3176)
+- General: Avoid creating multiple thumbnails [\#3174](https://github.com/pypeclub/OpenPype/pull/3174)
 - General/Hiero: better clip duration calculation [\#3169](https://github.com/pypeclub/OpenPype/pull/3169)
 - General: Oiio conversion for ffmpeg checks for invalid characters [\#3166](https://github.com/pypeclub/OpenPype/pull/3166)
 - Fix for attaching render to subset [\#3164](https://github.com/pypeclub/OpenPype/pull/3164)
@@ -55,19 +60,19 @@
 - General: New Session schema [\#3141](https://github.com/pypeclub/OpenPype/pull/3141)
 - General: Missing version on headless mode crash properly [\#3136](https://github.com/pypeclub/OpenPype/pull/3136)
 - TVPaint: Composite layers in reversed order [\#3135](https://github.com/pypeclub/OpenPype/pull/3135)
-- Nuke: fixing default settings for workfile builder loaders [\#3120](https://github.com/pypeclub/OpenPype/pull/3120)
 - Nuke: fix anatomy imageio regex default [\#3119](https://github.com/pypeclub/OpenPype/pull/3119)
 
 **🔀 Refactored code**
 
-- Avalon repo removed from Jobs workflow [\#3193](https://github.com/pypeclub/OpenPype/pull/3193)
 - General: Remove remaining imports from avalon [\#3130](https://github.com/pypeclub/OpenPype/pull/3130)
 
 **Merged pull requests:**
 
+- Harmony: message length in 21.1 [\#3257](https://github.com/pypeclub/OpenPype/pull/3257)
+- Harmony: 21.1 fix [\#3249](https://github.com/pypeclub/OpenPype/pull/3249)
+- Webpublish: remove publish highlight when creating subset name [\#3234](https://github.com/pypeclub/OpenPype/pull/3234)
 - Maya: added jpg to filter for Image Plane Loader [\#3223](https://github.com/pypeclub/OpenPype/pull/3223)
 - Webpublisher: replace space by underscore in subset names [\#3160](https://github.com/pypeclub/OpenPype/pull/3160)
-- StandalonePublisher: removed Extract Background plugins [\#3093](https://github.com/pypeclub/OpenPype/pull/3093)
 
 ## [3.9.8](https://github.com/pypeclub/OpenPype/tree/3.9.8) (2022-05-19)
 
@@ -84,11 +89,13 @@
 - Standalone Publisher: Always create new representation for thumbnail [\#3204](https://github.com/pypeclub/OpenPype/pull/3204)
 - Nuke: render/workfile version sync doesn't work on farm  [\#3184](https://github.com/pypeclub/OpenPype/pull/3184)
 - Ftrack: Review image only if there are no mp4 reviews [\#3182](https://github.com/pypeclub/OpenPype/pull/3182)
-- Ftrack: Locations deepcopy issue [\#3177](https://github.com/pypeclub/OpenPype/pull/3177)
 - Ftrack: Locations deepcopy issue [\#3175](https://github.com/pypeclub/OpenPype/pull/3175)
-- General: Avoid creating multiple thumbnails [\#3174](https://github.com/pypeclub/OpenPype/pull/3174)
 - General: TemplateResult can be copied [\#3170](https://github.com/pypeclub/OpenPype/pull/3170)
 
+**🔀 Refactored code**
+
+- Avalon repo removed from Jobs workflow [\#3193](https://github.com/pypeclub/OpenPype/pull/3193)
+
 **Merged pull requests:**
 
 - hiero: otio p3 compatibility issue - metadata on effect use update  [\#3194](https://github.com/pypeclub/OpenPype/pull/3194)
@@ -123,19 +130,13 @@
 
 - Nuke: render instance with subset name filtered overrides \(3.9.x\) [\#3125](https://github.com/pypeclub/OpenPype/pull/3125)
 
-**🚀 Enhancements**
-
-- TVPaint: Match renderlayer key with other hosts [\#3109](https://github.com/pypeclub/OpenPype/pull/3109)
-
 **🐛 Bug fixes**
 
 - TVPaint: Composite layers in reversed order [\#3134](https://github.com/pypeclub/OpenPype/pull/3134)
-- General: Python 3 compatibility in queries [\#3111](https://github.com/pypeclub/OpenPype/pull/3111)
 
 **Merged pull requests:**
 
 - Ftrack: AssetVersion status on publish [\#3114](https://github.com/pypeclub/OpenPype/pull/3114)
-- renderman support for 3.9.x [\#3107](https://github.com/pypeclub/OpenPype/pull/3107)
 
 ## [3.9.5](https://github.com/pypeclub/OpenPype/tree/3.9.5) (2022-04-25)
 
diff --git a/openpype/version.py b/openpype/version.py
index eee776fd2c..984e4ba426 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.10.0-nightly.5"
+__version__ = "3.10.0-nightly.6"
diff --git a/pyproject.toml b/pyproject.toml
index 50cdefe1bb..1caa2a838a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.10.0-nightly.5" # OpenPype
+version = "3.10.0-nightly.6" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 728079233484fdc277a00e4dbffe4cc8d6fe2529 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Thu, 26 May 2022 18:58:41 +0000
Subject: [PATCH 0389/1227] [Automated] Release

---
 CHANGELOG.md        | 13 +++++--------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8437540a49..15659f8aa4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,8 @@
 # Changelog
 
-## [3.10.0-nightly.6](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
-[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.9.8...HEAD)
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.9.8...3.10.0)
 
 **🆕 New features**
 
@@ -42,6 +42,7 @@
 - Maya: Fix support for multiple resolutions [\#3236](https://github.com/pypeclub/OpenPype/pull/3236)
 - TVPaint: Look for more groups than 12 [\#3228](https://github.com/pypeclub/OpenPype/pull/3228)
 - Hiero: debugging frame range and other 3.10 [\#3222](https://github.com/pypeclub/OpenPype/pull/3222)
+- Project Manager: Fix persistent editors on project change [\#3218](https://github.com/pypeclub/OpenPype/pull/3218)
 - Deadline: instance data overwrite fix [\#3214](https://github.com/pypeclub/OpenPype/pull/3214)
 - Ftrack: Push hierarchical attributes action works [\#3210](https://github.com/pypeclub/OpenPype/pull/3210)
 - Standalone Publisher: Always create new representation for thumbnail [\#3203](https://github.com/pypeclub/OpenPype/pull/3203)
@@ -50,7 +51,6 @@
 - Ftrack: Review image only if there are no mp4 reviews [\#3183](https://github.com/pypeclub/OpenPype/pull/3183)
 - Ftrack: Locations deepcopy issue [\#3177](https://github.com/pypeclub/OpenPype/pull/3177)
 - General: Avoid creating multiple thumbnails [\#3176](https://github.com/pypeclub/OpenPype/pull/3176)
-- General: Avoid creating multiple thumbnails [\#3174](https://github.com/pypeclub/OpenPype/pull/3174)
 - General/Hiero: better clip duration calculation [\#3169](https://github.com/pypeclub/OpenPype/pull/3169)
 - General: Oiio conversion for ffmpeg checks for invalid characters [\#3166](https://github.com/pypeclub/OpenPype/pull/3166)
 - Fix for attaching render to subset [\#3164](https://github.com/pypeclub/OpenPype/pull/3164)
@@ -64,13 +64,13 @@
 
 **🔀 Refactored code**
 
+- Avalon repo removed from Jobs workflow [\#3193](https://github.com/pypeclub/OpenPype/pull/3193)
 - General: Remove remaining imports from avalon [\#3130](https://github.com/pypeclub/OpenPype/pull/3130)
 
 **Merged pull requests:**
 
 - Harmony: message length in 21.1 [\#3257](https://github.com/pypeclub/OpenPype/pull/3257)
 - Harmony: 21.1 fix [\#3249](https://github.com/pypeclub/OpenPype/pull/3249)
-- Webpublish: remove publish highlight when creating subset name [\#3234](https://github.com/pypeclub/OpenPype/pull/3234)
 - Maya: added jpg to filter for Image Plane Loader [\#3223](https://github.com/pypeclub/OpenPype/pull/3223)
 - Webpublisher: replace space by underscore in subset names [\#3160](https://github.com/pypeclub/OpenPype/pull/3160)
 
@@ -90,12 +90,9 @@
 - Nuke: render/workfile version sync doesn't work on farm  [\#3184](https://github.com/pypeclub/OpenPype/pull/3184)
 - Ftrack: Review image only if there are no mp4 reviews [\#3182](https://github.com/pypeclub/OpenPype/pull/3182)
 - Ftrack: Locations deepcopy issue [\#3175](https://github.com/pypeclub/OpenPype/pull/3175)
+- General: Avoid creating multiple thumbnails [\#3174](https://github.com/pypeclub/OpenPype/pull/3174)
 - General: TemplateResult can be copied [\#3170](https://github.com/pypeclub/OpenPype/pull/3170)
 
-**🔀 Refactored code**
-
-- Avalon repo removed from Jobs workflow [\#3193](https://github.com/pypeclub/OpenPype/pull/3193)
-
 **Merged pull requests:**
 
 - hiero: otio p3 compatibility issue - metadata on effect use update  [\#3194](https://github.com/pypeclub/OpenPype/pull/3194)
diff --git a/openpype/version.py b/openpype/version.py
index 984e4ba426..31be1f2f02 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.10.0-nightly.6"
+__version__ = "3.10.0"
diff --git a/pyproject.toml b/pyproject.toml
index 1caa2a838a..444af49273 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.10.0-nightly.6" # OpenPype
+version = "3.10.0" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From c8a8831f8d7b8afb5f78257fcbeae2dc47e33c52 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Fri, 27 May 2022 10:33:46 +0200
Subject: [PATCH 0390/1227] :bug: fix getting attribute for multilayer pxr

---
 openpype/hosts/maya/plugins/publish/collect_look.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index d295492f9a..7d258b01fa 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -571,7 +571,7 @@ class CollectLook(pyblish.api.InstancePlugin):
 
         self.log.debug("  - got {}".format(cmds.nodeType(node)))
 
-        attribute = FILE_NODES.get(cmds.nodeType(node))
+        attribute = get_attributes(FILE_NODES, cmds.nodeType(node))
         source = cmds.getAttr("{}.{}".format(
             node,
             attribute

From eff55dfce412ccc88666be98c207f5a9fbfe9ab3 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Fri, 27 May 2022 17:52:33 +0900
Subject: [PATCH 0391/1227] Expanding the scope of mvLook to publish mipmapped
 textures too, like TDL's generated by 3delight. During collection, we check
 to see if the TDL's exist beside the original texture, and if they do they
 get added to the collection.

Validation of these will depend on the publish intent and whether
`expectMipMap` is True in the publish set.

If mipmaps are expected and the intent is correct, the mipmaps will be
published along with the original file, which will accelerate rendering,
since 3dl will find that TDL and use it instead of having to generate it.
---
 .../plugins/create/create_multiverse_look.py  |  1 +
 .../publish/collect_multiverse_look.py        | 50 +++++++++-
 .../publish/validate_mvlook_contents.py       | 93 +++++++++++++++++++
 3 files changed, 141 insertions(+), 3 deletions(-)
 create mode 100644 openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py

diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_look.py b/openpype/hosts/maya/plugins/create/create_multiverse_look.py
index b2b9b5bb29..44977efca0 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_look.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_look.py
@@ -12,3 +12,4 @@ class CreateMultiverseLook(plugin.Creator):
     def __init__(self, *args, **kwargs):
         super(CreateMultiverseLook, self).__init__(*args, **kwargs)
         self.data["fileFormat"] = ["usda", "usd"]
+        self.data["expectMipMap"] = True
diff --git a/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
index c5ea6a2253..6bf4cecc3a 100644
--- a/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
@@ -17,6 +17,9 @@ SHAPE_ATTRS = ["castsShadows",
                "opposite"]
 
 SHAPE_ATTRS = set(SHAPE_ATTRS)
+COLOUR_SPACES = ['sRGB']
+MIPMAP_EXTENSIONS = ['tdl']
+
 
 def get_look_attrs(node):
     """Returns attributes of a node that are important for the look.
@@ -103,7 +106,7 @@ def seq_to_glob(path):
         "<uvtile>": "<uvtile>",
         "#": "#",
         "u<u>_v<v>": "<u>|<v>",
-        "<frame0": "<frame0\d+>", #noqa - copied from collect_look.py
+        "<frame0": "<frame0\d+>",  # noqa - copied from collect_look.py
         "<f>": "<f>"
     }
 
@@ -189,6 +192,22 @@ def get_file_node_files(node):
         return []
 
 
+def get_mipmap(fname):
+    for colour_space in COLOUR_SPACES:
+        for mipmap_ext in MIPMAP_EXTENSIONS:
+            mipmap_fname = '.'.join([fname, colour_space, mipmap_ext])
+            if os.path.exists(mipmap_fname):
+                return mipmap_fname
+    return None
+
+
+def is_mipamp(fname):
+    ext = os.path.splitext(fname)[1][1:]
+    if ext in MIPMAP_EXTENSIONS:
+        return True
+    return False
+
+
 class CollectMultiverseLookData(pyblish.api.InstancePlugin):
     """Collect Multiverse Look
 
@@ -219,6 +238,7 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
         files = []
         sets = {}
         instance.data["resources"] = []
+        expectMipMap = instance.data["expectMipMap"]
 
         for node in nodes:
             self.log.info("Getting resources for '{}'".format(node))
@@ -242,7 +262,7 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
                     files = cmds.ls(history, type="file", long=True)
 
                     for f in files:
-                        resources = self.collect_resource(f)
+                        resources = self.collect_resource(f, expectMipMap)
                         instance.data["resources"].append(resources)
 
                 elif isinstance(matOver, multiverse.MaterialSourceUsdPath):
@@ -255,7 +275,7 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
             "relationships": sets
         }
 
-    def collect_resource(self, node):
+    def collect_resource(self, node, expectMipMap):
         """Collect the link to the file(s) used (resource)
         Args:
             node (str): name of the node
@@ -310,6 +330,7 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
         source = source.replace("\\", "/")
 
         files = get_file_node_files(node)
+        files = self.handle_files(files, expectMipMap)
         if len(files) == 0:
             self.log.error("No valid files found from node `%s`" % node)
 
@@ -326,3 +347,26 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
                 "source": source,  # required for resources
                 "files": files,
                 "color_space": color_space}  # required for resources
+
+    def handle_files(self, files, expectMipMap):
+        """This will go through all the files and make sure that they are
+        either already mipmapped or have a corresponding mipmap sidecar and
+        add that to the list."""
+        if not expectMipMap:
+            return files
+
+        extra_files = []
+        self.log.debug("Expecting MipMaps, going to look for them.")
+        for fname in files:
+            self.log.info("Checking '{}' for mipmaps".format(fname))
+            if is_mipamp(fname):
+                self.log.debug(" - file is already MipMap, skipping.")
+                continue
+
+            mipmap = get_mipmap(fname)
+            if mipmap:
+                self.log.info(" mipmap found for '{}'".format(fname))
+                extra_files.append(mipmap)
+            else:
+                self.log.warning(" no mipmap found for '{}'".format(fname))
+        return files + extra_files
diff --git a/openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py b/openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py
new file mode 100644
index 0000000000..8f31cd4753
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py
@@ -0,0 +1,93 @@
+import pyblish.api
+import openpype.api
+import openpype.hosts.maya.api.action
+
+import os
+import pprint
+
+COLOUR_SPACES = ['sRGB']
+MIPMAP_EXTENSIONS = ['tdl']
+
+
+class ValidateMvLookContents(pyblish.api.InstancePlugin):
+    order = openpype.api.ValidateContentsOrder
+    families = ['mvLook']
+    hosts = ['maya']
+    label = 'Validate mvLook Data'
+    actions = [openpype.hosts.maya.api.action.SelectInvalidAction]
+
+    # Allow this validation step to be skipped when you just need to
+    # get things pushed through.
+    optional = True
+
+    # These intents get enforced checks, other ones get warnings.
+    enforced_intents = ['-', 'Final']
+
+    def process(self, instance):
+        intent = instance.context.data['intent']['value']
+        expectMipMap = instance.data["expectMipMap"]
+        enforced = True
+        if intent in self.enforced_intents:
+            self.log.info("This validation will be enforced: '{}'"
+                          .format(intent))
+        else:
+            enforced = False
+            self.log.info("This validation will NOT be enforced: '{}'"
+                          .format(intent))
+
+        if not instance[:]:
+            raise RuntimeError("Instance is empty")
+
+        invalid = set()
+
+        resources = instance.data.get("resources", [])
+        for resource in resources:
+            files = resource["files"]
+            self.log.debug("Resouce '{}', files: [{}]".format(resource, files))
+            node = resource["node"]
+            if len(files) == 0:
+                self.log.error("File node '{}' uses no or non-existing "
+                               "files".format(node))
+                invalid.add(node)
+                continue
+            for fname in files:
+                if not self.valid_file(fname):
+                    self.log.error("File node '{}'/'{}' is not valid"
+                                   .format(node, fname))
+                    invalid.add(node)
+
+                if expectMipMap and not self.is_or_has_mipmap(fname, files):
+                    msg = "File node '{}'/'{}' does not have a mipmap".format(
+                        node, fname)
+                    if enforced:
+                        invalid.add(node)
+                        self.log.error(msg)
+                        raise RuntimeError(msg)
+                    else:
+                        self.log.warning(msg)
+
+        if invalid:
+            raise RuntimeError("'{}' has invalid look "
+                               "content".format(instance.name))
+
+    def valid_file(self, fname):
+        self.log.debug("Checking validity of '{}'".format(fname))
+        if not os.path.exists(fname):
+            return False
+        if os.path.getsize(fname) == 0:
+            return False
+        return True
+
+    def is_or_has_mipmap(self, fname, files):
+        ext = os.path.splitext(fname)[1][1:]
+        if ext in MIPMAP_EXTENSIONS:
+            self.log.debug("Is a mipmap '{}'".format(fname))
+            return True
+
+        for colour_space in COLOUR_SPACES:
+            for mipmap_ext in MIPMAP_EXTENSIONS:
+                mipmap_fname = '.'.join([fname, colour_space, mipmap_ext])
+                if mipmap_fname in files:
+                    self.log.debug("Has a mipmap '{}'".format(fname))
+                    return True
+        return False

From c9e4b14a1e470d1f8059b448474657414537d5e9 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Fri, 27 May 2022 17:53:54 +0900
Subject: [PATCH 0392/1227] Removed unused pprint import.

---
 openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py b/openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py
index 8f31cd4753..34a8bc0c85 100644
--- a/openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py
+++ b/openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py
@@ -3,7 +3,6 @@ import openpype.api
 import openpype.hosts.maya.api.action
 
 import os
-import pprint
 
 COLOUR_SPACES = ['sRGB']
 MIPMAP_EXTENSIONS = ['tdl']

From 67fdfba49f35b585ad5e391271fb6ebe5e43f2d3 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 27 May 2022 11:01:40 +0200
Subject: [PATCH 0393/1227] OP-2790 - added note about remote publish to
 documentation

---
 website/docs/artist_hosts_maya.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/website/docs/artist_hosts_maya.md b/website/docs/artist_hosts_maya.md
index 73e89384e8..48e1093753 100644
--- a/website/docs/artist_hosts_maya.md
+++ b/website/docs/artist_hosts_maya.md
@@ -312,6 +312,10 @@ Example setup:
 
 ![Maya - Point Cache Example](assets/maya-pointcache_setup.png)
 
+:::note Publish on farm
+If your studio has Deadline configured, artists could choose to offload potentially long running export of pointache and publish it to the farm.
+Only thing that is necessary is to toggle `Farm` property in created pointcache instance to True.
+
 ### Loading Point Caches
 
 Loading point cache means creating reference to **abc** file with Go **OpenPype → Load...**.

From e1deb29da8615c050358da6254c6e9e10d9f0c13 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Fri, 27 May 2022 11:06:08 +0200
Subject: [PATCH 0394/1227] :bug: fix multiple attributes per node

---
 .../maya/plugins/publish/collect_look.py      | 115 +++++++++---------
 1 file changed, 59 insertions(+), 56 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index 7d258b01fa..93c02ce0fb 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -28,7 +28,7 @@ SHAPE_ATTRS = set(SHAPE_ATTRS)
 def get_pxr_multitexture_file_attrs(node):
     attrs = []
     for i in range(9):
-        if cmds.attributeQuery("filename{}".format(i), node):
+        if cmds.attributeQuery("filename{}".format(i), node=node, ex=True):
             file = cmds.getAttr("{}.filename{}".format(node, i))
             if file:
                 attrs.append("filename{}".format(i))
@@ -50,10 +50,10 @@ FILE_NODES = {
 }
 
 
-def get_attributes(dictionary, attr):
-    # type: (dict, str) -> list
+def get_attributes(dictionary, attr, node=None):
+    # type: (dict, str, str) -> list
     if callable(dictionary[attr]):
-        val = dictionary[attr]()
+        val = dictionary[attr](node)
     else:
         val = dictionary.get(attr, [])
 
@@ -205,7 +205,8 @@ def get_file_node_paths(node):
             return [texture_pattern]
 
     try:
-        file_attributes = get_attributes(FILE_NODES, cmds.nodeType(node))
+        file_attributes = get_attributes(
+            FILE_NODES, cmds.nodeType(node), node)
     except AttributeError:
         file_attributes = "fileTextureName"
 
@@ -434,7 +435,8 @@ class CollectLook(pyblish.api.InstancePlugin):
         # Collect textures if any file nodes are found
         instance.data["resources"] = []
         for n in files:
-            instance.data["resources"].append(self.collect_resource(n))
+            for res in self.collect_resources(n):
+                instance.data["resources"].append(res)
 
         self.log.info("Collected resources: {}".format(instance.data["resources"]))
 
@@ -554,7 +556,7 @@ class CollectLook(pyblish.api.InstancePlugin):
 
         return attributes
 
-    def collect_resource(self, node):
+    def collect_resources(self, node):
         """Collect the link to the file(s) used (resource)
         Args:
             node (str): name of the node
@@ -571,60 +573,61 @@ class CollectLook(pyblish.api.InstancePlugin):
 
         self.log.debug("  - got {}".format(cmds.nodeType(node)))
 
-        attribute = get_attributes(FILE_NODES, cmds.nodeType(node))
-        source = cmds.getAttr("{}.{}".format(
-            node,
-            attribute
-        ))
-        computed_attribute = "{}.{}".format(node, attribute)
-        if attribute == "fileTextureName":
-            computed_attribute = node + ".computedFileTextureNamePattern"
+        attributes = get_attributes(FILE_NODES, cmds.nodeType(node), node)
+        for attribute in attributes:
+            source = cmds.getAttr("{}.{}".format(
+                node,
+                attribute
+            ))
+            computed_attribute = "{}.{}".format(node, attribute)
+            if attribute == "fileTextureName":
+                computed_attribute = node + ".computedFileTextureNamePattern"
 
-        self.log.info("  - file source: {}".format(source))
-        color_space_attr = "{}.colorSpace".format(node)
-        try:
-            color_space = cmds.getAttr(color_space_attr)
-        except ValueError:
-            # node doesn't have colorspace attribute
-            color_space = "Raw"
-        # Compare with the computed file path, e.g. the one with the <UDIM>
-        # pattern in it, to generate some logging information about this
-        # difference
-        # computed_attribute = "{}.computedFileTextureNamePattern".format(node)
-        computed_source = cmds.getAttr(computed_attribute)
-        if source != computed_source:
-            self.log.debug("Detected computed file pattern difference "
-                           "from original pattern: {0} "
-                           "({1} -> {2})".format(node,
-                                                 source,
-                                                 computed_source))
+            self.log.info("  - file source: {}".format(source))
+            color_space_attr = "{}.colorSpace".format(node)
+            try:
+                color_space = cmds.getAttr(color_space_attr)
+            except ValueError:
+                # node doesn't have colorspace attribute
+                color_space = "Raw"
+            # Compare with the computed file path, e.g. the one with the <UDIM>
+            # pattern in it, to generate some logging information about this
+            # difference
+            # computed_attribute = "{}.computedFileTextureNamePattern".format(node)
+            computed_source = cmds.getAttr(computed_attribute)
+            if source != computed_source:
+                self.log.debug("Detected computed file pattern difference "
+                               "from original pattern: {0} "
+                               "({1} -> {2})".format(node,
+                                                     source,
+                                                     computed_source))
 
-        # We replace backslashes with forward slashes because V-Ray
-        # can't handle the UDIM files with the backslashes in the
-        # paths as the computed patterns
-        source = source.replace("\\", "/")
+            # We replace backslashes with forward slashes because V-Ray
+            # can't handle the UDIM files with the backslashes in the
+            # paths as the computed patterns
+            source = source.replace("\\", "/")
 
-        files = get_file_node_files(node)
-        if len(files) == 0:
-            self.log.error("No valid files found from node `%s`" % node)
+            files = get_file_node_files(node)
+            if len(files) == 0:
+                self.log.error("No valid files found from node `%s`" % node)
 
-        self.log.info("collection of resource done:")
-        self.log.info("  - node: {}".format(node))
-        self.log.info("  - attribute: {}".format(attribute))
-        self.log.info("  - source: {}".format(source))
-        self.log.info("  - file: {}".format(files))
-        self.log.info("  - color space: {}".format(color_space))
+            self.log.info("collection of resource done:")
+            self.log.info("  - node: {}".format(node))
+            self.log.info("  - attribute: {}".format(attribute))
+            self.log.info("  - source: {}".format(source))
+            self.log.info("  - file: {}".format(files))
+            self.log.info("  - color space: {}".format(color_space))
 
-        # Define the resource
-        return {
-            "node": node,
-            # here we are passing not only attribute, but with node again
-            # this should be simplified and changed extractor.
-            "attribute": "{}.{}".format(node, attribute),
-            "source": source,  # required for resources
-            "files": files,
-            "color_space": color_space
-        }  # required for resources
+            # Define the resource
+            yield {
+                "node": node,
+                # here we are passing not only attribute, but with node again
+                # this should be simplified and changed extractor.
+                "attribute": "{}.{}".format(node, attribute),
+                "source": source,  # required for resources
+                "files": files,
+                "color_space": color_space
+            }  # required for resources
 
 
 class CollectModelRenderSets(CollectLook):

From 9c73a4181ed5aa5dcd5a902e8876cbaab55350e2 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Fri, 27 May 2022 18:06:51 +0900
Subject: [PATCH 0395/1227] Fixing a typo!

---
 .../hosts/maya/plugins/publish/collect_multiverse_look.py     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
index 6bf4cecc3a..e77245bca5 100644
--- a/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
@@ -201,7 +201,7 @@ def get_mipmap(fname):
     return None
 
 
-def is_mipamp(fname):
+def is_mipmap(fname):
     ext = os.path.splitext(fname)[1][1:]
     if ext in MIPMAP_EXTENSIONS:
         return True
@@ -359,7 +359,7 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
         self.log.debug("Expecting MipMaps, going to look for them.")
         for fname in files:
             self.log.info("Checking '{}' for mipmaps".format(fname))
-            if is_mipamp(fname):
+            if is_mipmap(fname):
                 self.log.debug(" - file is already MipMap, skipping.")
                 continue
 

From 20b7b5dca4c44cff55538bc7b9a13705edab7206 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 27 May 2022 12:39:39 +0300
Subject: [PATCH 0396/1227] Style fixes, remove unused imports

---
 openpype/plugins/publish/extract_jpeg_exr.py | 15 ++-------------
 1 file changed, 2 insertions(+), 13 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index bb3b80b7ef..771ffc0aed 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -1,8 +1,7 @@
 import os
-from urllib.parse import MAX_CACHE_SIZE
 
 import pyblish.api
-from openpype.pipeline import ( 
+from openpype.pipeline import (
     legacy_io,
     KnownPublishError
 )
@@ -14,14 +13,8 @@ from openpype.lib import (
     filter_profiles,
     run_subprocess,
     path_to_subprocess_arg,
-
-    get_transcode_temp_directory,
-    convert_input_paths_for_ffmpeg,
-    should_convert_for_ffmpeg
 )
 
-import shutil
-
 
 class ExtractThumbnail(pyblish.api.InstancePlugin):
     """Create jpg thumbnail from sequence using ffmpeg"""
@@ -91,8 +84,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
 
             full_input_path = os.path.join(stagingdir, input_file)
             self.log.info("input {}".format(full_input_path))
-           
-            
             # Presumably the following is not needed since we are being
             # explicit
             # TODO: Test cases, cleanup.
@@ -149,7 +140,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                 jpeg_items.extend(ffmpeg_args.get("output") or [])
                 # we just want one frame from movie files
                 jpeg_items.append("-vframes 1")
-
                 # output file
                 jpeg_items.append(path_to_subprocess_arg(full_output_path))
                 subprocess_command = " ".join(jpeg_items)
@@ -207,8 +197,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                     output = run_subprocess(args)
                     if failed_output in output:
                         raise ValueError(
-                            "oiiotool processing failed. Args: {}".format(args))
-
+                            "oiiotool processing failed. Args: {}".format(args)) # noqa
                     new_repre = {
                         "name": "thumbnail",
                         "ext": "jpg",

From c4115f61a7571ca157c41bbd6d4984073527b98d Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 27 May 2022 12:02:39 +0200
Subject: [PATCH 0397/1227] Nuke: removing kwargs with more explicit attribute
 inputs

---
 .../plugins/publish/extract_slate_frame.py    | 25 +++++++++++--------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
index 2d20c1747c..c9362329a6 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
@@ -58,13 +58,20 @@ class ExtractSlateFrame(openpype.api.Extractor):
                 for o_name, o_data in instance.data["bakePresets"].items():
                     self.log.info("_ o_name: {}, o_data: {}".format(
                         o_name, pformat(o_data)))
-                    self.render_slate(instance, o_name, **o_data)
+                    self.render_slate(
+                        instance,
+                        bake_viewer_process=o_data[
+                            "bake_viewer_process"],
+                        bake_viewer_input_process=o_data[
+                            "bake_viewer_input_process"],
+                        output_name=o_name
+                    )
             else:
-                viewer_process_swithes = {
-                    "bake_viewer_process": True,
-                    "bake_viewer_input_process": True
-                }
-                self.render_slate(instance, None, **viewer_process_swithes)
+                self.render_slate(
+                    instance,
+                    bake_viewer_process=True,
+                    bake_viewer_input_process=True
+                )
 
     def _create_staging_dir(self, instance):
         staging_dir = os.path.normpath(
@@ -92,10 +99,6 @@ class ExtractSlateFrame(openpype.api.Extractor):
         if _output_name:
             _output_name = "_" + _output_name
 
-        bake_viewer_process = kwargs["bake_viewer_process"]
-        bake_viewer_input_process_node = kwargs[
-            "bake_viewer_input_process"]
-
         slate_first_frame = self.first_frame - 1
 
         collection = instance.data.get("collection", None)
@@ -128,7 +131,7 @@ class ExtractSlateFrame(openpype.api.Extractor):
 
         # only create colorspace baking if toggled on
         if bake_viewer_process:
-            if bake_viewer_input_process_node:
+            if bake_viewer_input_process:
                 # get input process and connect it to baking
                 ipn = get_view_process_node()
                 if ipn is not None:

From 709cf99ce0ebebafd936bd67f3c716e60c0081fa Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 27 May 2022 12:08:52 +0200
Subject: [PATCH 0398/1227] Nuke: adding docstring to slate renderer function

---
 .../plugins/publish/extract_slate_frame.py    | 31 +++++++++++--------
 1 file changed, 18 insertions(+), 13 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
index c9362329a6..01759e8b60 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
@@ -60,18 +60,12 @@ class ExtractSlateFrame(openpype.api.Extractor):
                         o_name, pformat(o_data)))
                     self.render_slate(
                         instance,
-                        bake_viewer_process=o_data[
-                            "bake_viewer_process"],
-                        bake_viewer_input_process=o_data[
-                            "bake_viewer_input_process"],
-                        output_name=o_name
+                        o_name,
+                        o_data["bake_viewer_process"],
+                        o_data["bake_viewer_input_process"]
                     )
             else:
-                self.render_slate(
-                    instance,
-                    bake_viewer_process=True,
-                    bake_viewer_input_process=True
-                )
+                self.render_slate(instance)
 
     def _create_staging_dir(self, instance):
         staging_dir = os.path.normpath(
@@ -85,10 +79,21 @@ class ExtractSlateFrame(openpype.api.Extractor):
     def render_slate(
         self,
         instance,
-        bake_viewer_process,
-        bake_viewer_input_process,
-        output_name=None
+        output_name=None,
+        bake_viewer_process=True,
+        bake_viewer_input_process=True
     ):
+        """Slate frame renderer
+
+        Args:
+            instance (PyblishInstance): Pyblish instance with subset data
+            output_name (str, optional):
+                Slate variation name. Defaults to None.
+            bake_viewer_process (bool, optional):
+                Switch for viewer profile baking. Defaults to True.
+            bake_viewer_input_process (bool, optional):
+                Switch for input process node baking. Defaults to True.
+        """
         slate_node = instance.data["slateNode"]
 
         # fill slate node with comments

From d2bc5d46d530ece81e77ef8187d3bcbcc026eb15 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 27 May 2022 12:36:02 +0200
Subject: [PATCH 0399/1227] Nuke: releasing plugin attributes and distributing
 them directly

---
 .../plugins/publish/extract_slate_frame.py    | 75 ++++++++++---------
 1 file changed, 38 insertions(+), 37 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
index 01759e8b60..87cb333ae1 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
@@ -27,22 +27,13 @@ class ExtractSlateFrame(openpype.api.Extractor):
     hosts = ["nuke"]
 
     # Settings values
-    # - can be extended by other attributes from node in the future
     key_value_mapping = {
         "f_submission_note": [True, "{comment}"],
         "f_submitting_for": [True, "{intent[value]}"],
         "f_vfx_scope_of_work": [False, ""]
     }
 
-    # constants
-    SLATE_TO_SEQUENCE_DONE = None
-
     def process(self, instance):
-        self.fpath = instance.data["path"]
-        self.first_frame = instance.data["frameStartHandle"]
-        self.last_frame = instance.data["frameEndHandle"]
-
-        self.log.info("Creating staging dir...")
 
         if "representations" not in instance.data:
             instance.data["representations"] = []
@@ -65,11 +56,18 @@ class ExtractSlateFrame(openpype.api.Extractor):
                         o_data["bake_viewer_input_process"]
                     )
             else:
+                # backward compatibility
                 self.render_slate(instance)
 
+            # also render image to sequence
+            self._render_slate_to_sequence(instance)
+
     def _create_staging_dir(self, instance):
+
+        self.log.info("Creating staging dir...")
+
         staging_dir = os.path.normpath(
-            os.path.dirname(self.fpath))
+            os.path.dirname(instance.data["path"]))
 
         instance.data["stagingDir"] = staging_dir
 
@@ -96,6 +94,13 @@ class ExtractSlateFrame(openpype.api.Extractor):
         """
         slate_node = instance.data["slateNode"]
 
+        # rendering path from group write node
+        fpath = instance.data["path"]
+
+        # instance frame range with handles
+        first_frame = instance.data["frameStartHandle"]
+        last_frame = instance.data["frameEndHandle"]
+
         # fill slate node with comments
         self.add_comment_slate_node(instance, slate_node)
 
@@ -104,7 +109,7 @@ class ExtractSlateFrame(openpype.api.Extractor):
         if _output_name:
             _output_name = "_" + _output_name
 
-        slate_first_frame = self.first_frame - 1
+        slate_first_frame = first_frame - 1
 
         collection = instance.data.get("collection", None)
 
@@ -114,22 +119,22 @@ class ExtractSlateFrame(openpype.api.Extractor):
                 "{head}{padding}{tail}"))
             fhead = collection.format("{head}")
         else:
-            fname = os.path.basename(self.fpath)
+            fname = os.path.basename(fpath)
             fhead = os.path.splitext(fname)[0] + "."
 
         if "#" in fhead:
             fhead = fhead.replace("#", "")[:-1]
 
-        self.log.debug("__ self.first_frame: {}".format(self.first_frame))
+        self.log.debug("__ first_frame: {}".format(first_frame))
         self.log.debug("__ slate_first_frame: {}".format(slate_first_frame))
 
         # Read node
         r_node = nuke.createNode("Read")
-        r_node["file"].setValue(self.fpath)
-        r_node["first"].setValue(self.first_frame)
-        r_node["origfirst"].setValue(self.first_frame)
-        r_node["last"].setValue(self.last_frame)
-        r_node["origlast"].setValue(self.last_frame)
+        r_node["file"].setValue(fpath)
+        r_node["first"].setValue(first_frame)
+        r_node["origfirst"].setValue(first_frame)
+        r_node["last"].setValue(last_frame)
+        r_node["origlast"].setValue(last_frame)
         r_node["colorspace"].setValue(instance.data["colorspace"])
         previous_node = r_node
         temporary_nodes = [previous_node]
@@ -186,25 +191,21 @@ class ExtractSlateFrame(openpype.api.Extractor):
         nuke.execute(
             write_node.name(), int(slate_first_frame), int(slate_first_frame))
 
-        # also render image to sequence
-        self._render_slate_to_sequence(instance, slate_first_frame)
+        # Clean up
+        for node in temporary_nodes:
+            nuke.delete(node)
 
-        # # Clean up
-        # for node in temporary_nodes:
-        #     nuke.delete(node)
+    def _render_slate_to_sequence(self, instance):
+        # set slate frame
+        first_frame = instance.data["frameStartHandle"]
+        slate_first_frame = first_frame - 1
 
-    def _render_slate_to_sequence(self, instance, slate_first_frame):
-        if not self.SLATE_TO_SEQUENCE_DONE:
-            node_subset_name = instance.data["name"]
-            # also render slate as sequence frame
-            nuke.execute(
-                node_subset_name,
-                int(slate_first_frame),
-                int(slate_first_frame)
-            )
-
-            # mark as done
-            self.SLATE_TO_SEQUENCE_DONE = True
+        # render slate as sequence frame
+        nuke.execute(
+            instance.data["name"],
+            int(slate_first_frame),
+            int(slate_first_frame)
+        )
 
     def add_comment_slate_node(self, instance, node):
 
@@ -225,8 +226,8 @@ class ExtractSlateFrame(openpype.api.Extractor):
             "intent": intent
         })
 
-        for key, value in self.key_value_mapping.items():
-            enabled, template = value
+        for key, _values in self.key_value_mapping.items():
+            enabled, template = _values
             if not enabled:
                 self.log.debug("Key \"{}\" is disabled".format(key))
                 continue

From a24896962062e4db576ccb33ce2dbafec77ac789 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 27 May 2022 16:14:17 +0200
Subject: [PATCH 0400/1227] Nuke: bake reformat was failing on string type

---
 openpype/hosts/nuke/api/plugin.py | 14 +++-----------
 1 file changed, 3 insertions(+), 11 deletions(-)

diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index 2bad6f2c78..b8b56ef2b8 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -18,7 +18,8 @@ from .lib import (
     maintained_selection,
     set_avalon_knob_data,
     add_publish_knob,
-    get_nuke_imageio_settings
+    get_nuke_imageio_settings,
+    set_node_knobs_from_settings
 )
 
 
@@ -497,16 +498,7 @@ class ExporterReviewMov(ExporterReview):
             add_tags.append("reformated")
 
             rf_node = nuke.createNode("Reformat")
-            for kn_conf in reformat_node_config:
-                _type = kn_conf["type"]
-                k_name = str(kn_conf["name"])
-                k_value = kn_conf["value"]
-
-                # to remove unicode as nuke doesn't like it
-                if _type == "string":
-                    k_value = str(kn_conf["value"])
-
-                rf_node[k_name].setValue(k_value)
+            set_node_knobs_from_settings(rf_node, reformat_node_config)
 
             # connect
             rf_node.setInput(0, self.previous_node)

From c3c9cca5c2d1c3b29d5b4beaddbe2c855a32b3b8 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Fri, 27 May 2022 17:00:04 +0200
Subject: [PATCH 0401/1227] :recycle: :dog: fix hound

---
 openpype/hosts/maya/plugins/publish/collect_look.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index 93c02ce0fb..323bede761 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -590,10 +590,9 @@ class CollectLook(pyblish.api.InstancePlugin):
             except ValueError:
                 # node doesn't have colorspace attribute
                 color_space = "Raw"
-            # Compare with the computed file path, e.g. the one with the <UDIM>
-            # pattern in it, to generate some logging information about this
-            # difference
-            # computed_attribute = "{}.computedFileTextureNamePattern".format(node)
+            # Compare with the computed file path, e.g. the one with
+            # the <UDIM> pattern in it, to generate some logging information
+            # about this difference
             computed_source = cmds.getAttr(computed_attribute)
             if source != computed_source:
                 self.log.debug("Detected computed file pattern difference "

From f27176bed1ac255128fdbe3d4f9c1d6100942508 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Sat, 28 May 2022 03:44:32 +0000
Subject: [PATCH 0402/1227] [Automated] Bump version

---
 CHANGELOG.md        | 23 +++++++++++++++++------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 15659f8aa4..4a5e1f1067 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,24 @@
 # Changelog
 
+## [3.10.1-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.10.0...HEAD)
+
+**🚀 Enhancements**
+
+- TVPaint: Init file for TVPaint worker also handle guideline images [\#3250](https://github.com/pypeclub/OpenPype/pull/3250)
+- Support for Unreal 5 [\#3122](https://github.com/pypeclub/OpenPype/pull/3122)
+
+**🐛 Bug fixes**
+
+- Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
+- Unreal: Fixed Animation loading in UE5 [\#3240](https://github.com/pypeclub/OpenPype/pull/3240)
+- Unreal: Fixed Render creation in UE5 [\#3239](https://github.com/pypeclub/OpenPype/pull/3239)
+- Unreal: Fixed Camera loading in UE5 [\#3238](https://github.com/pypeclub/OpenPype/pull/3238)
+
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
-[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.9.8...3.10.0)
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.10.0-nightly.6...3.10.0)
 
 **🆕 New features**
 
@@ -31,7 +47,6 @@
 - General: Simplified OP modules/addons import [\#3137](https://github.com/pypeclub/OpenPype/pull/3137)
 - Terminal: Tweak coloring of TrayModuleManager logging enabled states [\#3133](https://github.com/pypeclub/OpenPype/pull/3133)
 - General: Cleanup some Loader docstrings [\#3131](https://github.com/pypeclub/OpenPype/pull/3131)
-- Unreal: Layout and Camera update and remove functions reimplemented and improvements [\#3116](https://github.com/pypeclub/OpenPype/pull/3116)
 
 **🐛 Bug fixes**
 
@@ -131,10 +146,6 @@
 
 - TVPaint: Composite layers in reversed order [\#3134](https://github.com/pypeclub/OpenPype/pull/3134)
 
-**Merged pull requests:**
-
-- Ftrack: AssetVersion status on publish [\#3114](https://github.com/pypeclub/OpenPype/pull/3114)
-
 ## [3.9.5](https://github.com/pypeclub/OpenPype/tree/3.9.5) (2022-04-25)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.10.0-nightly.2...3.9.5)
diff --git a/openpype/version.py b/openpype/version.py
index 31be1f2f02..12f25cdcea 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.10.0"
+__version__ = "3.10.1-nightly.1"
diff --git a/pyproject.toml b/pyproject.toml
index 444af49273..47d678b5e8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.10.0" # OpenPype
+version = "3.10.1-nightly.1" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From d404fbf8a285e0e25f5af3d8695c6df547f0ceab Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 30 May 2022 11:51:19 +0200
Subject: [PATCH 0403/1227] OP-3277 - added functionality to replace root value
 with environment variable.

Useful for remote workflows where Site Sync is being used.
When Load reference is used, real root value (c:/project) is replaced with ${OPENPYPE_ROOT_WORK}.
---
 openpype/hosts/maya/plugins/load/load_reference.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/load/load_reference.py b/openpype/hosts/maya/plugins/load/load_reference.py
index d65b5a2c1e..7fa7362ecc 100644
--- a/openpype/hosts/maya/plugins/load/load_reference.py
+++ b/openpype/hosts/maya/plugins/load/load_reference.py
@@ -8,6 +8,7 @@ from openpype.pipeline import (
     legacy_create,
 )
 import openpype.hosts.maya.api.plugin
+from openpype.api import Anatomy
 from openpype.hosts.maya.api.lib import maintained_selection
 
 
@@ -51,7 +52,9 @@ class ReferenceLoader(openpype.hosts.maya.api.plugin.ReferenceLoader):
 
         with maintained_selection():
             cmds.loadPlugin("AbcImport.mll", quiet=True)
-            nodes = cmds.file(self.fname,
+            anatomy = Anatomy(context["project"]["code"])
+            file_url = anatomy.replace_root_with_env_key(self.fname, '${{{}}}')
+            nodes = cmds.file(file_url,
                               namespace=namespace,
                               sharedReferenceFile=False,
                               reference=True,

From 46ab3b8e3aa8aa258dd49e880e723ee48513ac0b Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Mon, 30 May 2022 20:20:40 +0900
Subject: [PATCH 0404/1227] Addressed a concern raised for how file_formats are
 extracted from instance. Renamed `expectMipMap` to `publishMipMap` to make it
 more clear. Added `linear` & `auto` to possible color spaces.

---
 .../maya/plugins/create/create_multiverse_look.py  |  2 +-
 .../plugins/publish/collect_multiverse_look.py     | 14 +++++++-------
 .../maya/plugins/publish/extract_multiverse_usd.py |  9 +++------
 .../plugins/publish/extract_multiverse_usd_comp.py |  9 +++------
 .../plugins/publish/extract_multiverse_usd_over.py |  9 +++------
 .../plugins/publish/validate_mvlook_contents.py    |  6 +++---
 6 files changed, 20 insertions(+), 29 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_look.py b/openpype/hosts/maya/plugins/create/create_multiverse_look.py
index 44977efca0..3fc834a700 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_look.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_look.py
@@ -12,4 +12,4 @@ class CreateMultiverseLook(plugin.Creator):
     def __init__(self, *args, **kwargs):
         super(CreateMultiverseLook, self).__init__(*args, **kwargs)
         self.data["fileFormat"] = ["usda", "usd"]
-        self.data["expectMipMap"] = True
+        self.data["publishMipMap"] = True
diff --git a/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
index e77245bca5..edf40a27a6 100644
--- a/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_multiverse_look.py
@@ -17,7 +17,7 @@ SHAPE_ATTRS = ["castsShadows",
                "opposite"]
 
 SHAPE_ATTRS = set(SHAPE_ATTRS)
-COLOUR_SPACES = ['sRGB']
+COLOUR_SPACES = ['sRGB', 'linear', 'auto']
 MIPMAP_EXTENSIONS = ['tdl']
 
 
@@ -238,7 +238,7 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
         files = []
         sets = {}
         instance.data["resources"] = []
-        expectMipMap = instance.data["expectMipMap"]
+        publishMipMap = instance.data["publishMipMap"]
 
         for node in nodes:
             self.log.info("Getting resources for '{}'".format(node))
@@ -262,7 +262,7 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
                     files = cmds.ls(history, type="file", long=True)
 
                     for f in files:
-                        resources = self.collect_resource(f, expectMipMap)
+                        resources = self.collect_resource(f, publishMipMap)
                         instance.data["resources"].append(resources)
 
                 elif isinstance(matOver, multiverse.MaterialSourceUsdPath):
@@ -275,7 +275,7 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
             "relationships": sets
         }
 
-    def collect_resource(self, node, expectMipMap):
+    def collect_resource(self, node, publishMipMap):
         """Collect the link to the file(s) used (resource)
         Args:
             node (str): name of the node
@@ -330,7 +330,7 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
         source = source.replace("\\", "/")
 
         files = get_file_node_files(node)
-        files = self.handle_files(files, expectMipMap)
+        files = self.handle_files(files, publishMipMap)
         if len(files) == 0:
             self.log.error("No valid files found from node `%s`" % node)
 
@@ -348,11 +348,11 @@ class CollectMultiverseLookData(pyblish.api.InstancePlugin):
                 "files": files,
                 "color_space": color_space}  # required for resources
 
-    def handle_files(self, files, expectMipMap):
+    def handle_files(self, files, publishMipMap):
         """This will go through all the files and make sure that they are
         either already mipmapped or have a corresponding mipmap sidecar and
         add that to the list."""
-        if not expectMipMap:
+        if not publishMipMap:
             return files
 
         extra_files = []
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
index 4bc0322fa8..fe071b08a5 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
@@ -133,18 +133,15 @@ class ExtractMultiverseUsd(openpype.api.Extractor):
 
         return options
 
-    def get_file_format(self, instance):
-        fileFormat = instance.data["fileFormat"]
-        if fileFormat in range(len(self.file_formats)):
-            self.scene_type = self.file_formats[fileFormat]
-
     def process(self, instance):
         # Load plugin first
         cmds.loadPlugin("MultiverseForMaya", quiet=True)
 
         # Define output file path
         staging_dir = self.staging_dir(instance)
-        self.get_file_format(instance)
+        file_format = instance.data.get("fileFormat", 0)
+        if file_format in range(len(self.file_formats)):
+            self.scene_type = self.file_formats[file_format]
         file_name = "{0}.{1}".format(instance.name, self.scene_type)
         file_path = os.path.join(staging_dir, file_name)
         file_path = file_path.replace('\\', '/')
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
index f76a24f7ff..7be6b101d9 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
@@ -75,18 +75,15 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
 
         return options
 
-    def get_file_format(self, instance):
-        fileFormat = instance.data["fileFormat"]
-        if fileFormat in range(len(self.file_formats)):
-            self.scene_type = self.file_formats[fileFormat]
-
     def process(self, instance):
         # Load plugin first
         cmds.loadPlugin("MultiverseForMaya", quiet=True)
 
         # Define output file path
         staging_dir = self.staging_dir(instance)
-        self.get_file_format(instance)
+        file_format = instance.data.get("fileFormat", 0)
+        if file_format in range(len(self.file_formats)):
+            self.scene_type = self.file_formats[file_format]
         file_name = "{0}.{1}".format(instance.name, self.scene_type)
         file_path = os.path.join(staging_dir, file_name)
         file_path = file_path.replace('\\', '/')
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
index 3b101ab6cf..091750c32b 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
@@ -60,18 +60,15 @@ class ExtractMultiverseUsdOverride(openpype.api.Extractor):
             "timeSamplesSpan": 0.0
         }
 
-    def get_file_format(self, instance):
-        fileFormat = instance.data["fileFormat"]
-        if fileFormat in range(len(self.file_formats)):
-            self.scene_type = self.file_formats[fileFormat]
-
     def process(self, instance):
         # Load plugin first
         cmds.loadPlugin("MultiverseForMaya", quiet=True)
 
         # Define output file path
         staging_dir = self.staging_dir(instance)
-        self.get_file_format(instance)
+        file_format = instance.data.get("fileFormat", 0)
+        if file_format in range(len(self.file_formats)):
+            self.scene_type = self.file_formats[file_format]
         file_name = "{0}.{1}".format(instance.name, self.scene_type)
         file_path = os.path.join(staging_dir, file_name)
         file_path = file_path.replace("\\", "/")
diff --git a/openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py b/openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py
index 34a8bc0c85..bac2c030c8 100644
--- a/openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py
+++ b/openpype/hosts/maya/plugins/publish/validate_mvlook_contents.py
@@ -4,7 +4,7 @@ import openpype.hosts.maya.api.action
 
 import os
 
-COLOUR_SPACES = ['sRGB']
+COLOUR_SPACES = ['sRGB', 'linear', 'auto']
 MIPMAP_EXTENSIONS = ['tdl']
 
 
@@ -24,7 +24,7 @@ class ValidateMvLookContents(pyblish.api.InstancePlugin):
 
     def process(self, instance):
         intent = instance.context.data['intent']['value']
-        expectMipMap = instance.data["expectMipMap"]
+        publishMipMap = instance.data["publishMipMap"]
         enforced = True
         if intent in self.enforced_intents:
             self.log.info("This validation will be enforced: '{}'"
@@ -55,7 +55,7 @@ class ValidateMvLookContents(pyblish.api.InstancePlugin):
                                    .format(node, fname))
                     invalid.add(node)
 
-                if expectMipMap and not self.is_or_has_mipmap(fname, files):
+                if publishMipMap and not self.is_or_has_mipmap(fname, files):
                     msg = "File node '{}'/'{}' does not have a mipmap".format(
                         node, fname)
                     if enforced:

From 277024de81843a3198c47402e7b251f937ab0817 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 30 May 2022 13:23:24 +0200
Subject: [PATCH 0405/1227] OP-3277 - extracted logic to ReferenceLoader

All inheriting plugins implementing shared method.
Flag 'use_env_var_as_root' set to True for testing temporarily, proper location in Setting should be decided.
---
 openpype/hosts/maya/api/plugin.py             | 25 +++++++++++++++++++
 .../maya/plugins/load/_load_animation.py      |  5 ++--
 openpype/hosts/maya/plugins/load/load_ass.py  | 12 ++++++---
 openpype/hosts/maya/plugins/load/load_look.py |  4 ++-
 .../hosts/maya/plugins/load/load_reference.py |  5 ++--
 .../hosts/maya/plugins/load/load_yeti_rig.py  |  4 ++-
 6 files changed, 45 insertions(+), 10 deletions(-)

diff --git a/openpype/hosts/maya/api/plugin.py b/openpype/hosts/maya/api/plugin.py
index 3721868823..93b0793d9c 100644
--- a/openpype/hosts/maya/api/plugin.py
+++ b/openpype/hosts/maya/api/plugin.py
@@ -10,6 +10,7 @@ from openpype.pipeline import (
     get_representation_path,
     AVALON_CONTAINER_ID,
 )
+from openpype.api import Anatomy
 
 from .pipeline import containerise
 from . import lib
@@ -132,6 +133,7 @@ class ReferenceLoader(Loader):
                  " imported representation ?"
         )
     ]
+    use_env_var_as_root = True
 
     def load(
         self,
@@ -191,6 +193,25 @@ class ReferenceLoader(Loader):
         """To be implemented by subclass"""
         raise NotImplementedError("Must be implemented by subclass")
 
+    def prepare_root_value(self, file_url, project_name):
+        """Replace root value with env var placeholder.
+
+        Use ${OPENPYPE_ROOT_WORK} (or any other root) instead of proper root
+        value when storing referenced url into a workfile.
+        Useful for remote workflows with SiteSync.
+
+        Args:
+            file_url (str)
+            project_name (dict)
+        Returns:
+            (str)
+        """
+        if self.use_env_var_as_root:
+            anatomy = Anatomy(project_name)
+            file_url = anatomy.replace_root_with_env_key(file_url, '${{{}}}')
+
+        return file_url
+
     def update(self, container, representation):
         from maya import cmds
         from openpype.hosts.maya.api.lib import get_container_members
@@ -230,6 +251,10 @@ class ReferenceLoader(Loader):
                 self.log.debug("No alembic nodes found in {}".format(members))
 
         try:
+            path = self.prepare_root_value(path,
+                                           representation["context"]
+                                                         ["project"]
+                                                         ["code"])
             content = cmds.file(path,
                                 loadReference=reference_node,
                                 type=file_type,
diff --git a/openpype/hosts/maya/plugins/load/_load_animation.py b/openpype/hosts/maya/plugins/load/_load_animation.py
index 9c37e498ef..0010efb829 100644
--- a/openpype/hosts/maya/plugins/load/_load_animation.py
+++ b/openpype/hosts/maya/plugins/load/_load_animation.py
@@ -35,8 +35,9 @@ class AbcLoader(openpype.hosts.maya.api.plugin.ReferenceLoader):
 
         # hero_001 (abc)
         # asset_counter{optional}
-
-        nodes = cmds.file(self.fname,
+        file_url = self.prepare_root_value(self.fname,
+                                           context["project"]["code"])
+        nodes = cmds.file(file_url,
                           namespace=namespace,
                           sharedReferenceFile=False,
                           groupReference=True,
diff --git a/openpype/hosts/maya/plugins/load/load_ass.py b/openpype/hosts/maya/plugins/load/load_ass.py
index a284b7ec1f..1f0eb88995 100644
--- a/openpype/hosts/maya/plugins/load/load_ass.py
+++ b/openpype/hosts/maya/plugins/load/load_ass.py
@@ -64,9 +64,11 @@ class AssProxyLoader(openpype.hosts.maya.api.plugin.ReferenceLoader):
                     path = os.path.join(publish_folder, filename)
 
             proxyPath = proxyPath_base + ".ma"
-            self.log.info
 
-            nodes = cmds.file(proxyPath,
+            file_url = self.prepare_root_value(proxyPath,
+                                               context["project"]["code"])
+
+            nodes = cmds.file(file_url,
                               namespace=namespace,
                               reference=True,
                               returnNewNodes=True,
@@ -123,7 +125,11 @@ class AssProxyLoader(openpype.hosts.maya.api.plugin.ReferenceLoader):
         assert os.path.exists(proxyPath), "%s does not exist." % proxyPath
 
         try:
-            content = cmds.file(proxyPath,
+            file_url = self.prepare_root_value(proxyPath,
+                                               representation["context"]
+                                                             ["project"]
+                                                             ["code"])
+            content = cmds.file(file_url,
                                 loadReference=reference_node,
                                 type="mayaAscii",
                                 returnNewNodes=True)
diff --git a/openpype/hosts/maya/plugins/load/load_look.py b/openpype/hosts/maya/plugins/load/load_look.py
index 80eac8e0b5..ae3a683241 100644
--- a/openpype/hosts/maya/plugins/load/load_look.py
+++ b/openpype/hosts/maya/plugins/load/load_look.py
@@ -31,7 +31,9 @@ class LookLoader(openpype.hosts.maya.api.plugin.ReferenceLoader):
         import maya.cmds as cmds
 
         with lib.maintained_selection():
-            nodes = cmds.file(self.fname,
+            file_url = self.prepare_root_value(self.fname,
+                                               context["project"]["code"])
+            nodes = cmds.file(file_url,
                               namespace=namespace,
                               reference=True,
                               returnNewNodes=True)
diff --git a/openpype/hosts/maya/plugins/load/load_reference.py b/openpype/hosts/maya/plugins/load/load_reference.py
index 7fa7362ecc..e4355ed3d4 100644
--- a/openpype/hosts/maya/plugins/load/load_reference.py
+++ b/openpype/hosts/maya/plugins/load/load_reference.py
@@ -8,7 +8,6 @@ from openpype.pipeline import (
     legacy_create,
 )
 import openpype.hosts.maya.api.plugin
-from openpype.api import Anatomy
 from openpype.hosts.maya.api.lib import maintained_selection
 
 
@@ -52,8 +51,8 @@ class ReferenceLoader(openpype.hosts.maya.api.plugin.ReferenceLoader):
 
         with maintained_selection():
             cmds.loadPlugin("AbcImport.mll", quiet=True)
-            anatomy = Anatomy(context["project"]["code"])
-            file_url = anatomy.replace_root_with_env_key(self.fname, '${{{}}}')
+            file_url = self.prepare_root_value(self.fname,
+                                               context["project"]["code"])
             nodes = cmds.file(file_url,
                               namespace=namespace,
                               sharedReferenceFile=False,
diff --git a/openpype/hosts/maya/plugins/load/load_yeti_rig.py b/openpype/hosts/maya/plugins/load/load_yeti_rig.py
index b4d31b473f..241c28467a 100644
--- a/openpype/hosts/maya/plugins/load/load_yeti_rig.py
+++ b/openpype/hosts/maya/plugins/load/load_yeti_rig.py
@@ -53,7 +53,9 @@ class YetiRigLoader(openpype.hosts.maya.api.plugin.ReferenceLoader):
 
         # load rig
         with lib.maintained_selection():
-            nodes = cmds.file(self.fname,
+            file_url = self.prepare_root_value(self.fname,
+                                               context["project"]["code"])
+            nodes = cmds.file(file_url,
                               namespace=namespace,
                               reference=True,
                               returnNewNodes=True,

From 9afdf50bdc43ddbc014abd0ce4143d1755e79495 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Mon, 30 May 2022 15:18:51 +0300
Subject: [PATCH 0406/1227] initial conversion refactor

---
 openpype/plugins/publish/extract_jpeg_exr.py | 153 +++++++++++++------
 1 file changed, 106 insertions(+), 47 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 771ffc0aed..88fa627183 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -73,17 +73,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         filtered_repres = self._get_filtered_repres(instance)
 
         for repre in filtered_repres:
-            repre_files = repre["files"]
-            if not isinstance(repre_files, (list, tuple)):
-                input_file = repre_files
-            else:
-                file_index = int(float(len(repre_files)) * 0.5)
-                input_file = repre_files[file_index]
-
-            stagingdir = os.path.normpath(repre["stagingDir"])
-
-            full_input_path = os.path.join(stagingdir, input_file)
-            self.log.info("input {}".format(full_input_path))
             # Presumably the following is not needed since we are being
             # explicit
             # TODO: Test cases, cleanup.
@@ -110,6 +99,17 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             #         self.log
             #     )
             #     full_input_path = os.path.join(convert_dir, filename)
+            repre_files = repre["files"]
+            if not isinstance(repre_files, (list, tuple)):
+                input_file = repre_files
+            else:
+                file_index = int(float(len(repre_files)) * 0.5)
+                input_file = repre_files[file_index]
+
+            stagingdir = os.path.normpath(repre["stagingDir"])
+
+            full_input_path = os.path.join(stagingdir, input_file)
+            self.log.info("input {}".format(full_input_path))
             filename = os.path.splitext(input_file)[0]
             if not filename.endswith('.'):
                 filename += "."
@@ -178,42 +178,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                     # places where things may break
                     oiio_tool_path = get_oiio_tools_path()
                     full_output_path = os.path.join(stagingdir, jpeg_file)
-                    args = [oiio_tool_path]
-                    oiio_cmd = [oiio_tool_path,
-                                full_input_path, "-o",
-                                full_output_path
-                                ]
-                    subprocess_exr = " ".join(oiio_cmd)
-                    self.log.info(f"running: {subprocess_exr}")
-                    run_subprocess(subprocess_exr, logger=self.log)
-
-                    # raise error if there is no ouptput
-                    if not os.path.exists(full_input_path):
-                        self.log.error(
-                            ("File {} was not converted "
-                             "by oiio tool!").format(full_input_path))
-                        raise AssertionError("OIIO tool conversion failed")
-                    failed_output = "oiiotool produced no output."
-                    output = run_subprocess(args)
-                    if failed_output in output:
-                        raise ValueError(
-                            "oiiotool processing failed. Args: {}".format(args)) # noqa
-                    new_repre = {
-                        "name": "thumbnail",
-                        "ext": "jpg",
-                        "files": jpeg_file,
-                        "stagingDir": stagingdir,
-                        "thumbnail": True,
-                        "tags": ["thumbnail"]
-                    }
-                    # adding representation
-                    self.log.debug("Adding: {}".format(new_repre))
-                    instance.data["representations"].append(new_repre)
-
-                    # Create only one representation with name 'thumbnail'
-                    # TODO maybe handle way how to decide from which repre
-                    # will be thumbnail created
-                break
+                    
 
     def _get_filtered_repres(self, instance):
         filtered_repres = []
@@ -233,3 +198,97 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
 
             filtered_repres.append(repre)
         return filtered_repres
+
+
+    def create_thumbnail_oiio(self, src_path, dst_path):
+        args = [oiio_tool_path]
+        oiio_cmd = [oiio_tool_path,
+                    full_input_path, "-o",
+                    full_output_path
+                    ]
+        subprocess_exr = " ".join(oiio_cmd)
+        self.log.info(f"running: {subprocess_exr}")
+        run_subprocess(subprocess_exr, logger=self.log)
+
+        # raise error if there is no ouptput
+        if not os.path.exists(full_input_path):
+            self.log.error(
+                ("File {} was not converted "
+                    "by oiio tool!").format(full_input_path))
+            raise AssertionError("OIIO tool conversion failed")
+        failed_output = "oiiotool produced no output."
+        output = run_subprocess(args)
+        if failed_output in output:
+            raise ValueError(
+                "oiiotool processing failed. Args: {}".format(args)) # noqa
+        new_repre = {
+            "name": "thumbnail",
+            "ext": "jpg",
+            "files": jpeg_file,
+            "stagingDir": stagingdir,
+            "thumbnail": True,
+            "tags": ["thumbnail"]
+        }
+        # adding representation
+        self.log.debug("Adding: {}".format(new_repre))
+        instance.data["representations"].append(new_repre)
+
+        # Create only one representation with name 'thumbnail'
+        # TODO maybe handle way how to decide from which repre
+        # will be thumbnail created
+
+    def create_thumbnail_ffmpeg(self, src_path, dst_path):
+        self.log.info("output {}".format(full_output_path))
+
+        ffmpeg_path = get_ffmpeg_tool_path("ffmpeg")
+        ffmpeg_args = self.ffmpeg_args or {}
+
+        jpeg_items = []
+        jpeg_items.append(path_to_subprocess_arg(ffmpeg_path))
+        # override file if already exists
+        jpeg_items.append("-y")
+        # flag for large file sizes
+        max_int = 2147483647
+        jpeg_items.append("-analyzeduration {}".format(max_int))
+        jpeg_items.append("-probesize {}".format(max_int))
+        # use same input args like with mov
+        jpeg_items.extend(ffmpeg_args.get("input") or [])
+        # input file
+        jpeg_items.append("-i {}".format(
+            path_to_subprocess_arg(full_input_path)
+        ))
+        # output arguments from presets
+        jpeg_items.extend(ffmpeg_args.get("output") or [])
+        # we just want one frame from movie files
+        jpeg_items.append("-vframes 1")
+        # output file
+        jpeg_items.append(path_to_subprocess_arg(full_output_path))
+        subprocess_command = " ".join(jpeg_items)
+
+        # run subprocess
+        self.log.debug("{}".format(subprocess_command))
+        try:  # temporary until oiiotool is supported cross platform
+            run_subprocess(
+                subprocess_command, shell=True, logger=self.log
+            )
+        except RuntimeError as exp:
+            if "Compression" in str(exp):
+                self.log.debug(
+                    "Unsupported compression on input files. Skipping!"
+                )
+                return
+            self.log.warning("Conversion crashed", exc_info=True)
+            raise
+
+        new_repre = {
+            "name": "thumbnail",
+            "ext": "jpg",
+            "files": jpeg_file,
+            "stagingDir": stagingdir,
+            "thumbnail": True,
+            "tags": ["thumbnail"]
+        }
+
+        # adding representation
+        self.log.debug("Adding: {}".format(new_repre))
+        instance.data["representations"].append(new_repre)
\ No newline at end of file

From 38c8d2c8fe63c81fbc55c4f079e4f72519575c3c Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 30 May 2022 15:27:15 +0200
Subject: [PATCH 0407/1227] Fix udim support for e.g. uppercase <UDIM> tag

---
 openpype/hosts/maya/plugins/publish/collect_look.py | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index 323bede761..dc17ddc605 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -109,16 +109,18 @@ def node_uses_image_sequence(node, node_path):
     """
 
     # useFrameExtension indicates an explicit image sequence
-    # The following tokens imply a sequence
-    patterns = ["<udim>", "<tile>", "<uvtile>",
-                "u<u>_v<v>", "<frame0", "<f4>"]
     try:
         use_frame_extension = cmds.getAttr('%s.useFrameExtension' % node)
     except ValueError:
         use_frame_extension = False
+    if use_frame_extension:
+        return True
 
-    return (use_frame_extension or
-            any(pattern in node_path for pattern in patterns))
+    # The following tokens imply a sequence
+    patterns = ["<udim>", "<tile>", "<uvtile>",
+                "u<u>_v<v>", "<frame0", "<f4>"]
+    node_path_lowered = node_path.lower()
+    return any(pattern in node_path_lowered for pattern in patterns)
 
 
 def seq_to_glob(path):

From 254455e786c50ef20d0f953bebd57d50af077b1e Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 30 May 2022 18:05:56 +0200
Subject: [PATCH 0408/1227] OP-3277 - introduced Settings variable

Configured via Maya/Maya-dirmap to use in all Loaders
---
 openpype/hosts/maya/api/plugin.py             | 45 ++++++++++---------
 .../defaults/project_settings/maya.json       |  1 +
 .../projects_schema/schema_project_maya.json  |  6 +++
 3 files changed, 31 insertions(+), 21 deletions(-)

diff --git a/openpype/hosts/maya/api/plugin.py b/openpype/hosts/maya/api/plugin.py
index 93b0793d9c..f05893a7b4 100644
--- a/openpype/hosts/maya/api/plugin.py
+++ b/openpype/hosts/maya/api/plugin.py
@@ -11,7 +11,7 @@ from openpype.pipeline import (
     AVALON_CONTAINER_ID,
 )
 from openpype.api import Anatomy
-
+from openpype.settings import get_project_settings
 from .pipeline import containerise
 from . import lib
 
@@ -133,7 +133,6 @@ class ReferenceLoader(Loader):
                  " imported representation ?"
         )
     ]
-    use_env_var_as_root = True
 
     def load(
         self,
@@ -193,25 +192,6 @@ class ReferenceLoader(Loader):
         """To be implemented by subclass"""
         raise NotImplementedError("Must be implemented by subclass")
 
-    def prepare_root_value(self, file_url, project_name):
-        """Replace root value with env var placeholder.
-
-        Use ${OPENPYPE_ROOT_WORK} (or any other root) instead of proper root
-        value when storing referenced url into a workfile.
-        Useful for remote workflows with SiteSync.
-
-        Args:
-            file_url (str)
-            project_name (dict)
-        Returns:
-            (str)
-        """
-        if self.use_env_var_as_root:
-            anatomy = Anatomy(project_name)
-            file_url = anatomy.replace_root_with_env_key(file_url, '${{{}}}')
-
-        return file_url
-
     def update(self, container, representation):
         from maya import cmds
         from openpype.hosts.maya.api.lib import get_container_members
@@ -344,6 +324,29 @@ class ReferenceLoader(Loader):
         except RuntimeError:
             pass
 
+    def prepare_root_value(self, file_url, project_name):
+        """Replace root value with env var placeholder.
+
+        Use ${OPENPYPE_ROOT_WORK} (or any other root) instead of proper root
+        value when storing referenced url into a workfile.
+        Useful for remote workflows with SiteSync.
+
+        Args:
+            file_url (str)
+            project_name (dict)
+        Returns:
+            (str)
+        """
+        settings = get_project_settings(project_name)
+        use_env_var_as_root = (settings["maya"]
+                                       ["maya-dirmap"]
+                                       ["use_env_var_as_root"])
+        if use_env_var_as_root:
+            anatomy = Anatomy(project_name)
+            file_url = anatomy.replace_root_with_env_key(file_url, '${{{}}}')
+
+        return file_url
+
     @staticmethod
     def _organize_containers(nodes, container):
         # type: (list, str) -> None
diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index e03bdcecc3..a42f889e85 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -8,6 +8,7 @@
         "yetiRig": "ma"
     },
     "maya-dirmap": {
+        "use_env_var_as_root": true,
         "enabled": false,
         "paths": {
             "source-path": [],
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json b/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
index 0c7943447b..f9523b1baa 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
@@ -22,6 +22,12 @@
             "label": "Maya Directory Mapping",
             "is_group": true,
             "children": [
+                {
+                    "type": "boolean",
+                    "key": "use_env_var_as_root",
+                    "label": "Use env var placeholder in referenced url",
+                    "docstring": "Use ${} placeholder instead of physical value of root when storing into workfile metadata."
+                },
                 {
                     "type": "boolean",
                     "key": "enabled",

From 99b6050cbec6c35d088e106a7ef5aebb182fbb6a Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 30 May 2022 18:47:09 +0200
Subject: [PATCH 0409/1227] Replace by last nuke familly icon

---
 openpype/resources/app_icons/hiero.png      | Bin 46366 -> 87054 bytes
 openpype/resources/app_icons/nuke.png       | Bin 49012 -> 86832 bytes
 openpype/resources/app_icons/nukestudio.png | Bin 46080 -> 101945 bytes
 openpype/resources/app_icons/nukex.png      | Bin 44709 -> 99787 bytes
 4 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/openpype/resources/app_icons/hiero.png b/openpype/resources/app_icons/hiero.png
index 04bbf6265bb63f0615c2b98ab48891d03483f6b2..ba666c2fe0819e7c769bc2dc6d96c853b349fd80 100644
GIT binary patch
literal 87054
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%0A(CbMDEAy!zLpk*3DzbD%2alA
zZ(bOqb9XqhUktw7+4FB-QnY^{mw9S)9cw)|f4pivkEXwst%(@<9WnKE2)~)m!2Rg9
zYiThdlO1TN|IP_QiKwD=pn(j<K$!|HP;&C~rLEEG1&%%#?j^>l7nJ3Y31#+Tg`h{!
zo#{$4AhTk<GcGydWl(*Cw56a<@AIvbO;zMCHL|9-W@ILW)P^-)`+J`%6XZ;={q@pD
zdFyxMLR&oIGw%9}-4`7ooQ~uE`4RtK%3g8%a;@tJ;>bVFM|p=&KS{78Fh%0N@}zse
z#aYzW)XW`+rJr3we_&@YIg=QGLCE1yo0nbPpVRQnjDQuYZ<81IMkdtqT}(vM51527
z20b+RA$>Es_$a~J;z-F*UczIi4!zZ<-8F^L6TUC$#;!xr82itj0ZJ81w}9K={Du<t
zC_J>E@ojO0y6zD|40G@U=lZS5RsGEotZBaS@mEFqR2d1sr97KDr8#)I)DABZ3?K3z
z4qao08NOSSC1iq-nuDjgL2kvZ`-7%gim92rK$DeV4a(1E%n>*fqd{#u@gm3XWvty4
z_MJY-VDK5UsESd`$<h)1TP>N3s*ri8?APwF*;n93!yByJI7cDsBOM5TVVa94UKtNm
ziQ7wxnL+5@d#;bw1f86DWOplo4}t#5Hz^4AgR1iKqwI6co~m57MoS`~DE;K>Y9$%A
z1Afr&6uqg2wKUn69Q~W38t8<fhERGmLsoMNZ*Ik}x%g)u<%O#$oXT{c%ryBmpP}6F
zuGUStyWD7LRjNr=nb|NW3;JXKqVgFQb#}eK_1K8`B7r4J{iyUp5iQKPoarRc!$a7_
zZP)peo8`@DOr3W&dS}tr97<QNj?pq3gqaDP=mehkg?|0*oIA>qrXmg-arfxX4US+g
z`2ntO&EeZ}Lvtp4O?td~sd_k5R}&GT&=36whS%9xRNo&E`VN0jY}*E5$ZGAuxew#K
zH<q4+Sib-KDX0tzW4@S>xO(wMclk7aw$LZg|CFi~KKv<-!RlqH6{h{4^GkL8YZA#2
zLR|_^FrOUs1t0~jx&lzV@1X|Ux31e`(+`^;7-%rKX?S=`5dt2>I-^j%7^~{hsP3UY
ze&0Hx<+XWyADF_-z4nh~UW?di`6;p0O7BE9;h$J%#d05l2$MpOGba%bL}J0dl_ngF
zzQgJsSp!eaW&Qetz|+57dvd2Y@tt#CoJ%tSi&JgS$91;08k!`;jS|%bV4Ktsp>c)0
z!Yk_%N`vr%3?*{iQsySH-;Ni_Vk(;-63Aw0%0v%hHDbD|F!;c%t1*RC(7l?BZJqp2
zKG|>Z!_XA+^%c+U=$~<{S*TJ_ruL#hrmVo6$+r81g3}SI#abOQ>=Did;p>kK#Nmub
z-k6JdXmmO)q(*!o5xuu@`-8i!d!KgZwk@U>d}fQC+iXrj+Z6*qCEO$h9UoKD+~Jin
z*G%7Xe$Q>i{v<;0$Y96!t|TZ#gh4$xysMy&dGYtf+zFCPK-tG(-IjaAm;6&<!zxx%
z=#-RLuUqoXuhhiZ$CtHjBU)te8r?wn`^j5z6da0HDS^jPrWYQYShttuYq-&mM$}>o
zf)d+nf4+ae#f`puw(&7jqnww$^!?V)`5XW=E`qK|X{@G(h96o$vB&wIkF6U<ZhJFZ
zY~1M31R4-Jwla@4dmE)TAF-$_@e#<covrYu-8A0DG-4rA;d9tO5Oo}#Bi5aATUpzp
z^h5&mEf4GVpD&D)b*7k&Be@usTXQKQAUDhV1rv1IFQQ)l`SqRQl1)6@HH+$msjhAz
z$~hkI<BWbJ8z{&f%`OJ8gj(O&Si14~`&mcJLE`=uQYcYndG*eOHCORDNU(-4=ZZ9O
z_Z@JFVQE0(GCbRDyv5G9^%j3lj_MzV7ujLSE@2j?n8I1(ukA(9-z*5$U+o$Mlzc1M
zki1)~jEsKZ^&7~1b1uQ}^M@KsW)C+|Tw!jlF8qye-M8zyw9cX;Ig^yPkVl|#f0l$9
zGn(BEu$<V=$w_+_G>XGk{H-!W`6VT0YPYcyQkc-Yt4?jggTOg<F5ufly1A1m_tVEj
zr;(R>*QO-G`ClYZMz{~I$pwklt2?Z!TGBHMP4it@m7khxOc5(wuqC{gk1RAJ(l7tm
zAcQ?{r@UO2)g~%NIL1*2k8FD;KEQpd@%zO4oA8T~LDCXXI59bDEgv)%dF5>6{`{>?
zza!G}5sTSJF0S-fWu+f~0^VZ}*HzK<zphd|5Oe*^_cx}vj#b)<O5k54<~W(bNh<b8
zq~tS;q@~z@Pbi^p8rn*kB$S3bcv;nnndzU;eJ<GSr16?by(9o(M|mqYCGmtPrkn|#
zg^w{&#m}c^dmzTZq#bb!Ju+hdQi13}%ez7!6gCEmY`k|v_v$T6_i)A2<mEY-6)Dw(
z;w<Gxlu8GJIK0vPB9juW{S&LsG3+;g;1-T?a>S7S!ynuwvD5|iKlu%6bVX=dlqWPK
z9wc9(+FCVrRC<~3KauSHhM38FTt?gS4v95GkH&}6B>DJI_H3I@3VgFFCk||I){Kmd
zlo=Tr5B!7gY>~5v*de6&pfR-SCIC751sT$;wLt6RNXu1h;J45k<Ra<(h7mInyLgd%
zi@e3S@I3!lYs596u&W=JAM4Bj7a&XL&)&G@8Jn!Hd}Bnc2ie5(t^Lk@=GUu^t@UBz
z!K={*Le#iOQ@eueieSzK_(7>B>?W3aDrKeSIqqNm68j(&Mg3Hd>^rvn^5S29<-M%L
zSCr}mGiiEdq~NP$H>RnoM>ibRo=qwGwjyXiwbpA$;^Fwq(l#3W>s$Xpo{f2<OZZJ*
zy(8oqPz%`o<*u5p_RQVn@R9iF^F<S~ZmVJ8P`*BQfu(ohOBdi1k$^xEwOS8#OlA&U
z0CKMOO8Wb8!Fa!As=ZWA;|iK@G9A17mB(~}4h|y$+JNcMUaU?}N8JG_-TT;aS70H?
zrETkHVfcRt5Zhicyg=Pzd{ua+RM5~wK?dX8%U%3I`jBVqmP6SMEoOEiCt=ltTPBuS
z1(`#saW=?<$W?iJV71?}57xx}vZG`lQE~70mpTy<RDr+zG^nY}g#0+kVFv8Pk`DwO
zwL%cI7%|W%dkKGOg4Y#zu<WXd+*1>t<Z_-oEQ=4h4+ZR_L44Y*;wbOY{9^Nfu$ID`
zw8IN+TumhbG%RY};UeNK=Bnwi^v;HD?$8^P9GaZLbugYd{BG_kIq4*s=5g|=F8hhA
z0GJR+ZgSsAJtgl8R}ue=1UoA?-Gix0Gx1=6<*=WHFfWkP(t?}?GI1YH_qYmN`xYnW
zNFA(1qnwxha6`JwFd>p?V}fp9d}*uocdAomobF3FNzg_vd#}-M-Yd~p=er$!Fa($0
zSy?Bp*yEw)V6V)>!iYF1r1#sCXM6w#TcBx|AJ>P*Gh1o#+(XXAB4$=G9K6W_poxje
z48Xo?%5B+wVgk3=T0X^+*jewdpiEwNj4&_oWP#z=!y6{CLJd@QVigG<xn6H}Qm8rj
zt*N`&Q!D*3QI`BL9toWH0@hK0_ayE0b-D?!kJ>q~H%X{kU0yyS;0%6jU~pfTmTij|
z1GwVD9?fAAdHO+JTy$M1Z4_#E>$!3l^TF<0UOT_%#IQMm>_^r=OX34^M%?<F?etKa
zizM*RUV-sAo>~e&)o7q@zu3{~M@OL{;_(rw!hiY*2_%NYvHKp&w{Yo()OxceAH)IY
zwlz;@41aE2R;H9wP1=(6I@j!Bw2te8eQSR|n#Xf-zT!dv5;UK)jY+w|`ea>Les0R-
z9v+RqZ_No@kLPT^{*LUDEG=8-de%QdYendL9!1`#kUXtqGf?9Biz3Tz02V>DVGVap
z;J#&IuVwk=+sHsn7SyNELO(BB(AnA81Hb=Mv`hW;Twnu{@-3`^wP@u+qB|^r{emR=
zw&1gpF(DcuC1|<R_Y=INqa$J5^qpGM(=8}NM-Zzr*yavh20Q7ffeY(r@Q|45JUB+;
zJw8?!S8#cKg}7ABn<ti<`L&^Sb@c~CTe#B>ZX|VrY|)x{bM_-V<@+{f#_!vjFVDiJ
z7)kvKxi9025C;Wue+KXZb2TDvsO$>pixjWs-s2YM<FI`;>4Gr&+eCCk6>!k!p(x$3
zask&0N~{mm+4-Xb_=~zYs#Ecvd-jLmTx_wk_!wU3uybQw@M`r@KO%z6k^+KD0y>e9
z%mivmIx8#HA|8H${@HXCDNvPha&lhES(zGvP8%wYI7j~>jaK~WE#)iqWJXUhRXHwT
zZF`2@!C$2rfor8^wAHK*_7D93c)57CkM<{r?+wHkoa&yw8W#?dqu!f;7mr5Zfk!)S
z?`$5qZr(d%Pbbg06b`-<JYAcR3lO;^=|I?v)iyIgNJG%Lp7HOLYP*S(dvBmhv5P4W
zHXB@y7NLAuyI;w;Z1aX53u#NG>uQuv(`WOkZiX^YUP^P5hVviJ<K)62%yV}v(a1{~
zESQe^{d?jeJpHbB-sM(|)Bkahda@O_4TUw$CeGub{LuD$rvSaeR}<rZiMj(cAQ7A^
zAA~EBV@{daTjkD&xYt%8ORiFrIqY^md2QNcU5TSsiqN{Sq)1Z?r7w}GN(5@&e7{yU
zwQ&CRj5?{c(xVJx{Zra0c@!9MkRHfp^Vo!SI!4|1wDRk_`>=Y`<QK%M&aA4?1ng1q
zD^tSY7GCQk*s3o`!t8-IXAzmkb+TJp)%{%2x%K)0Sx3)-yR+UkIL?jiAu%%Gqh2yP
zl+|M7d8KPO;GGU7dQy6JA8zu`v15y6s%vrHk*mxS-1)0AYey*<G9YMRQv|!W{P116
zsdx6&KLQaxxM=FBaCOA?%KdfUW9%`?dn|^TH=bRv$4G*g_*L64u@G1Q{9-U@3j(wO
z<&h2^kQ?sL`^W^g-Ed{-W8wyBux@p!%!uIR4Lc&@du25^KC@a(r{XFq9m`G^SkB#;
z5(rC6JwJ_fFsCPPM3D?7dDTm=`#7J3*zP`Rn>%x+M~ZFR-&}hSQ~76%)@`3pe756T
z6SL>6tT>+?nx%N|>4da2MD~9sVhoM1!E<WNfm-xo6q(PfNS;JY2-6`;_KzeN4}pf*
z_oPMTCe#Y;2{$$UT1yS84|M-|<r(4<QD6R)b;JUv{QSCE4&Q4G6W*2c8Rwb7o)GrQ
zx*z;R2zzOPI_&-%0pAY~oR>@}Y01(vF{$9#roTdjbp8;c|Cduw)8z?tqHNbW+|NY~
z5DWiepl>s-I=QUDcb4Ps8$rtamV>7B{s<*;C;OFZ=KIy!*Cs7ncNu1Yu)Fi#SEnYd
zOQN^RwZHNh<cBOr#&*db<&@@>H0<@Ca9=atFu!2?#8N9Yx7H9B;3*73Pght@Ul_@b
zMT8Emfz9ZmB_wEa$WU&tP==h2^WXs@-}NZ8e|!b+0hB26+(|wz&!!G0LNn+USlZTQ
zhk5Vov}SqSh{s=xeJWoYptX=0d48$rfk-C~-_;vFAXRxVV8Z<cZ7p!wEu(qV-+Q^+
zCn^EQChX}GkGT|o>{a{S_uMm+dKP=c6ClPy{n?vx1p(BFm6Rz6bCh749;kcwbB4K|
zF<&80-qQr{39O685=%uE<fa;5F<iGloR?JX%l%#P3g>kGG%^zV9aB12$rAN5#VW((
zGqmX6e?(na@xaKl!&Xu`Gs>ndyjEo1_1VdOPVDqo*NPN>vyB_r`PG^4#d>(^nf2y`
z@?BK=Qw}GS+CO;11gTzPPxBVqPuH#Bvkg`W|MhuSg8|`foi{&EF{mO(Wz>%9qc6&2
z%+Kh)qKf;|d`BR`mJ76?RoKlK)61*$%q{kt`%7LValSY@3IEa+eP7?Hq_h<>ZyWKe
z$FY*&T&p7>bpK)8rE%)JI)54r<hVcK954n(+jPO;Nl<(ig+dSj_dTtrCx+)#6-Qao
zgnuou0B~oZDwNKxS+<QDGvlj{uOXk-r-Q$LSZp5*ggF~`@F1*!OZ^|OlSSFS(>!{;
z#1C}tKc^;mI=L?36UQ%xr$=<2yd&_Kig*gNkfg5b%l3yCtEAIKbfWvo68}TJyr84M
zSdsu8z~3uVFVD#kb$)^>J_lB7!R<nJEn1PPV-JIqcZk8s+|&uBbWLN0Na!$U%EjXc
z56PAtvUJwc0G1YI4h_(eWmUtr5SGdV+%s|djKp|z_C~9_Y-P~sQc?ZkG@x;6CbqD!
zuyj7#<H=&@zvF$L`nY$*TtGE17R1pb6&FwyNdP!}yDPBGn2IkhXFe9RF3xGf?on~2
z5BsyW^L~wAv>$uZ9Rtjxs;<2(Af_&FxC#$DV(;!DBqnn_#}y6CNk~Exq#qaWyBNb_
zU^oG`6dOl~8{OA6h#Mg=H?xIrHr4(OS`>sQBrGfau65%*(bYoTdy7?|H2Fm$6)F9l
z;!DeL*Y=bZ>w=`L2E&i9gx_X-&<Zyf`|uG0T3?gl36UtV-m<Ul^@y{oc}?hi4D0K7
z+@R9JSwUek>-=)JTZ~%WolOl4(?4?Y+%YvU_<?eV*Jt{a+t=}IXj~L%W)VF<ht${v
zz3sK^lZeONEED-=UKY~AV0q^8IidaxMsJD|`n6x_ieDbRuR_p?hg3bjwsbY+0x*e{
zR$YEK5Lmd6*mhOdn!jMA&HY;^6xILePwvqtPOCkR%0nh7eh%-1M>q#gXLdgaqsebB
zC+>4M<(|hZK@-mi8UxD=DY^Ks7t8WG@maEBeW5oX&MVdZ5NB}lD<&KklEgcS{q69C
z@g?W`!=E>C6XnA<!&}^etc=&*eLZL2lXqS*;`Do<UOl=cnbo#Y8&b6u)Qbd3h`a25
zzbnIoLAG}fzIjc)ilgEwH@z6n$RLw^_$rAv_`FZ6D}u%hS@!(1ll!%(XuXdx-R(l!
z8(Srn<MZglYhL`PfV?WUx7MUw#J9&txYaNe>s`d|US-q@AzIq~8y06u>f+?aSV3*Y
z{w5-Ef+vQ?r0WMtHuEbl@d)utt^1I#D~>`xPt_lrLjpWb#k9?M&v#8}_u(xZnkIG@
z$fT^TmiZ)>1L1*&7DN$``p<>~3X+ndi7Lrf>CIz@tC6v)%o3=+(;LLQ@?Q-<R;wuj
zgpIa*edP}KVznRFc}~=+d1nzt{W4o^jL(&iivlZC`9oFA2kn|)tNX`S-}OK4NUI_V
zMzmXjW6V^?d7a~WD-Jstghx)k4$)x?z>v;QS1{V2sHe94yO`s?Cku;{onw2Q7Cv=&
z6tg_YN8j-V;SS8w>7{{{Y5tTqY7kVu&h#v0W{aiXoHrk=&C5zU?elu36c0XalTDrO
z9qDCvPi&fk1xWF*8a=-?l%NhL(L`V($3g#`v{V?C6W2oZ-=?JY%>I%4YfWWQ_03V6
z4?p*2oa(v}0@D#*6crDDVds3RS??PyE4Q#`Ye+qMLrb3~4$-m$Mm(9k)t#)5{4=lB
zv)ru>Ig!+j#-&H!Rb9bEm1J)$1+&K~sy3u5Wc&9m*Os8;l2N0|LE_>BC(croc6SP+
zV$8&eZ5x6;Y6$S75lFuZjyln&xVp@C7zduZ2&{@#nnb+gI}l4wMX(V&NFY^`RM%(J
z_I~;C{NCM(g5I5poQzT>4}kkXD)COx<nhOWRiy887<tEFf_R=>S(ID{bQJzEqKo?n
z8W`S%#nPWC>9!k+oLd2>LhNr%+S1x=3yuO@pgfl1J{{vBauC@@6*F6|Wh#Z*Xey;5
z=FYDibpGUs>U|)+8Dr{b0)gd-wHx^^q1@UgBI_L|KY!EjRm63@<*nFadsUFwVolu7
zN5G;e={m?343hku@~dg;)f0ODwi0Gq8W!Pl3At^v_4*c*&9<V>yvu$1asAuC*YWa4
z`*>WzMuGmuCn0xlgI9mrohQADzK0*0cd1a9X-##Do7<ZTz?7xOuA0)9cg@HGeM=KM
zE~0T+l8&6rGzOl<!t_AZ6fO4jgLi*Z{kz(w%>>QImLN>Qmle<I?~py?rII-)kt)E5
z<uFtxzT?kyQzDJ%mcBX@H_d@R-Vk1UBdmJI6c~cKTxlWN)+|>pyV-K4?b{+5;$BP%
zy`OK!oW3u4JPa=iq()sed6=}#EsE%1u2ym^*0^zs!nQ}Rw%w{UITuBhdoW(#cY`xK
zh9m_|4I~Sl6-}sL<#u41e&mTYKZq%p3<}9HMHk|z%{t$_9FBtwBIP%9(R~3lyQaSp
zSdnA=Yx>r&{8n8_1nzPt%tHAD`lNxh&CPut=&ws|;(m=fvub&ERA6gg86e_D`lByz
zcwhT)50)M9Rgc{i!vYH>LO1JxM(E?UhHMVSXRypuyROS`^?-BX#f~b1kX$p6T<NQr
z;$2tjt+hZCA9R1jdy?FhptFz-$^}ncBT}1ymK9|TCqEYg#D!pB-Zk}+Oxwh%e$uJS
zVfdT%yuTc<Ya(m2nHPc~FG;`i4heMGzj&u2G%Ob}6<=@krFlGF4L-LT8of!A9d%d}
zWK-aeNFCm34SvW#GrWB#vg8s-+4m&t-u3Wt<!9+1RO;)=)XEiyj61jZY&^!tG!OOc
zHwh<qE3@^ReOr^bmd;`|<BqMj2Y_GxZz<z7sgd(03)$2Pgr9DW_<ZwXd(vfMTEw-M
zUw^?f6Hc9w+PuE5LXgA6bPVxgBVw)EY>^B}$t=#fky&f|M^h%-n-GcPqJLe>v9;zM
zoKexvx61t8f9JP%;XXAOi1!vFrW-k5X?uFhcY6=vWKbp`39{juW}1F*T7(e~%5s}b
z`@bwitmIpLg9p?KDWQ-fg4TWUcA6e1nnP@N?|EUC9M=-kP_b*ot^F>rs#0#C&Dz?U
z@583dR&=ks00!$s>%+H7xVquTBMa~<*OGg46B1iWrk&9{N=?xn9{1e_xAaEz+kC$g
zB~~WYeDn*?Pv)}$Ni4WnT)m;;%$^T4T~3{STX}~8?yqN6GQmYlGD~w!*T#!?Ibu*T
zdN<PzTes{UCJI_x#TVbbm!%dTAKxr`l*serv-ffK&NfJVI_EG(62*y3q1xfXqo)zJ
z5Z`OxYGON+sGhfzoIg2iKY46-!5tC&qQ31#X4EH9+u13#VZ;z#{KYmIJyO`DgsrjF
zw4VGsXW*s)&iT>;QBmO2Ffq(kuz3qB(h?rWcfQM7v-d=9`V*=qw670&!WzTH4G`I5
ziO-WUn;{HJl_|g+oFtNgX1A(=YOD94Rkv*FHSd`WXafGSgl>0Pj&O6;3N@yTi(CsC
z-o<&@T~aC7$&Lzy6bxB{fQ=p5z~Q-NgWr?y(vu2lRA8QQx);pLU%vbfZj2P5`c*!y
zY)T|Dw<+^YzPIs@8Fd!Fp3IWAv5uZ#cIDH8;QsW}9pmx)FH&p+9_&B+Oj6RJ->41?
zBe|Y;>B*3c{Yb1)5gWe{)mp(B&grK@*zf)2)ms|(`}>PsnX+!7pX<d_z2?G`<$|`y
z1<hs^*=>$4{}TZohiAzAcHCVZl`vMu9fG{+H#s?Pc$H_{3hO!b{#l2)zRY;0KxD_o
zy}AX>7SmS;XtxhlPB7`!CqaU1$FP!Gsx3xRAQjkWeY>J3#JrSelbT@*#hRNQ<paA5
z5f`$aa@rU19_iELs~#!C^1ygJsf2Dq&{43U%MD-ch1TMa#frrf;i;W9dSr17iy98+
zLp+-UZB0h)IQ5Y}9YW{&bI&RsP!>HGhf47&0<L+5SaXpGNWmwxvFH`?JiG4?Suq1y
z8G43_?obIO9b`aLv4zYlb(9*<UafFufB3YJUR96%H^K7nyKca`GTr>dAW_>ToRBZV
zXqd7MK_mn7Md}lebLFn6S9V{iXxm%0<qf~{=&EqO*dB(Qo73i{P5bvP(!f^&AGK{Y
zuB{@(=~--^MBtI2&PEai`#>OXw#`qP=N%$>|1!bIGqooMal)@sg*!ki#h^%4@Z)b!
z%<CHu4QXlR<yU1^3jNXFkU^}VJr^8Q-f!nOnJSa%c*lm(j9t`nZ7w~pmgUd3JSXI8
z?^Tv}7BC|xcYG+Ip_1pvG(URPiYXa?m!r!pb^FfiN(&Ptac6t*8W0N~)?d@~?2E3r
zpWd?B4KVbfkrFa9OPjy`Nv2F*j<av)#rIKE>B%PSWlZ!ai`?ah^OFPR8@>)v$%O51
zjAgy%<+p2}zaYHJdEd*h<DOMdt@+2z{`T-X9o8p<xA2}*$1?iAZe1v7b!a{N`qFZJ
z12{>;eU57>@#f0b?AlD_3VoDZmn;V-WBK?~OUi%$3t-G$1uBVGr2b)WF5p1bm;<-5
zguIA^9fphi(|vD}mJ5XK`Z~&j;tMZz5jEX2sfmxLFzkK_&OM}@M_KuSZ#nxaZQ{oP
zRHQ+;qWw}&wN;?1(RVEG!>@fkJDZBQgQ**7E<*NgPZv~~HnJY~>y?$66(n2H8|R@U
zl#TfPu<kh`_EM&$ytkomv(8((-wv*&f0zI?SDctCGyV<7j=HSE=Py5-yCZ>!?N#Vj
ziiu-~Mm{ZKe}~LDy-mM!FRX3Ojucl0XyHihV~}q0HwK9L+*@P_eU8nJdBZY(KGu0&
z1@Z6r9Hjn@1^c`kw)D%>PygXW98HcPtF^7|M-84bUtD#cjBm&M7i@4d?nf>v<kD)H
zclf=wB_T;nV-E%u{h{Kf!;atPMB_q0{>MFvW>DY#=e_saw{Xl1bXO@*tBp~-^PMm5
z=dNxB3-Z7k3fD==#OCPQc`S5#Vln%>rjZP{A|@NsK>4i<pvIzrF}v`xX^&xBNT&!v
z+fH%L?HUoiLx|h9yIh#vNf#}(|2~=LZ3qv$ss&CK_M<V!TnQdGdC|=O0?9x&zh|F*
zJh}`IZUzj1sv>!nl<qfhnZ=z3dD6UN%1c>xd>%Z)FsRrF{l7l-^z;z_3VAl9udmoI
zJOr2l*n6O!d`8B>J@11FXhpNn6Y<yDeGV|NwfmC8%IKuU<%pyir26{$f|mrad*I(+
z_t8Di_5s59*r8#-+o2|dvRK`Kp=w&h=f6o=d1{_M+)yhzI`@xT20&?he;Pvl-UR;;
z%b*z|&tkiw)9ZQ_gb(|9N*u()?~l^guiHi+?d!`}YHe*Tm6w-~8u91wyECRuq(uwo
zW0ucNC8<ZU_|dl?HWbh1X8<(ltQkRyXJ7)~+8Lz%P4GBKN-PNwNg$9b0?b@?cJ<N0
zdMMWuEbI{r0Qz@yj$Dh5-8Y1GuYWL)V^+77K5=}tdYYMl=4ON}FJK86W6Obo{`gcM
zy}Z_+A2TZxc(N+MVvAfHA<LKb7>>97amfHY{P4q;D20C`xl5-i5OF6YCTanQjhi2d
z$&2zeqeVlP!0rCx&fWB{cQPBGa+JTSsw!27olw6KJP3s%wDjl&R9VL>3>rNcFV+4M
z4Dew6oU4k&L}xX6@}P6TcI^k<)ZWD&28oFWLS|+}5(wmi080Qmx_an?t&j#{F`j{h
zHpK>c=muG*e6{=J2Zy3`-pMunu7JfL0b}()FSdHkgFUpn9_xBw2+lfXiD!%{f@gpw
zbglozv*u;}yfJcvzBP}LSIYbv7oRcjB8dJ!PrPPjLPASqeKr&Sek=Bb3^^aL-v5Ee
z8|c^f@6T99Nl6Lu?0>X5cPql`p0s=s>T4h+Q)mANVlGeFia)dLtQi4|XITGHw`vTP
zoS$(VZ7h@PB#w&<0R_tA^_xG!xWMYdIK?;Sic`PXFtz)H2g2Wd_Ea|=vjDDw@zl}L
zF{%>@tsd#N9KriwONf5+xQ&9AX+YQn!=5#si8rXK0N7Vst-)W9S5?5cV*vX0zB>tG
z{a?X7M;b&FSoGh%68h|Q=;Qfw-(ljv`NMAdubX$E4{#$)ot#c*zpsDlT*H5bt>>#N
z%OL?cEJc;kbh_7L_HWWaGO_RF^#xdr7=dc#U#l|5QpoFrMPcIx0rtRI^X~i9+u0d2
z@aH#YCYXQe(lECB#K*=Sq(<zlu+fQ&EBi0AF`&=qD|kB?r^7-ouHHj;{0nOyxN0%(
z7%%}@<C*>jRTW@YE`qT0%l&|jqn&Zb060r6*OI4XF2~bONIZ-6?Snr18FcFW!NPj~
zj<z6u<(h5O0v&a_#6JFP^fwyre#!M>@&A#B&87(x5p`^k^*>WwFJ}MDC>clxw8GN&
zJuTOexBR*G)_ZB&eq*}|7U2pbz#+ptt_!fB4b?ZcLJa^WUR!mN8=kd%FoQfo?LPKk
z?P0pl18<m5p9TUNPdw4-!YYErkXRCM$D^C*jU6));Ij;`7`Lx5c+J%Bqh;o8`V<r5
zAWEP$`U~$1AD@;!_t?9dKT1~w*eLDm&ynoTFH;~%@6RH=2#7O_{==9>X5#A2ysOss
zQ1p*)*-0C=r#D0^1dIQK*FwFQEna}=qwIlz1AS7(|GVRAlB6bNzVGQv%yB>dFhu=(
z18$XFy~*D-RxHO+VCG6Bfk3VZaR2PX(z~nIeGpR<@|b}cs^nUL@dA>=(P;OnUIuD_
zqvn**Vbc*JJD$8=FT7-o`-hgN5Vjl-z~}SRHFv&82m2O6M~{AMO4XA42VhkI!j??2
z+k?L<1Pn&94oRc;NIrUGpM`~f%3&jWgJgBu1_%6M(f`Y&^lpMJ+Ym(mNo|lt|Mx-f
zf5#K`8DF-#x|%r7Ka1WAA-S9mI^npZG1xKj=NHo_oa_A%*Vy7d&Kzj(uFp0s``UvB
z>ZHK%>6LfdQ$CH|D1`(dB|PGSNd&Bz`M<tuJq3Gv(VlP<6DG$*j2TR52il{_;<C&(
zxZS5JfWzLFSKDdDqKf`3O#GP%D29GugBW1<zIwX;fjty*FUAOyYD_ebNk0%Nc32f4
zStFMyuby>5iY#OD^tfRFq7m!&Bv0w0!2y5bqW|`P<u>zA(FSGAN<ZA*LqEQ4XU2xZ
zgr6CJK{g2)?;M^CyztL_#6IWv=cE`k5iIVb^lrq%ft~jL!&8-bsoFz$o0wP%+u0SQ
zSJ$&Af^iznI10u!5@(AM0SnC2_kb|%+`TvE4Zz}QTNRjq>F5Ur`syLSWa@UGv1nB7
z!jog}fLh+ZK4TS`cD<0cPJ~|m*Xx_<-j`tyP&NnnYSN1#V3OtqnU{l>M~=$DUv)ln
z?tlSBntR5=C4<p@EWB3YI|Q58E|%?%?;zY%;su_)@+w`;k3#eh0%BJ8pP>zMF?|q6
zf8+X(sHr`@-k&4<)z#G%6lczhpB%Gj0l6wF45V)$`hKikfCy-@X;2cRc{|Jia{M_G
zq%3c2=%U89fe3*5DzNx}w4x~L>ml}w9|0CmcXjvD>b0BWf-kgDUZKy)3_$YOlI#1L
zYxfyThZ<n%5#>}1gFr2@1fZDQVQp5KZh7EUT6bU`$!;(+!@^`~=rAeZ1%s4@9#`Mh
z182wf-k4_q6lEoB>KxaT(^bx)JQEV@?mFHer4O@NGopX3ZzdEn_&~z!|5tzBOK)vX
zJuBtA*f_0FjQ;d*VYgZ7v=ffu8sY~gNqcYJ^05z64PJaFSKogw#xNy3$S}vCllY{s
zu0xnswQhs15_?q${r_NG#F^X>kP!#qt#>wIMQcQyWIX@~zf`i=-1w35kvX*clx4*(
zC{P1Tp5#=c0%}=V4N&Oefwj8wmKm--pO=1q>uc0*ISHm&Y{!$Lqw8<XWk3E26lMY}
zk^dKb`HW+8DW=%&8S@N4q^<1plEZz@AfJCWWDC^8>i;=>votVd**9f}OfSCKN;f{Z
zKVw^9Uw>ZWw@^g?Twz}MZ|dYacmT`-OAK6+DJzTO`nF>5<Ib3mlqJBrNAmdV>kHG<
zZ>A2c<nee4O1h$}zSu271gs!J?;{}4zWs;L1$f-R%-=N?s(?D|CrvQYzF+R`K5en_
zi`;Fwe&?(hPy_Hd!%~1^N<10)aQhy*=^?CmSbYM<qiitF@TLZzfEg!vh?gKh&@aYA
zY=AVBF9Uc*a9L?sUn^VeKj$FRgNQ8mkd~()`fnLb%nTZanb(yOCbX$3K;OA(JJ!5T
zFA^*(E29dC*bBwzPkX-*W(mg}J)bHk!2NH~E1<cAIx+j%jqF2dIynNYRWiP1Nz0n|
zyXasu)?GJ9EMX}$2FswD;#3hKz-_9%qnqB_xFr@An8y(dmYsI7o;nk8%1^sD4Hw3s
zQ<qhe$2rhfdttyhXe=~c;OJy@+U@lBCtjy#*O!r80k4awW)F}<eN21;H8ud2K*8$p
zpUdG1MRm(S%P6X9o2zWpAzdZ8OXdys`G@GgdjtH~-$6lf9hr%Sk@2YzS^fOBU9@d)
zdM=xF(i0|3D9D+q6|)9j{g2l`z>*n>udKTN?E=#TpJLSvI`MMmBMs!tInCx^@qZ}A
zTH-AJXB&WG8}Q7&yT~^>2ylCPV+}lpf?zzQSeuqg(PxYzW+v*-Mzq2T>;Ps?b<y&p
z;ZGk=92UEn)Bs%V*ifU;Z|``T>O;qq?Bv)BgJvh%D-Paj!wzpvB<AVx0Lf~JUeoi!
z$0wM$rD(H^Sq4C9Uw5QraeQ;I;U8W(+)YZ$6W}D7V`n|y(7zvx{-1cciSBv|26AZ<
z&mfri7ecU~<Z7}sqNci%j$MrCe}?XV0IF{rZj0lVT!7&*gRA`vGvsuV2Zf+FLQlPs
z+Wn7b|BSat0)c!Yz<u}K4O^+TxdnE^%p`*txn_X=SH$-F+dH@W(MwFotPa@oEEzCr
zXXd3Cq5>wP#x9t94>Z#6?ps4j&Dn9rD>;|$SQ~P3`~<Ps0McBiCG=fgsbg+;OpcCd
z<5EPi{X}wlDhC_>L3iEu5-i#GqY<TvVwc6IX3>9Rqo028$DJ8xo9yn#vHlBjR?6;w
zM;$(!>L!8dO%DFUj8YilLoY<1lu7?T#NKBDdkL6t+1*P!4jQ{QvA;9x{|gak6R#(-
z6fgp8oYvCTfwcj^3~PaE*d5R{7ySlaMTL;GE(oKxb5E+l8b-{h#1g9k3QhH>)h*rD
z;jq(_FRY@c-wBaibNpbewRg^u=qEp$<BM2q;co<9J#As~wXt$MCK-Tm^Lrnc?at3o
zFsU=L2-~}xl=fF3;?6|GviQX4T>o?XZrXX!m-Z$mNW98lp>{r=EuXw%38G>pNB={Q
zV&6vp-njdpQM1W&?@Nm$F2Y6VbwvO31&l?3tY#7Jf0;lO*K<LDnad!?mbc*zK#}+u
zgZ?3TjzDpF99OcfoKY8qQQO>UZdx?Y-Cr8309X}J3_*eVD~+9)DuC#Bw?9Vp!KH}5
zG!aYyq><Wt>oezJpA7=xC{`sY;h*3U0~}Ny$}W^5j7IW8sasC<P?S|Ji_Q8o$>y{U
ziulKRqt<63vCE$en_1C6yP~nbf1!$`d8S-a;-=+GF^H)&RqIu}<%IU%w;k7*$<g{k
zavn9~u>awKAnK3M6DwiBnIf_HU%3CJ07sl2G6FVOr>|P4TO5c9kq4?X3lmzc&kXr7
znG49!1vx69r@~GrFM)(2o_GSnOh7RvRt4-k*i1Lx^AbgC&&4Y+3ClO$1E8t~ffl+r
z{PG!R79(Dn>OAHcfJlq;61e@HFnIP4W52HV;>*_#A>6MHQP%&pwgl+vTX$s?HM7f~
z9oDRcDw1aL|3WPOGky9LP**1KNu4U{N4$j1p#40<(K?6@j1k;r-1pV{Xw#0~lus>G
zHA~70iwi}C05kH3>YHiHhdUsRLZ9Htg&i(;&N<j0f|a@%6twP_)J0R?3M1JIP8x6r
z<b13KDAvTPfT#ZTHvMazkK{?GV!X-+-btXw5BamoR#<mR!Joh_5K*7TRvJ?bfYPy{
zLblqz&$|6YLJNWx?jfc1X?#7iy(aUAhIb+T^4`6)eSdnZe|GsRFE3B3Q|9tVG6$n_
z9E|_$s(nJzlbPuIv7SM&5e$Gf`%lU<Qiohoi2ql<*GZiz7XM*JONjqR>Vu5W=dk#^
z4~y2UdKXNwYLSkH$-%_jkOB;{pUDG8-0rnsw#C64VA1?inm1*Dez757F)R*b^r}1r
zv4_%)fBHK$hmV2k1(TMHE|^9o@i`r++AeQ(iERO_HszF1RJmApdQ9w&DFy)4=`zVv
za=4+}U&m|tHT;9s|6A)i=#GCLO4|_F4UK32g|2UNf~!{D|J2!kGLZ)Z;Dz`<!n1}^
zYBE~qL=Ct@zO*KF@E?x-FU0?8o29sz2Lx<T>%FmR0~QDBiS=&~A*tlZ7$cB}^80C1
z5<$wgXjTJM)!5+<2=}>oV&Y$n-T+$tZIHU`+S@?4Klmz1lRu52pT{M$Kxu;swz^%d
z?Bp$bQ?S<4B1NxOp1hzm`Fb%QkJ4zKf5^NC*G$D~f8V8KpKzYN1{z@a_cA^r_VbXq
zt$BOG^g~$v`>~2ty2Ql4(0$Q4_|Ke~Q)t258R!s9{JF*Jl7jUNc%{TV;ioG({jNdh
zWb9kp1GF;D;y-L`DUv{7xDnu`YWM7Kpxt{9fI6UIvLwI(4;m-;qa4N325mks?}2`O
zA-n<fshAcA($`ztcQ`pf&`b2rwkXMUr)0of2dr*aD=X7BwoU*ojFxs?o+)oJT^}<H
zfXnUrCT9Or6%ez;1cKK30#pF-7gxE&#H+a+@d7kF^I!czSK8ZI^v}OUbwt`*M&%-h
z|6Pj3e>_!K{3n^8Va!5^wI4W$x{W|{$<R3&`?ofBQFDj!B1`O}Eu#O8N;4XF4`p}2
zj;<ao4g}^{?HXvjGK>ISvq6lwA)8DY+Puk9(r1Gj;JBm8sk$s4_zby=ZE>LF7nGq3
z@CCwj(`^rt-*Yla%zPz;W7Ywy+f6RV^f54m!NIqcF%%qV1V(hz@aCKmy8oGQ>${vn
z9H2&**w5b!1HG<QApQdlUza26T^V}+oxA(!HxKMfdoL5Bnwmt8JM9glc#-36pMKI(
z)PN-<ECJ9Zp7nF=|7=!E)ZK1sH=E9hPrUNIj+EmoNB?8&MG^>%1OgV!{NF@WK*bO5
z7}Y*TTO24u8_cH75BWtDF!oWJJkdcXEE<Rk7z%}oE-GL$6b`$M)^6BF4?VS(r0EyM
z8Lv3FdB!*j20(Vu%&;x+t>k(X>+zUi0HTWWeR7x7Dd8jrfDJ=h|Aj`uMtVtvE!QuG
zVy?YoPsU|_nfMp7)xY-oygcaSi4(B+4`wY!*8hxQFBkxIaMSL}!#0P`$yMORf1Z6S
zwf>*2{|nvTA`j?^A_@cnwl(3!fesvMfPj&QQ;5)<(-2`CKI#dx(RhWmc0cU(*B->%
z7+sWY7W%~TmHkg<$z-uD4%A<H-Hz32qr3j{I34VqKyuYGe1Z^OSeGH6yHGJp6uAOY
z0DR=)PesoFC@t$2NV4Nn!paQ^iD&%1AHeNzJ&0GHX8#U}UVOWa9zw|9bcu;jp<DfH
z^$&q*TDoXHRZXZ>$1d%BY>Va*LfB*<3;^>H;3RQON_>=wBVPPxEz~XtTa0~}*)>au
z|4jfXvg8c`3));;dl$X8VGF!dz@f6}-wHc1_Z;lU$D|>)d-Ije@E|M>bmsBZ<b)bc
zOKb;FsDa6}I%e9k6y{KK2mR^Z$A~7K5Byomk*v$iREoLlECsOGrHMh=|8;YB6n3tG
zmQdLBOj*0A#r7>M_>&a!7afuP)?1&)eQXne;~^z*eOUCv2e-5TxpNPNRb7yAflP#W
z_FpWsQ0_b@9)C3K``|j6j1!Chz3_7mcjPVs$S@`uqnP?ENB;{Vys1$Vi~ks*BF+sr
z0+2w`TO1WI80deL<XHp;0BQi^rrMux=sV^+81o~uusG0)qrjlVQy>s1%BX-^{k5$F
zuD_2z_ZF?$+(Pn{b1?oV+k$C1bKL4-h7`amN3T#`IekWsr4`I=Ma=-Hvww>Xv;U-z
z%`^UPbV%<<Lzw;Rzc`8k*L)uq`dO2~@Q*|NvKv~V8~$+%<T_TCm%{)5a2#+`;CI$1
z9QOf3btaPq6O{;^zQCOKS^OVH^uH(HXiZs$So|j?G~&WAB4C5f$vf*mq>i@sxScU5
zt$QYBqT1p>`F?nA9gO?C&26QV7ID2|X{@LL*dWjkDexce_#1^vmct!$9>%RCx}d$Z
z*=-7#W3~WNT{sf{p4p-bHD6IP08xwOTZ0$;VM>8TYg(TJ=KKY-NycBC7oKTo@Y8Sp
zvOjHM9DJs#s;Vf6KfegaGhck<JeoKK`pQ8PGvFBU!hGTba6fDum?0TMm*FP!m-!of
zu&bB0?dvnVi6t%~`kx^*;^Z(Rz}^5&Exb4oY-ONlkEsEw;0?fPfFTm0{<`O>gF$+B
z{>h1p1F;&Q7$z+JP^8##*sZkY-L3S*^Q%aj@oD7ZaVtw2U>0Ub0c1<`bKWAi1t?ku
zz~8lDo+Q~XHMIQieiy#~dqB7{SmLS;Df1WSh=0HT`vKaA75`EtCP3`-&qhJT(wR7<
z?($=gA`2|%S#_C^nCScVsxE*j-6u0cmr&%84)6`$-rPlA{~%69EtZ+DVlcWK5(eVt
zf<%D(J}<7b>K#M{)ZCD<*qG#jWNk>cGkNM@`eLBITrk5!N6sEt9Ebw~u}46$s4deq
z0tw^qo%cURo&HHARUZrb4}(B6NyErYUgXiF01jK=3X``KWVWJZ033?^W%&IM*8PXU
z&GKr0$@=UB__eRi+w_Uu{<b0J{M}D9q|L~)&th7BmI=Pw<)o9L|BqS!C%+yf04)Ab
zSo{Zh%tM!4U=GKzhe>#-65z#u(u@B^^uHV+7PsUD0agR7e)oOy_jH4hqDWSoF$0j(
z;y_v_8$#8zB6zDy92Kyn(hhgP0W|;{0WuRX77|AY+_9&D{{GMBNSb;f@aO1<#*>EJ
z$FexMFscM6aJld4Gp83Tc16hm`0C%C4qMF22q9q;63_V6+5bL+*?)>2kx+oqfkeN#
zZ$Gtnr{*M!&G3)kG87Kc5es<npUK7yKr}!~FJ?5F6h(v22%@~6(;mdzSYq-2p(a0V
z*xsX^8ni7Y=4(*p#fhRvfX9G+2b<`FtvjLnXEgxECOhJQIA&nqj2d8YyU!XFvqeA(
zaM7uWivtyVR6spe9C`IG|9GD2n<1v3cm@;cfy-tw8n`3AH~2<X3gDzkR%h^QgR&RN
ziK1ix>~_oNC0EJB#HfE@yZdMVdi1pqr$1+IU$#rM22tn!k-_bc4gc5zy;wy5{PsLP
z9k=9ga;T9Clki~izyA=71e$OGxH5#pnzV0};z2eE!GF4_Ed>+C9lqG`A67U;;UkU!
z+X3|Uc@dNb?ttoy6K&ao#dq9njFzf88QOiS+w|viDFO_@(R0gaMxCR-B#sAAtcwHn
zzeIdTbqj3jp!@#%I1w`dj!7{lAmw*RE<rms0WPqVrO20*r%x@8sBhY<#kWPr04N9F
zsg|s^uM@)8CZzt^|6b565U_svPC~A%4x%vhxZ(bN<VzFppY_hgWca56V28oXDJvGo
z#;Rm>35Wk>_rD0wxQDBWnCM(uWnsAVVw%N&*!o|H|2440cC-+%LjU~c>Wvik_Qmw+
znE6Yk=wrM}V1LS@-S^*Pu%i`Ya4FL%p1Ib7`0LdG#lARD@;lowE<gO#tF&`hGs#oW
z136&8%p?t1bNQJ@$PQ^%*b)7*nbHd_&v1?I!}gw0hvPGn!!<`q2>Xj!YJ_$FFX!#K
zGTi=NeW!z-Ta{Yx%nxJYUrdI7T<0)?|ID2=jSibP1092#KvHApNLsxc<BSyFk*~zh
z(SGL2WL~7RD@3ni`QKDYEdG-U8F79j5#VuP+m3y-ci#cb{^R}1Q3q83)NHC6AgP~a
zTRE-k46zvPvFEOUr-Ckxg{Xkq>sTO>>FoB>UH3miR0(6iv~Gbp0;}D|QUE#nHRY`n
z1_CT-6)Es-Q855Y{kv|-BE#xZBU<q<z%%|Xw){8J{pa=tA~5jy?Slu>2K`}w|6*9|
zCmDe-!v8KlaxRs!%VLrsMYZ@3^5Q>G0pw-&uk{k%W}i6v-<wdwG`6K*{3rX8#T^2H
z{35_=fKDt9^zMca!2qCaHUzX_WlB~97=;Bk^Z224pVUvl%=M%t6;x3&;3+j0q5|q)
z*p4O6pL=-?eel5!lBZoTV9%sx$`M$D+f*rljgAQRS@4kJN=3y0MC_Kc$mUoIpB132
z5fse+IqF~Mn|VW?XaCP4;LOYG+ESLuE;Bs)XXBq@OKh=x#>t48t*T0rYR~7q2>l!G
z!u6rNo7Pj3%FpJIi@+HA+WHRSXlq7ETl}Y(>@SSoL!28M2=KV@`l=0B90)GMsyhHL
z4g^n|Y{HRiUB|e|=LIMQ-T+f3IcfRPW&P!ig~fsTUj{oI9H^%+Nca5>wg6=diAs+E
zt>B47mcW|)9<mg@QhE4dy}n0Zor2sS$_PKAFQi;^4QQ?WbqTtigu!0b{li+_2c5NM
zu|9;Fai0ys<?O}>_ajDj>VjD8T#SKdc<J9sb=7p#;j_^h@UqE?MFPE;!DQP>)N)Mr
zl;mgXk99@xxA1wx^z<9488QA2W5It}4}sV(UIbVTuxZN<YHewaw@dUV_jGs$u#H%n
z0Y%sDN8;_7pXSAZ&N+TS4Z!2-SW*Kpj&_HQUU+>yeX#jMNCDU_5Qdp%#<ncKhXRSQ
z#YV@4%bQLdiSL)MXA}(s5c<|9my*?S+Muw%2=t(Iz79OnbgnGWVv+OnZ?)1}n=k`T
zk$Bc$U0q$2gollNmK-&oYOw;~;C_JS5Y!g`G21k<>?uZ=rYM5H#rmy1w7<#NN14Ba
zSp3HbP;qXw5KyB6wsz3E4Id1+19C`Ub#b61cfb_we#GhyHNfe|Rg#?-F^Z?&UPMt%
zA#Kz06w_9f0`vxAQUDJoJ>^R<?y&^fAPwPrFl3m2S|us^9|k2C>?yOO{HVWxOt!B`
zPN$34weC+m<L})Dku`opnf=E<Jl6Z6FlPTZ{q0~{qfwsu7fZbVeyrj<Of*kk4$EW<
zOHu|pzIvI(|Gr)6qyMQHhtN~B3YjSa)noC0AjRT8BKn^Orq~t=0xXS+z{qy>Ixqkc
z7B|QGnB;*PfG}Q}Y4;=bGB947H_byITR335#t{v9fuOM@RqK}mZ2ABm0q0`uD*?j%
zA>teDo5arK{ukqvY*Ee*ym0D~xfe3BcNPT$;B8wwO}5%DLiCzMbeQexd<)-lpra*b
zNOPop^mseqoV?)AD{DJx6++IYN=!gm_g{>O_2`uqWpwP~!{Y5<_wwos;aFY#hjC6~
z4)Qf}X}D(qkj4LzK$M=!ApYm?A(B9#kPxuh5EXFU`_$9X6*r^7q{WTdr>rA91yErg
z59}}kTwxFua4azZ{ZfF3p1^mQK~w>+fC!`j$;00ezX?ZKl<ZQ8B!#~+#G*#*_M#X)
z9pt!3a(NK=M;FnFXRH4Gh*tMLXqC+zU>fmB@!_M;<NV)4=`H`+>c3cn&V;}~9SPn4
zWOebMWCG6=mlywmJw?B9U<Sa<p&sjKT2UtN;pl%K?d_uv(=7fYqW_r$Q)C-a1ehs3
z)YwX!w;+^ue^fw3-gAKoFclSW1gi@*z^6{(<;w@2Io8ww{AMf#c=3%5v~9~)EEoI<
ze3xNj#(<|qRz9P={c-463qKV+1E47Hx}jJ563oDp&_vZcS3&jPjq|$Jo0QA!#FZ`o
z-(25CufE%!TtfdbcWjROSFA|_PRo}aNmc~TVc|(aQpNxKVFLhzJ9RWj&XABh^MOY2
zb1lXy)9V{Lsn@Gx`gBia@jw5@lD<;+dSbVT5#ZUg*XO6T>k$=D^|M7MkTFT|K=PJu
ztQw7Xh8p0AStVE;2=0pU<c9|Xs{+PSVktmZkDvbb=+pQP(_*m!INnK~lNuh_Ce4WS
z`97KFqKBopf@c7z-Ex9rbuLa6|D)Q$7E-#`0hAQ8e~kc{g$)eGt&beUV^UKrp8Xdq
z(P4t`aXaax<%<lg|Kso6w;k8KKr9VIl@3o0^VATgyF1~Ug6NCSzM0zkpKUNi^uGki
z#6bZez^=A$tlCH+7}crbbi@RZO5lbj6_%G6i>*s5ZM5R3@_zIph!et#1C1p$0Kc5w
zZbMvvwX|=?PLd~oJkb`Q|Lya%BSkOUQUor61<wFPCHX6G{gV@BdOTb0UJqlnR&*%c
zE96LkWW<`^1Z(r>SEnX8#XkEF!TNu}-03uX#*{b%kOUU|W0gL=_}^qlNGitUU1_ti
zC3QoypWfNZ(jDU@#Q(;)h_i)(0FM`Y_Se&{z579EFh;Q?fTIFBXBM6s07AA4PpV1)
zZY(Vhq`eqN2W;)=qeq{70Wksa9V!tEC7NVcre)4$8y^c5EK(<1q-C?poA7|bPCDvY
zcokJT*Ugq>+s6}U|8ZS4i~pJU=Ys&DVchj(J@xvG#m$UNG0*<F{>(rfxAX{ds*C?H
zXu8A<RiF`4mHI@6N|z;JHy@ZM6qs}XhV1nXSp28cSVSil|4G7292Oh`%*1wd_R#9J
zV5+gN4ph7}FdGBr$z^%SFRk@sr~!^yP)<{82BZ@#0T?Tb1L<*M1I;I2SVb*|4v{qR
zbTDTo;{xal(eG;*>V{O7w!$gRX_u5Q>a!N&enB$;q}b1soUR%LBB}nw?tXo6`-1_X
z>Q>W#A-5eFKCt`td+8sqHm5A0*k}LzVl0w8`D1YZQ)B-py(%*RZ2ccjv-poeLr*Ft
ze}@>5UU;W1rI9X+|E+i*kpu#Ti~z4n_r{t{2&;`a7Hn6;YJgJsp^v5-z@Q&<RKU84
zPC8-nfEs{_KidL~H8lW#ll_NU>G>C4A*o_6;sRhy%vK6ufMH@gL<Sg?OH$<gz9-L`
zoOrFUjtZ6mP?RlpB`SSkkhL0%(mLJ-iaMrXD44?9{Gk_{AR02BZF14<_g}2Kf380-
z{xfU(BszTl40R&H=MoYd!}P&#S+7pv3>h1GLMeGU;Bm62Crq!d>r7c5i~mIu2oyR3
zY@@Pe+it3_Z$#JPp%!D86ZF6aRY1PRFS8(Mec2$tY7mTm_sQk(REQ^*7>-3X0Kc9E
zlZQv1dY$}TaMP?iJ!YV(y?Cmvh97TJCM^@bG$t|spS|}0k|fEl13j}cOLVEOs@7Ug
z>z?k>(<63PU<I()0|5hRXC%nO(LmhM?09F!Q#9Jy?H!GP+1=Tl@dOEjQ5ZoIAP9iK
zs#$^E9j!&H>F$}<TC36`D>LrBi10{{NcYHy$jGe9oc!Hc5#j#*yZa9h_wV1of5+1D
z+I;5>j13kqELs6z{=w9f7<CW&)c>5R;+%Sm8UQ-gs1Z2cjozOV|LS{Ce;a@ja5G!}
zvsyg-=kZ5(h{0te=EHwxE&>w_k!?7%p_6KTfW8>s#Nj{J@6Kv7V5ds&e{E=UV6k(6
z%K-Q8kBX0uz_m6e8unx+2jBa)SHP4eFkwuH^DSe*dhy_pSlV0eSLqhGq&i*;%d3gv
z^4OYr;>;EC>g#Wd%<wMfi~!yC%t-tTLBcD~b`<{x-PkWy_AK6lWpM0oXIGcc_>TkB
z*hdhaVI0P(VvRsovp;z2o;ZDlmhXDtY_nPS{mUBV(BNM@1XULWs334jW$G*pDmmj`
z1kC~8(;G(~h+@UIPp9Bg{qJuV!AiBC+Z<SU4sh~N!~pundq?qomABPp`mqxyg$azd
zh9TpT7T*oDAONgi(=DFa+wY-qD_|=w12`4Ti2wNgpTjK!mSvW|gdn%?i^RW3NSJx?
znBdGag=b#d=P`AW-7JD0zmg-PSKc1Rp7meG)K!VZfIkmE)!h208^{#QsJA6-HTxGK
zvwzaz?7x}U!Fc%3%H_l2G5G)2AN~U#+lT)^J-NU@nQjjI{{P}N^KJ~z{%MoZhBgP9
zfdjO?dGEs$;^DpfSO(yv1>alGMvVW^1Q@McV%99;coasJ%K#nFzJ2wn@@@bM*)#@h
zMaaPz@ZFC;6DN)x7nx=Ip_SQG#TFnwlO4~1qBoPB`_;wD!$sMX_V(mo$aHpZ^$7sd
z_>bq*ryu~(@z49m$HZGl&1=n^Z8rO1GgSW{*t=aUTM5ThY{Ncqg{mnS0NMwb`yw0u
zkbyzw;nU;d!VP_=!-2oO{jcG#rJZ379N;p*Z5$4C>=b-#NUwl-dIf|5nojK;HLv*N
zk%6*82!?B4d3s3Xxm@8wD|!WF)ojN=I3(yVUj7;03zif|UXWE*t_p9I&{(&$1rXM+
zTHpKSMY(RdC<TB_w)3xvTt49C4Kvh-?|}Cy%~a9G|M17RaL|mI-qNK@n|k)ohRTNi
z!ZVM;Accqj1e&g={>O|vXaE>MZO9`!%hx`BC}yCU(E$xHxdpJT{?~D*9kv)bK<(l5
z%q+G8!pK%yn`b*jrgt}r8?*aOVLWnpWFUmkZrl1L;_)4Hlj{Hv2I5jcGiyO*U4mC`
z3H<5nN5s8rS44K%<1o;Kai%SlN&W;=#DAtSAnZSO&38R~Hh${*r-<1C>t7%X2mfTU
z9bc+6{<{G`^^l@dn5n`^gSd8WTKws&cZ?P4?Ci9y|BVPu5W#`6uWyNX`XCHlN@c0u
zSM<p<X!P6xVTku3*YAP3mvH#ccV2^YCj(F$)As&nU`{)D(Q?4{3i!@pF*82y45Zi&
zDEi<QILkfgRX~nKyw(KO2~lO;GmsZA99Zh*L?b{N1Gb_7ki(Y1i&yW6pTCY>WxdOB
zND%z?@ZHo1DyKQ=f*0rx^u@ncBiXtnUvvUMG1K*YrmJVAg|+K4pqS%us4)+9eHt@W
zsG5KB?tO8?U}?^L>G+3x&6|0)Ifui49^Ji7tlNOCN4gHAIE}-UV4#%3l1lkqCA*{g
z|169#Ph6NZ65w{sW_};WinSwJngd+Ax_s@H`0UJu@-jdt1{~Wfpl18AI)c>1nFNGz
zr0us}9Pv#DxE-)nzq>4U75(|kZ;8@0TsALz2JeU34_#*&{vtv-O=G}J=^NuOe*-Ul
zalxV!0J53vuQ>yf@)GE#);9i2r?^F^{r~k3%v=9B%cKC%?2VqY>ZcytCGtypQI|l&
zqxyg53apbCiTd9@{AW~*PU>BAQvFY@OtZg}z*}fPehxT5JAkpV3Gx0%^tIuBh#g%p
zJfj_e%K%>GuO^;IB9d?fVrmkotoLs16FWBacnP@^pis~VDjr7j-f&Ccv6JV;F&YC7
zY{JZMPkE`PO0`tBg`sj8pd**r)YmZu31e|VIwNXIb+YaqUys56Ie4xqQ{+H3ecl<Y
zQkbdI`0qm)|Gjq-TL}%onPw{tHr*IBzxdo^XwbTf;??u;pCV`63#<NT>3I0h53wcF
z1nt9rOq^+lHv<Q#O?-o10clmw&&~D<i0y#%3K(Oo*4H)aP^6?bB%#WG>2O{=_h@+;
zfL;Mx@o*q=gG(FZQ*+|`KYks$`Yf~n&*7@sF0Emm5~RO%d2CO<(A^eAY0)hMEGhw@
zSSmpM-?hrG{>Rrc1~s)c!`G!}bevF-_*1z3H5r<*K@1L-U1G)|y_j$dQ2#%&ZN1pM
zX{~<!pIVjiBVcKGW3OwS+z$jSho$tac<UIJcnm<HtPO1rG%E+_g7(De3*zFXEBNHt
zk3lN$T7}<gTNsF6FT)64jgU;{!;^u$0#LMH#WH{jt?Ct!b)**H)whp{vD?>0W)QX+
zJ?rsKlu0OX0vu9V<G(i{(ikvPd}*;Q11u^5Ae+kv)c^QUic?spJ`N_=UQ`Y=<2YdE
zdm+cn(&<mLJN{vdq$L03ft_N>&{B>1AA`Pq_|J`0_{#hugXROF_rKS1_|F}~;Xj-`
z@tw4x&4Fg+0PO(oKNu4q9sQJ6;TTac%I5mrWq_!LXPS>E3PX&^WJG`n)~pXa(l1uw
zm|zJs1Z>5_fmlB}N;`k~mU!pA!x;Rb`LK-vt=b2D$vj+XV2N{QHufyCWq{g8Ri%=(
z+*;Q^+)%0h$3R6db+Z_#Qkbc7pm`PB%+6djd;a6ve=9he;TD&do_`!IkF$*ckeA$1
zF+U2vHlPW}euh^apu_p;2ltJdP+I>tyFsR|+U>B<83&*Xw!H#kTOB?;{P02a?Za((
zpsnOcwU4JVg&kr{W{6ONc{tD-9uD+qSrf{^pIZW3aW{a&!HoEeAHD&bC>($^{DiRb
zbkw9>J9W?%emMc*f4L0cbhYz~Y8jvby?;1kyx5+u$Mx!eNM(WsD4K!HOC0eAFX0b=
zbW<3-%-VxYE2x_3{Aa_uRbuz{P3U7Ze4~1699oqWgeoKFBYq&%%1pxW?=RnfU?kN(
z{Kv?ec0?0#fI{rYM^1@*ckj7_0o>5i16_U?wNM9}h#ya|?#5(>2vab_F*1DZsUa^1
z8sE0^GC&8k0Ea(0C$3z$h!Y#vK`^7|)PQEjz%P$U)o!>9AWB~tfBA()vm0R12moAm
za=r>OiGYz|ehdfyoWgzW#pK@q>o;b^>qjx`H2?>iR&X@K)Bg_c+b)JyjQIN%yWZgC
z9A?`y7w}X&Uwy1h@PSY(^Y+m(apg8`JSu_O7-|68(B?q1bAY=6Zryz-K0b;*4Fit7
zHkXIWxo0!(x#lcCpcplkNqF^vA;J*sOUegm<-YvHkm&6$_Yo8TTJdloR<{HF%#Aw_
z#oO<Fh=-iWjy#P}j6qTPMIu!|E(3Ju1uU}{2bACL0+z=bJ2jFK+2?R_M!6KWm%4Kp
ztgu}#jhQO;ng9I5`{Mc?{V8+InCkylfE>0lzH|s}EDJvd!3x>xfAG~-|D%D|3blS9
zm|47b_yN2=SCrH)S^MyxT3=8*{bJz&)#tNN|G)jgG1xY_vrFoQ`(k<pG=6i22t%-u
zFTm&FKpWQdh-dee`$TR9Y~^Ku4p{%c{PPc>aK;jGKa2splNxC1IcqNi<j@E#>lgJH
zjSpQE0>J#-^ubI%zsdV3Y(AhB()o{1HC6+I(4hbQU*0wn;6C$KFf^ltzI@pbj{h|r
z{zHCFP^-cYD4_rlw?i>-J%c^bbJIofy*JI<|2X?^1)B^53);b-GY-%z;M?yV6Vu~k
zuEG<`0KGdPtW(Ry56b|?Z_W^52sTi!nCWt`%5`;!FKN628fi3n1dRcYpSmbce|iQ>
zGt1x?U@!QhOiI(JAG%%3Dt`IqkH6ZR2Dw^kED8Z2o6Y?KHr{8-PF^rD&5x(5{=Wb(
zbMK!RGxDpyzu$H<TP}kUbx}uf```ZETgA%ND>eNI`3kRI_Oc38ka0nFDsj{K@FfvT
z(EH!9GZW&B;W%c_nA(T`_?XvzXmSovn7wx6jyUltv~bYW*#k`HGAsjZ!9AA&6excx
zN+53y5r*JE;__oPd@KX}(sLtFkC!J3E$tN$^}PFF0_Qe-?5vK$7?6H^(}WVV+~DW-
z;o>B$KNlVrTmZ1FGhOKDzvNf{<HMM~4D~-|>}go3W1xBch<TeCKgw1x{$q1uU0!(l
zQ5Y6?LDDRLxOP*smsQR~2*8XxDqpL05|P@lfe7|Szj<s_Ootr)(+UomBC)8A^ts>w
z?EuCnryZ|=av<-3GoU_b0r<TdK9!J&a#R!!8tH2iW3bw`wnrS;R-UZ3^5H<_0JQ)=
z_}K@rk%DXB-i_F%xdHqQ2xb~qMGL~#LT(4li%zV>elc2_`eH4(03hx>*oCR!9^cWw
zR87-LJuT~hF#S({ddJ8~s{XkI(Co8+mft@7=keW6r=U|QPGTQ2oB)NY|KoHLMy`ev
zp=eT?DT+UT^{$ZuXaDWPe~j#DM>Hu1XruG?2cKY&nMMupC1BYu)4K<^!P#cWHxv?8
z!In6<>@%qU$B#y9O9u1e#RKK-fJN9Yw5nG?@{RB2+=Xl6%-IVf(>)+EOCNRkQNh%x
z0WR}xp1Nu5RfW>mt#7Aog&nm_WxNF!0E!)5Ph@(!dn|ke9u#MA@*mf!YcC$H|1Vyd
z79XB6TmMu2-wOL%ss7)yW3$+}(d7LPhyP5TKu4od|HtYiyf>w}k%Tl+N)WxFUA#Um
zj-8uOLjAXG^}nAV?Wfk@0JU`IFI^LN?>#`jgF11Y+4c&E?Pp=T0pzE}Yc+_2OIq%r
zUomHZ5b&)Ru$xGMiHV7(pDZcW@!e8GbLZitID7;X&@7fI2cfCwxec+vWxgErgYS!4
z03r6w9(-v_EV6Y#u6=~9u~4wQ{JL*8Y9CT_DK+Om0_y+w;rIX61NsuE1b&PhXj%oH
zd18;~?9(0o!(|mXRGNb(M5_Peb`nM=B_M?NLZ?g*$Mxzps{UI+D`R9?JK}T80S@{T
z6Vu}Ab?k7$GMH`X+yNuN-ffOBpmHYerzP=K8m4=1&}SkAD3r(_>;U#}=@Z+r6d-|z
z1GTDGK-MvbF~QyqFb56Il68)+hN{Z|lJU68TgkA%wFrasY-eU9(^bG$t%ZdJ6#%TU
z_eQKt=3s^Te-Z{VY5D%g%lNaOo7MlcGH;c2=B}<zd;MSQ{SPvyH3juQj4Qph#+urm
zY~{R01SN@uV@H4duG#qy-%DHlACa$Zw5H;KvmLM?#>T1rk{<=M0DVw5a{?rTqJCPj
z@PRA`{vg-nps&#5n)UFqym)4BzlYt*hXb*a?03$bzbdX?#<>lhm>dorba>`*K;Ec~
zLYRD%(N(V44~WU{!oq?I0P`~)yI^&(!MFVnl9n~e?SHiwjT7Db_hzB~H(UR=%Iu%&
z|Lt4XiyhlGVnV?$Sp~FAuKV*)C7t?TMGd`|Eu7bgph?2_a_9c6c<qS!@Sj$BFA=%a
zM*Ey`z*%zScPhUn*a7rl2_T0Z0a3O-YrZQp3xO;LeVLs^mV-W@B~2M;2QjS>e<iRC
z(9&K3p_RFI>!CPu>?EWCbea9wQf)5-NCvrA^-<wjq+1A99U1G%n}4vd+W~7IWh2#A
zkCe@Iy^!hb%6Z0j9Gqrh6vl&U(hvY}#{Byy#>Iu}dM|U7^jc-0;r{=Fd$;58pF#Uu
zFMrKwrR3`z`FcG8UlX))V-hDKlh24Z;gRw70~#Y%0$rxk0Z<#-9B5Sz<ntY(zZYtM
zei8%@(0Lf!E!l*7{j!)hK+80CLen20RU7oB{82%V0rH1isH~sdH6WHREgLCP0H8r&
zs{)sX|MK;ZP<JdHFTpAG+zn8|dy#CZ;8{FQP_u$%mTki;r*_6mnJ)H%3IJ$-U+@dN
zC=OlJ&ff=f(ka?c-!mUF!$GE1)c-jg{_~|59!CQu-vX_ZyrlL2JZ9XH_{#M17qP)f
z^gz~SI!Xi@|0^Foa0Qi0`fcxjl{{&Ov<?S~*j_gRL4E6H80&i8Pw{>5+gt)W08Tq4
z7{4otpk9F-XV6zZN$q#)lICEwc6FC{PVoxJWdPa&w1V-p%0YQg*T5$~yClZ$-p1w(
z2x_)dARogdYN9J`-eCvOjfvaSi3p^WD4kI@L1C<k6RR*Y-Q`pNbI`H9)FmLONisiM
z6t5gMtC?HH$2=wRb*op1y*szyJEmA40IP^2m9eWLbns{6mcKxH)1yS^)d$81+qP(W
zq9|T|8$zA|sFi8ej>S;rcJSwj19YkTi(h$G42}ej>gH~MZp<_(0LV|MDqnz@c+e;D
z>KU<E8Cb`E^@*ikX{fd35y7nr)DB;`dRrVjd6rgz*bRWK)miv!NE5(%IBWk(nk3`W
zS}*}X6lQmbd~SVN0KmXi#5T3*^QePn5Q|eYFcxPoi=&@Sh|ezR8)++9{}*uh&tv-^
z5hE+Gen{1l55UVg*g#Cdu(D!VMSlFjG(G~A4>FlAMh0qVDN&hxR=kU4nX85~8Tei(
zn0d=WzC79wZ4NXq2e?c(H9ad1?%yH)_Fw-d#$IKnZ&wQ+O0Exg)w*Tir84MizE#Oy
z<(svGunh3U$A`p{u5#I0`EVfa)ZqCfA0NhcKrYGjKwHC~X?aHSEzT8vHDs&(qd)rE
zaGYdm;=<%~VW4Dn9m;lgWvpp;eV*&oGgsYhYQYa9LK%Z?84~M}Gvi_s&SrGLEoQBv
z{_lX%%JWa}$HW2hWN`Tq2Lg$yGs?0`kWo7BXu^!i3=xK4Qhxo&12KnP06L)hzg{OY
z28D_eI#G8mPFECPSQgq7d(XBnwEfWLK$!zY>B|I7yM$>o$7l}v)Mj<&^P(TybARoZ
zpAvuXw|-rWEMJDUS2@wiz)c)>Mq!{S({=6;P!Z<hsANny#>7fK#<ajeH@bCQw|Ht-
zzjzg1RS9!A*oZ$mQVV`tHbRsC;bi3X_fLucYGxAl8SoX;za0kZ7iylLO16|BV07d%
z>j%UHtPI7wGQ5%31rq?W+2V`-*(zEw-T#)r>}*8G3t<fwao>BRx|+G!8!kJTWy4Fw
z(+8oV(sU^7g{%pz|5Gx^#8hD!`D=(U1j`1^eyTWI65n~<{9ZWw=ZD97)e7`vR+ul?
zepWg=^AIdLu<g17^sxa4{|5W}L|<=@-BE|<Wr@4@M<KKnpqo;A+wfHF*v|(C*p}!)
zj)!oueXxBEEgcZOOS;9<fj+Tn#jx1*$Y!w*XLPJxyAt0a26^359oc1j>69N5uJSg>
zO0^l9aEyr+V#c%z4vU3vDc_wFFX3<?DFE0S4J-q+!Xaw@+B#31SY5q#OI(7}rcIB)
zRu9Vn)~&zPp(YBWfY{NQ=`74-V7&D?5&*2Lr$+G6Y|oU`**PR;9#Rv!P7O9iXs{$P
z3Jdd-7xZ4{D3P~{^?#vIwAcPuu0h9A!5j1vIQ&PLy#MK%Z3PX9WQZ^X%T(&sKK$q8
zxcKZc%A^7LUTPJ}Xk=AH+oE9fD0W8d+_ph%-?BlhU$X)ob3fia27PqYo!D(a<4G;>
z>r{ZpxUv&m6p%_WQX#S^*s&N2!M5AoO#vGs0B8IVIJui81BX_S4j}o0-~6Es1)7#p
zeE90%ZXH^igH8pgLB`i-j3|?ffZ`#mxG4WO4-Jcd^aq#meK`^I3OF=0<e|6H4GjTr
z+#M6AK07Nm?Z8<L+zHUR93JX%mP*xSnuwghJO|UA=YakHMNE+@nxXegHIGVSJyY97
zwio;V<t)z~sOGK%x4g#WB~%-s7ihl8z-Z&}=?QV(u>FrJW~%>N0od6bdTOuepc<|a
zs1cV{rY|}THcYTG^4Aby2oB_4ew6t5px(gYKU2^G=pc<{nYp<FES6V@-}tLv6Tke`
z=f$d3%dv$A&ODf<ci0LG#NJdEOzl}^$z+`K+^6f1C2Hu^PbU=ha}~J=_)<}Xih!7J
zgz4RO<&uK^Ef<p`&_M!x%VPW!M*xtg(5X$+SUh7yIo}8<9<m7+{q>HGJ!0RMCF00g
zM~LU)Ks0J>mE}~A2ks4*{@(rQ6Y-62ehq{F2>O!s!g_EU!<1&63MLMFmOQ3F2s;4!
z16cJpf1;lmh0&=oZb1ZqqUhR-0V{98AjSrJ|Nk{-uev%=NhT$z<dM^3o|GC)&UI#5
zdDc494AO1%Gug8QYDS*^$2Gc2K<_d689Ef$Sp=6=jJ!2O7=kPFbVD@w)?5+le@f4K
zklz22s{iQ>>BVOch;RRoza=(p+XSBABgLR^+0BdvQVV6e*O$$o)`SxbSMvzQeV(5e
zkT1rpjS(?lR9rePJ_r06On^qQ_Z-Vqp1f%!XN)M9Hv)=>9E$5ia#gNxFejehH|Plf
z@^GM5nNWHBaBsN#;mC=LqBu2)O#lPf4v3}Jhj>RxK*MA1ut49kX=wTMR@@v*LbjGP
zHHtCGvhK)Q&-(gew)W|(&OqhO(vs1(Q$fe}qj$~Q|5``=U%=r%o5Y3<YxLt&X;xS~
zRgvyR32cD!X9vhXGBD6W4Z$*1#We(<>!Md~&5EOE^~*A(#rKj_D5Hx0>tB9G{J;PE
ze=9a^*#vC}1U%S8IO^6wy($WxW<UrN(#)pmXe}ULj9D8a>dal4FS6m}huh2M;IHKB
zzjcgtsRdO~%7u}Eyc!?^ikC7J*AR(`#<!mHtNdHpD<Ew<u3W!ky9VYGW`kw9)&KxN
z07*naRHlDR<z&iZsOHANMv2K~#avgm7wd});t;6e8US?gIqTucM>FmklEVn>Q=f#}
zMNjON?1_J+0^#2MIdSHSUYo+1f2$a+aBzF_;4aZU(63kjPhElczgrGp*${nD5#Yoc
zf_+KVhp71Q{`VSuGTa*ru2VR~xGcjZfFw|WQ<6RKf$+cngWnQ;14F_pqEn3o5Im`N
zwcDL53wzH|2ta%{FX%=g(4sg|8%3R~FN?uf?4NO@o3Tw_M^d&eH-EdWpirFl(I}Uy
zsku=I=_k->z2bQ4l)}14PFBJT(BDKvvlAO}jS=NMVFz$vd!N|6s!LqB>1c524}gw=
z*tfPCaN=_J0hW_5To60=WA@*@3O`J^rY@q}Fbtm&*y!UE@G}|f5W@b0FT4Q{h8ol{
z=h3$}ip&t!|7qw#PT?b&$6kFoP}P_<*Z+^7of4Pa#u+5XL8e~Y%z}B<`?(VaY+rot
zF=u^S&CF&i2DHgDP=k*v5^G4y42e=n+xKyB`HqQSD2X4w6K?%aqp7$W0OEJ!o&LlB
z=5LCTl`GM&R_TN&A@akep;c+xX?rx3B%fH&A~Z(~uPTfJw*!t*vUFL@3Vz;U0eMhW
z2-B2J6IA;fREeTrv)h-mWsbBh9COZrKT{Zou^*PgX!8W$Ct@C2G1)HdLa1~?N)-_;
zoMap#C_W}`%a?bFLwg4x062%N$z=c@s~-3J4XNFtiJ~#!dmo(;zxd6s+kP4{I3ZBG
z9WWj%%k@J#2mp^+-xk@-xBb3x%SiRPYrFt3pWl?}$u0K`0PXev8}9mlmCjtf1zTKQ
z&?VYU<L>V68r<Cj!QI`0gaoH?cXzh{K?5YXy9Ez!!Ciy(?YuMJ+<E37oPGALs#U92
zRS6?wT(0~3*sry{O|OWf9b|VFY3ytSd7hK4@)wp!mW9M&fO2_1FCXbKQya^{&xKy`
zqqE;=UaqvR2kK$g^+LLllG(>6%-11?rh$?o&lA8;rRS_B8AvF-lK$|-Ns6p7DtQre
zRdZYGq+`gP<;{i7YqmM?mkZHepVr6R4Cz)sYN>l+^Ntn|E0?`TiXu!QqDJkNBi9|&
z#Y{C!$Y1|9laJV9Gx}p69akZKDq;I}!8{~Bl7x-}OP%&>%aL5nZGABRM1C2h%r<<W
z`?-n+P|vZ?4S)md!2Sl3ih3fIYo#prA_W5KLG|Yy+giL+&zxKc#8mG>R5hnNz_msn
z%{ZM%N79#iNPRIZkkKWVKTtFX>hn~3AQ^z)8L>&V-|v2z1gTcHLGmJG&x1NwWhh#<
zv;-jAX8b713oF%LbwQF`??d83#__E(qpXF<P9P)#SsxH`|1x-UOnm#InD7{93L&=H
zH6|R^*HtYN+~p`#UGvx1EBPp`-qX2GWqH|Br&LuhpYz;2URb0XKR`xoM5v`qp8mOE
zsLY@ub3kgAHz~VNy=7<!L($AI`it-i(QGW%zJ;8`Rid<;G>s_s5J{Hb2KMwB1#Umo
z_5*XXjYj75;0x)&Vj>1;hZtLndF?x6-*YT>7lG!IAT!6eQ$^5VkpW->zy%qxYN{4K
z;Lee(DuR*d-_)tn@><)JFVR*ttvrpyxx{tA<r3D!w5>Z@f(Xvg8r!~C&;3b1TEcD`
zaD}v2G$rvjY)2jlUW8m<Qt&TNKP2ubzF^{VM3>aRcn7s@f1wJr+o~fQGGI7z02^e{
z9tR5j@kZvuZ2$5xggGtCo_lLc+(R{T98yt#-WhvE>>LtYE;`fncU)?W1%;8QuxQwh
zV&qeH_1UQ`j!BYj%GNUcPy1ADYcm<2p$=)g!R_v(u5W%LntVxH?WGb-f!GzrL_{=W
zX;DzP5wR04=R+IIpS^d#Em8e*ut;>DNW2xsU77NGbuGLROk032YB*Ro_q@dsF5bl?
zgby6ghV_^=7J!u_;jYs%<0{<~jtp3gp!ma+_42s@p$9v*&xSoHPLbq&R#x*b5jPhl
zqmCioHKi?`G+K}<U0E1f(fI5Fi~NAt^Cd;P>~#+t!FuBF2<D)Q*k~B&%4k2zBY6Km
z{YxVS$_cG=DK|UMo&qlnF;jmWP5lh^eCmBAmI5mC3qt7kjxQv~KVg~b6DV0aT)PC(
z@Sv7{O2j52JAy+}t`$Q<BuXKq>G(`=#2cPiwa1%iontG6XO*M-+u!;PiyI2HtVyCt
zh>wyuH?$Pr^L^^6e5h7K_oi(_oq<vfAL<3ayg{dT&OGj?Zy5oQ0ajXCl|x!H4Fj4V
zs>;G_kJ09eFDjb8*W=ruJ37;Ihx07J#D4oT{J1rY=FiQE<H$?!aVj#3sMA2_8zdsx
zC3wWU#+PEb)tJ@vI}954GUBLaWn0BmF}=1)T~M44J|GKi;|-3}3Sq=daZa{K{eHV*
zcjuaoP{JNefxiH8bLMs;7!goC3$vB-qf~F}xRU2==?eW*_VsQd7#6ukPPQ|H*2@`A
z;eXCO<{ZzsKpCoHtwE{lcvFxf*&WQU2mg4ztGun+v^G4$Vx~bsj(1C-5BLJ=coS>>
zDtpUxxW^4@pQ(@`YO)Hc)}Si1ZY&ekuGdIl@9vyebVS4#;)51uS;iRv7U6s-%6dO_
zY8+JPh(@b{n0Hr9$T&U<jZ-xh&Gkik9DO|qCH$)nV(R$UZr36<U3*o3?&QoYv#1ky
zKY{l{+dO#s_^*E_MOfgs13pPqs3>+s&K_Z?Nf<e|ODy_DYQ2j4A!H{e^deNg_+!Q(
zb){}dBh!i)#O%v0R+V2XP(w*2OKi)~rH)e@9kv`y?%$<uzx`x+X{_*pgDkp?E_S8z
zeO@U7g4liV_9wqxu5Q`$O%A~#q?LFXK<-0j3NbHAn<4o;>v*~u0HO0DHYdI_x}PEc
zRUSt_X1!Y>5!G>qHy6S~w{aekXN&D*-^2G^bj1`m6*&vOmqoWuzzp*VWN)4GWkuW*
zFfRL>3r{2^0-{i>#L5RF=!S4O9of%~0r`8L16>r7Oo+}kNq|l^u#CPd?pv#CFNW*)
zr(xmvO%0PV3>3J6dwST)lo*+>AHu0wr71<ttuL#MhQ*z^#7KEXvkjx);)_=>DgQ>>
z8T}H6WvzszF0!Y-HlvUbdPVQ%&R;Z1BagGOkbyIO7V<@eK;XF`Ki@@F7(fVP^21Fn
z_XmJPbfQ7#fSbw;MZKlx{e)hQ?|oHipTS&Kjy}iVl}JZvs9?b6O|g3by<D|`>0uU~
z<x-cMM+jy4AR!)qfVW@pX6<<s`8@E)ne+5FHjA^T1!5pTRND=?$;8RSk|l0Jj&f`&
z!CosdkD@Nw1amk>9cSnJFZ$h=Q~__dF^VE6Kk_Djq2DhJibt_}h8>Uy5_qQQpMX}6
zk$dZSG3)kB?-unAzA_PTNHKdVDGX#z{3|kW^W%#pTDN0hr=D#nOcQ=6#{~{bqYt9R
z-6{}%#Af({^D`u1&^FW>Z0a4bjMI=Mo&lUk%5P9n#h3Igf$Go&$S{c=TjE6CBOC=|
znyHzLR{RE+!;$5!yw6Q;FXB_W(%{ztFs9W9Y2afT?UA3Z<RGfc6A)2cWFL)0@?=~E
zyPULU&pwHds_>XF9Ve*17kwBIOFCI3wH)ttIZoDpy<j0X2|a!3__9OIiSySo_XTe5
zgl0_7i{T>~1zrk|kE4DU&fCss!e#+6g*)*C9ki)8eR?4yB7Y1|Gdk?xmMJ8Aws5OP
zu@3t1P?`TlM_4vkZi9XpwA;!hmvd+mjZ_1v3m-L<{7fk+tYj2S@a$8;1EXo7*E&=u
z?P0n-c_bN;>p6$0<3U+jM7?ETolx{;AhcNbmUb4wGu6dbrQ2lZ*;85NHp2<*X`C{H
z4WE+v`n)1Ir&n9K*+`HB=Ow6nJ{4)-ujo;`^_FoU$JX2RaA5yft_=yPNU6Y*4-sD9
ziU=oJ{F`*7LND%T;%^qqXvxI5m`m5CEBjh7;Liy6!<KwA=1(XN<{3A0mIh+5y8UFX
zw6VZ*0uVWiunM2U!Qn0`)Iv*}etQAoU%88;>IoBtV#NF`-`T|Z!9na#LT|)=(O>C1
zwV_55n%hsoMZ9!haE1#dRoAv$E4;A8fV5C?44XZIgme!^VZ-OnWt%6ylJ!#IP$^Ko
z?sX&9(kEpKogI=dJ#3Dh2f#$;V?i%#mL7OY7x~(81klc?hig?8kZ(u_6M!66?BDX5
z9_N@VDWs=sr<L0uIKLFlA>?o%?{f<9!z_}YDV%Y*|9wVu)obgMgK9Iov=mXSZFM*<
z`Y7?zwLyL*TLTehpoIU`#HJdsgPeZ4Pz^3W)z)A=Kb${K0Vi@rLF<rCR<5jml=99G
z$=@;>P`7wtsf$-|W7~!z6JygVvy<DSoW+9ZDR!lR<A7<jXN~X2+Y$oE3M#7aBm3st
zcsh?|Iz4W~5<}g@(giW@OQ(L@y+)W~7_d1e&LL^YM}K0>uH18H*{TQ}S%pCqal{`o
zkIG|eBO1j3!-I!!VE{`Id)VdEp56;2LWn0uABna)s3$04IO<n5bt{DK{AGl0bUrcM
z7!B?@)KpxE{ybhNzc08$&F2vV<87tWvPrK(8$y#ooemyK2vh#EFh<Vm#3M2;w4kM<
z7`hZ`reXnQNk}|m!Z7x<es?y!OM)&*@U&a8E{!0&_~(qw*+RsWnQ!E~pATEa8Upma
zCz2yTgVi%T!&7~jmw(m~cCL9J@q4e!!GOdg19THu;aylyD)C<BHcwN*bq@>~5>Olt
z;QDo3hC#cfrV7PF52Duio`s}9$|0bO)@5Vqf;R&O%<)k_oc^aqWYNCw{!e~pN$u3L
zSB!Dyct3-0L=1h`72A0scCn0e|FBKJ#G(9!*d=)g|5|d^025C4_X>(lw(I*|8sJyl
zV5d6>-8{hq^8izOwhPy0g+>LeOswKRW{}1aYKnqsk_B1Bl<&Qzpy&}Ti={Uzr5$OG
z_*QWW&Y-T&XqGAeLkEmI5x50V+kz^Q0B${xkBQMO`tfHZE96X?pc$YD2kv>M<=`S^
zpSHF&-(DxQ%LD)jdI*2uZcPM+PdNy1%Yp$-^SJs7mP>AnFKncsnh+gVh_JXRt|4Cy
zemliVsXhe3W9xQ^IONz6-Os(}U|~eqQYI@78U(BeGW5j;;$wAPU+R#OAFa$F3+wAl
zCPKHF;Rqv9o&_R6HUO_Aqik+t4)V|CK4@rxp&p_gisXirTyjETfjea@!mCotqm)tj
zqWO$&6P0&>L-*}%BEdwI4hsh;cH@9bp+>-L6#jttuI|~u%AJ=84?t#|_06e#*#|~q
zF?-$k8>>OAKWh1gbzKBOA1g)#|KY>5X#p1h#jLU>-OQ{?Q@=>*@$mfxX2^IrmFw5o
zUQt_!N2c>!8TUo6$<0<pIj<`nG||@x8Sf9=5aDD0wz+^}_3lNP8sKWv;5=v0;E&QW
z_Inl5p&`J(rp+CI{ICTaUtliWc5D2qD21h|e2Z*COe6I>kA51HJ8fCQ1>-5r=_;%Z
zwf3g)!m6r6#O}Gv)l8lBjE$p717Igx2fiN#GfbC2%wK00*d<N1RAXxE$F_|}Ot+?D
zPHCtJtK@i9K$Jp0>8li+G1HRK=YihnpJ$Ant!$Vg2`|s%C%5xBCopO)0GZ>S60aB+
zfqTZ7Z5Mfq5V)^vo*@N&)n*2NNrAG(zjdQ7Q1(F7mu?;2FGctMm?2PBs1o80d%as9
zbVz1!%uDyHsaFTGscQ4eVb5A#y~k0<E2$zS_sLR*48dQkL-bJB`}y40{<g3#H5w=R
zuKMS|T>H2Q@P~FQ6u<~976`?ZIg)S7FNkLV8rPjFk>%Iq|BgOdeiheWygybrGP9FQ
z`Gi=lRU`cIz8_^eGBx{DGCHDpq8~94lx?L2j$lSR*Z@avsi95T2&}3!F4S;egrRJ2
zi?d`TL=N9ea?VfsHRM{vN#32|fKfY;b)<{o`aP$yGju6ZX)66P^Vp*=LY*KbHwCm}
zL{P$bNA{=0B9f#QNL3P%IlcszRTf7oD~=am3`mtVkkN#?#|xnP08}~nu;WMr3fd^7
z7|E#9hC&*EQt8w{CZ9UGSU5BbafpNq{ukTXw+b&7U}d)j5E=M(ss%_SU^0OJ^c?4~
znORxb9x2O6JuR8?c}IAO`F_~lYNNad+2iSa&(g;a^O!)uaLc#vN`u;6WB@oj0Byh2
z2}6<>FQ8aVjJGPz2@WLj)VbN}!GjJ7a;yB9Xqz^Rj6!%T@VIgUNj5e3ED(fE7g}a=
ztZqbfWWGC*SM&II8|u%fDcI~MABPHs;b`1Uu(gt}7(1A>otUBP@VgA-M7-m9R_3W+
zuna0-Lt_=KWGJPHCLD1i!!WD_FRPpP!PC`A`CP>+O#jh%|1063eSc10<2hs7Yekfd
zuTg%W4U-P+vY<d8AlR3H%02f4Sux~?2iKo5W;ct!33|a!^kYbANK1^edWZ4BY3b(w
z?e6X^Q9eOO!vY9-{M|o%jBug=G+s?efz(}Cf})jZzlXu8@6mkdX+C+lB?mA8-nH|7
zJ$rZ)eC(Y5;xH5leT>(eq_0ebL<Vn%H1+c*l+A6Zsp5aJQ&|k=PvqqXCrD{6&}Jw=
zn~Fw2u+&V6Z);SMHI3J%WM3tJdTPzlG$vO48%8mExb3JITi`A(Cy>e#TRN0#S#M15
zQ36^4ovZ38pD6h6;7}un@|XYr!BsqF7!=vGn5@$50#a6&JY$Ai9(?BiN$JjE+X8G=
zjM}367wg&7t!5#gEiKaV!P5e(Rx7{JQUvS@-)1m@5}(jN$4rs$V^Yp1%Qrt28lY$<
z;%PnEk>@Z*&W<j=1MEqxY_`gX_+#>=;(-drBatTF*v?y_{mS4z20E?4|FXVW%X2y}
zi<g_FhGt8^)LRPc=w5y5%|1ascmQpiN+E}08&~Ahq$P?~CMK@R(#U}wYpi<lzx(|c
zA1t>mpiu31VIBHQmkNyy?W~_Y8it$^QLiIRCDV@_y<ZB6oq00QYemt<{3=sTdxTeC
zL81I9T33P?*z%hj(4GO)lADm={x_Qxkm9qr<se?ks`xqKBM1`izD`F-Fi$~D1F-UN
z93$f)ly!6_2L7fr)K42zdS{~D6M8WgC%B6aw%LRk`QQ4{O|V>eLJjJ<=x0qm%i)=~
zwXC`*wf)fjc4(q7!i}~c9|7_6@m9+HS!x<j<$!$=c&eboN)h~QnuiHnOsZ}NTZI#x
zdd>U7Cx(J1t0FOyIq(mI<Bps^bgcZqQj`OG<w_P<Ur}20Lg9>6T-y+0-Mb?Ge^71J
zPm0}71x9;Z9j-{}lU<T4Uk`r)8S|Gr375e$FfI)FS_C}!0-1w(E{;c0gBW73lsIYa
z6J2JpQb?V8^j(%u2EaI}T6FL^D3;m$nIa7AU=;I<aNGTU5o8CT7XaOZv>{sj{K6u4
z%j`)J&xZ2O>{-DEvrmD?jU{hO1`tOF_LLg~U{Mm@G9FOm1z{C3RBlEE9VcYDmQ1Ak
zszwz_j;UJ{tW(p6h>hkDfXzS|5X@nlR0*LY;T4G_r;V~RP0fmhN+T14hz+>MB0hR0
zwh?ouF@fiCp-_gMMMpnIf$Cq}&+(qoCDLMz^3U-djQ4!&4{D<+Oat$Zt;AfmF>e|&
zH~|`uoOo?xpvY#_5QeAgNm?2ftWwqX{UxcWzZ^(8<@gX4-T3X=a)%cgyta&+yJhEE
z<?!CZ`5V=DGfB~P<DIet@(|B<L)ZlI)Y3-6N6wo;te&F2)C@V@xETdwn83_z(tzH;
z%NG4tj#kKDB(1<P^V+kl;rpH){61;SyzB&fL`gV>y<WC5$u%FbYCnZsH7V*LD{g9a
zN~k-6%2>u*Q@mzuC9Q0z!jc&~bVB|;4u{ln**Fb!3SNFwL9c=L7ueMXFU*MA#s0GK
z*8rb2qSjB09Qm8VTV-2|>qkfSpYBfU3_yBmYEykAh0c!=Oupm?z)yWx8V2Fut+F&c
z5|ZB9a6|xgPQ(MTKADwZ!t1e7owl&kkgotXe;=Mb6vB}J-0QrPU;kjaJ0l{aZMJ+g
z=4f#;im5}<e~Ryt9aOG-SjLKd&CaUZt4OaXN?JH6S43YWblaV(@j56q`dvkvBJ--|
zEXmPKF)bD)-B^mbM-x|<BurVU{k8nVb(!+EWPik?77jKSJrA@v^L;-q#F6-RWpiAt
zK$k|<Qs#%<|C2zQuOs-U8{uncq7V%_5*L<42nC$zci(5X0}W8Pi#cP;bYGkf55u_e
zr6kIdbaosp+s#kx05bCAhQwpFQ;lSRApW25xEa=kS4Z9tvarAS+Tp?BylOqqo5^J&
zFY?^uwWXprVZ_K?7ow6%#h3r{Ru_^jpEq-chX>Chd^{;KERu6a6fhzU`M%*)>sZv)
zssY@UM@kZg6D;a`-4$pGi7BYlsHm_kxuGsr&u~DX?Zx%1H&!<+oAh?ShhukdLE0J&
zWfI>=h>VjK6Kur8{;zP#_i4s9AE;pT1|a)eSylnthrSg>=5I0S>V1?(3~+!kfUBG=
zOev|VQj~9+1<FhOpqt`P(x6i=Zsw-bD6%^K2CR4K{)Hg=Qs~f=zTI`#3;^x^CGkO%
zX!-~&edy+xy*B2*`~b)d-S_QXD7EW)b!VuKt9gS@z4*z@E%rjuWvc`6xKt~S+a^NH
z;jak}<Dxw^;}tkmGsRn6^F#!AI*qwKVvaE?GUAR>Fr~nroTC*6A<}de)I88$bpqzl
zFiX&%46?ZsbwM%`R~rA2!au(9pH&k0%-9ZEk;SIPVo}*&9S8Bv<X6_1tk9vKF>!#J
zvvnodS;R?ma39X4SCL5GwO<_d!P2n-9Gi$7Jq`By4(A(|J~ig$4FwEoxaqGTVe$#$
zPJm?f%sU0Xp9Mi4h9;V(+Td+X$Wi?Ivo412s-aQ|xlS7-{0n@tO)XSEW)EyFYDxD1
z5DsUb-#%v;mZ<t`0W70)opGFhi{4a&u~nr^8zDauIqr`Wz=ORMjM!n5+W+>hix~(-
zZkMYeT}g58L&qlu-yJq7d=GAkvjh1HCZUny25ut}4l&IrtpZmz*D3M_rg&JLFM~vJ
zzQB|&BACarM)jgVj_IBVzp>040}jUyA~-z=n{6=~nLX5vhv8ILX--gF1$YEYbUAo$
z(81I;T?qFs1kx;&`cEy8qF<!9w&u5d-arh$FycRy@3`kvNuzG+-^9h}zxBaOAQ(j#
z0nM-rfm@B{HB86Nl(KvL0jMtuim#?P6!X97D6RfW1gpy~*N1x_;Qi^{gD7%dxJIBv
z%{Df&vZ377xzuRb|G6YbvRi#l{qWMT)Fba&yyoWSprPDTiyoG(40QD9xBNzD4Hh!=
z0mV_=q1*<y!Ng7+f86ebcK{U`{MQ_K;c<u5cZUvk&{JX#`k9u4D(IGrsg!y;e_yxh
zs0R5-YX2rzv&qiP9Uh-Ch~T}$?_q@(TZPKcJ6}Ik#WpNJ4$KvhRFQ3a6(z6vKl|_(
zodV1YAAcu(;7YItkkQ_~$s1_3qM<8XSRngfo8d=5=D)sWh^Q-^9IK16{vS-!@(<I1
zx@j46(mRNch-hfbt|jE>9Wa&H-!&5Nd+lF-@VH5H7E==SJ4%cAs$ChZPG>M$^;Dal
z&NrjL5~;dc7FXRqs3|;dAnpU_RMsEF2#ag;<2f2k)b0#>D6;UfM8x82+s<I8ucuqt
z4VanB=vO#Jw>VUc_Q;$)*1rF&8dA$t^ThbdMhbi}Yt{hGOu&O%c5|$ycdlNcUZx*#
z7*W%pHgnGSII^K1Qh^fPZ))npZ(ay0ec?g?o<3ig*+u{lUpbCGPf*|EZw7+Dw-gpy
zl1Sz&m%ph^gqXqMU~<!Q$)zIHn%)0AfM!#N|6w?+<=nk#^d1UDO|ey7B1W7i>bwX<
z#x5=FO@a{wBCKRxSz<a$H+Q<C4(*YlpJ_+l3sQKY%(Di`<q|Y(MCM9*=oy(EPXOQ=
zTE@j#be)Kf3H+9Z6AK%tUYM9dx_j?Ff+!cMP!w-wIJZ86TmH=YBzYmB$`r*8;O?(a
zinq@hZM3_{iwr#O(f;O37{R<NalUQ!Ay!p4KAF@t8C@uih?lQaoiQ4!zUsL`TkHxs
z4#W==!z~vBp^P)P%wW^+*PVKSLb|dEIw53&JWNwYDZlE8W2krX7*^gGs?-5(erUcf
zAw4EG@I!$eazO(kh}i#GC}EHfmFZs;e5yy*E3aB)iLVER(=XQEU(;oKYZ=>VHL$S4
z9DbliCAWJo>A@yo3~_6X7Ak#uC&#FloR5v0@gYgkjA-jb4LwTa2?5Cn-cBcnRUhHb
z=lNUiEttjo6lTP-BmOtVN+>PAHycP%qJ2G!Daz`k+*(8X0_txWZ5mm|$|Nicd(+pN
z*iKC4BELlRT4Og&|B%|Jq~rxmE^oCpUxi5{$RdawG}PVuml|E<i(HVu;aoq_etdOi
zfeBm>r3&dvKpcB|;v#=5nXbgY6TcbVcm285Fg-9I^1%;R$)8OiF#E>{$Dl6hW{4qP
zJI%f9fWN{&_e8kuJE^TqC?%J}Cvb=p<?rz$kZ+HIt0dCy^NN(4b!i+CL~Uo!rLXdA
zLyJ30yw2di_pZ#%s;;a?VpnQ0kdBp|s`dU{FQGrEWprP-W_fZ7nH|nmW9GC+Xss(D
zif|QWp;>Q#%9X`zVM>lWP8W?bleQ@@bKP3W`j5T(93t|O=p1DNDCN)4Qd<cj;?7_O
zB|z)Oh=9p4B5AJa=?-GE08lqOx)|IRPw4e+6n$QLmx|;BY0CHjLy_E{eC%8w-0jkr
znMdK#Y8Lu8kH3u8NOD>1DWgwMV{5TDrN9_>^L4vg>eFcFpp*OzHJ(dIO*xXX813Zz
zdxoe>Vvtp1G;KH{5h*W8l&PdCj#;-F?Upu-Y4!`3$}dfIQZ1rw5qpSIYIHO4=|3(W
ztwBQl-w(+=6HD|(#GtcDgVBjf*P=H4e%l-*mn`RG8Csx)B(lFP!2ySkP^<>l0gQ1L
z7<Zib8SW|Kr|=>IpRT%*=TK)cSq#jOda?~qI$hn-B9;(^K3=Jcio`PWvsdgPpg5%f
z3+Dk^RBeaFN3S2JrzS0EFd(y|d?GKlF9OR4=ziftnw=IvlWQ(|tF33q+5(Z=4t4AH
zQBi9v!LAz24zi$w%v;^&GtE`6;e}<pYDNiCA)xe^>I4EE&5d0pwe|+d4c|XS3sO53
zRD|mkNTIR^gWwnZpUca=eIfaOIQTKK&;&(FjW=w?l%QCp?7+m*^n5<f%wN8I79=zs
zrB5V;aF8^D@CIBK67p6Q%M+s*i6mRnRHNr6*7&^PI#!^TxdAi<w7rCn<lTA-ws}f*
z56?P{l*dYI{3G}{Ji54_dLAM>&o~8~k;Jax5fX|+w{$M}r;r}N>cImsBy{F=g@6Az
z<;PV`@6L+2ZOtkqLC=H;sG}gm!+3|ll|+j1whffPyEC&w-6C3hsE55YeR~aL?RuyP
zgz2@DvXaP=muzwz9rzQH{bM|(ZQ|X3m~kQb@f=G3>7zfX$k!9?nw$Y%lHTn%`KJYO
z7jgXZjs)+NA^%^Mh~p<rOPlOSg})J$VKVma)#RmR6=?5%aYO$>Y$-D}>+;3v+6>$0
zkBl7F9t;wWr0A)=?&4pX&0iY2d1LLp&wUbOtIgyEqZzRZwZ`WC2_%$ADkr};D0y^t
zp=Zm1wR`u~VdbDQf*&C8p5q5$T{aUkte@>dgD7ej5mr^>uyHOhLxF2@NNJkyBB#c`
z-UeTQ!o@hcA7(OReIb9z9q<5|lIWl0hRX*wAq9bIFMIMFF_2r`e5_|V8@P4Q?4SgE
z3rxHwx}_ToR__>Wv1h^%^zBR6$2XJVBbiESxSZYYN9hR0P`=late`f|vKq|8*Co+Q
zYIcyI=2oKKZ*edY3Z1zvN_rnrS2D`!l2s-FL-o@lA_iA$8NrnZQ~b|>+3Sg=%qLFh
zA1R*u%qfWofp$o3{d#}3^9H;cl^s^lBS(M733&MPIc(>biO6G(GLR2V(2nj5UHC#A
z)XQ#<CNgQoCJ<D`@ec)%%>Y>vi;xYy**AX{J&kZ@cX$Z5JGQo!6k=yXQE0?d;6ePP
z0Kg6;6geiea<Wl!>q}v+DoQWTyRsq~{vhewVfgT8Acx`C!<#L$5`rI%-VC`vWRhja
z_QDujdYO?&IKYt9t5m+mXoC*kr!)>66<owke@naVISDhMdb`lO8JbcmR{pNYJ5(;4
zv78`Z=f1S$dO^33IV)7gW33(KqRiuljw{&nI{$rl9fr`%QUAwv1(O>64JMt0Pb=>|
z8`mEXU3Y9o?_05wgX(gpLa<f|i>R=PVWor&7*9CFJGEZsF0LoA5!y(=FcLf=X9&;*
z4DTE!EMY8k^V$K+W}o~NwDj{Hnq)#_qmJ1DsWlcRWZzhy3C+HXgol?Dk34S;N0!cT
z+ZQpxfi)CGe%j_7l7#OL6l!;NUXZPB*c{1z*snD3Z{1(`4X7?hfPq#jtyI>2el!VI
zJchP#ez?q6Ev#+=;Z&l#`Oae#a7;!gytfp0`6nFbLYLT(HJpwPq7%GY%NM)a>5{yf
zw2c_R*ISCQfZtf?7uT|^;i6^-NmdfGAp#KUam-#D-@EO9<Iyh>2TbMXG$f>x?(ERK
zes|4jOvUCAz^x<}wt8Y*iXHhD9juFjo~@VHt5HT+Kg<WP>QCxs{@XO1As(f~zACP4
z^t0AfqY#>Q02kIc$b`T@;pm`y*I@wAd5!8n<}!bQGKl!Zu||ezx31<>1;Aj8X9kMQ
zT8QA|(j0mS>lS`5-nhJhg<(?E$=T&J2ZBJ0%4DkR+TYyACjRpn$Wws{rrO)O<xb$E
zZN}-1TH_eG?`T<%E_2BG8+L-?GeSagPRQxU4%b(-FQA%W{166MCA+ZxAiGQvJ}x+h
zPe$?9fw9)ah9F8u{bxJ`7;R1a#azX8IIt6XKA=-4Vo0;6@Ix(Da=|r2^<hi9nL!HX
znv<_8lWM%#pKb(YfWe(O2BhdgoCJo#oHsy;9KH@dKYjKVk<_nZ8+=qj@vqV1t?og1
zi`YW^JrXH7IXl4*|D`_?C>~pHj~$PjZ;#oJi{dX@Mjc`-jIf8@8l1g^SQ(P+RDy>$
zT-2OM2qPJ02!&84HJi-o^D<s4Z`HFaGmp}l0R(%s1nd;W_yubU=X6$79YJvGhFOvx
z#okryt^Fu_76FjZx!&TPCt8ArEO;Lqh#rhX25>_N+l$%L%&k@->6@EDO^n}wY={a{
zeIst>*b`reXjIz6vKqFi)ENEvwc$1s`SRPlS+IVF)aw~4t`&w1>vM@|-#RzlJcZ9(
z2rC_}$M=!%gH2IHCw}E`E^!E@La8G_w7^w!78N7F>JUwxzlE-f_R%>_$#WBaSx@xG
z8T|))#bYy$tWueA%GU)+KY=3Cki`o9jv}oz=an|Oy(gbgUY4va6KI^=VQpr3nC-$I
zaY{C_yOU02F6Q3(ZfVJB@insE11kKUW#B?bLt6=#H8R~xFd1%}8hKy7QX402YAD=T
zCWz_OetcuP^LV!TH$-{o%iEM(EI!gx81mGQ&8D}eZ$0s(V7CBJ?5Eb6V{F@R9wY)k
zxd~^kNcLqUYc;L1QDPO$|4fA_x}8n6Eq8!GS+&uNXm+D0*+=zb&kQLkNUAFmK(I=m
z+2kBxlp#$wiNuJ`;zJYsOe`^g+_&9#nBJFPF{}-3yN6gj%*;<Q=`#S_omTVfT`03c
zwp~{Xbq7bl0UII>d?BFc%M2qLAg1?ysJFW!SX``HT>8UmuQNKU0Xl4$uGme^&erJW
z{B3NT&Tj^K9-3m^++o7dI-Yyj-q#V{O&^2UqK2Ku?T+QnhG87QqqBy31z@IzGvPsU
zvbMHJ)*m(&Ad4{M<Xhb?)I(QO)bz|_zGF8^%m{!*#{JPND|gGi^;Noasi1R0<LCC)
z_pA*F^VgX0cL{gg$bbcSNObehK5fab*s6DsSv7{iqw1&rz)VZF2*{xlDMKt-OsI_$
zLgVR~V-AR3+GeFyRT{9|=$vsV{Fu}C^KUffQWxlml;>1I3ec5uU6Cx-g!lWN?S<_0
z_Y6x{NiOl2H8?4$v7qf1WmX}&l1>!(3%aEnT>}$9tp4)uR*owgiN1k%nT?t?OXh1d
zp<HRz4kI8I^)H(BDf03vWb1Xh<&D3CeU#lYjxIQ;0Lp$@T~W<d4bRsE_!mS#W<Z5P
zn9sjjDWLw(gAyA-3oYG8jSUcpi)rG2Bh4iwM91wIsA$Fa%4Q4T&R2-Q$b)HojnNAA
zQZRo-q#skexShWL5s{yb$}}@D?!;x00(=T^<4RAr=8k2o!p|^ro2Qj^TG^ehfV5g(
zG1S~C<l5;55R$6rSYz&({IaG|mK9%vJcZKaczDTbX7unIOfqX&Yk$_3ti*QSd-uz@
zyL!`S^qtlb@6DTuW#=ju^v=1_XYlxptqM9_iH!R@Mp%VuxlaP%%2Fx#QDUFNh;Ow6
zicm>(pE@(#6+=D)*g!<2zSE$fY{X+`K(2s!ueoo8$Q-`Y2a@u=WOkJy?H}CsG2oJK
zLnn!+iJtvGyLr8V-{%Lk=S4FG!0L2DU}wMFR?(!R5(16aI*t#*&67ckd*Dt2e?JYQ
zA3iASAbJG+_}|8V>8PH*SWqJyR)=LCIqIK%5)n1lCp|o(a5vchB+<Sb{!}mp&V6q*
z9w|$37)ZiI@bMw18?8Id!!B!VVqvNzJgG9glu5UaYtK$y3Jv^0Uo(tKyVz1U_!gBC
z1HvWK8nOz#ph9%gHh+w%-aS_F7{R5lb<_kYtuvu;k?RSt*jq{IH{SUxMNr+N&Fnn$
zAm7@U5J~Yays&NFpei29CWOy|E)M*%+Ks{W4y8eBkS@gnyjRsRr0`p%vIU+}&+Hpy
zx_4zt1nry_hmHoSC{utRccc_rEGaEADJmYh0^p#{uRa&hkAGIr0TuY7yP`DkoD8H1
z*TR2^R=JRqM@dW-MpiUrAyQ(9oH($PAOW~6Ig<&4?e5}(t<&nUX0C<a7!@sc=d}Sn
zoI&Z7(=f3cjLh>}T-Aejfp6Jx%a1?GY|$yCy$cW6j(a*GMv&HFBM=4=Yv6YsgI`zH
zWl%Q1I=o@A4Cn)KB(pcs?EUv4F|i=h=O56rDB>ZQZ5EIY{F<<~Z`GkG<`Ecr&V=8n
z+Vj3w9C?}Hc;z)8dwIS!2zgOGLuDv?cqWltQdNIGy(H>A3!@ZSBy}LK%}GtgiER~c
z@;BvcRxL|Qz44Nd_TA+ao{SP8bq!vC3l?o1b$yFN(RV1#!x)1p46W{*Pbs~9_WT>?
z_w~=J9Q1-FgR%u?f}*Cztfez4w|sBK^w&^N<xH{7Gg>p~mAEXZo{@^Znmp)oodIR8
zfZxPmfHd*rG9|D_y@dF8N|41IyrFBl+dgru_aoKn7Uyu^)hK!CC<l~q*xo;GZ*UDg
z>S7aEN6GKhD%=m`u{WM?Y`uWK3_0|f-l<=`Vhwog18`l+81-nJb7&lm^$0T#z&(a3
zN7_UrYO0f@nY#4=&WgM#=%|S*-Uz1p;o*0R9M{iRW$|}2gg^-$g|2`LK^=XTq`6{E
z#UI;Lx6Ga|^WM53%1x1PEe|rfKh;XK4Dv@Mvg!nBzLNU7b<Ne0_SHxS+06Z9l>NBb
zA~=&u%9s{yady0Kv0DD!wLUuTo_vdD|8w&T<xt>5&L7z~k&b$jsMB%`X|$LWtC=t|
z(StT1y7b4NZNw|P3%b`#Y(C`MmpMa-fO{A|ga%yrMnDPiM4hY4B6bYM-R+O@<x!kZ
zvB3NVWMIDF-aod@Z<+DL6cV;y+}gh8cbHjPRpw<m`JbbBkB*BB-Jc9)5^O*ASc@R|
zPrUJvy&ifL5p4~VAo-bkm*N`Gk`dVf#D3H~kdM)UZD1R-y0ay&ztU5W;$-+<?!D{N
z{Poa{fb@edt5k6VZ&_!@dclfctH`v?Pg<lSflYL6&JlDUwD;)d$b4==$YGFg586!v
zd~Ps{l5c&8f}B>X^ZbMc!FbVs{r)+iy8}SjS$;nI)dY?&sinDT`l<M3?agW8SGm2b
zCs<RyV`)SpA=d1?Y=VPtOygNfzimE|4&@O@gG4P>)H#})Yy40Vx3#mPRW;FJ_qS3n
zjyV7mYVFi^qM5LU85@Y<>`Xkh<a_Qv(B1wXtGXSHp&<g!9gDoOPMXU8DtJ4P{A28<
zBFQ4R26h6U;_fUk&>s_LG)y|J%6>2LA>dOXL}Rw;))8VM+&lF@1xj50ssGUD<Ld^)
z|C5XMl8d3%REB$P;?u5+Bx!r0DU96^8~8Na*H?(^tp`6EV}X*oE_XCv8pG-iTl0H|
z#lVs=0Bj*JBP6XvkfoR`2Ro!ZPv3@rN!5L`jpVeOM8PJvGG*-*j%jv%QM;eTH!}jH
zY2ku-Md<*3Gg@SNn-uqwaT?+(2t^`2@1=!~o`M?JlRMbq<{&>n>z0E|VhQu*cqR~c
zXj>Zgx6FlEVPb;d`wuCJL2@?&QyAU?RpLL_KOKI^wP1r~kK?TR`%cQr#2)hsnTOhU
zSV6cf5?-Z1{|7TBuuMf#w%oSLJ+{Mf@y;$_go6APcbIOXH-TW9yAV*13j?rOxv^~Y
ziBHrEaKF&%(vs1EC2WYp!lOMc1BVDd4UBg;8NNJp2Y%=X6yvzQG=9gW-QzBS6djA&
z5oj&SK;ie<hL(%FYNCbg*B^;I0kG;)=I6A_bwvgzktE(2Nv*sx_mcQ0ql!Ml(Z*P<
z910%?jwg6O*IwRFsY}@%r-YckFyJJkyGR3ZUEC{#3rpc9AT$}Q&oKLWV}X=z?nex`
zX2$NOrXmtZH>tOIR7ntEvPRjRd9JCXC9ZyhxAKcR$q;N(;{`p_gj=;FQdAk_S3Y>h
z=0lrADbLqBXmo1z;|4!7stG)P2@2%lmw-1-#z6JE+D@g2T^@>bH<&YSP{$VLzk`m#
zIy>8Ofdo<yUHcBm%ZuZ*x~yZjUc^T$^Pg|`BnTQ(ws}A2J2Oad6+)-Bu=1h18fUB?
zhr@GK4|Sp)TAr`@gPTq&&fY>lv%{gb;b`&*jDBMj;sR}(sT37{=yCsM#K%g$+706I
zj|)z-rVx#W4iwN8DWpf5pJAw6SrL0LcQDvqk%|->+*8{>X$RUu1Q-`5z-KnrYLWfj
z<-)s>>>QKXHmz;-Bml_Jo7z7qifO%?6?2Urz*g(Hu)6vLptjDgkiP9TKMp;8j|WJ6
z>G4lMyt=F(Z?f}C(&mEZ@K$4$y5ozmR@;|uX?G2J-(OF5lKk5_pCt}7GYP_ec&n-M
zMUbJ#!F^A5ay@R+z?QBLp50oN)h&cy5}!ORzDdp$ME&zJs^!E>dReC9MjYJJ8Bwxx
z`}bt$*C5Ky_g0J;&4X_-MDNbnzjhM?WLfdfhkrwqmH}Fo5T+<xazw`$k*Ao<_4b-i
z(Vk`xo=;<_>44kumE6~Zo4<`cX%-uI^n*w?-pNQ^1h$kOy^hr%U6rS_SRCCJb#)_G
zq;@jsGza?X*B^qhM3|5m=!t|aE}CL8F%De}Qq=q6GG$9<1^T`A;}Qn=yRMQmJZ(mO
z%(HTRy!7@-EK_*oQs?B_J&>4g3sZ3iuav1h{t8n!UDd6?06O*lTm=bVP>@+MY~Za*
zNrS^uvY6nU6*d%k?9~NHQse##tBn=Fm(E?5H}PEXmId_&G`LSPH~5N&8cn>s#X$Uw
z{M>IrR~(QnwE;D;wkWzUq_XTe#(B}oXgyH<aL*n&=%8lJdLN&Z<{Pg!(h1~2{ZAyl
zNw!dh&ZlLb*R9tG%);BO8DB<TK>iTj_t+EV$bIV--}Kuy>tW@C<XYS6vbv8o8g8#u
zQ|e!Ug;v%V={Z#0v0F<Y49R>mw3OB-7c=L-OsxMK`$9v$_JbunJi=Tms%kJ9&Gi^)
z2zV~}R>Ltz^207x-6PKZ0vov`V=%(+hN0e&5T7Vl!R7;;eIPFKYyB;<L5CsE2Td=L
z<GX$r*T2X4#_K$lo7I(aE7imwXJ*@XU37I5yk36PEgwGyK2JlU9@oW1SfX`a(_sY?
z<5AHfE71EEI8L2NFOehUZ(A@DcH8@ZNn`>F>D{VI{foFQK7XY(5wtLYm^Q*5;J;(C
z>M?zLsoBE`>~&)gplhN#ae2|Y(nuZt<8?%BnGqdk=wqWGCrhs#g-DL^AT5Leu$|Rf
zNn79nhRVJu-0cpIFAZL$929by)4&u6A&^q_q_B_U&A5Mnzc#>W3vC;svk(7e>D_R#
zdrg6I@{2+m56P2|mtY=Leku9bln%G^J<AL@#@1AWl0$oC<BM^`8IpqL=%QnlUW3zp
z)e1>}Y&WIo`PT7t73{wn?@TgSj#gddQVuBG8^rn&038Cs^SJiT*f+#f8~=5wET?HF
zWKJta7v}lkkEl58#A(lRN`zd_YssW9tA{HRbetP_A*oj<{wcUTtu)8{o8wmO+(U?>
zKIep3VK5sP+2K)*FWxUEJ5=VI$9hx$lU;Y|K0x--!I4S)fZF+JK|&4ROa#_;FCDh`
z3`X+aGZ@qL2BG-V@s}{qyXmmZu5cLXlwMv%c3=aUI%9oc&jA9?GsE1dBQ`Nx=Fr>n
zG7v7H;qPj2hhhlA9t(nQ-K%>PN;XH^KAyktz~<wkrN!!4@-%PYB}&zP)+*%iwXVdl
zH8uL91M((uH-CBp<uj}a2^uCK;AOTlGkbxMxtP`H`QrTCMd(g^W#rt=s(#oWCAqF;
zDCH|vfG;nMf)!i!-&WuhbaU##;q=C{tAkZ+HYrC@MNBoJmDi6jkNauUCMg85+y^ls
zrlD=Tdgv6HzY<R^NaLT+6m5wQ!L+H>Y|_{!l8n3tr?gil^&UYmV9y(Q>bdX89FAzH
zz^x^~lF9+*G3c(~tP!_`N}I=ad(St0DOB6pu5mt-xOU!i^4qt8l7)}G4Q4BSpr5B=
zXl&R#E`|VT@2=B|@z2lgUgk@yJGZsP3ag4t-_c%Q{dYz~GErS&kzp2QO9}+6$0bHg
zFkQ!F^~d|L2dB{^sv-7|Yc<L(hKq5J0#3buHL}gD8$Fi*uD3NTd#tQ5lFs{;vNHmW
zkLq7P-($suCKT2&I8vwz^XR@&I(^SQ2Sq7-E}FF?^8M3?cg55KEB5ymxSDMuG05n{
z8TmdJfdda%Sl$<GYu&OSqgasH<Trr3o#u2+Jr-|`1_SS}JoR>T0qzV#;Ki>T+B4yD
z`1t|3Xl+r3yLO;xA1O|y8un;5X;3={qiXz8M(_w5fxA9qhg3xQNpN=yWl~38t#u^b
zW?*0-b_C<L++j;@lX#WCA8?g48Pp%B{vkjbQ>A8B?Qde`pHUn*uW)%6NV}iq`wnjy
zm}L0Mw~LdIkS2P#crF%QR6)O15>n<kV*oFoSPsd3b#B<5Zjp5N=Va<>D6JXUAPkoj
z@qy6B_cPDvb6L5JXVMv3%1hA(I@in`m5u9SbEpjgKraENWv26f%KU1tX!sHgj%Q~D
zo%TL$tPpp9<W##><7S<#PUjP%t>RAeUODC#v%^uSv0K7bkQrBqC>u4xDOFyn=d|>W
z#X@5-sEG|8M2q+6eN-6e$A;sflmv-|2!e8RurY=z2G<Sw2L|j~3B#!_dcZrnlp0yL
z3TyF?Ynsn8Unrh_MZZEaaVL6goQ}D>zCV3A!Sh3Ggo6sQ-!9^gYzK4qTwlBOZ6QwZ
z(w9V3^{@I;<?kFF$gt^trNIDNzD(_$io9-&Drgl`Ep(RQMwg`g`1OMNn-<?!orhdg
zG5@Hmww^oVuhCGjh54WYIR`a^OM-jqr$RhffYQhXG|irfSKX2Zo?LP?K?g(C7JviY
zma=+8$RM=+4xK~AWHRxqn5lj6icBBwy3?}S_cIdirUeYphpsEJcrV2an11zIB<X7z
zyDc2cOsT4tVryS$ThROA4R=P+Q`(YTScv3jVJ+2}w&t0lp_z|X!`ITzeYRYO{II<b
z!N_+1g>HU|8#}{kv;0{nyK#ZE^cpw-lOT4TDBtzWZiGbwc7#m+gcN97EM(m7G|OUK
zzW>8wyx}#=<>It^7n^y=XnnhpVlneIJUg9zB~#6Q=N{C&{K30Nl^!GJzEXmHynr4}
zJem%=hy@jB&$c>|IQ+Rsvw|b~hM>;kK4D3QhQ<ZqG!z~>imb5ln;EGv>9a18p+}@2
zM~56t7A1Bgkz#UGZe5nvOQyu1py9_`jrZoP30&0sFr^Cdvgw$l7uedvsgVQwYBnR)
zNT!3cYnHD0`D~6fQEt!o&Rn8rUfA=ck+=i>fjVpy_|IRQ2PJS$SJeaFBg?6Q)5qEr
zN~<aDA1OmnnHp+1&No;hTi<66*V*VmgcrgSQe4>0Q%NcYZwQt*7m+EWAUKq|Ur4||
zQ2-C(Z~i{RZESD=Uqd~@5Ubtj9{J)ubNjg^&8iVQ8ybnm2#qb;wYaXk-mB}+Jw|mS
zsOQo&D4zkzMO!1qq_;F3D*ABiX`}mU1g1-zSq+8}J(k8z@ltDg<d!nHUr|DK8<(d#
z*6M_;6}8ATsj)M}zkmIAr+#YD_(qnS9T&R39>v#}Mc#Z)<$Cd1!-bI3l;?q8Ns?b9
z#<4m|RA){_%~$Rv)BKAl1jkasF|sLf%24T93$`u`Joww_O^`ml%*{y~*8hPOvLGfm
zqSir|1{HS2SO^gVbju054Nu=Gt1~rxJBR7X-s}<!leAX}_?YetOUURSJA?;aZ9iNc
z&e92VZ&#TE5&wq5rdAAu#s#TLbsJ1{iMF_@lw0FJE1*C!2h!*Df%k<RpOma_2dcy1
zxiLg^l#L&}{+X;NhsF-7o)wa+z~OlDjZ%N>Y(uetPnY{vPN?*Jsexj^@8)#z+X0hK
zp91*EW;ABAju|$L%CL7Ej=$sSM>37#z-Jc)-Ol)4ZTFi<b%ozqqbgT;pYo?N!_BvT
zScJlW=kE)ze!<h=6=G;}wfyBbt#wkUn&H5yY6qCv@?xau>DG+yrLvhe2BnRsY_Zd{
z)NSYMiPOF=zi8p#N3km;<O{I47_|?Q1LDx6R4>x6xxu8jqr>kcyD~;TSu)II@X>Mm
z>?}xuvJl9t%f9(`G>8mE{v=>ZL(TS^dAI@;98My@xozuMcdN$HGSF!xK9p5o_cXJl
zqeTr<tOJ!j;_ee(!Dp{(=yKYKPsP^HZlHadIwYuEcW+sw1~U2k#6}mQ3F?;y!z0wg
znxO#f1`c!B2!Ug6?7)*TMTPfzOXI-1cE>~jr{^X)#Q8%yG>@zAPy_YUOggeaIWkii
zO2=jWwLk&-4RJs0iquQ(AlttIN!!~J%}5G37J-iqIETtP*hHdN4n;u|po9gDCDDz4
z?{7UuD+BdEv%(I0sVd{$t`^{3OA&$Z){T#g(Pst01~sjh`fFfqK5ZBq4*cdFKkK{;
z_<cx#T%ryskp6CbARYiasR<?sl2;8Lku-{X#EpQE3Ri6Q4vE!ftwV%jdqx@ZjO&3t
zE~vyPqUHZH3qUa596=$xU1IrG0~|YIv8Wqp7YQ(%oX-35H8?#zWPW}&M!w}IE&$cE
zN*{(17dfi*3|A?Y83_gZ&&dU81D&d2`!Ia?I^eysa!|zeZi1FWl#yi@Q&N=H9&+hF
z=Yf11hL~u5z0U^ncIKYJ6a3(*614}WIQ3V3WV%wLn*P`XOVCqCI>)i<zNO6lY^zx1
z{%2cUz_+b&YaaD|pSl<Rv2A>poI0{{Zcho9{#vAw+{<A<mzR_keA>+Eao{3ilLuEL
z?lB~{{dOYbqxoe;NM$oEpgQawK!-hW!XDWUSKljew+gJ`?oN&U;%Ufvh{`^y>t~eO
zlA^SRgsj<0E11jwcGWPqGo|Vkwl|Cp>WS?{t$!zoVd?+UkT~h55EUyJQvaVPtWQOY
z;YnANdsjnyWHn%+oVeRq6HUzE7OM+&7ir?W4NzxTwY?!ho)YMG5Fpv{*{JU653$%o
zmoLvyq%5QP@HFOo%1`K!SuXSw2!^Xx+ey}p8lU=dPYFfqJwtqm2T!`!UFOQO>Bo<C
z&eQ6?E-3Or%7BD(gNQ%F_wqe>h5$C7FcoP4Krq%g!}*uz8xB2pdAg@OU*PIha%gsM
zQCt&_#8PIpbyc&OxA4a(XfI-eQ_sg&B@$>iu437_1D(B=AA(RkN$YuJ$|bVhM}$3m
ziMF}PTbGuwpppH=m!0p-15$jN%KsgiQ1uTtBdb2mu9Y`*WF%K##P>t;d7mxKRw_4b
zt3ER}MLp~cH*8%taIEq+ahOQ@VZi54Mr#3j_wvPmCVC4NFWiDQAT7@N3@y$E)mLv3
z=Ohu+0*jDF77SdzOG18#z+=mU__BD%O%?RSH`S0{tjkZY$NT#>3X)(kKpPsT7K&zG
zj?+q+_jsSA($ZJUrFbes)w9$-Mirx+2AlG&E4<v@(*lG(nQ#e|^aK|lB}>QjFVXwT
zcQ6urPWW8Zt$^2;IE*~(#<$yB-Zlb$KSbbYHM1RhnBK@A6-{c(DN0tklppkru~O^1
zvHM(d^PLL3);$)=>ciIhWJCl<%s5ptS&5<hYIL+$3-zhzbVp_%-tFZ%816(+WV3A^
zJ<^X_m4ZJ)=)6E>G22QK529#>T&qw`HcD$f*O-Z7Q#fWNBrw2AMdkg;SxWZbONum>
zHTY#=&REK_UXOc<QSlh1s_T3u6GVV!6W!yKJ>Z=TAd^Jgm!QI0v{`$Zw8P6a+^Ocb
z61;)y)(6$Tw9t)>T*A|vx`gjz*npGYLH^$<%!$l)dKqC=I=I<Es6EsI;(9BGQeI`(
zlRpx|jIxZ-l1k_6!`H@Ry*(vyXiM<-9H4>RLNYpwQL_xAS=?T~Y-GR+#zZ?2)Rhg~
zRef~$9s1y=*e<)*(E8<KIz~7C*tUxm4G!Ga^BvMfC%Q8V66Rf}Lmod1#1QX|47xjL
zvraI~WPZFil=2P?o`b0LtOR1SMMiB%g?e04oL=CMH?WkPf&kwOEdM{I-ZHEWu89^+
z2<}oGin|4O2!#SIQrz8&7m90;;ts`KOK~k)+_ktAcQ5XcllQy#+~@wu-(+X+nOSRO
z&F=?%TSRLDYG#R{3CpuNc^0)xc;oXz9Biszk<nv`2%u9jkxXWU1V1ZxgMi6$388-_
z0$grk5q-#8-Oux^N7MOn#nOWmfbTBox!8zMtAiij%a)nI6ZjJU97o@4*DGapX2niL
zT*RI+LOyC9{RdZ<UdmKV>Azs^A*1<OO8`R=?sVi5<K8K2%a8!tq23=2Iwu`WlDlr8
z*#5N(u&J<0I5j$1|4qnh^~j%qv`dK8y~#U&z@lWVryJ@Wrt$(k6~Kl)^sys4zjQ7I
zD)5x2auH_E$KL<4&~xh3Xfq^l4qiZqcffpd-g2k&oWlj0TzxUh!Yj5>G|sMO>ZLPv
zP$B0-K#1d1yTKTG>x(!L0^Cpz(1H)7>Rv4W1>ffDn;^tZ89p)(K!3N6OR2#aEvr6)
z?pPAgRATN)hQ!WE669b0{O_?=vp1?)B`}=VYtsDZRI?<y&mLyQj#mFD_Fp7RdByi@
z1f9@ck}lt+=D+?BP(x|({qZQuxfli$`@Jsw%p{*>H{S4^+y1SCTH>_X60QI9ZyJE_
z`Qi8Gn?L`MR7<w$L-pdD-^D9-T331EDC8xRk~qcLG+~4eaJ%qk(@tmbskbISlrvpN
zD>4zseUwH7h&HuMwf!=|5e1A&;B>v{ZTW{AO(m0`+aE7~Tu7{>2Uz?8pY#R}Fww|e
zG;TWO`QL+34V6Cxx43KV1{$0Cm^*^pP{jmFFlkyy;Ma#r^Q%jhy$;b=T|)l<#bf-$
z1Ras;y?zFlb>XaB^3n)B!dH}GcaljrlB#fPJbRQx8Bs>Xnv@Lbg*KlMBffp*MTb$}
z&exk*fO3M{zu{g7-%*k9mK?9szl%@UKzM(y^6S59VF>|&vOcpk-3B)1y_q~lg&L7E
zB^f9qMKd?La*JJ{UNk=Nlh3EF)WAlADH3f=_a5!o$KtK*hHx%G9U~6f;~RGbgAVWB
zDFmmz^|q-sybVDKH2-uo(oFnxixw0(0AnmnH)H(|fU#KR@URf+2EndapoOflef&mB
zV${wL>I9kRnptFL+li^~HN5iYjj=w*{0a8=cGJsh9TVS3hTK5$=LA#1+LaV|D0k9B
z)lPP?@6N?=(E%(ZIhrZUxMmv+yGcIqE}i4tgC<C#9{yXBkF|N-4Wpj6u#!3z*-C*B
z@EJl4lT{-zPW4;=Y;q9Re*)%bbV4j3ETT&0IPnu<A+?Q1H!=VUMdpHQ<Q!d<IdUqa
z;TM75Bg2&#pK-Sd)VDaYur|Dq#yFgDP}CMs>`Y2GLDhj~(MA6u8E(`$l)3+qjNeFt
zz+6|r9@<`omIe4C08SGata`MaZJXm1jEGcsL-e5hVmj<P9nk%3Rn@+(JWv_zA?h#A
z_+)Bd5{gG;em*ez0tl}h@12RR!H(RotM$q0xJL0@A@`*1u<RD2Lxgk<W<>t0P01sl
z-8P+0_n4WAQ&c`|$NsEBP-#tQfg1NpTeWcNWDd7U(c6{(r2T%#_K$rxM~?4J=(<L=
zE?2RwCJ=Y3q&UPMMSjr-vH<?zf~y`YZ}I2C5SDKCeB@rjK+b{y53NOUk09UCb?2bI
zMn*J?x1JTr-s6Wc|AmSyOGC7pMUnr#O!uJ6A6EarBc9fOkPaf_>_yOKrTEOW3D>B3
z4m<cju`WMeSNR%7SA!k^Fo}^;u-DI#W41;LWCh9^k<r#*Y)!6to4ol7ht^|oWdz5I
z->x3JednmYfT3USu(~LIL5a>43V<p)AC*R)?QMwkkWWtSG5Hh$X}@2OILg63xdXI8
z3IJWls04$G{5npMOMIVT_2rkw1Oy1yEV1UaZ-;c2kek#>2O3EAG9e6f<1oVx(qQ>D
zeNbjHPa_iVwNZ;rI>5v-s*x~Fq8iv@jR0o~-L<stZWaj1%n?a7&%<M${|_)7WZ;To
ze#k4A{l3-w@YT%uVz1(UBYN#J`{F|dOnB5F)@_do=cFebpxKGc4%aO4%R>I`9iNao
zfSPGV<d&7e9N8p|4a>)!MNg`sb-g;);vm!)gaEo60Vsdcz!m*uqZ%o!4vFqY_Z}V+
zY-C@t0i)|+VBYaI)EzG;fO82%%)S_6i+bS1^JoljG9)D1;%&><R0*huX)U1-*{UYH
z@2~k?bSF%%SOWNZ#4w{DYm`ct_3~mrqgNmKln)yq&k1fH%v%0mU{m^bR%EDKnFy@v
zW<mSmn|ATOT5zV#ADqhp?YORBi@=e;V$W+(F-EJs9g~euNwXK@VkbVgCo8n`m4>Qb
z_i^xRZ55v1lzjc_^{G{4DPaJW>t}oZBkZJ+^kPc5BG3-v7&t4#ZwR0Ie|&oCud}4<
zxHEG`f$%&08d0110RjSKLz}!A$?B2fx$;aAAbbBJmK04dbLx=+*sj%a41AiW+K{h<
zp(B+6E-qM0N>eohV}7O8ox!I8X$*^M{G#8w#g(BH>><ksLC$W_d5bEvG9T_99&pMa
z37)Kj>Gpp&8OZTpoUr)Ez?-BU!Ii7t{&Bip7N{#TjKZId8TF2d-grz<#`G7x|7Gpc
zqiDoqZvR%%ZvW@EA;m50CBvLNop(RW7u}ILOm=2q-$%%fEuvNM?Hu!8VN-JE1%ON>
zN)^<PW}y7S#y_SF+lzIkgwKnJ6iZ5mQ^XuYYD=6qi^|rr2G+Ag5UWKnFd&`q^I5hN
zB0$VlDn<<}2otk6Ou!zL1-x;Srq|4yLkuve>Xo24c%>A|*(gXjB|OI)tVz@h5E4_r
z|2|R4=%S<|;>A#8_FrDYR2EB_h+^?S_9TC6@Y4c6hP$L7O${Y#=o&w$KV`GkuFtpS
z<=^~ouZvrj`bWu#-L{Y~p4Nu}p0{Ytj|0*5_@4JT0va|ru%CUuq@&$<WJypTf*oj3
zm*aA~U*NOi=u(W{7^D-$>C$lyVH>*w%trgQpnzW_Jkdzs?RWiZ40#lhB1YNrzXv9J
zZ0Et{j!Mjj$!}Zvk5Ui&lmV28qy@cG-*nSRzZkD`%vWD4jKkH|O<z7}rC0G)8?-Sf
z`+9dTVGl`ly2x0h*z>uP@K}mhUlzA`4apf1gZ_(!I+(?=#-TEE+zdQ728_@5{c|Pp
zJB<l}5OutWf#y=`s~vvU^F{qJUn*rM6lI2UQKhZ>P_mBkW9=x8%z2Hsue~2HW?P(3
z@YPYWMozMEb*m#i&1I0RbO0fF<xP8iZ7dj4re2)Z6mU51TioM=nR~Up2n2v26U7Yr
zy~_-2)EAyu08D_sHsBzw4JtPlExK;yk9fSeh^2B>F}KM$$NO7Bq^}jPlZM(4_=lt>
zIUo%5`*KfiS2<QcFy%~|P@NCGY@`OlhApP0Wb_5`zgT#~sd{>?dreJW7R!?GbDw7u
z1taNPnA1yl?Ay}P@YdeXo&MUUaCLd;J)Wq)_@Dc@wSQaxbzb)5g9-@N_UzA-34+J?
zo&%iFy4D^F^Ur#<w`1^F)!KbfrK;bO6Pv3)zBXF6!vfjfj9CNjQI)N(F#$`sR-4cA
z=m68xI`pTXV;mF7R=ku;3KvH292SRuIfGrE&fk~ov^$a`sDa@0e@D>(>_mWn81?iL
z8t|0~!e#?x_JVp|^Kw5pVTyiY_S#z9_Af0df)J)=CtQGhal~X9)wyK;cRJP&-mbc?
zXeTD95#@9QA{JSlbqk4omRWt87}VQp@ES=qo7GA||M-lGlKu;{DWIFn;Ko7T5pz$9
z*Om7PJ~{o(<fUfs3)O2dFTmHNB9*%*Rcsh!jH0<E`TWNoG=&Zi5^GK<T|<A=YLN#4
z`fC%IPJzEjvOJL_sTiZX{m%fnT6>Qt24UTKkQDmW|72@&_F==8>_7t|Fa;jvB08#^
zKyu}ZMz{6KN?Rj*+@Bu{^42GKa?2^tg}AC^6kr`7?xZ{g0wp(Ov3XU~blr6ohW%0z
z9JnN*BPuJJy0V;N7>Z?Zc2h+Aj|!%zJ6Zb1EHv*};?0>Qh9dGCgdSG$7#kWSg2#NJ
zs5h_|=a;cmxK39`#PM^O*4{C=>twY>xBdkudG{xD`$snZsL0Rf8uMtp54N_7(liHq
z*+HJiMQg}GXi19@5?+H1)Q(YyOs!3NpJ@FY3*>S?G63yFaM8&R0UC3|Q`lS+iz*)`
z87rVhYyM<a!M#)3PRoZWpr<|3c5sK0e)`m|wVyf`Ma$G(3;HoNa>o9SFbw48+RaAo
z4s!ZXY=wF*ey+p&pojLK!Ikn4KK}ST#ZU^$tVoQGa!roVC{UE|xnx57|4w-kBo^PV
z(rcM^MkZ)XiKRsHboda&@VZ5L_A(Dzcul(hoy#>ACH?7)z%N+H8rd%$XVG|Kt@{y%
z)cy_%+ryNv>*>(A@#&&JJJ-z$@cgvir1p|4gIZ=BXjiDXc@o0pVgA!t0Ag?$W{I8z
zeph+IB+PadAzk4NCFcZmdEe{{G~F}YR4mMDd`(;k-(ajgH=V|H+WrWe>f+_)<*-DR
zuc{gOM=61pnP<Zes!=u5-=L-lqj#@)v*ELm;Kj-OKgaTCOKUu<Un{U$<y`@5I(`B?
z$YXjY-`nbZyi4S(R)r984S~|Nuu@H1?N)r<_{zRna-aLT+sHmYA2j2^6`Y)4J`@|6
zyz3FY(40_?I8Kf^nE5#_MpOO7lRd<;mo;EqYu#_s9+aSgiaz=^f9u}SyY<p+T%-av
zDlmRg4tFts(Nx+!9IC=@0)?w2xNVZfz8==4_mFan1_FiIcnraaMHa_yvWabYLpIBj
z!6I#SX6sg*9Nz;&1HNzQp^4ODIz8_QJ74fb2Q8W|hJhTqZa<#$)e%v5^>u9*Y^1U$
zRfBor7Z?#5o4chrRFf4W;B%cCuW4|+{U6mG-9mbxt``g$_4JC#tX53juq8(8xrJT5
z{57-H`r^b!x!$J@(>Lp{qj7ek`gKjj*Wh(O*=v6Pi*)cK7lq0TY@^%vU{mr<kRFmX
zpxJahe6hvN!OJFed!7Ol;6?9(55+`xVOIE#Ui_e_+SRLXp1+CEHCC+6spnGPWRHVr
z$Tsq{P&g|(GKlTi;fmXa@n%B{vJ7lUq@h0U=?#Qu5z*ZN*M5M#uBskg<Ug*|ZzcH@
zze~NHKv*BTJU;@FZekd$;Mh_I1!q*mMyfXol*rI?LRs<PL@DW9g40G<Y&cBkMr(vb
z(3ru7qe<8E^=aq1;l5XUGq@L^;lp&{Gnp;^sq5xnT>{O}zrf*0@kKHCb~a+_lPi5=
zoej@B7G=rjYxLVLyMT8p<rJ^IN6wec-g7+MU`(8VwKgfbJx9!COM2uVG*`)H!~5Qx
zToX);$zao7q<}N+*9V4*Y=Z_Qz>@~#V`Lz5wHD*qAU3=@c%vYr-C@9w{W^=#K<1Qv
z-q<8DKof-|*Bq!4Pr7*cvB)9|5sQFd3g1Vn>VNL0C@q1<GJye((IlAQ;X>6(rjmsq
zUFg}CHIhZMCfu~0d&<Of#kbd*A-pir!D<2@w%XawI)L?eO<o}3ah+olKKn8Fjk&oa
zP9Cl``zWaCR-b8;h>;@I@pM)?HI$G8OGK6W5IG&rw~~F)LvWxidil{E3@CzxHhbpT
z3>`G#c}w}8OG#q^bk8oCNvnw>YI)Z~D|=6}>u)WPLhTALQjSF!KT7nE4fnjRyy&NB
zECL$}XsB^eL_#eC^qcZR6Gs6r`pK3700MZ%ISTk6g=Y^{J08uuY!E+qO2#v7hi?}_
zGo&96$R)b{9JT&(*VGp$5wN@fXe@=vg`)JEKjpuMk(+Rc3B~%Wbsj^ajDJ9)HO<JF
zs5{(x+L039sj%7T506yBzYK2(hkOA)n#utLAtf3(XT>6=2P3}SUL=t%e(Q_{F9D)8
zw>@{vq^Vx5IqZ6CZmN?``O4`QK&hE-?JxfV6+iXrO!x%uU5~%%#onKQix8c2+hdJf
zXck-@P`Kitd=*W6<C($w>Ay1+W%#XzBRvKFhfQeVMAps(PWABD1{pY_m>#;W@h#GP
zvD*g51*5fMoKHAK@@~0Oc((q+_EPTUpspO>X`6mCT=*FG<aHh=D4AV_&K(d5BQq<S
z(4eO|#PtGd1{(MN^vFdQ;q6#v1>C>d{HMwPw5X*9`<p|$fNgFE*RXw*OtGk8>-9yf
zxx{8$D*AT5org?)Rf4}*^A`yZ@Nve2Q*XvR1d~XTXH|#*a>-h0TZrd>8X-l+4>z;v
z;efiYR|jH7UKmEeVxo}jZ@(#VNp_CS01y6bBj(ZP$;%HiD>S$`Cj`XTVbflgYNKZ8
z+Ro8;Vk;jiiBnu~H=bvmyr}w8H~Eb$DSa(}z9aY@u6;{?Xh~+Yy+ckcNKfThw24FD
zHx=mjN@?i+gMAHVulzhB*+KuB3iU`QAXWkQZsc`Na+^Pz-(z*&vtz>!3&^iF<bn{C
z3<n=U%Hf9cK!|@Cy#9aQU7E&m;3YK&#U~!}k7dtc5&`JdnziV3d}TP{TKzyse#p0m
zl4@a3=dNosT(lwj{o*q6+7ahn@W@scKTsM(;==!y4@3EeOXf96TRGWi5lS<|@fL5j
zoZF7_SFwR4uN^ZAa_@^ibxbcdL_h-_&;XLB&0kPSY-NHE;)TU!<KdjG5KBu39~4EN
zqc<z*h&iU~hx%eQob|JOHhD&l#&h4FR9+P3A=7>m?WVH-_Y7Nl!WL2}V|`KQa>Jfk
zO>&7<j8$X|OQ(qoM~@CF2%v6lEodguUNtlf=_JuHMZ&C+iJ-*<7kyBi5T10MczJ}c
zRPi|aeN<Id<^9w6%m><eR;InFwOW1ldw+$X5kdP9+el8-YNbru4m07x;*-Bi|Fg1H
z@fG3tgdPR&nuTVId)tNgsVBv+DGkaq{>H1RS<)~@SFQZtkOex<oYSBm%|1@XY8bK3
zPJ#j*U#u@?y6YvDUH>TkJGIVh)Ia_?=WurXwq1Yq{3w@hz2EG`Sj`}OM>2fV^!jB#
zgWEs((Lo4>oH5e~r4s5Lbo=mRqhdDd`YANh%^?jnoIO37C=9VNZ*Xqp9MEjRZO=<#
zG9i{hnXU}udcQo(Pu<pm|7kL@g2HX-P-TI4_#qh|8KU>180>2{E>(9!`2!!yB=ni<
zcs@Xu0v&Fas;2;h2ABo4J){0txQqfXU`d1G93bR<iFqpSnMFh$QYuoudrSAzgqbmR
z^$0Ps;Z`peX_Vlo{G!jSw`?@*!tK}Er?83p1MA{kR&rmB)q}!EqW4OIBkMK4bhVO-
zob&LEC^P5A1}Se5-5lNyTHz>>4Q)x~<3c3dG^c+sL7rPYtq#=#lKq?_P0ft|p5Pd<
zsf!mpY6^OnmUSzPbDX9fHx5h8&LHfkZD_*9KRaNL`=Ol#h=hLLJLgh-j@MvHIsEn{
z6y&<`pRcg?+!Hg;BCLN-m|L(rkBmXchV!7J%C9$8_}Mx#$|RCRO4EVeiFu4A3+zaN
zeRFjOXSJ=!Y;UjA9i~UdE45PTFFk{-hR>@j?)BH-%~Vs93zdr@>R1a;BW<7a>lk-a
zRh14&xeO4xfdRh!e}Oe=oXb+SFGbfvy?A|V-d_kfbcA@p5v9X{U6`{>G&OG~t4jJW
zWm3yQR~a%;qrZxAow`bYv75{Y_mJub2*3+?y5fecnot?=ed{`XtOXK6?QQxZ*<_#O
ze5r>~^lJZA3C+VN&bkpBTC`K~nnd^9{uNIO7xTyxTk-F>Flcid5@ySVIOt!d(lE67
zeFe{3{su0kY$5z;otp7>3%N_GkR+b;kJ^Rl9so{y)D58IpAOHuCYB@3jiKL_@M{UU
zHB&=3X)$^+dS0H$Ci=cxCtQ3z`xiWmN)(GaMB(v^&?wM;xiw5Lfg(I90vy~s9QZ~K
z=*``iT0+@~!hFCK!a1jtbMQ6!HaMb_s%hl`raVPu)GtH4U>`d5JL*>1j14y&Ik2vd
zr*v(jZL&O;8Dl*uGgbP^N~tHC@msLl>rESid0P6T%o~4)?Luk3-Q<}0DOehs86!0j
zJN{Hd&iwErthO*z4etq7K9C+wNCMD=O(F+8&UNC+l>hJu8okOrk)j3;ck~|}$xzAJ
zscEpTuM~QU$>}mO?Mfryx}g5uc;c;ErlLZyOc$<-|A-+XnP`R5RZwQnnnhs^%ingr
zCy5Tx85ll$ht$QFGaSfgFZ%Qa_uVLgDUDSvtgw16;J)6C-=eMn6_E!K7<(h>v;iRr
zr%BU|4k4xkJtfav51Wf<r%}57oDD2>riyhXccs+sZz!x*&P4CUG#Ax^CG#73LsMJs
zbJyuI6Jbt1iy)JSAeJ<BQ5#ej1zSbr*!Hro%9we`wCk2yW8Ic<=zTEBz3Zlb{B3Nc
zgK7f+d5qlB@8UN#APBDu9tQOfgcq@qxfbCnR!4gjup>zYCf*x)HumY^0Z+h+MAKjC
zV~NmO+#;ZDg!WfztZhhTD=dY{bwTGJ56+%r(qVq8=Pp+yg!%=~<O6y2*YpD%Dv9>N
zBN-wXSI~Xu5YNLWhk(UC^P9<DO*XRM)1fu5S?)2;7=|~$dO2JxrdOyFd8r4?5N&)F
zTc1-*<8_TPJ|!{5;FLbj5rdo*3x$}Z7x973T^efNPpA27_>@#X#2c{G%`d(<R0mDA
zhEu#Z0c>C&>?P;r{N?${lsJJNo6hCZZ0~wefxleSlw{{%W0SvSR!V7xyOiFpv`n#e
z>)&p}wCaDQiHZhTrSW(9O1*nczGy!1k^E*6OPihhml$5vfaAW`O()u8pY)IM-U#<L
zAc`k~)gjg=f#uxW%t>8BB89KRzZ(8%oe~aihXL-`&Lp1)IUU>Q9`!!$;dU%w<K!T@
zc!orD{7o>IxIe??V#|8ezS%+JWzyr<&PHr_bS3WRiM~MR@}JEsFFLMDdH%ta=32?!
z*ty8>GJBrS=YN7Kqc?X5`)e1Ea8F;NUjGH3p(ZWSvhIa9nL~*M1UbDS|2{9P`!!{;
z)Jd#jJ|DfdK;5*KzjLD?o#DE^GpFYsJ?pb5AO+DPlZ-l^;($6^%sE9iI_N$(M(Z*x
zxHc%NxNW+i_oy{T*tfas^4r-SiF^0U+w$vpl*9~`5GJBn_5pnd+IbS-X@}FgnrJRZ
zQqsI*tr9lE3bdi4SKpzN>C--;6|BRO&jb10n7hJjFPl<$+S~zjF#|snHK!_9K^liQ
zY6L;Bw%XhLcj|md`0L;nR9u;e&}z(d9>$d}ikD&2>~4Dot$^(xKur)tIzK3O1w~lE
zpro9(BcU2WiF(L+{-@YSyqkdCr9t&>aKI5F5vFy`erUhIH4=J|<`{)Oq!4-M&#OAn
z1EK}AFc$;7^~H+exV~U&v*}CQ3`FY-jL#av!mZKa-_+sQtQW)U?1=nipR5`~)pL6I
zx2f9Jr2k2eJJWYO)@I>KV8!dD(af0IM1~sgB}_X_ohhccV+gRAZo+tParW=649rdf
zwN^WgB_qss|NP+bh#PDBOptr^FSIP%{Vi|mJh$`&CWO}MXgP1^dCPr=cI>fzX$A`i
zk!~@-Q@jHCAm5aKy~^{Dn%QXN8nz<TE_)Qo2m2}Oq~5kj7<7qDN3HS)JK)LW&Y#3r
z^|WXgi4x0<1?pUzl%m8oMX9dg(G?5QZRq{LwulXx=b^fk=}`sVWY6JCj1ojhp~j7d
zL=KeI*lBuswRmTs6y1Jy`z^$YJ4BDzEXgHKRn-b+Jkip5o{X?sK6V<hh(1@Di%hs5
z<cqF!+#0zE18-MXeEEiw{Mx;YVX_=*`z?mHMQKUJ7yL>t+(5MglXWYz^5nb;2HGO1
zTlI;h$VwyR$u~%7zQUH-GOsyLHNO6;JAuaP(rk?dw7lfMG4*TIof7%E)Pg&BUdx#s
z)#_H<(xQ9E=Ho8R{AWHJrL?t<S2(_JI50~E1YTHn@U=~I7ftX~0qbHOZPPQco5q9$
z^CzdISQU?!)K+eJ{F8<Z=&-YKgx*t~LE{l!xkw0Z{&E}T56ndRhm(aVD)ufOF;*Eo
z^}cmqt>meEuOU;8uYfF5-a5T0qz{|S<c__3I+%e4Y4p5I>cOa9GTHpe$*qeUin4&`
zf+tHQ4YT|TsEy2o<`CC>HLYwu^s$Z37N@UxSf^0|(%n6_00GpQsFX&R^!CQyv;zZ6
zEWbLCR++s{-vAV~o}DnZuS#I54>%(f&}T%J6uPgL+jB;%OvF^zVf-c#B0#$_m<6|K
zCo*n(fOWe7XE2AQO?DF+azL1rpPQ{{$?zlo4ER^;2fF)Js-BjkxLlW+0o-9|9m^w?
zG`ke-Z_jSbUm|BRS;agt_TPtrPtihdMnuDJ+ce(6j8E&><hK%+3+zm7jrwk$J=~Kf
ze@A&T=ztOOc=N4T03P!>#9$ZjFXyQOmhc!Vc6(5K<yk<5zVDrMHaEj3+T#8E-HTq0
z-dZMoBKd1Jx9M;BEvse2B^I=+WK7uC-iV$TwQmpya_opwDAd1_V~*c{ngoDtwXQ|!
z3$z4v30@{p^3BFZtG_rlG%T1-K?QcTHy>Pf;yd`lig_sq(z_yKc*t?Tv%C%IhoPSq
zD3Qkv6t?EfCVWMPc;nXME|;w_paJSB0c{{2w*#re`CZ_BSqN_MF?u<$P6?rFd}bC9
z(}<<=vVHaSYu=VKT>KWhAguXl<M@ITN+)U$&>A}~%h`<VKk6Jjk3^q-1Dr1;4pVv!
z#$C&L4pV3vW_J?0hL&g2(m!^O=ss6>`PiQRk{unaZHP7eT3>umot-XdE|#ou-S0~J
zeFBUt|5DCJ)sMiB?O<6}zPM(woNBwGHUR(w>V6#Z+uEtn6Kfql(3#O{Xc^`le|Ekq
zV0q71+OCe(<pr$c76*Su5%ax%bGqiimxpXJLCBI?{452b-F=CXl!NO+Hea{X>a3K!
z7d-Lhs%65J$3>uc`EtJj<TD+s2`I066_%3bEe^!$O@BQ46#BO*16WA+`1qrye0kUf
z75r;-#VV3mMVILn<$#zYo$?I~h1;?blibqV7Wip$k2U${<;alhmXAW5TiLD8e1_2P
z#=_0)PZl13rPyC^+mW@7@os&~IluUFD4Pl+Rt1cfxRn8Qkh-8t%t+_dPW?VqUo`tY
zSW~iO8{QBNj$sxlbPsO-<FWLVh#_0le8Y-xTQn+%{}1mAVmmG@SMs0O2+K|u<-oG=
z!zYIDakM`$c?XjQT@_>P6B%P;j40T`KfB_Lfjqu~(GQATIuC;xh{GzHde0icFwA4Q
z`p=595in47$!x8vRTB=;jgQN{u{A07-UobEMZXUi$PhP_>v{iD9&L7@NgM#fxp98A
z*FVyc_@nFUR)9Wf?*u0s1tFLmgO{IN;2*6A-7G~J4Mrk}Fs?tGBV2(gmX!BJ4ujL_
zGNIgb*PxWi74A+f>C8*)3Kma8P|vfHFn+@dyws<>8K*;gM4-x><7ZYh@YllO*(iG-
zBWSlk9vAiyb7Zup^2IA5<$3Tj2vc-3SZXiPE9ocVg`7w~j5@(-P=jpgg$sKp@doBp
zCg1p!duy}xhqkgT$HBpWvOeocPst>y7fnE<e@^diZU$%chYc|~=Z3v9Mm{phd^P;d
zxC55bDF2{+7+DJ*JQ(6Gs<1$Ygo@&!=#894mIDj=o@b$a+gZe7O(e(}?wFXBH5QEI
zol)}=wWryrPPuOb4xs8xv1gpGpF;y~Ud!%{C9U}?8Y0F$V+Uhye;AJHmmlB2aoUw<
zh16xPo2Y1SDS5TkU8g-ud$R}aT6ahk&Fex~;pdWy2e2<qLVch0cT&sk2R5mrpYj5`
z|5Vp9YDQ;5fq65>0(9)>EW=3UPMQWB9<G};mGJI$7tg>~KbM0`VLy>F^LM?Z2=xw)
z!`>w+T7t8Hzl*HkKSn;BABw|8bL{y6ciw*7zHC-wM2gHsftD)jh!_fhx+x`fyWGWF
zWyE$JQ_eJ(x5+8VCWJ#EDQ!<TG|Kv(z7o2}T+<p?gDSjdaB%tdBZ)iM!CrD&Hf$1^
zwv^27PakYxJN+@UA7(CxS)@C|)NQ3m3<YAT*-Azjel2_YX0HzPX(+_57T-OCE_-|=
zhZEQ9bDJf@CvF1vpH7(3^txR3B=pPrS6V0)uTDdLE4{V=ls1Y2i+Zwvzjt_vpa<72
zSNJTYQ$1!N+d9cV{4ITMb1khSl^9^-V4X7~xlJT3?hp~8XH~5<nMViwkt~A2fU>lu
za@`g3L2LZ*j@N9kT*rAr<9)6ntd8}OD*Uxyp+wz?g(zH%#aT7Ij-(&9oJCy9a-Mq_
zEAvl&!4bj}c+G6n3jkBN=k9am=>&QLvS=5Z_2wY_u`#H%J9B#vsOWsA)<%Pry5-1D
zBG!XB(ym8uq9gg>>zEO@b|6Hzgp_$QZRWS)1rJ&zB&p*;t6^0Z<$j@65oS%qG+k#<
ziaY3pD?N-G8K(OFo&-E_0HrK==?W?)sIo@Z-ZxA*s}-nf>HhTZA3DeDB+)QSm<kum
zSg}INI1W2Ie_jD0EbN}W>_(EQNZo$YX6{F?KqX1QuM7_Ios`geHAn6uz&7X`D`M#s
z!jM{15G_g(fI6tVXKT;?8o4HaaBfa;s>I<b$QHo278q^#KH83=9eCen{XR3->`^QH
z3TME6_&WkCyy^F&ot>RltBvg`!QZtIKvdcf>R-=Yuc%z3Q^VIGKS4||8<B5>v~j?<
zD$9A(oY6K;HiBX6M`fv9Knjr=<-f5`vu$S~Nid6~Cn|E7QYK#zBdxHy+>x=P012pA
zB>LVsOy8qOB(CPB^F%wg;p1zZXk3Xu7yK;GEs_#6USyj50U3R=U!w82D!Pyi+DfA%
zuRyIA_F5pP6mEW2Y6QK~6_KchkDFG*e|6A3+$*iG)W3lsZIv$NtEds=LfbTioEh9A
zo!fkJc5l`IluqH<m~sL8>6ZI+?G@!S^TmZ9#NKAckxq|Y>N-RppcoArim%s}t<g-e
zk&_R7X;4R%NJxU6Q#G-WqYu6sdtLa}?RLE?s*7F;N-Z1nKjm`Y#}PW_cLCIqgw|P%
zT1X@GrhoLwqv0<AhV?P{A#C)3LYgYsuX&yoT5i?HpVzOZkjhvgqFI%;fY{O|w?Y3h
z5q)wM5I})nI3B~hN`4OT$X$i!hpbGFNEVLg(3p9hd>Mm}oSUshk|<D1My=l$jn_@b
zIr0&4aihAS2(HUy8f<RxQqB?jn)@=gr2oU*gmh3oE3cL;sQXBlWa=#C@YDe-1!v~~
z%8oP?+S3O;4^Y#qgYTz$`~te@{P-+hQ6;C}yFrAGq4fNv@ERX>CHiAk+g|*B^Xa3)
z3kyppMaQueKZM!UT<9|>%x9D#JeIgURTHq(yu7mm`8+ZAC-!#@``!*j@!BPT?Jt7N
z2*8?}TZ<bDp**wM>=dUh9)Vr7I_=U$q^$@JF%JqXL=Yt8w+3R#-kHl%ll@SIO|mH&
z^H#ugpL6q4^suCo25U<nEsDb=*6iNWg^*s_<HKA`N}`CA3xU#M5W=57WiM!IbkuAG
z0$D(w(Z)FF`mo*?uG2o)O3}p9FBGik{Ys=%F<-q4zK-(N>RM5giY?ojRP<=Xezq9~
zUIh`_Kef!|KZln$`WwnHg@-7gE8Px;#zMcE_7d?g7bxS9mIb3wM}5WBSuMiz-B$cz
z5-`N)tb?sY(qq;P8P*b1s`NAaD~fB9I=_qYIZ>Qz;aiFcx}zwlbCrN3Gg|;GE<0e0
zs;60jrNkcl+R_-Iw?f8!;tf(DtY^?Ao_uN%#@6#%qUBQ)Wa1vT5m)N#hDL9}s+_*T
z`sYNt0g&=U$1SM;16()xzWDpEWyz!;>GmPvMhoWr5GVSY4%X)K)|}*)gV5sLXQ9R#
zGHP<aNlKlEFRNYw8OIGfkgt%sEoS7mQjCy=J56vww%EJ1qH*?os-C#9;rbcEdeK6J
zO8}uQfY9KAOB&DQ7}gWyn;}ZDwCjn@Lli!p+)Alq;~o9E07iM*%#W$`Iy?+rd+u9)
z;rcJbVGzo)9Xb_llhj5AtG(}ZEYC<0X2k#5o4jDC^YZi@`Rsd5#dqOR!~in+vhvWe
zVgL<5H`4?m$_2$9cm(5vuGB|aOTmHwAbED}knmr0mlG76+&n*&IFvcS#)-?5$0zJJ
zr#txwmTpOoh_1ldqsNITB5AC=ew&TLXC)bpE@j_7BP*INKacaS4nD7ERNU`XK&#ml
z>PH*uhfmR`=#oXPTJ{tfzVKbYrH_h@scY*FoUi+%X~3Zr+Fqf@f%23@I%8tmY!-oX
zi!wL08F}&w)ABZ>#@9O*pRcRJREO9<#vS!|0MjSA{3<@D<z;IkX8--~-)J927MDnz
zmeUYgO=R~Y>uXgpdh*-A81BNtf0l869TXtYQhd$*X`<AP2_J&$JDqj>Gfr{zTkqd~
zWrvPobthxZWLf$H!KID$`h?Rs1#WmcuPNptC6_ZjJY7RbG59*kHim-^aNQ1kKki5p
z(nQhwju-u+vnnzi7mTg+@@Ec5I~*o>@+IHJZEqUYNYO&!l8OrRRTi@<Z#Qb+y>Zlp
zAG6I|wk(m`tQ<xi&3g>9^w!dQQPq<bP*6Y);J$9sglXDTUM&ix`o(@wp(Z@okPnYP
zC~rD={Q&mVb+PHhz7eVxsOM$`@HUb+ok)G9)|o4m=9x>46cWZok(r)E7IA7lL3TcK
zuhjh4)Y_p?yy{=`Tgf>;nDdXN!w#W_z(=cAej|z@5k#GkWROS8dzVQN&Bo7p@I0S_
z3;zR7Trv1Pxt1xX`X_xXB?+4w=JqW%@`_5B?%kv!MBoh<(fd@cT%}zQ%DdD2dXFwa
z^|Fn!YHtgj2EI4HmIZsX_+PJv#&=Y5>PuO6!)8)|P7;1k$hLNiiYHhqJV@qpPx4aV
z%;_J!`z!^JzfE`@4F$l22{P^ZkX=Qx8hqCAM4T_}O=!20J2NQ4SJ~YL0=%7Ohd&;V
zKN4vDHf~F45@$9U;mnSJsI-3g2nL9Esjp=4AnL%@JHJq62opx7!L8EODQAYv{di9x
zNjt_}$EH`^SQAlNP2u(G%-zo1TKP2zD^ci`(~`l<bv4qm%LoOVT)u5m3f4(*MSpwq
zzE@L_%PngjO1J8UPtTfWDEZYv#&({M!)6p9kJAI})qkS@0M=uZ24Io*^(a>G)ocTp
zp-;XQLSNe2jpZE108Z?WaIs{)!nCwskneBhvHK{*$j*kOzf#{bc!0Hh8<9D`+`L~X
zzX{{0{`XZ?LsAE;#>5PmOkRLsRTyZc(G?!Wiw!)hcloSbGA+@c)`}S|fb&uLwRg)Z
zlSU|h4&3mr%ii-S44jLj4MDrjahmDoMeTP~YuJ%wpBuXFVV$zXDEX6y7CHoFPcU7O
z#37eLz~wb)960Vwm~-nw-#JDrv0QdI{H3Ii91vJHcj~QaQ&E=k5f_L0OL(A8KgvgJ
zX`kL{bTXn@(Ry@h^6ft^;6xn3GkU1ptu$I9AsB%FNkZ?-yt(aCIY-sPI{A~tWK!^m
zVS|&JsT_k?!q+ThRYZjJpn#8zQai-s!S_^N!mWgi0w-1_jIeH<nb16M^QQ7PDlmD@
zqtAmc{d*ry`Y)4yDql!f<KO^9`dV`CX43M<TsbEoaLSL^YDi<dGe#)ZkN26c!gF-L
zQIa6*w2Q#qis{txP$_A~#)Y|(6kszDEJx@ue*7I{N<CMXg#O}lkq+5fXKs{ZYfZs+
zAs-(#rw5T!D<xJ>ECG#tQ#a+ged-RR(A2nlI1unouJ&k7@87>>u)nC@TzBQTO)y#B
zj8GC)pJT=neR2eqXF-XpOu$?Oq5PAm-7+Gs*USBpuYU2{0;_p`m(I8%Yw4sWy{Ywb
z$*OF@zej`Q6TH9e9ByY&+A8~D_Aj|u+i`|4t54)gE_;fC&98x^){7w3LuXufO7pzI
z5lkqr?*mB`%<_=I=0^6waHgq<AJkPd>@XL{awe<Gnu)Cv1=hJ1mr(BNxw}b;dQzh*
z1vOg~a_41Gl;$T0*sqdbBLiY5X!{UJ$So=w)+z@z)}L+$w`-`%Y<=V24=wB9x=!u<
zs1*b#AjsgMS|A|!-*V>)WrSiMVZ1JP0cvg}6JaX7{<!49RZELP4my|f6*`oHM&xGg
zwcOYFGp7x^@h#-80t_(Kn(+3EBaA#?$f`C92QXX*aX9&S)`8eYQRq2FXj_n1<NPIT
zt`mj^zZN&<Q&PZSx}={xhvwg+M7$b<Fzy(9C~X&KAb~95pPO#>!1l+_ERbJ>u|6-a
zkEdl4i3~=z-}}|VncHOaF}c<IK)98UxNfHB)T}0)N|aOS6hojnBpAE_g<fW+|0lat
z7Y<ri;)D8!k-*c$+R}tQ<qUclnvpfVh?tcb%d!rJhon|{wSz4+&TPI_|Dh{>Ie^EI
zbtDC*&V*TrkvhTDUsy<If4<;~c$iizv;{9{KzUW(Q6y0aSOEk?C*?Dx4N{1HOy>aO
zQ#!Y`#IWMZxq&15K)zQIG-m2Y<MukJoC&o6@|Xb3<wvh_uKl`Pqh_Ot`o&>4mcsi&
zYBXkSrw+VP+QL4`=?G?>%Aijt5aoc;eb+Le=Ovyhu&~e2AO|0Daikq55yqYd+SAK5
zDcN>_Tk%>f-D-Gjj<p=`?t9^R4SgAUn3r9q8|HWW53k!{9e2D7Mi4KC;-i%xD8@g1
zbNwczj0%8l^`TWhP7L&ianq>+#}ZBpY}32i%e(;0@0HH`E?=cJiz|Iuqk$-h5t<Y<
zeR&r?Z!*O5<E!-k$W^BGk1y@v52ds-O=?V6{g!i81tz?SFhtmPFvi=Jne{`^uzv7*
z|2<e}S<iG1^H}RW9%>OULi-~Xzi<2_ib73Qbs1S^V-MgQ60qoWH{U80M_Oq;*sz}e
zYbuuC(D0<(zl_!OGS?oS&~AmH6(Ubt5_6s$B@VNu{i=6*k<Q~QJkG`bA@8BN-Rb^N
zT0egGwdk(svNhTSP-KIXL+>$nWvdvV){N-RtrvwSQ7;t?-&_rdIjA8EKvNco$kxTY
zofnZWX>iRE13W4!P?Y3L#0fkcGPP~c57`E!o8uDJ(EcbyzD2~f4Zs%aQ_i66iVCxo
zf88E|*XP7lwbzN&IpOpu1U;bg&&~eLHnqXuvAt@iyR_`ESLo@jm90HLn6=xkp5Xzf
z%^iB%it)4ASW**d8HnU#uHgr8Q>4W1m&d+YN5D*e_p9?md6R~l7+s8qnZ5I+zQxs?
z*vCpNNBw?;p)j}F%t9~1moT1|$$udiOS5LJ7DO^K%qRG1erf=6hfuP-;wo-jLfo<M
zwy33LKr<b~u<i!(F`DoWZwDv*oe17ez;K|eEx>AEkp!GcQs;Od4kC>Kl$W7H?)N9Y
zMOEsW2KCOvUT?dWG;m)wd@c$f{MHx8{QvERsKe@Zz)2WkFO>WZREA!MYQ0BPJJpo6
zBxM2+bOHtzzVthU1lV^*-P;!y_4CNOxu13^e2*BJ-{+4SXFv1deMXDcKsUL}f7ck4
zB)H<S3K<DB#Y}B&ZH*T6pK4l&P{|34%{s}TV5agKxq95LLnRGh=00Uy+b7-<X)xnQ
z3(D*;@y4sL73DG!4Nw%6ozCF+wG;;6{TYmMTgXBn+g-iVTqY}tyoo~(o5Bge6_OF1
zf2Uz7*6(7-kO=c_W@<}<)o?6eu@R}|zUsUjJMfsC|3H2<jlfiR*P9Gpe;3q>kF8j}
zYw#Oslaja40u$8bG~%%Dub@-%_mLC(V6p;?eU)F~xV_Deq!XlbojQRn57arya*#MU
zbI198H>I@*L=+V-VE?!|3z#w+;nRQO1+^!YWM*r|{Zs`G603Epg?|iw?}GA14S<DL
ztHgw;)9)@34MSHzr?K6WDr9RPvESd3lml%+SATN0O~p2H3d&u8FmDHfD_!eEm}9^z
z8Cb(mU)+~C(zRSIV;2?@o>hb}V!|~>wTa)v#Ckn*QVxen_LpC<z$G`6(Pn^?FxUlA
z5#Vnz`a#7NvPUvPpYtEYA^=Fl9(Z(INoP@fv(V@%T=JV752tGe!C8b6XcVK6<vN^3
z!K|m)Vs;vrJAOB)7Bsm_t>mYW?b<zC5UZ!t$@&%K+C}3&jS5UrY{7N1qmhHn*xO(K
z8{C31-oHLAuIHdc=38%%I|-ReazAxa(83@6Yb}NeBXR6tjnxf<hQv_(H42_eGFkYm
zFhQZjIgX&#6SnG@vB2ETC!>Eg{Jv=)JT2dVs0|-wqN*$53oZ!bD}5z&I8{(j&HIsV
zAeR1pg~pgHUAry_YVh4A&#4^c%1rN)&Q@H)V{=g%QMMM*LwfNDYber!6k?IpV>axr
zNY~2=Pt$HiXSIAvUi}Rw%^EREdX-eQ>$o-QtGvtv;q>UPvx89n)#YuPjXXjt5hk*h
z{`@JbePa^Qi;-w{DaUd7@v-0a8usx4G(G1zi~}|pM+VV0Y<Uxy>bf4Bdh8E2-JdrN
zLQ_@~f5mosuK$3epiRL?{Db~T`nF~bei_Y`6Z7ViLrVN|#jjvwS7#FaY#k;>@K~pq
z0`RQUxrQtzR`_XIk0i<@6Dx!?ow4Foa*JNGj0|x4b%(r;Gt`<Tj`TE+Yo-^U;uFo;
znV2QE-@eycuwd6T%X<y<U`Qq0nN@oK=U534*t0Xl{b)5czPmT_?WbD2+YS_0y}~;|
zsf68ZGY(^!I`ribI5gbR`>rcR61{LG?Te9O^kr6e#z(S7r@-QEXB|WM_L%h?&-=jL
zv@0~CC;h%gmOp;yanKpSu1|-BkRchq#vEz_63Xv`<HsFE!sBA=XPVe|{5?l{e*s+L
z<M)<BOn6l4l+e4DhT)~NfsYK-OB*|oZBUXrapYS>HM)DUz=cmn%e5QDG=iJ?|Gu_i
zmS-e@zFH4hd-@|{v?0`m$^MeJXmF2k2&Dtic6z=wOV(k4ZH__D-Zp3U6THQ(Or6)?
z7aP9bk+hHEwp_t&_1^6dO@pOX)I4fWv?KBPw0dIt<I1bo2s~5SJXGy@`WINtCOcyS
zg3VlV{k~@$O)MjG_M&T1%?Q7-P*uw@(OfqWmmkOL%5oA|La??CaQSTdz3=g(^2Z)8
z;Oq`W>c|n!I6MjDuW#Zu1#9V8H<Cp>AQD`&0PpX8{$>Bs>&s~~IDJs$lbI|Dxf&a6
zFyXG`*b8Qlwzj*Od1|ZEex7uAp5E6|@n=D3tJPCy%X;~)4a<s{Dt%gjrwT^{p%!tz
zi>LMCc>NAGE;h1oYI@I=o2Wl2p=4=p+8%1JpAyU}P*CkhIe`bZv<KoNX_kg9l2hy3
z19keeH4Wu5;XiW)D}c}pDBoXL8;3R~zY#1J7^<}BFq!vHPrL{am5)61J_S+<26ZJ>
zF(U-JLb^~2ByFCV$+$5SKE_}IM*k+<3gW(0t0yOy-C4cBYU|%FH?Oa}#4*@;d3pWx
z{{2?6iSqH)Yi96|B{7%m81&0$zcIpl@Ruxqg2969KO*Iab?}OFdJc1kyR=g3HtA)d
zi|lwj@x0N@U+-s_s=h*{!$ycyD%ol9K+<JiX2AW5%PE9R2f2KTy&h=;K>E+GU5OHd
z_4j9E9cApk_rcuf<)YGgl!A^icchbp=b3W=b-BH%MVb~$k9u^74AMz}^hps35F6I!
z*{xAW^AIOM;MRd(vNS(~3)42ED9!<HXf#&a+ZVZ$h-MQ0dY&BLWe#1{H*@zBq1^VE
z=zh1!)?^eC4Gj%&wtp~g%qhhyOB1Sm^>ch^SpN*=%La$<8S<n6hq65v{9ATU)Mtq~
z1Ca`)Y8Hv8Unx@}Cd0d1T>tTdG!5#9i2{;94okJUN7QJj^eEE>2q}4$X%x|FfbyJT
zyqEjlYKesX{1pSy%GsYl&%F9KkVT-5-y3H!UDTQz=m%#Sjx_P&@@8EhpgiEa2za^9
zk-sck;WCA|n|;amvyVF?%-Osj+J8yv`r6a7str52gA%pE<o6q$){(cMvo}xA$Md<E
z9yYBxlRC%&z#Gle*UBwNhX$OWH`I>CjZZ(+sJ9=s&}Ht(a#A(b0N58^Cp)^!^)QlX
z(^?)=!Qw3RMD#GzbziqXfyzOg{F|r$R|_D*f6%3Yk|ht>3F7;c&}x9kIl16>=b{w~
z0({6_*d8~Aoc~P{K9|fj(hH&P-go4C81Idev*`tF*yXL>=X}`bP!aVc7?@7WDDjiW
ziZ>P_M|O9w#*o*IaZ7CJgHT8CrUB-9A2vn)Q}yKo1&qA+)W$_YmKPw*+gYpcDDuE}
zlN-_nkq%M|xHlgy+ndH`5<gGxX3gwoo3xL>J_v5C$e@tV%o39Nz@o)tm7kKNbnTX_
z7N|Y&K!9PR^8T|4e(ZFb152ix5>XpzPyn$E^y1kD^^;lRbC@=4NI;H*Y3rS*Hzt}^
z<-cB?-}(JRrHHnB@1;s2VSj5MI}eYF`5Z6lgLfr~1SzgyW1{!S&a__PpAh`Ff4196
zNGxxEN$f%2`X+m%w^6<NqHuYC>=4X_JQZ1wsV8^dbvnf#HFB7k&i<CE?B~y6bUHo(
z<dt>@u10<VbNf6|fb>t2l(C5(K#mBe+Fde@c)!mZ;^o7wL*Vm+p%4*30SG5sMd-j3
z$nNgmpLX4(G2=kD*T)^nJ#B`4W<*@EEaN4OFArjHW=|8qTj?~kKGn-=J+4#^<|Zjh
zr3g$|eWi_gpenhbphLdi$XaI<f3r8;AenuE37Hss@)+ev{v;0~?jZ_zzkq9gSEPe0
zw#SjR@z?>q!et$+C#aSnCr?oQq%VB8lg`qfx(d9b5|Ki|&JF6M<OS%EI(^MESQPuF
z4x)eh&3(?9jrIvCn_jaS#P~!PzJG{kQhOEPzsu)$N#b(Rc@lUJrE=ViU_c5P{CFN`
zIA3P>y9}}GNJ;3?n30GSvx`!&`rXhvybVl*tZU0(-uS!Azpe?iF&&CXM7oc@w{l;#
z?Zqg<j@0zt5AXt_b1H3M(mM%u4xp6534rxC$-aG)?Q}2oNSkp6zqxWD5$fu9yxC~h
zE=@CSRE}t1zzUBKXArwmEafOJ$?eYf3<^}+fVzSS!pIbgQl^_oA9&jyZ5M0ldt4ZC
z@|!?o0bDO4LFsEnr96TPJq4{Pyq8$H%ks^8B6^sx>fD;MPG|2H)Ezd;*G2}9pE;rt
zRfcY=+P$47+uzlz>CoxO#c#7#xCwUc?s9JvuT;g|(_7bFWTx|Wr;B{BhdB0g5|KFr
zH~`fKZWJb^cQfG~rYoWCNWstgxnwfEPc0gPe9FXGhnRp#;^U?hnlE<X*0<;J9}^}i
zq9G$%oQza~4&2C^&DK*z6FU$wU{q-Uqe+A`np^-{G37u#hE=ex)nR&V%|Q!ZIrKgU
zC1rB}W9wO;?pd#K-~p@exES8&pmUdN1OG%&kKZq<_B%vwejyF&Su(j_sLA|p+x*%e
z1?)Y_wK%+cV3Q0Q;=79aP(3~->qQm^`?1wXBeD^aPYT%13$JTAArd0Vw}ApQ0mN1S
z9m@D&ML;>w{X{~Z=~Fg_qD2L=$tM83cvI>~Mo2yju0Z~iYR^41+w|e&ha`fc@1y4T
zsTER_l<^AKQu2J-Gt=7mbhyNq7M-y#_Al#;8$a&c_1a*TW|vgs=U*NxY(nQG32fy>
zl&Qr!ss0LiM*LKTE#uu(ufoU)kJ;~2`7t4DJ6x1<WgF`X!6}I12(D^?C@H+-JM-YK
zPsWR>a23F^GJp<Y{BTHm>fWB#qvw?)7*N3kGP&((&;a3*)G+K5{&XiH+p|YyP6XLl
zhdb2aZb%6FUFwuE|AP-P2C7;~C%YHn?cc*L^!#kGqT&ziQm;}P@tzXyKQC|}??|RI
zzV6#Y&E>8OMduAr%&Na|+`?U5BM?78{HSBo-d>VMs(a<WykJhh%&eUH<!pouIUv8W
zabBXRVRZ0By1L8bUECj3XqK}!76J|W<8Vg)klKD8G6~4aTZJsv;`Z$c;0-3LW=0^I
z;tjG2T`G6{p{fo7?^`_JkLaOePnraZQV@D=k_@7SBBH`Xu599{Oy}elbpEAjVKZh6
zJU#%qZi56q9KEN9nf@OD?m!X0sfAf_xm?5vfHFn@&vP(R@X*)3cpa4u7-%s31Ku9E
z{hfTptf?^_v$NZuN8WC0EBa$h6{P7+ap;-p(=uuNP1RCc^?y*`IV9x|0|Nk2c7h5U
z1kRXHhzNm*{f*vOU0t2gZh<bS0k-ZsK$YjJF<+ruAeAO@UH~=aviYQuAZWW+tDF4z
zO&l&H2b$gK4#<;MrZZsO8!e8cGXhLV`ylzxyqR$S(_5W)yfiv({f?f^LArjgR?D4V
z`|Eg4_#GBTxZA+s?`X2TIMc-c?Z^na@}gOE`DM!uqJK1znJ+f{<M7Ms0>-l05uITC
z0_#cTXVU6-GA`p^s77WL1HcWfKK|~X6t{PqZP*I@;t`a%A|saeeK!oGx#J3mt<f7A
z8Zy=vKur!*Q%{?>9{`2rZUG63s}H0AqtN?x>XgL6*|lcl<i}^V$qxkof~m#iVuPGu
zVKsnA4y2(Wwuwf7#s3q>4yWNmERz5D5O$Wu|Ir4XG4}h8J|BCFSpR?gY&&f{V4eJj
z{r@wi_@QnY)USl@z2npH>_cEM76)hr>K0DAq?~;Z3mFs1jCNfVTN`o<V8QpU-QMtQ
z6t`u>rCG-S^j-AxCb{|452<XrEESDG=SZ9sfcsrhp@aVY3&SW6tJ3P~nv70R!x_!q
z{ooUH+#q3PA6hLrP%^r+aq{D5noNK)q%YG)<<ZCioymdN5K|-vO2$VL&tL?6ejhDa
zFoW!Q5Sw>{1k-9OjKtLyXaq#a*zZmHe78qLa{%J&*Ecs(Te~?UpJ~Z|d@#7YYt1Se
zK4vtgcm4bhApIVq<1fU`^MY6ZP&=Yh+Yh8G4ze|2R+X${0Ql=XxB2=Pl=ikaZ6jF<
z5HxB_&}Z|*An<}&rSz4R{UHhTsj7ekJu2bVa&n-}+xJsFk^=>z0&;R7Fi|d8-6t|A
zkTwBoEetaOGUJtBV5ci}$$@zF&r+C7_QuefFShB8fQ+$FT*S$LApU3HRAYe(O=0W*
zP|1I^KF?b&VfuXFqA30c>t_K3Gt6s4B>&;nKT7~Jp|rU@bm`J*^r`Ew=q~zK4gWqM
zrG6LaH6#OZC^jtYu=;=2xoX4Pai}iss>qD59wlt6SL2&C9(+*A8|Sw5fsd}N=Mtl=
zEP~59W$<@y8cfqh<*U&FGu17P1A!dp<Uj|G1>FI$V#w_Wdx|0PX8?LS0fIGO4mALa
zH?_jJXNnP%_ReCPc?hunfB4`5G=2>1j371ZTF@VTocss=|Ga$Em!9@{eO+ez#`<v$
zkB?K89=QKmtFAL8`d>iwUrgV;`!i&B!3bC{`e$7~axN$*;%E5B*vVd{4npLgn8BS5
z$Fh<E;1A;(yXIr1z2$Lf)HN6dIXJ>Bc4A7vAjnC-_~LNNg}AM<vPyMJ%f!{F7s-L%
z{cvm09T0fgTtt1Q0zTtJ7Xy~Y391LH9?sCXU}6CcD(mF*Sq;GA!A!(G1~kPjDMEn9
z$l~*-Q*J?icZL&7ZpB?0O#TC+WbE_&&RV~Z$NQVrudf%bYai@xrrIX+RKy(jKU0$b
zaMGo_KYtaCnlK*8e!90uKJg-~9f5ru4F4EHi7o$S`Qe;vH|^9znoavz%K-34vbFC1
ziDK)2#@>HH!leMJDgc)0_g*s)y6AQ_Sx_btBIbHGARa(lgO(gf4yXYf1zkDrNJoKj
zg3>0x9`a)>c`Yw-Knl<q6_AO)NDdU~hY{Dsf&fdHIQh@QIa30}-B<||9~MC)1#lM$
zK%Dx$`Z(j5GQNZEH$V2(O%1vuU3b~{KNFJwxZ7d%f8nfv=)c`S{8`*zvx%r`ePF@T
zwTUtPvctewZkPALg5%dQRgfV!Wi<mJjk)uL;%WW~4ZRG$x^Npyq#hd|oPE^4gOtJZ
z#urd+ZJkPtGK~q~$zcEC<8<UWTxitnfKZ=slBK+U+``DZwQ+)q=j6w4pw*An&84uv
z&=-*$NRNitk2eA=?d#vSjHXT;4N<>QwTO<%dVdc8%gg+D_Is_*^EQ%#XWOBIsHySN
zx(pZpvvKl>!DaNX_k0$je;EE6MgPdRARqld9FK#P64(YcH!Ng)P+GaUIuf`u^_r|^
z0QjSvJG1VOid^)uZRjO&>mXe}cIPPPWFUnwPW#oDhf_(ujn1AumvOFX-1%Et-SqB9
zPy@gyP%WGss1H^=p$3?7g6f2&D_pVuGS-iJIQrV+$pzh#1Bs}Bv4Sk_3x@#bo>;PA
zIu-XR#(IJ~xvucw;k@&Whe1VxV@G#7>RppQAF>YPn8Pc4a;TM#o^zYt#)f|^0Z8W(
zp!EuU^DCdC!6QdO^lxCgfVmp*2m1fGU=A>XZhtSk+DAT<&e+7`-Ljqm7&QCAR)1U7
zca*aEUa4SkXd)IdqQ;Tdd7~e(0p^`oOy7l3V0*h;RR!3BEM@0a>A$yr(=OOD1(O5e
zb)}MtLGhYy(lbs_*099ZU}OD;T9_Xh($_`v5RgeLA}XMUgxJO#0T%y<P5#q-kjUG^
z%yU}5kE8)sV~*>982jZA$$yymvkPE48_sgTpIfe9N>^NIlIf2{|J9q|^Zzd9rU=|E
zBfwKN{PQV|GAR#AtDlLFNFjpfrs|TcX8;&j=ZIBrE3)m6HZ}<CQPD=5NhR7TY&loJ
zR}mrbn)CaB0jQ;xw$_X?Oyj74+jensAaK>3<&3>3ibe*K1F;%FKSAl*ZGuYlhqStR
z8>aB1nOk3>a|h&GGSv$sOmoHQ6eGam{{el=LnQw}k5rTYM5rp$w<n5zuimDOJAECz
zAFPM9cg>A{dViO7^uL0Fg0y!3YxnqQ=H%gY&mEt^!VL}UCi<^|=pT!8)ype_3B!n$
z$!`fvlh3O>>{_{*1EOSo=@kqBe??pU!5>i0*yHx{X#qW5#Gh6hX}mQQi&NZBU9cei
z#g~TDi2hDGbEYz*Q~_+a(Ad;M8@EE2*^wNmARq<cWw%AU4d_JvGuFwE-vd6*izXLQ
zL2hSP7RiAkhhAJ6IRZXJ|C=#wJXKU!B>zFqd8P4C<f7=F^n3klo75x0n0FtN|7<_f
zs=u;hpT{`+|EKHfpL3Ix7Uj^tef<_HF0X*P&$t*@NICYL>iUOpfF14X$qvW+_j%+U
zE|2o_p45{`_jb;jne^5%ysI?f3#a|<ZU06?u2dvPK8RQ-E<FT=3vo*STAV9j#NZry
z_$wn|5$vX_s+x?F0`O|5YjPkAveHRtVw}2+$)u&nuiL%_?);vUhUL=K5%{LT(%#-K
zq5^7Qh;7^uV8(v&T)4zSLe{N7=dXtTb;D*XRQTUG^?PlluWq}&3=Uu=`}(FP@*C|G
zg4c55pL9+B!#Mk(>;KyA*U+>%Gfe{ixRB}ZBT_0qjGO46wX{fo;+G`l+tTXI)@~DK
zSZDCDIL+pnfq;GJAD&Qb<*(U>T?_`mU`!HfS!+Rj!nNA(QRvF^%jg@|4Wzod8ftE7
z$rvWU;j|+;&_SxMs>L9~=m1_)(P%Y4KxpPE1S$!b{P@#2a%^;kP7T1T8leUV@g2me
zs1aaBvrkDO&4dKNJoyi*tb@CFw|ND}6VUHNHGqkk4|C54yV(}Oys-E`T|JcA;qtfo
z$_4b<o2~-!H_X!<o*ZG86}I|U3xnJ9!V&*qRQ!Zv#pd`$66*PDCA@}S#Q;dsGk(e4
z_;sc9{90S#kl<j|sJj7c?J#e9P-IxDfA_OP=<-=5bP`eaG9^%r9ZJMA$PBn;=fQv)
zfF&k5WncnE0XL&KE(AcynEXKSFPMhpKoH?+g~I}i<Ukr4V%t*${8%227&eeb4DAmF
zz#u(TDK4T=Hty|Q{U@W}TQrId*-lq^=%c+YrdMd<f76pGKFE6iiDL%Qx9+{Qd!ira
zq+|~%NB*XITZELfM9~iR`S-fz6CStkyHVVh6_@rZ27teqG;-x$#V`F>8or8ub^VBO
zBKrDDnQrDoKmE{MBWQSENwo*ipHJs~_P>4S{ZBeyQB4js8NVaoinIx^^KR=sE8Mj@
z44=tZ5yv{8hU7pa`gJA;Vg`U+w$gQ#V{C)?o!$uWSXc=0zcVk_L~joD7$^U6pM$gv
z`(gTPM@xIy?>p)-?jSzK`h6`_-)vYt2d_)l<Ubthx4blue)hoaRMvk0geiuF250(1
znqQ?Bb5fjQ{WI^zDhK>~Ab<5Xe8k>WdL0A6pVxNa{og1#qu#a;;s}9A^rQ{M1but9
z2N*pxmwtEmNb-A|sJ5=YOAPx2J+{ZyI$!{}W#@iss%z{_4pagWsIxdYY7CEvkYIP*
zWrlmSb)YgHzy<ksx@bmcR6t(+voWAx06NeXJ24`_Dy3ZL%xAIqpDBj1faoi=+afbA
z*7`he^(BUWufM&^K4$gTL#VOY_>c2`q*LKBtYEeDuXo-+Q)kYA=pXa4zA(YB+XbKh
zSK~(fxq24;`+V}#&i2hu>L1rz_Io7*AT58;ExFxaS1K-Ou;o^u=NUwL3HbVK4{#~m
z0>2M+K;^kgYIAq`*eBp|ajDXQKtP9&o}%6Rjs@HSS@f?a2O5O>gWP$v6IZwiFxEH6
zs%OE(&UgS^4Mzn`S1adOn<?%~J_0hRQz`WS6UU7(kN)RtRddi=F8#yxc@v%@)>hgf
z{;#d|(!1M3yZ^;nf1>US`1>!T>#x7kB-js_m3FxN9exVaPCH&94uGKwHQcXPIq9@{
zVECs^Xo+fJde+-3836ti(#R{fO17dONJFmx17Hv}CFomme1Q9I7)YPHpp=dy)NUq3
ztn)x8_uj{b<UnO`rR4Dv={QWr1PCe1%+dK&1WABaSPhUVHW%7Ei*5QLzy^TBhV-Yt
z<&b<C)Bm!?zq<-5fD>3wcJ{pvsUr7%ec>^q{ppX#Yag$$X@4snI%6LFk5~Tbmi(t3
zvHh3Moj~{9bu;E-;K|~EjsmbSKdX9wBgP%qM7X2jj;$*C$8CN^{;srQ$KeQT$hymV
zEd!u_$$jtt#-BfFt-b&B$i#O&{QTUn9pKP^amPrSG15*aPgkbBh}wogKpYmhxkC-0
zzz}dO8p5uW`hjWyhfisL`ct|=s6X7(eV(L8^mkENVW*206Mtp`L=gz|1OaB$Cyg6P
zb~S3Ap(b|!YuF9R0Q#94tOn<e!y-X_-tZ=YpO{~s{h-eD6dz2t<UhQ?7&WYde)8Qf
zQ9)4&TjF<pcUABI2HgJEv%J3Rxk!FlV9x=>U_10TXKU{i{cF(mY6gH+0d_y#t@OLB
z#-59$GRaT{AYo8N9|t}8tuZv9$V1h&4Qb5;IH3mEci<RtXkdbCpeijX90pYYtf7s`
zfi!}jq6yFeH9&bWbcMPik^||$5W6uUz-pxOG9(k@@OoVes0&LE8{sKqoI5NCPnX-{
z{DZ~+=V1LGD*SIcMgL=?zdj|o^z#S4NP|a=gwdbDXpsqi-F8w=yo4pY5&IC}g~A?l
zlO6Mfw_QH&ZBxG4TSfmGdQqUN-I85fY4~Nk6lcYEX)uxn83|f~n(Fr|G+}rSJ^kP;
z8q%+r8XA#$*UY#mLC=r2T8@DB%-`2SH|JMHXT-^YN)QwXu2CJU{1g%Wj<)c?#soN^
zPge$jB><VAYUyZ)*hxzSOvfjWS;YNUnvQ@#1tm`!@kvE1;0F8rhxK&2hV|s#3%7wK
z0O?>C!*&&HsC)lcKTWgd&*>iQhw*GXL-HZ${n=1E90Q=?&Rb*QxheR^pA6DM*{0Ba
zd8;=cH(uJ?e)oC?fIqnH{hB{0g;SqRmMVas>Gw%Ad$gB+edkyz$a7I^n>%fp02f4`
z?|!(2-uqw+$2i8@OOYi9;)W)xU|_RG!i{81`ohV9_|J3#*Iy|11p*cbaNlV{XzcDP
zFHE1Dh0a?akPes;AB#HUeVBd!o0|Rf+gD+aU{PEy7x7=J833lm9*>vqUUMZ~$3}nM
zg8cwjL{C-N=nqVQWtKn2Tl+J%Sx5Bsr&#olSWS;OR&9D#f4sNu3kCpRURu4{FXflt
zOXbUt*z?OU(7O_mM0F091S}p^MgMW<OgzG-`mHDGSv{$jx#o5Z*k3>Tf7Ddp1ZEtg
zt8gR&1NA|**tZ&lJ$Yyh_j1_NQ#D=Phj_AMDS%)AVgOX!q9Wjc9n7X}d&%cEFp}*4
z*SH@`N^i=Ml3Wr!`dSrjJ8T~OhhMO;urMu>|Fpvc>eDOFr@QXB3APiMKbUjxD1pgD
zIsPnMD`9+W^!L~18r~WUSEKzI&*8Tk>%ZN<-EMDxz~pqVJR}%^;AfZ0=b!ZF47^XS
zSc-Vi$?FRoDR9-4D!PBoJZfwArJOsrYB^^J{ABw+`p<{Km1C4iIi)1^nSxz|-p;Cm
z1Ru9SuXn7{LuYHdG64Ko&JB?2RZoJOFRD)<0&F?IcmFZkuw_qB0v3E2tH3w_P?A)K
zR!wBWw)b!w{p@M1mMsc1z^wmIb#cSu|NL3w>DynwjU0{~thEe_Ef9R=>^r2KdApPN
z_kieY?Pc{K9@R*)?aQ$Gx3-ehZs;Xj!2sw!v}4dkFUTdc|I5}ND{?i(r0!&bc0o$P
z1vk@eOX}#J&n}|I=Jd5%XC~mOXa7OJeE3OrpCMa+1X8l)02w_8pCF*ZRSVJHlWS|K
zp#_t&p>RY%!2lRQ5kDhFfQcvjssHD1{z7%twIo3$ri#5}xY~Ij{*PCJtcc&J^FllN
z{n=U{eeOSx(7AeRNd$}jQ|<o8QpEA22GB2l^i?YE!x<F~V^uZ!+lDy*PosgDQ+Oq2
zwiwe^`4LV#Y8C9E>6O3lym})t2#KO0AQ%7*iQu-rt@ua&!g(LqO9r418ak-q+Iam`
z6gx?6RdnB_Zu-J?i>SWAT8tO3XU0+wPlTK!;Mf22JbmjsKcPzG%(7REBfDha;$x{i
z#(N;0B|CioUtU*FzkCk*Sd+rWMuGt_0Y)5(7y&1k-z_`#)7S3*C7nBUoTOZrN}m)T
z#wru4Bo{1bVT)^{qh~#I!;cQZ_rE#h8<dokq%``U2L{AL29(mn|Nd1PFl2~Hupb!x
zwHzn;;Nw_)VG(3z^rsR2kS*<g(uQPVJ`X*&<t#na{cP_(lKh^V0eD0FG+D0Qu-10!
zg}#0@9(4j>GT~m)O{q11I(_qrW_sZtA5(E5TkNJMV9d>r8dOZTUD}71j;y6Y{U8Zo
zb`oxm9RdNoJik9TAs+4Ed6p->j+FtDcr-Qo>4~>$>D!N=pvD$+bp)?`h7B8r+Y;~{
z)ARF)w@MHK-0#N@?L%L?bs1f_Y!123A}d|PVLUAu1c>`Qerf$(+eZ32S{K#2dEh?$
z(z-5>F{rzmnq_(c{{9a>d5R8O1pU#T>2Nq``0(Knxp&6M(9R`e%Xt*~6z9?-Kl>`p
zo<F~Pm|w(FU~dX}59o8#0St1MumlT(*@L3${k`%5%nTRhtrS-OMkuvzWjx;NfBTNT
z^f`O=KOdLRy$_SOI1QW#I<sB!Q%&vyy7zad5P@$C<>j)7Jw1yL#GY5yPPvKB8|<O!
zV~S|u!~z;z?w}lqCJS=yl%E6FBgES#j^V+*EdmU>wU+OLkip|tsHxRY&2E{_Al&II
z$anto$F;QeQ0Uc<U;w%yDh~7j0UzvkY>0$8YfK(3oZzHsgWG9Pxl8Tyx#;&fpkF!Y
z^G*<IiD?-VZ7x=QUz>%|#}!ENy%<*>c(Y*9OuYW^`ebT{!7y(Rp7GE>w>8l_+Zt%g
z!O;Ca@KB<PiVF2F6;d!iq;I({JN^8-x6$P*E+z#w09^{N^r3E54*Z^!>Wu;7Z-rBr
z8^izLunkbLwt9Wa)wx$~dNceTz3&RG>-D~tN6=#bfj|DjR`dGT{51zbykcYmBJRxE
zg^C)eqB{Q~y6tD5&{ibl$%VKvoeQsujvhIRR}82Eav&}(E^r_yj{}kUY*d2%l6*;x
zqvEhTqL!F)L_hWvs={jjT%8xXP9N1ZAuVWx%d6tzVj47PP{h}#GuGnW(gy(#EZAAS
zbo%6Rayb+#&PTt8I;t>NQbSVbf(a<j3q=29=GSSm0_QI5^P_WP%Y?tFO@S+`LalB;
zwIP29?1Et&?8kALTH1VI0-{q(<{*jD(4j+9BL3&-oSfk2NB{C!`qXExA;oPV{tOC4
z9`fP85S@Ml#6N!X91}Jhj3a&R^8L=MHvfD2^qTZ~6Ttw4_#R5ltHu5^yI!_ezqZ)l
z(umHgvGO5q;!_$e4|AF2g_srW@V7skcLja%-`CN$-3KTyCw_w?>}y4N0gKj~nwseJ
z>C<URWCso$NUQ^mlwpXn`Qq|ki~#rjvuDpzeLWikrdP3H2|Rf4VAc9R*?pghKL_CY
zx3AquH{WtSBpWQ=FiebW@qglF82vp1YRxK?_>m(!^!|R2|LG&PhMUJ;anL+6QhI%^
zl)O!Z6fGt1mhy*6<ySP?2VV9WrDV=wJBPsyRk&|!f1$4HxX3UV^!H#=@x$tPfafjx
z<u@**(IbYae)#%J(rKS3m!hH~Rm_-fdUh87^SdQ`0!*jxBi<!(2ynkDD=Q<X>KTx@
z=R{jGkHdcb`lW>UGbZeL^VQE^NjHD)I*2wbi2u3wzyQ1ex*uoakC+HPx4g@4lkXD5
zKXlI#3_xgnNGd<?gq%P5Zn<z$yUl3rt`YnYv^-FK#20qH4WteJwniE)y-mOW!HqO_
z)G#%AR_6ujwa0_Lyu6%vwVf`LA&WoxeRw4#ia;Py2(XJ?I`w-t_G6V-X=!QF8DE|U
zJRtt}-nN47x$|b#D436RDQx72AV13CKSOH>l?IrVcomNGk1DHSAN+agiY?Y*5##m1
z46i4C$Y(eZ;a=an`=M_-s{ipbxd~!!&EhxYO@>Y%^4bt55opI=G=vU1R?!!~^CTTP
zb^-=QIxE=_x2ED0uRNIhZ)j+s#>Pf<zuN?m;1}ZwkoEq&GUNSZKR?0E6V<070^IL8
z<aBLqEj2ect7)i{{hHj@S=yyZB$D0lna;Zrbn7dhyNtetKtG(?w|k%;gd%R(OA1^3
zBmRkHnBN${V?F|Zvd>FvTvu=UQw&w~x?2PT5aB0ZyH;^5Df!MLw#N0h`J34uzzVuJ
z5q|x9A=Ie7Y&?C^yqNBO@JTvzwh}SD)0+w4*JlGMj>5+b0Z)#+WrIHc<H<?;(>FER
zeO}%3<jYbAUWswC6BhexQix<vg3-RexITLj;C{%3`?}lhR{yxq^EhCAIB&T`+wZwv
zt!~~jq36PVpQ99Vzt;l&Xy=mM@0s{>u%w%>Sw!Fc*DoVwNUjO-ht9wGFe!U~15N>p
z^H>e5)z)|Y$H?1Ybm?pJ|IB&y=6~&aR{XL;z>11lUEiyZD~H}J@t=G8MSJV6rG7Tg
z?I;N#`W<x#cbEz2dme3VSw?q1@F<-+b1to!0PXd)iA(#fpO|<;)c@A5iDs)Y0DO=3
zte(~x&GW^z0s$ieT0hi|8~bCl{a)Y4wK{nl?m7Bv6S?1o_<sw;--Y-kEZWx>7W=oJ
zg|Gjw0^yVOzW(~_V%+DTNPf5fd3#~eP15pr5Ta3(NDvSVKqM&Xu4!KTl>vF~t^csu
z{pa}&ndfwuC1w}?viAP7XlLvB^p)@Yfli!0m)7cl#DE}b6$l6f(ggu#ZrBa@b6EL5
zz{EcX#J^jJUq~$4&XK(L5u)ZJ?4K8(*AG%JHQ0|w-tK6VFOpUZy?->|3I-q=w1U@q
zUYtF{?y|iC3EV(GXR}IXVM##$*|f853ElH=f1tz1P6;L;nfQxm2?PWJDgsRWJzgK(
za@`WT{~Nc1_~)Awf8<M$_dHD0c%bLR-$1eKu=azn;jG`|z1(%pR-_LUB^m^Td2}>r
z1+R5owP}mjC*6jQ*QUC!#!yGhw}5;0pW8%Jia()0J@ieQK6xYzZ;SypVy<1>C=d_`
z2n50+pb~$q{O^IQ-@n~|XF%+4w(|Ehki7rVo)Ld0`r4oF&0zijy9z?2KlwI6{B^)Y
zu`3vWD8SNRn!9rStH?k9b=H3+-OG%bfD>zJu=j2H?a%L}nNvnl8*-J4A`lP=2m}(1
zfE*P2-}{9XbnjiafHvDr4E`YY_aMIi{yz}a?TCKmuMvF1ieGCR&$(<<2{r83bFbR`
zigsLVqeDP20MX&q<!aZ8jgQEF=_itdEz!H2O8gJIi~J|wrv7d)0srwex@ggPkOUw+
zZsMOTo*)nq2=r0}u;_ssgG~3|c^%yY;&1NirxE|(M@Rg_5Pc1Do@;r|g#`A;uB$fx
zRy!`X(IXHhyj}Da_O?52o}c$YNpap#gr1zPa3;KD7U&<8hJ%PZuF&!;Z>FQiPSV~(
zCso&=q%$PRY`1upKtLdnbOiiJg5-eC{egQvMQgtBDfsaRTpGK)h%HLuA0g4#KSK@k
z+b%!maJT)-_n)aUxEtuN6#L;2NcOrl-1}tYdF9o4#Xd!O#*rgk;%^W5`X;p@eh=9P
zEvMH0SJO{^@i;yC+&h$m+yO>6p`^Z(c$h#yAdoc(a1x@zJSYA5+iPgW%1aR2A9R=X
zpZXFF@sE-6F!A@bD{nY#w$;)V>k*Jel%60E<7eo}BeV0~mS-0a%*kzk$(|$4P6-pB
z#tE21o}o9=Lyx{l4?Xsh8XUwXL;=~^;Y6zh0!c!k9hUwB%ZuozNa?#|`C?KyHK$S8
z$i&}WN%Da|64mc9*ZKF5+Ndjkx4hBa*0!o}^{%r?YJOHfriY&-tFei?aqWL!Fu~!F
zpT}63;P<3J5+HlXRz8EIaktT<Prgn+fA}vXBc}kk<*3^tZV(6v1Ox(Y@Gu%Ptb+dg
zhj-F>GiQ(jJELxe{rcMw<Yylu{52f`@z-T8jT41|+cn8vc@KDzYjUsJw6EJchyyVp
z5U0-*)3dYkCeQQpX4!M;C7WFt<VRlbq!&m6q|zy5n|K>N_wq*i;V&MehL(2ZD+h-z
zia<ahAP|TU0X8b0Ie7&A@<(5#;bTTy5`U%n7%2z-2SI+023G!YrYfqhzf7n6ZSpGD
zb(=ql@b$%I5g-ufPZhxvd%-2%zt3A_b12Va;a!pRKtYTzm;fpoMfNFo(FYq2)3<;0
z2pvCDN4aU7KcE+M3(-V@Kt>=C@bUN2Wy_}0kH7O3D(l}LVt<oZBUt$>O@~O?2Sa@K
zIdidptSt_%omAqlC{=PBUE{oN(+9CuC+;&xKrjI2xb*mF`-}6hb-3imZ4wpvlkFYA
zZ;!CSls5oOz}<A{l!xy7?k{QU?qigfo73aAi3$V)0)gyAK!%$ir}Mr2#tY~h_pG6u
zyh2itysKMbF@N25==>ig@;1OPFAff627#%X+E<}QWE8x`v2ybZ-QGbQ=rIC<0q8M=
z))lnBJpWp|U4F_gDY?cVS=M*O@eDHou5z+Z`Vv*SE9ikA{fgdrcbl3-NO%au5ob}A
zKp+bcU`zj8=-Ti5;&t?eTdy<s@#m0yyz;O7kdz}&^*p7of#_>628q8LNri55to-D8
z?YP*+7XiTl#23$QwRv8e`z42y9+o7<kyIu?8(0dM07oI&$K67nqG|N2haaQg!a&f5
z7y@>?Fb?eY!NdW9Krcj~9malx`<2l5zjX^;c*$}^@e8Ev?gEACQH0ndr{5su_;Zjl
z!XPk~mA^JOb*a4bN09jYkV5%R*Q!qtO-PhPAs`rlL?NrI*Yo$ecfbbkp@cI5`hlhY
zvI=~5!L{3mUr#jT5_<aSm*}St{gvvQ-N@T5j01I_O6&>*dKCgZWw;SWeCFig^z-lC
zL1QORGB@^vHxWkwRE|9d2H^DoMtm&NqMw^W+@lhI4l(5O-)R@bKLk?oIi)8P@u^YN
zVv2z0@3X)J*yGOx=m%D)ugO6>Fo2~&my&Jlr)cB)t*UY0!DE$_i=aWG2m}NIy$b=>
z_j{r5zxMKZ^qu=YZ*A-+VUgf#A?4^_NICaD789)R4>j57aMaIFy2IUeQC-K%U&hLR
zg;@D_!zcj<BK(R8cyceS(hVlS6%QsrKd8ceLH)HHyaRRtQr~%Go3Mt?oUWq>fBFc$
zv2KT&Qdrmp^ukUln%pZ9(DeOxuUSdAuUSoYrwhh@CQ)@YAOC}o5j9u@_%R~bWzI34
z)cw}YT>;_`eWfhlX&1y_2U22pb)O)y4-&Np5OBXZ_YRjU26cdbP=)(y`fJUAXE(v(
zv1A{A8@1cY=%L>{PLIGYK;oc5!Y;rJF>y>FkTnRj!M}gRpfdWwH*cY(7c9o=Ug@6A
zPc!yw*h|VG5dXH*So9;{k5vgb=V<qt%v~DsN06Vpa#wBoop!0%CLRHk&yo0t_Vy?E
zVHk+91j9grVPJ@nqdyhyOX;tT1Yl+Yaw^C^b`4SA8T8@{FVoK+dWue0HbEs2VxUJ-
zx41?iAP`791UQYa2mbs^=1!m=e*1O=_ZefM@8`(|#(tIWL+t-IxcN0f>~CT#6zQB3
zV(!w2zh9Oh_TMNB{*v5lLVTJezez89ocqODcQ{@4hY%;AD-)m}RN=mk{@PgZQ;h?2
zNE&tx*+#CQLwk0^F5tJcVcQ|qRZ!#+hy_$}k3b;(5MYr%GU(FnH(f$^e(BScS5S<E
zJ|@9^*s33rc;&?3Njdcj_A$xmjr}5>bHdGCfT)A``#}6x3F4oMUK7D*O2upSj%WH`
zp7TYrN&k(Afq5Mf1H*lhNC#lV5F%%R4CBB7%U~S%8ES6z(r<qICwla+ZxXV9lG71~
z03Q**i?~oAAP|Tr0z6%?i{Hp0<#hi&H_^qHEF*%{5y5r3KZf=F?X~dlhp}JHhM<cd
zCZtH`oN#lO?uktN5pl59<CDIYD~P`indI(9@yU|=V!h>QYQ#XN@;Gt_6m>8GW{r<@
z5SrZ^@>sB9_USE|NcJ&nU>`7y-hAU9^ppR7ijJJD4x|<iS%)|&5D*BY8v=e1c^{(q
zUAANzJ@EBgY0$_~<|2Ph-`}_&`u@j>T26%4_v;%P0|nvmzHmrtl>H*YpB~Co?8or=
zQt_JE{mfw4;NNx29gt|EZ-iB~3n(YssL#S(@O(Ob<RJa@mygp+Z*7Joz##$$8SxUo
z1p;Y`Ksy5Y6c@PY&RbW~nwzg7rz_7qq^~O82SGmf9`yas1S9*I===5U>;csXB=%9N
zZGPo;Nrd;+qneWa9(>A_yl>V%G>|}u{stG@L5WEv93eLW)|}w?tHui$c`eicGX43l
zFVaK*^8!`YvVow88IZM|P&6##5zu1!&zU-s9{AeLG<Eh2^QeB@Qa0@KHY2Lv3#6P~
z+g;zUM<WiDf>Zh`KIN3(>;07Ts;wXBs~7vJK_CvFH8n4ujZalm3FjzJ*c{Tt_%Hzx
z68&yLJ#Zh#3+OYAY@=_2YG61W*s+a%^o#$c_crVyr_+g0!lLVBV;>Z4%3K6I@T1Fh
zIq0@eUrb;8{Pk2=(#JfDpC<BeMkc?*e};emJ}?99`C~GsO%BC^kV^dh%5I-e{+w&2
zNa-63hKaZ*PM<dsuhu*3Z2!Mm6YP18|FyeluD{*HP$w)bu@ZfgiZzwM$eTzSxPaWv
zjr7=`o}u48`I;I=Sfm#=!Au+y2qYN+ZPh<{>|nb8-p|m&Mf0r<{nXg~2<dxv9ajFx
zvExA|KckCZoT-96$3|Gtthf8<7U`-@;5I}_7X;$`snexdnf)HkPtO^Ulc)TzBiDY3
z3??8vNe_QT0Fg*Px2`^R6=apbzzfMX>}sSKE}<QpH`2fV>M8no%K_L0h@?W9-P^?5
zXEFjF==yVW9Q3*CmeH4QTTP`E6)^NOaqr_ss#g9ri0A*Tn$1sL@oO%AkxmU!fW=kX
znE1ELue)2NHHE7;o{i#macL3|NWf=L!dv%(N7Oz&tE4dB{wt?Tx<&EIgs|O)((QoZ
zy!JDiPi$2uj&o{ZL=Tik+(@?a$>eFRrzc?>@W|t@z&4;o4IZQ>3)3DewgLfxK*A7U
z+Z-=M{<F^;N#DBrCYm#EHpVF2`^-{~sze^{y!G2jKJwRqmA?(PJkd-IQMQCNgpw1)
z-zz`XAldINzhZr3lvRk!lYl@1yFe1&KFc4WJbi=9mw)Vgh|c?M*y-B*-MN4e2t@j6
zt%$x!)vOY57LqjhO0o^UgeW(U4({AZ|MkdU=*@N8A*ry5xB(`xi9-T`cp<=}mHqnr
zl;qJDK7A?OdebT@EVa`0<6>U*`&vmk`7*Njy$L1(?!HEmf4p8USdU$${^UnK-=FSp
zZU4dK)w}ReQPL5CNU20RzI(5EC(p}sz6{sd|AP9iGhmQu>m&V~Q4oFObJ$A&(ZQs$
zsfZwWJq!g$lk9GymtK7vo&wL)p<`8nD1yRB(1@J)EfDAt0zO3ZL+~70Hh&WR%bhpU
zgsD?t#gAiVL4A1Dj|oHJSpLWUj|e{g0m2{Y91+{A27LULR-a$_I*k2(8(S^nu4EyQ
z*xrz=R`i1B_+FZSIf4fN4+hx4t{wuBe!?CQeKUMn8sI7=X~+t)4OkA_fPAVtd5nJl
z*mLyf7vG~+w^z+DXm+bOCJ+z^M2>)F<TrX~U;6TztLU1Q7m}U*`prW5a<%HJAL)Bf
zy-vy*tonUz319W|W9<<6%YNmISC((jU9lN)ghfer1R|v#>E4cB@qV5c7tF9be2>{&
zwrTM-4vY~#mIgrZFZBsZ14>5Wx0gQIxS4+Shi7RWTn23jY~T>#gkuC)+}4{B;4u80
zyr-}rhdzDPV!Hj7YpCy_!8qtuB>~;AF<bS+fEQ^#yImU316(^B`zaoIt3=Wo>B@~;
z<5|C`D{%-Uwr3>ny?brV%8T>*`yI+}?M~@x#jC*X$GEaL{!Ri^nlxbW<;W?poTR)W
zs2v;VxtIP)zx&hQ>EN+Ss0Cc4>IReWI^q!mflNoh3(>w!QfTRd$#l={H_&<0&$Bl2
z<HoX4pSKZu{(l5l{jC8>K!Snbgkh3Pf~CLzdAGm)%Y|3%JeS}{it6KtfM5XP2xhXX
zQr0fZ^|iD<h=uhx@Jzd(v-YIAsI~!ql8{e;IJ;mewut;yb?OxT=`Vk$KR^EtRoAs3
zuK<DwC3r=WYAD3>1p=`m;KNw<BYywnaYN{?&tFZKT(}6dJ=a>?uln_48fOdtW6u#a
z9|?;46F;@934IW8!0(g)!%<lDeQEhS?pWI`?n?~<iSH$;X;-g!s^_ISx7r=_Uy!nw
z`5_HRi^9?XM?OjYm%&@$GDri;F(LWs;GTW-$RD4jH{RVwEo~mvP*CszY4OFxOQZn;
z?BT=W{$Yd4=;j+Pq8qQfjEc%IcC5tx!DxQuJ{z#`ulfiQ0*pNt`6r=30?GRR8iWbC
z&#`jTpOWxM@rVQ<AQ*rIfSSxIz0b{EV9Qm0XLCyD$sPm^N;My#J|F)$Zb1HE1P{83
zsC+iWgt<88rp-_f{^qgg>D~2v)Yt|tXL2U2WPTIzEP+6z2(Su|-TEr}6w-~*^MCGB
zSJHr?L#(a)xnef*^Scqu=K~n}y-MV+42t^`Kb<qv4jUx!8uE6m{J-Q{^~uMPwpCo0
zeh4JK$E07Iv+j-9E<kq3zeWy$)tu`)x_AL`fWwOEP@@Ri;4(OkXz&V>ibo?jh#h=D
z3%&i$hxEt4yha~wIjE`xoPrUE!-o)6WC{XI_*DbH{2aRa(z$f&r&rRLiDO~0ZxPIg
z8>Wi;VRj4GK05ItDUHFXy20a#Zo6v3gLp!+Px)J$&wY>3_a_?h#MdtvfW%{*lqV=p
zPe#z7yl>bg>AR2u<|SMuU`6!JTC1uB3Sc0(6j=r@CMmZs)C5@Mv^3ExZ@f#7ff3lg
z_k`*(-~@vpia;P+5zrI<OO{NdH8);C=gpXk<|5P=BKw&Z)w&-8rtMU~wXf<!NB|)2
zPjEmV{kyQpADR5x{66J}``g|BC4&3t(aGF>!2o3Lw=;cn@5^&9h4t{SZ7ykC+*Jb6
z5dCg%7gP)64S;RHB_#DdAJTwAL>7buv!RY&dvhH<{?~ti5jZXwfo|A|1DTFMC*gO|
zB}=B$tv6myQ>VeQA4J^JpI_DUgYbJ`-GA;KB=C6)VE}8BChlj<bt3<L(D{GWxpMPA
zGW}bK_wPhNFaVucWX)dN-)9ZWk!-(&B;Z<tgFuf|0zD%7W{@Je5PJ+1jX^l!%ZSQm
zK(YxJCY2GWr`P@gM&NG&MnJN0XkjEG61~(6NO3F!5Kx2o1bz80#ftxyE`*;~{AL3T
z9iCVBtmm)Z2-m*X1M&M=)UU?%Pfo*Ckv{?oLYnxj$M61H{?$8AB<IQEDak@WOs&a6
zI?2z0tDwWz(sD2I2z*a+NJU+v2ZnhWvpFfuEg?^v^)iJgKf4-4h}c`82#JQ^(x5T|
z_4V}nKi`Mz;9A<U>o6g#D6z4iBshVPFpHDvg8(P%;Y@vHCHZvmk{R^b>o3NNAEA5I
z6@Mtg&q{VM$#CmaPQ8(IJ->#a9fp30GtvY@zwbMWi+%+cKMVbYc8AzzA_8Vpb0)S!
zyt4%Y-dATYgc;t$@DiAgNL?mb1%o#xgXnATsDGAfACLn{z$~&2x|FDJ1Qt2ymPmf!
zYi*`?*R7|&JpVSmzi}_QJ${uDu!%ea8j@n0W(Xhwj+&)!P`?to{DRqZ<24u4xQXNO
zmP}Bs2tS_&^9#wC!ZG_fm{09C91Nu5PG%F;JU#&{|1GjC-Q`@d5e5gMWGe!K0m#-b
zt816?+}v`%Q~o}@1n$5h+73gWz*#*Z)?MGD-B3MB|GX~O;RL%4a{K@=0&FO#G6F0f
zMSO8;chiPV+vw?+-lDhO-%hm+t>kn%$pP_(C<1|0BftrIyhzj|W7R)qct5)O@`beO
zilsDc#BlU$&~*g%u`Ft+UR=|7Fd*u$+YY+l4u$|au_PBYkq<i&`IJXmy|xF7uia3S
z<W~@nOELmorr{(%TRbkw2(-U6XEmY+{tR==2-yR7BRxUx$-9K=Mfzuix=wvQE@p{<
zvp8TRIAEC?O91xAU=Bd+ac=*<gY^6>@6fAnZKPwTY7k!7rsf(D>VckoKyhy@2n3S!
z_$be1r%B_6(oNT1Ko>5ZN2UGxfrw*#SrUE>1VryrOVbh6xKF9stfuW%B>`;wm&BqP
z`f(y3uYAO(*uIssV#6~@e7ty63K2+dPfKA##iIiVv^_m*m^07zbId=V;*amgL={sB
z)pPV!hPuw`!OWSkjex5JHUcmbWJaK9q<XbvM}^=8s?VIJx8Ge)e?#WMUHea{>H#OX
z8@rGSSfMJ8#{mKEnk?q`fw=cAE2O3Kr_l8)meQPA)5uW(uNH{;P1ExRdT&tFk87~v
zr*rEd>Sw~=5?t}eGFW=ns9-o>ytDEbn^*dlboEAI=+`qyGwSZ-_qdFLCp%wOd5~=0
zS#xf|8svwz9BFXG?t-CuOHYZu8PsZi0Wbn~#1P<Uf*K<LYiJ3HQdlbBZ)v7YpX{LL
zUt34-e!P>;R5qwg0B0Z+QUNni#j#irV52@C67)F0fQ}nAkXBtfpDtcDpGJ)t1>%j7
z#Dw2cq{d7ubo`KDv5sFk`!-RBs2|6ZyyEBftE+z2^?Q_)korGh-}uR&qz74HAxdvT
zAk>uJn{eorZLR<7tkH!9wjZm~0Q7_o+W<Wpp?XLnh`#o0ech}AU>gBD!U-ewux-F%
zB2GGl3}}c*9#9W}SvYn41g(8<1DJu2X!n8R)Yk4()dLQDP~583Ew%!I2oPX`?t^Zh
zSN#3Ui)sF>@pSDKi)r5Msgze*h5-YkJxeh^9-syA@gp-|{VovxcLGuTWKV!0NCDyJ
zW(RfsBw^K0e%p7XRU3{(0Ef6F3lRu4y=P%_MU#vOur$CuWA?33V}8%(v<+9h@Dwm!
zr2nla%<=9$`nvVc?AQ-70x)8bis3fcAB+GP0=5|-gdNtr2V{5;Y~HpPu7n>V=fF-n
zbR4nLG1)RBAXEe$V2T|R1Ug0hekv?*(Ztb1=qjxC7oR_yMvNK;>Ivh#kYaxBYG63|
z&r=H#|CWHLzxgQoC`Oj5`;Yg)F=>d&A=Sbkx_-F#9rcm_`%bayH$ka)9ZF44>|GdV
zL~C1Lm@_oTA^!kYb)RLsx-OxF^@KUzJw{)5G)S>TfZrv5C=3SYkyJ5<2vG*vvQd=^
zs3C<FYN)EBk2Y?D(cpU8xMe?`u7ZjHlQ1&^f*FVg@a(=;Tj@K|FUE`<Ko_1rl`dR1
zm!?gbK(@Ss@T-09jH)XiIy8sut@;>2d^TYJT%eyODNCQ#S5iay!dXG~Do@%y_U}p8
ztv_jXtvKF$5Qz75-g}VC(w6%EK4+z5Q+@<#z*J65q8bS%qL;)<_>H)8!XaK+<@5;z
z73#MLL4`(QGDdVkmI|=4lbHd(k4_#t0egX+^xE2uw0+MJI$hbQdJza_zzAyg|K^px
zpN;wO$KQX<u>Q1g&IDS%Xg1B7Hj(oCK*Y~|6e50W-9FB1t9>8D{7nY}8TugZCvPLp
z!CIBir?9Be{18(^_WHNMFX6k6D?fQTg|8zXon{CmVroybCW_aI7J-JR7nJ4ac)nqG
z*zS~^QZd|v;^Q(HFQRYOAk|<H%mBg)O9(Se6>||&0P2C93RNngG6OIS1jWas?xhp3
z7hq=K^|hOV%s>Nj5I`yrbSpG_ggBPj2yi@pKXm$R(C35!>F6NQUvmB&5dHB~SO%ic
zD|uXFZOPA<;2I|E+@Ia&0%Crw_LY|7s-a(iDL_9<VbNUsz{EHBe9HfG*xLV7TCt-p
zg|8$YorVYq1|SVTO1ivK%kwj5<v8u%gT#ClPbj8Fg5h2^kwoA0*?1s_Qst6c5s(U0
zKt)hA0>nR0l?t%LK+-b<kPK|!eSqG8WMKFHV|3(1wMrzI8L-1{Ktvu?(agwyei-Vh
z7W^RUB}I8OdiVfZgq8mJbEnhv$zv$LtQ_r%favoz+KS%SjMe@@i22u(Qoj?r{`w$O
zz!v?fFPf1b;uO3Hr-koJS8ReIf+zxk?g$75pgShwhz<cZ67<iSbt6RS57=^S6UfV<
z!opDXFsF6ZCw5np3b4^2LJU&{q71UpVBWys3J$7+4rTyD0V~6X>T24$^8jt!yq!MS
zypN6^KSwo)JjhW8IXMv<5;8L+N_rx|!FgD;ALyep4I5ZSqlOQrix*F&^QKIsDHBEo
zbo%`I;a2*5jV9t}%l+1qq||I7rEY5=IS;F!)bpub?elALQN{g8+Y7heJs5&Nv~S$>
zH{seBz()KxM?g$v=D3KX1_YGnruOqWbM8i};k&>Hly=K2kS;{u@ZKFi*=Ueuw$37=
z;xULTFcY2xa3##^i{lsuL0bYQ@~X`ME>+wuwCBJv+Ozinz4OryI&kC^9X(k^ZEl~c
zDqybzl`#+;K?lsq-eE#7W0fz1k>gOjeft#9(7^*}-t<v4d&U%+GI10Q7&Hj3qF9}S
z-wUhL=LTp*of$~?SrB~a^y@(Qn-1arHk?O)NwHC%9%n6nzvA)NLCf)QtH=9r(Y4#z
z^+gncKu81x0}v7(anguD`^&SZV5RY|=r}jn?2;>P_5sERCF(a@f2o-W@qnE2fIA_W
z0Zva$xj}JoP;#Ie5HjK51s;e@TSGnV+;@Zy96Uttd=(gO*Z=?$#7RU!RJ@yxpFBq=
z&eTv-OS@`FW`l^>21$Xs5=+$k_u_h)$7GQ{6MA0hvti1BzD3l(Zy8OSIGpCqnnYtq
zkD#$|*OPLf?qOz*SNV_#gf2|baV`I;L?3$n1_bP>#Y(>!M4v_c%p|7Jh0pB$nGb=n
zE<$7|9$@jb&+q+d&Z=$TRzwj9M1}ymkSGFy=n?R~Fy|u4q1+E*x10%N7q`Lat4qxt
zK|-%i?jZhbJSde-M<Sw8kPIN6yK3kK;=$KJdZ0=N*mi&mh)Qc?9ql`GijEySO6xZ4
zq5VfrQ&n{xovCV6y$@`dq4^%RB@lK50oWq_uP63wh0g@v1;f2zgUYB3#(E29jiE{7
zN7I<m!)f@C{xI)A7+ziq<2nUIKfKi{uGLohEZ%olVucUAevL--8}O=l3+<XnUpz_I
zv0EQYGyu)p=!!pauH5)mk{&G{lSK#!1|W+*X0n@d;MZevh7B*i!C|xgi_HbMK}^0e
z844!*#m%0lX9kdifC@*#USJ9&1W4t|%m5n@sxvOny37!OHt-6Q83G<fXuIrgR;2=m
zj-CcnaEw0QdWcS+tD(xOTB@vp;TSGtwE;^Om^omt1Hl*sSM{J|Oz07l9#AT(mHx1S
zeW<jw6rpzq(EJ(WsbBvAG-32$Dy#Va?Va0i99JF3&zaeq?Rf1_-%_W|r6d$udP#ao
zRY57DLTyCLMMOxnLX-*+68r%?^@$hW;GsfQ3qlcs04lwL)Q7f|s;weZ+%|2Yb(6Fq
zj$<bdUfb)v%pAVIvoq_pV{g{>*q*h&M;`C)T+Zb)bLRIuzw<lipxY*iVV=?ihDAV>
zvARR`<Yq~*!dz|^?wicNpC885y#K~5eeWnUc^pIc<Q~OW=t~jA!A}$&OyN6djQ4Xl
zU-+XwbPO5{0|_jhfYb&C5?B#|bBAxuwr9Nu;c@(9C<41>CA4KPGPI(cM09ag89;op
zL~+}8bP?=Tx&z8U+Z9-(s1w2jLIi@UsubXx?J|&Qhh?at9D}L4G(DkCo;r(dM2(#t
zRs(OJR3DreQPa~oHG)Zr&QIj+b#krUL`ks9fhY(Yr+SJfzO>@4pavTe@`6Z;*x%cs
zwsy3uRxGA-%k?nf@7k^|>+Vx~clN68o-PP`OaUz?8f+r$u{9Lr9*MBG_X<8Bg>!J^
z!z4Wr_;$=bzT2gDB{G@B$7*u&BYr^^?NQj!<u(L(zjXY}<NCf=a`DS4bJR=(@KiC7
zKr{p@j)JKlL4ZBvrgVRGBB5xaU#D0^kc+^<rwEcvkJ7FEN_Ae1kp;V99l-2^;#ep_
zBwA=CuscL4z%`-}gi3*&Q!1(){0YQ=;Pl9t`rr5%x)08%!FRE$;mkCYgS<L7KB>-K
zn3hx#hip&`Bu@J&J47bVDhok!Yx-eL^T?oWxl6gQNq#H8B`XzyFC!=Vy4qD|woRon
zEvmPxQ{DLK?P_~}uiBD@mp;bh%f3`A%=igRwOc7@(0?!17KyciAgpDR2qZscnDM9K
z#0S&9l0|r?K86x-9>;OaLY3|un^*&pug@t~@T1l570iFZ_0gG9@ew-st<SyKh^fZ=
z>EDRNH$j<XT4C4mAA*4TK_cz+ZVW{rxN*T~0sG5MTLnP3!pj_81=dmk1;MUOAm-+v
zlQ#4rn7#E7+|r^IYk_UqLLgZIidHfdfQejAoq=^=`0NEWlh3IO<Kyb1)1&G?C(fx0
z6FE42l~tiwfTDnHrl3a8PuUi=2s2xutF>Abgql?69-KWe|63r)!`&j#!w`OzeQhl%
z2=$EG(wb4}bV{XCX;|5lY6tr1_wMLYJ#fxz&vvMmwhpypTc^706IrzKp)4g}zL#>_
z%;D3T@ny29O4mx5R{c-8UIe}r3ZLTGS%kosiFqbJLJJ=PA0~b~6)#rdvmvJa`3seE
zR`C00fcjS@Pe0bmrFs`a#eFLvAhm~q1XhJW{;6AbC6xaYn6kg+Bz0fYcMV)bNdz~9
zmK9v6N@7NC=~X&|K5FqHXy1*I2KX*r2Ixw_iIq*HsJ&)Zu!d1fOWz7MG5Ly*fm~xR
z3qB#td<g&iOkU+Cu}#fjO5+@SFG`r;aLUefH!*=}XmQcGaVQTHQ`S--!{y#RKBi_0
zMaay>tG#&G_xE&SYqv^;oY~j2Rkc9CCz46k-o6FdOJKsqR+Vkbs4fh<%Wi2^t*vR5
z$-q>f5OY29ZIi&iFf9@Ch+F#jD+R(wqahUX_A|)4^x+pVu^r~xH?q*q<cAoxIcA;t
zs%-6D=Q|sY7LFZi#9mQRvql9))!w5jRE=tlQlmy~Y70@cKeVV(dz7oOQma-Ht76nD
zLhTxD)T*6WH}`(Lf5Sb``}v&rJ?A{<(|OLRiG#ehJwS|2`VL+~uV*Z&n*HP^?cmLB
z!{~FqyWIdyR=5qyAN=s9-iLu_2p+rbFLa_tLzt4%0MooPZ-p8`N%iS6vv8s3JPtgP
zG!s#f@9dSI>j7Ff>&3iSci>J>^yG3}IU6^7PS-8lxV?cn*5f7}4K~&j{~~tI*d#Y7
zO<p!9#;vBiv;MX&$=zP6>kKkp^0`~8W^~>qrsi50#rxVu&F1+6tN?K{hLJLcqks8}
z`|N;dfKMR(`P;PMoeYi3QWYA<<bJl)6R)T}CXP&U1=C_D<;la1o$@I@7I{SVVsKWp
z+eP;#<+Z7bF&(D_4l~fotMxa*d<P?y&D~Xg?Gy3}LKQMxuG*sGEDlH>1lzoWAaKra
z>BD@J1UvnpY<H*RnrQSn7dzVYvoNJSLLJerxN;Ap&NVGZ!+LB^t;2jA4vaYCb-j*P
zsvScvNs$CgB{0E_XF2FZsiT^0`<afak`1}H*dJ^-fmW1if&Xs*wcRc~9hYhWJB{@u
zF0kEPsqJi&M|xAu?vD&_DaSVEICi}x;~^^!z?}V<HNn6mA^s`DAKvovr6=IEdg+=|
z0i4*yVju?`QVTVUFy(j!UD?d`>u1o6w@F-Ec%>hm*k3NX%RRQFY00`KzgCOTh<Le?
zcTRYnsL=*BHMS$o$nvrbvF%qKN<B>X`g!#LOc%&!MBJOlB;;LvaT$Jk@t)%FDU?i^
z73j75<0CH92m*oh(5Zf2)IL8Ka^vi<7l+We(mT(=z%Hgop5IK?wj%qm&6x>Q2pR)E
z4_+S#n)()LR^K9)Q@iJbQ~iL3Odu!DKNmI9rBeD3_Zg?e@VA!xqY&f0ZyxtcYM_R1
z?BjsJ11-Q1DtFb!pDBqYDKigmR+_S20-b9U>+#n|^raRvQL^Ab-v-vTK1p`mYJQ}3
z`YiBjoAF)9a|iOG)rcmPW1kg&PjhG`l7D4K$(`5JGdPedw)I6cr3X+&0k(}1Uf<l+
z-B?H=+*fs04k&iG|LBvn{fJD%AO+j!nxD`vh~+WWm0s-Ybbz=zlF<nrE<8vX$EA-w
zPSdr$#~p7P(wJ$^Q}<7<A)mptRej-6j=(r~R~m}wT$ml@+}$FCE4u)qA5+NYatiq>
z2;{e;G<DLVE%#-Yk1seaPc%N@nlaV8k#b|DN+HBYZKrHAYE4k|NvsM|$o%EzhL@8-
z6d-N~WWc<Yu1jkT50+z?L<*EJ)()JtMHUnpA|-4+bw)0&_L~rl$^o7d*dCZyp`qI+
z3_iiYo2{t~>^iMMUFVVN)qh^HrIPsl<hnXno~gWWULp1z-(Nwe1NaMp65G8ZEPZn0
zU%rc`lV1l|LriOut%@B|JoKQoH0bcKCuXFSEUC?)><oO4qovO__XTC<G#+KL;+y_)
zzu^P&pznOdXJiXy;yZG-c>81Y>C^S|pe6L<`r?t6@#0Rrv4`}Ln6<ktjnlVO=}9Dg
z3Ih%&-=L*;wBLdyWY14|<d&M9r1N^A*`E!%&9zfjyu1Y~jlX(+xGQ)$I}R^<8C@1>
zlE=av2==0^UPPhQho8v6t2B3)vdlJRZ~E-?PqeoX%ClxYp_aa`4#XdU{3M56g6~5u
zrOYvT*r#mFy58)6VuY%Mr4SV-zEkvDomyhWOFaT|v<Oyr48b7_y$7V_aRs?ijRr%?
zECBMZAfiIV{AIvWaE{9*GUxU>zaQU~^akhHguc^zc(~}NlU`*>$e%vUgbP_j{uh23
z%Spm5@j5w-0q9YQY~eXgQl!h`SLe4el3BwUgtJSc+i=6^);p{|we7a7PPf1}JuJAj
z=HtAbT5;5cVh|Hpk9^#LJhB^m-cS89{}2ufE29ihESVfy3Yf4rA#;yVA*TFQj1%`J
z%()LL==udkHrpOw$y*zBhV+%#$SuBuQ-8<+AY%d-l{dmEC^rZf_JwkEdxMvEt0_a5
z`=U_t5WI}O)~&Z@BJI{?8;W+dQ%0(65`U9=Kb-WXXqt<lqPsw^b~_*LUx-iGVZPEw
z{PZu%dGnrq8R@jn$g9gpj~I*%0izh_;dB?0G7WWI?%2B^B}wTr={e6y^4lU5-*dwO
zw}Mr+usZ$a)oWk>yh*)-s9e{V$b^~p<Y^8)B25#S<%m-dEWX>*+%+F{14=QZ^{M(;
zl%3g4;I?D$(1oXR%51>10E%Jr_DuyA1N$L~L*X#=)^KEwv;_ifvv<#fh)H}=#+_ML
zG@!b{#BgB*RY>PyPa;imtd`1qi2(kx6u}=<_;n%+MtivYl(W8e(kiexe{(=c)KFRA
zr5P?bHPKBqk;#ngrUgflR|N=UkrZ)bcVPNhdw3+Viiy|ADG-!IQfyNB7b=tg6?Qn|
zOe5DXpC7`E{%3r?MQ3CO9t?3Y^etNrHC~{xz>ASRs=HgkeN~T2mN?JVXxC$kQ^Evl
zt}svU5HN@8RJu|o2<{9mb~4BJQ@s*7N8ikrU2N&XA73l-kNPEsTWqhd7-=f3t2HqS
zg#%qsAgwsu?>Nt-HrgpY`}-~>vKE!?=6v^?N6m2YsS$F7AzWHOmu%VN7+}xQ;zaF1
z$FDG|f#!q$!vgV{LEq02LtC}X6leqML@AdA0QK;}nW~9?aPR{HztfG&eB@Culwk{z
z0Fc^&EGODBeClD!e(c6@A)0{<-+Y737ChC}jAnL(EjKf^)m{Y*;Nu4}!(mH`kU!TH
z-U8@{g|%p$u7fT`;C;ZPgko{~nfO*(4H}_9)$$RhRF@DQM@NDixZjSR@*_aEzdCKj
z*<VqO<DFvTL~*utR84(RS9)725y!&>_oWp&b=3B{>a?`1V!5LfGhUfWXXHdC?y#}E
z%)(~N2OkhtKKW?r+2Y^PnNxTwb|~dY*H<jK0gqN*uRx-VTPUh&K-Sp~Jx&?ZCSI*9
zG@Z8zRLl<JQrJfa9Hzv|rg7i6zZRAui!cv&qoos)(R(=zS%GviRxD~tI++zF1{Y<;
zsfW6Rwv~qz!$=He3tlThA?jepP@VG=o|?7=k$lD;r*BuM;xRv6VlSNaW|F$>HuY=i
z#LmWo1hb~3ND3fQna5O7pU3&CU7q%DD&K6A%PO4*1>TrnDdT%jqSFEN)%gI<*!K$0
z7)AVyDM6d5;Tz39qV~Vz^D$~w^9!Jp2)~u<!*(-Fzq)VX`phJlwk4B2A0ep`cG~r@
zYGA2Iuf9c&@Js@t!%9a;79)y7r@vF-4v?6m$qZves-!xfoPmya`TG+Z9KybMcPPkE
z#rKe&)|R@r{uQLJzClry#VDdh`Ns&`v6rA19ngV4S{MRvzew2Hici9@#q9?G2OW$?
zx4)h~YRqqekS{y+(#uh~>xHJ4)|>NsawZe|_2cV(WAE0%?<RT&-C_QvYFb&|+n|x?
z!_XdJ@H|qvvUuhnNXmD5!y@SjPmvYUuY+h}<WN?PFi)Ukv;UqT{ab7s=*z<+hip?h
z3pNP6m3sJ{*Mm=@83l4L+L8BW%g1G0YZ~lYeSY)rhS-0%KE5B?2OF8C?SqKQ@%V%<
zgYh?R0S~A`npV^V8T$3F{V=joo3<P*8@;FwMk_?KlDeVuJRAt31Xxhq|0@sm#lvnz
zcG1x__0{{&g5)dr71&8*sGsMDr+L&yvHt~xmO53tiv0QLX2yy<xgq|K|IL6_KK;4i
XFw{KPQ)5pIKsIB2Grd|Jr?`Iu!E{nL

literal 46366
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

diff --git a/openpype/resources/app_icons/nuke.png b/openpype/resources/app_icons/nuke.png
index 423445409618d59ff822dc09e1dac2e4d3e241aa..e734b4984e1c5ce86e957274b455fd039c5cd150 100644
GIT binary patch
literal 86832
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
V+x*Ep#xxg4tS#)!Yt6hK{RcYQ(zyTt

literal 49012
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%0A3y@Oo-YAZ9Vv!Thpo(w5>Cq&$5N@jl
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
R3jP~ZQC3Z+PRcy&{{SdSemwvH

diff --git a/openpype/resources/app_icons/nukestudio.png b/openpype/resources/app_icons/nukestudio.png
index 99c95f59ff858d67fb92263f594f4b71bda87a66..601d4a591d7fd21a0c9c6a1850e569ca05e523ef 100644
GIT binary patch
literal 101945
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

literal 46080
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
HIsgA3TR*cj

diff --git a/openpype/resources/app_icons/nukex.png b/openpype/resources/app_icons/nukex.png
index 1c5a83c8ab2e22da3e6afe8a9561441c4e0e4022..980f150124faae3715eb4d0018d3368f1091a60f 100644
GIT binary patch
literal 99787
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
a`-EZgF*J|OX($H!`pHTvNz{oM2mc>0LFUT<

literal 44709
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
NBt&F|s|EG_{|{S*X`BE6


From 8f26e683576ffc9d7be2abb9c3eb40ef01db1e09 Mon Sep 17 00:00:00 2001
From: pberto <pberto@gmail.com>
Date: Tue, 31 May 2022 14:30:38 +0900
Subject: [PATCH 0410/1227] multiverse documentation: see commit body

- better docstrings for pyblish UI
- updated images
- re-organized Maya content in website by splitting plugin docs and
  sidebar menu (existing links are not broken since the same entry point
  doc exists)
---
 .../publish/extract_multiverse_look.py        |  27 +-
 .../plugins/publish/extract_multiverse_usd.py |  16 +-
 .../publish/extract_multiverse_usd_comp.py    |  16 +-
 .../publish/extract_multiverse_usd_over.py    |  14 +-
 website/docs/artist_hosts_maya.md             | 387 ------------------
 website/docs/artist_hosts_maya_multiverse.md  | 237 +++++++++++
 website/docs/artist_hosts_maya_redshift.md    |  31 ++
 website/docs/artist_hosts_maya_vray.md        |  44 ++
 website/docs/artist_hosts_maya_xgen.md        |  29 ++
 website/docs/artist_hosts_maya_yeti.md        | 108 +++++
 .../maya-multiverse_openpype_look_creator.png | Bin 26190 -> 125727 bytes
 .../maya-multiverse_openpype_publishers.png   | Bin 182542 -> 309158 bytes
 website/sidebars.js                           |  13 +-
 13 files changed, 530 insertions(+), 392 deletions(-)
 create mode 100644 website/docs/artist_hosts_maya_multiverse.md
 create mode 100644 website/docs/artist_hosts_maya_redshift.md
 create mode 100644 website/docs/artist_hosts_maya_vray.md
 create mode 100644 website/docs/artist_hosts_maya_xgen.md
 create mode 100644 website/docs/artist_hosts_maya_yeti.md

diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py
index 5ba840f2b7..d59d03ee58 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py
@@ -7,7 +7,32 @@ from openpype.hosts.maya.api.lib import maintained_selection
 
 
 class ExtractMultiverseLook(openpype.api.Extractor):
-    """Extractor for Multiverse USD look data into a Maya Scene."""
+    """Extractor for Multiverse USD look data.
+
+    This will extract:
+
+    - the shading networks that are assigned in MEOW as Maya material overrides
+      to a Multiverse Compound
+    - settings for a Multiverse Write Override operation.
+
+    Relevant settings are visible in the Maya set node created by a Multiverse
+    USD Look instance creator.
+
+    The input data contained in the set is:
+
+    - a single Multiverse Compound node with any number of Maya material
+      overrides (typically set in MEOW)
+
+    Upon publish two files will be written:
+
+    - a .usda override file containing material assignment information
+    - a .ma file containing shading networks
+
+    Note: when layering the material assignment override on a loaded Compound,
+          remember to set a matching attribute override with the namespace of
+          the loaded compound in order for the material assignment to resolve.
+
+    """
 
     label = "Extract Multiverse USD Look"
     hosts = ["maya"]
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
index fe071b08a5..0671813c32 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
@@ -8,7 +8,21 @@ from openpype.hosts.maya.api.lib import maintained_selection
 
 
 class ExtractMultiverseUsd(openpype.api.Extractor):
-    """Extractor for Multiverse USD asset data."""
+    """Extractor for Multiverse USD Asset data.
+
+    This will extract settings for a Multiverse Write Asset operation:
+    they are visible in the Maya set node created by a Multiverse USD
+    Asset instance creator.
+
+    The input data contained in the set is:
+
+    - a single hierarchy of Maya nodes. Multiverse supports a variety of Maya
+      nodes such as transforms, mesh, curves, particles, instances, particle
+      instancers, pfx, MASH, lights, cameras, joints, connected materials,
+      shading networks etc. including many of their attributes.
+
+    Upon publish a .usd (or .usdz) asset file will be typically written.  
+    """
 
     label = "Extract Multiverse USD Asset"
     hosts = ["maya"]
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
index 7be6b101d9..45d0cad368 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
@@ -7,7 +7,21 @@ from openpype.hosts.maya.api.lib import maintained_selection
 
 
 class ExtractMultiverseUsdComposition(openpype.api.Extractor):
-    """Extractor of Multiverse USD Composition."""
+    """Extractor of Multiverse USD Composition data.
+
+    This will extract settings for a Multiverse Write Composition operation:
+    they are visible in the Maya set node created by a Multiverse USD
+    Composition instance creator.
+
+    The input data contained in the set is either:
+
+    - a single hierarchy consisting of several Multiverse Compound nodes, with
+      any number of layers, and Maya transform nodes
+    - a single Compound node with more than one layer (in this case the "Write
+      as Compound Layers" option should be set).
+
+    Upon publish a .usda composition file will be written.  
+    """
 
     label = "Extract Multiverse USD Composition"
     hosts = ["maya"]
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
index 091750c32b..8b14ac3388 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
@@ -7,7 +7,19 @@ from maya import cmds
 
 
 class ExtractMultiverseUsdOverride(openpype.api.Extractor):
-    """Extractor for Multiverse USD Override."""
+    """Extractor for Multiverse USD Override data.
+
+    This will extract settings for a Multiverse Write Override operation:
+    they are visible in the Maya set node created by a Multiverse USD
+    Override instance creator.
+
+    The input data contained in the set is:
+
+    - a single Multiverse Compound node with any number of overrides (typically
+      set in MEOW)
+
+    Upon publish a .usda override file will be written.  
+    """
 
     label = "Extract Multiverse USD Override"
     hosts = ["maya"]
diff --git a/website/docs/artist_hosts_maya.md b/website/docs/artist_hosts_maya.md
index 7f7f360b82..79031ccaed 100644
--- a/website/docs/artist_hosts_maya.md
+++ b/website/docs/artist_hosts_maya.md
@@ -597,390 +597,3 @@ about customizing review process refer to [admin section](project_settings/setti
 
 If you don't move `modelMain` into `reviewMain`, review will be generated but it will
 be published as separate entity.
-
-
-## Working with Multiverse in OpenPype
-
-OpenPype supports creating, publishing and loading of [Multiverse | USD](
-https://multi-verse.io) data. The minimum Multiverse version supported is v6.7,
-and version 7.0 is recommended.
-
-In a nutshell it is possible to:
-
-- Create USD Assets, USD compositions, USD Overrides.
-
-  This _creates_ OpenPype instances as Maya set nodes that contain information
-  for published USD data.
-
-- Create Multiverse Looks.
-
-  This _creates_ OpenPype instances as Maya set nodes that contain information
-  for published Maya shading networks data.
-
-- Publish USD Assets, USD compositions and USD Overrides.
-
-  This _writes_ USD files to disk and _publishes_ information to the OpenPype
-  database.
-
-- Publish Multiverse Looks.
-
-  This _writes_ Maya files to disk and _publishes_ information to the OpenPype
-  database.
-
-
-- Load any USD data into Multiverse "Compound" shape nodes.
-
-  This _reads_ USD files (and also Alembic files) into Maya by _streaming_ them
-  to the viewport.
-
-- Rendering USD data procedurally with 3Delight<sup>NSI</sup>, Arnold, Redshift,
-  RenderMan and VRay.
-
-  This reads USD files by _streaming_ them procedurally to the renderer, at
-  render time.
-
-USD files written by Multiverse are 100% native USD data, they can be exchanged
-with any other DCC applications able to interchange USD. Likewise, Multiverse
-can read native USD data created by other applications. The USD extensions are
-supported: `.usd` (binary), `.usda` (ASCII), `.usdz`. (zipped, optionally with
-textures). Sequences of USD files can also be read via "USD clips".
-
-It is also possible to load Alembic data (`.abc`) in Multiverse Compounds,
-further compose it & override it in other USD files, and render it procedurally.
-Alembic data is always converted on the fly (in memory) to USD data. USD clip
-from Alembic data are also supported.
-
-
-### Configuration
-
-To configure Multiverse in OpenPype, an admin privileges needs to setup a new
-OpenPype tool in the OpenPype Project Settings, using a similar configuration as
-the one depicted here:
-
-![Maya - Multiverse Setup](assets/maya-multiverse_setup.png)
-
-For more information about setup of Multiverse please refer to the relative page
-on the [Multiverse official documentation](https://multi-verse.io/docs).
-
-
-### Understanding Assets, Compounds, Compositions, Overrides and Layering
-
-In Multiverse we use some terminology that relates to USD I/O: terms like
-"Assets", "Compounds", "Compositions", "Overrides" and "Layering".
-
-Please hop to the new [Multiverse Introduction](
-https://j-cube.jp/solutions/multiverse/docs/usage/introduction) page on the
-official documentation to understand them before reading the next sections.
-
-
-### Creators
-
-It is possible to create OpenPype "instances" (resulting in Maya set containers)
-for publishing Multiverse USD Assets, Compositions, Overrides and Looks.
-
-When creating OpenPype instances for Multiverse USD Asset, Composition,
-Override and Look, the creator plug-in will put the relative selected data in a
-Maya set node which holds the properties used by the Multiverse data writer for
-publishing.
-
-You can choose the USD file format in the Creators' set nodes:
-
-- Assets: `.usd` or `.usda` or `.usdz`
-- Compositions: `.usd` or `.usda`
-- Overrides: `.usd` or `.usda`
-- Looks: `.ma`
-
-![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_asset_creator.png)
-
-![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_composition_creator.png)
-
-![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_override_creator.png)
-
-![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_look_creator.png)
-
-### Publishers
-
-The relative publishers for Multiverse USD Asset, Composition, Override and Look
-are available. The first three write USD files to disk, while look writes a maya
-file. All communicate publish info to the OpenPype database.
-
-![Maya - Multiverse Publisher](assets/maya-multiverse_openpype_publishers.png)
-
-
-### Loader
-
-The loader creates a Multiverse "Compound" shape node reading the USD file of
-choice. All data is _streamed_ to the viewport and not contained in Maya. Thanks
-to the various viewport draw options the user can strategically decide how to
-minimize the cost of viewport draw effectively being able to load any data, this
-allows to bring into Maya scenes of virtually unlimited complexity.
-
-![Maya - Multiverse Loader](assets/maya-multiverse_openpype_loader.png)
-
-:::tip Note
-When using the Loader, Multiverse, by design, never "imports" USD data into the
-Maya scene as Maya data. Instead, when desired, Multiverse permits to import
-specific USD primitives into the Maya scene as Maya data selectively from MEOW,
-it also tracks what is being imported, so upon modification, it is possible to
-write (create & publish) the modifies data as a USD file for being layered on
-top of its relative Compound. See the [Multiverse Importer](
-https://j-cube.jp/solutions/multiverse/docs/usage/importer)) documentation.
-:::
-
-### Look
-
-In OpenPype a Multiverse Look is a Maya file that contains shading networks that
-are assigned to the items of a Multiverse Compound.
-
-Multiverse Looks are typically Maya-referenced in the lighting and shot scenes.
-
-Materials are assigned to the USD items in the Compound via the "material
-assignment" information that is output in the lookdev stage by a Multiverse
-Override. Once published the override can be Layered on the Compound so that 
-materials will be assigned to items. Finally, an attribute Override on the root
-item of the Compound is used to define the `namespace` with which the shading
-networks were referenced in Maya. At this point the renderer knows which
-material to assign to which item and it is possible to render and edit the
-materials as usual. Because the material exists in Maya you can perform IPR and
-tune the materials as you please.
-
-As of Multiverse 7 it is also possible to write shading networks inside the USD
-files: that is achieved by using either the Asset writer (if material are
-defined in the modeling stage) and the Override writer (if materials are
-defined in the lookdev or later stage). Shading networks in USD can then be
-rendered in 3Delight NSI or used for interchange with DCC apps.
-
-Some interesting consequences of USD shading networks in Multiverse:
-
-1. they can be overridden by a shading network in Maya by assigning in MEOW a
-   Maya material as an override
-2. they are available for assignment in MEOW, so you can assign a USD material
-   to an item as an override
-3. From Hypershade you can use the Multiverse USD shading network write File>
-   Export option to write USD shading network libraries to then layer on an asset
-   and perform 2. again.
-
-
-### Rendering
-
-Multiverse offers procedural rendering with all the major production renderers:
-
-- 3Delight<sup>NSI</sup>
-- Arnold
-- Redshift
-- RenderMan
-- VRay
-
-Procedural rendering effectively means that data is _streamed_ to the renderer
-at render-time, without the need to store the data in the Maya scene (this
-effectively means small .ma/.mb files that load fast) nor in the renderer native
-file format scene description file (this effectively means tiny `.nsi` / `.ass`
-/ `.vrscene` / `.rib` files that load fast).
-
-This is completely transparent to the user: Multiverse Compound nodes present in
-the scene, once a render is launched, will stream data to the renderer in a
-procedural fashion.
-
-
-### Example Multiverse Pipeline and API
-
-An example diagram of the data flow in a Maya pipeline using Multiverse is
-available, see the [Multiverse Pipeline](
-https://j-cube.jp/solutions/multiverse/docs/pipeline) documentation.
-
-
-A very easy to use Python API to automate any task is available, the API is
-user friendly and does not require any knowledge of the vast and complex USD
-APIs. See the [Multiverse Python API](
-https://j-cube.jp/solutions/multiverse/docs/dev/python-api.html) documentation.
-
-
-## Working with Yeti in OpenPype
-
-OpenPype can work with [Yeti](https://peregrinelabs.com/yeti/) in two data modes.
-It can handle Yeti caches and Yeti rigs.
-
-### Creating and publishing Yeti caches
-
-Let start by creating simple Yeti setup, just one object and Yeti node. Open new
-empty scene in Maya and create sphere. Then select sphere and go **Yeti → Create Yeti Node on Mesh**
-Open Yeti node graph **Yeti → Open Graph Editor** and create setup like this:
-
-![Maya - Yeti Basic Graph](assets/maya-yeti_basic_setup.jpg)
-
-It doesn't matter what setting you use now, just select proper shape in first
-*Import* node. Select your Yeti node and create *Yeti Cache instance* - **OpenPype → Create...**
-and select **Yeti Cache**. Leave `Use selection` checked. You should end up with this setup:
-
-![Maya - Yeti Basic Setup](assets/maya-yeti_basic_setup_outline.jpg)
-
-You can see there is `yeticacheDefault` set. Instead of *Default* it could be named with
-whatever name you've entered in `subset` field during instance creation.
-
-We are almost ready for publishing cache. You can check basic settings by selecting
-Yeti cache set and opening *Extra attributes* in Maya **Attribute Editor**.
-
-![Maya - Yeti Basic Setup](assets/maya-yeti_cache_attributes.jpg)
-
-Those attributes there are self-explanatory, but:
-
-- `Preroll` is number of frames simulation will run before cache frames are stored.
-This is useful to "steady" simulation for example.
-- `Frame Start` from what frame we start to store cache files
-- `Frame End` to what frame we are storing cache files
-- `Fps` of cache
-- `Samples` how many time samples we take during caching
-
-You can now publish Yeti cache as any other types. **OpenPype → Publish**. It will
-create sequence of `.fur` files and `.fursettings` metadata file with Yeti node
-setting.
-
-### Loading Yeti caches
-
-You can load Yeti cache by **OpenPype → Load ...**. Select your cache, right+click on
-it and select **Load Yeti cache**. This will create Yeti node in scene and set its
-cache path to point to your published cache files. Note that this Yeti node will
-be named with same name as the one you've used to publish cache. Also notice that
-when you open graph on this Yeti node, all nodes are as they were in publishing node.
-
-### Creating and publishing Yeti Rig
-
-Yeti Rigs are working in similar way as caches, but are more complex and they deal with
-other data used by Yeti, like geometry and textures.
-
-Let's start by [loading](artist_hosts_maya.md#loading-model) into new scene some model.
-I've loaded my Buddha model.
-
-Create select model mesh, create Yeti node - **Yeti → Create Yeti Node on Mesh** and
-setup similar Yeti graph as in cache example above.
-
-Then select this Yeti node (mine is called with default name `pgYetiMaya1`) and
-create *Yeti Rig instance* - **OpenPype → Create...** and select **Yeti Cache**.
-Leave `Use selection` checked.
-
-Last step is to add our model geometry to rig instance, so middle+drag its
-geometry to `input_SET` under `yetiRigDefault` set representing rig instance.
-Note that its name can differ and is based on your subset name.
-
-![Maya - Yeti Rig Setup](assets/maya-yeti_rig.jpg)
-
-Save your scene and ready for publishing our new simple Yeti Rig!
-
-Go to publish **OpenPype → Publish** and run. This will publish rig with its geometry
-as `.ma` scene, save Yeti node settings and export one frame of Yeti cache from
-the beginning of your timeline. It will also collect all textures used in Yeti
-node, copy them to publish folder `resource` directory and set *Image search path*
-of published node to this location.
-
-:::note Collect Yeti Cache failure
-If you encounter **Collect Yeti Cache** failure during collecting phase, and the error is like
-```fix
-No object matches name: pgYetiMaya1Shape.cbId
-```
-then it is probably caused by scene not being saved before publishing.
-:::
-
-### Loading Yeti Rig
-
-You can load published Yeti Rigs as any other thing in OpenPype - **OpenPype → Load ...**,
-select you Yeti rig and right+click on it. In context menu you should see
-**Load Yeti Cache** and **Load Yeti Rig** items (among others). First one will
-load that one frame cache. The other one will load whole rig.
-
-Notice that although we put only geometry into `input_SET`, whole hierarchy was
-pulled inside also. This allows you to store complex scene element along Yeti
-node.
-
-:::tip auto-connecting rig mesh to existing one
-If you select some objects before loading rig it will try to find shapes
-under selected hierarchies and match them with shapes loaded with rig (published
-under `input_SET`). This mechanism uses *cbId* attribute on those shapes.
-If match is found shapes are connected using their `outMesh` and `outMesh`. Thus you can easily connect existing animation to loaded rig.
-:::
-
-## Working with Xgen in OpenPype
-
-OpenPype support publishing and loading of Xgen interactive grooms. You can publish 
-them as mayaAscii files with scalps that can be loaded into another maya scene, or as
-alembic caches. 
-
-### Publishing Xgen Grooms
-
-To prepare xgen for publishing just select all the descriptions that should be published together and the create Xgen Subset in the scene using - **OpenPype menu** → **Create**... and select **Xgen Interactive**. Leave Use selection checked.
-
-For actual publishing of your groom to go **OpenPype → Publish** and then press ▶ to publish. This will export `.ma` file containing your grooms with any geometries they are attached to and also a baked cache in `.abc` format 
-
-
-:::tip adding more descriptions
-You can add multiple xgen description into the subset you are about to publish, simply by
-adding them to the maya set that was created for you. Please make sure that only xgen description nodes are present inside of the set and not the scalp geometry. 
-:::
-
-### Loading Xgen
-
-You can use published xgens by loading them using OpenPype Publisher. You can choose to reference or import xgen. We don't have any automatic mesh linking at the moment and it is expected, that groom is published with a scalp, that can then be manually attached to your animated mesh for example. 
-
-The alembic representation can be loaded too and it contains the groom converted to curves. Keep in mind that the density of the alembic directly depends on your viewport xgen density at the point of export.
-
-
-
-## Using Redshift Proxies
-
-OpenPype supports working with Redshift Proxy files. You can create  Redshift Proxy from almost
-any hierarchy in Maya and it will be included there. Redshift can export animation
-proxy file per frame.
-
-### Creating Redshift Proxy
-
-To mark data to publish as Redshift Proxy, select them in Maya and - **OpenPype → Create ...** and
-then select **Redshift Proxy**. You can name your subset and hit **Create** button.
-
-You can enable animation in Attribute Editor:
-
-![Maya - Yeti Rig Setup](assets/maya-create_rs_proxy.jpg)
-
-### Publishing Redshift Proxies
-
-Once data are marked as Redshift Proxy instance, they can be published - **OpenPype → Publish ...**
-
-### Using Redshift Proxies
-
-Published proxy files can be loaded with OpenPype Loader. It will create mesh and attach Redshift Proxy
-parameters to it - Redshift will then represent proxy with bounding box.
-
-## Using VRay Proxies
-
-OpenPype support publishing, loading and using of VRay Proxy in look management. Their underlying format
-can be either vrmesh or alembic.
-
-:::warning vrmesh or alembic and look management
-Be aware that **vrmesh** cannot be used with looks as it doesn't retain IDs necessary to map shaders to geometry.
-:::
-
-### Creating VRay Proxy
-
-To create VRay Proxy, select geometry you want and - **OpenPype → Create ...** select **VRay Proxy**. Name your
-subset as you want and press **Create** button.
-
-This will create `vrayproxy` set for your subset. You can set some options in Attribute editor, mainly if you want
-export animation instead of single frame.
-
-![Maya - VRay Proxy Creation](assets/maya-vray_proxy.jpg)
-
-### Publishing VRay Proxies
-
-VRay Proxy can be published - **OpenPype → Publish ...**. It will publish data as VRays `vrmesh` format and as
-Alembic file.
-
-## Using VRay Proxies
-
-You can load VRay Proxy using loader - **OpenPype → Loader ...**
-
-![Maya - VRay Proxy Creation](assets/maya-vray_proxy-loader.jpg)
-
-Select your subset and right-click. Select **Import VRay Proxy (vrmesh)** to import it.
-
-:::note
-Note that even if it states `vrmesh` in descriptions, if loader finds Alembic published along (default behavior) it will
-use abc file instead of vrmesh as it is more flexible and without it looks doesn't work.
-:::
diff --git a/website/docs/artist_hosts_maya_multiverse.md b/website/docs/artist_hosts_maya_multiverse.md
new file mode 100644
index 0000000000..e6520bafa0
--- /dev/null
+++ b/website/docs/artist_hosts_maya_multiverse.md
@@ -0,0 +1,237 @@
+---
+id: artist_hosts_maya_multiverse
+title: Multiverse for Maya
+sidebar_label: Multiverse USD
+---
+
+## Working with Multiverse in OpenPype
+
+OpenPype supports creating, publishing and loading of [Multiverse | USD](
+https://multi-verse.io) data. The minimum Multiverse version supported is v6.7,
+and version 7.0 is recommended.
+
+In a nutshell it is possible to:
+
+- Create USD Assets, USD compositions, USD Overrides.
+
+  This _creates_ OpenPype instances as Maya set nodes that contain information
+  for published USD data.
+
+- Create Multiverse Looks.
+
+  This _creates_ OpenPype instances as Maya set nodes that contain information
+  for published Maya shading networks data and USD material assignment data.
+
+- Publish USD Assets, USD compositions and USD Overrides.
+
+  This _writes_ USD files to disk and _publishes_ information to the OpenPype
+  database.
+
+- Publish Multiverse Looks.
+
+  This _writes_ a Maya file containing shading networks (to import in Maya), a
+  USD override file containing material assignment information (to layer in a
+  Multiverse Compound), it copies original & mip-mapped textures to disk and
+  _publishes_ information to the OpenPype database.
+
+- Load any USD data into Multiverse "Compound" shape nodes.
+
+  This _reads_ USD files (and also Alembic files) into Maya by _streaming_ them
+  to the viewport.
+
+- Rendering USD data procedurally with 3Delight<sup>NSI</sup>, Arnold, Redshift,
+  RenderMan and VRay.
+
+  This reads USD files by _streaming_ them procedurally to the renderer, at
+  render time.
+
+USD files written by Multiverse are 100% native USD data, they can be exchanged
+with any other DCC applications able to interchange USD. Likewise, Multiverse
+can read native USD data created by other applications. The USD extensions are
+supported: `.usd` (binary), `.usda` (ASCII), `.usdz`. (zipped, optionally with
+textures). Sequences of USD files can also be read via "USD clips".
+
+It is also possible to load Alembic data (`.abc`) in Multiverse Compounds,
+further compose it & override it in other USD files, and render it procedurally.
+Alembic data is always converted on the fly (in memory) to USD data. USD clip
+from Alembic data are also supported.
+
+
+### Configuration
+
+To configure Multiverse in OpenPype, an admin privileges needs to setup a new
+OpenPype tool in the OpenPype Project Settings, using a similar configuration as
+the one depicted here:
+
+![Maya - Multiverse Setup](assets/maya-multiverse_setup.png)
+
+For more information about setup of Multiverse please refer to the relative page
+on the [Multiverse official documentation](https://multi-verse.io/docs).
+
+
+### Understanding Assets, Compounds, Compositions, Overrides and Layering
+
+In Multiverse we use some terminology that relates to USD I/O: terms like
+"Assets", "Compounds", "Compositions", "Overrides" and "Layering".
+
+Please hop to the new [Multiverse Introduction](
+https://j-cube.jp/solutions/multiverse/docs/usage/introduction) page on the
+official documentation to understand them before reading the next sections.
+
+
+### Creators
+
+It is possible to create OpenPype "instances" (resulting in Maya set containers)
+for publishing Multiverse USD Assets, Compositions, Overrides and Looks.
+
+When creating OpenPype instances for Multiverse USD Asset, Composition,
+Override and Look, the creator plug-in will put the relative selected data in a
+Maya set node which holds the properties used by the Multiverse data writer for
+publishing.
+
+You can choose the USD file format in the Creators' set nodes:
+
+- Assets: `.usd` (default) or `.usda` or `.usdz`
+- Compositions: `.usda` (default) or `.usd`
+- Overrides: `.usda` (default) or `.usd`
+- Looks: `.ma`
+
+![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_asset_creator.png)
+
+![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_composition_creator.png)
+
+![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_override_creator.png)
+
+![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_look_creator.png)
+
+### Publishers
+
+The relative publishers for Multiverse USD Asset, Composition, Override and Look
+are available. The first three write USD files to disk, while look writes a Maya
+file along with the mip-mapped textures. All communicate publish info to the
+OpenPype database.
+
+![Maya - Multiverse Publisher](assets/maya-multiverse_openpype_publishers.png)
+
+
+### Loader
+
+The loader creates a Multiverse "Compound" shape node reading the USD file of
+choice. All data is _streamed_ to the viewport and not contained in Maya. Thanks
+to the various viewport draw options the user can strategically decide how to
+minimize the cost of viewport draw effectively being able to load any data, this
+allows to bring into Maya scenes of virtually unlimited complexity.
+
+![Maya - Multiverse Loader](assets/maya-multiverse_openpype_loader.png)
+
+:::tip Note
+When using the Loader, Multiverse, by design, never "imports" USD data into the
+Maya scene as Maya data. Instead, when desired, Multiverse permits to import
+specific USD primitives, or entire hierarchies, into the Maya scene as Maya data
+selectively from MEOW, it also tracks what is being imported with a "live
+connection" , so upon modification, it is possible to write (create & publish)
+the modifies data as a USD file for being layered on top of its relative
+Compound. See the [Multiverse Importer](
+https://j-cube.jp/solutions/multiverse/docs/usage/importer)) documentation.
+:::
+
+### Look
+
+In OpenPype a Multiverse Look is the combination of:
+
+- a Maya file that contains the shading networks that were assigned to the items
+  of a Multiverse Compound.
+- a Multiverse USD Override file that contains the material assignment
+  information (which Maya material was assigned to which USD item)
+- mip-mapped textures
+
+Multiverse Look shading networks are typically Maya-referenced in the lighting
+and shot scenes.
+
+Materials are assigned to the USD items in the Compound via the "material
+assignment" information that is output in the lookdev stage by a Multiverse
+Override. Once published the override can be Layered on the Compound so that 
+materials will be assigned to items. Finally, an attribute Override on the root
+item of the Compound is used to define the `namespace` with which the shading
+networks were referenced in Maya. At this point the renderer knows which
+material to assign to which item and it is possible to render and edit the
+materials as usual. Because the material exists in Maya you can perform IPR and
+tune the materials as you please.
+
+The Multiverse Look will also publish textures in optimized mip-map format,
+currently supporting the `.tdl` (Texture Delight) mip map format of the 3Delight
+NSI renderer. MipMaps are required when the relative option is checked and you
+are publishing Multiverse Looks with the `final` or `-` subset, while they are
+not required with the `WIP` or `test` subsets. MipMaps are found automatically
+as long as they exist alongside the original textures. Their generation can be
+automatic when using 3Delight for Maya or can be manual by using the `tdlmake`
+binary utility.
+
+
+### About embedding shading networks in USD
+
+Alternatively, but also complementary to the Multiverse Look, as of Multiverse
+7 it is also possible to write shading networks _inside_ USD files: that is
+achieved by using either the Asset writer (if material are defined in the
+modeling stage) and the Override writer (if materials are defined in the lookdev
+or later stage).
+
+Some interesting consequences of USD shading networks in Multiverse:
+
+1. they can be overridden by a shading network in Maya by assigning in MEOW a
+   Maya material as an override
+2. they are available for assignment in MEOW, so you can assign a USD material
+   to an item as an override
+3. From Hypershade you can use the Multiverse USD shading network write File>
+   Export option to write USD shading network libraries to then layer on an asset
+   and perform 2. again.
+
+Note that:
+
+- Shading networks in USD can then be currently rendered with
+  3Delight<sup>NSI</sup>
+- Shading networks in USD can be used for interchange with DCC apps. Multiverse
+  shading networks are written natively with the USD Shade schema.
+- usdPreviewSurface shading networks are too considered embedded shading
+  networks, though they are classified separately from non-preview / final
+  quality shading networks
+- USDZ files use usdPreviewSurface shading networks, and therefore can be, too,
+  rendered (with 3Delight<sup>NSI</sup>)
+- in case both usdPreviewSurface and final quality shading networks, the latter
+  will be used for rendering (while the former can be previewed in the viewport)  
+- it is possible to disable rendering of any embedded shading network via the
+  relative option in the Compound Attribute Editor.
+
+
+### Rendering
+
+Multiverse offers procedural rendering with all the major production renderers:
+
+- 3Delight<sup>NSI</sup>
+- Arnold
+- Redshift
+- RenderMan
+- VRay
+
+Procedural rendering effectively means that data is _streamed_ to the renderer
+at render-time, without the need to store the data in the Maya scene (this
+effectively means small .ma/.mb files that load fast) nor in the renderer native
+file format scene description file (this effectively means tiny `.nsi` / `.ass`
+/ `.vrscene` / `.rib` files that load fast).
+
+This is completely transparent to the user: Multiverse Compound nodes present in
+the scene, once a render is launched, will stream data to the renderer in a
+procedural fashion.
+
+
+### Example Multiverse Pipeline and API
+
+An example diagram of the data flow in a Maya pipeline using Multiverse is
+available, see the [Multiverse Pipeline](
+https://j-cube.jp/solutions/multiverse/docs/pipeline) documentation.
+
+
+A very easy to use Python API to automate any task is available, the API is
+user friendly and does not require any knowledge of the vast and complex USD
+APIs. See the [Multiverse Python API](
+https://j-cube.jp/solutions/multiverse/docs/dev/python-api.html) documentation.
diff --git a/website/docs/artist_hosts_maya_redshift.md b/website/docs/artist_hosts_maya_redshift.md
new file mode 100644
index 0000000000..268c49d75c
--- /dev/null
+++ b/website/docs/artist_hosts_maya_redshift.md
@@ -0,0 +1,31 @@
+---
+id: artist_hosts_maya_redshift
+title: Redshift for Maya
+sidebar_label: Redshift
+---
+
+## Working with Redshift in OpenPype
+
+### Using Redshift Proxies
+
+OpenPype supports working with Redshift Proxy files. You can create  Redshift Proxy from almost
+any hierarchy in Maya and it will be included there. Redshift can export animation
+proxy file per frame.
+
+### Creating Redshift Proxy
+
+To mark data to publish as Redshift Proxy, select them in Maya and - **OpenPype → Create ...** and
+then select **Redshift Proxy**. You can name your subset and hit **Create** button.
+
+You can enable animation in Attribute Editor:
+
+![Maya - Yeti Rig Setup](assets/maya-create_rs_proxy.jpg)
+
+### Publishing Redshift Proxies
+
+Once data are marked as Redshift Proxy instance, they can be published - **OpenPype → Publish ...**
+
+### Using Redshift Proxies
+
+Published proxy files can be loaded with OpenPype Loader. It will create mesh and attach Redshift Proxy
+parameters to it - Redshift will then represent proxy with bounding box.
diff --git a/website/docs/artist_hosts_maya_vray.md b/website/docs/artist_hosts_maya_vray.md
new file mode 100644
index 0000000000..a19fce9735
--- /dev/null
+++ b/website/docs/artist_hosts_maya_vray.md
@@ -0,0 +1,44 @@
+---
+id: artist_hosts_maya_vray
+title: VRay for Maya
+sidebar_label: VRay
+---
+
+## Working with VRay in OpenPype
+
+### #Using VRay Proxies
+
+OpenPype support publishing, loading and using of VRay Proxy in look management. Their underlying format
+can be either vrmesh or alembic.
+
+:::warning vrmesh or alembic and look management
+Be aware that **vrmesh** cannot be used with looks as it doesn't retain IDs necessary to map shaders to geometry.
+:::
+
+### Creating VRay Proxy
+
+To create VRay Proxy, select geometry you want and - **OpenPype → Create ...** select **VRay Proxy**. Name your
+subset as you want and press **Create** button.
+
+This will create `vrayproxy` set for your subset. You can set some options in Attribute editor, mainly if you want
+export animation instead of single frame.
+
+![Maya - VRay Proxy Creation](assets/maya-vray_proxy.jpg)
+
+### Publishing VRay Proxies
+
+VRay Proxy can be published - **OpenPype → Publish ...**. It will publish data as VRays `vrmesh` format and as
+Alembic file.
+
+## Using VRay Proxies
+
+You can load VRay Proxy using loader - **OpenPype → Loader ...**
+
+![Maya - VRay Proxy Creation](assets/maya-vray_proxy-loader.jpg)
+
+Select your subset and right-click. Select **Import VRay Proxy (vrmesh)** to import it.
+
+:::note
+Note that even if it states `vrmesh` in descriptions, if loader finds Alembic published along (default behavior) it will
+use abc file instead of vrmesh as it is more flexible and without it looks doesn't work.
+:::
diff --git a/website/docs/artist_hosts_maya_xgen.md b/website/docs/artist_hosts_maya_xgen.md
new file mode 100644
index 0000000000..8b0174a29f
--- /dev/null
+++ b/website/docs/artist_hosts_maya_xgen.md
@@ -0,0 +1,29 @@
+---
+id: artist_hosts_maya_xgen
+title: Xgen for Maya
+sidebar_label: Xgen
+---
+
+## Working with Xgen in OpenPype
+
+OpenPype support publishing and loading of Xgen interactive grooms. You can publish 
+them as mayaAscii files with scalps that can be loaded into another maya scene, or as
+alembic caches. 
+
+### Publishing Xgen Grooms
+
+To prepare xgen for publishing just select all the descriptions that should be published together and the create Xgen Subset in the scene using - **OpenPype menu** → **Create**... and select **Xgen Interactive**. Leave Use selection checked.
+
+For actual publishing of your groom to go **OpenPype → Publish** and then press ▶ to publish. This will export `.ma` file containing your grooms with any geometries they are attached to and also a baked cache in `.abc` format 
+
+
+:::tip adding more descriptions
+You can add multiple xgen description into the subset you are about to publish, simply by
+adding them to the maya set that was created for you. Please make sure that only xgen description nodes are present inside of the set and not the scalp geometry. 
+:::
+
+### Loading Xgen
+
+You can use published xgens by loading them using OpenPype Publisher. You can choose to reference or import xgen. We don't have any automatic mesh linking at the moment and it is expected, that groom is published with a scalp, that can then be manually attached to your animated mesh for example. 
+
+The alembic representation can be loaded too and it contains the groom converted to curves. Keep in mind that the density of the alembic directly depends on your viewport xgen density at the point of export.
diff --git a/website/docs/artist_hosts_maya_yeti.md b/website/docs/artist_hosts_maya_yeti.md
new file mode 100644
index 0000000000..f5a6a4d2c9
--- /dev/null
+++ b/website/docs/artist_hosts_maya_yeti.md
@@ -0,0 +1,108 @@
+---
+id: artist_hosts_maya_yeti
+title: Yeti for Maya
+sidebar_label: Yeti
+---
+
+## Working with Yeti in OpenPype
+
+OpenPype can work with [Yeti](https://peregrinelabs.com/yeti/) in two data modes.
+It can handle Yeti caches and Yeti rigs.
+
+### Creating and publishing Yeti caches
+
+Let start by creating simple Yeti setup, just one object and Yeti node. Open new
+empty scene in Maya and create sphere. Then select sphere and go **Yeti → Create Yeti Node on Mesh**
+Open Yeti node graph **Yeti → Open Graph Editor** and create setup like this:
+
+![Maya - Yeti Basic Graph](assets/maya-yeti_basic_setup.jpg)
+
+It doesn't matter what setting you use now, just select proper shape in first
+*Import* node. Select your Yeti node and create *Yeti Cache instance* - **OpenPype → Create...**
+and select **Yeti Cache**. Leave `Use selection` checked. You should end up with this setup:
+
+![Maya - Yeti Basic Setup](assets/maya-yeti_basic_setup_outline.jpg)
+
+You can see there is `yeticacheDefault` set. Instead of *Default* it could be named with
+whatever name you've entered in `subset` field during instance creation.
+
+We are almost ready for publishing cache. You can check basic settings by selecting
+Yeti cache set and opening *Extra attributes* in Maya **Attribute Editor**.
+
+![Maya - Yeti Basic Setup](assets/maya-yeti_cache_attributes.jpg)
+
+Those attributes there are self-explanatory, but:
+
+- `Preroll` is number of frames simulation will run before cache frames are stored.
+This is useful to "steady" simulation for example.
+- `Frame Start` from what frame we start to store cache files
+- `Frame End` to what frame we are storing cache files
+- `Fps` of cache
+- `Samples` how many time samples we take during caching
+
+You can now publish Yeti cache as any other types. **OpenPype → Publish**. It will
+create sequence of `.fur` files and `.fursettings` metadata file with Yeti node
+setting.
+
+### Loading Yeti caches
+
+You can load Yeti cache by **OpenPype → Load ...**. Select your cache, right+click on
+it and select **Load Yeti cache**. This will create Yeti node in scene and set its
+cache path to point to your published cache files. Note that this Yeti node will
+be named with same name as the one you've used to publish cache. Also notice that
+when you open graph on this Yeti node, all nodes are as they were in publishing node.
+
+### Creating and publishing Yeti Rig
+
+Yeti Rigs are working in similar way as caches, but are more complex and they deal with
+other data used by Yeti, like geometry and textures.
+
+Let's start by [loading](artist_hosts_maya.md#loading-model) into new scene some model.
+I've loaded my Buddha model.
+
+Create select model mesh, create Yeti node - **Yeti → Create Yeti Node on Mesh** and
+setup similar Yeti graph as in cache example above.
+
+Then select this Yeti node (mine is called with default name `pgYetiMaya1`) and
+create *Yeti Rig instance* - **OpenPype → Create...** and select **Yeti Cache**.
+Leave `Use selection` checked.
+
+Last step is to add our model geometry to rig instance, so middle+drag its
+geometry to `input_SET` under `yetiRigDefault` set representing rig instance.
+Note that its name can differ and is based on your subset name.
+
+![Maya - Yeti Rig Setup](assets/maya-yeti_rig.jpg)
+
+Save your scene and ready for publishing our new simple Yeti Rig!
+
+Go to publish **OpenPype → Publish** and run. This will publish rig with its geometry
+as `.ma` scene, save Yeti node settings and export one frame of Yeti cache from
+the beginning of your timeline. It will also collect all textures used in Yeti
+node, copy them to publish folder `resource` directory and set *Image search path*
+of published node to this location.
+
+:::note Collect Yeti Cache failure
+If you encounter **Collect Yeti Cache** failure during collecting phase, and the error is like
+```fix
+No object matches name: pgYetiMaya1Shape.cbId
+```
+then it is probably caused by scene not being saved before publishing.
+:::
+
+### Loading Yeti Rig
+
+You can load published Yeti Rigs as any other thing in OpenPype - **OpenPype → Load ...**,
+select you Yeti rig and right+click on it. In context menu you should see
+**Load Yeti Cache** and **Load Yeti Rig** items (among others). First one will
+load that one frame cache. The other one will load whole rig.
+
+Notice that although we put only geometry into `input_SET`, whole hierarchy was
+pulled inside also. This allows you to store complex scene element along Yeti
+node.
+
+:::tip auto-connecting rig mesh to existing one
+If you select some objects before loading rig it will try to find shapes
+under selected hierarchies and match them with shapes loaded with rig (published
+under `input_SET`). This mechanism uses *cbId* attribute on those shapes.
+If match is found shapes are connected using their `outMesh` and `outMesh`. Thus you can easily connect existing animation to loaded rig.
+:::
diff --git a/website/docs/assets/maya-multiverse_openpype_look_creator.png b/website/docs/assets/maya-multiverse_openpype_look_creator.png
index 14541e9e398fc99e3910d50a5286bdd8906b9f1a..fd27d5fd1af7d8ac4d9bc83799c52972615f251e 100644
GIT binary patch
literal 125727
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
Pp4Go+au<Ea>Dm7PT|Bi*

literal 26190
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
XNN#wif}p^6lEBGJD?=(?y$$*wxlGVg

diff --git a/website/docs/assets/maya-multiverse_openpype_publishers.png b/website/docs/assets/maya-multiverse_openpype_publishers.png
index b83fa5f59cd95ac8f6feab2e043fb9514ab257a7..bee6c79fe9802337520574fc619da0b63b62918b 100644
GIT binary patch
literal 309158
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%0Dj1JpW~1Q|YqP!3
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%0A{^xbkk2>37iiz1t7NI7
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
P;73eI>PLluj_>~hJy=nv

literal 182542
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

diff --git a/website/sidebars.js b/website/sidebars.js
index 105afc30eb..b105e6ea93 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -19,7 +19,18 @@ module.exports = {
             items: [
                 "artist_hosts_hiero",
                 "artist_hosts_nuke_tut",
-                "artist_hosts_maya",
+                {
+                    type: "category",
+                    label: "Maya",
+                    items: [
+                        "artist_hosts_maya",
+                        "artist_hosts_maya_multiverse",
+                        "artist_hosts_maya_yeti",
+                        "artist_hosts_maya_xgen",
+                        "artist_hosts_maya_vray",
+                        "artist_hosts_maya_redshift",
+                    ],
+                },
                 "artist_hosts_blender",
                 "artist_hosts_harmony",
                 "artist_hosts_houdini",

From 5c8e7fd3305dc67d339e49837d0a224961e274e3 Mon Sep 17 00:00:00 2001
From: pberto <pberto@gmail.com>
Date: Tue, 31 May 2022 14:36:06 +0900
Subject: [PATCH 0411/1227] docstring: addressing trailing whitespaces to
 placate the hound

---
 openpype/hosts/maya/plugins/publish/extract_multiverse_look.py  | 1 -
 openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py   | 2 +-
 .../hosts/maya/plugins/publish/extract_multiverse_usd_comp.py   | 2 +-
 .../hosts/maya/plugins/publish/extract_multiverse_usd_over.py   | 2 +-
 4 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py
index d59d03ee58..82e2b41929 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_look.py
@@ -31,7 +31,6 @@ class ExtractMultiverseLook(openpype.api.Extractor):
     Note: when layering the material assignment override on a loaded Compound,
           remember to set a matching attribute override with the namespace of
           the loaded compound in order for the material assignment to resolve.
-
     """
 
     label = "Extract Multiverse USD Look"
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
index 0671813c32..b1aaf9d9ba 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
@@ -21,7 +21,7 @@ class ExtractMultiverseUsd(openpype.api.Extractor):
       instancers, pfx, MASH, lights, cameras, joints, connected materials,
       shading networks etc. including many of their attributes.
 
-    Upon publish a .usd (or .usdz) asset file will be typically written.  
+    Upon publish a .usd (or .usdz) asset file will be typically written.
     """
 
     label = "Extract Multiverse USD Asset"
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
index 45d0cad368..c85b3b6664 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
@@ -20,7 +20,7 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
     - a single Compound node with more than one layer (in this case the "Write
       as Compound Layers" option should be set).
 
-    Upon publish a .usda composition file will be written.  
+    Upon publish a .usda composition file will be written.
     """
 
     label = "Extract Multiverse USD Composition"
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
index 8b14ac3388..4856f0cfdb 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
@@ -18,7 +18,7 @@ class ExtractMultiverseUsdOverride(openpype.api.Extractor):
     - a single Multiverse Compound node with any number of overrides (typically
       set in MEOW)
 
-    Upon publish a .usda override file will be written.  
+    Upon publish a .usda override file will be written.
     """
 
     label = "Extract Multiverse USD Override"

From 45e0e39ea1e262044e1764f546943f4b436dc926 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Tue, 31 May 2022 11:39:03 +0200
Subject: [PATCH 0412/1227] :sparkles: add support for skeletalMesh and
 staticMesh to loaders

---
 openpype/hosts/unreal/plugins/load/load_rig.py           | 2 +-
 openpype/hosts/unreal/plugins/load/load_staticmeshfbx.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/unreal/plugins/load/load_rig.py b/openpype/hosts/unreal/plugins/load/load_rig.py
index c27bd23aaf..227c5c9292 100644
--- a/openpype/hosts/unreal/plugins/load/load_rig.py
+++ b/openpype/hosts/unreal/plugins/load/load_rig.py
@@ -14,7 +14,7 @@ import unreal  # noqa
 class SkeletalMeshFBXLoader(plugin.Loader):
     """Load Unreal SkeletalMesh from FBX."""
 
-    families = ["rig"]
+    families = ["rig", "skeletalMesh"]
     label = "Import FBX Skeletal Mesh"
     representations = ["fbx"]
     icon = "cube"
diff --git a/openpype/hosts/unreal/plugins/load/load_staticmeshfbx.py b/openpype/hosts/unreal/plugins/load/load_staticmeshfbx.py
index 282d249947..351c686095 100644
--- a/openpype/hosts/unreal/plugins/load/load_staticmeshfbx.py
+++ b/openpype/hosts/unreal/plugins/load/load_staticmeshfbx.py
@@ -14,7 +14,7 @@ import unreal  # noqa
 class StaticMeshFBXLoader(plugin.Loader):
     """Load Unreal StaticMesh from FBX."""
 
-    families = ["model", "unrealStaticMesh"]
+    families = ["model", "staticMesh"]
     label = "Import FBX Static Mesh"
     representations = ["fbx"]
     icon = "cube"

From 9c1b1f11e97dfb7deff3c3b76a6ed9058771451b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 31 May 2022 13:52:29 +0200
Subject: [PATCH 0413/1227] updated windows oiio tool to v 2.3.10

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 47d678b5e8..6b98178aa8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -126,7 +126,7 @@ url = "https://distribute.openpype.io/thirdparty/ffmpeg-4.4-macos.tgz"
 hash = "95f43568338c275f80dc0cab1e1836a2e2270f856f0e7b204440d881dd74fbdb"
 
 [openpype.thirdparty.oiio.windows]
-url = "https://distribute.openpype.io/thirdparty/oiio_tools-2.2.0-windows.zip"
+url = "https://distribute.openpype.io/thirdparty/oiio_tools-2.3.10-windows.zip"
 hash = "fd2e00278e01e85dcee7b4a6969d1a16f13016ec16700fb0366dbb1b1f3c37ad"
 
 [openpype.thirdparty.oiio.linux]

From 5464fd40850ae1d25c1b467149249bd5edaaae9e Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 31 May 2022 13:58:11 +0200
Subject: [PATCH 0414/1227] OP-2787 - fix extractors could be run on a farm

---
 openpype/hosts/maya/plugins/publish/extract_animation.py  | 3 +++
 openpype/hosts/maya/plugins/publish/extract_pointcache.py | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_animation.py b/openpype/hosts/maya/plugins/publish/extract_animation.py
index 1ccc8f5cfe..8f2bc26d08 100644
--- a/openpype/hosts/maya/plugins/publish/extract_animation.py
+++ b/openpype/hosts/maya/plugins/publish/extract_animation.py
@@ -16,11 +16,14 @@ class ExtractAnimation(openpype.api.Extractor):
     Positions and normals, uvs, creases are preserved, but nothing more,
     for plain and predictable point caches.
 
+    Plugin can run locally or remotely (on a farm - if instance is marked with
+    "farm" it will be skipped in local processing, but processed on farm)
     """
 
     label = "Extract Animation"
     hosts = ["maya"]
     families = ["animation"]
+    targets = ["local", "remote"]
 
     def process(self, instance):
         if instance.data.get("farm"):
diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index ff3d97ded1..5606ea9459 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -16,6 +16,8 @@ class ExtractAlembic(openpype.api.Extractor):
     Positions and normals, uvs, creases are preserved, but nothing more,
     for plain and predictable point caches.
 
+    Plugin can run locally or remotely (on a farm - if instance is marked with
+    "farm" it will be skipped in local processing, but processed on farm)
     """
 
     label = "Extract Pointcache (Alembic)"
@@ -23,6 +25,7 @@ class ExtractAlembic(openpype.api.Extractor):
     families = ["pointcache",
                 "model",
                 "vrayproxy"]
+    targets = ["local", "remote"]
 
     def process(self, instance):
         if instance.data.get("farm"):

From 376ddc41329206173f2d8f4e9d568e0aef4cebc3 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 31 May 2022 14:01:23 +0200
Subject: [PATCH 0415/1227] OP-2787 - added raising error for Deadline

---
 openpype/lib/remote_publish.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/openpype/lib/remote_publish.py b/openpype/lib/remote_publish.py
index da2497e1a5..d7884d0200 100644
--- a/openpype/lib/remote_publish.py
+++ b/openpype/lib/remote_publish.py
@@ -60,7 +60,7 @@ def start_webpublish_log(dbcon, batch_id, user):
     }).inserted_id
 
 
-def publish(log, close_plugin_name=None):
+def publish(log, close_plugin_name=None, raise_error=False):
     """Loops through all plugins, logs to console. Used for tests.
 
         Args:
@@ -79,10 +79,15 @@ def publish(log, close_plugin_name=None):
                 result["plugin"].label, record.msg))
 
         if result["error"]:
-            log.error(error_format.format(**result))
+            error_message = error_format.format(**result)
+            log.error(error_message)
             if close_plugin:  # close host app explicitly after error
                 context = pyblish.api.Context()
                 close_plugin().process(context)
+            if raise_error:
+                # Fatal Error is because of Deadline
+                error_message = "Fatal Error: " + error_format.format(**result)
+                raise RuntimeError(error_message)
 
 
 def publish_and_log(dbcon, _id, log, close_plugin_name=None, batch_id=None):

From 8de1cbf7320f792e0d6cf8e2709f918a9d8c4ddd Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 31 May 2022 14:15:05 +0200
Subject: [PATCH 0416/1227] OP-2787 - fixed resolution order

---
 openpype/hosts/maya/api/pipeline.py | 16 ++++++++--------
 openpype/scripts/remote_publish.py  |  3 ++-
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index 6fc93e864f..0261694be2 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -66,20 +66,20 @@ def install():
     log.info("Installing callbacks ... ")
     register_event_callback("init", on_init)
 
-    # Callbacks below are not required for headless mode, the `init` however
-    # is important to load referenced Alembics correctly at rendertime.
+    if os.environ.get("HEADLESS_PUBLISH"):
+        # Maya launched on farm, lib.IS_HEADLESS might be triggered locally too
+        # target "farm" == rendering on farm, expects OPENPYPE_PUBLISH_DATA
+        # target "remote" == remote execution
+        print("Registering pyblish target: remote")
+        pyblish.api.register_target("remote")
+        return
+
     if lib.IS_HEADLESS:
         log.info(("Running in headless mode, skipping Maya "
                  "save/open/new callback installation.."))
 
         return
 
-    if os.environ.get("HEADLESS_PUBLISH"):
-        # Maya launched on farm, lib.IS_HEADLESS might be triggered locally too
-        print("Registering pyblish target: remote")
-        pyblish.api.register_target("remote")
-        return
-
     print("Registering pyblish target: local")
     pyblish.api.register_target("local")
 
diff --git a/openpype/scripts/remote_publish.py b/openpype/scripts/remote_publish.py
index b54c8d931b..8e5c91d663 100644
--- a/openpype/scripts/remote_publish.py
+++ b/openpype/scripts/remote_publish.py
@@ -1,6 +1,7 @@
 try:
     from openpype.api import Logger
     import openpype.lib.remote_publish
+    import pyblish.api
 except ImportError as exc:
     # Ensure Deadline fails by output an error that contains "Fatal Error:"
     raise ImportError("Fatal Error: %s" % exc)
@@ -8,4 +9,4 @@ except ImportError as exc:
 if __name__ == "__main__":
     # Perform remote publish with thorough error checking
     log = Logger.get_logger(__name__)
-    openpype.lib.remote_publish.publish(log)
+    openpype.lib.remote_publish.publish(log, raise_error=True)

From 2dd79b32e7ebbc3caaf863484806569bf62ab1f3 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 31 May 2022 14:15:25 +0200
Subject: [PATCH 0417/1227] OP-2787 - removed unnecessary family

---
 .../deadline/plugins/publish/collect_publishable_instances.py    | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/modules/deadline/plugins/publish/collect_publishable_instances.py b/openpype/modules/deadline/plugins/publish/collect_publishable_instances.py
index 741a2a5af8..b00381b6cf 100644
--- a/openpype/modules/deadline/plugins/publish/collect_publishable_instances.py
+++ b/openpype/modules/deadline/plugins/publish/collect_publishable_instances.py
@@ -34,7 +34,6 @@ class CollectDeadlinePublishableInstances(pyblish.api.InstancePlugin):
             self.log.debug("Publish {}".format(subset_name))
             instance.data["publish"] = True
             instance.data["farm"] = False
-            instance.data["families"].remove("deadline")
         else:
             self.log.debug("Skipping {}".format(subset_name))
             instance.data["publish"] = False

From b6e6b7ae69f92aa540a3af146249d8ba0db4fd93 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 31 May 2022 15:17:52 +0300
Subject: [PATCH 0418/1227] refactor cleanup

---
 openpype/plugins/publish/extract_jpeg_exr.py | 32 ++++++++------------
 1 file changed, 12 insertions(+), 20 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 88fa627183..8211c1a255 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -46,13 +46,9 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         if not profile:
             return
 
-        oiio_path = get_oiio_tools_path()
+        
         # Raise an exception when oiiotool is not available
 
-        if not os.path.exists(oiio_path):
-            KnownPublishError(
-                "OpenImageIO tool is not available on this machine."
-            )
         self.log.info("subset {}".format(instance.data['subset']))
 
         # skip crypto passes.
@@ -167,18 +163,10 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                     "thumbnail": True,
                     "tags": ["thumbnail"]
                 }
-
                 # adding representation
                 self.log.debug("Adding: {}".format(new_repre))
                 instance.data["representations"].append(new_repre)
-            elif repre["ext"] == "exr":
-                oiio_support = is_oiio_supported()
-                if oiio_support:
-                    # TODO: Add resolution checking, possibly check for other
-                    # places where things may break
-                    oiio_tool_path = get_oiio_tools_path()
-                    full_output_path = os.path.join(stagingdir, jpeg_file)
-                    
+            
 
     def _get_filtered_repres(self, instance):
         filtered_repres = []
@@ -199,22 +187,26 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             filtered_repres.append(repre)
         return filtered_repres
 
-
-    def create_thumbnail_oiio(self, src_path, dst_path):
+    def create_thumbnail_oiio(self, instance, src_path, dst_path):
+        oiio_path = get_oiio_tools_path()
+        if not os.path.exists(oiio_path):
+            KnownPublishError(
+                "OpenImageIO tool is not available on this machine."
+            )
         args = [oiio_tool_path]
         oiio_cmd = [oiio_tool_path,
-                    full_input_path, "-o",
-                    full_output_path
+                    src_path, "-o",
+                    dst_path
                     ]
         subprocess_exr = " ".join(oiio_cmd)
         self.log.info(f"running: {subprocess_exr}")
         run_subprocess(subprocess_exr, logger=self.log)
 
         # raise error if there is no ouptput
-        if not os.path.exists(full_input_path):
+        if not os.path.exists(src_path):
             self.log.error(
                 ("File {} was not converted "
-                    "by oiio tool!").format(full_input_path))
+                    "by oiio tool!").format(src_path))
             raise AssertionError("OIIO tool conversion failed")
         failed_output = "oiiotool produced no output."
         output = run_subprocess(args)

From d37815467a059cfa2ad2dbde6ce4025ec00def2d Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 31 May 2022 14:20:50 +0200
Subject: [PATCH 0419/1227] OP-2787 - added extracted path to explicit cleanup

---
 openpype/hosts/maya/plugins/publish/extract_animation.py  | 2 ++
 openpype/hosts/maya/plugins/publish/extract_pointcache.py | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_animation.py b/openpype/hosts/maya/plugins/publish/extract_animation.py
index 8f2bc26d08..abe5ed3bf5 100644
--- a/openpype/hosts/maya/plugins/publish/extract_animation.py
+++ b/openpype/hosts/maya/plugins/publish/extract_animation.py
@@ -95,4 +95,6 @@ class ExtractAnimation(openpype.api.Extractor):
         }
         instance.data["representations"].append(representation)
 
+        instance.context.data["cleanupFullPaths"].append(path)
+
         self.log.info("Extracted {} to {}".format(instance, dirname))
diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index 5606ea9459..c4c8610ebb 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -98,4 +98,6 @@ class ExtractAlembic(openpype.api.Extractor):
         }
         instance.data["representations"].append(representation)
 
+        instance.context.data["cleanupFullPaths"].append(path)
+
         self.log.info("Extracted {} to {}".format(instance, dirname))

From 0d7d43316b94685f78fb0a7e2e39153a98996b36 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 31 May 2022 14:44:37 +0200
Subject: [PATCH 0420/1227] OP-2787 - changed class to api.Integrator

This plugin should run only locally, not no a farm.
---
 .../plugins/publish/submit_maya_remote_publish_deadline.py     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
index 196adc5906..c31052be07 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
@@ -5,11 +5,12 @@ from maya import cmds
 
 from openpype.pipeline import legacy_io, PublishXmlValidationError
 from openpype.settings import get_project_settings
+import openpype.api
 
 import pyblish.api
 
 
-class MayaSubmitRemotePublishDeadline(pyblish.api.InstancePlugin):
+class MayaSubmitRemotePublishDeadline(openpype.api.Integrator):
     """Submit Maya scene to perform a local publish in Deadline.
 
     Publishing in Deadline can be helpful for scenes that publish very slow.

From 55a69074c6b550b4e30d99b658b9ec664d30214b Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 31 May 2022 14:46:05 +0200
Subject: [PATCH 0421/1227] OP-2787 - Hound

---
 openpype/scripts/remote_publish.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/scripts/remote_publish.py b/openpype/scripts/remote_publish.py
index 8e5c91d663..d322f369d1 100644
--- a/openpype/scripts/remote_publish.py
+++ b/openpype/scripts/remote_publish.py
@@ -1,7 +1,6 @@
 try:
     from openpype.api import Logger
     import openpype.lib.remote_publish
-    import pyblish.api
 except ImportError as exc:
     # Ensure Deadline fails by output an error that contains "Fatal Error:"
     raise ImportError("Fatal Error: %s" % exc)

From 26332ef0c8e7eccc1022b95ef883c6850a907681 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 31 May 2022 15:00:15 +0200
Subject: [PATCH 0422/1227] fix file hash

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 6b98178aa8..d398257f6b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -127,7 +127,7 @@ hash = "95f43568338c275f80dc0cab1e1836a2e2270f856f0e7b204440d881dd74fbdb"
 
 [openpype.thirdparty.oiio.windows]
 url = "https://distribute.openpype.io/thirdparty/oiio_tools-2.3.10-windows.zip"
-hash = "fd2e00278e01e85dcee7b4a6969d1a16f13016ec16700fb0366dbb1b1f3c37ad"
+hash = "b9950f5d2fa3720b52b8be55bacf5f56d33f9e029d38ee86534995f3d8d253d2"
 
 [openpype.thirdparty.oiio.linux]
 url = "https://distribute.openpype.io/thirdparty/oiio_tools-2.2.12-linux.tgz"

From 735942a6f53ca3a36ab1b60ebe462b25a5841abe Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 31 May 2022 16:44:18 +0200
Subject: [PATCH 0423/1227] Nuke: simplify duplicate node function

---
 openpype/hosts/nuke/api/lib.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 3871381451..7bb8c1e3d1 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -2567,8 +2567,7 @@ def duplicate_node(node):
     reset_selection()
 
     # select required node for duplication
-    node_orig = nuke.toNode(node.name())
-    node_orig.setSelected(True)
+    node.setSelected(True)
 
     # copy selected to clipboard
     nuke.nodeCopy("%clipboard%")
@@ -2577,10 +2576,7 @@ def duplicate_node(node):
     reset_selection()
 
     # paste node and selection is on it only
-    nuke.nodePaste("%clipboard%")
-
-    # assign to variable
-    dupli_node = nuke.selectedNode()
+    dupli_node = nuke.nodePaste("%clipboard%")
 
     # reset selection
     reset_selection()

From 2de4044167d5940c13bd768ad29879aa9d007b47 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 31 May 2022 16:44:37 +0200
Subject: [PATCH 0424/1227] Nuke: remove callback always

---
 openpype/hosts/nuke/api/lib.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 7bb8c1e3d1..3062091ba0 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -2384,6 +2384,8 @@ def process_workfile_builder():
         env_value_to_bool,
         get_custom_workfile_template
     )
+    # to avoid looping of the callback, remove it!
+    nuke.removeOnCreate(process_workfile_builder, nodeClass="Root")
 
     # get state from settings
     workfile_builder = get_current_project_settings()["nuke"].get(
@@ -2439,9 +2441,6 @@ def process_workfile_builder():
     if not openlv_on or not os.path.exists(last_workfile_path):
         return
 
-    # to avoid looping of the callback, remove it!
-    nuke.removeOnCreate(process_workfile_builder, nodeClass="Root")
-
     log.info("Opening last workfile...")
     # open workfile
     open_file(last_workfile_path)

From b073853a0b1d056a0976b5a3f983184bfb195d2e Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 31 May 2022 18:58:13 +0200
Subject: [PATCH 0425/1227] Update
 openpype/settings/entities/schemas/projects_schema/schema_project_maya.json

Co-authored-by: Milan Kolar <mkolar@users.noreply.github.com>
---
 .../entities/schemas/projects_schema/schema_project_maya.json   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json b/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
index f9523b1baa..f7d92c385e 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
@@ -25,7 +25,7 @@
                 {
                     "type": "boolean",
                     "key": "use_env_var_as_root",
-                    "label": "Use env var placeholder in referenced url",
+                    "label": "Use env var placeholder in referenced paths",
                     "docstring": "Use ${} placeholder instead of physical value of root when storing into workfile metadata."
                 },
                 {

From 6530fbd918f795077f0a715827e101c97b4bc8ea Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 31 May 2022 18:58:28 +0200
Subject: [PATCH 0426/1227] Update
 openpype/settings/entities/schemas/projects_schema/schema_project_maya.json

Co-authored-by: Milan Kolar <mkolar@users.noreply.github.com>
---
 .../entities/schemas/projects_schema/schema_project_maya.json   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json b/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
index f7d92c385e..40e98b0333 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_maya.json
@@ -26,7 +26,7 @@
                     "type": "boolean",
                     "key": "use_env_var_as_root",
                     "label": "Use env var placeholder in referenced paths",
-                    "docstring": "Use ${} placeholder instead of physical value of root when storing into workfile metadata."
+                    "docstring": "Use ${} placeholder instead of absolute value of a root in referenced filepaths."
                 },
                 {
                     "type": "boolean",

From 5be6f27eb19c76e78ec197358930f2d3de417c4d Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Wed, 1 Jun 2022 04:12:29 +0000
Subject: [PATCH 0427/1227] [Automated] Bump version

---
 CHANGELOG.md        | 29 +++++++++++++----------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 15 insertions(+), 18 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4a5e1f1067..6613985ccf 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,20 +1,28 @@
 # Changelog
 
-## [3.10.1-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.10.1-nightly.2](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.10.0...HEAD)
 
 **🚀 Enhancements**
 
+- General: Updated windows oiio tool [\#3268](https://github.com/pypeclub/OpenPype/pull/3268)
 - TVPaint: Init file for TVPaint worker also handle guideline images [\#3250](https://github.com/pypeclub/OpenPype/pull/3250)
-- Support for Unreal 5 [\#3122](https://github.com/pypeclub/OpenPype/pull/3122)
+- Nuke: Change default icon path in settings [\#3247](https://github.com/pypeclub/OpenPype/pull/3247)
 
 **🐛 Bug fixes**
 
+- Nuke: bake reformat was failing on string type [\#3261](https://github.com/pypeclub/OpenPype/pull/3261)
+- Maya: hotfix Pxr multitexture in looks [\#3260](https://github.com/pypeclub/OpenPype/pull/3260)
 - Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
 - Unreal: Fixed Animation loading in UE5 [\#3240](https://github.com/pypeclub/OpenPype/pull/3240)
 - Unreal: Fixed Render creation in UE5 [\#3239](https://github.com/pypeclub/OpenPype/pull/3239)
 - Unreal: Fixed Camera loading in UE5 [\#3238](https://github.com/pypeclub/OpenPype/pull/3238)
+- Flame: debugging [\#3224](https://github.com/pypeclub/OpenPype/pull/3224)
+
+**Merged pull requests:**
+
+- Nuke: add pointcache and animation to loader [\#3186](https://github.com/pypeclub/OpenPype/pull/3186)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
@@ -25,7 +33,6 @@
 - General: OpenPype modules publish plugins are registered in host [\#3180](https://github.com/pypeclub/OpenPype/pull/3180)
 - General: Creator plugins from addons can be registered [\#3179](https://github.com/pypeclub/OpenPype/pull/3179)
 - Ftrack: Single image reviewable [\#3157](https://github.com/pypeclub/OpenPype/pull/3157)
-- Nuke: Expose write attributes to settings [\#3123](https://github.com/pypeclub/OpenPype/pull/3123)
 
 **🚀 Enhancements**
 
@@ -45,8 +52,6 @@
 - Houdini: Add loader for alembic through Alembic Archive node [\#3140](https://github.com/pypeclub/OpenPype/pull/3140)
 - Publisher: UI Modifications and fixes [\#3139](https://github.com/pypeclub/OpenPype/pull/3139)
 - General: Simplified OP modules/addons import [\#3137](https://github.com/pypeclub/OpenPype/pull/3137)
-- Terminal: Tweak coloring of TrayModuleManager logging enabled states [\#3133](https://github.com/pypeclub/OpenPype/pull/3133)
-- General: Cleanup some Loader docstrings [\#3131](https://github.com/pypeclub/OpenPype/pull/3131)
 
 **🐛 Bug fixes**
 
@@ -70,17 +75,18 @@
 - General: Oiio conversion for ffmpeg checks for invalid characters [\#3166](https://github.com/pypeclub/OpenPype/pull/3166)
 - Fix for attaching render to subset [\#3164](https://github.com/pypeclub/OpenPype/pull/3164)
 - Harmony: fixed missing task name in render instance [\#3163](https://github.com/pypeclub/OpenPype/pull/3163)
+- add silent audio to slate [\#3162](https://github.com/pypeclub/OpenPype/pull/3162)
 - Ftrack: Action delete old versions formatting works [\#3152](https://github.com/pypeclub/OpenPype/pull/3152)
+- nuke: adding extract thumbnail settings [\#3148](https://github.com/pypeclub/OpenPype/pull/3148)
 - Deadline: fix the output directory [\#3144](https://github.com/pypeclub/OpenPype/pull/3144)
 - General: New Session schema [\#3141](https://github.com/pypeclub/OpenPype/pull/3141)
 - General: Missing version on headless mode crash properly [\#3136](https://github.com/pypeclub/OpenPype/pull/3136)
 - TVPaint: Composite layers in reversed order [\#3135](https://github.com/pypeclub/OpenPype/pull/3135)
-- Nuke: fix anatomy imageio regex default [\#3119](https://github.com/pypeclub/OpenPype/pull/3119)
+- TVPaint: Composite layers in reversed order [\#3134](https://github.com/pypeclub/OpenPype/pull/3134)
 
 **🔀 Refactored code**
 
 - Avalon repo removed from Jobs workflow [\#3193](https://github.com/pypeclub/OpenPype/pull/3193)
-- General: Remove remaining imports from avalon [\#3130](https://github.com/pypeclub/OpenPype/pull/3130)
 
 **Merged pull requests:**
 
@@ -128,7 +134,6 @@
 **🐛 Bug fixes**
 
 - Ftrack: Action delete old versions formatting works [\#3154](https://github.com/pypeclub/OpenPype/pull/3154)
-- nuke: adding extract thumbnail settings [\#3148](https://github.com/pypeclub/OpenPype/pull/3148)
 
 **Merged pull requests:**
 
@@ -138,14 +143,6 @@
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.9.5...3.9.6)
 
-**🆕 New features**
-
-- Nuke: render instance with subset name filtered overrides \(3.9.x\) [\#3125](https://github.com/pypeclub/OpenPype/pull/3125)
-
-**🐛 Bug fixes**
-
-- TVPaint: Composite layers in reversed order [\#3134](https://github.com/pypeclub/OpenPype/pull/3134)
-
 ## [3.9.5](https://github.com/pypeclub/OpenPype/tree/3.9.5) (2022-04-25)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.10.0-nightly.2...3.9.5)
diff --git a/openpype/version.py b/openpype/version.py
index 12f25cdcea..1d8ef28225 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.10.1-nightly.1"
+__version__ = "3.10.1-nightly.2"
diff --git a/pyproject.toml b/pyproject.toml
index d398257f6b..27b32cf53b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.10.1-nightly.1" # OpenPype
+version = "3.10.1-nightly.2" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From ca9c06df18bd7ff16ee7bae5ba7f4ef51ac383f7 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 1 Jun 2022 08:03:05 +0300
Subject: [PATCH 0428/1227] continue refactor

---
 openpype/plugins/publish/extract_jpeg_exr.py | 104 +++++++------------
 1 file changed, 37 insertions(+), 67 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 8211c1a255..4ffacf2600 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -13,6 +13,8 @@ from openpype.lib import (
     filter_profiles,
     run_subprocess,
     path_to_subprocess_arg,
+
+    execute,
 )
 
 
@@ -46,9 +48,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         if not profile:
             return
 
-        
-        # Raise an exception when oiiotool is not available
-
         self.log.info("subset {}".format(instance.data['subset']))
 
         # skip crypto passes.
@@ -67,7 +66,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             return
 
         filtered_repres = self._get_filtered_repres(instance)
-
         for repre in filtered_repres:
             # Presumably the following is not needed since we are being
             # explicit
@@ -112,61 +110,42 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             jpeg_file = filename + "jpg"
             full_output_path = os.path.join(stagingdir, jpeg_file)
             # If it's a movie file, use ffmpeg
-            if repre["ext"] == "mov":
-                self.log.info("output {}".format(full_output_path))
 
-                ffmpeg_path = get_ffmpeg_tool_path("ffmpeg")
-                ffmpeg_args = self.ffmpeg_args or {}
+        thumbnail_created = False
+        # Try to use FFMPEG if OIIO is not supported (for cases when oiiotool 
+        # isn't available)
+        if not is_oiio_supported():
+            thumbnail_created = self.create_thumbnail_ffmpeg(src_path, dst_path)
+        else:
+            # Check if the file can be read by OIIO
+            args = [
+                oiiotool_path, "--info", "-i", src_path
+            ]
+            returncode = execute(args, silent=True)
+            # If the input can read by OIIO then use OIIO method for conversion otherwise use ffmpeg
+            if returncode == 0:
+                
+                thumbnail_created = self.create_thumbnail_oiio(src_path, dst_path)  
+            else:
+                thumbnail_created = self.create_thumbnail_ffmpeg(src_path, dst_path)
 
-                jpeg_items = []
-                jpeg_items.append(path_to_subprocess_arg(ffmpeg_path))
-                # override file if already exists
-                jpeg_items.append("-y")
-                # flag for large file sizes
-                max_int = 2147483647
-                jpeg_items.append("-analyzeduration {}".format(max_int))
-                jpeg_items.append("-probesize {}".format(max_int))
-                # use same input args like with mov
-                jpeg_items.extend(ffmpeg_args.get("input") or [])
-                # input file
-                jpeg_items.append("-i {}".format(
-                    path_to_subprocess_arg(full_input_path)
-                ))
-                # output arguments from presets
-                jpeg_items.extend(ffmpeg_args.get("output") or [])
-                # we just want one frame from movie files
-                jpeg_items.append("-vframes 1")
-                # output file
-                jpeg_items.append(path_to_subprocess_arg(full_output_path))
-                subprocess_command = " ".join(jpeg_items)
+        # Skip the rest of the process if the thumbnail wasn't created
+        if not thumbnail_created:
 
-                # run subprocess
-                self.log.debug("{}".format(subprocess_command))
-                try:  # temporary until oiiotool is supported cross platform
-                    run_subprocess(
-                        subprocess_command, shell=True, logger=self.log
-                    )
-                except RuntimeError as exp:
-                    if "Compression" in str(exp):
-                        self.log.debug(
-                            "Unsupported compression on input files. Skipping!"
-                        )
-                        return
-                    self.log.warning("Conversion crashed", exc_info=True)
-                    raise
+            return
 
-                new_repre = {
-                    "name": "thumbnail",
-                    "ext": "jpg",
-                    "files": jpeg_file,
-                    "stagingDir": stagingdir,
-                    "thumbnail": True,
-                    "tags": ["thumbnail"]
-                }
-                # adding representation
-                self.log.debug("Adding: {}".format(new_repre))
-                instance.data["representations"].append(new_repre)
-            
+        new_repre = {
+                "name": "thumbnail",
+                "ext": "jpg",
+                "files": jpeg_file,
+                "stagingDir": stagingdir,
+                "thumbnail": True,
+                "tags": ["thumbnail"]
+            }
+
+        # adding representation
+        self.log.debug("Adding: {}".format(new_repre))
+        instance.data["representations"].append(new_repre)
 
     def _get_filtered_repres(self, instance):
         filtered_repres = []
@@ -188,11 +167,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         return filtered_repres
 
     def create_thumbnail_oiio(self, instance, src_path, dst_path):
-        oiio_path = get_oiio_tools_path()
-        if not os.path.exists(oiio_path):
-            KnownPublishError(
-                "OpenImageIO tool is not available on this machine."
-            )
+        oiio_tool_path = get_oiio_tools_path()
         args = [oiio_tool_path]
         oiio_cmd = [oiio_tool_path,
                     src_path, "-o",
@@ -202,12 +177,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         self.log.info(f"running: {subprocess_exr}")
         run_subprocess(subprocess_exr, logger=self.log)
 
-        # raise error if there is no ouptput
-        if not os.path.exists(src_path):
-            self.log.error(
-                ("File {} was not converted "
-                    "by oiio tool!").format(src_path))
-            raise AssertionError("OIIO tool conversion failed")
+        # raise an error if there's no output
         failed_output = "oiiotool produced no output."
         output = run_subprocess(args)
         if failed_output in output:
@@ -230,7 +200,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         # will be thumbnail created
 
     def create_thumbnail_ffmpeg(self, src_path, dst_path):
-        self.log.info("output {}".format(full_output_path))
+        self.log.info("output {}".format(dst_path))
 
         ffmpeg_path = get_ffmpeg_tool_path("ffmpeg")
         ffmpeg_args = self.ffmpeg_args or {}

From ebfef2a1b869c07eee950952bc38b97717281854 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 1 Jun 2022 08:11:26 +0300
Subject: [PATCH 0429/1227] Cleanup

---
 openpype/plugins/publish/extract_jpeg_exr.py | 32 ++++++--------------
 1 file changed, 9 insertions(+), 23 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 4ffacf2600..15f90262dc 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -115,19 +115,20 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         # Try to use FFMPEG if OIIO is not supported (for cases when oiiotool 
         # isn't available)
         if not is_oiio_supported():
-            thumbnail_created = self.create_thumbnail_ffmpeg(src_path, dst_path)
+            thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path)
         else:
             # Check if the file can be read by OIIO
             args = [
-                oiiotool_path, "--info", "-i", src_path
+                oiio_tool_path, "--info", "-i", full_output_path
             ]
             returncode = execute(args, silent=True)
-            # If the input can read by OIIO then use OIIO method for conversion otherwise use ffmpeg
+            # If the input can read by OIIO then use OIIO method for
+            # conversion otherwise use ffmpeg
             if returncode == 0:
                 
-                thumbnail_created = self.create_thumbnail_oiio(src_path, dst_path)  
+                thumbnail_created = self.create_thumbnail_oiio(full_input_path, full_output_path) # noqa
             else:
-                thumbnail_created = self.create_thumbnail_ffmpeg(src_path, dst_path)
+                thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path) # noqa
 
         # Skip the rest of the process if the thumbnail wasn't created
         if not thumbnail_created:
@@ -166,7 +167,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             filtered_repres.append(repre)
         return filtered_repres
 
-    def create_thumbnail_oiio(self, instance, src_path, dst_path):
+    def create_thumbnail_oiio(self, src_path, dst_path):
         oiio_tool_path = get_oiio_tools_path()
         args = [oiio_tool_path]
         oiio_cmd = [oiio_tool_path,
@@ -183,21 +184,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         if failed_output in output:
             raise ValueError(
                 "oiiotool processing failed. Args: {}".format(args)) # noqa
-        new_repre = {
-            "name": "thumbnail",
-            "ext": "jpg",
-            "files": jpeg_file,
-            "stagingDir": stagingdir,
-            "thumbnail": True,
-            "tags": ["thumbnail"]
-        }
-        # adding representation
-        self.log.debug("Adding: {}".format(new_repre))
-        instance.data["representations"].append(new_repre)
-
-        # Create only one representation with name 'thumbnail'
-        # TODO maybe handle way how to decide from which repre
-        # will be thumbnail created
 
     def create_thumbnail_ffmpeg(self, src_path, dst_path):
         self.log.info("output {}".format(dst_path))
@@ -217,14 +203,14 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         jpeg_items.extend(ffmpeg_args.get("input") or [])
         # input file
         jpeg_items.append("-i {}".format(
-            path_to_subprocess_arg(full_input_path)
+            path_to_subprocess_arg(src_path)
         ))
         # output arguments from presets
         jpeg_items.extend(ffmpeg_args.get("output") or [])
         # we just want one frame from movie files
         jpeg_items.append("-vframes 1")
         # output file
-        jpeg_items.append(path_to_subprocess_arg(full_output_path))
+        jpeg_items.append(path_to_subprocess_arg(src_path))
         subprocess_command = " ".join(jpeg_items)
 
         # run subprocess

From b720d46489cc88a2b08cb11964fad2b4d91af8e5 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 1 Jun 2022 08:31:20 +0300
Subject: [PATCH 0430/1227] continue refactoring

---
 openpype/plugins/publish/extract_jpeg_exr.py | 116 +++++--------------
 1 file changed, 29 insertions(+), 87 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 15f90262dc..8dc06bfe79 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -67,32 +67,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
 
         filtered_repres = self._get_filtered_repres(instance)
         for repre in filtered_repres:
-            # Presumably the following is not needed since we are being
-            # explicit
-            # TODO: Test cases, cleanup.
-            # do_convert = should_convert_for_ffmpeg(full_input_path)
-            # # If result is None the requirement of conversion can't be
-            # #   determined
-            # if do_convert is None:
-            #     self.log.info((
-            #         "Can't determine if representation requires conversion." # noqa
-            #         " Skipped."
-            #     ))
-            #     continue
-            #
-            # # Do conversion if needed
-            # #   - change staging dir of source representation
-            # #   - must be set back after output definitions processing
-            # convert_dir = None
-            # if do_convert:
-            #     convert_dir = get_transcode_temp_directory()
-            #     filename = os.path.basename(full_input_path)
-            #     convert_input_paths_for_ffmpeg(
-            #         [full_input_path],
-            #         convert_dir,
-            #         self.log
-            #     )
-            #     full_input_path = os.path.join(convert_dir, filename)
             repre_files = repre["files"]
             if not isinstance(repre_files, (list, tuple)):
                 input_file = repre_files
@@ -111,38 +85,38 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             full_output_path = os.path.join(stagingdir, jpeg_file)
             # If it's a movie file, use ffmpeg
 
-        thumbnail_created = False
-        # Try to use FFMPEG if OIIO is not supported (for cases when oiiotool 
-        # isn't available)
-        if not is_oiio_supported():
-            thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path)
-        else:
-            # Check if the file can be read by OIIO
-            args = [
-                oiio_tool_path, "--info", "-i", full_output_path
-            ]
-            returncode = execute(args, silent=True)
-            # If the input can read by OIIO then use OIIO method for
-            # conversion otherwise use ffmpeg
-            if returncode == 0:
-                
-                thumbnail_created = self.create_thumbnail_oiio(full_input_path, full_output_path) # noqa
+            thumbnail_created = False
+            # Try to use FFMPEG if OIIO is not supported (for cases when
+            # oiiotool isn't available)
+            if not is_oiio_supported():
+                thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path)
             else:
-                thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path) # noqa
+                # Check if the file can be read by OIIO
+                args = [
+                    oiio_tool_path, "--info", "-i", full_output_path
+                ]
+                returncode = execute(args, silent=True)
+                # If the input can read by OIIO then use OIIO method for
+                # conversion otherwise use ffmpeg
+                if returncode == 0:
+                    
+                    thumbnail_created = self.create_thumbnail_oiio(full_input_path, full_output_path) # noqa
+                else:
+                    thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path) # noqa
 
-        # Skip the rest of the process if the thumbnail wasn't created
-        if not thumbnail_created:
+            # Skip the rest of the process if the thumbnail wasn't created
+            if not thumbnail_created:
 
-            return
+                return
 
-        new_repre = {
-                "name": "thumbnail",
-                "ext": "jpg",
-                "files": jpeg_file,
-                "stagingDir": stagingdir,
-                "thumbnail": True,
-                "tags": ["thumbnail"]
-            }
+            new_repre = {
+                    "name": "thumbnail",
+                    "ext": "jpg",
+                    "files": jpeg_file,
+                    "stagingDir": stagingdir,
+                    "thumbnail": True,
+                    "tags": ["thumbnail"]
+                }
 
         # adding representation
         self.log.debug("Adding: {}".format(new_repre))
@@ -169,7 +143,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
 
     def create_thumbnail_oiio(self, src_path, dst_path):
         oiio_tool_path = get_oiio_tools_path()
-        args = [oiio_tool_path]
         oiio_cmd = [oiio_tool_path,
                     src_path, "-o",
                     dst_path
@@ -178,13 +151,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         self.log.info(f"running: {subprocess_exr}")
         run_subprocess(subprocess_exr, logger=self.log)
 
-        # raise an error if there's no output
-        failed_output = "oiiotool produced no output."
-        output = run_subprocess(args)
-        if failed_output in output:
-            raise ValueError(
-                "oiiotool processing failed. Args: {}".format(args)) # noqa
-
     def create_thumbnail_ffmpeg(self, src_path, dst_path):
         self.log.info("output {}".format(dst_path))
 
@@ -213,30 +179,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         jpeg_items.append(path_to_subprocess_arg(src_path))
         subprocess_command = " ".join(jpeg_items)
 
-        # run subprocess
-        self.log.debug("{}".format(subprocess_command))
-        try:  # temporary until oiiotool is supported cross platform
-            run_subprocess(
+        run_subprocess(
                 subprocess_command, shell=True, logger=self.log
             )
-        except RuntimeError as exp:
-            if "Compression" in str(exp):
-                self.log.debug(
-                    "Unsupported compression on input files. Skipping!"
-                )
-                return
-            self.log.warning("Conversion crashed", exc_info=True)
-            raise
-
-        new_repre = {
-            "name": "thumbnail",
-            "ext": "jpg",
-            "files": jpeg_file,
-            "stagingDir": stagingdir,
-            "thumbnail": True,
-            "tags": ["thumbnail"]
-        }
-
-        # adding representation
-        self.log.debug("Adding: {}".format(new_repre))
-        instance.data["representations"].append(new_repre)
\ No newline at end of file

From 84c073dd3c45515a055d36a8eee29bfe3cd749cd Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 1 Jun 2022 10:19:45 +0300
Subject: [PATCH 0431/1227] Further clean up and refactor.

---
 openpype/plugins/publish/extract_jpeg_exr.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 8dc06bfe79..a5a62c04ee 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -3,7 +3,6 @@ import os
 import pyblish.api
 from openpype.pipeline import (
     legacy_io,
-    KnownPublishError
 )
 from openpype.lib import (
     get_ffmpeg_tool_path,
@@ -83,15 +82,15 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                 filename += "."
             jpeg_file = filename + "jpg"
             full_output_path = os.path.join(stagingdir, jpeg_file)
-            # If it's a movie file, use ffmpeg
 
             thumbnail_created = False
             # Try to use FFMPEG if OIIO is not supported (for cases when
             # oiiotool isn't available)
             if not is_oiio_supported():
-                thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path)
+                thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path) # noqa
             else:
                 # Check if the file can be read by OIIO
+                oiio_tool_path = get_oiio_tools_path()
                 args = [
                     oiio_tool_path, "--info", "-i", full_output_path
                 ]
@@ -99,9 +98,10 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                 # If the input can read by OIIO then use OIIO method for
                 # conversion otherwise use ffmpeg
                 if returncode == 0:
-                    
+                    self.log.info("Input can be read by OIIO, converting with oiiotool now.")
                     thumbnail_created = self.create_thumbnail_oiio(full_input_path, full_output_path) # noqa
                 else:
+                    self.log.info("converting with")
                     thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path) # noqa
 
             # Skip the rest of the process if the thumbnail wasn't created
@@ -142,6 +142,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         return filtered_repres
 
     def create_thumbnail_oiio(self, src_path, dst_path):
+        self.log.info("outputting {}".format(dst_path))
         oiio_tool_path = get_oiio_tools_path()
         oiio_cmd = [oiio_tool_path,
                     src_path, "-o",
@@ -152,7 +153,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         run_subprocess(subprocess_exr, logger=self.log)
 
     def create_thumbnail_ffmpeg(self, src_path, dst_path):
-        self.log.info("output {}".format(dst_path))
+        self.log.info("outputting {}".format(dst_path))
 
         ffmpeg_path = get_ffmpeg_tool_path("ffmpeg")
         ffmpeg_args = self.ffmpeg_args or {}

From 3b26f78335057810cd8cd9d23f1de3546524211a Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 1 Jun 2022 10:23:52 +0300
Subject: [PATCH 0432/1227] Revert "Add profiles handling in schema aand for
 extractor"

This reverts commit 8453f9710f1fb305d917723eeee4cfea5c007062.
---
 openpype/plugins/publish/extract_jpeg_exr.py  | 17 ---------
 .../defaults/project_settings/deadline.json   |  2 +-
 .../defaults/project_settings/global.json     | 12 +-----
 .../schemas/schema_global_publish.json        | 38 -------------------
 repos/avalon-core                             |  1 +
 5 files changed, 3 insertions(+), 67 deletions(-)
 create mode 160000 repos/avalon-core

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index a5a62c04ee..4a1fea2043 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -1,15 +1,11 @@
 import os
 
 import pyblish.api
-from openpype.pipeline import (
-    legacy_io,
-)
 from openpype.lib import (
     get_ffmpeg_tool_path,
     get_oiio_tools_path,
     is_oiio_supported,
 
-    filter_profiles,
     run_subprocess,
     path_to_subprocess_arg,
 
@@ -34,19 +30,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
     oiio_args = None
 
     def process(self, instance):
-        task_name = instance.data.get("task", legacy_io.Session["AVALON_TASK"])
-        host_name = legacy_io.Session["AVALON_APP"]
-        family = instance.data["family"]
-        filtering_criteria = {
-            "hosts": host_name,
-            "families": family,
-            "tasks": task_name
-        }
-        profile = filter_profiles(self.profiles, filtering_criteria,
-                                  logger=self.log)
-        if not profile:
-            return
-
         self.log.info("subset {}".format(instance.data['subset']))
 
         # skip crypto passes.
diff --git a/openpype/settings/defaults/project_settings/deadline.json b/openpype/settings/defaults/project_settings/deadline.json
index 5c5a14bf21..f0b2a7e555 100644
--- a/openpype/settings/defaults/project_settings/deadline.json
+++ b/openpype/settings/defaults/project_settings/deadline.json
@@ -98,4 +98,4 @@
             }
         }
     }
-}
\ No newline at end of file
+}
diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index 4ad56d8086..cedd0eed99 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -40,17 +40,7 @@
                     "-apply_trc gamma22"
                 ],
                 "output": []
-            },
-            "thumbnail_extraction_profiles": [
-                {
-                    "families": [
-                        ""
-                    ],
-                    "hosts": [],
-                    "task_types": [],
-                    "tasks": []
-                }
-            ]
+            }
         },
         "ExtractReview": {
             "enabled": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
index 4149c99348..a3cbf0cfcd 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
@@ -152,44 +152,6 @@
                             "label": "FFmpeg output arguments"
                         }
                     ]
-                },
-                {
-                    "type": "list",
-                    "key": "thumbnail_extraction_profiles",
-                    "label": "Thumbnail Extraction profiles",
-                    "use_label_wrap": true,
-                    "object_type": {
-                        "type": "dict",
-                        "children": [
-                            {
-                                "type": "label",
-                                "label": ""
-                            },
-                            {
-                                "key": "families",
-                                "label": "Families",
-                                "type": "list",
-                                "object_type": "text"
-                            },
-                            {
-                                "type": "hosts-enum",
-                                "key": "hosts",
-                                "label": "Hosts",
-                                "multiselection": true
-                            },
-                            {
-                                "key": "task_types",
-                                "label": "Task types",
-                                "type": "task-types-enum"
-                            },
-                            {
-                                "key": "tasks",
-                                "label": "Task names",
-                                "type": "list",
-                                "object_type": "text"
-                            }
-                        ]
-                    }
                 }
             ]
         },
diff --git a/repos/avalon-core b/repos/avalon-core
new file mode 160000
index 0000000000..2fa14cea6f
--- /dev/null
+++ b/repos/avalon-core
@@ -0,0 +1 @@
+Subproject commit 2fa14cea6f6a9d86eec70bbb96860cbe4c75c8eb

From c4468664970bd93bbd074d7424042d4adee20c8e Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 1 Jun 2022 10:25:56 +0300
Subject: [PATCH 0433/1227] remove unused variable

---
 openpype/plugins/publish/extract_jpeg_exr.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 4a1fea2043..daf7430a32 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -27,7 +27,6 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
 
     # presetable attribute
     ffmpeg_args = None
-    oiio_args = None
 
     def process(self, instance):
         self.log.info("subset {}".format(instance.data['subset']))

From a10bbbcc79b5a369d51bb4716164611edcb4dbfa Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 1 Jun 2022 12:33:09 +0200
Subject: [PATCH 0434/1227] OP-3068 - better handling of legacy review subsets
 in Maya

Multiple reviews from a Maya workfile are blocked by legacy subset names without variant. These names could be used in later process so we cannot replace them.
Unique subset name validator was added, check for existing subset in DB too.
---
 .../maya/plugins/publish/collect_review.py    | 17 +++++----
 .../validate_review_subset_uniqueness.xml     | 28 +++++++++++++++
 .../validate_review_subset_uniqueness.py      | 36 +++++++++++++++++++
 3 files changed, 72 insertions(+), 9 deletions(-)
 create mode 100644 openpype/hosts/maya/plugins/publish/help/validate_review_subset_uniqueness.xml
 create mode 100644 openpype/hosts/maya/plugins/publish/validate_review_subset_uniqueness.py

diff --git a/openpype/hosts/maya/plugins/publish/collect_review.py b/openpype/hosts/maya/plugins/publish/collect_review.py
index 1af92c3bfc..e9e0d74c03 100644
--- a/openpype/hosts/maya/plugins/publish/collect_review.py
+++ b/openpype/hosts/maya/plugins/publish/collect_review.py
@@ -77,15 +77,14 @@ class CollectReview(pyblish.api.InstancePlugin):
                 instance.data['remove'] = True
                 self.log.debug('isntance data {}'.format(instance.data))
         else:
-            if self.legacy:
-                instance.data['subset'] = task + 'Review'
-            else:
-                subset = "{}{}{}".format(
-                    task,
-                    instance.data["subset"][0].upper(),
-                    instance.data["subset"][1:]
-                )
-                instance.data['subset'] = subset
+            legacy_subset_name = task + 'Review'
+            asset_doc_id = instance.context.data['assetEntity']["_id"]
+            subsets = legacy_io.find({"type": "subset",
+                                      "name": legacy_subset_name,
+                                      "parent": asset_doc_id}).distinct("_id")
+            if len(list(subsets)) > 0:
+                self.log.debug("Existing subsets found, keep legacy name.")
+                instance.data['subset'] = legacy_subset_name
 
             instance.data['review_camera'] = camera
             instance.data['frameStartFtrack'] = \
diff --git a/openpype/hosts/maya/plugins/publish/help/validate_review_subset_uniqueness.xml b/openpype/hosts/maya/plugins/publish/help/validate_review_subset_uniqueness.xml
new file mode 100644
index 0000000000..fd1bf4cbaa
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/help/validate_review_subset_uniqueness.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<root>
+    <error id="main">
+        <title>Review subsets not unique</title>
+        <description>
+            ## Non unique subset name found
+
+            Non unique subset names: '{non_unique}'
+            <detail>
+                ### __Detailed Info__ (optional)
+
+                This might happen if you already published for this asset
+                review subset with legacy name {task}Review.
+                This legacy name limits possibility of publishing of multiple
+                reviews from a single workfile. Proper review subset name should
+                now
+                contain variant also (as 'Main', 'Default' etc.). That would
+                result in completely new subset though, so this situation must
+                be handled manually.
+            </detail>
+            ### How to repair?
+
+            Legacy subsets must be removed from Openpype DB, please ask admin
+            to do that. Please provide them asset and subset names.
+
+        </description>
+    </error>
+</root>
\ No newline at end of file
diff --git a/openpype/hosts/maya/plugins/publish/validate_review_subset_uniqueness.py b/openpype/hosts/maya/plugins/publish/validate_review_subset_uniqueness.py
new file mode 100644
index 0000000000..d70096ee45
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/validate_review_subset_uniqueness.py
@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+import collections
+import pyblish.api
+import openpype.api
+from openpype.pipeline import PublishXmlValidationError
+
+
+class ValidateReviewSubsetUniqueness(pyblish.api.ContextPlugin):
+    """Validates that nodes has common root."""
+
+    order = openpype.api.ValidateContentsOrder
+    hosts = ["maya"]
+    families = ["review"]
+    label = "Validate Review Subset Unique"
+
+    def process(self, context):
+        subset_names = []
+
+        for instance in context:
+            self.log.info("instance:: {}".format(instance.data))
+            if instance.data.get('publish'):
+                subset_names.append(instance.data.get('subset'))
+
+        non_unique = \
+            [item
+             for item, count in collections.Counter(subset_names).items()
+             if count > 1]
+        msg = ("Instance subset names {} are not unique. ".format(non_unique) +
+               "Ask admin to remove subset from DB for multiple reviews.")
+        formatting_data = {
+            "non_unique": ",".join(non_unique)
+        }
+
+        if non_unique:
+            raise PublishXmlValidationError(self, msg,
+                                            formatting_data=formatting_data)

From 6a5fa89348bb822e1f2c8748fa867f19e2f70a8d Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 1 Jun 2022 14:27:55 +0200
Subject: [PATCH 0435/1227] Fix - change default of use_env_var_as_root

True was there only for testing, false is more sane default.
---
 openpype/settings/defaults/project_settings/maya.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index a42f889e85..efd22e13c8 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -8,7 +8,7 @@
         "yetiRig": "ma"
     },
     "maya-dirmap": {
-        "use_env_var_as_root": true,
+        "use_env_var_as_root": false,
         "enabled": false,
         "paths": {
             "source-path": [],

From 8b43c5e733117d528a164f45a6112b6d76a53e42 Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Wed, 4 May 2022 12:16:19 +0200
Subject: [PATCH 0436/1227] add a tab in nuke project settings for gizmos

---
 openpype/hosts/nuke/startup/menu.py           |  1 -
 .../defaults/project_settings/nuke.json       | 22 ++++++++++
 .../projects_schema/schema_project_nuke.json  |  4 ++
 .../schemas/schema_nuke_scriptsgizmo.json     | 42 +++++++++++++++++++
 4 files changed, 68 insertions(+), 1 deletion(-)
 create mode 100644 openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json

diff --git a/openpype/hosts/nuke/startup/menu.py b/openpype/hosts/nuke/startup/menu.py
index 49edb22a89..eea2d940f8 100644
--- a/openpype/hosts/nuke/startup/menu.py
+++ b/openpype/hosts/nuke/startup/menu.py
@@ -31,7 +31,6 @@ nuke.addFilenameFilter(dirmap_file_name_filter)
 
 log.info('Automatic syncing of write file knob to script version')
 
-
 def add_scripts_menu():
     try:
         from scriptsmenu import launchfornuke
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index dc8ffcebff..a10b88464c 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -290,5 +290,27 @@
             }
         ]
     },
+    "gizmo": [
+        {
+            "toolbar_menu_name": "FixStudio",
+            "toolbar_icon_path": "{QUAD_PLUGIN_PATH}/nuke/icons/fixstudio.png",
+            "gizmo_path": ["{QUAD_PLUGIN_PATH}/nuke/gizmos"],
+            "gizmo_definition": [
+                {
+                    "type": "menu",
+                    "title": "3D",
+                    "items": [
+                        {
+                            "type": "action",
+                            "command": "nuke.createNode('Camera_Smoother')",
+                            "sourcetype": "python",
+                            "title": "Camera_Smoother"
+                        }
+
+                    ]
+                }
+            ]
+        }
+    ],
     "filters": {}
 }
\ No newline at end of file
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json b/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
index 1ae4efd8ea..03d67a57ba 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_nuke.json
@@ -83,6 +83,10 @@
             "type": "schema",
             "name": "schema_scriptsmenu"
         },
+        {
+            "type": "schema",
+            "name": "schema_nuke_scriptsgizmo"
+        },
         {
             "type": "dict",
             "collapsible": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json
new file mode 100644
index 0000000000..c1e67842ce
--- /dev/null
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json
@@ -0,0 +1,42 @@
+{
+    "type": "list",
+    "key": "gizmo",
+    "label": "Gizmo Menu",
+    "is_group": true,
+    "use_label_wrap": true,
+    "object_type": {
+        "type": "dict",
+        "children": [
+            {
+                "type": "text",
+                "key": "toolbar_menu_name",
+                "label": "Toolbar Menu Name"
+            },
+            {
+                "type": "path",
+                "key": "toolbar_icon_path",
+                "label": "Toolbar Icon Path",
+                "multipath": false
+            },
+            {
+                "type": "splitter"
+            },
+            {
+                "type": "label",
+                "label": "Absolute path to gizmo folders."
+            },
+            {
+                "type": "path",
+                "key": "gizmo_path",
+                "label": "Gizmo Path",
+                "multipath": true
+            },
+            {
+                "type": "raw-json",
+                "key": "gizmo_definition",
+                "label": "Gizmo definition",
+                "is_list": true
+            }
+        ]
+    }
+}
\ No newline at end of file

From 25518a1c42ff9958f9bb9763b0792dd28e8cc691 Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Wed, 4 May 2022 17:01:32 +0200
Subject: [PATCH 0437/1227] generate toolbar menu from openpype project
 settings

---
 openpype/hosts/nuke/api/lib.py                | 48 +++++++++++++++
 openpype/hosts/nuke/startup/menu.py           | 59 ++++++++++++++++++-
 .../defaults/project_settings/nuke.json       |  9 ++-
 3 files changed, 110 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index f40425eefc..a1ac50ae1a 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -30,6 +30,8 @@ from openpype.pipeline import (
     legacy_io,
 )
 
+from . import gizmo_menu
+
 from .workio import (
     save_file,
     open_file
@@ -2498,6 +2500,52 @@ def recreate_instance(origin_node, avalon_data=None):
     return new_node
 
 
+def find_scripts_gizmo(title, parent):
+    """
+    Check if the menu exists with the given title in the parent
+
+    Args:
+        title (str): the title name of the scripts menu
+
+        parent (QtWidgets.QMenuBar): the menubar to check
+
+    Returns:
+        QtWidgets.QMenu or None
+
+    """
+
+    menu = None
+    search = [i for i in parent.items() if
+              isinstance(i, gizmo_menu.GizmoMenu)
+              and i.title() == title]
+
+    if search:
+        assert len(search) < 2, ("Multiple instances of menu '{}' "
+                                 "in toolbar".format(title))
+        menu = search[0]
+
+    return menu
+
+
+def gizmo_creation(title="Gizmos", parent=None, objectName=None, icon=None):
+    try:
+        toolbar = find_scripts_gizmo(title, parent)
+        if not toolbar:
+            log.info("Attempting to build toolbar...")
+            object_name = objectName or title.lower()
+            toolbar = gizmo_menu.GizmoMenu(
+                title=title,
+                parent=parent,
+                objectName=object_name,
+                icon=icon
+            )
+    except Exception as e:
+        log.error(e)
+        return
+
+    return toolbar
+
+
 class NukeDirmap(HostDirmap):
     def __init__(self, host_name, project_settings, sync_module, file_name):
         """
diff --git a/openpype/hosts/nuke/startup/menu.py b/openpype/hosts/nuke/startup/menu.py
index eea2d940f8..0f587fc62a 100644
--- a/openpype/hosts/nuke/startup/menu.py
+++ b/openpype/hosts/nuke/startup/menu.py
@@ -2,7 +2,7 @@ import nuke
 import os
 
 from openpype.api import Logger
-from openpype.pipeline import install_host
+from openpype.settings import get_project_settings
 from openpype.hosts.nuke import api
 from openpype.hosts.nuke.api.lib import (
     on_script_load,
@@ -31,6 +31,7 @@ nuke.addFilenameFilter(dirmap_file_name_filter)
 
 log.info('Automatic syncing of write file knob to script version')
 
+
 def add_scripts_menu():
     try:
         from scriptsmenu import launchfornuke
@@ -58,3 +59,59 @@ def add_scripts_menu():
 
 
 add_scripts_menu()
+
+
+def add_scripts_gizmo():
+    try:
+        from openpype.hosts.nuke.api import lib
+    except ImportError:
+        log.warning(
+            "Skipping studio.gizmo install, because "
+            "'scriptsgizmo' module seems unavailable."
+        )
+        return
+
+    for gizmo in project_settings["nuke"]["gizmo"]:
+        config = gizmo["gizmo_definition"]
+        toolbar_name = gizmo["toolbar_menu_name"]
+        gizmo_path = gizmo["gizmo_path"]
+        icon = gizmo['toolbar_icon_path']
+
+        if not any(gizmo_path):
+            log.warning("Skipping studio gizmo, no gizmo path found.")
+            return
+
+        if not config:
+            log.warning("Skipping studio gizmo, no definition found.")
+            return
+
+        try:
+            icon = icon.format(**os.environ)
+        except KeyError as e:
+            log.warning(f"This environment variable doesn't exist: {e}")
+
+        for gizmo in gizmo_path:
+            try:
+                gizmo = gizmo.format(**os.environ)
+                gizmo_path.append(gizmo)
+                gizmo_path.pop(0)
+            except KeyError as e:
+                log.warning(f"This environment variable doesn't exist: {e}")
+
+        nuke_toolbar = nuke.menu("Nodes")
+        toolbar = nuke_toolbar.addMenu(toolbar_name, icon=icon)
+
+        # run the launcher for Nuke toolbar
+        studio_menu = lib.gizmo_creation(
+            title=toolbar_name,
+            parent=toolbar,
+            objectName=toolbar_name.lower().replace(" ", "_"),
+            icon=icon
+        )
+
+        # apply configuration
+        studio_menu.add_gizmo_path(gizmo_path)
+        studio_menu.build_from_configuration(toolbar, config)
+
+
+add_scripts_gizmo()
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index a10b88464c..48bbbf0dcc 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -293,8 +293,8 @@
     "gizmo": [
         {
             "toolbar_menu_name": "FixStudio",
-            "toolbar_icon_path": "{QUAD_PLUGIN_PATH}/nuke/icons/fixstudio.png",
-            "gizmo_path": ["{QUAD_PLUGIN_PATH}/nuke/gizmos"],
+            "toolbar_icon_path": "openpype/modules/quad/nuke/icons/fixstudio.png",
+            "gizmo_path": ["openpype/modules/quad/nuke/gizmos/3D"],
             "gizmo_definition": [
                 {
                     "type": "menu",
@@ -302,11 +302,10 @@
                     "items": [
                         {
                             "type": "action",
-                            "command": "nuke.createNode('Camera_Smoother')",
                             "sourcetype": "python",
-                            "title": "Camera_Smoother"
+                            "title": "Camera Smoother",
+                            "command": "nuke.createNodes('Camera_Smoother)"
                         }
-
                     ]
                 }
             ]

From af259d215e08d54cca7dd01754a03f8b0863aefe Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Mon, 9 May 2022 15:12:16 +0200
Subject: [PATCH 0438/1227] refactor default gizmo

---
 openpype/settings/defaults/project_settings/nuke.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 48bbbf0dcc..d9b443c958 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -293,8 +293,8 @@
     "gizmo": [
         {
             "toolbar_menu_name": "FixStudio",
-            "toolbar_icon_path": "openpype/modules/quad/nuke/icons/fixstudio.png",
-            "gizmo_path": ["openpype/modules/quad/nuke/gizmos/3D"],
+            "toolbar_icon_path": "path/to/nuke/icon.png",
+            "gizmo_path": ["path/to/nuke/gizmo"],
             "gizmo_definition": [
                 {
                     "type": "menu",
@@ -304,7 +304,7 @@
                             "type": "action",
                             "sourcetype": "python",
                             "title": "Camera Smoother",
-                            "command": "nuke.createNodes('Camera_Smoother)"
+                            "command": "nuke.createNode('Camera_Smoother')"
                         }
                     ]
                 }

From 5bc741d993b67a3e9ebfd74b5cc711caa56e06fb Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Mon, 9 May 2022 15:13:50 +0200
Subject: [PATCH 0439/1227] add gizmo_menu module

---
 openpype/hosts/nuke/api/gizmo_menu.py | 77 +++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 openpype/hosts/nuke/api/gizmo_menu.py

diff --git a/openpype/hosts/nuke/api/gizmo_menu.py b/openpype/hosts/nuke/api/gizmo_menu.py
new file mode 100644
index 0000000000..56532ed1dc
--- /dev/null
+++ b/openpype/hosts/nuke/api/gizmo_menu.py
@@ -0,0 +1,77 @@
+import os
+import logging
+import nuke
+
+log = logging.getLogger(__name__)
+
+
+class GizmoMenu():
+    def __init__(self, *args, **kwargs):
+        self._script_actions = []
+
+    def build_from_configuration(self, parent, configuration):
+        for item in configuration:
+            assert isinstance(item, dict), "Configuration is wrong!"
+
+            # skip items which have no `type` key
+            item_type = item.get('type', None)
+            if not item_type:
+                log.warning("Missing 'type' from configuration item")
+                continue
+
+            if item_type == "action":
+                # filter out `type` from the item dict
+                config = {key: value for key, value in
+                          item.items() if key != "type"}
+
+                command = config['command']
+
+                if command.find('{pipe_path}') > -1:
+                    command = command.format(
+                        pipe_path=os.environ['QUAD_PLUGIN_PATH']
+                    )
+
+                icon = config.get('icon', None)
+                if icon:
+                    try:
+                        icon = icon.format(**os.environ)
+                    except KeyError as e:
+                        log.warning(f"This environment variable doesn't exist: {e}'")
+
+                hotkey = config.get('hotkey', None)
+
+                parent.addCommand(
+                    config['title'],
+                    command=command,
+                    icon=icon,
+                    shortcut=hotkey
+                )
+
+            # add separator
+            # Special behavior for separators
+            if item_type == "separator":
+                parent.addSeparator()
+
+            # add submenu
+            # items should hold a collection of submenu items (dict)
+            elif item_type == "menu":
+                assert "items" in item, "Menu is missing 'items' key"
+
+                icon = item.get('icon', None)
+                if icon:
+                    try:
+                        icon = icon.format(**os.environ)
+                    except KeyError as e:
+                        log.warning(f"This environment variable doesn't exist: {e}'")
+                menu = parent.addMenu(item['title'], icon=icon)
+                self.build_from_configuration(menu, item["items"])
+
+    def add_gizmo_path(self, gizmo_paths):
+        for gizmo_path in gizmo_paths:
+            if os.path.isdir(gizmo_path):
+                for folder in os.listdir(gizmo_path):
+                    if os.path.isdir(os.path.join(gizmo_path, folder)):
+                        nuke.pluginAddPath(os.path.join(gizmo_path, folder))
+                nuke.pluginAddPath(gizmo_path)
+            else:
+                log.warning(f"This path doesn't exist: {gizmo_path}")

From 94356faa9c16f359dca2e94a726e79f16253e1d3 Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Wed, 11 May 2022 11:46:57 +0200
Subject: [PATCH 0440/1227] fix install_host import

---
 openpype/hosts/nuke/startup/menu.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/startup/menu.py b/openpype/hosts/nuke/startup/menu.py
index 0f587fc62a..88c727aaa6 100644
--- a/openpype/hosts/nuke/startup/menu.py
+++ b/openpype/hosts/nuke/startup/menu.py
@@ -2,7 +2,7 @@ import nuke
 import os
 
 from openpype.api import Logger
-from openpype.settings import get_project_settings
+from openpype.pipeline import install_host
 from openpype.hosts.nuke import api
 from openpype.hosts.nuke.api.lib import (
     on_script_load,

From 0696d505c2cf9eb53c10afe2c2ffa6b73f3cbe7b Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Thu, 12 May 2022 11:12:08 +0200
Subject: [PATCH 0441/1227] set the default gizmo to a sticky note

---
 .../settings/defaults/project_settings/nuke.json | 16 +++++-----------
 1 file changed, 5 insertions(+), 11 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index d9b443c958..06679ac314 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -292,21 +292,15 @@
     },
     "gizmo": [
         {
-            "toolbar_menu_name": "FixStudio",
+            "toolbar_menu_name": "OpenPype Gizmo",
             "toolbar_icon_path": "path/to/nuke/icon.png",
             "gizmo_path": ["path/to/nuke/gizmo"],
             "gizmo_definition": [
                 {
-                    "type": "menu",
-                    "title": "3D",
-                    "items": [
-                        {
-                            "type": "action",
-                            "sourcetype": "python",
-                            "title": "Camera Smoother",
-                            "command": "nuke.createNode('Camera_Smoother')"
-                        }
-                    ]
+                    "type": "action",
+                    "sourcetype": "python",
+                    "title": "Gizmo Note",
+                    "command": "nuke.nodes.StickyNote(label='You can create your own toolbar menu in the Nuke GizmoMenu of OpenPype')"
                 }
             ]
         }

From bd7243f8aa1dd64d3bad4ef822eb24e4ee70e4d4 Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Thu, 12 May 2022 11:20:55 +0200
Subject: [PATCH 0442/1227] add the docs for the gizmo menu

---
 website/docs/admin_hosts_nuke.md             |   4 ++++
 website/docs/assets/nuke-admin_gizmomenu.png | Bin 0 -> 34803 bytes
 2 files changed, 4 insertions(+)
 create mode 100644 website/docs/assets/nuke-admin_gizmomenu.png

diff --git a/website/docs/admin_hosts_nuke.md b/website/docs/admin_hosts_nuke.md
index 46f596a2dc..bab63223ce 100644
--- a/website/docs/admin_hosts_nuke.md
+++ b/website/docs/admin_hosts_nuke.md
@@ -12,3 +12,7 @@ You can add your custom tools menu into Nuke by extending definitions in **Nuke
 This is still work in progress. Menu definition will be handled more friendly with widgets and not
 raw json.
 :::
+
+## Gizmo Menu
+You can add your custom toolbar menu into Nuke by setting your gizmo path and extending definitions in **Nuke -> Gizmo Menu**.
+![Custom menu definition](assets/nuke-admin_gizmomenu.png)
diff --git a/website/docs/assets/nuke-admin_gizmomenu.png b/website/docs/assets/nuke-admin_gizmomenu.png
new file mode 100644
index 0000000000000000000000000000000000000000..81e63b20418896173bf5f6417ce2515780e2bcdf
GIT binary patch
literal 34803
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
KXW7E9J^v4^Goq*f

literal 0
HcmV?d00001


From 08e04911b3c100ca1dba8d1107a33cf689c98e79 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Thu, 12 May 2022 15:55:11 +0200
Subject: [PATCH 0443/1227] fix string format for python2

---
 openpype/hosts/nuke/api/gizmo_menu.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/nuke/api/gizmo_menu.py b/openpype/hosts/nuke/api/gizmo_menu.py
index 56532ed1dc..c1132792d0 100644
--- a/openpype/hosts/nuke/api/gizmo_menu.py
+++ b/openpype/hosts/nuke/api/gizmo_menu.py
@@ -36,7 +36,8 @@ class GizmoMenu():
                     try:
                         icon = icon.format(**os.environ)
                     except KeyError as e:
-                        log.warning(f"This environment variable doesn't exist: {e}'")
+                        log.warning("This environment variable doesn't exist: "
+                                    "{}".format(e))
 
                 hotkey = config.get('hotkey', None)
 
@@ -62,7 +63,8 @@ class GizmoMenu():
                     try:
                         icon = icon.format(**os.environ)
                     except KeyError as e:
-                        log.warning(f"This environment variable doesn't exist: {e}'")
+                        log.warning("This environment variable doesn't exist: "
+                                    "{}".format(e))
                 menu = parent.addMenu(item['title'], icon=icon)
                 self.build_from_configuration(menu, item["items"])
 
@@ -74,4 +76,4 @@ class GizmoMenu():
                         nuke.pluginAddPath(os.path.join(gizmo_path, folder))
                 nuke.pluginAddPath(gizmo_path)
             else:
-                log.warning(f"This path doesn't exist: {gizmo_path}")
+                log.warning("This path doesn't exist: {}".format(gizmo_path))

From eb590602c329b90d8b1e40aeda4ae04287e01a06 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Wed, 1 Jun 2022 17:31:19 +0200
Subject: [PATCH 0444/1227] make it works on nuke 12

---
 openpype/hosts/nuke/api/gizmo_menu.py                 |  2 +-
 openpype/hosts/nuke/startup/menu.py                   | 11 +++++++++--
 openpype/settings/defaults/project_settings/nuke.json |  2 +-
 3 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/nuke/api/gizmo_menu.py b/openpype/hosts/nuke/api/gizmo_menu.py
index c1132792d0..a541fd3ab1 100644
--- a/openpype/hosts/nuke/api/gizmo_menu.py
+++ b/openpype/hosts/nuke/api/gizmo_menu.py
@@ -24,7 +24,7 @@ class GizmoMenu():
                 config = {key: value for key, value in
                           item.items() if key != "type"}
 
-                command = config['command']
+                command = str(config['command'])
 
                 if command.find('{pipe_path}') > -1:
                     command = command.format(
diff --git a/openpype/hosts/nuke/startup/menu.py b/openpype/hosts/nuke/startup/menu.py
index 88c727aaa6..6c076fc87b 100644
--- a/openpype/hosts/nuke/startup/menu.py
+++ b/openpype/hosts/nuke/startup/menu.py
@@ -71,6 +71,9 @@ def add_scripts_gizmo():
         )
         return
 
+    # load configuration of custom menu
+    project_settings = get_project_settings(os.getenv("AVALON_PROJECT"))
+
     for gizmo in project_settings["nuke"]["gizmo"]:
         config = gizmo["gizmo_definition"]
         toolbar_name = gizmo["toolbar_menu_name"]
@@ -88,7 +91,9 @@ def add_scripts_gizmo():
         try:
             icon = icon.format(**os.environ)
         except KeyError as e:
-            log.warning(f"This environment variable doesn't exist: {e}")
+            log.warning(
+                "This environment variable doesn't exist: {}".format(e)
+            )
 
         for gizmo in gizmo_path:
             try:
@@ -96,7 +101,9 @@ def add_scripts_gizmo():
                 gizmo_path.append(gizmo)
                 gizmo_path.pop(0)
             except KeyError as e:
-                log.warning(f"This environment variable doesn't exist: {e}")
+                log.warning(
+                    "This environment variable doesn't exist: {}".format(e)
+                )
 
         nuke_toolbar = nuke.menu("Nodes")
         toolbar = nuke_toolbar.addMenu(toolbar_name, icon=icon)
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 06679ac314..6c6454de36 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -306,4 +306,4 @@
         }
     ],
     "filters": {}
-}
\ No newline at end of file
+}

From 8f9c08549292a58b7beccf3ae8a9477b2aac1020 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Wed, 1 Jun 2022 20:40:28 +0200
Subject: [PATCH 0445/1227] beter loop check

---
 openpype/hosts/nuke/startup/menu.py | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/nuke/startup/menu.py b/openpype/hosts/nuke/startup/menu.py
index 6c076fc87b..715bab8ea5 100644
--- a/openpype/hosts/nuke/startup/menu.py
+++ b/openpype/hosts/nuke/startup/menu.py
@@ -95,15 +95,21 @@ def add_scripts_gizmo():
                 "This environment variable doesn't exist: {}".format(e)
             )
 
+        existing_gizmo_path = []
         for gizmo in gizmo_path:
             try:
                 gizmo = gizmo.format(**os.environ)
-                gizmo_path.append(gizmo)
-                gizmo_path.pop(0)
             except KeyError as e:
                 log.warning(
                     "This environment variable doesn't exist: {}".format(e)
                 )
+                continue
+            if not os.path.exists(gizmo):
+                log.warning(
+                    "The source of gizmo `{}` does not exists".format(gizmo)
+                )
+                continue
+            existing_gizmo_path.append(gizmo)
 
         nuke_toolbar = nuke.menu("Nodes")
         toolbar = nuke_toolbar.addMenu(toolbar_name, icon=icon)
@@ -117,7 +123,7 @@ def add_scripts_gizmo():
         )
 
         # apply configuration
-        studio_menu.add_gizmo_path(gizmo_path)
+        studio_menu.add_gizmo_path(existing_gizmo_path)
         studio_menu.build_from_configuration(toolbar, config)
 
 

From 0fcfdf7fa8250d400a7da772be12972b59c667fd Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Wed, 1 Jun 2022 20:44:10 +0200
Subject: [PATCH 0446/1227] remove studio operation

---
 openpype/hosts/nuke/api/gizmo_menu.py | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/openpype/hosts/nuke/api/gizmo_menu.py b/openpype/hosts/nuke/api/gizmo_menu.py
index a541fd3ab1..dd04f4a42e 100644
--- a/openpype/hosts/nuke/api/gizmo_menu.py
+++ b/openpype/hosts/nuke/api/gizmo_menu.py
@@ -26,11 +26,6 @@ class GizmoMenu():
 
                 command = str(config['command'])
 
-                if command.find('{pipe_path}') > -1:
-                    command = command.format(
-                        pipe_path=os.environ['QUAD_PLUGIN_PATH']
-                    )
-
                 icon = config.get('icon', None)
                 if icon:
                     try:

From 7d3b76cc0a1d9856bfd2a0479600d867412b133c Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Thu, 2 Jun 2022 09:50:53 +0900
Subject: [PATCH 0447/1227] Removed lib for hound.

---
 openpype/hosts/maya/plugins/create/create_multiverse_look.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_look.py b/openpype/hosts/maya/plugins/create/create_multiverse_look.py
index 3fc834a700..f47c88a93b 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_look.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_look.py
@@ -1,4 +1,4 @@
-from openpype.hosts.maya.api import plugin, lib
+from openpype.hosts.maya.api import plugin
 
 
 class CreateMultiverseLook(plugin.Creator):

From 85748589ef4cdbda6ad65c59c3130ad2901dc0b4 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 2 Jun 2022 11:18:02 +0200
Subject: [PATCH 0448/1227] :bug: skip empty attributes

---
 openpype/hosts/maya/plugins/publish/collect_look.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index 323bede761..9b6d1d999c 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -601,6 +601,9 @@ class CollectLook(pyblish.api.InstancePlugin):
                                                      source,
                                                      computed_source))
 
+            if not source:
+                self.log.info("source is empty, skipping...")
+                continue
             # We replace backslashes with forward slashes because V-Ray
             # can't handle the UDIM files with the backslashes in the
             # paths as the computed patterns

From 73b492c1fff78f4ece0e63dfc9bb0c83189ebe47 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 2 Jun 2022 15:53:40 +0200
Subject: [PATCH 0449/1227] Flame: adding `OPENPYPE_TEMP_DIR` to extractor

---
 .../publish/extract_subset_resources.py       | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 0bad3f7cfc..f3239af23e 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -1,5 +1,6 @@
 import os
 import re
+import tempfile
 from pprint import pformat
 from copy import deepcopy
 
@@ -420,3 +421,28 @@ class ExtractSubsetResources(openpype.api.Extractor):
                 "Path `{}` is containing more that one clip".format(path)
             )
         return clips[0]
+
+    def staging_dir(self, instance):
+        """Provide a temporary directory in which to store extracted files
+
+        Upon calling this method the staging directory is stored inside
+        the instance.data['stagingDir']
+        """
+        staging_dir = instance.data.get('stagingDir', None)
+        openpype_temp_dir = os.getenv("OPENPYPE_TEMP_DIR")
+
+        if not staging_dir:
+            if openpype_temp_dir and os.path.exists(openpype_temp_dir):
+                staging_dir = os.path.normpath(
+                    tempfile.mkdtemp(
+                        prefix="pyblish_tmp_",
+                        dir=openpype_temp_dir
+                    )
+                )
+            else:
+                staging_dir = os.path.normpath(
+                    tempfile.mkdtemp(prefix="pyblish_tmp_")
+                )
+            instance.data['stagingDir'] = staging_dir
+
+        return staging_dir

From 2339e41b4c32afcbd4eb5d1a6d8ea2cadd58f057 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 3 Jun 2022 10:19:22 +0200
Subject: [PATCH 0450/1227] Fix - removed unnecessary initialization

---
 openpype/modules/sync_server/sync_server_module.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/openpype/modules/sync_server/sync_server_module.py b/openpype/modules/sync_server/sync_server_module.py
index 5a1d8467ec..bd75172cc6 100644
--- a/openpype/modules/sync_server/sync_server_module.py
+++ b/openpype/modules/sync_server/sync_server_module.py
@@ -1026,9 +1026,6 @@ class SyncServerModule(OpenPypeModule, ITrayModule):
         """
         self.server_init()
 
-        from .tray.app import SyncServerWindow
-        self.widget = SyncServerWindow(self)
-
     def server_init(self):
         """Actual initialization of Sync Server."""
         # import only in tray or Python3, because of Python2 hosts

From 688400ad7b7065f6db5322dd480bfe352cc2f62d Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 3 Jun 2022 10:20:33 +0200
Subject: [PATCH 0451/1227] Fix - removed unnecessary first query

setSortable forces refresh itself
---
 openpype/modules/sync_server/tray/models.py | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/openpype/modules/sync_server/tray/models.py b/openpype/modules/sync_server/tray/models.py
index 7241cc3472..d3d36cdfd4 100644
--- a/openpype/modules/sync_server/tray/models.py
+++ b/openpype/modules/sync_server/tray/models.py
@@ -523,10 +523,6 @@ class SyncRepresentationSummaryModel(_SyncRepresentationModel):
         self.query = self.get_query()
         self.default_query = list(self.get_query())
 
-        representations = self.dbcon.aggregate(pipeline=self.query,
-                                               allowDiskUse=True)
-        self.refresh(representations)
-
         self.timer = QtCore.QTimer()
         self.timer.timeout.connect(self.tick)
         self.timer.start(self.REFRESH_SEC)
@@ -1003,9 +999,6 @@ class SyncRepresentationDetailModel(_SyncRepresentationModel):
         self.sort_criteria = self.DEFAULT_SORT
 
         self.query = self.get_query()
-        representations = self.dbcon.aggregate(pipeline=self.query,
-                                               allowDiskUse=True)
-        self.refresh(representations)
 
         self.timer = QtCore.QTimer()
         self.timer.timeout.connect(self.tick)

From 81a51696804915888daeeb42cf0b1d5f4c92e538 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 3 Jun 2022 11:08:52 +0200
Subject: [PATCH 0452/1227] Fix - faster loop logic

---
 openpype/modules/sync_server/sync_server.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/sync_server/sync_server.py b/openpype/modules/sync_server/sync_server.py
index 22eed01ef3..808d703616 100644
--- a/openpype/modules/sync_server/sync_server.py
+++ b/openpype/modules/sync_server/sync_server.py
@@ -282,10 +282,9 @@ class SyncServerThread(threading.Thread):
                 import time
                 start_time = None
                 self.module.set_sync_project_settings()  # clean cache
-                for collection, preset in self.module.sync_project_settings.\
-                        items():
-                    if collection not in self.module.get_enabled_projects():
-                        continue
+                enabled_projects = self.module.get_enabled_projects()
+                for collection in enabled_projects:
+                    preset = self.module.sync_project_settings["collection"]
 
                     start_time = time.time()
                     local_site, remote_site = self._working_sites(collection)

From 3c285d859a454107278470be43d00c205a0233e1 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 3 Jun 2022 12:34:21 +0200
Subject: [PATCH 0453/1227] Fix - fixes

Do creation of settings only in Thread as it is expensive operation.
---
 openpype/modules/sync_server/sync_server.py        |  6 +++---
 openpype/modules/sync_server/sync_server_module.py | 12 +++++-------
 2 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/openpype/modules/sync_server/sync_server.py b/openpype/modules/sync_server/sync_server.py
index 808d703616..356a75f99d 100644
--- a/openpype/modules/sync_server/sync_server.py
+++ b/openpype/modules/sync_server/sync_server.py
@@ -280,13 +280,13 @@ class SyncServerThread(threading.Thread):
         while self.is_running and not self.module.is_paused():
             try:
                 import time
-                start_time = None
+                start_time = time.time()
                 self.module.set_sync_project_settings()  # clean cache
+                collection = None
                 enabled_projects = self.module.get_enabled_projects()
                 for collection in enabled_projects:
-                    preset = self.module.sync_project_settings["collection"]
+                    preset = self.module.sync_project_settings[collection]
 
-                    start_time = time.time()
                     local_site, remote_site = self._working_sites(collection)
                     if not all([local_site, remote_site]):
                         continue
diff --git a/openpype/modules/sync_server/sync_server_module.py b/openpype/modules/sync_server/sync_server_module.py
index bd75172cc6..7f541d52e3 100644
--- a/openpype/modules/sync_server/sync_server_module.py
+++ b/openpype/modules/sync_server/sync_server_module.py
@@ -1029,15 +1029,10 @@ class SyncServerModule(OpenPypeModule, ITrayModule):
     def server_init(self):
         """Actual initialization of Sync Server."""
         # import only in tray or Python3, because of Python2 hosts
-        from .sync_server import SyncServerThread
-
         if not self.enabled:
             return
 
-        enabled_projects = self.get_enabled_projects()
-        if not enabled_projects:
-            self.enabled = False
-            return
+        from .sync_server import SyncServerThread
 
         self.lock = threading.Lock()
 
@@ -1057,7 +1052,7 @@ class SyncServerModule(OpenPypeModule, ITrayModule):
         self.server_start()
 
     def server_start(self):
-        if self.sync_project_settings and self.enabled:
+        if self.enabled:
             self.sync_server_thread.start()
         else:
             log.info("No presets or active providers. " +
@@ -1848,6 +1843,9 @@ class SyncServerModule(OpenPypeModule, ITrayModule):
         Returns:
             (int): in seconds
         """
+        if not project_name:
+            return 60
+
         ld = self.sync_project_settings[project_name]["config"]["loop_delay"]
         return int(ld)
 

From 96115fac6ed2addf4908e0aacaf9d3d2dc77ad12 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 3 Jun 2022 12:36:18 +0200
Subject: [PATCH 0454/1227] Fix - remove reset of Settings

Let only thread do it, expensive operation potentially.
---
 openpype/modules/sync_server/tray/models.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/modules/sync_server/tray/models.py b/openpype/modules/sync_server/tray/models.py
index d3d36cdfd4..6b309312a2 100644
--- a/openpype/modules/sync_server/tray/models.py
+++ b/openpype/modules/sync_server/tray/models.py
@@ -378,7 +378,6 @@ class _SyncRepresentationModel(QtCore.QAbstractTableModel):
                 project (str): name of project
         """
         self._project = project
-        self.sync_server.set_sync_project_settings()
         # project might have been deactivated in the meantime
         if not self.sync_server.get_sync_project_setting(project):
             return

From 7afa319b25ce94cb3cb64b1c050ad23eeb1cd873 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 3 Jun 2022 12:54:27 +0200
Subject: [PATCH 0455/1227] add subdir 'bin' when oiio path is prepared

---
 openpype/lib/vendor_bin_utils.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/openpype/lib/vendor_bin_utils.py b/openpype/lib/vendor_bin_utils.py
index 23e28ea304..e5ab2872a0 100644
--- a/openpype/lib/vendor_bin_utils.py
+++ b/openpype/lib/vendor_bin_utils.py
@@ -116,7 +116,10 @@ def get_oiio_tools_path(tool="oiiotool"):
         tool (string): Tool name (oiiotool, maketx, ...).
             Default is "oiiotool".
     """
+
     oiio_dir = get_vendor_bin_path("oiio")
+    if platform.system().lower() == "linux":
+        oiio_dir = os.path.join(oiio_dir, "bin")
     return find_executable(os.path.join(oiio_dir, tool))
 
 

From 0034d7495cebc18f0cee2466d1109d69cf52a234 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 3 Jun 2022 12:14:23 +0200
Subject: [PATCH 0456/1227] Hiero: add support for task tags

and collecting tags in general
---
 openpype/hosts/hiero/api/__init__.py          |  2 ++
 openpype/hosts/hiero/api/lib.py               | 25 +++++++++++++++++++
 .../collect_tag_tasks.py                      |  6 ++---
 .../plugins/publish/precollect_instances.py   |  5 +++-
 4 files changed, 34 insertions(+), 4 deletions(-)
 rename openpype/hosts/hiero/plugins/{publish_old_workflow => publish}/collect_tag_tasks.py (91%)

diff --git a/openpype/hosts/hiero/api/__init__.py b/openpype/hosts/hiero/api/__init__.py
index fc2d017f04..781f846bbe 100644
--- a/openpype/hosts/hiero/api/__init__.py
+++ b/openpype/hosts/hiero/api/__init__.py
@@ -29,6 +29,7 @@ from .lib import (
     get_current_sequence,
     get_timeline_selection,
     get_current_track,
+    get_track_item_tags,
     get_track_item_pype_tag,
     set_track_item_pype_tag,
     get_track_item_pype_data,
@@ -83,6 +84,7 @@ __all__ = [
     "get_current_sequence",
     "get_timeline_selection",
     "get_current_track",
+    "get_track_item_tags",
     "get_track_item_pype_tag",
     "set_track_item_pype_tag",
     "get_track_item_pype_data",
diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 761a36bd0f..06dfd2f2ee 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -274,6 +274,31 @@ def _validate_all_atrributes(
     ])
 
 
+def get_track_item_tags(track_item):
+    """
+    Get track item tags excluded openpype tag
+
+    Attributes:
+        trackItem (hiero.core.TrackItem): hiero object
+
+    Returns:
+        hiero.core.Tag: hierarchy, orig clip attributes
+    """
+    returning_tag_data = []
+    # get all tags from track item
+    _tags = track_item.tags()
+    if not _tags:
+        return []
+
+    # collect all tags which are not openpype tag
+    returning_tag_data.extend(
+        tag for tag in _tags
+        if tag.name() != self.pype_tag_name
+    )
+
+    return returning_tag_data
+
+
 def get_track_item_pype_tag(track_item):
     """
     Get pype track item tag created by creator or loader plugin.
diff --git a/openpype/hosts/hiero/plugins/publish_old_workflow/collect_tag_tasks.py b/openpype/hosts/hiero/plugins/publish/collect_tag_tasks.py
similarity index 91%
rename from openpype/hosts/hiero/plugins/publish_old_workflow/collect_tag_tasks.py
rename to openpype/hosts/hiero/plugins/publish/collect_tag_tasks.py
index 70891d5b45..27968060e1 100644
--- a/openpype/hosts/hiero/plugins/publish_old_workflow/collect_tag_tasks.py
+++ b/openpype/hosts/hiero/plugins/publish/collect_tag_tasks.py
@@ -4,16 +4,16 @@ from pyblish import api
 class CollectClipTagTasks(api.InstancePlugin):
     """Collect Tags from selected track items."""
 
-    order = api.CollectorOrder
+    order = api.CollectorOrder - 0.077
     label = "Collect Tag Tasks"
     hosts = ["hiero"]
-    families = ['clip']
+    families = ["shot"]
 
     def process(self, instance):
         # gets tags
         tags = instance.data["tags"]
 
-        tasks = dict()
+        tasks = {}
         for tag in tags:
             t_metadata = dict(tag.metadata())
             t_family = t_metadata.get("tag.family", "")
diff --git a/openpype/hosts/hiero/plugins/publish/precollect_instances.py b/openpype/hosts/hiero/plugins/publish/precollect_instances.py
index e54d050f0d..b891a37d9d 100644
--- a/openpype/hosts/hiero/plugins/publish/precollect_instances.py
+++ b/openpype/hosts/hiero/plugins/publish/precollect_instances.py
@@ -106,7 +106,10 @@ class PrecollectInstances(pyblish.api.ContextPlugin):
 
                 # clip's effect
                 "clipEffectItems": subtracks,
-                "clipAnnotations": annotations
+                "clipAnnotations": annotations,
+
+                # add all additional tags
+                "tags": phiero.get_track_item_tags(track_item)
             })
 
             # otio clip data

From 3464a7c5d7bceb1174237aeecc25e9d12c178638 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 3 Jun 2022 13:48:41 +0200
Subject: [PATCH 0457/1227] global: hierarchy publishing only to active
 instances filter

---
 .../publish/integrate_hierarchy_ftrack.py     | 47 +++++++++++--
 openpype/plugins/publish/collect_hierarchy.py |  4 --
 .../publish/extract_hierarchy_avalon.py       | 70 +++++++++----------
 3 files changed, 76 insertions(+), 45 deletions(-)

diff --git a/openpype/modules/ftrack/plugins/publish/integrate_hierarchy_ftrack.py b/openpype/modules/ftrack/plugins/publish/integrate_hierarchy_ftrack.py
index cf90c11b65..73398941eb 100644
--- a/openpype/modules/ftrack/plugins/publish/integrate_hierarchy_ftrack.py
+++ b/openpype/modules/ftrack/plugins/publish/integrate_hierarchy_ftrack.py
@@ -2,7 +2,7 @@ import sys
 import collections
 import six
 import pyblish.api
-
+from copy import deepcopy
 from openpype.pipeline import legacy_io
 
 # Copy of constant `openpype_modules.ftrack.lib.avalon_sync.CUST_ATTR_AUTO_SYNC`
@@ -72,7 +72,8 @@ class IntegrateHierarchyToFtrack(pyblish.api.ContextPlugin):
         if "hierarchyContext" not in self.context.data:
             return
 
-        hierarchy_context = self.context.data["hierarchyContext"]
+        hierarchy_context = self._get_active_assets(context)
+        self.log.debug("__ hierarchy_context: {}".format(hierarchy_context))
 
         self.session = self.context.data["ftrackSession"]
         project_name = self.context.data["projectEntity"]["name"]
@@ -86,15 +87,13 @@ class IntegrateHierarchyToFtrack(pyblish.api.ContextPlugin):
 
         self.ft_project = None
 
-        input_data = hierarchy_context
-
         # disable termporarily ftrack project's autosyncing
         if auto_sync_state:
             self.auto_sync_off(project)
 
         try:
             # import ftrack hierarchy
-            self.import_to_ftrack(input_data)
+            self.import_to_ftrack(hierarchy_context)
         except Exception:
             raise
         finally:
@@ -355,3 +354,41 @@ class IntegrateHierarchyToFtrack(pyblish.api.ContextPlugin):
             self.session.rollback()
             self.session._configure_locations()
             six.reraise(tp, value, tb)
+
+    def _get_active_assets(self, context):
+        """ Returns only asset dictionary.
+            Usually the last part of deep dictionary which
+            is not having any children
+        """
+        def get_pure_hierarchy_data(input_dict):
+            input_dict_copy = deepcopy(input_dict)
+            for key in input_dict.keys():
+                self.log.debug("__ key: {}".format(key))
+                # check if child key is available
+                if input_dict[key].get("childs"):
+                    # loop deeper
+                    input_dict_copy[
+                        key]["childs"] = get_pure_hierarchy_data(
+                            input_dict[key]["childs"])
+                elif key not in active_assets:
+                    input_dict_copy.pop(key, None)
+            return input_dict_copy
+
+        hierarchy_context = context.data["hierarchyContext"]
+
+        active_assets = []
+        # filter only the active publishing insatnces
+        for instance in context:
+            if instance.data.get("publish") is False:
+                continue
+
+            if not instance.data.get("asset"):
+                continue
+
+            active_assets.append(instance.data["asset"])
+
+        # remove duplicity in list
+        active_assets = list(set(active_assets))
+        self.log.debug("__ active_assets: {}".format(active_assets))
+
+        return get_pure_hierarchy_data(hierarchy_context)
diff --git a/openpype/plugins/publish/collect_hierarchy.py b/openpype/plugins/publish/collect_hierarchy.py
index 8398a2815a..91d5162d62 100644
--- a/openpype/plugins/publish/collect_hierarchy.py
+++ b/openpype/plugins/publish/collect_hierarchy.py
@@ -33,10 +33,6 @@ class CollectHierarchy(pyblish.api.ContextPlugin):
             family = instance.data["family"]
             families = instance.data["families"]
 
-            # filter out all unepropriate instances
-            if not instance.data["publish"]:
-                continue
-
             # exclude other families then self.families with intersection
             if not set(self.families).intersection(set(families + [family])):
                 continue
diff --git a/openpype/plugins/publish/extract_hierarchy_avalon.py b/openpype/plugins/publish/extract_hierarchy_avalon.py
index 2f528d4469..1f7ce839ed 100644
--- a/openpype/plugins/publish/extract_hierarchy_avalon.py
+++ b/openpype/plugins/publish/extract_hierarchy_avalon.py
@@ -1,7 +1,5 @@
 from copy import deepcopy
-
 import pyblish.api
-
 from openpype.pipeline import legacy_io
 
 
@@ -17,33 +15,16 @@ class ExtractHierarchyToAvalon(pyblish.api.ContextPlugin):
         if "hierarchyContext" not in context.data:
             self.log.info("skipping IntegrateHierarchyToAvalon")
             return
-        hierarchy_context = deepcopy(context.data["hierarchyContext"])
 
         if not legacy_io.Session:
             legacy_io.install()
 
-        active_assets = []
-        # filter only the active publishing insatnces
-        for instance in context:
-            if instance.data.get("publish") is False:
-                continue
-
-            if not instance.data.get("asset"):
-                continue
-
-            active_assets.append(instance.data["asset"])
-
-        # remove duplicity in list
-        self.active_assets = list(set(active_assets))
-        self.log.debug("__ self.active_assets: {}".format(self.active_assets))
-
-        hierarchy_context = self._get_assets(hierarchy_context)
-
+        hierarchy_context = self._get_active_assets(context)
         self.log.debug("__ hierarchy_context: {}".format(hierarchy_context))
-        input_data = context.data["hierarchyContext"] = hierarchy_context
 
         self.project = None
-        self.import_to_avalon(input_data)
+        self.import_to_avalon(hierarchy_context)
+
 
     def import_to_avalon(self, input_data, parent=None):
         for name in input_data:
@@ -183,23 +164,40 @@ class ExtractHierarchyToAvalon(pyblish.api.ContextPlugin):
 
         return legacy_io.find_one({"_id": entity_id})
 
-    def _get_assets(self, input_dict):
+    def _get_active_assets(self, context):
         """ Returns only asset dictionary.
             Usually the last part of deep dictionary which
             is not having any children
         """
-        input_dict_copy = deepcopy(input_dict)
-
-        for key in input_dict.keys():
-            self.log.debug("__ key: {}".format(key))
-            # check if child key is available
-            if input_dict[key].get("childs"):
-                # loop deeper
-                input_dict_copy[key]["childs"] = self._get_assets(
-                    input_dict[key]["childs"])
-            else:
-                # filter out unwanted assets
-                if key not in self.active_assets:
+        def get_pure_hierarchy_data(input_dict):
+            input_dict_copy = deepcopy(input_dict)
+            for key in input_dict.keys():
+                self.log.debug("__ key: {}".format(key))
+                # check if child key is available
+                if input_dict[key].get("childs"):
+                    # loop deeper
+                    input_dict_copy[
+                        key]["childs"] = get_pure_hierarchy_data(
+                            input_dict[key]["childs"])
+                elif key not in active_assets:
                     input_dict_copy.pop(key, None)
+            return input_dict_copy
 
-        return input_dict_copy
+        hierarchy_context = context.data["hierarchyContext"]
+
+        active_assets = []
+        # filter only the active publishing insatnces
+        for instance in context:
+            if instance.data.get("publish") is False:
+                continue
+
+            if not instance.data.get("asset"):
+                continue
+
+            active_assets.append(instance.data["asset"])
+
+        # remove duplicity in list
+        active_assets = list(set(active_assets))
+        self.log.debug("__ active_assets: {}".format(active_assets))
+
+        return get_pure_hierarchy_data(hierarchy_context)

From d86c71c15bc00d31c5459b3d75a28fcd70813696 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 3 Jun 2022 13:23:51 +0200
Subject: [PATCH 0458/1227] Fix - added disabled icon to Site Queue

---
 .../sync_server/resources/disabled.png        | Bin 0 -> 2368 bytes
 .../modules/sync_server/sync_server_module.py |  17 +++++++--
 openpype/modules/sync_server/tray/widgets.py  |  34 ++++++++++++------
 openpype/tools/loader/model.py                |   2 +-
 openpype/tools/loader/widgets.py              |  14 ++++----
 5 files changed, 48 insertions(+), 19 deletions(-)
 create mode 100644 openpype/modules/sync_server/resources/disabled.png

diff --git a/openpype/modules/sync_server/resources/disabled.png b/openpype/modules/sync_server/resources/disabled.png
new file mode 100644
index 0000000000000000000000000000000000000000..e036d7ef6a12a353551ddfc3e8a4e099c6506dd7
GIT binary patch
literal 2368
zcmb_e2~ZPP7>*VZ@L-&JptjTPQmu-cJ+dU(EfJBRpoYW5gAP_+c3;R!k`38Kf-}}?
zwXI5VMkdyC#wymMmU>MOoz_|qi=#}bPFwG)^{8UedNAtX^d*EyJ6_XiW;Xlwz3+Yh
z_y6yEZ+B5{_PAbggW@zAO|Ps>^CWb~f>%rw`aiDhoQrO;-pqVOqv>52yt)LEdJooU
zqW4I)Y3ek~L|%~HS|G}HsP((O2(8hir24%;D26I#heeXdgtzS7hhvgx!lx!%D2q28
zI;G6nK4_htZ4+h}3!I3jj>1y>JR)#I6<~h1%cJmq6CUE_Q9Ia8;#dfx7Mt+2U_fk|
zB^OJVeGoHfX+oeV3Nvt8gB>^o2Q?C7D266!illV}Me!`nGe#`@!%;Y&=-?-r$A*KU
zCll^eRWDDHWo2dBGM!fT6_GT@aU{i%3_~CUp_F@6;3qsvVh4j6DuPe)s*>!%f{ef}
zm#QWlNo~);?TyfSlyIF;#YjK!lC+iz<`e>oLIme6^|?a9MS+Aa=!PCuL0CG1^*Uu$
zR-Ez^s3XJw2!Lv9u|#4#R*Tym38APNvrro0f;<+j*vh?-oCFoQ)F;4<Sx9DLFdHwQ
z?t?&;eKuKkb*xlwhh&Ulw8_}8sgg&O%aq}rCO|V#p$SK;#t@W_plKV$@ifa*h9rvS
zDXJZ6kwwW--WjS#XdA8Lbw;$tNfh%4iaa9%6+9Cx3cN%1xdBR8a)TmBdObxr7AYg2
zF1utO3XIgzo%^%W({p{YLvo=3v#es{faF208xm4#vG7?QMFk!KW|>Vms*6^VM4mJ1
zj4Z7;5PE}7AoLEFC4imd2)&rhGLY37jSzOsH_Jk4aP@=p+joK}3y9;9GCg2)z;1L9
zMnOjtw1IUH00NGHc88Is05H-t*TI(Klh9@auFkAMRU%?E>h(HEB|8YwkjxMQU?BmF
zMuDJcgWdpjlwPpwf{qWFh|iQ1w7livJ!FL?;g(CnLcZaF5Zn(YTnHKgig>tNdQ3f@
zD{^>#nG+(?rx>I?x*|K&GT?)0MW}YqG$8pT@d}vrbm?~5ZlLWtKmaz`NH81=2)md}
z6Oa-OqR3KugC3c-T~lZ2oeWDOZ?_xvzeo>r3r^rEg6MQ5@&BI8^ZD|r$voP9|6ej>
z@JwxY82NAWg~mFazi1&tUFc8`HY2YS^bmO=K@X~v54~=fpA$+nnyw?W%xSjFgQo+j
z#eMVo9yr_BJaq3H#T88puo3~=xOSm)L;sV~h?_|<%bVg0x0!8G`w!({>(>Q-YgxB!
z%J%I$UL4#lf8x%DXhHvr-BEVwdh=@wr!=0UYf~D(ZvFPbWlovfz4eut>i7f0h9vAT
z%&&?5NS#2I?>9}a9upWexqfqQ<C5Q_j-CIsXH^4Lku$SNtjw?cv2e|I0|w4&%bsY(
zv8o+M;)uqQ#pRWGt!+2f&KSSVafPXvk#b3!Q@*iZ|3xv@MI+~oKl`A1+dDn2GIrN8
z!MtEYRL$@YQ*I_+JA&=jFR5sq^Fv%p!^wlSg)O5>=Yx5RN8LXLcoToso*=KRZtk&Q
z&-%~urkI+qbbn6@46Hwo+3)9lQ#GJ;-sqg^1M3H0+R{6U-4gFVPS%~lzS4hr!Rj@d
zG9~8vPf5#f^h~jKyS(D#Yi(zaFa2|0emyt6KIg=|yGJ)BXH;HvT{=GCudQiAk4gvc
ztP#3@;D4*2bj{?v`*)WGKCjzt)fzKOJj$!Lf4$iH@b&rhb?>P{^Szl%i7(!deS7aM
zzNT(;%PvkkVpGA2;=^|)aOd+1AhR#AZTa1q=XN!UtG86&n!S1Qi4(cwUglj+>*}kw
z_eWoQv&fQq?|bERwf<CN7r6B$$Epj5o2naPSFv0}*B<OjxH!FH)2?BL++lr~u>rnM
z>C9Ms=!$h|YexhgCj3!b@GvemCN?%ErmBVMcW6QF3v+glZdz;el5Owqy%~SyllUg~
T){1$-Z=9@*Y;(<+!ufv#nIl6P

literal 0
HcmV?d00001

diff --git a/openpype/modules/sync_server/sync_server_module.py b/openpype/modules/sync_server/sync_server_module.py
index 7f541d52e3..698b296a52 100644
--- a/openpype/modules/sync_server/sync_server_module.py
+++ b/openpype/modules/sync_server/sync_server_module.py
@@ -926,9 +926,22 @@ class SyncServerModule(OpenPypeModule, ITrayModule):
 
         return enabled_projects
 
-    def is_project_enabled(self, project_name):
+    def is_project_enabled(self, project_name, single=False):
+        """Checks if 'project_name' is enabled for syncing.
+        'get_sync_project_setting' is potentially expensive operation (pulls
+        settings for all projects if cached version is not available), using
+        project_settings for specific project should be faster.
+        Args:
+            project_name (str)
+            single (bool): use 'get_project_settings' method
+        """
         if self.enabled:
-            project_settings = self.get_sync_project_setting(project_name)
+            if single:
+                project_settings = get_project_settings(project_name)
+                project_settings = \
+                    self._parse_sync_settings_from_settings(project_settings)
+            else:
+                project_settings = self.get_sync_project_setting(project_name)
             if project_settings and project_settings.get("enabled"):
                 return True
         return False
diff --git a/openpype/modules/sync_server/tray/widgets.py b/openpype/modules/sync_server/tray/widgets.py
index 6aae9562cf..18de4d311d 100644
--- a/openpype/modules/sync_server/tray/widgets.py
+++ b/openpype/modules/sync_server/tray/widgets.py
@@ -122,11 +122,13 @@ class SyncProjectListWidget(QtWidgets.QWidget):
         self._model_reset = False
 
         selected_item = None
-        for project_name in self.sync_server.sync_project_settings.\
-                keys():
+        sync_settings = self.sync_server.sync_project_settings
+        for project_name in sync_settings.keys():
             if self.sync_server.is_paused() or \
                self.sync_server.is_project_paused(project_name):
                 icon = self._get_icon("paused")
+            elif not sync_settings["enabled"]:
+                icon = self._get_icon("disabled")
             else:
                 icon = self._get_icon("synced")
 
@@ -578,10 +580,11 @@ class SyncRepresentationSummaryWidget(_SyncRepresentationWidget):
     )
 
     def __init__(self, sync_server, project=None, parent=None):
+        import time
+        log.info("SyncRepresentationSummaryWidget start")
         super(SyncRepresentationSummaryWidget, self).__init__(parent)
 
         self.sync_server = sync_server
-
         self._selected_ids = set()  # keep last selected _id
 
         txt_filter = QtWidgets.QLineEdit()
@@ -600,8 +603,11 @@ class SyncRepresentationSummaryWidget(_SyncRepresentationWidget):
         table_view = QtWidgets.QTableView()
         headers = [item[0] for item in self.default_widths]
 
+        start_time = time.time()
         model = SyncRepresentationSummaryModel(sync_server, headers, project,
                                                parent=self)
+        log.info("SyncRepresentationSummaryModel:: {}".format(time.time() - start_time))
+        start_time = time.time()
         table_view.setModel(model)
         table_view.setContextMenuPolicy(QtCore.Qt.CustomContextMenu)
         table_view.setSelectionMode(
@@ -625,7 +631,8 @@ class SyncRepresentationSummaryWidget(_SyncRepresentationWidget):
         column = table_view.model().get_header_index("priority")
         priority_delegate = delegates.PriorityDelegate(self)
         table_view.setItemDelegateForColumn(column, priority_delegate)
-
+        log.info("SyncRepresentationSummaryWidget.2:: {}".format(time.time() - start_time))
+        start_time = time.time()
         layout = QtWidgets.QVBoxLayout(self)
         layout.setContentsMargins(0, 0, 0, 0)
         layout.addLayout(top_bar_layout)
@@ -633,27 +640,35 @@ class SyncRepresentationSummaryWidget(_SyncRepresentationWidget):
 
         self.table_view = table_view
         self.model = model
-
+        log.info("SyncRepresentationSummaryWidget.3:: {}".format(time.time() - start_time))
+        start_time = time.time()
         horizontal_header = HorizontalHeader(self)
-
+        log.info("SyncRepresentationSummaryWidget.4:: {}".format(time.time() - start_time))
+        start_time = time.time()
         table_view.setHorizontalHeader(horizontal_header)
+        log.info("SyncRepresentationSummaryWidget.4.1:: {}".format(time.time() - start_time))
+        start_time = time.time()
         table_view.setSortingEnabled(True)
-
+        log.info("SyncRepresentationSummaryWidget.5:: {}".format(time.time() - start_time))
+        start_time = time.time()
         for column_name, width in self.default_widths:
             idx = model.get_header_index(column_name)
             table_view.setColumnWidth(idx, width)
-
+        log.info("SyncRepresentationSummaryWidget.6:: {}".format(time.time() - start_time))
+        start_time = time.time()
         table_view.doubleClicked.connect(self._double_clicked)
         self.txt_filter.textChanged.connect(lambda: model.set_word_filter(
             self.txt_filter.text()))
         table_view.customContextMenuRequested.connect(self._on_context_menu)
-
+        log.info("SyncRepresentationSummaryWidget.7:: {}".format(time.time() - start_time))
+        start_time = time.time()
         model.refresh_started.connect(self._save_scrollbar)
         model.refresh_finished.connect(self._set_scrollbar)
         model.modelReset.connect(self._set_selection)
 
         self.selection_model = self.table_view.selectionModel()
         self.selection_model.selectionChanged.connect(self._selection_changed)
+        log.info("SyncRepresentationSummaryWidget.end:: {}".format(time.time() - start_time))
 
     def _prepare_menu(self, local_progress, remote_progress,
                       is_multi, can_edit, status=None):
@@ -963,7 +978,6 @@ class HorizontalHeader(QtWidgets.QHeaderView):
         super(HorizontalHeader, self).__init__(QtCore.Qt.Horizontal, parent)
         self._parent = parent
         self.checked_values = {}
-
         self.setModel(self._parent.model)
 
         self.setSectionsClickable(True)
diff --git a/openpype/tools/loader/model.py b/openpype/tools/loader/model.py
index 6f39c428be..e6bef0a33a 100644
--- a/openpype/tools/loader/model.py
+++ b/openpype/tools/loader/model.py
@@ -89,7 +89,7 @@ class BaseRepresentationModel(object):
             self._last_manager_cache = now_time
 
         sync_server = self._modules_manager.modules_by_name["sync_server"]
-        if sync_server.is_project_enabled(project_name):
+        if sync_server.is_project_enabled(project_name, single=True):
             active_site = sync_server.get_active_site(project_name)
             active_provider = sync_server.get_provider_for_site(
                 project_name, active_site)
diff --git a/openpype/tools/loader/widgets.py b/openpype/tools/loader/widgets.py
index 42fb62b632..5764085b6a 100644
--- a/openpype/tools/loader/widgets.py
+++ b/openpype/tools/loader/widgets.py
@@ -356,9 +356,10 @@ class SubsetWidget(QtWidgets.QWidget):
         enabled = False
         if project_name:
             self.model.reset_sync_server(project_name)
-            if self.model.sync_server:
-                enabled_proj = self.model.sync_server.get_enabled_projects()
-                enabled = project_name in enabled_proj
+            sync_server = self.model.sync_server
+            if sync_server:
+                enabled = sync_server.is_project_enabled(project_name,
+                                                         single=True)
 
         lib.change_visibility(self.model, self.view, "repre_info", enabled)
 
@@ -1228,9 +1229,10 @@ class RepresentationWidget(QtWidgets.QWidget):
         enabled = False
         if project_name:
             self.model.reset_sync_server(project_name)
-            if self.model.sync_server:
-                enabled_proj = self.model.sync_server.get_enabled_projects()
-                enabled = project_name in enabled_proj
+            sync_server = self.model.sync_server
+            if sync_server:
+                enabled = sync_server.is_project_enabled(project_name,
+                                                         single=True)
 
         self.sync_server_enabled = enabled
         lib.change_visibility(self.model, self.tree_view,

From 60bef01f6cd9a4f1233fcebf655254d52a8e3f04 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 3 Jun 2022 14:18:58 +0200
Subject: [PATCH 0459/1227] Fix - removed unwanted logs

---
 openpype/modules/sync_server/tray/widgets.py | 20 --------------------
 1 file changed, 20 deletions(-)

diff --git a/openpype/modules/sync_server/tray/widgets.py b/openpype/modules/sync_server/tray/widgets.py
index 18de4d311d..049a3f0127 100644
--- a/openpype/modules/sync_server/tray/widgets.py
+++ b/openpype/modules/sync_server/tray/widgets.py
@@ -580,8 +580,6 @@ class SyncRepresentationSummaryWidget(_SyncRepresentationWidget):
     )
 
     def __init__(self, sync_server, project=None, parent=None):
-        import time
-        log.info("SyncRepresentationSummaryWidget start")
         super(SyncRepresentationSummaryWidget, self).__init__(parent)
 
         self.sync_server = sync_server
@@ -603,11 +601,8 @@ class SyncRepresentationSummaryWidget(_SyncRepresentationWidget):
         table_view = QtWidgets.QTableView()
         headers = [item[0] for item in self.default_widths]
 
-        start_time = time.time()
         model = SyncRepresentationSummaryModel(sync_server, headers, project,
                                                parent=self)
-        log.info("SyncRepresentationSummaryModel:: {}".format(time.time() - start_time))
-        start_time = time.time()
         table_view.setModel(model)
         table_view.setContextMenuPolicy(QtCore.Qt.CustomContextMenu)
         table_view.setSelectionMode(
@@ -631,8 +626,6 @@ class SyncRepresentationSummaryWidget(_SyncRepresentationWidget):
         column = table_view.model().get_header_index("priority")
         priority_delegate = delegates.PriorityDelegate(self)
         table_view.setItemDelegateForColumn(column, priority_delegate)
-        log.info("SyncRepresentationSummaryWidget.2:: {}".format(time.time() - start_time))
-        start_time = time.time()
         layout = QtWidgets.QVBoxLayout(self)
         layout.setContentsMargins(0, 0, 0, 0)
         layout.addLayout(top_bar_layout)
@@ -640,35 +633,22 @@ class SyncRepresentationSummaryWidget(_SyncRepresentationWidget):
 
         self.table_view = table_view
         self.model = model
-        log.info("SyncRepresentationSummaryWidget.3:: {}".format(time.time() - start_time))
-        start_time = time.time()
         horizontal_header = HorizontalHeader(self)
-        log.info("SyncRepresentationSummaryWidget.4:: {}".format(time.time() - start_time))
-        start_time = time.time()
         table_view.setHorizontalHeader(horizontal_header)
-        log.info("SyncRepresentationSummaryWidget.4.1:: {}".format(time.time() - start_time))
-        start_time = time.time()
         table_view.setSortingEnabled(True)
-        log.info("SyncRepresentationSummaryWidget.5:: {}".format(time.time() - start_time))
-        start_time = time.time()
         for column_name, width in self.default_widths:
             idx = model.get_header_index(column_name)
             table_view.setColumnWidth(idx, width)
-        log.info("SyncRepresentationSummaryWidget.6:: {}".format(time.time() - start_time))
-        start_time = time.time()
         table_view.doubleClicked.connect(self._double_clicked)
         self.txt_filter.textChanged.connect(lambda: model.set_word_filter(
             self.txt_filter.text()))
         table_view.customContextMenuRequested.connect(self._on_context_menu)
-        log.info("SyncRepresentationSummaryWidget.7:: {}".format(time.time() - start_time))
-        start_time = time.time()
         model.refresh_started.connect(self._save_scrollbar)
         model.refresh_finished.connect(self._set_scrollbar)
         model.modelReset.connect(self._set_selection)
 
         self.selection_model = self.table_view.selectionModel()
         self.selection_model.selectionChanged.connect(self._selection_changed)
-        log.info("SyncRepresentationSummaryWidget.end:: {}".format(time.time() - start_time))
 
     def _prepare_menu(self, local_progress, remote_progress,
                       is_multi, can_edit, status=None):

From a9fdcd80aaee0db6dddc0e777e9dd021459f04c2 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 3 Jun 2022 14:44:11 +0200
Subject: [PATCH 0460/1227] OP-3231 - return only active projects in
 webpublisher ProjectsEndpoing

---
 .../webserver_service/webpublish_routes.py       | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
index e82ba7f2b8..70324fc39c 100644
--- a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
+++ b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
@@ -71,16 +71,12 @@ class ProjectsEndpoint(_RestApiEndpoint):
     """Returns list of dict with project info (id, name)."""
     async def get(self) -> Response:
         output = []
-        for project_name in self.dbcon.database.collection_names():
-            project_doc = self.dbcon.database[project_name].find_one({
-                "type": "project"
-            })
-            if project_doc:
-                ret_val = {
-                    "id": project_doc["_id"],
-                    "name": project_doc["name"]
-                }
-                output.append(ret_val)
+        for project_doc in self.dbcon.projects():
+            ret_val = {
+                "id": project_doc["_id"],
+                "name": project_doc["name"]
+            }
+            output.append(ret_val)
         return Response(
             status=200,
             body=self.resource.encode(output),

From 98504a205210471242f0c955d3f549561ec392df Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 3 Jun 2022 14:45:05 +0200
Subject: [PATCH 0461/1227] implemented action that can tranfer values of 1
 hierarchical attribute to another

---
 .../action_translate_hierarchical_values.py   | 331 ++++++++++++++++++
 1 file changed, 331 insertions(+)
 create mode 100644 openpype/modules/ftrack/event_handlers_server/action_translate_hierarchical_values.py

diff --git a/openpype/modules/ftrack/event_handlers_server/action_translate_hierarchical_values.py b/openpype/modules/ftrack/event_handlers_server/action_translate_hierarchical_values.py
new file mode 100644
index 0000000000..fd10005fad
--- /dev/null
+++ b/openpype/modules/ftrack/event_handlers_server/action_translate_hierarchical_values.py
@@ -0,0 +1,331 @@
+import copy
+import json
+import collections
+
+import ftrack_api
+
+from openpype_modules.ftrack.lib import (
+    ServerAction,
+    statics_icon,
+)
+from openpype_modules.ftrack.lib.avalon_sync import create_chunks
+
+
+class TranslateHierarchicalValues(ServerAction):
+    """Transfer values across hierarhcical attributes.
+
+    Aalso gives ability to convert types meanwhile. That is limited to
+    conversions between numbers and strings
+    - int <-> float
+    - in, float -> string
+    """
+
+    identifier = "translate.hierarchical.values"
+    label = "OpenPype Admin"
+    variant = "- Translate values between 2 custom attributes"
+    description = (
+        "Move values from a hierarchical attribute to"
+        " second hierarchical attribute."
+    )
+    icon = statics_icon("ftrack", "action_icons", "OpenPypeAdmin.svg")
+
+    all_project_entities_query = (
+        "select id, name, parent_id, link"
+        " from TypedContext where project_id is \"{}\""
+    )
+    cust_attr_query = (
+        "select value, entity_id from CustomAttributeValue"
+        " where entity_id in ({}) and configuration_id is \"{}\""
+    )
+    settings_key = "clean_hierarchical_attr"
+
+    def discover(self, session, entities, event):
+        """Show anywhere."""
+
+        return self.valid_roles(session, entities, event)
+
+    def _selection_interface(self, session, event_values=None):
+        title = "Translate hierarchical values"
+
+        attr_confs = session.query(
+            (
+                "select id, key from CustomAttributeConfiguration"
+                " where is_hierarchical is true"
+            )
+        ).all()
+        attr_items = []
+        for attr_conf in attr_confs:
+            attr_items.append({
+                "value": attr_conf["id"],
+                "label": attr_conf["key"]
+            })
+
+        if len(attr_items) < 2:
+            return {
+                "title": title,
+                "items": [{
+                    "type": "label",
+                    "value": (
+                        "Didn't found custom attributes"
+                        " that can be translated."
+                    )
+                }]
+            }
+
+        attr_items = sorted(attr_items, key=lambda item: item["label"])
+        items = []
+        item_splitter = {"type": "label", "value": "---"}
+        items.append({
+            "type": "label",
+            "value": (
+                "<h2>Please select source and destination"
+                " Custom attribute</h2>"
+            )
+        })
+        items.append({
+            "type": "label",
+            "value": (
+                "<b>WARNING:</b> This will take affect for all projects!"
+            )
+        })
+        if event_values:
+            items.append({
+                "type": "label",
+                "value": (
+                    "<b>Note:</b> Please select 2 different custom attributes."
+                )
+            })
+
+        items.append(item_splitter)
+
+        src_item = {
+            "type": "enumerator",
+            "label": "Source",
+            "name": "src_attr_id",
+            "data": copy.deepcopy(attr_items)
+        }
+        dst_item = {
+            "type": "enumerator",
+            "label": "Destination",
+            "name": "dst_attr_id",
+            "data": copy.deepcopy(attr_items)
+        }
+        delete_item = {
+            "type": "boolean",
+            "name": "delete_dst_attr_first",
+            "label": "Delete first",
+            "value": False
+        }
+        if event_values:
+            src_item["value"] = event_values["src_attr_id"]
+            dst_item["value"] = event_values["dst_attr_id"]
+            delete_item["value"] = event_values["delete_dst_attr_first"]
+
+        items.append(src_item)
+        items.append(dst_item)
+        items.append(item_splitter)
+        items.append({
+            "type": "label",
+            "value": (
+                "<b>WARNING:</b> All values from destination"
+                " Custom Attribute will be removed if this is enabled."
+            )
+        })
+        items.append(delete_item)
+
+        return {
+            "title": title,
+            "items": items
+        }
+
+    def interface(self, session, entities, event):
+        if event["data"].get("values", {}):
+            return None
+
+        return self._selection_interface(session)
+
+    def launch(self, session, entities, event):
+        values = event["data"].get("values", {})
+        if not values:
+            return None
+        src_attr_id = values["src_attr_id"]
+        dst_attr_id = values["dst_attr_id"]
+        delete_dst_values = values["delete_dst_attr_first"]
+
+        if not src_attr_id or not dst_attr_id:
+            return {
+                "success": True,
+                "message": "Nothing to do"
+            }
+
+        if src_attr_id == dst_attr_id:
+            return self._selection_interface(session, values)
+
+        # Query custom attrbutes
+        src_conf = session.query((
+            "select id from CustomAttributeConfiguration where id is {}"
+        ).format(src_attr_id)).one()
+        dst_conf = session.query((
+            "select id from CustomAttributeConfiguration where id is {}"
+        ).format(dst_attr_id)).one()
+        src_type_name = src_conf["type"]["name"]
+        dst_type_name = dst_conf["type"]["name"]
+        # Limit conversion to
+        # - same type -> same type (there is no need to do conversion)
+        # - number <Any> -> number <Any> (int to float and back)
+        # - number <Any> -> str (any number can be converted to str)
+        src_type = None
+        dst_type = None
+        if src_type_name == "number" or src_type_name != dst_type_name:
+            src_type = self._get_attr_type(dst_conf)
+            dst_type = self._get_attr_type(dst_conf)
+            valid = False
+            # Can convert numbers
+            if src_type in (int, float) and dst_type in (int, float):
+                valid = True
+            # Can convert numbers to string
+            elif dst_type is str:
+                valid = True
+
+            if not valid:
+                return {
+                    "message": (
+                        "Don't know how to properly convert"
+                        " custom attribute types {} > {}"
+                    ).format(src_type_name, dst_type_name),
+                    "success": False
+                }
+
+        # Query source values
+        src_attr_values = session.query(
+            (
+                "select value, entity_id"
+                " from CustomAttributeValue"
+                " where configuration_id is {}"
+            ).format(src_attr_id)
+        ).all()
+
+        value_by_id = {}
+        failed_entity_ids = []
+        for attr_value in src_attr_values:
+            entity_id = attr_value["entity_id"]
+            value = attr_value["value"]
+            if value is not None:
+                try:
+                    if dst_type is not None:
+                        value = dst_type(value)
+                    value_by_id[entity_id] = value
+                except Exception:
+                    failed_entity_ids.append(entity_id)
+
+        if failed_entity_ids:
+            return {
+                "success": False,
+                "message": (
+                    "Couldn't convert some values to destination attribute"
+                )
+            }
+
+
+        # Delete destination custom attributes first
+        if delete_dst_values:
+            self.log.info("Deleting destination custom attribute values first")
+            self._delete_custom_attribute_values(session, dst_attr_id)
+
+        self._apply_values(session, value_by_id, dst_attr_id)
+        return True
+
+    def _delete_custom_attribute_values(self, session, dst_attr_id):
+        dst_attr_values = session.query(
+            (
+                "select configuration_id, entity_id"
+                " from CustomAttributeValue"
+                " where configuration_id is {}"
+            ).format(dst_attr_id)
+        ).all()
+        delete_operations = []
+        for attr_value in dst_attr_values:
+            entity_id = attr_value["entity_id"]
+            configuration_id = attr_value["configuration_id"]
+            entity_key = collections.OrderedDict((
+                ("configuration_id", configuration_id),
+                ("entity_id", entity_id)
+            ))
+            delete_operations.append(
+                ftrack_api.operation.DeleteEntityOperation(
+                    "CustomAttributeValue",
+                    entity_key
+                )
+            )
+
+        if not delete_operations:
+            return
+
+        for chunk in create_chunks(delete_operations, 500):
+            for operation in chunk:
+                session.recorded_operations.push(operation)
+            session.commit()
+
+    def _apply_values(self, session, value_by_id, dst_attr_id):
+        dst_attr_values = session.query(
+            (
+                "select configuration_id, entity_id"
+                " from CustomAttributeValue"
+                " where configuration_id is {}"
+            ).format(dst_attr_id)
+        ).all()
+
+        dst_entity_ids_with_value = {
+            item["entity_id"]
+            for item in dst_attr_values
+        }
+        operations = []
+        for entity_id, value in value_by_id.items():
+            entity_key = collections.OrderedDict((
+                ("configuration_id", dst_attr_id),
+                ("entity_id", entity_id)
+            ))
+            if entity_id in dst_entity_ids_with_value:
+                operations.append(
+                    ftrack_api.operation.UpdateEntityOperation(
+                        "CustomAttributeValue",
+                        entity_key,
+                        "value",
+                        ftrack_api.symbol.NOT_SET,
+                        value
+                    )
+                )
+            else:
+                operations.append(
+                    ftrack_api.operation.CreateEntityOperation(
+                        "CustomAttributeValue",
+                        entity_key,
+                        {"value": value}
+                    )
+                )
+
+        if not operations:
+            return
+
+        for chunk in create_chunks(operations, 500):
+            for operation in chunk:
+                session.recorded_operations.push(operation)
+            session.commit()
+
+    def _get_attr_type(self, conf_def):
+        type_name = conf_def["type"]["name"]
+        if type_name == "text":
+            return str
+
+        if type_name == "number":
+            config = json.loads(conf_def["config"])
+            if config["isdecimal"]:
+                return float
+            return int
+        return None
+
+
+def register(session):
+    '''Register plugin. Called when used as an plugin.'''
+
+    TranslateHierarchicalValues(session).register()

From 8e7358a33b9da4a97681a1dae4119e30b238a24a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 3 Jun 2022 14:51:21 +0200
Subject: [PATCH 0462/1227] changed translate to transfer

---
 .../action_translate_hierarchical_values.py        | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_translate_hierarchical_values.py b/openpype/modules/ftrack/event_handlers_server/action_translate_hierarchical_values.py
index fd10005fad..8cc6fa3a57 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_translate_hierarchical_values.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_translate_hierarchical_values.py
@@ -11,7 +11,7 @@ from openpype_modules.ftrack.lib import (
 from openpype_modules.ftrack.lib.avalon_sync import create_chunks
 
 
-class TranslateHierarchicalValues(ServerAction):
+class TransferHierarchicalValues(ServerAction):
     """Transfer values across hierarhcical attributes.
 
     Aalso gives ability to convert types meanwhile. That is limited to
@@ -20,9 +20,9 @@ class TranslateHierarchicalValues(ServerAction):
     - in, float -> string
     """
 
-    identifier = "translate.hierarchical.values"
+    identifier = "transfer.hierarchical.values"
     label = "OpenPype Admin"
-    variant = "- Translate values between 2 custom attributes"
+    variant = "- Transfer values between 2 custom attributes"
     description = (
         "Move values from a hierarchical attribute to"
         " second hierarchical attribute."
@@ -37,7 +37,7 @@ class TranslateHierarchicalValues(ServerAction):
         "select value, entity_id from CustomAttributeValue"
         " where entity_id in ({}) and configuration_id is \"{}\""
     )
-    settings_key = "clean_hierarchical_attr"
+    settings_key = "transfer_values_of_hierarchical_attributes"
 
     def discover(self, session, entities, event):
         """Show anywhere."""
@@ -45,7 +45,7 @@ class TranslateHierarchicalValues(ServerAction):
         return self.valid_roles(session, entities, event)
 
     def _selection_interface(self, session, event_values=None):
-        title = "Translate hierarchical values"
+        title = "Transfer hierarchical values"
 
         attr_confs = session.query(
             (
@@ -67,7 +67,7 @@ class TranslateHierarchicalValues(ServerAction):
                     "type": "label",
                     "value": (
                         "Didn't found custom attributes"
-                        " that can be translated."
+                        " that can be transfered."
                     )
                 }]
             }
@@ -328,4 +328,4 @@ class TranslateHierarchicalValues(ServerAction):
 def register(session):
     '''Register plugin. Called when used as an plugin.'''
 
-    TranslateHierarchicalValues(session).register()
+    TransferHierarchicalValues(session).register()

From 3da8536f968c932811a7979680cc27980594c2fe Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 3 Jun 2022 14:51:32 +0200
Subject: [PATCH 0463/1227] added settings for new action

---
 .../defaults/project_settings/ftrack.json     |  7 +++++++
 .../schema_project_ftrack.json                | 19 +++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/ftrack.json b/openpype/settings/defaults/project_settings/ftrack.json
index f9d16d6476..9d59deea3d 100644
--- a/openpype/settings/defaults/project_settings/ftrack.json
+++ b/openpype/settings/defaults/project_settings/ftrack.json
@@ -109,6 +109,13 @@
                 "Omitted"
             ],
             "name_sorting": false
+        },
+        "transfer_values_of_hierarchical_attributes": {
+            "enabled": true,
+            "role_list": [
+                "Administrator",
+                "Project manager"
+            ]
         }
     },
     "user_handlers": {
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json b/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
index 7db490b114..16cab49d5d 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
@@ -369,6 +369,25 @@
                             "key": "name_sorting"
                         }
                     ]
+                },
+                {
+                    "type": "dict",
+                    "key": "transfer_values_of_hierarchical_attributes",
+                    "label": "Action to transfer hierarchical attribute values",
+                    "checkbox_key": "enabled",
+                    "children": [
+                        {
+                            "type": "boolean",
+                            "key": "enabled",
+                            "label": "Enabled"
+                        },
+                        {
+                            "type": "list",
+                            "key": "role_list",
+                            "label": "Roles",
+                            "object_type": "text"
+                        }
+                    ]
                 }
             ]
         },

From d37497df10d6883f3b154f076ce91e7163c9d89b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 3 Jun 2022 14:54:33 +0200
Subject: [PATCH 0464/1227] changed filename

---
 ...erarchical_values.py => action_tranfer_hierarchical_values.py} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename openpype/modules/ftrack/event_handlers_server/{action_translate_hierarchical_values.py => action_tranfer_hierarchical_values.py} (100%)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_translate_hierarchical_values.py b/openpype/modules/ftrack/event_handlers_server/action_tranfer_hierarchical_values.py
similarity index 100%
rename from openpype/modules/ftrack/event_handlers_server/action_translate_hierarchical_values.py
rename to openpype/modules/ftrack/event_handlers_server/action_tranfer_hierarchical_values.py

From 078a47e32f39b02c4c6c5db8860c2c7a6de886b5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 3 Jun 2022 14:58:59 +0200
Subject: [PATCH 0465/1227] added some logs

---
 .../action_tranfer_hierarchical_values.py     | 38 +++++++++++++------
 1 file changed, 27 insertions(+), 11 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_tranfer_hierarchical_values.py b/openpype/modules/ftrack/event_handlers_server/action_tranfer_hierarchical_values.py
index 8cc6fa3a57..9df3b67969 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_tranfer_hierarchical_values.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_tranfer_hierarchical_values.py
@@ -153,12 +153,17 @@ class TransferHierarchicalValues(ServerAction):
         delete_dst_values = values["delete_dst_attr_first"]
 
         if not src_attr_id or not dst_attr_id:
+            self.log.info("Attributes were not filled. Nothing to do.")
             return {
                 "success": True,
                 "message": "Nothing to do"
             }
 
         if src_attr_id == dst_attr_id:
+            self.log.info((
+                "Same attributes were selected {}, {}."
+                " Showing interface again."
+            ).format(src_attr_id, dst_attr_id))
             return self._selection_interface(session, values)
 
         # Query custom attrbutes
@@ -188,6 +193,10 @@ class TransferHierarchicalValues(ServerAction):
                 valid = True
 
             if not valid:
+                self.log.info((
+                    "Don't know how to properly convert"
+                    " custom attribute types {} > {}"
+                ).format(src_type_name, dst_type_name))
                 return {
                     "message": (
                         "Don't know how to properly convert"
@@ -205,20 +214,26 @@ class TransferHierarchicalValues(ServerAction):
             ).format(src_attr_id)
         ).all()
 
-        value_by_id = {}
+        self.log.debug("Queried source values.")
         failed_entity_ids = []
-        for attr_value in src_attr_values:
-            entity_id = attr_value["entity_id"]
-            value = attr_value["value"]
-            if value is not None:
-                try:
-                    if dst_type is not None:
-                        value = dst_type(value)
-                    value_by_id[entity_id] = value
-                except Exception:
-                    failed_entity_ids.append(entity_id)
+        if dst_type is not None:
+            self.log.debug("Converting source values to desctination type")
+            value_by_id = {}
+            for attr_value in src_attr_values:
+                entity_id = attr_value["entity_id"]
+                value = attr_value["value"]
+                if value is not None:
+                    try:
+                        if dst_type is not None:
+                            value = dst_type(value)
+                        value_by_id[entity_id] = value
+                    except Exception:
+                        failed_entity_ids.append(entity_id)
 
         if failed_entity_ids:
+            self.log.info(
+                "Couldn't convert some values to destination attribute"
+            )
             return {
                 "success": False,
                 "message": (
@@ -232,6 +247,7 @@ class TransferHierarchicalValues(ServerAction):
             self.log.info("Deleting destination custom attribute values first")
             self._delete_custom_attribute_values(session, dst_attr_id)
 
+        self.log.info("Applying source values on destination custom attribute")
         self._apply_values(session, value_by_id, dst_attr_id)
         return True
 

From 7500097cc47b18f8d9422547d13500e89427dd0f Mon Sep 17 00:00:00 2001
From: murphy <murphy@e-area.cz>
Date: Fri, 3 Jun 2022 14:54:53 +0200
Subject: [PATCH 0466/1227] added Royal Render and Multiverse

updated Nuke Studio icon, Flame moved to integrations
---
 website/src/pages/index.js             |  22 ++++++++++++++++------
 website/static/img/app_flame.png       | Bin 74845 -> 39096 bytes
 website/static/img/app_hiero.png       | Bin 40175 -> 33079 bytes
 website/static/img/app_multiverse.png  | Bin 0 -> 4814 bytes
 website/static/img/app_nuke.png        | Bin 25887 -> 32869 bytes
 website/static/img/app_nukestudio.png  | Bin 0 -> 37527 bytes
 website/static/img/app_royalrender.png | Bin 0 -> 11650 bytes
 7 files changed, 16 insertions(+), 6 deletions(-)
 create mode 100644 website/static/img/app_multiverse.png
 create mode 100644 website/static/img/app_nukestudio.png
 create mode 100644 website/static/img/app_royalrender.png

diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index d9bbc3eaa0..f57fd1002a 100644
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -299,6 +299,11 @@ function Home() {
                   <img src="/img/app_maya.png" alt="" title=""></img>
                   <span className="caption">Maya</span>
                 </a>
+				
+                <a className="link" href="https://www.autodesk.com/products/flame">
+                  <img src="/img/app_flame.png" alt="" title=""></img>
+                  <span className="caption">Flame</span>
+                </a>
 
                 <a className="link" href="https://www.foundry.com/products/nuke-family/nuke">
                   <img src="/img/app_nuke.png" alt="" title=""></img>
@@ -306,7 +311,7 @@ function Home() {
                 </a>
 
                 <a className="link" href="https://www.foundry.com/products/nuke-family/nuke-studio">
-                  <img src="/img/app_nuke.png" alt="" title=""></img>
+                  <img src="/img/app_nukestudio.png" alt="" title=""></img>
                   <span className="caption">Nuke Studio</span>
                 </a>
 
@@ -374,12 +379,17 @@ function Home() {
                   <img src="/img/app_deadline.png" alt="" title=""></img>
                   <span className="caption">Deadline</span>
                 </a>
-
+				
                 <a className="link" href="https://www.vvertex.com">
                   <img src="/img/app_muster.png" alt="" title=""></img>
                   <span className="caption">Muster</span>
                 </a>
 
+				<a className="link" href="https://www.royalrender.de/index.php/startseite.html">
+                  <img src="/img/app_royalrender.png" alt="" title=""></img>
+                  <span className="caption">Royal Render</span>
+                </a>
+
                 <a className="link" href="https://www.slack.com">
                   <img src="/img/app_slack.png" alt="" title=""></img>
                   <span className="caption">Slack</span>
@@ -390,10 +400,10 @@ function Home() {
               <p> <b>In development by us or OpenPype community.</b></p>
 
               <div className={classnames('showcase',)}>
-
-                <a className="link" href="https://www.autodesk.com/products/flame">
-                  <img src="/img/app_flame.png" alt="" title=""></img>
-                  <span className="caption">Flame</span>
+			  
+                <a className="link" href="https://j-cube.jp/solutions/multiverse/">
+                  <img src="/img/app_multiverse.png" alt="" title=""></img>
+                  <span className="caption">Multiverse</span>
                 </a>
 
                 <a className="link" href="https://www.shotgridsoftware.com/">
diff --git a/website/static/img/app_flame.png b/website/static/img/app_flame.png
index ba9b69e45fa73d3f9298e77ec4a167a38f7ecf7b..188153e573f64ae8f66d9a27092cb47b7049fc23 100644
GIT binary patch
literal 39096
zcmV)tK$pLXP)<h;3K|Lk000e1NJLTq00Arj00Arr1^@s6d3}y`00001b5ch_0olnc
ze*gdg32;bRa{vGf6951U69E94oEQKAm|aOkK~#90?7at|Bu8~Fe5$)==H}hKn}g6Q
z$6Y0mP();bF&J!PY;3^hIsL{s{5<UE@LSk8!h7(XvB7|CjFS*S#z+DLNJ0o93FWZb
zyn8p^oF;YEe@<8Knd!N^d*j|dyLG3hyQ;dnr|awQoH}(Xf?RURC6^^4(Ly&Mmt1nm
zWu}q?RxY{ZvScI&tXy)*WywemSh?hq%aV~CuyV;Imn9=PVC9laE=xvoz{(|&m)w0@
z2|v0pbz<sJiMCf_T8*h6(<)4TD)p-4l!_`pQ`@1cHpW!NBrsJ}npSBX)0j#lm<ClE
zQOC<F(e~6sum0i6TwQxEOGk3RT85&)i2!H~NDv}WIt$ZQOq*5Ofaygr|IbJr(>_dx
zF&$KC54L$XNH815bR5%A4r0qsa==;!f}On^KhDE+iAooPWKAw$l@_dlzR)vywo0xL
zIJtl|h}ZQrem<qr4g|2t`D|z|^DjAIokoHknA9}Qkj}w$Ii{OHf>m(=n>HIlfVy5K
zEpKwRt9bn{;O93neIL^<Ob0L>L?9cVw^rsdr;-EK5*MZ3U5DugOxI%C0ur!@Ik5$7
z+I$NE^2I8V&5YO>0oDP$M-SlVeV86V@G37{6LUFL$pLGL3U<O<@Z(*W-V95hJ<YZd
zP_I&H8>ZK({lvm<$InkAaQ*i}H7=KvmmIK`fGAauRJ;o@-Hhp#n9g0uHZ4&hVE-{n
zN`3qqrf*;(TiDLr2DbPm2dqUb*r_&wWCuTl=>m|3=rFTTE;E&LReCq3otU1%`~4sI
zc{c*ru?1~eE-fVotVJYhH1A4~HmNsax*F#1HzI#0@`)N(X#(Vk9Jv=z2Od)22c3Kq
zsvI#B8pW$&s$++b)%Ap`{RNOlbGknA+v)-7$3^~JG+Ifj8@XAm1?f()%E_bib<WXs
zQ~NGZiCzp9Z1;EY^S>~W?d#E;c`Y8v0c#Nmc90eL@fJ+42MJcxX@faDB{_4FL7IG<
z_F~!tQY|82asi8gX&O7MIGK|u;G$Gf^$lj_$NNCGCjuq{C>O8@$jF$!71Nm@ea2{T
zVJ>WU1gtN^bR$Tx{x-Jj%lP>@yq?iHIA1O&AUR+ypkPO!j`&_o{}blk4~o<tVhj&r
z`YNUuumjfT_?#ys3K*wUO3Q6}1MeF>x1`R!3ez<pM@P?@<>t@}gH-Y#QR#2+ydT2P
zKhIUhg_9hx=2;xIk8D#v2T~=PE#V-C^N(N}!1OpKQg5E6gdMFqi|1M}Q9%2wN`Hy>
zl$h3qD!mlbc9390K3n7zI~#13UMRnV=@;>Qe}|tm%J@jGF3zvyfHhBo4>_qhKZxna
zK{|A9gxOR3$hJhzlHbDgU64~-j)I)NvZz?pT!;c<0_Vr^K7S6RJ!~DwsYPT5B<ESW
z=c{Jnbo7Gx4NULA^nE<vXYun(*oLuLs5_T7k^|Npin7UEis`kOejOx8ovKjhB-_d}
znC=G&P-GZBItz6#c~Jm;RHY{|k^PB&3j(k!KmyqHm@WcoD?AxH7`<rpjDjD)bO`JJ
zKlphko%3XEez~-l9I)m<9H9CIOs@cGUn!howFFXRf4Uc>EsFez2K9(sF4>|0{Z9OC
z$bLsGiELnG`y%5y*}*oPLiO|_`Xi7o5?{x2{4M0bH7Ak-)+~z}%KtM=KM!&k|5SxW
z@~8v+J9dCQvryl%76tH{fqfg(|Hj{JD}KHe<O}AkldPIvNZO9}PD~%edf%VFP-a(h
zz?vn&hm+p2r2735rWc<=RWw4j2h;aJ8g}o+hyLIxH!zo$qFw}lhQHxwKr${G5TW02
zE65mOCo1%!A``$(Sm$5i=bd<tL$lM`<t;g2ouc3aN&Z4K-Q!&#NB>Ud0Vg4#B9I~@
zE~$Nc@gbj>jW*^oGf^*wf5qSQ4v_v{1YR^qLf~~Wzblm^z<LDh{1krvTmGA#n&g0W
zl7bH)jX05g>VqKFfRhm#-J>ulG$rKgm>$oA(k;9wP)Xu!;qUxOkZuz6TmLA?=}{*#
z+DJfmgG%qi`p7ln>v)dg*=_amkQ}g1LhzxZQKt8SoQS;gB&r}bMF#XwfDC!EYxY`~
z%WR5zfjmS>%{3%LJsH=@P=BJVi(YIW$Mj8dLdCl8pVh`L1IYpF1Vl}txfRo|o<cPg
zmx<JbJ9714X^DEV?84{Z3;6j4koL+OPOut!!BODBH(@;=#m`&wDL*rp9I$2}_+Zfj
z3-m_)Fs7?cq6+dpC%Y8cr~WH<GF;lCUNrxz<`|M67TLMT-gTmE`&TgCfc4PStOv2)
z>Dg`R=_fg0wGn)n=pp?7Kn{CvK8Y$Q=F&f5`U<9F_)zj$Y+f!4DD>jN=i}c%+8-&P
z;!lB$RW?&0e?2nH|1+k4$GUzW>l~T=mYzP616B)Bv8d<)BqM3h2^Qav>26H_0@5wv
zw3x$}OQWb45Y65Ew3?<vOzS5wy&BUQGpvSQgujOA=dg}Hz|ViedI#pBy-Qtkz-l7+
z&`>CozXWMu?Kpv=MCr*HkyOVA^O2zCCF;fWHGF;^0ck>@ff))HG}BmK<iB+*rq^N}
z@4@<>o|A?yVaWk2CHSC_^CykuY&pTAwDi;;f{YiQ1JyDX_4|JXpCuXzCa?G32Dzl#
zOoU#LF9$h|=zm~ccg|5Wm!#x?1!nHwR*>Odei=?|N(}|TqX+>+;~$;<*5$HPMFH1G
z@%f^q$H=@uK^o7TVR3q4-iBrW0zWC7&7OR2Vh&hZZpQR`AR|rAREYl58<ZSJzn!}%
z<kCv$MTWq$1LVL9*+fZQoJo`jdU5_HNVW1-O!v%H8<&bKYrw*Xh-msxgH+{a8cl(m
zKA*!x;Y7Za`_SYv6Hza;yOf$panWe5A;poOiSsGN^CA_IRLf6dUB~CHrHfmZEnun1
z%H+65el#-$D+=*K_N`B2+LgN~<Z_}yFF1VmX!MvO!IFLJf56N_+t4#gTEL63{I4$8
z$<)gdu<!>bN`4o}#SUgFMCpG4AC#}pO{;QQE}~v^6wmB;@mVA_kHQC?H-n<2B9cGg
zEm-a~SkHrV*vv&K%L=emtSWk|eE?<-R^-S>BQ+mcjt@vKb1U=$#OIO>^5lm_Bh)kT
zmZxX;Kd~G!u1_zgm|M#Ru<*wvUl^LS`ui~R+4kfIL;hH_#M6<vYFjSLTj)iI&nHdO
zp;5&5fLzk7ozN&E`TKQY*-tE&X+6sVu<!?^D3TPymX>Rp$u$$JqOc+##Rp;ET(&Kj
zTu9Ulk(Lsp1zc%zJq-r6V_Wp%{RpP($soTRqJEtAfQ3Kg&G<p<$<d@`HiIH$%%q3l
z<GBN9F7qw)f>hIU=s6@cvE9NY)Q2g6<at=`eOUe*bKJxQmD3uq@CPKnDw=paQ?GS0
ztiKn3^smfat8&RDThxp4L-_nYfuDa4?G5tuBBmGeKVg}l#PZ*q>ozWwoR)y4jO#QK
zNHMx+5@CTB!=xBTAD&Hb^<VqK?a`i9#Ve-c`no!>g97SPok3Kd1~%0dF<ywn@^l#0
z*B5&PkLvY*yyC`X@5!8t6?$>vvrO!X<|I-Kt#&go=*9dQRpvXVqcQ%p1T2s<<w>oZ
z30Rd?-oL{ic>ioRVysq;CMGKHm?{+BzymfK2$-yjcuWWw;G9*1Kpccxb#Ovd>xF7~
z;GN&Od+f~4F3va`E=PsYViZ9~6i!b}#S=vlz~t&E{_q)><e;{UM0v@Rw>#OV2)No!
z#;0eVd<99JJnb}v(+aTE>dHS0a=Oe+qAbvA!DLwf<Xp7p6F>4}<tzW{L!x8Dx=pqI
z6<eW>FT9uoV+_i)+$W0xK}<~4>kzPDB4SWER4I#M5RG;qz^y10pp!)iT;V{WP=a-1
z^@%@z=8=6-5L8eHC{M@nf$3UpDh!y21sjS*Jkk}0(8ZV-uf>z&AZk5fC`tj;hvQmh
ztQLx%&LVu|;ww+PH}B~z>P1RETLfBUkl)^>2!&$49rOP#$QSWx6EO0$0W1}0kA9%{
z!pyFVB7hRGeQPe;RjZcc`u+oARsTwu3>YxQkF@n);4bnaj5+VE0rXDA6hgeRmOzb7
z1B95f6ozpp0#SEZh<gi#%F05KuPJrLr68DG)!AKVgkGGF4A&|{<8ch5oYPqj;O>z+
zN7UlMNG*natHOHRT?g_0M;<s>f%<rNA%YUH%5bedI1OQ~uNVo$!pTErD2q5^oy89E
zcb8qBGrGki6mN@G_M!QRH@3-3FYG_Yw2_SXr%PbK(+03WP7<ZJPcVbLG;~a%I}Xon
zlK={=z=o0QtT{Re!MfFmOo$kCz!|ShK#abt1I#&ANByy0uZQFH8r1nzSQES$<G!vi
zf>p&*|Avk(*won#>q;GPc6T2{Sa=H0F<Py{V6_ZGwJH!GhK$va+=(e(qiP4a5EEm_
z`0!NIxV^6cmC3joi!z4;eY|!sielaiarM_9x_93QuMTz>OKe3{h)3ee{^1&wyMqXN
zJ4<l~uTK8qrPt<Dl;%P3c_s4&%||57fYiPpXj6pxH}whn(SLJ}n>R1A<N*tRJeoX8
zp28FtyB$~&eW7_=zc(LXMZ%C(6^cbTdf*^zM3!|7(W#L3u3$|!<#)A%m{y1^tAtww
zY=}KDT&=*7@-%#Z_&5~90QyjEMD_)15WM<v8vzYAcgbL>l{hX;#x(@97`N*i2?(nQ
zYzS6#mhA~k69lG=3&zR}(QTYp>F}6f!Q^DE#-{3Zj!f`S0r-?)oJ~$u%BY9#d*_2+
zokX^WZDL2K>+vD{6-0L!QN_dK)!LCD6wnt%EM(#2aHT#O7h}Gf(On2?1J!ssL|wQa
z%XgJJ;*oN>{>iIemb1DHp=TGL`(Fe(V}qibmNK$apZK4cpH>j35J*$=(Z;!wB@b9A
z@4!TUEA7CFeyGo5`mOl_E0WGa0FzZbIf6?(a0L3#KO2T8#*hiA=IXA=U}j!oDsO<g
zWI$jT$a)BOCXt1WA*0$iHIdv5ItQwg&>IzCHG<gsj!sxx>O}D9g#Zx>*%~sj3JhTy
zsa2pHCqyYg?CYZA5HoC^=n?c6PbxU4bDxjfqE@f71UF@v9bS#eEXJysvrK3@A!^j5
zGFCCdITK?wjurAzJm+C7Q6CEs-hdAmczrLcF%cIcHZe6hTCLX){@8c#toBDm=m~;&
zxF(Jc^ZL}PLcsdMVmt+W<WP-QJFxWHr~^T+Q2Vosu3UBukL+3qLcawPtbPcxqdw5%
z@IkfxvAJ&BT*{IKEM>F$Uzq-1AOeytM?sDRer&#-K_du}#xouuu<YHx53XFb3aTr6
zV7gMqr-=C=rB%c9_6&sZC1GLAFI3?%l&diuE>FRu!#rVB9jH#OMAo+!L5x(&^_b4@
zU6GU}b#e@Wk5ozmvoaSzDkvvxB9OGFqbA~4(Lu;0lJBBRC<Lx^i^a56b2t+r-2|RT
zVl+#@cDPET5CTz;O|v?SkJoE#kRjU>VhB$%J;CWfxsJ^_+9CK@6f!cjiRmgF`-unc
z9>CixI+3asgK%=XUf*98yxb9n3{_`QkNKf;TpP!)up%l!#GyJ=uaAp>BNOaEW*YKx
zTrVGwgL-c%;Q#lMYnH^IgkoAWm52PbXjE`rMs^CN^jDal7J~hgrRo&DBmqmU4@d^~
znb@p|3e&Wl|5%9FRb$oKKJ3KPj0K%M2;r$GpM(ppy$1FZGZLy7YjAS0rWshdAeKI!
z20JGYeMES^NU<>jEn-xI2%680jV3_VfyY*$I=K$PYa^yDo!xNhid6}-ny6P1@TTEd
zWg12h#A=);Koij*f;x!;EO}~Sw-Z3p209CDjb)O&0$)6=2b}zjv1EEmOjsuLZDO3p
z6{?&-58(}29+AHZL8Gl4sh^m_tZ@Z*)_IL?^9Yt2N2Z4iw1!%GFc~wkmkAbQ9c&aC
z8<NWdy-*uw6*loJ58rp7zyz|x;CK{<WAy;WK62?x7v+lF1U%Ru{sv@-Zem<#Wn`xp
zJGn+gYK5L97t3u)0v6a%#_hl=8BxI>=3nN%NzJ8PD^FnOsZ+NtL?H}MPQlc^1JHBU
z7MQG5El{OErYXZ>&i?c#Yf+}jK4NyH@<pLOuSnFxqX<X`rYB&smarXIhw9_mJ-u-8
ziq){KZx!^HHX$>r!QP1p*gZL#ur?YDAi701tRVS0m}Fz1!HTNl2EGK*E1??8K!TZ2
z$29yg1y)o_f|j`f65vF@gdUs_6uGmQlue2yV7ijFV+6H&qCUeJ0h861u|h`fBut*G
zObir(Ejf-k@CvF(>;`KPl(F0ZtJM$UrR{j%!}mXfD)>$jiQOOCcKy*4dI;uN6!3f;
zL5R#Ae+Jq9hx8*+-yyTehvuPqvnoppu#^Y;Yd{(s+XdaDHx8+cpP%b?Wl4y72#;kK
zM)d}IJ3C?T!2#H|c@qp{_bR$HsF}1<4Vy8otbJ)fH2W0WQS7C}LMRo(WXCju(IbOL
z;i2P4l2OUk#SS<JRmZJ8eQ;S{KfGksI+#Y5a}1dpB?7!@Wyt3WZ~|s8Lb&ZnR6*hF
zu&hhFerNy_f*U5Mu`2;U;i}Y%&n3GPlv6k^w{`6r{DiQ1oMw>@TEcysq!KL7CfyJL
zzK+*1idyG!<a7If{n7g$#_x|7SoCbj@ue8?;SX-Rb}^`t^sG}Kp=h{Si(XLQ`2hB(
zC-L*HrQ{L6qyP)$C7Av<v|l!fz=}d|{O3Z4-3YOx*JHaZA$5#00>Q}cy|Dh0^Wpg9
zL}Ght30UpySTnJEHDz8_9Tn+H6ta-Y7qLQ;mq6$^GOA<KlknitLx~zmDkP0Uo{OsE
zMF?Uq?Oz9|fF<Dd!uSXrMKzMtN$L&cZc$JJ4X#S)l1pHQT*>VQl;uiI3=Du#yO?nW
zk^Cx9pv4U95-!r&x)Jb*QnBP-1ooiwp>9<agIJB9t8w@Fs99c*=NJ(pJ`x7-U{n`h
z{f)=J`_(_)e)WR-I?)Iqg3y2BCatMSs$UjpQ6Hkd^fMr%pDqbm5`d*vwV{d3{|N0D
zrzEdnVpg{)zm)}*LKs4YIha9De-y!U`}V<2XPyCLg$Q^(b_~=?W&&X8Lahw=4eFw6
z4%fh?*p3hh`>;$$9uE{y2xXC?{i6s>g9u^|9vw*X_C*C)j{tUd-wN2)zZO=m-jD#;
zP_+z)5WMzIjw688pf2L%bi}^G)M%-2JZkN3k>HKI43+>4bJ>z+TOb?F6;N>nTH0<P
z)b%8)sv0(6T&t<_nk6HYYARC>aze;+3DYpviO|`}1>YD8c6p7#JA!)so9}=0f!j+E
z+!++u!4F(|b-noyIJZJCXzVZl7dH=pbR5m<FBf6@56u5g{Jdu=tje<_01Kp7FHL0L
z)FvN=oh8HL9g6|1NJ<D!iQ|hy7N{SD2vmD_?1YV%Z-X7xQ6NutPiDfLvedmaNJ-tw
zR&TB2&JJPzfzj5iu^bdoB%54*64UAp3rVN0@)&lH4#V!TA^7Hjz0i%<zNxzh&O!$E
zqP~@I<>s>>#)}`Ao`RiYqi`76+DNS`ZD0soK{61bn=6dQmw=18M(3goyJD*Cfy2u5
z^$P=XLaBfrqf}tT6ch`md`ohxS(+XjU<h6eUV|rjafR_Whl2gZZ$0zfum90SS1-sj
zNY6fk5G_4N)Sd>M&dtb96Q(Jm$&bSv&-$1RS@eLVhG9u3ZwFQsKj;JaWBte6w`%6n
zRfyP#wHhm+K=lY!#ew6;;QYyHqG57CzZpP@)MqP()e6vz-qi}M^d|@Ho<Ig|%ebW4
zrR&fgUKeHDHkRO`s7DUT28Lkt%+PW8-r<A5IfpGhE8vnf>)<8pH^W<BbWY+3`~Bf#
z@Wk+O*n_I^M708?AOxBZncNKJ8o>eyHc2ydTbN`%fx1u$Idl!o2Q_u0bejZoflAlo
zFgxc5P-ZT5Pb}b>o2Xcq;++BBiZ#gAZsCGmQmk=WiD|)no|Gws*c16_ks&@St`_yJ
zk6_-nV!563(!i6HMGaVZ18F`KIlNujCMzwW^rx`E2KHtmI85NPU2~K#)9K0EeCKmJ
z;KrBT0QVg}03BLAYGyQVs2CbSt(h?YxJcQqwAyFE3M|{wc_@owR6?nYN!R6E0hb;H
zwB<BF7O+#VDt08_hml!*ZTAlN=ANCfy0Z(;MAmiH#?A0DR2^TrE`q^Y1@<HB+BrUw
zIKZk?LKHIy<p88?jjG=eFTp_>rVNl8(DFYV)f^0XX?7(?C0Q~%!C*8reu85Y(`u><
zl32?bbzmR(?I#}^DG2_BTen@akZhm&#A=ZJs3#-e6`1}2``o)1+U}brix#ldh#)P2
zM5}~knVw1GqDi5jT8xXC4o*%C#6r+)d50lNbcm2iyl`j$wjVqUn^*S1k?}F(E7ejO
z$wT(t@c_yx15Wo+d6HS!26P-dmT<tz0GI?R2~Nt5A#pGT11Pdi#nSLk5wERSC?y%j
zXiCx4Bs_j(AaP{f*wX_StX>CauU-pRopDYQ^JmxiXkxrSmKg8riR(lm3=}{#-WaC1
zjy}l11rd8c5~gI;IYU4_o0V05ZGFN5mASW4XSFv}ohSyep7Hp%SrF(&Ocq3_PhemA
z6mDLE>Fv<kBc57MeeK)i*R@zj4i_z8fn42&7L3U9Vy8)+e~;;di`5CPT&t2Dq0W>F
zqcjus+%t$uMfl>q--KIU|9TjT3fT8sJSV!}G_y^$63?6?oPEM$Q5Ili9<JyX(?I30
zCMK*+OPG8z4>#cG<P)w<Ozx*mvVDaLoa49-`-X?%*&|0F#_K2cwRKfLY+JtxUbA)s
z6!9J%s+3V}9EW`qW72hkNsARtKMIURo+kqXpqP^IP|1!O(mu{4ylGE+V{A|I2MzYa
z2DX*_u||L9u{qf`ydT?;MgP$U9{={y-`jrOtObTVQBi9ll5Lk>?*9+8b_t@s_WLT|
zKg?6}PDmCdV5xNjKLG7lxA|9)(+n2vO1On6f?6Cq%tP+i_&|(`bjHIwcf-c>&w~9E
zqyETQGhk}Ru(V^Q<_JPraa_-OkXoM4psdPh`l|yt8icqrq9{MKYAF9Cpv1MEOXg#$
zE-r*Q9~1t*u81DT5GE1hpEz_7p2So__O-sJ53W4pOt^U6I=E@=Mi}FDcy4qEo*f;A
z@p?4@3mUWtjB#DILpXj~u78%kK24D1OGF;Cz+_-Zf-x}H@ga5V?Rku93Hl!M?bR^)
z<qtmj;BWlSrPmyT1rq8b*suNsH~T>b3uq<O=g3Fvsl~Xg-J%05wIVZ7=oM|UQizzJ
z!JE1u!^bm~2>->TAUH;ES7>)HGKyz+?}FD~a6UX+kD;&7#Fmw0ZnCd=tzf~*f`iMf
zxC2zWjO(&s*pUJoU8Mvo<qriZu+j`l2*<Fm+QD^Q7O^F$38$QF1^H~TAWXiKv3~!^
zAUrX!KLMn(R<D5@&OQ%bcFy_m22>p%9Xtx(J9-EXlqVClvo9*jIhp|Gdi0fPHP2PL
z?F1tC{%Q|<@bdd$Wz|NjdOA9$Efd9D{6rYBJAV7Q$8P__3odK^Ak2fPxrgL;MWB@x
znubOW@5H<pEw&Y=7ZqUP4I)Q3T0XuVSly55*2NB1Bs3BRu>(NDe3)GX0@Yd#4)59x
z=bXI-4vmdAw`H{&33SC$ofJq4bIcgU-Mreu?ShplDlGf*MjN%AOM#IAIRNbf;nf2+
zpNuic4bWK?(*aa<ZUP`u6RFI>p&|H}<KKom9)A=r*|-_5I%6xme!~{1Ai5kZPa*3X
zO6EJpiJFJtM-zq&`$^fRTu*n+#F$kRT{yC!WhM|gBZkgz(d0M6!==eOe`SeJegnS_
zHRhN<p+1BC>{gIVh+UtNmHOaEG4C%eCJkm$0T#%$*xCgpqnk&=w2#ewb531~5rgTP
zqXGf=9T;SnU||5?-|;-W`hxS|NI0SNwG%v9Gq4i=F^yHs*)N=SxB!x<fQkia#>BLW
z=mDP#LcR*<f>(l1NtN6HlLp6z@1WY@sGU@2X8|8s5hVcsy*)eO;k~<{yI6t?)^C8z
zP;GqO<}FY|HIh`uonyl=TCYI?5v#~TMUfnP6F96%>xf!)bWQdyadK!Dy=aX6%-(r<
zZv(R<$rm%YR)oQsu)u(&g!&Hkp-(`zH$3&lhgIH1A&UaAlqdVmn8<e}YmVR`CYojb
z#rbI0Y)DV32$Pix_Jx|+XYD3>D4lFsAq-AU!N{&XuxZPBI5_Uuva-Ze6E#@5Up14G
zsv9vW*Mps_<Ho?QfrDF+k^sj&CX|o~1vG-E08Qw6g$03RKex<IGcN;P7T}lzRJsn&
z@Q>TlXdfn7s?{nyj4Jhg&prbyk%^tRVIy37&bjb|$h@ji2s<W5VeiBkOx5H>?I@Y3
z?E;OwiP}XW(6`LHz0I~*!|m6DhW>P)<aVA}XCX0~1v9>D!Tv)J;}<Dn1AhJ<NVkV(
zLaX$A5c55RpWj#vp74tTuu!&Qx)s__X#O-vuiPagT|q=|VP@XoU>|t%pffpi*wfJg
zkMGz4uRQBac&dIJ)*y3e`-E8Qxbu-N#f?hm+3OWHStZHR4n6WG3}EOo7J#hXNft8p
zE5)WX+t9Wu#x>w+RZyMP0jC7OxdUnr+tP`f@2au5P5xd{sUu-tk0I-NV()I~D|Ny}
zn>WLa7jJ{hHgAPdJns{OM`2)UB8g5xPO6SiuO3V^3@b}g9L#L#IgI*#I%fPH+`RZV
zAGt61lPhmnECC0pFKxy2>lt~dPu_~@T_8g>EvPIOz@n9IZfcX~E=(U;YQgj;tHF4U
z3)N=VdS$oVQK!N2F{m6q3Ky?m4|@lXCq7D^H0wucM&)h`?ij%B`L)f;s5}N3xFKbp
z&B_H2aKTC$;I%qv7@YzrlSi|p6mxP}Ab}CLwl5DDQ|)0~_Ia)i_sJKsS&^%Q^n{r%
zm*L*0pN6|0eFQGtat6Hq%B$clmu!boY|mHryZ{FfxQYl`W?GcGMT|Kra|1M~wmXxl
zrMjp*=aZO*OzpEiEcmw=$Na4Bu1=bCJlW(|oOhwVgzSj|TV4t>3Q8-XzDXgS{@1)T
zEJGF?u<(Y_je2jJY(%4f6L0W=d1%tC%HfIQ6Ez+m3B1AXMh@ie|Nb-2z*{bQ3w&y1
zSauZFqJZ!>3<N1hP6IZHWnY_{T~?%37uQ$Hx*KR)lw>t&AWFGAsH+p&e?#XnwyEZ7
zo(EjQWofDJ&UrvMbqnkBB@bzUmO$E7jG!~>fxU+h!JmKe3vk=F?}Mw)y8v#ybUX0X
z_);iO!ajUSOx0`2=wy`KKi8?jVNalq_RbU?qfRmfUc&P&mA7BzVX(eh=Va_&6o5rS
zeM+r+xE7?hdn@^6%tvbBf;qvGEGS^%4Y(Mj;V)}NTN+mVquE@Mc|N5Y$7HI~5$#fJ
z$n6MH3WW%sKXM30_w0oW`q#j7$B!ioOtjWe6j-@TMZekg(G>I2z{!LURF)t~W@f<3
zDQ{SlZog(m^o4V?Pq=^t{>Y?ZO2XEq8Iy6PP@h`;Gxjo52e-hf>ox$&6~Jm&0|8xy
zBH8L;Xmk|5{M`rPTaP~m7oT}1TzAPfc<rV$;5e_r!+75*E`AB`cVt50IKEcicP$P-
zcIO)UKeK#i0Q83S%;_-;B5JW#nk4<_(0a}x_0dld!NB}a&tL0&SunuD3#X|ne+km(
zqm@utTABlO$GkLZ4y1!tN2QJzTUwLGE!!0!nRr|(7U3W7x)XltZEu6Ug#zM0t6360
z2$^|-NuAt+fveW3{KjsjwvAJ0veN+%djcOIz-2$Ks-{86aaqt{!d-w=`?)af<6MIz
zH-2L7Idp!#-;PRxZ$H!d^j&h)*#w9J0o7^^9z=EV9#j`Mtm=oCUU(6_{KYSUD&G6u
zlVfmrY8)tld?8TQMn?@~I%=x#Z>8>mo%SPrAsjVah&7!N-+-IXwfI37QmBtnOn3@3
z&}tPPie&ni*mr*tL2F>%TIR??GOVA(bZwhFwAkrq7fYy^laT@|LS59LmBW}GnX=KA
zL=wqiaAE|GAj{ggaW(88AC<%Bt~iM2z=|2Y(}XDvR>pZ#Gab;Nroqbv8u08%hA<gb
zE_E?H1z_eJsqK^(ysJ72!@wl#vh{%iH@Pnf+~=@0*EK={n{$(l3JUf+N-+$f*wq6Q
zlT+}OhrSCBJpB~B`1}jurpvE@ZJV|xql-I61`*^SnFnd^u>KGVyv#2NkoIXvv9oZ3
zi>xKN7EDw~8k&>)W=yZj$Vz>dR;v1wd1+Wm76h=IRhqMwlivd}T+EVO-9rm2gutqG
zPc^Xc;(luN1(Kf7-`fWdKl3!a_PjU1)5FJ;=$^jlS~N2gesv0jq%LASr#!IIfF{gw
zZX<r`{2Dxj(2fxv7-^uf26h`&%J-*ImFjbG%bq}JLp#W&#6YQt>Ksf15a-5Sf@%LS
zuD$N<b%3K@y7yGK#l3q}G7Kn1P^nbl%isAn+<xyj;gwfj1wZww*TMy7UjX0Ow+BY5
zW#~n=>rKxw*rl157mcg&_hqcB6T;26?tHj#>p54|8nQ01s0A%P05X2o))v{Q&;AbP
z``d*W0GoHfQXyjqtg>`@`jtP4>HG82s5um}KUGb*66Y<?w4F(@E9Lf}cN3#JHaY_0
z_%N*L?50W7b_uUE*2xN0eNJ2}qvL6n1x!H$cS2*DFd1AR(M-r?O}a7<EFA_V6bNc?
zGd3n&pEDBZ8sa@>1(rQgex9tEs96=a=P;@)H!RF;2Xn3=eItx&OMlg^?d$9U(Ft(h
z6OY5AJD!I(y!1M_di!NiUbPxtK*lwWpyn>6W~b+XMKXO;)uja{y9h<VS0+)h<;4BP
zDAebu@7)TmEvID9`d#eHzcb&VXcmHD(ZuE-Ym<ju7(TWb!^NDakZ1OEEik`4bNh|8
zZFsH?dLKpbeCnBJVEYZ%zypW&V@C<0v9vX?d%VGT`Ur6CTUM<DrD8dyG;lcW@JH?R
zpY({Ij_}}*PBNiQPIf}H1uhpz+z~&`{$ych>|PrDED-rX+I-t%lFl{gZOwR106zsr
zeVv_9N07YzzHh<TAAJ~Z*mfCQkF2Y<ay2}9^iZ<YnWrY2TA6jSb3lu!`$4Pp#G>6Y
znhPf?91R5?ybjZAGqO@2{t~8d%tyPl%qw82^#o~gh^%FZXrACN;Eg*nKdqWu=_{6C
zqFiBmBv5u9wE;3prgd9z{ikVKPXWI3{Il?$YhD69#SW;}YgQdgatPA_O-B@36|{`T
zf)6<0qw8^826TS6<Ld=cwdyAX7%WskVkShZe40^lrwq7t(q8Tw)K&Y8!CrzNedjz?
zRvpv(wF;@M^d2Z0wr9?v7@WO<My=C8BYy^oHX(V%N2n@RtMG;U?}aZv_yF8+>2`SC
zO*a9p?z$Hl7lB&DtQ)ZTYu*apI3iN3aKrjSk?dHD)-FqZ5Busb;O0L=>-mP%hd+e*
zUNxVgo#vZik$!wt#&H6vkKzs3Ge6Cld+CgdA`F;o0&WmJMaO&x`H+)ZNXpT^U3=g~
zXKsS0hmOg&dV^n<95ffkf5_>Ox|2E`NHZDRCI^CqEi2ce7hdPH9bYpnRi7&Bsg9s2
zmMy2*60=2<EoK4&YBmN2lq9g3iHMdxDWklr!s<~(cf`=f@JfGzqx9%eKb9EMlNJUR
zglHB5t$=;+laIqQ`}e_XuD%9tyy6OYfns!x4MRr|s{85umMMmn><VB#4<K!jTy#Qx
z5W$E75s*D=eT!_=muY&>ugq7w<_)m$;%|WV7e+&?Uz>;K%$tmsMP<4cA2r4)>sk)x
z-L7BAE~u!dy}P3m9)0#1c+<rf!u^N$Criuw8ld;Z@zA!1TtkGX$~pPmUDm#os-E^K
zhawGn+7NF-#Tf2qfzBT_l<KO`Y)FHZQT4d=`Q+RKE8zf<1SaRWnfl|_<AW8qRM7!*
z$Ev6d<`f<ogaj=>WT8=8L30m<3OZOQ!1&Z8eC&&#hp&C_d+@72`c~Mu=?r+_z`i7&
zmmcWQteK_WE_K0!a=q5lt8S4A^+oEF?{0CNuH(Jfw`o=N`{tuT^8#3SK@@-IeQmN)
z6o$WE>Z5{b*)h7m9Msw2Kt~)+I*d^cAq_ZbdlU&7-)qN*;QUpq;n?H^6j<mTmt_oR
zF*Y#`Lhi(7_lz!ka-B$%+B6d}3X`K&fvwMDQ~L7Eb%Je=3pOB}JPrdh+X~2Bb<VIX
zkl~qya6pXPyxcM|-9}f%H7cR=3nbf2qD*oM1}df&A#)&EohG(eh*tMmzj7rE3?GME
zKm8BzhL>IoFTVV8*fTW_W0i`G3}Jo|fBq&_74t<O6)6!lYWUZ<`6kGY>hM0y_cZ38
z^GFo)#jsuuG8#iGp)kS}J#@*B3Z`YeR)an$Io!o|m<G+Rg;e7ho__9GxaGC4fsa4=
z2t<($QK!Wkm+f0!c(wbT)F)?d&a}D+j*0~a1sT_hq%d9E1vB%((*p{Q&B~mcfP_1S
zbO(SG*y*s%u1csQJtVd+hf#^-yB#&OVC-Ipu)Yb&hgvR-5(1KhDytqE7Y((_4i)P`
z_DgEw=kC83b{{zcZ+zLyU}{wl>>3_QMu*7;#sqkPMMdi#4PNv@eUkbn%_VH5%HE9W
z6`1~Wt{XGwfQ86Q?hE9to)wgj=;Z%FgkCJO*k?_8f=+yJ>rk)zZ**gDS14e?%eQBd
zP?+ThP%V7jwb#SB$g=j24kytGtZ`SWYTn48!VZ^BSXD{0Ez7X{2&9b+2y88OWKmcU
zFjys;?HAs;4YSjZrrOSBY*ye!Beh{^oPFHZp+_haqdoWYlbUG4GP_JrUy(r+wO|;t
z3@-^CXi(aEwp-RD<I)$R4tQ+WPIzL^E_m~GH^TO9m%^Uu38++S$_2vy>JbDRIz%CB
zD%zqF>XX=q$@`tA(Y>NYHtO57;?7s*dSrh-7#6L>abcT06!3okJhWxrg_VjB)Tk52
zO;rSdG|MuB<3@sj!T4kuzV-0;VB6JK!M@R9TapRmP2k(W+&V0)aT%VkBI*o!q|U8J
zhg7!7s*6??wM?s7d+a$a33J$%aBEc1oti6Xr{<{psK8Hqzx&{3=Nf`?F4f-gF1t$9
zzl2q(`%aU@1Jw$e$m~wR5lU5d+~M@qcN9xNk^BGszHh;^0|($OFMlN*C<QQ8DH|0r
zDZ`*YF0ds7SW2jGQXg#vSR~ZP-wJcQc*UFomWt2*(`~ZRbbx<dtjh|Ws<3WU4Tb{C
za7?$hkGpYZNa<o0NEmc?cEXpx_g(m{7hjc3<gF(z4)(Y|3aCG{Uz5`wA<xKMXlbUQ
z7^AUm2UBXMaLX7#(aZ$ELp)<Y1H;U;QQxX+mJxyL;SS)`=hS7Gp=f!28_!EcZ$R)0
zgj5xE`va!pyff_zVqYne7dg?|HK8^5rSsT(O+grYx(e{*-aRmI+rPu_{M5VPX{>Xy
zT!umrsQfe)K3*zD_e4}!Wl{?%0_l%uWc_K(_uq3F2Y#*@7KM(<S_E|$rVpL2U`5g&
z1~3sca}-ST5vx`i`&81ABur3j_=)K$IJoZsY+2a@J4c6{_0O6!8NXLF2JbTimg?Nv
zsBF|J0bbQf=XKdtGoW+%n!yhTXuNvd>vi&juzwvj)xA%49-+QAYnw8*F|YkD*b1;Q
zU>qMRZNmZ!OlGlGmA3(D9JdI4bu_X&JT(O$LC|{hjW2`FzFru@-;O#P5ky*)WT^@D
zQ3Rt8fpq*nyG1tY>(u8zJy-3RGr&>{p}q%NFWg8j{hwK?VPj@0#h?ocQB@8rkZ6mo
zuRJwCj#*kAY`Imveel?`&%iaWenk>Fvp0&sEY0rde6FhEep<F;d$MqVz*QUlV}9F&
z0}vveJB=?*YH6@J3rnI5XgY1Tbt^`t&aVr*EGKnxe-seZv}DDs5<e?rY<C-|_?1R1
zCc#X%C(w2&^XYENin>Z2aA;%%K6&R?;D@fg4mP~#3^+D93F)78DTxY0^BIsM{+&&-
zP+xx!=K1HjA|Z1ESSm(41+IT_Mz#k)#=<(SrL)upm5>&GZayYx!2}eeYOF(p19`r`
zaBx4ord)&GVi7e9Wfv1^_9VZ%vD@W`wKvIK{>fYez1u?9sLmX4NwXevEsD!92YAf+
z4B)tT04!3OlQU_LYHScV1<YZsrX@B#!8Fc*AW-7MsD2hw{5%OD1%Xoi<Z|`o<tbQT
zfhcfB5}C`$^gf4{0ok>R5Mz5j{`I@y=1aE2RhL}`6ZIMeqHh-pd@&34S@M2wWzV8M
z|7VB+@0*Jl@N>nmDCFwTx5-0p{|D#j{EJ2?#Bm|;m-%Xd3cugCG|E${a;*k?cJGFZ
z&fWswKQbU~BZ664k}Bt##aQaqo~WBmz^;{;=DP&Z3A^m7b{4pl_q_*3>R6*D>oz2_
z9nHRJKYzW;*aicp+LQul1z<rkdw{7W>?Lq%dzHkgz=E2}7cdJ_fiA0nODHf)?m3q2
z@9Bewcf9~nu>e<Gx@~2(R&C`uz7&M|EcM+i13dNpPhxs<wog9mfTh?K%|pr>33&q3
zZA)QY!BdrPR)Wc};F)POqf-6F9%v%cAIVef;F0H_gEw5h9Ueb&C}n4A)HOW2P6Npk
zT15f3DPC56%+=LAT~j#V<y0;jHoUs+NmNB9D4s=adrF<hX`vdyGXoXC%z_f`En&(9
zR4)!;37leDiWLd120Gv+8I=SpFklrJVA3p0f|&*>X4|5{4UZRs0^I-f)3C08b!o$z
zHN6ctWr>I~z~6?OzlLdBi)_^Qe-ZP&XSP|^TrezRS6S#wlRn9ne{2rUz32qBIP%4*
zH#067!*>%&t7ZC=e6n^PJ_OyBD)g30FkP*-Ea@>K(~ISXhoEWGk7y(~BE^t2P^L)|
zYbfZpCUs>lA~v8Yvu$@4H`Q(DjM+s`L2)@|qkSgYq%*sK3Fe=LSrsw)8(8+FnG;j0
zp=Ms-uq@a9C0U(vg%4Q5$mCiS%wR0-D<H#qWXJPxetBLavdp?r-=*m|xOpD5j%i02
zKv?j^Y@T~A0E<FWoRe{UC#KKO!Fd;@Oqa)MW98Z*e3}WgBIY89?(iAvk1w(_lo6y3
z9~^+qD|+GS%26olb%|Bo4PoSjW9Je&hxWk|Zgcc$z}angI???+AcRKXvZP3XhJ#lc
zw`CTsGHSBrpGWSJ=q^X>m~ES3Ng(GR23iHyzEl9(!kt!it)X3m4tPw;1+PGPze599
z1y+q@+NUc>j%&40vobmty=+FOr{MX4fmZLSr6kmcDa6brEshfg(1_vU1uR6}K9Fmi
zWf>L!3e!`wdEUh=ckX|*zOlOI7(Ss@X70BG1A-ao(BcxYCXuqBr?V3tdh!W)`Ri_h
z?;Jh=Yl{9$&MJ@1fzanME%4ISLJfHMEC0A<je6zn_piwwbd5|x0)SBJF9W4=x!g;b
zQNE;v1}5APDr~Z>!=1KcELc|kPG6q}Do2GgKxXVzfr-t|T+q__$%d%ZLcI#Kw0#8*
zI|HkF(z>s;>gk|eP#>ng{MRjx69)V`V#43grZzR(4C{^1dese*$1#2Bbew|IO6qY9
zAKU^yx%G7aH`72E^FhPQ1J*L7_eWs}`wkz56*0i7QU{(x$e2tHf>_Yf^)&D$w-HSk
zRa%4(I_^n?t|#@gYG&kR)${W-ky6k~SP*O1R23~j1Ek|^?q3rqKZU>mWRQTHX0O69
zGVi(!xne5hu?8#f)WP(&VN4378d;dKajBwaLbYSpDumJ3Ll({|>sSa;Q+6nTAK9z7
zx5!2d%@8L1^K6}W)&NV*8O-v6CHd>6xVGS_NHI7QLOumG#|ETvMQTdEZA+65EB2u4
zXEafsh9Ly4t2dqj_w3mTeH8OOWhQG@OIl?VE=5Y|btxqZKm{8V+EL#z#Az+goF`SE
z3pCn>ByCe}8<=Hr!YZzsTzMew;FyN!<oryT*@eC0G<usdjG0euuuoVKSb%~Qa0!Qj
zaeWzq-X9ny6+3r32os<h=_wSxx}s3H^{#in_p}%tS8Ey)!}{BdY(I{9K0jM?3}=&J
zk(cY`8OOg3avILEk`jbTIG8edHyhgw^S2w&A!RE{saBL|Nvy|T*a1Iy*_+|MeY=fK
z%CebekOd(9lq_SD{z+;&Op|6AQL3B)O~nrV<~OmQDfH5eiYZl(DQ|PB1~SVwRbJr$
zj003OU|J&z6$HszU{jz_G?YwL#IYFTf>$(~Gc8l<rVHv!jSK>_-vzVwrzBoOz*HbV
z1RiOmGHwo1?X%?|S<Hf19`fBN5J4CY1OYo#3JNcjBKByZRC@TXpZdi)o3^q*LVcQ6
z(Ydb0al!-&^!Lr#IN59h*6X0PI!F)J?aO6k&=sC6gO0a3mX5!MRVhiUZd$uCU))Zo
zw*(E9hw#+iJ@78hV10KF3{Fj{2o9D>=}MRa8-q#)7BoWH?wuA{)Mrw5^v#7Rp^Vo~
zTb=W2)+JBpjQA<TIRUU$Arl1Q2mrN6z$k*o2*lzDs>0*EUfYK%Rkc_sR?5}#PApX^
z6$-4USRkLb`q0?ezR^l~iUkG*llH{aGK!<c{d-P)j6$sI7+47yfh0?kErkgXaeVOv
zu~hd0`b|UWzeQf4^+XK~6W|Z=0!vX5db>&-qUboDa;l?LoGf;BPJihwKY7}jLez-i
z?I3}v*{l}Agj--S0Twoxf_wceK+|WQglt#0&&Iiynsl9k>cDPi5sGH2lId7>Bu|2i
z@G`sHg+`nPjvs?3o_Y$d+OQe!-1WS!ttkkCceJrSx18TZ<~y7k@Y1m8P9L&ou@xBr
zk}4E{oP^B4*q5-X3aU&Kh%rMUu)T-{k4G%nh1-XsQgI-t#e<>{4t5A${px$(zvLGt
zISqyS_77uvX_I60lm9G*s6lW$cB&_uErvy*k5^|L|1UUA!^gCfbBY2+X!3L1%CZEG
zvD(dJnTh*ac7cfA@b`TG5qQI!e<+C*pzSt|>Y%m*>GLU=aTg(UfkrrO@FGZPc+zMT
z`z>X@dqVO-OoeN;%)L4$qA(aQ7J{dufIS>S_!u&$9TCIlgoz;}Gt=vOdTXD5`_G+r
ztmHHl>f6-En*kOHVZ(btF7J0ra>{_ETp8ZqCL4vENP9Rg3t^%JQOM;gbjHvQP2Cxs
zQjXEsKkk0(>gY(;&ij#S4f;wQFj1K{Cotz>a!#IxGFdxsv`K+O^bB}OgwcQ`-3u&B
z6wpMu)qtnXLqa)usyOa)q%0ijDirSR?kIhwR4Cpl>f!!7-}&y-e%8b3D%7_rtPF1c
zK}NRsW1bJ6>Iyrv!LW!5W~~D9HEiU=vv8iJDZv(GLeChxlx0Y+&By{%qYbMW?~+2%
zF2^P&;PBxiu%)LLo-9)c6S>lkubVRue0W;vQ?@6g=~=TDSfjKPjlo#<t$HYNO4+%{
zE@T2=DHnwRY8^pgM==b(+Sl3fWnj@0^%@-c%G-Z#>BU;fr9r5VBOuYD6|ZcOg)rhR
zAm<pKw44%PVFPK-(Cag@kg@%aQ#r>{mr@~udL(bN0i#BZ&DgD^=GHhWsK2C(c64;Y
z&b@o!tShg8?;RO{o-p!8!c6t9mPha-EMsyj724fE)!`qP;3aWP&*jsGa!|&2dmS9)
zT)zSfj+esdzk3RWj~Bzj6L-Jk=TEDJMshJief?T!9a8EC)CxN%ZHGKnhDELntrl7&
zc@EQ;Pw^Z}T4?mU6oufDCI&8`q){kkkr$1-?X((zzV2>#@`V@Ry6di2v7R&_3BNq(
zkiTi0lVgfE>Kt<#YQYFVq<}BELfjiWEwcHL0giSS3SaFD!@oh?zW>g*|I(seJT#YC
z5$fyY;&4Ta<JYNU_nzztP8G1I0a>9k?!mP86wk4wr2`765*Dpvq6a)u(j$5<Bl46*
zW<S6wJ2*B9@#GZrBiov&Rv=Py*EEaLE(MbOD7a#lWf_&vZIIR?Rl99?XAN$uo&?|s
zwB#6|Tp5}{6b6ToQT<JCSp0{ev*XZLe&ijw@%;1`>g&|!TLBhf1!2a50T#L42N}oj
zLi$%Z#d9oaAvd0mLTE6iK~*yuwc$wTlF4%~@V?s`X?2#vhYrEk{#EeUkwXYrHorwH
zZ4^(9`X#%Bv^ym}m>Lxg!Wn>anVo5SG788N(4x^!st*CP-d8BzS}b+`<6Uq2>6}$9
z6QRD2D&Jio=My&*dRhoG{`6$eangW=4WoHNS7&5-P^D!ppMAxv#gBjLuc|^=?*xC|
zpjM%@wOhFWr1GV~%UuaD<{X~iw+Ajb=O%dK=wX8<!l~cX>7b<El=(F4($P5`htrf1
zOnappgS-M;nn#DQH`W<Ne_vSH^-uS_>0LQkEkDuy{+brYuO{q3a2q(8%1?!1y{=7p
ziq}4J3iY2ha(Hs;DCc|>J9>}xMX~^7>6dS8cYUg)lckB2XGiQnj`Hm|cmQ5r>PjX?
zOM=vx$9ShR%aer4tJOK-@;Gg$a#ceR*4teTCmLTX-0mzCzStQCfANhsy=!R)eahve
zg!;US``!w$2s3D)?&Bv@|49KBHi#l7zBwbyV{nSYm#32)7@L?17)<+YM|XJ1aa=C~
zYp$|u^~plUQOX+e1$n)PaNx*M2&XHss-p{rr>BzRfp&4wBYDcMWf!v2=S>htO_LD@
zpo~`o2cuHznCG+{mzjz~hXN+L!{WDA6r&H^{nnpZ)^^KWlD_|LOqaDd{zHf%|Ayc;
zexenhEW@JUT<2#TzkjY*fL&5TtcT{Yf%T7aJq7%@=qVp5aDmLXU};+t1(KVtRA6xM
zIBe+dhNDvxP-H4_if6vkt_;>5Wme}gpk|Hi4SrS{%#!v5hW!zq6@&2j`p(kFW0ox4
zmdi30>iY;t_d{#IBJ3ax`TmL4eX@Xc0j9HB92)}Zrk{%zHR{&PW5F4BOKr6h&*W_?
zBcRzwQAjU57rs+F0L5a-fRtOt^#c=TpRexeNS@lK%B&=#7qKzk^h_~15M5#P!0Nu9
z&wpwe#X8F+QwRgzhN-{FF<RG<R*IfCz<PN`S&DbH^Cas%Erph#;H)`2a=*(Bf5MKj
zLpf12wGGRKqK;At_6{6`S6sd=@rsh!JpEFQ2uha4wOfK2K?DHDVwQYk+ID7ru}s@E
zXaNN-2#&LWec@9%tIov=VE|!4Gr*z{CO2dH*AuPugaJ#fij%d-#3LXZnu`+TI-o7k
zHio*5OXXR|!H(P+X@X#SoKQoUv|}BCzA%EWLLr%!teq(gYf3&PNHsVq2ykptRvpxf
zEV$M*tqkfE2H`$n;rC|eZsl^C2w?zWL91w_uOcit(N%R$hGEg@;CUIx@4!Y(o<zN;
ztq58=r^>;>Dk<8at$dz@qq4R76`Lr8s$P~jkk-d1;herz@WR+IbOn)DK!cX`aJRA2
z<!GR0P12`I2iUW2TuOD+<y9jPET4c-9G<QFmCMo>!T<y$nyT}z7Fo!KMObn|Ght2!
zu-=(*jAmj#bP{!**1{s>B(<hTJVU%Mq6sp&PN&8UZfxWAdL51(I|dhRS_jXK4mv}L
zY67y*_+_0#btF!+U&!f1Ttz$A=S&!#VO};o4V5Vb!NFBgNAAXuOIipE2oqMcI8InH
zcYuY6N!rbuGO|1Xqd;80j>x+2MCx1)5{l5w+0%?iG8E<fsRQJ>u2!CHNsGI90~oN9
zKBOXv+PUx009<$3C2+^?=PU@hQ4_#%Ye<DD)~cpa4~^XmR76gFUUx(@@xa<$4SDV)
znu{ld1&A3Gyz|BuS;)Pi1M|)J**Q^$Me~44EsoJsoZB&)NT4Z-79kv4mfZ*7?rN?S
zGWDln!BUV6Xz$@e@S|P5&|N4%Jyv0dxn@|Y;C@EsQ*!{FMIekS2-eq1IQcbT;<d$C
zaw;yY%tr@vX(ogTH-O&*v{1+yitcdFOe;H4z`7yh7{zNp=}C>Jvru#yZk?u@FehJJ
zmrk?1PD)&y(|AZrq7NKD4#ipw{T*F!cye4W{}pH#1PxAlz)^861ww&dr~$yZF-X6y
zK(Q*WxtXUTb{C4Qvl!08oyz4j6vBj`f!1mvVan_Smhx`DHX{qEg3rvfzU3qoXfH66
ziG9)Y_1x8ueGdrVkd<~mb+>6+&he39ICkU+oYA)m1|}!0U#jB@VW#}3li9Uu>}T><
z#j9Z^hXgLO3>RS`{^`W?cCoBE@VP8wAxt1_*w*6swS+A*^?E-MhP4^fmW<<jFdaF8
z`j(9Za-}>EU=lIzQq~}zHA2|-JO~<-<w@AFe;;h#x+P&;dV)?uvzT)duxcWtKA9fM
zWD4xK1ug9`3V|@TE~>rWhBfB0Y=tmk53~j>!W6=mXJ=B`i2&9X$Of$MAWG(uB%6pp
z2Ev#y?8O+=T_byw5kXbjIoP<sga?958t|XpyBA)3{y7PN$xL>|EA58`;DeNQRWRXZ
zw5vs8r~+f<XXb>7`)OkLn&vSG$W2(eGzwt?GN|w1<`1^WqH$%`0gK$}S7sbv^2=|}
zm6VdZY<;Z~NsQsX-<9vjexf2PqLp-Z4IG4<5v*t>9l>Mc=fzxl=S<mQ4$0E<3N^R}
z3Ixq4q8?RD>PrBTO~x^+*P8lm<dO?X7B&#3oITTuP6V(hiePh>Apmj|eewkAT2@j(
z;Ls#Re(EtcM?BE-%<fJWhiz%xOP#A!D8Rv^M}Spp$w=WuMXf8Zj9J?7E|k+~VsKaf
z5!O~E<8x`>EiW96I**BoC1_?&w3f#c^ep8IO61Z^2pb3^x|<xMhpSbD(gryZz-r}7
zLGo3ke!EYgu4N?!Cq%M!xDw{O4@v;d@JxzS!_1QJ?gFPm8tua{g5$%(Fg-DugiIc*
zR^(J1?Z73646U)BY0$GOA~QkzK)b*@`z+w8MJMnOyCjMu8kAYq(PeXKE`$xJ7Je04
z`*7Yg)4FB^Sa>p81tV)Z&bMZI!sRH104!iR25sw`(7aqTX9lA-rWls-i$ayKTrR`t
z*chzt?Sx%o7%7mpO}T9#2F2C7f%>}(T97zdX|D>e`JlbxMPmEnATGhOYjOASle<H?
zECV5oXa!j362>5~O|`3JrVNX~Dr@b*-2W;=ieQ(jpP6~e&178J&6ZZoJate53W7)&
zhA@OIYeoN=$>?1{`B7=m(hHg<p+cE<R#0&0#KZ!1F0*bSIMaHJs>sM6>umhE9CEjo
zTv|&OMi918jI6fdW@ZXlt%f8?NELi+hV?8<i4v8Nwv^wKV|RD4$$r&VaNll~wsC>k
z>k5Nnp#Xy;!*EvNT!@oN%pvG`f_fP+JJFdb6;nlk2<%v<FyJLrSQ_v~6E)+j3s_y_
z;!Qt!&*$#==a;|bgri92vMhu!g0SMO7RN7zSp=+0GLAjJT$iDrsT4xj6H5wf!n8!o
zFRBbQn&Q20YJ&i4Xk-MoQ<Mlzy+jHi-DSs&_r0J<$C7O+|0`3kVQ_Za*x#6l%7VXa
zw8r0n-#**wKIF1|MJ;FlJhTR^EQ~SI7O>QW=ZiA3<n9b@q*Ms?N`c@gRTi`iivcj4
zN!hwIx6)-=Mt86_d?*!*aCGoE^dPf}f<Uq;bu!KLgasRiwE<YqcBwHMHwQBs;N&($
zkU>rG4M*$sKfdLz{~YV@?!N0^u76$b=a5TU2rFLO;@HK6HSLxKoC(9Ch=HqH93y7+
z^bG1))>5z4Yq1cumR=!(J2Z(<fLp7&&eFn-K^-+)nlVjIO+y&-B(}S;S(&VIlu%-#
zwrRPwYXFsMqj7ZryOgRt#5};O#Pu`B7<)gTo~GDX56|@e<g#ppu!1n7nLT{9N}0=l
z%>=M?Ma_g_-Q?~JZDh~L@Nl_WJAxhjLf7WhXp>5<J!n{s%AayD1+T2GQ*KXAPlKq{
zpd$)ls$REq88t9*1x9LwP?t6KcA*b~af8sYv%pNzu`H2}hsfy4aeN(K=O4ZOTmSuY
zpSkIEdr$VB<#JjIVFh8v+9t<l4Y2y5d0b|a5tVYukf)CwsP>4`lnvBitx*6LWE{6p
zM;-K~1xK^T6`)jVRj601&>0nA5&^400_zKATo!~g8t9zd80sM%o<<n3v*602GLK)g
zZ)*I*ue$5D4|f+!-~YnRZ^-?#av{-p(G0M%aK^|?0Ba?*o|2OT)(j+>wi0#FrjQC>
zGZ@ke7dOb|IfmM7Mnsd{8uU;Fg~`cD=q(oESb5rJ^y*82jR7WIk>ko>jBbvx9&8@D
zJ5bYh@Z3CpBf{j1!fNF+Z~FR|zQ9X`{a?ENmVCnD@|G;Tpzt$UQ~wgl1T1B6C#!y|
zpnWtGd$8R}mb<VH?9D`ST6(ZI8#1&}6GW3d&A`e%$YTy;<KwV$-70ANPSI+fwr@H6
zm~ySK?hvUm&R~JrFa5KM6~V7Q&iU1aYW*FBdhoehzVXE`7K6fpQlU8dAJ@KeMjmOo
zoK`|u(JG=#f;H_7@9h{CdAM)QIKBtu9HCsYgn{D<AetbI9t(8Uz_f=|nn&sC8goe#
z6^C(TSUtt{wn$rjQvFE*5Yr=@-q5C3$ZMkpFs34t)<9et3w|Dt<2ROsxEEV@-;dn;
z-%poWZT}rNyz#UMt^BJ`KNOa0wT@nhd%6nUQP+m`M}MP#b3Rh)3t`2cjN@m5#GI1`
ztWJ=zYFf#@hw_CpXC}h?$Pm|fls3`(xon+|O-wpaC2%*23~PO{B&X!Gim&Gy&fGyl
zS2cu2mk7Dn0W}+{)CpmuZC(KrLC}Yc>zZmTu9=SGUn~aE;}HwK`Ko)qa8Dr!c8A5D
zfnsHP>T@^0eo->7cRze@cr>m@<JFp2C3r7{&_7<QhpVD+Lr)lN;N|HvdVrnDgYc|c
zy*5xgJn$!wug~cTVFfa%tTi79YY1~%hN)@?SY&wFlyN-MqMwVB#A%cHn4>^Kcp;D_
z*fdr1w0+A|Da>A7UjLPBNWj?CB%DKlmBp-B>NC}Da7Gb5;Bv0X#HTk^>HRVf3mmk>
zb|K^HuEn)$0|r+GEO>h)#F21%bU$X@^NM@Eupdk8Dh6x<ujEK9s#85d6pzPjVoKEG
zo+yOAQVIH_2uiHL_fJ&HPsTM~!8WeNGhWrzRq8ARg(+Tx;kXWy^(u^4V~FDzI-&yG
zR48^M*c6Xf%P?NAiyH1<SL*8NjH0#U^;$H6`>54@Q2{%T=*N95WI^e``0&<g9(Pa2
zbrBUh`nw@ov$50>_7;jO3qjaRk)mVlFEK?36YxY7v!0B*zMLfsGYGIcvI@@xu(BA|
zp*H1n0Z0LcbmA1;c7AVl<rZ)SZI9U;I?Ke=6m((-Z>b8-L`^i6IvWXT0szNP%d3+<
zn2Md{0<}_&tv44GQB^!6=5Pjny%MulF@G74PE2#CVZK336IITubr8D+=jCdh!5FVV
zHK=3u^3-UpvTt3rHVJ`X6rXFL5^pKh!ZlScSVh#K#_3+m5Ia>~4-ePG8LS4#_6Sh}
zL0CFcul0?`_5PTPK(3lC*hsC~g(Ztra=Km#@Uvr0p%iTG?t{&pJwX?OA5D8o>R11g
z*9nc81Q6HrkkPFq3p0ouof2RXJ<EzRnlI@!6G>rAGDi;@*CdqtTU)N&E!HBF#vrPH
zVrm+H{QyF@^E9Y_(EM1dZLgfydT$qV&)JH-`Nt{fat8u=he$??k_>01tDv<PCz;nI
z&Z5xNcC=CnC9~5*t)Sh;009X>%bJy#azrE0sXEij>mp8AWibqpeRaat?p|15>Plt}
z)JfH@R$#nVgD}v)B6xnj$vAJ?xR{HUEX*LR>C7tJ4zN~c<e^{wXq)o6kkEro^YR>P
zpN|2quYz4SQ2Ru=$7D?9tOZ!Dl(Az)pj9*<P?}1k{oEfg@Y<3tGZU)T;#{tg-#gTV
zQKrkW1nB(Z!pZ2G;u`LmFeA5gYp3cp=m<mD(%A!NB1moN>`uUbBCf#{kD-d{C0B9B
zqQJ03XYf~s+ku2_<#^RX2r~#f3QdmD<C^K(&<?O#dAO4dJ@o1y9&1xR7f6wb1Uvju
zLHnKt(6Ojo(1L~@$xXe@Fh*}DfW;Vi=Cfu-_Vl){AYEa)j%JN$bpx7^u}12dKBt}n
zWC6hywSKH~IZn=|c;P6oN;T#9Z<N>)-lQAWZiLHMt%3ex364~zVc+Bgkct>7wrJO9
zbjEdsy*LR~O0my094=oW%y`M&w+-Ru`W9KTFsChGWqF?F{#P>;vp|E>8MVDih!l_V
z@JU#kw-62eK1-t`l&Vy#_ye;fQbe3m*)l6?R$&^r((Ee>xJ;f5)}gOk`1gW@dsXN#
z&&@7Dc;y-br>Z+mPPMeiYzf)aT2%RNUb_ii)YX@)GBk|$?1jm(q#eYr0;MJ<%*h)M
z_l7;}Z%DsWkXGz-NeN-coB&o9JsWCMHWwuY)&bf}T<GQL!Ew-3jH?*{Wj*+&BRY)5
z#St1A1I`oMOB}b<NB#Y#P0$*Qn(a@QG4(aM0)s1-H!%g?&6?$Qf99xhEiXoEgIs>m
zWQWwbNmTE8q9R<sW+Pm<Vij~n1q7)I9IH;lbSy*CQ@}%CrPHhzKrTef%^DtQZ#f;=
z;zU;{US^Vo9jBxcwpy)~<XD@sxhUy?9(>NH6??EfTY!zyV98gS(lkm_^HEA|WcZdR
z12xA^SfH@Ub+DtA&D6Ur`ZiPT#%o7o`-KBwF4)TIxqliD?0mJ$09Yep%N^WQnw+y1
zOVHlZ-3wRsuY(ui=VV-mf$|hgPfsKOMG`P(TBk3?U?T^+AT4uW4NdTq>dI~IS(1ev
zeOU$D0ajMw(KcmsQ6ilAfoaW5t3g8TWR8m1XmU<<Oiu-J%gB?(T)Iz~QNm`-Dh*=I
zm{luA<^i8*noon2k1Y<9G95d0GMBwL0|u_m$QZcX^MSPe(S0l<yCm0xD_5_FtJkcD
zmBkJitdwEb<TzA#oY<L)EHv#iElIx-ICC1WS|#kAc21uB)-0(rmki0mj#C1xEa$g8
z6z+`0QEHsf$IOEypK6&St=`n>{X(Bdx<(|+9%6?j6_keGXKXZYXCzDScbSk=r(Lww
zUQaWCP40w9S@_iiY8x@amSehdtLLe6TeX_*0ZsVc+|>&|y7fFbf7NPua%2$pj1DI8
z!H7v|Hs!q(6d=05Wd=Q%cLgbh(OikV`}*yZODoC3j^3<-Gnq?xGAGT&6XCv~olfF(
zbZ)Y`AM&8^XFoY+uT)+iQD{CPb?6}N#OSi7EQ32ZdD6h9fh0wET-L!n1G>I&VT$QL
z+GWXB@7ympA6V#j)yt$Tm&b`Y^&^vd?Kv00wpD8r)$hJz(pRx7h+K{Yx>iq}bAKOg
zr*eP1RD1Myk89;v)lRao<COfcvb;|7NzW%K4VshM!5mz&WW|N9MkUcLU<|`bxbnhg
zIuO^147I0CY393V$fp5EV-j<(Fge8ahhk4|mBO1(-RQ=lfGWK^^^H~sny%O2=1nhx
z8#bPi02ht+l@YMQbQm4o^oBZBHg&tyLa}B*zyh<}cHc9$=BCT!=Hg2hcAWCmoK`Z?
zrfe=o(t1{t`QoY0W4pX-E3y2bk@WbZY>AIi;;}8Dtwp5)L7Oz)S@_j352r0gT{C&P
z-E_->&%8uxyP+9QAj4)DN>Es-*I`{}H@xfoZLqex2X>4PLzPBH5vT~PQsmXS>@+vk
z_9^G$4N$q)&!81c6C&NpT$)H0cAOGmwTgp9a$1B1nI92eM>icoOUf9Z>ffN=@ht$&
z(VLp7iK>HnJJYIQmXSTx?}X8jggK>eI2TPo%2DIeYNF2MHs6`d?Jdla652OWt-^)<
zYv66?T>=xxs-77ePS#m0C>xczq!hby>u|T-*GV#t%RCEYW2uHJ^I17FkSy%T!ko5%
zm8C=EOM9KDw0w@4S$bZ5P2rEzft!|w6hlh^RBCriX=-F|#)gDFX7UKTO0)qh3mM$m
zmmVQZtCYG<pRp<SqNctOgws@-OZ(TtZ@uIOxbNs8I9{nhG0-0H%@NmC*P39B!guK}
zC$w&;8YMME=GE13yS)39OAE=uj?7u(?EtIUd><`&aIzVT+j&&y(|s@b;;VTnvSdo8
z?OxvWon%-r)fJlokXvzj+sm6$mxO58uMx^%mos_WXH(opB^5r~A-4;o#tO$>vw>yl
zZ<68Fcs=o}dfNrt;9ExrU^oFQy@qxAvKyh^y%p|D!7Y)%lLjy6Ciy;Cjm$SUy0?`q
z?8w5Lwt$s&yvfQ2xiptl=Lg@=?5cLQ6E#;~ywS6iD?l@82=C&4HUq2F)EMDy2=BOw
z<)s;s0?`KcWwNQI!&3Q-`v5o|<=%PR3zGTEwHmzP?DJuyUWE}<3k!iCk;1<lRz0+P
zn&Wm_Tel+w%wCU%W&c(=1@oynZ6pgjGEJ_hGJ_zGG&*B(P2(yGgEK1VKKxAo5q^0a
zpFuc#ebn>8OnPp+Q6Cy!{H=fr!1yD1>_(}0hCQW#$+ukzGs>3y;fZ2s0ML%W`E}_k
zteUF>655Na#xb1Lw-UCj=!d69h7#W@e=1FLisRiq;eB|QlLjy^qt4u9#MOdU4p(jD
zq_LwNU}Yg;PJCx9X{EzX;7vc<rqc-5%%1*iQnSN`^vX3MvJRS}<Ml5Wxr|<vW>t#q
zrC61*&2ZtJ)2M>n$tUc754f}^zp$W~*tJs3N;rQwfMsvAhjZA{Bd6E6T(s5QX(i_J
z)BByl5$VE^%E9!=ZIdp*So8h4xRP~);;e%004qz^%tI=kh%k4ouR&)?8QN7`CFeEo
zcaIi@Q++E@2NAGhVJ5;gjt;t5m9`tD+!KtwDaEvyDyvmQTUN;UQMzvJ!LERa38$Pn
zuj^W18>gq_&{57~s3Xe?mCcH^c>bHO?5K}59!)baVJIL|s;F!Aat-pioS<Z3N2YDO
z9bjd>qB4zRxwv8tBdtb|G|<QwJF~%_)ZSKI&*foEmsRHpgD{EwX-4R>4C~IeUABvR
zYMzdiVDf6<;&z*H&7g$wt8&50l-GdZZaeL;=kP~MsSP2X@0lZq;f)t>hf)xsis;Vl
z_V0}w1wSpq&)krOnHn61=-x=ytkzs+AX(UvsV=qytgID#i*3s0V#K9AV4i>0JcpA_
zm?NS^?`qm%ROT?0Dq%e}wa4px4p@N0j9dog*_fPtMup?TVO<V5fp&Eeb_6qR+j1C|
zJ--j2x~}9uIfLTH;KUewXZKEc@mc4<<3q=i5kkGJn0rTE9BOv2L~7e1wT3|1n*96L
zs*YURN)~oxt`go3u(BMyGUxo{(o96=SGzOqacz(IJi;H+GRK*;y+lz2K^P@QYR`t{
zfnXz839Ul9Kp}+cz}%>Z_PE@~L<+DxM&*BJ!Zp%!hq(!R-QKkc!?sAe@VY+#_`{^}
z!cFI0lz<jZ!wJml)Qyy>8B29tNxU76xRlH6NfvfwI;7`-H4jo2<4_bd<DmHxUOFm)
z4V|K2?aiGZ{lZ{6w(A~2brrBvCk%^oXoi5&%|Pup3`!XAv22IiCUM~aj@_ob++|~&
z8wTbBmIW%knvKWSOf!YwT-O+{guK~rd-Nd~ot%VQwqF6e#>Zf&GL=lpX(sLA3mWcI
zVrOHi!?~QQ%o$)!WgN?j<dBOaabicL-zepr;E)*gRrMDav|8vM&37babyU-iQYkre
z+NaByv^-sj%eZ&0Vck{N$eP22QUADNMcQU185fsi$r&{?b}ChlKuXuIk7?g5(>T>0
z&2%J=3t;a3V$yQk5rlBtBM-shu@U&Cn_mqN57uF<N=~F9WEtIC?KkfU;q5W^ORy&S
zTbv=6mXd`X(^&=E0an%|#eAX28H>-9lKw`!($N{x-s-8Iz?|Np{gfK4S!z^^K%)}@
ztBN4PwHt!TCY(=I+A*A470?+0<QiDG$FR5yMjne&+p(-us8BbWO=;HFRDA@^{@h3n
zS|zo1D(&IFzPkq=-Lo71_`kjYKXc>Dq1@34`zFTZ2&EThHJhn=VcQuvleFbHBsY$3
z%IS^UO;@ALA*`*Obez3*fR(i>PG+F3Tuww9I8fq;#Zv<&T479YYnzRAnUGtZ9UX}y
z9d+EmHFufG%T|3fOeghSZgS;<z@-}3Oto`?$^aNwA!T@j9Sf3365tu+?JC&9WHaib
zbKR+nhZsSrD~e$6u_N%&JMVxWy!<M-`rPwj$Jj6&nVM8y@Y#IJH=Q|^GrK~Oywh$l
z#^yD)a<j<ANEUWvuEcdJfR(kPPA-lZe<QG3o*sc}@HBAzuV$id$j)VfjoAaRvZp6;
zuB1SI41$!+N&$mrR<8P|zjGJ3H0US;yUVIL_kk(_Fz(f15^v7LELed7DeIHvFw@4n
zYi7+*Z1(ZVDfqj4?uIiSdj#I{;%i{r`VFvWY9fj1U=8xBob#e!%n8rK+}}(73dYXp
zojK=HCn;IjaY}$SoN+93b&Fgak(!HCIhs7-{*niJpMf{I!*e7}IguLLVZV~Gy$=Cv
zyjHQD(ozU8U<D3fXdu(f$FQUnz;Pj?nYzHHKuWl_Dg#W)w#D^mpu@PhWmE<X)kSb)
z=d#Skcc_Kr#xkv!F`2KoP=cewBk*@$zZ<rnaVEU!>X!oV?u8dd2BD@_5y}#M3VDyM
zgGoDha&zXADOuPtl2x!BU}Y`GlQXQD3iS^?$;tH)ZE93+?K#96cV(QC!K&Uq7%7)c
z$G1~}U1v{OsnAU$yA;>PbS{BN=im~&v^^_fZVIeifRZ*Y30{J0R;2)rbB|TI_A7Vf
zQMXar`qcCs6NlXnT^JQD0W3K!hQONCK-%@t&K>ahzP<2{>u-WvF1rFA9XtYiMn|OI
zmUqYe*M>Im+cUXJA$MLG%#`KMs6eh1X39ygciIlHvI^&bHA4|qmmE39BnP1M+g!AA
z^i8RLjp~tST}eFLSN8P6u1Z+~2(v6H0VD%lj`}4ONGPxpp4#WCduqf`eHUCtHs!*C
znm!IO2jlr}R7b_M40wTZgHYR!dMe4I22E|!)>ki?l>wM!m212*waSe^P@;7QYp51~
z?CW>IJ<mP`uikz+Y+t_~2JpU&VWI_QLtqyAym^8yNC{a#SLe|`iLkF2{Ts6MP+~4=
znKQs5dRA|dZ_P{YzOC@ktA99;i`7P24TqC70FSe%YSwHw)?&XFTE)1#ryIsA6^EHQ
zK2{(sgHRwrK*P8N7;T55ecZ8ify1g?^)CUvSc4chd5sFleU%Zk8kq8ww{8wr{Y$G_
z@`?kgA|{^}v?P$J5my9mQURkv5q2Lr44*(X@vOD$;RmjI32a%j1_q`l;po(45=uEx
z3`saAF_X~svR)}4uf{vini<-1Q9_u3A8T41CagInm5_WQ4q)2a<QQ4{H)7h?rjBJV
zwA>a1>ak{yElG(mhlDYpG_#p#L%k=ST50psJi-+#R>08lgAxFknipum0Svpb42mmo
z0ShFKLEW$;14!yvEI&o;0#ck}RdihMvtVf2<EV#jbW;Bl%ncCQIu24*G*J=)kan$P
z9|4*4+9$?IVQ2_|2)I7{rQ6}`b?f2A3oeEWHgAS;yzjJTA<awF%hPL@4vl}h4H`=&
zK+49Lz=d|yqxr*-3t>j9Q9{C+Q}V+iuhWCj9I!|>Kn_@KrMII*L17aTq91q<c$$D%
zGjUm&`R<f6oeWb~sRUuMn5-n@Ib7<zX7o?lq_oY-8`0AYOPD3Yga#~aj5h%09+TkZ
zfnMr3Gt5fWYg9q*se}d{n%xa$x6(%U1f;mMVF_B=jA>Mn+q9qfV}!@Lk#QXu8idb&
z=U!Oby8^B{`&`(5?s-rvgm7SD9IEv?GBeATOn7FcnWy6-+HH}5V@|VL%7%<%1279y
za|TZG<hdx>w)U*<9Y+qXs#S$~&<$Hk580p4i&;2Ee7|6KXD6^i0m=wii5HTvs-IQ)
zWRmU!zRijmM&*1@u`8n*#=d%(Y^!}5lw80v%#7RoN$XQC5Aq6yH)?0@lm0`@O4*bW
zXR`#f0?BBZ1h3@!G>8y`3#iUO8s0IDPEEn>-+K`5eeP*^-S#Wss`D>|ArZs#!^aZ<
zO;*m<>LJs{f32G9HfhyS|AskWwU8{#AaZm{fHkcuX(gN5l+OiaU2o5deS?MmscJQO
zQ!@voB!cmV$2)Bs(Pm%(cg1LCn2F23VpP3W_4Ps(dwK=8OVlw9gGs4io*RNy5A`%0
ztp;)pHVSa0T}wE?WWg)}C(W>8J37c>3wGK-@2Q<44OrHJv|;Sj0W7JS1&Oge0h55*
zN9ti9-P1!2?19`z?UF0hC%7BnzEueD)3qvm_Q7w%JqTQvy=W_(zvT>wasPO&j`y*i
z80Z7j4(rEdmVNZvmaBv<BnvZ$9G#L%NQJXhzRhjQ=K?gBQ0grfR-6HJA&g-+>z$k)
zf^T8&O{9t)Z}rOl#A&q75wM6Mq?nvxSzuMcgy$%rVhN~N7R8hrm<A@vu+%7_%dAo=
zA*f>-_;g){fw`>CnYN>^(OjuU2uZ0VX-d9xqY4sO2@TRr+qtxMDH70PkiLryieU)F
zQXyen-+b;F`0nnVaQ>#vaM6|*!KM`}p@Nx*%99Wy`wGa=pV-EP0VyV!X<E*&T1pmX
z?1fVStcPCx!{wLUecNu3%kngfVRIoK@5FqWCt2=NuEw%MHaH@ve(8HEn%?PkQt(xe
zh7RGVQRQ+4Hmq9*L)D7Z8g-{Pb}Kz)#=0pqPN@;#js^;cVHrSjY*R_9J1Qd?-3j;*
z%(!uNh^-2lvVmE9n#;EI2&;QT9D5agQ)-|DD`HilR1ql}X&{a5r2er$e@bel_^ETQ
z5Fsc|Ffa;bY%K!pC-(1yhxhG<{_Y+)XWa(ax^6x6_w~UvMLorGbro^KcWnU3A*)dc
zEAZpO7KaIAb`$1g)iIMrD9GELh8ov3Ikq0t3TT6h%UyV)Ojw0RD0by7J>Nuwa0dYW
z&d{QOk_s}cwf+4th$?8LsD+)(Y+V~Xk8|B|Jpj`z$+11fX_jRHOam2dGjD&a)Wo<E
z_>%nge10@jMue$m2PBlmThUc%_X6<gQcM6AAxH)ZXoWT&uTl!-ou~GMq5aN?{n58L
zF@=FL+LHq+h3T2Xd-~YH{qXdWL$JEH7tUI<4%V$&1>L0%z%$|Tnqph|Ou`HytXSXT
z7-3A-%$h`I0$778H3O`bDjl9dJ<C=&NZXZ^^jM!GZOtBT21l&~@M3Beq6k)^3bUg!
zos5VH(4OvKMg%1|fMd4;-_1d*Y{Je9)UFTqm|{hB<>`*#!xi)5^;iNTsf$JxjIC-I
ztGvRrf2vR@3`apQ$fDxGu2QKA_1d24xOO}&7N8SVwIGPhWlMakK^^O;)dAT~JxK)~
zhAX>!Hgy!DEfp?U8IhSHD952xc?q*iQM3l@+<>Zj@+#rVEh1p7I|zamxDjZ-uH>%c
zkC%)XCLyO83{6hLzR~BCJAYRH8f0GUVKssmM{ui4H8zw+v|Li6@uHawLH5j=L{0>-
zPP75JD5+`?a7LEw_&Atha${Cf(uiM{ky*7+S)`QFH%36{L-nP1MK25<9)eI6kw$kp
z8po8qD)Fl~a|QiRYb<wELucgA8rNe3M6{i_KqO2mwv0-#EU3rI-UU?zhoM5DI8ZD^
zk4ItQ*+L=Q9Yvjoi=BmGs8<HpuIS@qlT+hQ?LAN-cfzhZXWmLfjLuny3N^RNVG3$c
z#dEFdir}(M8#?>?SN0B0PQk>)B&x<!P@RsU9G4OFLfE)|U2hL#Ylg9KnU@i711MwL
zR&{sw^%YB-rbMkcQRQ;>62eedN7wpdA>264xuA2<5Xt)P(n<ur&EwT_@aTcPV&nKI
zTiMgw+uc!G)m7{`fYoKHHp^79@FELmjLZbEhB7LmlQ&~txj0hMbLo_mp#dFdZik5!
z0L{$lc7!l3c4SHpRaH?n*|>HsM5PjpmCKevxvC&&yN$5MZKD!uRnW2TICBVHn^git
z+Loo5l-@Rp^4IIhHfm?nrBdnnVpO=Fh2j1Ge|uj7Ajegn`Pb3i(=$DXZpo6Yk!)GA
zF*aVC!!dz1*M@LqA&^}Xjx0_>c1a)!A%HoI1B5H=a%@644P+sJ4aNZ<#MlCCFb0gV
zd|TFKoin46G-vm8ch&x1z4z+qsp{#O>FMd?eem2pU9YO1y59Tx|Nr+NDLeH*cP4#=
zPn;-}%)&1}_>qLTq}l;d|2k25B{AxMU&7~q@U71nR__|y%(HSgbBvBmPqW09q0QNW
zba$7Pfn({!Op&Jf-!qWOq*tXgy{DYAF<zRXsi|>FTdDr6K^sa|dStq*tJ>~*rvhBD
zw1oAG=f9%x)c?5dA%6R^n8WZ`y_nk#b6uyC;S>rXk7#A`bt|<x9~Jvz65*Xi)lb>O
z$QR9uOjtVxw^H6RJiCh@GpL9ulrl!8G!Fc&6j6m-7<{rS2V^D5NsyH!s<PutRIaD)
z@q16AD)A&UPGq~fel^gY`$Bgvch_xKzON~rjlc2AH{x5G6>9dNFbKybvpl-wgK95;
zE0Vn29|YITb%9zdKR;0A*!CK)(Xq%&dyzuKisc4=JP}0x7D3U*tmE<au$_a0tOm_^
z>Y+^`PgR$E>B>_HRW=2suKFop0{4Qz;Zv!La>uV6BD8WjLRMabVTrY>o^)n+Hl6-_
zF57)`ZdL#OTi*Q6YQ=dq+8folq8i8esFkpGFK`eVL?XRQB>{zOTC<8x_+%6#enqZA
zfrN!^c=%jp(sb^Yt@QKp(^TerSStH~6I5X~)MYEwL*KwI)5nBk{vz%RzNdRQ^u`IK
ztCB}vGkx9J8`iE`b=8mF`S&$VMvb;d!wBm!O7_J%n^ng3EY9hj!UVw4&@;{$%AORJ
zssbm@kWJY?KHH+DJ`LUp^KhA^p8i}fow0sB9e(&XLiIBOgS_vDMM4F16lvkr4?-pq
zDUpLX!+^|`jVq*5hP~Y7?w{d0)2jzod~G1t`@voBeBa)s`BpVr3E&8RIXmGnxaE;r
zu2U0XF&Rzq4fpWd^I{Iei1tiw*Vb~aPDH5`GH_E6*&hv>4Z*0C$lL_wFZcvf6GC#}
zf0gd(rlHAkk##_sz1%P%`65=t;I5ML`F#|Lh2jL&j-l_d9tp<*S<y^iuJ?OuSFL!@
z#_WotyXy5NYP34Q5lII3J>ZyHE>f$61>8aLgay2WG+`wIzCuRWJ3VSUk8B>s6H+*U
zB=|HqCf>tGXy=(*=+M-JmuWQRr_Bs*=u2~<{8j-`g>zInzUR4btS?Kl3K``UVL4(a
z&>iUQy>{ck>UZAq)^}A4n%C$&yrjypJ8Qkjd<g3vims3_p2ZSaKeOcNd0ek!;3%?E
z?hDFwJG6;!xDkugEJUd(^gbktA&7Ty<0g7&WQYn*3ES*as1hojh{=r-m%n@Hhr+lN
z2w)-mmhUJkZCs8UNLkW9tG7FQ_qtsFM>7MtrrZV8SRQ~I_~ls%hcVOcsr6d(A*{zq
zxX-VMIW|ZlM(F4BxL(J=DZ`uE4H1ppxvNOl7qLrKY#WBd4a3!5RJI4ewk%q|ZXMk^
zblmSB*vEveOYBTWOT|b0u_&Ypy7E4eoy2e+Eujj6xH9R~k##FqUj4&&yzk!ne}ft=
z4sgR@!ZC2lo?0(7AHq5$TO45l=aVL^Sh(dGnPOOxPE;rK_XEQmRZ%5JeI))0m#9)#
zbXmgbrc5qJ`wu@(87421JA#27OF52K>_3KVT7I}qI3Jd;M#?^Z$c`}3n?(7pRQfw+
zcjkvn@bzi5KF+UlOz}!hm=9qcmKT0<!ttlF==ZO+IDd5<ymfB)@00ZEuob?NlGJfG
z))!nzIq-0wW`-KcPt!mu?Gup*<8eb;UPz(}8RNrV@ezZ(6A)RY6b5w=(p7hN_w~2E
z`AYrlH6mb6$l#?)7jR0=Q2{j*78B7p-~4C%_Js*uE+LWYMsH(R0I4jL(Y>PhjR%!|
z*LzRoOGQEKzw3WK8{+tMK2JNgZllA~Q$n&*w+V@DVS889Lq0@CmG&zNe;&9skTTTs
zf$ntX#)1BoHQOOHItt)~OR5~d3*1uc#pWYn0e4h6wq7<(SQS9}6mQ+fyHrKBKXC>H
zDr3mDRpHxUNDp}YU3SWJ=EhC*=+p#dZ98NlGlINN-nkW|RB_L61!gzYKkVo#P8Gyu
z8|HLZs_QnZT&h~_M5AM&cp(YZIAs>*OIVPwk{n1;4dYU7Kb_|_+a6BQCChR}O}iMv
z3ag00;b@(~Fd{pIl6car0<K-VhISp<@7b>mS4mL;0Yz<QuJ245F=~bWj2P}IxK}`2
zd|x~DM1OB?_sxIvjztG9YqTZ62^$iQflKDa7xN-4nSu0re*3DJ!^nR2wE0}GQ;@Qd
zcgcuE;6&`}6gI}wtRp^wBwW8(F4O82E6B=bX_QsM1VJto>{DSI^9)$wo?&&c;&boC
z-|=))nbh8#Vdy9ajU<2*%!Fgt&y``c67!X?fG<-#VF4F2q4n?}CKqtsw#D`pef^J~
z9L<&8_&^&)Mo~d1vXAHI%bE>CsDta)(<!%11(c^!7juKFRZ3C9$nGjfhv>B{?xSK4
z0})Cks5c6>Wj}1$wtn6kvj8q2k)a_8U!LzZ7eZJ!k?@;{iwio7+hyE-uz>5fCEj@F
zj}6-U@Y=m&r}|K&Q}|H{%;q0qDo^C55W><Cil$z?^IW=rWJnmojqndzH0hrkAwrct
zIrhSVLB4W4(x%1towQBs!E4|Aw{s0wqcZ_6I4j{8{5o%%?*->gSS&rc%$)GINeX0q
z299&T@_et|j+n|9MG9eM$aa;qR2gnlO^K86g`ucIiJaq`H*KPypEwfAC|+@{5o*4w
zITz0u0ht+*kG<iWhB3)aC#ut!1?B)$`*=o`F1Lb9=6l_RNLauwZdY)#VvaqZ+vi9p
zH}g<*W~f*!#85+2tO?Y>DA5E?rE<5>H=GCO4CH#KyT6Zy5AE^7b1KzI|9(mp3>`Hj
ziN(*Hpzy1>r?j$3Hw?ov^DNEHSvWwWBZ2Iq&rdi8VP@AtF1k>{dYFX!LR@~EP2A2T
zO;{fCys!)9V#o)|4M|E0q53(l6Z+hxsDLw@R`N3i+O}f{onmzpRi1n8RJ4OzNq*6)
z#eP~qBiu*6msOR0Rudn3?_tl%SXOCGu3Jme8gT#zY)Uu=?s#}17hNb}LH~S|;t30t
zU6D#chv_hiGm|u3l*J$7tXFQ89l(gN6_vcyyYb0MFD3F5QxjyH=B&#He?}q@#pgy?
zeN>;3Af*sV`BIo)z*N)$EE~qqM5&}DER8sT1CpvdgF7By$VC@KSkmkLJN))VF^A!!
z^-@0mDegD3kn6V-itZtrDx1Eb6W;BMnzEvjkRv~;W`HlVG?vX|=<IFV=!Vgw)Md%X
z8MdOMsHiKG^~swX(gtNzN_vu*d|FlH<$Z`ceU4X{luY=Qnfz~a#zrRdx+bMY1ibb=
z4xo5{P2l?Zc(;eKPzeiwg};<=4Qyq?VeChXxPDt;lockcgs&+ux&tAZX4W~$9tKLO
z6QAb`1=@b*7E1T#X!waquK=j4j7$}0tJGNHRpxv!+zM&Rh^m3AnJT+P@EIzc+Lmo}
z+g(ZSVH%wato<Z+1}ugf7kc3Z6BaY%5oXf6`R#AT9EShJACe|4+JBh!X3GiHVsWLQ
zBNa8@7B1x~DG`zS%=f1Xpj61h%nV)j<O^xUf&Ho^6ZSc?Vto?aw<40BPehUJL_?^t
zQqpogcL_O0G?uc=j5c9u%mUVaPr|Xg!5s^|@M0t^0Oh@~bs6W$`g=@hALqd>$hg)n
zNKY4OhS@6YTP}9|q)jQTnuP+R!~Nrcia5PJJ#^Ux7tl>7hROFmm)m+?E_dIBUY2&3
zH}Z?Nl9HAT-&MgQC;2oHN(AZ3aYND<>||0@vrUU^BU8UGOQYq%YaY3;elOuLX4Ile
z0xp)Y5C?Re;$wx@kjOIF(S%ht4pF(hj>$oZSmB)RuAjjrtRhx-P7y~-EKzM)w}Do#
zUr&!6cqC-d4`@zsmEqsOyR%>2LNR63!OAcL=5q1AEO!enA#J&i=;QEf+P0}bQ?V<l
z(dodNUz2bQT(PKF<HZuzujK$<k#PKV%(yqRl-02*b0^&b&6HeU%?m>jimGB$ovFeO
z4uWVdJ^y^#eR`CJ@>7&E?Lf_x|8bQQm0|d96^6gt=SuHSyfvjg%Mtc1-&Q3I?Zi@*
zm-r8_rgS*v&%077THVuKudhm@#ldSGt_-iM(gj@c>&4t-QG~@rG{J-XJ|z<t-10Br
z*0F@OGrO6liY3Dh(z-|BWlc~bR*inY=nC)lvj?}*PY&%D8eHgn<w8-JO4-vml|IO?
zrcB$c$W5qxz8ky9GmpO=p$ZzXkC`Ap(<3q4Hl02@qr-AE6tLElLUDi_!5NFW!D1yW
z;M?3jL-AXf>qu;Gey<MqX-QnPZb#}M?cccPWT7kK&F&S2Fk%B_qI-OC9`Qu0`g*B*
z<qF#U&_0p>%9ZM$I$x=Q%7-Daaz(ccal|xy?a);=uh4Fxp$zgKnVHhd-2xFGJzAL3
zZVeg=SnKN&j={z0y2ajL(S(IcIV@#;l;2*N(B-*&d<FOGNC(4gZ^rI9nORK~#I+dG
z*zTwZ8l|Dhb7D3IBf#$9Ip>{EM`rSrcgoabr$}W6^#v{On#!<mL}PJ$|0)WI%TxbC
z#(Jp+LT7YkAHy@ai%kQ|uxPU6jNE@}M5jg8fI5g;56`XA<)ihes#OmO3-|=LH*#AQ
zb8H)le@I8xEu5I1p+Xt1CviGo$mSGAXtyxjPaT5))p=*1O?xKCn5<?Cw%+MVfRYzC
zluH7kf{*xI?Gh?;mLe|0kl{g++zjbKkKz+BxSLQyy&G8WjH~%d!vog%wuECRNN~iW
zQ5V8u<{V~*MZojlQOx>d{0Sfb>0<mZS{0{D(==6*4*$M80fnOnX%?A9Jl~@VVwuUW
zucwDLo_QwS`otdL-469qn40|ELPMSs-V_upB?t);6rrA=Cpn?344Ot~sUpHwWyq?E
zhV*p^1T}cO8`N!RqkE@=*ET|M{v_crrp)KT5%suNy(BE)W^S*g`1m0h<KX$)afCIV
zpQ7oK>*;)kB%)cFMSVtzhSd1^sN}i$3)w}Vw0R4iwhfwO)zD7xGdHBl>0MRX*`;^8
zrz#q*Z}U<FiqDYk!7E879Yj6V(Cg#)q~%?o$7Y*0mAkcDgNC=ZFGx6sBnb1)dzFNG
z64tM{p@?Q2VIc|qE4lr99q-o?D3-^m;6>&{2}z|N_MH@@Bj@Z8<v_wxzULS3*hvqb
z9`#}gZNnl}Ow|ZiTXhZJOl5*@yxl%=J=fC?g%RD56`jRyAonx{F{wO&Ua5MJmS?+{
z$GqWy+-&MjYr@j-)^<{%32?%%>UE>K5teju_&UG+-GnaB;p0!?ejQaAcytUzQ=IjA
zRPs@Kc)?CygtS6g^t#e%+A=suKRt1jER~%>*}@DX<lP>=f(-XDq_cyoq$@XYXCP&p
zSH4+>R2NM_T4YMMhfvA;v|)5vnFJY6qZ5EN%`eZX(&g)mb!7;no)Q)Sw|j_yah~s}
zPxhDm4}4=MWpS99DU$6X-cA|V19~C~1R{lMtKV_Tv}w&6D(A8^dMr;pemSp@ohxu`
z5Bbz9GIFKlWrSQDNJ>|pd5cVzvK**?rj(?ZtW3|dT}WI)Y%`@w$gk<HMSn*ctqGZx
z;V((7?Kpr778Qz9iMkRN6VVvr2l?#>xy9)Uf6VPB?sM%z(xbK_rdTD+IYGQ#)ZiY-
zQtF*M>yMzA>gd=Qz5Md$(gPD?UMVkS5)UpQRZ1nkMM7_+!s$7$iycGnC^q~YVR#p$
z<$A}JYUrKmU02p9Qvr`4tW?U)+EzzAM~x_W4Pzp_jKrFb1Jnw{5|7pMzV(){fLpk|
zf!of6<A22M$0Xv4+8(_AsqDBR52=tly8o$LRkHHBqG+jQ)3&W!>EFjkSQ|5aU#q|`
zfut`L$xxrbCgvJy|4^x&BJ4(xmML8pNZPSLTGG}9Ck9uJ5ZO>&sUD&hqRpgfX&Y9D
z0x6LHsLF99=)0xfH(d(Cx}V!^luTHtQ+6SBNM)UEy=U0N<0o=6jvF;A0cs<#5~^5f
z$i_7>Jxv#HKZo4D9Gx6`!qeh_z`II$wUd;x0w0QKyt5%sa%Bu*S@sF+Sl$p!K~xS%
z&5_4t<{Cp1F9<ZFgP%JUSi{xokb(p5ulG&sPFS+44nlQaNAWpvu$%Cw+~;=gJKGxF
zX4u@@)15C(ZW$}&J)VeIuw13Eh0W|yHO~95D=6tj&$yHxof@Z-TNV-)QB?g4?+{8y
zgiz?9f82X3Nz3Fnj^U8<F?CF-NjjoCoJ1W{mAW^*SZMUe=jl|+=r!Z&kZ80sc<tg>
z>Q5<oXApHNKeH5OpQVtn05I#naQo|o<Im%E5x2XS=>AQEf?I@hK*kq%W<5e9UL_3m
zE0)T%an%~ywtYK&_p#k5uSH=m)LBJVJu)jx)ll3c$cH65D|;5m&4l{L{XI(ZBq=Ab
zX_2zIIikN|2?uyS&oWG>TT57-2&~=bRXL8eUw7#WSQ5gLQr6o@<i@!qrb|D!w{V{~
z*UJO8S#g>rtC?~s8e8K~h;JPKbLETW+q#q>#w_>D3ofAh3X?Q6H9@^88IBW5%<iYD
z@wW+ON*Lwx?gqww2gfL|pLvFO*Ya#so?XpU@q@5sNtTsC&z`gg-!GSnCrX9=>C@vn
zHm8HYYZke#-a=vx$KjXU-nLYmYD*<yfwao}kNY&g{U>g5@f(+Odp5OsjNw?JNX2rX
z<oWh-KUPp0#(jQLhWS8;%cfJb?X0uty9XYZp*Tbo60!nR?milR+_P)?+(yc&A?i}$
zN~ciAAC)1cDlbQt8xWT%20Jr3HFNsc*$JH^xwC*ZdwIgKDQ=%$$|A~3MpzOstlvYT
z<WD7_|Gu8uoUlsevX{;{Btk`;8A5Uq#r-5XOb(k?t)_Bs4?S^wKdtS`MmzWx^&lK4
z*gYg6G5H}l(p%m&{7pqt_cp{%q}V-V+H!<jgUBo)68j0;mb8wU2H7QxXXt{8pJ=o$
zUQfxkD<tRpkEOi%k`fj(?NOGpuAz9s0^t3QED!(Eu6|j?(hQZU9CdB?87e6oR`A)>
z^fX;~&JKEbYMlC@3RZfWR-6MHlp|F^!*^eozFhu!V#m@WIH@Rl%@pT)vC)ReLMk*v
zGuU}FgrAnz-{!N^N$HO?+6mI{>d&aUSNoTiI>EtGOIW}+xV@F)-5ek;yo1}F+;%r$
zEDgs@Nk~b6XHz0+OY*afhV;WoA}rV69o)KYE8RGGlDe=X7u`S<@I@qXO;dTe`#Xoq
z(60U)oap<)yQ076j4F-sB2B6*iOUJ>V5Z~svuzmmd+Ym!X*4U&C$Uzu3CABHvDTLq
zOHNoa#_-+z_VW~Ps6!s;w{xGr;=V&mJ)TCR#Hy9!dYSY>+z}#)O87#ULB(Q;F5J3}
zPIh<EsgWs48KKI~l~R@wIyuk=g~MoA(lUamMI~i<_N<Tu=<hlTk5frph9oXmN?e8~
zg_*OQ%QV^zyf)z^`gRg)H4aG3_pW-z3?`uw5*7d_vRx!x`Qz{c5<%0~G-x~x!x_B;
z-9wWnR~E~qK$@vASVePVDJjhLRJ4nBo=Xp$9*sTEM}iSvRm^c!twZIbWheq7f5*~K
zksKb6GLK2(@-j4lv}ATb_;96X>!%v+2dvE(R5^~wmD?IIkcJQzGw&#~^v5Wfu#iId
z3hwi@b_<MN(QOT!%o}T5sZI$ACCWRof)?{YPbNd_w``#skL>jVoyCE;&J`!R!Bqp&
zQigcp0P0z<yiLE58@w-Z&DJ;ruYAFB$Y46-*tFRYF&G-{2^rvg1&KA9gnz^uZ^U>S
zC1HWI?%;p?C;9DPQ2esHjN5Cu&sW-sv?fbM!*LzO1ODQVIHpsjlYvXqg&8{c?Co@f
zO3^RN4PU4N5lJh!)-2NU&KDU*l`&m}-?+Xc<@t5FBvnWubD8QErm3v-l+vE=Z3{_O
zNXmIxLKjR2xH0^wQDbTtVM)A~L}~jtXHoz`(|1rC6<?hw6y1^|qMQXuMa|x>l!lbn
zCHxYIPLGe%Q_ek)?wuH;tQC4pk&`R_u6!SIs}C1cB_%2OJBY4NOu;1;(FqkYTzl1%
z(O5DARk?Pfr;tVifgJ5`sB#>M`QFo@v3O|cY-1)q#jO3e{PtfdK8McJxqX29ya9b1
zIku(3RIx;5H!Mj>X-9SNNx%@E=KMNc$kRpJ&Z6{&b#(m50YA{$LztwJ%tyYY6{8+f
zU?q!)Ytqgo$jJy?Fy!&T*)-4_O)KiprO`g%H8{X8A0V+N;{f-Czisq7U5=l}pOe`B
zjEghG^oMZ|I`hXGIjE&V$tg<r1OeZ9lfrhQkZS{f3TM+7UwRomRG8xPOO#e>SF8_K
z3}#7PvxzH6Vk%WXa{V1e5vnMOD>Q0@0!a<82*6Hj#%fn!4Pq@OJ>YMWSj!DX!wHKS
zd79b#?@2hJ#btBIar-d$xtIIi+St+6ALWwkiiNMdpem?JIgd(-rdTS`;F>kGX~#MA
zt%rV1DG|3PJICCh^4KhEIfaa6!M%NHOZs1VBU8g5Ve9g2TAoB@3aQWyQsm%#i(5+b
zRoj8r9s-*`Ocbg*5(Tm`T#dEdxKRl#ivdEahVLg~(~8Tni!Tc4l=pDo{S6&losqK5
z%*;&5R*p@xgd}KVj_`5vc#BElDd+5@yT?Z<Uo28C6_X8NF58vrQ`t96T7G5dVE2+j
zMtK$4;}fmwCs_?H7lv(;t4&yK1zvN5B+?!ykyW1C`<JUQ@^VhMuaFQqFHbm*5P&}>
zL250Fb-lf392gz#L*g$bX8{pc2Icm|tk9EA)8=i1^v#2NsoS<^lM_)gSt%shx%|&(
zkHYtPH$oc&5jO}yxGMV5izT!ye$|ZCX26=O7Jl<H5^Hx^uxzspF-OeiZz2&O9cO@t
zx`-4s*onB2`<EIzz&e42rygidDy${givyw_?<hfk;f{0Zpk;{S5B5A<1}g37;m;MS
z*|v-j$4M#7FU%U=Rm3|(q)AROSy{{ao2OAP@H)eTgo7wj$HbXxfWzGWVmS*UFY9dM
zfB1vg5#+bmQT&(GN8$^7klUU{j;&spU=mU(-Bo6Hfne87)f3Ef-*b2Dpr1{Rvvie^
z7_Sz?`&<&(tiDmBy!tF!L@dO7t|<A{Wtn89bZAbSV35RG>q|HeyVVuEW*=zSh+?qp
zKaczc+`^>wDH5?tae&H*pv!9hAWe&Wu`FGygw&#38~nedUlWY&n^&%)(u#gMb?hKN
z7-jvg@kX_{It0Ur@8`R@yOBOdh}48)=y;!HJ(W;9j<yM~#*)l4z^8bv-rT6cBw^VJ
zOX71R97>;+aQx*=YWMN$XP0AVVlhArp_h^Ytrt@0MgARY!y@wXPhGHmJ3UsIV1h$_
zmjohM=&qb1s!Fm7d&m2KCydfiT}7s>F2iQ(YL+Rau@LaOLiPpZXMcH>Za*QhMwcDU
zGTZiXyNX0vpg3I!PHgxEIKW@<4NO{2OrNGi+4E}<?<+MmbpVUMJDsMD+qTm8PM)Al
ztx`)gwr6g{N>vGehmG?-Z@K<^c)FXc683AihL#1dC20Nsg~Zw#NazOJF*d&THELYd
z&=iCvllR@uU*Nk)xcbN0vydt7|Bxuq`27YBZ&B#BGkvFvlOYmT7NLM`CiBzu^quF?
zLFOsT4GB1^d!;{BCFb&YuZASji`{7yB9@BqA<Hs0>biujj2DtvQ%PAEmA}>PjT=&R
zGzDRW@I?}FhObOGzM0#VOl%LdihovbI(6phg3(3g7@<%S#dJPT+qR!gcTZ1JT9t?o
z_lZN?ZeS&`RT2<Y=~GEsNs?QzvFX^ZQyjN+LabJV^tZZ_#F|RNjU?7&)1avci%Dn%
zm2^n>XT>G^g9v*mw>QD@v=!nFi*7khu2%rscf<@#?~tzY^z^f~Q@%e(6T`<S<;VX~
zvbr{x<dk%5KI&r?AhxkY#_*AR;rJ&nzDN^Ri$TT-!lmfaD&0_G9#ySI8Z)Ze&{Tv4
z$UN}B!*9REZBs(G*Kym&{r;)hbHO9{Impl;y~as|xxl!dVu|V*ms~=3v2-Pp>=|<t
zN;RW-wR7flD6MjzP*)UDWnvvamY-Vk43ir5h0M+Vha}ce5)N^DCDvkNMpZkSj<5j!
zqVD1^_9}k+QEn?@x*(Yt#Mxsce7KqxqGAq!dE!twy-cZ8rtKRxQhx0!I<$Webz4=8
z?eno;%_X5FU1JW?bG(eBCaukM(L`xRh>aSp2J8l6?Ib1SgVu5t)?nj?R6ClIuq3V_
zk?<Zy!MK&Yf!kM^*ido^)jFmcIJTNmDwo}`nO#6gQE4Wq9p|4*w;VY@U1n0~R&dHJ
z%$Jy|1yLvUmkzI}3*Dc}(1xyV+CMo?wqY2(86EoED&Td3+Mo!#fe?^XNCNc)vFUY9
zgN8M4G%aDtLabjP;h**2D1MpYi~lPUzY71afy1i_&%5SR#_?k((n6>TRj46R_iz2c
z08RAv(9Ee3>Z$Z>uV!niMGZ_cvd@KzUBi62<hfludBtkanf3nDqn@0YO{FLL4Le`M
z6*Zaz|CPjANg^veaiom-{8AP|T`ZcGumG8g1{HU9aQjaQ-Ol3nUhelB?tg#dMmIOM
ztmx?<KQVdcRB=YIk#Zn644Rmprt_ZqRC=s1O*uO?YtyeP;&$%hcK_ny2rK)>T~FfF
zOo4Xvt)$D>Y@pwa4$<8whpC69EZfVQ<?Njx^Td3Ht+71dwSf{{@TEGdN;ecieRs1v
zW;Zoq0sI9%&R;l^{e6ww842CCb9*26d(U#mI)yPoeO-oeBqxNcKqV}f9a`PZ68hRz
zG(9;c_@Y|Mn7Mqhk_arx=9NHH_;|)Clg;Ys%1jqMn~ADiEYb~oAEDz+tUakTIprdm
zrd1-tJdh%zDb;X|0K6ui#4qn7u||@BVCKKZT5HUx7LKMTED4kmdJT!x${P~;AkrKX
z**o})f1+U{tAf+hBW}Lr1RP;_Q98Wn%d~B9kY|bGk(XV$GgzywDNb67JFoIs3{g#$
zie6^Zohw$+j-EcGj-WfAI6%WpR7l>Cg%rr+_Htoa#;9qz_kR1CFDT6UC1@-gcrC!k
z3SR8LTcsN|uCTU#+>k*n5-mYk(skiBegN3vfFs+vG2M^|5Zkp|W#0I^mpdiR6GNw%
zpvnPV$P_aO!&!ayHo9l*6lLSWaFW!yxc5o@syKmS7og-io-Hb4*|a8;r3?F4(rUw^
zLn9+}+uq;Mk*NvFv6O}I8&t`0+@h$KW14Q-upZ4h=H2uCJ~SEwnJVUKBn<4oRi*1g
zBr-7kv>^kl16qQxLih!@zainukYqf>148nAY~3#FgDB)D+_YEsJz$opLV?cPGDt(V
zNtsfWoxxhAt1uZ=GprlJEg@endp5L<Jvn;v$~Ckp)kXP<3Hte?kI*eAM`?m3Et5&i
ztAki}NYqT_|5ymfHu?YNq-j~VrR~(=d3_lgjReRFYoHog!B+KFT86yri$O~fmfXF#
ziGM+0K*R${3S|4w+&;qnUbURb#@6Ikrca+bl~&d(5Jho%n$~R{q(|Y$q`cbavRBQ=
zvpt5$ijG5L#Tk~SERUpKbmmz!z=GfX`}Wc|AH0Je9T}p&Y!7v@<d>4k1Km<dlpM1>
zsme?0=a?>~Qs(}2seJu6E`L$e?j&_Gc+SJl`w>d6B?x!{&Ac{lY|N<Yhn6C&5I#%7
zmW42$BrydK?1TIO|A8OOBMlo_2%B=b&6DHfYxCuz#~+9pe9HFiG?we4($qLv6ywz%
zXOp7PXO#pNws*<T;Q0lIRS;xfx{J2=^wK%p*4b&AI(3?Ey7h;2|ItG<G%-$HnGCIB
zmC$o*Ws*XEd8mG_B??a<k&NqD<S>!hWaL*`*5~_EnPvGtHL8Q>I(E}xv#Lf`@MK2*
zxz9FaP<2L25*8ECX<2y(nHwP1CXv>wxMk$-;bRROphUi0>gH9S@iqyWKzdRs+PHHE
zJy0x!gA1!mSwvA=R3$=oscEO=Ie8ASnzw!RD%#n<f>xGX8Xg*=2OqkJzJK@-jj;Mx
z<UW>dQC}+U+0>jO6P2`8xt`kRiVIr8Y1A<tN*k%E71{K6*4wGCe&xk~pmztG3_QoN
z3wRZ`msRNovO@X14`B^8VqEn`OA;0!t9JYyKPcqs0eQuR8o<s4r_(3NP@kI`>1Q%B
zG3lyoSlAgH92}%WJsFxgeaed=j37o*nuQRNm04XY@%-}==`j(mWtHx{-T~Uo(vm%0
zp#A&z(~oxDLA&?wqsc;nvMfnuxPg??h+Zzs#G<BD`E1KO2I6w?nZv~8xUOkilUY0c
z&_E{hnN_y^?XSG_)lDC8-bs)N_>d;%DsE4%(iK6>@U!|%BgVB<Xj#GvK~?bhzmzO#
z;X#7bdbxeM5rYDz@{?}a73qXCOe)z;8))y?sc0C^JhCUCYk`RmHYxZ?oxPH!sDYKV
zlGV8Bk(0Fh7x&PQAAg(<4G(j_qGy6irPI{Qk`&++#ZDj68XGJ{xt0T;Dvz+hs~|6f
z)jzUbxLQnSE$hDSbmj-$*~~Z1uIyvizWg=XjiLDfE#ht5&a2V~k`)}Vm#x}Oz0mT6
zC1VIbBlG*fogs;|@IXJt{f;4zd?UtYKx}c#CMr3vU$d4@W>VBO6EaSP?No80H1cl{
z6n5|M(T;&t^xK;U>7u>?8a;S~ezNOM`pPeVL3<A#WHryGzFf{Lza@OTSm9%J&&$Py
zvhq@z0#O-KigLX7o;6JrMm5co-Rbo1o^<L5nOxu3v$_5QH@y76YXf@|g6A@_g+j$k
z3S<UARv&G3$x5N+2`dCts>QA$ia;j)yYOH?4VxCfeup38lEuQk_V#a@!w(K^+c$H3
z0LJXTGdIx)951W+Q~}aQ3WjqK4}7+^clXlP?jBlirfF(;g!cb%7hQYbeRSa1QJR>V
zqONp?R`&OkN>vK=)8{*=f3Qozg#vae%Oj^EQ(3{bjDlra<Ed17m?g3MGU?2Nxt^W}
zvYFH#JKgof^{=^NW~sg(jfI2fFMJLW8+bKUCoAj*!odFFMvSWwXdA+UO^Y8S9w2h~
zK>drWC=Hy=?H{>q;{Mn0dBaOFp2>Wcm9FX4j^kuj_VrV~zlX|&3S&FqXG9>%dq#7w
z_$r;nlGNr@hPtN<bad}Ny7!SsS&BM9C&$OA0M(BFXQymh!9=BU!+T}K4B?HS!matG
z#1u7US@yV<vQAj(^oX5GKW?V%L)lE`NG6pzXxr9d%A|*kj6MFtKl>{k(A>n}IlG2m
zUQZ&BIVtJ`z;lEe__<a!u*aco2n&!825KLIp#L|woe5p>py8|XEbjXeKJO>>9?OB#
zd&$a|;cMmgZ{0$tnPkHGqd+btDMe-M6s=%MYD-rSt>fRsiDSp<z%PGH-`=~I4jw;B
z)A<5rvt5)<rO0JQN~hBv$3fv^hALQwIm0U6lxZ4crfChcS~tp))Zw&k4s~U^_ovgT
zA;YwXS(-Y*95?24WyWrQ>$_W~kcWl<&(+^1VXu1e99<tK5gT~Z(vPaKXe+`B;Xk-t
z!R;FqUsYNGHULOk|BGMms%JHx<Hz%~#+h-u`+KQ8&_@RBNYWk!qU!6)(%C(|wAwYP
zhoz_!2aeD~Oi(u;JV@gclPpCQykvPPCaD!&8OJcpY0Knhn5Qf&b(+<=!>(x_aUJ)7
zowi3=Qaj9qHsl!AXfB(Y<{M3AGTk$2bEc3hm7MFY{s*0IuSFrN+dPBYC%HXoj_!y+
zz}#=j1bmA{TN0M^h`*B`G-3-8FrAcY88)w{aQiAZWQ6!`y~Z%u-)D@S7)|9itTziR
zS`|x<XY}4Mu!08DUDP+3r;+;~qn|zcFg>t;pSM#05=$A@Og59A%ywmlt&}~SBI{7s
zK>v|$*L}h=vq$WlbtvnWhs$>Mm^nT@ar65>pe3dD$4j_<oZGfJ`hl$ekmvuMOFyLL
zL0b}52rA11c2bZ}E6ITX6X6pw6~`C(fgfA!jkm2@+dG`g?ilIqPMNH{onfV&zGAs#
z?LS;RGIC=2uA|5DBjcw|Wi0!|SsOPG8RQPLmUq;0=zyI`4W&x%P}w%dEZaK0V!Aw)
zNq6V3fB*Y6Idu?ZHr@Y0qR{D<DqSHxBcB!GY+EAh!a~v3ge9{)>_SW-iP*#6r{sS#
zCIrG7E|lRs_b%q%xxTbHp6{FNE0y+Vrl&^SvB^UxC#DXMPfZRN^7%vAo}Q62vt5S_
zgT|=nPTDCuZ_gA8j@?z*b>(}OHOqv?@`L9fB!86}CRe2^=E}9)-qi~EtQL#5CM*Sh
zkb8Lo;Fk)bGIkQ<3R?h}7$CQ&$sNaUFLZ}xB)wuZmmj^lYbO8knX++;$UHrrPUV00
z=T~Z5l13tU-l4o5(kQ|8W^j(~i1t7tfX_F3rqFt!BM1wS>6ZVQL|TojDA}$B408Jr
zw+mz`v3bWKe&f<-LVY{5fT3!1C}cd~|K#>+Zfoc0j=6Oew`-a?2YbEIF@y!k2m1x-
z_V5F4eO0<+!n}psv$_A<_}p6?F-DEf1kbVOk#M!SsD|z+a{Bu`CtE6)RXxyAgr$H7
z%@YJZTAv_cBj~Bp9TN!U#1Pu>&wTDsBgUxF8Q^(^AI3lD_C{{&=jc93qI~?Do3Y4g
zBhZnA1;`515Wi8Y?SoYPyTC+38k=+ZoKNt%KWoGoHQF0ImryDmIo)1F)eY+ajO(zg
zezDog$2SrkOIUz>@E_%g^Gg!;fM-?djtTV#+@8bz|D9hy&F!J3j7QXHKgc*h)FgNl
z3ID1!HJk=l1yp0ceJRJ*3g~FU3Sk$C_$>IlAb7gFN?%Mc>^NRRLRG{Ljm{CJF(-Jg
z43O|bhi~8oHJpM>B=Bzk9JhT-IJB05CM@#(wJ;&x!INqizoO!FwU8bF6Ao2Lu#<Q-
zUt`bGj#8tQ!E*#b_i$BsO^v6(YyAz4N`=%a(1cY1Oc0)2FCd}v!N!o3^+5p>@Tq*x
zzmX{RdVsH?)3RuQq>wog4#{v+K<3+|VEiy(Vt|eGO+1etT*BeCBs5{g0275L+aHl2
zBc$l4wu=a0BEl;f!PH;lbHCb7DLpji59t7k`2(^-SXicp)36JO)JR`l&T3E13{6-G
zkQ3&^Jn>Ln1f&In`x#YE!Gye2wpa6cNJk4_uLGUr*w@M6XO614kf<P`zm~*Ys0Em7
z-{f|+tW}_q08LnPKqdx6QPvws*sLz5xwEiiq9P?T46I+|^RL&xnC%T&5AgR$Y{<Y~
z)nCJDu$}&jL~8G!cS?B8VxS4D2FQtoAnNDy>-$LTB+dm)*o$Smg3o<BzuwN*DlXkf
zH5v_mu1HaIIf+oNTD;W5K>FhM>RsmAp$TgqkQ3|8JV_zGBlF|4skUEIOk|vME9_hR
zdJngwd_A3&p#{Ou5bFk6Yhjy$oeE(!wafzmw#^@L`$#+Ity(H*!dd_@(Rk9rLmt1Z
z@2A>!e=wn6L4xG&<90oWkFRxn=|-wiZ}2l)M<SyK)IYekR4W2e38XH57YRvwbP0yn
z_Rxg2K*$Mq9Zz8R$-p50dJ@05)tpWNOz`K(_7*-LLDi7D_HsL}4fM?gX-Ef2A<3hX
zrsm5083vp`kzDUf+`hrjccSit>>y~uS|sEIL<R^1rNXTN`Qb0A@pMdlc-JFD;{k5p
z=j&X@*L-402CFeI@Uz%VLMleAAF|O_t5OpOgnXgE?+^5*OMRdTt4@&7^VjesM-F+U
z2>}t!<-et{K{ot)zeT!4e03ptxHJ|InU@OE6kHRkr6x`S{Hfp$^EPd#tS>ZS)ft$e
zJmHaB8!7<OhQQ8s7KwrvwEznQeqV3o>!AGD%_M?f5An4pmte>p5B{F<!-9m42!8(^
zZYZZ!OHgtc*!@L{Vgx87713@P@}*HnXu?_o$ceg}7Xl*k&nMwXh^jpEQ7N!skSZ5y
zCKkdk`FgkUE0VVD)3&a~LE5Iaa(g-ndm_|${IJw26^8-o8dYuJD13iC%f)F#p$TgV
zAtx?&1n-j`^DiY4QwBE&<k&K6xC|E11+u{@5mMH#`FdC!KjpTc+c7PDRfm+K@SP8G
z`z;bbB6to9At*doR91p99WkUg@b^DfpOI=*gC?v7K~Cs@h1WZY-NYAi`x9=f=6NYB
zuxFAetciSHFy=nQ*M(2d9o!z}dll+7@D>JtCkU51hs5`F8Hqep@JPo_?Lz1N2@>gE
zP*wRJz3bOlXu@hR<OGLJ>c_mGphh6$BtkRN^Sl(E-Fn$TfG8RZqPkbQN_gsHr%7H?
zl2U3OHZf2xtCqmyxqu8D2+cyq+2J}|Ph$blgtd&26aQVj$gmJ#uR?x#s4KOqi<Q8_
ze7bCZ$L)~JrV58eyu#K3|1mhLPPD2~nEy?P<wOQp_(!cIVH<=EYNvdK0e!J^Td93e
zyWz63;F50|^@Ap?CV*TBUy>m|kd~mnz&Gn@wD4zy^9CuXZ3oE?>I?`AeqN98{b0;L
zK*A2TuUS<|soKFnK1gC06~^%$+~6k#!h%{oS5EX=f$!ih5+nt(`gNyCsm%;cSWN`E
zFn%K2hj^hP>nWtJmyxi=z|quN;N^3&VZp}*>5lUKQ0oqvE+L6Qx;Q9b$4S(4L~=QJ
zZWm-L$_90*ESsYwHz^63a?EH@dsDJyWJ6>Ck|bui^^%Y-&y=r_obVk$Vp_StfA?I#
zm_gh~mWK+;KhP>)^Fk9=6N48H$m4S|n<=CUs66oNdanGto>(bcIM+CcN0C&`gvH}k
zs^)wNOTC{feNR0AlKLSDzp00~?a`7{^FtF>3xF3AB%FI?`!^}Mz`^nLB!Y0~Yp|~s
zxKCELb^wU=yWFnfc2ld`@H!cquv!pup<!G7CRsKL2?Mcp4}-l@p-`cv5t2$X0^bi(
z0Vx$1Inv?s@l#!vt+k;EtHmJ~Ak>=MnY>^FQiKJS5nK8QH$eu>rINy$1(2Rlxd<*J
zkVK*Kd4we;RE;)(CagAsT$m5bcB}ea`X(Wu7a0ehOu~V3m24|WNMrTzRa#2GW(KJV
zInPhX2HVqa5}7U@(>AE~hbF8JfLzGR2BzEu!i0qew*l-RZj=ok;q~xmnlF&u0Fn_r
z_z%kl*9+8*JV_zKYF0N4jirMotPX@+=tpGpAW00nbTF`YQLu9dGE=@zcn`I+PrfRH
ze42vYz3?ud+GWJ6+F6{I4btG4d{rbgD&MOe$-I0&rO8PH(1fMoK@tL*E;FUkw9tg5
zp`p<-(1fL-q0utXgr%XO(K674rJ<qGGSGyjp`p<-(1fL-q0ut<|4|EVJ)d5+<p2Nx
M07*qoM6N<$f&x<YhX4Qo

literal 74845
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

diff --git a/website/static/img/app_hiero.png b/website/static/img/app_hiero.png
index ea33f10214fb3e7aeb88e069ccd8bf4a64daa977..ef27f58bee9bda7acee84c393255cec74c0794a0 100644
GIT binary patch
literal 33079
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

literal 40175
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
Q5dk2Ys=6vQN>8Hx2eo3k#Q*>R

diff --git a/website/static/img/app_multiverse.png b/website/static/img/app_multiverse.png
new file mode 100644
index 0000000000000000000000000000000000000000..c0d80e4f1bf6cec0d95451fe51172cd8e4a36333
GIT binary patch
literal 4814
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

literal 0
HcmV?d00001

diff --git a/website/static/img/app_nuke.png b/website/static/img/app_nuke.png
index 4b3797af7aea30fb37b43c7d94d91a249da013bf..1465da8ce823d72303087250d3fa74453c13aa83 100644
GIT binary patch
literal 32869
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

literal 25887
zcmcG#1z23$vM`9d6B?J`*0_6ccXw;t-6c2#5AGxc2reBQ8VDi5-QC>+fuPel=idA7
z{PX@dcjlX6f8Fd}U8`1k)vCQZPF+<F6O9B71_lOGL0(!D1_qY(&kF?!I^rLk<PH6Y
z>LzdC2?K+U|K|k@lbcTj1B1L`udVN;uc9nu<?764VeM)OV)Ju$gF?f=h=}{SSy(xO
zyr?Wew)QTf)aM;N)KvD?qSSi4DjX_qQXo5f`2Y`)R)DIuRe+<Fpf$C)7?p^h5EOwk
z$jgGt&)LbvQ^-%0`Y*gf(EC5b?9^0$fp|HJQos4LAeFv~I+c{G2Z)N7jSpzW$-_&<
zFUZEp$IT-s$V$b<!70GbA;8Yb4dmn#;^7eD;-dP;A2oC}4{IACO=;PGtOflfN^R%m
z<tD_=?(6Hz=F83I>S4>yDJUq&&cVgb#RY^y06qO(ye#~HE}k_1#2^jwwDPcb^Rjn!
zq56Z-!qU~-OOzT)>EA3kyZsBTi|0SY1Qi&&pM@JcCmY8fmi`H-qVhk3Iy?Uh+S5zM
z2fE5X=>2aIdusc;f!H-cp03^=Rv;N4kc$`1KNoYebM<odv~&I6(Dtvd|4$TJTm5T6
zH*XK8zr<s0#SU@;IYV)KLSZ@oqR&l8$^&HK<?5mB>gx1QMXCRDMJg$&zZ65osAunD
z?dt2v^oOW_%mGPTc!5Nzp^6g(atH#sxU@Mrgt!HTxCK}^xP&-3{svWnnu4{3m&LyU
zb8-T?xV1U?g*bSHc)3_OIR6XS)!N?1|33j$Q4vyb@$|BAu>vVbi&8_0Vzalm7UJjT
zx8djG<ONz-Tk!#{K|B^f3mYhLd;$WToE+BtHoTS=f6)b<FYRjO{YMyo=KpQE)~;4i
z9RCuikfntn7cYm6AdugRpBKn)$-@N{;1K`;`2_iFcm!<(tpo+R{)tV^!yf897Eb?;
z^$%6nP>g~+9K2lIf`UL^K5Gz=hl7V3C}?TJ4dmhHw6NqA;N;@66riU1uXUwdom@Rs
zT&<zf<^K0^1t}?Y4_6y|C+HWRnsSm<3NliBoPvCOKrS{;YAS0hAsbf@XA7vU**ja<
zg4o?$Z2wq3lnf}l^7fukHT(a=m$X3c|G0Cqr~1o4g)FT8_=PC7)gOZZSyTUG*#5r}
z^MA(B-)Md9Kv1OrgO&UZ=ILtV<!j*qdSeS!$$w&q?EgFZJuQ6xXX<S%thj8rIrxAA
zPz3@lt$08{L68;HD0!{9IJkHP`K<W<#r^+Z)c-@cR(2LHwjgMzWvBjs&(D8m^#2!a
z{P%A7|3Djp{~i|pp7+1-!~Q48{%vaP|Em@Lm%0DbW!^xY`Hziy{zJ2p7PkM=vDkm_
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

diff --git a/website/static/img/app_nukestudio.png b/website/static/img/app_nukestudio.png
new file mode 100644
index 0000000000000000000000000000000000000000..dfc2ad5a9745a5010589f7292a8c16f1097294f6
GIT binary patch
literal 37527
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

literal 0
HcmV?d00001

diff --git a/website/static/img/app_royalrender.png b/website/static/img/app_royalrender.png
new file mode 100644
index 0000000000000000000000000000000000000000..0e49519227003bcc031b8267315266c7da9e3f9d
GIT binary patch
literal 11650
zcmeHtWm6ms&n{Bj-QC&6UAnltEU>s!tmxuWT#LI)aai14io2Flptu#60!7aK{EqWx
zCX-1r`EpH?NhXQWR9C=4Cr5{agTqo%l+}iVg9rYPQ4#;MsFwyQ{3qZ&v=yY`*C&9%
z|0!s$iVzPtI1GaSF+5yO9w{6gBAlkGuH1jl|D*py;Qw0$nz`?y|0@<aPi=J_I0Ob;
z2&EE1$QC|^`cxf~@b{M@cs^<0fq(CNB=L7Q{Fn;4OBq1_4)*F|ebf)7ue5q4m(M01
z_kT>!<p4IVKfQVhV;{`4seV|k90iIg4!u1s>k=iRG~<n~QumLM8o2FzLS(u6YwvR*
zL*X0)ODK0=p9a%7rrzctr{H|~xE5-OPJgiZ+m38530veilF<k)e6Xjxsb!n@my1d#
z);{-XmMrnC#?0e56P@QsfuEEiGr3N3W>jI&32QCX_>gTlZsKd#2B=KcTe3o}O(-ls
zdj5>Zsj2}t@4BW^pwF7)v%JLOt_4?`;H0^0FsFF7rbEC&{Wq<4QRVc;h~LYoKj7fl
zaFk@Fbba#9O?=H&$7q5nLK#sTrR1#%>U5J^6Ow3)>BCoa7rXXM>57%p=cB8m0V$$2
z(C?d!x^fYshRfi(Qr%y%4mH(LH7h0kZ(IJiTNh%sTaD{8Q}PnQ4VS&yLVShOxlgkJ
z{kO09;Q*<lawwKD>cOO=NtiaqU-Xx=*mQC6)+(i{DE$L=aOc|AO7*|xc}H-rHfFxd
zjA84mB-Jd(dl&owZY4NEnJM)2<1MhE1mtf-@{$+Q^SQ`oMH#*z7-lgn|5YXnU`0Ui
zyNI%9qXlwHylnGHWu_WJ{(F->-j=DSha_+_M}_Fqk{~^I6S(`~&%Mr8qp7)AN|g*D
zbQ4dJR#f`z)B!D!1)GRN^bEBm<%52?yy2R@&WPtu%FbFkcOR`(hKT&xvqS9jrfGa&
zl|SW_d_Ya+-j#8-=|Wdm4n1=d%2RzKG;3MXMsCjZf1#w%yWnR-<&M)$g}t8{_&)dP
zN7ZJbtF1teN?i6a@cU6K%&JOi9L~O4bq2-3L=J05q*90QuU`YBzD%UyIR7wzb<ODf
z8b4yvk1&slU01fIpKCP9x)Q$MZ0}bHONZFdO<OnTg;dfgS_VFypVqLMmKm8%`JKPz
z0KvspKyp0;mH4uacTs<ca~@FNg`dv>V!;8AMvBAbd4RZI>2M_P!hEJ6r|R?UmA(VF
zLTLJJeA0k6h&z2=m<LbQj}JT*>liY@k7U0*x6B5Dd*lxQI9C%I?JUbX_&SWn`y1_b
zWeS%=CY0;(G-C5~LZeT}QUc?Y#UkGXWX>it`TeH9<-AJQTQol>zvGZqG1$%}zu~eq
z@t&BKcN(tsg%{725DHtEG`)VYKNMR+vowWfYsJw!28rJT%tKaNx!f3m#<B@u+Mw&R
zW$wafPPySErqpeWOj^Kc;Hf@QT@4J&5``l|qDLv4zfZ>Tw4&^uci)ulBUx5ey=$iz
z5hoETB~E0mdArm{3dIxwT9e_}3<SpTkaSA0>?}LA8hi`sYDPeVAC|~0c&Rq04B@%8
zNCx}wD5?Y}<dt2AyhtE_b2T|t@&|vN14Nk{*fr(1g|&yw2`M-11&z;?29F-OELSF!
zA!FPMqFn@x|HBqa9S*vhPweuvKcM)ggrtHO&*g%*WjM$HXhC7$Sc*9kiaTsaeN#0k
zl516F5k-poj5bcLdy~#y7ma_Z`KpkCjyjI--OG!qqT6b3bh@VT^SN<oJzis#cRjt?
zX2U2s`<~AZn&5hW!rR&aa%2z<u<4|H!jx`mn_@ECTnba`Zb}CLNObg<cUr~Ws?<SC
zM!zWeUdjmkFMbEN6!Jq=XH=-S!~!4H;3K7OI_W#fyp$@iP64cNe-faID=L)!)u=`Y
zl94akKJ+Y4l=jKX-N_x{j~uW{gd3qaBZPs9CPDjGkt&H)^&Fx^)<L`avqk}LU<JGh
z`?;0({m;q$jsDzJmqcsr*CW-YhH4jgUbSl4>>5I8{Y=L<n#{|Bk$5u{Yu>(@86gc`
zd+en~Y~<O(k#nQeHW3&VQ)nB4QKC$I45BbFpX(J>XpJPrKG32h^HqWDF`~|s<KNOU
z*2`%anJFC>QBqmW)D%=#oAGPe5@S8VpHsNsLgUHKZldLA)i@8n_-2a|ekzA5JGq<+
zDnC7j3+|D3%}1MXs{+a}r2y*=N9SRY4$#GDi@U^n#-_4Mq8#5uF=o0^<htS%N|rH^
zEMf8W9G8gU+<oyp^T@4Zs)$?m_R`2dsULU}yQ~ai=MGlqKZGk@uv<8LrYSFk)Ap6W
znKgeGsv!cv_`T`;VLA<yd;wK)%S+6-+#$5c$=<ttgRRn+Z(Y%B<aX5-Cl1OnWVTJ0
z&WVU}c2#00my&(|X1t_p^1^>MnDNla6v77`DGJV}wsRVf?7J4m3#4N@yJFhe>yoN*
z3OAz;)rfXqmYreoQF*w=<)MBe^oZ#dSAblobzrLMbE6FP8nzB-$?b7p+!;H%XBn!z
zUHTRX1bc;9%8Ep_jb(Ftm7eB43S8Q1xIQ`ONq1)WH0)YoT`2xIWxs~M!=pVTKQa;x
zQ^e7Ba7%|>3cOu;zB1L$r-5W60afQwY6nk%N(9lsR7=6){VS^87GDjwXVyx2B!w<g
zSL>C`V2rRDPI+R=W<Pd~;Am^_@eru!?wK`6L9H4o(LfaxuLr|ZDdpR0C|xBF**ZBG
zKegLVQNO$oJfM-+DoyAUNvtVdZtK#QJ(%P*s_g|e$B+zq&Z<A?_kEM1K{VK(F^0e>
zV1OClP=$=}4^vUT3#<<;y_WG0U@fDsjd|5qATOb6SA0#?46)1_8ltHk+xgt|@1H_C
zy6HC+Pb5F|I*6fgabm;$Mk*6oa&aF&t>o9ASA`?zldyMQB!u3t5N}kGn}ziUqkmUd
z&-iL|g0+%vW&^hVP^RJZ0EukA%IH%V<ea?V@7&|zy7MnbNt&X61ZMCCW4!)wQ*#5!
z%jwibAk2Td(Wh62cM$0w_ae4g$uhc|F_mccz7bt|@!bY>MfTbldU0ZbDGzqdh0mj>
z7xR^c*4e(glY43MJ~iKsOSwGT#I~SjT=vcEeLcL+1eG81TlH>1F_C3PD_V9zty^3H
z7MA1ny9Wo%ekMvBF?V%UW*o-Te>ip&nikz8bR=*V3UyULMqN2ync?X$$4>a*Gg`8;
zvf}Q3zip~7tWz&l6NZFN-*Q7G7V=+2;vZ_Rb8Ak#9c*=0U@EaV96N`4D@K1F%Dw}x
z{$|sce+qve-83KfMLEBv``!C=w(jf|_YSPYnPeg<@IEd)H~z$jA+6w;5eQOdk>?SO
zJ`Peq!6D~Au3?U|lP|3*d7d#aYVXXAGcn7JomRM<VcBlm+y5-@tQ$jnu{3lAr>}FN
z=@a#N_|Rg+5GcUv)PYe3tv{Q%i4n<CST6bNi^*w!!A<h{t9N%_OPn<z0@Z+bd|Sfj
z3a`_d0_4SXSKe(vm7NZ*l0#3+-jbuvbp^&^FIX{-LyKRnK|N+A8Z7YZOVvU%wm1@h
zmaLn7*@M!;P|Iczhd4VOHxDh%%?X~YdTF0?KZI63T2LRlrFVb3f=Z9ppkm$n)NL54
z0!`?TZYDgbV&zc((V-6)r)w{hWv`83DX}542muN+SLK~-A4(ibXuR!AoAq;Qg8CDO
zRtL(G9)7zbUoapR3uNo!9Uoz3k9mmw-ZEF_*LZ_r`UW)^$A4UF@Di-9ig8LjZbZH(
z6*u3$Mme?r(XrMhr0&X5Lnb#aT|m)J?iLP|NwL`sq)B9SY{GE9ts3~?Imbo~8PL@)
zJrpLwcxIq*WN@UOlqUQ_^#^0#I;27REBU_ah-C&>9HcjL8ZI%HW3ZcCU_3i3+P(%_
z8YuAGxl(!~K8=Ae`MXk}6ziEUcaFIu@o-l|&qkO;Bs)}azELAvdRAY5jG;FcGSkju
zT3HHcLL+7<i0pUmc5`$#+?O>N7nu1qyt~TWoFP!v`Kie%bd_^NM)~%SJ4I<MZkQ|3
zmMW!*+c+eZIEJvPV$_)ES!H)L$JCO#{9+_oAO^f!(I4l-9*8;&#cS30waV~E_W{xG
zv7(!}rj{($$3SmW)wJFBfaf)U>`fxg_b`!oo6eAzz*1Af=QXKxPeMmNkjz!xWZ&#1
z?k$*!AsObvGDsBt_QiKt<xbD?_%x&KBk$67PU~2<YqN7s0tS6b<+~kk_rT{ujHew2
zF8pc&4wT9otbz|LMZ@-3|MmJG;;i)$tg>p?PyLPd@wJOn%k6w>ncf69yRTZZ<6dW_
zHd-lVUCg1ivqp1|_#=P7aK;^S`|-1R#+yI)^sW<iQ?HuyBYS;8d>-N!z_n0Nv%POr
zKCWtW%jax@tB?NXez#8A=su{_y}X%D9?esNwx)eEAG6T3f<=yYr7_up|47_hEtqOA
zHw4A3w0_Rs+nJfR4iaNMEA9MT`%NSeZAmWS#g-Ddm6b*AUcsJAo3c3_6I<*qVGAY=
z<F`*DD1MJ&riZ;ki_w|)C$eS^UzqDyaI09?U_{ZT3}Y>Px%HU&v;jwzx2{$a{g|Ji
zK94!XibnCt_#KFN#vyO`WPY0!n7Lo(9(cdi(W35wCx6v$EJ(5qv+W@fLXao!Ri889
zmwiW<I&O71qqR0zLgvjtl&sEHZG?3_Z+g$0bZ1*mh^ls{>B)6b<v54@Pfzl43xVzW
zpRZx<w4Dh5d=@~9h06p~@aVoh4GV*<NH)?mhg6}Wjg<EjpWm_vLgYR*4Op8-@pE3I
z%HGj8;p#Vk)x~^0r@x}Fhi;|v7{eoON36DiX>U(rt^7CPcpv>D4FbZ`m|l9qq<-1z
zw}iKl&}bn1R@<VQvW?94DYj#Tldiu>L4Jb2(#XaqW?VSJN<rwGLasp;ShUr7605nW
zpGmBKV1XMpIWll@(^BNo%=Tx=g4PRWcUUq3hQ68@NQ_OXpU2JkICQNl(Lqe#tqdRm
zcm+H~uIq)LrYR>hYR6{OlWn@phM=qHS}krHdK*}K64R0bV}*O!br?_9B33G0r$82o
z^ON196j-bL7i{lpL#C*tBT~Q9U(CX>CvyAWL(iw>Wp}9@Z$3Ono>7%H;2a&VMs8Yg
z%4}JzipZ_7O4mNn-I3iC^=H*cAZG82`tbfJ3%DgjOagL41)#~Mm$Whp{CPW%)_52O
z+4R>UqJFkqqZI2)(t5t-PZQ^&UQQQ-li*^uD;W>Fdt)~4d&#p|_nR*XR4iT=eN$C7
zmTaszLSG~e^bf08YIv+FrdX}Nk&(Fn(gc3<qb1)?ry7v6#?x}4U3{<6I#8js+$(wT
zuEY6mjW?PoYX??c>?4@Ml|AGJi!_qqTH{sSM&x{-BNC?Oq;MtpaiwLK6V<3NyVkt5
zQmYNHseftyQmavra*%L6(Hxo)#(W}M!Du^gI2q(V$9=N7%@p08i6j!Kk>RFgB0rCB
zVa%Tr&953}ma+0=i_uXi{u)dc4(k@4Dyg9DN^NXzNY$)V(M9y7lE9|xX?E&s+3Kro
z|CWA<LXLaEx>pxvBSH9AWn9yPB_=!&?vG>UayVb!!9ih8)}>6gw3qw={AK$6L2)j4
z^mNtxCXMay^AL2$!gA1;k&dzCaxsBbsn$^2eljg8*syy&jkl(>$U=P5;2rvpBld!1
z)Iot3GGcNa#5=;kzzDd*`DDER`bge<Lk;_3lcutZ(jh_g-lk^M_+|sgvDjAH$$rBW
ztwzY#mUWl`wC(+Yt0lWG#nkmRbIPs15M@9AX8+w(QD<T*&B^5tiX;@qmHc6}qz|*|
zTyDG=OXTGdM$*F>wmI)6H)R$ss30d$6nOp#F2yGsICgU6uTs91GmvT8nnwTx^A239
zYN%}UNh}gGJ(*h1I8TQQaZ||N@O3WrX-@51$RIbSInKz1rpLPd1qscTaoi!TT@Uov
z7776hG?jSsbr%-la%#Ddg#1Um4~*r0%yxV2-wiAWScs!o{o_^FbH(e7#oKy$GP|%_
z9}zTf-RTNfH2`|%-6)a0V=nzeNCI@|Ujq{2#9jkoIKSkKYtFgs&}20yxm@k+R$BOr
z^0I0>Dg6PL6ffU3T@sKogF*)ue5D|3hSPzlqZTyeR{99=_!35mYJEiEUB=;5(C8B!
z1fIl0nB2P38-yU$_+5TrzNyb7=N9ZzyHS2nqB9SQa-+8Gu`{WO^3}~q3QLss(LZi1
zXa8@W>dL&wB8SxO{Y&&aJ{{!FM>k<ktgVpWwxQ|iz*g01fvMS#iEL1tzc=;3@8M3j
z=6kXG&vH;Ev_oL0X@Tczjn_P9bXRGs0&egP4h5P|2JP=5pD@8DC{uUz>smjM)!yIc
zyQpFCq>7xHXAT|6pWaDhG-75xxoL&a1I*40J5Vhv8N||CU=eY&c8x2qcfm>DY2XNV
z+Ed>VaU$Td-YK?;c8TG}rrJ)@5qBWEUQ{&r&(tPv@U~?;+fGw_N=8<)$~l~AYb+q*
zfMi`jm19HuRUiJH=ru8ChdY|gw$*;Rk2z_TAqUajph7(QQBS?(6E`s`X8S+cp?Ny<
zVGIIY0Q>41-0$@W{Z=zad7_8ea;!C(vl_m=L}BhFuTjR|goSy}$ZvQz4t7p`M5$)~
zB=fcYde29*1+B-~9T13NWn4Z`A0EqjT(VQ8-M<yi;2!s6eBJlTsu2%M%*#ihXczdJ
z_D@@>a9ZTAhsU&{^|(ZZ)kVDy61Fn|4jL6?QwsXJY*a{ZtgKNTah8o14Tm%w43vF7
zrDkU2nVOzE_Gp$@itEOBuzsWe3=g-S{K94J)h$EuB;&66=VP*!1o9<43)-HDF>8)O
z{pUR#v%sH%pJuF#X#yzI8)qv1s;KW%J<O5Sa;3eD^?ai{__^;LZ}U(8G*-prDkS&I
zn6n#%&e4r{n=z$3v7yVe&fsa|FUhq@+&<-yo`>3H9n){QEz%BS<_Et^Nz=&sD!y41
z{Z(b<YN$46B>0YPr;>#3<WG92Fa6W0i(U$imw`rsL}A|9;zII`m!MbE(yYGT<k-R#
zY~)|5uX@_CD#GKhy|c5+w@P8acu<6x=}7`r#&L?Oy~(L4SA*8P`@SSoWM`6?CK-T1
zX1wTHge9-~T7O@J#&ej0$+f1d0!@$=A7_FFNzBe9{Yukqg~dd8l**r_C(3(*V<fN5
z36{s>URZ~<8Fb)P1L_`~u(N2;a1(bGAZ6m6N|jy^GA7Z-2=X&?n-ySlwcphPyAdx5
zz+}WPb4r>~v{5%tANz>FMsi53;fcR<*yBZEJ@9i$yE$(d*}man0yx4*Cw;>se+TLR
z+khu>N;pqh(3bL&^IkG$EzJfx;;Gv3Xj-(4XOC`$O&A<vg?F1MV=2!GS6`z~MUy@?
zMK$+4)K=4SGs<Qn#>R~wUT6S+bWavIw7GLbxPI!O!D05h5sQz)QbMp(w>O$#=9&z-
zPK&Skp`q>{XYe6#2Aye3bqMb)*~D=)R6ticlRR_WvHb7ihVI7>&wTRb*aoZV(DNiv
zT*0L37(*6C0U(1m)NH;|XB@IMqI)pi85AuE^l4$DMB_R@(l~|O;$F(X12_ER&0OTI
zJITlf^Pft+l1y%hE-1l`JPyg3?Ga~e4{$DNxn2E^W(QE>0t|NQ1}V44=m+6+x!6mc
zNAJ|_{ph=sqemm`a`22*?}su-8#eAlZ0={>oj8-ARx4)>Xui-DH3A=-v{P<t$JZwN
zlVq8)C>?ZV%D;y%7OqPcu~!Sp>UrLEG)@?w-Cd`^-`kQ#Etb@OW^h|I3wtR1#4lcU
zjKr~(fPsxdfHa5mV5mm+qPS_d+mxVS%s4(J^wy8pS6zNIal37+)Lq5o2=b_QACH-s
z-W}@O{euVDBE<HLZ)yN%bU&^D<M%v=6kAi|auDoRus~We0oa68z{8{E#fInUVP)AC
zfhzb?HeRBv(*64Tj!RnwhEF%uU@@(MMvsM%0A#7e)IK@Uj0BSRnmXLGd4YciG^tXQ
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
Z;X|EyL*<Ici2nB@t0bo`3zIev{eK0-{73)*

literal 0
HcmV?d00001


From 9a4f33532f308033d4c589e71a5687cd87be0700 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 3 Jun 2022 15:04:20 +0200
Subject: [PATCH 0467/1227] hound fix

---
 .../event_handlers_server/action_tranfer_hierarchical_values.py  | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_tranfer_hierarchical_values.py b/openpype/modules/ftrack/event_handlers_server/action_tranfer_hierarchical_values.py
index 9df3b67969..d160b7200d 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_tranfer_hierarchical_values.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_tranfer_hierarchical_values.py
@@ -241,7 +241,6 @@ class TransferHierarchicalValues(ServerAction):
                 )
             }
 
-
         # Delete destination custom attributes first
         if delete_dst_values:
             self.log.info("Deleting destination custom attribute values first")

From 12579501c16120fcea663e97db93f5dfb8dd012c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 3 Jun 2022 17:37:45 +0200
Subject: [PATCH 0468/1227] global: fixing color metrix scale argument

---
 openpype/plugins/publish/extract_review_slate.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index a2cbc1b704..01a7b0f592 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -189,7 +189,6 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
             # make sure colors are correct
             output_args.extend([
-                "-vf", "scale=out_color_matrix=bt709",
                 "-color_primaries", "bt709",
                 "-color_trc", "bt709",
                 "-colorspace", "bt709",
@@ -230,6 +229,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
 
                 scaling_arg = (
                     "scale={0}x{1}:flags=lanczos"
+                    ":out_color_matrix=bt709"
                     ",pad={2}:{3}:{4}:{5}:black"
                     ",setsar=1"
                     ",fps={6}"

From 248d3bd1a36630adc42d9ca090f73c6557498d1b Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 3 Jun 2022 17:38:29 +0200
Subject: [PATCH 0469/1227] Global: removing duplicate timecode argument

- this will be applied at the end in concating stage
---
 openpype/plugins/publish/extract_review_slate.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 01a7b0f592..cff71f67ac 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -173,7 +173,6 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 self.log.debug("Slate Timecode: `{}`".format(
                     offset_timecode
                 ))
-                input_args.extend(["-timecode", str(offset_timecode)])
 
             if use_legacy_code:
                 format_args = []

From d1ff95129f447b52c46aa158c24b2c5d9ecac325 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Sat, 4 Jun 2022 03:43:28 +0000
Subject: [PATCH 0470/1227] [Automated] Bump version

---
 CHANGELOG.md        | 18 ++++++++----------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6613985ccf..50cb1d423e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,17 +1,19 @@
 # Changelog
 
-## [3.10.1-nightly.2](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.10.1-nightly.3](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.10.0...HEAD)
 
 **🚀 Enhancements**
 
 - General: Updated windows oiio tool [\#3268](https://github.com/pypeclub/OpenPype/pull/3268)
+- Maya: reference loaders could store placeholder in referenced url [\#3264](https://github.com/pypeclub/OpenPype/pull/3264)
 - TVPaint: Init file for TVPaint worker also handle guideline images [\#3250](https://github.com/pypeclub/OpenPype/pull/3250)
 - Nuke: Change default icon path in settings [\#3247](https://github.com/pypeclub/OpenPype/pull/3247)
 
 **🐛 Bug fixes**
 
+- Webpublisher: return only active projects in ProjectsEndpoint [\#3281](https://github.com/pypeclub/OpenPype/pull/3281)
 - Nuke: bake reformat was failing on string type [\#3261](https://github.com/pypeclub/OpenPype/pull/3261)
 - Maya: hotfix Pxr multitexture in looks [\#3260](https://github.com/pypeclub/OpenPype/pull/3260)
 - Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
@@ -19,9 +21,12 @@
 - Unreal: Fixed Render creation in UE5 [\#3239](https://github.com/pypeclub/OpenPype/pull/3239)
 - Unreal: Fixed Camera loading in UE5 [\#3238](https://github.com/pypeclub/OpenPype/pull/3238)
 - Flame: debugging [\#3224](https://github.com/pypeclub/OpenPype/pull/3224)
+- Ftrack: Push hierarchical attributes action works [\#3210](https://github.com/pypeclub/OpenPype/pull/3210)
+- add silent audio to slate [\#3162](https://github.com/pypeclub/OpenPype/pull/3162)
 
 **Merged pull requests:**
 
+- Maya: better handling of legacy review subsets names [\#3269](https://github.com/pypeclub/OpenPype/pull/3269)
 - Nuke: add pointcache and animation to loader [\#3186](https://github.com/pypeclub/OpenPype/pull/3186)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
@@ -49,9 +54,6 @@
 - General: Add 'dataclasses' to required python modules [\#3149](https://github.com/pypeclub/OpenPype/pull/3149)
 - Hooks: Tweak logging grammar [\#3147](https://github.com/pypeclub/OpenPype/pull/3147)
 - Nuke: settings for reformat node in CreateWriteRender node [\#3143](https://github.com/pypeclub/OpenPype/pull/3143)
-- Houdini: Add loader for alembic through Alembic Archive node [\#3140](https://github.com/pypeclub/OpenPype/pull/3140)
-- Publisher: UI Modifications and fixes [\#3139](https://github.com/pypeclub/OpenPype/pull/3139)
-- General: Simplified OP modules/addons import [\#3137](https://github.com/pypeclub/OpenPype/pull/3137)
 
 **🐛 Bug fixes**
 
@@ -64,7 +66,6 @@
 - Hiero: debugging frame range and other 3.10 [\#3222](https://github.com/pypeclub/OpenPype/pull/3222)
 - Project Manager: Fix persistent editors on project change [\#3218](https://github.com/pypeclub/OpenPype/pull/3218)
 - Deadline: instance data overwrite fix [\#3214](https://github.com/pypeclub/OpenPype/pull/3214)
-- Ftrack: Push hierarchical attributes action works [\#3210](https://github.com/pypeclub/OpenPype/pull/3210)
 - Standalone Publisher: Always create new representation for thumbnail [\#3203](https://github.com/pypeclub/OpenPype/pull/3203)
 - Photoshop: skip collector when automatic testing [\#3202](https://github.com/pypeclub/OpenPype/pull/3202)
 - Nuke: render/workfile version sync doesn't work on farm [\#3185](https://github.com/pypeclub/OpenPype/pull/3185)
@@ -75,14 +76,9 @@
 - General: Oiio conversion for ffmpeg checks for invalid characters [\#3166](https://github.com/pypeclub/OpenPype/pull/3166)
 - Fix for attaching render to subset [\#3164](https://github.com/pypeclub/OpenPype/pull/3164)
 - Harmony: fixed missing task name in render instance [\#3163](https://github.com/pypeclub/OpenPype/pull/3163)
-- add silent audio to slate [\#3162](https://github.com/pypeclub/OpenPype/pull/3162)
 - Ftrack: Action delete old versions formatting works [\#3152](https://github.com/pypeclub/OpenPype/pull/3152)
-- nuke: adding extract thumbnail settings [\#3148](https://github.com/pypeclub/OpenPype/pull/3148)
 - Deadline: fix the output directory [\#3144](https://github.com/pypeclub/OpenPype/pull/3144)
 - General: New Session schema [\#3141](https://github.com/pypeclub/OpenPype/pull/3141)
-- General: Missing version on headless mode crash properly [\#3136](https://github.com/pypeclub/OpenPype/pull/3136)
-- TVPaint: Composite layers in reversed order [\#3135](https://github.com/pypeclub/OpenPype/pull/3135)
-- TVPaint: Composite layers in reversed order [\#3134](https://github.com/pypeclub/OpenPype/pull/3134)
 
 **🔀 Refactored code**
 
@@ -93,6 +89,7 @@
 - Harmony: message length in 21.1 [\#3257](https://github.com/pypeclub/OpenPype/pull/3257)
 - Harmony: 21.1 fix [\#3249](https://github.com/pypeclub/OpenPype/pull/3249)
 - Maya: added jpg to filter for Image Plane Loader [\#3223](https://github.com/pypeclub/OpenPype/pull/3223)
+- Maya: added jpg to filter for Image Plane Loader [\#3221](https://github.com/pypeclub/OpenPype/pull/3221)
 - Webpublisher: replace space by underscore in subset names [\#3160](https://github.com/pypeclub/OpenPype/pull/3160)
 
 ## [3.9.8](https://github.com/pypeclub/OpenPype/tree/3.9.8) (2022-05-19)
@@ -134,6 +131,7 @@
 **🐛 Bug fixes**
 
 - Ftrack: Action delete old versions formatting works [\#3154](https://github.com/pypeclub/OpenPype/pull/3154)
+- nuke: adding extract thumbnail settings [\#3148](https://github.com/pypeclub/OpenPype/pull/3148)
 
 **Merged pull requests:**
 
diff --git a/openpype/version.py b/openpype/version.py
index 1d8ef28225..e5dfc2bb8f 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.10.1-nightly.2"
+__version__ = "3.10.1-nightly.3"
diff --git a/pyproject.toml b/pyproject.toml
index 27b32cf53b..7a620aec8f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.10.1-nightly.2" # OpenPype
+version = "3.10.1-nightly.3" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 5526435e41554a685864218fd601dd276cfc0cdd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Sat, 4 Jun 2022 21:07:49 +0200
Subject: [PATCH 0471/1227] initial commit of client entities functions

---
 openpype/client/__init__.py |  59 +++
 openpype/client/entities.py | 897 ++++++++++++++++++++++++++++++++++++
 2 files changed, 956 insertions(+)
 create mode 100644 openpype/client/__init__.py
 create mode 100644 openpype/client/entities.py

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
new file mode 100644
index 0000000000..861f828e67
--- /dev/null
+++ b/openpype/client/__init__.py
@@ -0,0 +1,59 @@
+from .entities import (
+    get_projects,
+    get_project,
+
+    get_asset,
+    get_assets,
+    get_asset_ids_with_subsets,
+
+    get_subset,
+    get_subsets,
+    get_subset_families,
+
+    get_version_by_name,
+    get_version,
+    get_versions,
+    get_last_versions,
+    get_last_version_for_subset,
+    get_hero_version,
+    get_hero_versions,
+    get_version_links,
+
+    get_representation,
+    get_representation_by_name,
+    get_representations,
+    get_representations_parents,
+
+    get_thumbnail,
+    get_thumbnail_id_from_source,
+)
+
+__all__ = (
+    "get_projects",
+    "get_project",
+
+    "get_asset",
+    "get_assets",
+    "get_asset_ids_with_subsets",
+
+    "get_subset",
+    "get_subsets",
+    "get_subset_families",
+
+    "get_version_by_name",
+    "get_version",
+    "get_versions",
+    "get_last_versions",
+    "get_last_version_for_subset",
+    "get_hero_version",
+    "get_hero_versions",
+    "get_version_links",
+
+    "get_representation",
+    "get_representation_by_name",
+    "get_representations",
+    "get_representations_parents",
+
+    "get_thubmnail",
+    "get_thumbnail_id_from_source",
+)
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
new file mode 100644
index 0000000000..4b52f8cf2d
--- /dev/null
+++ b/openpype/client/entities.py
@@ -0,0 +1,897 @@
+"""Unclear if these will have public functions like these.
+
+Goal is that most of functions here are called on (or with) an object
+that has project name as a context (e.g. on 'ProjectEntity'?).
+
++ We will need more specific functions doing wery specific queires really fast.
+"""
+
+import os
+import collections
+
+import six
+from bson.objectid import ObjectId
+
+from openpype.lib.mongo import OpenPypeMongoConnection
+
+
+def _get_project_connection(project_name=None):
+    db_name = os.environ.get("AVALON_DB") or "avalon"
+    mongodb = OpenPypeMongoConnection.get_mongo_client()[db_name]
+    if project_name:
+        return mongodb[project_name]
+    return mongodb
+
+
+def _prepare_fields(fields):
+    if not fields:
+        return None
+
+    output = {
+        field: True
+        for field in fields
+    }
+    if "_id" not in output:
+        output["_id"] = True
+    return output
+
+
+def _convert_id(in_id):
+    if isinstance(in_id, six.string_types):
+        return ObjectId(in_id)
+    return in_id
+
+
+def _convert_ids(in_ids):
+    _output = set()
+    for in_id in in_ids:
+        if in_id is not None:
+            _output.add(_convert_id(in_id))
+    return list(_output)
+
+
+def get_projects(active=True, inactive=False, fields=None):
+    mongodb = _get_project_connection()
+    for project_name in mongodb.collection_names():
+        if project_name in ("system.indexes",):
+            continue
+        project_doc = get_project(
+            project_name, active=active, inactive=inactive, fields=fields
+        )
+        if project_doc is not None:
+            yield project_doc
+
+
+def get_project(project_name, active=True, inactive=False, fields=None):
+    # Skip if both are disabled
+    if not active and not inactive:
+        return None
+
+    query_filter = {"type": "project"}
+    # Keep query untouched if both should be available
+    if active and inactive:
+        pass
+
+    # Add filter to keep only active
+    elif active:
+        query_filter["$or"] = [
+            {"data.active": {"$exists": False}},
+            {"data.active": True},
+        ]
+
+    # Add filter to keep only inactive
+    elif inactive:
+        query_filter["$or"] = [
+            {"data.active": {"$exists": False}},
+            {"data.active": False},
+        ]
+
+    conn = _get_project_connection(project_name)
+    return conn.find_one(query_filter, _prepare_fields(fields))
+
+
+def get_asset(project_name, asset_name=None, asset_id=None, fields=None):
+    query_filter = {"type": "asset"}
+    has_filter = False
+    if asset_name:
+        has_filter = True
+        query_filter["name"] = asset_name
+
+    if asset_id:
+        has_filter = True
+        query_filter["_id"] = _convert_id(asset_id)
+
+    # Avoid random asset quqery
+    if not has_filter:
+        return None
+
+    conn = _get_project_connection(project_name)
+
+    return conn.find_one(query_filter, _prepare_fields(fields))
+
+
+def get_assets(
+    project_name, asset_ids=None, asset_names=None, archived=False, fields=None
+):
+    asset_types = ["asset"]
+    if archived:
+        asset_types.append("archived_asset")
+
+    if len(asset_types) == 1:
+        query_filter = {"type": asset_types[0]}
+    else:
+        query_filter = {"type": {"$in": asset_types}}
+
+    if asset_ids is not None:
+        asset_ids = _convert_ids(asset_ids)
+        if not asset_ids:
+            return []
+        query_filter["_id"] = {"$in": asset_ids}
+
+    if asset_names is not None:
+        if not asset_names:
+            return []
+        query_filter["name"] = {"$in": list(asset_names)}
+
+    conn = _get_project_connection(project_name)
+
+    return conn.find(query_filter, _prepare_fields(fields))
+
+
+def get_asset_ids_with_subsets(project_name, asset_ids=None):
+    subset_query = {
+        "type": "subset"
+    }
+    if asset_ids is not None:
+        asset_ids = _convert_ids(asset_ids)
+        if not asset_ids:
+            return []
+        subset_query["parent"] = {"$in": asset_ids}
+
+    conn = _get_project_connection(project_name)
+    result = conn.aggregate([
+        {
+            "$match": subset_query
+        },
+        {
+            "$group": {
+                "_id": "$parent",
+                "count": {"$sum": 1}
+            }
+        }
+    ])
+    asset_ids_with_subsets = []
+    for item in result:
+        asset_id = item["_id"]
+        count = item["count"]
+        if count > 0:
+            asset_ids_with_subsets.append(asset_id)
+    return asset_ids_with_subsets
+
+
+def get_subset(
+    project_name,
+    subset_id=None,
+    subset_name=None,
+    asset_id=None,
+    fields=None
+):
+    """Single subset document by subset id or name and parent id.
+
+    When subset id is defined it is not needed to add any other arguments but
+    subset name filter must be always combined with asset id (or subset id).
+
+    Question:
+        This could be split into more functions?
+
+    Args:
+        project_name (str): Name of project where to look for subset.
+        subset_id (ObjectId): Id of subset which should be found.
+        subset_name (str): Name of asset. Must be combined with 'asset_id' or
+            'subset_id' arguments otherwise result is 'None'.
+        asset_id (ObjectId): Id of parent asset. Must be combined with
+            'subset_name' or 'subset_id'.
+        fields (list<str>): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        None: If subset with specified filters was not found.
+        Dict: Subset document which can be reduced to specified 'fields'.
+    """
+
+    query_filters = {"type": "subset"}
+    has_valid_filters = False
+    if subset_id is not None:
+        query_filters["_id"] = _convert_id(asset_id)
+        has_valid_filters = True
+
+    if subset_name is not None:
+        if asset_id is not None:
+            has_valid_filters = True
+        query_filters["name"] = subset_name
+
+    if asset_id is not None:
+        query_filters["parent"] = _convert_id(asset_id)
+
+    if not has_valid_filters:
+        return None
+
+    conn = _get_project_connection(project_name)
+    return conn.find_one(query_filters, _prepare_fields(fields))
+
+
+def get_subsets(
+    project_name,
+    asset_ids=None,
+    subset_ids=None,
+    subset_names=None,
+    archived=False,
+    fields=None
+):
+    subset_types = ["subset"]
+    if archived:
+        subset_types.append("archived_subset")
+
+    if len(subset_types) == 1:
+        query_filter = {"type": subset_types[0]}
+    else:
+        query_filter = {"type": {"$in": subset_types}}
+
+    if asset_ids is not None:
+        asset_ids = _convert_ids(asset_ids)
+        if not asset_ids:
+            return []
+        query_filter["parent"] = {"$in": asset_ids}
+
+    if subset_ids is not None:
+        subset_ids = _convert_ids(subset_ids)
+        if not subset_ids:
+            return []
+        query_filter["_id"] = {"$in": subset_ids}
+
+    if subset_names is not None:
+        if not subset_names:
+            return []
+        query_filter["name"] = {"$in": list(subset_names)}
+
+    conn = _get_project_connection(project_name)
+    return conn.find(query_filter, _prepare_fields(fields))
+
+
+def get_subset_families(project_name, subset_ids=None):
+    subset_filter = {
+        "type": "subset"
+    }
+    if subset_ids is not None:
+        if not subset_ids:
+            return set()
+        subset_filter["_id"] = {"$in": list(subset_ids)}
+
+    conn = _get_project_connection(project_name)
+    result = list(conn.aggregate([
+        {"$match": subset_filter},
+        {"$project": {
+            "family": {"$arrayElemAt": ["$data.families", 0]}
+        }},
+        {"$group": {
+            "_id": "family_group",
+            "families": {"$addToSet": "$family"}
+        }}
+    ]))
+    if result:
+        return set(result[0]["families"])
+    return set()
+
+
+def get_version_by_name(project_name, subset_id, version, fields=None):
+    conn = _get_project_connection(project_name)
+    query_filter = {
+        "type": "version",
+        "parent": _convert_id(subset_id),
+        "name": version
+    }
+    return conn.find_one(query_filter, _prepare_fields(fields))
+
+
+def get_version(project_name, version_id, fields=None):
+    if not version_id:
+        return None
+    conn = _get_project_connection(project_name)
+    query_filter = {
+        "type": {"$in": ["version", "hero_version"]},
+        "_id": _convert_id(version_id)
+    }
+    return conn.find_one(query_filter, _prepare_fields(fields))
+
+
+def _get_versions(
+    project_name,
+    subset_ids=None,
+    version_ids=None,
+    standard=True,
+    hero=False,
+    fields=None
+):
+    version_types = []
+    if standard:
+        version_types.append("version")
+
+    if hero:
+        version_types.append("hero_version")
+
+    if not version_types:
+        return []
+    elif len(version_types) == 1:
+        query_filter = {"type": version_types[0]}
+    else:
+        query_filter = {"type": {"$in": version_types}}
+
+    if subset_ids is not None:
+        subset_ids = _convert_ids(subset_ids)
+        if not subset_ids:
+            return []
+        query_filter["parent"] = {"$in": subset_ids}
+
+    if version_ids is not None:
+        version_ids = _convert_ids(version_ids)
+        if not version_ids:
+            return []
+        query_filter["_id"] = {"$in": version_ids}
+
+    conn = _get_project_connection(project_name)
+
+    return conn.find(query_filter, _prepare_fields(fields))
+
+
+def get_versions(
+    project_name,
+    subset_ids=None,
+    version_ids=None,
+    hero=False,
+    fields=None
+):
+    return _get_versions(
+        project_name,
+        subset_ids,
+        version_ids,
+        standard=True,
+        hero=hero,
+        fields=fields
+    )
+
+
+def get_hero_version(
+    project_name,
+    subset_id=None,
+    version_id=None,
+    fields=None
+):
+    if not subset_id and not version_id:
+        return None
+
+    subset_ids = None
+    if subset_id is not None:
+        subset_ids = [subset_id]
+
+    version_ids = None
+    if version_id is not None:
+        version_ids = [version_id]
+
+    versions = list(_get_versions(
+        project_name,
+        subset_ids=subset_ids,
+        version_ids=version_ids,
+        standard=False,
+        hero=True,
+        fields=fields
+    ))
+    if versions:
+        return versions[0]
+    return None
+
+
+def get_hero_versions(
+    project_name,
+    subset_ids=None,
+    version_ids=None,
+    fields=None
+):
+    return _get_versions(
+        project_name,
+        subset_ids,
+        version_ids,
+        standard=False,
+        hero=True,
+        fields=fields
+    )
+
+
+def get_version_links(project_name, version_id, fields=None):
+    conn = _get_project_connection(project_name)
+    # Does make sense to look for hero versions?
+    query_filter = {
+        "type": "version",
+        "data.inputLinks.input": _convert_id(version_id)
+    }
+    return conn.find(query_filter, _prepare_fields(fields))
+
+
+def get_last_versions(project_name, subset_ids, fields=None):
+    """Retrieve all latest versions for entered subset_ids.
+
+    Args:
+        subset_ids (list): List of subset ids.
+
+    Returns:
+        dict: Key is subset id and value is last version name.
+    """
+
+    subset_ids = _convert_ids(subset_ids)
+    if not subset_ids:
+        return {}
+
+    _pipeline = [
+        # Find all versions of those subsets
+        {"$match": {
+            "type": "version",
+            "parent": {"$in": subset_ids}
+        }},
+        # Sorting versions all together
+        {"$sort": {"name": 1}},
+        # Group them by "parent", but only take the last
+        {"$group": {
+            "_id": "$parent",
+            "_version_id": {"$last": "$_id"}
+        }}
+    ]
+
+    conn = _get_project_connection(project_name)
+    version_ids = [
+        doc["_version_id"]
+        for doc in conn.aggregate(_pipeline)
+    ]
+    version_docs = get_versions(
+        project_name, version_ids=version_ids, fields=fields
+    )
+
+    return {
+        version_doc["parent"]: version_doc
+        for version_doc in version_docs
+    }
+
+
+def get_last_version_for_subset(
+    project_name, subset_id=None, subset_name=None, asset_id=None, fields=None
+):
+    subset_doc = get_subset(
+        project_name,
+        subset_id=subset_id,
+        subset_name=subset_name,
+        asset_id=asset_id,
+        fields=["_id"]
+    )
+    if not subset_doc:
+        return None
+    subset_id = subset_doc["_id"]
+    last_versions = get_last_versions(
+        project_name, subset_ids=[subset_id], fields=fields
+    )
+    return last_versions.get(subset_id)
+
+
+def get_representation(
+    project_name,
+    representation_id=None,
+    representation_name=None,
+    version_id=None,
+    fields=None
+):
+    if not representation_id:
+        if not representation_name or not version_id:
+            return None
+
+    repre_types = ["representation", "archived_representations"]
+    query_filter = {
+        "type": {"$in": repre_types}
+    }
+    if representation_id is not None:
+        query_filter["_id"] = _convert_id(representation_id)
+
+    if representation_name is not None:
+        query_filter["name"] = representation_name
+
+    if version_id is not None:
+        query_filter["parent"] = version_id
+
+    conn = _get_project_connection(project_name)
+
+    return conn.find_one(query_filter, _prepare_fields(fields))
+
+
+def get_representation_by_name(
+    project_name, representation_name, version_id, fields=None
+):
+    if not version_id or not representation_name:
+        return None
+    repre_types = ["representation", "archived_representations"]
+    query_filter = {
+        "type": {"$in": repre_types},
+        "name": representation_name,
+        "parent": _convert_id(version_id)
+    }
+
+    conn = _get_project_connection(project_name)
+
+    return conn.find_one(query_filter, _prepare_fields(fields))
+
+
+def get_representations(
+    project_name,
+    representation_ids=None,
+    representation_names=None,
+    version_ids=None,
+    extensions=None,
+    names_by_version_ids=None,
+    check_site_name=False,
+    archived=False,
+    fields=None
+):
+    repre_types = ["representation"]
+    if archived:
+        repre_types.append("archived_representations")
+    if len(repre_types) == 1:
+        query_filter = {"type": repre_types[0]}
+    else:
+        query_filter = {"type": {"$in": repre_types}}
+
+    if check_site_name:
+        query_filter["files.site.name"] = {"$exists": True}
+
+    if representation_ids is not None:
+        representation_ids = _convert_ids(representation_ids)
+        if not representation_ids:
+            return []
+        query_filter["_id"] = {"$in": representation_ids}
+
+    if representation_names is not None:
+        if not representation_names:
+            return []
+        query_filter["name"] = {"$in": list(representation_names)}
+
+    if version_ids is not None:
+        version_ids = _convert_ids(version_ids)
+        if not version_ids:
+            return []
+        query_filter["parent"] = {"$in": version_ids}
+
+    if extensions is not None:
+        if not extensions:
+            return []
+        query_filter["context.ext"] = {"$in": list(extensions)}
+
+    if names_by_version_ids is not None:
+        or_query = []
+        for version_id, names in names_by_version_ids.items():
+            if version_id and names:
+                or_query.append({
+                    "parent": _convert_id(version_id),
+                    "name": {"$in": list(names)}
+                })
+        if not or_query:
+            return []
+        query_filter["$or"] = or_query
+
+    conn = _get_project_connection(project_name)
+
+    return conn.find(query_filter, _prepare_fields(fields))
+
+
+def get_representations_parents(project_name, representations):
+    repres_by_version_id = collections.defaultdict(list)
+    versions_by_version_id = {}
+    versions_by_subset_id = collections.defaultdict(list)
+    subsets_by_subset_id = {}
+    subsets_by_asset_id = collections.defaultdict(list)
+    for representation in representations:
+        repre_id = representation["_id"]
+        version_id = representation["parent"]
+        repres_by_version_id[version_id].append(representation)
+
+    versions = get_versions(
+        project_name, version_ids=repres_by_version_id.keys()
+    )
+    for version in versions:
+        version_id = version["_id"]
+        subset_id = version["parent"]
+        versions_by_version_id[version_id] = version
+        versions_by_subset_id[subset_id].append(version)
+
+    subsets = get_subsets(
+        project_name, subset_ids=versions_by_subset_id.keys()
+    )
+    for subset in subsets:
+        subset_id = subset["_id"]
+        asset_id = subset["parent"]
+        subsets_by_subset_id[subset_id] = subset
+        subsets_by_asset_id[asset_id].append(subset)
+
+    assets = get_assets(project_name, asset_ids=subsets_by_asset_id.keys())
+    assets_by_id = {
+        asset["_id"]: asset
+        for asset in assets
+    }
+
+    project = get_project(project_name)
+
+    output = {}
+    for version_id, representations in repres_by_version_id.items():
+        asset = None
+        subset = None
+        version = versions_by_version_id.get(version_id)
+        if version:
+            subset_id = version["parent"]
+            subset = subsets_by_subset_id.get(subset_id)
+            if subset:
+                asset_id = subset["parent"]
+                asset = assets_by_id.get(asset_id)
+
+        for representation in representations:
+            repre_id = representation["_id"]
+            output[repre_id] = (version, subset, asset, project)
+    return output
+
+
+def get_thumbnail_id_from_source(project_name, src_type, src_id):
+    if not src_type or not src_id:
+        return None
+
+    query_filter = {"_id": _convert_id(src_id)}
+
+    conn = _get_project_connection(project_name)
+    src_doc = conn.find_one(query_filter, {"data.thumbnail_id"})
+    if src_doc:
+        return src_doc.get("data", {}).get("thumbnail_id")
+    return None
+
+
+def get_thumbnail(project_name, thumbnail_id, fields=None):
+    if not thumbnail_id:
+        return None
+    query_filter = {"type": "thumbnail", "_id": _convert_id(thumbnail_id)}
+    conn = _get_project_connection(project_name)
+    return conn.find(query_filter, _prepare_fields(fields))
+
+
+"""
+Custom data storage:
+- Webpublisher - jobs
+- Ftrack - events
+
+openpype/tools/assetlinks/widgets.py
+- SimpleLinkView
+    Query:
+    - get_versions
+    - get_subsets
+    - get_assets
+    - get_version_links
+
+openpype/tools/creator/window.py
+- CreatorWindow
+    Query:
+    - get_asset
+    - get_subsets
+
+openpype/tools/launcher/models.py
+- LauncherModel
+    Query:
+    - get_project
+    - get_assets
+
+openpype/tools/libraryloader/app.py
+- LibraryLoaderWindow
+    Query:
+    - get_project
+
+openpype/tools/loader/app.py
+- LoaderWindow
+    Query:
+    - get_project
+- show
+    Query:
+    - get_projects
+
+openpype/tools/loader/model.py
+- SubsetsModel
+    Query:
+    - get_assets
+    - get_subsets
+    - get_last_versions
+    - get_versions
+    - get_hero_versions
+    - get_version_by_name
+- RepresentationModel
+    Query:
+    - get_representations
+    - sync server specific queries (separated into multiple functions?)
+        - NOT REPLACED
+
+openpype/tools/loader/widgets.py
+- FamilyModel
+    Query:
+    - get_subset_families
+- VersionTextEdit
+    Query:
+    - get_subset
+    - get_version
+- SubsetWidget
+    Query:
+    - get_subsets
+    - get_representations
+- RepresentationWidget
+    Query:
+    - get_subsets
+    - get_versions
+    - get_representations
+- ThumbnailWidget
+    Query:
+    - get_thumbnail_id_from_source
+    - get_thumbnail
+
+openpype/tools/mayalookassigner/app.py
+- MayaLookAssignerWindow
+    Query:
+    - get_last_version_for_subset
+
+openpype/tools/mayalookassigner/commands.py
+- create_items_from_nodes
+    Query:
+    - get_asset
+
+openpype/tools/mayalookassigner/vray_proxies.py
+- get_look_relationships
+    Query:
+    - get_representation_by_name
+- load_look
+    Query:
+    - get_representation_by_name
+- vrayproxy_assign_look
+    Query:
+    - get_last_version_for_subset
+
+openpype/tools/project_manager/project_manager/model.py
+- HierarchyModel
+    Query:
+    - get_asset_ids_with_subsets
+    - get_project
+    - get_assets
+
+openpype/tools/project_manager/project_manager/view.py
+- ProjectDocCache
+    Query:
+    - get_project
+
+openpype/tools/project_manager/project_manager/widgets.py
+- CreateProjectDialog
+    Query:
+    - get_projects
+
+openpype/tools/publisher/widgets/create_dialog.py
+- CreateDialog
+    Query:
+    - get_asset
+    - get_subsets
+
+openpype/tools/publisher/control.py
+- AssetDocsCache
+    Query:
+    - get_assets
+
+openpype/tools/sceneinventory/model.py
+- InventoryModel
+    Query:
+    - get_asset
+    - get_subset
+    - get_version
+    - get_last_version_for_subset
+    - get_representation
+
+openpype/tools/sceneinventory/switch_dialog.py
+- SwitchAssetDialog
+    Query:
+    - get_asset
+    - get_assets
+    - get_subset
+    - get_subsets
+    - get_versions
+    - get_hero_versions
+    - get_last_versions
+    - get_representations
+
+openpype/tools/sceneinventory/view.py
+- SceneInventoryView
+    Query:
+    - get_version
+    - get_versions
+    - get_hero_versions
+    - get_representation
+    - get_representations
+
+openpype/tools/standalonepublish/widgets/model_asset.py
+- AssetModel
+    Query:
+    - get_assets
+
+openpype/tools/standalonepublish/widgets/widget_asset.py
+- AssetWidget
+    Query:
+    - get_project
+    - get_asset
+
+openpype/tools/standalonepublish/widgets/widget_family.py
+- FamilyWidget
+    Query:
+    - get_asset
+    - get_subset
+    - get_subsets
+    - get_last_version_for_subset
+
+openpype/tools/standalonepublish/app.py
+- Window
+    Query:
+    - get_asset
+
+openpype/tools/texture_copy/app.py
+- TextureCopy
+    Query:
+    - get_project
+    - get_asset
+
+openpype/tools/workfiles/files_widget.py
+- FilesWidget
+    Query:
+    - get_asset
+
+openpype/tools/workfiles/model.py
+- PublishFilesModel
+    Query:
+    - get_subsets
+    - get_versions
+    - get_representations
+
+openpype/tools/workfiles/save_as_dialog.py
+- build_workfile_data
+    Query:
+    - get_project
+    - get_asset
+
+openpype/tools/workfiles/window.py
+- Window
+    Query:
+    - get_asset
+
+openpype/tools/utils/assets_widget.py
+- AssetModel
+    Query:
+    - get_project
+    - get_assets
+
+openpype/tools/utils/delegates.py
+- VersionDelegate
+    Query:
+    - get_versions
+    - get_hero_versions
+
+openpype/tools/utils/lib.py
+- GroupsConfig
+    Query:
+    - get_project
+- FamilyConfigCache
+    Query:
+    - get_asset
+
+openpype/tools/utils/tasks_widget.py
+- TasksModel
+    Query:
+    - get_project
+    - get_asset
+"""

From 7109d932ec2ed70a2042d2df7563de368293a88e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Sat, 4 Jun 2022 21:08:42 +0200
Subject: [PATCH 0472/1227] replace queries in tools

---
 openpype/tools/assetlinks/widgets.py          | 159 +++--
 openpype/tools/creator/window.py              |  21 +-
 openpype/tools/launcher/models.py             |  21 +-
 openpype/tools/libraryloader/app.py           |  57 +-
 openpype/tools/loader/app.py                  |  17 +-
 openpype/tools/loader/model.py                | 289 +++++----
 openpype/tools/loader/widgets.py              | 231 ++++---
 openpype/tools/mayalookassigner/app.py        |  21 +-
 openpype/tools/mayalookassigner/commands.py   |  18 +-
 .../tools/mayalookassigner/vray_proxies.py    |  77 +--
 .../project_manager/project_manager/model.py  |  42 +-
 .../project_manager/project_manager/view.py   |   9 +-
 .../project_manager/widgets.py                |  13 +-
 openpype/tools/publisher/control.py           |   9 +-
 .../tools/publisher/widgets/create_dialog.py  |  22 +-
 openpype/tools/sceneinventory/model.py        |  38 +-
 .../tools/sceneinventory/switch_dialog.py     | 569 ++++++++----------
 openpype/tools/sceneinventory/view.py         | 113 ++--
 openpype/tools/standalonepublish/app.py       |  18 +-
 .../standalonepublish/widgets/model_asset.py  |  12 +-
 .../standalonepublish/widgets/widget_asset.py |  27 +-
 .../widgets/widget_family.py                  |  81 ++-
 openpype/tools/texture_copy/app.py            |  28 +-
 openpype/tools/utils/assets_widget.py         |  19 +-
 openpype/tools/utils/delegates.py             |  40 +-
 openpype/tools/utils/lib.py                   |  14 +-
 openpype/tools/utils/tasks_widget.py          |  13 +-
 openpype/tools/workfiles/files_widget.py      |   5 +-
 openpype/tools/workfiles/model.py             |  48 +-
 openpype/tools/workfiles/save_as_dialog.py    |  30 +-
 openpype/tools/workfiles/window.py            |  23 +-
 31 files changed, 1010 insertions(+), 1074 deletions(-)

diff --git a/openpype/tools/assetlinks/widgets.py b/openpype/tools/assetlinks/widgets.py
index 22e8848a60..5ce2a835ef 100644
--- a/openpype/tools/assetlinks/widgets.py
+++ b/openpype/tools/assetlinks/widgets.py
@@ -1,10 +1,16 @@
+import collections
+from openpype.client import (
+    get_versions,
+    get_subsets,
+    get_assets,
+    get_version_links,
+)
 
 from Qt import QtWidgets
 
 
 class SimpleLinkView(QtWidgets.QWidget):
-
-    def __init__(self, dbcon, parent=None):
+    def __init__(self, dbcon, parent):
         super(SimpleLinkView, self).__init__(parent=parent)
         self.dbcon = dbcon
 
@@ -24,6 +30,11 @@ class SimpleLinkView(QtWidgets.QWidget):
 
         self._in_view = in_view
         self._out_view = out_view
+        self._version_doc_to_process = None
+
+    @property
+    def project_name(self):
+        return self.dbcon.current_project()
 
     def clear(self):
         self._in_view.clear()
@@ -31,60 +42,114 @@ class SimpleLinkView(QtWidgets.QWidget):
 
     def set_version(self, version_doc):
         self.clear()
-        if not version_doc or not self.isVisible():
-            return
+        self._version_doc_to_process = version_doc
+        if version_doc and self.isVisible():
+            self._fill_values()
 
-        # inputs
-        #
+    def showEvent(self, event):
+        super(SimpleLinkView, self).showEvent(event)
+        self._fill_values()
+
+    def _fill_values(self):
+        if self._version_doc_to_process is None:
+            return
+        version_doc = self._version_doc_to_process
+        self._version_doc_to_process = None
+        self._fill_inputs(version_doc)
+        self._fill_outputs(version_doc)
+
+    def _fill_inputs(self, version_doc):
+        version_ids = set()
         for link in version_doc["data"].get("inputLinks", []):
             # Backwards compatibility for "input" key used as "id"
             if "id" not in link:
                 link_id = link["input"]
             else:
                 link_id = link["id"]
-            version = self.dbcon.find_one(
-                {"_id": link_id, "type": "version"},
-                projection={"name": 1, "parent": 1}
-            )
-            if not version:
-                continue
-            subset = self.dbcon.find_one(
-                {"_id": version["parent"], "type": "subset"},
-                projection={"name": 1, "parent": 1}
-            )
-            if not subset:
-                continue
-            asset = self.dbcon.find_one(
-                {"_id": subset["parent"], "type": "asset"},
-                projection={"name": 1}
-            )
+            version_ids.add(link_id)
 
-            self._in_view.addItem("{asset} {subset} v{version:0>3}".format(
-                asset=asset["name"],
-                subset=subset["name"],
-                version=version["name"],
+        version_docs = list(get_versions(
+            self.project_name,
+            version_ids=version_ids,
+            fields=["name", "parent"]
+        ))
+
+        subset_docs = []
+        versions_by_subset_id = collections.defaultdict(list)
+        if versions_by_subset_id:
+            for version_doc in version_docs:
+                subset_id = version_doc["parent"]
+                versions_by_subset_id[subset_id].append(version_doc)
+
+            subset_docs = list(get_subsets(
+                self.project_name,
+                subset_ids=versions_by_subset_id.keys(),
+                fields=["_id", "name", "parent"]
             ))
 
-        # outputs
-        #
-        outputs = self.dbcon.find(
-            {"type": "version", "data.inputLinks.input": version_doc["_id"]},
-            projection={"name": 1, "parent": 1}
-        )
-        for version in outputs or []:
-            subset = self.dbcon.find_one(
-                {"_id": version["parent"], "type": "subset"},
-                projection={"name": 1, "parent": 1}
-            )
-            if not subset:
-                continue
-            asset = self.dbcon.find_one(
-                {"_id": subset["parent"], "type": "asset"},
-                projection={"name": 1}
-            )
+        asset_docs = []
+        subsets_by_asset_id = collections.defaultdict(list)
+        if subset_docs:
+            for subset_doc in subset_docs:
+                asset_id = subset_doc["parent"]
+                subsets_by_asset_id[asset_id].append(subset_doc)
 
-            self._out_view.addItem("{asset} {subset} v{version:0>3}".format(
-                asset=asset["name"],
-                subset=subset["name"],
-                version=version["name"],
+            asset_docs = list(get_assets(
+                self.project_name,
+                asset_ids=subsets_by_asset_id.keys(),
+                fields=["_id", "name"]
             ))
+
+        for asset_doc in asset_docs:
+            asset_id = asset_doc["_id"]
+            for subset_doc in subsets_by_asset_id[asset_id]:
+                subset_id = subset_doc["_id"]
+                for version_doc in versions_by_subset_id[subset_id]:
+                    self._in_view.addItem("{} {} v{:0>3}".format(
+                        asset_doc["name"],
+                        subset_doc["name"],
+                        version_doc["name"],
+                    ))
+
+    def _fill_outputs(self, version_doc):
+        version_docs = list(get_version_links(
+            self.project_name,
+            version_doc["_id"],
+            fields=["name", "parent"]
+        ))
+        subset_docs = []
+        versions_by_subset_id = collections.defaultdict(list)
+        if versions_by_subset_id:
+            for version_doc in version_docs:
+                subset_id = version_doc["parent"]
+                versions_by_subset_id[subset_id].append(version_doc)
+
+            subset_docs = list(get_subsets(
+                self.project_name,
+                subset_ids=versions_by_subset_id.keys(),
+                fields=["_id", "name", "parent"]
+            ))
+
+        asset_docs = []
+        subsets_by_asset_id = collections.defaultdict(list)
+        if subset_docs:
+            for subset_doc in subset_docs:
+                asset_id = subset_doc["parent"]
+                subsets_by_asset_id[asset_id].append(subset_doc)
+
+            asset_docs = list(get_assets(
+                self.project_name,
+                asset_ids=subsets_by_asset_id.keys(),
+                fields=["_id", "name"]
+            ))
+
+        for asset_doc in asset_docs:
+            asset_id = asset_doc["_id"]
+            for subset_doc in subsets_by_asset_id[asset_id]:
+                subset_id = subset_doc["_id"]
+                for version_doc in versions_by_subset_id[subset_id]:
+                    self._out_view.addItem("{} {} v{:0>3}".format(
+                        asset_doc["name"],
+                        subset_doc["name"],
+                        version_doc["name"],
+                    ))
diff --git a/openpype/tools/creator/window.py b/openpype/tools/creator/window.py
index e0c329fb78..a85f47a060 100644
--- a/openpype/tools/creator/window.py
+++ b/openpype/tools/creator/window.py
@@ -4,6 +4,7 @@ import re
 
 from Qt import QtWidgets, QtCore
 
+from openpype.client import get_asset, get_subsets
 from openpype import style
 from openpype.api import get_current_project_settings
 from openpype.tools.utils.lib import qt_app_context
@@ -215,12 +216,12 @@ class CreatorWindow(QtWidgets.QDialog):
             self._set_valid_state(False)
             return
 
+        project_name = legacy_io.active_project()
         asset_doc = None
         if creator_plugin:
             # Get the asset from the database which match with the name
-            asset_doc = legacy_io.find_one(
-                {"name": asset_name, "type": "asset"},
-                projection={"_id": 1}
+            asset_doc = get_asset(
+                project_name, asset_name=asset_name, fields=["_id"]
             )
 
         # Get plugin
@@ -235,7 +236,6 @@ class CreatorWindow(QtWidgets.QDialog):
             self._set_valid_state(False)
             return
 
-        project_name = legacy_io.Session["AVALON_PROJECT"]
         asset_id = asset_doc["_id"]
         task_name = legacy_io.Session["AVALON_TASK"]
 
@@ -269,14 +269,13 @@ class CreatorWindow(QtWidgets.QDialog):
         self._subset_name_input.setText(subset_name)
 
         # Get all subsets of the current asset
-        subset_docs = legacy_io.find(
-            {
-                "type": "subset",
-                "parent": asset_id
-            },
-            {"name": 1}
+        subset_docs = get_subsets(
+            project_name, asset_ids=[asset_id], fields=["name"]
         )
-        existing_subset_names = set(subset_docs.distinct("name"))
+        existing_subset_names = {
+            subset_doc["name"]
+            for subset_doc in subset_docs
+        }
         existing_subset_names_low = set(
             _name.lower()
             for _name in existing_subset_names
diff --git a/openpype/tools/launcher/models.py b/openpype/tools/launcher/models.py
index 13567e7916..307f591d96 100644
--- a/openpype/tools/launcher/models.py
+++ b/openpype/tools/launcher/models.py
@@ -9,6 +9,10 @@ import appdirs
 from Qt import QtCore, QtGui
 import qtawesome
 
+from openpype.client import (
+    get_project,
+    get_assets,
+)
 from openpype.lib import JSONSettingRegistry
 from openpype.lib.applications import (
     CUSTOM_LAUNCH_APP_GROUPS,
@@ -81,13 +85,11 @@ class ActionModel(QtGui.QStandardItemModel):
 
     def get_application_actions(self):
         actions = []
-        if not self.dbcon.Session.get("AVALON_PROJECT"):
+        if not self.dbcon.current_project():
             return actions
 
-        project_doc = self.dbcon.find_one(
-            {"type": "project"},
-            {"config.apps": True}
-        )
+        project_name = self.dbcon.active_project()
+        project_doc = get_project(project_name, fields=["config.apps"])
         if not project_doc:
             return actions
 
@@ -448,7 +450,7 @@ class LauncherModel(QtCore.QObject):
     @property
     def project_name(self):
         """Current project name."""
-        return self._dbcon.Session.get("AVALON_PROJECT")
+        return self._dbcon.current_project()
 
     @property
     def refreshing_assets(self):
@@ -649,10 +651,9 @@ class LauncherModel(QtCore.QObject):
             self._asset_refresh_thread = None
 
     def _refresh_assets(self):
-        asset_docs = list(self._dbcon.find(
-            {"type": "asset"},
-            self._asset_projection
-        ))
+        asset_docs = get_assets(
+            self._last_project_name, fields=list(self._asset_projection.keys())
+        )
         if not self._refreshing_assets:
             return
         self._refreshing_assets = False
diff --git a/openpype/tools/libraryloader/app.py b/openpype/tools/libraryloader/app.py
index 7fda6bd6f9..5f4d10d796 100644
--- a/openpype/tools/libraryloader/app.py
+++ b/openpype/tools/libraryloader/app.py
@@ -3,6 +3,7 @@ import sys
 from Qt import QtWidgets, QtCore, QtGui
 
 from openpype import style
+from openpype.client import get_project
 from openpype.pipeline import AvalonMongoDB
 from openpype.tools.utils import lib as tools_lib
 from openpype.tools.loader.widgets import (
@@ -303,14 +304,26 @@ class LibraryLoaderWindow(QtWidgets.QDialog):
         families = self._subsets_widget.get_subsets_families()
         self._families_filter_view.set_enabled_families(families)
 
-    def set_context(self, context, refresh=True):
-        self.echo("Setting context: {}".format(context))
-        lib.schedule(
-            lambda: self._set_context(context, refresh=refresh),
-            50, channel="mongo"
-        )
-
     # ------------------------------
+    def set_context(self, context, refresh=True):
+        """Set the selection in the interface using a context.
+        The context must contain `asset` data by name.
+
+        Args:
+            context (dict): The context to apply.
+        Returns:
+            None
+        """
+
+        asset_name = context.get("asset", None)
+        if asset_name is None:
+            return
+
+        if refresh:
+            self._refresh_assets()
+
+        self._assets_widget.select_asset_by_name(asset_name)
+
     def _on_family_filter_change(self, families):
         self._subsets_widget.set_family_filters(families)
 
@@ -323,10 +336,7 @@ class LibraryLoaderWindow(QtWidgets.QDialog):
         """Load assets from database"""
         if self.current_project is not None:
             # Ensure a project is loaded
-            project_doc = self.dbcon.find_one(
-                {"type": "project"},
-                {"type": 1}
-            )
+            project_doc = get_project(self.current_project, fields=["_id"])
             assert project_doc, "This is a bug"
 
         self._families_filter_view.set_enabled_families(set())
@@ -371,7 +381,7 @@ class LibraryLoaderWindow(QtWidgets.QDialog):
 
         # Clear the version information on asset change
         self._version_info_widget.set_version(None)
-        self._thumbnail_widget.set_thumbnail(asset_ids)
+        self._thumbnail_widget.set_thumbnail("asset", asset_ids)
 
         self.data["state"]["assetIds"] = asset_ids
 
@@ -426,34 +436,17 @@ class LibraryLoaderWindow(QtWidgets.QDialog):
             version_doc["_id"]
             for version_doc in version_docs
         ]
+        src_type = "version"
         if not thumbnail_src_ids:
+            src_type = "asset"
             thumbnail_src_ids = self._assets_widget.get_selected_asset_ids()
 
-        self._thumbnail_widget.set_thumbnail(thumbnail_src_ids)
+        self._thumbnail_widget.set_thumbnail(src_type, thumbnail_src_ids)
 
         version_ids = [doc["_id"] for doc in version_docs or []]
         if self._repres_widget:
             self._repres_widget.set_version_ids(version_ids)
 
-    def _set_context(self, context, refresh=True):
-        """Set the selection in the interface using a context.
-        The context must contain `asset` data by name.
-
-        Args:
-            context (dict): The context to apply.
-        Returns:
-            None
-        """
-
-        asset_name = context.get("asset", None)
-        if asset_name is None:
-            return
-
-        if refresh:
-            self._refresh_assets()
-
-        self._assets_widget.select_asset_by_name(asset_name)
-
     def _on_message_timeout(self):
         self._message_label.setText("")
 
diff --git a/openpype/tools/loader/app.py b/openpype/tools/loader/app.py
index bb589c199d..1917f23c60 100644
--- a/openpype/tools/loader/app.py
+++ b/openpype/tools/loader/app.py
@@ -3,6 +3,7 @@ import traceback
 
 from Qt import QtWidgets, QtCore
 
+from openpype.client import get_projects, get_project
 from openpype import style
 from openpype.lib import register_event_callback
 from openpype.pipeline import (
@@ -39,7 +40,7 @@ class LoaderWindow(QtWidgets.QDialog):
     def __init__(self, parent=None):
         super(LoaderWindow, self).__init__(parent)
         title = "Asset Loader 2.1"
-        project_name = legacy_io.Session.get("AVALON_PROJECT")
+        project_name = legacy_io.active_project()
         if project_name:
             title += " - {}".format(project_name)
         self.setWindowTitle(title)
@@ -274,8 +275,9 @@ class LoaderWindow(QtWidgets.QDialog):
         """Load assets from database"""
 
         # Ensure a project is loaded
-        project = legacy_io.find_one({"type": "project"}, {"type": 1})
-        assert project, "Project was not found! This is a bug"
+        project_name = legacy_io.active_project()
+        project_doc = get_project(project_name, fields=["_id"])
+        assert project_doc, "Project was not found! This is a bug"
 
         self._assets_widget.refresh()
         self._assets_widget.setFocus()
@@ -314,7 +316,7 @@ class LoaderWindow(QtWidgets.QDialog):
         )
 
         # Clear the version information on asset change
-        self._thumbnail_widget.set_thumbnail(asset_ids)
+        self._thumbnail_widget.set_thumbnail("asset", asset_ids)
         self._version_info_widget.set_version(None)
 
         self.data["state"]["assetIds"] = asset_ids
@@ -371,10 +373,12 @@ class LoaderWindow(QtWidgets.QDialog):
             version_doc["_id"]
             for version_doc in version_docs
         ]
+        source_type = "version"
         if not thumbnail_src_ids:
+            source_type = "asset"
             thumbnail_src_ids = self._assets_widget.get_selected_asset_ids()
 
-        self._thumbnail_widget.set_thumbnail(thumbnail_src_ids)
+        self._thumbnail_widget.set_thumbnail(source_type, thumbnail_src_ids)
 
         if self._repres_widget is not None:
             version_ids = [doc["_id"] for doc in version_docs]
@@ -576,8 +580,7 @@ def show(debug=False, parent=None, use_context=False):
         legacy_io.install()
 
         any_project = next(
-            project for project in legacy_io.projects()
-            if project.get("active", True) is not False
+            project for project in get_projects(fields=["name"])
         )
 
         legacy_io.Session["AVALON_PROJECT"] = any_project["name"]
diff --git a/openpype/tools/loader/model.py b/openpype/tools/loader/model.py
index 6f39c428be..e8e0480d9c 100644
--- a/openpype/tools/loader/model.py
+++ b/openpype/tools/loader/model.py
@@ -7,6 +7,15 @@ from uuid import uuid4
 from Qt import QtCore, QtGui
 import qtawesome
 
+from openpype.client import (
+    get_assets,
+    get_subsets,
+    get_last_versions,
+    get_versions,
+    get_hero_versions,
+    get_version_by_name,
+    get_representations
+)
 from openpype.pipeline import (
     HeroVersionType,
     schema,
@@ -56,7 +65,7 @@ class BaseRepresentationModel(object):
         remote_site = remote_provider = None
 
         if not project_name:
-            project_name = self.dbcon.Session.get("AVALON_PROJECT")
+            project_name = self.dbcon.active_project()
         else:
             self.dbcon.Session["AVALON_PROJECT"] = project_name
 
@@ -254,57 +263,61 @@ class SubsetsModel(TreeModel, BaseRepresentationModel):
         # because it also updates the information in other columns
         if index.column() == self.columns_index["version"]:
             item = index.internalPointer()
-            parent = item["_id"]
+            subset_id = item["_id"]
             if isinstance(value, HeroVersionType):
-                versions = list(self.dbcon.find({
-                    "type": {"$in": ["version", "hero_version"]},
-                    "parent": parent
-                }, sort=[("name", -1)]))
-
-                version = None
-                last_version = None
-                for __version in versions:
-                    if __version["type"] == "hero_version":
-                        version = __version
-                    elif last_version is None:
-                        last_version = __version
-
-                    if version is not None and last_version is not None:
-                        break
-
-                _version = None
-                for __version in versions:
-                    if __version["_id"] == version["version_id"]:
-                        _version = __version
-                        break
-
-                version["data"] = _version["data"]
-                version["name"] = _version["name"]
-                version["is_from_latest"] = (
-                    last_version["_id"] == _version["_id"]
-                )
+                version_doc = self._get_hero_version(subset_id)
 
             else:
-                version = self.dbcon.find_one({
-                    "name": value,
-                    "type": "version",
-                    "parent": parent
-                })
+                project_name = self.dbcon.active_project()
+                version_doc = get_version_by_name(
+                    project_name, subset_id, value
+                )
 
                 # update availability on active site when version changes
-                if self.sync_server.enabled and version:
-                    query = self._repre_per_version_pipeline([version["_id"]],
-                                                             self.active_site,
-                                                             self.remote_site)
+                if self.sync_server.enabled and version_doc:
+                    query = self._repre_per_version_pipeline(
+                        [version_doc["_id"]],
+                        self.active_site,
+                        self.remote_site
+                    )
                     docs = list(self.dbcon.aggregate(query))
                     if docs:
                         repre = docs.pop()
-                        version["data"].update(self._get_repre_dict(repre))
+                        version_doc["data"].update(self._get_repre_dict(repre))
 
-            self.set_version(index, version)
+            self.set_version(index, version_doc)
 
         return super(SubsetsModel, self).setData(index, value, role)
 
+    def _get_hero_version(self, subset_id):
+        project_name = self.dbcon.active_project()
+        version_docs = get_versions(
+            project_name, subset_ids=[subset_id], hero=True
+        )
+        standard_versions = []
+        hero_version_doc = None
+        for version_doc in version_docs:
+            if version_doc["type"] == "hero_version":
+                hero_version_doc = version_doc
+                continue
+            standard_versions.append(version_doc)
+
+        src_version_id = hero_version_doc["version_id"]
+        src_version = None
+        is_from_latest = True
+        for version_doc in reversed(sorted(
+            standard_versions, key=lambda item: item["name"]
+        )):
+            if version_doc["_id"] == src_version_id:
+                src_version = version_doc
+                break
+            is_from_latest = False
+
+        hero_version_doc["data"] = src_version["data"]
+        hero_version_doc["name"] = src_version["name"]
+        hero_version_doc["is_from_latest"] = is_from_latest
+        return hero_version_doc
+
     def set_version(self, index, version):
         """Update the version data of the given index.
 
@@ -391,26 +404,25 @@ class SubsetsModel(TreeModel, BaseRepresentationModel):
             item["repre_info"] = repre_info
 
     def _fetch(self):
-        asset_docs = self.dbcon.find(
-            {
-                "type": "asset",
-                "_id": {"$in": self._asset_ids}
-            },
-            self.asset_doc_projection
+        project_name = self.dbcon.active_project()
+        asset_docs = get_assets(
+            project_name,
+            asset_ids=self._asset_ids,
+            fields=self.asset_doc_projection.keys()
         )
+
         asset_docs_by_id = {
             asset_doc["_id"]: asset_doc
             for asset_doc in asset_docs
         }
 
         subset_docs_by_id = {}
-        subset_docs = self.dbcon.find(
-            {
-                "type": "subset",
-                "parent": {"$in": self._asset_ids}
-            },
-            self.subset_doc_projection
+        subset_docs = get_subsets(
+            project_name,
+            asset_ids=self._asset_ids,
+            fields=self.subset_doc_projection.keys()
         )
+
         subset_families = set()
         for subset_doc in subset_docs:
             if self._doc_fetching_stop:
@@ -423,37 +435,13 @@ class SubsetsModel(TreeModel, BaseRepresentationModel):
             subset_docs_by_id[subset_doc["_id"]] = subset_doc
 
         subset_ids = list(subset_docs_by_id.keys())
-        _pipeline = [
-            # Find all versions of those subsets
-            {"$match": {
-                "type": "version",
-                "parent": {"$in": subset_ids}
-            }},
-            # Sorting versions all together
-            {"$sort": {"name": 1}},
-            # Group them by "parent", but only take the last
-            {"$group": {
-                "_id": "$parent",
-                "_version_id": {"$last": "$_id"},
-                "name": {"$last": "$name"},
-                "type": {"$last": "$type"},
-                "data": {"$last": "$data"},
-                "locations": {"$last": "$locations"},
-                "schema": {"$last": "$schema"}
-            }}
-        ]
-        last_versions_by_subset_id = dict()
-        for doc in self.dbcon.aggregate(_pipeline):
-            if self._doc_fetching_stop:
-                return
-            doc["parent"] = doc["_id"]
-            doc["_id"] = doc.pop("_version_id")
-            last_versions_by_subset_id[doc["parent"]] = doc
+        last_versions_by_subset_id = get_last_versions(
+            project_name,
+            subset_ids,
+            fields=["_id", "parent", "name", "type", "data", "schema"]
+        )
 
-        hero_versions = self.dbcon.find({
-            "type": "hero_version",
-            "parent": {"$in": subset_ids}
-        })
+        hero_versions = get_hero_versions(project_name, subset_ids=subset_ids)
         missing_versions = []
         for hero_version in hero_versions:
             version_id = hero_version["version_id"]
@@ -462,10 +450,9 @@ class SubsetsModel(TreeModel, BaseRepresentationModel):
 
         missing_versions_by_id = {}
         if missing_versions:
-            missing_version_docs = self.dbcon.find({
-                "type": "version",
-                "_id": {"$in": missing_versions}
-            })
+            missing_version_docs = get_versions(
+                project_name, version_ids=missing_versions
+            )
             missing_versions_by_id = {
                 missing_version_doc["_id"]: missing_version_doc
                 for missing_version_doc in missing_version_docs
@@ -488,23 +475,16 @@ class SubsetsModel(TreeModel, BaseRepresentationModel):
 
             last_versions_by_subset_id[subset_id] = hero_version
 
-        self._doc_payload = {
-            "asset_docs_by_id": asset_docs_by_id,
-            "subset_docs_by_id": subset_docs_by_id,
-            "subset_families": subset_families,
-            "last_versions_by_subset_id": last_versions_by_subset_id
-        }
-
+        repre_info = {}
         if self.sync_server.enabled:
             version_ids = set()
             for _subset_id, doc in last_versions_by_subset_id.items():
                 version_ids.add(doc["_id"])
 
-            query = self._repre_per_version_pipeline(list(version_ids),
-                                                     self.active_site,
-                                                     self.remote_site)
+            query = self._repre_per_version_pipeline(
+                list(version_ids), self.active_site, self.remote_site
+            )
 
-            repre_info = {}
             for doc in self.dbcon.aggregate(query):
                 if self._doc_fetching_stop:
                     return
@@ -512,7 +492,13 @@ class SubsetsModel(TreeModel, BaseRepresentationModel):
                 doc["remote_provider"] = self.remote_provider
                 repre_info[doc["_id"]] = doc
 
-            self._doc_payload["repre_info_by_version_id"] = repre_info
+        self._doc_payload = {
+            "asset_docs_by_id": asset_docs_by_id,
+            "subset_docs_by_id": subset_docs_by_id,
+            "subset_families": subset_families,
+            "last_versions_by_subset_id": last_versions_by_subset_id,
+            "repre_info_by_version_id": repre_info
+        }
 
         self.doc_fetched.emit()
 
@@ -1062,6 +1048,16 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
         "remote_site": "Remote"
     }
 
+    repre_projection = {
+        "_id": 1,
+        "name": 1,
+        "context.subset": 1,
+        "context.asset": 1,
+        "context.version": 1,
+        "context.representation": 1,
+        'files.sites': 1
+    }
+
     def __init__(self, dbcon, header, version_ids):
         super(RepresentationModel, self).__init__()
         self.dbcon = dbcon
@@ -1073,22 +1069,22 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
         sync_server = active_site = remote_site = None
         active_provider = remote_provider = None
 
-        project = dbcon.Session["AVALON_PROJECT"]
-        if project:
+        project_name = dbcon.current_project()
+        if project_name:
             sync_server = manager.modules_by_name["sync_server"]
-            active_site = sync_server.get_active_site(project)
-            remote_site = sync_server.get_remote_site(project)
+            active_site = sync_server.get_active_site(project_name)
+            remote_site = sync_server.get_remote_site(project_name)
 
             # TODO refactor
-            active_provider = \
-                sync_server.get_provider_for_site(project,
-                                                  active_site)
+            active_provider = sync_server.get_provider_for_site(
+                project_name, active_site
+            )
             if active_site == 'studio':
                 active_provider = 'studio'
 
-            remote_provider = \
-                sync_server.get_provider_for_site(project,
-                                                  remote_site)
+            remote_provider = sync_server.get_provider_for_site(
+                project_name, remote_site
+            )
 
             if remote_site == 'studio':
                 remote_provider = 'studio'
@@ -1127,8 +1123,7 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
             if index.column() == self.Columns.index("name"):
                 if item.get("isMerged"):
                     return item["icon"]
-                else:
-                    return self._icons["repre"]
+                return self._icons["repre"]
 
         active_index = self.Columns.index("active_site")
         remote_index = self.Columns.index("remote_site")
@@ -1144,12 +1139,12 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
                 # site added, sync in progress
                 progress_str = "not avail."
                 if progress >= 0:
-                    # progress == 0 for isMerged is unavailable
                     if progress == 0 and item.get("isMerged"):
                         progress_str = "not avail."
                     else:
-                        progress_str = "{}% {}".format(int(progress * 100),
-                                                       label)
+                        progress_str = "{}% {}".format(
+                            int(progress * 100), label
+                        )
 
                 return progress_str
 
@@ -1192,7 +1187,6 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
             if len(self.version_ids) > 1:
                 group = repre_groups.get(doc["name"])
                 if not group:
-
                     group_item = Item()
                     item_id = str(uuid4())
                     group_item.update({
@@ -1213,9 +1207,9 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
                     repre_groups_items[doc["name"]] = 0
                     group = group_item
 
-            progress = lib.get_progress_for_repre(doc,
-                                                  self.active_site,
-                                                  self.remote_site)
+            progress = lib.get_progress_for_repre(
+                doc, self.active_site, self.remote_site
+            )
 
             active_site_icon = self._icons.get(self.active_provider)
             remote_site_icon = self._icons.get(self.remote_provider)
@@ -1248,9 +1242,9 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
                 'remote_site_progress': progress[self.remote_site]
             }
             if group:
-                group = self._sum_group_progress(doc["name"], group,
-                                                 current_progress,
-                                                 repre_groups_items)
+                group = self._sum_group_progress(
+                    doc["name"], group, current_progress, repre_groups_items
+                )
 
             self.add_child(item, group)
 
@@ -1269,47 +1263,40 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
         return self._items_by_id.get(item_id)
 
     def refresh(self):
-        docs = []
-        session_project = self.dbcon.Session['AVALON_PROJECT']
-        if not session_project:
+        project_name = self.dbcon.current_project()
+        if not project_name:
             return
 
+        repre_docs = []
         if self.version_ids:
             # Simple find here for now, expected to receive lower number of
             # representations and logic could be in Python
-            docs = list(self.dbcon.find(
-                {"type": "representation", "parent": {"$in": self.version_ids},
-                 "files.sites.name": {"$exists": 1}}, self.projection()))
-        self._docs = docs
+            repre_docs = list(get_representations(
+                project_name,
+                version_ids=self.version_ids,
+                check_site_name=True,
+                fields=self.repre_projection.keys()
+            ))
+
+        self._docs = repre_docs
 
         self.doc_fetched.emit()
 
-    @classmethod
-    def projection(cls):
-        return {
-            "_id": 1,
-            "name": 1,
-            "context.subset": 1,
-            "context.asset": 1,
-            "context.version": 1,
-            "context.representation": 1,
-            'files.sites': 1
-        }
+    def _sum_group_progress(
+        self, repre_name, group, current_item_progress, repre_groups_items
+    ):
+        """Update final group progress
 
-    def _sum_group_progress(self, repre_name, group, current_item_progress,
-                            repre_groups_items):
-        """
-            Update final group progress
-            Called after every item in group is added
+        Called after every item in group is added
 
-            Args:
-                repre_name(string)
-                group(dict): info about group of selected items
-                current_item_progress(dict): {'active_site_progress': XX,
-                                              'remote_site_progress': YY}
-                repre_groups_items(dict)
-            Returns:
-                (dict): updated group info
+        Args:
+            repre_name(string)
+            group(dict): info about group of selected items
+            current_item_progress(dict): {'active_site_progress': XX,
+                                          'remote_site_progress': YY}
+            repre_groups_items(dict)
+        Returns:
+            (dict): updated group info
         """
         repre_groups_items[repre_name] += 1
 
diff --git a/openpype/tools/loader/widgets.py b/openpype/tools/loader/widgets.py
index 42fb62b632..6c7acc593d 100644
--- a/openpype/tools/loader/widgets.py
+++ b/openpype/tools/loader/widgets.py
@@ -7,6 +7,16 @@ import collections
 
 from Qt import QtWidgets, QtCore, QtGui
 
+from openpype.client import (
+    get_subset_families,
+    get_subset,
+    get_subsets,
+    get_version,
+    get_versions,
+    get_representations,
+    get_thumbnail_id_from_source,
+    get_thumbnail,
+)
 from openpype.api import Anatomy
 from openpype.pipeline import HeroVersionType
 from openpype.pipeline.thumbnail import get_thumbnail_binary
@@ -237,8 +247,7 @@ class SubsetWidget(QtWidgets.QWidget):
         self.model = model
         self.view = view
 
-        actual_project = dbcon.Session["AVALON_PROJECT"]
-        self.on_project_change(actual_project)
+        self.on_project_change(dbcon.current_project())
 
         view.customContextMenuRequested.connect(self.on_context_menu)
 
@@ -302,33 +311,23 @@ class SubsetWidget(QtWidgets.QWidget):
                 item["version_document"]
             )
 
-        subset_docs = list(self.dbcon.find(
-            {
-                "_id": {"$in": list(version_docs_by_subset_id.keys())},
-                "type": "subset"
-            },
-            {
-                "schema": 1,
-                "data.families": 1
-            }
+        project_name = self.dbcon.active_project()
+        subset_docs = list(get_subsets(
+            project_name,
+            subset_ids=version_docs_by_subset_id.keys(),
+            fields=["schema", "data.families"]
         ))
         subset_docs_by_id = {
             subset_doc["_id"]: subset_doc
             for subset_doc in subset_docs
         }
         version_ids = list(version_docs_by_id.keys())
-        repre_docs = self.dbcon.find(
-            # Query all representations for selected versions at once
-            {
-                "type": "representation",
-                "parent": {"$in": version_ids}
-            },
-            # Query only name and parent from representation
-            {
-                "name": 1,
-                "parent": 1
-            }
+        repre_docs = get_representations(
+            project_name,
+            version_ids=version_ids,
+            fields=["name", "parent"]
         )
+
         repre_docs_by_version_id = {
             version_id: []
             for version_id in version_ids
@@ -566,28 +565,42 @@ class SubsetWidget(QtWidgets.QWidget):
             # same representation available
 
             # Trigger
-            repre_ids = []
+            project_name = self.dbcon.active_project()
+            subset_names_by_version_id = collections.defaultdict(set)
             for item in items:
-                representation = self.dbcon.find_one(
-                    {
-                        "type": "representation",
-                        "name": representation_name,
-                        "parent": item["version_document"]["_id"]
-                    },
-                    {"_id": 1}
-                )
-                if not representation:
-                    self.echo("Subset '{}' has no representation '{}'".format(
-                        item["subset"], representation_name
-                    ))
-                    continue
-                repre_ids.append(representation["_id"])
+                version_id = item["version_document"]["_id"]
+                subset_names_by_version_id[version_id].add(item["subset"])
+
+            version_ids = set(subset_names_by_version_id.keys())
+            repre_docs = get_representations(
+                project_name,
+                representation_names=[representation_name],
+                version_ids=version_ids,
+                fields=["_id", "parent"]
+            )
+
+            repre_ids = []
+            for repre_doc in repre_docs:
+                repre_ids.append(repre_doc["_id"])
+
+                version_id = repre_doc["parent"]
+                if version_id not in version_ids:
+                    version_ids.remove(version_id)
+
+            for version_id in version_ids:
+                joined_subset_names = ", ".join([
+                    '"{}"'.format(subset)
+                    for subset in subset_names_by_version_id[version_id]
+                ])
+                self.echo("Subsets {} don't have representation '{}'".format(
+                    joined_subset_names, representation_name
+                ))
 
             # get contexts only for selected menu option
             repre_contexts = get_repres_contexts(repre_ids, self.dbcon)
-            options = lib.get_options(action, loader, self,
-                                      list(repre_contexts.values()))
-
+            options = lib.get_options(
+                action, loader, self, list(repre_contexts.values())
+            )
             error_info = _load_representations_by_loader(
                 loader, repre_contexts, options=options
             )
@@ -661,27 +674,21 @@ class VersionTextEdit(QtWidgets.QTextEdit):
 
         print("Querying..")
 
+        project_name = self.dbcon.active_project()
         if not version_doc:
-            version_doc = self.dbcon.find_one({
-                "_id": version_id,
-                "type": {"$in": ["version", "hero_version"]}
-            })
+            version_doc = get_version(project_name, version_id=version_id)
             assert version_doc, "Not a valid version id"
 
         if version_doc["type"] == "hero_version":
-            _version_doc = self.dbcon.find_one({
-                "_id": version_doc["version_id"],
-                "type": "version"
-            })
+            _version_doc = get_version(
+                project_name, version_id=version_doc["version_id"]
+            )
             version_doc["data"] = _version_doc["data"]
             version_doc["name"] = HeroVersionType(
                 _version_doc["name"]
             )
 
-        subset = self.dbcon.find_one({
-            "_id": version_doc["parent"],
-            "type": "subset"
-        })
+        subset = get_subset(project_name, subset_id=version_doc["parent"])
         assert subset, "No valid subset parent for version"
 
         # Define readable creation timestamp
@@ -752,7 +759,7 @@ class VersionTextEdit(QtWidgets.QTextEdit):
         if not source:
             return
 
-        project_name = self.dbcon.Session["AVALON_PROJECT"]
+        project_name = self.dbcon.current_project()
         if self._anatomy is None or self._anatomy.project_name != project_name:
             self._anatomy = Anatomy(project_name)
 
@@ -833,24 +840,19 @@ class ThumbnailWidget(QtWidgets.QLabel):
             QtCore.Qt.SmoothTransformation
         )
 
-    def set_thumbnail(self, doc_id=None):
-        if not doc_id:
+    def set_thumbnail(self, src_type, doc_ids):
+        if not doc_ids:
             self.set_pixmap()
             return
 
-        if isinstance(doc_id, (list, tuple)):
-            if len(doc_id) < 1:
-                self.set_pixmap()
-                return
-            doc_id = doc_id[0]
+        src_id = doc_ids[0]
 
-        doc = self.dbcon.find_one(
-            {"_id": doc_id},
-            {"data.thumbnail_id"}
+        project_name = self.dbcon.active_project()
+        thumbnail_id = get_thumbnail_id_from_source(
+            project_name,
+            src_type,
+            src_id,
         )
-        thumbnail_id = None
-        if doc:
-            thumbnail_id = doc.get("data", {}).get("thumbnail_id")
         if thumbnail_id == self.current_thumb_id:
             if self.current_thumbnail is None:
                 self.set_pixmap()
@@ -861,9 +863,7 @@ class ThumbnailWidget(QtWidgets.QLabel):
             self.set_pixmap()
             return
 
-        thumbnail_ent = self.dbcon.find_one(
-            {"type": "thumbnail", "_id": thumbnail_id}
-        )
+        thumbnail_ent = get_thumbnail(project_name, thumbnail_id)
         if not thumbnail_ent:
             return
 
@@ -917,21 +917,9 @@ class FamilyModel(QtGui.QStandardItemModel):
 
     def refresh(self):
         families = set()
-        if self.dbcon.Session.get("AVALON_PROJECT"):
-            result = list(self.dbcon.aggregate([
-                {"$match": {
-                    "type": "subset"
-                }},
-                {"$project": {
-                    "family": {"$arrayElemAt": ["$data.families", 0]}
-                }},
-                {"$group": {
-                    "_id": "family_group",
-                    "families": {"$addToSet": "$family"}
-                }}
-            ]))
-            if result:
-                families = set(result[0]["families"])
+        project_name = self.dbcon.current_project()
+        if project_name:
+            families = get_subset_families(project_name)
 
         root_item = self.invisibleRootItem()
 
@@ -1213,8 +1201,8 @@ class RepresentationWidget(QtWidgets.QWidget):
         self.proxy_model = proxy_model
 
         self.sync_server_enabled = False
-        actual_project = dbcon.Session["AVALON_PROJECT"]
-        self.on_project_change(actual_project)
+
+        self.on_project_change(dbcon.current_project())
 
         self.model.refresh()
 
@@ -1243,23 +1231,18 @@ class RepresentationWidget(QtWidgets.QWidget):
         for item in items:
             repre_ids.append(item["_id"])
 
-        repre_docs = list(self.dbcon.find(
-            {
-                "type": "representation",
-                "_id": {"$in": repre_ids}
-            },
-            {
-                "name": 1,
-                "parent": 1
-            }
-        ))
+        project_name = self.dbcon.actual_project()
+        repre_docs = get_representations(
+            project_name,
+            representation_ids=repre_ids,
+            fields=["name", "parent"]
+        )
+
         version_ids = [
             repre_doc["parent"]
             for repre_doc in repre_docs
         ]
-        version_docs = self.dbcon.find({
-            "_id": {"$in": version_ids}
-        })
+        version_docs = get_versions(project_name, version_ids=version_ids)
 
         version_docs_by_id = {}
         version_docs_by_subset_id = collections.defaultdict(list)
@@ -1269,15 +1252,10 @@ class RepresentationWidget(QtWidgets.QWidget):
             version_docs_by_id[version_id] = version_doc
             version_docs_by_subset_id[subset_id].append(version_doc)
 
-        subset_docs = list(self.dbcon.find(
-            {
-                "_id": {"$in": list(version_docs_by_subset_id.keys())},
-                "type": "subset"
-            },
-            {
-                "schema": 1,
-                "data.families": 1
-            }
+        subset_docs = list(get_subsets(
+            project_name,
+            subset_ids=version_docs_by_subset_id.keys(),
+            fields=["schema", "data.families"]
         ))
         subset_docs_by_id = {
             subset_doc["_id"]: subset_doc
@@ -1446,13 +1424,12 @@ class RepresentationWidget(QtWidgets.QWidget):
         self._process_action(items, menu, point)
 
     def _process_action(self, items, menu, point):
-        """
-            Show the context action menu and process selected
+        """Show the context action menu and process selected
 
-            Args:
-                items(dict): menu items
-                menu(OptionalMenu)
-                point(PointIndex)
+        Args:
+            items(dict): menu items
+            menu(OptionalMenu)
+            point(PointIndex)
         """
         global_point = self.tree_view.mapToGlobal(point)
         action = menu.exec_(global_point)
@@ -1468,21 +1445,23 @@ class RepresentationWidget(QtWidgets.QWidget):
         data_by_repre_id = {}
         selected_side = action_representation.get("selected_side")
 
+        is_sync_loader = tools_lib.is_sync_loader(loader)
         for item in items:
-            if tools_lib.is_sync_loader(loader):
-                site_name = "{}_site_name".format(selected_side)
-                data = {
-                    "_id": item.get("_id"),
-                    "site_name": item.get(site_name),
-                    "project_name": self.dbcon.Session["AVALON_PROJECT"]
-                }
+            item_id = item.get("_id")
+            repre_ids.append(item_id)
+            if not is_sync_loader:
+                continue
 
-                if not data["site_name"]:
-                    continue
+            site_name = "{}_site_name".format(selected_side)
+            data_site_name = item.get(site_name)
+            if not data_site_name:
+                continue
 
-                data_by_repre_id[data["_id"]] = data
-
-            repre_ids.append(item.get("_id"))
+            data_by_repre_id[item_id] = {
+                "_id": item_id,
+                "site_name": data_site_name,
+                "project_name": self.dbcon.active_project()
+            }
 
         repre_contexts = get_repres_contexts(repre_ids, self.dbcon)
         options = lib.get_options(action, loader, self,
diff --git a/openpype/tools/mayalookassigner/app.py b/openpype/tools/mayalookassigner/app.py
index 1b6cad77a8..427edf8245 100644
--- a/openpype/tools/mayalookassigner/app.py
+++ b/openpype/tools/mayalookassigner/app.py
@@ -4,6 +4,7 @@ import logging
 
 from Qt import QtWidgets, QtCore
 
+from openpype.client import get_last_version_for_subset
 from openpype import style
 from openpype.pipeline import legacy_io
 from openpype.tools.utils.lib import qt_app_context
@@ -211,6 +212,7 @@ class MayaLookAssignerWindow(QtWidgets.QWidget):
         selection = self.assign_selected.isChecked()
         asset_nodes = self.asset_outliner.get_nodes(selection=selection)
 
+        project_name = legacy_io.active_project()
         start = time.time()
         for i, (asset, item) in enumerate(asset_nodes.items()):
 
@@ -222,23 +224,20 @@ class MayaLookAssignerWindow(QtWidgets.QWidget):
             assign_look = next((subset for subset in item["looks"]
                                 if subset["name"] in looks), None)
             if not assign_look:
-                self.echo("{} No matching selected "
-                          "look for {}".format(prefix, asset))
+                self.echo(
+                    "{} No matching selected look for {}".format(prefix, asset)
+                )
                 continue
 
             # Get the latest version of this asset's look subset
-            version = legacy_io.find_one(
-                {
-                    "type": "version",
-                    "parent": assign_look["_id"]
-                },
-                sort=[("name", -1)]
+            version = get_last_version_for_subset(
+                project_name, subset_id=assign_look["_id"], fields=["_id"]
             )
 
             subset_name = assign_look["name"]
-            self.echo("{} Assigning {} to {}\t".format(prefix,
-                                                       subset_name,
-                                                       asset))
+            self.echo("{} Assigning {} to {}\t".format(
+                prefix, subset_name, asset
+            ))
             nodes = item["nodes"]
 
             if cmds.pluginInfo('vrayformaya', query=True, loaded=True):
diff --git a/openpype/tools/mayalookassigner/commands.py b/openpype/tools/mayalookassigner/commands.py
index d41d8ca5a2..a4fc1fab70 100644
--- a/openpype/tools/mayalookassigner/commands.py
+++ b/openpype/tools/mayalookassigner/commands.py
@@ -2,9 +2,9 @@ from collections import defaultdict
 import logging
 import os
 
-from bson.objectid import ObjectId
 import maya.cmds as cmds
 
+from openpype.client import get_asset
 from openpype.pipeline import (
     legacy_io,
     remove_container,
@@ -159,11 +159,9 @@ def create_items_from_nodes(nodes):
         log.warning("No id hashes")
         return asset_view_items
 
+    project_name = legacy_io.active_project()
     for _id, id_nodes in id_hashes.items():
-        asset = legacy_io.find_one(
-            {"_id": ObjectId(_id)},
-            projection={"name": True}
-        )
+        asset = get_asset(project_name, asset_id=_id, fields=["name"])
 
         # Skip if asset id is not found
         if not asset:
@@ -180,10 +178,12 @@ def create_items_from_nodes(nodes):
             namespace = get_namespace_from_node(node)
             namespaces.add(namespace)
 
-        asset_view_items.append({"label": asset["name"],
-                                 "asset": asset,
-                                 "looks": looks,
-                                 "namespaces": namespaces})
+        asset_view_items.append({
+            "label": asset["name"],
+            "asset": asset,
+            "looks": looks,
+            "namespaces": namespaces
+        })
 
     return asset_view_items
 
diff --git a/openpype/tools/mayalookassigner/vray_proxies.py b/openpype/tools/mayalookassigner/vray_proxies.py
index 3523b24bf3..b2ba21f944 100644
--- a/openpype/tools/mayalookassigner/vray_proxies.py
+++ b/openpype/tools/mayalookassigner/vray_proxies.py
@@ -6,11 +6,14 @@ import logging
 import json
 
 import six
-from bson.objectid import ObjectId
 
 import alembic.Abc
 from maya import cmds
 
+from openpype.client import (
+    get_representation_by_name,
+    get_last_version_for_subset,
+)
 from openpype.pipeline import (
     legacy_io,
     load_container,
@@ -155,13 +158,12 @@ def get_look_relationships(version_id):
 
     Returns:
         dict: Dictionary of relations.
-
     """
-    json_representation = legacy_io.find_one({
-        "type": "representation",
-        "parent": version_id,
-        "name": "json"
-    })
+
+    project_name = legacy_io.active_project()
+    json_representation = get_representation_by_name(
+        project_name, representation_name="json", version_id=version_id
+    )
 
     # Load relationships
     shader_relation = get_representation_path(json_representation)
@@ -184,12 +186,12 @@ def load_look(version_id):
         list of shader nodes.
 
     """
+
+    project_name = legacy_io.active_project()
     # Get representations of shader file and relationships
-    look_representation = legacy_io.find_one({
-        "type": "representation",
-        "parent": version_id,
-        "name": "ma"
-    })
+    look_representation = get_representation_by_name(
+        project_name, representation_name="ma", version_id=version_id
+    )
 
     # See if representation is already loaded, if so reuse it.
     host = registered_host()
@@ -220,42 +222,6 @@ def load_look(version_id):
     return shader_nodes
 
 
-def get_latest_version(asset_id, subset):
-    # type: (str, str) -> dict
-    """Get latest version of subset.
-
-    Args:
-        asset_id (str): Asset ID
-        subset (str): Subset name.
-
-    Returns:
-        Latest version
-
-    Throws:
-        RuntimeError: When subset or version doesn't exist.
-
-    """
-    subset = legacy_io.find_one({
-        "name": subset,
-        "parent": ObjectId(asset_id),
-        "type": "subset"
-    })
-    if not subset:
-        raise RuntimeError("Subset does not exist: %s" % subset)
-
-    version = legacy_io.find_one(
-        {
-            "type": "version",
-            "parent": subset["_id"]
-        },
-        sort=[("name", -1)]
-    )
-    if not version:
-        raise RuntimeError("Version does not exist.")
-
-    return version
-
-
 def vrayproxy_assign_look(vrayproxy, subset="lookDefault"):
     # type: (str, str) -> None
     """Assign look to vray proxy.
@@ -281,13 +247,20 @@ def vrayproxy_assign_look(vrayproxy, subset="lookDefault"):
         asset_id = node_id.split(":", 1)[0]
         node_ids_by_asset_id[asset_id].add(node_id)
 
+    project_name = legacy_io.active_project()
     for asset_id, node_ids in node_ids_by_asset_id.items():
 
         # Get latest look version
-        try:
-            version = get_latest_version(asset_id, subset=subset)
-        except RuntimeError as exc:
-            print(exc)
+        version = get_last_version_for_subset(
+            project_name,
+            subset_name=subset,
+            asset_id=asset_id,
+            fields=["_id"]
+        )
+        if not version:
+            print("Didn't find last version for subset name {}".format(
+                subset
+            ))
             continue
 
         relationships = get_look_relationships(version["_id"])
diff --git a/openpype/tools/project_manager/project_manager/model.py b/openpype/tools/project_manager/project_manager/model.py
index 223cfa629d..c5bde5aaec 100644
--- a/openpype/tools/project_manager/project_manager/model.py
+++ b/openpype/tools/project_manager/project_manager/model.py
@@ -7,6 +7,11 @@ from pymongo import UpdateOne, DeleteOne
 
 from Qt import QtCore, QtGui
 
+from openpype.client import (
+    get_project,
+    get_assets,
+    get_asset_ids_with_subsets,
+)
 from openpype.lib import (
     CURRENT_DOC_SCHEMAS,
     PypeLogger,
@@ -255,10 +260,11 @@ class HierarchyModel(QtCore.QAbstractItemModel):
             return
 
         # Find project'd document
-        project_doc = self.dbcon.database[project_name].find_one(
-            {"type": "project"},
-            ProjectItem.query_projection
+        project_doc = get_project(
+            project_name,
+            fields=list(ProjectItem.query_projection.keys())
         )
+
         # Skip if project document does not exist
         # - this shouldn't happen using only UI elements
         if not project_doc:
@@ -269,9 +275,8 @@ class HierarchyModel(QtCore.QAbstractItemModel):
         self.add_item(project_item)
 
         # Query all assets of the project
-        asset_docs = self.dbcon.database[project_name].find(
-            {"type": "asset"},
-            AssetItem.query_projection
+        asset_docs = get_assets(
+            project_name, fields=AssetItem.query_projection.keys()
         )
         asset_docs_by_id = {
             asset_doc["_id"]: asset_doc
@@ -282,31 +287,16 @@ class HierarchyModel(QtCore.QAbstractItemModel):
         #   if asset item can be modified (name and hierarchy change)
         # - the same must be applied to all it's parents
         asset_ids = list(asset_docs_by_id.keys())
-        result = []
+        asset_ids_with_subsets = []
         if asset_ids:
-            result = self.dbcon.database[project_name].aggregate([
-                {
-                    "$match": {
-                        "type": "subset",
-                        "parent": {"$in": asset_ids}
-                    }
-                },
-                {
-                    "$group": {
-                        "_id": "$parent",
-                        "count": {"$sum": 1}
-                    }
-                }
-            ])
+            asset_ids_with_subsets = get_asset_ids_with_subsets(
+                project_name, asset_ids=asset_ids
+            )
 
         asset_modifiable = {
-            asset_id: True
+            asset_id: asset_id not in asset_ids_with_subsets
             for asset_id in asset_docs_by_id.keys()
         }
-        for item in result:
-            asset_id = item["_id"]
-            count = item["count"]
-            asset_modifiable[asset_id] = count < 1
 
         # Store assets by their visual parent to be able create their hierarchy
         asset_docs_by_parent_id = collections.defaultdict(list)
diff --git a/openpype/tools/project_manager/project_manager/view.py b/openpype/tools/project_manager/project_manager/view.py
index 4b5bc36aeb..e9d2874c54 100644
--- a/openpype/tools/project_manager/project_manager/view.py
+++ b/openpype/tools/project_manager/project_manager/view.py
@@ -3,6 +3,7 @@ from queue import Queue
 
 from Qt import QtWidgets, QtCore, QtGui
 
+from openpype.client import get_project
 from .delegates import (
     NumberDelegate,
     NameDelegate,
@@ -47,12 +48,8 @@ class ProjectDocCache:
     def set_project(self, project_name):
         self.project_doc = None
 
-        if not project_name:
-            return
-
-        self.project_doc = self.dbcon.database[project_name].find_one(
-            {"type": "project"}
-        )
+        if project_name:
+            self.project_doc = get_project(project_name)
 
 
 class ToolsCache:
diff --git a/openpype/tools/project_manager/project_manager/widgets.py b/openpype/tools/project_manager/project_manager/widgets.py
index dc75b30bd7..371d1ba2ef 100644
--- a/openpype/tools/project_manager/project_manager/widgets.py
+++ b/openpype/tools/project_manager/project_manager/widgets.py
@@ -1,5 +1,6 @@
 import re
 
+from openpype.client import get_projects
 from .constants import (
     NAME_ALLOWED_SYMBOLS,
     NAME_REGEX
@@ -272,15 +273,9 @@ class CreateProjectDialog(QtWidgets.QDialog):
     def _get_existing_projects(self):
         project_names = set()
         project_codes = set()
-        for project_name in self.dbcon.database.collection_names():
-            # Each collection will have exactly one project document
-            project_doc = self.dbcon.database[project_name].find_one(
-                {"type": "project"},
-                {"name": 1, "data.code": 1}
-            )
-            if not project_doc:
-                continue
-
+        for project_doc in get_projects(
+            inactive=True, fields=["name", "data.code"]
+        ):
             project_name = project_doc.get("name")
             if not project_name:
                 continue
diff --git a/openpype/tools/publisher/control.py b/openpype/tools/publisher/control.py
index 2973d6a5bb..915fb7f32e 100644
--- a/openpype/tools/publisher/control.py
+++ b/openpype/tools/publisher/control.py
@@ -13,6 +13,7 @@ except Exception:
 
 import pyblish.api
 
+from openpype.client import get_assets
 from openpype.pipeline import (
     PublishValidationError,
     registered_host,
@@ -116,10 +117,10 @@ class AssetDocsCache:
 
     def _query(self):
         if self._asset_docs is None:
-            asset_docs = list(self.dbcon.find(
-                {"type": "asset"},
-                self.projection
-            ))
+            project_name = self.dbcon.active_project()
+            asset_docs = get_assets(
+                project_name, fields=self.projection.keys()
+            )
             task_names_by_asset_name = {}
             for asset_doc in asset_docs:
                 asset_name = asset_doc["name"]
diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index 9e357f3a56..d579831b21 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -9,6 +9,8 @@ try:
 except Exception:
     commonmark = None
 from Qt import QtWidgets, QtCore, QtGui
+
+from openpype.client import get_asset, get_subsets
 from openpype.lib import TaskNotSetError
 from openpype.pipeline.create import (
     CreatorError,
@@ -647,21 +649,19 @@ class CreateDialog(QtWidgets.QDialog):
         if asset_name is None:
             return
 
-        asset_doc = self.dbcon.find_one({
-            "type": "asset",
-            "name": asset_name
-        })
+        project_name = self.dbcon.active_project()
+        asset_doc = get_asset(project_name, asset_name=asset_name)
         self._asset_doc = asset_doc
 
         if asset_doc:
-            subset_docs = self.dbcon.find(
-                {
-                    "type": "subset",
-                    "parent": asset_doc["_id"]
-                },
-                {"name": 1}
+            asset_id = asset_doc["_id"]
+            subset_docs = get_subsets(
+                project_name, asset_ids=[asset_id], fields=["name"]
             )
-            self._subset_names = set(subset_docs.distinct("name"))
+            self._subset_names = {
+                subset_doc["name"]
+                for subset_doc in subset_docs
+            }
 
         if not asset_doc:
             self.subset_name_input.setText("< Asset is not set >")
diff --git a/openpype/tools/sceneinventory/model.py b/openpype/tools/sceneinventory/model.py
index 8d72020c98..9cf69ed650 100644
--- a/openpype/tools/sceneinventory/model.py
+++ b/openpype/tools/sceneinventory/model.py
@@ -5,8 +5,14 @@ from collections import defaultdict
 
 from Qt import QtCore, QtGui
 import qtawesome
-from bson.objectid import ObjectId
 
+from openpype.client import (
+    get_asset,
+    get_subset,
+    get_version,
+    get_last_version_for_subset,
+    get_representation,
+)
 from openpype.pipeline import (
     legacy_io,
     schema,
@@ -55,7 +61,7 @@ class InventoryModel(TreeModel):
         if not self.sync_enabled:
             return
 
-        project_name = legacy_io.Session["AVALON_PROJECT"]
+        project_name = legacy_io.current_project()
         active_site = sync_server.get_active_site(project_name)
         remote_site = sync_server.get_remote_site(project_name)
 
@@ -291,6 +297,9 @@ class InventoryModel(TreeModel):
             node.Item: root node which has children added based on the data
         """
 
+        # NOTE: @iLLiCiTiT this need refactor
+        project_name = legacy_io.active_project()
+
         self.beginResetModel()
 
         # Group by representation
@@ -304,32 +313,36 @@ class InventoryModel(TreeModel):
         for repre_id, group_dict in sorted(grouped.items()):
             group_items = group_dict["items"]
             # Get parenthood per group
-            representation = legacy_io.find_one({"_id": ObjectId(repre_id)})
+            representation = get_representation(
+                project_name, representation_id=repre_id
+            )
             if not representation:
                 not_found["representation"].append(group_items)
                 not_found_ids.append(repre_id)
                 continue
 
-            version = legacy_io.find_one({"_id": representation["parent"]})
+            version = get_version(
+                project_name, version_id=representation["parent"]
+            )
             if not version:
                 not_found["version"].append(group_items)
                 not_found_ids.append(repre_id)
                 continue
 
             elif version["type"] == "hero_version":
-                _version = legacy_io.find_one({
-                    "_id": version["version_id"]
-                })
+                _version = get_version(
+                    project_name, version_id=version["version_id"]
+                )
                 version["name"] = HeroVersionType(_version["name"])
                 version["data"] = _version["data"]
 
-            subset = legacy_io.find_one({"_id": version["parent"]})
+            subset = get_subset(project_name, subset_id=version["parent"])
             if not subset:
                 not_found["subset"].append(group_items)
                 not_found_ids.append(repre_id)
                 continue
 
-            asset = legacy_io.find_one({"_id": subset["parent"]})
+            asset = get_asset(project_name, asset_id=subset["parent"])
             if not asset:
                 not_found["asset"].append(group_items)
                 not_found_ids.append(repre_id)
@@ -390,10 +403,9 @@ class InventoryModel(TreeModel):
 
             # Store the highest available version so the model can know
             # whether current version is currently up-to-date.
-            highest_version = legacy_io.find_one({
-                "type": "version",
-                "parent": version["parent"]
-            }, sort=[("name", -1)])
+            highest_version = get_last_version_for_subset(
+                project_name, subset_id=version["parent"]
+            )
 
             # create the group header
             group_node = Item()
diff --git a/openpype/tools/sceneinventory/switch_dialog.py b/openpype/tools/sceneinventory/switch_dialog.py
index b2d770330f..b940c66a56 100644
--- a/openpype/tools/sceneinventory/switch_dialog.py
+++ b/openpype/tools/sceneinventory/switch_dialog.py
@@ -4,6 +4,16 @@ from Qt import QtWidgets, QtCore
 import qtawesome
 from bson.objectid import ObjectId
 
+from openpype.client import (
+    get_asset,
+    get_assets,
+    get_subset,
+    get_subsets,
+    get_versions,
+    get_hero_versions,
+    get_last_versions,
+    get_representations,
+)
 from openpype.pipeline import legacy_io
 from openpype.pipeline.load import (
     discover_loader_plugins,
@@ -144,6 +154,9 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         self._prepare_content_data()
         self.refresh(True)
 
+    def active_project(self):
+        return legacy_io.active_project()
+
     def _prepare_content_data(self):
         repre_ids = set()
         content_loaders = set()
@@ -151,10 +164,12 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             repre_ids.add(ObjectId(item["representation"]))
             content_loaders.add(item["loader"])
 
-        repres = list(legacy_io.find({
-            "type": {"$in": ["representation", "archived_representation"]},
-            "_id": {"$in": list(repre_ids)}
-        }))
+        project_name = self.active_project()
+        repres = get_representations(
+            project_name,
+            representation_ids=repre_ids,
+            archived=True
+        )
         repres_by_id = {repre["_id"]: repre for repre in repres}
 
         # stash context values, works only for single representation
@@ -179,10 +194,11 @@ class SwitchAssetDialog(QtWidgets.QDialog):
                 content_repres[repre_id] = repres_by_id[repre_id]
                 version_ids.append(repre["parent"])
 
-        versions = legacy_io.find({
-            "type": {"$in": ["version", "hero_version"]},
-            "_id": {"$in": list(set(version_ids))}
-        })
+        versions = get_versions(
+            project_name,
+            version_ids=set(version_ids),
+            hero=True
+        )
         content_versions = {}
         hero_version_ids = set()
         for version in versions:
@@ -198,10 +214,9 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             else:
                 subset_ids.append(content_versions[version_id]["parent"])
 
-        subsets = legacy_io.find({
-            "type": {"$in": ["subset", "archived_subset"]},
-            "_id": {"$in": subset_ids}
-        })
+        subsets = get_subsets(
+            project_name, subset_ids=subset_ids, archived=True
+        )
         subsets_by_id = {sub["_id"]: sub for sub in subsets}
 
         asset_ids = []
@@ -220,10 +235,7 @@ class SwitchAssetDialog(QtWidgets.QDialog):
                 asset_ids.append(subset["parent"])
                 content_subsets[subset_id] = subset
 
-        assets = legacy_io.find({
-            "type": {"$in": ["asset", "archived_asset"]},
-            "_id": {"$in": list(asset_ids)}
-        })
+        assets = get_assets(project_name, asset_ids=asset_ids, archived=True)
         assets_by_id = {asset["_id"]: asset for asset in assets}
 
         missing_assets = []
@@ -472,9 +484,10 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         # Prepare asset document if asset is selected
         asset_doc = None
         if selected_asset:
-            asset_doc = legacy_io.find_one(
-                {"type": "asset", "name": selected_asset},
-                {"_id": True}
+            asset_doc = get_asset(
+                self.active_project(),
+                asset_name=selected_asset,
+                fields=["_id"]
             )
             if not asset_doc:
                 return []
@@ -523,38 +536,35 @@ class SwitchAssetDialog(QtWidgets.QDialog):
     def _get_current_output_repre_ids_xxx(
         self, asset_doc, selected_subset, selected_repre
     ):
-        subset_doc = legacy_io.find_one(
-            {
-                "type": "subset",
-                "name": selected_subset,
-                "parent": asset_doc["_id"]
-            },
-            {"_id": True}
+        project_name = self.active_project()
+        subset_doc = get_subset(
+            project_name,
+            subset_name=selected_subset,
+            asset_id=asset_doc["_id"],
+            fields=["_id"]
         )
+
         subset_id = subset_doc["_id"]
         last_versions_by_subset_id = self.find_last_versions([subset_id])
         version_doc = last_versions_by_subset_id.get(subset_id)
         if not version_doc:
             return []
 
-        repre_docs = legacy_io.find(
-            {
-                "type": "representation",
-                "parent": version_doc["_id"],
-                "name": selected_repre
-            },
-            {"_id": True}
+        repre_docs = get_representations(
+            project_name,
+            version_ids=[version_doc["_id"]],
+            representation_names=[selected_repre],
+            fields=["_id"]
         )
         return [repre_doc["_id"] for repre_doc in repre_docs]
 
     def _get_current_output_repre_ids_xxo(self, asset_doc, selected_subset):
-        subset_doc = legacy_io.find_one(
-            {
-                "type": "subset",
-                "parent": asset_doc["_id"],
-                "name": selected_subset
-            },
-            {"_id": True}
+        project_name = self.active_project()
+        subset_doc = get_subset(
+            project_name,
+            asset_id=asset_doc["_id"],
+            subset_name=selected_subset,
+            fields=["_id"]
         )
         if not subset_doc:
             return []
@@ -563,41 +573,51 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         for repre_doc in self.content_repres.values():
             repre_names.add(repre_doc["name"])
 
-        repre_docs = legacy_io.find(
-            {
-                "type": "representation",
-                "parent": subset_doc["_id"],
-                "name": {"$in": list(repre_names)}
-            },
-            {"_id": True}
+        # TODO where to take version ids?
+        version_ids = []
+        repre_docs = get_representations(
+            project_name,
+            representation_names=repre_names,
+            version_ids=version_ids,
+            fields=["_id"]
         )
         return [repre_doc["_id"] for repre_doc in repre_docs]
 
     def _get_current_output_repre_ids_xox(self, asset_doc, selected_repre):
-        susbet_names = set()
+        subset_names = set()
         for subset_doc in self.content_subsets.values():
-            susbet_names.add(subset_doc["name"])
+            subset_names.add(subset_doc["name"])
 
-        subset_docs = legacy_io.find(
-            {
-                "type": "subset",
-                "name": {"$in": list(susbet_names)},
-                "parent": asset_doc["_id"]
-            },
-            {"_id": True}
+        project_name = self.active_project()
+        subset_docs = get_subsets(
+            project_name,
+            asset_ids=[asset_doc["_id"]],
+            subset_names=subset_names,
+            fields=["_id", "name"]
         )
-        subset_ids = [subset_doc["_id"] for subset_doc in subset_docs]
-        repre_docs = legacy_io.find(
-            {
-                "type": "representation",
-                "parent": {"$in": subset_ids},
-                "name": selected_repre
-            },
-            {"_id": True}
+        subset_name_by_id = {
+            subset_doc["_id"]: subset_doc["name"]
+            for subset_doc in subset_docs
+        }
+        subset_ids = list(subset_name_by_id.keys())
+        last_versions_by_subset_id = self.find_last_versions(subset_ids)
+        last_version_id_by_subset_name = {}
+        for subset_id, last_version in last_versions_by_subset_id.items():
+            subset_name = subset_name_by_id[subset_id]
+            last_version_id_by_subset_name[subset_name] = (
+                last_version["_id"]
+            )
+
+        repre_docs = get_representations(
+            project_name,
+            version_ids=last_version_id_by_subset_name.values(),
+            representation_names=[selected_repre],
+            fields=["_id"]
         )
         return [repre_doc["_id"] for repre_doc in repre_docs]
 
     def _get_current_output_repre_ids_xoo(self, asset_doc):
+        project_name = self.active_project()
         repres_by_subset_name = collections.defaultdict(set)
         for repre_doc in self.content_repres.values():
             repre_name = repre_doc["name"]
@@ -606,13 +626,11 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             subset_name = subset_doc["name"]
             repres_by_subset_name[subset_name].add(repre_name)
 
-        subset_docs = list(legacy_io.find(
-            {
-                "type": "subset",
-                "parent": asset_doc["_id"],
-                "name": {"$in": list(repres_by_subset_name.keys())}
-            },
-            {"_id": True, "name": True}
+        subset_docs = list(get_subsets(
+            project_name,
+            asset_ids=[asset_doc["_id"]],
+            subset_names=repres_by_subset_name.keys(),
+            fields=["_id", "name"]
         ))
         subset_name_by_id = {
             subset_doc["_id"]: subset_doc["name"]
@@ -627,60 +645,59 @@ class SwitchAssetDialog(QtWidgets.QDialog):
                 last_version["_id"]
             )
 
-        repre_or_query = []
+        repre_names_by_version_id = {}
         for subset_name, repre_names in repres_by_subset_name.items():
             version_id = last_version_id_by_subset_name.get(subset_name)
             # This should not happen but why to crash?
-            if version_id is None:
-                continue
-            repre_or_query.append({
-                "parent": version_id,
-                "name": {"$in": list(repre_names)}
-            })
-        repre_docs = legacy_io.find(
-            {"$or": repre_or_query},
-            {"_id": True}
+            if version_id is not None:
+                repre_names_by_version_id[version_id] = list(repre_names)
+
+        repre_docs = get_representations(
+            project_name,
+            names_by_version_ids=repre_names_by_version_id,
+            fields=["_id"]
         )
         return [repre_doc["_id"] for repre_doc in repre_docs]
 
     def _get_current_output_repre_ids_oxx(
         self, selected_subset, selected_repre
     ):
-        subset_docs = list(legacy_io.find({
-            "type": "subset",
-            "parent": {"$in": list(self.content_assets.keys())},
-            "name": selected_subset
-        }))
+        project_name = self.active_project()
+        subset_docs = get_subsets(
+            project_name,
+            asset_ids=self.content_assets.keys(),
+            subset_names=[selected_subset],
+            fields=["_id"]
+        )
         subset_ids = [subset_doc["_id"] for subset_doc in subset_docs]
         last_versions_by_subset_id = self.find_last_versions(subset_ids)
         last_version_ids = [
             last_version["_id"]
             for last_version in last_versions_by_subset_id.values()
         ]
-        repre_docs = legacy_io.find({
-            "type": "representation",
-            "parent": {"$in": last_version_ids},
-            "name": selected_repre
-        })
-
+        repre_docs = get_representations(
+            project_name,
+            version_ids=last_version_ids,
+            representation_names=[selected_repre],
+            fields=["_id"]
+        )
         return [repre_doc["_id"] for repre_doc in repre_docs]
 
     def _get_current_output_repre_ids_oxo(self, selected_subset):
-        subset_docs = list(legacy_io.find(
-            {
-                "type": "subset",
-                "parent": {"$in": list(self.content_assets.keys())},
-                "name": selected_subset
-            },
-            {"_id": True, "parent": True}
-        ))
-        if not subset_docs:
-            return list()
-
+        project_name = self.active_project()
+        subset_docs = get_subsets(
+            project_name,
+            asset_ids=self.content_assets.keys(),
+            subset_names=[selected_subset],
+            fields=["_id", "parent"]
+        )
         subset_docs_by_id = {
             subset_doc["_id"]: subset_doc
             for subset_doc in subset_docs
         }
+        if not subset_docs:
+            return list()
+
         last_versions_by_subset_id = self.find_last_versions(
             subset_docs_by_id.keys()
         )
@@ -702,56 +719,44 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             asset_id = asset_doc["_id"]
             repre_names_by_asset_id[asset_id].add(repre_name)
 
-        repre_or_query = []
+        repre_names_by_version_id = {}
         for last_version_id, subset_id in subset_id_by_version_id.items():
             subset_doc = subset_docs_by_id[subset_id]
             asset_id = subset_doc["parent"]
             repre_names = repre_names_by_asset_id.get(asset_id)
             if not repre_names:
                 continue
-            repre_or_query.append({
-                "parent": last_version_id,
-                "name": {"$in": list(repre_names)}
-            })
-        repre_docs = legacy_io.find(
-            {
-                "type": "representation",
-                "$or": repre_or_query
-            },
-            {"_id": True}
-        )
+            repre_names_by_version_id[last_version_id] = repre_names
 
+        repre_docs = get_representations(
+            project_name,
+            names_by_version_ids=repre_names_by_version_id,
+            fields=["_id"]
+        )
         return [repre_doc["_id"] for repre_doc in repre_docs]
 
     def _get_current_output_repre_ids_oox(self, selected_repre):
-        repre_docs = legacy_io.find(
-            {
-                "name": selected_repre,
-                "parent": {"$in": list(self.content_versions.keys())}
-            },
-            {"_id": True}
+        project_name = self.active_project()
+        repre_docs = get_representations(
+            project_name,
+            representation_names=[selected_repre],
+            version_ids=self.content_versions.keys(),
+            fields=["_id"]
         )
         return [repre_doc["_id"] for repre_doc in repre_docs]
 
     def _get_asset_box_values(self):
-        asset_docs = legacy_io.find(
-            {"type": "asset"},
-            {"_id": 1, "name": 1}
-        )
+        project_name = self.active_project()
+        asset_docs = get_assets(project_name, fields=["_id", "name"])
         asset_names_by_id = {
             asset_doc["_id"]: asset_doc["name"]
             for asset_doc in asset_docs
         }
-        subsets = legacy_io.find(
-            {
-                "type": "subset",
-                "parent": {"$in": list(asset_names_by_id.keys())}
-            },
-            {
-                "parent": 1
-            }
+        subsets = get_subsets(
+            project_name,
+            asset_ids=asset_names_by_id.keys(),
+            fields=["parent"]
         )
-
         filtered_assets = []
         for subset in subsets:
             asset_name = asset_names_by_id[subset["parent"]]
@@ -760,25 +765,20 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         return sorted(filtered_assets)
 
     def _get_subset_box_values(self):
+        project_name = self.active_project()
         selected_asset = self._assets_box.get_valid_value()
         if selected_asset:
-            asset_doc = legacy_io.find_one({
-                "type": "asset",
-                "name": selected_asset
-            })
+            asset_doc = get_asset(
+                project_name, asset_name=selected_asset, fields=["_id"]
+            )
             asset_ids = [asset_doc["_id"]]
         else:
             asset_ids = list(self.content_assets.keys())
 
-        subsets = legacy_io.find(
-            {
-                "type": "subset",
-                "parent": {"$in": asset_ids}
-            },
-            {
-                "parent": 1,
-                "name": 1
-            }
+        subsets = get_subsets(
+            project_name,
+            asset_ids=asset_ids,
+            fields=["parent", "name"]
         )
 
         subset_names_by_parent_id = collections.defaultdict(set)
@@ -800,6 +800,7 @@ class SwitchAssetDialog(QtWidgets.QDialog):
     def _representations_box_values(self):
         # NOTE hero versions are not used because it is expected that
         # hero version has same representations as latests
+        project_name = self.active_project()
         selected_asset = self._assets_box.currentText()
         selected_subset = self._subsets_box.currentText()
 
@@ -807,16 +808,11 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         # [ ] [ ] [?]
         if not selected_asset and not selected_subset:
             # Find all representations of selection's subsets
-            possible_repres = list(legacy_io.find(
-                {
-                    "type": "representation",
-                    "parent": {"$in": list(self.content_versions.keys())}
-                },
-                {
-                    "parent": 1,
-                    "name": 1
-                }
-            ))
+            possible_repres = get_representations(
+                project_name,
+                version_ids=self.content_versions.keys(),
+                fields=["parent", "name"]
+            )
 
             possible_repres_by_parent = collections.defaultdict(set)
             for repre in possible_repres:
@@ -836,29 +832,23 @@ class SwitchAssetDialog(QtWidgets.QDialog):
 
         # [x] [x] [?]
         if selected_asset and selected_subset:
-            asset_doc = legacy_io.find_one(
-                {"type": "asset", "name": selected_asset},
-                {"_id": 1}
+            asset_doc = get_asset(
+                project_name, asset_name=selected_asset, fields=["_id"]
             )
-            subset_doc = legacy_io.find_one(
-                {
-                    "type": "subset",
-                    "name": selected_subset,
-                    "parent": asset_doc["_id"]
-                },
-                {"_id": 1}
+            subset_doc = get_subset(
+                project_name,
+                asset_id=asset_doc["_id"],
+                subset_name=selected_subset,
+                fields=["_id"]
             )
+
             subset_id = subset_doc["_id"]
             last_versions_by_subset_id = self.find_last_versions([subset_id])
             version_doc = last_versions_by_subset_id.get(subset_id)
-            repre_docs = legacy_io.find(
-                {
-                    "type": "representation",
-                    "parent": version_doc["_id"]
-                },
-                {
-                    "name": 1
-                }
+            repre_docs = get_representations(
+                project_name,
+                version_ids=[version_doc["_id"]],
+                fields=["name"]
             )
             return [
                 repre_doc["name"]
@@ -868,9 +858,8 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         # [x] [ ] [?]
         # If asset only is selected
         if selected_asset:
-            asset_doc = legacy_io.find_one(
-                {"type": "asset", "name": selected_asset},
-                {"_id": 1}
+            asset_doc = get_asset(
+                project_name, asset_name=selected_asset, fields=["_id"]
             )
             if not asset_doc:
                 return list()
@@ -879,13 +868,12 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             subset_names = set()
             for subset_doc in self.content_subsets.values():
                 subset_names.add(subset_doc["name"])
-            subset_docs = legacy_io.find(
-                {
-                    "type": "subset",
-                    "parent": asset_doc["_id"],
-                    "name": {"$in": list(subset_names)}
-                },
-                {"_id": 1}
+
+            subset_docs = get_subsets(
+                project_name,
+                asset_ids=[asset_doc["_id"]],
+                subset_names=subset_names,
+                fields=["_id"]
             )
             subset_ids = [
                 subset_doc["_id"]
@@ -903,15 +891,10 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             if not subset_id_by_version_id:
                 return list()
 
-            repre_docs = list(legacy_io.find(
-                {
-                    "type": "representation",
-                    "parent": {"$in": list(subset_id_by_version_id.keys())}
-                },
-                {
-                    "name": 1,
-                    "parent": 1
-                }
+            repre_docs = list(get_representations(
+                project_name,
+                version_ids=subset_id_by_version_id.keys(),
+                fields=["name", "parent"]
             ))
             if not repre_docs:
                 return list()
@@ -933,13 +916,11 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             return list(available_repres)
 
         # [ ] [x] [?]
-        subset_docs = list(legacy_io.find(
-            {
-                "type": "subset",
-                "parent": {"$in": list(self.content_assets.keys())},
-                "name": selected_subset
-            },
-            {"_id": 1, "parent": 1}
+        subset_docs = list(get_subsets(
+            project_name,
+            asset_ids=self.content_assets.keys(),
+            subset_names=[selected_subset],
+            fields=["_id", "parent"]
         ))
         if not subset_docs:
             return list()
@@ -960,16 +941,13 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         if not subset_id_by_version_id:
             return list()
 
-        repre_docs = list(legacy_io.find(
-            {
-                "type": "representation",
-                "parent": {"$in": list(subset_id_by_version_id.keys())}
-            },
-            {
-                "name": 1,
-                "parent": 1
-            }
-        ))
+        repre_docs = list(
+            get_representations(
+                project_name,
+                subset_ids=subset_id_by_version_id.keys(),
+                fields=["name", "parent"]
+            )
+        )
         if not repre_docs:
             return list()
 
@@ -1016,14 +994,14 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             return
 
         # [x] [ ] [?]
-        asset_doc = legacy_io.find_one(
-            {"type": "asset", "name": selected_asset},
-            {"_id": 1}
+        project_name = self.active_project()
+        asset_doc = get_asset(
+            project_name, asset_name=selected_asset, fields=["_id"]
         )
-        subset_docs = legacy_io.find(
-            {"type": "subset", "parent": asset_doc["_id"]},
-            {"name": 1}
+        subset_docs = get_subsets(
+            project_name, asset_ids=[asset_doc["_id"]], fields=["name"]
         )
+
         subset_names = set(
             subset_doc["name"]
             for subset_doc in subset_docs
@@ -1035,27 +1013,12 @@ class SwitchAssetDialog(QtWidgets.QDialog):
                 break
 
     def find_last_versions(self, subset_ids):
-        _pipeline = [
-            # Find all versions of those subsets
-            {"$match": {
-                "type": "version",
-                "parent": {"$in": list(subset_ids)}
-            }},
-            # Sorting versions all together
-            {"$sort": {"name": 1}},
-            # Group them by "parent", but only take the last
-            {"$group": {
-                "_id": "$parent",
-                "_version_id": {"$last": "$_id"},
-                "type": {"$last": "$type"}
-            }}
-        ]
-        last_versions_by_subset_id = dict()
-        for doc in legacy_io.aggregate(_pipeline):
-            doc["parent"] = doc["_id"]
-            doc["_id"] = doc.pop("_version_id")
-            last_versions_by_subset_id[doc["parent"]] = doc
-        return last_versions_by_subset_id
+        project_name = self.active_project()
+        return get_last_versions(
+            project_name,
+            subset_ids=subset_ids,
+            fields=["_id", "parent", "type"]
+        )
 
     def _is_repre_ok(self, validation_state):
         selected_asset = self._assets_box.get_valid_value()
@@ -1078,33 +1041,28 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             return
 
         # [x] [x] [ ]
+        project_name = self.active_project()
         if selected_asset is not None and selected_subset is not None:
-            asset_doc = legacy_io.find_one(
-                {"type": "asset", "name": selected_asset},
-                {"_id": 1}
+            asset_doc = get_asset(
+                project_name, asset_name=selected_asset, fields=["_id"]
             )
-            subset_doc = legacy_io.find_one(
-                {
-                    "type": "subset",
-                    "parent": asset_doc["_id"],
-                    "name": selected_subset
-                },
-                {"_id": 1}
+            subset_doc = get_subset(
+                project_name,
+                asset_id=asset_doc["_id"],
+                subset_name=selected_subset,
+                fields=["_id"]
             )
-            last_versions_by_subset_id = self.find_last_versions(
-                [subset_doc["_id"]]
-            )
-            last_version = last_versions_by_subset_id.get(subset_doc["_id"])
+            subset_id = subset_doc["_id"]
+            last_versions_by_subset_id = self.find_last_versions([subset_id])
+            last_version = last_versions_by_subset_id.get(subset_id)
             if not last_version:
                 validation_state.repre_ok = False
                 return
 
-            repre_docs = legacy_io.find(
-                {
-                    "type": "representation",
-                    "parent": last_version["_id"]
-                },
-                {"name": 1}
+            repre_docs = get_representations(
+                project_name,
+                version_ids=[last_version["_id"]],
+                fields=["name"]
             )
 
             repre_names = set(
@@ -1119,16 +1077,13 @@ class SwitchAssetDialog(QtWidgets.QDialog):
 
         # [x] [ ] [ ]
         if selected_asset is not None:
-            asset_doc = legacy_io.find_one(
-                {"type": "asset", "name": selected_asset},
-                {"_id": 1}
+            asset_doc = get_asset(
+                project_name, asset_name=selected_asset, fields=["_id"]
             )
-            subset_docs = list(legacy_io.find(
-                {
-                    "type": "subset",
-                    "parent": asset_doc["_id"]
-                },
-                {"_id": 1, "name": 1}
+            subset_docs = list(get_subsets(
+                project_name,
+                asset_ids=[asset_doc["_id"]],
+                fields=["_id", "name"]
             ))
 
             subset_name_by_id = {}
@@ -1145,15 +1100,10 @@ class SwitchAssetDialog(QtWidgets.QDialog):
                 version_id = last_version["_id"]
                 subset_id_by_version_id[version_id] = subset_id
 
-            repre_docs = legacy_io.find(
-                {
-                    "type": "representation",
-                    "parent": {"$in": list(subset_id_by_version_id.keys())}
-                },
-                {
-                    "name": 1,
-                    "parent": 1
-                }
+            repre_docs = get_representations(
+                project_name,
+                subset_ids=subset_id_by_version_id.keys(),
+                fields=["name", "parent"]
             )
             repres_by_subset_name = {}
             for repre_doc in repre_docs:
@@ -1176,15 +1126,12 @@ class SwitchAssetDialog(QtWidgets.QDialog):
 
         # [ ] [x] [ ]
         # Subset documents
-        subset_docs = legacy_io.find(
-            {
-                "type": "subset",
-                "parent": {"$in": list(self.content_assets.keys())},
-                "name": selected_subset
-            },
-            {"_id": 1, "name": 1, "parent": 1}
+        subset_docs = get_subsets(
+            project_name,
+            asset_ids=self.content_assets.keys(),
+            subset_names=[selected_subset],
+            fields=["_id", "name", "parent"]
         )
-
         subset_docs_by_id = {}
         for subset_doc in subset_docs:
             subset_docs_by_id[subset_doc["_id"]] = subset_doc
@@ -1197,15 +1144,10 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             version_id = last_version["_id"]
             subset_id_by_version_id[version_id] = subset_id
 
-        repre_docs = legacy_io.find(
-            {
-                "type": "representation",
-                "parent": {"$in": list(subset_id_by_version_id.keys())}
-            },
-            {
-                "name": 1,
-                "parent": 1
-            }
+        repre_docs = get_representations(
+            project_name,
+            version_ids=subset_id_by_version_id.keys(),
+            fields=["name", "parent"]
         )
         repres_by_asset_id = {}
         for repre_doc in repre_docs:
@@ -1245,11 +1187,9 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         selected_subset = self._subsets_box.get_valid_value()
         selected_representation = self._representations_box.get_valid_value()
 
+        project_name = self.active_project()
         if selected_asset:
-            asset_doc = legacy_io.find_one({
-                "type": "asset",
-                "name": selected_asset
-            })
+            asset_doc = get_asset(project_name, asset_name=selected_asset)
             asset_docs_by_id = {asset_doc["_id"]: asset_doc}
         else:
             asset_docs_by_id = self.content_assets
@@ -1259,16 +1199,15 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             for asset_doc in asset_docs_by_id.values()
         }
 
-        asset_ids = list(asset_docs_by_id.keys())
-
-        subset_query = {
-            "type": "subset",
-            "parent": {"$in": asset_ids}
-        }
+        subset_names = None
         if selected_subset:
-            subset_query["name"] = selected_subset
+            subset_names = [selected_subset]
 
-        subset_docs = list(legacy_io.find(subset_query))
+        subset_docs = list(get_subsets(
+            project_name,
+            subset_names=subset_names,
+            asset_ids=asset_docs_by_id.keys()
+        ))
         subset_ids = []
         subset_docs_by_parent_and_name = collections.defaultdict(dict)
         for subset in subset_docs:
@@ -1278,15 +1217,14 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             subset_docs_by_parent_and_name[parent_id][name] = subset
 
         # versions
-        version_docs = list(legacy_io.find({
-            "type": "version",
-            "parent": {"$in": subset_ids}
-        }, sort=[("name", -1)]))
+        _version_docs = get_versions(project_name, subset_ids=subset_ids)
+        version_docs = list(reversed(
+            sorted(_version_docs, key=lambda item: item["name"])
+        ))
 
-        hero_version_docs = list(legacy_io.find({
-            "type": "hero_version",
-            "parent": {"$in": subset_ids}
-        }))
+        hero_version_docs = list(get_hero_versions(
+            project_name, subset_ids=subset_ids
+        ))
 
         version_ids = list()
 
@@ -1303,10 +1241,7 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             parent_id = hero_version_doc["parent"]
             hero_version_docs_by_parent_id[parent_id] = hero_version_doc
 
-        repre_docs = legacy_io.find({
-            "type": "representation",
-            "parent": {"$in": version_ids}
-        })
+        repre_docs = get_representations(project_name, version_ids=version_ids)
         repre_docs_by_parent_id_by_name = collections.defaultdict(dict)
         for repre_doc in repre_docs:
             parent_id = repre_doc["parent"]
diff --git a/openpype/tools/sceneinventory/view.py b/openpype/tools/sceneinventory/view.py
index 448e3f4e6f..6a95ccb57b 100644
--- a/openpype/tools/sceneinventory/view.py
+++ b/openpype/tools/sceneinventory/view.py
@@ -6,6 +6,13 @@ from Qt import QtWidgets, QtCore
 import qtawesome
 from bson.objectid import ObjectId
 
+from openpype.client import (
+    get_version,
+    get_versions,
+    get_hero_versions,
+    get_representation,
+    get_representations,
+)
 from openpype import style
 from openpype.pipeline import (
     legacy_io,
@@ -83,12 +90,9 @@ class SceneInventoryView(QtWidgets.QTreeView):
             if item_id not in repre_ids:
                 repre_ids.append(item_id)
 
-        repre_docs = legacy_io.find(
-            {
-                "type": "representation",
-                "_id": {"$in": repre_ids}
-            },
-            {"parent": 1}
+        project_name = legacy_io.active_project()
+        repre_docs = get_representations(
+            project_name, representaion_ids=repre_ids, fields=["parent"]
         )
 
         version_ids = []
@@ -97,10 +101,9 @@ class SceneInventoryView(QtWidgets.QTreeView):
             if version_id not in version_ids:
                 version_ids.append(version_id)
 
-        loaded_versions = legacy_io.find({
-            "_id": {"$in": version_ids},
-            "type": {"$in": ["version", "hero_version"]}
-        })
+        loaded_versions = get_versions(
+            project_name, version_ids=version_ids, hero=True
+        )
 
         loaded_hero_versions = []
         versions_by_parent_id = collections.defaultdict(list)
@@ -114,10 +117,9 @@ class SceneInventoryView(QtWidgets.QTreeView):
                 if parent_id not in version_parents:
                     version_parents.append(parent_id)
 
-        all_versions = legacy_io.find({
-            "type": {"$in": ["hero_version", "version"]},
-            "parent": {"$in": version_parents}
-        })
+        all_versions = get_versions(
+            project_name, subset_ids=version_parents, hero=True
+        )
         hero_versions = []
         versions = []
         for version in all_versions:
@@ -150,12 +152,10 @@ class SceneInventoryView(QtWidgets.QTreeView):
                     if item_id not in repre_ids:
                         repre_ids.append(item_id)
 
-                repre_docs = legacy_io.find(
-                    {
-                        "type": "representation",
-                        "_id": {"$in": repre_ids}
-                    },
-                    {"parent": 1}
+                repre_docs = get_representations(
+                    project_name,
+                    representation_ids=repre_ids,
+                    fields=["parent"]
                 )
 
                 version_ids = []
@@ -165,13 +165,13 @@ class SceneInventoryView(QtWidgets.QTreeView):
                     version_id_by_repre_id[repre_doc["_id"]] = version_id
                     if version_id not in version_ids:
                         version_ids.append(version_id)
-                hero_versions = legacy_io.find(
-                    {
-                        "_id": {"$in": version_ids},
-                        "type": "hero_version"
-                    },
-                    {"version_id": 1}
+
+                hero_versions = get_hero_versions(
+                    project_name,
+                    version_ids=version_ids,
+                    fields=["version_id"]
                 )
+
                 version_ids = set()
                 for hero_version in hero_versions:
                     version_id = hero_version["version_id"]
@@ -183,12 +183,10 @@ class SceneInventoryView(QtWidgets.QTreeView):
                         if current_version_id == hero_version_id:
                             version_id_by_repre_id[_repre_id] = version_id
 
-                version_docs = legacy_io.find(
-                    {
-                        "_id": {"$in": list(version_ids)},
-                        "type": "version"
-                    },
-                    {"name": 1}
+                version_docs = get_versions(
+                    project_name,
+                    version_ids=version_ids,
+                    fields=["name"]
                 )
                 version_name_by_id = {}
                 for version_doc in version_docs:
@@ -370,10 +368,9 @@ class SceneInventoryView(QtWidgets.QTreeView):
         active_site = self.sync_server.get_active_site(project_name)
         remote_site = self.sync_server.get_remote_site(project_name)
 
-        repre_docs = legacy_io.find({
-            "type": "representation",
-            "_id": {"$in": repre_ids}
-        })
+        repre_docs = get_representations(
+            project_name, representation_ids=repre_ids
+        )
         repre_docs_by_id = {
             repre_doc["_id"]: repre_doc
             for repre_doc in repre_docs
@@ -658,25 +655,37 @@ class SceneInventoryView(QtWidgets.QTreeView):
 
         active = items[-1]
 
+        project_name = legacy_io.active_project()
         # Get available versions for active representation
         representation_id = ObjectId(active["representation"])
-        representation = legacy_io.find_one({"_id": representation_id})
-        version = legacy_io.find_one({
-            "_id": representation["parent"]
-        })
 
-        versions = list(legacy_io.find(
-            {
-                "parent": version["parent"],
-                "type": "version"
-            },
-            sort=[("name", 1)]
+        repre_doc = get_representation(
+            project_name,
+            representation_id=representation_id,
+            fields=["parent"]
+        )
+
+        repre_version_doc = get_version(
+            project_name,
+            version_id=repre_doc["parent"],
+            fields=["parent"]
+        )
+
+        version_docs = get_versions(
+            project_name,
+            subset_ids=[repre_version_doc["parent"]],
+            hero=True
+        )
+        hero_version = None
+        standard_versions = []
+        for version_doc in version_docs:
+            if version_doc["type"] == "hero_version":
+                hero_version = version_doc
+            else:
+                standard_versions.append(version_doc)
+        versions = list(reversed(
+            sorted(standard_versions, key=lambda item: item["name"])
         ))
-
-        hero_version = legacy_io.find_one({
-            "parent": version["parent"],
-            "type": "hero_version"
-        })
         if hero_version:
             _version_id = hero_version["version_id"]
             for _version in versions:
@@ -703,7 +712,7 @@ class SceneInventoryView(QtWidgets.QTreeView):
         all_versions = []
         if hero_version:
             all_versions.append(hero_version)
-        all_versions.extend(reversed(versions))
+        all_versions.extend(versions)
 
         if current_item:
             index = all_versions.index(current_item)
diff --git a/openpype/tools/standalonepublish/app.py b/openpype/tools/standalonepublish/app.py
index 1ad5cd119e..4831db038c 100644
--- a/openpype/tools/standalonepublish/app.py
+++ b/openpype/tools/standalonepublish/app.py
@@ -6,6 +6,8 @@ import signal
 from bson.objectid import ObjectId
 from Qt import QtWidgets, QtCore, QtGui
 
+from openpype.client import get_asset
+
 from .widgets import (
     AssetWidget, FamilyWidget, ComponentsWidget, ShadowWidget
 )
@@ -126,17 +128,6 @@ class Window(QtWidgets.QDialog):
         if event:
             super().resizeEvent(event)
 
-    def get_avalon_parent(self, entity):
-        ''' Avalon DB entities helper - get all parents (exclude project).
-        '''
-        parent_id = entity['data']['visualParent']
-        parents = []
-        if parent_id is not None:
-            parent = self.db.find_one({'_id': parent_id})
-            parents.extend(self.get_avalon_parent(parent))
-            parents.append(parent['name'])
-        return parents
-
     def on_project_change(self, project_name):
         self.widget_family.refresh()
 
@@ -152,7 +143,10 @@ class Window(QtWidgets.QDialog):
         ]
         if len(selected) == 1:
             self.valid_parent = True
-            asset = self.db.find_one({"_id": selected[0], "type": "asset"})
+            project_name = self.db.active_project()
+            asset = get_asset(
+                project_name, asset_id=selected[0], fields=["name"]
+            )
             self.widget_family.change_asset(asset['name'])
         else:
             self.valid_parent = False
diff --git a/openpype/tools/standalonepublish/widgets/model_asset.py b/openpype/tools/standalonepublish/widgets/model_asset.py
index 02e9073555..abfc0a2145 100644
--- a/openpype/tools/standalonepublish/widgets/model_asset.py
+++ b/openpype/tools/standalonepublish/widgets/model_asset.py
@@ -4,6 +4,7 @@ import collections
 from Qt import QtCore, QtGui
 import qtawesome
 
+from openpype.client import get_assets
 from openpype.style import (
     get_default_entity_icon_color,
     get_deprecated_entity_font_color,
@@ -104,17 +105,18 @@ class AssetModel(TreeModel):
     def refresh(self):
         """Refresh the data for the model."""
 
+        project_name = self.dbcon.active_project()
         self.clear()
-        if (
-            self.dbcon.active_project() is None or
-            self.dbcon.active_project() == ''
-        ):
+        if not project_name:
             return
 
         self.beginResetModel()
 
         # Get all assets in current project sorted by name
-        db_assets = self.dbcon.find({"type": "asset"}).sort("name", 1)
+        asset_docs = get_assets(project_name)
+        db_assets = list(
+            sorted(asset_docs, key=lambda item: item["name"])
+        )
 
         # Group the assets by their visual parent's id
         assets_by_parent = collections.defaultdict(list)
diff --git a/openpype/tools/standalonepublish/widgets/widget_asset.py b/openpype/tools/standalonepublish/widgets/widget_asset.py
index 8b43cd7cf8..0b5802ed9e 100644
--- a/openpype/tools/standalonepublish/widgets/widget_asset.py
+++ b/openpype/tools/standalonepublish/widgets/widget_asset.py
@@ -2,6 +2,10 @@ import contextlib
 from Qt import QtWidgets, QtCore
 import qtawesome
 
+from openpype.client import (
+    get_project,
+    get_asset,
+)
 from openpype.tools.utils import PlaceholderLineEdit
 
 from openpype.style import get_default_tools_icon_color
@@ -218,7 +222,8 @@ class AssetWidget(QtWidgets.QWidget):
         self.view = view
 
     def collect_data(self):
-        project = self.dbcon.find_one({'type': 'project'})
+        project_name = self.dbcon.active_project()
+        project = get_project(project_name, fields=["name"])
         asset = self.get_active_asset()
 
         try:
@@ -241,9 +246,16 @@ class AssetWidget(QtWidgets.QWidget):
             return ent_parents
 
         output = []
-        if entity.get('data', {}).get('visualParent', None) is None:
+        parent_asset_id = entity.get('data', {}).get('visualParent', None)
+        if parent_asset_id is None:
             return output
-        parent = self.dbcon.find_one({'_id': entity['data']['visualParent']})
+
+        project_name = self.dbcon.active_project()
+        parent = get_asset(
+            project_name,
+            asset_id=parent_asset_id,
+            fields=["name", "data.visualParent"]
+        )
         output.append(parent['name'])
         output.extend(self.get_parents(parent))
         return output
@@ -349,9 +361,10 @@ class AssetWidget(QtWidgets.QWidget):
         tasks = []
         selected = self.get_selected_assets()
         if len(selected) == 1:
-            asset = self.dbcon.find_one({
-                "_id": selected[0], "type": "asset"
-            })
+            project_name = self.dbcon.active_project()
+            asset = get_asset(
+                project_name, asset_id=selected[0], fields=["data.tasks"]
+            )
             if asset:
                 tasks = asset.get('data', {}).get('tasks', [])
         self.task_model.set_tasks(tasks)
@@ -400,7 +413,7 @@ class AssetWidget(QtWidgets.QWidget):
 
         # Select
         mode = selection_model.Select | selection_model.Rows
-        for index in lib.iter_model_rows(
+        for index in _iter_model_rows(
             self.proxy, column=0, include_root=False
         ):
             # stop iteration if there are no assets to process
diff --git a/openpype/tools/standalonepublish/widgets/widget_family.py b/openpype/tools/standalonepublish/widgets/widget_family.py
index 08cd45bbf2..ed9f405f38 100644
--- a/openpype/tools/standalonepublish/widgets/widget_family.py
+++ b/openpype/tools/standalonepublish/widgets/widget_family.py
@@ -1,14 +1,21 @@
 import re
 
 from Qt import QtWidgets, QtCore
-from . import HelpRole, FamilyRole, ExistsRole, PluginRole, PluginKeyRole
-from . import FamilyDescriptionWidget
 
+from openpype.client import (
+    get_asset,
+    get_subset,
+    get_subsets,
+    get_last_version_for_subset,
+)
 from openpype.api import get_project_settings
 from openpype.pipeline import LegacyCreator
 from openpype.lib import TaskNotSetError
 from openpype.pipeline.create import SUBSET_NAME_ALLOWED_SYMBOLS
 
+from . import HelpRole, FamilyRole, ExistsRole, PluginRole, PluginKeyRole
+from . import FamilyDescriptionWidget
+
 
 class FamilyWidget(QtWidgets.QWidget):
 
@@ -180,12 +187,9 @@ class FamilyWidget(QtWidgets.QWidget):
         asset_doc = None
         if asset_name != self.NOT_SELECTED:
             # Get the assets from the database which match with the name
-            asset_doc = self.dbcon.find_one(
-                {
-                    "type": "asset",
-                    "name": asset_name
-                },
-                {"_id": 1}
+            project_name = self.dbcon.active_project()
+            asset_doc = get_asset(
+                project_name, asset_name=asset_name, fields=["_id"]
             )
 
         # Get plugin and family
@@ -200,14 +204,13 @@ class FamilyWidget(QtWidgets.QWidget):
             return
 
         # Get the asset from the database which match with the name
-        asset_doc = self.dbcon.find_one(
-            {"name": asset_name, "type": "asset"},
-            projection={"_id": 1}
+        project_name = self.dbcon.active_project()
+        asset_doc = get_asset(
+            project_name, asset_name=asset_name, fields=["_id"]
         )
         # Get plugin
         plugin = item.data(PluginRole)
         if asset_doc and plugin:
-            project_name = self.dbcon.Session["AVALON_PROJECT"]
             asset_id = asset_doc["_id"]
             task_name = self.dbcon.Session["AVALON_TASK"]
 
@@ -231,14 +234,14 @@ class FamilyWidget(QtWidgets.QWidget):
                 self.input_result.setText("Select task please")
 
             # Get all subsets of the current asset
-            subset_docs = self.dbcon.find(
-                {
-                    "type": "subset",
-                    "parent": asset_id
-                },
-                {"name": 1}
+            subset_docs = get_subsets(
+                project_name, asset_ids=[asset_id], fields=["name"]
             )
-            existing_subset_names = set(subset_docs.distinct("name"))
+
+            existing_subset_names = {
+                subset_doc["name"]
+                for subset_doc in subset_docs
+            }
 
             # Defaults to dropdown
             defaults = []
@@ -296,47 +299,37 @@ class FamilyWidget(QtWidgets.QWidget):
         if not auto_version:
             return
 
+        project_name = self.dbcon.active_project()
         asset_name = self.asset_name
         subset_name = self.input_result.text()
         version = 1
 
         asset_doc = None
         subset_doc = None
-        versions = None
         if (
             asset_name != self.NOT_SELECTED and
             subset_name.strip() != ''
         ):
-            asset_doc = self.dbcon.find_one(
-                {
-                    'type': 'asset',
-                    'name': asset_name
-                },
-                {"_id": 1}
+            asset_doc = get_asset(
+                project_name, asset_name=asset_name, fields=["_id"]
             )
 
         if asset_doc:
-            subset_doc = self.dbcon.find_one(
-                {
-                    'type': 'subset',
-                    'parent': asset_doc['_id'],
-                    'name': subset_name
-                },
-                {"_id": 1}
+            subset_doc = get_subset(
+                project_name,
+                subset_name=subset_name,
+                asset_id=asset_doc['_id'],
+                fields=["_id"]
             )
 
         if subset_doc:
-            versions = self.dbcon.find(
-                {
-                    'type': 'version',
-                    'parent': subset_doc['_id']
-                },
-                {"name": 1}
-            ).distinct("name")
-
-        if versions:
-            versions = sorted(versions)
-            version = int(versions[-1]) + 1
+            last_version = get_last_version_for_subset(
+                project_name,
+                subset_id=subset_doc["_id"],
+                fields=["name"]
+            )
+            if last_version:
+                version = last_version["name"] + 1
 
         self.version_spinbox.setValue(version)
 
diff --git a/openpype/tools/texture_copy/app.py b/openpype/tools/texture_copy/app.py
index fd8d6dc02e..8703f075d3 100644
--- a/openpype/tools/texture_copy/app.py
+++ b/openpype/tools/texture_copy/app.py
@@ -4,6 +4,7 @@ import click
 
 import speedcopy
 
+from openpype.client import get_project, get_asset
 from openpype.lib import Terminal
 from openpype.api import Anatomy
 from openpype.pipeline import legacy_io
@@ -29,20 +30,6 @@ class TextureCopy:
                 if os.path.splitext(x)[1].lower() in texture_extensions)
         return textures
 
-    def _get_project(self, project_name):
-        project = legacy_io.find_one({
-            'type': 'project',
-            'name': project_name
-        })
-        return project
-
-    def _get_asset(self, asset_name):
-        asset = legacy_io.find_one({
-            'type': 'asset',
-            'name': asset_name
-        })
-        return asset
-
     def _get_destination_path(self, asset, project):
         project_name = project["name"]
         hierarchy = ""
@@ -88,11 +75,12 @@ class TextureCopy:
                 t.echo("!!! {}".format(e))
                 exit(1)
 
-    def process(self, asset, project, path):
+    def process(self, asset_name, project_name, path):
         """
         Process all textures found in path and copy them to asset under
         project.
         """
+
         t.echo(">>> Looking for textures ...")
         textures = self._get_textures(path)
         if len(textures) < 1:
@@ -101,14 +89,14 @@ class TextureCopy:
         else:
             t.echo(">>> Found {} textures ...".format(len(textures)))
 
-        project = self._get_project(project)
+        project = get_project(project_name)
         if not project:
-            t.echo("!!! Project name [ {} ] not found.".format(project))
+            t.echo("!!! Project name [ {} ] not found.".format(project_name))
             exit(1)
 
-        asset = self._get_asset(asset)
-        if not project:
-            t.echo("!!! Asset [ {} ] not found in project".format(asset))
+        asset = get_asset(project_name, asset_name=asset_name)
+        if not asset:
+            t.echo("!!! Asset [ {} ] not found in project".format(asset_name))
             exit(1)
         t.echo((">>> Project [ {} ] and "
                 "asset [ {} ] seems to be OK ...").format(project['name'],
diff --git a/openpype/tools/utils/assets_widget.py b/openpype/tools/utils/assets_widget.py
index 82bdcd63a2..772946e9e1 100644
--- a/openpype/tools/utils/assets_widget.py
+++ b/openpype/tools/utils/assets_widget.py
@@ -5,6 +5,10 @@ import Qt
 from Qt import QtWidgets, QtCore, QtGui
 import qtawesome
 
+from openpype.client import (
+    get_project,
+    get_assets,
+)
 from openpype.style import (
     get_objected_colors,
     get_default_tools_icon_color,
@@ -525,21 +529,18 @@ class AssetModel(QtGui.QStandardItemModel):
         self._doc_fetched.emit()
 
     def _fetch_asset_docs(self):
-        if not self.dbcon.Session.get("AVALON_PROJECT"):
+        project_name = self.dbcon.current_project()
+        if not project_name:
             return []
 
-        project_doc = self.dbcon.find_one(
-            {"type": "project"},
-            {"_id": True}
-        )
+        project_doc = get_project(project_name, fields=["_id"])
         if not project_doc:
             return []
 
         # Get all assets sorted by name
-        return list(self.dbcon.find(
-            {"type": "asset"},
-            self._asset_projection
-        ))
+        return list(
+            get_assets(project_name, fields=self._asset_projection.keys())
+        )
 
     def _stop_fetch_thread(self):
         self._refreshing = False
diff --git a/openpype/tools/utils/delegates.py b/openpype/tools/utils/delegates.py
index 71f817a1d7..d6c2d69e76 100644
--- a/openpype/tools/utils/delegates.py
+++ b/openpype/tools/utils/delegates.py
@@ -6,15 +6,19 @@ import numbers
 import Qt
 from Qt import QtWidgets, QtGui, QtCore
 
-from openpype.pipeline import HeroVersionType
-from .models import TreeModel
-from . import lib
-
 if Qt.__binding__ == "PySide":
     from PySide.QtGui import QStyleOptionViewItemV4
 elif Qt.__binding__ == "PyQt4":
     from PyQt4.QtGui import QStyleOptionViewItemV4
 
+from openpype.client import (
+    get_versions,
+    get_hero_versions,
+)
+from openpype.pipeline import HeroVersionType
+from .models import TreeModel
+from . import lib
+
 log = logging.getLogger(__name__)
 
 
@@ -114,26 +118,24 @@ class VersionDelegate(QtWidgets.QStyledItemDelegate):
                 "Version is not integer"
             )
 
+        project_name = self.dbcon.active_project()
         # Add all available versions to the editor
         parent_id = item["version_document"]["parent"]
-        version_docs = list(self.dbcon.find(
-            {
-                "type": "version",
-                "parent": parent_id
-            },
-            sort=[("name", 1)]
+        version_docs = list(sorted(
+            get_versions(project_name, subset_ids=[parent_id]),
+            key=lambda item: item["name"]
         ))
 
-        hero_version_doc = self.dbcon.find_one(
-            {
-                "type": "hero_version",
-                "parent": parent_id
-            }, {
-                "name": 1,
-                "data.tags": 1,
-                "version_id": 1
-            }
+        hero_versions = list(
+            get_hero_versions(
+                project_name,
+                subset_ids=[parent_id],
+                fields=["name", "data.tags", "version_id"]
+            )
         )
+        hero_version_doc = None
+        if hero_versions:
+            hero_version_doc = hero_versions[0]
 
         doc_for_hero_version = None
 
diff --git a/openpype/tools/utils/lib.py b/openpype/tools/utils/lib.py
index 20fea6600b..72ebfcc063 100644
--- a/openpype/tools/utils/lib.py
+++ b/openpype/tools/utils/lib.py
@@ -6,6 +6,10 @@ import collections
 from Qt import QtWidgets, QtCore, QtGui
 import qtawesome
 
+from openpype.client import (
+    get_project,
+    get_asset,
+)
 from openpype.style import (
     get_default_entity_icon_color,
     get_objected_colors,
@@ -430,9 +434,8 @@ class FamilyConfigCache:
             database = getattr(self.dbcon, "database", None)
             if database is None:
                 database = self.dbcon._database
-            asset_doc = database[project_name].find_one(
-                {"type": "asset", "name": asset_name},
-                {"data.tasks": True}
+            asset_doc = get_asset(
+                project_name, asset_name=asset_name, fields=["data.tasks"]
             ) or {}
             tasks_info = asset_doc.get("data", {}).get("tasks") or {}
             task_type = tasks_info.get(task_name, {}).get("type")
@@ -500,10 +503,7 @@ class GroupsConfig:
         project_name = self.dbcon.Session.get("AVALON_PROJECT")
         if project_name:
             # Get pre-defined group name and appearance from project config
-            project_doc = self.dbcon.find_one(
-                {"type": "project"},
-                projection={"config.groups": True}
-            )
+            project_doc = get_project(project_name, fields=["config.groups"])
 
             if project_doc:
                 group_configs = project_doc["config"].get("groups") or []
diff --git a/openpype/tools/utils/tasks_widget.py b/openpype/tools/utils/tasks_widget.py
index eab183d5f3..fcbec318f5 100644
--- a/openpype/tools/utils/tasks_widget.py
+++ b/openpype/tools/utils/tasks_widget.py
@@ -1,6 +1,10 @@
 from Qt import QtWidgets, QtCore, QtGui
 import qtawesome
 
+from openpype.client import (
+    get_project,
+    get_asset,
+)
 from openpype.style import get_disabled_entity_icon_color
 from openpype.tools.utils.lib import get_task_icon
 
@@ -47,7 +51,8 @@ class TasksModel(QtGui.QStandardItemModel):
         # Get the project configured icons from database
         project_doc = {}
         if self._context_is_valid():
-            project_doc = self.dbcon.find_one({"type": "project"})
+            project_name = self.dbcon.active_project()
+            project_doc = get_project(project_name)
 
         self._loaded_project_name = self._get_current_project()
         self._project_doc = project_doc
@@ -71,9 +76,9 @@ class TasksModel(QtGui.QStandardItemModel):
     def set_asset_id(self, asset_id):
         asset_doc = None
         if self._context_is_valid():
-            asset_doc = self.dbcon.find_one(
-                {"_id": asset_id},
-                {"data.tasks": True}
+            project_name = self._get_current_project()
+            asset_doc = get_asset(
+                project_name, asset_id=asset_id, fields=["data.tasks"]
             )
         self._set_asset(asset_doc)
 
diff --git a/openpype/tools/workfiles/files_widget.py b/openpype/tools/workfiles/files_widget.py
index 977111b71b..36b9a055d8 100644
--- a/openpype/tools/workfiles/files_widget.py
+++ b/openpype/tools/workfiles/files_widget.py
@@ -5,6 +5,7 @@ import shutil
 import Qt
 from Qt import QtWidgets, QtCore
 
+from openpype.client import get_asset
 from openpype.tools.utils import PlaceholderLineEdit
 from openpype.tools.utils.delegates import PrettyTimeDelegate
 from openpype.lib import (
@@ -384,7 +385,9 @@ class FilesWidget(QtWidgets.QWidget):
             return None
 
         if self._asset_doc is None:
-            self._asset_doc = legacy_io.find_one({"_id": self._asset_id})
+            project_name = legacy_io.active_project()
+            self._asset_doc = get_asset(project_name, asset_id=self._asset_id)
+
         return self._asset_doc
 
     def _get_session(self):
diff --git a/openpype/tools/workfiles/model.py b/openpype/tools/workfiles/model.py
index 8f9dd8c6ba..d5b7cef339 100644
--- a/openpype/tools/workfiles/model.py
+++ b/openpype/tools/workfiles/model.py
@@ -4,6 +4,11 @@ import logging
 from Qt import QtCore, QtGui
 import qtawesome
 
+from openpype.client import (
+    get_subsets,
+    get_versions,
+    get_representations,
+)
 from openpype.style import (
     get_default_entity_icon_color,
     get_disabled_entity_icon_color,
@@ -215,6 +220,7 @@ class PublishFilesModel(QtGui.QStandardItemModel):
 
         self._dbcon = dbcon
         self._anatomy = anatomy
+
         self._file_extensions = extensions
 
         self._invalid_context_item = None
@@ -234,6 +240,10 @@ class PublishFilesModel(QtGui.QStandardItemModel):
         self._asset_id = None
         self._task_name = None
 
+    @property
+    def project_name(self):
+        return self._dbcon.Session["AVALON_PROJECT"]
+
     def _set_item_invalid(self, item):
         item.setFlags(QtCore.Qt.NoItemFlags)
         item.setData(self._invalid_icon, QtCore.Qt.DecorationRole)
@@ -285,15 +295,11 @@ class PublishFilesModel(QtGui.QStandardItemModel):
     def _get_workfie_representations(self):
         output = []
         # Get subset docs of asset
-        subset_docs = self._dbcon.find(
-            {
-                "type": "subset",
-                "parent": self._asset_id
-            },
-            {
-                "_id": True,
-                "name": True
-            }
+        subset_docs = get_subsets(
+            self.project_name,
+            asset_ids=[self._asset_id],
+            fields=["_id", "name"]
+
         )
 
         subset_ids = [subset_doc["_id"] for subset_doc in subset_docs]
@@ -301,17 +307,12 @@ class PublishFilesModel(QtGui.QStandardItemModel):
             return output
 
         # Get version docs of subsets with their families
-        version_docs = self._dbcon.find(
-            {
-                "type": "version",
-                "parent": {"$in": subset_ids}
-            },
-            {
-                "_id": True,
-                "data.families": True,
-                "parent": True
-            }
+        version_docs = get_versions(
+            self.project_name,
+            subset_ids=subset_ids,
+            fields=["_id", "parent", "data.families"]
         )
+
         # Filter versions if they contain 'workfile' family
         filtered_versions = []
         for version_doc in version_docs:
@@ -327,13 +328,10 @@ class PublishFilesModel(QtGui.QStandardItemModel):
         # Query representations of filtered versions and add filter for
         #   extension
         extensions = [ext.replace(".", "") for ext in self._file_extensions]
-        repre_docs = self._dbcon.find(
-            {
-                "type": "representation",
-                "parent": {"$in": version_ids},
-                "context.ext": {"$in": extensions}
-            }
+        repre_docs = get_representations(
+            self.project_name, version_ids, extensions
         )
+
         # Filter queried representations by task name if task is set
         filtered_repre_docs = []
         for repre_doc in repre_docs:
diff --git a/openpype/tools/workfiles/save_as_dialog.py b/openpype/tools/workfiles/save_as_dialog.py
index 3e97d6c938..1fbcbfeb22 100644
--- a/openpype/tools/workfiles/save_as_dialog.py
+++ b/openpype/tools/workfiles/save_as_dialog.py
@@ -5,6 +5,10 @@ import logging
 
 from Qt import QtWidgets, QtCore
 
+from openpype.client import (
+    get_project,
+    get_asset,
+)
 from openpype.lib import (
     get_last_workfile_with_version,
     get_workdir_data,
@@ -22,29 +26,19 @@ def build_workfile_data(session):
     """Get the data required for workfile formatting from avalon `session`"""
 
     # Set work file data for template formatting
+    project_name = session["AVALON_PROJECT"]
     asset_name = session["AVALON_ASSET"]
     task_name = session["AVALON_TASK"]
     host_name = session["AVALON_APP"]
-    project_doc = legacy_io.find_one(
-        {"type": "project"},
-        {
-            "name": True,
-            "data.code": True,
-            "config.tasks": True,
-        }
+    project_doc = get_project(
+        project_name, fields=["name", "data.code", "config.tasks"]
+    )
+    asset_doc = get_asset(
+        project_name,
+        asset_name=asset_name,
+        fields=["name", "data.tasks", "data.parents"]
     )
 
-    asset_doc = legacy_io.find_one(
-        {
-            "type": "asset",
-            "name": asset_name
-        },
-        {
-            "name": True,
-            "data.tasks": True,
-            "data.parents": True
-        }
-    )
     data = get_workdir_data(project_doc, asset_doc, task_name, host_name)
     data.update({
         "version": 1,
diff --git a/openpype/tools/workfiles/window.py b/openpype/tools/workfiles/window.py
index 02a22af26c..45d8d41d16 100644
--- a/openpype/tools/workfiles/window.py
+++ b/openpype/tools/workfiles/window.py
@@ -2,6 +2,7 @@ import os
 import datetime
 from Qt import QtCore, QtWidgets
 
+from openpype.client import get_asset
 from openpype import style
 from openpype.lib import (
     get_workfile_doc,
@@ -223,6 +224,10 @@ class Window(QtWidgets.QMainWindow):
         self._first_show = True
         self._context_to_set = None
 
+    @property
+    def project_name(self):
+        return legacy_io.Session["AVALON_PROJECT"]
+
     def showEvent(self, event):
         super(Window, self).showEvent(event)
         if self._first_show:
@@ -296,7 +301,8 @@ class Window(QtWidgets.QMainWindow):
         if not workfile_doc:
             workdir, filename = os.path.split(filepath)
             asset_id = self.assets_widget.get_selected_asset_id()
-            asset_doc = legacy_io.find_one({"_id": asset_id})
+            project_name = legacy_io.active_project()
+            asset_doc = get_asset(project_name, asset_id=asset_id)
             task_name = self.tasks_widget.get_selected_task_name()
             create_workfile_doc(
                 asset_doc, task_name, filename, workdir, legacy_io
@@ -322,14 +328,13 @@ class Window(QtWidgets.QMainWindow):
 
         self._context_to_set, context = None, self._context_to_set
         if "asset" in context:
-            asset_doc = legacy_io.find_one(
-                {
-                    "name": context["asset"],
-                    "type": "asset"
-                },
-                {"_id": 1}
-            ) or {}
-            asset_id = asset_doc.get("_id")
+            asset_doc = get_asset(
+                self.project_name, context["asset"], fields=["_id"]
+            )
+
+            asset_id = None
+            if asset_doc:
+                asset_id = asset_doc["_id"]
             # Select the asset
             self.assets_widget.select_asset(asset_id)
             self.tasks_widget.set_asset_id(asset_id)

From 8bb97b9bbc9f14315aea37de033fa59758c5185a Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 6 Jun 2022 11:06:03 +0200
Subject: [PATCH 0473/1227] Fix - correct project settings selected

---
 openpype/modules/sync_server/tray/widgets.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/sync_server/tray/widgets.py b/openpype/modules/sync_server/tray/widgets.py
index 049a3f0127..e41910fa4f 100644
--- a/openpype/modules/sync_server/tray/widgets.py
+++ b/openpype/modules/sync_server/tray/widgets.py
@@ -127,7 +127,7 @@ class SyncProjectListWidget(QtWidgets.QWidget):
             if self.sync_server.is_paused() or \
                self.sync_server.is_project_paused(project_name):
                 icon = self._get_icon("paused")
-            elif not sync_settings["enabled"]:
+            elif not sync_settings[project_name]["enabled"]:
                 icon = self._get_icon("disabled")
             else:
                 icon = self._get_icon("synced")

From b3098a4a1ed2f06c622392870f6fad4f7d122e29 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Mon, 6 Jun 2022 12:12:10 +0300
Subject: [PATCH 0474/1227] Fix path bug causing output path to equal input
 path.

---
 repos/avalon-core | 1 -
 1 file changed, 1 deletion(-)
 delete mode 160000 repos/avalon-core

diff --git a/repos/avalon-core b/repos/avalon-core
deleted file mode 160000
index 2fa14cea6f..0000000000
--- a/repos/avalon-core
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 2fa14cea6f6a9d86eec70bbb96860cbe4c75c8eb

From a922b93202cc8ec898981109f260141bb0707ef2 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Mon, 6 Jun 2022 12:12:30 +0300
Subject: [PATCH 0475/1227] Fix path bug.

---
 openpype/plugins/publish/extract_jpeg_exr.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index daf7430a32..f474714780 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -159,9 +159,8 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         # we just want one frame from movie files
         jpeg_items.append("-vframes 1")
         # output file
-        jpeg_items.append(path_to_subprocess_arg(src_path))
+        jpeg_items.append(path_to_subprocess_arg(dst_path))
         subprocess_command = " ".join(jpeg_items)
-
         run_subprocess(
                 subprocess_command, shell=True, logger=self.log
             )

From 7b16c6837b1c02defd73fcba984909d085cce61e Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 6 Jun 2022 17:08:37 +0200
Subject: [PATCH 0476/1227] refacto code to have simpler menu

---
 openpype/hosts/nuke/api/gizmo_menu.py         |  90 ++++++++------
 openpype/hosts/nuke/api/lib.py                | 109 ++++++++++------
 openpype/hosts/nuke/startup/menu.py           |  70 +----------
 .../defaults/project_settings/nuke.json       |   8 +-
 .../schemas/schema_nuke_scriptsgizmo.json     | 117 +++++++++++++++---
 5 files changed, 222 insertions(+), 172 deletions(-)

diff --git a/openpype/hosts/nuke/api/gizmo_menu.py b/openpype/hosts/nuke/api/gizmo_menu.py
index dd04f4a42e..7f8121372c 100644
--- a/openpype/hosts/nuke/api/gizmo_menu.py
+++ b/openpype/hosts/nuke/api/gizmo_menu.py
@@ -1,67 +1,75 @@
 import os
-import logging
+import re
 import nuke
 
-log = logging.getLogger(__name__)
+from openpype.api import Logger
+
+log = Logger.get_logger(__name__)
 
 
 class GizmoMenu():
-    def __init__(self, *args, **kwargs):
+    def __init__(self, title, icon=None):
+
+        self.toolbar = self._create_toolbar_menu(
+            title,
+            icon=icon
+        )
+
         self._script_actions = []
 
-    def build_from_configuration(self, parent, configuration):
+    def _create_toolbar_menu(self, name, icon=None):
+        nuke_node_menu = nuke.menu("Nodes")
+        return nuke_node_menu.addMenu(
+            name,
+            icon=icon
+        )
+
+    def _make_menu_path(self, path, icon=None):
+        parent = self.toolbar
+        for folder in re.split(r"/|\\",path):
+            if not folder:
+                continue
+            existing_menu = parent.findItem(folder)
+            if existing_menu:
+                parent = existing_menu
+            else:
+                parent = parent.addMenu(folder, icon=icon)
+
+        return parent
+
+    def build_from_configuration(self, configuration):
         for item in configuration:
             assert isinstance(item, dict), "Configuration is wrong!"
 
-            # skip items which have no `type` key
-            item_type = item.get('type', None)
-            if not item_type:
-                log.warning("Missing 'type' from configuration item")
-                continue
+            # Construct parent path else parent is toolbar
+            parent = self.toolbar
+            gizmo_toolbar_path = item.get("gizmo_toolbar_path")
+            if gizmo_toolbar_path:
+                parent = self._make_menu_path(gizmo_toolbar_path)
 
-            if item_type == "action":
-                # filter out `type` from the item dict
-                config = {key: value for key, value in
-                          item.items() if key != "type"}
-
-                command = str(config['command'])
-
-                icon = config.get('icon', None)
-                if icon:
-                    try:
-                        icon = icon.format(**os.environ)
-                    except KeyError as e:
-                        log.warning("This environment variable doesn't exist: "
-                                    "{}".format(e))
-
-                hotkey = config.get('hotkey', None)
+            item_type = item.get("sourcetype")
 
+            if item_type == ("python" or "file"):
                 parent.addCommand(
-                    config['title'],
-                    command=command,
-                    icon=icon,
-                    shortcut=hotkey
+                    item['title'],
+                    command=str(item["command"]),
+                    icon=item.get("icon"),
+                    shortcut=item.get('hotkey')
                 )
 
             # add separator
             # Special behavior for separators
-            if item_type == "separator":
+            elif item_type == "separator":
                 parent.addSeparator()
 
             # add submenu
             # items should hold a collection of submenu items (dict)
             elif item_type == "menu":
-                assert "items" in item, "Menu is missing 'items' key"
-
-                icon = item.get('icon', None)
-                if icon:
-                    try:
-                        icon = icon.format(**os.environ)
-                    except KeyError as e:
-                        log.warning("This environment variable doesn't exist: "
-                                    "{}".format(e))
-                menu = parent.addMenu(item['title'], icon=icon)
-                self.build_from_configuration(menu, item["items"])
+                # assert "items" in item, "Menu is missing 'items' key"
+                parent.addMenu(
+                    item['title'],
+                    icon=item.get('icon')
+                )
 
     def add_gizmo_path(self, gizmo_paths):
         for gizmo_path in gizmo_paths:
diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index a1ac50ae1a..335e7190a0 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -2500,50 +2500,77 @@ def recreate_instance(origin_node, avalon_data=None):
     return new_node
 
 
-def find_scripts_gizmo(title, parent):
-    """
-    Check if the menu exists with the given title in the parent
-
-    Args:
-        title (str): the title name of the scripts menu
-
-        parent (QtWidgets.QMenuBar): the menubar to check
-
-    Returns:
-        QtWidgets.QMenu or None
-
-    """
-
-    menu = None
-    search = [i for i in parent.items() if
-              isinstance(i, gizmo_menu.GizmoMenu)
-              and i.title() == title]
-
-    if search:
-        assert len(search) < 2, ("Multiple instances of menu '{}' "
-                                 "in toolbar".format(title))
-        menu = search[0]
-
-    return menu
-
-
-def gizmo_creation(title="Gizmos", parent=None, objectName=None, icon=None):
+def add_scripts_gizmo():
     try:
-        toolbar = find_scripts_gizmo(title, parent)
-        if not toolbar:
-            log.info("Attempting to build toolbar...")
-            object_name = objectName or title.lower()
-            toolbar = gizmo_menu.GizmoMenu(
-                title=title,
-                parent=parent,
-                objectName=object_name,
-                icon=icon
-            )
-    except Exception as e:
-        log.error(e)
+        from openpype.hosts.nuke.api import lib
+    except ImportError:
+        log.warning(
+            "Skipping studio.gizmo install, because "
+            "'scriptsgizmo' module seems unavailable."
+        )
         return
 
-    return toolbar
+    # load configuration of custom menu
+    project_settings = get_project_settings(os.getenv("AVALON_PROJECT"))
+    platform_name = platform.system().lower()
+
+    for gizmo_settings in project_settings["nuke"]["gizmo"]:
+        gizmo_list_definition = gizmo_settings["gizmo_definition"]
+        print(1, gizmo_list_definition)
+        toolbar_name = gizmo_settings["toolbar_menu_name"]
+        # gizmo_toolbar_path = gizmo_settings["gizmo_toolbar_path"]
+        gizmo_source_dir = gizmo_settings.get(
+            "gizmo_source_dir", {}).get(platform_name)
+        toolbar_icon_path = gizmo_settings.get(
+            "toolbar_icon_path", {}).get(platform_name)
+
+        if not gizmo_source_dir:
+            log.debug("Skipping studio gizmo `{}`, no gizmo path found.".format(
+                toolbar_name
+            ))
+            return
+
+        if not gizmo_list_definition:
+            log.debug("Skipping studio gizmo `{}`, no definition found.".format(
+                toolbar_name
+            ))
+            return
+
+        if toolbar_icon_path:
+            try:
+                toolbar_icon_path = toolbar_icon_path.format(**os.environ)
+            except KeyError as e:
+                log.error(
+                    "This environment variable doesn't exist: {}".format(e)
+                )
+
+        existing_gizmo_path = []
+        for source_dir in gizmo_source_dir:
+            try:
+                resolve_source_dir = source_dir.format(**os.environ)
+            except KeyError as e:
+                log.error(
+                    "This environment variable doesn't exist: {}".format(e)
+                )
+                continue
+            if not os.path.exists(resolve_source_dir):
+                log.warning(
+                    "The source of gizmo `{}` does not exists".format(
+                        resolve_source_dir
+                    )
+                )
+                continue
+            existing_gizmo_path.append(resolve_source_dir)
+
+        # run the launcher for Nuke toolbar
+        toolbar_menu = gizmo_menu.GizmoMenu(
+            title=toolbar_name,
+            icon=toolbar_icon_path
+        )
+
+        # apply configuration
+        toolbar_menu.add_gizmo_path(existing_gizmo_path)
+        toolbar_menu.build_from_configuration(gizmo_list_definition)
 
 
 class NukeDirmap(HostDirmap):
diff --git a/openpype/hosts/nuke/startup/menu.py b/openpype/hosts/nuke/startup/menu.py
index 715bab8ea5..1461d41385 100644
--- a/openpype/hosts/nuke/startup/menu.py
+++ b/openpype/hosts/nuke/startup/menu.py
@@ -8,7 +8,8 @@ from openpype.hosts.nuke.api.lib import (
     on_script_load,
     check_inventory_versions,
     WorkfileSettings,
-    dirmap_file_name_filter
+    dirmap_file_name_filter,
+    add_scripts_gizmo
 )
 from openpype.settings import get_project_settings
 
@@ -60,71 +61,4 @@ def add_scripts_menu():
 
 add_scripts_menu()
 
-
-def add_scripts_gizmo():
-    try:
-        from openpype.hosts.nuke.api import lib
-    except ImportError:
-        log.warning(
-            "Skipping studio.gizmo install, because "
-            "'scriptsgizmo' module seems unavailable."
-        )
-        return
-
-    # load configuration of custom menu
-    project_settings = get_project_settings(os.getenv("AVALON_PROJECT"))
-
-    for gizmo in project_settings["nuke"]["gizmo"]:
-        config = gizmo["gizmo_definition"]
-        toolbar_name = gizmo["toolbar_menu_name"]
-        gizmo_path = gizmo["gizmo_path"]
-        icon = gizmo['toolbar_icon_path']
-
-        if not any(gizmo_path):
-            log.warning("Skipping studio gizmo, no gizmo path found.")
-            return
-
-        if not config:
-            log.warning("Skipping studio gizmo, no definition found.")
-            return
-
-        try:
-            icon = icon.format(**os.environ)
-        except KeyError as e:
-            log.warning(
-                "This environment variable doesn't exist: {}".format(e)
-            )
-
-        existing_gizmo_path = []
-        for gizmo in gizmo_path:
-            try:
-                gizmo = gizmo.format(**os.environ)
-            except KeyError as e:
-                log.warning(
-                    "This environment variable doesn't exist: {}".format(e)
-                )
-                continue
-            if not os.path.exists(gizmo):
-                log.warning(
-                    "The source of gizmo `{}` does not exists".format(gizmo)
-                )
-                continue
-            existing_gizmo_path.append(gizmo)
-
-        nuke_toolbar = nuke.menu("Nodes")
-        toolbar = nuke_toolbar.addMenu(toolbar_name, icon=icon)
-
-        # run the launcher for Nuke toolbar
-        studio_menu = lib.gizmo_creation(
-            title=toolbar_name,
-            parent=toolbar,
-            objectName=toolbar_name.lower().replace(" ", "_"),
-            icon=icon
-        )
-
-        # apply configuration
-        studio_menu.add_gizmo_path(existing_gizmo_path)
-        studio_menu.build_from_configuration(toolbar, config)
-
-
 add_scripts_gizmo()
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 6c6454de36..63978ad1be 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -293,8 +293,12 @@
     "gizmo": [
         {
             "toolbar_menu_name": "OpenPype Gizmo",
-            "toolbar_icon_path": "path/to/nuke/icon.png",
-            "gizmo_path": ["path/to/nuke/gizmo"],
+            "gizmo_path": {
+                "windows": [],
+                "darwin": [],
+                "linux": []
+            },
+            "toolbar_icon_path": {},
             "gizmo_definition": [
                 {
                     "type": "action",
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json
index c1e67842ce..80fda56175 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json
@@ -14,28 +14,105 @@
             },
             {
                 "type": "path",
-                "key": "toolbar_icon_path",
-                "label": "Toolbar Icon Path",
-                "multipath": false
+                "key": "gizmo_source_dir",
+                "label": "Gizmo directory path",
+                "multipath": true,
+                "multiplatform": true
             },
             {
-                "type": "splitter"
-            },
-            {
-                "type": "label",
-                "label": "Absolute path to gizmo folders."
-            },
-            {
-                "type": "path",
-                "key": "gizmo_path",
-                "label": "Gizmo Path",
-                "multipath": true
-            },
-            {
-                "type": "raw-json",
-                "key": "gizmo_definition",
-                "label": "Gizmo definition",
-                "is_list": true
+                "type": "collapsible-wrap",
+                "label": "Options",
+                "collapsible": true,
+                "collapsed": true,
+                "children": [
+                    {
+                        "type": "path",
+                        "key": "toolbar_icon_path",
+                        "label": "Toolbar Icon Path",
+                        "multipath": false,
+                        "multiplatform": true
+                    },
+                    {
+                        "type": "splitter"
+                    },
+                    {
+                        "type": "list",
+                        "key": "gizmo_definition",
+                        "label": "Gizmo definitions",
+                        "use_label_wrap": true,
+                        "object_type": {
+                            "type": "dict-conditional",
+                            "enum_key": "sourcetype",
+                            "enum_label": "Type of usage",
+                            "enum_children": [
+                                {
+                                    "key": "python",
+                                    "label": "Python",
+                                    "children": [
+                                        {
+                                            "type": "text",
+                                            "key": "title",
+                                            "label": "Title"
+                                        },
+                                        {
+                                            "type": "text",
+                                            "key": "gizmo_toolbar_path",
+                                            "label": "Toolbar path"
+                                        },
+                                        {
+                                            "type": "text",
+                                            "key": "command",
+                                            "label": "Python command"
+                                        },
+                                        {
+                                            "type": "text",
+                                            "key": "shortcut",
+                                            "label": "Hotkey"
+                                        }
+                                    ]
+                                },
+                                {
+                                    "key": "file",
+                                    "label": "File",
+                                    "children": [
+                                        {
+                                            "type": "text",
+                                            "key": "title",
+                                            "label": "Title"
+                                        },
+                                        {
+                                            "type": "text",
+                                            "key": "gizmo_toolbar_path",
+                                            "label": "Toolbar path"
+                                        },
+                                        {
+                                            "type": "text",
+                                            "key": "file_name",
+                                            "label": "Gizmo file name"
+                                        },
+                                        {
+                                            "type": "text",
+                                            "key": "shortcut",
+                                            "label": "Hotkey"
+                                        }
+
+                                    ]
+                                },
+                                {
+                                    "key": "separator",
+                                    "label": "Separator",
+                                    "children": [
+                                        {
+                                            "type": "text",
+                                            "key": "gizmo_toolbar_path",
+                                            "label": "Toolbar path"
+                                        }
+                                    ]
+                                }
+                            ]
+                        }
+                    }
+                ]
             }
         ]
     }

From b77cb4ba1a367e5974342e670241d19137fb2a3e Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 6 Jun 2022 19:17:34 +0200
Subject: [PATCH 0477/1227] Add global menu from settings

---
 openpype/hosts/nuke/api/gizmo_menu.py         |  52 +++----
 openpype/hosts/nuke/api/lib.py                |   1 -
 .../defaults/project_settings/nuke.json       |  13 +-
 .../schemas/schema_nuke_scriptsgizmo.json     | 133 +++++++++---------
 4 files changed, 106 insertions(+), 93 deletions(-)

diff --git a/openpype/hosts/nuke/api/gizmo_menu.py b/openpype/hosts/nuke/api/gizmo_menu.py
index 7f8121372c..42b5812360 100644
--- a/openpype/hosts/nuke/api/gizmo_menu.py
+++ b/openpype/hosts/nuke/api/gizmo_menu.py
@@ -38,38 +38,42 @@ class GizmoMenu():
         return parent
 
     def build_from_configuration(self, configuration):
-        for item in configuration:
-            assert isinstance(item, dict), "Configuration is wrong!"
-
+        for menu in configuration:
             # Construct parent path else parent is toolbar
             parent = self.toolbar
-            gizmo_toolbar_path = item.get("gizmo_toolbar_path")
+            gizmo_toolbar_path = menu.get("gizmo_toolbar_path")
             if gizmo_toolbar_path:
                 parent = self._make_menu_path(gizmo_toolbar_path)
 
-            item_type = item.get("sourcetype")
+            for item in menu["sub_gizmo_list"]:
+                assert isinstance(item, dict), "Configuration is wrong!"
 
-            if item_type == ("python" or "file"):
-                parent.addCommand(
-                    item['title'],
-                    command=str(item["command"]),
-                    icon=item.get("icon"),
-                    shortcut=item.get('hotkey')
-                )
+                if not item.get("title"):
+                    continue
 
-            # add separator
-            # Special behavior for separators
-            elif item_type == "separator":
-                parent.addSeparator()
+                item_type = item.get("sourcetype")
 
-            # add submenu
-            # items should hold a collection of submenu items (dict)
-            elif item_type == "menu":
-                # assert "items" in item, "Menu is missing 'items' key"
-                parent.addMenu(
-                    item['title'],
-                    icon=item.get('icon')
-                )
+                if item_type == ("python" or "file"):
+                    parent.addCommand(
+                        item["title"],
+                        command=str(item["command"]),
+                        icon=item.get("icon"),
+                        shortcut=item.get("hotkey")
+                    )
+
+                # add separator
+                # Special behavior for separators
+                elif item_type == "separator":
+                    parent.addSeparator()
+
+                # add submenu
+                # items should hold a collection of submenu items (dict)
+                elif item_type == "menu":
+                    # assert "items" in item, "Menu is missing 'items' key"
+                    parent.addMenu(
+                        item['title'],
+                        icon=item.get('icon')
+                    )
 
     def add_gizmo_path(self, gizmo_paths):
         for gizmo_path in gizmo_paths:
diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 335e7190a0..0d766c8459 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -2516,7 +2516,6 @@ def add_scripts_gizmo():
 
     for gizmo_settings in project_settings["nuke"]["gizmo"]:
         gizmo_list_definition = gizmo_settings["gizmo_definition"]
-        print(1, gizmo_list_definition)
         toolbar_name = gizmo_settings["toolbar_menu_name"]
         # gizmo_toolbar_path = gizmo_settings["gizmo_toolbar_path"]
         gizmo_source_dir = gizmo_settings.get(
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 63978ad1be..c609a0927a 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -301,10 +301,15 @@
             "toolbar_icon_path": {},
             "gizmo_definition": [
                 {
-                    "type": "action",
-                    "sourcetype": "python",
-                    "title": "Gizmo Note",
-                    "command": "nuke.nodes.StickyNote(label='You can create your own toolbar menu in the Nuke GizmoMenu of OpenPype')"
+                    "gizmo_toolbar_path": "/path/to/menu",
+                    "sub_gizmo_list": [
+                        {
+                            "sourcetype": "python",
+                            "title": "Gizmo Note",
+                            "command": "nuke.nodes.StickyNote(label='You can create your own toolbar menu in the Nuke GizmoMenu of OpenPype')",
+                            "shortcut": ""
+                        }
+                    ]
                 }
             ]
         }
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json
index 80fda56175..abe14970c5 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_scriptsgizmo.json
@@ -41,73 +41,78 @@
                         "label": "Gizmo definitions",
                         "use_label_wrap": true,
                         "object_type": {
-                            "type": "dict-conditional",
-                            "enum_key": "sourcetype",
-                            "enum_label": "Type of usage",
-                            "enum_children": [
+                            "type": "dict",
+                            "children": [
                                 {
-                                    "key": "python",
-                                    "label": "Python",
-                                    "children": [
-                                        {
-                                            "type": "text",
-                                            "key": "title",
-                                            "label": "Title"
-                                        },
-                                        {
-                                            "type": "text",
-                                            "key": "gizmo_toolbar_path",
-                                            "label": "Toolbar path"
-                                        },
-                                        {
-                                            "type": "text",
-                                            "key": "command",
-                                            "label": "Python command"
-                                        },
-                                        {
-                                            "type": "text",
-                                            "key": "shortcut",
-                                            "label": "Hotkey"
-                                        }
-                                    ]
+                                    "type": "text",
+                                    "key": "gizmo_toolbar_path",
+                                    "label": "Gizmo Menu Path"
                                 },
                                 {
-                                    "key": "file",
-                                    "label": "File",
-                                    "children": [
-                                        {
-                                            "type": "text",
-                                            "key": "title",
-                                            "label": "Title"
-                                        },
-                                        {
-                                            "type": "text",
-                                            "key": "gizmo_toolbar_path",
-                                            "label": "Toolbar path"
-                                        },
-                                        {
-                                            "type": "text",
-                                            "key": "file_name",
-                                            "label": "Gizmo file name"
-                                        },
-                                        {
-                                            "type": "text",
-                                            "key": "shortcut",
-                                            "label": "Hotkey"
-                                        }
-
-                                    ]
-                                },
-                                {
-                                    "key": "separator",
-                                    "label": "Separator",
-                                    "children": [
-                                        {
-                                            "type": "text",
-                                            "key": "gizmo_toolbar_path",
-                                            "label": "Toolbar path"
-                                        }
-                                    ]
+                                    "type": "list",
+                                    "key": "sub_gizmo_list",
+                                    "label": "Sub Gizmo List",
+                                    "use_label_wrap": true,
+                                    "object_type": {
+                                        "type": "dict-conditional",
+                                        "enum_key": "sourcetype",
+                                        "enum_label": "Type of usage",
+                                        "enum_children": [
+                                            {
+                                                "key": "python",
+                                                "label": "Python",
+                                                "children": [
+                                                    {
+                                                        "type": "text",
+                                                        "key": "title",
+                                                        "label": "Title"
+                                                    },
+                                                    {
+                                                        "type": "text",
+                                                        "key": "command",
+                                                        "label": "Python command"
+                                                    },
+                                                    {
+                                                        "type": "text",
+                                                        "key": "shortcut",
+                                                        "label": "Hotkey"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "key": "file",
+                                                "label": "File",
+                                                "children": [
+                                                    {
+                                                        "type": "text",
+                                                        "key": "title",
+                                                        "label": "Title"
+                                                    },
+                                                    {
+                                                        "type": "text",
+                                                        "key": "file_name",
+                                                        "label": "Gizmo file name"
+                                                    },
+                                                    {
+                                                        "type": "text",
+                                                        "key": "shortcut",
+                                                        "label": "Hotkey"
+                                                    }
+                                                ]
+                                            },
+                                            {
+                                                "key": "separator",
+                                                "label": "Separator",
+                                                "children": [
+                                                {
+                                                    "type": "text",
+                                                    "key": "gizmo_toolbar_path",
+                                                    "label": "Toolbar path"
+                                                }
+                                                ]
+                                            }
+                                        ]
+                                    }
                                 }
                             ]
                         }

From 25e9ee617e798e14cffb6e2090e1a4dbdb88214c Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 6 Jun 2022 21:00:24 +0200
Subject: [PATCH 0478/1227] linter correction

---
 openpype/hosts/nuke/api/gizmo_menu.py |  2 +-
 openpype/hosts/nuke/api/lib.py        | 20 ++++++--------------
 2 files changed, 7 insertions(+), 15 deletions(-)

diff --git a/openpype/hosts/nuke/api/gizmo_menu.py b/openpype/hosts/nuke/api/gizmo_menu.py
index 42b5812360..0f1a3e03fc 100644
--- a/openpype/hosts/nuke/api/gizmo_menu.py
+++ b/openpype/hosts/nuke/api/gizmo_menu.py
@@ -26,7 +26,7 @@ class GizmoMenu():
 
     def _make_menu_path(self, path, icon=None):
         parent = self.toolbar
-        for folder in re.split(r"/|\\",path):
+        for folder in re.split(r"/|\\", path):
             if not folder:
                 continue
             existing_menu = parent.findItem(folder)
diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 0d766c8459..2c5989309b 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -2501,14 +2501,6 @@ def recreate_instance(origin_node, avalon_data=None):
 
 
 def add_scripts_gizmo():
-    try:
-        from openpype.hosts.nuke.api import lib
-    except ImportError:
-        log.warning(
-            "Skipping studio.gizmo install, because "
-            "'scriptsgizmo' module seems unavailable."
-        )
-        return
 
     # load configuration of custom menu
     project_settings = get_project_settings(os.getenv("AVALON_PROJECT"))
@@ -2524,15 +2516,15 @@ def add_scripts_gizmo():
             "toolbar_icon_path", {}).get(platform_name)
 
         if not gizmo_source_dir:
-            log.debug("Skipping studio gizmo `{}`, no gizmo path found.".format(
-                toolbar_name
-            ))
+            log.debug("Skipping studio gizmo `{}`, "
+                      "no gizmo path found.".format(toolbar_name)
+                      )
             return
 
         if not gizmo_list_definition:
-            log.debug("Skipping studio gizmo `{}`, no definition found.".format(
-                toolbar_name
-            ))
+            log.debug("Skipping studio gizmo `{}`, "
+                      "no definition found.".format(toolbar_name)
+                      )
             return
 
         if toolbar_icon_path:

From 2f945b9a7b3ce04fa3a37eb3eafac5cdc3efe942 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 7 Jun 2022 11:06:10 +0200
Subject: [PATCH 0479/1227] Added checkbox to filter only enabled projects

Default is true, is not persistent between opening of dialog.
---
 openpype/modules/sync_server/tray/app.py     | 36 +++++++++++++++-----
 openpype/modules/sync_server/tray/widgets.py |  3 ++
 2 files changed, 30 insertions(+), 9 deletions(-)

diff --git a/openpype/modules/sync_server/tray/app.py b/openpype/modules/sync_server/tray/app.py
index fc8558bdbc..4aa3d430fa 100644
--- a/openpype/modules/sync_server/tray/app.py
+++ b/openpype/modules/sync_server/tray/app.py
@@ -46,6 +46,14 @@ class SyncServerWindow(QtWidgets.QDialog):
 
         left_column_layout.addWidget(self.pause_btn)
 
+        checkbox = QtWidgets.QCheckBox("Show only enabled", self)
+        checkbox.setStyleSheet("QCheckBox{spacing: 5px;"
+                               "padding:5px 5px 5px 5px;}")
+        checkbox.setChecked(True)
+        self.show_only_enabled_chk = checkbox
+
+        left_column_layout.addWidget(self.show_only_enabled_chk)
+
         repres = SyncRepresentationSummaryWidget(
             sync_server,
             project=self.projects.current_project,
@@ -86,8 +94,23 @@ class SyncServerWindow(QtWidgets.QDialog):
         repres.message_generated.connect(self._update_message)
         self.projects.message_generated.connect(self._update_message)
 
+        self.show_only_enabled_chk.stateChanged.connect(
+            self._on_enabled_change
+        )
+
         self.representationWidget = repres
 
+    def showEvent(self, event):
+        self.representationWidget.model.set_project(
+            self.projects.current_project)
+        self.projects.refresh()
+        self._set_running(True)
+        super().showEvent(event)
+
+    def closeEvent(self, event):
+        self._set_running(False)
+        super().closeEvent(event)
+
     def _on_project_change(self):
         if self.projects.current_project is None:
             return
@@ -103,16 +126,11 @@ class SyncServerWindow(QtWidgets.QDialog):
             self.projects.refresh()
             return
 
-    def showEvent(self, event):
-        self.representationWidget.model.set_project(
-            self.projects.current_project)
+    def _on_enabled_change(self):
+        """Called when enabled projects only checkbox is toggled."""
+        self.projects.show_only_enabled = \
+            self.show_only_enabled_chk.isChecked()
         self.projects.refresh()
-        self._set_running(True)
-        super().showEvent(event)
-
-    def closeEvent(self, event):
-        self._set_running(False)
-        super().closeEvent(event)
 
     def _set_running(self, running):
         self.representationWidget.model.is_running = running
diff --git a/openpype/modules/sync_server/tray/widgets.py b/openpype/modules/sync_server/tray/widgets.py
index e41910fa4f..88ed2c1d37 100644
--- a/openpype/modules/sync_server/tray/widgets.py
+++ b/openpype/modules/sync_server/tray/widgets.py
@@ -47,6 +47,7 @@ class SyncProjectListWidget(QtWidgets.QWidget):
     message_generated = QtCore.Signal(str)
 
     refresh_msec = 10000
+    show_only_enabled = True
 
     def __init__(self, sync_server, parent):
         super(SyncProjectListWidget, self).__init__(parent)
@@ -128,6 +129,8 @@ class SyncProjectListWidget(QtWidgets.QWidget):
                self.sync_server.is_project_paused(project_name):
                 icon = self._get_icon("paused")
             elif not sync_settings[project_name]["enabled"]:
+                if self.show_only_enabled:
+                    continue
                 icon = self._get_icon("disabled")
             else:
                 icon = self._get_icon("synced")

From e2d6d903e99120048d92cb7fbabe42b111df373c Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 7 Jun 2022 11:23:45 +0000
Subject: [PATCH 0480/1227] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b6966adbc4..b8c04f8b49 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-26-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-27-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 OpenPype
 ====
@@ -328,6 +328,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <td align="center"><a href="https://github.com/Malthaldar"><img src="https://avatars.githubusercontent.com/u/33671694?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Malthaldar</b></sub></a><br /><a href="https://github.com/pypeclub/OpenPype/commits?author=Malthaldar" title="Code">💻</a></td>
     <td align="center"><a href="http://www.svenneve.com/"><img src="https://avatars.githubusercontent.com/u/2472863?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sven Neve</b></sub></a><br /><a href="https://github.com/pypeclub/OpenPype/commits?author=svenneve" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/zafrs"><img src="https://avatars.githubusercontent.com/u/26890002?v=4?s=100" width="100px;" alt=""/><br /><sub><b>zafrs</b></sub></a><br /><a href="https://github.com/pypeclub/OpenPype/commits?author=zafrs" title="Code">💻</a></td>
+    <td align="center"><a href="http://felixdavid.com/"><img src="https://avatars.githubusercontent.com/u/22875539?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Félix David</b></sub></a><br /><a href="https://github.com/pypeclub/OpenPype/commits?author=Tilix4" title="Code">💻</a> <a href="https://github.com/pypeclub/OpenPype/commits?author=Tilix4" title="Documentation">📖</a></td>
   </tr>
 </table>
 

From 884fce81ce10c6f31e8738b1e7c6f178787ba9df Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 7 Jun 2022 11:23:46 +0000
Subject: [PATCH 0481/1227] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index a3b85cae68..b30f3b2499 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -309,7 +309,18 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "Tilix4",
+      "name": "Félix David",
+      "avatar_url": "https://avatars.githubusercontent.com/u/22875539?v=4",
+      "profile": "http://felixdavid.com/",
+      "contributions": [
+        "code",
+        "doc"
+      ]
     }
   ],
-  "contributorsPerLine": 7
-}
\ No newline at end of file
+  "contributorsPerLine": 7,
+  "skipCi": true
+}

From 9babdb7832c9cc6644e0dc4ff8f3d024b068fd52 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Tue, 7 Jun 2022 14:18:48 +0200
Subject: [PATCH 0482/1227] :recycle: limit the scope of file attribute
 skipping filter

---
 openpype/hosts/maya/plugins/publish/collect_look.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index 9b6d1d999c..60af5238d0 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -601,8 +601,10 @@ class CollectLook(pyblish.api.InstancePlugin):
                                                      source,
                                                      computed_source))
 
-            if not source:
-                self.log.info("source is empty, skipping...")
+            # renderman allows nodes to have filename attribute empty while
+            # you can have another incoming connection from different node.
+            if not source and cmds.nodeType(node).lower().startswith("pxr"):
+                self.log.info("Renderman: source is empty, skipping...")
                 continue
             # We replace backslashes with forward slashes because V-Ray
             # can't handle the UDIM files with the backslashes in the

From 71cabc76c4386bff5c8d89ab0afcc6d5d15c61ab Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 7 Jun 2022 15:13:08 +0200
Subject: [PATCH 0483/1227] Handle when no projects are shown or selected

---
 openpype/modules/sync_server/tray/app.py     |  1 +
 openpype/modules/sync_server/tray/models.py  | 33 +++++++++++++-------
 openpype/modules/sync_server/tray/widgets.py |  6 ++--
 3 files changed, 26 insertions(+), 14 deletions(-)

diff --git a/openpype/modules/sync_server/tray/app.py b/openpype/modules/sync_server/tray/app.py
index 4aa3d430fa..dee3bf0ecc 100644
--- a/openpype/modules/sync_server/tray/app.py
+++ b/openpype/modules/sync_server/tray/app.py
@@ -131,6 +131,7 @@ class SyncServerWindow(QtWidgets.QDialog):
         self.projects.show_only_enabled = \
             self.show_only_enabled_chk.isChecked()
         self.projects.refresh()
+        self.representationWidget.model.set_project(None)
 
     def _set_running(self, running):
         self.representationWidget.model.is_running = running
diff --git a/openpype/modules/sync_server/tray/models.py b/openpype/modules/sync_server/tray/models.py
index 6b309312a2..c49edeafb9 100644
--- a/openpype/modules/sync_server/tray/models.py
+++ b/openpype/modules/sync_server/tray/models.py
@@ -52,7 +52,8 @@ class _SyncRepresentationModel(QtCore.QAbstractTableModel):
 
             All queries should go through this (because of collection).
         """
-        return self.sync_server.connection.database[self.project]
+        if self.project:
+            return self.sync_server.connection.database[self.project]
 
     @property
     def project(self):
@@ -150,6 +151,9 @@ class _SyncRepresentationModel(QtCore.QAbstractTableModel):
     @property
     def can_edit(self):
         """Returns true if some site is user local site, eg. could edit"""
+        if not self.project:
+            return False
+
         return get_local_site_id() in (self.active_site, self.remote_site)
 
     def get_column(self, index):
@@ -190,7 +194,7 @@ class _SyncRepresentationModel(QtCore.QAbstractTableModel):
                     actually queried (scrolled a couple of times to list more
                     than single page of records)
         """
-        if self.is_editing or not self.is_running:
+        if self.is_editing or not self.is_running or not self.project:
             return
         self.refresh_started.emit()
         self.beginResetModel()
@@ -232,6 +236,9 @@ class _SyncRepresentationModel(QtCore.QAbstractTableModel):
             more records in DB than loaded.
         """
         log.debug("fetchMore")
+        if not self.dbcon:
+            return
+
         items_to_fetch = min(self._total_records - self._rec_loaded,
                              self.PAGE_SIZE)
         self.query = self.get_query(self._rec_loaded)
@@ -286,9 +293,10 @@ class _SyncRepresentationModel(QtCore.QAbstractTableModel):
         #           replace('False', 'false').\
         #           replace('True', 'true').replace('None', 'null'))
 
-        representations = self.dbcon.aggregate(pipeline=self.query,
-                                               allowDiskUse=True)
-        self.refresh(representations)
+        if self.dbcon:
+            representations = self.dbcon.aggregate(pipeline=self.query,
+                                                   allowDiskUse=True)
+            self.refresh(representations)
 
     def set_word_filter(self, word_filter):
         """
@@ -380,6 +388,7 @@ class _SyncRepresentationModel(QtCore.QAbstractTableModel):
         self._project = project
         # project might have been deactivated in the meantime
         if not self.sync_server.get_sync_project_setting(project):
+            self._data = {}
             return
 
         self.active_site = self.sync_server.get_active_site(self.project)
@@ -508,21 +517,23 @@ class SyncRepresentationSummaryModel(_SyncRepresentationModel):
 
         self._word_filter = None
 
-        if not self._project or self._project == lib.DUMMY_PROJECT:
-            return
-
         self.sync_server = sync_server
         # TODO think about admin mode
+        self.sort_criteria = self.DEFAULT_SORT
+
+        self.timer = QtCore.QTimer()
+        if not self._project or self._project == lib.DUMMY_PROJECT:
+            self.active_site = sync_server.DEFAULT_SITE
+            self.remote_site = sync_server.DEFAULT_SITE
+            return
+
         # this is for regular user, always only single local and single remote
         self.active_site = self.sync_server.get_active_site(self.project)
         self.remote_site = self.sync_server.get_remote_site(self.project)
 
-        self.sort_criteria = self.DEFAULT_SORT
-
         self.query = self.get_query()
         self.default_query = list(self.get_query())
 
-        self.timer = QtCore.QTimer()
         self.timer.timeout.connect(self.tick)
         self.timer.start(self.REFRESH_SEC)
 
diff --git a/openpype/modules/sync_server/tray/widgets.py b/openpype/modules/sync_server/tray/widgets.py
index 88ed2c1d37..89ab12ea4d 100644
--- a/openpype/modules/sync_server/tray/widgets.py
+++ b/openpype/modules/sync_server/tray/widgets.py
@@ -144,12 +144,12 @@ class SyncProjectListWidget(QtWidgets.QWidget):
             if self.current_project == project_name:
                 selected_item = item
 
+        if model.item(0) is None:
+            return
+
         if selected_item:
             selected_index = model.indexFromItem(selected_item)
 
-        if len(self.sync_server.sync_project_settings.keys()) == 0:
-            model.appendRow(QtGui.QStandardItem(lib.DUMMY_PROJECT))
-
         if not self.current_project:
             self.current_project = model.item(0).data(QtCore.Qt.DisplayRole)
 

From 9829410932e18f85f4e899a2af045e65aa1d12ab Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 15:16:39 +0200
Subject: [PATCH 0484/1227] implemented get_representation_parents for single
 representation

---
 openpype/client/__init__.py | 2 ++
 openpype/client/entities.py | 9 +++++++++
 2 files changed, 11 insertions(+)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index 861f828e67..e4c01fc0cc 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -22,6 +22,7 @@ from .entities import (
     get_representation,
     get_representation_by_name,
     get_representations,
+    get_representation_parents,
     get_representations_parents,
 
     get_thumbnail,
@@ -52,6 +53,7 @@ __all__ = (
     "get_representation",
     "get_representation_by_name",
     "get_representations",
+    "get_representation_parents",
     "get_representations_parents",
 
     "get_thubmnail",
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 4b52f8cf2d..e9b820dd1a 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -641,6 +641,15 @@ def get_representations_parents(project_name, representations):
     return output
 
 
+def get_representation_parents(project_name, representation):
+    if not representation:
+        return None
+
+    repre_id = representation["_id"]
+    parents_by_repre_id = get_representations(project_name, [representation])
+    return parents_by_repre_id.get(repre_id)
+
+
 def get_thumbnail_id_from_source(project_name, src_type, src_id):
     if not src_type or not src_id:
         return None

From f760c9d767c46a0ee433e83890cc15b4565f412f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Tue, 7 Jun 2022 15:28:11 +0200
Subject: [PATCH 0485/1227] :recycle: more explicit renderman check

---
 openpype/hosts/maya/plugins/publish/collect_look.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index 60af5238d0..4a34cfdea2 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -603,7 +603,14 @@ class CollectLook(pyblish.api.InstancePlugin):
 
             # renderman allows nodes to have filename attribute empty while
             # you can have another incoming connection from different node.
-            if not source and cmds.nodeType(node).lower().startswith("pxr"):
+            pxr_nodes = set()
+            if cmds.pluginInfo("RenderMan_for_Maya", query=True, loaded=True):
+                pxr_nodes = set(
+                    cmds.pluginInfo("RenderMan_for_Maya",
+                                    query=True,
+                                    dependNode=True)
+                )
+            if not source and cmds.nodeType(node) in pxr_nodes:
                 self.log.info("Renderman: source is empty, skipping...")
                 continue
             # We replace backslashes with forward slashes because V-Ray

From dcac9e08a6aae510f024389870a212d0aae1596e Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Tue, 7 Jun 2022 15:53:08 +0200
Subject: [PATCH 0486/1227] :recycle: few tweaks

---
 tools/create_env.ps1            | 4 +++-
 tools/fetch_thirdparty_libs.ps1 | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/tools/create_env.ps1 b/tools/create_env.ps1
index 9472c75c2f..b1337b5635 100644
--- a/tools/create_env.ps1
+++ b/tools/create_env.ps1
@@ -169,14 +169,16 @@ if (-not (Test-Path -PathType Leaf -Path "$($openpype_root)\poetry.lock")) {
 } else {
     Write-Color -Text ">>> ", "Installing virtual environment from lock." -Color Green, Gray
 }
+$startTime = [int][double]::Parse((Get-Date -UFormat %s))
 & "$env:POETRY_HOME\bin\poetry" install --no-root $poetry_verbosity --ansi
 if ($LASTEXITCODE -ne 0) {
     Write-Color -Text "!!! ", "Poetry command failed." -Color Red, Yellow
     Set-Location -Path $current_dir
     Exit-WithCode 1
 }
+$endTime = [int][double]::Parse((Get-Date -UFormat %s))
 Set-Location -Path $current_dir
 
-New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype", "Virtual environment created."
+New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype", "Virtual environment created.", "All done in $($endTime - $startTime) secs."
 
 Write-Color -Text ">>> ", "Virtual environment created." -Color Green, White
diff --git a/tools/fetch_thirdparty_libs.ps1 b/tools/fetch_thirdparty_libs.ps1
index 0226a35bfb..41a3585ff9 100644
--- a/tools/fetch_thirdparty_libs.ps1
+++ b/tools/fetch_thirdparty_libs.ps1
@@ -34,6 +34,8 @@ if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
 } else {
     Write-Color -Text "OK" -Color Green
 }
-
+$startTime = [int][double]::Parse((Get-Date -UFormat %s))
 & "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\tools\fetch_thirdparty_libs.py"
+$endTime = [int][double]::Parse((Get-Date -UFormat %s))
 Set-Location -Path $current_dir
+New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype", "Dependencies downloaded", "All done in $($endTime - $startTime) secs."

From 0d38c76f5402cd99e5a70385667ff1a5f0885eb7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 16:28:53 +0200
Subject: [PATCH 0487/1227] separated functions to query asset by name and id

---
 openpype/client/__init__.py                   |  8 ++--
 openpype/client/entities.py                   | 43 ++++++++++++++-----
 openpype/tools/creator/window.py              |  6 +--
 openpype/tools/mayalookassigner/commands.py   |  4 +-
 .../tools/publisher/widgets/create_dialog.py  |  4 +-
 openpype/tools/sceneinventory/model.py        |  4 +-
 .../tools/sceneinventory/switch_dialog.py     | 32 +++++++-------
 openpype/tools/sceneinventory/view.py         |  4 +-
 openpype/tools/standalonepublish/app.py       |  6 +--
 .../standalonepublish/widgets/widget_asset.py | 10 ++---
 .../widgets/widget_family.py                  | 14 +++---
 openpype/tools/texture_copy/app.py            |  4 +-
 openpype/tools/utils/lib.py                   |  6 +--
 openpype/tools/utils/tasks_widget.py          |  6 +--
 openpype/tools/workfiles/files_widget.py      |  4 +-
 openpype/tools/workfiles/save_as_dialog.py    |  6 +--
 openpype/tools/workfiles/window.py            |  6 +--
 17 files changed, 94 insertions(+), 73 deletions(-)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index e4c01fc0cc..2ba2a3693e 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -2,7 +2,8 @@ from .entities import (
     get_projects,
     get_project,
 
-    get_asset,
+    get_asset_by_id,
+    get_asset_by_name,
     get_assets,
     get_asset_ids_with_subsets,
 
@@ -33,7 +34,8 @@ __all__ = (
     "get_projects",
     "get_project",
 
-    "get_asset",
+    "get_asset_by_id",
+    "get_asset_by_name",
     "get_assets",
     "get_asset_ids_with_subsets",
 
@@ -56,6 +58,6 @@ __all__ = (
     "get_representation_parents",
     "get_representations_parents",
 
-    "get_thubmnail",
+    "get_thumbnail",
     "get_thumbnail_id_from_source",
 )
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index e9b820dd1a..97553f30fe 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -90,23 +90,44 @@ def get_project(project_name, active=True, inactive=False, fields=None):
     return conn.find_one(query_filter, _prepare_fields(fields))
 
 
-def get_asset(project_name, asset_name=None, asset_id=None, fields=None):
-    query_filter = {"type": "asset"}
-    has_filter = False
-    if asset_name:
-        has_filter = True
-        query_filter["name"] = asset_name
+def get_asset_by_id(project_name, asset_id, fields=None):
+    """Receive asset data by it's id.
 
-    if asset_id:
-        has_filter = True
-        query_filter["_id"] = _convert_id(asset_id)
+    Args:
+        project_name (str): Name of project where to look for subset.
+        asset_id (str|ObjectId): Asset's id.
 
-    # Avoid random asset quqery
-    if not has_filter:
+    Returns:
+        dict: Asset entity data.
+        None: Asset was not found by id.
+    """
+
+    asset_id = _convert_id(asset_id)
+    if not asset_id:
         return None
 
+    query_filter = {"type": "asset", "_id": asset_id}
     conn = _get_project_connection(project_name)
+    return conn.find_one(query_filter, _prepare_fields(fields))
 
+
+def get_asset_by_name(project_name, asset_name, fields=None):
+    """Receive asset data by it's name.
+
+    Args:
+        project_name (str): Name of project where to look for subset.
+        asset_name (str): Asset's name.
+
+    Returns:
+        dict: Asset entity data.
+        None: Asset was not found by name.
+    """
+
+    if not asset_name:
+        return None
+
+    query_filter = {"type": "asset", "name": asset_name}
+    conn = _get_project_connection(project_name)
     return conn.find_one(query_filter, _prepare_fields(fields))
 
 
diff --git a/openpype/tools/creator/window.py b/openpype/tools/creator/window.py
index a85f47a060..a3937d6a40 100644
--- a/openpype/tools/creator/window.py
+++ b/openpype/tools/creator/window.py
@@ -4,7 +4,7 @@ import re
 
 from Qt import QtWidgets, QtCore
 
-from openpype.client import get_asset, get_subsets
+from openpype.client import get_asset_by_name, get_subsets
 from openpype import style
 from openpype.api import get_current_project_settings
 from openpype.tools.utils.lib import qt_app_context
@@ -220,8 +220,8 @@ class CreatorWindow(QtWidgets.QDialog):
         asset_doc = None
         if creator_plugin:
             # Get the asset from the database which match with the name
-            asset_doc = get_asset(
-                project_name, asset_name=asset_name, fields=["_id"]
+            asset_doc = get_asset_by_name(
+                project_name, asset_name, fields=["_id"]
             )
 
         # Get plugin
diff --git a/openpype/tools/mayalookassigner/commands.py b/openpype/tools/mayalookassigner/commands.py
index a4fc1fab70..2e7a51efde 100644
--- a/openpype/tools/mayalookassigner/commands.py
+++ b/openpype/tools/mayalookassigner/commands.py
@@ -4,7 +4,7 @@ import os
 
 import maya.cmds as cmds
 
-from openpype.client import get_asset
+from openpype.client import get_asset_by_id
 from openpype.pipeline import (
     legacy_io,
     remove_container,
@@ -161,7 +161,7 @@ def create_items_from_nodes(nodes):
 
     project_name = legacy_io.active_project()
     for _id, id_nodes in id_hashes.items():
-        asset = get_asset(project_name, asset_id=_id, fields=["name"])
+        asset = get_asset_by_id(project_name, _id, fields=["name"])
 
         # Skip if asset id is not found
         if not asset:
diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index d579831b21..53bbef8b75 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -10,7 +10,7 @@ except Exception:
     commonmark = None
 from Qt import QtWidgets, QtCore, QtGui
 
-from openpype.client import get_asset, get_subsets
+from openpype.client import get_asset_by_name, get_subsets
 from openpype.lib import TaskNotSetError
 from openpype.pipeline.create import (
     CreatorError,
@@ -650,7 +650,7 @@ class CreateDialog(QtWidgets.QDialog):
             return
 
         project_name = self.dbcon.active_project()
-        asset_doc = get_asset(project_name, asset_name=asset_name)
+        asset_doc = get_asset_by_name(project_name, asset_name)
         self._asset_doc = asset_doc
 
         if asset_doc:
diff --git a/openpype/tools/sceneinventory/model.py b/openpype/tools/sceneinventory/model.py
index 9cf69ed650..6d813af45b 100644
--- a/openpype/tools/sceneinventory/model.py
+++ b/openpype/tools/sceneinventory/model.py
@@ -7,7 +7,7 @@ from Qt import QtCore, QtGui
 import qtawesome
 
 from openpype.client import (
-    get_asset,
+    get_asset_by_id,
     get_subset,
     get_version,
     get_last_version_for_subset,
@@ -342,7 +342,7 @@ class InventoryModel(TreeModel):
                 not_found_ids.append(repre_id)
                 continue
 
-            asset = get_asset(project_name, asset_id=subset["parent"])
+            asset = get_asset_by_id(project_name, subset["parent"])
             if not asset:
                 not_found["asset"].append(group_items)
                 not_found_ids.append(repre_id)
diff --git a/openpype/tools/sceneinventory/switch_dialog.py b/openpype/tools/sceneinventory/switch_dialog.py
index b940c66a56..6d6294af6f 100644
--- a/openpype/tools/sceneinventory/switch_dialog.py
+++ b/openpype/tools/sceneinventory/switch_dialog.py
@@ -5,7 +5,7 @@ import qtawesome
 from bson.objectid import ObjectId
 
 from openpype.client import (
-    get_asset,
+    get_asset_by_name,
     get_assets,
     get_subset,
     get_subsets,
@@ -484,9 +484,9 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         # Prepare asset document if asset is selected
         asset_doc = None
         if selected_asset:
-            asset_doc = get_asset(
+            asset_doc = get_asset_by_name(
                 self.active_project(),
-                asset_name=selected_asset,
+                selected_asset,
                 fields=["_id"]
             )
             if not asset_doc:
@@ -768,8 +768,8 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         project_name = self.active_project()
         selected_asset = self._assets_box.get_valid_value()
         if selected_asset:
-            asset_doc = get_asset(
-                project_name, asset_name=selected_asset, fields=["_id"]
+            asset_doc = get_asset_by_name(
+                project_name, selected_asset, fields=["_id"]
             )
             asset_ids = [asset_doc["_id"]]
         else:
@@ -832,8 +832,8 @@ class SwitchAssetDialog(QtWidgets.QDialog):
 
         # [x] [x] [?]
         if selected_asset and selected_subset:
-            asset_doc = get_asset(
-                project_name, asset_name=selected_asset, fields=["_id"]
+            asset_doc = get_asset_by_name(
+                project_name, selected_asset, fields=["_id"]
             )
             subset_doc = get_subset(
                 project_name,
@@ -858,8 +858,8 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         # [x] [ ] [?]
         # If asset only is selected
         if selected_asset:
-            asset_doc = get_asset(
-                project_name, asset_name=selected_asset, fields=["_id"]
+            asset_doc = get_asset_by_name(
+                project_name, selected_asset, fields=["_id"]
             )
             if not asset_doc:
                 return list()
@@ -995,8 +995,8 @@ class SwitchAssetDialog(QtWidgets.QDialog):
 
         # [x] [ ] [?]
         project_name = self.active_project()
-        asset_doc = get_asset(
-            project_name, asset_name=selected_asset, fields=["_id"]
+        asset_doc = get_asset_by_name(
+            project_name, selected_asset, fields=["_id"]
         )
         subset_docs = get_subsets(
             project_name, asset_ids=[asset_doc["_id"]], fields=["name"]
@@ -1043,8 +1043,8 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         # [x] [x] [ ]
         project_name = self.active_project()
         if selected_asset is not None and selected_subset is not None:
-            asset_doc = get_asset(
-                project_name, asset_name=selected_asset, fields=["_id"]
+            asset_doc = get_asset_by_name(
+                project_name, selected_asset, fields=["_id"]
             )
             subset_doc = get_subset(
                 project_name,
@@ -1077,8 +1077,8 @@ class SwitchAssetDialog(QtWidgets.QDialog):
 
         # [x] [ ] [ ]
         if selected_asset is not None:
-            asset_doc = get_asset(
-                project_name, asset_name=selected_asset, fields=["_id"]
+            asset_doc = get_asset_by_name(
+                project_name, selected_asset, fields=["_id"]
             )
             subset_docs = list(get_subsets(
                 project_name,
@@ -1189,7 +1189,7 @@ class SwitchAssetDialog(QtWidgets.QDialog):
 
         project_name = self.active_project()
         if selected_asset:
-            asset_doc = get_asset(project_name, asset_name=selected_asset)
+            asset_doc = get_asset_by_name(project_name, selected_asset)
             asset_docs_by_id = {asset_doc["_id"]: asset_doc}
         else:
             asset_docs_by_id = self.content_assets
diff --git a/openpype/tools/sceneinventory/view.py b/openpype/tools/sceneinventory/view.py
index 6a95ccb57b..04e0f67a15 100644
--- a/openpype/tools/sceneinventory/view.py
+++ b/openpype/tools/sceneinventory/view.py
@@ -657,11 +657,9 @@ class SceneInventoryView(QtWidgets.QTreeView):
 
         project_name = legacy_io.active_project()
         # Get available versions for active representation
-        representation_id = ObjectId(active["representation"])
-
         repre_doc = get_representation(
             project_name,
-            representation_id=representation_id,
+            representation_id=active["representation"],
             fields=["parent"]
         )
 
diff --git a/openpype/tools/standalonepublish/app.py b/openpype/tools/standalonepublish/app.py
index 4831db038c..3ceeb3ad48 100644
--- a/openpype/tools/standalonepublish/app.py
+++ b/openpype/tools/standalonepublish/app.py
@@ -6,7 +6,7 @@ import signal
 from bson.objectid import ObjectId
 from Qt import QtWidgets, QtCore, QtGui
 
-from openpype.client import get_asset
+from openpype.client import get_asset_by_id
 
 from .widgets import (
     AssetWidget, FamilyWidget, ComponentsWidget, ShadowWidget
@@ -144,8 +144,8 @@ class Window(QtWidgets.QDialog):
         if len(selected) == 1:
             self.valid_parent = True
             project_name = self.db.active_project()
-            asset = get_asset(
-                project_name, asset_id=selected[0], fields=["name"]
+            asset = get_asset_by_id(
+                project_name, selected[0], fields=["name"]
             )
             self.widget_family.change_asset(asset['name'])
         else:
diff --git a/openpype/tools/standalonepublish/widgets/widget_asset.py b/openpype/tools/standalonepublish/widgets/widget_asset.py
index 0b5802ed9e..73114f7960 100644
--- a/openpype/tools/standalonepublish/widgets/widget_asset.py
+++ b/openpype/tools/standalonepublish/widgets/widget_asset.py
@@ -4,7 +4,7 @@ import qtawesome
 
 from openpype.client import (
     get_project,
-    get_asset,
+    get_asset_by_id,
 )
 from openpype.tools.utils import PlaceholderLineEdit
 
@@ -251,9 +251,9 @@ class AssetWidget(QtWidgets.QWidget):
             return output
 
         project_name = self.dbcon.active_project()
-        parent = get_asset(
+        parent = get_asset_by_id(
             project_name,
-            asset_id=parent_asset_id,
+            parent_asset_id,
             fields=["name", "data.visualParent"]
         )
         output.append(parent['name'])
@@ -362,8 +362,8 @@ class AssetWidget(QtWidgets.QWidget):
         selected = self.get_selected_assets()
         if len(selected) == 1:
             project_name = self.dbcon.active_project()
-            asset = get_asset(
-                project_name, asset_id=selected[0], fields=["data.tasks"]
+            asset = get_asset_by_id(
+                project_name, selected[0], fields=["data.tasks"]
             )
             if asset:
                 tasks = asset.get('data', {}).get('tasks', [])
diff --git a/openpype/tools/standalonepublish/widgets/widget_family.py b/openpype/tools/standalonepublish/widgets/widget_family.py
index ed9f405f38..fa157d37f1 100644
--- a/openpype/tools/standalonepublish/widgets/widget_family.py
+++ b/openpype/tools/standalonepublish/widgets/widget_family.py
@@ -3,7 +3,7 @@ import re
 from Qt import QtWidgets, QtCore
 
 from openpype.client import (
-    get_asset,
+    get_asset_by_name,
     get_subset,
     get_subsets,
     get_last_version_for_subset,
@@ -188,8 +188,8 @@ class FamilyWidget(QtWidgets.QWidget):
         if asset_name != self.NOT_SELECTED:
             # Get the assets from the database which match with the name
             project_name = self.dbcon.active_project()
-            asset_doc = get_asset(
-                project_name, asset_name=asset_name, fields=["_id"]
+            asset_doc = get_asset_by_name(
+                project_name, asset_name, fields=["_id"]
             )
 
         # Get plugin and family
@@ -205,8 +205,8 @@ class FamilyWidget(QtWidgets.QWidget):
 
         # Get the asset from the database which match with the name
         project_name = self.dbcon.active_project()
-        asset_doc = get_asset(
-            project_name, asset_name=asset_name, fields=["_id"]
+        asset_doc = get_asset_by_name(
+            project_name, asset_name, fields=["_id"]
         )
         # Get plugin
         plugin = item.data(PluginRole)
@@ -310,8 +310,8 @@ class FamilyWidget(QtWidgets.QWidget):
             asset_name != self.NOT_SELECTED and
             subset_name.strip() != ''
         ):
-            asset_doc = get_asset(
-                project_name, asset_name=asset_name, fields=["_id"]
+            asset_doc = get_asset_by_name(
+                project_name, asset_name, fields=["_id"]
             )
 
         if asset_doc:
diff --git a/openpype/tools/texture_copy/app.py b/openpype/tools/texture_copy/app.py
index 8703f075d3..746a72b3ec 100644
--- a/openpype/tools/texture_copy/app.py
+++ b/openpype/tools/texture_copy/app.py
@@ -4,7 +4,7 @@ import click
 
 import speedcopy
 
-from openpype.client import get_project, get_asset
+from openpype.client import get_project, get_asset_by_name
 from openpype.lib import Terminal
 from openpype.api import Anatomy
 from openpype.pipeline import legacy_io
@@ -94,7 +94,7 @@ class TextureCopy:
             t.echo("!!! Project name [ {} ] not found.".format(project_name))
             exit(1)
 
-        asset = get_asset(project_name, asset_name=asset_name)
+        asset = get_asset_by_name(project_name, asset_name)
         if not asset:
             t.echo("!!! Asset [ {} ] not found in project".format(asset_name))
             exit(1)
diff --git a/openpype/tools/utils/lib.py b/openpype/tools/utils/lib.py
index 72ebfcc063..ea1362945f 100644
--- a/openpype/tools/utils/lib.py
+++ b/openpype/tools/utils/lib.py
@@ -8,7 +8,7 @@ import qtawesome
 
 from openpype.client import (
     get_project,
-    get_asset,
+    get_asset_by_name,
 )
 from openpype.style import (
     get_default_entity_icon_color,
@@ -434,8 +434,8 @@ class FamilyConfigCache:
             database = getattr(self.dbcon, "database", None)
             if database is None:
                 database = self.dbcon._database
-            asset_doc = get_asset(
-                project_name, asset_name=asset_name, fields=["data.tasks"]
+            asset_doc = get_asset_by_name(
+                project_name, asset_name, fields=["data.tasks"]
             ) or {}
             tasks_info = asset_doc.get("data", {}).get("tasks") or {}
             task_type = tasks_info.get(task_name, {}).get("type")
diff --git a/openpype/tools/utils/tasks_widget.py b/openpype/tools/utils/tasks_widget.py
index fcbec318f5..0353f3dd2f 100644
--- a/openpype/tools/utils/tasks_widget.py
+++ b/openpype/tools/utils/tasks_widget.py
@@ -3,7 +3,7 @@ import qtawesome
 
 from openpype.client import (
     get_project,
-    get_asset,
+    get_asset_by_id,
 )
 from openpype.style import get_disabled_entity_icon_color
 from openpype.tools.utils.lib import get_task_icon
@@ -77,8 +77,8 @@ class TasksModel(QtGui.QStandardItemModel):
         asset_doc = None
         if self._context_is_valid():
             project_name = self._get_current_project()
-            asset_doc = get_asset(
-                project_name, asset_id=asset_id, fields=["data.tasks"]
+            asset_doc = get_asset_by_id(
+                project_name, asset_id, fields=["data.tasks"]
             )
         self._set_asset(asset_doc)
 
diff --git a/openpype/tools/workfiles/files_widget.py b/openpype/tools/workfiles/files_widget.py
index 36b9a055d8..68fe8301c9 100644
--- a/openpype/tools/workfiles/files_widget.py
+++ b/openpype/tools/workfiles/files_widget.py
@@ -5,7 +5,7 @@ import shutil
 import Qt
 from Qt import QtWidgets, QtCore
 
-from openpype.client import get_asset
+from openpype.client import get_asset_by_id
 from openpype.tools.utils import PlaceholderLineEdit
 from openpype.tools.utils.delegates import PrettyTimeDelegate
 from openpype.lib import (
@@ -386,7 +386,7 @@ class FilesWidget(QtWidgets.QWidget):
 
         if self._asset_doc is None:
             project_name = legacy_io.active_project()
-            self._asset_doc = get_asset(project_name, asset_id=self._asset_id)
+            self._asset_doc = get_asset_by_id(project_name, self._asset_id)
 
         return self._asset_doc
 
diff --git a/openpype/tools/workfiles/save_as_dialog.py b/openpype/tools/workfiles/save_as_dialog.py
index 1fbcbfeb22..b62fd2c889 100644
--- a/openpype/tools/workfiles/save_as_dialog.py
+++ b/openpype/tools/workfiles/save_as_dialog.py
@@ -7,7 +7,7 @@ from Qt import QtWidgets, QtCore
 
 from openpype.client import (
     get_project,
-    get_asset,
+    get_asset_by_name,
 )
 from openpype.lib import (
     get_last_workfile_with_version,
@@ -33,9 +33,9 @@ def build_workfile_data(session):
     project_doc = get_project(
         project_name, fields=["name", "data.code", "config.tasks"]
     )
-    asset_doc = get_asset(
+    asset_doc = get_asset_by_name(
         project_name,
-        asset_name=asset_name,
+        asset_name,
         fields=["name", "data.tasks", "data.parents"]
     )
 
diff --git a/openpype/tools/workfiles/window.py b/openpype/tools/workfiles/window.py
index 45d8d41d16..9f4cea2f8a 100644
--- a/openpype/tools/workfiles/window.py
+++ b/openpype/tools/workfiles/window.py
@@ -2,7 +2,7 @@ import os
 import datetime
 from Qt import QtCore, QtWidgets
 
-from openpype.client import get_asset
+from openpype.client import get_asset_by_id, get_asset_by_name
 from openpype import style
 from openpype.lib import (
     get_workfile_doc,
@@ -302,7 +302,7 @@ class Window(QtWidgets.QMainWindow):
             workdir, filename = os.path.split(filepath)
             asset_id = self.assets_widget.get_selected_asset_id()
             project_name = legacy_io.active_project()
-            asset_doc = get_asset(project_name, asset_id=asset_id)
+            asset_doc = get_asset_by_id(project_name, asset_id)
             task_name = self.tasks_widget.get_selected_task_name()
             create_workfile_doc(
                 asset_doc, task_name, filename, workdir, legacy_io
@@ -328,7 +328,7 @@ class Window(QtWidgets.QMainWindow):
 
         self._context_to_set, context = None, self._context_to_set
         if "asset" in context:
-            asset_doc = get_asset(
+            asset_doc = get_asset_by_name(
                 self.project_name, context["asset"], fields=["_id"]
             )
 

From 20ecefa4aae7918fb6a0dbdd5d3de141249eb69d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 16:43:07 +0200
Subject: [PATCH 0488/1227] added docstrings for asset queries

---
 openpype/client/entities.py | 37 +++++++++++++++++++++++++++++++++++--
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 97553f30fe..16dc3d76a9 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -94,8 +94,10 @@ def get_asset_by_id(project_name, asset_id, fields=None):
     """Receive asset data by it's id.
 
     Args:
-        project_name (str): Name of project where to look for subset.
+        project_name (str): Name of project where to look for queried entities.
         asset_id (str|ObjectId): Asset's id.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
 
     Returns:
         dict: Asset entity data.
@@ -115,8 +117,10 @@ def get_asset_by_name(project_name, asset_name, fields=None):
     """Receive asset data by it's name.
 
     Args:
-        project_name (str): Name of project where to look for subset.
+        project_name (str): Name of project where to look for queried entities.
         asset_name (str): Asset's name.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
 
     Returns:
         dict: Asset entity data.
@@ -134,6 +138,25 @@ def get_asset_by_name(project_name, asset_name, fields=None):
 def get_assets(
     project_name, asset_ids=None, asset_names=None, archived=False, fields=None
 ):
+    """Assets for specified project by passed filters.
+
+    Passed filters (ids and names) are always combined so all conditions must
+    match.
+
+    To receive all assets from project just keep filters empty.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        asset_ids (list[str, ObjectId]): Asset ids that should be found.
+        asset_names (list[str]): Name assets that should be found.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        Cursor: Query cursor as iterable which returns asset documents matching
+            passed filters.
+    """
+
     asset_types = ["asset"]
     if archived:
         asset_types.append("archived_asset")
@@ -160,6 +183,16 @@ def get_assets(
 
 
 def get_asset_ids_with_subsets(project_name, asset_ids=None):
+    """Find out which assets have existing subsets.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        asset_ids (list[str|ObjectId]): Look only for entered asset ids.
+
+    Returns:
+        List[ObjectId]: Asset ids that have existing subsets.
+    """
+
     subset_query = {
         "type": "subset"
     }

From 9456dac8b92862120f580bfbd59327b83a78fd4c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 16:44:26 +0200
Subject: [PATCH 0489/1227] separated function get_subset into 2 separated
 functions

---
 openpype/client/__init__.py                   |  6 +-
 openpype/client/entities.py                   | 73 ++++++++++---------
 openpype/tools/loader/widgets.py              |  4 +-
 openpype/tools/sceneinventory/model.py        |  4 +-
 .../tools/sceneinventory/switch_dialog.py     | 26 +++----
 .../widgets/widget_family.py                  |  8 +-
 6 files changed, 63 insertions(+), 58 deletions(-)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index 2ba2a3693e..34257cf3dc 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -7,7 +7,8 @@ from .entities import (
     get_assets,
     get_asset_ids_with_subsets,
 
-    get_subset,
+    get_subset_by_id,
+    get_subset_by_name,
     get_subsets,
     get_subset_families,
 
@@ -39,7 +40,8 @@ __all__ = (
     "get_assets",
     "get_asset_ids_with_subsets",
 
-    "get_subset",
+    "get_subset_by_id",
+    "get_subset_by_name",
     "get_subsets",
     "get_subset_families",
 
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 16dc3d76a9..07f6bb2e65 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -223,29 +223,13 @@ def get_asset_ids_with_subsets(project_name, asset_ids=None):
     return asset_ids_with_subsets
 
 
-def get_subset(
-    project_name,
-    subset_id=None,
-    subset_name=None,
-    asset_id=None,
-    fields=None
-):
-    """Single subset document by subset id or name and parent id.
-
-    When subset id is defined it is not needed to add any other arguments but
-    subset name filter must be always combined with asset id (or subset id).
-
-    Question:
-        This could be split into more functions?
+def get_subset_by_id(project_name, subset_id, fields=None):
+    """Single subset document by it's id.
 
     Args:
-        project_name (str): Name of project where to look for subset.
+        project_name (str): Name of project where to look for queried entities.
         subset_id (ObjectId): Id of subset which should be found.
-        subset_name (str): Name of asset. Must be combined with 'asset_id' or
-            'subset_id' arguments otherwise result is 'None'.
-        asset_id (ObjectId): Id of parent asset. Must be combined with
-            'subset_name' or 'subset_id'.
-        fields (list<str>): Fields that should be returned. All fields are
+        fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -253,23 +237,42 @@ def get_subset(
         Dict: Subset document which can be reduced to specified 'fields'.
     """
 
-    query_filters = {"type": "subset"}
-    has_valid_filters = False
-    if subset_id is not None:
-        query_filters["_id"] = _convert_id(asset_id)
-        has_valid_filters = True
-
-    if subset_name is not None:
-        if asset_id is not None:
-            has_valid_filters = True
-        query_filters["name"] = subset_name
-
-    if asset_id is not None:
-        query_filters["parent"] = _convert_id(asset_id)
-
-    if not has_valid_filters:
+    subset_id = _convert_id(subset_id)
+    if not subset_id:
         return None
 
+    query_filters = {"type": "subset", "_id": subset_id}
+    conn = _get_project_connection(project_name)
+    return conn.find_one(query_filters, _prepare_fields(fields))
+
+
+def get_subset_by_name(project_name, subset_name, asset_id, fields=None):
+    """Single subset document by subset name and it's version id.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        subset_name (str): Name of subset.
+        asset_id (str|ObjectId): Id of parent asset.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        None: If subset with specified filters was not found.
+        Dict: Subset document which can be reduced to specified 'fields'.
+    """
+
+    if not subset_name:
+        return None
+
+    asset_id = _convert_id(asset_id)
+    if not asset_id:
+        return None
+
+    query_filters = {
+        "type": "subset",
+        "name": subset_name,
+        "parent": asset_id
+    }
     conn = _get_project_connection(project_name)
     return conn.find_one(query_filters, _prepare_fields(fields))
 
diff --git a/openpype/tools/loader/widgets.py b/openpype/tools/loader/widgets.py
index 6c7acc593d..4a9a911f93 100644
--- a/openpype/tools/loader/widgets.py
+++ b/openpype/tools/loader/widgets.py
@@ -9,7 +9,7 @@ from Qt import QtWidgets, QtCore, QtGui
 
 from openpype.client import (
     get_subset_families,
-    get_subset,
+    get_subset_by_id,
     get_subsets,
     get_version,
     get_versions,
@@ -688,7 +688,7 @@ class VersionTextEdit(QtWidgets.QTextEdit):
                 _version_doc["name"]
             )
 
-        subset = get_subset(project_name, subset_id=version_doc["parent"])
+        subset = get_subset_by_id(project_name, version_doc["parent"])
         assert subset, "No valid subset parent for version"
 
         # Define readable creation timestamp
diff --git a/openpype/tools/sceneinventory/model.py b/openpype/tools/sceneinventory/model.py
index 6d813af45b..b36f7f4cea 100644
--- a/openpype/tools/sceneinventory/model.py
+++ b/openpype/tools/sceneinventory/model.py
@@ -8,7 +8,7 @@ import qtawesome
 
 from openpype.client import (
     get_asset_by_id,
-    get_subset,
+    get_subset_by_id,
     get_version,
     get_last_version_for_subset,
     get_representation,
@@ -336,7 +336,7 @@ class InventoryModel(TreeModel):
                 version["name"] = HeroVersionType(_version["name"])
                 version["data"] = _version["data"]
 
-            subset = get_subset(project_name, subset_id=version["parent"])
+            subset = get_subset_by_id(project_name, version["parent"])
             if not subset:
                 not_found["subset"].append(group_items)
                 not_found_ids.append(repre_id)
diff --git a/openpype/tools/sceneinventory/switch_dialog.py b/openpype/tools/sceneinventory/switch_dialog.py
index 6d6294af6f..92ef2b3553 100644
--- a/openpype/tools/sceneinventory/switch_dialog.py
+++ b/openpype/tools/sceneinventory/switch_dialog.py
@@ -7,7 +7,7 @@ from bson.objectid import ObjectId
 from openpype.client import (
     get_asset_by_name,
     get_assets,
-    get_subset,
+    get_subset_by_name,
     get_subsets,
     get_versions,
     get_hero_versions,
@@ -537,10 +537,10 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         self, asset_doc, selected_subset, selected_repre
     ):
         project_name = self.active_project()
-        subset_doc = get_subset(
+        subset_doc = get_subset_by_name(
             project_name,
-            subset_name=selected_subset,
-            asset_id=asset_doc["_id"],
+            selected_subset,
+            asset_doc["_id"],
             fields=["_id"]
         )
 
@@ -560,10 +560,10 @@ class SwitchAssetDialog(QtWidgets.QDialog):
 
     def _get_current_output_repre_ids_xxo(self, asset_doc, selected_subset):
         project_name = self.active_project()
-        subset_doc = get_subset(
+        subset_doc = get_subset_by_name(
             project_name,
-            asset_id=asset_doc["_id"],
-            subset_name=selected_subset,
+            selected_subset,
+            asset_doc["_id"],
             fields=["_id"]
         )
         if not subset_doc:
@@ -835,10 +835,10 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             asset_doc = get_asset_by_name(
                 project_name, selected_asset, fields=["_id"]
             )
-            subset_doc = get_subset(
+            subset_doc = get_subset_by_name(
                 project_name,
-                asset_id=asset_doc["_id"],
-                subset_name=selected_subset,
+                selected_subset,
+                asset_doc["_id"],
                 fields=["_id"]
             )
 
@@ -1046,10 +1046,10 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             asset_doc = get_asset_by_name(
                 project_name, selected_asset, fields=["_id"]
             )
-            subset_doc = get_subset(
+            subset_doc = get_subset_by_name(
                 project_name,
-                asset_id=asset_doc["_id"],
-                subset_name=selected_subset,
+                selected_subset,
+                asset_doc["_id"],
                 fields=["_id"]
             )
             subset_id = subset_doc["_id"]
diff --git a/openpype/tools/standalonepublish/widgets/widget_family.py b/openpype/tools/standalonepublish/widgets/widget_family.py
index fa157d37f1..2f00cfe7bb 100644
--- a/openpype/tools/standalonepublish/widgets/widget_family.py
+++ b/openpype/tools/standalonepublish/widgets/widget_family.py
@@ -4,7 +4,7 @@ from Qt import QtWidgets, QtCore
 
 from openpype.client import (
     get_asset_by_name,
-    get_subset,
+    get_subset_by_name,
     get_subsets,
     get_last_version_for_subset,
 )
@@ -315,10 +315,10 @@ class FamilyWidget(QtWidgets.QWidget):
             )
 
         if asset_doc:
-            subset_doc = get_subset(
+            subset_doc = get_subset_by_name(
                 project_name,
-                subset_name=subset_name,
-                asset_id=asset_doc['_id'],
+                subset_name,
+                asset_doc['_id'],
                 fields=["_id"]
             )
 

From 0d5cc529d502cdf2a421be4f7db27dcbd54eb9ff Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 17:18:21 +0200
Subject: [PATCH 0490/1227] renamed 'get_version' to 'get_version_by_id'

---
 openpype/client/__init__.py            |   4 +-
 openpype/client/entities.py            | 107 ++++++++++++++++++++++---
 openpype/tools/loader/widgets.py       |   8 +-
 openpype/tools/sceneinventory/model.py |  10 +--
 openpype/tools/sceneinventory/view.py  |   6 +-
 5 files changed, 108 insertions(+), 27 deletions(-)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index 34257cf3dc..e8e3a81d5d 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -12,8 +12,8 @@ from .entities import (
     get_subsets,
     get_subset_families,
 
+    get_version_by_id,
     get_version_by_name,
-    get_version,
     get_versions,
     get_last_versions,
     get_last_version_for_subset,
@@ -45,8 +45,8 @@ __all__ = (
     "get_subsets",
     "get_subset_families",
 
+    "get_version_by_id",
     "get_version_by_name",
-    "get_version",
     "get_versions",
     "get_last_versions",
     "get_last_version_for_subset",
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 07f6bb2e65..1a45be6e93 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -224,7 +224,7 @@ def get_asset_ids_with_subsets(project_name, asset_ids=None):
 
 
 def get_subset_by_id(project_name, subset_id, fields=None):
-    """Single subset document by it's id.
+    """Single subset entity data by it's id.
 
     Args:
         project_name (str): Name of project where to look for queried entities.
@@ -247,7 +247,7 @@ def get_subset_by_id(project_name, subset_id, fields=None):
 
 
 def get_subset_by_name(project_name, subset_name, asset_id, fields=None):
-    """Single subset document by subset name and it's version id.
+    """Single subset entity data by it's name and it's version id.
 
     Args:
         project_name (str): Name of project where to look for queried entities.
@@ -279,12 +279,31 @@ def get_subset_by_name(project_name, subset_name, asset_id, fields=None):
 
 def get_subsets(
     project_name,
-    asset_ids=None,
     subset_ids=None,
     subset_names=None,
+    asset_ids=None,
     archived=False,
     fields=None
 ):
+    """Subset entities data from one project filtered by entered filters.
+
+    Filters are additive (all conditions must pass to return subset).
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        subset_ids (list[str, ObjectId]): Subset ids that should be queried.
+            Filter ignored if 'None' is passed.
+        subset_names (list[str]): Subset names that should be queried.
+            Filter ignored if 'None' is passed.
+        asset_ids (list[str, ObjectId]): Asset ids under which should look for
+            the subsets. Filter ignored if 'None' is passed.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        Cursor: Iterable cursor yielding all matching subsets.
+    """
+
     subset_types = ["subset"]
     if archived:
         subset_types.append("archived_subset")
@@ -316,6 +335,17 @@ def get_subsets(
 
 
 def get_subset_families(project_name, subset_ids=None):
+    """Set of main families of subsets.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        subset_ids (list[str, ObjectId]): Subset ids that should be queried.
+            All subsets from project are used if 'None' is passed.
+
+    Returns:
+         set[str]: Main families of matching subsets.
+    """
+
     subset_filter = {
         "type": "subset"
     }
@@ -340,23 +370,56 @@ def get_subset_families(project_name, subset_ids=None):
     return set()
 
 
-def get_version_by_name(project_name, subset_id, version, fields=None):
-    conn = _get_project_connection(project_name)
+def get_version_by_id(project_name, version_id, fields=None):
+    """Single version entity data by it's id.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        version_id (ObjectId): Id of version which should be found.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        None: If version with specified filters was not found.
+        Dict: Version document which can be reduced to specified 'fields'.
+    """
+
+    version_id = _convert_id(version_id)
+    if not version_id:
+        return None
+
     query_filter = {
-        "type": "version",
-        "parent": _convert_id(subset_id),
-        "name": version
+        "type": {"$in": ["version", "hero_version"]},
+        "_id": version_id
     }
+    conn = _get_project_connection(project_name)
     return conn.find_one(query_filter, _prepare_fields(fields))
 
 
-def get_version(project_name, version_id, fields=None):
-    if not version_id:
+def get_version_by_name(project_name, version, subset_id, fields=None):
+    """Single version entity data by it's name and subset id.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        version (int): name of version entity (it's version).
+        subset_id (ObjectId): Id of version which should be found.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        None: If version with specified filters was not found.
+        Dict: Version document which can be reduced to specified 'fields'.
+    """
+
+    subset_id = _convert_id(subset_id)
+    if not subset_id:
         return None
+
     conn = _get_project_connection(project_name)
     query_filter = {
-        "type": {"$in": ["version", "hero_version"]},
-        "_id": _convert_id(version_id)
+        "type": "version",
+        "parent": subset_id,
+        "name": version
     }
     return conn.find_one(query_filter, _prepare_fields(fields))
 
@@ -402,11 +465,29 @@ def _get_versions(
 
 def get_versions(
     project_name,
-    subset_ids=None,
     version_ids=None,
+    subset_ids=None,
     hero=False,
     fields=None
 ):
+    """Version entities data from one project filtered by entered filters.
+
+    Filters are additive (all conditions must pass to return subset).
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        version_ids (list[str, ObjectId]): Version ids that will be queried.
+            Filter ignored if 'None' is passed.
+        subset_ids (list[str]): Subset ids that will be queried.
+            Filter ignored if 'None' is passed.
+        hero (bool): Look also for hero versions.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        Cursor: Iterable cursor yielding all matching versions.
+    """
+
     return _get_versions(
         project_name,
         subset_ids,
diff --git a/openpype/tools/loader/widgets.py b/openpype/tools/loader/widgets.py
index 4a9a911f93..921708922e 100644
--- a/openpype/tools/loader/widgets.py
+++ b/openpype/tools/loader/widgets.py
@@ -11,7 +11,7 @@ from openpype.client import (
     get_subset_families,
     get_subset_by_id,
     get_subsets,
-    get_version,
+    get_version_by_id,
     get_versions,
     get_representations,
     get_thumbnail_id_from_source,
@@ -676,12 +676,12 @@ class VersionTextEdit(QtWidgets.QTextEdit):
 
         project_name = self.dbcon.active_project()
         if not version_doc:
-            version_doc = get_version(project_name, version_id=version_id)
+            version_doc = get_version_by_id(project_name, version_id)
             assert version_doc, "Not a valid version id"
 
         if version_doc["type"] == "hero_version":
-            _version_doc = get_version(
-                project_name, version_id=version_doc["version_id"]
+            _version_doc = get_version_by_id(
+                project_name, version_doc["version_id"]
             )
             version_doc["data"] = _version_doc["data"]
             version_doc["name"] = HeroVersionType(
diff --git a/openpype/tools/sceneinventory/model.py b/openpype/tools/sceneinventory/model.py
index b36f7f4cea..a5d856fe72 100644
--- a/openpype/tools/sceneinventory/model.py
+++ b/openpype/tools/sceneinventory/model.py
@@ -9,7 +9,7 @@ import qtawesome
 from openpype.client import (
     get_asset_by_id,
     get_subset_by_id,
-    get_version,
+    get_version_by_id,
     get_last_version_for_subset,
     get_representation,
 )
@@ -321,8 +321,8 @@ class InventoryModel(TreeModel):
                 not_found_ids.append(repre_id)
                 continue
 
-            version = get_version(
-                project_name, version_id=representation["parent"]
+            version = get_version_by_id(
+                project_name, representation["parent"]
             )
             if not version:
                 not_found["version"].append(group_items)
@@ -330,8 +330,8 @@ class InventoryModel(TreeModel):
                 continue
 
             elif version["type"] == "hero_version":
-                _version = get_version(
-                    project_name, version_id=version["version_id"]
+                _version = get_version_by_id(
+                    project_name, version["version_id"]
                 )
                 version["name"] = HeroVersionType(_version["name"])
                 version["data"] = _version["data"]
diff --git a/openpype/tools/sceneinventory/view.py b/openpype/tools/sceneinventory/view.py
index 04e0f67a15..d1ff91535f 100644
--- a/openpype/tools/sceneinventory/view.py
+++ b/openpype/tools/sceneinventory/view.py
@@ -7,7 +7,7 @@ import qtawesome
 from bson.objectid import ObjectId
 
 from openpype.client import (
-    get_version,
+    get_version_by_id,
     get_versions,
     get_hero_versions,
     get_representation,
@@ -663,9 +663,9 @@ class SceneInventoryView(QtWidgets.QTreeView):
             fields=["parent"]
         )
 
-        repre_version_doc = get_version(
+        repre_version_doc = get_version_by_id(
             project_name,
-            version_id=repre_doc["parent"],
+            repre_doc["parent"],
             fields=["parent"]
         )
 

From 0f95a66359c693382af236e4d695764ecbfb7f14 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 17:43:44 +0200
Subject: [PATCH 0491/1227] renamed get_version_links to
 get_output_link_versions

---
 openpype/client/__init__.py          |  4 ++--
 openpype/client/entities.py          | 26 ++++++++++++++++++++++++--
 openpype/tools/assetlinks/widgets.py |  4 ++--
 3 files changed, 28 insertions(+), 6 deletions(-)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index e8e3a81d5d..7230a7c153 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -19,7 +19,7 @@ from .entities import (
     get_last_version_for_subset,
     get_hero_version,
     get_hero_versions,
-    get_version_links,
+    get_output_link_versions,
 
     get_representation,
     get_representation_by_name,
@@ -52,7 +52,7 @@ __all__ = (
     "get_last_version_for_subset",
     "get_hero_version",
     "get_hero_versions",
-    "get_version_links",
+    "get_output_link_versions",
 
     "get_representation",
     "get_representation_by_name",
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 1a45be6e93..0eb0367452 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -544,12 +544,34 @@ def get_hero_versions(
     )
 
 
-def get_version_links(project_name, version_id, fields=None):
+def get_output_link_versions(project_name, version_id, fields=None):
+    """Versions where passed version was used as input.
+
+    Question:
+        Not 100% sure about the usage of the function so the name and docstring
+            maybe does not match what it does?
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        version_id (str|ObjectId): Version id which can be used as input link
+            for other versions.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        Cursor|list: Iterable cursor yielding versions that are used as input
+            links for passed version.
+    """
+
+    version_id = _convert_id(version_id)
+    if not version_id:
+        return []
+
     conn = _get_project_connection(project_name)
     # Does make sense to look for hero versions?
     query_filter = {
         "type": "version",
-        "data.inputLinks.input": _convert_id(version_id)
+        "data.inputLinks.input": version_id
     }
     return conn.find(query_filter, _prepare_fields(fields))
 
diff --git a/openpype/tools/assetlinks/widgets.py b/openpype/tools/assetlinks/widgets.py
index 5ce2a835ef..3078585ed1 100644
--- a/openpype/tools/assetlinks/widgets.py
+++ b/openpype/tools/assetlinks/widgets.py
@@ -3,7 +3,7 @@ from openpype.client import (
     get_versions,
     get_subsets,
     get_assets,
-    get_version_links,
+    get_output_link_versions,
 )
 
 from Qt import QtWidgets
@@ -112,7 +112,7 @@ class SimpleLinkView(QtWidgets.QWidget):
                     ))
 
     def _fill_outputs(self, version_doc):
-        version_docs = list(get_version_links(
+        version_docs = list(get_output_link_versions(
             self.project_name,
             version_doc["_id"],
             fields=["name", "parent"]

From 675da63f8ccb862797c298ba9acd6a57b7f7e1e6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 18:04:04 +0200
Subject: [PATCH 0492/1227] split 'get_hero_version' to
 'get_hero_version_by_id' and 'get_hero_version_by_subset_id'

---
 openpype/client/__init__.py | 10 +++--
 openpype/client/entities.py | 79 +++++++++++++++++++++++++++++--------
 2 files changed, 68 insertions(+), 21 deletions(-)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index 7230a7c153..4f8b948c93 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -15,10 +15,11 @@ from .entities import (
     get_version_by_id,
     get_version_by_name,
     get_versions,
+    get_hero_version_by_id,
+    get_hero_version_by_subset_id,
+    get_hero_versions,
     get_last_versions,
     get_last_version_for_subset,
-    get_hero_version,
-    get_hero_versions,
     get_output_link_versions,
 
     get_representation,
@@ -48,10 +49,11 @@ __all__ = (
     "get_version_by_id",
     "get_version_by_name",
     "get_versions",
+    "get_hero_version_by_id",
+    "get_hero_version_by_subset_id",
+    "get_hero_versions",
     "get_last_versions",
     "get_last_version_for_subset",
-    "get_hero_version",
-    "get_hero_versions",
     "get_output_link_versions",
 
     "get_representation",
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 0eb0367452..bf033e7c81 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -498,27 +498,57 @@ def get_versions(
     )
 
 
-def get_hero_version(
-    project_name,
-    subset_id=None,
-    version_id=None,
-    fields=None
-):
-    if not subset_id and not version_id:
+def get_hero_version_by_subset_id(project_name, subset_id, fields=None):
+    """Hero version by subset id.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        subset_id (str|ObjectId): Subset id under which is hero version.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        None: If hero version for passed subset id does not exists.
+        Dict: Hero version entity data.
+    """
+
+    subset_id = _convert_id(subset_id)
+    if not subset_id:
         return None
 
-    subset_ids = None
-    if subset_id is not None:
-        subset_ids = [subset_id]
-
-    version_ids = None
-    if version_id is not None:
-        version_ids = [version_id]
-
     versions = list(_get_versions(
         project_name,
-        subset_ids=subset_ids,
-        version_ids=version_ids,
+        subset_ids=[subset_id],
+        standard=False,
+        hero=True,
+        fields=fields
+    ))
+    if versions:
+        return versions[0]
+    return None
+
+
+def get_hero_version_by_id(project_name, version_id, fields=None):
+    """Hero version by it's id.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        version_id (str|ObjectId): Hero version id.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        None: If hero version with passed id was not found.
+        Dict: Hero version entity data.
+    """
+
+    version_id = _convert_id(version_id)
+    if not version_id:
+        return None
+
+    versions = list(_get_versions(
+        project_name,
+        version_ids=[version_id],
         standard=False,
         hero=True,
         fields=fields
@@ -534,6 +564,21 @@ def get_hero_versions(
     version_ids=None,
     fields=None
 ):
+    """Hero version entities data from one project filtered by entered filters.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        subset_ids (list[str|ObjectId]): Subset ids for which should look for
+            hero versions. Filter ignored if 'None' is passed.
+        version_ids (list[str|ObjectId]): Hero version ids. Filter ignored if
+            'None' is passed.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        Cursor|list: Iterable yielding hero versions matching passed filters.
+    """
+
     return _get_versions(
         project_name,
         subset_ids,

From ba6ef6d2ae035361d0a7282983555990c322cc7c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 18:23:44 +0200
Subject: [PATCH 0493/1227] split 'get_last_version_for_subset' into
 'get_last_version_by_subset_id' and 'get_last_version_by_subset_name'

---
 openpype/client/__init__.py                   |  6 +-
 openpype/client/entities.py                   | 81 ++++++++++++-------
 openpype/tools/mayalookassigner/app.py        |  6 +-
 .../tools/mayalookassigner/vray_proxies.py    |  4 +-
 openpype/tools/sceneinventory/model.py        |  6 +-
 .../widgets/widget_family.py                  |  6 +-
 6 files changed, 65 insertions(+), 44 deletions(-)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index 4f8b948c93..2ef32d6a83 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -19,7 +19,8 @@ from .entities import (
     get_hero_version_by_subset_id,
     get_hero_versions,
     get_last_versions,
-    get_last_version_for_subset,
+    get_last_version_by_subset_id,
+    get_last_version_by_subset_name,
     get_output_link_versions,
 
     get_representation,
@@ -53,7 +54,8 @@ __all__ = (
     "get_hero_version_by_subset_id",
     "get_hero_versions",
     "get_last_versions",
-    "get_last_version_for_subset",
+    "get_last_version_by_subset_id",
+    "get_last_version_by_subset_name",
     "get_output_link_versions",
 
     "get_representation",
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index bf033e7c81..232d9aebcc 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -228,7 +228,7 @@ def get_subset_by_id(project_name, subset_id, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        subset_id (ObjectId): Id of subset which should be found.
+        subset_id (str|ObjectId): Id of subset which should be found.
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
@@ -375,7 +375,7 @@ def get_version_by_id(project_name, version_id, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        version_id (ObjectId): Id of version which should be found.
+        version_id (str|ObjectId): Id of version which should be found.
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
@@ -402,7 +402,7 @@ def get_version_by_name(project_name, version, subset_id, fields=None):
     Args:
         project_name (str): Name of project where to look for queried entities.
         version (int): name of version entity (it's version).
-        subset_id (ObjectId): Id of version which should be found.
+        subset_id (str|ObjectId): Id of version which should be found.
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
@@ -622,13 +622,13 @@ def get_output_link_versions(project_name, version_id, fields=None):
 
 
 def get_last_versions(project_name, subset_ids, fields=None):
-    """Retrieve all latest versions for entered subset_ids.
+    """Latest versions for entered subset_ids.
 
     Args:
         subset_ids (list): List of subset ids.
 
     Returns:
-        dict: Key is subset id and value is last version name.
+        dict[ObjectId, int]: Key is subset id and value is last version name.
     """
 
     subset_ids = _convert_ids(subset_ids)
@@ -665,35 +665,60 @@ def get_last_versions(project_name, subset_ids, fields=None):
     }
 
 
-def get_last_version_for_subset(
-    project_name, subset_id=None, subset_name=None, asset_id=None, fields=None
-):
-    subset_doc = get_subset(
-        project_name,
-        subset_id=subset_id,
-        subset_name=subset_name,
-        asset_id=asset_id,
-        fields=["_id"]
-    )
-    if not subset_doc:
+def get_last_version_by_subset_id(project_name, subset_id, fields=None):
+    """Last version for passed subset id.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        subset_id (str|ObjectId): Id of version which should be found.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        None: If version with specified filters was not found.
+        Dict: Version document which can be reduced to specified 'fields'.
+    """
+
+    subset_id = _convert_id(subset_id)
+    if not subset_id:
         return None
-    subset_id = subset_doc["_id"]
+
     last_versions = get_last_versions(
         project_name, subset_ids=[subset_id], fields=fields
     )
     return last_versions.get(subset_id)
 
 
-def get_representation(
-    project_name,
-    representation_id=None,
-    representation_name=None,
-    version_id=None,
-    fields=None
+def get_last_version_by_subset_name(
+    project_name, subset_name, asset_id, fields=None
 ):
+    """Last version for passed subset name under asset id.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        subset_name (str): Name of subset.
+        asset_id (str|ObjectId): Asset id which is parnt of passed subset name.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        None: If version with specified filters was not found.
+        Dict: Version document which can be reduced to specified 'fields'.
+    """
+
+    subset_doc = get_subset_by_name(
+        project_name, subset_name, asset_id, fields=["_id"]
+    )
+    if not subset_doc:
+        return None
+    return get_last_version_by_subset_id(
+        project_name, subset_doc["_id"], fields=fields
+    )
+
+
+def get_representation(project_name, representation_id, fields=None):
     if not representation_id:
-        if not representation_name or not version_id:
-            return None
+        return None
 
     repre_types = ["representation", "archived_representations"]
     query_filter = {
@@ -702,12 +727,6 @@ def get_representation(
     if representation_id is not None:
         query_filter["_id"] = _convert_id(representation_id)
 
-    if representation_name is not None:
-        query_filter["name"] = representation_name
-
-    if version_id is not None:
-        query_filter["parent"] = version_id
-
     conn = _get_project_connection(project_name)
 
     return conn.find_one(query_filter, _prepare_fields(fields))
diff --git a/openpype/tools/mayalookassigner/app.py b/openpype/tools/mayalookassigner/app.py
index 427edf8245..5665acea42 100644
--- a/openpype/tools/mayalookassigner/app.py
+++ b/openpype/tools/mayalookassigner/app.py
@@ -4,7 +4,7 @@ import logging
 
 from Qt import QtWidgets, QtCore
 
-from openpype.client import get_last_version_for_subset
+from openpype.client import get_last_version_by_subset_id
 from openpype import style
 from openpype.pipeline import legacy_io
 from openpype.tools.utils.lib import qt_app_context
@@ -230,8 +230,8 @@ class MayaLookAssignerWindow(QtWidgets.QWidget):
                 continue
 
             # Get the latest version of this asset's look subset
-            version = get_last_version_for_subset(
-                project_name, subset_id=assign_look["_id"], fields=["_id"]
+            version = get_last_version_by_subset_id(
+                project_name, assign_look["_id"], fields=["_id"]
             )
 
             subset_name = assign_look["name"]
diff --git a/openpype/tools/mayalookassigner/vray_proxies.py b/openpype/tools/mayalookassigner/vray_proxies.py
index b2ba21f944..889396e555 100644
--- a/openpype/tools/mayalookassigner/vray_proxies.py
+++ b/openpype/tools/mayalookassigner/vray_proxies.py
@@ -12,7 +12,7 @@ from maya import cmds
 
 from openpype.client import (
     get_representation_by_name,
-    get_last_version_for_subset,
+    get_last_version_by_subset_name,
 )
 from openpype.pipeline import (
     legacy_io,
@@ -251,7 +251,7 @@ def vrayproxy_assign_look(vrayproxy, subset="lookDefault"):
     for asset_id, node_ids in node_ids_by_asset_id.items():
 
         # Get latest look version
-        version = get_last_version_for_subset(
+        version = get_last_version_by_subset_name(
             project_name,
             subset_name=subset,
             asset_id=asset_id,
diff --git a/openpype/tools/sceneinventory/model.py b/openpype/tools/sceneinventory/model.py
index a5d856fe72..8c49933e80 100644
--- a/openpype/tools/sceneinventory/model.py
+++ b/openpype/tools/sceneinventory/model.py
@@ -10,7 +10,7 @@ from openpype.client import (
     get_asset_by_id,
     get_subset_by_id,
     get_version_by_id,
-    get_last_version_for_subset,
+    get_last_version_by_subset_id,
     get_representation,
 )
 from openpype.pipeline import (
@@ -403,8 +403,8 @@ class InventoryModel(TreeModel):
 
             # Store the highest available version so the model can know
             # whether current version is currently up-to-date.
-            highest_version = get_last_version_for_subset(
-                project_name, subset_id=version["parent"]
+            highest_version = get_last_version_by_subset_id(
+                project_name, version["parent"]
             )
 
             # create the group header
diff --git a/openpype/tools/standalonepublish/widgets/widget_family.py b/openpype/tools/standalonepublish/widgets/widget_family.py
index 2f00cfe7bb..1736be84ab 100644
--- a/openpype/tools/standalonepublish/widgets/widget_family.py
+++ b/openpype/tools/standalonepublish/widgets/widget_family.py
@@ -6,7 +6,7 @@ from openpype.client import (
     get_asset_by_name,
     get_subset_by_name,
     get_subsets,
-    get_last_version_for_subset,
+    get_last_version_by_subset_id,
 )
 from openpype.api import get_project_settings
 from openpype.pipeline import LegacyCreator
@@ -323,9 +323,9 @@ class FamilyWidget(QtWidgets.QWidget):
             )
 
         if subset_doc:
-            last_version = get_last_version_for_subset(
+            last_version = get_last_version_by_subset_id(
                 project_name,
-                subset_id=subset_doc["_id"],
+                subset_doc["_id"],
                 fields=["name"]
             )
             if last_version:

From cde47eefa8201fb6fc7b922427436ec2f3bd0202 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 18:27:54 +0200
Subject: [PATCH 0494/1227] renamed 'get_representation' to
 'get_representation_by_id'

---
 openpype/client/__init__.py            |  4 +--
 openpype/client/entities.py            | 35 +++++++++++++++++++++++---
 openpype/tools/sceneinventory/model.py |  6 ++---
 openpype/tools/sceneinventory/view.py  |  6 ++---
 4 files changed, 40 insertions(+), 11 deletions(-)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index 2ef32d6a83..2fa7730839 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -23,7 +23,7 @@ from .entities import (
     get_last_version_by_subset_name,
     get_output_link_versions,
 
-    get_representation,
+    get_representation_by_id,
     get_representation_by_name,
     get_representations,
     get_representation_parents,
@@ -58,7 +58,7 @@ __all__ = (
     "get_last_version_by_subset_name",
     "get_output_link_versions",
 
-    "get_representation",
+    "get_representation_by_id",
     "get_representation_by_name",
     "get_representations",
     "get_representation_parents",
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 232d9aebcc..7abb25e380 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -716,7 +716,21 @@ def get_last_version_by_subset_name(
     )
 
 
-def get_representation(project_name, representation_id, fields=None):
+def get_representation_by_id(project_name, representation_id, fields=None):
+    """Representation entity data by it's id.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        representation_id (str|ObjectId): Representation id.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        None: If representation with specified filters was not found.
+        Dict: Representation entity data which can be reduced
+            to specified 'fields'.
+    """
+
     if not representation_id:
         return None
 
@@ -735,17 +749,32 @@ def get_representation(project_name, representation_id, fields=None):
 def get_representation_by_name(
     project_name, representation_name, version_id, fields=None
 ):
+    """Representation entity data by it's name and it's version id.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        representation_name (str): Representation name.
+        version_id (str|ObjectId): Id of parent version entity.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        None: If representation with specified filters was not found.
+        Dict: Representation entity data which can be reduced
+            to specified 'fields'.
+    """
+
+    version_id = _convert_id(version_id)
     if not version_id or not representation_name:
         return None
     repre_types = ["representation", "archived_representations"]
     query_filter = {
         "type": {"$in": repre_types},
         "name": representation_name,
-        "parent": _convert_id(version_id)
+        "parent": version_id
     }
 
     conn = _get_project_connection(project_name)
-
     return conn.find_one(query_filter, _prepare_fields(fields))
 
 
diff --git a/openpype/tools/sceneinventory/model.py b/openpype/tools/sceneinventory/model.py
index 8c49933e80..117bdfcba1 100644
--- a/openpype/tools/sceneinventory/model.py
+++ b/openpype/tools/sceneinventory/model.py
@@ -11,7 +11,7 @@ from openpype.client import (
     get_subset_by_id,
     get_version_by_id,
     get_last_version_by_subset_id,
-    get_representation,
+    get_representation_by_id,
 )
 from openpype.pipeline import (
     legacy_io,
@@ -313,8 +313,8 @@ class InventoryModel(TreeModel):
         for repre_id, group_dict in sorted(grouped.items()):
             group_items = group_dict["items"]
             # Get parenthood per group
-            representation = get_representation(
-                project_name, representation_id=repre_id
+            representation = get_representation_by_id(
+                project_name, repre_id
             )
             if not representation:
                 not_found["representation"].append(group_items)
diff --git a/openpype/tools/sceneinventory/view.py b/openpype/tools/sceneinventory/view.py
index d1ff91535f..8164c48a5d 100644
--- a/openpype/tools/sceneinventory/view.py
+++ b/openpype/tools/sceneinventory/view.py
@@ -10,7 +10,7 @@ from openpype.client import (
     get_version_by_id,
     get_versions,
     get_hero_versions,
-    get_representation,
+    get_representation_by_id,
     get_representations,
 )
 from openpype import style
@@ -657,9 +657,9 @@ class SceneInventoryView(QtWidgets.QTreeView):
 
         project_name = legacy_io.active_project()
         # Get available versions for active representation
-        repre_doc = get_representation(
+        repre_doc = get_representation_by_id(
             project_name,
-            representation_id=active["representation"],
+            active["representation"],
             fields=["parent"]
         )
 

From aa91db6883485f33ba7bd2c74e2250ec5ebd906d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 18:36:54 +0200
Subject: [PATCH 0495/1227] added docstring for get_representations

---
 openpype/client/entities.py | 36 +++++++++++++++++++++++++++++++-----
 1 file changed, 31 insertions(+), 5 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 7abb25e380..6c0170ea40 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -147,7 +147,7 @@ def get_assets(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        asset_ids (list[str, ObjectId]): Asset ids that should be found.
+        asset_ids (list[str|ObjectId]): Asset ids that should be found.
         asset_names (list[str]): Name assets that should be found.
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
@@ -291,11 +291,11 @@ def get_subsets(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        subset_ids (list[str, ObjectId]): Subset ids that should be queried.
+        subset_ids (list[str|ObjectId]): Subset ids that should be queried.
             Filter ignored if 'None' is passed.
         subset_names (list[str]): Subset names that should be queried.
             Filter ignored if 'None' is passed.
-        asset_ids (list[str, ObjectId]): Asset ids under which should look for
+        asset_ids (list[str|ObjectId]): Asset ids under which should look for
             the subsets. Filter ignored if 'None' is passed.
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
@@ -339,7 +339,7 @@ def get_subset_families(project_name, subset_ids=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        subset_ids (list[str, ObjectId]): Subset ids that should be queried.
+        subset_ids (list[str|ObjectId]): Subset ids that should be queried.
             All subsets from project are used if 'None' is passed.
 
     Returns:
@@ -476,7 +476,7 @@ def get_versions(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        version_ids (list[str, ObjectId]): Version ids that will be queried.
+        version_ids (list[str|ObjectId]): Version ids that will be queried.
             Filter ignored if 'None' is passed.
         subset_ids (list[str]): Subset ids that will be queried.
             Filter ignored if 'None' is passed.
@@ -789,6 +789,32 @@ def get_representations(
     archived=False,
     fields=None
 ):
+    """Representaion entities data from one project filtered by filters.
+
+    Filters are additive (all conditions must pass to return subset).
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        representation_ids (list[str|ObjectId]): Representation ids used as
+            filter. Filter ignored if 'None' is passed.
+        representation_names (list[str]): Representations names used as filter.
+            Filter ignored if 'None' is passed.
+        version_ids (list[str]): Subset ids used as parent filter. Filter
+            ignored if 'None' is passed.
+        extensions (list[str]): Filter by extension of main representation
+            file (without dot).
+        names_by_version_ids (dict[ObjectId, list[str]]): Complex filtering
+            using version ids and list of names under the version.
+        check_site_name (bool): Filter only representation that have existing
+            site name.
+        archived (bool): Output will also contain archived representations.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        Cursor: Iterable cursor yielding all matching representations.
+    """
+
     repre_types = ["representation"]
     if archived:
         repre_types.append("archived_representations")

From 7d13ba2706d0cdc11f6b6358bafc432c87522d04 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 18:37:09 +0200
Subject: [PATCH 0496/1227] added missing functions to legacy_io and mongodb

---
 openpype/pipeline/legacy_io.py | 9 +++++++++
 openpype/pipeline/mongodb.py   | 4 ++++
 2 files changed, 13 insertions(+)

diff --git a/openpype/pipeline/legacy_io.py b/openpype/pipeline/legacy_io.py
index c8e7e79600..9359e3057b 100644
--- a/openpype/pipeline/legacy_io.py
+++ b/openpype/pipeline/legacy_io.py
@@ -144,3 +144,12 @@ def parenthood(*args, **kwargs):
 @requires_install
 def bulk_write(*args, **kwargs):
     return _connection_object.bulk_write(*args, **kwargs)
+
+
+@requires_install
+def active_project(*args, **kwargs):
+    return _connection_object.active_project(*args, **kwargs)
+
+
+def current_project(*args, **kwargs):
+    return Session.get("AVALON_PROJECT")
diff --git a/openpype/pipeline/mongodb.py b/openpype/pipeline/mongodb.py
index 565e26b966..dab5bb9e13 100644
--- a/openpype/pipeline/mongodb.py
+++ b/openpype/pipeline/mongodb.py
@@ -199,6 +199,10 @@ class AvalonMongoDB:
         """Return the name of the active project"""
         return self.Session["AVALON_PROJECT"]
 
+    def current_project(self):
+        """Currently set project in Session without triggering installation."""
+        return self.Session.get("AVALON_PROJECT")
+
     @requires_install
     @auto_reconnect
     def projects(self, projection=None, only_active=True):

From 0ce3045ad0bf399389cdbc7605762ecfe7b638f2 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 18:47:42 +0200
Subject: [PATCH 0497/1227] added missing docstrings

---
 openpype/client/__init__.py |  2 +
 openpype/client/entities.py | 88 ++++++++++++++++++++++++++++++++++++-
 2 files changed, 88 insertions(+), 2 deletions(-)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index 2fa7730839..16b1dcf321 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -30,6 +30,7 @@ from .entities import (
     get_representations_parents,
 
     get_thumbnail,
+    get_thumbnails,
     get_thumbnail_id_from_source,
 )
 
@@ -65,5 +66,6 @@ __all__ = (
     "get_representations_parents",
 
     "get_thumbnail",
+    "get_thumbnails",
     "get_thumbnail_id_from_source",
 )
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 6c0170ea40..c50ae32d7f 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -866,6 +866,20 @@ def get_representations(
 
 
 def get_representations_parents(project_name, representations):
+    """Prepare parents of representation entities.
+
+    Each item of returned dictionary contains version, subset, asset
+    and project in that order.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        representations (list[dict]): Representation entities with at least
+            '_id' and 'parent' keys.
+
+    Returns:
+        dict[ObjectId, tuple]: Parents by representation id.
+    """
+
     repres_by_version_id = collections.defaultdict(list)
     versions_by_version_id = {}
     versions_by_subset_id = collections.defaultdict(list)
@@ -921,15 +935,43 @@ def get_representations_parents(project_name, representations):
 
 
 def get_representation_parents(project_name, representation):
+    """Prepare parents of representation entity.
+
+    Each item of returned dictionary contains version, subset, asset
+    and project in that order.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        representation (dict): Representation entities with at least
+            '_id' and 'parent' keys.
+
+    Returns:
+        dict[ObjectId, tuple]: Parents by representation id.
+    """
+
     if not representation:
         return None
 
     repre_id = representation["_id"]
-    parents_by_repre_id = get_representations(project_name, [representation])
+    parents_by_repre_id = get_representations_parents(
+        project_name, [representation]
+    )
     return parents_by_repre_id.get(repre_id)
 
 
 def get_thumbnail_id_from_source(project_name, src_type, src_id):
+    """Receive thumbnail id from source entity.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        src_type (str): Type of source entity ('asset', 'version').
+        src_id (str|objectId): Id of source entity.
+
+    Returns:
+        ObjectId: Thumbnail id assigned to entity.
+        None: If Source entity does not have any thumbnail id assigned.
+    """
+
     if not src_type or not src_id:
         return None
 
@@ -942,12 +984,54 @@ def get_thumbnail_id_from_source(project_name, src_type, src_id):
     return None
 
 
+def get_thumbnails(project_name, thumbnail_ids, fields=None):
+    """Receive thumbnails entity data.
+
+    Thumbnail entity can be used to receive binary content of thumbnail based
+    on it's content and ThumbnailResolvers.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        thumbnail_ids (list[str|ObjectId]): Ids of thumbnail entities.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        cursor: Cursor of queried documents.
+    """
+
+    if thumbnail_ids:
+        thumbnail_ids = _convert_ids(thumbnail_ids)
+
+    if not thumbnail_ids:
+        return []
+    query_filter = {
+        "type": "thumbnail",
+        "_id": {"$in": thumbnail_ids}
+    }
+    conn = _get_project_connection(project_name)
+    return conn.find(query_filter, _prepare_fields(fields))
+
+
 def get_thumbnail(project_name, thumbnail_id, fields=None):
+    """Receive thumbnail entity data.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        thumbnail_id (str|ObjectId): Id of thumbnail entity.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        None: If thumbnail with specified id was not found.
+        Dict: Thumbnail entity data which can be reduced to specified 'fields'.
+    """
+
     if not thumbnail_id:
         return None
     query_filter = {"type": "thumbnail", "_id": _convert_id(thumbnail_id)}
     conn = _get_project_connection(project_name)
-    return conn.find(query_filter, _prepare_fields(fields))
+    return conn.find_one(query_filter, _prepare_fields(fields))
 
 
 """

From 125af17c2244f902447048c803d649f657f16f38 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 7 Jun 2022 18:47:47 +0200
Subject: [PATCH 0498/1227] updated usages

---
 openpype/client/entities.py | 57 +++++++++++++++++++------------------
 1 file changed, 30 insertions(+), 27 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index c50ae32d7f..2459ea3e92 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -1045,12 +1045,12 @@ openpype/tools/assetlinks/widgets.py
     - get_versions
     - get_subsets
     - get_assets
-    - get_version_links
+    - get_output_link_versions
 
 openpype/tools/creator/window.py
 - CreatorWindow
     Query:
-    - get_asset
+    - get_asset_by_name
     - get_subsets
 
 openpype/tools/launcher/models.py
@@ -1093,12 +1093,14 @@ openpype/tools/loader/widgets.py
     - get_subset_families
 - VersionTextEdit
     Query:
-    - get_subset
-    - get_version
+    - get_subset_by_id
+    - get_version_by_id
 - SubsetWidget
     Query:
     - get_subsets
     - get_representations
+    Update:
+    - Subset groups (combination of asset id and subset names)
 - RepresentationWidget
     Query:
     - get_subsets
@@ -1112,12 +1114,12 @@ openpype/tools/loader/widgets.py
 openpype/tools/mayalookassigner/app.py
 - MayaLookAssignerWindow
     Query:
-    - get_last_version_for_subset
+    - get_last_version_by_subset_id
 
 openpype/tools/mayalookassigner/commands.py
 - create_items_from_nodes
     Query:
-    - get_asset
+    - get_asset_by_id
 
 openpype/tools/mayalookassigner/vray_proxies.py
 - get_look_relationships
@@ -1128,7 +1130,7 @@ openpype/tools/mayalookassigner/vray_proxies.py
     - get_representation_by_name
 - vrayproxy_assign_look
     Query:
-    - get_last_version_for_subset
+    - get_last_version_by_subset_name
 
 openpype/tools/project_manager/project_manager/model.py
 - HierarchyModel
@@ -1150,7 +1152,7 @@ openpype/tools/project_manager/project_manager/widgets.py
 openpype/tools/publisher/widgets/create_dialog.py
 - CreateDialog
     Query:
-    - get_asset
+    - get_asset_by_name
     - get_subsets
 
 openpype/tools/publisher/control.py
@@ -1161,18 +1163,18 @@ openpype/tools/publisher/control.py
 openpype/tools/sceneinventory/model.py
 - InventoryModel
     Query:
-    - get_asset
-    - get_subset
-    - get_version
-    - get_last_version_for_subset
+    - get_asset_by_id
+    - get_subset_by_id
+    - get_version_by_id
+    - get_last_version_by_subset_id
     - get_representation
 
 openpype/tools/sceneinventory/switch_dialog.py
 - SwitchAssetDialog
     Query:
-    - get_asset
+    - get_asset_by_name
     - get_assets
-    - get_subset
+    - get_subset_by_name
     - get_subsets
     - get_versions
     - get_hero_versions
@@ -1182,10 +1184,10 @@ openpype/tools/sceneinventory/switch_dialog.py
 openpype/tools/sceneinventory/view.py
 - SceneInventoryView
     Query:
-    - get_version
+    - get_version_by_id
     - get_versions
     - get_hero_versions
-    - get_representation
+    - get_representation_by_id
     - get_representations
 
 openpype/tools/standalonepublish/widgets/model_asset.py
@@ -1197,31 +1199,31 @@ openpype/tools/standalonepublish/widgets/widget_asset.py
 - AssetWidget
     Query:
     - get_project
-    - get_asset
+    - get_asset_by_id
 
 openpype/tools/standalonepublish/widgets/widget_family.py
 - FamilyWidget
     Query:
-    - get_asset
-    - get_subset
+    - get_asset_by_name
+    - get_subset_by_name
     - get_subsets
-    - get_last_version_for_subset
+    - get_last_version_by_subset_id
 
 openpype/tools/standalonepublish/app.py
 - Window
     Query:
-    - get_asset
+    - get_asset_by_id
 
 openpype/tools/texture_copy/app.py
 - TextureCopy
     Query:
     - get_project
-    - get_asset
+    - get_asset_by_name
 
 openpype/tools/workfiles/files_widget.py
 - FilesWidget
     Query:
-    - get_asset
+    - get_asset_by_id
 
 openpype/tools/workfiles/model.py
 - PublishFilesModel
@@ -1234,12 +1236,13 @@ openpype/tools/workfiles/save_as_dialog.py
 - build_workfile_data
     Query:
     - get_project
-    - get_asset
+    - get_asset_by_name
 
 openpype/tools/workfiles/window.py
 - Window
     Query:
-    - get_asset
+    - get_asset_by_id
+    - get_asset_by_name
 
 openpype/tools/utils/assets_widget.py
 - AssetModel
@@ -1259,11 +1262,11 @@ openpype/tools/utils/lib.py
     - get_project
 - FamilyConfigCache
     Query:
-    - get_asset
+    - get_asset_by_name
 
 openpype/tools/utils/tasks_widget.py
 - TasksModel
     Query:
     - get_project
-    - get_asset
+    - get_asset_by_id
 """

From 1133dedb545efe81aaf5febc5819d7bd3ab6a3ab Mon Sep 17 00:00:00 2001
From: "felix.wang" <icyvapor@gmail.com>
Date: Tue, 7 Jun 2022 16:07:54 -0700
Subject: [PATCH 0499/1227] Support Maya instances in pointCache extraction.

---
 .../hosts/maya/plugins/publish/extract_pointcache.py | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index c4c8610ebb..4aaf223403 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -65,7 +65,7 @@ class ExtractAlembic(openpype.api.Extractor):
             "writeColorSets": writeColorSets,
             "writeFaceSets": writeFaceSets,
             "uvWrite": True,
-            "selection": True,
+            "selection": False,
             "worldSpace": instance.data.get("worldSpace", True)
         }
 
@@ -80,12 +80,10 @@ class ExtractAlembic(openpype.api.Extractor):
             options["writeUVSets"] = True
 
         with suspended_refresh():
-            with maintained_selection():
-                cmds.select(nodes, noExpand=True)
-                extract_alembic(file=path,
-                                startFrame=start,
-                                endFrame=end,
-                                **options)
+            extract_alembic(file=path,
+                            startFrame=start,
+                            endFrame=end,
+                            **options)
 
         if "representations" not in instance.data:
             instance.data["representations"] = []

From 1819c66e7bed0b3e9af91cf1d408bd91f8adb7b2 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Wed, 8 Jun 2022 03:51:00 +0000
Subject: [PATCH 0500/1227] [Automated] Bump version

---
 CHANGELOG.md        | 42 +++++++++++++-----------------------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 15 insertions(+), 31 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 50cb1d423e..1d7798cb48 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,19 +1,28 @@
 # Changelog
 
-## [3.10.1-nightly.3](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.11.0-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.10.0...HEAD)
 
+### 📖 Documentation
+
+- doc: adding royal render and multiverse to the web site [\#3285](https://github.com/pypeclub/OpenPype/pull/3285)
+
 **🚀 Enhancements**
 
 - General: Updated windows oiio tool [\#3268](https://github.com/pypeclub/OpenPype/pull/3268)
+- Unreal: add support for skeletalMesh and staticMesh to loaders [\#3267](https://github.com/pypeclub/OpenPype/pull/3267)
 - Maya: reference loaders could store placeholder in referenced url [\#3264](https://github.com/pypeclub/OpenPype/pull/3264)
 - TVPaint: Init file for TVPaint worker also handle guideline images [\#3250](https://github.com/pypeclub/OpenPype/pull/3250)
 - Nuke: Change default icon path in settings [\#3247](https://github.com/pypeclub/OpenPype/pull/3247)
 
 **🐛 Bug fixes**
 
+- Global: extract review slate issues [\#3286](https://github.com/pypeclub/OpenPype/pull/3286)
 - Webpublisher: return only active projects in ProjectsEndpoint [\#3281](https://github.com/pypeclub/OpenPype/pull/3281)
+- Hiero: add support for task tags 3.10.x [\#3279](https://github.com/pypeclub/OpenPype/pull/3279)
+- General: Fix Oiio tool path resolving [\#3278](https://github.com/pypeclub/OpenPype/pull/3278)
+- Maya: Fix udim support for e.g. uppercase \<UDIM\> tag [\#3266](https://github.com/pypeclub/OpenPype/pull/3266)
 - Nuke: bake reformat was failing on string type [\#3261](https://github.com/pypeclub/OpenPype/pull/3261)
 - Maya: hotfix Pxr multitexture in looks [\#3260](https://github.com/pypeclub/OpenPype/pull/3260)
 - Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
@@ -21,13 +30,14 @@
 - Unreal: Fixed Render creation in UE5 [\#3239](https://github.com/pypeclub/OpenPype/pull/3239)
 - Unreal: Fixed Camera loading in UE5 [\#3238](https://github.com/pypeclub/OpenPype/pull/3238)
 - Flame: debugging [\#3224](https://github.com/pypeclub/OpenPype/pull/3224)
-- Ftrack: Push hierarchical attributes action works [\#3210](https://github.com/pypeclub/OpenPype/pull/3210)
 - add silent audio to slate [\#3162](https://github.com/pypeclub/OpenPype/pull/3162)
 
 **Merged pull requests:**
 
 - Maya: better handling of legacy review subsets names [\#3269](https://github.com/pypeclub/OpenPype/pull/3269)
+- Deadline: publishing of animation and pointcache on a farm [\#3225](https://github.com/pypeclub/OpenPype/pull/3225)
 - Nuke: add pointcache and animation to loader [\#3186](https://github.com/pypeclub/OpenPype/pull/3186)
+- Add a gizmo menu to nuke [\#3172](https://github.com/pypeclub/OpenPype/pull/3172)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
@@ -37,7 +47,6 @@
 
 - General: OpenPype modules publish plugins are registered in host [\#3180](https://github.com/pypeclub/OpenPype/pull/3180)
 - General: Creator plugins from addons can be registered [\#3179](https://github.com/pypeclub/OpenPype/pull/3179)
-- Ftrack: Single image reviewable [\#3157](https://github.com/pypeclub/OpenPype/pull/3157)
 
 **🚀 Enhancements**
 
@@ -50,10 +59,6 @@
 - Maya: added clean\_import option to Import loader [\#3181](https://github.com/pypeclub/OpenPype/pull/3181)
 - Add the scripts menu definition to nuke [\#3168](https://github.com/pypeclub/OpenPype/pull/3168)
 - Maya: add maya 2023 to default applications [\#3167](https://github.com/pypeclub/OpenPype/pull/3167)
-- Compressed bgeo publishing in SAP and Houdini loader [\#3153](https://github.com/pypeclub/OpenPype/pull/3153)
-- General: Add 'dataclasses' to required python modules [\#3149](https://github.com/pypeclub/OpenPype/pull/3149)
-- Hooks: Tweak logging grammar [\#3147](https://github.com/pypeclub/OpenPype/pull/3147)
-- Nuke: settings for reformat node in CreateWriteRender node [\#3143](https://github.com/pypeclub/OpenPype/pull/3143)
 
 **🐛 Bug fixes**
 
@@ -66,6 +71,7 @@
 - Hiero: debugging frame range and other 3.10 [\#3222](https://github.com/pypeclub/OpenPype/pull/3222)
 - Project Manager: Fix persistent editors on project change [\#3218](https://github.com/pypeclub/OpenPype/pull/3218)
 - Deadline: instance data overwrite fix [\#3214](https://github.com/pypeclub/OpenPype/pull/3214)
+- Ftrack: Push hierarchical attributes action works [\#3210](https://github.com/pypeclub/OpenPype/pull/3210)
 - Standalone Publisher: Always create new representation for thumbnail [\#3203](https://github.com/pypeclub/OpenPype/pull/3203)
 - Photoshop: skip collector when automatic testing [\#3202](https://github.com/pypeclub/OpenPype/pull/3202)
 - Nuke: render/workfile version sync doesn't work on farm [\#3185](https://github.com/pypeclub/OpenPype/pull/3185)
@@ -76,9 +82,6 @@
 - General: Oiio conversion for ffmpeg checks for invalid characters [\#3166](https://github.com/pypeclub/OpenPype/pull/3166)
 - Fix for attaching render to subset [\#3164](https://github.com/pypeclub/OpenPype/pull/3164)
 - Harmony: fixed missing task name in render instance [\#3163](https://github.com/pypeclub/OpenPype/pull/3163)
-- Ftrack: Action delete old versions formatting works [\#3152](https://github.com/pypeclub/OpenPype/pull/3152)
-- Deadline: fix the output directory [\#3144](https://github.com/pypeclub/OpenPype/pull/3144)
-- General: New Session schema [\#3141](https://github.com/pypeclub/OpenPype/pull/3141)
 
 **🔀 Refactored code**
 
@@ -89,7 +92,6 @@
 - Harmony: message length in 21.1 [\#3257](https://github.com/pypeclub/OpenPype/pull/3257)
 - Harmony: 21.1 fix [\#3249](https://github.com/pypeclub/OpenPype/pull/3249)
 - Maya: added jpg to filter for Image Plane Loader [\#3223](https://github.com/pypeclub/OpenPype/pull/3223)
-- Maya: added jpg to filter for Image Plane Loader [\#3221](https://github.com/pypeclub/OpenPype/pull/3221)
 - Webpublisher: replace space by underscore in subset names [\#3160](https://github.com/pypeclub/OpenPype/pull/3160)
 
 ## [3.9.8](https://github.com/pypeclub/OpenPype/tree/3.9.8) (2022-05-19)
@@ -119,24 +121,6 @@
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.9.6...3.9.7)
 
-**🆕 New features**
-
-- Ftrack: Single image reviewable [\#3158](https://github.com/pypeclub/OpenPype/pull/3158)
-
-**🚀 Enhancements**
-
-- Deadline output dir issue to 3.9x [\#3155](https://github.com/pypeclub/OpenPype/pull/3155)
-- nuke: removing redundant code from startup [\#3142](https://github.com/pypeclub/OpenPype/pull/3142)
-
-**🐛 Bug fixes**
-
-- Ftrack: Action delete old versions formatting works [\#3154](https://github.com/pypeclub/OpenPype/pull/3154)
-- nuke: adding extract thumbnail settings [\#3148](https://github.com/pypeclub/OpenPype/pull/3148)
-
-**Merged pull requests:**
-
-- Webpublisher: replace space by underscore in subset names [\#3159](https://github.com/pypeclub/OpenPype/pull/3159)
-
 ## [3.9.6](https://github.com/pypeclub/OpenPype/tree/3.9.6) (2022-05-03)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.9.5...3.9.6)
diff --git a/openpype/version.py b/openpype/version.py
index e5dfc2bb8f..4c78a6e0a1 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.10.1-nightly.3"
+__version__ = "3.11.0-nightly.1"
diff --git a/pyproject.toml b/pyproject.toml
index 5649ff2073..362f6a62d8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.10.1-nightly.3" # OpenPype
+version = "3.11.0-nightly.1" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 24cb024dd9d27e5c68fcd6f7d9097297031d7845 Mon Sep 17 00:00:00 2001
From: Felix Wang <icyvapor@gmail.com>
Date: Wed, 8 Jun 2022 00:45:15 -0700
Subject: [PATCH 0501/1227] Maya: Look assigner UI improvements (#3208)

Co-authored-by: felix.wang <felix.wang@igg.com>
---
 openpype/hosts/maya/api/lib.py     |  5 ++++-
 openpype/tools/utils/host_tools.py | 10 ++++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 088304ab05..bce03a648b 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -1737,8 +1737,11 @@ def apply_shaders(relationships, shadernodes, nodes):
             log.warning("No nodes found for shading engine "
                         "'{0}'".format(id_shading_engines[0]))
             continue
+        try:
+            cmds.sets(filtered_nodes, forceElement=id_shading_engines[0])
+        except RuntimeError as rte:
+            log.error("Error during shader assignment: {}".format(rte))
 
-        cmds.sets(filtered_nodes, forceElement=id_shading_engines[0])
     # endregion
 
     apply_attributes(attributes, nodes_by_id)
diff --git a/openpype/tools/utils/host_tools.py b/openpype/tools/utils/host_tools.py
index d8f4570120..9dbbe25fda 100644
--- a/openpype/tools/utils/host_tools.py
+++ b/openpype/tools/utils/host_tools.py
@@ -105,6 +105,7 @@ class HostToolsHelper:
             loader_tool.show()
             loader_tool.raise_()
             loader_tool.activateWindow()
+            loader_tool.showNormal()
 
             if use_context is None:
                 use_context = False
@@ -180,6 +181,7 @@ class HostToolsHelper:
             # Pull window to the front.
             scene_inventory_tool.raise_()
             scene_inventory_tool.activateWindow()
+            scene_inventory_tool.showNormal()
 
     def get_library_loader_tool(self, parent):
         """Create, cache and return library loader tool window."""
@@ -200,8 +202,10 @@ class HostToolsHelper:
             library_loader_tool.show()
             library_loader_tool.raise_()
             library_loader_tool.activateWindow()
+            library_loader_tool.showNormal()
             library_loader_tool.refresh()
 
+
     def show_publish(self, parent=None):
         """Try showing the most desirable publish GUI
 
@@ -243,6 +247,11 @@ class HostToolsHelper:
             look_assigner_tool = self.get_look_assigner_tool(parent)
             look_assigner_tool.show()
 
+            # Pull window to the front.
+            look_assigner_tool.raise_()
+            look_assigner_tool.activateWindow()
+            look_assigner_tool.showNormal()
+
     def get_experimental_tools_dialog(self, parent=None):
         """Dialog of experimental tools.
 
@@ -270,6 +279,7 @@ class HostToolsHelper:
             dialog.show()
             dialog.raise_()
             dialog.activateWindow()
+            dialog.showNormal()
 
     def get_tool_by_name(self, tool_name, parent=None, *args, **kwargs):
         """Show tool by it's name.

From 964504eb7706eaf2f0ac9013f31a72192c840845 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Wed, 8 Jun 2022 10:23:43 +0200
Subject: [PATCH 0502/1227] add app key to documentation

---
 website/docs/admin_settings_project_anatomy.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/website/docs/admin_settings_project_anatomy.md b/website/docs/admin_settings_project_anatomy.md
index b98819cd8a..6e0b49f152 100644
--- a/website/docs/admin_settings_project_anatomy.md
+++ b/website/docs/admin_settings_project_anatomy.md
@@ -67,6 +67,7 @@ We have a few required anatomy templates for OpenPype to work properly, however
 | `ext` | File extension |
 | `representation` | Representation name |
 | `frame` | Frame number for sequence files. |
+| `app` | Application Name |
 | `output` |  |
 | `comment` |  |
 

From 10bf3a33e1c90104b5f9cfe709b46607a5c98807 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 8 Jun 2022 11:45:12 +0200
Subject: [PATCH 0503/1227] Nuke: no need to add Nuke host to filter

It is actually  adding review even not needed
---
 openpype/settings/defaults/project_settings/deadline.json | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/deadline.json b/openpype/settings/defaults/project_settings/deadline.json
index 5c5a14bf21..a6e7b4a94a 100644
--- a/openpype/settings/defaults/project_settings/deadline.json
+++ b/openpype/settings/defaults/project_settings/deadline.json
@@ -83,9 +83,6 @@
                 "maya": [
                     ".*([Bb]eauty).*"
                 ],
-                "nuke": [
-                    ".*"
-                ],
                 "aftereffects": [
                     ".*"
                 ],

From 016baf166b1646c06cb8b1c7b40d6ccb9a5be2e1 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Wed, 8 Jun 2022 18:45:31 +0900
Subject: [PATCH 0504/1227] Renaming `usdX` families to `mvUsdX`, that is
 `usd`->`mvUsd`, `usdComposition`->`mvUsdComposition`,
 `usdOverride`->`usdOverride`, specifically within multiverse files. I have
 left the `usd` family in `integrate_new.py` because that is being used in a
 bunch of different places (eg: houdini's host integration), and have just
 added `mvUsd` as a new family.

---
 .../hosts/maya/plugins/create/create_multiverse_usd.py     | 4 ++--
 .../maya/plugins/create/create_multiverse_usd_comp.py      | 4 ++--
 .../maya/plugins/create/create_multiverse_usd_over.py      | 4 ++--
 openpype/hosts/maya/plugins/load/load_multiverse_usd.py    | 2 +-
 .../hosts/maya/plugins/publish/extract_multiverse_usd.py   | 2 +-
 .../maya/plugins/publish/extract_multiverse_usd_comp.py    | 2 +-
 .../maya/plugins/publish/extract_multiverse_usd_over.py    | 2 +-
 openpype/plugins/publish/integrate_new.py                  | 7 ++++---
 8 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
index a82a73cbdb..034714d51b 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
@@ -4,9 +4,9 @@ from openpype.hosts.maya.api import plugin, lib
 class CreateMultiverseUsd(plugin.Creator):
     """Create Multiverse USD Asset"""
 
-    name = "usdMain"
+    name = "mvUsdMain"
     label = "Multiverse USD Asset"
-    family = "usd"
+    family = "mvUsd"
     icon = "cubes"
 
     def __init__(self, *args, **kwargs):
diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
index 9d00ad1cfa..ed466a8068 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd_comp.py
@@ -4,9 +4,9 @@ from openpype.hosts.maya.api import plugin, lib
 class CreateMultiverseUsdComp(plugin.Creator):
     """Create Multiverse USD Composition"""
 
-    name = "usdCompositionMain"
+    name = "mvUsdCompositionMain"
     label = "Multiverse USD Composition"
-    family = "usdComposition"
+    family = "mvUsdComposition"
     icon = "cubes"
 
     def __init__(self, *args, **kwargs):
diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
index 9477cd7fed..06e22df295 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
@@ -4,9 +4,9 @@ from openpype.hosts.maya.api import plugin, lib
 class CreateMultiverseUsdOver(plugin.Creator):
     """Create Multiverse USD Override"""
 
-    name = "usdOverrideMain"
+    name = "mvUsdOverrideMain"
     label = "Multiverse USD Override"
-    family = "usdOverride"
+    family = "mvUsdOverride"
     icon = "cubes"
 
     def __init__(self, *args, **kwargs):
diff --git a/openpype/hosts/maya/plugins/load/load_multiverse_usd.py b/openpype/hosts/maya/plugins/load/load_multiverse_usd.py
index ed0ffc8ef1..3350dc6ac9 100644
--- a/openpype/hosts/maya/plugins/load/load_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/load/load_multiverse_usd.py
@@ -16,7 +16,7 @@ from openpype.hosts.maya.api.pipeline import containerise
 class MultiverseUsdLoader(load.LoaderPlugin):
     """Read USD data in a Multiverse Compound"""
 
-    families = ["model", "usd", "usdComposition", "usdOverride",
+    families = ["model", "mvUsd", "mvUsdComposition", "mvUsdOverride",
                 "pointcache", "animation"]
     representations = ["usd", "usda", "usdc", "usdz", "abc"]
 
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
index b1aaf9d9ba..3654be7b34 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
@@ -26,7 +26,7 @@ class ExtractMultiverseUsd(openpype.api.Extractor):
 
     label = "Extract Multiverse USD Asset"
     hosts = ["maya"]
-    families = ["usd"]
+    families = ["mvUsd"]
     scene_type = "usd"
     file_formats = ["usd", "usda", "usdz"]
 
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
index c85b3b6664..ad9303657f 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py
@@ -25,7 +25,7 @@ class ExtractMultiverseUsdComposition(openpype.api.Extractor):
 
     label = "Extract Multiverse USD Composition"
     hosts = ["maya"]
-    families = ["usdComposition"]
+    families = ["mvUsdComposition"]
     scene_type = "usd"
     # Order of `fileFormat` must match create_multiverse_usd_comp.py
     file_formats = ["usda", "usd"]
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
index 4856f0cfdb..d44e3878b8 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py
@@ -23,7 +23,7 @@ class ExtractMultiverseUsdOverride(openpype.api.Extractor):
 
     label = "Extract Multiverse USD Override"
     hosts = ["maya"]
-    families = ["usdOverride"]
+    families = ["mvUsdOverride"]
     scene_type = "usd"
     # Order of `fileFormat` must match create_multiverse_usd_over.py
     file_formats = ["usda", "usd"]
diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 4712c2e6bb..59b80f5cc1 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -106,12 +106,13 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "effect",
                 "xgen",
                 "hda",
-                "mvLook",
                 "usd",
                 "staticMesh",
                 "skeletalMesh",
-                "usdComposition",
-                "usdOverride",
+                "mvLook",
+                "mvUsd",
+                "mvUsdComposition",
+                "mvUsdOverride",
                 "simpleUnrealTexture"
                 ]
     exclude_families = ["clip", "render.farm"]

From 082fb1d29dfe151809c8a63767a9fc941462a23e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Wed, 8 Jun 2022 12:09:13 +0200
Subject: [PATCH 0505/1227] :sparkles: settings for camera content validator

---
 .../publish/validate_camera_contents.py       |  3 +++
 .../defaults/project_settings/maya.json       |  5 ++++
 .../schemas/schema_maya_publish.json          | 24 +++++++++++++++++++
 3 files changed, 32 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/validate_camera_contents.py b/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
index 20af8d2315..38cf65f006 100644
--- a/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
+++ b/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
@@ -20,6 +20,7 @@ class ValidateCameraContents(pyblish.api.InstancePlugin):
     hosts = ['maya']
     label = 'Camera Contents'
     actions = [openpype.hosts.maya.api.action.SelectInvalidAction]
+    validate_shapes = True
 
     @classmethod
     def get_invalid(cls, instance):
@@ -49,6 +50,8 @@ class ValidateCameraContents(pyblish.api.InstancePlugin):
 
                 raise RuntimeError("No cameras found in empty instance.")
 
+        if not cls.validate_shapes:
+            return
         # non-camera shapes
         valid_shapes = cmds.ls(shapes, type=('camera', 'locator'), long=True)
         shapes = set(shapes) - set(valid_shapes)
diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index efd22e13c8..b39beeb305 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -413,6 +413,11 @@
             "optional": true,
             "active": true
         },
+        "ValidateCameraContents": {
+            "enabled": true,
+            "optional": true,
+            "validate_shapes": true
+        },
         "ExtractPlayblast": {
             "capture_preset": {
                 "Codec": {
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
index 9877b5ff0d..dca0e85acb 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
@@ -570,6 +570,30 @@
                 }
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "ValidateCameraContents",
+            "label": "Validate Camera Content",
+            "checkbox_key": "enabled",
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                },
+                {
+                    "type": "boolean",
+                    "key": "optional",
+                    "label": "Optional"
+                },
+                {
+                    "type": "boolean",
+                    "key": "validate_shapes",
+                    "label": "Validate presence of shapes"
+                }
+            ]
+        },
         {
             "type": "splitter"
         },

From eba5691a2db74da0ff994299d9c252f03dcea021 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 13:23:14 +0200
Subject: [PATCH 0506/1227] use width for width and height for height in maya
 render

---
 openpype/hosts/maya/plugins/publish/collect_render.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_render.py b/openpype/hosts/maya/plugins/publish/collect_render.py
index fbd2e81279..8b911a867d 100644
--- a/openpype/hosts/maya/plugins/publish/collect_render.py
+++ b/openpype/hosts/maya/plugins/publish/collect_render.py
@@ -340,10 +340,10 @@ class CollectMayaRender(pyblish.api.ContextPlugin):
                 "expectedFiles": full_exp_files,
                 "publishRenderMetadataFolder": common_publish_meta_path,
                 "resolutionWidth": lib.get_attr_in_layer(
-                    "defaultResolution.height", layer=layer_name
+                    "defaultResolution.width", layer=layer_name
                 ),
                 "resolutionHeight": lib.get_attr_in_layer(
-                    "defaultResolution.width", layer=layer_name
+                    "defaultResolution.height", layer=layer_name
                 ),
                 "pixelAspect": lib.get_attr_in_layer(
                     "defaultResolution.pixelAspect", layer=layer_name

From a45795526698b9a668df876a01ce002a5a05024f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 13:33:26 +0200
Subject: [PATCH 0507/1227] add missing default settings for nuke gizmo

---
 .../defaults/project_settings/nuke.json       | 54 ++++++++++---------
 1 file changed, 29 insertions(+), 25 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index c609a0927a..16348bec85 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -27,6 +27,34 @@
             }
         ]
     },
+    "gizmo": [
+        {
+            "toolbar_menu_name": "OpenPype Gizmo",
+            "gizmo_source_dir": {
+                "windows": [],
+                "darwin": [],
+                "linux": []
+            },
+            "toolbar_icon_path": {
+                "windows": "",
+                "darwin": "",
+                "linux": ""
+            },
+            "gizmo_definition": [
+                {
+                    "gizmo_toolbar_path": "/path/to/menu",
+                    "sub_gizmo_list": [
+                        {
+                            "sourcetype": "python",
+                            "title": "Gizmo Note",
+                            "command": "nuke.nodes.StickyNote(label='You can create your own toolbar menu in the Nuke GizmoMenu of OpenPype')",
+                            "shortcut": ""
+                        }
+                    ]
+                }
+            ]
+        }
+    ],
     "create": {
         "CreateWriteRender": {
             "fpath_template": "{work}/renders/nuke/{subset}/{subset}.{frame}.{ext}",
@@ -290,29 +318,5 @@
             }
         ]
     },
-    "gizmo": [
-        {
-            "toolbar_menu_name": "OpenPype Gizmo",
-            "gizmo_path": {
-                "windows": [],
-                "darwin": [],
-                "linux": []
-            },
-            "toolbar_icon_path": {},
-            "gizmo_definition": [
-                {
-                    "gizmo_toolbar_path": "/path/to/menu",
-                    "sub_gizmo_list": [
-                        {
-                            "sourcetype": "python",
-                            "title": "Gizmo Note",
-                            "command": "nuke.nodes.StickyNote(label='You can create your own toolbar menu in the Nuke GizmoMenu of OpenPype')",
-                            "shortcut": ""
-                        }
-                    ]
-                }
-            ]
-        }
-    ],
     "filters": {}
-}
+}
\ No newline at end of file

From 56a3dae94b39ce90e5afc701ae8efb3aa130896e Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 8 Jun 2022 14:46:16 +0200
Subject: [PATCH 0508/1227] Fix - added local targets to install host

By default when host is started, it should register targets to 'local', only if specific env var is set (OPENPYPE_REMOTE_PUBLISH) it should be 'remote'. This means
farm is using host to collect/validate/extract and publish on behalf of artist.
---
 openpype/hosts/maya/api/pipeline.py                       | 2 +-
 .../publish/submit_maya_remote_publish_deadline.py        | 2 +-
 openpype/pipeline/context_tools.py                        | 8 ++++++++
 openpype/plugin.py                                        | 2 +-
 4 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index 0261694be2..836445a970 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -66,7 +66,7 @@ def install():
     log.info("Installing callbacks ... ")
     register_event_callback("init", on_init)
 
-    if os.environ.get("HEADLESS_PUBLISH"):
+    if os.environ.get("OPENPYPE_REMOTE_PUBLISH"):
         # Maya launched on farm, lib.IS_HEADLESS might be triggered locally too
         # target "farm" == rendering on farm, expects OPENPYPE_PUBLISH_DATA
         # target "remote" == remote execution
diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
index c31052be07..4f82818d6d 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
@@ -115,7 +115,7 @@ class MayaSubmitRemotePublishDeadline(openpype.api.Integrator):
         environment["OPENPYPE_REMOTE_JOB"] = "1"
         environment["OPENPYPE_USERNAME"] = instance.context.data["user"]
         environment["OPENPYPE_PUBLISH_SUBSET"] = instance.data["subset"]
-        environment["HEADLESS_PUBLISH"] = "1"
+        environment["OPENPYPE_REMOTE_PUBLISH"] = "1"
 
         payload["JobInfo"].update({
             "EnvironmentKeyValue%d" % index: "{key}={value}".format(
diff --git a/openpype/pipeline/context_tools.py b/openpype/pipeline/context_tools.py
index e849f5b0d1..c6e09cfba1 100644
--- a/openpype/pipeline/context_tools.py
+++ b/openpype/pipeline/context_tools.py
@@ -104,6 +104,14 @@ def install_host(host):
 
     MessageHandler.emit = modified_emit
 
+    if os.environ.get("OPENPYPE_REMOTE_PUBLISH"):
+        # target "farm" == rendering on farm, expects OPENPYPE_PUBLISH_DATA
+        # target "remote" == remote execution, installs host
+        print("Registering pyblish target: remote")
+        pyblish.api.register_target("remote")
+    else:
+        pyblish.api.register_target("local")
+
     install_openpype_plugins()
 
 
diff --git a/openpype/plugin.py b/openpype/plugin.py
index f1ee626ffb..6637ad1d8b 100644
--- a/openpype/plugin.py
+++ b/openpype/plugin.py
@@ -23,7 +23,7 @@ class Integrator(InstancePlugin):
 
     Wraps pyblish instance plugin. Targets set to "local" which means all
     integrators should run on "local" publishes, by default.
-    "farm" targets could be used for integrators that should run on a farm.
+    "remote" targets could be used for integrators that should run externally.
     """
     targets = ["local"]
 

From 860dc3fc90ae78a044bbbf52e47560e1d7cdd7ea Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 14:57:12 +0200
Subject: [PATCH 0509/1227] use temp file instead of clipboard for node
 duplication

---
 openpype/hosts/nuke/api/lib.py | 44 +++++++++++++++++++++++++++++-----
 1 file changed, 38 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 3062091ba0..7329fc859b 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3,6 +3,8 @@ from pprint import pformat
 import re
 import six
 import platform
+import time
+import tempfile
 import contextlib
 from collections import OrderedDict
 
@@ -2562,20 +2564,50 @@ class DirmapCache:
         return cls._sync_module
 
 
+@contextlib.contextmanager
+def _duplicate_node_temp():
+    """Create a temp file where node is pasted during duplication.
+
+    This is to avoid using clipboard for node duplication.
+    """
+
+    duplicate_node_temp_path = os.path.join(
+        tempfile.gettempdir(),
+        "openpype_nuke_duplicate_temp_{}".format(os.getpid())
+    )
+
+    # This can happen only if 'duplicate_node' would be
+    if os.path.exists(duplicate_node_temp_path):
+        log.warning((
+            "Temp file for node duplication already exists."
+            " Trying to remove {}"
+        ).format(duplicate_node_temp_path))
+        os.remove(duplicate_node_temp_path)
+
+    try:
+        # Yield the path where node can be copied
+        yield duplicate_node_temp_path
+
+    finally:
+        # Remove the file at the end
+        os.remove(duplicate_node_temp_path)
+
+
 def duplicate_node(node):
     reset_selection()
 
     # select required node for duplication
     node.setSelected(True)
 
-    # copy selected to clipboard
-    nuke.nodeCopy("%clipboard%")
+    with _duplicate_node_temp() as filepath:
+        # copy selected to temp filepath
+        nuke.nodeCopy(filepath)
 
-    # reset selection
-    reset_selection()
+        # reset selection
+        reset_selection()
 
-    # paste node and selection is on it only
-    dupli_node = nuke.nodePaste("%clipboard%")
+        # paste node and selection is on it only
+        dupli_node = nuke.nodePaste(filepath)
 
     # reset selection
     reset_selection()

From 1f8be47064249bb69ca764a70e18f81d2cb3af49 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 14:57:42 +0200
Subject: [PATCH 0510/1227] remove unused import

---
 openpype/hosts/nuke/api/lib.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 7329fc859b..4391742f43 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3,7 +3,6 @@ from pprint import pformat
 import re
 import six
 import platform
-import time
 import tempfile
 import contextlib
 from collections import OrderedDict

From a63299d57e8856408ec9a2eeb6fe60ebb57483e2 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 8 Jun 2022 15:00:54 +0200
Subject: [PATCH 0511/1227] Removed explicit targets registering

install_host registers targets implicitly for all hosts
---
 openpype/hosts/maya/api/pipeline.py | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index 836445a970..d9276ddf4a 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -66,23 +66,12 @@ def install():
     log.info("Installing callbacks ... ")
     register_event_callback("init", on_init)
 
-    if os.environ.get("OPENPYPE_REMOTE_PUBLISH"):
-        # Maya launched on farm, lib.IS_HEADLESS might be triggered locally too
-        # target "farm" == rendering on farm, expects OPENPYPE_PUBLISH_DATA
-        # target "remote" == remote execution
-        print("Registering pyblish target: remote")
-        pyblish.api.register_target("remote")
-        return
-
     if lib.IS_HEADLESS:
         log.info(("Running in headless mode, skipping Maya "
                  "save/open/new callback installation.."))
 
         return
 
-    print("Registering pyblish target: local")
-    pyblish.api.register_target("local")
-
     _set_project()
     _register_callbacks()
 

From 5f3395683ac38bbb01d16880a1e063b0f9f39554 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 16:02:08 +0200
Subject: [PATCH 0512/1227] added 'requests' and its dependencies into python 2
 vendor

---
 .../python/python_2/chardet/__init__.py       |   83 +
 .../python/python_2/chardet/big5freq.py       |  386 +
 .../python/python_2/chardet/big5prober.py     |   47 +
 .../python_2/chardet/chardistribution.py      |  233 +
 .../python_2/chardet/charsetgroupprober.py    |  107 +
 .../python/python_2/chardet/charsetprober.py  |  145 +
 .../python/python_2/chardet/cli/__init__.py   |    1 +
 .../python/python_2/chardet/cli/chardetect.py |   84 +
 .../python_2/chardet/codingstatemachine.py    |   88 +
 .../vendor/python/python_2/chardet/compat.py  |   36 +
 .../python/python_2/chardet/cp949prober.py    |   49 +
 .../vendor/python/python_2/chardet/enums.py   |   76 +
 .../python/python_2/chardet/escprober.py      |  101 +
 .../vendor/python/python_2/chardet/escsm.py   |  246 +
 .../python/python_2/chardet/eucjpprober.py    |   92 +
 .../python/python_2/chardet/euckrfreq.py      |  195 +
 .../python/python_2/chardet/euckrprober.py    |   47 +
 .../python/python_2/chardet/euctwfreq.py      |  387 +
 .../python/python_2/chardet/euctwprober.py    |   46 +
 .../python/python_2/chardet/gb2312freq.py     |  283 +
 .../python/python_2/chardet/gb2312prober.py   |   46 +
 .../python/python_2/chardet/hebrewprober.py   |  292 +
 .../vendor/python/python_2/chardet/jisfreq.py |  325 +
 .../vendor/python/python_2/chardet/jpcntx.py  |  233 +
 .../python_2/chardet/langbulgarianmodel.py    | 4650 +++++++++
 .../python/python_2/chardet/langgreekmodel.py | 4398 +++++++++
 .../python_2/chardet/langhebrewmodel.py       | 4383 +++++++++
 .../python_2/chardet/langhungarianmodel.py    | 4650 +++++++++
 .../python_2/chardet/langrussianmodel.py      | 5718 +++++++++++
 .../python/python_2/chardet/langthaimodel.py  | 4383 +++++++++
 .../python_2/chardet/langturkishmodel.py      | 4383 +++++++++
 .../python/python_2/chardet/latin1prober.py   |  145 +
 .../python_2/chardet/mbcharsetprober.py       |   91 +
 .../python_2/chardet/mbcsgroupprober.py       |   54 +
 .../vendor/python/python_2/chardet/mbcssm.py  |  572 ++
 .../python_2/chardet/metadata/__init__.py     |    0
 .../python_2/chardet/metadata/languages.py    |  310 +
 .../python_2/chardet/sbcharsetprober.py       |  145 +
 .../python_2/chardet/sbcsgroupprober.py       |   83 +
 .../python/python_2/chardet/sjisprober.py     |   92 +
 .../python_2/chardet/universaldetector.py     |  286 +
 .../python/python_2/chardet/utf8prober.py     |   82 +
 .../vendor/python/python_2/chardet/version.py |    9 +
 .../vendor/python/python_2/idna/__init__.py   |    2 +
 openpype/vendor/python/python_2/idna/codec.py |  118 +
 .../vendor/python/python_2/idna/compat.py     |   12 +
 openpype/vendor/python/python_2/idna/core.py  |  400 +
 .../vendor/python/python_2/idna/idnadata.py   | 2050 ++++
 .../vendor/python/python_2/idna/intranges.py  |   53 +
 .../python/python_2/idna/package_data.py      |    2 +
 .../vendor/python/python_2/idna/uts46data.py  | 8357 +++++++++++++++++
 .../python/python_2/requests/__init__.py      |  152 +
 .../python/python_2/requests/__version__.py   |   14 +
 .../python_2/requests/_internal_utils.py      |   42 +
 .../python/python_2/requests/adapters.py      |  538 ++
 .../vendor/python/python_2/requests/api.py    |  159 +
 .../vendor/python/python_2/requests/auth.py   |  305 +
 .../vendor/python/python_2/requests/certs.py  |   18 +
 .../vendor/python/python_2/requests/compat.py |   81 +
 .../python/python_2/requests/cookies.py       |  549 ++
 .../python/python_2/requests/exceptions.py    |  133 +
 .../vendor/python/python_2/requests/help.py   |  135 +
 .../vendor/python/python_2/requests/hooks.py  |   34 +
 .../vendor/python/python_2/requests/models.py |  973 ++
 .../python/python_2/requests/packages.py      |   26 +
 .../python/python_2/requests/sessions.py      |  771 ++
 .../python/python_2/requests/status_codes.py  |  123 +
 .../python/python_2/requests/structures.py    |  105 +
 .../vendor/python/python_2/requests/utils.py  | 1060 +++
 .../python/python_2/urllib3/__init__.py       |   85 +
 .../python/python_2/urllib3/_collections.py   |  337 +
 .../python/python_2/urllib3/_version.py       |    2 +
 .../python/python_2/urllib3/connection.py     |  567 ++
 .../python/python_2/urllib3/connectionpool.py | 1108 +++
 .../python_2/urllib3/contrib/__init__.py      |    0
 .../urllib3/contrib/_appengine_environ.py     |   36 +
 .../contrib/_securetransport/__init__.py      |    0
 .../contrib/_securetransport/bindings.py      |  519 +
 .../contrib/_securetransport/low_level.py     |  397 +
 .../python_2/urllib3/contrib/appengine.py     |  314 +
 .../python_2/urllib3/contrib/ntlmpool.py      |  130 +
 .../python_2/urllib3/contrib/pyopenssl.py     |  511 +
 .../urllib3/contrib/securetransport.py        |  922 ++
 .../python/python_2/urllib3/contrib/socks.py  |  216 +
 .../python/python_2/urllib3/exceptions.py     |  323 +
 .../vendor/python/python_2/urllib3/fields.py  |  274 +
 .../python/python_2/urllib3/filepost.py       |   98 +
 .../python_2/urllib3/packages/__init__.py     |    0
 .../urllib3/packages/backports/__init__.py    |    0
 .../urllib3/packages/backports/makefile.py    |   51 +
 .../python/python_2/urllib3/packages/six.py   | 1077 +++
 .../python/python_2/urllib3/poolmanager.py    |  537 ++
 .../vendor/python/python_2/urllib3/request.py |  170 +
 .../python/python_2/urllib3/response.py       |  824 ++
 .../python/python_2/urllib3/util/__init__.py  |   49 +
 .../python_2/urllib3/util/connection.py       |  149 +
 .../python/python_2/urllib3/util/proxy.py     |   57 +
 .../python/python_2/urllib3/util/queue.py     |   22 +
 .../python/python_2/urllib3/util/request.py   |  146 +
 .../python/python_2/urllib3/util/response.py  |  107 +
 .../python/python_2/urllib3/util/retry.py     |  620 ++
 .../python/python_2/urllib3/util/ssl_.py      |  495 +
 .../urllib3/util/ssl_match_hostname.py        |  159 +
 .../python_2/urllib3/util/ssltransport.py     |  221 +
 .../python/python_2/urllib3/util/timeout.py   |  268 +
 .../python/python_2/urllib3/util/url.py       |  432 +
 .../python/python_2/urllib3/util/wait.py      |  153 +
 107 files changed, 65650 insertions(+)
 create mode 100644 openpype/vendor/python/python_2/chardet/__init__.py
 create mode 100644 openpype/vendor/python/python_2/chardet/big5freq.py
 create mode 100644 openpype/vendor/python/python_2/chardet/big5prober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/chardistribution.py
 create mode 100644 openpype/vendor/python/python_2/chardet/charsetgroupprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/charsetprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/cli/__init__.py
 create mode 100644 openpype/vendor/python/python_2/chardet/cli/chardetect.py
 create mode 100644 openpype/vendor/python/python_2/chardet/codingstatemachine.py
 create mode 100644 openpype/vendor/python/python_2/chardet/compat.py
 create mode 100644 openpype/vendor/python/python_2/chardet/cp949prober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/enums.py
 create mode 100644 openpype/vendor/python/python_2/chardet/escprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/escsm.py
 create mode 100644 openpype/vendor/python/python_2/chardet/eucjpprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/euckrfreq.py
 create mode 100644 openpype/vendor/python/python_2/chardet/euckrprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/euctwfreq.py
 create mode 100644 openpype/vendor/python/python_2/chardet/euctwprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/gb2312freq.py
 create mode 100644 openpype/vendor/python/python_2/chardet/gb2312prober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/hebrewprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/jisfreq.py
 create mode 100644 openpype/vendor/python/python_2/chardet/jpcntx.py
 create mode 100644 openpype/vendor/python/python_2/chardet/langbulgarianmodel.py
 create mode 100644 openpype/vendor/python/python_2/chardet/langgreekmodel.py
 create mode 100644 openpype/vendor/python/python_2/chardet/langhebrewmodel.py
 create mode 100644 openpype/vendor/python/python_2/chardet/langhungarianmodel.py
 create mode 100644 openpype/vendor/python/python_2/chardet/langrussianmodel.py
 create mode 100644 openpype/vendor/python/python_2/chardet/langthaimodel.py
 create mode 100644 openpype/vendor/python/python_2/chardet/langturkishmodel.py
 create mode 100644 openpype/vendor/python/python_2/chardet/latin1prober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/mbcharsetprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/mbcsgroupprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/mbcssm.py
 create mode 100644 openpype/vendor/python/python_2/chardet/metadata/__init__.py
 create mode 100644 openpype/vendor/python/python_2/chardet/metadata/languages.py
 create mode 100644 openpype/vendor/python/python_2/chardet/sbcharsetprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/sbcsgroupprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/sjisprober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/universaldetector.py
 create mode 100644 openpype/vendor/python/python_2/chardet/utf8prober.py
 create mode 100644 openpype/vendor/python/python_2/chardet/version.py
 create mode 100644 openpype/vendor/python/python_2/idna/__init__.py
 create mode 100644 openpype/vendor/python/python_2/idna/codec.py
 create mode 100644 openpype/vendor/python/python_2/idna/compat.py
 create mode 100644 openpype/vendor/python/python_2/idna/core.py
 create mode 100644 openpype/vendor/python/python_2/idna/idnadata.py
 create mode 100644 openpype/vendor/python/python_2/idna/intranges.py
 create mode 100644 openpype/vendor/python/python_2/idna/package_data.py
 create mode 100644 openpype/vendor/python/python_2/idna/uts46data.py
 create mode 100644 openpype/vendor/python/python_2/requests/__init__.py
 create mode 100644 openpype/vendor/python/python_2/requests/__version__.py
 create mode 100644 openpype/vendor/python/python_2/requests/_internal_utils.py
 create mode 100644 openpype/vendor/python/python_2/requests/adapters.py
 create mode 100644 openpype/vendor/python/python_2/requests/api.py
 create mode 100644 openpype/vendor/python/python_2/requests/auth.py
 create mode 100644 openpype/vendor/python/python_2/requests/certs.py
 create mode 100644 openpype/vendor/python/python_2/requests/compat.py
 create mode 100644 openpype/vendor/python/python_2/requests/cookies.py
 create mode 100644 openpype/vendor/python/python_2/requests/exceptions.py
 create mode 100644 openpype/vendor/python/python_2/requests/help.py
 create mode 100644 openpype/vendor/python/python_2/requests/hooks.py
 create mode 100644 openpype/vendor/python/python_2/requests/models.py
 create mode 100644 openpype/vendor/python/python_2/requests/packages.py
 create mode 100644 openpype/vendor/python/python_2/requests/sessions.py
 create mode 100644 openpype/vendor/python/python_2/requests/status_codes.py
 create mode 100644 openpype/vendor/python/python_2/requests/structures.py
 create mode 100644 openpype/vendor/python/python_2/requests/utils.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/__init__.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/_collections.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/_version.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/connection.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/connectionpool.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/contrib/__init__.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/contrib/_appengine_environ.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/contrib/_securetransport/__init__.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/contrib/_securetransport/bindings.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/contrib/_securetransport/low_level.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/contrib/appengine.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/contrib/ntlmpool.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/contrib/pyopenssl.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/contrib/securetransport.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/contrib/socks.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/exceptions.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/fields.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/filepost.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/packages/__init__.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/packages/backports/__init__.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/packages/backports/makefile.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/packages/six.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/poolmanager.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/request.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/response.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/__init__.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/connection.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/proxy.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/queue.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/request.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/response.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/retry.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/ssl_.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/ssl_match_hostname.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/ssltransport.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/timeout.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/url.py
 create mode 100644 openpype/vendor/python/python_2/urllib3/util/wait.py

diff --git a/openpype/vendor/python/python_2/chardet/__init__.py b/openpype/vendor/python/python_2/chardet/__init__.py
new file mode 100644
index 0000000000..80ad2546d7
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/__init__.py
@@ -0,0 +1,83 @@
+######################## BEGIN LICENSE BLOCK ########################
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+
+from .universaldetector import UniversalDetector
+from .enums import InputState
+from .version import __version__, VERSION
+
+
+__all__ = ['UniversalDetector', 'detect', 'detect_all', '__version__', 'VERSION']
+
+
+def detect(byte_str):
+    """
+    Detect the encoding of the given byte string.
+
+    :param byte_str:     The byte sequence to examine.
+    :type byte_str:      ``bytes`` or ``bytearray``
+    """
+    if not isinstance(byte_str, bytearray):
+        if not isinstance(byte_str, bytes):
+            raise TypeError('Expected object of type bytes or bytearray, got: '
+                            '{}'.format(type(byte_str)))
+        else:
+            byte_str = bytearray(byte_str)
+    detector = UniversalDetector()
+    detector.feed(byte_str)
+    return detector.close()
+
+
+def detect_all(byte_str):
+    """
+    Detect all the possible encodings of the given byte string.
+
+    :param byte_str:     The byte sequence to examine.
+    :type byte_str:      ``bytes`` or ``bytearray``
+    """
+    if not isinstance(byte_str, bytearray):
+        if not isinstance(byte_str, bytes):
+            raise TypeError('Expected object of type bytes or bytearray, got: '
+                            '{}'.format(type(byte_str)))
+        else:
+            byte_str = bytearray(byte_str)
+
+    detector = UniversalDetector()
+    detector.feed(byte_str)
+    detector.close()
+
+    if detector._input_state == InputState.HIGH_BYTE:
+        results = []
+        for prober in detector._charset_probers:
+            if prober.get_confidence() > detector.MINIMUM_THRESHOLD:
+                charset_name = prober.charset_name
+                lower_charset_name = prober.charset_name.lower()
+                # Use Windows encoding name instead of ISO-8859 if we saw any
+                # extra Windows-specific bytes
+                if lower_charset_name.startswith('iso-8859'):
+                    if detector._has_win_bytes:
+                        charset_name = detector.ISO_WIN_MAP.get(lower_charset_name,
+                                                            charset_name)
+                results.append({
+                    'encoding': charset_name,
+                    'confidence': prober.get_confidence(),
+                    'language': prober.language,
+                })
+        if len(results) > 0:
+            return sorted(results, key=lambda result: -result['confidence'])
+
+    return [detector.result]
diff --git a/openpype/vendor/python/python_2/chardet/big5freq.py b/openpype/vendor/python/python_2/chardet/big5freq.py
new file mode 100644
index 0000000000..38f32517aa
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/big5freq.py
@@ -0,0 +1,386 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# Big5 frequency table
+# by Taiwan's Mandarin Promotion Council
+# <http://www.edu.tw:81/mandr/>
+#
+# 128  --> 0.42261
+# 256  --> 0.57851
+# 512  --> 0.74851
+# 1024 --> 0.89384
+# 2048 --> 0.97583
+#
+# Ideal Distribution Ratio = 0.74851/(1-0.74851) =2.98
+# Random Distribution Ration = 512/(5401-512)=0.105
+#
+# Typical Distribution Ratio about 25% of Ideal one, still much higher than RDR
+
+BIG5_TYPICAL_DISTRIBUTION_RATIO = 0.75
+
+#Char to FreqOrder table
+BIG5_TABLE_SIZE = 5376
+
+BIG5_CHAR_TO_FREQ_ORDER = (
+   1,1801,1506, 255,1431, 198,   9,  82,   6,5008, 177, 202,3681,1256,2821, 110, #   16
+3814,  33,3274, 261,  76,  44,2114,  16,2946,2187,1176, 659,3971,  26,3451,2653, #   32
+1198,3972,3350,4202, 410,2215, 302, 590, 361,1964,   8, 204,  58,4510,5009,1932, #   48
+  63,5010,5011, 317,1614,  75, 222, 159,4203,2417,1480,5012,3555,3091, 224,2822, #   64
+3682,   3,  10,3973,1471,  29,2787,1135,2866,1940, 873, 130,3275,1123, 312,5013, #   80
+4511,2052, 507, 252, 682,5014, 142,1915, 124, 206,2947,  34,3556,3204,  64, 604, #   96
+5015,2501,1977,1978, 155,1991, 645, 641,1606,5016,3452, 337,  72, 406,5017,  80, #  112
+ 630, 238,3205,1509, 263, 939,1092,2654, 756,1440,1094,3453, 449,  69,2987, 591, #  128
+ 179,2096, 471, 115,2035,1844,  60,  50,2988, 134, 806,1869, 734,2036,3454, 180, #  144
+ 995,1607, 156, 537,2907, 688,5018, 319,1305, 779,2145, 514,2379, 298,4512, 359, #  160
+2502,  90,2716,1338, 663,  11, 906,1099,2553,  20,2441, 182, 532,1716,5019, 732, #  176
+1376,4204,1311,1420,3206,  25,2317,1056, 113, 399, 382,1950, 242,3455,2474, 529, #  192
+3276, 475,1447,3683,5020, 117,  21, 656, 810,1297,2300,2334,3557,5021, 126,4205, #  208
+ 706, 456, 150, 613,4513,  71,1118,2037,4206, 145,3092,  85, 835, 486,2115,1246, #  224
+1426, 428, 727,1285,1015, 800, 106, 623, 303,1281,5022,2128,2359, 347,3815, 221, #  240
+3558,3135,5023,1956,1153,4207,  83, 296,1199,3093, 192, 624,  93,5024, 822,1898, #  256
+2823,3136, 795,2065, 991,1554,1542,1592,  27,  43,2867, 859, 139,1456, 860,4514, #  272
+ 437, 712,3974, 164,2397,3137, 695, 211,3037,2097, 195,3975,1608,3559,3560,3684, #  288
+3976, 234, 811,2989,2098,3977,2233,1441,3561,1615,2380, 668,2077,1638, 305, 228, #  304
+1664,4515, 467, 415,5025, 262,2099,1593, 239, 108, 300, 200,1033, 512,1247,2078, #  320
+5026,5027,2176,3207,3685,2682, 593, 845,1062,3277,  88,1723,2038,3978,1951, 212, #  336
+ 266, 152, 149, 468,1899,4208,4516,  77, 187,5028,3038,  37,   5,2990,5029,3979, #  352
+5030,5031,  39,2524,4517,2908,3208,2079,  55, 148,  74,4518, 545, 483,1474,1029, #  368
+1665, 217,1870,1531,3138,1104,2655,4209,  24, 172,3562, 900,3980,3563,3564,4519, #  384
+  32,1408,2824,1312, 329, 487,2360,2251,2717, 784,2683,   4,3039,3351,1427,1789, #  400
+ 188, 109, 499,5032,3686,1717,1790, 888,1217,3040,4520,5033,3565,5034,3352,1520, #  416
+3687,3981, 196,1034, 775,5035,5036, 929,1816, 249, 439,  38,5037,1063,5038, 794, #  432
+3982,1435,2301,  46, 178,3278,2066,5039,2381,5040, 214,1709,4521, 804,  35, 707, #  448
+ 324,3688,1601,2554, 140, 459,4210,5041,5042,1365, 839, 272, 978,2262,2580,3456, #  464
+2129,1363,3689,1423, 697, 100,3094,  48,  70,1231, 495,3139,2196,5043,1294,5044, #  480
+2080, 462, 586,1042,3279, 853, 256, 988, 185,2382,3457,1698, 434,1084,5045,3458, #  496
+ 314,2625,2788,4522,2335,2336, 569,2285, 637,1817,2525, 757,1162,1879,1616,3459, #  512
+ 287,1577,2116, 768,4523,1671,2868,3566,2526,1321,3816, 909,2418,5046,4211, 933, #  528
+3817,4212,2053,2361,1222,4524, 765,2419,1322, 786,4525,5047,1920,1462,1677,2909, #  544
+1699,5048,4526,1424,2442,3140,3690,2600,3353,1775,1941,3460,3983,4213, 309,1369, #  560
+1130,2825, 364,2234,1653,1299,3984,3567,3985,3986,2656, 525,1085,3041, 902,2001, #  576
+1475, 964,4527, 421,1845,1415,1057,2286, 940,1364,3141, 376,4528,4529,1381,   7, #  592
+2527, 983,2383, 336,1710,2684,1846, 321,3461, 559,1131,3042,2752,1809,1132,1313, #  608
+ 265,1481,1858,5049, 352,1203,2826,3280, 167,1089, 420,2827, 776, 792,1724,3568, #  624
+4214,2443,3281,5050,4215,5051, 446, 229, 333,2753, 901,3818,1200,1557,4530,2657, #  640
+1921, 395,2754,2685,3819,4216,1836, 125, 916,3209,2626,4531,5052,5053,3820,5054, #  656
+5055,5056,4532,3142,3691,1133,2555,1757,3462,1510,2318,1409,3569,5057,2146, 438, #  672
+2601,2910,2384,3354,1068, 958,3043, 461, 311,2869,2686,4217,1916,3210,4218,1979, #  688
+ 383, 750,2755,2627,4219, 274, 539, 385,1278,1442,5058,1154,1965, 384, 561, 210, #  704
+  98,1295,2556,3570,5059,1711,2420,1482,3463,3987,2911,1257, 129,5060,3821, 642, #  720
+ 523,2789,2790,2658,5061, 141,2235,1333,  68, 176, 441, 876, 907,4220, 603,2602, #  736
+ 710, 171,3464, 404, 549,  18,3143,2398,1410,3692,1666,5062,3571,4533,2912,4534, #  752
+5063,2991, 368,5064, 146, 366,  99, 871,3693,1543, 748, 807,1586,1185,  22,2263, #  768
+ 379,3822,3211,5065,3212, 505,1942,2628,1992,1382,2319,5066, 380,2362, 218, 702, #  784
+1818,1248,3465,3044,3572,3355,3282,5067,2992,3694, 930,3283,3823,5068,  59,5069, #  800
+ 585, 601,4221, 497,3466,1112,1314,4535,1802,5070,1223,1472,2177,5071, 749,1837, #  816
+ 690,1900,3824,1773,3988,1476, 429,1043,1791,2236,2117, 917,4222, 447,1086,1629, #  832
+5072, 556,5073,5074,2021,1654, 844,1090, 105, 550, 966,1758,2828,1008,1783, 686, #  848
+1095,5075,2287, 793,1602,5076,3573,2603,4536,4223,2948,2302,4537,3825, 980,2503, #  864
+ 544, 353, 527,4538, 908,2687,2913,5077, 381,2629,1943,1348,5078,1341,1252, 560, #  880
+3095,5079,3467,2870,5080,2054, 973, 886,2081, 143,4539,5081,5082, 157,3989, 496, #  896
+4224,  57, 840, 540,2039,4540,4541,3468,2118,1445, 970,2264,1748,1966,2082,4225, #  912
+3144,1234,1776,3284,2829,3695, 773,1206,2130,1066,2040,1326,3990,1738,1725,4226, #  928
+ 279,3145,  51,1544,2604, 423,1578,2131,2067, 173,4542,1880,5083,5084,1583, 264, #  944
+ 610,3696,4543,2444, 280, 154,5085,5086,5087,1739, 338,1282,3096, 693,2871,1411, #  960
+1074,3826,2445,5088,4544,5089,5090,1240, 952,2399,5091,2914,1538,2688, 685,1483, #  976
+4227,2475,1436, 953,4228,2055,4545, 671,2400,  79,4229,2446,3285, 608, 567,2689, #  992
+3469,4230,4231,1691, 393,1261,1792,2401,5092,4546,5093,5094,5095,5096,1383,1672, # 1008
+3827,3213,1464, 522,1119, 661,1150, 216, 675,4547,3991,1432,3574, 609,4548,2690, # 1024
+2402,5097,5098,5099,4232,3045,   0,5100,2476, 315, 231,2447, 301,3356,4549,2385, # 1040
+5101, 233,4233,3697,1819,4550,4551,5102,  96,1777,1315,2083,5103, 257,5104,1810, # 1056
+3698,2718,1139,1820,4234,2022,1124,2164,2791,1778,2659,5105,3097, 363,1655,3214, # 1072
+5106,2993,5107,5108,5109,3992,1567,3993, 718, 103,3215, 849,1443, 341,3357,2949, # 1088
+1484,5110,1712, 127,  67, 339,4235,2403, 679,1412, 821,5111,5112, 834, 738, 351, # 1104
+2994,2147, 846, 235,1497,1881, 418,1993,3828,2719, 186,1100,2148,2756,3575,1545, # 1120
+1355,2950,2872,1377, 583,3994,4236,2581,2995,5113,1298,3699,1078,2557,3700,2363, # 1136
+  78,3829,3830, 267,1289,2100,2002,1594,4237, 348, 369,1274,2197,2178,1838,4552, # 1152
+1821,2830,3701,2757,2288,2003,4553,2951,2758, 144,3358, 882,4554,3995,2759,3470, # 1168
+4555,2915,5114,4238,1726, 320,5115,3996,3046, 788,2996,5116,2831,1774,1327,2873, # 1184
+3997,2832,5117,1306,4556,2004,1700,3831,3576,2364,2660, 787,2023, 506, 824,3702, # 1200
+ 534, 323,4557,1044,3359,2024,1901, 946,3471,5118,1779,1500,1678,5119,1882,4558, # 1216
+ 165, 243,4559,3703,2528, 123, 683,4239, 764,4560,  36,3998,1793, 589,2916, 816, # 1232
+ 626,1667,3047,2237,1639,1555,1622,3832,3999,5120,4000,2874,1370,1228,1933, 891, # 1248
+2084,2917, 304,4240,5121, 292,2997,2720,3577, 691,2101,4241,1115,4561, 118, 662, # 1264
+5122, 611,1156, 854,2386,1316,2875,   2, 386, 515,2918,5123,5124,3286, 868,2238, # 1280
+1486, 855,2661, 785,2216,3048,5125,1040,3216,3578,5126,3146, 448,5127,1525,5128, # 1296
+2165,4562,5129,3833,5130,4242,2833,3579,3147, 503, 818,4001,3148,1568, 814, 676, # 1312
+1444, 306,1749,5131,3834,1416,1030, 197,1428, 805,2834,1501,4563,5132,5133,5134, # 1328
+1994,5135,4564,5136,5137,2198,  13,2792,3704,2998,3149,1229,1917,5138,3835,2132, # 1344
+5139,4243,4565,2404,3580,5140,2217,1511,1727,1120,5141,5142, 646,3836,2448, 307, # 1360
+5143,5144,1595,3217,5145,5146,5147,3705,1113,1356,4002,1465,2529,2530,5148, 519, # 1376
+5149, 128,2133,  92,2289,1980,5150,4003,1512, 342,3150,2199,5151,2793,2218,1981, # 1392
+3360,4244, 290,1656,1317, 789, 827,2365,5152,3837,4566, 562, 581,4004,5153, 401, # 1408
+4567,2252,  94,4568,5154,1399,2794,5155,1463,2025,4569,3218,1944,5156, 828,1105, # 1424
+4245,1262,1394,5157,4246, 605,4570,5158,1784,2876,5159,2835, 819,2102, 578,2200, # 1440
+2952,5160,1502, 436,3287,4247,3288,2836,4005,2919,3472,3473,5161,2721,2320,5162, # 1456
+5163,2337,2068,  23,4571, 193, 826,3838,2103, 699,1630,4248,3098, 390,1794,1064, # 1472
+3581,5164,1579,3099,3100,1400,5165,4249,1839,1640,2877,5166,4572,4573, 137,4250, # 1488
+ 598,3101,1967, 780, 104, 974,2953,5167, 278, 899, 253, 402, 572, 504, 493,1339, # 1504
+5168,4006,1275,4574,2582,2558,5169,3706,3049,3102,2253, 565,1334,2722, 863,  41, # 1520
+5170,5171,4575,5172,1657,2338,  19, 463,2760,4251, 606,5173,2999,3289,1087,2085, # 1536
+1323,2662,3000,5174,1631,1623,1750,4252,2691,5175,2878, 791,2723,2663,2339, 232, # 1552
+2421,5176,3001,1498,5177,2664,2630, 755,1366,3707,3290,3151,2026,1609, 119,1918, # 1568
+3474, 862,1026,4253,5178,4007,3839,4576,4008,4577,2265,1952,2477,5179,1125, 817, # 1584
+4254,4255,4009,1513,1766,2041,1487,4256,3050,3291,2837,3840,3152,5180,5181,1507, # 1600
+5182,2692, 733,  40,1632,1106,2879, 345,4257, 841,2531, 230,4578,3002,1847,3292, # 1616
+3475,5183,1263, 986,3476,5184, 735, 879, 254,1137, 857, 622,1300,1180,1388,1562, # 1632
+4010,4011,2954, 967,2761,2665,1349, 592,2134,1692,3361,3003,1995,4258,1679,4012, # 1648
+1902,2188,5185, 739,3708,2724,1296,1290,5186,4259,2201,2202,1922,1563,2605,2559, # 1664
+1871,2762,3004,5187, 435,5188, 343,1108, 596,  17,1751,4579,2239,3477,3709,5189, # 1680
+4580, 294,3582,2955,1693, 477, 979, 281,2042,3583, 643,2043,3710,2631,2795,2266, # 1696
+1031,2340,2135,2303,3584,4581, 367,1249,2560,5190,3585,5191,4582,1283,3362,2005, # 1712
+ 240,1762,3363,4583,4584, 836,1069,3153, 474,5192,2149,2532, 268,3586,5193,3219, # 1728
+1521,1284,5194,1658,1546,4260,5195,3587,3588,5196,4261,3364,2693,1685,4262, 961, # 1744
+1673,2632, 190,2006,2203,3841,4585,4586,5197, 570,2504,3711,1490,5198,4587,2633, # 1760
+3293,1957,4588, 584,1514, 396,1045,1945,5199,4589,1968,2449,5200,5201,4590,4013, # 1776
+ 619,5202,3154,3294, 215,2007,2796,2561,3220,4591,3221,4592, 763,4263,3842,4593, # 1792
+5203,5204,1958,1767,2956,3365,3712,1174, 452,1477,4594,3366,3155,5205,2838,1253, # 1808
+2387,2189,1091,2290,4264, 492,5206, 638,1169,1825,2136,1752,4014, 648, 926,1021, # 1824
+1324,4595, 520,4596, 997, 847,1007, 892,4597,3843,2267,1872,3713,2405,1785,4598, # 1840
+1953,2957,3103,3222,1728,4265,2044,3714,4599,2008,1701,3156,1551,  30,2268,4266, # 1856
+5207,2027,4600,3589,5208, 501,5209,4267, 594,3478,2166,1822,3590,3479,3591,3223, # 1872
+ 829,2839,4268,5210,1680,3157,1225,4269,5211,3295,4601,4270,3158,2341,5212,4602, # 1888
+4271,5213,4015,4016,5214,1848,2388,2606,3367,5215,4603, 374,4017, 652,4272,4273, # 1904
+ 375,1140, 798,5216,5217,5218,2366,4604,2269, 546,1659, 138,3051,2450,4605,5219, # 1920
+2254, 612,1849, 910, 796,3844,1740,1371, 825,3845,3846,5220,2920,2562,5221, 692, # 1936
+ 444,3052,2634, 801,4606,4274,5222,1491, 244,1053,3053,4275,4276, 340,5223,4018, # 1952
+1041,3005, 293,1168,  87,1357,5224,1539, 959,5225,2240, 721, 694,4277,3847, 219, # 1968
+1478, 644,1417,3368,2666,1413,1401,1335,1389,4019,5226,5227,3006,2367,3159,1826, # 1984
+ 730,1515, 184,2840,  66,4607,5228,1660,2958, 246,3369, 378,1457, 226,3480, 975, # 2000
+4020,2959,1264,3592, 674, 696,5229, 163,5230,1141,2422,2167, 713,3593,3370,4608, # 2016
+4021,5231,5232,1186,  15,5233,1079,1070,5234,1522,3224,3594, 276,1050,2725, 758, # 2032
+1126, 653,2960,3296,5235,2342, 889,3595,4022,3104,3007, 903,1250,4609,4023,3481, # 2048
+3596,1342,1681,1718, 766,3297, 286,  89,2961,3715,5236,1713,5237,2607,3371,3008, # 2064
+5238,2962,2219,3225,2880,5239,4610,2505,2533, 181, 387,1075,4024, 731,2190,3372, # 2080
+5240,3298, 310, 313,3482,2304, 770,4278,  54,3054, 189,4611,3105,3848,4025,5241, # 2096
+1230,1617,1850, 355,3597,4279,4612,3373, 111,4280,3716,1350,3160,3483,3055,4281, # 2112
+2150,3299,3598,5242,2797,4026,4027,3009, 722,2009,5243,1071, 247,1207,2343,2478, # 2128
+1378,4613,2010, 864,1437,1214,4614, 373,3849,1142,2220, 667,4615, 442,2763,2563, # 2144
+3850,4028,1969,4282,3300,1840, 837, 170,1107, 934,1336,1883,5244,5245,2119,4283, # 2160
+2841, 743,1569,5246,4616,4284, 582,2389,1418,3484,5247,1803,5248, 357,1395,1729, # 2176
+3717,3301,2423,1564,2241,5249,3106,3851,1633,4617,1114,2086,4285,1532,5250, 482, # 2192
+2451,4618,5251,5252,1492, 833,1466,5253,2726,3599,1641,2842,5254,1526,1272,3718, # 2208
+4286,1686,1795, 416,2564,1903,1954,1804,5255,3852,2798,3853,1159,2321,5256,2881, # 2224
+4619,1610,1584,3056,2424,2764, 443,3302,1163,3161,5257,5258,4029,5259,4287,2506, # 2240
+3057,4620,4030,3162,2104,1647,3600,2011,1873,4288,5260,4289, 431,3485,5261, 250, # 2256
+  97,  81,4290,5262,1648,1851,1558, 160, 848,5263, 866, 740,1694,5264,2204,2843, # 2272
+3226,4291,4621,3719,1687, 950,2479, 426, 469,3227,3720,3721,4031,5265,5266,1188, # 2288
+ 424,1996, 861,3601,4292,3854,2205,2694, 168,1235,3602,4293,5267,2087,1674,4622, # 2304
+3374,3303, 220,2565,1009,5268,3855, 670,3010, 332,1208, 717,5269,5270,3603,2452, # 2320
+4032,3375,5271, 513,5272,1209,2882,3376,3163,4623,1080,5273,5274,5275,5276,2534, # 2336
+3722,3604, 815,1587,4033,4034,5277,3605,3486,3856,1254,4624,1328,3058,1390,4035, # 2352
+1741,4036,3857,4037,5278, 236,3858,2453,3304,5279,5280,3723,3859,1273,3860,4625, # 2368
+5281, 308,5282,4626, 245,4627,1852,2480,1307,2583, 430, 715,2137,2454,5283, 270, # 2384
+ 199,2883,4038,5284,3606,2727,1753, 761,1754, 725,1661,1841,4628,3487,3724,5285, # 2400
+5286, 587,  14,3305, 227,2608, 326, 480,2270, 943,2765,3607, 291, 650,1884,5287, # 2416
+1702,1226, 102,1547,  62,3488, 904,4629,3489,1164,4294,5288,5289,1224,1548,2766, # 2432
+ 391, 498,1493,5290,1386,1419,5291,2056,1177,4630, 813, 880,1081,2368, 566,1145, # 2448
+4631,2291,1001,1035,2566,2609,2242, 394,1286,5292,5293,2069,5294,  86,1494,1730, # 2464
+4039, 491,1588, 745, 897,2963, 843,3377,4040,2767,2884,3306,1768, 998,2221,2070, # 2480
+ 397,1827,1195,1970,3725,3011,3378, 284,5295,3861,2507,2138,2120,1904,5296,4041, # 2496
+2151,4042,4295,1036,3490,1905, 114,2567,4296, 209,1527,5297,5298,2964,2844,2635, # 2512
+2390,2728,3164, 812,2568,5299,3307,5300,1559, 737,1885,3726,1210, 885,  28,2695, # 2528
+3608,3862,5301,4297,1004,1780,4632,5302, 346,1982,2222,2696,4633,3863,1742, 797, # 2544
+1642,4043,1934,1072,1384,2152, 896,4044,3308,3727,3228,2885,3609,5303,2569,1959, # 2560
+4634,2455,1786,5304,5305,5306,4045,4298,1005,1308,3728,4299,2729,4635,4636,1528, # 2576
+2610, 161,1178,4300,1983, 987,4637,1101,4301, 631,4046,1157,3229,2425,1343,1241, # 2592
+1016,2243,2570, 372, 877,2344,2508,1160, 555,1935, 911,4047,5307, 466,1170, 169, # 2608
+1051,2921,2697,3729,2481,3012,1182,2012,2571,1251,2636,5308, 992,2345,3491,1540, # 2624
+2730,1201,2071,2406,1997,2482,5309,4638, 528,1923,2191,1503,1874,1570,2369,3379, # 2640
+3309,5310, 557,1073,5311,1828,3492,2088,2271,3165,3059,3107, 767,3108,2799,4639, # 2656
+1006,4302,4640,2346,1267,2179,3730,3230, 778,4048,3231,2731,1597,2667,5312,4641, # 2672
+5313,3493,5314,5315,5316,3310,2698,1433,3311, 131,  95,1504,4049, 723,4303,3166, # 2688
+1842,3610,2768,2192,4050,2028,2105,3731,5317,3013,4051,1218,5318,3380,3232,4052, # 2704
+4304,2584, 248,1634,3864, 912,5319,2845,3732,3060,3865, 654,  53,5320,3014,5321, # 2720
+1688,4642, 777,3494,1032,4053,1425,5322, 191, 820,2121,2846, 971,4643, 931,3233, # 2736
+ 135, 664, 783,3866,1998, 772,2922,1936,4054,3867,4644,2923,3234, 282,2732, 640, # 2752
+1372,3495,1127, 922, 325,3381,5323,5324, 711,2045,5325,5326,4055,2223,2800,1937, # 2768
+4056,3382,2224,2255,3868,2305,5327,4645,3869,1258,3312,4057,3235,2139,2965,4058, # 2784
+4059,5328,2225, 258,3236,4646, 101,1227,5329,3313,1755,5330,1391,3314,5331,2924, # 2800
+2057, 893,5332,5333,5334,1402,4305,2347,5335,5336,3237,3611,5337,5338, 878,1325, # 2816
+1781,2801,4647, 259,1385,2585, 744,1183,2272,4648,5339,4060,2509,5340, 684,1024, # 2832
+4306,5341, 472,3612,3496,1165,3315,4061,4062, 322,2153, 881, 455,1695,1152,1340, # 2848
+ 660, 554,2154,4649,1058,4650,4307, 830,1065,3383,4063,4651,1924,5342,1703,1919, # 2864
+5343, 932,2273, 122,5344,4652, 947, 677,5345,3870,2637, 297,1906,1925,2274,4653, # 2880
+2322,3316,5346,5347,4308,5348,4309,  84,4310, 112, 989,5349, 547,1059,4064, 701, # 2896
+3613,1019,5350,4311,5351,3497, 942, 639, 457,2306,2456, 993,2966, 407, 851, 494, # 2912
+4654,3384, 927,5352,1237,5353,2426,3385, 573,4312, 680, 921,2925,1279,1875, 285, # 2928
+ 790,1448,1984, 719,2168,5354,5355,4655,4065,4066,1649,5356,1541, 563,5357,1077, # 2944
+5358,3386,3061,3498, 511,3015,4067,4068,3733,4069,1268,2572,3387,3238,4656,4657, # 2960
+5359, 535,1048,1276,1189,2926,2029,3167,1438,1373,2847,2967,1134,2013,5360,4313, # 2976
+1238,2586,3109,1259,5361, 700,5362,2968,3168,3734,4314,5363,4315,1146,1876,1907, # 2992
+4658,2611,4070, 781,2427, 132,1589, 203, 147, 273,2802,2407, 898,1787,2155,4071, # 3008
+4072,5364,3871,2803,5365,5366,4659,4660,5367,3239,5368,1635,3872, 965,5369,1805, # 3024
+2699,1516,3614,1121,1082,1329,3317,4073,1449,3873,  65,1128,2848,2927,2769,1590, # 3040
+3874,5370,5371,  12,2668,  45, 976,2587,3169,4661, 517,2535,1013,1037,3240,5372, # 3056
+3875,2849,5373,3876,5374,3499,5375,2612, 614,1999,2323,3877,3110,2733,2638,5376, # 3072
+2588,4316, 599,1269,5377,1811,3735,5378,2700,3111, 759,1060, 489,1806,3388,3318, # 3088
+1358,5379,5380,2391,1387,1215,2639,2256, 490,5381,5382,4317,1759,2392,2348,5383, # 3104
+4662,3878,1908,4074,2640,1807,3241,4663,3500,3319,2770,2349, 874,5384,5385,3501, # 3120
+3736,1859,  91,2928,3737,3062,3879,4664,5386,3170,4075,2669,5387,3502,1202,1403, # 3136
+3880,2969,2536,1517,2510,4665,3503,2511,5388,4666,5389,2701,1886,1495,1731,4076, # 3152
+2370,4667,5390,2030,5391,5392,4077,2702,1216, 237,2589,4318,2324,4078,3881,4668, # 3168
+4669,2703,3615,3504, 445,4670,5393,5394,5395,5396,2771,  61,4079,3738,1823,4080, # 3184
+5397, 687,2046, 935, 925, 405,2670, 703,1096,1860,2734,4671,4081,1877,1367,2704, # 3200
+3389, 918,2106,1782,2483, 334,3320,1611,1093,4672, 564,3171,3505,3739,3390, 945, # 3216
+2641,2058,4673,5398,1926, 872,4319,5399,3506,2705,3112, 349,4320,3740,4082,4674, # 3232
+3882,4321,3741,2156,4083,4675,4676,4322,4677,2408,2047, 782,4084, 400, 251,4323, # 3248
+1624,5400,5401, 277,3742, 299,1265, 476,1191,3883,2122,4324,4325,1109, 205,5402, # 3264
+2590,1000,2157,3616,1861,5403,5404,5405,4678,5406,4679,2573, 107,2484,2158,4085, # 3280
+3507,3172,5407,1533, 541,1301, 158, 753,4326,2886,3617,5408,1696, 370,1088,4327, # 3296
+4680,3618, 579, 327, 440, 162,2244, 269,1938,1374,3508, 968,3063,  56,1396,3113, # 3312
+2107,3321,3391,5409,1927,2159,4681,3016,5410,3619,5411,5412,3743,4682,2485,5413, # 3328
+2804,5414,1650,4683,5415,2613,5416,5417,4086,2671,3392,1149,3393,4087,3884,4088, # 3344
+5418,1076,  49,5419, 951,3242,3322,3323, 450,2850, 920,5420,1812,2805,2371,4328, # 3360
+1909,1138,2372,3885,3509,5421,3243,4684,1910,1147,1518,2428,4685,3886,5422,4686, # 3376
+2393,2614, 260,1796,3244,5423,5424,3887,3324, 708,5425,3620,1704,5426,3621,1351, # 3392
+1618,3394,3017,1887, 944,4329,3395,4330,3064,3396,4331,5427,3744, 422, 413,1714, # 3408
+3325, 500,2059,2350,4332,2486,5428,1344,1911, 954,5429,1668,5430,5431,4089,2409, # 3424
+4333,3622,3888,4334,5432,2307,1318,2512,3114, 133,3115,2887,4687, 629,  31,2851, # 3440
+2706,3889,4688, 850, 949,4689,4090,2970,1732,2089,4335,1496,1853,5433,4091, 620, # 3456
+3245, 981,1242,3745,3397,1619,3746,1643,3326,2140,2457,1971,1719,3510,2169,5434, # 3472
+3246,5435,5436,3398,1829,5437,1277,4690,1565,2048,5438,1636,3623,3116,5439, 869, # 3488
+2852, 655,3890,3891,3117,4092,3018,3892,1310,3624,4691,5440,5441,5442,1733, 558, # 3504
+4692,3747, 335,1549,3065,1756,4336,3748,1946,3511,1830,1291,1192, 470,2735,2108, # 3520
+2806, 913,1054,4093,5443,1027,5444,3066,4094,4693, 982,2672,3399,3173,3512,3247, # 3536
+3248,1947,2807,5445, 571,4694,5446,1831,5447,3625,2591,1523,2429,5448,2090, 984, # 3552
+4695,3749,1960,5449,3750, 852, 923,2808,3513,3751, 969,1519, 999,2049,2325,1705, # 3568
+5450,3118, 615,1662, 151, 597,4095,2410,2326,1049, 275,4696,3752,4337, 568,3753, # 3584
+3626,2487,4338,3754,5451,2430,2275, 409,3249,5452,1566,2888,3514,1002, 769,2853, # 3600
+ 194,2091,3174,3755,2226,3327,4339, 628,1505,5453,5454,1763,2180,3019,4096, 521, # 3616
+1161,2592,1788,2206,2411,4697,4097,1625,4340,4341, 412,  42,3119, 464,5455,2642, # 3632
+4698,3400,1760,1571,2889,3515,2537,1219,2207,3893,2643,2141,2373,4699,4700,3328, # 3648
+1651,3401,3627,5456,5457,3628,2488,3516,5458,3756,5459,5460,2276,2092, 460,5461, # 3664
+4701,5462,3020, 962, 588,3629, 289,3250,2644,1116,  52,5463,3067,1797,5464,5465, # 3680
+5466,1467,5467,1598,1143,3757,4342,1985,1734,1067,4702,1280,3402, 465,4703,1572, # 3696
+ 510,5468,1928,2245,1813,1644,3630,5469,4704,3758,5470,5471,2673,1573,1534,5472, # 3712
+5473, 536,1808,1761,3517,3894,3175,2645,5474,5475,5476,4705,3518,2929,1912,2809, # 3728
+5477,3329,1122, 377,3251,5478, 360,5479,5480,4343,1529, 551,5481,2060,3759,1769, # 3744
+2431,5482,2930,4344,3330,3120,2327,2109,2031,4706,1404, 136,1468,1479, 672,1171, # 3760
+3252,2308, 271,3176,5483,2772,5484,2050, 678,2736, 865,1948,4707,5485,2014,4098, # 3776
+2971,5486,2737,2227,1397,3068,3760,4708,4709,1735,2931,3403,3631,5487,3895, 509, # 3792
+2854,2458,2890,3896,5488,5489,3177,3178,4710,4345,2538,4711,2309,1166,1010, 552, # 3808
+ 681,1888,5490,5491,2972,2973,4099,1287,1596,1862,3179, 358, 453, 736, 175, 478, # 3824
+1117, 905,1167,1097,5492,1854,1530,5493,1706,5494,2181,3519,2292,3761,3520,3632, # 3840
+4346,2093,4347,5495,3404,1193,2489,4348,1458,2193,2208,1863,1889,1421,3331,2932, # 3856
+3069,2182,3521, 595,2123,5496,4100,5497,5498,4349,1707,2646, 223,3762,1359, 751, # 3872
+3121, 183,3522,5499,2810,3021, 419,2374, 633, 704,3897,2394, 241,5500,5501,5502, # 3888
+ 838,3022,3763,2277,2773,2459,3898,1939,2051,4101,1309,3122,2246,1181,5503,1136, # 3904
+2209,3899,2375,1446,4350,2310,4712,5504,5505,4351,1055,2615, 484,3764,5506,4102, # 3920
+ 625,4352,2278,3405,1499,4353,4103,5507,4104,4354,3253,2279,2280,3523,5508,5509, # 3936
+2774, 808,2616,3765,3406,4105,4355,3123,2539, 526,3407,3900,4356, 955,5510,1620, # 3952
+4357,2647,2432,5511,1429,3766,1669,1832, 994, 928,5512,3633,1260,5513,5514,5515, # 3968
+1949,2293, 741,2933,1626,4358,2738,2460, 867,1184, 362,3408,1392,5516,5517,4106, # 3984
+4359,1770,1736,3254,2934,4713,4714,1929,2707,1459,1158,5518,3070,3409,2891,1292, # 4000
+1930,2513,2855,3767,1986,1187,2072,2015,2617,4360,5519,2574,2514,2170,3768,2490, # 4016
+3332,5520,3769,4715,5521,5522, 666,1003,3023,1022,3634,4361,5523,4716,1814,2257, # 4032
+ 574,3901,1603, 295,1535, 705,3902,4362, 283, 858, 417,5524,5525,3255,4717,4718, # 4048
+3071,1220,1890,1046,2281,2461,4107,1393,1599, 689,2575, 388,4363,5526,2491, 802, # 4064
+5527,2811,3903,2061,1405,2258,5528,4719,3904,2110,1052,1345,3256,1585,5529, 809, # 4080
+5530,5531,5532, 575,2739,3524, 956,1552,1469,1144,2328,5533,2329,1560,2462,3635, # 4096
+3257,4108, 616,2210,4364,3180,2183,2294,5534,1833,5535,3525,4720,5536,1319,3770, # 4112
+3771,1211,3636,1023,3258,1293,2812,5537,5538,5539,3905, 607,2311,3906, 762,2892, # 4128
+1439,4365,1360,4721,1485,3072,5540,4722,1038,4366,1450,2062,2648,4367,1379,4723, # 4144
+2593,5541,5542,4368,1352,1414,2330,2935,1172,5543,5544,3907,3908,4724,1798,1451, # 4160
+5545,5546,5547,5548,2936,4109,4110,2492,2351, 411,4111,4112,3637,3333,3124,4725, # 4176
+1561,2674,1452,4113,1375,5549,5550,  47,2974, 316,5551,1406,1591,2937,3181,5552, # 4192
+1025,2142,3125,3182, 354,2740, 884,2228,4369,2412, 508,3772, 726,3638, 996,2433, # 4208
+3639, 729,5553, 392,2194,1453,4114,4726,3773,5554,5555,2463,3640,2618,1675,2813, # 4224
+ 919,2352,2975,2353,1270,4727,4115,  73,5556,5557, 647,5558,3259,2856,2259,1550, # 4240
+1346,3024,5559,1332, 883,3526,5560,5561,5562,5563,3334,2775,5564,1212, 831,1347, # 4256
+4370,4728,2331,3909,1864,3073, 720,3910,4729,4730,3911,5565,4371,5566,5567,4731, # 4272
+5568,5569,1799,4732,3774,2619,4733,3641,1645,2376,4734,5570,2938, 669,2211,2675, # 4288
+2434,5571,2893,5572,5573,1028,3260,5574,4372,2413,5575,2260,1353,5576,5577,4735, # 4304
+3183, 518,5578,4116,5579,4373,1961,5580,2143,4374,5581,5582,3025,2354,2355,3912, # 4320
+ 516,1834,1454,4117,2708,4375,4736,2229,2620,1972,1129,3642,5583,2776,5584,2976, # 4336
+1422, 577,1470,3026,1524,3410,5585,5586, 432,4376,3074,3527,5587,2594,1455,2515, # 4352
+2230,1973,1175,5588,1020,2741,4118,3528,4737,5589,2742,5590,1743,1361,3075,3529, # 4368
+2649,4119,4377,4738,2295, 895, 924,4378,2171, 331,2247,3076, 166,1627,3077,1098, # 4384
+5591,1232,2894,2231,3411,4739, 657, 403,1196,2377, 542,3775,3412,1600,4379,3530, # 4400
+5592,4740,2777,3261, 576, 530,1362,4741,4742,2540,2676,3776,4120,5593, 842,3913, # 4416
+5594,2814,2032,1014,4121, 213,2709,3413, 665, 621,4380,5595,3777,2939,2435,5596, # 4432
+2436,3335,3643,3414,4743,4381,2541,4382,4744,3644,1682,4383,3531,1380,5597, 724, # 4448
+2282, 600,1670,5598,1337,1233,4745,3126,2248,5599,1621,4746,5600, 651,4384,5601, # 4464
+1612,4385,2621,5602,2857,5603,2743,2312,3078,5604, 716,2464,3079, 174,1255,2710, # 4480
+4122,3645, 548,1320,1398, 728,4123,1574,5605,1891,1197,3080,4124,5606,3081,3082, # 4496
+3778,3646,3779, 747,5607, 635,4386,4747,5608,5609,5610,4387,5611,5612,4748,5613, # 4512
+3415,4749,2437, 451,5614,3780,2542,2073,4388,2744,4389,4125,5615,1764,4750,5616, # 4528
+4390, 350,4751,2283,2395,2493,5617,4391,4126,2249,1434,4127, 488,4752, 458,4392, # 4544
+4128,3781, 771,1330,2396,3914,2576,3184,2160,2414,1553,2677,3185,4393,5618,2494, # 4560
+2895,2622,1720,2711,4394,3416,4753,5619,2543,4395,5620,3262,4396,2778,5621,2016, # 4576
+2745,5622,1155,1017,3782,3915,5623,3336,2313, 201,1865,4397,1430,5624,4129,5625, # 4592
+5626,5627,5628,5629,4398,1604,5630, 414,1866, 371,2595,4754,4755,3532,2017,3127, # 4608
+4756,1708, 960,4399, 887, 389,2172,1536,1663,1721,5631,2232,4130,2356,2940,1580, # 4624
+5632,5633,1744,4757,2544,4758,4759,5634,4760,5635,2074,5636,4761,3647,3417,2896, # 4640
+4400,5637,4401,2650,3418,2815, 673,2712,2465, 709,3533,4131,3648,4402,5638,1148, # 4656
+ 502, 634,5639,5640,1204,4762,3649,1575,4763,2623,3783,5641,3784,3128, 948,3263, # 4672
+ 121,1745,3916,1110,5642,4403,3083,2516,3027,4132,3785,1151,1771,3917,1488,4133, # 4688
+1987,5643,2438,3534,5644,5645,2094,5646,4404,3918,1213,1407,2816, 531,2746,2545, # 4704
+3264,1011,1537,4764,2779,4405,3129,1061,5647,3786,3787,1867,2897,5648,2018, 120, # 4720
+4406,4407,2063,3650,3265,2314,3919,2678,3419,1955,4765,4134,5649,3535,1047,2713, # 4736
+1266,5650,1368,4766,2858, 649,3420,3920,2546,2747,1102,2859,2679,5651,5652,2000, # 4752
+5653,1111,3651,2977,5654,2495,3921,3652,2817,1855,3421,3788,5655,5656,3422,2415, # 4768
+2898,3337,3266,3653,5657,2577,5658,3654,2818,4135,1460, 856,5659,3655,5660,2899, # 4784
+2978,5661,2900,3922,5662,4408, 632,2517, 875,3923,1697,3924,2296,5663,5664,4767, # 4800
+3028,1239, 580,4768,4409,5665, 914, 936,2075,1190,4136,1039,2124,5666,5667,5668, # 4816
+5669,3423,1473,5670,1354,4410,3925,4769,2173,3084,4137, 915,3338,4411,4412,3339, # 4832
+1605,1835,5671,2748, 398,3656,4413,3926,4138, 328,1913,2860,4139,3927,1331,4414, # 4848
+3029, 937,4415,5672,3657,4140,4141,3424,2161,4770,3425, 524, 742, 538,3085,1012, # 4864
+5673,5674,3928,2466,5675, 658,1103, 225,3929,5676,5677,4771,5678,4772,5679,3267, # 4880
+1243,5680,4142, 963,2250,4773,5681,2714,3658,3186,5682,5683,2596,2332,5684,4774, # 4896
+5685,5686,5687,3536, 957,3426,2547,2033,1931,2941,2467, 870,2019,3659,1746,2780, # 4912
+2781,2439,2468,5688,3930,5689,3789,3130,3790,3537,3427,3791,5690,1179,3086,5691, # 4928
+3187,2378,4416,3792,2548,3188,3131,2749,4143,5692,3428,1556,2549,2297, 977,2901, # 4944
+2034,4144,1205,3429,5693,1765,3430,3189,2125,1271, 714,1689,4775,3538,5694,2333, # 4960
+3931, 533,4417,3660,2184, 617,5695,2469,3340,3539,2315,5696,5697,3190,5698,5699, # 4976
+3932,1988, 618, 427,2651,3540,3431,5700,5701,1244,1690,5702,2819,4418,4776,5703, # 4992
+3541,4777,5704,2284,1576, 473,3661,4419,3432, 972,5705,3662,5706,3087,5707,5708, # 5008
+4778,4779,5709,3793,4145,4146,5710, 153,4780, 356,5711,1892,2902,4420,2144, 408, # 5024
+ 803,2357,5712,3933,5713,4421,1646,2578,2518,4781,4782,3934,5714,3935,4422,5715, # 5040
+2416,3433, 752,5716,5717,1962,3341,2979,5718, 746,3030,2470,4783,4423,3794, 698, # 5056
+4784,1893,4424,3663,2550,4785,3664,3936,5719,3191,3434,5720,1824,1302,4147,2715, # 5072
+3937,1974,4425,5721,4426,3192, 823,1303,1288,1236,2861,3542,4148,3435, 774,3938, # 5088
+5722,1581,4786,1304,2862,3939,4787,5723,2440,2162,1083,3268,4427,4149,4428, 344, # 5104
+1173, 288,2316, 454,1683,5724,5725,1461,4788,4150,2597,5726,5727,4789, 985, 894, # 5120
+5728,3436,3193,5729,1914,2942,3795,1989,5730,2111,1975,5731,4151,5732,2579,1194, # 5136
+ 425,5733,4790,3194,1245,3796,4429,5734,5735,2863,5736, 636,4791,1856,3940, 760, # 5152
+1800,5737,4430,2212,1508,4792,4152,1894,1684,2298,5738,5739,4793,4431,4432,2213, # 5168
+ 479,5740,5741, 832,5742,4153,2496,5743,2980,2497,3797, 990,3132, 627,1815,2652, # 5184
+4433,1582,4434,2126,2112,3543,4794,5744, 799,4435,3195,5745,4795,2113,1737,3031, # 5200
+1018, 543, 754,4436,3342,1676,4796,4797,4154,4798,1489,5746,3544,5747,2624,2903, # 5216
+4155,5748,5749,2981,5750,5751,5752,5753,3196,4799,4800,2185,1722,5754,3269,3270, # 5232
+1843,3665,1715, 481, 365,1976,1857,5755,5756,1963,2498,4801,5757,2127,3666,3271, # 5248
+ 433,1895,2064,2076,5758, 602,2750,5759,5760,5761,5762,5763,3032,1628,3437,5764, # 5264
+3197,4802,4156,2904,4803,2519,5765,2551,2782,5766,5767,5768,3343,4804,2905,5769, # 5280
+4805,5770,2864,4806,4807,1221,2982,4157,2520,5771,5772,5773,1868,1990,5774,5775, # 5296
+5776,1896,5777,5778,4808,1897,4158, 318,5779,2095,4159,4437,5780,5781, 485,5782, # 5312
+ 938,3941, 553,2680, 116,5783,3942,3667,5784,3545,2681,2783,3438,3344,2820,5785, # 5328
+3668,2943,4160,1747,2944,2983,5786,5787, 207,5788,4809,5789,4810,2521,5790,3033, # 5344
+ 890,3669,3943,5791,1878,3798,3439,5792,2186,2358,3440,1652,5793,5794,5795, 941, # 5360
+2299, 208,3546,4161,2020, 330,4438,3944,2906,2499,3799,4439,4811,5796,5797,5798, # 5376
+)
+
diff --git a/openpype/vendor/python/python_2/chardet/big5prober.py b/openpype/vendor/python/python_2/chardet/big5prober.py
new file mode 100644
index 0000000000..98f9970122
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/big5prober.py
@@ -0,0 +1,47 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import Big5DistributionAnalysis
+from .mbcssm import BIG5_SM_MODEL
+
+
+class Big5Prober(MultiByteCharSetProber):
+    def __init__(self):
+        super(Big5Prober, self).__init__()
+        self.coding_sm = CodingStateMachine(BIG5_SM_MODEL)
+        self.distribution_analyzer = Big5DistributionAnalysis()
+        self.reset()
+
+    @property
+    def charset_name(self):
+        return "Big5"
+
+    @property
+    def language(self):
+        return "Chinese"
diff --git a/openpype/vendor/python/python_2/chardet/chardistribution.py b/openpype/vendor/python/python_2/chardet/chardistribution.py
new file mode 100644
index 0000000000..c0395f4a45
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/chardistribution.py
@@ -0,0 +1,233 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .euctwfreq import (EUCTW_CHAR_TO_FREQ_ORDER, EUCTW_TABLE_SIZE,
+                        EUCTW_TYPICAL_DISTRIBUTION_RATIO)
+from .euckrfreq import (EUCKR_CHAR_TO_FREQ_ORDER, EUCKR_TABLE_SIZE,
+                        EUCKR_TYPICAL_DISTRIBUTION_RATIO)
+from .gb2312freq import (GB2312_CHAR_TO_FREQ_ORDER, GB2312_TABLE_SIZE,
+                         GB2312_TYPICAL_DISTRIBUTION_RATIO)
+from .big5freq import (BIG5_CHAR_TO_FREQ_ORDER, BIG5_TABLE_SIZE,
+                       BIG5_TYPICAL_DISTRIBUTION_RATIO)
+from .jisfreq import (JIS_CHAR_TO_FREQ_ORDER, JIS_TABLE_SIZE,
+                      JIS_TYPICAL_DISTRIBUTION_RATIO)
+
+
+class CharDistributionAnalysis(object):
+    ENOUGH_DATA_THRESHOLD = 1024
+    SURE_YES = 0.99
+    SURE_NO = 0.01
+    MINIMUM_DATA_THRESHOLD = 3
+
+    def __init__(self):
+        # Mapping table to get frequency order from char order (get from
+        # GetOrder())
+        self._char_to_freq_order = None
+        self._table_size = None  # Size of above table
+        # This is a constant value which varies from language to language,
+        # used in calculating confidence.  See
+        # http://www.mozilla.org/projects/intl/UniversalCharsetDetection.html
+        # for further detail.
+        self.typical_distribution_ratio = None
+        self._done = None
+        self._total_chars = None
+        self._freq_chars = None
+        self.reset()
+
+    def reset(self):
+        """reset analyser, clear any state"""
+        # If this flag is set to True, detection is done and conclusion has
+        # been made
+        self._done = False
+        self._total_chars = 0  # Total characters encountered
+        # The number of characters whose frequency order is less than 512
+        self._freq_chars = 0
+
+    def feed(self, char, char_len):
+        """feed a character with known length"""
+        if char_len == 2:
+            # we only care about 2-bytes character in our distribution analysis
+            order = self.get_order(char)
+        else:
+            order = -1
+        if order >= 0:
+            self._total_chars += 1
+            # order is valid
+            if order < self._table_size:
+                if 512 > self._char_to_freq_order[order]:
+                    self._freq_chars += 1
+
+    def get_confidence(self):
+        """return confidence based on existing data"""
+        # if we didn't receive any character in our consideration range,
+        # return negative answer
+        if self._total_chars <= 0 or self._freq_chars <= self.MINIMUM_DATA_THRESHOLD:
+            return self.SURE_NO
+
+        if self._total_chars != self._freq_chars:
+            r = (self._freq_chars / ((self._total_chars - self._freq_chars)
+                 * self.typical_distribution_ratio))
+            if r < self.SURE_YES:
+                return r
+
+        # normalize confidence (we don't want to be 100% sure)
+        return self.SURE_YES
+
+    def got_enough_data(self):
+        # It is not necessary to receive all data to draw conclusion.
+        # For charset detection, certain amount of data is enough
+        return self._total_chars > self.ENOUGH_DATA_THRESHOLD
+
+    def get_order(self, byte_str):
+        # We do not handle characters based on the original encoding string,
+        # but convert this encoding string to a number, here called order.
+        # This allows multiple encodings of a language to share one frequency
+        # table.
+        return -1
+
+
+class EUCTWDistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(EUCTWDistributionAnalysis, self).__init__()
+        self._char_to_freq_order = EUCTW_CHAR_TO_FREQ_ORDER
+        self._table_size = EUCTW_TABLE_SIZE
+        self.typical_distribution_ratio = EUCTW_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for euc-TW encoding, we are interested
+        #   first  byte range: 0xc4 -- 0xfe
+        #   second byte range: 0xa1 -- 0xfe
+        # no validation needed here. State machine has done that
+        first_char = byte_str[0]
+        if first_char >= 0xC4:
+            return 94 * (first_char - 0xC4) + byte_str[1] - 0xA1
+        else:
+            return -1
+
+
+class EUCKRDistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(EUCKRDistributionAnalysis, self).__init__()
+        self._char_to_freq_order = EUCKR_CHAR_TO_FREQ_ORDER
+        self._table_size = EUCKR_TABLE_SIZE
+        self.typical_distribution_ratio = EUCKR_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for euc-KR encoding, we are interested
+        #   first  byte range: 0xb0 -- 0xfe
+        #   second byte range: 0xa1 -- 0xfe
+        # no validation needed here. State machine has done that
+        first_char = byte_str[0]
+        if first_char >= 0xB0:
+            return 94 * (first_char - 0xB0) + byte_str[1] - 0xA1
+        else:
+            return -1
+
+
+class GB2312DistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(GB2312DistributionAnalysis, self).__init__()
+        self._char_to_freq_order = GB2312_CHAR_TO_FREQ_ORDER
+        self._table_size = GB2312_TABLE_SIZE
+        self.typical_distribution_ratio = GB2312_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for GB2312 encoding, we are interested
+        #  first  byte range: 0xb0 -- 0xfe
+        #  second byte range: 0xa1 -- 0xfe
+        # no validation needed here. State machine has done that
+        first_char, second_char = byte_str[0], byte_str[1]
+        if (first_char >= 0xB0) and (second_char >= 0xA1):
+            return 94 * (first_char - 0xB0) + second_char - 0xA1
+        else:
+            return -1
+
+
+class Big5DistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(Big5DistributionAnalysis, self).__init__()
+        self._char_to_freq_order = BIG5_CHAR_TO_FREQ_ORDER
+        self._table_size = BIG5_TABLE_SIZE
+        self.typical_distribution_ratio = BIG5_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for big5 encoding, we are interested
+        #   first  byte range: 0xa4 -- 0xfe
+        #   second byte range: 0x40 -- 0x7e , 0xa1 -- 0xfe
+        # no validation needed here. State machine has done that
+        first_char, second_char = byte_str[0], byte_str[1]
+        if first_char >= 0xA4:
+            if second_char >= 0xA1:
+                return 157 * (first_char - 0xA4) + second_char - 0xA1 + 63
+            else:
+                return 157 * (first_char - 0xA4) + second_char - 0x40
+        else:
+            return -1
+
+
+class SJISDistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(SJISDistributionAnalysis, self).__init__()
+        self._char_to_freq_order = JIS_CHAR_TO_FREQ_ORDER
+        self._table_size = JIS_TABLE_SIZE
+        self.typical_distribution_ratio = JIS_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for sjis encoding, we are interested
+        #   first  byte range: 0x81 -- 0x9f , 0xe0 -- 0xfe
+        #   second byte range: 0x40 -- 0x7e,  0x81 -- oxfe
+        # no validation needed here. State machine has done that
+        first_char, second_char = byte_str[0], byte_str[1]
+        if (first_char >= 0x81) and (first_char <= 0x9F):
+            order = 188 * (first_char - 0x81)
+        elif (first_char >= 0xE0) and (first_char <= 0xEF):
+            order = 188 * (first_char - 0xE0 + 31)
+        else:
+            return -1
+        order = order + second_char - 0x40
+        if second_char > 0x7F:
+            order = -1
+        return order
+
+
+class EUCJPDistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(EUCJPDistributionAnalysis, self).__init__()
+        self._char_to_freq_order = JIS_CHAR_TO_FREQ_ORDER
+        self._table_size = JIS_TABLE_SIZE
+        self.typical_distribution_ratio = JIS_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for euc-JP encoding, we are interested
+        #   first  byte range: 0xa0 -- 0xfe
+        #   second byte range: 0xa1 -- 0xfe
+        # no validation needed here. State machine has done that
+        char = byte_str[0]
+        if char >= 0xA0:
+            return 94 * (char - 0xA1) + byte_str[1] - 0xa1
+        else:
+            return -1
diff --git a/openpype/vendor/python/python_2/chardet/charsetgroupprober.py b/openpype/vendor/python/python_2/chardet/charsetgroupprober.py
new file mode 100644
index 0000000000..5812cef0b5
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/charsetgroupprober.py
@@ -0,0 +1,107 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .enums import ProbingState
+from .charsetprober import CharSetProber
+
+
+class CharSetGroupProber(CharSetProber):
+    def __init__(self, lang_filter=None):
+        super(CharSetGroupProber, self).__init__(lang_filter=lang_filter)
+        self._active_num = 0
+        self.probers = []
+        self._best_guess_prober = None
+
+    def reset(self):
+        super(CharSetGroupProber, self).reset()
+        self._active_num = 0
+        for prober in self.probers:
+            if prober:
+                prober.reset()
+                prober.active = True
+                self._active_num += 1
+        self._best_guess_prober = None
+
+    @property
+    def charset_name(self):
+        if not self._best_guess_prober:
+            self.get_confidence()
+            if not self._best_guess_prober:
+                return None
+        return self._best_guess_prober.charset_name
+
+    @property
+    def language(self):
+        if not self._best_guess_prober:
+            self.get_confidence()
+            if not self._best_guess_prober:
+                return None
+        return self._best_guess_prober.language
+
+    def feed(self, byte_str):
+        for prober in self.probers:
+            if not prober:
+                continue
+            if not prober.active:
+                continue
+            state = prober.feed(byte_str)
+            if not state:
+                continue
+            if state == ProbingState.FOUND_IT:
+                self._best_guess_prober = prober
+                self._state = ProbingState.FOUND_IT
+                return self.state
+            elif state == ProbingState.NOT_ME:
+                prober.active = False
+                self._active_num -= 1
+                if self._active_num <= 0:
+                    self._state = ProbingState.NOT_ME
+                    return self.state
+        return self.state
+
+    def get_confidence(self):
+        state = self.state
+        if state == ProbingState.FOUND_IT:
+            return 0.99
+        elif state == ProbingState.NOT_ME:
+            return 0.01
+        best_conf = 0.0
+        self._best_guess_prober = None
+        for prober in self.probers:
+            if not prober:
+                continue
+            if not prober.active:
+                self.logger.debug('%s not active', prober.charset_name)
+                continue
+            conf = prober.get_confidence()
+            self.logger.debug('%s %s confidence = %s', prober.charset_name, prober.language, conf)
+            if best_conf < conf:
+                best_conf = conf
+                self._best_guess_prober = prober
+        if not self._best_guess_prober:
+            return 0.0
+        return best_conf
diff --git a/openpype/vendor/python/python_2/chardet/charsetprober.py b/openpype/vendor/python/python_2/chardet/charsetprober.py
new file mode 100644
index 0000000000..eac4e59865
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/charsetprober.py
@@ -0,0 +1,145 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+import logging
+import re
+
+from .enums import ProbingState
+
+
+class CharSetProber(object):
+
+    SHORTCUT_THRESHOLD = 0.95
+
+    def __init__(self, lang_filter=None):
+        self._state = None
+        self.lang_filter = lang_filter
+        self.logger = logging.getLogger(__name__)
+
+    def reset(self):
+        self._state = ProbingState.DETECTING
+
+    @property
+    def charset_name(self):
+        return None
+
+    def feed(self, buf):
+        pass
+
+    @property
+    def state(self):
+        return self._state
+
+    def get_confidence(self):
+        return 0.0
+
+    @staticmethod
+    def filter_high_byte_only(buf):
+        buf = re.sub(b'([\x00-\x7F])+', b' ', buf)
+        return buf
+
+    @staticmethod
+    def filter_international_words(buf):
+        """
+        We define three types of bytes:
+        alphabet: english alphabets [a-zA-Z]
+        international: international characters [\x80-\xFF]
+        marker: everything else [^a-zA-Z\x80-\xFF]
+
+        The input buffer can be thought to contain a series of words delimited
+        by markers. This function works to filter all words that contain at
+        least one international character. All contiguous sequences of markers
+        are replaced by a single space ascii character.
+
+        This filter applies to all scripts which do not use English characters.
+        """
+        filtered = bytearray()
+
+        # This regex expression filters out only words that have at-least one
+        # international character. The word may include one marker character at
+        # the end.
+        words = re.findall(b'[a-zA-Z]*[\x80-\xFF]+[a-zA-Z]*[^a-zA-Z\x80-\xFF]?',
+                           buf)
+
+        for word in words:
+            filtered.extend(word[:-1])
+
+            # If the last character in the word is a marker, replace it with a
+            # space as markers shouldn't affect our analysis (they are used
+            # similarly across all languages and may thus have similar
+            # frequencies).
+            last_char = word[-1:]
+            if not last_char.isalpha() and last_char < b'\x80':
+                last_char = b' '
+            filtered.extend(last_char)
+
+        return filtered
+
+    @staticmethod
+    def filter_with_english_letters(buf):
+        """
+        Returns a copy of ``buf`` that retains only the sequences of English
+        alphabet and high byte characters that are not between <> characters.
+        Also retains English alphabet and high byte characters immediately
+        before occurrences of >.
+
+        This filter can be applied to all scripts which contain both English
+        characters and extended ASCII characters, but is currently only used by
+        ``Latin1Prober``.
+        """
+        filtered = bytearray()
+        in_tag = False
+        prev = 0
+
+        for curr in range(len(buf)):
+            # Slice here to get bytes instead of an int with Python 3
+            buf_char = buf[curr:curr + 1]
+            # Check if we're coming out of or entering an HTML tag
+            if buf_char == b'>':
+                in_tag = False
+            elif buf_char == b'<':
+                in_tag = True
+
+            # If current character is not extended-ASCII and not alphabetic...
+            if buf_char < b'\x80' and not buf_char.isalpha():
+                # ...and we're not in a tag
+                if curr > prev and not in_tag:
+                    # Keep everything after last non-extended-ASCII,
+                    # non-alphabetic character
+                    filtered.extend(buf[prev:curr])
+                    # Output a space to delimit stretch we kept
+                    filtered.extend(b' ')
+                prev = curr + 1
+
+        # If we're not in a tag...
+        if not in_tag:
+            # Keep everything after last non-extended-ASCII, non-alphabetic
+            # character
+            filtered.extend(buf[prev:])
+
+        return filtered
diff --git a/openpype/vendor/python/python_2/chardet/cli/__init__.py b/openpype/vendor/python/python_2/chardet/cli/__init__.py
new file mode 100644
index 0000000000..8b13789179
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/cli/__init__.py
@@ -0,0 +1 @@
+
diff --git a/openpype/vendor/python/python_2/chardet/cli/chardetect.py b/openpype/vendor/python/python_2/chardet/cli/chardetect.py
new file mode 100644
index 0000000000..e1d8cd69ac
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/cli/chardetect.py
@@ -0,0 +1,84 @@
+"""
+Script which takes one or more file paths and reports on their detected
+encodings
+
+Example::
+
+    % chardetect somefile someotherfile
+    somefile: windows-1252 with confidence 0.5
+    someotherfile: ascii with confidence 1.0
+
+If no paths are provided, it takes its input from stdin.
+
+"""
+
+from __future__ import absolute_import, print_function, unicode_literals
+
+import argparse
+import sys
+
+from chardet import __version__
+from chardet.compat import PY2
+from chardet.universaldetector import UniversalDetector
+
+
+def description_of(lines, name='stdin'):
+    """
+    Return a string describing the probable encoding of a file or
+    list of strings.
+
+    :param lines: The lines to get the encoding of.
+    :type lines: Iterable of bytes
+    :param name: Name of file or collection of lines
+    :type name: str
+    """
+    u = UniversalDetector()
+    for line in lines:
+        line = bytearray(line)
+        u.feed(line)
+        # shortcut out of the loop to save reading further - particularly useful if we read a BOM.
+        if u.done:
+            break
+    u.close()
+    result = u.result
+    if PY2:
+        name = name.decode(sys.getfilesystemencoding(), 'ignore')
+    if result['encoding']:
+        return '{}: {} with confidence {}'.format(name, result['encoding'],
+                                                     result['confidence'])
+    else:
+        return '{}: no result'.format(name)
+
+
+def main(argv=None):
+    """
+    Handles command line arguments and gets things started.
+
+    :param argv: List of arguments, as if specified on the command-line.
+                 If None, ``sys.argv[1:]`` is used instead.
+    :type argv: list of str
+    """
+    # Get command line arguments
+    parser = argparse.ArgumentParser(
+        description="Takes one or more file paths and reports their detected \
+                     encodings")
+    parser.add_argument('input',
+                        help='File whose encoding we would like to determine. \
+                              (default: stdin)',
+                        type=argparse.FileType('rb'), nargs='*',
+                        default=[sys.stdin if PY2 else sys.stdin.buffer])
+    parser.add_argument('--version', action='version',
+                        version='%(prog)s {}'.format(__version__))
+    args = parser.parse_args(argv)
+
+    for f in args.input:
+        if f.isatty():
+            print("You are running chardetect interactively. Press " +
+                  "CTRL-D twice at the start of a blank line to signal the " +
+                  "end of your input. If you want help, run chardetect " +
+                  "--help\n", file=sys.stderr)
+        print(description_of(f, f.name))
+
+
+if __name__ == '__main__':
+    main()
diff --git a/openpype/vendor/python/python_2/chardet/codingstatemachine.py b/openpype/vendor/python/python_2/chardet/codingstatemachine.py
new file mode 100644
index 0000000000..68fba44f14
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/codingstatemachine.py
@@ -0,0 +1,88 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+import logging
+
+from .enums import MachineState
+
+
+class CodingStateMachine(object):
+    """
+    A state machine to verify a byte sequence for a particular encoding. For
+    each byte the detector receives, it will feed that byte to every active
+    state machine available, one byte at a time. The state machine changes its
+    state based on its previous state and the byte it receives. There are 3
+    states in a state machine that are of interest to an auto-detector:
+
+    START state: This is the state to start with, or a legal byte sequence
+                 (i.e. a valid code point) for character has been identified.
+
+    ME state:  This indicates that the state machine identified a byte sequence
+               that is specific to the charset it is designed for and that
+               there is no other possible encoding which can contain this byte
+               sequence. This will to lead to an immediate positive answer for
+               the detector.
+
+    ERROR state: This indicates the state machine identified an illegal byte
+                 sequence for that encoding. This will lead to an immediate
+                 negative answer for this encoding. Detector will exclude this
+                 encoding from consideration from here on.
+    """
+    def __init__(self, sm):
+        self._model = sm
+        self._curr_byte_pos = 0
+        self._curr_char_len = 0
+        self._curr_state = None
+        self.logger = logging.getLogger(__name__)
+        self.reset()
+
+    def reset(self):
+        self._curr_state = MachineState.START
+
+    def next_state(self, c):
+        # for each byte we get its class
+        # if it is first byte, we also get byte length
+        byte_class = self._model['class_table'][c]
+        if self._curr_state == MachineState.START:
+            self._curr_byte_pos = 0
+            self._curr_char_len = self._model['char_len_table'][byte_class]
+        # from byte's class and state_table, we get its next state
+        curr_state = (self._curr_state * self._model['class_factor']
+                      + byte_class)
+        self._curr_state = self._model['state_table'][curr_state]
+        self._curr_byte_pos += 1
+        return self._curr_state
+
+    def get_current_charlen(self):
+        return self._curr_char_len
+
+    def get_coding_state_machine(self):
+        return self._model['name']
+
+    @property
+    def language(self):
+        return self._model['language']
diff --git a/openpype/vendor/python/python_2/chardet/compat.py b/openpype/vendor/python/python_2/chardet/compat.py
new file mode 100644
index 0000000000..8941572b3e
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/compat.py
@@ -0,0 +1,36 @@
+######################## BEGIN LICENSE BLOCK ########################
+# Contributor(s):
+#   Dan Blanchard
+#   Ian Cordasco
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+import sys
+
+
+if sys.version_info < (3, 0):
+    PY2 = True
+    PY3 = False
+    string_types = (str, unicode)
+    text_type = unicode
+    iteritems = dict.iteritems
+else:
+    PY2 = False
+    PY3 = True
+    string_types = (bytes, str)
+    text_type = str
+    iteritems = dict.items
diff --git a/openpype/vendor/python/python_2/chardet/cp949prober.py b/openpype/vendor/python/python_2/chardet/cp949prober.py
new file mode 100644
index 0000000000..efd793abca
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/cp949prober.py
@@ -0,0 +1,49 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .chardistribution import EUCKRDistributionAnalysis
+from .codingstatemachine import CodingStateMachine
+from .mbcharsetprober import MultiByteCharSetProber
+from .mbcssm import CP949_SM_MODEL
+
+
+class CP949Prober(MultiByteCharSetProber):
+    def __init__(self):
+        super(CP949Prober, self).__init__()
+        self.coding_sm = CodingStateMachine(CP949_SM_MODEL)
+        # NOTE: CP949 is a superset of EUC-KR, so the distribution should be
+        #       not different.
+        self.distribution_analyzer = EUCKRDistributionAnalysis()
+        self.reset()
+
+    @property
+    def charset_name(self):
+        return "CP949"
+
+    @property
+    def language(self):
+        return "Korean"
diff --git a/openpype/vendor/python/python_2/chardet/enums.py b/openpype/vendor/python/python_2/chardet/enums.py
new file mode 100644
index 0000000000..0451207225
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/enums.py
@@ -0,0 +1,76 @@
+"""
+All of the Enums that are used throughout the chardet package.
+
+:author: Dan Blanchard (dan.blanchard@gmail.com)
+"""
+
+
+class InputState(object):
+    """
+    This enum represents the different states a universal detector can be in.
+    """
+    PURE_ASCII = 0
+    ESC_ASCII = 1
+    HIGH_BYTE = 2
+
+
+class LanguageFilter(object):
+    """
+    This enum represents the different language filters we can apply to a
+    ``UniversalDetector``.
+    """
+    CHINESE_SIMPLIFIED = 0x01
+    CHINESE_TRADITIONAL = 0x02
+    JAPANESE = 0x04
+    KOREAN = 0x08
+    NON_CJK = 0x10
+    ALL = 0x1F
+    CHINESE = CHINESE_SIMPLIFIED | CHINESE_TRADITIONAL
+    CJK = CHINESE | JAPANESE | KOREAN
+
+
+class ProbingState(object):
+    """
+    This enum represents the different states a prober can be in.
+    """
+    DETECTING = 0
+    FOUND_IT = 1
+    NOT_ME = 2
+
+
+class MachineState(object):
+    """
+    This enum represents the different states a state machine can be in.
+    """
+    START = 0
+    ERROR = 1
+    ITS_ME = 2
+
+
+class SequenceLikelihood(object):
+    """
+    This enum represents the likelihood of a character following the previous one.
+    """
+    NEGATIVE = 0
+    UNLIKELY = 1
+    LIKELY = 2
+    POSITIVE = 3
+
+    @classmethod
+    def get_num_categories(cls):
+        """:returns: The number of likelihood categories in the enum."""
+        return 4
+
+
+class CharacterCategory(object):
+    """
+    This enum represents the different categories language models for
+    ``SingleByteCharsetProber`` put characters into.
+
+    Anything less than CONTROL is considered a letter.
+    """
+    UNDEFINED = 255
+    LINE_BREAK = 254
+    SYMBOL = 253
+    DIGIT = 252
+    CONTROL = 251
diff --git a/openpype/vendor/python/python_2/chardet/escprober.py b/openpype/vendor/python/python_2/chardet/escprober.py
new file mode 100644
index 0000000000..c70493f2b1
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/escprober.py
@@ -0,0 +1,101 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetprober import CharSetProber
+from .codingstatemachine import CodingStateMachine
+from .enums import LanguageFilter, ProbingState, MachineState
+from .escsm import (HZ_SM_MODEL, ISO2022CN_SM_MODEL, ISO2022JP_SM_MODEL,
+                    ISO2022KR_SM_MODEL)
+
+
+class EscCharSetProber(CharSetProber):
+    """
+    This CharSetProber uses a "code scheme" approach for detecting encodings,
+    whereby easily recognizable escape or shift sequences are relied on to
+    identify these encodings.
+    """
+
+    def __init__(self, lang_filter=None):
+        super(EscCharSetProber, self).__init__(lang_filter=lang_filter)
+        self.coding_sm = []
+        if self.lang_filter & LanguageFilter.CHINESE_SIMPLIFIED:
+            self.coding_sm.append(CodingStateMachine(HZ_SM_MODEL))
+            self.coding_sm.append(CodingStateMachine(ISO2022CN_SM_MODEL))
+        if self.lang_filter & LanguageFilter.JAPANESE:
+            self.coding_sm.append(CodingStateMachine(ISO2022JP_SM_MODEL))
+        if self.lang_filter & LanguageFilter.KOREAN:
+            self.coding_sm.append(CodingStateMachine(ISO2022KR_SM_MODEL))
+        self.active_sm_count = None
+        self._detected_charset = None
+        self._detected_language = None
+        self._state = None
+        self.reset()
+
+    def reset(self):
+        super(EscCharSetProber, self).reset()
+        for coding_sm in self.coding_sm:
+            if not coding_sm:
+                continue
+            coding_sm.active = True
+            coding_sm.reset()
+        self.active_sm_count = len(self.coding_sm)
+        self._detected_charset = None
+        self._detected_language = None
+
+    @property
+    def charset_name(self):
+        return self._detected_charset
+
+    @property
+    def language(self):
+        return self._detected_language
+
+    def get_confidence(self):
+        if self._detected_charset:
+            return 0.99
+        else:
+            return 0.00
+
+    def feed(self, byte_str):
+        for c in byte_str:
+            for coding_sm in self.coding_sm:
+                if not coding_sm or not coding_sm.active:
+                    continue
+                coding_state = coding_sm.next_state(c)
+                if coding_state == MachineState.ERROR:
+                    coding_sm.active = False
+                    self.active_sm_count -= 1
+                    if self.active_sm_count <= 0:
+                        self._state = ProbingState.NOT_ME
+                        return self.state
+                elif coding_state == MachineState.ITS_ME:
+                    self._state = ProbingState.FOUND_IT
+                    self._detected_charset = coding_sm.get_coding_state_machine()
+                    self._detected_language = coding_sm.language
+                    return self.state
+
+        return self.state
diff --git a/openpype/vendor/python/python_2/chardet/escsm.py b/openpype/vendor/python/python_2/chardet/escsm.py
new file mode 100644
index 0000000000..0069523a04
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/escsm.py
@@ -0,0 +1,246 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .enums import MachineState
+
+HZ_CLS = (
+1,0,0,0,0,0,0,0,  # 00 - 07
+0,0,0,0,0,0,0,0,  # 08 - 0f
+0,0,0,0,0,0,0,0,  # 10 - 17
+0,0,0,1,0,0,0,0,  # 18 - 1f
+0,0,0,0,0,0,0,0,  # 20 - 27
+0,0,0,0,0,0,0,0,  # 28 - 2f
+0,0,0,0,0,0,0,0,  # 30 - 37
+0,0,0,0,0,0,0,0,  # 38 - 3f
+0,0,0,0,0,0,0,0,  # 40 - 47
+0,0,0,0,0,0,0,0,  # 48 - 4f
+0,0,0,0,0,0,0,0,  # 50 - 57
+0,0,0,0,0,0,0,0,  # 58 - 5f
+0,0,0,0,0,0,0,0,  # 60 - 67
+0,0,0,0,0,0,0,0,  # 68 - 6f
+0,0,0,0,0,0,0,0,  # 70 - 77
+0,0,0,4,0,5,2,0,  # 78 - 7f
+1,1,1,1,1,1,1,1,  # 80 - 87
+1,1,1,1,1,1,1,1,  # 88 - 8f
+1,1,1,1,1,1,1,1,  # 90 - 97
+1,1,1,1,1,1,1,1,  # 98 - 9f
+1,1,1,1,1,1,1,1,  # a0 - a7
+1,1,1,1,1,1,1,1,  # a8 - af
+1,1,1,1,1,1,1,1,  # b0 - b7
+1,1,1,1,1,1,1,1,  # b8 - bf
+1,1,1,1,1,1,1,1,  # c0 - c7
+1,1,1,1,1,1,1,1,  # c8 - cf
+1,1,1,1,1,1,1,1,  # d0 - d7
+1,1,1,1,1,1,1,1,  # d8 - df
+1,1,1,1,1,1,1,1,  # e0 - e7
+1,1,1,1,1,1,1,1,  # e8 - ef
+1,1,1,1,1,1,1,1,  # f0 - f7
+1,1,1,1,1,1,1,1,  # f8 - ff
+)
+
+HZ_ST = (
+MachineState.START,MachineState.ERROR,     3,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,# 00-07
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 08-0f
+MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,     4,MachineState.ERROR,# 10-17
+     5,MachineState.ERROR,     6,MachineState.ERROR,     5,     5,     4,MachineState.ERROR,# 18-1f
+     4,MachineState.ERROR,     4,     4,     4,MachineState.ERROR,     4,MachineState.ERROR,# 20-27
+     4,MachineState.ITS_ME,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 28-2f
+)
+
+HZ_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0)
+
+HZ_SM_MODEL = {'class_table': HZ_CLS,
+               'class_factor': 6,
+               'state_table': HZ_ST,
+               'char_len_table': HZ_CHAR_LEN_TABLE,
+               'name': "HZ-GB-2312",
+               'language': 'Chinese'}
+
+ISO2022CN_CLS = (
+2,0,0,0,0,0,0,0,  # 00 - 07
+0,0,0,0,0,0,0,0,  # 08 - 0f
+0,0,0,0,0,0,0,0,  # 10 - 17
+0,0,0,1,0,0,0,0,  # 18 - 1f
+0,0,0,0,0,0,0,0,  # 20 - 27
+0,3,0,0,0,0,0,0,  # 28 - 2f
+0,0,0,0,0,0,0,0,  # 30 - 37
+0,0,0,0,0,0,0,0,  # 38 - 3f
+0,0,0,4,0,0,0,0,  # 40 - 47
+0,0,0,0,0,0,0,0,  # 48 - 4f
+0,0,0,0,0,0,0,0,  # 50 - 57
+0,0,0,0,0,0,0,0,  # 58 - 5f
+0,0,0,0,0,0,0,0,  # 60 - 67
+0,0,0,0,0,0,0,0,  # 68 - 6f
+0,0,0,0,0,0,0,0,  # 70 - 77
+0,0,0,0,0,0,0,0,  # 78 - 7f
+2,2,2,2,2,2,2,2,  # 80 - 87
+2,2,2,2,2,2,2,2,  # 88 - 8f
+2,2,2,2,2,2,2,2,  # 90 - 97
+2,2,2,2,2,2,2,2,  # 98 - 9f
+2,2,2,2,2,2,2,2,  # a0 - a7
+2,2,2,2,2,2,2,2,  # a8 - af
+2,2,2,2,2,2,2,2,  # b0 - b7
+2,2,2,2,2,2,2,2,  # b8 - bf
+2,2,2,2,2,2,2,2,  # c0 - c7
+2,2,2,2,2,2,2,2,  # c8 - cf
+2,2,2,2,2,2,2,2,  # d0 - d7
+2,2,2,2,2,2,2,2,  # d8 - df
+2,2,2,2,2,2,2,2,  # e0 - e7
+2,2,2,2,2,2,2,2,  # e8 - ef
+2,2,2,2,2,2,2,2,  # f0 - f7
+2,2,2,2,2,2,2,2,  # f8 - ff
+)
+
+ISO2022CN_ST = (
+MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 00-07
+MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 08-0f
+MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 10-17
+MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     4,MachineState.ERROR,# 18-1f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 20-27
+     5,     6,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 28-2f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 30-37
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.START,# 38-3f
+)
+
+ISO2022CN_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0, 0, 0, 0)
+
+ISO2022CN_SM_MODEL = {'class_table': ISO2022CN_CLS,
+                      'class_factor': 9,
+                      'state_table': ISO2022CN_ST,
+                      'char_len_table': ISO2022CN_CHAR_LEN_TABLE,
+                      'name': "ISO-2022-CN",
+                      'language': 'Chinese'}
+
+ISO2022JP_CLS = (
+2,0,0,0,0,0,0,0,  # 00 - 07
+0,0,0,0,0,0,2,2,  # 08 - 0f
+0,0,0,0,0,0,0,0,  # 10 - 17
+0,0,0,1,0,0,0,0,  # 18 - 1f
+0,0,0,0,7,0,0,0,  # 20 - 27
+3,0,0,0,0,0,0,0,  # 28 - 2f
+0,0,0,0,0,0,0,0,  # 30 - 37
+0,0,0,0,0,0,0,0,  # 38 - 3f
+6,0,4,0,8,0,0,0,  # 40 - 47
+0,9,5,0,0,0,0,0,  # 48 - 4f
+0,0,0,0,0,0,0,0,  # 50 - 57
+0,0,0,0,0,0,0,0,  # 58 - 5f
+0,0,0,0,0,0,0,0,  # 60 - 67
+0,0,0,0,0,0,0,0,  # 68 - 6f
+0,0,0,0,0,0,0,0,  # 70 - 77
+0,0,0,0,0,0,0,0,  # 78 - 7f
+2,2,2,2,2,2,2,2,  # 80 - 87
+2,2,2,2,2,2,2,2,  # 88 - 8f
+2,2,2,2,2,2,2,2,  # 90 - 97
+2,2,2,2,2,2,2,2,  # 98 - 9f
+2,2,2,2,2,2,2,2,  # a0 - a7
+2,2,2,2,2,2,2,2,  # a8 - af
+2,2,2,2,2,2,2,2,  # b0 - b7
+2,2,2,2,2,2,2,2,  # b8 - bf
+2,2,2,2,2,2,2,2,  # c0 - c7
+2,2,2,2,2,2,2,2,  # c8 - cf
+2,2,2,2,2,2,2,2,  # d0 - d7
+2,2,2,2,2,2,2,2,  # d8 - df
+2,2,2,2,2,2,2,2,  # e0 - e7
+2,2,2,2,2,2,2,2,  # e8 - ef
+2,2,2,2,2,2,2,2,  # f0 - f7
+2,2,2,2,2,2,2,2,  # f8 - ff
+)
+
+ISO2022JP_ST = (
+MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 00-07
+MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 08-0f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 10-17
+MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,# 18-1f
+MachineState.ERROR,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     4,MachineState.ERROR,MachineState.ERROR,# 20-27
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     6,MachineState.ITS_ME,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,# 28-2f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,# 30-37
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 38-3f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.START,MachineState.START,# 40-47
+)
+
+ISO2022JP_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0, 0, 0, 0, 0)
+
+ISO2022JP_SM_MODEL = {'class_table': ISO2022JP_CLS,
+                      'class_factor': 10,
+                      'state_table': ISO2022JP_ST,
+                      'char_len_table': ISO2022JP_CHAR_LEN_TABLE,
+                      'name': "ISO-2022-JP",
+                      'language': 'Japanese'}
+
+ISO2022KR_CLS = (
+2,0,0,0,0,0,0,0,  # 00 - 07
+0,0,0,0,0,0,0,0,  # 08 - 0f
+0,0,0,0,0,0,0,0,  # 10 - 17
+0,0,0,1,0,0,0,0,  # 18 - 1f
+0,0,0,0,3,0,0,0,  # 20 - 27
+0,4,0,0,0,0,0,0,  # 28 - 2f
+0,0,0,0,0,0,0,0,  # 30 - 37
+0,0,0,0,0,0,0,0,  # 38 - 3f
+0,0,0,5,0,0,0,0,  # 40 - 47
+0,0,0,0,0,0,0,0,  # 48 - 4f
+0,0,0,0,0,0,0,0,  # 50 - 57
+0,0,0,0,0,0,0,0,  # 58 - 5f
+0,0,0,0,0,0,0,0,  # 60 - 67
+0,0,0,0,0,0,0,0,  # 68 - 6f
+0,0,0,0,0,0,0,0,  # 70 - 77
+0,0,0,0,0,0,0,0,  # 78 - 7f
+2,2,2,2,2,2,2,2,  # 80 - 87
+2,2,2,2,2,2,2,2,  # 88 - 8f
+2,2,2,2,2,2,2,2,  # 90 - 97
+2,2,2,2,2,2,2,2,  # 98 - 9f
+2,2,2,2,2,2,2,2,  # a0 - a7
+2,2,2,2,2,2,2,2,  # a8 - af
+2,2,2,2,2,2,2,2,  # b0 - b7
+2,2,2,2,2,2,2,2,  # b8 - bf
+2,2,2,2,2,2,2,2,  # c0 - c7
+2,2,2,2,2,2,2,2,  # c8 - cf
+2,2,2,2,2,2,2,2,  # d0 - d7
+2,2,2,2,2,2,2,2,  # d8 - df
+2,2,2,2,2,2,2,2,  # e0 - e7
+2,2,2,2,2,2,2,2,  # e8 - ef
+2,2,2,2,2,2,2,2,  # f0 - f7
+2,2,2,2,2,2,2,2,  # f8 - ff
+)
+
+ISO2022KR_ST = (
+MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,# 00-07
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 08-0f
+MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     4,MachineState.ERROR,MachineState.ERROR,# 10-17
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 18-1f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 20-27
+)
+
+ISO2022KR_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0)
+
+ISO2022KR_SM_MODEL = {'class_table': ISO2022KR_CLS,
+                      'class_factor': 6,
+                      'state_table': ISO2022KR_ST,
+                      'char_len_table': ISO2022KR_CHAR_LEN_TABLE,
+                      'name': "ISO-2022-KR",
+                      'language': 'Korean'}
+
+
diff --git a/openpype/vendor/python/python_2/chardet/eucjpprober.py b/openpype/vendor/python/python_2/chardet/eucjpprober.py
new file mode 100644
index 0000000000..20ce8f7d15
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/eucjpprober.py
@@ -0,0 +1,92 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .enums import ProbingState, MachineState
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import EUCJPDistributionAnalysis
+from .jpcntx import EUCJPContextAnalysis
+from .mbcssm import EUCJP_SM_MODEL
+
+
+class EUCJPProber(MultiByteCharSetProber):
+    def __init__(self):
+        super(EUCJPProber, self).__init__()
+        self.coding_sm = CodingStateMachine(EUCJP_SM_MODEL)
+        self.distribution_analyzer = EUCJPDistributionAnalysis()
+        self.context_analyzer = EUCJPContextAnalysis()
+        self.reset()
+
+    def reset(self):
+        super(EUCJPProber, self).reset()
+        self.context_analyzer.reset()
+
+    @property
+    def charset_name(self):
+        return "EUC-JP"
+
+    @property
+    def language(self):
+        return "Japanese"
+
+    def feed(self, byte_str):
+        for i in range(len(byte_str)):
+            # PY3K: byte_str is a byte array, so byte_str[i] is an int, not a byte
+            coding_state = self.coding_sm.next_state(byte_str[i])
+            if coding_state == MachineState.ERROR:
+                self.logger.debug('%s %s prober hit error at byte %s',
+                                  self.charset_name, self.language, i)
+                self._state = ProbingState.NOT_ME
+                break
+            elif coding_state == MachineState.ITS_ME:
+                self._state = ProbingState.FOUND_IT
+                break
+            elif coding_state == MachineState.START:
+                char_len = self.coding_sm.get_current_charlen()
+                if i == 0:
+                    self._last_char[1] = byte_str[0]
+                    self.context_analyzer.feed(self._last_char, char_len)
+                    self.distribution_analyzer.feed(self._last_char, char_len)
+                else:
+                    self.context_analyzer.feed(byte_str[i - 1:i + 1],
+                                                char_len)
+                    self.distribution_analyzer.feed(byte_str[i - 1:i + 1],
+                                                     char_len)
+
+        self._last_char[0] = byte_str[-1]
+
+        if self.state == ProbingState.DETECTING:
+            if (self.context_analyzer.got_enough_data() and
+               (self.get_confidence() > self.SHORTCUT_THRESHOLD)):
+                self._state = ProbingState.FOUND_IT
+
+        return self.state
+
+    def get_confidence(self):
+        context_conf = self.context_analyzer.get_confidence()
+        distrib_conf = self.distribution_analyzer.get_confidence()
+        return max(context_conf, distrib_conf)
diff --git a/openpype/vendor/python/python_2/chardet/euckrfreq.py b/openpype/vendor/python/python_2/chardet/euckrfreq.py
new file mode 100644
index 0000000000..b68078cb96
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/euckrfreq.py
@@ -0,0 +1,195 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# Sampling from about 20M text materials include literature and computer technology
+
+# 128  --> 0.79
+# 256  --> 0.92
+# 512  --> 0.986
+# 1024 --> 0.99944
+# 2048 --> 0.99999
+#
+# Idea Distribution Ratio = 0.98653 / (1-0.98653) = 73.24
+# Random Distribution Ration = 512 / (2350-512) = 0.279.
+#
+# Typical Distribution Ratio
+
+EUCKR_TYPICAL_DISTRIBUTION_RATIO = 6.0
+
+EUCKR_TABLE_SIZE = 2352
+
+# Char to FreqOrder table ,
+EUCKR_CHAR_TO_FREQ_ORDER = (
+  13, 130, 120,1396, 481,1719,1720, 328, 609, 212,1721, 707, 400, 299,1722,  87,
+1397,1723, 104, 536,1117,1203,1724,1267, 685,1268, 508,1725,1726,1727,1728,1398,
+1399,1729,1730,1731, 141, 621, 326,1057, 368,1732, 267, 488,  20,1733,1269,1734,
+ 945,1400,1735,  47, 904,1270,1736,1737, 773, 248,1738, 409, 313, 786, 429,1739,
+ 116, 987, 813,1401, 683,  75,1204, 145,1740,1741,1742,1743,  16, 847, 667, 622,
+ 708,1744,1745,1746, 966, 787, 304, 129,1747,  60, 820, 123, 676,1748,1749,1750,
+1751, 617,1752, 626,1753,1754,1755,1756, 653,1757,1758,1759,1760,1761,1762, 856,
+ 344,1763,1764,1765,1766,  89, 401, 418, 806, 905, 848,1767,1768,1769, 946,1205,
+ 709,1770,1118,1771, 241,1772,1773,1774,1271,1775, 569,1776, 999,1777,1778,1779,
+1780, 337, 751,1058,  28, 628, 254,1781, 177, 906, 270, 349, 891,1079,1782,  19,
+1783, 379,1784, 315,1785, 629, 754,1402, 559,1786, 636, 203,1206,1787, 710, 567,
+1788, 935, 814,1789,1790,1207, 766, 528,1791,1792,1208,1793,1794,1795,1796,1797,
+1403,1798,1799, 533,1059,1404,1405,1156,1406, 936, 884,1080,1800, 351,1801,1802,
+1803,1804,1805, 801,1806,1807,1808,1119,1809,1157, 714, 474,1407,1810, 298, 899,
+ 885,1811,1120, 802,1158,1812, 892,1813,1814,1408, 659,1815,1816,1121,1817,1818,
+1819,1820,1821,1822, 319,1823, 594, 545,1824, 815, 937,1209,1825,1826, 573,1409,
+1022,1827,1210,1828,1829,1830,1831,1832,1833, 556, 722, 807,1122,1060,1834, 697,
+1835, 900, 557, 715,1836,1410, 540,1411, 752,1159, 294, 597,1211, 976, 803, 770,
+1412,1837,1838,  39, 794,1413, 358,1839, 371, 925,1840, 453, 661, 788, 531, 723,
+ 544,1023,1081, 869,  91,1841, 392, 430, 790, 602,1414, 677,1082, 457,1415,1416,
+1842,1843, 475, 327,1024,1417, 795, 121,1844, 733, 403,1418,1845,1846,1847, 300,
+ 119, 711,1212, 627,1848,1272, 207,1849,1850, 796,1213, 382,1851, 519,1852,1083,
+ 893,1853,1854,1855, 367, 809, 487, 671,1856, 663,1857,1858, 956, 471, 306, 857,
+1859,1860,1160,1084,1861,1862,1863,1864,1865,1061,1866,1867,1868,1869,1870,1871,
+ 282,  96, 574,1872, 502,1085,1873,1214,1874, 907,1875,1876, 827, 977,1419,1420,
+1421, 268,1877,1422,1878,1879,1880, 308,1881,   2, 537,1882,1883,1215,1884,1885,
+ 127, 791,1886,1273,1423,1887,  34, 336, 404, 643,1888, 571, 654, 894, 840,1889,
+   0, 886,1274, 122, 575, 260, 908, 938,1890,1275, 410, 316,1891,1892, 100,1893,
+1894,1123,  48,1161,1124,1025,1895, 633, 901,1276,1896,1897, 115, 816,1898, 317,
+1899, 694,1900, 909, 734,1424, 572, 866,1425, 691,  85, 524,1010, 543, 394, 841,
+1901,1902,1903,1026,1904,1905,1906,1907,1908,1909,  30, 451, 651, 988, 310,1910,
+1911,1426, 810,1216,  93,1912,1913,1277,1217,1914, 858, 759,  45,  58, 181, 610,
+ 269,1915,1916, 131,1062, 551, 443,1000, 821,1427, 957, 895,1086,1917,1918, 375,
+1919, 359,1920, 687,1921, 822,1922, 293,1923,1924,  40, 662, 118, 692,  29, 939,
+ 887, 640, 482, 174,1925,  69,1162, 728,1428, 910,1926,1278,1218,1279, 386, 870,
+ 217, 854,1163, 823,1927,1928,1929,1930, 834,1931,  78,1932, 859,1933,1063,1934,
+1935,1936,1937, 438,1164, 208, 595,1938,1939,1940,1941,1219,1125,1942, 280, 888,
+1429,1430,1220,1431,1943,1944,1945,1946,1947,1280, 150, 510,1432,1948,1949,1950,
+1951,1952,1953,1954,1011,1087,1955,1433,1043,1956, 881,1957, 614, 958,1064,1065,
+1221,1958, 638,1001, 860, 967, 896,1434, 989, 492, 553,1281,1165,1959,1282,1002,
+1283,1222,1960,1961,1962,1963,  36, 383, 228, 753, 247, 454,1964, 876, 678,1965,
+1966,1284, 126, 464, 490, 835, 136, 672, 529, 940,1088,1435, 473,1967,1968, 467,
+  50, 390, 227, 587, 279, 378, 598, 792, 968, 240, 151, 160, 849, 882,1126,1285,
+ 639,1044, 133, 140, 288, 360, 811, 563,1027, 561, 142, 523,1969,1970,1971,   7,
+ 103, 296, 439, 407, 506, 634, 990,1972,1973,1974,1975, 645,1976,1977,1978,1979,
+1980,1981, 236,1982,1436,1983,1984,1089, 192, 828, 618, 518,1166, 333,1127,1985,
+ 818,1223,1986,1987,1988,1989,1990,1991,1992,1993, 342,1128,1286, 746, 842,1994,
+1995, 560, 223,1287,  98,   8, 189, 650, 978,1288,1996,1437,1997,  17, 345, 250,
+ 423, 277, 234, 512, 226,  97, 289,  42, 167,1998, 201,1999,2000, 843, 836, 824,
+ 532, 338, 783,1090, 182, 576, 436,1438,1439, 527, 500,2001, 947, 889,2002,2003,
+2004,2005, 262, 600, 314, 447,2006, 547,2007, 693, 738,1129,2008,  71,1440, 745,
+ 619, 688,2009, 829,2010,2011, 147,2012,  33, 948,2013,2014,  74, 224,2015,  61,
+ 191, 918, 399, 637,2016,1028,1130, 257, 902,2017,2018,2019,2020,2021,2022,2023,
+2024,2025,2026, 837,2027,2028,2029,2030, 179, 874, 591,  52, 724, 246,2031,2032,
+2033,2034,1167, 969,2035,1289, 630, 605, 911,1091,1168,2036,2037,2038,1441, 912,
+2039, 623,2040,2041, 253,1169,1290,2042,1442, 146, 620, 611, 577, 433,2043,1224,
+ 719,1170, 959, 440, 437, 534,  84, 388, 480,1131, 159, 220, 198, 679,2044,1012,
+ 819,1066,1443, 113,1225, 194, 318,1003,1029,2045,2046,2047,2048,1067,2049,2050,
+2051,2052,2053,  59, 913, 112,2054, 632,2055, 455, 144, 739,1291,2056, 273, 681,
+ 499,2057, 448,2058,2059, 760,2060,2061, 970, 384, 169, 245,1132,2062,2063, 414,
+1444,2064,2065,  41, 235,2066, 157, 252, 877, 568, 919, 789, 580,2067, 725,2068,
+2069,1292,2070,2071,1445,2072,1446,2073,2074,  55, 588,  66,1447, 271,1092,2075,
+1226,2076, 960,1013, 372,2077,2078,2079,2080,2081,1293,2082,2083,2084,2085, 850,
+2086,2087,2088,2089,2090, 186,2091,1068, 180,2092,2093,2094, 109,1227, 522, 606,
+2095, 867,1448,1093, 991,1171, 926, 353,1133,2096, 581,2097,2098,2099,1294,1449,
+1450,2100, 596,1172,1014,1228,2101,1451,1295,1173,1229,2102,2103,1296,1134,1452,
+ 949,1135,2104,2105,1094,1453,1454,1455,2106,1095,2107,2108,2109,2110,2111,2112,
+2113,2114,2115,2116,2117, 804,2118,2119,1230,1231, 805,1456, 405,1136,2120,2121,
+2122,2123,2124, 720, 701,1297, 992,1457, 927,1004,2125,2126,2127,2128,2129,2130,
+  22, 417,2131, 303,2132, 385,2133, 971, 520, 513,2134,1174,  73,1096, 231, 274,
+ 962,1458, 673,2135,1459,2136, 152,1137,2137,2138,2139,2140,1005,1138,1460,1139,
+2141,2142,2143,2144,  11, 374, 844,2145, 154,1232,  46,1461,2146, 838, 830, 721,
+1233, 106,2147,  90, 428, 462, 578, 566,1175, 352,2148,2149, 538,1234, 124,1298,
+2150,1462, 761, 565,2151, 686,2152, 649,2153,  72, 173,2154, 460, 415,2155,1463,
+2156,1235, 305,2157,2158,2159,2160,2161,2162, 579,2163,2164,2165,2166,2167, 747,
+2168,2169,2170,2171,1464, 669,2172,2173,2174,2175,2176,1465,2177,  23, 530, 285,
+2178, 335, 729,2179, 397,2180,2181,2182,1030,2183,2184, 698,2185,2186, 325,2187,
+2188, 369,2189, 799,1097,1015, 348,2190,1069, 680,2191, 851,1466,2192,2193,  10,
+2194, 613, 424,2195, 979, 108, 449, 589,  27, 172,  81,1031,  80, 774, 281, 350,
+1032, 525, 301, 582,1176,2196, 674,1045,2197,2198,1467, 730, 762,2199,2200,2201,
+2202,1468,2203, 993,2204,2205, 266,1070, 963,1140,2206,2207,2208, 664,1098, 972,
+2209,2210,2211,1177,1469,1470, 871,2212,2213,2214,2215,2216,1471,2217,2218,2219,
+2220,2221,2222,2223,2224,2225,2226,2227,1472,1236,2228,2229,2230,2231,2232,2233,
+2234,2235,1299,2236,2237, 200,2238, 477, 373,2239,2240, 731, 825, 777,2241,2242,
+2243, 521, 486, 548,2244,2245,2246,1473,1300,  53, 549, 137, 875,  76, 158,2247,
+1301,1474, 469, 396,1016, 278, 712,2248, 321, 442, 503, 767, 744, 941,1237,1178,
+1475,2249,  82, 178,1141,1179, 973,2250,1302,2251, 297,2252,2253, 570,2254,2255,
+2256,  18, 450, 206,2257, 290, 292,1142,2258, 511, 162,  99, 346, 164, 735,2259,
+1476,1477,   4, 554, 343, 798,1099,2260,1100,2261,  43, 171,1303, 139, 215,2262,
+2263, 717, 775,2264,1033, 322, 216,2265, 831,2266, 149,2267,1304,2268,2269, 702,
+1238, 135, 845, 347, 309,2270, 484,2271, 878, 655, 238,1006,1478,2272,  67,2273,
+ 295,2274,2275, 461,2276, 478, 942, 412,2277,1034,2278,2279,2280, 265,2281, 541,
+2282,2283,2284,2285,2286,  70, 852,1071,2287,2288,2289,2290,  21,  56, 509, 117,
+ 432,2291,2292, 331, 980, 552,1101, 148, 284, 105, 393,1180,1239, 755,2293, 187,
+2294,1046,1479,2295, 340,2296,  63,1047, 230,2297,2298,1305, 763,1306, 101, 800,
+ 808, 494,2299,2300,2301, 903,2302,  37,1072,  14,   5,2303,  79, 675,2304, 312,
+2305,2306,2307,2308,2309,1480,   6,1307,2310,2311,2312,   1, 470,  35,  24, 229,
+2313, 695, 210,  86, 778,  15, 784, 592, 779,  32,  77, 855, 964,2314, 259,2315,
+ 501, 380,2316,2317,  83, 981, 153, 689,1308,1481,1482,1483,2318,2319, 716,1484,
+2320,2321,2322,2323,2324,2325,1485,2326,2327, 128,  57,  68, 261,1048, 211, 170,
+1240,  31,2328,  51, 435, 742,2329,2330,2331, 635,2332, 264, 456,2333,2334,2335,
+ 425,2336,1486, 143, 507, 263, 943,2337, 363, 920,1487, 256,1488,1102, 243, 601,
+1489,2338,2339,2340,2341,2342,2343,2344, 861,2345,2346,2347,2348,2349,2350, 395,
+2351,1490,1491,  62, 535, 166, 225,2352,2353, 668, 419,1241, 138, 604, 928,2354,
+1181,2355,1492,1493,2356,2357,2358,1143,2359, 696,2360, 387, 307,1309, 682, 476,
+2361,2362, 332,  12, 222, 156,2363, 232,2364, 641, 276, 656, 517,1494,1495,1035,
+ 416, 736,1496,2365,1017, 586,2366,2367,2368,1497,2369, 242,2370,2371,2372,1498,
+2373, 965, 713,2374,2375,2376,2377, 740, 982,1499, 944,1500,1007,2378,2379,1310,
+1501,2380,2381,2382, 785, 329,2383,2384,1502,2385,2386,2387, 932,2388,1503,2389,
+2390,2391,2392,1242,2393,2394,2395,2396,2397, 994, 950,2398,2399,2400,2401,1504,
+1311,2402,2403,2404,2405,1049, 749,2406,2407, 853, 718,1144,1312,2408,1182,1505,
+2409,2410, 255, 516, 479, 564, 550, 214,1506,1507,1313, 413, 239, 444, 339,1145,
+1036,1508,1509,1314,1037,1510,1315,2411,1511,2412,2413,2414, 176, 703, 497, 624,
+ 593, 921, 302,2415, 341, 165,1103,1512,2416,1513,2417,2418,2419, 376,2420, 700,
+2421,2422,2423, 258, 768,1316,2424,1183,2425, 995, 608,2426,2427,2428,2429, 221,
+2430,2431,2432,2433,2434,2435,2436,2437, 195, 323, 726, 188, 897, 983,1317, 377,
+ 644,1050, 879,2438, 452,2439,2440,2441,2442,2443,2444, 914,2445,2446,2447,2448,
+ 915, 489,2449,1514,1184,2450,2451, 515,  64, 427, 495,2452, 583,2453, 483, 485,
+1038, 562, 213,1515, 748, 666,2454,2455,2456,2457, 334,2458, 780, 996,1008, 705,
+1243,2459,2460,2461,2462,2463, 114,2464, 493,1146, 366, 163,1516, 961,1104,2465,
+ 291,2466,1318,1105,2467,1517, 365,2468, 355, 951,1244,2469,1319,2470, 631,2471,
+2472, 218,1320, 364, 320, 756,1518,1519,1321,1520,1322,2473,2474,2475,2476, 997,
+2477,2478,2479,2480, 665,1185,2481, 916,1521,2482,2483,2484, 584, 684,2485,2486,
+ 797,2487,1051,1186,2488,2489,2490,1522,2491,2492, 370,2493,1039,1187,  65,2494,
+ 434, 205, 463,1188,2495, 125, 812, 391, 402, 826, 699, 286, 398, 155, 781, 771,
+ 585,2496, 590, 505,1073,2497, 599, 244, 219, 917,1018, 952, 646,1523,2498,1323,
+2499,2500,  49, 984, 354, 741,2501, 625,2502,1324,2503,1019, 190, 357, 757, 491,
+  95, 782, 868,2504,2505,2506,2507,2508,2509, 134,1524,1074, 422,1525, 898,2510,
+ 161,2511,2512,2513,2514, 769,2515,1526,2516,2517, 411,1325,2518, 472,1527,2519,
+2520,2521,2522,2523,2524, 985,2525,2526,2527,2528,2529,2530, 764,2531,1245,2532,
+2533,  25, 204, 311,2534, 496,2535,1052,2536,2537,2538,2539,2540,2541,2542, 199,
+ 704, 504, 468, 758, 657,1528, 196,  44, 839,1246, 272, 750,2543, 765, 862,2544,
+2545,1326,2546, 132, 615, 933,2547, 732,2548,2549,2550,1189,1529,2551, 283,1247,
+1053, 607, 929,2552,2553,2554, 930, 183, 872, 616,1040,1147,2555,1148,1020, 441,
+ 249,1075,2556,2557,2558, 466, 743,2559,2560,2561,  92, 514, 426, 420, 526,2562,
+2563,2564,2565,2566,2567,2568, 185,2569,2570,2571,2572, 776,1530, 658,2573, 362,
+2574, 361, 922,1076, 793,2575,2576,2577,2578,2579,2580,1531, 251,2581,2582,2583,
+2584,1532,  54, 612, 237,1327,2585,2586, 275, 408, 647, 111,2587,1533,1106, 465,
+   3, 458,   9,  38,2588, 107, 110, 890, 209,  26, 737, 498,2589,1534,2590, 431,
+ 202,  88,1535, 356, 287,1107, 660,1149,2591, 381,1536, 986,1150, 445,1248,1151,
+ 974,2592,2593, 846,2594, 446, 953, 184,1249,1250, 727,2595, 923, 193, 883,2596,
+2597,2598, 102, 324, 539, 817,2599, 421,1041,2600, 832,2601,  94, 175, 197, 406,
+2602, 459,2603,2604,2605,2606,2607, 330, 555,2608,2609,2610, 706,1108, 389,2611,
+2612,2613,2614, 233,2615, 833, 558, 931, 954,1251,2616,2617,1537, 546,2618,2619,
+1009,2620,2621,2622,1538, 690,1328,2623, 955,2624,1539,2625,2626, 772,2627,2628,
+2629,2630,2631, 924, 648, 863, 603,2632,2633, 934,1540, 864, 865,2634, 642,1042,
+ 670,1190,2635,2636,2637,2638, 168,2639, 652, 873, 542,1054,1541,2640,2641,2642,  # 512, 256
+)
+
diff --git a/openpype/vendor/python/python_2/chardet/euckrprober.py b/openpype/vendor/python/python_2/chardet/euckrprober.py
new file mode 100644
index 0000000000..345a060d02
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/euckrprober.py
@@ -0,0 +1,47 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import EUCKRDistributionAnalysis
+from .mbcssm import EUCKR_SM_MODEL
+
+
+class EUCKRProber(MultiByteCharSetProber):
+    def __init__(self):
+        super(EUCKRProber, self).__init__()
+        self.coding_sm = CodingStateMachine(EUCKR_SM_MODEL)
+        self.distribution_analyzer = EUCKRDistributionAnalysis()
+        self.reset()
+
+    @property
+    def charset_name(self):
+        return "EUC-KR"
+
+    @property
+    def language(self):
+        return "Korean"
diff --git a/openpype/vendor/python/python_2/chardet/euctwfreq.py b/openpype/vendor/python/python_2/chardet/euctwfreq.py
new file mode 100644
index 0000000000..ed7a995a3a
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/euctwfreq.py
@@ -0,0 +1,387 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# EUCTW frequency table
+# Converted from big5 work
+# by Taiwan's Mandarin Promotion Council
+# <http:#www.edu.tw:81/mandr/>
+
+# 128  --> 0.42261
+# 256  --> 0.57851
+# 512  --> 0.74851
+# 1024 --> 0.89384
+# 2048 --> 0.97583
+#
+# Idea Distribution Ratio = 0.74851/(1-0.74851) =2.98
+# Random Distribution Ration = 512/(5401-512)=0.105
+#
+# Typical Distribution Ratio about 25% of Ideal one, still much higher than RDR
+
+EUCTW_TYPICAL_DISTRIBUTION_RATIO = 0.75
+
+# Char to FreqOrder table ,
+EUCTW_TABLE_SIZE = 5376
+
+EUCTW_CHAR_TO_FREQ_ORDER = (
+   1,1800,1506, 255,1431, 198,   9,  82,   6,7310, 177, 202,3615,1256,2808, 110,  # 2742
+3735,  33,3241, 261,  76,  44,2113,  16,2931,2184,1176, 659,3868,  26,3404,2643,  # 2758
+1198,3869,3313,4060, 410,2211, 302, 590, 361,1963,   8, 204,  58,4296,7311,1931,  # 2774
+  63,7312,7313, 317,1614,  75, 222, 159,4061,2412,1480,7314,3500,3068, 224,2809,  # 2790
+3616,   3,  10,3870,1471,  29,2774,1135,2852,1939, 873, 130,3242,1123, 312,7315,  # 2806
+4297,2051, 507, 252, 682,7316, 142,1914, 124, 206,2932,  34,3501,3173,  64, 604,  # 2822
+7317,2494,1976,1977, 155,1990, 645, 641,1606,7318,3405, 337,  72, 406,7319,  80,  # 2838
+ 630, 238,3174,1509, 263, 939,1092,2644, 756,1440,1094,3406, 449,  69,2969, 591,  # 2854
+ 179,2095, 471, 115,2034,1843,  60,  50,2970, 134, 806,1868, 734,2035,3407, 180,  # 2870
+ 995,1607, 156, 537,2893, 688,7320, 319,1305, 779,2144, 514,2374, 298,4298, 359,  # 2886
+2495,  90,2707,1338, 663,  11, 906,1099,2545,  20,2436, 182, 532,1716,7321, 732,  # 2902
+1376,4062,1311,1420,3175,  25,2312,1056, 113, 399, 382,1949, 242,3408,2467, 529,  # 2918
+3243, 475,1447,3617,7322, 117,  21, 656, 810,1297,2295,2329,3502,7323, 126,4063,  # 2934
+ 706, 456, 150, 613,4299,  71,1118,2036,4064, 145,3069,  85, 835, 486,2114,1246,  # 2950
+1426, 428, 727,1285,1015, 800, 106, 623, 303,1281,7324,2127,2354, 347,3736, 221,  # 2966
+3503,3110,7325,1955,1153,4065,  83, 296,1199,3070, 192, 624,  93,7326, 822,1897,  # 2982
+2810,3111, 795,2064, 991,1554,1542,1592,  27,  43,2853, 859, 139,1456, 860,4300,  # 2998
+ 437, 712,3871, 164,2392,3112, 695, 211,3017,2096, 195,3872,1608,3504,3505,3618,  # 3014
+3873, 234, 811,2971,2097,3874,2229,1441,3506,1615,2375, 668,2076,1638, 305, 228,  # 3030
+1664,4301, 467, 415,7327, 262,2098,1593, 239, 108, 300, 200,1033, 512,1247,2077,  # 3046
+7328,7329,2173,3176,3619,2673, 593, 845,1062,3244,  88,1723,2037,3875,1950, 212,  # 3062
+ 266, 152, 149, 468,1898,4066,4302,  77, 187,7330,3018,  37,   5,2972,7331,3876,  # 3078
+7332,7333,  39,2517,4303,2894,3177,2078,  55, 148,  74,4304, 545, 483,1474,1029,  # 3094
+1665, 217,1869,1531,3113,1104,2645,4067,  24, 172,3507, 900,3877,3508,3509,4305,  # 3110
+  32,1408,2811,1312, 329, 487,2355,2247,2708, 784,2674,   4,3019,3314,1427,1788,  # 3126
+ 188, 109, 499,7334,3620,1717,1789, 888,1217,3020,4306,7335,3510,7336,3315,1520,  # 3142
+3621,3878, 196,1034, 775,7337,7338, 929,1815, 249, 439,  38,7339,1063,7340, 794,  # 3158
+3879,1435,2296,  46, 178,3245,2065,7341,2376,7342, 214,1709,4307, 804,  35, 707,  # 3174
+ 324,3622,1601,2546, 140, 459,4068,7343,7344,1365, 839, 272, 978,2257,2572,3409,  # 3190
+2128,1363,3623,1423, 697, 100,3071,  48,  70,1231, 495,3114,2193,7345,1294,7346,  # 3206
+2079, 462, 586,1042,3246, 853, 256, 988, 185,2377,3410,1698, 434,1084,7347,3411,  # 3222
+ 314,2615,2775,4308,2330,2331, 569,2280, 637,1816,2518, 757,1162,1878,1616,3412,  # 3238
+ 287,1577,2115, 768,4309,1671,2854,3511,2519,1321,3737, 909,2413,7348,4069, 933,  # 3254
+3738,7349,2052,2356,1222,4310, 765,2414,1322, 786,4311,7350,1919,1462,1677,2895,  # 3270
+1699,7351,4312,1424,2437,3115,3624,2590,3316,1774,1940,3413,3880,4070, 309,1369,  # 3286
+1130,2812, 364,2230,1653,1299,3881,3512,3882,3883,2646, 525,1085,3021, 902,2000,  # 3302
+1475, 964,4313, 421,1844,1415,1057,2281, 940,1364,3116, 376,4314,4315,1381,   7,  # 3318
+2520, 983,2378, 336,1710,2675,1845, 321,3414, 559,1131,3022,2742,1808,1132,1313,  # 3334
+ 265,1481,1857,7352, 352,1203,2813,3247, 167,1089, 420,2814, 776, 792,1724,3513,  # 3350
+4071,2438,3248,7353,4072,7354, 446, 229, 333,2743, 901,3739,1200,1557,4316,2647,  # 3366
+1920, 395,2744,2676,3740,4073,1835, 125, 916,3178,2616,4317,7355,7356,3741,7357,  # 3382
+7358,7359,4318,3117,3625,1133,2547,1757,3415,1510,2313,1409,3514,7360,2145, 438,  # 3398
+2591,2896,2379,3317,1068, 958,3023, 461, 311,2855,2677,4074,1915,3179,4075,1978,  # 3414
+ 383, 750,2745,2617,4076, 274, 539, 385,1278,1442,7361,1154,1964, 384, 561, 210,  # 3430
+  98,1295,2548,3515,7362,1711,2415,1482,3416,3884,2897,1257, 129,7363,3742, 642,  # 3446
+ 523,2776,2777,2648,7364, 141,2231,1333,  68, 176, 441, 876, 907,4077, 603,2592,  # 3462
+ 710, 171,3417, 404, 549,  18,3118,2393,1410,3626,1666,7365,3516,4319,2898,4320,  # 3478
+7366,2973, 368,7367, 146, 366,  99, 871,3627,1543, 748, 807,1586,1185,  22,2258,  # 3494
+ 379,3743,3180,7368,3181, 505,1941,2618,1991,1382,2314,7369, 380,2357, 218, 702,  # 3510
+1817,1248,3418,3024,3517,3318,3249,7370,2974,3628, 930,3250,3744,7371,  59,7372,  # 3526
+ 585, 601,4078, 497,3419,1112,1314,4321,1801,7373,1223,1472,2174,7374, 749,1836,  # 3542
+ 690,1899,3745,1772,3885,1476, 429,1043,1790,2232,2116, 917,4079, 447,1086,1629,  # 3558
+7375, 556,7376,7377,2020,1654, 844,1090, 105, 550, 966,1758,2815,1008,1782, 686,  # 3574
+1095,7378,2282, 793,1602,7379,3518,2593,4322,4080,2933,2297,4323,3746, 980,2496,  # 3590
+ 544, 353, 527,4324, 908,2678,2899,7380, 381,2619,1942,1348,7381,1341,1252, 560,  # 3606
+3072,7382,3420,2856,7383,2053, 973, 886,2080, 143,4325,7384,7385, 157,3886, 496,  # 3622
+4081,  57, 840, 540,2038,4326,4327,3421,2117,1445, 970,2259,1748,1965,2081,4082,  # 3638
+3119,1234,1775,3251,2816,3629, 773,1206,2129,1066,2039,1326,3887,1738,1725,4083,  # 3654
+ 279,3120,  51,1544,2594, 423,1578,2130,2066, 173,4328,1879,7386,7387,1583, 264,  # 3670
+ 610,3630,4329,2439, 280, 154,7388,7389,7390,1739, 338,1282,3073, 693,2857,1411,  # 3686
+1074,3747,2440,7391,4330,7392,7393,1240, 952,2394,7394,2900,1538,2679, 685,1483,  # 3702
+4084,2468,1436, 953,4085,2054,4331, 671,2395,  79,4086,2441,3252, 608, 567,2680,  # 3718
+3422,4087,4088,1691, 393,1261,1791,2396,7395,4332,7396,7397,7398,7399,1383,1672,  # 3734
+3748,3182,1464, 522,1119, 661,1150, 216, 675,4333,3888,1432,3519, 609,4334,2681,  # 3750
+2397,7400,7401,7402,4089,3025,   0,7403,2469, 315, 231,2442, 301,3319,4335,2380,  # 3766
+7404, 233,4090,3631,1818,4336,4337,7405,  96,1776,1315,2082,7406, 257,7407,1809,  # 3782
+3632,2709,1139,1819,4091,2021,1124,2163,2778,1777,2649,7408,3074, 363,1655,3183,  # 3798
+7409,2975,7410,7411,7412,3889,1567,3890, 718, 103,3184, 849,1443, 341,3320,2934,  # 3814
+1484,7413,1712, 127,  67, 339,4092,2398, 679,1412, 821,7414,7415, 834, 738, 351,  # 3830
+2976,2146, 846, 235,1497,1880, 418,1992,3749,2710, 186,1100,2147,2746,3520,1545,  # 3846
+1355,2935,2858,1377, 583,3891,4093,2573,2977,7416,1298,3633,1078,2549,3634,2358,  # 3862
+  78,3750,3751, 267,1289,2099,2001,1594,4094, 348, 369,1274,2194,2175,1837,4338,  # 3878
+1820,2817,3635,2747,2283,2002,4339,2936,2748, 144,3321, 882,4340,3892,2749,3423,  # 3894
+4341,2901,7417,4095,1726, 320,7418,3893,3026, 788,2978,7419,2818,1773,1327,2859,  # 3910
+3894,2819,7420,1306,4342,2003,1700,3752,3521,2359,2650, 787,2022, 506, 824,3636,  # 3926
+ 534, 323,4343,1044,3322,2023,1900, 946,3424,7421,1778,1500,1678,7422,1881,4344,  # 3942
+ 165, 243,4345,3637,2521, 123, 683,4096, 764,4346,  36,3895,1792, 589,2902, 816,  # 3958
+ 626,1667,3027,2233,1639,1555,1622,3753,3896,7423,3897,2860,1370,1228,1932, 891,  # 3974
+2083,2903, 304,4097,7424, 292,2979,2711,3522, 691,2100,4098,1115,4347, 118, 662,  # 3990
+7425, 611,1156, 854,2381,1316,2861,   2, 386, 515,2904,7426,7427,3253, 868,2234,  # 4006
+1486, 855,2651, 785,2212,3028,7428,1040,3185,3523,7429,3121, 448,7430,1525,7431,  # 4022
+2164,4348,7432,3754,7433,4099,2820,3524,3122, 503, 818,3898,3123,1568, 814, 676,  # 4038
+1444, 306,1749,7434,3755,1416,1030, 197,1428, 805,2821,1501,4349,7435,7436,7437,  # 4054
+1993,7438,4350,7439,7440,2195,  13,2779,3638,2980,3124,1229,1916,7441,3756,2131,  # 4070
+7442,4100,4351,2399,3525,7443,2213,1511,1727,1120,7444,7445, 646,3757,2443, 307,  # 4086
+7446,7447,1595,3186,7448,7449,7450,3639,1113,1356,3899,1465,2522,2523,7451, 519,  # 4102
+7452, 128,2132,  92,2284,1979,7453,3900,1512, 342,3125,2196,7454,2780,2214,1980,  # 4118
+3323,7455, 290,1656,1317, 789, 827,2360,7456,3758,4352, 562, 581,3901,7457, 401,  # 4134
+4353,2248,  94,4354,1399,2781,7458,1463,2024,4355,3187,1943,7459, 828,1105,4101,  # 4150
+1262,1394,7460,4102, 605,4356,7461,1783,2862,7462,2822, 819,2101, 578,2197,2937,  # 4166
+7463,1502, 436,3254,4103,3255,2823,3902,2905,3425,3426,7464,2712,2315,7465,7466,  # 4182
+2332,2067,  23,4357, 193, 826,3759,2102, 699,1630,4104,3075, 390,1793,1064,3526,  # 4198
+7467,1579,3076,3077,1400,7468,4105,1838,1640,2863,7469,4358,4359, 137,4106, 598,  # 4214
+3078,1966, 780, 104, 974,2938,7470, 278, 899, 253, 402, 572, 504, 493,1339,7471,  # 4230
+3903,1275,4360,2574,2550,7472,3640,3029,3079,2249, 565,1334,2713, 863,  41,7473,  # 4246
+7474,4361,7475,1657,2333,  19, 463,2750,4107, 606,7476,2981,3256,1087,2084,1323,  # 4262
+2652,2982,7477,1631,1623,1750,4108,2682,7478,2864, 791,2714,2653,2334, 232,2416,  # 4278
+7479,2983,1498,7480,2654,2620, 755,1366,3641,3257,3126,2025,1609, 119,1917,3427,  # 4294
+ 862,1026,4109,7481,3904,3760,4362,3905,4363,2260,1951,2470,7482,1125, 817,4110,  # 4310
+4111,3906,1513,1766,2040,1487,4112,3030,3258,2824,3761,3127,7483,7484,1507,7485,  # 4326
+2683, 733,  40,1632,1106,2865, 345,4113, 841,2524, 230,4364,2984,1846,3259,3428,  # 4342
+7486,1263, 986,3429,7487, 735, 879, 254,1137, 857, 622,1300,1180,1388,1562,3907,  # 4358
+3908,2939, 967,2751,2655,1349, 592,2133,1692,3324,2985,1994,4114,1679,3909,1901,  # 4374
+2185,7488, 739,3642,2715,1296,1290,7489,4115,2198,2199,1921,1563,2595,2551,1870,  # 4390
+2752,2986,7490, 435,7491, 343,1108, 596,  17,1751,4365,2235,3430,3643,7492,4366,  # 4406
+ 294,3527,2940,1693, 477, 979, 281,2041,3528, 643,2042,3644,2621,2782,2261,1031,  # 4422
+2335,2134,2298,3529,4367, 367,1249,2552,7493,3530,7494,4368,1283,3325,2004, 240,  # 4438
+1762,3326,4369,4370, 836,1069,3128, 474,7495,2148,2525, 268,3531,7496,3188,1521,  # 4454
+1284,7497,1658,1546,4116,7498,3532,3533,7499,4117,3327,2684,1685,4118, 961,1673,  # 4470
+2622, 190,2005,2200,3762,4371,4372,7500, 570,2497,3645,1490,7501,4373,2623,3260,  # 4486
+1956,4374, 584,1514, 396,1045,1944,7502,4375,1967,2444,7503,7504,4376,3910, 619,  # 4502
+7505,3129,3261, 215,2006,2783,2553,3189,4377,3190,4378, 763,4119,3763,4379,7506,  # 4518
+7507,1957,1767,2941,3328,3646,1174, 452,1477,4380,3329,3130,7508,2825,1253,2382,  # 4534
+2186,1091,2285,4120, 492,7509, 638,1169,1824,2135,1752,3911, 648, 926,1021,1324,  # 4550
+4381, 520,4382, 997, 847,1007, 892,4383,3764,2262,1871,3647,7510,2400,1784,4384,  # 4566
+1952,2942,3080,3191,1728,4121,2043,3648,4385,2007,1701,3131,1551,  30,2263,4122,  # 4582
+7511,2026,4386,3534,7512, 501,7513,4123, 594,3431,2165,1821,3535,3432,3536,3192,  # 4598
+ 829,2826,4124,7514,1680,3132,1225,4125,7515,3262,4387,4126,3133,2336,7516,4388,  # 4614
+4127,7517,3912,3913,7518,1847,2383,2596,3330,7519,4389, 374,3914, 652,4128,4129,  # 4630
+ 375,1140, 798,7520,7521,7522,2361,4390,2264, 546,1659, 138,3031,2445,4391,7523,  # 4646
+2250, 612,1848, 910, 796,3765,1740,1371, 825,3766,3767,7524,2906,2554,7525, 692,  # 4662
+ 444,3032,2624, 801,4392,4130,7526,1491, 244,1053,3033,4131,4132, 340,7527,3915,  # 4678
+1041,2987, 293,1168,  87,1357,7528,1539, 959,7529,2236, 721, 694,4133,3768, 219,  # 4694
+1478, 644,1417,3331,2656,1413,1401,1335,1389,3916,7530,7531,2988,2362,3134,1825,  # 4710
+ 730,1515, 184,2827,  66,4393,7532,1660,2943, 246,3332, 378,1457, 226,3433, 975,  # 4726
+3917,2944,1264,3537, 674, 696,7533, 163,7534,1141,2417,2166, 713,3538,3333,4394,  # 4742
+3918,7535,7536,1186,  15,7537,1079,1070,7538,1522,3193,3539, 276,1050,2716, 758,  # 4758
+1126, 653,2945,3263,7539,2337, 889,3540,3919,3081,2989, 903,1250,4395,3920,3434,  # 4774
+3541,1342,1681,1718, 766,3264, 286,  89,2946,3649,7540,1713,7541,2597,3334,2990,  # 4790
+7542,2947,2215,3194,2866,7543,4396,2498,2526, 181, 387,1075,3921, 731,2187,3335,  # 4806
+7544,3265, 310, 313,3435,2299, 770,4134,  54,3034, 189,4397,3082,3769,3922,7545,  # 4822
+1230,1617,1849, 355,3542,4135,4398,3336, 111,4136,3650,1350,3135,3436,3035,4137,  # 4838
+2149,3266,3543,7546,2784,3923,3924,2991, 722,2008,7547,1071, 247,1207,2338,2471,  # 4854
+1378,4399,2009, 864,1437,1214,4400, 373,3770,1142,2216, 667,4401, 442,2753,2555,  # 4870
+3771,3925,1968,4138,3267,1839, 837, 170,1107, 934,1336,1882,7548,7549,2118,4139,  # 4886
+2828, 743,1569,7550,4402,4140, 582,2384,1418,3437,7551,1802,7552, 357,1395,1729,  # 4902
+3651,3268,2418,1564,2237,7553,3083,3772,1633,4403,1114,2085,4141,1532,7554, 482,  # 4918
+2446,4404,7555,7556,1492, 833,1466,7557,2717,3544,1641,2829,7558,1526,1272,3652,  # 4934
+4142,1686,1794, 416,2556,1902,1953,1803,7559,3773,2785,3774,1159,2316,7560,2867,  # 4950
+4405,1610,1584,3036,2419,2754, 443,3269,1163,3136,7561,7562,3926,7563,4143,2499,  # 4966
+3037,4406,3927,3137,2103,1647,3545,2010,1872,4144,7564,4145, 431,3438,7565, 250,  # 4982
+  97,  81,4146,7566,1648,1850,1558, 160, 848,7567, 866, 740,1694,7568,2201,2830,  # 4998
+3195,4147,4407,3653,1687, 950,2472, 426, 469,3196,3654,3655,3928,7569,7570,1188,  # 5014
+ 424,1995, 861,3546,4148,3775,2202,2685, 168,1235,3547,4149,7571,2086,1674,4408,  # 5030
+3337,3270, 220,2557,1009,7572,3776, 670,2992, 332,1208, 717,7573,7574,3548,2447,  # 5046
+3929,3338,7575, 513,7576,1209,2868,3339,3138,4409,1080,7577,7578,7579,7580,2527,  # 5062
+3656,3549, 815,1587,3930,3931,7581,3550,3439,3777,1254,4410,1328,3038,1390,3932,  # 5078
+1741,3933,3778,3934,7582, 236,3779,2448,3271,7583,7584,3657,3780,1273,3781,4411,  # 5094
+7585, 308,7586,4412, 245,4413,1851,2473,1307,2575, 430, 715,2136,2449,7587, 270,  # 5110
+ 199,2869,3935,7588,3551,2718,1753, 761,1754, 725,1661,1840,4414,3440,3658,7589,  # 5126
+7590, 587,  14,3272, 227,2598, 326, 480,2265, 943,2755,3552, 291, 650,1883,7591,  # 5142
+1702,1226, 102,1547,  62,3441, 904,4415,3442,1164,4150,7592,7593,1224,1548,2756,  # 5158
+ 391, 498,1493,7594,1386,1419,7595,2055,1177,4416, 813, 880,1081,2363, 566,1145,  # 5174
+4417,2286,1001,1035,2558,2599,2238, 394,1286,7596,7597,2068,7598,  86,1494,1730,  # 5190
+3936, 491,1588, 745, 897,2948, 843,3340,3937,2757,2870,3273,1768, 998,2217,2069,  # 5206
+ 397,1826,1195,1969,3659,2993,3341, 284,7599,3782,2500,2137,2119,1903,7600,3938,  # 5222
+2150,3939,4151,1036,3443,1904, 114,2559,4152, 209,1527,7601,7602,2949,2831,2625,  # 5238
+2385,2719,3139, 812,2560,7603,3274,7604,1559, 737,1884,3660,1210, 885,  28,2686,  # 5254
+3553,3783,7605,4153,1004,1779,4418,7606, 346,1981,2218,2687,4419,3784,1742, 797,  # 5270
+1642,3940,1933,1072,1384,2151, 896,3941,3275,3661,3197,2871,3554,7607,2561,1958,  # 5286
+4420,2450,1785,7608,7609,7610,3942,4154,1005,1308,3662,4155,2720,4421,4422,1528,  # 5302
+2600, 161,1178,4156,1982, 987,4423,1101,4157, 631,3943,1157,3198,2420,1343,1241,  # 5318
+1016,2239,2562, 372, 877,2339,2501,1160, 555,1934, 911,3944,7611, 466,1170, 169,  # 5334
+1051,2907,2688,3663,2474,2994,1182,2011,2563,1251,2626,7612, 992,2340,3444,1540,  # 5350
+2721,1201,2070,2401,1996,2475,7613,4424, 528,1922,2188,1503,1873,1570,2364,3342,  # 5366
+3276,7614, 557,1073,7615,1827,3445,2087,2266,3140,3039,3084, 767,3085,2786,4425,  # 5382
+1006,4158,4426,2341,1267,2176,3664,3199, 778,3945,3200,2722,1597,2657,7616,4427,  # 5398
+7617,3446,7618,7619,7620,3277,2689,1433,3278, 131,  95,1504,3946, 723,4159,3141,  # 5414
+1841,3555,2758,2189,3947,2027,2104,3665,7621,2995,3948,1218,7622,3343,3201,3949,  # 5430
+4160,2576, 248,1634,3785, 912,7623,2832,3666,3040,3786, 654,  53,7624,2996,7625,  # 5446
+1688,4428, 777,3447,1032,3950,1425,7626, 191, 820,2120,2833, 971,4429, 931,3202,  # 5462
+ 135, 664, 783,3787,1997, 772,2908,1935,3951,3788,4430,2909,3203, 282,2723, 640,  # 5478
+1372,3448,1127, 922, 325,3344,7627,7628, 711,2044,7629,7630,3952,2219,2787,1936,  # 5494
+3953,3345,2220,2251,3789,2300,7631,4431,3790,1258,3279,3954,3204,2138,2950,3955,  # 5510
+3956,7632,2221, 258,3205,4432, 101,1227,7633,3280,1755,7634,1391,3281,7635,2910,  # 5526
+2056, 893,7636,7637,7638,1402,4161,2342,7639,7640,3206,3556,7641,7642, 878,1325,  # 5542
+1780,2788,4433, 259,1385,2577, 744,1183,2267,4434,7643,3957,2502,7644, 684,1024,  # 5558
+4162,7645, 472,3557,3449,1165,3282,3958,3959, 322,2152, 881, 455,1695,1152,1340,  # 5574
+ 660, 554,2153,4435,1058,4436,4163, 830,1065,3346,3960,4437,1923,7646,1703,1918,  # 5590
+7647, 932,2268, 122,7648,4438, 947, 677,7649,3791,2627, 297,1905,1924,2269,4439,  # 5606
+2317,3283,7650,7651,4164,7652,4165,  84,4166, 112, 989,7653, 547,1059,3961, 701,  # 5622
+3558,1019,7654,4167,7655,3450, 942, 639, 457,2301,2451, 993,2951, 407, 851, 494,  # 5638
+4440,3347, 927,7656,1237,7657,2421,3348, 573,4168, 680, 921,2911,1279,1874, 285,  # 5654
+ 790,1448,1983, 719,2167,7658,7659,4441,3962,3963,1649,7660,1541, 563,7661,1077,  # 5670
+7662,3349,3041,3451, 511,2997,3964,3965,3667,3966,1268,2564,3350,3207,4442,4443,  # 5686
+7663, 535,1048,1276,1189,2912,2028,3142,1438,1373,2834,2952,1134,2012,7664,4169,  # 5702
+1238,2578,3086,1259,7665, 700,7666,2953,3143,3668,4170,7667,4171,1146,1875,1906,  # 5718
+4444,2601,3967, 781,2422, 132,1589, 203, 147, 273,2789,2402, 898,1786,2154,3968,  # 5734
+3969,7668,3792,2790,7669,7670,4445,4446,7671,3208,7672,1635,3793, 965,7673,1804,  # 5750
+2690,1516,3559,1121,1082,1329,3284,3970,1449,3794,  65,1128,2835,2913,2759,1590,  # 5766
+3795,7674,7675,  12,2658,  45, 976,2579,3144,4447, 517,2528,1013,1037,3209,7676,  # 5782
+3796,2836,7677,3797,7678,3452,7679,2602, 614,1998,2318,3798,3087,2724,2628,7680,  # 5798
+2580,4172, 599,1269,7681,1810,3669,7682,2691,3088, 759,1060, 489,1805,3351,3285,  # 5814
+1358,7683,7684,2386,1387,1215,2629,2252, 490,7685,7686,4173,1759,2387,2343,7687,  # 5830
+4448,3799,1907,3971,2630,1806,3210,4449,3453,3286,2760,2344, 874,7688,7689,3454,  # 5846
+3670,1858,  91,2914,3671,3042,3800,4450,7690,3145,3972,2659,7691,3455,1202,1403,  # 5862
+3801,2954,2529,1517,2503,4451,3456,2504,7692,4452,7693,2692,1885,1495,1731,3973,  # 5878
+2365,4453,7694,2029,7695,7696,3974,2693,1216, 237,2581,4174,2319,3975,3802,4454,  # 5894
+4455,2694,3560,3457, 445,4456,7697,7698,7699,7700,2761,  61,3976,3672,1822,3977,  # 5910
+7701, 687,2045, 935, 925, 405,2660, 703,1096,1859,2725,4457,3978,1876,1367,2695,  # 5926
+3352, 918,2105,1781,2476, 334,3287,1611,1093,4458, 564,3146,3458,3673,3353, 945,  # 5942
+2631,2057,4459,7702,1925, 872,4175,7703,3459,2696,3089, 349,4176,3674,3979,4460,  # 5958
+3803,4177,3675,2155,3980,4461,4462,4178,4463,2403,2046, 782,3981, 400, 251,4179,  # 5974
+1624,7704,7705, 277,3676, 299,1265, 476,1191,3804,2121,4180,4181,1109, 205,7706,  # 5990
+2582,1000,2156,3561,1860,7707,7708,7709,4464,7710,4465,2565, 107,2477,2157,3982,  # 6006
+3460,3147,7711,1533, 541,1301, 158, 753,4182,2872,3562,7712,1696, 370,1088,4183,  # 6022
+4466,3563, 579, 327, 440, 162,2240, 269,1937,1374,3461, 968,3043,  56,1396,3090,  # 6038
+2106,3288,3354,7713,1926,2158,4467,2998,7714,3564,7715,7716,3677,4468,2478,7717,  # 6054
+2791,7718,1650,4469,7719,2603,7720,7721,3983,2661,3355,1149,3356,3984,3805,3985,  # 6070
+7722,1076,  49,7723, 951,3211,3289,3290, 450,2837, 920,7724,1811,2792,2366,4184,  # 6086
+1908,1138,2367,3806,3462,7725,3212,4470,1909,1147,1518,2423,4471,3807,7726,4472,  # 6102
+2388,2604, 260,1795,3213,7727,7728,3808,3291, 708,7729,3565,1704,7730,3566,1351,  # 6118
+1618,3357,2999,1886, 944,4185,3358,4186,3044,3359,4187,7731,3678, 422, 413,1714,  # 6134
+3292, 500,2058,2345,4188,2479,7732,1344,1910, 954,7733,1668,7734,7735,3986,2404,  # 6150
+4189,3567,3809,4190,7736,2302,1318,2505,3091, 133,3092,2873,4473, 629,  31,2838,  # 6166
+2697,3810,4474, 850, 949,4475,3987,2955,1732,2088,4191,1496,1852,7737,3988, 620,  # 6182
+3214, 981,1242,3679,3360,1619,3680,1643,3293,2139,2452,1970,1719,3463,2168,7738,  # 6198
+3215,7739,7740,3361,1828,7741,1277,4476,1565,2047,7742,1636,3568,3093,7743, 869,  # 6214
+2839, 655,3811,3812,3094,3989,3000,3813,1310,3569,4477,7744,7745,7746,1733, 558,  # 6230
+4478,3681, 335,1549,3045,1756,4192,3682,1945,3464,1829,1291,1192, 470,2726,2107,  # 6246
+2793, 913,1054,3990,7747,1027,7748,3046,3991,4479, 982,2662,3362,3148,3465,3216,  # 6262
+3217,1946,2794,7749, 571,4480,7750,1830,7751,3570,2583,1523,2424,7752,2089, 984,  # 6278
+4481,3683,1959,7753,3684, 852, 923,2795,3466,3685, 969,1519, 999,2048,2320,1705,  # 6294
+7754,3095, 615,1662, 151, 597,3992,2405,2321,1049, 275,4482,3686,4193, 568,3687,  # 6310
+3571,2480,4194,3688,7755,2425,2270, 409,3218,7756,1566,2874,3467,1002, 769,2840,  # 6326
+ 194,2090,3149,3689,2222,3294,4195, 628,1505,7757,7758,1763,2177,3001,3993, 521,  # 6342
+1161,2584,1787,2203,2406,4483,3994,1625,4196,4197, 412,  42,3096, 464,7759,2632,  # 6358
+4484,3363,1760,1571,2875,3468,2530,1219,2204,3814,2633,2140,2368,4485,4486,3295,  # 6374
+1651,3364,3572,7760,7761,3573,2481,3469,7762,3690,7763,7764,2271,2091, 460,7765,  # 6390
+4487,7766,3002, 962, 588,3574, 289,3219,2634,1116,  52,7767,3047,1796,7768,7769,  # 6406
+7770,1467,7771,1598,1143,3691,4198,1984,1734,1067,4488,1280,3365, 465,4489,1572,  # 6422
+ 510,7772,1927,2241,1812,1644,3575,7773,4490,3692,7774,7775,2663,1573,1534,7776,  # 6438
+7777,4199, 536,1807,1761,3470,3815,3150,2635,7778,7779,7780,4491,3471,2915,1911,  # 6454
+2796,7781,3296,1122, 377,3220,7782, 360,7783,7784,4200,1529, 551,7785,2059,3693,  # 6470
+1769,2426,7786,2916,4201,3297,3097,2322,2108,2030,4492,1404, 136,1468,1479, 672,  # 6486
+1171,3221,2303, 271,3151,7787,2762,7788,2049, 678,2727, 865,1947,4493,7789,2013,  # 6502
+3995,2956,7790,2728,2223,1397,3048,3694,4494,4495,1735,2917,3366,3576,7791,3816,  # 6518
+ 509,2841,2453,2876,3817,7792,7793,3152,3153,4496,4202,2531,4497,2304,1166,1010,  # 6534
+ 552, 681,1887,7794,7795,2957,2958,3996,1287,1596,1861,3154, 358, 453, 736, 175,  # 6550
+ 478,1117, 905,1167,1097,7796,1853,1530,7797,1706,7798,2178,3472,2287,3695,3473,  # 6566
+3577,4203,2092,4204,7799,3367,1193,2482,4205,1458,2190,2205,1862,1888,1421,3298,  # 6582
+2918,3049,2179,3474, 595,2122,7800,3997,7801,7802,4206,1707,2636, 223,3696,1359,  # 6598
+ 751,3098, 183,3475,7803,2797,3003, 419,2369, 633, 704,3818,2389, 241,7804,7805,  # 6614
+7806, 838,3004,3697,2272,2763,2454,3819,1938,2050,3998,1309,3099,2242,1181,7807,  # 6630
+1136,2206,3820,2370,1446,4207,2305,4498,7808,7809,4208,1055,2605, 484,3698,7810,  # 6646
+3999, 625,4209,2273,3368,1499,4210,4000,7811,4001,4211,3222,2274,2275,3476,7812,  # 6662
+7813,2764, 808,2606,3699,3369,4002,4212,3100,2532, 526,3370,3821,4213, 955,7814,  # 6678
+1620,4214,2637,2427,7815,1429,3700,1669,1831, 994, 928,7816,3578,1260,7817,7818,  # 6694
+7819,1948,2288, 741,2919,1626,4215,2729,2455, 867,1184, 362,3371,1392,7820,7821,  # 6710
+4003,4216,1770,1736,3223,2920,4499,4500,1928,2698,1459,1158,7822,3050,3372,2877,  # 6726
+1292,1929,2506,2842,3701,1985,1187,2071,2014,2607,4217,7823,2566,2507,2169,3702,  # 6742
+2483,3299,7824,3703,4501,7825,7826, 666,1003,3005,1022,3579,4218,7827,4502,1813,  # 6758
+2253, 574,3822,1603, 295,1535, 705,3823,4219, 283, 858, 417,7828,7829,3224,4503,  # 6774
+4504,3051,1220,1889,1046,2276,2456,4004,1393,1599, 689,2567, 388,4220,7830,2484,  # 6790
+ 802,7831,2798,3824,2060,1405,2254,7832,4505,3825,2109,1052,1345,3225,1585,7833,  # 6806
+ 809,7834,7835,7836, 575,2730,3477, 956,1552,1469,1144,2323,7837,2324,1560,2457,  # 6822
+3580,3226,4005, 616,2207,3155,2180,2289,7838,1832,7839,3478,4506,7840,1319,3704,  # 6838
+3705,1211,3581,1023,3227,1293,2799,7841,7842,7843,3826, 607,2306,3827, 762,2878,  # 6854
+1439,4221,1360,7844,1485,3052,7845,4507,1038,4222,1450,2061,2638,4223,1379,4508,  # 6870
+2585,7846,7847,4224,1352,1414,2325,2921,1172,7848,7849,3828,3829,7850,1797,1451,  # 6886
+7851,7852,7853,7854,2922,4006,4007,2485,2346, 411,4008,4009,3582,3300,3101,4509,  # 6902
+1561,2664,1452,4010,1375,7855,7856,  47,2959, 316,7857,1406,1591,2923,3156,7858,  # 6918
+1025,2141,3102,3157, 354,2731, 884,2224,4225,2407, 508,3706, 726,3583, 996,2428,  # 6934
+3584, 729,7859, 392,2191,1453,4011,4510,3707,7860,7861,2458,3585,2608,1675,2800,  # 6950
+ 919,2347,2960,2348,1270,4511,4012,  73,7862,7863, 647,7864,3228,2843,2255,1550,  # 6966
+1346,3006,7865,1332, 883,3479,7866,7867,7868,7869,3301,2765,7870,1212, 831,1347,  # 6982
+4226,4512,2326,3830,1863,3053, 720,3831,4513,4514,3832,7871,4227,7872,7873,4515,  # 6998
+7874,7875,1798,4516,3708,2609,4517,3586,1645,2371,7876,7877,2924, 669,2208,2665,  # 7014
+2429,7878,2879,7879,7880,1028,3229,7881,4228,2408,7882,2256,1353,7883,7884,4518,  # 7030
+3158, 518,7885,4013,7886,4229,1960,7887,2142,4230,7888,7889,3007,2349,2350,3833,  # 7046
+ 516,1833,1454,4014,2699,4231,4519,2225,2610,1971,1129,3587,7890,2766,7891,2961,  # 7062
+1422, 577,1470,3008,1524,3373,7892,7893, 432,4232,3054,3480,7894,2586,1455,2508,  # 7078
+2226,1972,1175,7895,1020,2732,4015,3481,4520,7896,2733,7897,1743,1361,3055,3482,  # 7094
+2639,4016,4233,4521,2290, 895, 924,4234,2170, 331,2243,3056, 166,1627,3057,1098,  # 7110
+7898,1232,2880,2227,3374,4522, 657, 403,1196,2372, 542,3709,3375,1600,4235,3483,  # 7126
+7899,4523,2767,3230, 576, 530,1362,7900,4524,2533,2666,3710,4017,7901, 842,3834,  # 7142
+7902,2801,2031,1014,4018, 213,2700,3376, 665, 621,4236,7903,3711,2925,2430,7904,  # 7158
+2431,3302,3588,3377,7905,4237,2534,4238,4525,3589,1682,4239,3484,1380,7906, 724,  # 7174
+2277, 600,1670,7907,1337,1233,4526,3103,2244,7908,1621,4527,7909, 651,4240,7910,  # 7190
+1612,4241,2611,7911,2844,7912,2734,2307,3058,7913, 716,2459,3059, 174,1255,2701,  # 7206
+4019,3590, 548,1320,1398, 728,4020,1574,7914,1890,1197,3060,4021,7915,3061,3062,  # 7222
+3712,3591,3713, 747,7916, 635,4242,4528,7917,7918,7919,4243,7920,7921,4529,7922,  # 7238
+3378,4530,2432, 451,7923,3714,2535,2072,4244,2735,4245,4022,7924,1764,4531,7925,  # 7254
+4246, 350,7926,2278,2390,2486,7927,4247,4023,2245,1434,4024, 488,4532, 458,4248,  # 7270
+4025,3715, 771,1330,2391,3835,2568,3159,2159,2409,1553,2667,3160,4249,7928,2487,  # 7286
+2881,2612,1720,2702,4250,3379,4533,7929,2536,4251,7930,3231,4252,2768,7931,2015,  # 7302
+2736,7932,1155,1017,3716,3836,7933,3303,2308, 201,1864,4253,1430,7934,4026,7935,  # 7318
+7936,7937,7938,7939,4254,1604,7940, 414,1865, 371,2587,4534,4535,3485,2016,3104,  # 7334
+4536,1708, 960,4255, 887, 389,2171,1536,1663,1721,7941,2228,4027,2351,2926,1580,  # 7350
+7942,7943,7944,1744,7945,2537,4537,4538,7946,4539,7947,2073,7948,7949,3592,3380,  # 7366
+2882,4256,7950,4257,2640,3381,2802, 673,2703,2460, 709,3486,4028,3593,4258,7951,  # 7382
+1148, 502, 634,7952,7953,1204,4540,3594,1575,4541,2613,3717,7954,3718,3105, 948,  # 7398
+3232, 121,1745,3837,1110,7955,4259,3063,2509,3009,4029,3719,1151,1771,3838,1488,  # 7414
+4030,1986,7956,2433,3487,7957,7958,2093,7959,4260,3839,1213,1407,2803, 531,2737,  # 7430
+2538,3233,1011,1537,7960,2769,4261,3106,1061,7961,3720,3721,1866,2883,7962,2017,  # 7446
+ 120,4262,4263,2062,3595,3234,2309,3840,2668,3382,1954,4542,7963,7964,3488,1047,  # 7462
+2704,1266,7965,1368,4543,2845, 649,3383,3841,2539,2738,1102,2846,2669,7966,7967,  # 7478
+1999,7968,1111,3596,2962,7969,2488,3842,3597,2804,1854,3384,3722,7970,7971,3385,  # 7494
+2410,2884,3304,3235,3598,7972,2569,7973,3599,2805,4031,1460, 856,7974,3600,7975,  # 7510
+2885,2963,7976,2886,3843,7977,4264, 632,2510, 875,3844,1697,3845,2291,7978,7979,  # 7526
+4544,3010,1239, 580,4545,4265,7980, 914, 936,2074,1190,4032,1039,2123,7981,7982,  # 7542
+7983,3386,1473,7984,1354,4266,3846,7985,2172,3064,4033, 915,3305,4267,4268,3306,  # 7558
+1605,1834,7986,2739, 398,3601,4269,3847,4034, 328,1912,2847,4035,3848,1331,4270,  # 7574
+3011, 937,4271,7987,3602,4036,4037,3387,2160,4546,3388, 524, 742, 538,3065,1012,  # 7590
+7988,7989,3849,2461,7990, 658,1103, 225,3850,7991,7992,4547,7993,4548,7994,3236,  # 7606
+1243,7995,4038, 963,2246,4549,7996,2705,3603,3161,7997,7998,2588,2327,7999,4550,  # 7622
+8000,8001,8002,3489,3307, 957,3389,2540,2032,1930,2927,2462, 870,2018,3604,1746,  # 7638
+2770,2771,2434,2463,8003,3851,8004,3723,3107,3724,3490,3390,3725,8005,1179,3066,  # 7654
+8006,3162,2373,4272,3726,2541,3163,3108,2740,4039,8007,3391,1556,2542,2292, 977,  # 7670
+2887,2033,4040,1205,3392,8008,1765,3393,3164,2124,1271,1689, 714,4551,3491,8009,  # 7686
+2328,3852, 533,4273,3605,2181, 617,8010,2464,3308,3492,2310,8011,8012,3165,8013,  # 7702
+8014,3853,1987, 618, 427,2641,3493,3394,8015,8016,1244,1690,8017,2806,4274,4552,  # 7718
+8018,3494,8019,8020,2279,1576, 473,3606,4275,3395, 972,8021,3607,8022,3067,8023,  # 7734
+8024,4553,4554,8025,3727,4041,4042,8026, 153,4555, 356,8027,1891,2888,4276,2143,  # 7750
+ 408, 803,2352,8028,3854,8029,4277,1646,2570,2511,4556,4557,3855,8030,3856,4278,  # 7766
+8031,2411,3396, 752,8032,8033,1961,2964,8034, 746,3012,2465,8035,4279,3728, 698,  # 7782
+4558,1892,4280,3608,2543,4559,3609,3857,8036,3166,3397,8037,1823,1302,4043,2706,  # 7798
+3858,1973,4281,8038,4282,3167, 823,1303,1288,1236,2848,3495,4044,3398, 774,3859,  # 7814
+8039,1581,4560,1304,2849,3860,4561,8040,2435,2161,1083,3237,4283,4045,4284, 344,  # 7830
+1173, 288,2311, 454,1683,8041,8042,1461,4562,4046,2589,8043,8044,4563, 985, 894,  # 7846
+8045,3399,3168,8046,1913,2928,3729,1988,8047,2110,1974,8048,4047,8049,2571,1194,  # 7862
+ 425,8050,4564,3169,1245,3730,4285,8051,8052,2850,8053, 636,4565,1855,3861, 760,  # 7878
+1799,8054,4286,2209,1508,4566,4048,1893,1684,2293,8055,8056,8057,4287,4288,2210,  # 7894
+ 479,8058,8059, 832,8060,4049,2489,8061,2965,2490,3731, 990,3109, 627,1814,2642,  # 7910
+4289,1582,4290,2125,2111,3496,4567,8062, 799,4291,3170,8063,4568,2112,1737,3013,  # 7926
+1018, 543, 754,4292,3309,1676,4569,4570,4050,8064,1489,8065,3497,8066,2614,2889,  # 7942
+4051,8067,8068,2966,8069,8070,8071,8072,3171,4571,4572,2182,1722,8073,3238,3239,  # 7958
+1842,3610,1715, 481, 365,1975,1856,8074,8075,1962,2491,4573,8076,2126,3611,3240,  # 7974
+ 433,1894,2063,2075,8077, 602,2741,8078,8079,8080,8081,8082,3014,1628,3400,8083,  # 7990
+3172,4574,4052,2890,4575,2512,8084,2544,2772,8085,8086,8087,3310,4576,2891,8088,  # 8006
+4577,8089,2851,4578,4579,1221,2967,4053,2513,8090,8091,8092,1867,1989,8093,8094,  # 8022
+8095,1895,8096,8097,4580,1896,4054, 318,8098,2094,4055,4293,8099,8100, 485,8101,  # 8038
+ 938,3862, 553,2670, 116,8102,3863,3612,8103,3498,2671,2773,3401,3311,2807,8104,  # 8054
+3613,2929,4056,1747,2930,2968,8105,8106, 207,8107,8108,2672,4581,2514,8109,3015,  # 8070
+ 890,3614,3864,8110,1877,3732,3402,8111,2183,2353,3403,1652,8112,8113,8114, 941,  # 8086
+2294, 208,3499,4057,2019, 330,4294,3865,2892,2492,3733,4295,8115,8116,8117,8118,  # 8102
+)
+
diff --git a/openpype/vendor/python/python_2/chardet/euctwprober.py b/openpype/vendor/python/python_2/chardet/euctwprober.py
new file mode 100644
index 0000000000..35669cc4dd
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/euctwprober.py
@@ -0,0 +1,46 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import EUCTWDistributionAnalysis
+from .mbcssm import EUCTW_SM_MODEL
+
+class EUCTWProber(MultiByteCharSetProber):
+    def __init__(self):
+        super(EUCTWProber, self).__init__()
+        self.coding_sm = CodingStateMachine(EUCTW_SM_MODEL)
+        self.distribution_analyzer = EUCTWDistributionAnalysis()
+        self.reset()
+
+    @property
+    def charset_name(self):
+        return "EUC-TW"
+
+    @property
+    def language(self):
+        return "Taiwan"
diff --git a/openpype/vendor/python/python_2/chardet/gb2312freq.py b/openpype/vendor/python/python_2/chardet/gb2312freq.py
new file mode 100644
index 0000000000..697837bd9a
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/gb2312freq.py
@@ -0,0 +1,283 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# GB2312 most frequently used character table
+#
+# Char to FreqOrder table , from hz6763
+
+# 512  --> 0.79  -- 0.79
+# 1024 --> 0.92  -- 0.13
+# 2048 --> 0.98  -- 0.06
+# 6768 --> 1.00  -- 0.02
+#
+# Ideal Distribution Ratio = 0.79135/(1-0.79135) = 3.79
+# Random Distribution Ration = 512 / (3755 - 512) = 0.157
+#
+# Typical Distribution Ratio about 25% of Ideal one, still much higher that RDR
+
+GB2312_TYPICAL_DISTRIBUTION_RATIO = 0.9
+
+GB2312_TABLE_SIZE = 3760
+
+GB2312_CHAR_TO_FREQ_ORDER = (
+1671, 749,1443,2364,3924,3807,2330,3921,1704,3463,2691,1511,1515, 572,3191,2205,
+2361, 224,2558, 479,1711, 963,3162, 440,4060,1905,2966,2947,3580,2647,3961,3842,
+2204, 869,4207, 970,2678,5626,2944,2956,1479,4048, 514,3595, 588,1346,2820,3409,
+ 249,4088,1746,1873,2047,1774, 581,1813, 358,1174,3590,1014,1561,4844,2245, 670,
+1636,3112, 889,1286, 953, 556,2327,3060,1290,3141, 613, 185,3477,1367, 850,3820,
+1715,2428,2642,2303,2732,3041,2562,2648,3566,3946,1349, 388,3098,2091,1360,3585,
+ 152,1687,1539, 738,1559,  59,1232,2925,2267,1388,1249,1741,1679,2960, 151,1566,
+1125,1352,4271, 924,4296, 385,3166,4459, 310,1245,2850,  70,3285,2729,3534,3575,
+2398,3298,3466,1960,2265, 217,3647, 864,1909,2084,4401,2773,1010,3269,5152, 853,
+3051,3121,1244,4251,1895, 364,1499,1540,2313,1180,3655,2268, 562, 715,2417,3061,
+ 544, 336,3768,2380,1752,4075, 950, 280,2425,4382, 183,2759,3272, 333,4297,2155,
+1688,2356,1444,1039,4540, 736,1177,3349,2443,2368,2144,2225, 565, 196,1482,3406,
+ 927,1335,4147, 692, 878,1311,1653,3911,3622,1378,4200,1840,2969,3149,2126,1816,
+2534,1546,2393,2760, 737,2494,  13, 447, 245,2747,  38,2765,2129,2589,1079, 606,
+ 360, 471,3755,2890, 404, 848, 699,1785,1236, 370,2221,1023,3746,2074,2026,2023,
+2388,1581,2119, 812,1141,3091,2536,1519, 804,2053, 406,1596,1090, 784, 548,4414,
+1806,2264,2936,1100, 343,4114,5096, 622,3358, 743,3668,1510,1626,5020,3567,2513,
+3195,4115,5627,2489,2991,  24,2065,2697,1087,2719,  48,1634, 315,  68, 985,2052,
+ 198,2239,1347,1107,1439, 597,2366,2172, 871,3307, 919,2487,2790,1867, 236,2570,
+1413,3794, 906,3365,3381,1701,1982,1818,1524,2924,1205, 616,2586,2072,2004, 575,
+ 253,3099,  32,1365,1182, 197,1714,2454,1201, 554,3388,3224,2748, 756,2587, 250,
+2567,1507,1517,3529,1922,2761,2337,3416,1961,1677,2452,2238,3153, 615, 911,1506,
+1474,2495,1265,1906,2749,3756,3280,2161, 898,2714,1759,3450,2243,2444, 563,  26,
+3286,2266,3769,3344,2707,3677, 611,1402, 531,1028,2871,4548,1375, 261,2948, 835,
+1190,4134, 353, 840,2684,1900,3082,1435,2109,1207,1674, 329,1872,2781,4055,2686,
+2104, 608,3318,2423,2957,2768,1108,3739,3512,3271,3985,2203,1771,3520,1418,2054,
+1681,1153, 225,1627,2929, 162,2050,2511,3687,1954, 124,1859,2431,1684,3032,2894,
+ 585,4805,3969,2869,2704,2088,2032,2095,3656,2635,4362,2209, 256, 518,2042,2105,
+3777,3657, 643,2298,1148,1779, 190, 989,3544, 414,  11,2135,2063,2979,1471, 403,
+3678, 126, 770,1563, 671,2499,3216,2877, 600,1179, 307,2805,4937,1268,1297,2694,
+ 252,4032,1448,1494,1331,1394, 127,2256, 222,1647,1035,1481,3056,1915,1048, 873,
+3651, 210,  33,1608,2516, 200,1520, 415, 102,   0,3389,1287, 817,  91,3299,2940,
+ 836,1814, 549,2197,1396,1669,2987,3582,2297,2848,4528,1070, 687,  20,1819, 121,
+1552,1364,1461,1968,2617,3540,2824,2083, 177, 948,4938,2291, 110,4549,2066, 648,
+3359,1755,2110,2114,4642,4845,1693,3937,3308,1257,1869,2123, 208,1804,3159,2992,
+2531,2549,3361,2418,1350,2347,2800,2568,1291,2036,2680,  72, 842,1990, 212,1233,
+1154,1586,  75,2027,3410,4900,1823,1337,2710,2676, 728,2810,1522,3026,4995, 157,
+ 755,1050,4022, 710, 785,1936,2194,2085,1406,2777,2400, 150,1250,4049,1206, 807,
+1910, 534, 529,3309,1721,1660, 274,  39,2827, 661,2670,1578, 925,3248,3815,1094,
+4278,4901,4252,  41,1150,3747,2572,2227,4501,3658,4902,3813,3357,3617,2884,2258,
+ 887, 538,4187,3199,1294,2439,3042,2329,2343,2497,1255, 107, 543,1527, 521,3478,
+3568, 194,5062,  15, 961,3870,1241,1192,2664,  66,5215,3260,2111,1295,1127,2152,
+3805,4135, 901,1164,1976, 398,1278, 530,1460, 748, 904,1054,1966,1426,  53,2909,
+ 509, 523,2279,1534, 536,1019, 239,1685, 460,2353, 673,1065,2401,3600,4298,2272,
+1272,2363, 284,1753,3679,4064,1695,  81, 815,2677,2757,2731,1386, 859, 500,4221,
+2190,2566, 757,1006,2519,2068,1166,1455, 337,2654,3203,1863,1682,1914,3025,1252,
+1409,1366, 847, 714,2834,2038,3209, 964,2970,1901, 885,2553,1078,1756,3049, 301,
+1572,3326, 688,2130,1996,2429,1805,1648,2930,3421,2750,3652,3088, 262,1158,1254,
+ 389,1641,1812, 526,1719, 923,2073,1073,1902, 468, 489,4625,1140, 857,2375,3070,
+3319,2863, 380, 116,1328,2693,1161,2244, 273,1212,1884,2769,3011,1775,1142, 461,
+3066,1200,2147,2212, 790, 702,2695,4222,1601,1058, 434,2338,5153,3640,  67,2360,
+4099,2502, 618,3472,1329, 416,1132, 830,2782,1807,2653,3211,3510,1662, 192,2124,
+ 296,3979,1739,1611,3684,  23, 118, 324, 446,1239,1225, 293,2520,3814,3795,2535,
+3116,  17,1074, 467,2692,2201, 387,2922,  45,1326,3055,1645,3659,2817, 958, 243,
+1903,2320,1339,2825,1784,3289, 356, 576, 865,2315,2381,3377,3916,1088,3122,1713,
+1655, 935, 628,4689,1034,1327, 441, 800, 720, 894,1979,2183,1528,5289,2702,1071,
+4046,3572,2399,1571,3281,  79, 761,1103, 327, 134, 758,1899,1371,1615, 879, 442,
+ 215,2605,2579, 173,2048,2485,1057,2975,3317,1097,2253,3801,4263,1403,1650,2946,
+ 814,4968,3487,1548,2644,1567,1285,   2, 295,2636,  97, 946,3576, 832, 141,4257,
+3273, 760,3821,3521,3156,2607, 949,1024,1733,1516,1803,1920,2125,2283,2665,3180,
+1501,2064,3560,2171,1592, 803,3518,1416, 732,3897,4258,1363,1362,2458, 119,1427,
+ 602,1525,2608,1605,1639,3175, 694,3064,  10, 465,  76,2000,4846,4208, 444,3781,
+1619,3353,2206,1273,3796, 740,2483, 320,1723,2377,3660,2619,1359,1137,1762,1724,
+2345,2842,1850,1862, 912, 821,1866, 612,2625,1735,2573,3369,1093, 844,  89, 937,
+ 930,1424,3564,2413,2972,1004,3046,3019,2011, 711,3171,1452,4178, 428, 801,1943,
+ 432, 445,2811, 206,4136,1472, 730, 349,  73, 397,2802,2547, 998,1637,1167, 789,
+ 396,3217, 154,1218, 716,1120,1780,2819,4826,1931,3334,3762,2139,1215,2627, 552,
+3664,3628,3232,1405,2383,3111,1356,2652,3577,3320,3101,1703, 640,1045,1370,1246,
+4996, 371,1575,2436,1621,2210, 984,4033,1734,2638,  16,4529, 663,2755,3255,1451,
+3917,2257,1253,1955,2234,1263,2951, 214,1229, 617, 485, 359,1831,1969, 473,2310,
+ 750,2058, 165,  80,2864,2419, 361,4344,2416,2479,1134, 796,3726,1266,2943, 860,
+2715, 938, 390,2734,1313,1384, 248, 202, 877,1064,2854, 522,3907, 279,1602, 297,
+2357, 395,3740, 137,2075, 944,4089,2584,1267,3802,  62,1533,2285, 178, 176, 780,
+2440, 201,3707, 590, 478,1560,4354,2117,1075,  30,  74,4643,4004,1635,1441,2745,
+ 776,2596, 238,1077,1692,1912,2844, 605, 499,1742,3947, 241,3053, 980,1749, 936,
+2640,4511,2582, 515,1543,2162,5322,2892,2993, 890,2148,1924, 665,1827,3581,1032,
+ 968,3163, 339,1044,1896, 270, 583,1791,1720,4367,1194,3488,3669,  43,2523,1657,
+ 163,2167, 290,1209,1622,3378, 550, 634,2508,2510, 695,2634,2384,2512,1476,1414,
+ 220,1469,2341,2138,2852,3183,2900,4939,2865,3502,1211,3680, 854,3227,1299,2976,
+3172, 186,2998,1459, 443,1067,3251,1495, 321,1932,3054, 909, 753,1410,1828, 436,
+2441,1119,1587,3164,2186,1258, 227, 231,1425,1890,3200,3942, 247, 959, 725,5254,
+2741, 577,2158,2079, 929, 120, 174, 838,2813, 591,1115, 417,2024,  40,3240,1536,
+1037, 291,4151,2354, 632,1298,2406,2500,3535,1825,1846,3451, 205,1171, 345,4238,
+  18,1163, 811, 685,2208,1217, 425,1312,1508,1175,4308,2552,1033, 587,1381,3059,
+2984,3482, 340,1316,4023,3972, 792,3176, 519, 777,4690, 918, 933,4130,2981,3741,
+  90,3360,2911,2200,5184,4550, 609,3079,2030, 272,3379,2736, 363,3881,1130,1447,
+ 286, 779, 357,1169,3350,3137,1630,1220,2687,2391, 747,1277,3688,2618,2682,2601,
+1156,3196,5290,4034,3102,1689,3596,3128, 874, 219,2783, 798, 508,1843,2461, 269,
+1658,1776,1392,1913,2983,3287,2866,2159,2372, 829,4076,  46,4253,2873,1889,1894,
+ 915,1834,1631,2181,2318, 298, 664,2818,3555,2735, 954,3228,3117, 527,3511,2173,
+ 681,2712,3033,2247,2346,3467,1652, 155,2164,3382, 113,1994, 450, 899, 494, 994,
+1237,2958,1875,2336,1926,3727, 545,1577,1550, 633,3473, 204,1305,3072,2410,1956,
+2471, 707,2134, 841,2195,2196,2663,3843,1026,4940, 990,3252,4997, 368,1092, 437,
+3212,3258,1933,1829, 675,2977,2893, 412, 943,3723,4644,3294,3283,2230,2373,5154,
+2389,2241,2661,2323,1404,2524, 593, 787, 677,3008,1275,2059, 438,2709,2609,2240,
+2269,2246,1446,  36,1568,1373,3892,1574,2301,1456,3962, 693,2276,5216,2035,1143,
+2720,1919,1797,1811,2763,4137,2597,1830,1699,1488,1198,2090, 424,1694, 312,3634,
+3390,4179,3335,2252,1214, 561,1059,3243,2295,2561, 975,5155,2321,2751,3772, 472,
+1537,3282,3398,1047,2077,2348,2878,1323,3340,3076, 690,2906,  51, 369, 170,3541,
+1060,2187,2688,3670,2541,1083,1683, 928,3918, 459, 109,4427, 599,3744,4286, 143,
+2101,2730,2490,  82,1588,3036,2121, 281,1860, 477,4035,1238,2812,3020,2716,3312,
+1530,2188,2055,1317, 843, 636,1808,1173,3495, 649, 181,1002, 147,3641,1159,2414,
+3750,2289,2795, 813,3123,2610,1136,4368,   5,3391,4541,2174, 420, 429,1728, 754,
+1228,2115,2219, 347,2223,2733, 735,1518,3003,2355,3134,1764,3948,3329,1888,2424,
+1001,1234,1972,3321,3363,1672,1021,1450,1584, 226, 765, 655,2526,3404,3244,2302,
+3665, 731, 594,2184, 319,1576, 621, 658,2656,4299,2099,3864,1279,2071,2598,2739,
+ 795,3086,3699,3908,1707,2352,2402,1382,3136,2475,1465,4847,3496,3865,1085,3004,
+2591,1084, 213,2287,1963,3565,2250, 822, 793,4574,3187,1772,1789,3050, 595,1484,
+1959,2770,1080,2650, 456, 422,2996, 940,3322,4328,4345,3092,2742, 965,2784, 739,
+4124, 952,1358,2498,2949,2565, 332,2698,2378, 660,2260,2473,4194,3856,2919, 535,
+1260,2651,1208,1428,1300,1949,1303,2942, 433,2455,2450,1251,1946, 614,1269, 641,
+1306,1810,2737,3078,2912, 564,2365,1419,1415,1497,4460,2367,2185,1379,3005,1307,
+3218,2175,1897,3063, 682,1157,4040,4005,1712,1160,1941,1399, 394, 402,2952,1573,
+1151,2986,2404, 862, 299,2033,1489,3006, 346, 171,2886,3401,1726,2932, 168,2533,
+  47,2507,1030,3735,1145,3370,1395,1318,1579,3609,4560,2857,4116,1457,2529,1965,
+ 504,1036,2690,2988,2405, 745,5871, 849,2397,2056,3081, 863,2359,3857,2096,  99,
+1397,1769,2300,4428,1643,3455,1978,1757,3718,1440,  35,4879,3742,1296,4228,2280,
+ 160,5063,1599,2013, 166, 520,3479,1646,3345,3012, 490,1937,1545,1264,2182,2505,
+1096,1188,1369,1436,2421,1667,2792,2460,1270,2122, 727,3167,2143, 806,1706,1012,
+1800,3037, 960,2218,1882, 805, 139,2456,1139,1521, 851,1052,3093,3089, 342,2039,
+ 744,5097,1468,1502,1585,2087, 223, 939, 326,2140,2577, 892,2481,1623,4077, 982,
+3708, 135,2131,  87,2503,3114,2326,1106, 876,1616, 547,2997,2831,2093,3441,4530,
+4314,   9,3256,4229,4148, 659,1462,1986,1710,2046,2913,2231,4090,4880,5255,3392,
+3274,1368,3689,4645,1477, 705,3384,3635,1068,1529,2941,1458,3782,1509, 100,1656,
+2548, 718,2339, 408,1590,2780,3548,1838,4117,3719,1345,3530, 717,3442,2778,3220,
+2898,1892,4590,3614,3371,2043,1998,1224,3483, 891, 635, 584,2559,3355, 733,1766,
+1729,1172,3789,1891,2307, 781,2982,2271,1957,1580,5773,2633,2005,4195,3097,1535,
+3213,1189,1934,5693,3262, 586,3118,1324,1598, 517,1564,2217,1868,1893,4445,3728,
+2703,3139,1526,1787,1992,3882,2875,1549,1199,1056,2224,1904,2711,5098,4287, 338,
+1993,3129,3489,2689,1809,2815,1997, 957,1855,3898,2550,3275,3057,1105,1319, 627,
+1505,1911,1883,3526, 698,3629,3456,1833,1431, 746,  77,1261,2017,2296,1977,1885,
+ 125,1334,1600, 525,1798,1109,2222,1470,1945, 559,2236,1186,3443,2476,1929,1411,
+2411,3135,1777,3372,2621,1841,1613,3229, 668,1430,1839,2643,2916, 195,1989,2671,
+2358,1387, 629,3205,2293,5256,4439, 123,1310, 888,1879,4300,3021,3605,1003,1162,
+3192,2910,2010, 140,2395,2859,  55,1082,2012,2901, 662, 419,2081,1438, 680,2774,
+4654,3912,1620,1731,1625,5035,4065,2328, 512,1344, 802,5443,2163,2311,2537, 524,
+3399,  98,1155,2103,1918,2606,3925,2816,1393,2465,1504,3773,2177,3963,1478,4346,
+ 180,1113,4655,3461,2028,1698, 833,2696,1235,1322,1594,4408,3623,3013,3225,2040,
+3022, 541,2881, 607,3632,2029,1665,1219, 639,1385,1686,1099,2803,3231,1938,3188,
+2858, 427, 676,2772,1168,2025, 454,3253,2486,3556, 230,1950, 580, 791,1991,1280,
+1086,1974,2034, 630, 257,3338,2788,4903,1017,  86,4790, 966,2789,1995,1696,1131,
+ 259,3095,4188,1308, 179,1463,5257, 289,4107,1248,  42,3413,1725,2288, 896,1947,
+ 774,4474,4254, 604,3430,4264, 392,2514,2588, 452, 237,1408,3018, 988,4531,1970,
+3034,3310, 540,2370,1562,1288,2990, 502,4765,1147,   4,1853,2708, 207, 294,2814,
+4078,2902,2509, 684,  34,3105,3532,2551, 644, 709,2801,2344, 573,1727,3573,3557,
+2021,1081,3100,4315,2100,3681, 199,2263,1837,2385, 146,3484,1195,2776,3949, 997,
+1939,3973,1008,1091,1202,1962,1847,1149,4209,5444,1076, 493, 117,5400,2521, 972,
+1490,2934,1796,4542,2374,1512,2933,2657, 413,2888,1135,2762,2314,2156,1355,2369,
+ 766,2007,2527,2170,3124,2491,2593,2632,4757,2437, 234,3125,3591,1898,1750,1376,
+1942,3468,3138, 570,2127,2145,3276,4131, 962, 132,1445,4196,  19, 941,3624,3480,
+3366,1973,1374,4461,3431,2629, 283,2415,2275, 808,2887,3620,2112,2563,1353,3610,
+ 955,1089,3103,1053,  96,  88,4097, 823,3808,1583, 399, 292,4091,3313, 421,1128,
+ 642,4006, 903,2539,1877,2082, 596,  29,4066,1790, 722,2157, 130, 995,1569, 769,
+1485, 464, 513,2213, 288,1923,1101,2453,4316, 133, 486,2445,  50, 625, 487,2207,
+  57, 423, 481,2962, 159,3729,1558, 491, 303, 482, 501, 240,2837, 112,3648,2392,
+1783, 362,   8,3433,3422, 610,2793,3277,1390,1284,1654,  21,3823, 734, 367, 623,
+ 193, 287, 374,1009,1483, 816, 476, 313,2255,2340,1262,2150,2899,1146,2581, 782,
+2116,1659,2018,1880, 255,3586,3314,1110,2867,2137,2564, 986,2767,5185,2006, 650,
+ 158, 926, 762, 881,3157,2717,2362,3587, 306,3690,3245,1542,3077,2427,1691,2478,
+2118,2985,3490,2438, 539,2305, 983, 129,1754, 355,4201,2386, 827,2923, 104,1773,
+2838,2771, 411,2905,3919, 376, 767, 122,1114, 828,2422,1817,3506, 266,3460,1007,
+1609,4998, 945,2612,4429,2274, 726,1247,1964,2914,2199,2070,4002,4108, 657,3323,
+1422, 579, 455,2764,4737,1222,2895,1670, 824,1223,1487,2525, 558, 861,3080, 598,
+2659,2515,1967, 752,2583,2376,2214,4180, 977, 704,2464,4999,2622,4109,1210,2961,
+ 819,1541, 142,2284,  44, 418, 457,1126,3730,4347,4626,1644,1876,3671,1864, 302,
+1063,5694, 624, 723,1984,3745,1314,1676,2488,1610,1449,3558,3569,2166,2098, 409,
+1011,2325,3704,2306, 818,1732,1383,1824,1844,3757, 999,2705,3497,1216,1423,2683,
+2426,2954,2501,2726,2229,1475,2554,5064,1971,1794,1666,2014,1343, 783, 724, 191,
+2434,1354,2220,5065,1763,2752,2472,4152, 131, 175,2885,3434,  92,1466,4920,2616,
+3871,3872,3866, 128,1551,1632, 669,1854,3682,4691,4125,1230, 188,2973,3290,1302,
+1213, 560,3266, 917, 763,3909,3249,1760, 868,1958, 764,1782,2097, 145,2277,3774,
+4462,  64,1491,3062, 971,2132,3606,2442, 221,1226,1617, 218, 323,1185,3207,3147,
+ 571, 619,1473,1005,1744,2281, 449,1887,2396,3685, 275, 375,3816,1743,3844,3731,
+ 845,1983,2350,4210,1377, 773, 967,3499,3052,3743,2725,4007,1697,1022,3943,1464,
+3264,2855,2722,1952,1029,2839,2467,  84,4383,2215, 820,1391,2015,2448,3672, 377,
+1948,2168, 797,2545,3536,2578,2645,  94,2874,1678, 405,1259,3071, 771, 546,1315,
+ 470,1243,3083, 895,2468, 981, 969,2037, 846,4181, 653,1276,2928,  14,2594, 557,
+3007,2474, 156, 902,1338,1740,2574, 537,2518, 973,2282,2216,2433,1928, 138,2903,
+1293,2631,1612, 646,3457, 839,2935, 111, 496,2191,2847, 589,3186, 149,3994,2060,
+4031,2641,4067,3145,1870,  37,3597,2136,1025,2051,3009,3383,3549,1121,1016,3261,
+1301, 251,2446,2599,2153, 872,3246, 637, 334,3705, 831, 884, 921,3065,3140,4092,
+2198,1944, 246,2964, 108,2045,1152,1921,2308,1031, 203,3173,4170,1907,3890, 810,
+1401,2003,1690, 506, 647,1242,2828,1761,1649,3208,2249,1589,3709,2931,5156,1708,
+ 498, 666,2613, 834,3817,1231, 184,2851,1124, 883,3197,2261,3710,1765,1553,2658,
+1178,2639,2351,  93,1193, 942,2538,2141,4402, 235,1821, 870,1591,2192,1709,1871,
+3341,1618,4126,2595,2334, 603, 651,  69, 701, 268,2662,3411,2555,1380,1606, 503,
+ 448, 254,2371,2646, 574,1187,2309,1770, 322,2235,1292,1801, 305, 566,1133, 229,
+2067,2057, 706, 167, 483,2002,2672,3295,1820,3561,3067, 316, 378,2746,3452,1112,
+ 136,1981, 507,1651,2917,1117, 285,4591, 182,2580,3522,1304, 335,3303,1835,2504,
+1795,1792,2248, 674,1018,2106,2449,1857,2292,2845, 976,3047,1781,2600,2727,1389,
+1281,  52,3152, 153, 265,3950, 672,3485,3951,4463, 430,1183, 365, 278,2169,  27,
+1407,1336,2304, 209,1340,1730,2202,1852,2403,2883, 979,1737,1062, 631,2829,2542,
+3876,2592, 825,2086,2226,3048,3625, 352,1417,3724, 542, 991, 431,1351,3938,1861,
+2294, 826,1361,2927,3142,3503,1738, 463,2462,2723, 582,1916,1595,2808, 400,3845,
+3891,2868,3621,2254,  58,2492,1123, 910,2160,2614,1372,1603,1196,1072,3385,1700,
+3267,1980, 696, 480,2430, 920, 799,1570,2920,1951,2041,4047,2540,1321,4223,2469,
+3562,2228,1271,2602, 401,2833,3351,2575,5157, 907,2312,1256, 410, 263,3507,1582,
+ 996, 678,1849,2316,1480, 908,3545,2237, 703,2322, 667,1826,2849,1531,2604,2999,
+2407,3146,2151,2630,1786,3711, 469,3542, 497,3899,2409, 858, 837,4446,3393,1274,
+ 786, 620,1845,2001,3311, 484, 308,3367,1204,1815,3691,2332,1532,2557,1842,2020,
+2724,1927,2333,4440, 567,  22,1673,2728,4475,1987,1858,1144,1597, 101,1832,3601,
+  12, 974,3783,4391, 951,1412,   1,3720, 453,4608,4041, 528,1041,1027,3230,2628,
+1129, 875,1051,3291,1203,2262,1069,2860,2799,2149,2615,3278, 144,1758,3040,  31,
+ 475,1680, 366,2685,3184, 311,1642,4008,2466,5036,1593,1493,2809, 216,1420,1668,
+ 233, 304,2128,3284, 232,1429,1768,1040,2008,3407,2740,2967,2543, 242,2133, 778,
+1565,2022,2620, 505,2189,2756,1098,2273, 372,1614, 708, 553,2846,2094,2278, 169,
+3626,2835,4161, 228,2674,3165, 809,1454,1309, 466,1705,1095, 900,3423, 880,2667,
+3751,5258,2317,3109,2571,4317,2766,1503,1342, 866,4447,1118,  63,2076, 314,1881,
+1348,1061, 172, 978,3515,1747, 532, 511,3970,   6, 601, 905,2699,3300,1751, 276,
+1467,3725,2668,  65,4239,2544,2779,2556,1604, 578,2451,1802, 992,2331,2624,1320,
+3446, 713,1513,1013, 103,2786,2447,1661, 886,1702, 916, 654,3574,2031,1556, 751,
+2178,2821,2179,1498,1538,2176, 271, 914,2251,2080,1325, 638,1953,2937,3877,2432,
+2754,  95,3265,1716, 260,1227,4083, 775, 106,1357,3254, 426,1607, 555,2480, 772,
+1985, 244,2546, 474, 495,1046,2611,1851,2061,  71,2089,1675,2590, 742,3758,2843,
+3222,1433, 267,2180,2576,2826,2233,2092,3913,2435, 956,1745,3075, 856,2113,1116,
+ 451,   3,1988,2896,1398, 993,2463,1878,2049,1341,2718,2721,2870,2108, 712,2904,
+4363,2753,2324, 277,2872,2349,2649, 384, 987, 435, 691,3000, 922, 164,3939, 652,
+1500,1184,4153,2482,3373,2165,4848,2335,3775,3508,3154,2806,2830,1554,2102,1664,
+2530,1434,2408, 893,1547,2623,3447,2832,2242,2532,3169,2856,3223,2078,  49,3770,
+3469, 462, 318, 656,2259,3250,3069, 679,1629,2758, 344,1138,1104,3120,1836,1283,
+3115,2154,1437,4448, 934, 759,1999, 794,2862,1038, 533,2560,1722,2342, 855,2626,
+1197,1663,4476,3127,  85,4240,2528,  25,1111,1181,3673, 407,3470,4561,2679,2713,
+ 768,1925,2841,3986,1544,1165, 932, 373,1240,2146,1930,2673, 721,4766, 354,4333,
+ 391,2963, 187,  61,3364,1442,1102, 330,1940,1767, 341,3809,4118, 393,2496,2062,
+2211, 105, 331, 300, 439, 913,1332, 626, 379,3304,1557, 328, 689,3952, 309,1555,
+ 931, 317,2517,3027, 325, 569, 686,2107,3084,  60,1042,1333,2794, 264,3177,4014,
+1628, 258,3712,   7,4464,1176,1043,1778, 683, 114,1975,  78,1492, 383,1886, 510,
+ 386, 645,5291,2891,2069,3305,4138,3867,2939,2603,2493,1935,1066,1848,3588,1015,
+1282,1289,4609, 697,1453,3044,2666,3611,1856,2412,  54, 719,1330, 568,3778,2459,
+1748, 788, 492, 551,1191,1000, 488,3394,3763, 282,1799, 348,2016,1523,3155,2390,
+1049, 382,2019,1788,1170, 729,2968,3523, 897,3926,2785,2938,3292, 350,2319,3238,
+1718,1717,2655,3453,3143,4465, 161,2889,2980,2009,1421,  56,1908,1640,2387,2232,
+1917,1874,2477,4921, 148,  83,3438, 592,4245,2882,1822,1055, 741, 115,1496,1624,
+ 381,1638,4592,1020, 516,3214, 458, 947,4575,1432, 211,1514,2926,1865,2142, 189,
+ 852,1221,1400,1486, 882,2299,4036, 351,  28,1122, 700,6479,6480,6481,6482,6483,  #last 512
+)
+
diff --git a/openpype/vendor/python/python_2/chardet/gb2312prober.py b/openpype/vendor/python/python_2/chardet/gb2312prober.py
new file mode 100644
index 0000000000..8446d2dd95
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/gb2312prober.py
@@ -0,0 +1,46 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import GB2312DistributionAnalysis
+from .mbcssm import GB2312_SM_MODEL
+
+class GB2312Prober(MultiByteCharSetProber):
+    def __init__(self):
+        super(GB2312Prober, self).__init__()
+        self.coding_sm = CodingStateMachine(GB2312_SM_MODEL)
+        self.distribution_analyzer = GB2312DistributionAnalysis()
+        self.reset()
+
+    @property
+    def charset_name(self):
+        return "GB2312"
+
+    @property
+    def language(self):
+        return "Chinese"
diff --git a/openpype/vendor/python/python_2/chardet/hebrewprober.py b/openpype/vendor/python/python_2/chardet/hebrewprober.py
new file mode 100644
index 0000000000..b0e1bf4926
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/hebrewprober.py
@@ -0,0 +1,292 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+#          Shy Shalom
+# Portions created by the Initial Developer are Copyright (C) 2005
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetprober import CharSetProber
+from .enums import ProbingState
+
+# This prober doesn't actually recognize a language or a charset.
+# It is a helper prober for the use of the Hebrew model probers
+
+### General ideas of the Hebrew charset recognition ###
+#
+# Four main charsets exist in Hebrew:
+# "ISO-8859-8" - Visual Hebrew
+# "windows-1255" - Logical Hebrew
+# "ISO-8859-8-I" - Logical Hebrew
+# "x-mac-hebrew" - ?? Logical Hebrew ??
+#
+# Both "ISO" charsets use a completely identical set of code points, whereas
+# "windows-1255" and "x-mac-hebrew" are two different proper supersets of
+# these code points. windows-1255 defines additional characters in the range
+# 0x80-0x9F as some misc punctuation marks as well as some Hebrew-specific
+# diacritics and additional 'Yiddish' ligature letters in the range 0xc0-0xd6.
+# x-mac-hebrew defines similar additional code points but with a different
+# mapping.
+#
+# As far as an average Hebrew text with no diacritics is concerned, all four
+# charsets are identical with respect to code points. Meaning that for the
+# main Hebrew alphabet, all four map the same values to all 27 Hebrew letters
+# (including final letters).
+#
+# The dominant difference between these charsets is their directionality.
+# "Visual" directionality means that the text is ordered as if the renderer is
+# not aware of a BIDI rendering algorithm. The renderer sees the text and
+# draws it from left to right. The text itself when ordered naturally is read
+# backwards. A buffer of Visual Hebrew generally looks like so:
+# "[last word of first line spelled backwards] [whole line ordered backwards
+# and spelled backwards] [first word of first line spelled backwards]
+# [end of line] [last word of second line] ... etc' "
+# adding punctuation marks, numbers and English text to visual text is
+# naturally also "visual" and from left to right.
+#
+# "Logical" directionality means the text is ordered "naturally" according to
+# the order it is read. It is the responsibility of the renderer to display
+# the text from right to left. A BIDI algorithm is used to place general
+# punctuation marks, numbers and English text in the text.
+#
+# Texts in x-mac-hebrew are almost impossible to find on the Internet. From
+# what little evidence I could find, it seems that its general directionality
+# is Logical.
+#
+# To sum up all of the above, the Hebrew probing mechanism knows about two
+# charsets:
+# Visual Hebrew - "ISO-8859-8" - backwards text - Words and sentences are
+#    backwards while line order is natural. For charset recognition purposes
+#    the line order is unimportant (In fact, for this implementation, even
+#    word order is unimportant).
+# Logical Hebrew - "windows-1255" - normal, naturally ordered text.
+#
+# "ISO-8859-8-I" is a subset of windows-1255 and doesn't need to be
+#    specifically identified.
+# "x-mac-hebrew" is also identified as windows-1255. A text in x-mac-hebrew
+#    that contain special punctuation marks or diacritics is displayed with
+#    some unconverted characters showing as question marks. This problem might
+#    be corrected using another model prober for x-mac-hebrew. Due to the fact
+#    that x-mac-hebrew texts are so rare, writing another model prober isn't
+#    worth the effort and performance hit.
+#
+#### The Prober ####
+#
+# The prober is divided between two SBCharSetProbers and a HebrewProber,
+# all of which are managed, created, fed data, inquired and deleted by the
+# SBCSGroupProber. The two SBCharSetProbers identify that the text is in
+# fact some kind of Hebrew, Logical or Visual. The final decision about which
+# one is it is made by the HebrewProber by combining final-letter scores
+# with the scores of the two SBCharSetProbers to produce a final answer.
+#
+# The SBCSGroupProber is responsible for stripping the original text of HTML
+# tags, English characters, numbers, low-ASCII punctuation characters, spaces
+# and new lines. It reduces any sequence of such characters to a single space.
+# The buffer fed to each prober in the SBCS group prober is pure text in
+# high-ASCII.
+# The two SBCharSetProbers (model probers) share the same language model:
+# Win1255Model.
+# The first SBCharSetProber uses the model normally as any other
+# SBCharSetProber does, to recognize windows-1255, upon which this model was
+# built. The second SBCharSetProber is told to make the pair-of-letter
+# lookup in the language model backwards. This in practice exactly simulates
+# a visual Hebrew model using the windows-1255 logical Hebrew model.
+#
+# The HebrewProber is not using any language model. All it does is look for
+# final-letter evidence suggesting the text is either logical Hebrew or visual
+# Hebrew. Disjointed from the model probers, the results of the HebrewProber
+# alone are meaningless. HebrewProber always returns 0.00 as confidence
+# since it never identifies a charset by itself. Instead, the pointer to the
+# HebrewProber is passed to the model probers as a helper "Name Prober".
+# When the Group prober receives a positive identification from any prober,
+# it asks for the name of the charset identified. If the prober queried is a
+# Hebrew model prober, the model prober forwards the call to the
+# HebrewProber to make the final decision. In the HebrewProber, the
+# decision is made according to the final-letters scores maintained and Both
+# model probers scores. The answer is returned in the form of the name of the
+# charset identified, either "windows-1255" or "ISO-8859-8".
+
+class HebrewProber(CharSetProber):
+    # windows-1255 / ISO-8859-8 code points of interest
+    FINAL_KAF = 0xea
+    NORMAL_KAF = 0xeb
+    FINAL_MEM = 0xed
+    NORMAL_MEM = 0xee
+    FINAL_NUN = 0xef
+    NORMAL_NUN = 0xf0
+    FINAL_PE = 0xf3
+    NORMAL_PE = 0xf4
+    FINAL_TSADI = 0xf5
+    NORMAL_TSADI = 0xf6
+
+    # Minimum Visual vs Logical final letter score difference.
+    # If the difference is below this, don't rely solely on the final letter score
+    # distance.
+    MIN_FINAL_CHAR_DISTANCE = 5
+
+    # Minimum Visual vs Logical model score difference.
+    # If the difference is below this, don't rely at all on the model score
+    # distance.
+    MIN_MODEL_DISTANCE = 0.01
+
+    VISUAL_HEBREW_NAME = "ISO-8859-8"
+    LOGICAL_HEBREW_NAME = "windows-1255"
+
+    def __init__(self):
+        super(HebrewProber, self).__init__()
+        self._final_char_logical_score = None
+        self._final_char_visual_score = None
+        self._prev = None
+        self._before_prev = None
+        self._logical_prober = None
+        self._visual_prober = None
+        self.reset()
+
+    def reset(self):
+        self._final_char_logical_score = 0
+        self._final_char_visual_score = 0
+        # The two last characters seen in the previous buffer,
+        # mPrev and mBeforePrev are initialized to space in order to simulate
+        # a word delimiter at the beginning of the data
+        self._prev = ' '
+        self._before_prev = ' '
+        # These probers are owned by the group prober.
+
+    def set_model_probers(self, logicalProber, visualProber):
+        self._logical_prober = logicalProber
+        self._visual_prober = visualProber
+
+    def is_final(self, c):
+        return c in [self.FINAL_KAF, self.FINAL_MEM, self.FINAL_NUN,
+                     self.FINAL_PE, self.FINAL_TSADI]
+
+    def is_non_final(self, c):
+        # The normal Tsadi is not a good Non-Final letter due to words like
+        # 'lechotet' (to chat) containing an apostrophe after the tsadi. This
+        # apostrophe is converted to a space in FilterWithoutEnglishLetters
+        # causing the Non-Final tsadi to appear at an end of a word even
+        # though this is not the case in the original text.
+        # The letters Pe and Kaf rarely display a related behavior of not being
+        # a good Non-Final letter. Words like 'Pop', 'Winamp' and 'Mubarak'
+        # for example legally end with a Non-Final Pe or Kaf. However, the
+        # benefit of these letters as Non-Final letters outweighs the damage
+        # since these words are quite rare.
+        return c in [self.NORMAL_KAF, self.NORMAL_MEM,
+                     self.NORMAL_NUN, self.NORMAL_PE]
+
+    def feed(self, byte_str):
+        # Final letter analysis for logical-visual decision.
+        # Look for evidence that the received buffer is either logical Hebrew
+        # or visual Hebrew.
+        # The following cases are checked:
+        # 1) A word longer than 1 letter, ending with a final letter. This is
+        #    an indication that the text is laid out "naturally" since the
+        #    final letter really appears at the end. +1 for logical score.
+        # 2) A word longer than 1 letter, ending with a Non-Final letter. In
+        #    normal Hebrew, words ending with Kaf, Mem, Nun, Pe or Tsadi,
+        #    should not end with the Non-Final form of that letter. Exceptions
+        #    to this rule are mentioned above in isNonFinal(). This is an
+        #    indication that the text is laid out backwards. +1 for visual
+        #    score
+        # 3) A word longer than 1 letter, starting with a final letter. Final
+        #    letters should not appear at the beginning of a word. This is an
+        #    indication that the text is laid out backwards. +1 for visual
+        #    score.
+        #
+        # The visual score and logical score are accumulated throughout the
+        # text and are finally checked against each other in GetCharSetName().
+        # No checking for final letters in the middle of words is done since
+        # that case is not an indication for either Logical or Visual text.
+        #
+        # We automatically filter out all 7-bit characters (replace them with
+        # spaces) so the word boundary detection works properly. [MAP]
+
+        if self.state == ProbingState.NOT_ME:
+            # Both model probers say it's not them. No reason to continue.
+            return ProbingState.NOT_ME
+
+        byte_str = self.filter_high_byte_only(byte_str)
+
+        for cur in byte_str:
+            if cur == ' ':
+                # We stand on a space - a word just ended
+                if self._before_prev != ' ':
+                    # next-to-last char was not a space so self._prev is not a
+                    # 1 letter word
+                    if self.is_final(self._prev):
+                        # case (1) [-2:not space][-1:final letter][cur:space]
+                        self._final_char_logical_score += 1
+                    elif self.is_non_final(self._prev):
+                        # case (2) [-2:not space][-1:Non-Final letter][
+                        #  cur:space]
+                        self._final_char_visual_score += 1
+            else:
+                # Not standing on a space
+                if ((self._before_prev == ' ') and
+                        (self.is_final(self._prev)) and (cur != ' ')):
+                    # case (3) [-2:space][-1:final letter][cur:not space]
+                    self._final_char_visual_score += 1
+            self._before_prev = self._prev
+            self._prev = cur
+
+        # Forever detecting, till the end or until both model probers return
+        # ProbingState.NOT_ME (handled above)
+        return ProbingState.DETECTING
+
+    @property
+    def charset_name(self):
+        # Make the decision: is it Logical or Visual?
+        # If the final letter score distance is dominant enough, rely on it.
+        finalsub = self._final_char_logical_score - self._final_char_visual_score
+        if finalsub >= self.MIN_FINAL_CHAR_DISTANCE:
+            return self.LOGICAL_HEBREW_NAME
+        if finalsub <= -self.MIN_FINAL_CHAR_DISTANCE:
+            return self.VISUAL_HEBREW_NAME
+
+        # It's not dominant enough, try to rely on the model scores instead.
+        modelsub = (self._logical_prober.get_confidence()
+                    - self._visual_prober.get_confidence())
+        if modelsub > self.MIN_MODEL_DISTANCE:
+            return self.LOGICAL_HEBREW_NAME
+        if modelsub < -self.MIN_MODEL_DISTANCE:
+            return self.VISUAL_HEBREW_NAME
+
+        # Still no good, back to final letter distance, maybe it'll save the
+        # day.
+        if finalsub < 0.0:
+            return self.VISUAL_HEBREW_NAME
+
+        # (finalsub > 0 - Logical) or (don't know what to do) default to
+        # Logical.
+        return self.LOGICAL_HEBREW_NAME
+
+    @property
+    def language(self):
+        return 'Hebrew'
+
+    @property
+    def state(self):
+        # Remain active as long as any of the model probers are active.
+        if (self._logical_prober.state == ProbingState.NOT_ME) and \
+           (self._visual_prober.state == ProbingState.NOT_ME):
+            return ProbingState.NOT_ME
+        return ProbingState.DETECTING
diff --git a/openpype/vendor/python/python_2/chardet/jisfreq.py b/openpype/vendor/python/python_2/chardet/jisfreq.py
new file mode 100644
index 0000000000..83fc082b54
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/jisfreq.py
@@ -0,0 +1,325 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# Sampling from about 20M text materials include literature and computer technology
+#
+# Japanese frequency table, applied to both S-JIS and EUC-JP
+# They are sorted in order.
+
+# 128  --> 0.77094
+# 256  --> 0.85710
+# 512  --> 0.92635
+# 1024 --> 0.97130
+# 2048 --> 0.99431
+#
+# Ideal Distribution Ratio = 0.92635 / (1-0.92635) = 12.58
+# Random Distribution Ration = 512 / (2965+62+83+86-512) = 0.191
+#
+# Typical Distribution Ratio, 25% of IDR
+
+JIS_TYPICAL_DISTRIBUTION_RATIO = 3.0
+
+# Char to FreqOrder table ,
+JIS_TABLE_SIZE = 4368
+
+JIS_CHAR_TO_FREQ_ORDER = (
+  40,   1,   6, 182, 152, 180, 295,2127, 285, 381,3295,4304,3068,4606,3165,3510, #   16
+3511,1822,2785,4607,1193,2226,5070,4608, 171,2996,1247,  18, 179,5071, 856,1661, #   32
+1262,5072, 619, 127,3431,3512,3230,1899,1700, 232, 228,1294,1298, 284, 283,2041, #   48
+2042,1061,1062,  48,  49,  44,  45, 433, 434,1040,1041, 996, 787,2997,1255,4305, #   64
+2108,4609,1684,1648,5073,5074,5075,5076,5077,5078,3687,5079,4610,5080,3927,3928, #   80
+5081,3296,3432, 290,2285,1471,2187,5082,2580,2825,1303,2140,1739,1445,2691,3375, #   96
+1691,3297,4306,4307,4611, 452,3376,1182,2713,3688,3069,4308,5083,5084,5085,5086, #  112
+5087,5088,5089,5090,5091,5092,5093,5094,5095,5096,5097,5098,5099,5100,5101,5102, #  128
+5103,5104,5105,5106,5107,5108,5109,5110,5111,5112,4097,5113,5114,5115,5116,5117, #  144
+5118,5119,5120,5121,5122,5123,5124,5125,5126,5127,5128,5129,5130,5131,5132,5133, #  160
+5134,5135,5136,5137,5138,5139,5140,5141,5142,5143,5144,5145,5146,5147,5148,5149, #  176
+5150,5151,5152,4612,5153,5154,5155,5156,5157,5158,5159,5160,5161,5162,5163,5164, #  192
+5165,5166,5167,5168,5169,5170,5171,5172,5173,5174,5175,1472, 598, 618, 820,1205, #  208
+1309,1412,1858,1307,1692,5176,5177,5178,5179,5180,5181,5182,1142,1452,1234,1172, #  224
+1875,2043,2149,1793,1382,2973, 925,2404,1067,1241, 960,1377,2935,1491, 919,1217, #  240
+1865,2030,1406,1499,2749,4098,5183,5184,5185,5186,5187,5188,2561,4099,3117,1804, #  256
+2049,3689,4309,3513,1663,5189,3166,3118,3298,1587,1561,3433,5190,3119,1625,2998, #  272
+3299,4613,1766,3690,2786,4614,5191,5192,5193,5194,2161,  26,3377,   2,3929,  20, #  288
+3691,  47,4100,  50,  17,  16,  35, 268,  27, 243,  42, 155,  24, 154,  29, 184, #  304
+   4,  91,  14,  92,  53, 396,  33, 289,   9,  37,  64, 620,  21,  39, 321,   5, #  320
+  12,  11,  52,  13,   3, 208, 138,   0,   7,  60, 526, 141, 151,1069, 181, 275, #  336
+1591,  83, 132,1475, 126, 331, 829,  15,  69, 160,  59,  22, 157,  55,1079, 312, #  352
+ 109,  38,  23,  25,  10,  19,  79,5195,  61, 382,1124,   8,  30,5196,5197,5198, #  368
+5199,5200,5201,5202,5203,5204,5205,5206,  89,  62,  74,  34,2416, 112, 139, 196, #  384
+ 271, 149,  84, 607, 131, 765,  46,  88, 153, 683,  76, 874, 101, 258,  57,  80, #  400
+  32, 364, 121,1508, 169,1547,  68, 235, 145,2999,  41, 360,3027,  70,  63,  31, #  416
+  43, 259, 262,1383,  99, 533, 194,  66,  93, 846, 217, 192,  56, 106,  58, 565, #  432
+ 280, 272, 311, 256, 146,  82, 308,  71, 100, 128, 214, 655, 110, 261, 104,1140, #  448
+  54,  51,  36,  87,  67,3070, 185,2618,2936,2020,  28,1066,2390,2059,5207,5208, #  464
+5209,5210,5211,5212,5213,5214,5215,5216,4615,5217,5218,5219,5220,5221,5222,5223, #  480
+5224,5225,5226,5227,5228,5229,5230,5231,5232,5233,5234,5235,5236,3514,5237,5238, #  496
+5239,5240,5241,5242,5243,5244,2297,2031,4616,4310,3692,5245,3071,5246,3598,5247, #  512
+4617,3231,3515,5248,4101,4311,4618,3808,4312,4102,5249,4103,4104,3599,5250,5251, #  528
+5252,5253,5254,5255,5256,5257,5258,5259,5260,5261,5262,5263,5264,5265,5266,5267, #  544
+5268,5269,5270,5271,5272,5273,5274,5275,5276,5277,5278,5279,5280,5281,5282,5283, #  560
+5284,5285,5286,5287,5288,5289,5290,5291,5292,5293,5294,5295,5296,5297,5298,5299, #  576
+5300,5301,5302,5303,5304,5305,5306,5307,5308,5309,5310,5311,5312,5313,5314,5315, #  592
+5316,5317,5318,5319,5320,5321,5322,5323,5324,5325,5326,5327,5328,5329,5330,5331, #  608
+5332,5333,5334,5335,5336,5337,5338,5339,5340,5341,5342,5343,5344,5345,5346,5347, #  624
+5348,5349,5350,5351,5352,5353,5354,5355,5356,5357,5358,5359,5360,5361,5362,5363, #  640
+5364,5365,5366,5367,5368,5369,5370,5371,5372,5373,5374,5375,5376,5377,5378,5379, #  656
+5380,5381, 363, 642,2787,2878,2788,2789,2316,3232,2317,3434,2011, 165,1942,3930, #  672
+3931,3932,3933,5382,4619,5383,4620,5384,5385,5386,5387,5388,5389,5390,5391,5392, #  688
+5393,5394,5395,5396,5397,5398,5399,5400,5401,5402,5403,5404,5405,5406,5407,5408, #  704
+5409,5410,5411,5412,5413,5414,5415,5416,5417,5418,5419,5420,5421,5422,5423,5424, #  720
+5425,5426,5427,5428,5429,5430,5431,5432,5433,5434,5435,5436,5437,5438,5439,5440, #  736
+5441,5442,5443,5444,5445,5446,5447,5448,5449,5450,5451,5452,5453,5454,5455,5456, #  752
+5457,5458,5459,5460,5461,5462,5463,5464,5465,5466,5467,5468,5469,5470,5471,5472, #  768
+5473,5474,5475,5476,5477,5478,5479,5480,5481,5482,5483,5484,5485,5486,5487,5488, #  784
+5489,5490,5491,5492,5493,5494,5495,5496,5497,5498,5499,5500,5501,5502,5503,5504, #  800
+5505,5506,5507,5508,5509,5510,5511,5512,5513,5514,5515,5516,5517,5518,5519,5520, #  816
+5521,5522,5523,5524,5525,5526,5527,5528,5529,5530,5531,5532,5533,5534,5535,5536, #  832
+5537,5538,5539,5540,5541,5542,5543,5544,5545,5546,5547,5548,5549,5550,5551,5552, #  848
+5553,5554,5555,5556,5557,5558,5559,5560,5561,5562,5563,5564,5565,5566,5567,5568, #  864
+5569,5570,5571,5572,5573,5574,5575,5576,5577,5578,5579,5580,5581,5582,5583,5584, #  880
+5585,5586,5587,5588,5589,5590,5591,5592,5593,5594,5595,5596,5597,5598,5599,5600, #  896
+5601,5602,5603,5604,5605,5606,5607,5608,5609,5610,5611,5612,5613,5614,5615,5616, #  912
+5617,5618,5619,5620,5621,5622,5623,5624,5625,5626,5627,5628,5629,5630,5631,5632, #  928
+5633,5634,5635,5636,5637,5638,5639,5640,5641,5642,5643,5644,5645,5646,5647,5648, #  944
+5649,5650,5651,5652,5653,5654,5655,5656,5657,5658,5659,5660,5661,5662,5663,5664, #  960
+5665,5666,5667,5668,5669,5670,5671,5672,5673,5674,5675,5676,5677,5678,5679,5680, #  976
+5681,5682,5683,5684,5685,5686,5687,5688,5689,5690,5691,5692,5693,5694,5695,5696, #  992
+5697,5698,5699,5700,5701,5702,5703,5704,5705,5706,5707,5708,5709,5710,5711,5712, # 1008
+5713,5714,5715,5716,5717,5718,5719,5720,5721,5722,5723,5724,5725,5726,5727,5728, # 1024
+5729,5730,5731,5732,5733,5734,5735,5736,5737,5738,5739,5740,5741,5742,5743,5744, # 1040
+5745,5746,5747,5748,5749,5750,5751,5752,5753,5754,5755,5756,5757,5758,5759,5760, # 1056
+5761,5762,5763,5764,5765,5766,5767,5768,5769,5770,5771,5772,5773,5774,5775,5776, # 1072
+5777,5778,5779,5780,5781,5782,5783,5784,5785,5786,5787,5788,5789,5790,5791,5792, # 1088
+5793,5794,5795,5796,5797,5798,5799,5800,5801,5802,5803,5804,5805,5806,5807,5808, # 1104
+5809,5810,5811,5812,5813,5814,5815,5816,5817,5818,5819,5820,5821,5822,5823,5824, # 1120
+5825,5826,5827,5828,5829,5830,5831,5832,5833,5834,5835,5836,5837,5838,5839,5840, # 1136
+5841,5842,5843,5844,5845,5846,5847,5848,5849,5850,5851,5852,5853,5854,5855,5856, # 1152
+5857,5858,5859,5860,5861,5862,5863,5864,5865,5866,5867,5868,5869,5870,5871,5872, # 1168
+5873,5874,5875,5876,5877,5878,5879,5880,5881,5882,5883,5884,5885,5886,5887,5888, # 1184
+5889,5890,5891,5892,5893,5894,5895,5896,5897,5898,5899,5900,5901,5902,5903,5904, # 1200
+5905,5906,5907,5908,5909,5910,5911,5912,5913,5914,5915,5916,5917,5918,5919,5920, # 1216
+5921,5922,5923,5924,5925,5926,5927,5928,5929,5930,5931,5932,5933,5934,5935,5936, # 1232
+5937,5938,5939,5940,5941,5942,5943,5944,5945,5946,5947,5948,5949,5950,5951,5952, # 1248
+5953,5954,5955,5956,5957,5958,5959,5960,5961,5962,5963,5964,5965,5966,5967,5968, # 1264
+5969,5970,5971,5972,5973,5974,5975,5976,5977,5978,5979,5980,5981,5982,5983,5984, # 1280
+5985,5986,5987,5988,5989,5990,5991,5992,5993,5994,5995,5996,5997,5998,5999,6000, # 1296
+6001,6002,6003,6004,6005,6006,6007,6008,6009,6010,6011,6012,6013,6014,6015,6016, # 1312
+6017,6018,6019,6020,6021,6022,6023,6024,6025,6026,6027,6028,6029,6030,6031,6032, # 1328
+6033,6034,6035,6036,6037,6038,6039,6040,6041,6042,6043,6044,6045,6046,6047,6048, # 1344
+6049,6050,6051,6052,6053,6054,6055,6056,6057,6058,6059,6060,6061,6062,6063,6064, # 1360
+6065,6066,6067,6068,6069,6070,6071,6072,6073,6074,6075,6076,6077,6078,6079,6080, # 1376
+6081,6082,6083,6084,6085,6086,6087,6088,6089,6090,6091,6092,6093,6094,6095,6096, # 1392
+6097,6098,6099,6100,6101,6102,6103,6104,6105,6106,6107,6108,6109,6110,6111,6112, # 1408
+6113,6114,2044,2060,4621, 997,1235, 473,1186,4622, 920,3378,6115,6116, 379,1108, # 1424
+4313,2657,2735,3934,6117,3809, 636,3233, 573,1026,3693,3435,2974,3300,2298,4105, # 1440
+ 854,2937,2463, 393,2581,2417, 539, 752,1280,2750,2480, 140,1161, 440, 708,1569, # 1456
+ 665,2497,1746,1291,1523,3000, 164,1603, 847,1331, 537,1997, 486, 508,1693,2418, # 1472
+1970,2227, 878,1220, 299,1030, 969, 652,2751, 624,1137,3301,2619,  65,3302,2045, # 1488
+1761,1859,3120,1930,3694,3516, 663,1767, 852, 835,3695, 269, 767,2826,2339,1305, # 1504
+ 896,1150, 770,1616,6118, 506,1502,2075,1012,2519, 775,2520,2975,2340,2938,4314, # 1520
+3028,2086,1224,1943,2286,6119,3072,4315,2240,1273,1987,3935,1557, 175, 597, 985, # 1536
+3517,2419,2521,1416,3029, 585, 938,1931,1007,1052,1932,1685,6120,3379,4316,4623, # 1552
+ 804, 599,3121,1333,2128,2539,1159,1554,2032,3810, 687,2033,2904, 952, 675,1467, # 1568
+3436,6121,2241,1096,1786,2440,1543,1924, 980,1813,2228, 781,2692,1879, 728,1918, # 1584
+3696,4624, 548,1950,4625,1809,1088,1356,3303,2522,1944, 502, 972, 373, 513,2827, # 1600
+ 586,2377,2391,1003,1976,1631,6122,2464,1084, 648,1776,4626,2141, 324, 962,2012, # 1616
+2177,2076,1384, 742,2178,1448,1173,1810, 222, 102, 301, 445, 125,2420, 662,2498, # 1632
+ 277, 200,1476,1165,1068, 224,2562,1378,1446, 450,1880, 659, 791, 582,4627,2939, # 1648
+3936,1516,1274, 555,2099,3697,1020,1389,1526,3380,1762,1723,1787,2229, 412,2114, # 1664
+1900,2392,3518, 512,2597, 427,1925,2341,3122,1653,1686,2465,2499, 697, 330, 273, # 1680
+ 380,2162, 951, 832, 780, 991,1301,3073, 965,2270,3519, 668,2523,2636,1286, 535, # 1696
+1407, 518, 671, 957,2658,2378, 267, 611,2197,3030,6123, 248,2299, 967,1799,2356, # 1712
+ 850,1418,3437,1876,1256,1480,2828,1718,6124,6125,1755,1664,2405,6126,4628,2879, # 1728
+2829, 499,2179, 676,4629, 557,2329,2214,2090, 325,3234, 464, 811,3001, 992,2342, # 1744
+2481,1232,1469, 303,2242, 466,1070,2163, 603,1777,2091,4630,2752,4631,2714, 322, # 1760
+2659,1964,1768, 481,2188,1463,2330,2857,3600,2092,3031,2421,4632,2318,2070,1849, # 1776
+2598,4633,1302,2254,1668,1701,2422,3811,2905,3032,3123,2046,4106,1763,1694,4634, # 1792
+1604, 943,1724,1454, 917, 868,2215,1169,2940, 552,1145,1800,1228,1823,1955, 316, # 1808
+1080,2510, 361,1807,2830,4107,2660,3381,1346,1423,1134,4108,6127, 541,1263,1229, # 1824
+1148,2540, 545, 465,1833,2880,3438,1901,3074,2482, 816,3937, 713,1788,2500, 122, # 1840
+1575, 195,1451,2501,1111,6128, 859, 374,1225,2243,2483,4317, 390,1033,3439,3075, # 1856
+2524,1687, 266, 793,1440,2599, 946, 779, 802, 507, 897,1081, 528,2189,1292, 711, # 1872
+1866,1725,1167,1640, 753, 398,2661,1053, 246, 348,4318, 137,1024,3440,1600,2077, # 1888
+2129, 825,4319, 698, 238, 521, 187,2300,1157,2423,1641,1605,1464,1610,1097,2541, # 1904
+1260,1436, 759,2255,1814,2150, 705,3235, 409,2563,3304, 561,3033,2005,2564, 726, # 1920
+1956,2343,3698,4109, 949,3812,3813,3520,1669, 653,1379,2525, 881,2198, 632,2256, # 1936
+1027, 778,1074, 733,1957, 514,1481,2466, 554,2180, 702,3938,1606,1017,1398,6129, # 1952
+1380,3521, 921, 993,1313, 594, 449,1489,1617,1166, 768,1426,1360, 495,1794,3601, # 1968
+1177,3602,1170,4320,2344, 476, 425,3167,4635,3168,1424, 401,2662,1171,3382,1998, # 1984
+1089,4110, 477,3169, 474,6130,1909, 596,2831,1842, 494, 693,1051,1028,1207,3076, # 2000
+ 606,2115, 727,2790,1473,1115, 743,3522, 630, 805,1532,4321,2021, 366,1057, 838, # 2016
+ 684,1114,2142,4322,2050,1492,1892,1808,2271,3814,2424,1971,1447,1373,3305,1090, # 2032
+1536,3939,3523,3306,1455,2199, 336, 369,2331,1035, 584,2393, 902, 718,2600,6131, # 2048
+2753, 463,2151,1149,1611,2467, 715,1308,3124,1268, 343,1413,3236,1517,1347,2663, # 2064
+2093,3940,2022,1131,1553,2100,2941,1427,3441,2942,1323,2484,6132,1980, 872,2368, # 2080
+2441,2943, 320,2369,2116,1082, 679,1933,3941,2791,3815, 625,1143,2023, 422,2200, # 2096
+3816,6133, 730,1695, 356,2257,1626,2301,2858,2637,1627,1778, 937, 883,2906,2693, # 2112
+3002,1769,1086, 400,1063,1325,3307,2792,4111,3077, 456,2345,1046, 747,6134,1524, # 2128
+ 884,1094,3383,1474,2164,1059, 974,1688,2181,2258,1047, 345,1665,1187, 358, 875, # 2144
+3170, 305, 660,3524,2190,1334,1135,3171,1540,1649,2542,1527, 927, 968,2793, 885, # 2160
+1972,1850, 482, 500,2638,1218,1109,1085,2543,1654,2034, 876,  78,2287,1482,1277, # 2176
+ 861,1675,1083,1779, 724,2754, 454, 397,1132,1612,2332, 893, 672,1237, 257,2259, # 2192
+2370, 135,3384, 337,2244, 547, 352, 340, 709,2485,1400, 788,1138,2511, 540, 772, # 2208
+1682,2260,2272,2544,2013,1843,1902,4636,1999,1562,2288,4637,2201,1403,1533, 407, # 2224
+ 576,3308,1254,2071, 978,3385, 170, 136,1201,3125,2664,3172,2394, 213, 912, 873, # 2240
+3603,1713,2202, 699,3604,3699, 813,3442, 493, 531,1054, 468,2907,1483, 304, 281, # 2256
+4112,1726,1252,2094, 339,2319,2130,2639, 756,1563,2944, 748, 571,2976,1588,2425, # 2272
+2715,1851,1460,2426,1528,1392,1973,3237, 288,3309, 685,3386, 296, 892,2716,2216, # 2288
+1570,2245, 722,1747,2217, 905,3238,1103,6135,1893,1441,1965, 251,1805,2371,3700, # 2304
+2601,1919,1078,  75,2182,1509,1592,1270,2640,4638,2152,6136,3310,3817, 524, 706, # 2320
+1075, 292,3818,1756,2602, 317,  98,3173,3605,3525,1844,2218,3819,2502, 814, 567, # 2336
+ 385,2908,1534,6137, 534,1642,3239, 797,6138,1670,1529, 953,4323, 188,1071, 538, # 2352
+ 178, 729,3240,2109,1226,1374,2000,2357,2977, 731,2468,1116,2014,2051,6139,1261, # 2368
+1593, 803,2859,2736,3443, 556, 682, 823,1541,6140,1369,2289,1706,2794, 845, 462, # 2384
+2603,2665,1361, 387, 162,2358,1740, 739,1770,1720,1304,1401,3241,1049, 627,1571, # 2400
+2427,3526,1877,3942,1852,1500, 431,1910,1503, 677, 297,2795, 286,1433,1038,1198, # 2416
+2290,1133,1596,4113,4639,2469,1510,1484,3943,6141,2442, 108, 712,4640,2372, 866, # 2432
+3701,2755,3242,1348, 834,1945,1408,3527,2395,3243,1811, 824, 994,1179,2110,1548, # 2448
+1453, 790,3003, 690,4324,4325,2832,2909,3820,1860,3821, 225,1748, 310, 346,1780, # 2464
+2470, 821,1993,2717,2796, 828, 877,3528,2860,2471,1702,2165,2910,2486,1789, 453, # 2480
+ 359,2291,1676,  73,1164,1461,1127,3311, 421, 604, 314,1037, 589, 116,2487, 737, # 2496
+ 837,1180, 111, 244, 735,6142,2261,1861,1362, 986, 523, 418, 581,2666,3822, 103, # 2512
+ 855, 503,1414,1867,2488,1091, 657,1597, 979, 605,1316,4641,1021,2443,2078,2001, # 2528
+1209,  96, 587,2166,1032, 260,1072,2153, 173,  94, 226,3244, 819,2006,4642,4114, # 2544
+2203, 231,1744, 782,  97,2667, 786,3387, 887, 391, 442,2219,4326,1425,6143,2694, # 2560
+ 633,1544,1202, 483,2015, 592,2052,1958,2472,1655, 419, 129,4327,3444,3312,1714, # 2576
+1257,3078,4328,1518,1098, 865,1310,1019,1885,1512,1734, 469,2444, 148, 773, 436, # 2592
+1815,1868,1128,1055,4329,1245,2756,3445,2154,1934,1039,4643, 579,1238, 932,2320, # 2608
+ 353, 205, 801, 115,2428, 944,2321,1881, 399,2565,1211, 678, 766,3944, 335,2101, # 2624
+1459,1781,1402,3945,2737,2131,1010, 844, 981,1326,1013, 550,1816,1545,2620,1335, # 2640
+1008, 371,2881, 936,1419,1613,3529,1456,1395,2273,1834,2604,1317,2738,2503, 416, # 2656
+1643,4330, 806,1126, 229, 591,3946,1314,1981,1576,1837,1666, 347,1790, 977,3313, # 2672
+ 764,2861,1853, 688,2429,1920,1462,  77, 595, 415,2002,3034, 798,1192,4115,6144, # 2688
+2978,4331,3035,2695,2582,2072,2566, 430,2430,1727, 842,1396,3947,3702, 613, 377, # 2704
+ 278, 236,1417,3388,3314,3174, 757,1869, 107,3530,6145,1194, 623,2262, 207,1253, # 2720
+2167,3446,3948, 492,1117,1935, 536,1838,2757,1246,4332, 696,2095,2406,1393,1572, # 2736
+3175,1782, 583, 190, 253,1390,2230, 830,3126,3389, 934,3245,1703,1749,2979,1870, # 2752
+2545,1656,2204, 869,2346,4116,3176,1817, 496,1764,4644, 942,1504, 404,1903,1122, # 2768
+1580,3606,2945,1022, 515, 372,1735, 955,2431,3036,6146,2797,1110,2302,2798, 617, # 2784
+6147, 441, 762,1771,3447,3607,3608,1904, 840,3037,  86, 939,1385, 572,1370,2445, # 2800
+1336, 114,3703, 898, 294, 203,3315, 703,1583,2274, 429, 961,4333,1854,1951,3390, # 2816
+2373,3704,4334,1318,1381, 966,1911,2322,1006,1155, 309, 989, 458,2718,1795,1372, # 2832
+1203, 252,1689,1363,3177, 517,1936, 168,1490, 562, 193,3823,1042,4117,1835, 551, # 2848
+ 470,4645, 395, 489,3448,1871,1465,2583,2641, 417,1493, 279,1295, 511,1236,1119, # 2864
+  72,1231,1982,1812,3004, 871,1564, 984,3449,1667,2696,2096,4646,2347,2833,1673, # 2880
+3609, 695,3246,2668, 807,1183,4647, 890, 388,2333,1801,1457,2911,1765,1477,1031, # 2896
+3316,3317,1278,3391,2799,2292,2526, 163,3450,4335,2669,1404,1802,6148,2323,2407, # 2912
+1584,1728,1494,1824,1269, 298, 909,3318,1034,1632, 375, 776,1683,2061, 291, 210, # 2928
+1123, 809,1249,1002,2642,3038, 206,1011,2132, 144, 975, 882,1565, 342, 667, 754, # 2944
+1442,2143,1299,2303,2062, 447, 626,2205,1221,2739,2912,1144,1214,2206,2584, 760, # 2960
+1715, 614, 950,1281,2670,2621, 810, 577,1287,2546,4648, 242,2168, 250,2643, 691, # 2976
+ 123,2644, 647, 313,1029, 689,1357,2946,1650, 216, 771,1339,1306, 808,2063, 549, # 2992
+ 913,1371,2913,2914,6149,1466,1092,1174,1196,1311,2605,2396,1783,1796,3079, 406, # 3008
+2671,2117,3949,4649, 487,1825,2220,6150,2915, 448,2348,1073,6151,2397,1707, 130, # 3024
+ 900,1598, 329, 176,1959,2527,1620,6152,2275,4336,3319,1983,2191,3705,3610,2155, # 3040
+3706,1912,1513,1614,6153,1988, 646, 392,2304,1589,3320,3039,1826,1239,1352,1340, # 3056
+2916, 505,2567,1709,1437,2408,2547, 906,6154,2672, 384,1458,1594,1100,1329, 710, # 3072
+ 423,3531,2064,2231,2622,1989,2673,1087,1882, 333, 841,3005,1296,2882,2379, 580, # 3088
+1937,1827,1293,2585, 601, 574, 249,1772,4118,2079,1120, 645, 901,1176,1690, 795, # 3104
+2207, 478,1434, 516,1190,1530, 761,2080, 930,1264, 355, 435,1552, 644,1791, 987, # 3120
+ 220,1364,1163,1121,1538, 306,2169,1327,1222, 546,2645, 218, 241, 610,1704,3321, # 3136
+1984,1839,1966,2528, 451,6155,2586,3707,2568, 907,3178, 254,2947, 186,1845,4650, # 3152
+ 745, 432,1757, 428,1633, 888,2246,2221,2489,3611,2118,1258,1265, 956,3127,1784, # 3168
+4337,2490, 319, 510, 119, 457,3612, 274,2035,2007,4651,1409,3128, 970,2758, 590, # 3184
+2800, 661,2247,4652,2008,3950,1420,1549,3080,3322,3951,1651,1375,2111, 485,2491, # 3200
+1429,1156,6156,2548,2183,1495, 831,1840,2529,2446, 501,1657, 307,1894,3247,1341, # 3216
+ 666, 899,2156,1539,2549,1559, 886, 349,2208,3081,2305,1736,3824,2170,2759,1014, # 3232
+1913,1386, 542,1397,2948, 490, 368, 716, 362, 159, 282,2569,1129,1658,1288,1750, # 3248
+2674, 276, 649,2016, 751,1496, 658,1818,1284,1862,2209,2087,2512,3451, 622,2834, # 3264
+ 376, 117,1060,2053,1208,1721,1101,1443, 247,1250,3179,1792,3952,2760,2398,3953, # 3280
+6157,2144,3708, 446,2432,1151,2570,3452,2447,2761,2835,1210,2448,3082, 424,2222, # 3296
+1251,2449,2119,2836, 504,1581,4338, 602, 817, 857,3825,2349,2306, 357,3826,1470, # 3312
+1883,2883, 255, 958, 929,2917,3248, 302,4653,1050,1271,1751,2307,1952,1430,2697, # 3328
+2719,2359, 354,3180, 777, 158,2036,4339,1659,4340,4654,2308,2949,2248,1146,2232, # 3344
+3532,2720,1696,2623,3827,6158,3129,1550,2698,1485,1297,1428, 637, 931,2721,2145, # 3360
+ 914,2550,2587,  81,2450, 612, 827,2646,1242,4655,1118,2884, 472,1855,3181,3533, # 3376
+3534, 569,1353,2699,1244,1758,2588,4119,2009,2762,2171,3709,1312,1531,6159,1152, # 3392
+1938, 134,1830, 471,3710,2276,1112,1535,3323,3453,3535, 982,1337,2950, 488, 826, # 3408
+ 674,1058,1628,4120,2017, 522,2399, 211, 568,1367,3454, 350, 293,1872,1139,3249, # 3424
+1399,1946,3006,1300,2360,3324, 588, 736,6160,2606, 744, 669,3536,3828,6161,1358, # 3440
+ 199, 723, 848, 933, 851,1939,1505,1514,1338,1618,1831,4656,1634,3613, 443,2740, # 3456
+3829, 717,1947, 491,1914,6162,2551,1542,4121,1025,6163,1099,1223, 198,3040,2722, # 3472
+ 370, 410,1905,2589, 998,1248,3182,2380, 519,1449,4122,1710, 947, 928,1153,4341, # 3488
+2277, 344,2624,1511, 615, 105, 161,1212,1076,1960,3130,2054,1926,1175,1906,2473, # 3504
+ 414,1873,2801,6164,2309, 315,1319,3325, 318,2018,2146,2157, 963, 631, 223,4342, # 3520
+4343,2675, 479,3711,1197,2625,3712,2676,2361,6165,4344,4123,6166,2451,3183,1886, # 3536
+2184,1674,1330,1711,1635,1506, 799, 219,3250,3083,3954,1677,3713,3326,2081,3614, # 3552
+1652,2073,4657,1147,3041,1752, 643,1961, 147,1974,3955,6167,1716,2037, 918,3007, # 3568
+1994, 120,1537, 118, 609,3184,4345, 740,3455,1219, 332,1615,3830,6168,1621,2980, # 3584
+1582, 783, 212, 553,2350,3714,1349,2433,2082,4124, 889,6169,2310,1275,1410, 973, # 3600
+ 166,1320,3456,1797,1215,3185,2885,1846,2590,2763,4658, 629, 822,3008, 763, 940, # 3616
+1990,2862, 439,2409,1566,1240,1622, 926,1282,1907,2764, 654,2210,1607, 327,1130, # 3632
+3956,1678,1623,6170,2434,2192, 686, 608,3831,3715, 903,3957,3042,6171,2741,1522, # 3648
+1915,1105,1555,2552,1359, 323,3251,4346,3457, 738,1354,2553,2311,2334,1828,2003, # 3664
+3832,1753,2351,1227,6172,1887,4125,1478,6173,2410,1874,1712,1847, 520,1204,2607, # 3680
+ 264,4659, 836,2677,2102, 600,4660,3833,2278,3084,6174,4347,3615,1342, 640, 532, # 3696
+ 543,2608,1888,2400,2591,1009,4348,1497, 341,1737,3616,2723,1394, 529,3252,1321, # 3712
+ 983,4661,1515,2120, 971,2592, 924, 287,1662,3186,4349,2700,4350,1519, 908,1948, # 3728
+2452, 156, 796,1629,1486,2223,2055, 694,4126,1259,1036,3392,1213,2249,2742,1889, # 3744
+1230,3958,1015, 910, 408, 559,3617,4662, 746, 725, 935,4663,3959,3009,1289, 563, # 3760
+ 867,4664,3960,1567,2981,2038,2626, 988,2263,2381,4351, 143,2374, 704,1895,6175, # 3776
+1188,3716,2088, 673,3085,2362,4352, 484,1608,1921,2765,2918, 215, 904,3618,3537, # 3792
+ 894, 509, 976,3043,2701,3961,4353,2837,2982, 498,6176,6177,1102,3538,1332,3393, # 3808
+1487,1636,1637, 233, 245,3962, 383, 650, 995,3044, 460,1520,1206,2352, 749,3327, # 3824
+ 530, 700, 389,1438,1560,1773,3963,2264, 719,2951,2724,3834, 870,1832,1644,1000, # 3840
+ 839,2474,3717, 197,1630,3394, 365,2886,3964,1285,2133, 734, 922, 818,1106, 732, # 3856
+ 480,2083,1774,3458, 923,2279,1350, 221,3086,  85,2233,2234,3835,1585,3010,2147, # 3872
+1387,1705,2382,1619,2475, 133, 239,2802,1991,1016,2084,2383, 411,2838,1113, 651, # 3888
+1985,1160,3328, 990,1863,3087,1048,1276,2647, 265,2627,1599,3253,2056, 150, 638, # 3904
+2019, 656, 853, 326,1479, 680,1439,4354,1001,1759, 413,3459,3395,2492,1431, 459, # 3920
+4355,1125,3329,2265,1953,1450,2065,2863, 849, 351,2678,3131,3254,3255,1104,1577, # 3936
+ 227,1351,1645,2453,2193,1421,2887, 812,2121, 634,  95,2435, 201,2312,4665,1646, # 3952
+1671,2743,1601,2554,2702,2648,2280,1315,1366,2089,3132,1573,3718,3965,1729,1189, # 3968
+ 328,2679,1077,1940,1136, 558,1283, 964,1195, 621,2074,1199,1743,3460,3619,1896, # 3984
+1916,1890,3836,2952,1154,2112,1064, 862, 378,3011,2066,2113,2803,1568,2839,6178, # 4000
+3088,2919,1941,1660,2004,1992,2194, 142, 707,1590,1708,1624,1922,1023,1836,1233, # 4016
+1004,2313, 789, 741,3620,6179,1609,2411,1200,4127,3719,3720,4666,2057,3721, 593, # 4032
+2840, 367,2920,1878,6180,3461,1521, 628,1168, 692,2211,2649, 300, 720,2067,2571, # 4048
+2953,3396, 959,2504,3966,3539,3462,1977, 701,6181, 954,1043, 800, 681, 183,3722, # 4064
+1803,1730,3540,4128,2103, 815,2314, 174, 467, 230,2454,1093,2134, 755,3541,3397, # 4080
+1141,1162,6182,1738,2039, 270,3256,2513,1005,1647,2185,3837, 858,1679,1897,1719, # 4096
+2954,2324,1806, 402, 670, 167,4129,1498,2158,2104, 750,6183, 915, 189,1680,1551, # 4112
+ 455,4356,1501,2455, 405,1095,2955, 338,1586,1266,1819, 570, 641,1324, 237,1556, # 4128
+2650,1388,3723,6184,1368,2384,1343,1978,3089,2436, 879,3724, 792,1191, 758,3012, # 4144
+1411,2135,1322,4357, 240,4667,1848,3725,1574,6185, 420,3045,1546,1391, 714,4358, # 4160
+1967, 941,1864, 863, 664, 426, 560,1731,2680,1785,2864,1949,2363, 403,3330,1415, # 4176
+1279,2136,1697,2335, 204, 721,2097,3838,  90,6186,2085,2505, 191,3967, 124,2148, # 4192
+1376,1798,1178,1107,1898,1405, 860,4359,1243,1272,2375,2983,1558,2456,1638, 113, # 4208
+3621, 578,1923,2609, 880, 386,4130, 784,2186,2266,1422,2956,2172,1722, 497, 263, # 4224
+2514,1267,2412,2610, 177,2703,3542, 774,1927,1344, 616,1432,1595,1018, 172,4360, # 4240
+2325, 911,4361, 438,1468,3622, 794,3968,2024,2173,1681,1829,2957, 945, 895,3090, # 4256
+ 575,2212,2476, 475,2401,2681, 785,2744,1745,2293,2555,1975,3133,2865, 394,4668, # 4272
+3839, 635,4131, 639, 202,1507,2195,2766,1345,1435,2572,3726,1908,1184,1181,2457, # 4288
+3727,3134,4362, 843,2611, 437, 916,4669, 234, 769,1884,3046,3047,3623, 833,6187, # 4304
+1639,2250,2402,1355,1185,2010,2047, 999, 525,1732,1290,1488,2612, 948,1578,3728, # 4320
+2413,2477,1216,2725,2159, 334,3840,1328,3624,2921,1525,4132, 564,1056, 891,4363, # 4336
+1444,1698,2385,2251,3729,1365,2281,2235,1717,6188, 864,3841,2515, 444, 527,2767, # 4352
+2922,3625, 544, 461,6189, 566, 209,2437,3398,2098,1065,2068,3331,3626,3257,2137, # 4368  #last 512
+)
+
+
diff --git a/openpype/vendor/python/python_2/chardet/jpcntx.py b/openpype/vendor/python/python_2/chardet/jpcntx.py
new file mode 100644
index 0000000000..20044e4bc8
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/jpcntx.py
@@ -0,0 +1,233 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+
+# This is hiragana 2-char sequence table, the number in each cell represents its frequency category
+jp2CharContext = (
+(0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1),
+(2,4,0,4,0,3,0,4,0,3,4,4,4,2,4,3,3,4,3,2,3,3,4,2,3,3,3,2,4,1,4,3,3,1,5,4,3,4,3,4,3,5,3,0,3,5,4,2,0,3,1,0,3,3,0,3,3,0,1,1,0,4,3,0,3,3,0,4,0,2,0,3,5,5,5,5,4,0,4,1,0,3,4),
+(0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2),
+(0,4,0,5,0,5,0,4,0,4,5,4,4,3,5,3,5,1,5,3,4,3,4,4,3,4,3,3,4,3,5,4,4,3,5,5,3,5,5,5,3,5,5,3,4,5,5,3,1,3,2,0,3,4,0,4,2,0,4,2,1,5,3,2,3,5,0,4,0,2,0,5,4,4,5,4,5,0,4,0,0,4,4),
+(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
+(0,3,0,4,0,3,0,3,0,4,5,4,3,3,3,3,4,3,5,4,4,3,5,4,4,3,4,3,4,4,4,4,5,3,4,4,3,4,5,5,4,5,5,1,4,5,4,3,0,3,3,1,3,3,0,4,4,0,3,3,1,5,3,3,3,5,0,4,0,3,0,4,4,3,4,3,3,0,4,1,1,3,4),
+(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
+(0,4,0,3,0,3,0,4,0,3,4,4,3,2,2,1,2,1,3,1,3,3,3,3,3,4,3,1,3,3,5,3,3,0,4,3,0,5,4,3,3,5,4,4,3,4,4,5,0,1,2,0,1,2,0,2,2,0,1,0,0,5,2,2,1,4,0,3,0,1,0,4,4,3,5,4,3,0,2,1,0,4,3),
+(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
+(0,3,0,5,0,4,0,2,1,4,4,2,4,1,4,2,4,2,4,3,3,3,4,3,3,3,3,1,4,2,3,3,3,1,4,4,1,1,1,4,3,3,2,0,2,4,3,2,0,3,3,0,3,1,1,0,0,0,3,3,0,4,2,2,3,4,0,4,0,3,0,4,4,5,3,4,4,0,3,0,0,1,4),
+(1,4,0,4,0,4,0,4,0,3,5,4,4,3,4,3,5,4,3,3,4,3,5,4,4,4,4,3,4,2,4,3,3,1,5,4,3,2,4,5,4,5,5,4,4,5,4,4,0,3,2,2,3,3,0,4,3,1,3,2,1,4,3,3,4,5,0,3,0,2,0,4,5,5,4,5,4,0,4,0,0,5,4),
+(0,5,0,5,0,4,0,3,0,4,4,3,4,3,3,3,4,0,4,4,4,3,4,3,4,3,3,1,4,2,4,3,4,0,5,4,1,4,5,4,4,5,3,2,4,3,4,3,2,4,1,3,3,3,2,3,2,0,4,3,3,4,3,3,3,4,0,4,0,3,0,4,5,4,4,4,3,0,4,1,0,1,3),
+(0,3,1,4,0,3,0,2,0,3,4,4,3,1,4,2,3,3,4,3,4,3,4,3,4,4,3,2,3,1,5,4,4,1,4,4,3,5,4,4,3,5,5,4,3,4,4,3,1,2,3,1,2,2,0,3,2,0,3,1,0,5,3,3,3,4,3,3,3,3,4,4,4,4,5,4,2,0,3,3,2,4,3),
+(0,2,0,3,0,1,0,1,0,0,3,2,0,0,2,0,1,0,2,1,3,3,3,1,2,3,1,0,1,0,4,2,1,1,3,3,0,4,3,3,1,4,3,3,0,3,3,2,0,0,0,0,1,0,0,2,0,0,0,0,0,4,1,0,2,3,2,2,2,1,3,3,3,4,4,3,2,0,3,1,0,3,3),
+(0,4,0,4,0,3,0,3,0,4,4,4,3,3,3,3,3,3,4,3,4,2,4,3,4,3,3,2,4,3,4,5,4,1,4,5,3,5,4,5,3,5,4,0,3,5,5,3,1,3,3,2,2,3,0,3,4,1,3,3,2,4,3,3,3,4,0,4,0,3,0,4,5,4,4,5,3,0,4,1,0,3,4),
+(0,2,0,3,0,3,0,0,0,2,2,2,1,0,1,0,0,0,3,0,3,0,3,0,1,3,1,0,3,1,3,3,3,1,3,3,3,0,1,3,1,3,4,0,0,3,1,1,0,3,2,0,0,0,0,1,3,0,1,0,0,3,3,2,0,3,0,0,0,0,0,3,4,3,4,3,3,0,3,0,0,2,3),
+(2,3,0,3,0,2,0,1,0,3,3,4,3,1,3,1,1,1,3,1,4,3,4,3,3,3,0,0,3,1,5,4,3,1,4,3,2,5,5,4,4,4,4,3,3,4,4,4,0,2,1,1,3,2,0,1,2,0,0,1,0,4,1,3,3,3,0,3,0,1,0,4,4,4,5,5,3,0,2,0,0,4,4),
+(0,2,0,1,0,3,1,3,0,2,3,3,3,0,3,1,0,0,3,0,3,2,3,1,3,2,1,1,0,0,4,2,1,0,2,3,1,4,3,2,0,4,4,3,1,3,1,3,0,1,0,0,1,0,0,0,1,0,0,0,0,4,1,1,1,2,0,3,0,0,0,3,4,2,4,3,2,0,1,0,0,3,3),
+(0,1,0,4,0,5,0,4,0,2,4,4,2,3,3,2,3,3,5,3,3,3,4,3,4,2,3,0,4,3,3,3,4,1,4,3,2,1,5,5,3,4,5,1,3,5,4,2,0,3,3,0,1,3,0,4,2,0,1,3,1,4,3,3,3,3,0,3,0,1,0,3,4,4,4,5,5,0,3,0,1,4,5),
+(0,2,0,3,0,3,0,0,0,2,3,1,3,0,4,0,1,1,3,0,3,4,3,2,3,1,0,3,3,2,3,1,3,0,2,3,0,2,1,4,1,2,2,0,0,3,3,0,0,2,0,0,0,1,0,0,0,0,2,2,0,3,2,1,3,3,0,2,0,2,0,0,3,3,1,2,4,0,3,0,2,2,3),
+(2,4,0,5,0,4,0,4,0,2,4,4,4,3,4,3,3,3,1,2,4,3,4,3,4,4,5,0,3,3,3,3,2,0,4,3,1,4,3,4,1,4,4,3,3,4,4,3,1,2,3,0,4,2,0,4,1,0,3,3,0,4,3,3,3,4,0,4,0,2,0,3,5,3,4,5,2,0,3,0,0,4,5),
+(0,3,0,4,0,1,0,1,0,1,3,2,2,1,3,0,3,0,2,0,2,0,3,0,2,0,0,0,1,0,1,1,0,0,3,1,0,0,0,4,0,3,1,0,2,1,3,0,0,0,0,0,0,3,0,0,0,0,0,0,0,4,2,2,3,1,0,3,0,0,0,1,4,4,4,3,0,0,4,0,0,1,4),
+(1,4,1,5,0,3,0,3,0,4,5,4,4,3,5,3,3,4,4,3,4,1,3,3,3,3,2,1,4,1,5,4,3,1,4,4,3,5,4,4,3,5,4,3,3,4,4,4,0,3,3,1,2,3,0,3,1,0,3,3,0,5,4,4,4,4,4,4,3,3,5,4,4,3,3,5,4,0,3,2,0,4,4),
+(0,2,0,3,0,1,0,0,0,1,3,3,3,2,4,1,3,0,3,1,3,0,2,2,1,1,0,0,2,0,4,3,1,0,4,3,0,4,4,4,1,4,3,1,1,3,3,1,0,2,0,0,1,3,0,0,0,0,2,0,0,4,3,2,4,3,5,4,3,3,3,4,3,3,4,3,3,0,2,1,0,3,3),
+(0,2,0,4,0,3,0,2,0,2,5,5,3,4,4,4,4,1,4,3,3,0,4,3,4,3,1,3,3,2,4,3,0,3,4,3,0,3,4,4,2,4,4,0,4,5,3,3,2,2,1,1,1,2,0,1,5,0,3,3,2,4,3,3,3,4,0,3,0,2,0,4,4,3,5,5,0,0,3,0,2,3,3),
+(0,3,0,4,0,3,0,1,0,3,4,3,3,1,3,3,3,0,3,1,3,0,4,3,3,1,1,0,3,0,3,3,0,0,4,4,0,1,5,4,3,3,5,0,3,3,4,3,0,2,0,1,1,1,0,1,3,0,1,2,1,3,3,2,3,3,0,3,0,1,0,1,3,3,4,4,1,0,1,2,2,1,3),
+(0,1,0,4,0,4,0,3,0,1,3,3,3,2,3,1,1,0,3,0,3,3,4,3,2,4,2,0,1,0,4,3,2,0,4,3,0,5,3,3,2,4,4,4,3,3,3,4,0,1,3,0,0,1,0,0,1,0,0,0,0,4,2,3,3,3,0,3,0,0,0,4,4,4,5,3,2,0,3,3,0,3,5),
+(0,2,0,3,0,0,0,3,0,1,3,0,2,0,0,0,1,0,3,1,1,3,3,0,0,3,0,0,3,0,2,3,1,0,3,1,0,3,3,2,0,4,2,2,0,2,0,0,0,4,0,0,0,0,0,0,0,0,0,0,0,2,1,2,0,1,0,1,0,0,0,1,3,1,2,0,0,0,1,0,0,1,4),
+(0,3,0,3,0,5,0,1,0,2,4,3,1,3,3,2,1,1,5,2,1,0,5,1,2,0,0,0,3,3,2,2,3,2,4,3,0,0,3,3,1,3,3,0,2,5,3,4,0,3,3,0,1,2,0,2,2,0,3,2,0,2,2,3,3,3,0,2,0,1,0,3,4,4,2,5,4,0,3,0,0,3,5),
+(0,3,0,3,0,3,0,1,0,3,3,3,3,0,3,0,2,0,2,1,1,0,2,0,1,0,0,0,2,1,0,0,1,0,3,2,0,0,3,3,1,2,3,1,0,3,3,0,0,1,0,0,0,0,0,2,0,0,0,0,0,2,3,1,2,3,0,3,0,1,0,3,2,1,0,4,3,0,1,1,0,3,3),
+(0,4,0,5,0,3,0,3,0,4,5,5,4,3,5,3,4,3,5,3,3,2,5,3,4,4,4,3,4,3,4,5,5,3,4,4,3,4,4,5,4,4,4,3,4,5,5,4,2,3,4,2,3,4,0,3,3,1,4,3,2,4,3,3,5,5,0,3,0,3,0,5,5,5,5,4,4,0,4,0,1,4,4),
+(0,4,0,4,0,3,0,3,0,3,5,4,4,2,3,2,5,1,3,2,5,1,4,2,3,2,3,3,4,3,3,3,3,2,5,4,1,3,3,5,3,4,4,0,4,4,3,1,1,3,1,0,2,3,0,2,3,0,3,0,0,4,3,1,3,4,0,3,0,2,0,4,4,4,3,4,5,0,4,0,0,3,4),
+(0,3,0,3,0,3,1,2,0,3,4,4,3,3,3,0,2,2,4,3,3,1,3,3,3,1,1,0,3,1,4,3,2,3,4,4,2,4,4,4,3,4,4,3,2,4,4,3,1,3,3,1,3,3,0,4,1,0,2,2,1,4,3,2,3,3,5,4,3,3,5,4,4,3,3,0,4,0,3,2,2,4,4),
+(0,2,0,1,0,0,0,0,0,1,2,1,3,0,0,0,0,0,2,0,1,2,1,0,0,1,0,0,0,0,3,0,0,1,0,1,1,3,1,0,0,0,1,1,0,1,1,0,0,0,0,0,2,0,0,0,0,0,0,0,0,1,1,2,2,0,3,4,0,0,0,1,1,0,0,1,0,0,0,0,0,1,1),
+(0,1,0,0,0,1,0,0,0,0,4,0,4,1,4,0,3,0,4,0,3,0,4,0,3,0,3,0,4,1,5,1,4,0,0,3,0,5,0,5,2,0,1,0,0,0,2,1,4,0,1,3,0,0,3,0,0,3,1,1,4,1,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0),
+(1,4,0,5,0,3,0,2,0,3,5,4,4,3,4,3,5,3,4,3,3,0,4,3,3,3,3,3,3,2,4,4,3,1,3,4,4,5,4,4,3,4,4,1,3,5,4,3,3,3,1,2,2,3,3,1,3,1,3,3,3,5,3,3,4,5,0,3,0,3,0,3,4,3,4,4,3,0,3,0,2,4,3),
+(0,1,0,4,0,0,0,0,0,1,4,0,4,1,4,2,4,0,3,0,1,0,1,0,0,0,0,0,2,0,3,1,1,1,0,3,0,0,0,1,2,1,0,0,1,1,1,1,0,1,0,0,0,1,0,0,3,0,0,0,0,3,2,0,2,2,0,1,0,0,0,2,3,2,3,3,0,0,0,0,2,1,0),
+(0,5,1,5,0,3,0,3,0,5,4,4,5,1,5,3,3,0,4,3,4,3,5,3,4,3,3,2,4,3,4,3,3,0,3,3,1,4,4,3,4,4,4,3,4,5,5,3,2,3,1,1,3,3,1,3,1,1,3,3,2,4,5,3,3,5,0,4,0,3,0,4,4,3,5,3,3,0,3,4,0,4,3),
+(0,5,0,5,0,3,0,2,0,4,4,3,5,2,4,3,3,3,4,4,4,3,5,3,5,3,3,1,4,0,4,3,3,0,3,3,0,4,4,4,4,5,4,3,3,5,5,3,2,3,1,2,3,2,0,1,0,0,3,2,2,4,4,3,1,5,0,4,0,3,0,4,3,1,3,2,1,0,3,3,0,3,3),
+(0,4,0,5,0,5,0,4,0,4,5,5,5,3,4,3,3,2,5,4,4,3,5,3,5,3,4,0,4,3,4,4,3,2,4,4,3,4,5,4,4,5,5,0,3,5,5,4,1,3,3,2,3,3,1,3,1,0,4,3,1,4,4,3,4,5,0,4,0,2,0,4,3,4,4,3,3,0,4,0,0,5,5),
+(0,4,0,4,0,5,0,1,1,3,3,4,4,3,4,1,3,0,5,1,3,0,3,1,3,1,1,0,3,0,3,3,4,0,4,3,0,4,4,4,3,4,4,0,3,5,4,1,0,3,0,0,2,3,0,3,1,0,3,1,0,3,2,1,3,5,0,3,0,1,0,3,2,3,3,4,4,0,2,2,0,4,4),
+(2,4,0,5,0,4,0,3,0,4,5,5,4,3,5,3,5,3,5,3,5,2,5,3,4,3,3,4,3,4,5,3,2,1,5,4,3,2,3,4,5,3,4,1,2,5,4,3,0,3,3,0,3,2,0,2,3,0,4,1,0,3,4,3,3,5,0,3,0,1,0,4,5,5,5,4,3,0,4,2,0,3,5),
+(0,5,0,4,0,4,0,2,0,5,4,3,4,3,4,3,3,3,4,3,4,2,5,3,5,3,4,1,4,3,4,4,4,0,3,5,0,4,4,4,4,5,3,1,3,4,5,3,3,3,3,3,3,3,0,2,2,0,3,3,2,4,3,3,3,5,3,4,1,3,3,5,3,2,0,0,0,0,4,3,1,3,3),
+(0,1,0,3,0,3,0,1,0,1,3,3,3,2,3,3,3,0,3,0,0,0,3,1,3,0,0,0,2,2,2,3,0,0,3,2,0,1,2,4,1,3,3,0,0,3,3,3,0,1,0,0,2,1,0,0,3,0,3,1,0,3,0,0,1,3,0,2,0,1,0,3,3,1,3,3,0,0,1,1,0,3,3),
+(0,2,0,3,0,2,1,4,0,2,2,3,1,1,3,1,1,0,2,0,3,1,2,3,1,3,0,0,1,0,4,3,2,3,3,3,1,4,2,3,3,3,3,1,0,3,1,4,0,1,1,0,1,2,0,1,1,0,1,1,0,3,1,3,2,2,0,1,0,0,0,2,3,3,3,1,0,0,0,0,0,2,3),
+(0,5,0,4,0,5,0,2,0,4,5,5,3,3,4,3,3,1,5,4,4,2,4,4,4,3,4,2,4,3,5,5,4,3,3,4,3,3,5,5,4,5,5,1,3,4,5,3,1,4,3,1,3,3,0,3,3,1,4,3,1,4,5,3,3,5,0,4,0,3,0,5,3,3,1,4,3,0,4,0,1,5,3),
+(0,5,0,5,0,4,0,2,0,4,4,3,4,3,3,3,3,3,5,4,4,4,4,4,4,5,3,3,5,2,4,4,4,3,4,4,3,3,4,4,5,5,3,3,4,3,4,3,3,4,3,3,3,3,1,2,2,1,4,3,3,5,4,4,3,4,0,4,0,3,0,4,4,4,4,4,1,0,4,2,0,2,4),
+(0,4,0,4,0,3,0,1,0,3,5,2,3,0,3,0,2,1,4,2,3,3,4,1,4,3,3,2,4,1,3,3,3,0,3,3,0,0,3,3,3,5,3,3,3,3,3,2,0,2,0,0,2,0,0,2,0,0,1,0,0,3,1,2,2,3,0,3,0,2,0,4,4,3,3,4,1,0,3,0,0,2,4),
+(0,0,0,4,0,0,0,0,0,0,1,0,1,0,2,0,0,0,0,0,1,0,2,0,1,0,0,0,0,0,3,1,3,0,3,2,0,0,0,1,0,3,2,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,4,0,2,0,0,0,0,0,0,2),
+(0,2,1,3,0,2,0,2,0,3,3,3,3,1,3,1,3,3,3,3,3,3,4,2,2,1,2,1,4,0,4,3,1,3,3,3,2,4,3,5,4,3,3,3,3,3,3,3,0,1,3,0,2,0,0,1,0,0,1,0,0,4,2,0,2,3,0,3,3,0,3,3,4,2,3,1,4,0,1,2,0,2,3),
+(0,3,0,3,0,1,0,3,0,2,3,3,3,0,3,1,2,0,3,3,2,3,3,2,3,2,3,1,3,0,4,3,2,0,3,3,1,4,3,3,2,3,4,3,1,3,3,1,1,0,1,1,0,1,0,1,0,1,0,0,0,4,1,1,0,3,0,3,1,0,2,3,3,3,3,3,1,0,0,2,0,3,3),
+(0,0,0,0,0,0,0,0,0,0,3,0,2,0,3,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,3,0,3,0,3,1,0,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,2,0,2,3,0,0,0,0,0,0,0,0,3),
+(0,2,0,3,1,3,0,3,0,2,3,3,3,1,3,1,3,1,3,1,3,3,3,1,3,0,2,3,1,1,4,3,3,2,3,3,1,2,2,4,1,3,3,0,1,4,2,3,0,1,3,0,3,0,0,1,3,0,2,0,0,3,3,2,1,3,0,3,0,2,0,3,4,4,4,3,1,0,3,0,0,3,3),
+(0,2,0,1,0,2,0,0,0,1,3,2,2,1,3,0,1,1,3,0,3,2,3,1,2,0,2,0,1,1,3,3,3,0,3,3,1,1,2,3,2,3,3,1,2,3,2,0,0,1,0,0,0,0,0,0,3,0,1,0,0,2,1,2,1,3,0,3,0,0,0,3,4,4,4,3,2,0,2,0,0,2,4),
+(0,0,0,1,0,1,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,1,1,1,0,0,0,0,0,0,0,0,0,2,2,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,3,1,0,0,0,0,0,0,0,3),
+(0,3,0,3,0,2,0,3,0,3,3,3,2,3,2,2,2,0,3,1,3,3,3,2,3,3,0,0,3,0,3,2,2,0,2,3,1,4,3,4,3,3,2,3,1,5,4,4,0,3,1,2,1,3,0,3,1,1,2,0,2,3,1,3,1,3,0,3,0,1,0,3,3,4,4,2,1,0,2,1,0,2,4),
+(0,1,0,3,0,1,0,2,0,1,4,2,5,1,4,0,2,0,2,1,3,1,4,0,2,1,0,0,2,1,4,1,1,0,3,3,0,5,1,3,2,3,3,1,0,3,2,3,0,1,0,0,0,0,0,0,1,0,0,0,0,4,0,1,0,3,0,2,0,1,0,3,3,3,4,3,3,0,0,0,0,2,3),
+(0,0,0,1,0,0,0,0,0,0,2,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,1,0,0,1,0,0,0,0,0,3),
+(0,1,0,3,0,4,0,3,0,2,4,3,1,0,3,2,2,1,3,1,2,2,3,1,1,1,2,1,3,0,1,2,0,1,3,2,1,3,0,5,5,1,0,0,1,3,2,1,0,3,0,0,1,0,0,0,0,0,3,4,0,1,1,1,3,2,0,2,0,1,0,2,3,3,1,2,3,0,1,0,1,0,4),
+(0,0,0,1,0,3,0,3,0,2,2,1,0,0,4,0,3,0,3,1,3,0,3,0,3,0,1,0,3,0,3,1,3,0,3,3,0,0,1,2,1,1,1,0,1,2,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,2,2,1,2,0,0,2,0,0,0,0,2,3,3,3,3,0,0,0,0,1,4),
+(0,0,0,3,0,3,0,0,0,0,3,1,1,0,3,0,1,0,2,0,1,0,0,0,0,0,0,0,1,0,3,0,2,0,2,3,0,0,2,2,3,1,2,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,2,0,0,0,0,2,3),
+(2,4,0,5,0,5,0,4,0,3,4,3,3,3,4,3,3,3,4,3,4,4,5,4,5,5,5,2,3,0,5,5,4,1,5,4,3,1,5,4,3,4,4,3,3,4,3,3,0,3,2,0,2,3,0,3,0,0,3,3,0,5,3,2,3,3,0,3,0,3,0,3,4,5,4,5,3,0,4,3,0,3,4),
+(0,3,0,3,0,3,0,3,0,3,3,4,3,2,3,2,3,0,4,3,3,3,3,3,3,3,3,0,3,2,4,3,3,1,3,4,3,4,4,4,3,4,4,3,2,4,4,1,0,2,0,0,1,1,0,2,0,0,3,1,0,5,3,2,1,3,0,3,0,1,2,4,3,2,4,3,3,0,3,2,0,4,4),
+(0,3,0,3,0,1,0,0,0,1,4,3,3,2,3,1,3,1,4,2,3,2,4,2,3,4,3,0,2,2,3,3,3,0,3,3,3,0,3,4,1,3,3,0,3,4,3,3,0,1,1,0,1,0,0,0,4,0,3,0,0,3,1,2,1,3,0,4,0,1,0,4,3,3,4,3,3,0,2,0,0,3,3),
+(0,3,0,4,0,1,0,3,0,3,4,3,3,0,3,3,3,1,3,1,3,3,4,3,3,3,0,0,3,1,5,3,3,1,3,3,2,5,4,3,3,4,5,3,2,5,3,4,0,1,0,0,0,0,0,2,0,0,1,1,0,4,2,2,1,3,0,3,0,2,0,4,4,3,5,3,2,0,1,1,0,3,4),
+(0,5,0,4,0,5,0,2,0,4,4,3,3,2,3,3,3,1,4,3,4,1,5,3,4,3,4,0,4,2,4,3,4,1,5,4,0,4,4,4,4,5,4,1,3,5,4,2,1,4,1,1,3,2,0,3,1,0,3,2,1,4,3,3,3,4,0,4,0,3,0,4,4,4,3,3,3,0,4,2,0,3,4),
+(1,4,0,4,0,3,0,1,0,3,3,3,1,1,3,3,2,2,3,3,1,0,3,2,2,1,2,0,3,1,2,1,2,0,3,2,0,2,2,3,3,4,3,0,3,3,1,2,0,1,1,3,1,2,0,0,3,0,1,1,0,3,2,2,3,3,0,3,0,0,0,2,3,3,4,3,3,0,1,0,0,1,4),
+(0,4,0,4,0,4,0,0,0,3,4,4,3,1,4,2,3,2,3,3,3,1,4,3,4,0,3,0,4,2,3,3,2,2,5,4,2,1,3,4,3,4,3,1,3,3,4,2,0,2,1,0,3,3,0,0,2,0,3,1,0,4,4,3,4,3,0,4,0,1,0,2,4,4,4,4,4,0,3,2,0,3,3),
+(0,0,0,1,0,4,0,0,0,0,0,0,1,1,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,3,2,0,0,1,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,2),
+(0,2,0,3,0,4,0,4,0,1,3,3,3,0,4,0,2,1,2,1,1,1,2,0,3,1,1,0,1,0,3,1,0,0,3,3,2,0,1,1,0,0,0,0,0,1,0,2,0,2,2,0,3,1,0,0,1,0,1,1,0,1,2,0,3,0,0,0,0,1,0,0,3,3,4,3,1,0,1,0,3,0,2),
+(0,0,0,3,0,5,0,0,0,0,1,0,2,0,3,1,0,1,3,0,0,0,2,0,0,0,1,0,0,0,1,1,0,0,4,0,0,0,2,3,0,1,4,1,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,1,0,0,0,0,0,0,0,2,0,0,3,0,0,0,0,0,3),
+(0,2,0,5,0,5,0,1,0,2,4,3,3,2,5,1,3,2,3,3,3,0,4,1,2,0,3,0,4,0,2,2,1,1,5,3,0,0,1,4,2,3,2,0,3,3,3,2,0,2,4,1,1,2,0,1,1,0,3,1,0,1,3,1,2,3,0,2,0,0,0,1,3,5,4,4,4,0,3,0,0,1,3),
+(0,4,0,5,0,4,0,4,0,4,5,4,3,3,4,3,3,3,4,3,4,4,5,3,4,5,4,2,4,2,3,4,3,1,4,4,1,3,5,4,4,5,5,4,4,5,5,5,2,3,3,1,4,3,1,3,3,0,3,3,1,4,3,4,4,4,0,3,0,4,0,3,3,4,4,5,0,0,4,3,0,4,5),
+(0,4,0,4,0,3,0,3,0,3,4,4,4,3,3,2,4,3,4,3,4,3,5,3,4,3,2,1,4,2,4,4,3,1,3,4,2,4,5,5,3,4,5,4,1,5,4,3,0,3,2,2,3,2,1,3,1,0,3,3,3,5,3,3,3,5,4,4,2,3,3,4,3,3,3,2,1,0,3,2,1,4,3),
+(0,4,0,5,0,4,0,3,0,3,5,5,3,2,4,3,4,0,5,4,4,1,4,4,4,3,3,3,4,3,5,5,2,3,3,4,1,2,5,5,3,5,5,2,3,5,5,4,0,3,2,0,3,3,1,1,5,1,4,1,0,4,3,2,3,5,0,4,0,3,0,5,4,3,4,3,0,0,4,1,0,4,4),
+(1,3,0,4,0,2,0,2,0,2,5,5,3,3,3,3,3,0,4,2,3,4,4,4,3,4,0,0,3,4,5,4,3,3,3,3,2,5,5,4,5,5,5,4,3,5,5,5,1,3,1,0,1,0,0,3,2,0,4,2,0,5,2,3,2,4,1,3,0,3,0,4,5,4,5,4,3,0,4,2,0,5,4),
+(0,3,0,4,0,5,0,3,0,3,4,4,3,2,3,2,3,3,3,3,3,2,4,3,3,2,2,0,3,3,3,3,3,1,3,3,3,0,4,4,3,4,4,1,1,4,4,2,0,3,1,0,1,1,0,4,1,0,2,3,1,3,3,1,3,4,0,3,0,1,0,3,1,3,0,0,1,0,2,0,0,4,4),
+(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
+(0,3,0,3,0,2,0,3,0,1,5,4,3,3,3,1,4,2,1,2,3,4,4,2,4,4,5,0,3,1,4,3,4,0,4,3,3,3,2,3,2,5,3,4,3,2,2,3,0,0,3,0,2,1,0,1,2,0,0,0,0,2,1,1,3,1,0,2,0,4,0,3,4,4,4,5,2,0,2,0,0,1,3),
+(0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,1,1,0,0,1,1,0,0,0,4,2,1,1,0,1,0,3,2,0,0,3,1,1,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,1,0,0,0,2,0,0,0,1,4,0,4,2,1,0,0,0,0,0,1),
+(0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,0,1,0,0,0,0,0,0,1,0,1,0,0,0,0,3,1,0,0,0,2,0,2,1,0,0,1,2,1,0,1,1,0,0,3,0,0,0,0,0,0,0,0,0,0,0,1,3,1,0,0,0,0,0,1,0,0,2,1,0,0,0,0,0,0,0,0,2),
+(0,4,0,4,0,4,0,3,0,4,4,3,4,2,4,3,2,0,4,4,4,3,5,3,5,3,3,2,4,2,4,3,4,3,1,4,0,2,3,4,4,4,3,3,3,4,4,4,3,4,1,3,4,3,2,1,2,1,3,3,3,4,4,3,3,5,0,4,0,3,0,4,3,3,3,2,1,0,3,0,0,3,3),
+(0,4,0,3,0,3,0,3,0,3,5,5,3,3,3,3,4,3,4,3,3,3,4,4,4,3,3,3,3,4,3,5,3,3,1,3,2,4,5,5,5,5,4,3,4,5,5,3,2,2,3,3,3,3,2,3,3,1,2,3,2,4,3,3,3,4,0,4,0,2,0,4,3,2,2,1,2,0,3,0,0,4,1),
+)
+
+class JapaneseContextAnalysis(object):
+    NUM_OF_CATEGORY = 6
+    DONT_KNOW = -1
+    ENOUGH_REL_THRESHOLD = 100
+    MAX_REL_THRESHOLD = 1000
+    MINIMUM_DATA_THRESHOLD = 4
+
+    def __init__(self):
+        self._total_rel = None
+        self._rel_sample = None
+        self._need_to_skip_char_num = None
+        self._last_char_order = None
+        self._done = None
+        self.reset()
+
+    def reset(self):
+        self._total_rel = 0  # total sequence received
+        # category counters, each integer counts sequence in its category
+        self._rel_sample = [0] * self.NUM_OF_CATEGORY
+        # if last byte in current buffer is not the last byte of a character,
+        # we need to know how many bytes to skip in next buffer
+        self._need_to_skip_char_num = 0
+        self._last_char_order = -1  # The order of previous char
+        # If this flag is set to True, detection is done and conclusion has
+        # been made
+        self._done = False
+
+    def feed(self, byte_str, num_bytes):
+        if self._done:
+            return
+
+        # The buffer we got is byte oriented, and a character may span in more than one
+        # buffers. In case the last one or two byte in last buffer is not
+        # complete, we record how many byte needed to complete that character
+        # and skip these bytes here.  We can choose to record those bytes as
+        # well and analyse the character once it is complete, but since a
+        # character will not make much difference, by simply skipping
+        # this character will simply our logic and improve performance.
+        i = self._need_to_skip_char_num
+        while i < num_bytes:
+            order, char_len = self.get_order(byte_str[i:i + 2])
+            i += char_len
+            if i > num_bytes:
+                self._need_to_skip_char_num = i - num_bytes
+                self._last_char_order = -1
+            else:
+                if (order != -1) and (self._last_char_order != -1):
+                    self._total_rel += 1
+                    if self._total_rel > self.MAX_REL_THRESHOLD:
+                        self._done = True
+                        break
+                    self._rel_sample[jp2CharContext[self._last_char_order][order]] += 1
+                self._last_char_order = order
+
+    def got_enough_data(self):
+        return self._total_rel > self.ENOUGH_REL_THRESHOLD
+
+    def get_confidence(self):
+        # This is just one way to calculate confidence. It works well for me.
+        if self._total_rel > self.MINIMUM_DATA_THRESHOLD:
+            return (self._total_rel - self._rel_sample[0]) / self._total_rel
+        else:
+            return self.DONT_KNOW
+
+    def get_order(self, byte_str):
+        return -1, 1
+
+class SJISContextAnalysis(JapaneseContextAnalysis):
+    def __init__(self):
+        super(SJISContextAnalysis, self).__init__()
+        self._charset_name = "SHIFT_JIS"
+
+    @property
+    def charset_name(self):
+        return self._charset_name
+
+    def get_order(self, byte_str):
+        if not byte_str:
+            return -1, 1
+        # find out current char's byte length
+        first_char = byte_str[0]
+        if (0x81 <= first_char <= 0x9F) or (0xE0 <= first_char <= 0xFC):
+            char_len = 2
+            if (first_char == 0x87) or (0xFA <= first_char <= 0xFC):
+                self._charset_name = "CP932"
+        else:
+            char_len = 1
+
+        # return its order if it is hiragana
+        if len(byte_str) > 1:
+            second_char = byte_str[1]
+            if (first_char == 202) and (0x9F <= second_char <= 0xF1):
+                return second_char - 0x9F, char_len
+
+        return -1, char_len
+
+class EUCJPContextAnalysis(JapaneseContextAnalysis):
+    def get_order(self, byte_str):
+        if not byte_str:
+            return -1, 1
+        # find out current char's byte length
+        first_char = byte_str[0]
+        if (first_char == 0x8E) or (0xA1 <= first_char <= 0xFE):
+            char_len = 2
+        elif first_char == 0x8F:
+            char_len = 3
+        else:
+            char_len = 1
+
+        # return its order if it is hiragana
+        if len(byte_str) > 1:
+            second_char = byte_str[1]
+            if (first_char == 0xA4) and (0xA1 <= second_char <= 0xF3):
+                return second_char - 0xA1, char_len
+
+        return -1, char_len
+
+
diff --git a/openpype/vendor/python/python_2/chardet/langbulgarianmodel.py b/openpype/vendor/python/python_2/chardet/langbulgarianmodel.py
new file mode 100644
index 0000000000..561bfd9051
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/langbulgarianmodel.py
@@ -0,0 +1,4650 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from chardet.sbcharsetprober import SingleByteCharSetModel
+
+
+# 3: Positive
+# 2: Likely
+# 1: Unlikely
+# 0: Negative
+
+BULGARIAN_LANG_MODEL = {
+    63: {  # 'e'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 0,  # 'а'
+        18: 1,  # 'б'
+        9: 1,  # 'в'
+        20: 1,  # 'г'
+        11: 1,  # 'д'
+        3: 1,  # 'е'
+        23: 1,  # 'ж'
+        15: 1,  # 'з'
+        2: 0,  # 'и'
+        26: 1,  # 'й'
+        12: 1,  # 'к'
+        10: 1,  # 'л'
+        14: 1,  # 'м'
+        6: 1,  # 'н'
+        4: 1,  # 'о'
+        13: 1,  # 'п'
+        7: 1,  # 'р'
+        8: 1,  # 'с'
+        5: 1,  # 'т'
+        19: 0,  # 'у'
+        29: 1,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 1,  # 'ч'
+        27: 1,  # 'ш'
+        24: 1,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    45: {  # '\xad'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 0,  # 'Г'
+        37: 1,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 1,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 0,  # 'Л'
+        38: 1,  # 'М'
+        36: 0,  # 'Н'
+        41: 1,  # 'О'
+        30: 1,  # 'П'
+        39: 1,  # 'Р'
+        28: 1,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 0,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 0,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 0,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 0,  # 'о'
+        13: 0,  # 'п'
+        7: 0,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 0,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    31: {  # 'А'
+        63: 0,  # 'e'
+        45: 1,  # '\xad'
+        31: 1,  # 'А'
+        32: 1,  # 'Б'
+        35: 2,  # 'В'
+        43: 1,  # 'Г'
+        37: 2,  # 'Д'
+        44: 2,  # 'Е'
+        55: 1,  # 'Ж'
+        47: 2,  # 'З'
+        40: 1,  # 'И'
+        59: 1,  # 'Й'
+        33: 1,  # 'К'
+        46: 2,  # 'Л'
+        38: 1,  # 'М'
+        36: 2,  # 'Н'
+        41: 1,  # 'О'
+        30: 2,  # 'П'
+        39: 2,  # 'Р'
+        28: 2,  # 'С'
+        34: 2,  # 'Т'
+        51: 1,  # 'У'
+        48: 2,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 1,  # 'Ш'
+        57: 2,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 1,  # 'а'
+        18: 2,  # 'б'
+        9: 2,  # 'в'
+        20: 2,  # 'г'
+        11: 2,  # 'д'
+        3: 1,  # 'е'
+        23: 1,  # 'ж'
+        15: 2,  # 'з'
+        2: 0,  # 'и'
+        26: 2,  # 'й'
+        12: 2,  # 'к'
+        10: 3,  # 'л'
+        14: 2,  # 'м'
+        6: 3,  # 'н'
+        4: 0,  # 'о'
+        13: 2,  # 'п'
+        7: 2,  # 'р'
+        8: 2,  # 'с'
+        5: 2,  # 'т'
+        19: 1,  # 'у'
+        29: 2,  # 'ф'
+        25: 1,  # 'х'
+        22: 1,  # 'ц'
+        21: 1,  # 'ч'
+        27: 1,  # 'ш'
+        24: 0,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    32: {  # 'Б'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 2,  # 'А'
+        32: 2,  # 'Б'
+        35: 1,  # 'В'
+        43: 1,  # 'Г'
+        37: 2,  # 'Д'
+        44: 1,  # 'Е'
+        55: 1,  # 'Ж'
+        47: 2,  # 'З'
+        40: 1,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 2,  # 'Н'
+        41: 2,  # 'О'
+        30: 1,  # 'П'
+        39: 1,  # 'Р'
+        28: 2,  # 'С'
+        34: 2,  # 'Т'
+        51: 1,  # 'У'
+        48: 2,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 1,  # 'Щ'
+        61: 2,  # 'Ъ'
+        60: 1,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 3,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 1,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 2,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 2,  # 'р'
+        8: 1,  # 'с'
+        5: 0,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 2,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    35: {  # 'В'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 2,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 0,  # 'Г'
+        37: 1,  # 'Д'
+        44: 2,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 2,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 1,  # 'О'
+        30: 1,  # 'П'
+        39: 2,  # 'Р'
+        28: 2,  # 'С'
+        34: 1,  # 'Т'
+        51: 1,  # 'У'
+        48: 2,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 1,  # 'Ю'
+        56: 2,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 1,  # 'д'
+        3: 3,  # 'е'
+        23: 1,  # 'ж'
+        15: 2,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 2,  # 'л'
+        14: 1,  # 'м'
+        6: 2,  # 'н'
+        4: 2,  # 'о'
+        13: 1,  # 'п'
+        7: 2,  # 'р'
+        8: 2,  # 'с'
+        5: 2,  # 'т'
+        19: 1,  # 'у'
+        29: 0,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 2,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    43: {  # 'Г'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 2,  # 'А'
+        32: 1,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 1,  # 'Д'
+        44: 2,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 1,  # 'З'
+        40: 1,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 0,  # 'М'
+        36: 1,  # 'Н'
+        41: 1,  # 'О'
+        30: 0,  # 'П'
+        39: 1,  # 'Р'
+        28: 1,  # 'С'
+        34: 0,  # 'Т'
+        51: 1,  # 'У'
+        48: 1,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 1,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 2,  # 'а'
+        18: 1,  # 'б'
+        9: 1,  # 'в'
+        20: 0,  # 'г'
+        11: 1,  # 'д'
+        3: 3,  # 'е'
+        23: 1,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 2,  # 'л'
+        14: 1,  # 'м'
+        6: 1,  # 'н'
+        4: 2,  # 'о'
+        13: 0,  # 'п'
+        7: 2,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 1,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    37: {  # 'Д'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 2,  # 'А'
+        32: 1,  # 'Б'
+        35: 2,  # 'В'
+        43: 1,  # 'Г'
+        37: 2,  # 'Д'
+        44: 2,  # 'Е'
+        55: 2,  # 'Ж'
+        47: 1,  # 'З'
+        40: 2,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 2,  # 'О'
+        30: 2,  # 'П'
+        39: 1,  # 'Р'
+        28: 2,  # 'С'
+        34: 1,  # 'Т'
+        51: 1,  # 'У'
+        48: 1,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 1,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 3,  # 'а'
+        18: 0,  # 'б'
+        9: 2,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 3,  # 'е'
+        23: 3,  # 'ж'
+        15: 1,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 1,  # 'л'
+        14: 1,  # 'м'
+        6: 2,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 2,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 2,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    44: {  # 'Е'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 1,  # 'А'
+        32: 1,  # 'Б'
+        35: 2,  # 'В'
+        43: 1,  # 'Г'
+        37: 1,  # 'Д'
+        44: 1,  # 'Е'
+        55: 1,  # 'Ж'
+        47: 1,  # 'З'
+        40: 1,  # 'И'
+        59: 1,  # 'Й'
+        33: 2,  # 'К'
+        46: 2,  # 'Л'
+        38: 1,  # 'М'
+        36: 2,  # 'Н'
+        41: 2,  # 'О'
+        30: 1,  # 'П'
+        39: 2,  # 'Р'
+        28: 2,  # 'С'
+        34: 2,  # 'Т'
+        51: 1,  # 'У'
+        48: 2,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 2,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 1,  # 'Ш'
+        57: 1,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 0,  # 'а'
+        18: 1,  # 'б'
+        9: 2,  # 'в'
+        20: 1,  # 'г'
+        11: 2,  # 'д'
+        3: 0,  # 'е'
+        23: 1,  # 'ж'
+        15: 1,  # 'з'
+        2: 0,  # 'и'
+        26: 1,  # 'й'
+        12: 2,  # 'к'
+        10: 2,  # 'л'
+        14: 2,  # 'м'
+        6: 2,  # 'н'
+        4: 0,  # 'о'
+        13: 1,  # 'п'
+        7: 2,  # 'р'
+        8: 2,  # 'с'
+        5: 1,  # 'т'
+        19: 1,  # 'у'
+        29: 1,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 1,  # 'ч'
+        27: 1,  # 'ш'
+        24: 1,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    55: {  # 'Ж'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 1,  # 'А'
+        32: 0,  # 'Б'
+        35: 1,  # 'В'
+        43: 0,  # 'Г'
+        37: 1,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 1,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 1,  # 'Н'
+        41: 1,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 1,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 2,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 1,  # 'д'
+        3: 2,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 2,  # 'о'
+        13: 1,  # 'п'
+        7: 1,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 1,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    47: {  # 'З'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 2,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 1,  # 'Г'
+        37: 1,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 1,  # 'З'
+        40: 1,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 2,  # 'Н'
+        41: 1,  # 'О'
+        30: 1,  # 'П'
+        39: 1,  # 'Р'
+        28: 1,  # 'С'
+        34: 1,  # 'Т'
+        51: 1,  # 'У'
+        48: 0,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 2,  # 'в'
+        20: 1,  # 'г'
+        11: 2,  # 'д'
+        3: 2,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 1,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 2,  # 'л'
+        14: 1,  # 'м'
+        6: 1,  # 'н'
+        4: 1,  # 'о'
+        13: 0,  # 'п'
+        7: 1,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 1,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    40: {  # 'И'
+        63: 0,  # 'e'
+        45: 1,  # '\xad'
+        31: 1,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 1,  # 'Г'
+        37: 1,  # 'Д'
+        44: 2,  # 'Е'
+        55: 1,  # 'Ж'
+        47: 2,  # 'З'
+        40: 1,  # 'И'
+        59: 1,  # 'Й'
+        33: 2,  # 'К'
+        46: 2,  # 'Л'
+        38: 2,  # 'М'
+        36: 2,  # 'Н'
+        41: 1,  # 'О'
+        30: 1,  # 'П'
+        39: 2,  # 'Р'
+        28: 2,  # 'С'
+        34: 2,  # 'Т'
+        51: 0,  # 'У'
+        48: 1,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 1,  # 'Ш'
+        57: 1,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 2,  # 'Я'
+        1: 1,  # 'а'
+        18: 1,  # 'б'
+        9: 3,  # 'в'
+        20: 2,  # 'г'
+        11: 1,  # 'д'
+        3: 1,  # 'е'
+        23: 0,  # 'ж'
+        15: 3,  # 'з'
+        2: 0,  # 'и'
+        26: 1,  # 'й'
+        12: 1,  # 'к'
+        10: 2,  # 'л'
+        14: 2,  # 'м'
+        6: 2,  # 'н'
+        4: 0,  # 'о'
+        13: 1,  # 'п'
+        7: 2,  # 'р'
+        8: 2,  # 'с'
+        5: 2,  # 'т'
+        19: 0,  # 'у'
+        29: 1,  # 'ф'
+        25: 1,  # 'х'
+        22: 1,  # 'ц'
+        21: 1,  # 'ч'
+        27: 1,  # 'ш'
+        24: 1,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    59: {  # 'Й'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 1,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 1,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 1,  # 'С'
+        34: 1,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 0,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 1,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 0,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 2,  # 'о'
+        13: 0,  # 'п'
+        7: 0,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 0,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    33: {  # 'К'
+        63: 0,  # 'e'
+        45: 1,  # '\xad'
+        31: 2,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 1,  # 'Г'
+        37: 1,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 1,  # 'З'
+        40: 2,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 0,  # 'М'
+        36: 2,  # 'Н'
+        41: 2,  # 'О'
+        30: 2,  # 'П'
+        39: 1,  # 'Р'
+        28: 2,  # 'С'
+        34: 1,  # 'Т'
+        51: 1,  # 'У'
+        48: 1,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 1,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 0,  # 'б'
+        9: 1,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 2,  # 'е'
+        23: 1,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 2,  # 'л'
+        14: 1,  # 'м'
+        6: 2,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 3,  # 'р'
+        8: 1,  # 'с'
+        5: 0,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 1,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 2,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    46: {  # 'Л'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 2,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 2,  # 'Г'
+        37: 1,  # 'Д'
+        44: 2,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 1,  # 'З'
+        40: 2,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 0,  # 'М'
+        36: 1,  # 'Н'
+        41: 2,  # 'О'
+        30: 1,  # 'П'
+        39: 0,  # 'Р'
+        28: 1,  # 'С'
+        34: 1,  # 'Т'
+        51: 1,  # 'У'
+        48: 0,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 1,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 2,  # 'а'
+        18: 0,  # 'б'
+        9: 1,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 2,  # 'о'
+        13: 0,  # 'п'
+        7: 0,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 2,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    38: {  # 'М'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 2,  # 'А'
+        32: 1,  # 'Б'
+        35: 2,  # 'В'
+        43: 0,  # 'Г'
+        37: 1,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 1,  # 'З'
+        40: 2,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 2,  # 'О'
+        30: 1,  # 'П'
+        39: 1,  # 'Р'
+        28: 2,  # 'С'
+        34: 1,  # 'Т'
+        51: 1,  # 'У'
+        48: 1,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 3,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 2,  # 'л'
+        14: 0,  # 'м'
+        6: 2,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 1,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 2,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    36: {  # 'Н'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 2,  # 'А'
+        32: 2,  # 'Б'
+        35: 1,  # 'В'
+        43: 1,  # 'Г'
+        37: 2,  # 'Д'
+        44: 2,  # 'Е'
+        55: 1,  # 'Ж'
+        47: 1,  # 'З'
+        40: 2,  # 'И'
+        59: 1,  # 'Й'
+        33: 2,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 2,  # 'О'
+        30: 1,  # 'П'
+        39: 1,  # 'Р'
+        28: 2,  # 'С'
+        34: 2,  # 'Т'
+        51: 1,  # 'У'
+        48: 1,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 1,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 1,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 3,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 1,  # 'г'
+        11: 0,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 0,  # 'р'
+        8: 0,  # 'с'
+        5: 1,  # 'т'
+        19: 1,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 1,  # 'ш'
+        24: 0,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 2,  # 'ю'
+        16: 2,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    41: {  # 'О'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 1,  # 'А'
+        32: 1,  # 'Б'
+        35: 2,  # 'В'
+        43: 1,  # 'Г'
+        37: 2,  # 'Д'
+        44: 1,  # 'Е'
+        55: 1,  # 'Ж'
+        47: 1,  # 'З'
+        40: 1,  # 'И'
+        59: 1,  # 'Й'
+        33: 2,  # 'К'
+        46: 2,  # 'Л'
+        38: 2,  # 'М'
+        36: 2,  # 'Н'
+        41: 2,  # 'О'
+        30: 1,  # 'П'
+        39: 2,  # 'Р'
+        28: 2,  # 'С'
+        34: 2,  # 'Т'
+        51: 1,  # 'У'
+        48: 1,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 1,  # 'Ш'
+        57: 1,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 1,  # 'а'
+        18: 2,  # 'б'
+        9: 2,  # 'в'
+        20: 2,  # 'г'
+        11: 1,  # 'д'
+        3: 1,  # 'е'
+        23: 1,  # 'ж'
+        15: 1,  # 'з'
+        2: 0,  # 'и'
+        26: 1,  # 'й'
+        12: 2,  # 'к'
+        10: 2,  # 'л'
+        14: 1,  # 'м'
+        6: 1,  # 'н'
+        4: 0,  # 'о'
+        13: 2,  # 'п'
+        7: 2,  # 'р'
+        8: 2,  # 'с'
+        5: 3,  # 'т'
+        19: 1,  # 'у'
+        29: 1,  # 'ф'
+        25: 1,  # 'х'
+        22: 1,  # 'ц'
+        21: 2,  # 'ч'
+        27: 0,  # 'ш'
+        24: 2,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    30: {  # 'П'
+        63: 0,  # 'e'
+        45: 1,  # '\xad'
+        31: 2,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 1,  # 'Г'
+        37: 1,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 1,  # 'З'
+        40: 2,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 2,  # 'О'
+        30: 2,  # 'П'
+        39: 2,  # 'Р'
+        28: 2,  # 'С'
+        34: 1,  # 'Т'
+        51: 2,  # 'У'
+        48: 1,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 1,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 1,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 2,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 3,  # 'л'
+        14: 0,  # 'м'
+        6: 1,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 3,  # 'р'
+        8: 1,  # 'с'
+        5: 1,  # 'т'
+        19: 2,  # 'у'
+        29: 1,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 1,  # 'ч'
+        27: 1,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    39: {  # 'Р'
+        63: 0,  # 'e'
+        45: 1,  # '\xad'
+        31: 2,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 2,  # 'Г'
+        37: 2,  # 'Д'
+        44: 2,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 1,  # 'З'
+        40: 2,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 0,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 2,  # 'О'
+        30: 2,  # 'П'
+        39: 1,  # 'Р'
+        28: 1,  # 'С'
+        34: 1,  # 'Т'
+        51: 1,  # 'У'
+        48: 1,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 1,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 3,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 2,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 1,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 0,  # 'р'
+        8: 1,  # 'с'
+        5: 0,  # 'т'
+        19: 3,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    28: {  # 'С'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 3,  # 'А'
+        32: 2,  # 'Б'
+        35: 2,  # 'В'
+        43: 1,  # 'Г'
+        37: 2,  # 'Д'
+        44: 2,  # 'Е'
+        55: 1,  # 'Ж'
+        47: 1,  # 'З'
+        40: 2,  # 'И'
+        59: 0,  # 'Й'
+        33: 2,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 2,  # 'О'
+        30: 2,  # 'П'
+        39: 1,  # 'Р'
+        28: 2,  # 'С'
+        34: 2,  # 'Т'
+        51: 1,  # 'У'
+        48: 1,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 1,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 2,  # 'в'
+        20: 1,  # 'г'
+        11: 1,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 2,  # 'к'
+        10: 3,  # 'л'
+        14: 2,  # 'м'
+        6: 1,  # 'н'
+        4: 3,  # 'о'
+        13: 3,  # 'п'
+        7: 2,  # 'р'
+        8: 0,  # 'с'
+        5: 3,  # 'т'
+        19: 2,  # 'у'
+        29: 2,  # 'ф'
+        25: 1,  # 'х'
+        22: 1,  # 'ц'
+        21: 1,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    34: {  # 'Т'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 2,  # 'А'
+        32: 2,  # 'Б'
+        35: 1,  # 'В'
+        43: 0,  # 'Г'
+        37: 1,  # 'Д'
+        44: 2,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 2,  # 'И'
+        59: 0,  # 'Й'
+        33: 2,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 2,  # 'О'
+        30: 1,  # 'П'
+        39: 2,  # 'Р'
+        28: 2,  # 'С'
+        34: 1,  # 'Т'
+        51: 1,  # 'У'
+        48: 1,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 1,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 1,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 1,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 1,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 3,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 2,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    51: {  # 'У'
+        63: 0,  # 'e'
+        45: 1,  # '\xad'
+        31: 1,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 1,  # 'Г'
+        37: 1,  # 'Д'
+        44: 2,  # 'Е'
+        55: 1,  # 'Ж'
+        47: 1,  # 'З'
+        40: 1,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 0,  # 'О'
+        30: 1,  # 'П'
+        39: 1,  # 'Р'
+        28: 1,  # 'С'
+        34: 2,  # 'Т'
+        51: 0,  # 'У'
+        48: 1,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 1,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 1,  # 'а'
+        18: 1,  # 'б'
+        9: 2,  # 'в'
+        20: 1,  # 'г'
+        11: 1,  # 'д'
+        3: 2,  # 'е'
+        23: 1,  # 'ж'
+        15: 1,  # 'з'
+        2: 2,  # 'и'
+        26: 1,  # 'й'
+        12: 2,  # 'к'
+        10: 1,  # 'л'
+        14: 1,  # 'м'
+        6: 2,  # 'н'
+        4: 2,  # 'о'
+        13: 1,  # 'п'
+        7: 1,  # 'р'
+        8: 2,  # 'с'
+        5: 1,  # 'т'
+        19: 1,  # 'у'
+        29: 0,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 2,  # 'ч'
+        27: 1,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    48: {  # 'Ф'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 2,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 2,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 0,  # 'М'
+        36: 1,  # 'Н'
+        41: 1,  # 'О'
+        30: 2,  # 'П'
+        39: 1,  # 'Р'
+        28: 2,  # 'С'
+        34: 1,  # 'Т'
+        51: 1,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 2,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 2,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 2,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 2,  # 'о'
+        13: 0,  # 'п'
+        7: 2,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 1,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    49: {  # 'Х'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 1,  # 'А'
+        32: 0,  # 'Б'
+        35: 1,  # 'В'
+        43: 1,  # 'Г'
+        37: 1,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 1,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 1,  # 'О'
+        30: 1,  # 'П'
+        39: 1,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 2,  # 'а'
+        18: 0,  # 'б'
+        9: 1,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 2,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 1,  # 'л'
+        14: 1,  # 'м'
+        6: 0,  # 'н'
+        4: 2,  # 'о'
+        13: 0,  # 'п'
+        7: 2,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    53: {  # 'Ц'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 1,  # 'А'
+        32: 0,  # 'Б'
+        35: 1,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 2,  # 'И'
+        59: 0,  # 'Й'
+        33: 2,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 1,  # 'Р'
+        28: 2,  # 'С'
+        34: 0,  # 'Т'
+        51: 1,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 2,  # 'а'
+        18: 0,  # 'б'
+        9: 2,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 2,  # 'е'
+        23: 0,  # 'ж'
+        15: 1,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 1,  # 'о'
+        13: 0,  # 'п'
+        7: 1,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 1,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    50: {  # 'Ч'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 2,  # 'А'
+        32: 1,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 1,  # 'З'
+        40: 1,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 0,  # 'М'
+        36: 1,  # 'Н'
+        41: 1,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 1,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 2,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 3,  # 'е'
+        23: 1,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 1,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 2,  # 'о'
+        13: 0,  # 'п'
+        7: 1,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 0,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    54: {  # 'Ш'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 1,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 1,  # 'З'
+        40: 1,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 1,  # 'Н'
+        41: 1,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 1,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 2,  # 'а'
+        18: 0,  # 'б'
+        9: 2,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 2,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 2,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 1,  # 'л'
+        14: 1,  # 'м'
+        6: 1,  # 'н'
+        4: 2,  # 'о'
+        13: 1,  # 'п'
+        7: 1,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 1,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 0,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    57: {  # 'Щ'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 1,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 1,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 1,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 2,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 2,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 1,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 1,  # 'о'
+        13: 0,  # 'п'
+        7: 1,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 1,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    61: {  # 'Ъ'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 0,  # 'Г'
+        37: 1,  # 'Д'
+        44: 0,  # 'Е'
+        55: 1,  # 'Ж'
+        47: 1,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 2,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 0,  # 'О'
+        30: 1,  # 'П'
+        39: 2,  # 'Р'
+        28: 1,  # 'С'
+        34: 1,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 1,  # 'Х'
+        53: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        54: 1,  # 'Ш'
+        57: 1,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 0,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 0,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 0,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 1,  # 'л'
+        14: 0,  # 'м'
+        6: 1,  # 'н'
+        4: 0,  # 'о'
+        13: 0,  # 'п'
+        7: 1,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 0,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    60: {  # 'Ю'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 1,  # 'А'
+        32: 1,  # 'Б'
+        35: 0,  # 'В'
+        43: 1,  # 'Г'
+        37: 1,  # 'Д'
+        44: 0,  # 'Е'
+        55: 1,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 0,  # 'М'
+        36: 1,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 1,  # 'Р'
+        28: 1,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 0,  # 'а'
+        18: 1,  # 'б'
+        9: 1,  # 'в'
+        20: 2,  # 'г'
+        11: 1,  # 'д'
+        3: 0,  # 'е'
+        23: 2,  # 'ж'
+        15: 1,  # 'з'
+        2: 1,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 1,  # 'л'
+        14: 1,  # 'м'
+        6: 1,  # 'н'
+        4: 0,  # 'о'
+        13: 1,  # 'п'
+        7: 1,  # 'р'
+        8: 1,  # 'с'
+        5: 1,  # 'т'
+        19: 0,  # 'у'
+        29: 0,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    56: {  # 'Я'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 1,  # 'Б'
+        35: 1,  # 'В'
+        43: 1,  # 'Г'
+        37: 1,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 1,  # 'Л'
+        38: 1,  # 'М'
+        36: 1,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 1,  # 'С'
+        34: 2,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 0,  # 'а'
+        18: 1,  # 'б'
+        9: 1,  # 'в'
+        20: 1,  # 'г'
+        11: 1,  # 'д'
+        3: 0,  # 'е'
+        23: 0,  # 'ж'
+        15: 1,  # 'з'
+        2: 1,  # 'и'
+        26: 1,  # 'й'
+        12: 1,  # 'к'
+        10: 1,  # 'л'
+        14: 2,  # 'м'
+        6: 2,  # 'н'
+        4: 0,  # 'о'
+        13: 2,  # 'п'
+        7: 1,  # 'р'
+        8: 1,  # 'с'
+        5: 1,  # 'т'
+        19: 0,  # 'у'
+        29: 0,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 1,  # 'ш'
+        24: 0,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    1: {  # 'а'
+        63: 1,  # 'e'
+        45: 1,  # '\xad'
+        31: 1,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 1,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 1,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 3,  # 'г'
+        11: 3,  # 'д'
+        3: 3,  # 'е'
+        23: 3,  # 'ж'
+        15: 3,  # 'з'
+        2: 3,  # 'и'
+        26: 3,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 3,  # 'м'
+        6: 3,  # 'н'
+        4: 2,  # 'о'
+        13: 3,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 3,  # 'у'
+        29: 3,  # 'ф'
+        25: 3,  # 'х'
+        22: 3,  # 'ц'
+        21: 3,  # 'ч'
+        27: 3,  # 'ш'
+        24: 3,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    18: {  # 'б'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 0,  # 'б'
+        9: 3,  # 'в'
+        20: 1,  # 'г'
+        11: 2,  # 'д'
+        3: 3,  # 'е'
+        23: 1,  # 'ж'
+        15: 1,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 3,  # 'л'
+        14: 2,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 1,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 0,  # 'т'
+        19: 3,  # 'у'
+        29: 0,  # 'ф'
+        25: 2,  # 'х'
+        22: 1,  # 'ц'
+        21: 1,  # 'ч'
+        27: 1,  # 'ш'
+        24: 3,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 2,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    9: {  # 'в'
+        63: 1,  # 'e'
+        45: 1,  # '\xad'
+        31: 0,  # 'А'
+        32: 1,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 1,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 0,  # 'в'
+        20: 2,  # 'г'
+        11: 3,  # 'д'
+        3: 3,  # 'е'
+        23: 1,  # 'ж'
+        15: 3,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 2,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 2,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 2,  # 'х'
+        22: 2,  # 'ц'
+        21: 3,  # 'ч'
+        27: 2,  # 'ш'
+        24: 1,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 2,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    20: {  # 'г'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 2,  # 'в'
+        20: 1,  # 'г'
+        11: 2,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 1,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 3,  # 'л'
+        14: 1,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 1,  # 'п'
+        7: 3,  # 'р'
+        8: 2,  # 'с'
+        5: 2,  # 'т'
+        19: 3,  # 'у'
+        29: 1,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 1,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    11: {  # 'д'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 2,  # 'б'
+        9: 3,  # 'в'
+        20: 2,  # 'г'
+        11: 2,  # 'д'
+        3: 3,  # 'е'
+        23: 3,  # 'ж'
+        15: 2,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 3,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 3,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 1,  # 'т'
+        19: 3,  # 'у'
+        29: 1,  # 'ф'
+        25: 2,  # 'х'
+        22: 2,  # 'ц'
+        21: 2,  # 'ч'
+        27: 1,  # 'ш'
+        24: 1,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    3: {  # 'е'
+        63: 0,  # 'e'
+        45: 1,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 2,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 3,  # 'г'
+        11: 3,  # 'д'
+        3: 2,  # 'е'
+        23: 3,  # 'ж'
+        15: 3,  # 'з'
+        2: 2,  # 'и'
+        26: 3,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 3,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 3,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 2,  # 'у'
+        29: 3,  # 'ф'
+        25: 3,  # 'х'
+        22: 3,  # 'ц'
+        21: 3,  # 'ч'
+        27: 3,  # 'ш'
+        24: 3,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    23: {  # 'ж'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 3,  # 'б'
+        9: 2,  # 'в'
+        20: 1,  # 'г'
+        11: 3,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 2,  # 'к'
+        10: 1,  # 'л'
+        14: 1,  # 'м'
+        6: 3,  # 'н'
+        4: 2,  # 'о'
+        13: 1,  # 'п'
+        7: 1,  # 'р'
+        8: 1,  # 'с'
+        5: 1,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 1,  # 'ц'
+        21: 1,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    15: {  # 'з'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 3,  # 'г'
+        11: 3,  # 'д'
+        3: 3,  # 'е'
+        23: 1,  # 'ж'
+        15: 1,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 3,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 3,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 3,  # 'у'
+        29: 1,  # 'ф'
+        25: 2,  # 'х'
+        22: 2,  # 'ц'
+        21: 2,  # 'ч'
+        27: 2,  # 'ш'
+        24: 1,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 2,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    2: {  # 'и'
+        63: 1,  # 'e'
+        45: 1,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 1,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 1,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 1,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 1,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 3,  # 'г'
+        11: 3,  # 'д'
+        3: 3,  # 'е'
+        23: 3,  # 'ж'
+        15: 3,  # 'з'
+        2: 3,  # 'и'
+        26: 3,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 3,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 3,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 2,  # 'у'
+        29: 3,  # 'ф'
+        25: 3,  # 'х'
+        22: 3,  # 'ц'
+        21: 3,  # 'ч'
+        27: 3,  # 'ш'
+        24: 3,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    26: {  # 'й'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 1,  # 'а'
+        18: 2,  # 'б'
+        9: 2,  # 'в'
+        20: 1,  # 'г'
+        11: 2,  # 'д'
+        3: 2,  # 'е'
+        23: 0,  # 'ж'
+        15: 2,  # 'з'
+        2: 1,  # 'и'
+        26: 0,  # 'й'
+        12: 3,  # 'к'
+        10: 2,  # 'л'
+        14: 2,  # 'м'
+        6: 3,  # 'н'
+        4: 2,  # 'о'
+        13: 1,  # 'п'
+        7: 2,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 1,  # 'у'
+        29: 2,  # 'ф'
+        25: 1,  # 'х'
+        22: 2,  # 'ц'
+        21: 2,  # 'ч'
+        27: 1,  # 'ш'
+        24: 1,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    12: {  # 'к'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 1,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 1,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 3,  # 'в'
+        20: 2,  # 'г'
+        11: 1,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 2,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 3,  # 'л'
+        14: 2,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 1,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 3,  # 'у'
+        29: 1,  # 'ф'
+        25: 1,  # 'х'
+        22: 3,  # 'ц'
+        21: 2,  # 'ч'
+        27: 1,  # 'ш'
+        24: 0,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 2,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    10: {  # 'л'
+        63: 1,  # 'e'
+        45: 1,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 1,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 3,  # 'г'
+        11: 2,  # 'д'
+        3: 3,  # 'е'
+        23: 3,  # 'ж'
+        15: 2,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 3,  # 'к'
+        10: 1,  # 'л'
+        14: 2,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 2,  # 'п'
+        7: 2,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 3,  # 'у'
+        29: 2,  # 'ф'
+        25: 2,  # 'х'
+        22: 2,  # 'ц'
+        21: 2,  # 'ч'
+        27: 2,  # 'ш'
+        24: 1,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 2,  # 'ь'
+        42: 3,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    14: {  # 'м'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 1,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 1,  # 'г'
+        11: 1,  # 'д'
+        3: 3,  # 'е'
+        23: 1,  # 'ж'
+        15: 1,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 2,  # 'к'
+        10: 3,  # 'л'
+        14: 1,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 3,  # 'п'
+        7: 2,  # 'р'
+        8: 2,  # 'с'
+        5: 1,  # 'т'
+        19: 3,  # 'у'
+        29: 2,  # 'ф'
+        25: 1,  # 'х'
+        22: 2,  # 'ц'
+        21: 2,  # 'ч'
+        27: 2,  # 'ш'
+        24: 1,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 2,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    6: {  # 'н'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 1,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 2,  # 'б'
+        9: 2,  # 'в'
+        20: 3,  # 'г'
+        11: 3,  # 'д'
+        3: 3,  # 'е'
+        23: 2,  # 'ж'
+        15: 2,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 3,  # 'к'
+        10: 2,  # 'л'
+        14: 1,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 1,  # 'п'
+        7: 2,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 3,  # 'у'
+        29: 3,  # 'ф'
+        25: 2,  # 'х'
+        22: 3,  # 'ц'
+        21: 3,  # 'ч'
+        27: 2,  # 'ш'
+        24: 1,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 2,  # 'ь'
+        42: 2,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    4: {  # 'о'
+        63: 0,  # 'e'
+        45: 1,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 2,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 3,  # 'г'
+        11: 3,  # 'д'
+        3: 3,  # 'е'
+        23: 3,  # 'ж'
+        15: 3,  # 'з'
+        2: 3,  # 'и'
+        26: 3,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 3,  # 'м'
+        6: 3,  # 'н'
+        4: 2,  # 'о'
+        13: 3,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 2,  # 'у'
+        29: 3,  # 'ф'
+        25: 3,  # 'х'
+        22: 3,  # 'ц'
+        21: 3,  # 'ч'
+        27: 3,  # 'ш'
+        24: 3,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    13: {  # 'п'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 2,  # 'в'
+        20: 1,  # 'г'
+        11: 1,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 1,  # 'з'
+        2: 3,  # 'и'
+        26: 1,  # 'й'
+        12: 2,  # 'к'
+        10: 3,  # 'л'
+        14: 1,  # 'м'
+        6: 2,  # 'н'
+        4: 3,  # 'о'
+        13: 1,  # 'п'
+        7: 3,  # 'р'
+        8: 2,  # 'с'
+        5: 2,  # 'т'
+        19: 3,  # 'у'
+        29: 1,  # 'ф'
+        25: 1,  # 'х'
+        22: 2,  # 'ц'
+        21: 2,  # 'ч'
+        27: 1,  # 'ш'
+        24: 1,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 2,  # 'ю'
+        16: 2,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    7: {  # 'р'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 3,  # 'г'
+        11: 3,  # 'д'
+        3: 3,  # 'е'
+        23: 3,  # 'ж'
+        15: 2,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 3,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 2,  # 'п'
+        7: 1,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 3,  # 'у'
+        29: 2,  # 'ф'
+        25: 3,  # 'х'
+        22: 3,  # 'ц'
+        21: 2,  # 'ч'
+        27: 3,  # 'ш'
+        24: 1,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 2,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    8: {  # 'с'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 2,  # 'б'
+        9: 3,  # 'в'
+        20: 2,  # 'г'
+        11: 2,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 1,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 3,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 3,  # 'п'
+        7: 3,  # 'р'
+        8: 1,  # 'с'
+        5: 3,  # 'т'
+        19: 3,  # 'у'
+        29: 2,  # 'ф'
+        25: 2,  # 'х'
+        22: 2,  # 'ц'
+        21: 2,  # 'ч'
+        27: 2,  # 'ш'
+        24: 0,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 2,  # 'ь'
+        42: 2,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    5: {  # 'т'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 2,  # 'г'
+        11: 2,  # 'д'
+        3: 3,  # 'е'
+        23: 1,  # 'ж'
+        15: 1,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 2,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 2,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 3,  # 'у'
+        29: 1,  # 'ф'
+        25: 2,  # 'х'
+        22: 2,  # 'ц'
+        21: 2,  # 'ч'
+        27: 1,  # 'ш'
+        24: 1,  # 'щ'
+        17: 3,  # 'ъ'
+        52: 2,  # 'ь'
+        42: 2,  # 'ю'
+        16: 3,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    19: {  # 'у'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 3,  # 'г'
+        11: 3,  # 'д'
+        3: 2,  # 'е'
+        23: 3,  # 'ж'
+        15: 3,  # 'з'
+        2: 2,  # 'и'
+        26: 2,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 3,  # 'м'
+        6: 3,  # 'н'
+        4: 2,  # 'о'
+        13: 3,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 1,  # 'у'
+        29: 2,  # 'ф'
+        25: 2,  # 'х'
+        22: 2,  # 'ц'
+        21: 3,  # 'ч'
+        27: 3,  # 'ш'
+        24: 2,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    29: {  # 'ф'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 1,  # 'в'
+        20: 1,  # 'г'
+        11: 0,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 2,  # 'к'
+        10: 2,  # 'л'
+        14: 1,  # 'м'
+        6: 1,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 2,  # 'р'
+        8: 2,  # 'с'
+        5: 2,  # 'т'
+        19: 2,  # 'у'
+        29: 0,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 1,  # 'ч'
+        27: 1,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 2,  # 'ь'
+        42: 1,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    25: {  # 'х'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 3,  # 'в'
+        20: 0,  # 'г'
+        11: 1,  # 'д'
+        3: 2,  # 'е'
+        23: 0,  # 'ж'
+        15: 1,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 2,  # 'л'
+        14: 2,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 1,  # 'п'
+        7: 3,  # 'р'
+        8: 1,  # 'с'
+        5: 2,  # 'т'
+        19: 3,  # 'у'
+        29: 0,  # 'ф'
+        25: 1,  # 'х'
+        22: 0,  # 'ц'
+        21: 1,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    22: {  # 'ц'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 2,  # 'в'
+        20: 1,  # 'г'
+        11: 1,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 1,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 2,  # 'к'
+        10: 1,  # 'л'
+        14: 1,  # 'м'
+        6: 1,  # 'н'
+        4: 2,  # 'о'
+        13: 1,  # 'п'
+        7: 1,  # 'р'
+        8: 1,  # 'с'
+        5: 1,  # 'т'
+        19: 2,  # 'у'
+        29: 1,  # 'ф'
+        25: 1,  # 'х'
+        22: 1,  # 'ц'
+        21: 1,  # 'ч'
+        27: 1,  # 'ш'
+        24: 1,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 0,  # 'ю'
+        16: 2,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    21: {  # 'ч'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 1,  # 'б'
+        9: 3,  # 'в'
+        20: 1,  # 'г'
+        11: 0,  # 'д'
+        3: 3,  # 'е'
+        23: 1,  # 'ж'
+        15: 0,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 3,  # 'к'
+        10: 2,  # 'л'
+        14: 2,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 2,  # 'р'
+        8: 0,  # 'с'
+        5: 2,  # 'т'
+        19: 3,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 1,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    27: {  # 'ш'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 0,  # 'б'
+        9: 2,  # 'в'
+        20: 0,  # 'г'
+        11: 1,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 3,  # 'к'
+        10: 2,  # 'л'
+        14: 1,  # 'м'
+        6: 3,  # 'н'
+        4: 2,  # 'о'
+        13: 2,  # 'п'
+        7: 1,  # 'р'
+        8: 0,  # 'с'
+        5: 1,  # 'т'
+        19: 2,  # 'у'
+        29: 1,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 1,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 2,  # 'ъ'
+        52: 1,  # 'ь'
+        42: 1,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    24: {  # 'щ'
+        63: 1,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 3,  # 'а'
+        18: 0,  # 'б'
+        9: 1,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 3,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 3,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 2,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 1,  # 'р'
+        8: 0,  # 'с'
+        5: 2,  # 'т'
+        19: 3,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 1,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 2,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    17: {  # 'ъ'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 1,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 3,  # 'г'
+        11: 3,  # 'д'
+        3: 2,  # 'е'
+        23: 3,  # 'ж'
+        15: 3,  # 'з'
+        2: 1,  # 'и'
+        26: 2,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 3,  # 'м'
+        6: 3,  # 'н'
+        4: 3,  # 'о'
+        13: 3,  # 'п'
+        7: 3,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 1,  # 'у'
+        29: 1,  # 'ф'
+        25: 2,  # 'х'
+        22: 2,  # 'ц'
+        21: 3,  # 'ч'
+        27: 2,  # 'ш'
+        24: 3,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 2,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    52: {  # 'ь'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 0,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 1,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 0,  # 'и'
+        26: 0,  # 'й'
+        12: 1,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 1,  # 'н'
+        4: 3,  # 'о'
+        13: 0,  # 'п'
+        7: 0,  # 'р'
+        8: 0,  # 'с'
+        5: 1,  # 'т'
+        19: 0,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 1,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 1,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    42: {  # 'ю'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 1,  # 'а'
+        18: 2,  # 'б'
+        9: 1,  # 'в'
+        20: 2,  # 'г'
+        11: 2,  # 'д'
+        3: 1,  # 'е'
+        23: 2,  # 'ж'
+        15: 2,  # 'з'
+        2: 1,  # 'и'
+        26: 1,  # 'й'
+        12: 2,  # 'к'
+        10: 2,  # 'л'
+        14: 2,  # 'м'
+        6: 2,  # 'н'
+        4: 1,  # 'о'
+        13: 1,  # 'п'
+        7: 2,  # 'р'
+        8: 2,  # 'с'
+        5: 2,  # 'т'
+        19: 1,  # 'у'
+        29: 1,  # 'ф'
+        25: 1,  # 'х'
+        22: 2,  # 'ц'
+        21: 3,  # 'ч'
+        27: 1,  # 'ш'
+        24: 1,  # 'щ'
+        17: 1,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    16: {  # 'я'
+        63: 0,  # 'e'
+        45: 1,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 0,  # 'а'
+        18: 3,  # 'б'
+        9: 3,  # 'в'
+        20: 2,  # 'г'
+        11: 3,  # 'д'
+        3: 2,  # 'е'
+        23: 1,  # 'ж'
+        15: 2,  # 'з'
+        2: 1,  # 'и'
+        26: 2,  # 'й'
+        12: 3,  # 'к'
+        10: 3,  # 'л'
+        14: 3,  # 'м'
+        6: 3,  # 'н'
+        4: 1,  # 'о'
+        13: 2,  # 'п'
+        7: 2,  # 'р'
+        8: 3,  # 'с'
+        5: 3,  # 'т'
+        19: 1,  # 'у'
+        29: 1,  # 'ф'
+        25: 3,  # 'х'
+        22: 2,  # 'ц'
+        21: 1,  # 'ч'
+        27: 1,  # 'ш'
+        24: 2,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 1,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    58: {  # 'є'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 0,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 0,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 0,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 0,  # 'о'
+        13: 0,  # 'п'
+        7: 0,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 0,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+    62: {  # '№'
+        63: 0,  # 'e'
+        45: 0,  # '\xad'
+        31: 0,  # 'А'
+        32: 0,  # 'Б'
+        35: 0,  # 'В'
+        43: 0,  # 'Г'
+        37: 0,  # 'Д'
+        44: 0,  # 'Е'
+        55: 0,  # 'Ж'
+        47: 0,  # 'З'
+        40: 0,  # 'И'
+        59: 0,  # 'Й'
+        33: 0,  # 'К'
+        46: 0,  # 'Л'
+        38: 0,  # 'М'
+        36: 0,  # 'Н'
+        41: 0,  # 'О'
+        30: 0,  # 'П'
+        39: 0,  # 'Р'
+        28: 0,  # 'С'
+        34: 0,  # 'Т'
+        51: 0,  # 'У'
+        48: 0,  # 'Ф'
+        49: 0,  # 'Х'
+        53: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        54: 0,  # 'Ш'
+        57: 0,  # 'Щ'
+        61: 0,  # 'Ъ'
+        60: 0,  # 'Ю'
+        56: 0,  # 'Я'
+        1: 0,  # 'а'
+        18: 0,  # 'б'
+        9: 0,  # 'в'
+        20: 0,  # 'г'
+        11: 0,  # 'д'
+        3: 0,  # 'е'
+        23: 0,  # 'ж'
+        15: 0,  # 'з'
+        2: 0,  # 'и'
+        26: 0,  # 'й'
+        12: 0,  # 'к'
+        10: 0,  # 'л'
+        14: 0,  # 'м'
+        6: 0,  # 'н'
+        4: 0,  # 'о'
+        13: 0,  # 'п'
+        7: 0,  # 'р'
+        8: 0,  # 'с'
+        5: 0,  # 'т'
+        19: 0,  # 'у'
+        29: 0,  # 'ф'
+        25: 0,  # 'х'
+        22: 0,  # 'ц'
+        21: 0,  # 'ч'
+        27: 0,  # 'ш'
+        24: 0,  # 'щ'
+        17: 0,  # 'ъ'
+        52: 0,  # 'ь'
+        42: 0,  # 'ю'
+        16: 0,  # 'я'
+        58: 0,  # 'є'
+        62: 0,  # '№'
+    },
+}
+
+# 255: Undefined characters that did not exist in training text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+# 251: Control characters
+
+# Character Mapping Table(s):
+ISO_8859_5_BULGARIAN_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 77,  # 'A'
+     66: 90,  # 'B'
+     67: 99,  # 'C'
+     68: 100,  # 'D'
+     69: 72,  # 'E'
+     70: 109,  # 'F'
+     71: 107,  # 'G'
+     72: 101,  # 'H'
+     73: 79,  # 'I'
+     74: 185,  # 'J'
+     75: 81,  # 'K'
+     76: 102,  # 'L'
+     77: 76,  # 'M'
+     78: 94,  # 'N'
+     79: 82,  # 'O'
+     80: 110,  # 'P'
+     81: 186,  # 'Q'
+     82: 108,  # 'R'
+     83: 91,  # 'S'
+     84: 74,  # 'T'
+     85: 119,  # 'U'
+     86: 84,  # 'V'
+     87: 96,  # 'W'
+     88: 111,  # 'X'
+     89: 187,  # 'Y'
+     90: 115,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 65,  # 'a'
+     98: 69,  # 'b'
+     99: 70,  # 'c'
+     100: 66,  # 'd'
+     101: 63,  # 'e'
+     102: 68,  # 'f'
+     103: 112,  # 'g'
+     104: 103,  # 'h'
+     105: 92,  # 'i'
+     106: 194,  # 'j'
+     107: 104,  # 'k'
+     108: 95,  # 'l'
+     109: 86,  # 'm'
+     110: 87,  # 'n'
+     111: 71,  # 'o'
+     112: 116,  # 'p'
+     113: 195,  # 'q'
+     114: 85,  # 'r'
+     115: 93,  # 's'
+     116: 97,  # 't'
+     117: 113,  # 'u'
+     118: 196,  # 'v'
+     119: 197,  # 'w'
+     120: 198,  # 'x'
+     121: 199,  # 'y'
+     122: 200,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 194,  # '\x80'
+     129: 195,  # '\x81'
+     130: 196,  # '\x82'
+     131: 197,  # '\x83'
+     132: 198,  # '\x84'
+     133: 199,  # '\x85'
+     134: 200,  # '\x86'
+     135: 201,  # '\x87'
+     136: 202,  # '\x88'
+     137: 203,  # '\x89'
+     138: 204,  # '\x8a'
+     139: 205,  # '\x8b'
+     140: 206,  # '\x8c'
+     141: 207,  # '\x8d'
+     142: 208,  # '\x8e'
+     143: 209,  # '\x8f'
+     144: 210,  # '\x90'
+     145: 211,  # '\x91'
+     146: 212,  # '\x92'
+     147: 213,  # '\x93'
+     148: 214,  # '\x94'
+     149: 215,  # '\x95'
+     150: 216,  # '\x96'
+     151: 217,  # '\x97'
+     152: 218,  # '\x98'
+     153: 219,  # '\x99'
+     154: 220,  # '\x9a'
+     155: 221,  # '\x9b'
+     156: 222,  # '\x9c'
+     157: 223,  # '\x9d'
+     158: 224,  # '\x9e'
+     159: 225,  # '\x9f'
+     160: 81,  # '\xa0'
+     161: 226,  # 'Ё'
+     162: 227,  # 'Ђ'
+     163: 228,  # 'Ѓ'
+     164: 229,  # 'Є'
+     165: 230,  # 'Ѕ'
+     166: 105,  # 'І'
+     167: 231,  # 'Ї'
+     168: 232,  # 'Ј'
+     169: 233,  # 'Љ'
+     170: 234,  # 'Њ'
+     171: 235,  # 'Ћ'
+     172: 236,  # 'Ќ'
+     173: 45,  # '\xad'
+     174: 237,  # 'Ў'
+     175: 238,  # 'Џ'
+     176: 31,  # 'А'
+     177: 32,  # 'Б'
+     178: 35,  # 'В'
+     179: 43,  # 'Г'
+     180: 37,  # 'Д'
+     181: 44,  # 'Е'
+     182: 55,  # 'Ж'
+     183: 47,  # 'З'
+     184: 40,  # 'И'
+     185: 59,  # 'Й'
+     186: 33,  # 'К'
+     187: 46,  # 'Л'
+     188: 38,  # 'М'
+     189: 36,  # 'Н'
+     190: 41,  # 'О'
+     191: 30,  # 'П'
+     192: 39,  # 'Р'
+     193: 28,  # 'С'
+     194: 34,  # 'Т'
+     195: 51,  # 'У'
+     196: 48,  # 'Ф'
+     197: 49,  # 'Х'
+     198: 53,  # 'Ц'
+     199: 50,  # 'Ч'
+     200: 54,  # 'Ш'
+     201: 57,  # 'Щ'
+     202: 61,  # 'Ъ'
+     203: 239,  # 'Ы'
+     204: 67,  # 'Ь'
+     205: 240,  # 'Э'
+     206: 60,  # 'Ю'
+     207: 56,  # 'Я'
+     208: 1,  # 'а'
+     209: 18,  # 'б'
+     210: 9,  # 'в'
+     211: 20,  # 'г'
+     212: 11,  # 'д'
+     213: 3,  # 'е'
+     214: 23,  # 'ж'
+     215: 15,  # 'з'
+     216: 2,  # 'и'
+     217: 26,  # 'й'
+     218: 12,  # 'к'
+     219: 10,  # 'л'
+     220: 14,  # 'м'
+     221: 6,  # 'н'
+     222: 4,  # 'о'
+     223: 13,  # 'п'
+     224: 7,  # 'р'
+     225: 8,  # 'с'
+     226: 5,  # 'т'
+     227: 19,  # 'у'
+     228: 29,  # 'ф'
+     229: 25,  # 'х'
+     230: 22,  # 'ц'
+     231: 21,  # 'ч'
+     232: 27,  # 'ш'
+     233: 24,  # 'щ'
+     234: 17,  # 'ъ'
+     235: 75,  # 'ы'
+     236: 52,  # 'ь'
+     237: 241,  # 'э'
+     238: 42,  # 'ю'
+     239: 16,  # 'я'
+     240: 62,  # '№'
+     241: 242,  # 'ё'
+     242: 243,  # 'ђ'
+     243: 244,  # 'ѓ'
+     244: 58,  # 'є'
+     245: 245,  # 'ѕ'
+     246: 98,  # 'і'
+     247: 246,  # 'ї'
+     248: 247,  # 'ј'
+     249: 248,  # 'љ'
+     250: 249,  # 'њ'
+     251: 250,  # 'ћ'
+     252: 251,  # 'ќ'
+     253: 91,  # '§'
+     254: 252,  # 'ў'
+     255: 253,  # 'џ'
+}
+
+ISO_8859_5_BULGARIAN_MODEL = SingleByteCharSetModel(charset_name='ISO-8859-5',
+                                                    language='Bulgarian',
+                                                    char_to_order_map=ISO_8859_5_BULGARIAN_CHAR_TO_ORDER,
+                                                    language_model=BULGARIAN_LANG_MODEL,
+                                                    typical_positive_ratio=0.969392,
+                                                    keep_ascii_letters=False,
+                                                    alphabet='АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЬЮЯабвгдежзийклмнопрстуфхцчшщъьюя')
+
+WINDOWS_1251_BULGARIAN_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 77,  # 'A'
+     66: 90,  # 'B'
+     67: 99,  # 'C'
+     68: 100,  # 'D'
+     69: 72,  # 'E'
+     70: 109,  # 'F'
+     71: 107,  # 'G'
+     72: 101,  # 'H'
+     73: 79,  # 'I'
+     74: 185,  # 'J'
+     75: 81,  # 'K'
+     76: 102,  # 'L'
+     77: 76,  # 'M'
+     78: 94,  # 'N'
+     79: 82,  # 'O'
+     80: 110,  # 'P'
+     81: 186,  # 'Q'
+     82: 108,  # 'R'
+     83: 91,  # 'S'
+     84: 74,  # 'T'
+     85: 119,  # 'U'
+     86: 84,  # 'V'
+     87: 96,  # 'W'
+     88: 111,  # 'X'
+     89: 187,  # 'Y'
+     90: 115,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 65,  # 'a'
+     98: 69,  # 'b'
+     99: 70,  # 'c'
+     100: 66,  # 'd'
+     101: 63,  # 'e'
+     102: 68,  # 'f'
+     103: 112,  # 'g'
+     104: 103,  # 'h'
+     105: 92,  # 'i'
+     106: 194,  # 'j'
+     107: 104,  # 'k'
+     108: 95,  # 'l'
+     109: 86,  # 'm'
+     110: 87,  # 'n'
+     111: 71,  # 'o'
+     112: 116,  # 'p'
+     113: 195,  # 'q'
+     114: 85,  # 'r'
+     115: 93,  # 's'
+     116: 97,  # 't'
+     117: 113,  # 'u'
+     118: 196,  # 'v'
+     119: 197,  # 'w'
+     120: 198,  # 'x'
+     121: 199,  # 'y'
+     122: 200,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 206,  # 'Ђ'
+     129: 207,  # 'Ѓ'
+     130: 208,  # '‚'
+     131: 209,  # 'ѓ'
+     132: 210,  # '„'
+     133: 211,  # '…'
+     134: 212,  # '†'
+     135: 213,  # '‡'
+     136: 120,  # '€'
+     137: 214,  # '‰'
+     138: 215,  # 'Љ'
+     139: 216,  # '‹'
+     140: 217,  # 'Њ'
+     141: 218,  # 'Ќ'
+     142: 219,  # 'Ћ'
+     143: 220,  # 'Џ'
+     144: 221,  # 'ђ'
+     145: 78,  # '‘'
+     146: 64,  # '’'
+     147: 83,  # '“'
+     148: 121,  # '”'
+     149: 98,  # '•'
+     150: 117,  # '–'
+     151: 105,  # '—'
+     152: 222,  # None
+     153: 223,  # '™'
+     154: 224,  # 'љ'
+     155: 225,  # '›'
+     156: 226,  # 'њ'
+     157: 227,  # 'ќ'
+     158: 228,  # 'ћ'
+     159: 229,  # 'џ'
+     160: 88,  # '\xa0'
+     161: 230,  # 'Ў'
+     162: 231,  # 'ў'
+     163: 232,  # 'Ј'
+     164: 233,  # '¤'
+     165: 122,  # 'Ґ'
+     166: 89,  # '¦'
+     167: 106,  # '§'
+     168: 234,  # 'Ё'
+     169: 235,  # '©'
+     170: 236,  # 'Є'
+     171: 237,  # '«'
+     172: 238,  # '¬'
+     173: 45,  # '\xad'
+     174: 239,  # '®'
+     175: 240,  # 'Ї'
+     176: 73,  # '°'
+     177: 80,  # '±'
+     178: 118,  # 'І'
+     179: 114,  # 'і'
+     180: 241,  # 'ґ'
+     181: 242,  # 'µ'
+     182: 243,  # '¶'
+     183: 244,  # '·'
+     184: 245,  # 'ё'
+     185: 62,  # '№'
+     186: 58,  # 'є'
+     187: 246,  # '»'
+     188: 247,  # 'ј'
+     189: 248,  # 'Ѕ'
+     190: 249,  # 'ѕ'
+     191: 250,  # 'ї'
+     192: 31,  # 'А'
+     193: 32,  # 'Б'
+     194: 35,  # 'В'
+     195: 43,  # 'Г'
+     196: 37,  # 'Д'
+     197: 44,  # 'Е'
+     198: 55,  # 'Ж'
+     199: 47,  # 'З'
+     200: 40,  # 'И'
+     201: 59,  # 'Й'
+     202: 33,  # 'К'
+     203: 46,  # 'Л'
+     204: 38,  # 'М'
+     205: 36,  # 'Н'
+     206: 41,  # 'О'
+     207: 30,  # 'П'
+     208: 39,  # 'Р'
+     209: 28,  # 'С'
+     210: 34,  # 'Т'
+     211: 51,  # 'У'
+     212: 48,  # 'Ф'
+     213: 49,  # 'Х'
+     214: 53,  # 'Ц'
+     215: 50,  # 'Ч'
+     216: 54,  # 'Ш'
+     217: 57,  # 'Щ'
+     218: 61,  # 'Ъ'
+     219: 251,  # 'Ы'
+     220: 67,  # 'Ь'
+     221: 252,  # 'Э'
+     222: 60,  # 'Ю'
+     223: 56,  # 'Я'
+     224: 1,  # 'а'
+     225: 18,  # 'б'
+     226: 9,  # 'в'
+     227: 20,  # 'г'
+     228: 11,  # 'д'
+     229: 3,  # 'е'
+     230: 23,  # 'ж'
+     231: 15,  # 'з'
+     232: 2,  # 'и'
+     233: 26,  # 'й'
+     234: 12,  # 'к'
+     235: 10,  # 'л'
+     236: 14,  # 'м'
+     237: 6,  # 'н'
+     238: 4,  # 'о'
+     239: 13,  # 'п'
+     240: 7,  # 'р'
+     241: 8,  # 'с'
+     242: 5,  # 'т'
+     243: 19,  # 'у'
+     244: 29,  # 'ф'
+     245: 25,  # 'х'
+     246: 22,  # 'ц'
+     247: 21,  # 'ч'
+     248: 27,  # 'ш'
+     249: 24,  # 'щ'
+     250: 17,  # 'ъ'
+     251: 75,  # 'ы'
+     252: 52,  # 'ь'
+     253: 253,  # 'э'
+     254: 42,  # 'ю'
+     255: 16,  # 'я'
+}
+
+WINDOWS_1251_BULGARIAN_MODEL = SingleByteCharSetModel(charset_name='windows-1251',
+                                                      language='Bulgarian',
+                                                      char_to_order_map=WINDOWS_1251_BULGARIAN_CHAR_TO_ORDER,
+                                                      language_model=BULGARIAN_LANG_MODEL,
+                                                      typical_positive_ratio=0.969392,
+                                                      keep_ascii_letters=False,
+                                                      alphabet='АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЬЮЯабвгдежзийклмнопрстуфхцчшщъьюя')
+
diff --git a/openpype/vendor/python/python_2/chardet/langgreekmodel.py b/openpype/vendor/python/python_2/chardet/langgreekmodel.py
new file mode 100644
index 0000000000..02b94de655
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/langgreekmodel.py
@@ -0,0 +1,4398 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from chardet.sbcharsetprober import SingleByteCharSetModel
+
+
+# 3: Positive
+# 2: Likely
+# 1: Unlikely
+# 0: Negative
+
+GREEK_LANG_MODEL = {
+    60: {  # 'e'
+        60: 2,  # 'e'
+        55: 1,  # 'o'
+        58: 2,  # 't'
+        36: 1,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 1,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    55: {  # 'o'
+        60: 0,  # 'e'
+        55: 2,  # 'o'
+        58: 2,  # 't'
+        36: 1,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 1,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 1,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    58: {  # 't'
+        60: 2,  # 'e'
+        55: 1,  # 'o'
+        58: 1,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 1,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    36: {  # '·'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    61: {  # 'Ά'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 1,  # 'γ'
+        21: 2,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 1,  # 'π'
+        8: 2,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    46: {  # 'Έ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 2,  # 'β'
+        20: 2,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 2,  # 'κ'
+        16: 2,  # 'λ'
+        10: 0,  # 'μ'
+        6: 3,  # 'ν'
+        30: 2,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 2,  # 'π'
+        8: 2,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 1,  # 'σ'
+        2: 2,  # 'τ'
+        12: 0,  # 'υ'
+        28: 2,  # 'φ'
+        23: 3,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    54: {  # 'Ό'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 2,  # 'μ'
+        6: 2,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 2,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 2,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 2,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    31: {  # 'Α'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 2,  # 'Β'
+        43: 2,  # 'Γ'
+        41: 1,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 2,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 2,  # 'Κ'
+        53: 2,  # 'Λ'
+        38: 2,  # 'Μ'
+        49: 2,  # 'Ν'
+        59: 1,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 2,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 2,  # 'Σ'
+        33: 2,  # 'Τ'
+        45: 2,  # 'Υ'
+        56: 2,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 2,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 1,  # 'θ'
+        5: 0,  # 'ι'
+        11: 2,  # 'κ'
+        16: 3,  # 'λ'
+        10: 2,  # 'μ'
+        6: 3,  # 'ν'
+        30: 2,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 2,  # 'ς'
+        7: 2,  # 'σ'
+        2: 0,  # 'τ'
+        12: 3,  # 'υ'
+        28: 2,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    51: {  # 'Β'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 1,  # 'Ε'
+        40: 1,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 1,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 1,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 2,  # 'έ'
+        22: 2,  # 'ή'
+        15: 0,  # 'ί'
+        1: 2,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 2,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 2,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 0,  # 'π'
+        8: 2,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    43: {  # 'Γ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 1,  # 'Α'
+        51: 0,  # 'Β'
+        43: 2,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 1,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 1,  # 'Κ'
+        53: 1,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 1,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 2,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 1,  # 'Χ'
+        57: 2,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 2,  # 'ί'
+        1: 2,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 2,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 3,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 0,  # 'μ'
+        6: 2,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 0,  # 'π'
+        8: 2,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    41: {  # 'Δ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 2,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 2,  # 'ή'
+        15: 2,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 2,  # 'η'
+        25: 0,  # 'θ'
+        5: 3,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 0,  # 'π'
+        8: 2,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 2,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 1,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 2,  # 'ώ'
+    },
+    34: {  # 'Ε'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 0,  # 'Β'
+        43: 2,  # 'Γ'
+        41: 2,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 2,  # 'Κ'
+        53: 2,  # 'Λ'
+        38: 2,  # 'Μ'
+        49: 2,  # 'Ν'
+        59: 1,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 2,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 2,  # 'Σ'
+        33: 2,  # 'Τ'
+        45: 2,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 2,  # 'Χ'
+        57: 2,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 3,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 3,  # 'γ'
+        21: 2,  # 'δ'
+        3: 1,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 1,  # 'θ'
+        5: 2,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 2,  # 'μ'
+        6: 3,  # 'ν'
+        30: 2,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 3,  # 'π'
+        8: 2,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 2,  # 'σ'
+        2: 2,  # 'τ'
+        12: 2,  # 'υ'
+        28: 2,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 1,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    40: {  # 'Η'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 1,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 2,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 2,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 2,  # 'Μ'
+        49: 2,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 2,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 2,  # 'Σ'
+        33: 2,  # 'Τ'
+        45: 1,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 0,  # 'μ'
+        6: 1,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 1,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    52: {  # 'Θ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 1,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 1,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 2,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 2,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 2,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    47: {  # 'Ι'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 1,  # 'Β'
+        43: 1,  # 'Γ'
+        41: 2,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 2,  # 'Κ'
+        53: 2,  # 'Λ'
+        38: 2,  # 'Μ'
+        49: 2,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 2,  # 'Σ'
+        33: 2,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 2,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 2,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 2,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 2,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 1,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 2,  # 'σ'
+        2: 1,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 1,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    44: {  # 'Κ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 1,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 1,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 1,  # 'Τ'
+        45: 2,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 1,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 2,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 2,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 0,  # 'π'
+        8: 2,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 2,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 2,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 2,  # 'ώ'
+    },
+    53: {  # 'Λ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 2,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 2,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 2,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 2,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 2,  # 'έ'
+        22: 0,  # 'ή'
+        15: 2,  # 'ί'
+        1: 2,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 2,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 1,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 2,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 2,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    38: {  # 'Μ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 2,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 2,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 2,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 2,  # 'έ'
+        22: 2,  # 'ή'
+        15: 2,  # 'ί'
+        1: 2,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 2,  # 'η'
+        25: 0,  # 'θ'
+        5: 3,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 3,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 2,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 2,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    49: {  # 'Ν'
+        60: 2,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 2,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 2,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 2,  # 'έ'
+        22: 0,  # 'ή'
+        15: 2,  # 'ί'
+        1: 2,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 1,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 1,  # 'ω'
+        19: 2,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    59: {  # 'Ξ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 1,  # 'Ε'
+        40: 1,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 1,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 2,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 2,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 2,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    39: {  # 'Ο'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 1,  # 'Β'
+        43: 2,  # 'Γ'
+        41: 2,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 1,  # 'Η'
+        52: 2,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 2,  # 'Κ'
+        53: 2,  # 'Λ'
+        38: 2,  # 'Μ'
+        49: 2,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 2,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 2,  # 'Σ'
+        33: 2,  # 'Τ'
+        45: 2,  # 'Υ'
+        56: 2,  # 'Φ'
+        50: 2,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 2,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 3,  # 'ι'
+        11: 2,  # 'κ'
+        16: 2,  # 'λ'
+        10: 2,  # 'μ'
+        6: 2,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 2,  # 'π'
+        8: 2,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 2,  # 'τ'
+        12: 2,  # 'υ'
+        28: 1,  # 'φ'
+        23: 1,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    35: {  # 'Π'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 2,  # 'Λ'
+        38: 1,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 1,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 1,  # 'Χ'
+        57: 2,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 1,  # 'έ'
+        22: 1,  # 'ή'
+        15: 2,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 2,  # 'η'
+        25: 0,  # 'θ'
+        5: 2,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 0,  # 'μ'
+        6: 2,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 3,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 2,  # 'υ'
+        28: 0,  # 'φ'
+        23: 2,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 2,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    48: {  # 'Ρ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 0,  # 'Β'
+        43: 1,  # 'Γ'
+        41: 1,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 2,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 1,  # 'Τ'
+        45: 1,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 1,  # 'Χ'
+        57: 1,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 2,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 1,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 3,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 0,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    37: {  # 'Σ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 1,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 2,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 2,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 2,  # 'Σ'
+        33: 2,  # 'Τ'
+        45: 2,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 2,  # 'Χ'
+        57: 2,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 2,  # 'ή'
+        15: 2,  # 'ί'
+        1: 2,  # 'α'
+        29: 2,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 0,  # 'θ'
+        5: 2,  # 'ι'
+        11: 2,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 2,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 0,  # 'φ'
+        23: 2,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 0,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 2,  # 'ώ'
+    },
+    33: {  # 'Τ'
+        60: 0,  # 'e'
+        55: 1,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 2,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 2,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 1,  # 'Τ'
+        45: 1,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 2,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 2,  # 'έ'
+        22: 0,  # 'ή'
+        15: 2,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 2,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 2,  # 'η'
+        25: 0,  # 'θ'
+        5: 2,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 2,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 2,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 2,  # 'σ'
+        2: 0,  # 'τ'
+        12: 2,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 2,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    45: {  # 'Υ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 2,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 1,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 2,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 1,  # 'Λ'
+        38: 2,  # 'Μ'
+        49: 2,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 2,  # 'Π'
+        48: 1,  # 'Ρ'
+        37: 2,  # 'Σ'
+        33: 2,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 1,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 3,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    56: {  # 'Φ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 1,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 1,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 2,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 2,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 2,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 2,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 2,  # 'τ'
+        12: 2,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 1,  # 'ύ'
+        27: 1,  # 'ώ'
+    },
+    50: {  # 'Χ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 1,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 2,  # 'Ε'
+        40: 2,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 2,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 1,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 1,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 1,  # 'Χ'
+        57: 1,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 2,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 2,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 0,  # 'π'
+        8: 3,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 2,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    57: {  # 'Ω'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 1,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 1,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 2,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 2,  # 'Ρ'
+        37: 2,  # 'Σ'
+        33: 2,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 0,  # 'π'
+        8: 2,  # 'ρ'
+        14: 2,  # 'ς'
+        7: 2,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 1,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    17: {  # 'ά'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 2,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 3,  # 'β'
+        20: 3,  # 'γ'
+        21: 3,  # 'δ'
+        3: 3,  # 'ε'
+        32: 3,  # 'ζ'
+        13: 0,  # 'η'
+        25: 3,  # 'θ'
+        5: 2,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 3,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 3,  # 'φ'
+        23: 3,  # 'χ'
+        42: 3,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    18: {  # 'έ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 3,  # 'α'
+        29: 2,  # 'β'
+        20: 3,  # 'γ'
+        21: 2,  # 'δ'
+        3: 3,  # 'ε'
+        32: 2,  # 'ζ'
+        13: 0,  # 'η'
+        25: 3,  # 'θ'
+        5: 0,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 3,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 3,  # 'φ'
+        23: 3,  # 'χ'
+        42: 3,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    22: {  # 'ή'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 1,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 3,  # 'γ'
+        21: 3,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 3,  # 'θ'
+        5: 0,  # 'ι'
+        11: 3,  # 'κ'
+        16: 2,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 2,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 2,  # 'φ'
+        23: 3,  # 'χ'
+        42: 2,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    15: {  # 'ί'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 3,  # 'α'
+        29: 2,  # 'β'
+        20: 3,  # 'γ'
+        21: 3,  # 'δ'
+        3: 3,  # 'ε'
+        32: 3,  # 'ζ'
+        13: 3,  # 'η'
+        25: 3,  # 'θ'
+        5: 0,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 3,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 1,  # 'φ'
+        23: 3,  # 'χ'
+        42: 2,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    1: {  # 'α'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 2,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 2,  # 'έ'
+        22: 0,  # 'ή'
+        15: 3,  # 'ί'
+        1: 0,  # 'α'
+        29: 3,  # 'β'
+        20: 3,  # 'γ'
+        21: 3,  # 'δ'
+        3: 2,  # 'ε'
+        32: 3,  # 'ζ'
+        13: 1,  # 'η'
+        25: 3,  # 'θ'
+        5: 3,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 3,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 3,  # 'φ'
+        23: 3,  # 'χ'
+        42: 2,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 2,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    29: {  # 'β'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 2,  # 'έ'
+        22: 3,  # 'ή'
+        15: 2,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 2,  # 'γ'
+        21: 2,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 2,  # 'η'
+        25: 0,  # 'θ'
+        5: 3,  # 'ι'
+        11: 0,  # 'κ'
+        16: 3,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 3,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 2,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 2,  # 'ώ'
+    },
+    20: {  # 'γ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 3,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 0,  # 'θ'
+        5: 3,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 3,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 3,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 2,  # 'υ'
+        28: 0,  # 'φ'
+        23: 3,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    21: {  # 'δ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 0,  # 'θ'
+        5: 3,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 3,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 3,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    3: {  # 'ε'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 2,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 3,  # 'ί'
+        1: 2,  # 'α'
+        29: 3,  # 'β'
+        20: 3,  # 'γ'
+        21: 3,  # 'δ'
+        3: 2,  # 'ε'
+        32: 2,  # 'ζ'
+        13: 0,  # 'η'
+        25: 3,  # 'θ'
+        5: 3,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 3,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 3,  # 'φ'
+        23: 3,  # 'χ'
+        42: 2,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 2,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 2,  # 'ώ'
+    },
+    32: {  # 'ζ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 2,  # 'έ'
+        22: 2,  # 'ή'
+        15: 2,  # 'ί'
+        1: 2,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 0,  # 'θ'
+        5: 2,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 1,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 2,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 2,  # 'ώ'
+    },
+    13: {  # 'η'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 2,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 3,  # 'γ'
+        21: 2,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 3,  # 'θ'
+        5: 0,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 2,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 2,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 2,  # 'φ'
+        23: 3,  # 'χ'
+        42: 2,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    25: {  # 'θ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 2,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 0,  # 'θ'
+        5: 3,  # 'ι'
+        11: 0,  # 'κ'
+        16: 1,  # 'λ'
+        10: 3,  # 'μ'
+        6: 2,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 3,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 3,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    5: {  # 'ι'
+        60: 0,  # 'e'
+        55: 1,  # 'o'
+        58: 0,  # 't'
+        36: 2,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 1,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 0,  # 'ί'
+        1: 3,  # 'α'
+        29: 3,  # 'β'
+        20: 3,  # 'γ'
+        21: 3,  # 'δ'
+        3: 3,  # 'ε'
+        32: 2,  # 'ζ'
+        13: 3,  # 'η'
+        25: 3,  # 'θ'
+        5: 0,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 3,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 2,  # 'φ'
+        23: 3,  # 'χ'
+        42: 2,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    11: {  # 'κ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 3,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 2,  # 'θ'
+        5: 3,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 2,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 2,  # 'π'
+        8: 3,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 2,  # 'φ'
+        23: 2,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    16: {  # 'λ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 1,  # 'β'
+        20: 2,  # 'γ'
+        21: 1,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 2,  # 'θ'
+        5: 3,  # 'ι'
+        11: 2,  # 'κ'
+        16: 3,  # 'λ'
+        10: 2,  # 'μ'
+        6: 2,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 3,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 2,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    10: {  # 'μ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 1,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 3,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 0,  # 'θ'
+        5: 3,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 3,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 2,  # 'υ'
+        28: 3,  # 'φ'
+        23: 0,  # 'χ'
+        42: 2,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 2,  # 'ώ'
+    },
+    6: {  # 'ν'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 2,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 3,  # 'δ'
+        3: 3,  # 'ε'
+        32: 2,  # 'ζ'
+        13: 3,  # 'η'
+        25: 3,  # 'θ'
+        5: 3,  # 'ι'
+        11: 0,  # 'κ'
+        16: 1,  # 'λ'
+        10: 0,  # 'μ'
+        6: 2,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    30: {  # 'ξ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 2,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 0,  # 'θ'
+        5: 2,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 3,  # 'τ'
+        12: 2,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 2,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 1,  # 'ώ'
+    },
+    4: {  # 'ο'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 2,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 2,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 2,  # 'α'
+        29: 3,  # 'β'
+        20: 3,  # 'γ'
+        21: 3,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 3,  # 'θ'
+        5: 3,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 2,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 3,  # 'φ'
+        23: 3,  # 'χ'
+        42: 2,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 1,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 2,  # 'ώ'
+    },
+    9: {  # 'π'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 0,  # 'θ'
+        5: 3,  # 'ι'
+        11: 0,  # 'κ'
+        16: 3,  # 'λ'
+        10: 0,  # 'μ'
+        6: 2,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 3,  # 'ρ'
+        14: 2,  # 'ς'
+        7: 0,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 0,  # 'φ'
+        23: 2,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    8: {  # 'ρ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 2,  # 'β'
+        20: 3,  # 'γ'
+        21: 2,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 3,  # 'θ'
+        5: 3,  # 'ι'
+        11: 3,  # 'κ'
+        16: 1,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 2,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 2,  # 'π'
+        8: 2,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 2,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 3,  # 'φ'
+        23: 3,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    14: {  # 'ς'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 2,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 0,  # 'θ'
+        5: 0,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 0,  # 'τ'
+        12: 0,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    7: {  # 'σ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 2,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 3,  # 'β'
+        20: 0,  # 'γ'
+        21: 2,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 3,  # 'θ'
+        5: 3,  # 'ι'
+        11: 3,  # 'κ'
+        16: 2,  # 'λ'
+        10: 3,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 3,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 3,  # 'φ'
+        23: 3,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 2,  # 'ώ'
+    },
+    2: {  # 'τ'
+        60: 0,  # 'e'
+        55: 2,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 2,  # 'ζ'
+        13: 3,  # 'η'
+        25: 0,  # 'θ'
+        5: 3,  # 'ι'
+        11: 2,  # 'κ'
+        16: 2,  # 'λ'
+        10: 3,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 3,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 2,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    12: {  # 'υ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 2,  # 'έ'
+        22: 3,  # 'ή'
+        15: 2,  # 'ί'
+        1: 3,  # 'α'
+        29: 2,  # 'β'
+        20: 3,  # 'γ'
+        21: 2,  # 'δ'
+        3: 2,  # 'ε'
+        32: 2,  # 'ζ'
+        13: 2,  # 'η'
+        25: 3,  # 'θ'
+        5: 2,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 3,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 2,  # 'φ'
+        23: 3,  # 'χ'
+        42: 2,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 2,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 2,  # 'ώ'
+    },
+    28: {  # 'φ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 3,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 2,  # 'η'
+        25: 2,  # 'θ'
+        5: 3,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 0,  # 'μ'
+        6: 1,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 3,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 1,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 2,  # 'ύ'
+        27: 2,  # 'ώ'
+    },
+    23: {  # 'χ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 3,  # 'ά'
+        18: 2,  # 'έ'
+        22: 3,  # 'ή'
+        15: 3,  # 'ί'
+        1: 3,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 2,  # 'η'
+        25: 2,  # 'θ'
+        5: 3,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 2,  # 'μ'
+        6: 3,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 0,  # 'π'
+        8: 3,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 3,  # 'τ'
+        12: 3,  # 'υ'
+        28: 0,  # 'φ'
+        23: 2,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 3,  # 'ω'
+        19: 3,  # 'ό'
+        26: 3,  # 'ύ'
+        27: 3,  # 'ώ'
+    },
+    42: {  # 'ψ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 2,  # 'ά'
+        18: 2,  # 'έ'
+        22: 1,  # 'ή'
+        15: 2,  # 'ί'
+        1: 2,  # 'α'
+        29: 0,  # 'β'
+        20: 0,  # 'γ'
+        21: 0,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 3,  # 'η'
+        25: 0,  # 'θ'
+        5: 2,  # 'ι'
+        11: 0,  # 'κ'
+        16: 0,  # 'λ'
+        10: 0,  # 'μ'
+        6: 0,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 0,  # 'π'
+        8: 0,  # 'ρ'
+        14: 0,  # 'ς'
+        7: 0,  # 'σ'
+        2: 2,  # 'τ'
+        12: 1,  # 'υ'
+        28: 0,  # 'φ'
+        23: 0,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    24: {  # 'ω'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 1,  # 'ά'
+        18: 0,  # 'έ'
+        22: 2,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 2,  # 'β'
+        20: 3,  # 'γ'
+        21: 2,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 0,  # 'η'
+        25: 3,  # 'θ'
+        5: 2,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 0,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 2,  # 'φ'
+        23: 2,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    19: {  # 'ό'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 3,  # 'β'
+        20: 3,  # 'γ'
+        21: 3,  # 'δ'
+        3: 1,  # 'ε'
+        32: 2,  # 'ζ'
+        13: 2,  # 'η'
+        25: 2,  # 'θ'
+        5: 2,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 1,  # 'ξ'
+        4: 2,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 2,  # 'φ'
+        23: 3,  # 'χ'
+        42: 2,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    26: {  # 'ύ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 2,  # 'α'
+        29: 2,  # 'β'
+        20: 2,  # 'γ'
+        21: 1,  # 'δ'
+        3: 3,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 2,  # 'η'
+        25: 3,  # 'θ'
+        5: 0,  # 'ι'
+        11: 3,  # 'κ'
+        16: 3,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 2,  # 'ξ'
+        4: 3,  # 'ο'
+        9: 3,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 2,  # 'φ'
+        23: 2,  # 'χ'
+        42: 2,  # 'ψ'
+        24: 2,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+    27: {  # 'ώ'
+        60: 0,  # 'e'
+        55: 0,  # 'o'
+        58: 0,  # 't'
+        36: 0,  # '·'
+        61: 0,  # 'Ά'
+        46: 0,  # 'Έ'
+        54: 0,  # 'Ό'
+        31: 0,  # 'Α'
+        51: 0,  # 'Β'
+        43: 0,  # 'Γ'
+        41: 0,  # 'Δ'
+        34: 0,  # 'Ε'
+        40: 0,  # 'Η'
+        52: 0,  # 'Θ'
+        47: 0,  # 'Ι'
+        44: 0,  # 'Κ'
+        53: 0,  # 'Λ'
+        38: 0,  # 'Μ'
+        49: 0,  # 'Ν'
+        59: 0,  # 'Ξ'
+        39: 0,  # 'Ο'
+        35: 0,  # 'Π'
+        48: 0,  # 'Ρ'
+        37: 0,  # 'Σ'
+        33: 0,  # 'Τ'
+        45: 0,  # 'Υ'
+        56: 0,  # 'Φ'
+        50: 0,  # 'Χ'
+        57: 0,  # 'Ω'
+        17: 0,  # 'ά'
+        18: 0,  # 'έ'
+        22: 0,  # 'ή'
+        15: 0,  # 'ί'
+        1: 0,  # 'α'
+        29: 1,  # 'β'
+        20: 0,  # 'γ'
+        21: 3,  # 'δ'
+        3: 0,  # 'ε'
+        32: 0,  # 'ζ'
+        13: 1,  # 'η'
+        25: 2,  # 'θ'
+        5: 2,  # 'ι'
+        11: 0,  # 'κ'
+        16: 2,  # 'λ'
+        10: 3,  # 'μ'
+        6: 3,  # 'ν'
+        30: 1,  # 'ξ'
+        4: 0,  # 'ο'
+        9: 2,  # 'π'
+        8: 3,  # 'ρ'
+        14: 3,  # 'ς'
+        7: 3,  # 'σ'
+        2: 3,  # 'τ'
+        12: 0,  # 'υ'
+        28: 1,  # 'φ'
+        23: 1,  # 'χ'
+        42: 0,  # 'ψ'
+        24: 0,  # 'ω'
+        19: 0,  # 'ό'
+        26: 0,  # 'ύ'
+        27: 0,  # 'ώ'
+    },
+}
+
+# 255: Undefined characters that did not exist in training text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+# 251: Control characters
+
+# Character Mapping Table(s):
+WINDOWS_1253_GREEK_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 82,  # 'A'
+     66: 100,  # 'B'
+     67: 104,  # 'C'
+     68: 94,  # 'D'
+     69: 98,  # 'E'
+     70: 101,  # 'F'
+     71: 116,  # 'G'
+     72: 102,  # 'H'
+     73: 111,  # 'I'
+     74: 187,  # 'J'
+     75: 117,  # 'K'
+     76: 92,  # 'L'
+     77: 88,  # 'M'
+     78: 113,  # 'N'
+     79: 85,  # 'O'
+     80: 79,  # 'P'
+     81: 118,  # 'Q'
+     82: 105,  # 'R'
+     83: 83,  # 'S'
+     84: 67,  # 'T'
+     85: 114,  # 'U'
+     86: 119,  # 'V'
+     87: 95,  # 'W'
+     88: 99,  # 'X'
+     89: 109,  # 'Y'
+     90: 188,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 72,  # 'a'
+     98: 70,  # 'b'
+     99: 80,  # 'c'
+     100: 81,  # 'd'
+     101: 60,  # 'e'
+     102: 96,  # 'f'
+     103: 93,  # 'g'
+     104: 89,  # 'h'
+     105: 68,  # 'i'
+     106: 120,  # 'j'
+     107: 97,  # 'k'
+     108: 77,  # 'l'
+     109: 86,  # 'm'
+     110: 69,  # 'n'
+     111: 55,  # 'o'
+     112: 78,  # 'p'
+     113: 115,  # 'q'
+     114: 65,  # 'r'
+     115: 66,  # 's'
+     116: 58,  # 't'
+     117: 76,  # 'u'
+     118: 106,  # 'v'
+     119: 103,  # 'w'
+     120: 87,  # 'x'
+     121: 107,  # 'y'
+     122: 112,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 255,  # '€'
+     129: 255,  # None
+     130: 255,  # '‚'
+     131: 255,  # 'ƒ'
+     132: 255,  # '„'
+     133: 255,  # '…'
+     134: 255,  # '†'
+     135: 255,  # '‡'
+     136: 255,  # None
+     137: 255,  # '‰'
+     138: 255,  # None
+     139: 255,  # '‹'
+     140: 255,  # None
+     141: 255,  # None
+     142: 255,  # None
+     143: 255,  # None
+     144: 255,  # None
+     145: 255,  # '‘'
+     146: 255,  # '’'
+     147: 255,  # '“'
+     148: 255,  # '”'
+     149: 255,  # '•'
+     150: 255,  # '–'
+     151: 255,  # '—'
+     152: 255,  # None
+     153: 255,  # '™'
+     154: 255,  # None
+     155: 255,  # '›'
+     156: 255,  # None
+     157: 255,  # None
+     158: 255,  # None
+     159: 255,  # None
+     160: 253,  # '\xa0'
+     161: 233,  # '΅'
+     162: 61,  # 'Ά'
+     163: 253,  # '£'
+     164: 253,  # '¤'
+     165: 253,  # '¥'
+     166: 253,  # '¦'
+     167: 253,  # '§'
+     168: 253,  # '¨'
+     169: 253,  # '©'
+     170: 253,  # None
+     171: 253,  # '«'
+     172: 253,  # '¬'
+     173: 74,  # '\xad'
+     174: 253,  # '®'
+     175: 253,  # '―'
+     176: 253,  # '°'
+     177: 253,  # '±'
+     178: 253,  # '²'
+     179: 253,  # '³'
+     180: 247,  # '΄'
+     181: 253,  # 'µ'
+     182: 253,  # '¶'
+     183: 36,  # '·'
+     184: 46,  # 'Έ'
+     185: 71,  # 'Ή'
+     186: 73,  # 'Ί'
+     187: 253,  # '»'
+     188: 54,  # 'Ό'
+     189: 253,  # '½'
+     190: 108,  # 'Ύ'
+     191: 123,  # 'Ώ'
+     192: 110,  # 'ΐ'
+     193: 31,  # 'Α'
+     194: 51,  # 'Β'
+     195: 43,  # 'Γ'
+     196: 41,  # 'Δ'
+     197: 34,  # 'Ε'
+     198: 91,  # 'Ζ'
+     199: 40,  # 'Η'
+     200: 52,  # 'Θ'
+     201: 47,  # 'Ι'
+     202: 44,  # 'Κ'
+     203: 53,  # 'Λ'
+     204: 38,  # 'Μ'
+     205: 49,  # 'Ν'
+     206: 59,  # 'Ξ'
+     207: 39,  # 'Ο'
+     208: 35,  # 'Π'
+     209: 48,  # 'Ρ'
+     210: 250,  # None
+     211: 37,  # 'Σ'
+     212: 33,  # 'Τ'
+     213: 45,  # 'Υ'
+     214: 56,  # 'Φ'
+     215: 50,  # 'Χ'
+     216: 84,  # 'Ψ'
+     217: 57,  # 'Ω'
+     218: 120,  # 'Ϊ'
+     219: 121,  # 'Ϋ'
+     220: 17,  # 'ά'
+     221: 18,  # 'έ'
+     222: 22,  # 'ή'
+     223: 15,  # 'ί'
+     224: 124,  # 'ΰ'
+     225: 1,  # 'α'
+     226: 29,  # 'β'
+     227: 20,  # 'γ'
+     228: 21,  # 'δ'
+     229: 3,  # 'ε'
+     230: 32,  # 'ζ'
+     231: 13,  # 'η'
+     232: 25,  # 'θ'
+     233: 5,  # 'ι'
+     234: 11,  # 'κ'
+     235: 16,  # 'λ'
+     236: 10,  # 'μ'
+     237: 6,  # 'ν'
+     238: 30,  # 'ξ'
+     239: 4,  # 'ο'
+     240: 9,  # 'π'
+     241: 8,  # 'ρ'
+     242: 14,  # 'ς'
+     243: 7,  # 'σ'
+     244: 2,  # 'τ'
+     245: 12,  # 'υ'
+     246: 28,  # 'φ'
+     247: 23,  # 'χ'
+     248: 42,  # 'ψ'
+     249: 24,  # 'ω'
+     250: 64,  # 'ϊ'
+     251: 75,  # 'ϋ'
+     252: 19,  # 'ό'
+     253: 26,  # 'ύ'
+     254: 27,  # 'ώ'
+     255: 253,  # None
+}
+
+WINDOWS_1253_GREEK_MODEL = SingleByteCharSetModel(charset_name='windows-1253',
+                                                  language='Greek',
+                                                  char_to_order_map=WINDOWS_1253_GREEK_CHAR_TO_ORDER,
+                                                  language_model=GREEK_LANG_MODEL,
+                                                  typical_positive_ratio=0.982851,
+                                                  keep_ascii_letters=False,
+                                                  alphabet='ΆΈΉΊΌΎΏΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩάέήίαβγδεζηθικλμνξοπρςστυφχψωόύώ')
+
+ISO_8859_7_GREEK_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 82,  # 'A'
+     66: 100,  # 'B'
+     67: 104,  # 'C'
+     68: 94,  # 'D'
+     69: 98,  # 'E'
+     70: 101,  # 'F'
+     71: 116,  # 'G'
+     72: 102,  # 'H'
+     73: 111,  # 'I'
+     74: 187,  # 'J'
+     75: 117,  # 'K'
+     76: 92,  # 'L'
+     77: 88,  # 'M'
+     78: 113,  # 'N'
+     79: 85,  # 'O'
+     80: 79,  # 'P'
+     81: 118,  # 'Q'
+     82: 105,  # 'R'
+     83: 83,  # 'S'
+     84: 67,  # 'T'
+     85: 114,  # 'U'
+     86: 119,  # 'V'
+     87: 95,  # 'W'
+     88: 99,  # 'X'
+     89: 109,  # 'Y'
+     90: 188,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 72,  # 'a'
+     98: 70,  # 'b'
+     99: 80,  # 'c'
+     100: 81,  # 'd'
+     101: 60,  # 'e'
+     102: 96,  # 'f'
+     103: 93,  # 'g'
+     104: 89,  # 'h'
+     105: 68,  # 'i'
+     106: 120,  # 'j'
+     107: 97,  # 'k'
+     108: 77,  # 'l'
+     109: 86,  # 'm'
+     110: 69,  # 'n'
+     111: 55,  # 'o'
+     112: 78,  # 'p'
+     113: 115,  # 'q'
+     114: 65,  # 'r'
+     115: 66,  # 's'
+     116: 58,  # 't'
+     117: 76,  # 'u'
+     118: 106,  # 'v'
+     119: 103,  # 'w'
+     120: 87,  # 'x'
+     121: 107,  # 'y'
+     122: 112,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 255,  # '\x80'
+     129: 255,  # '\x81'
+     130: 255,  # '\x82'
+     131: 255,  # '\x83'
+     132: 255,  # '\x84'
+     133: 255,  # '\x85'
+     134: 255,  # '\x86'
+     135: 255,  # '\x87'
+     136: 255,  # '\x88'
+     137: 255,  # '\x89'
+     138: 255,  # '\x8a'
+     139: 255,  # '\x8b'
+     140: 255,  # '\x8c'
+     141: 255,  # '\x8d'
+     142: 255,  # '\x8e'
+     143: 255,  # '\x8f'
+     144: 255,  # '\x90'
+     145: 255,  # '\x91'
+     146: 255,  # '\x92'
+     147: 255,  # '\x93'
+     148: 255,  # '\x94'
+     149: 255,  # '\x95'
+     150: 255,  # '\x96'
+     151: 255,  # '\x97'
+     152: 255,  # '\x98'
+     153: 255,  # '\x99'
+     154: 255,  # '\x9a'
+     155: 255,  # '\x9b'
+     156: 255,  # '\x9c'
+     157: 255,  # '\x9d'
+     158: 255,  # '\x9e'
+     159: 255,  # '\x9f'
+     160: 253,  # '\xa0'
+     161: 233,  # '‘'
+     162: 90,  # '’'
+     163: 253,  # '£'
+     164: 253,  # '€'
+     165: 253,  # '₯'
+     166: 253,  # '¦'
+     167: 253,  # '§'
+     168: 253,  # '¨'
+     169: 253,  # '©'
+     170: 253,  # 'ͺ'
+     171: 253,  # '«'
+     172: 253,  # '¬'
+     173: 74,  # '\xad'
+     174: 253,  # None
+     175: 253,  # '―'
+     176: 253,  # '°'
+     177: 253,  # '±'
+     178: 253,  # '²'
+     179: 253,  # '³'
+     180: 247,  # '΄'
+     181: 248,  # '΅'
+     182: 61,  # 'Ά'
+     183: 36,  # '·'
+     184: 46,  # 'Έ'
+     185: 71,  # 'Ή'
+     186: 73,  # 'Ί'
+     187: 253,  # '»'
+     188: 54,  # 'Ό'
+     189: 253,  # '½'
+     190: 108,  # 'Ύ'
+     191: 123,  # 'Ώ'
+     192: 110,  # 'ΐ'
+     193: 31,  # 'Α'
+     194: 51,  # 'Β'
+     195: 43,  # 'Γ'
+     196: 41,  # 'Δ'
+     197: 34,  # 'Ε'
+     198: 91,  # 'Ζ'
+     199: 40,  # 'Η'
+     200: 52,  # 'Θ'
+     201: 47,  # 'Ι'
+     202: 44,  # 'Κ'
+     203: 53,  # 'Λ'
+     204: 38,  # 'Μ'
+     205: 49,  # 'Ν'
+     206: 59,  # 'Ξ'
+     207: 39,  # 'Ο'
+     208: 35,  # 'Π'
+     209: 48,  # 'Ρ'
+     210: 250,  # None
+     211: 37,  # 'Σ'
+     212: 33,  # 'Τ'
+     213: 45,  # 'Υ'
+     214: 56,  # 'Φ'
+     215: 50,  # 'Χ'
+     216: 84,  # 'Ψ'
+     217: 57,  # 'Ω'
+     218: 120,  # 'Ϊ'
+     219: 121,  # 'Ϋ'
+     220: 17,  # 'ά'
+     221: 18,  # 'έ'
+     222: 22,  # 'ή'
+     223: 15,  # 'ί'
+     224: 124,  # 'ΰ'
+     225: 1,  # 'α'
+     226: 29,  # 'β'
+     227: 20,  # 'γ'
+     228: 21,  # 'δ'
+     229: 3,  # 'ε'
+     230: 32,  # 'ζ'
+     231: 13,  # 'η'
+     232: 25,  # 'θ'
+     233: 5,  # 'ι'
+     234: 11,  # 'κ'
+     235: 16,  # 'λ'
+     236: 10,  # 'μ'
+     237: 6,  # 'ν'
+     238: 30,  # 'ξ'
+     239: 4,  # 'ο'
+     240: 9,  # 'π'
+     241: 8,  # 'ρ'
+     242: 14,  # 'ς'
+     243: 7,  # 'σ'
+     244: 2,  # 'τ'
+     245: 12,  # 'υ'
+     246: 28,  # 'φ'
+     247: 23,  # 'χ'
+     248: 42,  # 'ψ'
+     249: 24,  # 'ω'
+     250: 64,  # 'ϊ'
+     251: 75,  # 'ϋ'
+     252: 19,  # 'ό'
+     253: 26,  # 'ύ'
+     254: 27,  # 'ώ'
+     255: 253,  # None
+}
+
+ISO_8859_7_GREEK_MODEL = SingleByteCharSetModel(charset_name='ISO-8859-7',
+                                                language='Greek',
+                                                char_to_order_map=ISO_8859_7_GREEK_CHAR_TO_ORDER,
+                                                language_model=GREEK_LANG_MODEL,
+                                                typical_positive_ratio=0.982851,
+                                                keep_ascii_letters=False,
+                                                alphabet='ΆΈΉΊΌΎΏΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩάέήίαβγδεζηθικλμνξοπρςστυφχψωόύώ')
+
diff --git a/openpype/vendor/python/python_2/chardet/langhebrewmodel.py b/openpype/vendor/python/python_2/chardet/langhebrewmodel.py
new file mode 100644
index 0000000000..40fd674c4a
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/langhebrewmodel.py
@@ -0,0 +1,4383 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from chardet.sbcharsetprober import SingleByteCharSetModel
+
+
+# 3: Positive
+# 2: Likely
+# 1: Unlikely
+# 0: Negative
+
+HEBREW_LANG_MODEL = {
+    50: {  # 'a'
+        50: 0,  # 'a'
+        60: 1,  # 'c'
+        61: 1,  # 'd'
+        42: 1,  # 'e'
+        53: 1,  # 'i'
+        56: 2,  # 'l'
+        54: 2,  # 'n'
+        49: 0,  # 'o'
+        51: 2,  # 'r'
+        43: 1,  # 's'
+        44: 2,  # 't'
+        63: 1,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 1,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 1,  # 'ק'
+        7: 0,  # 'ר'
+        10: 1,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    60: {  # 'c'
+        50: 1,  # 'a'
+        60: 1,  # 'c'
+        61: 0,  # 'd'
+        42: 1,  # 'e'
+        53: 1,  # 'i'
+        56: 1,  # 'l'
+        54: 0,  # 'n'
+        49: 1,  # 'o'
+        51: 1,  # 'r'
+        43: 1,  # 's'
+        44: 2,  # 't'
+        63: 1,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 1,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 1,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    61: {  # 'd'
+        50: 1,  # 'a'
+        60: 0,  # 'c'
+        61: 1,  # 'd'
+        42: 1,  # 'e'
+        53: 1,  # 'i'
+        56: 1,  # 'l'
+        54: 1,  # 'n'
+        49: 2,  # 'o'
+        51: 1,  # 'r'
+        43: 1,  # 's'
+        44: 0,  # 't'
+        63: 1,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 1,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 1,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    42: {  # 'e'
+        50: 1,  # 'a'
+        60: 1,  # 'c'
+        61: 2,  # 'd'
+        42: 1,  # 'e'
+        53: 1,  # 'i'
+        56: 2,  # 'l'
+        54: 2,  # 'n'
+        49: 1,  # 'o'
+        51: 2,  # 'r'
+        43: 2,  # 's'
+        44: 2,  # 't'
+        63: 1,  # 'u'
+        34: 1,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 1,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 1,  # '–'
+        52: 2,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    53: {  # 'i'
+        50: 1,  # 'a'
+        60: 2,  # 'c'
+        61: 1,  # 'd'
+        42: 1,  # 'e'
+        53: 0,  # 'i'
+        56: 1,  # 'l'
+        54: 2,  # 'n'
+        49: 2,  # 'o'
+        51: 1,  # 'r'
+        43: 2,  # 's'
+        44: 2,  # 't'
+        63: 1,  # 'u'
+        34: 0,  # '\xa0'
+        55: 1,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    56: {  # 'l'
+        50: 1,  # 'a'
+        60: 1,  # 'c'
+        61: 1,  # 'd'
+        42: 2,  # 'e'
+        53: 2,  # 'i'
+        56: 2,  # 'l'
+        54: 1,  # 'n'
+        49: 1,  # 'o'
+        51: 0,  # 'r'
+        43: 1,  # 's'
+        44: 1,  # 't'
+        63: 1,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    54: {  # 'n'
+        50: 1,  # 'a'
+        60: 1,  # 'c'
+        61: 1,  # 'd'
+        42: 1,  # 'e'
+        53: 1,  # 'i'
+        56: 1,  # 'l'
+        54: 1,  # 'n'
+        49: 1,  # 'o'
+        51: 0,  # 'r'
+        43: 1,  # 's'
+        44: 2,  # 't'
+        63: 1,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 1,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 2,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    49: {  # 'o'
+        50: 1,  # 'a'
+        60: 1,  # 'c'
+        61: 1,  # 'd'
+        42: 1,  # 'e'
+        53: 1,  # 'i'
+        56: 1,  # 'l'
+        54: 2,  # 'n'
+        49: 1,  # 'o'
+        51: 2,  # 'r'
+        43: 1,  # 's'
+        44: 1,  # 't'
+        63: 1,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    51: {  # 'r'
+        50: 2,  # 'a'
+        60: 1,  # 'c'
+        61: 1,  # 'd'
+        42: 2,  # 'e'
+        53: 1,  # 'i'
+        56: 1,  # 'l'
+        54: 1,  # 'n'
+        49: 2,  # 'o'
+        51: 1,  # 'r'
+        43: 1,  # 's'
+        44: 1,  # 't'
+        63: 1,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 2,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    43: {  # 's'
+        50: 1,  # 'a'
+        60: 1,  # 'c'
+        61: 0,  # 'd'
+        42: 2,  # 'e'
+        53: 1,  # 'i'
+        56: 1,  # 'l'
+        54: 1,  # 'n'
+        49: 1,  # 'o'
+        51: 1,  # 'r'
+        43: 1,  # 's'
+        44: 2,  # 't'
+        63: 1,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 2,  # '”'
+        58: 0,  # '†'
+        40: 2,  # '…'
+    },
+    44: {  # 't'
+        50: 1,  # 'a'
+        60: 1,  # 'c'
+        61: 0,  # 'd'
+        42: 2,  # 'e'
+        53: 2,  # 'i'
+        56: 1,  # 'l'
+        54: 0,  # 'n'
+        49: 1,  # 'o'
+        51: 1,  # 'r'
+        43: 1,  # 's'
+        44: 1,  # 't'
+        63: 1,  # 'u'
+        34: 1,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 2,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    63: {  # 'u'
+        50: 1,  # 'a'
+        60: 1,  # 'c'
+        61: 1,  # 'd'
+        42: 1,  # 'e'
+        53: 1,  # 'i'
+        56: 1,  # 'l'
+        54: 1,  # 'n'
+        49: 0,  # 'o'
+        51: 1,  # 'r'
+        43: 2,  # 's'
+        44: 1,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    34: {  # '\xa0'
+        50: 1,  # 'a'
+        60: 0,  # 'c'
+        61: 1,  # 'd'
+        42: 0,  # 'e'
+        53: 1,  # 'i'
+        56: 0,  # 'l'
+        54: 1,  # 'n'
+        49: 1,  # 'o'
+        51: 0,  # 'r'
+        43: 1,  # 's'
+        44: 1,  # 't'
+        63: 0,  # 'u'
+        34: 2,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 1,  # 'ב'
+        20: 1,  # 'ג'
+        16: 1,  # 'ד'
+        3: 1,  # 'ה'
+        2: 1,  # 'ו'
+        24: 1,  # 'ז'
+        14: 1,  # 'ח'
+        22: 1,  # 'ט'
+        1: 2,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 1,  # 'ל'
+        11: 0,  # 'ם'
+        6: 2,  # 'מ'
+        23: 0,  # 'ן'
+        12: 1,  # 'נ'
+        19: 1,  # 'ס'
+        13: 1,  # 'ע'
+        26: 0,  # 'ף'
+        18: 1,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 1,  # 'צ'
+        17: 1,  # 'ק'
+        7: 1,  # 'ר'
+        10: 1,  # 'ש'
+        5: 1,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    55: {  # '´'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 1,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 1,  # 'ה'
+        2: 1,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 2,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 1,  # 'ל'
+        11: 0,  # 'ם'
+        6: 1,  # 'מ'
+        23: 1,  # 'ן'
+        12: 1,  # 'נ'
+        19: 1,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 1,  # 'ר'
+        10: 1,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    48: {  # '¼'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 1,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 1,  # 'ל'
+        11: 0,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    39: {  # '½'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 1,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 1,  # 'צ'
+        17: 1,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    57: {  # '¾'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    30: {  # 'ְ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 2,  # 'ב'
+        20: 2,  # 'ג'
+        16: 2,  # 'ד'
+        3: 2,  # 'ה'
+        2: 2,  # 'ו'
+        24: 2,  # 'ז'
+        14: 2,  # 'ח'
+        22: 2,  # 'ט'
+        1: 2,  # 'י'
+        25: 2,  # 'ך'
+        15: 2,  # 'כ'
+        4: 2,  # 'ל'
+        11: 1,  # 'ם'
+        6: 2,  # 'מ'
+        23: 0,  # 'ן'
+        12: 2,  # 'נ'
+        19: 2,  # 'ס'
+        13: 2,  # 'ע'
+        26: 0,  # 'ף'
+        18: 2,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 2,  # 'ק'
+        7: 2,  # 'ר'
+        10: 2,  # 'ש'
+        5: 2,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    59: {  # 'ֱ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 1,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 1,  # 'ב'
+        20: 1,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 1,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 1,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 2,  # 'ל'
+        11: 0,  # 'ם'
+        6: 2,  # 'מ'
+        23: 0,  # 'ן'
+        12: 1,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 1,  # 'ר'
+        10: 1,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    41: {  # 'ֲ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 2,  # 'ב'
+        20: 1,  # 'ג'
+        16: 2,  # 'ד'
+        3: 1,  # 'ה'
+        2: 1,  # 'ו'
+        24: 1,  # 'ז'
+        14: 1,  # 'ח'
+        22: 1,  # 'ט'
+        1: 1,  # 'י'
+        25: 1,  # 'ך'
+        15: 1,  # 'כ'
+        4: 2,  # 'ל'
+        11: 0,  # 'ם'
+        6: 2,  # 'מ'
+        23: 0,  # 'ן'
+        12: 2,  # 'נ'
+        19: 1,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 1,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 1,  # 'ק'
+        7: 2,  # 'ר'
+        10: 2,  # 'ש'
+        5: 1,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    33: {  # 'ִ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 1,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 1,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 1,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 1,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 2,  # 'ב'
+        20: 2,  # 'ג'
+        16: 2,  # 'ד'
+        3: 1,  # 'ה'
+        2: 1,  # 'ו'
+        24: 2,  # 'ז'
+        14: 1,  # 'ח'
+        22: 1,  # 'ט'
+        1: 3,  # 'י'
+        25: 1,  # 'ך'
+        15: 2,  # 'כ'
+        4: 2,  # 'ל'
+        11: 2,  # 'ם'
+        6: 2,  # 'מ'
+        23: 2,  # 'ן'
+        12: 2,  # 'נ'
+        19: 2,  # 'ס'
+        13: 1,  # 'ע'
+        26: 0,  # 'ף'
+        18: 2,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 2,  # 'ק'
+        7: 2,  # 'ר'
+        10: 2,  # 'ש'
+        5: 2,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    37: {  # 'ֵ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 1,  # 'ַ'
+        29: 1,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 2,  # 'ב'
+        20: 1,  # 'ג'
+        16: 2,  # 'ד'
+        3: 2,  # 'ה'
+        2: 1,  # 'ו'
+        24: 1,  # 'ז'
+        14: 2,  # 'ח'
+        22: 1,  # 'ט'
+        1: 3,  # 'י'
+        25: 2,  # 'ך'
+        15: 1,  # 'כ'
+        4: 2,  # 'ל'
+        11: 2,  # 'ם'
+        6: 1,  # 'מ'
+        23: 2,  # 'ן'
+        12: 2,  # 'נ'
+        19: 1,  # 'ס'
+        13: 2,  # 'ע'
+        26: 1,  # 'ף'
+        18: 1,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 1,  # 'צ'
+        17: 1,  # 'ק'
+        7: 2,  # 'ר'
+        10: 2,  # 'ש'
+        5: 2,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    36: {  # 'ֶ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 1,  # 'ַ'
+        29: 1,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 2,  # 'ב'
+        20: 1,  # 'ג'
+        16: 2,  # 'ד'
+        3: 2,  # 'ה'
+        2: 1,  # 'ו'
+        24: 1,  # 'ז'
+        14: 2,  # 'ח'
+        22: 1,  # 'ט'
+        1: 2,  # 'י'
+        25: 2,  # 'ך'
+        15: 1,  # 'כ'
+        4: 2,  # 'ל'
+        11: 2,  # 'ם'
+        6: 2,  # 'מ'
+        23: 2,  # 'ן'
+        12: 2,  # 'נ'
+        19: 2,  # 'ס'
+        13: 1,  # 'ע'
+        26: 1,  # 'ף'
+        18: 1,  # 'פ'
+        27: 2,  # 'ץ'
+        21: 1,  # 'צ'
+        17: 1,  # 'ק'
+        7: 2,  # 'ר'
+        10: 2,  # 'ש'
+        5: 2,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    31: {  # 'ַ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 1,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 2,  # 'ב'
+        20: 2,  # 'ג'
+        16: 2,  # 'ד'
+        3: 2,  # 'ה'
+        2: 1,  # 'ו'
+        24: 2,  # 'ז'
+        14: 2,  # 'ח'
+        22: 2,  # 'ט'
+        1: 3,  # 'י'
+        25: 1,  # 'ך'
+        15: 2,  # 'כ'
+        4: 2,  # 'ל'
+        11: 2,  # 'ם'
+        6: 2,  # 'מ'
+        23: 2,  # 'ן'
+        12: 2,  # 'נ'
+        19: 2,  # 'ס'
+        13: 2,  # 'ע'
+        26: 2,  # 'ף'
+        18: 2,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 2,  # 'ק'
+        7: 2,  # 'ר'
+        10: 2,  # 'ש'
+        5: 2,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    29: {  # 'ָ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 1,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 1,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 2,  # 'ב'
+        20: 2,  # 'ג'
+        16: 2,  # 'ד'
+        3: 3,  # 'ה'
+        2: 2,  # 'ו'
+        24: 2,  # 'ז'
+        14: 2,  # 'ח'
+        22: 1,  # 'ט'
+        1: 2,  # 'י'
+        25: 2,  # 'ך'
+        15: 2,  # 'כ'
+        4: 2,  # 'ל'
+        11: 2,  # 'ם'
+        6: 2,  # 'מ'
+        23: 2,  # 'ן'
+        12: 2,  # 'נ'
+        19: 1,  # 'ס'
+        13: 2,  # 'ע'
+        26: 1,  # 'ף'
+        18: 2,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 2,  # 'ק'
+        7: 2,  # 'ר'
+        10: 2,  # 'ש'
+        5: 2,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    35: {  # 'ֹ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 2,  # 'ב'
+        20: 1,  # 'ג'
+        16: 2,  # 'ד'
+        3: 2,  # 'ה'
+        2: 1,  # 'ו'
+        24: 1,  # 'ז'
+        14: 1,  # 'ח'
+        22: 1,  # 'ט'
+        1: 1,  # 'י'
+        25: 1,  # 'ך'
+        15: 2,  # 'כ'
+        4: 2,  # 'ל'
+        11: 2,  # 'ם'
+        6: 2,  # 'מ'
+        23: 2,  # 'ן'
+        12: 2,  # 'נ'
+        19: 2,  # 'ס'
+        13: 2,  # 'ע'
+        26: 1,  # 'ף'
+        18: 2,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 2,  # 'ק'
+        7: 2,  # 'ר'
+        10: 2,  # 'ש'
+        5: 2,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    62: {  # 'ֻ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 1,  # 'ב'
+        20: 1,  # 'ג'
+        16: 1,  # 'ד'
+        3: 1,  # 'ה'
+        2: 1,  # 'ו'
+        24: 1,  # 'ז'
+        14: 1,  # 'ח'
+        22: 0,  # 'ט'
+        1: 1,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 2,  # 'ל'
+        11: 1,  # 'ם'
+        6: 1,  # 'מ'
+        23: 1,  # 'ן'
+        12: 1,  # 'נ'
+        19: 1,  # 'ס'
+        13: 1,  # 'ע'
+        26: 0,  # 'ף'
+        18: 1,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 1,  # 'צ'
+        17: 1,  # 'ק'
+        7: 1,  # 'ר'
+        10: 1,  # 'ש'
+        5: 1,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    28: {  # 'ּ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 3,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 1,  # 'ֲ'
+        33: 3,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 3,  # 'ַ'
+        29: 3,  # 'ָ'
+        35: 2,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 2,  # 'ׁ'
+        45: 1,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 2,  # 'ב'
+        20: 1,  # 'ג'
+        16: 2,  # 'ד'
+        3: 1,  # 'ה'
+        2: 2,  # 'ו'
+        24: 1,  # 'ז'
+        14: 1,  # 'ח'
+        22: 1,  # 'ט'
+        1: 2,  # 'י'
+        25: 2,  # 'ך'
+        15: 2,  # 'כ'
+        4: 2,  # 'ל'
+        11: 1,  # 'ם'
+        6: 2,  # 'מ'
+        23: 1,  # 'ן'
+        12: 2,  # 'נ'
+        19: 1,  # 'ס'
+        13: 2,  # 'ע'
+        26: 1,  # 'ף'
+        18: 1,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 1,  # 'צ'
+        17: 1,  # 'ק'
+        7: 2,  # 'ר'
+        10: 2,  # 'ש'
+        5: 2,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    38: {  # 'ׁ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 2,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 1,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 1,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    45: {  # 'ׂ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 1,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 1,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 0,  # 'ב'
+        20: 1,  # 'ג'
+        16: 0,  # 'ד'
+        3: 1,  # 'ה'
+        2: 2,  # 'ו'
+        24: 0,  # 'ז'
+        14: 1,  # 'ח'
+        22: 0,  # 'ט'
+        1: 1,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 1,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 1,  # 'נ'
+        19: 0,  # 'ס'
+        13: 1,  # 'ע'
+        26: 0,  # 'ף'
+        18: 1,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 1,  # 'ר'
+        10: 0,  # 'ש'
+        5: 1,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    9: {  # 'א'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 1,  # '´'
+        48: 1,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 2,  # 'ֱ'
+        41: 2,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 2,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 3,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 2,  # 'ע'
+        26: 3,  # 'ף'
+        18: 3,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    8: {  # 'ב'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 1,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 1,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 2,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 3,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 2,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 2,  # 'ם'
+        6: 3,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 3,  # 'ע'
+        26: 1,  # 'ף'
+        18: 3,  # 'פ'
+        27: 2,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 1,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    20: {  # 'ג'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 2,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 1,  # 'ִ'
+        37: 1,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 3,  # 'ב'
+        20: 2,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 2,  # 'ח'
+        22: 2,  # 'ט'
+        1: 3,  # 'י'
+        25: 1,  # 'ך'
+        15: 1,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 2,  # 'ס'
+        13: 3,  # 'ע'
+        26: 2,  # 'ף'
+        18: 2,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 1,  # 'צ'
+        17: 1,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    16: {  # 'ד'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 2,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 1,  # 'ז'
+        14: 2,  # 'ח'
+        22: 2,  # 'ט'
+        1: 3,  # 'י'
+        25: 2,  # 'ך'
+        15: 2,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 2,  # 'ן'
+        12: 3,  # 'נ'
+        19: 2,  # 'ס'
+        13: 3,  # 'ע'
+        26: 2,  # 'ף'
+        18: 3,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    3: {  # 'ה'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 1,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 0,  # '´'
+        48: 1,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 1,  # 'ְ'
+        59: 1,  # 'ֱ'
+        41: 2,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 3,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 1,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 3,  # 'ע'
+        26: 0,  # 'ף'
+        18: 3,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 1,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 2,  # '…'
+    },
+    2: {  # 'ו'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 1,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 1,  # '´'
+        48: 1,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 1,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 3,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 3,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 3,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 3,  # 'ע'
+        26: 3,  # 'ף'
+        18: 3,  # 'פ'
+        27: 3,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 1,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 2,  # '…'
+    },
+    24: {  # 'ז'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 1,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 1,  # 'ֲ'
+        33: 1,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 2,  # 'ב'
+        20: 2,  # 'ג'
+        16: 2,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 2,  # 'ז'
+        14: 2,  # 'ח'
+        22: 1,  # 'ט'
+        1: 3,  # 'י'
+        25: 1,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 2,  # 'ם'
+        6: 3,  # 'מ'
+        23: 2,  # 'ן'
+        12: 2,  # 'נ'
+        19: 1,  # 'ס'
+        13: 2,  # 'ע'
+        26: 1,  # 'ף'
+        18: 1,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 1,  # 'ש'
+        5: 2,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    14: {  # 'ח'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 1,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 1,  # 'ֱ'
+        41: 2,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 2,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 3,  # 'ב'
+        20: 2,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 2,  # 'ח'
+        22: 2,  # 'ט'
+        1: 3,  # 'י'
+        25: 1,  # 'ך'
+        15: 2,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 2,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 1,  # 'ע'
+        26: 2,  # 'ף'
+        18: 2,  # 'פ'
+        27: 2,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    22: {  # 'ט'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 1,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 1,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 1,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 1,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 2,  # 'ז'
+        14: 3,  # 'ח'
+        22: 2,  # 'ט'
+        1: 3,  # 'י'
+        25: 1,  # 'ך'
+        15: 2,  # 'כ'
+        4: 3,  # 'ל'
+        11: 2,  # 'ם'
+        6: 2,  # 'מ'
+        23: 2,  # 'ן'
+        12: 3,  # 'נ'
+        19: 2,  # 'ס'
+        13: 3,  # 'ע'
+        26: 2,  # 'ף'
+        18: 3,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 2,  # 'ק'
+        7: 3,  # 'ר'
+        10: 2,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    1: {  # 'י'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 1,  # '´'
+        48: 1,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 2,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 3,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 3,  # 'ע'
+        26: 3,  # 'ף'
+        18: 3,  # 'פ'
+        27: 3,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 1,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 2,  # '…'
+    },
+    25: {  # 'ך'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 1,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 1,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 1,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 1,  # 'ל'
+        11: 0,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 1,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    15: {  # 'כ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 3,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 2,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 3,  # 'ח'
+        22: 2,  # 'ט'
+        1: 3,  # 'י'
+        25: 3,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 2,  # 'ע'
+        26: 3,  # 'ף'
+        18: 3,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 2,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    4: {  # 'ל'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 1,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 3,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 2,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 3,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 2,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 3,  # 'ע'
+        26: 2,  # 'ף'
+        18: 3,  # 'פ'
+        27: 2,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 1,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    11: {  # 'ם'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 1,  # 'ב'
+        20: 1,  # 'ג'
+        16: 0,  # 'ד'
+        3: 1,  # 'ה'
+        2: 1,  # 'ו'
+        24: 1,  # 'ז'
+        14: 1,  # 'ח'
+        22: 0,  # 'ט'
+        1: 1,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 1,  # 'ל'
+        11: 1,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 1,  # 'נ'
+        19: 0,  # 'ס'
+        13: 1,  # 'ע'
+        26: 0,  # 'ף'
+        18: 1,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 1,  # 'צ'
+        17: 1,  # 'ק'
+        7: 1,  # 'ר'
+        10: 1,  # 'ש'
+        5: 1,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 2,  # '…'
+    },
+    6: {  # 'מ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 1,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 2,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 2,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 3,  # 'ע'
+        26: 0,  # 'ף'
+        18: 3,  # 'פ'
+        27: 2,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    23: {  # 'ן'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 0,  # '´'
+        48: 1,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 1,  # 'ב'
+        20: 1,  # 'ג'
+        16: 1,  # 'ד'
+        3: 1,  # 'ה'
+        2: 1,  # 'ו'
+        24: 0,  # 'ז'
+        14: 1,  # 'ח'
+        22: 1,  # 'ט'
+        1: 1,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 1,  # 'ל'
+        11: 1,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 1,  # 'נ'
+        19: 1,  # 'ס'
+        13: 1,  # 'ע'
+        26: 1,  # 'ף'
+        18: 1,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 1,  # 'ק'
+        7: 1,  # 'ר'
+        10: 1,  # 'ש'
+        5: 1,  # 'ת'
+        32: 1,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 2,  # '…'
+    },
+    12: {  # 'נ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 2,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 3,  # 'ע'
+        26: 2,  # 'ף'
+        18: 3,  # 'פ'
+        27: 2,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    19: {  # 'ס'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 1,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 1,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 1,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 2,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 1,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 2,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 2,  # 'ם'
+        6: 3,  # 'מ'
+        23: 2,  # 'ן'
+        12: 3,  # 'נ'
+        19: 2,  # 'ס'
+        13: 3,  # 'ע'
+        26: 3,  # 'ף'
+        18: 3,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 1,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    13: {  # 'ע'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 1,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 1,  # 'ְ'
+        59: 1,  # 'ֱ'
+        41: 2,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 2,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 1,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 2,  # 'ך'
+        15: 2,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 2,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 2,  # 'ע'
+        26: 1,  # 'ף'
+        18: 2,  # 'פ'
+        27: 2,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    26: {  # 'ף'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 1,  # 'ו'
+        24: 0,  # 'ז'
+        14: 1,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 1,  # 'ל'
+        11: 0,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 1,  # 'ס'
+        13: 0,  # 'ע'
+        26: 1,  # 'ף'
+        18: 1,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 1,  # 'ק'
+        7: 1,  # 'ר'
+        10: 1,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    18: {  # 'פ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 1,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 1,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 1,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 2,  # 'ב'
+        20: 3,  # 'ג'
+        16: 2,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 2,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 2,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 2,  # 'ם'
+        6: 2,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 3,  # 'ע'
+        26: 2,  # 'ף'
+        18: 2,  # 'פ'
+        27: 2,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    27: {  # 'ץ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 1,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 1,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 1,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 1,  # 'ר'
+        10: 0,  # 'ש'
+        5: 1,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    21: {  # 'צ'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 1,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 2,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 1,  # 'ז'
+        14: 3,  # 'ח'
+        22: 2,  # 'ט'
+        1: 3,  # 'י'
+        25: 1,  # 'ך'
+        15: 1,  # 'כ'
+        4: 3,  # 'ל'
+        11: 2,  # 'ם'
+        6: 3,  # 'מ'
+        23: 2,  # 'ן'
+        12: 3,  # 'נ'
+        19: 1,  # 'ס'
+        13: 3,  # 'ע'
+        26: 2,  # 'ף'
+        18: 3,  # 'פ'
+        27: 2,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 0,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    17: {  # 'ק'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 1,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 2,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 2,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 2,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 1,  # 'ך'
+        15: 1,  # 'כ'
+        4: 3,  # 'ל'
+        11: 2,  # 'ם'
+        6: 3,  # 'מ'
+        23: 2,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 3,  # 'ע'
+        26: 2,  # 'ף'
+        18: 3,  # 'פ'
+        27: 2,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 2,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    7: {  # 'ר'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 2,  # '´'
+        48: 1,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 1,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 2,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 3,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 3,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 3,  # 'ס'
+        13: 3,  # 'ע'
+        26: 2,  # 'ף'
+        18: 3,  # 'פ'
+        27: 3,  # 'ץ'
+        21: 3,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 2,  # '…'
+    },
+    10: {  # 'ש'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 1,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 1,  # 'ִ'
+        37: 1,  # 'ֵ'
+        36: 1,  # 'ֶ'
+        31: 1,  # 'ַ'
+        29: 1,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 3,  # 'ׁ'
+        45: 2,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 3,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 2,  # 'ז'
+        14: 3,  # 'ח'
+        22: 3,  # 'ט'
+        1: 3,  # 'י'
+        25: 3,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 2,  # 'ן'
+        12: 3,  # 'נ'
+        19: 2,  # 'ס'
+        13: 3,  # 'ע'
+        26: 2,  # 'ף'
+        18: 3,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 1,  # '…'
+    },
+    5: {  # 'ת'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 1,  # '\xa0'
+        55: 0,  # '´'
+        48: 1,  # '¼'
+        39: 1,  # '½'
+        57: 0,  # '¾'
+        30: 2,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 2,  # 'ִ'
+        37: 2,  # 'ֵ'
+        36: 2,  # 'ֶ'
+        31: 2,  # 'ַ'
+        29: 2,  # 'ָ'
+        35: 1,  # 'ֹ'
+        62: 1,  # 'ֻ'
+        28: 2,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 3,  # 'א'
+        8: 3,  # 'ב'
+        20: 3,  # 'ג'
+        16: 2,  # 'ד'
+        3: 3,  # 'ה'
+        2: 3,  # 'ו'
+        24: 2,  # 'ז'
+        14: 3,  # 'ח'
+        22: 2,  # 'ט'
+        1: 3,  # 'י'
+        25: 2,  # 'ך'
+        15: 3,  # 'כ'
+        4: 3,  # 'ל'
+        11: 3,  # 'ם'
+        6: 3,  # 'מ'
+        23: 3,  # 'ן'
+        12: 3,  # 'נ'
+        19: 2,  # 'ס'
+        13: 3,  # 'ע'
+        26: 2,  # 'ף'
+        18: 3,  # 'פ'
+        27: 1,  # 'ץ'
+        21: 2,  # 'צ'
+        17: 3,  # 'ק'
+        7: 3,  # 'ר'
+        10: 3,  # 'ש'
+        5: 3,  # 'ת'
+        32: 1,  # '–'
+        52: 1,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 2,  # '…'
+    },
+    32: {  # '–'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 1,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 1,  # 'ב'
+        20: 1,  # 'ג'
+        16: 1,  # 'ד'
+        3: 1,  # 'ה'
+        2: 1,  # 'ו'
+        24: 0,  # 'ז'
+        14: 1,  # 'ח'
+        22: 0,  # 'ט'
+        1: 1,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 1,  # 'ל'
+        11: 0,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 1,  # 'ס'
+        13: 1,  # 'ע'
+        26: 0,  # 'ף'
+        18: 1,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 1,  # 'צ'
+        17: 0,  # 'ק'
+        7: 1,  # 'ר'
+        10: 1,  # 'ש'
+        5: 1,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    52: {  # '’'
+        50: 1,  # 'a'
+        60: 0,  # 'c'
+        61: 1,  # 'd'
+        42: 1,  # 'e'
+        53: 1,  # 'i'
+        56: 1,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 1,  # 'r'
+        43: 2,  # 's'
+        44: 2,  # 't'
+        63: 1,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 1,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 1,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    47: {  # '“'
+        50: 1,  # 'a'
+        60: 1,  # 'c'
+        61: 1,  # 'd'
+        42: 1,  # 'e'
+        53: 1,  # 'i'
+        56: 1,  # 'l'
+        54: 1,  # 'n'
+        49: 1,  # 'o'
+        51: 1,  # 'r'
+        43: 1,  # 's'
+        44: 1,  # 't'
+        63: 1,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 2,  # 'א'
+        8: 1,  # 'ב'
+        20: 1,  # 'ג'
+        16: 1,  # 'ד'
+        3: 1,  # 'ה'
+        2: 1,  # 'ו'
+        24: 1,  # 'ז'
+        14: 1,  # 'ח'
+        22: 1,  # 'ט'
+        1: 1,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 1,  # 'ל'
+        11: 0,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 1,  # 'נ'
+        19: 1,  # 'ס'
+        13: 1,  # 'ע'
+        26: 0,  # 'ף'
+        18: 1,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 1,  # 'צ'
+        17: 1,  # 'ק'
+        7: 1,  # 'ר'
+        10: 1,  # 'ש'
+        5: 1,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    46: {  # '”'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 1,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 1,  # 'ב'
+        20: 1,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 1,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 1,  # 'ל'
+        11: 0,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 1,  # 'צ'
+        17: 0,  # 'ק'
+        7: 1,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 0,  # '†'
+        40: 0,  # '…'
+    },
+    58: {  # '†'
+        50: 0,  # 'a'
+        60: 0,  # 'c'
+        61: 0,  # 'd'
+        42: 0,  # 'e'
+        53: 0,  # 'i'
+        56: 0,  # 'l'
+        54: 0,  # 'n'
+        49: 0,  # 'o'
+        51: 0,  # 'r'
+        43: 0,  # 's'
+        44: 0,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 0,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 0,  # 'ה'
+        2: 0,  # 'ו'
+        24: 0,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 0,  # 'י'
+        25: 0,  # 'ך'
+        15: 0,  # 'כ'
+        4: 0,  # 'ל'
+        11: 0,  # 'ם'
+        6: 0,  # 'מ'
+        23: 0,  # 'ן'
+        12: 0,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 0,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 0,  # 'ר'
+        10: 0,  # 'ש'
+        5: 0,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 0,  # '”'
+        58: 2,  # '†'
+        40: 0,  # '…'
+    },
+    40: {  # '…'
+        50: 1,  # 'a'
+        60: 1,  # 'c'
+        61: 1,  # 'd'
+        42: 1,  # 'e'
+        53: 1,  # 'i'
+        56: 0,  # 'l'
+        54: 1,  # 'n'
+        49: 0,  # 'o'
+        51: 1,  # 'r'
+        43: 1,  # 's'
+        44: 1,  # 't'
+        63: 0,  # 'u'
+        34: 0,  # '\xa0'
+        55: 0,  # '´'
+        48: 0,  # '¼'
+        39: 0,  # '½'
+        57: 0,  # '¾'
+        30: 0,  # 'ְ'
+        59: 0,  # 'ֱ'
+        41: 0,  # 'ֲ'
+        33: 0,  # 'ִ'
+        37: 0,  # 'ֵ'
+        36: 0,  # 'ֶ'
+        31: 0,  # 'ַ'
+        29: 0,  # 'ָ'
+        35: 0,  # 'ֹ'
+        62: 0,  # 'ֻ'
+        28: 0,  # 'ּ'
+        38: 0,  # 'ׁ'
+        45: 0,  # 'ׂ'
+        9: 1,  # 'א'
+        8: 0,  # 'ב'
+        20: 0,  # 'ג'
+        16: 0,  # 'ד'
+        3: 1,  # 'ה'
+        2: 1,  # 'ו'
+        24: 1,  # 'ז'
+        14: 0,  # 'ח'
+        22: 0,  # 'ט'
+        1: 1,  # 'י'
+        25: 0,  # 'ך'
+        15: 1,  # 'כ'
+        4: 1,  # 'ל'
+        11: 0,  # 'ם'
+        6: 1,  # 'מ'
+        23: 0,  # 'ן'
+        12: 1,  # 'נ'
+        19: 0,  # 'ס'
+        13: 0,  # 'ע'
+        26: 0,  # 'ף'
+        18: 1,  # 'פ'
+        27: 0,  # 'ץ'
+        21: 0,  # 'צ'
+        17: 0,  # 'ק'
+        7: 1,  # 'ר'
+        10: 1,  # 'ש'
+        5: 1,  # 'ת'
+        32: 0,  # '–'
+        52: 0,  # '’'
+        47: 0,  # '“'
+        46: 1,  # '”'
+        58: 0,  # '†'
+        40: 2,  # '…'
+    },
+}
+
+# 255: Undefined characters that did not exist in training text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+# 251: Control characters
+
+# Character Mapping Table(s):
+WINDOWS_1255_HEBREW_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 69,  # 'A'
+     66: 91,  # 'B'
+     67: 79,  # 'C'
+     68: 80,  # 'D'
+     69: 92,  # 'E'
+     70: 89,  # 'F'
+     71: 97,  # 'G'
+     72: 90,  # 'H'
+     73: 68,  # 'I'
+     74: 111,  # 'J'
+     75: 112,  # 'K'
+     76: 82,  # 'L'
+     77: 73,  # 'M'
+     78: 95,  # 'N'
+     79: 85,  # 'O'
+     80: 78,  # 'P'
+     81: 121,  # 'Q'
+     82: 86,  # 'R'
+     83: 71,  # 'S'
+     84: 67,  # 'T'
+     85: 102,  # 'U'
+     86: 107,  # 'V'
+     87: 84,  # 'W'
+     88: 114,  # 'X'
+     89: 103,  # 'Y'
+     90: 115,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 50,  # 'a'
+     98: 74,  # 'b'
+     99: 60,  # 'c'
+     100: 61,  # 'd'
+     101: 42,  # 'e'
+     102: 76,  # 'f'
+     103: 70,  # 'g'
+     104: 64,  # 'h'
+     105: 53,  # 'i'
+     106: 105,  # 'j'
+     107: 93,  # 'k'
+     108: 56,  # 'l'
+     109: 65,  # 'm'
+     110: 54,  # 'n'
+     111: 49,  # 'o'
+     112: 66,  # 'p'
+     113: 110,  # 'q'
+     114: 51,  # 'r'
+     115: 43,  # 's'
+     116: 44,  # 't'
+     117: 63,  # 'u'
+     118: 81,  # 'v'
+     119: 77,  # 'w'
+     120: 98,  # 'x'
+     121: 75,  # 'y'
+     122: 108,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 124,  # '€'
+     129: 202,  # None
+     130: 203,  # '‚'
+     131: 204,  # 'ƒ'
+     132: 205,  # '„'
+     133: 40,  # '…'
+     134: 58,  # '†'
+     135: 206,  # '‡'
+     136: 207,  # 'ˆ'
+     137: 208,  # '‰'
+     138: 209,  # None
+     139: 210,  # '‹'
+     140: 211,  # None
+     141: 212,  # None
+     142: 213,  # None
+     143: 214,  # None
+     144: 215,  # None
+     145: 83,  # '‘'
+     146: 52,  # '’'
+     147: 47,  # '“'
+     148: 46,  # '”'
+     149: 72,  # '•'
+     150: 32,  # '–'
+     151: 94,  # '—'
+     152: 216,  # '˜'
+     153: 113,  # '™'
+     154: 217,  # None
+     155: 109,  # '›'
+     156: 218,  # None
+     157: 219,  # None
+     158: 220,  # None
+     159: 221,  # None
+     160: 34,  # '\xa0'
+     161: 116,  # '¡'
+     162: 222,  # '¢'
+     163: 118,  # '£'
+     164: 100,  # '₪'
+     165: 223,  # '¥'
+     166: 224,  # '¦'
+     167: 117,  # '§'
+     168: 119,  # '¨'
+     169: 104,  # '©'
+     170: 125,  # '×'
+     171: 225,  # '«'
+     172: 226,  # '¬'
+     173: 87,  # '\xad'
+     174: 99,  # '®'
+     175: 227,  # '¯'
+     176: 106,  # '°'
+     177: 122,  # '±'
+     178: 123,  # '²'
+     179: 228,  # '³'
+     180: 55,  # '´'
+     181: 229,  # 'µ'
+     182: 230,  # '¶'
+     183: 101,  # '·'
+     184: 231,  # '¸'
+     185: 232,  # '¹'
+     186: 120,  # '÷'
+     187: 233,  # '»'
+     188: 48,  # '¼'
+     189: 39,  # '½'
+     190: 57,  # '¾'
+     191: 234,  # '¿'
+     192: 30,  # 'ְ'
+     193: 59,  # 'ֱ'
+     194: 41,  # 'ֲ'
+     195: 88,  # 'ֳ'
+     196: 33,  # 'ִ'
+     197: 37,  # 'ֵ'
+     198: 36,  # 'ֶ'
+     199: 31,  # 'ַ'
+     200: 29,  # 'ָ'
+     201: 35,  # 'ֹ'
+     202: 235,  # None
+     203: 62,  # 'ֻ'
+     204: 28,  # 'ּ'
+     205: 236,  # 'ֽ'
+     206: 126,  # '־'
+     207: 237,  # 'ֿ'
+     208: 238,  # '׀'
+     209: 38,  # 'ׁ'
+     210: 45,  # 'ׂ'
+     211: 239,  # '׃'
+     212: 240,  # 'װ'
+     213: 241,  # 'ױ'
+     214: 242,  # 'ײ'
+     215: 243,  # '׳'
+     216: 127,  # '״'
+     217: 244,  # None
+     218: 245,  # None
+     219: 246,  # None
+     220: 247,  # None
+     221: 248,  # None
+     222: 249,  # None
+     223: 250,  # None
+     224: 9,  # 'א'
+     225: 8,  # 'ב'
+     226: 20,  # 'ג'
+     227: 16,  # 'ד'
+     228: 3,  # 'ה'
+     229: 2,  # 'ו'
+     230: 24,  # 'ז'
+     231: 14,  # 'ח'
+     232: 22,  # 'ט'
+     233: 1,  # 'י'
+     234: 25,  # 'ך'
+     235: 15,  # 'כ'
+     236: 4,  # 'ל'
+     237: 11,  # 'ם'
+     238: 6,  # 'מ'
+     239: 23,  # 'ן'
+     240: 12,  # 'נ'
+     241: 19,  # 'ס'
+     242: 13,  # 'ע'
+     243: 26,  # 'ף'
+     244: 18,  # 'פ'
+     245: 27,  # 'ץ'
+     246: 21,  # 'צ'
+     247: 17,  # 'ק'
+     248: 7,  # 'ר'
+     249: 10,  # 'ש'
+     250: 5,  # 'ת'
+     251: 251,  # None
+     252: 252,  # None
+     253: 128,  # '\u200e'
+     254: 96,  # '\u200f'
+     255: 253,  # None
+}
+
+WINDOWS_1255_HEBREW_MODEL = SingleByteCharSetModel(charset_name='windows-1255',
+                                                   language='Hebrew',
+                                                   char_to_order_map=WINDOWS_1255_HEBREW_CHAR_TO_ORDER,
+                                                   language_model=HEBREW_LANG_MODEL,
+                                                   typical_positive_ratio=0.984004,
+                                                   keep_ascii_letters=False,
+                                                   alphabet='אבגדהוזחטיךכלםמןנסעףפץצקרשתװױײ')
+
diff --git a/openpype/vendor/python/python_2/chardet/langhungarianmodel.py b/openpype/vendor/python/python_2/chardet/langhungarianmodel.py
new file mode 100644
index 0000000000..24a097f520
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/langhungarianmodel.py
@@ -0,0 +1,4650 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from chardet.sbcharsetprober import SingleByteCharSetModel
+
+
+# 3: Positive
+# 2: Likely
+# 1: Unlikely
+# 0: Negative
+
+HUNGARIAN_LANG_MODEL = {
+    28: {  # 'A'
+        28: 0,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 2,  # 'D'
+        32: 1,  # 'E'
+        50: 1,  # 'F'
+        49: 2,  # 'G'
+        38: 1,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 2,  # 'K'
+        41: 2,  # 'L'
+        34: 1,  # 'M'
+        35: 2,  # 'N'
+        47: 1,  # 'O'
+        46: 2,  # 'P'
+        43: 2,  # 'R'
+        33: 2,  # 'S'
+        37: 2,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 2,  # 'Z'
+        2: 0,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 2,  # 'd'
+        1: 1,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 1,  # 'h'
+        9: 1,  # 'i'
+        22: 1,  # 'j'
+        7: 2,  # 'k'
+        6: 2,  # 'l'
+        13: 2,  # 'm'
+        4: 2,  # 'n'
+        8: 0,  # 'o'
+        23: 2,  # 'p'
+        10: 2,  # 'r'
+        5: 1,  # 's'
+        3: 1,  # 't'
+        21: 1,  # 'u'
+        19: 1,  # 'v'
+        62: 1,  # 'x'
+        16: 0,  # 'y'
+        11: 3,  # 'z'
+        51: 1,  # 'Á'
+        44: 0,  # 'É'
+        61: 1,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    40: {  # 'B'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 0,  # 'M'
+        35: 1,  # 'N'
+        47: 2,  # 'O'
+        46: 0,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 3,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 2,  # 'i'
+        22: 1,  # 'j'
+        7: 0,  # 'k'
+        6: 1,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        8: 2,  # 'o'
+        23: 1,  # 'p'
+        10: 2,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 3,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 0,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 2,  # 'á'
+        15: 2,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 1,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    54: {  # 'C'
+        28: 1,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 1,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 1,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 0,  # 'N'
+        47: 1,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 2,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 0,  # 'V'
+        55: 1,  # 'Y'
+        52: 1,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 1,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 1,  # 'h'
+        9: 1,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 1,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        8: 2,  # 'o'
+        23: 0,  # 'p'
+        10: 1,  # 'r'
+        5: 3,  # 's'
+        3: 0,  # 't'
+        21: 1,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 1,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 1,  # 'á'
+        15: 1,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    45: {  # 'D'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 0,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 0,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 2,  # 'O'
+        46: 0,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 1,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 3,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 1,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        8: 1,  # 'o'
+        23: 0,  # 'p'
+        10: 2,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 2,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 1,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 1,  # 'á'
+        15: 1,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 1,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    32: {  # 'E'
+        28: 1,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 1,  # 'E'
+        50: 1,  # 'F'
+        49: 2,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 2,  # 'K'
+        41: 2,  # 'L'
+        34: 2,  # 'M'
+        35: 2,  # 'N'
+        47: 1,  # 'O'
+        46: 1,  # 'P'
+        43: 2,  # 'R'
+        33: 2,  # 'S'
+        37: 2,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 1,  # 'Z'
+        2: 1,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 2,  # 'd'
+        1: 1,  # 'e'
+        27: 1,  # 'f'
+        12: 3,  # 'g'
+        20: 1,  # 'h'
+        9: 1,  # 'i'
+        22: 1,  # 'j'
+        7: 1,  # 'k'
+        6: 2,  # 'l'
+        13: 2,  # 'm'
+        4: 2,  # 'n'
+        8: 0,  # 'o'
+        23: 1,  # 'p'
+        10: 2,  # 'r'
+        5: 2,  # 's'
+        3: 1,  # 't'
+        21: 2,  # 'u'
+        19: 1,  # 'v'
+        62: 1,  # 'x'
+        16: 0,  # 'y'
+        11: 3,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 0,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 1,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    50: {  # 'F'
+        28: 1,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 1,  # 'E'
+        50: 1,  # 'F'
+        49: 0,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 1,  # 'O'
+        46: 0,  # 'P'
+        43: 1,  # 'R'
+        33: 0,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 0,  # 'V'
+        55: 1,  # 'Y'
+        52: 0,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 2,  # 'e'
+        27: 1,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 2,  # 'i'
+        22: 1,  # 'j'
+        7: 0,  # 'k'
+        6: 1,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        8: 2,  # 'o'
+        23: 0,  # 'p'
+        10: 2,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 1,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 0,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 0,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 1,  # 'á'
+        15: 1,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 2,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 1,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    49: {  # 'G'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 1,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 2,  # 'Y'
+        52: 1,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 2,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 1,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 1,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        8: 2,  # 'o'
+        23: 0,  # 'p'
+        10: 2,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 1,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 2,  # 'y'
+        11: 0,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 1,  # 'á'
+        15: 1,  # 'é'
+        30: 0,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 1,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    38: {  # 'H'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 0,  # 'D'
+        32: 1,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 1,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 1,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 1,  # 'O'
+        46: 0,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 0,  # 'V'
+        55: 1,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 2,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 2,  # 'i'
+        22: 1,  # 'j'
+        7: 0,  # 'k'
+        6: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 0,  # 'n'
+        8: 3,  # 'o'
+        23: 0,  # 'p'
+        10: 1,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 2,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 0,  # 'z'
+        51: 2,  # 'Á'
+        44: 2,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 2,  # 'á'
+        15: 1,  # 'é'
+        30: 2,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 1,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    39: {  # 'I'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 1,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 2,  # 'K'
+        41: 2,  # 'L'
+        34: 1,  # 'M'
+        35: 2,  # 'N'
+        47: 1,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 2,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 2,  # 'Z'
+        2: 0,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 2,  # 'd'
+        1: 0,  # 'e'
+        27: 1,  # 'f'
+        12: 2,  # 'g'
+        20: 1,  # 'h'
+        9: 0,  # 'i'
+        22: 1,  # 'j'
+        7: 1,  # 'k'
+        6: 2,  # 'l'
+        13: 2,  # 'm'
+        4: 1,  # 'n'
+        8: 0,  # 'o'
+        23: 1,  # 'p'
+        10: 2,  # 'r'
+        5: 2,  # 's'
+        3: 2,  # 't'
+        21: 0,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 1,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 0,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    53: {  # 'J'
+        28: 2,  # 'A'
+        40: 0,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 1,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 1,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 2,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 1,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        8: 1,  # 'o'
+        23: 0,  # 'p'
+        10: 0,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 2,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 0,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 0,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 2,  # 'á'
+        15: 1,  # 'é'
+        30: 0,  # 'í'
+        25: 2,  # 'ó'
+        24: 2,  # 'ö'
+        31: 1,  # 'ú'
+        29: 0,  # 'ü'
+        42: 1,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    36: {  # 'K'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 0,  # 'G'
+        38: 1,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 2,  # 'O'
+        46: 0,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 0,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 2,  # 'e'
+        27: 1,  # 'f'
+        12: 0,  # 'g'
+        20: 1,  # 'h'
+        9: 3,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        8: 2,  # 'o'
+        23: 0,  # 'p'
+        10: 2,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 1,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 0,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 2,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 2,  # 'á'
+        15: 2,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 2,  # 'ö'
+        31: 1,  # 'ú'
+        29: 2,  # 'ü'
+        42: 1,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    41: {  # 'L'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 2,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 2,  # 'O'
+        46: 0,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 2,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 1,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 3,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 2,  # 'i'
+        22: 1,  # 'j'
+        7: 0,  # 'k'
+        6: 1,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        8: 2,  # 'o'
+        23: 0,  # 'p'
+        10: 0,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 2,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 0,  # 'z'
+        51: 2,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 2,  # 'á'
+        15: 1,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 0,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    34: {  # 'M'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 0,  # 'G'
+        38: 1,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 1,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 1,  # 'Z'
+        2: 3,  # 'a'
+        18: 0,  # 'b'
+        26: 1,  # 'c'
+        17: 0,  # 'd'
+        1: 3,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 3,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 0,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        8: 3,  # 'o'
+        23: 0,  # 'p'
+        10: 1,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 2,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 0,  # 'z'
+        51: 2,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 2,  # 'á'
+        15: 2,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    35: {  # 'N'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 2,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 1,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 2,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 2,  # 'Y'
+        52: 1,  # 'Z'
+        2: 3,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 3,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 2,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 1,  # 'n'
+        8: 2,  # 'o'
+        23: 0,  # 'p'
+        10: 0,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 1,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 2,  # 'y'
+        11: 0,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 1,  # 'á'
+        15: 2,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 1,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    47: {  # 'O'
+        28: 1,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 1,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 2,  # 'K'
+        41: 2,  # 'L'
+        34: 2,  # 'M'
+        35: 2,  # 'N'
+        47: 1,  # 'O'
+        46: 1,  # 'P'
+        43: 2,  # 'R'
+        33: 2,  # 'S'
+        37: 2,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 1,  # 'Z'
+        2: 0,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 1,  # 'd'
+        1: 1,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 1,  # 'h'
+        9: 1,  # 'i'
+        22: 1,  # 'j'
+        7: 2,  # 'k'
+        6: 2,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        8: 1,  # 'o'
+        23: 1,  # 'p'
+        10: 2,  # 'r'
+        5: 1,  # 's'
+        3: 2,  # 't'
+        21: 1,  # 'u'
+        19: 0,  # 'v'
+        62: 1,  # 'x'
+        16: 0,  # 'y'
+        11: 1,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 0,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    46: {  # 'P'
+        28: 1,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 1,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 0,  # 'M'
+        35: 1,  # 'N'
+        47: 1,  # 'O'
+        46: 1,  # 'P'
+        43: 2,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 1,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 2,  # 'e'
+        27: 1,  # 'f'
+        12: 0,  # 'g'
+        20: 1,  # 'h'
+        9: 2,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 1,  # 'l'
+        13: 0,  # 'm'
+        4: 1,  # 'n'
+        8: 2,  # 'o'
+        23: 0,  # 'p'
+        10: 2,  # 'r'
+        5: 1,  # 's'
+        3: 0,  # 't'
+        21: 1,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 0,  # 'z'
+        51: 2,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 3,  # 'á'
+        15: 2,  # 'é'
+        30: 0,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 0,  # 'ú'
+        29: 1,  # 'ü'
+        42: 1,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    43: {  # 'R'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 2,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 2,  # 'S'
+        37: 2,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 1,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 2,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 1,  # 'h'
+        9: 2,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        8: 2,  # 'o'
+        23: 0,  # 'p'
+        10: 0,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 1,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 0,  # 'z'
+        51: 2,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 2,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 2,  # 'á'
+        15: 2,  # 'é'
+        30: 1,  # 'í'
+        25: 2,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    33: {  # 'S'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 2,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 2,  # 'S'
+        37: 2,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 3,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 1,  # 'c'
+        17: 0,  # 'd'
+        1: 2,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 1,  # 'h'
+        9: 2,  # 'i'
+        22: 0,  # 'j'
+        7: 1,  # 'k'
+        6: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 0,  # 'n'
+        8: 2,  # 'o'
+        23: 1,  # 'p'
+        10: 0,  # 'r'
+        5: 0,  # 's'
+        3: 1,  # 't'
+        21: 1,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 3,  # 'z'
+        51: 2,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 2,  # 'á'
+        15: 1,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 1,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    37: {  # 'T'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 2,  # 'O'
+        46: 1,  # 'P'
+        43: 2,  # 'R'
+        33: 1,  # 'S'
+        37: 2,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 1,  # 'Z'
+        2: 2,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 2,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 1,  # 'h'
+        9: 2,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        8: 2,  # 'o'
+        23: 0,  # 'p'
+        10: 1,  # 'r'
+        5: 1,  # 's'
+        3: 0,  # 't'
+        21: 2,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 1,  # 'z'
+        51: 2,  # 'Á'
+        44: 2,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 2,  # 'á'
+        15: 1,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 2,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 1,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    57: {  # 'U'
+        28: 1,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 1,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 1,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 2,  # 'S'
+        37: 1,  # 'T'
+        57: 0,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 1,  # 'Z'
+        2: 0,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 1,  # 'd'
+        1: 1,  # 'e'
+        27: 0,  # 'f'
+        12: 2,  # 'g'
+        20: 0,  # 'h'
+        9: 0,  # 'i'
+        22: 1,  # 'j'
+        7: 1,  # 'k'
+        6: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        8: 0,  # 'o'
+        23: 1,  # 'p'
+        10: 1,  # 'r'
+        5: 1,  # 's'
+        3: 1,  # 't'
+        21: 0,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 1,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 1,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    48: {  # 'V'
+        28: 2,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 0,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 1,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 2,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 2,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 1,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        8: 2,  # 'o'
+        23: 0,  # 'p'
+        10: 0,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 1,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 0,  # 'z'
+        51: 2,  # 'Á'
+        44: 2,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 2,  # 'á'
+        15: 2,  # 'é'
+        30: 1,  # 'í'
+        25: 0,  # 'ó'
+        24: 1,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    55: {  # 'Y'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 1,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 2,  # 'Z'
+        2: 1,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 1,  # 'd'
+        1: 1,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 0,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        8: 1,  # 'o'
+        23: 1,  # 'p'
+        10: 0,  # 'r'
+        5: 0,  # 's'
+        3: 0,  # 't'
+        21: 0,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 0,  # 'z'
+        51: 1,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    52: {  # 'Z'
+        28: 2,  # 'A'
+        40: 1,  # 'B'
+        54: 0,  # 'C'
+        45: 1,  # 'D'
+        32: 2,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 2,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 2,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 2,  # 'S'
+        37: 1,  # 'T'
+        57: 1,  # 'U'
+        48: 1,  # 'V'
+        55: 1,  # 'Y'
+        52: 1,  # 'Z'
+        2: 1,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 1,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 1,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 1,  # 'n'
+        8: 1,  # 'o'
+        23: 0,  # 'p'
+        10: 1,  # 'r'
+        5: 2,  # 's'
+        3: 0,  # 't'
+        21: 1,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 0,  # 'z'
+        51: 2,  # 'Á'
+        44: 1,  # 'É'
+        61: 1,  # 'Í'
+        58: 1,  # 'Ó'
+        59: 1,  # 'Ö'
+        60: 1,  # 'Ú'
+        63: 1,  # 'Ü'
+        14: 1,  # 'á'
+        15: 1,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    2: {  # 'a'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 1,  # 'a'
+        18: 3,  # 'b'
+        26: 3,  # 'c'
+        17: 3,  # 'd'
+        1: 2,  # 'e'
+        27: 2,  # 'f'
+        12: 3,  # 'g'
+        20: 3,  # 'h'
+        9: 3,  # 'i'
+        22: 3,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 2,  # 'o'
+        23: 3,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 3,  # 'v'
+        62: 1,  # 'x'
+        16: 2,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 1,  # 'á'
+        15: 1,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    18: {  # 'b'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 3,  # 'b'
+        26: 1,  # 'c'
+        17: 1,  # 'd'
+        1: 3,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 1,  # 'h'
+        9: 3,  # 'i'
+        22: 2,  # 'j'
+        7: 2,  # 'k'
+        6: 2,  # 'l'
+        13: 1,  # 'm'
+        4: 2,  # 'n'
+        8: 3,  # 'o'
+        23: 1,  # 'p'
+        10: 3,  # 'r'
+        5: 2,  # 's'
+        3: 1,  # 't'
+        21: 3,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 1,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 2,  # 'í'
+        25: 3,  # 'ó'
+        24: 2,  # 'ö'
+        31: 2,  # 'ú'
+        29: 2,  # 'ü'
+        42: 2,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    26: {  # 'c'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 1,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 1,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 2,  # 'a'
+        18: 1,  # 'b'
+        26: 2,  # 'c'
+        17: 1,  # 'd'
+        1: 3,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 3,  # 'h'
+        9: 3,  # 'i'
+        22: 1,  # 'j'
+        7: 2,  # 'k'
+        6: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        8: 3,  # 'o'
+        23: 1,  # 'p'
+        10: 2,  # 'r'
+        5: 3,  # 's'
+        3: 2,  # 't'
+        21: 2,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 2,  # 'á'
+        15: 2,  # 'é'
+        30: 2,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    17: {  # 'd'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 2,  # 'b'
+        26: 1,  # 'c'
+        17: 2,  # 'd'
+        1: 3,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 2,  # 'h'
+        9: 3,  # 'i'
+        22: 3,  # 'j'
+        7: 2,  # 'k'
+        6: 1,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        8: 3,  # 'o'
+        23: 1,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 3,  # 'v'
+        62: 0,  # 'x'
+        16: 2,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 3,  # 'í'
+        25: 3,  # 'ó'
+        24: 3,  # 'ö'
+        31: 2,  # 'ú'
+        29: 2,  # 'ü'
+        42: 2,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    1: {  # 'e'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 2,  # 'a'
+        18: 3,  # 'b'
+        26: 3,  # 'c'
+        17: 3,  # 'd'
+        1: 2,  # 'e'
+        27: 3,  # 'f'
+        12: 3,  # 'g'
+        20: 3,  # 'h'
+        9: 3,  # 'i'
+        22: 3,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 2,  # 'o'
+        23: 3,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 2,  # 'u'
+        19: 3,  # 'v'
+        62: 2,  # 'x'
+        16: 2,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 1,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    27: {  # 'f'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 1,  # 'd'
+        1: 3,  # 'e'
+        27: 2,  # 'f'
+        12: 1,  # 'g'
+        20: 1,  # 'h'
+        9: 3,  # 'i'
+        22: 2,  # 'j'
+        7: 1,  # 'k'
+        6: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        8: 3,  # 'o'
+        23: 0,  # 'p'
+        10: 3,  # 'r'
+        5: 1,  # 's'
+        3: 1,  # 't'
+        21: 2,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 0,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 3,  # 'ö'
+        31: 1,  # 'ú'
+        29: 2,  # 'ü'
+        42: 1,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    12: {  # 'g'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 3,  # 'b'
+        26: 2,  # 'c'
+        17: 2,  # 'd'
+        1: 3,  # 'e'
+        27: 2,  # 'f'
+        12: 3,  # 'g'
+        20: 3,  # 'h'
+        9: 3,  # 'i'
+        22: 3,  # 'j'
+        7: 2,  # 'k'
+        6: 3,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        8: 3,  # 'o'
+        23: 1,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 3,  # 'v'
+        62: 0,  # 'x'
+        16: 3,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 2,  # 'í'
+        25: 3,  # 'ó'
+        24: 2,  # 'ö'
+        31: 2,  # 'ú'
+        29: 2,  # 'ü'
+        42: 2,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    20: {  # 'h'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 0,  # 'd'
+        1: 3,  # 'e'
+        27: 0,  # 'f'
+        12: 1,  # 'g'
+        20: 2,  # 'h'
+        9: 3,  # 'i'
+        22: 1,  # 'j'
+        7: 1,  # 'k'
+        6: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        8: 3,  # 'o'
+        23: 0,  # 'p'
+        10: 1,  # 'r'
+        5: 2,  # 's'
+        3: 1,  # 't'
+        21: 3,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 2,  # 'y'
+        11: 0,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 3,  # 'í'
+        25: 2,  # 'ó'
+        24: 2,  # 'ö'
+        31: 2,  # 'ú'
+        29: 1,  # 'ü'
+        42: 1,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    9: {  # 'i'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 3,  # 'b'
+        26: 3,  # 'c'
+        17: 3,  # 'd'
+        1: 3,  # 'e'
+        27: 3,  # 'f'
+        12: 3,  # 'g'
+        20: 3,  # 'h'
+        9: 2,  # 'i'
+        22: 2,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 2,  # 'o'
+        23: 2,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 3,  # 'v'
+        62: 1,  # 'x'
+        16: 1,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 2,  # 'é'
+        30: 1,  # 'í'
+        25: 3,  # 'ó'
+        24: 1,  # 'ö'
+        31: 2,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    22: {  # 'j'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 2,  # 'b'
+        26: 1,  # 'c'
+        17: 3,  # 'd'
+        1: 3,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 2,  # 'h'
+        9: 1,  # 'i'
+        22: 2,  # 'j'
+        7: 2,  # 'k'
+        6: 2,  # 'l'
+        13: 1,  # 'm'
+        4: 2,  # 'n'
+        8: 3,  # 'o'
+        23: 1,  # 'p'
+        10: 2,  # 'r'
+        5: 2,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 1,  # 'í'
+        25: 3,  # 'ó'
+        24: 3,  # 'ö'
+        31: 3,  # 'ú'
+        29: 2,  # 'ü'
+        42: 1,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    7: {  # 'k'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 3,  # 'b'
+        26: 2,  # 'c'
+        17: 1,  # 'd'
+        1: 3,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 2,  # 'h'
+        9: 3,  # 'i'
+        22: 2,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 1,  # 'm'
+        4: 3,  # 'n'
+        8: 3,  # 'o'
+        23: 1,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 2,  # 'v'
+        62: 0,  # 'x'
+        16: 2,  # 'y'
+        11: 1,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 3,  # 'í'
+        25: 2,  # 'ó'
+        24: 3,  # 'ö'
+        31: 1,  # 'ú'
+        29: 3,  # 'ü'
+        42: 1,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    6: {  # 'l'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 1,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 1,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 2,  # 'b'
+        26: 3,  # 'c'
+        17: 3,  # 'd'
+        1: 3,  # 'e'
+        27: 3,  # 'f'
+        12: 3,  # 'g'
+        20: 3,  # 'h'
+        9: 3,  # 'i'
+        22: 3,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 3,  # 'o'
+        23: 2,  # 'p'
+        10: 2,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 3,  # 'v'
+        62: 0,  # 'x'
+        16: 3,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 3,  # 'í'
+        25: 3,  # 'ó'
+        24: 3,  # 'ö'
+        31: 2,  # 'ú'
+        29: 2,  # 'ü'
+        42: 3,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    13: {  # 'm'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 3,  # 'b'
+        26: 2,  # 'c'
+        17: 1,  # 'd'
+        1: 3,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 2,  # 'h'
+        9: 3,  # 'i'
+        22: 2,  # 'j'
+        7: 1,  # 'k'
+        6: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 2,  # 'n'
+        8: 3,  # 'o'
+        23: 3,  # 'p'
+        10: 2,  # 'r'
+        5: 2,  # 's'
+        3: 2,  # 't'
+        21: 3,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 2,  # 'í'
+        25: 2,  # 'ó'
+        24: 2,  # 'ö'
+        31: 2,  # 'ú'
+        29: 2,  # 'ü'
+        42: 1,  # 'ő'
+        56: 2,  # 'ű'
+    },
+    4: {  # 'n'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 3,  # 'b'
+        26: 3,  # 'c'
+        17: 3,  # 'd'
+        1: 3,  # 'e'
+        27: 2,  # 'f'
+        12: 3,  # 'g'
+        20: 3,  # 'h'
+        9: 3,  # 'i'
+        22: 2,  # 'j'
+        7: 3,  # 'k'
+        6: 2,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        8: 3,  # 'o'
+        23: 2,  # 'p'
+        10: 2,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 2,  # 'v'
+        62: 1,  # 'x'
+        16: 3,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 2,  # 'í'
+        25: 2,  # 'ó'
+        24: 3,  # 'ö'
+        31: 2,  # 'ú'
+        29: 3,  # 'ü'
+        42: 2,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    8: {  # 'o'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 1,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 2,  # 'a'
+        18: 3,  # 'b'
+        26: 3,  # 'c'
+        17: 3,  # 'd'
+        1: 2,  # 'e'
+        27: 2,  # 'f'
+        12: 3,  # 'g'
+        20: 3,  # 'h'
+        9: 2,  # 'i'
+        22: 2,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 1,  # 'o'
+        23: 3,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 2,  # 'u'
+        19: 3,  # 'v'
+        62: 1,  # 'x'
+        16: 1,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 1,  # 'á'
+        15: 2,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    23: {  # 'p'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 1,  # 'b'
+        26: 2,  # 'c'
+        17: 1,  # 'd'
+        1: 3,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 2,  # 'h'
+        9: 3,  # 'i'
+        22: 2,  # 'j'
+        7: 2,  # 'k'
+        6: 3,  # 'l'
+        13: 1,  # 'm'
+        4: 2,  # 'n'
+        8: 3,  # 'o'
+        23: 3,  # 'p'
+        10: 3,  # 'r'
+        5: 2,  # 's'
+        3: 2,  # 't'
+        21: 3,  # 'u'
+        19: 2,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 2,  # 'í'
+        25: 2,  # 'ó'
+        24: 2,  # 'ö'
+        31: 1,  # 'ú'
+        29: 2,  # 'ü'
+        42: 1,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    10: {  # 'r'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 3,  # 'b'
+        26: 3,  # 'c'
+        17: 3,  # 'd'
+        1: 3,  # 'e'
+        27: 2,  # 'f'
+        12: 3,  # 'g'
+        20: 2,  # 'h'
+        9: 3,  # 'i'
+        22: 3,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 3,  # 'o'
+        23: 2,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 3,  # 'v'
+        62: 1,  # 'x'
+        16: 2,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 2,  # 'í'
+        25: 3,  # 'ó'
+        24: 3,  # 'ö'
+        31: 3,  # 'ú'
+        29: 3,  # 'ü'
+        42: 2,  # 'ő'
+        56: 2,  # 'ű'
+    },
+    5: {  # 's'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 3,  # 'b'
+        26: 2,  # 'c'
+        17: 2,  # 'd'
+        1: 3,  # 'e'
+        27: 2,  # 'f'
+        12: 2,  # 'g'
+        20: 2,  # 'h'
+        9: 3,  # 'i'
+        22: 1,  # 'j'
+        7: 3,  # 'k'
+        6: 2,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 3,  # 'o'
+        23: 2,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 2,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 3,  # 'í'
+        25: 3,  # 'ó'
+        24: 3,  # 'ö'
+        31: 3,  # 'ú'
+        29: 3,  # 'ü'
+        42: 2,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    3: {  # 't'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 3,  # 'b'
+        26: 2,  # 'c'
+        17: 1,  # 'd'
+        1: 3,  # 'e'
+        27: 2,  # 'f'
+        12: 1,  # 'g'
+        20: 3,  # 'h'
+        9: 3,  # 'i'
+        22: 3,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        8: 3,  # 'o'
+        23: 1,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 3,  # 'v'
+        62: 0,  # 'x'
+        16: 3,  # 'y'
+        11: 1,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 2,  # 'í'
+        25: 3,  # 'ó'
+        24: 3,  # 'ö'
+        31: 3,  # 'ú'
+        29: 3,  # 'ü'
+        42: 3,  # 'ő'
+        56: 2,  # 'ű'
+    },
+    21: {  # 'u'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 1,  # 'a'
+        18: 2,  # 'b'
+        26: 2,  # 'c'
+        17: 3,  # 'd'
+        1: 2,  # 'e'
+        27: 1,  # 'f'
+        12: 3,  # 'g'
+        20: 2,  # 'h'
+        9: 2,  # 'i'
+        22: 2,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 1,  # 'o'
+        23: 2,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 1,  # 'u'
+        19: 3,  # 'v'
+        62: 1,  # 'x'
+        16: 1,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 2,  # 'á'
+        15: 1,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 0,  # 'ö'
+        31: 1,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    19: {  # 'v'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 2,  # 'b'
+        26: 1,  # 'c'
+        17: 1,  # 'd'
+        1: 3,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 1,  # 'h'
+        9: 3,  # 'i'
+        22: 1,  # 'j'
+        7: 1,  # 'k'
+        6: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        8: 3,  # 'o'
+        23: 1,  # 'p'
+        10: 1,  # 'r'
+        5: 2,  # 's'
+        3: 2,  # 't'
+        21: 2,  # 'u'
+        19: 2,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 1,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 2,  # 'í'
+        25: 2,  # 'ó'
+        24: 2,  # 'ö'
+        31: 1,  # 'ú'
+        29: 2,  # 'ü'
+        42: 1,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    62: {  # 'x'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 1,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 0,  # 'd'
+        1: 1,  # 'e'
+        27: 1,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 1,  # 'i'
+        22: 0,  # 'j'
+        7: 1,  # 'k'
+        6: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        8: 1,  # 'o'
+        23: 1,  # 'p'
+        10: 1,  # 'r'
+        5: 1,  # 's'
+        3: 1,  # 't'
+        21: 1,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 0,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 1,  # 'á'
+        15: 1,  # 'é'
+        30: 1,  # 'í'
+        25: 1,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    16: {  # 'y'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 2,  # 'b'
+        26: 1,  # 'c'
+        17: 1,  # 'd'
+        1: 3,  # 'e'
+        27: 2,  # 'f'
+        12: 2,  # 'g'
+        20: 2,  # 'h'
+        9: 3,  # 'i'
+        22: 2,  # 'j'
+        7: 2,  # 'k'
+        6: 2,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        8: 3,  # 'o'
+        23: 2,  # 'p'
+        10: 2,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 3,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 2,  # 'í'
+        25: 2,  # 'ó'
+        24: 3,  # 'ö'
+        31: 2,  # 'ú'
+        29: 2,  # 'ü'
+        42: 1,  # 'ő'
+        56: 2,  # 'ű'
+    },
+    11: {  # 'z'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 3,  # 'a'
+        18: 2,  # 'b'
+        26: 1,  # 'c'
+        17: 3,  # 'd'
+        1: 3,  # 'e'
+        27: 1,  # 'f'
+        12: 2,  # 'g'
+        20: 2,  # 'h'
+        9: 3,  # 'i'
+        22: 1,  # 'j'
+        7: 3,  # 'k'
+        6: 2,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 3,  # 'o'
+        23: 1,  # 'p'
+        10: 2,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 3,  # 'u'
+        19: 2,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 3,  # 'á'
+        15: 3,  # 'é'
+        30: 3,  # 'í'
+        25: 3,  # 'ó'
+        24: 3,  # 'ö'
+        31: 2,  # 'ú'
+        29: 3,  # 'ü'
+        42: 2,  # 'ő'
+        56: 1,  # 'ű'
+    },
+    51: {  # 'Á'
+        28: 0,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 0,  # 'E'
+        50: 1,  # 'F'
+        49: 2,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 2,  # 'L'
+        34: 1,  # 'M'
+        35: 2,  # 'N'
+        47: 0,  # 'O'
+        46: 1,  # 'P'
+        43: 2,  # 'R'
+        33: 2,  # 'S'
+        37: 1,  # 'T'
+        57: 0,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 1,  # 'Z'
+        2: 0,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 1,  # 'd'
+        1: 0,  # 'e'
+        27: 0,  # 'f'
+        12: 1,  # 'g'
+        20: 1,  # 'h'
+        9: 0,  # 'i'
+        22: 1,  # 'j'
+        7: 1,  # 'k'
+        6: 2,  # 'l'
+        13: 2,  # 'm'
+        4: 0,  # 'n'
+        8: 0,  # 'o'
+        23: 1,  # 'p'
+        10: 1,  # 'r'
+        5: 1,  # 's'
+        3: 1,  # 't'
+        21: 0,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 1,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 1,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    44: {  # 'É'
+        28: 0,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 1,  # 'E'
+        50: 0,  # 'F'
+        49: 2,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 2,  # 'L'
+        34: 1,  # 'M'
+        35: 2,  # 'N'
+        47: 0,  # 'O'
+        46: 1,  # 'P'
+        43: 2,  # 'R'
+        33: 2,  # 'S'
+        37: 2,  # 'T'
+        57: 0,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 1,  # 'Z'
+        2: 0,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 1,  # 'd'
+        1: 0,  # 'e'
+        27: 0,  # 'f'
+        12: 1,  # 'g'
+        20: 1,  # 'h'
+        9: 0,  # 'i'
+        22: 1,  # 'j'
+        7: 1,  # 'k'
+        6: 2,  # 'l'
+        13: 1,  # 'm'
+        4: 2,  # 'n'
+        8: 0,  # 'o'
+        23: 1,  # 'p'
+        10: 2,  # 'r'
+        5: 3,  # 's'
+        3: 1,  # 't'
+        21: 0,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 0,  # 'z'
+        51: 0,  # 'Á'
+        44: 1,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    61: {  # 'Í'
+        28: 0,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 0,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 1,  # 'J'
+        36: 0,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 0,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 0,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 1,  # 'Z'
+        2: 0,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 0,  # 'e'
+        27: 0,  # 'f'
+        12: 2,  # 'g'
+        20: 0,  # 'h'
+        9: 0,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 0,  # 'l'
+        13: 1,  # 'm'
+        4: 0,  # 'n'
+        8: 0,  # 'o'
+        23: 0,  # 'p'
+        10: 1,  # 'r'
+        5: 0,  # 's'
+        3: 1,  # 't'
+        21: 0,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 1,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    58: {  # 'Ó'
+        28: 1,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 0,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 1,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 2,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 0,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 0,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 1,  # 'Z'
+        2: 0,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 1,  # 'd'
+        1: 0,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 2,  # 'h'
+        9: 0,  # 'i'
+        22: 0,  # 'j'
+        7: 1,  # 'k'
+        6: 1,  # 'l'
+        13: 0,  # 'm'
+        4: 1,  # 'n'
+        8: 0,  # 'o'
+        23: 1,  # 'p'
+        10: 1,  # 'r'
+        5: 1,  # 's'
+        3: 0,  # 't'
+        21: 0,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 1,  # 'z'
+        51: 0,  # 'Á'
+        44: 1,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    59: {  # 'Ö'
+        28: 0,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 0,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 0,  # 'O'
+        46: 1,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 0,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 1,  # 'Z'
+        2: 0,  # 'a'
+        18: 0,  # 'b'
+        26: 1,  # 'c'
+        17: 1,  # 'd'
+        1: 0,  # 'e'
+        27: 0,  # 'f'
+        12: 0,  # 'g'
+        20: 0,  # 'h'
+        9: 0,  # 'i'
+        22: 0,  # 'j'
+        7: 1,  # 'k'
+        6: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        8: 0,  # 'o'
+        23: 0,  # 'p'
+        10: 2,  # 'r'
+        5: 1,  # 's'
+        3: 1,  # 't'
+        21: 0,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 1,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    60: {  # 'Ú'
+        28: 0,  # 'A'
+        40: 1,  # 'B'
+        54: 1,  # 'C'
+        45: 1,  # 'D'
+        32: 0,  # 'E'
+        50: 1,  # 'F'
+        49: 1,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 0,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 1,  # 'Z'
+        2: 0,  # 'a'
+        18: 0,  # 'b'
+        26: 0,  # 'c'
+        17: 0,  # 'd'
+        1: 0,  # 'e'
+        27: 0,  # 'f'
+        12: 2,  # 'g'
+        20: 0,  # 'h'
+        9: 0,  # 'i'
+        22: 2,  # 'j'
+        7: 0,  # 'k'
+        6: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 1,  # 'n'
+        8: 0,  # 'o'
+        23: 0,  # 'p'
+        10: 1,  # 'r'
+        5: 1,  # 's'
+        3: 1,  # 't'
+        21: 0,  # 'u'
+        19: 0,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 0,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    63: {  # 'Ü'
+        28: 0,  # 'A'
+        40: 1,  # 'B'
+        54: 0,  # 'C'
+        45: 1,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 1,  # 'G'
+        38: 1,  # 'H'
+        39: 0,  # 'I'
+        53: 1,  # 'J'
+        36: 1,  # 'K'
+        41: 1,  # 'L'
+        34: 1,  # 'M'
+        35: 1,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 1,  # 'R'
+        33: 1,  # 'S'
+        37: 1,  # 'T'
+        57: 0,  # 'U'
+        48: 1,  # 'V'
+        55: 0,  # 'Y'
+        52: 1,  # 'Z'
+        2: 0,  # 'a'
+        18: 1,  # 'b'
+        26: 0,  # 'c'
+        17: 1,  # 'd'
+        1: 0,  # 'e'
+        27: 0,  # 'f'
+        12: 1,  # 'g'
+        20: 0,  # 'h'
+        9: 0,  # 'i'
+        22: 0,  # 'j'
+        7: 0,  # 'k'
+        6: 1,  # 'l'
+        13: 0,  # 'm'
+        4: 1,  # 'n'
+        8: 0,  # 'o'
+        23: 0,  # 'p'
+        10: 1,  # 'r'
+        5: 1,  # 's'
+        3: 1,  # 't'
+        21: 0,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 1,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    14: {  # 'á'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 1,  # 'a'
+        18: 3,  # 'b'
+        26: 3,  # 'c'
+        17: 3,  # 'd'
+        1: 1,  # 'e'
+        27: 2,  # 'f'
+        12: 3,  # 'g'
+        20: 2,  # 'h'
+        9: 2,  # 'i'
+        22: 3,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 1,  # 'o'
+        23: 2,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 2,  # 'u'
+        19: 3,  # 'v'
+        62: 0,  # 'x'
+        16: 1,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 1,  # 'á'
+        15: 2,  # 'é'
+        30: 1,  # 'í'
+        25: 0,  # 'ó'
+        24: 1,  # 'ö'
+        31: 0,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    15: {  # 'é'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 1,  # 'a'
+        18: 3,  # 'b'
+        26: 2,  # 'c'
+        17: 3,  # 'd'
+        1: 1,  # 'e'
+        27: 1,  # 'f'
+        12: 3,  # 'g'
+        20: 3,  # 'h'
+        9: 2,  # 'i'
+        22: 2,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 1,  # 'o'
+        23: 3,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 0,  # 'u'
+        19: 3,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 1,  # 'á'
+        15: 1,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    30: {  # 'í'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 0,  # 'a'
+        18: 1,  # 'b'
+        26: 2,  # 'c'
+        17: 1,  # 'd'
+        1: 0,  # 'e'
+        27: 1,  # 'f'
+        12: 3,  # 'g'
+        20: 0,  # 'h'
+        9: 0,  # 'i'
+        22: 1,  # 'j'
+        7: 1,  # 'k'
+        6: 2,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        8: 0,  # 'o'
+        23: 1,  # 'p'
+        10: 3,  # 'r'
+        5: 2,  # 's'
+        3: 3,  # 't'
+        21: 0,  # 'u'
+        19: 3,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    25: {  # 'ó'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 2,  # 'a'
+        18: 3,  # 'b'
+        26: 2,  # 'c'
+        17: 3,  # 'd'
+        1: 1,  # 'e'
+        27: 2,  # 'f'
+        12: 2,  # 'g'
+        20: 2,  # 'h'
+        9: 2,  # 'i'
+        22: 2,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        8: 1,  # 'o'
+        23: 2,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 1,  # 'u'
+        19: 2,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 1,  # 'á'
+        15: 1,  # 'é'
+        30: 1,  # 'í'
+        25: 0,  # 'ó'
+        24: 1,  # 'ö'
+        31: 1,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    24: {  # 'ö'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 0,  # 'a'
+        18: 3,  # 'b'
+        26: 1,  # 'c'
+        17: 2,  # 'd'
+        1: 0,  # 'e'
+        27: 1,  # 'f'
+        12: 2,  # 'g'
+        20: 1,  # 'h'
+        9: 0,  # 'i'
+        22: 1,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        8: 0,  # 'o'
+        23: 2,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 3,  # 't'
+        21: 0,  # 'u'
+        19: 3,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 3,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    31: {  # 'ú'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 1,  # 'a'
+        18: 1,  # 'b'
+        26: 2,  # 'c'
+        17: 1,  # 'd'
+        1: 1,  # 'e'
+        27: 2,  # 'f'
+        12: 3,  # 'g'
+        20: 1,  # 'h'
+        9: 1,  # 'i'
+        22: 3,  # 'j'
+        7: 1,  # 'k'
+        6: 3,  # 'l'
+        13: 1,  # 'm'
+        4: 2,  # 'n'
+        8: 0,  # 'o'
+        23: 1,  # 'p'
+        10: 3,  # 'r'
+        5: 3,  # 's'
+        3: 2,  # 't'
+        21: 1,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 1,  # 'á'
+        15: 1,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    29: {  # 'ü'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 1,  # 'a'
+        18: 1,  # 'b'
+        26: 1,  # 'c'
+        17: 2,  # 'd'
+        1: 1,  # 'e'
+        27: 1,  # 'f'
+        12: 3,  # 'g'
+        20: 2,  # 'h'
+        9: 1,  # 'i'
+        22: 1,  # 'j'
+        7: 3,  # 'k'
+        6: 3,  # 'l'
+        13: 1,  # 'm'
+        4: 3,  # 'n'
+        8: 0,  # 'o'
+        23: 1,  # 'p'
+        10: 2,  # 'r'
+        5: 2,  # 's'
+        3: 2,  # 't'
+        21: 0,  # 'u'
+        19: 2,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 1,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    42: {  # 'ő'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 1,  # 'a'
+        18: 2,  # 'b'
+        26: 1,  # 'c'
+        17: 2,  # 'd'
+        1: 1,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 1,  # 'h'
+        9: 1,  # 'i'
+        22: 1,  # 'j'
+        7: 2,  # 'k'
+        6: 3,  # 'l'
+        13: 1,  # 'm'
+        4: 2,  # 'n'
+        8: 1,  # 'o'
+        23: 1,  # 'p'
+        10: 2,  # 'r'
+        5: 2,  # 's'
+        3: 2,  # 't'
+        21: 1,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 1,  # 'é'
+        30: 1,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 1,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+    56: {  # 'ű'
+        28: 0,  # 'A'
+        40: 0,  # 'B'
+        54: 0,  # 'C'
+        45: 0,  # 'D'
+        32: 0,  # 'E'
+        50: 0,  # 'F'
+        49: 0,  # 'G'
+        38: 0,  # 'H'
+        39: 0,  # 'I'
+        53: 0,  # 'J'
+        36: 0,  # 'K'
+        41: 0,  # 'L'
+        34: 0,  # 'M'
+        35: 0,  # 'N'
+        47: 0,  # 'O'
+        46: 0,  # 'P'
+        43: 0,  # 'R'
+        33: 0,  # 'S'
+        37: 0,  # 'T'
+        57: 0,  # 'U'
+        48: 0,  # 'V'
+        55: 0,  # 'Y'
+        52: 0,  # 'Z'
+        2: 1,  # 'a'
+        18: 1,  # 'b'
+        26: 0,  # 'c'
+        17: 1,  # 'd'
+        1: 1,  # 'e'
+        27: 1,  # 'f'
+        12: 1,  # 'g'
+        20: 1,  # 'h'
+        9: 1,  # 'i'
+        22: 1,  # 'j'
+        7: 1,  # 'k'
+        6: 1,  # 'l'
+        13: 0,  # 'm'
+        4: 2,  # 'n'
+        8: 0,  # 'o'
+        23: 0,  # 'p'
+        10: 1,  # 'r'
+        5: 1,  # 's'
+        3: 1,  # 't'
+        21: 0,  # 'u'
+        19: 1,  # 'v'
+        62: 0,  # 'x'
+        16: 0,  # 'y'
+        11: 2,  # 'z'
+        51: 0,  # 'Á'
+        44: 0,  # 'É'
+        61: 0,  # 'Í'
+        58: 0,  # 'Ó'
+        59: 0,  # 'Ö'
+        60: 0,  # 'Ú'
+        63: 0,  # 'Ü'
+        14: 0,  # 'á'
+        15: 0,  # 'é'
+        30: 0,  # 'í'
+        25: 0,  # 'ó'
+        24: 0,  # 'ö'
+        31: 0,  # 'ú'
+        29: 0,  # 'ü'
+        42: 0,  # 'ő'
+        56: 0,  # 'ű'
+    },
+}
+
+# 255: Undefined characters that did not exist in training text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+# 251: Control characters
+
+# Character Mapping Table(s):
+WINDOWS_1250_HUNGARIAN_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 28,  # 'A'
+     66: 40,  # 'B'
+     67: 54,  # 'C'
+     68: 45,  # 'D'
+     69: 32,  # 'E'
+     70: 50,  # 'F'
+     71: 49,  # 'G'
+     72: 38,  # 'H'
+     73: 39,  # 'I'
+     74: 53,  # 'J'
+     75: 36,  # 'K'
+     76: 41,  # 'L'
+     77: 34,  # 'M'
+     78: 35,  # 'N'
+     79: 47,  # 'O'
+     80: 46,  # 'P'
+     81: 72,  # 'Q'
+     82: 43,  # 'R'
+     83: 33,  # 'S'
+     84: 37,  # 'T'
+     85: 57,  # 'U'
+     86: 48,  # 'V'
+     87: 64,  # 'W'
+     88: 68,  # 'X'
+     89: 55,  # 'Y'
+     90: 52,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 2,  # 'a'
+     98: 18,  # 'b'
+     99: 26,  # 'c'
+     100: 17,  # 'd'
+     101: 1,  # 'e'
+     102: 27,  # 'f'
+     103: 12,  # 'g'
+     104: 20,  # 'h'
+     105: 9,  # 'i'
+     106: 22,  # 'j'
+     107: 7,  # 'k'
+     108: 6,  # 'l'
+     109: 13,  # 'm'
+     110: 4,  # 'n'
+     111: 8,  # 'o'
+     112: 23,  # 'p'
+     113: 67,  # 'q'
+     114: 10,  # 'r'
+     115: 5,  # 's'
+     116: 3,  # 't'
+     117: 21,  # 'u'
+     118: 19,  # 'v'
+     119: 65,  # 'w'
+     120: 62,  # 'x'
+     121: 16,  # 'y'
+     122: 11,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 161,  # '€'
+     129: 162,  # None
+     130: 163,  # '‚'
+     131: 164,  # None
+     132: 165,  # '„'
+     133: 166,  # '…'
+     134: 167,  # '†'
+     135: 168,  # '‡'
+     136: 169,  # None
+     137: 170,  # '‰'
+     138: 171,  # 'Š'
+     139: 172,  # '‹'
+     140: 173,  # 'Ś'
+     141: 174,  # 'Ť'
+     142: 175,  # 'Ž'
+     143: 176,  # 'Ź'
+     144: 177,  # None
+     145: 178,  # '‘'
+     146: 179,  # '’'
+     147: 180,  # '“'
+     148: 78,  # '”'
+     149: 181,  # '•'
+     150: 69,  # '–'
+     151: 182,  # '—'
+     152: 183,  # None
+     153: 184,  # '™'
+     154: 185,  # 'š'
+     155: 186,  # '›'
+     156: 187,  # 'ś'
+     157: 188,  # 'ť'
+     158: 189,  # 'ž'
+     159: 190,  # 'ź'
+     160: 191,  # '\xa0'
+     161: 192,  # 'ˇ'
+     162: 193,  # '˘'
+     163: 194,  # 'Ł'
+     164: 195,  # '¤'
+     165: 196,  # 'Ą'
+     166: 197,  # '¦'
+     167: 76,  # '§'
+     168: 198,  # '¨'
+     169: 199,  # '©'
+     170: 200,  # 'Ş'
+     171: 201,  # '«'
+     172: 202,  # '¬'
+     173: 203,  # '\xad'
+     174: 204,  # '®'
+     175: 205,  # 'Ż'
+     176: 81,  # '°'
+     177: 206,  # '±'
+     178: 207,  # '˛'
+     179: 208,  # 'ł'
+     180: 209,  # '´'
+     181: 210,  # 'µ'
+     182: 211,  # '¶'
+     183: 212,  # '·'
+     184: 213,  # '¸'
+     185: 214,  # 'ą'
+     186: 215,  # 'ş'
+     187: 216,  # '»'
+     188: 217,  # 'Ľ'
+     189: 218,  # '˝'
+     190: 219,  # 'ľ'
+     191: 220,  # 'ż'
+     192: 221,  # 'Ŕ'
+     193: 51,  # 'Á'
+     194: 83,  # 'Â'
+     195: 222,  # 'Ă'
+     196: 80,  # 'Ä'
+     197: 223,  # 'Ĺ'
+     198: 224,  # 'Ć'
+     199: 225,  # 'Ç'
+     200: 226,  # 'Č'
+     201: 44,  # 'É'
+     202: 227,  # 'Ę'
+     203: 228,  # 'Ë'
+     204: 229,  # 'Ě'
+     205: 61,  # 'Í'
+     206: 230,  # 'Î'
+     207: 231,  # 'Ď'
+     208: 232,  # 'Đ'
+     209: 233,  # 'Ń'
+     210: 234,  # 'Ň'
+     211: 58,  # 'Ó'
+     212: 235,  # 'Ô'
+     213: 66,  # 'Ő'
+     214: 59,  # 'Ö'
+     215: 236,  # '×'
+     216: 237,  # 'Ř'
+     217: 238,  # 'Ů'
+     218: 60,  # 'Ú'
+     219: 70,  # 'Ű'
+     220: 63,  # 'Ü'
+     221: 239,  # 'Ý'
+     222: 240,  # 'Ţ'
+     223: 241,  # 'ß'
+     224: 84,  # 'ŕ'
+     225: 14,  # 'á'
+     226: 75,  # 'â'
+     227: 242,  # 'ă'
+     228: 71,  # 'ä'
+     229: 82,  # 'ĺ'
+     230: 243,  # 'ć'
+     231: 73,  # 'ç'
+     232: 244,  # 'č'
+     233: 15,  # 'é'
+     234: 85,  # 'ę'
+     235: 79,  # 'ë'
+     236: 86,  # 'ě'
+     237: 30,  # 'í'
+     238: 77,  # 'î'
+     239: 87,  # 'ď'
+     240: 245,  # 'đ'
+     241: 246,  # 'ń'
+     242: 247,  # 'ň'
+     243: 25,  # 'ó'
+     244: 74,  # 'ô'
+     245: 42,  # 'ő'
+     246: 24,  # 'ö'
+     247: 248,  # '÷'
+     248: 249,  # 'ř'
+     249: 250,  # 'ů'
+     250: 31,  # 'ú'
+     251: 56,  # 'ű'
+     252: 29,  # 'ü'
+     253: 251,  # 'ý'
+     254: 252,  # 'ţ'
+     255: 253,  # '˙'
+}
+
+WINDOWS_1250_HUNGARIAN_MODEL = SingleByteCharSetModel(charset_name='windows-1250',
+                                                      language='Hungarian',
+                                                      char_to_order_map=WINDOWS_1250_HUNGARIAN_CHAR_TO_ORDER,
+                                                      language_model=HUNGARIAN_LANG_MODEL,
+                                                      typical_positive_ratio=0.947368,
+                                                      keep_ascii_letters=True,
+                                                      alphabet='ABCDEFGHIJKLMNOPRSTUVZabcdefghijklmnoprstuvzÁÉÍÓÖÚÜáéíóöúüŐőŰű')
+
+ISO_8859_2_HUNGARIAN_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 28,  # 'A'
+     66: 40,  # 'B'
+     67: 54,  # 'C'
+     68: 45,  # 'D'
+     69: 32,  # 'E'
+     70: 50,  # 'F'
+     71: 49,  # 'G'
+     72: 38,  # 'H'
+     73: 39,  # 'I'
+     74: 53,  # 'J'
+     75: 36,  # 'K'
+     76: 41,  # 'L'
+     77: 34,  # 'M'
+     78: 35,  # 'N'
+     79: 47,  # 'O'
+     80: 46,  # 'P'
+     81: 71,  # 'Q'
+     82: 43,  # 'R'
+     83: 33,  # 'S'
+     84: 37,  # 'T'
+     85: 57,  # 'U'
+     86: 48,  # 'V'
+     87: 64,  # 'W'
+     88: 68,  # 'X'
+     89: 55,  # 'Y'
+     90: 52,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 2,  # 'a'
+     98: 18,  # 'b'
+     99: 26,  # 'c'
+     100: 17,  # 'd'
+     101: 1,  # 'e'
+     102: 27,  # 'f'
+     103: 12,  # 'g'
+     104: 20,  # 'h'
+     105: 9,  # 'i'
+     106: 22,  # 'j'
+     107: 7,  # 'k'
+     108: 6,  # 'l'
+     109: 13,  # 'm'
+     110: 4,  # 'n'
+     111: 8,  # 'o'
+     112: 23,  # 'p'
+     113: 67,  # 'q'
+     114: 10,  # 'r'
+     115: 5,  # 's'
+     116: 3,  # 't'
+     117: 21,  # 'u'
+     118: 19,  # 'v'
+     119: 65,  # 'w'
+     120: 62,  # 'x'
+     121: 16,  # 'y'
+     122: 11,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 159,  # '\x80'
+     129: 160,  # '\x81'
+     130: 161,  # '\x82'
+     131: 162,  # '\x83'
+     132: 163,  # '\x84'
+     133: 164,  # '\x85'
+     134: 165,  # '\x86'
+     135: 166,  # '\x87'
+     136: 167,  # '\x88'
+     137: 168,  # '\x89'
+     138: 169,  # '\x8a'
+     139: 170,  # '\x8b'
+     140: 171,  # '\x8c'
+     141: 172,  # '\x8d'
+     142: 173,  # '\x8e'
+     143: 174,  # '\x8f'
+     144: 175,  # '\x90'
+     145: 176,  # '\x91'
+     146: 177,  # '\x92'
+     147: 178,  # '\x93'
+     148: 179,  # '\x94'
+     149: 180,  # '\x95'
+     150: 181,  # '\x96'
+     151: 182,  # '\x97'
+     152: 183,  # '\x98'
+     153: 184,  # '\x99'
+     154: 185,  # '\x9a'
+     155: 186,  # '\x9b'
+     156: 187,  # '\x9c'
+     157: 188,  # '\x9d'
+     158: 189,  # '\x9e'
+     159: 190,  # '\x9f'
+     160: 191,  # '\xa0'
+     161: 192,  # 'Ą'
+     162: 193,  # '˘'
+     163: 194,  # 'Ł'
+     164: 195,  # '¤'
+     165: 196,  # 'Ľ'
+     166: 197,  # 'Ś'
+     167: 75,  # '§'
+     168: 198,  # '¨'
+     169: 199,  # 'Š'
+     170: 200,  # 'Ş'
+     171: 201,  # 'Ť'
+     172: 202,  # 'Ź'
+     173: 203,  # '\xad'
+     174: 204,  # 'Ž'
+     175: 205,  # 'Ż'
+     176: 79,  # '°'
+     177: 206,  # 'ą'
+     178: 207,  # '˛'
+     179: 208,  # 'ł'
+     180: 209,  # '´'
+     181: 210,  # 'ľ'
+     182: 211,  # 'ś'
+     183: 212,  # 'ˇ'
+     184: 213,  # '¸'
+     185: 214,  # 'š'
+     186: 215,  # 'ş'
+     187: 216,  # 'ť'
+     188: 217,  # 'ź'
+     189: 218,  # '˝'
+     190: 219,  # 'ž'
+     191: 220,  # 'ż'
+     192: 221,  # 'Ŕ'
+     193: 51,  # 'Á'
+     194: 81,  # 'Â'
+     195: 222,  # 'Ă'
+     196: 78,  # 'Ä'
+     197: 223,  # 'Ĺ'
+     198: 224,  # 'Ć'
+     199: 225,  # 'Ç'
+     200: 226,  # 'Č'
+     201: 44,  # 'É'
+     202: 227,  # 'Ę'
+     203: 228,  # 'Ë'
+     204: 229,  # 'Ě'
+     205: 61,  # 'Í'
+     206: 230,  # 'Î'
+     207: 231,  # 'Ď'
+     208: 232,  # 'Đ'
+     209: 233,  # 'Ń'
+     210: 234,  # 'Ň'
+     211: 58,  # 'Ó'
+     212: 235,  # 'Ô'
+     213: 66,  # 'Ő'
+     214: 59,  # 'Ö'
+     215: 236,  # '×'
+     216: 237,  # 'Ř'
+     217: 238,  # 'Ů'
+     218: 60,  # 'Ú'
+     219: 69,  # 'Ű'
+     220: 63,  # 'Ü'
+     221: 239,  # 'Ý'
+     222: 240,  # 'Ţ'
+     223: 241,  # 'ß'
+     224: 82,  # 'ŕ'
+     225: 14,  # 'á'
+     226: 74,  # 'â'
+     227: 242,  # 'ă'
+     228: 70,  # 'ä'
+     229: 80,  # 'ĺ'
+     230: 243,  # 'ć'
+     231: 72,  # 'ç'
+     232: 244,  # 'č'
+     233: 15,  # 'é'
+     234: 83,  # 'ę'
+     235: 77,  # 'ë'
+     236: 84,  # 'ě'
+     237: 30,  # 'í'
+     238: 76,  # 'î'
+     239: 85,  # 'ď'
+     240: 245,  # 'đ'
+     241: 246,  # 'ń'
+     242: 247,  # 'ň'
+     243: 25,  # 'ó'
+     244: 73,  # 'ô'
+     245: 42,  # 'ő'
+     246: 24,  # 'ö'
+     247: 248,  # '÷'
+     248: 249,  # 'ř'
+     249: 250,  # 'ů'
+     250: 31,  # 'ú'
+     251: 56,  # 'ű'
+     252: 29,  # 'ü'
+     253: 251,  # 'ý'
+     254: 252,  # 'ţ'
+     255: 253,  # '˙'
+}
+
+ISO_8859_2_HUNGARIAN_MODEL = SingleByteCharSetModel(charset_name='ISO-8859-2',
+                                                    language='Hungarian',
+                                                    char_to_order_map=ISO_8859_2_HUNGARIAN_CHAR_TO_ORDER,
+                                                    language_model=HUNGARIAN_LANG_MODEL,
+                                                    typical_positive_ratio=0.947368,
+                                                    keep_ascii_letters=True,
+                                                    alphabet='ABCDEFGHIJKLMNOPRSTUVZabcdefghijklmnoprstuvzÁÉÍÓÖÚÜáéíóöúüŐőŰű')
+
diff --git a/openpype/vendor/python/python_2/chardet/langrussianmodel.py b/openpype/vendor/python/python_2/chardet/langrussianmodel.py
new file mode 100644
index 0000000000..569689d0f5
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/langrussianmodel.py
@@ -0,0 +1,5718 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from chardet.sbcharsetprober import SingleByteCharSetModel
+
+
+# 3: Positive
+# 2: Likely
+# 1: Unlikely
+# 0: Negative
+
+RUSSIAN_LANG_MODEL = {
+    37: {  # 'А'
+        37: 0,  # 'А'
+        44: 1,  # 'Б'
+        33: 1,  # 'В'
+        46: 1,  # 'Г'
+        41: 1,  # 'Д'
+        48: 1,  # 'Е'
+        56: 1,  # 'Ж'
+        51: 1,  # 'З'
+        42: 1,  # 'И'
+        60: 1,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 2,  # 'Н'
+        34: 1,  # 'О'
+        35: 1,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 1,  # 'У'
+        53: 1,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 1,  # 'Ш'
+        63: 1,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 1,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 1,  # 'а'
+        21: 2,  # 'б'
+        10: 2,  # 'в'
+        19: 2,  # 'г'
+        13: 2,  # 'д'
+        2: 0,  # 'е'
+        24: 1,  # 'ж'
+        20: 1,  # 'з'
+        4: 0,  # 'и'
+        23: 1,  # 'й'
+        11: 2,  # 'к'
+        8: 3,  # 'л'
+        12: 2,  # 'м'
+        5: 2,  # 'н'
+        1: 0,  # 'о'
+        15: 2,  # 'п'
+        9: 2,  # 'р'
+        7: 2,  # 'с'
+        6: 2,  # 'т'
+        14: 2,  # 'у'
+        39: 2,  # 'ф'
+        26: 2,  # 'х'
+        28: 0,  # 'ц'
+        22: 1,  # 'ч'
+        25: 2,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 1,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    44: {  # 'Б'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 1,  # 'В'
+        46: 1,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 0,  # 'П'
+        45: 1,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 2,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 0,  # 'г'
+        13: 1,  # 'д'
+        2: 3,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 2,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 2,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 2,  # 'ы'
+        17: 1,  # 'ь'
+        30: 2,  # 'э'
+        27: 1,  # 'ю'
+        16: 1,  # 'я'
+    },
+    33: {  # 'В'
+        37: 2,  # 'А'
+        44: 0,  # 'Б'
+        33: 1,  # 'В'
+        46: 0,  # 'Г'
+        41: 1,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 1,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 1,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 1,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 2,  # 'а'
+        21: 1,  # 'б'
+        10: 1,  # 'в'
+        19: 1,  # 'г'
+        13: 2,  # 'д'
+        2: 3,  # 'е'
+        24: 0,  # 'ж'
+        20: 2,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 1,  # 'к'
+        8: 2,  # 'л'
+        12: 2,  # 'м'
+        5: 2,  # 'н'
+        1: 3,  # 'о'
+        15: 2,  # 'п'
+        9: 2,  # 'р'
+        7: 3,  # 'с'
+        6: 2,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 1,  # 'х'
+        28: 1,  # 'ц'
+        22: 2,  # 'ч'
+        25: 1,  # 'ш'
+        29: 0,  # 'щ'
+        54: 1,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 1,  # 'ь'
+        30: 2,  # 'э'
+        27: 0,  # 'ю'
+        16: 1,  # 'я'
+    },
+    46: {  # 'Г'
+        37: 1,  # 'А'
+        44: 1,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 1,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 1,  # 'П'
+        45: 1,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 2,  # 'а'
+        21: 0,  # 'б'
+        10: 1,  # 'в'
+        19: 0,  # 'г'
+        13: 2,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 2,  # 'л'
+        12: 1,  # 'м'
+        5: 1,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 2,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 1,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 0,  # 'я'
+    },
+    41: {  # 'Д'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 1,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 2,  # 'Е'
+        56: 1,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 0,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 0,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 1,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 3,  # 'а'
+        21: 0,  # 'б'
+        10: 2,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 3,  # 'ж'
+        20: 1,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 2,  # 'л'
+        12: 1,  # 'м'
+        5: 1,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 2,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 1,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 1,  # 'ы'
+        17: 1,  # 'ь'
+        30: 2,  # 'э'
+        27: 1,  # 'ю'
+        16: 1,  # 'я'
+    },
+    48: {  # 'Е'
+        37: 1,  # 'А'
+        44: 1,  # 'Б'
+        33: 1,  # 'В'
+        46: 1,  # 'Г'
+        41: 1,  # 'Д'
+        48: 1,  # 'Е'
+        56: 1,  # 'Ж'
+        51: 1,  # 'З'
+        42: 1,  # 'И'
+        60: 1,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 2,  # 'Н'
+        34: 1,  # 'О'
+        35: 1,  # 'П'
+        45: 2,  # 'Р'
+        32: 2,  # 'С'
+        40: 1,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 1,  # 'Ш'
+        63: 1,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 0,  # 'а'
+        21: 0,  # 'б'
+        10: 2,  # 'в'
+        19: 2,  # 'г'
+        13: 2,  # 'д'
+        2: 2,  # 'е'
+        24: 1,  # 'ж'
+        20: 1,  # 'з'
+        4: 0,  # 'и'
+        23: 2,  # 'й'
+        11: 1,  # 'к'
+        8: 2,  # 'л'
+        12: 2,  # 'м'
+        5: 1,  # 'н'
+        1: 0,  # 'о'
+        15: 1,  # 'п'
+        9: 1,  # 'р'
+        7: 3,  # 'с'
+        6: 0,  # 'т'
+        14: 0,  # 'у'
+        39: 1,  # 'ф'
+        26: 1,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 1,  # 'ш'
+        29: 2,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 1,  # 'ю'
+        16: 0,  # 'я'
+    },
+    56: {  # 'Ж'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 1,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 1,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 2,  # 'а'
+        21: 1,  # 'б'
+        10: 0,  # 'в'
+        19: 1,  # 'г'
+        13: 1,  # 'д'
+        2: 2,  # 'е'
+        24: 1,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 0,  # 'л'
+        12: 1,  # 'м'
+        5: 0,  # 'н'
+        1: 2,  # 'о'
+        15: 0,  # 'п'
+        9: 1,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 2,  # 'ю'
+        16: 0,  # 'я'
+    },
+    51: {  # 'З'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 1,  # 'В'
+        46: 1,  # 'Г'
+        41: 1,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 0,  # 'П'
+        45: 1,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 1,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 1,  # 'б'
+        10: 2,  # 'в'
+        19: 0,  # 'г'
+        13: 2,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 1,  # 'л'
+        12: 1,  # 'м'
+        5: 2,  # 'н'
+        1: 2,  # 'о'
+        15: 0,  # 'п'
+        9: 1,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 1,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 1,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 1,  # 'я'
+    },
+    42: {  # 'И'
+        37: 1,  # 'А'
+        44: 1,  # 'Б'
+        33: 1,  # 'В'
+        46: 1,  # 'Г'
+        41: 1,  # 'Д'
+        48: 2,  # 'Е'
+        56: 1,  # 'Ж'
+        51: 1,  # 'З'
+        42: 1,  # 'И'
+        60: 1,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 1,  # 'П'
+        45: 1,  # 'Р'
+        32: 2,  # 'С'
+        40: 1,  # 'Т'
+        52: 0,  # 'У'
+        53: 1,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 1,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 1,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 1,  # 'а'
+        21: 2,  # 'б'
+        10: 2,  # 'в'
+        19: 2,  # 'г'
+        13: 2,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 2,  # 'з'
+        4: 1,  # 'и'
+        23: 0,  # 'й'
+        11: 1,  # 'к'
+        8: 2,  # 'л'
+        12: 2,  # 'м'
+        5: 2,  # 'н'
+        1: 1,  # 'о'
+        15: 1,  # 'п'
+        9: 2,  # 'р'
+        7: 2,  # 'с'
+        6: 2,  # 'т'
+        14: 1,  # 'у'
+        39: 1,  # 'ф'
+        26: 2,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 1,  # 'ш'
+        29: 1,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 1,  # 'ю'
+        16: 0,  # 'я'
+    },
+    60: {  # 'Й'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 1,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 1,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 0,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 1,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 0,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 0,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 2,  # 'о'
+        15: 0,  # 'п'
+        9: 0,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 0,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    36: {  # 'К'
+        37: 2,  # 'А'
+        44: 0,  # 'Б'
+        33: 1,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 1,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 1,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 2,  # 'О'
+        35: 1,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 1,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 0,  # 'б'
+        10: 1,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 2,  # 'л'
+        12: 0,  # 'м'
+        5: 1,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 2,  # 'р'
+        7: 2,  # 'с'
+        6: 2,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 1,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 1,  # 'ы'
+        17: 1,  # 'ь'
+        30: 2,  # 'э'
+        27: 1,  # 'ю'
+        16: 0,  # 'я'
+    },
+    49: {  # 'Л'
+        37: 2,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 1,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 1,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 0,  # 'Н'
+        34: 1,  # 'О'
+        35: 1,  # 'П'
+        45: 0,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 1,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 1,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 2,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 1,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 1,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 1,  # 'л'
+        12: 0,  # 'м'
+        5: 1,  # 'н'
+        1: 2,  # 'о'
+        15: 0,  # 'п'
+        9: 0,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 1,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 1,  # 'ы'
+        17: 1,  # 'ь'
+        30: 2,  # 'э'
+        27: 2,  # 'ю'
+        16: 1,  # 'я'
+    },
+    38: {  # 'М'
+        37: 1,  # 'А'
+        44: 1,  # 'Б'
+        33: 1,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 1,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 1,  # 'У'
+        53: 1,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 1,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 3,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 1,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 1,  # 'л'
+        12: 1,  # 'м'
+        5: 2,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 1,  # 'р'
+        7: 1,  # 'с'
+        6: 0,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 1,  # 'ь'
+        30: 2,  # 'э'
+        27: 1,  # 'ю'
+        16: 1,  # 'я'
+    },
+    31: {  # 'Н'
+        37: 2,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 1,  # 'Г'
+        41: 1,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 1,  # 'З'
+        42: 2,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 0,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 1,  # 'У'
+        53: 1,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 1,  # 'Ь'
+        47: 1,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 3,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 3,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 0,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 1,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 3,  # 'у'
+        39: 0,  # 'ф'
+        26: 1,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 1,  # 'ы'
+        17: 2,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 1,  # 'я'
+    },
+    34: {  # 'О'
+        37: 0,  # 'А'
+        44: 1,  # 'Б'
+        33: 1,  # 'В'
+        46: 1,  # 'Г'
+        41: 2,  # 'Д'
+        48: 1,  # 'Е'
+        56: 1,  # 'Ж'
+        51: 1,  # 'З'
+        42: 1,  # 'И'
+        60: 1,  # 'Й'
+        36: 1,  # 'К'
+        49: 2,  # 'Л'
+        38: 1,  # 'М'
+        31: 2,  # 'Н'
+        34: 1,  # 'О'
+        35: 1,  # 'П'
+        45: 2,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 1,  # 'У'
+        53: 1,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 1,  # 'Ш'
+        63: 1,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 1,  # 'а'
+        21: 2,  # 'б'
+        10: 1,  # 'в'
+        19: 2,  # 'г'
+        13: 2,  # 'д'
+        2: 0,  # 'е'
+        24: 1,  # 'ж'
+        20: 1,  # 'з'
+        4: 0,  # 'и'
+        23: 1,  # 'й'
+        11: 2,  # 'к'
+        8: 2,  # 'л'
+        12: 1,  # 'м'
+        5: 3,  # 'н'
+        1: 0,  # 'о'
+        15: 2,  # 'п'
+        9: 2,  # 'р'
+        7: 2,  # 'с'
+        6: 2,  # 'т'
+        14: 1,  # 'у'
+        39: 1,  # 'ф'
+        26: 2,  # 'х'
+        28: 1,  # 'ц'
+        22: 2,  # 'ч'
+        25: 2,  # 'ш'
+        29: 1,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    35: {  # 'П'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 1,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 1,  # 'П'
+        45: 2,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 1,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 2,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 2,  # 'л'
+        12: 0,  # 'м'
+        5: 1,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 3,  # 'р'
+        7: 1,  # 'с'
+        6: 1,  # 'т'
+        14: 2,  # 'у'
+        39: 1,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 1,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 1,  # 'ы'
+        17: 2,  # 'ь'
+        30: 1,  # 'э'
+        27: 0,  # 'ю'
+        16: 2,  # 'я'
+    },
+    45: {  # 'Р'
+        37: 2,  # 'А'
+        44: 1,  # 'Б'
+        33: 1,  # 'В'
+        46: 1,  # 'Г'
+        41: 1,  # 'Д'
+        48: 2,  # 'Е'
+        56: 1,  # 'Ж'
+        51: 0,  # 'З'
+        42: 2,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 2,  # 'О'
+        35: 0,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 1,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 1,  # 'Ь'
+        47: 1,  # 'Э'
+        59: 1,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 3,  # 'а'
+        21: 0,  # 'б'
+        10: 1,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 1,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 0,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 1,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 2,  # 'ы'
+        17: 0,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 2,  # 'я'
+    },
+    32: {  # 'С'
+        37: 1,  # 'А'
+        44: 1,  # 'Б'
+        33: 1,  # 'В'
+        46: 1,  # 'Г'
+        41: 1,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 1,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 2,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 1,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 1,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 1,  # 'Ь'
+        47: 1,  # 'Э'
+        59: 1,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 2,  # 'а'
+        21: 1,  # 'б'
+        10: 2,  # 'в'
+        19: 1,  # 'г'
+        13: 2,  # 'д'
+        2: 3,  # 'е'
+        24: 1,  # 'ж'
+        20: 1,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 2,  # 'к'
+        8: 2,  # 'л'
+        12: 2,  # 'м'
+        5: 2,  # 'н'
+        1: 2,  # 'о'
+        15: 2,  # 'п'
+        9: 2,  # 'р'
+        7: 1,  # 'с'
+        6: 3,  # 'т'
+        14: 2,  # 'у'
+        39: 1,  # 'ф'
+        26: 1,  # 'х'
+        28: 1,  # 'ц'
+        22: 1,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 1,  # 'ъ'
+        18: 1,  # 'ы'
+        17: 1,  # 'ь'
+        30: 2,  # 'э'
+        27: 1,  # 'ю'
+        16: 1,  # 'я'
+    },
+    40: {  # 'Т'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 1,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 2,  # 'О'
+        35: 0,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 1,  # 'Ь'
+        47: 1,  # 'Э'
+        59: 1,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 3,  # 'а'
+        21: 1,  # 'б'
+        10: 2,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 3,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 1,  # 'к'
+        8: 1,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 2,  # 'р'
+        7: 1,  # 'с'
+        6: 0,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 1,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 1,  # 'ь'
+        30: 2,  # 'э'
+        27: 1,  # 'ю'
+        16: 1,  # 'я'
+    },
+    52: {  # 'У'
+        37: 1,  # 'А'
+        44: 1,  # 'Б'
+        33: 1,  # 'В'
+        46: 1,  # 'Г'
+        41: 1,  # 'Д'
+        48: 1,  # 'Е'
+        56: 1,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 1,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 1,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 1,  # 'Ш'
+        63: 1,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 1,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 1,  # 'а'
+        21: 2,  # 'б'
+        10: 2,  # 'в'
+        19: 1,  # 'г'
+        13: 2,  # 'д'
+        2: 1,  # 'е'
+        24: 2,  # 'ж'
+        20: 2,  # 'з'
+        4: 2,  # 'и'
+        23: 1,  # 'й'
+        11: 1,  # 'к'
+        8: 2,  # 'л'
+        12: 2,  # 'м'
+        5: 1,  # 'н'
+        1: 2,  # 'о'
+        15: 1,  # 'п'
+        9: 2,  # 'р'
+        7: 2,  # 'с'
+        6: 2,  # 'т'
+        14: 0,  # 'у'
+        39: 1,  # 'ф'
+        26: 1,  # 'х'
+        28: 1,  # 'ц'
+        22: 2,  # 'ч'
+        25: 1,  # 'ш'
+        29: 1,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 2,  # 'э'
+        27: 1,  # 'ю'
+        16: 0,  # 'я'
+    },
+    53: {  # 'Ф'
+        37: 1,  # 'А'
+        44: 1,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 1,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 1,  # 'О'
+        35: 0,  # 'П'
+        45: 1,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 2,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 2,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 2,  # 'о'
+        15: 0,  # 'п'
+        9: 2,  # 'р'
+        7: 0,  # 'с'
+        6: 1,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 1,  # 'ь'
+        30: 2,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    55: {  # 'Х'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 1,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 2,  # 'а'
+        21: 0,  # 'б'
+        10: 2,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 2,  # 'л'
+        12: 1,  # 'м'
+        5: 0,  # 'н'
+        1: 2,  # 'о'
+        15: 0,  # 'п'
+        9: 2,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 1,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 1,  # 'ь'
+        30: 1,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    58: {  # 'Ц'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 1,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 1,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 1,  # 'а'
+        21: 0,  # 'б'
+        10: 1,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 0,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 0,  # 'о'
+        15: 0,  # 'п'
+        9: 0,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 1,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 1,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 1,  # 'ю'
+        16: 0,  # 'я'
+    },
+    50: {  # 'Ч'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 0,  # 'О'
+        35: 1,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 1,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 1,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 2,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 1,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 1,  # 'о'
+        15: 0,  # 'п'
+        9: 1,  # 'р'
+        7: 0,  # 'с'
+        6: 3,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 1,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    57: {  # 'Ш'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 1,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 2,  # 'а'
+        21: 0,  # 'б'
+        10: 1,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 1,  # 'и'
+        23: 0,  # 'й'
+        11: 1,  # 'к'
+        8: 2,  # 'л'
+        12: 1,  # 'м'
+        5: 1,  # 'н'
+        1: 2,  # 'о'
+        15: 2,  # 'п'
+        9: 1,  # 'р'
+        7: 0,  # 'с'
+        6: 2,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 1,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 1,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 1,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    63: {  # 'Щ'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 1,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 1,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 1,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 1,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 0,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 1,  # 'о'
+        15: 0,  # 'п'
+        9: 0,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 1,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    62: {  # 'Ы'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 1,  # 'В'
+        46: 1,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 1,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 0,  # 'О'
+        35: 1,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 1,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 1,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 0,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 0,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 0,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 0,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 0,  # 'о'
+        15: 0,  # 'п'
+        9: 0,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 0,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    61: {  # 'Ь'
+        37: 0,  # 'А'
+        44: 1,  # 'Б'
+        33: 1,  # 'В'
+        46: 0,  # 'Г'
+        41: 1,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 0,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 1,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 1,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 1,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 1,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 1,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 0,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 0,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 0,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 0,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 0,  # 'о'
+        15: 0,  # 'п'
+        9: 0,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 0,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    47: {  # 'Э'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 1,  # 'В'
+        46: 0,  # 'Г'
+        41: 1,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 1,  # 'Й'
+        36: 1,  # 'К'
+        49: 1,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 0,  # 'О'
+        35: 1,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 1,  # 'а'
+        21: 1,  # 'б'
+        10: 2,  # 'в'
+        19: 1,  # 'г'
+        13: 2,  # 'д'
+        2: 0,  # 'е'
+        24: 1,  # 'ж'
+        20: 0,  # 'з'
+        4: 0,  # 'и'
+        23: 2,  # 'й'
+        11: 2,  # 'к'
+        8: 2,  # 'л'
+        12: 2,  # 'м'
+        5: 2,  # 'н'
+        1: 0,  # 'о'
+        15: 1,  # 'п'
+        9: 2,  # 'р'
+        7: 1,  # 'с'
+        6: 3,  # 'т'
+        14: 1,  # 'у'
+        39: 1,  # 'ф'
+        26: 1,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 1,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    59: {  # 'Ю'
+        37: 1,  # 'А'
+        44: 1,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 1,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 1,  # 'Р'
+        32: 0,  # 'С'
+        40: 1,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 1,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 0,  # 'а'
+        21: 1,  # 'б'
+        10: 0,  # 'в'
+        19: 1,  # 'г'
+        13: 1,  # 'д'
+        2: 0,  # 'е'
+        24: 1,  # 'ж'
+        20: 0,  # 'з'
+        4: 0,  # 'и'
+        23: 0,  # 'й'
+        11: 1,  # 'к'
+        8: 2,  # 'л'
+        12: 1,  # 'м'
+        5: 2,  # 'н'
+        1: 0,  # 'о'
+        15: 1,  # 'п'
+        9: 1,  # 'р'
+        7: 1,  # 'с'
+        6: 0,  # 'т'
+        14: 0,  # 'у'
+        39: 0,  # 'ф'
+        26: 1,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    43: {  # 'Я'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 1,  # 'В'
+        46: 1,  # 'Г'
+        41: 0,  # 'Д'
+        48: 1,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 1,  # 'С'
+        40: 1,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 1,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 1,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 1,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 1,  # 'Ю'
+        43: 1,  # 'Я'
+        3: 0,  # 'а'
+        21: 1,  # 'б'
+        10: 1,  # 'в'
+        19: 1,  # 'г'
+        13: 1,  # 'д'
+        2: 0,  # 'е'
+        24: 0,  # 'ж'
+        20: 1,  # 'з'
+        4: 0,  # 'и'
+        23: 1,  # 'й'
+        11: 1,  # 'к'
+        8: 1,  # 'л'
+        12: 1,  # 'м'
+        5: 2,  # 'н'
+        1: 0,  # 'о'
+        15: 1,  # 'п'
+        9: 1,  # 'р'
+        7: 1,  # 'с'
+        6: 0,  # 'т'
+        14: 0,  # 'у'
+        39: 0,  # 'ф'
+        26: 1,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 1,  # 'ш'
+        29: 1,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    3: {  # 'а'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 1,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 2,  # 'а'
+        21: 3,  # 'б'
+        10: 3,  # 'в'
+        19: 3,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 3,  # 'ж'
+        20: 3,  # 'з'
+        4: 3,  # 'и'
+        23: 3,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 3,  # 'м'
+        5: 3,  # 'н'
+        1: 2,  # 'о'
+        15: 3,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 3,  # 'у'
+        39: 2,  # 'ф'
+        26: 3,  # 'х'
+        28: 3,  # 'ц'
+        22: 3,  # 'ч'
+        25: 3,  # 'ш'
+        29: 3,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 2,  # 'э'
+        27: 3,  # 'ю'
+        16: 3,  # 'я'
+    },
+    21: {  # 'б'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 1,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 2,  # 'б'
+        10: 2,  # 'в'
+        19: 1,  # 'г'
+        13: 2,  # 'д'
+        2: 3,  # 'е'
+        24: 2,  # 'ж'
+        20: 1,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 2,  # 'к'
+        8: 3,  # 'л'
+        12: 2,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 1,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 2,  # 'т'
+        14: 3,  # 'у'
+        39: 0,  # 'ф'
+        26: 2,  # 'х'
+        28: 1,  # 'ц'
+        22: 1,  # 'ч'
+        25: 2,  # 'ш'
+        29: 3,  # 'щ'
+        54: 2,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 2,  # 'ь'
+        30: 1,  # 'э'
+        27: 2,  # 'ю'
+        16: 3,  # 'я'
+    },
+    10: {  # 'в'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 2,  # 'б'
+        10: 2,  # 'в'
+        19: 2,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 1,  # 'ж'
+        20: 3,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 2,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 3,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 3,  # 'у'
+        39: 1,  # 'ф'
+        26: 2,  # 'х'
+        28: 2,  # 'ц'
+        22: 2,  # 'ч'
+        25: 3,  # 'ш'
+        29: 2,  # 'щ'
+        54: 2,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 3,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 3,  # 'я'
+    },
+    19: {  # 'г'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 1,  # 'б'
+        10: 2,  # 'в'
+        19: 1,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 0,  # 'ж'
+        20: 1,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 2,  # 'к'
+        8: 3,  # 'л'
+        12: 2,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 3,  # 'р'
+        7: 2,  # 'с'
+        6: 2,  # 'т'
+        14: 3,  # 'у'
+        39: 1,  # 'ф'
+        26: 1,  # 'х'
+        28: 1,  # 'ц'
+        22: 2,  # 'ч'
+        25: 1,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 1,  # 'ы'
+        17: 1,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 0,  # 'я'
+    },
+    13: {  # 'д'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 2,  # 'б'
+        10: 3,  # 'в'
+        19: 2,  # 'г'
+        13: 2,  # 'д'
+        2: 3,  # 'е'
+        24: 2,  # 'ж'
+        20: 2,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 2,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 2,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 3,  # 'у'
+        39: 1,  # 'ф'
+        26: 2,  # 'х'
+        28: 3,  # 'ц'
+        22: 2,  # 'ч'
+        25: 2,  # 'ш'
+        29: 1,  # 'щ'
+        54: 2,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 3,  # 'ь'
+        30: 1,  # 'э'
+        27: 2,  # 'ю'
+        16: 3,  # 'я'
+    },
+    2: {  # 'е'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 2,  # 'а'
+        21: 3,  # 'б'
+        10: 3,  # 'в'
+        19: 3,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 3,  # 'ж'
+        20: 3,  # 'з'
+        4: 2,  # 'и'
+        23: 3,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 3,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 3,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 2,  # 'у'
+        39: 2,  # 'ф'
+        26: 3,  # 'х'
+        28: 3,  # 'ц'
+        22: 3,  # 'ч'
+        25: 3,  # 'ш'
+        29: 3,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 1,  # 'э'
+        27: 2,  # 'ю'
+        16: 3,  # 'я'
+    },
+    24: {  # 'ж'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 2,  # 'б'
+        10: 1,  # 'в'
+        19: 2,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 2,  # 'ж'
+        20: 1,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 2,  # 'к'
+        8: 2,  # 'л'
+        12: 1,  # 'м'
+        5: 3,  # 'н'
+        1: 2,  # 'о'
+        15: 1,  # 'п'
+        9: 2,  # 'р'
+        7: 2,  # 'с'
+        6: 1,  # 'т'
+        14: 3,  # 'у'
+        39: 1,  # 'ф'
+        26: 0,  # 'х'
+        28: 1,  # 'ц'
+        22: 2,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 1,  # 'ы'
+        17: 2,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 1,  # 'я'
+    },
+    20: {  # 'з'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 3,  # 'б'
+        10: 3,  # 'в'
+        19: 3,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 2,  # 'ж'
+        20: 2,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 3,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 3,  # 'р'
+        7: 2,  # 'с'
+        6: 2,  # 'т'
+        14: 3,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 1,  # 'ц'
+        22: 2,  # 'ч'
+        25: 1,  # 'ш'
+        29: 0,  # 'щ'
+        54: 2,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 2,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 3,  # 'я'
+    },
+    4: {  # 'и'
+        37: 1,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 1,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 3,  # 'б'
+        10: 3,  # 'в'
+        19: 3,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 3,  # 'ж'
+        20: 3,  # 'з'
+        4: 3,  # 'и'
+        23: 3,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 3,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 3,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 2,  # 'у'
+        39: 2,  # 'ф'
+        26: 3,  # 'х'
+        28: 3,  # 'ц'
+        22: 3,  # 'ч'
+        25: 3,  # 'ш'
+        29: 3,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 2,  # 'э'
+        27: 3,  # 'ю'
+        16: 3,  # 'я'
+    },
+    23: {  # 'й'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 1,  # 'а'
+        21: 1,  # 'б'
+        10: 1,  # 'в'
+        19: 2,  # 'г'
+        13: 3,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 2,  # 'з'
+        4: 1,  # 'и'
+        23: 0,  # 'й'
+        11: 2,  # 'к'
+        8: 2,  # 'л'
+        12: 2,  # 'м'
+        5: 3,  # 'н'
+        1: 2,  # 'о'
+        15: 1,  # 'п'
+        9: 2,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 1,  # 'у'
+        39: 2,  # 'ф'
+        26: 1,  # 'х'
+        28: 2,  # 'ц'
+        22: 3,  # 'ч'
+        25: 2,  # 'ш'
+        29: 1,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 2,  # 'я'
+    },
+    11: {  # 'к'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 1,  # 'б'
+        10: 3,  # 'в'
+        19: 1,  # 'г'
+        13: 1,  # 'д'
+        2: 3,  # 'е'
+        24: 2,  # 'ж'
+        20: 2,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 2,  # 'к'
+        8: 3,  # 'л'
+        12: 1,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 3,  # 'у'
+        39: 1,  # 'ф'
+        26: 2,  # 'х'
+        28: 2,  # 'ц'
+        22: 1,  # 'ч'
+        25: 2,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 1,  # 'ы'
+        17: 1,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 1,  # 'я'
+    },
+    8: {  # 'л'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 2,  # 'б'
+        10: 2,  # 'в'
+        19: 3,  # 'г'
+        13: 2,  # 'д'
+        2: 3,  # 'е'
+        24: 3,  # 'ж'
+        20: 2,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 2,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 2,  # 'п'
+        9: 1,  # 'р'
+        7: 3,  # 'с'
+        6: 2,  # 'т'
+        14: 3,  # 'у'
+        39: 2,  # 'ф'
+        26: 2,  # 'х'
+        28: 1,  # 'ц'
+        22: 3,  # 'ч'
+        25: 2,  # 'ш'
+        29: 1,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 3,  # 'ь'
+        30: 1,  # 'э'
+        27: 3,  # 'ю'
+        16: 3,  # 'я'
+    },
+    12: {  # 'м'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 2,  # 'б'
+        10: 2,  # 'в'
+        19: 2,  # 'г'
+        13: 1,  # 'д'
+        2: 3,  # 'е'
+        24: 1,  # 'ж'
+        20: 1,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 2,  # 'к'
+        8: 3,  # 'л'
+        12: 2,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 2,  # 'п'
+        9: 2,  # 'р'
+        7: 3,  # 'с'
+        6: 2,  # 'т'
+        14: 3,  # 'у'
+        39: 2,  # 'ф'
+        26: 2,  # 'х'
+        28: 2,  # 'ц'
+        22: 2,  # 'ч'
+        25: 1,  # 'ш'
+        29: 1,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 2,  # 'ь'
+        30: 2,  # 'э'
+        27: 1,  # 'ю'
+        16: 3,  # 'я'
+    },
+    5: {  # 'н'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 2,  # 'б'
+        10: 2,  # 'в'
+        19: 3,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 2,  # 'ж'
+        20: 2,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 3,  # 'к'
+        8: 2,  # 'л'
+        12: 1,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 1,  # 'п'
+        9: 2,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 3,  # 'у'
+        39: 2,  # 'ф'
+        26: 2,  # 'х'
+        28: 3,  # 'ц'
+        22: 3,  # 'ч'
+        25: 2,  # 'ш'
+        29: 2,  # 'щ'
+        54: 1,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 3,  # 'ь'
+        30: 1,  # 'э'
+        27: 3,  # 'ю'
+        16: 3,  # 'я'
+    },
+    1: {  # 'о'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 2,  # 'а'
+        21: 3,  # 'б'
+        10: 3,  # 'в'
+        19: 3,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 3,  # 'ж'
+        20: 3,  # 'з'
+        4: 3,  # 'и'
+        23: 3,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 3,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 3,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 2,  # 'у'
+        39: 2,  # 'ф'
+        26: 3,  # 'х'
+        28: 2,  # 'ц'
+        22: 3,  # 'ч'
+        25: 3,  # 'ш'
+        29: 3,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 2,  # 'э'
+        27: 3,  # 'ю'
+        16: 3,  # 'я'
+    },
+    15: {  # 'п'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 1,  # 'б'
+        10: 0,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 3,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 2,  # 'к'
+        8: 3,  # 'л'
+        12: 1,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 2,  # 'п'
+        9: 3,  # 'р'
+        7: 2,  # 'с'
+        6: 2,  # 'т'
+        14: 3,  # 'у'
+        39: 1,  # 'ф'
+        26: 0,  # 'х'
+        28: 2,  # 'ц'
+        22: 2,  # 'ч'
+        25: 1,  # 'ш'
+        29: 1,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 2,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 3,  # 'я'
+    },
+    9: {  # 'р'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 2,  # 'б'
+        10: 3,  # 'в'
+        19: 3,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 3,  # 'ж'
+        20: 2,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 3,  # 'к'
+        8: 2,  # 'л'
+        12: 3,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 2,  # 'п'
+        9: 2,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 3,  # 'у'
+        39: 2,  # 'ф'
+        26: 3,  # 'х'
+        28: 2,  # 'ц'
+        22: 2,  # 'ч'
+        25: 3,  # 'ш'
+        29: 2,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 3,  # 'ь'
+        30: 2,  # 'э'
+        27: 2,  # 'ю'
+        16: 3,  # 'я'
+    },
+    7: {  # 'с'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 1,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 2,  # 'б'
+        10: 3,  # 'в'
+        19: 2,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 2,  # 'ж'
+        20: 2,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 3,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 3,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 3,  # 'у'
+        39: 2,  # 'ф'
+        26: 3,  # 'х'
+        28: 2,  # 'ц'
+        22: 3,  # 'ч'
+        25: 2,  # 'ш'
+        29: 1,  # 'щ'
+        54: 2,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 3,  # 'ь'
+        30: 2,  # 'э'
+        27: 3,  # 'ю'
+        16: 3,  # 'я'
+    },
+    6: {  # 'т'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 2,  # 'б'
+        10: 3,  # 'в'
+        19: 2,  # 'г'
+        13: 2,  # 'д'
+        2: 3,  # 'е'
+        24: 1,  # 'ж'
+        20: 1,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 2,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 2,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 2,  # 'т'
+        14: 3,  # 'у'
+        39: 2,  # 'ф'
+        26: 2,  # 'х'
+        28: 2,  # 'ц'
+        22: 2,  # 'ч'
+        25: 2,  # 'ш'
+        29: 2,  # 'щ'
+        54: 2,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 3,  # 'ь'
+        30: 2,  # 'э'
+        27: 2,  # 'ю'
+        16: 3,  # 'я'
+    },
+    14: {  # 'у'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 2,  # 'а'
+        21: 3,  # 'б'
+        10: 3,  # 'в'
+        19: 3,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 3,  # 'ж'
+        20: 3,  # 'з'
+        4: 2,  # 'и'
+        23: 2,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 3,  # 'м'
+        5: 3,  # 'н'
+        1: 2,  # 'о'
+        15: 3,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 1,  # 'у'
+        39: 2,  # 'ф'
+        26: 3,  # 'х'
+        28: 2,  # 'ц'
+        22: 3,  # 'ч'
+        25: 3,  # 'ш'
+        29: 3,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 2,  # 'э'
+        27: 3,  # 'ю'
+        16: 2,  # 'я'
+    },
+    39: {  # 'ф'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 1,  # 'б'
+        10: 0,  # 'в'
+        19: 1,  # 'г'
+        13: 0,  # 'д'
+        2: 3,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 1,  # 'к'
+        8: 2,  # 'л'
+        12: 1,  # 'м'
+        5: 1,  # 'н'
+        1: 3,  # 'о'
+        15: 1,  # 'п'
+        9: 2,  # 'р'
+        7: 2,  # 'с'
+        6: 2,  # 'т'
+        14: 2,  # 'у'
+        39: 2,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 1,  # 'ч'
+        25: 1,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 2,  # 'ы'
+        17: 1,  # 'ь'
+        30: 2,  # 'э'
+        27: 1,  # 'ю'
+        16: 1,  # 'я'
+    },
+    26: {  # 'х'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 0,  # 'б'
+        10: 3,  # 'в'
+        19: 1,  # 'г'
+        13: 1,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 1,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 1,  # 'к'
+        8: 2,  # 'л'
+        12: 2,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 1,  # 'п'
+        9: 3,  # 'р'
+        7: 2,  # 'с'
+        6: 2,  # 'т'
+        14: 2,  # 'у'
+        39: 1,  # 'ф'
+        26: 1,  # 'х'
+        28: 1,  # 'ц'
+        22: 1,  # 'ч'
+        25: 2,  # 'ш'
+        29: 0,  # 'щ'
+        54: 1,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 1,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 0,  # 'я'
+    },
+    28: {  # 'ц'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 1,  # 'б'
+        10: 2,  # 'в'
+        19: 1,  # 'г'
+        13: 1,  # 'д'
+        2: 3,  # 'е'
+        24: 0,  # 'ж'
+        20: 1,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 2,  # 'к'
+        8: 1,  # 'л'
+        12: 1,  # 'м'
+        5: 1,  # 'н'
+        1: 3,  # 'о'
+        15: 0,  # 'п'
+        9: 1,  # 'р'
+        7: 0,  # 'с'
+        6: 1,  # 'т'
+        14: 3,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 1,  # 'ц'
+        22: 0,  # 'ч'
+        25: 1,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 3,  # 'ы'
+        17: 1,  # 'ь'
+        30: 0,  # 'э'
+        27: 1,  # 'ю'
+        16: 0,  # 'я'
+    },
+    22: {  # 'ч'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 1,  # 'б'
+        10: 1,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 3,  # 'е'
+        24: 1,  # 'ж'
+        20: 0,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 3,  # 'к'
+        8: 2,  # 'л'
+        12: 1,  # 'м'
+        5: 3,  # 'н'
+        1: 2,  # 'о'
+        15: 0,  # 'п'
+        9: 2,  # 'р'
+        7: 1,  # 'с'
+        6: 3,  # 'т'
+        14: 3,  # 'у'
+        39: 1,  # 'ф'
+        26: 1,  # 'х'
+        28: 0,  # 'ц'
+        22: 1,  # 'ч'
+        25: 2,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 3,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    25: {  # 'ш'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 1,  # 'б'
+        10: 2,  # 'в'
+        19: 1,  # 'г'
+        13: 0,  # 'д'
+        2: 3,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 2,  # 'м'
+        5: 3,  # 'н'
+        1: 3,  # 'о'
+        15: 2,  # 'п'
+        9: 2,  # 'р'
+        7: 1,  # 'с'
+        6: 2,  # 'т'
+        14: 3,  # 'у'
+        39: 2,  # 'ф'
+        26: 1,  # 'х'
+        28: 1,  # 'ц'
+        22: 1,  # 'ч'
+        25: 1,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 3,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 0,  # 'я'
+    },
+    29: {  # 'щ'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 3,  # 'а'
+        21: 0,  # 'б'
+        10: 1,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 3,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 3,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 0,  # 'л'
+        12: 1,  # 'м'
+        5: 2,  # 'н'
+        1: 1,  # 'о'
+        15: 0,  # 'п'
+        9: 2,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 2,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 2,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 0,  # 'я'
+    },
+    54: {  # 'ъ'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 0,  # 'а'
+        21: 0,  # 'б'
+        10: 0,  # 'в'
+        19: 0,  # 'г'
+        13: 0,  # 'д'
+        2: 2,  # 'е'
+        24: 0,  # 'ж'
+        20: 0,  # 'з'
+        4: 0,  # 'и'
+        23: 0,  # 'й'
+        11: 0,  # 'к'
+        8: 0,  # 'л'
+        12: 0,  # 'м'
+        5: 0,  # 'н'
+        1: 0,  # 'о'
+        15: 0,  # 'п'
+        9: 0,  # 'р'
+        7: 0,  # 'с'
+        6: 0,  # 'т'
+        14: 0,  # 'у'
+        39: 0,  # 'ф'
+        26: 0,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 0,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 1,  # 'ю'
+        16: 2,  # 'я'
+    },
+    18: {  # 'ы'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 0,  # 'а'
+        21: 3,  # 'б'
+        10: 3,  # 'в'
+        19: 2,  # 'г'
+        13: 2,  # 'д'
+        2: 3,  # 'е'
+        24: 2,  # 'ж'
+        20: 2,  # 'з'
+        4: 2,  # 'и'
+        23: 3,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 3,  # 'м'
+        5: 3,  # 'н'
+        1: 1,  # 'о'
+        15: 3,  # 'п'
+        9: 3,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 1,  # 'у'
+        39: 0,  # 'ф'
+        26: 3,  # 'х'
+        28: 2,  # 'ц'
+        22: 3,  # 'ч'
+        25: 3,  # 'ш'
+        29: 2,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 0,  # 'ю'
+        16: 2,  # 'я'
+    },
+    17: {  # 'ь'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 0,  # 'а'
+        21: 2,  # 'б'
+        10: 2,  # 'в'
+        19: 2,  # 'г'
+        13: 2,  # 'д'
+        2: 3,  # 'е'
+        24: 1,  # 'ж'
+        20: 3,  # 'з'
+        4: 2,  # 'и'
+        23: 0,  # 'й'
+        11: 3,  # 'к'
+        8: 0,  # 'л'
+        12: 3,  # 'м'
+        5: 3,  # 'н'
+        1: 2,  # 'о'
+        15: 2,  # 'п'
+        9: 1,  # 'р'
+        7: 3,  # 'с'
+        6: 2,  # 'т'
+        14: 0,  # 'у'
+        39: 2,  # 'ф'
+        26: 1,  # 'х'
+        28: 2,  # 'ц'
+        22: 2,  # 'ч'
+        25: 3,  # 'ш'
+        29: 2,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 1,  # 'э'
+        27: 3,  # 'ю'
+        16: 3,  # 'я'
+    },
+    30: {  # 'э'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 1,  # 'М'
+        31: 1,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 1,  # 'Р'
+        32: 1,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 1,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 0,  # 'а'
+        21: 1,  # 'б'
+        10: 1,  # 'в'
+        19: 1,  # 'г'
+        13: 2,  # 'д'
+        2: 1,  # 'е'
+        24: 0,  # 'ж'
+        20: 1,  # 'з'
+        4: 0,  # 'и'
+        23: 2,  # 'й'
+        11: 2,  # 'к'
+        8: 2,  # 'л'
+        12: 2,  # 'м'
+        5: 2,  # 'н'
+        1: 0,  # 'о'
+        15: 2,  # 'п'
+        9: 2,  # 'р'
+        7: 2,  # 'с'
+        6: 3,  # 'т'
+        14: 1,  # 'у'
+        39: 2,  # 'ф'
+        26: 1,  # 'х'
+        28: 0,  # 'ц'
+        22: 0,  # 'ч'
+        25: 1,  # 'ш'
+        29: 0,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 1,  # 'э'
+        27: 1,  # 'ю'
+        16: 1,  # 'я'
+    },
+    27: {  # 'ю'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 2,  # 'а'
+        21: 3,  # 'б'
+        10: 1,  # 'в'
+        19: 2,  # 'г'
+        13: 3,  # 'д'
+        2: 1,  # 'е'
+        24: 2,  # 'ж'
+        20: 2,  # 'з'
+        4: 1,  # 'и'
+        23: 1,  # 'й'
+        11: 2,  # 'к'
+        8: 2,  # 'л'
+        12: 2,  # 'м'
+        5: 2,  # 'н'
+        1: 1,  # 'о'
+        15: 2,  # 'п'
+        9: 2,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 0,  # 'у'
+        39: 1,  # 'ф'
+        26: 2,  # 'х'
+        28: 2,  # 'ц'
+        22: 2,  # 'ч'
+        25: 2,  # 'ш'
+        29: 3,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 1,  # 'э'
+        27: 2,  # 'ю'
+        16: 1,  # 'я'
+    },
+    16: {  # 'я'
+        37: 0,  # 'А'
+        44: 0,  # 'Б'
+        33: 0,  # 'В'
+        46: 0,  # 'Г'
+        41: 0,  # 'Д'
+        48: 0,  # 'Е'
+        56: 0,  # 'Ж'
+        51: 0,  # 'З'
+        42: 0,  # 'И'
+        60: 0,  # 'Й'
+        36: 0,  # 'К'
+        49: 0,  # 'Л'
+        38: 0,  # 'М'
+        31: 0,  # 'Н'
+        34: 0,  # 'О'
+        35: 0,  # 'П'
+        45: 0,  # 'Р'
+        32: 0,  # 'С'
+        40: 0,  # 'Т'
+        52: 0,  # 'У'
+        53: 0,  # 'Ф'
+        55: 0,  # 'Х'
+        58: 0,  # 'Ц'
+        50: 0,  # 'Ч'
+        57: 0,  # 'Ш'
+        63: 0,  # 'Щ'
+        62: 0,  # 'Ы'
+        61: 0,  # 'Ь'
+        47: 0,  # 'Э'
+        59: 0,  # 'Ю'
+        43: 0,  # 'Я'
+        3: 0,  # 'а'
+        21: 2,  # 'б'
+        10: 3,  # 'в'
+        19: 2,  # 'г'
+        13: 3,  # 'д'
+        2: 3,  # 'е'
+        24: 3,  # 'ж'
+        20: 3,  # 'з'
+        4: 2,  # 'и'
+        23: 2,  # 'й'
+        11: 3,  # 'к'
+        8: 3,  # 'л'
+        12: 3,  # 'м'
+        5: 3,  # 'н'
+        1: 0,  # 'о'
+        15: 2,  # 'п'
+        9: 2,  # 'р'
+        7: 3,  # 'с'
+        6: 3,  # 'т'
+        14: 1,  # 'у'
+        39: 1,  # 'ф'
+        26: 3,  # 'х'
+        28: 2,  # 'ц'
+        22: 2,  # 'ч'
+        25: 2,  # 'ш'
+        29: 3,  # 'щ'
+        54: 0,  # 'ъ'
+        18: 0,  # 'ы'
+        17: 0,  # 'ь'
+        30: 0,  # 'э'
+        27: 2,  # 'ю'
+        16: 2,  # 'я'
+    },
+}
+
+# 255: Undefined characters that did not exist in training text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+# 251: Control characters
+
+# Character Mapping Table(s):
+IBM866_RUSSIAN_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 142,  # 'A'
+     66: 143,  # 'B'
+     67: 144,  # 'C'
+     68: 145,  # 'D'
+     69: 146,  # 'E'
+     70: 147,  # 'F'
+     71: 148,  # 'G'
+     72: 149,  # 'H'
+     73: 150,  # 'I'
+     74: 151,  # 'J'
+     75: 152,  # 'K'
+     76: 74,  # 'L'
+     77: 153,  # 'M'
+     78: 75,  # 'N'
+     79: 154,  # 'O'
+     80: 155,  # 'P'
+     81: 156,  # 'Q'
+     82: 157,  # 'R'
+     83: 158,  # 'S'
+     84: 159,  # 'T'
+     85: 160,  # 'U'
+     86: 161,  # 'V'
+     87: 162,  # 'W'
+     88: 163,  # 'X'
+     89: 164,  # 'Y'
+     90: 165,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 71,  # 'a'
+     98: 172,  # 'b'
+     99: 66,  # 'c'
+     100: 173,  # 'd'
+     101: 65,  # 'e'
+     102: 174,  # 'f'
+     103: 76,  # 'g'
+     104: 175,  # 'h'
+     105: 64,  # 'i'
+     106: 176,  # 'j'
+     107: 177,  # 'k'
+     108: 77,  # 'l'
+     109: 72,  # 'm'
+     110: 178,  # 'n'
+     111: 69,  # 'o'
+     112: 67,  # 'p'
+     113: 179,  # 'q'
+     114: 78,  # 'r'
+     115: 73,  # 's'
+     116: 180,  # 't'
+     117: 181,  # 'u'
+     118: 79,  # 'v'
+     119: 182,  # 'w'
+     120: 183,  # 'x'
+     121: 184,  # 'y'
+     122: 185,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 37,  # 'А'
+     129: 44,  # 'Б'
+     130: 33,  # 'В'
+     131: 46,  # 'Г'
+     132: 41,  # 'Д'
+     133: 48,  # 'Е'
+     134: 56,  # 'Ж'
+     135: 51,  # 'З'
+     136: 42,  # 'И'
+     137: 60,  # 'Й'
+     138: 36,  # 'К'
+     139: 49,  # 'Л'
+     140: 38,  # 'М'
+     141: 31,  # 'Н'
+     142: 34,  # 'О'
+     143: 35,  # 'П'
+     144: 45,  # 'Р'
+     145: 32,  # 'С'
+     146: 40,  # 'Т'
+     147: 52,  # 'У'
+     148: 53,  # 'Ф'
+     149: 55,  # 'Х'
+     150: 58,  # 'Ц'
+     151: 50,  # 'Ч'
+     152: 57,  # 'Ш'
+     153: 63,  # 'Щ'
+     154: 70,  # 'Ъ'
+     155: 62,  # 'Ы'
+     156: 61,  # 'Ь'
+     157: 47,  # 'Э'
+     158: 59,  # 'Ю'
+     159: 43,  # 'Я'
+     160: 3,  # 'а'
+     161: 21,  # 'б'
+     162: 10,  # 'в'
+     163: 19,  # 'г'
+     164: 13,  # 'д'
+     165: 2,  # 'е'
+     166: 24,  # 'ж'
+     167: 20,  # 'з'
+     168: 4,  # 'и'
+     169: 23,  # 'й'
+     170: 11,  # 'к'
+     171: 8,  # 'л'
+     172: 12,  # 'м'
+     173: 5,  # 'н'
+     174: 1,  # 'о'
+     175: 15,  # 'п'
+     176: 191,  # '░'
+     177: 192,  # '▒'
+     178: 193,  # '▓'
+     179: 194,  # '│'
+     180: 195,  # '┤'
+     181: 196,  # '╡'
+     182: 197,  # '╢'
+     183: 198,  # '╖'
+     184: 199,  # '╕'
+     185: 200,  # '╣'
+     186: 201,  # '║'
+     187: 202,  # '╗'
+     188: 203,  # '╝'
+     189: 204,  # '╜'
+     190: 205,  # '╛'
+     191: 206,  # '┐'
+     192: 207,  # '└'
+     193: 208,  # '┴'
+     194: 209,  # '┬'
+     195: 210,  # '├'
+     196: 211,  # '─'
+     197: 212,  # '┼'
+     198: 213,  # '╞'
+     199: 214,  # '╟'
+     200: 215,  # '╚'
+     201: 216,  # '╔'
+     202: 217,  # '╩'
+     203: 218,  # '╦'
+     204: 219,  # '╠'
+     205: 220,  # '═'
+     206: 221,  # '╬'
+     207: 222,  # '╧'
+     208: 223,  # '╨'
+     209: 224,  # '╤'
+     210: 225,  # '╥'
+     211: 226,  # '╙'
+     212: 227,  # '╘'
+     213: 228,  # '╒'
+     214: 229,  # '╓'
+     215: 230,  # '╫'
+     216: 231,  # '╪'
+     217: 232,  # '┘'
+     218: 233,  # '┌'
+     219: 234,  # '█'
+     220: 235,  # '▄'
+     221: 236,  # '▌'
+     222: 237,  # '▐'
+     223: 238,  # '▀'
+     224: 9,  # 'р'
+     225: 7,  # 'с'
+     226: 6,  # 'т'
+     227: 14,  # 'у'
+     228: 39,  # 'ф'
+     229: 26,  # 'х'
+     230: 28,  # 'ц'
+     231: 22,  # 'ч'
+     232: 25,  # 'ш'
+     233: 29,  # 'щ'
+     234: 54,  # 'ъ'
+     235: 18,  # 'ы'
+     236: 17,  # 'ь'
+     237: 30,  # 'э'
+     238: 27,  # 'ю'
+     239: 16,  # 'я'
+     240: 239,  # 'Ё'
+     241: 68,  # 'ё'
+     242: 240,  # 'Є'
+     243: 241,  # 'є'
+     244: 242,  # 'Ї'
+     245: 243,  # 'ї'
+     246: 244,  # 'Ў'
+     247: 245,  # 'ў'
+     248: 246,  # '°'
+     249: 247,  # '∙'
+     250: 248,  # '·'
+     251: 249,  # '√'
+     252: 250,  # '№'
+     253: 251,  # '¤'
+     254: 252,  # '■'
+     255: 255,  # '\xa0'
+}
+
+IBM866_RUSSIAN_MODEL = SingleByteCharSetModel(charset_name='IBM866',
+                                              language='Russian',
+                                              char_to_order_map=IBM866_RUSSIAN_CHAR_TO_ORDER,
+                                              language_model=RUSSIAN_LANG_MODEL,
+                                              typical_positive_ratio=0.976601,
+                                              keep_ascii_letters=False,
+                                              alphabet='ЁАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдежзийклмнопрстуфхцчшщъыьэюяё')
+
+WINDOWS_1251_RUSSIAN_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 142,  # 'A'
+     66: 143,  # 'B'
+     67: 144,  # 'C'
+     68: 145,  # 'D'
+     69: 146,  # 'E'
+     70: 147,  # 'F'
+     71: 148,  # 'G'
+     72: 149,  # 'H'
+     73: 150,  # 'I'
+     74: 151,  # 'J'
+     75: 152,  # 'K'
+     76: 74,  # 'L'
+     77: 153,  # 'M'
+     78: 75,  # 'N'
+     79: 154,  # 'O'
+     80: 155,  # 'P'
+     81: 156,  # 'Q'
+     82: 157,  # 'R'
+     83: 158,  # 'S'
+     84: 159,  # 'T'
+     85: 160,  # 'U'
+     86: 161,  # 'V'
+     87: 162,  # 'W'
+     88: 163,  # 'X'
+     89: 164,  # 'Y'
+     90: 165,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 71,  # 'a'
+     98: 172,  # 'b'
+     99: 66,  # 'c'
+     100: 173,  # 'd'
+     101: 65,  # 'e'
+     102: 174,  # 'f'
+     103: 76,  # 'g'
+     104: 175,  # 'h'
+     105: 64,  # 'i'
+     106: 176,  # 'j'
+     107: 177,  # 'k'
+     108: 77,  # 'l'
+     109: 72,  # 'm'
+     110: 178,  # 'n'
+     111: 69,  # 'o'
+     112: 67,  # 'p'
+     113: 179,  # 'q'
+     114: 78,  # 'r'
+     115: 73,  # 's'
+     116: 180,  # 't'
+     117: 181,  # 'u'
+     118: 79,  # 'v'
+     119: 182,  # 'w'
+     120: 183,  # 'x'
+     121: 184,  # 'y'
+     122: 185,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 191,  # 'Ђ'
+     129: 192,  # 'Ѓ'
+     130: 193,  # '‚'
+     131: 194,  # 'ѓ'
+     132: 195,  # '„'
+     133: 196,  # '…'
+     134: 197,  # '†'
+     135: 198,  # '‡'
+     136: 199,  # '€'
+     137: 200,  # '‰'
+     138: 201,  # 'Љ'
+     139: 202,  # '‹'
+     140: 203,  # 'Њ'
+     141: 204,  # 'Ќ'
+     142: 205,  # 'Ћ'
+     143: 206,  # 'Џ'
+     144: 207,  # 'ђ'
+     145: 208,  # '‘'
+     146: 209,  # '’'
+     147: 210,  # '“'
+     148: 211,  # '”'
+     149: 212,  # '•'
+     150: 213,  # '–'
+     151: 214,  # '—'
+     152: 215,  # None
+     153: 216,  # '™'
+     154: 217,  # 'љ'
+     155: 218,  # '›'
+     156: 219,  # 'њ'
+     157: 220,  # 'ќ'
+     158: 221,  # 'ћ'
+     159: 222,  # 'џ'
+     160: 223,  # '\xa0'
+     161: 224,  # 'Ў'
+     162: 225,  # 'ў'
+     163: 226,  # 'Ј'
+     164: 227,  # '¤'
+     165: 228,  # 'Ґ'
+     166: 229,  # '¦'
+     167: 230,  # '§'
+     168: 231,  # 'Ё'
+     169: 232,  # '©'
+     170: 233,  # 'Є'
+     171: 234,  # '«'
+     172: 235,  # '¬'
+     173: 236,  # '\xad'
+     174: 237,  # '®'
+     175: 238,  # 'Ї'
+     176: 239,  # '°'
+     177: 240,  # '±'
+     178: 241,  # 'І'
+     179: 242,  # 'і'
+     180: 243,  # 'ґ'
+     181: 244,  # 'µ'
+     182: 245,  # '¶'
+     183: 246,  # '·'
+     184: 68,  # 'ё'
+     185: 247,  # '№'
+     186: 248,  # 'є'
+     187: 249,  # '»'
+     188: 250,  # 'ј'
+     189: 251,  # 'Ѕ'
+     190: 252,  # 'ѕ'
+     191: 253,  # 'ї'
+     192: 37,  # 'А'
+     193: 44,  # 'Б'
+     194: 33,  # 'В'
+     195: 46,  # 'Г'
+     196: 41,  # 'Д'
+     197: 48,  # 'Е'
+     198: 56,  # 'Ж'
+     199: 51,  # 'З'
+     200: 42,  # 'И'
+     201: 60,  # 'Й'
+     202: 36,  # 'К'
+     203: 49,  # 'Л'
+     204: 38,  # 'М'
+     205: 31,  # 'Н'
+     206: 34,  # 'О'
+     207: 35,  # 'П'
+     208: 45,  # 'Р'
+     209: 32,  # 'С'
+     210: 40,  # 'Т'
+     211: 52,  # 'У'
+     212: 53,  # 'Ф'
+     213: 55,  # 'Х'
+     214: 58,  # 'Ц'
+     215: 50,  # 'Ч'
+     216: 57,  # 'Ш'
+     217: 63,  # 'Щ'
+     218: 70,  # 'Ъ'
+     219: 62,  # 'Ы'
+     220: 61,  # 'Ь'
+     221: 47,  # 'Э'
+     222: 59,  # 'Ю'
+     223: 43,  # 'Я'
+     224: 3,  # 'а'
+     225: 21,  # 'б'
+     226: 10,  # 'в'
+     227: 19,  # 'г'
+     228: 13,  # 'д'
+     229: 2,  # 'е'
+     230: 24,  # 'ж'
+     231: 20,  # 'з'
+     232: 4,  # 'и'
+     233: 23,  # 'й'
+     234: 11,  # 'к'
+     235: 8,  # 'л'
+     236: 12,  # 'м'
+     237: 5,  # 'н'
+     238: 1,  # 'о'
+     239: 15,  # 'п'
+     240: 9,  # 'р'
+     241: 7,  # 'с'
+     242: 6,  # 'т'
+     243: 14,  # 'у'
+     244: 39,  # 'ф'
+     245: 26,  # 'х'
+     246: 28,  # 'ц'
+     247: 22,  # 'ч'
+     248: 25,  # 'ш'
+     249: 29,  # 'щ'
+     250: 54,  # 'ъ'
+     251: 18,  # 'ы'
+     252: 17,  # 'ь'
+     253: 30,  # 'э'
+     254: 27,  # 'ю'
+     255: 16,  # 'я'
+}
+
+WINDOWS_1251_RUSSIAN_MODEL = SingleByteCharSetModel(charset_name='windows-1251',
+                                                    language='Russian',
+                                                    char_to_order_map=WINDOWS_1251_RUSSIAN_CHAR_TO_ORDER,
+                                                    language_model=RUSSIAN_LANG_MODEL,
+                                                    typical_positive_ratio=0.976601,
+                                                    keep_ascii_letters=False,
+                                                    alphabet='ЁАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдежзийклмнопрстуфхцчшщъыьэюяё')
+
+IBM855_RUSSIAN_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 142,  # 'A'
+     66: 143,  # 'B'
+     67: 144,  # 'C'
+     68: 145,  # 'D'
+     69: 146,  # 'E'
+     70: 147,  # 'F'
+     71: 148,  # 'G'
+     72: 149,  # 'H'
+     73: 150,  # 'I'
+     74: 151,  # 'J'
+     75: 152,  # 'K'
+     76: 74,  # 'L'
+     77: 153,  # 'M'
+     78: 75,  # 'N'
+     79: 154,  # 'O'
+     80: 155,  # 'P'
+     81: 156,  # 'Q'
+     82: 157,  # 'R'
+     83: 158,  # 'S'
+     84: 159,  # 'T'
+     85: 160,  # 'U'
+     86: 161,  # 'V'
+     87: 162,  # 'W'
+     88: 163,  # 'X'
+     89: 164,  # 'Y'
+     90: 165,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 71,  # 'a'
+     98: 172,  # 'b'
+     99: 66,  # 'c'
+     100: 173,  # 'd'
+     101: 65,  # 'e'
+     102: 174,  # 'f'
+     103: 76,  # 'g'
+     104: 175,  # 'h'
+     105: 64,  # 'i'
+     106: 176,  # 'j'
+     107: 177,  # 'k'
+     108: 77,  # 'l'
+     109: 72,  # 'm'
+     110: 178,  # 'n'
+     111: 69,  # 'o'
+     112: 67,  # 'p'
+     113: 179,  # 'q'
+     114: 78,  # 'r'
+     115: 73,  # 's'
+     116: 180,  # 't'
+     117: 181,  # 'u'
+     118: 79,  # 'v'
+     119: 182,  # 'w'
+     120: 183,  # 'x'
+     121: 184,  # 'y'
+     122: 185,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 191,  # 'ђ'
+     129: 192,  # 'Ђ'
+     130: 193,  # 'ѓ'
+     131: 194,  # 'Ѓ'
+     132: 68,  # 'ё'
+     133: 195,  # 'Ё'
+     134: 196,  # 'є'
+     135: 197,  # 'Є'
+     136: 198,  # 'ѕ'
+     137: 199,  # 'Ѕ'
+     138: 200,  # 'і'
+     139: 201,  # 'І'
+     140: 202,  # 'ї'
+     141: 203,  # 'Ї'
+     142: 204,  # 'ј'
+     143: 205,  # 'Ј'
+     144: 206,  # 'љ'
+     145: 207,  # 'Љ'
+     146: 208,  # 'њ'
+     147: 209,  # 'Њ'
+     148: 210,  # 'ћ'
+     149: 211,  # 'Ћ'
+     150: 212,  # 'ќ'
+     151: 213,  # 'Ќ'
+     152: 214,  # 'ў'
+     153: 215,  # 'Ў'
+     154: 216,  # 'џ'
+     155: 217,  # 'Џ'
+     156: 27,  # 'ю'
+     157: 59,  # 'Ю'
+     158: 54,  # 'ъ'
+     159: 70,  # 'Ъ'
+     160: 3,  # 'а'
+     161: 37,  # 'А'
+     162: 21,  # 'б'
+     163: 44,  # 'Б'
+     164: 28,  # 'ц'
+     165: 58,  # 'Ц'
+     166: 13,  # 'д'
+     167: 41,  # 'Д'
+     168: 2,  # 'е'
+     169: 48,  # 'Е'
+     170: 39,  # 'ф'
+     171: 53,  # 'Ф'
+     172: 19,  # 'г'
+     173: 46,  # 'Г'
+     174: 218,  # '«'
+     175: 219,  # '»'
+     176: 220,  # '░'
+     177: 221,  # '▒'
+     178: 222,  # '▓'
+     179: 223,  # '│'
+     180: 224,  # '┤'
+     181: 26,  # 'х'
+     182: 55,  # 'Х'
+     183: 4,  # 'и'
+     184: 42,  # 'И'
+     185: 225,  # '╣'
+     186: 226,  # '║'
+     187: 227,  # '╗'
+     188: 228,  # '╝'
+     189: 23,  # 'й'
+     190: 60,  # 'Й'
+     191: 229,  # '┐'
+     192: 230,  # '└'
+     193: 231,  # '┴'
+     194: 232,  # '┬'
+     195: 233,  # '├'
+     196: 234,  # '─'
+     197: 235,  # '┼'
+     198: 11,  # 'к'
+     199: 36,  # 'К'
+     200: 236,  # '╚'
+     201: 237,  # '╔'
+     202: 238,  # '╩'
+     203: 239,  # '╦'
+     204: 240,  # '╠'
+     205: 241,  # '═'
+     206: 242,  # '╬'
+     207: 243,  # '¤'
+     208: 8,  # 'л'
+     209: 49,  # 'Л'
+     210: 12,  # 'м'
+     211: 38,  # 'М'
+     212: 5,  # 'н'
+     213: 31,  # 'Н'
+     214: 1,  # 'о'
+     215: 34,  # 'О'
+     216: 15,  # 'п'
+     217: 244,  # '┘'
+     218: 245,  # '┌'
+     219: 246,  # '█'
+     220: 247,  # '▄'
+     221: 35,  # 'П'
+     222: 16,  # 'я'
+     223: 248,  # '▀'
+     224: 43,  # 'Я'
+     225: 9,  # 'р'
+     226: 45,  # 'Р'
+     227: 7,  # 'с'
+     228: 32,  # 'С'
+     229: 6,  # 'т'
+     230: 40,  # 'Т'
+     231: 14,  # 'у'
+     232: 52,  # 'У'
+     233: 24,  # 'ж'
+     234: 56,  # 'Ж'
+     235: 10,  # 'в'
+     236: 33,  # 'В'
+     237: 17,  # 'ь'
+     238: 61,  # 'Ь'
+     239: 249,  # '№'
+     240: 250,  # '\xad'
+     241: 18,  # 'ы'
+     242: 62,  # 'Ы'
+     243: 20,  # 'з'
+     244: 51,  # 'З'
+     245: 25,  # 'ш'
+     246: 57,  # 'Ш'
+     247: 30,  # 'э'
+     248: 47,  # 'Э'
+     249: 29,  # 'щ'
+     250: 63,  # 'Щ'
+     251: 22,  # 'ч'
+     252: 50,  # 'Ч'
+     253: 251,  # '§'
+     254: 252,  # '■'
+     255: 255,  # '\xa0'
+}
+
+IBM855_RUSSIAN_MODEL = SingleByteCharSetModel(charset_name='IBM855',
+                                              language='Russian',
+                                              char_to_order_map=IBM855_RUSSIAN_CHAR_TO_ORDER,
+                                              language_model=RUSSIAN_LANG_MODEL,
+                                              typical_positive_ratio=0.976601,
+                                              keep_ascii_letters=False,
+                                              alphabet='ЁАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдежзийклмнопрстуфхцчшщъыьэюяё')
+
+KOI8_R_RUSSIAN_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 142,  # 'A'
+     66: 143,  # 'B'
+     67: 144,  # 'C'
+     68: 145,  # 'D'
+     69: 146,  # 'E'
+     70: 147,  # 'F'
+     71: 148,  # 'G'
+     72: 149,  # 'H'
+     73: 150,  # 'I'
+     74: 151,  # 'J'
+     75: 152,  # 'K'
+     76: 74,  # 'L'
+     77: 153,  # 'M'
+     78: 75,  # 'N'
+     79: 154,  # 'O'
+     80: 155,  # 'P'
+     81: 156,  # 'Q'
+     82: 157,  # 'R'
+     83: 158,  # 'S'
+     84: 159,  # 'T'
+     85: 160,  # 'U'
+     86: 161,  # 'V'
+     87: 162,  # 'W'
+     88: 163,  # 'X'
+     89: 164,  # 'Y'
+     90: 165,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 71,  # 'a'
+     98: 172,  # 'b'
+     99: 66,  # 'c'
+     100: 173,  # 'd'
+     101: 65,  # 'e'
+     102: 174,  # 'f'
+     103: 76,  # 'g'
+     104: 175,  # 'h'
+     105: 64,  # 'i'
+     106: 176,  # 'j'
+     107: 177,  # 'k'
+     108: 77,  # 'l'
+     109: 72,  # 'm'
+     110: 178,  # 'n'
+     111: 69,  # 'o'
+     112: 67,  # 'p'
+     113: 179,  # 'q'
+     114: 78,  # 'r'
+     115: 73,  # 's'
+     116: 180,  # 't'
+     117: 181,  # 'u'
+     118: 79,  # 'v'
+     119: 182,  # 'w'
+     120: 183,  # 'x'
+     121: 184,  # 'y'
+     122: 185,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 191,  # '─'
+     129: 192,  # '│'
+     130: 193,  # '┌'
+     131: 194,  # '┐'
+     132: 195,  # '└'
+     133: 196,  # '┘'
+     134: 197,  # '├'
+     135: 198,  # '┤'
+     136: 199,  # '┬'
+     137: 200,  # '┴'
+     138: 201,  # '┼'
+     139: 202,  # '▀'
+     140: 203,  # '▄'
+     141: 204,  # '█'
+     142: 205,  # '▌'
+     143: 206,  # '▐'
+     144: 207,  # '░'
+     145: 208,  # '▒'
+     146: 209,  # '▓'
+     147: 210,  # '⌠'
+     148: 211,  # '■'
+     149: 212,  # '∙'
+     150: 213,  # '√'
+     151: 214,  # '≈'
+     152: 215,  # '≤'
+     153: 216,  # '≥'
+     154: 217,  # '\xa0'
+     155: 218,  # '⌡'
+     156: 219,  # '°'
+     157: 220,  # '²'
+     158: 221,  # '·'
+     159: 222,  # '÷'
+     160: 223,  # '═'
+     161: 224,  # '║'
+     162: 225,  # '╒'
+     163: 68,  # 'ё'
+     164: 226,  # '╓'
+     165: 227,  # '╔'
+     166: 228,  # '╕'
+     167: 229,  # '╖'
+     168: 230,  # '╗'
+     169: 231,  # '╘'
+     170: 232,  # '╙'
+     171: 233,  # '╚'
+     172: 234,  # '╛'
+     173: 235,  # '╜'
+     174: 236,  # '╝'
+     175: 237,  # '╞'
+     176: 238,  # '╟'
+     177: 239,  # '╠'
+     178: 240,  # '╡'
+     179: 241,  # 'Ё'
+     180: 242,  # '╢'
+     181: 243,  # '╣'
+     182: 244,  # '╤'
+     183: 245,  # '╥'
+     184: 246,  # '╦'
+     185: 247,  # '╧'
+     186: 248,  # '╨'
+     187: 249,  # '╩'
+     188: 250,  # '╪'
+     189: 251,  # '╫'
+     190: 252,  # '╬'
+     191: 253,  # '©'
+     192: 27,  # 'ю'
+     193: 3,  # 'а'
+     194: 21,  # 'б'
+     195: 28,  # 'ц'
+     196: 13,  # 'д'
+     197: 2,  # 'е'
+     198: 39,  # 'ф'
+     199: 19,  # 'г'
+     200: 26,  # 'х'
+     201: 4,  # 'и'
+     202: 23,  # 'й'
+     203: 11,  # 'к'
+     204: 8,  # 'л'
+     205: 12,  # 'м'
+     206: 5,  # 'н'
+     207: 1,  # 'о'
+     208: 15,  # 'п'
+     209: 16,  # 'я'
+     210: 9,  # 'р'
+     211: 7,  # 'с'
+     212: 6,  # 'т'
+     213: 14,  # 'у'
+     214: 24,  # 'ж'
+     215: 10,  # 'в'
+     216: 17,  # 'ь'
+     217: 18,  # 'ы'
+     218: 20,  # 'з'
+     219: 25,  # 'ш'
+     220: 30,  # 'э'
+     221: 29,  # 'щ'
+     222: 22,  # 'ч'
+     223: 54,  # 'ъ'
+     224: 59,  # 'Ю'
+     225: 37,  # 'А'
+     226: 44,  # 'Б'
+     227: 58,  # 'Ц'
+     228: 41,  # 'Д'
+     229: 48,  # 'Е'
+     230: 53,  # 'Ф'
+     231: 46,  # 'Г'
+     232: 55,  # 'Х'
+     233: 42,  # 'И'
+     234: 60,  # 'Й'
+     235: 36,  # 'К'
+     236: 49,  # 'Л'
+     237: 38,  # 'М'
+     238: 31,  # 'Н'
+     239: 34,  # 'О'
+     240: 35,  # 'П'
+     241: 43,  # 'Я'
+     242: 45,  # 'Р'
+     243: 32,  # 'С'
+     244: 40,  # 'Т'
+     245: 52,  # 'У'
+     246: 56,  # 'Ж'
+     247: 33,  # 'В'
+     248: 61,  # 'Ь'
+     249: 62,  # 'Ы'
+     250: 51,  # 'З'
+     251: 57,  # 'Ш'
+     252: 47,  # 'Э'
+     253: 63,  # 'Щ'
+     254: 50,  # 'Ч'
+     255: 70,  # 'Ъ'
+}
+
+KOI8_R_RUSSIAN_MODEL = SingleByteCharSetModel(charset_name='KOI8-R',
+                                              language='Russian',
+                                              char_to_order_map=KOI8_R_RUSSIAN_CHAR_TO_ORDER,
+                                              language_model=RUSSIAN_LANG_MODEL,
+                                              typical_positive_ratio=0.976601,
+                                              keep_ascii_letters=False,
+                                              alphabet='ЁАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдежзийклмнопрстуфхцчшщъыьэюяё')
+
+MACCYRILLIC_RUSSIAN_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 142,  # 'A'
+     66: 143,  # 'B'
+     67: 144,  # 'C'
+     68: 145,  # 'D'
+     69: 146,  # 'E'
+     70: 147,  # 'F'
+     71: 148,  # 'G'
+     72: 149,  # 'H'
+     73: 150,  # 'I'
+     74: 151,  # 'J'
+     75: 152,  # 'K'
+     76: 74,  # 'L'
+     77: 153,  # 'M'
+     78: 75,  # 'N'
+     79: 154,  # 'O'
+     80: 155,  # 'P'
+     81: 156,  # 'Q'
+     82: 157,  # 'R'
+     83: 158,  # 'S'
+     84: 159,  # 'T'
+     85: 160,  # 'U'
+     86: 161,  # 'V'
+     87: 162,  # 'W'
+     88: 163,  # 'X'
+     89: 164,  # 'Y'
+     90: 165,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 71,  # 'a'
+     98: 172,  # 'b'
+     99: 66,  # 'c'
+     100: 173,  # 'd'
+     101: 65,  # 'e'
+     102: 174,  # 'f'
+     103: 76,  # 'g'
+     104: 175,  # 'h'
+     105: 64,  # 'i'
+     106: 176,  # 'j'
+     107: 177,  # 'k'
+     108: 77,  # 'l'
+     109: 72,  # 'm'
+     110: 178,  # 'n'
+     111: 69,  # 'o'
+     112: 67,  # 'p'
+     113: 179,  # 'q'
+     114: 78,  # 'r'
+     115: 73,  # 's'
+     116: 180,  # 't'
+     117: 181,  # 'u'
+     118: 79,  # 'v'
+     119: 182,  # 'w'
+     120: 183,  # 'x'
+     121: 184,  # 'y'
+     122: 185,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 37,  # 'А'
+     129: 44,  # 'Б'
+     130: 33,  # 'В'
+     131: 46,  # 'Г'
+     132: 41,  # 'Д'
+     133: 48,  # 'Е'
+     134: 56,  # 'Ж'
+     135: 51,  # 'З'
+     136: 42,  # 'И'
+     137: 60,  # 'Й'
+     138: 36,  # 'К'
+     139: 49,  # 'Л'
+     140: 38,  # 'М'
+     141: 31,  # 'Н'
+     142: 34,  # 'О'
+     143: 35,  # 'П'
+     144: 45,  # 'Р'
+     145: 32,  # 'С'
+     146: 40,  # 'Т'
+     147: 52,  # 'У'
+     148: 53,  # 'Ф'
+     149: 55,  # 'Х'
+     150: 58,  # 'Ц'
+     151: 50,  # 'Ч'
+     152: 57,  # 'Ш'
+     153: 63,  # 'Щ'
+     154: 70,  # 'Ъ'
+     155: 62,  # 'Ы'
+     156: 61,  # 'Ь'
+     157: 47,  # 'Э'
+     158: 59,  # 'Ю'
+     159: 43,  # 'Я'
+     160: 191,  # '†'
+     161: 192,  # '°'
+     162: 193,  # 'Ґ'
+     163: 194,  # '£'
+     164: 195,  # '§'
+     165: 196,  # '•'
+     166: 197,  # '¶'
+     167: 198,  # 'І'
+     168: 199,  # '®'
+     169: 200,  # '©'
+     170: 201,  # '™'
+     171: 202,  # 'Ђ'
+     172: 203,  # 'ђ'
+     173: 204,  # '≠'
+     174: 205,  # 'Ѓ'
+     175: 206,  # 'ѓ'
+     176: 207,  # '∞'
+     177: 208,  # '±'
+     178: 209,  # '≤'
+     179: 210,  # '≥'
+     180: 211,  # 'і'
+     181: 212,  # 'µ'
+     182: 213,  # 'ґ'
+     183: 214,  # 'Ј'
+     184: 215,  # 'Є'
+     185: 216,  # 'є'
+     186: 217,  # 'Ї'
+     187: 218,  # 'ї'
+     188: 219,  # 'Љ'
+     189: 220,  # 'љ'
+     190: 221,  # 'Њ'
+     191: 222,  # 'њ'
+     192: 223,  # 'ј'
+     193: 224,  # 'Ѕ'
+     194: 225,  # '¬'
+     195: 226,  # '√'
+     196: 227,  # 'ƒ'
+     197: 228,  # '≈'
+     198: 229,  # '∆'
+     199: 230,  # '«'
+     200: 231,  # '»'
+     201: 232,  # '…'
+     202: 233,  # '\xa0'
+     203: 234,  # 'Ћ'
+     204: 235,  # 'ћ'
+     205: 236,  # 'Ќ'
+     206: 237,  # 'ќ'
+     207: 238,  # 'ѕ'
+     208: 239,  # '–'
+     209: 240,  # '—'
+     210: 241,  # '“'
+     211: 242,  # '”'
+     212: 243,  # '‘'
+     213: 244,  # '’'
+     214: 245,  # '÷'
+     215: 246,  # '„'
+     216: 247,  # 'Ў'
+     217: 248,  # 'ў'
+     218: 249,  # 'Џ'
+     219: 250,  # 'џ'
+     220: 251,  # '№'
+     221: 252,  # 'Ё'
+     222: 68,  # 'ё'
+     223: 16,  # 'я'
+     224: 3,  # 'а'
+     225: 21,  # 'б'
+     226: 10,  # 'в'
+     227: 19,  # 'г'
+     228: 13,  # 'д'
+     229: 2,  # 'е'
+     230: 24,  # 'ж'
+     231: 20,  # 'з'
+     232: 4,  # 'и'
+     233: 23,  # 'й'
+     234: 11,  # 'к'
+     235: 8,  # 'л'
+     236: 12,  # 'м'
+     237: 5,  # 'н'
+     238: 1,  # 'о'
+     239: 15,  # 'п'
+     240: 9,  # 'р'
+     241: 7,  # 'с'
+     242: 6,  # 'т'
+     243: 14,  # 'у'
+     244: 39,  # 'ф'
+     245: 26,  # 'х'
+     246: 28,  # 'ц'
+     247: 22,  # 'ч'
+     248: 25,  # 'ш'
+     249: 29,  # 'щ'
+     250: 54,  # 'ъ'
+     251: 18,  # 'ы'
+     252: 17,  # 'ь'
+     253: 30,  # 'э'
+     254: 27,  # 'ю'
+     255: 255,  # '€'
+}
+
+MACCYRILLIC_RUSSIAN_MODEL = SingleByteCharSetModel(charset_name='MacCyrillic',
+                                                   language='Russian',
+                                                   char_to_order_map=MACCYRILLIC_RUSSIAN_CHAR_TO_ORDER,
+                                                   language_model=RUSSIAN_LANG_MODEL,
+                                                   typical_positive_ratio=0.976601,
+                                                   keep_ascii_letters=False,
+                                                   alphabet='ЁАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдежзийклмнопрстуфхцчшщъыьэюяё')
+
+ISO_8859_5_RUSSIAN_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 142,  # 'A'
+     66: 143,  # 'B'
+     67: 144,  # 'C'
+     68: 145,  # 'D'
+     69: 146,  # 'E'
+     70: 147,  # 'F'
+     71: 148,  # 'G'
+     72: 149,  # 'H'
+     73: 150,  # 'I'
+     74: 151,  # 'J'
+     75: 152,  # 'K'
+     76: 74,  # 'L'
+     77: 153,  # 'M'
+     78: 75,  # 'N'
+     79: 154,  # 'O'
+     80: 155,  # 'P'
+     81: 156,  # 'Q'
+     82: 157,  # 'R'
+     83: 158,  # 'S'
+     84: 159,  # 'T'
+     85: 160,  # 'U'
+     86: 161,  # 'V'
+     87: 162,  # 'W'
+     88: 163,  # 'X'
+     89: 164,  # 'Y'
+     90: 165,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 71,  # 'a'
+     98: 172,  # 'b'
+     99: 66,  # 'c'
+     100: 173,  # 'd'
+     101: 65,  # 'e'
+     102: 174,  # 'f'
+     103: 76,  # 'g'
+     104: 175,  # 'h'
+     105: 64,  # 'i'
+     106: 176,  # 'j'
+     107: 177,  # 'k'
+     108: 77,  # 'l'
+     109: 72,  # 'm'
+     110: 178,  # 'n'
+     111: 69,  # 'o'
+     112: 67,  # 'p'
+     113: 179,  # 'q'
+     114: 78,  # 'r'
+     115: 73,  # 's'
+     116: 180,  # 't'
+     117: 181,  # 'u'
+     118: 79,  # 'v'
+     119: 182,  # 'w'
+     120: 183,  # 'x'
+     121: 184,  # 'y'
+     122: 185,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 191,  # '\x80'
+     129: 192,  # '\x81'
+     130: 193,  # '\x82'
+     131: 194,  # '\x83'
+     132: 195,  # '\x84'
+     133: 196,  # '\x85'
+     134: 197,  # '\x86'
+     135: 198,  # '\x87'
+     136: 199,  # '\x88'
+     137: 200,  # '\x89'
+     138: 201,  # '\x8a'
+     139: 202,  # '\x8b'
+     140: 203,  # '\x8c'
+     141: 204,  # '\x8d'
+     142: 205,  # '\x8e'
+     143: 206,  # '\x8f'
+     144: 207,  # '\x90'
+     145: 208,  # '\x91'
+     146: 209,  # '\x92'
+     147: 210,  # '\x93'
+     148: 211,  # '\x94'
+     149: 212,  # '\x95'
+     150: 213,  # '\x96'
+     151: 214,  # '\x97'
+     152: 215,  # '\x98'
+     153: 216,  # '\x99'
+     154: 217,  # '\x9a'
+     155: 218,  # '\x9b'
+     156: 219,  # '\x9c'
+     157: 220,  # '\x9d'
+     158: 221,  # '\x9e'
+     159: 222,  # '\x9f'
+     160: 223,  # '\xa0'
+     161: 224,  # 'Ё'
+     162: 225,  # 'Ђ'
+     163: 226,  # 'Ѓ'
+     164: 227,  # 'Є'
+     165: 228,  # 'Ѕ'
+     166: 229,  # 'І'
+     167: 230,  # 'Ї'
+     168: 231,  # 'Ј'
+     169: 232,  # 'Љ'
+     170: 233,  # 'Њ'
+     171: 234,  # 'Ћ'
+     172: 235,  # 'Ќ'
+     173: 236,  # '\xad'
+     174: 237,  # 'Ў'
+     175: 238,  # 'Џ'
+     176: 37,  # 'А'
+     177: 44,  # 'Б'
+     178: 33,  # 'В'
+     179: 46,  # 'Г'
+     180: 41,  # 'Д'
+     181: 48,  # 'Е'
+     182: 56,  # 'Ж'
+     183: 51,  # 'З'
+     184: 42,  # 'И'
+     185: 60,  # 'Й'
+     186: 36,  # 'К'
+     187: 49,  # 'Л'
+     188: 38,  # 'М'
+     189: 31,  # 'Н'
+     190: 34,  # 'О'
+     191: 35,  # 'П'
+     192: 45,  # 'Р'
+     193: 32,  # 'С'
+     194: 40,  # 'Т'
+     195: 52,  # 'У'
+     196: 53,  # 'Ф'
+     197: 55,  # 'Х'
+     198: 58,  # 'Ц'
+     199: 50,  # 'Ч'
+     200: 57,  # 'Ш'
+     201: 63,  # 'Щ'
+     202: 70,  # 'Ъ'
+     203: 62,  # 'Ы'
+     204: 61,  # 'Ь'
+     205: 47,  # 'Э'
+     206: 59,  # 'Ю'
+     207: 43,  # 'Я'
+     208: 3,  # 'а'
+     209: 21,  # 'б'
+     210: 10,  # 'в'
+     211: 19,  # 'г'
+     212: 13,  # 'д'
+     213: 2,  # 'е'
+     214: 24,  # 'ж'
+     215: 20,  # 'з'
+     216: 4,  # 'и'
+     217: 23,  # 'й'
+     218: 11,  # 'к'
+     219: 8,  # 'л'
+     220: 12,  # 'м'
+     221: 5,  # 'н'
+     222: 1,  # 'о'
+     223: 15,  # 'п'
+     224: 9,  # 'р'
+     225: 7,  # 'с'
+     226: 6,  # 'т'
+     227: 14,  # 'у'
+     228: 39,  # 'ф'
+     229: 26,  # 'х'
+     230: 28,  # 'ц'
+     231: 22,  # 'ч'
+     232: 25,  # 'ш'
+     233: 29,  # 'щ'
+     234: 54,  # 'ъ'
+     235: 18,  # 'ы'
+     236: 17,  # 'ь'
+     237: 30,  # 'э'
+     238: 27,  # 'ю'
+     239: 16,  # 'я'
+     240: 239,  # '№'
+     241: 68,  # 'ё'
+     242: 240,  # 'ђ'
+     243: 241,  # 'ѓ'
+     244: 242,  # 'є'
+     245: 243,  # 'ѕ'
+     246: 244,  # 'і'
+     247: 245,  # 'ї'
+     248: 246,  # 'ј'
+     249: 247,  # 'љ'
+     250: 248,  # 'њ'
+     251: 249,  # 'ћ'
+     252: 250,  # 'ќ'
+     253: 251,  # '§'
+     254: 252,  # 'ў'
+     255: 255,  # 'џ'
+}
+
+ISO_8859_5_RUSSIAN_MODEL = SingleByteCharSetModel(charset_name='ISO-8859-5',
+                                                  language='Russian',
+                                                  char_to_order_map=ISO_8859_5_RUSSIAN_CHAR_TO_ORDER,
+                                                  language_model=RUSSIAN_LANG_MODEL,
+                                                  typical_positive_ratio=0.976601,
+                                                  keep_ascii_letters=False,
+                                                  alphabet='ЁАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдежзийклмнопрстуфхцчшщъыьэюяё')
+
diff --git a/openpype/vendor/python/python_2/chardet/langthaimodel.py b/openpype/vendor/python/python_2/chardet/langthaimodel.py
new file mode 100644
index 0000000000..d0191f241d
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/langthaimodel.py
@@ -0,0 +1,4383 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from chardet.sbcharsetprober import SingleByteCharSetModel
+
+
+# 3: Positive
+# 2: Likely
+# 1: Unlikely
+# 0: Negative
+
+THAI_LANG_MODEL = {
+    5: {  # 'ก'
+        5: 2,  # 'ก'
+        30: 2,  # 'ข'
+        24: 2,  # 'ค'
+        8: 2,  # 'ง'
+        26: 2,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 3,  # 'ฎ'
+        57: 2,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 2,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 3,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 2,  # 'น'
+        17: 1,  # 'บ'
+        25: 2,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 1,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 1,  # 'ย'
+        2: 3,  # 'ร'
+        61: 2,  # 'ฤ'
+        15: 3,  # 'ล'
+        12: 3,  # 'ว'
+        42: 2,  # 'ศ'
+        46: 3,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 2,  # 'ห'
+        4: 3,  # 'อ'
+        63: 1,  # 'ฯ'
+        22: 2,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 3,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 2,  # 'ื'
+        32: 2,  # 'ุ'
+        35: 1,  # 'ู'
+        11: 2,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 1,  # 'ๆ'
+        37: 3,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 2,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    30: {  # 'ข'
+        5: 1,  # 'ก'
+        30: 0,  # 'ข'
+        24: 1,  # 'ค'
+        8: 1,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 2,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 2,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 2,  # 'น'
+        17: 1,  # 'บ'
+        25: 1,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 2,  # 'ย'
+        2: 1,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 2,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 1,  # 'ห'
+        4: 3,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 2,  # 'ี'
+        40: 3,  # 'ึ'
+        27: 1,  # 'ื'
+        32: 1,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 1,  # '็'
+        6: 2,  # '่'
+        7: 3,  # '้'
+        38: 1,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    24: {  # 'ค'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 2,  # 'ค'
+        8: 2,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 2,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 2,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 0,  # 'บ'
+        25: 1,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 2,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 3,  # 'ล'
+        12: 3,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 0,  # 'ห'
+        4: 2,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 2,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 2,  # 'า'
+        36: 3,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 2,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 3,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 2,  # 'ู'
+        11: 1,  # 'เ'
+        28: 0,  # 'แ'
+        41: 3,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 1,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 3,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    8: {  # 'ง'
+        5: 3,  # 'ก'
+        30: 2,  # 'ข'
+        24: 3,  # 'ค'
+        8: 2,  # 'ง'
+        26: 2,  # 'จ'
+        52: 1,  # 'ฉ'
+        34: 2,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 2,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 3,  # 'ท'
+        48: 1,  # 'ธ'
+        3: 3,  # 'น'
+        17: 2,  # 'บ'
+        25: 2,  # 'ป'
+        39: 2,  # 'ผ'
+        62: 1,  # 'ฝ'
+        31: 2,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 1,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 2,  # 'ว'
+        42: 2,  # 'ศ'
+        46: 1,  # 'ษ'
+        18: 3,  # 'ส'
+        21: 3,  # 'ห'
+        4: 2,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 1,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 2,  # 'ิ'
+        13: 1,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 1,  # 'ื'
+        32: 1,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 3,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 3,  # 'ๆ'
+        37: 0,  # '็'
+        6: 2,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    26: {  # 'จ'
+        5: 2,  # 'ก'
+        30: 1,  # 'ข'
+        24: 0,  # 'ค'
+        8: 2,  # 'ง'
+        26: 3,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 1,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 1,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 1,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 1,  # 'ห'
+        4: 2,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 3,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 3,  # 'ำ'
+        23: 2,  # 'ิ'
+        13: 1,  # 'ี'
+        40: 3,  # 'ึ'
+        27: 1,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 2,  # 'ู'
+        11: 1,  # 'เ'
+        28: 1,  # 'แ'
+        41: 0,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 2,  # '่'
+        7: 2,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    52: {  # 'ฉ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 3,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 3,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 1,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 1,  # 'ะ'
+        10: 1,  # 'ั'
+        1: 1,  # 'า'
+        36: 0,  # 'ำ'
+        23: 1,  # 'ิ'
+        13: 1,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 1,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    34: {  # 'ช'
+        5: 1,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 1,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 1,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 2,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 1,  # 'ย'
+        2: 1,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 2,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 2,  # 'ั'
+        1: 3,  # 'า'
+        36: 1,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 2,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 3,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 1,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 1,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    51: {  # 'ซ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 1,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 1,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 0,  # 'ห'
+        4: 2,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 1,  # 'ั'
+        1: 1,  # 'า'
+        36: 0,  # 'ำ'
+        23: 1,  # 'ิ'
+        13: 2,  # 'ี'
+        40: 3,  # 'ึ'
+        27: 2,  # 'ื'
+        32: 1,  # 'ุ'
+        35: 1,  # 'ู'
+        11: 1,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 1,  # '็'
+        6: 1,  # '่'
+        7: 2,  # '้'
+        38: 1,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    47: {  # 'ญ'
+        5: 1,  # 'ก'
+        30: 1,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 3,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 1,  # 'บ'
+        25: 1,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 1,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 2,  # 'ห'
+        4: 1,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 1,  # 'ะ'
+        10: 2,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 1,  # 'ิ'
+        13: 1,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 1,  # 'เ'
+        28: 1,  # 'แ'
+        41: 0,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 1,  # 'ๆ'
+        37: 0,  # '็'
+        6: 2,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    58: {  # 'ฎ'
+        5: 2,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 1,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 1,  # 'ิ'
+        13: 2,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    57: {  # 'ฏ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 1,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    49: {  # 'ฐ'
+        5: 1,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 2,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 1,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 1,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 1,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    53: {  # 'ฑ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 2,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 3,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    55: {  # 'ฒ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 1,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    43: {  # 'ณ'
+        5: 1,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 3,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 3,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 1,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 1,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 3,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 1,  # 'ิ'
+        13: 2,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 1,  # 'เ'
+        28: 1,  # 'แ'
+        41: 0,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 3,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    20: {  # 'ด'
+        5: 2,  # 'ก'
+        30: 2,  # 'ข'
+        24: 2,  # 'ค'
+        8: 3,  # 'ง'
+        26: 2,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 2,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 1,  # 'น'
+        17: 1,  # 'บ'
+        25: 1,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 3,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 2,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 2,  # 'ห'
+        4: 1,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 2,  # 'า'
+        36: 2,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 1,  # 'ึ'
+        27: 2,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 2,  # 'ู'
+        11: 2,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 2,  # 'ๆ'
+        37: 2,  # '็'
+        6: 1,  # '่'
+        7: 3,  # '้'
+        38: 1,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    19: {  # 'ต'
+        5: 2,  # 'ก'
+        30: 1,  # 'ข'
+        24: 1,  # 'ค'
+        8: 0,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 1,  # 'ต'
+        44: 2,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 2,  # 'น'
+        17: 1,  # 'บ'
+        25: 1,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 2,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 1,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 3,  # 'ส'
+        21: 0,  # 'ห'
+        4: 3,  # 'อ'
+        63: 1,  # 'ฯ'
+        22: 2,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 2,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 2,  # 'ี'
+        40: 1,  # 'ึ'
+        27: 1,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 2,  # 'ู'
+        11: 1,  # 'เ'
+        28: 1,  # 'แ'
+        41: 1,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 2,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 2,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    44: {  # 'ถ'
+        5: 1,  # 'ก'
+        30: 0,  # 'ข'
+        24: 1,  # 'ค'
+        8: 0,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 1,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 1,  # 'น'
+        17: 2,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 1,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 1,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 0,  # 'ห'
+        4: 1,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 2,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 2,  # 'ิ'
+        13: 1,  # 'ี'
+        40: 3,  # 'ึ'
+        27: 2,  # 'ื'
+        32: 2,  # 'ุ'
+        35: 3,  # 'ู'
+        11: 1,  # 'เ'
+        28: 1,  # 'แ'
+        41: 0,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 2,  # '่'
+        7: 3,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    14: {  # 'ท'
+        5: 1,  # 'ก'
+        30: 1,  # 'ข'
+        24: 3,  # 'ค'
+        8: 1,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 1,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 3,  # 'ธ'
+        3: 3,  # 'น'
+        17: 2,  # 'บ'
+        25: 2,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 2,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 3,  # 'ย'
+        2: 3,  # 'ร'
+        61: 1,  # 'ฤ'
+        15: 1,  # 'ล'
+        12: 2,  # 'ว'
+        42: 3,  # 'ศ'
+        46: 1,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 0,  # 'ห'
+        4: 2,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 2,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 3,  # 'ำ'
+        23: 2,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 2,  # 'ึ'
+        27: 1,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 1,  # 'ู'
+        11: 0,  # 'เ'
+        28: 1,  # 'แ'
+        41: 0,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 1,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 2,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    48: {  # 'ธ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 1,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 1,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 2,  # 'า'
+        36: 0,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 2,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 3,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    3: {  # 'น'
+        5: 3,  # 'ก'
+        30: 2,  # 'ข'
+        24: 3,  # 'ค'
+        8: 1,  # 'ง'
+        26: 2,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 1,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 3,  # 'ต'
+        44: 2,  # 'ถ'
+        14: 3,  # 'ท'
+        48: 3,  # 'ธ'
+        3: 2,  # 'น'
+        17: 2,  # 'บ'
+        25: 2,  # 'ป'
+        39: 2,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 2,  # 'พ'
+        54: 1,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 2,  # 'ย'
+        2: 2,  # 'ร'
+        61: 1,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 3,  # 'ว'
+        42: 1,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 2,  # 'ห'
+        4: 3,  # 'อ'
+        63: 1,  # 'ฯ'
+        22: 2,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 3,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 3,  # 'ึ'
+        27: 3,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 2,  # 'ู'
+        11: 3,  # 'เ'
+        28: 2,  # 'แ'
+        41: 3,  # 'โ'
+        29: 3,  # 'ใ'
+        33: 3,  # 'ไ'
+        50: 2,  # 'ๆ'
+        37: 1,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 2,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    17: {  # 'บ'
+        5: 3,  # 'ก'
+        30: 2,  # 'ข'
+        24: 2,  # 'ค'
+        8: 1,  # 'ง'
+        26: 1,  # 'จ'
+        52: 1,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 2,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 3,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 3,  # 'บ'
+        25: 2,  # 'ป'
+        39: 2,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 1,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 0,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 3,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 2,  # 'ห'
+        4: 2,  # 'อ'
+        63: 1,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 2,  # 'ำ'
+        23: 2,  # 'ิ'
+        13: 2,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 2,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 2,  # 'ู'
+        11: 2,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 1,  # '็'
+        6: 2,  # '่'
+        7: 2,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    25: {  # 'ป'
+        5: 2,  # 'ก'
+        30: 0,  # 'ข'
+        24: 1,  # 'ค'
+        8: 0,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 1,  # 'ฎ'
+        57: 3,  # 'ฏ'
+        49: 1,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 1,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 2,  # 'น'
+        17: 0,  # 'บ'
+        25: 1,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 1,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 0,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 3,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 1,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 1,  # 'ห'
+        4: 2,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 1,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 1,  # 'า'
+        36: 0,  # 'ำ'
+        23: 2,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 1,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 1,  # 'เ'
+        28: 2,  # 'แ'
+        41: 0,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 3,  # '็'
+        6: 1,  # '่'
+        7: 2,  # '้'
+        38: 1,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    39: {  # 'ผ'
+        5: 1,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 1,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 2,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 2,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 3,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 1,  # 'ะ'
+        10: 1,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 2,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 1,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 3,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 3,  # '่'
+        7: 1,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    62: {  # 'ฝ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 1,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 1,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 1,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 1,  # 'ี'
+        40: 2,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 2,  # '่'
+        7: 1,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    31: {  # 'พ'
+        5: 1,  # 'ก'
+        30: 1,  # 'ข'
+        24: 1,  # 'ค'
+        8: 1,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 1,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 1,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 1,  # 'ธ'
+        3: 3,  # 'น'
+        17: 2,  # 'บ'
+        25: 0,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 2,  # 'ย'
+        2: 3,  # 'ร'
+        61: 2,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 2,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 1,  # 'ห'
+        4: 2,  # 'อ'
+        63: 1,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 2,  # 'ี'
+        40: 1,  # 'ึ'
+        27: 3,  # 'ื'
+        32: 1,  # 'ุ'
+        35: 2,  # 'ู'
+        11: 1,  # 'เ'
+        28: 1,  # 'แ'
+        41: 0,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 1,  # '็'
+        6: 0,  # '่'
+        7: 1,  # '้'
+        38: 3,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    54: {  # 'ฟ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 1,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 2,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 1,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 0,  # 'ห'
+        4: 1,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 2,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 1,  # 'ิ'
+        13: 1,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 1,  # 'ื'
+        32: 1,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 1,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 2,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    45: {  # 'ภ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 1,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 3,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 1,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 1,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 2,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 1,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    9: {  # 'ม'
+        5: 2,  # 'ก'
+        30: 2,  # 'ข'
+        24: 2,  # 'ค'
+        8: 2,  # 'ง'
+        26: 2,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 1,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 2,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 1,  # 'ธ'
+        3: 3,  # 'น'
+        17: 2,  # 'บ'
+        25: 2,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 3,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 1,  # 'ย'
+        2: 2,  # 'ร'
+        61: 2,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 2,  # 'ว'
+        42: 1,  # 'ศ'
+        46: 1,  # 'ษ'
+        18: 3,  # 'ส'
+        21: 3,  # 'ห'
+        4: 3,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 1,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 3,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 3,  # 'ู'
+        11: 2,  # 'เ'
+        28: 2,  # 'แ'
+        41: 2,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 1,  # 'ๆ'
+        37: 1,  # '็'
+        6: 3,  # '่'
+        7: 2,  # '้'
+        38: 1,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    16: {  # 'ย'
+        5: 3,  # 'ก'
+        30: 1,  # 'ข'
+        24: 2,  # 'ค'
+        8: 3,  # 'ง'
+        26: 2,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 2,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 2,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 2,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 1,  # 'ธ'
+        3: 3,  # 'น'
+        17: 3,  # 'บ'
+        25: 1,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 0,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 1,  # 'ล'
+        12: 3,  # 'ว'
+        42: 1,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 1,  # 'ห'
+        4: 2,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 2,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 2,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 1,  # 'ึ'
+        27: 2,  # 'ื'
+        32: 2,  # 'ุ'
+        35: 3,  # 'ู'
+        11: 2,  # 'เ'
+        28: 1,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 2,  # 'ๆ'
+        37: 1,  # '็'
+        6: 3,  # '่'
+        7: 2,  # '้'
+        38: 3,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    2: {  # 'ร'
+        5: 3,  # 'ก'
+        30: 2,  # 'ข'
+        24: 2,  # 'ค'
+        8: 3,  # 'ง'
+        26: 2,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 2,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 3,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 3,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 2,  # 'ต'
+        44: 3,  # 'ถ'
+        14: 3,  # 'ท'
+        48: 1,  # 'ธ'
+        3: 2,  # 'น'
+        17: 2,  # 'บ'
+        25: 3,  # 'ป'
+        39: 2,  # 'ผ'
+        62: 1,  # 'ฝ'
+        31: 2,  # 'พ'
+        54: 1,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 2,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 3,  # 'ว'
+        42: 2,  # 'ศ'
+        46: 2,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 2,  # 'ห'
+        4: 3,  # 'อ'
+        63: 1,  # 'ฯ'
+        22: 3,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 2,  # 'ึ'
+        27: 3,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 3,  # 'ู'
+        11: 3,  # 'เ'
+        28: 3,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 3,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 3,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    61: {  # 'ฤ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 2,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 2,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    15: {  # 'ล'
+        5: 2,  # 'ก'
+        30: 3,  # 'ข'
+        24: 1,  # 'ค'
+        8: 3,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 2,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 1,  # 'น'
+        17: 2,  # 'บ'
+        25: 2,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 3,  # 'ย'
+        2: 1,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 1,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 1,  # 'ห'
+        4: 3,  # 'อ'
+        63: 2,  # 'ฯ'
+        22: 3,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 2,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 2,  # 'ึ'
+        27: 3,  # 'ื'
+        32: 2,  # 'ุ'
+        35: 3,  # 'ู'
+        11: 2,  # 'เ'
+        28: 1,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 2,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 2,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    12: {  # 'ว'
+        5: 3,  # 'ก'
+        30: 2,  # 'ข'
+        24: 1,  # 'ค'
+        8: 3,  # 'ง'
+        26: 2,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 1,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 1,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 2,  # 'บ'
+        25: 1,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 1,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 3,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 3,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 2,  # 'ห'
+        4: 2,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 2,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 2,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 2,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 3,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 1,  # 'ๆ'
+        37: 0,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 1,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    42: {  # 'ศ'
+        5: 1,  # 'ก'
+        30: 0,  # 'ข'
+        24: 1,  # 'ค'
+        8: 0,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 1,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 1,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 2,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 2,  # 'ว'
+        42: 1,  # 'ศ'
+        46: 2,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 2,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 2,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 3,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 2,  # 'ู'
+        11: 0,  # 'เ'
+        28: 1,  # 'แ'
+        41: 0,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 1,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    46: {  # 'ษ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 2,  # 'ฎ'
+        57: 1,  # 'ฏ'
+        49: 2,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 3,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 1,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 2,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 1,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 2,  # 'ะ'
+        10: 2,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 1,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 1,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 2,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    18: {  # 'ส'
+        5: 2,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 2,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 3,  # 'ต'
+        44: 3,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 2,  # 'บ'
+        25: 1,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 2,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 1,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 1,  # 'ล'
+        12: 2,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 2,  # 'ห'
+        4: 3,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 2,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 3,  # 'ำ'
+        23: 3,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 2,  # 'ึ'
+        27: 3,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 3,  # 'ู'
+        11: 2,  # 'เ'
+        28: 0,  # 'แ'
+        41: 1,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 3,  # '่'
+        7: 1,  # '้'
+        38: 2,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    21: {  # 'ห'
+        5: 3,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 1,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 2,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 3,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 0,  # 'บ'
+        25: 1,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 2,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 3,  # 'ล'
+        12: 2,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 3,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 1,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 0,  # 'ำ'
+        23: 1,  # 'ิ'
+        13: 1,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 1,  # 'ุ'
+        35: 1,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 3,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 2,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    4: {  # 'อ'
+        5: 3,  # 'ก'
+        30: 1,  # 'ข'
+        24: 2,  # 'ค'
+        8: 3,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 2,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 1,  # 'ธ'
+        3: 3,  # 'น'
+        17: 3,  # 'บ'
+        25: 1,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 1,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 3,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 2,  # 'ว'
+        42: 1,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 2,  # 'ห'
+        4: 3,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 2,  # 'ะ'
+        10: 3,  # 'ั'
+        1: 3,  # 'า'
+        36: 2,  # 'ำ'
+        23: 2,  # 'ิ'
+        13: 3,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 3,  # 'ื'
+        32: 3,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 3,  # 'เ'
+        28: 1,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 1,  # 'ๆ'
+        37: 1,  # '็'
+        6: 2,  # '่'
+        7: 2,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    63: {  # 'ฯ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    22: {  # 'ะ'
+        5: 3,  # 'ก'
+        30: 1,  # 'ข'
+        24: 2,  # 'ค'
+        8: 1,  # 'ง'
+        26: 2,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 3,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 3,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 3,  # 'ท'
+        48: 1,  # 'ธ'
+        3: 2,  # 'น'
+        17: 3,  # 'บ'
+        25: 2,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 2,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 2,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 2,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 3,  # 'ส'
+        21: 3,  # 'ห'
+        4: 2,  # 'อ'
+        63: 1,  # 'ฯ'
+        22: 1,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 3,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    10: {  # 'ั'
+        5: 3,  # 'ก'
+        30: 0,  # 'ข'
+        24: 1,  # 'ค'
+        8: 3,  # 'ง'
+        26: 3,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 3,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 2,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 3,  # 'ฒ'
+        43: 3,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 3,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 3,  # 'บ'
+        25: 1,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 2,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 3,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 3,  # 'ว'
+        42: 2,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 3,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    1: {  # 'า'
+        5: 3,  # 'ก'
+        30: 2,  # 'ข'
+        24: 3,  # 'ค'
+        8: 3,  # 'ง'
+        26: 3,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 3,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 2,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 3,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 3,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 3,  # 'ท'
+        48: 2,  # 'ธ'
+        3: 3,  # 'น'
+        17: 3,  # 'บ'
+        25: 2,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 1,  # 'ฝ'
+        31: 3,  # 'พ'
+        54: 1,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 3,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 3,  # 'ล'
+        12: 3,  # 'ว'
+        42: 2,  # 'ศ'
+        46: 3,  # 'ษ'
+        18: 3,  # 'ส'
+        21: 3,  # 'ห'
+        4: 2,  # 'อ'
+        63: 1,  # 'ฯ'
+        22: 3,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 3,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 1,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    36: {  # 'ำ'
+        5: 2,  # 'ก'
+        30: 1,  # 'ข'
+        24: 3,  # 'ค'
+        8: 2,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 1,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 1,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 1,  # 'บ'
+        25: 1,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 0,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 3,  # 'ห'
+        4: 1,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 3,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    23: {  # 'ิ'
+        5: 3,  # 'ก'
+        30: 1,  # 'ข'
+        24: 2,  # 'ค'
+        8: 3,  # 'ง'
+        26: 3,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 3,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 2,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 3,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 3,  # 'ท'
+        48: 3,  # 'ธ'
+        3: 3,  # 'น'
+        17: 3,  # 'บ'
+        25: 2,  # 'ป'
+        39: 2,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 3,  # 'พ'
+        54: 1,  # 'ฟ'
+        45: 2,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 2,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 3,  # 'ว'
+        42: 3,  # 'ศ'
+        46: 2,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 3,  # 'ห'
+        4: 1,  # 'อ'
+        63: 1,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 3,  # 'เ'
+        28: 1,  # 'แ'
+        41: 1,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 3,  # '่'
+        7: 2,  # '้'
+        38: 2,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    13: {  # 'ี'
+        5: 3,  # 'ก'
+        30: 2,  # 'ข'
+        24: 2,  # 'ค'
+        8: 0,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 1,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 1,  # 'น'
+        17: 2,  # 'บ'
+        25: 2,  # 'ป'
+        39: 1,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 2,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 3,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 1,  # 'ล'
+        12: 2,  # 'ว'
+        42: 1,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 1,  # 'ห'
+        4: 2,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 2,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 1,  # 'ๆ'
+        37: 0,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    40: {  # 'ึ'
+        5: 3,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 3,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    27: {  # 'ื'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 2,  # 'น'
+        17: 3,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 3,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    32: {  # 'ุ'
+        5: 3,  # 'ก'
+        30: 2,  # 'ข'
+        24: 3,  # 'ค'
+        8: 3,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 2,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 1,  # 'ฒ'
+        43: 3,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 3,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 1,  # 'ธ'
+        3: 2,  # 'น'
+        17: 2,  # 'บ'
+        25: 2,  # 'ป'
+        39: 2,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 1,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 1,  # 'ว'
+        42: 1,  # 'ศ'
+        46: 2,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 1,  # 'ห'
+        4: 1,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 1,  # 'เ'
+        28: 0,  # 'แ'
+        41: 1,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 3,  # '่'
+        7: 2,  # '้'
+        38: 1,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    35: {  # 'ู'
+        5: 3,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 2,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 2,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 1,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 2,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 2,  # 'น'
+        17: 0,  # 'บ'
+        25: 3,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 0,  # 'ย'
+        2: 1,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 3,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 1,  # 'เ'
+        28: 1,  # 'แ'
+        41: 1,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 3,  # '่'
+        7: 3,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    11: {  # 'เ'
+        5: 3,  # 'ก'
+        30: 3,  # 'ข'
+        24: 3,  # 'ค'
+        8: 2,  # 'ง'
+        26: 3,  # 'จ'
+        52: 3,  # 'ฉ'
+        34: 3,  # 'ช'
+        51: 2,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 1,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 3,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 3,  # 'ท'
+        48: 1,  # 'ธ'
+        3: 3,  # 'น'
+        17: 3,  # 'บ'
+        25: 3,  # 'ป'
+        39: 2,  # 'ผ'
+        62: 1,  # 'ฝ'
+        31: 3,  # 'พ'
+        54: 1,  # 'ฟ'
+        45: 3,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 2,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 3,  # 'ล'
+        12: 3,  # 'ว'
+        42: 2,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 3,  # 'ส'
+        21: 3,  # 'ห'
+        4: 3,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    28: {  # 'แ'
+        5: 3,  # 'ก'
+        30: 2,  # 'ข'
+        24: 2,  # 'ค'
+        8: 1,  # 'ง'
+        26: 2,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 3,  # 'ต'
+        44: 2,  # 'ถ'
+        14: 3,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 3,  # 'บ'
+        25: 2,  # 'ป'
+        39: 3,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 2,  # 'พ'
+        54: 2,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 2,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 3,  # 'ล'
+        12: 2,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 3,  # 'ส'
+        21: 3,  # 'ห'
+        4: 1,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    41: {  # 'โ'
+        5: 2,  # 'ก'
+        30: 1,  # 'ข'
+        24: 2,  # 'ค'
+        8: 0,  # 'ง'
+        26: 1,  # 'จ'
+        52: 1,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 2,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 1,  # 'บ'
+        25: 3,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 1,  # 'ฟ'
+        45: 1,  # 'ภ'
+        9: 1,  # 'ม'
+        16: 2,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 3,  # 'ล'
+        12: 0,  # 'ว'
+        42: 1,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 0,  # 'ห'
+        4: 2,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    29: {  # 'ใ'
+        5: 2,  # 'ก'
+        30: 0,  # 'ข'
+        24: 1,  # 'ค'
+        8: 0,  # 'ง'
+        26: 3,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 3,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 1,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 2,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 1,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 3,  # 'ส'
+        21: 3,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    33: {  # 'ไ'
+        5: 1,  # 'ก'
+        30: 2,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 3,  # 'ด'
+        19: 1,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 3,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 1,  # 'บ'
+        25: 3,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 2,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 0,  # 'ย'
+        2: 3,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 1,  # 'ล'
+        12: 3,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 2,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    50: {  # 'ๆ'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    37: {  # '็'
+        5: 2,  # 'ก'
+        30: 1,  # 'ข'
+        24: 2,  # 'ค'
+        8: 2,  # 'ง'
+        26: 3,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 1,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 2,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 3,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 1,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 2,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 0,  # 'ห'
+        4: 1,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 1,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    6: {  # '่'
+        5: 2,  # 'ก'
+        30: 1,  # 'ข'
+        24: 2,  # 'ค'
+        8: 3,  # 'ง'
+        26: 2,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 1,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 2,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 1,  # 'ธ'
+        3: 3,  # 'น'
+        17: 1,  # 'บ'
+        25: 2,  # 'ป'
+        39: 2,  # 'ผ'
+        62: 1,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 3,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 2,  # 'ล'
+        12: 3,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 1,  # 'ห'
+        4: 3,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 1,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 3,  # 'า'
+        36: 2,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 3,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 1,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    7: {  # '้'
+        5: 2,  # 'ก'
+        30: 1,  # 'ข'
+        24: 2,  # 'ค'
+        8: 3,  # 'ง'
+        26: 2,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 1,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 1,  # 'ด'
+        19: 2,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 2,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 3,  # 'น'
+        17: 2,  # 'บ'
+        25: 2,  # 'ป'
+        39: 2,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 1,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 3,  # 'ม'
+        16: 2,  # 'ย'
+        2: 2,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 1,  # 'ล'
+        12: 3,  # 'ว'
+        42: 1,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 2,  # 'ส'
+        21: 2,  # 'ห'
+        4: 3,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 3,  # 'า'
+        36: 2,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 2,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 2,  # 'ใ'
+        33: 2,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    38: {  # '์'
+        5: 2,  # 'ก'
+        30: 1,  # 'ข'
+        24: 1,  # 'ค'
+        8: 0,  # 'ง'
+        26: 1,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 1,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 2,  # 'ด'
+        19: 1,  # 'ต'
+        44: 1,  # 'ถ'
+        14: 1,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 1,  # 'น'
+        17: 1,  # 'บ'
+        25: 1,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 1,  # 'พ'
+        54: 1,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 2,  # 'ม'
+        16: 0,  # 'ย'
+        2: 1,  # 'ร'
+        61: 1,  # 'ฤ'
+        15: 1,  # 'ล'
+        12: 1,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 1,  # 'ส'
+        21: 1,  # 'ห'
+        4: 2,  # 'อ'
+        63: 1,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 2,  # 'เ'
+        28: 2,  # 'แ'
+        41: 1,  # 'โ'
+        29: 1,  # 'ใ'
+        33: 1,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 0,  # '๑'
+        59: 0,  # '๒'
+        60: 0,  # '๕'
+    },
+    56: {  # '๑'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 2,  # '๑'
+        59: 1,  # '๒'
+        60: 1,  # '๕'
+    },
+    59: {  # '๒'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 1,  # '๑'
+        59: 1,  # '๒'
+        60: 3,  # '๕'
+    },
+    60: {  # '๕'
+        5: 0,  # 'ก'
+        30: 0,  # 'ข'
+        24: 0,  # 'ค'
+        8: 0,  # 'ง'
+        26: 0,  # 'จ'
+        52: 0,  # 'ฉ'
+        34: 0,  # 'ช'
+        51: 0,  # 'ซ'
+        47: 0,  # 'ญ'
+        58: 0,  # 'ฎ'
+        57: 0,  # 'ฏ'
+        49: 0,  # 'ฐ'
+        53: 0,  # 'ฑ'
+        55: 0,  # 'ฒ'
+        43: 0,  # 'ณ'
+        20: 0,  # 'ด'
+        19: 0,  # 'ต'
+        44: 0,  # 'ถ'
+        14: 0,  # 'ท'
+        48: 0,  # 'ธ'
+        3: 0,  # 'น'
+        17: 0,  # 'บ'
+        25: 0,  # 'ป'
+        39: 0,  # 'ผ'
+        62: 0,  # 'ฝ'
+        31: 0,  # 'พ'
+        54: 0,  # 'ฟ'
+        45: 0,  # 'ภ'
+        9: 0,  # 'ม'
+        16: 0,  # 'ย'
+        2: 0,  # 'ร'
+        61: 0,  # 'ฤ'
+        15: 0,  # 'ล'
+        12: 0,  # 'ว'
+        42: 0,  # 'ศ'
+        46: 0,  # 'ษ'
+        18: 0,  # 'ส'
+        21: 0,  # 'ห'
+        4: 0,  # 'อ'
+        63: 0,  # 'ฯ'
+        22: 0,  # 'ะ'
+        10: 0,  # 'ั'
+        1: 0,  # 'า'
+        36: 0,  # 'ำ'
+        23: 0,  # 'ิ'
+        13: 0,  # 'ี'
+        40: 0,  # 'ึ'
+        27: 0,  # 'ื'
+        32: 0,  # 'ุ'
+        35: 0,  # 'ู'
+        11: 0,  # 'เ'
+        28: 0,  # 'แ'
+        41: 0,  # 'โ'
+        29: 0,  # 'ใ'
+        33: 0,  # 'ไ'
+        50: 0,  # 'ๆ'
+        37: 0,  # '็'
+        6: 0,  # '่'
+        7: 0,  # '้'
+        38: 0,  # '์'
+        56: 2,  # '๑'
+        59: 1,  # '๒'
+        60: 0,  # '๕'
+    },
+}
+
+# 255: Undefined characters that did not exist in training text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+# 251: Control characters
+
+# Character Mapping Table(s):
+TIS_620_THAI_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 254,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 254,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 253,  # ' '
+     33: 253,  # '!'
+     34: 253,  # '"'
+     35: 253,  # '#'
+     36: 253,  # '$'
+     37: 253,  # '%'
+     38: 253,  # '&'
+     39: 253,  # "'"
+     40: 253,  # '('
+     41: 253,  # ')'
+     42: 253,  # '*'
+     43: 253,  # '+'
+     44: 253,  # ','
+     45: 253,  # '-'
+     46: 253,  # '.'
+     47: 253,  # '/'
+     48: 252,  # '0'
+     49: 252,  # '1'
+     50: 252,  # '2'
+     51: 252,  # '3'
+     52: 252,  # '4'
+     53: 252,  # '5'
+     54: 252,  # '6'
+     55: 252,  # '7'
+     56: 252,  # '8'
+     57: 252,  # '9'
+     58: 253,  # ':'
+     59: 253,  # ';'
+     60: 253,  # '<'
+     61: 253,  # '='
+     62: 253,  # '>'
+     63: 253,  # '?'
+     64: 253,  # '@'
+     65: 182,  # 'A'
+     66: 106,  # 'B'
+     67: 107,  # 'C'
+     68: 100,  # 'D'
+     69: 183,  # 'E'
+     70: 184,  # 'F'
+     71: 185,  # 'G'
+     72: 101,  # 'H'
+     73: 94,  # 'I'
+     74: 186,  # 'J'
+     75: 187,  # 'K'
+     76: 108,  # 'L'
+     77: 109,  # 'M'
+     78: 110,  # 'N'
+     79: 111,  # 'O'
+     80: 188,  # 'P'
+     81: 189,  # 'Q'
+     82: 190,  # 'R'
+     83: 89,  # 'S'
+     84: 95,  # 'T'
+     85: 112,  # 'U'
+     86: 113,  # 'V'
+     87: 191,  # 'W'
+     88: 192,  # 'X'
+     89: 193,  # 'Y'
+     90: 194,  # 'Z'
+     91: 253,  # '['
+     92: 253,  # '\\'
+     93: 253,  # ']'
+     94: 253,  # '^'
+     95: 253,  # '_'
+     96: 253,  # '`'
+     97: 64,  # 'a'
+     98: 72,  # 'b'
+     99: 73,  # 'c'
+     100: 114,  # 'd'
+     101: 74,  # 'e'
+     102: 115,  # 'f'
+     103: 116,  # 'g'
+     104: 102,  # 'h'
+     105: 81,  # 'i'
+     106: 201,  # 'j'
+     107: 117,  # 'k'
+     108: 90,  # 'l'
+     109: 103,  # 'm'
+     110: 78,  # 'n'
+     111: 82,  # 'o'
+     112: 96,  # 'p'
+     113: 202,  # 'q'
+     114: 91,  # 'r'
+     115: 79,  # 's'
+     116: 84,  # 't'
+     117: 104,  # 'u'
+     118: 105,  # 'v'
+     119: 97,  # 'w'
+     120: 98,  # 'x'
+     121: 92,  # 'y'
+     122: 203,  # 'z'
+     123: 253,  # '{'
+     124: 253,  # '|'
+     125: 253,  # '}'
+     126: 253,  # '~'
+     127: 253,  # '\x7f'
+     128: 209,  # '\x80'
+     129: 210,  # '\x81'
+     130: 211,  # '\x82'
+     131: 212,  # '\x83'
+     132: 213,  # '\x84'
+     133: 88,  # '\x85'
+     134: 214,  # '\x86'
+     135: 215,  # '\x87'
+     136: 216,  # '\x88'
+     137: 217,  # '\x89'
+     138: 218,  # '\x8a'
+     139: 219,  # '\x8b'
+     140: 220,  # '\x8c'
+     141: 118,  # '\x8d'
+     142: 221,  # '\x8e'
+     143: 222,  # '\x8f'
+     144: 223,  # '\x90'
+     145: 224,  # '\x91'
+     146: 99,  # '\x92'
+     147: 85,  # '\x93'
+     148: 83,  # '\x94'
+     149: 225,  # '\x95'
+     150: 226,  # '\x96'
+     151: 227,  # '\x97'
+     152: 228,  # '\x98'
+     153: 229,  # '\x99'
+     154: 230,  # '\x9a'
+     155: 231,  # '\x9b'
+     156: 232,  # '\x9c'
+     157: 233,  # '\x9d'
+     158: 234,  # '\x9e'
+     159: 235,  # '\x9f'
+     160: 236,  # None
+     161: 5,  # 'ก'
+     162: 30,  # 'ข'
+     163: 237,  # 'ฃ'
+     164: 24,  # 'ค'
+     165: 238,  # 'ฅ'
+     166: 75,  # 'ฆ'
+     167: 8,  # 'ง'
+     168: 26,  # 'จ'
+     169: 52,  # 'ฉ'
+     170: 34,  # 'ช'
+     171: 51,  # 'ซ'
+     172: 119,  # 'ฌ'
+     173: 47,  # 'ญ'
+     174: 58,  # 'ฎ'
+     175: 57,  # 'ฏ'
+     176: 49,  # 'ฐ'
+     177: 53,  # 'ฑ'
+     178: 55,  # 'ฒ'
+     179: 43,  # 'ณ'
+     180: 20,  # 'ด'
+     181: 19,  # 'ต'
+     182: 44,  # 'ถ'
+     183: 14,  # 'ท'
+     184: 48,  # 'ธ'
+     185: 3,  # 'น'
+     186: 17,  # 'บ'
+     187: 25,  # 'ป'
+     188: 39,  # 'ผ'
+     189: 62,  # 'ฝ'
+     190: 31,  # 'พ'
+     191: 54,  # 'ฟ'
+     192: 45,  # 'ภ'
+     193: 9,  # 'ม'
+     194: 16,  # 'ย'
+     195: 2,  # 'ร'
+     196: 61,  # 'ฤ'
+     197: 15,  # 'ล'
+     198: 239,  # 'ฦ'
+     199: 12,  # 'ว'
+     200: 42,  # 'ศ'
+     201: 46,  # 'ษ'
+     202: 18,  # 'ส'
+     203: 21,  # 'ห'
+     204: 76,  # 'ฬ'
+     205: 4,  # 'อ'
+     206: 66,  # 'ฮ'
+     207: 63,  # 'ฯ'
+     208: 22,  # 'ะ'
+     209: 10,  # 'ั'
+     210: 1,  # 'า'
+     211: 36,  # 'ำ'
+     212: 23,  # 'ิ'
+     213: 13,  # 'ี'
+     214: 40,  # 'ึ'
+     215: 27,  # 'ื'
+     216: 32,  # 'ุ'
+     217: 35,  # 'ู'
+     218: 86,  # 'ฺ'
+     219: 240,  # None
+     220: 241,  # None
+     221: 242,  # None
+     222: 243,  # None
+     223: 244,  # '฿'
+     224: 11,  # 'เ'
+     225: 28,  # 'แ'
+     226: 41,  # 'โ'
+     227: 29,  # 'ใ'
+     228: 33,  # 'ไ'
+     229: 245,  # 'ๅ'
+     230: 50,  # 'ๆ'
+     231: 37,  # '็'
+     232: 6,  # '่'
+     233: 7,  # '้'
+     234: 67,  # '๊'
+     235: 77,  # '๋'
+     236: 38,  # '์'
+     237: 93,  # 'ํ'
+     238: 246,  # '๎'
+     239: 247,  # '๏'
+     240: 68,  # '๐'
+     241: 56,  # '๑'
+     242: 59,  # '๒'
+     243: 65,  # '๓'
+     244: 69,  # '๔'
+     245: 60,  # '๕'
+     246: 70,  # '๖'
+     247: 80,  # '๗'
+     248: 71,  # '๘'
+     249: 87,  # '๙'
+     250: 248,  # '๚'
+     251: 249,  # '๛'
+     252: 250,  # None
+     253: 251,  # None
+     254: 252,  # None
+     255: 253,  # None
+}
+
+TIS_620_THAI_MODEL = SingleByteCharSetModel(charset_name='TIS-620',
+                                            language='Thai',
+                                            char_to_order_map=TIS_620_THAI_CHAR_TO_ORDER,
+                                            language_model=THAI_LANG_MODEL,
+                                            typical_positive_ratio=0.926386,
+                                            keep_ascii_letters=False,
+                                            alphabet='กขฃคฅฆงจฉชซฌญฎฏฐฑฒณดตถทธนบปผฝพฟภมยรฤลฦวศษสหฬอฮฯะัาำิีึืฺุู฿เแโใไๅๆ็่้๊๋์ํ๎๏๐๑๒๓๔๕๖๗๘๙๚๛')
+
diff --git a/openpype/vendor/python/python_2/chardet/langturkishmodel.py b/openpype/vendor/python/python_2/chardet/langturkishmodel.py
new file mode 100644
index 0000000000..8ba93224de
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/langturkishmodel.py
@@ -0,0 +1,4383 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from chardet.sbcharsetprober import SingleByteCharSetModel
+
+
+# 3: Positive
+# 2: Likely
+# 1: Unlikely
+# 0: Negative
+
+TURKISH_LANG_MODEL = {
+    23: {  # 'A'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 0,  # 'c'
+        12: 2,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 1,  # 'g'
+        25: 1,  # 'h'
+        3: 1,  # 'i'
+        24: 0,  # 'j'
+        10: 2,  # 'k'
+        5: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 1,  # 'r'
+        8: 1,  # 's'
+        9: 1,  # 't'
+        14: 1,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 3,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 0,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    37: {  # 'B'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 2,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 2,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 1,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 1,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 0,  # 'Z'
+        1: 2,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 0,  # 'k'
+        5: 0,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 2,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 1,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 1,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 0,  # 'ı'
+        40: 1,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    47: {  # 'C'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 1,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 1,  # 'L'
+        20: 0,  # 'M'
+        46: 1,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 1,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 2,  # 'j'
+        10: 1,  # 'k'
+        5: 2,  # 'l'
+        13: 2,  # 'm'
+        4: 2,  # 'n'
+        15: 1,  # 'o'
+        26: 0,  # 'p'
+        7: 2,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 1,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    39: {  # 'D'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 1,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 1,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 2,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 2,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 0,  # 'k'
+        5: 1,  # 'l'
+        13: 3,  # 'm'
+        4: 0,  # 'n'
+        15: 1,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 1,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 1,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 1,  # 'ı'
+        40: 1,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    29: {  # 'E'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 1,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 0,  # 'c'
+        12: 2,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 1,  # 'g'
+        25: 0,  # 'h'
+        3: 1,  # 'i'
+        24: 1,  # 'j'
+        10: 0,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 1,  # 's'
+        9: 1,  # 't'
+        14: 1,  # 'u'
+        32: 1,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 2,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    52: {  # 'F'
+        23: 0,  # 'A'
+        37: 1,  # 'B'
+        47: 1,  # 'C'
+        39: 1,  # 'D'
+        29: 1,  # 'E'
+        52: 2,  # 'F'
+        36: 0,  # 'G'
+        45: 2,  # 'H'
+        53: 1,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 1,  # 'N'
+        42: 1,  # 'O'
+        48: 2,  # 'P'
+        44: 1,  # 'R'
+        35: 1,  # 'S'
+        31: 1,  # 'T'
+        51: 1,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 2,  # 'Y'
+        56: 0,  # 'Z'
+        1: 0,  # 'a'
+        21: 1,  # 'b'
+        28: 1,  # 'c'
+        12: 1,  # 'd'
+        2: 0,  # 'e'
+        18: 1,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 2,  # 'i'
+        24: 1,  # 'j'
+        10: 0,  # 'k'
+        5: 0,  # 'l'
+        13: 1,  # 'm'
+        4: 2,  # 'n'
+        15: 1,  # 'o'
+        26: 0,  # 'p'
+        7: 2,  # 'r'
+        8: 1,  # 's'
+        9: 1,  # 't'
+        14: 1,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 1,  # 'y'
+        22: 1,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 1,  # 'Ö'
+        55: 2,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 2,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 2,  # 'ş'
+    },
+    36: {  # 'G'
+        23: 1,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 1,  # 'F'
+        36: 2,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 2,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 2,  # 'N'
+        42: 1,  # 'O'
+        48: 1,  # 'P'
+        44: 1,  # 'R'
+        35: 1,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 2,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 1,  # 'c'
+        12: 0,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 1,  # 'j'
+        10: 1,  # 'k'
+        5: 0,  # 'l'
+        13: 3,  # 'm'
+        4: 2,  # 'n'
+        15: 0,  # 'o'
+        26: 1,  # 'p'
+        7: 0,  # 'r'
+        8: 1,  # 's'
+        9: 1,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 1,  # 'x'
+        11: 0,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 2,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 1,  # 'â'
+        33: 2,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 2,  # 'ı'
+        40: 2,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    45: {  # 'H'
+        23: 0,  # 'A'
+        37: 1,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 2,  # 'F'
+        36: 2,  # 'G'
+        45: 1,  # 'H'
+        53: 1,  # 'I'
+        60: 0,  # 'J'
+        16: 2,  # 'K'
+        49: 1,  # 'L'
+        20: 0,  # 'M'
+        46: 1,  # 'N'
+        42: 1,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 2,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 2,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 2,  # 'i'
+        24: 0,  # 'j'
+        10: 1,  # 'k'
+        5: 0,  # 'l'
+        13: 2,  # 'm'
+        4: 0,  # 'n'
+        15: 1,  # 'o'
+        26: 1,  # 'p'
+        7: 1,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 1,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 2,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 0,  # 'ı'
+        40: 2,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    53: {  # 'I'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 1,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 2,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 2,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 2,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 0,  # 'k'
+        5: 2,  # 'l'
+        13: 2,  # 'm'
+        4: 0,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 2,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 2,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 0,  # 'ı'
+        40: 1,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    60: {  # 'J'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 0,  # 'a'
+        21: 1,  # 'b'
+        28: 0,  # 'c'
+        12: 1,  # 'd'
+        2: 0,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 1,  # 'i'
+        24: 0,  # 'j'
+        10: 0,  # 'k'
+        5: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 1,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 1,  # 's'
+        9: 0,  # 't'
+        14: 0,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 0,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    16: {  # 'K'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 3,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 2,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 2,  # 'a'
+        21: 3,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 1,  # 'e'
+        18: 3,  # 'f'
+        27: 3,  # 'g'
+        25: 3,  # 'h'
+        3: 3,  # 'i'
+        24: 2,  # 'j'
+        10: 3,  # 'k'
+        5: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 1,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 0,  # 'u'
+        32: 3,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 2,  # 'y'
+        22: 1,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 2,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    49: {  # 'L'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 2,  # 'E'
+        52: 0,  # 'F'
+        36: 1,  # 'G'
+        45: 1,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 0,  # 'N'
+        42: 2,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 0,  # 'Z'
+        1: 0,  # 'a'
+        21: 3,  # 'b'
+        28: 0,  # 'c'
+        12: 2,  # 'd'
+        2: 0,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 2,  # 'i'
+        24: 0,  # 'j'
+        10: 1,  # 'k'
+        5: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 2,  # 'n'
+        15: 1,  # 'o'
+        26: 1,  # 'p'
+        7: 1,  # 'r'
+        8: 1,  # 's'
+        9: 1,  # 't'
+        14: 0,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 2,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 2,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 1,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    20: {  # 'M'
+        23: 1,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 1,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 1,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 2,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 1,  # 'g'
+        25: 1,  # 'h'
+        3: 2,  # 'i'
+        24: 2,  # 'j'
+        10: 2,  # 'k'
+        5: 2,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 1,  # 'p'
+        7: 3,  # 'r'
+        8: 0,  # 's'
+        9: 2,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 2,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 3,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    46: {  # 'N'
+        23: 0,  # 'A'
+        37: 1,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 1,  # 'F'
+        36: 1,  # 'G'
+        45: 1,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 2,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 1,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 1,  # 'R'
+        35: 1,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 2,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 1,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 2,  # 'j'
+        10: 1,  # 'k'
+        5: 1,  # 'l'
+        13: 3,  # 'm'
+        4: 2,  # 'n'
+        15: 1,  # 'o'
+        26: 1,  # 'p'
+        7: 1,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 1,  # 'x'
+        11: 1,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 1,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 2,  # 'ı'
+        40: 1,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    42: {  # 'O'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 1,  # 'F'
+        36: 0,  # 'G'
+        45: 1,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 2,  # 'K'
+        49: 1,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 2,  # 'P'
+        44: 1,  # 'R'
+        35: 1,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 2,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 0,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 0,  # 'n'
+        15: 1,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 2,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 2,  # 'Ç'
+        50: 1,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 2,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 2,  # 'İ'
+        6: 1,  # 'ı'
+        40: 1,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    48: {  # 'P'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 2,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 2,  # 'F'
+        36: 1,  # 'G'
+        45: 1,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 2,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 1,  # 'N'
+        42: 1,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 1,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 2,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 1,  # 'k'
+        5: 0,  # 'l'
+        13: 2,  # 'm'
+        4: 0,  # 'n'
+        15: 2,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 2,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 2,  # 'x'
+        11: 0,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 2,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 2,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 0,  # 'ı'
+        40: 2,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    44: {  # 'R'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 1,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 1,  # 'b'
+        28: 1,  # 'c'
+        12: 0,  # 'd'
+        2: 2,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 1,  # 'k'
+        5: 2,  # 'l'
+        13: 2,  # 'm'
+        4: 0,  # 'n'
+        15: 1,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 2,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 1,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 1,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 1,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 2,  # 'ı'
+        40: 1,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    35: {  # 'S'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 1,  # 'F'
+        36: 1,  # 'G'
+        45: 1,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 1,  # 'L'
+        20: 1,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 1,  # 'k'
+        5: 1,  # 'l'
+        13: 2,  # 'm'
+        4: 1,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 1,  # 't'
+        14: 2,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 1,  # 'z'
+        63: 0,  # '·'
+        54: 2,  # 'Ç'
+        50: 2,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 3,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 2,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    31: {  # 'T'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 1,  # 'J'
+        16: 2,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 2,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 2,  # 'b'
+        28: 0,  # 'c'
+        12: 1,  # 'd'
+        2: 3,  # 'e'
+        18: 2,  # 'f'
+        27: 2,  # 'g'
+        25: 0,  # 'h'
+        3: 1,  # 'i'
+        24: 1,  # 'j'
+        10: 2,  # 'k'
+        5: 2,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 2,  # 'p'
+        7: 2,  # 'r'
+        8: 0,  # 's'
+        9: 2,  # 't'
+        14: 2,  # 'u'
+        32: 1,  # 'v'
+        57: 1,  # 'w'
+        58: 1,  # 'x'
+        11: 2,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 1,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    51: {  # 'U'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 1,  # 'F'
+        36: 1,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 1,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 1,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 1,  # 'c'
+        12: 0,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 2,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 1,  # 'k'
+        5: 1,  # 'l'
+        13: 3,  # 'm'
+        4: 2,  # 'n'
+        15: 0,  # 'o'
+        26: 1,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 2,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 1,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    38: {  # 'V'
+        23: 1,  # 'A'
+        37: 1,  # 'B'
+        47: 1,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 2,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 3,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 1,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 0,  # 'k'
+        5: 2,  # 'l'
+        13: 2,  # 'm'
+        4: 0,  # 'n'
+        15: 2,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 1,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 1,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 1,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 1,  # 'â'
+        33: 2,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 3,  # 'ı'
+        40: 2,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    62: {  # 'W'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 0,  # 'a'
+        21: 0,  # 'b'
+        28: 0,  # 'c'
+        12: 0,  # 'd'
+        2: 0,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 0,  # 'k'
+        5: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 0,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 0,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 0,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    43: {  # 'Y'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 2,  # 'F'
+        36: 0,  # 'G'
+        45: 1,  # 'H'
+        53: 1,  # 'I'
+        60: 0,  # 'J'
+        16: 2,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 2,  # 'N'
+        42: 0,  # 'O'
+        48: 2,  # 'P'
+        44: 1,  # 'R'
+        35: 1,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 2,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 2,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 1,  # 'j'
+        10: 1,  # 'k'
+        5: 1,  # 'l'
+        13: 3,  # 'm'
+        4: 0,  # 'n'
+        15: 2,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 1,  # 'x'
+        11: 0,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 2,  # 'Ö'
+        55: 1,  # 'Ü'
+        59: 1,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 0,  # 'ı'
+        40: 2,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    56: {  # 'Z'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 2,  # 'Z'
+        1: 2,  # 'a'
+        21: 1,  # 'b'
+        28: 0,  # 'c'
+        12: 0,  # 'd'
+        2: 2,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 2,  # 'i'
+        24: 1,  # 'j'
+        10: 0,  # 'k'
+        5: 0,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 1,  # 'r'
+        8: 1,  # 's'
+        9: 0,  # 't'
+        14: 2,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 1,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 1,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    1: {  # 'a'
+        23: 3,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 0,  # 'D'
+        29: 3,  # 'E'
+        52: 0,  # 'F'
+        36: 1,  # 'G'
+        45: 1,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 3,  # 'M'
+        46: 1,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 3,  # 'T'
+        51: 0,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 2,  # 'Z'
+        1: 2,  # 'a'
+        21: 3,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 2,  # 'e'
+        18: 3,  # 'f'
+        27: 3,  # 'g'
+        25: 3,  # 'h'
+        3: 3,  # 'i'
+        24: 3,  # 'j'
+        10: 3,  # 'k'
+        5: 0,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        15: 1,  # 'o'
+        26: 3,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 3,  # 'u'
+        32: 3,  # 'v'
+        57: 2,  # 'w'
+        58: 0,  # 'x'
+        11: 3,  # 'y'
+        22: 0,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 1,  # 'î'
+        34: 1,  # 'ö'
+        17: 3,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    21: {  # 'b'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 1,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 1,  # 'J'
+        16: 2,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 1,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 2,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 3,  # 'g'
+        25: 1,  # 'h'
+        3: 3,  # 'i'
+        24: 2,  # 'j'
+        10: 3,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 3,  # 'p'
+        7: 1,  # 'r'
+        8: 2,  # 's'
+        9: 2,  # 't'
+        14: 2,  # 'u'
+        32: 1,  # 'v'
+        57: 0,  # 'w'
+        58: 1,  # 'x'
+        11: 3,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    28: {  # 'c'
+        23: 0,  # 'A'
+        37: 1,  # 'B'
+        47: 1,  # 'C'
+        39: 1,  # 'D'
+        29: 2,  # 'E'
+        52: 0,  # 'F'
+        36: 2,  # 'G'
+        45: 2,  # 'H'
+        53: 1,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 1,  # 'N'
+        42: 1,  # 'O'
+        48: 2,  # 'P'
+        44: 1,  # 'R'
+        35: 1,  # 'S'
+        31: 2,  # 'T'
+        51: 2,  # 'U'
+        38: 2,  # 'V'
+        62: 0,  # 'W'
+        43: 3,  # 'Y'
+        56: 0,  # 'Z'
+        1: 1,  # 'a'
+        21: 1,  # 'b'
+        28: 2,  # 'c'
+        12: 2,  # 'd'
+        2: 1,  # 'e'
+        18: 1,  # 'f'
+        27: 2,  # 'g'
+        25: 2,  # 'h'
+        3: 3,  # 'i'
+        24: 1,  # 'j'
+        10: 3,  # 'k'
+        5: 0,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        15: 2,  # 'o'
+        26: 2,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 1,  # 'u'
+        32: 0,  # 'v'
+        57: 1,  # 'w'
+        58: 0,  # 'x'
+        11: 2,  # 'y'
+        22: 1,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 1,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 1,  # 'î'
+        34: 2,  # 'ö'
+        17: 2,  # 'ü'
+        30: 2,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 2,  # 'ş'
+    },
+    12: {  # 'd'
+        23: 1,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 2,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 3,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 1,  # 'S'
+        31: 1,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 2,  # 'b'
+        28: 1,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 1,  # 'f'
+        27: 3,  # 'g'
+        25: 3,  # 'h'
+        3: 2,  # 'i'
+        24: 3,  # 'j'
+        10: 2,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 1,  # 'o'
+        26: 2,  # 'p'
+        7: 3,  # 'r'
+        8: 2,  # 's'
+        9: 2,  # 't'
+        14: 3,  # 'u'
+        32: 1,  # 'v'
+        57: 0,  # 'w'
+        58: 1,  # 'x'
+        11: 3,  # 'y'
+        22: 1,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 1,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    2: {  # 'e'
+        23: 2,  # 'A'
+        37: 0,  # 'B'
+        47: 2,  # 'C'
+        39: 0,  # 'D'
+        29: 3,  # 'E'
+        52: 1,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 1,  # 'K'
+        49: 0,  # 'L'
+        20: 3,  # 'M'
+        46: 1,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 1,  # 'R'
+        35: 0,  # 'S'
+        31: 3,  # 'T'
+        51: 0,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 3,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 2,  # 'e'
+        18: 3,  # 'f'
+        27: 3,  # 'g'
+        25: 3,  # 'h'
+        3: 3,  # 'i'
+        24: 3,  # 'j'
+        10: 3,  # 'k'
+        5: 0,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        15: 1,  # 'o'
+        26: 3,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 3,  # 'u'
+        32: 3,  # 'v'
+        57: 2,  # 'w'
+        58: 0,  # 'x'
+        11: 3,  # 'y'
+        22: 1,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 3,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    18: {  # 'f'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 2,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 2,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 1,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 2,  # 'f'
+        27: 1,  # 'g'
+        25: 1,  # 'h'
+        3: 1,  # 'i'
+        24: 1,  # 'j'
+        10: 1,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 2,  # 'p'
+        7: 1,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 1,  # 'u'
+        32: 2,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 1,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 1,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 1,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    27: {  # 'g'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 1,  # 'S'
+        31: 1,  # 'T'
+        51: 0,  # 'U'
+        38: 2,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 1,  # 'b'
+        28: 0,  # 'c'
+        12: 1,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 2,  # 'g'
+        25: 1,  # 'h'
+        3: 2,  # 'i'
+        24: 3,  # 'j'
+        10: 2,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 2,  # 'n'
+        15: 0,  # 'o'
+        26: 1,  # 'p'
+        7: 2,  # 'r'
+        8: 2,  # 's'
+        9: 3,  # 't'
+        14: 3,  # 'u'
+        32: 1,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 1,  # 'y'
+        22: 0,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    25: {  # 'h'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 2,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 0,  # 'c'
+        12: 2,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 1,  # 'g'
+        25: 2,  # 'h'
+        3: 2,  # 'i'
+        24: 3,  # 'j'
+        10: 3,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 1,  # 'o'
+        26: 1,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 2,  # 't'
+        14: 3,  # 'u'
+        32: 2,  # 'v'
+        57: 1,  # 'w'
+        58: 0,  # 'x'
+        11: 1,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    3: {  # 'i'
+        23: 2,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 1,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 3,  # 'M'
+        46: 0,  # 'N'
+        42: 1,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 1,  # 'S'
+        31: 2,  # 'T'
+        51: 0,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 2,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 2,  # 'f'
+        27: 3,  # 'g'
+        25: 1,  # 'h'
+        3: 3,  # 'i'
+        24: 2,  # 'j'
+        10: 3,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 1,  # 'o'
+        26: 3,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 3,  # 'u'
+        32: 2,  # 'v'
+        57: 1,  # 'w'
+        58: 1,  # 'x'
+        11: 3,  # 'y'
+        22: 1,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 1,  # 'Ü'
+        59: 0,  # 'â'
+        33: 2,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 3,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    24: {  # 'j'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 1,  # 'J'
+        16: 2,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 1,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 1,  # 'Z'
+        1: 3,  # 'a'
+        21: 1,  # 'b'
+        28: 1,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 2,  # 'f'
+        27: 1,  # 'g'
+        25: 1,  # 'h'
+        3: 2,  # 'i'
+        24: 1,  # 'j'
+        10: 2,  # 'k'
+        5: 2,  # 'l'
+        13: 3,  # 'm'
+        4: 2,  # 'n'
+        15: 0,  # 'o'
+        26: 1,  # 'p'
+        7: 2,  # 'r'
+        8: 3,  # 's'
+        9: 2,  # 't'
+        14: 3,  # 'u'
+        32: 2,  # 'v'
+        57: 0,  # 'w'
+        58: 2,  # 'x'
+        11: 1,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 1,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    10: {  # 'k'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 3,  # 'T'
+        51: 0,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 1,  # 'Z'
+        1: 3,  # 'a'
+        21: 2,  # 'b'
+        28: 0,  # 'c'
+        12: 2,  # 'd'
+        2: 3,  # 'e'
+        18: 1,  # 'f'
+        27: 2,  # 'g'
+        25: 2,  # 'h'
+        3: 3,  # 'i'
+        24: 2,  # 'j'
+        10: 2,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 3,  # 'p'
+        7: 2,  # 'r'
+        8: 2,  # 's'
+        9: 2,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 1,  # 'x'
+        11: 3,  # 'y'
+        22: 0,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 3,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 3,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    5: {  # 'l'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 3,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 1,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 0,  # 'a'
+        21: 3,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 1,  # 'e'
+        18: 3,  # 'f'
+        27: 3,  # 'g'
+        25: 2,  # 'h'
+        3: 3,  # 'i'
+        24: 2,  # 'j'
+        10: 3,  # 'k'
+        5: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 2,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 2,  # 'u'
+        32: 2,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 3,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 2,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    13: {  # 'm'
+        23: 1,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 3,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 3,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 3,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 0,  # 'Z'
+        1: 2,  # 'a'
+        21: 3,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 2,  # 'e'
+        18: 3,  # 'f'
+        27: 3,  # 'g'
+        25: 3,  # 'h'
+        3: 3,  # 'i'
+        24: 3,  # 'j'
+        10: 3,  # 'k'
+        5: 0,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        15: 1,  # 'o'
+        26: 2,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 2,  # 'u'
+        32: 2,  # 'v'
+        57: 1,  # 'w'
+        58: 0,  # 'x'
+        11: 3,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 3,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    4: {  # 'n'
+        23: 1,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 1,  # 'H'
+        53: 0,  # 'I'
+        60: 2,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 3,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 2,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 2,  # 'b'
+        28: 1,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 1,  # 'f'
+        27: 2,  # 'g'
+        25: 3,  # 'h'
+        3: 2,  # 'i'
+        24: 2,  # 'j'
+        10: 3,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 1,  # 'o'
+        26: 3,  # 'p'
+        7: 2,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 3,  # 'u'
+        32: 2,  # 'v'
+        57: 0,  # 'w'
+        58: 2,  # 'x'
+        11: 3,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 2,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 1,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    15: {  # 'o'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 2,  # 'F'
+        36: 1,  # 'G'
+        45: 1,  # 'H'
+        53: 1,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 2,  # 'L'
+        20: 0,  # 'M'
+        46: 2,  # 'N'
+        42: 1,  # 'O'
+        48: 2,  # 'P'
+        44: 1,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 1,  # 'i'
+        24: 2,  # 'j'
+        10: 1,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 2,  # 'n'
+        15: 2,  # 'o'
+        26: 0,  # 'p'
+        7: 1,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 2,  # 'x'
+        11: 0,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 2,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 3,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 2,  # 'ğ'
+        41: 2,  # 'İ'
+        6: 3,  # 'ı'
+        40: 2,  # 'Ş'
+        19: 2,  # 'ş'
+    },
+    26: {  # 'p'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 1,  # 'b'
+        28: 0,  # 'c'
+        12: 1,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 1,  # 'g'
+        25: 1,  # 'h'
+        3: 2,  # 'i'
+        24: 3,  # 'j'
+        10: 1,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 2,  # 'n'
+        15: 0,  # 'o'
+        26: 2,  # 'p'
+        7: 2,  # 'r'
+        8: 1,  # 's'
+        9: 1,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 1,  # 'x'
+        11: 1,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 3,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 1,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    7: {  # 'r'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 1,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 2,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 2,  # 'T'
+        51: 1,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 1,  # 'Z'
+        1: 3,  # 'a'
+        21: 1,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 2,  # 'g'
+        25: 3,  # 'h'
+        3: 2,  # 'i'
+        24: 2,  # 'j'
+        10: 3,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 2,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 3,  # 'u'
+        32: 2,  # 'v'
+        57: 0,  # 'w'
+        58: 1,  # 'x'
+        11: 2,  # 'y'
+        22: 0,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 2,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 3,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    8: {  # 's'
+        23: 1,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 1,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 3,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 2,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 1,  # 'Z'
+        1: 3,  # 'a'
+        21: 2,  # 'b'
+        28: 1,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 2,  # 'g'
+        25: 2,  # 'h'
+        3: 2,  # 'i'
+        24: 3,  # 'j'
+        10: 3,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 3,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 3,  # 'u'
+        32: 2,  # 'v'
+        57: 0,  # 'w'
+        58: 1,  # 'x'
+        11: 2,  # 'y'
+        22: 1,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 2,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 2,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    9: {  # 't'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 1,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 2,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 1,  # 'Z'
+        1: 3,  # 'a'
+        21: 3,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 2,  # 'f'
+        27: 2,  # 'g'
+        25: 2,  # 'h'
+        3: 2,  # 'i'
+        24: 2,  # 'j'
+        10: 3,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 2,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 3,  # 'u'
+        32: 3,  # 'v'
+        57: 0,  # 'w'
+        58: 2,  # 'x'
+        11: 2,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 3,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 2,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    14: {  # 'u'
+        23: 3,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 3,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 1,  # 'H'
+        53: 0,  # 'I'
+        60: 1,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 3,  # 'M'
+        46: 2,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 3,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 2,  # 'Z'
+        1: 2,  # 'a'
+        21: 3,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 2,  # 'e'
+        18: 2,  # 'f'
+        27: 3,  # 'g'
+        25: 3,  # 'h'
+        3: 3,  # 'i'
+        24: 2,  # 'j'
+        10: 3,  # 'k'
+        5: 0,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 3,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 3,  # 'u'
+        32: 2,  # 'v'
+        57: 2,  # 'w'
+        58: 0,  # 'x'
+        11: 3,  # 'y'
+        22: 0,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 3,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    32: {  # 'v'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 0,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 1,  # 'j'
+        10: 1,  # 'k'
+        5: 3,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 1,  # 'p'
+        7: 1,  # 'r'
+        8: 2,  # 's'
+        9: 3,  # 't'
+        14: 3,  # 'u'
+        32: 1,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 2,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 1,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    57: {  # 'w'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 1,  # 'a'
+        21: 0,  # 'b'
+        28: 0,  # 'c'
+        12: 0,  # 'd'
+        2: 2,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 1,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 1,  # 'k'
+        5: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 1,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 1,  # 's'
+        9: 0,  # 't'
+        14: 1,  # 'u'
+        32: 0,  # 'v'
+        57: 2,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 0,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 1,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 0,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    58: {  # 'x'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 1,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 1,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 0,  # 'a'
+        21: 1,  # 'b'
+        28: 0,  # 'c'
+        12: 2,  # 'd'
+        2: 1,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 2,  # 'i'
+        24: 2,  # 'j'
+        10: 1,  # 'k'
+        5: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 2,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 1,  # 'r'
+        8: 2,  # 's'
+        9: 1,  # 't'
+        14: 0,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 2,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 1,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    11: {  # 'y'
+        23: 1,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 1,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 1,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 1,  # 'Z'
+        1: 3,  # 'a'
+        21: 1,  # 'b'
+        28: 0,  # 'c'
+        12: 2,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 2,  # 'g'
+        25: 2,  # 'h'
+        3: 2,  # 'i'
+        24: 1,  # 'j'
+        10: 2,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 1,  # 'p'
+        7: 2,  # 'r'
+        8: 1,  # 's'
+        9: 2,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 1,  # 'x'
+        11: 3,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 3,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 2,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    22: {  # 'z'
+        23: 2,  # 'A'
+        37: 2,  # 'B'
+        47: 1,  # 'C'
+        39: 2,  # 'D'
+        29: 3,  # 'E'
+        52: 1,  # 'F'
+        36: 2,  # 'G'
+        45: 2,  # 'H'
+        53: 1,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 3,  # 'M'
+        46: 2,  # 'N'
+        42: 2,  # 'O'
+        48: 2,  # 'P'
+        44: 1,  # 'R'
+        35: 1,  # 'S'
+        31: 3,  # 'T'
+        51: 2,  # 'U'
+        38: 2,  # 'V'
+        62: 0,  # 'W'
+        43: 2,  # 'Y'
+        56: 1,  # 'Z'
+        1: 1,  # 'a'
+        21: 2,  # 'b'
+        28: 1,  # 'c'
+        12: 2,  # 'd'
+        2: 2,  # 'e'
+        18: 3,  # 'f'
+        27: 2,  # 'g'
+        25: 2,  # 'h'
+        3: 3,  # 'i'
+        24: 2,  # 'j'
+        10: 3,  # 'k'
+        5: 0,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        15: 2,  # 'o'
+        26: 2,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 0,  # 'u'
+        32: 2,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 3,  # 'y'
+        22: 2,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 2,  # 'Ü'
+        59: 1,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 2,  # 'ö'
+        17: 2,  # 'ü'
+        30: 2,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 3,  # 'ı'
+        40: 1,  # 'Ş'
+        19: 2,  # 'ş'
+    },
+    63: {  # '·'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 0,  # 'a'
+        21: 0,  # 'b'
+        28: 0,  # 'c'
+        12: 0,  # 'd'
+        2: 1,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 0,  # 'k'
+        5: 0,  # 'l'
+        13: 2,  # 'm'
+        4: 0,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 2,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 0,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    54: {  # 'Ç'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 1,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 1,  # 'G'
+        45: 1,  # 'H'
+        53: 1,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 1,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 2,  # 'Y'
+        56: 0,  # 'Z'
+        1: 0,  # 'a'
+        21: 1,  # 'b'
+        28: 0,  # 'c'
+        12: 1,  # 'd'
+        2: 0,  # 'e'
+        18: 0,  # 'f'
+        27: 1,  # 'g'
+        25: 0,  # 'h'
+        3: 3,  # 'i'
+        24: 0,  # 'j'
+        10: 1,  # 'k'
+        5: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 2,  # 'n'
+        15: 1,  # 'o'
+        26: 0,  # 'p'
+        7: 2,  # 'r'
+        8: 0,  # 's'
+        9: 1,  # 't'
+        14: 0,  # 'u'
+        32: 2,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 2,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    50: {  # 'Ö'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 1,  # 'D'
+        29: 2,  # 'E'
+        52: 0,  # 'F'
+        36: 1,  # 'G'
+        45: 2,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 1,  # 'N'
+        42: 2,  # 'O'
+        48: 2,  # 'P'
+        44: 1,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 2,  # 'Y'
+        56: 0,  # 'Z'
+        1: 0,  # 'a'
+        21: 2,  # 'b'
+        28: 1,  # 'c'
+        12: 2,  # 'd'
+        2: 0,  # 'e'
+        18: 1,  # 'f'
+        27: 1,  # 'g'
+        25: 1,  # 'h'
+        3: 2,  # 'i'
+        24: 0,  # 'j'
+        10: 2,  # 'k'
+        5: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 3,  # 'n'
+        15: 2,  # 'o'
+        26: 2,  # 'p'
+        7: 3,  # 'r'
+        8: 1,  # 's'
+        9: 2,  # 't'
+        14: 0,  # 'u'
+        32: 1,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 1,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 2,  # 'ö'
+        17: 2,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    55: {  # 'Ü'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 2,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 1,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 1,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 2,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 2,  # 'e'
+        18: 0,  # 'f'
+        27: 1,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 0,  # 'k'
+        5: 1,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 1,  # 't'
+        14: 2,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 1,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 1,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 0,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    59: {  # 'â'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 1,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 1,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 2,  # 'a'
+        21: 0,  # 'b'
+        28: 0,  # 'c'
+        12: 0,  # 'd'
+        2: 2,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 0,  # 'j'
+        10: 0,  # 'k'
+        5: 0,  # 'l'
+        13: 2,  # 'm'
+        4: 0,  # 'n'
+        15: 1,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 2,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 1,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 1,  # 'ı'
+        40: 1,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    33: {  # 'ç'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 3,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 2,  # 'T'
+        51: 0,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 0,  # 'Z'
+        1: 0,  # 'a'
+        21: 3,  # 'b'
+        28: 0,  # 'c'
+        12: 2,  # 'd'
+        2: 0,  # 'e'
+        18: 2,  # 'f'
+        27: 1,  # 'g'
+        25: 3,  # 'h'
+        3: 3,  # 'i'
+        24: 0,  # 'j'
+        10: 3,  # 'k'
+        5: 0,  # 'l'
+        13: 0,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 1,  # 'p'
+        7: 3,  # 'r'
+        8: 2,  # 's'
+        9: 3,  # 't'
+        14: 0,  # 'u'
+        32: 2,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 2,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 1,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    61: {  # 'î'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 0,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 0,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 1,  # 'Z'
+        1: 2,  # 'a'
+        21: 0,  # 'b'
+        28: 0,  # 'c'
+        12: 0,  # 'd'
+        2: 2,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 1,  # 'j'
+        10: 0,  # 'k'
+        5: 0,  # 'l'
+        13: 1,  # 'm'
+        4: 1,  # 'n'
+        15: 0,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 1,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 1,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 1,  # 'î'
+        34: 0,  # 'ö'
+        17: 0,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 1,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    34: {  # 'ö'
+        23: 0,  # 'A'
+        37: 1,  # 'B'
+        47: 1,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 2,  # 'F'
+        36: 1,  # 'G'
+        45: 1,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 1,  # 'L'
+        20: 0,  # 'M'
+        46: 1,  # 'N'
+        42: 1,  # 'O'
+        48: 2,  # 'P'
+        44: 1,  # 'R'
+        35: 1,  # 'S'
+        31: 1,  # 'T'
+        51: 1,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 1,  # 'Z'
+        1: 3,  # 'a'
+        21: 1,  # 'b'
+        28: 2,  # 'c'
+        12: 1,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 2,  # 'g'
+        25: 2,  # 'h'
+        3: 1,  # 'i'
+        24: 2,  # 'j'
+        10: 1,  # 'k'
+        5: 2,  # 'l'
+        13: 3,  # 'm'
+        4: 2,  # 'n'
+        15: 2,  # 'o'
+        26: 0,  # 'p'
+        7: 0,  # 'r'
+        8: 3,  # 's'
+        9: 1,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 1,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 2,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 2,  # 'ç'
+        61: 0,  # 'î'
+        34: 2,  # 'ö'
+        17: 0,  # 'ü'
+        30: 2,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 1,  # 'ı'
+        40: 2,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    17: {  # 'ü'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 0,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 1,  # 'J'
+        16: 1,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 0,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 1,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 0,  # 'Y'
+        56: 1,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 0,  # 'c'
+        12: 1,  # 'd'
+        2: 3,  # 'e'
+        18: 1,  # 'f'
+        27: 2,  # 'g'
+        25: 0,  # 'h'
+        3: 1,  # 'i'
+        24: 1,  # 'j'
+        10: 2,  # 'k'
+        5: 3,  # 'l'
+        13: 2,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 2,  # 'p'
+        7: 2,  # 'r'
+        8: 3,  # 's'
+        9: 2,  # 't'
+        14: 3,  # 'u'
+        32: 1,  # 'v'
+        57: 1,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 2,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 2,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    30: {  # 'ğ'
+        23: 0,  # 'A'
+        37: 2,  # 'B'
+        47: 1,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 2,  # 'F'
+        36: 1,  # 'G'
+        45: 0,  # 'H'
+        53: 1,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 1,  # 'M'
+        46: 2,  # 'N'
+        42: 2,  # 'O'
+        48: 1,  # 'P'
+        44: 1,  # 'R'
+        35: 0,  # 'S'
+        31: 1,  # 'T'
+        51: 0,  # 'U'
+        38: 2,  # 'V'
+        62: 0,  # 'W'
+        43: 2,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 0,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 2,  # 'e'
+        18: 0,  # 'f'
+        27: 0,  # 'g'
+        25: 0,  # 'h'
+        3: 0,  # 'i'
+        24: 3,  # 'j'
+        10: 1,  # 'k'
+        5: 2,  # 'l'
+        13: 3,  # 'm'
+        4: 0,  # 'n'
+        15: 1,  # 'o'
+        26: 0,  # 'p'
+        7: 1,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 2,  # 'Ç'
+        50: 2,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 0,  # 'î'
+        34: 2,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 2,  # 'İ'
+        6: 2,  # 'ı'
+        40: 2,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    41: {  # 'İ'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 1,  # 'D'
+        29: 1,  # 'E'
+        52: 0,  # 'F'
+        36: 2,  # 'G'
+        45: 2,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 1,  # 'N'
+        42: 1,  # 'O'
+        48: 2,  # 'P'
+        44: 0,  # 'R'
+        35: 1,  # 'S'
+        31: 1,  # 'T'
+        51: 1,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 2,  # 'Y'
+        56: 0,  # 'Z'
+        1: 1,  # 'a'
+        21: 2,  # 'b'
+        28: 1,  # 'c'
+        12: 2,  # 'd'
+        2: 1,  # 'e'
+        18: 0,  # 'f'
+        27: 3,  # 'g'
+        25: 2,  # 'h'
+        3: 2,  # 'i'
+        24: 2,  # 'j'
+        10: 2,  # 'k'
+        5: 0,  # 'l'
+        13: 1,  # 'm'
+        4: 3,  # 'n'
+        15: 1,  # 'o'
+        26: 1,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 2,  # 't'
+        14: 0,  # 'u'
+        32: 0,  # 'v'
+        57: 1,  # 'w'
+        58: 0,  # 'x'
+        11: 2,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 1,  # 'Ü'
+        59: 1,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 1,  # 'ö'
+        17: 1,  # 'ü'
+        30: 2,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+    6: {  # 'ı'
+        23: 2,  # 'A'
+        37: 0,  # 'B'
+        47: 0,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 0,  # 'F'
+        36: 1,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 2,  # 'J'
+        16: 3,  # 'K'
+        49: 0,  # 'L'
+        20: 3,  # 'M'
+        46: 1,  # 'N'
+        42: 0,  # 'O'
+        48: 0,  # 'P'
+        44: 0,  # 'R'
+        35: 0,  # 'S'
+        31: 2,  # 'T'
+        51: 0,  # 'U'
+        38: 0,  # 'V'
+        62: 0,  # 'W'
+        43: 2,  # 'Y'
+        56: 1,  # 'Z'
+        1: 3,  # 'a'
+        21: 2,  # 'b'
+        28: 1,  # 'c'
+        12: 3,  # 'd'
+        2: 3,  # 'e'
+        18: 3,  # 'f'
+        27: 3,  # 'g'
+        25: 2,  # 'h'
+        3: 3,  # 'i'
+        24: 3,  # 'j'
+        10: 3,  # 'k'
+        5: 3,  # 'l'
+        13: 3,  # 'm'
+        4: 3,  # 'n'
+        15: 0,  # 'o'
+        26: 3,  # 'p'
+        7: 3,  # 'r'
+        8: 3,  # 's'
+        9: 3,  # 't'
+        14: 3,  # 'u'
+        32: 3,  # 'v'
+        57: 1,  # 'w'
+        58: 1,  # 'x'
+        11: 3,  # 'y'
+        22: 0,  # 'z'
+        63: 1,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 2,  # 'ç'
+        61: 0,  # 'î'
+        34: 0,  # 'ö'
+        17: 3,  # 'ü'
+        30: 0,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 3,  # 'ı'
+        40: 0,  # 'Ş'
+        19: 0,  # 'ş'
+    },
+    40: {  # 'Ş'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 1,  # 'D'
+        29: 1,  # 'E'
+        52: 0,  # 'F'
+        36: 1,  # 'G'
+        45: 2,  # 'H'
+        53: 1,  # 'I'
+        60: 0,  # 'J'
+        16: 0,  # 'K'
+        49: 0,  # 'L'
+        20: 2,  # 'M'
+        46: 1,  # 'N'
+        42: 1,  # 'O'
+        48: 2,  # 'P'
+        44: 2,  # 'R'
+        35: 1,  # 'S'
+        31: 1,  # 'T'
+        51: 0,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 2,  # 'Y'
+        56: 1,  # 'Z'
+        1: 0,  # 'a'
+        21: 2,  # 'b'
+        28: 0,  # 'c'
+        12: 2,  # 'd'
+        2: 0,  # 'e'
+        18: 3,  # 'f'
+        27: 0,  # 'g'
+        25: 2,  # 'h'
+        3: 3,  # 'i'
+        24: 2,  # 'j'
+        10: 1,  # 'k'
+        5: 0,  # 'l'
+        13: 1,  # 'm'
+        4: 3,  # 'n'
+        15: 2,  # 'o'
+        26: 0,  # 'p'
+        7: 3,  # 'r'
+        8: 2,  # 's'
+        9: 2,  # 't'
+        14: 1,  # 'u'
+        32: 3,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 2,  # 'y'
+        22: 0,  # 'z'
+        63: 0,  # '·'
+        54: 0,  # 'Ç'
+        50: 0,  # 'Ö'
+        55: 1,  # 'Ü'
+        59: 0,  # 'â'
+        33: 0,  # 'ç'
+        61: 0,  # 'î'
+        34: 2,  # 'ö'
+        17: 1,  # 'ü'
+        30: 2,  # 'ğ'
+        41: 0,  # 'İ'
+        6: 2,  # 'ı'
+        40: 1,  # 'Ş'
+        19: 2,  # 'ş'
+    },
+    19: {  # 'ş'
+        23: 0,  # 'A'
+        37: 0,  # 'B'
+        47: 1,  # 'C'
+        39: 0,  # 'D'
+        29: 0,  # 'E'
+        52: 2,  # 'F'
+        36: 1,  # 'G'
+        45: 0,  # 'H'
+        53: 0,  # 'I'
+        60: 0,  # 'J'
+        16: 3,  # 'K'
+        49: 2,  # 'L'
+        20: 0,  # 'M'
+        46: 1,  # 'N'
+        42: 1,  # 'O'
+        48: 1,  # 'P'
+        44: 1,  # 'R'
+        35: 1,  # 'S'
+        31: 0,  # 'T'
+        51: 1,  # 'U'
+        38: 1,  # 'V'
+        62: 0,  # 'W'
+        43: 1,  # 'Y'
+        56: 0,  # 'Z'
+        1: 3,  # 'a'
+        21: 1,  # 'b'
+        28: 2,  # 'c'
+        12: 0,  # 'd'
+        2: 3,  # 'e'
+        18: 0,  # 'f'
+        27: 2,  # 'g'
+        25: 1,  # 'h'
+        3: 1,  # 'i'
+        24: 0,  # 'j'
+        10: 2,  # 'k'
+        5: 2,  # 'l'
+        13: 3,  # 'm'
+        4: 0,  # 'n'
+        15: 0,  # 'o'
+        26: 1,  # 'p'
+        7: 3,  # 'r'
+        8: 0,  # 's'
+        9: 0,  # 't'
+        14: 3,  # 'u'
+        32: 0,  # 'v'
+        57: 0,  # 'w'
+        58: 0,  # 'x'
+        11: 0,  # 'y'
+        22: 2,  # 'z'
+        63: 0,  # '·'
+        54: 1,  # 'Ç'
+        50: 2,  # 'Ö'
+        55: 0,  # 'Ü'
+        59: 0,  # 'â'
+        33: 1,  # 'ç'
+        61: 1,  # 'î'
+        34: 2,  # 'ö'
+        17: 0,  # 'ü'
+        30: 1,  # 'ğ'
+        41: 1,  # 'İ'
+        6: 1,  # 'ı'
+        40: 1,  # 'Ş'
+        19: 1,  # 'ş'
+    },
+}
+
+# 255: Undefined characters that did not exist in training text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+# 251: Control characters
+
+# Character Mapping Table(s):
+ISO_8859_9_TURKISH_CHAR_TO_ORDER = {
+     0: 255,  # '\x00'
+     1: 255,  # '\x01'
+     2: 255,  # '\x02'
+     3: 255,  # '\x03'
+     4: 255,  # '\x04'
+     5: 255,  # '\x05'
+     6: 255,  # '\x06'
+     7: 255,  # '\x07'
+     8: 255,  # '\x08'
+     9: 255,  # '\t'
+     10: 255,  # '\n'
+     11: 255,  # '\x0b'
+     12: 255,  # '\x0c'
+     13: 255,  # '\r'
+     14: 255,  # '\x0e'
+     15: 255,  # '\x0f'
+     16: 255,  # '\x10'
+     17: 255,  # '\x11'
+     18: 255,  # '\x12'
+     19: 255,  # '\x13'
+     20: 255,  # '\x14'
+     21: 255,  # '\x15'
+     22: 255,  # '\x16'
+     23: 255,  # '\x17'
+     24: 255,  # '\x18'
+     25: 255,  # '\x19'
+     26: 255,  # '\x1a'
+     27: 255,  # '\x1b'
+     28: 255,  # '\x1c'
+     29: 255,  # '\x1d'
+     30: 255,  # '\x1e'
+     31: 255,  # '\x1f'
+     32: 255,  # ' '
+     33: 255,  # '!'
+     34: 255,  # '"'
+     35: 255,  # '#'
+     36: 255,  # '$'
+     37: 255,  # '%'
+     38: 255,  # '&'
+     39: 255,  # "'"
+     40: 255,  # '('
+     41: 255,  # ')'
+     42: 255,  # '*'
+     43: 255,  # '+'
+     44: 255,  # ','
+     45: 255,  # '-'
+     46: 255,  # '.'
+     47: 255,  # '/'
+     48: 255,  # '0'
+     49: 255,  # '1'
+     50: 255,  # '2'
+     51: 255,  # '3'
+     52: 255,  # '4'
+     53: 255,  # '5'
+     54: 255,  # '6'
+     55: 255,  # '7'
+     56: 255,  # '8'
+     57: 255,  # '9'
+     58: 255,  # ':'
+     59: 255,  # ';'
+     60: 255,  # '<'
+     61: 255,  # '='
+     62: 255,  # '>'
+     63: 255,  # '?'
+     64: 255,  # '@'
+     65: 23,  # 'A'
+     66: 37,  # 'B'
+     67: 47,  # 'C'
+     68: 39,  # 'D'
+     69: 29,  # 'E'
+     70: 52,  # 'F'
+     71: 36,  # 'G'
+     72: 45,  # 'H'
+     73: 53,  # 'I'
+     74: 60,  # 'J'
+     75: 16,  # 'K'
+     76: 49,  # 'L'
+     77: 20,  # 'M'
+     78: 46,  # 'N'
+     79: 42,  # 'O'
+     80: 48,  # 'P'
+     81: 69,  # 'Q'
+     82: 44,  # 'R'
+     83: 35,  # 'S'
+     84: 31,  # 'T'
+     85: 51,  # 'U'
+     86: 38,  # 'V'
+     87: 62,  # 'W'
+     88: 65,  # 'X'
+     89: 43,  # 'Y'
+     90: 56,  # 'Z'
+     91: 255,  # '['
+     92: 255,  # '\\'
+     93: 255,  # ']'
+     94: 255,  # '^'
+     95: 255,  # '_'
+     96: 255,  # '`'
+     97: 1,  # 'a'
+     98: 21,  # 'b'
+     99: 28,  # 'c'
+     100: 12,  # 'd'
+     101: 2,  # 'e'
+     102: 18,  # 'f'
+     103: 27,  # 'g'
+     104: 25,  # 'h'
+     105: 3,  # 'i'
+     106: 24,  # 'j'
+     107: 10,  # 'k'
+     108: 5,  # 'l'
+     109: 13,  # 'm'
+     110: 4,  # 'n'
+     111: 15,  # 'o'
+     112: 26,  # 'p'
+     113: 64,  # 'q'
+     114: 7,  # 'r'
+     115: 8,  # 's'
+     116: 9,  # 't'
+     117: 14,  # 'u'
+     118: 32,  # 'v'
+     119: 57,  # 'w'
+     120: 58,  # 'x'
+     121: 11,  # 'y'
+     122: 22,  # 'z'
+     123: 255,  # '{'
+     124: 255,  # '|'
+     125: 255,  # '}'
+     126: 255,  # '~'
+     127: 255,  # '\x7f'
+     128: 180,  # '\x80'
+     129: 179,  # '\x81'
+     130: 178,  # '\x82'
+     131: 177,  # '\x83'
+     132: 176,  # '\x84'
+     133: 175,  # '\x85'
+     134: 174,  # '\x86'
+     135: 173,  # '\x87'
+     136: 172,  # '\x88'
+     137: 171,  # '\x89'
+     138: 170,  # '\x8a'
+     139: 169,  # '\x8b'
+     140: 168,  # '\x8c'
+     141: 167,  # '\x8d'
+     142: 166,  # '\x8e'
+     143: 165,  # '\x8f'
+     144: 164,  # '\x90'
+     145: 163,  # '\x91'
+     146: 162,  # '\x92'
+     147: 161,  # '\x93'
+     148: 160,  # '\x94'
+     149: 159,  # '\x95'
+     150: 101,  # '\x96'
+     151: 158,  # '\x97'
+     152: 157,  # '\x98'
+     153: 156,  # '\x99'
+     154: 155,  # '\x9a'
+     155: 154,  # '\x9b'
+     156: 153,  # '\x9c'
+     157: 152,  # '\x9d'
+     158: 151,  # '\x9e'
+     159: 106,  # '\x9f'
+     160: 150,  # '\xa0'
+     161: 149,  # '¡'
+     162: 148,  # '¢'
+     163: 147,  # '£'
+     164: 146,  # '¤'
+     165: 145,  # '¥'
+     166: 144,  # '¦'
+     167: 100,  # '§'
+     168: 143,  # '¨'
+     169: 142,  # '©'
+     170: 141,  # 'ª'
+     171: 140,  # '«'
+     172: 139,  # '¬'
+     173: 138,  # '\xad'
+     174: 137,  # '®'
+     175: 136,  # '¯'
+     176: 94,  # '°'
+     177: 80,  # '±'
+     178: 93,  # '²'
+     179: 135,  # '³'
+     180: 105,  # '´'
+     181: 134,  # 'µ'
+     182: 133,  # '¶'
+     183: 63,  # '·'
+     184: 132,  # '¸'
+     185: 131,  # '¹'
+     186: 130,  # 'º'
+     187: 129,  # '»'
+     188: 128,  # '¼'
+     189: 127,  # '½'
+     190: 126,  # '¾'
+     191: 125,  # '¿'
+     192: 124,  # 'À'
+     193: 104,  # 'Á'
+     194: 73,  # 'Â'
+     195: 99,  # 'Ã'
+     196: 79,  # 'Ä'
+     197: 85,  # 'Å'
+     198: 123,  # 'Æ'
+     199: 54,  # 'Ç'
+     200: 122,  # 'È'
+     201: 98,  # 'É'
+     202: 92,  # 'Ê'
+     203: 121,  # 'Ë'
+     204: 120,  # 'Ì'
+     205: 91,  # 'Í'
+     206: 103,  # 'Î'
+     207: 119,  # 'Ï'
+     208: 68,  # 'Ğ'
+     209: 118,  # 'Ñ'
+     210: 117,  # 'Ò'
+     211: 97,  # 'Ó'
+     212: 116,  # 'Ô'
+     213: 115,  # 'Õ'
+     214: 50,  # 'Ö'
+     215: 90,  # '×'
+     216: 114,  # 'Ø'
+     217: 113,  # 'Ù'
+     218: 112,  # 'Ú'
+     219: 111,  # 'Û'
+     220: 55,  # 'Ü'
+     221: 41,  # 'İ'
+     222: 40,  # 'Ş'
+     223: 86,  # 'ß'
+     224: 89,  # 'à'
+     225: 70,  # 'á'
+     226: 59,  # 'â'
+     227: 78,  # 'ã'
+     228: 71,  # 'ä'
+     229: 82,  # 'å'
+     230: 88,  # 'æ'
+     231: 33,  # 'ç'
+     232: 77,  # 'è'
+     233: 66,  # 'é'
+     234: 84,  # 'ê'
+     235: 83,  # 'ë'
+     236: 110,  # 'ì'
+     237: 75,  # 'í'
+     238: 61,  # 'î'
+     239: 96,  # 'ï'
+     240: 30,  # 'ğ'
+     241: 67,  # 'ñ'
+     242: 109,  # 'ò'
+     243: 74,  # 'ó'
+     244: 87,  # 'ô'
+     245: 102,  # 'õ'
+     246: 34,  # 'ö'
+     247: 95,  # '÷'
+     248: 81,  # 'ø'
+     249: 108,  # 'ù'
+     250: 76,  # 'ú'
+     251: 72,  # 'û'
+     252: 17,  # 'ü'
+     253: 6,  # 'ı'
+     254: 19,  # 'ş'
+     255: 107,  # 'ÿ'
+}
+
+ISO_8859_9_TURKISH_MODEL = SingleByteCharSetModel(charset_name='ISO-8859-9',
+                                                  language='Turkish',
+                                                  char_to_order_map=ISO_8859_9_TURKISH_CHAR_TO_ORDER,
+                                                  language_model=TURKISH_LANG_MODEL,
+                                                  typical_positive_ratio=0.97029,
+                                                  keep_ascii_letters=True,
+                                                  alphabet='ABCDEFGHIJKLMNOPRSTUVYZabcdefghijklmnoprstuvyzÂÇÎÖÛÜâçîöûüĞğİıŞş')
+
diff --git a/openpype/vendor/python/python_2/chardet/latin1prober.py b/openpype/vendor/python/python_2/chardet/latin1prober.py
new file mode 100644
index 0000000000..7d1e8c20fb
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/latin1prober.py
@@ -0,0 +1,145 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetprober import CharSetProber
+from .enums import ProbingState
+
+FREQ_CAT_NUM = 4
+
+UDF = 0  # undefined
+OTH = 1  # other
+ASC = 2  # ascii capital letter
+ASS = 3  # ascii small letter
+ACV = 4  # accent capital vowel
+ACO = 5  # accent capital other
+ASV = 6  # accent small vowel
+ASO = 7  # accent small other
+CLASS_NUM = 8  # total classes
+
+Latin1_CharToClass = (
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 00 - 07
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 08 - 0F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 10 - 17
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 18 - 1F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 20 - 27
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 28 - 2F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 30 - 37
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 38 - 3F
+    OTH, ASC, ASC, ASC, ASC, ASC, ASC, ASC,   # 40 - 47
+    ASC, ASC, ASC, ASC, ASC, ASC, ASC, ASC,   # 48 - 4F
+    ASC, ASC, ASC, ASC, ASC, ASC, ASC, ASC,   # 50 - 57
+    ASC, ASC, ASC, OTH, OTH, OTH, OTH, OTH,   # 58 - 5F
+    OTH, ASS, ASS, ASS, ASS, ASS, ASS, ASS,   # 60 - 67
+    ASS, ASS, ASS, ASS, ASS, ASS, ASS, ASS,   # 68 - 6F
+    ASS, ASS, ASS, ASS, ASS, ASS, ASS, ASS,   # 70 - 77
+    ASS, ASS, ASS, OTH, OTH, OTH, OTH, OTH,   # 78 - 7F
+    OTH, UDF, OTH, ASO, OTH, OTH, OTH, OTH,   # 80 - 87
+    OTH, OTH, ACO, OTH, ACO, UDF, ACO, UDF,   # 88 - 8F
+    UDF, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 90 - 97
+    OTH, OTH, ASO, OTH, ASO, UDF, ASO, ACO,   # 98 - 9F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # A0 - A7
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # A8 - AF
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # B0 - B7
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # B8 - BF
+    ACV, ACV, ACV, ACV, ACV, ACV, ACO, ACO,   # C0 - C7
+    ACV, ACV, ACV, ACV, ACV, ACV, ACV, ACV,   # C8 - CF
+    ACO, ACO, ACV, ACV, ACV, ACV, ACV, OTH,   # D0 - D7
+    ACV, ACV, ACV, ACV, ACV, ACO, ACO, ACO,   # D8 - DF
+    ASV, ASV, ASV, ASV, ASV, ASV, ASO, ASO,   # E0 - E7
+    ASV, ASV, ASV, ASV, ASV, ASV, ASV, ASV,   # E8 - EF
+    ASO, ASO, ASV, ASV, ASV, ASV, ASV, OTH,   # F0 - F7
+    ASV, ASV, ASV, ASV, ASV, ASO, ASO, ASO,   # F8 - FF
+)
+
+# 0 : illegal
+# 1 : very unlikely
+# 2 : normal
+# 3 : very likely
+Latin1ClassModel = (
+# UDF OTH ASC ASS ACV ACO ASV ASO
+    0,  0,  0,  0,  0,  0,  0,  0,  # UDF
+    0,  3,  3,  3,  3,  3,  3,  3,  # OTH
+    0,  3,  3,  3,  3,  3,  3,  3,  # ASC
+    0,  3,  3,  3,  1,  1,  3,  3,  # ASS
+    0,  3,  3,  3,  1,  2,  1,  2,  # ACV
+    0,  3,  3,  3,  3,  3,  3,  3,  # ACO
+    0,  3,  1,  3,  1,  1,  1,  3,  # ASV
+    0,  3,  1,  3,  1,  1,  3,  3,  # ASO
+)
+
+
+class Latin1Prober(CharSetProber):
+    def __init__(self):
+        super(Latin1Prober, self).__init__()
+        self._last_char_class = None
+        self._freq_counter = None
+        self.reset()
+
+    def reset(self):
+        self._last_char_class = OTH
+        self._freq_counter = [0] * FREQ_CAT_NUM
+        CharSetProber.reset(self)
+
+    @property
+    def charset_name(self):
+        return "ISO-8859-1"
+
+    @property
+    def language(self):
+        return ""
+
+    def feed(self, byte_str):
+        byte_str = self.filter_with_english_letters(byte_str)
+        for c in byte_str:
+            char_class = Latin1_CharToClass[c]
+            freq = Latin1ClassModel[(self._last_char_class * CLASS_NUM)
+                                    + char_class]
+            if freq == 0:
+                self._state = ProbingState.NOT_ME
+                break
+            self._freq_counter[freq] += 1
+            self._last_char_class = char_class
+
+        return self.state
+
+    def get_confidence(self):
+        if self.state == ProbingState.NOT_ME:
+            return 0.01
+
+        total = sum(self._freq_counter)
+        if total < 0.01:
+            confidence = 0.0
+        else:
+            confidence = ((self._freq_counter[3] - self._freq_counter[1] * 20.0)
+                          / total)
+        if confidence < 0.0:
+            confidence = 0.0
+        # lower the confidence of latin1 so that other more accurate
+        # detector can take priority.
+        confidence = confidence * 0.73
+        return confidence
diff --git a/openpype/vendor/python/python_2/chardet/mbcharsetprober.py b/openpype/vendor/python/python_2/chardet/mbcharsetprober.py
new file mode 100644
index 0000000000..6256ecfd1e
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/mbcharsetprober.py
@@ -0,0 +1,91 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#   Proofpoint, Inc.
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetprober import CharSetProber
+from .enums import ProbingState, MachineState
+
+
+class MultiByteCharSetProber(CharSetProber):
+    """
+    MultiByteCharSetProber
+    """
+
+    def __init__(self, lang_filter=None):
+        super(MultiByteCharSetProber, self).__init__(lang_filter=lang_filter)
+        self.distribution_analyzer = None
+        self.coding_sm = None
+        self._last_char = [0, 0]
+
+    def reset(self):
+        super(MultiByteCharSetProber, self).reset()
+        if self.coding_sm:
+            self.coding_sm.reset()
+        if self.distribution_analyzer:
+            self.distribution_analyzer.reset()
+        self._last_char = [0, 0]
+
+    @property
+    def charset_name(self):
+        raise NotImplementedError
+
+    @property
+    def language(self):
+        raise NotImplementedError
+
+    def feed(self, byte_str):
+        for i in range(len(byte_str)):
+            coding_state = self.coding_sm.next_state(byte_str[i])
+            if coding_state == MachineState.ERROR:
+                self.logger.debug('%s %s prober hit error at byte %s',
+                                  self.charset_name, self.language, i)
+                self._state = ProbingState.NOT_ME
+                break
+            elif coding_state == MachineState.ITS_ME:
+                self._state = ProbingState.FOUND_IT
+                break
+            elif coding_state == MachineState.START:
+                char_len = self.coding_sm.get_current_charlen()
+                if i == 0:
+                    self._last_char[1] = byte_str[0]
+                    self.distribution_analyzer.feed(self._last_char, char_len)
+                else:
+                    self.distribution_analyzer.feed(byte_str[i - 1:i + 1],
+                                                    char_len)
+
+        self._last_char[0] = byte_str[-1]
+
+        if self.state == ProbingState.DETECTING:
+            if (self.distribution_analyzer.got_enough_data() and
+                    (self.get_confidence() > self.SHORTCUT_THRESHOLD)):
+                self._state = ProbingState.FOUND_IT
+
+        return self.state
+
+    def get_confidence(self):
+        return self.distribution_analyzer.get_confidence()
diff --git a/openpype/vendor/python/python_2/chardet/mbcsgroupprober.py b/openpype/vendor/python/python_2/chardet/mbcsgroupprober.py
new file mode 100644
index 0000000000..530abe75e0
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/mbcsgroupprober.py
@@ -0,0 +1,54 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#   Proofpoint, Inc.
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetgroupprober import CharSetGroupProber
+from .utf8prober import UTF8Prober
+from .sjisprober import SJISProber
+from .eucjpprober import EUCJPProber
+from .gb2312prober import GB2312Prober
+from .euckrprober import EUCKRProber
+from .cp949prober import CP949Prober
+from .big5prober import Big5Prober
+from .euctwprober import EUCTWProber
+
+
+class MBCSGroupProber(CharSetGroupProber):
+    def __init__(self, lang_filter=None):
+        super(MBCSGroupProber, self).__init__(lang_filter=lang_filter)
+        self.probers = [
+            UTF8Prober(),
+            SJISProber(),
+            EUCJPProber(),
+            GB2312Prober(),
+            EUCKRProber(),
+            CP949Prober(),
+            Big5Prober(),
+            EUCTWProber()
+        ]
+        self.reset()
diff --git a/openpype/vendor/python/python_2/chardet/mbcssm.py b/openpype/vendor/python/python_2/chardet/mbcssm.py
new file mode 100644
index 0000000000..8360d0f284
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/mbcssm.py
@@ -0,0 +1,572 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .enums import MachineState
+
+# BIG5
+
+BIG5_CLS = (
+    1,1,1,1,1,1,1,1,  # 00 - 07    #allow 0x00 as legal value
+    1,1,1,1,1,1,0,0,  # 08 - 0f
+    1,1,1,1,1,1,1,1,  # 10 - 17
+    1,1,1,0,1,1,1,1,  # 18 - 1f
+    1,1,1,1,1,1,1,1,  # 20 - 27
+    1,1,1,1,1,1,1,1,  # 28 - 2f
+    1,1,1,1,1,1,1,1,  # 30 - 37
+    1,1,1,1,1,1,1,1,  # 38 - 3f
+    2,2,2,2,2,2,2,2,  # 40 - 47
+    2,2,2,2,2,2,2,2,  # 48 - 4f
+    2,2,2,2,2,2,2,2,  # 50 - 57
+    2,2,2,2,2,2,2,2,  # 58 - 5f
+    2,2,2,2,2,2,2,2,  # 60 - 67
+    2,2,2,2,2,2,2,2,  # 68 - 6f
+    2,2,2,2,2,2,2,2,  # 70 - 77
+    2,2,2,2,2,2,2,1,  # 78 - 7f
+    4,4,4,4,4,4,4,4,  # 80 - 87
+    4,4,4,4,4,4,4,4,  # 88 - 8f
+    4,4,4,4,4,4,4,4,  # 90 - 97
+    4,4,4,4,4,4,4,4,  # 98 - 9f
+    4,3,3,3,3,3,3,3,  # a0 - a7
+    3,3,3,3,3,3,3,3,  # a8 - af
+    3,3,3,3,3,3,3,3,  # b0 - b7
+    3,3,3,3,3,3,3,3,  # b8 - bf
+    3,3,3,3,3,3,3,3,  # c0 - c7
+    3,3,3,3,3,3,3,3,  # c8 - cf
+    3,3,3,3,3,3,3,3,  # d0 - d7
+    3,3,3,3,3,3,3,3,  # d8 - df
+    3,3,3,3,3,3,3,3,  # e0 - e7
+    3,3,3,3,3,3,3,3,  # e8 - ef
+    3,3,3,3,3,3,3,3,  # f0 - f7
+    3,3,3,3,3,3,3,0  # f8 - ff
+)
+
+BIG5_ST = (
+    MachineState.ERROR,MachineState.START,MachineState.START,     3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
+    MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,#08-0f
+    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START#10-17
+)
+
+BIG5_CHAR_LEN_TABLE = (0, 1, 1, 2, 0)
+
+BIG5_SM_MODEL = {'class_table': BIG5_CLS,
+                 'class_factor': 5,
+                 'state_table': BIG5_ST,
+                 'char_len_table': BIG5_CHAR_LEN_TABLE,
+                 'name': 'Big5'}
+
+# CP949
+
+CP949_CLS  = (
+    1,1,1,1,1,1,1,1, 1,1,1,1,1,1,0,0,  # 00 - 0f
+    1,1,1,1,1,1,1,1, 1,1,1,0,1,1,1,1,  # 10 - 1f
+    1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,  # 20 - 2f
+    1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,  # 30 - 3f
+    1,4,4,4,4,4,4,4, 4,4,4,4,4,4,4,4,  # 40 - 4f
+    4,4,5,5,5,5,5,5, 5,5,5,1,1,1,1,1,  # 50 - 5f
+    1,5,5,5,5,5,5,5, 5,5,5,5,5,5,5,5,  # 60 - 6f
+    5,5,5,5,5,5,5,5, 5,5,5,1,1,1,1,1,  # 70 - 7f
+    0,6,6,6,6,6,6,6, 6,6,6,6,6,6,6,6,  # 80 - 8f
+    6,6,6,6,6,6,6,6, 6,6,6,6,6,6,6,6,  # 90 - 9f
+    6,7,7,7,7,7,7,7, 7,7,7,7,7,8,8,8,  # a0 - af
+    7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7,  # b0 - bf
+    7,7,7,7,7,7,9,2, 2,3,2,2,2,2,2,2,  # c0 - cf
+    2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2,  # d0 - df
+    2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2,  # e0 - ef
+    2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,0,  # f0 - ff
+)
+
+CP949_ST = (
+#cls=    0      1      2      3      4      5      6      7      8      9  # previous state =
+    MachineState.ERROR,MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,     4,     5,MachineState.ERROR,     6, # MachineState.START
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR, # MachineState.ERROR
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME, # MachineState.ITS_ME
+    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START, # 3
+    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START, # 4
+    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START, # 5
+    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START, # 6
+)
+
+CP949_CHAR_LEN_TABLE = (0, 1, 2, 0, 1, 1, 2, 2, 0, 2)
+
+CP949_SM_MODEL = {'class_table': CP949_CLS,
+                  'class_factor': 10,
+                  'state_table': CP949_ST,
+                  'char_len_table': CP949_CHAR_LEN_TABLE,
+                  'name': 'CP949'}
+
+# EUC-JP
+
+EUCJP_CLS = (
+    4,4,4,4,4,4,4,4,  # 00 - 07
+    4,4,4,4,4,4,5,5,  # 08 - 0f
+    4,4,4,4,4,4,4,4,  # 10 - 17
+    4,4,4,5,4,4,4,4,  # 18 - 1f
+    4,4,4,4,4,4,4,4,  # 20 - 27
+    4,4,4,4,4,4,4,4,  # 28 - 2f
+    4,4,4,4,4,4,4,4,  # 30 - 37
+    4,4,4,4,4,4,4,4,  # 38 - 3f
+    4,4,4,4,4,4,4,4,  # 40 - 47
+    4,4,4,4,4,4,4,4,  # 48 - 4f
+    4,4,4,4,4,4,4,4,  # 50 - 57
+    4,4,4,4,4,4,4,4,  # 58 - 5f
+    4,4,4,4,4,4,4,4,  # 60 - 67
+    4,4,4,4,4,4,4,4,  # 68 - 6f
+    4,4,4,4,4,4,4,4,  # 70 - 77
+    4,4,4,4,4,4,4,4,  # 78 - 7f
+    5,5,5,5,5,5,5,5,  # 80 - 87
+    5,5,5,5,5,5,1,3,  # 88 - 8f
+    5,5,5,5,5,5,5,5,  # 90 - 97
+    5,5,5,5,5,5,5,5,  # 98 - 9f
+    5,2,2,2,2,2,2,2,  # a0 - a7
+    2,2,2,2,2,2,2,2,  # a8 - af
+    2,2,2,2,2,2,2,2,  # b0 - b7
+    2,2,2,2,2,2,2,2,  # b8 - bf
+    2,2,2,2,2,2,2,2,  # c0 - c7
+    2,2,2,2,2,2,2,2,  # c8 - cf
+    2,2,2,2,2,2,2,2,  # d0 - d7
+    2,2,2,2,2,2,2,2,  # d8 - df
+    0,0,0,0,0,0,0,0,  # e0 - e7
+    0,0,0,0,0,0,0,0,  # e8 - ef
+    0,0,0,0,0,0,0,0,  # f0 - f7
+    0,0,0,0,0,0,0,5  # f8 - ff
+)
+
+EUCJP_ST = (
+          3,     4,     3,     5,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
+     MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+     MachineState.ITS_ME,MachineState.ITS_ME,MachineState.START,MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#10-17
+     MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     3,MachineState.ERROR,#18-1f
+          3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START#20-27
+)
+
+EUCJP_CHAR_LEN_TABLE = (2, 2, 2, 3, 1, 0)
+
+EUCJP_SM_MODEL = {'class_table': EUCJP_CLS,
+                  'class_factor': 6,
+                  'state_table': EUCJP_ST,
+                  'char_len_table': EUCJP_CHAR_LEN_TABLE,
+                  'name': 'EUC-JP'}
+
+# EUC-KR
+
+EUCKR_CLS  = (
+    1,1,1,1,1,1,1,1,  # 00 - 07
+    1,1,1,1,1,1,0,0,  # 08 - 0f
+    1,1,1,1,1,1,1,1,  # 10 - 17
+    1,1,1,0,1,1,1,1,  # 18 - 1f
+    1,1,1,1,1,1,1,1,  # 20 - 27
+    1,1,1,1,1,1,1,1,  # 28 - 2f
+    1,1,1,1,1,1,1,1,  # 30 - 37
+    1,1,1,1,1,1,1,1,  # 38 - 3f
+    1,1,1,1,1,1,1,1,  # 40 - 47
+    1,1,1,1,1,1,1,1,  # 48 - 4f
+    1,1,1,1,1,1,1,1,  # 50 - 57
+    1,1,1,1,1,1,1,1,  # 58 - 5f
+    1,1,1,1,1,1,1,1,  # 60 - 67
+    1,1,1,1,1,1,1,1,  # 68 - 6f
+    1,1,1,1,1,1,1,1,  # 70 - 77
+    1,1,1,1,1,1,1,1,  # 78 - 7f
+    0,0,0,0,0,0,0,0,  # 80 - 87
+    0,0,0,0,0,0,0,0,  # 88 - 8f
+    0,0,0,0,0,0,0,0,  # 90 - 97
+    0,0,0,0,0,0,0,0,  # 98 - 9f
+    0,2,2,2,2,2,2,2,  # a0 - a7
+    2,2,2,2,2,3,3,3,  # a8 - af
+    2,2,2,2,2,2,2,2,  # b0 - b7
+    2,2,2,2,2,2,2,2,  # b8 - bf
+    2,2,2,2,2,2,2,2,  # c0 - c7
+    2,3,2,2,2,2,2,2,  # c8 - cf
+    2,2,2,2,2,2,2,2,  # d0 - d7
+    2,2,2,2,2,2,2,2,  # d8 - df
+    2,2,2,2,2,2,2,2,  # e0 - e7
+    2,2,2,2,2,2,2,2,  # e8 - ef
+    2,2,2,2,2,2,2,2,  # f0 - f7
+    2,2,2,2,2,2,2,0   # f8 - ff
+)
+
+EUCKR_ST = (
+    MachineState.ERROR,MachineState.START,     3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START #08-0f
+)
+
+EUCKR_CHAR_LEN_TABLE = (0, 1, 2, 0)
+
+EUCKR_SM_MODEL = {'class_table': EUCKR_CLS,
+                'class_factor': 4,
+                'state_table': EUCKR_ST,
+                'char_len_table': EUCKR_CHAR_LEN_TABLE,
+                'name': 'EUC-KR'}
+
+# EUC-TW
+
+EUCTW_CLS = (
+    2,2,2,2,2,2,2,2,  # 00 - 07
+    2,2,2,2,2,2,0,0,  # 08 - 0f
+    2,2,2,2,2,2,2,2,  # 10 - 17
+    2,2,2,0,2,2,2,2,  # 18 - 1f
+    2,2,2,2,2,2,2,2,  # 20 - 27
+    2,2,2,2,2,2,2,2,  # 28 - 2f
+    2,2,2,2,2,2,2,2,  # 30 - 37
+    2,2,2,2,2,2,2,2,  # 38 - 3f
+    2,2,2,2,2,2,2,2,  # 40 - 47
+    2,2,2,2,2,2,2,2,  # 48 - 4f
+    2,2,2,2,2,2,2,2,  # 50 - 57
+    2,2,2,2,2,2,2,2,  # 58 - 5f
+    2,2,2,2,2,2,2,2,  # 60 - 67
+    2,2,2,2,2,2,2,2,  # 68 - 6f
+    2,2,2,2,2,2,2,2,  # 70 - 77
+    2,2,2,2,2,2,2,2,  # 78 - 7f
+    0,0,0,0,0,0,0,0,  # 80 - 87
+    0,0,0,0,0,0,6,0,  # 88 - 8f
+    0,0,0,0,0,0,0,0,  # 90 - 97
+    0,0,0,0,0,0,0,0,  # 98 - 9f
+    0,3,4,4,4,4,4,4,  # a0 - a7
+    5,5,1,1,1,1,1,1,  # a8 - af
+    1,1,1,1,1,1,1,1,  # b0 - b7
+    1,1,1,1,1,1,1,1,  # b8 - bf
+    1,1,3,1,3,3,3,3,  # c0 - c7
+    3,3,3,3,3,3,3,3,  # c8 - cf
+    3,3,3,3,3,3,3,3,  # d0 - d7
+    3,3,3,3,3,3,3,3,  # d8 - df
+    3,3,3,3,3,3,3,3,  # e0 - e7
+    3,3,3,3,3,3,3,3,  # e8 - ef
+    3,3,3,3,3,3,3,3,  # f0 - f7
+    3,3,3,3,3,3,3,0   # f8 - ff
+)
+
+EUCTW_ST = (
+    MachineState.ERROR,MachineState.ERROR,MachineState.START,     3,     3,     3,     4,MachineState.ERROR,#00-07
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.START,MachineState.ERROR,#10-17
+    MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#18-1f
+         5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.START,MachineState.START,#20-27
+    MachineState.START,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START #28-2f
+)
+
+EUCTW_CHAR_LEN_TABLE = (0, 0, 1, 2, 2, 2, 3)
+
+EUCTW_SM_MODEL = {'class_table': EUCTW_CLS,
+                'class_factor': 7,
+                'state_table': EUCTW_ST,
+                'char_len_table': EUCTW_CHAR_LEN_TABLE,
+                'name': 'x-euc-tw'}
+
+# GB2312
+
+GB2312_CLS = (
+    1,1,1,1,1,1,1,1,  # 00 - 07
+    1,1,1,1,1,1,0,0,  # 08 - 0f
+    1,1,1,1,1,1,1,1,  # 10 - 17
+    1,1,1,0,1,1,1,1,  # 18 - 1f
+    1,1,1,1,1,1,1,1,  # 20 - 27
+    1,1,1,1,1,1,1,1,  # 28 - 2f
+    3,3,3,3,3,3,3,3,  # 30 - 37
+    3,3,1,1,1,1,1,1,  # 38 - 3f
+    2,2,2,2,2,2,2,2,  # 40 - 47
+    2,2,2,2,2,2,2,2,  # 48 - 4f
+    2,2,2,2,2,2,2,2,  # 50 - 57
+    2,2,2,2,2,2,2,2,  # 58 - 5f
+    2,2,2,2,2,2,2,2,  # 60 - 67
+    2,2,2,2,2,2,2,2,  # 68 - 6f
+    2,2,2,2,2,2,2,2,  # 70 - 77
+    2,2,2,2,2,2,2,4,  # 78 - 7f
+    5,6,6,6,6,6,6,6,  # 80 - 87
+    6,6,6,6,6,6,6,6,  # 88 - 8f
+    6,6,6,6,6,6,6,6,  # 90 - 97
+    6,6,6,6,6,6,6,6,  # 98 - 9f
+    6,6,6,6,6,6,6,6,  # a0 - a7
+    6,6,6,6,6,6,6,6,  # a8 - af
+    6,6,6,6,6,6,6,6,  # b0 - b7
+    6,6,6,6,6,6,6,6,  # b8 - bf
+    6,6,6,6,6,6,6,6,  # c0 - c7
+    6,6,6,6,6,6,6,6,  # c8 - cf
+    6,6,6,6,6,6,6,6,  # d0 - d7
+    6,6,6,6,6,6,6,6,  # d8 - df
+    6,6,6,6,6,6,6,6,  # e0 - e7
+    6,6,6,6,6,6,6,6,  # e8 - ef
+    6,6,6,6,6,6,6,6,  # f0 - f7
+    6,6,6,6,6,6,6,0   # f8 - ff
+)
+
+GB2312_ST = (
+    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,     3,MachineState.ERROR,#00-07
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,#10-17
+         4,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#18-1f
+    MachineState.ERROR,MachineState.ERROR,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,#20-27
+    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START #28-2f
+)
+
+# To be accurate, the length of class 6 can be either 2 or 4.
+# But it is not necessary to discriminate between the two since
+# it is used for frequency analysis only, and we are validating
+# each code range there as well. So it is safe to set it to be
+# 2 here.
+GB2312_CHAR_LEN_TABLE = (0, 1, 1, 1, 1, 1, 2)
+
+GB2312_SM_MODEL = {'class_table': GB2312_CLS,
+                   'class_factor': 7,
+                   'state_table': GB2312_ST,
+                   'char_len_table': GB2312_CHAR_LEN_TABLE,
+                   'name': 'GB2312'}
+
+# Shift_JIS
+
+SJIS_CLS = (
+    1,1,1,1,1,1,1,1,  # 00 - 07
+    1,1,1,1,1,1,0,0,  # 08 - 0f
+    1,1,1,1,1,1,1,1,  # 10 - 17
+    1,1,1,0,1,1,1,1,  # 18 - 1f
+    1,1,1,1,1,1,1,1,  # 20 - 27
+    1,1,1,1,1,1,1,1,  # 28 - 2f
+    1,1,1,1,1,1,1,1,  # 30 - 37
+    1,1,1,1,1,1,1,1,  # 38 - 3f
+    2,2,2,2,2,2,2,2,  # 40 - 47
+    2,2,2,2,2,2,2,2,  # 48 - 4f
+    2,2,2,2,2,2,2,2,  # 50 - 57
+    2,2,2,2,2,2,2,2,  # 58 - 5f
+    2,2,2,2,2,2,2,2,  # 60 - 67
+    2,2,2,2,2,2,2,2,  # 68 - 6f
+    2,2,2,2,2,2,2,2,  # 70 - 77
+    2,2,2,2,2,2,2,1,  # 78 - 7f
+    3,3,3,3,3,2,2,3,  # 80 - 87
+    3,3,3,3,3,3,3,3,  # 88 - 8f
+    3,3,3,3,3,3,3,3,  # 90 - 97
+    3,3,3,3,3,3,3,3,  # 98 - 9f
+    #0xa0 is illegal in sjis encoding, but some pages does
+    #contain such byte. We need to be more error forgiven.
+    2,2,2,2,2,2,2,2,  # a0 - a7
+    2,2,2,2,2,2,2,2,  # a8 - af
+    2,2,2,2,2,2,2,2,  # b0 - b7
+    2,2,2,2,2,2,2,2,  # b8 - bf
+    2,2,2,2,2,2,2,2,  # c0 - c7
+    2,2,2,2,2,2,2,2,  # c8 - cf
+    2,2,2,2,2,2,2,2,  # d0 - d7
+    2,2,2,2,2,2,2,2,  # d8 - df
+    3,3,3,3,3,3,3,3,  # e0 - e7
+    3,3,3,3,3,4,4,4,  # e8 - ef
+    3,3,3,3,3,3,3,3,  # f0 - f7
+    3,3,3,3,3,0,0,0)  # f8 - ff
+
+
+SJIS_ST = (
+    MachineState.ERROR,MachineState.START,MachineState.START,     3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START #10-17
+)
+
+SJIS_CHAR_LEN_TABLE = (0, 1, 1, 2, 0, 0)
+
+SJIS_SM_MODEL = {'class_table': SJIS_CLS,
+               'class_factor': 6,
+               'state_table': SJIS_ST,
+               'char_len_table': SJIS_CHAR_LEN_TABLE,
+               'name': 'Shift_JIS'}
+
+# UCS2-BE
+
+UCS2BE_CLS = (
+    0,0,0,0,0,0,0,0,  # 00 - 07
+    0,0,1,0,0,2,0,0,  # 08 - 0f
+    0,0,0,0,0,0,0,0,  # 10 - 17
+    0,0,0,3,0,0,0,0,  # 18 - 1f
+    0,0,0,0,0,0,0,0,  # 20 - 27
+    0,3,3,3,3,3,0,0,  # 28 - 2f
+    0,0,0,0,0,0,0,0,  # 30 - 37
+    0,0,0,0,0,0,0,0,  # 38 - 3f
+    0,0,0,0,0,0,0,0,  # 40 - 47
+    0,0,0,0,0,0,0,0,  # 48 - 4f
+    0,0,0,0,0,0,0,0,  # 50 - 57
+    0,0,0,0,0,0,0,0,  # 58 - 5f
+    0,0,0,0,0,0,0,0,  # 60 - 67
+    0,0,0,0,0,0,0,0,  # 68 - 6f
+    0,0,0,0,0,0,0,0,  # 70 - 77
+    0,0,0,0,0,0,0,0,  # 78 - 7f
+    0,0,0,0,0,0,0,0,  # 80 - 87
+    0,0,0,0,0,0,0,0,  # 88 - 8f
+    0,0,0,0,0,0,0,0,  # 90 - 97
+    0,0,0,0,0,0,0,0,  # 98 - 9f
+    0,0,0,0,0,0,0,0,  # a0 - a7
+    0,0,0,0,0,0,0,0,  # a8 - af
+    0,0,0,0,0,0,0,0,  # b0 - b7
+    0,0,0,0,0,0,0,0,  # b8 - bf
+    0,0,0,0,0,0,0,0,  # c0 - c7
+    0,0,0,0,0,0,0,0,  # c8 - cf
+    0,0,0,0,0,0,0,0,  # d0 - d7
+    0,0,0,0,0,0,0,0,  # d8 - df
+    0,0,0,0,0,0,0,0,  # e0 - e7
+    0,0,0,0,0,0,0,0,  # e8 - ef
+    0,0,0,0,0,0,0,0,  # f0 - f7
+    0,0,0,0,0,0,4,5   # f8 - ff
+)
+
+UCS2BE_ST  = (
+          5,     7,     7,MachineState.ERROR,     4,     3,MachineState.ERROR,MachineState.ERROR,#00-07
+     MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+     MachineState.ITS_ME,MachineState.ITS_ME,     6,     6,     6,     6,MachineState.ERROR,MachineState.ERROR,#10-17
+          6,     6,     6,     6,     6,MachineState.ITS_ME,     6,     6,#18-1f
+          6,     6,     6,     6,     5,     7,     7,MachineState.ERROR,#20-27
+          5,     8,     6,     6,MachineState.ERROR,     6,     6,     6,#28-2f
+          6,     6,     6,     6,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START #30-37
+)
+
+UCS2BE_CHAR_LEN_TABLE = (2, 2, 2, 0, 2, 2)
+
+UCS2BE_SM_MODEL = {'class_table': UCS2BE_CLS,
+                   'class_factor': 6,
+                   'state_table': UCS2BE_ST,
+                   'char_len_table': UCS2BE_CHAR_LEN_TABLE,
+                   'name': 'UTF-16BE'}
+
+# UCS2-LE
+
+UCS2LE_CLS = (
+    0,0,0,0,0,0,0,0,  # 00 - 07
+    0,0,1,0,0,2,0,0,  # 08 - 0f
+    0,0,0,0,0,0,0,0,  # 10 - 17
+    0,0,0,3,0,0,0,0,  # 18 - 1f
+    0,0,0,0,0,0,0,0,  # 20 - 27
+    0,3,3,3,3,3,0,0,  # 28 - 2f
+    0,0,0,0,0,0,0,0,  # 30 - 37
+    0,0,0,0,0,0,0,0,  # 38 - 3f
+    0,0,0,0,0,0,0,0,  # 40 - 47
+    0,0,0,0,0,0,0,0,  # 48 - 4f
+    0,0,0,0,0,0,0,0,  # 50 - 57
+    0,0,0,0,0,0,0,0,  # 58 - 5f
+    0,0,0,0,0,0,0,0,  # 60 - 67
+    0,0,0,0,0,0,0,0,  # 68 - 6f
+    0,0,0,0,0,0,0,0,  # 70 - 77
+    0,0,0,0,0,0,0,0,  # 78 - 7f
+    0,0,0,0,0,0,0,0,  # 80 - 87
+    0,0,0,0,0,0,0,0,  # 88 - 8f
+    0,0,0,0,0,0,0,0,  # 90 - 97
+    0,0,0,0,0,0,0,0,  # 98 - 9f
+    0,0,0,0,0,0,0,0,  # a0 - a7
+    0,0,0,0,0,0,0,0,  # a8 - af
+    0,0,0,0,0,0,0,0,  # b0 - b7
+    0,0,0,0,0,0,0,0,  # b8 - bf
+    0,0,0,0,0,0,0,0,  # c0 - c7
+    0,0,0,0,0,0,0,0,  # c8 - cf
+    0,0,0,0,0,0,0,0,  # d0 - d7
+    0,0,0,0,0,0,0,0,  # d8 - df
+    0,0,0,0,0,0,0,0,  # e0 - e7
+    0,0,0,0,0,0,0,0,  # e8 - ef
+    0,0,0,0,0,0,0,0,  # f0 - f7
+    0,0,0,0,0,0,4,5   # f8 - ff
+)
+
+UCS2LE_ST = (
+          6,     6,     7,     6,     4,     3,MachineState.ERROR,MachineState.ERROR,#00-07
+     MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+     MachineState.ITS_ME,MachineState.ITS_ME,     5,     5,     5,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,#10-17
+          5,     5,     5,MachineState.ERROR,     5,MachineState.ERROR,     6,     6,#18-1f
+          7,     6,     8,     8,     5,     5,     5,MachineState.ERROR,#20-27
+          5,     5,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     5,     5,#28-2f
+          5,     5,     5,MachineState.ERROR,     5,MachineState.ERROR,MachineState.START,MachineState.START #30-37
+)
+
+UCS2LE_CHAR_LEN_TABLE = (2, 2, 2, 2, 2, 2)
+
+UCS2LE_SM_MODEL = {'class_table': UCS2LE_CLS,
+                 'class_factor': 6,
+                 'state_table': UCS2LE_ST,
+                 'char_len_table': UCS2LE_CHAR_LEN_TABLE,
+                 'name': 'UTF-16LE'}
+
+# UTF-8
+
+UTF8_CLS = (
+    1,1,1,1,1,1,1,1,  # 00 - 07  #allow 0x00 as a legal value
+    1,1,1,1,1,1,0,0,  # 08 - 0f
+    1,1,1,1,1,1,1,1,  # 10 - 17
+    1,1,1,0,1,1,1,1,  # 18 - 1f
+    1,1,1,1,1,1,1,1,  # 20 - 27
+    1,1,1,1,1,1,1,1,  # 28 - 2f
+    1,1,1,1,1,1,1,1,  # 30 - 37
+    1,1,1,1,1,1,1,1,  # 38 - 3f
+    1,1,1,1,1,1,1,1,  # 40 - 47
+    1,1,1,1,1,1,1,1,  # 48 - 4f
+    1,1,1,1,1,1,1,1,  # 50 - 57
+    1,1,1,1,1,1,1,1,  # 58 - 5f
+    1,1,1,1,1,1,1,1,  # 60 - 67
+    1,1,1,1,1,1,1,1,  # 68 - 6f
+    1,1,1,1,1,1,1,1,  # 70 - 77
+    1,1,1,1,1,1,1,1,  # 78 - 7f
+    2,2,2,2,3,3,3,3,  # 80 - 87
+    4,4,4,4,4,4,4,4,  # 88 - 8f
+    4,4,4,4,4,4,4,4,  # 90 - 97
+    4,4,4,4,4,4,4,4,  # 98 - 9f
+    5,5,5,5,5,5,5,5,  # a0 - a7
+    5,5,5,5,5,5,5,5,  # a8 - af
+    5,5,5,5,5,5,5,5,  # b0 - b7
+    5,5,5,5,5,5,5,5,  # b8 - bf
+    0,0,6,6,6,6,6,6,  # c0 - c7
+    6,6,6,6,6,6,6,6,  # c8 - cf
+    6,6,6,6,6,6,6,6,  # d0 - d7
+    6,6,6,6,6,6,6,6,  # d8 - df
+    7,8,8,8,8,8,8,8,  # e0 - e7
+    8,8,8,8,8,9,8,8,  # e8 - ef
+    10,11,11,11,11,11,11,11,  # f0 - f7
+    12,13,13,13,14,15,0,0    # f8 - ff
+)
+
+UTF8_ST = (
+    MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     12,   10,#00-07
+         9,     11,     8,     7,     6,     5,     4,    3,#08-0f
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#10-17
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#18-1f
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#20-27
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#28-2f
+    MachineState.ERROR,MachineState.ERROR,     5,     5,     5,     5,MachineState.ERROR,MachineState.ERROR,#30-37
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#38-3f
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     5,     5,     5,MachineState.ERROR,MachineState.ERROR,#40-47
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#48-4f
+    MachineState.ERROR,MachineState.ERROR,     7,     7,     7,     7,MachineState.ERROR,MachineState.ERROR,#50-57
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#58-5f
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     7,     7,MachineState.ERROR,MachineState.ERROR,#60-67
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#68-6f
+    MachineState.ERROR,MachineState.ERROR,     9,     9,     9,     9,MachineState.ERROR,MachineState.ERROR,#70-77
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#78-7f
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     9,MachineState.ERROR,MachineState.ERROR,#80-87
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#88-8f
+    MachineState.ERROR,MachineState.ERROR,    12,    12,    12,    12,MachineState.ERROR,MachineState.ERROR,#90-97
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#98-9f
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,    12,MachineState.ERROR,MachineState.ERROR,#a0-a7
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#a8-af
+    MachineState.ERROR,MachineState.ERROR,    12,    12,    12,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#b0-b7
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#b8-bf
+    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,#c0-c7
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR #c8-cf
+)
+
+UTF8_CHAR_LEN_TABLE = (0, 1, 0, 0, 0, 0, 2, 3, 3, 3, 4, 4, 5, 5, 6, 6)
+
+UTF8_SM_MODEL = {'class_table': UTF8_CLS,
+                 'class_factor': 16,
+                 'state_table': UTF8_ST,
+                 'char_len_table': UTF8_CHAR_LEN_TABLE,
+                 'name': 'UTF-8'}
diff --git a/openpype/vendor/python/python_2/chardet/metadata/__init__.py b/openpype/vendor/python/python_2/chardet/metadata/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/vendor/python/python_2/chardet/metadata/languages.py b/openpype/vendor/python/python_2/chardet/metadata/languages.py
new file mode 100644
index 0000000000..3237d5abf6
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/metadata/languages.py
@@ -0,0 +1,310 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""
+Metadata about languages used by our model training code for our
+SingleByteCharSetProbers.  Could be used for other things in the future.
+
+This code is based on the language metadata from the uchardet project.
+"""
+from __future__ import absolute_import, print_function
+
+from string import ascii_letters
+
+
+# TODO: Add Ukranian (KOI8-U)
+
+class Language(object):
+    """Metadata about a language useful for training models
+
+    :ivar name: The human name for the language, in English.
+    :type name: str
+    :ivar iso_code: 2-letter ISO 639-1 if possible, 3-letter ISO code otherwise,
+                    or use another catalog as a last resort.
+    :type iso_code: str
+    :ivar use_ascii: Whether or not ASCII letters should be included in trained
+                     models.
+    :type use_ascii: bool
+    :ivar charsets: The charsets we want to support and create data for.
+    :type charsets: list of str
+    :ivar alphabet: The characters in the language's alphabet. If `use_ascii` is
+                    `True`, you only need to add those not in the ASCII set.
+    :type alphabet: str
+    :ivar wiki_start_pages: The Wikipedia pages to start from if we're crawling
+                            Wikipedia for training data.
+    :type wiki_start_pages: list of str
+    """
+    def __init__(self, name=None, iso_code=None, use_ascii=True, charsets=None,
+                 alphabet=None, wiki_start_pages=None):
+        super(Language, self).__init__()
+        self.name = name
+        self.iso_code = iso_code
+        self.use_ascii = use_ascii
+        self.charsets = charsets
+        if self.use_ascii:
+            if alphabet:
+                alphabet += ascii_letters
+            else:
+                alphabet = ascii_letters
+        elif not alphabet:
+            raise ValueError('Must supply alphabet if use_ascii is False')
+        self.alphabet = ''.join(sorted(set(alphabet))) if alphabet else None
+        self.wiki_start_pages = wiki_start_pages
+
+    def __repr__(self):
+        return '{}({})'.format(self.__class__.__name__,
+                               ', '.join('{}={!r}'.format(k, v)
+                                         for k, v in self.__dict__.items()
+                                         if not k.startswith('_')))
+
+
+LANGUAGES = {'Arabic': Language(name='Arabic',
+                                iso_code='ar',
+                                use_ascii=False,
+                                # We only support encodings that use isolated
+                                # forms, because the current recommendation is
+                                # that the rendering system handles presentation
+                                # forms. This means we purposefully skip IBM864.
+                                charsets=['ISO-8859-6', 'WINDOWS-1256',
+                                          'CP720', 'CP864'],
+                                alphabet=u'ءآأؤإئابةتثجحخدذرزسشصضطظعغػؼؽؾؿـفقكلمنهوىيًٌٍَُِّ',
+                                wiki_start_pages=[u'الصفحة_الرئيسية']),
+             'Belarusian': Language(name='Belarusian',
+                                    iso_code='be',
+                                    use_ascii=False,
+                                    charsets=['ISO-8859-5', 'WINDOWS-1251',
+                                              'IBM866', 'MacCyrillic'],
+                                    alphabet=(u'АБВГДЕЁЖЗІЙКЛМНОПРСТУЎФХЦЧШЫЬЭЮЯ'
+                                              u'абвгдеёжзійклмнопрстуўфхцчшыьэюяʼ'),
+                                    wiki_start_pages=[u'Галоўная_старонка']),
+             'Bulgarian': Language(name='Bulgarian',
+                                   iso_code='bg',
+                                   use_ascii=False,
+                                   charsets=['ISO-8859-5', 'WINDOWS-1251',
+                                             'IBM855'],
+                                   alphabet=(u'АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЬЮЯ'
+                                             u'абвгдежзийклмнопрстуфхцчшщъьюя'),
+                                   wiki_start_pages=[u'Начална_страница']),
+             'Czech': Language(name='Czech',
+                               iso_code='cz',
+                               use_ascii=True,
+                               charsets=['ISO-8859-2', 'WINDOWS-1250'],
+                               alphabet=u'áčďéěíňóřšťúůýžÁČĎÉĚÍŇÓŘŠŤÚŮÝŽ',
+                               wiki_start_pages=[u'Hlavní_strana']),
+             'Danish': Language(name='Danish',
+                                iso_code='da',
+                                use_ascii=True,
+                                charsets=['ISO-8859-1', 'ISO-8859-15',
+                                          'WINDOWS-1252'],
+                                alphabet=u'æøåÆØÅ',
+                                wiki_start_pages=[u'Forside']),
+             'German': Language(name='German',
+                                iso_code='de',
+                                use_ascii=True,
+                                charsets=['ISO-8859-1', 'WINDOWS-1252'],
+                                alphabet=u'äöüßÄÖÜ',
+                                wiki_start_pages=[u'Wikipedia:Hauptseite']),
+             'Greek': Language(name='Greek',
+                               iso_code='el',
+                               use_ascii=False,
+                               charsets=['ISO-8859-7', 'WINDOWS-1253'],
+                               alphabet=(u'αβγδεζηθικλμνξοπρσςτυφχψωάέήίόύώ'
+                                         u'ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΣΤΥΦΧΨΩΆΈΉΊΌΎΏ'),
+                               wiki_start_pages=[u'Πύλη:Κύρια']),
+             'English': Language(name='English',
+                                 iso_code='en',
+                                 use_ascii=True,
+                                 charsets=['ISO-8859-1', 'WINDOWS-1252'],
+                                 wiki_start_pages=[u'Main_Page']),
+             'Esperanto': Language(name='Esperanto',
+                                   iso_code='eo',
+                                   # Q, W, X, and Y not used at all
+                                   use_ascii=False,
+                                   charsets=['ISO-8859-3'],
+                                   alphabet=(u'abcĉdefgĝhĥijĵklmnoprsŝtuŭvz'
+                                             u'ABCĈDEFGĜHĤIJĴKLMNOPRSŜTUŬVZ'),
+                                   wiki_start_pages=[u'Vikipedio:Ĉefpaĝo']),
+             'Spanish': Language(name='Spanish',
+                                 iso_code='es',
+                                 use_ascii=True,
+                                 charsets=['ISO-8859-1', 'ISO-8859-15',
+                                           'WINDOWS-1252'],
+                                 alphabet=u'ñáéíóúüÑÁÉÍÓÚÜ',
+                                 wiki_start_pages=[u'Wikipedia:Portada']),
+             'Estonian': Language(name='Estonian',
+                                  iso_code='et',
+                                  use_ascii=False,
+                                  charsets=['ISO-8859-4', 'ISO-8859-13',
+                                            'WINDOWS-1257'],
+                                  # C, F, Š, Q, W, X, Y, Z, Ž are only for
+                                  # loanwords
+                                  alphabet=(u'ABDEGHIJKLMNOPRSTUVÕÄÖÜ'
+                                            u'abdeghijklmnoprstuvõäöü'),
+                                  wiki_start_pages=[u'Esileht']),
+             'Finnish': Language(name='Finnish',
+                                 iso_code='fi',
+                                 use_ascii=True,
+                                 charsets=['ISO-8859-1', 'ISO-8859-15',
+                                           'WINDOWS-1252'],
+                                 alphabet=u'ÅÄÖŠŽåäöšž',
+                                 wiki_start_pages=[u'Wikipedia:Etusivu']),
+             'French': Language(name='French',
+                                iso_code='fr',
+                                use_ascii=True,
+                                charsets=['ISO-8859-1', 'ISO-8859-15',
+                                          'WINDOWS-1252'],
+                                alphabet=u'œàâçèéîïùûêŒÀÂÇÈÉÎÏÙÛÊ',
+                                wiki_start_pages=[u'Wikipédia:Accueil_principal',
+                                                  u'Bœuf (animal)']),
+             'Hebrew': Language(name='Hebrew',
+                                iso_code='he',
+                                use_ascii=False,
+                                charsets=['ISO-8859-8', 'WINDOWS-1255'],
+                                alphabet=u'אבגדהוזחטיךכלםמןנסעףפץצקרשתװױײ',
+                                wiki_start_pages=[u'עמוד_ראשי']),
+             'Croatian': Language(name='Croatian',
+                                  iso_code='hr',
+                                  # Q, W, X, Y are only used for foreign words.
+                                  use_ascii=False,
+                                  charsets=['ISO-8859-2', 'WINDOWS-1250'],
+                                  alphabet=(u'abcčćdđefghijklmnoprsštuvzž'
+                                            u'ABCČĆDĐEFGHIJKLMNOPRSŠTUVZŽ'),
+                                  wiki_start_pages=[u'Glavna_stranica']),
+             'Hungarian': Language(name='Hungarian',
+                                   iso_code='hu',
+                                   # Q, W, X, Y are only used for foreign words.
+                                   use_ascii=False,
+                                   charsets=['ISO-8859-2', 'WINDOWS-1250'],
+                                   alphabet=(u'abcdefghijklmnoprstuvzáéíóöőúüű'
+                                             u'ABCDEFGHIJKLMNOPRSTUVZÁÉÍÓÖŐÚÜŰ'),
+                                   wiki_start_pages=[u'Kezdőlap']),
+             'Italian': Language(name='Italian',
+                                 iso_code='it',
+                                 use_ascii=True,
+                                 charsets=['ISO-8859-1', 'ISO-8859-15',
+                                           'WINDOWS-1252'],
+                                 alphabet=u'ÀÈÉÌÒÓÙàèéìòóù',
+                                 wiki_start_pages=[u'Pagina_principale']),
+             'Lithuanian': Language(name='Lithuanian',
+                                    iso_code='lt',
+                                    use_ascii=False,
+                                    charsets=['ISO-8859-13', 'WINDOWS-1257',
+                                              'ISO-8859-4'],
+                                    # Q, W, and X not used at all
+                                    alphabet=(u'AĄBCČDEĘĖFGHIĮYJKLMNOPRSŠTUŲŪVZŽ'
+                                              u'aąbcčdeęėfghiįyjklmnoprsštuųūvzž'),
+                                    wiki_start_pages=[u'Pagrindinis_puslapis']),
+             'Latvian': Language(name='Latvian',
+                                 iso_code='lv',
+                                 use_ascii=False,
+                                 charsets=['ISO-8859-13', 'WINDOWS-1257',
+                                           'ISO-8859-4'],
+                                 # Q, W, X, Y are only for loanwords
+                                 alphabet=(u'AĀBCČDEĒFGĢHIĪJKĶLĻMNŅOPRSŠTUŪVZŽ'
+                                           u'aābcčdeēfgģhiījkķlļmnņoprsštuūvzž'),
+                                 wiki_start_pages=[u'Sākumlapa']),
+             'Macedonian': Language(name='Macedonian',
+                                    iso_code='mk',
+                                    use_ascii=False,
+                                    charsets=['ISO-8859-5', 'WINDOWS-1251',
+                                              'MacCyrillic', 'IBM855'],
+                                    alphabet=(u'АБВГДЃЕЖЗЅИЈКЛЉМНЊОПРСТЌУФХЦЧЏШ'
+                                              u'абвгдѓежзѕијклљмнњопрстќуфхцчџш'),
+                                    wiki_start_pages=[u'Главна_страница']),
+             'Dutch': Language(name='Dutch',
+                               iso_code='nl',
+                               use_ascii=True,
+                               charsets=['ISO-8859-1', 'WINDOWS-1252'],
+                               wiki_start_pages=[u'Hoofdpagina']),
+             'Polish': Language(name='Polish',
+                                iso_code='pl',
+                                # Q and X are only used for foreign words.
+                                use_ascii=False,
+                                charsets=['ISO-8859-2', 'WINDOWS-1250'],
+                                alphabet=(u'AĄBCĆDEĘFGHIJKLŁMNŃOÓPRSŚTUWYZŹŻ'
+                                          u'aąbcćdeęfghijklłmnńoóprsśtuwyzźż'),
+                                wiki_start_pages=[u'Wikipedia:Strona_główna']),
+             'Portuguese': Language(name='Portuguese',
+                                 iso_code='pt',
+                                 use_ascii=True,
+                                 charsets=['ISO-8859-1', 'ISO-8859-15',
+                                           'WINDOWS-1252'],
+                                 alphabet=u'ÁÂÃÀÇÉÊÍÓÔÕÚáâãàçéêíóôõú',
+                                 wiki_start_pages=[u'Wikipédia:Página_principal']),
+             'Romanian': Language(name='Romanian',
+                                  iso_code='ro',
+                                  use_ascii=True,
+                                  charsets=['ISO-8859-2', 'WINDOWS-1250'],
+                                  alphabet=u'ăâîșțĂÂÎȘȚ',
+                                  wiki_start_pages=[u'Pagina_principală']),
+             'Russian': Language(name='Russian',
+                                 iso_code='ru',
+                                 use_ascii=False,
+                                 charsets=['ISO-8859-5', 'WINDOWS-1251',
+                                           'KOI8-R', 'MacCyrillic', 'IBM866',
+                                           'IBM855'],
+                                 alphabet=(u'абвгдеёжзийклмнопрстуфхцчшщъыьэюя'
+                                           u'АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ'),
+                                 wiki_start_pages=[u'Заглавная_страница']),
+             'Slovak': Language(name='Slovak',
+                                iso_code='sk',
+                                use_ascii=True,
+                                charsets=['ISO-8859-2', 'WINDOWS-1250'],
+                                alphabet=u'áäčďéíĺľňóôŕšťúýžÁÄČĎÉÍĹĽŇÓÔŔŠŤÚÝŽ',
+                                wiki_start_pages=[u'Hlavná_stránka']),
+             'Slovene': Language(name='Slovene',
+                                 iso_code='sl',
+                                 # Q, W, X, Y are only used for foreign words.
+                                 use_ascii=False,
+                                 charsets=['ISO-8859-2', 'WINDOWS-1250'],
+                                 alphabet=(u'abcčdefghijklmnoprsštuvzž'
+                                           u'ABCČDEFGHIJKLMNOPRSŠTUVZŽ'),
+                                 wiki_start_pages=[u'Glavna_stran']),
+             # Serbian can be written in both Latin and Cyrillic, but there's no
+             # simple way to get the Latin alphabet pages from Wikipedia through
+             # the API, so for now we just support Cyrillic.
+             'Serbian': Language(name='Serbian',
+                                 iso_code='sr',
+                                 alphabet=(u'АБВГДЂЕЖЗИЈКЛЉМНЊОПРСТЋУФХЦЧЏШ'
+                                           u'абвгдђежзијклљмнњопрстћуфхцчџш'),
+                                 charsets=['ISO-8859-5', 'WINDOWS-1251',
+                                           'MacCyrillic', 'IBM855'],
+                                 wiki_start_pages=[u'Главна_страна']),
+             'Thai': Language(name='Thai',
+                              iso_code='th',
+                              use_ascii=False,
+                              charsets=['ISO-8859-11', 'TIS-620', 'CP874'],
+                              alphabet=u'กขฃคฅฆงจฉชซฌญฎฏฐฑฒณดตถทธนบปผฝพฟภมยรฤลฦวศษสหฬอฮฯะัาำิีึืฺุู฿เแโใไๅๆ็่้๊๋์ํ๎๏๐๑๒๓๔๕๖๗๘๙๚๛',
+                              wiki_start_pages=[u'หน้าหลัก']),
+             'Turkish': Language(name='Turkish',
+                                 iso_code='tr',
+                                 # Q, W, and X are not used by Turkish
+                                 use_ascii=False,
+                                 charsets=['ISO-8859-3', 'ISO-8859-9',
+                                           'WINDOWS-1254'],
+                                 alphabet=(u'abcçdefgğhıijklmnoöprsştuüvyzâîû'
+                                           u'ABCÇDEFGĞHIİJKLMNOÖPRSŞTUÜVYZÂÎÛ'),
+                                 wiki_start_pages=[u'Ana_Sayfa']),
+             'Vietnamese': Language(name='Vietnamese',
+                                    iso_code='vi',
+                                    use_ascii=False,
+                                    # Windows-1258 is the only common 8-bit
+                                    # Vietnamese encoding supported by Python.
+                                    # From Wikipedia:
+                                    # For systems that lack support for Unicode,
+                                    # dozens of 8-bit Vietnamese code pages are
+                                    # available.[1] The most common are VISCII
+                                    # (TCVN 5712:1993), VPS, and Windows-1258.[3]
+                                    # Where ASCII is required, such as when
+                                    # ensuring readability in plain text e-mail,
+                                    # Vietnamese letters are often encoded
+                                    # according to Vietnamese Quoted-Readable
+                                    # (VIQR) or VSCII Mnemonic (VSCII-MNEM),[4]
+                                    # though usage of either variable-width
+                                    # scheme has declined dramatically following
+                                    # the adoption of Unicode on the World Wide
+                                    # Web.
+                                    charsets=['WINDOWS-1258'],
+                                    alphabet=(u'aăâbcdđeêghiklmnoôơpqrstuưvxy'
+                                              u'AĂÂBCDĐEÊGHIKLMNOÔƠPQRSTUƯVXY'),
+                                    wiki_start_pages=[u'Chữ_Quốc_ngữ']),
+            }
diff --git a/openpype/vendor/python/python_2/chardet/sbcharsetprober.py b/openpype/vendor/python/python_2/chardet/sbcharsetprober.py
new file mode 100644
index 0000000000..46ba835c66
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/sbcharsetprober.py
@@ -0,0 +1,145 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from collections import namedtuple
+
+from .charsetprober import CharSetProber
+from .enums import CharacterCategory, ProbingState, SequenceLikelihood
+
+
+SingleByteCharSetModel = namedtuple('SingleByteCharSetModel',
+                                    ['charset_name',
+                                     'language',
+                                     'char_to_order_map',
+                                     'language_model',
+                                     'typical_positive_ratio',
+                                     'keep_ascii_letters',
+                                     'alphabet'])
+
+
+class SingleByteCharSetProber(CharSetProber):
+    SAMPLE_SIZE = 64
+    SB_ENOUGH_REL_THRESHOLD = 1024  #  0.25 * SAMPLE_SIZE^2
+    POSITIVE_SHORTCUT_THRESHOLD = 0.95
+    NEGATIVE_SHORTCUT_THRESHOLD = 0.05
+
+    def __init__(self, model, reversed=False, name_prober=None):
+        super(SingleByteCharSetProber, self).__init__()
+        self._model = model
+        # TRUE if we need to reverse every pair in the model lookup
+        self._reversed = reversed
+        # Optional auxiliary prober for name decision
+        self._name_prober = name_prober
+        self._last_order = None
+        self._seq_counters = None
+        self._total_seqs = None
+        self._total_char = None
+        self._freq_char = None
+        self.reset()
+
+    def reset(self):
+        super(SingleByteCharSetProber, self).reset()
+        # char order of last character
+        self._last_order = 255
+        self._seq_counters = [0] * SequenceLikelihood.get_num_categories()
+        self._total_seqs = 0
+        self._total_char = 0
+        # characters that fall in our sampling range
+        self._freq_char = 0
+
+    @property
+    def charset_name(self):
+        if self._name_prober:
+            return self._name_prober.charset_name
+        else:
+            return self._model.charset_name
+
+    @property
+    def language(self):
+        if self._name_prober:
+            return self._name_prober.language
+        else:
+            return self._model.language
+
+    def feed(self, byte_str):
+        # TODO: Make filter_international_words keep things in self.alphabet
+        if not self._model.keep_ascii_letters:
+            byte_str = self.filter_international_words(byte_str)
+        if not byte_str:
+            return self.state
+        char_to_order_map = self._model.char_to_order_map
+        language_model = self._model.language_model
+        for char in byte_str:
+            order = char_to_order_map.get(char, CharacterCategory.UNDEFINED)
+            # XXX: This was SYMBOL_CAT_ORDER before, with a value of 250, but
+            #      CharacterCategory.SYMBOL is actually 253, so we use CONTROL
+            #      to make it closer to the original intent. The only difference
+            #      is whether or not we count digits and control characters for
+            #      _total_char purposes.
+            if order < CharacterCategory.CONTROL:
+                self._total_char += 1
+            # TODO: Follow uchardet's lead and discount confidence for frequent
+            #       control characters.
+            #       See https://github.com/BYVoid/uchardet/commit/55b4f23971db61
+            if order < self.SAMPLE_SIZE:
+                self._freq_char += 1
+                if self._last_order < self.SAMPLE_SIZE:
+                    self._total_seqs += 1
+                    if not self._reversed:
+                        lm_cat = language_model[self._last_order][order]
+                    else:
+                        lm_cat = language_model[order][self._last_order]
+                    self._seq_counters[lm_cat] += 1
+            self._last_order = order
+
+        charset_name = self._model.charset_name
+        if self.state == ProbingState.DETECTING:
+            if self._total_seqs > self.SB_ENOUGH_REL_THRESHOLD:
+                confidence = self.get_confidence()
+                if confidence > self.POSITIVE_SHORTCUT_THRESHOLD:
+                    self.logger.debug('%s confidence = %s, we have a winner',
+                                      charset_name, confidence)
+                    self._state = ProbingState.FOUND_IT
+                elif confidence < self.NEGATIVE_SHORTCUT_THRESHOLD:
+                    self.logger.debug('%s confidence = %s, below negative '
+                                      'shortcut threshhold %s', charset_name,
+                                      confidence,
+                                      self.NEGATIVE_SHORTCUT_THRESHOLD)
+                    self._state = ProbingState.NOT_ME
+
+        return self.state
+
+    def get_confidence(self):
+        r = 0.01
+        if self._total_seqs > 0:
+            r = ((1.0 * self._seq_counters[SequenceLikelihood.POSITIVE]) /
+                 self._total_seqs / self._model.typical_positive_ratio)
+            r = r * self._freq_char / self._total_char
+            if r >= 1.0:
+                r = 0.99
+        return r
diff --git a/openpype/vendor/python/python_2/chardet/sbcsgroupprober.py b/openpype/vendor/python/python_2/chardet/sbcsgroupprober.py
new file mode 100644
index 0000000000..bdeef4e15b
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/sbcsgroupprober.py
@@ -0,0 +1,83 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetgroupprober import CharSetGroupProber
+from .hebrewprober import HebrewProber
+from .langbulgarianmodel import (ISO_8859_5_BULGARIAN_MODEL,
+                                 WINDOWS_1251_BULGARIAN_MODEL)
+from .langgreekmodel import ISO_8859_7_GREEK_MODEL, WINDOWS_1253_GREEK_MODEL
+from .langhebrewmodel import WINDOWS_1255_HEBREW_MODEL
+# from .langhungarianmodel import (ISO_8859_2_HUNGARIAN_MODEL,
+#                                  WINDOWS_1250_HUNGARIAN_MODEL)
+from .langrussianmodel import (IBM855_RUSSIAN_MODEL, IBM866_RUSSIAN_MODEL,
+                               ISO_8859_5_RUSSIAN_MODEL, KOI8_R_RUSSIAN_MODEL,
+                               MACCYRILLIC_RUSSIAN_MODEL,
+                               WINDOWS_1251_RUSSIAN_MODEL)
+from .langthaimodel import TIS_620_THAI_MODEL
+from .langturkishmodel import ISO_8859_9_TURKISH_MODEL
+from .sbcharsetprober import SingleByteCharSetProber
+
+
+class SBCSGroupProber(CharSetGroupProber):
+    def __init__(self):
+        super(SBCSGroupProber, self).__init__()
+        hebrew_prober = HebrewProber()
+        logical_hebrew_prober = SingleByteCharSetProber(WINDOWS_1255_HEBREW_MODEL,
+                                                        False, hebrew_prober)
+        # TODO: See if using ISO-8859-8 Hebrew model works better here, since
+        #       it's actually the visual one
+        visual_hebrew_prober = SingleByteCharSetProber(WINDOWS_1255_HEBREW_MODEL,
+                                                       True, hebrew_prober)
+        hebrew_prober.set_model_probers(logical_hebrew_prober,
+                                        visual_hebrew_prober)
+        # TODO: ORDER MATTERS HERE. I changed the order vs what was in master
+        #       and several tests failed that did not before. Some thought
+        #       should be put into the ordering, and we should consider making
+        #       order not matter here, because that is very counter-intuitive.
+        self.probers = [
+            SingleByteCharSetProber(WINDOWS_1251_RUSSIAN_MODEL),
+            SingleByteCharSetProber(KOI8_R_RUSSIAN_MODEL),
+            SingleByteCharSetProber(ISO_8859_5_RUSSIAN_MODEL),
+            SingleByteCharSetProber(MACCYRILLIC_RUSSIAN_MODEL),
+            SingleByteCharSetProber(IBM866_RUSSIAN_MODEL),
+            SingleByteCharSetProber(IBM855_RUSSIAN_MODEL),
+            SingleByteCharSetProber(ISO_8859_7_GREEK_MODEL),
+            SingleByteCharSetProber(WINDOWS_1253_GREEK_MODEL),
+            SingleByteCharSetProber(ISO_8859_5_BULGARIAN_MODEL),
+            SingleByteCharSetProber(WINDOWS_1251_BULGARIAN_MODEL),
+            # TODO: Restore Hungarian encodings (iso-8859-2 and windows-1250)
+            #       after we retrain model.
+            # SingleByteCharSetProber(ISO_8859_2_HUNGARIAN_MODEL),
+            # SingleByteCharSetProber(WINDOWS_1250_HUNGARIAN_MODEL),
+            SingleByteCharSetProber(TIS_620_THAI_MODEL),
+            SingleByteCharSetProber(ISO_8859_9_TURKISH_MODEL),
+            hebrew_prober,
+            logical_hebrew_prober,
+            visual_hebrew_prober,
+        ]
+        self.reset()
diff --git a/openpype/vendor/python/python_2/chardet/sjisprober.py b/openpype/vendor/python/python_2/chardet/sjisprober.py
new file mode 100644
index 0000000000..9e29623bdc
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/sjisprober.py
@@ -0,0 +1,92 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import SJISDistributionAnalysis
+from .jpcntx import SJISContextAnalysis
+from .mbcssm import SJIS_SM_MODEL
+from .enums import ProbingState, MachineState
+
+
+class SJISProber(MultiByteCharSetProber):
+    def __init__(self):
+        super(SJISProber, self).__init__()
+        self.coding_sm = CodingStateMachine(SJIS_SM_MODEL)
+        self.distribution_analyzer = SJISDistributionAnalysis()
+        self.context_analyzer = SJISContextAnalysis()
+        self.reset()
+
+    def reset(self):
+        super(SJISProber, self).reset()
+        self.context_analyzer.reset()
+
+    @property
+    def charset_name(self):
+        return self.context_analyzer.charset_name
+
+    @property
+    def language(self):
+        return "Japanese"
+
+    def feed(self, byte_str):
+        for i in range(len(byte_str)):
+            coding_state = self.coding_sm.next_state(byte_str[i])
+            if coding_state == MachineState.ERROR:
+                self.logger.debug('%s %s prober hit error at byte %s',
+                                  self.charset_name, self.language, i)
+                self._state = ProbingState.NOT_ME
+                break
+            elif coding_state == MachineState.ITS_ME:
+                self._state = ProbingState.FOUND_IT
+                break
+            elif coding_state == MachineState.START:
+                char_len = self.coding_sm.get_current_charlen()
+                if i == 0:
+                    self._last_char[1] = byte_str[0]
+                    self.context_analyzer.feed(self._last_char[2 - char_len:],
+                                               char_len)
+                    self.distribution_analyzer.feed(self._last_char, char_len)
+                else:
+                    self.context_analyzer.feed(byte_str[i + 1 - char_len:i + 3
+                                                        - char_len], char_len)
+                    self.distribution_analyzer.feed(byte_str[i - 1:i + 1],
+                                                    char_len)
+
+        self._last_char[0] = byte_str[-1]
+
+        if self.state == ProbingState.DETECTING:
+            if (self.context_analyzer.got_enough_data() and
+               (self.get_confidence() > self.SHORTCUT_THRESHOLD)):
+                self._state = ProbingState.FOUND_IT
+
+        return self.state
+
+    def get_confidence(self):
+        context_conf = self.context_analyzer.get_confidence()
+        distrib_conf = self.distribution_analyzer.get_confidence()
+        return max(context_conf, distrib_conf)
diff --git a/openpype/vendor/python/python_2/chardet/universaldetector.py b/openpype/vendor/python/python_2/chardet/universaldetector.py
new file mode 100644
index 0000000000..055a8ac1b1
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/universaldetector.py
@@ -0,0 +1,286 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+"""
+Module containing the UniversalDetector detector class, which is the primary
+class a user of ``chardet`` should use.
+
+:author: Mark Pilgrim (initial port to Python)
+:author: Shy Shalom (original C code)
+:author: Dan Blanchard (major refactoring for 3.0)
+:author: Ian Cordasco
+"""
+
+
+import codecs
+import logging
+import re
+
+from .charsetgroupprober import CharSetGroupProber
+from .enums import InputState, LanguageFilter, ProbingState
+from .escprober import EscCharSetProber
+from .latin1prober import Latin1Prober
+from .mbcsgroupprober import MBCSGroupProber
+from .sbcsgroupprober import SBCSGroupProber
+
+
+class UniversalDetector(object):
+    """
+    The ``UniversalDetector`` class underlies the ``chardet.detect`` function
+    and coordinates all of the different charset probers.
+
+    To get a ``dict`` containing an encoding and its confidence, you can simply
+    run:
+
+    .. code::
+
+            u = UniversalDetector()
+            u.feed(some_bytes)
+            u.close()
+            detected = u.result
+
+    """
+
+    MINIMUM_THRESHOLD = 0.20
+    HIGH_BYTE_DETECTOR = re.compile(b'[\x80-\xFF]')
+    ESC_DETECTOR = re.compile(b'(\033|~{)')
+    WIN_BYTE_DETECTOR = re.compile(b'[\x80-\x9F]')
+    ISO_WIN_MAP = {'iso-8859-1': 'Windows-1252',
+                   'iso-8859-2': 'Windows-1250',
+                   'iso-8859-5': 'Windows-1251',
+                   'iso-8859-6': 'Windows-1256',
+                   'iso-8859-7': 'Windows-1253',
+                   'iso-8859-8': 'Windows-1255',
+                   'iso-8859-9': 'Windows-1254',
+                   'iso-8859-13': 'Windows-1257'}
+
+    def __init__(self, lang_filter=LanguageFilter.ALL):
+        self._esc_charset_prober = None
+        self._charset_probers = []
+        self.result = None
+        self.done = None
+        self._got_data = None
+        self._input_state = None
+        self._last_char = None
+        self.lang_filter = lang_filter
+        self.logger = logging.getLogger(__name__)
+        self._has_win_bytes = None
+        self.reset()
+
+    def reset(self):
+        """
+        Reset the UniversalDetector and all of its probers back to their
+        initial states.  This is called by ``__init__``, so you only need to
+        call this directly in between analyses of different documents.
+        """
+        self.result = {'encoding': None, 'confidence': 0.0, 'language': None}
+        self.done = False
+        self._got_data = False
+        self._has_win_bytes = False
+        self._input_state = InputState.PURE_ASCII
+        self._last_char = b''
+        if self._esc_charset_prober:
+            self._esc_charset_prober.reset()
+        for prober in self._charset_probers:
+            prober.reset()
+
+    def feed(self, byte_str):
+        """
+        Takes a chunk of a document and feeds it through all of the relevant
+        charset probers.
+
+        After calling ``feed``, you can check the value of the ``done``
+        attribute to see if you need to continue feeding the
+        ``UniversalDetector`` more data, or if it has made a prediction
+        (in the ``result`` attribute).
+
+        .. note::
+           You should always call ``close`` when you're done feeding in your
+           document if ``done`` is not already ``True``.
+        """
+        if self.done:
+            return
+
+        if not len(byte_str):
+            return
+
+        if not isinstance(byte_str, bytearray):
+            byte_str = bytearray(byte_str)
+
+        # First check for known BOMs, since these are guaranteed to be correct
+        if not self._got_data:
+            # If the data starts with BOM, we know it is UTF
+            if byte_str.startswith(codecs.BOM_UTF8):
+                # EF BB BF  UTF-8 with BOM
+                self.result = {'encoding': "UTF-8-SIG",
+                               'confidence': 1.0,
+                               'language': ''}
+            elif byte_str.startswith((codecs.BOM_UTF32_LE,
+                                      codecs.BOM_UTF32_BE)):
+                # FF FE 00 00  UTF-32, little-endian BOM
+                # 00 00 FE FF  UTF-32, big-endian BOM
+                self.result = {'encoding': "UTF-32",
+                               'confidence': 1.0,
+                               'language': ''}
+            elif byte_str.startswith(b'\xFE\xFF\x00\x00'):
+                # FE FF 00 00  UCS-4, unusual octet order BOM (3412)
+                self.result = {'encoding': "X-ISO-10646-UCS-4-3412",
+                               'confidence': 1.0,
+                               'language': ''}
+            elif byte_str.startswith(b'\x00\x00\xFF\xFE'):
+                # 00 00 FF FE  UCS-4, unusual octet order BOM (2143)
+                self.result = {'encoding': "X-ISO-10646-UCS-4-2143",
+                               'confidence': 1.0,
+                               'language': ''}
+            elif byte_str.startswith((codecs.BOM_LE, codecs.BOM_BE)):
+                # FF FE  UTF-16, little endian BOM
+                # FE FF  UTF-16, big endian BOM
+                self.result = {'encoding': "UTF-16",
+                               'confidence': 1.0,
+                               'language': ''}
+
+            self._got_data = True
+            if self.result['encoding'] is not None:
+                self.done = True
+                return
+
+        # If none of those matched and we've only see ASCII so far, check
+        # for high bytes and escape sequences
+        if self._input_state == InputState.PURE_ASCII:
+            if self.HIGH_BYTE_DETECTOR.search(byte_str):
+                self._input_state = InputState.HIGH_BYTE
+            elif self._input_state == InputState.PURE_ASCII and \
+                    self.ESC_DETECTOR.search(self._last_char + byte_str):
+                self._input_state = InputState.ESC_ASCII
+
+        self._last_char = byte_str[-1:]
+
+        # If we've seen escape sequences, use the EscCharSetProber, which
+        # uses a simple state machine to check for known escape sequences in
+        # HZ and ISO-2022 encodings, since those are the only encodings that
+        # use such sequences.
+        if self._input_state == InputState.ESC_ASCII:
+            if not self._esc_charset_prober:
+                self._esc_charset_prober = EscCharSetProber(self.lang_filter)
+            if self._esc_charset_prober.feed(byte_str) == ProbingState.FOUND_IT:
+                self.result = {'encoding':
+                               self._esc_charset_prober.charset_name,
+                               'confidence':
+                               self._esc_charset_prober.get_confidence(),
+                               'language':
+                               self._esc_charset_prober.language}
+                self.done = True
+        # If we've seen high bytes (i.e., those with values greater than 127),
+        # we need to do more complicated checks using all our multi-byte and
+        # single-byte probers that are left.  The single-byte probers
+        # use character bigram distributions to determine the encoding, whereas
+        # the multi-byte probers use a combination of character unigram and
+        # bigram distributions.
+        elif self._input_state == InputState.HIGH_BYTE:
+            if not self._charset_probers:
+                self._charset_probers = [MBCSGroupProber(self.lang_filter)]
+                # If we're checking non-CJK encodings, use single-byte prober
+                if self.lang_filter & LanguageFilter.NON_CJK:
+                    self._charset_probers.append(SBCSGroupProber())
+                self._charset_probers.append(Latin1Prober())
+            for prober in self._charset_probers:
+                if prober.feed(byte_str) == ProbingState.FOUND_IT:
+                    self.result = {'encoding': prober.charset_name,
+                                   'confidence': prober.get_confidence(),
+                                   'language': prober.language}
+                    self.done = True
+                    break
+            if self.WIN_BYTE_DETECTOR.search(byte_str):
+                self._has_win_bytes = True
+
+    def close(self):
+        """
+        Stop analyzing the current document and come up with a final
+        prediction.
+
+        :returns:  The ``result`` attribute, a ``dict`` with the keys
+                   `encoding`, `confidence`, and `language`.
+        """
+        # Don't bother with checks if we're already done
+        if self.done:
+            return self.result
+        self.done = True
+
+        if not self._got_data:
+            self.logger.debug('no data received!')
+
+        # Default to ASCII if it is all we've seen so far
+        elif self._input_state == InputState.PURE_ASCII:
+            self.result = {'encoding': 'ascii',
+                           'confidence': 1.0,
+                           'language': ''}
+
+        # If we have seen non-ASCII, return the best that met MINIMUM_THRESHOLD
+        elif self._input_state == InputState.HIGH_BYTE:
+            prober_confidence = None
+            max_prober_confidence = 0.0
+            max_prober = None
+            for prober in self._charset_probers:
+                if not prober:
+                    continue
+                prober_confidence = prober.get_confidence()
+                if prober_confidence > max_prober_confidence:
+                    max_prober_confidence = prober_confidence
+                    max_prober = prober
+            if max_prober and (max_prober_confidence > self.MINIMUM_THRESHOLD):
+                charset_name = max_prober.charset_name
+                lower_charset_name = max_prober.charset_name.lower()
+                confidence = max_prober.get_confidence()
+                # Use Windows encoding name instead of ISO-8859 if we saw any
+                # extra Windows-specific bytes
+                if lower_charset_name.startswith('iso-8859'):
+                    if self._has_win_bytes:
+                        charset_name = self.ISO_WIN_MAP.get(lower_charset_name,
+                                                            charset_name)
+                self.result = {'encoding': charset_name,
+                               'confidence': confidence,
+                               'language': max_prober.language}
+
+        # Log all prober confidences if none met MINIMUM_THRESHOLD
+        if self.logger.getEffectiveLevel() <= logging.DEBUG:
+            if self.result['encoding'] is None:
+                self.logger.debug('no probers hit minimum threshold')
+                for group_prober in self._charset_probers:
+                    if not group_prober:
+                        continue
+                    if isinstance(group_prober, CharSetGroupProber):
+                        for prober in group_prober.probers:
+                            self.logger.debug('%s %s confidence = %s',
+                                              prober.charset_name,
+                                              prober.language,
+                                              prober.get_confidence())
+                    else:
+                        self.logger.debug('%s %s confidence = %s',
+                                          group_prober.charset_name,
+                                          group_prober.language,
+                                          group_prober.get_confidence())
+        return self.result
diff --git a/openpype/vendor/python/python_2/chardet/utf8prober.py b/openpype/vendor/python/python_2/chardet/utf8prober.py
new file mode 100644
index 0000000000..6c3196cc2d
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/utf8prober.py
@@ -0,0 +1,82 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetprober import CharSetProber
+from .enums import ProbingState, MachineState
+from .codingstatemachine import CodingStateMachine
+from .mbcssm import UTF8_SM_MODEL
+
+
+
+class UTF8Prober(CharSetProber):
+    ONE_CHAR_PROB = 0.5
+
+    def __init__(self):
+        super(UTF8Prober, self).__init__()
+        self.coding_sm = CodingStateMachine(UTF8_SM_MODEL)
+        self._num_mb_chars = None
+        self.reset()
+
+    def reset(self):
+        super(UTF8Prober, self).reset()
+        self.coding_sm.reset()
+        self._num_mb_chars = 0
+
+    @property
+    def charset_name(self):
+        return "utf-8"
+
+    @property
+    def language(self):
+        return ""
+
+    def feed(self, byte_str):
+        for c in byte_str:
+            coding_state = self.coding_sm.next_state(c)
+            if coding_state == MachineState.ERROR:
+                self._state = ProbingState.NOT_ME
+                break
+            elif coding_state == MachineState.ITS_ME:
+                self._state = ProbingState.FOUND_IT
+                break
+            elif coding_state == MachineState.START:
+                if self.coding_sm.get_current_charlen() >= 2:
+                    self._num_mb_chars += 1
+
+        if self.state == ProbingState.DETECTING:
+            if self.get_confidence() > self.SHORTCUT_THRESHOLD:
+                self._state = ProbingState.FOUND_IT
+
+        return self.state
+
+    def get_confidence(self):
+        unlike = 0.99
+        if self._num_mb_chars < 6:
+            unlike *= self.ONE_CHAR_PROB ** self._num_mb_chars
+            return 1.0 - unlike
+        else:
+            return unlike
diff --git a/openpype/vendor/python/python_2/chardet/version.py b/openpype/vendor/python/python_2/chardet/version.py
new file mode 100644
index 0000000000..70369b9d66
--- /dev/null
+++ b/openpype/vendor/python/python_2/chardet/version.py
@@ -0,0 +1,9 @@
+"""
+This module exists only to simplify retrieving the version number of chardet
+from within setup.py and from chardet subpackages.
+
+:author: Dan Blanchard (dan.blanchard@gmail.com)
+"""
+
+__version__ = "4.0.0"
+VERSION = __version__.split('.')
diff --git a/openpype/vendor/python/python_2/idna/__init__.py b/openpype/vendor/python/python_2/idna/__init__.py
new file mode 100644
index 0000000000..847bf93547
--- /dev/null
+++ b/openpype/vendor/python/python_2/idna/__init__.py
@@ -0,0 +1,2 @@
+from .package_data import __version__
+from .core import *
diff --git a/openpype/vendor/python/python_2/idna/codec.py b/openpype/vendor/python/python_2/idna/codec.py
new file mode 100644
index 0000000000..98c65ead14
--- /dev/null
+++ b/openpype/vendor/python/python_2/idna/codec.py
@@ -0,0 +1,118 @@
+from .core import encode, decode, alabel, ulabel, IDNAError
+import codecs
+import re
+
+_unicode_dots_re = re.compile(u'[\u002e\u3002\uff0e\uff61]')
+
+class Codec(codecs.Codec):
+
+    def encode(self, data, errors='strict'):
+
+        if errors != 'strict':
+            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))
+
+        if not data:
+            return "", 0
+
+        return encode(data), len(data)
+
+    def decode(self, data, errors='strict'):
+
+        if errors != 'strict':
+            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))
+
+        if not data:
+            return u"", 0
+
+        return decode(data), len(data)
+
+class IncrementalEncoder(codecs.BufferedIncrementalEncoder):
+    def _buffer_encode(self, data, errors, final):
+        if errors != 'strict':
+            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))
+
+        if not data:
+            return ("", 0)
+
+        labels = _unicode_dots_re.split(data)
+        trailing_dot = u''
+        if labels:
+            if not labels[-1]:
+                trailing_dot = '.'
+                del labels[-1]
+            elif not final:
+                # Keep potentially unfinished label until the next call
+                del labels[-1]
+                if labels:
+                    trailing_dot = '.'
+
+        result = []
+        size = 0
+        for label in labels:
+            result.append(alabel(label))
+            if size:
+                size += 1
+            size += len(label)
+
+        # Join with U+002E
+        result = ".".join(result) + trailing_dot
+        size += len(trailing_dot)
+        return (result, size)
+
+class IncrementalDecoder(codecs.BufferedIncrementalDecoder):
+    def _buffer_decode(self, data, errors, final):
+        if errors != 'strict':
+            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))
+
+        if not data:
+            return (u"", 0)
+
+        # IDNA allows decoding to operate on Unicode strings, too.
+        if isinstance(data, unicode):
+            labels = _unicode_dots_re.split(data)
+        else:
+            # Must be ASCII string
+            data = str(data)
+            unicode(data, "ascii")
+            labels = data.split(".")
+
+        trailing_dot = u''
+        if labels:
+            if not labels[-1]:
+                trailing_dot = u'.'
+                del labels[-1]
+            elif not final:
+                # Keep potentially unfinished label until the next call
+                del labels[-1]
+                if labels:
+                    trailing_dot = u'.'
+
+        result = []
+        size = 0
+        for label in labels:
+            result.append(ulabel(label))
+            if size:
+                size += 1
+            size += len(label)
+
+        result = u".".join(result) + trailing_dot
+        size += len(trailing_dot)
+        return (result, size)
+
+
+class StreamWriter(Codec, codecs.StreamWriter):
+    pass
+
+class StreamReader(Codec, codecs.StreamReader):
+    pass
+
+def getregentry():
+    return codecs.CodecInfo(
+        name='idna',
+        encode=Codec().encode,
+        decode=Codec().decode,
+        incrementalencoder=IncrementalEncoder,
+        incrementaldecoder=IncrementalDecoder,
+        streamwriter=StreamWriter,
+        streamreader=StreamReader,
+    )
diff --git a/openpype/vendor/python/python_2/idna/compat.py b/openpype/vendor/python/python_2/idna/compat.py
new file mode 100644
index 0000000000..4d47f336db
--- /dev/null
+++ b/openpype/vendor/python/python_2/idna/compat.py
@@ -0,0 +1,12 @@
+from .core import *
+from .codec import *
+
+def ToASCII(label):
+    return encode(label)
+
+def ToUnicode(label):
+    return decode(label)
+
+def nameprep(s):
+    raise NotImplementedError("IDNA 2008 does not utilise nameprep protocol")
+
diff --git a/openpype/vendor/python/python_2/idna/core.py b/openpype/vendor/python/python_2/idna/core.py
new file mode 100644
index 0000000000..41ec5c711d
--- /dev/null
+++ b/openpype/vendor/python/python_2/idna/core.py
@@ -0,0 +1,400 @@
+from . import idnadata
+import bisect
+import unicodedata
+import re
+import sys
+from .intranges import intranges_contain
+
+_virama_combining_class = 9
+_alabel_prefix = b'xn--'
+_unicode_dots_re = re.compile(u'[\u002e\u3002\uff0e\uff61]')
+
+if sys.version_info[0] >= 3:
+    unicode = str
+    unichr = chr
+
+class IDNAError(UnicodeError):
+    """ Base exception for all IDNA-encoding related problems """
+    pass
+
+
+class IDNABidiError(IDNAError):
+    """ Exception when bidirectional requirements are not satisfied """
+    pass
+
+
+class InvalidCodepoint(IDNAError):
+    """ Exception when a disallowed or unallocated codepoint is used """
+    pass
+
+
+class InvalidCodepointContext(IDNAError):
+    """ Exception when the codepoint is not valid in the context it is used """
+    pass
+
+
+def _combining_class(cp):
+    v = unicodedata.combining(unichr(cp))
+    if v == 0:
+        if not unicodedata.name(unichr(cp)):
+            raise ValueError("Unknown character in unicodedata")
+    return v
+
+def _is_script(cp, script):
+    return intranges_contain(ord(cp), idnadata.scripts[script])
+
+def _punycode(s):
+    return s.encode('punycode')
+
+def _unot(s):
+    return 'U+{0:04X}'.format(s)
+
+
+def valid_label_length(label):
+
+    if len(label) > 63:
+        return False
+    return True
+
+
+def valid_string_length(label, trailing_dot):
+
+    if len(label) > (254 if trailing_dot else 253):
+        return False
+    return True
+
+
+def check_bidi(label, check_ltr=False):
+
+    # Bidi rules should only be applied if string contains RTL characters
+    bidi_label = False
+    for (idx, cp) in enumerate(label, 1):
+        direction = unicodedata.bidirectional(cp)
+        if direction == '':
+            # String likely comes from a newer version of Unicode
+            raise IDNABidiError('Unknown directionality in label {0} at position {1}'.format(repr(label), idx))
+        if direction in ['R', 'AL', 'AN']:
+            bidi_label = True
+    if not bidi_label and not check_ltr:
+        return True
+
+    # Bidi rule 1
+    direction = unicodedata.bidirectional(label[0])
+    if direction in ['R', 'AL']:
+        rtl = True
+    elif direction == 'L':
+        rtl = False
+    else:
+        raise IDNABidiError('First codepoint in label {0} must be directionality L, R or AL'.format(repr(label)))
+
+    valid_ending = False
+    number_type = False
+    for (idx, cp) in enumerate(label, 1):
+        direction = unicodedata.bidirectional(cp)
+
+        if rtl:
+            # Bidi rule 2
+            if not direction in ['R', 'AL', 'AN', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:
+                raise IDNABidiError('Invalid direction for codepoint at position {0} in a right-to-left label'.format(idx))
+            # Bidi rule 3
+            if direction in ['R', 'AL', 'EN', 'AN']:
+                valid_ending = True
+            elif direction != 'NSM':
+                valid_ending = False
+            # Bidi rule 4
+            if direction in ['AN', 'EN']:
+                if not number_type:
+                    number_type = direction
+                else:
+                    if number_type != direction:
+                        raise IDNABidiError('Can not mix numeral types in a right-to-left label')
+        else:
+            # Bidi rule 5
+            if not direction in ['L', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:
+                raise IDNABidiError('Invalid direction for codepoint at position {0} in a left-to-right label'.format(idx))
+            # Bidi rule 6
+            if direction in ['L', 'EN']:
+                valid_ending = True
+            elif direction != 'NSM':
+                valid_ending = False
+
+    if not valid_ending:
+        raise IDNABidiError('Label ends with illegal codepoint directionality')
+
+    return True
+
+
+def check_initial_combiner(label):
+
+    if unicodedata.category(label[0])[0] == 'M':
+        raise IDNAError('Label begins with an illegal combining character')
+    return True
+
+
+def check_hyphen_ok(label):
+
+    if label[2:4] == '--':
+        raise IDNAError('Label has disallowed hyphens in 3rd and 4th position')
+    if label[0] == '-' or label[-1] == '-':
+        raise IDNAError('Label must not start or end with a hyphen')
+    return True
+
+
+def check_nfc(label):
+
+    if unicodedata.normalize('NFC', label) != label:
+        raise IDNAError('Label must be in Normalization Form C')
+
+
+def valid_contextj(label, pos):
+
+    cp_value = ord(label[pos])
+
+    if cp_value == 0x200c:
+
+        if pos > 0:
+            if _combining_class(ord(label[pos - 1])) == _virama_combining_class:
+                return True
+
+        ok = False
+        for i in range(pos-1, -1, -1):
+            joining_type = idnadata.joining_types.get(ord(label[i]))
+            if joining_type == ord('T'):
+                continue
+            if joining_type in [ord('L'), ord('D')]:
+                ok = True
+                break
+
+        if not ok:
+            return False
+
+        ok = False
+        for i in range(pos+1, len(label)):
+            joining_type = idnadata.joining_types.get(ord(label[i]))
+            if joining_type == ord('T'):
+                continue
+            if joining_type in [ord('R'), ord('D')]:
+                ok = True
+                break
+        return ok
+
+    if cp_value == 0x200d:
+
+        if pos > 0:
+            if _combining_class(ord(label[pos - 1])) == _virama_combining_class:
+                return True
+        return False
+
+    else:
+
+        return False
+
+
+def valid_contexto(label, pos, exception=False):
+
+    cp_value = ord(label[pos])
+
+    if cp_value == 0x00b7:
+        if 0 < pos < len(label)-1:
+            if ord(label[pos - 1]) == 0x006c and ord(label[pos + 1]) == 0x006c:
+                return True
+        return False
+
+    elif cp_value == 0x0375:
+        if pos < len(label)-1 and len(label) > 1:
+            return _is_script(label[pos + 1], 'Greek')
+        return False
+
+    elif cp_value == 0x05f3 or cp_value == 0x05f4:
+        if pos > 0:
+            return _is_script(label[pos - 1], 'Hebrew')
+        return False
+
+    elif cp_value == 0x30fb:
+        for cp in label:
+            if cp == u'\u30fb':
+                continue
+            if _is_script(cp, 'Hiragana') or _is_script(cp, 'Katakana') or _is_script(cp, 'Han'):
+                return True
+        return False
+
+    elif 0x660 <= cp_value <= 0x669:
+        for cp in label:
+            if 0x6f0 <= ord(cp) <= 0x06f9:
+                return False
+        return True
+
+    elif 0x6f0 <= cp_value <= 0x6f9:
+        for cp in label:
+            if 0x660 <= ord(cp) <= 0x0669:
+                return False
+        return True
+
+
+def check_label(label):
+
+    if isinstance(label, (bytes, bytearray)):
+        label = label.decode('utf-8')
+    if len(label) == 0:
+        raise IDNAError('Empty Label')
+
+    check_nfc(label)
+    check_hyphen_ok(label)
+    check_initial_combiner(label)
+
+    for (pos, cp) in enumerate(label):
+        cp_value = ord(cp)
+        if intranges_contain(cp_value, idnadata.codepoint_classes['PVALID']):
+            continue
+        elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTJ']):
+            try:
+                if not valid_contextj(label, pos):
+                    raise InvalidCodepointContext('Joiner {0} not allowed at position {1} in {2}'.format(
+                        _unot(cp_value), pos+1, repr(label)))
+            except ValueError:
+                raise IDNAError('Unknown codepoint adjacent to joiner {0} at position {1} in {2}'.format(
+                    _unot(cp_value), pos+1, repr(label)))
+        elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTO']):
+            if not valid_contexto(label, pos):
+                raise InvalidCodepointContext('Codepoint {0} not allowed at position {1} in {2}'.format(_unot(cp_value), pos+1, repr(label)))
+        else:
+            raise InvalidCodepoint('Codepoint {0} at position {1} of {2} not allowed'.format(_unot(cp_value), pos+1, repr(label)))
+
+    check_bidi(label)
+
+
+def alabel(label):
+
+    try:
+        label = label.encode('ascii')
+        ulabel(label)
+        if not valid_label_length(label):
+            raise IDNAError('Label too long')
+        return label
+    except UnicodeEncodeError:
+        pass
+
+    if not label:
+        raise IDNAError('No Input')
+
+    label = unicode(label)
+    check_label(label)
+    label = _punycode(label)
+    label = _alabel_prefix + label
+
+    if not valid_label_length(label):
+        raise IDNAError('Label too long')
+
+    return label
+
+
+def ulabel(label):
+
+    if not isinstance(label, (bytes, bytearray)):
+        try:
+            label = label.encode('ascii')
+        except UnicodeEncodeError:
+            check_label(label)
+            return label
+
+    label = label.lower()
+    if label.startswith(_alabel_prefix):
+        label = label[len(_alabel_prefix):]
+        if not label:
+            raise IDNAError('Malformed A-label, no Punycode eligible content found')
+        if label.decode('ascii')[-1] == '-':
+            raise IDNAError('A-label must not end with a hyphen')
+    else:
+        check_label(label)
+        return label.decode('ascii')
+
+    label = label.decode('punycode')
+    check_label(label)
+    return label
+
+
+def uts46_remap(domain, std3_rules=True, transitional=False):
+    """Re-map the characters in the string according to UTS46 processing."""
+    from .uts46data import uts46data
+    output = u""
+    try:
+        for pos, char in enumerate(domain):
+            code_point = ord(char)
+            uts46row = uts46data[code_point if code_point < 256 else
+                bisect.bisect_left(uts46data, (code_point, "Z")) - 1]
+            status = uts46row[1]
+            replacement = uts46row[2] if len(uts46row) == 3 else None
+            if (status == "V" or
+                    (status == "D" and not transitional) or
+                    (status == "3" and not std3_rules and replacement is None)):
+                output += char
+            elif replacement is not None and (status == "M" or
+                    (status == "3" and not std3_rules) or
+                    (status == "D" and transitional)):
+                output += replacement
+            elif status != "I":
+                raise IndexError()
+        return unicodedata.normalize("NFC", output)
+    except IndexError:
+        raise InvalidCodepoint(
+            "Codepoint {0} not allowed at position {1} in {2}".format(
+            _unot(code_point), pos + 1, repr(domain)))
+
+
+def encode(s, strict=False, uts46=False, std3_rules=False, transitional=False):
+
+    if isinstance(s, (bytes, bytearray)):
+        s = s.decode("ascii")
+    if uts46:
+        s = uts46_remap(s, std3_rules, transitional)
+    trailing_dot = False
+    result = []
+    if strict:
+        labels = s.split('.')
+    else:
+        labels = _unicode_dots_re.split(s)
+    if not labels or labels == ['']:
+        raise IDNAError('Empty domain')
+    if labels[-1] == '':
+        del labels[-1]
+        trailing_dot = True
+    for label in labels:
+        s = alabel(label)
+        if s:
+            result.append(s)
+        else:
+            raise IDNAError('Empty label')
+    if trailing_dot:
+        result.append(b'')
+    s = b'.'.join(result)
+    if not valid_string_length(s, trailing_dot):
+        raise IDNAError('Domain too long')
+    return s
+
+
+def decode(s, strict=False, uts46=False, std3_rules=False):
+
+    if isinstance(s, (bytes, bytearray)):
+        s = s.decode("ascii")
+    if uts46:
+        s = uts46_remap(s, std3_rules, False)
+    trailing_dot = False
+    result = []
+    if not strict:
+        labels = _unicode_dots_re.split(s)
+    else:
+        labels = s.split(u'.')
+    if not labels or labels == ['']:
+        raise IDNAError('Empty domain')
+    if not labels[-1]:
+        del labels[-1]
+        trailing_dot = True
+    for label in labels:
+        s = ulabel(label)
+        if s:
+            result.append(s)
+        else:
+            raise IDNAError('Empty label')
+    if trailing_dot:
+        result.append(u'')
+    return u'.'.join(result)
diff --git a/openpype/vendor/python/python_2/idna/idnadata.py b/openpype/vendor/python/python_2/idna/idnadata.py
new file mode 100644
index 0000000000..a284e4c84a
--- /dev/null
+++ b/openpype/vendor/python/python_2/idna/idnadata.py
@@ -0,0 +1,2050 @@
+# This file is automatically generated by tools/idna-data
+
+__version__ = "13.0.0"
+scripts = {
+    'Greek': (
+        0x37000000374,
+        0x37500000378,
+        0x37a0000037e,
+        0x37f00000380,
+        0x38400000385,
+        0x38600000387,
+        0x3880000038b,
+        0x38c0000038d,
+        0x38e000003a2,
+        0x3a3000003e2,
+        0x3f000000400,
+        0x1d2600001d2b,
+        0x1d5d00001d62,
+        0x1d6600001d6b,
+        0x1dbf00001dc0,
+        0x1f0000001f16,
+        0x1f1800001f1e,
+        0x1f2000001f46,
+        0x1f4800001f4e,
+        0x1f5000001f58,
+        0x1f5900001f5a,
+        0x1f5b00001f5c,
+        0x1f5d00001f5e,
+        0x1f5f00001f7e,
+        0x1f8000001fb5,
+        0x1fb600001fc5,
+        0x1fc600001fd4,
+        0x1fd600001fdc,
+        0x1fdd00001ff0,
+        0x1ff200001ff5,
+        0x1ff600001fff,
+        0x212600002127,
+        0xab650000ab66,
+        0x101400001018f,
+        0x101a0000101a1,
+        0x1d2000001d246,
+    ),
+    'Han': (
+        0x2e8000002e9a,
+        0x2e9b00002ef4,
+        0x2f0000002fd6,
+        0x300500003006,
+        0x300700003008,
+        0x30210000302a,
+        0x30380000303c,
+        0x340000004dc0,
+        0x4e0000009ffd,
+        0xf9000000fa6e,
+        0xfa700000fada,
+        0x16ff000016ff2,
+        0x200000002a6de,
+        0x2a7000002b735,
+        0x2b7400002b81e,
+        0x2b8200002cea2,
+        0x2ceb00002ebe1,
+        0x2f8000002fa1e,
+        0x300000003134b,
+    ),
+    'Hebrew': (
+        0x591000005c8,
+        0x5d0000005eb,
+        0x5ef000005f5,
+        0xfb1d0000fb37,
+        0xfb380000fb3d,
+        0xfb3e0000fb3f,
+        0xfb400000fb42,
+        0xfb430000fb45,
+        0xfb460000fb50,
+    ),
+    'Hiragana': (
+        0x304100003097,
+        0x309d000030a0,
+        0x1b0010001b11f,
+        0x1b1500001b153,
+        0x1f2000001f201,
+    ),
+    'Katakana': (
+        0x30a1000030fb,
+        0x30fd00003100,
+        0x31f000003200,
+        0x32d0000032ff,
+        0x330000003358,
+        0xff660000ff70,
+        0xff710000ff9e,
+        0x1b0000001b001,
+        0x1b1640001b168,
+    ),
+}
+joining_types = {
+    0x600: 85,
+    0x601: 85,
+    0x602: 85,
+    0x603: 85,
+    0x604: 85,
+    0x605: 85,
+    0x608: 85,
+    0x60b: 85,
+    0x620: 68,
+    0x621: 85,
+    0x622: 82,
+    0x623: 82,
+    0x624: 82,
+    0x625: 82,
+    0x626: 68,
+    0x627: 82,
+    0x628: 68,
+    0x629: 82,
+    0x62a: 68,
+    0x62b: 68,
+    0x62c: 68,
+    0x62d: 68,
+    0x62e: 68,
+    0x62f: 82,
+    0x630: 82,
+    0x631: 82,
+    0x632: 82,
+    0x633: 68,
+    0x634: 68,
+    0x635: 68,
+    0x636: 68,
+    0x637: 68,
+    0x638: 68,
+    0x639: 68,
+    0x63a: 68,
+    0x63b: 68,
+    0x63c: 68,
+    0x63d: 68,
+    0x63e: 68,
+    0x63f: 68,
+    0x640: 67,
+    0x641: 68,
+    0x642: 68,
+    0x643: 68,
+    0x644: 68,
+    0x645: 68,
+    0x646: 68,
+    0x647: 68,
+    0x648: 82,
+    0x649: 68,
+    0x64a: 68,
+    0x66e: 68,
+    0x66f: 68,
+    0x671: 82,
+    0x672: 82,
+    0x673: 82,
+    0x674: 85,
+    0x675: 82,
+    0x676: 82,
+    0x677: 82,
+    0x678: 68,
+    0x679: 68,
+    0x67a: 68,
+    0x67b: 68,
+    0x67c: 68,
+    0x67d: 68,
+    0x67e: 68,
+    0x67f: 68,
+    0x680: 68,
+    0x681: 68,
+    0x682: 68,
+    0x683: 68,
+    0x684: 68,
+    0x685: 68,
+    0x686: 68,
+    0x687: 68,
+    0x688: 82,
+    0x689: 82,
+    0x68a: 82,
+    0x68b: 82,
+    0x68c: 82,
+    0x68d: 82,
+    0x68e: 82,
+    0x68f: 82,
+    0x690: 82,
+    0x691: 82,
+    0x692: 82,
+    0x693: 82,
+    0x694: 82,
+    0x695: 82,
+    0x696: 82,
+    0x697: 82,
+    0x698: 82,
+    0x699: 82,
+    0x69a: 68,
+    0x69b: 68,
+    0x69c: 68,
+    0x69d: 68,
+    0x69e: 68,
+    0x69f: 68,
+    0x6a0: 68,
+    0x6a1: 68,
+    0x6a2: 68,
+    0x6a3: 68,
+    0x6a4: 68,
+    0x6a5: 68,
+    0x6a6: 68,
+    0x6a7: 68,
+    0x6a8: 68,
+    0x6a9: 68,
+    0x6aa: 68,
+    0x6ab: 68,
+    0x6ac: 68,
+    0x6ad: 68,
+    0x6ae: 68,
+    0x6af: 68,
+    0x6b0: 68,
+    0x6b1: 68,
+    0x6b2: 68,
+    0x6b3: 68,
+    0x6b4: 68,
+    0x6b5: 68,
+    0x6b6: 68,
+    0x6b7: 68,
+    0x6b8: 68,
+    0x6b9: 68,
+    0x6ba: 68,
+    0x6bb: 68,
+    0x6bc: 68,
+    0x6bd: 68,
+    0x6be: 68,
+    0x6bf: 68,
+    0x6c0: 82,
+    0x6c1: 68,
+    0x6c2: 68,
+    0x6c3: 82,
+    0x6c4: 82,
+    0x6c5: 82,
+    0x6c6: 82,
+    0x6c7: 82,
+    0x6c8: 82,
+    0x6c9: 82,
+    0x6ca: 82,
+    0x6cb: 82,
+    0x6cc: 68,
+    0x6cd: 82,
+    0x6ce: 68,
+    0x6cf: 82,
+    0x6d0: 68,
+    0x6d1: 68,
+    0x6d2: 82,
+    0x6d3: 82,
+    0x6d5: 82,
+    0x6dd: 85,
+    0x6ee: 82,
+    0x6ef: 82,
+    0x6fa: 68,
+    0x6fb: 68,
+    0x6fc: 68,
+    0x6ff: 68,
+    0x70f: 84,
+    0x710: 82,
+    0x712: 68,
+    0x713: 68,
+    0x714: 68,
+    0x715: 82,
+    0x716: 82,
+    0x717: 82,
+    0x718: 82,
+    0x719: 82,
+    0x71a: 68,
+    0x71b: 68,
+    0x71c: 68,
+    0x71d: 68,
+    0x71e: 82,
+    0x71f: 68,
+    0x720: 68,
+    0x721: 68,
+    0x722: 68,
+    0x723: 68,
+    0x724: 68,
+    0x725: 68,
+    0x726: 68,
+    0x727: 68,
+    0x728: 82,
+    0x729: 68,
+    0x72a: 82,
+    0x72b: 68,
+    0x72c: 82,
+    0x72d: 68,
+    0x72e: 68,
+    0x72f: 82,
+    0x74d: 82,
+    0x74e: 68,
+    0x74f: 68,
+    0x750: 68,
+    0x751: 68,
+    0x752: 68,
+    0x753: 68,
+    0x754: 68,
+    0x755: 68,
+    0x756: 68,
+    0x757: 68,
+    0x758: 68,
+    0x759: 82,
+    0x75a: 82,
+    0x75b: 82,
+    0x75c: 68,
+    0x75d: 68,
+    0x75e: 68,
+    0x75f: 68,
+    0x760: 68,
+    0x761: 68,
+    0x762: 68,
+    0x763: 68,
+    0x764: 68,
+    0x765: 68,
+    0x766: 68,
+    0x767: 68,
+    0x768: 68,
+    0x769: 68,
+    0x76a: 68,
+    0x76b: 82,
+    0x76c: 82,
+    0x76d: 68,
+    0x76e: 68,
+    0x76f: 68,
+    0x770: 68,
+    0x771: 82,
+    0x772: 68,
+    0x773: 82,
+    0x774: 82,
+    0x775: 68,
+    0x776: 68,
+    0x777: 68,
+    0x778: 82,
+    0x779: 82,
+    0x77a: 68,
+    0x77b: 68,
+    0x77c: 68,
+    0x77d: 68,
+    0x77e: 68,
+    0x77f: 68,
+    0x7ca: 68,
+    0x7cb: 68,
+    0x7cc: 68,
+    0x7cd: 68,
+    0x7ce: 68,
+    0x7cf: 68,
+    0x7d0: 68,
+    0x7d1: 68,
+    0x7d2: 68,
+    0x7d3: 68,
+    0x7d4: 68,
+    0x7d5: 68,
+    0x7d6: 68,
+    0x7d7: 68,
+    0x7d8: 68,
+    0x7d9: 68,
+    0x7da: 68,
+    0x7db: 68,
+    0x7dc: 68,
+    0x7dd: 68,
+    0x7de: 68,
+    0x7df: 68,
+    0x7e0: 68,
+    0x7e1: 68,
+    0x7e2: 68,
+    0x7e3: 68,
+    0x7e4: 68,
+    0x7e5: 68,
+    0x7e6: 68,
+    0x7e7: 68,
+    0x7e8: 68,
+    0x7e9: 68,
+    0x7ea: 68,
+    0x7fa: 67,
+    0x840: 82,
+    0x841: 68,
+    0x842: 68,
+    0x843: 68,
+    0x844: 68,
+    0x845: 68,
+    0x846: 82,
+    0x847: 82,
+    0x848: 68,
+    0x849: 82,
+    0x84a: 68,
+    0x84b: 68,
+    0x84c: 68,
+    0x84d: 68,
+    0x84e: 68,
+    0x84f: 68,
+    0x850: 68,
+    0x851: 68,
+    0x852: 68,
+    0x853: 68,
+    0x854: 82,
+    0x855: 68,
+    0x856: 82,
+    0x857: 82,
+    0x858: 82,
+    0x860: 68,
+    0x861: 85,
+    0x862: 68,
+    0x863: 68,
+    0x864: 68,
+    0x865: 68,
+    0x866: 85,
+    0x867: 82,
+    0x868: 68,
+    0x869: 82,
+    0x86a: 82,
+    0x8a0: 68,
+    0x8a1: 68,
+    0x8a2: 68,
+    0x8a3: 68,
+    0x8a4: 68,
+    0x8a5: 68,
+    0x8a6: 68,
+    0x8a7: 68,
+    0x8a8: 68,
+    0x8a9: 68,
+    0x8aa: 82,
+    0x8ab: 82,
+    0x8ac: 82,
+    0x8ad: 85,
+    0x8ae: 82,
+    0x8af: 68,
+    0x8b0: 68,
+    0x8b1: 82,
+    0x8b2: 82,
+    0x8b3: 68,
+    0x8b4: 68,
+    0x8b6: 68,
+    0x8b7: 68,
+    0x8b8: 68,
+    0x8b9: 82,
+    0x8ba: 68,
+    0x8bb: 68,
+    0x8bc: 68,
+    0x8bd: 68,
+    0x8be: 68,
+    0x8bf: 68,
+    0x8c0: 68,
+    0x8c1: 68,
+    0x8c2: 68,
+    0x8c3: 68,
+    0x8c4: 68,
+    0x8c5: 68,
+    0x8c6: 68,
+    0x8c7: 68,
+    0x8e2: 85,
+    0x1806: 85,
+    0x1807: 68,
+    0x180a: 67,
+    0x180e: 85,
+    0x1820: 68,
+    0x1821: 68,
+    0x1822: 68,
+    0x1823: 68,
+    0x1824: 68,
+    0x1825: 68,
+    0x1826: 68,
+    0x1827: 68,
+    0x1828: 68,
+    0x1829: 68,
+    0x182a: 68,
+    0x182b: 68,
+    0x182c: 68,
+    0x182d: 68,
+    0x182e: 68,
+    0x182f: 68,
+    0x1830: 68,
+    0x1831: 68,
+    0x1832: 68,
+    0x1833: 68,
+    0x1834: 68,
+    0x1835: 68,
+    0x1836: 68,
+    0x1837: 68,
+    0x1838: 68,
+    0x1839: 68,
+    0x183a: 68,
+    0x183b: 68,
+    0x183c: 68,
+    0x183d: 68,
+    0x183e: 68,
+    0x183f: 68,
+    0x1840: 68,
+    0x1841: 68,
+    0x1842: 68,
+    0x1843: 68,
+    0x1844: 68,
+    0x1845: 68,
+    0x1846: 68,
+    0x1847: 68,
+    0x1848: 68,
+    0x1849: 68,
+    0x184a: 68,
+    0x184b: 68,
+    0x184c: 68,
+    0x184d: 68,
+    0x184e: 68,
+    0x184f: 68,
+    0x1850: 68,
+    0x1851: 68,
+    0x1852: 68,
+    0x1853: 68,
+    0x1854: 68,
+    0x1855: 68,
+    0x1856: 68,
+    0x1857: 68,
+    0x1858: 68,
+    0x1859: 68,
+    0x185a: 68,
+    0x185b: 68,
+    0x185c: 68,
+    0x185d: 68,
+    0x185e: 68,
+    0x185f: 68,
+    0x1860: 68,
+    0x1861: 68,
+    0x1862: 68,
+    0x1863: 68,
+    0x1864: 68,
+    0x1865: 68,
+    0x1866: 68,
+    0x1867: 68,
+    0x1868: 68,
+    0x1869: 68,
+    0x186a: 68,
+    0x186b: 68,
+    0x186c: 68,
+    0x186d: 68,
+    0x186e: 68,
+    0x186f: 68,
+    0x1870: 68,
+    0x1871: 68,
+    0x1872: 68,
+    0x1873: 68,
+    0x1874: 68,
+    0x1875: 68,
+    0x1876: 68,
+    0x1877: 68,
+    0x1878: 68,
+    0x1880: 85,
+    0x1881: 85,
+    0x1882: 85,
+    0x1883: 85,
+    0x1884: 85,
+    0x1885: 84,
+    0x1886: 84,
+    0x1887: 68,
+    0x1888: 68,
+    0x1889: 68,
+    0x188a: 68,
+    0x188b: 68,
+    0x188c: 68,
+    0x188d: 68,
+    0x188e: 68,
+    0x188f: 68,
+    0x1890: 68,
+    0x1891: 68,
+    0x1892: 68,
+    0x1893: 68,
+    0x1894: 68,
+    0x1895: 68,
+    0x1896: 68,
+    0x1897: 68,
+    0x1898: 68,
+    0x1899: 68,
+    0x189a: 68,
+    0x189b: 68,
+    0x189c: 68,
+    0x189d: 68,
+    0x189e: 68,
+    0x189f: 68,
+    0x18a0: 68,
+    0x18a1: 68,
+    0x18a2: 68,
+    0x18a3: 68,
+    0x18a4: 68,
+    0x18a5: 68,
+    0x18a6: 68,
+    0x18a7: 68,
+    0x18a8: 68,
+    0x18aa: 68,
+    0x200c: 85,
+    0x200d: 67,
+    0x202f: 85,
+    0x2066: 85,
+    0x2067: 85,
+    0x2068: 85,
+    0x2069: 85,
+    0xa840: 68,
+    0xa841: 68,
+    0xa842: 68,
+    0xa843: 68,
+    0xa844: 68,
+    0xa845: 68,
+    0xa846: 68,
+    0xa847: 68,
+    0xa848: 68,
+    0xa849: 68,
+    0xa84a: 68,
+    0xa84b: 68,
+    0xa84c: 68,
+    0xa84d: 68,
+    0xa84e: 68,
+    0xa84f: 68,
+    0xa850: 68,
+    0xa851: 68,
+    0xa852: 68,
+    0xa853: 68,
+    0xa854: 68,
+    0xa855: 68,
+    0xa856: 68,
+    0xa857: 68,
+    0xa858: 68,
+    0xa859: 68,
+    0xa85a: 68,
+    0xa85b: 68,
+    0xa85c: 68,
+    0xa85d: 68,
+    0xa85e: 68,
+    0xa85f: 68,
+    0xa860: 68,
+    0xa861: 68,
+    0xa862: 68,
+    0xa863: 68,
+    0xa864: 68,
+    0xa865: 68,
+    0xa866: 68,
+    0xa867: 68,
+    0xa868: 68,
+    0xa869: 68,
+    0xa86a: 68,
+    0xa86b: 68,
+    0xa86c: 68,
+    0xa86d: 68,
+    0xa86e: 68,
+    0xa86f: 68,
+    0xa870: 68,
+    0xa871: 68,
+    0xa872: 76,
+    0xa873: 85,
+    0x10ac0: 68,
+    0x10ac1: 68,
+    0x10ac2: 68,
+    0x10ac3: 68,
+    0x10ac4: 68,
+    0x10ac5: 82,
+    0x10ac6: 85,
+    0x10ac7: 82,
+    0x10ac8: 85,
+    0x10ac9: 82,
+    0x10aca: 82,
+    0x10acb: 85,
+    0x10acc: 85,
+    0x10acd: 76,
+    0x10ace: 82,
+    0x10acf: 82,
+    0x10ad0: 82,
+    0x10ad1: 82,
+    0x10ad2: 82,
+    0x10ad3: 68,
+    0x10ad4: 68,
+    0x10ad5: 68,
+    0x10ad6: 68,
+    0x10ad7: 76,
+    0x10ad8: 68,
+    0x10ad9: 68,
+    0x10ada: 68,
+    0x10adb: 68,
+    0x10adc: 68,
+    0x10add: 82,
+    0x10ade: 68,
+    0x10adf: 68,
+    0x10ae0: 68,
+    0x10ae1: 82,
+    0x10ae2: 85,
+    0x10ae3: 85,
+    0x10ae4: 82,
+    0x10aeb: 68,
+    0x10aec: 68,
+    0x10aed: 68,
+    0x10aee: 68,
+    0x10aef: 82,
+    0x10b80: 68,
+    0x10b81: 82,
+    0x10b82: 68,
+    0x10b83: 82,
+    0x10b84: 82,
+    0x10b85: 82,
+    0x10b86: 68,
+    0x10b87: 68,
+    0x10b88: 68,
+    0x10b89: 82,
+    0x10b8a: 68,
+    0x10b8b: 68,
+    0x10b8c: 82,
+    0x10b8d: 68,
+    0x10b8e: 82,
+    0x10b8f: 82,
+    0x10b90: 68,
+    0x10b91: 82,
+    0x10ba9: 82,
+    0x10baa: 82,
+    0x10bab: 82,
+    0x10bac: 82,
+    0x10bad: 68,
+    0x10bae: 68,
+    0x10baf: 85,
+    0x10d00: 76,
+    0x10d01: 68,
+    0x10d02: 68,
+    0x10d03: 68,
+    0x10d04: 68,
+    0x10d05: 68,
+    0x10d06: 68,
+    0x10d07: 68,
+    0x10d08: 68,
+    0x10d09: 68,
+    0x10d0a: 68,
+    0x10d0b: 68,
+    0x10d0c: 68,
+    0x10d0d: 68,
+    0x10d0e: 68,
+    0x10d0f: 68,
+    0x10d10: 68,
+    0x10d11: 68,
+    0x10d12: 68,
+    0x10d13: 68,
+    0x10d14: 68,
+    0x10d15: 68,
+    0x10d16: 68,
+    0x10d17: 68,
+    0x10d18: 68,
+    0x10d19: 68,
+    0x10d1a: 68,
+    0x10d1b: 68,
+    0x10d1c: 68,
+    0x10d1d: 68,
+    0x10d1e: 68,
+    0x10d1f: 68,
+    0x10d20: 68,
+    0x10d21: 68,
+    0x10d22: 82,
+    0x10d23: 68,
+    0x10f30: 68,
+    0x10f31: 68,
+    0x10f32: 68,
+    0x10f33: 82,
+    0x10f34: 68,
+    0x10f35: 68,
+    0x10f36: 68,
+    0x10f37: 68,
+    0x10f38: 68,
+    0x10f39: 68,
+    0x10f3a: 68,
+    0x10f3b: 68,
+    0x10f3c: 68,
+    0x10f3d: 68,
+    0x10f3e: 68,
+    0x10f3f: 68,
+    0x10f40: 68,
+    0x10f41: 68,
+    0x10f42: 68,
+    0x10f43: 68,
+    0x10f44: 68,
+    0x10f45: 85,
+    0x10f51: 68,
+    0x10f52: 68,
+    0x10f53: 68,
+    0x10f54: 82,
+    0x10fb0: 68,
+    0x10fb1: 85,
+    0x10fb2: 68,
+    0x10fb3: 68,
+    0x10fb4: 82,
+    0x10fb5: 82,
+    0x10fb6: 82,
+    0x10fb7: 85,
+    0x10fb8: 68,
+    0x10fb9: 82,
+    0x10fba: 82,
+    0x10fbb: 68,
+    0x10fbc: 68,
+    0x10fbd: 82,
+    0x10fbe: 68,
+    0x10fbf: 68,
+    0x10fc0: 85,
+    0x10fc1: 68,
+    0x10fc2: 82,
+    0x10fc3: 82,
+    0x10fc4: 68,
+    0x10fc5: 85,
+    0x10fc6: 85,
+    0x10fc7: 85,
+    0x10fc8: 85,
+    0x10fc9: 82,
+    0x10fca: 68,
+    0x10fcb: 76,
+    0x110bd: 85,
+    0x110cd: 85,
+    0x1e900: 68,
+    0x1e901: 68,
+    0x1e902: 68,
+    0x1e903: 68,
+    0x1e904: 68,
+    0x1e905: 68,
+    0x1e906: 68,
+    0x1e907: 68,
+    0x1e908: 68,
+    0x1e909: 68,
+    0x1e90a: 68,
+    0x1e90b: 68,
+    0x1e90c: 68,
+    0x1e90d: 68,
+    0x1e90e: 68,
+    0x1e90f: 68,
+    0x1e910: 68,
+    0x1e911: 68,
+    0x1e912: 68,
+    0x1e913: 68,
+    0x1e914: 68,
+    0x1e915: 68,
+    0x1e916: 68,
+    0x1e917: 68,
+    0x1e918: 68,
+    0x1e919: 68,
+    0x1e91a: 68,
+    0x1e91b: 68,
+    0x1e91c: 68,
+    0x1e91d: 68,
+    0x1e91e: 68,
+    0x1e91f: 68,
+    0x1e920: 68,
+    0x1e921: 68,
+    0x1e922: 68,
+    0x1e923: 68,
+    0x1e924: 68,
+    0x1e925: 68,
+    0x1e926: 68,
+    0x1e927: 68,
+    0x1e928: 68,
+    0x1e929: 68,
+    0x1e92a: 68,
+    0x1e92b: 68,
+    0x1e92c: 68,
+    0x1e92d: 68,
+    0x1e92e: 68,
+    0x1e92f: 68,
+    0x1e930: 68,
+    0x1e931: 68,
+    0x1e932: 68,
+    0x1e933: 68,
+    0x1e934: 68,
+    0x1e935: 68,
+    0x1e936: 68,
+    0x1e937: 68,
+    0x1e938: 68,
+    0x1e939: 68,
+    0x1e93a: 68,
+    0x1e93b: 68,
+    0x1e93c: 68,
+    0x1e93d: 68,
+    0x1e93e: 68,
+    0x1e93f: 68,
+    0x1e940: 68,
+    0x1e941: 68,
+    0x1e942: 68,
+    0x1e943: 68,
+    0x1e94b: 84,
+}
+codepoint_classes = {
+    'PVALID': (
+        0x2d0000002e,
+        0x300000003a,
+        0x610000007b,
+        0xdf000000f7,
+        0xf800000100,
+        0x10100000102,
+        0x10300000104,
+        0x10500000106,
+        0x10700000108,
+        0x1090000010a,
+        0x10b0000010c,
+        0x10d0000010e,
+        0x10f00000110,
+        0x11100000112,
+        0x11300000114,
+        0x11500000116,
+        0x11700000118,
+        0x1190000011a,
+        0x11b0000011c,
+        0x11d0000011e,
+        0x11f00000120,
+        0x12100000122,
+        0x12300000124,
+        0x12500000126,
+        0x12700000128,
+        0x1290000012a,
+        0x12b0000012c,
+        0x12d0000012e,
+        0x12f00000130,
+        0x13100000132,
+        0x13500000136,
+        0x13700000139,
+        0x13a0000013b,
+        0x13c0000013d,
+        0x13e0000013f,
+        0x14200000143,
+        0x14400000145,
+        0x14600000147,
+        0x14800000149,
+        0x14b0000014c,
+        0x14d0000014e,
+        0x14f00000150,
+        0x15100000152,
+        0x15300000154,
+        0x15500000156,
+        0x15700000158,
+        0x1590000015a,
+        0x15b0000015c,
+        0x15d0000015e,
+        0x15f00000160,
+        0x16100000162,
+        0x16300000164,
+        0x16500000166,
+        0x16700000168,
+        0x1690000016a,
+        0x16b0000016c,
+        0x16d0000016e,
+        0x16f00000170,
+        0x17100000172,
+        0x17300000174,
+        0x17500000176,
+        0x17700000178,
+        0x17a0000017b,
+        0x17c0000017d,
+        0x17e0000017f,
+        0x18000000181,
+        0x18300000184,
+        0x18500000186,
+        0x18800000189,
+        0x18c0000018e,
+        0x19200000193,
+        0x19500000196,
+        0x1990000019c,
+        0x19e0000019f,
+        0x1a1000001a2,
+        0x1a3000001a4,
+        0x1a5000001a6,
+        0x1a8000001a9,
+        0x1aa000001ac,
+        0x1ad000001ae,
+        0x1b0000001b1,
+        0x1b4000001b5,
+        0x1b6000001b7,
+        0x1b9000001bc,
+        0x1bd000001c4,
+        0x1ce000001cf,
+        0x1d0000001d1,
+        0x1d2000001d3,
+        0x1d4000001d5,
+        0x1d6000001d7,
+        0x1d8000001d9,
+        0x1da000001db,
+        0x1dc000001de,
+        0x1df000001e0,
+        0x1e1000001e2,
+        0x1e3000001e4,
+        0x1e5000001e6,
+        0x1e7000001e8,
+        0x1e9000001ea,
+        0x1eb000001ec,
+        0x1ed000001ee,
+        0x1ef000001f1,
+        0x1f5000001f6,
+        0x1f9000001fa,
+        0x1fb000001fc,
+        0x1fd000001fe,
+        0x1ff00000200,
+        0x20100000202,
+        0x20300000204,
+        0x20500000206,
+        0x20700000208,
+        0x2090000020a,
+        0x20b0000020c,
+        0x20d0000020e,
+        0x20f00000210,
+        0x21100000212,
+        0x21300000214,
+        0x21500000216,
+        0x21700000218,
+        0x2190000021a,
+        0x21b0000021c,
+        0x21d0000021e,
+        0x21f00000220,
+        0x22100000222,
+        0x22300000224,
+        0x22500000226,
+        0x22700000228,
+        0x2290000022a,
+        0x22b0000022c,
+        0x22d0000022e,
+        0x22f00000230,
+        0x23100000232,
+        0x2330000023a,
+        0x23c0000023d,
+        0x23f00000241,
+        0x24200000243,
+        0x24700000248,
+        0x2490000024a,
+        0x24b0000024c,
+        0x24d0000024e,
+        0x24f000002b0,
+        0x2b9000002c2,
+        0x2c6000002d2,
+        0x2ec000002ed,
+        0x2ee000002ef,
+        0x30000000340,
+        0x34200000343,
+        0x3460000034f,
+        0x35000000370,
+        0x37100000372,
+        0x37300000374,
+        0x37700000378,
+        0x37b0000037e,
+        0x39000000391,
+        0x3ac000003cf,
+        0x3d7000003d8,
+        0x3d9000003da,
+        0x3db000003dc,
+        0x3dd000003de,
+        0x3df000003e0,
+        0x3e1000003e2,
+        0x3e3000003e4,
+        0x3e5000003e6,
+        0x3e7000003e8,
+        0x3e9000003ea,
+        0x3eb000003ec,
+        0x3ed000003ee,
+        0x3ef000003f0,
+        0x3f3000003f4,
+        0x3f8000003f9,
+        0x3fb000003fd,
+        0x43000000460,
+        0x46100000462,
+        0x46300000464,
+        0x46500000466,
+        0x46700000468,
+        0x4690000046a,
+        0x46b0000046c,
+        0x46d0000046e,
+        0x46f00000470,
+        0x47100000472,
+        0x47300000474,
+        0x47500000476,
+        0x47700000478,
+        0x4790000047a,
+        0x47b0000047c,
+        0x47d0000047e,
+        0x47f00000480,
+        0x48100000482,
+        0x48300000488,
+        0x48b0000048c,
+        0x48d0000048e,
+        0x48f00000490,
+        0x49100000492,
+        0x49300000494,
+        0x49500000496,
+        0x49700000498,
+        0x4990000049a,
+        0x49b0000049c,
+        0x49d0000049e,
+        0x49f000004a0,
+        0x4a1000004a2,
+        0x4a3000004a4,
+        0x4a5000004a6,
+        0x4a7000004a8,
+        0x4a9000004aa,
+        0x4ab000004ac,
+        0x4ad000004ae,
+        0x4af000004b0,
+        0x4b1000004b2,
+        0x4b3000004b4,
+        0x4b5000004b6,
+        0x4b7000004b8,
+        0x4b9000004ba,
+        0x4bb000004bc,
+        0x4bd000004be,
+        0x4bf000004c0,
+        0x4c2000004c3,
+        0x4c4000004c5,
+        0x4c6000004c7,
+        0x4c8000004c9,
+        0x4ca000004cb,
+        0x4cc000004cd,
+        0x4ce000004d0,
+        0x4d1000004d2,
+        0x4d3000004d4,
+        0x4d5000004d6,
+        0x4d7000004d8,
+        0x4d9000004da,
+        0x4db000004dc,
+        0x4dd000004de,
+        0x4df000004e0,
+        0x4e1000004e2,
+        0x4e3000004e4,
+        0x4e5000004e6,
+        0x4e7000004e8,
+        0x4e9000004ea,
+        0x4eb000004ec,
+        0x4ed000004ee,
+        0x4ef000004f0,
+        0x4f1000004f2,
+        0x4f3000004f4,
+        0x4f5000004f6,
+        0x4f7000004f8,
+        0x4f9000004fa,
+        0x4fb000004fc,
+        0x4fd000004fe,
+        0x4ff00000500,
+        0x50100000502,
+        0x50300000504,
+        0x50500000506,
+        0x50700000508,
+        0x5090000050a,
+        0x50b0000050c,
+        0x50d0000050e,
+        0x50f00000510,
+        0x51100000512,
+        0x51300000514,
+        0x51500000516,
+        0x51700000518,
+        0x5190000051a,
+        0x51b0000051c,
+        0x51d0000051e,
+        0x51f00000520,
+        0x52100000522,
+        0x52300000524,
+        0x52500000526,
+        0x52700000528,
+        0x5290000052a,
+        0x52b0000052c,
+        0x52d0000052e,
+        0x52f00000530,
+        0x5590000055a,
+        0x56000000587,
+        0x58800000589,
+        0x591000005be,
+        0x5bf000005c0,
+        0x5c1000005c3,
+        0x5c4000005c6,
+        0x5c7000005c8,
+        0x5d0000005eb,
+        0x5ef000005f3,
+        0x6100000061b,
+        0x62000000640,
+        0x64100000660,
+        0x66e00000675,
+        0x679000006d4,
+        0x6d5000006dd,
+        0x6df000006e9,
+        0x6ea000006f0,
+        0x6fa00000700,
+        0x7100000074b,
+        0x74d000007b2,
+        0x7c0000007f6,
+        0x7fd000007fe,
+        0x8000000082e,
+        0x8400000085c,
+        0x8600000086b,
+        0x8a0000008b5,
+        0x8b6000008c8,
+        0x8d3000008e2,
+        0x8e300000958,
+        0x96000000964,
+        0x96600000970,
+        0x97100000984,
+        0x9850000098d,
+        0x98f00000991,
+        0x993000009a9,
+        0x9aa000009b1,
+        0x9b2000009b3,
+        0x9b6000009ba,
+        0x9bc000009c5,
+        0x9c7000009c9,
+        0x9cb000009cf,
+        0x9d7000009d8,
+        0x9e0000009e4,
+        0x9e6000009f2,
+        0x9fc000009fd,
+        0x9fe000009ff,
+        0xa0100000a04,
+        0xa0500000a0b,
+        0xa0f00000a11,
+        0xa1300000a29,
+        0xa2a00000a31,
+        0xa3200000a33,
+        0xa3500000a36,
+        0xa3800000a3a,
+        0xa3c00000a3d,
+        0xa3e00000a43,
+        0xa4700000a49,
+        0xa4b00000a4e,
+        0xa5100000a52,
+        0xa5c00000a5d,
+        0xa6600000a76,
+        0xa8100000a84,
+        0xa8500000a8e,
+        0xa8f00000a92,
+        0xa9300000aa9,
+        0xaaa00000ab1,
+        0xab200000ab4,
+        0xab500000aba,
+        0xabc00000ac6,
+        0xac700000aca,
+        0xacb00000ace,
+        0xad000000ad1,
+        0xae000000ae4,
+        0xae600000af0,
+        0xaf900000b00,
+        0xb0100000b04,
+        0xb0500000b0d,
+        0xb0f00000b11,
+        0xb1300000b29,
+        0xb2a00000b31,
+        0xb3200000b34,
+        0xb3500000b3a,
+        0xb3c00000b45,
+        0xb4700000b49,
+        0xb4b00000b4e,
+        0xb5500000b58,
+        0xb5f00000b64,
+        0xb6600000b70,
+        0xb7100000b72,
+        0xb8200000b84,
+        0xb8500000b8b,
+        0xb8e00000b91,
+        0xb9200000b96,
+        0xb9900000b9b,
+        0xb9c00000b9d,
+        0xb9e00000ba0,
+        0xba300000ba5,
+        0xba800000bab,
+        0xbae00000bba,
+        0xbbe00000bc3,
+        0xbc600000bc9,
+        0xbca00000bce,
+        0xbd000000bd1,
+        0xbd700000bd8,
+        0xbe600000bf0,
+        0xc0000000c0d,
+        0xc0e00000c11,
+        0xc1200000c29,
+        0xc2a00000c3a,
+        0xc3d00000c45,
+        0xc4600000c49,
+        0xc4a00000c4e,
+        0xc5500000c57,
+        0xc5800000c5b,
+        0xc6000000c64,
+        0xc6600000c70,
+        0xc8000000c84,
+        0xc8500000c8d,
+        0xc8e00000c91,
+        0xc9200000ca9,
+        0xcaa00000cb4,
+        0xcb500000cba,
+        0xcbc00000cc5,
+        0xcc600000cc9,
+        0xcca00000cce,
+        0xcd500000cd7,
+        0xcde00000cdf,
+        0xce000000ce4,
+        0xce600000cf0,
+        0xcf100000cf3,
+        0xd0000000d0d,
+        0xd0e00000d11,
+        0xd1200000d45,
+        0xd4600000d49,
+        0xd4a00000d4f,
+        0xd5400000d58,
+        0xd5f00000d64,
+        0xd6600000d70,
+        0xd7a00000d80,
+        0xd8100000d84,
+        0xd8500000d97,
+        0xd9a00000db2,
+        0xdb300000dbc,
+        0xdbd00000dbe,
+        0xdc000000dc7,
+        0xdca00000dcb,
+        0xdcf00000dd5,
+        0xdd600000dd7,
+        0xdd800000de0,
+        0xde600000df0,
+        0xdf200000df4,
+        0xe0100000e33,
+        0xe3400000e3b,
+        0xe4000000e4f,
+        0xe5000000e5a,
+        0xe8100000e83,
+        0xe8400000e85,
+        0xe8600000e8b,
+        0xe8c00000ea4,
+        0xea500000ea6,
+        0xea700000eb3,
+        0xeb400000ebe,
+        0xec000000ec5,
+        0xec600000ec7,
+        0xec800000ece,
+        0xed000000eda,
+        0xede00000ee0,
+        0xf0000000f01,
+        0xf0b00000f0c,
+        0xf1800000f1a,
+        0xf2000000f2a,
+        0xf3500000f36,
+        0xf3700000f38,
+        0xf3900000f3a,
+        0xf3e00000f43,
+        0xf4400000f48,
+        0xf4900000f4d,
+        0xf4e00000f52,
+        0xf5300000f57,
+        0xf5800000f5c,
+        0xf5d00000f69,
+        0xf6a00000f6d,
+        0xf7100000f73,
+        0xf7400000f75,
+        0xf7a00000f81,
+        0xf8200000f85,
+        0xf8600000f93,
+        0xf9400000f98,
+        0xf9900000f9d,
+        0xf9e00000fa2,
+        0xfa300000fa7,
+        0xfa800000fac,
+        0xfad00000fb9,
+        0xfba00000fbd,
+        0xfc600000fc7,
+        0x10000000104a,
+        0x10500000109e,
+        0x10d0000010fb,
+        0x10fd00001100,
+        0x120000001249,
+        0x124a0000124e,
+        0x125000001257,
+        0x125800001259,
+        0x125a0000125e,
+        0x126000001289,
+        0x128a0000128e,
+        0x1290000012b1,
+        0x12b2000012b6,
+        0x12b8000012bf,
+        0x12c0000012c1,
+        0x12c2000012c6,
+        0x12c8000012d7,
+        0x12d800001311,
+        0x131200001316,
+        0x13180000135b,
+        0x135d00001360,
+        0x138000001390,
+        0x13a0000013f6,
+        0x14010000166d,
+        0x166f00001680,
+        0x16810000169b,
+        0x16a0000016eb,
+        0x16f1000016f9,
+        0x17000000170d,
+        0x170e00001715,
+        0x172000001735,
+        0x174000001754,
+        0x17600000176d,
+        0x176e00001771,
+        0x177200001774,
+        0x1780000017b4,
+        0x17b6000017d4,
+        0x17d7000017d8,
+        0x17dc000017de,
+        0x17e0000017ea,
+        0x18100000181a,
+        0x182000001879,
+        0x1880000018ab,
+        0x18b0000018f6,
+        0x19000000191f,
+        0x19200000192c,
+        0x19300000193c,
+        0x19460000196e,
+        0x197000001975,
+        0x1980000019ac,
+        0x19b0000019ca,
+        0x19d0000019da,
+        0x1a0000001a1c,
+        0x1a2000001a5f,
+        0x1a6000001a7d,
+        0x1a7f00001a8a,
+        0x1a9000001a9a,
+        0x1aa700001aa8,
+        0x1ab000001abe,
+        0x1abf00001ac1,
+        0x1b0000001b4c,
+        0x1b5000001b5a,
+        0x1b6b00001b74,
+        0x1b8000001bf4,
+        0x1c0000001c38,
+        0x1c4000001c4a,
+        0x1c4d00001c7e,
+        0x1cd000001cd3,
+        0x1cd400001cfb,
+        0x1d0000001d2c,
+        0x1d2f00001d30,
+        0x1d3b00001d3c,
+        0x1d4e00001d4f,
+        0x1d6b00001d78,
+        0x1d7900001d9b,
+        0x1dc000001dfa,
+        0x1dfb00001e00,
+        0x1e0100001e02,
+        0x1e0300001e04,
+        0x1e0500001e06,
+        0x1e0700001e08,
+        0x1e0900001e0a,
+        0x1e0b00001e0c,
+        0x1e0d00001e0e,
+        0x1e0f00001e10,
+        0x1e1100001e12,
+        0x1e1300001e14,
+        0x1e1500001e16,
+        0x1e1700001e18,
+        0x1e1900001e1a,
+        0x1e1b00001e1c,
+        0x1e1d00001e1e,
+        0x1e1f00001e20,
+        0x1e2100001e22,
+        0x1e2300001e24,
+        0x1e2500001e26,
+        0x1e2700001e28,
+        0x1e2900001e2a,
+        0x1e2b00001e2c,
+        0x1e2d00001e2e,
+        0x1e2f00001e30,
+        0x1e3100001e32,
+        0x1e3300001e34,
+        0x1e3500001e36,
+        0x1e3700001e38,
+        0x1e3900001e3a,
+        0x1e3b00001e3c,
+        0x1e3d00001e3e,
+        0x1e3f00001e40,
+        0x1e4100001e42,
+        0x1e4300001e44,
+        0x1e4500001e46,
+        0x1e4700001e48,
+        0x1e4900001e4a,
+        0x1e4b00001e4c,
+        0x1e4d00001e4e,
+        0x1e4f00001e50,
+        0x1e5100001e52,
+        0x1e5300001e54,
+        0x1e5500001e56,
+        0x1e5700001e58,
+        0x1e5900001e5a,
+        0x1e5b00001e5c,
+        0x1e5d00001e5e,
+        0x1e5f00001e60,
+        0x1e6100001e62,
+        0x1e6300001e64,
+        0x1e6500001e66,
+        0x1e6700001e68,
+        0x1e6900001e6a,
+        0x1e6b00001e6c,
+        0x1e6d00001e6e,
+        0x1e6f00001e70,
+        0x1e7100001e72,
+        0x1e7300001e74,
+        0x1e7500001e76,
+        0x1e7700001e78,
+        0x1e7900001e7a,
+        0x1e7b00001e7c,
+        0x1e7d00001e7e,
+        0x1e7f00001e80,
+        0x1e8100001e82,
+        0x1e8300001e84,
+        0x1e8500001e86,
+        0x1e8700001e88,
+        0x1e8900001e8a,
+        0x1e8b00001e8c,
+        0x1e8d00001e8e,
+        0x1e8f00001e90,
+        0x1e9100001e92,
+        0x1e9300001e94,
+        0x1e9500001e9a,
+        0x1e9c00001e9e,
+        0x1e9f00001ea0,
+        0x1ea100001ea2,
+        0x1ea300001ea4,
+        0x1ea500001ea6,
+        0x1ea700001ea8,
+        0x1ea900001eaa,
+        0x1eab00001eac,
+        0x1ead00001eae,
+        0x1eaf00001eb0,
+        0x1eb100001eb2,
+        0x1eb300001eb4,
+        0x1eb500001eb6,
+        0x1eb700001eb8,
+        0x1eb900001eba,
+        0x1ebb00001ebc,
+        0x1ebd00001ebe,
+        0x1ebf00001ec0,
+        0x1ec100001ec2,
+        0x1ec300001ec4,
+        0x1ec500001ec6,
+        0x1ec700001ec8,
+        0x1ec900001eca,
+        0x1ecb00001ecc,
+        0x1ecd00001ece,
+        0x1ecf00001ed0,
+        0x1ed100001ed2,
+        0x1ed300001ed4,
+        0x1ed500001ed6,
+        0x1ed700001ed8,
+        0x1ed900001eda,
+        0x1edb00001edc,
+        0x1edd00001ede,
+        0x1edf00001ee0,
+        0x1ee100001ee2,
+        0x1ee300001ee4,
+        0x1ee500001ee6,
+        0x1ee700001ee8,
+        0x1ee900001eea,
+        0x1eeb00001eec,
+        0x1eed00001eee,
+        0x1eef00001ef0,
+        0x1ef100001ef2,
+        0x1ef300001ef4,
+        0x1ef500001ef6,
+        0x1ef700001ef8,
+        0x1ef900001efa,
+        0x1efb00001efc,
+        0x1efd00001efe,
+        0x1eff00001f08,
+        0x1f1000001f16,
+        0x1f2000001f28,
+        0x1f3000001f38,
+        0x1f4000001f46,
+        0x1f5000001f58,
+        0x1f6000001f68,
+        0x1f7000001f71,
+        0x1f7200001f73,
+        0x1f7400001f75,
+        0x1f7600001f77,
+        0x1f7800001f79,
+        0x1f7a00001f7b,
+        0x1f7c00001f7d,
+        0x1fb000001fb2,
+        0x1fb600001fb7,
+        0x1fc600001fc7,
+        0x1fd000001fd3,
+        0x1fd600001fd8,
+        0x1fe000001fe3,
+        0x1fe400001fe8,
+        0x1ff600001ff7,
+        0x214e0000214f,
+        0x218400002185,
+        0x2c3000002c5f,
+        0x2c6100002c62,
+        0x2c6500002c67,
+        0x2c6800002c69,
+        0x2c6a00002c6b,
+        0x2c6c00002c6d,
+        0x2c7100002c72,
+        0x2c7300002c75,
+        0x2c7600002c7c,
+        0x2c8100002c82,
+        0x2c8300002c84,
+        0x2c8500002c86,
+        0x2c8700002c88,
+        0x2c8900002c8a,
+        0x2c8b00002c8c,
+        0x2c8d00002c8e,
+        0x2c8f00002c90,
+        0x2c9100002c92,
+        0x2c9300002c94,
+        0x2c9500002c96,
+        0x2c9700002c98,
+        0x2c9900002c9a,
+        0x2c9b00002c9c,
+        0x2c9d00002c9e,
+        0x2c9f00002ca0,
+        0x2ca100002ca2,
+        0x2ca300002ca4,
+        0x2ca500002ca6,
+        0x2ca700002ca8,
+        0x2ca900002caa,
+        0x2cab00002cac,
+        0x2cad00002cae,
+        0x2caf00002cb0,
+        0x2cb100002cb2,
+        0x2cb300002cb4,
+        0x2cb500002cb6,
+        0x2cb700002cb8,
+        0x2cb900002cba,
+        0x2cbb00002cbc,
+        0x2cbd00002cbe,
+        0x2cbf00002cc0,
+        0x2cc100002cc2,
+        0x2cc300002cc4,
+        0x2cc500002cc6,
+        0x2cc700002cc8,
+        0x2cc900002cca,
+        0x2ccb00002ccc,
+        0x2ccd00002cce,
+        0x2ccf00002cd0,
+        0x2cd100002cd2,
+        0x2cd300002cd4,
+        0x2cd500002cd6,
+        0x2cd700002cd8,
+        0x2cd900002cda,
+        0x2cdb00002cdc,
+        0x2cdd00002cde,
+        0x2cdf00002ce0,
+        0x2ce100002ce2,
+        0x2ce300002ce5,
+        0x2cec00002ced,
+        0x2cee00002cf2,
+        0x2cf300002cf4,
+        0x2d0000002d26,
+        0x2d2700002d28,
+        0x2d2d00002d2e,
+        0x2d3000002d68,
+        0x2d7f00002d97,
+        0x2da000002da7,
+        0x2da800002daf,
+        0x2db000002db7,
+        0x2db800002dbf,
+        0x2dc000002dc7,
+        0x2dc800002dcf,
+        0x2dd000002dd7,
+        0x2dd800002ddf,
+        0x2de000002e00,
+        0x2e2f00002e30,
+        0x300500003008,
+        0x302a0000302e,
+        0x303c0000303d,
+        0x304100003097,
+        0x30990000309b,
+        0x309d0000309f,
+        0x30a1000030fb,
+        0x30fc000030ff,
+        0x310500003130,
+        0x31a0000031c0,
+        0x31f000003200,
+        0x340000004dc0,
+        0x4e0000009ffd,
+        0xa0000000a48d,
+        0xa4d00000a4fe,
+        0xa5000000a60d,
+        0xa6100000a62c,
+        0xa6410000a642,
+        0xa6430000a644,
+        0xa6450000a646,
+        0xa6470000a648,
+        0xa6490000a64a,
+        0xa64b0000a64c,
+        0xa64d0000a64e,
+        0xa64f0000a650,
+        0xa6510000a652,
+        0xa6530000a654,
+        0xa6550000a656,
+        0xa6570000a658,
+        0xa6590000a65a,
+        0xa65b0000a65c,
+        0xa65d0000a65e,
+        0xa65f0000a660,
+        0xa6610000a662,
+        0xa6630000a664,
+        0xa6650000a666,
+        0xa6670000a668,
+        0xa6690000a66a,
+        0xa66b0000a66c,
+        0xa66d0000a670,
+        0xa6740000a67e,
+        0xa67f0000a680,
+        0xa6810000a682,
+        0xa6830000a684,
+        0xa6850000a686,
+        0xa6870000a688,
+        0xa6890000a68a,
+        0xa68b0000a68c,
+        0xa68d0000a68e,
+        0xa68f0000a690,
+        0xa6910000a692,
+        0xa6930000a694,
+        0xa6950000a696,
+        0xa6970000a698,
+        0xa6990000a69a,
+        0xa69b0000a69c,
+        0xa69e0000a6e6,
+        0xa6f00000a6f2,
+        0xa7170000a720,
+        0xa7230000a724,
+        0xa7250000a726,
+        0xa7270000a728,
+        0xa7290000a72a,
+        0xa72b0000a72c,
+        0xa72d0000a72e,
+        0xa72f0000a732,
+        0xa7330000a734,
+        0xa7350000a736,
+        0xa7370000a738,
+        0xa7390000a73a,
+        0xa73b0000a73c,
+        0xa73d0000a73e,
+        0xa73f0000a740,
+        0xa7410000a742,
+        0xa7430000a744,
+        0xa7450000a746,
+        0xa7470000a748,
+        0xa7490000a74a,
+        0xa74b0000a74c,
+        0xa74d0000a74e,
+        0xa74f0000a750,
+        0xa7510000a752,
+        0xa7530000a754,
+        0xa7550000a756,
+        0xa7570000a758,
+        0xa7590000a75a,
+        0xa75b0000a75c,
+        0xa75d0000a75e,
+        0xa75f0000a760,
+        0xa7610000a762,
+        0xa7630000a764,
+        0xa7650000a766,
+        0xa7670000a768,
+        0xa7690000a76a,
+        0xa76b0000a76c,
+        0xa76d0000a76e,
+        0xa76f0000a770,
+        0xa7710000a779,
+        0xa77a0000a77b,
+        0xa77c0000a77d,
+        0xa77f0000a780,
+        0xa7810000a782,
+        0xa7830000a784,
+        0xa7850000a786,
+        0xa7870000a789,
+        0xa78c0000a78d,
+        0xa78e0000a790,
+        0xa7910000a792,
+        0xa7930000a796,
+        0xa7970000a798,
+        0xa7990000a79a,
+        0xa79b0000a79c,
+        0xa79d0000a79e,
+        0xa79f0000a7a0,
+        0xa7a10000a7a2,
+        0xa7a30000a7a4,
+        0xa7a50000a7a6,
+        0xa7a70000a7a8,
+        0xa7a90000a7aa,
+        0xa7af0000a7b0,
+        0xa7b50000a7b6,
+        0xa7b70000a7b8,
+        0xa7b90000a7ba,
+        0xa7bb0000a7bc,
+        0xa7bd0000a7be,
+        0xa7bf0000a7c0,
+        0xa7c30000a7c4,
+        0xa7c80000a7c9,
+        0xa7ca0000a7cb,
+        0xa7f60000a7f8,
+        0xa7fa0000a828,
+        0xa82c0000a82d,
+        0xa8400000a874,
+        0xa8800000a8c6,
+        0xa8d00000a8da,
+        0xa8e00000a8f8,
+        0xa8fb0000a8fc,
+        0xa8fd0000a92e,
+        0xa9300000a954,
+        0xa9800000a9c1,
+        0xa9cf0000a9da,
+        0xa9e00000a9ff,
+        0xaa000000aa37,
+        0xaa400000aa4e,
+        0xaa500000aa5a,
+        0xaa600000aa77,
+        0xaa7a0000aac3,
+        0xaadb0000aade,
+        0xaae00000aaf0,
+        0xaaf20000aaf7,
+        0xab010000ab07,
+        0xab090000ab0f,
+        0xab110000ab17,
+        0xab200000ab27,
+        0xab280000ab2f,
+        0xab300000ab5b,
+        0xab600000ab6a,
+        0xabc00000abeb,
+        0xabec0000abee,
+        0xabf00000abfa,
+        0xac000000d7a4,
+        0xfa0e0000fa10,
+        0xfa110000fa12,
+        0xfa130000fa15,
+        0xfa1f0000fa20,
+        0xfa210000fa22,
+        0xfa230000fa25,
+        0xfa270000fa2a,
+        0xfb1e0000fb1f,
+        0xfe200000fe30,
+        0xfe730000fe74,
+        0x100000001000c,
+        0x1000d00010027,
+        0x100280001003b,
+        0x1003c0001003e,
+        0x1003f0001004e,
+        0x100500001005e,
+        0x10080000100fb,
+        0x101fd000101fe,
+        0x102800001029d,
+        0x102a0000102d1,
+        0x102e0000102e1,
+        0x1030000010320,
+        0x1032d00010341,
+        0x103420001034a,
+        0x103500001037b,
+        0x103800001039e,
+        0x103a0000103c4,
+        0x103c8000103d0,
+        0x104280001049e,
+        0x104a0000104aa,
+        0x104d8000104fc,
+        0x1050000010528,
+        0x1053000010564,
+        0x1060000010737,
+        0x1074000010756,
+        0x1076000010768,
+        0x1080000010806,
+        0x1080800010809,
+        0x1080a00010836,
+        0x1083700010839,
+        0x1083c0001083d,
+        0x1083f00010856,
+        0x1086000010877,
+        0x108800001089f,
+        0x108e0000108f3,
+        0x108f4000108f6,
+        0x1090000010916,
+        0x109200001093a,
+        0x10980000109b8,
+        0x109be000109c0,
+        0x10a0000010a04,
+        0x10a0500010a07,
+        0x10a0c00010a14,
+        0x10a1500010a18,
+        0x10a1900010a36,
+        0x10a3800010a3b,
+        0x10a3f00010a40,
+        0x10a6000010a7d,
+        0x10a8000010a9d,
+        0x10ac000010ac8,
+        0x10ac900010ae7,
+        0x10b0000010b36,
+        0x10b4000010b56,
+        0x10b6000010b73,
+        0x10b8000010b92,
+        0x10c0000010c49,
+        0x10cc000010cf3,
+        0x10d0000010d28,
+        0x10d3000010d3a,
+        0x10e8000010eaa,
+        0x10eab00010ead,
+        0x10eb000010eb2,
+        0x10f0000010f1d,
+        0x10f2700010f28,
+        0x10f3000010f51,
+        0x10fb000010fc5,
+        0x10fe000010ff7,
+        0x1100000011047,
+        0x1106600011070,
+        0x1107f000110bb,
+        0x110d0000110e9,
+        0x110f0000110fa,
+        0x1110000011135,
+        0x1113600011140,
+        0x1114400011148,
+        0x1115000011174,
+        0x1117600011177,
+        0x11180000111c5,
+        0x111c9000111cd,
+        0x111ce000111db,
+        0x111dc000111dd,
+        0x1120000011212,
+        0x1121300011238,
+        0x1123e0001123f,
+        0x1128000011287,
+        0x1128800011289,
+        0x1128a0001128e,
+        0x1128f0001129e,
+        0x1129f000112a9,
+        0x112b0000112eb,
+        0x112f0000112fa,
+        0x1130000011304,
+        0x113050001130d,
+        0x1130f00011311,
+        0x1131300011329,
+        0x1132a00011331,
+        0x1133200011334,
+        0x113350001133a,
+        0x1133b00011345,
+        0x1134700011349,
+        0x1134b0001134e,
+        0x1135000011351,
+        0x1135700011358,
+        0x1135d00011364,
+        0x113660001136d,
+        0x1137000011375,
+        0x114000001144b,
+        0x114500001145a,
+        0x1145e00011462,
+        0x11480000114c6,
+        0x114c7000114c8,
+        0x114d0000114da,
+        0x11580000115b6,
+        0x115b8000115c1,
+        0x115d8000115de,
+        0x1160000011641,
+        0x1164400011645,
+        0x116500001165a,
+        0x11680000116b9,
+        0x116c0000116ca,
+        0x117000001171b,
+        0x1171d0001172c,
+        0x117300001173a,
+        0x118000001183b,
+        0x118c0000118ea,
+        0x118ff00011907,
+        0x119090001190a,
+        0x1190c00011914,
+        0x1191500011917,
+        0x1191800011936,
+        0x1193700011939,
+        0x1193b00011944,
+        0x119500001195a,
+        0x119a0000119a8,
+        0x119aa000119d8,
+        0x119da000119e2,
+        0x119e3000119e5,
+        0x11a0000011a3f,
+        0x11a4700011a48,
+        0x11a5000011a9a,
+        0x11a9d00011a9e,
+        0x11ac000011af9,
+        0x11c0000011c09,
+        0x11c0a00011c37,
+        0x11c3800011c41,
+        0x11c5000011c5a,
+        0x11c7200011c90,
+        0x11c9200011ca8,
+        0x11ca900011cb7,
+        0x11d0000011d07,
+        0x11d0800011d0a,
+        0x11d0b00011d37,
+        0x11d3a00011d3b,
+        0x11d3c00011d3e,
+        0x11d3f00011d48,
+        0x11d5000011d5a,
+        0x11d6000011d66,
+        0x11d6700011d69,
+        0x11d6a00011d8f,
+        0x11d9000011d92,
+        0x11d9300011d99,
+        0x11da000011daa,
+        0x11ee000011ef7,
+        0x11fb000011fb1,
+        0x120000001239a,
+        0x1248000012544,
+        0x130000001342f,
+        0x1440000014647,
+        0x1680000016a39,
+        0x16a4000016a5f,
+        0x16a6000016a6a,
+        0x16ad000016aee,
+        0x16af000016af5,
+        0x16b0000016b37,
+        0x16b4000016b44,
+        0x16b5000016b5a,
+        0x16b6300016b78,
+        0x16b7d00016b90,
+        0x16e6000016e80,
+        0x16f0000016f4b,
+        0x16f4f00016f88,
+        0x16f8f00016fa0,
+        0x16fe000016fe2,
+        0x16fe300016fe5,
+        0x16ff000016ff2,
+        0x17000000187f8,
+        0x1880000018cd6,
+        0x18d0000018d09,
+        0x1b0000001b11f,
+        0x1b1500001b153,
+        0x1b1640001b168,
+        0x1b1700001b2fc,
+        0x1bc000001bc6b,
+        0x1bc700001bc7d,
+        0x1bc800001bc89,
+        0x1bc900001bc9a,
+        0x1bc9d0001bc9f,
+        0x1da000001da37,
+        0x1da3b0001da6d,
+        0x1da750001da76,
+        0x1da840001da85,
+        0x1da9b0001daa0,
+        0x1daa10001dab0,
+        0x1e0000001e007,
+        0x1e0080001e019,
+        0x1e01b0001e022,
+        0x1e0230001e025,
+        0x1e0260001e02b,
+        0x1e1000001e12d,
+        0x1e1300001e13e,
+        0x1e1400001e14a,
+        0x1e14e0001e14f,
+        0x1e2c00001e2fa,
+        0x1e8000001e8c5,
+        0x1e8d00001e8d7,
+        0x1e9220001e94c,
+        0x1e9500001e95a,
+        0x1fbf00001fbfa,
+        0x200000002a6de,
+        0x2a7000002b735,
+        0x2b7400002b81e,
+        0x2b8200002cea2,
+        0x2ceb00002ebe1,
+        0x300000003134b,
+    ),
+    'CONTEXTJ': (
+        0x200c0000200e,
+    ),
+    'CONTEXTO': (
+        0xb7000000b8,
+        0x37500000376,
+        0x5f3000005f5,
+        0x6600000066a,
+        0x6f0000006fa,
+        0x30fb000030fc,
+    ),
+}
diff --git a/openpype/vendor/python/python_2/idna/intranges.py b/openpype/vendor/python/python_2/idna/intranges.py
new file mode 100644
index 0000000000..fa8a735662
--- /dev/null
+++ b/openpype/vendor/python/python_2/idna/intranges.py
@@ -0,0 +1,53 @@
+"""
+Given a list of integers, made up of (hopefully) a small number of long runs
+of consecutive integers, compute a representation of the form
+((start1, end1), (start2, end2) ...). Then answer the question "was x present
+in the original list?" in time O(log(# runs)).
+"""
+
+import bisect
+
+def intranges_from_list(list_):
+    """Represent a list of integers as a sequence of ranges:
+    ((start_0, end_0), (start_1, end_1), ...), such that the original
+    integers are exactly those x such that start_i <= x < end_i for some i.
+
+    Ranges are encoded as single integers (start << 32 | end), not as tuples.
+    """
+
+    sorted_list = sorted(list_)
+    ranges = []
+    last_write = -1
+    for i in range(len(sorted_list)):
+        if i+1 < len(sorted_list):
+            if sorted_list[i] == sorted_list[i+1]-1:
+                continue
+        current_range = sorted_list[last_write+1:i+1]
+        ranges.append(_encode_range(current_range[0], current_range[-1] + 1))
+        last_write = i
+
+    return tuple(ranges)
+
+def _encode_range(start, end):
+    return (start << 32) | end
+
+def _decode_range(r):
+    return (r >> 32), (r & ((1 << 32) - 1))
+
+
+def intranges_contain(int_, ranges):
+    """Determine if `int_` falls into one of the ranges in `ranges`."""
+    tuple_ = _encode_range(int_, 0)
+    pos = bisect.bisect_left(ranges, tuple_)
+    # we could be immediately ahead of a tuple (start, end)
+    # with start < int_ <= end
+    if pos > 0:
+        left, right = _decode_range(ranges[pos-1])
+        if left <= int_ < right:
+            return True
+    # or we could be immediately behind a tuple (int_, end)
+    if pos < len(ranges):
+        left, _ = _decode_range(ranges[pos])
+        if left == int_:
+            return True
+    return False
diff --git a/openpype/vendor/python/python_2/idna/package_data.py b/openpype/vendor/python/python_2/idna/package_data.py
new file mode 100644
index 0000000000..ce1c521d23
--- /dev/null
+++ b/openpype/vendor/python/python_2/idna/package_data.py
@@ -0,0 +1,2 @@
+__version__ = '2.10'
+
diff --git a/openpype/vendor/python/python_2/idna/uts46data.py b/openpype/vendor/python/python_2/idna/uts46data.py
new file mode 100644
index 0000000000..3766dd49f6
--- /dev/null
+++ b/openpype/vendor/python/python_2/idna/uts46data.py
@@ -0,0 +1,8357 @@
+# This file is automatically generated by tools/idna-data
+# vim: set fileencoding=utf-8 :
+
+"""IDNA Mapping Table from UTS46."""
+
+
+__version__ = "13.0.0"
+def _seg_0():
+    return [
+    (0x0, '3'),
+    (0x1, '3'),
+    (0x2, '3'),
+    (0x3, '3'),
+    (0x4, '3'),
+    (0x5, '3'),
+    (0x6, '3'),
+    (0x7, '3'),
+    (0x8, '3'),
+    (0x9, '3'),
+    (0xA, '3'),
+    (0xB, '3'),
+    (0xC, '3'),
+    (0xD, '3'),
+    (0xE, '3'),
+    (0xF, '3'),
+    (0x10, '3'),
+    (0x11, '3'),
+    (0x12, '3'),
+    (0x13, '3'),
+    (0x14, '3'),
+    (0x15, '3'),
+    (0x16, '3'),
+    (0x17, '3'),
+    (0x18, '3'),
+    (0x19, '3'),
+    (0x1A, '3'),
+    (0x1B, '3'),
+    (0x1C, '3'),
+    (0x1D, '3'),
+    (0x1E, '3'),
+    (0x1F, '3'),
+    (0x20, '3'),
+    (0x21, '3'),
+    (0x22, '3'),
+    (0x23, '3'),
+    (0x24, '3'),
+    (0x25, '3'),
+    (0x26, '3'),
+    (0x27, '3'),
+    (0x28, '3'),
+    (0x29, '3'),
+    (0x2A, '3'),
+    (0x2B, '3'),
+    (0x2C, '3'),
+    (0x2D, 'V'),
+    (0x2E, 'V'),
+    (0x2F, '3'),
+    (0x30, 'V'),
+    (0x31, 'V'),
+    (0x32, 'V'),
+    (0x33, 'V'),
+    (0x34, 'V'),
+    (0x35, 'V'),
+    (0x36, 'V'),
+    (0x37, 'V'),
+    (0x38, 'V'),
+    (0x39, 'V'),
+    (0x3A, '3'),
+    (0x3B, '3'),
+    (0x3C, '3'),
+    (0x3D, '3'),
+    (0x3E, '3'),
+    (0x3F, '3'),
+    (0x40, '3'),
+    (0x41, 'M', u'a'),
+    (0x42, 'M', u'b'),
+    (0x43, 'M', u'c'),
+    (0x44, 'M', u'd'),
+    (0x45, 'M', u'e'),
+    (0x46, 'M', u'f'),
+    (0x47, 'M', u'g'),
+    (0x48, 'M', u'h'),
+    (0x49, 'M', u'i'),
+    (0x4A, 'M', u'j'),
+    (0x4B, 'M', u'k'),
+    (0x4C, 'M', u'l'),
+    (0x4D, 'M', u'm'),
+    (0x4E, 'M', u'n'),
+    (0x4F, 'M', u'o'),
+    (0x50, 'M', u'p'),
+    (0x51, 'M', u'q'),
+    (0x52, 'M', u'r'),
+    (0x53, 'M', u's'),
+    (0x54, 'M', u't'),
+    (0x55, 'M', u'u'),
+    (0x56, 'M', u'v'),
+    (0x57, 'M', u'w'),
+    (0x58, 'M', u'x'),
+    (0x59, 'M', u'y'),
+    (0x5A, 'M', u'z'),
+    (0x5B, '3'),
+    (0x5C, '3'),
+    (0x5D, '3'),
+    (0x5E, '3'),
+    (0x5F, '3'),
+    (0x60, '3'),
+    (0x61, 'V'),
+    (0x62, 'V'),
+    (0x63, 'V'),
+    ]
+
+def _seg_1():
+    return [
+    (0x64, 'V'),
+    (0x65, 'V'),
+    (0x66, 'V'),
+    (0x67, 'V'),
+    (0x68, 'V'),
+    (0x69, 'V'),
+    (0x6A, 'V'),
+    (0x6B, 'V'),
+    (0x6C, 'V'),
+    (0x6D, 'V'),
+    (0x6E, 'V'),
+    (0x6F, 'V'),
+    (0x70, 'V'),
+    (0x71, 'V'),
+    (0x72, 'V'),
+    (0x73, 'V'),
+    (0x74, 'V'),
+    (0x75, 'V'),
+    (0x76, 'V'),
+    (0x77, 'V'),
+    (0x78, 'V'),
+    (0x79, 'V'),
+    (0x7A, 'V'),
+    (0x7B, '3'),
+    (0x7C, '3'),
+    (0x7D, '3'),
+    (0x7E, '3'),
+    (0x7F, '3'),
+    (0x80, 'X'),
+    (0x81, 'X'),
+    (0x82, 'X'),
+    (0x83, 'X'),
+    (0x84, 'X'),
+    (0x85, 'X'),
+    (0x86, 'X'),
+    (0x87, 'X'),
+    (0x88, 'X'),
+    (0x89, 'X'),
+    (0x8A, 'X'),
+    (0x8B, 'X'),
+    (0x8C, 'X'),
+    (0x8D, 'X'),
+    (0x8E, 'X'),
+    (0x8F, 'X'),
+    (0x90, 'X'),
+    (0x91, 'X'),
+    (0x92, 'X'),
+    (0x93, 'X'),
+    (0x94, 'X'),
+    (0x95, 'X'),
+    (0x96, 'X'),
+    (0x97, 'X'),
+    (0x98, 'X'),
+    (0x99, 'X'),
+    (0x9A, 'X'),
+    (0x9B, 'X'),
+    (0x9C, 'X'),
+    (0x9D, 'X'),
+    (0x9E, 'X'),
+    (0x9F, 'X'),
+    (0xA0, '3', u' '),
+    (0xA1, 'V'),
+    (0xA2, 'V'),
+    (0xA3, 'V'),
+    (0xA4, 'V'),
+    (0xA5, 'V'),
+    (0xA6, 'V'),
+    (0xA7, 'V'),
+    (0xA8, '3', u' ̈'),
+    (0xA9, 'V'),
+    (0xAA, 'M', u'a'),
+    (0xAB, 'V'),
+    (0xAC, 'V'),
+    (0xAD, 'I'),
+    (0xAE, 'V'),
+    (0xAF, '3', u' ̄'),
+    (0xB0, 'V'),
+    (0xB1, 'V'),
+    (0xB2, 'M', u'2'),
+    (0xB3, 'M', u'3'),
+    (0xB4, '3', u' ́'),
+    (0xB5, 'M', u'μ'),
+    (0xB6, 'V'),
+    (0xB7, 'V'),
+    (0xB8, '3', u' ̧'),
+    (0xB9, 'M', u'1'),
+    (0xBA, 'M', u'o'),
+    (0xBB, 'V'),
+    (0xBC, 'M', u'1⁄4'),
+    (0xBD, 'M', u'1⁄2'),
+    (0xBE, 'M', u'3⁄4'),
+    (0xBF, 'V'),
+    (0xC0, 'M', u'à'),
+    (0xC1, 'M', u'á'),
+    (0xC2, 'M', u'â'),
+    (0xC3, 'M', u'ã'),
+    (0xC4, 'M', u'ä'),
+    (0xC5, 'M', u'å'),
+    (0xC6, 'M', u'æ'),
+    (0xC7, 'M', u'ç'),
+    ]
+
+def _seg_2():
+    return [
+    (0xC8, 'M', u'è'),
+    (0xC9, 'M', u'é'),
+    (0xCA, 'M', u'ê'),
+    (0xCB, 'M', u'ë'),
+    (0xCC, 'M', u'ì'),
+    (0xCD, 'M', u'í'),
+    (0xCE, 'M', u'î'),
+    (0xCF, 'M', u'ï'),
+    (0xD0, 'M', u'ð'),
+    (0xD1, 'M', u'ñ'),
+    (0xD2, 'M', u'ò'),
+    (0xD3, 'M', u'ó'),
+    (0xD4, 'M', u'ô'),
+    (0xD5, 'M', u'õ'),
+    (0xD6, 'M', u'ö'),
+    (0xD7, 'V'),
+    (0xD8, 'M', u'ø'),
+    (0xD9, 'M', u'ù'),
+    (0xDA, 'M', u'ú'),
+    (0xDB, 'M', u'û'),
+    (0xDC, 'M', u'ü'),
+    (0xDD, 'M', u'ý'),
+    (0xDE, 'M', u'þ'),
+    (0xDF, 'D', u'ss'),
+    (0xE0, 'V'),
+    (0xE1, 'V'),
+    (0xE2, 'V'),
+    (0xE3, 'V'),
+    (0xE4, 'V'),
+    (0xE5, 'V'),
+    (0xE6, 'V'),
+    (0xE7, 'V'),
+    (0xE8, 'V'),
+    (0xE9, 'V'),
+    (0xEA, 'V'),
+    (0xEB, 'V'),
+    (0xEC, 'V'),
+    (0xED, 'V'),
+    (0xEE, 'V'),
+    (0xEF, 'V'),
+    (0xF0, 'V'),
+    (0xF1, 'V'),
+    (0xF2, 'V'),
+    (0xF3, 'V'),
+    (0xF4, 'V'),
+    (0xF5, 'V'),
+    (0xF6, 'V'),
+    (0xF7, 'V'),
+    (0xF8, 'V'),
+    (0xF9, 'V'),
+    (0xFA, 'V'),
+    (0xFB, 'V'),
+    (0xFC, 'V'),
+    (0xFD, 'V'),
+    (0xFE, 'V'),
+    (0xFF, 'V'),
+    (0x100, 'M', u'ā'),
+    (0x101, 'V'),
+    (0x102, 'M', u'ă'),
+    (0x103, 'V'),
+    (0x104, 'M', u'ą'),
+    (0x105, 'V'),
+    (0x106, 'M', u'ć'),
+    (0x107, 'V'),
+    (0x108, 'M', u'ĉ'),
+    (0x109, 'V'),
+    (0x10A, 'M', u'ċ'),
+    (0x10B, 'V'),
+    (0x10C, 'M', u'č'),
+    (0x10D, 'V'),
+    (0x10E, 'M', u'ď'),
+    (0x10F, 'V'),
+    (0x110, 'M', u'đ'),
+    (0x111, 'V'),
+    (0x112, 'M', u'ē'),
+    (0x113, 'V'),
+    (0x114, 'M', u'ĕ'),
+    (0x115, 'V'),
+    (0x116, 'M', u'ė'),
+    (0x117, 'V'),
+    (0x118, 'M', u'ę'),
+    (0x119, 'V'),
+    (0x11A, 'M', u'ě'),
+    (0x11B, 'V'),
+    (0x11C, 'M', u'ĝ'),
+    (0x11D, 'V'),
+    (0x11E, 'M', u'ğ'),
+    (0x11F, 'V'),
+    (0x120, 'M', u'ġ'),
+    (0x121, 'V'),
+    (0x122, 'M', u'ģ'),
+    (0x123, 'V'),
+    (0x124, 'M', u'ĥ'),
+    (0x125, 'V'),
+    (0x126, 'M', u'ħ'),
+    (0x127, 'V'),
+    (0x128, 'M', u'ĩ'),
+    (0x129, 'V'),
+    (0x12A, 'M', u'ī'),
+    (0x12B, 'V'),
+    ]
+
+def _seg_3():
+    return [
+    (0x12C, 'M', u'ĭ'),
+    (0x12D, 'V'),
+    (0x12E, 'M', u'į'),
+    (0x12F, 'V'),
+    (0x130, 'M', u'i̇'),
+    (0x131, 'V'),
+    (0x132, 'M', u'ij'),
+    (0x134, 'M', u'ĵ'),
+    (0x135, 'V'),
+    (0x136, 'M', u'ķ'),
+    (0x137, 'V'),
+    (0x139, 'M', u'ĺ'),
+    (0x13A, 'V'),
+    (0x13B, 'M', u'ļ'),
+    (0x13C, 'V'),
+    (0x13D, 'M', u'ľ'),
+    (0x13E, 'V'),
+    (0x13F, 'M', u'l·'),
+    (0x141, 'M', u'ł'),
+    (0x142, 'V'),
+    (0x143, 'M', u'ń'),
+    (0x144, 'V'),
+    (0x145, 'M', u'ņ'),
+    (0x146, 'V'),
+    (0x147, 'M', u'ň'),
+    (0x148, 'V'),
+    (0x149, 'M', u'ʼn'),
+    (0x14A, 'M', u'ŋ'),
+    (0x14B, 'V'),
+    (0x14C, 'M', u'ō'),
+    (0x14D, 'V'),
+    (0x14E, 'M', u'ŏ'),
+    (0x14F, 'V'),
+    (0x150, 'M', u'ő'),
+    (0x151, 'V'),
+    (0x152, 'M', u'œ'),
+    (0x153, 'V'),
+    (0x154, 'M', u'ŕ'),
+    (0x155, 'V'),
+    (0x156, 'M', u'ŗ'),
+    (0x157, 'V'),
+    (0x158, 'M', u'ř'),
+    (0x159, 'V'),
+    (0x15A, 'M', u'ś'),
+    (0x15B, 'V'),
+    (0x15C, 'M', u'ŝ'),
+    (0x15D, 'V'),
+    (0x15E, 'M', u'ş'),
+    (0x15F, 'V'),
+    (0x160, 'M', u'š'),
+    (0x161, 'V'),
+    (0x162, 'M', u'ţ'),
+    (0x163, 'V'),
+    (0x164, 'M', u'ť'),
+    (0x165, 'V'),
+    (0x166, 'M', u'ŧ'),
+    (0x167, 'V'),
+    (0x168, 'M', u'ũ'),
+    (0x169, 'V'),
+    (0x16A, 'M', u'ū'),
+    (0x16B, 'V'),
+    (0x16C, 'M', u'ŭ'),
+    (0x16D, 'V'),
+    (0x16E, 'M', u'ů'),
+    (0x16F, 'V'),
+    (0x170, 'M', u'ű'),
+    (0x171, 'V'),
+    (0x172, 'M', u'ų'),
+    (0x173, 'V'),
+    (0x174, 'M', u'ŵ'),
+    (0x175, 'V'),
+    (0x176, 'M', u'ŷ'),
+    (0x177, 'V'),
+    (0x178, 'M', u'ÿ'),
+    (0x179, 'M', u'ź'),
+    (0x17A, 'V'),
+    (0x17B, 'M', u'ż'),
+    (0x17C, 'V'),
+    (0x17D, 'M', u'ž'),
+    (0x17E, 'V'),
+    (0x17F, 'M', u's'),
+    (0x180, 'V'),
+    (0x181, 'M', u'ɓ'),
+    (0x182, 'M', u'ƃ'),
+    (0x183, 'V'),
+    (0x184, 'M', u'ƅ'),
+    (0x185, 'V'),
+    (0x186, 'M', u'ɔ'),
+    (0x187, 'M', u'ƈ'),
+    (0x188, 'V'),
+    (0x189, 'M', u'ɖ'),
+    (0x18A, 'M', u'ɗ'),
+    (0x18B, 'M', u'ƌ'),
+    (0x18C, 'V'),
+    (0x18E, 'M', u'ǝ'),
+    (0x18F, 'M', u'ə'),
+    (0x190, 'M', u'ɛ'),
+    (0x191, 'M', u'ƒ'),
+    (0x192, 'V'),
+    (0x193, 'M', u'ɠ'),
+    ]
+
+def _seg_4():
+    return [
+    (0x194, 'M', u'ɣ'),
+    (0x195, 'V'),
+    (0x196, 'M', u'ɩ'),
+    (0x197, 'M', u'ɨ'),
+    (0x198, 'M', u'ƙ'),
+    (0x199, 'V'),
+    (0x19C, 'M', u'ɯ'),
+    (0x19D, 'M', u'ɲ'),
+    (0x19E, 'V'),
+    (0x19F, 'M', u'ɵ'),
+    (0x1A0, 'M', u'ơ'),
+    (0x1A1, 'V'),
+    (0x1A2, 'M', u'ƣ'),
+    (0x1A3, 'V'),
+    (0x1A4, 'M', u'ƥ'),
+    (0x1A5, 'V'),
+    (0x1A6, 'M', u'ʀ'),
+    (0x1A7, 'M', u'ƨ'),
+    (0x1A8, 'V'),
+    (0x1A9, 'M', u'ʃ'),
+    (0x1AA, 'V'),
+    (0x1AC, 'M', u'ƭ'),
+    (0x1AD, 'V'),
+    (0x1AE, 'M', u'ʈ'),
+    (0x1AF, 'M', u'ư'),
+    (0x1B0, 'V'),
+    (0x1B1, 'M', u'ʊ'),
+    (0x1B2, 'M', u'ʋ'),
+    (0x1B3, 'M', u'ƴ'),
+    (0x1B4, 'V'),
+    (0x1B5, 'M', u'ƶ'),
+    (0x1B6, 'V'),
+    (0x1B7, 'M', u'ʒ'),
+    (0x1B8, 'M', u'ƹ'),
+    (0x1B9, 'V'),
+    (0x1BC, 'M', u'ƽ'),
+    (0x1BD, 'V'),
+    (0x1C4, 'M', u'dž'),
+    (0x1C7, 'M', u'lj'),
+    (0x1CA, 'M', u'nj'),
+    (0x1CD, 'M', u'ǎ'),
+    (0x1CE, 'V'),
+    (0x1CF, 'M', u'ǐ'),
+    (0x1D0, 'V'),
+    (0x1D1, 'M', u'ǒ'),
+    (0x1D2, 'V'),
+    (0x1D3, 'M', u'ǔ'),
+    (0x1D4, 'V'),
+    (0x1D5, 'M', u'ǖ'),
+    (0x1D6, 'V'),
+    (0x1D7, 'M', u'ǘ'),
+    (0x1D8, 'V'),
+    (0x1D9, 'M', u'ǚ'),
+    (0x1DA, 'V'),
+    (0x1DB, 'M', u'ǜ'),
+    (0x1DC, 'V'),
+    (0x1DE, 'M', u'ǟ'),
+    (0x1DF, 'V'),
+    (0x1E0, 'M', u'ǡ'),
+    (0x1E1, 'V'),
+    (0x1E2, 'M', u'ǣ'),
+    (0x1E3, 'V'),
+    (0x1E4, 'M', u'ǥ'),
+    (0x1E5, 'V'),
+    (0x1E6, 'M', u'ǧ'),
+    (0x1E7, 'V'),
+    (0x1E8, 'M', u'ǩ'),
+    (0x1E9, 'V'),
+    (0x1EA, 'M', u'ǫ'),
+    (0x1EB, 'V'),
+    (0x1EC, 'M', u'ǭ'),
+    (0x1ED, 'V'),
+    (0x1EE, 'M', u'ǯ'),
+    (0x1EF, 'V'),
+    (0x1F1, 'M', u'dz'),
+    (0x1F4, 'M', u'ǵ'),
+    (0x1F5, 'V'),
+    (0x1F6, 'M', u'ƕ'),
+    (0x1F7, 'M', u'ƿ'),
+    (0x1F8, 'M', u'ǹ'),
+    (0x1F9, 'V'),
+    (0x1FA, 'M', u'ǻ'),
+    (0x1FB, 'V'),
+    (0x1FC, 'M', u'ǽ'),
+    (0x1FD, 'V'),
+    (0x1FE, 'M', u'ǿ'),
+    (0x1FF, 'V'),
+    (0x200, 'M', u'ȁ'),
+    (0x201, 'V'),
+    (0x202, 'M', u'ȃ'),
+    (0x203, 'V'),
+    (0x204, 'M', u'ȅ'),
+    (0x205, 'V'),
+    (0x206, 'M', u'ȇ'),
+    (0x207, 'V'),
+    (0x208, 'M', u'ȉ'),
+    (0x209, 'V'),
+    (0x20A, 'M', u'ȋ'),
+    (0x20B, 'V'),
+    (0x20C, 'M', u'ȍ'),
+    ]
+
+def _seg_5():
+    return [
+    (0x20D, 'V'),
+    (0x20E, 'M', u'ȏ'),
+    (0x20F, 'V'),
+    (0x210, 'M', u'ȑ'),
+    (0x211, 'V'),
+    (0x212, 'M', u'ȓ'),
+    (0x213, 'V'),
+    (0x214, 'M', u'ȕ'),
+    (0x215, 'V'),
+    (0x216, 'M', u'ȗ'),
+    (0x217, 'V'),
+    (0x218, 'M', u'ș'),
+    (0x219, 'V'),
+    (0x21A, 'M', u'ț'),
+    (0x21B, 'V'),
+    (0x21C, 'M', u'ȝ'),
+    (0x21D, 'V'),
+    (0x21E, 'M', u'ȟ'),
+    (0x21F, 'V'),
+    (0x220, 'M', u'ƞ'),
+    (0x221, 'V'),
+    (0x222, 'M', u'ȣ'),
+    (0x223, 'V'),
+    (0x224, 'M', u'ȥ'),
+    (0x225, 'V'),
+    (0x226, 'M', u'ȧ'),
+    (0x227, 'V'),
+    (0x228, 'M', u'ȩ'),
+    (0x229, 'V'),
+    (0x22A, 'M', u'ȫ'),
+    (0x22B, 'V'),
+    (0x22C, 'M', u'ȭ'),
+    (0x22D, 'V'),
+    (0x22E, 'M', u'ȯ'),
+    (0x22F, 'V'),
+    (0x230, 'M', u'ȱ'),
+    (0x231, 'V'),
+    (0x232, 'M', u'ȳ'),
+    (0x233, 'V'),
+    (0x23A, 'M', u'ⱥ'),
+    (0x23B, 'M', u'ȼ'),
+    (0x23C, 'V'),
+    (0x23D, 'M', u'ƚ'),
+    (0x23E, 'M', u'ⱦ'),
+    (0x23F, 'V'),
+    (0x241, 'M', u'ɂ'),
+    (0x242, 'V'),
+    (0x243, 'M', u'ƀ'),
+    (0x244, 'M', u'ʉ'),
+    (0x245, 'M', u'ʌ'),
+    (0x246, 'M', u'ɇ'),
+    (0x247, 'V'),
+    (0x248, 'M', u'ɉ'),
+    (0x249, 'V'),
+    (0x24A, 'M', u'ɋ'),
+    (0x24B, 'V'),
+    (0x24C, 'M', u'ɍ'),
+    (0x24D, 'V'),
+    (0x24E, 'M', u'ɏ'),
+    (0x24F, 'V'),
+    (0x2B0, 'M', u'h'),
+    (0x2B1, 'M', u'ɦ'),
+    (0x2B2, 'M', u'j'),
+    (0x2B3, 'M', u'r'),
+    (0x2B4, 'M', u'ɹ'),
+    (0x2B5, 'M', u'ɻ'),
+    (0x2B6, 'M', u'ʁ'),
+    (0x2B7, 'M', u'w'),
+    (0x2B8, 'M', u'y'),
+    (0x2B9, 'V'),
+    (0x2D8, '3', u' ̆'),
+    (0x2D9, '3', u' ̇'),
+    (0x2DA, '3', u' ̊'),
+    (0x2DB, '3', u' ̨'),
+    (0x2DC, '3', u' ̃'),
+    (0x2DD, '3', u' ̋'),
+    (0x2DE, 'V'),
+    (0x2E0, 'M', u'ɣ'),
+    (0x2E1, 'M', u'l'),
+    (0x2E2, 'M', u's'),
+    (0x2E3, 'M', u'x'),
+    (0x2E4, 'M', u'ʕ'),
+    (0x2E5, 'V'),
+    (0x340, 'M', u'̀'),
+    (0x341, 'M', u'́'),
+    (0x342, 'V'),
+    (0x343, 'M', u'̓'),
+    (0x344, 'M', u'̈́'),
+    (0x345, 'M', u'ι'),
+    (0x346, 'V'),
+    (0x34F, 'I'),
+    (0x350, 'V'),
+    (0x370, 'M', u'ͱ'),
+    (0x371, 'V'),
+    (0x372, 'M', u'ͳ'),
+    (0x373, 'V'),
+    (0x374, 'M', u'ʹ'),
+    (0x375, 'V'),
+    (0x376, 'M', u'ͷ'),
+    (0x377, 'V'),
+    ]
+
+def _seg_6():
+    return [
+    (0x378, 'X'),
+    (0x37A, '3', u' ι'),
+    (0x37B, 'V'),
+    (0x37E, '3', u';'),
+    (0x37F, 'M', u'ϳ'),
+    (0x380, 'X'),
+    (0x384, '3', u' ́'),
+    (0x385, '3', u' ̈́'),
+    (0x386, 'M', u'ά'),
+    (0x387, 'M', u'·'),
+    (0x388, 'M', u'έ'),
+    (0x389, 'M', u'ή'),
+    (0x38A, 'M', u'ί'),
+    (0x38B, 'X'),
+    (0x38C, 'M', u'ό'),
+    (0x38D, 'X'),
+    (0x38E, 'M', u'ύ'),
+    (0x38F, 'M', u'ώ'),
+    (0x390, 'V'),
+    (0x391, 'M', u'α'),
+    (0x392, 'M', u'β'),
+    (0x393, 'M', u'γ'),
+    (0x394, 'M', u'δ'),
+    (0x395, 'M', u'ε'),
+    (0x396, 'M', u'ζ'),
+    (0x397, 'M', u'η'),
+    (0x398, 'M', u'θ'),
+    (0x399, 'M', u'ι'),
+    (0x39A, 'M', u'κ'),
+    (0x39B, 'M', u'λ'),
+    (0x39C, 'M', u'μ'),
+    (0x39D, 'M', u'ν'),
+    (0x39E, 'M', u'ξ'),
+    (0x39F, 'M', u'ο'),
+    (0x3A0, 'M', u'π'),
+    (0x3A1, 'M', u'ρ'),
+    (0x3A2, 'X'),
+    (0x3A3, 'M', u'σ'),
+    (0x3A4, 'M', u'τ'),
+    (0x3A5, 'M', u'υ'),
+    (0x3A6, 'M', u'φ'),
+    (0x3A7, 'M', u'χ'),
+    (0x3A8, 'M', u'ψ'),
+    (0x3A9, 'M', u'ω'),
+    (0x3AA, 'M', u'ϊ'),
+    (0x3AB, 'M', u'ϋ'),
+    (0x3AC, 'V'),
+    (0x3C2, 'D', u'σ'),
+    (0x3C3, 'V'),
+    (0x3CF, 'M', u'ϗ'),
+    (0x3D0, 'M', u'β'),
+    (0x3D1, 'M', u'θ'),
+    (0x3D2, 'M', u'υ'),
+    (0x3D3, 'M', u'ύ'),
+    (0x3D4, 'M', u'ϋ'),
+    (0x3D5, 'M', u'φ'),
+    (0x3D6, 'M', u'π'),
+    (0x3D7, 'V'),
+    (0x3D8, 'M', u'ϙ'),
+    (0x3D9, 'V'),
+    (0x3DA, 'M', u'ϛ'),
+    (0x3DB, 'V'),
+    (0x3DC, 'M', u'ϝ'),
+    (0x3DD, 'V'),
+    (0x3DE, 'M', u'ϟ'),
+    (0x3DF, 'V'),
+    (0x3E0, 'M', u'ϡ'),
+    (0x3E1, 'V'),
+    (0x3E2, 'M', u'ϣ'),
+    (0x3E3, 'V'),
+    (0x3E4, 'M', u'ϥ'),
+    (0x3E5, 'V'),
+    (0x3E6, 'M', u'ϧ'),
+    (0x3E7, 'V'),
+    (0x3E8, 'M', u'ϩ'),
+    (0x3E9, 'V'),
+    (0x3EA, 'M', u'ϫ'),
+    (0x3EB, 'V'),
+    (0x3EC, 'M', u'ϭ'),
+    (0x3ED, 'V'),
+    (0x3EE, 'M', u'ϯ'),
+    (0x3EF, 'V'),
+    (0x3F0, 'M', u'κ'),
+    (0x3F1, 'M', u'ρ'),
+    (0x3F2, 'M', u'σ'),
+    (0x3F3, 'V'),
+    (0x3F4, 'M', u'θ'),
+    (0x3F5, 'M', u'ε'),
+    (0x3F6, 'V'),
+    (0x3F7, 'M', u'ϸ'),
+    (0x3F8, 'V'),
+    (0x3F9, 'M', u'σ'),
+    (0x3FA, 'M', u'ϻ'),
+    (0x3FB, 'V'),
+    (0x3FD, 'M', u'ͻ'),
+    (0x3FE, 'M', u'ͼ'),
+    (0x3FF, 'M', u'ͽ'),
+    (0x400, 'M', u'ѐ'),
+    (0x401, 'M', u'ё'),
+    (0x402, 'M', u'ђ'),
+    ]
+
+def _seg_7():
+    return [
+    (0x403, 'M', u'ѓ'),
+    (0x404, 'M', u'є'),
+    (0x405, 'M', u'ѕ'),
+    (0x406, 'M', u'і'),
+    (0x407, 'M', u'ї'),
+    (0x408, 'M', u'ј'),
+    (0x409, 'M', u'љ'),
+    (0x40A, 'M', u'њ'),
+    (0x40B, 'M', u'ћ'),
+    (0x40C, 'M', u'ќ'),
+    (0x40D, 'M', u'ѝ'),
+    (0x40E, 'M', u'ў'),
+    (0x40F, 'M', u'џ'),
+    (0x410, 'M', u'а'),
+    (0x411, 'M', u'б'),
+    (0x412, 'M', u'в'),
+    (0x413, 'M', u'г'),
+    (0x414, 'M', u'д'),
+    (0x415, 'M', u'е'),
+    (0x416, 'M', u'ж'),
+    (0x417, 'M', u'з'),
+    (0x418, 'M', u'и'),
+    (0x419, 'M', u'й'),
+    (0x41A, 'M', u'к'),
+    (0x41B, 'M', u'л'),
+    (0x41C, 'M', u'м'),
+    (0x41D, 'M', u'н'),
+    (0x41E, 'M', u'о'),
+    (0x41F, 'M', u'п'),
+    (0x420, 'M', u'р'),
+    (0x421, 'M', u'с'),
+    (0x422, 'M', u'т'),
+    (0x423, 'M', u'у'),
+    (0x424, 'M', u'ф'),
+    (0x425, 'M', u'х'),
+    (0x426, 'M', u'ц'),
+    (0x427, 'M', u'ч'),
+    (0x428, 'M', u'ш'),
+    (0x429, 'M', u'щ'),
+    (0x42A, 'M', u'ъ'),
+    (0x42B, 'M', u'ы'),
+    (0x42C, 'M', u'ь'),
+    (0x42D, 'M', u'э'),
+    (0x42E, 'M', u'ю'),
+    (0x42F, 'M', u'я'),
+    (0x430, 'V'),
+    (0x460, 'M', u'ѡ'),
+    (0x461, 'V'),
+    (0x462, 'M', u'ѣ'),
+    (0x463, 'V'),
+    (0x464, 'M', u'ѥ'),
+    (0x465, 'V'),
+    (0x466, 'M', u'ѧ'),
+    (0x467, 'V'),
+    (0x468, 'M', u'ѩ'),
+    (0x469, 'V'),
+    (0x46A, 'M', u'ѫ'),
+    (0x46B, 'V'),
+    (0x46C, 'M', u'ѭ'),
+    (0x46D, 'V'),
+    (0x46E, 'M', u'ѯ'),
+    (0x46F, 'V'),
+    (0x470, 'M', u'ѱ'),
+    (0x471, 'V'),
+    (0x472, 'M', u'ѳ'),
+    (0x473, 'V'),
+    (0x474, 'M', u'ѵ'),
+    (0x475, 'V'),
+    (0x476, 'M', u'ѷ'),
+    (0x477, 'V'),
+    (0x478, 'M', u'ѹ'),
+    (0x479, 'V'),
+    (0x47A, 'M', u'ѻ'),
+    (0x47B, 'V'),
+    (0x47C, 'M', u'ѽ'),
+    (0x47D, 'V'),
+    (0x47E, 'M', u'ѿ'),
+    (0x47F, 'V'),
+    (0x480, 'M', u'ҁ'),
+    (0x481, 'V'),
+    (0x48A, 'M', u'ҋ'),
+    (0x48B, 'V'),
+    (0x48C, 'M', u'ҍ'),
+    (0x48D, 'V'),
+    (0x48E, 'M', u'ҏ'),
+    (0x48F, 'V'),
+    (0x490, 'M', u'ґ'),
+    (0x491, 'V'),
+    (0x492, 'M', u'ғ'),
+    (0x493, 'V'),
+    (0x494, 'M', u'ҕ'),
+    (0x495, 'V'),
+    (0x496, 'M', u'җ'),
+    (0x497, 'V'),
+    (0x498, 'M', u'ҙ'),
+    (0x499, 'V'),
+    (0x49A, 'M', u'қ'),
+    (0x49B, 'V'),
+    (0x49C, 'M', u'ҝ'),
+    (0x49D, 'V'),
+    ]
+
+def _seg_8():
+    return [
+    (0x49E, 'M', u'ҟ'),
+    (0x49F, 'V'),
+    (0x4A0, 'M', u'ҡ'),
+    (0x4A1, 'V'),
+    (0x4A2, 'M', u'ң'),
+    (0x4A3, 'V'),
+    (0x4A4, 'M', u'ҥ'),
+    (0x4A5, 'V'),
+    (0x4A6, 'M', u'ҧ'),
+    (0x4A7, 'V'),
+    (0x4A8, 'M', u'ҩ'),
+    (0x4A9, 'V'),
+    (0x4AA, 'M', u'ҫ'),
+    (0x4AB, 'V'),
+    (0x4AC, 'M', u'ҭ'),
+    (0x4AD, 'V'),
+    (0x4AE, 'M', u'ү'),
+    (0x4AF, 'V'),
+    (0x4B0, 'M', u'ұ'),
+    (0x4B1, 'V'),
+    (0x4B2, 'M', u'ҳ'),
+    (0x4B3, 'V'),
+    (0x4B4, 'M', u'ҵ'),
+    (0x4B5, 'V'),
+    (0x4B6, 'M', u'ҷ'),
+    (0x4B7, 'V'),
+    (0x4B8, 'M', u'ҹ'),
+    (0x4B9, 'V'),
+    (0x4BA, 'M', u'һ'),
+    (0x4BB, 'V'),
+    (0x4BC, 'M', u'ҽ'),
+    (0x4BD, 'V'),
+    (0x4BE, 'M', u'ҿ'),
+    (0x4BF, 'V'),
+    (0x4C0, 'X'),
+    (0x4C1, 'M', u'ӂ'),
+    (0x4C2, 'V'),
+    (0x4C3, 'M', u'ӄ'),
+    (0x4C4, 'V'),
+    (0x4C5, 'M', u'ӆ'),
+    (0x4C6, 'V'),
+    (0x4C7, 'M', u'ӈ'),
+    (0x4C8, 'V'),
+    (0x4C9, 'M', u'ӊ'),
+    (0x4CA, 'V'),
+    (0x4CB, 'M', u'ӌ'),
+    (0x4CC, 'V'),
+    (0x4CD, 'M', u'ӎ'),
+    (0x4CE, 'V'),
+    (0x4D0, 'M', u'ӑ'),
+    (0x4D1, 'V'),
+    (0x4D2, 'M', u'ӓ'),
+    (0x4D3, 'V'),
+    (0x4D4, 'M', u'ӕ'),
+    (0x4D5, 'V'),
+    (0x4D6, 'M', u'ӗ'),
+    (0x4D7, 'V'),
+    (0x4D8, 'M', u'ә'),
+    (0x4D9, 'V'),
+    (0x4DA, 'M', u'ӛ'),
+    (0x4DB, 'V'),
+    (0x4DC, 'M', u'ӝ'),
+    (0x4DD, 'V'),
+    (0x4DE, 'M', u'ӟ'),
+    (0x4DF, 'V'),
+    (0x4E0, 'M', u'ӡ'),
+    (0x4E1, 'V'),
+    (0x4E2, 'M', u'ӣ'),
+    (0x4E3, 'V'),
+    (0x4E4, 'M', u'ӥ'),
+    (0x4E5, 'V'),
+    (0x4E6, 'M', u'ӧ'),
+    (0x4E7, 'V'),
+    (0x4E8, 'M', u'ө'),
+    (0x4E9, 'V'),
+    (0x4EA, 'M', u'ӫ'),
+    (0x4EB, 'V'),
+    (0x4EC, 'M', u'ӭ'),
+    (0x4ED, 'V'),
+    (0x4EE, 'M', u'ӯ'),
+    (0x4EF, 'V'),
+    (0x4F0, 'M', u'ӱ'),
+    (0x4F1, 'V'),
+    (0x4F2, 'M', u'ӳ'),
+    (0x4F3, 'V'),
+    (0x4F4, 'M', u'ӵ'),
+    (0x4F5, 'V'),
+    (0x4F6, 'M', u'ӷ'),
+    (0x4F7, 'V'),
+    (0x4F8, 'M', u'ӹ'),
+    (0x4F9, 'V'),
+    (0x4FA, 'M', u'ӻ'),
+    (0x4FB, 'V'),
+    (0x4FC, 'M', u'ӽ'),
+    (0x4FD, 'V'),
+    (0x4FE, 'M', u'ӿ'),
+    (0x4FF, 'V'),
+    (0x500, 'M', u'ԁ'),
+    (0x501, 'V'),
+    (0x502, 'M', u'ԃ'),
+    ]
+
+def _seg_9():
+    return [
+    (0x503, 'V'),
+    (0x504, 'M', u'ԅ'),
+    (0x505, 'V'),
+    (0x506, 'M', u'ԇ'),
+    (0x507, 'V'),
+    (0x508, 'M', u'ԉ'),
+    (0x509, 'V'),
+    (0x50A, 'M', u'ԋ'),
+    (0x50B, 'V'),
+    (0x50C, 'M', u'ԍ'),
+    (0x50D, 'V'),
+    (0x50E, 'M', u'ԏ'),
+    (0x50F, 'V'),
+    (0x510, 'M', u'ԑ'),
+    (0x511, 'V'),
+    (0x512, 'M', u'ԓ'),
+    (0x513, 'V'),
+    (0x514, 'M', u'ԕ'),
+    (0x515, 'V'),
+    (0x516, 'M', u'ԗ'),
+    (0x517, 'V'),
+    (0x518, 'M', u'ԙ'),
+    (0x519, 'V'),
+    (0x51A, 'M', u'ԛ'),
+    (0x51B, 'V'),
+    (0x51C, 'M', u'ԝ'),
+    (0x51D, 'V'),
+    (0x51E, 'M', u'ԟ'),
+    (0x51F, 'V'),
+    (0x520, 'M', u'ԡ'),
+    (0x521, 'V'),
+    (0x522, 'M', u'ԣ'),
+    (0x523, 'V'),
+    (0x524, 'M', u'ԥ'),
+    (0x525, 'V'),
+    (0x526, 'M', u'ԧ'),
+    (0x527, 'V'),
+    (0x528, 'M', u'ԩ'),
+    (0x529, 'V'),
+    (0x52A, 'M', u'ԫ'),
+    (0x52B, 'V'),
+    (0x52C, 'M', u'ԭ'),
+    (0x52D, 'V'),
+    (0x52E, 'M', u'ԯ'),
+    (0x52F, 'V'),
+    (0x530, 'X'),
+    (0x531, 'M', u'ա'),
+    (0x532, 'M', u'բ'),
+    (0x533, 'M', u'գ'),
+    (0x534, 'M', u'դ'),
+    (0x535, 'M', u'ե'),
+    (0x536, 'M', u'զ'),
+    (0x537, 'M', u'է'),
+    (0x538, 'M', u'ը'),
+    (0x539, 'M', u'թ'),
+    (0x53A, 'M', u'ժ'),
+    (0x53B, 'M', u'ի'),
+    (0x53C, 'M', u'լ'),
+    (0x53D, 'M', u'խ'),
+    (0x53E, 'M', u'ծ'),
+    (0x53F, 'M', u'կ'),
+    (0x540, 'M', u'հ'),
+    (0x541, 'M', u'ձ'),
+    (0x542, 'M', u'ղ'),
+    (0x543, 'M', u'ճ'),
+    (0x544, 'M', u'մ'),
+    (0x545, 'M', u'յ'),
+    (0x546, 'M', u'ն'),
+    (0x547, 'M', u'շ'),
+    (0x548, 'M', u'ո'),
+    (0x549, 'M', u'չ'),
+    (0x54A, 'M', u'պ'),
+    (0x54B, 'M', u'ջ'),
+    (0x54C, 'M', u'ռ'),
+    (0x54D, 'M', u'ս'),
+    (0x54E, 'M', u'վ'),
+    (0x54F, 'M', u'տ'),
+    (0x550, 'M', u'ր'),
+    (0x551, 'M', u'ց'),
+    (0x552, 'M', u'ւ'),
+    (0x553, 'M', u'փ'),
+    (0x554, 'M', u'ք'),
+    (0x555, 'M', u'օ'),
+    (0x556, 'M', u'ֆ'),
+    (0x557, 'X'),
+    (0x559, 'V'),
+    (0x587, 'M', u'եւ'),
+    (0x588, 'V'),
+    (0x58B, 'X'),
+    (0x58D, 'V'),
+    (0x590, 'X'),
+    (0x591, 'V'),
+    (0x5C8, 'X'),
+    (0x5D0, 'V'),
+    (0x5EB, 'X'),
+    (0x5EF, 'V'),
+    (0x5F5, 'X'),
+    (0x606, 'V'),
+    (0x61C, 'X'),
+    (0x61E, 'V'),
+    ]
+
+def _seg_10():
+    return [
+    (0x675, 'M', u'اٴ'),
+    (0x676, 'M', u'وٴ'),
+    (0x677, 'M', u'ۇٴ'),
+    (0x678, 'M', u'يٴ'),
+    (0x679, 'V'),
+    (0x6DD, 'X'),
+    (0x6DE, 'V'),
+    (0x70E, 'X'),
+    (0x710, 'V'),
+    (0x74B, 'X'),
+    (0x74D, 'V'),
+    (0x7B2, 'X'),
+    (0x7C0, 'V'),
+    (0x7FB, 'X'),
+    (0x7FD, 'V'),
+    (0x82E, 'X'),
+    (0x830, 'V'),
+    (0x83F, 'X'),
+    (0x840, 'V'),
+    (0x85C, 'X'),
+    (0x85E, 'V'),
+    (0x85F, 'X'),
+    (0x860, 'V'),
+    (0x86B, 'X'),
+    (0x8A0, 'V'),
+    (0x8B5, 'X'),
+    (0x8B6, 'V'),
+    (0x8C8, 'X'),
+    (0x8D3, 'V'),
+    (0x8E2, 'X'),
+    (0x8E3, 'V'),
+    (0x958, 'M', u'क़'),
+    (0x959, 'M', u'ख़'),
+    (0x95A, 'M', u'ग़'),
+    (0x95B, 'M', u'ज़'),
+    (0x95C, 'M', u'ड़'),
+    (0x95D, 'M', u'ढ़'),
+    (0x95E, 'M', u'फ़'),
+    (0x95F, 'M', u'य़'),
+    (0x960, 'V'),
+    (0x984, 'X'),
+    (0x985, 'V'),
+    (0x98D, 'X'),
+    (0x98F, 'V'),
+    (0x991, 'X'),
+    (0x993, 'V'),
+    (0x9A9, 'X'),
+    (0x9AA, 'V'),
+    (0x9B1, 'X'),
+    (0x9B2, 'V'),
+    (0x9B3, 'X'),
+    (0x9B6, 'V'),
+    (0x9BA, 'X'),
+    (0x9BC, 'V'),
+    (0x9C5, 'X'),
+    (0x9C7, 'V'),
+    (0x9C9, 'X'),
+    (0x9CB, 'V'),
+    (0x9CF, 'X'),
+    (0x9D7, 'V'),
+    (0x9D8, 'X'),
+    (0x9DC, 'M', u'ড়'),
+    (0x9DD, 'M', u'ঢ়'),
+    (0x9DE, 'X'),
+    (0x9DF, 'M', u'য়'),
+    (0x9E0, 'V'),
+    (0x9E4, 'X'),
+    (0x9E6, 'V'),
+    (0x9FF, 'X'),
+    (0xA01, 'V'),
+    (0xA04, 'X'),
+    (0xA05, 'V'),
+    (0xA0B, 'X'),
+    (0xA0F, 'V'),
+    (0xA11, 'X'),
+    (0xA13, 'V'),
+    (0xA29, 'X'),
+    (0xA2A, 'V'),
+    (0xA31, 'X'),
+    (0xA32, 'V'),
+    (0xA33, 'M', u'ਲ਼'),
+    (0xA34, 'X'),
+    (0xA35, 'V'),
+    (0xA36, 'M', u'ਸ਼'),
+    (0xA37, 'X'),
+    (0xA38, 'V'),
+    (0xA3A, 'X'),
+    (0xA3C, 'V'),
+    (0xA3D, 'X'),
+    (0xA3E, 'V'),
+    (0xA43, 'X'),
+    (0xA47, 'V'),
+    (0xA49, 'X'),
+    (0xA4B, 'V'),
+    (0xA4E, 'X'),
+    (0xA51, 'V'),
+    (0xA52, 'X'),
+    (0xA59, 'M', u'ਖ਼'),
+    (0xA5A, 'M', u'ਗ਼'),
+    (0xA5B, 'M', u'ਜ਼'),
+    ]
+
+def _seg_11():
+    return [
+    (0xA5C, 'V'),
+    (0xA5D, 'X'),
+    (0xA5E, 'M', u'ਫ਼'),
+    (0xA5F, 'X'),
+    (0xA66, 'V'),
+    (0xA77, 'X'),
+    (0xA81, 'V'),
+    (0xA84, 'X'),
+    (0xA85, 'V'),
+    (0xA8E, 'X'),
+    (0xA8F, 'V'),
+    (0xA92, 'X'),
+    (0xA93, 'V'),
+    (0xAA9, 'X'),
+    (0xAAA, 'V'),
+    (0xAB1, 'X'),
+    (0xAB2, 'V'),
+    (0xAB4, 'X'),
+    (0xAB5, 'V'),
+    (0xABA, 'X'),
+    (0xABC, 'V'),
+    (0xAC6, 'X'),
+    (0xAC7, 'V'),
+    (0xACA, 'X'),
+    (0xACB, 'V'),
+    (0xACE, 'X'),
+    (0xAD0, 'V'),
+    (0xAD1, 'X'),
+    (0xAE0, 'V'),
+    (0xAE4, 'X'),
+    (0xAE6, 'V'),
+    (0xAF2, 'X'),
+    (0xAF9, 'V'),
+    (0xB00, 'X'),
+    (0xB01, 'V'),
+    (0xB04, 'X'),
+    (0xB05, 'V'),
+    (0xB0D, 'X'),
+    (0xB0F, 'V'),
+    (0xB11, 'X'),
+    (0xB13, 'V'),
+    (0xB29, 'X'),
+    (0xB2A, 'V'),
+    (0xB31, 'X'),
+    (0xB32, 'V'),
+    (0xB34, 'X'),
+    (0xB35, 'V'),
+    (0xB3A, 'X'),
+    (0xB3C, 'V'),
+    (0xB45, 'X'),
+    (0xB47, 'V'),
+    (0xB49, 'X'),
+    (0xB4B, 'V'),
+    (0xB4E, 'X'),
+    (0xB55, 'V'),
+    (0xB58, 'X'),
+    (0xB5C, 'M', u'ଡ଼'),
+    (0xB5D, 'M', u'ଢ଼'),
+    (0xB5E, 'X'),
+    (0xB5F, 'V'),
+    (0xB64, 'X'),
+    (0xB66, 'V'),
+    (0xB78, 'X'),
+    (0xB82, 'V'),
+    (0xB84, 'X'),
+    (0xB85, 'V'),
+    (0xB8B, 'X'),
+    (0xB8E, 'V'),
+    (0xB91, 'X'),
+    (0xB92, 'V'),
+    (0xB96, 'X'),
+    (0xB99, 'V'),
+    (0xB9B, 'X'),
+    (0xB9C, 'V'),
+    (0xB9D, 'X'),
+    (0xB9E, 'V'),
+    (0xBA0, 'X'),
+    (0xBA3, 'V'),
+    (0xBA5, 'X'),
+    (0xBA8, 'V'),
+    (0xBAB, 'X'),
+    (0xBAE, 'V'),
+    (0xBBA, 'X'),
+    (0xBBE, 'V'),
+    (0xBC3, 'X'),
+    (0xBC6, 'V'),
+    (0xBC9, 'X'),
+    (0xBCA, 'V'),
+    (0xBCE, 'X'),
+    (0xBD0, 'V'),
+    (0xBD1, 'X'),
+    (0xBD7, 'V'),
+    (0xBD8, 'X'),
+    (0xBE6, 'V'),
+    (0xBFB, 'X'),
+    (0xC00, 'V'),
+    (0xC0D, 'X'),
+    (0xC0E, 'V'),
+    (0xC11, 'X'),
+    (0xC12, 'V'),
+    ]
+
+def _seg_12():
+    return [
+    (0xC29, 'X'),
+    (0xC2A, 'V'),
+    (0xC3A, 'X'),
+    (0xC3D, 'V'),
+    (0xC45, 'X'),
+    (0xC46, 'V'),
+    (0xC49, 'X'),
+    (0xC4A, 'V'),
+    (0xC4E, 'X'),
+    (0xC55, 'V'),
+    (0xC57, 'X'),
+    (0xC58, 'V'),
+    (0xC5B, 'X'),
+    (0xC60, 'V'),
+    (0xC64, 'X'),
+    (0xC66, 'V'),
+    (0xC70, 'X'),
+    (0xC77, 'V'),
+    (0xC8D, 'X'),
+    (0xC8E, 'V'),
+    (0xC91, 'X'),
+    (0xC92, 'V'),
+    (0xCA9, 'X'),
+    (0xCAA, 'V'),
+    (0xCB4, 'X'),
+    (0xCB5, 'V'),
+    (0xCBA, 'X'),
+    (0xCBC, 'V'),
+    (0xCC5, 'X'),
+    (0xCC6, 'V'),
+    (0xCC9, 'X'),
+    (0xCCA, 'V'),
+    (0xCCE, 'X'),
+    (0xCD5, 'V'),
+    (0xCD7, 'X'),
+    (0xCDE, 'V'),
+    (0xCDF, 'X'),
+    (0xCE0, 'V'),
+    (0xCE4, 'X'),
+    (0xCE6, 'V'),
+    (0xCF0, 'X'),
+    (0xCF1, 'V'),
+    (0xCF3, 'X'),
+    (0xD00, 'V'),
+    (0xD0D, 'X'),
+    (0xD0E, 'V'),
+    (0xD11, 'X'),
+    (0xD12, 'V'),
+    (0xD45, 'X'),
+    (0xD46, 'V'),
+    (0xD49, 'X'),
+    (0xD4A, 'V'),
+    (0xD50, 'X'),
+    (0xD54, 'V'),
+    (0xD64, 'X'),
+    (0xD66, 'V'),
+    (0xD80, 'X'),
+    (0xD81, 'V'),
+    (0xD84, 'X'),
+    (0xD85, 'V'),
+    (0xD97, 'X'),
+    (0xD9A, 'V'),
+    (0xDB2, 'X'),
+    (0xDB3, 'V'),
+    (0xDBC, 'X'),
+    (0xDBD, 'V'),
+    (0xDBE, 'X'),
+    (0xDC0, 'V'),
+    (0xDC7, 'X'),
+    (0xDCA, 'V'),
+    (0xDCB, 'X'),
+    (0xDCF, 'V'),
+    (0xDD5, 'X'),
+    (0xDD6, 'V'),
+    (0xDD7, 'X'),
+    (0xDD8, 'V'),
+    (0xDE0, 'X'),
+    (0xDE6, 'V'),
+    (0xDF0, 'X'),
+    (0xDF2, 'V'),
+    (0xDF5, 'X'),
+    (0xE01, 'V'),
+    (0xE33, 'M', u'ํา'),
+    (0xE34, 'V'),
+    (0xE3B, 'X'),
+    (0xE3F, 'V'),
+    (0xE5C, 'X'),
+    (0xE81, 'V'),
+    (0xE83, 'X'),
+    (0xE84, 'V'),
+    (0xE85, 'X'),
+    (0xE86, 'V'),
+    (0xE8B, 'X'),
+    (0xE8C, 'V'),
+    (0xEA4, 'X'),
+    (0xEA5, 'V'),
+    (0xEA6, 'X'),
+    (0xEA7, 'V'),
+    (0xEB3, 'M', u'ໍາ'),
+    (0xEB4, 'V'),
+    ]
+
+def _seg_13():
+    return [
+    (0xEBE, 'X'),
+    (0xEC0, 'V'),
+    (0xEC5, 'X'),
+    (0xEC6, 'V'),
+    (0xEC7, 'X'),
+    (0xEC8, 'V'),
+    (0xECE, 'X'),
+    (0xED0, 'V'),
+    (0xEDA, 'X'),
+    (0xEDC, 'M', u'ຫນ'),
+    (0xEDD, 'M', u'ຫມ'),
+    (0xEDE, 'V'),
+    (0xEE0, 'X'),
+    (0xF00, 'V'),
+    (0xF0C, 'M', u'་'),
+    (0xF0D, 'V'),
+    (0xF43, 'M', u'གྷ'),
+    (0xF44, 'V'),
+    (0xF48, 'X'),
+    (0xF49, 'V'),
+    (0xF4D, 'M', u'ཌྷ'),
+    (0xF4E, 'V'),
+    (0xF52, 'M', u'དྷ'),
+    (0xF53, 'V'),
+    (0xF57, 'M', u'བྷ'),
+    (0xF58, 'V'),
+    (0xF5C, 'M', u'ཛྷ'),
+    (0xF5D, 'V'),
+    (0xF69, 'M', u'ཀྵ'),
+    (0xF6A, 'V'),
+    (0xF6D, 'X'),
+    (0xF71, 'V'),
+    (0xF73, 'M', u'ཱི'),
+    (0xF74, 'V'),
+    (0xF75, 'M', u'ཱུ'),
+    (0xF76, 'M', u'ྲྀ'),
+    (0xF77, 'M', u'ྲཱྀ'),
+    (0xF78, 'M', u'ླྀ'),
+    (0xF79, 'M', u'ླཱྀ'),
+    (0xF7A, 'V'),
+    (0xF81, 'M', u'ཱྀ'),
+    (0xF82, 'V'),
+    (0xF93, 'M', u'ྒྷ'),
+    (0xF94, 'V'),
+    (0xF98, 'X'),
+    (0xF99, 'V'),
+    (0xF9D, 'M', u'ྜྷ'),
+    (0xF9E, 'V'),
+    (0xFA2, 'M', u'ྡྷ'),
+    (0xFA3, 'V'),
+    (0xFA7, 'M', u'ྦྷ'),
+    (0xFA8, 'V'),
+    (0xFAC, 'M', u'ྫྷ'),
+    (0xFAD, 'V'),
+    (0xFB9, 'M', u'ྐྵ'),
+    (0xFBA, 'V'),
+    (0xFBD, 'X'),
+    (0xFBE, 'V'),
+    (0xFCD, 'X'),
+    (0xFCE, 'V'),
+    (0xFDB, 'X'),
+    (0x1000, 'V'),
+    (0x10A0, 'X'),
+    (0x10C7, 'M', u'ⴧ'),
+    (0x10C8, 'X'),
+    (0x10CD, 'M', u'ⴭ'),
+    (0x10CE, 'X'),
+    (0x10D0, 'V'),
+    (0x10FC, 'M', u'ნ'),
+    (0x10FD, 'V'),
+    (0x115F, 'X'),
+    (0x1161, 'V'),
+    (0x1249, 'X'),
+    (0x124A, 'V'),
+    (0x124E, 'X'),
+    (0x1250, 'V'),
+    (0x1257, 'X'),
+    (0x1258, 'V'),
+    (0x1259, 'X'),
+    (0x125A, 'V'),
+    (0x125E, 'X'),
+    (0x1260, 'V'),
+    (0x1289, 'X'),
+    (0x128A, 'V'),
+    (0x128E, 'X'),
+    (0x1290, 'V'),
+    (0x12B1, 'X'),
+    (0x12B2, 'V'),
+    (0x12B6, 'X'),
+    (0x12B8, 'V'),
+    (0x12BF, 'X'),
+    (0x12C0, 'V'),
+    (0x12C1, 'X'),
+    (0x12C2, 'V'),
+    (0x12C6, 'X'),
+    (0x12C8, 'V'),
+    (0x12D7, 'X'),
+    (0x12D8, 'V'),
+    (0x1311, 'X'),
+    (0x1312, 'V'),
+    ]
+
+def _seg_14():
+    return [
+    (0x1316, 'X'),
+    (0x1318, 'V'),
+    (0x135B, 'X'),
+    (0x135D, 'V'),
+    (0x137D, 'X'),
+    (0x1380, 'V'),
+    (0x139A, 'X'),
+    (0x13A0, 'V'),
+    (0x13F6, 'X'),
+    (0x13F8, 'M', u'Ᏸ'),
+    (0x13F9, 'M', u'Ᏹ'),
+    (0x13FA, 'M', u'Ᏺ'),
+    (0x13FB, 'M', u'Ᏻ'),
+    (0x13FC, 'M', u'Ᏼ'),
+    (0x13FD, 'M', u'Ᏽ'),
+    (0x13FE, 'X'),
+    (0x1400, 'V'),
+    (0x1680, 'X'),
+    (0x1681, 'V'),
+    (0x169D, 'X'),
+    (0x16A0, 'V'),
+    (0x16F9, 'X'),
+    (0x1700, 'V'),
+    (0x170D, 'X'),
+    (0x170E, 'V'),
+    (0x1715, 'X'),
+    (0x1720, 'V'),
+    (0x1737, 'X'),
+    (0x1740, 'V'),
+    (0x1754, 'X'),
+    (0x1760, 'V'),
+    (0x176D, 'X'),
+    (0x176E, 'V'),
+    (0x1771, 'X'),
+    (0x1772, 'V'),
+    (0x1774, 'X'),
+    (0x1780, 'V'),
+    (0x17B4, 'X'),
+    (0x17B6, 'V'),
+    (0x17DE, 'X'),
+    (0x17E0, 'V'),
+    (0x17EA, 'X'),
+    (0x17F0, 'V'),
+    (0x17FA, 'X'),
+    (0x1800, 'V'),
+    (0x1806, 'X'),
+    (0x1807, 'V'),
+    (0x180B, 'I'),
+    (0x180E, 'X'),
+    (0x1810, 'V'),
+    (0x181A, 'X'),
+    (0x1820, 'V'),
+    (0x1879, 'X'),
+    (0x1880, 'V'),
+    (0x18AB, 'X'),
+    (0x18B0, 'V'),
+    (0x18F6, 'X'),
+    (0x1900, 'V'),
+    (0x191F, 'X'),
+    (0x1920, 'V'),
+    (0x192C, 'X'),
+    (0x1930, 'V'),
+    (0x193C, 'X'),
+    (0x1940, 'V'),
+    (0x1941, 'X'),
+    (0x1944, 'V'),
+    (0x196E, 'X'),
+    (0x1970, 'V'),
+    (0x1975, 'X'),
+    (0x1980, 'V'),
+    (0x19AC, 'X'),
+    (0x19B0, 'V'),
+    (0x19CA, 'X'),
+    (0x19D0, 'V'),
+    (0x19DB, 'X'),
+    (0x19DE, 'V'),
+    (0x1A1C, 'X'),
+    (0x1A1E, 'V'),
+    (0x1A5F, 'X'),
+    (0x1A60, 'V'),
+    (0x1A7D, 'X'),
+    (0x1A7F, 'V'),
+    (0x1A8A, 'X'),
+    (0x1A90, 'V'),
+    (0x1A9A, 'X'),
+    (0x1AA0, 'V'),
+    (0x1AAE, 'X'),
+    (0x1AB0, 'V'),
+    (0x1AC1, 'X'),
+    (0x1B00, 'V'),
+    (0x1B4C, 'X'),
+    (0x1B50, 'V'),
+    (0x1B7D, 'X'),
+    (0x1B80, 'V'),
+    (0x1BF4, 'X'),
+    (0x1BFC, 'V'),
+    (0x1C38, 'X'),
+    (0x1C3B, 'V'),
+    (0x1C4A, 'X'),
+    (0x1C4D, 'V'),
+    ]
+
+def _seg_15():
+    return [
+    (0x1C80, 'M', u'в'),
+    (0x1C81, 'M', u'д'),
+    (0x1C82, 'M', u'о'),
+    (0x1C83, 'M', u'с'),
+    (0x1C84, 'M', u'т'),
+    (0x1C86, 'M', u'ъ'),
+    (0x1C87, 'M', u'ѣ'),
+    (0x1C88, 'M', u'ꙋ'),
+    (0x1C89, 'X'),
+    (0x1C90, 'M', u'ა'),
+    (0x1C91, 'M', u'ბ'),
+    (0x1C92, 'M', u'გ'),
+    (0x1C93, 'M', u'დ'),
+    (0x1C94, 'M', u'ე'),
+    (0x1C95, 'M', u'ვ'),
+    (0x1C96, 'M', u'ზ'),
+    (0x1C97, 'M', u'თ'),
+    (0x1C98, 'M', u'ი'),
+    (0x1C99, 'M', u'კ'),
+    (0x1C9A, 'M', u'ლ'),
+    (0x1C9B, 'M', u'მ'),
+    (0x1C9C, 'M', u'ნ'),
+    (0x1C9D, 'M', u'ო'),
+    (0x1C9E, 'M', u'პ'),
+    (0x1C9F, 'M', u'ჟ'),
+    (0x1CA0, 'M', u'რ'),
+    (0x1CA1, 'M', u'ს'),
+    (0x1CA2, 'M', u'ტ'),
+    (0x1CA3, 'M', u'უ'),
+    (0x1CA4, 'M', u'ფ'),
+    (0x1CA5, 'M', u'ქ'),
+    (0x1CA6, 'M', u'ღ'),
+    (0x1CA7, 'M', u'ყ'),
+    (0x1CA8, 'M', u'შ'),
+    (0x1CA9, 'M', u'ჩ'),
+    (0x1CAA, 'M', u'ც'),
+    (0x1CAB, 'M', u'ძ'),
+    (0x1CAC, 'M', u'წ'),
+    (0x1CAD, 'M', u'ჭ'),
+    (0x1CAE, 'M', u'ხ'),
+    (0x1CAF, 'M', u'ჯ'),
+    (0x1CB0, 'M', u'ჰ'),
+    (0x1CB1, 'M', u'ჱ'),
+    (0x1CB2, 'M', u'ჲ'),
+    (0x1CB3, 'M', u'ჳ'),
+    (0x1CB4, 'M', u'ჴ'),
+    (0x1CB5, 'M', u'ჵ'),
+    (0x1CB6, 'M', u'ჶ'),
+    (0x1CB7, 'M', u'ჷ'),
+    (0x1CB8, 'M', u'ჸ'),
+    (0x1CB9, 'M', u'ჹ'),
+    (0x1CBA, 'M', u'ჺ'),
+    (0x1CBB, 'X'),
+    (0x1CBD, 'M', u'ჽ'),
+    (0x1CBE, 'M', u'ჾ'),
+    (0x1CBF, 'M', u'ჿ'),
+    (0x1CC0, 'V'),
+    (0x1CC8, 'X'),
+    (0x1CD0, 'V'),
+    (0x1CFB, 'X'),
+    (0x1D00, 'V'),
+    (0x1D2C, 'M', u'a'),
+    (0x1D2D, 'M', u'æ'),
+    (0x1D2E, 'M', u'b'),
+    (0x1D2F, 'V'),
+    (0x1D30, 'M', u'd'),
+    (0x1D31, 'M', u'e'),
+    (0x1D32, 'M', u'ǝ'),
+    (0x1D33, 'M', u'g'),
+    (0x1D34, 'M', u'h'),
+    (0x1D35, 'M', u'i'),
+    (0x1D36, 'M', u'j'),
+    (0x1D37, 'M', u'k'),
+    (0x1D38, 'M', u'l'),
+    (0x1D39, 'M', u'm'),
+    (0x1D3A, 'M', u'n'),
+    (0x1D3B, 'V'),
+    (0x1D3C, 'M', u'o'),
+    (0x1D3D, 'M', u'ȣ'),
+    (0x1D3E, 'M', u'p'),
+    (0x1D3F, 'M', u'r'),
+    (0x1D40, 'M', u't'),
+    (0x1D41, 'M', u'u'),
+    (0x1D42, 'M', u'w'),
+    (0x1D43, 'M', u'a'),
+    (0x1D44, 'M', u'ɐ'),
+    (0x1D45, 'M', u'ɑ'),
+    (0x1D46, 'M', u'ᴂ'),
+    (0x1D47, 'M', u'b'),
+    (0x1D48, 'M', u'd'),
+    (0x1D49, 'M', u'e'),
+    (0x1D4A, 'M', u'ə'),
+    (0x1D4B, 'M', u'ɛ'),
+    (0x1D4C, 'M', u'ɜ'),
+    (0x1D4D, 'M', u'g'),
+    (0x1D4E, 'V'),
+    (0x1D4F, 'M', u'k'),
+    (0x1D50, 'M', u'm'),
+    (0x1D51, 'M', u'ŋ'),
+    (0x1D52, 'M', u'o'),
+    ]
+
+def _seg_16():
+    return [
+    (0x1D53, 'M', u'ɔ'),
+    (0x1D54, 'M', u'ᴖ'),
+    (0x1D55, 'M', u'ᴗ'),
+    (0x1D56, 'M', u'p'),
+    (0x1D57, 'M', u't'),
+    (0x1D58, 'M', u'u'),
+    (0x1D59, 'M', u'ᴝ'),
+    (0x1D5A, 'M', u'ɯ'),
+    (0x1D5B, 'M', u'v'),
+    (0x1D5C, 'M', u'ᴥ'),
+    (0x1D5D, 'M', u'β'),
+    (0x1D5E, 'M', u'γ'),
+    (0x1D5F, 'M', u'δ'),
+    (0x1D60, 'M', u'φ'),
+    (0x1D61, 'M', u'χ'),
+    (0x1D62, 'M', u'i'),
+    (0x1D63, 'M', u'r'),
+    (0x1D64, 'M', u'u'),
+    (0x1D65, 'M', u'v'),
+    (0x1D66, 'M', u'β'),
+    (0x1D67, 'M', u'γ'),
+    (0x1D68, 'M', u'ρ'),
+    (0x1D69, 'M', u'φ'),
+    (0x1D6A, 'M', u'χ'),
+    (0x1D6B, 'V'),
+    (0x1D78, 'M', u'н'),
+    (0x1D79, 'V'),
+    (0x1D9B, 'M', u'ɒ'),
+    (0x1D9C, 'M', u'c'),
+    (0x1D9D, 'M', u'ɕ'),
+    (0x1D9E, 'M', u'ð'),
+    (0x1D9F, 'M', u'ɜ'),
+    (0x1DA0, 'M', u'f'),
+    (0x1DA1, 'M', u'ɟ'),
+    (0x1DA2, 'M', u'ɡ'),
+    (0x1DA3, 'M', u'ɥ'),
+    (0x1DA4, 'M', u'ɨ'),
+    (0x1DA5, 'M', u'ɩ'),
+    (0x1DA6, 'M', u'ɪ'),
+    (0x1DA7, 'M', u'ᵻ'),
+    (0x1DA8, 'M', u'ʝ'),
+    (0x1DA9, 'M', u'ɭ'),
+    (0x1DAA, 'M', u'ᶅ'),
+    (0x1DAB, 'M', u'ʟ'),
+    (0x1DAC, 'M', u'ɱ'),
+    (0x1DAD, 'M', u'ɰ'),
+    (0x1DAE, 'M', u'ɲ'),
+    (0x1DAF, 'M', u'ɳ'),
+    (0x1DB0, 'M', u'ɴ'),
+    (0x1DB1, 'M', u'ɵ'),
+    (0x1DB2, 'M', u'ɸ'),
+    (0x1DB3, 'M', u'ʂ'),
+    (0x1DB4, 'M', u'ʃ'),
+    (0x1DB5, 'M', u'ƫ'),
+    (0x1DB6, 'M', u'ʉ'),
+    (0x1DB7, 'M', u'ʊ'),
+    (0x1DB8, 'M', u'ᴜ'),
+    (0x1DB9, 'M', u'ʋ'),
+    (0x1DBA, 'M', u'ʌ'),
+    (0x1DBB, 'M', u'z'),
+    (0x1DBC, 'M', u'ʐ'),
+    (0x1DBD, 'M', u'ʑ'),
+    (0x1DBE, 'M', u'ʒ'),
+    (0x1DBF, 'M', u'θ'),
+    (0x1DC0, 'V'),
+    (0x1DFA, 'X'),
+    (0x1DFB, 'V'),
+    (0x1E00, 'M', u'ḁ'),
+    (0x1E01, 'V'),
+    (0x1E02, 'M', u'ḃ'),
+    (0x1E03, 'V'),
+    (0x1E04, 'M', u'ḅ'),
+    (0x1E05, 'V'),
+    (0x1E06, 'M', u'ḇ'),
+    (0x1E07, 'V'),
+    (0x1E08, 'M', u'ḉ'),
+    (0x1E09, 'V'),
+    (0x1E0A, 'M', u'ḋ'),
+    (0x1E0B, 'V'),
+    (0x1E0C, 'M', u'ḍ'),
+    (0x1E0D, 'V'),
+    (0x1E0E, 'M', u'ḏ'),
+    (0x1E0F, 'V'),
+    (0x1E10, 'M', u'ḑ'),
+    (0x1E11, 'V'),
+    (0x1E12, 'M', u'ḓ'),
+    (0x1E13, 'V'),
+    (0x1E14, 'M', u'ḕ'),
+    (0x1E15, 'V'),
+    (0x1E16, 'M', u'ḗ'),
+    (0x1E17, 'V'),
+    (0x1E18, 'M', u'ḙ'),
+    (0x1E19, 'V'),
+    (0x1E1A, 'M', u'ḛ'),
+    (0x1E1B, 'V'),
+    (0x1E1C, 'M', u'ḝ'),
+    (0x1E1D, 'V'),
+    (0x1E1E, 'M', u'ḟ'),
+    (0x1E1F, 'V'),
+    (0x1E20, 'M', u'ḡ'),
+    ]
+
+def _seg_17():
+    return [
+    (0x1E21, 'V'),
+    (0x1E22, 'M', u'ḣ'),
+    (0x1E23, 'V'),
+    (0x1E24, 'M', u'ḥ'),
+    (0x1E25, 'V'),
+    (0x1E26, 'M', u'ḧ'),
+    (0x1E27, 'V'),
+    (0x1E28, 'M', u'ḩ'),
+    (0x1E29, 'V'),
+    (0x1E2A, 'M', u'ḫ'),
+    (0x1E2B, 'V'),
+    (0x1E2C, 'M', u'ḭ'),
+    (0x1E2D, 'V'),
+    (0x1E2E, 'M', u'ḯ'),
+    (0x1E2F, 'V'),
+    (0x1E30, 'M', u'ḱ'),
+    (0x1E31, 'V'),
+    (0x1E32, 'M', u'ḳ'),
+    (0x1E33, 'V'),
+    (0x1E34, 'M', u'ḵ'),
+    (0x1E35, 'V'),
+    (0x1E36, 'M', u'ḷ'),
+    (0x1E37, 'V'),
+    (0x1E38, 'M', u'ḹ'),
+    (0x1E39, 'V'),
+    (0x1E3A, 'M', u'ḻ'),
+    (0x1E3B, 'V'),
+    (0x1E3C, 'M', u'ḽ'),
+    (0x1E3D, 'V'),
+    (0x1E3E, 'M', u'ḿ'),
+    (0x1E3F, 'V'),
+    (0x1E40, 'M', u'ṁ'),
+    (0x1E41, 'V'),
+    (0x1E42, 'M', u'ṃ'),
+    (0x1E43, 'V'),
+    (0x1E44, 'M', u'ṅ'),
+    (0x1E45, 'V'),
+    (0x1E46, 'M', u'ṇ'),
+    (0x1E47, 'V'),
+    (0x1E48, 'M', u'ṉ'),
+    (0x1E49, 'V'),
+    (0x1E4A, 'M', u'ṋ'),
+    (0x1E4B, 'V'),
+    (0x1E4C, 'M', u'ṍ'),
+    (0x1E4D, 'V'),
+    (0x1E4E, 'M', u'ṏ'),
+    (0x1E4F, 'V'),
+    (0x1E50, 'M', u'ṑ'),
+    (0x1E51, 'V'),
+    (0x1E52, 'M', u'ṓ'),
+    (0x1E53, 'V'),
+    (0x1E54, 'M', u'ṕ'),
+    (0x1E55, 'V'),
+    (0x1E56, 'M', u'ṗ'),
+    (0x1E57, 'V'),
+    (0x1E58, 'M', u'ṙ'),
+    (0x1E59, 'V'),
+    (0x1E5A, 'M', u'ṛ'),
+    (0x1E5B, 'V'),
+    (0x1E5C, 'M', u'ṝ'),
+    (0x1E5D, 'V'),
+    (0x1E5E, 'M', u'ṟ'),
+    (0x1E5F, 'V'),
+    (0x1E60, 'M', u'ṡ'),
+    (0x1E61, 'V'),
+    (0x1E62, 'M', u'ṣ'),
+    (0x1E63, 'V'),
+    (0x1E64, 'M', u'ṥ'),
+    (0x1E65, 'V'),
+    (0x1E66, 'M', u'ṧ'),
+    (0x1E67, 'V'),
+    (0x1E68, 'M', u'ṩ'),
+    (0x1E69, 'V'),
+    (0x1E6A, 'M', u'ṫ'),
+    (0x1E6B, 'V'),
+    (0x1E6C, 'M', u'ṭ'),
+    (0x1E6D, 'V'),
+    (0x1E6E, 'M', u'ṯ'),
+    (0x1E6F, 'V'),
+    (0x1E70, 'M', u'ṱ'),
+    (0x1E71, 'V'),
+    (0x1E72, 'M', u'ṳ'),
+    (0x1E73, 'V'),
+    (0x1E74, 'M', u'ṵ'),
+    (0x1E75, 'V'),
+    (0x1E76, 'M', u'ṷ'),
+    (0x1E77, 'V'),
+    (0x1E78, 'M', u'ṹ'),
+    (0x1E79, 'V'),
+    (0x1E7A, 'M', u'ṻ'),
+    (0x1E7B, 'V'),
+    (0x1E7C, 'M', u'ṽ'),
+    (0x1E7D, 'V'),
+    (0x1E7E, 'M', u'ṿ'),
+    (0x1E7F, 'V'),
+    (0x1E80, 'M', u'ẁ'),
+    (0x1E81, 'V'),
+    (0x1E82, 'M', u'ẃ'),
+    (0x1E83, 'V'),
+    (0x1E84, 'M', u'ẅ'),
+    ]
+
+def _seg_18():
+    return [
+    (0x1E85, 'V'),
+    (0x1E86, 'M', u'ẇ'),
+    (0x1E87, 'V'),
+    (0x1E88, 'M', u'ẉ'),
+    (0x1E89, 'V'),
+    (0x1E8A, 'M', u'ẋ'),
+    (0x1E8B, 'V'),
+    (0x1E8C, 'M', u'ẍ'),
+    (0x1E8D, 'V'),
+    (0x1E8E, 'M', u'ẏ'),
+    (0x1E8F, 'V'),
+    (0x1E90, 'M', u'ẑ'),
+    (0x1E91, 'V'),
+    (0x1E92, 'M', u'ẓ'),
+    (0x1E93, 'V'),
+    (0x1E94, 'M', u'ẕ'),
+    (0x1E95, 'V'),
+    (0x1E9A, 'M', u'aʾ'),
+    (0x1E9B, 'M', u'ṡ'),
+    (0x1E9C, 'V'),
+    (0x1E9E, 'M', u'ss'),
+    (0x1E9F, 'V'),
+    (0x1EA0, 'M', u'ạ'),
+    (0x1EA1, 'V'),
+    (0x1EA2, 'M', u'ả'),
+    (0x1EA3, 'V'),
+    (0x1EA4, 'M', u'ấ'),
+    (0x1EA5, 'V'),
+    (0x1EA6, 'M', u'ầ'),
+    (0x1EA7, 'V'),
+    (0x1EA8, 'M', u'ẩ'),
+    (0x1EA9, 'V'),
+    (0x1EAA, 'M', u'ẫ'),
+    (0x1EAB, 'V'),
+    (0x1EAC, 'M', u'ậ'),
+    (0x1EAD, 'V'),
+    (0x1EAE, 'M', u'ắ'),
+    (0x1EAF, 'V'),
+    (0x1EB0, 'M', u'ằ'),
+    (0x1EB1, 'V'),
+    (0x1EB2, 'M', u'ẳ'),
+    (0x1EB3, 'V'),
+    (0x1EB4, 'M', u'ẵ'),
+    (0x1EB5, 'V'),
+    (0x1EB6, 'M', u'ặ'),
+    (0x1EB7, 'V'),
+    (0x1EB8, 'M', u'ẹ'),
+    (0x1EB9, 'V'),
+    (0x1EBA, 'M', u'ẻ'),
+    (0x1EBB, 'V'),
+    (0x1EBC, 'M', u'ẽ'),
+    (0x1EBD, 'V'),
+    (0x1EBE, 'M', u'ế'),
+    (0x1EBF, 'V'),
+    (0x1EC0, 'M', u'ề'),
+    (0x1EC1, 'V'),
+    (0x1EC2, 'M', u'ể'),
+    (0x1EC3, 'V'),
+    (0x1EC4, 'M', u'ễ'),
+    (0x1EC5, 'V'),
+    (0x1EC6, 'M', u'ệ'),
+    (0x1EC7, 'V'),
+    (0x1EC8, 'M', u'ỉ'),
+    (0x1EC9, 'V'),
+    (0x1ECA, 'M', u'ị'),
+    (0x1ECB, 'V'),
+    (0x1ECC, 'M', u'ọ'),
+    (0x1ECD, 'V'),
+    (0x1ECE, 'M', u'ỏ'),
+    (0x1ECF, 'V'),
+    (0x1ED0, 'M', u'ố'),
+    (0x1ED1, 'V'),
+    (0x1ED2, 'M', u'ồ'),
+    (0x1ED3, 'V'),
+    (0x1ED4, 'M', u'ổ'),
+    (0x1ED5, 'V'),
+    (0x1ED6, 'M', u'ỗ'),
+    (0x1ED7, 'V'),
+    (0x1ED8, 'M', u'ộ'),
+    (0x1ED9, 'V'),
+    (0x1EDA, 'M', u'ớ'),
+    (0x1EDB, 'V'),
+    (0x1EDC, 'M', u'ờ'),
+    (0x1EDD, 'V'),
+    (0x1EDE, 'M', u'ở'),
+    (0x1EDF, 'V'),
+    (0x1EE0, 'M', u'ỡ'),
+    (0x1EE1, 'V'),
+    (0x1EE2, 'M', u'ợ'),
+    (0x1EE3, 'V'),
+    (0x1EE4, 'M', u'ụ'),
+    (0x1EE5, 'V'),
+    (0x1EE6, 'M', u'ủ'),
+    (0x1EE7, 'V'),
+    (0x1EE8, 'M', u'ứ'),
+    (0x1EE9, 'V'),
+    (0x1EEA, 'M', u'ừ'),
+    (0x1EEB, 'V'),
+    (0x1EEC, 'M', u'ử'),
+    (0x1EED, 'V'),
+    ]
+
+def _seg_19():
+    return [
+    (0x1EEE, 'M', u'ữ'),
+    (0x1EEF, 'V'),
+    (0x1EF0, 'M', u'ự'),
+    (0x1EF1, 'V'),
+    (0x1EF2, 'M', u'ỳ'),
+    (0x1EF3, 'V'),
+    (0x1EF4, 'M', u'ỵ'),
+    (0x1EF5, 'V'),
+    (0x1EF6, 'M', u'ỷ'),
+    (0x1EF7, 'V'),
+    (0x1EF8, 'M', u'ỹ'),
+    (0x1EF9, 'V'),
+    (0x1EFA, 'M', u'ỻ'),
+    (0x1EFB, 'V'),
+    (0x1EFC, 'M', u'ỽ'),
+    (0x1EFD, 'V'),
+    (0x1EFE, 'M', u'ỿ'),
+    (0x1EFF, 'V'),
+    (0x1F08, 'M', u'ἀ'),
+    (0x1F09, 'M', u'ἁ'),
+    (0x1F0A, 'M', u'ἂ'),
+    (0x1F0B, 'M', u'ἃ'),
+    (0x1F0C, 'M', u'ἄ'),
+    (0x1F0D, 'M', u'ἅ'),
+    (0x1F0E, 'M', u'ἆ'),
+    (0x1F0F, 'M', u'ἇ'),
+    (0x1F10, 'V'),
+    (0x1F16, 'X'),
+    (0x1F18, 'M', u'ἐ'),
+    (0x1F19, 'M', u'ἑ'),
+    (0x1F1A, 'M', u'ἒ'),
+    (0x1F1B, 'M', u'ἓ'),
+    (0x1F1C, 'M', u'ἔ'),
+    (0x1F1D, 'M', u'ἕ'),
+    (0x1F1E, 'X'),
+    (0x1F20, 'V'),
+    (0x1F28, 'M', u'ἠ'),
+    (0x1F29, 'M', u'ἡ'),
+    (0x1F2A, 'M', u'ἢ'),
+    (0x1F2B, 'M', u'ἣ'),
+    (0x1F2C, 'M', u'ἤ'),
+    (0x1F2D, 'M', u'ἥ'),
+    (0x1F2E, 'M', u'ἦ'),
+    (0x1F2F, 'M', u'ἧ'),
+    (0x1F30, 'V'),
+    (0x1F38, 'M', u'ἰ'),
+    (0x1F39, 'M', u'ἱ'),
+    (0x1F3A, 'M', u'ἲ'),
+    (0x1F3B, 'M', u'ἳ'),
+    (0x1F3C, 'M', u'ἴ'),
+    (0x1F3D, 'M', u'ἵ'),
+    (0x1F3E, 'M', u'ἶ'),
+    (0x1F3F, 'M', u'ἷ'),
+    (0x1F40, 'V'),
+    (0x1F46, 'X'),
+    (0x1F48, 'M', u'ὀ'),
+    (0x1F49, 'M', u'ὁ'),
+    (0x1F4A, 'M', u'ὂ'),
+    (0x1F4B, 'M', u'ὃ'),
+    (0x1F4C, 'M', u'ὄ'),
+    (0x1F4D, 'M', u'ὅ'),
+    (0x1F4E, 'X'),
+    (0x1F50, 'V'),
+    (0x1F58, 'X'),
+    (0x1F59, 'M', u'ὑ'),
+    (0x1F5A, 'X'),
+    (0x1F5B, 'M', u'ὓ'),
+    (0x1F5C, 'X'),
+    (0x1F5D, 'M', u'ὕ'),
+    (0x1F5E, 'X'),
+    (0x1F5F, 'M', u'ὗ'),
+    (0x1F60, 'V'),
+    (0x1F68, 'M', u'ὠ'),
+    (0x1F69, 'M', u'ὡ'),
+    (0x1F6A, 'M', u'ὢ'),
+    (0x1F6B, 'M', u'ὣ'),
+    (0x1F6C, 'M', u'ὤ'),
+    (0x1F6D, 'M', u'ὥ'),
+    (0x1F6E, 'M', u'ὦ'),
+    (0x1F6F, 'M', u'ὧ'),
+    (0x1F70, 'V'),
+    (0x1F71, 'M', u'ά'),
+    (0x1F72, 'V'),
+    (0x1F73, 'M', u'έ'),
+    (0x1F74, 'V'),
+    (0x1F75, 'M', u'ή'),
+    (0x1F76, 'V'),
+    (0x1F77, 'M', u'ί'),
+    (0x1F78, 'V'),
+    (0x1F79, 'M', u'ό'),
+    (0x1F7A, 'V'),
+    (0x1F7B, 'M', u'ύ'),
+    (0x1F7C, 'V'),
+    (0x1F7D, 'M', u'ώ'),
+    (0x1F7E, 'X'),
+    (0x1F80, 'M', u'ἀι'),
+    (0x1F81, 'M', u'ἁι'),
+    (0x1F82, 'M', u'ἂι'),
+    (0x1F83, 'M', u'ἃι'),
+    (0x1F84, 'M', u'ἄι'),
+    ]
+
+def _seg_20():
+    return [
+    (0x1F85, 'M', u'ἅι'),
+    (0x1F86, 'M', u'ἆι'),
+    (0x1F87, 'M', u'ἇι'),
+    (0x1F88, 'M', u'ἀι'),
+    (0x1F89, 'M', u'ἁι'),
+    (0x1F8A, 'M', u'ἂι'),
+    (0x1F8B, 'M', u'ἃι'),
+    (0x1F8C, 'M', u'ἄι'),
+    (0x1F8D, 'M', u'ἅι'),
+    (0x1F8E, 'M', u'ἆι'),
+    (0x1F8F, 'M', u'ἇι'),
+    (0x1F90, 'M', u'ἠι'),
+    (0x1F91, 'M', u'ἡι'),
+    (0x1F92, 'M', u'ἢι'),
+    (0x1F93, 'M', u'ἣι'),
+    (0x1F94, 'M', u'ἤι'),
+    (0x1F95, 'M', u'ἥι'),
+    (0x1F96, 'M', u'ἦι'),
+    (0x1F97, 'M', u'ἧι'),
+    (0x1F98, 'M', u'ἠι'),
+    (0x1F99, 'M', u'ἡι'),
+    (0x1F9A, 'M', u'ἢι'),
+    (0x1F9B, 'M', u'ἣι'),
+    (0x1F9C, 'M', u'ἤι'),
+    (0x1F9D, 'M', u'ἥι'),
+    (0x1F9E, 'M', u'ἦι'),
+    (0x1F9F, 'M', u'ἧι'),
+    (0x1FA0, 'M', u'ὠι'),
+    (0x1FA1, 'M', u'ὡι'),
+    (0x1FA2, 'M', u'ὢι'),
+    (0x1FA3, 'M', u'ὣι'),
+    (0x1FA4, 'M', u'ὤι'),
+    (0x1FA5, 'M', u'ὥι'),
+    (0x1FA6, 'M', u'ὦι'),
+    (0x1FA7, 'M', u'ὧι'),
+    (0x1FA8, 'M', u'ὠι'),
+    (0x1FA9, 'M', u'ὡι'),
+    (0x1FAA, 'M', u'ὢι'),
+    (0x1FAB, 'M', u'ὣι'),
+    (0x1FAC, 'M', u'ὤι'),
+    (0x1FAD, 'M', u'ὥι'),
+    (0x1FAE, 'M', u'ὦι'),
+    (0x1FAF, 'M', u'ὧι'),
+    (0x1FB0, 'V'),
+    (0x1FB2, 'M', u'ὰι'),
+    (0x1FB3, 'M', u'αι'),
+    (0x1FB4, 'M', u'άι'),
+    (0x1FB5, 'X'),
+    (0x1FB6, 'V'),
+    (0x1FB7, 'M', u'ᾶι'),
+    (0x1FB8, 'M', u'ᾰ'),
+    (0x1FB9, 'M', u'ᾱ'),
+    (0x1FBA, 'M', u'ὰ'),
+    (0x1FBB, 'M', u'ά'),
+    (0x1FBC, 'M', u'αι'),
+    (0x1FBD, '3', u' ̓'),
+    (0x1FBE, 'M', u'ι'),
+    (0x1FBF, '3', u' ̓'),
+    (0x1FC0, '3', u' ͂'),
+    (0x1FC1, '3', u' ̈͂'),
+    (0x1FC2, 'M', u'ὴι'),
+    (0x1FC3, 'M', u'ηι'),
+    (0x1FC4, 'M', u'ήι'),
+    (0x1FC5, 'X'),
+    (0x1FC6, 'V'),
+    (0x1FC7, 'M', u'ῆι'),
+    (0x1FC8, 'M', u'ὲ'),
+    (0x1FC9, 'M', u'έ'),
+    (0x1FCA, 'M', u'ὴ'),
+    (0x1FCB, 'M', u'ή'),
+    (0x1FCC, 'M', u'ηι'),
+    (0x1FCD, '3', u' ̓̀'),
+    (0x1FCE, '3', u' ̓́'),
+    (0x1FCF, '3', u' ̓͂'),
+    (0x1FD0, 'V'),
+    (0x1FD3, 'M', u'ΐ'),
+    (0x1FD4, 'X'),
+    (0x1FD6, 'V'),
+    (0x1FD8, 'M', u'ῐ'),
+    (0x1FD9, 'M', u'ῑ'),
+    (0x1FDA, 'M', u'ὶ'),
+    (0x1FDB, 'M', u'ί'),
+    (0x1FDC, 'X'),
+    (0x1FDD, '3', u' ̔̀'),
+    (0x1FDE, '3', u' ̔́'),
+    (0x1FDF, '3', u' ̔͂'),
+    (0x1FE0, 'V'),
+    (0x1FE3, 'M', u'ΰ'),
+    (0x1FE4, 'V'),
+    (0x1FE8, 'M', u'ῠ'),
+    (0x1FE9, 'M', u'ῡ'),
+    (0x1FEA, 'M', u'ὺ'),
+    (0x1FEB, 'M', u'ύ'),
+    (0x1FEC, 'M', u'ῥ'),
+    (0x1FED, '3', u' ̈̀'),
+    (0x1FEE, '3', u' ̈́'),
+    (0x1FEF, '3', u'`'),
+    (0x1FF0, 'X'),
+    (0x1FF2, 'M', u'ὼι'),
+    (0x1FF3, 'M', u'ωι'),
+    ]
+
+def _seg_21():
+    return [
+    (0x1FF4, 'M', u'ώι'),
+    (0x1FF5, 'X'),
+    (0x1FF6, 'V'),
+    (0x1FF7, 'M', u'ῶι'),
+    (0x1FF8, 'M', u'ὸ'),
+    (0x1FF9, 'M', u'ό'),
+    (0x1FFA, 'M', u'ὼ'),
+    (0x1FFB, 'M', u'ώ'),
+    (0x1FFC, 'M', u'ωι'),
+    (0x1FFD, '3', u' ́'),
+    (0x1FFE, '3', u' ̔'),
+    (0x1FFF, 'X'),
+    (0x2000, '3', u' '),
+    (0x200B, 'I'),
+    (0x200C, 'D', u''),
+    (0x200E, 'X'),
+    (0x2010, 'V'),
+    (0x2011, 'M', u'‐'),
+    (0x2012, 'V'),
+    (0x2017, '3', u' ̳'),
+    (0x2018, 'V'),
+    (0x2024, 'X'),
+    (0x2027, 'V'),
+    (0x2028, 'X'),
+    (0x202F, '3', u' '),
+    (0x2030, 'V'),
+    (0x2033, 'M', u'′′'),
+    (0x2034, 'M', u'′′′'),
+    (0x2035, 'V'),
+    (0x2036, 'M', u'‵‵'),
+    (0x2037, 'M', u'‵‵‵'),
+    (0x2038, 'V'),
+    (0x203C, '3', u'!!'),
+    (0x203D, 'V'),
+    (0x203E, '3', u' ̅'),
+    (0x203F, 'V'),
+    (0x2047, '3', u'??'),
+    (0x2048, '3', u'?!'),
+    (0x2049, '3', u'!?'),
+    (0x204A, 'V'),
+    (0x2057, 'M', u'′′′′'),
+    (0x2058, 'V'),
+    (0x205F, '3', u' '),
+    (0x2060, 'I'),
+    (0x2061, 'X'),
+    (0x2064, 'I'),
+    (0x2065, 'X'),
+    (0x2070, 'M', u'0'),
+    (0x2071, 'M', u'i'),
+    (0x2072, 'X'),
+    (0x2074, 'M', u'4'),
+    (0x2075, 'M', u'5'),
+    (0x2076, 'M', u'6'),
+    (0x2077, 'M', u'7'),
+    (0x2078, 'M', u'8'),
+    (0x2079, 'M', u'9'),
+    (0x207A, '3', u'+'),
+    (0x207B, 'M', u'−'),
+    (0x207C, '3', u'='),
+    (0x207D, '3', u'('),
+    (0x207E, '3', u')'),
+    (0x207F, 'M', u'n'),
+    (0x2080, 'M', u'0'),
+    (0x2081, 'M', u'1'),
+    (0x2082, 'M', u'2'),
+    (0x2083, 'M', u'3'),
+    (0x2084, 'M', u'4'),
+    (0x2085, 'M', u'5'),
+    (0x2086, 'M', u'6'),
+    (0x2087, 'M', u'7'),
+    (0x2088, 'M', u'8'),
+    (0x2089, 'M', u'9'),
+    (0x208A, '3', u'+'),
+    (0x208B, 'M', u'−'),
+    (0x208C, '3', u'='),
+    (0x208D, '3', u'('),
+    (0x208E, '3', u')'),
+    (0x208F, 'X'),
+    (0x2090, 'M', u'a'),
+    (0x2091, 'M', u'e'),
+    (0x2092, 'M', u'o'),
+    (0x2093, 'M', u'x'),
+    (0x2094, 'M', u'ə'),
+    (0x2095, 'M', u'h'),
+    (0x2096, 'M', u'k'),
+    (0x2097, 'M', u'l'),
+    (0x2098, 'M', u'm'),
+    (0x2099, 'M', u'n'),
+    (0x209A, 'M', u'p'),
+    (0x209B, 'M', u's'),
+    (0x209C, 'M', u't'),
+    (0x209D, 'X'),
+    (0x20A0, 'V'),
+    (0x20A8, 'M', u'rs'),
+    (0x20A9, 'V'),
+    (0x20C0, 'X'),
+    (0x20D0, 'V'),
+    (0x20F1, 'X'),
+    (0x2100, '3', u'a/c'),
+    (0x2101, '3', u'a/s'),
+    ]
+
+def _seg_22():
+    return [
+    (0x2102, 'M', u'c'),
+    (0x2103, 'M', u'°c'),
+    (0x2104, 'V'),
+    (0x2105, '3', u'c/o'),
+    (0x2106, '3', u'c/u'),
+    (0x2107, 'M', u'ɛ'),
+    (0x2108, 'V'),
+    (0x2109, 'M', u'°f'),
+    (0x210A, 'M', u'g'),
+    (0x210B, 'M', u'h'),
+    (0x210F, 'M', u'ħ'),
+    (0x2110, 'M', u'i'),
+    (0x2112, 'M', u'l'),
+    (0x2114, 'V'),
+    (0x2115, 'M', u'n'),
+    (0x2116, 'M', u'no'),
+    (0x2117, 'V'),
+    (0x2119, 'M', u'p'),
+    (0x211A, 'M', u'q'),
+    (0x211B, 'M', u'r'),
+    (0x211E, 'V'),
+    (0x2120, 'M', u'sm'),
+    (0x2121, 'M', u'tel'),
+    (0x2122, 'M', u'tm'),
+    (0x2123, 'V'),
+    (0x2124, 'M', u'z'),
+    (0x2125, 'V'),
+    (0x2126, 'M', u'ω'),
+    (0x2127, 'V'),
+    (0x2128, 'M', u'z'),
+    (0x2129, 'V'),
+    (0x212A, 'M', u'k'),
+    (0x212B, 'M', u'å'),
+    (0x212C, 'M', u'b'),
+    (0x212D, 'M', u'c'),
+    (0x212E, 'V'),
+    (0x212F, 'M', u'e'),
+    (0x2131, 'M', u'f'),
+    (0x2132, 'X'),
+    (0x2133, 'M', u'm'),
+    (0x2134, 'M', u'o'),
+    (0x2135, 'M', u'א'),
+    (0x2136, 'M', u'ב'),
+    (0x2137, 'M', u'ג'),
+    (0x2138, 'M', u'ד'),
+    (0x2139, 'M', u'i'),
+    (0x213A, 'V'),
+    (0x213B, 'M', u'fax'),
+    (0x213C, 'M', u'π'),
+    (0x213D, 'M', u'γ'),
+    (0x213F, 'M', u'π'),
+    (0x2140, 'M', u'∑'),
+    (0x2141, 'V'),
+    (0x2145, 'M', u'd'),
+    (0x2147, 'M', u'e'),
+    (0x2148, 'M', u'i'),
+    (0x2149, 'M', u'j'),
+    (0x214A, 'V'),
+    (0x2150, 'M', u'1⁄7'),
+    (0x2151, 'M', u'1⁄9'),
+    (0x2152, 'M', u'1⁄10'),
+    (0x2153, 'M', u'1⁄3'),
+    (0x2154, 'M', u'2⁄3'),
+    (0x2155, 'M', u'1⁄5'),
+    (0x2156, 'M', u'2⁄5'),
+    (0x2157, 'M', u'3⁄5'),
+    (0x2158, 'M', u'4⁄5'),
+    (0x2159, 'M', u'1⁄6'),
+    (0x215A, 'M', u'5⁄6'),
+    (0x215B, 'M', u'1⁄8'),
+    (0x215C, 'M', u'3⁄8'),
+    (0x215D, 'M', u'5⁄8'),
+    (0x215E, 'M', u'7⁄8'),
+    (0x215F, 'M', u'1⁄'),
+    (0x2160, 'M', u'i'),
+    (0x2161, 'M', u'ii'),
+    (0x2162, 'M', u'iii'),
+    (0x2163, 'M', u'iv'),
+    (0x2164, 'M', u'v'),
+    (0x2165, 'M', u'vi'),
+    (0x2166, 'M', u'vii'),
+    (0x2167, 'M', u'viii'),
+    (0x2168, 'M', u'ix'),
+    (0x2169, 'M', u'x'),
+    (0x216A, 'M', u'xi'),
+    (0x216B, 'M', u'xii'),
+    (0x216C, 'M', u'l'),
+    (0x216D, 'M', u'c'),
+    (0x216E, 'M', u'd'),
+    (0x216F, 'M', u'm'),
+    (0x2170, 'M', u'i'),
+    (0x2171, 'M', u'ii'),
+    (0x2172, 'M', u'iii'),
+    (0x2173, 'M', u'iv'),
+    (0x2174, 'M', u'v'),
+    (0x2175, 'M', u'vi'),
+    (0x2176, 'M', u'vii'),
+    (0x2177, 'M', u'viii'),
+    (0x2178, 'M', u'ix'),
+    (0x2179, 'M', u'x'),
+    ]
+
+def _seg_23():
+    return [
+    (0x217A, 'M', u'xi'),
+    (0x217B, 'M', u'xii'),
+    (0x217C, 'M', u'l'),
+    (0x217D, 'M', u'c'),
+    (0x217E, 'M', u'd'),
+    (0x217F, 'M', u'm'),
+    (0x2180, 'V'),
+    (0x2183, 'X'),
+    (0x2184, 'V'),
+    (0x2189, 'M', u'0⁄3'),
+    (0x218A, 'V'),
+    (0x218C, 'X'),
+    (0x2190, 'V'),
+    (0x222C, 'M', u'∫∫'),
+    (0x222D, 'M', u'∫∫∫'),
+    (0x222E, 'V'),
+    (0x222F, 'M', u'∮∮'),
+    (0x2230, 'M', u'∮∮∮'),
+    (0x2231, 'V'),
+    (0x2260, '3'),
+    (0x2261, 'V'),
+    (0x226E, '3'),
+    (0x2270, 'V'),
+    (0x2329, 'M', u'〈'),
+    (0x232A, 'M', u'〉'),
+    (0x232B, 'V'),
+    (0x2427, 'X'),
+    (0x2440, 'V'),
+    (0x244B, 'X'),
+    (0x2460, 'M', u'1'),
+    (0x2461, 'M', u'2'),
+    (0x2462, 'M', u'3'),
+    (0x2463, 'M', u'4'),
+    (0x2464, 'M', u'5'),
+    (0x2465, 'M', u'6'),
+    (0x2466, 'M', u'7'),
+    (0x2467, 'M', u'8'),
+    (0x2468, 'M', u'9'),
+    (0x2469, 'M', u'10'),
+    (0x246A, 'M', u'11'),
+    (0x246B, 'M', u'12'),
+    (0x246C, 'M', u'13'),
+    (0x246D, 'M', u'14'),
+    (0x246E, 'M', u'15'),
+    (0x246F, 'M', u'16'),
+    (0x2470, 'M', u'17'),
+    (0x2471, 'M', u'18'),
+    (0x2472, 'M', u'19'),
+    (0x2473, 'M', u'20'),
+    (0x2474, '3', u'(1)'),
+    (0x2475, '3', u'(2)'),
+    (0x2476, '3', u'(3)'),
+    (0x2477, '3', u'(4)'),
+    (0x2478, '3', u'(5)'),
+    (0x2479, '3', u'(6)'),
+    (0x247A, '3', u'(7)'),
+    (0x247B, '3', u'(8)'),
+    (0x247C, '3', u'(9)'),
+    (0x247D, '3', u'(10)'),
+    (0x247E, '3', u'(11)'),
+    (0x247F, '3', u'(12)'),
+    (0x2480, '3', u'(13)'),
+    (0x2481, '3', u'(14)'),
+    (0x2482, '3', u'(15)'),
+    (0x2483, '3', u'(16)'),
+    (0x2484, '3', u'(17)'),
+    (0x2485, '3', u'(18)'),
+    (0x2486, '3', u'(19)'),
+    (0x2487, '3', u'(20)'),
+    (0x2488, 'X'),
+    (0x249C, '3', u'(a)'),
+    (0x249D, '3', u'(b)'),
+    (0x249E, '3', u'(c)'),
+    (0x249F, '3', u'(d)'),
+    (0x24A0, '3', u'(e)'),
+    (0x24A1, '3', u'(f)'),
+    (0x24A2, '3', u'(g)'),
+    (0x24A3, '3', u'(h)'),
+    (0x24A4, '3', u'(i)'),
+    (0x24A5, '3', u'(j)'),
+    (0x24A6, '3', u'(k)'),
+    (0x24A7, '3', u'(l)'),
+    (0x24A8, '3', u'(m)'),
+    (0x24A9, '3', u'(n)'),
+    (0x24AA, '3', u'(o)'),
+    (0x24AB, '3', u'(p)'),
+    (0x24AC, '3', u'(q)'),
+    (0x24AD, '3', u'(r)'),
+    (0x24AE, '3', u'(s)'),
+    (0x24AF, '3', u'(t)'),
+    (0x24B0, '3', u'(u)'),
+    (0x24B1, '3', u'(v)'),
+    (0x24B2, '3', u'(w)'),
+    (0x24B3, '3', u'(x)'),
+    (0x24B4, '3', u'(y)'),
+    (0x24B5, '3', u'(z)'),
+    (0x24B6, 'M', u'a'),
+    (0x24B7, 'M', u'b'),
+    (0x24B8, 'M', u'c'),
+    (0x24B9, 'M', u'd'),
+    ]
+
+def _seg_24():
+    return [
+    (0x24BA, 'M', u'e'),
+    (0x24BB, 'M', u'f'),
+    (0x24BC, 'M', u'g'),
+    (0x24BD, 'M', u'h'),
+    (0x24BE, 'M', u'i'),
+    (0x24BF, 'M', u'j'),
+    (0x24C0, 'M', u'k'),
+    (0x24C1, 'M', u'l'),
+    (0x24C2, 'M', u'm'),
+    (0x24C3, 'M', u'n'),
+    (0x24C4, 'M', u'o'),
+    (0x24C5, 'M', u'p'),
+    (0x24C6, 'M', u'q'),
+    (0x24C7, 'M', u'r'),
+    (0x24C8, 'M', u's'),
+    (0x24C9, 'M', u't'),
+    (0x24CA, 'M', u'u'),
+    (0x24CB, 'M', u'v'),
+    (0x24CC, 'M', u'w'),
+    (0x24CD, 'M', u'x'),
+    (0x24CE, 'M', u'y'),
+    (0x24CF, 'M', u'z'),
+    (0x24D0, 'M', u'a'),
+    (0x24D1, 'M', u'b'),
+    (0x24D2, 'M', u'c'),
+    (0x24D3, 'M', u'd'),
+    (0x24D4, 'M', u'e'),
+    (0x24D5, 'M', u'f'),
+    (0x24D6, 'M', u'g'),
+    (0x24D7, 'M', u'h'),
+    (0x24D8, 'M', u'i'),
+    (0x24D9, 'M', u'j'),
+    (0x24DA, 'M', u'k'),
+    (0x24DB, 'M', u'l'),
+    (0x24DC, 'M', u'm'),
+    (0x24DD, 'M', u'n'),
+    (0x24DE, 'M', u'o'),
+    (0x24DF, 'M', u'p'),
+    (0x24E0, 'M', u'q'),
+    (0x24E1, 'M', u'r'),
+    (0x24E2, 'M', u's'),
+    (0x24E3, 'M', u't'),
+    (0x24E4, 'M', u'u'),
+    (0x24E5, 'M', u'v'),
+    (0x24E6, 'M', u'w'),
+    (0x24E7, 'M', u'x'),
+    (0x24E8, 'M', u'y'),
+    (0x24E9, 'M', u'z'),
+    (0x24EA, 'M', u'0'),
+    (0x24EB, 'V'),
+    (0x2A0C, 'M', u'∫∫∫∫'),
+    (0x2A0D, 'V'),
+    (0x2A74, '3', u'::='),
+    (0x2A75, '3', u'=='),
+    (0x2A76, '3', u'==='),
+    (0x2A77, 'V'),
+    (0x2ADC, 'M', u'⫝̸'),
+    (0x2ADD, 'V'),
+    (0x2B74, 'X'),
+    (0x2B76, 'V'),
+    (0x2B96, 'X'),
+    (0x2B97, 'V'),
+    (0x2C00, 'M', u'ⰰ'),
+    (0x2C01, 'M', u'ⰱ'),
+    (0x2C02, 'M', u'ⰲ'),
+    (0x2C03, 'M', u'ⰳ'),
+    (0x2C04, 'M', u'ⰴ'),
+    (0x2C05, 'M', u'ⰵ'),
+    (0x2C06, 'M', u'ⰶ'),
+    (0x2C07, 'M', u'ⰷ'),
+    (0x2C08, 'M', u'ⰸ'),
+    (0x2C09, 'M', u'ⰹ'),
+    (0x2C0A, 'M', u'ⰺ'),
+    (0x2C0B, 'M', u'ⰻ'),
+    (0x2C0C, 'M', u'ⰼ'),
+    (0x2C0D, 'M', u'ⰽ'),
+    (0x2C0E, 'M', u'ⰾ'),
+    (0x2C0F, 'M', u'ⰿ'),
+    (0x2C10, 'M', u'ⱀ'),
+    (0x2C11, 'M', u'ⱁ'),
+    (0x2C12, 'M', u'ⱂ'),
+    (0x2C13, 'M', u'ⱃ'),
+    (0x2C14, 'M', u'ⱄ'),
+    (0x2C15, 'M', u'ⱅ'),
+    (0x2C16, 'M', u'ⱆ'),
+    (0x2C17, 'M', u'ⱇ'),
+    (0x2C18, 'M', u'ⱈ'),
+    (0x2C19, 'M', u'ⱉ'),
+    (0x2C1A, 'M', u'ⱊ'),
+    (0x2C1B, 'M', u'ⱋ'),
+    (0x2C1C, 'M', u'ⱌ'),
+    (0x2C1D, 'M', u'ⱍ'),
+    (0x2C1E, 'M', u'ⱎ'),
+    (0x2C1F, 'M', u'ⱏ'),
+    (0x2C20, 'M', u'ⱐ'),
+    (0x2C21, 'M', u'ⱑ'),
+    (0x2C22, 'M', u'ⱒ'),
+    (0x2C23, 'M', u'ⱓ'),
+    (0x2C24, 'M', u'ⱔ'),
+    (0x2C25, 'M', u'ⱕ'),
+    ]
+
+def _seg_25():
+    return [
+    (0x2C26, 'M', u'ⱖ'),
+    (0x2C27, 'M', u'ⱗ'),
+    (0x2C28, 'M', u'ⱘ'),
+    (0x2C29, 'M', u'ⱙ'),
+    (0x2C2A, 'M', u'ⱚ'),
+    (0x2C2B, 'M', u'ⱛ'),
+    (0x2C2C, 'M', u'ⱜ'),
+    (0x2C2D, 'M', u'ⱝ'),
+    (0x2C2E, 'M', u'ⱞ'),
+    (0x2C2F, 'X'),
+    (0x2C30, 'V'),
+    (0x2C5F, 'X'),
+    (0x2C60, 'M', u'ⱡ'),
+    (0x2C61, 'V'),
+    (0x2C62, 'M', u'ɫ'),
+    (0x2C63, 'M', u'ᵽ'),
+    (0x2C64, 'M', u'ɽ'),
+    (0x2C65, 'V'),
+    (0x2C67, 'M', u'ⱨ'),
+    (0x2C68, 'V'),
+    (0x2C69, 'M', u'ⱪ'),
+    (0x2C6A, 'V'),
+    (0x2C6B, 'M', u'ⱬ'),
+    (0x2C6C, 'V'),
+    (0x2C6D, 'M', u'ɑ'),
+    (0x2C6E, 'M', u'ɱ'),
+    (0x2C6F, 'M', u'ɐ'),
+    (0x2C70, 'M', u'ɒ'),
+    (0x2C71, 'V'),
+    (0x2C72, 'M', u'ⱳ'),
+    (0x2C73, 'V'),
+    (0x2C75, 'M', u'ⱶ'),
+    (0x2C76, 'V'),
+    (0x2C7C, 'M', u'j'),
+    (0x2C7D, 'M', u'v'),
+    (0x2C7E, 'M', u'ȿ'),
+    (0x2C7F, 'M', u'ɀ'),
+    (0x2C80, 'M', u'ⲁ'),
+    (0x2C81, 'V'),
+    (0x2C82, 'M', u'ⲃ'),
+    (0x2C83, 'V'),
+    (0x2C84, 'M', u'ⲅ'),
+    (0x2C85, 'V'),
+    (0x2C86, 'M', u'ⲇ'),
+    (0x2C87, 'V'),
+    (0x2C88, 'M', u'ⲉ'),
+    (0x2C89, 'V'),
+    (0x2C8A, 'M', u'ⲋ'),
+    (0x2C8B, 'V'),
+    (0x2C8C, 'M', u'ⲍ'),
+    (0x2C8D, 'V'),
+    (0x2C8E, 'M', u'ⲏ'),
+    (0x2C8F, 'V'),
+    (0x2C90, 'M', u'ⲑ'),
+    (0x2C91, 'V'),
+    (0x2C92, 'M', u'ⲓ'),
+    (0x2C93, 'V'),
+    (0x2C94, 'M', u'ⲕ'),
+    (0x2C95, 'V'),
+    (0x2C96, 'M', u'ⲗ'),
+    (0x2C97, 'V'),
+    (0x2C98, 'M', u'ⲙ'),
+    (0x2C99, 'V'),
+    (0x2C9A, 'M', u'ⲛ'),
+    (0x2C9B, 'V'),
+    (0x2C9C, 'M', u'ⲝ'),
+    (0x2C9D, 'V'),
+    (0x2C9E, 'M', u'ⲟ'),
+    (0x2C9F, 'V'),
+    (0x2CA0, 'M', u'ⲡ'),
+    (0x2CA1, 'V'),
+    (0x2CA2, 'M', u'ⲣ'),
+    (0x2CA3, 'V'),
+    (0x2CA4, 'M', u'ⲥ'),
+    (0x2CA5, 'V'),
+    (0x2CA6, 'M', u'ⲧ'),
+    (0x2CA7, 'V'),
+    (0x2CA8, 'M', u'ⲩ'),
+    (0x2CA9, 'V'),
+    (0x2CAA, 'M', u'ⲫ'),
+    (0x2CAB, 'V'),
+    (0x2CAC, 'M', u'ⲭ'),
+    (0x2CAD, 'V'),
+    (0x2CAE, 'M', u'ⲯ'),
+    (0x2CAF, 'V'),
+    (0x2CB0, 'M', u'ⲱ'),
+    (0x2CB1, 'V'),
+    (0x2CB2, 'M', u'ⲳ'),
+    (0x2CB3, 'V'),
+    (0x2CB4, 'M', u'ⲵ'),
+    (0x2CB5, 'V'),
+    (0x2CB6, 'M', u'ⲷ'),
+    (0x2CB7, 'V'),
+    (0x2CB8, 'M', u'ⲹ'),
+    (0x2CB9, 'V'),
+    (0x2CBA, 'M', u'ⲻ'),
+    (0x2CBB, 'V'),
+    (0x2CBC, 'M', u'ⲽ'),
+    (0x2CBD, 'V'),
+    (0x2CBE, 'M', u'ⲿ'),
+    ]
+
+def _seg_26():
+    return [
+    (0x2CBF, 'V'),
+    (0x2CC0, 'M', u'ⳁ'),
+    (0x2CC1, 'V'),
+    (0x2CC2, 'M', u'ⳃ'),
+    (0x2CC3, 'V'),
+    (0x2CC4, 'M', u'ⳅ'),
+    (0x2CC5, 'V'),
+    (0x2CC6, 'M', u'ⳇ'),
+    (0x2CC7, 'V'),
+    (0x2CC8, 'M', u'ⳉ'),
+    (0x2CC9, 'V'),
+    (0x2CCA, 'M', u'ⳋ'),
+    (0x2CCB, 'V'),
+    (0x2CCC, 'M', u'ⳍ'),
+    (0x2CCD, 'V'),
+    (0x2CCE, 'M', u'ⳏ'),
+    (0x2CCF, 'V'),
+    (0x2CD0, 'M', u'ⳑ'),
+    (0x2CD1, 'V'),
+    (0x2CD2, 'M', u'ⳓ'),
+    (0x2CD3, 'V'),
+    (0x2CD4, 'M', u'ⳕ'),
+    (0x2CD5, 'V'),
+    (0x2CD6, 'M', u'ⳗ'),
+    (0x2CD7, 'V'),
+    (0x2CD8, 'M', u'ⳙ'),
+    (0x2CD9, 'V'),
+    (0x2CDA, 'M', u'ⳛ'),
+    (0x2CDB, 'V'),
+    (0x2CDC, 'M', u'ⳝ'),
+    (0x2CDD, 'V'),
+    (0x2CDE, 'M', u'ⳟ'),
+    (0x2CDF, 'V'),
+    (0x2CE0, 'M', u'ⳡ'),
+    (0x2CE1, 'V'),
+    (0x2CE2, 'M', u'ⳣ'),
+    (0x2CE3, 'V'),
+    (0x2CEB, 'M', u'ⳬ'),
+    (0x2CEC, 'V'),
+    (0x2CED, 'M', u'ⳮ'),
+    (0x2CEE, 'V'),
+    (0x2CF2, 'M', u'ⳳ'),
+    (0x2CF3, 'V'),
+    (0x2CF4, 'X'),
+    (0x2CF9, 'V'),
+    (0x2D26, 'X'),
+    (0x2D27, 'V'),
+    (0x2D28, 'X'),
+    (0x2D2D, 'V'),
+    (0x2D2E, 'X'),
+    (0x2D30, 'V'),
+    (0x2D68, 'X'),
+    (0x2D6F, 'M', u'ⵡ'),
+    (0x2D70, 'V'),
+    (0x2D71, 'X'),
+    (0x2D7F, 'V'),
+    (0x2D97, 'X'),
+    (0x2DA0, 'V'),
+    (0x2DA7, 'X'),
+    (0x2DA8, 'V'),
+    (0x2DAF, 'X'),
+    (0x2DB0, 'V'),
+    (0x2DB7, 'X'),
+    (0x2DB8, 'V'),
+    (0x2DBF, 'X'),
+    (0x2DC0, 'V'),
+    (0x2DC7, 'X'),
+    (0x2DC8, 'V'),
+    (0x2DCF, 'X'),
+    (0x2DD0, 'V'),
+    (0x2DD7, 'X'),
+    (0x2DD8, 'V'),
+    (0x2DDF, 'X'),
+    (0x2DE0, 'V'),
+    (0x2E53, 'X'),
+    (0x2E80, 'V'),
+    (0x2E9A, 'X'),
+    (0x2E9B, 'V'),
+    (0x2E9F, 'M', u'母'),
+    (0x2EA0, 'V'),
+    (0x2EF3, 'M', u'龟'),
+    (0x2EF4, 'X'),
+    (0x2F00, 'M', u'一'),
+    (0x2F01, 'M', u'丨'),
+    (0x2F02, 'M', u'丶'),
+    (0x2F03, 'M', u'丿'),
+    (0x2F04, 'M', u'乙'),
+    (0x2F05, 'M', u'亅'),
+    (0x2F06, 'M', u'二'),
+    (0x2F07, 'M', u'亠'),
+    (0x2F08, 'M', u'人'),
+    (0x2F09, 'M', u'儿'),
+    (0x2F0A, 'M', u'入'),
+    (0x2F0B, 'M', u'八'),
+    (0x2F0C, 'M', u'冂'),
+    (0x2F0D, 'M', u'冖'),
+    (0x2F0E, 'M', u'冫'),
+    (0x2F0F, 'M', u'几'),
+    (0x2F10, 'M', u'凵'),
+    (0x2F11, 'M', u'刀'),
+    ]
+
+def _seg_27():
+    return [
+    (0x2F12, 'M', u'力'),
+    (0x2F13, 'M', u'勹'),
+    (0x2F14, 'M', u'匕'),
+    (0x2F15, 'M', u'匚'),
+    (0x2F16, 'M', u'匸'),
+    (0x2F17, 'M', u'十'),
+    (0x2F18, 'M', u'卜'),
+    (0x2F19, 'M', u'卩'),
+    (0x2F1A, 'M', u'厂'),
+    (0x2F1B, 'M', u'厶'),
+    (0x2F1C, 'M', u'又'),
+    (0x2F1D, 'M', u'口'),
+    (0x2F1E, 'M', u'囗'),
+    (0x2F1F, 'M', u'土'),
+    (0x2F20, 'M', u'士'),
+    (0x2F21, 'M', u'夂'),
+    (0x2F22, 'M', u'夊'),
+    (0x2F23, 'M', u'夕'),
+    (0x2F24, 'M', u'大'),
+    (0x2F25, 'M', u'女'),
+    (0x2F26, 'M', u'子'),
+    (0x2F27, 'M', u'宀'),
+    (0x2F28, 'M', u'寸'),
+    (0x2F29, 'M', u'小'),
+    (0x2F2A, 'M', u'尢'),
+    (0x2F2B, 'M', u'尸'),
+    (0x2F2C, 'M', u'屮'),
+    (0x2F2D, 'M', u'山'),
+    (0x2F2E, 'M', u'巛'),
+    (0x2F2F, 'M', u'工'),
+    (0x2F30, 'M', u'己'),
+    (0x2F31, 'M', u'巾'),
+    (0x2F32, 'M', u'干'),
+    (0x2F33, 'M', u'幺'),
+    (0x2F34, 'M', u'广'),
+    (0x2F35, 'M', u'廴'),
+    (0x2F36, 'M', u'廾'),
+    (0x2F37, 'M', u'弋'),
+    (0x2F38, 'M', u'弓'),
+    (0x2F39, 'M', u'彐'),
+    (0x2F3A, 'M', u'彡'),
+    (0x2F3B, 'M', u'彳'),
+    (0x2F3C, 'M', u'心'),
+    (0x2F3D, 'M', u'戈'),
+    (0x2F3E, 'M', u'戶'),
+    (0x2F3F, 'M', u'手'),
+    (0x2F40, 'M', u'支'),
+    (0x2F41, 'M', u'攴'),
+    (0x2F42, 'M', u'文'),
+    (0x2F43, 'M', u'斗'),
+    (0x2F44, 'M', u'斤'),
+    (0x2F45, 'M', u'方'),
+    (0x2F46, 'M', u'无'),
+    (0x2F47, 'M', u'日'),
+    (0x2F48, 'M', u'曰'),
+    (0x2F49, 'M', u'月'),
+    (0x2F4A, 'M', u'木'),
+    (0x2F4B, 'M', u'欠'),
+    (0x2F4C, 'M', u'止'),
+    (0x2F4D, 'M', u'歹'),
+    (0x2F4E, 'M', u'殳'),
+    (0x2F4F, 'M', u'毋'),
+    (0x2F50, 'M', u'比'),
+    (0x2F51, 'M', u'毛'),
+    (0x2F52, 'M', u'氏'),
+    (0x2F53, 'M', u'气'),
+    (0x2F54, 'M', u'水'),
+    (0x2F55, 'M', u'火'),
+    (0x2F56, 'M', u'爪'),
+    (0x2F57, 'M', u'父'),
+    (0x2F58, 'M', u'爻'),
+    (0x2F59, 'M', u'爿'),
+    (0x2F5A, 'M', u'片'),
+    (0x2F5B, 'M', u'牙'),
+    (0x2F5C, 'M', u'牛'),
+    (0x2F5D, 'M', u'犬'),
+    (0x2F5E, 'M', u'玄'),
+    (0x2F5F, 'M', u'玉'),
+    (0x2F60, 'M', u'瓜'),
+    (0x2F61, 'M', u'瓦'),
+    (0x2F62, 'M', u'甘'),
+    (0x2F63, 'M', u'生'),
+    (0x2F64, 'M', u'用'),
+    (0x2F65, 'M', u'田'),
+    (0x2F66, 'M', u'疋'),
+    (0x2F67, 'M', u'疒'),
+    (0x2F68, 'M', u'癶'),
+    (0x2F69, 'M', u'白'),
+    (0x2F6A, 'M', u'皮'),
+    (0x2F6B, 'M', u'皿'),
+    (0x2F6C, 'M', u'目'),
+    (0x2F6D, 'M', u'矛'),
+    (0x2F6E, 'M', u'矢'),
+    (0x2F6F, 'M', u'石'),
+    (0x2F70, 'M', u'示'),
+    (0x2F71, 'M', u'禸'),
+    (0x2F72, 'M', u'禾'),
+    (0x2F73, 'M', u'穴'),
+    (0x2F74, 'M', u'立'),
+    (0x2F75, 'M', u'竹'),
+    ]
+
+def _seg_28():
+    return [
+    (0x2F76, 'M', u'米'),
+    (0x2F77, 'M', u'糸'),
+    (0x2F78, 'M', u'缶'),
+    (0x2F79, 'M', u'网'),
+    (0x2F7A, 'M', u'羊'),
+    (0x2F7B, 'M', u'羽'),
+    (0x2F7C, 'M', u'老'),
+    (0x2F7D, 'M', u'而'),
+    (0x2F7E, 'M', u'耒'),
+    (0x2F7F, 'M', u'耳'),
+    (0x2F80, 'M', u'聿'),
+    (0x2F81, 'M', u'肉'),
+    (0x2F82, 'M', u'臣'),
+    (0x2F83, 'M', u'自'),
+    (0x2F84, 'M', u'至'),
+    (0x2F85, 'M', u'臼'),
+    (0x2F86, 'M', u'舌'),
+    (0x2F87, 'M', u'舛'),
+    (0x2F88, 'M', u'舟'),
+    (0x2F89, 'M', u'艮'),
+    (0x2F8A, 'M', u'色'),
+    (0x2F8B, 'M', u'艸'),
+    (0x2F8C, 'M', u'虍'),
+    (0x2F8D, 'M', u'虫'),
+    (0x2F8E, 'M', u'血'),
+    (0x2F8F, 'M', u'行'),
+    (0x2F90, 'M', u'衣'),
+    (0x2F91, 'M', u'襾'),
+    (0x2F92, 'M', u'見'),
+    (0x2F93, 'M', u'角'),
+    (0x2F94, 'M', u'言'),
+    (0x2F95, 'M', u'谷'),
+    (0x2F96, 'M', u'豆'),
+    (0x2F97, 'M', u'豕'),
+    (0x2F98, 'M', u'豸'),
+    (0x2F99, 'M', u'貝'),
+    (0x2F9A, 'M', u'赤'),
+    (0x2F9B, 'M', u'走'),
+    (0x2F9C, 'M', u'足'),
+    (0x2F9D, 'M', u'身'),
+    (0x2F9E, 'M', u'車'),
+    (0x2F9F, 'M', u'辛'),
+    (0x2FA0, 'M', u'辰'),
+    (0x2FA1, 'M', u'辵'),
+    (0x2FA2, 'M', u'邑'),
+    (0x2FA3, 'M', u'酉'),
+    (0x2FA4, 'M', u'釆'),
+    (0x2FA5, 'M', u'里'),
+    (0x2FA6, 'M', u'金'),
+    (0x2FA7, 'M', u'長'),
+    (0x2FA8, 'M', u'門'),
+    (0x2FA9, 'M', u'阜'),
+    (0x2FAA, 'M', u'隶'),
+    (0x2FAB, 'M', u'隹'),
+    (0x2FAC, 'M', u'雨'),
+    (0x2FAD, 'M', u'靑'),
+    (0x2FAE, 'M', u'非'),
+    (0x2FAF, 'M', u'面'),
+    (0x2FB0, 'M', u'革'),
+    (0x2FB1, 'M', u'韋'),
+    (0x2FB2, 'M', u'韭'),
+    (0x2FB3, 'M', u'音'),
+    (0x2FB4, 'M', u'頁'),
+    (0x2FB5, 'M', u'風'),
+    (0x2FB6, 'M', u'飛'),
+    (0x2FB7, 'M', u'食'),
+    (0x2FB8, 'M', u'首'),
+    (0x2FB9, 'M', u'香'),
+    (0x2FBA, 'M', u'馬'),
+    (0x2FBB, 'M', u'骨'),
+    (0x2FBC, 'M', u'高'),
+    (0x2FBD, 'M', u'髟'),
+    (0x2FBE, 'M', u'鬥'),
+    (0x2FBF, 'M', u'鬯'),
+    (0x2FC0, 'M', u'鬲'),
+    (0x2FC1, 'M', u'鬼'),
+    (0x2FC2, 'M', u'魚'),
+    (0x2FC3, 'M', u'鳥'),
+    (0x2FC4, 'M', u'鹵'),
+    (0x2FC5, 'M', u'鹿'),
+    (0x2FC6, 'M', u'麥'),
+    (0x2FC7, 'M', u'麻'),
+    (0x2FC8, 'M', u'黃'),
+    (0x2FC9, 'M', u'黍'),
+    (0x2FCA, 'M', u'黑'),
+    (0x2FCB, 'M', u'黹'),
+    (0x2FCC, 'M', u'黽'),
+    (0x2FCD, 'M', u'鼎'),
+    (0x2FCE, 'M', u'鼓'),
+    (0x2FCF, 'M', u'鼠'),
+    (0x2FD0, 'M', u'鼻'),
+    (0x2FD1, 'M', u'齊'),
+    (0x2FD2, 'M', u'齒'),
+    (0x2FD3, 'M', u'龍'),
+    (0x2FD4, 'M', u'龜'),
+    (0x2FD5, 'M', u'龠'),
+    (0x2FD6, 'X'),
+    (0x3000, '3', u' '),
+    (0x3001, 'V'),
+    (0x3002, 'M', u'.'),
+    ]
+
+def _seg_29():
+    return [
+    (0x3003, 'V'),
+    (0x3036, 'M', u'〒'),
+    (0x3037, 'V'),
+    (0x3038, 'M', u'十'),
+    (0x3039, 'M', u'卄'),
+    (0x303A, 'M', u'卅'),
+    (0x303B, 'V'),
+    (0x3040, 'X'),
+    (0x3041, 'V'),
+    (0x3097, 'X'),
+    (0x3099, 'V'),
+    (0x309B, '3', u' ゙'),
+    (0x309C, '3', u' ゚'),
+    (0x309D, 'V'),
+    (0x309F, 'M', u'より'),
+    (0x30A0, 'V'),
+    (0x30FF, 'M', u'コト'),
+    (0x3100, 'X'),
+    (0x3105, 'V'),
+    (0x3130, 'X'),
+    (0x3131, 'M', u'ᄀ'),
+    (0x3132, 'M', u'ᄁ'),
+    (0x3133, 'M', u'ᆪ'),
+    (0x3134, 'M', u'ᄂ'),
+    (0x3135, 'M', u'ᆬ'),
+    (0x3136, 'M', u'ᆭ'),
+    (0x3137, 'M', u'ᄃ'),
+    (0x3138, 'M', u'ᄄ'),
+    (0x3139, 'M', u'ᄅ'),
+    (0x313A, 'M', u'ᆰ'),
+    (0x313B, 'M', u'ᆱ'),
+    (0x313C, 'M', u'ᆲ'),
+    (0x313D, 'M', u'ᆳ'),
+    (0x313E, 'M', u'ᆴ'),
+    (0x313F, 'M', u'ᆵ'),
+    (0x3140, 'M', u'ᄚ'),
+    (0x3141, 'M', u'ᄆ'),
+    (0x3142, 'M', u'ᄇ'),
+    (0x3143, 'M', u'ᄈ'),
+    (0x3144, 'M', u'ᄡ'),
+    (0x3145, 'M', u'ᄉ'),
+    (0x3146, 'M', u'ᄊ'),
+    (0x3147, 'M', u'ᄋ'),
+    (0x3148, 'M', u'ᄌ'),
+    (0x3149, 'M', u'ᄍ'),
+    (0x314A, 'M', u'ᄎ'),
+    (0x314B, 'M', u'ᄏ'),
+    (0x314C, 'M', u'ᄐ'),
+    (0x314D, 'M', u'ᄑ'),
+    (0x314E, 'M', u'ᄒ'),
+    (0x314F, 'M', u'ᅡ'),
+    (0x3150, 'M', u'ᅢ'),
+    (0x3151, 'M', u'ᅣ'),
+    (0x3152, 'M', u'ᅤ'),
+    (0x3153, 'M', u'ᅥ'),
+    (0x3154, 'M', u'ᅦ'),
+    (0x3155, 'M', u'ᅧ'),
+    (0x3156, 'M', u'ᅨ'),
+    (0x3157, 'M', u'ᅩ'),
+    (0x3158, 'M', u'ᅪ'),
+    (0x3159, 'M', u'ᅫ'),
+    (0x315A, 'M', u'ᅬ'),
+    (0x315B, 'M', u'ᅭ'),
+    (0x315C, 'M', u'ᅮ'),
+    (0x315D, 'M', u'ᅯ'),
+    (0x315E, 'M', u'ᅰ'),
+    (0x315F, 'M', u'ᅱ'),
+    (0x3160, 'M', u'ᅲ'),
+    (0x3161, 'M', u'ᅳ'),
+    (0x3162, 'M', u'ᅴ'),
+    (0x3163, 'M', u'ᅵ'),
+    (0x3164, 'X'),
+    (0x3165, 'M', u'ᄔ'),
+    (0x3166, 'M', u'ᄕ'),
+    (0x3167, 'M', u'ᇇ'),
+    (0x3168, 'M', u'ᇈ'),
+    (0x3169, 'M', u'ᇌ'),
+    (0x316A, 'M', u'ᇎ'),
+    (0x316B, 'M', u'ᇓ'),
+    (0x316C, 'M', u'ᇗ'),
+    (0x316D, 'M', u'ᇙ'),
+    (0x316E, 'M', u'ᄜ'),
+    (0x316F, 'M', u'ᇝ'),
+    (0x3170, 'M', u'ᇟ'),
+    (0x3171, 'M', u'ᄝ'),
+    (0x3172, 'M', u'ᄞ'),
+    (0x3173, 'M', u'ᄠ'),
+    (0x3174, 'M', u'ᄢ'),
+    (0x3175, 'M', u'ᄣ'),
+    (0x3176, 'M', u'ᄧ'),
+    (0x3177, 'M', u'ᄩ'),
+    (0x3178, 'M', u'ᄫ'),
+    (0x3179, 'M', u'ᄬ'),
+    (0x317A, 'M', u'ᄭ'),
+    (0x317B, 'M', u'ᄮ'),
+    (0x317C, 'M', u'ᄯ'),
+    (0x317D, 'M', u'ᄲ'),
+    (0x317E, 'M', u'ᄶ'),
+    (0x317F, 'M', u'ᅀ'),
+    (0x3180, 'M', u'ᅇ'),
+    ]
+
+def _seg_30():
+    return [
+    (0x3181, 'M', u'ᅌ'),
+    (0x3182, 'M', u'ᇱ'),
+    (0x3183, 'M', u'ᇲ'),
+    (0x3184, 'M', u'ᅗ'),
+    (0x3185, 'M', u'ᅘ'),
+    (0x3186, 'M', u'ᅙ'),
+    (0x3187, 'M', u'ᆄ'),
+    (0x3188, 'M', u'ᆅ'),
+    (0x3189, 'M', u'ᆈ'),
+    (0x318A, 'M', u'ᆑ'),
+    (0x318B, 'M', u'ᆒ'),
+    (0x318C, 'M', u'ᆔ'),
+    (0x318D, 'M', u'ᆞ'),
+    (0x318E, 'M', u'ᆡ'),
+    (0x318F, 'X'),
+    (0x3190, 'V'),
+    (0x3192, 'M', u'一'),
+    (0x3193, 'M', u'二'),
+    (0x3194, 'M', u'三'),
+    (0x3195, 'M', u'四'),
+    (0x3196, 'M', u'上'),
+    (0x3197, 'M', u'中'),
+    (0x3198, 'M', u'下'),
+    (0x3199, 'M', u'甲'),
+    (0x319A, 'M', u'乙'),
+    (0x319B, 'M', u'丙'),
+    (0x319C, 'M', u'丁'),
+    (0x319D, 'M', u'天'),
+    (0x319E, 'M', u'地'),
+    (0x319F, 'M', u'人'),
+    (0x31A0, 'V'),
+    (0x31E4, 'X'),
+    (0x31F0, 'V'),
+    (0x3200, '3', u'(ᄀ)'),
+    (0x3201, '3', u'(ᄂ)'),
+    (0x3202, '3', u'(ᄃ)'),
+    (0x3203, '3', u'(ᄅ)'),
+    (0x3204, '3', u'(ᄆ)'),
+    (0x3205, '3', u'(ᄇ)'),
+    (0x3206, '3', u'(ᄉ)'),
+    (0x3207, '3', u'(ᄋ)'),
+    (0x3208, '3', u'(ᄌ)'),
+    (0x3209, '3', u'(ᄎ)'),
+    (0x320A, '3', u'(ᄏ)'),
+    (0x320B, '3', u'(ᄐ)'),
+    (0x320C, '3', u'(ᄑ)'),
+    (0x320D, '3', u'(ᄒ)'),
+    (0x320E, '3', u'(가)'),
+    (0x320F, '3', u'(나)'),
+    (0x3210, '3', u'(다)'),
+    (0x3211, '3', u'(라)'),
+    (0x3212, '3', u'(마)'),
+    (0x3213, '3', u'(바)'),
+    (0x3214, '3', u'(사)'),
+    (0x3215, '3', u'(아)'),
+    (0x3216, '3', u'(자)'),
+    (0x3217, '3', u'(차)'),
+    (0x3218, '3', u'(카)'),
+    (0x3219, '3', u'(타)'),
+    (0x321A, '3', u'(파)'),
+    (0x321B, '3', u'(하)'),
+    (0x321C, '3', u'(주)'),
+    (0x321D, '3', u'(오전)'),
+    (0x321E, '3', u'(오후)'),
+    (0x321F, 'X'),
+    (0x3220, '3', u'(一)'),
+    (0x3221, '3', u'(二)'),
+    (0x3222, '3', u'(三)'),
+    (0x3223, '3', u'(四)'),
+    (0x3224, '3', u'(五)'),
+    (0x3225, '3', u'(六)'),
+    (0x3226, '3', u'(七)'),
+    (0x3227, '3', u'(八)'),
+    (0x3228, '3', u'(九)'),
+    (0x3229, '3', u'(十)'),
+    (0x322A, '3', u'(月)'),
+    (0x322B, '3', u'(火)'),
+    (0x322C, '3', u'(水)'),
+    (0x322D, '3', u'(木)'),
+    (0x322E, '3', u'(金)'),
+    (0x322F, '3', u'(土)'),
+    (0x3230, '3', u'(日)'),
+    (0x3231, '3', u'(株)'),
+    (0x3232, '3', u'(有)'),
+    (0x3233, '3', u'(社)'),
+    (0x3234, '3', u'(名)'),
+    (0x3235, '3', u'(特)'),
+    (0x3236, '3', u'(財)'),
+    (0x3237, '3', u'(祝)'),
+    (0x3238, '3', u'(労)'),
+    (0x3239, '3', u'(代)'),
+    (0x323A, '3', u'(呼)'),
+    (0x323B, '3', u'(学)'),
+    (0x323C, '3', u'(監)'),
+    (0x323D, '3', u'(企)'),
+    (0x323E, '3', u'(資)'),
+    (0x323F, '3', u'(協)'),
+    (0x3240, '3', u'(祭)'),
+    (0x3241, '3', u'(休)'),
+    (0x3242, '3', u'(自)'),
+    ]
+
+def _seg_31():
+    return [
+    (0x3243, '3', u'(至)'),
+    (0x3244, 'M', u'問'),
+    (0x3245, 'M', u'幼'),
+    (0x3246, 'M', u'文'),
+    (0x3247, 'M', u'箏'),
+    (0x3248, 'V'),
+    (0x3250, 'M', u'pte'),
+    (0x3251, 'M', u'21'),
+    (0x3252, 'M', u'22'),
+    (0x3253, 'M', u'23'),
+    (0x3254, 'M', u'24'),
+    (0x3255, 'M', u'25'),
+    (0x3256, 'M', u'26'),
+    (0x3257, 'M', u'27'),
+    (0x3258, 'M', u'28'),
+    (0x3259, 'M', u'29'),
+    (0x325A, 'M', u'30'),
+    (0x325B, 'M', u'31'),
+    (0x325C, 'M', u'32'),
+    (0x325D, 'M', u'33'),
+    (0x325E, 'M', u'34'),
+    (0x325F, 'M', u'35'),
+    (0x3260, 'M', u'ᄀ'),
+    (0x3261, 'M', u'ᄂ'),
+    (0x3262, 'M', u'ᄃ'),
+    (0x3263, 'M', u'ᄅ'),
+    (0x3264, 'M', u'ᄆ'),
+    (0x3265, 'M', u'ᄇ'),
+    (0x3266, 'M', u'ᄉ'),
+    (0x3267, 'M', u'ᄋ'),
+    (0x3268, 'M', u'ᄌ'),
+    (0x3269, 'M', u'ᄎ'),
+    (0x326A, 'M', u'ᄏ'),
+    (0x326B, 'M', u'ᄐ'),
+    (0x326C, 'M', u'ᄑ'),
+    (0x326D, 'M', u'ᄒ'),
+    (0x326E, 'M', u'가'),
+    (0x326F, 'M', u'나'),
+    (0x3270, 'M', u'다'),
+    (0x3271, 'M', u'라'),
+    (0x3272, 'M', u'마'),
+    (0x3273, 'M', u'바'),
+    (0x3274, 'M', u'사'),
+    (0x3275, 'M', u'아'),
+    (0x3276, 'M', u'자'),
+    (0x3277, 'M', u'차'),
+    (0x3278, 'M', u'카'),
+    (0x3279, 'M', u'타'),
+    (0x327A, 'M', u'파'),
+    (0x327B, 'M', u'하'),
+    (0x327C, 'M', u'참고'),
+    (0x327D, 'M', u'주의'),
+    (0x327E, 'M', u'우'),
+    (0x327F, 'V'),
+    (0x3280, 'M', u'一'),
+    (0x3281, 'M', u'二'),
+    (0x3282, 'M', u'三'),
+    (0x3283, 'M', u'四'),
+    (0x3284, 'M', u'五'),
+    (0x3285, 'M', u'六'),
+    (0x3286, 'M', u'七'),
+    (0x3287, 'M', u'八'),
+    (0x3288, 'M', u'九'),
+    (0x3289, 'M', u'十'),
+    (0x328A, 'M', u'月'),
+    (0x328B, 'M', u'火'),
+    (0x328C, 'M', u'水'),
+    (0x328D, 'M', u'木'),
+    (0x328E, 'M', u'金'),
+    (0x328F, 'M', u'土'),
+    (0x3290, 'M', u'日'),
+    (0x3291, 'M', u'株'),
+    (0x3292, 'M', u'有'),
+    (0x3293, 'M', u'社'),
+    (0x3294, 'M', u'名'),
+    (0x3295, 'M', u'特'),
+    (0x3296, 'M', u'財'),
+    (0x3297, 'M', u'祝'),
+    (0x3298, 'M', u'労'),
+    (0x3299, 'M', u'秘'),
+    (0x329A, 'M', u'男'),
+    (0x329B, 'M', u'女'),
+    (0x329C, 'M', u'適'),
+    (0x329D, 'M', u'優'),
+    (0x329E, 'M', u'印'),
+    (0x329F, 'M', u'注'),
+    (0x32A0, 'M', u'項'),
+    (0x32A1, 'M', u'休'),
+    (0x32A2, 'M', u'写'),
+    (0x32A3, 'M', u'正'),
+    (0x32A4, 'M', u'上'),
+    (0x32A5, 'M', u'中'),
+    (0x32A6, 'M', u'下'),
+    (0x32A7, 'M', u'左'),
+    (0x32A8, 'M', u'右'),
+    (0x32A9, 'M', u'医'),
+    (0x32AA, 'M', u'宗'),
+    (0x32AB, 'M', u'学'),
+    (0x32AC, 'M', u'監'),
+    (0x32AD, 'M', u'企'),
+    ]
+
+def _seg_32():
+    return [
+    (0x32AE, 'M', u'資'),
+    (0x32AF, 'M', u'協'),
+    (0x32B0, 'M', u'夜'),
+    (0x32B1, 'M', u'36'),
+    (0x32B2, 'M', u'37'),
+    (0x32B3, 'M', u'38'),
+    (0x32B4, 'M', u'39'),
+    (0x32B5, 'M', u'40'),
+    (0x32B6, 'M', u'41'),
+    (0x32B7, 'M', u'42'),
+    (0x32B8, 'M', u'43'),
+    (0x32B9, 'M', u'44'),
+    (0x32BA, 'M', u'45'),
+    (0x32BB, 'M', u'46'),
+    (0x32BC, 'M', u'47'),
+    (0x32BD, 'M', u'48'),
+    (0x32BE, 'M', u'49'),
+    (0x32BF, 'M', u'50'),
+    (0x32C0, 'M', u'1月'),
+    (0x32C1, 'M', u'2月'),
+    (0x32C2, 'M', u'3月'),
+    (0x32C3, 'M', u'4月'),
+    (0x32C4, 'M', u'5月'),
+    (0x32C5, 'M', u'6月'),
+    (0x32C6, 'M', u'7月'),
+    (0x32C7, 'M', u'8月'),
+    (0x32C8, 'M', u'9月'),
+    (0x32C9, 'M', u'10月'),
+    (0x32CA, 'M', u'11月'),
+    (0x32CB, 'M', u'12月'),
+    (0x32CC, 'M', u'hg'),
+    (0x32CD, 'M', u'erg'),
+    (0x32CE, 'M', u'ev'),
+    (0x32CF, 'M', u'ltd'),
+    (0x32D0, 'M', u'ア'),
+    (0x32D1, 'M', u'イ'),
+    (0x32D2, 'M', u'ウ'),
+    (0x32D3, 'M', u'エ'),
+    (0x32D4, 'M', u'オ'),
+    (0x32D5, 'M', u'カ'),
+    (0x32D6, 'M', u'キ'),
+    (0x32D7, 'M', u'ク'),
+    (0x32D8, 'M', u'ケ'),
+    (0x32D9, 'M', u'コ'),
+    (0x32DA, 'M', u'サ'),
+    (0x32DB, 'M', u'シ'),
+    (0x32DC, 'M', u'ス'),
+    (0x32DD, 'M', u'セ'),
+    (0x32DE, 'M', u'ソ'),
+    (0x32DF, 'M', u'タ'),
+    (0x32E0, 'M', u'チ'),
+    (0x32E1, 'M', u'ツ'),
+    (0x32E2, 'M', u'テ'),
+    (0x32E3, 'M', u'ト'),
+    (0x32E4, 'M', u'ナ'),
+    (0x32E5, 'M', u'ニ'),
+    (0x32E6, 'M', u'ヌ'),
+    (0x32E7, 'M', u'ネ'),
+    (0x32E8, 'M', u'ノ'),
+    (0x32E9, 'M', u'ハ'),
+    (0x32EA, 'M', u'ヒ'),
+    (0x32EB, 'M', u'フ'),
+    (0x32EC, 'M', u'ヘ'),
+    (0x32ED, 'M', u'ホ'),
+    (0x32EE, 'M', u'マ'),
+    (0x32EF, 'M', u'ミ'),
+    (0x32F0, 'M', u'ム'),
+    (0x32F1, 'M', u'メ'),
+    (0x32F2, 'M', u'モ'),
+    (0x32F3, 'M', u'ヤ'),
+    (0x32F4, 'M', u'ユ'),
+    (0x32F5, 'M', u'ヨ'),
+    (0x32F6, 'M', u'ラ'),
+    (0x32F7, 'M', u'リ'),
+    (0x32F8, 'M', u'ル'),
+    (0x32F9, 'M', u'レ'),
+    (0x32FA, 'M', u'ロ'),
+    (0x32FB, 'M', u'ワ'),
+    (0x32FC, 'M', u'ヰ'),
+    (0x32FD, 'M', u'ヱ'),
+    (0x32FE, 'M', u'ヲ'),
+    (0x32FF, 'M', u'令和'),
+    (0x3300, 'M', u'アパート'),
+    (0x3301, 'M', u'アルファ'),
+    (0x3302, 'M', u'アンペア'),
+    (0x3303, 'M', u'アール'),
+    (0x3304, 'M', u'イニング'),
+    (0x3305, 'M', u'インチ'),
+    (0x3306, 'M', u'ウォン'),
+    (0x3307, 'M', u'エスクード'),
+    (0x3308, 'M', u'エーカー'),
+    (0x3309, 'M', u'オンス'),
+    (0x330A, 'M', u'オーム'),
+    (0x330B, 'M', u'カイリ'),
+    (0x330C, 'M', u'カラット'),
+    (0x330D, 'M', u'カロリー'),
+    (0x330E, 'M', u'ガロン'),
+    (0x330F, 'M', u'ガンマ'),
+    (0x3310, 'M', u'ギガ'),
+    (0x3311, 'M', u'ギニー'),
+    ]
+
+def _seg_33():
+    return [
+    (0x3312, 'M', u'キュリー'),
+    (0x3313, 'M', u'ギルダー'),
+    (0x3314, 'M', u'キロ'),
+    (0x3315, 'M', u'キログラム'),
+    (0x3316, 'M', u'キロメートル'),
+    (0x3317, 'M', u'キロワット'),
+    (0x3318, 'M', u'グラム'),
+    (0x3319, 'M', u'グラムトン'),
+    (0x331A, 'M', u'クルゼイロ'),
+    (0x331B, 'M', u'クローネ'),
+    (0x331C, 'M', u'ケース'),
+    (0x331D, 'M', u'コルナ'),
+    (0x331E, 'M', u'コーポ'),
+    (0x331F, 'M', u'サイクル'),
+    (0x3320, 'M', u'サンチーム'),
+    (0x3321, 'M', u'シリング'),
+    (0x3322, 'M', u'センチ'),
+    (0x3323, 'M', u'セント'),
+    (0x3324, 'M', u'ダース'),
+    (0x3325, 'M', u'デシ'),
+    (0x3326, 'M', u'ドル'),
+    (0x3327, 'M', u'トン'),
+    (0x3328, 'M', u'ナノ'),
+    (0x3329, 'M', u'ノット'),
+    (0x332A, 'M', u'ハイツ'),
+    (0x332B, 'M', u'パーセント'),
+    (0x332C, 'M', u'パーツ'),
+    (0x332D, 'M', u'バーレル'),
+    (0x332E, 'M', u'ピアストル'),
+    (0x332F, 'M', u'ピクル'),
+    (0x3330, 'M', u'ピコ'),
+    (0x3331, 'M', u'ビル'),
+    (0x3332, 'M', u'ファラッド'),
+    (0x3333, 'M', u'フィート'),
+    (0x3334, 'M', u'ブッシェル'),
+    (0x3335, 'M', u'フラン'),
+    (0x3336, 'M', u'ヘクタール'),
+    (0x3337, 'M', u'ペソ'),
+    (0x3338, 'M', u'ペニヒ'),
+    (0x3339, 'M', u'ヘルツ'),
+    (0x333A, 'M', u'ペンス'),
+    (0x333B, 'M', u'ページ'),
+    (0x333C, 'M', u'ベータ'),
+    (0x333D, 'M', u'ポイント'),
+    (0x333E, 'M', u'ボルト'),
+    (0x333F, 'M', u'ホン'),
+    (0x3340, 'M', u'ポンド'),
+    (0x3341, 'M', u'ホール'),
+    (0x3342, 'M', u'ホーン'),
+    (0x3343, 'M', u'マイクロ'),
+    (0x3344, 'M', u'マイル'),
+    (0x3345, 'M', u'マッハ'),
+    (0x3346, 'M', u'マルク'),
+    (0x3347, 'M', u'マンション'),
+    (0x3348, 'M', u'ミクロン'),
+    (0x3349, 'M', u'ミリ'),
+    (0x334A, 'M', u'ミリバール'),
+    (0x334B, 'M', u'メガ'),
+    (0x334C, 'M', u'メガトン'),
+    (0x334D, 'M', u'メートル'),
+    (0x334E, 'M', u'ヤード'),
+    (0x334F, 'M', u'ヤール'),
+    (0x3350, 'M', u'ユアン'),
+    (0x3351, 'M', u'リットル'),
+    (0x3352, 'M', u'リラ'),
+    (0x3353, 'M', u'ルピー'),
+    (0x3354, 'M', u'ルーブル'),
+    (0x3355, 'M', u'レム'),
+    (0x3356, 'M', u'レントゲン'),
+    (0x3357, 'M', u'ワット'),
+    (0x3358, 'M', u'0点'),
+    (0x3359, 'M', u'1点'),
+    (0x335A, 'M', u'2点'),
+    (0x335B, 'M', u'3点'),
+    (0x335C, 'M', u'4点'),
+    (0x335D, 'M', u'5点'),
+    (0x335E, 'M', u'6点'),
+    (0x335F, 'M', u'7点'),
+    (0x3360, 'M', u'8点'),
+    (0x3361, 'M', u'9点'),
+    (0x3362, 'M', u'10点'),
+    (0x3363, 'M', u'11点'),
+    (0x3364, 'M', u'12点'),
+    (0x3365, 'M', u'13点'),
+    (0x3366, 'M', u'14点'),
+    (0x3367, 'M', u'15点'),
+    (0x3368, 'M', u'16点'),
+    (0x3369, 'M', u'17点'),
+    (0x336A, 'M', u'18点'),
+    (0x336B, 'M', u'19点'),
+    (0x336C, 'M', u'20点'),
+    (0x336D, 'M', u'21点'),
+    (0x336E, 'M', u'22点'),
+    (0x336F, 'M', u'23点'),
+    (0x3370, 'M', u'24点'),
+    (0x3371, 'M', u'hpa'),
+    (0x3372, 'M', u'da'),
+    (0x3373, 'M', u'au'),
+    (0x3374, 'M', u'bar'),
+    (0x3375, 'M', u'ov'),
+    ]
+
+def _seg_34():
+    return [
+    (0x3376, 'M', u'pc'),
+    (0x3377, 'M', u'dm'),
+    (0x3378, 'M', u'dm2'),
+    (0x3379, 'M', u'dm3'),
+    (0x337A, 'M', u'iu'),
+    (0x337B, 'M', u'平成'),
+    (0x337C, 'M', u'昭和'),
+    (0x337D, 'M', u'大正'),
+    (0x337E, 'M', u'明治'),
+    (0x337F, 'M', u'株式会社'),
+    (0x3380, 'M', u'pa'),
+    (0x3381, 'M', u'na'),
+    (0x3382, 'M', u'μa'),
+    (0x3383, 'M', u'ma'),
+    (0x3384, 'M', u'ka'),
+    (0x3385, 'M', u'kb'),
+    (0x3386, 'M', u'mb'),
+    (0x3387, 'M', u'gb'),
+    (0x3388, 'M', u'cal'),
+    (0x3389, 'M', u'kcal'),
+    (0x338A, 'M', u'pf'),
+    (0x338B, 'M', u'nf'),
+    (0x338C, 'M', u'μf'),
+    (0x338D, 'M', u'μg'),
+    (0x338E, 'M', u'mg'),
+    (0x338F, 'M', u'kg'),
+    (0x3390, 'M', u'hz'),
+    (0x3391, 'M', u'khz'),
+    (0x3392, 'M', u'mhz'),
+    (0x3393, 'M', u'ghz'),
+    (0x3394, 'M', u'thz'),
+    (0x3395, 'M', u'μl'),
+    (0x3396, 'M', u'ml'),
+    (0x3397, 'M', u'dl'),
+    (0x3398, 'M', u'kl'),
+    (0x3399, 'M', u'fm'),
+    (0x339A, 'M', u'nm'),
+    (0x339B, 'M', u'μm'),
+    (0x339C, 'M', u'mm'),
+    (0x339D, 'M', u'cm'),
+    (0x339E, 'M', u'km'),
+    (0x339F, 'M', u'mm2'),
+    (0x33A0, 'M', u'cm2'),
+    (0x33A1, 'M', u'm2'),
+    (0x33A2, 'M', u'km2'),
+    (0x33A3, 'M', u'mm3'),
+    (0x33A4, 'M', u'cm3'),
+    (0x33A5, 'M', u'm3'),
+    (0x33A6, 'M', u'km3'),
+    (0x33A7, 'M', u'm∕s'),
+    (0x33A8, 'M', u'm∕s2'),
+    (0x33A9, 'M', u'pa'),
+    (0x33AA, 'M', u'kpa'),
+    (0x33AB, 'M', u'mpa'),
+    (0x33AC, 'M', u'gpa'),
+    (0x33AD, 'M', u'rad'),
+    (0x33AE, 'M', u'rad∕s'),
+    (0x33AF, 'M', u'rad∕s2'),
+    (0x33B0, 'M', u'ps'),
+    (0x33B1, 'M', u'ns'),
+    (0x33B2, 'M', u'μs'),
+    (0x33B3, 'M', u'ms'),
+    (0x33B4, 'M', u'pv'),
+    (0x33B5, 'M', u'nv'),
+    (0x33B6, 'M', u'μv'),
+    (0x33B7, 'M', u'mv'),
+    (0x33B8, 'M', u'kv'),
+    (0x33B9, 'M', u'mv'),
+    (0x33BA, 'M', u'pw'),
+    (0x33BB, 'M', u'nw'),
+    (0x33BC, 'M', u'μw'),
+    (0x33BD, 'M', u'mw'),
+    (0x33BE, 'M', u'kw'),
+    (0x33BF, 'M', u'mw'),
+    (0x33C0, 'M', u'kω'),
+    (0x33C1, 'M', u'mω'),
+    (0x33C2, 'X'),
+    (0x33C3, 'M', u'bq'),
+    (0x33C4, 'M', u'cc'),
+    (0x33C5, 'M', u'cd'),
+    (0x33C6, 'M', u'c∕kg'),
+    (0x33C7, 'X'),
+    (0x33C8, 'M', u'db'),
+    (0x33C9, 'M', u'gy'),
+    (0x33CA, 'M', u'ha'),
+    (0x33CB, 'M', u'hp'),
+    (0x33CC, 'M', u'in'),
+    (0x33CD, 'M', u'kk'),
+    (0x33CE, 'M', u'km'),
+    (0x33CF, 'M', u'kt'),
+    (0x33D0, 'M', u'lm'),
+    (0x33D1, 'M', u'ln'),
+    (0x33D2, 'M', u'log'),
+    (0x33D3, 'M', u'lx'),
+    (0x33D4, 'M', u'mb'),
+    (0x33D5, 'M', u'mil'),
+    (0x33D6, 'M', u'mol'),
+    (0x33D7, 'M', u'ph'),
+    (0x33D8, 'X'),
+    (0x33D9, 'M', u'ppm'),
+    ]
+
+def _seg_35():
+    return [
+    (0x33DA, 'M', u'pr'),
+    (0x33DB, 'M', u'sr'),
+    (0x33DC, 'M', u'sv'),
+    (0x33DD, 'M', u'wb'),
+    (0x33DE, 'M', u'v∕m'),
+    (0x33DF, 'M', u'a∕m'),
+    (0x33E0, 'M', u'1日'),
+    (0x33E1, 'M', u'2日'),
+    (0x33E2, 'M', u'3日'),
+    (0x33E3, 'M', u'4日'),
+    (0x33E4, 'M', u'5日'),
+    (0x33E5, 'M', u'6日'),
+    (0x33E6, 'M', u'7日'),
+    (0x33E7, 'M', u'8日'),
+    (0x33E8, 'M', u'9日'),
+    (0x33E9, 'M', u'10日'),
+    (0x33EA, 'M', u'11日'),
+    (0x33EB, 'M', u'12日'),
+    (0x33EC, 'M', u'13日'),
+    (0x33ED, 'M', u'14日'),
+    (0x33EE, 'M', u'15日'),
+    (0x33EF, 'M', u'16日'),
+    (0x33F0, 'M', u'17日'),
+    (0x33F1, 'M', u'18日'),
+    (0x33F2, 'M', u'19日'),
+    (0x33F3, 'M', u'20日'),
+    (0x33F4, 'M', u'21日'),
+    (0x33F5, 'M', u'22日'),
+    (0x33F6, 'M', u'23日'),
+    (0x33F7, 'M', u'24日'),
+    (0x33F8, 'M', u'25日'),
+    (0x33F9, 'M', u'26日'),
+    (0x33FA, 'M', u'27日'),
+    (0x33FB, 'M', u'28日'),
+    (0x33FC, 'M', u'29日'),
+    (0x33FD, 'M', u'30日'),
+    (0x33FE, 'M', u'31日'),
+    (0x33FF, 'M', u'gal'),
+    (0x3400, 'V'),
+    (0x9FFD, 'X'),
+    (0xA000, 'V'),
+    (0xA48D, 'X'),
+    (0xA490, 'V'),
+    (0xA4C7, 'X'),
+    (0xA4D0, 'V'),
+    (0xA62C, 'X'),
+    (0xA640, 'M', u'ꙁ'),
+    (0xA641, 'V'),
+    (0xA642, 'M', u'ꙃ'),
+    (0xA643, 'V'),
+    (0xA644, 'M', u'ꙅ'),
+    (0xA645, 'V'),
+    (0xA646, 'M', u'ꙇ'),
+    (0xA647, 'V'),
+    (0xA648, 'M', u'ꙉ'),
+    (0xA649, 'V'),
+    (0xA64A, 'M', u'ꙋ'),
+    (0xA64B, 'V'),
+    (0xA64C, 'M', u'ꙍ'),
+    (0xA64D, 'V'),
+    (0xA64E, 'M', u'ꙏ'),
+    (0xA64F, 'V'),
+    (0xA650, 'M', u'ꙑ'),
+    (0xA651, 'V'),
+    (0xA652, 'M', u'ꙓ'),
+    (0xA653, 'V'),
+    (0xA654, 'M', u'ꙕ'),
+    (0xA655, 'V'),
+    (0xA656, 'M', u'ꙗ'),
+    (0xA657, 'V'),
+    (0xA658, 'M', u'ꙙ'),
+    (0xA659, 'V'),
+    (0xA65A, 'M', u'ꙛ'),
+    (0xA65B, 'V'),
+    (0xA65C, 'M', u'ꙝ'),
+    (0xA65D, 'V'),
+    (0xA65E, 'M', u'ꙟ'),
+    (0xA65F, 'V'),
+    (0xA660, 'M', u'ꙡ'),
+    (0xA661, 'V'),
+    (0xA662, 'M', u'ꙣ'),
+    (0xA663, 'V'),
+    (0xA664, 'M', u'ꙥ'),
+    (0xA665, 'V'),
+    (0xA666, 'M', u'ꙧ'),
+    (0xA667, 'V'),
+    (0xA668, 'M', u'ꙩ'),
+    (0xA669, 'V'),
+    (0xA66A, 'M', u'ꙫ'),
+    (0xA66B, 'V'),
+    (0xA66C, 'M', u'ꙭ'),
+    (0xA66D, 'V'),
+    (0xA680, 'M', u'ꚁ'),
+    (0xA681, 'V'),
+    (0xA682, 'M', u'ꚃ'),
+    (0xA683, 'V'),
+    (0xA684, 'M', u'ꚅ'),
+    (0xA685, 'V'),
+    (0xA686, 'M', u'ꚇ'),
+    (0xA687, 'V'),
+    ]
+
+def _seg_36():
+    return [
+    (0xA688, 'M', u'ꚉ'),
+    (0xA689, 'V'),
+    (0xA68A, 'M', u'ꚋ'),
+    (0xA68B, 'V'),
+    (0xA68C, 'M', u'ꚍ'),
+    (0xA68D, 'V'),
+    (0xA68E, 'M', u'ꚏ'),
+    (0xA68F, 'V'),
+    (0xA690, 'M', u'ꚑ'),
+    (0xA691, 'V'),
+    (0xA692, 'M', u'ꚓ'),
+    (0xA693, 'V'),
+    (0xA694, 'M', u'ꚕ'),
+    (0xA695, 'V'),
+    (0xA696, 'M', u'ꚗ'),
+    (0xA697, 'V'),
+    (0xA698, 'M', u'ꚙ'),
+    (0xA699, 'V'),
+    (0xA69A, 'M', u'ꚛ'),
+    (0xA69B, 'V'),
+    (0xA69C, 'M', u'ъ'),
+    (0xA69D, 'M', u'ь'),
+    (0xA69E, 'V'),
+    (0xA6F8, 'X'),
+    (0xA700, 'V'),
+    (0xA722, 'M', u'ꜣ'),
+    (0xA723, 'V'),
+    (0xA724, 'M', u'ꜥ'),
+    (0xA725, 'V'),
+    (0xA726, 'M', u'ꜧ'),
+    (0xA727, 'V'),
+    (0xA728, 'M', u'ꜩ'),
+    (0xA729, 'V'),
+    (0xA72A, 'M', u'ꜫ'),
+    (0xA72B, 'V'),
+    (0xA72C, 'M', u'ꜭ'),
+    (0xA72D, 'V'),
+    (0xA72E, 'M', u'ꜯ'),
+    (0xA72F, 'V'),
+    (0xA732, 'M', u'ꜳ'),
+    (0xA733, 'V'),
+    (0xA734, 'M', u'ꜵ'),
+    (0xA735, 'V'),
+    (0xA736, 'M', u'ꜷ'),
+    (0xA737, 'V'),
+    (0xA738, 'M', u'ꜹ'),
+    (0xA739, 'V'),
+    (0xA73A, 'M', u'ꜻ'),
+    (0xA73B, 'V'),
+    (0xA73C, 'M', u'ꜽ'),
+    (0xA73D, 'V'),
+    (0xA73E, 'M', u'ꜿ'),
+    (0xA73F, 'V'),
+    (0xA740, 'M', u'ꝁ'),
+    (0xA741, 'V'),
+    (0xA742, 'M', u'ꝃ'),
+    (0xA743, 'V'),
+    (0xA744, 'M', u'ꝅ'),
+    (0xA745, 'V'),
+    (0xA746, 'M', u'ꝇ'),
+    (0xA747, 'V'),
+    (0xA748, 'M', u'ꝉ'),
+    (0xA749, 'V'),
+    (0xA74A, 'M', u'ꝋ'),
+    (0xA74B, 'V'),
+    (0xA74C, 'M', u'ꝍ'),
+    (0xA74D, 'V'),
+    (0xA74E, 'M', u'ꝏ'),
+    (0xA74F, 'V'),
+    (0xA750, 'M', u'ꝑ'),
+    (0xA751, 'V'),
+    (0xA752, 'M', u'ꝓ'),
+    (0xA753, 'V'),
+    (0xA754, 'M', u'ꝕ'),
+    (0xA755, 'V'),
+    (0xA756, 'M', u'ꝗ'),
+    (0xA757, 'V'),
+    (0xA758, 'M', u'ꝙ'),
+    (0xA759, 'V'),
+    (0xA75A, 'M', u'ꝛ'),
+    (0xA75B, 'V'),
+    (0xA75C, 'M', u'ꝝ'),
+    (0xA75D, 'V'),
+    (0xA75E, 'M', u'ꝟ'),
+    (0xA75F, 'V'),
+    (0xA760, 'M', u'ꝡ'),
+    (0xA761, 'V'),
+    (0xA762, 'M', u'ꝣ'),
+    (0xA763, 'V'),
+    (0xA764, 'M', u'ꝥ'),
+    (0xA765, 'V'),
+    (0xA766, 'M', u'ꝧ'),
+    (0xA767, 'V'),
+    (0xA768, 'M', u'ꝩ'),
+    (0xA769, 'V'),
+    (0xA76A, 'M', u'ꝫ'),
+    (0xA76B, 'V'),
+    (0xA76C, 'M', u'ꝭ'),
+    (0xA76D, 'V'),
+    (0xA76E, 'M', u'ꝯ'),
+    ]
+
+def _seg_37():
+    return [
+    (0xA76F, 'V'),
+    (0xA770, 'M', u'ꝯ'),
+    (0xA771, 'V'),
+    (0xA779, 'M', u'ꝺ'),
+    (0xA77A, 'V'),
+    (0xA77B, 'M', u'ꝼ'),
+    (0xA77C, 'V'),
+    (0xA77D, 'M', u'ᵹ'),
+    (0xA77E, 'M', u'ꝿ'),
+    (0xA77F, 'V'),
+    (0xA780, 'M', u'ꞁ'),
+    (0xA781, 'V'),
+    (0xA782, 'M', u'ꞃ'),
+    (0xA783, 'V'),
+    (0xA784, 'M', u'ꞅ'),
+    (0xA785, 'V'),
+    (0xA786, 'M', u'ꞇ'),
+    (0xA787, 'V'),
+    (0xA78B, 'M', u'ꞌ'),
+    (0xA78C, 'V'),
+    (0xA78D, 'M', u'ɥ'),
+    (0xA78E, 'V'),
+    (0xA790, 'M', u'ꞑ'),
+    (0xA791, 'V'),
+    (0xA792, 'M', u'ꞓ'),
+    (0xA793, 'V'),
+    (0xA796, 'M', u'ꞗ'),
+    (0xA797, 'V'),
+    (0xA798, 'M', u'ꞙ'),
+    (0xA799, 'V'),
+    (0xA79A, 'M', u'ꞛ'),
+    (0xA79B, 'V'),
+    (0xA79C, 'M', u'ꞝ'),
+    (0xA79D, 'V'),
+    (0xA79E, 'M', u'ꞟ'),
+    (0xA79F, 'V'),
+    (0xA7A0, 'M', u'ꞡ'),
+    (0xA7A1, 'V'),
+    (0xA7A2, 'M', u'ꞣ'),
+    (0xA7A3, 'V'),
+    (0xA7A4, 'M', u'ꞥ'),
+    (0xA7A5, 'V'),
+    (0xA7A6, 'M', u'ꞧ'),
+    (0xA7A7, 'V'),
+    (0xA7A8, 'M', u'ꞩ'),
+    (0xA7A9, 'V'),
+    (0xA7AA, 'M', u'ɦ'),
+    (0xA7AB, 'M', u'ɜ'),
+    (0xA7AC, 'M', u'ɡ'),
+    (0xA7AD, 'M', u'ɬ'),
+    (0xA7AE, 'M', u'ɪ'),
+    (0xA7AF, 'V'),
+    (0xA7B0, 'M', u'ʞ'),
+    (0xA7B1, 'M', u'ʇ'),
+    (0xA7B2, 'M', u'ʝ'),
+    (0xA7B3, 'M', u'ꭓ'),
+    (0xA7B4, 'M', u'ꞵ'),
+    (0xA7B5, 'V'),
+    (0xA7B6, 'M', u'ꞷ'),
+    (0xA7B7, 'V'),
+    (0xA7B8, 'M', u'ꞹ'),
+    (0xA7B9, 'V'),
+    (0xA7BA, 'M', u'ꞻ'),
+    (0xA7BB, 'V'),
+    (0xA7BC, 'M', u'ꞽ'),
+    (0xA7BD, 'V'),
+    (0xA7BE, 'M', u'ꞿ'),
+    (0xA7BF, 'V'),
+    (0xA7C0, 'X'),
+    (0xA7C2, 'M', u'ꟃ'),
+    (0xA7C3, 'V'),
+    (0xA7C4, 'M', u'ꞔ'),
+    (0xA7C5, 'M', u'ʂ'),
+    (0xA7C6, 'M', u'ᶎ'),
+    (0xA7C7, 'M', u'ꟈ'),
+    (0xA7C8, 'V'),
+    (0xA7C9, 'M', u'ꟊ'),
+    (0xA7CA, 'V'),
+    (0xA7CB, 'X'),
+    (0xA7F5, 'M', u'ꟶ'),
+    (0xA7F6, 'V'),
+    (0xA7F8, 'M', u'ħ'),
+    (0xA7F9, 'M', u'œ'),
+    (0xA7FA, 'V'),
+    (0xA82D, 'X'),
+    (0xA830, 'V'),
+    (0xA83A, 'X'),
+    (0xA840, 'V'),
+    (0xA878, 'X'),
+    (0xA880, 'V'),
+    (0xA8C6, 'X'),
+    (0xA8CE, 'V'),
+    (0xA8DA, 'X'),
+    (0xA8E0, 'V'),
+    (0xA954, 'X'),
+    (0xA95F, 'V'),
+    (0xA97D, 'X'),
+    (0xA980, 'V'),
+    (0xA9CE, 'X'),
+    (0xA9CF, 'V'),
+    ]
+
+def _seg_38():
+    return [
+    (0xA9DA, 'X'),
+    (0xA9DE, 'V'),
+    (0xA9FF, 'X'),
+    (0xAA00, 'V'),
+    (0xAA37, 'X'),
+    (0xAA40, 'V'),
+    (0xAA4E, 'X'),
+    (0xAA50, 'V'),
+    (0xAA5A, 'X'),
+    (0xAA5C, 'V'),
+    (0xAAC3, 'X'),
+    (0xAADB, 'V'),
+    (0xAAF7, 'X'),
+    (0xAB01, 'V'),
+    (0xAB07, 'X'),
+    (0xAB09, 'V'),
+    (0xAB0F, 'X'),
+    (0xAB11, 'V'),
+    (0xAB17, 'X'),
+    (0xAB20, 'V'),
+    (0xAB27, 'X'),
+    (0xAB28, 'V'),
+    (0xAB2F, 'X'),
+    (0xAB30, 'V'),
+    (0xAB5C, 'M', u'ꜧ'),
+    (0xAB5D, 'M', u'ꬷ'),
+    (0xAB5E, 'M', u'ɫ'),
+    (0xAB5F, 'M', u'ꭒ'),
+    (0xAB60, 'V'),
+    (0xAB69, 'M', u'ʍ'),
+    (0xAB6A, 'V'),
+    (0xAB6C, 'X'),
+    (0xAB70, 'M', u'Ꭰ'),
+    (0xAB71, 'M', u'Ꭱ'),
+    (0xAB72, 'M', u'Ꭲ'),
+    (0xAB73, 'M', u'Ꭳ'),
+    (0xAB74, 'M', u'Ꭴ'),
+    (0xAB75, 'M', u'Ꭵ'),
+    (0xAB76, 'M', u'Ꭶ'),
+    (0xAB77, 'M', u'Ꭷ'),
+    (0xAB78, 'M', u'Ꭸ'),
+    (0xAB79, 'M', u'Ꭹ'),
+    (0xAB7A, 'M', u'Ꭺ'),
+    (0xAB7B, 'M', u'Ꭻ'),
+    (0xAB7C, 'M', u'Ꭼ'),
+    (0xAB7D, 'M', u'Ꭽ'),
+    (0xAB7E, 'M', u'Ꭾ'),
+    (0xAB7F, 'M', u'Ꭿ'),
+    (0xAB80, 'M', u'Ꮀ'),
+    (0xAB81, 'M', u'Ꮁ'),
+    (0xAB82, 'M', u'Ꮂ'),
+    (0xAB83, 'M', u'Ꮃ'),
+    (0xAB84, 'M', u'Ꮄ'),
+    (0xAB85, 'M', u'Ꮅ'),
+    (0xAB86, 'M', u'Ꮆ'),
+    (0xAB87, 'M', u'Ꮇ'),
+    (0xAB88, 'M', u'Ꮈ'),
+    (0xAB89, 'M', u'Ꮉ'),
+    (0xAB8A, 'M', u'Ꮊ'),
+    (0xAB8B, 'M', u'Ꮋ'),
+    (0xAB8C, 'M', u'Ꮌ'),
+    (0xAB8D, 'M', u'Ꮍ'),
+    (0xAB8E, 'M', u'Ꮎ'),
+    (0xAB8F, 'M', u'Ꮏ'),
+    (0xAB90, 'M', u'Ꮐ'),
+    (0xAB91, 'M', u'Ꮑ'),
+    (0xAB92, 'M', u'Ꮒ'),
+    (0xAB93, 'M', u'Ꮓ'),
+    (0xAB94, 'M', u'Ꮔ'),
+    (0xAB95, 'M', u'Ꮕ'),
+    (0xAB96, 'M', u'Ꮖ'),
+    (0xAB97, 'M', u'Ꮗ'),
+    (0xAB98, 'M', u'Ꮘ'),
+    (0xAB99, 'M', u'Ꮙ'),
+    (0xAB9A, 'M', u'Ꮚ'),
+    (0xAB9B, 'M', u'Ꮛ'),
+    (0xAB9C, 'M', u'Ꮜ'),
+    (0xAB9D, 'M', u'Ꮝ'),
+    (0xAB9E, 'M', u'Ꮞ'),
+    (0xAB9F, 'M', u'Ꮟ'),
+    (0xABA0, 'M', u'Ꮠ'),
+    (0xABA1, 'M', u'Ꮡ'),
+    (0xABA2, 'M', u'Ꮢ'),
+    (0xABA3, 'M', u'Ꮣ'),
+    (0xABA4, 'M', u'Ꮤ'),
+    (0xABA5, 'M', u'Ꮥ'),
+    (0xABA6, 'M', u'Ꮦ'),
+    (0xABA7, 'M', u'Ꮧ'),
+    (0xABA8, 'M', u'Ꮨ'),
+    (0xABA9, 'M', u'Ꮩ'),
+    (0xABAA, 'M', u'Ꮪ'),
+    (0xABAB, 'M', u'Ꮫ'),
+    (0xABAC, 'M', u'Ꮬ'),
+    (0xABAD, 'M', u'Ꮭ'),
+    (0xABAE, 'M', u'Ꮮ'),
+    (0xABAF, 'M', u'Ꮯ'),
+    (0xABB0, 'M', u'Ꮰ'),
+    (0xABB1, 'M', u'Ꮱ'),
+    (0xABB2, 'M', u'Ꮲ'),
+    (0xABB3, 'M', u'Ꮳ'),
+    ]
+
+def _seg_39():
+    return [
+    (0xABB4, 'M', u'Ꮴ'),
+    (0xABB5, 'M', u'Ꮵ'),
+    (0xABB6, 'M', u'Ꮶ'),
+    (0xABB7, 'M', u'Ꮷ'),
+    (0xABB8, 'M', u'Ꮸ'),
+    (0xABB9, 'M', u'Ꮹ'),
+    (0xABBA, 'M', u'Ꮺ'),
+    (0xABBB, 'M', u'Ꮻ'),
+    (0xABBC, 'M', u'Ꮼ'),
+    (0xABBD, 'M', u'Ꮽ'),
+    (0xABBE, 'M', u'Ꮾ'),
+    (0xABBF, 'M', u'Ꮿ'),
+    (0xABC0, 'V'),
+    (0xABEE, 'X'),
+    (0xABF0, 'V'),
+    (0xABFA, 'X'),
+    (0xAC00, 'V'),
+    (0xD7A4, 'X'),
+    (0xD7B0, 'V'),
+    (0xD7C7, 'X'),
+    (0xD7CB, 'V'),
+    (0xD7FC, 'X'),
+    (0xF900, 'M', u'豈'),
+    (0xF901, 'M', u'更'),
+    (0xF902, 'M', u'車'),
+    (0xF903, 'M', u'賈'),
+    (0xF904, 'M', u'滑'),
+    (0xF905, 'M', u'串'),
+    (0xF906, 'M', u'句'),
+    (0xF907, 'M', u'龜'),
+    (0xF909, 'M', u'契'),
+    (0xF90A, 'M', u'金'),
+    (0xF90B, 'M', u'喇'),
+    (0xF90C, 'M', u'奈'),
+    (0xF90D, 'M', u'懶'),
+    (0xF90E, 'M', u'癩'),
+    (0xF90F, 'M', u'羅'),
+    (0xF910, 'M', u'蘿'),
+    (0xF911, 'M', u'螺'),
+    (0xF912, 'M', u'裸'),
+    (0xF913, 'M', u'邏'),
+    (0xF914, 'M', u'樂'),
+    (0xF915, 'M', u'洛'),
+    (0xF916, 'M', u'烙'),
+    (0xF917, 'M', u'珞'),
+    (0xF918, 'M', u'落'),
+    (0xF919, 'M', u'酪'),
+    (0xF91A, 'M', u'駱'),
+    (0xF91B, 'M', u'亂'),
+    (0xF91C, 'M', u'卵'),
+    (0xF91D, 'M', u'欄'),
+    (0xF91E, 'M', u'爛'),
+    (0xF91F, 'M', u'蘭'),
+    (0xF920, 'M', u'鸞'),
+    (0xF921, 'M', u'嵐'),
+    (0xF922, 'M', u'濫'),
+    (0xF923, 'M', u'藍'),
+    (0xF924, 'M', u'襤'),
+    (0xF925, 'M', u'拉'),
+    (0xF926, 'M', u'臘'),
+    (0xF927, 'M', u'蠟'),
+    (0xF928, 'M', u'廊'),
+    (0xF929, 'M', u'朗'),
+    (0xF92A, 'M', u'浪'),
+    (0xF92B, 'M', u'狼'),
+    (0xF92C, 'M', u'郎'),
+    (0xF92D, 'M', u'來'),
+    (0xF92E, 'M', u'冷'),
+    (0xF92F, 'M', u'勞'),
+    (0xF930, 'M', u'擄'),
+    (0xF931, 'M', u'櫓'),
+    (0xF932, 'M', u'爐'),
+    (0xF933, 'M', u'盧'),
+    (0xF934, 'M', u'老'),
+    (0xF935, 'M', u'蘆'),
+    (0xF936, 'M', u'虜'),
+    (0xF937, 'M', u'路'),
+    (0xF938, 'M', u'露'),
+    (0xF939, 'M', u'魯'),
+    (0xF93A, 'M', u'鷺'),
+    (0xF93B, 'M', u'碌'),
+    (0xF93C, 'M', u'祿'),
+    (0xF93D, 'M', u'綠'),
+    (0xF93E, 'M', u'菉'),
+    (0xF93F, 'M', u'錄'),
+    (0xF940, 'M', u'鹿'),
+    (0xF941, 'M', u'論'),
+    (0xF942, 'M', u'壟'),
+    (0xF943, 'M', u'弄'),
+    (0xF944, 'M', u'籠'),
+    (0xF945, 'M', u'聾'),
+    (0xF946, 'M', u'牢'),
+    (0xF947, 'M', u'磊'),
+    (0xF948, 'M', u'賂'),
+    (0xF949, 'M', u'雷'),
+    (0xF94A, 'M', u'壘'),
+    (0xF94B, 'M', u'屢'),
+    (0xF94C, 'M', u'樓'),
+    (0xF94D, 'M', u'淚'),
+    (0xF94E, 'M', u'漏'),
+    ]
+
+def _seg_40():
+    return [
+    (0xF94F, 'M', u'累'),
+    (0xF950, 'M', u'縷'),
+    (0xF951, 'M', u'陋'),
+    (0xF952, 'M', u'勒'),
+    (0xF953, 'M', u'肋'),
+    (0xF954, 'M', u'凜'),
+    (0xF955, 'M', u'凌'),
+    (0xF956, 'M', u'稜'),
+    (0xF957, 'M', u'綾'),
+    (0xF958, 'M', u'菱'),
+    (0xF959, 'M', u'陵'),
+    (0xF95A, 'M', u'讀'),
+    (0xF95B, 'M', u'拏'),
+    (0xF95C, 'M', u'樂'),
+    (0xF95D, 'M', u'諾'),
+    (0xF95E, 'M', u'丹'),
+    (0xF95F, 'M', u'寧'),
+    (0xF960, 'M', u'怒'),
+    (0xF961, 'M', u'率'),
+    (0xF962, 'M', u'異'),
+    (0xF963, 'M', u'北'),
+    (0xF964, 'M', u'磻'),
+    (0xF965, 'M', u'便'),
+    (0xF966, 'M', u'復'),
+    (0xF967, 'M', u'不'),
+    (0xF968, 'M', u'泌'),
+    (0xF969, 'M', u'數'),
+    (0xF96A, 'M', u'索'),
+    (0xF96B, 'M', u'參'),
+    (0xF96C, 'M', u'塞'),
+    (0xF96D, 'M', u'省'),
+    (0xF96E, 'M', u'葉'),
+    (0xF96F, 'M', u'說'),
+    (0xF970, 'M', u'殺'),
+    (0xF971, 'M', u'辰'),
+    (0xF972, 'M', u'沈'),
+    (0xF973, 'M', u'拾'),
+    (0xF974, 'M', u'若'),
+    (0xF975, 'M', u'掠'),
+    (0xF976, 'M', u'略'),
+    (0xF977, 'M', u'亮'),
+    (0xF978, 'M', u'兩'),
+    (0xF979, 'M', u'凉'),
+    (0xF97A, 'M', u'梁'),
+    (0xF97B, 'M', u'糧'),
+    (0xF97C, 'M', u'良'),
+    (0xF97D, 'M', u'諒'),
+    (0xF97E, 'M', u'量'),
+    (0xF97F, 'M', u'勵'),
+    (0xF980, 'M', u'呂'),
+    (0xF981, 'M', u'女'),
+    (0xF982, 'M', u'廬'),
+    (0xF983, 'M', u'旅'),
+    (0xF984, 'M', u'濾'),
+    (0xF985, 'M', u'礪'),
+    (0xF986, 'M', u'閭'),
+    (0xF987, 'M', u'驪'),
+    (0xF988, 'M', u'麗'),
+    (0xF989, 'M', u'黎'),
+    (0xF98A, 'M', u'力'),
+    (0xF98B, 'M', u'曆'),
+    (0xF98C, 'M', u'歷'),
+    (0xF98D, 'M', u'轢'),
+    (0xF98E, 'M', u'年'),
+    (0xF98F, 'M', u'憐'),
+    (0xF990, 'M', u'戀'),
+    (0xF991, 'M', u'撚'),
+    (0xF992, 'M', u'漣'),
+    (0xF993, 'M', u'煉'),
+    (0xF994, 'M', u'璉'),
+    (0xF995, 'M', u'秊'),
+    (0xF996, 'M', u'練'),
+    (0xF997, 'M', u'聯'),
+    (0xF998, 'M', u'輦'),
+    (0xF999, 'M', u'蓮'),
+    (0xF99A, 'M', u'連'),
+    (0xF99B, 'M', u'鍊'),
+    (0xF99C, 'M', u'列'),
+    (0xF99D, 'M', u'劣'),
+    (0xF99E, 'M', u'咽'),
+    (0xF99F, 'M', u'烈'),
+    (0xF9A0, 'M', u'裂'),
+    (0xF9A1, 'M', u'說'),
+    (0xF9A2, 'M', u'廉'),
+    (0xF9A3, 'M', u'念'),
+    (0xF9A4, 'M', u'捻'),
+    (0xF9A5, 'M', u'殮'),
+    (0xF9A6, 'M', u'簾'),
+    (0xF9A7, 'M', u'獵'),
+    (0xF9A8, 'M', u'令'),
+    (0xF9A9, 'M', u'囹'),
+    (0xF9AA, 'M', u'寧'),
+    (0xF9AB, 'M', u'嶺'),
+    (0xF9AC, 'M', u'怜'),
+    (0xF9AD, 'M', u'玲'),
+    (0xF9AE, 'M', u'瑩'),
+    (0xF9AF, 'M', u'羚'),
+    (0xF9B0, 'M', u'聆'),
+    (0xF9B1, 'M', u'鈴'),
+    (0xF9B2, 'M', u'零'),
+    ]
+
+def _seg_41():
+    return [
+    (0xF9B3, 'M', u'靈'),
+    (0xF9B4, 'M', u'領'),
+    (0xF9B5, 'M', u'例'),
+    (0xF9B6, 'M', u'禮'),
+    (0xF9B7, 'M', u'醴'),
+    (0xF9B8, 'M', u'隸'),
+    (0xF9B9, 'M', u'惡'),
+    (0xF9BA, 'M', u'了'),
+    (0xF9BB, 'M', u'僚'),
+    (0xF9BC, 'M', u'寮'),
+    (0xF9BD, 'M', u'尿'),
+    (0xF9BE, 'M', u'料'),
+    (0xF9BF, 'M', u'樂'),
+    (0xF9C0, 'M', u'燎'),
+    (0xF9C1, 'M', u'療'),
+    (0xF9C2, 'M', u'蓼'),
+    (0xF9C3, 'M', u'遼'),
+    (0xF9C4, 'M', u'龍'),
+    (0xF9C5, 'M', u'暈'),
+    (0xF9C6, 'M', u'阮'),
+    (0xF9C7, 'M', u'劉'),
+    (0xF9C8, 'M', u'杻'),
+    (0xF9C9, 'M', u'柳'),
+    (0xF9CA, 'M', u'流'),
+    (0xF9CB, 'M', u'溜'),
+    (0xF9CC, 'M', u'琉'),
+    (0xF9CD, 'M', u'留'),
+    (0xF9CE, 'M', u'硫'),
+    (0xF9CF, 'M', u'紐'),
+    (0xF9D0, 'M', u'類'),
+    (0xF9D1, 'M', u'六'),
+    (0xF9D2, 'M', u'戮'),
+    (0xF9D3, 'M', u'陸'),
+    (0xF9D4, 'M', u'倫'),
+    (0xF9D5, 'M', u'崙'),
+    (0xF9D6, 'M', u'淪'),
+    (0xF9D7, 'M', u'輪'),
+    (0xF9D8, 'M', u'律'),
+    (0xF9D9, 'M', u'慄'),
+    (0xF9DA, 'M', u'栗'),
+    (0xF9DB, 'M', u'率'),
+    (0xF9DC, 'M', u'隆'),
+    (0xF9DD, 'M', u'利'),
+    (0xF9DE, 'M', u'吏'),
+    (0xF9DF, 'M', u'履'),
+    (0xF9E0, 'M', u'易'),
+    (0xF9E1, 'M', u'李'),
+    (0xF9E2, 'M', u'梨'),
+    (0xF9E3, 'M', u'泥'),
+    (0xF9E4, 'M', u'理'),
+    (0xF9E5, 'M', u'痢'),
+    (0xF9E6, 'M', u'罹'),
+    (0xF9E7, 'M', u'裏'),
+    (0xF9E8, 'M', u'裡'),
+    (0xF9E9, 'M', u'里'),
+    (0xF9EA, 'M', u'離'),
+    (0xF9EB, 'M', u'匿'),
+    (0xF9EC, 'M', u'溺'),
+    (0xF9ED, 'M', u'吝'),
+    (0xF9EE, 'M', u'燐'),
+    (0xF9EF, 'M', u'璘'),
+    (0xF9F0, 'M', u'藺'),
+    (0xF9F1, 'M', u'隣'),
+    (0xF9F2, 'M', u'鱗'),
+    (0xF9F3, 'M', u'麟'),
+    (0xF9F4, 'M', u'林'),
+    (0xF9F5, 'M', u'淋'),
+    (0xF9F6, 'M', u'臨'),
+    (0xF9F7, 'M', u'立'),
+    (0xF9F8, 'M', u'笠'),
+    (0xF9F9, 'M', u'粒'),
+    (0xF9FA, 'M', u'狀'),
+    (0xF9FB, 'M', u'炙'),
+    (0xF9FC, 'M', u'識'),
+    (0xF9FD, 'M', u'什'),
+    (0xF9FE, 'M', u'茶'),
+    (0xF9FF, 'M', u'刺'),
+    (0xFA00, 'M', u'切'),
+    (0xFA01, 'M', u'度'),
+    (0xFA02, 'M', u'拓'),
+    (0xFA03, 'M', u'糖'),
+    (0xFA04, 'M', u'宅'),
+    (0xFA05, 'M', u'洞'),
+    (0xFA06, 'M', u'暴'),
+    (0xFA07, 'M', u'輻'),
+    (0xFA08, 'M', u'行'),
+    (0xFA09, 'M', u'降'),
+    (0xFA0A, 'M', u'見'),
+    (0xFA0B, 'M', u'廓'),
+    (0xFA0C, 'M', u'兀'),
+    (0xFA0D, 'M', u'嗀'),
+    (0xFA0E, 'V'),
+    (0xFA10, 'M', u'塚'),
+    (0xFA11, 'V'),
+    (0xFA12, 'M', u'晴'),
+    (0xFA13, 'V'),
+    (0xFA15, 'M', u'凞'),
+    (0xFA16, 'M', u'猪'),
+    (0xFA17, 'M', u'益'),
+    (0xFA18, 'M', u'礼'),
+    ]
+
+def _seg_42():
+    return [
+    (0xFA19, 'M', u'神'),
+    (0xFA1A, 'M', u'祥'),
+    (0xFA1B, 'M', u'福'),
+    (0xFA1C, 'M', u'靖'),
+    (0xFA1D, 'M', u'精'),
+    (0xFA1E, 'M', u'羽'),
+    (0xFA1F, 'V'),
+    (0xFA20, 'M', u'蘒'),
+    (0xFA21, 'V'),
+    (0xFA22, 'M', u'諸'),
+    (0xFA23, 'V'),
+    (0xFA25, 'M', u'逸'),
+    (0xFA26, 'M', u'都'),
+    (0xFA27, 'V'),
+    (0xFA2A, 'M', u'飯'),
+    (0xFA2B, 'M', u'飼'),
+    (0xFA2C, 'M', u'館'),
+    (0xFA2D, 'M', u'鶴'),
+    (0xFA2E, 'M', u'郞'),
+    (0xFA2F, 'M', u'隷'),
+    (0xFA30, 'M', u'侮'),
+    (0xFA31, 'M', u'僧'),
+    (0xFA32, 'M', u'免'),
+    (0xFA33, 'M', u'勉'),
+    (0xFA34, 'M', u'勤'),
+    (0xFA35, 'M', u'卑'),
+    (0xFA36, 'M', u'喝'),
+    (0xFA37, 'M', u'嘆'),
+    (0xFA38, 'M', u'器'),
+    (0xFA39, 'M', u'塀'),
+    (0xFA3A, 'M', u'墨'),
+    (0xFA3B, 'M', u'層'),
+    (0xFA3C, 'M', u'屮'),
+    (0xFA3D, 'M', u'悔'),
+    (0xFA3E, 'M', u'慨'),
+    (0xFA3F, 'M', u'憎'),
+    (0xFA40, 'M', u'懲'),
+    (0xFA41, 'M', u'敏'),
+    (0xFA42, 'M', u'既'),
+    (0xFA43, 'M', u'暑'),
+    (0xFA44, 'M', u'梅'),
+    (0xFA45, 'M', u'海'),
+    (0xFA46, 'M', u'渚'),
+    (0xFA47, 'M', u'漢'),
+    (0xFA48, 'M', u'煮'),
+    (0xFA49, 'M', u'爫'),
+    (0xFA4A, 'M', u'琢'),
+    (0xFA4B, 'M', u'碑'),
+    (0xFA4C, 'M', u'社'),
+    (0xFA4D, 'M', u'祉'),
+    (0xFA4E, 'M', u'祈'),
+    (0xFA4F, 'M', u'祐'),
+    (0xFA50, 'M', u'祖'),
+    (0xFA51, 'M', u'祝'),
+    (0xFA52, 'M', u'禍'),
+    (0xFA53, 'M', u'禎'),
+    (0xFA54, 'M', u'穀'),
+    (0xFA55, 'M', u'突'),
+    (0xFA56, 'M', u'節'),
+    (0xFA57, 'M', u'練'),
+    (0xFA58, 'M', u'縉'),
+    (0xFA59, 'M', u'繁'),
+    (0xFA5A, 'M', u'署'),
+    (0xFA5B, 'M', u'者'),
+    (0xFA5C, 'M', u'臭'),
+    (0xFA5D, 'M', u'艹'),
+    (0xFA5F, 'M', u'著'),
+    (0xFA60, 'M', u'褐'),
+    (0xFA61, 'M', u'視'),
+    (0xFA62, 'M', u'謁'),
+    (0xFA63, 'M', u'謹'),
+    (0xFA64, 'M', u'賓'),
+    (0xFA65, 'M', u'贈'),
+    (0xFA66, 'M', u'辶'),
+    (0xFA67, 'M', u'逸'),
+    (0xFA68, 'M', u'難'),
+    (0xFA69, 'M', u'響'),
+    (0xFA6A, 'M', u'頻'),
+    (0xFA6B, 'M', u'恵'),
+    (0xFA6C, 'M', u'𤋮'),
+    (0xFA6D, 'M', u'舘'),
+    (0xFA6E, 'X'),
+    (0xFA70, 'M', u'並'),
+    (0xFA71, 'M', u'况'),
+    (0xFA72, 'M', u'全'),
+    (0xFA73, 'M', u'侀'),
+    (0xFA74, 'M', u'充'),
+    (0xFA75, 'M', u'冀'),
+    (0xFA76, 'M', u'勇'),
+    (0xFA77, 'M', u'勺'),
+    (0xFA78, 'M', u'喝'),
+    (0xFA79, 'M', u'啕'),
+    (0xFA7A, 'M', u'喙'),
+    (0xFA7B, 'M', u'嗢'),
+    (0xFA7C, 'M', u'塚'),
+    (0xFA7D, 'M', u'墳'),
+    (0xFA7E, 'M', u'奄'),
+    (0xFA7F, 'M', u'奔'),
+    (0xFA80, 'M', u'婢'),
+    (0xFA81, 'M', u'嬨'),
+    ]
+
+def _seg_43():
+    return [
+    (0xFA82, 'M', u'廒'),
+    (0xFA83, 'M', u'廙'),
+    (0xFA84, 'M', u'彩'),
+    (0xFA85, 'M', u'徭'),
+    (0xFA86, 'M', u'惘'),
+    (0xFA87, 'M', u'慎'),
+    (0xFA88, 'M', u'愈'),
+    (0xFA89, 'M', u'憎'),
+    (0xFA8A, 'M', u'慠'),
+    (0xFA8B, 'M', u'懲'),
+    (0xFA8C, 'M', u'戴'),
+    (0xFA8D, 'M', u'揄'),
+    (0xFA8E, 'M', u'搜'),
+    (0xFA8F, 'M', u'摒'),
+    (0xFA90, 'M', u'敖'),
+    (0xFA91, 'M', u'晴'),
+    (0xFA92, 'M', u'朗'),
+    (0xFA93, 'M', u'望'),
+    (0xFA94, 'M', u'杖'),
+    (0xFA95, 'M', u'歹'),
+    (0xFA96, 'M', u'殺'),
+    (0xFA97, 'M', u'流'),
+    (0xFA98, 'M', u'滛'),
+    (0xFA99, 'M', u'滋'),
+    (0xFA9A, 'M', u'漢'),
+    (0xFA9B, 'M', u'瀞'),
+    (0xFA9C, 'M', u'煮'),
+    (0xFA9D, 'M', u'瞧'),
+    (0xFA9E, 'M', u'爵'),
+    (0xFA9F, 'M', u'犯'),
+    (0xFAA0, 'M', u'猪'),
+    (0xFAA1, 'M', u'瑱'),
+    (0xFAA2, 'M', u'甆'),
+    (0xFAA3, 'M', u'画'),
+    (0xFAA4, 'M', u'瘝'),
+    (0xFAA5, 'M', u'瘟'),
+    (0xFAA6, 'M', u'益'),
+    (0xFAA7, 'M', u'盛'),
+    (0xFAA8, 'M', u'直'),
+    (0xFAA9, 'M', u'睊'),
+    (0xFAAA, 'M', u'着'),
+    (0xFAAB, 'M', u'磌'),
+    (0xFAAC, 'M', u'窱'),
+    (0xFAAD, 'M', u'節'),
+    (0xFAAE, 'M', u'类'),
+    (0xFAAF, 'M', u'絛'),
+    (0xFAB0, 'M', u'練'),
+    (0xFAB1, 'M', u'缾'),
+    (0xFAB2, 'M', u'者'),
+    (0xFAB3, 'M', u'荒'),
+    (0xFAB4, 'M', u'華'),
+    (0xFAB5, 'M', u'蝹'),
+    (0xFAB6, 'M', u'襁'),
+    (0xFAB7, 'M', u'覆'),
+    (0xFAB8, 'M', u'視'),
+    (0xFAB9, 'M', u'調'),
+    (0xFABA, 'M', u'諸'),
+    (0xFABB, 'M', u'請'),
+    (0xFABC, 'M', u'謁'),
+    (0xFABD, 'M', u'諾'),
+    (0xFABE, 'M', u'諭'),
+    (0xFABF, 'M', u'謹'),
+    (0xFAC0, 'M', u'變'),
+    (0xFAC1, 'M', u'贈'),
+    (0xFAC2, 'M', u'輸'),
+    (0xFAC3, 'M', u'遲'),
+    (0xFAC4, 'M', u'醙'),
+    (0xFAC5, 'M', u'鉶'),
+    (0xFAC6, 'M', u'陼'),
+    (0xFAC7, 'M', u'難'),
+    (0xFAC8, 'M', u'靖'),
+    (0xFAC9, 'M', u'韛'),
+    (0xFACA, 'M', u'響'),
+    (0xFACB, 'M', u'頋'),
+    (0xFACC, 'M', u'頻'),
+    (0xFACD, 'M', u'鬒'),
+    (0xFACE, 'M', u'龜'),
+    (0xFACF, 'M', u'𢡊'),
+    (0xFAD0, 'M', u'𢡄'),
+    (0xFAD1, 'M', u'𣏕'),
+    (0xFAD2, 'M', u'㮝'),
+    (0xFAD3, 'M', u'䀘'),
+    (0xFAD4, 'M', u'䀹'),
+    (0xFAD5, 'M', u'𥉉'),
+    (0xFAD6, 'M', u'𥳐'),
+    (0xFAD7, 'M', u'𧻓'),
+    (0xFAD8, 'M', u'齃'),
+    (0xFAD9, 'M', u'龎'),
+    (0xFADA, 'X'),
+    (0xFB00, 'M', u'ff'),
+    (0xFB01, 'M', u'fi'),
+    (0xFB02, 'M', u'fl'),
+    (0xFB03, 'M', u'ffi'),
+    (0xFB04, 'M', u'ffl'),
+    (0xFB05, 'M', u'st'),
+    (0xFB07, 'X'),
+    (0xFB13, 'M', u'մն'),
+    (0xFB14, 'M', u'մե'),
+    (0xFB15, 'M', u'մի'),
+    (0xFB16, 'M', u'վն'),
+    ]
+
+def _seg_44():
+    return [
+    (0xFB17, 'M', u'մխ'),
+    (0xFB18, 'X'),
+    (0xFB1D, 'M', u'יִ'),
+    (0xFB1E, 'V'),
+    (0xFB1F, 'M', u'ײַ'),
+    (0xFB20, 'M', u'ע'),
+    (0xFB21, 'M', u'א'),
+    (0xFB22, 'M', u'ד'),
+    (0xFB23, 'M', u'ה'),
+    (0xFB24, 'M', u'כ'),
+    (0xFB25, 'M', u'ל'),
+    (0xFB26, 'M', u'ם'),
+    (0xFB27, 'M', u'ר'),
+    (0xFB28, 'M', u'ת'),
+    (0xFB29, '3', u'+'),
+    (0xFB2A, 'M', u'שׁ'),
+    (0xFB2B, 'M', u'שׂ'),
+    (0xFB2C, 'M', u'שּׁ'),
+    (0xFB2D, 'M', u'שּׂ'),
+    (0xFB2E, 'M', u'אַ'),
+    (0xFB2F, 'M', u'אָ'),
+    (0xFB30, 'M', u'אּ'),
+    (0xFB31, 'M', u'בּ'),
+    (0xFB32, 'M', u'גּ'),
+    (0xFB33, 'M', u'דּ'),
+    (0xFB34, 'M', u'הּ'),
+    (0xFB35, 'M', u'וּ'),
+    (0xFB36, 'M', u'זּ'),
+    (0xFB37, 'X'),
+    (0xFB38, 'M', u'טּ'),
+    (0xFB39, 'M', u'יּ'),
+    (0xFB3A, 'M', u'ךּ'),
+    (0xFB3B, 'M', u'כּ'),
+    (0xFB3C, 'M', u'לּ'),
+    (0xFB3D, 'X'),
+    (0xFB3E, 'M', u'מּ'),
+    (0xFB3F, 'X'),
+    (0xFB40, 'M', u'נּ'),
+    (0xFB41, 'M', u'סּ'),
+    (0xFB42, 'X'),
+    (0xFB43, 'M', u'ףּ'),
+    (0xFB44, 'M', u'פּ'),
+    (0xFB45, 'X'),
+    (0xFB46, 'M', u'צּ'),
+    (0xFB47, 'M', u'קּ'),
+    (0xFB48, 'M', u'רּ'),
+    (0xFB49, 'M', u'שּ'),
+    (0xFB4A, 'M', u'תּ'),
+    (0xFB4B, 'M', u'וֹ'),
+    (0xFB4C, 'M', u'בֿ'),
+    (0xFB4D, 'M', u'כֿ'),
+    (0xFB4E, 'M', u'פֿ'),
+    (0xFB4F, 'M', u'אל'),
+    (0xFB50, 'M', u'ٱ'),
+    (0xFB52, 'M', u'ٻ'),
+    (0xFB56, 'M', u'پ'),
+    (0xFB5A, 'M', u'ڀ'),
+    (0xFB5E, 'M', u'ٺ'),
+    (0xFB62, 'M', u'ٿ'),
+    (0xFB66, 'M', u'ٹ'),
+    (0xFB6A, 'M', u'ڤ'),
+    (0xFB6E, 'M', u'ڦ'),
+    (0xFB72, 'M', u'ڄ'),
+    (0xFB76, 'M', u'ڃ'),
+    (0xFB7A, 'M', u'چ'),
+    (0xFB7E, 'M', u'ڇ'),
+    (0xFB82, 'M', u'ڍ'),
+    (0xFB84, 'M', u'ڌ'),
+    (0xFB86, 'M', u'ڎ'),
+    (0xFB88, 'M', u'ڈ'),
+    (0xFB8A, 'M', u'ژ'),
+    (0xFB8C, 'M', u'ڑ'),
+    (0xFB8E, 'M', u'ک'),
+    (0xFB92, 'M', u'گ'),
+    (0xFB96, 'M', u'ڳ'),
+    (0xFB9A, 'M', u'ڱ'),
+    (0xFB9E, 'M', u'ں'),
+    (0xFBA0, 'M', u'ڻ'),
+    (0xFBA4, 'M', u'ۀ'),
+    (0xFBA6, 'M', u'ہ'),
+    (0xFBAA, 'M', u'ھ'),
+    (0xFBAE, 'M', u'ے'),
+    (0xFBB0, 'M', u'ۓ'),
+    (0xFBB2, 'V'),
+    (0xFBC2, 'X'),
+    (0xFBD3, 'M', u'ڭ'),
+    (0xFBD7, 'M', u'ۇ'),
+    (0xFBD9, 'M', u'ۆ'),
+    (0xFBDB, 'M', u'ۈ'),
+    (0xFBDD, 'M', u'ۇٴ'),
+    (0xFBDE, 'M', u'ۋ'),
+    (0xFBE0, 'M', u'ۅ'),
+    (0xFBE2, 'M', u'ۉ'),
+    (0xFBE4, 'M', u'ې'),
+    (0xFBE8, 'M', u'ى'),
+    (0xFBEA, 'M', u'ئا'),
+    (0xFBEC, 'M', u'ئە'),
+    (0xFBEE, 'M', u'ئو'),
+    (0xFBF0, 'M', u'ئۇ'),
+    (0xFBF2, 'M', u'ئۆ'),
+    ]
+
+def _seg_45():
+    return [
+    (0xFBF4, 'M', u'ئۈ'),
+    (0xFBF6, 'M', u'ئې'),
+    (0xFBF9, 'M', u'ئى'),
+    (0xFBFC, 'M', u'ی'),
+    (0xFC00, 'M', u'ئج'),
+    (0xFC01, 'M', u'ئح'),
+    (0xFC02, 'M', u'ئم'),
+    (0xFC03, 'M', u'ئى'),
+    (0xFC04, 'M', u'ئي'),
+    (0xFC05, 'M', u'بج'),
+    (0xFC06, 'M', u'بح'),
+    (0xFC07, 'M', u'بخ'),
+    (0xFC08, 'M', u'بم'),
+    (0xFC09, 'M', u'بى'),
+    (0xFC0A, 'M', u'بي'),
+    (0xFC0B, 'M', u'تج'),
+    (0xFC0C, 'M', u'تح'),
+    (0xFC0D, 'M', u'تخ'),
+    (0xFC0E, 'M', u'تم'),
+    (0xFC0F, 'M', u'تى'),
+    (0xFC10, 'M', u'تي'),
+    (0xFC11, 'M', u'ثج'),
+    (0xFC12, 'M', u'ثم'),
+    (0xFC13, 'M', u'ثى'),
+    (0xFC14, 'M', u'ثي'),
+    (0xFC15, 'M', u'جح'),
+    (0xFC16, 'M', u'جم'),
+    (0xFC17, 'M', u'حج'),
+    (0xFC18, 'M', u'حم'),
+    (0xFC19, 'M', u'خج'),
+    (0xFC1A, 'M', u'خح'),
+    (0xFC1B, 'M', u'خم'),
+    (0xFC1C, 'M', u'سج'),
+    (0xFC1D, 'M', u'سح'),
+    (0xFC1E, 'M', u'سخ'),
+    (0xFC1F, 'M', u'سم'),
+    (0xFC20, 'M', u'صح'),
+    (0xFC21, 'M', u'صم'),
+    (0xFC22, 'M', u'ضج'),
+    (0xFC23, 'M', u'ضح'),
+    (0xFC24, 'M', u'ضخ'),
+    (0xFC25, 'M', u'ضم'),
+    (0xFC26, 'M', u'طح'),
+    (0xFC27, 'M', u'طم'),
+    (0xFC28, 'M', u'ظم'),
+    (0xFC29, 'M', u'عج'),
+    (0xFC2A, 'M', u'عم'),
+    (0xFC2B, 'M', u'غج'),
+    (0xFC2C, 'M', u'غم'),
+    (0xFC2D, 'M', u'فج'),
+    (0xFC2E, 'M', u'فح'),
+    (0xFC2F, 'M', u'فخ'),
+    (0xFC30, 'M', u'فم'),
+    (0xFC31, 'M', u'فى'),
+    (0xFC32, 'M', u'في'),
+    (0xFC33, 'M', u'قح'),
+    (0xFC34, 'M', u'قم'),
+    (0xFC35, 'M', u'قى'),
+    (0xFC36, 'M', u'قي'),
+    (0xFC37, 'M', u'كا'),
+    (0xFC38, 'M', u'كج'),
+    (0xFC39, 'M', u'كح'),
+    (0xFC3A, 'M', u'كخ'),
+    (0xFC3B, 'M', u'كل'),
+    (0xFC3C, 'M', u'كم'),
+    (0xFC3D, 'M', u'كى'),
+    (0xFC3E, 'M', u'كي'),
+    (0xFC3F, 'M', u'لج'),
+    (0xFC40, 'M', u'لح'),
+    (0xFC41, 'M', u'لخ'),
+    (0xFC42, 'M', u'لم'),
+    (0xFC43, 'M', u'لى'),
+    (0xFC44, 'M', u'لي'),
+    (0xFC45, 'M', u'مج'),
+    (0xFC46, 'M', u'مح'),
+    (0xFC47, 'M', u'مخ'),
+    (0xFC48, 'M', u'مم'),
+    (0xFC49, 'M', u'مى'),
+    (0xFC4A, 'M', u'مي'),
+    (0xFC4B, 'M', u'نج'),
+    (0xFC4C, 'M', u'نح'),
+    (0xFC4D, 'M', u'نخ'),
+    (0xFC4E, 'M', u'نم'),
+    (0xFC4F, 'M', u'نى'),
+    (0xFC50, 'M', u'ني'),
+    (0xFC51, 'M', u'هج'),
+    (0xFC52, 'M', u'هم'),
+    (0xFC53, 'M', u'هى'),
+    (0xFC54, 'M', u'هي'),
+    (0xFC55, 'M', u'يج'),
+    (0xFC56, 'M', u'يح'),
+    (0xFC57, 'M', u'يخ'),
+    (0xFC58, 'M', u'يم'),
+    (0xFC59, 'M', u'يى'),
+    (0xFC5A, 'M', u'يي'),
+    (0xFC5B, 'M', u'ذٰ'),
+    (0xFC5C, 'M', u'رٰ'),
+    (0xFC5D, 'M', u'ىٰ'),
+    (0xFC5E, '3', u' ٌّ'),
+    (0xFC5F, '3', u' ٍّ'),
+    ]
+
+def _seg_46():
+    return [
+    (0xFC60, '3', u' َّ'),
+    (0xFC61, '3', u' ُّ'),
+    (0xFC62, '3', u' ِّ'),
+    (0xFC63, '3', u' ّٰ'),
+    (0xFC64, 'M', u'ئر'),
+    (0xFC65, 'M', u'ئز'),
+    (0xFC66, 'M', u'ئم'),
+    (0xFC67, 'M', u'ئن'),
+    (0xFC68, 'M', u'ئى'),
+    (0xFC69, 'M', u'ئي'),
+    (0xFC6A, 'M', u'بر'),
+    (0xFC6B, 'M', u'بز'),
+    (0xFC6C, 'M', u'بم'),
+    (0xFC6D, 'M', u'بن'),
+    (0xFC6E, 'M', u'بى'),
+    (0xFC6F, 'M', u'بي'),
+    (0xFC70, 'M', u'تر'),
+    (0xFC71, 'M', u'تز'),
+    (0xFC72, 'M', u'تم'),
+    (0xFC73, 'M', u'تن'),
+    (0xFC74, 'M', u'تى'),
+    (0xFC75, 'M', u'تي'),
+    (0xFC76, 'M', u'ثر'),
+    (0xFC77, 'M', u'ثز'),
+    (0xFC78, 'M', u'ثم'),
+    (0xFC79, 'M', u'ثن'),
+    (0xFC7A, 'M', u'ثى'),
+    (0xFC7B, 'M', u'ثي'),
+    (0xFC7C, 'M', u'فى'),
+    (0xFC7D, 'M', u'في'),
+    (0xFC7E, 'M', u'قى'),
+    (0xFC7F, 'M', u'قي'),
+    (0xFC80, 'M', u'كا'),
+    (0xFC81, 'M', u'كل'),
+    (0xFC82, 'M', u'كم'),
+    (0xFC83, 'M', u'كى'),
+    (0xFC84, 'M', u'كي'),
+    (0xFC85, 'M', u'لم'),
+    (0xFC86, 'M', u'لى'),
+    (0xFC87, 'M', u'لي'),
+    (0xFC88, 'M', u'ما'),
+    (0xFC89, 'M', u'مم'),
+    (0xFC8A, 'M', u'نر'),
+    (0xFC8B, 'M', u'نز'),
+    (0xFC8C, 'M', u'نم'),
+    (0xFC8D, 'M', u'نن'),
+    (0xFC8E, 'M', u'نى'),
+    (0xFC8F, 'M', u'ني'),
+    (0xFC90, 'M', u'ىٰ'),
+    (0xFC91, 'M', u'ير'),
+    (0xFC92, 'M', u'يز'),
+    (0xFC93, 'M', u'يم'),
+    (0xFC94, 'M', u'ين'),
+    (0xFC95, 'M', u'يى'),
+    (0xFC96, 'M', u'يي'),
+    (0xFC97, 'M', u'ئج'),
+    (0xFC98, 'M', u'ئح'),
+    (0xFC99, 'M', u'ئخ'),
+    (0xFC9A, 'M', u'ئم'),
+    (0xFC9B, 'M', u'ئه'),
+    (0xFC9C, 'M', u'بج'),
+    (0xFC9D, 'M', u'بح'),
+    (0xFC9E, 'M', u'بخ'),
+    (0xFC9F, 'M', u'بم'),
+    (0xFCA0, 'M', u'به'),
+    (0xFCA1, 'M', u'تج'),
+    (0xFCA2, 'M', u'تح'),
+    (0xFCA3, 'M', u'تخ'),
+    (0xFCA4, 'M', u'تم'),
+    (0xFCA5, 'M', u'ته'),
+    (0xFCA6, 'M', u'ثم'),
+    (0xFCA7, 'M', u'جح'),
+    (0xFCA8, 'M', u'جم'),
+    (0xFCA9, 'M', u'حج'),
+    (0xFCAA, 'M', u'حم'),
+    (0xFCAB, 'M', u'خج'),
+    (0xFCAC, 'M', u'خم'),
+    (0xFCAD, 'M', u'سج'),
+    (0xFCAE, 'M', u'سح'),
+    (0xFCAF, 'M', u'سخ'),
+    (0xFCB0, 'M', u'سم'),
+    (0xFCB1, 'M', u'صح'),
+    (0xFCB2, 'M', u'صخ'),
+    (0xFCB3, 'M', u'صم'),
+    (0xFCB4, 'M', u'ضج'),
+    (0xFCB5, 'M', u'ضح'),
+    (0xFCB6, 'M', u'ضخ'),
+    (0xFCB7, 'M', u'ضم'),
+    (0xFCB8, 'M', u'طح'),
+    (0xFCB9, 'M', u'ظم'),
+    (0xFCBA, 'M', u'عج'),
+    (0xFCBB, 'M', u'عم'),
+    (0xFCBC, 'M', u'غج'),
+    (0xFCBD, 'M', u'غم'),
+    (0xFCBE, 'M', u'فج'),
+    (0xFCBF, 'M', u'فح'),
+    (0xFCC0, 'M', u'فخ'),
+    (0xFCC1, 'M', u'فم'),
+    (0xFCC2, 'M', u'قح'),
+    (0xFCC3, 'M', u'قم'),
+    ]
+
+def _seg_47():
+    return [
+    (0xFCC4, 'M', u'كج'),
+    (0xFCC5, 'M', u'كح'),
+    (0xFCC6, 'M', u'كخ'),
+    (0xFCC7, 'M', u'كل'),
+    (0xFCC8, 'M', u'كم'),
+    (0xFCC9, 'M', u'لج'),
+    (0xFCCA, 'M', u'لح'),
+    (0xFCCB, 'M', u'لخ'),
+    (0xFCCC, 'M', u'لم'),
+    (0xFCCD, 'M', u'له'),
+    (0xFCCE, 'M', u'مج'),
+    (0xFCCF, 'M', u'مح'),
+    (0xFCD0, 'M', u'مخ'),
+    (0xFCD1, 'M', u'مم'),
+    (0xFCD2, 'M', u'نج'),
+    (0xFCD3, 'M', u'نح'),
+    (0xFCD4, 'M', u'نخ'),
+    (0xFCD5, 'M', u'نم'),
+    (0xFCD6, 'M', u'نه'),
+    (0xFCD7, 'M', u'هج'),
+    (0xFCD8, 'M', u'هم'),
+    (0xFCD9, 'M', u'هٰ'),
+    (0xFCDA, 'M', u'يج'),
+    (0xFCDB, 'M', u'يح'),
+    (0xFCDC, 'M', u'يخ'),
+    (0xFCDD, 'M', u'يم'),
+    (0xFCDE, 'M', u'يه'),
+    (0xFCDF, 'M', u'ئم'),
+    (0xFCE0, 'M', u'ئه'),
+    (0xFCE1, 'M', u'بم'),
+    (0xFCE2, 'M', u'به'),
+    (0xFCE3, 'M', u'تم'),
+    (0xFCE4, 'M', u'ته'),
+    (0xFCE5, 'M', u'ثم'),
+    (0xFCE6, 'M', u'ثه'),
+    (0xFCE7, 'M', u'سم'),
+    (0xFCE8, 'M', u'سه'),
+    (0xFCE9, 'M', u'شم'),
+    (0xFCEA, 'M', u'شه'),
+    (0xFCEB, 'M', u'كل'),
+    (0xFCEC, 'M', u'كم'),
+    (0xFCED, 'M', u'لم'),
+    (0xFCEE, 'M', u'نم'),
+    (0xFCEF, 'M', u'نه'),
+    (0xFCF0, 'M', u'يم'),
+    (0xFCF1, 'M', u'يه'),
+    (0xFCF2, 'M', u'ـَّ'),
+    (0xFCF3, 'M', u'ـُّ'),
+    (0xFCF4, 'M', u'ـِّ'),
+    (0xFCF5, 'M', u'طى'),
+    (0xFCF6, 'M', u'طي'),
+    (0xFCF7, 'M', u'عى'),
+    (0xFCF8, 'M', u'عي'),
+    (0xFCF9, 'M', u'غى'),
+    (0xFCFA, 'M', u'غي'),
+    (0xFCFB, 'M', u'سى'),
+    (0xFCFC, 'M', u'سي'),
+    (0xFCFD, 'M', u'شى'),
+    (0xFCFE, 'M', u'شي'),
+    (0xFCFF, 'M', u'حى'),
+    (0xFD00, 'M', u'حي'),
+    (0xFD01, 'M', u'جى'),
+    (0xFD02, 'M', u'جي'),
+    (0xFD03, 'M', u'خى'),
+    (0xFD04, 'M', u'خي'),
+    (0xFD05, 'M', u'صى'),
+    (0xFD06, 'M', u'صي'),
+    (0xFD07, 'M', u'ضى'),
+    (0xFD08, 'M', u'ضي'),
+    (0xFD09, 'M', u'شج'),
+    (0xFD0A, 'M', u'شح'),
+    (0xFD0B, 'M', u'شخ'),
+    (0xFD0C, 'M', u'شم'),
+    (0xFD0D, 'M', u'شر'),
+    (0xFD0E, 'M', u'سر'),
+    (0xFD0F, 'M', u'صر'),
+    (0xFD10, 'M', u'ضر'),
+    (0xFD11, 'M', u'طى'),
+    (0xFD12, 'M', u'طي'),
+    (0xFD13, 'M', u'عى'),
+    (0xFD14, 'M', u'عي'),
+    (0xFD15, 'M', u'غى'),
+    (0xFD16, 'M', u'غي'),
+    (0xFD17, 'M', u'سى'),
+    (0xFD18, 'M', u'سي'),
+    (0xFD19, 'M', u'شى'),
+    (0xFD1A, 'M', u'شي'),
+    (0xFD1B, 'M', u'حى'),
+    (0xFD1C, 'M', u'حي'),
+    (0xFD1D, 'M', u'جى'),
+    (0xFD1E, 'M', u'جي'),
+    (0xFD1F, 'M', u'خى'),
+    (0xFD20, 'M', u'خي'),
+    (0xFD21, 'M', u'صى'),
+    (0xFD22, 'M', u'صي'),
+    (0xFD23, 'M', u'ضى'),
+    (0xFD24, 'M', u'ضي'),
+    (0xFD25, 'M', u'شج'),
+    (0xFD26, 'M', u'شح'),
+    (0xFD27, 'M', u'شخ'),
+    ]
+
+def _seg_48():
+    return [
+    (0xFD28, 'M', u'شم'),
+    (0xFD29, 'M', u'شر'),
+    (0xFD2A, 'M', u'سر'),
+    (0xFD2B, 'M', u'صر'),
+    (0xFD2C, 'M', u'ضر'),
+    (0xFD2D, 'M', u'شج'),
+    (0xFD2E, 'M', u'شح'),
+    (0xFD2F, 'M', u'شخ'),
+    (0xFD30, 'M', u'شم'),
+    (0xFD31, 'M', u'سه'),
+    (0xFD32, 'M', u'شه'),
+    (0xFD33, 'M', u'طم'),
+    (0xFD34, 'M', u'سج'),
+    (0xFD35, 'M', u'سح'),
+    (0xFD36, 'M', u'سخ'),
+    (0xFD37, 'M', u'شج'),
+    (0xFD38, 'M', u'شح'),
+    (0xFD39, 'M', u'شخ'),
+    (0xFD3A, 'M', u'طم'),
+    (0xFD3B, 'M', u'ظم'),
+    (0xFD3C, 'M', u'اً'),
+    (0xFD3E, 'V'),
+    (0xFD40, 'X'),
+    (0xFD50, 'M', u'تجم'),
+    (0xFD51, 'M', u'تحج'),
+    (0xFD53, 'M', u'تحم'),
+    (0xFD54, 'M', u'تخم'),
+    (0xFD55, 'M', u'تمج'),
+    (0xFD56, 'M', u'تمح'),
+    (0xFD57, 'M', u'تمخ'),
+    (0xFD58, 'M', u'جمح'),
+    (0xFD5A, 'M', u'حمي'),
+    (0xFD5B, 'M', u'حمى'),
+    (0xFD5C, 'M', u'سحج'),
+    (0xFD5D, 'M', u'سجح'),
+    (0xFD5E, 'M', u'سجى'),
+    (0xFD5F, 'M', u'سمح'),
+    (0xFD61, 'M', u'سمج'),
+    (0xFD62, 'M', u'سمم'),
+    (0xFD64, 'M', u'صحح'),
+    (0xFD66, 'M', u'صمم'),
+    (0xFD67, 'M', u'شحم'),
+    (0xFD69, 'M', u'شجي'),
+    (0xFD6A, 'M', u'شمخ'),
+    (0xFD6C, 'M', u'شمم'),
+    (0xFD6E, 'M', u'ضحى'),
+    (0xFD6F, 'M', u'ضخم'),
+    (0xFD71, 'M', u'طمح'),
+    (0xFD73, 'M', u'طمم'),
+    (0xFD74, 'M', u'طمي'),
+    (0xFD75, 'M', u'عجم'),
+    (0xFD76, 'M', u'عمم'),
+    (0xFD78, 'M', u'عمى'),
+    (0xFD79, 'M', u'غمم'),
+    (0xFD7A, 'M', u'غمي'),
+    (0xFD7B, 'M', u'غمى'),
+    (0xFD7C, 'M', u'فخم'),
+    (0xFD7E, 'M', u'قمح'),
+    (0xFD7F, 'M', u'قمم'),
+    (0xFD80, 'M', u'لحم'),
+    (0xFD81, 'M', u'لحي'),
+    (0xFD82, 'M', u'لحى'),
+    (0xFD83, 'M', u'لجج'),
+    (0xFD85, 'M', u'لخم'),
+    (0xFD87, 'M', u'لمح'),
+    (0xFD89, 'M', u'محج'),
+    (0xFD8A, 'M', u'محم'),
+    (0xFD8B, 'M', u'محي'),
+    (0xFD8C, 'M', u'مجح'),
+    (0xFD8D, 'M', u'مجم'),
+    (0xFD8E, 'M', u'مخج'),
+    (0xFD8F, 'M', u'مخم'),
+    (0xFD90, 'X'),
+    (0xFD92, 'M', u'مجخ'),
+    (0xFD93, 'M', u'همج'),
+    (0xFD94, 'M', u'همم'),
+    (0xFD95, 'M', u'نحم'),
+    (0xFD96, 'M', u'نحى'),
+    (0xFD97, 'M', u'نجم'),
+    (0xFD99, 'M', u'نجى'),
+    (0xFD9A, 'M', u'نمي'),
+    (0xFD9B, 'M', u'نمى'),
+    (0xFD9C, 'M', u'يمم'),
+    (0xFD9E, 'M', u'بخي'),
+    (0xFD9F, 'M', u'تجي'),
+    (0xFDA0, 'M', u'تجى'),
+    (0xFDA1, 'M', u'تخي'),
+    (0xFDA2, 'M', u'تخى'),
+    (0xFDA3, 'M', u'تمي'),
+    (0xFDA4, 'M', u'تمى'),
+    (0xFDA5, 'M', u'جمي'),
+    (0xFDA6, 'M', u'جحى'),
+    (0xFDA7, 'M', u'جمى'),
+    (0xFDA8, 'M', u'سخى'),
+    (0xFDA9, 'M', u'صحي'),
+    (0xFDAA, 'M', u'شحي'),
+    (0xFDAB, 'M', u'ضحي'),
+    (0xFDAC, 'M', u'لجي'),
+    (0xFDAD, 'M', u'لمي'),
+    (0xFDAE, 'M', u'يحي'),
+    ]
+
+def _seg_49():
+    return [
+    (0xFDAF, 'M', u'يجي'),
+    (0xFDB0, 'M', u'يمي'),
+    (0xFDB1, 'M', u'ممي'),
+    (0xFDB2, 'M', u'قمي'),
+    (0xFDB3, 'M', u'نحي'),
+    (0xFDB4, 'M', u'قمح'),
+    (0xFDB5, 'M', u'لحم'),
+    (0xFDB6, 'M', u'عمي'),
+    (0xFDB7, 'M', u'كمي'),
+    (0xFDB8, 'M', u'نجح'),
+    (0xFDB9, 'M', u'مخي'),
+    (0xFDBA, 'M', u'لجم'),
+    (0xFDBB, 'M', u'كمم'),
+    (0xFDBC, 'M', u'لجم'),
+    (0xFDBD, 'M', u'نجح'),
+    (0xFDBE, 'M', u'جحي'),
+    (0xFDBF, 'M', u'حجي'),
+    (0xFDC0, 'M', u'مجي'),
+    (0xFDC1, 'M', u'فمي'),
+    (0xFDC2, 'M', u'بحي'),
+    (0xFDC3, 'M', u'كمم'),
+    (0xFDC4, 'M', u'عجم'),
+    (0xFDC5, 'M', u'صمم'),
+    (0xFDC6, 'M', u'سخي'),
+    (0xFDC7, 'M', u'نجي'),
+    (0xFDC8, 'X'),
+    (0xFDF0, 'M', u'صلے'),
+    (0xFDF1, 'M', u'قلے'),
+    (0xFDF2, 'M', u'الله'),
+    (0xFDF3, 'M', u'اكبر'),
+    (0xFDF4, 'M', u'محمد'),
+    (0xFDF5, 'M', u'صلعم'),
+    (0xFDF6, 'M', u'رسول'),
+    (0xFDF7, 'M', u'عليه'),
+    (0xFDF8, 'M', u'وسلم'),
+    (0xFDF9, 'M', u'صلى'),
+    (0xFDFA, '3', u'صلى الله عليه وسلم'),
+    (0xFDFB, '3', u'جل جلاله'),
+    (0xFDFC, 'M', u'ریال'),
+    (0xFDFD, 'V'),
+    (0xFDFE, 'X'),
+    (0xFE00, 'I'),
+    (0xFE10, '3', u','),
+    (0xFE11, 'M', u'、'),
+    (0xFE12, 'X'),
+    (0xFE13, '3', u':'),
+    (0xFE14, '3', u';'),
+    (0xFE15, '3', u'!'),
+    (0xFE16, '3', u'?'),
+    (0xFE17, 'M', u'〖'),
+    (0xFE18, 'M', u'〗'),
+    (0xFE19, 'X'),
+    (0xFE20, 'V'),
+    (0xFE30, 'X'),
+    (0xFE31, 'M', u'—'),
+    (0xFE32, 'M', u'–'),
+    (0xFE33, '3', u'_'),
+    (0xFE35, '3', u'('),
+    (0xFE36, '3', u')'),
+    (0xFE37, '3', u'{'),
+    (0xFE38, '3', u'}'),
+    (0xFE39, 'M', u'〔'),
+    (0xFE3A, 'M', u'〕'),
+    (0xFE3B, 'M', u'【'),
+    (0xFE3C, 'M', u'】'),
+    (0xFE3D, 'M', u'《'),
+    (0xFE3E, 'M', u'》'),
+    (0xFE3F, 'M', u'〈'),
+    (0xFE40, 'M', u'〉'),
+    (0xFE41, 'M', u'「'),
+    (0xFE42, 'M', u'」'),
+    (0xFE43, 'M', u'『'),
+    (0xFE44, 'M', u'』'),
+    (0xFE45, 'V'),
+    (0xFE47, '3', u'['),
+    (0xFE48, '3', u']'),
+    (0xFE49, '3', u' ̅'),
+    (0xFE4D, '3', u'_'),
+    (0xFE50, '3', u','),
+    (0xFE51, 'M', u'、'),
+    (0xFE52, 'X'),
+    (0xFE54, '3', u';'),
+    (0xFE55, '3', u':'),
+    (0xFE56, '3', u'?'),
+    (0xFE57, '3', u'!'),
+    (0xFE58, 'M', u'—'),
+    (0xFE59, '3', u'('),
+    (0xFE5A, '3', u')'),
+    (0xFE5B, '3', u'{'),
+    (0xFE5C, '3', u'}'),
+    (0xFE5D, 'M', u'〔'),
+    (0xFE5E, 'M', u'〕'),
+    (0xFE5F, '3', u'#'),
+    (0xFE60, '3', u'&'),
+    (0xFE61, '3', u'*'),
+    (0xFE62, '3', u'+'),
+    (0xFE63, 'M', u'-'),
+    (0xFE64, '3', u'<'),
+    (0xFE65, '3', u'>'),
+    (0xFE66, '3', u'='),
+    ]
+
+def _seg_50():
+    return [
+    (0xFE67, 'X'),
+    (0xFE68, '3', u'\\'),
+    (0xFE69, '3', u'$'),
+    (0xFE6A, '3', u'%'),
+    (0xFE6B, '3', u'@'),
+    (0xFE6C, 'X'),
+    (0xFE70, '3', u' ً'),
+    (0xFE71, 'M', u'ـً'),
+    (0xFE72, '3', u' ٌ'),
+    (0xFE73, 'V'),
+    (0xFE74, '3', u' ٍ'),
+    (0xFE75, 'X'),
+    (0xFE76, '3', u' َ'),
+    (0xFE77, 'M', u'ـَ'),
+    (0xFE78, '3', u' ُ'),
+    (0xFE79, 'M', u'ـُ'),
+    (0xFE7A, '3', u' ِ'),
+    (0xFE7B, 'M', u'ـِ'),
+    (0xFE7C, '3', u' ّ'),
+    (0xFE7D, 'M', u'ـّ'),
+    (0xFE7E, '3', u' ْ'),
+    (0xFE7F, 'M', u'ـْ'),
+    (0xFE80, 'M', u'ء'),
+    (0xFE81, 'M', u'آ'),
+    (0xFE83, 'M', u'أ'),
+    (0xFE85, 'M', u'ؤ'),
+    (0xFE87, 'M', u'إ'),
+    (0xFE89, 'M', u'ئ'),
+    (0xFE8D, 'M', u'ا'),
+    (0xFE8F, 'M', u'ب'),
+    (0xFE93, 'M', u'ة'),
+    (0xFE95, 'M', u'ت'),
+    (0xFE99, 'M', u'ث'),
+    (0xFE9D, 'M', u'ج'),
+    (0xFEA1, 'M', u'ح'),
+    (0xFEA5, 'M', u'خ'),
+    (0xFEA9, 'M', u'د'),
+    (0xFEAB, 'M', u'ذ'),
+    (0xFEAD, 'M', u'ر'),
+    (0xFEAF, 'M', u'ز'),
+    (0xFEB1, 'M', u'س'),
+    (0xFEB5, 'M', u'ش'),
+    (0xFEB9, 'M', u'ص'),
+    (0xFEBD, 'M', u'ض'),
+    (0xFEC1, 'M', u'ط'),
+    (0xFEC5, 'M', u'ظ'),
+    (0xFEC9, 'M', u'ع'),
+    (0xFECD, 'M', u'غ'),
+    (0xFED1, 'M', u'ف'),
+    (0xFED5, 'M', u'ق'),
+    (0xFED9, 'M', u'ك'),
+    (0xFEDD, 'M', u'ل'),
+    (0xFEE1, 'M', u'م'),
+    (0xFEE5, 'M', u'ن'),
+    (0xFEE9, 'M', u'ه'),
+    (0xFEED, 'M', u'و'),
+    (0xFEEF, 'M', u'ى'),
+    (0xFEF1, 'M', u'ي'),
+    (0xFEF5, 'M', u'لآ'),
+    (0xFEF7, 'M', u'لأ'),
+    (0xFEF9, 'M', u'لإ'),
+    (0xFEFB, 'M', u'لا'),
+    (0xFEFD, 'X'),
+    (0xFEFF, 'I'),
+    (0xFF00, 'X'),
+    (0xFF01, '3', u'!'),
+    (0xFF02, '3', u'"'),
+    (0xFF03, '3', u'#'),
+    (0xFF04, '3', u'$'),
+    (0xFF05, '3', u'%'),
+    (0xFF06, '3', u'&'),
+    (0xFF07, '3', u'\''),
+    (0xFF08, '3', u'('),
+    (0xFF09, '3', u')'),
+    (0xFF0A, '3', u'*'),
+    (0xFF0B, '3', u'+'),
+    (0xFF0C, '3', u','),
+    (0xFF0D, 'M', u'-'),
+    (0xFF0E, 'M', u'.'),
+    (0xFF0F, '3', u'/'),
+    (0xFF10, 'M', u'0'),
+    (0xFF11, 'M', u'1'),
+    (0xFF12, 'M', u'2'),
+    (0xFF13, 'M', u'3'),
+    (0xFF14, 'M', u'4'),
+    (0xFF15, 'M', u'5'),
+    (0xFF16, 'M', u'6'),
+    (0xFF17, 'M', u'7'),
+    (0xFF18, 'M', u'8'),
+    (0xFF19, 'M', u'9'),
+    (0xFF1A, '3', u':'),
+    (0xFF1B, '3', u';'),
+    (0xFF1C, '3', u'<'),
+    (0xFF1D, '3', u'='),
+    (0xFF1E, '3', u'>'),
+    (0xFF1F, '3', u'?'),
+    (0xFF20, '3', u'@'),
+    (0xFF21, 'M', u'a'),
+    (0xFF22, 'M', u'b'),
+    (0xFF23, 'M', u'c'),
+    ]
+
+def _seg_51():
+    return [
+    (0xFF24, 'M', u'd'),
+    (0xFF25, 'M', u'e'),
+    (0xFF26, 'M', u'f'),
+    (0xFF27, 'M', u'g'),
+    (0xFF28, 'M', u'h'),
+    (0xFF29, 'M', u'i'),
+    (0xFF2A, 'M', u'j'),
+    (0xFF2B, 'M', u'k'),
+    (0xFF2C, 'M', u'l'),
+    (0xFF2D, 'M', u'm'),
+    (0xFF2E, 'M', u'n'),
+    (0xFF2F, 'M', u'o'),
+    (0xFF30, 'M', u'p'),
+    (0xFF31, 'M', u'q'),
+    (0xFF32, 'M', u'r'),
+    (0xFF33, 'M', u's'),
+    (0xFF34, 'M', u't'),
+    (0xFF35, 'M', u'u'),
+    (0xFF36, 'M', u'v'),
+    (0xFF37, 'M', u'w'),
+    (0xFF38, 'M', u'x'),
+    (0xFF39, 'M', u'y'),
+    (0xFF3A, 'M', u'z'),
+    (0xFF3B, '3', u'['),
+    (0xFF3C, '3', u'\\'),
+    (0xFF3D, '3', u']'),
+    (0xFF3E, '3', u'^'),
+    (0xFF3F, '3', u'_'),
+    (0xFF40, '3', u'`'),
+    (0xFF41, 'M', u'a'),
+    (0xFF42, 'M', u'b'),
+    (0xFF43, 'M', u'c'),
+    (0xFF44, 'M', u'd'),
+    (0xFF45, 'M', u'e'),
+    (0xFF46, 'M', u'f'),
+    (0xFF47, 'M', u'g'),
+    (0xFF48, 'M', u'h'),
+    (0xFF49, 'M', u'i'),
+    (0xFF4A, 'M', u'j'),
+    (0xFF4B, 'M', u'k'),
+    (0xFF4C, 'M', u'l'),
+    (0xFF4D, 'M', u'm'),
+    (0xFF4E, 'M', u'n'),
+    (0xFF4F, 'M', u'o'),
+    (0xFF50, 'M', u'p'),
+    (0xFF51, 'M', u'q'),
+    (0xFF52, 'M', u'r'),
+    (0xFF53, 'M', u's'),
+    (0xFF54, 'M', u't'),
+    (0xFF55, 'M', u'u'),
+    (0xFF56, 'M', u'v'),
+    (0xFF57, 'M', u'w'),
+    (0xFF58, 'M', u'x'),
+    (0xFF59, 'M', u'y'),
+    (0xFF5A, 'M', u'z'),
+    (0xFF5B, '3', u'{'),
+    (0xFF5C, '3', u'|'),
+    (0xFF5D, '3', u'}'),
+    (0xFF5E, '3', u'~'),
+    (0xFF5F, 'M', u'⦅'),
+    (0xFF60, 'M', u'⦆'),
+    (0xFF61, 'M', u'.'),
+    (0xFF62, 'M', u'「'),
+    (0xFF63, 'M', u'」'),
+    (0xFF64, 'M', u'、'),
+    (0xFF65, 'M', u'・'),
+    (0xFF66, 'M', u'ヲ'),
+    (0xFF67, 'M', u'ァ'),
+    (0xFF68, 'M', u'ィ'),
+    (0xFF69, 'M', u'ゥ'),
+    (0xFF6A, 'M', u'ェ'),
+    (0xFF6B, 'M', u'ォ'),
+    (0xFF6C, 'M', u'ャ'),
+    (0xFF6D, 'M', u'ュ'),
+    (0xFF6E, 'M', u'ョ'),
+    (0xFF6F, 'M', u'ッ'),
+    (0xFF70, 'M', u'ー'),
+    (0xFF71, 'M', u'ア'),
+    (0xFF72, 'M', u'イ'),
+    (0xFF73, 'M', u'ウ'),
+    (0xFF74, 'M', u'エ'),
+    (0xFF75, 'M', u'オ'),
+    (0xFF76, 'M', u'カ'),
+    (0xFF77, 'M', u'キ'),
+    (0xFF78, 'M', u'ク'),
+    (0xFF79, 'M', u'ケ'),
+    (0xFF7A, 'M', u'コ'),
+    (0xFF7B, 'M', u'サ'),
+    (0xFF7C, 'M', u'シ'),
+    (0xFF7D, 'M', u'ス'),
+    (0xFF7E, 'M', u'セ'),
+    (0xFF7F, 'M', u'ソ'),
+    (0xFF80, 'M', u'タ'),
+    (0xFF81, 'M', u'チ'),
+    (0xFF82, 'M', u'ツ'),
+    (0xFF83, 'M', u'テ'),
+    (0xFF84, 'M', u'ト'),
+    (0xFF85, 'M', u'ナ'),
+    (0xFF86, 'M', u'ニ'),
+    (0xFF87, 'M', u'ヌ'),
+    ]
+
+def _seg_52():
+    return [
+    (0xFF88, 'M', u'ネ'),
+    (0xFF89, 'M', u'ノ'),
+    (0xFF8A, 'M', u'ハ'),
+    (0xFF8B, 'M', u'ヒ'),
+    (0xFF8C, 'M', u'フ'),
+    (0xFF8D, 'M', u'ヘ'),
+    (0xFF8E, 'M', u'ホ'),
+    (0xFF8F, 'M', u'マ'),
+    (0xFF90, 'M', u'ミ'),
+    (0xFF91, 'M', u'ム'),
+    (0xFF92, 'M', u'メ'),
+    (0xFF93, 'M', u'モ'),
+    (0xFF94, 'M', u'ヤ'),
+    (0xFF95, 'M', u'ユ'),
+    (0xFF96, 'M', u'ヨ'),
+    (0xFF97, 'M', u'ラ'),
+    (0xFF98, 'M', u'リ'),
+    (0xFF99, 'M', u'ル'),
+    (0xFF9A, 'M', u'レ'),
+    (0xFF9B, 'M', u'ロ'),
+    (0xFF9C, 'M', u'ワ'),
+    (0xFF9D, 'M', u'ン'),
+    (0xFF9E, 'M', u'゙'),
+    (0xFF9F, 'M', u'゚'),
+    (0xFFA0, 'X'),
+    (0xFFA1, 'M', u'ᄀ'),
+    (0xFFA2, 'M', u'ᄁ'),
+    (0xFFA3, 'M', u'ᆪ'),
+    (0xFFA4, 'M', u'ᄂ'),
+    (0xFFA5, 'M', u'ᆬ'),
+    (0xFFA6, 'M', u'ᆭ'),
+    (0xFFA7, 'M', u'ᄃ'),
+    (0xFFA8, 'M', u'ᄄ'),
+    (0xFFA9, 'M', u'ᄅ'),
+    (0xFFAA, 'M', u'ᆰ'),
+    (0xFFAB, 'M', u'ᆱ'),
+    (0xFFAC, 'M', u'ᆲ'),
+    (0xFFAD, 'M', u'ᆳ'),
+    (0xFFAE, 'M', u'ᆴ'),
+    (0xFFAF, 'M', u'ᆵ'),
+    (0xFFB0, 'M', u'ᄚ'),
+    (0xFFB1, 'M', u'ᄆ'),
+    (0xFFB2, 'M', u'ᄇ'),
+    (0xFFB3, 'M', u'ᄈ'),
+    (0xFFB4, 'M', u'ᄡ'),
+    (0xFFB5, 'M', u'ᄉ'),
+    (0xFFB6, 'M', u'ᄊ'),
+    (0xFFB7, 'M', u'ᄋ'),
+    (0xFFB8, 'M', u'ᄌ'),
+    (0xFFB9, 'M', u'ᄍ'),
+    (0xFFBA, 'M', u'ᄎ'),
+    (0xFFBB, 'M', u'ᄏ'),
+    (0xFFBC, 'M', u'ᄐ'),
+    (0xFFBD, 'M', u'ᄑ'),
+    (0xFFBE, 'M', u'ᄒ'),
+    (0xFFBF, 'X'),
+    (0xFFC2, 'M', u'ᅡ'),
+    (0xFFC3, 'M', u'ᅢ'),
+    (0xFFC4, 'M', u'ᅣ'),
+    (0xFFC5, 'M', u'ᅤ'),
+    (0xFFC6, 'M', u'ᅥ'),
+    (0xFFC7, 'M', u'ᅦ'),
+    (0xFFC8, 'X'),
+    (0xFFCA, 'M', u'ᅧ'),
+    (0xFFCB, 'M', u'ᅨ'),
+    (0xFFCC, 'M', u'ᅩ'),
+    (0xFFCD, 'M', u'ᅪ'),
+    (0xFFCE, 'M', u'ᅫ'),
+    (0xFFCF, 'M', u'ᅬ'),
+    (0xFFD0, 'X'),
+    (0xFFD2, 'M', u'ᅭ'),
+    (0xFFD3, 'M', u'ᅮ'),
+    (0xFFD4, 'M', u'ᅯ'),
+    (0xFFD5, 'M', u'ᅰ'),
+    (0xFFD6, 'M', u'ᅱ'),
+    (0xFFD7, 'M', u'ᅲ'),
+    (0xFFD8, 'X'),
+    (0xFFDA, 'M', u'ᅳ'),
+    (0xFFDB, 'M', u'ᅴ'),
+    (0xFFDC, 'M', u'ᅵ'),
+    (0xFFDD, 'X'),
+    (0xFFE0, 'M', u'¢'),
+    (0xFFE1, 'M', u'£'),
+    (0xFFE2, 'M', u'¬'),
+    (0xFFE3, '3', u' ̄'),
+    (0xFFE4, 'M', u'¦'),
+    (0xFFE5, 'M', u'¥'),
+    (0xFFE6, 'M', u'₩'),
+    (0xFFE7, 'X'),
+    (0xFFE8, 'M', u'│'),
+    (0xFFE9, 'M', u'←'),
+    (0xFFEA, 'M', u'↑'),
+    (0xFFEB, 'M', u'→'),
+    (0xFFEC, 'M', u'↓'),
+    (0xFFED, 'M', u'■'),
+    (0xFFEE, 'M', u'○'),
+    (0xFFEF, 'X'),
+    (0x10000, 'V'),
+    (0x1000C, 'X'),
+    (0x1000D, 'V'),
+    ]
+
+def _seg_53():
+    return [
+    (0x10027, 'X'),
+    (0x10028, 'V'),
+    (0x1003B, 'X'),
+    (0x1003C, 'V'),
+    (0x1003E, 'X'),
+    (0x1003F, 'V'),
+    (0x1004E, 'X'),
+    (0x10050, 'V'),
+    (0x1005E, 'X'),
+    (0x10080, 'V'),
+    (0x100FB, 'X'),
+    (0x10100, 'V'),
+    (0x10103, 'X'),
+    (0x10107, 'V'),
+    (0x10134, 'X'),
+    (0x10137, 'V'),
+    (0x1018F, 'X'),
+    (0x10190, 'V'),
+    (0x1019D, 'X'),
+    (0x101A0, 'V'),
+    (0x101A1, 'X'),
+    (0x101D0, 'V'),
+    (0x101FE, 'X'),
+    (0x10280, 'V'),
+    (0x1029D, 'X'),
+    (0x102A0, 'V'),
+    (0x102D1, 'X'),
+    (0x102E0, 'V'),
+    (0x102FC, 'X'),
+    (0x10300, 'V'),
+    (0x10324, 'X'),
+    (0x1032D, 'V'),
+    (0x1034B, 'X'),
+    (0x10350, 'V'),
+    (0x1037B, 'X'),
+    (0x10380, 'V'),
+    (0x1039E, 'X'),
+    (0x1039F, 'V'),
+    (0x103C4, 'X'),
+    (0x103C8, 'V'),
+    (0x103D6, 'X'),
+    (0x10400, 'M', u'𐐨'),
+    (0x10401, 'M', u'𐐩'),
+    (0x10402, 'M', u'𐐪'),
+    (0x10403, 'M', u'𐐫'),
+    (0x10404, 'M', u'𐐬'),
+    (0x10405, 'M', u'𐐭'),
+    (0x10406, 'M', u'𐐮'),
+    (0x10407, 'M', u'𐐯'),
+    (0x10408, 'M', u'𐐰'),
+    (0x10409, 'M', u'𐐱'),
+    (0x1040A, 'M', u'𐐲'),
+    (0x1040B, 'M', u'𐐳'),
+    (0x1040C, 'M', u'𐐴'),
+    (0x1040D, 'M', u'𐐵'),
+    (0x1040E, 'M', u'𐐶'),
+    (0x1040F, 'M', u'𐐷'),
+    (0x10410, 'M', u'𐐸'),
+    (0x10411, 'M', u'𐐹'),
+    (0x10412, 'M', u'𐐺'),
+    (0x10413, 'M', u'𐐻'),
+    (0x10414, 'M', u'𐐼'),
+    (0x10415, 'M', u'𐐽'),
+    (0x10416, 'M', u'𐐾'),
+    (0x10417, 'M', u'𐐿'),
+    (0x10418, 'M', u'𐑀'),
+    (0x10419, 'M', u'𐑁'),
+    (0x1041A, 'M', u'𐑂'),
+    (0x1041B, 'M', u'𐑃'),
+    (0x1041C, 'M', u'𐑄'),
+    (0x1041D, 'M', u'𐑅'),
+    (0x1041E, 'M', u'𐑆'),
+    (0x1041F, 'M', u'𐑇'),
+    (0x10420, 'M', u'𐑈'),
+    (0x10421, 'M', u'𐑉'),
+    (0x10422, 'M', u'𐑊'),
+    (0x10423, 'M', u'𐑋'),
+    (0x10424, 'M', u'𐑌'),
+    (0x10425, 'M', u'𐑍'),
+    (0x10426, 'M', u'𐑎'),
+    (0x10427, 'M', u'𐑏'),
+    (0x10428, 'V'),
+    (0x1049E, 'X'),
+    (0x104A0, 'V'),
+    (0x104AA, 'X'),
+    (0x104B0, 'M', u'𐓘'),
+    (0x104B1, 'M', u'𐓙'),
+    (0x104B2, 'M', u'𐓚'),
+    (0x104B3, 'M', u'𐓛'),
+    (0x104B4, 'M', u'𐓜'),
+    (0x104B5, 'M', u'𐓝'),
+    (0x104B6, 'M', u'𐓞'),
+    (0x104B7, 'M', u'𐓟'),
+    (0x104B8, 'M', u'𐓠'),
+    (0x104B9, 'M', u'𐓡'),
+    (0x104BA, 'M', u'𐓢'),
+    (0x104BB, 'M', u'𐓣'),
+    (0x104BC, 'M', u'𐓤'),
+    (0x104BD, 'M', u'𐓥'),
+    (0x104BE, 'M', u'𐓦'),
+    ]
+
+def _seg_54():
+    return [
+    (0x104BF, 'M', u'𐓧'),
+    (0x104C0, 'M', u'𐓨'),
+    (0x104C1, 'M', u'𐓩'),
+    (0x104C2, 'M', u'𐓪'),
+    (0x104C3, 'M', u'𐓫'),
+    (0x104C4, 'M', u'𐓬'),
+    (0x104C5, 'M', u'𐓭'),
+    (0x104C6, 'M', u'𐓮'),
+    (0x104C7, 'M', u'𐓯'),
+    (0x104C8, 'M', u'𐓰'),
+    (0x104C9, 'M', u'𐓱'),
+    (0x104CA, 'M', u'𐓲'),
+    (0x104CB, 'M', u'𐓳'),
+    (0x104CC, 'M', u'𐓴'),
+    (0x104CD, 'M', u'𐓵'),
+    (0x104CE, 'M', u'𐓶'),
+    (0x104CF, 'M', u'𐓷'),
+    (0x104D0, 'M', u'𐓸'),
+    (0x104D1, 'M', u'𐓹'),
+    (0x104D2, 'M', u'𐓺'),
+    (0x104D3, 'M', u'𐓻'),
+    (0x104D4, 'X'),
+    (0x104D8, 'V'),
+    (0x104FC, 'X'),
+    (0x10500, 'V'),
+    (0x10528, 'X'),
+    (0x10530, 'V'),
+    (0x10564, 'X'),
+    (0x1056F, 'V'),
+    (0x10570, 'X'),
+    (0x10600, 'V'),
+    (0x10737, 'X'),
+    (0x10740, 'V'),
+    (0x10756, 'X'),
+    (0x10760, 'V'),
+    (0x10768, 'X'),
+    (0x10800, 'V'),
+    (0x10806, 'X'),
+    (0x10808, 'V'),
+    (0x10809, 'X'),
+    (0x1080A, 'V'),
+    (0x10836, 'X'),
+    (0x10837, 'V'),
+    (0x10839, 'X'),
+    (0x1083C, 'V'),
+    (0x1083D, 'X'),
+    (0x1083F, 'V'),
+    (0x10856, 'X'),
+    (0x10857, 'V'),
+    (0x1089F, 'X'),
+    (0x108A7, 'V'),
+    (0x108B0, 'X'),
+    (0x108E0, 'V'),
+    (0x108F3, 'X'),
+    (0x108F4, 'V'),
+    (0x108F6, 'X'),
+    (0x108FB, 'V'),
+    (0x1091C, 'X'),
+    (0x1091F, 'V'),
+    (0x1093A, 'X'),
+    (0x1093F, 'V'),
+    (0x10940, 'X'),
+    (0x10980, 'V'),
+    (0x109B8, 'X'),
+    (0x109BC, 'V'),
+    (0x109D0, 'X'),
+    (0x109D2, 'V'),
+    (0x10A04, 'X'),
+    (0x10A05, 'V'),
+    (0x10A07, 'X'),
+    (0x10A0C, 'V'),
+    (0x10A14, 'X'),
+    (0x10A15, 'V'),
+    (0x10A18, 'X'),
+    (0x10A19, 'V'),
+    (0x10A36, 'X'),
+    (0x10A38, 'V'),
+    (0x10A3B, 'X'),
+    (0x10A3F, 'V'),
+    (0x10A49, 'X'),
+    (0x10A50, 'V'),
+    (0x10A59, 'X'),
+    (0x10A60, 'V'),
+    (0x10AA0, 'X'),
+    (0x10AC0, 'V'),
+    (0x10AE7, 'X'),
+    (0x10AEB, 'V'),
+    (0x10AF7, 'X'),
+    (0x10B00, 'V'),
+    (0x10B36, 'X'),
+    (0x10B39, 'V'),
+    (0x10B56, 'X'),
+    (0x10B58, 'V'),
+    (0x10B73, 'X'),
+    (0x10B78, 'V'),
+    (0x10B92, 'X'),
+    (0x10B99, 'V'),
+    (0x10B9D, 'X'),
+    (0x10BA9, 'V'),
+    (0x10BB0, 'X'),
+    ]
+
+def _seg_55():
+    return [
+    (0x10C00, 'V'),
+    (0x10C49, 'X'),
+    (0x10C80, 'M', u'𐳀'),
+    (0x10C81, 'M', u'𐳁'),
+    (0x10C82, 'M', u'𐳂'),
+    (0x10C83, 'M', u'𐳃'),
+    (0x10C84, 'M', u'𐳄'),
+    (0x10C85, 'M', u'𐳅'),
+    (0x10C86, 'M', u'𐳆'),
+    (0x10C87, 'M', u'𐳇'),
+    (0x10C88, 'M', u'𐳈'),
+    (0x10C89, 'M', u'𐳉'),
+    (0x10C8A, 'M', u'𐳊'),
+    (0x10C8B, 'M', u'𐳋'),
+    (0x10C8C, 'M', u'𐳌'),
+    (0x10C8D, 'M', u'𐳍'),
+    (0x10C8E, 'M', u'𐳎'),
+    (0x10C8F, 'M', u'𐳏'),
+    (0x10C90, 'M', u'𐳐'),
+    (0x10C91, 'M', u'𐳑'),
+    (0x10C92, 'M', u'𐳒'),
+    (0x10C93, 'M', u'𐳓'),
+    (0x10C94, 'M', u'𐳔'),
+    (0x10C95, 'M', u'𐳕'),
+    (0x10C96, 'M', u'𐳖'),
+    (0x10C97, 'M', u'𐳗'),
+    (0x10C98, 'M', u'𐳘'),
+    (0x10C99, 'M', u'𐳙'),
+    (0x10C9A, 'M', u'𐳚'),
+    (0x10C9B, 'M', u'𐳛'),
+    (0x10C9C, 'M', u'𐳜'),
+    (0x10C9D, 'M', u'𐳝'),
+    (0x10C9E, 'M', u'𐳞'),
+    (0x10C9F, 'M', u'𐳟'),
+    (0x10CA0, 'M', u'𐳠'),
+    (0x10CA1, 'M', u'𐳡'),
+    (0x10CA2, 'M', u'𐳢'),
+    (0x10CA3, 'M', u'𐳣'),
+    (0x10CA4, 'M', u'𐳤'),
+    (0x10CA5, 'M', u'𐳥'),
+    (0x10CA6, 'M', u'𐳦'),
+    (0x10CA7, 'M', u'𐳧'),
+    (0x10CA8, 'M', u'𐳨'),
+    (0x10CA9, 'M', u'𐳩'),
+    (0x10CAA, 'M', u'𐳪'),
+    (0x10CAB, 'M', u'𐳫'),
+    (0x10CAC, 'M', u'𐳬'),
+    (0x10CAD, 'M', u'𐳭'),
+    (0x10CAE, 'M', u'𐳮'),
+    (0x10CAF, 'M', u'𐳯'),
+    (0x10CB0, 'M', u'𐳰'),
+    (0x10CB1, 'M', u'𐳱'),
+    (0x10CB2, 'M', u'𐳲'),
+    (0x10CB3, 'X'),
+    (0x10CC0, 'V'),
+    (0x10CF3, 'X'),
+    (0x10CFA, 'V'),
+    (0x10D28, 'X'),
+    (0x10D30, 'V'),
+    (0x10D3A, 'X'),
+    (0x10E60, 'V'),
+    (0x10E7F, 'X'),
+    (0x10E80, 'V'),
+    (0x10EAA, 'X'),
+    (0x10EAB, 'V'),
+    (0x10EAE, 'X'),
+    (0x10EB0, 'V'),
+    (0x10EB2, 'X'),
+    (0x10F00, 'V'),
+    (0x10F28, 'X'),
+    (0x10F30, 'V'),
+    (0x10F5A, 'X'),
+    (0x10FB0, 'V'),
+    (0x10FCC, 'X'),
+    (0x10FE0, 'V'),
+    (0x10FF7, 'X'),
+    (0x11000, 'V'),
+    (0x1104E, 'X'),
+    (0x11052, 'V'),
+    (0x11070, 'X'),
+    (0x1107F, 'V'),
+    (0x110BD, 'X'),
+    (0x110BE, 'V'),
+    (0x110C2, 'X'),
+    (0x110D0, 'V'),
+    (0x110E9, 'X'),
+    (0x110F0, 'V'),
+    (0x110FA, 'X'),
+    (0x11100, 'V'),
+    (0x11135, 'X'),
+    (0x11136, 'V'),
+    (0x11148, 'X'),
+    (0x11150, 'V'),
+    (0x11177, 'X'),
+    (0x11180, 'V'),
+    (0x111E0, 'X'),
+    (0x111E1, 'V'),
+    (0x111F5, 'X'),
+    (0x11200, 'V'),
+    (0x11212, 'X'),
+    ]
+
+def _seg_56():
+    return [
+    (0x11213, 'V'),
+    (0x1123F, 'X'),
+    (0x11280, 'V'),
+    (0x11287, 'X'),
+    (0x11288, 'V'),
+    (0x11289, 'X'),
+    (0x1128A, 'V'),
+    (0x1128E, 'X'),
+    (0x1128F, 'V'),
+    (0x1129E, 'X'),
+    (0x1129F, 'V'),
+    (0x112AA, 'X'),
+    (0x112B0, 'V'),
+    (0x112EB, 'X'),
+    (0x112F0, 'V'),
+    (0x112FA, 'X'),
+    (0x11300, 'V'),
+    (0x11304, 'X'),
+    (0x11305, 'V'),
+    (0x1130D, 'X'),
+    (0x1130F, 'V'),
+    (0x11311, 'X'),
+    (0x11313, 'V'),
+    (0x11329, 'X'),
+    (0x1132A, 'V'),
+    (0x11331, 'X'),
+    (0x11332, 'V'),
+    (0x11334, 'X'),
+    (0x11335, 'V'),
+    (0x1133A, 'X'),
+    (0x1133B, 'V'),
+    (0x11345, 'X'),
+    (0x11347, 'V'),
+    (0x11349, 'X'),
+    (0x1134B, 'V'),
+    (0x1134E, 'X'),
+    (0x11350, 'V'),
+    (0x11351, 'X'),
+    (0x11357, 'V'),
+    (0x11358, 'X'),
+    (0x1135D, 'V'),
+    (0x11364, 'X'),
+    (0x11366, 'V'),
+    (0x1136D, 'X'),
+    (0x11370, 'V'),
+    (0x11375, 'X'),
+    (0x11400, 'V'),
+    (0x1145C, 'X'),
+    (0x1145D, 'V'),
+    (0x11462, 'X'),
+    (0x11480, 'V'),
+    (0x114C8, 'X'),
+    (0x114D0, 'V'),
+    (0x114DA, 'X'),
+    (0x11580, 'V'),
+    (0x115B6, 'X'),
+    (0x115B8, 'V'),
+    (0x115DE, 'X'),
+    (0x11600, 'V'),
+    (0x11645, 'X'),
+    (0x11650, 'V'),
+    (0x1165A, 'X'),
+    (0x11660, 'V'),
+    (0x1166D, 'X'),
+    (0x11680, 'V'),
+    (0x116B9, 'X'),
+    (0x116C0, 'V'),
+    (0x116CA, 'X'),
+    (0x11700, 'V'),
+    (0x1171B, 'X'),
+    (0x1171D, 'V'),
+    (0x1172C, 'X'),
+    (0x11730, 'V'),
+    (0x11740, 'X'),
+    (0x11800, 'V'),
+    (0x1183C, 'X'),
+    (0x118A0, 'M', u'𑣀'),
+    (0x118A1, 'M', u'𑣁'),
+    (0x118A2, 'M', u'𑣂'),
+    (0x118A3, 'M', u'𑣃'),
+    (0x118A4, 'M', u'𑣄'),
+    (0x118A5, 'M', u'𑣅'),
+    (0x118A6, 'M', u'𑣆'),
+    (0x118A7, 'M', u'𑣇'),
+    (0x118A8, 'M', u'𑣈'),
+    (0x118A9, 'M', u'𑣉'),
+    (0x118AA, 'M', u'𑣊'),
+    (0x118AB, 'M', u'𑣋'),
+    (0x118AC, 'M', u'𑣌'),
+    (0x118AD, 'M', u'𑣍'),
+    (0x118AE, 'M', u'𑣎'),
+    (0x118AF, 'M', u'𑣏'),
+    (0x118B0, 'M', u'𑣐'),
+    (0x118B1, 'M', u'𑣑'),
+    (0x118B2, 'M', u'𑣒'),
+    (0x118B3, 'M', u'𑣓'),
+    (0x118B4, 'M', u'𑣔'),
+    (0x118B5, 'M', u'𑣕'),
+    (0x118B6, 'M', u'𑣖'),
+    (0x118B7, 'M', u'𑣗'),
+    ]
+
+def _seg_57():
+    return [
+    (0x118B8, 'M', u'𑣘'),
+    (0x118B9, 'M', u'𑣙'),
+    (0x118BA, 'M', u'𑣚'),
+    (0x118BB, 'M', u'𑣛'),
+    (0x118BC, 'M', u'𑣜'),
+    (0x118BD, 'M', u'𑣝'),
+    (0x118BE, 'M', u'𑣞'),
+    (0x118BF, 'M', u'𑣟'),
+    (0x118C0, 'V'),
+    (0x118F3, 'X'),
+    (0x118FF, 'V'),
+    (0x11907, 'X'),
+    (0x11909, 'V'),
+    (0x1190A, 'X'),
+    (0x1190C, 'V'),
+    (0x11914, 'X'),
+    (0x11915, 'V'),
+    (0x11917, 'X'),
+    (0x11918, 'V'),
+    (0x11936, 'X'),
+    (0x11937, 'V'),
+    (0x11939, 'X'),
+    (0x1193B, 'V'),
+    (0x11947, 'X'),
+    (0x11950, 'V'),
+    (0x1195A, 'X'),
+    (0x119A0, 'V'),
+    (0x119A8, 'X'),
+    (0x119AA, 'V'),
+    (0x119D8, 'X'),
+    (0x119DA, 'V'),
+    (0x119E5, 'X'),
+    (0x11A00, 'V'),
+    (0x11A48, 'X'),
+    (0x11A50, 'V'),
+    (0x11AA3, 'X'),
+    (0x11AC0, 'V'),
+    (0x11AF9, 'X'),
+    (0x11C00, 'V'),
+    (0x11C09, 'X'),
+    (0x11C0A, 'V'),
+    (0x11C37, 'X'),
+    (0x11C38, 'V'),
+    (0x11C46, 'X'),
+    (0x11C50, 'V'),
+    (0x11C6D, 'X'),
+    (0x11C70, 'V'),
+    (0x11C90, 'X'),
+    (0x11C92, 'V'),
+    (0x11CA8, 'X'),
+    (0x11CA9, 'V'),
+    (0x11CB7, 'X'),
+    (0x11D00, 'V'),
+    (0x11D07, 'X'),
+    (0x11D08, 'V'),
+    (0x11D0A, 'X'),
+    (0x11D0B, 'V'),
+    (0x11D37, 'X'),
+    (0x11D3A, 'V'),
+    (0x11D3B, 'X'),
+    (0x11D3C, 'V'),
+    (0x11D3E, 'X'),
+    (0x11D3F, 'V'),
+    (0x11D48, 'X'),
+    (0x11D50, 'V'),
+    (0x11D5A, 'X'),
+    (0x11D60, 'V'),
+    (0x11D66, 'X'),
+    (0x11D67, 'V'),
+    (0x11D69, 'X'),
+    (0x11D6A, 'V'),
+    (0x11D8F, 'X'),
+    (0x11D90, 'V'),
+    (0x11D92, 'X'),
+    (0x11D93, 'V'),
+    (0x11D99, 'X'),
+    (0x11DA0, 'V'),
+    (0x11DAA, 'X'),
+    (0x11EE0, 'V'),
+    (0x11EF9, 'X'),
+    (0x11FB0, 'V'),
+    (0x11FB1, 'X'),
+    (0x11FC0, 'V'),
+    (0x11FF2, 'X'),
+    (0x11FFF, 'V'),
+    (0x1239A, 'X'),
+    (0x12400, 'V'),
+    (0x1246F, 'X'),
+    (0x12470, 'V'),
+    (0x12475, 'X'),
+    (0x12480, 'V'),
+    (0x12544, 'X'),
+    (0x13000, 'V'),
+    (0x1342F, 'X'),
+    (0x14400, 'V'),
+    (0x14647, 'X'),
+    (0x16800, 'V'),
+    (0x16A39, 'X'),
+    (0x16A40, 'V'),
+    (0x16A5F, 'X'),
+    ]
+
+def _seg_58():
+    return [
+    (0x16A60, 'V'),
+    (0x16A6A, 'X'),
+    (0x16A6E, 'V'),
+    (0x16A70, 'X'),
+    (0x16AD0, 'V'),
+    (0x16AEE, 'X'),
+    (0x16AF0, 'V'),
+    (0x16AF6, 'X'),
+    (0x16B00, 'V'),
+    (0x16B46, 'X'),
+    (0x16B50, 'V'),
+    (0x16B5A, 'X'),
+    (0x16B5B, 'V'),
+    (0x16B62, 'X'),
+    (0x16B63, 'V'),
+    (0x16B78, 'X'),
+    (0x16B7D, 'V'),
+    (0x16B90, 'X'),
+    (0x16E40, 'M', u'𖹠'),
+    (0x16E41, 'M', u'𖹡'),
+    (0x16E42, 'M', u'𖹢'),
+    (0x16E43, 'M', u'𖹣'),
+    (0x16E44, 'M', u'𖹤'),
+    (0x16E45, 'M', u'𖹥'),
+    (0x16E46, 'M', u'𖹦'),
+    (0x16E47, 'M', u'𖹧'),
+    (0x16E48, 'M', u'𖹨'),
+    (0x16E49, 'M', u'𖹩'),
+    (0x16E4A, 'M', u'𖹪'),
+    (0x16E4B, 'M', u'𖹫'),
+    (0x16E4C, 'M', u'𖹬'),
+    (0x16E4D, 'M', u'𖹭'),
+    (0x16E4E, 'M', u'𖹮'),
+    (0x16E4F, 'M', u'𖹯'),
+    (0x16E50, 'M', u'𖹰'),
+    (0x16E51, 'M', u'𖹱'),
+    (0x16E52, 'M', u'𖹲'),
+    (0x16E53, 'M', u'𖹳'),
+    (0x16E54, 'M', u'𖹴'),
+    (0x16E55, 'M', u'𖹵'),
+    (0x16E56, 'M', u'𖹶'),
+    (0x16E57, 'M', u'𖹷'),
+    (0x16E58, 'M', u'𖹸'),
+    (0x16E59, 'M', u'𖹹'),
+    (0x16E5A, 'M', u'𖹺'),
+    (0x16E5B, 'M', u'𖹻'),
+    (0x16E5C, 'M', u'𖹼'),
+    (0x16E5D, 'M', u'𖹽'),
+    (0x16E5E, 'M', u'𖹾'),
+    (0x16E5F, 'M', u'𖹿'),
+    (0x16E60, 'V'),
+    (0x16E9B, 'X'),
+    (0x16F00, 'V'),
+    (0x16F4B, 'X'),
+    (0x16F4F, 'V'),
+    (0x16F88, 'X'),
+    (0x16F8F, 'V'),
+    (0x16FA0, 'X'),
+    (0x16FE0, 'V'),
+    (0x16FE5, 'X'),
+    (0x16FF0, 'V'),
+    (0x16FF2, 'X'),
+    (0x17000, 'V'),
+    (0x187F8, 'X'),
+    (0x18800, 'V'),
+    (0x18CD6, 'X'),
+    (0x18D00, 'V'),
+    (0x18D09, 'X'),
+    (0x1B000, 'V'),
+    (0x1B11F, 'X'),
+    (0x1B150, 'V'),
+    (0x1B153, 'X'),
+    (0x1B164, 'V'),
+    (0x1B168, 'X'),
+    (0x1B170, 'V'),
+    (0x1B2FC, 'X'),
+    (0x1BC00, 'V'),
+    (0x1BC6B, 'X'),
+    (0x1BC70, 'V'),
+    (0x1BC7D, 'X'),
+    (0x1BC80, 'V'),
+    (0x1BC89, 'X'),
+    (0x1BC90, 'V'),
+    (0x1BC9A, 'X'),
+    (0x1BC9C, 'V'),
+    (0x1BCA0, 'I'),
+    (0x1BCA4, 'X'),
+    (0x1D000, 'V'),
+    (0x1D0F6, 'X'),
+    (0x1D100, 'V'),
+    (0x1D127, 'X'),
+    (0x1D129, 'V'),
+    (0x1D15E, 'M', u'𝅗𝅥'),
+    (0x1D15F, 'M', u'𝅘𝅥'),
+    (0x1D160, 'M', u'𝅘𝅥𝅮'),
+    (0x1D161, 'M', u'𝅘𝅥𝅯'),
+    (0x1D162, 'M', u'𝅘𝅥𝅰'),
+    (0x1D163, 'M', u'𝅘𝅥𝅱'),
+    (0x1D164, 'M', u'𝅘𝅥𝅲'),
+    (0x1D165, 'V'),
+    ]
+
+def _seg_59():
+    return [
+    (0x1D173, 'X'),
+    (0x1D17B, 'V'),
+    (0x1D1BB, 'M', u'𝆹𝅥'),
+    (0x1D1BC, 'M', u'𝆺𝅥'),
+    (0x1D1BD, 'M', u'𝆹𝅥𝅮'),
+    (0x1D1BE, 'M', u'𝆺𝅥𝅮'),
+    (0x1D1BF, 'M', u'𝆹𝅥𝅯'),
+    (0x1D1C0, 'M', u'𝆺𝅥𝅯'),
+    (0x1D1C1, 'V'),
+    (0x1D1E9, 'X'),
+    (0x1D200, 'V'),
+    (0x1D246, 'X'),
+    (0x1D2E0, 'V'),
+    (0x1D2F4, 'X'),
+    (0x1D300, 'V'),
+    (0x1D357, 'X'),
+    (0x1D360, 'V'),
+    (0x1D379, 'X'),
+    (0x1D400, 'M', u'a'),
+    (0x1D401, 'M', u'b'),
+    (0x1D402, 'M', u'c'),
+    (0x1D403, 'M', u'd'),
+    (0x1D404, 'M', u'e'),
+    (0x1D405, 'M', u'f'),
+    (0x1D406, 'M', u'g'),
+    (0x1D407, 'M', u'h'),
+    (0x1D408, 'M', u'i'),
+    (0x1D409, 'M', u'j'),
+    (0x1D40A, 'M', u'k'),
+    (0x1D40B, 'M', u'l'),
+    (0x1D40C, 'M', u'm'),
+    (0x1D40D, 'M', u'n'),
+    (0x1D40E, 'M', u'o'),
+    (0x1D40F, 'M', u'p'),
+    (0x1D410, 'M', u'q'),
+    (0x1D411, 'M', u'r'),
+    (0x1D412, 'M', u's'),
+    (0x1D413, 'M', u't'),
+    (0x1D414, 'M', u'u'),
+    (0x1D415, 'M', u'v'),
+    (0x1D416, 'M', u'w'),
+    (0x1D417, 'M', u'x'),
+    (0x1D418, 'M', u'y'),
+    (0x1D419, 'M', u'z'),
+    (0x1D41A, 'M', u'a'),
+    (0x1D41B, 'M', u'b'),
+    (0x1D41C, 'M', u'c'),
+    (0x1D41D, 'M', u'd'),
+    (0x1D41E, 'M', u'e'),
+    (0x1D41F, 'M', u'f'),
+    (0x1D420, 'M', u'g'),
+    (0x1D421, 'M', u'h'),
+    (0x1D422, 'M', u'i'),
+    (0x1D423, 'M', u'j'),
+    (0x1D424, 'M', u'k'),
+    (0x1D425, 'M', u'l'),
+    (0x1D426, 'M', u'm'),
+    (0x1D427, 'M', u'n'),
+    (0x1D428, 'M', u'o'),
+    (0x1D429, 'M', u'p'),
+    (0x1D42A, 'M', u'q'),
+    (0x1D42B, 'M', u'r'),
+    (0x1D42C, 'M', u's'),
+    (0x1D42D, 'M', u't'),
+    (0x1D42E, 'M', u'u'),
+    (0x1D42F, 'M', u'v'),
+    (0x1D430, 'M', u'w'),
+    (0x1D431, 'M', u'x'),
+    (0x1D432, 'M', u'y'),
+    (0x1D433, 'M', u'z'),
+    (0x1D434, 'M', u'a'),
+    (0x1D435, 'M', u'b'),
+    (0x1D436, 'M', u'c'),
+    (0x1D437, 'M', u'd'),
+    (0x1D438, 'M', u'e'),
+    (0x1D439, 'M', u'f'),
+    (0x1D43A, 'M', u'g'),
+    (0x1D43B, 'M', u'h'),
+    (0x1D43C, 'M', u'i'),
+    (0x1D43D, 'M', u'j'),
+    (0x1D43E, 'M', u'k'),
+    (0x1D43F, 'M', u'l'),
+    (0x1D440, 'M', u'm'),
+    (0x1D441, 'M', u'n'),
+    (0x1D442, 'M', u'o'),
+    (0x1D443, 'M', u'p'),
+    (0x1D444, 'M', u'q'),
+    (0x1D445, 'M', u'r'),
+    (0x1D446, 'M', u's'),
+    (0x1D447, 'M', u't'),
+    (0x1D448, 'M', u'u'),
+    (0x1D449, 'M', u'v'),
+    (0x1D44A, 'M', u'w'),
+    (0x1D44B, 'M', u'x'),
+    (0x1D44C, 'M', u'y'),
+    (0x1D44D, 'M', u'z'),
+    (0x1D44E, 'M', u'a'),
+    (0x1D44F, 'M', u'b'),
+    (0x1D450, 'M', u'c'),
+    (0x1D451, 'M', u'd'),
+    ]
+
+def _seg_60():
+    return [
+    (0x1D452, 'M', u'e'),
+    (0x1D453, 'M', u'f'),
+    (0x1D454, 'M', u'g'),
+    (0x1D455, 'X'),
+    (0x1D456, 'M', u'i'),
+    (0x1D457, 'M', u'j'),
+    (0x1D458, 'M', u'k'),
+    (0x1D459, 'M', u'l'),
+    (0x1D45A, 'M', u'm'),
+    (0x1D45B, 'M', u'n'),
+    (0x1D45C, 'M', u'o'),
+    (0x1D45D, 'M', u'p'),
+    (0x1D45E, 'M', u'q'),
+    (0x1D45F, 'M', u'r'),
+    (0x1D460, 'M', u's'),
+    (0x1D461, 'M', u't'),
+    (0x1D462, 'M', u'u'),
+    (0x1D463, 'M', u'v'),
+    (0x1D464, 'M', u'w'),
+    (0x1D465, 'M', u'x'),
+    (0x1D466, 'M', u'y'),
+    (0x1D467, 'M', u'z'),
+    (0x1D468, 'M', u'a'),
+    (0x1D469, 'M', u'b'),
+    (0x1D46A, 'M', u'c'),
+    (0x1D46B, 'M', u'd'),
+    (0x1D46C, 'M', u'e'),
+    (0x1D46D, 'M', u'f'),
+    (0x1D46E, 'M', u'g'),
+    (0x1D46F, 'M', u'h'),
+    (0x1D470, 'M', u'i'),
+    (0x1D471, 'M', u'j'),
+    (0x1D472, 'M', u'k'),
+    (0x1D473, 'M', u'l'),
+    (0x1D474, 'M', u'm'),
+    (0x1D475, 'M', u'n'),
+    (0x1D476, 'M', u'o'),
+    (0x1D477, 'M', u'p'),
+    (0x1D478, 'M', u'q'),
+    (0x1D479, 'M', u'r'),
+    (0x1D47A, 'M', u's'),
+    (0x1D47B, 'M', u't'),
+    (0x1D47C, 'M', u'u'),
+    (0x1D47D, 'M', u'v'),
+    (0x1D47E, 'M', u'w'),
+    (0x1D47F, 'M', u'x'),
+    (0x1D480, 'M', u'y'),
+    (0x1D481, 'M', u'z'),
+    (0x1D482, 'M', u'a'),
+    (0x1D483, 'M', u'b'),
+    (0x1D484, 'M', u'c'),
+    (0x1D485, 'M', u'd'),
+    (0x1D486, 'M', u'e'),
+    (0x1D487, 'M', u'f'),
+    (0x1D488, 'M', u'g'),
+    (0x1D489, 'M', u'h'),
+    (0x1D48A, 'M', u'i'),
+    (0x1D48B, 'M', u'j'),
+    (0x1D48C, 'M', u'k'),
+    (0x1D48D, 'M', u'l'),
+    (0x1D48E, 'M', u'm'),
+    (0x1D48F, 'M', u'n'),
+    (0x1D490, 'M', u'o'),
+    (0x1D491, 'M', u'p'),
+    (0x1D492, 'M', u'q'),
+    (0x1D493, 'M', u'r'),
+    (0x1D494, 'M', u's'),
+    (0x1D495, 'M', u't'),
+    (0x1D496, 'M', u'u'),
+    (0x1D497, 'M', u'v'),
+    (0x1D498, 'M', u'w'),
+    (0x1D499, 'M', u'x'),
+    (0x1D49A, 'M', u'y'),
+    (0x1D49B, 'M', u'z'),
+    (0x1D49C, 'M', u'a'),
+    (0x1D49D, 'X'),
+    (0x1D49E, 'M', u'c'),
+    (0x1D49F, 'M', u'd'),
+    (0x1D4A0, 'X'),
+    (0x1D4A2, 'M', u'g'),
+    (0x1D4A3, 'X'),
+    (0x1D4A5, 'M', u'j'),
+    (0x1D4A6, 'M', u'k'),
+    (0x1D4A7, 'X'),
+    (0x1D4A9, 'M', u'n'),
+    (0x1D4AA, 'M', u'o'),
+    (0x1D4AB, 'M', u'p'),
+    (0x1D4AC, 'M', u'q'),
+    (0x1D4AD, 'X'),
+    (0x1D4AE, 'M', u's'),
+    (0x1D4AF, 'M', u't'),
+    (0x1D4B0, 'M', u'u'),
+    (0x1D4B1, 'M', u'v'),
+    (0x1D4B2, 'M', u'w'),
+    (0x1D4B3, 'M', u'x'),
+    (0x1D4B4, 'M', u'y'),
+    (0x1D4B5, 'M', u'z'),
+    (0x1D4B6, 'M', u'a'),
+    (0x1D4B7, 'M', u'b'),
+    (0x1D4B8, 'M', u'c'),
+    ]
+
+def _seg_61():
+    return [
+    (0x1D4B9, 'M', u'd'),
+    (0x1D4BA, 'X'),
+    (0x1D4BB, 'M', u'f'),
+    (0x1D4BC, 'X'),
+    (0x1D4BD, 'M', u'h'),
+    (0x1D4BE, 'M', u'i'),
+    (0x1D4BF, 'M', u'j'),
+    (0x1D4C0, 'M', u'k'),
+    (0x1D4C1, 'M', u'l'),
+    (0x1D4C2, 'M', u'm'),
+    (0x1D4C3, 'M', u'n'),
+    (0x1D4C4, 'X'),
+    (0x1D4C5, 'M', u'p'),
+    (0x1D4C6, 'M', u'q'),
+    (0x1D4C7, 'M', u'r'),
+    (0x1D4C8, 'M', u's'),
+    (0x1D4C9, 'M', u't'),
+    (0x1D4CA, 'M', u'u'),
+    (0x1D4CB, 'M', u'v'),
+    (0x1D4CC, 'M', u'w'),
+    (0x1D4CD, 'M', u'x'),
+    (0x1D4CE, 'M', u'y'),
+    (0x1D4CF, 'M', u'z'),
+    (0x1D4D0, 'M', u'a'),
+    (0x1D4D1, 'M', u'b'),
+    (0x1D4D2, 'M', u'c'),
+    (0x1D4D3, 'M', u'd'),
+    (0x1D4D4, 'M', u'e'),
+    (0x1D4D5, 'M', u'f'),
+    (0x1D4D6, 'M', u'g'),
+    (0x1D4D7, 'M', u'h'),
+    (0x1D4D8, 'M', u'i'),
+    (0x1D4D9, 'M', u'j'),
+    (0x1D4DA, 'M', u'k'),
+    (0x1D4DB, 'M', u'l'),
+    (0x1D4DC, 'M', u'm'),
+    (0x1D4DD, 'M', u'n'),
+    (0x1D4DE, 'M', u'o'),
+    (0x1D4DF, 'M', u'p'),
+    (0x1D4E0, 'M', u'q'),
+    (0x1D4E1, 'M', u'r'),
+    (0x1D4E2, 'M', u's'),
+    (0x1D4E3, 'M', u't'),
+    (0x1D4E4, 'M', u'u'),
+    (0x1D4E5, 'M', u'v'),
+    (0x1D4E6, 'M', u'w'),
+    (0x1D4E7, 'M', u'x'),
+    (0x1D4E8, 'M', u'y'),
+    (0x1D4E9, 'M', u'z'),
+    (0x1D4EA, 'M', u'a'),
+    (0x1D4EB, 'M', u'b'),
+    (0x1D4EC, 'M', u'c'),
+    (0x1D4ED, 'M', u'd'),
+    (0x1D4EE, 'M', u'e'),
+    (0x1D4EF, 'M', u'f'),
+    (0x1D4F0, 'M', u'g'),
+    (0x1D4F1, 'M', u'h'),
+    (0x1D4F2, 'M', u'i'),
+    (0x1D4F3, 'M', u'j'),
+    (0x1D4F4, 'M', u'k'),
+    (0x1D4F5, 'M', u'l'),
+    (0x1D4F6, 'M', u'm'),
+    (0x1D4F7, 'M', u'n'),
+    (0x1D4F8, 'M', u'o'),
+    (0x1D4F9, 'M', u'p'),
+    (0x1D4FA, 'M', u'q'),
+    (0x1D4FB, 'M', u'r'),
+    (0x1D4FC, 'M', u's'),
+    (0x1D4FD, 'M', u't'),
+    (0x1D4FE, 'M', u'u'),
+    (0x1D4FF, 'M', u'v'),
+    (0x1D500, 'M', u'w'),
+    (0x1D501, 'M', u'x'),
+    (0x1D502, 'M', u'y'),
+    (0x1D503, 'M', u'z'),
+    (0x1D504, 'M', u'a'),
+    (0x1D505, 'M', u'b'),
+    (0x1D506, 'X'),
+    (0x1D507, 'M', u'd'),
+    (0x1D508, 'M', u'e'),
+    (0x1D509, 'M', u'f'),
+    (0x1D50A, 'M', u'g'),
+    (0x1D50B, 'X'),
+    (0x1D50D, 'M', u'j'),
+    (0x1D50E, 'M', u'k'),
+    (0x1D50F, 'M', u'l'),
+    (0x1D510, 'M', u'm'),
+    (0x1D511, 'M', u'n'),
+    (0x1D512, 'M', u'o'),
+    (0x1D513, 'M', u'p'),
+    (0x1D514, 'M', u'q'),
+    (0x1D515, 'X'),
+    (0x1D516, 'M', u's'),
+    (0x1D517, 'M', u't'),
+    (0x1D518, 'M', u'u'),
+    (0x1D519, 'M', u'v'),
+    (0x1D51A, 'M', u'w'),
+    (0x1D51B, 'M', u'x'),
+    (0x1D51C, 'M', u'y'),
+    (0x1D51D, 'X'),
+    ]
+
+def _seg_62():
+    return [
+    (0x1D51E, 'M', u'a'),
+    (0x1D51F, 'M', u'b'),
+    (0x1D520, 'M', u'c'),
+    (0x1D521, 'M', u'd'),
+    (0x1D522, 'M', u'e'),
+    (0x1D523, 'M', u'f'),
+    (0x1D524, 'M', u'g'),
+    (0x1D525, 'M', u'h'),
+    (0x1D526, 'M', u'i'),
+    (0x1D527, 'M', u'j'),
+    (0x1D528, 'M', u'k'),
+    (0x1D529, 'M', u'l'),
+    (0x1D52A, 'M', u'm'),
+    (0x1D52B, 'M', u'n'),
+    (0x1D52C, 'M', u'o'),
+    (0x1D52D, 'M', u'p'),
+    (0x1D52E, 'M', u'q'),
+    (0x1D52F, 'M', u'r'),
+    (0x1D530, 'M', u's'),
+    (0x1D531, 'M', u't'),
+    (0x1D532, 'M', u'u'),
+    (0x1D533, 'M', u'v'),
+    (0x1D534, 'M', u'w'),
+    (0x1D535, 'M', u'x'),
+    (0x1D536, 'M', u'y'),
+    (0x1D537, 'M', u'z'),
+    (0x1D538, 'M', u'a'),
+    (0x1D539, 'M', u'b'),
+    (0x1D53A, 'X'),
+    (0x1D53B, 'M', u'd'),
+    (0x1D53C, 'M', u'e'),
+    (0x1D53D, 'M', u'f'),
+    (0x1D53E, 'M', u'g'),
+    (0x1D53F, 'X'),
+    (0x1D540, 'M', u'i'),
+    (0x1D541, 'M', u'j'),
+    (0x1D542, 'M', u'k'),
+    (0x1D543, 'M', u'l'),
+    (0x1D544, 'M', u'm'),
+    (0x1D545, 'X'),
+    (0x1D546, 'M', u'o'),
+    (0x1D547, 'X'),
+    (0x1D54A, 'M', u's'),
+    (0x1D54B, 'M', u't'),
+    (0x1D54C, 'M', u'u'),
+    (0x1D54D, 'M', u'v'),
+    (0x1D54E, 'M', u'w'),
+    (0x1D54F, 'M', u'x'),
+    (0x1D550, 'M', u'y'),
+    (0x1D551, 'X'),
+    (0x1D552, 'M', u'a'),
+    (0x1D553, 'M', u'b'),
+    (0x1D554, 'M', u'c'),
+    (0x1D555, 'M', u'd'),
+    (0x1D556, 'M', u'e'),
+    (0x1D557, 'M', u'f'),
+    (0x1D558, 'M', u'g'),
+    (0x1D559, 'M', u'h'),
+    (0x1D55A, 'M', u'i'),
+    (0x1D55B, 'M', u'j'),
+    (0x1D55C, 'M', u'k'),
+    (0x1D55D, 'M', u'l'),
+    (0x1D55E, 'M', u'm'),
+    (0x1D55F, 'M', u'n'),
+    (0x1D560, 'M', u'o'),
+    (0x1D561, 'M', u'p'),
+    (0x1D562, 'M', u'q'),
+    (0x1D563, 'M', u'r'),
+    (0x1D564, 'M', u's'),
+    (0x1D565, 'M', u't'),
+    (0x1D566, 'M', u'u'),
+    (0x1D567, 'M', u'v'),
+    (0x1D568, 'M', u'w'),
+    (0x1D569, 'M', u'x'),
+    (0x1D56A, 'M', u'y'),
+    (0x1D56B, 'M', u'z'),
+    (0x1D56C, 'M', u'a'),
+    (0x1D56D, 'M', u'b'),
+    (0x1D56E, 'M', u'c'),
+    (0x1D56F, 'M', u'd'),
+    (0x1D570, 'M', u'e'),
+    (0x1D571, 'M', u'f'),
+    (0x1D572, 'M', u'g'),
+    (0x1D573, 'M', u'h'),
+    (0x1D574, 'M', u'i'),
+    (0x1D575, 'M', u'j'),
+    (0x1D576, 'M', u'k'),
+    (0x1D577, 'M', u'l'),
+    (0x1D578, 'M', u'm'),
+    (0x1D579, 'M', u'n'),
+    (0x1D57A, 'M', u'o'),
+    (0x1D57B, 'M', u'p'),
+    (0x1D57C, 'M', u'q'),
+    (0x1D57D, 'M', u'r'),
+    (0x1D57E, 'M', u's'),
+    (0x1D57F, 'M', u't'),
+    (0x1D580, 'M', u'u'),
+    (0x1D581, 'M', u'v'),
+    (0x1D582, 'M', u'w'),
+    (0x1D583, 'M', u'x'),
+    ]
+
+def _seg_63():
+    return [
+    (0x1D584, 'M', u'y'),
+    (0x1D585, 'M', u'z'),
+    (0x1D586, 'M', u'a'),
+    (0x1D587, 'M', u'b'),
+    (0x1D588, 'M', u'c'),
+    (0x1D589, 'M', u'd'),
+    (0x1D58A, 'M', u'e'),
+    (0x1D58B, 'M', u'f'),
+    (0x1D58C, 'M', u'g'),
+    (0x1D58D, 'M', u'h'),
+    (0x1D58E, 'M', u'i'),
+    (0x1D58F, 'M', u'j'),
+    (0x1D590, 'M', u'k'),
+    (0x1D591, 'M', u'l'),
+    (0x1D592, 'M', u'm'),
+    (0x1D593, 'M', u'n'),
+    (0x1D594, 'M', u'o'),
+    (0x1D595, 'M', u'p'),
+    (0x1D596, 'M', u'q'),
+    (0x1D597, 'M', u'r'),
+    (0x1D598, 'M', u's'),
+    (0x1D599, 'M', u't'),
+    (0x1D59A, 'M', u'u'),
+    (0x1D59B, 'M', u'v'),
+    (0x1D59C, 'M', u'w'),
+    (0x1D59D, 'M', u'x'),
+    (0x1D59E, 'M', u'y'),
+    (0x1D59F, 'M', u'z'),
+    (0x1D5A0, 'M', u'a'),
+    (0x1D5A1, 'M', u'b'),
+    (0x1D5A2, 'M', u'c'),
+    (0x1D5A3, 'M', u'd'),
+    (0x1D5A4, 'M', u'e'),
+    (0x1D5A5, 'M', u'f'),
+    (0x1D5A6, 'M', u'g'),
+    (0x1D5A7, 'M', u'h'),
+    (0x1D5A8, 'M', u'i'),
+    (0x1D5A9, 'M', u'j'),
+    (0x1D5AA, 'M', u'k'),
+    (0x1D5AB, 'M', u'l'),
+    (0x1D5AC, 'M', u'm'),
+    (0x1D5AD, 'M', u'n'),
+    (0x1D5AE, 'M', u'o'),
+    (0x1D5AF, 'M', u'p'),
+    (0x1D5B0, 'M', u'q'),
+    (0x1D5B1, 'M', u'r'),
+    (0x1D5B2, 'M', u's'),
+    (0x1D5B3, 'M', u't'),
+    (0x1D5B4, 'M', u'u'),
+    (0x1D5B5, 'M', u'v'),
+    (0x1D5B6, 'M', u'w'),
+    (0x1D5B7, 'M', u'x'),
+    (0x1D5B8, 'M', u'y'),
+    (0x1D5B9, 'M', u'z'),
+    (0x1D5BA, 'M', u'a'),
+    (0x1D5BB, 'M', u'b'),
+    (0x1D5BC, 'M', u'c'),
+    (0x1D5BD, 'M', u'd'),
+    (0x1D5BE, 'M', u'e'),
+    (0x1D5BF, 'M', u'f'),
+    (0x1D5C0, 'M', u'g'),
+    (0x1D5C1, 'M', u'h'),
+    (0x1D5C2, 'M', u'i'),
+    (0x1D5C3, 'M', u'j'),
+    (0x1D5C4, 'M', u'k'),
+    (0x1D5C5, 'M', u'l'),
+    (0x1D5C6, 'M', u'm'),
+    (0x1D5C7, 'M', u'n'),
+    (0x1D5C8, 'M', u'o'),
+    (0x1D5C9, 'M', u'p'),
+    (0x1D5CA, 'M', u'q'),
+    (0x1D5CB, 'M', u'r'),
+    (0x1D5CC, 'M', u's'),
+    (0x1D5CD, 'M', u't'),
+    (0x1D5CE, 'M', u'u'),
+    (0x1D5CF, 'M', u'v'),
+    (0x1D5D0, 'M', u'w'),
+    (0x1D5D1, 'M', u'x'),
+    (0x1D5D2, 'M', u'y'),
+    (0x1D5D3, 'M', u'z'),
+    (0x1D5D4, 'M', u'a'),
+    (0x1D5D5, 'M', u'b'),
+    (0x1D5D6, 'M', u'c'),
+    (0x1D5D7, 'M', u'd'),
+    (0x1D5D8, 'M', u'e'),
+    (0x1D5D9, 'M', u'f'),
+    (0x1D5DA, 'M', u'g'),
+    (0x1D5DB, 'M', u'h'),
+    (0x1D5DC, 'M', u'i'),
+    (0x1D5DD, 'M', u'j'),
+    (0x1D5DE, 'M', u'k'),
+    (0x1D5DF, 'M', u'l'),
+    (0x1D5E0, 'M', u'm'),
+    (0x1D5E1, 'M', u'n'),
+    (0x1D5E2, 'M', u'o'),
+    (0x1D5E3, 'M', u'p'),
+    (0x1D5E4, 'M', u'q'),
+    (0x1D5E5, 'M', u'r'),
+    (0x1D5E6, 'M', u's'),
+    (0x1D5E7, 'M', u't'),
+    ]
+
+def _seg_64():
+    return [
+    (0x1D5E8, 'M', u'u'),
+    (0x1D5E9, 'M', u'v'),
+    (0x1D5EA, 'M', u'w'),
+    (0x1D5EB, 'M', u'x'),
+    (0x1D5EC, 'M', u'y'),
+    (0x1D5ED, 'M', u'z'),
+    (0x1D5EE, 'M', u'a'),
+    (0x1D5EF, 'M', u'b'),
+    (0x1D5F0, 'M', u'c'),
+    (0x1D5F1, 'M', u'd'),
+    (0x1D5F2, 'M', u'e'),
+    (0x1D5F3, 'M', u'f'),
+    (0x1D5F4, 'M', u'g'),
+    (0x1D5F5, 'M', u'h'),
+    (0x1D5F6, 'M', u'i'),
+    (0x1D5F7, 'M', u'j'),
+    (0x1D5F8, 'M', u'k'),
+    (0x1D5F9, 'M', u'l'),
+    (0x1D5FA, 'M', u'm'),
+    (0x1D5FB, 'M', u'n'),
+    (0x1D5FC, 'M', u'o'),
+    (0x1D5FD, 'M', u'p'),
+    (0x1D5FE, 'M', u'q'),
+    (0x1D5FF, 'M', u'r'),
+    (0x1D600, 'M', u's'),
+    (0x1D601, 'M', u't'),
+    (0x1D602, 'M', u'u'),
+    (0x1D603, 'M', u'v'),
+    (0x1D604, 'M', u'w'),
+    (0x1D605, 'M', u'x'),
+    (0x1D606, 'M', u'y'),
+    (0x1D607, 'M', u'z'),
+    (0x1D608, 'M', u'a'),
+    (0x1D609, 'M', u'b'),
+    (0x1D60A, 'M', u'c'),
+    (0x1D60B, 'M', u'd'),
+    (0x1D60C, 'M', u'e'),
+    (0x1D60D, 'M', u'f'),
+    (0x1D60E, 'M', u'g'),
+    (0x1D60F, 'M', u'h'),
+    (0x1D610, 'M', u'i'),
+    (0x1D611, 'M', u'j'),
+    (0x1D612, 'M', u'k'),
+    (0x1D613, 'M', u'l'),
+    (0x1D614, 'M', u'm'),
+    (0x1D615, 'M', u'n'),
+    (0x1D616, 'M', u'o'),
+    (0x1D617, 'M', u'p'),
+    (0x1D618, 'M', u'q'),
+    (0x1D619, 'M', u'r'),
+    (0x1D61A, 'M', u's'),
+    (0x1D61B, 'M', u't'),
+    (0x1D61C, 'M', u'u'),
+    (0x1D61D, 'M', u'v'),
+    (0x1D61E, 'M', u'w'),
+    (0x1D61F, 'M', u'x'),
+    (0x1D620, 'M', u'y'),
+    (0x1D621, 'M', u'z'),
+    (0x1D622, 'M', u'a'),
+    (0x1D623, 'M', u'b'),
+    (0x1D624, 'M', u'c'),
+    (0x1D625, 'M', u'd'),
+    (0x1D626, 'M', u'e'),
+    (0x1D627, 'M', u'f'),
+    (0x1D628, 'M', u'g'),
+    (0x1D629, 'M', u'h'),
+    (0x1D62A, 'M', u'i'),
+    (0x1D62B, 'M', u'j'),
+    (0x1D62C, 'M', u'k'),
+    (0x1D62D, 'M', u'l'),
+    (0x1D62E, 'M', u'm'),
+    (0x1D62F, 'M', u'n'),
+    (0x1D630, 'M', u'o'),
+    (0x1D631, 'M', u'p'),
+    (0x1D632, 'M', u'q'),
+    (0x1D633, 'M', u'r'),
+    (0x1D634, 'M', u's'),
+    (0x1D635, 'M', u't'),
+    (0x1D636, 'M', u'u'),
+    (0x1D637, 'M', u'v'),
+    (0x1D638, 'M', u'w'),
+    (0x1D639, 'M', u'x'),
+    (0x1D63A, 'M', u'y'),
+    (0x1D63B, 'M', u'z'),
+    (0x1D63C, 'M', u'a'),
+    (0x1D63D, 'M', u'b'),
+    (0x1D63E, 'M', u'c'),
+    (0x1D63F, 'M', u'd'),
+    (0x1D640, 'M', u'e'),
+    (0x1D641, 'M', u'f'),
+    (0x1D642, 'M', u'g'),
+    (0x1D643, 'M', u'h'),
+    (0x1D644, 'M', u'i'),
+    (0x1D645, 'M', u'j'),
+    (0x1D646, 'M', u'k'),
+    (0x1D647, 'M', u'l'),
+    (0x1D648, 'M', u'm'),
+    (0x1D649, 'M', u'n'),
+    (0x1D64A, 'M', u'o'),
+    (0x1D64B, 'M', u'p'),
+    ]
+
+def _seg_65():
+    return [
+    (0x1D64C, 'M', u'q'),
+    (0x1D64D, 'M', u'r'),
+    (0x1D64E, 'M', u's'),
+    (0x1D64F, 'M', u't'),
+    (0x1D650, 'M', u'u'),
+    (0x1D651, 'M', u'v'),
+    (0x1D652, 'M', u'w'),
+    (0x1D653, 'M', u'x'),
+    (0x1D654, 'M', u'y'),
+    (0x1D655, 'M', u'z'),
+    (0x1D656, 'M', u'a'),
+    (0x1D657, 'M', u'b'),
+    (0x1D658, 'M', u'c'),
+    (0x1D659, 'M', u'd'),
+    (0x1D65A, 'M', u'e'),
+    (0x1D65B, 'M', u'f'),
+    (0x1D65C, 'M', u'g'),
+    (0x1D65D, 'M', u'h'),
+    (0x1D65E, 'M', u'i'),
+    (0x1D65F, 'M', u'j'),
+    (0x1D660, 'M', u'k'),
+    (0x1D661, 'M', u'l'),
+    (0x1D662, 'M', u'm'),
+    (0x1D663, 'M', u'n'),
+    (0x1D664, 'M', u'o'),
+    (0x1D665, 'M', u'p'),
+    (0x1D666, 'M', u'q'),
+    (0x1D667, 'M', u'r'),
+    (0x1D668, 'M', u's'),
+    (0x1D669, 'M', u't'),
+    (0x1D66A, 'M', u'u'),
+    (0x1D66B, 'M', u'v'),
+    (0x1D66C, 'M', u'w'),
+    (0x1D66D, 'M', u'x'),
+    (0x1D66E, 'M', u'y'),
+    (0x1D66F, 'M', u'z'),
+    (0x1D670, 'M', u'a'),
+    (0x1D671, 'M', u'b'),
+    (0x1D672, 'M', u'c'),
+    (0x1D673, 'M', u'd'),
+    (0x1D674, 'M', u'e'),
+    (0x1D675, 'M', u'f'),
+    (0x1D676, 'M', u'g'),
+    (0x1D677, 'M', u'h'),
+    (0x1D678, 'M', u'i'),
+    (0x1D679, 'M', u'j'),
+    (0x1D67A, 'M', u'k'),
+    (0x1D67B, 'M', u'l'),
+    (0x1D67C, 'M', u'm'),
+    (0x1D67D, 'M', u'n'),
+    (0x1D67E, 'M', u'o'),
+    (0x1D67F, 'M', u'p'),
+    (0x1D680, 'M', u'q'),
+    (0x1D681, 'M', u'r'),
+    (0x1D682, 'M', u's'),
+    (0x1D683, 'M', u't'),
+    (0x1D684, 'M', u'u'),
+    (0x1D685, 'M', u'v'),
+    (0x1D686, 'M', u'w'),
+    (0x1D687, 'M', u'x'),
+    (0x1D688, 'M', u'y'),
+    (0x1D689, 'M', u'z'),
+    (0x1D68A, 'M', u'a'),
+    (0x1D68B, 'M', u'b'),
+    (0x1D68C, 'M', u'c'),
+    (0x1D68D, 'M', u'd'),
+    (0x1D68E, 'M', u'e'),
+    (0x1D68F, 'M', u'f'),
+    (0x1D690, 'M', u'g'),
+    (0x1D691, 'M', u'h'),
+    (0x1D692, 'M', u'i'),
+    (0x1D693, 'M', u'j'),
+    (0x1D694, 'M', u'k'),
+    (0x1D695, 'M', u'l'),
+    (0x1D696, 'M', u'm'),
+    (0x1D697, 'M', u'n'),
+    (0x1D698, 'M', u'o'),
+    (0x1D699, 'M', u'p'),
+    (0x1D69A, 'M', u'q'),
+    (0x1D69B, 'M', u'r'),
+    (0x1D69C, 'M', u's'),
+    (0x1D69D, 'M', u't'),
+    (0x1D69E, 'M', u'u'),
+    (0x1D69F, 'M', u'v'),
+    (0x1D6A0, 'M', u'w'),
+    (0x1D6A1, 'M', u'x'),
+    (0x1D6A2, 'M', u'y'),
+    (0x1D6A3, 'M', u'z'),
+    (0x1D6A4, 'M', u'ı'),
+    (0x1D6A5, 'M', u'ȷ'),
+    (0x1D6A6, 'X'),
+    (0x1D6A8, 'M', u'α'),
+    (0x1D6A9, 'M', u'β'),
+    (0x1D6AA, 'M', u'γ'),
+    (0x1D6AB, 'M', u'δ'),
+    (0x1D6AC, 'M', u'ε'),
+    (0x1D6AD, 'M', u'ζ'),
+    (0x1D6AE, 'M', u'η'),
+    (0x1D6AF, 'M', u'θ'),
+    (0x1D6B0, 'M', u'ι'),
+    ]
+
+def _seg_66():
+    return [
+    (0x1D6B1, 'M', u'κ'),
+    (0x1D6B2, 'M', u'λ'),
+    (0x1D6B3, 'M', u'μ'),
+    (0x1D6B4, 'M', u'ν'),
+    (0x1D6B5, 'M', u'ξ'),
+    (0x1D6B6, 'M', u'ο'),
+    (0x1D6B7, 'M', u'π'),
+    (0x1D6B8, 'M', u'ρ'),
+    (0x1D6B9, 'M', u'θ'),
+    (0x1D6BA, 'M', u'σ'),
+    (0x1D6BB, 'M', u'τ'),
+    (0x1D6BC, 'M', u'υ'),
+    (0x1D6BD, 'M', u'φ'),
+    (0x1D6BE, 'M', u'χ'),
+    (0x1D6BF, 'M', u'ψ'),
+    (0x1D6C0, 'M', u'ω'),
+    (0x1D6C1, 'M', u'∇'),
+    (0x1D6C2, 'M', u'α'),
+    (0x1D6C3, 'M', u'β'),
+    (0x1D6C4, 'M', u'γ'),
+    (0x1D6C5, 'M', u'δ'),
+    (0x1D6C6, 'M', u'ε'),
+    (0x1D6C7, 'M', u'ζ'),
+    (0x1D6C8, 'M', u'η'),
+    (0x1D6C9, 'M', u'θ'),
+    (0x1D6CA, 'M', u'ι'),
+    (0x1D6CB, 'M', u'κ'),
+    (0x1D6CC, 'M', u'λ'),
+    (0x1D6CD, 'M', u'μ'),
+    (0x1D6CE, 'M', u'ν'),
+    (0x1D6CF, 'M', u'ξ'),
+    (0x1D6D0, 'M', u'ο'),
+    (0x1D6D1, 'M', u'π'),
+    (0x1D6D2, 'M', u'ρ'),
+    (0x1D6D3, 'M', u'σ'),
+    (0x1D6D5, 'M', u'τ'),
+    (0x1D6D6, 'M', u'υ'),
+    (0x1D6D7, 'M', u'φ'),
+    (0x1D6D8, 'M', u'χ'),
+    (0x1D6D9, 'M', u'ψ'),
+    (0x1D6DA, 'M', u'ω'),
+    (0x1D6DB, 'M', u'∂'),
+    (0x1D6DC, 'M', u'ε'),
+    (0x1D6DD, 'M', u'θ'),
+    (0x1D6DE, 'M', u'κ'),
+    (0x1D6DF, 'M', u'φ'),
+    (0x1D6E0, 'M', u'ρ'),
+    (0x1D6E1, 'M', u'π'),
+    (0x1D6E2, 'M', u'α'),
+    (0x1D6E3, 'M', u'β'),
+    (0x1D6E4, 'M', u'γ'),
+    (0x1D6E5, 'M', u'δ'),
+    (0x1D6E6, 'M', u'ε'),
+    (0x1D6E7, 'M', u'ζ'),
+    (0x1D6E8, 'M', u'η'),
+    (0x1D6E9, 'M', u'θ'),
+    (0x1D6EA, 'M', u'ι'),
+    (0x1D6EB, 'M', u'κ'),
+    (0x1D6EC, 'M', u'λ'),
+    (0x1D6ED, 'M', u'μ'),
+    (0x1D6EE, 'M', u'ν'),
+    (0x1D6EF, 'M', u'ξ'),
+    (0x1D6F0, 'M', u'ο'),
+    (0x1D6F1, 'M', u'π'),
+    (0x1D6F2, 'M', u'ρ'),
+    (0x1D6F3, 'M', u'θ'),
+    (0x1D6F4, 'M', u'σ'),
+    (0x1D6F5, 'M', u'τ'),
+    (0x1D6F6, 'M', u'υ'),
+    (0x1D6F7, 'M', u'φ'),
+    (0x1D6F8, 'M', u'χ'),
+    (0x1D6F9, 'M', u'ψ'),
+    (0x1D6FA, 'M', u'ω'),
+    (0x1D6FB, 'M', u'∇'),
+    (0x1D6FC, 'M', u'α'),
+    (0x1D6FD, 'M', u'β'),
+    (0x1D6FE, 'M', u'γ'),
+    (0x1D6FF, 'M', u'δ'),
+    (0x1D700, 'M', u'ε'),
+    (0x1D701, 'M', u'ζ'),
+    (0x1D702, 'M', u'η'),
+    (0x1D703, 'M', u'θ'),
+    (0x1D704, 'M', u'ι'),
+    (0x1D705, 'M', u'κ'),
+    (0x1D706, 'M', u'λ'),
+    (0x1D707, 'M', u'μ'),
+    (0x1D708, 'M', u'ν'),
+    (0x1D709, 'M', u'ξ'),
+    (0x1D70A, 'M', u'ο'),
+    (0x1D70B, 'M', u'π'),
+    (0x1D70C, 'M', u'ρ'),
+    (0x1D70D, 'M', u'σ'),
+    (0x1D70F, 'M', u'τ'),
+    (0x1D710, 'M', u'υ'),
+    (0x1D711, 'M', u'φ'),
+    (0x1D712, 'M', u'χ'),
+    (0x1D713, 'M', u'ψ'),
+    (0x1D714, 'M', u'ω'),
+    (0x1D715, 'M', u'∂'),
+    (0x1D716, 'M', u'ε'),
+    ]
+
+def _seg_67():
+    return [
+    (0x1D717, 'M', u'θ'),
+    (0x1D718, 'M', u'κ'),
+    (0x1D719, 'M', u'φ'),
+    (0x1D71A, 'M', u'ρ'),
+    (0x1D71B, 'M', u'π'),
+    (0x1D71C, 'M', u'α'),
+    (0x1D71D, 'M', u'β'),
+    (0x1D71E, 'M', u'γ'),
+    (0x1D71F, 'M', u'δ'),
+    (0x1D720, 'M', u'ε'),
+    (0x1D721, 'M', u'ζ'),
+    (0x1D722, 'M', u'η'),
+    (0x1D723, 'M', u'θ'),
+    (0x1D724, 'M', u'ι'),
+    (0x1D725, 'M', u'κ'),
+    (0x1D726, 'M', u'λ'),
+    (0x1D727, 'M', u'μ'),
+    (0x1D728, 'M', u'ν'),
+    (0x1D729, 'M', u'ξ'),
+    (0x1D72A, 'M', u'ο'),
+    (0x1D72B, 'M', u'π'),
+    (0x1D72C, 'M', u'ρ'),
+    (0x1D72D, 'M', u'θ'),
+    (0x1D72E, 'M', u'σ'),
+    (0x1D72F, 'M', u'τ'),
+    (0x1D730, 'M', u'υ'),
+    (0x1D731, 'M', u'φ'),
+    (0x1D732, 'M', u'χ'),
+    (0x1D733, 'M', u'ψ'),
+    (0x1D734, 'M', u'ω'),
+    (0x1D735, 'M', u'∇'),
+    (0x1D736, 'M', u'α'),
+    (0x1D737, 'M', u'β'),
+    (0x1D738, 'M', u'γ'),
+    (0x1D739, 'M', u'δ'),
+    (0x1D73A, 'M', u'ε'),
+    (0x1D73B, 'M', u'ζ'),
+    (0x1D73C, 'M', u'η'),
+    (0x1D73D, 'M', u'θ'),
+    (0x1D73E, 'M', u'ι'),
+    (0x1D73F, 'M', u'κ'),
+    (0x1D740, 'M', u'λ'),
+    (0x1D741, 'M', u'μ'),
+    (0x1D742, 'M', u'ν'),
+    (0x1D743, 'M', u'ξ'),
+    (0x1D744, 'M', u'ο'),
+    (0x1D745, 'M', u'π'),
+    (0x1D746, 'M', u'ρ'),
+    (0x1D747, 'M', u'σ'),
+    (0x1D749, 'M', u'τ'),
+    (0x1D74A, 'M', u'υ'),
+    (0x1D74B, 'M', u'φ'),
+    (0x1D74C, 'M', u'χ'),
+    (0x1D74D, 'M', u'ψ'),
+    (0x1D74E, 'M', u'ω'),
+    (0x1D74F, 'M', u'∂'),
+    (0x1D750, 'M', u'ε'),
+    (0x1D751, 'M', u'θ'),
+    (0x1D752, 'M', u'κ'),
+    (0x1D753, 'M', u'φ'),
+    (0x1D754, 'M', u'ρ'),
+    (0x1D755, 'M', u'π'),
+    (0x1D756, 'M', u'α'),
+    (0x1D757, 'M', u'β'),
+    (0x1D758, 'M', u'γ'),
+    (0x1D759, 'M', u'δ'),
+    (0x1D75A, 'M', u'ε'),
+    (0x1D75B, 'M', u'ζ'),
+    (0x1D75C, 'M', u'η'),
+    (0x1D75D, 'M', u'θ'),
+    (0x1D75E, 'M', u'ι'),
+    (0x1D75F, 'M', u'κ'),
+    (0x1D760, 'M', u'λ'),
+    (0x1D761, 'M', u'μ'),
+    (0x1D762, 'M', u'ν'),
+    (0x1D763, 'M', u'ξ'),
+    (0x1D764, 'M', u'ο'),
+    (0x1D765, 'M', u'π'),
+    (0x1D766, 'M', u'ρ'),
+    (0x1D767, 'M', u'θ'),
+    (0x1D768, 'M', u'σ'),
+    (0x1D769, 'M', u'τ'),
+    (0x1D76A, 'M', u'υ'),
+    (0x1D76B, 'M', u'φ'),
+    (0x1D76C, 'M', u'χ'),
+    (0x1D76D, 'M', u'ψ'),
+    (0x1D76E, 'M', u'ω'),
+    (0x1D76F, 'M', u'∇'),
+    (0x1D770, 'M', u'α'),
+    (0x1D771, 'M', u'β'),
+    (0x1D772, 'M', u'γ'),
+    (0x1D773, 'M', u'δ'),
+    (0x1D774, 'M', u'ε'),
+    (0x1D775, 'M', u'ζ'),
+    (0x1D776, 'M', u'η'),
+    (0x1D777, 'M', u'θ'),
+    (0x1D778, 'M', u'ι'),
+    (0x1D779, 'M', u'κ'),
+    (0x1D77A, 'M', u'λ'),
+    (0x1D77B, 'M', u'μ'),
+    ]
+
+def _seg_68():
+    return [
+    (0x1D77C, 'M', u'ν'),
+    (0x1D77D, 'M', u'ξ'),
+    (0x1D77E, 'M', u'ο'),
+    (0x1D77F, 'M', u'π'),
+    (0x1D780, 'M', u'ρ'),
+    (0x1D781, 'M', u'σ'),
+    (0x1D783, 'M', u'τ'),
+    (0x1D784, 'M', u'υ'),
+    (0x1D785, 'M', u'φ'),
+    (0x1D786, 'M', u'χ'),
+    (0x1D787, 'M', u'ψ'),
+    (0x1D788, 'M', u'ω'),
+    (0x1D789, 'M', u'∂'),
+    (0x1D78A, 'M', u'ε'),
+    (0x1D78B, 'M', u'θ'),
+    (0x1D78C, 'M', u'κ'),
+    (0x1D78D, 'M', u'φ'),
+    (0x1D78E, 'M', u'ρ'),
+    (0x1D78F, 'M', u'π'),
+    (0x1D790, 'M', u'α'),
+    (0x1D791, 'M', u'β'),
+    (0x1D792, 'M', u'γ'),
+    (0x1D793, 'M', u'δ'),
+    (0x1D794, 'M', u'ε'),
+    (0x1D795, 'M', u'ζ'),
+    (0x1D796, 'M', u'η'),
+    (0x1D797, 'M', u'θ'),
+    (0x1D798, 'M', u'ι'),
+    (0x1D799, 'M', u'κ'),
+    (0x1D79A, 'M', u'λ'),
+    (0x1D79B, 'M', u'μ'),
+    (0x1D79C, 'M', u'ν'),
+    (0x1D79D, 'M', u'ξ'),
+    (0x1D79E, 'M', u'ο'),
+    (0x1D79F, 'M', u'π'),
+    (0x1D7A0, 'M', u'ρ'),
+    (0x1D7A1, 'M', u'θ'),
+    (0x1D7A2, 'M', u'σ'),
+    (0x1D7A3, 'M', u'τ'),
+    (0x1D7A4, 'M', u'υ'),
+    (0x1D7A5, 'M', u'φ'),
+    (0x1D7A6, 'M', u'χ'),
+    (0x1D7A7, 'M', u'ψ'),
+    (0x1D7A8, 'M', u'ω'),
+    (0x1D7A9, 'M', u'∇'),
+    (0x1D7AA, 'M', u'α'),
+    (0x1D7AB, 'M', u'β'),
+    (0x1D7AC, 'M', u'γ'),
+    (0x1D7AD, 'M', u'δ'),
+    (0x1D7AE, 'M', u'ε'),
+    (0x1D7AF, 'M', u'ζ'),
+    (0x1D7B0, 'M', u'η'),
+    (0x1D7B1, 'M', u'θ'),
+    (0x1D7B2, 'M', u'ι'),
+    (0x1D7B3, 'M', u'κ'),
+    (0x1D7B4, 'M', u'λ'),
+    (0x1D7B5, 'M', u'μ'),
+    (0x1D7B6, 'M', u'ν'),
+    (0x1D7B7, 'M', u'ξ'),
+    (0x1D7B8, 'M', u'ο'),
+    (0x1D7B9, 'M', u'π'),
+    (0x1D7BA, 'M', u'ρ'),
+    (0x1D7BB, 'M', u'σ'),
+    (0x1D7BD, 'M', u'τ'),
+    (0x1D7BE, 'M', u'υ'),
+    (0x1D7BF, 'M', u'φ'),
+    (0x1D7C0, 'M', u'χ'),
+    (0x1D7C1, 'M', u'ψ'),
+    (0x1D7C2, 'M', u'ω'),
+    (0x1D7C3, 'M', u'∂'),
+    (0x1D7C4, 'M', u'ε'),
+    (0x1D7C5, 'M', u'θ'),
+    (0x1D7C6, 'M', u'κ'),
+    (0x1D7C7, 'M', u'φ'),
+    (0x1D7C8, 'M', u'ρ'),
+    (0x1D7C9, 'M', u'π'),
+    (0x1D7CA, 'M', u'ϝ'),
+    (0x1D7CC, 'X'),
+    (0x1D7CE, 'M', u'0'),
+    (0x1D7CF, 'M', u'1'),
+    (0x1D7D0, 'M', u'2'),
+    (0x1D7D1, 'M', u'3'),
+    (0x1D7D2, 'M', u'4'),
+    (0x1D7D3, 'M', u'5'),
+    (0x1D7D4, 'M', u'6'),
+    (0x1D7D5, 'M', u'7'),
+    (0x1D7D6, 'M', u'8'),
+    (0x1D7D7, 'M', u'9'),
+    (0x1D7D8, 'M', u'0'),
+    (0x1D7D9, 'M', u'1'),
+    (0x1D7DA, 'M', u'2'),
+    (0x1D7DB, 'M', u'3'),
+    (0x1D7DC, 'M', u'4'),
+    (0x1D7DD, 'M', u'5'),
+    (0x1D7DE, 'M', u'6'),
+    (0x1D7DF, 'M', u'7'),
+    (0x1D7E0, 'M', u'8'),
+    (0x1D7E1, 'M', u'9'),
+    (0x1D7E2, 'M', u'0'),
+    (0x1D7E3, 'M', u'1'),
+    ]
+
+def _seg_69():
+    return [
+    (0x1D7E4, 'M', u'2'),
+    (0x1D7E5, 'M', u'3'),
+    (0x1D7E6, 'M', u'4'),
+    (0x1D7E7, 'M', u'5'),
+    (0x1D7E8, 'M', u'6'),
+    (0x1D7E9, 'M', u'7'),
+    (0x1D7EA, 'M', u'8'),
+    (0x1D7EB, 'M', u'9'),
+    (0x1D7EC, 'M', u'0'),
+    (0x1D7ED, 'M', u'1'),
+    (0x1D7EE, 'M', u'2'),
+    (0x1D7EF, 'M', u'3'),
+    (0x1D7F0, 'M', u'4'),
+    (0x1D7F1, 'M', u'5'),
+    (0x1D7F2, 'M', u'6'),
+    (0x1D7F3, 'M', u'7'),
+    (0x1D7F4, 'M', u'8'),
+    (0x1D7F5, 'M', u'9'),
+    (0x1D7F6, 'M', u'0'),
+    (0x1D7F7, 'M', u'1'),
+    (0x1D7F8, 'M', u'2'),
+    (0x1D7F9, 'M', u'3'),
+    (0x1D7FA, 'M', u'4'),
+    (0x1D7FB, 'M', u'5'),
+    (0x1D7FC, 'M', u'6'),
+    (0x1D7FD, 'M', u'7'),
+    (0x1D7FE, 'M', u'8'),
+    (0x1D7FF, 'M', u'9'),
+    (0x1D800, 'V'),
+    (0x1DA8C, 'X'),
+    (0x1DA9B, 'V'),
+    (0x1DAA0, 'X'),
+    (0x1DAA1, 'V'),
+    (0x1DAB0, 'X'),
+    (0x1E000, 'V'),
+    (0x1E007, 'X'),
+    (0x1E008, 'V'),
+    (0x1E019, 'X'),
+    (0x1E01B, 'V'),
+    (0x1E022, 'X'),
+    (0x1E023, 'V'),
+    (0x1E025, 'X'),
+    (0x1E026, 'V'),
+    (0x1E02B, 'X'),
+    (0x1E100, 'V'),
+    (0x1E12D, 'X'),
+    (0x1E130, 'V'),
+    (0x1E13E, 'X'),
+    (0x1E140, 'V'),
+    (0x1E14A, 'X'),
+    (0x1E14E, 'V'),
+    (0x1E150, 'X'),
+    (0x1E2C0, 'V'),
+    (0x1E2FA, 'X'),
+    (0x1E2FF, 'V'),
+    (0x1E300, 'X'),
+    (0x1E800, 'V'),
+    (0x1E8C5, 'X'),
+    (0x1E8C7, 'V'),
+    (0x1E8D7, 'X'),
+    (0x1E900, 'M', u'𞤢'),
+    (0x1E901, 'M', u'𞤣'),
+    (0x1E902, 'M', u'𞤤'),
+    (0x1E903, 'M', u'𞤥'),
+    (0x1E904, 'M', u'𞤦'),
+    (0x1E905, 'M', u'𞤧'),
+    (0x1E906, 'M', u'𞤨'),
+    (0x1E907, 'M', u'𞤩'),
+    (0x1E908, 'M', u'𞤪'),
+    (0x1E909, 'M', u'𞤫'),
+    (0x1E90A, 'M', u'𞤬'),
+    (0x1E90B, 'M', u'𞤭'),
+    (0x1E90C, 'M', u'𞤮'),
+    (0x1E90D, 'M', u'𞤯'),
+    (0x1E90E, 'M', u'𞤰'),
+    (0x1E90F, 'M', u'𞤱'),
+    (0x1E910, 'M', u'𞤲'),
+    (0x1E911, 'M', u'𞤳'),
+    (0x1E912, 'M', u'𞤴'),
+    (0x1E913, 'M', u'𞤵'),
+    (0x1E914, 'M', u'𞤶'),
+    (0x1E915, 'M', u'𞤷'),
+    (0x1E916, 'M', u'𞤸'),
+    (0x1E917, 'M', u'𞤹'),
+    (0x1E918, 'M', u'𞤺'),
+    (0x1E919, 'M', u'𞤻'),
+    (0x1E91A, 'M', u'𞤼'),
+    (0x1E91B, 'M', u'𞤽'),
+    (0x1E91C, 'M', u'𞤾'),
+    (0x1E91D, 'M', u'𞤿'),
+    (0x1E91E, 'M', u'𞥀'),
+    (0x1E91F, 'M', u'𞥁'),
+    (0x1E920, 'M', u'𞥂'),
+    (0x1E921, 'M', u'𞥃'),
+    (0x1E922, 'V'),
+    (0x1E94C, 'X'),
+    (0x1E950, 'V'),
+    (0x1E95A, 'X'),
+    (0x1E95E, 'V'),
+    (0x1E960, 'X'),
+    ]
+
+def _seg_70():
+    return [
+    (0x1EC71, 'V'),
+    (0x1ECB5, 'X'),
+    (0x1ED01, 'V'),
+    (0x1ED3E, 'X'),
+    (0x1EE00, 'M', u'ا'),
+    (0x1EE01, 'M', u'ب'),
+    (0x1EE02, 'M', u'ج'),
+    (0x1EE03, 'M', u'د'),
+    (0x1EE04, 'X'),
+    (0x1EE05, 'M', u'و'),
+    (0x1EE06, 'M', u'ز'),
+    (0x1EE07, 'M', u'ح'),
+    (0x1EE08, 'M', u'ط'),
+    (0x1EE09, 'M', u'ي'),
+    (0x1EE0A, 'M', u'ك'),
+    (0x1EE0B, 'M', u'ل'),
+    (0x1EE0C, 'M', u'م'),
+    (0x1EE0D, 'M', u'ن'),
+    (0x1EE0E, 'M', u'س'),
+    (0x1EE0F, 'M', u'ع'),
+    (0x1EE10, 'M', u'ف'),
+    (0x1EE11, 'M', u'ص'),
+    (0x1EE12, 'M', u'ق'),
+    (0x1EE13, 'M', u'ر'),
+    (0x1EE14, 'M', u'ش'),
+    (0x1EE15, 'M', u'ت'),
+    (0x1EE16, 'M', u'ث'),
+    (0x1EE17, 'M', u'خ'),
+    (0x1EE18, 'M', u'ذ'),
+    (0x1EE19, 'M', u'ض'),
+    (0x1EE1A, 'M', u'ظ'),
+    (0x1EE1B, 'M', u'غ'),
+    (0x1EE1C, 'M', u'ٮ'),
+    (0x1EE1D, 'M', u'ں'),
+    (0x1EE1E, 'M', u'ڡ'),
+    (0x1EE1F, 'M', u'ٯ'),
+    (0x1EE20, 'X'),
+    (0x1EE21, 'M', u'ب'),
+    (0x1EE22, 'M', u'ج'),
+    (0x1EE23, 'X'),
+    (0x1EE24, 'M', u'ه'),
+    (0x1EE25, 'X'),
+    (0x1EE27, 'M', u'ح'),
+    (0x1EE28, 'X'),
+    (0x1EE29, 'M', u'ي'),
+    (0x1EE2A, 'M', u'ك'),
+    (0x1EE2B, 'M', u'ل'),
+    (0x1EE2C, 'M', u'م'),
+    (0x1EE2D, 'M', u'ن'),
+    (0x1EE2E, 'M', u'س'),
+    (0x1EE2F, 'M', u'ع'),
+    (0x1EE30, 'M', u'ف'),
+    (0x1EE31, 'M', u'ص'),
+    (0x1EE32, 'M', u'ق'),
+    (0x1EE33, 'X'),
+    (0x1EE34, 'M', u'ش'),
+    (0x1EE35, 'M', u'ت'),
+    (0x1EE36, 'M', u'ث'),
+    (0x1EE37, 'M', u'خ'),
+    (0x1EE38, 'X'),
+    (0x1EE39, 'M', u'ض'),
+    (0x1EE3A, 'X'),
+    (0x1EE3B, 'M', u'غ'),
+    (0x1EE3C, 'X'),
+    (0x1EE42, 'M', u'ج'),
+    (0x1EE43, 'X'),
+    (0x1EE47, 'M', u'ح'),
+    (0x1EE48, 'X'),
+    (0x1EE49, 'M', u'ي'),
+    (0x1EE4A, 'X'),
+    (0x1EE4B, 'M', u'ل'),
+    (0x1EE4C, 'X'),
+    (0x1EE4D, 'M', u'ن'),
+    (0x1EE4E, 'M', u'س'),
+    (0x1EE4F, 'M', u'ع'),
+    (0x1EE50, 'X'),
+    (0x1EE51, 'M', u'ص'),
+    (0x1EE52, 'M', u'ق'),
+    (0x1EE53, 'X'),
+    (0x1EE54, 'M', u'ش'),
+    (0x1EE55, 'X'),
+    (0x1EE57, 'M', u'خ'),
+    (0x1EE58, 'X'),
+    (0x1EE59, 'M', u'ض'),
+    (0x1EE5A, 'X'),
+    (0x1EE5B, 'M', u'غ'),
+    (0x1EE5C, 'X'),
+    (0x1EE5D, 'M', u'ں'),
+    (0x1EE5E, 'X'),
+    (0x1EE5F, 'M', u'ٯ'),
+    (0x1EE60, 'X'),
+    (0x1EE61, 'M', u'ب'),
+    (0x1EE62, 'M', u'ج'),
+    (0x1EE63, 'X'),
+    (0x1EE64, 'M', u'ه'),
+    (0x1EE65, 'X'),
+    (0x1EE67, 'M', u'ح'),
+    (0x1EE68, 'M', u'ط'),
+    (0x1EE69, 'M', u'ي'),
+    (0x1EE6A, 'M', u'ك'),
+    ]
+
+def _seg_71():
+    return [
+    (0x1EE6B, 'X'),
+    (0x1EE6C, 'M', u'م'),
+    (0x1EE6D, 'M', u'ن'),
+    (0x1EE6E, 'M', u'س'),
+    (0x1EE6F, 'M', u'ع'),
+    (0x1EE70, 'M', u'ف'),
+    (0x1EE71, 'M', u'ص'),
+    (0x1EE72, 'M', u'ق'),
+    (0x1EE73, 'X'),
+    (0x1EE74, 'M', u'ش'),
+    (0x1EE75, 'M', u'ت'),
+    (0x1EE76, 'M', u'ث'),
+    (0x1EE77, 'M', u'خ'),
+    (0x1EE78, 'X'),
+    (0x1EE79, 'M', u'ض'),
+    (0x1EE7A, 'M', u'ظ'),
+    (0x1EE7B, 'M', u'غ'),
+    (0x1EE7C, 'M', u'ٮ'),
+    (0x1EE7D, 'X'),
+    (0x1EE7E, 'M', u'ڡ'),
+    (0x1EE7F, 'X'),
+    (0x1EE80, 'M', u'ا'),
+    (0x1EE81, 'M', u'ب'),
+    (0x1EE82, 'M', u'ج'),
+    (0x1EE83, 'M', u'د'),
+    (0x1EE84, 'M', u'ه'),
+    (0x1EE85, 'M', u'و'),
+    (0x1EE86, 'M', u'ز'),
+    (0x1EE87, 'M', u'ح'),
+    (0x1EE88, 'M', u'ط'),
+    (0x1EE89, 'M', u'ي'),
+    (0x1EE8A, 'X'),
+    (0x1EE8B, 'M', u'ل'),
+    (0x1EE8C, 'M', u'م'),
+    (0x1EE8D, 'M', u'ن'),
+    (0x1EE8E, 'M', u'س'),
+    (0x1EE8F, 'M', u'ع'),
+    (0x1EE90, 'M', u'ف'),
+    (0x1EE91, 'M', u'ص'),
+    (0x1EE92, 'M', u'ق'),
+    (0x1EE93, 'M', u'ر'),
+    (0x1EE94, 'M', u'ش'),
+    (0x1EE95, 'M', u'ت'),
+    (0x1EE96, 'M', u'ث'),
+    (0x1EE97, 'M', u'خ'),
+    (0x1EE98, 'M', u'ذ'),
+    (0x1EE99, 'M', u'ض'),
+    (0x1EE9A, 'M', u'ظ'),
+    (0x1EE9B, 'M', u'غ'),
+    (0x1EE9C, 'X'),
+    (0x1EEA1, 'M', u'ب'),
+    (0x1EEA2, 'M', u'ج'),
+    (0x1EEA3, 'M', u'د'),
+    (0x1EEA4, 'X'),
+    (0x1EEA5, 'M', u'و'),
+    (0x1EEA6, 'M', u'ز'),
+    (0x1EEA7, 'M', u'ح'),
+    (0x1EEA8, 'M', u'ط'),
+    (0x1EEA9, 'M', u'ي'),
+    (0x1EEAA, 'X'),
+    (0x1EEAB, 'M', u'ل'),
+    (0x1EEAC, 'M', u'م'),
+    (0x1EEAD, 'M', u'ن'),
+    (0x1EEAE, 'M', u'س'),
+    (0x1EEAF, 'M', u'ع'),
+    (0x1EEB0, 'M', u'ف'),
+    (0x1EEB1, 'M', u'ص'),
+    (0x1EEB2, 'M', u'ق'),
+    (0x1EEB3, 'M', u'ر'),
+    (0x1EEB4, 'M', u'ش'),
+    (0x1EEB5, 'M', u'ت'),
+    (0x1EEB6, 'M', u'ث'),
+    (0x1EEB7, 'M', u'خ'),
+    (0x1EEB8, 'M', u'ذ'),
+    (0x1EEB9, 'M', u'ض'),
+    (0x1EEBA, 'M', u'ظ'),
+    (0x1EEBB, 'M', u'غ'),
+    (0x1EEBC, 'X'),
+    (0x1EEF0, 'V'),
+    (0x1EEF2, 'X'),
+    (0x1F000, 'V'),
+    (0x1F02C, 'X'),
+    (0x1F030, 'V'),
+    (0x1F094, 'X'),
+    (0x1F0A0, 'V'),
+    (0x1F0AF, 'X'),
+    (0x1F0B1, 'V'),
+    (0x1F0C0, 'X'),
+    (0x1F0C1, 'V'),
+    (0x1F0D0, 'X'),
+    (0x1F0D1, 'V'),
+    (0x1F0F6, 'X'),
+    (0x1F101, '3', u'0,'),
+    (0x1F102, '3', u'1,'),
+    (0x1F103, '3', u'2,'),
+    (0x1F104, '3', u'3,'),
+    (0x1F105, '3', u'4,'),
+    (0x1F106, '3', u'5,'),
+    (0x1F107, '3', u'6,'),
+    (0x1F108, '3', u'7,'),
+    ]
+
+def _seg_72():
+    return [
+    (0x1F109, '3', u'8,'),
+    (0x1F10A, '3', u'9,'),
+    (0x1F10B, 'V'),
+    (0x1F110, '3', u'(a)'),
+    (0x1F111, '3', u'(b)'),
+    (0x1F112, '3', u'(c)'),
+    (0x1F113, '3', u'(d)'),
+    (0x1F114, '3', u'(e)'),
+    (0x1F115, '3', u'(f)'),
+    (0x1F116, '3', u'(g)'),
+    (0x1F117, '3', u'(h)'),
+    (0x1F118, '3', u'(i)'),
+    (0x1F119, '3', u'(j)'),
+    (0x1F11A, '3', u'(k)'),
+    (0x1F11B, '3', u'(l)'),
+    (0x1F11C, '3', u'(m)'),
+    (0x1F11D, '3', u'(n)'),
+    (0x1F11E, '3', u'(o)'),
+    (0x1F11F, '3', u'(p)'),
+    (0x1F120, '3', u'(q)'),
+    (0x1F121, '3', u'(r)'),
+    (0x1F122, '3', u'(s)'),
+    (0x1F123, '3', u'(t)'),
+    (0x1F124, '3', u'(u)'),
+    (0x1F125, '3', u'(v)'),
+    (0x1F126, '3', u'(w)'),
+    (0x1F127, '3', u'(x)'),
+    (0x1F128, '3', u'(y)'),
+    (0x1F129, '3', u'(z)'),
+    (0x1F12A, 'M', u'〔s〕'),
+    (0x1F12B, 'M', u'c'),
+    (0x1F12C, 'M', u'r'),
+    (0x1F12D, 'M', u'cd'),
+    (0x1F12E, 'M', u'wz'),
+    (0x1F12F, 'V'),
+    (0x1F130, 'M', u'a'),
+    (0x1F131, 'M', u'b'),
+    (0x1F132, 'M', u'c'),
+    (0x1F133, 'M', u'd'),
+    (0x1F134, 'M', u'e'),
+    (0x1F135, 'M', u'f'),
+    (0x1F136, 'M', u'g'),
+    (0x1F137, 'M', u'h'),
+    (0x1F138, 'M', u'i'),
+    (0x1F139, 'M', u'j'),
+    (0x1F13A, 'M', u'k'),
+    (0x1F13B, 'M', u'l'),
+    (0x1F13C, 'M', u'm'),
+    (0x1F13D, 'M', u'n'),
+    (0x1F13E, 'M', u'o'),
+    (0x1F13F, 'M', u'p'),
+    (0x1F140, 'M', u'q'),
+    (0x1F141, 'M', u'r'),
+    (0x1F142, 'M', u's'),
+    (0x1F143, 'M', u't'),
+    (0x1F144, 'M', u'u'),
+    (0x1F145, 'M', u'v'),
+    (0x1F146, 'M', u'w'),
+    (0x1F147, 'M', u'x'),
+    (0x1F148, 'M', u'y'),
+    (0x1F149, 'M', u'z'),
+    (0x1F14A, 'M', u'hv'),
+    (0x1F14B, 'M', u'mv'),
+    (0x1F14C, 'M', u'sd'),
+    (0x1F14D, 'M', u'ss'),
+    (0x1F14E, 'M', u'ppv'),
+    (0x1F14F, 'M', u'wc'),
+    (0x1F150, 'V'),
+    (0x1F16A, 'M', u'mc'),
+    (0x1F16B, 'M', u'md'),
+    (0x1F16C, 'M', u'mr'),
+    (0x1F16D, 'V'),
+    (0x1F190, 'M', u'dj'),
+    (0x1F191, 'V'),
+    (0x1F1AE, 'X'),
+    (0x1F1E6, 'V'),
+    (0x1F200, 'M', u'ほか'),
+    (0x1F201, 'M', u'ココ'),
+    (0x1F202, 'M', u'サ'),
+    (0x1F203, 'X'),
+    (0x1F210, 'M', u'手'),
+    (0x1F211, 'M', u'字'),
+    (0x1F212, 'M', u'双'),
+    (0x1F213, 'M', u'デ'),
+    (0x1F214, 'M', u'二'),
+    (0x1F215, 'M', u'多'),
+    (0x1F216, 'M', u'解'),
+    (0x1F217, 'M', u'天'),
+    (0x1F218, 'M', u'交'),
+    (0x1F219, 'M', u'映'),
+    (0x1F21A, 'M', u'無'),
+    (0x1F21B, 'M', u'料'),
+    (0x1F21C, 'M', u'前'),
+    (0x1F21D, 'M', u'後'),
+    (0x1F21E, 'M', u'再'),
+    (0x1F21F, 'M', u'新'),
+    (0x1F220, 'M', u'初'),
+    (0x1F221, 'M', u'終'),
+    (0x1F222, 'M', u'生'),
+    (0x1F223, 'M', u'販'),
+    ]
+
+def _seg_73():
+    return [
+    (0x1F224, 'M', u'声'),
+    (0x1F225, 'M', u'吹'),
+    (0x1F226, 'M', u'演'),
+    (0x1F227, 'M', u'投'),
+    (0x1F228, 'M', u'捕'),
+    (0x1F229, 'M', u'一'),
+    (0x1F22A, 'M', u'三'),
+    (0x1F22B, 'M', u'遊'),
+    (0x1F22C, 'M', u'左'),
+    (0x1F22D, 'M', u'中'),
+    (0x1F22E, 'M', u'右'),
+    (0x1F22F, 'M', u'指'),
+    (0x1F230, 'M', u'走'),
+    (0x1F231, 'M', u'打'),
+    (0x1F232, 'M', u'禁'),
+    (0x1F233, 'M', u'空'),
+    (0x1F234, 'M', u'合'),
+    (0x1F235, 'M', u'満'),
+    (0x1F236, 'M', u'有'),
+    (0x1F237, 'M', u'月'),
+    (0x1F238, 'M', u'申'),
+    (0x1F239, 'M', u'割'),
+    (0x1F23A, 'M', u'営'),
+    (0x1F23B, 'M', u'配'),
+    (0x1F23C, 'X'),
+    (0x1F240, 'M', u'〔本〕'),
+    (0x1F241, 'M', u'〔三〕'),
+    (0x1F242, 'M', u'〔二〕'),
+    (0x1F243, 'M', u'〔安〕'),
+    (0x1F244, 'M', u'〔点〕'),
+    (0x1F245, 'M', u'〔打〕'),
+    (0x1F246, 'M', u'〔盗〕'),
+    (0x1F247, 'M', u'〔勝〕'),
+    (0x1F248, 'M', u'〔敗〕'),
+    (0x1F249, 'X'),
+    (0x1F250, 'M', u'得'),
+    (0x1F251, 'M', u'可'),
+    (0x1F252, 'X'),
+    (0x1F260, 'V'),
+    (0x1F266, 'X'),
+    (0x1F300, 'V'),
+    (0x1F6D8, 'X'),
+    (0x1F6E0, 'V'),
+    (0x1F6ED, 'X'),
+    (0x1F6F0, 'V'),
+    (0x1F6FD, 'X'),
+    (0x1F700, 'V'),
+    (0x1F774, 'X'),
+    (0x1F780, 'V'),
+    (0x1F7D9, 'X'),
+    (0x1F7E0, 'V'),
+    (0x1F7EC, 'X'),
+    (0x1F800, 'V'),
+    (0x1F80C, 'X'),
+    (0x1F810, 'V'),
+    (0x1F848, 'X'),
+    (0x1F850, 'V'),
+    (0x1F85A, 'X'),
+    (0x1F860, 'V'),
+    (0x1F888, 'X'),
+    (0x1F890, 'V'),
+    (0x1F8AE, 'X'),
+    (0x1F8B0, 'V'),
+    (0x1F8B2, 'X'),
+    (0x1F900, 'V'),
+    (0x1F979, 'X'),
+    (0x1F97A, 'V'),
+    (0x1F9CC, 'X'),
+    (0x1F9CD, 'V'),
+    (0x1FA54, 'X'),
+    (0x1FA60, 'V'),
+    (0x1FA6E, 'X'),
+    (0x1FA70, 'V'),
+    (0x1FA75, 'X'),
+    (0x1FA78, 'V'),
+    (0x1FA7B, 'X'),
+    (0x1FA80, 'V'),
+    (0x1FA87, 'X'),
+    (0x1FA90, 'V'),
+    (0x1FAA9, 'X'),
+    (0x1FAB0, 'V'),
+    (0x1FAB7, 'X'),
+    (0x1FAC0, 'V'),
+    (0x1FAC3, 'X'),
+    (0x1FAD0, 'V'),
+    (0x1FAD7, 'X'),
+    (0x1FB00, 'V'),
+    (0x1FB93, 'X'),
+    (0x1FB94, 'V'),
+    (0x1FBCB, 'X'),
+    (0x1FBF0, 'M', u'0'),
+    (0x1FBF1, 'M', u'1'),
+    (0x1FBF2, 'M', u'2'),
+    (0x1FBF3, 'M', u'3'),
+    (0x1FBF4, 'M', u'4'),
+    (0x1FBF5, 'M', u'5'),
+    (0x1FBF6, 'M', u'6'),
+    (0x1FBF7, 'M', u'7'),
+    (0x1FBF8, 'M', u'8'),
+    (0x1FBF9, 'M', u'9'),
+    ]
+
+def _seg_74():
+    return [
+    (0x1FBFA, 'X'),
+    (0x20000, 'V'),
+    (0x2A6DE, 'X'),
+    (0x2A700, 'V'),
+    (0x2B735, 'X'),
+    (0x2B740, 'V'),
+    (0x2B81E, 'X'),
+    (0x2B820, 'V'),
+    (0x2CEA2, 'X'),
+    (0x2CEB0, 'V'),
+    (0x2EBE1, 'X'),
+    (0x2F800, 'M', u'丽'),
+    (0x2F801, 'M', u'丸'),
+    (0x2F802, 'M', u'乁'),
+    (0x2F803, 'M', u'𠄢'),
+    (0x2F804, 'M', u'你'),
+    (0x2F805, 'M', u'侮'),
+    (0x2F806, 'M', u'侻'),
+    (0x2F807, 'M', u'倂'),
+    (0x2F808, 'M', u'偺'),
+    (0x2F809, 'M', u'備'),
+    (0x2F80A, 'M', u'僧'),
+    (0x2F80B, 'M', u'像'),
+    (0x2F80C, 'M', u'㒞'),
+    (0x2F80D, 'M', u'𠘺'),
+    (0x2F80E, 'M', u'免'),
+    (0x2F80F, 'M', u'兔'),
+    (0x2F810, 'M', u'兤'),
+    (0x2F811, 'M', u'具'),
+    (0x2F812, 'M', u'𠔜'),
+    (0x2F813, 'M', u'㒹'),
+    (0x2F814, 'M', u'內'),
+    (0x2F815, 'M', u'再'),
+    (0x2F816, 'M', u'𠕋'),
+    (0x2F817, 'M', u'冗'),
+    (0x2F818, 'M', u'冤'),
+    (0x2F819, 'M', u'仌'),
+    (0x2F81A, 'M', u'冬'),
+    (0x2F81B, 'M', u'况'),
+    (0x2F81C, 'M', u'𩇟'),
+    (0x2F81D, 'M', u'凵'),
+    (0x2F81E, 'M', u'刃'),
+    (0x2F81F, 'M', u'㓟'),
+    (0x2F820, 'M', u'刻'),
+    (0x2F821, 'M', u'剆'),
+    (0x2F822, 'M', u'割'),
+    (0x2F823, 'M', u'剷'),
+    (0x2F824, 'M', u'㔕'),
+    (0x2F825, 'M', u'勇'),
+    (0x2F826, 'M', u'勉'),
+    (0x2F827, 'M', u'勤'),
+    (0x2F828, 'M', u'勺'),
+    (0x2F829, 'M', u'包'),
+    (0x2F82A, 'M', u'匆'),
+    (0x2F82B, 'M', u'北'),
+    (0x2F82C, 'M', u'卉'),
+    (0x2F82D, 'M', u'卑'),
+    (0x2F82E, 'M', u'博'),
+    (0x2F82F, 'M', u'即'),
+    (0x2F830, 'M', u'卽'),
+    (0x2F831, 'M', u'卿'),
+    (0x2F834, 'M', u'𠨬'),
+    (0x2F835, 'M', u'灰'),
+    (0x2F836, 'M', u'及'),
+    (0x2F837, 'M', u'叟'),
+    (0x2F838, 'M', u'𠭣'),
+    (0x2F839, 'M', u'叫'),
+    (0x2F83A, 'M', u'叱'),
+    (0x2F83B, 'M', u'吆'),
+    (0x2F83C, 'M', u'咞'),
+    (0x2F83D, 'M', u'吸'),
+    (0x2F83E, 'M', u'呈'),
+    (0x2F83F, 'M', u'周'),
+    (0x2F840, 'M', u'咢'),
+    (0x2F841, 'M', u'哶'),
+    (0x2F842, 'M', u'唐'),
+    (0x2F843, 'M', u'啓'),
+    (0x2F844, 'M', u'啣'),
+    (0x2F845, 'M', u'善'),
+    (0x2F847, 'M', u'喙'),
+    (0x2F848, 'M', u'喫'),
+    (0x2F849, 'M', u'喳'),
+    (0x2F84A, 'M', u'嗂'),
+    (0x2F84B, 'M', u'圖'),
+    (0x2F84C, 'M', u'嘆'),
+    (0x2F84D, 'M', u'圗'),
+    (0x2F84E, 'M', u'噑'),
+    (0x2F84F, 'M', u'噴'),
+    (0x2F850, 'M', u'切'),
+    (0x2F851, 'M', u'壮'),
+    (0x2F852, 'M', u'城'),
+    (0x2F853, 'M', u'埴'),
+    (0x2F854, 'M', u'堍'),
+    (0x2F855, 'M', u'型'),
+    (0x2F856, 'M', u'堲'),
+    (0x2F857, 'M', u'報'),
+    (0x2F858, 'M', u'墬'),
+    (0x2F859, 'M', u'𡓤'),
+    (0x2F85A, 'M', u'売'),
+    (0x2F85B, 'M', u'壷'),
+    ]
+
+def _seg_75():
+    return [
+    (0x2F85C, 'M', u'夆'),
+    (0x2F85D, 'M', u'多'),
+    (0x2F85E, 'M', u'夢'),
+    (0x2F85F, 'M', u'奢'),
+    (0x2F860, 'M', u'𡚨'),
+    (0x2F861, 'M', u'𡛪'),
+    (0x2F862, 'M', u'姬'),
+    (0x2F863, 'M', u'娛'),
+    (0x2F864, 'M', u'娧'),
+    (0x2F865, 'M', u'姘'),
+    (0x2F866, 'M', u'婦'),
+    (0x2F867, 'M', u'㛮'),
+    (0x2F868, 'X'),
+    (0x2F869, 'M', u'嬈'),
+    (0x2F86A, 'M', u'嬾'),
+    (0x2F86C, 'M', u'𡧈'),
+    (0x2F86D, 'M', u'寃'),
+    (0x2F86E, 'M', u'寘'),
+    (0x2F86F, 'M', u'寧'),
+    (0x2F870, 'M', u'寳'),
+    (0x2F871, 'M', u'𡬘'),
+    (0x2F872, 'M', u'寿'),
+    (0x2F873, 'M', u'将'),
+    (0x2F874, 'X'),
+    (0x2F875, 'M', u'尢'),
+    (0x2F876, 'M', u'㞁'),
+    (0x2F877, 'M', u'屠'),
+    (0x2F878, 'M', u'屮'),
+    (0x2F879, 'M', u'峀'),
+    (0x2F87A, 'M', u'岍'),
+    (0x2F87B, 'M', u'𡷤'),
+    (0x2F87C, 'M', u'嵃'),
+    (0x2F87D, 'M', u'𡷦'),
+    (0x2F87E, 'M', u'嵮'),
+    (0x2F87F, 'M', u'嵫'),
+    (0x2F880, 'M', u'嵼'),
+    (0x2F881, 'M', u'巡'),
+    (0x2F882, 'M', u'巢'),
+    (0x2F883, 'M', u'㠯'),
+    (0x2F884, 'M', u'巽'),
+    (0x2F885, 'M', u'帨'),
+    (0x2F886, 'M', u'帽'),
+    (0x2F887, 'M', u'幩'),
+    (0x2F888, 'M', u'㡢'),
+    (0x2F889, 'M', u'𢆃'),
+    (0x2F88A, 'M', u'㡼'),
+    (0x2F88B, 'M', u'庰'),
+    (0x2F88C, 'M', u'庳'),
+    (0x2F88D, 'M', u'庶'),
+    (0x2F88E, 'M', u'廊'),
+    (0x2F88F, 'M', u'𪎒'),
+    (0x2F890, 'M', u'廾'),
+    (0x2F891, 'M', u'𢌱'),
+    (0x2F893, 'M', u'舁'),
+    (0x2F894, 'M', u'弢'),
+    (0x2F896, 'M', u'㣇'),
+    (0x2F897, 'M', u'𣊸'),
+    (0x2F898, 'M', u'𦇚'),
+    (0x2F899, 'M', u'形'),
+    (0x2F89A, 'M', u'彫'),
+    (0x2F89B, 'M', u'㣣'),
+    (0x2F89C, 'M', u'徚'),
+    (0x2F89D, 'M', u'忍'),
+    (0x2F89E, 'M', u'志'),
+    (0x2F89F, 'M', u'忹'),
+    (0x2F8A0, 'M', u'悁'),
+    (0x2F8A1, 'M', u'㤺'),
+    (0x2F8A2, 'M', u'㤜'),
+    (0x2F8A3, 'M', u'悔'),
+    (0x2F8A4, 'M', u'𢛔'),
+    (0x2F8A5, 'M', u'惇'),
+    (0x2F8A6, 'M', u'慈'),
+    (0x2F8A7, 'M', u'慌'),
+    (0x2F8A8, 'M', u'慎'),
+    (0x2F8A9, 'M', u'慌'),
+    (0x2F8AA, 'M', u'慺'),
+    (0x2F8AB, 'M', u'憎'),
+    (0x2F8AC, 'M', u'憲'),
+    (0x2F8AD, 'M', u'憤'),
+    (0x2F8AE, 'M', u'憯'),
+    (0x2F8AF, 'M', u'懞'),
+    (0x2F8B0, 'M', u'懲'),
+    (0x2F8B1, 'M', u'懶'),
+    (0x2F8B2, 'M', u'成'),
+    (0x2F8B3, 'M', u'戛'),
+    (0x2F8B4, 'M', u'扝'),
+    (0x2F8B5, 'M', u'抱'),
+    (0x2F8B6, 'M', u'拔'),
+    (0x2F8B7, 'M', u'捐'),
+    (0x2F8B8, 'M', u'𢬌'),
+    (0x2F8B9, 'M', u'挽'),
+    (0x2F8BA, 'M', u'拼'),
+    (0x2F8BB, 'M', u'捨'),
+    (0x2F8BC, 'M', u'掃'),
+    (0x2F8BD, 'M', u'揤'),
+    (0x2F8BE, 'M', u'𢯱'),
+    (0x2F8BF, 'M', u'搢'),
+    (0x2F8C0, 'M', u'揅'),
+    (0x2F8C1, 'M', u'掩'),
+    (0x2F8C2, 'M', u'㨮'),
+    ]
+
+def _seg_76():
+    return [
+    (0x2F8C3, 'M', u'摩'),
+    (0x2F8C4, 'M', u'摾'),
+    (0x2F8C5, 'M', u'撝'),
+    (0x2F8C6, 'M', u'摷'),
+    (0x2F8C7, 'M', u'㩬'),
+    (0x2F8C8, 'M', u'敏'),
+    (0x2F8C9, 'M', u'敬'),
+    (0x2F8CA, 'M', u'𣀊'),
+    (0x2F8CB, 'M', u'旣'),
+    (0x2F8CC, 'M', u'書'),
+    (0x2F8CD, 'M', u'晉'),
+    (0x2F8CE, 'M', u'㬙'),
+    (0x2F8CF, 'M', u'暑'),
+    (0x2F8D0, 'M', u'㬈'),
+    (0x2F8D1, 'M', u'㫤'),
+    (0x2F8D2, 'M', u'冒'),
+    (0x2F8D3, 'M', u'冕'),
+    (0x2F8D4, 'M', u'最'),
+    (0x2F8D5, 'M', u'暜'),
+    (0x2F8D6, 'M', u'肭'),
+    (0x2F8D7, 'M', u'䏙'),
+    (0x2F8D8, 'M', u'朗'),
+    (0x2F8D9, 'M', u'望'),
+    (0x2F8DA, 'M', u'朡'),
+    (0x2F8DB, 'M', u'杞'),
+    (0x2F8DC, 'M', u'杓'),
+    (0x2F8DD, 'M', u'𣏃'),
+    (0x2F8DE, 'M', u'㭉'),
+    (0x2F8DF, 'M', u'柺'),
+    (0x2F8E0, 'M', u'枅'),
+    (0x2F8E1, 'M', u'桒'),
+    (0x2F8E2, 'M', u'梅'),
+    (0x2F8E3, 'M', u'𣑭'),
+    (0x2F8E4, 'M', u'梎'),
+    (0x2F8E5, 'M', u'栟'),
+    (0x2F8E6, 'M', u'椔'),
+    (0x2F8E7, 'M', u'㮝'),
+    (0x2F8E8, 'M', u'楂'),
+    (0x2F8E9, 'M', u'榣'),
+    (0x2F8EA, 'M', u'槪'),
+    (0x2F8EB, 'M', u'檨'),
+    (0x2F8EC, 'M', u'𣚣'),
+    (0x2F8ED, 'M', u'櫛'),
+    (0x2F8EE, 'M', u'㰘'),
+    (0x2F8EF, 'M', u'次'),
+    (0x2F8F0, 'M', u'𣢧'),
+    (0x2F8F1, 'M', u'歔'),
+    (0x2F8F2, 'M', u'㱎'),
+    (0x2F8F3, 'M', u'歲'),
+    (0x2F8F4, 'M', u'殟'),
+    (0x2F8F5, 'M', u'殺'),
+    (0x2F8F6, 'M', u'殻'),
+    (0x2F8F7, 'M', u'𣪍'),
+    (0x2F8F8, 'M', u'𡴋'),
+    (0x2F8F9, 'M', u'𣫺'),
+    (0x2F8FA, 'M', u'汎'),
+    (0x2F8FB, 'M', u'𣲼'),
+    (0x2F8FC, 'M', u'沿'),
+    (0x2F8FD, 'M', u'泍'),
+    (0x2F8FE, 'M', u'汧'),
+    (0x2F8FF, 'M', u'洖'),
+    (0x2F900, 'M', u'派'),
+    (0x2F901, 'M', u'海'),
+    (0x2F902, 'M', u'流'),
+    (0x2F903, 'M', u'浩'),
+    (0x2F904, 'M', u'浸'),
+    (0x2F905, 'M', u'涅'),
+    (0x2F906, 'M', u'𣴞'),
+    (0x2F907, 'M', u'洴'),
+    (0x2F908, 'M', u'港'),
+    (0x2F909, 'M', u'湮'),
+    (0x2F90A, 'M', u'㴳'),
+    (0x2F90B, 'M', u'滋'),
+    (0x2F90C, 'M', u'滇'),
+    (0x2F90D, 'M', u'𣻑'),
+    (0x2F90E, 'M', u'淹'),
+    (0x2F90F, 'M', u'潮'),
+    (0x2F910, 'M', u'𣽞'),
+    (0x2F911, 'M', u'𣾎'),
+    (0x2F912, 'M', u'濆'),
+    (0x2F913, 'M', u'瀹'),
+    (0x2F914, 'M', u'瀞'),
+    (0x2F915, 'M', u'瀛'),
+    (0x2F916, 'M', u'㶖'),
+    (0x2F917, 'M', u'灊'),
+    (0x2F918, 'M', u'災'),
+    (0x2F919, 'M', u'灷'),
+    (0x2F91A, 'M', u'炭'),
+    (0x2F91B, 'M', u'𠔥'),
+    (0x2F91C, 'M', u'煅'),
+    (0x2F91D, 'M', u'𤉣'),
+    (0x2F91E, 'M', u'熜'),
+    (0x2F91F, 'X'),
+    (0x2F920, 'M', u'爨'),
+    (0x2F921, 'M', u'爵'),
+    (0x2F922, 'M', u'牐'),
+    (0x2F923, 'M', u'𤘈'),
+    (0x2F924, 'M', u'犀'),
+    (0x2F925, 'M', u'犕'),
+    (0x2F926, 'M', u'𤜵'),
+    ]
+
+def _seg_77():
+    return [
+    (0x2F927, 'M', u'𤠔'),
+    (0x2F928, 'M', u'獺'),
+    (0x2F929, 'M', u'王'),
+    (0x2F92A, 'M', u'㺬'),
+    (0x2F92B, 'M', u'玥'),
+    (0x2F92C, 'M', u'㺸'),
+    (0x2F92E, 'M', u'瑇'),
+    (0x2F92F, 'M', u'瑜'),
+    (0x2F930, 'M', u'瑱'),
+    (0x2F931, 'M', u'璅'),
+    (0x2F932, 'M', u'瓊'),
+    (0x2F933, 'M', u'㼛'),
+    (0x2F934, 'M', u'甤'),
+    (0x2F935, 'M', u'𤰶'),
+    (0x2F936, 'M', u'甾'),
+    (0x2F937, 'M', u'𤲒'),
+    (0x2F938, 'M', u'異'),
+    (0x2F939, 'M', u'𢆟'),
+    (0x2F93A, 'M', u'瘐'),
+    (0x2F93B, 'M', u'𤾡'),
+    (0x2F93C, 'M', u'𤾸'),
+    (0x2F93D, 'M', u'𥁄'),
+    (0x2F93E, 'M', u'㿼'),
+    (0x2F93F, 'M', u'䀈'),
+    (0x2F940, 'M', u'直'),
+    (0x2F941, 'M', u'𥃳'),
+    (0x2F942, 'M', u'𥃲'),
+    (0x2F943, 'M', u'𥄙'),
+    (0x2F944, 'M', u'𥄳'),
+    (0x2F945, 'M', u'眞'),
+    (0x2F946, 'M', u'真'),
+    (0x2F948, 'M', u'睊'),
+    (0x2F949, 'M', u'䀹'),
+    (0x2F94A, 'M', u'瞋'),
+    (0x2F94B, 'M', u'䁆'),
+    (0x2F94C, 'M', u'䂖'),
+    (0x2F94D, 'M', u'𥐝'),
+    (0x2F94E, 'M', u'硎'),
+    (0x2F94F, 'M', u'碌'),
+    (0x2F950, 'M', u'磌'),
+    (0x2F951, 'M', u'䃣'),
+    (0x2F952, 'M', u'𥘦'),
+    (0x2F953, 'M', u'祖'),
+    (0x2F954, 'M', u'𥚚'),
+    (0x2F955, 'M', u'𥛅'),
+    (0x2F956, 'M', u'福'),
+    (0x2F957, 'M', u'秫'),
+    (0x2F958, 'M', u'䄯'),
+    (0x2F959, 'M', u'穀'),
+    (0x2F95A, 'M', u'穊'),
+    (0x2F95B, 'M', u'穏'),
+    (0x2F95C, 'M', u'𥥼'),
+    (0x2F95D, 'M', u'𥪧'),
+    (0x2F95F, 'X'),
+    (0x2F960, 'M', u'䈂'),
+    (0x2F961, 'M', u'𥮫'),
+    (0x2F962, 'M', u'篆'),
+    (0x2F963, 'M', u'築'),
+    (0x2F964, 'M', u'䈧'),
+    (0x2F965, 'M', u'𥲀'),
+    (0x2F966, 'M', u'糒'),
+    (0x2F967, 'M', u'䊠'),
+    (0x2F968, 'M', u'糨'),
+    (0x2F969, 'M', u'糣'),
+    (0x2F96A, 'M', u'紀'),
+    (0x2F96B, 'M', u'𥾆'),
+    (0x2F96C, 'M', u'絣'),
+    (0x2F96D, 'M', u'䌁'),
+    (0x2F96E, 'M', u'緇'),
+    (0x2F96F, 'M', u'縂'),
+    (0x2F970, 'M', u'繅'),
+    (0x2F971, 'M', u'䌴'),
+    (0x2F972, 'M', u'𦈨'),
+    (0x2F973, 'M', u'𦉇'),
+    (0x2F974, 'M', u'䍙'),
+    (0x2F975, 'M', u'𦋙'),
+    (0x2F976, 'M', u'罺'),
+    (0x2F977, 'M', u'𦌾'),
+    (0x2F978, 'M', u'羕'),
+    (0x2F979, 'M', u'翺'),
+    (0x2F97A, 'M', u'者'),
+    (0x2F97B, 'M', u'𦓚'),
+    (0x2F97C, 'M', u'𦔣'),
+    (0x2F97D, 'M', u'聠'),
+    (0x2F97E, 'M', u'𦖨'),
+    (0x2F97F, 'M', u'聰'),
+    (0x2F980, 'M', u'𣍟'),
+    (0x2F981, 'M', u'䏕'),
+    (0x2F982, 'M', u'育'),
+    (0x2F983, 'M', u'脃'),
+    (0x2F984, 'M', u'䐋'),
+    (0x2F985, 'M', u'脾'),
+    (0x2F986, 'M', u'媵'),
+    (0x2F987, 'M', u'𦞧'),
+    (0x2F988, 'M', u'𦞵'),
+    (0x2F989, 'M', u'𣎓'),
+    (0x2F98A, 'M', u'𣎜'),
+    (0x2F98B, 'M', u'舁'),
+    (0x2F98C, 'M', u'舄'),
+    (0x2F98D, 'M', u'辞'),
+    ]
+
+def _seg_78():
+    return [
+    (0x2F98E, 'M', u'䑫'),
+    (0x2F98F, 'M', u'芑'),
+    (0x2F990, 'M', u'芋'),
+    (0x2F991, 'M', u'芝'),
+    (0x2F992, 'M', u'劳'),
+    (0x2F993, 'M', u'花'),
+    (0x2F994, 'M', u'芳'),
+    (0x2F995, 'M', u'芽'),
+    (0x2F996, 'M', u'苦'),
+    (0x2F997, 'M', u'𦬼'),
+    (0x2F998, 'M', u'若'),
+    (0x2F999, 'M', u'茝'),
+    (0x2F99A, 'M', u'荣'),
+    (0x2F99B, 'M', u'莭'),
+    (0x2F99C, 'M', u'茣'),
+    (0x2F99D, 'M', u'莽'),
+    (0x2F99E, 'M', u'菧'),
+    (0x2F99F, 'M', u'著'),
+    (0x2F9A0, 'M', u'荓'),
+    (0x2F9A1, 'M', u'菊'),
+    (0x2F9A2, 'M', u'菌'),
+    (0x2F9A3, 'M', u'菜'),
+    (0x2F9A4, 'M', u'𦰶'),
+    (0x2F9A5, 'M', u'𦵫'),
+    (0x2F9A6, 'M', u'𦳕'),
+    (0x2F9A7, 'M', u'䔫'),
+    (0x2F9A8, 'M', u'蓱'),
+    (0x2F9A9, 'M', u'蓳'),
+    (0x2F9AA, 'M', u'蔖'),
+    (0x2F9AB, 'M', u'𧏊'),
+    (0x2F9AC, 'M', u'蕤'),
+    (0x2F9AD, 'M', u'𦼬'),
+    (0x2F9AE, 'M', u'䕝'),
+    (0x2F9AF, 'M', u'䕡'),
+    (0x2F9B0, 'M', u'𦾱'),
+    (0x2F9B1, 'M', u'𧃒'),
+    (0x2F9B2, 'M', u'䕫'),
+    (0x2F9B3, 'M', u'虐'),
+    (0x2F9B4, 'M', u'虜'),
+    (0x2F9B5, 'M', u'虧'),
+    (0x2F9B6, 'M', u'虩'),
+    (0x2F9B7, 'M', u'蚩'),
+    (0x2F9B8, 'M', u'蚈'),
+    (0x2F9B9, 'M', u'蜎'),
+    (0x2F9BA, 'M', u'蛢'),
+    (0x2F9BB, 'M', u'蝹'),
+    (0x2F9BC, 'M', u'蜨'),
+    (0x2F9BD, 'M', u'蝫'),
+    (0x2F9BE, 'M', u'螆'),
+    (0x2F9BF, 'X'),
+    (0x2F9C0, 'M', u'蟡'),
+    (0x2F9C1, 'M', u'蠁'),
+    (0x2F9C2, 'M', u'䗹'),
+    (0x2F9C3, 'M', u'衠'),
+    (0x2F9C4, 'M', u'衣'),
+    (0x2F9C5, 'M', u'𧙧'),
+    (0x2F9C6, 'M', u'裗'),
+    (0x2F9C7, 'M', u'裞'),
+    (0x2F9C8, 'M', u'䘵'),
+    (0x2F9C9, 'M', u'裺'),
+    (0x2F9CA, 'M', u'㒻'),
+    (0x2F9CB, 'M', u'𧢮'),
+    (0x2F9CC, 'M', u'𧥦'),
+    (0x2F9CD, 'M', u'䚾'),
+    (0x2F9CE, 'M', u'䛇'),
+    (0x2F9CF, 'M', u'誠'),
+    (0x2F9D0, 'M', u'諭'),
+    (0x2F9D1, 'M', u'變'),
+    (0x2F9D2, 'M', u'豕'),
+    (0x2F9D3, 'M', u'𧲨'),
+    (0x2F9D4, 'M', u'貫'),
+    (0x2F9D5, 'M', u'賁'),
+    (0x2F9D6, 'M', u'贛'),
+    (0x2F9D7, 'M', u'起'),
+    (0x2F9D8, 'M', u'𧼯'),
+    (0x2F9D9, 'M', u'𠠄'),
+    (0x2F9DA, 'M', u'跋'),
+    (0x2F9DB, 'M', u'趼'),
+    (0x2F9DC, 'M', u'跰'),
+    (0x2F9DD, 'M', u'𠣞'),
+    (0x2F9DE, 'M', u'軔'),
+    (0x2F9DF, 'M', u'輸'),
+    (0x2F9E0, 'M', u'𨗒'),
+    (0x2F9E1, 'M', u'𨗭'),
+    (0x2F9E2, 'M', u'邔'),
+    (0x2F9E3, 'M', u'郱'),
+    (0x2F9E4, 'M', u'鄑'),
+    (0x2F9E5, 'M', u'𨜮'),
+    (0x2F9E6, 'M', u'鄛'),
+    (0x2F9E7, 'M', u'鈸'),
+    (0x2F9E8, 'M', u'鋗'),
+    (0x2F9E9, 'M', u'鋘'),
+    (0x2F9EA, 'M', u'鉼'),
+    (0x2F9EB, 'M', u'鏹'),
+    (0x2F9EC, 'M', u'鐕'),
+    (0x2F9ED, 'M', u'𨯺'),
+    (0x2F9EE, 'M', u'開'),
+    (0x2F9EF, 'M', u'䦕'),
+    (0x2F9F0, 'M', u'閷'),
+    (0x2F9F1, 'M', u'𨵷'),
+    ]
+
+def _seg_79():
+    return [
+    (0x2F9F2, 'M', u'䧦'),
+    (0x2F9F3, 'M', u'雃'),
+    (0x2F9F4, 'M', u'嶲'),
+    (0x2F9F5, 'M', u'霣'),
+    (0x2F9F6, 'M', u'𩅅'),
+    (0x2F9F7, 'M', u'𩈚'),
+    (0x2F9F8, 'M', u'䩮'),
+    (0x2F9F9, 'M', u'䩶'),
+    (0x2F9FA, 'M', u'韠'),
+    (0x2F9FB, 'M', u'𩐊'),
+    (0x2F9FC, 'M', u'䪲'),
+    (0x2F9FD, 'M', u'𩒖'),
+    (0x2F9FE, 'M', u'頋'),
+    (0x2FA00, 'M', u'頩'),
+    (0x2FA01, 'M', u'𩖶'),
+    (0x2FA02, 'M', u'飢'),
+    (0x2FA03, 'M', u'䬳'),
+    (0x2FA04, 'M', u'餩'),
+    (0x2FA05, 'M', u'馧'),
+    (0x2FA06, 'M', u'駂'),
+    (0x2FA07, 'M', u'駾'),
+    (0x2FA08, 'M', u'䯎'),
+    (0x2FA09, 'M', u'𩬰'),
+    (0x2FA0A, 'M', u'鬒'),
+    (0x2FA0B, 'M', u'鱀'),
+    (0x2FA0C, 'M', u'鳽'),
+    (0x2FA0D, 'M', u'䳎'),
+    (0x2FA0E, 'M', u'䳭'),
+    (0x2FA0F, 'M', u'鵧'),
+    (0x2FA10, 'M', u'𪃎'),
+    (0x2FA11, 'M', u'䳸'),
+    (0x2FA12, 'M', u'𪄅'),
+    (0x2FA13, 'M', u'𪈎'),
+    (0x2FA14, 'M', u'𪊑'),
+    (0x2FA15, 'M', u'麻'),
+    (0x2FA16, 'M', u'䵖'),
+    (0x2FA17, 'M', u'黹'),
+    (0x2FA18, 'M', u'黾'),
+    (0x2FA19, 'M', u'鼅'),
+    (0x2FA1A, 'M', u'鼏'),
+    (0x2FA1B, 'M', u'鼖'),
+    (0x2FA1C, 'M', u'鼻'),
+    (0x2FA1D, 'M', u'𪘀'),
+    (0x2FA1E, 'X'),
+    (0x30000, 'V'),
+    (0x3134B, 'X'),
+    (0xE0100, 'I'),
+    (0xE01F0, 'X'),
+    ]
+
+uts46data = tuple(
+    _seg_0()
+    + _seg_1()
+    + _seg_2()
+    + _seg_3()
+    + _seg_4()
+    + _seg_5()
+    + _seg_6()
+    + _seg_7()
+    + _seg_8()
+    + _seg_9()
+    + _seg_10()
+    + _seg_11()
+    + _seg_12()
+    + _seg_13()
+    + _seg_14()
+    + _seg_15()
+    + _seg_16()
+    + _seg_17()
+    + _seg_18()
+    + _seg_19()
+    + _seg_20()
+    + _seg_21()
+    + _seg_22()
+    + _seg_23()
+    + _seg_24()
+    + _seg_25()
+    + _seg_26()
+    + _seg_27()
+    + _seg_28()
+    + _seg_29()
+    + _seg_30()
+    + _seg_31()
+    + _seg_32()
+    + _seg_33()
+    + _seg_34()
+    + _seg_35()
+    + _seg_36()
+    + _seg_37()
+    + _seg_38()
+    + _seg_39()
+    + _seg_40()
+    + _seg_41()
+    + _seg_42()
+    + _seg_43()
+    + _seg_44()
+    + _seg_45()
+    + _seg_46()
+    + _seg_47()
+    + _seg_48()
+    + _seg_49()
+    + _seg_50()
+    + _seg_51()
+    + _seg_52()
+    + _seg_53()
+    + _seg_54()
+    + _seg_55()
+    + _seg_56()
+    + _seg_57()
+    + _seg_58()
+    + _seg_59()
+    + _seg_60()
+    + _seg_61()
+    + _seg_62()
+    + _seg_63()
+    + _seg_64()
+    + _seg_65()
+    + _seg_66()
+    + _seg_67()
+    + _seg_68()
+    + _seg_69()
+    + _seg_70()
+    + _seg_71()
+    + _seg_72()
+    + _seg_73()
+    + _seg_74()
+    + _seg_75()
+    + _seg_76()
+    + _seg_77()
+    + _seg_78()
+    + _seg_79()
+)
diff --git a/openpype/vendor/python/python_2/requests/__init__.py b/openpype/vendor/python/python_2/requests/__init__.py
new file mode 100644
index 0000000000..53a5b42af6
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/__init__.py
@@ -0,0 +1,152 @@
+# -*- coding: utf-8 -*-
+
+#   __
+#  /__)  _  _     _   _ _/   _
+# / (   (- (/ (/ (- _)  /  _)
+#          /
+
+"""
+Requests HTTP Library
+~~~~~~~~~~~~~~~~~~~~~
+
+Requests is an HTTP library, written in Python, for human beings.
+Basic GET usage:
+
+   >>> import requests
+   >>> r = requests.get('https://www.python.org')
+   >>> r.status_code
+   200
+   >>> b'Python is a programming language' in r.content
+   True
+
+... or POST:
+
+   >>> payload = dict(key1='value1', key2='value2')
+   >>> r = requests.post('https://httpbin.org/post', data=payload)
+   >>> print(r.text)
+   {
+     ...
+     "form": {
+       "key1": "value1",
+       "key2": "value2"
+     },
+     ...
+   }
+
+The other HTTP methods are supported - see `requests.api`. Full documentation
+is at <https://requests.readthedocs.io>.
+
+:copyright: (c) 2017 by Kenneth Reitz.
+:license: Apache 2.0, see LICENSE for more details.
+"""
+
+import urllib3
+import warnings
+from .exceptions import RequestsDependencyWarning
+
+try:
+    from charset_normalizer import __version__ as charset_normalizer_version
+except ImportError:
+    charset_normalizer_version = None
+
+try:
+    from chardet import __version__ as chardet_version
+except ImportError:
+    chardet_version = None
+
+def check_compatibility(urllib3_version, chardet_version, charset_normalizer_version):
+    urllib3_version = urllib3_version.split('.')
+    assert urllib3_version != ['dev']  # Verify urllib3 isn't installed from git.
+
+    # Sometimes, urllib3 only reports its version as 16.1.
+    if len(urllib3_version) == 2:
+        urllib3_version.append('0')
+
+    # Check urllib3 for compatibility.
+    major, minor, patch = urllib3_version  # noqa: F811
+    major, minor, patch = int(major), int(minor), int(patch)
+    # urllib3 >= 1.21.1, <= 1.26
+    assert major == 1
+    assert minor >= 21
+    assert minor <= 26
+
+    # Check charset_normalizer for compatibility.
+    if chardet_version:
+        major, minor, patch = chardet_version.split('.')[:3]
+        major, minor, patch = int(major), int(minor), int(patch)
+        # chardet_version >= 3.0.2, < 5.0.0
+        assert (3, 0, 2) <= (major, minor, patch) < (5, 0, 0)
+    elif charset_normalizer_version:
+        major, minor, patch = charset_normalizer_version.split('.')[:3]
+        major, minor, patch = int(major), int(minor), int(patch)
+        # charset_normalizer >= 2.0.0 < 3.0.0
+        assert (2, 0, 0) <= (major, minor, patch) < (3, 0, 0)
+    else:
+        raise Exception("You need either charset_normalizer or chardet installed")
+
+def _check_cryptography(cryptography_version):
+    # cryptography < 1.3.4
+    try:
+        cryptography_version = list(map(int, cryptography_version.split('.')))
+    except ValueError:
+        return
+
+    if cryptography_version < [1, 3, 4]:
+        warning = 'Old version of cryptography ({}) may cause slowdown.'.format(cryptography_version)
+        warnings.warn(warning, RequestsDependencyWarning)
+
+# Check imported dependencies for compatibility.
+try:
+    check_compatibility(urllib3.__version__, chardet_version, charset_normalizer_version)
+except (AssertionError, ValueError):
+    warnings.warn("urllib3 ({}) or chardet ({})/charset_normalizer ({}) doesn't match a supported "
+                  "version!".format(urllib3.__version__, chardet_version, charset_normalizer_version),
+                  RequestsDependencyWarning)
+
+# Attempt to enable urllib3's fallback for SNI support
+# if the standard library doesn't support SNI or the
+# 'ssl' library isn't available.
+try:
+    try:
+        import ssl
+    except ImportError:
+        ssl = None
+
+    if not getattr(ssl, "HAS_SNI", False):
+        from urllib3.contrib import pyopenssl
+        pyopenssl.inject_into_urllib3()
+
+        # Check cryptography version
+        from cryptography import __version__ as cryptography_version
+        _check_cryptography(cryptography_version)
+except ImportError:
+    pass
+
+# urllib3's DependencyWarnings should be silenced.
+from urllib3.exceptions import DependencyWarning
+warnings.simplefilter('ignore', DependencyWarning)
+
+from .__version__ import __title__, __description__, __url__, __version__
+from .__version__ import __build__, __author__, __author_email__, __license__
+from .__version__ import __copyright__, __cake__
+
+from . import utils
+from . import packages
+from .models import Request, Response, PreparedRequest
+from .api import request, get, head, post, patch, put, delete, options
+from .sessions import session, Session
+from .status_codes import codes
+from .exceptions import (
+    RequestException, Timeout, URLRequired,
+    TooManyRedirects, HTTPError, ConnectionError,
+    FileModeWarning, ConnectTimeout, ReadTimeout, JSONDecodeError
+)
+
+# Set default logging handler to avoid "No handler found" warnings.
+import logging
+from logging import NullHandler
+
+logging.getLogger(__name__).addHandler(NullHandler())
+
+# FileModeWarnings go off per the default.
+warnings.simplefilter('default', FileModeWarning, append=True)
diff --git a/openpype/vendor/python/python_2/requests/__version__.py b/openpype/vendor/python/python_2/requests/__version__.py
new file mode 100644
index 0000000000..e973b03b5f
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/__version__.py
@@ -0,0 +1,14 @@
+# .-. .-. .-. . . .-. .-. .-. .-.
+# |(  |-  |.| | | |-  `-.  |  `-.
+# ' ' `-' `-`.`-' `-' `-'  '  `-'
+
+__title__ = 'requests'
+__description__ = 'Python HTTP for Humans.'
+__url__ = 'https://requests.readthedocs.io'
+__version__ = '2.27.1'
+__build__ = 0x022701
+__author__ = 'Kenneth Reitz'
+__author_email__ = 'me@kennethreitz.org'
+__license__ = 'Apache 2.0'
+__copyright__ = 'Copyright 2022 Kenneth Reitz'
+__cake__ = u'\u2728 \U0001f370 \u2728'
diff --git a/openpype/vendor/python/python_2/requests/_internal_utils.py b/openpype/vendor/python/python_2/requests/_internal_utils.py
new file mode 100644
index 0000000000..759d9a56ba
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/_internal_utils.py
@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests._internal_utils
+~~~~~~~~~~~~~~
+
+Provides utility functions that are consumed internally by Requests
+which depend on extremely few external helpers (such as compat)
+"""
+
+from .compat import is_py2, builtin_str, str
+
+
+def to_native_string(string, encoding='ascii'):
+    """Given a string object, regardless of type, returns a representation of
+    that string in the native string type, encoding and decoding where
+    necessary. This assumes ASCII unless told otherwise.
+    """
+    if isinstance(string, builtin_str):
+        out = string
+    else:
+        if is_py2:
+            out = string.encode(encoding)
+        else:
+            out = string.decode(encoding)
+
+    return out
+
+
+def unicode_is_ascii(u_string):
+    """Determine if unicode string only contains ASCII characters.
+
+    :param str u_string: unicode string to check. Must be unicode
+        and not Python 2 `str`.
+    :rtype: bool
+    """
+    assert isinstance(u_string, str)
+    try:
+        u_string.encode('ascii')
+        return True
+    except UnicodeEncodeError:
+        return False
diff --git a/openpype/vendor/python/python_2/requests/adapters.py b/openpype/vendor/python/python_2/requests/adapters.py
new file mode 100644
index 0000000000..fe22ff450e
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/adapters.py
@@ -0,0 +1,538 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.adapters
+~~~~~~~~~~~~~~~~~
+
+This module contains the transport adapters that Requests uses to define
+and maintain connections.
+"""
+
+import os.path
+import socket
+
+from urllib3.poolmanager import PoolManager, proxy_from_url
+from urllib3.response import HTTPResponse
+from urllib3.util import parse_url
+from urllib3.util import Timeout as TimeoutSauce
+from urllib3.util.retry import Retry
+from urllib3.exceptions import ClosedPoolError
+from urllib3.exceptions import ConnectTimeoutError
+from urllib3.exceptions import HTTPError as _HTTPError
+from urllib3.exceptions import InvalidHeader as _InvalidHeader
+from urllib3.exceptions import MaxRetryError
+from urllib3.exceptions import NewConnectionError
+from urllib3.exceptions import ProxyError as _ProxyError
+from urllib3.exceptions import ProtocolError
+from urllib3.exceptions import ReadTimeoutError
+from urllib3.exceptions import SSLError as _SSLError
+from urllib3.exceptions import ResponseError
+from urllib3.exceptions import LocationValueError
+
+from .models import Response
+from .compat import urlparse, basestring
+from .utils import (DEFAULT_CA_BUNDLE_PATH, extract_zipped_paths,
+                    get_encoding_from_headers, prepend_scheme_if_needed,
+                    get_auth_from_url, urldefragauth, select_proxy)
+from .structures import CaseInsensitiveDict
+from .cookies import extract_cookies_to_jar
+from .exceptions import (ConnectionError, ConnectTimeout, ReadTimeout, SSLError,
+                         ProxyError, RetryError, InvalidSchema, InvalidProxyURL,
+                         InvalidURL, InvalidHeader)
+from .auth import _basic_auth_str
+
+try:
+    from urllib3.contrib.socks import SOCKSProxyManager
+except ImportError:
+    def SOCKSProxyManager(*args, **kwargs):
+        raise InvalidSchema("Missing dependencies for SOCKS support.")
+
+DEFAULT_POOLBLOCK = False
+DEFAULT_POOLSIZE = 10
+DEFAULT_RETRIES = 0
+DEFAULT_POOL_TIMEOUT = None
+
+
+class BaseAdapter(object):
+    """The Base Transport Adapter"""
+
+    def __init__(self):
+        super(BaseAdapter, self).__init__()
+
+    def send(self, request, stream=False, timeout=None, verify=True,
+             cert=None, proxies=None):
+        """Sends PreparedRequest object. Returns Response object.
+
+        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
+        :param stream: (optional) Whether to stream the request content.
+        :param timeout: (optional) How long to wait for the server to send
+            data before giving up, as a float, or a :ref:`(connect timeout,
+            read timeout) <timeouts>` tuple.
+        :type timeout: float or tuple
+        :param verify: (optional) Either a boolean, in which case it controls whether we verify
+            the server's TLS certificate, or a string, in which case it must be a path
+            to a CA bundle to use
+        :param cert: (optional) Any user-provided SSL certificate to be trusted.
+        :param proxies: (optional) The proxies dictionary to apply to the request.
+        """
+        raise NotImplementedError
+
+    def close(self):
+        """Cleans up adapter specific items."""
+        raise NotImplementedError
+
+
+class HTTPAdapter(BaseAdapter):
+    """The built-in HTTP Adapter for urllib3.
+
+    Provides a general-case interface for Requests sessions to contact HTTP and
+    HTTPS urls by implementing the Transport Adapter interface. This class will
+    usually be created by the :class:`Session <Session>` class under the
+    covers.
+
+    :param pool_connections: The number of urllib3 connection pools to cache.
+    :param pool_maxsize: The maximum number of connections to save in the pool.
+    :param max_retries: The maximum number of retries each connection
+        should attempt. Note, this applies only to failed DNS lookups, socket
+        connections and connection timeouts, never to requests where data has
+        made it to the server. By default, Requests does not retry failed
+        connections. If you need granular control over the conditions under
+        which we retry a request, import urllib3's ``Retry`` class and pass
+        that instead.
+    :param pool_block: Whether the connection pool should block for connections.
+
+    Usage::
+
+      >>> import requests
+      >>> s = requests.Session()
+      >>> a = requests.adapters.HTTPAdapter(max_retries=3)
+      >>> s.mount('http://', a)
+    """
+    __attrs__ = ['max_retries', 'config', '_pool_connections', '_pool_maxsize',
+                 '_pool_block']
+
+    def __init__(self, pool_connections=DEFAULT_POOLSIZE,
+                 pool_maxsize=DEFAULT_POOLSIZE, max_retries=DEFAULT_RETRIES,
+                 pool_block=DEFAULT_POOLBLOCK):
+        if max_retries == DEFAULT_RETRIES:
+            self.max_retries = Retry(0, read=False)
+        else:
+            self.max_retries = Retry.from_int(max_retries)
+        self.config = {}
+        self.proxy_manager = {}
+
+        super(HTTPAdapter, self).__init__()
+
+        self._pool_connections = pool_connections
+        self._pool_maxsize = pool_maxsize
+        self._pool_block = pool_block
+
+        self.init_poolmanager(pool_connections, pool_maxsize, block=pool_block)
+
+    def __getstate__(self):
+        return {attr: getattr(self, attr, None) for attr in self.__attrs__}
+
+    def __setstate__(self, state):
+        # Can't handle by adding 'proxy_manager' to self.__attrs__ because
+        # self.poolmanager uses a lambda function, which isn't pickleable.
+        self.proxy_manager = {}
+        self.config = {}
+
+        for attr, value in state.items():
+            setattr(self, attr, value)
+
+        self.init_poolmanager(self._pool_connections, self._pool_maxsize,
+                              block=self._pool_block)
+
+    def init_poolmanager(self, connections, maxsize, block=DEFAULT_POOLBLOCK, **pool_kwargs):
+        """Initializes a urllib3 PoolManager.
+
+        This method should not be called from user code, and is only
+        exposed for use when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param connections: The number of urllib3 connection pools to cache.
+        :param maxsize: The maximum number of connections to save in the pool.
+        :param block: Block when no free connections are available.
+        :param pool_kwargs: Extra keyword arguments used to initialize the Pool Manager.
+        """
+        # save these values for pickling
+        self._pool_connections = connections
+        self._pool_maxsize = maxsize
+        self._pool_block = block
+
+        self.poolmanager = PoolManager(num_pools=connections, maxsize=maxsize,
+                                       block=block, strict=True, **pool_kwargs)
+
+    def proxy_manager_for(self, proxy, **proxy_kwargs):
+        """Return urllib3 ProxyManager for the given proxy.
+
+        This method should not be called from user code, and is only
+        exposed for use when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param proxy: The proxy to return a urllib3 ProxyManager for.
+        :param proxy_kwargs: Extra keyword arguments used to configure the Proxy Manager.
+        :returns: ProxyManager
+        :rtype: urllib3.ProxyManager
+        """
+        if proxy in self.proxy_manager:
+            manager = self.proxy_manager[proxy]
+        elif proxy.lower().startswith('socks'):
+            username, password = get_auth_from_url(proxy)
+            manager = self.proxy_manager[proxy] = SOCKSProxyManager(
+                proxy,
+                username=username,
+                password=password,
+                num_pools=self._pool_connections,
+                maxsize=self._pool_maxsize,
+                block=self._pool_block,
+                **proxy_kwargs
+            )
+        else:
+            proxy_headers = self.proxy_headers(proxy)
+            manager = self.proxy_manager[proxy] = proxy_from_url(
+                proxy,
+                proxy_headers=proxy_headers,
+                num_pools=self._pool_connections,
+                maxsize=self._pool_maxsize,
+                block=self._pool_block,
+                **proxy_kwargs)
+
+        return manager
+
+    def cert_verify(self, conn, url, verify, cert):
+        """Verify a SSL certificate. This method should not be called from user
+        code, and is only exposed for use when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param conn: The urllib3 connection object associated with the cert.
+        :param url: The requested URL.
+        :param verify: Either a boolean, in which case it controls whether we verify
+            the server's TLS certificate, or a string, in which case it must be a path
+            to a CA bundle to use
+        :param cert: The SSL certificate to verify.
+        """
+        if url.lower().startswith('https') and verify:
+
+            cert_loc = None
+
+            # Allow self-specified cert location.
+            if verify is not True:
+                cert_loc = verify
+
+            if not cert_loc:
+                cert_loc = extract_zipped_paths(DEFAULT_CA_BUNDLE_PATH)
+
+            if not cert_loc or not os.path.exists(cert_loc):
+                raise IOError("Could not find a suitable TLS CA certificate bundle, "
+                              "invalid path: {}".format(cert_loc))
+
+            conn.cert_reqs = 'CERT_REQUIRED'
+
+            if not os.path.isdir(cert_loc):
+                conn.ca_certs = cert_loc
+            else:
+                conn.ca_cert_dir = cert_loc
+        else:
+            conn.cert_reqs = 'CERT_NONE'
+            conn.ca_certs = None
+            conn.ca_cert_dir = None
+
+        if cert:
+            if not isinstance(cert, basestring):
+                conn.cert_file = cert[0]
+                conn.key_file = cert[1]
+            else:
+                conn.cert_file = cert
+                conn.key_file = None
+            if conn.cert_file and not os.path.exists(conn.cert_file):
+                raise IOError("Could not find the TLS certificate file, "
+                              "invalid path: {}".format(conn.cert_file))
+            if conn.key_file and not os.path.exists(conn.key_file):
+                raise IOError("Could not find the TLS key file, "
+                              "invalid path: {}".format(conn.key_file))
+
+    def build_response(self, req, resp):
+        """Builds a :class:`Response <requests.Response>` object from a urllib3
+        response. This should not be called from user code, and is only exposed
+        for use when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`
+
+        :param req: The :class:`PreparedRequest <PreparedRequest>` used to generate the response.
+        :param resp: The urllib3 response object.
+        :rtype: requests.Response
+        """
+        response = Response()
+
+        # Fallback to None if there's no status_code, for whatever reason.
+        response.status_code = getattr(resp, 'status', None)
+
+        # Make headers case-insensitive.
+        response.headers = CaseInsensitiveDict(getattr(resp, 'headers', {}))
+
+        # Set encoding.
+        response.encoding = get_encoding_from_headers(response.headers)
+        response.raw = resp
+        response.reason = response.raw.reason
+
+        if isinstance(req.url, bytes):
+            response.url = req.url.decode('utf-8')
+        else:
+            response.url = req.url
+
+        # Add new cookies from the server.
+        extract_cookies_to_jar(response.cookies, req, resp)
+
+        # Give the Response some context.
+        response.request = req
+        response.connection = self
+
+        return response
+
+    def get_connection(self, url, proxies=None):
+        """Returns a urllib3 connection for the given URL. This should not be
+        called from user code, and is only exposed for use when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param url: The URL to connect to.
+        :param proxies: (optional) A Requests-style dictionary of proxies used on this request.
+        :rtype: urllib3.ConnectionPool
+        """
+        proxy = select_proxy(url, proxies)
+
+        if proxy:
+            proxy = prepend_scheme_if_needed(proxy, 'http')
+            proxy_url = parse_url(proxy)
+            if not proxy_url.host:
+                raise InvalidProxyURL("Please check proxy URL. It is malformed"
+                                      " and could be missing the host.")
+            proxy_manager = self.proxy_manager_for(proxy)
+            conn = proxy_manager.connection_from_url(url)
+        else:
+            # Only scheme should be lower case
+            parsed = urlparse(url)
+            url = parsed.geturl()
+            conn = self.poolmanager.connection_from_url(url)
+
+        return conn
+
+    def close(self):
+        """Disposes of any internal state.
+
+        Currently, this closes the PoolManager and any active ProxyManager,
+        which closes any pooled connections.
+        """
+        self.poolmanager.clear()
+        for proxy in self.proxy_manager.values():
+            proxy.clear()
+
+    def request_url(self, request, proxies):
+        """Obtain the url to use when making the final request.
+
+        If the message is being sent through a HTTP proxy, the full URL has to
+        be used. Otherwise, we should only use the path portion of the URL.
+
+        This should not be called from user code, and is only exposed for use
+        when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
+        :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs.
+        :rtype: str
+        """
+        proxy = select_proxy(request.url, proxies)
+        scheme = urlparse(request.url).scheme
+
+        is_proxied_http_request = (proxy and scheme != 'https')
+        using_socks_proxy = False
+        if proxy:
+            proxy_scheme = urlparse(proxy).scheme.lower()
+            using_socks_proxy = proxy_scheme.startswith('socks')
+
+        url = request.path_url
+        if is_proxied_http_request and not using_socks_proxy:
+            url = urldefragauth(request.url)
+
+        return url
+
+    def add_headers(self, request, **kwargs):
+        """Add any headers needed by the connection. As of v2.0 this does
+        nothing by default, but is left for overriding by users that subclass
+        the :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        This should not be called from user code, and is only exposed for use
+        when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param request: The :class:`PreparedRequest <PreparedRequest>` to add headers to.
+        :param kwargs: The keyword arguments from the call to send().
+        """
+        pass
+
+    def proxy_headers(self, proxy):
+        """Returns a dictionary of the headers to add to any request sent
+        through a proxy. This works with urllib3 magic to ensure that they are
+        correctly sent to the proxy, rather than in a tunnelled request if
+        CONNECT is being used.
+
+        This should not be called from user code, and is only exposed for use
+        when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param proxy: The url of the proxy being used for this request.
+        :rtype: dict
+        """
+        headers = {}
+        username, password = get_auth_from_url(proxy)
+
+        if username:
+            headers['Proxy-Authorization'] = _basic_auth_str(username,
+                                                             password)
+
+        return headers
+
+    def send(self, request, stream=False, timeout=None, verify=True, cert=None, proxies=None):
+        """Sends PreparedRequest object. Returns Response object.
+
+        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
+        :param stream: (optional) Whether to stream the request content.
+        :param timeout: (optional) How long to wait for the server to send
+            data before giving up, as a float, or a :ref:`(connect timeout,
+            read timeout) <timeouts>` tuple.
+        :type timeout: float or tuple or urllib3 Timeout object
+        :param verify: (optional) Either a boolean, in which case it controls whether
+            we verify the server's TLS certificate, or a string, in which case it
+            must be a path to a CA bundle to use
+        :param cert: (optional) Any user-provided SSL certificate to be trusted.
+        :param proxies: (optional) The proxies dictionary to apply to the request.
+        :rtype: requests.Response
+        """
+
+        try:
+            conn = self.get_connection(request.url, proxies)
+        except LocationValueError as e:
+            raise InvalidURL(e, request=request)
+
+        self.cert_verify(conn, request.url, verify, cert)
+        url = self.request_url(request, proxies)
+        self.add_headers(request, stream=stream, timeout=timeout, verify=verify, cert=cert, proxies=proxies)
+
+        chunked = not (request.body is None or 'Content-Length' in request.headers)
+
+        if isinstance(timeout, tuple):
+            try:
+                connect, read = timeout
+                timeout = TimeoutSauce(connect=connect, read=read)
+            except ValueError as e:
+                # this may raise a string formatting error.
+                err = ("Invalid timeout {}. Pass a (connect, read) "
+                       "timeout tuple, or a single float to set "
+                       "both timeouts to the same value".format(timeout))
+                raise ValueError(err)
+        elif isinstance(timeout, TimeoutSauce):
+            pass
+        else:
+            timeout = TimeoutSauce(connect=timeout, read=timeout)
+
+        try:
+            if not chunked:
+                resp = conn.urlopen(
+                    method=request.method,
+                    url=url,
+                    body=request.body,
+                    headers=request.headers,
+                    redirect=False,
+                    assert_same_host=False,
+                    preload_content=False,
+                    decode_content=False,
+                    retries=self.max_retries,
+                    timeout=timeout
+                )
+
+            # Send the request.
+            else:
+                if hasattr(conn, 'proxy_pool'):
+                    conn = conn.proxy_pool
+
+                low_conn = conn._get_conn(timeout=DEFAULT_POOL_TIMEOUT)
+
+                try:
+                    skip_host = 'Host' in request.headers
+                    low_conn.putrequest(request.method,
+                                        url,
+                                        skip_accept_encoding=True,
+                                        skip_host=skip_host)
+
+                    for header, value in request.headers.items():
+                        low_conn.putheader(header, value)
+
+                    low_conn.endheaders()
+
+                    for i in request.body:
+                        low_conn.send(hex(len(i))[2:].encode('utf-8'))
+                        low_conn.send(b'\r\n')
+                        low_conn.send(i)
+                        low_conn.send(b'\r\n')
+                    low_conn.send(b'0\r\n\r\n')
+
+                    # Receive the response from the server
+                    try:
+                        # For Python 2.7, use buffering of HTTP responses
+                        r = low_conn.getresponse(buffering=True)
+                    except TypeError:
+                        # For compatibility with Python 3.3+
+                        r = low_conn.getresponse()
+
+                    resp = HTTPResponse.from_httplib(
+                        r,
+                        pool=conn,
+                        connection=low_conn,
+                        preload_content=False,
+                        decode_content=False
+                    )
+                except:
+                    # If we hit any problems here, clean up the connection.
+                    # Then, reraise so that we can handle the actual exception.
+                    low_conn.close()
+                    raise
+
+        except (ProtocolError, socket.error) as err:
+            raise ConnectionError(err, request=request)
+
+        except MaxRetryError as e:
+            if isinstance(e.reason, ConnectTimeoutError):
+                # TODO: Remove this in 3.0.0: see #2811
+                if not isinstance(e.reason, NewConnectionError):
+                    raise ConnectTimeout(e, request=request)
+
+            if isinstance(e.reason, ResponseError):
+                raise RetryError(e, request=request)
+
+            if isinstance(e.reason, _ProxyError):
+                raise ProxyError(e, request=request)
+
+            if isinstance(e.reason, _SSLError):
+                # This branch is for urllib3 v1.22 and later.
+                raise SSLError(e, request=request)
+
+            raise ConnectionError(e, request=request)
+
+        except ClosedPoolError as e:
+            raise ConnectionError(e, request=request)
+
+        except _ProxyError as e:
+            raise ProxyError(e)
+
+        except (_SSLError, _HTTPError) as e:
+            if isinstance(e, _SSLError):
+                # This branch is for urllib3 versions earlier than v1.22
+                raise SSLError(e, request=request)
+            elif isinstance(e, ReadTimeoutError):
+                raise ReadTimeout(e, request=request)
+            elif isinstance(e, _InvalidHeader):
+                raise InvalidHeader(e, request=request)
+            else:
+                raise
+
+        return self.build_response(request, resp)
diff --git a/openpype/vendor/python/python_2/requests/api.py b/openpype/vendor/python/python_2/requests/api.py
new file mode 100644
index 0000000000..4cba90eefe
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/api.py
@@ -0,0 +1,159 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.api
+~~~~~~~~~~~~
+
+This module implements the Requests API.
+
+:copyright: (c) 2012 by Kenneth Reitz.
+:license: Apache2, see LICENSE for more details.
+"""
+
+from . import sessions
+
+
+def request(method, url, **kwargs):
+    """Constructs and sends a :class:`Request <Request>`.
+
+    :param method: method for the new :class:`Request` object: ``GET``, ``OPTIONS``, ``HEAD``, ``POST``, ``PUT``, ``PATCH``, or ``DELETE``.
+    :param url: URL for the new :class:`Request` object.
+    :param params: (optional) Dictionary, list of tuples or bytes to send
+        in the query string for the :class:`Request`.
+    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+        object to send in the body of the :class:`Request`.
+    :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`.
+    :param headers: (optional) Dictionary of HTTP Headers to send with the :class:`Request`.
+    :param cookies: (optional) Dict or CookieJar object to send with the :class:`Request`.
+    :param files: (optional) Dictionary of ``'name': file-like-objects`` (or ``{'name': file-tuple}``) for multipart encoding upload.
+        ``file-tuple`` can be a 2-tuple ``('filename', fileobj)``, 3-tuple ``('filename', fileobj, 'content_type')``
+        or a 4-tuple ``('filename', fileobj, 'content_type', custom_headers)``, where ``'content-type'`` is a string
+        defining the content type of the given file and ``custom_headers`` a dict-like object containing additional headers
+        to add for the file.
+    :param auth: (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth.
+    :param timeout: (optional) How many seconds to wait for the server to send data
+        before giving up, as a float, or a :ref:`(connect timeout, read
+        timeout) <timeouts>` tuple.
+    :type timeout: float or tuple
+    :param allow_redirects: (optional) Boolean. Enable/disable GET/OPTIONS/POST/PUT/PATCH/DELETE/HEAD redirection. Defaults to ``True``.
+    :type allow_redirects: bool
+    :param proxies: (optional) Dictionary mapping protocol to the URL of the proxy.
+    :param verify: (optional) Either a boolean, in which case it controls whether we verify
+            the server's TLS certificate, or a string, in which case it must be a path
+            to a CA bundle to use. Defaults to ``True``.
+    :param stream: (optional) if ``False``, the response content will be immediately downloaded.
+    :param cert: (optional) if String, path to ssl client cert file (.pem). If Tuple, ('cert', 'key') pair.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+
+    Usage::
+
+      >>> import requests
+      >>> req = requests.request('GET', 'https://httpbin.org/get')
+      >>> req
+      <Response [200]>
+    """
+
+    # By using the 'with' statement we are sure the session is closed, thus we
+    # avoid leaving sockets open which can trigger a ResourceWarning in some
+    # cases, and look like a memory leak in others.
+    with sessions.Session() as session:
+        return session.request(method=method, url=url, **kwargs)
+
+
+def get(url, params=None, **kwargs):
+    r"""Sends a GET request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param params: (optional) Dictionary, list of tuples or bytes to send
+        in the query string for the :class:`Request`.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    return request('get', url, params=params, **kwargs)
+
+
+def options(url, **kwargs):
+    r"""Sends an OPTIONS request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    return request('options', url, **kwargs)
+
+
+def head(url, **kwargs):
+    r"""Sends a HEAD request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param \*\*kwargs: Optional arguments that ``request`` takes. If
+        `allow_redirects` is not provided, it will be set to `False` (as
+        opposed to the default :meth:`request` behavior).
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    kwargs.setdefault('allow_redirects', False)
+    return request('head', url, **kwargs)
+
+
+def post(url, data=None, json=None, **kwargs):
+    r"""Sends a POST request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+        object to send in the body of the :class:`Request`.
+    :param json: (optional) json data to send in the body of the :class:`Request`.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    return request('post', url, data=data, json=json, **kwargs)
+
+
+def put(url, data=None, **kwargs):
+    r"""Sends a PUT request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+        object to send in the body of the :class:`Request`.
+    :param json: (optional) json data to send in the body of the :class:`Request`.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    return request('put', url, data=data, **kwargs)
+
+
+def patch(url, data=None, **kwargs):
+    r"""Sends a PATCH request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+        object to send in the body of the :class:`Request`.
+    :param json: (optional) json data to send in the body of the :class:`Request`.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    return request('patch', url, data=data, **kwargs)
+
+
+def delete(url, **kwargs):
+    r"""Sends a DELETE request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    return request('delete', url, **kwargs)
diff --git a/openpype/vendor/python/python_2/requests/auth.py b/openpype/vendor/python/python_2/requests/auth.py
new file mode 100644
index 0000000000..eeface39ae
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/auth.py
@@ -0,0 +1,305 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.auth
+~~~~~~~~~~~~~
+
+This module contains the authentication handlers for Requests.
+"""
+
+import os
+import re
+import time
+import hashlib
+import threading
+import warnings
+
+from base64 import b64encode
+
+from .compat import urlparse, str, basestring
+from .cookies import extract_cookies_to_jar
+from ._internal_utils import to_native_string
+from .utils import parse_dict_header
+
+CONTENT_TYPE_FORM_URLENCODED = 'application/x-www-form-urlencoded'
+CONTENT_TYPE_MULTI_PART = 'multipart/form-data'
+
+
+def _basic_auth_str(username, password):
+    """Returns a Basic Auth string."""
+
+    # "I want us to put a big-ol' comment on top of it that
+    # says that this behaviour is dumb but we need to preserve
+    # it because people are relying on it."
+    #    - Lukasa
+    #
+    # These are here solely to maintain backwards compatibility
+    # for things like ints. This will be removed in 3.0.0.
+    if not isinstance(username, basestring):
+        warnings.warn(
+            "Non-string usernames will no longer be supported in Requests "
+            "3.0.0. Please convert the object you've passed in ({!r}) to "
+            "a string or bytes object in the near future to avoid "
+            "problems.".format(username),
+            category=DeprecationWarning,
+        )
+        username = str(username)
+
+    if not isinstance(password, basestring):
+        warnings.warn(
+            "Non-string passwords will no longer be supported in Requests "
+            "3.0.0. Please convert the object you've passed in ({!r}) to "
+            "a string or bytes object in the near future to avoid "
+            "problems.".format(type(password)),
+            category=DeprecationWarning,
+        )
+        password = str(password)
+    # -- End Removal --
+
+    if isinstance(username, str):
+        username = username.encode('latin1')
+
+    if isinstance(password, str):
+        password = password.encode('latin1')
+
+    authstr = 'Basic ' + to_native_string(
+        b64encode(b':'.join((username, password))).strip()
+    )
+
+    return authstr
+
+
+class AuthBase(object):
+    """Base class that all auth implementations derive from"""
+
+    def __call__(self, r):
+        raise NotImplementedError('Auth hooks must be callable.')
+
+
+class HTTPBasicAuth(AuthBase):
+    """Attaches HTTP Basic Authentication to the given Request object."""
+
+    def __init__(self, username, password):
+        self.username = username
+        self.password = password
+
+    def __eq__(self, other):
+        return all([
+            self.username == getattr(other, 'username', None),
+            self.password == getattr(other, 'password', None)
+        ])
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __call__(self, r):
+        r.headers['Authorization'] = _basic_auth_str(self.username, self.password)
+        return r
+
+
+class HTTPProxyAuth(HTTPBasicAuth):
+    """Attaches HTTP Proxy Authentication to a given Request object."""
+
+    def __call__(self, r):
+        r.headers['Proxy-Authorization'] = _basic_auth_str(self.username, self.password)
+        return r
+
+
+class HTTPDigestAuth(AuthBase):
+    """Attaches HTTP Digest Authentication to the given Request object."""
+
+    def __init__(self, username, password):
+        self.username = username
+        self.password = password
+        # Keep state in per-thread local storage
+        self._thread_local = threading.local()
+
+    def init_per_thread_state(self):
+        # Ensure state is initialized just once per-thread
+        if not hasattr(self._thread_local, 'init'):
+            self._thread_local.init = True
+            self._thread_local.last_nonce = ''
+            self._thread_local.nonce_count = 0
+            self._thread_local.chal = {}
+            self._thread_local.pos = None
+            self._thread_local.num_401_calls = None
+
+    def build_digest_header(self, method, url):
+        """
+        :rtype: str
+        """
+
+        realm = self._thread_local.chal['realm']
+        nonce = self._thread_local.chal['nonce']
+        qop = self._thread_local.chal.get('qop')
+        algorithm = self._thread_local.chal.get('algorithm')
+        opaque = self._thread_local.chal.get('opaque')
+        hash_utf8 = None
+
+        if algorithm is None:
+            _algorithm = 'MD5'
+        else:
+            _algorithm = algorithm.upper()
+        # lambdas assume digest modules are imported at the top level
+        if _algorithm == 'MD5' or _algorithm == 'MD5-SESS':
+            def md5_utf8(x):
+                if isinstance(x, str):
+                    x = x.encode('utf-8')
+                return hashlib.md5(x).hexdigest()
+            hash_utf8 = md5_utf8
+        elif _algorithm == 'SHA':
+            def sha_utf8(x):
+                if isinstance(x, str):
+                    x = x.encode('utf-8')
+                return hashlib.sha1(x).hexdigest()
+            hash_utf8 = sha_utf8
+        elif _algorithm == 'SHA-256':
+            def sha256_utf8(x):
+                if isinstance(x, str):
+                    x = x.encode('utf-8')
+                return hashlib.sha256(x).hexdigest()
+            hash_utf8 = sha256_utf8
+        elif _algorithm == 'SHA-512':
+            def sha512_utf8(x):
+                if isinstance(x, str):
+                    x = x.encode('utf-8')
+                return hashlib.sha512(x).hexdigest()
+            hash_utf8 = sha512_utf8
+
+        KD = lambda s, d: hash_utf8("%s:%s" % (s, d))
+
+        if hash_utf8 is None:
+            return None
+
+        # XXX not implemented yet
+        entdig = None
+        p_parsed = urlparse(url)
+        #: path is request-uri defined in RFC 2616 which should not be empty
+        path = p_parsed.path or "/"
+        if p_parsed.query:
+            path += '?' + p_parsed.query
+
+        A1 = '%s:%s:%s' % (self.username, realm, self.password)
+        A2 = '%s:%s' % (method, path)
+
+        HA1 = hash_utf8(A1)
+        HA2 = hash_utf8(A2)
+
+        if nonce == self._thread_local.last_nonce:
+            self._thread_local.nonce_count += 1
+        else:
+            self._thread_local.nonce_count = 1
+        ncvalue = '%08x' % self._thread_local.nonce_count
+        s = str(self._thread_local.nonce_count).encode('utf-8')
+        s += nonce.encode('utf-8')
+        s += time.ctime().encode('utf-8')
+        s += os.urandom(8)
+
+        cnonce = (hashlib.sha1(s).hexdigest()[:16])
+        if _algorithm == 'MD5-SESS':
+            HA1 = hash_utf8('%s:%s:%s' % (HA1, nonce, cnonce))
+
+        if not qop:
+            respdig = KD(HA1, "%s:%s" % (nonce, HA2))
+        elif qop == 'auth' or 'auth' in qop.split(','):
+            noncebit = "%s:%s:%s:%s:%s" % (
+                nonce, ncvalue, cnonce, 'auth', HA2
+            )
+            respdig = KD(HA1, noncebit)
+        else:
+            # XXX handle auth-int.
+            return None
+
+        self._thread_local.last_nonce = nonce
+
+        # XXX should the partial digests be encoded too?
+        base = 'username="%s", realm="%s", nonce="%s", uri="%s", ' \
+               'response="%s"' % (self.username, realm, nonce, path, respdig)
+        if opaque:
+            base += ', opaque="%s"' % opaque
+        if algorithm:
+            base += ', algorithm="%s"' % algorithm
+        if entdig:
+            base += ', digest="%s"' % entdig
+        if qop:
+            base += ', qop="auth", nc=%s, cnonce="%s"' % (ncvalue, cnonce)
+
+        return 'Digest %s' % (base)
+
+    def handle_redirect(self, r, **kwargs):
+        """Reset num_401_calls counter on redirects."""
+        if r.is_redirect:
+            self._thread_local.num_401_calls = 1
+
+    def handle_401(self, r, **kwargs):
+        """
+        Takes the given response and tries digest-auth, if needed.
+
+        :rtype: requests.Response
+        """
+
+        # If response is not 4xx, do not auth
+        # See https://github.com/psf/requests/issues/3772
+        if not 400 <= r.status_code < 500:
+            self._thread_local.num_401_calls = 1
+            return r
+
+        if self._thread_local.pos is not None:
+            # Rewind the file position indicator of the body to where
+            # it was to resend the request.
+            r.request.body.seek(self._thread_local.pos)
+        s_auth = r.headers.get('www-authenticate', '')
+
+        if 'digest' in s_auth.lower() and self._thread_local.num_401_calls < 2:
+
+            self._thread_local.num_401_calls += 1
+            pat = re.compile(r'digest ', flags=re.IGNORECASE)
+            self._thread_local.chal = parse_dict_header(pat.sub('', s_auth, count=1))
+
+            # Consume content and release the original connection
+            # to allow our new request to reuse the same one.
+            r.content
+            r.close()
+            prep = r.request.copy()
+            extract_cookies_to_jar(prep._cookies, r.request, r.raw)
+            prep.prepare_cookies(prep._cookies)
+
+            prep.headers['Authorization'] = self.build_digest_header(
+                prep.method, prep.url)
+            _r = r.connection.send(prep, **kwargs)
+            _r.history.append(r)
+            _r.request = prep
+
+            return _r
+
+        self._thread_local.num_401_calls = 1
+        return r
+
+    def __call__(self, r):
+        # Initialize per-thread state, if needed
+        self.init_per_thread_state()
+        # If we have a saved nonce, skip the 401
+        if self._thread_local.last_nonce:
+            r.headers['Authorization'] = self.build_digest_header(r.method, r.url)
+        try:
+            self._thread_local.pos = r.body.tell()
+        except AttributeError:
+            # In the case of HTTPDigestAuth being reused and the body of
+            # the previous request was a file-like object, pos has the
+            # file position of the previous body. Ensure it's set to
+            # None.
+            self._thread_local.pos = None
+        r.register_hook('response', self.handle_401)
+        r.register_hook('response', self.handle_redirect)
+        self._thread_local.num_401_calls = 1
+
+        return r
+
+    def __eq__(self, other):
+        return all([
+            self.username == getattr(other, 'username', None),
+            self.password == getattr(other, 'password', None)
+        ])
+
+    def __ne__(self, other):
+        return not self == other
diff --git a/openpype/vendor/python/python_2/requests/certs.py b/openpype/vendor/python/python_2/requests/certs.py
new file mode 100644
index 0000000000..d1a378d787
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/certs.py
@@ -0,0 +1,18 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+requests.certs
+~~~~~~~~~~~~~~
+
+This module returns the preferred default CA certificate bundle. There is
+only one — the one from the certifi package.
+
+If you are packaging Requests, e.g., for a Linux distribution or a managed
+environment, you can change the definition of where() to return a separately
+packaged CA bundle.
+"""
+from certifi import where
+
+if __name__ == '__main__':
+    print(where())
diff --git a/openpype/vendor/python/python_2/requests/compat.py b/openpype/vendor/python/python_2/requests/compat.py
new file mode 100644
index 0000000000..029ae62ac3
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/compat.py
@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.compat
+~~~~~~~~~~~~~~~
+
+This module handles import compatibility issues between Python 2 and
+Python 3.
+"""
+
+try:
+    import chardet
+except ImportError:
+    import charset_normalizer as chardet
+
+import sys
+
+# -------
+# Pythons
+# -------
+
+# Syntax sugar.
+_ver = sys.version_info
+
+#: Python 2.x?
+is_py2 = (_ver[0] == 2)
+
+#: Python 3.x?
+is_py3 = (_ver[0] == 3)
+
+has_simplejson = False
+try:
+    import simplejson as json
+    has_simplejson = True
+except ImportError:
+    import json
+
+# ---------
+# Specifics
+# ---------
+
+if is_py2:
+    from urllib import (
+        quote, unquote, quote_plus, unquote_plus, urlencode, getproxies,
+        proxy_bypass, proxy_bypass_environment, getproxies_environment)
+    from urlparse import urlparse, urlunparse, urljoin, urlsplit, urldefrag
+    from urllib2 import parse_http_list
+    import cookielib
+    from Cookie import Morsel
+    from StringIO import StringIO
+    # Keep OrderedDict for backwards compatibility.
+    from collections import Callable, Mapping, MutableMapping, OrderedDict
+
+    builtin_str = str
+    bytes = str
+    str = unicode
+    basestring = basestring
+    numeric_types = (int, long, float)
+    integer_types = (int, long)
+    JSONDecodeError = ValueError
+
+elif is_py3:
+    from urllib.parse import urlparse, urlunparse, urljoin, urlsplit, urlencode, quote, unquote, quote_plus, unquote_plus, urldefrag
+    from urllib.request import parse_http_list, getproxies, proxy_bypass, proxy_bypass_environment, getproxies_environment
+    from http import cookiejar as cookielib
+    from http.cookies import Morsel
+    from io import StringIO
+    # Keep OrderedDict for backwards compatibility.
+    from collections import OrderedDict
+    from collections.abc import Callable, Mapping, MutableMapping
+    if has_simplejson:
+        from simplejson import JSONDecodeError
+    else:
+        from json import JSONDecodeError
+
+    builtin_str = str
+    str = str
+    bytes = bytes
+    basestring = (str, bytes)
+    numeric_types = (int, float)
+    integer_types = (int,)
diff --git a/openpype/vendor/python/python_2/requests/cookies.py b/openpype/vendor/python/python_2/requests/cookies.py
new file mode 100644
index 0000000000..56fccd9c25
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/cookies.py
@@ -0,0 +1,549 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.cookies
+~~~~~~~~~~~~~~~~
+
+Compatibility code to be able to use `cookielib.CookieJar` with requests.
+
+requests.utils imports from here, so be careful with imports.
+"""
+
+import copy
+import time
+import calendar
+
+from ._internal_utils import to_native_string
+from .compat import cookielib, urlparse, urlunparse, Morsel, MutableMapping
+
+try:
+    import threading
+except ImportError:
+    import dummy_threading as threading
+
+
+class MockRequest(object):
+    """Wraps a `requests.Request` to mimic a `urllib2.Request`.
+
+    The code in `cookielib.CookieJar` expects this interface in order to correctly
+    manage cookie policies, i.e., determine whether a cookie can be set, given the
+    domains of the request and the cookie.
+
+    The original request object is read-only. The client is responsible for collecting
+    the new headers via `get_new_headers()` and interpreting them appropriately. You
+    probably want `get_cookie_header`, defined below.
+    """
+
+    def __init__(self, request):
+        self._r = request
+        self._new_headers = {}
+        self.type = urlparse(self._r.url).scheme
+
+    def get_type(self):
+        return self.type
+
+    def get_host(self):
+        return urlparse(self._r.url).netloc
+
+    def get_origin_req_host(self):
+        return self.get_host()
+
+    def get_full_url(self):
+        # Only return the response's URL if the user hadn't set the Host
+        # header
+        if not self._r.headers.get('Host'):
+            return self._r.url
+        # If they did set it, retrieve it and reconstruct the expected domain
+        host = to_native_string(self._r.headers['Host'], encoding='utf-8')
+        parsed = urlparse(self._r.url)
+        # Reconstruct the URL as we expect it
+        return urlunparse([
+            parsed.scheme, host, parsed.path, parsed.params, parsed.query,
+            parsed.fragment
+        ])
+
+    def is_unverifiable(self):
+        return True
+
+    def has_header(self, name):
+        return name in self._r.headers or name in self._new_headers
+
+    def get_header(self, name, default=None):
+        return self._r.headers.get(name, self._new_headers.get(name, default))
+
+    def add_header(self, key, val):
+        """cookielib has no legitimate use for this method; add it back if you find one."""
+        raise NotImplementedError("Cookie headers should be added with add_unredirected_header()")
+
+    def add_unredirected_header(self, name, value):
+        self._new_headers[name] = value
+
+    def get_new_headers(self):
+        return self._new_headers
+
+    @property
+    def unverifiable(self):
+        return self.is_unverifiable()
+
+    @property
+    def origin_req_host(self):
+        return self.get_origin_req_host()
+
+    @property
+    def host(self):
+        return self.get_host()
+
+
+class MockResponse(object):
+    """Wraps a `httplib.HTTPMessage` to mimic a `urllib.addinfourl`.
+
+    ...what? Basically, expose the parsed HTTP headers from the server response
+    the way `cookielib` expects to see them.
+    """
+
+    def __init__(self, headers):
+        """Make a MockResponse for `cookielib` to read.
+
+        :param headers: a httplib.HTTPMessage or analogous carrying the headers
+        """
+        self._headers = headers
+
+    def info(self):
+        return self._headers
+
+    def getheaders(self, name):
+        self._headers.getheaders(name)
+
+
+def extract_cookies_to_jar(jar, request, response):
+    """Extract the cookies from the response into a CookieJar.
+
+    :param jar: cookielib.CookieJar (not necessarily a RequestsCookieJar)
+    :param request: our own requests.Request object
+    :param response: urllib3.HTTPResponse object
+    """
+    if not (hasattr(response, '_original_response') and
+            response._original_response):
+        return
+    # the _original_response field is the wrapped httplib.HTTPResponse object,
+    req = MockRequest(request)
+    # pull out the HTTPMessage with the headers and put it in the mock:
+    res = MockResponse(response._original_response.msg)
+    jar.extract_cookies(res, req)
+
+
+def get_cookie_header(jar, request):
+    """
+    Produce an appropriate Cookie header string to be sent with `request`, or None.
+
+    :rtype: str
+    """
+    r = MockRequest(request)
+    jar.add_cookie_header(r)
+    return r.get_new_headers().get('Cookie')
+
+
+def remove_cookie_by_name(cookiejar, name, domain=None, path=None):
+    """Unsets a cookie by name, by default over all domains and paths.
+
+    Wraps CookieJar.clear(), is O(n).
+    """
+    clearables = []
+    for cookie in cookiejar:
+        if cookie.name != name:
+            continue
+        if domain is not None and domain != cookie.domain:
+            continue
+        if path is not None and path != cookie.path:
+            continue
+        clearables.append((cookie.domain, cookie.path, cookie.name))
+
+    for domain, path, name in clearables:
+        cookiejar.clear(domain, path, name)
+
+
+class CookieConflictError(RuntimeError):
+    """There are two cookies that meet the criteria specified in the cookie jar.
+    Use .get and .set and include domain and path args in order to be more specific.
+    """
+
+
+class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
+    """Compatibility class; is a cookielib.CookieJar, but exposes a dict
+    interface.
+
+    This is the CookieJar we create by default for requests and sessions that
+    don't specify one, since some clients may expect response.cookies and
+    session.cookies to support dict operations.
+
+    Requests does not use the dict interface internally; it's just for
+    compatibility with external client code. All requests code should work
+    out of the box with externally provided instances of ``CookieJar``, e.g.
+    ``LWPCookieJar`` and ``FileCookieJar``.
+
+    Unlike a regular CookieJar, this class is pickleable.
+
+    .. warning:: dictionary operations that are normally O(1) may be O(n).
+    """
+
+    def get(self, name, default=None, domain=None, path=None):
+        """Dict-like get() that also supports optional domain and path args in
+        order to resolve naming collisions from using one cookie jar over
+        multiple domains.
+
+        .. warning:: operation is O(n), not O(1).
+        """
+        try:
+            return self._find_no_duplicates(name, domain, path)
+        except KeyError:
+            return default
+
+    def set(self, name, value, **kwargs):
+        """Dict-like set() that also supports optional domain and path args in
+        order to resolve naming collisions from using one cookie jar over
+        multiple domains.
+        """
+        # support client code that unsets cookies by assignment of a None value:
+        if value is None:
+            remove_cookie_by_name(self, name, domain=kwargs.get('domain'), path=kwargs.get('path'))
+            return
+
+        if isinstance(value, Morsel):
+            c = morsel_to_cookie(value)
+        else:
+            c = create_cookie(name, value, **kwargs)
+        self.set_cookie(c)
+        return c
+
+    def iterkeys(self):
+        """Dict-like iterkeys() that returns an iterator of names of cookies
+        from the jar.
+
+        .. seealso:: itervalues() and iteritems().
+        """
+        for cookie in iter(self):
+            yield cookie.name
+
+    def keys(self):
+        """Dict-like keys() that returns a list of names of cookies from the
+        jar.
+
+        .. seealso:: values() and items().
+        """
+        return list(self.iterkeys())
+
+    def itervalues(self):
+        """Dict-like itervalues() that returns an iterator of values of cookies
+        from the jar.
+
+        .. seealso:: iterkeys() and iteritems().
+        """
+        for cookie in iter(self):
+            yield cookie.value
+
+    def values(self):
+        """Dict-like values() that returns a list of values of cookies from the
+        jar.
+
+        .. seealso:: keys() and items().
+        """
+        return list(self.itervalues())
+
+    def iteritems(self):
+        """Dict-like iteritems() that returns an iterator of name-value tuples
+        from the jar.
+
+        .. seealso:: iterkeys() and itervalues().
+        """
+        for cookie in iter(self):
+            yield cookie.name, cookie.value
+
+    def items(self):
+        """Dict-like items() that returns a list of name-value tuples from the
+        jar. Allows client-code to call ``dict(RequestsCookieJar)`` and get a
+        vanilla python dict of key value pairs.
+
+        .. seealso:: keys() and values().
+        """
+        return list(self.iteritems())
+
+    def list_domains(self):
+        """Utility method to list all the domains in the jar."""
+        domains = []
+        for cookie in iter(self):
+            if cookie.domain not in domains:
+                domains.append(cookie.domain)
+        return domains
+
+    def list_paths(self):
+        """Utility method to list all the paths in the jar."""
+        paths = []
+        for cookie in iter(self):
+            if cookie.path not in paths:
+                paths.append(cookie.path)
+        return paths
+
+    def multiple_domains(self):
+        """Returns True if there are multiple domains in the jar.
+        Returns False otherwise.
+
+        :rtype: bool
+        """
+        domains = []
+        for cookie in iter(self):
+            if cookie.domain is not None and cookie.domain in domains:
+                return True
+            domains.append(cookie.domain)
+        return False  # there is only one domain in jar
+
+    def get_dict(self, domain=None, path=None):
+        """Takes as an argument an optional domain and path and returns a plain
+        old Python dict of name-value pairs of cookies that meet the
+        requirements.
+
+        :rtype: dict
+        """
+        dictionary = {}
+        for cookie in iter(self):
+            if (
+                (domain is None or cookie.domain == domain) and
+                (path is None or cookie.path == path)
+            ):
+                dictionary[cookie.name] = cookie.value
+        return dictionary
+
+    def __contains__(self, name):
+        try:
+            return super(RequestsCookieJar, self).__contains__(name)
+        except CookieConflictError:
+            return True
+
+    def __getitem__(self, name):
+        """Dict-like __getitem__() for compatibility with client code. Throws
+        exception if there are more than one cookie with name. In that case,
+        use the more explicit get() method instead.
+
+        .. warning:: operation is O(n), not O(1).
+        """
+        return self._find_no_duplicates(name)
+
+    def __setitem__(self, name, value):
+        """Dict-like __setitem__ for compatibility with client code. Throws
+        exception if there is already a cookie of that name in the jar. In that
+        case, use the more explicit set() method instead.
+        """
+        self.set(name, value)
+
+    def __delitem__(self, name):
+        """Deletes a cookie given a name. Wraps ``cookielib.CookieJar``'s
+        ``remove_cookie_by_name()``.
+        """
+        remove_cookie_by_name(self, name)
+
+    def set_cookie(self, cookie, *args, **kwargs):
+        if hasattr(cookie.value, 'startswith') and cookie.value.startswith('"') and cookie.value.endswith('"'):
+            cookie.value = cookie.value.replace('\\"', '')
+        return super(RequestsCookieJar, self).set_cookie(cookie, *args, **kwargs)
+
+    def update(self, other):
+        """Updates this jar with cookies from another CookieJar or dict-like"""
+        if isinstance(other, cookielib.CookieJar):
+            for cookie in other:
+                self.set_cookie(copy.copy(cookie))
+        else:
+            super(RequestsCookieJar, self).update(other)
+
+    def _find(self, name, domain=None, path=None):
+        """Requests uses this method internally to get cookie values.
+
+        If there are conflicting cookies, _find arbitrarily chooses one.
+        See _find_no_duplicates if you want an exception thrown if there are
+        conflicting cookies.
+
+        :param name: a string containing name of cookie
+        :param domain: (optional) string containing domain of cookie
+        :param path: (optional) string containing path of cookie
+        :return: cookie.value
+        """
+        for cookie in iter(self):
+            if cookie.name == name:
+                if domain is None or cookie.domain == domain:
+                    if path is None or cookie.path == path:
+                        return cookie.value
+
+        raise KeyError('name=%r, domain=%r, path=%r' % (name, domain, path))
+
+    def _find_no_duplicates(self, name, domain=None, path=None):
+        """Both ``__get_item__`` and ``get`` call this function: it's never
+        used elsewhere in Requests.
+
+        :param name: a string containing name of cookie
+        :param domain: (optional) string containing domain of cookie
+        :param path: (optional) string containing path of cookie
+        :raises KeyError: if cookie is not found
+        :raises CookieConflictError: if there are multiple cookies
+            that match name and optionally domain and path
+        :return: cookie.value
+        """
+        toReturn = None
+        for cookie in iter(self):
+            if cookie.name == name:
+                if domain is None or cookie.domain == domain:
+                    if path is None or cookie.path == path:
+                        if toReturn is not None:  # if there are multiple cookies that meet passed in criteria
+                            raise CookieConflictError('There are multiple cookies with name, %r' % (name))
+                        toReturn = cookie.value  # we will eventually return this as long as no cookie conflict
+
+        if toReturn:
+            return toReturn
+        raise KeyError('name=%r, domain=%r, path=%r' % (name, domain, path))
+
+    def __getstate__(self):
+        """Unlike a normal CookieJar, this class is pickleable."""
+        state = self.__dict__.copy()
+        # remove the unpickleable RLock object
+        state.pop('_cookies_lock')
+        return state
+
+    def __setstate__(self, state):
+        """Unlike a normal CookieJar, this class is pickleable."""
+        self.__dict__.update(state)
+        if '_cookies_lock' not in self.__dict__:
+            self._cookies_lock = threading.RLock()
+
+    def copy(self):
+        """Return a copy of this RequestsCookieJar."""
+        new_cj = RequestsCookieJar()
+        new_cj.set_policy(self.get_policy())
+        new_cj.update(self)
+        return new_cj
+
+    def get_policy(self):
+        """Return the CookiePolicy instance used."""
+        return self._policy
+
+
+def _copy_cookie_jar(jar):
+    if jar is None:
+        return None
+
+    if hasattr(jar, 'copy'):
+        # We're dealing with an instance of RequestsCookieJar
+        return jar.copy()
+    # We're dealing with a generic CookieJar instance
+    new_jar = copy.copy(jar)
+    new_jar.clear()
+    for cookie in jar:
+        new_jar.set_cookie(copy.copy(cookie))
+    return new_jar
+
+
+def create_cookie(name, value, **kwargs):
+    """Make a cookie from underspecified parameters.
+
+    By default, the pair of `name` and `value` will be set for the domain ''
+    and sent on every request (this is sometimes called a "supercookie").
+    """
+    result = {
+        'version': 0,
+        'name': name,
+        'value': value,
+        'port': None,
+        'domain': '',
+        'path': '/',
+        'secure': False,
+        'expires': None,
+        'discard': True,
+        'comment': None,
+        'comment_url': None,
+        'rest': {'HttpOnly': None},
+        'rfc2109': False,
+    }
+
+    badargs = set(kwargs) - set(result)
+    if badargs:
+        err = 'create_cookie() got unexpected keyword arguments: %s'
+        raise TypeError(err % list(badargs))
+
+    result.update(kwargs)
+    result['port_specified'] = bool(result['port'])
+    result['domain_specified'] = bool(result['domain'])
+    result['domain_initial_dot'] = result['domain'].startswith('.')
+    result['path_specified'] = bool(result['path'])
+
+    return cookielib.Cookie(**result)
+
+
+def morsel_to_cookie(morsel):
+    """Convert a Morsel object into a Cookie containing the one k/v pair."""
+
+    expires = None
+    if morsel['max-age']:
+        try:
+            expires = int(time.time() + int(morsel['max-age']))
+        except ValueError:
+            raise TypeError('max-age: %s must be integer' % morsel['max-age'])
+    elif morsel['expires']:
+        time_template = '%a, %d-%b-%Y %H:%M:%S GMT'
+        expires = calendar.timegm(
+            time.strptime(morsel['expires'], time_template)
+        )
+    return create_cookie(
+        comment=morsel['comment'],
+        comment_url=bool(morsel['comment']),
+        discard=False,
+        domain=morsel['domain'],
+        expires=expires,
+        name=morsel.key,
+        path=morsel['path'],
+        port=None,
+        rest={'HttpOnly': morsel['httponly']},
+        rfc2109=False,
+        secure=bool(morsel['secure']),
+        value=morsel.value,
+        version=morsel['version'] or 0,
+    )
+
+
+def cookiejar_from_dict(cookie_dict, cookiejar=None, overwrite=True):
+    """Returns a CookieJar from a key/value dictionary.
+
+    :param cookie_dict: Dict of key/values to insert into CookieJar.
+    :param cookiejar: (optional) A cookiejar to add the cookies to.
+    :param overwrite: (optional) If False, will not replace cookies
+        already in the jar with new ones.
+    :rtype: CookieJar
+    """
+    if cookiejar is None:
+        cookiejar = RequestsCookieJar()
+
+    if cookie_dict is not None:
+        names_from_jar = [cookie.name for cookie in cookiejar]
+        for name in cookie_dict:
+            if overwrite or (name not in names_from_jar):
+                cookiejar.set_cookie(create_cookie(name, cookie_dict[name]))
+
+    return cookiejar
+
+
+def merge_cookies(cookiejar, cookies):
+    """Add cookies to cookiejar and returns a merged CookieJar.
+
+    :param cookiejar: CookieJar object to add the cookies to.
+    :param cookies: Dictionary or CookieJar object to be added.
+    :rtype: CookieJar
+    """
+    if not isinstance(cookiejar, cookielib.CookieJar):
+        raise ValueError('You can only merge into CookieJar')
+
+    if isinstance(cookies, dict):
+        cookiejar = cookiejar_from_dict(
+            cookies, cookiejar=cookiejar, overwrite=False)
+    elif isinstance(cookies, cookielib.CookieJar):
+        try:
+            cookiejar.update(cookies)
+        except AttributeError:
+            for cookie_in_jar in cookies:
+                cookiejar.set_cookie(cookie_in_jar)
+
+    return cookiejar
diff --git a/openpype/vendor/python/python_2/requests/exceptions.py b/openpype/vendor/python/python_2/requests/exceptions.py
new file mode 100644
index 0000000000..79697635a5
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/exceptions.py
@@ -0,0 +1,133 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.exceptions
+~~~~~~~~~~~~~~~~~~~
+
+This module contains the set of Requests' exceptions.
+"""
+from urllib3.exceptions import HTTPError as BaseHTTPError
+
+from .compat import JSONDecodeError as CompatJSONDecodeError
+
+
+class RequestException(IOError):
+    """There was an ambiguous exception that occurred while handling your
+    request.
+    """
+
+    def __init__(self, *args, **kwargs):
+        """Initialize RequestException with `request` and `response` objects."""
+        response = kwargs.pop('response', None)
+        self.response = response
+        self.request = kwargs.pop('request', None)
+        if (response is not None and not self.request and
+                hasattr(response, 'request')):
+            self.request = self.response.request
+        super(RequestException, self).__init__(*args, **kwargs)
+
+
+class InvalidJSONError(RequestException):
+    """A JSON error occurred."""
+
+
+class JSONDecodeError(InvalidJSONError, CompatJSONDecodeError):
+    """Couldn't decode the text into json"""
+
+
+class HTTPError(RequestException):
+    """An HTTP error occurred."""
+
+
+class ConnectionError(RequestException):
+    """A Connection error occurred."""
+
+
+class ProxyError(ConnectionError):
+    """A proxy error occurred."""
+
+
+class SSLError(ConnectionError):
+    """An SSL error occurred."""
+
+
+class Timeout(RequestException):
+    """The request timed out.
+
+    Catching this error will catch both
+    :exc:`~requests.exceptions.ConnectTimeout` and
+    :exc:`~requests.exceptions.ReadTimeout` errors.
+    """
+
+
+class ConnectTimeout(ConnectionError, Timeout):
+    """The request timed out while trying to connect to the remote server.
+
+    Requests that produced this error are safe to retry.
+    """
+
+
+class ReadTimeout(Timeout):
+    """The server did not send any data in the allotted amount of time."""
+
+
+class URLRequired(RequestException):
+    """A valid URL is required to make a request."""
+
+
+class TooManyRedirects(RequestException):
+    """Too many redirects."""
+
+
+class MissingSchema(RequestException, ValueError):
+    """The URL scheme (e.g. http or https) is missing."""
+
+
+class InvalidSchema(RequestException, ValueError):
+    """The URL scheme provided is either invalid or unsupported."""
+
+
+class InvalidURL(RequestException, ValueError):
+    """The URL provided was somehow invalid."""
+
+
+class InvalidHeader(RequestException, ValueError):
+    """The header value provided was somehow invalid."""
+
+
+class InvalidProxyURL(InvalidURL):
+    """The proxy URL provided is invalid."""
+
+
+class ChunkedEncodingError(RequestException):
+    """The server declared chunked encoding but sent an invalid chunk."""
+
+
+class ContentDecodingError(RequestException, BaseHTTPError):
+    """Failed to decode response content."""
+
+
+class StreamConsumedError(RequestException, TypeError):
+    """The content for this response was already consumed."""
+
+
+class RetryError(RequestException):
+    """Custom retries logic failed"""
+
+
+class UnrewindableBodyError(RequestException):
+    """Requests encountered an error when trying to rewind a body."""
+
+# Warnings
+
+
+class RequestsWarning(Warning):
+    """Base warning for Requests."""
+
+
+class FileModeWarning(RequestsWarning, DeprecationWarning):
+    """A file was opened in text mode, but Requests determined its binary length."""
+
+
+class RequestsDependencyWarning(RequestsWarning):
+    """An imported dependency doesn't match the expected version range."""
diff --git a/openpype/vendor/python/python_2/requests/help.py b/openpype/vendor/python/python_2/requests/help.py
new file mode 100644
index 0000000000..4cd6389f55
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/help.py
@@ -0,0 +1,135 @@
+"""Module containing bug report helper(s)."""
+from __future__ import print_function
+
+import json
+import platform
+import sys
+import ssl
+
+import idna
+import urllib3
+
+from . import __version__ as requests_version
+
+try:
+    import charset_normalizer
+except ImportError:
+    charset_normalizer = None
+
+try:
+    import chardet
+except ImportError:
+    chardet = None
+
+try:
+    from urllib3.contrib import pyopenssl
+except ImportError:
+    pyopenssl = None
+    OpenSSL = None
+    cryptography = None
+else:
+    import OpenSSL
+    import cryptography
+
+
+def _implementation():
+    """Return a dict with the Python implementation and version.
+
+    Provide both the name and the version of the Python implementation
+    currently running. For example, on CPython 2.7.5 it will return
+    {'name': 'CPython', 'version': '2.7.5'}.
+
+    This function works best on CPython and PyPy: in particular, it probably
+    doesn't work for Jython or IronPython. Future investigation should be done
+    to work out the correct shape of the code for those platforms.
+    """
+    implementation = platform.python_implementation()
+
+    if implementation == 'CPython':
+        implementation_version = platform.python_version()
+    elif implementation == 'PyPy':
+        implementation_version = '%s.%s.%s' % (sys.pypy_version_info.major,
+                                               sys.pypy_version_info.minor,
+                                               sys.pypy_version_info.micro)
+        if sys.pypy_version_info.releaselevel != 'final':
+            implementation_version = ''.join([
+                implementation_version, sys.pypy_version_info.releaselevel
+            ])
+    elif implementation == 'Jython':
+        implementation_version = platform.python_version()  # Complete Guess
+    elif implementation == 'IronPython':
+        implementation_version = platform.python_version()  # Complete Guess
+    else:
+        implementation_version = 'Unknown'
+
+    return {'name': implementation, 'version': implementation_version}
+
+
+def info():
+    """Generate information for a bug report."""
+    try:
+        platform_info = {
+            'system': platform.system(),
+            'release': platform.release(),
+        }
+    except IOError:
+        platform_info = {
+            'system': 'Unknown',
+            'release': 'Unknown',
+        }
+
+    implementation_info = _implementation()
+    urllib3_info = {'version': urllib3.__version__}
+    charset_normalizer_info = {'version': None}
+    chardet_info = {'version': None}
+    if charset_normalizer:
+        charset_normalizer_info = {'version': charset_normalizer.__version__}
+    if chardet:
+        chardet_info = {'version': chardet.__version__}
+
+    pyopenssl_info = {
+        'version': None,
+        'openssl_version': '',
+    }
+    if OpenSSL:
+        pyopenssl_info = {
+            'version': OpenSSL.__version__,
+            'openssl_version': '%x' % OpenSSL.SSL.OPENSSL_VERSION_NUMBER,
+        }
+    cryptography_info = {
+        'version': getattr(cryptography, '__version__', ''),
+    }
+    idna_info = {
+        'version': getattr(idna, '__version__', ''),
+    }
+
+    system_ssl = ssl.OPENSSL_VERSION_NUMBER
+    system_ssl_info = {
+        'version': '%x' % system_ssl if system_ssl is not None else ''
+    }
+
+    return {
+        'platform': platform_info,
+        'implementation': implementation_info,
+        'system_ssl': system_ssl_info,
+        'using_pyopenssl': pyopenssl is not None,
+        'using_charset_normalizer': chardet is None,
+        'pyOpenSSL': pyopenssl_info,
+        'urllib3': urllib3_info,
+        'chardet': chardet_info,
+        'charset_normalizer': charset_normalizer_info,
+        'cryptography': cryptography_info,
+        'idna': idna_info,
+        'requests': {
+            'version': requests_version,
+        },
+    }
+
+
+def main():
+    """Pretty-print the bug information as JSON."""
+    print(json.dumps(info(), sort_keys=True, indent=2))
+
+
+if __name__ == '__main__':
+    main()
diff --git a/openpype/vendor/python/python_2/requests/hooks.py b/openpype/vendor/python/python_2/requests/hooks.py
new file mode 100644
index 0000000000..7a51f212c8
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/hooks.py
@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.hooks
+~~~~~~~~~~~~~~
+
+This module provides the capabilities for the Requests hooks system.
+
+Available hooks:
+
+``response``:
+    The response generated from a Request.
+"""
+HOOKS = ['response']
+
+
+def default_hooks():
+    return {event: [] for event in HOOKS}
+
+# TODO: response is the only one
+
+
+def dispatch_hook(key, hooks, hook_data, **kwargs):
+    """Dispatches a hook dictionary on a given piece of data."""
+    hooks = hooks or {}
+    hooks = hooks.get(key)
+    if hooks:
+        if hasattr(hooks, '__call__'):
+            hooks = [hooks]
+        for hook in hooks:
+            _hook_data = hook(hook_data, **kwargs)
+            if _hook_data is not None:
+                hook_data = _hook_data
+    return hook_data
diff --git a/openpype/vendor/python/python_2/requests/models.py b/openpype/vendor/python/python_2/requests/models.py
new file mode 100644
index 0000000000..dfbea854f9
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/models.py
@@ -0,0 +1,973 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.models
+~~~~~~~~~~~~~~~
+
+This module contains the primary objects that power Requests.
+"""
+
+import datetime
+import sys
+
+# Import encoding now, to avoid implicit import later.
+# Implicit import within threads may cause LookupError when standard library is in a ZIP,
+# such as in Embedded Python. See https://github.com/psf/requests/issues/3578.
+import encodings.idna
+
+from urllib3.fields import RequestField
+from urllib3.filepost import encode_multipart_formdata
+from urllib3.util import parse_url
+from urllib3.exceptions import (
+    DecodeError, ReadTimeoutError, ProtocolError, LocationParseError)
+
+from io import UnsupportedOperation
+from .hooks import default_hooks
+from .structures import CaseInsensitiveDict
+
+from .auth import HTTPBasicAuth
+from .cookies import cookiejar_from_dict, get_cookie_header, _copy_cookie_jar
+from .exceptions import (
+    HTTPError, MissingSchema, InvalidURL, ChunkedEncodingError,
+    ContentDecodingError, ConnectionError, StreamConsumedError,
+    InvalidJSONError)
+from .exceptions import JSONDecodeError as RequestsJSONDecodeError
+from ._internal_utils import to_native_string, unicode_is_ascii
+from .utils import (
+    guess_filename, get_auth_from_url, requote_uri,
+    stream_decode_response_unicode, to_key_val_list, parse_header_links,
+    iter_slices, guess_json_utf, super_len, check_header_validity)
+from .compat import (
+    Callable, Mapping,
+    cookielib, urlunparse, urlsplit, urlencode, str, bytes,
+    is_py2, chardet, builtin_str, basestring, JSONDecodeError)
+from .compat import json as complexjson
+from .status_codes import codes
+
+#: The set of HTTP status codes that indicate an automatically
+#: processable redirect.
+REDIRECT_STATI = (
+    codes.moved,               # 301
+    codes.found,               # 302
+    codes.other,               # 303
+    codes.temporary_redirect,  # 307
+    codes.permanent_redirect,  # 308
+)
+
+DEFAULT_REDIRECT_LIMIT = 30
+CONTENT_CHUNK_SIZE = 10 * 1024
+ITER_CHUNK_SIZE = 512
+
+
+class RequestEncodingMixin(object):
+    @property
+    def path_url(self):
+        """Build the path URL to use."""
+
+        url = []
+
+        p = urlsplit(self.url)
+
+        path = p.path
+        if not path:
+            path = '/'
+
+        url.append(path)
+
+        query = p.query
+        if query:
+            url.append('?')
+            url.append(query)
+
+        return ''.join(url)
+
+    @staticmethod
+    def _encode_params(data):
+        """Encode parameters in a piece of data.
+
+        Will successfully encode parameters when passed as a dict or a list of
+        2-tuples. Order is retained if data is a list of 2-tuples but arbitrary
+        if parameters are supplied as a dict.
+        """
+
+        if isinstance(data, (str, bytes)):
+            return data
+        elif hasattr(data, 'read'):
+            return data
+        elif hasattr(data, '__iter__'):
+            result = []
+            for k, vs in to_key_val_list(data):
+                if isinstance(vs, basestring) or not hasattr(vs, '__iter__'):
+                    vs = [vs]
+                for v in vs:
+                    if v is not None:
+                        result.append(
+                            (k.encode('utf-8') if isinstance(k, str) else k,
+                             v.encode('utf-8') if isinstance(v, str) else v))
+            return urlencode(result, doseq=True)
+        else:
+            return data
+
+    @staticmethod
+    def _encode_files(files, data):
+        """Build the body for a multipart/form-data request.
+
+        Will successfully encode files when passed as a dict or a list of
+        tuples. Order is retained if data is a list of tuples but arbitrary
+        if parameters are supplied as a dict.
+        The tuples may be 2-tuples (filename, fileobj), 3-tuples (filename, fileobj, contentype)
+        or 4-tuples (filename, fileobj, contentype, custom_headers).
+        """
+        if (not files):
+            raise ValueError("Files must be provided.")
+        elif isinstance(data, basestring):
+            raise ValueError("Data must not be a string.")
+
+        new_fields = []
+        fields = to_key_val_list(data or {})
+        files = to_key_val_list(files or {})
+
+        for field, val in fields:
+            if isinstance(val, basestring) or not hasattr(val, '__iter__'):
+                val = [val]
+            for v in val:
+                if v is not None:
+                    # Don't call str() on bytestrings: in Py3 it all goes wrong.
+                    if not isinstance(v, bytes):
+                        v = str(v)
+
+                    new_fields.append(
+                        (field.decode('utf-8') if isinstance(field, bytes) else field,
+                         v.encode('utf-8') if isinstance(v, str) else v))
+
+        for (k, v) in files:
+            # support for explicit filename
+            ft = None
+            fh = None
+            if isinstance(v, (tuple, list)):
+                if len(v) == 2:
+                    fn, fp = v
+                elif len(v) == 3:
+                    fn, fp, ft = v
+                else:
+                    fn, fp, ft, fh = v
+            else:
+                fn = guess_filename(v) or k
+                fp = v
+
+            if isinstance(fp, (str, bytes, bytearray)):
+                fdata = fp
+            elif hasattr(fp, 'read'):
+                fdata = fp.read()
+            elif fp is None:
+                continue
+            else:
+                fdata = fp
+
+            rf = RequestField(name=k, data=fdata, filename=fn, headers=fh)
+            rf.make_multipart(content_type=ft)
+            new_fields.append(rf)
+
+        body, content_type = encode_multipart_formdata(new_fields)
+
+        return body, content_type
+
+
+class RequestHooksMixin(object):
+    def register_hook(self, event, hook):
+        """Properly register a hook."""
+
+        if event not in self.hooks:
+            raise ValueError('Unsupported event specified, with event name "%s"' % (event))
+
+        if isinstance(hook, Callable):
+            self.hooks[event].append(hook)
+        elif hasattr(hook, '__iter__'):
+            self.hooks[event].extend(h for h in hook if isinstance(h, Callable))
+
+    def deregister_hook(self, event, hook):
+        """Deregister a previously registered hook.
+        Returns True if the hook existed, False if not.
+        """
+
+        try:
+            self.hooks[event].remove(hook)
+            return True
+        except ValueError:
+            return False
+
+
+class Request(RequestHooksMixin):
+    """A user-created :class:`Request <Request>` object.
+
+    Used to prepare a :class:`PreparedRequest <PreparedRequest>`, which is sent to the server.
+
+    :param method: HTTP method to use.
+    :param url: URL to send.
+    :param headers: dictionary of headers to send.
+    :param files: dictionary of {filename: fileobject} files to multipart upload.
+    :param data: the body to attach to the request. If a dictionary or
+        list of tuples ``[(key, value)]`` is provided, form-encoding will
+        take place.
+    :param json: json for the body to attach to the request (if files or data is not specified).
+    :param params: URL parameters to append to the URL. If a dictionary or
+        list of tuples ``[(key, value)]`` is provided, form-encoding will
+        take place.
+    :param auth: Auth handler or (user, pass) tuple.
+    :param cookies: dictionary or CookieJar of cookies to attach to this request.
+    :param hooks: dictionary of callback hooks, for internal usage.
+
+    Usage::
+
+      >>> import requests
+      >>> req = requests.Request('GET', 'https://httpbin.org/get')
+      >>> req.prepare()
+      <PreparedRequest [GET]>
+    """
+
+    def __init__(self,
+            method=None, url=None, headers=None, files=None, data=None,
+            params=None, auth=None, cookies=None, hooks=None, json=None):
+
+        # Default empty dicts for dict params.
+        data = [] if data is None else data
+        files = [] if files is None else files
+        headers = {} if headers is None else headers
+        params = {} if params is None else params
+        hooks = {} if hooks is None else hooks
+
+        self.hooks = default_hooks()
+        for (k, v) in list(hooks.items()):
+            self.register_hook(event=k, hook=v)
+
+        self.method = method
+        self.url = url
+        self.headers = headers
+        self.files = files
+        self.data = data
+        self.json = json
+        self.params = params
+        self.auth = auth
+        self.cookies = cookies
+
+    def __repr__(self):
+        return '<Request [%s]>' % (self.method)
+
+    def prepare(self):
+        """Constructs a :class:`PreparedRequest <PreparedRequest>` for transmission and returns it."""
+        p = PreparedRequest()
+        p.prepare(
+            method=self.method,
+            url=self.url,
+            headers=self.headers,
+            files=self.files,
+            data=self.data,
+            json=self.json,
+            params=self.params,
+            auth=self.auth,
+            cookies=self.cookies,
+            hooks=self.hooks,
+        )
+        return p
+
+
+class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
+    """The fully mutable :class:`PreparedRequest <PreparedRequest>` object,
+    containing the exact bytes that will be sent to the server.
+
+    Instances are generated from a :class:`Request <Request>` object, and
+    should not be instantiated manually; doing so may produce undesirable
+    effects.
+
+    Usage::
+
+      >>> import requests
+      >>> req = requests.Request('GET', 'https://httpbin.org/get')
+      >>> r = req.prepare()
+      >>> r
+      <PreparedRequest [GET]>
+
+      >>> s = requests.Session()
+      >>> s.send(r)
+      <Response [200]>
+    """
+
+    def __init__(self):
+        #: HTTP verb to send to the server.
+        self.method = None
+        #: HTTP URL to send the request to.
+        self.url = None
+        #: dictionary of HTTP headers.
+        self.headers = None
+        # The `CookieJar` used to create the Cookie header will be stored here
+        # after prepare_cookies is called
+        self._cookies = None
+        #: request body to send to the server.
+        self.body = None
+        #: dictionary of callback hooks, for internal usage.
+        self.hooks = default_hooks()
+        #: integer denoting starting position of a readable file-like body.
+        self._body_position = None
+
+    def prepare(self,
+            method=None, url=None, headers=None, files=None, data=None,
+            params=None, auth=None, cookies=None, hooks=None, json=None):
+        """Prepares the entire request with the given parameters."""
+
+        self.prepare_method(method)
+        self.prepare_url(url, params)
+        self.prepare_headers(headers)
+        self.prepare_cookies(cookies)
+        self.prepare_body(data, files, json)
+        self.prepare_auth(auth, url)
+
+        # Note that prepare_auth must be last to enable authentication schemes
+        # such as OAuth to work on a fully prepared request.
+
+        # This MUST go after prepare_auth. Authenticators could add a hook
+        self.prepare_hooks(hooks)
+
+    def __repr__(self):
+        return '<PreparedRequest [%s]>' % (self.method)
+
+    def copy(self):
+        p = PreparedRequest()
+        p.method = self.method
+        p.url = self.url
+        p.headers = self.headers.copy() if self.headers is not None else None
+        p._cookies = _copy_cookie_jar(self._cookies)
+        p.body = self.body
+        p.hooks = self.hooks
+        p._body_position = self._body_position
+        return p
+
+    def prepare_method(self, method):
+        """Prepares the given HTTP method."""
+        self.method = method
+        if self.method is not None:
+            self.method = to_native_string(self.method.upper())
+
+    @staticmethod
+    def _get_idna_encoded_host(host):
+        import idna
+
+        try:
+            host = idna.encode(host, uts46=True).decode('utf-8')
+        except idna.IDNAError:
+            raise UnicodeError
+        return host
+
+    def prepare_url(self, url, params):
+        """Prepares the given HTTP URL."""
+        #: Accept objects that have string representations.
+        #: We're unable to blindly call unicode/str functions
+        #: as this will include the bytestring indicator (b'')
+        #: on python 3.x.
+        #: https://github.com/psf/requests/pull/2238
+        if isinstance(url, bytes):
+            url = url.decode('utf8')
+        else:
+            url = unicode(url) if is_py2 else str(url)
+
+        # Remove leading whitespaces from url
+        url = url.lstrip()
+
+        # Don't do any URL preparation for non-HTTP schemes like `mailto`,
+        # `data` etc to work around exceptions from `url_parse`, which
+        # handles RFC 3986 only.
+        if ':' in url and not url.lower().startswith('http'):
+            self.url = url
+            return
+
+        # Support for unicode domain names and paths.
+        try:
+            scheme, auth, host, port, path, query, fragment = parse_url(url)
+        except LocationParseError as e:
+            raise InvalidURL(*e.args)
+
+        if not scheme:
+            error = ("Invalid URL {0!r}: No scheme supplied. Perhaps you meant http://{0}?")
+            error = error.format(to_native_string(url, 'utf8'))
+
+            raise MissingSchema(error)
+
+        if not host:
+            raise InvalidURL("Invalid URL %r: No host supplied" % url)
+
+        # In general, we want to try IDNA encoding the hostname if the string contains
+        # non-ASCII characters. This allows users to automatically get the correct IDNA
+        # behaviour. For strings containing only ASCII characters, we need to also verify
+        # it doesn't start with a wildcard (*), before allowing the unencoded hostname.
+        if not unicode_is_ascii(host):
+            try:
+                host = self._get_idna_encoded_host(host)
+            except UnicodeError:
+                raise InvalidURL('URL has an invalid label.')
+        elif host.startswith((u'*', u'.')):
+            raise InvalidURL('URL has an invalid label.')
+
+        # Carefully reconstruct the network location
+        netloc = auth or ''
+        if netloc:
+            netloc += '@'
+        netloc += host
+        if port:
+            netloc += ':' + str(port)
+
+        # Bare domains aren't valid URLs.
+        if not path:
+            path = '/'
+
+        if is_py2:
+            if isinstance(scheme, str):
+                scheme = scheme.encode('utf-8')
+            if isinstance(netloc, str):
+                netloc = netloc.encode('utf-8')
+            if isinstance(path, str):
+                path = path.encode('utf-8')
+            if isinstance(query, str):
+                query = query.encode('utf-8')
+            if isinstance(fragment, str):
+                fragment = fragment.encode('utf-8')
+
+        if isinstance(params, (str, bytes)):
+            params = to_native_string(params)
+
+        enc_params = self._encode_params(params)
+        if enc_params:
+            if query:
+                query = '%s&%s' % (query, enc_params)
+            else:
+                query = enc_params
+
+        url = requote_uri(urlunparse([scheme, netloc, path, None, query, fragment]))
+        self.url = url
+
+    def prepare_headers(self, headers):
+        """Prepares the given HTTP headers."""
+
+        self.headers = CaseInsensitiveDict()
+        if headers:
+            for header in headers.items():
+                # Raise exception on invalid header value.
+                check_header_validity(header)
+                name, value = header
+                self.headers[to_native_string(name)] = value
+
+    def prepare_body(self, data, files, json=None):
+        """Prepares the given HTTP body data."""
+
+        # Check if file, fo, generator, iterator.
+        # If not, run through normal process.
+
+        # Nottin' on you.
+        body = None
+        content_type = None
+
+        if not data and json is not None:
+            # urllib3 requires a bytes-like body. Python 2's json.dumps
+            # provides this natively, but Python 3 gives a Unicode string.
+            content_type = 'application/json'
+
+            try:
+                body = complexjson.dumps(json, allow_nan=False)
+            except ValueError as ve:
+                raise InvalidJSONError(ve, request=self)
+
+            if not isinstance(body, bytes):
+                body = body.encode('utf-8')
+
+        is_stream = all([
+            hasattr(data, '__iter__'),
+            not isinstance(data, (basestring, list, tuple, Mapping))
+        ])
+
+        if is_stream:
+            try:
+                length = super_len(data)
+            except (TypeError, AttributeError, UnsupportedOperation):
+                length = None
+
+            body = data
+
+            if getattr(body, 'tell', None) is not None:
+                # Record the current file position before reading.
+                # This will allow us to rewind a file in the event
+                # of a redirect.
+                try:
+                    self._body_position = body.tell()
+                except (IOError, OSError):
+                    # This differentiates from None, allowing us to catch
+                    # a failed `tell()` later when trying to rewind the body
+                    self._body_position = object()
+
+            if files:
+                raise NotImplementedError('Streamed bodies and files are mutually exclusive.')
+
+            if length:
+                self.headers['Content-Length'] = builtin_str(length)
+            else:
+                self.headers['Transfer-Encoding'] = 'chunked'
+        else:
+            # Multi-part file uploads.
+            if files:
+                (body, content_type) = self._encode_files(files, data)
+            else:
+                if data:
+                    body = self._encode_params(data)
+                    if isinstance(data, basestring) or hasattr(data, 'read'):
+                        content_type = None
+                    else:
+                        content_type = 'application/x-www-form-urlencoded'
+
+            self.prepare_content_length(body)
+
+            # Add content-type if it wasn't explicitly provided.
+            if content_type and ('content-type' not in self.headers):
+                self.headers['Content-Type'] = content_type
+
+        self.body = body
+
+    def prepare_content_length(self, body):
+        """Prepare Content-Length header based on request method and body"""
+        if body is not None:
+            length = super_len(body)
+            if length:
+                # If length exists, set it. Otherwise, we fallback
+                # to Transfer-Encoding: chunked.
+                self.headers['Content-Length'] = builtin_str(length)
+        elif self.method not in ('GET', 'HEAD') and self.headers.get('Content-Length') is None:
+            # Set Content-Length to 0 for methods that can have a body
+            # but don't provide one. (i.e. not GET or HEAD)
+            self.headers['Content-Length'] = '0'
+
+    def prepare_auth(self, auth, url=''):
+        """Prepares the given HTTP auth data."""
+
+        # If no Auth is explicitly provided, extract it from the URL first.
+        if auth is None:
+            url_auth = get_auth_from_url(self.url)
+            auth = url_auth if any(url_auth) else None
+
+        if auth:
+            if isinstance(auth, tuple) and len(auth) == 2:
+                # special-case basic HTTP auth
+                auth = HTTPBasicAuth(*auth)
+
+            # Allow auth to make its changes.
+            r = auth(self)
+
+            # Update self to reflect the auth changes.
+            self.__dict__.update(r.__dict__)
+
+            # Recompute Content-Length
+            self.prepare_content_length(self.body)
+
+    def prepare_cookies(self, cookies):
+        """Prepares the given HTTP cookie data.
+
+        This function eventually generates a ``Cookie`` header from the
+        given cookies using cookielib. Due to cookielib's design, the header
+        will not be regenerated if it already exists, meaning this function
+        can only be called once for the life of the
+        :class:`PreparedRequest <PreparedRequest>` object. Any subsequent calls
+        to ``prepare_cookies`` will have no actual effect, unless the "Cookie"
+        header is removed beforehand.
+        """
+        if isinstance(cookies, cookielib.CookieJar):
+            self._cookies = cookies
+        else:
+            self._cookies = cookiejar_from_dict(cookies)
+
+        cookie_header = get_cookie_header(self._cookies, self)
+        if cookie_header is not None:
+            self.headers['Cookie'] = cookie_header
+
+    def prepare_hooks(self, hooks):
+        """Prepares the given hooks."""
+        # hooks can be passed as None to the prepare method and to this
+        # method. To prevent iterating over None, simply use an empty list
+        # if hooks is False-y
+        hooks = hooks or []
+        for event in hooks:
+            self.register_hook(event, hooks[event])
+
+
+class Response(object):
+    """The :class:`Response <Response>` object, which contains a
+    server's response to an HTTP request.
+    """
+
+    __attrs__ = [
+        '_content', 'status_code', 'headers', 'url', 'history',
+        'encoding', 'reason', 'cookies', 'elapsed', 'request'
+    ]
+
+    def __init__(self):
+        self._content = False
+        self._content_consumed = False
+        self._next = None
+
+        #: Integer Code of responded HTTP Status, e.g. 404 or 200.
+        self.status_code = None
+
+        #: Case-insensitive Dictionary of Response Headers.
+        #: For example, ``headers['content-encoding']`` will return the
+        #: value of a ``'Content-Encoding'`` response header.
+        self.headers = CaseInsensitiveDict()
+
+        #: File-like object representation of response (for advanced usage).
+        #: Use of ``raw`` requires that ``stream=True`` be set on the request.
+        #: This requirement does not apply for use internally to Requests.
+        self.raw = None
+
+        #: Final URL location of Response.
+        self.url = None
+
+        #: Encoding to decode with when accessing r.text.
+        self.encoding = None
+
+        #: A list of :class:`Response <Response>` objects from
+        #: the history of the Request. Any redirect responses will end
+        #: up here. The list is sorted from the oldest to the most recent request.
+        self.history = []
+
+        #: Textual reason of responded HTTP Status, e.g. "Not Found" or "OK".
+        self.reason = None
+
+        #: A CookieJar of Cookies the server sent back.
+        self.cookies = cookiejar_from_dict({})
+
+        #: The amount of time elapsed between sending the request
+        #: and the arrival of the response (as a timedelta).
+        #: This property specifically measures the time taken between sending
+        #: the first byte of the request and finishing parsing the headers. It
+        #: is therefore unaffected by consuming the response content or the
+        #: value of the ``stream`` keyword argument.
+        self.elapsed = datetime.timedelta(0)
+
+        #: The :class:`PreparedRequest <PreparedRequest>` object to which this
+        #: is a response.
+        self.request = None
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
+
+    def __getstate__(self):
+        # Consume everything; accessing the content attribute makes
+        # sure the content has been fully read.
+        if not self._content_consumed:
+            self.content
+
+        return {attr: getattr(self, attr, None) for attr in self.__attrs__}
+
+    def __setstate__(self, state):
+        for name, value in state.items():
+            setattr(self, name, value)
+
+        # pickled objects do not have .raw
+        setattr(self, '_content_consumed', True)
+        setattr(self, 'raw', None)
+
+    def __repr__(self):
+        return '<Response [%s]>' % (self.status_code)
+
+    def __bool__(self):
+        """Returns True if :attr:`status_code` is less than 400.
+
+        This attribute checks if the status code of the response is between
+        400 and 600 to see if there was a client error or a server error. If
+        the status code, is between 200 and 400, this will return True. This
+        is **not** a check to see if the response code is ``200 OK``.
+        """
+        return self.ok
+
+    def __nonzero__(self):
+        """Returns True if :attr:`status_code` is less than 400.
+
+        This attribute checks if the status code of the response is between
+        400 and 600 to see if there was a client error or a server error. If
+        the status code, is between 200 and 400, this will return True. This
+        is **not** a check to see if the response code is ``200 OK``.
+        """
+        return self.ok
+
+    def __iter__(self):
+        """Allows you to use a response as an iterator."""
+        return self.iter_content(128)
+
+    @property
+    def ok(self):
+        """Returns True if :attr:`status_code` is less than 400, False if not.
+
+        This attribute checks if the status code of the response is between
+        400 and 600 to see if there was a client error or a server error. If
+        the status code is between 200 and 400, this will return True. This
+        is **not** a check to see if the response code is ``200 OK``.
+        """
+        try:
+            self.raise_for_status()
+        except HTTPError:
+            return False
+        return True
+
+    @property
+    def is_redirect(self):
+        """True if this Response is a well-formed HTTP redirect that could have
+        been processed automatically (by :meth:`Session.resolve_redirects`).
+        """
+        return ('location' in self.headers and self.status_code in REDIRECT_STATI)
+
+    @property
+    def is_permanent_redirect(self):
+        """True if this Response one of the permanent versions of redirect."""
+        return ('location' in self.headers and self.status_code in (codes.moved_permanently, codes.permanent_redirect))
+
+    @property
+    def next(self):
+        """Returns a PreparedRequest for the next request in a redirect chain, if there is one."""
+        return self._next
+
+    @property
+    def apparent_encoding(self):
+        """The apparent encoding, provided by the charset_normalizer or chardet libraries."""
+        return chardet.detect(self.content)['encoding']
+
+    def iter_content(self, chunk_size=1, decode_unicode=False):
+        """Iterates over the response data.  When stream=True is set on the
+        request, this avoids reading the content at once into memory for
+        large responses.  The chunk size is the number of bytes it should
+        read into memory.  This is not necessarily the length of each item
+        returned as decoding can take place.
+
+        chunk_size must be of type int or None. A value of None will
+        function differently depending on the value of `stream`.
+        stream=True will read data as it arrives in whatever size the
+        chunks are received. If stream=False, data is returned as
+        a single chunk.
+
+        If decode_unicode is True, content will be decoded using the best
+        available encoding based on the response.
+        """
+
+        def generate():
+            # Special case for urllib3.
+            if hasattr(self.raw, 'stream'):
+                try:
+                    for chunk in self.raw.stream(chunk_size, decode_content=True):
+                        yield chunk
+                except ProtocolError as e:
+                    raise ChunkedEncodingError(e)
+                except DecodeError as e:
+                    raise ContentDecodingError(e)
+                except ReadTimeoutError as e:
+                    raise ConnectionError(e)
+            else:
+                # Standard file-like object.
+                while True:
+                    chunk = self.raw.read(chunk_size)
+                    if not chunk:
+                        break
+                    yield chunk
+
+            self._content_consumed = True
+
+        if self._content_consumed and isinstance(self._content, bool):
+            raise StreamConsumedError()
+        elif chunk_size is not None and not isinstance(chunk_size, int):
+            raise TypeError("chunk_size must be an int, it is instead a %s." % type(chunk_size))
+        # simulate reading small chunks of the content
+        reused_chunks = iter_slices(self._content, chunk_size)
+
+        stream_chunks = generate()
+
+        chunks = reused_chunks if self._content_consumed else stream_chunks
+
+        if decode_unicode:
+            chunks = stream_decode_response_unicode(chunks, self)
+
+        return chunks
+
+    def iter_lines(self, chunk_size=ITER_CHUNK_SIZE, decode_unicode=False, delimiter=None):
+        """Iterates over the response data, one line at a time.  When
+        stream=True is set on the request, this avoids reading the
+        content at once into memory for large responses.
+
+        .. note:: This method is not reentrant safe.
+        """
+
+        pending = None
+
+        for chunk in self.iter_content(chunk_size=chunk_size, decode_unicode=decode_unicode):
+
+            if pending is not None:
+                chunk = pending + chunk
+
+            if delimiter:
+                lines = chunk.split(delimiter)
+            else:
+                lines = chunk.splitlines()
+
+            if lines and lines[-1] and chunk and lines[-1][-1] == chunk[-1]:
+                pending = lines.pop()
+            else:
+                pending = None
+
+            for line in lines:
+                yield line
+
+        if pending is not None:
+            yield pending
+
+    @property
+    def content(self):
+        """Content of the response, in bytes."""
+
+        if self._content is False:
+            # Read the contents.
+            if self._content_consumed:
+                raise RuntimeError(
+                    'The content for this response was already consumed')
+
+            if self.status_code == 0 or self.raw is None:
+                self._content = None
+            else:
+                self._content = b''.join(self.iter_content(CONTENT_CHUNK_SIZE)) or b''
+
+        self._content_consumed = True
+        # don't need to release the connection; that's been handled by urllib3
+        # since we exhausted the data.
+        return self._content
+
+    @property
+    def text(self):
+        """Content of the response, in unicode.
+
+        If Response.encoding is None, encoding will be guessed using
+        ``charset_normalizer`` or ``chardet``.
+
+        The encoding of the response content is determined based solely on HTTP
+        headers, following RFC 2616 to the letter. If you can take advantage of
+        non-HTTP knowledge to make a better guess at the encoding, you should
+        set ``r.encoding`` appropriately before accessing this property.
+        """
+
+        # Try charset from content-type
+        content = None
+        encoding = self.encoding
+
+        if not self.content:
+            return str('')
+
+        # Fallback to auto-detected encoding.
+        if self.encoding is None:
+            encoding = self.apparent_encoding
+
+        # Decode unicode from given encoding.
+        try:
+            content = str(self.content, encoding, errors='replace')
+        except (LookupError, TypeError):
+            # A LookupError is raised if the encoding was not found which could
+            # indicate a misspelling or similar mistake.
+            #
+            # A TypeError can be raised if encoding is None
+            #
+            # So we try blindly encoding.
+            content = str(self.content, errors='replace')
+
+        return content
+
+    def json(self, **kwargs):
+        r"""Returns the json-encoded content of a response, if any.
+
+        :param \*\*kwargs: Optional arguments that ``json.loads`` takes.
+        :raises requests.exceptions.JSONDecodeError: If the response body does not
+            contain valid json.
+        """
+
+        if not self.encoding and self.content and len(self.content) > 3:
+            # No encoding set. JSON RFC 4627 section 3 states we should expect
+            # UTF-8, -16 or -32. Detect which one to use; If the detection or
+            # decoding fails, fall back to `self.text` (using charset_normalizer to make
+            # a best guess).
+            encoding = guess_json_utf(self.content)
+            if encoding is not None:
+                try:
+                    return complexjson.loads(
+                        self.content.decode(encoding), **kwargs
+                    )
+                except UnicodeDecodeError:
+                    # Wrong UTF codec detected; usually because it's not UTF-8
+                    # but some other 8-bit codec.  This is an RFC violation,
+                    # and the server didn't bother to tell us what codec *was*
+                    # used.
+                    pass
+
+        try:
+            return complexjson.loads(self.text, **kwargs)
+        except JSONDecodeError as e:
+            # Catch JSON-related errors and raise as requests.JSONDecodeError
+            # This aliases json.JSONDecodeError and simplejson.JSONDecodeError
+            if is_py2: # e is a ValueError
+                raise RequestsJSONDecodeError(e.message)
+            else:
+                raise RequestsJSONDecodeError(e.msg, e.doc, e.pos)
+
+    @property
+    def links(self):
+        """Returns the parsed header links of the response, if any."""
+
+        header = self.headers.get('link')
+
+        # l = MultiDict()
+        l = {}
+
+        if header:
+            links = parse_header_links(header)
+
+            for link in links:
+                key = link.get('rel') or link.get('url')
+                l[key] = link
+
+        return l
+
+    def raise_for_status(self):
+        """Raises :class:`HTTPError`, if one occurred."""
+
+        http_error_msg = ''
+        if isinstance(self.reason, bytes):
+            # We attempt to decode utf-8 first because some servers
+            # choose to localize their reason strings. If the string
+            # isn't utf-8, we fall back to iso-8859-1 for all other
+            # encodings. (See PR #3538)
+            try:
+                reason = self.reason.decode('utf-8')
+            except UnicodeDecodeError:
+                reason = self.reason.decode('iso-8859-1')
+        else:
+            reason = self.reason
+
+        if 400 <= self.status_code < 500:
+            http_error_msg = u'%s Client Error: %s for url: %s' % (self.status_code, reason, self.url)
+
+        elif 500 <= self.status_code < 600:
+            http_error_msg = u'%s Server Error: %s for url: %s' % (self.status_code, reason, self.url)
+
+        if http_error_msg:
+            raise HTTPError(http_error_msg, response=self)
+
+    def close(self):
+        """Releases the connection back to the pool. Once this method has been
+        called the underlying ``raw`` object must not be accessed again.
+
+        *Note: Should not normally need to be called explicitly.*
+        """
+        if not self._content_consumed:
+            self.raw.close()
+
+        release_conn = getattr(self.raw, 'release_conn', None)
+        if release_conn is not None:
+            release_conn()
diff --git a/openpype/vendor/python/python_2/requests/packages.py b/openpype/vendor/python/python_2/requests/packages.py
new file mode 100644
index 0000000000..00196bff25
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/packages.py
@@ -0,0 +1,26 @@
+import sys
+
+try:
+    import chardet
+except ImportError:
+    import charset_normalizer as chardet
+    import warnings
+
+    warnings.filterwarnings('ignore', 'Trying to detect', module='charset_normalizer')
+
+# This code exists for backwards compatibility reasons.
+# I don't like it either. Just look the other way. :)
+
+for package in ('urllib3', 'idna'):
+    locals()[package] = __import__(package)
+    # This traversal is apparently necessary such that the identities are
+    # preserved (requests.packages.urllib3.* is urllib3.*)
+    for mod in list(sys.modules):
+        if mod == package or mod.startswith(package + '.'):
+            sys.modules['requests.packages.' + mod] = sys.modules[mod]
+
+target = chardet.__name__
+for mod in list(sys.modules):
+    if mod == target or mod.startswith(target + '.'):
+        sys.modules['requests.packages.' + target.replace(target, 'chardet')] = sys.modules[mod]
+# Kinda cool, though, right?
diff --git a/openpype/vendor/python/python_2/requests/sessions.py b/openpype/vendor/python/python_2/requests/sessions.py
new file mode 100644
index 0000000000..3f59cab922
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/sessions.py
@@ -0,0 +1,771 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.sessions
+~~~~~~~~~~~~~~~~~
+
+This module provides a Session object to manage and persist settings across
+requests (cookies, auth, proxies).
+"""
+import os
+import sys
+import time
+from datetime import timedelta
+from collections import OrderedDict
+
+from .auth import _basic_auth_str
+from .compat import cookielib, is_py3, urljoin, urlparse, Mapping
+from .cookies import (
+    cookiejar_from_dict, extract_cookies_to_jar, RequestsCookieJar, merge_cookies)
+from .models import Request, PreparedRequest, DEFAULT_REDIRECT_LIMIT
+from .hooks import default_hooks, dispatch_hook
+from ._internal_utils import to_native_string
+from .utils import to_key_val_list, default_headers, DEFAULT_PORTS
+from .exceptions import (
+    TooManyRedirects, InvalidSchema, ChunkedEncodingError, ContentDecodingError)
+
+from .structures import CaseInsensitiveDict
+from .adapters import HTTPAdapter
+
+from .utils import (
+    requote_uri, get_environ_proxies, get_netrc_auth, should_bypass_proxies,
+    get_auth_from_url, rewind_body, resolve_proxies
+)
+
+from .status_codes import codes
+
+# formerly defined here, reexposed here for backward compatibility
+from .models import REDIRECT_STATI
+
+# Preferred clock, based on which one is more accurate on a given system.
+if sys.platform == 'win32':
+    try:  # Python 3.4+
+        preferred_clock = time.perf_counter
+    except AttributeError:  # Earlier than Python 3.
+        preferred_clock = time.clock
+else:
+    preferred_clock = time.time
+
+
+def merge_setting(request_setting, session_setting, dict_class=OrderedDict):
+    """Determines appropriate setting for a given request, taking into account
+    the explicit setting on that request, and the setting in the session. If a
+    setting is a dictionary, they will be merged together using `dict_class`
+    """
+
+    if session_setting is None:
+        return request_setting
+
+    if request_setting is None:
+        return session_setting
+
+    # Bypass if not a dictionary (e.g. verify)
+    if not (
+            isinstance(session_setting, Mapping) and
+            isinstance(request_setting, Mapping)
+    ):
+        return request_setting
+
+    merged_setting = dict_class(to_key_val_list(session_setting))
+    merged_setting.update(to_key_val_list(request_setting))
+
+    # Remove keys that are set to None. Extract keys first to avoid altering
+    # the dictionary during iteration.
+    none_keys = [k for (k, v) in merged_setting.items() if v is None]
+    for key in none_keys:
+        del merged_setting[key]
+
+    return merged_setting
+
+
+def merge_hooks(request_hooks, session_hooks, dict_class=OrderedDict):
+    """Properly merges both requests and session hooks.
+
+    This is necessary because when request_hooks == {'response': []}, the
+    merge breaks Session hooks entirely.
+    """
+    if session_hooks is None or session_hooks.get('response') == []:
+        return request_hooks
+
+    if request_hooks is None or request_hooks.get('response') == []:
+        return session_hooks
+
+    return merge_setting(request_hooks, session_hooks, dict_class)
+
+
+class SessionRedirectMixin(object):
+
+    def get_redirect_target(self, resp):
+        """Receives a Response. Returns a redirect URI or ``None``"""
+        # Due to the nature of how requests processes redirects this method will
+        # be called at least once upon the original response and at least twice
+        # on each subsequent redirect response (if any).
+        # If a custom mixin is used to handle this logic, it may be advantageous
+        # to cache the redirect location onto the response object as a private
+        # attribute.
+        if resp.is_redirect:
+            location = resp.headers['location']
+            # Currently the underlying http module on py3 decode headers
+            # in latin1, but empirical evidence suggests that latin1 is very
+            # rarely used with non-ASCII characters in HTTP headers.
+            # It is more likely to get UTF8 header rather than latin1.
+            # This causes incorrect handling of UTF8 encoded location headers.
+            # To solve this, we re-encode the location in latin1.
+            if is_py3:
+                location = location.encode('latin1')
+            return to_native_string(location, 'utf8')
+        return None
+
+    def should_strip_auth(self, old_url, new_url):
+        """Decide whether Authorization header should be removed when redirecting"""
+        old_parsed = urlparse(old_url)
+        new_parsed = urlparse(new_url)
+        if old_parsed.hostname != new_parsed.hostname:
+            return True
+        # Special case: allow http -> https redirect when using the standard
+        # ports. This isn't specified by RFC 7235, but is kept to avoid
+        # breaking backwards compatibility with older versions of requests
+        # that allowed any redirects on the same host.
+        if (old_parsed.scheme == 'http' and old_parsed.port in (80, None)
+                and new_parsed.scheme == 'https' and new_parsed.port in (443, None)):
+            return False
+
+        # Handle default port usage corresponding to scheme.
+        changed_port = old_parsed.port != new_parsed.port
+        changed_scheme = old_parsed.scheme != new_parsed.scheme
+        default_port = (DEFAULT_PORTS.get(old_parsed.scheme, None), None)
+        if (not changed_scheme and old_parsed.port in default_port
+                and new_parsed.port in default_port):
+            return False
+
+        # Standard case: root URI must match
+        return changed_port or changed_scheme
+
+    def resolve_redirects(self, resp, req, stream=False, timeout=None,
+                          verify=True, cert=None, proxies=None, yield_requests=False, **adapter_kwargs):
+        """Receives a Response. Returns a generator of Responses or Requests."""
+
+        hist = []  # keep track of history
+
+        url = self.get_redirect_target(resp)
+        previous_fragment = urlparse(req.url).fragment
+        while url:
+            prepared_request = req.copy()
+
+            # Update history and keep track of redirects.
+            # resp.history must ignore the original request in this loop
+            hist.append(resp)
+            resp.history = hist[1:]
+
+            try:
+                resp.content  # Consume socket so it can be released
+            except (ChunkedEncodingError, ContentDecodingError, RuntimeError):
+                resp.raw.read(decode_content=False)
+
+            if len(resp.history) >= self.max_redirects:
+                raise TooManyRedirects('Exceeded {} redirects.'.format(self.max_redirects), response=resp)
+
+            # Release the connection back into the pool.
+            resp.close()
+
+            # Handle redirection without scheme (see: RFC 1808 Section 4)
+            if url.startswith('//'):
+                parsed_rurl = urlparse(resp.url)
+                url = ':'.join([to_native_string(parsed_rurl.scheme), url])
+
+            # Normalize url case and attach previous fragment if needed (RFC 7231 7.1.2)
+            parsed = urlparse(url)
+            if parsed.fragment == '' and previous_fragment:
+                parsed = parsed._replace(fragment=previous_fragment)
+            elif parsed.fragment:
+                previous_fragment = parsed.fragment
+            url = parsed.geturl()
+
+            # Facilitate relative 'location' headers, as allowed by RFC 7231.
+            # (e.g. '/path/to/resource' instead of 'http://domain.tld/path/to/resource')
+            # Compliant with RFC3986, we percent encode the url.
+            if not parsed.netloc:
+                url = urljoin(resp.url, requote_uri(url))
+            else:
+                url = requote_uri(url)
+
+            prepared_request.url = to_native_string(url)
+
+            self.rebuild_method(prepared_request, resp)
+
+            # https://github.com/psf/requests/issues/1084
+            if resp.status_code not in (codes.temporary_redirect, codes.permanent_redirect):
+                # https://github.com/psf/requests/issues/3490
+                purged_headers = ('Content-Length', 'Content-Type', 'Transfer-Encoding')
+                for header in purged_headers:
+                    prepared_request.headers.pop(header, None)
+                prepared_request.body = None
+
+            headers = prepared_request.headers
+            headers.pop('Cookie', None)
+
+            # Extract any cookies sent on the response to the cookiejar
+            # in the new request. Because we've mutated our copied prepared
+            # request, use the old one that we haven't yet touched.
+            extract_cookies_to_jar(prepared_request._cookies, req, resp.raw)
+            merge_cookies(prepared_request._cookies, self.cookies)
+            prepared_request.prepare_cookies(prepared_request._cookies)
+
+            # Rebuild auth and proxy information.
+            proxies = self.rebuild_proxies(prepared_request, proxies)
+            self.rebuild_auth(prepared_request, resp)
+
+            # A failed tell() sets `_body_position` to `object()`. This non-None
+            # value ensures `rewindable` will be True, allowing us to raise an
+            # UnrewindableBodyError, instead of hanging the connection.
+            rewindable = (
+                prepared_request._body_position is not None and
+                ('Content-Length' in headers or 'Transfer-Encoding' in headers)
+            )
+
+            # Attempt to rewind consumed file-like object.
+            if rewindable:
+                rewind_body(prepared_request)
+
+            # Override the original request.
+            req = prepared_request
+
+            if yield_requests:
+                yield req
+            else:
+
+                resp = self.send(
+                    req,
+                    stream=stream,
+                    timeout=timeout,
+                    verify=verify,
+                    cert=cert,
+                    proxies=proxies,
+                    allow_redirects=False,
+                    **adapter_kwargs
+                )
+
+                extract_cookies_to_jar(self.cookies, prepared_request, resp.raw)
+
+                # extract redirect url, if any, for the next loop
+                url = self.get_redirect_target(resp)
+                yield resp
+
+    def rebuild_auth(self, prepared_request, response):
+        """When being redirected we may want to strip authentication from the
+        request to avoid leaking credentials. This method intelligently removes
+        and reapplies authentication where possible to avoid credential loss.
+        """
+        headers = prepared_request.headers
+        url = prepared_request.url
+
+        if 'Authorization' in headers and self.should_strip_auth(response.request.url, url):
+            # If we get redirected to a new host, we should strip out any
+            # authentication headers.
+            del headers['Authorization']
+
+        # .netrc might have more auth for us on our new host.
+        new_auth = get_netrc_auth(url) if self.trust_env else None
+        if new_auth is not None:
+            prepared_request.prepare_auth(new_auth)
+
+    def rebuild_proxies(self, prepared_request, proxies):
+        """This method re-evaluates the proxy configuration by considering the
+        environment variables. If we are redirected to a URL covered by
+        NO_PROXY, we strip the proxy configuration. Otherwise, we set missing
+        proxy keys for this URL (in case they were stripped by a previous
+        redirect).
+
+        This method also replaces the Proxy-Authorization header where
+        necessary.
+
+        :rtype: dict
+        """
+        headers = prepared_request.headers
+        scheme = urlparse(prepared_request.url).scheme
+        new_proxies = resolve_proxies(prepared_request, proxies, self.trust_env)
+
+        if 'Proxy-Authorization' in headers:
+            del headers['Proxy-Authorization']
+
+        try:
+            username, password = get_auth_from_url(new_proxies[scheme])
+        except KeyError:
+            username, password = None, None
+
+        if username and password:
+            headers['Proxy-Authorization'] = _basic_auth_str(username, password)
+
+        return new_proxies
+
+    def rebuild_method(self, prepared_request, response):
+        """When being redirected we may want to change the method of the request
+        based on certain specs or browser behavior.
+        """
+        method = prepared_request.method
+
+        # https://tools.ietf.org/html/rfc7231#section-6.4.4
+        if response.status_code == codes.see_other and method != 'HEAD':
+            method = 'GET'
+
+        # Do what the browsers do, despite standards...
+        # First, turn 302s into GETs.
+        if response.status_code == codes.found and method != 'HEAD':
+            method = 'GET'
+
+        # Second, if a POST is responded to with a 301, turn it into a GET.
+        # This bizarre behaviour is explained in Issue 1704.
+        if response.status_code == codes.moved and method == 'POST':
+            method = 'GET'
+
+        prepared_request.method = method
+
+
+class Session(SessionRedirectMixin):
+    """A Requests session.
+
+    Provides cookie persistence, connection-pooling, and configuration.
+
+    Basic Usage::
+
+      >>> import requests
+      >>> s = requests.Session()
+      >>> s.get('https://httpbin.org/get')
+      <Response [200]>
+
+    Or as a context manager::
+
+      >>> with requests.Session() as s:
+      ...     s.get('https://httpbin.org/get')
+      <Response [200]>
+    """
+
+    __attrs__ = [
+        'headers', 'cookies', 'auth', 'proxies', 'hooks', 'params', 'verify',
+        'cert', 'adapters', 'stream', 'trust_env',
+        'max_redirects',
+    ]
+
+    def __init__(self):
+
+        #: A case-insensitive dictionary of headers to be sent on each
+        #: :class:`Request <Request>` sent from this
+        #: :class:`Session <Session>`.
+        self.headers = default_headers()
+
+        #: Default Authentication tuple or object to attach to
+        #: :class:`Request <Request>`.
+        self.auth = None
+
+        #: Dictionary mapping protocol or protocol and host to the URL of the proxy
+        #: (e.g. {'http': 'foo.bar:3128', 'http://host.name': 'foo.bar:4012'}) to
+        #: be used on each :class:`Request <Request>`.
+        self.proxies = {}
+
+        #: Event-handling hooks.
+        self.hooks = default_hooks()
+
+        #: Dictionary of querystring data to attach to each
+        #: :class:`Request <Request>`. The dictionary values may be lists for
+        #: representing multivalued query parameters.
+        self.params = {}
+
+        #: Stream response content default.
+        self.stream = False
+
+        #: SSL Verification default.
+        #: Defaults to `True`, requiring requests to verify the TLS certificate at the
+        #: remote end.
+        #: If verify is set to `False`, requests will accept any TLS certificate
+        #: presented by the server, and will ignore hostname mismatches and/or
+        #: expired certificates, which will make your application vulnerable to
+        #: man-in-the-middle (MitM) attacks.
+        #: Only set this to `False` for testing.
+        self.verify = True
+
+        #: SSL client certificate default, if String, path to ssl client
+        #: cert file (.pem). If Tuple, ('cert', 'key') pair.
+        self.cert = None
+
+        #: Maximum number of redirects allowed. If the request exceeds this
+        #: limit, a :class:`TooManyRedirects` exception is raised.
+        #: This defaults to requests.models.DEFAULT_REDIRECT_LIMIT, which is
+        #: 30.
+        self.max_redirects = DEFAULT_REDIRECT_LIMIT
+
+        #: Trust environment settings for proxy configuration, default
+        #: authentication and similar.
+        self.trust_env = True
+
+        #: A CookieJar containing all currently outstanding cookies set on this
+        #: session. By default it is a
+        #: :class:`RequestsCookieJar <requests.cookies.RequestsCookieJar>`, but
+        #: may be any other ``cookielib.CookieJar`` compatible object.
+        self.cookies = cookiejar_from_dict({})
+
+        # Default connection adapters.
+        self.adapters = OrderedDict()
+        self.mount('https://', HTTPAdapter())
+        self.mount('http://', HTTPAdapter())
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
+
+    def prepare_request(self, request):
+        """Constructs a :class:`PreparedRequest <PreparedRequest>` for
+        transmission and returns it. The :class:`PreparedRequest` has settings
+        merged from the :class:`Request <Request>` instance and those of the
+        :class:`Session`.
+
+        :param request: :class:`Request` instance to prepare with this
+            session's settings.
+        :rtype: requests.PreparedRequest
+        """
+        cookies = request.cookies or {}
+
+        # Bootstrap CookieJar.
+        if not isinstance(cookies, cookielib.CookieJar):
+            cookies = cookiejar_from_dict(cookies)
+
+        # Merge with session cookies
+        merged_cookies = merge_cookies(
+            merge_cookies(RequestsCookieJar(), self.cookies), cookies)
+
+        # Set environment's basic authentication if not explicitly set.
+        auth = request.auth
+        if self.trust_env and not auth and not self.auth:
+            auth = get_netrc_auth(request.url)
+
+        p = PreparedRequest()
+        p.prepare(
+            method=request.method.upper(),
+            url=request.url,
+            files=request.files,
+            data=request.data,
+            json=request.json,
+            headers=merge_setting(request.headers, self.headers, dict_class=CaseInsensitiveDict),
+            params=merge_setting(request.params, self.params),
+            auth=merge_setting(auth, self.auth),
+            cookies=merged_cookies,
+            hooks=merge_hooks(request.hooks, self.hooks),
+        )
+        return p
+
+    def request(self, method, url,
+            params=None, data=None, headers=None, cookies=None, files=None,
+            auth=None, timeout=None, allow_redirects=True, proxies=None,
+            hooks=None, stream=None, verify=None, cert=None, json=None):
+        """Constructs a :class:`Request <Request>`, prepares it and sends it.
+        Returns :class:`Response <Response>` object.
+
+        :param method: method for the new :class:`Request` object.
+        :param url: URL for the new :class:`Request` object.
+        :param params: (optional) Dictionary or bytes to be sent in the query
+            string for the :class:`Request`.
+        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+            object to send in the body of the :class:`Request`.
+        :param json: (optional) json to send in the body of the
+            :class:`Request`.
+        :param headers: (optional) Dictionary of HTTP Headers to send with the
+            :class:`Request`.
+        :param cookies: (optional) Dict or CookieJar object to send with the
+            :class:`Request`.
+        :param files: (optional) Dictionary of ``'filename': file-like-objects``
+            for multipart encoding upload.
+        :param auth: (optional) Auth tuple or callable to enable
+            Basic/Digest/Custom HTTP Auth.
+        :param timeout: (optional) How long to wait for the server to send
+            data before giving up, as a float, or a :ref:`(connect timeout,
+            read timeout) <timeouts>` tuple.
+        :type timeout: float or tuple
+        :param allow_redirects: (optional) Set to True by default.
+        :type allow_redirects: bool
+        :param proxies: (optional) Dictionary mapping protocol or protocol and
+            hostname to the URL of the proxy.
+        :param stream: (optional) whether to immediately download the response
+            content. Defaults to ``False``.
+        :param verify: (optional) Either a boolean, in which case it controls whether we verify
+            the server's TLS certificate, or a string, in which case it must be a path
+            to a CA bundle to use. Defaults to ``True``. When set to
+            ``False``, requests will accept any TLS certificate presented by
+            the server, and will ignore hostname mismatches and/or expired
+            certificates, which will make your application vulnerable to
+            man-in-the-middle (MitM) attacks. Setting verify to ``False`` 
+            may be useful during local development or testing.
+        :param cert: (optional) if String, path to ssl client cert file (.pem).
+            If Tuple, ('cert', 'key') pair.
+        :rtype: requests.Response
+        """
+        # Create the Request.
+        req = Request(
+            method=method.upper(),
+            url=url,
+            headers=headers,
+            files=files,
+            data=data or {},
+            json=json,
+            params=params or {},
+            auth=auth,
+            cookies=cookies,
+            hooks=hooks,
+        )
+        prep = self.prepare_request(req)
+
+        proxies = proxies or {}
+
+        settings = self.merge_environment_settings(
+            prep.url, proxies, stream, verify, cert
+        )
+
+        # Send the request.
+        send_kwargs = {
+            'timeout': timeout,
+            'allow_redirects': allow_redirects,
+        }
+        send_kwargs.update(settings)
+        resp = self.send(prep, **send_kwargs)
+
+        return resp
+
+    def get(self, url, **kwargs):
+        r"""Sends a GET request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        kwargs.setdefault('allow_redirects', True)
+        return self.request('GET', url, **kwargs)
+
+    def options(self, url, **kwargs):
+        r"""Sends a OPTIONS request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        kwargs.setdefault('allow_redirects', True)
+        return self.request('OPTIONS', url, **kwargs)
+
+    def head(self, url, **kwargs):
+        r"""Sends a HEAD request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        kwargs.setdefault('allow_redirects', False)
+        return self.request('HEAD', url, **kwargs)
+
+    def post(self, url, data=None, json=None, **kwargs):
+        r"""Sends a POST request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+            object to send in the body of the :class:`Request`.
+        :param json: (optional) json to send in the body of the :class:`Request`.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        return self.request('POST', url, data=data, json=json, **kwargs)
+
+    def put(self, url, data=None, **kwargs):
+        r"""Sends a PUT request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+            object to send in the body of the :class:`Request`.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        return self.request('PUT', url, data=data, **kwargs)
+
+    def patch(self, url, data=None, **kwargs):
+        r"""Sends a PATCH request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+            object to send in the body of the :class:`Request`.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        return self.request('PATCH', url, data=data, **kwargs)
+
+    def delete(self, url, **kwargs):
+        r"""Sends a DELETE request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        return self.request('DELETE', url, **kwargs)
+
+    def send(self, request, **kwargs):
+        """Send a given PreparedRequest.
+
+        :rtype: requests.Response
+        """
+        # Set defaults that the hooks can utilize to ensure they always have
+        # the correct parameters to reproduce the previous request.
+        kwargs.setdefault('stream', self.stream)
+        kwargs.setdefault('verify', self.verify)
+        kwargs.setdefault('cert', self.cert)
+        if 'proxies' not in kwargs:
+            kwargs['proxies'] = resolve_proxies(
+                request, self.proxies, self.trust_env
+            )
+
+        # It's possible that users might accidentally send a Request object.
+        # Guard against that specific failure case.
+        if isinstance(request, Request):
+            raise ValueError('You can only send PreparedRequests.')
+
+        # Set up variables needed for resolve_redirects and dispatching of hooks
+        allow_redirects = kwargs.pop('allow_redirects', True)
+        stream = kwargs.get('stream')
+        hooks = request.hooks
+
+        # Get the appropriate adapter to use
+        adapter = self.get_adapter(url=request.url)
+
+        # Start time (approximately) of the request
+        start = preferred_clock()
+
+        # Send the request
+        r = adapter.send(request, **kwargs)
+
+        # Total elapsed time of the request (approximately)
+        elapsed = preferred_clock() - start
+        r.elapsed = timedelta(seconds=elapsed)
+
+        # Response manipulation hooks
+        r = dispatch_hook('response', hooks, r, **kwargs)
+
+        # Persist cookies
+        if r.history:
+
+            # If the hooks create history then we want those cookies too
+            for resp in r.history:
+                extract_cookies_to_jar(self.cookies, resp.request, resp.raw)
+
+        extract_cookies_to_jar(self.cookies, request, r.raw)
+
+        # Resolve redirects if allowed.
+        if allow_redirects:
+            # Redirect resolving generator.
+            gen = self.resolve_redirects(r, request, **kwargs)
+            history = [resp for resp in gen]
+        else:
+            history = []
+
+        # Shuffle things around if there's history.
+        if history:
+            # Insert the first (original) request at the start
+            history.insert(0, r)
+            # Get the last request made
+            r = history.pop()
+            r.history = history
+
+        # If redirects aren't being followed, store the response on the Request for Response.next().
+        if not allow_redirects:
+            try:
+                r._next = next(self.resolve_redirects(r, request, yield_requests=True, **kwargs))
+            except StopIteration:
+                pass
+
+        if not stream:
+            r.content
+
+        return r
+
+    def merge_environment_settings(self, url, proxies, stream, verify, cert):
+        """
+        Check the environment and merge it with some settings.
+
+        :rtype: dict
+        """
+        # Gather clues from the surrounding environment.
+        if self.trust_env:
+            # Set environment's proxies.
+            no_proxy = proxies.get('no_proxy') if proxies is not None else None
+            env_proxies = get_environ_proxies(url, no_proxy=no_proxy)
+            for (k, v) in env_proxies.items():
+                proxies.setdefault(k, v)
+
+            # Look for requests environment configuration and be compatible
+            # with cURL.
+            if verify is True or verify is None:
+                verify = (os.environ.get('REQUESTS_CA_BUNDLE') or
+                          os.environ.get('CURL_CA_BUNDLE'))
+
+        # Merge all the kwargs.
+        proxies = merge_setting(proxies, self.proxies)
+        stream = merge_setting(stream, self.stream)
+        verify = merge_setting(verify, self.verify)
+        cert = merge_setting(cert, self.cert)
+
+        return {'verify': verify, 'proxies': proxies, 'stream': stream,
+                'cert': cert}
+
+    def get_adapter(self, url):
+        """
+        Returns the appropriate connection adapter for the given URL.
+
+        :rtype: requests.adapters.BaseAdapter
+        """
+        for (prefix, adapter) in self.adapters.items():
+
+            if url.lower().startswith(prefix.lower()):
+                return adapter
+
+        # Nothing matches :-/
+        raise InvalidSchema("No connection adapters were found for {!r}".format(url))
+
+    def close(self):
+        """Closes all adapters and as such the session"""
+        for v in self.adapters.values():
+            v.close()
+
+    def mount(self, prefix, adapter):
+        """Registers a connection adapter to a prefix.
+
+        Adapters are sorted in descending order by prefix length.
+        """
+        self.adapters[prefix] = adapter
+        keys_to_move = [k for k in self.adapters if len(k) < len(prefix)]
+
+        for key in keys_to_move:
+            self.adapters[key] = self.adapters.pop(key)
+
+    def __getstate__(self):
+        state = {attr: getattr(self, attr, None) for attr in self.__attrs__}
+        return state
+
+    def __setstate__(self, state):
+        for attr, value in state.items():
+            setattr(self, attr, value)
+
+
+def session():
+    """
+    Returns a :class:`Session` for context-management.
+
+    .. deprecated:: 1.0.0
+
+        This method has been deprecated since version 1.0.0 and is only kept for
+        backwards compatibility. New code should use :class:`~requests.sessions.Session`
+        to create a session. This may be removed at a future date.
+
+    :rtype: Session
+    """
+    return Session()
diff --git a/openpype/vendor/python/python_2/requests/status_codes.py b/openpype/vendor/python/python_2/requests/status_codes.py
new file mode 100644
index 0000000000..d80a7cd4dd
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/status_codes.py
@@ -0,0 +1,123 @@
+# -*- coding: utf-8 -*-
+
+r"""
+The ``codes`` object defines a mapping from common names for HTTP statuses
+to their numerical codes, accessible either as attributes or as dictionary
+items.
+
+Example::
+
+    >>> import requests
+    >>> requests.codes['temporary_redirect']
+    307
+    >>> requests.codes.teapot
+    418
+    >>> requests.codes['\o/']
+    200
+
+Some codes have multiple names, and both upper- and lower-case versions of
+the names are allowed. For example, ``codes.ok``, ``codes.OK``, and
+``codes.okay`` all correspond to the HTTP status code 200.
+"""
+
+from .structures import LookupDict
+
+_codes = {
+
+    # Informational.
+    100: ('continue',),
+    101: ('switching_protocols',),
+    102: ('processing',),
+    103: ('checkpoint',),
+    122: ('uri_too_long', 'request_uri_too_long'),
+    200: ('ok', 'okay', 'all_ok', 'all_okay', 'all_good', '\\o/', '✓'),
+    201: ('created',),
+    202: ('accepted',),
+    203: ('non_authoritative_info', 'non_authoritative_information'),
+    204: ('no_content',),
+    205: ('reset_content', 'reset'),
+    206: ('partial_content', 'partial'),
+    207: ('multi_status', 'multiple_status', 'multi_stati', 'multiple_stati'),
+    208: ('already_reported',),
+    226: ('im_used',),
+
+    # Redirection.
+    300: ('multiple_choices',),
+    301: ('moved_permanently', 'moved', '\\o-'),
+    302: ('found',),
+    303: ('see_other', 'other'),
+    304: ('not_modified',),
+    305: ('use_proxy',),
+    306: ('switch_proxy',),
+    307: ('temporary_redirect', 'temporary_moved', 'temporary'),
+    308: ('permanent_redirect',
+          'resume_incomplete', 'resume',),  # These 2 to be removed in 3.0
+
+    # Client Error.
+    400: ('bad_request', 'bad'),
+    401: ('unauthorized',),
+    402: ('payment_required', 'payment'),
+    403: ('forbidden',),
+    404: ('not_found', '-o-'),
+    405: ('method_not_allowed', 'not_allowed'),
+    406: ('not_acceptable',),
+    407: ('proxy_authentication_required', 'proxy_auth', 'proxy_authentication'),
+    408: ('request_timeout', 'timeout'),
+    409: ('conflict',),
+    410: ('gone',),
+    411: ('length_required',),
+    412: ('precondition_failed', 'precondition'),
+    413: ('request_entity_too_large',),
+    414: ('request_uri_too_large',),
+    415: ('unsupported_media_type', 'unsupported_media', 'media_type'),
+    416: ('requested_range_not_satisfiable', 'requested_range', 'range_not_satisfiable'),
+    417: ('expectation_failed',),
+    418: ('im_a_teapot', 'teapot', 'i_am_a_teapot'),
+    421: ('misdirected_request',),
+    422: ('unprocessable_entity', 'unprocessable'),
+    423: ('locked',),
+    424: ('failed_dependency', 'dependency'),
+    425: ('unordered_collection', 'unordered'),
+    426: ('upgrade_required', 'upgrade'),
+    428: ('precondition_required', 'precondition'),
+    429: ('too_many_requests', 'too_many'),
+    431: ('header_fields_too_large', 'fields_too_large'),
+    444: ('no_response', 'none'),
+    449: ('retry_with', 'retry'),
+    450: ('blocked_by_windows_parental_controls', 'parental_controls'),
+    451: ('unavailable_for_legal_reasons', 'legal_reasons'),
+    499: ('client_closed_request',),
+
+    # Server Error.
+    500: ('internal_server_error', 'server_error', '/o\\', '✗'),
+    501: ('not_implemented',),
+    502: ('bad_gateway',),
+    503: ('service_unavailable', 'unavailable'),
+    504: ('gateway_timeout',),
+    505: ('http_version_not_supported', 'http_version'),
+    506: ('variant_also_negotiates',),
+    507: ('insufficient_storage',),
+    509: ('bandwidth_limit_exceeded', 'bandwidth'),
+    510: ('not_extended',),
+    511: ('network_authentication_required', 'network_auth', 'network_authentication'),
+}
+
+codes = LookupDict(name='status_codes')
+
+def _init():
+    for code, titles in _codes.items():
+        for title in titles:
+            setattr(codes, title, code)
+            if not title.startswith(('\\', '/')):
+                setattr(codes, title.upper(), code)
+
+    def doc(code):
+        names = ', '.join('``%s``' % n for n in _codes[code])
+        return '* %d: %s' % (code, names)
+
+    global __doc__
+    __doc__ = (__doc__ + '\n' +
+               '\n'.join(doc(code) for code in sorted(_codes))
+               if __doc__ is not None else None)
+
+_init()
diff --git a/openpype/vendor/python/python_2/requests/structures.py b/openpype/vendor/python/python_2/requests/structures.py
new file mode 100644
index 0000000000..8ee0ba7a08
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/structures.py
@@ -0,0 +1,105 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.structures
+~~~~~~~~~~~~~~~~~~~
+
+Data structures that power Requests.
+"""
+
+from collections import OrderedDict
+
+from .compat import Mapping, MutableMapping
+
+
+class CaseInsensitiveDict(MutableMapping):
+    """A case-insensitive ``dict``-like object.
+
+    Implements all methods and operations of
+    ``MutableMapping`` as well as dict's ``copy``. Also
+    provides ``lower_items``.
+
+    All keys are expected to be strings. The structure remembers the
+    case of the last key to be set, and ``iter(instance)``,
+    ``keys()``, ``items()``, ``iterkeys()``, and ``iteritems()``
+    will contain case-sensitive keys. However, querying and contains
+    testing is case insensitive::
+
+        cid = CaseInsensitiveDict()
+        cid['Accept'] = 'application/json'
+        cid['aCCEPT'] == 'application/json'  # True
+        list(cid) == ['Accept']  # True
+
+    For example, ``headers['content-encoding']`` will return the
+    value of a ``'Content-Encoding'`` response header, regardless
+    of how the header name was originally stored.
+
+    If the constructor, ``.update``, or equality comparison
+    operations are given keys that have equal ``.lower()``s, the
+    behavior is undefined.
+    """
+
+    def __init__(self, data=None, **kwargs):
+        self._store = OrderedDict()
+        if data is None:
+            data = {}
+        self.update(data, **kwargs)
+
+    def __setitem__(self, key, value):
+        # Use the lowercased key for lookups, but store the actual
+        # key alongside the value.
+        self._store[key.lower()] = (key, value)
+
+    def __getitem__(self, key):
+        return self._store[key.lower()][1]
+
+    def __delitem__(self, key):
+        del self._store[key.lower()]
+
+    def __iter__(self):
+        return (casedkey for casedkey, mappedvalue in self._store.values())
+
+    def __len__(self):
+        return len(self._store)
+
+    def lower_items(self):
+        """Like iteritems(), but with all lowercase keys."""
+        return (
+            (lowerkey, keyval[1])
+            for (lowerkey, keyval)
+            in self._store.items()
+        )
+
+    def __eq__(self, other):
+        if isinstance(other, Mapping):
+            other = CaseInsensitiveDict(other)
+        else:
+            return NotImplemented
+        # Compare insensitively
+        return dict(self.lower_items()) == dict(other.lower_items())
+
+    # Copy is required
+    def copy(self):
+        return CaseInsensitiveDict(self._store.values())
+
+    def __repr__(self):
+        return str(dict(self.items()))
+
+
+class LookupDict(dict):
+    """Dictionary lookup object."""
+
+    def __init__(self, name=None):
+        self.name = name
+        super(LookupDict, self).__init__()
+
+    def __repr__(self):
+        return '<lookup \'%s\'>' % (self.name)
+
+    def __getitem__(self, key):
+        # We allow fall-through here, so values default to None
+
+        return self.__dict__.get(key, None)
+
+    def get(self, key, default=None):
+        return self.__dict__.get(key, default)
diff --git a/openpype/vendor/python/python_2/requests/utils.py b/openpype/vendor/python/python_2/requests/utils.py
new file mode 100644
index 0000000000..153776c7f3
--- /dev/null
+++ b/openpype/vendor/python/python_2/requests/utils.py
@@ -0,0 +1,1060 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.utils
+~~~~~~~~~~~~~~
+
+This module provides utility functions that are used within Requests
+that are also useful for external consumption.
+"""
+
+import codecs
+import contextlib
+import io
+import os
+import re
+import socket
+import struct
+import sys
+import tempfile
+import warnings
+import zipfile
+from collections import OrderedDict
+from urllib3.util import make_headers
+from urllib3.util import parse_url
+
+from .__version__ import __version__
+from . import certs
+# to_native_string is unused here, but imported here for backwards compatibility
+from ._internal_utils import to_native_string
+from .compat import parse_http_list as _parse_list_header
+from .compat import (
+    quote, urlparse, bytes, str, unquote, getproxies,
+    proxy_bypass, urlunparse, basestring, integer_types, is_py3,
+    proxy_bypass_environment, getproxies_environment, Mapping)
+from .cookies import cookiejar_from_dict
+from .structures import CaseInsensitiveDict
+from .exceptions import (
+    InvalidURL, InvalidHeader, FileModeWarning, UnrewindableBodyError)
+
+NETRC_FILES = ('.netrc', '_netrc')
+
+DEFAULT_CA_BUNDLE_PATH = certs.where()
+
+DEFAULT_PORTS = {'http': 80, 'https': 443}
+
+# Ensure that ', ' is used to preserve previous delimiter behavior.
+DEFAULT_ACCEPT_ENCODING = ", ".join(
+    re.split(r",\s*", make_headers(accept_encoding=True)["accept-encoding"])
+)
+
+
+if sys.platform == 'win32':
+    # provide a proxy_bypass version on Windows without DNS lookups
+
+    def proxy_bypass_registry(host):
+        try:
+            if is_py3:
+                import winreg
+            else:
+                import _winreg as winreg
+        except ImportError:
+            return False
+
+        try:
+            internetSettings = winreg.OpenKey(winreg.HKEY_CURRENT_USER,
+                r'Software\Microsoft\Windows\CurrentVersion\Internet Settings')
+            # ProxyEnable could be REG_SZ or REG_DWORD, normalizing it
+            proxyEnable = int(winreg.QueryValueEx(internetSettings,
+                                              'ProxyEnable')[0])
+            # ProxyOverride is almost always a string
+            proxyOverride = winreg.QueryValueEx(internetSettings,
+                                                'ProxyOverride')[0]
+        except OSError:
+            return False
+        if not proxyEnable or not proxyOverride:
+            return False
+
+        # make a check value list from the registry entry: replace the
+        # '<local>' string by the localhost entry and the corresponding
+        # canonical entry.
+        proxyOverride = proxyOverride.split(';')
+        # now check if we match one of the registry values.
+        for test in proxyOverride:
+            if test == '<local>':
+                if '.' not in host:
+                    return True
+            test = test.replace(".", r"\.")     # mask dots
+            test = test.replace("*", r".*")     # change glob sequence
+            test = test.replace("?", r".")      # change glob char
+            if re.match(test, host, re.I):
+                return True
+        return False
+
+    def proxy_bypass(host):  # noqa
+        """Return True, if the host should be bypassed.
+
+        Checks proxy settings gathered from the environment, if specified,
+        or the registry.
+        """
+        if getproxies_environment():
+            return proxy_bypass_environment(host)
+        else:
+            return proxy_bypass_registry(host)
+
+
+def dict_to_sequence(d):
+    """Returns an internal sequence dictionary update."""
+
+    if hasattr(d, 'items'):
+        d = d.items()
+
+    return d
+
+
+def super_len(o):
+    total_length = None
+    current_position = 0
+
+    if hasattr(o, '__len__'):
+        total_length = len(o)
+
+    elif hasattr(o, 'len'):
+        total_length = o.len
+
+    elif hasattr(o, 'fileno'):
+        try:
+            fileno = o.fileno()
+        except (io.UnsupportedOperation, AttributeError):
+            # AttributeError is a surprising exception, seeing as how we've just checked
+            # that `hasattr(o, 'fileno')`.  It happens for objects obtained via
+            # `Tarfile.extractfile()`, per issue 5229.
+            pass
+        else:
+            total_length = os.fstat(fileno).st_size
+
+            # Having used fstat to determine the file length, we need to
+            # confirm that this file was opened up in binary mode.
+            if 'b' not in o.mode:
+                warnings.warn((
+                    "Requests has determined the content-length for this "
+                    "request using the binary size of the file: however, the "
+                    "file has been opened in text mode (i.e. without the 'b' "
+                    "flag in the mode). This may lead to an incorrect "
+                    "content-length. In Requests 3.0, support will be removed "
+                    "for files in text mode."),
+                    FileModeWarning
+                )
+
+    if hasattr(o, 'tell'):
+        try:
+            current_position = o.tell()
+        except (OSError, IOError):
+            # This can happen in some weird situations, such as when the file
+            # is actually a special file descriptor like stdin. In this
+            # instance, we don't know what the length is, so set it to zero and
+            # let requests chunk it instead.
+            if total_length is not None:
+                current_position = total_length
+        else:
+            if hasattr(o, 'seek') and total_length is None:
+                # StringIO and BytesIO have seek but no usable fileno
+                try:
+                    # seek to end of file
+                    o.seek(0, 2)
+                    total_length = o.tell()
+
+                    # seek back to current position to support
+                    # partially read file-like objects
+                    o.seek(current_position or 0)
+                except (OSError, IOError):
+                    total_length = 0
+
+    if total_length is None:
+        total_length = 0
+
+    return max(0, total_length - current_position)
+
+
+def get_netrc_auth(url, raise_errors=False):
+    """Returns the Requests tuple auth for a given url from netrc."""
+
+    netrc_file = os.environ.get('NETRC')
+    if netrc_file is not None:
+        netrc_locations = (netrc_file,)
+    else:
+        netrc_locations = ('~/{}'.format(f) for f in NETRC_FILES)
+
+    try:
+        from netrc import netrc, NetrcParseError
+
+        netrc_path = None
+
+        for f in netrc_locations:
+            try:
+                loc = os.path.expanduser(f)
+            except KeyError:
+                # os.path.expanduser can fail when $HOME is undefined and
+                # getpwuid fails. See https://bugs.python.org/issue20164 &
+                # https://github.com/psf/requests/issues/1846
+                return
+
+            if os.path.exists(loc):
+                netrc_path = loc
+                break
+
+        # Abort early if there isn't one.
+        if netrc_path is None:
+            return
+
+        ri = urlparse(url)
+
+        # Strip port numbers from netloc. This weird `if...encode`` dance is
+        # used for Python 3.2, which doesn't support unicode literals.
+        splitstr = b':'
+        if isinstance(url, str):
+            splitstr = splitstr.decode('ascii')
+        host = ri.netloc.split(splitstr)[0]
+
+        try:
+            _netrc = netrc(netrc_path).authenticators(host)
+            if _netrc:
+                # Return with login / password
+                login_i = (0 if _netrc[0] else 1)
+                return (_netrc[login_i], _netrc[2])
+        except (NetrcParseError, IOError):
+            # If there was a parsing error or a permissions issue reading the file,
+            # we'll just skip netrc auth unless explicitly asked to raise errors.
+            if raise_errors:
+                raise
+
+    # App Engine hackiness.
+    except (ImportError, AttributeError):
+        pass
+
+
+def guess_filename(obj):
+    """Tries to guess the filename of the given object."""
+    name = getattr(obj, 'name', None)
+    if (name and isinstance(name, basestring) and name[0] != '<' and
+            name[-1] != '>'):
+        return os.path.basename(name)
+
+
+def extract_zipped_paths(path):
+    """Replace nonexistent paths that look like they refer to a member of a zip
+    archive with the location of an extracted copy of the target, or else
+    just return the provided path unchanged.
+    """
+    if os.path.exists(path):
+        # this is already a valid path, no need to do anything further
+        return path
+
+    # find the first valid part of the provided path and treat that as a zip archive
+    # assume the rest of the path is the name of a member in the archive
+    archive, member = os.path.split(path)
+    while archive and not os.path.exists(archive):
+        archive, prefix = os.path.split(archive)
+        if not prefix:
+            # If we don't check for an empty prefix after the split (in other words, archive remains unchanged after the split),
+            # we _can_ end up in an infinite loop on a rare corner case affecting a small number of users
+            break
+        member = '/'.join([prefix, member])
+
+    if not zipfile.is_zipfile(archive):
+        return path
+
+    zip_file = zipfile.ZipFile(archive)
+    if member not in zip_file.namelist():
+        return path
+
+    # we have a valid zip archive and a valid member of that archive
+    tmp = tempfile.gettempdir()
+    extracted_path = os.path.join(tmp, member.split('/')[-1])
+    if not os.path.exists(extracted_path):
+        # use read + write to avoid the creating nested folders, we only want the file, avoids mkdir racing condition
+        with atomic_open(extracted_path) as file_handler:
+            file_handler.write(zip_file.read(member))
+    return extracted_path
+
+
+@contextlib.contextmanager
+def atomic_open(filename):
+    """Write a file to the disk in an atomic fashion"""
+    replacer = os.rename if sys.version_info[0] == 2 else os.replace
+    tmp_descriptor, tmp_name = tempfile.mkstemp(dir=os.path.dirname(filename))
+    try:
+        with os.fdopen(tmp_descriptor, 'wb') as tmp_handler:
+            yield tmp_handler
+        replacer(tmp_name, filename)
+    except BaseException:
+        os.remove(tmp_name)
+        raise
+
+
+def from_key_val_list(value):
+    """Take an object and test to see if it can be represented as a
+    dictionary. Unless it can not be represented as such, return an
+    OrderedDict, e.g.,
+
+    ::
+
+        >>> from_key_val_list([('key', 'val')])
+        OrderedDict([('key', 'val')])
+        >>> from_key_val_list('string')
+        Traceback (most recent call last):
+        ...
+        ValueError: cannot encode objects that are not 2-tuples
+        >>> from_key_val_list({'key': 'val'})
+        OrderedDict([('key', 'val')])
+
+    :rtype: OrderedDict
+    """
+    if value is None:
+        return None
+
+    if isinstance(value, (str, bytes, bool, int)):
+        raise ValueError('cannot encode objects that are not 2-tuples')
+
+    return OrderedDict(value)
+
+
+def to_key_val_list(value):
+    """Take an object and test to see if it can be represented as a
+    dictionary. If it can be, return a list of tuples, e.g.,
+
+    ::
+
+        >>> to_key_val_list([('key', 'val')])
+        [('key', 'val')]
+        >>> to_key_val_list({'key': 'val'})
+        [('key', 'val')]
+        >>> to_key_val_list('string')
+        Traceback (most recent call last):
+        ...
+        ValueError: cannot encode objects that are not 2-tuples
+
+    :rtype: list
+    """
+    if value is None:
+        return None
+
+    if isinstance(value, (str, bytes, bool, int)):
+        raise ValueError('cannot encode objects that are not 2-tuples')
+
+    if isinstance(value, Mapping):
+        value = value.items()
+
+    return list(value)
+
+
+# From mitsuhiko/werkzeug (used with permission).
+def parse_list_header(value):
+    """Parse lists as described by RFC 2068 Section 2.
+
+    In particular, parse comma-separated lists where the elements of
+    the list may include quoted-strings.  A quoted-string could
+    contain a comma.  A non-quoted string could have quotes in the
+    middle.  Quotes are removed automatically after parsing.
+
+    It basically works like :func:`parse_set_header` just that items
+    may appear multiple times and case sensitivity is preserved.
+
+    The return value is a standard :class:`list`:
+
+    >>> parse_list_header('token, "quoted value"')
+    ['token', 'quoted value']
+
+    To create a header from the :class:`list` again, use the
+    :func:`dump_header` function.
+
+    :param value: a string with a list header.
+    :return: :class:`list`
+    :rtype: list
+    """
+    result = []
+    for item in _parse_list_header(value):
+        if item[:1] == item[-1:] == '"':
+            item = unquote_header_value(item[1:-1])
+        result.append(item)
+    return result
+
+
+# From mitsuhiko/werkzeug (used with permission).
+def parse_dict_header(value):
+    """Parse lists of key, value pairs as described by RFC 2068 Section 2 and
+    convert them into a python dict:
+
+    >>> d = parse_dict_header('foo="is a fish", bar="as well"')
+    >>> type(d) is dict
+    True
+    >>> sorted(d.items())
+    [('bar', 'as well'), ('foo', 'is a fish')]
+
+    If there is no value for a key it will be `None`:
+
+    >>> parse_dict_header('key_without_value')
+    {'key_without_value': None}
+
+    To create a header from the :class:`dict` again, use the
+    :func:`dump_header` function.
+
+    :param value: a string with a dict header.
+    :return: :class:`dict`
+    :rtype: dict
+    """
+    result = {}
+    for item in _parse_list_header(value):
+        if '=' not in item:
+            result[item] = None
+            continue
+        name, value = item.split('=', 1)
+        if value[:1] == value[-1:] == '"':
+            value = unquote_header_value(value[1:-1])
+        result[name] = value
+    return result
+
+
+# From mitsuhiko/werkzeug (used with permission).
+def unquote_header_value(value, is_filename=False):
+    r"""Unquotes a header value.  (Reversal of :func:`quote_header_value`).
+    This does not use the real unquoting but what browsers are actually
+    using for quoting.
+
+    :param value: the header value to unquote.
+    :rtype: str
+    """
+    if value and value[0] == value[-1] == '"':
+        # this is not the real unquoting, but fixing this so that the
+        # RFC is met will result in bugs with internet explorer and
+        # probably some other browsers as well.  IE for example is
+        # uploading files with "C:\foo\bar.txt" as filename
+        value = value[1:-1]
+
+        # if this is a filename and the starting characters look like
+        # a UNC path, then just return the value without quotes.  Using the
+        # replace sequence below on a UNC path has the effect of turning
+        # the leading double slash into a single slash and then
+        # _fix_ie_filename() doesn't work correctly.  See #458.
+        if not is_filename or value[:2] != '\\\\':
+            return value.replace('\\\\', '\\').replace('\\"', '"')
+    return value
+
+
+def dict_from_cookiejar(cj):
+    """Returns a key/value dictionary from a CookieJar.
+
+    :param cj: CookieJar object to extract cookies from.
+    :rtype: dict
+    """
+
+    cookie_dict = {}
+
+    for cookie in cj:
+        cookie_dict[cookie.name] = cookie.value
+
+    return cookie_dict
+
+
+def add_dict_to_cookiejar(cj, cookie_dict):
+    """Returns a CookieJar from a key/value dictionary.
+
+    :param cj: CookieJar to insert cookies into.
+    :param cookie_dict: Dict of key/values to insert into CookieJar.
+    :rtype: CookieJar
+    """
+
+    return cookiejar_from_dict(cookie_dict, cj)
+
+
+def get_encodings_from_content(content):
+    """Returns encodings from given content string.
+
+    :param content: bytestring to extract encodings from.
+    """
+    warnings.warn((
+        'In requests 3.0, get_encodings_from_content will be removed. For '
+        'more information, please see the discussion on issue #2266. (This'
+        ' warning should only appear once.)'),
+        DeprecationWarning)
+
+    charset_re = re.compile(r'<meta.*?charset=["\']*(.+?)["\'>]', flags=re.I)
+    pragma_re = re.compile(r'<meta.*?content=["\']*;?charset=(.+?)["\'>]', flags=re.I)
+    xml_re = re.compile(r'^<\?xml.*?encoding=["\']*(.+?)["\'>]')
+
+    return (charset_re.findall(content) +
+            pragma_re.findall(content) +
+            xml_re.findall(content))
+
+
+def _parse_content_type_header(header):
+    """Returns content type and parameters from given header
+
+    :param header: string
+    :return: tuple containing content type and dictionary of
+         parameters
+    """
+
+    tokens = header.split(';')
+    content_type, params = tokens[0].strip(), tokens[1:]
+    params_dict = {}
+    items_to_strip = "\"' "
+
+    for param in params:
+        param = param.strip()
+        if param:
+            key, value = param, True
+            index_of_equals = param.find("=")
+            if index_of_equals != -1:
+                key = param[:index_of_equals].strip(items_to_strip)
+                value = param[index_of_equals + 1:].strip(items_to_strip)
+            params_dict[key.lower()] = value
+    return content_type, params_dict
+
+
+def get_encoding_from_headers(headers):
+    """Returns encodings from given HTTP Header Dict.
+
+    :param headers: dictionary to extract encoding from.
+    :rtype: str
+    """
+
+    content_type = headers.get('content-type')
+
+    if not content_type:
+        return None
+
+    content_type, params = _parse_content_type_header(content_type)
+
+    if 'charset' in params:
+        return params['charset'].strip("'\"")
+
+    if 'text' in content_type:
+        return 'ISO-8859-1'
+
+    if 'application/json' in content_type:
+        # Assume UTF-8 based on RFC 4627: https://www.ietf.org/rfc/rfc4627.txt since the charset was unset
+        return 'utf-8'
+
+
+def stream_decode_response_unicode(iterator, r):
+    """Stream decodes a iterator."""
+
+    if r.encoding is None:
+        for item in iterator:
+            yield item
+        return
+
+    decoder = codecs.getincrementaldecoder(r.encoding)(errors='replace')
+    for chunk in iterator:
+        rv = decoder.decode(chunk)
+        if rv:
+            yield rv
+    rv = decoder.decode(b'', final=True)
+    if rv:
+        yield rv
+
+
+def iter_slices(string, slice_length):
+    """Iterate over slices of a string."""
+    pos = 0
+    if slice_length is None or slice_length <= 0:
+        slice_length = len(string)
+    while pos < len(string):
+        yield string[pos:pos + slice_length]
+        pos += slice_length
+
+
+def get_unicode_from_response(r):
+    """Returns the requested content back in unicode.
+
+    :param r: Response object to get unicode content from.
+
+    Tried:
+
+    1. charset from content-type
+    2. fall back and replace all unicode characters
+
+    :rtype: str
+    """
+    warnings.warn((
+        'In requests 3.0, get_unicode_from_response will be removed. For '
+        'more information, please see the discussion on issue #2266. (This'
+        ' warning should only appear once.)'),
+        DeprecationWarning)
+
+    tried_encodings = []
+
+    # Try charset from content-type
+    encoding = get_encoding_from_headers(r.headers)
+
+    if encoding:
+        try:
+            return str(r.content, encoding)
+        except UnicodeError:
+            tried_encodings.append(encoding)
+
+    # Fall back:
+    try:
+        return str(r.content, encoding, errors='replace')
+    except TypeError:
+        return r.content
+
+
+# The unreserved URI characters (RFC 3986)
+UNRESERVED_SET = frozenset(
+    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" + "0123456789-._~")
+
+
+def unquote_unreserved(uri):
+    """Un-escape any percent-escape sequences in a URI that are unreserved
+    characters. This leaves all reserved, illegal and non-ASCII bytes encoded.
+
+    :rtype: str
+    """
+    parts = uri.split('%')
+    for i in range(1, len(parts)):
+        h = parts[i][0:2]
+        if len(h) == 2 and h.isalnum():
+            try:
+                c = chr(int(h, 16))
+            except ValueError:
+                raise InvalidURL("Invalid percent-escape sequence: '%s'" % h)
+
+            if c in UNRESERVED_SET:
+                parts[i] = c + parts[i][2:]
+            else:
+                parts[i] = '%' + parts[i]
+        else:
+            parts[i] = '%' + parts[i]
+    return ''.join(parts)
+
+
+def requote_uri(uri):
+    """Re-quote the given URI.
+
+    This function passes the given URI through an unquote/quote cycle to
+    ensure that it is fully and consistently quoted.
+
+    :rtype: str
+    """
+    safe_with_percent = "!#$%&'()*+,/:;=?@[]~"
+    safe_without_percent = "!#$&'()*+,/:;=?@[]~"
+    try:
+        # Unquote only the unreserved characters
+        # Then quote only illegal characters (do not quote reserved,
+        # unreserved, or '%')
+        return quote(unquote_unreserved(uri), safe=safe_with_percent)
+    except InvalidURL:
+        # We couldn't unquote the given URI, so let's try quoting it, but
+        # there may be unquoted '%'s in the URI. We need to make sure they're
+        # properly quoted so they do not cause issues elsewhere.
+        return quote(uri, safe=safe_without_percent)
+
+
+def address_in_network(ip, net):
+    """This function allows you to check if an IP belongs to a network subnet
+
+    Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24
+             returns False if ip = 192.168.1.1 and net = 192.168.100.0/24
+
+    :rtype: bool
+    """
+    ipaddr = struct.unpack('=L', socket.inet_aton(ip))[0]
+    netaddr, bits = net.split('/')
+    netmask = struct.unpack('=L', socket.inet_aton(dotted_netmask(int(bits))))[0]
+    network = struct.unpack('=L', socket.inet_aton(netaddr))[0] & netmask
+    return (ipaddr & netmask) == (network & netmask)
+
+
+def dotted_netmask(mask):
+    """Converts mask from /xx format to xxx.xxx.xxx.xxx
+
+    Example: if mask is 24 function returns 255.255.255.0
+
+    :rtype: str
+    """
+    bits = 0xffffffff ^ (1 << 32 - mask) - 1
+    return socket.inet_ntoa(struct.pack('>I', bits))
+
+
+def is_ipv4_address(string_ip):
+    """
+    :rtype: bool
+    """
+    try:
+        socket.inet_aton(string_ip)
+    except socket.error:
+        return False
+    return True
+
+
+def is_valid_cidr(string_network):
+    """
+    Very simple check of the cidr format in no_proxy variable.
+
+    :rtype: bool
+    """
+    if string_network.count('/') == 1:
+        try:
+            mask = int(string_network.split('/')[1])
+        except ValueError:
+            return False
+
+        if mask < 1 or mask > 32:
+            return False
+
+        try:
+            socket.inet_aton(string_network.split('/')[0])
+        except socket.error:
+            return False
+    else:
+        return False
+    return True
+
+
+@contextlib.contextmanager
+def set_environ(env_name, value):
+    """Set the environment variable 'env_name' to 'value'
+
+    Save previous value, yield, and then restore the previous value stored in
+    the environment variable 'env_name'.
+
+    If 'value' is None, do nothing"""
+    value_changed = value is not None
+    if value_changed:
+        old_value = os.environ.get(env_name)
+        os.environ[env_name] = value
+    try:
+        yield
+    finally:
+        if value_changed:
+            if old_value is None:
+                del os.environ[env_name]
+            else:
+                os.environ[env_name] = old_value
+
+
+def should_bypass_proxies(url, no_proxy):
+    """
+    Returns whether we should bypass proxies or not.
+
+    :rtype: bool
+    """
+    # Prioritize lowercase environment variables over uppercase
+    # to keep a consistent behaviour with other http projects (curl, wget).
+    get_proxy = lambda k: os.environ.get(k) or os.environ.get(k.upper())
+
+    # First check whether no_proxy is defined. If it is, check that the URL
+    # we're getting isn't in the no_proxy list.
+    no_proxy_arg = no_proxy
+    if no_proxy is None:
+        no_proxy = get_proxy('no_proxy')
+    parsed = urlparse(url)
+
+    if parsed.hostname is None:
+        # URLs don't always have hostnames, e.g. file:/// urls.
+        return True
+
+    if no_proxy:
+        # We need to check whether we match here. We need to see if we match
+        # the end of the hostname, both with and without the port.
+        no_proxy = (
+            host for host in no_proxy.replace(' ', '').split(',') if host
+        )
+
+        if is_ipv4_address(parsed.hostname):
+            for proxy_ip in no_proxy:
+                if is_valid_cidr(proxy_ip):
+                    if address_in_network(parsed.hostname, proxy_ip):
+                        return True
+                elif parsed.hostname == proxy_ip:
+                    # If no_proxy ip was defined in plain IP notation instead of cidr notation &
+                    # matches the IP of the index
+                    return True
+        else:
+            host_with_port = parsed.hostname
+            if parsed.port:
+                host_with_port += ':{}'.format(parsed.port)
+
+            for host in no_proxy:
+                if parsed.hostname.endswith(host) or host_with_port.endswith(host):
+                    # The URL does match something in no_proxy, so we don't want
+                    # to apply the proxies on this URL.
+                    return True
+
+    with set_environ('no_proxy', no_proxy_arg):
+        # parsed.hostname can be `None` in cases such as a file URI.
+        try:
+            bypass = proxy_bypass(parsed.hostname)
+        except (TypeError, socket.gaierror):
+            bypass = False
+
+    if bypass:
+        return True
+
+    return False
+
+
+def get_environ_proxies(url, no_proxy=None):
+    """
+    Return a dict of environment proxies.
+
+    :rtype: dict
+    """
+    if should_bypass_proxies(url, no_proxy=no_proxy):
+        return {}
+    else:
+        return getproxies()
+
+
+def select_proxy(url, proxies):
+    """Select a proxy for the url, if applicable.
+
+    :param url: The url being for the request
+    :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
+    """
+    proxies = proxies or {}
+    urlparts = urlparse(url)
+    if urlparts.hostname is None:
+        return proxies.get(urlparts.scheme, proxies.get('all'))
+
+    proxy_keys = [
+        urlparts.scheme + '://' + urlparts.hostname,
+        urlparts.scheme,
+        'all://' + urlparts.hostname,
+        'all',
+    ]
+    proxy = None
+    for proxy_key in proxy_keys:
+        if proxy_key in proxies:
+            proxy = proxies[proxy_key]
+            break
+
+    return proxy
+
+
+def resolve_proxies(request, proxies, trust_env=True):
+    """This method takes proxy information from a request and configuration
+    input to resolve a mapping of target proxies. This will consider settings
+    such a NO_PROXY to strip proxy configurations.
+
+    :param request: Request or PreparedRequest
+    :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
+    :param trust_env: Boolean declaring whether to trust environment configs
+
+    :rtype: dict
+    """
+    proxies = proxies if proxies is not None else {}
+    url = request.url
+    scheme = urlparse(url).scheme
+    no_proxy = proxies.get('no_proxy')
+    new_proxies = proxies.copy()
+
+    if trust_env and not should_bypass_proxies(url, no_proxy=no_proxy):
+        environ_proxies = get_environ_proxies(url, no_proxy=no_proxy)
+
+        proxy = environ_proxies.get(scheme, environ_proxies.get('all'))
+
+        if proxy:
+            new_proxies.setdefault(scheme, proxy)
+    return new_proxies
+
+
+def default_user_agent(name="python-requests"):
+    """
+    Return a string representing the default user agent.
+
+    :rtype: str
+    """
+    return '%s/%s' % (name, __version__)
+
+
+def default_headers():
+    """
+    :rtype: requests.structures.CaseInsensitiveDict
+    """
+    return CaseInsensitiveDict({
+        'User-Agent': default_user_agent(),
+        'Accept-Encoding': DEFAULT_ACCEPT_ENCODING,
+        'Accept': '*/*',
+        'Connection': 'keep-alive',
+    })
+
+
+def parse_header_links(value):
+    """Return a list of parsed link headers proxies.
+
+    i.e. Link: <http:/.../front.jpeg>; rel=front; type="image/jpeg",<http://.../back.jpeg>; rel=back;type="image/jpeg"
+
+    :rtype: list
+    """
+
+    links = []
+
+    replace_chars = ' \'"'
+
+    value = value.strip(replace_chars)
+    if not value:
+        return links
+
+    for val in re.split(', *<', value):
+        try:
+            url, params = val.split(';', 1)
+        except ValueError:
+            url, params = val, ''
+
+        link = {'url': url.strip('<> \'"')}
+
+        for param in params.split(';'):
+            try:
+                key, value = param.split('=')
+            except ValueError:
+                break
+
+            link[key.strip(replace_chars)] = value.strip(replace_chars)
+
+        links.append(link)
+
+    return links
+
+
+# Null bytes; no need to recreate these on each call to guess_json_utf
+_null = '\x00'.encode('ascii')  # encoding to ASCII for Python 3
+_null2 = _null * 2
+_null3 = _null * 3
+
+
+def guess_json_utf(data):
+    """
+    :rtype: str
+    """
+    # JSON always starts with two ASCII characters, so detection is as
+    # easy as counting the nulls and from their location and count
+    # determine the encoding. Also detect a BOM, if present.
+    sample = data[:4]
+    if sample in (codecs.BOM_UTF32_LE, codecs.BOM_UTF32_BE):
+        return 'utf-32'     # BOM included
+    if sample[:3] == codecs.BOM_UTF8:
+        return 'utf-8-sig'  # BOM included, MS style (discouraged)
+    if sample[:2] in (codecs.BOM_UTF16_LE, codecs.BOM_UTF16_BE):
+        return 'utf-16'     # BOM included
+    nullcount = sample.count(_null)
+    if nullcount == 0:
+        return 'utf-8'
+    if nullcount == 2:
+        if sample[::2] == _null2:   # 1st and 3rd are null
+            return 'utf-16-be'
+        if sample[1::2] == _null2:  # 2nd and 4th are null
+            return 'utf-16-le'
+        # Did not detect 2 valid UTF-16 ascii-range characters
+    if nullcount == 3:
+        if sample[:3] == _null3:
+            return 'utf-32-be'
+        if sample[1:] == _null3:
+            return 'utf-32-le'
+        # Did not detect a valid UTF-32 ascii-range character
+    return None
+
+
+def prepend_scheme_if_needed(url, new_scheme):
+    """Given a URL that may or may not have a scheme, prepend the given scheme.
+    Does not replace a present scheme with the one provided as an argument.
+
+    :rtype: str
+    """
+    parsed = parse_url(url)
+    scheme, auth, host, port, path, query, fragment = parsed
+
+    # A defect in urlparse determines that there isn't a netloc present in some
+    # urls. We previously assumed parsing was overly cautious, and swapped the
+    # netloc and path. Due to a lack of tests on the original defect, this is
+    # maintained with parse_url for backwards compatibility.
+    netloc = parsed.netloc
+    if not netloc:
+        netloc, path = path, netloc
+
+    if auth:
+        # parse_url doesn't provide the netloc with auth
+        # so we'll add it ourselves.
+        netloc = '@'.join([auth, netloc])
+    if scheme is None:
+        scheme = new_scheme
+    if path is None:
+        path = ''
+
+    return urlunparse((scheme, netloc, path, '', query, fragment))
+
+
+def get_auth_from_url(url):
+    """Given a url with authentication components, extract them into a tuple of
+    username,password.
+
+    :rtype: (str,str)
+    """
+    parsed = urlparse(url)
+
+    try:
+        auth = (unquote(parsed.username), unquote(parsed.password))
+    except (AttributeError, TypeError):
+        auth = ('', '')
+
+    return auth
+
+
+# Moved outside of function to avoid recompile every call
+_CLEAN_HEADER_REGEX_BYTE = re.compile(b'^\\S[^\\r\\n]*$|^$')
+_CLEAN_HEADER_REGEX_STR = re.compile(r'^\S[^\r\n]*$|^$')
+
+
+def check_header_validity(header):
+    """Verifies that header value is a string which doesn't contain
+    leading whitespace or return characters. This prevents unintended
+    header injection.
+
+    :param header: tuple, in the format (name, value).
+    """
+    name, value = header
+
+    if isinstance(value, bytes):
+        pat = _CLEAN_HEADER_REGEX_BYTE
+    else:
+        pat = _CLEAN_HEADER_REGEX_STR
+    try:
+        if not pat.match(value):
+            raise InvalidHeader("Invalid return character or leading space in header: %s" % name)
+    except TypeError:
+        raise InvalidHeader("Value for header {%s: %s} must be of type str or "
+                            "bytes, not %s" % (name, value, type(value)))
+
+
+def urldefragauth(url):
+    """
+    Given a url remove the fragment and the authentication part.
+
+    :rtype: str
+    """
+    scheme, netloc, path, params, query, fragment = urlparse(url)
+
+    # see func:`prepend_scheme_if_needed`
+    if not netloc:
+        netloc, path = path, netloc
+
+    netloc = netloc.rsplit('@', 1)[-1]
+
+    return urlunparse((scheme, netloc, path, params, query, ''))
+
+
+def rewind_body(prepared_request):
+    """Move file pointer back to its recorded starting position
+    so it can be read again on redirect.
+    """
+    body_seek = getattr(prepared_request.body, 'seek', None)
+    if body_seek is not None and isinstance(prepared_request._body_position, integer_types):
+        try:
+            body_seek(prepared_request._body_position)
+        except (IOError, OSError):
+            raise UnrewindableBodyError("An error occurred when rewinding request "
+                                        "body for redirect.")
+    else:
+        raise UnrewindableBodyError("Unable to rewind request body for redirect.")
diff --git a/openpype/vendor/python/python_2/urllib3/__init__.py b/openpype/vendor/python/python_2/urllib3/__init__.py
new file mode 100644
index 0000000000..fe86b59d78
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/__init__.py
@@ -0,0 +1,85 @@
+"""
+Python HTTP library with thread-safe connection pooling, file post support, user friendly, and more
+"""
+from __future__ import absolute_import
+
+# Set default logging handler to avoid "No handler found" warnings.
+import logging
+import warnings
+from logging import NullHandler
+
+from . import exceptions
+from ._version import __version__
+from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, connection_from_url
+from .filepost import encode_multipart_formdata
+from .poolmanager import PoolManager, ProxyManager, proxy_from_url
+from .response import HTTPResponse
+from .util.request import make_headers
+from .util.retry import Retry
+from .util.timeout import Timeout
+from .util.url import get_host
+
+__author__ = "Andrey Petrov (andrey.petrov@shazow.net)"
+__license__ = "MIT"
+__version__ = __version__
+
+__all__ = (
+    "HTTPConnectionPool",
+    "HTTPSConnectionPool",
+    "PoolManager",
+    "ProxyManager",
+    "HTTPResponse",
+    "Retry",
+    "Timeout",
+    "add_stderr_logger",
+    "connection_from_url",
+    "disable_warnings",
+    "encode_multipart_formdata",
+    "get_host",
+    "make_headers",
+    "proxy_from_url",
+)
+
+logging.getLogger(__name__).addHandler(NullHandler())
+
+
+def add_stderr_logger(level=logging.DEBUG):
+    """
+    Helper for quickly adding a StreamHandler to the logger. Useful for
+    debugging.
+
+    Returns the handler after adding it.
+    """
+    # This method needs to be in this __init__.py to get the __name__ correct
+    # even if urllib3 is vendored within another package.
+    logger = logging.getLogger(__name__)
+    handler = logging.StreamHandler()
+    handler.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(message)s"))
+    logger.addHandler(handler)
+    logger.setLevel(level)
+    logger.debug("Added a stderr logging handler to logger: %s", __name__)
+    return handler
+
+
+# ... Clean up.
+del NullHandler
+
+
+# All warning filters *must* be appended unless you're really certain that they
+# shouldn't be: otherwise, it's very hard for users to use most Python
+# mechanisms to silence them.
+# SecurityWarning's always go off by default.
+warnings.simplefilter("always", exceptions.SecurityWarning, append=True)
+# SubjectAltNameWarning's should go off once per host
+warnings.simplefilter("default", exceptions.SubjectAltNameWarning, append=True)
+# InsecurePlatformWarning's don't vary between requests, so we keep it default.
+warnings.simplefilter("default", exceptions.InsecurePlatformWarning, append=True)
+# SNIMissingWarnings should go off only once.
+warnings.simplefilter("default", exceptions.SNIMissingWarning, append=True)
+
+
+def disable_warnings(category=exceptions.HTTPWarning):
+    """
+    Helper for quickly disabling all urllib3 warnings.
+    """
+    warnings.simplefilter("ignore", category)
diff --git a/openpype/vendor/python/python_2/urllib3/_collections.py b/openpype/vendor/python/python_2/urllib3/_collections.py
new file mode 100644
index 0000000000..da9857e986
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/_collections.py
@@ -0,0 +1,337 @@
+from __future__ import absolute_import
+
+try:
+    from collections.abc import Mapping, MutableMapping
+except ImportError:
+    from collections import Mapping, MutableMapping
+try:
+    from threading import RLock
+except ImportError:  # Platform-specific: No threads available
+
+    class RLock:
+        def __enter__(self):
+            pass
+
+        def __exit__(self, exc_type, exc_value, traceback):
+            pass
+
+
+from collections import OrderedDict
+
+from .exceptions import InvalidHeader
+from .packages import six
+from .packages.six import iterkeys, itervalues
+
+__all__ = ["RecentlyUsedContainer", "HTTPHeaderDict"]
+
+
+_Null = object()
+
+
+class RecentlyUsedContainer(MutableMapping):
+    """
+    Provides a thread-safe dict-like container which maintains up to
+    ``maxsize`` keys while throwing away the least-recently-used keys beyond
+    ``maxsize``.
+
+    :param maxsize:
+        Maximum number of recent elements to retain.
+
+    :param dispose_func:
+        Every time an item is evicted from the container,
+        ``dispose_func(value)`` is called.  Callback which will get called
+    """
+
+    ContainerCls = OrderedDict
+
+    def __init__(self, maxsize=10, dispose_func=None):
+        self._maxsize = maxsize
+        self.dispose_func = dispose_func
+
+        self._container = self.ContainerCls()
+        self.lock = RLock()
+
+    def __getitem__(self, key):
+        # Re-insert the item, moving it to the end of the eviction line.
+        with self.lock:
+            item = self._container.pop(key)
+            self._container[key] = item
+            return item
+
+    def __setitem__(self, key, value):
+        evicted_value = _Null
+        with self.lock:
+            # Possibly evict the existing value of 'key'
+            evicted_value = self._container.get(key, _Null)
+            self._container[key] = value
+
+            # If we didn't evict an existing value, we might have to evict the
+            # least recently used item from the beginning of the container.
+            if len(self._container) > self._maxsize:
+                _key, evicted_value = self._container.popitem(last=False)
+
+        if self.dispose_func and evicted_value is not _Null:
+            self.dispose_func(evicted_value)
+
+    def __delitem__(self, key):
+        with self.lock:
+            value = self._container.pop(key)
+
+        if self.dispose_func:
+            self.dispose_func(value)
+
+    def __len__(self):
+        with self.lock:
+            return len(self._container)
+
+    def __iter__(self):
+        raise NotImplementedError(
+            "Iteration over this class is unlikely to be threadsafe."
+        )
+
+    def clear(self):
+        with self.lock:
+            # Copy pointers to all values, then wipe the mapping
+            values = list(itervalues(self._container))
+            self._container.clear()
+
+        if self.dispose_func:
+            for value in values:
+                self.dispose_func(value)
+
+    def keys(self):
+        with self.lock:
+            return list(iterkeys(self._container))
+
+
+class HTTPHeaderDict(MutableMapping):
+    """
+    :param headers:
+        An iterable of field-value pairs. Must not contain multiple field names
+        when compared case-insensitively.
+
+    :param kwargs:
+        Additional field-value pairs to pass in to ``dict.update``.
+
+    A ``dict`` like container for storing HTTP Headers.
+
+    Field names are stored and compared case-insensitively in compliance with
+    RFC 7230. Iteration provides the first case-sensitive key seen for each
+    case-insensitive pair.
+
+    Using ``__setitem__`` syntax overwrites fields that compare equal
+    case-insensitively in order to maintain ``dict``'s api. For fields that
+    compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add``
+    in a loop.
+
+    If multiple fields that are equal case-insensitively are passed to the
+    constructor or ``.update``, the behavior is undefined and some will be
+    lost.
+
+    >>> headers = HTTPHeaderDict()
+    >>> headers.add('Set-Cookie', 'foo=bar')
+    >>> headers.add('set-cookie', 'baz=quxx')
+    >>> headers['content-length'] = '7'
+    >>> headers['SET-cookie']
+    'foo=bar, baz=quxx'
+    >>> headers['Content-Length']
+    '7'
+    """
+
+    def __init__(self, headers=None, **kwargs):
+        super(HTTPHeaderDict, self).__init__()
+        self._container = OrderedDict()
+        if headers is not None:
+            if isinstance(headers, HTTPHeaderDict):
+                self._copy_from(headers)
+            else:
+                self.extend(headers)
+        if kwargs:
+            self.extend(kwargs)
+
+    def __setitem__(self, key, val):
+        self._container[key.lower()] = [key, val]
+        return self._container[key.lower()]
+
+    def __getitem__(self, key):
+        val = self._container[key.lower()]
+        return ", ".join(val[1:])
+
+    def __delitem__(self, key):
+        del self._container[key.lower()]
+
+    def __contains__(self, key):
+        return key.lower() in self._container
+
+    def __eq__(self, other):
+        if not isinstance(other, Mapping) and not hasattr(other, "keys"):
+            return False
+        if not isinstance(other, type(self)):
+            other = type(self)(other)
+        return dict((k.lower(), v) for k, v in self.itermerged()) == dict(
+            (k.lower(), v) for k, v in other.itermerged()
+        )
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    if six.PY2:  # Python 2
+        iterkeys = MutableMapping.iterkeys
+        itervalues = MutableMapping.itervalues
+
+    __marker = object()
+
+    def __len__(self):
+        return len(self._container)
+
+    def __iter__(self):
+        # Only provide the originally cased names
+        for vals in self._container.values():
+            yield vals[0]
+
+    def pop(self, key, default=__marker):
+        """D.pop(k[,d]) -> v, remove specified key and return the corresponding value.
+        If key is not found, d is returned if given, otherwise KeyError is raised.
+        """
+        # Using the MutableMapping function directly fails due to the private marker.
+        # Using ordinary dict.pop would expose the internal structures.
+        # So let's reinvent the wheel.
+        try:
+            value = self[key]
+        except KeyError:
+            if default is self.__marker:
+                raise
+            return default
+        else:
+            del self[key]
+            return value
+
+    def discard(self, key):
+        try:
+            del self[key]
+        except KeyError:
+            pass
+
+    def add(self, key, val):
+        """Adds a (name, value) pair, doesn't overwrite the value if it already
+        exists.
+
+        >>> headers = HTTPHeaderDict(foo='bar')
+        >>> headers.add('Foo', 'baz')
+        >>> headers['foo']
+        'bar, baz'
+        """
+        key_lower = key.lower()
+        new_vals = [key, val]
+        # Keep the common case aka no item present as fast as possible
+        vals = self._container.setdefault(key_lower, new_vals)
+        if new_vals is not vals:
+            vals.append(val)
+
+    def extend(self, *args, **kwargs):
+        """Generic import function for any type of header-like object.
+        Adapted version of MutableMapping.update in order to insert items
+        with self.add instead of self.__setitem__
+        """
+        if len(args) > 1:
+            raise TypeError(
+                "extend() takes at most 1 positional "
+                "arguments ({0} given)".format(len(args))
+            )
+        other = args[0] if len(args) >= 1 else ()
+
+        if isinstance(other, HTTPHeaderDict):
+            for key, val in other.iteritems():
+                self.add(key, val)
+        elif isinstance(other, Mapping):
+            for key in other:
+                self.add(key, other[key])
+        elif hasattr(other, "keys"):
+            for key in other.keys():
+                self.add(key, other[key])
+        else:
+            for key, value in other:
+                self.add(key, value)
+
+        for key, value in kwargs.items():
+            self.add(key, value)
+
+    def getlist(self, key, default=__marker):
+        """Returns a list of all the values for the named field. Returns an
+        empty list if the key doesn't exist."""
+        try:
+            vals = self._container[key.lower()]
+        except KeyError:
+            if default is self.__marker:
+                return []
+            return default
+        else:
+            return vals[1:]
+
+    # Backwards compatibility for httplib
+    getheaders = getlist
+    getallmatchingheaders = getlist
+    iget = getlist
+
+    # Backwards compatibility for http.cookiejar
+    get_all = getlist
+
+    def __repr__(self):
+        return "%s(%s)" % (type(self).__name__, dict(self.itermerged()))
+
+    def _copy_from(self, other):
+        for key in other:
+            val = other.getlist(key)
+            if isinstance(val, list):
+                # Don't need to convert tuples
+                val = list(val)
+            self._container[key.lower()] = [key] + val
+
+    def copy(self):
+        clone = type(self)()
+        clone._copy_from(self)
+        return clone
+
+    def iteritems(self):
+        """Iterate over all header lines, including duplicate ones."""
+        for key in self:
+            vals = self._container[key.lower()]
+            for val in vals[1:]:
+                yield vals[0], val
+
+    def itermerged(self):
+        """Iterate over all headers, merging duplicate ones together."""
+        for key in self:
+            val = self._container[key.lower()]
+            yield val[0], ", ".join(val[1:])
+
+    def items(self):
+        return list(self.iteritems())
+
+    @classmethod
+    def from_httplib(cls, message):  # Python 2
+        """Read headers from a Python 2 httplib message object."""
+        # python2.7 does not expose a proper API for exporting multiheaders
+        # efficiently. This function re-reads raw lines from the message
+        # object and extracts the multiheaders properly.
+        obs_fold_continued_leaders = (" ", "\t")
+        headers = []
+
+        for line in message.headers:
+            if line.startswith(obs_fold_continued_leaders):
+                if not headers:
+                    # We received a header line that starts with OWS as described
+                    # in RFC-7230 S3.2.4. This indicates a multiline header, but
+                    # there exists no previous header to which we can attach it.
+                    raise InvalidHeader(
+                        "Header continuation with no previous header: %s" % line
+                    )
+                else:
+                    key, value = headers[-1]
+                    headers[-1] = (key, value + " " + line.strip())
+                    continue
+
+            key, value = line.split(":", 1)
+            headers.append((key, value.strip()))
+
+        return cls(headers)
diff --git a/openpype/vendor/python/python_2/urllib3/_version.py b/openpype/vendor/python/python_2/urllib3/_version.py
new file mode 100644
index 0000000000..d905b69755
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/_version.py
@@ -0,0 +1,2 @@
+# This file is protected via CODEOWNERS
+__version__ = "1.26.9"
diff --git a/openpype/vendor/python/python_2/urllib3/connection.py b/openpype/vendor/python/python_2/urllib3/connection.py
new file mode 100644
index 0000000000..7bf395bdac
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/connection.py
@@ -0,0 +1,567 @@
+from __future__ import absolute_import
+
+import datetime
+import logging
+import os
+import re
+import socket
+import warnings
+from socket import error as SocketError
+from socket import timeout as SocketTimeout
+
+from .packages import six
+from .packages.six.moves.http_client import HTTPConnection as _HTTPConnection
+from .packages.six.moves.http_client import HTTPException  # noqa: F401
+from .util.proxy import create_proxy_ssl_context
+
+try:  # Compiled with SSL?
+    import ssl
+
+    BaseSSLError = ssl.SSLError
+except (ImportError, AttributeError):  # Platform-specific: No SSL.
+    ssl = None
+
+    class BaseSSLError(BaseException):
+        pass
+
+
+try:
+    # Python 3: not a no-op, we're adding this to the namespace so it can be imported.
+    ConnectionError = ConnectionError
+except NameError:
+    # Python 2
+    class ConnectionError(Exception):
+        pass
+
+
+try:  # Python 3:
+    # Not a no-op, we're adding this to the namespace so it can be imported.
+    BrokenPipeError = BrokenPipeError
+except NameError:  # Python 2:
+
+    class BrokenPipeError(Exception):
+        pass
+
+
+from ._collections import HTTPHeaderDict  # noqa (historical, removed in v2)
+from ._version import __version__
+from .exceptions import (
+    ConnectTimeoutError,
+    NewConnectionError,
+    SubjectAltNameWarning,
+    SystemTimeWarning,
+)
+from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection
+from .util.ssl_ import (
+    assert_fingerprint,
+    create_urllib3_context,
+    is_ipaddress,
+    resolve_cert_reqs,
+    resolve_ssl_version,
+    ssl_wrap_socket,
+)
+from .util.ssl_match_hostname import CertificateError, match_hostname
+
+log = logging.getLogger(__name__)
+
+port_by_scheme = {"http": 80, "https": 443}
+
+# When it comes time to update this value as a part of regular maintenance
+# (ie test_recent_date is failing) update it to ~6 months before the current date.
+RECENT_DATE = datetime.date(2020, 7, 1)
+
+_CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]")
+
+
+class HTTPConnection(_HTTPConnection, object):
+    """
+    Based on :class:`http.client.HTTPConnection` but provides an extra constructor
+    backwards-compatibility layer between older and newer Pythons.
+
+    Additional keyword parameters are used to configure attributes of the connection.
+    Accepted parameters include:
+
+    - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool`
+    - ``source_address``: Set the source address for the current connection.
+    - ``socket_options``: Set specific options on the underlying socket. If not specified, then
+      defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling
+      Nagle's algorithm (sets TCP_NODELAY to 1) unless the connection is behind a proxy.
+
+      For example, if you wish to enable TCP Keep Alive in addition to the defaults,
+      you might pass:
+
+      .. code-block:: python
+
+         HTTPConnection.default_socket_options + [
+             (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1),
+         ]
+
+      Or you may want to disable the defaults by passing an empty list (e.g., ``[]``).
+    """
+
+    default_port = port_by_scheme["http"]
+
+    #: Disable Nagle's algorithm by default.
+    #: ``[(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]``
+    default_socket_options = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]
+
+    #: Whether this connection verifies the host's certificate.
+    is_verified = False
+
+    #: Whether this proxy connection (if used) verifies the proxy host's
+    #: certificate.
+    proxy_is_verified = None
+
+    def __init__(self, *args, **kw):
+        if not six.PY2:
+            kw.pop("strict", None)
+
+        # Pre-set source_address.
+        self.source_address = kw.get("source_address")
+
+        #: The socket options provided by the user. If no options are
+        #: provided, we use the default options.
+        self.socket_options = kw.pop("socket_options", self.default_socket_options)
+
+        # Proxy options provided by the user.
+        self.proxy = kw.pop("proxy", None)
+        self.proxy_config = kw.pop("proxy_config", None)
+
+        _HTTPConnection.__init__(self, *args, **kw)
+
+    @property
+    def host(self):
+        """
+        Getter method to remove any trailing dots that indicate the hostname is an FQDN.
+
+        In general, SSL certificates don't include the trailing dot indicating a
+        fully-qualified domain name, and thus, they don't validate properly when
+        checked against a domain name that includes the dot. In addition, some
+        servers may not expect to receive the trailing dot when provided.
+
+        However, the hostname with trailing dot is critical to DNS resolution; doing a
+        lookup with the trailing dot will properly only resolve the appropriate FQDN,
+        whereas a lookup without a trailing dot will search the system's search domain
+        list. Thus, it's important to keep the original host around for use only in
+        those cases where it's appropriate (i.e., when doing DNS lookup to establish the
+        actual TCP connection across which we're going to send HTTP requests).
+        """
+        return self._dns_host.rstrip(".")
+
+    @host.setter
+    def host(self, value):
+        """
+        Setter for the `host` property.
+
+        We assume that only urllib3 uses the _dns_host attribute; httplib itself
+        only uses `host`, and it seems reasonable that other libraries follow suit.
+        """
+        self._dns_host = value
+
+    def _new_conn(self):
+        """Establish a socket connection and set nodelay settings on it.
+
+        :return: New socket connection.
+        """
+        extra_kw = {}
+        if self.source_address:
+            extra_kw["source_address"] = self.source_address
+
+        if self.socket_options:
+            extra_kw["socket_options"] = self.socket_options
+
+        try:
+            conn = connection.create_connection(
+                (self._dns_host, self.port), self.timeout, **extra_kw
+            )
+
+        except SocketTimeout:
+            raise ConnectTimeoutError(
+                self,
+                "Connection to %s timed out. (connect timeout=%s)"
+                % (self.host, self.timeout),
+            )
+
+        except SocketError as e:
+            raise NewConnectionError(
+                self, "Failed to establish a new connection: %s" % e
+            )
+
+        return conn
+
+    def _is_using_tunnel(self):
+        # Google App Engine's httplib does not define _tunnel_host
+        return getattr(self, "_tunnel_host", None)
+
+    def _prepare_conn(self, conn):
+        self.sock = conn
+        if self._is_using_tunnel():
+            # TODO: Fix tunnel so it doesn't depend on self.sock state.
+            self._tunnel()
+            # Mark this connection as not reusable
+            self.auto_open = 0
+
+    def connect(self):
+        conn = self._new_conn()
+        self._prepare_conn(conn)
+
+    def putrequest(self, method, url, *args, **kwargs):
+        """ """
+        # Empty docstring because the indentation of CPython's implementation
+        # is broken but we don't want this method in our documentation.
+        match = _CONTAINS_CONTROL_CHAR_RE.search(method)
+        if match:
+            raise ValueError(
+                "Method cannot contain non-token characters %r (found at least %r)"
+                % (method, match.group())
+            )
+
+        return _HTTPConnection.putrequest(self, method, url, *args, **kwargs)
+
+    def putheader(self, header, *values):
+        """ """
+        if not any(isinstance(v, str) and v == SKIP_HEADER for v in values):
+            _HTTPConnection.putheader(self, header, *values)
+        elif six.ensure_str(header.lower()) not in SKIPPABLE_HEADERS:
+            raise ValueError(
+                "urllib3.util.SKIP_HEADER only supports '%s'"
+                % ("', '".join(map(str.title, sorted(SKIPPABLE_HEADERS))),)
+            )
+
+    def request(self, method, url, body=None, headers=None):
+        if headers is None:
+            headers = {}
+        else:
+            # Avoid modifying the headers passed into .request()
+            headers = headers.copy()
+        if "user-agent" not in (six.ensure_str(k.lower()) for k in headers):
+            headers["User-Agent"] = _get_default_user_agent()
+        super(HTTPConnection, self).request(method, url, body=body, headers=headers)
+
+    def request_chunked(self, method, url, body=None, headers=None):
+        """
+        Alternative to the common request method, which sends the
+        body with chunked encoding and not as one block
+        """
+        headers = headers or {}
+        header_keys = set([six.ensure_str(k.lower()) for k in headers])
+        skip_accept_encoding = "accept-encoding" in header_keys
+        skip_host = "host" in header_keys
+        self.putrequest(
+            method, url, skip_accept_encoding=skip_accept_encoding, skip_host=skip_host
+        )
+        if "user-agent" not in header_keys:
+            self.putheader("User-Agent", _get_default_user_agent())
+        for header, value in headers.items():
+            self.putheader(header, value)
+        if "transfer-encoding" not in header_keys:
+            self.putheader("Transfer-Encoding", "chunked")
+        self.endheaders()
+
+        if body is not None:
+            stringish_types = six.string_types + (bytes,)
+            if isinstance(body, stringish_types):
+                body = (body,)
+            for chunk in body:
+                if not chunk:
+                    continue
+                if not isinstance(chunk, bytes):
+                    chunk = chunk.encode("utf8")
+                len_str = hex(len(chunk))[2:]
+                to_send = bytearray(len_str.encode())
+                to_send += b"\r\n"
+                to_send += chunk
+                to_send += b"\r\n"
+                self.send(to_send)
+
+        # After the if clause, to always have a closed body
+        self.send(b"0\r\n\r\n")
+
+
+class HTTPSConnection(HTTPConnection):
+    """
+    Many of the parameters to this constructor are passed to the underlying SSL
+    socket by means of :py:func:`urllib3.util.ssl_wrap_socket`.
+    """
+
+    default_port = port_by_scheme["https"]
+
+    cert_reqs = None
+    ca_certs = None
+    ca_cert_dir = None
+    ca_cert_data = None
+    ssl_version = None
+    assert_fingerprint = None
+    tls_in_tls_required = False
+
+    def __init__(
+        self,
+        host,
+        port=None,
+        key_file=None,
+        cert_file=None,
+        key_password=None,
+        strict=None,
+        timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
+        ssl_context=None,
+        server_hostname=None,
+        **kw
+    ):
+
+        HTTPConnection.__init__(self, host, port, strict=strict, timeout=timeout, **kw)
+
+        self.key_file = key_file
+        self.cert_file = cert_file
+        self.key_password = key_password
+        self.ssl_context = ssl_context
+        self.server_hostname = server_hostname
+
+        # Required property for Google AppEngine 1.9.0 which otherwise causes
+        # HTTPS requests to go out as HTTP. (See Issue #356)
+        self._protocol = "https"
+
+    def set_cert(
+        self,
+        key_file=None,
+        cert_file=None,
+        cert_reqs=None,
+        key_password=None,
+        ca_certs=None,
+        assert_hostname=None,
+        assert_fingerprint=None,
+        ca_cert_dir=None,
+        ca_cert_data=None,
+    ):
+        """
+        This method should only be called once, before the connection is used.
+        """
+        # If cert_reqs is not provided we'll assume CERT_REQUIRED unless we also
+        # have an SSLContext object in which case we'll use its verify_mode.
+        if cert_reqs is None:
+            if self.ssl_context is not None:
+                cert_reqs = self.ssl_context.verify_mode
+            else:
+                cert_reqs = resolve_cert_reqs(None)
+
+        self.key_file = key_file
+        self.cert_file = cert_file
+        self.cert_reqs = cert_reqs
+        self.key_password = key_password
+        self.assert_hostname = assert_hostname
+        self.assert_fingerprint = assert_fingerprint
+        self.ca_certs = ca_certs and os.path.expanduser(ca_certs)
+        self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir)
+        self.ca_cert_data = ca_cert_data
+
+    def connect(self):
+        # Add certificate verification
+        self.sock = conn = self._new_conn()
+        hostname = self.host
+        tls_in_tls = False
+
+        if self._is_using_tunnel():
+            if self.tls_in_tls_required:
+                self.sock = conn = self._connect_tls_proxy(hostname, conn)
+                tls_in_tls = True
+
+            # Calls self._set_hostport(), so self.host is
+            # self._tunnel_host below.
+            self._tunnel()
+            # Mark this connection as not reusable
+            self.auto_open = 0
+
+            # Override the host with the one we're requesting data from.
+            hostname = self._tunnel_host
+
+        server_hostname = hostname
+        if self.server_hostname is not None:
+            server_hostname = self.server_hostname
+
+        is_time_off = datetime.date.today() < RECENT_DATE
+        if is_time_off:
+            warnings.warn(
+                (
+                    "System time is way off (before {0}). This will probably "
+                    "lead to SSL verification errors"
+                ).format(RECENT_DATE),
+                SystemTimeWarning,
+            )
+
+        # Wrap socket using verification with the root certs in
+        # trusted_root_certs
+        default_ssl_context = False
+        if self.ssl_context is None:
+            default_ssl_context = True
+            self.ssl_context = create_urllib3_context(
+                ssl_version=resolve_ssl_version(self.ssl_version),
+                cert_reqs=resolve_cert_reqs(self.cert_reqs),
+            )
+
+        context = self.ssl_context
+        context.verify_mode = resolve_cert_reqs(self.cert_reqs)
+
+        # Try to load OS default certs if none are given.
+        # Works well on Windows (requires Python3.4+)
+        if (
+            not self.ca_certs
+            and not self.ca_cert_dir
+            and not self.ca_cert_data
+            and default_ssl_context
+            and hasattr(context, "load_default_certs")
+        ):
+            context.load_default_certs()
+
+        self.sock = ssl_wrap_socket(
+            sock=conn,
+            keyfile=self.key_file,
+            certfile=self.cert_file,
+            key_password=self.key_password,
+            ca_certs=self.ca_certs,
+            ca_cert_dir=self.ca_cert_dir,
+            ca_cert_data=self.ca_cert_data,
+            server_hostname=server_hostname,
+            ssl_context=context,
+            tls_in_tls=tls_in_tls,
+        )
+
+        # If we're using all defaults and the connection
+        # is TLSv1 or TLSv1.1 we throw a DeprecationWarning
+        # for the host.
+        if (
+            default_ssl_context
+            and self.ssl_version is None
+            and hasattr(self.sock, "version")
+            and self.sock.version() in {"TLSv1", "TLSv1.1"}
+        ):
+            warnings.warn(
+                "Negotiating TLSv1/TLSv1.1 by default is deprecated "
+                "and will be disabled in urllib3 v2.0.0. Connecting to "
+                "'%s' with '%s' can be enabled by explicitly opting-in "
+                "with 'ssl_version'" % (self.host, self.sock.version()),
+                DeprecationWarning,
+            )
+
+        if self.assert_fingerprint:
+            assert_fingerprint(
+                self.sock.getpeercert(binary_form=True), self.assert_fingerprint
+            )
+        elif (
+            context.verify_mode != ssl.CERT_NONE
+            and not getattr(context, "check_hostname", False)
+            and self.assert_hostname is not False
+        ):
+            # While urllib3 attempts to always turn off hostname matching from
+            # the TLS library, this cannot always be done. So we check whether
+            # the TLS Library still thinks it's matching hostnames.
+            cert = self.sock.getpeercert()
+            if not cert.get("subjectAltName", ()):
+                warnings.warn(
+                    (
+                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
+                        "`commonName` for now. This feature is being removed by major browsers and "
+                        "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 "
+                        "for details.)".format(hostname)
+                    ),
+                    SubjectAltNameWarning,
+                )
+            _match_hostname(cert, self.assert_hostname or server_hostname)
+
+        self.is_verified = (
+            context.verify_mode == ssl.CERT_REQUIRED
+            or self.assert_fingerprint is not None
+        )
+
+    def _connect_tls_proxy(self, hostname, conn):
+        """
+        Establish a TLS connection to the proxy using the provided SSL context.
+        """
+        proxy_config = self.proxy_config
+        ssl_context = proxy_config.ssl_context
+        if ssl_context:
+            # If the user provided a proxy context, we assume CA and client
+            # certificates have already been set
+            return ssl_wrap_socket(
+                sock=conn,
+                server_hostname=hostname,
+                ssl_context=ssl_context,
+            )
+
+        ssl_context = create_proxy_ssl_context(
+            self.ssl_version,
+            self.cert_reqs,
+            self.ca_certs,
+            self.ca_cert_dir,
+            self.ca_cert_data,
+        )
+
+        # If no cert was provided, use only the default options for server
+        # certificate validation
+        socket = ssl_wrap_socket(
+            sock=conn,
+            ca_certs=self.ca_certs,
+            ca_cert_dir=self.ca_cert_dir,
+            ca_cert_data=self.ca_cert_data,
+            server_hostname=hostname,
+            ssl_context=ssl_context,
+        )
+
+        if ssl_context.verify_mode != ssl.CERT_NONE and not getattr(
+            ssl_context, "check_hostname", False
+        ):
+            # While urllib3 attempts to always turn off hostname matching from
+            # the TLS library, this cannot always be done. So we check whether
+            # the TLS Library still thinks it's matching hostnames.
+            cert = socket.getpeercert()
+            if not cert.get("subjectAltName", ()):
+                warnings.warn(
+                    (
+                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
+                        "`commonName` for now. This feature is being removed by major browsers and "
+                        "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 "
+                        "for details.)".format(hostname)
+                    ),
+                    SubjectAltNameWarning,
+                )
+            _match_hostname(cert, hostname)
+
+        self.proxy_is_verified = ssl_context.verify_mode == ssl.CERT_REQUIRED
+        return socket
+
+
+def _match_hostname(cert, asserted_hostname):
+    # Our upstream implementation of ssl.match_hostname()
+    # only applies this normalization to IP addresses so it doesn't
+    # match DNS SANs so we do the same thing!
+    stripped_hostname = asserted_hostname.strip("u[]")
+    if is_ipaddress(stripped_hostname):
+        asserted_hostname = stripped_hostname
+
+    try:
+        match_hostname(cert, asserted_hostname)
+    except CertificateError as e:
+        log.warning(
+            "Certificate did not match expected hostname: %s. Certificate: %s",
+            asserted_hostname,
+            cert,
+        )
+        # Add cert to exception and reraise so client code can inspect
+        # the cert when catching the exception, if they want to
+        e._peer_cert = cert
+        raise
+
+
+def _get_default_user_agent():
+    return "python-urllib3/%s" % __version__
+
+
+class DummyConnection(object):
+    """Used to detect a failed ConnectionCls import."""
+
+    pass
+
+
+if not ssl:
+    HTTPSConnection = DummyConnection  # noqa: F811
+
+
+VerifiedHTTPSConnection = HTTPSConnection
diff --git a/openpype/vendor/python/python_2/urllib3/connectionpool.py b/openpype/vendor/python/python_2/urllib3/connectionpool.py
new file mode 100644
index 0000000000..15bffcb23a
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/connectionpool.py
@@ -0,0 +1,1108 @@
+from __future__ import absolute_import
+
+import errno
+import logging
+import re
+import socket
+import sys
+import warnings
+from socket import error as SocketError
+from socket import timeout as SocketTimeout
+
+from .connection import (
+    BaseSSLError,
+    BrokenPipeError,
+    DummyConnection,
+    HTTPConnection,
+    HTTPException,
+    HTTPSConnection,
+    VerifiedHTTPSConnection,
+    port_by_scheme,
+)
+from .exceptions import (
+    ClosedPoolError,
+    EmptyPoolError,
+    HeaderParsingError,
+    HostChangedError,
+    InsecureRequestWarning,
+    LocationValueError,
+    MaxRetryError,
+    NewConnectionError,
+    ProtocolError,
+    ProxyError,
+    ReadTimeoutError,
+    SSLError,
+    TimeoutError,
+)
+from .packages import six
+from .packages.six.moves import queue
+from .request import RequestMethods
+from .response import HTTPResponse
+from .util.connection import is_connection_dropped
+from .util.proxy import connection_requires_http_tunnel
+from .util.queue import LifoQueue
+from .util.request import set_file_position
+from .util.response import assert_header_parsing
+from .util.retry import Retry
+from .util.ssl_match_hostname import CertificateError
+from .util.timeout import Timeout
+from .util.url import Url, _encode_target
+from .util.url import _normalize_host as normalize_host
+from .util.url import get_host, parse_url
+
+xrange = six.moves.xrange
+
+log = logging.getLogger(__name__)
+
+_Default = object()
+
+
+# Pool objects
+class ConnectionPool(object):
+    """
+    Base class for all connection pools, such as
+    :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
+
+    .. note::
+       ConnectionPool.urlopen() does not normalize or percent-encode target URIs
+       which is useful if your target server doesn't support percent-encoded
+       target URIs.
+    """
+
+    scheme = None
+    QueueCls = LifoQueue
+
+    def __init__(self, host, port=None):
+        if not host:
+            raise LocationValueError("No host specified.")
+
+        self.host = _normalize_host(host, scheme=self.scheme)
+        self._proxy_host = host.lower()
+        self.port = port
+
+    def __str__(self):
+        return "%s(host=%r, port=%r)" % (type(self).__name__, self.host, self.port)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        # Return False to re-raise any potential exceptions
+        return False
+
+    def close(self):
+        """
+        Close all pooled connections and disable the pool.
+        """
+        pass
+
+
+# This is taken from http://hg.python.org/cpython/file/7aaba721ebc0/Lib/socket.py#l252
+_blocking_errnos = {errno.EAGAIN, errno.EWOULDBLOCK}
+
+
+class HTTPConnectionPool(ConnectionPool, RequestMethods):
+    """
+    Thread-safe connection pool for one host.
+
+    :param host:
+        Host used for this HTTP Connection (e.g. "localhost"), passed into
+        :class:`http.client.HTTPConnection`.
+
+    :param port:
+        Port used for this HTTP Connection (None is equivalent to 80), passed
+        into :class:`http.client.HTTPConnection`.
+
+    :param strict:
+        Causes BadStatusLine to be raised if the status line can't be parsed
+        as a valid HTTP/1.0 or 1.1 status line, passed into
+        :class:`http.client.HTTPConnection`.
+
+        .. note::
+           Only works in Python 2. This parameter is ignored in Python 3.
+
+    :param timeout:
+        Socket timeout in seconds for each individual connection. This can
+        be a float or integer, which sets the timeout for the HTTP request,
+        or an instance of :class:`urllib3.util.Timeout` which gives you more
+        fine-grained control over request timeouts. After the constructor has
+        been parsed, this is always a `urllib3.util.Timeout` object.
+
+    :param maxsize:
+        Number of connections to save that can be reused. More than 1 is useful
+        in multithreaded situations. If ``block`` is set to False, more
+        connections will be created but they will not be saved once they've
+        been used.
+
+    :param block:
+        If set to True, no more than ``maxsize`` connections will be used at
+        a time. When no free connections are available, the call will block
+        until a connection has been released. This is a useful side effect for
+        particular multithreaded situations where one does not want to use more
+        than maxsize connections per host to prevent flooding.
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+
+    :param retries:
+        Retry configuration to use by default with requests in this pool.
+
+    :param _proxy:
+        Parsed proxy URL, should not be used directly, instead, see
+        :class:`urllib3.ProxyManager`
+
+    :param _proxy_headers:
+        A dictionary with proxy headers, should not be used directly,
+        instead, see :class:`urllib3.ProxyManager`
+
+    :param \\**conn_kw:
+        Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`,
+        :class:`urllib3.connection.HTTPSConnection` instances.
+    """
+
+    scheme = "http"
+    ConnectionCls = HTTPConnection
+    ResponseCls = HTTPResponse
+
+    def __init__(
+        self,
+        host,
+        port=None,
+        strict=False,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        maxsize=1,
+        block=False,
+        headers=None,
+        retries=None,
+        _proxy=None,
+        _proxy_headers=None,
+        _proxy_config=None,
+        **conn_kw
+    ):
+        ConnectionPool.__init__(self, host, port)
+        RequestMethods.__init__(self, headers)
+
+        self.strict = strict
+
+        if not isinstance(timeout, Timeout):
+            timeout = Timeout.from_float(timeout)
+
+        if retries is None:
+            retries = Retry.DEFAULT
+
+        self.timeout = timeout
+        self.retries = retries
+
+        self.pool = self.QueueCls(maxsize)
+        self.block = block
+
+        self.proxy = _proxy
+        self.proxy_headers = _proxy_headers or {}
+        self.proxy_config = _proxy_config
+
+        # Fill the queue up so that doing get() on it will block properly
+        for _ in xrange(maxsize):
+            self.pool.put(None)
+
+        # These are mostly for testing and debugging purposes.
+        self.num_connections = 0
+        self.num_requests = 0
+        self.conn_kw = conn_kw
+
+        if self.proxy:
+            # Enable Nagle's algorithm for proxies, to avoid packet fragmentation.
+            # We cannot know if the user has added default socket options, so we cannot replace the
+            # list.
+            self.conn_kw.setdefault("socket_options", [])
+
+            self.conn_kw["proxy"] = self.proxy
+            self.conn_kw["proxy_config"] = self.proxy_config
+
+    def _new_conn(self):
+        """
+        Return a fresh :class:`HTTPConnection`.
+        """
+        self.num_connections += 1
+        log.debug(
+            "Starting new HTTP connection (%d): %s:%s",
+            self.num_connections,
+            self.host,
+            self.port or "80",
+        )
+
+        conn = self.ConnectionCls(
+            host=self.host,
+            port=self.port,
+            timeout=self.timeout.connect_timeout,
+            strict=self.strict,
+            **self.conn_kw
+        )
+        return conn
+
+    def _get_conn(self, timeout=None):
+        """
+        Get a connection. Will return a pooled connection if one is available.
+
+        If no connections are available and :prop:`.block` is ``False``, then a
+        fresh connection is returned.
+
+        :param timeout:
+            Seconds to wait before giving up and raising
+            :class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and
+            :prop:`.block` is ``True``.
+        """
+        conn = None
+        try:
+            conn = self.pool.get(block=self.block, timeout=timeout)
+
+        except AttributeError:  # self.pool is None
+            raise ClosedPoolError(self, "Pool is closed.")
+
+        except queue.Empty:
+            if self.block:
+                raise EmptyPoolError(
+                    self,
+                    "Pool reached maximum size and no more connections are allowed.",
+                )
+            pass  # Oh well, we'll create a new connection then
+
+        # If this is a persistent connection, check if it got disconnected
+        if conn and is_connection_dropped(conn):
+            log.debug("Resetting dropped connection: %s", self.host)
+            conn.close()
+            if getattr(conn, "auto_open", 1) == 0:
+                # This is a proxied connection that has been mutated by
+                # http.client._tunnel() and cannot be reused (since it would
+                # attempt to bypass the proxy)
+                conn = None
+
+        return conn or self._new_conn()
+
+    def _put_conn(self, conn):
+        """
+        Put a connection back into the pool.
+
+        :param conn:
+            Connection object for the current host and port as returned by
+            :meth:`._new_conn` or :meth:`._get_conn`.
+
+        If the pool is already full, the connection is closed and discarded
+        because we exceeded maxsize. If connections are discarded frequently,
+        then maxsize should be increased.
+
+        If the pool is closed, then the connection will be closed and discarded.
+        """
+        try:
+            self.pool.put(conn, block=False)
+            return  # Everything is dandy, done.
+        except AttributeError:
+            # self.pool is None.
+            pass
+        except queue.Full:
+            # This should never happen if self.block == True
+            log.warning(
+                "Connection pool is full, discarding connection: %s. Connection pool size: %s",
+                self.host,
+                self.pool.qsize(),
+            )
+        # Connection never got put back into the pool, close it.
+        if conn:
+            conn.close()
+
+    def _validate_conn(self, conn):
+        """
+        Called right before a request is made, after the socket is created.
+        """
+        pass
+
+    def _prepare_proxy(self, conn):
+        # Nothing to do for HTTP connections.
+        pass
+
+    def _get_timeout(self, timeout):
+        """Helper that always returns a :class:`urllib3.util.Timeout`"""
+        if timeout is _Default:
+            return self.timeout.clone()
+
+        if isinstance(timeout, Timeout):
+            return timeout.clone()
+        else:
+            # User passed us an int/float. This is for backwards compatibility,
+            # can be removed later
+            return Timeout.from_float(timeout)
+
+    def _raise_timeout(self, err, url, timeout_value):
+        """Is the error actually a timeout? Will raise a ReadTimeout or pass"""
+
+        if isinstance(err, SocketTimeout):
+            raise ReadTimeoutError(
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
+
+        # See the above comment about EAGAIN in Python 3. In Python 2 we have
+        # to specifically catch it and throw the timeout error
+        if hasattr(err, "errno") and err.errno in _blocking_errnos:
+            raise ReadTimeoutError(
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
+
+        # Catch possible read timeouts thrown as SSL errors. If not the
+        # case, rethrow the original. We need to do this because of:
+        # http://bugs.python.org/issue10272
+        if "timed out" in str(err) or "did not complete (read)" in str(
+            err
+        ):  # Python < 2.7.4
+            raise ReadTimeoutError(
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
+
+    def _make_request(
+        self, conn, method, url, timeout=_Default, chunked=False, **httplib_request_kw
+    ):
+        """
+        Perform a request on a given urllib connection object taken from our
+        pool.
+
+        :param conn:
+            a connection from one of our connection pools
+
+        :param timeout:
+            Socket timeout in seconds for the request. This can be a
+            float or integer, which will set the same timeout value for
+            the socket connect and the socket read, or an instance of
+            :class:`urllib3.util.Timeout`, which gives you more fine-grained
+            control over your timeouts.
+        """
+        self.num_requests += 1
+
+        timeout_obj = self._get_timeout(timeout)
+        timeout_obj.start_connect()
+        conn.timeout = timeout_obj.connect_timeout
+
+        # Trigger any extra validation we need to do.
+        try:
+            self._validate_conn(conn)
+        except (SocketTimeout, BaseSSLError) as e:
+            # Py2 raises this as a BaseSSLError, Py3 raises it as socket timeout.
+            self._raise_timeout(err=e, url=url, timeout_value=conn.timeout)
+            raise
+
+        # conn.request() calls http.client.*.request, not the method in
+        # urllib3.request. It also calls makefile (recv) on the socket.
+        try:
+            if chunked:
+                conn.request_chunked(method, url, **httplib_request_kw)
+            else:
+                conn.request(method, url, **httplib_request_kw)
+
+        # We are swallowing BrokenPipeError (errno.EPIPE) since the server is
+        # legitimately able to close the connection after sending a valid response.
+        # With this behaviour, the received response is still readable.
+        except BrokenPipeError:
+            # Python 3
+            pass
+        except IOError as e:
+            # Python 2 and macOS/Linux
+            # EPIPE and ESHUTDOWN are BrokenPipeError on Python 2, and EPROTOTYPE is needed on macOS
+            # https://erickt.github.io/blog/2014/11/19/adventures-in-debugging-a-potential-osx-kernel-bug/
+            if e.errno not in {
+                errno.EPIPE,
+                errno.ESHUTDOWN,
+                errno.EPROTOTYPE,
+            }:
+                raise
+
+        # Reset the timeout for the recv() on the socket
+        read_timeout = timeout_obj.read_timeout
+
+        # App Engine doesn't have a sock attr
+        if getattr(conn, "sock", None):
+            # In Python 3 socket.py will catch EAGAIN and return None when you
+            # try and read into the file pointer created by http.client, which
+            # instead raises a BadStatusLine exception. Instead of catching
+            # the exception and assuming all BadStatusLine exceptions are read
+            # timeouts, check for a zero timeout before making the request.
+            if read_timeout == 0:
+                raise ReadTimeoutError(
+                    self, url, "Read timed out. (read timeout=%s)" % read_timeout
+                )
+            if read_timeout is Timeout.DEFAULT_TIMEOUT:
+                conn.sock.settimeout(socket.getdefaulttimeout())
+            else:  # None or a value
+                conn.sock.settimeout(read_timeout)
+
+        # Receive the response from the server
+        try:
+            try:
+                # Python 2.7, use buffering of HTTP responses
+                httplib_response = conn.getresponse(buffering=True)
+            except TypeError:
+                # Python 3
+                try:
+                    httplib_response = conn.getresponse()
+                except BaseException as e:
+                    # Remove the TypeError from the exception chain in
+                    # Python 3 (including for exceptions like SystemExit).
+                    # Otherwise it looks like a bug in the code.
+                    six.raise_from(e, None)
+        except (SocketTimeout, BaseSSLError, SocketError) as e:
+            self._raise_timeout(err=e, url=url, timeout_value=read_timeout)
+            raise
+
+        # AppEngine doesn't have a version attr.
+        http_version = getattr(conn, "_http_vsn_str", "HTTP/?")
+        log.debug(
+            '%s://%s:%s "%s %s %s" %s %s',
+            self.scheme,
+            self.host,
+            self.port,
+            method,
+            url,
+            http_version,
+            httplib_response.status,
+            httplib_response.length,
+        )
+
+        try:
+            assert_header_parsing(httplib_response.msg)
+        except (HeaderParsingError, TypeError) as hpe:  # Platform-specific: Python 3
+            log.warning(
+                "Failed to parse headers (url=%s): %s",
+                self._absolute_url(url),
+                hpe,
+                exc_info=True,
+            )
+
+        return httplib_response
+
+    def _absolute_url(self, path):
+        return Url(scheme=self.scheme, host=self.host, port=self.port, path=path).url
+
+    def close(self):
+        """
+        Close all pooled connections and disable the pool.
+        """
+        if self.pool is None:
+            return
+        # Disable access to the pool
+        old_pool, self.pool = self.pool, None
+
+        try:
+            while True:
+                conn = old_pool.get(block=False)
+                if conn:
+                    conn.close()
+
+        except queue.Empty:
+            pass  # Done.
+
+    def is_same_host(self, url):
+        """
+        Check if the given ``url`` is a member of the same host as this
+        connection pool.
+        """
+        if url.startswith("/"):
+            return True
+
+        # TODO: Add optional support for socket.gethostbyname checking.
+        scheme, host, port = get_host(url)
+        if host is not None:
+            host = _normalize_host(host, scheme=scheme)
+
+        # Use explicit default port for comparison when none is given
+        if self.port and not port:
+            port = port_by_scheme.get(scheme)
+        elif not self.port and port == port_by_scheme.get(scheme):
+            port = None
+
+        return (scheme, host, port) == (self.scheme, self.host, self.port)
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=None,
+        redirect=True,
+        assert_same_host=True,
+        timeout=_Default,
+        pool_timeout=None,
+        release_conn=None,
+        chunked=False,
+        body_pos=None,
+        **response_kw
+    ):
+        """
+        Get a connection from the pool and perform an HTTP request. This is the
+        lowest level call for making a request, so you'll need to specify all
+        the raw details.
+
+        .. note::
+
+           More commonly, it's appropriate to use a convenience method provided
+           by :class:`.RequestMethods`, such as :meth:`request`.
+
+        .. note::
+
+           `release_conn` will only behave as expected if
+           `preload_content=False` because we want to make
+           `preload_content=False` the default behaviour someday soon without
+           breaking backwards compatibility.
+
+        :param method:
+            HTTP request method (such as GET, POST, PUT, etc.)
+
+        :param url:
+            The URL to perform the request on.
+
+        :param body:
+            Data to send in the request body, either :class:`str`, :class:`bytes`,
+            an iterable of :class:`str`/:class:`bytes`, or a file-like object.
+
+        :param headers:
+            Dictionary of custom headers to send, such as User-Agent,
+            If-None-Match, etc. If None, pool headers are used. If provided,
+            these headers completely replace any pool-specific headers.
+
+        :param retries:
+            Configure the number of retries to allow before raising a
+            :class:`~urllib3.exceptions.MaxRetryError` exception.
+
+            Pass ``None`` to retry until you receive a response. Pass a
+            :class:`~urllib3.util.retry.Retry` object for fine-grained control
+            over different types of retries.
+            Pass an integer number to retry connection errors that many times,
+            but no other types of errors. Pass zero to never retry.
+
+            If ``False``, then retries are disabled and any exception is raised
+            immediately. Also, instead of raising a MaxRetryError on redirects,
+            the redirect response will be returned.
+
+        :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.
+
+        :param redirect:
+            If True, automatically handle redirects (status codes 301, 302,
+            303, 307, 308). Each redirect counts as a retry. Disabling retries
+            will disable redirect, too.
+
+        :param assert_same_host:
+            If ``True``, will make sure that the host of the pool requests is
+            consistent else will raise HostChangedError. When ``False``, you can
+            use the pool on an HTTP proxy and request foreign hosts.
+
+        :param timeout:
+            If specified, overrides the default timeout for this one
+            request. It may be a float (in seconds) or an instance of
+            :class:`urllib3.util.Timeout`.
+
+        :param pool_timeout:
+            If set and the pool is set to block=True, then this method will
+            block for ``pool_timeout`` seconds and raise EmptyPoolError if no
+            connection is available within the time period.
+
+        :param release_conn:
+            If False, then the urlopen call will not release the connection
+            back into the pool once a response is received (but will release if
+            you read the entire contents of the response such as when
+            `preload_content=True`). This is useful if you're not preloading
+            the response's content immediately. You will need to call
+            ``r.release_conn()`` on the response ``r`` to return the connection
+            back into the pool. If None, it takes the value of
+            ``response_kw.get('preload_content', True)``.
+
+        :param chunked:
+            If True, urllib3 will send the body using chunked transfer
+            encoding. Otherwise, urllib3 will send the body using the standard
+            content-length form. Defaults to False.
+
+        :param int body_pos:
+            Position to seek to in file-like body in the event of a retry or
+            redirect. Typically this won't need to be set because urllib3 will
+            auto-populate the value when needed.
+
+        :param \\**response_kw:
+            Additional parameters are passed to
+            :meth:`urllib3.response.HTTPResponse.from_httplib`
+        """
+
+        parsed_url = parse_url(url)
+        destination_scheme = parsed_url.scheme
+
+        if headers is None:
+            headers = self.headers
+
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
+
+        if release_conn is None:
+            release_conn = response_kw.get("preload_content", True)
+
+        # Check host
+        if assert_same_host and not self.is_same_host(url):
+            raise HostChangedError(self, url, retries)
+
+        # Ensure that the URL we're connecting to is properly encoded
+        if url.startswith("/"):
+            url = six.ensure_str(_encode_target(url))
+        else:
+            url = six.ensure_str(parsed_url.url)
+
+        conn = None
+
+        # Track whether `conn` needs to be released before
+        # returning/raising/recursing. Update this variable if necessary, and
+        # leave `release_conn` constant throughout the function. That way, if
+        # the function recurses, the original value of `release_conn` will be
+        # passed down into the recursive call, and its value will be respected.
+        #
+        # See issue #651 [1] for details.
+        #
+        # [1] <https://github.com/urllib3/urllib3/issues/651>
+        release_this_conn = release_conn
+
+        http_tunnel_required = connection_requires_http_tunnel(
+            self.proxy, self.proxy_config, destination_scheme
+        )
+
+        # Merge the proxy headers. Only done when not using HTTP CONNECT. We
+        # have to copy the headers dict so we can safely change it without those
+        # changes being reflected in anyone else's copy.
+        if not http_tunnel_required:
+            headers = headers.copy()
+            headers.update(self.proxy_headers)
+
+        # Must keep the exception bound to a separate variable or else Python 3
+        # complains about UnboundLocalError.
+        err = None
+
+        # Keep track of whether we cleanly exited the except block. This
+        # ensures we do proper cleanup in finally.
+        clean_exit = False
+
+        # Rewind body position, if needed. Record current position
+        # for future rewinds in the event of a redirect/retry.
+        body_pos = set_file_position(body, body_pos)
+
+        try:
+            # Request a connection from the queue.
+            timeout_obj = self._get_timeout(timeout)
+            conn = self._get_conn(timeout=pool_timeout)
+
+            conn.timeout = timeout_obj.connect_timeout
+
+            is_new_proxy_conn = self.proxy is not None and not getattr(
+                conn, "sock", None
+            )
+            if is_new_proxy_conn and http_tunnel_required:
+                self._prepare_proxy(conn)
+
+            # Make the request on the httplib connection object.
+            httplib_response = self._make_request(
+                conn,
+                method,
+                url,
+                timeout=timeout_obj,
+                body=body,
+                headers=headers,
+                chunked=chunked,
+            )
+
+            # If we're going to release the connection in ``finally:``, then
+            # the response doesn't need to know about the connection. Otherwise
+            # it will also try to release it and we'll have a double-release
+            # mess.
+            response_conn = conn if not release_conn else None
+
+            # Pass method to Response for length checking
+            response_kw["request_method"] = method
+
+            # Import httplib's response into our own wrapper object
+            response = self.ResponseCls.from_httplib(
+                httplib_response,
+                pool=self,
+                connection=response_conn,
+                retries=retries,
+                **response_kw
+            )
+
+            # Everything went great!
+            clean_exit = True
+
+        except EmptyPoolError:
+            # Didn't get a connection from the pool, no need to clean up
+            clean_exit = True
+            release_this_conn = False
+            raise
+
+        except (
+            TimeoutError,
+            HTTPException,
+            SocketError,
+            ProtocolError,
+            BaseSSLError,
+            SSLError,
+            CertificateError,
+        ) as e:
+            # Discard the connection for these exceptions. It will be
+            # replaced during the next _get_conn() call.
+            clean_exit = False
+
+            def _is_ssl_error_message_from_http_proxy(ssl_error):
+                # We're trying to detect the message 'WRONG_VERSION_NUMBER' but
+                # SSLErrors are kinda all over the place when it comes to the message,
+                # so we try to cover our bases here!
+                message = " ".join(re.split("[^a-z]", str(ssl_error).lower()))
+                return (
+                    "wrong version number" in message or "unknown protocol" in message
+                )
+
+            # Try to detect a common user error with proxies which is to
+            # set an HTTP proxy to be HTTPS when it should be 'http://'
+            # (ie {'http': 'http://proxy', 'https': 'https://proxy'})
+            # Instead we add a nice error message and point to a URL.
+            if (
+                isinstance(e, BaseSSLError)
+                and self.proxy
+                and _is_ssl_error_message_from_http_proxy(e)
+            ):
+                e = ProxyError(
+                    "Your proxy appears to only use HTTP and not HTTPS, "
+                    "try changing your proxy URL to be HTTP. See: "
+                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                    "#https-proxy-error-http-proxy",
+                    SSLError(e),
+                )
+            elif isinstance(e, (BaseSSLError, CertificateError)):
+                e = SSLError(e)
+            elif isinstance(e, (SocketError, NewConnectionError)) and self.proxy:
+                e = ProxyError("Cannot connect to proxy.", e)
+            elif isinstance(e, (SocketError, HTTPException)):
+                e = ProtocolError("Connection aborted.", e)
+
+            retries = retries.increment(
+                method, url, error=e, _pool=self, _stacktrace=sys.exc_info()[2]
+            )
+            retries.sleep()
+
+            # Keep track of the error for the retry warning.
+            err = e
+
+        finally:
+            if not clean_exit:
+                # We hit some kind of exception, handled or otherwise. We need
+                # to throw the connection away unless explicitly told not to.
+                # Close the connection, set the variable to None, and make sure
+                # we put the None back in the pool to avoid leaking it.
+                conn = conn and conn.close()
+                release_this_conn = True
+
+            if release_this_conn:
+                # Put the connection back to be reused. If the connection is
+                # expired then it will be None, which will get replaced with a
+                # fresh connection during _get_conn.
+                self._put_conn(conn)
+
+        if not conn:
+            # Try again
+            log.warning(
+                "Retrying (%r) after connection broken by '%r': %s", retries, err, url
+            )
+            return self.urlopen(
+                method,
+                url,
+                body,
+                headers,
+                retries,
+                redirect,
+                assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        # Handle redirect?
+        redirect_location = redirect and response.get_redirect_location()
+        if redirect_location:
+            if response.status == 303:
+                method = "GET"
+
+            try:
+                retries = retries.increment(method, url, response=response, _pool=self)
+            except MaxRetryError:
+                if retries.raise_on_redirect:
+                    response.drain_conn()
+                    raise
+                return response
+
+            response.drain_conn()
+            retries.sleep_for_retry(response)
+            log.debug("Redirecting %s -> %s", url, redirect_location)
+            return self.urlopen(
+                method,
+                redirect_location,
+                body,
+                headers,
+                retries=retries,
+                redirect=redirect,
+                assert_same_host=assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        # Check if we should retry the HTTP response.
+        has_retry_after = bool(response.getheader("Retry-After"))
+        if retries.is_retry(method, response.status, has_retry_after):
+            try:
+                retries = retries.increment(method, url, response=response, _pool=self)
+            except MaxRetryError:
+                if retries.raise_on_status:
+                    response.drain_conn()
+                    raise
+                return response
+
+            response.drain_conn()
+            retries.sleep(response)
+            log.debug("Retry: %s", url)
+            return self.urlopen(
+                method,
+                url,
+                body,
+                headers,
+                retries=retries,
+                redirect=redirect,
+                assert_same_host=assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        return response
+
+
+class HTTPSConnectionPool(HTTPConnectionPool):
+    """
+    Same as :class:`.HTTPConnectionPool`, but HTTPS.
+
+    :class:`.HTTPSConnection` uses one of ``assert_fingerprint``,
+    ``assert_hostname`` and ``host`` in this order to verify connections.
+    If ``assert_hostname`` is False, no verification is done.
+
+    The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs``,
+    ``ca_cert_dir``, ``ssl_version``, ``key_password`` are only used if :mod:`ssl`
+    is available and are fed into :meth:`urllib3.util.ssl_wrap_socket` to upgrade
+    the connection socket into an SSL socket.
+    """
+
+    scheme = "https"
+    ConnectionCls = HTTPSConnection
+
+    def __init__(
+        self,
+        host,
+        port=None,
+        strict=False,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        maxsize=1,
+        block=False,
+        headers=None,
+        retries=None,
+        _proxy=None,
+        _proxy_headers=None,
+        key_file=None,
+        cert_file=None,
+        cert_reqs=None,
+        key_password=None,
+        ca_certs=None,
+        ssl_version=None,
+        assert_hostname=None,
+        assert_fingerprint=None,
+        ca_cert_dir=None,
+        **conn_kw
+    ):
+
+        HTTPConnectionPool.__init__(
+            self,
+            host,
+            port,
+            strict,
+            timeout,
+            maxsize,
+            block,
+            headers,
+            retries,
+            _proxy,
+            _proxy_headers,
+            **conn_kw
+        )
+
+        self.key_file = key_file
+        self.cert_file = cert_file
+        self.cert_reqs = cert_reqs
+        self.key_password = key_password
+        self.ca_certs = ca_certs
+        self.ca_cert_dir = ca_cert_dir
+        self.ssl_version = ssl_version
+        self.assert_hostname = assert_hostname
+        self.assert_fingerprint = assert_fingerprint
+
+    def _prepare_conn(self, conn):
+        """
+        Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket`
+        and establish the tunnel if proxy is used.
+        """
+
+        if isinstance(conn, VerifiedHTTPSConnection):
+            conn.set_cert(
+                key_file=self.key_file,
+                key_password=self.key_password,
+                cert_file=self.cert_file,
+                cert_reqs=self.cert_reqs,
+                ca_certs=self.ca_certs,
+                ca_cert_dir=self.ca_cert_dir,
+                assert_hostname=self.assert_hostname,
+                assert_fingerprint=self.assert_fingerprint,
+            )
+            conn.ssl_version = self.ssl_version
+        return conn
+
+    def _prepare_proxy(self, conn):
+        """
+        Establishes a tunnel connection through HTTP CONNECT.
+
+        Tunnel connection is established early because otherwise httplib would
+        improperly set Host: header to proxy's IP:port.
+        """
+
+        conn.set_tunnel(self._proxy_host, self.port, self.proxy_headers)
+
+        if self.proxy.scheme == "https":
+            conn.tls_in_tls_required = True
+
+        conn.connect()
+
+    def _new_conn(self):
+        """
+        Return a fresh :class:`http.client.HTTPSConnection`.
+        """
+        self.num_connections += 1
+        log.debug(
+            "Starting new HTTPS connection (%d): %s:%s",
+            self.num_connections,
+            self.host,
+            self.port or "443",
+        )
+
+        if not self.ConnectionCls or self.ConnectionCls is DummyConnection:
+            raise SSLError(
+                "Can't connect to HTTPS URL because the SSL module is not available."
+            )
+
+        actual_host = self.host
+        actual_port = self.port
+        if self.proxy is not None:
+            actual_host = self.proxy.host
+            actual_port = self.proxy.port
+
+        conn = self.ConnectionCls(
+            host=actual_host,
+            port=actual_port,
+            timeout=self.timeout.connect_timeout,
+            strict=self.strict,
+            cert_file=self.cert_file,
+            key_file=self.key_file,
+            key_password=self.key_password,
+            **self.conn_kw
+        )
+
+        return self._prepare_conn(conn)
+
+    def _validate_conn(self, conn):
+        """
+        Called right before a request is made, after the socket is created.
+        """
+        super(HTTPSConnectionPool, self)._validate_conn(conn)
+
+        # Force connect early to allow us to validate the connection.
+        if not getattr(conn, "sock", None):  # AppEngine might not have  `.sock`
+            conn.connect()
+
+        if not conn.is_verified:
+            warnings.warn(
+                (
+                    "Unverified HTTPS request is being made to host '%s'. "
+                    "Adding certificate verification is strongly advised. See: "
+                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                    "#ssl-warnings" % conn.host
+                ),
+                InsecureRequestWarning,
+            )
+
+        if getattr(conn, "proxy_is_verified", None) is False:
+            warnings.warn(
+                (
+                    "Unverified HTTPS connection done to an HTTPS proxy. "
+                    "Adding certificate verification is strongly advised. See: "
+                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                    "#ssl-warnings"
+                ),
+                InsecureRequestWarning,
+            )
+
+
+def connection_from_url(url, **kw):
+    """
+    Given a url, return an :class:`.ConnectionPool` instance of its host.
+
+    This is a shortcut for not having to parse out the scheme, host, and port
+    of the url before creating an :class:`.ConnectionPool` instance.
+
+    :param url:
+        Absolute URL string that must include the scheme. Port is optional.
+
+    :param \\**kw:
+        Passes additional parameters to the constructor of the appropriate
+        :class:`.ConnectionPool`. Useful for specifying things like
+        timeout, maxsize, headers, etc.
+
+    Example::
+
+        >>> conn = connection_from_url('http://google.com/')
+        >>> r = conn.request('GET', '/')
+    """
+    scheme, host, port = get_host(url)
+    port = port or port_by_scheme.get(scheme, 80)
+    if scheme == "https":
+        return HTTPSConnectionPool(host, port=port, **kw)
+    else:
+        return HTTPConnectionPool(host, port=port, **kw)
+
+
+def _normalize_host(host, scheme):
+    """
+    Normalize hosts for comparisons and use with sockets.
+    """
+
+    host = normalize_host(host, scheme)
+
+    # httplib doesn't like it when we include brackets in IPv6 addresses
+    # Specifically, if we include brackets but also pass the port then
+    # httplib crazily doubles up the square brackets on the Host header.
+    # Instead, we need to make sure we never pass ``None`` as the port.
+    # However, for backward compatibility reasons we can't actually
+    # *assert* that.  See http://bugs.python.org/issue28539
+    if host.startswith("[") and host.endswith("]"):
+        host = host[1:-1]
+    return host
diff --git a/openpype/vendor/python/python_2/urllib3/contrib/__init__.py b/openpype/vendor/python/python_2/urllib3/contrib/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/vendor/python/python_2/urllib3/contrib/_appengine_environ.py b/openpype/vendor/python/python_2/urllib3/contrib/_appengine_environ.py
new file mode 100644
index 0000000000..8765b907d7
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/contrib/_appengine_environ.py
@@ -0,0 +1,36 @@
+"""
+This module provides means to detect the App Engine environment.
+"""
+
+import os
+
+
+def is_appengine():
+    return is_local_appengine() or is_prod_appengine()
+
+
+def is_appengine_sandbox():
+    """Reports if the app is running in the first generation sandbox.
+
+    The second generation runtimes are technically still in a sandbox, but it
+    is much less restrictive, so generally you shouldn't need to check for it.
+    see https://cloud.google.com/appengine/docs/standard/runtimes
+    """
+    return is_appengine() and os.environ["APPENGINE_RUNTIME"] == "python27"
+
+
+def is_local_appengine():
+    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
+        "SERVER_SOFTWARE", ""
+    ).startswith("Development/")
+
+
+def is_prod_appengine():
+    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
+        "SERVER_SOFTWARE", ""
+    ).startswith("Google App Engine/")
+
+
+def is_prod_appengine_mvms():
+    """Deprecated."""
+    return False
diff --git a/openpype/vendor/python/python_2/urllib3/contrib/_securetransport/__init__.py b/openpype/vendor/python/python_2/urllib3/contrib/_securetransport/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/vendor/python/python_2/urllib3/contrib/_securetransport/bindings.py b/openpype/vendor/python/python_2/urllib3/contrib/_securetransport/bindings.py
new file mode 100644
index 0000000000..264d564dbd
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/contrib/_securetransport/bindings.py
@@ -0,0 +1,519 @@
+"""
+This module uses ctypes to bind a whole bunch of functions and constants from
+SecureTransport. The goal here is to provide the low-level API to
+SecureTransport. These are essentially the C-level functions and constants, and
+they're pretty gross to work with.
+
+This code is a bastardised version of the code found in Will Bond's oscrypto
+library. An enormous debt is owed to him for blazing this trail for us. For
+that reason, this code should be considered to be covered both by urllib3's
+license and by oscrypto's:
+
+    Copyright (c) 2015-2016 Will Bond <will@wbond.net>
+
+    Permission is hereby granted, free of charge, to any person obtaining a
+    copy of this software and associated documentation files (the "Software"),
+    to deal in the Software without restriction, including without limitation
+    the rights to use, copy, modify, merge, publish, distribute, sublicense,
+    and/or sell copies of the Software, and to permit persons to whom the
+    Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+    DEALINGS IN THE SOFTWARE.
+"""
+from __future__ import absolute_import
+
+import platform
+from ctypes import (
+    CDLL,
+    CFUNCTYPE,
+    POINTER,
+    c_bool,
+    c_byte,
+    c_char_p,
+    c_int32,
+    c_long,
+    c_size_t,
+    c_uint32,
+    c_ulong,
+    c_void_p,
+)
+from ctypes.util import find_library
+
+from ...packages.six import raise_from
+
+if platform.system() != "Darwin":
+    raise ImportError("Only macOS is supported")
+
+version = platform.mac_ver()[0]
+version_info = tuple(map(int, version.split(".")))
+if version_info < (10, 8):
+    raise OSError(
+        "Only OS X 10.8 and newer are supported, not %s.%s"
+        % (version_info[0], version_info[1])
+    )
+
+
+def load_cdll(name, macos10_16_path):
+    """Loads a CDLL by name, falling back to known path on 10.16+"""
+    try:
+        # Big Sur is technically 11 but we use 10.16 due to the Big Sur
+        # beta being labeled as 10.16.
+        if version_info >= (10, 16):
+            path = macos10_16_path
+        else:
+            path = find_library(name)
+        if not path:
+            raise OSError  # Caught and reraised as 'ImportError'
+        return CDLL(path, use_errno=True)
+    except OSError:
+        raise_from(ImportError("The library %s failed to load" % name), None)
+
+
+Security = load_cdll(
+    "Security", "/System/Library/Frameworks/Security.framework/Security"
+)
+CoreFoundation = load_cdll(
+    "CoreFoundation",
+    "/System/Library/Frameworks/CoreFoundation.framework/CoreFoundation",
+)
+
+
+Boolean = c_bool
+CFIndex = c_long
+CFStringEncoding = c_uint32
+CFData = c_void_p
+CFString = c_void_p
+CFArray = c_void_p
+CFMutableArray = c_void_p
+CFDictionary = c_void_p
+CFError = c_void_p
+CFType = c_void_p
+CFTypeID = c_ulong
+
+CFTypeRef = POINTER(CFType)
+CFAllocatorRef = c_void_p
+
+OSStatus = c_int32
+
+CFDataRef = POINTER(CFData)
+CFStringRef = POINTER(CFString)
+CFArrayRef = POINTER(CFArray)
+CFMutableArrayRef = POINTER(CFMutableArray)
+CFDictionaryRef = POINTER(CFDictionary)
+CFArrayCallBacks = c_void_p
+CFDictionaryKeyCallBacks = c_void_p
+CFDictionaryValueCallBacks = c_void_p
+
+SecCertificateRef = POINTER(c_void_p)
+SecExternalFormat = c_uint32
+SecExternalItemType = c_uint32
+SecIdentityRef = POINTER(c_void_p)
+SecItemImportExportFlags = c_uint32
+SecItemImportExportKeyParameters = c_void_p
+SecKeychainRef = POINTER(c_void_p)
+SSLProtocol = c_uint32
+SSLCipherSuite = c_uint32
+SSLContextRef = POINTER(c_void_p)
+SecTrustRef = POINTER(c_void_p)
+SSLConnectionRef = c_uint32
+SecTrustResultType = c_uint32
+SecTrustOptionFlags = c_uint32
+SSLProtocolSide = c_uint32
+SSLConnectionType = c_uint32
+SSLSessionOption = c_uint32
+
+
+try:
+    Security.SecItemImport.argtypes = [
+        CFDataRef,
+        CFStringRef,
+        POINTER(SecExternalFormat),
+        POINTER(SecExternalItemType),
+        SecItemImportExportFlags,
+        POINTER(SecItemImportExportKeyParameters),
+        SecKeychainRef,
+        POINTER(CFArrayRef),
+    ]
+    Security.SecItemImport.restype = OSStatus
+
+    Security.SecCertificateGetTypeID.argtypes = []
+    Security.SecCertificateGetTypeID.restype = CFTypeID
+
+    Security.SecIdentityGetTypeID.argtypes = []
+    Security.SecIdentityGetTypeID.restype = CFTypeID
+
+    Security.SecKeyGetTypeID.argtypes = []
+    Security.SecKeyGetTypeID.restype = CFTypeID
+
+    Security.SecCertificateCreateWithData.argtypes = [CFAllocatorRef, CFDataRef]
+    Security.SecCertificateCreateWithData.restype = SecCertificateRef
+
+    Security.SecCertificateCopyData.argtypes = [SecCertificateRef]
+    Security.SecCertificateCopyData.restype = CFDataRef
+
+    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
+    Security.SecCopyErrorMessageString.restype = CFStringRef
+
+    Security.SecIdentityCreateWithCertificate.argtypes = [
+        CFTypeRef,
+        SecCertificateRef,
+        POINTER(SecIdentityRef),
+    ]
+    Security.SecIdentityCreateWithCertificate.restype = OSStatus
+
+    Security.SecKeychainCreate.argtypes = [
+        c_char_p,
+        c_uint32,
+        c_void_p,
+        Boolean,
+        c_void_p,
+        POINTER(SecKeychainRef),
+    ]
+    Security.SecKeychainCreate.restype = OSStatus
+
+    Security.SecKeychainDelete.argtypes = [SecKeychainRef]
+    Security.SecKeychainDelete.restype = OSStatus
+
+    Security.SecPKCS12Import.argtypes = [
+        CFDataRef,
+        CFDictionaryRef,
+        POINTER(CFArrayRef),
+    ]
+    Security.SecPKCS12Import.restype = OSStatus
+
+    SSLReadFunc = CFUNCTYPE(OSStatus, SSLConnectionRef, c_void_p, POINTER(c_size_t))
+    SSLWriteFunc = CFUNCTYPE(
+        OSStatus, SSLConnectionRef, POINTER(c_byte), POINTER(c_size_t)
+    )
+
+    Security.SSLSetIOFuncs.argtypes = [SSLContextRef, SSLReadFunc, SSLWriteFunc]
+    Security.SSLSetIOFuncs.restype = OSStatus
+
+    Security.SSLSetPeerID.argtypes = [SSLContextRef, c_char_p, c_size_t]
+    Security.SSLSetPeerID.restype = OSStatus
+
+    Security.SSLSetCertificate.argtypes = [SSLContextRef, CFArrayRef]
+    Security.SSLSetCertificate.restype = OSStatus
+
+    Security.SSLSetCertificateAuthorities.argtypes = [SSLContextRef, CFTypeRef, Boolean]
+    Security.SSLSetCertificateAuthorities.restype = OSStatus
+
+    Security.SSLSetConnection.argtypes = [SSLContextRef, SSLConnectionRef]
+    Security.SSLSetConnection.restype = OSStatus
+
+    Security.SSLSetPeerDomainName.argtypes = [SSLContextRef, c_char_p, c_size_t]
+    Security.SSLSetPeerDomainName.restype = OSStatus
+
+    Security.SSLHandshake.argtypes = [SSLContextRef]
+    Security.SSLHandshake.restype = OSStatus
+
+    Security.SSLRead.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
+    Security.SSLRead.restype = OSStatus
+
+    Security.SSLWrite.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
+    Security.SSLWrite.restype = OSStatus
+
+    Security.SSLClose.argtypes = [SSLContextRef]
+    Security.SSLClose.restype = OSStatus
+
+    Security.SSLGetNumberSupportedCiphers.argtypes = [SSLContextRef, POINTER(c_size_t)]
+    Security.SSLGetNumberSupportedCiphers.restype = OSStatus
+
+    Security.SSLGetSupportedCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        POINTER(c_size_t),
+    ]
+    Security.SSLGetSupportedCiphers.restype = OSStatus
+
+    Security.SSLSetEnabledCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        c_size_t,
+    ]
+    Security.SSLSetEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetNumberEnabledCiphers.argtype = [SSLContextRef, POINTER(c_size_t)]
+    Security.SSLGetNumberEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetEnabledCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        POINTER(c_size_t),
+    ]
+    Security.SSLGetEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetNegotiatedCipher.argtypes = [SSLContextRef, POINTER(SSLCipherSuite)]
+    Security.SSLGetNegotiatedCipher.restype = OSStatus
+
+    Security.SSLGetNegotiatedProtocolVersion.argtypes = [
+        SSLContextRef,
+        POINTER(SSLProtocol),
+    ]
+    Security.SSLGetNegotiatedProtocolVersion.restype = OSStatus
+
+    Security.SSLCopyPeerTrust.argtypes = [SSLContextRef, POINTER(SecTrustRef)]
+    Security.SSLCopyPeerTrust.restype = OSStatus
+
+    Security.SecTrustSetAnchorCertificates.argtypes = [SecTrustRef, CFArrayRef]
+    Security.SecTrustSetAnchorCertificates.restype = OSStatus
+
+    Security.SecTrustSetAnchorCertificatesOnly.argstypes = [SecTrustRef, Boolean]
+    Security.SecTrustSetAnchorCertificatesOnly.restype = OSStatus
+
+    Security.SecTrustEvaluate.argtypes = [SecTrustRef, POINTER(SecTrustResultType)]
+    Security.SecTrustEvaluate.restype = OSStatus
+
+    Security.SecTrustGetCertificateCount.argtypes = [SecTrustRef]
+    Security.SecTrustGetCertificateCount.restype = CFIndex
+
+    Security.SecTrustGetCertificateAtIndex.argtypes = [SecTrustRef, CFIndex]
+    Security.SecTrustGetCertificateAtIndex.restype = SecCertificateRef
+
+    Security.SSLCreateContext.argtypes = [
+        CFAllocatorRef,
+        SSLProtocolSide,
+        SSLConnectionType,
+    ]
+    Security.SSLCreateContext.restype = SSLContextRef
+
+    Security.SSLSetSessionOption.argtypes = [SSLContextRef, SSLSessionOption, Boolean]
+    Security.SSLSetSessionOption.restype = OSStatus
+
+    Security.SSLSetProtocolVersionMin.argtypes = [SSLContextRef, SSLProtocol]
+    Security.SSLSetProtocolVersionMin.restype = OSStatus
+
+    Security.SSLSetProtocolVersionMax.argtypes = [SSLContextRef, SSLProtocol]
+    Security.SSLSetProtocolVersionMax.restype = OSStatus
+
+    try:
+        Security.SSLSetALPNProtocols.argtypes = [SSLContextRef, CFArrayRef]
+        Security.SSLSetALPNProtocols.restype = OSStatus
+    except AttributeError:
+        # Supported only in 10.12+
+        pass
+
+    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
+    Security.SecCopyErrorMessageString.restype = CFStringRef
+
+    Security.SSLReadFunc = SSLReadFunc
+    Security.SSLWriteFunc = SSLWriteFunc
+    Security.SSLContextRef = SSLContextRef
+    Security.SSLProtocol = SSLProtocol
+    Security.SSLCipherSuite = SSLCipherSuite
+    Security.SecIdentityRef = SecIdentityRef
+    Security.SecKeychainRef = SecKeychainRef
+    Security.SecTrustRef = SecTrustRef
+    Security.SecTrustResultType = SecTrustResultType
+    Security.SecExternalFormat = SecExternalFormat
+    Security.OSStatus = OSStatus
+
+    Security.kSecImportExportPassphrase = CFStringRef.in_dll(
+        Security, "kSecImportExportPassphrase"
+    )
+    Security.kSecImportItemIdentity = CFStringRef.in_dll(
+        Security, "kSecImportItemIdentity"
+    )
+
+    # CoreFoundation time!
+    CoreFoundation.CFRetain.argtypes = [CFTypeRef]
+    CoreFoundation.CFRetain.restype = CFTypeRef
+
+    CoreFoundation.CFRelease.argtypes = [CFTypeRef]
+    CoreFoundation.CFRelease.restype = None
+
+    CoreFoundation.CFGetTypeID.argtypes = [CFTypeRef]
+    CoreFoundation.CFGetTypeID.restype = CFTypeID
+
+    CoreFoundation.CFStringCreateWithCString.argtypes = [
+        CFAllocatorRef,
+        c_char_p,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringCreateWithCString.restype = CFStringRef
+
+    CoreFoundation.CFStringGetCStringPtr.argtypes = [CFStringRef, CFStringEncoding]
+    CoreFoundation.CFStringGetCStringPtr.restype = c_char_p
+
+    CoreFoundation.CFStringGetCString.argtypes = [
+        CFStringRef,
+        c_char_p,
+        CFIndex,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringGetCString.restype = c_bool
+
+    CoreFoundation.CFDataCreate.argtypes = [CFAllocatorRef, c_char_p, CFIndex]
+    CoreFoundation.CFDataCreate.restype = CFDataRef
+
+    CoreFoundation.CFDataGetLength.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetLength.restype = CFIndex
+
+    CoreFoundation.CFDataGetBytePtr.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetBytePtr.restype = c_void_p
+
+    CoreFoundation.CFDictionaryCreate.argtypes = [
+        CFAllocatorRef,
+        POINTER(CFTypeRef),
+        POINTER(CFTypeRef),
+        CFIndex,
+        CFDictionaryKeyCallBacks,
+        CFDictionaryValueCallBacks,
+    ]
+    CoreFoundation.CFDictionaryCreate.restype = CFDictionaryRef
+
+    CoreFoundation.CFDictionaryGetValue.argtypes = [CFDictionaryRef, CFTypeRef]
+    CoreFoundation.CFDictionaryGetValue.restype = CFTypeRef
+
+    CoreFoundation.CFArrayCreate.argtypes = [
+        CFAllocatorRef,
+        POINTER(CFTypeRef),
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreate.restype = CFArrayRef
+
+    CoreFoundation.CFArrayCreateMutable.argtypes = [
+        CFAllocatorRef,
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreateMutable.restype = CFMutableArrayRef
+
+    CoreFoundation.CFArrayAppendValue.argtypes = [CFMutableArrayRef, c_void_p]
+    CoreFoundation.CFArrayAppendValue.restype = None
+
+    CoreFoundation.CFArrayGetCount.argtypes = [CFArrayRef]
+    CoreFoundation.CFArrayGetCount.restype = CFIndex
+
+    CoreFoundation.CFArrayGetValueAtIndex.argtypes = [CFArrayRef, CFIndex]
+    CoreFoundation.CFArrayGetValueAtIndex.restype = c_void_p
+
+    CoreFoundation.kCFAllocatorDefault = CFAllocatorRef.in_dll(
+        CoreFoundation, "kCFAllocatorDefault"
+    )
+    CoreFoundation.kCFTypeArrayCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeArrayCallBacks"
+    )
+    CoreFoundation.kCFTypeDictionaryKeyCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeDictionaryKeyCallBacks"
+    )
+    CoreFoundation.kCFTypeDictionaryValueCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeDictionaryValueCallBacks"
+    )
+
+    CoreFoundation.CFTypeRef = CFTypeRef
+    CoreFoundation.CFArrayRef = CFArrayRef
+    CoreFoundation.CFStringRef = CFStringRef
+    CoreFoundation.CFDictionaryRef = CFDictionaryRef
+
+except (AttributeError):
+    raise ImportError("Error initializing ctypes")
+
+
+class CFConst(object):
+    """
+    A class object that acts as essentially a namespace for CoreFoundation
+    constants.
+    """
+
+    kCFStringEncodingUTF8 = CFStringEncoding(0x08000100)
+
+
+class SecurityConst(object):
+    """
+    A class object that acts as essentially a namespace for Security constants.
+    """
+
+    kSSLSessionOptionBreakOnServerAuth = 0
+
+    kSSLProtocol2 = 1
+    kSSLProtocol3 = 2
+    kTLSProtocol1 = 4
+    kTLSProtocol11 = 7
+    kTLSProtocol12 = 8
+    # SecureTransport does not support TLS 1.3 even if there's a constant for it
+    kTLSProtocol13 = 10
+    kTLSProtocolMaxSupported = 999
+
+    kSSLClientSide = 1
+    kSSLStreamType = 0
+
+    kSecFormatPEMSequence = 10
+
+    kSecTrustResultInvalid = 0
+    kSecTrustResultProceed = 1
+    # This gap is present on purpose: this was kSecTrustResultConfirm, which
+    # is deprecated.
+    kSecTrustResultDeny = 3
+    kSecTrustResultUnspecified = 4
+    kSecTrustResultRecoverableTrustFailure = 5
+    kSecTrustResultFatalTrustFailure = 6
+    kSecTrustResultOtherError = 7
+
+    errSSLProtocol = -9800
+    errSSLWouldBlock = -9803
+    errSSLClosedGraceful = -9805
+    errSSLClosedNoNotify = -9816
+    errSSLClosedAbort = -9806
+
+    errSSLXCertChainInvalid = -9807
+    errSSLCrypto = -9809
+    errSSLInternal = -9810
+    errSSLCertExpired = -9814
+    errSSLCertNotYetValid = -9815
+    errSSLUnknownRootCert = -9812
+    errSSLNoRootCert = -9813
+    errSSLHostNameMismatch = -9843
+    errSSLPeerHandshakeFail = -9824
+    errSSLPeerUserCancelled = -9839
+    errSSLWeakPeerEphemeralDHKey = -9850
+    errSSLServerAuthCompleted = -9841
+    errSSLRecordOverflow = -9847
+
+    errSecVerifyFailed = -67808
+    errSecNoTrustSettings = -25263
+    errSecItemNotFound = -25300
+    errSecInvalidTrustSettings = -25262
+
+    # Cipher suites. We only pick the ones our default cipher string allows.
+    # Source: https://developer.apple.com/documentation/security/1550981-ssl_cipher_suite_values
+    TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 = 0xC02C
+    TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 = 0xC030
+    TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 = 0xC02B
+    TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 = 0xC02F
+    TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA9
+    TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA8
+    TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 = 0x009F
+    TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 = 0x009E
+    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 = 0xC024
+    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 = 0xC028
+    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA = 0xC00A
+    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA = 0xC014
+    TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 = 0x006B
+    TLS_DHE_RSA_WITH_AES_256_CBC_SHA = 0x0039
+    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 = 0xC023
+    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 = 0xC027
+    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA = 0xC009
+    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA = 0xC013
+    TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 = 0x0067
+    TLS_DHE_RSA_WITH_AES_128_CBC_SHA = 0x0033
+    TLS_RSA_WITH_AES_256_GCM_SHA384 = 0x009D
+    TLS_RSA_WITH_AES_128_GCM_SHA256 = 0x009C
+    TLS_RSA_WITH_AES_256_CBC_SHA256 = 0x003D
+    TLS_RSA_WITH_AES_128_CBC_SHA256 = 0x003C
+    TLS_RSA_WITH_AES_256_CBC_SHA = 0x0035
+    TLS_RSA_WITH_AES_128_CBC_SHA = 0x002F
+    TLS_AES_128_GCM_SHA256 = 0x1301
+    TLS_AES_256_GCM_SHA384 = 0x1302
+    TLS_AES_128_CCM_8_SHA256 = 0x1305
+    TLS_AES_128_CCM_SHA256 = 0x1304
diff --git a/openpype/vendor/python/python_2/urllib3/contrib/_securetransport/low_level.py b/openpype/vendor/python/python_2/urllib3/contrib/_securetransport/low_level.py
new file mode 100644
index 0000000000..fa0b245d27
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/contrib/_securetransport/low_level.py
@@ -0,0 +1,397 @@
+"""
+Low-level helpers for the SecureTransport bindings.
+
+These are Python functions that are not directly related to the high-level APIs
+but are necessary to get them to work. They include a whole bunch of low-level
+CoreFoundation messing about and memory management. The concerns in this module
+are almost entirely about trying to avoid memory leaks and providing
+appropriate and useful assistance to the higher-level code.
+"""
+import base64
+import ctypes
+import itertools
+import os
+import re
+import ssl
+import struct
+import tempfile
+
+from .bindings import CFConst, CoreFoundation, Security
+
+# This regular expression is used to grab PEM data out of a PEM bundle.
+_PEM_CERTS_RE = re.compile(
+    b"-----BEGIN CERTIFICATE-----\n(.*?)\n-----END CERTIFICATE-----", re.DOTALL
+)
+
+
+def _cf_data_from_bytes(bytestring):
+    """
+    Given a bytestring, create a CFData object from it. This CFData object must
+    be CFReleased by the caller.
+    """
+    return CoreFoundation.CFDataCreate(
+        CoreFoundation.kCFAllocatorDefault, bytestring, len(bytestring)
+    )
+
+
+def _cf_dictionary_from_tuples(tuples):
+    """
+    Given a list of Python tuples, create an associated CFDictionary.
+    """
+    dictionary_size = len(tuples)
+
+    # We need to get the dictionary keys and values out in the same order.
+    keys = (t[0] for t in tuples)
+    values = (t[1] for t in tuples)
+    cf_keys = (CoreFoundation.CFTypeRef * dictionary_size)(*keys)
+    cf_values = (CoreFoundation.CFTypeRef * dictionary_size)(*values)
+
+    return CoreFoundation.CFDictionaryCreate(
+        CoreFoundation.kCFAllocatorDefault,
+        cf_keys,
+        cf_values,
+        dictionary_size,
+        CoreFoundation.kCFTypeDictionaryKeyCallBacks,
+        CoreFoundation.kCFTypeDictionaryValueCallBacks,
+    )
+
+
+def _cfstr(py_bstr):
+    """
+    Given a Python binary data, create a CFString.
+    The string must be CFReleased by the caller.
+    """
+    c_str = ctypes.c_char_p(py_bstr)
+    cf_str = CoreFoundation.CFStringCreateWithCString(
+        CoreFoundation.kCFAllocatorDefault,
+        c_str,
+        CFConst.kCFStringEncodingUTF8,
+    )
+    return cf_str
+
+
+def _create_cfstring_array(lst):
+    """
+    Given a list of Python binary data, create an associated CFMutableArray.
+    The array must be CFReleased by the caller.
+
+    Raises an ssl.SSLError on failure.
+    """
+    cf_arr = None
+    try:
+        cf_arr = CoreFoundation.CFArrayCreateMutable(
+            CoreFoundation.kCFAllocatorDefault,
+            0,
+            ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+        )
+        if not cf_arr:
+            raise MemoryError("Unable to allocate memory!")
+        for item in lst:
+            cf_str = _cfstr(item)
+            if not cf_str:
+                raise MemoryError("Unable to allocate memory!")
+            try:
+                CoreFoundation.CFArrayAppendValue(cf_arr, cf_str)
+            finally:
+                CoreFoundation.CFRelease(cf_str)
+    except BaseException as e:
+        if cf_arr:
+            CoreFoundation.CFRelease(cf_arr)
+        raise ssl.SSLError("Unable to allocate array: %s" % (e,))
+    return cf_arr
+
+
+def _cf_string_to_unicode(value):
+    """
+    Creates a Unicode string from a CFString object. Used entirely for error
+    reporting.
+
+    Yes, it annoys me quite a lot that this function is this complex.
+    """
+    value_as_void_p = ctypes.cast(value, ctypes.POINTER(ctypes.c_void_p))
+
+    string = CoreFoundation.CFStringGetCStringPtr(
+        value_as_void_p, CFConst.kCFStringEncodingUTF8
+    )
+    if string is None:
+        buffer = ctypes.create_string_buffer(1024)
+        result = CoreFoundation.CFStringGetCString(
+            value_as_void_p, buffer, 1024, CFConst.kCFStringEncodingUTF8
+        )
+        if not result:
+            raise OSError("Error copying C string from CFStringRef")
+        string = buffer.value
+    if string is not None:
+        string = string.decode("utf-8")
+    return string
+
+
+def _assert_no_error(error, exception_class=None):
+    """
+    Checks the return code and throws an exception if there is an error to
+    report
+    """
+    if error == 0:
+        return
+
+    cf_error_string = Security.SecCopyErrorMessageString(error, None)
+    output = _cf_string_to_unicode(cf_error_string)
+    CoreFoundation.CFRelease(cf_error_string)
+
+    if output is None or output == u"":
+        output = u"OSStatus %s" % error
+
+    if exception_class is None:
+        exception_class = ssl.SSLError
+
+    raise exception_class(output)
+
+
+def _cert_array_from_pem(pem_bundle):
+    """
+    Given a bundle of certs in PEM format, turns them into a CFArray of certs
+    that can be used to validate a cert chain.
+    """
+    # Normalize the PEM bundle's line endings.
+    pem_bundle = pem_bundle.replace(b"\r\n", b"\n")
+
+    der_certs = [
+        base64.b64decode(match.group(1)) for match in _PEM_CERTS_RE.finditer(pem_bundle)
+    ]
+    if not der_certs:
+        raise ssl.SSLError("No root certificates specified")
+
+    cert_array = CoreFoundation.CFArrayCreateMutable(
+        CoreFoundation.kCFAllocatorDefault,
+        0,
+        ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+    )
+    if not cert_array:
+        raise ssl.SSLError("Unable to allocate memory!")
+
+    try:
+        for der_bytes in der_certs:
+            certdata = _cf_data_from_bytes(der_bytes)
+            if not certdata:
+                raise ssl.SSLError("Unable to allocate memory!")
+            cert = Security.SecCertificateCreateWithData(
+                CoreFoundation.kCFAllocatorDefault, certdata
+            )
+            CoreFoundation.CFRelease(certdata)
+            if not cert:
+                raise ssl.SSLError("Unable to build cert object!")
+
+            CoreFoundation.CFArrayAppendValue(cert_array, cert)
+            CoreFoundation.CFRelease(cert)
+    except Exception:
+        # We need to free the array before the exception bubbles further.
+        # We only want to do that if an error occurs: otherwise, the caller
+        # should free.
+        CoreFoundation.CFRelease(cert_array)
+        raise
+
+    return cert_array
+
+
+def _is_cert(item):
+    """
+    Returns True if a given CFTypeRef is a certificate.
+    """
+    expected = Security.SecCertificateGetTypeID()
+    return CoreFoundation.CFGetTypeID(item) == expected
+
+
+def _is_identity(item):
+    """
+    Returns True if a given CFTypeRef is an identity.
+    """
+    expected = Security.SecIdentityGetTypeID()
+    return CoreFoundation.CFGetTypeID(item) == expected
+
+
+def _temporary_keychain():
+    """
+    This function creates a temporary Mac keychain that we can use to work with
+    credentials. This keychain uses a one-time password and a temporary file to
+    store the data. We expect to have one keychain per socket. The returned
+    SecKeychainRef must be freed by the caller, including calling
+    SecKeychainDelete.
+
+    Returns a tuple of the SecKeychainRef and the path to the temporary
+    directory that contains it.
+    """
+    # Unfortunately, SecKeychainCreate requires a path to a keychain. This
+    # means we cannot use mkstemp to use a generic temporary file. Instead,
+    # we're going to create a temporary directory and a filename to use there.
+    # This filename will be 8 random bytes expanded into base64. We also need
+    # some random bytes to password-protect the keychain we're creating, so we
+    # ask for 40 random bytes.
+    random_bytes = os.urandom(40)
+    filename = base64.b16encode(random_bytes[:8]).decode("utf-8")
+    password = base64.b16encode(random_bytes[8:])  # Must be valid UTF-8
+    tempdirectory = tempfile.mkdtemp()
+
+    keychain_path = os.path.join(tempdirectory, filename).encode("utf-8")
+
+    # We now want to create the keychain itself.
+    keychain = Security.SecKeychainRef()
+    status = Security.SecKeychainCreate(
+        keychain_path, len(password), password, False, None, ctypes.byref(keychain)
+    )
+    _assert_no_error(status)
+
+    # Having created the keychain, we want to pass it off to the caller.
+    return keychain, tempdirectory
+
+
+def _load_items_from_file(keychain, path):
+    """
+    Given a single file, loads all the trust objects from it into arrays and
+    the keychain.
+    Returns a tuple of lists: the first list is a list of identities, the
+    second a list of certs.
+    """
+    certificates = []
+    identities = []
+    result_array = None
+
+    with open(path, "rb") as f:
+        raw_filedata = f.read()
+
+    try:
+        filedata = CoreFoundation.CFDataCreate(
+            CoreFoundation.kCFAllocatorDefault, raw_filedata, len(raw_filedata)
+        )
+        result_array = CoreFoundation.CFArrayRef()
+        result = Security.SecItemImport(
+            filedata,  # cert data
+            None,  # Filename, leaving it out for now
+            None,  # What the type of the file is, we don't care
+            None,  # what's in the file, we don't care
+            0,  # import flags
+            None,  # key params, can include passphrase in the future
+            keychain,  # The keychain to insert into
+            ctypes.byref(result_array),  # Results
+        )
+        _assert_no_error(result)
+
+        # A CFArray is not very useful to us as an intermediary
+        # representation, so we are going to extract the objects we want
+        # and then free the array. We don't need to keep hold of keys: the
+        # keychain already has them!
+        result_count = CoreFoundation.CFArrayGetCount(result_array)
+        for index in range(result_count):
+            item = CoreFoundation.CFArrayGetValueAtIndex(result_array, index)
+            item = ctypes.cast(item, CoreFoundation.CFTypeRef)
+
+            if _is_cert(item):
+                CoreFoundation.CFRetain(item)
+                certificates.append(item)
+            elif _is_identity(item):
+                CoreFoundation.CFRetain(item)
+                identities.append(item)
+    finally:
+        if result_array:
+            CoreFoundation.CFRelease(result_array)
+
+        CoreFoundation.CFRelease(filedata)
+
+    return (identities, certificates)
+
+
+def _load_client_cert_chain(keychain, *paths):
+    """
+    Load certificates and maybe keys from a number of files. Has the end goal
+    of returning a CFArray containing one SecIdentityRef, and then zero or more
+    SecCertificateRef objects, suitable for use as a client certificate trust
+    chain.
+    """
+    # Ok, the strategy.
+    #
+    # This relies on knowing that macOS will not give you a SecIdentityRef
+    # unless you have imported a key into a keychain. This is a somewhat
+    # artificial limitation of macOS (for example, it doesn't necessarily
+    # affect iOS), but there is nothing inside Security.framework that lets you
+    # get a SecIdentityRef without having a key in a keychain.
+    #
+    # So the policy here is we take all the files and iterate them in order.
+    # Each one will use SecItemImport to have one or more objects loaded from
+    # it. We will also point at a keychain that macOS can use to work with the
+    # private key.
+    #
+    # Once we have all the objects, we'll check what we actually have. If we
+    # already have a SecIdentityRef in hand, fab: we'll use that. Otherwise,
+    # we'll take the first certificate (which we assume to be our leaf) and
+    # ask the keychain to give us a SecIdentityRef with that cert's associated
+    # key.
+    #
+    # We'll then return a CFArray containing the trust chain: one
+    # SecIdentityRef and then zero-or-more SecCertificateRef objects. The
+    # responsibility for freeing this CFArray will be with the caller. This
+    # CFArray must remain alive for the entire connection, so in practice it
+    # will be stored with a single SSLSocket, along with the reference to the
+    # keychain.
+    certificates = []
+    identities = []
+
+    # Filter out bad paths.
+    paths = (path for path in paths if path)
+
+    try:
+        for file_path in paths:
+            new_identities, new_certs = _load_items_from_file(keychain, file_path)
+            identities.extend(new_identities)
+            certificates.extend(new_certs)
+
+        # Ok, we have everything. The question is: do we have an identity? If
+        # not, we want to grab one from the first cert we have.
+        if not identities:
+            new_identity = Security.SecIdentityRef()
+            status = Security.SecIdentityCreateWithCertificate(
+                keychain, certificates[0], ctypes.byref(new_identity)
+            )
+            _assert_no_error(status)
+            identities.append(new_identity)
+
+            # We now want to release the original certificate, as we no longer
+            # need it.
+            CoreFoundation.CFRelease(certificates.pop(0))
+
+        # We now need to build a new CFArray that holds the trust chain.
+        trust_chain = CoreFoundation.CFArrayCreateMutable(
+            CoreFoundation.kCFAllocatorDefault,
+            0,
+            ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+        )
+        for item in itertools.chain(identities, certificates):
+            # ArrayAppendValue does a CFRetain on the item. That's fine,
+            # because the finally block will release our other refs to them.
+            CoreFoundation.CFArrayAppendValue(trust_chain, item)
+
+        return trust_chain
+    finally:
+        for obj in itertools.chain(identities, certificates):
+            CoreFoundation.CFRelease(obj)
+
+
+TLS_PROTOCOL_VERSIONS = {
+    "SSLv2": (0, 2),
+    "SSLv3": (3, 0),
+    "TLSv1": (3, 1),
+    "TLSv1.1": (3, 2),
+    "TLSv1.2": (3, 3),
+}
+
+
+def _build_tls_unknown_ca_alert(version):
+    """
+    Builds a TLS alert record for an unknown CA.
+    """
+    ver_maj, ver_min = TLS_PROTOCOL_VERSIONS[version]
+    severity_fatal = 0x02
+    description_unknown_ca = 0x30
+    msg = struct.pack(">BB", severity_fatal, description_unknown_ca)
+    msg_len = len(msg)
+    record_type_alert = 0x15
+    record = struct.pack(">BBBH", record_type_alert, ver_maj, ver_min, msg_len) + msg
+    return record
diff --git a/openpype/vendor/python/python_2/urllib3/contrib/appengine.py b/openpype/vendor/python/python_2/urllib3/contrib/appengine.py
new file mode 100644
index 0000000000..f91bdd6e77
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/contrib/appengine.py
@@ -0,0 +1,314 @@
+"""
+This module provides a pool manager that uses Google App Engine's
+`URLFetch Service <https://cloud.google.com/appengine/docs/python/urlfetch>`_.
+
+Example usage::
+
+    from urllib3 import PoolManager
+    from urllib3.contrib.appengine import AppEngineManager, is_appengine_sandbox
+
+    if is_appengine_sandbox():
+        # AppEngineManager uses AppEngine's URLFetch API behind the scenes
+        http = AppEngineManager()
+    else:
+        # PoolManager uses a socket-level API behind the scenes
+        http = PoolManager()
+
+    r = http.request('GET', 'https://google.com/')
+
+There are `limitations <https://cloud.google.com/appengine/docs/python/\
+urlfetch/#Python_Quotas_and_limits>`_ to the URLFetch service and it may not be
+the best choice for your application. There are three options for using
+urllib3 on Google App Engine:
+
+1. You can use :class:`AppEngineManager` with URLFetch. URLFetch is
+   cost-effective in many circumstances as long as your usage is within the
+   limitations.
+2. You can use a normal :class:`~urllib3.PoolManager` by enabling sockets.
+   Sockets also have `limitations and restrictions
+   <https://cloud.google.com/appengine/docs/python/sockets/\
+   #limitations-and-restrictions>`_ and have a lower free quota than URLFetch.
+   To use sockets, be sure to specify the following in your ``app.yaml``::
+
+        env_variables:
+            GAE_USE_SOCKETS_HTTPLIB : 'true'
+
+3. If you are using `App Engine Flexible
+<https://cloud.google.com/appengine/docs/flexible/>`_, you can use the standard
+:class:`PoolManager` without any configuration or special environment variables.
+"""
+
+from __future__ import absolute_import
+
+import io
+import logging
+import warnings
+
+from ..exceptions import (
+    HTTPError,
+    HTTPWarning,
+    MaxRetryError,
+    ProtocolError,
+    SSLError,
+    TimeoutError,
+)
+from ..packages.six.moves.urllib.parse import urljoin
+from ..request import RequestMethods
+from ..response import HTTPResponse
+from ..util.retry import Retry
+from ..util.timeout import Timeout
+from . import _appengine_environ
+
+try:
+    from google.appengine.api import urlfetch
+except ImportError:
+    urlfetch = None
+
+
+log = logging.getLogger(__name__)
+
+
+class AppEnginePlatformWarning(HTTPWarning):
+    pass
+
+
+class AppEnginePlatformError(HTTPError):
+    pass
+
+
+class AppEngineManager(RequestMethods):
+    """
+    Connection manager for Google App Engine sandbox applications.
+
+    This manager uses the URLFetch service directly instead of using the
+    emulated httplib, and is subject to URLFetch limitations as described in
+    the App Engine documentation `here
+    <https://cloud.google.com/appengine/docs/python/urlfetch>`_.
+
+    Notably it will raise an :class:`AppEnginePlatformError` if:
+        * URLFetch is not available.
+        * If you attempt to use this on App Engine Flexible, as full socket
+          support is available.
+        * If a request size is more than 10 megabytes.
+        * If a response size is more than 32 megabytes.
+        * If you use an unsupported request method such as OPTIONS.
+
+    Beyond those cases, it will raise normal urllib3 errors.
+    """
+
+    def __init__(
+        self,
+        headers=None,
+        retries=None,
+        validate_certificate=True,
+        urlfetch_retries=True,
+    ):
+        if not urlfetch:
+            raise AppEnginePlatformError(
+                "URLFetch is not available in this environment."
+            )
+
+        warnings.warn(
+            "urllib3 is using URLFetch on Google App Engine sandbox instead "
+            "of sockets. To use sockets directly instead of URLFetch see "
+            "https://urllib3.readthedocs.io/en/1.26.x/reference/urllib3.contrib.html.",
+            AppEnginePlatformWarning,
+        )
+
+        RequestMethods.__init__(self, headers)
+        self.validate_certificate = validate_certificate
+        self.urlfetch_retries = urlfetch_retries
+
+        self.retries = retries or Retry.DEFAULT
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        # Return False to re-raise any potential exceptions
+        return False
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=None,
+        redirect=True,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        **response_kw
+    ):
+
+        retries = self._get_retries(retries, redirect)
+
+        try:
+            follow_redirects = redirect and retries.redirect != 0 and retries.total
+            response = urlfetch.fetch(
+                url,
+                payload=body,
+                method=method,
+                headers=headers or {},
+                allow_truncated=False,
+                follow_redirects=self.urlfetch_retries and follow_redirects,
+                deadline=self._get_absolute_timeout(timeout),
+                validate_certificate=self.validate_certificate,
+            )
+        except urlfetch.DeadlineExceededError as e:
+            raise TimeoutError(self, e)
+
+        except urlfetch.InvalidURLError as e:
+            if "too large" in str(e):
+                raise AppEnginePlatformError(
+                    "URLFetch request too large, URLFetch only "
+                    "supports requests up to 10mb in size.",
+                    e,
+                )
+            raise ProtocolError(e)
+
+        except urlfetch.DownloadError as e:
+            if "Too many redirects" in str(e):
+                raise MaxRetryError(self, url, reason=e)
+            raise ProtocolError(e)
+
+        except urlfetch.ResponseTooLargeError as e:
+            raise AppEnginePlatformError(
+                "URLFetch response too large, URLFetch only supports"
+                "responses up to 32mb in size.",
+                e,
+            )
+
+        except urlfetch.SSLCertificateError as e:
+            raise SSLError(e)
+
+        except urlfetch.InvalidMethodError as e:
+            raise AppEnginePlatformError(
+                "URLFetch does not support method: %s" % method, e
+            )
+
+        http_response = self._urlfetch_response_to_http_response(
+            response, retries=retries, **response_kw
+        )
+
+        # Handle redirect?
+        redirect_location = redirect and http_response.get_redirect_location()
+        if redirect_location:
+            # Check for redirect response
+            if self.urlfetch_retries and retries.raise_on_redirect:
+                raise MaxRetryError(self, url, "too many redirects")
+            else:
+                if http_response.status == 303:
+                    method = "GET"
+
+                try:
+                    retries = retries.increment(
+                        method, url, response=http_response, _pool=self
+                    )
+                except MaxRetryError:
+                    if retries.raise_on_redirect:
+                        raise MaxRetryError(self, url, "too many redirects")
+                    return http_response
+
+                retries.sleep_for_retry(http_response)
+                log.debug("Redirecting %s -> %s", url, redirect_location)
+                redirect_url = urljoin(url, redirect_location)
+                return self.urlopen(
+                    method,
+                    redirect_url,
+                    body,
+                    headers,
+                    retries=retries,
+                    redirect=redirect,
+                    timeout=timeout,
+                    **response_kw
+                )
+
+        # Check if we should retry the HTTP response.
+        has_retry_after = bool(http_response.getheader("Retry-After"))
+        if retries.is_retry(method, http_response.status, has_retry_after):
+            retries = retries.increment(method, url, response=http_response, _pool=self)
+            log.debug("Retry: %s", url)
+            retries.sleep(http_response)
+            return self.urlopen(
+                method,
+                url,
+                body=body,
+                headers=headers,
+                retries=retries,
+                redirect=redirect,
+                timeout=timeout,
+                **response_kw
+            )
+
+        return http_response
+
+    def _urlfetch_response_to_http_response(self, urlfetch_resp, **response_kw):
+
+        if is_prod_appengine():
+            # Production GAE handles deflate encoding automatically, but does
+            # not remove the encoding header.
+            content_encoding = urlfetch_resp.headers.get("content-encoding")
+
+            if content_encoding == "deflate":
+                del urlfetch_resp.headers["content-encoding"]
+
+        transfer_encoding = urlfetch_resp.headers.get("transfer-encoding")
+        # We have a full response's content,
+        # so let's make sure we don't report ourselves as chunked data.
+        if transfer_encoding == "chunked":
+            encodings = transfer_encoding.split(",")
+            encodings.remove("chunked")
+            urlfetch_resp.headers["transfer-encoding"] = ",".join(encodings)
+
+        original_response = HTTPResponse(
+            # In order for decoding to work, we must present the content as
+            # a file-like object.
+            body=io.BytesIO(urlfetch_resp.content),
+            msg=urlfetch_resp.header_msg,
+            headers=urlfetch_resp.headers,
+            status=urlfetch_resp.status_code,
+            **response_kw
+        )
+
+        return HTTPResponse(
+            body=io.BytesIO(urlfetch_resp.content),
+            headers=urlfetch_resp.headers,
+            status=urlfetch_resp.status_code,
+            original_response=original_response,
+            **response_kw
+        )
+
+    def _get_absolute_timeout(self, timeout):
+        if timeout is Timeout.DEFAULT_TIMEOUT:
+            return None  # Defer to URLFetch's default.
+        if isinstance(timeout, Timeout):
+            if timeout._read is not None or timeout._connect is not None:
+                warnings.warn(
+                    "URLFetch does not support granular timeout settings, "
+                    "reverting to total or default URLFetch timeout.",
+                    AppEnginePlatformWarning,
+                )
+            return timeout.total
+        return timeout
+
+    def _get_retries(self, retries, redirect):
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
+
+        if retries.connect or retries.read or retries.redirect:
+            warnings.warn(
+                "URLFetch only supports total retries and does not "
+                "recognize connect, read, or redirect retry parameters.",
+                AppEnginePlatformWarning,
+            )
+
+        return retries
+
+
+# Alias methods from _appengine_environ to maintain public API interface.
+
+is_appengine = _appengine_environ.is_appengine
+is_appengine_sandbox = _appengine_environ.is_appengine_sandbox
+is_local_appengine = _appengine_environ.is_local_appengine
+is_prod_appengine = _appengine_environ.is_prod_appengine
+is_prod_appengine_mvms = _appengine_environ.is_prod_appengine_mvms
diff --git a/openpype/vendor/python/python_2/urllib3/contrib/ntlmpool.py b/openpype/vendor/python/python_2/urllib3/contrib/ntlmpool.py
new file mode 100644
index 0000000000..41a8fd174c
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/contrib/ntlmpool.py
@@ -0,0 +1,130 @@
+"""
+NTLM authenticating pool, contributed by erikcederstran
+
+Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10
+"""
+from __future__ import absolute_import
+
+import warnings
+from logging import getLogger
+
+from ntlm import ntlm
+
+from .. import HTTPSConnectionPool
+from ..packages.six.moves.http_client import HTTPSConnection
+
+warnings.warn(
+    "The 'urllib3.contrib.ntlmpool' module is deprecated and will be removed "
+    "in urllib3 v2.0 release, urllib3 is not able to support it properly due "
+    "to reasons listed in issue: https://github.com/urllib3/urllib3/issues/2282. "
+    "If you are a user of this module please comment in the mentioned issue.",
+    DeprecationWarning,
+)
+
+log = getLogger(__name__)
+
+
+class NTLMConnectionPool(HTTPSConnectionPool):
+    """
+    Implements an NTLM authentication version of an urllib3 connection pool
+    """
+
+    scheme = "https"
+
+    def __init__(self, user, pw, authurl, *args, **kwargs):
+        """
+        authurl is a random URL on the server that is protected by NTLM.
+        user is the Windows user, probably in the DOMAIN\\username format.
+        pw is the password for the user.
+        """
+        super(NTLMConnectionPool, self).__init__(*args, **kwargs)
+        self.authurl = authurl
+        self.rawuser = user
+        user_parts = user.split("\\", 1)
+        self.domain = user_parts[0].upper()
+        self.user = user_parts[1]
+        self.pw = pw
+
+    def _new_conn(self):
+        # Performs the NTLM handshake that secures the connection. The socket
+        # must be kept open while requests are performed.
+        self.num_connections += 1
+        log.debug(
+            "Starting NTLM HTTPS connection no. %d: https://%s%s",
+            self.num_connections,
+            self.host,
+            self.authurl,
+        )
+
+        headers = {"Connection": "Keep-Alive"}
+        req_header = "Authorization"
+        resp_header = "www-authenticate"
+
+        conn = HTTPSConnection(host=self.host, port=self.port)
+
+        # Send negotiation message
+        headers[req_header] = "NTLM %s" % ntlm.create_NTLM_NEGOTIATE_MESSAGE(
+            self.rawuser
+        )
+        log.debug("Request headers: %s", headers)
+        conn.request("GET", self.authurl, None, headers)
+        res = conn.getresponse()
+        reshdr = dict(res.getheaders())
+        log.debug("Response status: %s %s", res.status, res.reason)
+        log.debug("Response headers: %s", reshdr)
+        log.debug("Response data: %s [...]", res.read(100))
+
+        # Remove the reference to the socket, so that it can not be closed by
+        # the response object (we want to keep the socket open)
+        res.fp = None
+
+        # Server should respond with a challenge message
+        auth_header_values = reshdr[resp_header].split(", ")
+        auth_header_value = None
+        for s in auth_header_values:
+            if s[:5] == "NTLM ":
+                auth_header_value = s[5:]
+        if auth_header_value is None:
+            raise Exception(
+                "Unexpected %s response header: %s" % (resp_header, reshdr[resp_header])
+            )
+
+        # Send authentication message
+        ServerChallenge, NegotiateFlags = ntlm.parse_NTLM_CHALLENGE_MESSAGE(
+            auth_header_value
+        )
+        auth_msg = ntlm.create_NTLM_AUTHENTICATE_MESSAGE(
+            ServerChallenge, self.user, self.domain, self.pw, NegotiateFlags
+        )
+        headers[req_header] = "NTLM %s" % auth_msg
+        log.debug("Request headers: %s", headers)
+        conn.request("GET", self.authurl, None, headers)
+        res = conn.getresponse()
+        log.debug("Response status: %s %s", res.status, res.reason)
+        log.debug("Response headers: %s", dict(res.getheaders()))
+        log.debug("Response data: %s [...]", res.read()[:100])
+        if res.status != 200:
+            if res.status == 401:
+                raise Exception("Server rejected request: wrong username or password")
+            raise Exception("Wrong server response: %s %s" % (res.status, res.reason))
+
+        res.fp = None
+        log.debug("Connection established")
+        return conn
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=3,
+        redirect=True,
+        assert_same_host=True,
+    ):
+        if headers is None:
+            headers = {}
+        headers["Connection"] = "Keep-Alive"
+        return super(NTLMConnectionPool, self).urlopen(
+            method, url, body, headers, retries, redirect, assert_same_host
+        )
diff --git a/openpype/vendor/python/python_2/urllib3/contrib/pyopenssl.py b/openpype/vendor/python/python_2/urllib3/contrib/pyopenssl.py
new file mode 100644
index 0000000000..def83afdb2
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/contrib/pyopenssl.py
@@ -0,0 +1,511 @@
+"""
+TLS with SNI_-support for Python 2. Follow these instructions if you would
+like to verify TLS certificates in Python 2. Note, the default libraries do
+*not* do certificate checking; you need to do additional work to validate
+certificates yourself.
+
+This needs the following packages installed:
+
+* `pyOpenSSL`_ (tested with 16.0.0)
+* `cryptography`_ (minimum 1.3.4, from pyopenssl)
+* `idna`_ (minimum 2.0, from cryptography)
+
+However, pyopenssl depends on cryptography, which depends on idna, so while we
+use all three directly here we end up having relatively few packages required.
+
+You can install them with the following command:
+
+.. code-block:: bash
+
+    $ python -m pip install pyopenssl cryptography idna
+
+To activate certificate checking, call
+:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code
+before you begin making HTTP requests. This can be done in a ``sitecustomize``
+module, or at any other time before your application begins using ``urllib3``,
+like this:
+
+.. code-block:: python
+
+    try:
+        import urllib3.contrib.pyopenssl
+        urllib3.contrib.pyopenssl.inject_into_urllib3()
+    except ImportError:
+        pass
+
+Now you can use :mod:`urllib3` as you normally would, and it will support SNI
+when the required modules are installed.
+
+Activating this module also has the positive side effect of disabling SSL/TLS
+compression in Python 2 (see `CRIME attack`_).
+
+.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication
+.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit)
+.. _pyopenssl: https://www.pyopenssl.org
+.. _cryptography: https://cryptography.io
+.. _idna: https://github.com/kjd/idna
+"""
+from __future__ import absolute_import
+
+import OpenSSL.SSL
+from cryptography import x509
+from cryptography.hazmat.backends.openssl import backend as openssl_backend
+from cryptography.hazmat.backends.openssl.x509 import _Certificate
+
+try:
+    from cryptography.x509 import UnsupportedExtension
+except ImportError:
+    # UnsupportedExtension is gone in cryptography >= 2.1.0
+    class UnsupportedExtension(Exception):
+        pass
+
+
+from io import BytesIO
+from socket import error as SocketError
+from socket import timeout
+
+try:  # Platform-specific: Python 2
+    from socket import _fileobject
+except ImportError:  # Platform-specific: Python 3
+    _fileobject = None
+    from ..packages.backports.makefile import backport_makefile
+
+import logging
+import ssl
+import sys
+
+from .. import util
+from ..packages import six
+from ..util.ssl_ import PROTOCOL_TLS_CLIENT
+
+__all__ = ["inject_into_urllib3", "extract_from_urllib3"]
+
+# SNI always works.
+HAS_SNI = True
+
+# Map from urllib3 to PyOpenSSL compatible parameter-values.
+_openssl_versions = {
+    util.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD,
+    PROTOCOL_TLS_CLIENT: OpenSSL.SSL.SSLv23_METHOD,
+    ssl.PROTOCOL_TLSv1: OpenSSL.SSL.TLSv1_METHOD,
+}
+
+if hasattr(ssl, "PROTOCOL_SSLv3") and hasattr(OpenSSL.SSL, "SSLv3_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_SSLv3] = OpenSSL.SSL.SSLv3_METHOD
+
+if hasattr(ssl, "PROTOCOL_TLSv1_1") and hasattr(OpenSSL.SSL, "TLSv1_1_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_TLSv1_1] = OpenSSL.SSL.TLSv1_1_METHOD
+
+if hasattr(ssl, "PROTOCOL_TLSv1_2") and hasattr(OpenSSL.SSL, "TLSv1_2_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_TLSv1_2] = OpenSSL.SSL.TLSv1_2_METHOD
+
+
+_stdlib_to_openssl_verify = {
+    ssl.CERT_NONE: OpenSSL.SSL.VERIFY_NONE,
+    ssl.CERT_OPTIONAL: OpenSSL.SSL.VERIFY_PEER,
+    ssl.CERT_REQUIRED: OpenSSL.SSL.VERIFY_PEER
+    + OpenSSL.SSL.VERIFY_FAIL_IF_NO_PEER_CERT,
+}
+_openssl_to_stdlib_verify = dict((v, k) for k, v in _stdlib_to_openssl_verify.items())
+
+# OpenSSL will only write 16K at a time
+SSL_WRITE_BLOCKSIZE = 16384
+
+orig_util_HAS_SNI = util.HAS_SNI
+orig_util_SSLContext = util.ssl_.SSLContext
+
+
+log = logging.getLogger(__name__)
+
+
+def inject_into_urllib3():
+    "Monkey-patch urllib3 with PyOpenSSL-backed SSL-support."
+
+    _validate_dependencies_met()
+
+    util.SSLContext = PyOpenSSLContext
+    util.ssl_.SSLContext = PyOpenSSLContext
+    util.HAS_SNI = HAS_SNI
+    util.ssl_.HAS_SNI = HAS_SNI
+    util.IS_PYOPENSSL = True
+    util.ssl_.IS_PYOPENSSL = True
+
+
+def extract_from_urllib3():
+    "Undo monkey-patching by :func:`inject_into_urllib3`."
+
+    util.SSLContext = orig_util_SSLContext
+    util.ssl_.SSLContext = orig_util_SSLContext
+    util.HAS_SNI = orig_util_HAS_SNI
+    util.ssl_.HAS_SNI = orig_util_HAS_SNI
+    util.IS_PYOPENSSL = False
+    util.ssl_.IS_PYOPENSSL = False
+
+
+def _validate_dependencies_met():
+    """
+    Verifies that PyOpenSSL's package-level dependencies have been met.
+    Throws `ImportError` if they are not met.
+    """
+    # Method added in `cryptography==1.1`; not available in older versions
+    from cryptography.x509.extensions import Extensions
+
+    if getattr(Extensions, "get_extension_for_class", None) is None:
+        raise ImportError(
+            "'cryptography' module missing required functionality.  "
+            "Try upgrading to v1.3.4 or newer."
+        )
+
+    # pyOpenSSL 0.14 and above use cryptography for OpenSSL bindings. The _x509
+    # attribute is only present on those versions.
+    from OpenSSL.crypto import X509
+
+    x509 = X509()
+    if getattr(x509, "_x509", None) is None:
+        raise ImportError(
+            "'pyOpenSSL' module missing required functionality. "
+            "Try upgrading to v0.14 or newer."
+        )
+
+
+def _dnsname_to_stdlib(name):
+    """
+    Converts a dNSName SubjectAlternativeName field to the form used by the
+    standard library on the given Python version.
+
+    Cryptography produces a dNSName as a unicode string that was idna-decoded
+    from ASCII bytes. We need to idna-encode that string to get it back, and
+    then on Python 3 we also need to convert to unicode via UTF-8 (the stdlib
+    uses PyUnicode_FromStringAndSize on it, which decodes via UTF-8).
+
+    If the name cannot be idna-encoded then we return None signalling that
+    the name given should be skipped.
+    """
+
+    def idna_encode(name):
+        """
+        Borrowed wholesale from the Python Cryptography Project. It turns out
+        that we can't just safely call `idna.encode`: it can explode for
+        wildcard names. This avoids that problem.
+        """
+        import idna
+
+        try:
+            for prefix in [u"*.", u"."]:
+                if name.startswith(prefix):
+                    name = name[len(prefix) :]
+                    return prefix.encode("ascii") + idna.encode(name)
+            return idna.encode(name)
+        except idna.core.IDNAError:
+            return None
+
+    # Don't send IPv6 addresses through the IDNA encoder.
+    if ":" in name:
+        return name
+
+    name = idna_encode(name)
+    if name is None:
+        return None
+    elif sys.version_info >= (3, 0):
+        name = name.decode("utf-8")
+    return name
+
+
+def get_subj_alt_name(peer_cert):
+    """
+    Given an PyOpenSSL certificate, provides all the subject alternative names.
+    """
+    # Pass the cert to cryptography, which has much better APIs for this.
+    if hasattr(peer_cert, "to_cryptography"):
+        cert = peer_cert.to_cryptography()
+    else:
+        # This is technically using private APIs, but should work across all
+        # relevant versions before PyOpenSSL got a proper API for this.
+        cert = _Certificate(openssl_backend, peer_cert._x509)
+
+    # We want to find the SAN extension. Ask Cryptography to locate it (it's
+    # faster than looping in Python)
+    try:
+        ext = cert.extensions.get_extension_for_class(x509.SubjectAlternativeName).value
+    except x509.ExtensionNotFound:
+        # No such extension, return the empty list.
+        return []
+    except (
+        x509.DuplicateExtension,
+        UnsupportedExtension,
+        x509.UnsupportedGeneralNameType,
+        UnicodeError,
+    ) as e:
+        # A problem has been found with the quality of the certificate. Assume
+        # no SAN field is present.
+        log.warning(
+            "A problem was encountered with the certificate that prevented "
+            "urllib3 from finding the SubjectAlternativeName field. This can "
+            "affect certificate validation. The error was %s",
+            e,
+        )
+        return []
+
+    # We want to return dNSName and iPAddress fields. We need to cast the IPs
+    # back to strings because the match_hostname function wants them as
+    # strings.
+    # Sadly the DNS names need to be idna encoded and then, on Python 3, UTF-8
+    # decoded. This is pretty frustrating, but that's what the standard library
+    # does with certificates, and so we need to attempt to do the same.
+    # We also want to skip over names which cannot be idna encoded.
+    names = [
+        ("DNS", name)
+        for name in map(_dnsname_to_stdlib, ext.get_values_for_type(x509.DNSName))
+        if name is not None
+    ]
+    names.extend(
+        ("IP Address", str(name)) for name in ext.get_values_for_type(x509.IPAddress)
+    )
+
+    return names
+
+
+class WrappedSocket(object):
+    """API-compatibility wrapper for Python OpenSSL's Connection-class.
+
+    Note: _makefile_refs, _drop() and _reuse() are needed for the garbage
+    collector of pypy.
+    """
+
+    def __init__(self, connection, socket, suppress_ragged_eofs=True):
+        self.connection = connection
+        self.socket = socket
+        self.suppress_ragged_eofs = suppress_ragged_eofs
+        self._makefile_refs = 0
+        self._closed = False
+
+    def fileno(self):
+        return self.socket.fileno()
+
+    # Copy-pasted from Python 3.5 source code
+    def _decref_socketios(self):
+        if self._makefile_refs > 0:
+            self._makefile_refs -= 1
+        if self._closed:
+            self.close()
+
+    def recv(self, *args, **kwargs):
+        try:
+            data = self.connection.recv(*args, **kwargs)
+        except OpenSSL.SSL.SysCallError as e:
+            if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
+                return b""
+            else:
+                raise SocketError(str(e))
+        except OpenSSL.SSL.ZeroReturnError:
+            if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
+                return b""
+            else:
+                raise
+        except OpenSSL.SSL.WantReadError:
+            if not util.wait_for_read(self.socket, self.socket.gettimeout()):
+                raise timeout("The read operation timed out")
+            else:
+                return self.recv(*args, **kwargs)
+
+        # TLS 1.3 post-handshake authentication
+        except OpenSSL.SSL.Error as e:
+            raise ssl.SSLError("read error: %r" % e)
+        else:
+            return data
+
+    def recv_into(self, *args, **kwargs):
+        try:
+            return self.connection.recv_into(*args, **kwargs)
+        except OpenSSL.SSL.SysCallError as e:
+            if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
+                return 0
+            else:
+                raise SocketError(str(e))
+        except OpenSSL.SSL.ZeroReturnError:
+            if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
+                return 0
+            else:
+                raise
+        except OpenSSL.SSL.WantReadError:
+            if not util.wait_for_read(self.socket, self.socket.gettimeout()):
+                raise timeout("The read operation timed out")
+            else:
+                return self.recv_into(*args, **kwargs)
+
+        # TLS 1.3 post-handshake authentication
+        except OpenSSL.SSL.Error as e:
+            raise ssl.SSLError("read error: %r" % e)
+
+    def settimeout(self, timeout):
+        return self.socket.settimeout(timeout)
+
+    def _send_until_done(self, data):
+        while True:
+            try:
+                return self.connection.send(data)
+            except OpenSSL.SSL.WantWriteError:
+                if not util.wait_for_write(self.socket, self.socket.gettimeout()):
+                    raise timeout()
+                continue
+            except OpenSSL.SSL.SysCallError as e:
+                raise SocketError(str(e))
+
+    def sendall(self, data):
+        total_sent = 0
+        while total_sent < len(data):
+            sent = self._send_until_done(
+                data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE]
+            )
+            total_sent += sent
+
+    def shutdown(self):
+        # FIXME rethrow compatible exceptions should we ever use this
+        self.connection.shutdown()
+
+    def close(self):
+        if self._makefile_refs < 1:
+            try:
+                self._closed = True
+                return self.connection.close()
+            except OpenSSL.SSL.Error:
+                return
+        else:
+            self._makefile_refs -= 1
+
+    def getpeercert(self, binary_form=False):
+        x509 = self.connection.get_peer_certificate()
+
+        if not x509:
+            return x509
+
+        if binary_form:
+            return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509)
+
+        return {
+            "subject": ((("commonName", x509.get_subject().CN),),),
+            "subjectAltName": get_subj_alt_name(x509),
+        }
+
+    def version(self):
+        return self.connection.get_protocol_version_name()
+
+    def _reuse(self):
+        self._makefile_refs += 1
+
+    def _drop(self):
+        if self._makefile_refs < 1:
+            self.close()
+        else:
+            self._makefile_refs -= 1
+
+
+if _fileobject:  # Platform-specific: Python 2
+
+    def makefile(self, mode, bufsize=-1):
+        self._makefile_refs += 1
+        return _fileobject(self, mode, bufsize, close=True)
+
+
+else:  # Platform-specific: Python 3
+    makefile = backport_makefile
+
+WrappedSocket.makefile = makefile
+
+
+class PyOpenSSLContext(object):
+    """
+    I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible
+    for translating the interface of the standard library ``SSLContext`` object
+    to calls into PyOpenSSL.
+    """
+
+    def __init__(self, protocol):
+        self.protocol = _openssl_versions[protocol]
+        self._ctx = OpenSSL.SSL.Context(self.protocol)
+        self._options = 0
+        self.check_hostname = False
+
+    @property
+    def options(self):
+        return self._options
+
+    @options.setter
+    def options(self, value):
+        self._options = value
+        self._ctx.set_options(value)
+
+    @property
+    def verify_mode(self):
+        return _openssl_to_stdlib_verify[self._ctx.get_verify_mode()]
+
+    @verify_mode.setter
+    def verify_mode(self, value):
+        self._ctx.set_verify(_stdlib_to_openssl_verify[value], _verify_callback)
+
+    def set_default_verify_paths(self):
+        self._ctx.set_default_verify_paths()
+
+    def set_ciphers(self, ciphers):
+        if isinstance(ciphers, six.text_type):
+            ciphers = ciphers.encode("utf-8")
+        self._ctx.set_cipher_list(ciphers)
+
+    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+        if cafile is not None:
+            cafile = cafile.encode("utf-8")
+        if capath is not None:
+            capath = capath.encode("utf-8")
+        try:
+            self._ctx.load_verify_locations(cafile, capath)
+            if cadata is not None:
+                self._ctx.load_verify_locations(BytesIO(cadata))
+        except OpenSSL.SSL.Error as e:
+            raise ssl.SSLError("unable to load trusted certificates: %r" % e)
+
+    def load_cert_chain(self, certfile, keyfile=None, password=None):
+        self._ctx.use_certificate_chain_file(certfile)
+        if password is not None:
+            if not isinstance(password, six.binary_type):
+                password = password.encode("utf-8")
+            self._ctx.set_passwd_cb(lambda *_: password)
+        self._ctx.use_privatekey_file(keyfile or certfile)
+
+    def set_alpn_protocols(self, protocols):
+        protocols = [six.ensure_binary(p) for p in protocols]
+        return self._ctx.set_alpn_protos(protocols)
+
+    def wrap_socket(
+        self,
+        sock,
+        server_side=False,
+        do_handshake_on_connect=True,
+        suppress_ragged_eofs=True,
+        server_hostname=None,
+    ):
+        cnx = OpenSSL.SSL.Connection(self._ctx, sock)
+
+        if isinstance(server_hostname, six.text_type):  # Platform-specific: Python 3
+            server_hostname = server_hostname.encode("utf-8")
+
+        if server_hostname is not None:
+            cnx.set_tlsext_host_name(server_hostname)
+
+        cnx.set_connect_state()
+
+        while True:
+            try:
+                cnx.do_handshake()
+            except OpenSSL.SSL.WantReadError:
+                if not util.wait_for_read(sock, sock.gettimeout()):
+                    raise timeout("select timed out")
+                continue
+            except OpenSSL.SSL.Error as e:
+                raise ssl.SSLError("bad handshake: %r" % e)
+            break
+
+        return WrappedSocket(cnx, sock)
+
+
+def _verify_callback(cnx, x509, err_no, err_depth, return_code):
+    return err_no == 0
diff --git a/openpype/vendor/python/python_2/urllib3/contrib/securetransport.py b/openpype/vendor/python/python_2/urllib3/contrib/securetransport.py
new file mode 100644
index 0000000000..554c015fed
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/contrib/securetransport.py
@@ -0,0 +1,922 @@
+"""
+SecureTranport support for urllib3 via ctypes.
+
+This makes platform-native TLS available to urllib3 users on macOS without the
+use of a compiler. This is an important feature because the Python Package
+Index is moving to become a TLSv1.2-or-higher server, and the default OpenSSL
+that ships with macOS is not capable of doing TLSv1.2. The only way to resolve
+this is to give macOS users an alternative solution to the problem, and that
+solution is to use SecureTransport.
+
+We use ctypes here because this solution must not require a compiler. That's
+because pip is not allowed to require a compiler either.
+
+This is not intended to be a seriously long-term solution to this problem.
+The hope is that PEP 543 will eventually solve this issue for us, at which
+point we can retire this contrib module. But in the short term, we need to
+solve the impending tire fire that is Python on Mac without this kind of
+contrib module. So...here we are.
+
+To use this module, simply import and inject it::
+
+    import urllib3.contrib.securetransport
+    urllib3.contrib.securetransport.inject_into_urllib3()
+
+Happy TLSing!
+
+This code is a bastardised version of the code found in Will Bond's oscrypto
+library. An enormous debt is owed to him for blazing this trail for us. For
+that reason, this code should be considered to be covered both by urllib3's
+license and by oscrypto's:
+
+.. code-block::
+
+    Copyright (c) 2015-2016 Will Bond <will@wbond.net>
+
+    Permission is hereby granted, free of charge, to any person obtaining a
+    copy of this software and associated documentation files (the "Software"),
+    to deal in the Software without restriction, including without limitation
+    the rights to use, copy, modify, merge, publish, distribute, sublicense,
+    and/or sell copies of the Software, and to permit persons to whom the
+    Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+    DEALINGS IN THE SOFTWARE.
+"""
+from __future__ import absolute_import
+
+import contextlib
+import ctypes
+import errno
+import os.path
+import shutil
+import socket
+import ssl
+import struct
+import threading
+import weakref
+
+import six
+
+from .. import util
+from ..util.ssl_ import PROTOCOL_TLS_CLIENT
+from ._securetransport.bindings import CoreFoundation, Security, SecurityConst
+from ._securetransport.low_level import (
+    _assert_no_error,
+    _build_tls_unknown_ca_alert,
+    _cert_array_from_pem,
+    _create_cfstring_array,
+    _load_client_cert_chain,
+    _temporary_keychain,
+)
+
+try:  # Platform-specific: Python 2
+    from socket import _fileobject
+except ImportError:  # Platform-specific: Python 3
+    _fileobject = None
+    from ..packages.backports.makefile import backport_makefile
+
+__all__ = ["inject_into_urllib3", "extract_from_urllib3"]
+
+# SNI always works
+HAS_SNI = True
+
+orig_util_HAS_SNI = util.HAS_SNI
+orig_util_SSLContext = util.ssl_.SSLContext
+
+# This dictionary is used by the read callback to obtain a handle to the
+# calling wrapped socket. This is a pretty silly approach, but for now it'll
+# do. I feel like I should be able to smuggle a handle to the wrapped socket
+# directly in the SSLConnectionRef, but for now this approach will work I
+# guess.
+#
+# We need to lock around this structure for inserts, but we don't do it for
+# reads/writes in the callbacks. The reasoning here goes as follows:
+#
+#    1. It is not possible to call into the callbacks before the dictionary is
+#       populated, so once in the callback the id must be in the dictionary.
+#    2. The callbacks don't mutate the dictionary, they only read from it, and
+#       so cannot conflict with any of the insertions.
+#
+# This is good: if we had to lock in the callbacks we'd drastically slow down
+# the performance of this code.
+_connection_refs = weakref.WeakValueDictionary()
+_connection_ref_lock = threading.Lock()
+
+# Limit writes to 16kB. This is OpenSSL's limit, but we'll cargo-cult it over
+# for no better reason than we need *a* limit, and this one is right there.
+SSL_WRITE_BLOCKSIZE = 16384
+
+# This is our equivalent of util.ssl_.DEFAULT_CIPHERS, but expanded out to
+# individual cipher suites. We need to do this because this is how
+# SecureTransport wants them.
+CIPHER_SUITES = [
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_AES_256_GCM_SHA384,
+    SecurityConst.TLS_AES_128_GCM_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_AES_128_CCM_8_SHA256,
+    SecurityConst.TLS_AES_128_CCM_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA,
+]
+
+# Basically this is simple: for PROTOCOL_SSLv23 we turn it into a low of
+# TLSv1 and a high of TLSv1.2. For everything else, we pin to that version.
+# TLSv1 to 1.2 are supported on macOS 10.8+
+_protocol_to_min_max = {
+    util.PROTOCOL_TLS: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),
+    PROTOCOL_TLS_CLIENT: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),
+}
+
+if hasattr(ssl, "PROTOCOL_SSLv2"):
+    _protocol_to_min_max[ssl.PROTOCOL_SSLv2] = (
+        SecurityConst.kSSLProtocol2,
+        SecurityConst.kSSLProtocol2,
+    )
+if hasattr(ssl, "PROTOCOL_SSLv3"):
+    _protocol_to_min_max[ssl.PROTOCOL_SSLv3] = (
+        SecurityConst.kSSLProtocol3,
+        SecurityConst.kSSLProtocol3,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1] = (
+        SecurityConst.kTLSProtocol1,
+        SecurityConst.kTLSProtocol1,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1_1"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_1] = (
+        SecurityConst.kTLSProtocol11,
+        SecurityConst.kTLSProtocol11,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1_2"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_2] = (
+        SecurityConst.kTLSProtocol12,
+        SecurityConst.kTLSProtocol12,
+    )
+
+
+def inject_into_urllib3():
+    """
+    Monkey-patch urllib3 with SecureTransport-backed SSL-support.
+    """
+    util.SSLContext = SecureTransportContext
+    util.ssl_.SSLContext = SecureTransportContext
+    util.HAS_SNI = HAS_SNI
+    util.ssl_.HAS_SNI = HAS_SNI
+    util.IS_SECURETRANSPORT = True
+    util.ssl_.IS_SECURETRANSPORT = True
+
+
+def extract_from_urllib3():
+    """
+    Undo monkey-patching by :func:`inject_into_urllib3`.
+    """
+    util.SSLContext = orig_util_SSLContext
+    util.ssl_.SSLContext = orig_util_SSLContext
+    util.HAS_SNI = orig_util_HAS_SNI
+    util.ssl_.HAS_SNI = orig_util_HAS_SNI
+    util.IS_SECURETRANSPORT = False
+    util.ssl_.IS_SECURETRANSPORT = False
+
+
+def _read_callback(connection_id, data_buffer, data_length_pointer):
+    """
+    SecureTransport read callback. This is called by ST to request that data
+    be returned from the socket.
+    """
+    wrapped_socket = None
+    try:
+        wrapped_socket = _connection_refs.get(connection_id)
+        if wrapped_socket is None:
+            return SecurityConst.errSSLInternal
+        base_socket = wrapped_socket.socket
+
+        requested_length = data_length_pointer[0]
+
+        timeout = wrapped_socket.gettimeout()
+        error = None
+        read_count = 0
+
+        try:
+            while read_count < requested_length:
+                if timeout is None or timeout >= 0:
+                    if not util.wait_for_read(base_socket, timeout):
+                        raise socket.error(errno.EAGAIN, "timed out")
+
+                remaining = requested_length - read_count
+                buffer = (ctypes.c_char * remaining).from_address(
+                    data_buffer + read_count
+                )
+                chunk_size = base_socket.recv_into(buffer, remaining)
+                read_count += chunk_size
+                if not chunk_size:
+                    if not read_count:
+                        return SecurityConst.errSSLClosedGraceful
+                    break
+        except (socket.error) as e:
+            error = e.errno
+
+            if error is not None and error != errno.EAGAIN:
+                data_length_pointer[0] = read_count
+                if error == errno.ECONNRESET or error == errno.EPIPE:
+                    return SecurityConst.errSSLClosedAbort
+                raise
+
+        data_length_pointer[0] = read_count
+
+        if read_count != requested_length:
+            return SecurityConst.errSSLWouldBlock
+
+        return 0
+    except Exception as e:
+        if wrapped_socket is not None:
+            wrapped_socket._exception = e
+        return SecurityConst.errSSLInternal
+
+
+def _write_callback(connection_id, data_buffer, data_length_pointer):
+    """
+    SecureTransport write callback. This is called by ST to request that data
+    actually be sent on the network.
+    """
+    wrapped_socket = None
+    try:
+        wrapped_socket = _connection_refs.get(connection_id)
+        if wrapped_socket is None:
+            return SecurityConst.errSSLInternal
+        base_socket = wrapped_socket.socket
+
+        bytes_to_write = data_length_pointer[0]
+        data = ctypes.string_at(data_buffer, bytes_to_write)
+
+        timeout = wrapped_socket.gettimeout()
+        error = None
+        sent = 0
+
+        try:
+            while sent < bytes_to_write:
+                if timeout is None or timeout >= 0:
+                    if not util.wait_for_write(base_socket, timeout):
+                        raise socket.error(errno.EAGAIN, "timed out")
+                chunk_sent = base_socket.send(data)
+                sent += chunk_sent
+
+                # This has some needless copying here, but I'm not sure there's
+                # much value in optimising this data path.
+                data = data[chunk_sent:]
+        except (socket.error) as e:
+            error = e.errno
+
+            if error is not None and error != errno.EAGAIN:
+                data_length_pointer[0] = sent
+                if error == errno.ECONNRESET or error == errno.EPIPE:
+                    return SecurityConst.errSSLClosedAbort
+                raise
+
+        data_length_pointer[0] = sent
+
+        if sent != bytes_to_write:
+            return SecurityConst.errSSLWouldBlock
+
+        return 0
+    except Exception as e:
+        if wrapped_socket is not None:
+            wrapped_socket._exception = e
+        return SecurityConst.errSSLInternal
+
+
+# We need to keep these two objects references alive: if they get GC'd while
+# in use then SecureTransport could attempt to call a function that is in freed
+# memory. That would be...uh...bad. Yeah, that's the word. Bad.
+_read_callback_pointer = Security.SSLReadFunc(_read_callback)
+_write_callback_pointer = Security.SSLWriteFunc(_write_callback)
+
+
+class WrappedSocket(object):
+    """
+    API-compatibility wrapper for Python's OpenSSL wrapped socket object.
+
+    Note: _makefile_refs, _drop(), and _reuse() are needed for the garbage
+    collector of PyPy.
+    """
+
+    def __init__(self, socket):
+        self.socket = socket
+        self.context = None
+        self._makefile_refs = 0
+        self._closed = False
+        self._exception = None
+        self._keychain = None
+        self._keychain_dir = None
+        self._client_cert_chain = None
+
+        # We save off the previously-configured timeout and then set it to
+        # zero. This is done because we use select and friends to handle the
+        # timeouts, but if we leave the timeout set on the lower socket then
+        # Python will "kindly" call select on that socket again for us. Avoid
+        # that by forcing the timeout to zero.
+        self._timeout = self.socket.gettimeout()
+        self.socket.settimeout(0)
+
+    @contextlib.contextmanager
+    def _raise_on_error(self):
+        """
+        A context manager that can be used to wrap calls that do I/O from
+        SecureTransport. If any of the I/O callbacks hit an exception, this
+        context manager will correctly propagate the exception after the fact.
+        This avoids silently swallowing those exceptions.
+
+        It also correctly forces the socket closed.
+        """
+        self._exception = None
+
+        # We explicitly don't catch around this yield because in the unlikely
+        # event that an exception was hit in the block we don't want to swallow
+        # it.
+        yield
+        if self._exception is not None:
+            exception, self._exception = self._exception, None
+            self.close()
+            raise exception
+
+    def _set_ciphers(self):
+        """
+        Sets up the allowed ciphers. By default this matches the set in
+        util.ssl_.DEFAULT_CIPHERS, at least as supported by macOS. This is done
+        custom and doesn't allow changing at this time, mostly because parsing
+        OpenSSL cipher strings is going to be a freaking nightmare.
+        """
+        ciphers = (Security.SSLCipherSuite * len(CIPHER_SUITES))(*CIPHER_SUITES)
+        result = Security.SSLSetEnabledCiphers(
+            self.context, ciphers, len(CIPHER_SUITES)
+        )
+        _assert_no_error(result)
+
+    def _set_alpn_protocols(self, protocols):
+        """
+        Sets up the ALPN protocols on the context.
+        """
+        if not protocols:
+            return
+        protocols_arr = _create_cfstring_array(protocols)
+        try:
+            result = Security.SSLSetALPNProtocols(self.context, protocols_arr)
+            _assert_no_error(result)
+        finally:
+            CoreFoundation.CFRelease(protocols_arr)
+
+    def _custom_validate(self, verify, trust_bundle):
+        """
+        Called when we have set custom validation. We do this in two cases:
+        first, when cert validation is entirely disabled; and second, when
+        using a custom trust DB.
+        Raises an SSLError if the connection is not trusted.
+        """
+        # If we disabled cert validation, just say: cool.
+        if not verify:
+            return
+
+        successes = (
+            SecurityConst.kSecTrustResultUnspecified,
+            SecurityConst.kSecTrustResultProceed,
+        )
+        try:
+            trust_result = self._evaluate_trust(trust_bundle)
+            if trust_result in successes:
+                return
+            reason = "error code: %d" % (trust_result,)
+        except Exception as e:
+            # Do not trust on error
+            reason = "exception: %r" % (e,)
+
+        # SecureTransport does not send an alert nor shuts down the connection.
+        rec = _build_tls_unknown_ca_alert(self.version())
+        self.socket.sendall(rec)
+        # close the connection immediately
+        # l_onoff = 1, activate linger
+        # l_linger = 0, linger for 0 seoncds
+        opts = struct.pack("ii", 1, 0)
+        self.socket.setsockopt(socket.SOL_SOCKET, socket.SO_LINGER, opts)
+        self.close()
+        raise ssl.SSLError("certificate verify failed, %s" % reason)
+
+    def _evaluate_trust(self, trust_bundle):
+        # We want data in memory, so load it up.
+        if os.path.isfile(trust_bundle):
+            with open(trust_bundle, "rb") as f:
+                trust_bundle = f.read()
+
+        cert_array = None
+        trust = Security.SecTrustRef()
+
+        try:
+            # Get a CFArray that contains the certs we want.
+            cert_array = _cert_array_from_pem(trust_bundle)
+
+            # Ok, now the hard part. We want to get the SecTrustRef that ST has
+            # created for this connection, shove our CAs into it, tell ST to
+            # ignore everything else it knows, and then ask if it can build a
+            # chain. This is a buuuunch of code.
+            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
+            _assert_no_error(result)
+            if not trust:
+                raise ssl.SSLError("Failed to copy trust reference")
+
+            result = Security.SecTrustSetAnchorCertificates(trust, cert_array)
+            _assert_no_error(result)
+
+            result = Security.SecTrustSetAnchorCertificatesOnly(trust, True)
+            _assert_no_error(result)
+
+            trust_result = Security.SecTrustResultType()
+            result = Security.SecTrustEvaluate(trust, ctypes.byref(trust_result))
+            _assert_no_error(result)
+        finally:
+            if trust:
+                CoreFoundation.CFRelease(trust)
+
+            if cert_array is not None:
+                CoreFoundation.CFRelease(cert_array)
+
+        return trust_result.value
+
+    def handshake(
+        self,
+        server_hostname,
+        verify,
+        trust_bundle,
+        min_version,
+        max_version,
+        client_cert,
+        client_key,
+        client_key_passphrase,
+        alpn_protocols,
+    ):
+        """
+        Actually performs the TLS handshake. This is run automatically by
+        wrapped socket, and shouldn't be needed in user code.
+        """
+        # First, we do the initial bits of connection setup. We need to create
+        # a context, set its I/O funcs, and set the connection reference.
+        self.context = Security.SSLCreateContext(
+            None, SecurityConst.kSSLClientSide, SecurityConst.kSSLStreamType
+        )
+        result = Security.SSLSetIOFuncs(
+            self.context, _read_callback_pointer, _write_callback_pointer
+        )
+        _assert_no_error(result)
+
+        # Here we need to compute the handle to use. We do this by taking the
+        # id of self modulo 2**31 - 1. If this is already in the dictionary, we
+        # just keep incrementing by one until we find a free space.
+        with _connection_ref_lock:
+            handle = id(self) % 2147483647
+            while handle in _connection_refs:
+                handle = (handle + 1) % 2147483647
+            _connection_refs[handle] = self
+
+        result = Security.SSLSetConnection(self.context, handle)
+        _assert_no_error(result)
+
+        # If we have a server hostname, we should set that too.
+        if server_hostname:
+            if not isinstance(server_hostname, bytes):
+                server_hostname = server_hostname.encode("utf-8")
+
+            result = Security.SSLSetPeerDomainName(
+                self.context, server_hostname, len(server_hostname)
+            )
+            _assert_no_error(result)
+
+        # Setup the ciphers.
+        self._set_ciphers()
+
+        # Setup the ALPN protocols.
+        self._set_alpn_protocols(alpn_protocols)
+
+        # Set the minimum and maximum TLS versions.
+        result = Security.SSLSetProtocolVersionMin(self.context, min_version)
+        _assert_no_error(result)
+
+        result = Security.SSLSetProtocolVersionMax(self.context, max_version)
+        _assert_no_error(result)
+
+        # If there's a trust DB, we need to use it. We do that by telling
+        # SecureTransport to break on server auth. We also do that if we don't
+        # want to validate the certs at all: we just won't actually do any
+        # authing in that case.
+        if not verify or trust_bundle is not None:
+            result = Security.SSLSetSessionOption(
+                self.context, SecurityConst.kSSLSessionOptionBreakOnServerAuth, True
+            )
+            _assert_no_error(result)
+
+        # If there's a client cert, we need to use it.
+        if client_cert:
+            self._keychain, self._keychain_dir = _temporary_keychain()
+            self._client_cert_chain = _load_client_cert_chain(
+                self._keychain, client_cert, client_key
+            )
+            result = Security.SSLSetCertificate(self.context, self._client_cert_chain)
+            _assert_no_error(result)
+
+        while True:
+            with self._raise_on_error():
+                result = Security.SSLHandshake(self.context)
+
+                if result == SecurityConst.errSSLWouldBlock:
+                    raise socket.timeout("handshake timed out")
+                elif result == SecurityConst.errSSLServerAuthCompleted:
+                    self._custom_validate(verify, trust_bundle)
+                    continue
+                else:
+                    _assert_no_error(result)
+                    break
+
+    def fileno(self):
+        return self.socket.fileno()
+
+    # Copy-pasted from Python 3.5 source code
+    def _decref_socketios(self):
+        if self._makefile_refs > 0:
+            self._makefile_refs -= 1
+        if self._closed:
+            self.close()
+
+    def recv(self, bufsiz):
+        buffer = ctypes.create_string_buffer(bufsiz)
+        bytes_read = self.recv_into(buffer, bufsiz)
+        data = buffer[:bytes_read]
+        return data
+
+    def recv_into(self, buffer, nbytes=None):
+        # Read short on EOF.
+        if self._closed:
+            return 0
+
+        if nbytes is None:
+            nbytes = len(buffer)
+
+        buffer = (ctypes.c_char * nbytes).from_buffer(buffer)
+        processed_bytes = ctypes.c_size_t(0)
+
+        with self._raise_on_error():
+            result = Security.SSLRead(
+                self.context, buffer, nbytes, ctypes.byref(processed_bytes)
+            )
+
+        # There are some result codes that we want to treat as "not always
+        # errors". Specifically, those are errSSLWouldBlock,
+        # errSSLClosedGraceful, and errSSLClosedNoNotify.
+        if result == SecurityConst.errSSLWouldBlock:
+            # If we didn't process any bytes, then this was just a time out.
+            # However, we can get errSSLWouldBlock in situations when we *did*
+            # read some data, and in those cases we should just read "short"
+            # and return.
+            if processed_bytes.value == 0:
+                # Timed out, no data read.
+                raise socket.timeout("recv timed out")
+        elif result in (
+            SecurityConst.errSSLClosedGraceful,
+            SecurityConst.errSSLClosedNoNotify,
+        ):
+            # The remote peer has closed this connection. We should do so as
+            # well. Note that we don't actually return here because in
+            # principle this could actually be fired along with return data.
+            # It's unlikely though.
+            self.close()
+        else:
+            _assert_no_error(result)
+
+        # Ok, we read and probably succeeded. We should return whatever data
+        # was actually read.
+        return processed_bytes.value
+
+    def settimeout(self, timeout):
+        self._timeout = timeout
+
+    def gettimeout(self):
+        return self._timeout
+
+    def send(self, data):
+        processed_bytes = ctypes.c_size_t(0)
+
+        with self._raise_on_error():
+            result = Security.SSLWrite(
+                self.context, data, len(data), ctypes.byref(processed_bytes)
+            )
+
+        if result == SecurityConst.errSSLWouldBlock and processed_bytes.value == 0:
+            # Timed out
+            raise socket.timeout("send timed out")
+        else:
+            _assert_no_error(result)
+
+        # We sent, and probably succeeded. Tell them how much we sent.
+        return processed_bytes.value
+
+    def sendall(self, data):
+        total_sent = 0
+        while total_sent < len(data):
+            sent = self.send(data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE])
+            total_sent += sent
+
+    def shutdown(self):
+        with self._raise_on_error():
+            Security.SSLClose(self.context)
+
+    def close(self):
+        # TODO: should I do clean shutdown here? Do I have to?
+        if self._makefile_refs < 1:
+            self._closed = True
+            if self.context:
+                CoreFoundation.CFRelease(self.context)
+                self.context = None
+            if self._client_cert_chain:
+                CoreFoundation.CFRelease(self._client_cert_chain)
+                self._client_cert_chain = None
+            if self._keychain:
+                Security.SecKeychainDelete(self._keychain)
+                CoreFoundation.CFRelease(self._keychain)
+                shutil.rmtree(self._keychain_dir)
+                self._keychain = self._keychain_dir = None
+            return self.socket.close()
+        else:
+            self._makefile_refs -= 1
+
+    def getpeercert(self, binary_form=False):
+        # Urgh, annoying.
+        #
+        # Here's how we do this:
+        #
+        # 1. Call SSLCopyPeerTrust to get hold of the trust object for this
+        #    connection.
+        # 2. Call SecTrustGetCertificateAtIndex for index 0 to get the leaf.
+        # 3. To get the CN, call SecCertificateCopyCommonName and process that
+        #    string so that it's of the appropriate type.
+        # 4. To get the SAN, we need to do something a bit more complex:
+        #    a. Call SecCertificateCopyValues to get the data, requesting
+        #       kSecOIDSubjectAltName.
+        #    b. Mess about with this dictionary to try to get the SANs out.
+        #
+        # This is gross. Really gross. It's going to be a few hundred LoC extra
+        # just to repeat something that SecureTransport can *already do*. So my
+        # operating assumption at this time is that what we want to do is
+        # instead to just flag to urllib3 that it shouldn't do its own hostname
+        # validation when using SecureTransport.
+        if not binary_form:
+            raise ValueError("SecureTransport only supports dumping binary certs")
+        trust = Security.SecTrustRef()
+        certdata = None
+        der_bytes = None
+
+        try:
+            # Grab the trust store.
+            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
+            _assert_no_error(result)
+            if not trust:
+                # Probably we haven't done the handshake yet. No biggie.
+                return None
+
+            cert_count = Security.SecTrustGetCertificateCount(trust)
+            if not cert_count:
+                # Also a case that might happen if we haven't handshaked.
+                # Handshook? Handshaken?
+                return None
+
+            leaf = Security.SecTrustGetCertificateAtIndex(trust, 0)
+            assert leaf
+
+            # Ok, now we want the DER bytes.
+            certdata = Security.SecCertificateCopyData(leaf)
+            assert certdata
+
+            data_length = CoreFoundation.CFDataGetLength(certdata)
+            data_buffer = CoreFoundation.CFDataGetBytePtr(certdata)
+            der_bytes = ctypes.string_at(data_buffer, data_length)
+        finally:
+            if certdata:
+                CoreFoundation.CFRelease(certdata)
+            if trust:
+                CoreFoundation.CFRelease(trust)
+
+        return der_bytes
+
+    def version(self):
+        protocol = Security.SSLProtocol()
+        result = Security.SSLGetNegotiatedProtocolVersion(
+            self.context, ctypes.byref(protocol)
+        )
+        _assert_no_error(result)
+        if protocol.value == SecurityConst.kTLSProtocol13:
+            raise ssl.SSLError("SecureTransport does not support TLS 1.3")
+        elif protocol.value == SecurityConst.kTLSProtocol12:
+            return "TLSv1.2"
+        elif protocol.value == SecurityConst.kTLSProtocol11:
+            return "TLSv1.1"
+        elif protocol.value == SecurityConst.kTLSProtocol1:
+            return "TLSv1"
+        elif protocol.value == SecurityConst.kSSLProtocol3:
+            return "SSLv3"
+        elif protocol.value == SecurityConst.kSSLProtocol2:
+            return "SSLv2"
+        else:
+            raise ssl.SSLError("Unknown TLS version: %r" % protocol)
+
+    def _reuse(self):
+        self._makefile_refs += 1
+
+    def _drop(self):
+        if self._makefile_refs < 1:
+            self.close()
+        else:
+            self._makefile_refs -= 1
+
+
+if _fileobject:  # Platform-specific: Python 2
+
+    def makefile(self, mode, bufsize=-1):
+        self._makefile_refs += 1
+        return _fileobject(self, mode, bufsize, close=True)
+
+
+else:  # Platform-specific: Python 3
+
+    def makefile(self, mode="r", buffering=None, *args, **kwargs):
+        # We disable buffering with SecureTransport because it conflicts with
+        # the buffering that ST does internally (see issue #1153 for more).
+        buffering = 0
+        return backport_makefile(self, mode, buffering, *args, **kwargs)
+
+
+WrappedSocket.makefile = makefile
+
+
+class SecureTransportContext(object):
+    """
+    I am a wrapper class for the SecureTransport library, to translate the
+    interface of the standard library ``SSLContext`` object to calls into
+    SecureTransport.
+    """
+
+    def __init__(self, protocol):
+        self._min_version, self._max_version = _protocol_to_min_max[protocol]
+        self._options = 0
+        self._verify = False
+        self._trust_bundle = None
+        self._client_cert = None
+        self._client_key = None
+        self._client_key_passphrase = None
+        self._alpn_protocols = None
+
+    @property
+    def check_hostname(self):
+        """
+        SecureTransport cannot have its hostname checking disabled. For more,
+        see the comment on getpeercert() in this file.
+        """
+        return True
+
+    @check_hostname.setter
+    def check_hostname(self, value):
+        """
+        SecureTransport cannot have its hostname checking disabled. For more,
+        see the comment on getpeercert() in this file.
+        """
+        pass
+
+    @property
+    def options(self):
+        # TODO: Well, crap.
+        #
+        # So this is the bit of the code that is the most likely to cause us
+        # trouble. Essentially we need to enumerate all of the SSL options that
+        # users might want to use and try to see if we can sensibly translate
+        # them, or whether we should just ignore them.
+        return self._options
+
+    @options.setter
+    def options(self, value):
+        # TODO: Update in line with above.
+        self._options = value
+
+    @property
+    def verify_mode(self):
+        return ssl.CERT_REQUIRED if self._verify else ssl.CERT_NONE
+
+    @verify_mode.setter
+    def verify_mode(self, value):
+        self._verify = True if value == ssl.CERT_REQUIRED else False
+
+    def set_default_verify_paths(self):
+        # So, this has to do something a bit weird. Specifically, what it does
+        # is nothing.
+        #
+        # This means that, if we had previously had load_verify_locations
+        # called, this does not undo that. We need to do that because it turns
+        # out that the rest of the urllib3 code will attempt to load the
+        # default verify paths if it hasn't been told about any paths, even if
+        # the context itself was sometime earlier. We resolve that by just
+        # ignoring it.
+        pass
+
+    def load_default_certs(self):
+        return self.set_default_verify_paths()
+
+    def set_ciphers(self, ciphers):
+        # For now, we just require the default cipher string.
+        if ciphers != util.ssl_.DEFAULT_CIPHERS:
+            raise ValueError("SecureTransport doesn't support custom cipher strings")
+
+    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+        # OK, we only really support cadata and cafile.
+        if capath is not None:
+            raise ValueError("SecureTransport does not support cert directories")
+
+        # Raise if cafile does not exist.
+        if cafile is not None:
+            with open(cafile):
+                pass
+
+        self._trust_bundle = cafile or cadata
+
+    def load_cert_chain(self, certfile, keyfile=None, password=None):
+        self._client_cert = certfile
+        self._client_key = keyfile
+        self._client_cert_passphrase = password
+
+    def set_alpn_protocols(self, protocols):
+        """
+        Sets the ALPN protocols that will later be set on the context.
+
+        Raises a NotImplementedError if ALPN is not supported.
+        """
+        if not hasattr(Security, "SSLSetALPNProtocols"):
+            raise NotImplementedError(
+                "SecureTransport supports ALPN only in macOS 10.12+"
+            )
+        self._alpn_protocols = [six.ensure_binary(p) for p in protocols]
+
+    def wrap_socket(
+        self,
+        sock,
+        server_side=False,
+        do_handshake_on_connect=True,
+        suppress_ragged_eofs=True,
+        server_hostname=None,
+    ):
+        # So, what do we do here? Firstly, we assert some properties. This is a
+        # stripped down shim, so there is some functionality we don't support.
+        # See PEP 543 for the real deal.
+        assert not server_side
+        assert do_handshake_on_connect
+        assert suppress_ragged_eofs
+
+        # Ok, we're good to go. Now we want to create the wrapped socket object
+        # and store it in the appropriate place.
+        wrapped_socket = WrappedSocket(sock)
+
+        # Now we can handshake
+        wrapped_socket.handshake(
+            server_hostname,
+            self._verify,
+            self._trust_bundle,
+            self._min_version,
+            self._max_version,
+            self._client_cert,
+            self._client_key,
+            self._client_key_passphrase,
+            self._alpn_protocols,
+        )
+        return wrapped_socket
diff --git a/openpype/vendor/python/python_2/urllib3/contrib/socks.py b/openpype/vendor/python/python_2/urllib3/contrib/socks.py
new file mode 100644
index 0000000000..c326e80dd1
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/contrib/socks.py
@@ -0,0 +1,216 @@
+# -*- coding: utf-8 -*-
+"""
+This module contains provisional support for SOCKS proxies from within
+urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and
+SOCKS5. To enable its functionality, either install PySocks or install this
+module with the ``socks`` extra.
+
+The SOCKS implementation supports the full range of urllib3 features. It also
+supports the following SOCKS features:
+
+- SOCKS4A (``proxy_url='socks4a://...``)
+- SOCKS4 (``proxy_url='socks4://...``)
+- SOCKS5 with remote DNS (``proxy_url='socks5h://...``)
+- SOCKS5 with local DNS (``proxy_url='socks5://...``)
+- Usernames and passwords for the SOCKS proxy
+
+.. note::
+   It is recommended to use ``socks5h://`` or ``socks4a://`` schemes in
+   your ``proxy_url`` to ensure that DNS resolution is done from the remote
+   server instead of client-side when connecting to a domain name.
+
+SOCKS4 supports IPv4 and domain names with the SOCKS4A extension. SOCKS5
+supports IPv4, IPv6, and domain names.
+
+When connecting to a SOCKS4 proxy the ``username`` portion of the ``proxy_url``
+will be sent as the ``userid`` section of the SOCKS request:
+
+.. code-block:: python
+
+    proxy_url="socks4a://<userid>@proxy-host"
+
+When connecting to a SOCKS5 proxy the ``username`` and ``password`` portion
+of the ``proxy_url`` will be sent as the username/password to authenticate
+with the proxy:
+
+.. code-block:: python
+
+    proxy_url="socks5h://<username>:<password>@proxy-host"
+
+"""
+from __future__ import absolute_import
+
+try:
+    import socks
+except ImportError:
+    import warnings
+
+    from ..exceptions import DependencyWarning
+
+    warnings.warn(
+        (
+            "SOCKS support in urllib3 requires the installation of optional "
+            "dependencies: specifically, PySocks.  For more information, see "
+            "https://urllib3.readthedocs.io/en/1.26.x/contrib.html#socks-proxies"
+        ),
+        DependencyWarning,
+    )
+    raise
+
+from socket import error as SocketError
+from socket import timeout as SocketTimeout
+
+from ..connection import HTTPConnection, HTTPSConnection
+from ..connectionpool import HTTPConnectionPool, HTTPSConnectionPool
+from ..exceptions import ConnectTimeoutError, NewConnectionError
+from ..poolmanager import PoolManager
+from ..util.url import parse_url
+
+try:
+    import ssl
+except ImportError:
+    ssl = None
+
+
+class SOCKSConnection(HTTPConnection):
+    """
+    A plain-text HTTP connection that connects via a SOCKS proxy.
+    """
+
+    def __init__(self, *args, **kwargs):
+        self._socks_options = kwargs.pop("_socks_options")
+        super(SOCKSConnection, self).__init__(*args, **kwargs)
+
+    def _new_conn(self):
+        """
+        Establish a new connection via the SOCKS proxy.
+        """
+        extra_kw = {}
+        if self.source_address:
+            extra_kw["source_address"] = self.source_address
+
+        if self.socket_options:
+            extra_kw["socket_options"] = self.socket_options
+
+        try:
+            conn = socks.create_connection(
+                (self.host, self.port),
+                proxy_type=self._socks_options["socks_version"],
+                proxy_addr=self._socks_options["proxy_host"],
+                proxy_port=self._socks_options["proxy_port"],
+                proxy_username=self._socks_options["username"],
+                proxy_password=self._socks_options["password"],
+                proxy_rdns=self._socks_options["rdns"],
+                timeout=self.timeout,
+                **extra_kw
+            )
+
+        except SocketTimeout:
+            raise ConnectTimeoutError(
+                self,
+                "Connection to %s timed out. (connect timeout=%s)"
+                % (self.host, self.timeout),
+            )
+
+        except socks.ProxyError as e:
+            # This is fragile as hell, but it seems to be the only way to raise
+            # useful errors here.
+            if e.socket_err:
+                error = e.socket_err
+                if isinstance(error, SocketTimeout):
+                    raise ConnectTimeoutError(
+                        self,
+                        "Connection to %s timed out. (connect timeout=%s)"
+                        % (self.host, self.timeout),
+                    )
+                else:
+                    raise NewConnectionError(
+                        self, "Failed to establish a new connection: %s" % error
+                    )
+            else:
+                raise NewConnectionError(
+                    self, "Failed to establish a new connection: %s" % e
+                )
+
+        except SocketError as e:  # Defensive: PySocks should catch all these.
+            raise NewConnectionError(
+                self, "Failed to establish a new connection: %s" % e
+            )
+
+        return conn
+
+
+# We don't need to duplicate the Verified/Unverified distinction from
+# urllib3/connection.py here because the HTTPSConnection will already have been
+# correctly set to either the Verified or Unverified form by that module. This
+# means the SOCKSHTTPSConnection will automatically be the correct type.
+class SOCKSHTTPSConnection(SOCKSConnection, HTTPSConnection):
+    pass
+
+
+class SOCKSHTTPConnectionPool(HTTPConnectionPool):
+    ConnectionCls = SOCKSConnection
+
+
+class SOCKSHTTPSConnectionPool(HTTPSConnectionPool):
+    ConnectionCls = SOCKSHTTPSConnection
+
+
+class SOCKSProxyManager(PoolManager):
+    """
+    A version of the urllib3 ProxyManager that routes connections via the
+    defined SOCKS proxy.
+    """
+
+    pool_classes_by_scheme = {
+        "http": SOCKSHTTPConnectionPool,
+        "https": SOCKSHTTPSConnectionPool,
+    }
+
+    def __init__(
+        self,
+        proxy_url,
+        username=None,
+        password=None,
+        num_pools=10,
+        headers=None,
+        **connection_pool_kw
+    ):
+        parsed = parse_url(proxy_url)
+
+        if username is None and password is None and parsed.auth is not None:
+            split = parsed.auth.split(":")
+            if len(split) == 2:
+                username, password = split
+        if parsed.scheme == "socks5":
+            socks_version = socks.PROXY_TYPE_SOCKS5
+            rdns = False
+        elif parsed.scheme == "socks5h":
+            socks_version = socks.PROXY_TYPE_SOCKS5
+            rdns = True
+        elif parsed.scheme == "socks4":
+            socks_version = socks.PROXY_TYPE_SOCKS4
+            rdns = False
+        elif parsed.scheme == "socks4a":
+            socks_version = socks.PROXY_TYPE_SOCKS4
+            rdns = True
+        else:
+            raise ValueError("Unable to determine SOCKS version from %s" % proxy_url)
+
+        self.proxy_url = proxy_url
+
+        socks_options = {
+            "socks_version": socks_version,
+            "proxy_host": parsed.host,
+            "proxy_port": parsed.port,
+            "username": username,
+            "password": password,
+            "rdns": rdns,
+        }
+        connection_pool_kw["_socks_options"] = socks_options
+
+        super(SOCKSProxyManager, self).__init__(
+            num_pools, headers, **connection_pool_kw
+        )
+
+        self.pool_classes_by_scheme = SOCKSProxyManager.pool_classes_by_scheme
diff --git a/openpype/vendor/python/python_2/urllib3/exceptions.py b/openpype/vendor/python/python_2/urllib3/exceptions.py
new file mode 100644
index 0000000000..cba6f3f560
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/exceptions.py
@@ -0,0 +1,323 @@
+from __future__ import absolute_import
+
+from .packages.six.moves.http_client import IncompleteRead as httplib_IncompleteRead
+
+# Base Exceptions
+
+
+class HTTPError(Exception):
+    """Base exception used by this module."""
+
+    pass
+
+
+class HTTPWarning(Warning):
+    """Base warning used by this module."""
+
+    pass
+
+
+class PoolError(HTTPError):
+    """Base exception for errors caused within a pool."""
+
+    def __init__(self, pool, message):
+        self.pool = pool
+        HTTPError.__init__(self, "%s: %s" % (pool, message))
+
+    def __reduce__(self):
+        # For pickling purposes.
+        return self.__class__, (None, None)
+
+
+class RequestError(PoolError):
+    """Base exception for PoolErrors that have associated URLs."""
+
+    def __init__(self, pool, url, message):
+        self.url = url
+        PoolError.__init__(self, pool, message)
+
+    def __reduce__(self):
+        # For pickling purposes.
+        return self.__class__, (None, self.url, None)
+
+
+class SSLError(HTTPError):
+    """Raised when SSL certificate fails in an HTTPS connection."""
+
+    pass
+
+
+class ProxyError(HTTPError):
+    """Raised when the connection to a proxy fails."""
+
+    def __init__(self, message, error, *args):
+        super(ProxyError, self).__init__(message, error, *args)
+        self.original_error = error
+
+
+class DecodeError(HTTPError):
+    """Raised when automatic decoding based on Content-Type fails."""
+
+    pass
+
+
+class ProtocolError(HTTPError):
+    """Raised when something unexpected happens mid-request/response."""
+
+    pass
+
+
+#: Renamed to ProtocolError but aliased for backwards compatibility.
+ConnectionError = ProtocolError
+
+
+# Leaf Exceptions
+
+
+class MaxRetryError(RequestError):
+    """Raised when the maximum number of retries is exceeded.
+
+    :param pool: The connection pool
+    :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool`
+    :param string url: The requested Url
+    :param exceptions.Exception reason: The underlying error
+
+    """
+
+    def __init__(self, pool, url, reason=None):
+        self.reason = reason
+
+        message = "Max retries exceeded with url: %s (Caused by %r)" % (url, reason)
+
+        RequestError.__init__(self, pool, url, message)
+
+
+class HostChangedError(RequestError):
+    """Raised when an existing pool gets a request for a foreign host."""
+
+    def __init__(self, pool, url, retries=3):
+        message = "Tried to open a foreign host with url: %s" % url
+        RequestError.__init__(self, pool, url, message)
+        self.retries = retries
+
+
+class TimeoutStateError(HTTPError):
+    """Raised when passing an invalid state to a timeout"""
+
+    pass
+
+
+class TimeoutError(HTTPError):
+    """Raised when a socket timeout error occurs.
+
+    Catching this error will catch both :exc:`ReadTimeoutErrors
+    <ReadTimeoutError>` and :exc:`ConnectTimeoutErrors <ConnectTimeoutError>`.
+    """
+
+    pass
+
+
+class ReadTimeoutError(TimeoutError, RequestError):
+    """Raised when a socket timeout occurs while receiving data from a server"""
+
+    pass
+
+
+# This timeout error does not have a URL attached and needs to inherit from the
+# base HTTPError
+class ConnectTimeoutError(TimeoutError):
+    """Raised when a socket timeout occurs while connecting to a server"""
+
+    pass
+
+
+class NewConnectionError(ConnectTimeoutError, PoolError):
+    """Raised when we fail to establish a new connection. Usually ECONNREFUSED."""
+
+    pass
+
+
+class EmptyPoolError(PoolError):
+    """Raised when a pool runs out of connections and no more are allowed."""
+
+    pass
+
+
+class ClosedPoolError(PoolError):
+    """Raised when a request enters a pool after the pool has been closed."""
+
+    pass
+
+
+class LocationValueError(ValueError, HTTPError):
+    """Raised when there is something wrong with a given URL input."""
+
+    pass
+
+
+class LocationParseError(LocationValueError):
+    """Raised when get_host or similar fails to parse the URL input."""
+
+    def __init__(self, location):
+        message = "Failed to parse: %s" % location
+        HTTPError.__init__(self, message)
+
+        self.location = location
+
+
+class URLSchemeUnknown(LocationValueError):
+    """Raised when a URL input has an unsupported scheme."""
+
+    def __init__(self, scheme):
+        message = "Not supported URL scheme %s" % scheme
+        super(URLSchemeUnknown, self).__init__(message)
+
+        self.scheme = scheme
+
+
+class ResponseError(HTTPError):
+    """Used as a container for an error reason supplied in a MaxRetryError."""
+
+    GENERIC_ERROR = "too many error responses"
+    SPECIFIC_ERROR = "too many {status_code} error responses"
+
+
+class SecurityWarning(HTTPWarning):
+    """Warned when performing security reducing actions"""
+
+    pass
+
+
+class SubjectAltNameWarning(SecurityWarning):
+    """Warned when connecting to a host with a certificate missing a SAN."""
+
+    pass
+
+
+class InsecureRequestWarning(SecurityWarning):
+    """Warned when making an unverified HTTPS request."""
+
+    pass
+
+
+class SystemTimeWarning(SecurityWarning):
+    """Warned when system time is suspected to be wrong"""
+
+    pass
+
+
+class InsecurePlatformWarning(SecurityWarning):
+    """Warned when certain TLS/SSL configuration is not available on a platform."""
+
+    pass
+
+
+class SNIMissingWarning(HTTPWarning):
+    """Warned when making a HTTPS request without SNI available."""
+
+    pass
+
+
+class DependencyWarning(HTTPWarning):
+    """
+    Warned when an attempt is made to import a module with missing optional
+    dependencies.
+    """
+
+    pass
+
+
+class ResponseNotChunked(ProtocolError, ValueError):
+    """Response needs to be chunked in order to read it as chunks."""
+
+    pass
+
+
+class BodyNotHttplibCompatible(HTTPError):
+    """
+    Body should be :class:`http.client.HTTPResponse` like
+    (have an fp attribute which returns raw chunks) for read_chunked().
+    """
+
+    pass
+
+
+class IncompleteRead(HTTPError, httplib_IncompleteRead):
+    """
+    Response length doesn't match expected Content-Length
+
+    Subclass of :class:`http.client.IncompleteRead` to allow int value
+    for ``partial`` to avoid creating large objects on streamed reads.
+    """
+
+    def __init__(self, partial, expected):
+        super(IncompleteRead, self).__init__(partial, expected)
+
+    def __repr__(self):
+        return "IncompleteRead(%i bytes read, %i more expected)" % (
+            self.partial,
+            self.expected,
+        )
+
+
+class InvalidChunkLength(HTTPError, httplib_IncompleteRead):
+    """Invalid chunk length in a chunked response."""
+
+    def __init__(self, response, length):
+        super(InvalidChunkLength, self).__init__(
+            response.tell(), response.length_remaining
+        )
+        self.response = response
+        self.length = length
+
+    def __repr__(self):
+        return "InvalidChunkLength(got length %r, %i bytes read)" % (
+            self.length,
+            self.partial,
+        )
+
+
+class InvalidHeader(HTTPError):
+    """The header provided was somehow invalid."""
+
+    pass
+
+
+class ProxySchemeUnknown(AssertionError, URLSchemeUnknown):
+    """ProxyManager does not support the supplied scheme"""
+
+    # TODO(t-8ch): Stop inheriting from AssertionError in v2.0.
+
+    def __init__(self, scheme):
+        # 'localhost' is here because our URL parser parses
+        # localhost:8080 -> scheme=localhost, remove if we fix this.
+        if scheme == "localhost":
+            scheme = None
+        if scheme is None:
+            message = "Proxy URL had no scheme, should start with http:// or https://"
+        else:
+            message = (
+                "Proxy URL had unsupported scheme %s, should use http:// or https://"
+                % scheme
+            )
+        super(ProxySchemeUnknown, self).__init__(message)
+
+
+class ProxySchemeUnsupported(ValueError):
+    """Fetching HTTPS resources through HTTPS proxies is unsupported"""
+
+    pass
+
+
+class HeaderParsingError(HTTPError):
+    """Raised by assert_header_parsing, but we convert it to a log.warning statement."""
+
+    def __init__(self, defects, unparsed_data):
+        message = "%s, unparsed data: %r" % (defects or "Unknown", unparsed_data)
+        super(HeaderParsingError, self).__init__(message)
+
+
+class UnrewindableBodyError(HTTPError):
+    """urllib3 encountered an error when trying to rewind a body"""
+
+    pass
diff --git a/openpype/vendor/python/python_2/urllib3/fields.py b/openpype/vendor/python/python_2/urllib3/fields.py
new file mode 100644
index 0000000000..9d630f491d
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/fields.py
@@ -0,0 +1,274 @@
+from __future__ import absolute_import
+
+import email.utils
+import mimetypes
+import re
+
+from .packages import six
+
+
+def guess_content_type(filename, default="application/octet-stream"):
+    """
+    Guess the "Content-Type" of a file.
+
+    :param filename:
+        The filename to guess the "Content-Type" of using :mod:`mimetypes`.
+    :param default:
+        If no "Content-Type" can be guessed, default to `default`.
+    """
+    if filename:
+        return mimetypes.guess_type(filename)[0] or default
+    return default
+
+
+def format_header_param_rfc2231(name, value):
+    """
+    Helper function to format and quote a single header parameter using the
+    strategy defined in RFC 2231.
+
+    Particularly useful for header parameters which might contain
+    non-ASCII values, like file names. This follows
+    `RFC 2388 Section 4.4 <https://tools.ietf.org/html/rfc2388#section-4.4>`_.
+
+    :param name:
+        The name of the parameter, a string expected to be ASCII only.
+    :param value:
+        The value of the parameter, provided as ``bytes`` or `str``.
+    :ret:
+        An RFC-2231-formatted unicode string.
+    """
+    if isinstance(value, six.binary_type):
+        value = value.decode("utf-8")
+
+    if not any(ch in value for ch in '"\\\r\n'):
+        result = u'%s="%s"' % (name, value)
+        try:
+            result.encode("ascii")
+        except (UnicodeEncodeError, UnicodeDecodeError):
+            pass
+        else:
+            return result
+
+    if six.PY2:  # Python 2:
+        value = value.encode("utf-8")
+
+    # encode_rfc2231 accepts an encoded string and returns an ascii-encoded
+    # string in Python 2 but accepts and returns unicode strings in Python 3
+    value = email.utils.encode_rfc2231(value, "utf-8")
+    value = "%s*=%s" % (name, value)
+
+    if six.PY2:  # Python 2:
+        value = value.decode("utf-8")
+
+    return value
+
+
+_HTML5_REPLACEMENTS = {
+    u"\u0022": u"%22",
+    # Replace "\" with "\\".
+    u"\u005C": u"\u005C\u005C",
+}
+
+# All control characters from 0x00 to 0x1F *except* 0x1B.
+_HTML5_REPLACEMENTS.update(
+    {
+        six.unichr(cc): u"%{:02X}".format(cc)
+        for cc in range(0x00, 0x1F + 1)
+        if cc not in (0x1B,)
+    }
+)
+
+
+def _replace_multiple(value, needles_and_replacements):
+    def replacer(match):
+        return needles_and_replacements[match.group(0)]
+
+    pattern = re.compile(
+        r"|".join([re.escape(needle) for needle in needles_and_replacements.keys()])
+    )
+
+    result = pattern.sub(replacer, value)
+
+    return result
+
+
+def format_header_param_html5(name, value):
+    """
+    Helper function to format and quote a single header parameter using the
+    HTML5 strategy.
+
+    Particularly useful for header parameters which might contain
+    non-ASCII values, like file names. This follows the `HTML5 Working Draft
+    Section 4.10.22.7`_ and matches the behavior of curl and modern browsers.
+
+    .. _HTML5 Working Draft Section 4.10.22.7:
+        https://w3c.github.io/html/sec-forms.html#multipart-form-data
+
+    :param name:
+        The name of the parameter, a string expected to be ASCII only.
+    :param value:
+        The value of the parameter, provided as ``bytes`` or `str``.
+    :ret:
+        A unicode string, stripped of troublesome characters.
+    """
+    if isinstance(value, six.binary_type):
+        value = value.decode("utf-8")
+
+    value = _replace_multiple(value, _HTML5_REPLACEMENTS)
+
+    return u'%s="%s"' % (name, value)
+
+
+# For backwards-compatibility.
+format_header_param = format_header_param_html5
+
+
+class RequestField(object):
+    """
+    A data container for request body parameters.
+
+    :param name:
+        The name of this request field. Must be unicode.
+    :param data:
+        The data/value body.
+    :param filename:
+        An optional filename of the request field. Must be unicode.
+    :param headers:
+        An optional dict-like object of headers to initially use for the field.
+    :param header_formatter:
+        An optional callable that is used to encode and format the headers. By
+        default, this is :func:`format_header_param_html5`.
+    """
+
+    def __init__(
+        self,
+        name,
+        data,
+        filename=None,
+        headers=None,
+        header_formatter=format_header_param_html5,
+    ):
+        self._name = name
+        self._filename = filename
+        self.data = data
+        self.headers = {}
+        if headers:
+            self.headers = dict(headers)
+        self.header_formatter = header_formatter
+
+    @classmethod
+    def from_tuples(cls, fieldname, value, header_formatter=format_header_param_html5):
+        """
+        A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters.
+
+        Supports constructing :class:`~urllib3.fields.RequestField` from
+        parameter of key/value strings AND key/filetuple. A filetuple is a
+        (filename, data, MIME type) tuple where the MIME type is optional.
+        For example::
+
+            'foo': 'bar',
+            'fakefile': ('foofile.txt', 'contents of foofile'),
+            'realfile': ('barfile.txt', open('realfile').read()),
+            'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'),
+            'nonamefile': 'contents of nonamefile field',
+
+        Field names and filenames must be unicode.
+        """
+        if isinstance(value, tuple):
+            if len(value) == 3:
+                filename, data, content_type = value
+            else:
+                filename, data = value
+                content_type = guess_content_type(filename)
+        else:
+            filename = None
+            content_type = None
+            data = value
+
+        request_param = cls(
+            fieldname, data, filename=filename, header_formatter=header_formatter
+        )
+        request_param.make_multipart(content_type=content_type)
+
+        return request_param
+
+    def _render_part(self, name, value):
+        """
+        Overridable helper function to format a single header parameter. By
+        default, this calls ``self.header_formatter``.
+
+        :param name:
+            The name of the parameter, a string expected to be ASCII only.
+        :param value:
+            The value of the parameter, provided as a unicode string.
+        """
+
+        return self.header_formatter(name, value)
+
+    def _render_parts(self, header_parts):
+        """
+        Helper function to format and quote a single header.
+
+        Useful for single headers that are composed of multiple items. E.g.,
+        'Content-Disposition' fields.
+
+        :param header_parts:
+            A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format
+            as `k1="v1"; k2="v2"; ...`.
+        """
+        parts = []
+        iterable = header_parts
+        if isinstance(header_parts, dict):
+            iterable = header_parts.items()
+
+        for name, value in iterable:
+            if value is not None:
+                parts.append(self._render_part(name, value))
+
+        return u"; ".join(parts)
+
+    def render_headers(self):
+        """
+        Renders the headers for this request field.
+        """
+        lines = []
+
+        sort_keys = ["Content-Disposition", "Content-Type", "Content-Location"]
+        for sort_key in sort_keys:
+            if self.headers.get(sort_key, False):
+                lines.append(u"%s: %s" % (sort_key, self.headers[sort_key]))
+
+        for header_name, header_value in self.headers.items():
+            if header_name not in sort_keys:
+                if header_value:
+                    lines.append(u"%s: %s" % (header_name, header_value))
+
+        lines.append(u"\r\n")
+        return u"\r\n".join(lines)
+
+    def make_multipart(
+        self, content_disposition=None, content_type=None, content_location=None
+    ):
+        """
+        Makes this request field into a multipart request field.
+
+        This method overrides "Content-Disposition", "Content-Type" and
+        "Content-Location" headers to the request parameter.
+
+        :param content_type:
+            The 'Content-Type' of the request body.
+        :param content_location:
+            The 'Content-Location' of the request body.
+
+        """
+        self.headers["Content-Disposition"] = content_disposition or u"form-data"
+        self.headers["Content-Disposition"] += u"; ".join(
+            [
+                u"",
+                self._render_parts(
+                    ((u"name", self._name), (u"filename", self._filename))
+                ),
+            ]
+        )
+        self.headers["Content-Type"] = content_type
+        self.headers["Content-Location"] = content_location
diff --git a/openpype/vendor/python/python_2/urllib3/filepost.py b/openpype/vendor/python/python_2/urllib3/filepost.py
new file mode 100644
index 0000000000..36c9252c64
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/filepost.py
@@ -0,0 +1,98 @@
+from __future__ import absolute_import
+
+import binascii
+import codecs
+import os
+from io import BytesIO
+
+from .fields import RequestField
+from .packages import six
+from .packages.six import b
+
+writer = codecs.lookup("utf-8")[3]
+
+
+def choose_boundary():
+    """
+    Our embarrassingly-simple replacement for mimetools.choose_boundary.
+    """
+    boundary = binascii.hexlify(os.urandom(16))
+    if not six.PY2:
+        boundary = boundary.decode("ascii")
+    return boundary
+
+
+def iter_field_objects(fields):
+    """
+    Iterate over fields.
+
+    Supports list of (k, v) tuples and dicts, and lists of
+    :class:`~urllib3.fields.RequestField`.
+
+    """
+    if isinstance(fields, dict):
+        i = six.iteritems(fields)
+    else:
+        i = iter(fields)
+
+    for field in i:
+        if isinstance(field, RequestField):
+            yield field
+        else:
+            yield RequestField.from_tuples(*field)
+
+
+def iter_fields(fields):
+    """
+    .. deprecated:: 1.6
+
+    Iterate over fields.
+
+    The addition of :class:`~urllib3.fields.RequestField` makes this function
+    obsolete. Instead, use :func:`iter_field_objects`, which returns
+    :class:`~urllib3.fields.RequestField` objects.
+
+    Supports list of (k, v) tuples and dicts.
+    """
+    if isinstance(fields, dict):
+        return ((k, v) for k, v in six.iteritems(fields))
+
+    return ((k, v) for k, v in fields)
+
+
+def encode_multipart_formdata(fields, boundary=None):
+    """
+    Encode a dictionary of ``fields`` using the multipart/form-data MIME format.
+
+    :param fields:
+        Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`).
+
+    :param boundary:
+        If not specified, then a random boundary will be generated using
+        :func:`urllib3.filepost.choose_boundary`.
+    """
+    body = BytesIO()
+    if boundary is None:
+        boundary = choose_boundary()
+
+    for field in iter_field_objects(fields):
+        body.write(b("--%s\r\n" % (boundary)))
+
+        writer(body).write(field.render_headers())
+        data = field.data
+
+        if isinstance(data, int):
+            data = str(data)  # Backwards compatibility
+
+        if isinstance(data, six.text_type):
+            writer(body).write(data)
+        else:
+            body.write(data)
+
+        body.write(b"\r\n")
+
+    body.write(b("--%s--\r\n" % (boundary)))
+
+    content_type = str("multipart/form-data; boundary=%s" % boundary)
+
+    return body.getvalue(), content_type
diff --git a/openpype/vendor/python/python_2/urllib3/packages/__init__.py b/openpype/vendor/python/python_2/urllib3/packages/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/vendor/python/python_2/urllib3/packages/backports/__init__.py b/openpype/vendor/python/python_2/urllib3/packages/backports/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/vendor/python/python_2/urllib3/packages/backports/makefile.py b/openpype/vendor/python/python_2/urllib3/packages/backports/makefile.py
new file mode 100644
index 0000000000..b8fb2154b6
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/packages/backports/makefile.py
@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+"""
+backports.makefile
+~~~~~~~~~~~~~~~~~~
+
+Backports the Python 3 ``socket.makefile`` method for use with anything that
+wants to create a "fake" socket object.
+"""
+import io
+from socket import SocketIO
+
+
+def backport_makefile(
+    self, mode="r", buffering=None, encoding=None, errors=None, newline=None
+):
+    """
+    Backport of ``socket.makefile`` from Python 3.5.
+    """
+    if not set(mode) <= {"r", "w", "b"}:
+        raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
+    writing = "w" in mode
+    reading = "r" in mode or not writing
+    assert reading or writing
+    binary = "b" in mode
+    rawmode = ""
+    if reading:
+        rawmode += "r"
+    if writing:
+        rawmode += "w"
+    raw = SocketIO(self, rawmode)
+    self._makefile_refs += 1
+    if buffering is None:
+        buffering = -1
+    if buffering < 0:
+        buffering = io.DEFAULT_BUFFER_SIZE
+    if buffering == 0:
+        if not binary:
+            raise ValueError("unbuffered streams must be binary")
+        return raw
+    if reading and writing:
+        buffer = io.BufferedRWPair(raw, raw, buffering)
+    elif reading:
+        buffer = io.BufferedReader(raw, buffering)
+    else:
+        assert writing
+        buffer = io.BufferedWriter(raw, buffering)
+    if binary:
+        return buffer
+    text = io.TextIOWrapper(buffer, encoding, errors, newline)
+    text.mode = mode
+    return text
diff --git a/openpype/vendor/python/python_2/urllib3/packages/six.py b/openpype/vendor/python/python_2/urllib3/packages/six.py
new file mode 100644
index 0000000000..ba50acb062
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/packages/six.py
@@ -0,0 +1,1077 @@
+# Copyright (c) 2010-2020 Benjamin Peterson
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""Utilities for writing code that runs on Python 2 and 3"""
+
+from __future__ import absolute_import
+
+import functools
+import itertools
+import operator
+import sys
+import types
+
+__author__ = "Benjamin Peterson <benjamin@python.org>"
+__version__ = "1.16.0"
+
+
+# Useful for very coarse version differentiation.
+PY2 = sys.version_info[0] == 2
+PY3 = sys.version_info[0] == 3
+PY34 = sys.version_info[0:2] >= (3, 4)
+
+if PY3:
+    string_types = (str,)
+    integer_types = (int,)
+    class_types = (type,)
+    text_type = str
+    binary_type = bytes
+
+    MAXSIZE = sys.maxsize
+else:
+    string_types = (basestring,)
+    integer_types = (int, long)
+    class_types = (type, types.ClassType)
+    text_type = unicode
+    binary_type = str
+
+    if sys.platform.startswith("java"):
+        # Jython always uses 32 bits.
+        MAXSIZE = int((1 << 31) - 1)
+    else:
+        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
+        class X(object):
+            def __len__(self):
+                return 1 << 31
+
+        try:
+            len(X())
+        except OverflowError:
+            # 32-bit
+            MAXSIZE = int((1 << 31) - 1)
+        else:
+            # 64-bit
+            MAXSIZE = int((1 << 63) - 1)
+        del X
+
+if PY34:
+    from importlib.util import spec_from_loader
+else:
+    spec_from_loader = None
+
+
+def _add_doc(func, doc):
+    """Add documentation to a function."""
+    func.__doc__ = doc
+
+
+def _import_module(name):
+    """Import module, returning the module after the last dot."""
+    __import__(name)
+    return sys.modules[name]
+
+
+class _LazyDescr(object):
+    def __init__(self, name):
+        self.name = name
+
+    def __get__(self, obj, tp):
+        result = self._resolve()
+        setattr(obj, self.name, result)  # Invokes __set__.
+        try:
+            # This is a bit ugly, but it avoids running this again by
+            # removing this descriptor.
+            delattr(obj.__class__, self.name)
+        except AttributeError:
+            pass
+        return result
+
+
+class MovedModule(_LazyDescr):
+    def __init__(self, name, old, new=None):
+        super(MovedModule, self).__init__(name)
+        if PY3:
+            if new is None:
+                new = name
+            self.mod = new
+        else:
+            self.mod = old
+
+    def _resolve(self):
+        return _import_module(self.mod)
+
+    def __getattr__(self, attr):
+        _module = self._resolve()
+        value = getattr(_module, attr)
+        setattr(self, attr, value)
+        return value
+
+
+class _LazyModule(types.ModuleType):
+    def __init__(self, name):
+        super(_LazyModule, self).__init__(name)
+        self.__doc__ = self.__class__.__doc__
+
+    def __dir__(self):
+        attrs = ["__doc__", "__name__"]
+        attrs += [attr.name for attr in self._moved_attributes]
+        return attrs
+
+    # Subclasses should override this
+    _moved_attributes = []
+
+
+class MovedAttribute(_LazyDescr):
+    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
+        super(MovedAttribute, self).__init__(name)
+        if PY3:
+            if new_mod is None:
+                new_mod = name
+            self.mod = new_mod
+            if new_attr is None:
+                if old_attr is None:
+                    new_attr = name
+                else:
+                    new_attr = old_attr
+            self.attr = new_attr
+        else:
+            self.mod = old_mod
+            if old_attr is None:
+                old_attr = name
+            self.attr = old_attr
+
+    def _resolve(self):
+        module = _import_module(self.mod)
+        return getattr(module, self.attr)
+
+
+class _SixMetaPathImporter(object):
+
+    """
+    A meta path importer to import six.moves and its submodules.
+
+    This class implements a PEP302 finder and loader. It should be compatible
+    with Python 2.5 and all existing versions of Python3
+    """
+
+    def __init__(self, six_module_name):
+        self.name = six_module_name
+        self.known_modules = {}
+
+    def _add_module(self, mod, *fullnames):
+        for fullname in fullnames:
+            self.known_modules[self.name + "." + fullname] = mod
+
+    def _get_module(self, fullname):
+        return self.known_modules[self.name + "." + fullname]
+
+    def find_module(self, fullname, path=None):
+        if fullname in self.known_modules:
+            return self
+        return None
+
+    def find_spec(self, fullname, path, target=None):
+        if fullname in self.known_modules:
+            return spec_from_loader(fullname, self)
+        return None
+
+    def __get_module(self, fullname):
+        try:
+            return self.known_modules[fullname]
+        except KeyError:
+            raise ImportError("This loader does not know module " + fullname)
+
+    def load_module(self, fullname):
+        try:
+            # in case of a reload
+            return sys.modules[fullname]
+        except KeyError:
+            pass
+        mod = self.__get_module(fullname)
+        if isinstance(mod, MovedModule):
+            mod = mod._resolve()
+        else:
+            mod.__loader__ = self
+        sys.modules[fullname] = mod
+        return mod
+
+    def is_package(self, fullname):
+        """
+        Return true, if the named module is a package.
+
+        We need this method to get correct spec objects with
+        Python 3.4 (see PEP451)
+        """
+        return hasattr(self.__get_module(fullname), "__path__")
+
+    def get_code(self, fullname):
+        """Return None
+
+        Required, if is_package is implemented"""
+        self.__get_module(fullname)  # eventually raises ImportError
+        return None
+
+    get_source = get_code  # same as get_code
+
+    def create_module(self, spec):
+        return self.load_module(spec.name)
+
+    def exec_module(self, module):
+        pass
+
+
+_importer = _SixMetaPathImporter(__name__)
+
+
+class _MovedItems(_LazyModule):
+
+    """Lazy loading of moved objects"""
+
+    __path__ = []  # mark as package
+
+
+_moved_attributes = [
+    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
+    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
+    MovedAttribute(
+        "filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"
+    ),
+    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
+    MovedAttribute("intern", "__builtin__", "sys"),
+    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
+    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
+    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
+    MovedAttribute("getoutput", "commands", "subprocess"),
+    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute(
+        "reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"
+    ),
+    MovedAttribute("reduce", "__builtin__", "functools"),
+    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
+    MovedAttribute("StringIO", "StringIO", "io"),
+    MovedAttribute("UserDict", "UserDict", "collections"),
+    MovedAttribute("UserList", "UserList", "collections"),
+    MovedAttribute("UserString", "UserString", "collections"),
+    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
+    MovedAttribute(
+        "zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"
+    ),
+    MovedModule("builtins", "__builtin__"),
+    MovedModule("configparser", "ConfigParser"),
+    MovedModule(
+        "collections_abc",
+        "collections",
+        "collections.abc" if sys.version_info >= (3, 3) else "collections",
+    ),
+    MovedModule("copyreg", "copy_reg"),
+    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
+    MovedModule("dbm_ndbm", "dbm", "dbm.ndbm"),
+    MovedModule(
+        "_dummy_thread",
+        "dummy_thread",
+        "_dummy_thread" if sys.version_info < (3, 9) else "_thread",
+    ),
+    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
+    MovedModule("http_cookies", "Cookie", "http.cookies"),
+    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
+    MovedModule("html_parser", "HTMLParser", "html.parser"),
+    MovedModule("http_client", "httplib", "http.client"),
+    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
+    MovedModule("email_mime_image", "email.MIMEImage", "email.mime.image"),
+    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
+    MovedModule(
+        "email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"
+    ),
+    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
+    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
+    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
+    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
+    MovedModule("cPickle", "cPickle", "pickle"),
+    MovedModule("queue", "Queue"),
+    MovedModule("reprlib", "repr"),
+    MovedModule("socketserver", "SocketServer"),
+    MovedModule("_thread", "thread", "_thread"),
+    MovedModule("tkinter", "Tkinter"),
+    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
+    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
+    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
+    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
+    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
+    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
+    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
+    MovedModule("tkinter_colorchooser", "tkColorChooser", "tkinter.colorchooser"),
+    MovedModule("tkinter_commondialog", "tkCommonDialog", "tkinter.commondialog"),
+    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
+    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
+    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", "tkinter.simpledialog"),
+    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
+    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
+    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
+    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
+    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
+    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
+]
+# Add windows specific modules.
+if sys.platform == "win32":
+    _moved_attributes += [
+        MovedModule("winreg", "_winreg"),
+    ]
+
+for attr in _moved_attributes:
+    setattr(_MovedItems, attr.name, attr)
+    if isinstance(attr, MovedModule):
+        _importer._add_module(attr, "moves." + attr.name)
+del attr
+
+_MovedItems._moved_attributes = _moved_attributes
+
+moves = _MovedItems(__name__ + ".moves")
+_importer._add_module(moves, "moves")
+
+
+class Module_six_moves_urllib_parse(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_parse"""
+
+
+_urllib_parse_moved_attributes = [
+    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
+    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
+    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
+    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
+    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("quote", "urllib", "urllib.parse"),
+    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
+    MovedAttribute("unquote", "urllib", "urllib.parse"),
+    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
+    MovedAttribute(
+        "unquote_to_bytes", "urllib", "urllib.parse", "unquote", "unquote_to_bytes"
+    ),
+    MovedAttribute("urlencode", "urllib", "urllib.parse"),
+    MovedAttribute("splitquery", "urllib", "urllib.parse"),
+    MovedAttribute("splittag", "urllib", "urllib.parse"),
+    MovedAttribute("splituser", "urllib", "urllib.parse"),
+    MovedAttribute("splitvalue", "urllib", "urllib.parse"),
+    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
+]
+for attr in _urllib_parse_moved_attributes:
+    setattr(Module_six_moves_urllib_parse, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
+    "moves.urllib_parse",
+    "moves.urllib.parse",
+)
+
+
+class Module_six_moves_urllib_error(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_error"""
+
+
+_urllib_error_moved_attributes = [
+    MovedAttribute("URLError", "urllib2", "urllib.error"),
+    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
+    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
+]
+for attr in _urllib_error_moved_attributes:
+    setattr(Module_six_moves_urllib_error, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
+    "moves.urllib_error",
+    "moves.urllib.error",
+)
+
+
+class Module_six_moves_urllib_request(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_request"""
+
+
+_urllib_request_moved_attributes = [
+    MovedAttribute("urlopen", "urllib2", "urllib.request"),
+    MovedAttribute("install_opener", "urllib2", "urllib.request"),
+    MovedAttribute("build_opener", "urllib2", "urllib.request"),
+    MovedAttribute("pathname2url", "urllib", "urllib.request"),
+    MovedAttribute("url2pathname", "urllib", "urllib.request"),
+    MovedAttribute("getproxies", "urllib", "urllib.request"),
+    MovedAttribute("Request", "urllib2", "urllib.request"),
+    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
+    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
+    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
+    MovedAttribute("URLopener", "urllib", "urllib.request"),
+    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
+    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
+    MovedAttribute("parse_http_list", "urllib2", "urllib.request"),
+    MovedAttribute("parse_keqv_list", "urllib2", "urllib.request"),
+]
+for attr in _urllib_request_moved_attributes:
+    setattr(Module_six_moves_urllib_request, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
+    "moves.urllib_request",
+    "moves.urllib.request",
+)
+
+
+class Module_six_moves_urllib_response(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_response"""
+
+
+_urllib_response_moved_attributes = [
+    MovedAttribute("addbase", "urllib", "urllib.response"),
+    MovedAttribute("addclosehook", "urllib", "urllib.response"),
+    MovedAttribute("addinfo", "urllib", "urllib.response"),
+    MovedAttribute("addinfourl", "urllib", "urllib.response"),
+]
+for attr in _urllib_response_moved_attributes:
+    setattr(Module_six_moves_urllib_response, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
+    "moves.urllib_response",
+    "moves.urllib.response",
+)
+
+
+class Module_six_moves_urllib_robotparser(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_robotparser"""
+
+
+_urllib_robotparser_moved_attributes = [
+    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"),
+]
+for attr in _urllib_robotparser_moved_attributes:
+    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_robotparser._moved_attributes = (
+    _urllib_robotparser_moved_attributes
+)
+
+_importer._add_module(
+    Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
+    "moves.urllib_robotparser",
+    "moves.urllib.robotparser",
+)
+
+
+class Module_six_moves_urllib(types.ModuleType):
+
+    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""
+
+    __path__ = []  # mark as package
+    parse = _importer._get_module("moves.urllib_parse")
+    error = _importer._get_module("moves.urllib_error")
+    request = _importer._get_module("moves.urllib_request")
+    response = _importer._get_module("moves.urllib_response")
+    robotparser = _importer._get_module("moves.urllib_robotparser")
+
+    def __dir__(self):
+        return ["parse", "error", "request", "response", "robotparser"]
+
+
+_importer._add_module(
+    Module_six_moves_urllib(__name__ + ".moves.urllib"), "moves.urllib"
+)
+
+
+def add_move(move):
+    """Add an item to six.moves."""
+    setattr(_MovedItems, move.name, move)
+
+
+def remove_move(name):
+    """Remove item from six.moves."""
+    try:
+        delattr(_MovedItems, name)
+    except AttributeError:
+        try:
+            del moves.__dict__[name]
+        except KeyError:
+            raise AttributeError("no such move, %r" % (name,))
+
+
+if PY3:
+    _meth_func = "__func__"
+    _meth_self = "__self__"
+
+    _func_closure = "__closure__"
+    _func_code = "__code__"
+    _func_defaults = "__defaults__"
+    _func_globals = "__globals__"
+else:
+    _meth_func = "im_func"
+    _meth_self = "im_self"
+
+    _func_closure = "func_closure"
+    _func_code = "func_code"
+    _func_defaults = "func_defaults"
+    _func_globals = "func_globals"
+
+
+try:
+    advance_iterator = next
+except NameError:
+
+    def advance_iterator(it):
+        return it.next()
+
+
+next = advance_iterator
+
+
+try:
+    callable = callable
+except NameError:
+
+    def callable(obj):
+        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)
+
+
+if PY3:
+
+    def get_unbound_function(unbound):
+        return unbound
+
+    create_bound_method = types.MethodType
+
+    def create_unbound_method(func, cls):
+        return func
+
+    Iterator = object
+else:
+
+    def get_unbound_function(unbound):
+        return unbound.im_func
+
+    def create_bound_method(func, obj):
+        return types.MethodType(func, obj, obj.__class__)
+
+    def create_unbound_method(func, cls):
+        return types.MethodType(func, None, cls)
+
+    class Iterator(object):
+        def next(self):
+            return type(self).__next__(self)
+
+    callable = callable
+_add_doc(
+    get_unbound_function, """Get the function out of a possibly unbound function"""
+)
+
+
+get_method_function = operator.attrgetter(_meth_func)
+get_method_self = operator.attrgetter(_meth_self)
+get_function_closure = operator.attrgetter(_func_closure)
+get_function_code = operator.attrgetter(_func_code)
+get_function_defaults = operator.attrgetter(_func_defaults)
+get_function_globals = operator.attrgetter(_func_globals)
+
+
+if PY3:
+
+    def iterkeys(d, **kw):
+        return iter(d.keys(**kw))
+
+    def itervalues(d, **kw):
+        return iter(d.values(**kw))
+
+    def iteritems(d, **kw):
+        return iter(d.items(**kw))
+
+    def iterlists(d, **kw):
+        return iter(d.lists(**kw))
+
+    viewkeys = operator.methodcaller("keys")
+
+    viewvalues = operator.methodcaller("values")
+
+    viewitems = operator.methodcaller("items")
+else:
+
+    def iterkeys(d, **kw):
+        return d.iterkeys(**kw)
+
+    def itervalues(d, **kw):
+        return d.itervalues(**kw)
+
+    def iteritems(d, **kw):
+        return d.iteritems(**kw)
+
+    def iterlists(d, **kw):
+        return d.iterlists(**kw)
+
+    viewkeys = operator.methodcaller("viewkeys")
+
+    viewvalues = operator.methodcaller("viewvalues")
+
+    viewitems = operator.methodcaller("viewitems")
+
+_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
+_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
+_add_doc(iteritems, "Return an iterator over the (key, value) pairs of a dictionary.")
+_add_doc(
+    iterlists, "Return an iterator over the (key, [values]) pairs of a dictionary."
+)
+
+
+if PY3:
+
+    def b(s):
+        return s.encode("latin-1")
+
+    def u(s):
+        return s
+
+    unichr = chr
+    import struct
+
+    int2byte = struct.Struct(">B").pack
+    del struct
+    byte2int = operator.itemgetter(0)
+    indexbytes = operator.getitem
+    iterbytes = iter
+    import io
+
+    StringIO = io.StringIO
+    BytesIO = io.BytesIO
+    del io
+    _assertCountEqual = "assertCountEqual"
+    if sys.version_info[1] <= 1:
+        _assertRaisesRegex = "assertRaisesRegexp"
+        _assertRegex = "assertRegexpMatches"
+        _assertNotRegex = "assertNotRegexpMatches"
+    else:
+        _assertRaisesRegex = "assertRaisesRegex"
+        _assertRegex = "assertRegex"
+        _assertNotRegex = "assertNotRegex"
+else:
+
+    def b(s):
+        return s
+
+    # Workaround for standalone backslash
+
+    def u(s):
+        return unicode(s.replace(r"\\", r"\\\\"), "unicode_escape")
+
+    unichr = unichr
+    int2byte = chr
+
+    def byte2int(bs):
+        return ord(bs[0])
+
+    def indexbytes(buf, i):
+        return ord(buf[i])
+
+    iterbytes = functools.partial(itertools.imap, ord)
+    import StringIO
+
+    StringIO = BytesIO = StringIO.StringIO
+    _assertCountEqual = "assertItemsEqual"
+    _assertRaisesRegex = "assertRaisesRegexp"
+    _assertRegex = "assertRegexpMatches"
+    _assertNotRegex = "assertNotRegexpMatches"
+_add_doc(b, """Byte literal""")
+_add_doc(u, """Text literal""")
+
+
+def assertCountEqual(self, *args, **kwargs):
+    return getattr(self, _assertCountEqual)(*args, **kwargs)
+
+
+def assertRaisesRegex(self, *args, **kwargs):
+    return getattr(self, _assertRaisesRegex)(*args, **kwargs)
+
+
+def assertRegex(self, *args, **kwargs):
+    return getattr(self, _assertRegex)(*args, **kwargs)
+
+
+def assertNotRegex(self, *args, **kwargs):
+    return getattr(self, _assertNotRegex)(*args, **kwargs)
+
+
+if PY3:
+    exec_ = getattr(moves.builtins, "exec")
+
+    def reraise(tp, value, tb=None):
+        try:
+            if value is None:
+                value = tp()
+            if value.__traceback__ is not tb:
+                raise value.with_traceback(tb)
+            raise value
+        finally:
+            value = None
+            tb = None
+
+
+else:
+
+    def exec_(_code_, _globs_=None, _locs_=None):
+        """Execute code in a namespace."""
+        if _globs_ is None:
+            frame = sys._getframe(1)
+            _globs_ = frame.f_globals
+            if _locs_ is None:
+                _locs_ = frame.f_locals
+            del frame
+        elif _locs_ is None:
+            _locs_ = _globs_
+        exec ("""exec _code_ in _globs_, _locs_""")
+
+    exec_(
+        """def reraise(tp, value, tb=None):
+    try:
+        raise tp, value, tb
+    finally:
+        tb = None
+"""
+    )
+
+
+if sys.version_info[:2] > (3,):
+    exec_(
+        """def raise_from(value, from_value):
+    try:
+        raise value from from_value
+    finally:
+        value = None
+"""
+    )
+else:
+
+    def raise_from(value, from_value):
+        raise value
+
+
+print_ = getattr(moves.builtins, "print", None)
+if print_ is None:
+
+    def print_(*args, **kwargs):
+        """The new-style print function for Python 2.4 and 2.5."""
+        fp = kwargs.pop("file", sys.stdout)
+        if fp is None:
+            return
+
+        def write(data):
+            if not isinstance(data, basestring):
+                data = str(data)
+            # If the file has an encoding, encode unicode with it.
+            if (
+                isinstance(fp, file)
+                and isinstance(data, unicode)
+                and fp.encoding is not None
+            ):
+                errors = getattr(fp, "errors", None)
+                if errors is None:
+                    errors = "strict"
+                data = data.encode(fp.encoding, errors)
+            fp.write(data)
+
+        want_unicode = False
+        sep = kwargs.pop("sep", None)
+        if sep is not None:
+            if isinstance(sep, unicode):
+                want_unicode = True
+            elif not isinstance(sep, str):
+                raise TypeError("sep must be None or a string")
+        end = kwargs.pop("end", None)
+        if end is not None:
+            if isinstance(end, unicode):
+                want_unicode = True
+            elif not isinstance(end, str):
+                raise TypeError("end must be None or a string")
+        if kwargs:
+            raise TypeError("invalid keyword arguments to print()")
+        if not want_unicode:
+            for arg in args:
+                if isinstance(arg, unicode):
+                    want_unicode = True
+                    break
+        if want_unicode:
+            newline = unicode("\n")
+            space = unicode(" ")
+        else:
+            newline = "\n"
+            space = " "
+        if sep is None:
+            sep = space
+        if end is None:
+            end = newline
+        for i, arg in enumerate(args):
+            if i:
+                write(sep)
+            write(arg)
+        write(end)
+
+
+if sys.version_info[:2] < (3, 3):
+    _print = print_
+
+    def print_(*args, **kwargs):
+        fp = kwargs.get("file", sys.stdout)
+        flush = kwargs.pop("flush", False)
+        _print(*args, **kwargs)
+        if flush and fp is not None:
+            fp.flush()
+
+
+_add_doc(reraise, """Reraise an exception.""")
+
+if sys.version_info[0:2] < (3, 4):
+    # This does exactly the same what the :func:`py3:functools.update_wrapper`
+    # function does on Python versions after 3.2. It sets the ``__wrapped__``
+    # attribute on ``wrapper`` object and it doesn't raise an error if any of
+    # the attributes mentioned in ``assigned`` and ``updated`` are missing on
+    # ``wrapped`` object.
+    def _update_wrapper(
+        wrapper,
+        wrapped,
+        assigned=functools.WRAPPER_ASSIGNMENTS,
+        updated=functools.WRAPPER_UPDATES,
+    ):
+        for attr in assigned:
+            try:
+                value = getattr(wrapped, attr)
+            except AttributeError:
+                continue
+            else:
+                setattr(wrapper, attr, value)
+        for attr in updated:
+            getattr(wrapper, attr).update(getattr(wrapped, attr, {}))
+        wrapper.__wrapped__ = wrapped
+        return wrapper
+
+    _update_wrapper.__doc__ = functools.update_wrapper.__doc__
+
+    def wraps(
+        wrapped,
+        assigned=functools.WRAPPER_ASSIGNMENTS,
+        updated=functools.WRAPPER_UPDATES,
+    ):
+        return functools.partial(
+            _update_wrapper, wrapped=wrapped, assigned=assigned, updated=updated
+        )
+
+    wraps.__doc__ = functools.wraps.__doc__
+
+else:
+    wraps = functools.wraps
+
+
+def with_metaclass(meta, *bases):
+    """Create a base class with a metaclass."""
+    # This requires a bit of explanation: the basic idea is to make a dummy
+    # metaclass for one level of class instantiation that replaces itself with
+    # the actual metaclass.
+    class metaclass(type):
+        def __new__(cls, name, this_bases, d):
+            if sys.version_info[:2] >= (3, 7):
+                # This version introduced PEP 560 that requires a bit
+                # of extra care (we mimic what is done by __build_class__).
+                resolved_bases = types.resolve_bases(bases)
+                if resolved_bases is not bases:
+                    d["__orig_bases__"] = bases
+            else:
+                resolved_bases = bases
+            return meta(name, resolved_bases, d)
+
+        @classmethod
+        def __prepare__(cls, name, this_bases):
+            return meta.__prepare__(name, bases)
+
+    return type.__new__(metaclass, "temporary_class", (), {})
+
+
+def add_metaclass(metaclass):
+    """Class decorator for creating a class with a metaclass."""
+
+    def wrapper(cls):
+        orig_vars = cls.__dict__.copy()
+        slots = orig_vars.get("__slots__")
+        if slots is not None:
+            if isinstance(slots, str):
+                slots = [slots]
+            for slots_var in slots:
+                orig_vars.pop(slots_var)
+        orig_vars.pop("__dict__", None)
+        orig_vars.pop("__weakref__", None)
+        if hasattr(cls, "__qualname__"):
+            orig_vars["__qualname__"] = cls.__qualname__
+        return metaclass(cls.__name__, cls.__bases__, orig_vars)
+
+    return wrapper
+
+
+def ensure_binary(s, encoding="utf-8", errors="strict"):
+    """Coerce **s** to six.binary_type.
+
+    For Python 2:
+      - `unicode` -> encoded to `str`
+      - `str` -> `str`
+
+    For Python 3:
+      - `str` -> encoded to `bytes`
+      - `bytes` -> `bytes`
+    """
+    if isinstance(s, binary_type):
+        return s
+    if isinstance(s, text_type):
+        return s.encode(encoding, errors)
+    raise TypeError("not expecting type '%s'" % type(s))
+
+
+def ensure_str(s, encoding="utf-8", errors="strict"):
+    """Coerce *s* to `str`.
+
+    For Python 2:
+      - `unicode` -> encoded to `str`
+      - `str` -> `str`
+
+    For Python 3:
+      - `str` -> `str`
+      - `bytes` -> decoded to `str`
+    """
+    # Optimization: Fast return for the common case.
+    if type(s) is str:
+        return s
+    if PY2 and isinstance(s, text_type):
+        return s.encode(encoding, errors)
+    elif PY3 and isinstance(s, binary_type):
+        return s.decode(encoding, errors)
+    elif not isinstance(s, (text_type, binary_type)):
+        raise TypeError("not expecting type '%s'" % type(s))
+    return s
+
+
+def ensure_text(s, encoding="utf-8", errors="strict"):
+    """Coerce *s* to six.text_type.
+
+    For Python 2:
+      - `unicode` -> `unicode`
+      - `str` -> `unicode`
+
+    For Python 3:
+      - `str` -> `str`
+      - `bytes` -> decoded to `str`
+    """
+    if isinstance(s, binary_type):
+        return s.decode(encoding, errors)
+    elif isinstance(s, text_type):
+        return s
+    else:
+        raise TypeError("not expecting type '%s'" % type(s))
+
+
+def python_2_unicode_compatible(klass):
+    """
+    A class decorator that defines __unicode__ and __str__ methods under Python 2.
+    Under Python 3 it does nothing.
+
+    To support Python 2 and 3 with a single code base, define a __str__ method
+    returning text and apply this decorator to the class.
+    """
+    if PY2:
+        if "__str__" not in klass.__dict__:
+            raise ValueError(
+                "@python_2_unicode_compatible cannot be applied "
+                "to %s because it doesn't define __str__()." % klass.__name__
+            )
+        klass.__unicode__ = klass.__str__
+        klass.__str__ = lambda self: self.__unicode__().encode("utf-8")
+    return klass
+
+
+# Complete the moves implementation.
+# This code is at the end of this module to speed up module loading.
+# Turn this module into a package.
+__path__ = []  # required for PEP 302 and PEP 451
+__package__ = __name__  # see PEP 366 @ReservedAssignment
+if globals().get("__spec__") is not None:
+    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
+# Remove other six meta path importers, since they cause problems. This can
+# happen if six is removed from sys.modules and then reloaded. (Setuptools does
+# this for some reason.)
+if sys.meta_path:
+    for i, importer in enumerate(sys.meta_path):
+        # Here's some real nastiness: Another "instance" of the six module might
+        # be floating around. Therefore, we can't use isinstance() to check for
+        # the six meta path importer, since the other six instance will have
+        # inserted an importer with different class.
+        if (
+            type(importer).__name__ == "_SixMetaPathImporter"
+            and importer.name == __name__
+        ):
+            del sys.meta_path[i]
+            break
+    del i, importer
+# Finally, add the importer to the meta path import hook.
+sys.meta_path.append(_importer)
diff --git a/openpype/vendor/python/python_2/urllib3/poolmanager.py b/openpype/vendor/python/python_2/urllib3/poolmanager.py
new file mode 100644
index 0000000000..ca4ec34118
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/poolmanager.py
@@ -0,0 +1,537 @@
+from __future__ import absolute_import
+
+import collections
+import functools
+import logging
+
+from ._collections import RecentlyUsedContainer
+from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, port_by_scheme
+from .exceptions import (
+    LocationValueError,
+    MaxRetryError,
+    ProxySchemeUnknown,
+    ProxySchemeUnsupported,
+    URLSchemeUnknown,
+)
+from .packages import six
+from .packages.six.moves.urllib.parse import urljoin
+from .request import RequestMethods
+from .util.proxy import connection_requires_http_tunnel
+from .util.retry import Retry
+from .util.url import parse_url
+
+__all__ = ["PoolManager", "ProxyManager", "proxy_from_url"]
+
+
+log = logging.getLogger(__name__)
+
+SSL_KEYWORDS = (
+    "key_file",
+    "cert_file",
+    "cert_reqs",
+    "ca_certs",
+    "ssl_version",
+    "ca_cert_dir",
+    "ssl_context",
+    "key_password",
+    "server_hostname",
+)
+
+# All known keyword arguments that could be provided to the pool manager, its
+# pools, or the underlying connections. This is used to construct a pool key.
+_key_fields = (
+    "key_scheme",  # str
+    "key_host",  # str
+    "key_port",  # int
+    "key_timeout",  # int or float or Timeout
+    "key_retries",  # int or Retry
+    "key_strict",  # bool
+    "key_block",  # bool
+    "key_source_address",  # str
+    "key_key_file",  # str
+    "key_key_password",  # str
+    "key_cert_file",  # str
+    "key_cert_reqs",  # str
+    "key_ca_certs",  # str
+    "key_ssl_version",  # str
+    "key_ca_cert_dir",  # str
+    "key_ssl_context",  # instance of ssl.SSLContext or urllib3.util.ssl_.SSLContext
+    "key_maxsize",  # int
+    "key_headers",  # dict
+    "key__proxy",  # parsed proxy url
+    "key__proxy_headers",  # dict
+    "key__proxy_config",  # class
+    "key_socket_options",  # list of (level (int), optname (int), value (int or str)) tuples
+    "key__socks_options",  # dict
+    "key_assert_hostname",  # bool or string
+    "key_assert_fingerprint",  # str
+    "key_server_hostname",  # str
+)
+
+#: The namedtuple class used to construct keys for the connection pool.
+#: All custom key schemes should include the fields in this key at a minimum.
+PoolKey = collections.namedtuple("PoolKey", _key_fields)
+
+_proxy_config_fields = ("ssl_context", "use_forwarding_for_https")
+ProxyConfig = collections.namedtuple("ProxyConfig", _proxy_config_fields)
+
+
+def _default_key_normalizer(key_class, request_context):
+    """
+    Create a pool key out of a request context dictionary.
+
+    According to RFC 3986, both the scheme and host are case-insensitive.
+    Therefore, this function normalizes both before constructing the pool
+    key for an HTTPS request. If you wish to change this behaviour, provide
+    alternate callables to ``key_fn_by_scheme``.
+
+    :param key_class:
+        The class to use when constructing the key. This should be a namedtuple
+        with the ``scheme`` and ``host`` keys at a minimum.
+    :type  key_class: namedtuple
+    :param request_context:
+        A dictionary-like object that contain the context for a request.
+    :type  request_context: dict
+
+    :return: A namedtuple that can be used as a connection pool key.
+    :rtype:  PoolKey
+    """
+    # Since we mutate the dictionary, make a copy first
+    context = request_context.copy()
+    context["scheme"] = context["scheme"].lower()
+    context["host"] = context["host"].lower()
+
+    # These are both dictionaries and need to be transformed into frozensets
+    for key in ("headers", "_proxy_headers", "_socks_options"):
+        if key in context and context[key] is not None:
+            context[key] = frozenset(context[key].items())
+
+    # The socket_options key may be a list and needs to be transformed into a
+    # tuple.
+    socket_opts = context.get("socket_options")
+    if socket_opts is not None:
+        context["socket_options"] = tuple(socket_opts)
+
+    # Map the kwargs to the names in the namedtuple - this is necessary since
+    # namedtuples can't have fields starting with '_'.
+    for key in list(context.keys()):
+        context["key_" + key] = context.pop(key)
+
+    # Default to ``None`` for keys missing from the context
+    for field in key_class._fields:
+        if field not in context:
+            context[field] = None
+
+    return key_class(**context)
+
+
+#: A dictionary that maps a scheme to a callable that creates a pool key.
+#: This can be used to alter the way pool keys are constructed, if desired.
+#: Each PoolManager makes a copy of this dictionary so they can be configured
+#: globally here, or individually on the instance.
+key_fn_by_scheme = {
+    "http": functools.partial(_default_key_normalizer, PoolKey),
+    "https": functools.partial(_default_key_normalizer, PoolKey),
+}
+
+pool_classes_by_scheme = {"http": HTTPConnectionPool, "https": HTTPSConnectionPool}
+
+
+class PoolManager(RequestMethods):
+    """
+    Allows for arbitrary requests while transparently keeping track of
+    necessary connection pools for you.
+
+    :param num_pools:
+        Number of connection pools to cache before discarding the least
+        recently used pool.
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+
+    :param \\**connection_pool_kw:
+        Additional parameters are used to create fresh
+        :class:`urllib3.connectionpool.ConnectionPool` instances.
+
+    Example::
+
+        >>> manager = PoolManager(num_pools=2)
+        >>> r = manager.request('GET', 'http://google.com/')
+        >>> r = manager.request('GET', 'http://google.com/mail')
+        >>> r = manager.request('GET', 'http://yahoo.com/')
+        >>> len(manager.pools)
+        2
+
+    """
+
+    proxy = None
+    proxy_config = None
+
+    def __init__(self, num_pools=10, headers=None, **connection_pool_kw):
+        RequestMethods.__init__(self, headers)
+        self.connection_pool_kw = connection_pool_kw
+        self.pools = RecentlyUsedContainer(num_pools, dispose_func=lambda p: p.close())
+
+        # Locally set the pool classes and keys so other PoolManagers can
+        # override them.
+        self.pool_classes_by_scheme = pool_classes_by_scheme
+        self.key_fn_by_scheme = key_fn_by_scheme.copy()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.clear()
+        # Return False to re-raise any potential exceptions
+        return False
+
+    def _new_pool(self, scheme, host, port, request_context=None):
+        """
+        Create a new :class:`urllib3.connectionpool.ConnectionPool` based on host, port, scheme, and
+        any additional pool keyword arguments.
+
+        If ``request_context`` is provided, it is provided as keyword arguments
+        to the pool class used. This method is used to actually create the
+        connection pools handed out by :meth:`connection_from_url` and
+        companion methods. It is intended to be overridden for customization.
+        """
+        pool_cls = self.pool_classes_by_scheme[scheme]
+        if request_context is None:
+            request_context = self.connection_pool_kw.copy()
+
+        # Although the context has everything necessary to create the pool,
+        # this function has historically only used the scheme, host, and port
+        # in the positional args. When an API change is acceptable these can
+        # be removed.
+        for key in ("scheme", "host", "port"):
+            request_context.pop(key, None)
+
+        if scheme == "http":
+            for kw in SSL_KEYWORDS:
+                request_context.pop(kw, None)
+
+        return pool_cls(host, port, **request_context)
+
+    def clear(self):
+        """
+        Empty our store of pools and direct them all to close.
+
+        This will not affect in-flight connections, but they will not be
+        re-used after completion.
+        """
+        self.pools.clear()
+
+    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
+        """
+        Get a :class:`urllib3.connectionpool.ConnectionPool` based on the host, port, and scheme.
+
+        If ``port`` isn't given, it will be derived from the ``scheme`` using
+        ``urllib3.connectionpool.port_by_scheme``. If ``pool_kwargs`` is
+        provided, it is merged with the instance's ``connection_pool_kw``
+        variable and used to create the new connection pool, if one is
+        needed.
+        """
+
+        if not host:
+            raise LocationValueError("No host specified.")
+
+        request_context = self._merge_pool_kwargs(pool_kwargs)
+        request_context["scheme"] = scheme or "http"
+        if not port:
+            port = port_by_scheme.get(request_context["scheme"].lower(), 80)
+        request_context["port"] = port
+        request_context["host"] = host
+
+        return self.connection_from_context(request_context)
+
+    def connection_from_context(self, request_context):
+        """
+        Get a :class:`urllib3.connectionpool.ConnectionPool` based on the request context.
+
+        ``request_context`` must at least contain the ``scheme`` key and its
+        value must be a key in ``key_fn_by_scheme`` instance variable.
+        """
+        scheme = request_context["scheme"].lower()
+        pool_key_constructor = self.key_fn_by_scheme.get(scheme)
+        if not pool_key_constructor:
+            raise URLSchemeUnknown(scheme)
+        pool_key = pool_key_constructor(request_context)
+
+        return self.connection_from_pool_key(pool_key, request_context=request_context)
+
+    def connection_from_pool_key(self, pool_key, request_context=None):
+        """
+        Get a :class:`urllib3.connectionpool.ConnectionPool` based on the provided pool key.
+
+        ``pool_key`` should be a namedtuple that only contains immutable
+        objects. At a minimum it must have the ``scheme``, ``host``, and
+        ``port`` fields.
+        """
+        with self.pools.lock:
+            # If the scheme, host, or port doesn't match existing open
+            # connections, open a new ConnectionPool.
+            pool = self.pools.get(pool_key)
+            if pool:
+                return pool
+
+            # Make a fresh ConnectionPool of the desired type
+            scheme = request_context["scheme"]
+            host = request_context["host"]
+            port = request_context["port"]
+            pool = self._new_pool(scheme, host, port, request_context=request_context)
+            self.pools[pool_key] = pool
+
+        return pool
+
+    def connection_from_url(self, url, pool_kwargs=None):
+        """
+        Similar to :func:`urllib3.connectionpool.connection_from_url`.
+
+        If ``pool_kwargs`` is not provided and a new pool needs to be
+        constructed, ``self.connection_pool_kw`` is used to initialize
+        the :class:`urllib3.connectionpool.ConnectionPool`. If ``pool_kwargs``
+        is provided, it is used instead. Note that if a new pool does not
+        need to be created for the request, the provided ``pool_kwargs`` are
+        not used.
+        """
+        u = parse_url(url)
+        return self.connection_from_host(
+            u.host, port=u.port, scheme=u.scheme, pool_kwargs=pool_kwargs
+        )
+
+    def _merge_pool_kwargs(self, override):
+        """
+        Merge a dictionary of override values for self.connection_pool_kw.
+
+        This does not modify self.connection_pool_kw and returns a new dict.
+        Any keys in the override dictionary with a value of ``None`` are
+        removed from the merged dictionary.
+        """
+        base_pool_kwargs = self.connection_pool_kw.copy()
+        if override:
+            for key, value in override.items():
+                if value is None:
+                    try:
+                        del base_pool_kwargs[key]
+                    except KeyError:
+                        pass
+                else:
+                    base_pool_kwargs[key] = value
+        return base_pool_kwargs
+
+    def _proxy_requires_url_absolute_form(self, parsed_url):
+        """
+        Indicates if the proxy requires the complete destination URL in the
+        request.  Normally this is only needed when not using an HTTP CONNECT
+        tunnel.
+        """
+        if self.proxy is None:
+            return False
+
+        return not connection_requires_http_tunnel(
+            self.proxy, self.proxy_config, parsed_url.scheme
+        )
+
+    def _validate_proxy_scheme_url_selection(self, url_scheme):
+        """
+        Validates that were not attempting to do TLS in TLS connections on
+        Python2 or with unsupported SSL implementations.
+        """
+        if self.proxy is None or url_scheme != "https":
+            return
+
+        if self.proxy.scheme != "https":
+            return
+
+        if six.PY2 and not self.proxy_config.use_forwarding_for_https:
+            raise ProxySchemeUnsupported(
+                "Contacting HTTPS destinations through HTTPS proxies "
+                "'via CONNECT tunnels' is not supported in Python 2"
+            )
+
+    def urlopen(self, method, url, redirect=True, **kw):
+        """
+        Same as :meth:`urllib3.HTTPConnectionPool.urlopen`
+        with custom cross-host redirect logic and only sends the request-uri
+        portion of the ``url``.
+
+        The given ``url`` parameter must be absolute, such that an appropriate
+        :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it.
+        """
+        u = parse_url(url)
+        self._validate_proxy_scheme_url_selection(u.scheme)
+
+        conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme)
+
+        kw["assert_same_host"] = False
+        kw["redirect"] = False
+
+        if "headers" not in kw:
+            kw["headers"] = self.headers.copy()
+
+        if self._proxy_requires_url_absolute_form(u):
+            response = conn.urlopen(method, url, **kw)
+        else:
+            response = conn.urlopen(method, u.request_uri, **kw)
+
+        redirect_location = redirect and response.get_redirect_location()
+        if not redirect_location:
+            return response
+
+        # Support relative URLs for redirecting.
+        redirect_location = urljoin(url, redirect_location)
+
+        # RFC 7231, Section 6.4.4
+        if response.status == 303:
+            method = "GET"
+
+        retries = kw.get("retries")
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect)
+
+        # Strip headers marked as unsafe to forward to the redirected location.
+        # Check remove_headers_on_redirect to avoid a potential network call within
+        # conn.is_same_host() which may use socket.gethostbyname() in the future.
+        if retries.remove_headers_on_redirect and not conn.is_same_host(
+            redirect_location
+        ):
+            headers = list(six.iterkeys(kw["headers"]))
+            for header in headers:
+                if header.lower() in retries.remove_headers_on_redirect:
+                    kw["headers"].pop(header, None)
+
+        try:
+            retries = retries.increment(method, url, response=response, _pool=conn)
+        except MaxRetryError:
+            if retries.raise_on_redirect:
+                response.drain_conn()
+                raise
+            return response
+
+        kw["retries"] = retries
+        kw["redirect"] = redirect
+
+        log.info("Redirecting %s -> %s", url, redirect_location)
+
+        response.drain_conn()
+        return self.urlopen(method, redirect_location, **kw)
+
+
+class ProxyManager(PoolManager):
+    """
+    Behaves just like :class:`PoolManager`, but sends all requests through
+    the defined proxy, using the CONNECT method for HTTPS URLs.
+
+    :param proxy_url:
+        The URL of the proxy to be used.
+
+    :param proxy_headers:
+        A dictionary containing headers that will be sent to the proxy. In case
+        of HTTP they are being sent with each request, while in the
+        HTTPS/CONNECT case they are sent only once. Could be used for proxy
+        authentication.
+
+    :param proxy_ssl_context:
+        The proxy SSL context is used to establish the TLS connection to the
+        proxy when using HTTPS proxies.
+
+    :param use_forwarding_for_https:
+        (Defaults to False) If set to True will forward requests to the HTTPS
+        proxy to be made on behalf of the client instead of creating a TLS
+        tunnel via the CONNECT method. **Enabling this flag means that request
+        and response headers and content will be visible from the HTTPS proxy**
+        whereas tunneling keeps request and response headers and content
+        private.  IP address, target hostname, SNI, and port are always visible
+        to an HTTPS proxy even when this flag is disabled.
+
+    Example:
+        >>> proxy = urllib3.ProxyManager('http://localhost:3128/')
+        >>> r1 = proxy.request('GET', 'http://google.com/')
+        >>> r2 = proxy.request('GET', 'http://httpbin.org/')
+        >>> len(proxy.pools)
+        1
+        >>> r3 = proxy.request('GET', 'https://httpbin.org/')
+        >>> r4 = proxy.request('GET', 'https://twitter.com/')
+        >>> len(proxy.pools)
+        3
+
+    """
+
+    def __init__(
+        self,
+        proxy_url,
+        num_pools=10,
+        headers=None,
+        proxy_headers=None,
+        proxy_ssl_context=None,
+        use_forwarding_for_https=False,
+        **connection_pool_kw
+    ):
+
+        if isinstance(proxy_url, HTTPConnectionPool):
+            proxy_url = "%s://%s:%i" % (
+                proxy_url.scheme,
+                proxy_url.host,
+                proxy_url.port,
+            )
+        proxy = parse_url(proxy_url)
+
+        if proxy.scheme not in ("http", "https"):
+            raise ProxySchemeUnknown(proxy.scheme)
+
+        if not proxy.port:
+            port = port_by_scheme.get(proxy.scheme, 80)
+            proxy = proxy._replace(port=port)
+
+        self.proxy = proxy
+        self.proxy_headers = proxy_headers or {}
+        self.proxy_ssl_context = proxy_ssl_context
+        self.proxy_config = ProxyConfig(proxy_ssl_context, use_forwarding_for_https)
+
+        connection_pool_kw["_proxy"] = self.proxy
+        connection_pool_kw["_proxy_headers"] = self.proxy_headers
+        connection_pool_kw["_proxy_config"] = self.proxy_config
+
+        super(ProxyManager, self).__init__(num_pools, headers, **connection_pool_kw)
+
+    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
+        if scheme == "https":
+            return super(ProxyManager, self).connection_from_host(
+                host, port, scheme, pool_kwargs=pool_kwargs
+            )
+
+        return super(ProxyManager, self).connection_from_host(
+            self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs
+        )
+
+    def _set_proxy_headers(self, url, headers=None):
+        """
+        Sets headers needed by proxies: specifically, the Accept and Host
+        headers. Only sets headers not provided by the user.
+        """
+        headers_ = {"Accept": "*/*"}
+
+        netloc = parse_url(url).netloc
+        if netloc:
+            headers_["Host"] = netloc
+
+        if headers:
+            headers_.update(headers)
+        return headers_
+
+    def urlopen(self, method, url, redirect=True, **kw):
+        "Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute."
+        u = parse_url(url)
+        if not connection_requires_http_tunnel(self.proxy, self.proxy_config, u.scheme):
+            # For connections using HTTP CONNECT, httplib sets the necessary
+            # headers on the CONNECT to the proxy. If we're not using CONNECT,
+            # we'll definitely need to set 'Host' at the very least.
+            headers = kw.get("headers", self.headers)
+            kw["headers"] = self._set_proxy_headers(url, headers)
+
+        return super(ProxyManager, self).urlopen(method, url, redirect=redirect, **kw)
+
+
+def proxy_from_url(url, **kw):
+    return ProxyManager(proxy_url=url, **kw)
diff --git a/openpype/vendor/python/python_2/urllib3/request.py b/openpype/vendor/python/python_2/urllib3/request.py
new file mode 100644
index 0000000000..398386a5b9
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/request.py
@@ -0,0 +1,170 @@
+from __future__ import absolute_import
+
+from .filepost import encode_multipart_formdata
+from .packages.six.moves.urllib.parse import urlencode
+
+__all__ = ["RequestMethods"]
+
+
+class RequestMethods(object):
+    """
+    Convenience mixin for classes who implement a :meth:`urlopen` method, such
+    as :class:`urllib3.HTTPConnectionPool` and
+    :class:`urllib3.PoolManager`.
+
+    Provides behavior for making common types of HTTP request methods and
+    decides which type of request field encoding to use.
+
+    Specifically,
+
+    :meth:`.request_encode_url` is for sending requests whose fields are
+    encoded in the URL (such as GET, HEAD, DELETE).
+
+    :meth:`.request_encode_body` is for sending requests whose fields are
+    encoded in the *body* of the request using multipart or www-form-urlencoded
+    (such as for POST, PUT, PATCH).
+
+    :meth:`.request` is for making any kind of request, it will look up the
+    appropriate encoding format and use one of the above two methods to make
+    the request.
+
+    Initializer parameters:
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+    """
+
+    _encode_url_methods = {"DELETE", "GET", "HEAD", "OPTIONS"}
+
+    def __init__(self, headers=None):
+        self.headers = headers or {}
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        encode_multipart=True,
+        multipart_boundary=None,
+        **kw
+    ):  # Abstract
+        raise NotImplementedError(
+            "Classes extending RequestMethods must implement "
+            "their own ``urlopen`` method."
+        )
+
+    def request(self, method, url, fields=None, headers=None, **urlopen_kw):
+        """
+        Make a request using :meth:`urlopen` with the appropriate encoding of
+        ``fields`` based on the ``method`` used.
+
+        This is a convenience method that requires the least amount of manual
+        effort. It can be used in most situations, while still having the
+        option to drop down to more specific methods when necessary, such as
+        :meth:`request_encode_url`, :meth:`request_encode_body`,
+        or even the lowest level :meth:`urlopen`.
+        """
+        method = method.upper()
+
+        urlopen_kw["request_url"] = url
+
+        if method in self._encode_url_methods:
+            return self.request_encode_url(
+                method, url, fields=fields, headers=headers, **urlopen_kw
+            )
+        else:
+            return self.request_encode_body(
+                method, url, fields=fields, headers=headers, **urlopen_kw
+            )
+
+    def request_encode_url(self, method, url, fields=None, headers=None, **urlopen_kw):
+        """
+        Make a request using :meth:`urlopen` with the ``fields`` encoded in
+        the url. This is useful for request methods like GET, HEAD, DELETE, etc.
+        """
+        if headers is None:
+            headers = self.headers
+
+        extra_kw = {"headers": headers}
+        extra_kw.update(urlopen_kw)
+
+        if fields:
+            url += "?" + urlencode(fields)
+
+        return self.urlopen(method, url, **extra_kw)
+
+    def request_encode_body(
+        self,
+        method,
+        url,
+        fields=None,
+        headers=None,
+        encode_multipart=True,
+        multipart_boundary=None,
+        **urlopen_kw
+    ):
+        """
+        Make a request using :meth:`urlopen` with the ``fields`` encoded in
+        the body. This is useful for request methods like POST, PUT, PATCH, etc.
+
+        When ``encode_multipart=True`` (default), then
+        :func:`urllib3.encode_multipart_formdata` is used to encode
+        the payload with the appropriate content type. Otherwise
+        :func:`urllib.parse.urlencode` is used with the
+        'application/x-www-form-urlencoded' content type.
+
+        Multipart encoding must be used when posting files, and it's reasonably
+        safe to use it in other times too. However, it may break request
+        signing, such as with OAuth.
+
+        Supports an optional ``fields`` parameter of key/value strings AND
+        key/filetuple. A filetuple is a (filename, data, MIME type) tuple where
+        the MIME type is optional. For example::
+
+            fields = {
+                'foo': 'bar',
+                'fakefile': ('foofile.txt', 'contents of foofile'),
+                'realfile': ('barfile.txt', open('realfile').read()),
+                'typedfile': ('bazfile.bin', open('bazfile').read(),
+                              'image/jpeg'),
+                'nonamefile': 'contents of nonamefile field',
+            }
+
+        When uploading a file, providing a filename (the first parameter of the
+        tuple) is optional but recommended to best mimic behavior of browsers.
+
+        Note that if ``headers`` are supplied, the 'Content-Type' header will
+        be overwritten because it depends on the dynamic random boundary string
+        which is used to compose the body of the request. The random boundary
+        string can be explicitly set with the ``multipart_boundary`` parameter.
+        """
+        if headers is None:
+            headers = self.headers
+
+        extra_kw = {"headers": {}}
+
+        if fields:
+            if "body" in urlopen_kw:
+                raise TypeError(
+                    "request got values for both 'fields' and 'body', can only specify one."
+                )
+
+            if encode_multipart:
+                body, content_type = encode_multipart_formdata(
+                    fields, boundary=multipart_boundary
+                )
+            else:
+                body, content_type = (
+                    urlencode(fields),
+                    "application/x-www-form-urlencoded",
+                )
+
+            extra_kw["body"] = body
+            extra_kw["headers"] = {"Content-Type": content_type}
+
+        extra_kw["headers"].update(headers)
+        extra_kw.update(urlopen_kw)
+
+        return self.urlopen(method, url, **extra_kw)
diff --git a/openpype/vendor/python/python_2/urllib3/response.py b/openpype/vendor/python/python_2/urllib3/response.py
new file mode 100644
index 0000000000..fdb50ddb2f
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/response.py
@@ -0,0 +1,824 @@
+from __future__ import absolute_import
+
+import io
+import logging
+import zlib
+from contextlib import contextmanager
+from socket import error as SocketError
+from socket import timeout as SocketTimeout
+
+try:
+    try:
+        import brotlicffi as brotli
+    except ImportError:
+        import brotli
+except ImportError:
+    brotli = None
+
+from ._collections import HTTPHeaderDict
+from .connection import BaseSSLError, HTTPException
+from .exceptions import (
+    BodyNotHttplibCompatible,
+    DecodeError,
+    HTTPError,
+    IncompleteRead,
+    InvalidChunkLength,
+    InvalidHeader,
+    ProtocolError,
+    ReadTimeoutError,
+    ResponseNotChunked,
+    SSLError,
+)
+from .packages import six
+from .util.response import is_fp_closed, is_response_to_head
+
+log = logging.getLogger(__name__)
+
+
+class DeflateDecoder(object):
+    def __init__(self):
+        self._first_try = True
+        self._data = b""
+        self._obj = zlib.decompressobj()
+
+    def __getattr__(self, name):
+        return getattr(self._obj, name)
+
+    def decompress(self, data):
+        if not data:
+            return data
+
+        if not self._first_try:
+            return self._obj.decompress(data)
+
+        self._data += data
+        try:
+            decompressed = self._obj.decompress(data)
+            if decompressed:
+                self._first_try = False
+                self._data = None
+            return decompressed
+        except zlib.error:
+            self._first_try = False
+            self._obj = zlib.decompressobj(-zlib.MAX_WBITS)
+            try:
+                return self.decompress(self._data)
+            finally:
+                self._data = None
+
+
+class GzipDecoderState(object):
+
+    FIRST_MEMBER = 0
+    OTHER_MEMBERS = 1
+    SWALLOW_DATA = 2
+
+
+class GzipDecoder(object):
+    def __init__(self):
+        self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
+        self._state = GzipDecoderState.FIRST_MEMBER
+
+    def __getattr__(self, name):
+        return getattr(self._obj, name)
+
+    def decompress(self, data):
+        ret = bytearray()
+        if self._state == GzipDecoderState.SWALLOW_DATA or not data:
+            return bytes(ret)
+        while True:
+            try:
+                ret += self._obj.decompress(data)
+            except zlib.error:
+                previous_state = self._state
+                # Ignore data after the first error
+                self._state = GzipDecoderState.SWALLOW_DATA
+                if previous_state == GzipDecoderState.OTHER_MEMBERS:
+                    # Allow trailing garbage acceptable in other gzip clients
+                    return bytes(ret)
+                raise
+            data = self._obj.unused_data
+            if not data:
+                return bytes(ret)
+            self._state = GzipDecoderState.OTHER_MEMBERS
+            self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
+
+
+if brotli is not None:
+
+    class BrotliDecoder(object):
+        # Supports both 'brotlipy' and 'Brotli' packages
+        # since they share an import name. The top branches
+        # are for 'brotlipy' and bottom branches for 'Brotli'
+        def __init__(self):
+            self._obj = brotli.Decompressor()
+            if hasattr(self._obj, "decompress"):
+                self.decompress = self._obj.decompress
+            else:
+                self.decompress = self._obj.process
+
+        def flush(self):
+            if hasattr(self._obj, "flush"):
+                return self._obj.flush()
+            return b""
+
+
+class MultiDecoder(object):
+    """
+    From RFC7231:
+        If one or more encodings have been applied to a representation, the
+        sender that applied the encodings MUST generate a Content-Encoding
+        header field that lists the content codings in the order in which
+        they were applied.
+    """
+
+    def __init__(self, modes):
+        self._decoders = [_get_decoder(m.strip()) for m in modes.split(",")]
+
+    def flush(self):
+        return self._decoders[0].flush()
+
+    def decompress(self, data):
+        for d in reversed(self._decoders):
+            data = d.decompress(data)
+        return data
+
+
+def _get_decoder(mode):
+    if "," in mode:
+        return MultiDecoder(mode)
+
+    if mode == "gzip":
+        return GzipDecoder()
+
+    if brotli is not None and mode == "br":
+        return BrotliDecoder()
+
+    return DeflateDecoder()
+
+
+class HTTPResponse(io.IOBase):
+    """
+    HTTP Response container.
+
+    Backwards-compatible with :class:`http.client.HTTPResponse` but the response ``body`` is
+    loaded and decoded on-demand when the ``data`` property is accessed.  This
+    class is also compatible with the Python standard library's :mod:`io`
+    module, and can hence be treated as a readable object in the context of that
+    framework.
+
+    Extra parameters for behaviour not present in :class:`http.client.HTTPResponse`:
+
+    :param preload_content:
+        If True, the response's body will be preloaded during construction.
+
+    :param decode_content:
+        If True, will attempt to decode the body based on the
+        'content-encoding' header.
+
+    :param original_response:
+        When this HTTPResponse wrapper is generated from an :class:`http.client.HTTPResponse`
+        object, it's convenient to include the original for debug purposes. It's
+        otherwise unused.
+
+    :param retries:
+        The retries contains the last :class:`~urllib3.util.retry.Retry` that
+        was used during the request.
+
+    :param enforce_content_length:
+        Enforce content length checking. Body returned by server must match
+        value of Content-Length header, if present. Otherwise, raise error.
+    """
+
+    CONTENT_DECODERS = ["gzip", "deflate"]
+    if brotli is not None:
+        CONTENT_DECODERS += ["br"]
+    REDIRECT_STATUSES = [301, 302, 303, 307, 308]
+
+    def __init__(
+        self,
+        body="",
+        headers=None,
+        status=0,
+        version=0,
+        reason=None,
+        strict=0,
+        preload_content=True,
+        decode_content=True,
+        original_response=None,
+        pool=None,
+        connection=None,
+        msg=None,
+        retries=None,
+        enforce_content_length=False,
+        request_method=None,
+        request_url=None,
+        auto_close=True,
+    ):
+
+        if isinstance(headers, HTTPHeaderDict):
+            self.headers = headers
+        else:
+            self.headers = HTTPHeaderDict(headers)
+        self.status = status
+        self.version = version
+        self.reason = reason
+        self.strict = strict
+        self.decode_content = decode_content
+        self.retries = retries
+        self.enforce_content_length = enforce_content_length
+        self.auto_close = auto_close
+
+        self._decoder = None
+        self._body = None
+        self._fp = None
+        self._original_response = original_response
+        self._fp_bytes_read = 0
+        self.msg = msg
+        self._request_url = request_url
+
+        if body and isinstance(body, (six.string_types, bytes)):
+            self._body = body
+
+        self._pool = pool
+        self._connection = connection
+
+        if hasattr(body, "read"):
+            self._fp = body
+
+        # Are we using the chunked-style of transfer encoding?
+        self.chunked = False
+        self.chunk_left = None
+        tr_enc = self.headers.get("transfer-encoding", "").lower()
+        # Don't incur the penalty of creating a list and then discarding it
+        encodings = (enc.strip() for enc in tr_enc.split(","))
+        if "chunked" in encodings:
+            self.chunked = True
+
+        # Determine length of response
+        self.length_remaining = self._init_length(request_method)
+
+        # If requested, preload the body.
+        if preload_content and not self._body:
+            self._body = self.read(decode_content=decode_content)
+
+    def get_redirect_location(self):
+        """
+        Should we redirect and where to?
+
+        :returns: Truthy redirect location string if we got a redirect status
+            code and valid location. ``None`` if redirect status and no
+            location. ``False`` if not a redirect status code.
+        """
+        if self.status in self.REDIRECT_STATUSES:
+            return self.headers.get("location")
+
+        return False
+
+    def release_conn(self):
+        if not self._pool or not self._connection:
+            return
+
+        self._pool._put_conn(self._connection)
+        self._connection = None
+
+    def drain_conn(self):
+        """
+        Read and discard any remaining HTTP response data in the response connection.
+
+        Unread data in the HTTPResponse connection blocks the connection from being released back to the pool.
+        """
+        try:
+            self.read()
+        except (HTTPError, SocketError, BaseSSLError, HTTPException):
+            pass
+
+    @property
+    def data(self):
+        # For backwards-compat with earlier urllib3 0.4 and earlier.
+        if self._body:
+            return self._body
+
+        if self._fp:
+            return self.read(cache_content=True)
+
+    @property
+    def connection(self):
+        return self._connection
+
+    def isclosed(self):
+        return is_fp_closed(self._fp)
+
+    def tell(self):
+        """
+        Obtain the number of bytes pulled over the wire so far. May differ from
+        the amount of content returned by :meth:``urllib3.response.HTTPResponse.read``
+        if bytes are encoded on the wire (e.g, compressed).
+        """
+        return self._fp_bytes_read
+
+    def _init_length(self, request_method):
+        """
+        Set initial length value for Response content if available.
+        """
+        length = self.headers.get("content-length")
+
+        if length is not None:
+            if self.chunked:
+                # This Response will fail with an IncompleteRead if it can't be
+                # received as chunked. This method falls back to attempt reading
+                # the response before raising an exception.
+                log.warning(
+                    "Received response with both Content-Length and "
+                    "Transfer-Encoding set. This is expressly forbidden "
+                    "by RFC 7230 sec 3.3.2. Ignoring Content-Length and "
+                    "attempting to process response as Transfer-Encoding: "
+                    "chunked."
+                )
+                return None
+
+            try:
+                # RFC 7230 section 3.3.2 specifies multiple content lengths can
+                # be sent in a single Content-Length header
+                # (e.g. Content-Length: 42, 42). This line ensures the values
+                # are all valid ints and that as long as the `set` length is 1,
+                # all values are the same. Otherwise, the header is invalid.
+                lengths = set([int(val) for val in length.split(",")])
+                if len(lengths) > 1:
+                    raise InvalidHeader(
+                        "Content-Length contained multiple "
+                        "unmatching values (%s)" % length
+                    )
+                length = lengths.pop()
+            except ValueError:
+                length = None
+            else:
+                if length < 0:
+                    length = None
+
+        # Convert status to int for comparison
+        # In some cases, httplib returns a status of "_UNKNOWN"
+        try:
+            status = int(self.status)
+        except ValueError:
+            status = 0
+
+        # Check for responses that shouldn't include a body
+        if status in (204, 304) or 100 <= status < 200 or request_method == "HEAD":
+            length = 0
+
+        return length
+
+    def _init_decoder(self):
+        """
+        Set-up the _decoder attribute if necessary.
+        """
+        # Note: content-encoding value should be case-insensitive, per RFC 7230
+        # Section 3.2
+        content_encoding = self.headers.get("content-encoding", "").lower()
+        if self._decoder is None:
+            if content_encoding in self.CONTENT_DECODERS:
+                self._decoder = _get_decoder(content_encoding)
+            elif "," in content_encoding:
+                encodings = [
+                    e.strip()
+                    for e in content_encoding.split(",")
+                    if e.strip() in self.CONTENT_DECODERS
+                ]
+                if len(encodings):
+                    self._decoder = _get_decoder(content_encoding)
+
+    DECODER_ERROR_CLASSES = (IOError, zlib.error)
+    if brotli is not None:
+        DECODER_ERROR_CLASSES += (brotli.error,)
+
+    def _decode(self, data, decode_content, flush_decoder):
+        """
+        Decode the data passed in and potentially flush the decoder.
+        """
+        if not decode_content:
+            return data
+
+        try:
+            if self._decoder:
+                data = self._decoder.decompress(data)
+        except self.DECODER_ERROR_CLASSES as e:
+            content_encoding = self.headers.get("content-encoding", "").lower()
+            raise DecodeError(
+                "Received response with content-encoding: %s, but "
+                "failed to decode it." % content_encoding,
+                e,
+            )
+        if flush_decoder:
+            data += self._flush_decoder()
+
+        return data
+
+    def _flush_decoder(self):
+        """
+        Flushes the decoder. Should only be called if the decoder is actually
+        being used.
+        """
+        if self._decoder:
+            buf = self._decoder.decompress(b"")
+            return buf + self._decoder.flush()
+
+        return b""
+
+    @contextmanager
+    def _error_catcher(self):
+        """
+        Catch low-level python exceptions, instead re-raising urllib3
+        variants, so that low-level exceptions are not leaked in the
+        high-level api.
+
+        On exit, release the connection back to the pool.
+        """
+        clean_exit = False
+
+        try:
+            try:
+                yield
+
+            except SocketTimeout:
+                # FIXME: Ideally we'd like to include the url in the ReadTimeoutError but
+                # there is yet no clean way to get at it from this context.
+                raise ReadTimeoutError(self._pool, None, "Read timed out.")
+
+            except BaseSSLError as e:
+                # FIXME: Is there a better way to differentiate between SSLErrors?
+                if "read operation timed out" not in str(e):
+                    # SSL errors related to framing/MAC get wrapped and reraised here
+                    raise SSLError(e)
+
+                raise ReadTimeoutError(self._pool, None, "Read timed out.")
+
+            except (HTTPException, SocketError) as e:
+                # This includes IncompleteRead.
+                raise ProtocolError("Connection broken: %r" % e, e)
+
+            # If no exception is thrown, we should avoid cleaning up
+            # unnecessarily.
+            clean_exit = True
+        finally:
+            # If we didn't terminate cleanly, we need to throw away our
+            # connection.
+            if not clean_exit:
+                # The response may not be closed but we're not going to use it
+                # anymore so close it now to ensure that the connection is
+                # released back to the pool.
+                if self._original_response:
+                    self._original_response.close()
+
+                # Closing the response may not actually be sufficient to close
+                # everything, so if we have a hold of the connection close that
+                # too.
+                if self._connection:
+                    self._connection.close()
+
+            # If we hold the original response but it's closed now, we should
+            # return the connection back to the pool.
+            if self._original_response and self._original_response.isclosed():
+                self.release_conn()
+
+    def read(self, amt=None, decode_content=None, cache_content=False):
+        """
+        Similar to :meth:`http.client.HTTPResponse.read`, but with two additional
+        parameters: ``decode_content`` and ``cache_content``.
+
+        :param amt:
+            How much of the content to read. If specified, caching is skipped
+            because it doesn't make sense to cache partial content as the full
+            response.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+
+        :param cache_content:
+            If True, will save the returned data such that the same result is
+            returned despite of the state of the underlying file object. This
+            is useful if you want the ``.data`` property to continue working
+            after having ``.read()`` the file object. (Overridden if ``amt`` is
+            set.)
+        """
+        self._init_decoder()
+        if decode_content is None:
+            decode_content = self.decode_content
+
+        if self._fp is None:
+            return
+
+        flush_decoder = False
+        fp_closed = getattr(self._fp, "closed", False)
+
+        with self._error_catcher():
+            if amt is None:
+                # cStringIO doesn't like amt=None
+                data = self._fp.read() if not fp_closed else b""
+                flush_decoder = True
+            else:
+                cache_content = False
+                data = self._fp.read(amt) if not fp_closed else b""
+                if (
+                    amt != 0 and not data
+                ):  # Platform-specific: Buggy versions of Python.
+                    # Close the connection when no data is returned
+                    #
+                    # This is redundant to what httplib/http.client _should_
+                    # already do.  However, versions of python released before
+                    # December 15, 2012 (http://bugs.python.org/issue16298) do
+                    # not properly close the connection in all cases. There is
+                    # no harm in redundantly calling close.
+                    self._fp.close()
+                    flush_decoder = True
+                    if self.enforce_content_length and self.length_remaining not in (
+                        0,
+                        None,
+                    ):
+                        # This is an edge case that httplib failed to cover due
+                        # to concerns of backward compatibility. We're
+                        # addressing it here to make sure IncompleteRead is
+                        # raised during streaming, so all calls with incorrect
+                        # Content-Length are caught.
+                        raise IncompleteRead(self._fp_bytes_read, self.length_remaining)
+
+        if data:
+            self._fp_bytes_read += len(data)
+            if self.length_remaining is not None:
+                self.length_remaining -= len(data)
+
+            data = self._decode(data, decode_content, flush_decoder)
+
+            if cache_content:
+                self._body = data
+
+        return data
+
+    def stream(self, amt=2 ** 16, decode_content=None):
+        """
+        A generator wrapper for the read() method. A call will block until
+        ``amt`` bytes have been read from the connection or until the
+        connection is closed.
+
+        :param amt:
+            How much of the content to read. The generator will return up to
+            much data per iteration, but may return less. This is particularly
+            likely when using compressed data. However, the empty string will
+            never be returned.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+        """
+        if self.chunked and self.supports_chunked_reads():
+            for line in self.read_chunked(amt, decode_content=decode_content):
+                yield line
+        else:
+            while not is_fp_closed(self._fp):
+                data = self.read(amt=amt, decode_content=decode_content)
+
+                if data:
+                    yield data
+
+    @classmethod
+    def from_httplib(ResponseCls, r, **response_kw):
+        """
+        Given an :class:`http.client.HTTPResponse` instance ``r``, return a
+        corresponding :class:`urllib3.response.HTTPResponse` object.
+
+        Remaining parameters are passed to the HTTPResponse constructor, along
+        with ``original_response=r``.
+        """
+        headers = r.msg
+
+        if not isinstance(headers, HTTPHeaderDict):
+            if six.PY2:
+                # Python 2.7
+                headers = HTTPHeaderDict.from_httplib(headers)
+            else:
+                headers = HTTPHeaderDict(headers.items())
+
+        # HTTPResponse objects in Python 3 don't have a .strict attribute
+        strict = getattr(r, "strict", 0)
+        resp = ResponseCls(
+            body=r,
+            headers=headers,
+            status=r.status,
+            version=r.version,
+            reason=r.reason,
+            strict=strict,
+            original_response=r,
+            **response_kw
+        )
+        return resp
+
+    # Backwards-compatibility methods for http.client.HTTPResponse
+    def getheaders(self):
+        return self.headers
+
+    def getheader(self, name, default=None):
+        return self.headers.get(name, default)
+
+    # Backwards compatibility for http.cookiejar
+    def info(self):
+        return self.headers
+
+    # Overrides from io.IOBase
+    def close(self):
+        if not self.closed:
+            self._fp.close()
+
+        if self._connection:
+            self._connection.close()
+
+        if not self.auto_close:
+            io.IOBase.close(self)
+
+    @property
+    def closed(self):
+        if not self.auto_close:
+            return io.IOBase.closed.__get__(self)
+        elif self._fp is None:
+            return True
+        elif hasattr(self._fp, "isclosed"):
+            return self._fp.isclosed()
+        elif hasattr(self._fp, "closed"):
+            return self._fp.closed
+        else:
+            return True
+
+    def fileno(self):
+        if self._fp is None:
+            raise IOError("HTTPResponse has no file to get a fileno from")
+        elif hasattr(self._fp, "fileno"):
+            return self._fp.fileno()
+        else:
+            raise IOError(
+                "The file-like object this HTTPResponse is wrapped "
+                "around has no file descriptor"
+            )
+
+    def flush(self):
+        if (
+            self._fp is not None
+            and hasattr(self._fp, "flush")
+            and not getattr(self._fp, "closed", False)
+        ):
+            return self._fp.flush()
+
+    def readable(self):
+        # This method is required for `io` module compatibility.
+        return True
+
+    def readinto(self, b):
+        # This method is required for `io` module compatibility.
+        temp = self.read(len(b))
+        if len(temp) == 0:
+            return 0
+        else:
+            b[: len(temp)] = temp
+            return len(temp)
+
+    def supports_chunked_reads(self):
+        """
+        Checks if the underlying file-like object looks like a
+        :class:`http.client.HTTPResponse` object. We do this by testing for
+        the fp attribute. If it is present we assume it returns raw chunks as
+        processed by read_chunked().
+        """
+        return hasattr(self._fp, "fp")
+
+    def _update_chunk_length(self):
+        # First, we'll figure out length of a chunk and then
+        # we'll try to read it from socket.
+        if self.chunk_left is not None:
+            return
+        line = self._fp.fp.readline()
+        line = line.split(b";", 1)[0]
+        try:
+            self.chunk_left = int(line, 16)
+        except ValueError:
+            # Invalid chunked protocol response, abort.
+            self.close()
+            raise InvalidChunkLength(self, line)
+
+    def _handle_chunk(self, amt):
+        returned_chunk = None
+        if amt is None:
+            chunk = self._fp._safe_read(self.chunk_left)
+            returned_chunk = chunk
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self.chunk_left = None
+        elif amt < self.chunk_left:
+            value = self._fp._safe_read(amt)
+            self.chunk_left = self.chunk_left - amt
+            returned_chunk = value
+        elif amt == self.chunk_left:
+            value = self._fp._safe_read(amt)
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self.chunk_left = None
+            returned_chunk = value
+        else:  # amt > self.chunk_left
+            returned_chunk = self._fp._safe_read(self.chunk_left)
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self.chunk_left = None
+        return returned_chunk
+
+    def read_chunked(self, amt=None, decode_content=None):
+        """
+        Similar to :meth:`HTTPResponse.read`, but with an additional
+        parameter: ``decode_content``.
+
+        :param amt:
+            How much of the content to read. If specified, caching is skipped
+            because it doesn't make sense to cache partial content as the full
+            response.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+        """
+        self._init_decoder()
+        # FIXME: Rewrite this method and make it a class with a better structured logic.
+        if not self.chunked:
+            raise ResponseNotChunked(
+                "Response is not chunked. "
+                "Header 'transfer-encoding: chunked' is missing."
+            )
+        if not self.supports_chunked_reads():
+            raise BodyNotHttplibCompatible(
+                "Body should be http.client.HTTPResponse like. "
+                "It should have have an fp attribute which returns raw chunks."
+            )
+
+        with self._error_catcher():
+            # Don't bother reading the body of a HEAD request.
+            if self._original_response and is_response_to_head(self._original_response):
+                self._original_response.close()
+                return
+
+            # If a response is already read and closed
+            # then return immediately.
+            if self._fp.fp is None:
+                return
+
+            while True:
+                self._update_chunk_length()
+                if self.chunk_left == 0:
+                    break
+                chunk = self._handle_chunk(amt)
+                decoded = self._decode(
+                    chunk, decode_content=decode_content, flush_decoder=False
+                )
+                if decoded:
+                    yield decoded
+
+            if decode_content:
+                # On CPython and PyPy, we should never need to flush the
+                # decoder. However, on Jython we *might* need to, so
+                # lets defensively do it anyway.
+                decoded = self._flush_decoder()
+                if decoded:  # Platform-specific: Jython.
+                    yield decoded
+
+            # Chunk content ends with \r\n: discard it.
+            while True:
+                line = self._fp.fp.readline()
+                if not line:
+                    # Some sites may not end with '\r\n'.
+                    break
+                if line == b"\r\n":
+                    break
+
+            # We read everything; close the "file".
+            if self._original_response:
+                self._original_response.close()
+
+    def geturl(self):
+        """
+        Returns the URL that was the source of this response.
+        If the request that generated this response redirected, this method
+        will return the final redirect location.
+        """
+        if self.retries is not None and len(self.retries.history):
+            return self.retries.history[-1].redirect_location
+        else:
+            return self._request_url
+
+    def __iter__(self):
+        buffer = []
+        for chunk in self.stream(decode_content=True):
+            if b"\n" in chunk:
+                chunk = chunk.split(b"\n")
+                yield b"".join(buffer) + chunk[0] + b"\n"
+                for x in chunk[1:-1]:
+                    yield x + b"\n"
+                if chunk[-1]:
+                    buffer = [chunk[-1]]
+                else:
+                    buffer = []
+            else:
+                buffer.append(chunk)
+        if buffer:
+            yield b"".join(buffer)
diff --git a/openpype/vendor/python/python_2/urllib3/util/__init__.py b/openpype/vendor/python/python_2/urllib3/util/__init__.py
new file mode 100644
index 0000000000..4547fc522b
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/__init__.py
@@ -0,0 +1,49 @@
+from __future__ import absolute_import
+
+# For backwards compatibility, provide imports that used to be here.
+from .connection import is_connection_dropped
+from .request import SKIP_HEADER, SKIPPABLE_HEADERS, make_headers
+from .response import is_fp_closed
+from .retry import Retry
+from .ssl_ import (
+    ALPN_PROTOCOLS,
+    HAS_SNI,
+    IS_PYOPENSSL,
+    IS_SECURETRANSPORT,
+    PROTOCOL_TLS,
+    SSLContext,
+    assert_fingerprint,
+    resolve_cert_reqs,
+    resolve_ssl_version,
+    ssl_wrap_socket,
+)
+from .timeout import Timeout, current_time
+from .url import Url, get_host, parse_url, split_first
+from .wait import wait_for_read, wait_for_write
+
+__all__ = (
+    "HAS_SNI",
+    "IS_PYOPENSSL",
+    "IS_SECURETRANSPORT",
+    "SSLContext",
+    "PROTOCOL_TLS",
+    "ALPN_PROTOCOLS",
+    "Retry",
+    "Timeout",
+    "Url",
+    "assert_fingerprint",
+    "current_time",
+    "is_connection_dropped",
+    "is_fp_closed",
+    "get_host",
+    "parse_url",
+    "make_headers",
+    "resolve_cert_reqs",
+    "resolve_ssl_version",
+    "split_first",
+    "ssl_wrap_socket",
+    "wait_for_read",
+    "wait_for_write",
+    "SKIP_HEADER",
+    "SKIPPABLE_HEADERS",
+)
diff --git a/openpype/vendor/python/python_2/urllib3/util/connection.py b/openpype/vendor/python/python_2/urllib3/util/connection.py
new file mode 100644
index 0000000000..6af1138f26
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/connection.py
@@ -0,0 +1,149 @@
+from __future__ import absolute_import
+
+import socket
+
+from ..contrib import _appengine_environ
+from ..exceptions import LocationParseError
+from ..packages import six
+from .wait import NoWayToWaitForSocketError, wait_for_read
+
+
+def is_connection_dropped(conn):  # Platform-specific
+    """
+    Returns True if the connection is dropped and should be closed.
+
+    :param conn:
+        :class:`http.client.HTTPConnection` object.
+
+    Note: For platforms like AppEngine, this will always return ``False`` to
+    let the platform handle connection recycling transparently for us.
+    """
+    sock = getattr(conn, "sock", False)
+    if sock is False:  # Platform-specific: AppEngine
+        return False
+    if sock is None:  # Connection already closed (such as by httplib).
+        return True
+    try:
+        # Returns True if readable, which here means it's been dropped
+        return wait_for_read(sock, timeout=0.0)
+    except NoWayToWaitForSocketError:  # Platform-specific: AppEngine
+        return False
+
+
+# This function is copied from socket.py in the Python 2.7 standard
+# library test suite. Added to its signature is only `socket_options`.
+# One additional modification is that we avoid binding to IPv6 servers
+# discovered in DNS if the system doesn't have IPv6 functionality.
+def create_connection(
+    address,
+    timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
+    source_address=None,
+    socket_options=None,
+):
+    """Connect to *address* and return the socket object.
+
+    Convenience function.  Connect to *address* (a 2-tuple ``(host,
+    port)``) and return the socket object.  Passing the optional
+    *timeout* parameter will set the timeout on the socket instance
+    before attempting to connect.  If no *timeout* is supplied, the
+    global default timeout setting returned by :func:`socket.getdefaulttimeout`
+    is used.  If *source_address* is set it must be a tuple of (host, port)
+    for the socket to bind as a source address before making the connection.
+    An host of '' or port 0 tells the OS to use the default.
+    """
+
+    host, port = address
+    if host.startswith("["):
+        host = host.strip("[]")
+    err = None
+
+    # Using the value from allowed_gai_family() in the context of getaddrinfo lets
+    # us select whether to work with IPv4 DNS records, IPv6 records, or both.
+    # The original create_connection function always returns all records.
+    family = allowed_gai_family()
+
+    try:
+        host.encode("idna")
+    except UnicodeError:
+        return six.raise_from(
+            LocationParseError(u"'%s', label empty or too long" % host), None
+        )
+
+    for res in socket.getaddrinfo(host, port, family, socket.SOCK_STREAM):
+        af, socktype, proto, canonname, sa = res
+        sock = None
+        try:
+            sock = socket.socket(af, socktype, proto)
+
+            # If provided, set socket level options before connecting.
+            _set_socket_options(sock, socket_options)
+
+            if timeout is not socket._GLOBAL_DEFAULT_TIMEOUT:
+                sock.settimeout(timeout)
+            if source_address:
+                sock.bind(source_address)
+            sock.connect(sa)
+            return sock
+
+        except socket.error as e:
+            err = e
+            if sock is not None:
+                sock.close()
+                sock = None
+
+    if err is not None:
+        raise err
+
+    raise socket.error("getaddrinfo returns an empty list")
+
+
+def _set_socket_options(sock, options):
+    if options is None:
+        return
+
+    for opt in options:
+        sock.setsockopt(*opt)
+
+
+def allowed_gai_family():
+    """This function is designed to work in the context of
+    getaddrinfo, where family=socket.AF_UNSPEC is the default and
+    will perform a DNS search for both IPv6 and IPv4 records."""
+
+    family = socket.AF_INET
+    if HAS_IPV6:
+        family = socket.AF_UNSPEC
+    return family
+
+
+def _has_ipv6(host):
+    """Returns True if the system can bind an IPv6 address."""
+    sock = None
+    has_ipv6 = False
+
+    # App Engine doesn't support IPV6 sockets and actually has a quota on the
+    # number of sockets that can be used, so just early out here instead of
+    # creating a socket needlessly.
+    # See https://github.com/urllib3/urllib3/issues/1446
+    if _appengine_environ.is_appengine_sandbox():
+        return False
+
+    if socket.has_ipv6:
+        # has_ipv6 returns true if cPython was compiled with IPv6 support.
+        # It does not tell us if the system has IPv6 support enabled. To
+        # determine that we must bind to an IPv6 address.
+        # https://github.com/urllib3/urllib3/pull/611
+        # https://bugs.python.org/issue658327
+        try:
+            sock = socket.socket(socket.AF_INET6)
+            sock.bind((host, 0))
+            has_ipv6 = True
+        except Exception:
+            pass
+
+    if sock:
+        sock.close()
+    return has_ipv6
+
+
+HAS_IPV6 = _has_ipv6("::1")
diff --git a/openpype/vendor/python/python_2/urllib3/util/proxy.py b/openpype/vendor/python/python_2/urllib3/util/proxy.py
new file mode 100644
index 0000000000..2199cc7b7f
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/proxy.py
@@ -0,0 +1,57 @@
+from .ssl_ import create_urllib3_context, resolve_cert_reqs, resolve_ssl_version
+
+
+def connection_requires_http_tunnel(
+    proxy_url=None, proxy_config=None, destination_scheme=None
+):
+    """
+    Returns True if the connection requires an HTTP CONNECT through the proxy.
+
+    :param URL proxy_url:
+        URL of the proxy.
+    :param ProxyConfig proxy_config:
+        Proxy configuration from poolmanager.py
+    :param str destination_scheme:
+        The scheme of the destination. (i.e https, http, etc)
+    """
+    # If we're not using a proxy, no way to use a tunnel.
+    if proxy_url is None:
+        return False
+
+    # HTTP destinations never require tunneling, we always forward.
+    if destination_scheme == "http":
+        return False
+
+    # Support for forwarding with HTTPS proxies and HTTPS destinations.
+    if (
+        proxy_url.scheme == "https"
+        and proxy_config
+        and proxy_config.use_forwarding_for_https
+    ):
+        return False
+
+    # Otherwise always use a tunnel.
+    return True
+
+
+def create_proxy_ssl_context(
+    ssl_version, cert_reqs, ca_certs=None, ca_cert_dir=None, ca_cert_data=None
+):
+    """
+    Generates a default proxy ssl context if one hasn't been provided by the
+    user.
+    """
+    ssl_context = create_urllib3_context(
+        ssl_version=resolve_ssl_version(ssl_version),
+        cert_reqs=resolve_cert_reqs(cert_reqs),
+    )
+
+    if (
+        not ca_certs
+        and not ca_cert_dir
+        and not ca_cert_data
+        and hasattr(ssl_context, "load_default_certs")
+    ):
+        ssl_context.load_default_certs()
+
+    return ssl_context
diff --git a/openpype/vendor/python/python_2/urllib3/util/queue.py b/openpype/vendor/python/python_2/urllib3/util/queue.py
new file mode 100644
index 0000000000..41784104ee
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/queue.py
@@ -0,0 +1,22 @@
+import collections
+
+from ..packages import six
+from ..packages.six.moves import queue
+
+if six.PY2:
+    # Queue is imported for side effects on MS Windows. See issue #229.
+    import Queue as _unused_module_Queue  # noqa: F401
+
+
+class LifoQueue(queue.Queue):
+    def _init(self, _):
+        self.queue = collections.deque()
+
+    def _qsize(self, len=len):
+        return len(self.queue)
+
+    def _put(self, item):
+        self.queue.append(item)
+
+    def _get(self):
+        return self.queue.pop()
diff --git a/openpype/vendor/python/python_2/urllib3/util/request.py b/openpype/vendor/python/python_2/urllib3/util/request.py
new file mode 100644
index 0000000000..b574b081e9
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/request.py
@@ -0,0 +1,146 @@
+from __future__ import absolute_import
+
+from base64 import b64encode
+
+from ..exceptions import UnrewindableBodyError
+from ..packages.six import b, integer_types
+
+# Pass as a value within ``headers`` to skip
+# emitting some HTTP headers that are added automatically.
+# The only headers that are supported are ``Accept-Encoding``,
+# ``Host``, and ``User-Agent``.
+SKIP_HEADER = "@@@SKIP_HEADER@@@"
+SKIPPABLE_HEADERS = frozenset(["accept-encoding", "host", "user-agent"])
+
+ACCEPT_ENCODING = "gzip,deflate"
+try:
+    try:
+        import brotlicffi as _unused_module_brotli  # noqa: F401
+    except ImportError:
+        import brotli as _unused_module_brotli  # noqa: F401
+except ImportError:
+    pass
+else:
+    ACCEPT_ENCODING += ",br"
+
+_FAILEDTELL = object()
+
+
+def make_headers(
+    keep_alive=None,
+    accept_encoding=None,
+    user_agent=None,
+    basic_auth=None,
+    proxy_basic_auth=None,
+    disable_cache=None,
+):
+    """
+    Shortcuts for generating request headers.
+
+    :param keep_alive:
+        If ``True``, adds 'connection: keep-alive' header.
+
+    :param accept_encoding:
+        Can be a boolean, list, or string.
+        ``True`` translates to 'gzip,deflate'.
+        List will get joined by comma.
+        String will be used as provided.
+
+    :param user_agent:
+        String representing the user-agent you want, such as
+        "python-urllib3/0.6"
+
+    :param basic_auth:
+        Colon-separated username:password string for 'authorization: basic ...'
+        auth header.
+
+    :param proxy_basic_auth:
+        Colon-separated username:password string for 'proxy-authorization: basic ...'
+        auth header.
+
+    :param disable_cache:
+        If ``True``, adds 'cache-control: no-cache' header.
+
+    Example::
+
+        >>> make_headers(keep_alive=True, user_agent="Batman/1.0")
+        {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
+        >>> make_headers(accept_encoding=True)
+        {'accept-encoding': 'gzip,deflate'}
+    """
+    headers = {}
+    if accept_encoding:
+        if isinstance(accept_encoding, str):
+            pass
+        elif isinstance(accept_encoding, list):
+            accept_encoding = ",".join(accept_encoding)
+        else:
+            accept_encoding = ACCEPT_ENCODING
+        headers["accept-encoding"] = accept_encoding
+
+    if user_agent:
+        headers["user-agent"] = user_agent
+
+    if keep_alive:
+        headers["connection"] = "keep-alive"
+
+    if basic_auth:
+        headers["authorization"] = "Basic " + b64encode(b(basic_auth)).decode("utf-8")
+
+    if proxy_basic_auth:
+        headers["proxy-authorization"] = "Basic " + b64encode(
+            b(proxy_basic_auth)
+        ).decode("utf-8")
+
+    if disable_cache:
+        headers["cache-control"] = "no-cache"
+
+    return headers
+
+
+def set_file_position(body, pos):
+    """
+    If a position is provided, move file to that point.
+    Otherwise, we'll attempt to record a position for future use.
+    """
+    if pos is not None:
+        rewind_body(body, pos)
+    elif getattr(body, "tell", None) is not None:
+        try:
+            pos = body.tell()
+        except (IOError, OSError):
+            # This differentiates from None, allowing us to catch
+            # a failed `tell()` later when trying to rewind the body.
+            pos = _FAILEDTELL
+
+    return pos
+
+
+def rewind_body(body, body_pos):
+    """
+    Attempt to rewind body to a certain position.
+    Primarily used for request redirects and retries.
+
+    :param body:
+        File-like object that supports seek.
+
+    :param int pos:
+        Position to seek to in file.
+    """
+    body_seek = getattr(body, "seek", None)
+    if body_seek is not None and isinstance(body_pos, integer_types):
+        try:
+            body_seek(body_pos)
+        except (IOError, OSError):
+            raise UnrewindableBodyError(
+                "An error occurred when rewinding request body for redirect/retry."
+            )
+    elif body_pos is _FAILEDTELL:
+        raise UnrewindableBodyError(
+            "Unable to record file position for rewinding "
+            "request body during a redirect/retry."
+        )
+    else:
+        raise ValueError(
+            "body_pos must be of type integer, instead it was %s." % type(body_pos)
+        )
diff --git a/openpype/vendor/python/python_2/urllib3/util/response.py b/openpype/vendor/python/python_2/urllib3/util/response.py
new file mode 100644
index 0000000000..5ea609cced
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/response.py
@@ -0,0 +1,107 @@
+from __future__ import absolute_import
+
+from email.errors import MultipartInvariantViolationDefect, StartBoundaryNotFoundDefect
+
+from ..exceptions import HeaderParsingError
+from ..packages.six.moves import http_client as httplib
+
+
+def is_fp_closed(obj):
+    """
+    Checks whether a given file-like object is closed.
+
+    :param obj:
+        The file-like object to check.
+    """
+
+    try:
+        # Check `isclosed()` first, in case Python3 doesn't set `closed`.
+        # GH Issue #928
+        return obj.isclosed()
+    except AttributeError:
+        pass
+
+    try:
+        # Check via the official file-like-object way.
+        return obj.closed
+    except AttributeError:
+        pass
+
+    try:
+        # Check if the object is a container for another file-like object that
+        # gets released on exhaustion (e.g. HTTPResponse).
+        return obj.fp is None
+    except AttributeError:
+        pass
+
+    raise ValueError("Unable to determine whether fp is closed.")
+
+
+def assert_header_parsing(headers):
+    """
+    Asserts whether all headers have been successfully parsed.
+    Extracts encountered errors from the result of parsing headers.
+
+    Only works on Python 3.
+
+    :param http.client.HTTPMessage headers: Headers to verify.
+
+    :raises urllib3.exceptions.HeaderParsingError:
+        If parsing errors are found.
+    """
+
+    # This will fail silently if we pass in the wrong kind of parameter.
+    # To make debugging easier add an explicit check.
+    if not isinstance(headers, httplib.HTTPMessage):
+        raise TypeError("expected httplib.Message, got {0}.".format(type(headers)))
+
+    defects = getattr(headers, "defects", None)
+    get_payload = getattr(headers, "get_payload", None)
+
+    unparsed_data = None
+    if get_payload:
+        # get_payload is actually email.message.Message.get_payload;
+        # we're only interested in the result if it's not a multipart message
+        if not headers.is_multipart():
+            payload = get_payload()
+
+            if isinstance(payload, (bytes, str)):
+                unparsed_data = payload
+    if defects:
+        # httplib is assuming a response body is available
+        # when parsing headers even when httplib only sends
+        # header data to parse_headers() This results in
+        # defects on multipart responses in particular.
+        # See: https://github.com/urllib3/urllib3/issues/800
+
+        # So we ignore the following defects:
+        # - StartBoundaryNotFoundDefect:
+        #     The claimed start boundary was never found.
+        # - MultipartInvariantViolationDefect:
+        #     A message claimed to be a multipart but no subparts were found.
+        defects = [
+            defect
+            for defect in defects
+            if not isinstance(
+                defect, (StartBoundaryNotFoundDefect, MultipartInvariantViolationDefect)
+            )
+        ]
+
+    if defects or unparsed_data:
+        raise HeaderParsingError(defects=defects, unparsed_data=unparsed_data)
+
+
+def is_response_to_head(response):
+    """
+    Checks whether the request of a response has been a HEAD-request.
+    Handles the quirks of AppEngine.
+
+    :param http.client.HTTPResponse response:
+        Response to check if the originating request
+        used 'HEAD' as a method.
+    """
+    # FIXME: Can we do this somehow without accessing private httplib _method?
+    method = response._method
+    if isinstance(method, int):  # Platform-specific: Appengine
+        return method == 3
+    return method.upper() == "HEAD"
diff --git a/openpype/vendor/python/python_2/urllib3/util/retry.py b/openpype/vendor/python/python_2/urllib3/util/retry.py
new file mode 100644
index 0000000000..3398323fd7
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/retry.py
@@ -0,0 +1,620 @@
+from __future__ import absolute_import
+
+import email
+import logging
+import re
+import time
+import warnings
+from collections import namedtuple
+from itertools import takewhile
+
+from ..exceptions import (
+    ConnectTimeoutError,
+    InvalidHeader,
+    MaxRetryError,
+    ProtocolError,
+    ProxyError,
+    ReadTimeoutError,
+    ResponseError,
+)
+from ..packages import six
+
+log = logging.getLogger(__name__)
+
+
+# Data structure for representing the metadata of requests that result in a retry.
+RequestHistory = namedtuple(
+    "RequestHistory", ["method", "url", "error", "status", "redirect_location"]
+)
+
+
+# TODO: In v2 we can remove this sentinel and metaclass with deprecated options.
+_Default = object()
+
+
+class _RetryMeta(type):
+    @property
+    def DEFAULT_METHOD_WHITELIST(cls):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead",
+            DeprecationWarning,
+        )
+        return cls.DEFAULT_ALLOWED_METHODS
+
+    @DEFAULT_METHOD_WHITELIST.setter
+    def DEFAULT_METHOD_WHITELIST(cls, value):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead",
+            DeprecationWarning,
+        )
+        cls.DEFAULT_ALLOWED_METHODS = value
+
+    @property
+    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
+            DeprecationWarning,
+        )
+        return cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT
+
+    @DEFAULT_REDIRECT_HEADERS_BLACKLIST.setter
+    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls, value):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
+            DeprecationWarning,
+        )
+        cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT = value
+
+    @property
+    def BACKOFF_MAX(cls):
+        warnings.warn(
+            "Using 'Retry.BACKOFF_MAX' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead",
+            DeprecationWarning,
+        )
+        return cls.DEFAULT_BACKOFF_MAX
+
+    @BACKOFF_MAX.setter
+    def BACKOFF_MAX(cls, value):
+        warnings.warn(
+            "Using 'Retry.BACKOFF_MAX' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead",
+            DeprecationWarning,
+        )
+        cls.DEFAULT_BACKOFF_MAX = value
+
+
+@six.add_metaclass(_RetryMeta)
+class Retry(object):
+    """Retry configuration.
+
+    Each retry attempt will create a new Retry object with updated values, so
+    they can be safely reused.
+
+    Retries can be defined as a default for a pool::
+
+        retries = Retry(connect=5, read=2, redirect=5)
+        http = PoolManager(retries=retries)
+        response = http.request('GET', 'http://example.com/')
+
+    Or per-request (which overrides the default for the pool)::
+
+        response = http.request('GET', 'http://example.com/', retries=Retry(10))
+
+    Retries can be disabled by passing ``False``::
+
+        response = http.request('GET', 'http://example.com/', retries=False)
+
+    Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless
+    retries are disabled, in which case the causing exception will be raised.
+
+    :param int total:
+        Total number of retries to allow. Takes precedence over other counts.
+
+        Set to ``None`` to remove this constraint and fall back on other
+        counts.
+
+        Set to ``0`` to fail on the first retry.
+
+        Set to ``False`` to disable and imply ``raise_on_redirect=False``.
+
+    :param int connect:
+        How many connection-related errors to retry on.
+
+        These are errors raised before the request is sent to the remote server,
+        which we assume has not triggered the server to process the request.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param int read:
+        How many times to retry on read errors.
+
+        These errors are raised after the request was sent to the server, so the
+        request may have side-effects.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param int redirect:
+        How many redirects to perform. Limit this to avoid infinite redirect
+        loops.
+
+        A redirect is a HTTP response with a status code 301, 302, 303, 307 or
+        308.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+        Set to ``False`` to disable and imply ``raise_on_redirect=False``.
+
+    :param int status:
+        How many times to retry on bad status codes.
+
+        These are retries made on responses, where status code matches
+        ``status_forcelist``.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param int other:
+        How many times to retry on other errors.
+
+        Other errors are errors that are not connect, read, redirect or status errors.
+        These errors might be raised after the request was sent to the server, so the
+        request might have side-effects.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+        If ``total`` is not set, it's a good idea to set this to 0 to account
+        for unexpected edge cases and avoid infinite retry loops.
+
+    :param iterable allowed_methods:
+        Set of uppercased HTTP method verbs that we should retry on.
+
+        By default, we only retry on methods which are considered to be
+        idempotent (multiple requests with the same parameters end with the
+        same state). See :attr:`Retry.DEFAULT_ALLOWED_METHODS`.
+
+        Set to a ``False`` value to retry on any verb.
+
+        .. warning::
+
+            Previously this parameter was named ``method_whitelist``, that
+            usage is deprecated in v1.26.0 and will be removed in v2.0.
+
+    :param iterable status_forcelist:
+        A set of integer HTTP status codes that we should force a retry on.
+        A retry is initiated if the request method is in ``allowed_methods``
+        and the response status code is in ``status_forcelist``.
+
+        By default, this is disabled with ``None``.
+
+    :param float backoff_factor:
+        A backoff factor to apply between attempts after the second try
+        (most errors are resolved immediately by a second try without a
+        delay). urllib3 will sleep for::
+
+            {backoff factor} * (2 ** ({number of total retries} - 1))
+
+        seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep
+        for [0.0s, 0.2s, 0.4s, ...] between retries. It will never be longer
+        than :attr:`Retry.DEFAULT_BACKOFF_MAX`.
+
+        By default, backoff is disabled (set to 0).
+
+    :param bool raise_on_redirect: Whether, if the number of redirects is
+        exhausted, to raise a MaxRetryError, or to return a response with a
+        response code in the 3xx range.
+
+    :param bool raise_on_status: Similar meaning to ``raise_on_redirect``:
+        whether we should raise an exception, or return a response,
+        if status falls in ``status_forcelist`` range and retries have
+        been exhausted.
+
+    :param tuple history: The history of the request encountered during
+        each call to :meth:`~Retry.increment`. The list is in the order
+        the requests occurred. Each list item is of class :class:`RequestHistory`.
+
+    :param bool respect_retry_after_header:
+        Whether to respect Retry-After header on status codes defined as
+        :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not.
+
+    :param iterable remove_headers_on_redirect:
+        Sequence of headers to remove from the request when a response
+        indicating a redirect is returned before firing off the redirected
+        request.
+    """
+
+    #: Default methods to be used for ``allowed_methods``
+    DEFAULT_ALLOWED_METHODS = frozenset(
+        ["HEAD", "GET", "PUT", "DELETE", "OPTIONS", "TRACE"]
+    )
+
+    #: Default status codes to be used for ``status_forcelist``
+    RETRY_AFTER_STATUS_CODES = frozenset([413, 429, 503])
+
+    #: Default headers to be used for ``remove_headers_on_redirect``
+    DEFAULT_REMOVE_HEADERS_ON_REDIRECT = frozenset(["Authorization"])
+
+    #: Maximum backoff time.
+    DEFAULT_BACKOFF_MAX = 120
+
+    def __init__(
+        self,
+        total=10,
+        connect=None,
+        read=None,
+        redirect=None,
+        status=None,
+        other=None,
+        allowed_methods=_Default,
+        status_forcelist=None,
+        backoff_factor=0,
+        raise_on_redirect=True,
+        raise_on_status=True,
+        history=None,
+        respect_retry_after_header=True,
+        remove_headers_on_redirect=_Default,
+        # TODO: Deprecated, remove in v2.0
+        method_whitelist=_Default,
+    ):
+
+        if method_whitelist is not _Default:
+            if allowed_methods is not _Default:
+                raise ValueError(
+                    "Using both 'allowed_methods' and "
+                    "'method_whitelist' together is not allowed. "
+                    "Instead only use 'allowed_methods'"
+                )
+            warnings.warn(
+                "Using 'method_whitelist' with Retry is deprecated and "
+                "will be removed in v2.0. Use 'allowed_methods' instead",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            allowed_methods = method_whitelist
+        if allowed_methods is _Default:
+            allowed_methods = self.DEFAULT_ALLOWED_METHODS
+        if remove_headers_on_redirect is _Default:
+            remove_headers_on_redirect = self.DEFAULT_REMOVE_HEADERS_ON_REDIRECT
+
+        self.total = total
+        self.connect = connect
+        self.read = read
+        self.status = status
+        self.other = other
+
+        if redirect is False or total is False:
+            redirect = 0
+            raise_on_redirect = False
+
+        self.redirect = redirect
+        self.status_forcelist = status_forcelist or set()
+        self.allowed_methods = allowed_methods
+        self.backoff_factor = backoff_factor
+        self.raise_on_redirect = raise_on_redirect
+        self.raise_on_status = raise_on_status
+        self.history = history or tuple()
+        self.respect_retry_after_header = respect_retry_after_header
+        self.remove_headers_on_redirect = frozenset(
+            [h.lower() for h in remove_headers_on_redirect]
+        )
+
+    def new(self, **kw):
+        params = dict(
+            total=self.total,
+            connect=self.connect,
+            read=self.read,
+            redirect=self.redirect,
+            status=self.status,
+            other=self.other,
+            status_forcelist=self.status_forcelist,
+            backoff_factor=self.backoff_factor,
+            raise_on_redirect=self.raise_on_redirect,
+            raise_on_status=self.raise_on_status,
+            history=self.history,
+            remove_headers_on_redirect=self.remove_headers_on_redirect,
+            respect_retry_after_header=self.respect_retry_after_header,
+        )
+
+        # TODO: If already given in **kw we use what's given to us
+        # If not given we need to figure out what to pass. We decide
+        # based on whether our class has the 'method_whitelist' property
+        # and if so we pass the deprecated 'method_whitelist' otherwise
+        # we use 'allowed_methods'. Remove in v2.0
+        if "method_whitelist" not in kw and "allowed_methods" not in kw:
+            if "method_whitelist" in self.__dict__:
+                warnings.warn(
+                    "Using 'method_whitelist' with Retry is deprecated and "
+                    "will be removed in v2.0. Use 'allowed_methods' instead",
+                    DeprecationWarning,
+                )
+                params["method_whitelist"] = self.allowed_methods
+            else:
+                params["allowed_methods"] = self.allowed_methods
+
+        params.update(kw)
+        return type(self)(**params)
+
+    @classmethod
+    def from_int(cls, retries, redirect=True, default=None):
+        """Backwards-compatibility for the old retries format."""
+        if retries is None:
+            retries = default if default is not None else cls.DEFAULT
+
+        if isinstance(retries, Retry):
+            return retries
+
+        redirect = bool(redirect) and None
+        new_retries = cls(retries, redirect=redirect)
+        log.debug("Converted retries value: %r -> %r", retries, new_retries)
+        return new_retries
+
+    def get_backoff_time(self):
+        """Formula for computing the current backoff
+
+        :rtype: float
+        """
+        # We want to consider only the last consecutive errors sequence (Ignore redirects).
+        consecutive_errors_len = len(
+            list(
+                takewhile(lambda x: x.redirect_location is None, reversed(self.history))
+            )
+        )
+        if consecutive_errors_len <= 1:
+            return 0
+
+        backoff_value = self.backoff_factor * (2 ** (consecutive_errors_len - 1))
+        return min(self.DEFAULT_BACKOFF_MAX, backoff_value)
+
+    def parse_retry_after(self, retry_after):
+        # Whitespace: https://tools.ietf.org/html/rfc7230#section-3.2.4
+        if re.match(r"^\s*[0-9]+\s*$", retry_after):
+            seconds = int(retry_after)
+        else:
+            retry_date_tuple = email.utils.parsedate_tz(retry_after)
+            if retry_date_tuple is None:
+                raise InvalidHeader("Invalid Retry-After header: %s" % retry_after)
+            if retry_date_tuple[9] is None:  # Python 2
+                # Assume UTC if no timezone was specified
+                # On Python2.7, parsedate_tz returns None for a timezone offset
+                # instead of 0 if no timezone is given, where mktime_tz treats
+                # a None timezone offset as local time.
+                retry_date_tuple = retry_date_tuple[:9] + (0,) + retry_date_tuple[10:]
+
+            retry_date = email.utils.mktime_tz(retry_date_tuple)
+            seconds = retry_date - time.time()
+
+        if seconds < 0:
+            seconds = 0
+
+        return seconds
+
+    def get_retry_after(self, response):
+        """Get the value of Retry-After in seconds."""
+
+        retry_after = response.getheader("Retry-After")
+
+        if retry_after is None:
+            return None
+
+        return self.parse_retry_after(retry_after)
+
+    def sleep_for_retry(self, response=None):
+        retry_after = self.get_retry_after(response)
+        if retry_after:
+            time.sleep(retry_after)
+            return True
+
+        return False
+
+    def _sleep_backoff(self):
+        backoff = self.get_backoff_time()
+        if backoff <= 0:
+            return
+        time.sleep(backoff)
+
+    def sleep(self, response=None):
+        """Sleep between retry attempts.
+
+        This method will respect a server's ``Retry-After`` response header
+        and sleep the duration of the time requested. If that is not present, it
+        will use an exponential backoff. By default, the backoff factor is 0 and
+        this method will return immediately.
+        """
+
+        if self.respect_retry_after_header and response:
+            slept = self.sleep_for_retry(response)
+            if slept:
+                return
+
+        self._sleep_backoff()
+
+    def _is_connection_error(self, err):
+        """Errors when we're fairly sure that the server did not receive the
+        request, so it should be safe to retry.
+        """
+        if isinstance(err, ProxyError):
+            err = err.original_error
+        return isinstance(err, ConnectTimeoutError)
+
+    def _is_read_error(self, err):
+        """Errors that occur after the request has been started, so we should
+        assume that the server began processing it.
+        """
+        return isinstance(err, (ReadTimeoutError, ProtocolError))
+
+    def _is_method_retryable(self, method):
+        """Checks if a given HTTP method should be retried upon, depending if
+        it is included in the allowed_methods
+        """
+        # TODO: For now favor if the Retry implementation sets its own method_whitelist
+        # property outside of our constructor to avoid breaking custom implementations.
+        if "method_whitelist" in self.__dict__:
+            warnings.warn(
+                "Using 'method_whitelist' with Retry is deprecated and "
+                "will be removed in v2.0. Use 'allowed_methods' instead",
+                DeprecationWarning,
+            )
+            allowed_methods = self.method_whitelist
+        else:
+            allowed_methods = self.allowed_methods
+
+        if allowed_methods and method.upper() not in allowed_methods:
+            return False
+        return True
+
+    def is_retry(self, method, status_code, has_retry_after=False):
+        """Is this method/status code retryable? (Based on allowlists and control
+        variables such as the number of total retries to allow, whether to
+        respect the Retry-After header, whether this header is present, and
+        whether the returned status code is on the list of status codes to
+        be retried upon on the presence of the aforementioned header)
+        """
+        if not self._is_method_retryable(method):
+            return False
+
+        if self.status_forcelist and status_code in self.status_forcelist:
+            return True
+
+        return (
+            self.total
+            and self.respect_retry_after_header
+            and has_retry_after
+            and (status_code in self.RETRY_AFTER_STATUS_CODES)
+        )
+
+    def is_exhausted(self):
+        """Are we out of retries?"""
+        retry_counts = (
+            self.total,
+            self.connect,
+            self.read,
+            self.redirect,
+            self.status,
+            self.other,
+        )
+        retry_counts = list(filter(None, retry_counts))
+        if not retry_counts:
+            return False
+
+        return min(retry_counts) < 0
+
+    def increment(
+        self,
+        method=None,
+        url=None,
+        response=None,
+        error=None,
+        _pool=None,
+        _stacktrace=None,
+    ):
+        """Return a new Retry object with incremented retry counters.
+
+        :param response: A response object, or None, if the server did not
+            return a response.
+        :type response: :class:`~urllib3.response.HTTPResponse`
+        :param Exception error: An error encountered during the request, or
+            None if the response was received successfully.
+
+        :return: A new ``Retry`` object.
+        """
+        if self.total is False and error:
+            # Disabled, indicate to re-raise the error.
+            raise six.reraise(type(error), error, _stacktrace)
+
+        total = self.total
+        if total is not None:
+            total -= 1
+
+        connect = self.connect
+        read = self.read
+        redirect = self.redirect
+        status_count = self.status
+        other = self.other
+        cause = "unknown"
+        status = None
+        redirect_location = None
+
+        if error and self._is_connection_error(error):
+            # Connect retry?
+            if connect is False:
+                raise six.reraise(type(error), error, _stacktrace)
+            elif connect is not None:
+                connect -= 1
+
+        elif error and self._is_read_error(error):
+            # Read retry?
+            if read is False or not self._is_method_retryable(method):
+                raise six.reraise(type(error), error, _stacktrace)
+            elif read is not None:
+                read -= 1
+
+        elif error:
+            # Other retry?
+            if other is not None:
+                other -= 1
+
+        elif response and response.get_redirect_location():
+            # Redirect retry?
+            if redirect is not None:
+                redirect -= 1
+            cause = "too many redirects"
+            redirect_location = response.get_redirect_location()
+            status = response.status
+
+        else:
+            # Incrementing because of a server error like a 500 in
+            # status_forcelist and the given method is in the allowed_methods
+            cause = ResponseError.GENERIC_ERROR
+            if response and response.status:
+                if status_count is not None:
+                    status_count -= 1
+                cause = ResponseError.SPECIFIC_ERROR.format(status_code=response.status)
+                status = response.status
+
+        history = self.history + (
+            RequestHistory(method, url, error, status, redirect_location),
+        )
+
+        new_retry = self.new(
+            total=total,
+            connect=connect,
+            read=read,
+            redirect=redirect,
+            status=status_count,
+            other=other,
+            history=history,
+        )
+
+        if new_retry.is_exhausted():
+            raise MaxRetryError(_pool, url, error or ResponseError(cause))
+
+        log.debug("Incremented Retry for (url='%s'): %r", url, new_retry)
+
+        return new_retry
+
+    def __repr__(self):
+        return (
+            "{cls.__name__}(total={self.total}, connect={self.connect}, "
+            "read={self.read}, redirect={self.redirect}, status={self.status})"
+        ).format(cls=type(self), self=self)
+
+    def __getattr__(self, item):
+        if item == "method_whitelist":
+            # TODO: Remove this deprecated alias in v2.0
+            warnings.warn(
+                "Using 'method_whitelist' with Retry is deprecated and "
+                "will be removed in v2.0. Use 'allowed_methods' instead",
+                DeprecationWarning,
+            )
+            return self.allowed_methods
+        try:
+            return getattr(super(Retry, self), item)
+        except AttributeError:
+            return getattr(Retry, item)
+
+
+# For backwards compatibility (equivalent to pre-v1.9):
+Retry.DEFAULT = Retry(3)
diff --git a/openpype/vendor/python/python_2/urllib3/util/ssl_.py b/openpype/vendor/python/python_2/urllib3/util/ssl_.py
new file mode 100644
index 0000000000..8f867812a5
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/ssl_.py
@@ -0,0 +1,495 @@
+from __future__ import absolute_import
+
+import hmac
+import os
+import sys
+import warnings
+from binascii import hexlify, unhexlify
+from hashlib import md5, sha1, sha256
+
+from ..exceptions import (
+    InsecurePlatformWarning,
+    ProxySchemeUnsupported,
+    SNIMissingWarning,
+    SSLError,
+)
+from ..packages import six
+from .url import BRACELESS_IPV6_ADDRZ_RE, IPV4_RE
+
+SSLContext = None
+SSLTransport = None
+HAS_SNI = False
+IS_PYOPENSSL = False
+IS_SECURETRANSPORT = False
+ALPN_PROTOCOLS = ["http/1.1"]
+
+# Maps the length of a digest to a possible hash function producing this digest
+HASHFUNC_MAP = {32: md5, 40: sha1, 64: sha256}
+
+
+def _const_compare_digest_backport(a, b):
+    """
+    Compare two digests of equal length in constant time.
+
+    The digests must be of type str/bytes.
+    Returns True if the digests match, and False otherwise.
+    """
+    result = abs(len(a) - len(b))
+    for left, right in zip(bytearray(a), bytearray(b)):
+        result |= left ^ right
+    return result == 0
+
+
+_const_compare_digest = getattr(hmac, "compare_digest", _const_compare_digest_backport)
+
+try:  # Test for SSL features
+    import ssl
+    from ssl import CERT_REQUIRED, wrap_socket
+except ImportError:
+    pass
+
+try:
+    from ssl import HAS_SNI  # Has SNI?
+except ImportError:
+    pass
+
+try:
+    from .ssltransport import SSLTransport
+except ImportError:
+    pass
+
+
+try:  # Platform-specific: Python 3.6
+    from ssl import PROTOCOL_TLS
+
+    PROTOCOL_SSLv23 = PROTOCOL_TLS
+except ImportError:
+    try:
+        from ssl import PROTOCOL_SSLv23 as PROTOCOL_TLS
+
+        PROTOCOL_SSLv23 = PROTOCOL_TLS
+    except ImportError:
+        PROTOCOL_SSLv23 = PROTOCOL_TLS = 2
+
+try:
+    from ssl import PROTOCOL_TLS_CLIENT
+except ImportError:
+    PROTOCOL_TLS_CLIENT = PROTOCOL_TLS
+
+
+try:
+    from ssl import OP_NO_COMPRESSION, OP_NO_SSLv2, OP_NO_SSLv3
+except ImportError:
+    OP_NO_SSLv2, OP_NO_SSLv3 = 0x1000000, 0x2000000
+    OP_NO_COMPRESSION = 0x20000
+
+
+try:  # OP_NO_TICKET was added in Python 3.6
+    from ssl import OP_NO_TICKET
+except ImportError:
+    OP_NO_TICKET = 0x4000
+
+
+# A secure default.
+# Sources for more information on TLS ciphers:
+#
+# - https://wiki.mozilla.org/Security/Server_Side_TLS
+# - https://www.ssllabs.com/projects/best-practices/index.html
+# - https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/
+#
+# The general intent is:
+# - prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE),
+# - prefer ECDHE over DHE for better performance,
+# - prefer any AES-GCM and ChaCha20 over any AES-CBC for better performance and
+#   security,
+# - prefer AES-GCM over ChaCha20 because hardware-accelerated AES is common,
+# - disable NULL authentication, MD5 MACs, DSS, and other
+#   insecure ciphers for security reasons.
+# - NOTE: TLS 1.3 cipher suites are managed through a different interface
+#   not exposed by CPython (yet!) and are enabled by default if they're available.
+DEFAULT_CIPHERS = ":".join(
+    [
+        "ECDHE+AESGCM",
+        "ECDHE+CHACHA20",
+        "DHE+AESGCM",
+        "DHE+CHACHA20",
+        "ECDH+AESGCM",
+        "DH+AESGCM",
+        "ECDH+AES",
+        "DH+AES",
+        "RSA+AESGCM",
+        "RSA+AES",
+        "!aNULL",
+        "!eNULL",
+        "!MD5",
+        "!DSS",
+    ]
+)
+
+try:
+    from ssl import SSLContext  # Modern SSL?
+except ImportError:
+
+    class SSLContext(object):  # Platform-specific: Python 2
+        def __init__(self, protocol_version):
+            self.protocol = protocol_version
+            # Use default values from a real SSLContext
+            self.check_hostname = False
+            self.verify_mode = ssl.CERT_NONE
+            self.ca_certs = None
+            self.options = 0
+            self.certfile = None
+            self.keyfile = None
+            self.ciphers = None
+
+        def load_cert_chain(self, certfile, keyfile):
+            self.certfile = certfile
+            self.keyfile = keyfile
+
+        def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+            self.ca_certs = cafile
+
+            if capath is not None:
+                raise SSLError("CA directories not supported in older Pythons")
+
+            if cadata is not None:
+                raise SSLError("CA data not supported in older Pythons")
+
+        def set_ciphers(self, cipher_suite):
+            self.ciphers = cipher_suite
+
+        def wrap_socket(self, socket, server_hostname=None, server_side=False):
+            warnings.warn(
+                "A true SSLContext object is not available. This prevents "
+                "urllib3 from configuring SSL appropriately and may cause "
+                "certain SSL connections to fail. You can upgrade to a newer "
+                "version of Python to solve this. For more information, see "
+                "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                "#ssl-warnings",
+                InsecurePlatformWarning,
+            )
+            kwargs = {
+                "keyfile": self.keyfile,
+                "certfile": self.certfile,
+                "ca_certs": self.ca_certs,
+                "cert_reqs": self.verify_mode,
+                "ssl_version": self.protocol,
+                "server_side": server_side,
+            }
+            return wrap_socket(socket, ciphers=self.ciphers, **kwargs)
+
+
+def assert_fingerprint(cert, fingerprint):
+    """
+    Checks if given fingerprint matches the supplied certificate.
+
+    :param cert:
+        Certificate as bytes object.
+    :param fingerprint:
+        Fingerprint as string of hexdigits, can be interspersed by colons.
+    """
+
+    fingerprint = fingerprint.replace(":", "").lower()
+    digest_length = len(fingerprint)
+    hashfunc = HASHFUNC_MAP.get(digest_length)
+    if not hashfunc:
+        raise SSLError("Fingerprint of invalid length: {0}".format(fingerprint))
+
+    # We need encode() here for py32; works on py2 and p33.
+    fingerprint_bytes = unhexlify(fingerprint.encode())
+
+    cert_digest = hashfunc(cert).digest()
+
+    if not _const_compare_digest(cert_digest, fingerprint_bytes):
+        raise SSLError(
+            'Fingerprints did not match. Expected "{0}", got "{1}".'.format(
+                fingerprint, hexlify(cert_digest)
+            )
+        )
+
+
+def resolve_cert_reqs(candidate):
+    """
+    Resolves the argument to a numeric constant, which can be passed to
+    the wrap_socket function/method from the ssl module.
+    Defaults to :data:`ssl.CERT_REQUIRED`.
+    If given a string it is assumed to be the name of the constant in the
+    :mod:`ssl` module or its abbreviation.
+    (So you can specify `REQUIRED` instead of `CERT_REQUIRED`.
+    If it's neither `None` nor a string we assume it is already the numeric
+    constant which can directly be passed to wrap_socket.
+    """
+    if candidate is None:
+        return CERT_REQUIRED
+
+    if isinstance(candidate, str):
+        res = getattr(ssl, candidate, None)
+        if res is None:
+            res = getattr(ssl, "CERT_" + candidate)
+        return res
+
+    return candidate
+
+
+def resolve_ssl_version(candidate):
+    """
+    like resolve_cert_reqs
+    """
+    if candidate is None:
+        return PROTOCOL_TLS
+
+    if isinstance(candidate, str):
+        res = getattr(ssl, candidate, None)
+        if res is None:
+            res = getattr(ssl, "PROTOCOL_" + candidate)
+        return res
+
+    return candidate
+
+
+def create_urllib3_context(
+    ssl_version=None, cert_reqs=None, options=None, ciphers=None
+):
+    """All arguments have the same meaning as ``ssl_wrap_socket``.
+
+    By default, this function does a lot of the same work that
+    ``ssl.create_default_context`` does on Python 3.4+. It:
+
+    - Disables SSLv2, SSLv3, and compression
+    - Sets a restricted set of server ciphers
+
+    If you wish to enable SSLv3, you can do::
+
+        from urllib3.util import ssl_
+        context = ssl_.create_urllib3_context()
+        context.options &= ~ssl_.OP_NO_SSLv3
+
+    You can do the same to enable compression (substituting ``COMPRESSION``
+    for ``SSLv3`` in the last line above).
+
+    :param ssl_version:
+        The desired protocol version to use. This will default to
+        PROTOCOL_SSLv23 which will negotiate the highest protocol that both
+        the server and your installation of OpenSSL support.
+    :param cert_reqs:
+        Whether to require the certificate verification. This defaults to
+        ``ssl.CERT_REQUIRED``.
+    :param options:
+        Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``,
+        ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``, and ``ssl.OP_NO_TICKET``.
+    :param ciphers:
+        Which cipher suites to allow the server to select.
+    :returns:
+        Constructed SSLContext object with specified options
+    :rtype: SSLContext
+    """
+    # PROTOCOL_TLS is deprecated in Python 3.10
+    if not ssl_version or ssl_version == PROTOCOL_TLS:
+        ssl_version = PROTOCOL_TLS_CLIENT
+
+    context = SSLContext(ssl_version)
+
+    context.set_ciphers(ciphers or DEFAULT_CIPHERS)
+
+    # Setting the default here, as we may have no ssl module on import
+    cert_reqs = ssl.CERT_REQUIRED if cert_reqs is None else cert_reqs
+
+    if options is None:
+        options = 0
+        # SSLv2 is easily broken and is considered harmful and dangerous
+        options |= OP_NO_SSLv2
+        # SSLv3 has several problems and is now dangerous
+        options |= OP_NO_SSLv3
+        # Disable compression to prevent CRIME attacks for OpenSSL 1.0+
+        # (issue #309)
+        options |= OP_NO_COMPRESSION
+        # TLSv1.2 only. Unless set explicitly, do not request tickets.
+        # This may save some bandwidth on wire, and although the ticket is encrypted,
+        # there is a risk associated with it being on wire,
+        # if the server is not rotating its ticketing keys properly.
+        options |= OP_NO_TICKET
+
+    context.options |= options
+
+    # Enable post-handshake authentication for TLS 1.3, see GH #1634. PHA is
+    # necessary for conditional client cert authentication with TLS 1.3.
+    # The attribute is None for OpenSSL <= 1.1.0 or does not exist in older
+    # versions of Python.  We only enable on Python 3.7.4+ or if certificate
+    # verification is enabled to work around Python issue #37428
+    # See: https://bugs.python.org/issue37428
+    if (cert_reqs == ssl.CERT_REQUIRED or sys.version_info >= (3, 7, 4)) and getattr(
+        context, "post_handshake_auth", None
+    ) is not None:
+        context.post_handshake_auth = True
+
+    def disable_check_hostname():
+        if (
+            getattr(context, "check_hostname", None) is not None
+        ):  # Platform-specific: Python 3.2
+            # We do our own verification, including fingerprints and alternative
+            # hostnames. So disable it here
+            context.check_hostname = False
+
+    # The order of the below lines setting verify_mode and check_hostname
+    # matter due to safe-guards SSLContext has to prevent an SSLContext with
+    # check_hostname=True, verify_mode=NONE/OPTIONAL. This is made even more
+    # complex because we don't know whether PROTOCOL_TLS_CLIENT will be used
+    # or not so we don't know the initial state of the freshly created SSLContext.
+    if cert_reqs == ssl.CERT_REQUIRED:
+        context.verify_mode = cert_reqs
+        disable_check_hostname()
+    else:
+        disable_check_hostname()
+        context.verify_mode = cert_reqs
+
+    # Enable logging of TLS session keys via defacto standard environment variable
+    # 'SSLKEYLOGFILE', if the feature is available (Python 3.8+). Skip empty values.
+    if hasattr(context, "keylog_filename"):
+        sslkeylogfile = os.environ.get("SSLKEYLOGFILE")
+        if sslkeylogfile:
+            context.keylog_filename = sslkeylogfile
+
+    return context
+
+
+def ssl_wrap_socket(
+    sock,
+    keyfile=None,
+    certfile=None,
+    cert_reqs=None,
+    ca_certs=None,
+    server_hostname=None,
+    ssl_version=None,
+    ciphers=None,
+    ssl_context=None,
+    ca_cert_dir=None,
+    key_password=None,
+    ca_cert_data=None,
+    tls_in_tls=False,
+):
+    """
+    All arguments except for server_hostname, ssl_context, and ca_cert_dir have
+    the same meaning as they do when using :func:`ssl.wrap_socket`.
+
+    :param server_hostname:
+        When SNI is supported, the expected hostname of the certificate
+    :param ssl_context:
+        A pre-made :class:`SSLContext` object. If none is provided, one will
+        be created using :func:`create_urllib3_context`.
+    :param ciphers:
+        A string of ciphers we wish the client to support.
+    :param ca_cert_dir:
+        A directory containing CA certificates in multiple separate files, as
+        supported by OpenSSL's -CApath flag or the capath argument to
+        SSLContext.load_verify_locations().
+    :param key_password:
+        Optional password if the keyfile is encrypted.
+    :param ca_cert_data:
+        Optional string containing CA certificates in PEM format suitable for
+        passing as the cadata parameter to SSLContext.load_verify_locations()
+    :param tls_in_tls:
+        Use SSLTransport to wrap the existing socket.
+    """
+    context = ssl_context
+    if context is None:
+        # Note: This branch of code and all the variables in it are no longer
+        # used by urllib3 itself. We should consider deprecating and removing
+        # this code.
+        context = create_urllib3_context(ssl_version, cert_reqs, ciphers=ciphers)
+
+    if ca_certs or ca_cert_dir or ca_cert_data:
+        try:
+            context.load_verify_locations(ca_certs, ca_cert_dir, ca_cert_data)
+        except (IOError, OSError) as e:
+            raise SSLError(e)
+
+    elif ssl_context is None and hasattr(context, "load_default_certs"):
+        # try to load OS default certs; works well on Windows (require Python3.4+)
+        context.load_default_certs()
+
+    # Attempt to detect if we get the goofy behavior of the
+    # keyfile being encrypted and OpenSSL asking for the
+    # passphrase via the terminal and instead error out.
+    if keyfile and key_password is None and _is_key_file_encrypted(keyfile):
+        raise SSLError("Client private key is encrypted, password is required")
+
+    if certfile:
+        if key_password is None:
+            context.load_cert_chain(certfile, keyfile)
+        else:
+            context.load_cert_chain(certfile, keyfile, key_password)
+
+    try:
+        if hasattr(context, "set_alpn_protocols"):
+            context.set_alpn_protocols(ALPN_PROTOCOLS)
+    except NotImplementedError:  # Defensive: in CI, we always have set_alpn_protocols
+        pass
+
+    # If we detect server_hostname is an IP address then the SNI
+    # extension should not be used according to RFC3546 Section 3.1
+    use_sni_hostname = server_hostname and not is_ipaddress(server_hostname)
+    # SecureTransport uses server_hostname in certificate verification.
+    send_sni = (use_sni_hostname and HAS_SNI) or (
+        IS_SECURETRANSPORT and server_hostname
+    )
+    # Do not warn the user if server_hostname is an invalid SNI hostname.
+    if not HAS_SNI and use_sni_hostname:
+        warnings.warn(
+            "An HTTPS request has been made, but the SNI (Server Name "
+            "Indication) extension to TLS is not available on this platform. "
+            "This may cause the server to present an incorrect TLS "
+            "certificate, which can cause validation failures. You can upgrade to "
+            "a newer version of Python to solve this. For more information, see "
+            "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+            "#ssl-warnings",
+            SNIMissingWarning,
+        )
+
+    if send_sni:
+        ssl_sock = _ssl_wrap_socket_impl(
+            sock, context, tls_in_tls, server_hostname=server_hostname
+        )
+    else:
+        ssl_sock = _ssl_wrap_socket_impl(sock, context, tls_in_tls)
+    return ssl_sock
+
+
+def is_ipaddress(hostname):
+    """Detects whether the hostname given is an IPv4 or IPv6 address.
+    Also detects IPv6 addresses with Zone IDs.
+
+    :param str hostname: Hostname to examine.
+    :return: True if the hostname is an IP address, False otherwise.
+    """
+    if not six.PY2 and isinstance(hostname, bytes):
+        # IDN A-label bytes are ASCII compatible.
+        hostname = hostname.decode("ascii")
+    return bool(IPV4_RE.match(hostname) or BRACELESS_IPV6_ADDRZ_RE.match(hostname))
+
+
+def _is_key_file_encrypted(key_file):
+    """Detects if a key file is encrypted or not."""
+    with open(key_file, "r") as f:
+        for line in f:
+            # Look for Proc-Type: 4,ENCRYPTED
+            if "ENCRYPTED" in line:
+                return True
+
+    return False
+
+
+def _ssl_wrap_socket_impl(sock, ssl_context, tls_in_tls, server_hostname=None):
+    if tls_in_tls:
+        if not SSLTransport:
+            # Import error, ssl is not available.
+            raise ProxySchemeUnsupported(
+                "TLS in TLS requires support for the 'ssl' module"
+            )
+
+        SSLTransport._validate_ssl_context_for_tls_in_tls(ssl_context)
+        return SSLTransport(sock, ssl_context, server_hostname)
+
+    if server_hostname:
+        return ssl_context.wrap_socket(sock, server_hostname=server_hostname)
+    else:
+        return ssl_context.wrap_socket(sock)
diff --git a/openpype/vendor/python/python_2/urllib3/util/ssl_match_hostname.py b/openpype/vendor/python/python_2/urllib3/util/ssl_match_hostname.py
new file mode 100644
index 0000000000..1dd950c489
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/ssl_match_hostname.py
@@ -0,0 +1,159 @@
+"""The match_hostname() function from Python 3.3.3, essential when using SSL."""
+
+# Note: This file is under the PSF license as the code comes from the python
+# stdlib.   http://docs.python.org/3/license.html
+
+import re
+import sys
+
+# ipaddress has been backported to 2.6+ in pypi.  If it is installed on the
+# system, use it to handle IPAddress ServerAltnames (this was added in
+# python-3.5) otherwise only do DNS matching.  This allows
+# util.ssl_match_hostname to continue to be used in Python 2.7.
+try:
+    import ipaddress
+except ImportError:
+    ipaddress = None
+
+__version__ = "3.5.0.1"
+
+
+class CertificateError(ValueError):
+    pass
+
+
+def _dnsname_match(dn, hostname, max_wildcards=1):
+    """Matching according to RFC 6125, section 6.4.3
+
+    http://tools.ietf.org/html/rfc6125#section-6.4.3
+    """
+    pats = []
+    if not dn:
+        return False
+
+    # Ported from python3-syntax:
+    # leftmost, *remainder = dn.split(r'.')
+    parts = dn.split(r".")
+    leftmost = parts[0]
+    remainder = parts[1:]
+
+    wildcards = leftmost.count("*")
+    if wildcards > max_wildcards:
+        # Issue #17980: avoid denials of service by refusing more
+        # than one wildcard per fragment.  A survey of established
+        # policy among SSL implementations showed it to be a
+        # reasonable choice.
+        raise CertificateError(
+            "too many wildcards in certificate DNS name: " + repr(dn)
+        )
+
+    # speed up common case w/o wildcards
+    if not wildcards:
+        return dn.lower() == hostname.lower()
+
+    # RFC 6125, section 6.4.3, subitem 1.
+    # The client SHOULD NOT attempt to match a presented identifier in which
+    # the wildcard character comprises a label other than the left-most label.
+    if leftmost == "*":
+        # When '*' is a fragment by itself, it matches a non-empty dotless
+        # fragment.
+        pats.append("[^.]+")
+    elif leftmost.startswith("xn--") or hostname.startswith("xn--"):
+        # RFC 6125, section 6.4.3, subitem 3.
+        # The client SHOULD NOT attempt to match a presented identifier
+        # where the wildcard character is embedded within an A-label or
+        # U-label of an internationalized domain name.
+        pats.append(re.escape(leftmost))
+    else:
+        # Otherwise, '*' matches any dotless string, e.g. www*
+        pats.append(re.escape(leftmost).replace(r"\*", "[^.]*"))
+
+    # add the remaining fragments, ignore any wildcards
+    for frag in remainder:
+        pats.append(re.escape(frag))
+
+    pat = re.compile(r"\A" + r"\.".join(pats) + r"\Z", re.IGNORECASE)
+    return pat.match(hostname)
+
+
+def _to_unicode(obj):
+    if isinstance(obj, str) and sys.version_info < (3,):
+        # ignored flake8 # F821 to support python 2.7 function
+        obj = unicode(obj, encoding="ascii", errors="strict")  # noqa: F821
+    return obj
+
+
+def _ipaddress_match(ipname, host_ip):
+    """Exact matching of IP addresses.
+
+    RFC 6125 explicitly doesn't define an algorithm for this
+    (section 1.7.2 - "Out of Scope").
+    """
+    # OpenSSL may add a trailing newline to a subjectAltName's IP address
+    # Divergence from upstream: ipaddress can't handle byte str
+    ip = ipaddress.ip_address(_to_unicode(ipname).rstrip())
+    return ip == host_ip
+
+
+def match_hostname(cert, hostname):
+    """Verify that *cert* (in decoded format as returned by
+    SSLSocket.getpeercert()) matches the *hostname*.  RFC 2818 and RFC 6125
+    rules are followed, but IP addresses are not accepted for *hostname*.
+
+    CertificateError is raised on failure. On success, the function
+    returns nothing.
+    """
+    if not cert:
+        raise ValueError(
+            "empty or no certificate, match_hostname needs a "
+            "SSL socket or SSL context with either "
+            "CERT_OPTIONAL or CERT_REQUIRED"
+        )
+    try:
+        # Divergence from upstream: ipaddress can't handle byte str
+        host_ip = ipaddress.ip_address(_to_unicode(hostname))
+    except (UnicodeError, ValueError):
+        # ValueError: Not an IP address (common case)
+        # UnicodeError: Divergence from upstream: Have to deal with ipaddress not taking
+        # byte strings.  addresses should be all ascii, so we consider it not
+        # an ipaddress in this case
+        host_ip = None
+    except AttributeError:
+        # Divergence from upstream: Make ipaddress library optional
+        if ipaddress is None:
+            host_ip = None
+        else:  # Defensive
+            raise
+    dnsnames = []
+    san = cert.get("subjectAltName", ())
+    for key, value in san:
+        if key == "DNS":
+            if host_ip is None and _dnsname_match(value, hostname):
+                return
+            dnsnames.append(value)
+        elif key == "IP Address":
+            if host_ip is not None and _ipaddress_match(value, host_ip):
+                return
+            dnsnames.append(value)
+    if not dnsnames:
+        # The subject is only checked when there is no dNSName entry
+        # in subjectAltName
+        for sub in cert.get("subject", ()):
+            for key, value in sub:
+                # XXX according to RFC 2818, the most specific Common Name
+                # must be used.
+                if key == "commonName":
+                    if _dnsname_match(value, hostname):
+                        return
+                    dnsnames.append(value)
+    if len(dnsnames) > 1:
+        raise CertificateError(
+            "hostname %r "
+            "doesn't match either of %s" % (hostname, ", ".join(map(repr, dnsnames)))
+        )
+    elif len(dnsnames) == 1:
+        raise CertificateError("hostname %r doesn't match %r" % (hostname, dnsnames[0]))
+    else:
+        raise CertificateError(
+            "no appropriate commonName or subjectAltName fields were found"
+        )
diff --git a/openpype/vendor/python/python_2/urllib3/util/ssltransport.py b/openpype/vendor/python/python_2/urllib3/util/ssltransport.py
new file mode 100644
index 0000000000..4a7105d179
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/ssltransport.py
@@ -0,0 +1,221 @@
+import io
+import socket
+import ssl
+
+from ..exceptions import ProxySchemeUnsupported
+from ..packages import six
+
+SSL_BLOCKSIZE = 16384
+
+
+class SSLTransport:
+    """
+    The SSLTransport wraps an existing socket and establishes an SSL connection.
+
+    Contrary to Python's implementation of SSLSocket, it allows you to chain
+    multiple TLS connections together. It's particularly useful if you need to
+    implement TLS within TLS.
+
+    The class supports most of the socket API operations.
+    """
+
+    @staticmethod
+    def _validate_ssl_context_for_tls_in_tls(ssl_context):
+        """
+        Raises a ProxySchemeUnsupported if the provided ssl_context can't be used
+        for TLS in TLS.
+
+        The only requirement is that the ssl_context provides the 'wrap_bio'
+        methods.
+        """
+
+        if not hasattr(ssl_context, "wrap_bio"):
+            if six.PY2:
+                raise ProxySchemeUnsupported(
+                    "TLS in TLS requires SSLContext.wrap_bio() which isn't "
+                    "supported on Python 2"
+                )
+            else:
+                raise ProxySchemeUnsupported(
+                    "TLS in TLS requires SSLContext.wrap_bio() which isn't "
+                    "available on non-native SSLContext"
+                )
+
+    def __init__(
+        self, socket, ssl_context, server_hostname=None, suppress_ragged_eofs=True
+    ):
+        """
+        Create an SSLTransport around socket using the provided ssl_context.
+        """
+        self.incoming = ssl.MemoryBIO()
+        self.outgoing = ssl.MemoryBIO()
+
+        self.suppress_ragged_eofs = suppress_ragged_eofs
+        self.socket = socket
+
+        self.sslobj = ssl_context.wrap_bio(
+            self.incoming, self.outgoing, server_hostname=server_hostname
+        )
+
+        # Perform initial handshake.
+        self._ssl_io_loop(self.sslobj.do_handshake)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *_):
+        self.close()
+
+    def fileno(self):
+        return self.socket.fileno()
+
+    def read(self, len=1024, buffer=None):
+        return self._wrap_ssl_read(len, buffer)
+
+    def recv(self, len=1024, flags=0):
+        if flags != 0:
+            raise ValueError("non-zero flags not allowed in calls to recv")
+        return self._wrap_ssl_read(len)
+
+    def recv_into(self, buffer, nbytes=None, flags=0):
+        if flags != 0:
+            raise ValueError("non-zero flags not allowed in calls to recv_into")
+        if buffer and (nbytes is None):
+            nbytes = len(buffer)
+        elif nbytes is None:
+            nbytes = 1024
+        return self.read(nbytes, buffer)
+
+    def sendall(self, data, flags=0):
+        if flags != 0:
+            raise ValueError("non-zero flags not allowed in calls to sendall")
+        count = 0
+        with memoryview(data) as view, view.cast("B") as byte_view:
+            amount = len(byte_view)
+            while count < amount:
+                v = self.send(byte_view[count:])
+                count += v
+
+    def send(self, data, flags=0):
+        if flags != 0:
+            raise ValueError("non-zero flags not allowed in calls to send")
+        response = self._ssl_io_loop(self.sslobj.write, data)
+        return response
+
+    def makefile(
+        self, mode="r", buffering=None, encoding=None, errors=None, newline=None
+    ):
+        """
+        Python's httpclient uses makefile and buffered io when reading HTTP
+        messages and we need to support it.
+
+        This is unfortunately a copy and paste of socket.py makefile with small
+        changes to point to the socket directly.
+        """
+        if not set(mode) <= {"r", "w", "b"}:
+            raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
+
+        writing = "w" in mode
+        reading = "r" in mode or not writing
+        assert reading or writing
+        binary = "b" in mode
+        rawmode = ""
+        if reading:
+            rawmode += "r"
+        if writing:
+            rawmode += "w"
+        raw = socket.SocketIO(self, rawmode)
+        self.socket._io_refs += 1
+        if buffering is None:
+            buffering = -1
+        if buffering < 0:
+            buffering = io.DEFAULT_BUFFER_SIZE
+        if buffering == 0:
+            if not binary:
+                raise ValueError("unbuffered streams must be binary")
+            return raw
+        if reading and writing:
+            buffer = io.BufferedRWPair(raw, raw, buffering)
+        elif reading:
+            buffer = io.BufferedReader(raw, buffering)
+        else:
+            assert writing
+            buffer = io.BufferedWriter(raw, buffering)
+        if binary:
+            return buffer
+        text = io.TextIOWrapper(buffer, encoding, errors, newline)
+        text.mode = mode
+        return text
+
+    def unwrap(self):
+        self._ssl_io_loop(self.sslobj.unwrap)
+
+    def close(self):
+        self.socket.close()
+
+    def getpeercert(self, binary_form=False):
+        return self.sslobj.getpeercert(binary_form)
+
+    def version(self):
+        return self.sslobj.version()
+
+    def cipher(self):
+        return self.sslobj.cipher()
+
+    def selected_alpn_protocol(self):
+        return self.sslobj.selected_alpn_protocol()
+
+    def selected_npn_protocol(self):
+        return self.sslobj.selected_npn_protocol()
+
+    def shared_ciphers(self):
+        return self.sslobj.shared_ciphers()
+
+    def compression(self):
+        return self.sslobj.compression()
+
+    def settimeout(self, value):
+        self.socket.settimeout(value)
+
+    def gettimeout(self):
+        return self.socket.gettimeout()
+
+    def _decref_socketios(self):
+        self.socket._decref_socketios()
+
+    def _wrap_ssl_read(self, len, buffer=None):
+        try:
+            return self._ssl_io_loop(self.sslobj.read, len, buffer)
+        except ssl.SSLError as e:
+            if e.errno == ssl.SSL_ERROR_EOF and self.suppress_ragged_eofs:
+                return 0  # eof, return 0.
+            else:
+                raise
+
+    def _ssl_io_loop(self, func, *args):
+        """Performs an I/O loop between incoming/outgoing and the socket."""
+        should_loop = True
+        ret = None
+
+        while should_loop:
+            errno = None
+            try:
+                ret = func(*args)
+            except ssl.SSLError as e:
+                if e.errno not in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE):
+                    # WANT_READ, and WANT_WRITE are expected, others are not.
+                    raise e
+                errno = e.errno
+
+            buf = self.outgoing.read()
+            self.socket.sendall(buf)
+
+            if errno is None:
+                should_loop = False
+            elif errno == ssl.SSL_ERROR_WANT_READ:
+                buf = self.socket.recv(SSL_BLOCKSIZE)
+                if buf:
+                    self.incoming.write(buf)
+                else:
+                    self.incoming.write_eof()
+        return ret
diff --git a/openpype/vendor/python/python_2/urllib3/util/timeout.py b/openpype/vendor/python/python_2/urllib3/util/timeout.py
new file mode 100644
index 0000000000..ff69593b05
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/timeout.py
@@ -0,0 +1,268 @@
+from __future__ import absolute_import
+
+import time
+
+# The default socket timeout, used by httplib to indicate that no timeout was
+# specified by the user
+from socket import _GLOBAL_DEFAULT_TIMEOUT
+
+from ..exceptions import TimeoutStateError
+
+# A sentinel value to indicate that no timeout was specified by the user in
+# urllib3
+_Default = object()
+
+
+# Use time.monotonic if available.
+current_time = getattr(time, "monotonic", time.time)
+
+
+class Timeout(object):
+    """Timeout configuration.
+
+    Timeouts can be defined as a default for a pool:
+
+    .. code-block:: python
+
+       timeout = Timeout(connect=2.0, read=7.0)
+       http = PoolManager(timeout=timeout)
+       response = http.request('GET', 'http://example.com/')
+
+    Or per-request (which overrides the default for the pool):
+
+    .. code-block:: python
+
+       response = http.request('GET', 'http://example.com/', timeout=Timeout(10))
+
+    Timeouts can be disabled by setting all the parameters to ``None``:
+
+    .. code-block:: python
+
+       no_timeout = Timeout(connect=None, read=None)
+       response = http.request('GET', 'http://example.com/, timeout=no_timeout)
+
+
+    :param total:
+        This combines the connect and read timeouts into one; the read timeout
+        will be set to the time leftover from the connect attempt. In the
+        event that both a connect timeout and a total are specified, or a read
+        timeout and a total are specified, the shorter timeout will be applied.
+
+        Defaults to None.
+
+    :type total: int, float, or None
+
+    :param connect:
+        The maximum amount of time (in seconds) to wait for a connection
+        attempt to a server to succeed. Omitting the parameter will default the
+        connect timeout to the system default, probably `the global default
+        timeout in socket.py
+        <http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
+        None will set an infinite timeout for connection attempts.
+
+    :type connect: int, float, or None
+
+    :param read:
+        The maximum amount of time (in seconds) to wait between consecutive
+        read operations for a response from the server. Omitting the parameter
+        will default the read timeout to the system default, probably `the
+        global default timeout in socket.py
+        <http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
+        None will set an infinite timeout.
+
+    :type read: int, float, or None
+
+    .. note::
+
+        Many factors can affect the total amount of time for urllib3 to return
+        an HTTP response.
+
+        For example, Python's DNS resolver does not obey the timeout specified
+        on the socket. Other factors that can affect total request time include
+        high CPU load, high swap, the program running at a low priority level,
+        or other behaviors.
+
+        In addition, the read and total timeouts only measure the time between
+        read operations on the socket connecting the client and the server,
+        not the total amount of time for the request to return a complete
+        response. For most requests, the timeout is raised because the server
+        has not sent the first byte in the specified time. This is not always
+        the case; if a server streams one byte every fifteen seconds, a timeout
+        of 20 seconds will not trigger, even though the request will take
+        several minutes to complete.
+
+        If your goal is to cut off any request after a set amount of wall clock
+        time, consider having a second "watcher" thread to cut off a slow
+        request.
+    """
+
+    #: A sentinel object representing the default timeout value
+    DEFAULT_TIMEOUT = _GLOBAL_DEFAULT_TIMEOUT
+
+    def __init__(self, total=None, connect=_Default, read=_Default):
+        self._connect = self._validate_timeout(connect, "connect")
+        self._read = self._validate_timeout(read, "read")
+        self.total = self._validate_timeout(total, "total")
+        self._start_connect = None
+
+    def __repr__(self):
+        return "%s(connect=%r, read=%r, total=%r)" % (
+            type(self).__name__,
+            self._connect,
+            self._read,
+            self.total,
+        )
+
+    # __str__ provided for backwards compatibility
+    __str__ = __repr__
+
+    @classmethod
+    def _validate_timeout(cls, value, name):
+        """Check that a timeout attribute is valid.
+
+        :param value: The timeout value to validate
+        :param name: The name of the timeout attribute to validate. This is
+            used to specify in error messages.
+        :return: The validated and casted version of the given value.
+        :raises ValueError: If it is a numeric value less than or equal to
+            zero, or the type is not an integer, float, or None.
+        """
+        if value is _Default:
+            return cls.DEFAULT_TIMEOUT
+
+        if value is None or value is cls.DEFAULT_TIMEOUT:
+            return value
+
+        if isinstance(value, bool):
+            raise ValueError(
+                "Timeout cannot be a boolean value. It must "
+                "be an int, float or None."
+            )
+        try:
+            float(value)
+        except (TypeError, ValueError):
+            raise ValueError(
+                "Timeout value %s was %s, but it must be an "
+                "int, float or None." % (name, value)
+            )
+
+        try:
+            if value <= 0:
+                raise ValueError(
+                    "Attempted to set %s timeout to %s, but the "
+                    "timeout cannot be set to a value less "
+                    "than or equal to 0." % (name, value)
+                )
+        except TypeError:
+            # Python 3
+            raise ValueError(
+                "Timeout value %s was %s, but it must be an "
+                "int, float or None." % (name, value)
+            )
+
+        return value
+
+    @classmethod
+    def from_float(cls, timeout):
+        """Create a new Timeout from a legacy timeout value.
+
+        The timeout value used by httplib.py sets the same timeout on the
+        connect(), and recv() socket requests. This creates a :class:`Timeout`
+        object that sets the individual timeouts to the ``timeout`` value
+        passed to this function.
+
+        :param timeout: The legacy timeout value.
+        :type timeout: integer, float, sentinel default object, or None
+        :return: Timeout object
+        :rtype: :class:`Timeout`
+        """
+        return Timeout(read=timeout, connect=timeout)
+
+    def clone(self):
+        """Create a copy of the timeout object
+
+        Timeout properties are stored per-pool but each request needs a fresh
+        Timeout object to ensure each one has its own start/stop configured.
+
+        :return: a copy of the timeout object
+        :rtype: :class:`Timeout`
+        """
+        # We can't use copy.deepcopy because that will also create a new object
+        # for _GLOBAL_DEFAULT_TIMEOUT, which socket.py uses as a sentinel to
+        # detect the user default.
+        return Timeout(connect=self._connect, read=self._read, total=self.total)
+
+    def start_connect(self):
+        """Start the timeout clock, used during a connect() attempt
+
+        :raises urllib3.exceptions.TimeoutStateError: if you attempt
+            to start a timer that has been started already.
+        """
+        if self._start_connect is not None:
+            raise TimeoutStateError("Timeout timer has already been started.")
+        self._start_connect = current_time()
+        return self._start_connect
+
+    def get_connect_duration(self):
+        """Gets the time elapsed since the call to :meth:`start_connect`.
+
+        :return: Elapsed time in seconds.
+        :rtype: float
+        :raises urllib3.exceptions.TimeoutStateError: if you attempt
+            to get duration for a timer that hasn't been started.
+        """
+        if self._start_connect is None:
+            raise TimeoutStateError(
+                "Can't get connect duration for timer that has not started."
+            )
+        return current_time() - self._start_connect
+
+    @property
+    def connect_timeout(self):
+        """Get the value to use when setting a connection timeout.
+
+        This will be a positive float or integer, the value None
+        (never timeout), or the default system timeout.
+
+        :return: Connect timeout.
+        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
+        """
+        if self.total is None:
+            return self._connect
+
+        if self._connect is None or self._connect is self.DEFAULT_TIMEOUT:
+            return self.total
+
+        return min(self._connect, self.total)
+
+    @property
+    def read_timeout(self):
+        """Get the value for the read timeout.
+
+        This assumes some time has elapsed in the connection timeout and
+        computes the read timeout appropriately.
+
+        If self.total is set, the read timeout is dependent on the amount of
+        time taken by the connect timeout. If the connection time has not been
+        established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be
+        raised.
+
+        :return: Value to use for the read timeout.
+        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
+        :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect`
+            has not yet been called on this object.
+        """
+        if (
+            self.total is not None
+            and self.total is not self.DEFAULT_TIMEOUT
+            and self._read is not None
+            and self._read is not self.DEFAULT_TIMEOUT
+        ):
+            # In case the connect timeout has not yet been established.
+            if self._start_connect is None:
+                return self._read
+            return max(0, min(self.total - self.get_connect_duration(), self._read))
+        elif self.total is not None and self.total is not self.DEFAULT_TIMEOUT:
+            return max(0, self.total - self.get_connect_duration())
+        else:
+            return self._read
diff --git a/openpype/vendor/python/python_2/urllib3/util/url.py b/openpype/vendor/python/python_2/urllib3/util/url.py
new file mode 100644
index 0000000000..81a03da9e3
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/url.py
@@ -0,0 +1,432 @@
+from __future__ import absolute_import
+
+import re
+from collections import namedtuple
+
+from ..exceptions import LocationParseError
+from ..packages import six
+
+url_attrs = ["scheme", "auth", "host", "port", "path", "query", "fragment"]
+
+# We only want to normalize urls with an HTTP(S) scheme.
+# urllib3 infers URLs without a scheme (None) to be http.
+NORMALIZABLE_SCHEMES = ("http", "https", None)
+
+# Almost all of these patterns were derived from the
+# 'rfc3986' module: https://github.com/python-hyper/rfc3986
+PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}")
+SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)")
+URI_RE = re.compile(
+    r"^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?"
+    r"(?://([^\\/?#]*))?"
+    r"([^?#]*)"
+    r"(?:\?([^#]*))?"
+    r"(?:#(.*))?$",
+    re.UNICODE | re.DOTALL,
+)
+
+IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
+HEX_PAT = "[0-9A-Fa-f]{1,4}"
+LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=HEX_PAT, ipv4=IPV4_PAT)
+_subs = {"hex": HEX_PAT, "ls32": LS32_PAT}
+_variations = [
+    #                            6( h16 ":" ) ls32
+    "(?:%(hex)s:){6}%(ls32)s",
+    #                       "::" 5( h16 ":" ) ls32
+    "::(?:%(hex)s:){5}%(ls32)s",
+    # [               h16 ] "::" 4( h16 ":" ) ls32
+    "(?:%(hex)s)?::(?:%(hex)s:){4}%(ls32)s",
+    # [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32
+    "(?:(?:%(hex)s:)?%(hex)s)?::(?:%(hex)s:){3}%(ls32)s",
+    # [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32
+    "(?:(?:%(hex)s:){0,2}%(hex)s)?::(?:%(hex)s:){2}%(ls32)s",
+    # [ *3( h16 ":" ) h16 ] "::"    h16 ":"   ls32
+    "(?:(?:%(hex)s:){0,3}%(hex)s)?::%(hex)s:%(ls32)s",
+    # [ *4( h16 ":" ) h16 ] "::"              ls32
+    "(?:(?:%(hex)s:){0,4}%(hex)s)?::%(ls32)s",
+    # [ *5( h16 ":" ) h16 ] "::"              h16
+    "(?:(?:%(hex)s:){0,5}%(hex)s)?::%(hex)s",
+    # [ *6( h16 ":" ) h16 ] "::"
+    "(?:(?:%(hex)s:){0,6}%(hex)s)?::",
+]
+
+UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._!\-~"
+IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")"
+ZONE_ID_PAT = "(?:%25|%)(?:[" + UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+"
+IPV6_ADDRZ_PAT = r"\[" + IPV6_PAT + r"(?:" + ZONE_ID_PAT + r")?\]"
+REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*"
+TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$")
+
+IPV4_RE = re.compile("^" + IPV4_PAT + "$")
+IPV6_RE = re.compile("^" + IPV6_PAT + "$")
+IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT + "$")
+BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT[2:-2] + "$")
+ZONE_ID_RE = re.compile("(" + ZONE_ID_PAT + r")\]$")
+
+_HOST_PORT_PAT = ("^(%s|%s|%s)(?::([0-9]{0,5}))?$") % (
+    REG_NAME_PAT,
+    IPV4_PAT,
+    IPV6_ADDRZ_PAT,
+)
+_HOST_PORT_RE = re.compile(_HOST_PORT_PAT, re.UNICODE | re.DOTALL)
+
+UNRESERVED_CHARS = set(
+    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~"
+)
+SUB_DELIM_CHARS = set("!$&'()*+,;=")
+USERINFO_CHARS = UNRESERVED_CHARS | SUB_DELIM_CHARS | {":"}
+PATH_CHARS = USERINFO_CHARS | {"@", "/"}
+QUERY_CHARS = FRAGMENT_CHARS = PATH_CHARS | {"?"}
+
+
+class Url(namedtuple("Url", url_attrs)):
+    """
+    Data structure for representing an HTTP URL. Used as a return value for
+    :func:`parse_url`. Both the scheme and host are normalized as they are
+    both case-insensitive according to RFC 3986.
+    """
+
+    __slots__ = ()
+
+    def __new__(
+        cls,
+        scheme=None,
+        auth=None,
+        host=None,
+        port=None,
+        path=None,
+        query=None,
+        fragment=None,
+    ):
+        if path and not path.startswith("/"):
+            path = "/" + path
+        if scheme is not None:
+            scheme = scheme.lower()
+        return super(Url, cls).__new__(
+            cls, scheme, auth, host, port, path, query, fragment
+        )
+
+    @property
+    def hostname(self):
+        """For backwards-compatibility with urlparse. We're nice like that."""
+        return self.host
+
+    @property
+    def request_uri(self):
+        """Absolute path including the query string."""
+        uri = self.path or "/"
+
+        if self.query is not None:
+            uri += "?" + self.query
+
+        return uri
+
+    @property
+    def netloc(self):
+        """Network location including host and port"""
+        if self.port:
+            return "%s:%d" % (self.host, self.port)
+        return self.host
+
+    @property
+    def url(self):
+        """
+        Convert self into a url
+
+        This function should more or less round-trip with :func:`.parse_url`. The
+        returned url may not be exactly the same as the url inputted to
+        :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls
+        with a blank port will have : removed).
+
+        Example: ::
+
+            >>> U = parse_url('http://google.com/mail/')
+            >>> U.url
+            'http://google.com/mail/'
+            >>> Url('http', 'username:password', 'host.com', 80,
+            ... '/path', 'query', 'fragment').url
+            'http://username:password@host.com:80/path?query#fragment'
+        """
+        scheme, auth, host, port, path, query, fragment = self
+        url = u""
+
+        # We use "is not None" we want things to happen with empty strings (or 0 port)
+        if scheme is not None:
+            url += scheme + u"://"
+        if auth is not None:
+            url += auth + u"@"
+        if host is not None:
+            url += host
+        if port is not None:
+            url += u":" + str(port)
+        if path is not None:
+            url += path
+        if query is not None:
+            url += u"?" + query
+        if fragment is not None:
+            url += u"#" + fragment
+
+        return url
+
+    def __str__(self):
+        return self.url
+
+
+def split_first(s, delims):
+    """
+    .. deprecated:: 1.25
+
+    Given a string and an iterable of delimiters, split on the first found
+    delimiter. Return two split parts and the matched delimiter.
+
+    If not found, then the first part is the full input string.
+
+    Example::
+
+        >>> split_first('foo/bar?baz', '?/=')
+        ('foo', 'bar?baz', '/')
+        >>> split_first('foo/bar?baz', '123')
+        ('foo/bar?baz', '', None)
+
+    Scales linearly with number of delims. Not ideal for large number of delims.
+    """
+    min_idx = None
+    min_delim = None
+    for d in delims:
+        idx = s.find(d)
+        if idx < 0:
+            continue
+
+        if min_idx is None or idx < min_idx:
+            min_idx = idx
+            min_delim = d
+
+    if min_idx is None or min_idx < 0:
+        return s, "", None
+
+    return s[:min_idx], s[min_idx + 1 :], min_delim
+
+
+def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"):
+    """Percent-encodes a URI component without reapplying
+    onto an already percent-encoded component.
+    """
+    if component is None:
+        return component
+
+    component = six.ensure_text(component)
+
+    # Normalize existing percent-encoded bytes.
+    # Try to see if the component we're encoding is already percent-encoded
+    # so we can skip all '%' characters but still encode all others.
+    component, percent_encodings = PERCENT_RE.subn(
+        lambda match: match.group(0).upper(), component
+    )
+
+    uri_bytes = component.encode("utf-8", "surrogatepass")
+    is_percent_encoded = percent_encodings == uri_bytes.count(b"%")
+    encoded_component = bytearray()
+
+    for i in range(0, len(uri_bytes)):
+        # Will return a single character bytestring on both Python 2 & 3
+        byte = uri_bytes[i : i + 1]
+        byte_ord = ord(byte)
+        if (is_percent_encoded and byte == b"%") or (
+            byte_ord < 128 and byte.decode() in allowed_chars
+        ):
+            encoded_component += byte
+            continue
+        encoded_component.extend(b"%" + (hex(byte_ord)[2:].encode().zfill(2).upper()))
+
+    return encoded_component.decode(encoding)
+
+
+def _remove_path_dot_segments(path):
+    # See http://tools.ietf.org/html/rfc3986#section-5.2.4 for pseudo-code
+    segments = path.split("/")  # Turn the path into a list of segments
+    output = []  # Initialize the variable to use to store output
+
+    for segment in segments:
+        # '.' is the current directory, so ignore it, it is superfluous
+        if segment == ".":
+            continue
+        # Anything other than '..', should be appended to the output
+        elif segment != "..":
+            output.append(segment)
+        # In this case segment == '..', if we can, we should pop the last
+        # element
+        elif output:
+            output.pop()
+
+    # If the path starts with '/' and the output is empty or the first string
+    # is non-empty
+    if path.startswith("/") and (not output or output[0]):
+        output.insert(0, "")
+
+    # If the path starts with '/.' or '/..' ensure we add one more empty
+    # string to add a trailing '/'
+    if path.endswith(("/.", "/..")):
+        output.append("")
+
+    return "/".join(output)
+
+
+def _normalize_host(host, scheme):
+    if host:
+        if isinstance(host, six.binary_type):
+            host = six.ensure_str(host)
+
+        if scheme in NORMALIZABLE_SCHEMES:
+            is_ipv6 = IPV6_ADDRZ_RE.match(host)
+            if is_ipv6:
+                match = ZONE_ID_RE.search(host)
+                if match:
+                    start, end = match.span(1)
+                    zone_id = host[start:end]
+
+                    if zone_id.startswith("%25") and zone_id != "%25":
+                        zone_id = zone_id[3:]
+                    else:
+                        zone_id = zone_id[1:]
+                    zone_id = "%" + _encode_invalid_chars(zone_id, UNRESERVED_CHARS)
+                    return host[:start].lower() + zone_id + host[end:]
+                else:
+                    return host.lower()
+            elif not IPV4_RE.match(host):
+                return six.ensure_str(
+                    b".".join([_idna_encode(label) for label in host.split(".")])
+                )
+    return host
+
+
+def _idna_encode(name):
+    if name and any([ord(x) > 128 for x in name]):
+        try:
+            import idna
+        except ImportError:
+            six.raise_from(
+                LocationParseError("Unable to parse URL without the 'idna' module"),
+                None,
+            )
+        try:
+            return idna.encode(name.lower(), strict=True, std3_rules=True)
+        except idna.IDNAError:
+            six.raise_from(
+                LocationParseError(u"Name '%s' is not a valid IDNA label" % name), None
+            )
+    return name.lower().encode("ascii")
+
+
+def _encode_target(target):
+    """Percent-encodes a request target so that there are no invalid characters"""
+    path, query = TARGET_RE.match(target).groups()
+    target = _encode_invalid_chars(path, PATH_CHARS)
+    query = _encode_invalid_chars(query, QUERY_CHARS)
+    if query is not None:
+        target += "?" + query
+    return target
+
+
+def parse_url(url):
+    """
+    Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is
+    performed to parse incomplete urls. Fields not provided will be None.
+    This parser is RFC 3986 compliant.
+
+    The parser logic and helper functions are based heavily on
+    work done in the ``rfc3986`` module.
+
+    :param str url: URL to parse into a :class:`.Url` namedtuple.
+
+    Partly backwards-compatible with :mod:`urlparse`.
+
+    Example::
+
+        >>> parse_url('http://google.com/mail/')
+        Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
+        >>> parse_url('google.com:80')
+        Url(scheme=None, host='google.com', port=80, path=None, ...)
+        >>> parse_url('/foo?bar')
+        Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
+    """
+    if not url:
+        # Empty
+        return Url()
+
+    source_url = url
+    if not SCHEME_RE.search(url):
+        url = "//" + url
+
+    try:
+        scheme, authority, path, query, fragment = URI_RE.match(url).groups()
+        normalize_uri = scheme is None or scheme.lower() in NORMALIZABLE_SCHEMES
+
+        if scheme:
+            scheme = scheme.lower()
+
+        if authority:
+            auth, _, host_port = authority.rpartition("@")
+            auth = auth or None
+            host, port = _HOST_PORT_RE.match(host_port).groups()
+            if auth and normalize_uri:
+                auth = _encode_invalid_chars(auth, USERINFO_CHARS)
+            if port == "":
+                port = None
+        else:
+            auth, host, port = None, None, None
+
+        if port is not None:
+            port = int(port)
+            if not (0 <= port <= 65535):
+                raise LocationParseError(url)
+
+        host = _normalize_host(host, scheme)
+
+        if normalize_uri and path:
+            path = _remove_path_dot_segments(path)
+            path = _encode_invalid_chars(path, PATH_CHARS)
+        if normalize_uri and query:
+            query = _encode_invalid_chars(query, QUERY_CHARS)
+        if normalize_uri and fragment:
+            fragment = _encode_invalid_chars(fragment, FRAGMENT_CHARS)
+
+    except (ValueError, AttributeError):
+        return six.raise_from(LocationParseError(source_url), None)
+
+    # For the sake of backwards compatibility we put empty
+    # string values for path if there are any defined values
+    # beyond the path in the URL.
+    # TODO: Remove this when we break backwards compatibility.
+    if not path:
+        if query is not None or fragment is not None:
+            path = ""
+        else:
+            path = None
+
+    # Ensure that each part of the URL is a `str` for
+    # backwards compatibility.
+    if isinstance(url, six.text_type):
+        ensure_func = six.ensure_text
+    else:
+        ensure_func = six.ensure_str
+
+    def ensure_type(x):
+        return x if x is None else ensure_func(x)
+
+    return Url(
+        scheme=ensure_type(scheme),
+        auth=ensure_type(auth),
+        host=ensure_type(host),
+        port=port,
+        path=ensure_type(path),
+        query=ensure_type(query),
+        fragment=ensure_type(fragment),
+    )
+
+
+def get_host(url):
+    """
+    Deprecated. Use :func:`parse_url` instead.
+    """
+    p = parse_url(url)
+    return p.scheme or "http", p.hostname, p.port
diff --git a/openpype/vendor/python/python_2/urllib3/util/wait.py b/openpype/vendor/python/python_2/urllib3/util/wait.py
new file mode 100644
index 0000000000..c280646c7b
--- /dev/null
+++ b/openpype/vendor/python/python_2/urllib3/util/wait.py
@@ -0,0 +1,153 @@
+import errno
+import select
+import sys
+from functools import partial
+
+try:
+    from time import monotonic
+except ImportError:
+    from time import time as monotonic
+
+__all__ = ["NoWayToWaitForSocketError", "wait_for_read", "wait_for_write"]
+
+
+class NoWayToWaitForSocketError(Exception):
+    pass
+
+
+# How should we wait on sockets?
+#
+# There are two types of APIs you can use for waiting on sockets: the fancy
+# modern stateful APIs like epoll/kqueue, and the older stateless APIs like
+# select/poll. The stateful APIs are more efficient when you have a lots of
+# sockets to keep track of, because you can set them up once and then use them
+# lots of times. But we only ever want to wait on a single socket at a time
+# and don't want to keep track of state, so the stateless APIs are actually
+# more efficient. So we want to use select() or poll().
+#
+# Now, how do we choose between select() and poll()? On traditional Unixes,
+# select() has a strange calling convention that makes it slow, or fail
+# altogether, for high-numbered file descriptors. The point of poll() is to fix
+# that, so on Unixes, we prefer poll().
+#
+# On Windows, there is no poll() (or at least Python doesn't provide a wrapper
+# for it), but that's OK, because on Windows, select() doesn't have this
+# strange calling convention; plain select() works fine.
+#
+# So: on Windows we use select(), and everywhere else we use poll(). We also
+# fall back to select() in case poll() is somehow broken or missing.
+
+if sys.version_info >= (3, 5):
+    # Modern Python, that retries syscalls by default
+    def _retry_on_intr(fn, timeout):
+        return fn(timeout)
+
+
+else:
+    # Old and broken Pythons.
+    def _retry_on_intr(fn, timeout):
+        if timeout is None:
+            deadline = float("inf")
+        else:
+            deadline = monotonic() + timeout
+
+        while True:
+            try:
+                return fn(timeout)
+            # OSError for 3 <= pyver < 3.5, select.error for pyver <= 2.7
+            except (OSError, select.error) as e:
+                # 'e.args[0]' incantation works for both OSError and select.error
+                if e.args[0] != errno.EINTR:
+                    raise
+                else:
+                    timeout = deadline - monotonic()
+                    if timeout < 0:
+                        timeout = 0
+                    if timeout == float("inf"):
+                        timeout = None
+                    continue
+
+
+def select_wait_for_socket(sock, read=False, write=False, timeout=None):
+    if not read and not write:
+        raise RuntimeError("must specify at least one of read=True, write=True")
+    rcheck = []
+    wcheck = []
+    if read:
+        rcheck.append(sock)
+    if write:
+        wcheck.append(sock)
+    # When doing a non-blocking connect, most systems signal success by
+    # marking the socket writable. Windows, though, signals success by marked
+    # it as "exceptional". We paper over the difference by checking the write
+    # sockets for both conditions. (The stdlib selectors module does the same
+    # thing.)
+    fn = partial(select.select, rcheck, wcheck, wcheck)
+    rready, wready, xready = _retry_on_intr(fn, timeout)
+    return bool(rready or wready or xready)
+
+
+def poll_wait_for_socket(sock, read=False, write=False, timeout=None):
+    if not read and not write:
+        raise RuntimeError("must specify at least one of read=True, write=True")
+    mask = 0
+    if read:
+        mask |= select.POLLIN
+    if write:
+        mask |= select.POLLOUT
+    poll_obj = select.poll()
+    poll_obj.register(sock, mask)
+
+    # For some reason, poll() takes timeout in milliseconds
+    def do_poll(t):
+        if t is not None:
+            t *= 1000
+        return poll_obj.poll(t)
+
+    return bool(_retry_on_intr(do_poll, timeout))
+
+
+def null_wait_for_socket(*args, **kwargs):
+    raise NoWayToWaitForSocketError("no select-equivalent available")
+
+
+def _have_working_poll():
+    # Apparently some systems have a select.poll that fails as soon as you try
+    # to use it, either due to strange configuration or broken monkeypatching
+    # from libraries like eventlet/greenlet.
+    try:
+        poll_obj = select.poll()
+        _retry_on_intr(poll_obj.poll, 0)
+    except (AttributeError, OSError):
+        return False
+    else:
+        return True
+
+
+def wait_for_socket(*args, **kwargs):
+    # We delay choosing which implementation to use until the first time we're
+    # called. We could do it at import time, but then we might make the wrong
+    # decision if someone goes wild with monkeypatching select.poll after
+    # we're imported.
+    global wait_for_socket
+    if _have_working_poll():
+        wait_for_socket = poll_wait_for_socket
+    elif hasattr(select, "select"):
+        wait_for_socket = select_wait_for_socket
+    else:  # Platform-specific: Appengine.
+        wait_for_socket = null_wait_for_socket
+    return wait_for_socket(*args, **kwargs)
+
+
+def wait_for_read(sock, timeout=None):
+    """Waits for reading to be available on a given socket.
+    Returns True if the socket is readable, or False if the timeout expired.
+    """
+    return wait_for_socket(sock, read=True, timeout=timeout)
+
+
+def wait_for_write(sock, timeout=None):
+    """Waits for writing to be available on a given socket.
+    Returns True if the socket is readable, or False if the timeout expired.
+    """
+    return wait_for_socket(sock, write=True, timeout=timeout)

From 63a83dc23a7075bb40f2ea827c24aa0b0dbf3088 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 8 Jun 2022 16:04:55 +0200
Subject: [PATCH 0513/1227] Added set_project method to widget

It makes sending of project name to model clearer.
---
 openpype/modules/sync_server/tray/app.py     | 9 +++------
 openpype/modules/sync_server/tray/widgets.py | 3 +++
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/modules/sync_server/tray/app.py b/openpype/modules/sync_server/tray/app.py
index dee3bf0ecc..96fad6a247 100644
--- a/openpype/modules/sync_server/tray/app.py
+++ b/openpype/modules/sync_server/tray/app.py
@@ -101,8 +101,7 @@ class SyncServerWindow(QtWidgets.QDialog):
         self.representationWidget = repres
 
     def showEvent(self, event):
-        self.representationWidget.model.set_project(
-            self.projects.current_project)
+        self.representationWidget.set_project(self.projects.current_project)
         self.projects.refresh()
         self._set_running(True)
         super().showEvent(event)
@@ -115,9 +114,7 @@ class SyncServerWindow(QtWidgets.QDialog):
         if self.projects.current_project is None:
             return
 
-        self.representationWidget.table_view.model().set_project(
-            self.projects.current_project
-        )
+        self.representationWidget.set_project(self.projects.current_project)
 
         project_name = self.projects.current_project
         if not self.sync_server.get_sync_project_setting(project_name):
@@ -131,7 +128,7 @@ class SyncServerWindow(QtWidgets.QDialog):
         self.projects.show_only_enabled = \
             self.show_only_enabled_chk.isChecked()
         self.projects.refresh()
-        self.representationWidget.model.set_project(None)
+        self.representationWidget.set_project(None)
 
     def _set_running(self, running):
         self.representationWidget.model.is_running = running
diff --git a/openpype/modules/sync_server/tray/widgets.py b/openpype/modules/sync_server/tray/widgets.py
index 89ab12ea4d..b4ee447ac4 100644
--- a/openpype/modules/sync_server/tray/widgets.py
+++ b/openpype/modules/sync_server/tray/widgets.py
@@ -253,6 +253,9 @@ class _SyncRepresentationWidget(QtWidgets.QWidget):
     active_changed = QtCore.Signal()  # active index changed
     message_generated = QtCore.Signal(str)
 
+    def set_project(self, project):
+        self.model.set_project(project)
+
     def _selection_changed(self, _new_selected, _all_selected):
         idxs = self.selection_model.selectedRows()
         self._selected_ids = set()

From 1494c09d2aa39a4e8b4e7d480c4b0719b0d2116a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 16:17:03 +0200
Subject: [PATCH 0514/1227] added websocket, socketio and engineio into python
 2 vendor

---
 .../python/python_2/engineio/__init__.py      |  25 +
 .../python/python_2/engineio/async_aiohttp.py | 129 ++++
 .../python/python_2/engineio/async_asgi.py    | 223 ++++++
 .../engineio/async_drivers/__init__.py        |   0
 .../engineio/async_drivers/aiohttp.py         | 128 ++++
 .../python_2/engineio/async_drivers/asgi.py   | 214 ++++++
 .../engineio/async_drivers/eventlet.py        |  30 +
 .../python_2/engineio/async_drivers/gevent.py |  63 ++
 .../engineio/async_drivers/gevent_uwsgi.py    | 156 ++++
 .../python_2/engineio/async_drivers/sanic.py  | 144 ++++
 .../engineio/async_drivers/threading.py       |  17 +
 .../engineio/async_drivers/tornado.py         | 184 +++++
 .../python_2/engineio/async_eventlet.py       |  30 +
 .../python/python_2/engineio/async_gevent.py  |  63 ++
 .../python_2/engineio/async_gevent_uwsgi.py   | 155 ++++
 .../python/python_2/engineio/async_sanic.py   | 145 ++++
 .../python_2/engineio/async_threading.py      |  17 +
 .../python/python_2/engineio/async_tornado.py | 154 ++++
 .../python_2/engineio/asyncio_client.py       | 556 ++++++++++++++
 .../python_2/engineio/asyncio_server.py       | 444 +++++++++++
 .../python_2/engineio/asyncio_socket.py       | 235 ++++++
 .../vendor/python/python_2/engineio/client.py | 641 ++++++++++++++++
 .../python/python_2/engineio/exceptions.py    |  22 +
 .../python/python_2/engineio/middleware.py    |  87 +++
 .../vendor/python/python_2/engineio/packet.py |  92 +++
 .../python/python_2/engineio/payload.py       |  80 ++
 .../vendor/python/python_2/engineio/server.py | 633 +++++++++++++++
 .../vendor/python/python_2/engineio/socket.py | 247 ++++++
 .../python/python_2/engineio/static_files.py  |  55 ++
 .../python/python_2/socketio/__init__.py      |  35 +
 .../vendor/python/python_2/socketio/asgi.py   |  36 +
 .../python_2/socketio/asyncio_client.py       | 445 +++++++++++
 .../python_2/socketio/asyncio_manager.py      |  58 ++
 .../python_2/socketio/asyncio_namespace.py    | 204 +++++
 .../socketio/asyncio_pubsub_manager.py        | 163 ++++
 .../socketio/asyncio_redis_manager.py         | 107 +++
 .../python_2/socketio/asyncio_server.py       | 515 +++++++++++++
 .../python/python_2/socketio/base_manager.py  | 178 +++++
 .../vendor/python/python_2/socketio/client.py | 590 ++++++++++++++
 .../python/python_2/socketio/exceptions.py    |  26 +
 .../python/python_2/socketio/kombu_manager.py | 105 +++
 .../python/python_2/socketio/middleware.py    |  42 +
 .../python/python_2/socketio/namespace.py     | 191 +++++
 .../vendor/python/python_2/socketio/packet.py | 179 +++++
 .../python_2/socketio/pubsub_manager.py       | 154 ++++
 .../python/python_2/socketio/redis_manager.py | 111 +++
 .../vendor/python/python_2/socketio/server.py | 719 ++++++++++++++++++
 .../python/python_2/socketio/tornado.py       |  11 +
 .../python/python_2/socketio/zmq_manager.py   | 111 +++
 .../python/python_2/websocket/__init__.py     |  28 +
 .../vendor/python/python_2/websocket/_abnf.py | 458 +++++++++++
 .../vendor/python/python_2/websocket/_app.py  | 399 ++++++++++
 .../python/python_2/websocket/_cookiejar.py   |  78 ++
 .../vendor/python/python_2/websocket/_core.py | 595 +++++++++++++++
 .../python/python_2/websocket/_exceptions.py  |  86 +++
 .../python/python_2/websocket/_handshake.py   | 212 ++++++
 .../vendor/python/python_2/websocket/_http.py | 335 ++++++++
 .../python/python_2/websocket/_logging.py     |  92 +++
 .../python/python_2/websocket/_socket.py      | 176 +++++
 .../python/python_2/websocket/_ssl_compat.py  |  53 ++
 .../vendor/python/python_2/websocket/_url.py  | 178 +++++
 .../python/python_2/websocket/_utils.py       | 110 +++
 .../python_2/websocket/tests/__init__.py      |   0
 .../websocket/tests/data/header01.txt         |   6 +
 .../websocket/tests/data/header02.txt         |   6 +
 .../websocket/tests/data/header03.txt         |   6 +
 .../python_2/websocket/tests/test_abnf.py     |  77 ++
 .../python_2/websocket/tests/test_app.py      | 137 ++++
 .../websocket/tests/test_cookiejar.py         | 117 +++
 .../python_2/websocket/tests/test_http.py     | 109 +++
 .../python_2/websocket/tests/test_url.py      | 309 ++++++++
 .../websocket/tests/test_websocket.py         | 433 +++++++++++
 72 files changed, 12949 insertions(+)
 create mode 100644 openpype/vendor/python/python_2/engineio/__init__.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_aiohttp.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_asgi.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_drivers/__init__.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_drivers/aiohttp.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_drivers/asgi.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_drivers/eventlet.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_drivers/gevent.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_drivers/gevent_uwsgi.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_drivers/sanic.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_drivers/threading.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_drivers/tornado.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_eventlet.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_gevent.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_gevent_uwsgi.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_sanic.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_threading.py
 create mode 100644 openpype/vendor/python/python_2/engineio/async_tornado.py
 create mode 100644 openpype/vendor/python/python_2/engineio/asyncio_client.py
 create mode 100644 openpype/vendor/python/python_2/engineio/asyncio_server.py
 create mode 100644 openpype/vendor/python/python_2/engineio/asyncio_socket.py
 create mode 100644 openpype/vendor/python/python_2/engineio/client.py
 create mode 100644 openpype/vendor/python/python_2/engineio/exceptions.py
 create mode 100644 openpype/vendor/python/python_2/engineio/middleware.py
 create mode 100644 openpype/vendor/python/python_2/engineio/packet.py
 create mode 100644 openpype/vendor/python/python_2/engineio/payload.py
 create mode 100644 openpype/vendor/python/python_2/engineio/server.py
 create mode 100644 openpype/vendor/python/python_2/engineio/socket.py
 create mode 100644 openpype/vendor/python/python_2/engineio/static_files.py
 create mode 100644 openpype/vendor/python/python_2/socketio/__init__.py
 create mode 100644 openpype/vendor/python/python_2/socketio/asgi.py
 create mode 100644 openpype/vendor/python/python_2/socketio/asyncio_client.py
 create mode 100644 openpype/vendor/python/python_2/socketio/asyncio_manager.py
 create mode 100644 openpype/vendor/python/python_2/socketio/asyncio_namespace.py
 create mode 100644 openpype/vendor/python/python_2/socketio/asyncio_pubsub_manager.py
 create mode 100644 openpype/vendor/python/python_2/socketio/asyncio_redis_manager.py
 create mode 100644 openpype/vendor/python/python_2/socketio/asyncio_server.py
 create mode 100644 openpype/vendor/python/python_2/socketio/base_manager.py
 create mode 100644 openpype/vendor/python/python_2/socketio/client.py
 create mode 100644 openpype/vendor/python/python_2/socketio/exceptions.py
 create mode 100644 openpype/vendor/python/python_2/socketio/kombu_manager.py
 create mode 100644 openpype/vendor/python/python_2/socketio/middleware.py
 create mode 100644 openpype/vendor/python/python_2/socketio/namespace.py
 create mode 100644 openpype/vendor/python/python_2/socketio/packet.py
 create mode 100644 openpype/vendor/python/python_2/socketio/pubsub_manager.py
 create mode 100644 openpype/vendor/python/python_2/socketio/redis_manager.py
 create mode 100644 openpype/vendor/python/python_2/socketio/server.py
 create mode 100644 openpype/vendor/python/python_2/socketio/tornado.py
 create mode 100644 openpype/vendor/python/python_2/socketio/zmq_manager.py
 create mode 100644 openpype/vendor/python/python_2/websocket/__init__.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_abnf.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_app.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_cookiejar.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_core.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_exceptions.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_handshake.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_http.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_logging.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_socket.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_ssl_compat.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_url.py
 create mode 100644 openpype/vendor/python/python_2/websocket/_utils.py
 create mode 100644 openpype/vendor/python/python_2/websocket/tests/__init__.py
 create mode 100644 openpype/vendor/python/python_2/websocket/tests/data/header01.txt
 create mode 100644 openpype/vendor/python/python_2/websocket/tests/data/header02.txt
 create mode 100644 openpype/vendor/python/python_2/websocket/tests/data/header03.txt
 create mode 100644 openpype/vendor/python/python_2/websocket/tests/test_abnf.py
 create mode 100644 openpype/vendor/python/python_2/websocket/tests/test_app.py
 create mode 100644 openpype/vendor/python/python_2/websocket/tests/test_cookiejar.py
 create mode 100644 openpype/vendor/python/python_2/websocket/tests/test_http.py
 create mode 100644 openpype/vendor/python/python_2/websocket/tests/test_url.py
 create mode 100644 openpype/vendor/python/python_2/websocket/tests/test_websocket.py

diff --git a/openpype/vendor/python/python_2/engineio/__init__.py b/openpype/vendor/python/python_2/engineio/__init__.py
new file mode 100644
index 0000000000..888bf40190
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/__init__.py
@@ -0,0 +1,25 @@
+import sys
+
+from .client import Client
+from .middleware import WSGIApp, Middleware
+from .server import Server
+if sys.version_info >= (3, 5):  # pragma: no cover
+    from .asyncio_server import AsyncServer
+    from .asyncio_client import AsyncClient
+    from .async_drivers.asgi import ASGIApp
+    try:
+        from .async_drivers.tornado import get_tornado_handler
+    except ImportError:
+        get_tornado_handler = None
+else:  # pragma: no cover
+    AsyncServer = None
+    AsyncClient = None
+    get_tornado_handler = None
+    ASGIApp = None
+
+__version__ = '3.8.2.post1'
+
+__all__ = ['__version__', 'Server', 'WSGIApp', 'Middleware', 'Client']
+if AsyncServer is not None:  # pragma: no cover
+    __all__ += ['AsyncServer', 'ASGIApp', 'get_tornado_handler',
+                'AsyncClient'],
diff --git a/openpype/vendor/python/python_2/engineio/async_aiohttp.py b/openpype/vendor/python/python_2/engineio/async_aiohttp.py
new file mode 100644
index 0000000000..ad0252dff9
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_aiohttp.py
@@ -0,0 +1,129 @@
+import asyncio
+import sys
+from urllib.parse import urlsplit
+
+from aiohttp.web import Response, WebSocketResponse
+import six
+
+
+def create_route(app, engineio_server, engineio_endpoint):
+    """This function sets up the engine.io endpoint as a route for the
+    application.
+
+    Note that both GET and POST requests must be hooked up on the engine.io
+    endpoint.
+    """
+    app.router.add_get(engineio_endpoint, engineio_server.handle_request)
+    app.router.add_post(engineio_endpoint, engineio_server.handle_request)
+    app.router.add_route('OPTIONS', engineio_endpoint,
+                         engineio_server.handle_request)
+
+
+def translate_request(request):
+    """This function takes the arguments passed to the request handler and
+    uses them to generate a WSGI compatible environ dictionary.
+    """
+    message = request._message
+    payload = request._payload
+
+    uri_parts = urlsplit(message.path)
+    environ = {
+        'wsgi.input': payload,
+        'wsgi.errors': sys.stderr,
+        'wsgi.version': (1, 0),
+        'wsgi.async': True,
+        'wsgi.multithread': False,
+        'wsgi.multiprocess': False,
+        'wsgi.run_once': False,
+        'SERVER_SOFTWARE': 'aiohttp',
+        'REQUEST_METHOD': message.method,
+        'QUERY_STRING': uri_parts.query or '',
+        'RAW_URI': message.path,
+        'SERVER_PROTOCOL': 'HTTP/%s.%s' % message.version,
+        'REMOTE_ADDR': '127.0.0.1',
+        'REMOTE_PORT': '0',
+        'SERVER_NAME': 'aiohttp',
+        'SERVER_PORT': '0',
+        'aiohttp.request': request
+    }
+
+    for hdr_name, hdr_value in message.headers.items():
+        hdr_name = hdr_name.upper()
+        if hdr_name == 'CONTENT-TYPE':
+            environ['CONTENT_TYPE'] = hdr_value
+            continue
+        elif hdr_name == 'CONTENT-LENGTH':
+            environ['CONTENT_LENGTH'] = hdr_value
+            continue
+
+        key = 'HTTP_%s' % hdr_name.replace('-', '_')
+        if key in environ:
+            hdr_value = '%s,%s' % (environ[key], hdr_value)
+
+        environ[key] = hdr_value
+
+    environ['wsgi.url_scheme'] = environ.get('HTTP_X_FORWARDED_PROTO', 'http')
+
+    path_info = uri_parts.path
+
+    environ['PATH_INFO'] = path_info
+    environ['SCRIPT_NAME'] = ''
+
+    return environ
+
+
+def make_response(status, headers, payload, environ):
+    """This function generates an appropriate response object for this async
+    mode.
+    """
+    return Response(body=payload, status=int(status.split()[0]),
+                    headers=headers)
+
+
+class WebSocket(object):  # pragma: no cover
+    """
+    This wrapper class provides a aiohttp WebSocket interface that is
+    somewhat compatible with eventlet's implementation.
+    """
+    def __init__(self, handler):
+        self.handler = handler
+        self._sock = None
+
+    async def __call__(self, environ):
+        request = environ['aiohttp.request']
+        self._sock = WebSocketResponse()
+        await self._sock.prepare(request)
+
+        self.environ = environ
+        await self.handler(self)
+        return self._sock
+
+    async def close(self):
+        await self._sock.close()
+
+    async def send(self, message):
+        if isinstance(message, bytes):
+            f = self._sock.send_bytes
+        else:
+            f = self._sock.send_str
+        if asyncio.iscoroutinefunction(f):
+            await f(message)
+        else:
+            f(message)
+
+    async def wait(self):
+        msg = await self._sock.receive()
+        if not isinstance(msg.data, six.binary_type) and \
+                not isinstance(msg.data, six.text_type):
+            raise IOError()
+        return msg.data
+
+
+_async = {
+    'asyncio': True,
+    'create_route': create_route,
+    'translate_request': translate_request,
+    'make_response': make_response,
+    'websocket': sys.modules[__name__],
+    'websocket_class': 'WebSocket'
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_asgi.py b/openpype/vendor/python/python_2/engineio/async_asgi.py
new file mode 100644
index 0000000000..d216f31c77
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_asgi.py
@@ -0,0 +1,223 @@
+import sys
+
+
+class ASGIApp:
+    """ASGI application middleware for Engine.IO.
+
+    This middleware dispatches traffic to an Engine.IO application. It can
+    also serve a list of static files to the client, or forward unrelated
+    HTTP traffic to another ASGI application.
+
+    :param engineio_server: The Engine.IO server. Must be an instance of the
+                            ``engineio.AsyncServer`` class.
+    :param static_files: A dictionary where the keys are URLs that should be
+                         served as static files. For each URL, the value is
+                         a dictionary with ``content_type`` and ``filename``
+                         keys. This option is intended to be used for serving
+                         client files during development.
+    :param other_asgi_app: A separate ASGI app that receives all other traffic.
+    :param engineio_path: The endpoint where the Engine.IO application should
+                          be installed. The default value is appropriate for
+                          most cases.
+
+    Example usage::
+
+        import engineio
+        import uvicorn
+
+        eio = engineio.AsyncServer()
+        app = engineio.ASGIApp(eio, static_files={
+            '/': {'content_type': 'text/html', 'filename': 'index.html'},
+            '/index.html': {'content_type': 'text/html',
+                            'filename': 'index.html'},
+        })
+        uvicorn.run(app, '127.0.0.1', 5000)
+    """
+    def __init__(self, engineio_server, other_asgi_app=None,
+                 static_files=None, engineio_path='engine.io'):
+        self.engineio_server = engineio_server
+        self.other_asgi_app = other_asgi_app
+        self.engineio_path = engineio_path.strip('/')
+        self.static_files = static_files or {}
+
+    def __call__(self, scope):
+        if scope['type'] in ['http', 'websocket'] and \
+                scope['path'].startswith('/{0}/'.format(self.engineio_path)):
+            return self.engineio_asgi_app(scope)
+        elif scope['type'] == 'http' and scope['path'] in self.static_files:
+            return self.serve_static_file(scope)
+        elif self.other_asgi_app is not None:
+            return self.other_asgi_app(scope)
+        elif scope['type'] == 'lifespan':
+            return self.lifespan
+        else:
+            return self.not_found
+
+    def engineio_asgi_app(self, scope):
+        async def _app(receive, send):
+            await self.engineio_server.handle_request(scope, receive, send)
+        return _app
+
+    def serve_static_file(self, scope):
+        async def _send_static_file(receive, send):  # pragma: no cover
+            event = await receive()
+            if event['type'] == 'http.request':
+                if scope['path'] in self.static_files:
+                    content_type = self.static_files[scope['path']][
+                        'content_type'].encode('utf-8')
+                    filename = self.static_files[scope['path']]['filename']
+                    status_code = 200
+                    with open(filename, 'rb') as f:
+                        payload = f.read()
+                else:
+                    content_type = b'text/plain'
+                    status_code = 404
+                    payload = b'not found'
+                await send({'type': 'http.response.start',
+                            'status': status_code,
+                            'headers': [(b'Content-Type', content_type)]})
+                await send({'type': 'http.response.body',
+                            'body': payload})
+        return _send_static_file
+
+    async def lifespan(self, receive, send):
+        event = await receive()
+        if event['type'] == 'lifespan.startup':
+            await send({'type': 'lifespan.startup.complete'})
+        elif event['type'] == 'lifespan.shutdown':
+            await send({'type': 'lifespan.shutdown.complete'})
+
+    async def not_found(self, receive, send):
+        """Return a 404 Not Found error to the client."""
+        await send({'type': 'http.response.start',
+                    'status': 404,
+                    'headers': [(b'Content-Type', b'text/plain')]})
+        await send({'type': 'http.response.body',
+                    'body': b'not found'})
+
+
+async def translate_request(scope, receive, send):
+    class AwaitablePayload(object):  # pragma: no cover
+        def __init__(self, payload):
+            self.payload = payload or b''
+
+        async def read(self, length=None):
+            if length is None:
+                r = self.payload
+                self.payload = b''
+            else:
+                r = self.payload[:length]
+                self.payload = self.payload[length:]
+            return r
+
+    event = await receive()
+    payload = b''
+    if event['type'] == 'http.request':
+        payload += event.get('body') or b''
+        while event.get('more_body'):
+            event = await receive()
+            if event['type'] == 'http.request':
+                payload += event.get('body') or b''
+    elif event['type'] == 'websocket.connect':
+        await send({'type': 'websocket.accept'})
+    else:
+        return {}
+
+    raw_uri = scope['path'].encode('utf-8')
+    if 'query_string' in scope and scope['query_string']:
+        raw_uri += b'?' + scope['query_string']
+    environ = {
+        'wsgi.input': AwaitablePayload(payload),
+        'wsgi.errors': sys.stderr,
+        'wsgi.version': (1, 0),
+        'wsgi.async': True,
+        'wsgi.multithread': False,
+        'wsgi.multiprocess': False,
+        'wsgi.run_once': False,
+        'SERVER_SOFTWARE': 'asgi',
+        'REQUEST_METHOD': scope.get('method', 'GET'),
+        'PATH_INFO': scope['path'],
+        'QUERY_STRING': scope.get('query_string', b'').decode('utf-8'),
+        'RAW_URI': raw_uri.decode('utf-8'),
+        'SCRIPT_NAME': '',
+        'SERVER_PROTOCOL': 'HTTP/1.1',
+        'REMOTE_ADDR': '127.0.0.1',
+        'REMOTE_PORT': '0',
+        'SERVER_NAME': 'asgi',
+        'SERVER_PORT': '0',
+        'asgi.receive': receive,
+        'asgi.send': send,
+    }
+
+    for hdr_name, hdr_value in scope['headers']:
+        hdr_name = hdr_name.upper().decode('utf-8')
+        hdr_value = hdr_value.decode('utf-8')
+        if hdr_name == 'CONTENT-TYPE':
+            environ['CONTENT_TYPE'] = hdr_value
+            continue
+        elif hdr_name == 'CONTENT-LENGTH':
+            environ['CONTENT_LENGTH'] = hdr_value
+            continue
+
+        key = 'HTTP_%s' % hdr_name.replace('-', '_')
+        if key in environ:
+            hdr_value = '%s,%s' % (environ[key], hdr_value)
+
+        environ[key] = hdr_value
+
+    environ['wsgi.url_scheme'] = environ.get('HTTP_X_FORWARDED_PROTO', 'http')
+    return environ
+
+
+async def make_response(status, headers, payload, environ):
+    headers = [(h[0].encode('utf-8'), h[1].encode('utf-8')) for h in headers]
+    await environ['asgi.send']({'type': 'http.response.start',
+                                'status': int(status.split(' ')[0]),
+                                'headers': headers})
+    await environ['asgi.send']({'type': 'http.response.body',
+                                'body': payload})
+
+
+class WebSocket(object):  # pragma: no cover
+    """
+    This wrapper class provides an asgi WebSocket interface that is
+    somewhat compatible with eventlet's implementation.
+    """
+    def __init__(self, handler):
+        self.handler = handler
+        self.asgi_receive = None
+        self.asgi_send = None
+
+    async def __call__(self, environ):
+        self.asgi_receive = environ['asgi.receive']
+        self.asgi_send = environ['asgi.send']
+        await self.handler(self)
+
+    async def close(self):
+        await self.asgi_send({'type': 'websocket.close'})
+
+    async def send(self, message):
+        msg_bytes = None
+        msg_text = None
+        if isinstance(message, bytes):
+            msg_bytes = message
+        else:
+            msg_text = message
+        await self.asgi_send({'type': 'websocket.send',
+                              'bytes': msg_bytes,
+                              'text': msg_text})
+
+    async def wait(self):
+        event = await self.asgi_receive()
+        if event['type'] != 'websocket.receive':
+            raise IOError()
+        return event.get('bytes') or event.get('text')
+
+
+_async = {
+    'asyncio': True,
+    'translate_request': translate_request,
+    'make_response': make_response,
+    'websocket': sys.modules[__name__],
+    'websocket_class': 'WebSocket'
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_drivers/__init__.py b/openpype/vendor/python/python_2/engineio/async_drivers/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/vendor/python/python_2/engineio/async_drivers/aiohttp.py b/openpype/vendor/python/python_2/engineio/async_drivers/aiohttp.py
new file mode 100644
index 0000000000..ad6987649d
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_drivers/aiohttp.py
@@ -0,0 +1,128 @@
+import asyncio
+import sys
+from urllib.parse import urlsplit
+
+from aiohttp.web import Response, WebSocketResponse
+import six
+
+
+def create_route(app, engineio_server, engineio_endpoint):
+    """This function sets up the engine.io endpoint as a route for the
+    application.
+
+    Note that both GET and POST requests must be hooked up on the engine.io
+    endpoint.
+    """
+    app.router.add_get(engineio_endpoint, engineio_server.handle_request)
+    app.router.add_post(engineio_endpoint, engineio_server.handle_request)
+    app.router.add_route('OPTIONS', engineio_endpoint,
+                         engineio_server.handle_request)
+
+
+def translate_request(request):
+    """This function takes the arguments passed to the request handler and
+    uses them to generate a WSGI compatible environ dictionary.
+    """
+    message = request._message
+    payload = request._payload
+
+    uri_parts = urlsplit(message.path)
+    environ = {
+        'wsgi.input': payload,
+        'wsgi.errors': sys.stderr,
+        'wsgi.version': (1, 0),
+        'wsgi.async': True,
+        'wsgi.multithread': False,
+        'wsgi.multiprocess': False,
+        'wsgi.run_once': False,
+        'SERVER_SOFTWARE': 'aiohttp',
+        'REQUEST_METHOD': message.method,
+        'QUERY_STRING': uri_parts.query or '',
+        'RAW_URI': message.path,
+        'SERVER_PROTOCOL': 'HTTP/%s.%s' % message.version,
+        'REMOTE_ADDR': '127.0.0.1',
+        'REMOTE_PORT': '0',
+        'SERVER_NAME': 'aiohttp',
+        'SERVER_PORT': '0',
+        'aiohttp.request': request
+    }
+
+    for hdr_name, hdr_value in message.headers.items():
+        hdr_name = hdr_name.upper()
+        if hdr_name == 'CONTENT-TYPE':
+            environ['CONTENT_TYPE'] = hdr_value
+            continue
+        elif hdr_name == 'CONTENT-LENGTH':
+            environ['CONTENT_LENGTH'] = hdr_value
+            continue
+
+        key = 'HTTP_%s' % hdr_name.replace('-', '_')
+        if key in environ:
+            hdr_value = '%s,%s' % (environ[key], hdr_value)
+
+        environ[key] = hdr_value
+
+    environ['wsgi.url_scheme'] = environ.get('HTTP_X_FORWARDED_PROTO', 'http')
+
+    path_info = uri_parts.path
+
+    environ['PATH_INFO'] = path_info
+    environ['SCRIPT_NAME'] = ''
+
+    return environ
+
+
+def make_response(status, headers, payload, environ):
+    """This function generates an appropriate response object for this async
+    mode.
+    """
+    return Response(body=payload, status=int(status.split()[0]),
+                    headers=headers)
+
+
+class WebSocket(object):  # pragma: no cover
+    """
+    This wrapper class provides a aiohttp WebSocket interface that is
+    somewhat compatible with eventlet's implementation.
+    """
+    def __init__(self, handler):
+        self.handler = handler
+        self._sock = None
+
+    async def __call__(self, environ):
+        request = environ['aiohttp.request']
+        self._sock = WebSocketResponse()
+        await self._sock.prepare(request)
+
+        self.environ = environ
+        await self.handler(self)
+        return self._sock
+
+    async def close(self):
+        await self._sock.close()
+
+    async def send(self, message):
+        if isinstance(message, bytes):
+            f = self._sock.send_bytes
+        else:
+            f = self._sock.send_str
+        if asyncio.iscoroutinefunction(f):
+            await f(message)
+        else:
+            f(message)
+
+    async def wait(self):
+        msg = await self._sock.receive()
+        if not isinstance(msg.data, six.binary_type) and \
+                not isinstance(msg.data, six.text_type):
+            raise IOError()
+        return msg.data
+
+
+_async = {
+    'asyncio': True,
+    'create_route': create_route,
+    'translate_request': translate_request,
+    'make_response': make_response,
+    'websocket': WebSocket,
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_drivers/asgi.py b/openpype/vendor/python/python_2/engineio/async_drivers/asgi.py
new file mode 100644
index 0000000000..9f14ef05ff
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_drivers/asgi.py
@@ -0,0 +1,214 @@
+import os
+import sys
+
+from engineio.static_files import get_static_file
+
+
+class ASGIApp:
+    """ASGI application middleware for Engine.IO.
+
+    This middleware dispatches traffic to an Engine.IO application. It can
+    also serve a list of static files to the client, or forward unrelated
+    HTTP traffic to another ASGI application.
+
+    :param engineio_server: The Engine.IO server. Must be an instance of the
+                            ``engineio.AsyncServer`` class.
+    :param static_files: A dictionary with static file mapping rules. See the
+                         documentation for details on this argument.
+    :param other_asgi_app: A separate ASGI app that receives all other traffic.
+    :param engineio_path: The endpoint where the Engine.IO application should
+                          be installed. The default value is appropriate for
+                          most cases.
+
+    Example usage::
+
+        import engineio
+        import uvicorn
+
+        eio = engineio.AsyncServer()
+        app = engineio.ASGIApp(eio, static_files={
+            '/': {'content_type': 'text/html', 'filename': 'index.html'},
+            '/index.html': {'content_type': 'text/html',
+                            'filename': 'index.html'},
+        })
+        uvicorn.run(app, '127.0.0.1', 5000)
+    """
+    def __init__(self, engineio_server, other_asgi_app=None,
+                 static_files=None, engineio_path='engine.io'):
+        self.engineio_server = engineio_server
+        self.other_asgi_app = other_asgi_app
+        self.engineio_path = engineio_path.strip('/')
+        self.static_files = static_files or {}
+
+    async def __call__(self, scope, receive, send):
+        if scope['type'] in ['http', 'websocket'] and \
+                scope['path'].startswith('/{0}/'.format(self.engineio_path)):
+            await self.engineio_server.handle_request(scope, receive, send)
+        else:
+            static_file = get_static_file(scope['path'], self.static_files) \
+                if scope['type'] == 'http' and self.static_files else None
+            if static_file:
+                await self.serve_static_file(static_file, receive, send)
+            elif self.other_asgi_app is not None:
+                await self.other_asgi_app(scope, receive, send)
+            elif scope['type'] == 'lifespan':
+                await self.lifespan(receive, send)
+            else:
+                await self.not_found(receive, send)
+
+    async def serve_static_file(self, static_file, receive,
+                                send):  # pragma: no cover
+        event = await receive()
+        if event['type'] == 'http.request':
+            if os.path.exists(static_file['filename']):
+                with open(static_file['filename'], 'rb') as f:
+                    payload = f.read()
+                await send({'type': 'http.response.start',
+                            'status': 200,
+                            'headers': [(b'Content-Type', static_file[
+                                'content_type'].encode('utf-8'))]})
+                await send({'type': 'http.response.body',
+                            'body': payload})
+            else:
+                await self.not_found(receive, send)
+
+    async def lifespan(self, receive, send):
+        event = await receive()
+        if event['type'] == 'lifespan.startup':
+            await send({'type': 'lifespan.startup.complete'})
+        elif event['type'] == 'lifespan.shutdown':
+            await send({'type': 'lifespan.shutdown.complete'})
+
+    async def not_found(self, receive, send):
+        """Return a 404 Not Found error to the client."""
+        await send({'type': 'http.response.start',
+                    'status': 404,
+                    'headers': [(b'Content-Type', b'text/plain')]})
+        await send({'type': 'http.response.body',
+                    'body': b'Not Found'})
+
+
+async def translate_request(scope, receive, send):
+    class AwaitablePayload(object):  # pragma: no cover
+        def __init__(self, payload):
+            self.payload = payload or b''
+
+        async def read(self, length=None):
+            if length is None:
+                r = self.payload
+                self.payload = b''
+            else:
+                r = self.payload[:length]
+                self.payload = self.payload[length:]
+            return r
+
+    event = await receive()
+    payload = b''
+    if event['type'] == 'http.request':
+        payload += event.get('body') or b''
+        while event.get('more_body'):
+            event = await receive()
+            if event['type'] == 'http.request':
+                payload += event.get('body') or b''
+    elif event['type'] == 'websocket.connect':
+        await send({'type': 'websocket.accept'})
+    else:
+        return {}
+
+    raw_uri = scope['path'].encode('utf-8')
+    if 'query_string' in scope and scope['query_string']:
+        raw_uri += b'?' + scope['query_string']
+    environ = {
+        'wsgi.input': AwaitablePayload(payload),
+        'wsgi.errors': sys.stderr,
+        'wsgi.version': (1, 0),
+        'wsgi.async': True,
+        'wsgi.multithread': False,
+        'wsgi.multiprocess': False,
+        'wsgi.run_once': False,
+        'SERVER_SOFTWARE': 'asgi',
+        'REQUEST_METHOD': scope.get('method', 'GET'),
+        'PATH_INFO': scope['path'],
+        'QUERY_STRING': scope.get('query_string', b'').decode('utf-8'),
+        'RAW_URI': raw_uri.decode('utf-8'),
+        'SCRIPT_NAME': '',
+        'SERVER_PROTOCOL': 'HTTP/1.1',
+        'REMOTE_ADDR': '127.0.0.1',
+        'REMOTE_PORT': '0',
+        'SERVER_NAME': 'asgi',
+        'SERVER_PORT': '0',
+        'asgi.receive': receive,
+        'asgi.send': send,
+    }
+
+    for hdr_name, hdr_value in scope['headers']:
+        hdr_name = hdr_name.upper().decode('utf-8')
+        hdr_value = hdr_value.decode('utf-8')
+        if hdr_name == 'CONTENT-TYPE':
+            environ['CONTENT_TYPE'] = hdr_value
+            continue
+        elif hdr_name == 'CONTENT-LENGTH':
+            environ['CONTENT_LENGTH'] = hdr_value
+            continue
+
+        key = 'HTTP_%s' % hdr_name.replace('-', '_')
+        if key in environ:
+            hdr_value = '%s,%s' % (environ[key], hdr_value)
+
+        environ[key] = hdr_value
+
+    environ['wsgi.url_scheme'] = environ.get('HTTP_X_FORWARDED_PROTO', 'http')
+    return environ
+
+
+async def make_response(status, headers, payload, environ):
+    headers = [(h[0].encode('utf-8'), h[1].encode('utf-8')) for h in headers]
+    await environ['asgi.send']({'type': 'http.response.start',
+                                'status': int(status.split(' ')[0]),
+                                'headers': headers})
+    await environ['asgi.send']({'type': 'http.response.body',
+                                'body': payload})
+
+
+class WebSocket(object):  # pragma: no cover
+    """
+    This wrapper class provides an asgi WebSocket interface that is
+    somewhat compatible with eventlet's implementation.
+    """
+    def __init__(self, handler):
+        self.handler = handler
+        self.asgi_receive = None
+        self.asgi_send = None
+
+    async def __call__(self, environ):
+        self.asgi_receive = environ['asgi.receive']
+        self.asgi_send = environ['asgi.send']
+        await self.handler(self)
+
+    async def close(self):
+        await self.asgi_send({'type': 'websocket.close'})
+
+    async def send(self, message):
+        msg_bytes = None
+        msg_text = None
+        if isinstance(message, bytes):
+            msg_bytes = message
+        else:
+            msg_text = message
+        await self.asgi_send({'type': 'websocket.send',
+                              'bytes': msg_bytes,
+                              'text': msg_text})
+
+    async def wait(self):
+        event = await self.asgi_receive()
+        if event['type'] != 'websocket.receive':
+            raise IOError()
+        return event.get('bytes') or event.get('text')
+
+
+_async = {
+    'asyncio': True,
+    'translate_request': translate_request,
+    'make_response': make_response,
+    'websocket': WebSocket,
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_drivers/eventlet.py b/openpype/vendor/python/python_2/engineio/async_drivers/eventlet.py
new file mode 100644
index 0000000000..9be3797cd8
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_drivers/eventlet.py
@@ -0,0 +1,30 @@
+from __future__ import absolute_import
+
+from eventlet.green.threading import Thread, Event
+from eventlet import queue
+from eventlet import sleep
+from eventlet.websocket import WebSocketWSGI as _WebSocketWSGI
+
+
+class WebSocketWSGI(_WebSocketWSGI):
+    def __init__(self, *args, **kwargs):
+        super(WebSocketWSGI, self).__init__(*args, **kwargs)
+        self._sock = None
+
+    def __call__(self, environ, start_response):
+        if 'eventlet.input' not in environ:
+            raise RuntimeError('You need to use the eventlet server. '
+                               'See the Deployment section of the '
+                               'documentation for more information.')
+        self._sock = environ['eventlet.input'].get_socket()
+        return super(WebSocketWSGI, self).__call__(environ, start_response)
+
+
+_async = {
+    'thread': Thread,
+    'queue': queue.Queue,
+    'queue_empty': queue.Empty,
+    'event': Event,
+    'websocket': WebSocketWSGI,
+    'sleep': sleep,
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_drivers/gevent.py b/openpype/vendor/python/python_2/engineio/async_drivers/gevent.py
new file mode 100644
index 0000000000..024dd0aad5
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_drivers/gevent.py
@@ -0,0 +1,63 @@
+from __future__ import absolute_import
+
+import gevent
+from gevent import queue
+from gevent.event import Event
+try:
+    import geventwebsocket  # noqa
+    _websocket_available = True
+except ImportError:
+    _websocket_available = False
+
+
+class Thread(gevent.Greenlet):  # pragma: no cover
+    """
+    This wrapper class provides gevent Greenlet interface that is compatible
+    with the standard library's Thread class.
+    """
+    def __init__(self, target, args=[], kwargs={}):
+        super(Thread, self).__init__(target, *args, **kwargs)
+
+    def _run(self):
+        return self.run()
+
+
+class WebSocketWSGI(object):  # pragma: no cover
+    """
+    This wrapper class provides a gevent WebSocket interface that is
+    compatible with eventlet's implementation.
+    """
+    def __init__(self, app):
+        self.app = app
+
+    def __call__(self, environ, start_response):
+        if 'wsgi.websocket' not in environ:
+            raise RuntimeError('You need to use the gevent-websocket server. '
+                               'See the Deployment section of the '
+                               'documentation for more information.')
+        self._sock = environ['wsgi.websocket']
+        self.environ = environ
+        self.version = self._sock.version
+        self.path = self._sock.path
+        self.origin = self._sock.origin
+        self.protocol = self._sock.protocol
+        return self.app(self)
+
+    def close(self):
+        return self._sock.close()
+
+    def send(self, message):
+        return self._sock.send(message)
+
+    def wait(self):
+        return self._sock.receive()
+
+
+_async = {
+    'thread': Thread,
+    'queue': queue.JoinableQueue,
+    'queue_empty': queue.Empty,
+    'event': Event,
+    'websocket': WebSocketWSGI if _websocket_available else None,
+    'sleep': gevent.sleep,
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_drivers/gevent_uwsgi.py b/openpype/vendor/python/python_2/engineio/async_drivers/gevent_uwsgi.py
new file mode 100644
index 0000000000..07fa2a79df
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_drivers/gevent_uwsgi.py
@@ -0,0 +1,156 @@
+from __future__ import absolute_import
+
+import six
+
+import gevent
+from gevent import queue
+from gevent.event import Event
+import uwsgi
+_websocket_available = hasattr(uwsgi, 'websocket_handshake')
+
+
+class Thread(gevent.Greenlet):  # pragma: no cover
+    """
+    This wrapper class provides gevent Greenlet interface that is compatible
+    with the standard library's Thread class.
+    """
+    def __init__(self, target, args=[], kwargs={}):
+        super(Thread, self).__init__(target, *args, **kwargs)
+
+    def _run(self):
+        return self.run()
+
+
+class uWSGIWebSocket(object):  # pragma: no cover
+    """
+    This wrapper class provides a uWSGI WebSocket interface that is
+    compatible with eventlet's implementation.
+    """
+    def __init__(self, app):
+        self.app = app
+        self._sock = None
+
+    def __call__(self, environ, start_response):
+        self._sock = uwsgi.connection_fd()
+        self.environ = environ
+
+        uwsgi.websocket_handshake()
+
+        self._req_ctx = None
+        if hasattr(uwsgi, 'request_context'):
+            # uWSGI >= 2.1.x with support for api access across-greenlets
+            self._req_ctx = uwsgi.request_context()
+        else:
+            # use event and queue for sending messages
+            from gevent.event import Event
+            from gevent.queue import Queue
+            from gevent.select import select
+            self._event = Event()
+            self._send_queue = Queue()
+
+            # spawn a select greenlet
+            def select_greenlet_runner(fd, event):
+                """Sets event when data becomes available to read on fd."""
+                while True:
+                    event.set()
+                    try:
+                        select([fd], [], [])[0]
+                    except ValueError:
+                        break
+            self._select_greenlet = gevent.spawn(
+                select_greenlet_runner,
+                self._sock,
+                self._event)
+
+        self.app(self)
+
+    def close(self):
+        """Disconnects uWSGI from the client."""
+        uwsgi.disconnect()
+        if self._req_ctx is None:
+            # better kill it here in case wait() is not called again
+            self._select_greenlet.kill()
+            self._event.set()
+
+    def _send(self, msg):
+        """Transmits message either in binary or UTF-8 text mode,
+        depending on its type."""
+        if isinstance(msg, six.binary_type):
+            method = uwsgi.websocket_send_binary
+        else:
+            method = uwsgi.websocket_send
+        if self._req_ctx is not None:
+            method(msg, request_context=self._req_ctx)
+        else:
+            method(msg)
+
+    def _decode_received(self, msg):
+        """Returns either bytes or str, depending on message type."""
+        if not isinstance(msg, six.binary_type):
+            # already decoded - do nothing
+            return msg
+        # only decode from utf-8 if message is not binary data
+        type = six.byte2int(msg[0:1])
+        if type >= 48:  # no binary
+            return msg.decode('utf-8')
+        # binary message, don't try to decode
+        return msg
+
+    def send(self, msg):
+        """Queues a message for sending. Real transmission is done in
+        wait method.
+        Sends directly if uWSGI version is new enough."""
+        if self._req_ctx is not None:
+            self._send(msg)
+        else:
+            self._send_queue.put(msg)
+            self._event.set()
+
+    def wait(self):
+        """Waits and returns received messages.
+        If running in compatibility mode for older uWSGI versions,
+        it also sends messages that have been queued by send().
+        A return value of None means that connection was closed.
+        This must be called repeatedly. For uWSGI < 2.1.x it must
+        be called from the main greenlet."""
+        while True:
+            if self._req_ctx is not None:
+                try:
+                    msg = uwsgi.websocket_recv(request_context=self._req_ctx)
+                except IOError:  # connection closed
+                    return None
+                return self._decode_received(msg)
+            else:
+                # we wake up at least every 3 seconds to let uWSGI
+                # do its ping/ponging
+                event_set = self._event.wait(timeout=3)
+                if event_set:
+                    self._event.clear()
+                    # maybe there is something to send
+                    msgs = []
+                    while True:
+                        try:
+                            msgs.append(self._send_queue.get(block=False))
+                        except gevent.queue.Empty:
+                            break
+                    for msg in msgs:
+                        self._send(msg)
+                # maybe there is something to receive, if not, at least
+                # ensure uWSGI does its ping/ponging
+                try:
+                    msg = uwsgi.websocket_recv_nb()
+                except IOError:  # connection closed
+                    self._select_greenlet.kill()
+                    return None
+                if msg:  # message available
+                    return self._decode_received(msg)
+
+
+_async = {
+    'thread': Thread,
+    'queue': queue.JoinableQueue,
+    'queue_empty': queue.Empty,
+    'event': Event,
+    'websocket': uWSGIWebSocket if _websocket_available else None,
+    'sleep': gevent.sleep,
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_drivers/sanic.py b/openpype/vendor/python/python_2/engineio/async_drivers/sanic.py
new file mode 100644
index 0000000000..6929654b92
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_drivers/sanic.py
@@ -0,0 +1,144 @@
+import sys
+from urllib.parse import urlsplit
+
+from sanic.response import HTTPResponse
+try:
+    from sanic.websocket import WebSocketProtocol
+except ImportError:
+    # the installed version of sanic does not have websocket support
+    WebSocketProtocol = None
+import six
+
+
+def create_route(app, engineio_server, engineio_endpoint):
+    """This function sets up the engine.io endpoint as a route for the
+    application.
+
+    Note that both GET and POST requests must be hooked up on the engine.io
+    endpoint.
+    """
+    app.add_route(engineio_server.handle_request, engineio_endpoint,
+                  methods=['GET', 'POST', 'OPTIONS'])
+    try:
+        app.enable_websocket()
+    except AttributeError:
+        # ignore, this version does not support websocket
+        pass
+
+
+def translate_request(request):
+    """This function takes the arguments passed to the request handler and
+    uses them to generate a WSGI compatible environ dictionary.
+    """
+    class AwaitablePayload(object):
+        def __init__(self, payload):
+            self.payload = payload or b''
+
+        async def read(self, length=None):
+            if length is None:
+                r = self.payload
+                self.payload = b''
+            else:
+                r = self.payload[:length]
+                self.payload = self.payload[length:]
+            return r
+
+    uri_parts = urlsplit(request.url)
+    environ = {
+        'wsgi.input': AwaitablePayload(request.body),
+        'wsgi.errors': sys.stderr,
+        'wsgi.version': (1, 0),
+        'wsgi.async': True,
+        'wsgi.multithread': False,
+        'wsgi.multiprocess': False,
+        'wsgi.run_once': False,
+        'SERVER_SOFTWARE': 'sanic',
+        'REQUEST_METHOD': request.method,
+        'QUERY_STRING': uri_parts.query or '',
+        'RAW_URI': request.url,
+        'SERVER_PROTOCOL': 'HTTP/' + request.version,
+        'REMOTE_ADDR': '127.0.0.1',
+        'REMOTE_PORT': '0',
+        'SERVER_NAME': 'sanic',
+        'SERVER_PORT': '0',
+        'sanic.request': request
+    }
+
+    for hdr_name, hdr_value in request.headers.items():
+        hdr_name = hdr_name.upper()
+        if hdr_name == 'CONTENT-TYPE':
+            environ['CONTENT_TYPE'] = hdr_value
+            continue
+        elif hdr_name == 'CONTENT-LENGTH':
+            environ['CONTENT_LENGTH'] = hdr_value
+            continue
+
+        key = 'HTTP_%s' % hdr_name.replace('-', '_')
+        if key in environ:
+            hdr_value = '%s,%s' % (environ[key], hdr_value)
+
+        environ[key] = hdr_value
+
+    environ['wsgi.url_scheme'] = environ.get('HTTP_X_FORWARDED_PROTO', 'http')
+
+    path_info = uri_parts.path
+
+    environ['PATH_INFO'] = path_info
+    environ['SCRIPT_NAME'] = ''
+
+    return environ
+
+
+def make_response(status, headers, payload, environ):
+    """This function generates an appropriate response object for this async
+    mode.
+    """
+    headers_dict = {}
+    content_type = None
+    for h in headers:
+        if h[0].lower() == 'content-type':
+            content_type = h[1]
+        else:
+            headers_dict[h[0]] = h[1]
+    return HTTPResponse(body_bytes=payload, content_type=content_type,
+                        status=int(status.split()[0]), headers=headers_dict)
+
+
+class WebSocket(object):  # pragma: no cover
+    """
+    This wrapper class provides a sanic WebSocket interface that is
+    somewhat compatible with eventlet's implementation.
+    """
+    def __init__(self, handler):
+        self.handler = handler
+        self._sock = None
+
+    async def __call__(self, environ):
+        request = environ['sanic.request']
+        protocol = request.transport.get_protocol()
+        self._sock = await protocol.websocket_handshake(request)
+
+        self.environ = environ
+        await self.handler(self)
+
+    async def close(self):
+        await self._sock.close()
+
+    async def send(self, message):
+        await self._sock.send(message)
+
+    async def wait(self):
+        data = await self._sock.recv()
+        if not isinstance(data, six.binary_type) and \
+                not isinstance(data, six.text_type):
+            raise IOError()
+        return data
+
+
+_async = {
+    'asyncio': True,
+    'create_route': create_route,
+    'translate_request': translate_request,
+    'make_response': make_response,
+    'websocket': WebSocket if WebSocketProtocol else None,
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_drivers/threading.py b/openpype/vendor/python/python_2/engineio/async_drivers/threading.py
new file mode 100644
index 0000000000..9b53756681
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_drivers/threading.py
@@ -0,0 +1,17 @@
+from __future__ import absolute_import
+import threading
+import time
+
+try:
+    import queue
+except ImportError:  # pragma: no cover
+    import Queue as queue
+
+_async = {
+    'thread': threading.Thread,
+    'queue': queue.Queue,
+    'queue_empty': queue.Empty,
+    'event': threading.Event,
+    'websocket': None,
+    'sleep': time.sleep,
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_drivers/tornado.py b/openpype/vendor/python/python_2/engineio/async_drivers/tornado.py
new file mode 100644
index 0000000000..adfe18f5a2
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_drivers/tornado.py
@@ -0,0 +1,184 @@
+import asyncio
+import sys
+from urllib.parse import urlsplit
+from .. import exceptions
+
+import tornado.web
+import tornado.websocket
+import six
+
+
+def get_tornado_handler(engineio_server):
+    class Handler(tornado.websocket.WebSocketHandler):  # pragma: no cover
+        def __init__(self, *args, **kwargs):
+            super().__init__(*args, **kwargs)
+            if isinstance(engineio_server.cors_allowed_origins,
+                          six.string_types):
+                if engineio_server.cors_allowed_origins == '*':
+                    self.allowed_origins = None
+                else:
+                    self.allowed_origins = [
+                        engineio_server.cors_allowed_origins]
+            else:
+                self.allowed_origins = engineio_server.cors_allowed_origins
+            self.receive_queue = asyncio.Queue()
+
+        async def get(self, *args, **kwargs):
+            if self.request.headers.get('Upgrade', '').lower() == 'websocket':
+                ret = super().get(*args, **kwargs)
+                if asyncio.iscoroutine(ret):
+                    await ret
+            else:
+                await engineio_server.handle_request(self)
+
+        async def open(self, *args, **kwargs):
+            # this is the handler for the websocket request
+            asyncio.ensure_future(engineio_server.handle_request(self))
+
+        async def post(self, *args, **kwargs):
+            await engineio_server.handle_request(self)
+
+        async def options(self, *args, **kwargs):
+            await engineio_server.handle_request(self)
+
+        async def on_message(self, message):
+            await self.receive_queue.put(message)
+
+        async def get_next_message(self):
+            return await self.receive_queue.get()
+
+        def on_close(self):
+            self.receive_queue.put_nowait(None)
+
+        def check_origin(self, origin):
+            if self.allowed_origins is None or origin in self.allowed_origins:
+                return True
+            return super().check_origin(origin)
+
+        def get_compression_options(self):
+            # enable compression
+            return {}
+
+    return Handler
+
+
+def translate_request(handler):
+    """This function takes the arguments passed to the request handler and
+    uses them to generate a WSGI compatible environ dictionary.
+    """
+    class AwaitablePayload(object):
+        def __init__(self, payload):
+            self.payload = payload or b''
+
+        async def read(self, length=None):
+            if length is None:
+                r = self.payload
+                self.payload = b''
+            else:
+                r = self.payload[:length]
+                self.payload = self.payload[length:]
+            return r
+
+    payload = handler.request.body
+
+    uri_parts = urlsplit(handler.request.path)
+    full_uri = handler.request.path
+    if handler.request.query:  # pragma: no cover
+        full_uri += '?' + handler.request.query
+    environ = {
+        'wsgi.input': AwaitablePayload(payload),
+        'wsgi.errors': sys.stderr,
+        'wsgi.version': (1, 0),
+        'wsgi.async': True,
+        'wsgi.multithread': False,
+        'wsgi.multiprocess': False,
+        'wsgi.run_once': False,
+        'SERVER_SOFTWARE': 'aiohttp',
+        'REQUEST_METHOD': handler.request.method,
+        'QUERY_STRING': handler.request.query or '',
+        'RAW_URI': full_uri,
+        'SERVER_PROTOCOL': 'HTTP/%s' % handler.request.version,
+        'REMOTE_ADDR': '127.0.0.1',
+        'REMOTE_PORT': '0',
+        'SERVER_NAME': 'aiohttp',
+        'SERVER_PORT': '0',
+        'tornado.handler': handler
+    }
+
+    for hdr_name, hdr_value in handler.request.headers.items():
+        hdr_name = hdr_name.upper()
+        if hdr_name == 'CONTENT-TYPE':
+            environ['CONTENT_TYPE'] = hdr_value
+            continue
+        elif hdr_name == 'CONTENT-LENGTH':
+            environ['CONTENT_LENGTH'] = hdr_value
+            continue
+
+        key = 'HTTP_%s' % hdr_name.replace('-', '_')
+        environ[key] = hdr_value
+
+    environ['wsgi.url_scheme'] = environ.get('HTTP_X_FORWARDED_PROTO', 'http')
+
+    path_info = uri_parts.path
+
+    environ['PATH_INFO'] = path_info
+    environ['SCRIPT_NAME'] = ''
+
+    return environ
+
+
+def make_response(status, headers, payload, environ):
+    """This function generates an appropriate response object for this async
+    mode.
+    """
+    tornado_handler = environ['tornado.handler']
+    try:
+        tornado_handler.set_status(int(status.split()[0]))
+    except RuntimeError:  # pragma: no cover
+        # for websocket connections Tornado does not accept a response, since
+        # it already emitted the 101 status code
+        return
+    for header, value in headers:
+        tornado_handler.set_header(header, value)
+    tornado_handler.write(payload)
+    tornado_handler.finish()
+
+
+class WebSocket(object):  # pragma: no cover
+    """
+    This wrapper class provides a tornado WebSocket interface that is
+    somewhat compatible with eventlet's implementation.
+    """
+    def __init__(self, handler):
+        self.handler = handler
+        self.tornado_handler = None
+
+    async def __call__(self, environ):
+        self.tornado_handler = environ['tornado.handler']
+        self.environ = environ
+        await self.handler(self)
+
+    async def close(self):
+        self.tornado_handler.close()
+
+    async def send(self, message):
+        try:
+            self.tornado_handler.write_message(
+                message, binary=isinstance(message, bytes))
+        except tornado.websocket.WebSocketClosedError:
+            raise exceptions.EngineIOError()
+
+    async def wait(self):
+        msg = await self.tornado_handler.get_next_message()
+        if not isinstance(msg, six.binary_type) and \
+                not isinstance(msg, six.text_type):
+            raise IOError()
+        return msg
+
+
+_async = {
+    'asyncio': True,
+    'translate_request': translate_request,
+    'make_response': make_response,
+    'websocket': WebSocket,
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_eventlet.py b/openpype/vendor/python/python_2/engineio/async_eventlet.py
new file mode 100644
index 0000000000..042a67499b
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_eventlet.py
@@ -0,0 +1,30 @@
+import importlib
+import sys
+
+from eventlet import sleep
+from eventlet.websocket import WebSocketWSGI as _WebSocketWSGI
+
+
+class WebSocketWSGI(_WebSocketWSGI):
+    def __init__(self, *args, **kwargs):
+        super(WebSocketWSGI, self).__init__(*args, **kwargs)
+        self._sock = None
+
+    def __call__(self, environ, start_response):
+        if 'eventlet.input' not in environ:
+            raise RuntimeError('You need to use the eventlet server. '
+                               'See the Deployment section of the '
+                               'documentation for more information.')
+        self._sock = environ['eventlet.input'].get_socket()
+        return super(WebSocketWSGI, self).__call__(environ, start_response)
+
+
+_async = {
+    'threading': importlib.import_module('eventlet.green.threading'),
+    'thread_class': 'Thread',
+    'queue': importlib.import_module('eventlet.queue'),
+    'queue_class': 'Queue',
+    'websocket': sys.modules[__name__],
+    'websocket_class': 'WebSocketWSGI',
+    'sleep': sleep
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_gevent.py b/openpype/vendor/python/python_2/engineio/async_gevent.py
new file mode 100644
index 0000000000..34a9e43ce3
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_gevent.py
@@ -0,0 +1,63 @@
+import importlib
+import sys
+
+import gevent
+try:
+    import geventwebsocket  # noqa
+    _websocket_available = True
+except ImportError:
+    _websocket_available = False
+
+
+class Thread(gevent.Greenlet):  # pragma: no cover
+    """
+    This wrapper class provides gevent Greenlet interface that is compatible
+    with the standard library's Thread class.
+    """
+    def __init__(self, target, args=[], kwargs={}):
+        super(Thread, self).__init__(target, *args, **kwargs)
+
+    def _run(self):
+        return self.run()
+
+
+class WebSocketWSGI(object):  # pragma: no cover
+    """
+    This wrapper class provides a gevent WebSocket interface that is
+    compatible with eventlet's implementation.
+    """
+    def __init__(self, app):
+        self.app = app
+
+    def __call__(self, environ, start_response):
+        if 'wsgi.websocket' not in environ:
+            raise RuntimeError('You need to use the gevent-websocket server. '
+                               'See the Deployment section of the '
+                               'documentation for more information.')
+        self._sock = environ['wsgi.websocket']
+        self.environ = environ
+        self.version = self._sock.version
+        self.path = self._sock.path
+        self.origin = self._sock.origin
+        self.protocol = self._sock.protocol
+        return self.app(self)
+
+    def close(self):
+        return self._sock.close()
+
+    def send(self, message):
+        return self._sock.send(message)
+
+    def wait(self):
+        return self._sock.receive()
+
+
+_async = {
+    'threading': sys.modules[__name__],
+    'thread_class': 'Thread',
+    'queue': importlib.import_module('gevent.queue'),
+    'queue_class': 'JoinableQueue',
+    'websocket': sys.modules[__name__] if _websocket_available else None,
+    'websocket_class': 'WebSocketWSGI' if _websocket_available else None,
+    'sleep': gevent.sleep
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_gevent_uwsgi.py b/openpype/vendor/python/python_2/engineio/async_gevent_uwsgi.py
new file mode 100644
index 0000000000..d2d6983893
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_gevent_uwsgi.py
@@ -0,0 +1,155 @@
+import importlib
+import sys
+import six
+
+import gevent
+import uwsgi
+_websocket_available = hasattr(uwsgi, 'websocket_handshake')
+
+
+class Thread(gevent.Greenlet):  # pragma: no cover
+    """
+    This wrapper class provides gevent Greenlet interface that is compatible
+    with the standard library's Thread class.
+    """
+    def __init__(self, target, args=[], kwargs={}):
+        super(Thread, self).__init__(target, *args, **kwargs)
+
+    def _run(self):
+        return self.run()
+
+
+class uWSGIWebSocket(object):  # pragma: no cover
+    """
+    This wrapper class provides a uWSGI WebSocket interface that is
+    compatible with eventlet's implementation.
+    """
+    def __init__(self, app):
+        self.app = app
+        self._sock = None
+
+    def __call__(self, environ, start_response):
+        self._sock = uwsgi.connection_fd()
+        self.environ = environ
+
+        uwsgi.websocket_handshake()
+
+        self._req_ctx = None
+        if hasattr(uwsgi, 'request_context'):
+            # uWSGI >= 2.1.x with support for api access across-greenlets
+            self._req_ctx = uwsgi.request_context()
+        else:
+            # use event and queue for sending messages
+            from gevent.event import Event
+            from gevent.queue import Queue
+            from gevent.select import select
+            self._event = Event()
+            self._send_queue = Queue()
+
+            # spawn a select greenlet
+            def select_greenlet_runner(fd, event):
+                """Sets event when data becomes available to read on fd."""
+                while True:
+                    event.set()
+                    try:
+                        select([fd], [], [])[0]
+                    except ValueError:
+                        break
+            self._select_greenlet = gevent.spawn(
+                select_greenlet_runner,
+                self._sock,
+                self._event)
+
+        self.app(self)
+
+    def close(self):
+        """Disconnects uWSGI from the client."""
+        uwsgi.disconnect()
+        if self._req_ctx is None:
+            # better kill it here in case wait() is not called again
+            self._select_greenlet.kill()
+            self._event.set()
+
+    def _send(self, msg):
+        """Transmits message either in binary or UTF-8 text mode,
+        depending on its type."""
+        if isinstance(msg, six.binary_type):
+            method = uwsgi.websocket_send_binary
+        else:
+            method = uwsgi.websocket_send
+        if self._req_ctx is not None:
+            method(msg, request_context=self._req_ctx)
+        else:
+            method(msg)
+
+    def _decode_received(self, msg):
+        """Returns either bytes or str, depending on message type."""
+        if not isinstance(msg, six.binary_type):
+            # already decoded - do nothing
+            return msg
+        # only decode from utf-8 if message is not binary data
+        type = six.byte2int(msg[0:1])
+        if type >= 48:  # no binary
+            return msg.decode('utf-8')
+        # binary message, don't try to decode
+        return msg
+
+    def send(self, msg):
+        """Queues a message for sending. Real transmission is done in
+        wait method.
+        Sends directly if uWSGI version is new enough."""
+        if self._req_ctx is not None:
+            self._send(msg)
+        else:
+            self._send_queue.put(msg)
+            self._event.set()
+
+    def wait(self):
+        """Waits and returns received messages.
+        If running in compatibility mode for older uWSGI versions,
+        it also sends messages that have been queued by send().
+        A return value of None means that connection was closed.
+        This must be called repeatedly. For uWSGI < 2.1.x it must
+        be called from the main greenlet."""
+        while True:
+            if self._req_ctx is not None:
+                try:
+                    msg = uwsgi.websocket_recv(request_context=self._req_ctx)
+                except IOError:  # connection closed
+                    return None
+                return self._decode_received(msg)
+            else:
+                # we wake up at least every 3 seconds to let uWSGI
+                # do its ping/ponging
+                event_set = self._event.wait(timeout=3)
+                if event_set:
+                    self._event.clear()
+                    # maybe there is something to send
+                    msgs = []
+                    while True:
+                        try:
+                            msgs.append(self._send_queue.get(block=False))
+                        except gevent.queue.Empty:
+                            break
+                    for msg in msgs:
+                        self._send(msg)
+                # maybe there is something to receive, if not, at least
+                # ensure uWSGI does its ping/ponging
+                try:
+                    msg = uwsgi.websocket_recv_nb()
+                except IOError:  # connection closed
+                    self._select_greenlet.kill()
+                    return None
+                if msg:  # message available
+                    return self._decode_received(msg)
+
+
+_async = {
+    'threading': sys.modules[__name__],
+    'thread_class': 'Thread',
+    'queue': importlib.import_module('gevent.queue'),
+    'queue_class': 'JoinableQueue',
+    'websocket': sys.modules[__name__] if _websocket_available else None,
+    'websocket_class': 'uWSGIWebSocket' if _websocket_available else None,
+    'sleep': gevent.sleep
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_sanic.py b/openpype/vendor/python/python_2/engineio/async_sanic.py
new file mode 100644
index 0000000000..d150aac0e6
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_sanic.py
@@ -0,0 +1,145 @@
+import sys
+from urllib.parse import urlsplit
+
+from sanic.response import HTTPResponse
+try:
+    from sanic.websocket import WebSocketProtocol
+except ImportError:
+    # the installed version of sanic does not have websocket support
+    WebSocketProtocol = None
+import six
+
+
+def create_route(app, engineio_server, engineio_endpoint):
+    """This function sets up the engine.io endpoint as a route for the
+    application.
+
+    Note that both GET and POST requests must be hooked up on the engine.io
+    endpoint.
+    """
+    app.add_route(engineio_server.handle_request, engineio_endpoint,
+                  methods=['GET', 'POST', 'OPTIONS'])
+    try:
+        app.enable_websocket()
+    except AttributeError:
+        # ignore, this version does not support websocket
+        pass
+
+
+def translate_request(request):
+    """This function takes the arguments passed to the request handler and
+    uses them to generate a WSGI compatible environ dictionary.
+    """
+    class AwaitablePayload(object):
+        def __init__(self, payload):
+            self.payload = payload or b''
+
+        async def read(self, length=None):
+            if length is None:
+                r = self.payload
+                self.payload = b''
+            else:
+                r = self.payload[:length]
+                self.payload = self.payload[length:]
+            return r
+
+    uri_parts = urlsplit(request.url)
+    environ = {
+        'wsgi.input': AwaitablePayload(request.body),
+        'wsgi.errors': sys.stderr,
+        'wsgi.version': (1, 0),
+        'wsgi.async': True,
+        'wsgi.multithread': False,
+        'wsgi.multiprocess': False,
+        'wsgi.run_once': False,
+        'SERVER_SOFTWARE': 'sanic',
+        'REQUEST_METHOD': request.method,
+        'QUERY_STRING': uri_parts.query or '',
+        'RAW_URI': request.url,
+        'SERVER_PROTOCOL': 'HTTP/' + request.version,
+        'REMOTE_ADDR': '127.0.0.1',
+        'REMOTE_PORT': '0',
+        'SERVER_NAME': 'sanic',
+        'SERVER_PORT': '0',
+        'sanic.request': request
+    }
+
+    for hdr_name, hdr_value in request.headers.items():
+        hdr_name = hdr_name.upper()
+        if hdr_name == 'CONTENT-TYPE':
+            environ['CONTENT_TYPE'] = hdr_value
+            continue
+        elif hdr_name == 'CONTENT-LENGTH':
+            environ['CONTENT_LENGTH'] = hdr_value
+            continue
+
+        key = 'HTTP_%s' % hdr_name.replace('-', '_')
+        if key in environ:
+            hdr_value = '%s,%s' % (environ[key], hdr_value)
+
+        environ[key] = hdr_value
+
+    environ['wsgi.url_scheme'] = environ.get('HTTP_X_FORWARDED_PROTO', 'http')
+
+    path_info = uri_parts.path
+
+    environ['PATH_INFO'] = path_info
+    environ['SCRIPT_NAME'] = ''
+
+    return environ
+
+
+def make_response(status, headers, payload, environ):
+    """This function generates an appropriate response object for this async
+    mode.
+    """
+    headers_dict = {}
+    content_type = None
+    for h in headers:
+        if h[0].lower() == 'content-type':
+            content_type = h[1]
+        else:
+            headers_dict[h[0]] = h[1]
+    return HTTPResponse(body_bytes=payload, content_type=content_type,
+                        status=int(status.split()[0]), headers=headers_dict)
+
+
+class WebSocket(object):  # pragma: no cover
+    """
+    This wrapper class provides a sanic WebSocket interface that is
+    somewhat compatible with eventlet's implementation.
+    """
+    def __init__(self, handler):
+        self.handler = handler
+        self._sock = None
+
+    async def __call__(self, environ):
+        request = environ['sanic.request']
+        protocol = request.transport.get_protocol()
+        self._sock = await protocol.websocket_handshake(request)
+
+        self.environ = environ
+        await self.handler(self)
+
+    async def close(self):
+        await self._sock.close()
+
+    async def send(self, message):
+        await self._sock.send(message)
+
+    async def wait(self):
+        data = await self._sock.recv()
+        if not isinstance(data, six.binary_type) and \
+                not isinstance(data, six.text_type):
+            raise IOError()
+        return data
+
+
+_async = {
+    'asyncio': True,
+    'create_route': create_route,
+    'translate_request': translate_request,
+    'make_response': make_response,
+    'websocket': sys.modules[__name__] if WebSocketProtocol else None,
+    'websocket_class': 'WebSocket' if WebSocketProtocol else None
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_threading.py b/openpype/vendor/python/python_2/engineio/async_threading.py
new file mode 100644
index 0000000000..fb458b07af
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_threading.py
@@ -0,0 +1,17 @@
+import importlib
+import time
+
+try:
+    queue = importlib.import_module('queue')
+except ImportError:  # pragma: no cover
+    queue = importlib.import_module('Queue')  # pragma: no cover
+
+_async = {
+    'threading': importlib.import_module('threading'),
+    'thread_class': 'Thread',
+    'queue': queue,
+    'queue_class': 'Queue',
+    'websocket': None,
+    'websocket_class': None,
+    'sleep': time.sleep
+}
diff --git a/openpype/vendor/python/python_2/engineio/async_tornado.py b/openpype/vendor/python/python_2/engineio/async_tornado.py
new file mode 100644
index 0000000000..4b4f9c7572
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/async_tornado.py
@@ -0,0 +1,154 @@
+import asyncio
+import sys
+from urllib.parse import urlsplit
+
+try:
+    import tornado.web
+    import tornado.websocket
+except ImportError:  # pragma: no cover
+    pass
+import six
+
+
+def get_tornado_handler(engineio_server):
+    class Handler(tornado.websocket.WebSocketHandler):  # pragma: no cover
+        def __init__(self, *args, **kwargs):
+            super().__init__(*args, **kwargs)
+            self.receive_queue = asyncio.Queue()
+
+        async def get(self):
+            if self.request.headers.get('Upgrade', '').lower() == 'websocket':
+                super().get()
+            await engineio_server.handle_request(self)
+
+        async def post(self):
+            await engineio_server.handle_request(self)
+
+        async def options(self):
+            await engineio_server.handle_request(self)
+
+        async def on_message(self, message):
+            await self.receive_queue.put(message)
+
+        async def get_next_message(self):
+            return await self.receive_queue.get()
+
+        def on_close(self):
+            self.receive_queue.put_nowait(None)
+
+    return Handler
+
+
+def translate_request(handler):
+    """This function takes the arguments passed to the request handler and
+    uses them to generate a WSGI compatible environ dictionary.
+    """
+    class AwaitablePayload(object):
+        def __init__(self, payload):
+            self.payload = payload or b''
+
+        async def read(self, length=None):
+            if length is None:
+                r = self.payload
+                self.payload = b''
+            else:
+                r = self.payload[:length]
+                self.payload = self.payload[length:]
+            return r
+
+    payload = handler.request.body
+
+    uri_parts = urlsplit(handler.request.path)
+    full_uri = handler.request.path
+    if handler.request.query:  # pragma: no cover
+        full_uri += '?' + handler.request.query
+    environ = {
+        'wsgi.input': AwaitablePayload(payload),
+        'wsgi.errors': sys.stderr,
+        'wsgi.version': (1, 0),
+        'wsgi.async': True,
+        'wsgi.multithread': False,
+        'wsgi.multiprocess': False,
+        'wsgi.run_once': False,
+        'SERVER_SOFTWARE': 'aiohttp',
+        'REQUEST_METHOD': handler.request.method,
+        'QUERY_STRING': handler.request.query or '',
+        'RAW_URI': full_uri,
+        'SERVER_PROTOCOL': 'HTTP/%s' % handler.request.version,
+        'REMOTE_ADDR': '127.0.0.1',
+        'REMOTE_PORT': '0',
+        'SERVER_NAME': 'aiohttp',
+        'SERVER_PORT': '0',
+        'tornado.handler': handler
+    }
+
+    for hdr_name, hdr_value in handler.request.headers.items():
+        hdr_name = hdr_name.upper()
+        if hdr_name == 'CONTENT-TYPE':
+            environ['CONTENT_TYPE'] = hdr_value
+            continue
+        elif hdr_name == 'CONTENT-LENGTH':
+            environ['CONTENT_LENGTH'] = hdr_value
+            continue
+
+        key = 'HTTP_%s' % hdr_name.replace('-', '_')
+        environ[key] = hdr_value
+
+    environ['wsgi.url_scheme'] = environ.get('HTTP_X_FORWARDED_PROTO', 'http')
+
+    path_info = uri_parts.path
+
+    environ['PATH_INFO'] = path_info
+    environ['SCRIPT_NAME'] = ''
+
+    return environ
+
+
+def make_response(status, headers, payload, environ):
+    """This function generates an appropriate response object for this async
+    mode.
+    """
+    tornado_handler = environ['tornado.handler']
+    tornado_handler.set_status(int(status.split()[0]))
+    for header, value in headers:
+        tornado_handler.set_header(header, value)
+    tornado_handler.write(payload)
+    tornado_handler.finish()
+
+
+class WebSocket(object):  # pragma: no cover
+    """
+    This wrapper class provides a tornado WebSocket interface that is
+    somewhat compatible with eventlet's implementation.
+    """
+    def __init__(self, handler):
+        self.handler = handler
+        self.tornado_handler = None
+
+    async def __call__(self, environ):
+        self.tornado_handler = environ['tornado.handler']
+        self.environ = environ
+        await self.handler(self)
+
+    async def close(self):
+        self.tornado_handler.close()
+
+    async def send(self, message):
+        self.tornado_handler.write_message(
+            message, binary=isinstance(message, bytes))
+
+    async def wait(self):
+        msg = await self.tornado_handler.get_next_message()
+        if not isinstance(msg, six.binary_type) and \
+                not isinstance(msg, six.text_type):
+            raise IOError()
+        return msg
+
+
+_async = {
+    'asyncio': True,
+    'translate_request': translate_request,
+    'make_response': make_response,
+    'websocket': sys.modules[__name__],
+    'websocket_class': 'WebSocket'
+}
diff --git a/openpype/vendor/python/python_2/engineio/asyncio_client.py b/openpype/vendor/python/python_2/engineio/asyncio_client.py
new file mode 100644
index 0000000000..340cf278b7
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/asyncio_client.py
@@ -0,0 +1,556 @@
+import asyncio
+
+try:
+    import aiohttp
+except ImportError:  # pragma: no cover
+    aiohttp = None
+import six
+try:
+    import websockets
+except ImportError:  # pragma: no cover
+    websockets = None
+
+from . import client
+from . import exceptions
+from . import packet
+from . import payload
+
+
+class AsyncClient(client.Client):
+    """An Engine.IO client for asyncio.
+
+    This class implements a fully compliant Engine.IO web client with support
+    for websocket and long-polling transports, compatible with the asyncio
+    framework on Python 3.5 or newer.
+
+    :param logger: To enable logging set to ``True`` or pass a logger object to
+                   use. To disable logging set to ``False``. The default is
+                   ``False``.
+    :param json: An alternative json module to use for encoding and decoding
+                 packets. Custom json modules must have ``dumps`` and ``loads``
+                 functions that are compatible with the standard library
+                 versions.
+    """
+    def is_asyncio_based(self):
+        return True
+
+    async def connect(self, url, headers={}, transports=None,
+                      engineio_path='engine.io'):
+        """Connect to an Engine.IO server.
+
+        :param url: The URL of the Engine.IO server. It can include custom
+                    query string parameters if required by the server.
+        :param headers: A dictionary with custom headers to send with the
+                        connection request.
+        :param transports: The list of allowed transports. Valid transports
+                           are ``'polling'`` and ``'websocket'``. If not
+                           given, the polling transport is connected first,
+                           then an upgrade to websocket is attempted.
+        :param engineio_path: The endpoint where the Engine.IO server is
+                              installed. The default value is appropriate for
+                              most cases.
+
+        Note: this method is a coroutine.
+
+        Example usage::
+
+            eio = engineio.Client()
+            await eio.connect('http://localhost:5000')
+        """
+        if self.state != 'disconnected':
+            raise ValueError('Client is not in a disconnected state')
+        valid_transports = ['polling', 'websocket']
+        if transports is not None:
+            if isinstance(transports, six.text_type):
+                transports = [transports]
+            transports = [transport for transport in transports
+                          if transport in valid_transports]
+            if not transports:
+                raise ValueError('No valid transports provided')
+        self.transports = transports or valid_transports
+        self.queue = self.create_queue()
+        return await getattr(self, '_connect_' + self.transports[0])(
+            url, headers, engineio_path)
+
+    async def wait(self):
+        """Wait until the connection with the server ends.
+
+        Client applications can use this function to block the main thread
+        during the life of the connection.
+
+        Note: this method is a coroutine.
+        """
+        if self.read_loop_task:
+            await self.read_loop_task
+
+    async def send(self, data, binary=None):
+        """Send a message to a client.
+
+        :param data: The data to send to the client. Data can be of type
+                     ``str``, ``bytes``, ``list`` or ``dict``. If a ``list``
+                     or ``dict``, the data will be serialized as JSON.
+        :param binary: ``True`` to send packet as binary, ``False`` to send
+                       as text. If not given, unicode (Python 2) and str
+                       (Python 3) are sent as text, and str (Python 2) and
+                       bytes (Python 3) are sent as binary.
+
+        Note: this method is a coroutine.
+        """
+        await self._send_packet(packet.Packet(packet.MESSAGE, data=data,
+                                              binary=binary))
+
+    async def disconnect(self, abort=False):
+        """Disconnect from the server.
+
+        :param abort: If set to ``True``, do not wait for background tasks
+                      associated with the connection to end.
+
+        Note: this method is a coroutine.
+        """
+        if self.state == 'connected':
+            await self._send_packet(packet.Packet(packet.CLOSE))
+            await self.queue.put(None)
+            self.state = 'disconnecting'
+            await self._trigger_event('disconnect', run_async=False)
+            if self.current_transport == 'websocket':
+                await self.ws.close()
+            if not abort:
+                await self.read_loop_task
+            self.state = 'disconnected'
+            try:
+                client.connected_clients.remove(self)
+            except ValueError:  # pragma: no cover
+                pass
+        self._reset()
+
+    def start_background_task(self, target, *args, **kwargs):
+        """Start a background task.
+
+        This is a utility function that applications can use to start a
+        background task.
+
+        :param target: the target function to execute.
+        :param args: arguments to pass to the function.
+        :param kwargs: keyword arguments to pass to the function.
+
+        This function returns an object compatible with the `Thread` class in
+        the Python standard library. The `start()` method on this object is
+        already called by this function.
+
+        Note: this method is a coroutine.
+        """
+        return asyncio.ensure_future(target(*args, **kwargs))
+
+    async def sleep(self, seconds=0):
+        """Sleep for the requested amount of time.
+
+        Note: this method is a coroutine.
+        """
+        return await asyncio.sleep(seconds)
+
+    def create_queue(self):
+        """Create a queue object."""
+        q = asyncio.Queue()
+        q.Empty = asyncio.QueueEmpty
+        return q
+
+    def create_event(self):
+        """Create an event object."""
+        return asyncio.Event()
+
+    def _reset(self):
+        if self.http:  # pragma: no cover
+            asyncio.ensure_future(self.http.close())
+        super()._reset()
+
+    async def _connect_polling(self, url, headers, engineio_path):
+        """Establish a long-polling connection to the Engine.IO server."""
+        if aiohttp is None:  # pragma: no cover
+            self.logger.error('aiohttp not installed -- cannot make HTTP '
+                              'requests!')
+            return
+        self.base_url = self._get_engineio_url(url, engineio_path, 'polling')
+        self.logger.info('Attempting polling connection to ' + self.base_url)
+        r = await self._send_request(
+            'GET', self.base_url + self._get_url_timestamp(), headers=headers)
+        if r is None:
+            self._reset()
+            raise exceptions.ConnectionError(
+                'Connection refused by the server')
+        if r.status != 200:
+            raise exceptions.ConnectionError(
+                'Unexpected status code {} in server response'.format(
+                    r.status))
+        try:
+            p = payload.Payload(encoded_payload=await r.read())
+        except ValueError:
+            six.raise_from(exceptions.ConnectionError(
+                'Unexpected response from server'), None)
+        open_packet = p.packets[0]
+        if open_packet.packet_type != packet.OPEN:
+            raise exceptions.ConnectionError(
+                'OPEN packet not returned by server')
+        self.logger.info(
+            'Polling connection accepted with ' + str(open_packet.data))
+        self.sid = open_packet.data['sid']
+        self.upgrades = open_packet.data['upgrades']
+        self.ping_interval = open_packet.data['pingInterval'] / 1000.0
+        self.ping_timeout = open_packet.data['pingTimeout'] / 1000.0
+        self.current_transport = 'polling'
+        self.base_url += '&sid=' + self.sid
+
+        self.state = 'connected'
+        client.connected_clients.append(self)
+        await self._trigger_event('connect', run_async=False)
+
+        for pkt in p.packets[1:]:
+            await self._receive_packet(pkt)
+
+        if 'websocket' in self.upgrades and 'websocket' in self.transports:
+            # attempt to upgrade to websocket
+            if await self._connect_websocket(url, headers, engineio_path):
+                # upgrade to websocket succeeded, we're done here
+                return
+
+        self.ping_loop_task = self.start_background_task(self._ping_loop)
+        self.write_loop_task = self.start_background_task(self._write_loop)
+        self.read_loop_task = self.start_background_task(
+            self._read_loop_polling)
+
+    async def _connect_websocket(self, url, headers, engineio_path):
+        """Establish or upgrade to a WebSocket connection with the server."""
+        if websockets is None:  # pragma: no cover
+            self.logger.error('websockets package not installed')
+            return False
+        websocket_url = self._get_engineio_url(url, engineio_path,
+                                               'websocket')
+        if self.sid:
+            self.logger.info(
+                'Attempting WebSocket upgrade to ' + websocket_url)
+            upgrade = True
+            websocket_url += '&sid=' + self.sid
+        else:
+            upgrade = False
+            self.base_url = websocket_url
+            self.logger.info(
+                'Attempting WebSocket connection to ' + websocket_url)
+
+        # get the cookies from the long-polling connection so that they can
+        # also be sent the the WebSocket route
+        cookies = None
+        if self.http:
+            cookies = '; '.join(["{}={}".format(cookie.key, cookie.value)
+                                 for cookie in self.http._cookie_jar])
+            headers = headers.copy()
+            headers['Cookie'] = cookies
+
+        try:
+            ws = await websockets.connect(
+                websocket_url + self._get_url_timestamp(),
+                extra_headers=headers)
+        except (websockets.exceptions.InvalidURI,
+                websockets.exceptions.InvalidHandshake):
+            if upgrade:
+                self.logger.warning(
+                    'WebSocket upgrade failed: connection error')
+                return False
+            else:
+                raise exceptions.ConnectionError('Connection error')
+        if upgrade:
+            p = packet.Packet(packet.PING, data='probe').encode(
+                always_bytes=False)
+            try:
+                await ws.send(p)
+            except Exception as e:  # pragma: no cover
+                self.logger.warning(
+                    'WebSocket upgrade failed: unexpected send exception: %s',
+                    str(e))
+                return False
+            try:
+                p = await ws.recv()
+            except Exception as e:  # pragma: no cover
+                self.logger.warning(
+                    'WebSocket upgrade failed: unexpected recv exception: %s',
+                    str(e))
+                return False
+            pkt = packet.Packet(encoded_packet=p)
+            if pkt.packet_type != packet.PONG or pkt.data != 'probe':
+                self.logger.warning(
+                    'WebSocket upgrade failed: no PONG packet')
+                return False
+            p = packet.Packet(packet.UPGRADE).encode(always_bytes=False)
+            try:
+                await ws.send(p)
+            except Exception as e:  # pragma: no cover
+                self.logger.warning(
+                    'WebSocket upgrade failed: unexpected send exception: %s',
+                    str(e))
+                return False
+            self.current_transport = 'websocket'
+            if self.http:  # pragma: no cover
+                await self.http.close()
+            self.logger.info('WebSocket upgrade was successful')
+        else:
+            try:
+                p = await ws.recv()
+            except Exception as e:  # pragma: no cover
+                raise exceptions.ConnectionError(
+                    'Unexpected recv exception: ' + str(e))
+            open_packet = packet.Packet(encoded_packet=p)
+            if open_packet.packet_type != packet.OPEN:
+                raise exceptions.ConnectionError('no OPEN packet')
+            self.logger.info(
+                'WebSocket connection accepted with ' + str(open_packet.data))
+            self.sid = open_packet.data['sid']
+            self.upgrades = open_packet.data['upgrades']
+            self.ping_interval = open_packet.data['pingInterval'] / 1000.0
+            self.ping_timeout = open_packet.data['pingTimeout'] / 1000.0
+            self.current_transport = 'websocket'
+
+            self.state = 'connected'
+            client.connected_clients.append(self)
+            await self._trigger_event('connect', run_async=False)
+
+        self.ws = ws
+        self.ping_loop_task = self.start_background_task(self._ping_loop)
+        self.write_loop_task = self.start_background_task(self._write_loop)
+        self.read_loop_task = self.start_background_task(
+            self._read_loop_websocket)
+        return True
+
+    async def _receive_packet(self, pkt):
+        """Handle incoming packets from the server."""
+        packet_name = packet.packet_names[pkt.packet_type] \
+            if pkt.packet_type < len(packet.packet_names) else 'UNKNOWN'
+        self.logger.info(
+            'Received packet %s data %s', packet_name,
+            pkt.data if not isinstance(pkt.data, bytes) else '<binary>')
+        if pkt.packet_type == packet.MESSAGE:
+            await self._trigger_event('message', pkt.data, run_async=True)
+        elif pkt.packet_type == packet.PONG:
+            self.pong_received = True
+        elif pkt.packet_type == packet.CLOSE:
+            await self.disconnect(abort=True)
+        elif pkt.packet_type == packet.NOOP:
+            pass
+        else:
+            self.logger.error('Received unexpected packet of type %s',
+                              pkt.packet_type)
+
+    async def _send_packet(self, pkt):
+        """Queue a packet to be sent to the server."""
+        if self.state != 'connected':
+            return
+        await self.queue.put(pkt)
+        self.logger.info(
+            'Sending packet %s data %s',
+            packet.packet_names[pkt.packet_type],
+            pkt.data if not isinstance(pkt.data, bytes) else '<binary>')
+
+    async def _send_request(
+            self, method, url, headers=None, body=None):  # pragma: no cover
+        if self.http is None or self.http.closed:
+            self.http = aiohttp.ClientSession()
+        method = getattr(self.http, method.lower())
+        try:
+            return await method(url, headers=headers, data=body)
+        except aiohttp.ClientError:
+            return
+
+    async def _trigger_event(self, event, *args, **kwargs):
+        """Invoke an event handler."""
+        run_async = kwargs.pop('run_async', False)
+        ret = None
+        if event in self.handlers:
+            if asyncio.iscoroutinefunction(self.handlers[event]) is True:
+                if run_async:
+                    return self.start_background_task(self.handlers[event],
+                                                      *args)
+                else:
+                    try:
+                        ret = await self.handlers[event](*args)
+                    except asyncio.CancelledError:  # pragma: no cover
+                        pass
+                    except:
+                        self.logger.exception(event + ' async handler error')
+                        if event == 'connect':
+                            # if connect handler raised error we reject the
+                            # connection
+                            return False
+            else:
+                if run_async:
+                    async def async_handler():
+                        return self.handlers[event](*args)
+
+                    return self.start_background_task(async_handler)
+                else:
+                    try:
+                        ret = self.handlers[event](*args)
+                    except:
+                        self.logger.exception(event + ' handler error')
+                        if event == 'connect':
+                            # if connect handler raised error we reject the
+                            # connection
+                            return False
+        return ret
+
+    async def _ping_loop(self):
+        """This background task sends a PING to the server at the requested
+        interval.
+        """
+        self.pong_received = True
+        self.ping_loop_event.clear()
+        while self.state == 'connected':
+            if not self.pong_received:
+                self.logger.info(
+                    'PONG response has not been received, aborting')
+                if self.ws:
+                    await self.ws.close()
+                await self.queue.put(None)
+                break
+            self.pong_received = False
+            await self._send_packet(packet.Packet(packet.PING))
+            try:
+                await asyncio.wait_for(self.ping_loop_event.wait(),
+                                       self.ping_interval)
+            except (asyncio.TimeoutError,
+                    asyncio.CancelledError):  # pragma: no cover
+                pass
+        self.logger.info('Exiting ping task')
+
+    async def _read_loop_polling(self):
+        """Read packets by polling the Engine.IO server."""
+        while self.state == 'connected':
+            self.logger.info(
+                'Sending polling GET request to ' + self.base_url)
+            r = await self._send_request(
+                'GET', self.base_url + self._get_url_timestamp())
+            if r is None:
+                self.logger.warning(
+                    'Connection refused by the server, aborting')
+                await self.queue.put(None)
+                break
+            if r.status != 200:
+                self.logger.warning('Unexpected status code %s in server '
+                                    'response, aborting', r.status)
+                await self.queue.put(None)
+                break
+            try:
+                p = payload.Payload(encoded_payload=await r.read())
+            except ValueError:
+                self.logger.warning(
+                    'Unexpected packet from server, aborting')
+                await self.queue.put(None)
+                break
+            for pkt in p.packets:
+                await self._receive_packet(pkt)
+
+        self.logger.info('Waiting for write loop task to end')
+        await self.write_loop_task
+        self.logger.info('Waiting for ping loop task to end')
+        self.ping_loop_event.set()
+        await self.ping_loop_task
+        if self.state == 'connected':
+            await self._trigger_event('disconnect', run_async=False)
+            try:
+                client.connected_clients.remove(self)
+            except ValueError:  # pragma: no cover
+                pass
+            self._reset()
+        self.logger.info('Exiting read loop task')
+
+    async def _read_loop_websocket(self):
+        """Read packets from the Engine.IO WebSocket connection."""
+        while self.state == 'connected':
+            p = None
+            try:
+                p = await self.ws.recv()
+            except websockets.exceptions.ConnectionClosed:
+                self.logger.info(
+                    'Read loop: WebSocket connection was closed, aborting')
+                await self.queue.put(None)
+                break
+            except Exception as e:
+                self.logger.info(
+                    'Unexpected error "%s", aborting', str(e))
+                await self.queue.put(None)
+                break
+            if isinstance(p, six.text_type):  # pragma: no cover
+                p = p.encode('utf-8')
+            pkt = packet.Packet(encoded_packet=p)
+            await self._receive_packet(pkt)
+
+        self.logger.info('Waiting for write loop task to end')
+        await self.write_loop_task
+        self.logger.info('Waiting for ping loop task to end')
+        self.ping_loop_event.set()
+        await self.ping_loop_task
+        if self.state == 'connected':
+            await self._trigger_event('disconnect', run_async=False)
+            try:
+                client.connected_clients.remove(self)
+            except ValueError:  # pragma: no cover
+                pass
+            self._reset()
+        self.logger.info('Exiting read loop task')
+
+    async def _write_loop(self):
+        """This background task sends packages to the server as they are
+        pushed to the send queue.
+        """
+        while self.state == 'connected':
+            # to simplify the timeout handling, use the maximum of the
+            # ping interval and ping timeout as timeout, with an extra 5
+            # seconds grace period
+            timeout = max(self.ping_interval, self.ping_timeout) + 5
+            packets = None
+            try:
+                packets = [await asyncio.wait_for(self.queue.get(), timeout)]
+            except (self.queue.Empty, asyncio.TimeoutError,
+                    asyncio.CancelledError):
+                self.logger.error('packet queue is empty, aborting')
+                break
+            if packets == [None]:
+                self.queue.task_done()
+                packets = []
+            else:
+                while True:
+                    try:
+                        packets.append(self.queue.get_nowait())
+                    except self.queue.Empty:
+                        break
+                    if packets[-1] is None:
+                        packets = packets[:-1]
+                        self.queue.task_done()
+                        break
+            if not packets:
+                # empty packet list returned -> connection closed
+                break
+            if self.current_transport == 'polling':
+                p = payload.Payload(packets=packets)
+                r = await self._send_request(
+                    'POST', self.base_url, body=p.encode(),
+                    headers={'Content-Type': 'application/octet-stream'})
+                for pkt in packets:
+                    self.queue.task_done()
+                if r is None:
+                    self.logger.warning(
+                        'Connection refused by the server, aborting')
+                    break
+                if r.status != 200:
+                    self.logger.warning('Unexpected status code %s in server '
+                                        'response, aborting', r.status)
+                    self._reset()
+                    break
+            else:
+                # websocket
+                try:
+                    for pkt in packets:
+                        await self.ws.send(pkt.encode(always_bytes=False))
+                        self.queue.task_done()
+                except websockets.exceptions.ConnectionClosed:
+                    self.logger.info(
+                        'Write loop: WebSocket connection was closed, '
+                        'aborting')
+                    break
+        self.logger.info('Exiting write loop task')
diff --git a/openpype/vendor/python/python_2/engineio/asyncio_server.py b/openpype/vendor/python/python_2/engineio/asyncio_server.py
new file mode 100644
index 0000000000..cc5ed8007c
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/asyncio_server.py
@@ -0,0 +1,444 @@
+import asyncio
+
+import six
+from six.moves import urllib
+
+from . import exceptions
+from . import packet
+from . import server
+from . import asyncio_socket
+
+
+class AsyncServer(server.Server):
+    """An Engine.IO server for asyncio.
+
+    This class implements a fully compliant Engine.IO web server with support
+    for websocket and long-polling transports, compatible with the asyncio
+    framework on Python 3.5 or newer.
+
+    :param async_mode: The asynchronous model to use. See the Deployment
+                       section in the documentation for a description of the
+                       available options. Valid async modes are "aiohttp",
+                       "sanic", "tornado" and "asgi". If this argument is not
+                       given, "aiohttp" is tried first, followed by "sanic",
+                       "tornado", and finally "asgi". The first async mode that
+                       has all its dependencies installed is the one that is
+                       chosen.
+    :param ping_timeout: The time in seconds that the client waits for the
+                         server to respond before disconnecting.
+    :param ping_interval: The interval in seconds at which the client pings
+                          the server.
+    :param max_http_buffer_size: The maximum size of a message when using the
+                                 polling transport.
+    :param allow_upgrades: Whether to allow transport upgrades or not.
+    :param http_compression: Whether to compress packages when using the
+                             polling transport.
+    :param compression_threshold: Only compress messages when their byte size
+                                  is greater than this value.
+    :param cookie: Name of the HTTP cookie that contains the client session
+                   id. If set to ``None``, a cookie is not sent to the client.
+    :param cors_allowed_origins: List of origins that are allowed to connect
+                                 to this server. All origins are allowed by
+                                 default.
+    :param cors_credentials: Whether credentials (cookies, authentication) are
+                             allowed in requests to this server.
+    :param logger: To enable logging set to ``True`` or pass a logger object to
+                   use. To disable logging set to ``False``.
+    :param json: An alternative json module to use for encoding and decoding
+                 packets. Custom json modules must have ``dumps`` and ``loads``
+                 functions that are compatible with the standard library
+                 versions.
+    :param async_handlers: If set to ``True``, run message event handlers in
+                           non-blocking threads. To run handlers synchronously,
+                           set to ``False``. The default is ``True``.
+    :param kwargs: Reserved for future extensions, any additional parameters
+                   given as keyword arguments will be silently ignored.
+    """
+    def is_asyncio_based(self):
+        return True
+
+    def async_modes(self):
+        return ['aiohttp', 'sanic', 'tornado', 'asgi']
+
+    def attach(self, app, engineio_path='engine.io'):
+        """Attach the Engine.IO server to an application."""
+        engineio_path = engineio_path.strip('/')
+        self._async['create_route'](app, self, '/{}/'.format(engineio_path))
+
+    async def send(self, sid, data, binary=None):
+        """Send a message to a client.
+
+        :param sid: The session id of the recipient client.
+        :param data: The data to send to the client. Data can be of type
+                     ``str``, ``bytes``, ``list`` or ``dict``. If a ``list``
+                     or ``dict``, the data will be serialized as JSON.
+        :param binary: ``True`` to send packet as binary, ``False`` to send
+                       as text. If not given, unicode (Python 2) and str
+                       (Python 3) are sent as text, and str (Python 2) and
+                       bytes (Python 3) are sent as binary.
+
+        Note: this method is a coroutine.
+        """
+        try:
+            socket = self._get_socket(sid)
+        except KeyError:
+            # the socket is not available
+            self.logger.warning('Cannot send to sid %s', sid)
+            return
+        await socket.send(packet.Packet(packet.MESSAGE, data=data,
+                                        binary=binary))
+
+    async def get_session(self, sid):
+        """Return the user session for a client.
+
+        :param sid: The session id of the client.
+
+        The return value is a dictionary. Modifications made to this
+        dictionary are not guaranteed to be preserved. If you want to modify
+        the user session, use the ``session`` context manager instead.
+        """
+        socket = self._get_socket(sid)
+        return socket.session
+
+    async def save_session(self, sid, session):
+        """Store the user session for a client.
+
+        :param sid: The session id of the client.
+        :param session: The session dictionary.
+        """
+        socket = self._get_socket(sid)
+        socket.session = session
+
+    def session(self, sid):
+        """Return the user session for a client with context manager syntax.
+
+        :param sid: The session id of the client.
+
+        This is a context manager that returns the user session dictionary for
+        the client. Any changes that are made to this dictionary inside the
+        context manager block are saved back to the session. Example usage::
+
+            @eio.on('connect')
+            def on_connect(sid, environ):
+                username = authenticate_user(environ)
+                if not username:
+                    return False
+                with eio.session(sid) as session:
+                    session['username'] = username
+
+            @eio.on('message')
+            def on_message(sid, msg):
+                async with eio.session(sid) as session:
+                    print('received message from ', session['username'])
+        """
+        class _session_context_manager(object):
+            def __init__(self, server, sid):
+                self.server = server
+                self.sid = sid
+                self.session = None
+
+            async def __aenter__(self):
+                self.session = await self.server.get_session(sid)
+                return self.session
+
+            async def __aexit__(self, *args):
+                await self.server.save_session(sid, self.session)
+
+        return _session_context_manager(self, sid)
+
+    async def disconnect(self, sid=None):
+        """Disconnect a client.
+
+        :param sid: The session id of the client to close. If this parameter
+                    is not given, then all clients are closed.
+
+        Note: this method is a coroutine.
+        """
+        if sid is not None:
+            try:
+                socket = self._get_socket(sid)
+            except KeyError:  # pragma: no cover
+                # the socket was already closed or gone
+                pass
+            else:
+                await socket.close()
+                del self.sockets[sid]
+        else:
+            await asyncio.wait([client.close()
+                                for client in six.itervalues(self.sockets)])
+            self.sockets = {}
+
+    async def handle_request(self, *args, **kwargs):
+        """Handle an HTTP request from the client.
+
+        This is the entry point of the Engine.IO application. This function
+        returns the HTTP response to deliver to the client.
+
+        Note: this method is a coroutine.
+        """
+        translate_request = self._async['translate_request']
+        if asyncio.iscoroutinefunction(translate_request):
+            environ = await translate_request(*args, **kwargs)
+        else:
+            environ = translate_request(*args, **kwargs)
+        method = environ['REQUEST_METHOD']
+        query = urllib.parse.parse_qs(environ.get('QUERY_STRING', ''))
+
+        sid = query['sid'][0] if 'sid' in query else None
+        b64 = False
+        jsonp = False
+        jsonp_index = None
+
+        if 'b64' in query:
+            if query['b64'][0] == "1" or query['b64'][0].lower() == "true":
+                b64 = True
+        if 'j' in query:
+            jsonp = True
+            try:
+                jsonp_index = int(query['j'][0])
+            except (ValueError, KeyError, IndexError):
+                # Invalid JSONP index number
+                pass
+
+        if jsonp and jsonp_index is None:
+            self.logger.warning('Invalid JSONP index number')
+            r = self._bad_request()
+        elif method == 'GET':
+            if sid is None:
+                transport = query.get('transport', ['polling'])[0]
+                if transport != 'polling' and transport != 'websocket':
+                    self.logger.warning('Invalid transport %s', transport)
+                    r = self._bad_request()
+                else:
+                    r = await self._handle_connect(environ, transport,
+                                                   b64, jsonp_index)
+            else:
+                if sid not in self.sockets:
+                    self.logger.warning('Invalid session %s', sid)
+                    r = self._bad_request()
+                else:
+                    socket = self._get_socket(sid)
+                    try:
+                        packets = await socket.handle_get_request(environ)
+                        if isinstance(packets, list):
+                            r = self._ok(packets, b64=b64,
+                                         jsonp_index=jsonp_index)
+                        else:
+                            r = packets
+                    except exceptions.EngineIOError:
+                        if sid in self.sockets:  # pragma: no cover
+                            await self.disconnect(sid)
+                        r = self._bad_request()
+                    if sid in self.sockets and self.sockets[sid].closed:
+                        del self.sockets[sid]
+        elif method == 'POST':
+            if sid is None or sid not in self.sockets:
+                self.logger.warning('Invalid session %s', sid)
+                r = self._bad_request()
+            else:
+                socket = self._get_socket(sid)
+                try:
+                    await socket.handle_post_request(environ)
+                    r = self._ok(jsonp_index=jsonp_index)
+                except exceptions.EngineIOError:
+                    if sid in self.sockets:  # pragma: no cover
+                        await self.disconnect(sid)
+                    r = self._bad_request()
+                except:  # pragma: no cover
+                    # for any other unexpected errors, we log the error
+                    # and keep going
+                    self.logger.exception('post request handler error')
+                    r = self._ok(jsonp_index=jsonp_index)
+        elif method == 'OPTIONS':
+            r = self._ok()
+        else:
+            self.logger.warning('Method %s not supported', method)
+            r = self._method_not_found()
+        if not isinstance(r, dict):
+            return r
+        if self.http_compression and \
+                len(r['response']) >= self.compression_threshold:
+            encodings = [e.split(';')[0].strip() for e in
+                         environ.get('HTTP_ACCEPT_ENCODING', '').split(',')]
+            for encoding in encodings:
+                if encoding in self.compression_methods:
+                    r['response'] = \
+                        getattr(self, '_' + encoding)(r['response'])
+                    r['headers'] += [('Content-Encoding', encoding)]
+                    break
+        cors_headers = self._cors_headers(environ)
+        make_response = self._async['make_response']
+        if asyncio.iscoroutinefunction(make_response):
+            response = await make_response(r['status'],
+                                           r['headers'] + cors_headers,
+                                           r['response'], environ)
+        else:
+            response = make_response(r['status'], r['headers'] + cors_headers,
+                                     r['response'], environ)
+        return response
+
+    def start_background_task(self, target, *args, **kwargs):
+        """Start a background task using the appropriate async model.
+
+        This is a utility function that applications can use to start a
+        background task using the method that is compatible with the
+        selected async mode.
+
+        :param target: the target function to execute.
+        :param args: arguments to pass to the function.
+        :param kwargs: keyword arguments to pass to the function.
+
+        The return value is a ``asyncio.Task`` object.
+        """
+        return asyncio.ensure_future(target(*args, **kwargs))
+
+    async def sleep(self, seconds=0):
+        """Sleep for the requested amount of time using the appropriate async
+        model.
+
+        This is a utility function that applications can use to put a task to
+        sleep without having to worry about using the correct call for the
+        selected async mode.
+
+        Note: this method is a coroutine.
+        """
+        return await asyncio.sleep(seconds)
+
+    def create_queue(self, *args, **kwargs):
+        """Create a queue object using the appropriate async model.
+
+        This is a utility function that applications can use to create a queue
+        without having to worry about using the correct call for the selected
+        async mode. For asyncio based async modes, this returns an instance of
+        ``asyncio.Queue``.
+        """
+        return asyncio.Queue(*args, **kwargs)
+
+    def get_queue_empty_exception(self):
+        """Return the queue empty exception for the appropriate async model.
+
+        This is a utility function that applications can use to work with a
+        queue without having to worry about using the correct call for the
+        selected async mode. For asyncio based async modes, this returns an
+        instance of ``asyncio.QueueEmpty``.
+        """
+        return asyncio.QueueEmpty
+
+    def create_event(self, *args, **kwargs):
+        """Create an event object using the appropriate async model.
+
+        This is a utility function that applications can use to create an
+        event without having to worry about using the correct call for the
+        selected async mode. For asyncio based async modes, this returns
+        an instance of ``asyncio.Event``.
+        """
+        return asyncio.Event(*args, **kwargs)
+
+    async def _handle_connect(self, environ, transport, b64=False,
+                              jsonp_index=None):
+        """Handle a client connection request."""
+        if self.start_service_task:
+            # start the service task to monitor connected clients
+            self.start_service_task = False
+            self.start_background_task(self._service_task)
+
+        sid = self._generate_id()
+        s = asyncio_socket.AsyncSocket(self, sid)
+        self.sockets[sid] = s
+
+        pkt = packet.Packet(
+            packet.OPEN, {'sid': sid,
+                          'upgrades': self._upgrades(sid, transport),
+                          'pingTimeout': int(self.ping_timeout * 1000),
+                          'pingInterval': int(self.ping_interval * 1000)})
+        await s.send(pkt)
+
+        ret = await self._trigger_event('connect', sid, environ,
+                                        run_async=False)
+        if ret is False:
+            del self.sockets[sid]
+            self.logger.warning('Application rejected connection')
+            return self._unauthorized()
+
+        if transport == 'websocket':
+            ret = await s.handle_get_request(environ)
+            if s.closed:
+                # websocket connection ended, so we are done
+                del self.sockets[sid]
+            return ret
+        else:
+            s.connected = True
+            headers = None
+            if self.cookie:
+                headers = [('Set-Cookie', self.cookie + '=' + sid)]
+            try:
+                return self._ok(await s.poll(), headers=headers, b64=b64,
+                                jsonp_index=jsonp_index)
+            except exceptions.QueueEmpty:
+                return self._bad_request()
+
+    async def _trigger_event(self, event, *args, **kwargs):
+        """Invoke an event handler."""
+        run_async = kwargs.pop('run_async', False)
+        ret = None
+        if event in self.handlers:
+            if asyncio.iscoroutinefunction(self.handlers[event]) is True:
+                if run_async:
+                    return self.start_background_task(self.handlers[event],
+                                                      *args)
+                else:
+                    try:
+                        ret = await self.handlers[event](*args)
+                    except asyncio.CancelledError:  # pragma: no cover
+                        pass
+                    except:
+                        self.logger.exception(event + ' async handler error')
+                        if event == 'connect':
+                            # if connect handler raised error we reject the
+                            # connection
+                            return False
+            else:
+                if run_async:
+                    async def async_handler():
+                        return self.handlers[event](*args)
+
+                    return self.start_background_task(async_handler)
+                else:
+                    try:
+                        ret = self.handlers[event](*args)
+                    except:
+                        self.logger.exception(event + ' handler error')
+                        if event == 'connect':
+                            # if connect handler raised error we reject the
+                            # connection
+                            return False
+        return ret
+
+    async def _service_task(self):  # pragma: no cover
+        """Monitor connected clients and clean up those that time out."""
+        while True:
+            if len(self.sockets) == 0:
+                # nothing to do
+                await self.sleep(self.ping_timeout)
+                continue
+
+            # go through the entire client list in a ping interval cycle
+            sleep_interval = self.ping_timeout / len(self.sockets)
+
+            try:
+                # iterate over the current clients
+                for socket in self.sockets.copy().values():
+                    if not socket.closing and not socket.closed:
+                        await socket.check_ping_timeout()
+                    await self.sleep(sleep_interval)
+            except (SystemExit, KeyboardInterrupt, asyncio.CancelledError):
+                self.logger.info('service task canceled')
+                break
+            except:
+                if asyncio.get_event_loop().is_closed():
+                    self.logger.info('event loop is closed, exiting service '
+                                     'task')
+                    break
+
+                # an unexpected exception has occurred, log it and continue
+                self.logger.exception('service task exception')
diff --git a/openpype/vendor/python/python_2/engineio/asyncio_socket.py b/openpype/vendor/python/python_2/engineio/asyncio_socket.py
new file mode 100644
index 0000000000..c4afcfe309
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/asyncio_socket.py
@@ -0,0 +1,235 @@
+import asyncio
+import six
+import sys
+import time
+
+from . import exceptions
+from . import packet
+from . import payload
+from . import socket
+
+
+class AsyncSocket(socket.Socket):
+    async def poll(self):
+        """Wait for packets to send to the client."""
+        try:
+            packets = [await asyncio.wait_for(self.queue.get(),
+                                              self.server.ping_timeout)]
+            self.queue.task_done()
+        except (asyncio.TimeoutError, asyncio.CancelledError):
+            raise exceptions.QueueEmpty()
+        if packets == [None]:
+            return []
+        try:
+            packets.append(self.queue.get_nowait())
+            self.queue.task_done()
+        except asyncio.QueueEmpty:
+            pass
+        return packets
+
+    async def receive(self, pkt):
+        """Receive packet from the client."""
+        self.server.logger.info('%s: Received packet %s data %s',
+                                self.sid, packet.packet_names[pkt.packet_type],
+                                pkt.data if not isinstance(pkt.data, bytes)
+                                else '<binary>')
+        if pkt.packet_type == packet.PING:
+            self.last_ping = time.time()
+            await self.send(packet.Packet(packet.PONG, pkt.data))
+        elif pkt.packet_type == packet.MESSAGE:
+            await self.server._trigger_event(
+                'message', self.sid, pkt.data,
+                run_async=self.server.async_handlers)
+        elif pkt.packet_type == packet.UPGRADE:
+            await self.send(packet.Packet(packet.NOOP))
+        elif pkt.packet_type == packet.CLOSE:
+            await self.close(wait=False, abort=True)
+        else:
+            raise exceptions.UnknownPacketError()
+
+    async def check_ping_timeout(self):
+        """Make sure the client is still sending pings.
+
+        This helps detect disconnections for long-polling clients.
+        """
+        if self.closed:
+            raise exceptions.SocketIsClosedError()
+        if time.time() - self.last_ping > self.server.ping_interval + 5:
+            self.server.logger.info('%s: Client is gone, closing socket',
+                                    self.sid)
+            # Passing abort=False here will cause close() to write a
+            # CLOSE packet. This has the effect of updating half-open sockets
+            # to their correct state of disconnected
+            await self.close(wait=False, abort=False)
+            return False
+        return True
+
+    async def send(self, pkt):
+        """Send a packet to the client."""
+        if not await self.check_ping_timeout():
+            return
+        if self.upgrading:
+            self.packet_backlog.append(pkt)
+        else:
+            await self.queue.put(pkt)
+        self.server.logger.info('%s: Sending packet %s data %s',
+                                self.sid, packet.packet_names[pkt.packet_type],
+                                pkt.data if not isinstance(pkt.data, bytes)
+                                else '<binary>')
+
+    async def handle_get_request(self, environ):
+        """Handle a long-polling GET request from the client."""
+        connections = [
+            s.strip()
+            for s in environ.get('HTTP_CONNECTION', '').lower().split(',')]
+        transport = environ.get('HTTP_UPGRADE', '').lower()
+        if 'upgrade' in connections and transport in self.upgrade_protocols:
+            self.server.logger.info('%s: Received request to upgrade to %s',
+                                    self.sid, transport)
+            return await getattr(self, '_upgrade_' + transport)(environ)
+        try:
+            packets = await self.poll()
+        except exceptions.QueueEmpty:
+            exc = sys.exc_info()
+            await self.close(wait=False)
+            six.reraise(*exc)
+        return packets
+
+    async def handle_post_request(self, environ):
+        """Handle a long-polling POST request from the client."""
+        length = int(environ.get('CONTENT_LENGTH', '0'))
+        if length > self.server.max_http_buffer_size:
+            raise exceptions.ContentTooLongError()
+        else:
+            body = await environ['wsgi.input'].read(length)
+            p = payload.Payload(encoded_payload=body)
+            for pkt in p.packets:
+                await self.receive(pkt)
+
+    async def close(self, wait=True, abort=False):
+        """Close the socket connection."""
+        if not self.closed and not self.closing:
+            self.closing = True
+            await self.server._trigger_event('disconnect', self.sid)
+            if not abort:
+                await self.send(packet.Packet(packet.CLOSE))
+            self.closed = True
+            if wait:
+                await self.queue.join()
+
+    async def _upgrade_websocket(self, environ):
+        """Upgrade the connection from polling to websocket."""
+        if self.upgraded:
+            raise IOError('Socket has been upgraded already')
+        if self.server._async['websocket'] is None:
+            # the selected async mode does not support websocket
+            return self.server._bad_request()
+        ws = self.server._async['websocket'](self._websocket_handler)
+        return await ws(environ)
+
+    async def _websocket_handler(self, ws):
+        """Engine.IO handler for websocket transport."""
+        if self.connected:
+            # the socket was already connected, so this is an upgrade
+            self.upgrading = True  # hold packet sends during the upgrade
+
+            try:
+                pkt = await ws.wait()
+            except IOError:  # pragma: no cover
+                return
+            decoded_pkt = packet.Packet(encoded_packet=pkt)
+            if decoded_pkt.packet_type != packet.PING or \
+                    decoded_pkt.data != 'probe':
+                self.server.logger.info(
+                    '%s: Failed websocket upgrade, no PING packet', self.sid)
+                return
+            await ws.send(packet.Packet(
+                packet.PONG,
+                data=six.text_type('probe')).encode(always_bytes=False))
+            await self.queue.put(packet.Packet(packet.NOOP))  # end poll
+
+            try:
+                pkt = await ws.wait()
+            except IOError:  # pragma: no cover
+                return
+            decoded_pkt = packet.Packet(encoded_packet=pkt)
+            if decoded_pkt.packet_type != packet.UPGRADE:
+                self.upgraded = False
+                self.server.logger.info(
+                    ('%s: Failed websocket upgrade, expected UPGRADE packet, '
+                     'received %s instead.'),
+                    self.sid, pkt)
+                return
+            self.upgraded = True
+
+            # flush any packets that were sent during the upgrade
+            for pkt in self.packet_backlog:
+                await self.queue.put(pkt)
+            self.packet_backlog = []
+            self.upgrading = False
+        else:
+            self.connected = True
+            self.upgraded = True
+
+        # start separate writer thread
+        async def writer():
+            while True:
+                packets = None
+                try:
+                    packets = await self.poll()
+                except exceptions.QueueEmpty:
+                    break
+                if not packets:
+                    # empty packet list returned -> connection closed
+                    break
+                try:
+                    for pkt in packets:
+                        await ws.send(pkt.encode(always_bytes=False))
+                except:
+                    break
+        writer_task = asyncio.ensure_future(writer())
+
+        self.server.logger.info(
+            '%s: Upgrade to websocket successful', self.sid)
+
+        while True:
+            p = None
+            wait_task = asyncio.ensure_future(ws.wait())
+            try:
+                p = await asyncio.wait_for(wait_task, self.server.ping_timeout)
+            except asyncio.CancelledError:  # pragma: no cover
+                # there is a bug (https://bugs.python.org/issue30508) in
+                # asyncio that causes a "Task exception never retrieved" error
+                # to appear when wait_task raises an exception before it gets
+                # cancelled. Calling wait_task.exception() prevents the error
+                # from being issued in Python 3.6, but causes other errors in
+                # other versions, so we run it with all errors suppressed and
+                # hope for the best.
+                try:
+                    wait_task.exception()
+                except:
+                    pass
+                break
+            except:
+                break
+            if p is None:
+                # connection closed by client
+                break
+            if isinstance(p, six.text_type):  # pragma: no cover
+                p = p.encode('utf-8')
+            pkt = packet.Packet(encoded_packet=p)
+            try:
+                await self.receive(pkt)
+            except exceptions.UnknownPacketError:  # pragma: no cover
+                pass
+            except exceptions.SocketIsClosedError:  # pragma: no cover
+                self.server.logger.info('Receive error -- socket is closed')
+                break
+            except:  # pragma: no cover
+                # if we get an unexpected exception we log the error and exit
+                # the connection properly
+                self.server.logger.exception('Unknown receive error')
+
+        await self.queue.put(None)  # unlock the writer task so it can exit
+        await asyncio.wait_for(writer_task, timeout=None)
+        await self.close(wait=False, abort=True)
diff --git a/openpype/vendor/python/python_2/engineio/client.py b/openpype/vendor/python/python_2/engineio/client.py
new file mode 100644
index 0000000000..16dcc94e63
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/client.py
@@ -0,0 +1,641 @@
+import logging
+try:
+    import queue
+except ImportError:  # pragma: no cover
+    import Queue as queue
+import signal
+import threading
+import time
+
+import six
+from six.moves import urllib
+try:
+    import requests
+except ImportError:  # pragma: no cover
+    requests = None
+try:
+    import websocket
+except ImportError:  # pragma: no cover
+    websocket = None
+from . import exceptions
+from . import packet
+from . import payload
+
+default_logger = logging.getLogger('engineio.client')
+connected_clients = []
+
+if six.PY2:  # pragma: no cover
+    ConnectionError = OSError
+
+
+def signal_handler(sig, frame):
+    """SIGINT handler.
+
+    Disconnect all active clients and then invoke the original signal handler.
+    """
+    for client in connected_clients[:]:
+        if client.is_asyncio_based():
+            client.start_background_task(client.disconnect, abort=True)
+        else:
+            client.disconnect(abort=True)
+    return original_signal_handler(sig, frame)
+
+
+original_signal_handler = signal.signal(signal.SIGINT, signal_handler)
+
+
+class Client(object):
+    """An Engine.IO client.
+
+    This class implements a fully compliant Engine.IO web client with support
+    for websocket and long-polling transports.
+
+    :param logger: To enable logging set to ``True`` or pass a logger object to
+                   use. To disable logging set to ``False``. The default is
+                   ``False``.
+    :param json: An alternative json module to use for encoding and decoding
+                 packets. Custom json modules must have ``dumps`` and ``loads``
+                 functions that are compatible with the standard library
+                 versions.
+    """
+    event_names = ['connect', 'disconnect', 'message']
+
+    def __init__(self, logger=False, json=None):
+        self.handlers = {}
+        self.base_url = None
+        self.transports = None
+        self.current_transport = None
+        self.sid = None
+        self.upgrades = None
+        self.ping_interval = None
+        self.ping_timeout = None
+        self.pong_received = True
+        self.http = None
+        self.ws = None
+        self.read_loop_task = None
+        self.write_loop_task = None
+        self.ping_loop_task = None
+        self.ping_loop_event = self.create_event()
+        self.queue = None
+        self.state = 'disconnected'
+
+        if json is not None:
+            packet.Packet.json = json
+        if not isinstance(logger, bool):
+            self.logger = logger
+        else:
+            self.logger = default_logger
+            if not logging.root.handlers and \
+                    self.logger.level == logging.NOTSET:
+                if logger:
+                    self.logger.setLevel(logging.INFO)
+                else:
+                    self.logger.setLevel(logging.ERROR)
+                self.logger.addHandler(logging.StreamHandler())
+
+    def is_asyncio_based(self):
+        return False
+
+    def on(self, event, handler=None):
+        """Register an event handler.
+
+        :param event: The event name. Can be ``'connect'``, ``'message'`` or
+                      ``'disconnect'``.
+        :param handler: The function that should be invoked to handle the
+                        event. When this parameter is not given, the method
+                        acts as a decorator for the handler function.
+
+        Example usage::
+
+            # as a decorator:
+            @eio.on('connect')
+            def connect_handler():
+                print('Connection request')
+
+            # as a method:
+            def message_handler(msg):
+                print('Received message: ', msg)
+                eio.send('response')
+            eio.on('message', message_handler)
+        """
+        if event not in self.event_names:
+            raise ValueError('Invalid event')
+
+        def set_handler(handler):
+            self.handlers[event] = handler
+            return handler
+
+        if handler is None:
+            return set_handler
+        set_handler(handler)
+
+    def connect(self, url, headers={}, transports=None,
+                engineio_path='engine.io'):
+        """Connect to an Engine.IO server.
+
+        :param url: The URL of the Engine.IO server. It can include custom
+                    query string parameters if required by the server.
+        :param headers: A dictionary with custom headers to send with the
+                        connection request.
+        :param transports: The list of allowed transports. Valid transports
+                           are ``'polling'`` and ``'websocket'``. If not
+                           given, the polling transport is connected first,
+                           then an upgrade to websocket is attempted.
+        :param engineio_path: The endpoint where the Engine.IO server is
+                              installed. The default value is appropriate for
+                              most cases.
+
+        Example usage::
+
+            eio = engineio.Client()
+            eio.connect('http://localhost:5000')
+        """
+        if self.state != 'disconnected':
+            raise ValueError('Client is not in a disconnected state')
+        valid_transports = ['polling', 'websocket']
+        if transports is not None:
+            if isinstance(transports, six.string_types):
+                transports = [transports]
+            transports = [transport for transport in transports
+                          if transport in valid_transports]
+            if not transports:
+                raise ValueError('No valid transports provided')
+        self.transports = transports or valid_transports
+        self.queue = self.create_queue()
+        return getattr(self, '_connect_' + self.transports[0])(
+            url, headers, engineio_path)
+
+    def wait(self):
+        """Wait until the connection with the server ends.
+
+        Client applications can use this function to block the main thread
+        during the life of the connection.
+        """
+        if self.read_loop_task:
+            self.read_loop_task.join()
+
+    def send(self, data, binary=None):
+        """Send a message to a client.
+
+        :param data: The data to send to the client. Data can be of type
+                     ``str``, ``bytes``, ``list`` or ``dict``. If a ``list``
+                     or ``dict``, the data will be serialized as JSON.
+        :param binary: ``True`` to send packet as binary, ``False`` to send
+                       as text. If not given, unicode (Python 2) and str
+                       (Python 3) are sent as text, and str (Python 2) and
+                       bytes (Python 3) are sent as binary.
+        """
+        self._send_packet(packet.Packet(packet.MESSAGE, data=data,
+                                        binary=binary))
+
+    def disconnect(self, abort=False):
+        """Disconnect from the server.
+
+        :param abort: If set to ``True``, do not wait for background tasks
+                      associated with the connection to end.
+        """
+        if self.state == 'connected':
+            self._send_packet(packet.Packet(packet.CLOSE))
+            self.queue.put(None)
+            self.state = 'disconnecting'
+            self._trigger_event('disconnect', run_async=False)
+            if self.current_transport == 'websocket':
+                self.ws.close()
+            if not abort:
+                self.read_loop_task.join()
+            self.state = 'disconnected'
+            try:
+                connected_clients.remove(self)
+            except ValueError:  # pragma: no cover
+                pass
+        self._reset()
+
+    def transport(self):
+        """Return the name of the transport currently in use.
+
+        The possible values returned by this function are ``'polling'`` and
+        ``'websocket'``.
+        """
+        return self.current_transport
+
+    def start_background_task(self, target, *args, **kwargs):
+        """Start a background task.
+
+        This is a utility function that applications can use to start a
+        background task.
+
+        :param target: the target function to execute.
+        :param args: arguments to pass to the function.
+        :param kwargs: keyword arguments to pass to the function.
+
+        This function returns an object compatible with the `Thread` class in
+        the Python standard library. The `start()` method on this object is
+        already called by this function.
+        """
+        th = threading.Thread(target=target, args=args, kwargs=kwargs)
+        th.start()
+        return th
+
+    def sleep(self, seconds=0):
+        """Sleep for the requested amount of time."""
+        return time.sleep(seconds)
+
+    def create_queue(self, *args, **kwargs):
+        """Create a queue object."""
+        q = queue.Queue(*args, **kwargs)
+        q.Empty = queue.Empty
+        return q
+
+    def create_event(self, *args, **kwargs):
+        """Create an event object."""
+        return threading.Event(*args, **kwargs)
+
+    def _reset(self):
+        self.state = 'disconnected'
+        self.sid = None
+
+    def _connect_polling(self, url, headers, engineio_path):
+        """Establish a long-polling connection to the Engine.IO server."""
+        if requests is None:  # pragma: no cover
+            # not installed
+            self.logger.error('requests package is not installed -- cannot '
+                              'send HTTP requests!')
+            return
+        self.base_url = self._get_engineio_url(url, engineio_path, 'polling')
+        self.logger.info('Attempting polling connection to ' + self.base_url)
+        r = self._send_request(
+            'GET', self.base_url + self._get_url_timestamp(), headers=headers)
+        if r is None:
+            self._reset()
+            raise exceptions.ConnectionError(
+                'Connection refused by the server')
+        if r.status_code != 200:
+            raise exceptions.ConnectionError(
+                'Unexpected status code {} in server response'.format(
+                    r.status_code))
+        try:
+            p = payload.Payload(encoded_payload=r.content)
+        except ValueError:
+            six.raise_from(exceptions.ConnectionError(
+                'Unexpected response from server'), None)
+        open_packet = p.packets[0]
+        if open_packet.packet_type != packet.OPEN:
+            raise exceptions.ConnectionError(
+                'OPEN packet not returned by server')
+        self.logger.info(
+            'Polling connection accepted with ' + str(open_packet.data))
+        self.sid = open_packet.data['sid']
+        self.upgrades = open_packet.data['upgrades']
+        self.ping_interval = open_packet.data['pingInterval'] / 1000.0
+        self.ping_timeout = open_packet.data['pingTimeout'] / 1000.0
+        self.current_transport = 'polling'
+        self.base_url += '&sid=' + self.sid
+
+        self.state = 'connected'
+        connected_clients.append(self)
+        self._trigger_event('connect', run_async=False)
+
+        for pkt in p.packets[1:]:
+            self._receive_packet(pkt)
+
+        if 'websocket' in self.upgrades and 'websocket' in self.transports:
+            # attempt to upgrade to websocket
+            if self._connect_websocket(url, headers, engineio_path):
+                # upgrade to websocket succeeded, we're done here
+                return
+
+        # start background tasks associated with this client
+        self.ping_loop_task = self.start_background_task(self._ping_loop)
+        self.write_loop_task = self.start_background_task(self._write_loop)
+        self.read_loop_task = self.start_background_task(
+            self._read_loop_polling)
+
+    def _connect_websocket(self, url, headers, engineio_path):
+        """Establish or upgrade to a WebSocket connection with the server."""
+        if websocket is None:  # pragma: no cover
+            # not installed
+            self.logger.warning('websocket-client package not installed, only '
+                                'polling transport is available')
+            return False
+        websocket_url = self._get_engineio_url(url, engineio_path, 'websocket')
+        if self.sid:
+            self.logger.info(
+                'Attempting WebSocket upgrade to ' + websocket_url)
+            upgrade = True
+            websocket_url += '&sid=' + self.sid
+        else:
+            upgrade = False
+            self.base_url = websocket_url
+            self.logger.info(
+                'Attempting WebSocket connection to ' + websocket_url)
+
+        # get the cookies from the long-polling connection so that they can
+        # also be sent the the WebSocket route
+        cookies = None
+        if self.http:
+            cookies = '; '.join(["{}={}".format(cookie.name, cookie.value)
+                                 for cookie in self.http.cookies])
+        try:
+            ws = websocket.create_connection(
+                websocket_url + self._get_url_timestamp(), header=headers,
+                cookie=cookies)
+        except ConnectionError:
+            if upgrade:
+                self.logger.warning(
+                    'WebSocket upgrade failed: connection error')
+                return False
+            else:
+                raise exceptions.ConnectionError('Connection error')
+        if upgrade:
+            p = packet.Packet(packet.PING,
+                              data=six.text_type('probe')).encode()
+            try:
+                ws.send(p)
+            except Exception as e:  # pragma: no cover
+                self.logger.warning(
+                    'WebSocket upgrade failed: unexpected send exception: %s',
+                    str(e))
+                return False
+            try:
+                p = ws.recv()
+            except Exception as e:  # pragma: no cover
+                self.logger.warning(
+                    'WebSocket upgrade failed: unexpected recv exception: %s',
+                    str(e))
+                return False
+            pkt = packet.Packet(encoded_packet=p)
+            if pkt.packet_type != packet.PONG or pkt.data != 'probe':
+                self.logger.warning(
+                    'WebSocket upgrade failed: no PONG packet')
+                return False
+            p = packet.Packet(packet.UPGRADE).encode()
+            try:
+                ws.send(p)
+            except Exception as e:  # pragma: no cover
+                self.logger.warning(
+                    'WebSocket upgrade failed: unexpected send exception: %s',
+                    str(e))
+                return False
+            self.current_transport = 'websocket'
+            self.logger.info('WebSocket upgrade was successful')
+        else:
+            try:
+                p = ws.recv()
+            except Exception as e:  # pragma: no cover
+                raise exceptions.ConnectionError(
+                    'Unexpected recv exception: ' + str(e))
+            open_packet = packet.Packet(encoded_packet=p)
+            if open_packet.packet_type != packet.OPEN:
+                raise exceptions.ConnectionError('no OPEN packet')
+            self.logger.info(
+                'WebSocket connection accepted with ' + str(open_packet.data))
+            self.sid = open_packet.data['sid']
+            self.upgrades = open_packet.data['upgrades']
+            self.ping_interval = open_packet.data['pingInterval'] / 1000.0
+            self.ping_timeout = open_packet.data['pingTimeout'] / 1000.0
+            self.current_transport = 'websocket'
+
+            self.state = 'connected'
+            connected_clients.append(self)
+            self._trigger_event('connect', run_async=False)
+        self.ws = ws
+
+        # start background tasks associated with this client
+        self.ping_loop_task = self.start_background_task(self._ping_loop)
+        self.write_loop_task = self.start_background_task(self._write_loop)
+        self.read_loop_task = self.start_background_task(
+            self._read_loop_websocket)
+        return True
+
+    def _receive_packet(self, pkt):
+        """Handle incoming packets from the server."""
+        packet_name = packet.packet_names[pkt.packet_type] \
+            if pkt.packet_type < len(packet.packet_names) else 'UNKNOWN'
+        self.logger.info(
+            'Received packet %s data %s', packet_name,
+            pkt.data if not isinstance(pkt.data, bytes) else '<binary>')
+        if pkt.packet_type == packet.MESSAGE:
+            self._trigger_event('message', pkt.data, run_async=True)
+        elif pkt.packet_type == packet.PONG:
+            self.pong_received = True
+        elif pkt.packet_type == packet.CLOSE:
+            self.disconnect(abort=True)
+        elif pkt.packet_type == packet.NOOP:
+            pass
+        else:
+            self.logger.error('Received unexpected packet of type %s',
+                              pkt.packet_type)
+
+    def _send_packet(self, pkt):
+        """Queue a packet to be sent to the server."""
+        if self.state != 'connected':
+            return
+        self.queue.put(pkt)
+        self.logger.info(
+            'Sending packet %s data %s',
+            packet.packet_names[pkt.packet_type],
+            pkt.data if not isinstance(pkt.data, bytes) else '<binary>')
+
+    def _send_request(
+            self, method, url, headers=None, body=None):  # pragma: no cover
+        if self.http is None:
+            self.http = requests.Session()
+        try:
+            return self.http.request(method, url, headers=headers, data=body)
+        except requests.exceptions.RequestException:
+            pass
+
+    def _trigger_event(self, event, *args, **kwargs):
+        """Invoke an event handler."""
+        run_async = kwargs.pop('run_async', False)
+        if event in self.handlers:
+            if run_async:
+                return self.start_background_task(self.handlers[event], *args)
+            else:
+                try:
+                    return self.handlers[event](*args)
+                except:
+                    self.logger.exception(event + ' handler error')
+
+    def _get_engineio_url(self, url, engineio_path, transport):
+        """Generate the Engine.IO connection URL."""
+        engineio_path = engineio_path.strip('/')
+        parsed_url = urllib.parse.urlparse(url)
+
+        if transport == 'polling':
+            scheme = 'http'
+        elif transport == 'websocket':
+            scheme = 'ws'
+        else:  # pragma: no cover
+            raise ValueError('invalid transport')
+        if parsed_url.scheme in ['https', 'wss']:
+            scheme += 's'
+
+        return ('{scheme}://{netloc}/{path}/?{query}'
+                '{sep}transport={transport}&EIO=3').format(
+                    scheme=scheme, netloc=parsed_url.netloc,
+                    path=engineio_path, query=parsed_url.query,
+                    sep='&' if parsed_url.query else '',
+                    transport=transport)
+
+    def _get_url_timestamp(self):
+        """Generate the Engine.IO query string timestamp."""
+        return '&t=' + str(time.time())
+
+    def _ping_loop(self):
+        """This background task sends a PING to the server at the requested
+        interval.
+        """
+        self.pong_received = True
+        self.ping_loop_event.clear()
+        while self.state == 'connected':
+            if not self.pong_received:
+                self.logger.info(
+                    'PONG response has not been received, aborting')
+                if self.ws:
+                    self.ws.close()
+                self.queue.put(None)
+                break
+            self.pong_received = False
+            self._send_packet(packet.Packet(packet.PING))
+            self.ping_loop_event.wait(timeout=self.ping_interval)
+        self.logger.info('Exiting ping task')
+
+    def _read_loop_polling(self):
+        """Read packets by polling the Engine.IO server."""
+        while self.state == 'connected':
+            self.logger.info(
+                'Sending polling GET request to ' + self.base_url)
+            r = self._send_request(
+                'GET', self.base_url + self._get_url_timestamp())
+            if r is None:
+                self.logger.warning(
+                    'Connection refused by the server, aborting')
+                self.queue.put(None)
+                break
+            if r.status_code != 200:
+                self.logger.warning('Unexpected status code %s in server '
+                                    'response, aborting', r.status_code)
+                self.queue.put(None)
+                break
+            try:
+                p = payload.Payload(encoded_payload=r.content)
+            except ValueError:
+                self.logger.warning(
+                    'Unexpected packet from server, aborting')
+                self.queue.put(None)
+                break
+            for pkt in p.packets:
+                self._receive_packet(pkt)
+
+        self.logger.info('Waiting for write loop task to end')
+        self.write_loop_task.join()
+        self.logger.info('Waiting for ping loop task to end')
+        self.ping_loop_event.set()
+        self.ping_loop_task.join()
+        if self.state == 'connected':
+            self._trigger_event('disconnect', run_async=False)
+            try:
+                connected_clients.remove(self)
+            except ValueError:  # pragma: no cover
+                pass
+            self._reset()
+        self.logger.info('Exiting read loop task')
+
+    def _read_loop_websocket(self):
+        """Read packets from the Engine.IO WebSocket connection."""
+        while self.state == 'connected':
+            p = None
+            try:
+                p = self.ws.recv()
+            except websocket.WebSocketConnectionClosedException:
+                self.logger.warning(
+                    'WebSocket connection was closed, aborting')
+                self.queue.put(None)
+                break
+            except Exception as e:
+                self.logger.info(
+                    'Unexpected error "%s", aborting', str(e))
+                self.queue.put(None)
+                break
+            if isinstance(p, six.text_type):  # pragma: no cover
+                p = p.encode('utf-8')
+            pkt = packet.Packet(encoded_packet=p)
+            self._receive_packet(pkt)
+
+        self.logger.info('Waiting for write loop task to end')
+        self.write_loop_task.join()
+        self.logger.info('Waiting for ping loop task to end')
+        self.ping_loop_event.set()
+        self.ping_loop_task.join()
+        if self.state == 'connected':
+            self._trigger_event('disconnect', run_async=False)
+            try:
+                connected_clients.remove(self)
+            except ValueError:  # pragma: no cover
+                pass
+            self._reset()
+        self.logger.info('Exiting read loop task')
+
+    def _write_loop(self):
+        """This background task sends packages to the server as they are
+        pushed to the send queue.
+        """
+        while self.state == 'connected':
+            # to simplify the timeout handling, use the maximum of the
+            # ping interval and ping timeout as timeout, with an extra 5
+            # seconds grace period
+            timeout = max(self.ping_interval, self.ping_timeout) + 5
+            packets = None
+            try:
+                packets = [self.queue.get(timeout=timeout)]
+            except self.queue.Empty:
+                self.logger.error('packet queue is empty, aborting')
+                break
+            if packets == [None]:
+                self.queue.task_done()
+                packets = []
+            else:
+                while True:
+                    try:
+                        packets.append(self.queue.get(block=False))
+                    except self.queue.Empty:
+                        break
+                    if packets[-1] is None:
+                        packets = packets[:-1]
+                        self.queue.task_done()
+                        break
+            if not packets:
+                # empty packet list returned -> connection closed
+                break
+            if self.current_transport == 'polling':
+                p = payload.Payload(packets=packets)
+                r = self._send_request(
+                    'POST', self.base_url, body=p.encode(),
+                    headers={'Content-Type': 'application/octet-stream'})
+                for pkt in packets:
+                    self.queue.task_done()
+                if r is None:
+                    self.logger.warning(
+                        'Connection refused by the server, aborting')
+                    break
+                if r.status_code != 200:
+                    self.logger.warning('Unexpected status code %s in server '
+                                        'response, aborting', r.status_code)
+                    self._reset()
+                    break
+            else:
+                # websocket
+                try:
+                    for pkt in packets:
+                        encoded_packet = pkt.encode(always_bytes=False)
+                        if pkt.binary:
+                            self.ws.send_binary(encoded_packet)
+                        else:
+                            self.ws.send(encoded_packet)
+                        self.queue.task_done()
+                except websocket.WebSocketConnectionClosedException:
+                    self.logger.warning(
+                        'WebSocket connection was closed, aborting')
+                    break
+        self.logger.info('Exiting write loop task')
diff --git a/openpype/vendor/python/python_2/engineio/exceptions.py b/openpype/vendor/python/python_2/engineio/exceptions.py
new file mode 100644
index 0000000000..fb0b3e057c
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/exceptions.py
@@ -0,0 +1,22 @@
+class EngineIOError(Exception):
+    pass
+
+
+class ContentTooLongError(EngineIOError):
+    pass
+
+
+class UnknownPacketError(EngineIOError):
+    pass
+
+
+class QueueEmpty(EngineIOError):
+    pass
+
+
+class SocketIsClosedError(EngineIOError):
+    pass
+
+
+class ConnectionError(EngineIOError):
+    pass
diff --git a/openpype/vendor/python/python_2/engineio/middleware.py b/openpype/vendor/python/python_2/engineio/middleware.py
new file mode 100644
index 0000000000..d0bdcc7476
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/middleware.py
@@ -0,0 +1,87 @@
+import os
+from engineio.static_files import get_static_file
+
+
+class WSGIApp(object):
+    """WSGI application middleware for Engine.IO.
+
+    This middleware dispatches traffic to an Engine.IO application. It can
+    also serve a list of static files to the client, or forward unrelated
+    HTTP traffic to another WSGI application.
+
+    :param engineio_app: The Engine.IO server. Must be an instance of the
+                         ``engineio.Server`` class.
+    :param wsgi_app: The WSGI app that receives all other traffic.
+    :param static_files: A dictionary with static file mapping rules. See the
+                         documentation for details on this argument.
+    :param engineio_path: The endpoint where the Engine.IO application should
+                          be installed. The default value is appropriate for
+                          most cases.
+
+    Example usage::
+
+        import engineio
+        import eventlet
+
+        eio = engineio.Server()
+        app = engineio.WSGIApp(eio, static_files={
+            '/': {'content_type': 'text/html', 'filename': 'index.html'},
+            '/index.html': {'content_type': 'text/html',
+                            'filename': 'index.html'},
+        })
+        eventlet.wsgi.server(eventlet.listen(('', 8000)), app)
+    """
+    def __init__(self, engineio_app, wsgi_app=None, static_files=None,
+                 engineio_path='engine.io'):
+        self.engineio_app = engineio_app
+        self.wsgi_app = wsgi_app
+        self.engineio_path = engineio_path.strip('/')
+        self.static_files = static_files or {}
+
+    def __call__(self, environ, start_response):
+        if 'gunicorn.socket' in environ:
+            # gunicorn saves the socket under environ['gunicorn.socket'], while
+            # eventlet saves it under environ['eventlet.input']. Eventlet also
+            # stores the socket inside a wrapper class, while gunicon writes it
+            # directly into the environment. To give eventlet's WebSocket
+            # module access to this socket when running under gunicorn, here we
+            # copy the socket to the eventlet format.
+            class Input(object):
+                def __init__(self, socket):
+                    self.socket = socket
+
+                def get_socket(self):
+                    return self.socket
+
+            environ['eventlet.input'] = Input(environ['gunicorn.socket'])
+        path = environ['PATH_INFO']
+        if path is not None and \
+                path.startswith('/{0}/'.format(self.engineio_path)):
+            return self.engineio_app.handle_request(environ, start_response)
+        else:
+            static_file = get_static_file(path, self.static_files) \
+                if self.static_files else None
+            if static_file:
+                if os.path.exists(static_file['filename']):
+                    start_response(
+                        '200 OK',
+                        [('Content-Type', static_file['content_type'])])
+                    with open(static_file['filename'], 'rb') as f:
+                        return [f.read()]
+                else:
+                    return self.not_found(start_response)
+            elif self.wsgi_app is not None:
+                return self.wsgi_app(environ, start_response)
+        return self.not_found(start_response)
+
+    def not_found(self, start_response):
+        start_response("404 Not Found", [('Content-Type', 'text/plain')])
+        return [b'Not Found']
+
+
+class Middleware(WSGIApp):
+    """This class has been renamed to ``WSGIApp`` and is now deprecated."""
+    def __init__(self, engineio_app, wsgi_app=None,
+                 engineio_path='engine.io'):
+        super(Middleware, self).__init__(engineio_app, wsgi_app,
+                                         engineio_path=engineio_path)
diff --git a/openpype/vendor/python/python_2/engineio/packet.py b/openpype/vendor/python/python_2/engineio/packet.py
new file mode 100644
index 0000000000..a3aa6d4761
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/packet.py
@@ -0,0 +1,92 @@
+import base64
+import json as _json
+
+import six
+
+(OPEN, CLOSE, PING, PONG, MESSAGE, UPGRADE, NOOP) = (0, 1, 2, 3, 4, 5, 6)
+packet_names = ['OPEN', 'CLOSE', 'PING', 'PONG', 'MESSAGE', 'UPGRADE', 'NOOP']
+
+binary_types = (six.binary_type, bytearray)
+
+
+class Packet(object):
+    """Engine.IO packet."""
+
+    json = _json
+
+    def __init__(self, packet_type=NOOP, data=None, binary=None,
+                 encoded_packet=None):
+        self.packet_type = packet_type
+        self.data = data
+        if binary is not None:
+            self.binary = binary
+        elif isinstance(data, six.text_type):
+            self.binary = False
+        elif isinstance(data, binary_types):
+            self.binary = True
+        else:
+            self.binary = False
+        if encoded_packet:
+            self.decode(encoded_packet)
+
+    def encode(self, b64=False, always_bytes=True):
+        """Encode the packet for transmission."""
+        if self.binary and not b64:
+            encoded_packet = six.int2byte(self.packet_type)
+        else:
+            encoded_packet = six.text_type(self.packet_type)
+            if self.binary and b64:
+                encoded_packet = 'b' + encoded_packet
+        if self.binary:
+            if b64:
+                encoded_packet += base64.b64encode(self.data).decode('utf-8')
+            else:
+                encoded_packet += self.data
+        elif isinstance(self.data, six.string_types):
+            encoded_packet += self.data
+        elif isinstance(self.data, dict) or isinstance(self.data, list):
+            encoded_packet += self.json.dumps(self.data,
+                                              separators=(',', ':'))
+        elif self.data is not None:
+            encoded_packet += str(self.data)
+        if always_bytes and not isinstance(encoded_packet, binary_types):
+            encoded_packet = encoded_packet.encode('utf-8')
+        return encoded_packet
+
+    def decode(self, encoded_packet):
+        """Decode a transmitted package."""
+        b64 = False
+        if not isinstance(encoded_packet, binary_types):
+            encoded_packet = encoded_packet.encode('utf-8')
+        elif not isinstance(encoded_packet, bytes):
+            encoded_packet = bytes(encoded_packet)
+        self.packet_type = six.byte2int(encoded_packet[0:1])
+        if self.packet_type == 98:  # 'b' --> binary base64 encoded packet
+            self.binary = True
+            encoded_packet = encoded_packet[1:]
+            self.packet_type = six.byte2int(encoded_packet[0:1])
+            self.packet_type -= 48
+            b64 = True
+        elif self.packet_type >= 48:
+            self.packet_type -= 48
+            self.binary = False
+        else:
+            self.binary = True
+        self.data = None
+        if len(encoded_packet) > 1:
+            if self.binary:
+                if b64:
+                    self.data = base64.b64decode(encoded_packet[1:])
+                else:
+                    self.data = encoded_packet[1:]
+            else:
+                try:
+                    self.data = self.json.loads(
+                        encoded_packet[1:].decode('utf-8'))
+                    if isinstance(self.data, int):
+                        # do not allow integer payloads, see
+                        # github.com/miguelgrinberg/python-engineio/issues/75
+                        # for background on this decision
+                        raise ValueError
+                except ValueError:
+                    self.data = encoded_packet[1:].decode('utf-8')
diff --git a/openpype/vendor/python/python_2/engineio/payload.py b/openpype/vendor/python/python_2/engineio/payload.py
new file mode 100644
index 0000000000..cfff557f5b
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/payload.py
@@ -0,0 +1,80 @@
+import six
+
+from . import packet
+
+from six.moves import urllib
+
+
+class Payload(object):
+    """Engine.IO payload."""
+    def __init__(self, packets=None, encoded_payload=None):
+        self.packets = packets or []
+        if encoded_payload is not None:
+            self.decode(encoded_payload)
+
+    def encode(self, b64=False, jsonp_index=None):
+        """Encode the payload for transmission."""
+        encoded_payload = b''
+        for pkt in self.packets:
+            encoded_packet = pkt.encode(b64=b64)
+            packet_len = len(encoded_packet)
+            if b64:
+                encoded_payload += str(packet_len).encode('utf-8') + b':' + \
+                    encoded_packet
+            else:
+                binary_len = b''
+                while packet_len != 0:
+                    binary_len = six.int2byte(packet_len % 10) + binary_len
+                    packet_len = int(packet_len / 10)
+                if not pkt.binary:
+                    encoded_payload += b'\0'
+                else:
+                    encoded_payload += b'\1'
+                encoded_payload += binary_len + b'\xff' + encoded_packet
+        if jsonp_index is not None:
+            encoded_payload = b'___eio[' + \
+                              str(jsonp_index).encode() + \
+                              b']("' + \
+                              encoded_payload.replace(b'"', b'\\"') + \
+                              b'");'
+        return encoded_payload
+
+    def decode(self, encoded_payload):
+        """Decode a transmitted payload."""
+        self.packets = []
+        while encoded_payload:
+            # JSONP POST payload starts with 'd='
+            if encoded_payload.startswith(b'd='):
+                encoded_payload = urllib.parse.parse_qs(
+                    encoded_payload)[b'd'][0]
+
+            if six.byte2int(encoded_payload[0:1]) <= 1:
+                packet_len = 0
+                i = 1
+                while six.byte2int(encoded_payload[i:i + 1]) != 255:
+                    packet_len = packet_len * 10 + six.byte2int(
+                        encoded_payload[i:i + 1])
+                    i += 1
+                self.packets.append(packet.Packet(
+                    encoded_packet=encoded_payload[i + 1:i + 1 + packet_len]))
+            else:
+                i = encoded_payload.find(b':')
+                if i == -1:
+                    raise ValueError('invalid payload')
+
+                # extracting the packet out of the payload is extremely
+                # inefficient, because the payload needs to be treated as
+                # binary, but the non-binary packets have to be parsed as
+                # unicode. Luckily this complication only applies to long
+                # polling, as the websocket transport sends packets
+                # individually wrapped.
+                packet_len = int(encoded_payload[0:i])
+                pkt = encoded_payload.decode('utf-8', errors='ignore')[
+                    i + 1: i + 1 + packet_len].encode('utf-8')
+                self.packets.append(packet.Packet(encoded_packet=pkt))
+
+                # the engine.io protocol sends the packet length in
+                # utf-8 characters, but we need it in bytes to be able to
+                # jump to the next packet in the payload
+                packet_len = len(pkt)
+            encoded_payload = encoded_payload[i + 1 + packet_len:]
diff --git a/openpype/vendor/python/python_2/engineio/server.py b/openpype/vendor/python/python_2/engineio/server.py
new file mode 100644
index 0000000000..a2ba7d16b4
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/server.py
@@ -0,0 +1,633 @@
+import gzip
+import importlib
+import logging
+import uuid
+import zlib
+
+import six
+from six.moves import urllib
+
+from . import exceptions
+from . import packet
+from . import payload
+from . import socket
+
+default_logger = logging.getLogger('engineio.server')
+
+
+class Server(object):
+    """An Engine.IO server.
+
+    This class implements a fully compliant Engine.IO web server with support
+    for websocket and long-polling transports.
+
+    :param async_mode: The asynchronous model to use. See the Deployment
+                       section in the documentation for a description of the
+                       available options. Valid async modes are "threading",
+                       "eventlet", "gevent" and "gevent_uwsgi". If this
+                       argument is not given, "eventlet" is tried first, then
+                       "gevent_uwsgi", then "gevent", and finally "threading".
+                       The first async mode that has all its dependencies
+                       installed is the one that is chosen.
+    :param ping_timeout: The time in seconds that the client waits for the
+                         server to respond before disconnecting. The default
+                         is 60 seconds.
+    :param ping_interval: The interval in seconds at which the client pings
+                          the server. The default is 25 seconds.
+    :param max_http_buffer_size: The maximum size of a message when using the
+                                 polling transport. The default is 100,000,000
+                                 bytes.
+    :param allow_upgrades: Whether to allow transport upgrades or not. The
+                           default is ``True``.
+    :param http_compression: Whether to compress packages when using the
+                             polling transport. The default is ``True``.
+    :param compression_threshold: Only compress messages when their byte size
+                                  is greater than this value. The default is
+                                  1024 bytes.
+    :param cookie: Name of the HTTP cookie that contains the client session
+                   id. If set to ``None``, a cookie is not sent to the client.
+                   The default is ``'io'``.
+    :param cors_allowed_origins: Origin or list of origins that are allowed to
+                                 connect to this server. All origins are
+                                 allowed by default, which is equivalent to
+                                 setting this argument to ``'*'``.
+    :param cors_credentials: Whether credentials (cookies, authentication) are
+                             allowed in requests to this server. The default
+                             is ``True``.
+    :param logger: To enable logging set to ``True`` or pass a logger object to
+                   use. To disable logging set to ``False``. The default is
+                   ``False``.
+    :param json: An alternative json module to use for encoding and decoding
+                 packets. Custom json modules must have ``dumps`` and ``loads``
+                 functions that are compatible with the standard library
+                 versions.
+    :param async_handlers: If set to ``True``, run message event handlers in
+                           non-blocking threads. To run handlers synchronously,
+                           set to ``False``. The default is ``True``.
+    :param monitor_clients: If set to ``True``, a background task will ensure
+                            inactive clients are closed. Set to ``False`` to
+                            disable the monitoring task (not recommended). The
+                            default is ``True``.
+    :param kwargs: Reserved for future extensions, any additional parameters
+                   given as keyword arguments will be silently ignored.
+    """
+    compression_methods = ['gzip', 'deflate']
+    event_names = ['connect', 'disconnect', 'message']
+    _default_monitor_clients = True
+
+    def __init__(self, async_mode=None, ping_timeout=60, ping_interval=25,
+                 max_http_buffer_size=100000000, allow_upgrades=True,
+                 http_compression=True, compression_threshold=1024,
+                 cookie='io', cors_allowed_origins=None,
+                 cors_credentials=True, logger=False, json=None,
+                 async_handlers=True, monitor_clients=None, **kwargs):
+        self.ping_timeout = ping_timeout
+        self.ping_interval = ping_interval
+        self.max_http_buffer_size = max_http_buffer_size
+        self.allow_upgrades = allow_upgrades
+        self.http_compression = http_compression
+        self.compression_threshold = compression_threshold
+        self.cookie = cookie
+        self.cors_allowed_origins = cors_allowed_origins
+        self.cors_credentials = cors_credentials
+        self.async_handlers = async_handlers
+        self.sockets = {}
+        self.handlers = {}
+        self.start_service_task = monitor_clients \
+            if monitor_clients is not None else self._default_monitor_clients
+        if json is not None:
+            packet.Packet.json = json
+        if not isinstance(logger, bool):
+            self.logger = logger
+        else:
+            self.logger = default_logger
+            if not logging.root.handlers and \
+                    self.logger.level == logging.NOTSET:
+                if logger:
+                    self.logger.setLevel(logging.INFO)
+                else:
+                    self.logger.setLevel(logging.ERROR)
+                self.logger.addHandler(logging.StreamHandler())
+        modes = self.async_modes()
+        if async_mode is not None:
+            modes = [async_mode] if async_mode in modes else []
+        self._async = None
+        self.async_mode = None
+        for mode in modes:
+            try:
+                self._async = importlib.import_module(
+                    'engineio.async_drivers.' + mode)._async
+                asyncio_based = self._async['asyncio'] \
+                    if 'asyncio' in self._async else False
+                if asyncio_based != self.is_asyncio_based():
+                    continue  # pragma: no cover
+                self.async_mode = mode
+                break
+            except ImportError:
+                pass
+        if self.async_mode is None:
+            raise ValueError('Invalid async_mode specified')
+        if self.is_asyncio_based() and \
+                ('asyncio' not in self._async or not
+                 self._async['asyncio']):  # pragma: no cover
+            raise ValueError('The selected async_mode is not asyncio '
+                             'compatible')
+        if not self.is_asyncio_based() and 'asyncio' in self._async and \
+                self._async['asyncio']:  # pragma: no cover
+            raise ValueError('The selected async_mode requires asyncio and '
+                             'must use the AsyncServer class')
+        self.logger.info('Server initialized for %s.', self.async_mode)
+
+    def is_asyncio_based(self):
+        return False
+
+    def async_modes(self):
+        return ['eventlet', 'gevent_uwsgi', 'gevent', 'threading']
+
+    def on(self, event, handler=None):
+        """Register an event handler.
+
+        :param event: The event name. Can be ``'connect'``, ``'message'`` or
+                      ``'disconnect'``.
+        :param handler: The function that should be invoked to handle the
+                        event. When this parameter is not given, the method
+                        acts as a decorator for the handler function.
+
+        Example usage::
+
+            # as a decorator:
+            @eio.on('connect')
+            def connect_handler(sid, environ):
+                print('Connection request')
+                if environ['REMOTE_ADDR'] in blacklisted:
+                    return False  # reject
+
+            # as a method:
+            def message_handler(sid, msg):
+                print('Received message: ', msg)
+                eio.send(sid, 'response')
+            eio.on('message', message_handler)
+
+        The handler function receives the ``sid`` (session ID) for the
+        client as first argument. The ``'connect'`` event handler receives the
+        WSGI environment as a second argument, and can return ``False`` to
+        reject the connection. The ``'message'`` handler receives the message
+        payload as a second argument. The ``'disconnect'`` handler does not
+        take a second argument.
+        """
+        if event not in self.event_names:
+            raise ValueError('Invalid event')
+
+        def set_handler(handler):
+            self.handlers[event] = handler
+            return handler
+
+        if handler is None:
+            return set_handler
+        set_handler(handler)
+
+    def send(self, sid, data, binary=None):
+        """Send a message to a client.
+
+        :param sid: The session id of the recipient client.
+        :param data: The data to send to the client. Data can be of type
+                     ``str``, ``bytes``, ``list`` or ``dict``. If a ``list``
+                     or ``dict``, the data will be serialized as JSON.
+        :param binary: ``True`` to send packet as binary, ``False`` to send
+                       as text. If not given, unicode (Python 2) and str
+                       (Python 3) are sent as text, and str (Python 2) and
+                       bytes (Python 3) are sent as binary.
+        """
+        try:
+            socket = self._get_socket(sid)
+        except KeyError:
+            # the socket is not available
+            self.logger.warning('Cannot send to sid %s', sid)
+            return
+        socket.send(packet.Packet(packet.MESSAGE, data=data, binary=binary))
+
+    def get_session(self, sid):
+        """Return the user session for a client.
+
+        :param sid: The session id of the client.
+
+        The return value is a dictionary. Modifications made to this
+        dictionary are not guaranteed to be preserved unless
+        ``save_session()`` is called, or when the ``session`` context manager
+        is used.
+        """
+        socket = self._get_socket(sid)
+        return socket.session
+
+    def save_session(self, sid, session):
+        """Store the user session for a client.
+
+        :param sid: The session id of the client.
+        :param session: The session dictionary.
+        """
+        socket = self._get_socket(sid)
+        socket.session = session
+
+    def session(self, sid):
+        """Return the user session for a client with context manager syntax.
+
+        :param sid: The session id of the client.
+
+        This is a context manager that returns the user session dictionary for
+        the client. Any changes that are made to this dictionary inside the
+        context manager block are saved back to the session. Example usage::
+
+            @eio.on('connect')
+            def on_connect(sid, environ):
+                username = authenticate_user(environ)
+                if not username:
+                    return False
+                with eio.session(sid) as session:
+                    session['username'] = username
+
+            @eio.on('message')
+            def on_message(sid, msg):
+                with eio.session(sid) as session:
+                    print('received message from ', session['username'])
+        """
+        class _session_context_manager(object):
+            def __init__(self, server, sid):
+                self.server = server
+                self.sid = sid
+                self.session = None
+
+            def __enter__(self):
+                self.session = self.server.get_session(sid)
+                return self.session
+
+            def __exit__(self, *args):
+                self.server.save_session(sid, self.session)
+
+        return _session_context_manager(self, sid)
+
+    def disconnect(self, sid=None):
+        """Disconnect a client.
+
+        :param sid: The session id of the client to close. If this parameter
+                    is not given, then all clients are closed.
+        """
+        if sid is not None:
+            try:
+                socket = self._get_socket(sid)
+            except KeyError:  # pragma: no cover
+                # the socket was already closed or gone
+                pass
+            else:
+                socket.close()
+                del self.sockets[sid]
+        else:
+            for client in six.itervalues(self.sockets):
+                client.close()
+            self.sockets = {}
+
+    def transport(self, sid):
+        """Return the name of the transport used by the client.
+
+        The two possible values returned by this function are ``'polling'``
+        and ``'websocket'``.
+
+        :param sid: The session of the client.
+        """
+        return 'websocket' if self._get_socket(sid).upgraded else 'polling'
+
+    def handle_request(self, environ, start_response):
+        """Handle an HTTP request from the client.
+
+        This is the entry point of the Engine.IO application, using the same
+        interface as a WSGI application. For the typical usage, this function
+        is invoked by the :class:`Middleware` instance, but it can be invoked
+        directly when the middleware is not used.
+
+        :param environ: The WSGI environment.
+        :param start_response: The WSGI ``start_response`` function.
+
+        This function returns the HTTP response body to deliver to the client
+        as a byte sequence.
+        """
+        method = environ['REQUEST_METHOD']
+        query = urllib.parse.parse_qs(environ.get('QUERY_STRING', ''))
+
+        sid = query['sid'][0] if 'sid' in query else None
+        b64 = False
+        jsonp = False
+        jsonp_index = None
+
+        if 'b64' in query:
+            if query['b64'][0] == "1" or query['b64'][0].lower() == "true":
+                b64 = True
+        if 'j' in query:
+            jsonp = True
+            try:
+                jsonp_index = int(query['j'][0])
+            except (ValueError, KeyError, IndexError):
+                # Invalid JSONP index number
+                pass
+
+        if jsonp and jsonp_index is None:
+            self.logger.warning('Invalid JSONP index number')
+            r = self._bad_request()
+        elif method == 'GET':
+            if sid is None:
+                transport = query.get('transport', ['polling'])[0]
+                if transport != 'polling' and transport != 'websocket':
+                    self.logger.warning('Invalid transport %s', transport)
+                    r = self._bad_request()
+                else:
+                    r = self._handle_connect(environ, start_response,
+                                             transport, b64, jsonp_index)
+            else:
+                if sid not in self.sockets:
+                    self.logger.warning('Invalid session %s', sid)
+                    r = self._bad_request()
+                else:
+                    socket = self._get_socket(sid)
+                    try:
+                        packets = socket.handle_get_request(
+                            environ, start_response)
+                        if isinstance(packets, list):
+                            r = self._ok(packets, b64=b64,
+                                         jsonp_index=jsonp_index)
+                        else:
+                            r = packets
+                    except exceptions.EngineIOError:
+                        if sid in self.sockets:  # pragma: no cover
+                            self.disconnect(sid)
+                        r = self._bad_request()
+                    if sid in self.sockets and self.sockets[sid].closed:
+                        del self.sockets[sid]
+        elif method == 'POST':
+            if sid is None or sid not in self.sockets:
+                self.logger.warning('Invalid session %s', sid)
+                r = self._bad_request()
+            else:
+                socket = self._get_socket(sid)
+                try:
+                    socket.handle_post_request(environ)
+                    r = self._ok(jsonp_index=jsonp_index)
+                except exceptions.EngineIOError:
+                    if sid in self.sockets:  # pragma: no cover
+                        self.disconnect(sid)
+                    r = self._bad_request()
+                except:  # pragma: no cover
+                    # for any other unexpected errors, we log the error
+                    # and keep going
+                    self.logger.exception('post request handler error')
+                    r = self._ok(jsonp_index=jsonp_index)
+        elif method == 'OPTIONS':
+            r = self._ok()
+        else:
+            self.logger.warning('Method %s not supported', method)
+            r = self._method_not_found()
+
+        if not isinstance(r, dict):
+            return r or []
+        if self.http_compression and \
+                len(r['response']) >= self.compression_threshold:
+            encodings = [e.split(';')[0].strip() for e in
+                         environ.get('HTTP_ACCEPT_ENCODING', '').split(',')]
+            for encoding in encodings:
+                if encoding in self.compression_methods:
+                    r['response'] = \
+                        getattr(self, '_' + encoding)(r['response'])
+                    r['headers'] += [('Content-Encoding', encoding)]
+                    break
+        cors_headers = self._cors_headers(environ)
+        start_response(r['status'], r['headers'] + cors_headers)
+        return [r['response']]
+
+    def start_background_task(self, target, *args, **kwargs):
+        """Start a background task using the appropriate async model.
+
+        This is a utility function that applications can use to start a
+        background task using the method that is compatible with the
+        selected async mode.
+
+        :param target: the target function to execute.
+        :param args: arguments to pass to the function.
+        :param kwargs: keyword arguments to pass to the function.
+
+        This function returns an object compatible with the `Thread` class in
+        the Python standard library. The `start()` method on this object is
+        already called by this function.
+        """
+        th = self._async['thread'](target=target, args=args, kwargs=kwargs)
+        th.start()
+        return th  # pragma: no cover
+
+    def sleep(self, seconds=0):
+        """Sleep for the requested amount of time using the appropriate async
+        model.
+
+        This is a utility function that applications can use to put a task to
+        sleep without having to worry about using the correct call for the
+        selected async mode.
+        """
+        return self._async['sleep'](seconds)
+
+    def create_queue(self, *args, **kwargs):
+        """Create a queue object using the appropriate async model.
+
+        This is a utility function that applications can use to create a queue
+        without having to worry about using the correct call for the selected
+        async mode.
+        """
+        return self._async['queue'](*args, **kwargs)
+
+    def get_queue_empty_exception(self):
+        """Return the queue empty exception for the appropriate async model.
+
+        This is a utility function that applications can use to work with a
+        queue without having to worry about using the correct call for the
+        selected async mode.
+        """
+        return self._async['queue_empty']
+
+    def create_event(self, *args, **kwargs):
+        """Create an event object using the appropriate async model.
+
+        This is a utility function that applications can use to create an
+        event without having to worry about using the correct call for the
+        selected async mode.
+        """
+        return self._async['event'](*args, **kwargs)
+
+    def _generate_id(self):
+        """Generate a unique session id."""
+        return uuid.uuid4().hex
+
+    def _handle_connect(self, environ, start_response, transport, b64=False,
+                        jsonp_index=None):
+        """Handle a client connection request."""
+        if self.start_service_task:
+            # start the service task to monitor connected clients
+            self.start_service_task = False
+            self.start_background_task(self._service_task)
+
+        sid = self._generate_id()
+        s = socket.Socket(self, sid)
+        self.sockets[sid] = s
+
+        pkt = packet.Packet(
+            packet.OPEN, {'sid': sid,
+                          'upgrades': self._upgrades(sid, transport),
+                          'pingTimeout': int(self.ping_timeout * 1000),
+                          'pingInterval': int(self.ping_interval * 1000)})
+        s.send(pkt)
+
+        ret = self._trigger_event('connect', sid, environ, run_async=False)
+        if ret is False:
+            del self.sockets[sid]
+            self.logger.warning('Application rejected connection')
+            return self._unauthorized()
+
+        if transport == 'websocket':
+            ret = s.handle_get_request(environ, start_response)
+            if s.closed:
+                # websocket connection ended, so we are done
+                del self.sockets[sid]
+            return ret
+        else:
+            s.connected = True
+            headers = None
+            if self.cookie:
+                headers = [('Set-Cookie', self.cookie + '=' + sid)]
+            try:
+                return self._ok(s.poll(), headers=headers, b64=b64,
+                                jsonp_index=jsonp_index)
+            except exceptions.QueueEmpty:
+                return self._bad_request()
+
+    def _upgrades(self, sid, transport):
+        """Return the list of possible upgrades for a client connection."""
+        if not self.allow_upgrades or self._get_socket(sid).upgraded or \
+                self._async['websocket'] is None or transport == 'websocket':
+            return []
+        return ['websocket']
+
+    def _trigger_event(self, event, *args, **kwargs):
+        """Invoke an event handler."""
+        run_async = kwargs.pop('run_async', False)
+        if event in self.handlers:
+            if run_async:
+                return self.start_background_task(self.handlers[event], *args)
+            else:
+                try:
+                    return self.handlers[event](*args)
+                except:
+                    self.logger.exception(event + ' handler error')
+                    if event == 'connect':
+                        # if connect handler raised error we reject the
+                        # connection
+                        return False
+
+    def _get_socket(self, sid):
+        """Return the socket object for a given session."""
+        try:
+            s = self.sockets[sid]
+        except KeyError:
+            raise KeyError('Session not found')
+        if s.closed:
+            del self.sockets[sid]
+            raise KeyError('Session is disconnected')
+        return s
+
+    def _ok(self, packets=None, headers=None, b64=False, jsonp_index=None):
+        """Generate a successful HTTP response."""
+        if packets is not None:
+            if headers is None:
+                headers = []
+            if b64:
+                headers += [('Content-Type', 'text/plain; charset=UTF-8')]
+            else:
+                headers += [('Content-Type', 'application/octet-stream')]
+            return {'status': '200 OK',
+                    'headers': headers,
+                    'response': payload.Payload(packets=packets).encode(
+                        b64=b64, jsonp_index=jsonp_index)}
+        else:
+            return {'status': '200 OK',
+                    'headers': [('Content-Type', 'text/plain')],
+                    'response': b'OK'}
+
+    def _bad_request(self):
+        """Generate a bad request HTTP error response."""
+        return {'status': '400 BAD REQUEST',
+                'headers': [('Content-Type', 'text/plain')],
+                'response': b'Bad Request'}
+
+    def _method_not_found(self):
+        """Generate a method not found HTTP error response."""
+        return {'status': '405 METHOD NOT FOUND',
+                'headers': [('Content-Type', 'text/plain')],
+                'response': b'Method Not Found'}
+
+    def _unauthorized(self):
+        """Generate a unauthorized HTTP error response."""
+        return {'status': '401 UNAUTHORIZED',
+                'headers': [('Content-Type', 'text/plain')],
+                'response': b'Unauthorized'}
+
+    def _cors_headers(self, environ):
+        """Return the cross-origin-resource-sharing headers."""
+        if isinstance(self.cors_allowed_origins, six.string_types):
+            if self.cors_allowed_origins == '*':
+                allowed_origins = None
+            else:
+                allowed_origins = [self.cors_allowed_origins]
+        else:
+            allowed_origins = self.cors_allowed_origins
+        if allowed_origins is not None and \
+                environ.get('HTTP_ORIGIN', '') not in allowed_origins:
+            return []
+        if 'HTTP_ORIGIN' in environ:
+            headers = [('Access-Control-Allow-Origin', environ['HTTP_ORIGIN'])]
+        else:
+            headers = [('Access-Control-Allow-Origin', '*')]
+        if environ['REQUEST_METHOD'] == 'OPTIONS':
+            headers += [('Access-Control-Allow-Methods', 'OPTIONS, GET, POST')]
+        if 'HTTP_ACCESS_CONTROL_REQUEST_HEADERS' in environ:
+            headers += [('Access-Control-Allow-Headers',
+                         environ['HTTP_ACCESS_CONTROL_REQUEST_HEADERS'])]
+        if self.cors_credentials:
+            headers += [('Access-Control-Allow-Credentials', 'true')]
+        return headers
+
+    def _gzip(self, response):
+        """Apply gzip compression to a response."""
+        bytesio = six.BytesIO()
+        with gzip.GzipFile(fileobj=bytesio, mode='w') as gz:
+            gz.write(response)
+        return bytesio.getvalue()
+
+    def _deflate(self, response):
+        """Apply deflate compression to a response."""
+        return zlib.compress(response)
+
+    def _service_task(self):  # pragma: no cover
+        """Monitor connected clients and clean up those that time out."""
+        while True:
+            if len(self.sockets) == 0:
+                # nothing to do
+                self.sleep(self.ping_timeout)
+                continue
+
+            # go through the entire client list in a ping interval cycle
+            sleep_interval = self.ping_timeout / len(self.sockets)
+
+            try:
+                # iterate over the current clients
+                for s in self.sockets.copy().values():
+                    if not s.closing and not s.closed:
+                        s.check_ping_timeout()
+                    self.sleep(sleep_interval)
+            except (SystemExit, KeyboardInterrupt):
+                self.logger.info('service task canceled')
+                break
+            except:
+                # an unexpected exception has occurred, log it and continue
+                self.logger.exception('service task exception')
diff --git a/openpype/vendor/python/python_2/engineio/socket.py b/openpype/vendor/python/python_2/engineio/socket.py
new file mode 100644
index 0000000000..495088ae3e
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/socket.py
@@ -0,0 +1,247 @@
+import six
+import sys
+import time
+
+from . import exceptions
+from . import packet
+from . import payload
+
+
+class Socket(object):
+    """An Engine.IO socket."""
+    upgrade_protocols = ['websocket']
+
+    def __init__(self, server, sid):
+        self.server = server
+        self.sid = sid
+        self.queue = self.server.create_queue()
+        self.last_ping = time.time()
+        self.connected = False
+        self.upgrading = False
+        self.upgraded = False
+        self.packet_backlog = []
+        self.closing = False
+        self.closed = False
+        self.session = {}
+
+    def poll(self):
+        """Wait for packets to send to the client."""
+        queue_empty = self.server.get_queue_empty_exception()
+        try:
+            packets = [self.queue.get(timeout=self.server.ping_timeout)]
+            self.queue.task_done()
+        except queue_empty:
+            raise exceptions.QueueEmpty()
+        if packets == [None]:
+            return []
+        while True:
+            try:
+                packets.append(self.queue.get(block=False))
+                self.queue.task_done()
+            except queue_empty:
+                break
+        return packets
+
+    def receive(self, pkt):
+        """Receive packet from the client."""
+        packet_name = packet.packet_names[pkt.packet_type] \
+            if pkt.packet_type < len(packet.packet_names) else 'UNKNOWN'
+        self.server.logger.info('%s: Received packet %s data %s',
+                                self.sid, packet_name,
+                                pkt.data if not isinstance(pkt.data, bytes)
+                                else '<binary>')
+        if pkt.packet_type == packet.PING:
+            self.last_ping = time.time()
+            self.send(packet.Packet(packet.PONG, pkt.data))
+        elif pkt.packet_type == packet.MESSAGE:
+            self.server._trigger_event('message', self.sid, pkt.data,
+                                       run_async=self.server.async_handlers)
+        elif pkt.packet_type == packet.UPGRADE:
+            self.send(packet.Packet(packet.NOOP))
+        elif pkt.packet_type == packet.CLOSE:
+            self.close(wait=False, abort=True)
+        else:
+            raise exceptions.UnknownPacketError()
+
+    def check_ping_timeout(self):
+        """Make sure the client is still sending pings.
+
+        This helps detect disconnections for long-polling clients.
+        """
+        if self.closed:
+            raise exceptions.SocketIsClosedError()
+        if time.time() - self.last_ping > self.server.ping_interval + 5:
+            self.server.logger.info('%s: Client is gone, closing socket',
+                                    self.sid)
+            # Passing abort=False here will cause close() to write a
+            # CLOSE packet. This has the effect of updating half-open sockets
+            # to their correct state of disconnected
+            self.close(wait=False, abort=False)
+            return False
+        return True
+
+    def send(self, pkt):
+        """Send a packet to the client."""
+        if not self.check_ping_timeout():
+            return
+        if self.upgrading:
+            self.packet_backlog.append(pkt)
+        else:
+            self.queue.put(pkt)
+        self.server.logger.info('%s: Sending packet %s data %s',
+                                self.sid, packet.packet_names[pkt.packet_type],
+                                pkt.data if not isinstance(pkt.data, bytes)
+                                else '<binary>')
+
+    def handle_get_request(self, environ, start_response):
+        """Handle a long-polling GET request from the client."""
+        connections = [
+            s.strip()
+            for s in environ.get('HTTP_CONNECTION', '').lower().split(',')]
+        transport = environ.get('HTTP_UPGRADE', '').lower()
+        if 'upgrade' in connections and transport in self.upgrade_protocols:
+            self.server.logger.info('%s: Received request to upgrade to %s',
+                                    self.sid, transport)
+            return getattr(self, '_upgrade_' + transport)(environ,
+                                                          start_response)
+        try:
+            packets = self.poll()
+        except exceptions.QueueEmpty:
+            exc = sys.exc_info()
+            self.close(wait=False)
+            six.reraise(*exc)
+        return packets
+
+    def handle_post_request(self, environ):
+        """Handle a long-polling POST request from the client."""
+        length = int(environ.get('CONTENT_LENGTH', '0'))
+        if length > self.server.max_http_buffer_size:
+            raise exceptions.ContentTooLongError()
+        else:
+            body = environ['wsgi.input'].read(length)
+            p = payload.Payload(encoded_payload=body)
+            for pkt in p.packets:
+                self.receive(pkt)
+
+    def close(self, wait=True, abort=False):
+        """Close the socket connection."""
+        if not self.closed and not self.closing:
+            self.closing = True
+            self.server._trigger_event('disconnect', self.sid, run_async=False)
+            if not abort:
+                self.send(packet.Packet(packet.CLOSE))
+            self.closed = True
+            self.queue.put(None)
+            if wait:
+                self.queue.join()
+
+    def _upgrade_websocket(self, environ, start_response):
+        """Upgrade the connection from polling to websocket."""
+        if self.upgraded:
+            raise IOError('Socket has been upgraded already')
+        if self.server._async['websocket'] is None:
+            # the selected async mode does not support websocket
+            return self.server._bad_request()
+        ws = self.server._async['websocket'](self._websocket_handler)
+        return ws(environ, start_response)
+
+    def _websocket_handler(self, ws):
+        """Engine.IO handler for websocket transport."""
+        # try to set a socket timeout matching the configured ping interval
+        for attr in ['_sock', 'socket']:  # pragma: no cover
+            if hasattr(ws, attr) and hasattr(getattr(ws, attr), 'settimeout'):
+                getattr(ws, attr).settimeout(self.server.ping_timeout)
+
+        if self.connected:
+            # the socket was already connected, so this is an upgrade
+            self.upgrading = True  # hold packet sends during the upgrade
+
+            pkt = ws.wait()
+            decoded_pkt = packet.Packet(encoded_packet=pkt)
+            if decoded_pkt.packet_type != packet.PING or \
+                    decoded_pkt.data != 'probe':
+                self.server.logger.info(
+                    '%s: Failed websocket upgrade, no PING packet', self.sid)
+                return []
+            ws.send(packet.Packet(
+                packet.PONG,
+                data=six.text_type('probe')).encode(always_bytes=False))
+            self.queue.put(packet.Packet(packet.NOOP))  # end poll
+
+            pkt = ws.wait()
+            decoded_pkt = packet.Packet(encoded_packet=pkt)
+            if decoded_pkt.packet_type != packet.UPGRADE:
+                self.upgraded = False
+                self.server.logger.info(
+                    ('%s: Failed websocket upgrade, expected UPGRADE packet, '
+                     'received %s instead.'),
+                    self.sid, pkt)
+                return []
+            self.upgraded = True
+
+            # flush any packets that were sent during the upgrade
+            for pkt in self.packet_backlog:
+                self.queue.put(pkt)
+            self.packet_backlog = []
+            self.upgrading = False
+        else:
+            self.connected = True
+            self.upgraded = True
+
+        # start separate writer thread
+        def writer():
+            while True:
+                packets = None
+                try:
+                    packets = self.poll()
+                except exceptions.QueueEmpty:
+                    break
+                if not packets:
+                    # empty packet list returned -> connection closed
+                    break
+                try:
+                    for pkt in packets:
+                        ws.send(pkt.encode(always_bytes=False))
+                except:
+                    break
+        writer_task = self.server.start_background_task(writer)
+
+        self.server.logger.info(
+            '%s: Upgrade to websocket successful', self.sid)
+
+        while True:
+            p = None
+            try:
+                p = ws.wait()
+            except Exception as e:
+                # if the socket is already closed, we can assume this is a
+                # downstream error of that
+                if not self.closed:  # pragma: no cover
+                    self.server.logger.info(
+                        '%s: Unexpected error "%s", closing connection',
+                        self.sid, str(e))
+                break
+            if p is None:
+                # connection closed by client
+                break
+            if isinstance(p, six.text_type):  # pragma: no cover
+                p = p.encode('utf-8')
+            pkt = packet.Packet(encoded_packet=p)
+            try:
+                self.receive(pkt)
+            except exceptions.UnknownPacketError:  # pragma: no cover
+                pass
+            except exceptions.SocketIsClosedError:  # pragma: no cover
+                self.server.logger.info('Receive error -- socket is closed')
+                break
+            except:  # pragma: no cover
+                # if we get an unexpected exception we log the error and exit
+                # the connection properly
+                self.server.logger.exception('Unknown receive error')
+                break
+
+        self.queue.put(None)  # unlock the writer task so that it can exit
+        writer_task.join()
+        self.close(wait=False, abort=True)
+
+        return []
diff --git a/openpype/vendor/python/python_2/engineio/static_files.py b/openpype/vendor/python/python_2/engineio/static_files.py
new file mode 100644
index 0000000000..3058f6ea42
--- /dev/null
+++ b/openpype/vendor/python/python_2/engineio/static_files.py
@@ -0,0 +1,55 @@
+content_types = {
+    'css': 'text/css',
+    'gif': 'image/gif',
+    'html': 'text/html',
+    'jpg': 'image/jpeg',
+    'js': 'application/javascript',
+    'json': 'application/json',
+    'png': 'image/png',
+    'txt': 'text/plain',
+}
+
+
+def get_static_file(path, static_files):
+    """Return the local filename and content type for the requested static
+    file URL.
+
+    :param path: the path portion of the requested URL.
+    :param static_files: a static file configuration dictionary.
+
+    This function returns a dictionary with two keys, "filename" and
+    "content_type". If the requested URL does not match any static file, the
+    return value is None.
+    """
+    if path in static_files:
+        f = static_files[path]
+    else:
+        f = None
+        rest = ''
+        while path != '':
+            path, last = path.rsplit('/', 1)
+            rest = '/' + last + rest
+            if path in static_files:
+                f = static_files[path] + rest
+                break
+            elif path + '/' in static_files:
+                f = static_files[path + '/'] + rest[1:]
+                break
+    if f:
+        if isinstance(f, str):
+            f = {'filename': f}
+        if f['filename'].endswith('/'):
+            if '' in static_files:
+                if isinstance(static_files[''], str):
+                    f['filename'] += static_files['']
+                else:
+                    f['filename'] += static_files['']['filename']
+                    if 'content_type' in static_files['']:
+                        f['content_type'] = static_files['']['content_type']
+            else:
+                f['filename'] += 'index.html'
+        if 'content_type' not in f:
+            ext = f['filename'].rsplit('.')[-1]
+            f['content_type'] = content_types.get(
+                ext, 'application/octet-stream')
+    return f
diff --git a/openpype/vendor/python/python_2/socketio/__init__.py b/openpype/vendor/python/python_2/socketio/__init__.py
new file mode 100644
index 0000000000..f0a9541820
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/__init__.py
@@ -0,0 +1,35 @@
+import sys
+
+from .client import Client
+from .base_manager import BaseManager
+from .pubsub_manager import PubSubManager
+from .kombu_manager import KombuManager
+from .redis_manager import RedisManager
+from .zmq_manager import ZmqManager
+from .server import Server
+from .namespace import Namespace, ClientNamespace
+from .middleware import WSGIApp, Middleware
+from .tornado import get_tornado_handler
+if sys.version_info >= (3, 5):  # pragma: no cover
+    from .asyncio_client import AsyncClient
+    from .asyncio_server import AsyncServer
+    from .asyncio_manager import AsyncManager
+    from .asyncio_namespace import AsyncNamespace, AsyncClientNamespace
+    from .asyncio_redis_manager import AsyncRedisManager
+    from .asgi import ASGIApp
+else:  # pragma: no cover
+    AsyncClient = None
+    AsyncServer = None
+    AsyncManager = None
+    AsyncNamespace = None
+    AsyncRedisManager = None
+
+__version__ = '4.2.1'
+
+__all__ = ['__version__', 'Client', 'Server', 'BaseManager', 'PubSubManager',
+           'KombuManager', 'RedisManager', 'ZmqManager', 'Namespace',
+           'ClientNamespace', 'WSGIApp', 'Middleware']
+if AsyncServer is not None:  # pragma: no cover
+    __all__ += ['AsyncClient', 'AsyncServer', 'AsyncNamespace',
+                'AsyncClientNamespace', 'AsyncManager', 'AsyncRedisManager',
+                'ASGIApp', 'get_tornado_handler']
diff --git a/openpype/vendor/python/python_2/socketio/asgi.py b/openpype/vendor/python/python_2/socketio/asgi.py
new file mode 100644
index 0000000000..9bcdd03bac
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/asgi.py
@@ -0,0 +1,36 @@
+import engineio
+
+
+class ASGIApp(engineio.ASGIApp):  # pragma: no cover
+    """ASGI application middleware for Socket.IO.
+
+    This middleware dispatches traffic to an Socket.IO application. It can
+    also serve a list of static files to the client, or forward unrelated
+    HTTP traffic to another ASGI application.
+
+    :param socketio_server: The Socket.IO server. Must be an instance of the
+                            ``socketio.AsyncServer`` class.
+    :param static_files: A dictionary with static file mapping rules. See the
+                         documentation for details on this argument.
+    :param other_asgi_app: A separate ASGI app that receives all other traffic.
+    :param socketio_path: The endpoint where the Socket.IO application should
+                          be installed. The default value is appropriate for
+                          most cases.
+
+    Example usage::
+
+        import socketio
+        import uvicorn
+
+        sio = socketio.AsyncServer()
+        app = engineio.ASGIApp(sio, static_files={
+            '/': 'index.html',
+            '/static': './public',
+        })
+        uvicorn.run(app, host='127.0.0.1', port=5000)
+    """
+    def __init__(self, socketio_server, other_asgi_app=None,
+                 static_files=None, socketio_path='socket.io'):
+        super().__init__(socketio_server, other_asgi_app,
+                         static_files=static_files,
+                         engineio_path=socketio_path)
diff --git a/openpype/vendor/python/python_2/socketio/asyncio_client.py b/openpype/vendor/python/python_2/socketio/asyncio_client.py
new file mode 100644
index 0000000000..d71ccecfaa
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/asyncio_client.py
@@ -0,0 +1,445 @@
+import asyncio
+import logging
+import random
+
+import engineio
+import six
+
+from . import client
+from . import exceptions
+from . import packet
+
+default_logger = logging.getLogger('socketio.client')
+
+
+class AsyncClient(client.Client):
+    """A Socket.IO client for asyncio.
+
+    This class implements a fully compliant Socket.IO web client with support
+    for websocket and long-polling transports.
+
+    :param reconnection: ``True`` if the client should automatically attempt to
+                         reconnect to the server after an interruption, or
+                         ``False`` to not reconnect. The default is ``True``.
+    :param reconnection_attempts: How many reconnection attempts to issue
+                                  before giving up, or 0 for infinity attempts.
+                                  The default is 0.
+    :param reconnection_delay: How long to wait in seconds before the first
+                               reconnection attempt. Each successive attempt
+                               doubles this delay.
+    :param reconnection_delay_max: The maximum delay between reconnection
+                                   attempts.
+    :param randomization_factor: Randomization amount for each delay between
+                                 reconnection attempts. The default is 0.5,
+                                 which means that each delay is randomly
+                                 adjusted by +/- 50%.
+    :param logger: To enable logging set to ``True`` or pass a logger object to
+                   use. To disable logging set to ``False``. The default is
+                   ``False``.
+    :param binary: ``True`` to support binary payloads, ``False`` to treat all
+                   payloads as text. On Python 2, if this is set to ``True``,
+                   ``unicode`` values are treated as text, and ``str`` and
+                   ``bytes`` values are treated as binary.  This option has no
+                   effect on Python 3, where text and binary payloads are
+                   always automatically discovered.
+    :param json: An alternative json module to use for encoding and decoding
+                 packets. Custom json modules must have ``dumps`` and ``loads``
+                 functions that are compatible with the standard library
+                 versions.
+
+    The Engine.IO configuration supports the following settings:
+
+    :param engineio_logger: To enable Engine.IO logging set to ``True`` or pass
+                            a logger object to use. To disable logging set to
+                            ``False``. The default is ``False``.
+    """
+    def is_asyncio_based(self):
+        return True
+
+    async def connect(self, url, headers={}, transports=None,
+                      namespaces=None, socketio_path='socket.io'):
+        """Connect to a Socket.IO server.
+
+        :param url: The URL of the Socket.IO server. It can include custom
+                    query string parameters if required by the server.
+        :param headers: A dictionary with custom headers to send with the
+                        connection request.
+        :param transports: The list of allowed transports. Valid transports
+                           are ``'polling'`` and ``'websocket'``. If not
+                           given, the polling transport is connected first,
+                           then an upgrade to websocket is attempted.
+        :param namespaces: The list of custom namespaces to connect, in
+                           addition to the default namespace. If not given,
+                           the namespace list is obtained from the registered
+                           event handlers.
+        :param socketio_path: The endpoint where the Socket.IO server is
+                              installed. The default value is appropriate for
+                              most cases.
+
+        Note: this method is a coroutine.
+
+        Example usage::
+
+            sio = socketio.Client()
+            sio.connect('http://localhost:5000')
+        """
+        self.connection_url = url
+        self.connection_headers = headers
+        self.connection_transports = transports
+        self.connection_namespaces = namespaces
+        self.socketio_path = socketio_path
+
+        if namespaces is None:
+            namespaces = set(self.handlers.keys()).union(
+                set(self.namespace_handlers.keys()))
+        elif isinstance(namespaces, six.string_types):
+            namespaces = [namespaces]
+            self.connection_namespaces = namespaces
+        self.namespaces = [n for n in namespaces if n != '/']
+        try:
+            await self.eio.connect(url, headers=headers,
+                                   transports=transports,
+                                   engineio_path=socketio_path)
+        except engineio.exceptions.ConnectionError as exc:
+            six.raise_from(exceptions.ConnectionError(exc.args[0]), None)
+
+    async def wait(self):
+        """Wait until the connection with the server ends.
+
+        Client applications can use this function to block the main thread
+        during the life of the connection.
+
+        Note: this method is a coroutine.
+        """
+        while True:
+            await self.eio.wait()
+            await self.sleep(1)  # give the reconnect task time to start up
+            if not self._reconnect_task:
+                break
+            await self._reconnect_task
+            if self.eio.state != 'connected':
+                break
+
+    async def emit(self, event, data=None, namespace=None, callback=None):
+        """Emit a custom event to one or more connected clients.
+
+        :param event: The event name. It can be any string. The event names
+                      ``'connect'``, ``'message'`` and ``'disconnect'`` are
+                      reserved and should not be used.
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param callback: If given, this function will be called to acknowledge
+                         the the client has received the message. The arguments
+                         that will be passed to the function are those provided
+                         by the client. Callback functions can only be used
+                         when addressing an individual client.
+
+        Note: this method is a coroutine.
+        """
+        namespace = namespace or '/'
+        self.logger.info('Emitting event "%s" [%s]', event, namespace)
+        if callback is not None:
+            id = self._generate_ack_id(namespace, callback)
+        else:
+            id = None
+        if six.PY2 and not self.binary:
+            binary = False  # pragma: nocover
+        else:
+            binary = None
+        # tuples are expanded to multiple arguments, everything else is sent
+        # as a single argument
+        if isinstance(data, tuple):
+            data = list(data)
+        elif data is not None:
+            data = [data]
+        else:
+            data = []
+        await self._send_packet(packet.Packet(
+            packet.EVENT, namespace=namespace, data=[event] + data, id=id,
+            binary=binary))
+
+    async def send(self, data, namespace=None, callback=None):
+        """Send a message to one or more connected clients.
+
+        This function emits an event with the name ``'message'``. Use
+        :func:`emit` to issue custom event names.
+
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param callback: If given, this function will be called to acknowledge
+                         the the client has received the message. The arguments
+                         that will be passed to the function are those provided
+                         by the client. Callback functions can only be used
+                         when addressing an individual client.
+
+        Note: this method is a coroutine.
+        """
+        await self.emit('message', data=data, namespace=namespace,
+                        callback=callback)
+
+    async def call(self, event, data=None, namespace=None, timeout=60):
+        """Emit a custom event to a client and wait for the response.
+
+        :param event: The event name. It can be any string. The event names
+                      ``'connect'``, ``'message'`` and ``'disconnect'`` are
+                      reserved and should not be used.
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param timeout: The waiting timeout. If the timeout is reached before
+                        the client acknowledges the event, then a
+                        ``TimeoutError`` exception is raised.
+
+        Note: this method is a coroutine.
+        """
+        callback_event = self.eio.create_event()
+        callback_args = []
+
+        def event_callback(*args):
+            callback_args.append(args)
+            callback_event.set()
+
+        await self.emit(event, data=data, namespace=namespace,
+                        callback=event_callback)
+        try:
+            await asyncio.wait_for(callback_event.wait(), timeout)
+        except asyncio.TimeoutError:
+            six.raise_from(exceptions.TimeoutError(), None)
+        return callback_args[0] if len(callback_args[0]) > 1 \
+            else callback_args[0][0] if len(callback_args[0]) == 1 \
+            else None
+
+    async def disconnect(self):
+        """Disconnect from the server.
+
+        Note: this method is a coroutine.
+        """
+        # here we just request the disconnection
+        # later in _handle_eio_disconnect we invoke the disconnect handler
+        for n in self.namespaces:
+            await self._send_packet(packet.Packet(packet.DISCONNECT,
+                                    namespace=n))
+        await self._send_packet(packet.Packet(
+            packet.DISCONNECT, namespace='/'))
+        await self.eio.disconnect(abort=True)
+
+    def start_background_task(self, target, *args, **kwargs):
+        """Start a background task using the appropriate async model.
+
+        This is a utility function that applications can use to start a
+        background task using the method that is compatible with the
+        selected async mode.
+
+        :param target: the target function to execute.
+        :param args: arguments to pass to the function.
+        :param kwargs: keyword arguments to pass to the function.
+
+        This function returns an object compatible with the `Thread` class in
+        the Python standard library. The `start()` method on this object is
+        already called by this function.
+        """
+        return self.eio.start_background_task(target, *args, **kwargs)
+
+    async def sleep(self, seconds=0):
+        """Sleep for the requested amount of time using the appropriate async
+        model.
+
+        This is a utility function that applications can use to put a task to
+        sleep without having to worry about using the correct call for the
+        selected async mode.
+
+        Note: this method is a coroutine.
+        """
+        return await self.eio.sleep(seconds)
+
+    async def _send_packet(self, pkt):
+        """Send a Socket.IO packet to the server."""
+        encoded_packet = pkt.encode()
+        if isinstance(encoded_packet, list):
+            binary = False
+            for ep in encoded_packet:
+                await self.eio.send(ep, binary=binary)
+                binary = True
+        else:
+            await self.eio.send(encoded_packet, binary=False)
+
+    async def _handle_connect(self, namespace):
+        namespace = namespace or '/'
+        self.logger.info('Namespace {} is connected'.format(namespace))
+        await self._trigger_event('connect', namespace=namespace)
+        if namespace == '/':
+            for n in self.namespaces:
+                await self._send_packet(packet.Packet(packet.CONNECT,
+                                        namespace=n))
+        elif namespace not in self.namespaces:
+            self.namespaces.append(namespace)
+
+    async def _handle_disconnect(self, namespace):
+        namespace = namespace or '/'
+        await self._trigger_event('disconnect', namespace=namespace)
+        if namespace in self.namespaces:
+            self.namespaces.remove(namespace)
+
+    async def _handle_event(self, namespace, id, data):
+        namespace = namespace or '/'
+        self.logger.info('Received event "%s" [%s]', data[0], namespace)
+        r = await self._trigger_event(data[0], namespace, *data[1:])
+        if id is not None:
+            # send ACK packet with the response returned by the handler
+            # tuples are expanded as multiple arguments
+            if r is None:
+                data = []
+            elif isinstance(r, tuple):
+                data = list(r)
+            else:
+                data = [r]
+            if six.PY2 and not self.binary:
+                binary = False  # pragma: nocover
+            else:
+                binary = None
+            await self._send_packet(packet.Packet(
+                packet.ACK, namespace=namespace, id=id, data=data,
+                binary=binary))
+
+    async def _handle_ack(self, namespace, id, data):
+        namespace = namespace or '/'
+        self.logger.info('Received ack [%s]', namespace)
+        callback = None
+        try:
+            callback = self.callbacks[namespace][id]
+        except KeyError:
+            # if we get an unknown callback we just ignore it
+            self.logger.warning('Unknown callback received, ignoring.')
+        else:
+            del self.callbacks[namespace][id]
+        if callback is not None:
+            if asyncio.iscoroutinefunction(callback):
+                await callback(*data)
+            else:
+                callback(*data)
+
+    def _handle_error(self, namespace):
+        namespace = namespace or '/'
+        self.logger.info('Connection to namespace {} was rejected'.format(
+            namespace))
+        if namespace in self.namespaces:
+            self.namespaces.remove(namespace)
+
+    async def _trigger_event(self, event, namespace, *args):
+        """Invoke an application event handler."""
+        # first see if we have an explicit handler for the event
+        if namespace in self.handlers and event in self.handlers[namespace]:
+            if asyncio.iscoroutinefunction(self.handlers[namespace][event]):
+                try:
+                    ret = await self.handlers[namespace][event](*args)
+                except asyncio.CancelledError:  # pragma: no cover
+                    ret = None
+            else:
+                ret = self.handlers[namespace][event](*args)
+            return ret
+
+        # or else, forward the event to a namepsace handler if one exists
+        elif namespace in self.namespace_handlers:
+            return await self.namespace_handlers[namespace].trigger_event(
+                event, *args)
+
+    async def _handle_reconnect(self):
+        self._reconnect_abort.clear()
+        client.reconnecting_clients.append(self)
+        attempt_count = 0
+        current_delay = self.reconnection_delay
+        while True:
+            delay = current_delay
+            current_delay *= 2
+            if delay > self.reconnection_delay_max:
+                delay = self.reconnection_delay_max
+            delay += self.randomization_factor * (2 * random.random() - 1)
+            self.logger.info(
+                'Connection failed, new attempt in {:.02f} seconds'.format(
+                    delay))
+            try:
+                await asyncio.wait_for(self._reconnect_abort.wait(), delay)
+                self.logger.info('Reconnect task aborted')
+                break
+            except (asyncio.TimeoutError, asyncio.CancelledError):
+                pass
+            attempt_count += 1
+            try:
+                await self.connect(self.connection_url,
+                                   headers=self.connection_headers,
+                                   transports=self.connection_transports,
+                                   namespaces=self.connection_namespaces,
+                                   socketio_path=self.socketio_path)
+            except (exceptions.ConnectionError, ValueError):
+                pass
+            else:
+                self.logger.info('Reconnection successful')
+                self._reconnect_task = None
+                break
+            if self.reconnection_attempts and \
+                    attempt_count >= self.reconnection_attempts:
+                self.logger.info(
+                    'Maximum reconnection attempts reached, giving up')
+                break
+        client.reconnecting_clients.remove(self)
+
+    def _handle_eio_connect(self):
+        """Handle the Engine.IO connection event."""
+        self.logger.info('Engine.IO connection established')
+        self.sid = self.eio.sid
+
+    async def _handle_eio_message(self, data):
+        """Dispatch Engine.IO messages."""
+        if self._binary_packet:
+            pkt = self._binary_packet
+            if pkt.add_attachment(data):
+                self._binary_packet = None
+                if pkt.packet_type == packet.BINARY_EVENT:
+                    await self._handle_event(pkt.namespace, pkt.id, pkt.data)
+                else:
+                    await self._handle_ack(pkt.namespace, pkt.id, pkt.data)
+        else:
+            pkt = packet.Packet(encoded_packet=data)
+            if pkt.packet_type == packet.CONNECT:
+                await self._handle_connect(pkt.namespace)
+            elif pkt.packet_type == packet.DISCONNECT:
+                await self._handle_disconnect(pkt.namespace)
+            elif pkt.packet_type == packet.EVENT:
+                await self._handle_event(pkt.namespace, pkt.id, pkt.data)
+            elif pkt.packet_type == packet.ACK:
+                await self._handle_ack(pkt.namespace, pkt.id, pkt.data)
+            elif pkt.packet_type == packet.BINARY_EVENT or \
+                    pkt.packet_type == packet.BINARY_ACK:
+                self._binary_packet = pkt
+            elif pkt.packet_type == packet.ERROR:
+                self._handle_error(pkt.namespace)
+            else:
+                raise ValueError('Unknown packet type.')
+
+    async def _handle_eio_disconnect(self):
+        """Handle the Engine.IO disconnection event."""
+        self.logger.info('Engine.IO connection dropped')
+        self._reconnect_abort.set()
+        for n in self.namespaces:
+            await self._trigger_event('disconnect', namespace=n)
+        await self._trigger_event('disconnect', namespace='/')
+        self.callbacks = {}
+        self._binary_packet = None
+        self.sid = None
+        if self.eio.state == 'connected' and self.reconnection:
+            self._reconnect_task = self.start_background_task(
+                self._handle_reconnect)
+
+    def _engineio_client_class(self):
+        return engineio.AsyncClient
diff --git a/openpype/vendor/python/python_2/socketio/asyncio_manager.py b/openpype/vendor/python/python_2/socketio/asyncio_manager.py
new file mode 100644
index 0000000000..f4496ec7f4
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/asyncio_manager.py
@@ -0,0 +1,58 @@
+import asyncio
+
+from .base_manager import BaseManager
+
+
+class AsyncManager(BaseManager):
+    """Manage a client list for an asyncio server."""
+    async def emit(self, event, data, namespace, room=None, skip_sid=None,
+                   callback=None, **kwargs):
+        """Emit a message to a single client, a room, or all the clients
+        connected to the namespace.
+
+        Note: this method is a coroutine.
+        """
+        if namespace not in self.rooms or room not in self.rooms[namespace]:
+            return
+        tasks = []
+        if not isinstance(skip_sid, list):
+            skip_sid = [skip_sid]
+        for sid in self.get_participants(namespace, room):
+            if sid not in skip_sid:
+                if callback is not None:
+                    id = self._generate_ack_id(sid, namespace, callback)
+                else:
+                    id = None
+                tasks.append(self.server._emit_internal(sid, event, data,
+                                                        namespace, id))
+        if tasks == []:  # pragma: no cover
+            return
+        await asyncio.wait(tasks)
+
+    async def close_room(self, room, namespace):
+        """Remove all participants from a room.
+
+        Note: this method is a coroutine.
+        """
+        return super().close_room(room, namespace)
+
+    async def trigger_callback(self, sid, namespace, id, data):
+        """Invoke an application callback.
+
+        Note: this method is a coroutine.
+        """
+        callback = None
+        try:
+            callback = self.callbacks[sid][namespace][id]
+        except KeyError:
+            # if we get an unknown callback we just ignore it
+            self._get_logger().warning('Unknown callback received, ignoring.')
+        else:
+            del self.callbacks[sid][namespace][id]
+        if callback is not None:
+            ret = callback(*data)
+            if asyncio.iscoroutine(ret):
+                try:
+                    await ret
+                except asyncio.CancelledError:  # pragma: no cover
+                    pass
diff --git a/openpype/vendor/python/python_2/socketio/asyncio_namespace.py b/openpype/vendor/python/python_2/socketio/asyncio_namespace.py
new file mode 100644
index 0000000000..12e9c0fe62
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/asyncio_namespace.py
@@ -0,0 +1,204 @@
+import asyncio
+
+from socketio import namespace
+
+
+class AsyncNamespace(namespace.Namespace):
+    """Base class for asyncio server-side class-based namespaces.
+
+    A class-based namespace is a class that contains all the event handlers
+    for a Socket.IO namespace. The event handlers are methods of the class
+    with the prefix ``on_``, such as ``on_connect``, ``on_disconnect``,
+    ``on_message``, ``on_json``, and so on. These can be regular functions or
+    coroutines.
+
+    :param namespace: The Socket.IO namespace to be used with all the event
+                      handlers defined in this class. If this argument is
+                      omitted, the default namespace is used.
+    """
+    def is_asyncio_based(self):
+        return True
+
+    async def trigger_event(self, event, *args):
+        """Dispatch an event to the proper handler method.
+
+        In the most common usage, this method is not overloaded by subclasses,
+        as it performs the routing of events to methods. However, this
+        method can be overriden if special dispatching rules are needed, or if
+        having a single method that catches all events is desired.
+
+        Note: this method is a coroutine.
+        """
+        handler_name = 'on_' + event
+        if hasattr(self, handler_name):
+            handler = getattr(self, handler_name)
+            if asyncio.iscoroutinefunction(handler) is True:
+                try:
+                    ret = await handler(*args)
+                except asyncio.CancelledError:  # pragma: no cover
+                    ret = None
+            else:
+                ret = handler(*args)
+            return ret
+
+    async def emit(self, event, data=None, room=None, skip_sid=None,
+                   namespace=None, callback=None):
+        """Emit a custom event to one or more connected clients.
+
+        The only difference with the :func:`socketio.Server.emit` method is
+        that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+
+        Note: this method is a coroutine.
+        """
+        return await self.server.emit(event, data=data, room=room,
+                                      skip_sid=skip_sid,
+                                      namespace=namespace or self.namespace,
+                                      callback=callback)
+
+    async def send(self, data, room=None, skip_sid=None, namespace=None,
+                   callback=None):
+        """Send a message to one or more connected clients.
+
+        The only difference with the :func:`socketio.Server.send` method is
+        that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+
+        Note: this method is a coroutine.
+        """
+        return await self.server.send(data, room=room, skip_sid=skip_sid,
+                                      namespace=namespace or self.namespace,
+                                      callback=callback)
+
+    async def close_room(self, room, namespace=None):
+        """Close a room.
+
+        The only difference with the :func:`socketio.Server.close_room` method
+        is that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+
+        Note: this method is a coroutine.
+        """
+        return await self.server.close_room(
+            room, namespace=namespace or self.namespace)
+
+    async def get_session(self, sid, namespace=None):
+        """Return the user session for a client.
+
+        The only difference with the :func:`socketio.Server.get_session`
+        method is that when the ``namespace`` argument is not given the
+        namespace associated with the class is used.
+
+        Note: this method is a coroutine.
+        """
+        return await self.server.get_session(
+            sid, namespace=namespace or self.namespace)
+
+    async def save_session(self, sid, session, namespace=None):
+        """Store the user session for a client.
+
+        The only difference with the :func:`socketio.Server.save_session`
+        method is that when the ``namespace`` argument is not given the
+        namespace associated with the class is used.
+
+        Note: this method is a coroutine.
+        """
+        return await self.server.save_session(
+            sid, session, namespace=namespace or self.namespace)
+
+    def session(self, sid, namespace=None):
+        """Return the user session for a client with context manager syntax.
+
+        The only difference with the :func:`socketio.Server.session` method is
+        that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.server.session(sid, namespace=namespace or self.namespace)
+
+    async def disconnect(self, sid, namespace=None):
+        """Disconnect a client.
+
+        The only difference with the :func:`socketio.Server.disconnect` method
+        is that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+
+        Note: this method is a coroutine.
+        """
+        return await self.server.disconnect(
+            sid, namespace=namespace or self.namespace)
+
+
+class AsyncClientNamespace(namespace.ClientNamespace):
+    """Base class for asyncio client-side class-based namespaces.
+
+    A class-based namespace is a class that contains all the event handlers
+    for a Socket.IO namespace. The event handlers are methods of the class
+    with the prefix ``on_``, such as ``on_connect``, ``on_disconnect``,
+    ``on_message``, ``on_json``, and so on. These can be regular functions or
+    coroutines.
+
+    :param namespace: The Socket.IO namespace to be used with all the event
+                      handlers defined in this class. If this argument is
+                      omitted, the default namespace is used.
+    """
+    def is_asyncio_based(self):
+        return True
+
+    async def trigger_event(self, event, *args):
+        """Dispatch an event to the proper handler method.
+
+        In the most common usage, this method is not overloaded by subclasses,
+        as it performs the routing of events to methods. However, this
+        method can be overriden if special dispatching rules are needed, or if
+        having a single method that catches all events is desired.
+
+        Note: this method is a coroutine.
+        """
+        handler_name = 'on_' + event
+        if hasattr(self, handler_name):
+            handler = getattr(self, handler_name)
+            if asyncio.iscoroutinefunction(handler) is True:
+                try:
+                    ret = await handler(*args)
+                except asyncio.CancelledError:  # pragma: no cover
+                    ret = None
+            else:
+                ret = handler(*args)
+            return ret
+
+    async def emit(self, event, data=None, namespace=None, callback=None):
+        """Emit a custom event to the server.
+
+        The only difference with the :func:`socketio.Client.emit` method is
+        that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+
+        Note: this method is a coroutine.
+        """
+        return await self.client.emit(event, data=data,
+                                      namespace=namespace or self.namespace,
+                                      callback=callback)
+
+    async def send(self, data, namespace=None, callback=None):
+        """Send a message to the server.
+
+        The only difference with the :func:`socketio.Client.send` method is
+        that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+
+        Note: this method is a coroutine.
+        """
+        return await self.client.send(data,
+                                      namespace=namespace or self.namespace,
+                                      callback=callback)
+
+    async def disconnect(self):
+        """Disconnect a client.
+
+        The only difference with the :func:`socketio.Client.disconnect` method
+        is that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+
+        Note: this method is a coroutine.
+        """
+        return await self.client.disconnect()
diff --git a/openpype/vendor/python/python_2/socketio/asyncio_pubsub_manager.py b/openpype/vendor/python/python_2/socketio/asyncio_pubsub_manager.py
new file mode 100644
index 0000000000..6fdba6d0ce
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/asyncio_pubsub_manager.py
@@ -0,0 +1,163 @@
+from functools import partial
+import uuid
+
+import json
+import pickle
+import six
+
+from .asyncio_manager import AsyncManager
+
+
+class AsyncPubSubManager(AsyncManager):
+    """Manage a client list attached to a pub/sub backend under asyncio.
+
+    This is a base class that enables multiple servers to share the list of
+    clients, with the servers communicating events through a pub/sub backend.
+    The use of a pub/sub backend also allows any client connected to the
+    backend to emit events addressed to Socket.IO clients.
+
+    The actual backends must be implemented by subclasses, this class only
+    provides a pub/sub generic framework for asyncio applications.
+
+    :param channel: The channel name on which the server sends and receives
+                    notifications.
+    """
+    name = 'asyncpubsub'
+
+    def __init__(self, channel='socketio', write_only=False, logger=None):
+        super().__init__()
+        self.channel = channel
+        self.write_only = write_only
+        self.host_id = uuid.uuid4().hex
+        self.logger = logger
+
+    def initialize(self):
+        super().initialize()
+        if not self.write_only:
+            self.thread = self.server.start_background_task(self._thread)
+        self._get_logger().info(self.name + ' backend initialized.')
+
+    async def emit(self, event, data, namespace=None, room=None, skip_sid=None,
+                   callback=None, **kwargs):
+        """Emit a message to a single client, a room, or all the clients
+        connected to the namespace.
+
+        This method takes care or propagating the message to all the servers
+        that are connected through the message queue.
+
+        The parameters are the same as in :meth:`.Server.emit`.
+
+        Note: this method is a coroutine.
+        """
+        if kwargs.get('ignore_queue'):
+            return await super().emit(
+                event, data, namespace=namespace, room=room, skip_sid=skip_sid,
+                callback=callback)
+        namespace = namespace or '/'
+        if callback is not None:
+            if self.server is None:
+                raise RuntimeError('Callbacks can only be issued from the '
+                                   'context of a server.')
+            if room is None:
+                raise ValueError('Cannot use callback without a room set.')
+            id = self._generate_ack_id(room, namespace, callback)
+            callback = (room, namespace, id)
+        else:
+            callback = None
+        await self._publish({'method': 'emit', 'event': event, 'data': data,
+                             'namespace': namespace, 'room': room,
+                             'skip_sid': skip_sid, 'callback': callback,
+                             'host_id': self.host_id})
+
+    async def close_room(self, room, namespace=None):
+        await self._publish({'method': 'close_room', 'room': room,
+                             'namespace': namespace or '/'})
+
+    async def _publish(self, data):
+        """Publish a message on the Socket.IO channel.
+
+        This method needs to be implemented by the different subclasses that
+        support pub/sub backends.
+        """
+        raise NotImplementedError('This method must be implemented in a '
+                                  'subclass.')  # pragma: no cover
+
+    async def _listen(self):
+        """Return the next message published on the Socket.IO channel,
+        blocking until a message is available.
+
+        This method needs to be implemented by the different subclasses that
+        support pub/sub backends.
+        """
+        raise NotImplementedError('This method must be implemented in a '
+                                  'subclass.')  # pragma: no cover
+
+    async def _handle_emit(self, message):
+        # Events with callbacks are very tricky to handle across hosts
+        # Here in the receiving end we set up a local callback that preserves
+        # the callback host and id from the sender
+        remote_callback = message.get('callback')
+        remote_host_id = message.get('host_id')
+        if remote_callback is not None and len(remote_callback) == 3:
+            callback = partial(self._return_callback, remote_host_id,
+                               *remote_callback)
+        else:
+            callback = None
+        await super().emit(message['event'], message['data'],
+                           namespace=message.get('namespace'),
+                           room=message.get('room'),
+                           skip_sid=message.get('skip_sid'),
+                           callback=callback)
+
+    async def _handle_callback(self, message):
+        if self.host_id == message.get('host_id'):
+            try:
+                sid = message['sid']
+                namespace = message['namespace']
+                id = message['id']
+                args = message['args']
+            except KeyError:
+                return
+            await self.trigger_callback(sid, namespace, id, args)
+
+    async def _return_callback(self, host_id, sid, namespace, callback_id,
+                               *args):
+        # When an event callback is received, the callback is returned back
+        # the sender, which is identified by the host_id
+        await self._publish({'method': 'callback', 'host_id': host_id,
+                             'sid': sid, 'namespace': namespace,
+                             'id': callback_id, 'args': args})
+
+    async def _handle_close_room(self, message):
+        await super().close_room(
+            room=message.get('room'), namespace=message.get('namespace'))
+
+    async def _thread(self):
+        while True:
+            try:
+                message = await self._listen()
+            except:
+                import traceback
+                traceback.print_exc()
+                break
+            data = None
+            if isinstance(message, dict):
+                data = message
+            else:
+                if isinstance(message, six.binary_type):  # pragma: no cover
+                    try:
+                        data = pickle.loads(message)
+                    except:
+                        pass
+                if data is None:
+                    try:
+                        data = json.loads(message)
+                    except:
+                        pass
+            if data and 'method' in data:
+                if data['method'] == 'emit':
+                    await self._handle_emit(data)
+                elif data['method'] == 'callback':
+                    await self._handle_callback(data)
+                elif data['method'] == 'close_room':
+                    await self._handle_close_room(data)
diff --git a/openpype/vendor/python/python_2/socketio/asyncio_redis_manager.py b/openpype/vendor/python/python_2/socketio/asyncio_redis_manager.py
new file mode 100644
index 0000000000..21499c26c5
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/asyncio_redis_manager.py
@@ -0,0 +1,107 @@
+import asyncio
+import pickle
+from urllib.parse import urlparse
+
+try:
+    import aioredis
+except ImportError:
+    aioredis = None
+
+from .asyncio_pubsub_manager import AsyncPubSubManager
+
+
+def _parse_redis_url(url):
+    p = urlparse(url)
+    if p.scheme not in {'redis', 'rediss'}:
+        raise ValueError('Invalid redis url')
+    ssl = p.scheme == 'rediss'
+    host = p.hostname or 'localhost'
+    port = p.port or 6379
+    password = p.password
+    if p.path:
+        db = int(p.path[1:])
+    else:
+        db = 0
+    return host, port, password, db, ssl
+
+
+class AsyncRedisManager(AsyncPubSubManager):  # pragma: no cover
+    """Redis based client manager for asyncio servers.
+
+    This class implements a Redis backend for event sharing across multiple
+    processes. Only kept here as one more example of how to build a custom
+    backend, since the kombu backend is perfectly adequate to support a Redis
+    message queue.
+
+    To use a Redis backend, initialize the :class:`Server` instance as
+    follows::
+
+        server = socketio.Server(client_manager=socketio.AsyncRedisManager(
+            'redis://hostname:port/0'))
+
+    :param url: The connection URL for the Redis server. For a default Redis
+                store running on the same host, use ``redis://``.  To use an
+                SSL connection, use ``rediss://``.
+    :param channel: The channel name on which the server sends and receives
+                    notifications. Must be the same in all the servers.
+    :param write_only: If set ot ``True``, only initialize to emit events. The
+                       default of ``False`` initializes the class for emitting
+                       and receiving.
+    """
+    name = 'aioredis'
+
+    def __init__(self, url='redis://localhost:6379/0', channel='socketio',
+                 write_only=False, logger=None):
+        if aioredis is None:
+            raise RuntimeError('Redis package is not installed '
+                               '(Run "pip install aioredis" in your '
+                               'virtualenv).')
+        (
+            self.host, self.port, self.password, self.db, self.ssl
+        ) = _parse_redis_url(url)
+        self.pub = None
+        self.sub = None
+        super().__init__(channel=channel, write_only=write_only, logger=logger)
+
+    async def _publish(self, data):
+        retry = True
+        while True:
+            try:
+                if self.pub is None:
+                    self.pub = await aioredis.create_redis(
+                        (self.host, self.port), db=self.db,
+                        password=self.password, ssl=self.ssl
+                    )
+                return await self.pub.publish(self.channel,
+                                              pickle.dumps(data))
+            except (aioredis.RedisError, OSError):
+                if retry:
+                    self._get_logger().error('Cannot publish to redis... '
+                                             'retrying')
+                    self.pub = None
+                    retry = False
+                else:
+                    self._get_logger().error('Cannot publish to redis... '
+                                             'giving up')
+                    break
+
+    async def _listen(self):
+        retry_sleep = 1
+        while True:
+            try:
+                if self.sub is None:
+                    self.sub = await aioredis.create_redis(
+                        (self.host, self.port), db=self.db,
+                        password=self.password, ssl=self.ssl
+                    )
+                self.ch = (await self.sub.subscribe(self.channel))[0]
+                return await self.ch.get()
+            except (aioredis.RedisError, OSError):
+                self._get_logger().error('Cannot receive from redis... '
+                                         'retrying in '
+                                         '{} secs'.format(retry_sleep))
+                self.sub = None
+                await asyncio.sleep(retry_sleep)
+                retry_sleep *= 2
+                if retry_sleep > 60:
+                    retry_sleep = 60
diff --git a/openpype/vendor/python/python_2/socketio/asyncio_server.py b/openpype/vendor/python/python_2/socketio/asyncio_server.py
new file mode 100644
index 0000000000..45f5d86bba
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/asyncio_server.py
@@ -0,0 +1,515 @@
+import asyncio
+
+import engineio
+import six
+
+from . import asyncio_manager
+from . import exceptions
+from . import packet
+from . import server
+
+
+class AsyncServer(server.Server):
+    """A Socket.IO server for asyncio.
+
+    This class implements a fully compliant Socket.IO web server with support
+    for websocket and long-polling transports, compatible with the asyncio
+    framework on Python 3.5 or newer.
+
+    :param client_manager: The client manager instance that will manage the
+                           client list. When this is omitted, the client list
+                           is stored in an in-memory structure, so the use of
+                           multiple connected servers is not possible.
+    :param logger: To enable logging set to ``True`` or pass a logger object to
+                   use. To disable logging set to ``False``.
+    :param json: An alternative json module to use for encoding and decoding
+                 packets. Custom json modules must have ``dumps`` and ``loads``
+                 functions that are compatible with the standard library
+                 versions.
+    :param async_handlers: If set to ``True``, event handlers are executed in
+                           separate threads. To run handlers synchronously,
+                           set to ``False``. The default is ``True``.
+    :param kwargs: Connection parameters for the underlying Engine.IO server.
+
+    The Engine.IO configuration supports the following settings:
+
+    :param async_mode: The asynchronous model to use. See the Deployment
+                       section in the documentation for a description of the
+                       available options. Valid async modes are "aiohttp". If
+                       this argument is not given, an async mode is chosen
+                       based on the installed packages.
+    :param ping_timeout: The time in seconds that the client waits for the
+                         server to respond before disconnecting.
+    :param ping_interval: The interval in seconds at which the client pings
+                          the server.
+    :param max_http_buffer_size: The maximum size of a message when using the
+                                 polling transport.
+    :param allow_upgrades: Whether to allow transport upgrades or not.
+    :param http_compression: Whether to compress packages when using the
+                             polling transport.
+    :param compression_threshold: Only compress messages when their byte size
+                                  is greater than this value.
+    :param cookie: Name of the HTTP cookie that contains the client session
+                   id. If set to ``None``, a cookie is not sent to the client.
+    :param cors_allowed_origins: List of origins that are allowed to connect
+                                 to this server. All origins are allowed by
+                                 default.
+    :param cors_credentials: Whether credentials (cookies, authentication) are
+                             allowed in requests to this server.
+    :param engineio_logger: To enable Engine.IO logging set to ``True`` or pass
+                            a logger object to use. To disable logging set to
+                            ``False``.
+    """
+    def __init__(self, client_manager=None, logger=False, json=None,
+                 async_handlers=True, **kwargs):
+        if client_manager is None:
+            client_manager = asyncio_manager.AsyncManager()
+        super().__init__(client_manager=client_manager, logger=logger,
+                         binary=False, json=json,
+                         async_handlers=async_handlers, **kwargs)
+
+    def is_asyncio_based(self):
+        return True
+
+    def attach(self, app, socketio_path='socket.io'):
+        """Attach the Socket.IO server to an application."""
+        self.eio.attach(app, socketio_path)
+
+    async def emit(self, event, data=None, to=None, room=None, skip_sid=None,
+                   namespace=None, callback=None, **kwargs):
+        """Emit a custom event to one or more connected clients.
+
+        :param event: The event name. It can be any string. The event names
+                      ``'connect'``, ``'message'`` and ``'disconnect'`` are
+                      reserved and should not be used.
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param to: The recipient of the message. This can be set to the
+                   session ID of a client to address only that client, or to
+                   to any custom room created by the application to address all
+                   the clients in that room, If this argument is omitted the
+                   event is broadcasted to all connected clients.
+        :param room: Alias for the ``to`` parameter.
+        :param skip_sid: The session ID of a client to skip when broadcasting
+                         to a room or to all clients. This can be used to
+                         prevent a message from being sent to the sender.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param callback: If given, this function will be called to acknowledge
+                         the the client has received the message. The arguments
+                         that will be passed to the function are those provided
+                         by the client. Callback functions can only be used
+                         when addressing an individual client.
+        :param ignore_queue: Only used when a message queue is configured. If
+                             set to ``True``, the event is emitted to the
+                             clients directly, without going through the queue.
+                             This is more efficient, but only works when a
+                             single server process is used. It is recommended
+                             to always leave this parameter with its default
+                             value of ``False``.
+
+        Note: this method is a coroutine.
+        """
+        namespace = namespace or '/'
+        room = to or room
+        self.logger.info('emitting event "%s" to %s [%s]', event,
+                         room or 'all', namespace)
+        await self.manager.emit(event, data, namespace, room=room,
+                                skip_sid=skip_sid, callback=callback,
+                                **kwargs)
+
+    async def send(self, data, to=None, room=None, skip_sid=None,
+                   namespace=None, callback=None, **kwargs):
+        """Send a message to one or more connected clients.
+
+        This function emits an event with the name ``'message'``. Use
+        :func:`emit` to issue custom event names.
+
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param to: The recipient of the message. This can be set to the
+                   session ID of a client to address only that client, or to
+                   to any custom room created by the application to address all
+                   the clients in that room, If this argument is omitted the
+                   event is broadcasted to all connected clients.
+        :param room: Alias for the ``to`` parameter.
+        :param skip_sid: The session ID of a client to skip when broadcasting
+                         to a room or to all clients. This can be used to
+                         prevent a message from being sent to the sender.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param callback: If given, this function will be called to acknowledge
+                         the the client has received the message. The arguments
+                         that will be passed to the function are those provided
+                         by the client. Callback functions can only be used
+                         when addressing an individual client.
+        :param ignore_queue: Only used when a message queue is configured. If
+                             set to ``True``, the event is emitted to the
+                             clients directly, without going through the queue.
+                             This is more efficient, but only works when a
+                             single server process is used. It is recommended
+                             to always leave this parameter with its default
+                             value of ``False``.
+
+        Note: this method is a coroutine.
+        """
+        await self.emit('message', data=data, to=to, room=room,
+                        skip_sid=skip_sid, namespace=namespace,
+                        callback=callback, **kwargs)
+
+    async def call(self, event, data=None, to=None, sid=None, namespace=None,
+                   timeout=60, **kwargs):
+        """Emit a custom event to a client and wait for the response.
+
+        :param event: The event name. It can be any string. The event names
+                      ``'connect'``, ``'message'`` and ``'disconnect'`` are
+                      reserved and should not be used.
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param to: The session ID of the recipient client.
+        :param sid: Alias for the ``to`` parameter.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param timeout: The waiting timeout. If the timeout is reached before
+                        the client acknowledges the event, then a
+                        ``TimeoutError`` exception is raised.
+        :param ignore_queue: Only used when a message queue is configured. If
+                             set to ``True``, the event is emitted to the
+                             client directly, without going through the queue.
+                             This is more efficient, but only works when a
+                             single server process is used. It is recommended
+                             to always leave this parameter with its default
+                             value of ``False``.
+        """
+        if not self.async_handlers:
+            raise RuntimeError(
+                'Cannot use call() when async_handlers is False.')
+        callback_event = self.eio.create_event()
+        callback_args = []
+
+        def event_callback(*args):
+            callback_args.append(args)
+            callback_event.set()
+
+        await self.emit(event, data=data, room=to or sid, namespace=namespace,
+                        callback=event_callback, **kwargs)
+        try:
+            await asyncio.wait_for(callback_event.wait(), timeout)
+        except asyncio.TimeoutError:
+            six.raise_from(exceptions.TimeoutError(), None)
+        return callback_args[0] if len(callback_args[0]) > 1 \
+            else callback_args[0][0] if len(callback_args[0]) == 1 \
+            else None
+
+    async def close_room(self, room, namespace=None):
+        """Close a room.
+
+        This function removes all the clients from the given room.
+
+        :param room: Room name.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the default namespace is used.
+
+        Note: this method is a coroutine.
+        """
+        namespace = namespace or '/'
+        self.logger.info('room %s is closing [%s]', room, namespace)
+        await self.manager.close_room(room, namespace)
+
+    async def get_session(self, sid, namespace=None):
+        """Return the user session for a client.
+
+        :param sid: The session id of the client.
+        :param namespace: The Socket.IO namespace. If this argument is omitted
+                          the default namespace is used.
+
+        The return value is a dictionary. Modifications made to this
+        dictionary are not guaranteed to be preserved. If you want to modify
+        the user session, use the ``session`` context manager instead.
+        """
+        namespace = namespace or '/'
+        eio_session = await self.eio.get_session(sid)
+        return eio_session.setdefault(namespace, {})
+
+    async def save_session(self, sid, session, namespace=None):
+        """Store the user session for a client.
+
+        :param sid: The session id of the client.
+        :param session: The session dictionary.
+        :param namespace: The Socket.IO namespace. If this argument is omitted
+                          the default namespace is used.
+        """
+        namespace = namespace or '/'
+        eio_session = await self.eio.get_session(sid)
+        eio_session[namespace] = session
+
+    def session(self, sid, namespace=None):
+        """Return the user session for a client with context manager syntax.
+
+        :param sid: The session id of the client.
+
+        This is a context manager that returns the user session dictionary for
+        the client. Any changes that are made to this dictionary inside the
+        context manager block are saved back to the session. Example usage::
+
+            @eio.on('connect')
+            def on_connect(sid, environ):
+                username = authenticate_user(environ)
+                if not username:
+                    return False
+                with eio.session(sid) as session:
+                    session['username'] = username
+
+            @eio.on('message')
+            def on_message(sid, msg):
+                async with eio.session(sid) as session:
+                    print('received message from ', session['username'])
+        """
+        class _session_context_manager(object):
+            def __init__(self, server, sid, namespace):
+                self.server = server
+                self.sid = sid
+                self.namespace = namespace
+                self.session = None
+
+            async def __aenter__(self):
+                self.session = await self.server.get_session(
+                    sid, namespace=self.namespace)
+                return self.session
+
+            async def __aexit__(self, *args):
+                await self.server.save_session(sid, self.session,
+                                               namespace=self.namespace)
+
+        return _session_context_manager(self, sid, namespace)
+
+    async def disconnect(self, sid, namespace=None):
+        """Disconnect a client.
+
+        :param sid: Session ID of the client.
+        :param namespace: The Socket.IO namespace to disconnect. If this
+                          argument is omitted the default namespace is used.
+
+        Note: this method is a coroutine.
+        """
+        namespace = namespace or '/'
+        if self.manager.is_connected(sid, namespace=namespace):
+            self.logger.info('Disconnecting %s [%s]', sid, namespace)
+            self.manager.pre_disconnect(sid, namespace=namespace)
+            await self._send_packet(sid, packet.Packet(packet.DISCONNECT,
+                                                       namespace=namespace))
+            await self._trigger_event('disconnect', namespace, sid)
+            self.manager.disconnect(sid, namespace=namespace)
+
+    async def handle_request(self, *args, **kwargs):
+        """Handle an HTTP request from the client.
+
+        This is the entry point of the Socket.IO application. This function
+        returns the HTTP response body to deliver to the client.
+
+        Note: this method is a coroutine.
+        """
+        return await self.eio.handle_request(*args, **kwargs)
+
+    def start_background_task(self, target, *args, **kwargs):
+        """Start a background task using the appropriate async model.
+
+        This is a utility function that applications can use to start a
+        background task using the method that is compatible with the
+        selected async mode.
+
+        :param target: the target function to execute. Must be a coroutine.
+        :param args: arguments to pass to the function.
+        :param kwargs: keyword arguments to pass to the function.
+
+        The return value is a ``asyncio.Task`` object.
+
+        Note: this method is a coroutine.
+        """
+        return self.eio.start_background_task(target, *args, **kwargs)
+
+    async def sleep(self, seconds=0):
+        """Sleep for the requested amount of time using the appropriate async
+        model.
+
+        This is a utility function that applications can use to put a task to
+        sleep without having to worry about using the correct call for the
+        selected async mode.
+
+        Note: this method is a coroutine.
+        """
+        return await self.eio.sleep(seconds)
+
+    async def _emit_internal(self, sid, event, data, namespace=None, id=None):
+        """Send a message to a client."""
+        # tuples are expanded to multiple arguments, everything else is sent
+        # as a single argument
+        if isinstance(data, tuple):
+            data = list(data)
+        else:
+            data = [data]
+        await self._send_packet(sid, packet.Packet(
+            packet.EVENT, namespace=namespace, data=[event] + data, id=id,
+            binary=None))
+
+    async def _send_packet(self, sid, pkt):
+        """Send a Socket.IO packet to a client."""
+        encoded_packet = pkt.encode()
+        if isinstance(encoded_packet, list):
+            binary = False
+            for ep in encoded_packet:
+                await self.eio.send(sid, ep, binary=binary)
+                binary = True
+        else:
+            await self.eio.send(sid, encoded_packet, binary=False)
+
+    async def _handle_connect(self, sid, namespace):
+        """Handle a client connection request."""
+        namespace = namespace or '/'
+        self.manager.connect(sid, namespace)
+        if self.always_connect:
+            await self._send_packet(sid, packet.Packet(packet.CONNECT,
+                                                       namespace=namespace))
+        fail_reason = None
+        try:
+            success = await self._trigger_event('connect', namespace, sid,
+                                                self.environ[sid])
+        except exceptions.ConnectionRefusedError as exc:
+            fail_reason = exc.error_args
+            success = False
+
+        if success is False:
+            if self.always_connect:
+                self.manager.pre_disconnect(sid, namespace)
+                await self._send_packet(sid, packet.Packet(
+                    packet.DISCONNECT, data=fail_reason, namespace=namespace))
+            self.manager.disconnect(sid, namespace)
+            if not self.always_connect:
+                await self._send_packet(sid, packet.Packet(
+                    packet.ERROR, data=fail_reason, namespace=namespace))
+            if sid in self.environ:  # pragma: no cover
+                del self.environ[sid]
+            return False
+        elif not self.always_connect:
+            await self._send_packet(sid, packet.Packet(packet.CONNECT,
+                                                       namespace=namespace))
+
+    async def _handle_disconnect(self, sid, namespace):
+        """Handle a client disconnect."""
+        namespace = namespace or '/'
+        if namespace == '/':
+            namespace_list = list(self.manager.get_namespaces())
+        else:
+            namespace_list = [namespace]
+        for n in namespace_list:
+            if n != '/' and self.manager.is_connected(sid, n):
+                await self._trigger_event('disconnect', n, sid)
+                self.manager.disconnect(sid, n)
+        if namespace == '/' and self.manager.is_connected(sid, namespace):
+            await self._trigger_event('disconnect', '/', sid)
+            self.manager.disconnect(sid, '/')
+
+    async def _handle_event(self, sid, namespace, id, data):
+        """Handle an incoming client event."""
+        namespace = namespace or '/'
+        self.logger.info('received event "%s" from %s [%s]', data[0], sid,
+                         namespace)
+        if self.async_handlers:
+            self.start_background_task(self._handle_event_internal, self, sid,
+                                       data, namespace, id)
+        else:
+            await self._handle_event_internal(self, sid, data, namespace, id)
+
+    async def _handle_event_internal(self, server, sid, data, namespace, id):
+        r = await server._trigger_event(data[0], namespace, sid, *data[1:])
+        if id is not None:
+            # send ACK packet with the response returned by the handler
+            # tuples are expanded as multiple arguments
+            if r is None:
+                data = []
+            elif isinstance(r, tuple):
+                data = list(r)
+            else:
+                data = [r]
+            await server._send_packet(sid, packet.Packet(packet.ACK,
+                                                         namespace=namespace,
+                                                         id=id, data=data,
+                                                         binary=None))
+
+    async def _handle_ack(self, sid, namespace, id, data):
+        """Handle ACK packets from the client."""
+        namespace = namespace or '/'
+        self.logger.info('received ack from %s [%s]', sid, namespace)
+        await self.manager.trigger_callback(sid, namespace, id, data)
+
+    async def _trigger_event(self, event, namespace, *args):
+        """Invoke an application event handler."""
+        # first see if we have an explicit handler for the event
+        if namespace in self.handlers and event in self.handlers[namespace]:
+            if asyncio.iscoroutinefunction(self.handlers[namespace][event]) \
+                    is True:
+                try:
+                    ret = await self.handlers[namespace][event](*args)
+                except asyncio.CancelledError:  # pragma: no cover
+                    ret = None
+            else:
+                ret = self.handlers[namespace][event](*args)
+            return ret
+
+        # or else, forward the event to a namepsace handler if one exists
+        elif namespace in self.namespace_handlers:
+            return await self.namespace_handlers[namespace].trigger_event(
+                event, *args)
+
+    async def _handle_eio_connect(self, sid, environ):
+        """Handle the Engine.IO connection event."""
+        if not self.manager_initialized:
+            self.manager_initialized = True
+            self.manager.initialize()
+        self.environ[sid] = environ
+        return await self._handle_connect(sid, '/')
+
+    async def _handle_eio_message(self, sid, data):
+        """Dispatch Engine.IO messages."""
+        if sid in self._binary_packet:
+            pkt = self._binary_packet[sid]
+            if pkt.add_attachment(data):
+                del self._binary_packet[sid]
+                if pkt.packet_type == packet.BINARY_EVENT:
+                    await self._handle_event(sid, pkt.namespace, pkt.id,
+                                             pkt.data)
+                else:
+                    await self._handle_ack(sid, pkt.namespace, pkt.id,
+                                           pkt.data)
+        else:
+            pkt = packet.Packet(encoded_packet=data)
+            if pkt.packet_type == packet.CONNECT:
+                await self._handle_connect(sid, pkt.namespace)
+            elif pkt.packet_type == packet.DISCONNECT:
+                await self._handle_disconnect(sid, pkt.namespace)
+            elif pkt.packet_type == packet.EVENT:
+                await self._handle_event(sid, pkt.namespace, pkt.id, pkt.data)
+            elif pkt.packet_type == packet.ACK:
+                await self._handle_ack(sid, pkt.namespace, pkt.id, pkt.data)
+            elif pkt.packet_type == packet.BINARY_EVENT or \
+                    pkt.packet_type == packet.BINARY_ACK:
+                self._binary_packet[sid] = pkt
+            elif pkt.packet_type == packet.ERROR:
+                raise ValueError('Unexpected ERROR packet.')
+            else:
+                raise ValueError('Unknown packet type.')
+
+    async def _handle_eio_disconnect(self, sid):
+        """Handle Engine.IO disconnect event."""
+        await self._handle_disconnect(sid, '/')
+        if sid in self.environ:
+            del self.environ[sid]
+
+    def _engineio_server_class(self):
+        return engineio.AsyncServer
diff --git a/openpype/vendor/python/python_2/socketio/base_manager.py b/openpype/vendor/python/python_2/socketio/base_manager.py
new file mode 100644
index 0000000000..3cccb85690
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/base_manager.py
@@ -0,0 +1,178 @@
+import itertools
+import logging
+
+import six
+
+default_logger = logging.getLogger('socketio')
+
+
+class BaseManager(object):
+    """Manage client connections.
+
+    This class keeps track of all the clients and the rooms they are in, to
+    support the broadcasting of messages. The data used by this class is
+    stored in a memory structure, making it appropriate only for single process
+    services. More sophisticated storage backends can be implemented by
+    subclasses.
+    """
+    def __init__(self):
+        self.logger = None
+        self.server = None
+        self.rooms = {}
+        self.callbacks = {}
+        self.pending_disconnect = {}
+
+    def set_server(self, server):
+        self.server = server
+
+    def initialize(self):
+        """Invoked before the first request is received. Subclasses can add
+        their initialization code here.
+        """
+        pass
+
+    def get_namespaces(self):
+        """Return an iterable with the active namespace names."""
+        return six.iterkeys(self.rooms)
+
+    def get_participants(self, namespace, room):
+        """Return an iterable with the active participants in a room."""
+        for sid, active in six.iteritems(self.rooms[namespace][room].copy()):
+            yield sid
+
+    def connect(self, sid, namespace):
+        """Register a client connection to a namespace."""
+        self.enter_room(sid, namespace, None)
+        self.enter_room(sid, namespace, sid)
+
+    def is_connected(self, sid, namespace):
+        if namespace in self.pending_disconnect and \
+                sid in self.pending_disconnect[namespace]:
+            # the client is in the process of being disconnected
+            return False
+        try:
+            return self.rooms[namespace][None][sid]
+        except KeyError:
+            pass
+
+    def pre_disconnect(self, sid, namespace):
+        """Put the client in the to-be-disconnected list.
+
+        This allows the client data structures to be present while the
+        disconnect handler is invoked, but still recognize the fact that the
+        client is soon going away.
+        """
+        if namespace not in self.pending_disconnect:
+            self.pending_disconnect[namespace] = []
+        self.pending_disconnect[namespace].append(sid)
+
+    def disconnect(self, sid, namespace):
+        """Register a client disconnect from a namespace."""
+        if namespace not in self.rooms:
+            return
+        rooms = []
+        for room_name, room in six.iteritems(self.rooms[namespace].copy()):
+            if sid in room:
+                rooms.append(room_name)
+        for room in rooms:
+            self.leave_room(sid, namespace, room)
+        if sid in self.callbacks and namespace in self.callbacks[sid]:
+            del self.callbacks[sid][namespace]
+            if len(self.callbacks[sid]) == 0:
+                del self.callbacks[sid]
+        if namespace in self.pending_disconnect and \
+                sid in self.pending_disconnect[namespace]:
+            self.pending_disconnect[namespace].remove(sid)
+            if len(self.pending_disconnect[namespace]) == 0:
+                del self.pending_disconnect[namespace]
+
+    def enter_room(self, sid, namespace, room):
+        """Add a client to a room."""
+        if namespace not in self.rooms:
+            self.rooms[namespace] = {}
+        if room not in self.rooms[namespace]:
+            self.rooms[namespace][room] = {}
+        self.rooms[namespace][room][sid] = True
+
+    def leave_room(self, sid, namespace, room):
+        """Remove a client from a room."""
+        try:
+            del self.rooms[namespace][room][sid]
+            if len(self.rooms[namespace][room]) == 0:
+                del self.rooms[namespace][room]
+                if len(self.rooms[namespace]) == 0:
+                    del self.rooms[namespace]
+        except KeyError:
+            pass
+
+    def close_room(self, room, namespace):
+        """Remove all participants from a room."""
+        try:
+            for sid in self.get_participants(namespace, room):
+                self.leave_room(sid, namespace, room)
+        except KeyError:
+            pass
+
+    def get_rooms(self, sid, namespace):
+        """Return the rooms a client is in."""
+        r = []
+        try:
+            for room_name, room in six.iteritems(self.rooms[namespace]):
+                if room_name is not None and sid in room and room[sid]:
+                    r.append(room_name)
+        except KeyError:
+            pass
+        return r
+
+    def emit(self, event, data, namespace, room=None, skip_sid=None,
+             callback=None, **kwargs):
+        """Emit a message to a single client, a room, or all the clients
+        connected to the namespace."""
+        if namespace not in self.rooms or room not in self.rooms[namespace]:
+            return
+        if not isinstance(skip_sid, list):
+            skip_sid = [skip_sid]
+        for sid in self.get_participants(namespace, room):
+            if sid not in skip_sid:
+                if callback is not None:
+                    id = self._generate_ack_id(sid, namespace, callback)
+                else:
+                    id = None
+                self.server._emit_internal(sid, event, data, namespace, id)
+
+    def trigger_callback(self, sid, namespace, id, data):
+        """Invoke an application callback."""
+        callback = None
+        try:
+            callback = self.callbacks[sid][namespace][id]
+        except KeyError:
+            # if we get an unknown callback we just ignore it
+            self._get_logger().warning('Unknown callback received, ignoring.')
+        else:
+            del self.callbacks[sid][namespace][id]
+        if callback is not None:
+            callback(*data)
+
+    def _generate_ack_id(self, sid, namespace, callback):
+        """Generate a unique identifier for an ACK packet."""
+        namespace = namespace or '/'
+        if sid not in self.callbacks:
+            self.callbacks[sid] = {}
+        if namespace not in self.callbacks[sid]:
+            self.callbacks[sid][namespace] = {0: itertools.count(1)}
+        id = six.next(self.callbacks[sid][namespace][0])
+        self.callbacks[sid][namespace][id] = callback
+        return id
+
+    def _get_logger(self):
+        """Get the appropriate logger
+
+        Prevents uninitialized servers in write-only mode from failing.
+        """
+
+        if self.logger:
+            return self.logger
+        elif self.server:
+            return self.server.logger
+        else:
+            return default_logger
diff --git a/openpype/vendor/python/python_2/socketio/client.py b/openpype/vendor/python/python_2/socketio/client.py
new file mode 100644
index 0000000000..c0bdc1ab13
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/client.py
@@ -0,0 +1,590 @@
+import itertools
+import logging
+import random
+import signal
+
+import engineio
+import six
+
+from . import exceptions
+from . import namespace
+from . import packet
+
+default_logger = logging.getLogger('socketio.client')
+reconnecting_clients = []
+
+
+def signal_handler(sig, frame):  # pragma: no cover
+    """SIGINT handler.
+
+    Notify any clients that are in a reconnect loop to abort. Other
+    disconnection tasks are handled at the engine.io level.
+    """
+    for client in reconnecting_clients[:]:
+        client._reconnect_abort.set()
+    return original_signal_handler(sig, frame)
+
+
+original_signal_handler = signal.signal(signal.SIGINT, signal_handler)
+
+
+class Client(object):
+    """A Socket.IO client.
+
+    This class implements a fully compliant Socket.IO web client with support
+    for websocket and long-polling transports.
+
+    :param reconnection: ``True`` if the client should automatically attempt to
+                         reconnect to the server after an interruption, or
+                         ``False`` to not reconnect. The default is ``True``.
+    :param reconnection_attempts: How many reconnection attempts to issue
+                                  before giving up, or 0 for infinity attempts.
+                                  The default is 0.
+    :param reconnection_delay: How long to wait in seconds before the first
+                               reconnection attempt. Each successive attempt
+                               doubles this delay.
+    :param reconnection_delay_max: The maximum delay between reconnection
+                                   attempts.
+    :param randomization_factor: Randomization amount for each delay between
+                                 reconnection attempts. The default is 0.5,
+                                 which means that each delay is randomly
+                                 adjusted by +/- 50%.
+    :param logger: To enable logging set to ``True`` or pass a logger object to
+                   use. To disable logging set to ``False``. The default is
+                   ``False``.
+    :param binary: ``True`` to support binary payloads, ``False`` to treat all
+                   payloads as text. On Python 2, if this is set to ``True``,
+                   ``unicode`` values are treated as text, and ``str`` and
+                   ``bytes`` values are treated as binary.  This option has no
+                   effect on Python 3, where text and binary payloads are
+                   always automatically discovered.
+    :param json: An alternative json module to use for encoding and decoding
+                 packets. Custom json modules must have ``dumps`` and ``loads``
+                 functions that are compatible with the standard library
+                 versions.
+
+    The Engine.IO configuration supports the following settings:
+
+    :param engineio_logger: To enable Engine.IO logging set to ``True`` or pass
+                            a logger object to use. To disable logging set to
+                            ``False``. The default is ``False``.
+    """
+    def __init__(self, reconnection=True, reconnection_attempts=0,
+                 reconnection_delay=1, reconnection_delay_max=5,
+                 randomization_factor=0.5, logger=False, binary=False,
+                 json=None, **kwargs):
+        self.reconnection = reconnection
+        self.reconnection_attempts = reconnection_attempts
+        self.reconnection_delay = reconnection_delay
+        self.reconnection_delay_max = reconnection_delay_max
+        self.randomization_factor = randomization_factor
+        self.binary = binary
+
+        engineio_options = kwargs
+        engineio_logger = engineio_options.pop('engineio_logger', None)
+        if engineio_logger is not None:
+            engineio_options['logger'] = engineio_logger
+        if json is not None:
+            packet.Packet.json = json
+            engineio_options['json'] = json
+
+        self.eio = self._engineio_client_class()(**engineio_options)
+        self.eio.on('connect', self._handle_eio_connect)
+        self.eio.on('message', self._handle_eio_message)
+        self.eio.on('disconnect', self._handle_eio_disconnect)
+
+        if not isinstance(logger, bool):
+            self.logger = logger
+        else:
+            self.logger = default_logger
+            if not logging.root.handlers and \
+                    self.logger.level == logging.NOTSET:
+                if logger:
+                    self.logger.setLevel(logging.INFO)
+                else:
+                    self.logger.setLevel(logging.ERROR)
+                self.logger.addHandler(logging.StreamHandler())
+
+        self.connection_url = None
+        self.connection_headers = None
+        self.connection_transports = None
+        self.connection_namespaces = None
+        self.socketio_path = None
+        self.sid = None
+
+        self.namespaces = []
+        self.handlers = {}
+        self.namespace_handlers = {}
+        self.callbacks = {}
+        self._binary_packet = None
+        self._reconnect_task = None
+        self._reconnect_abort = self.eio.create_event()
+
+    def is_asyncio_based(self):
+        return False
+
+    def on(self, event, handler=None, namespace=None):
+        """Register an event handler.
+
+        :param event: The event name. It can be any string. The event names
+                      ``'connect'``, ``'message'`` and ``'disconnect'`` are
+                      reserved and should not be used.
+        :param handler: The function that should be invoked to handle the
+                        event. When this parameter is not given, the method
+                        acts as a decorator for the handler function.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the handler is associated with
+                          the default namespace.
+
+        Example usage::
+
+            # as a decorator:
+            @sio.on('connect')
+            def connect_handler():
+                print('Connected!')
+
+            # as a method:
+            def message_handler(msg):
+                print('Received message: ', msg)
+                sio.send( 'response')
+            sio.on('message', message_handler)
+
+        The ``'connect'`` event handler receives no arguments. The
+        ``'message'`` handler and handlers for custom event names receive the
+        message payload as only argument. Any values returned from a message
+        handler will be passed to the client's acknowledgement callback
+        function if it exists. The ``'disconnect'`` handler does not take
+        arguments.
+        """
+        namespace = namespace or '/'
+
+        def set_handler(handler):
+            if namespace not in self.handlers:
+                self.handlers[namespace] = {}
+            self.handlers[namespace][event] = handler
+            return handler
+
+        if handler is None:
+            return set_handler
+        set_handler(handler)
+
+    def event(self, *args, **kwargs):
+        """Decorator to register an event handler.
+
+        This is a simplified version of the ``on()`` method that takes the
+        event name from the decorated function.
+
+        Example usage::
+
+            @sio.event
+            def my_event(data):
+                print('Received data: ', data)
+
+        The above example is equivalent to::
+
+            @sio.on('my_event')
+            def my_event(data):
+                print('Received data: ', data)
+
+        A custom namespace can be given as an argument to the decorator::
+
+            @sio.event(namespace='/test')
+            def my_event(data):
+                print('Received data: ', data)
+        """
+        if len(args) == 1 and len(kwargs) == 0 and callable(args[0]):
+            # the decorator was invoked without arguments
+            # args[0] is the decorated function
+            return self.on(args[0].__name__)(args[0])
+        else:
+            # the decorator was invoked with arguments
+            def set_handler(handler):
+                return self.on(handler.__name__, *args, **kwargs)(handler)
+
+            return set_handler
+
+    def register_namespace(self, namespace_handler):
+        """Register a namespace handler object.
+
+        :param namespace_handler: An instance of a :class:`Namespace`
+                                  subclass that handles all the event traffic
+                                  for a namespace.
+        """
+        if not isinstance(namespace_handler, namespace.ClientNamespace):
+            raise ValueError('Not a namespace instance')
+        if self.is_asyncio_based() != namespace_handler.is_asyncio_based():
+            raise ValueError('Not a valid namespace class for this client')
+        namespace_handler._set_client(self)
+        self.namespace_handlers[namespace_handler.namespace] = \
+            namespace_handler
+
+    def connect(self, url, headers={}, transports=None,
+                namespaces=None, socketio_path='socket.io'):
+        """Connect to a Socket.IO server.
+
+        :param url: The URL of the Socket.IO server. It can include custom
+                    query string parameters if required by the server.
+        :param headers: A dictionary with custom headers to send with the
+                        connection request.
+        :param transports: The list of allowed transports. Valid transports
+                           are ``'polling'`` and ``'websocket'``. If not
+                           given, the polling transport is connected first,
+                           then an upgrade to websocket is attempted.
+        :param namespaces: The list of custom namespaces to connect, in
+                           addition to the default namespace. If not given,
+                           the namespace list is obtained from the registered
+                           event handlers.
+        :param socketio_path: The endpoint where the Socket.IO server is
+                              installed. The default value is appropriate for
+                              most cases.
+
+        Example usage::
+
+            sio = socketio.Client()
+            sio.connect('http://localhost:5000')
+        """
+        self.connection_url = url
+        self.connection_headers = headers
+        self.connection_transports = transports
+        self.connection_namespaces = namespaces
+        self.socketio_path = socketio_path
+
+        if namespaces is None:
+            namespaces = set(self.handlers.keys()).union(
+                set(self.namespace_handlers.keys()))
+        elif isinstance(namespaces, six.string_types):
+            namespaces = [namespaces]
+            self.connection_namespaces = namespaces
+        self.namespaces = [n for n in namespaces if n != '/']
+        try:
+            self.eio.connect(url, headers=headers, transports=transports,
+                             engineio_path=socketio_path)
+        except engineio.exceptions.ConnectionError as exc:
+            six.raise_from(exceptions.ConnectionError(exc.args[0]), None)
+
+    def wait(self):
+        """Wait until the connection with the server ends.
+
+        Client applications can use this function to block the main thread
+        during the life of the connection.
+        """
+        while True:
+            self.eio.wait()
+            self.sleep(1)  # give the reconnect task time to start up
+            if not self._reconnect_task:
+                break
+            self._reconnect_task.join()
+            if self.eio.state != 'connected':
+                break
+
+    def emit(self, event, data=None, namespace=None, callback=None):
+        """Emit a custom event to one or more connected clients.
+
+        :param event: The event name. It can be any string. The event names
+                      ``'connect'``, ``'message'`` and ``'disconnect'`` are
+                      reserved and should not be used.
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param callback: If given, this function will be called to acknowledge
+                         the the client has received the message. The arguments
+                         that will be passed to the function are those provided
+                         by the client. Callback functions can only be used
+                         when addressing an individual client.
+        """
+        namespace = namespace or '/'
+        self.logger.info('Emitting event "%s" [%s]', event, namespace)
+        if callback is not None:
+            id = self._generate_ack_id(namespace, callback)
+        else:
+            id = None
+        if six.PY2 and not self.binary:
+            binary = False  # pragma: nocover
+        else:
+            binary = None
+        # tuples are expanded to multiple arguments, everything else is sent
+        # as a single argument
+        if isinstance(data, tuple):
+            data = list(data)
+        elif data is not None:
+            data = [data]
+        else:
+            data = []
+        self._send_packet(packet.Packet(packet.EVENT, namespace=namespace,
+                                        data=[event] + data, id=id,
+                                        binary=binary))
+
+    def send(self, data, namespace=None, callback=None):
+        """Send a message to one or more connected clients.
+
+        This function emits an event with the name ``'message'``. Use
+        :func:`emit` to issue custom event names.
+
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param callback: If given, this function will be called to acknowledge
+                         the the client has received the message. The arguments
+                         that will be passed to the function are those provided
+                         by the client. Callback functions can only be used
+                         when addressing an individual client.
+        """
+        self.emit('message', data=data, namespace=namespace,
+                  callback=callback)
+
+    def call(self, event, data=None, namespace=None, timeout=60):
+        """Emit a custom event to a client and wait for the response.
+
+        :param event: The event name. It can be any string. The event names
+                      ``'connect'``, ``'message'`` and ``'disconnect'`` are
+                      reserved and should not be used.
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param timeout: The waiting timeout. If the timeout is reached before
+                        the client acknowledges the event, then a
+                        ``TimeoutError`` exception is raised.
+        """
+        callback_event = self.eio.create_event()
+        callback_args = []
+
+        def event_callback(*args):
+            callback_args.append(args)
+            callback_event.set()
+
+        self.emit(event, data=data, namespace=namespace,
+                  callback=event_callback)
+        if not callback_event.wait(timeout=timeout):
+            raise exceptions.TimeoutError()
+        return callback_args[0] if len(callback_args[0]) > 1 \
+            else callback_args[0][0] if len(callback_args[0]) == 1 \
+            else None
+
+    def disconnect(self):
+        """Disconnect from the server."""
+        # here we just request the disconnection
+        # later in _handle_eio_disconnect we invoke the disconnect handler
+        for n in self.namespaces:
+            self._send_packet(packet.Packet(packet.DISCONNECT, namespace=n))
+        self._send_packet(packet.Packet(
+            packet.DISCONNECT, namespace='/'))
+        self.eio.disconnect(abort=True)
+
+    def transport(self):
+        """Return the name of the transport used by the client.
+
+        The two possible values returned by this function are ``'polling'``
+        and ``'websocket'``.
+        """
+        return self.eio.transport()
+
+    def start_background_task(self, target, *args, **kwargs):
+        """Start a background task using the appropriate async model.
+
+        This is a utility function that applications can use to start a
+        background task using the method that is compatible with the
+        selected async mode.
+
+        :param target: the target function to execute.
+        :param args: arguments to pass to the function.
+        :param kwargs: keyword arguments to pass to the function.
+
+        This function returns an object compatible with the `Thread` class in
+        the Python standard library. The `start()` method on this object is
+        already called by this function.
+        """
+        return self.eio.start_background_task(target, *args, **kwargs)
+
+    def sleep(self, seconds=0):
+        """Sleep for the requested amount of time using the appropriate async
+        model.
+
+        This is a utility function that applications can use to put a task to
+        sleep without having to worry about using the correct call for the
+        selected async mode.
+        """
+        return self.eio.sleep(seconds)
+
+    def _send_packet(self, pkt):
+        """Send a Socket.IO packet to the server."""
+        encoded_packet = pkt.encode()
+        if isinstance(encoded_packet, list):
+            binary = False
+            for ep in encoded_packet:
+                self.eio.send(ep, binary=binary)
+                binary = True
+        else:
+            self.eio.send(encoded_packet, binary=False)
+
+    def _generate_ack_id(self, namespace, callback):
+        """Generate a unique identifier for an ACK packet."""
+        namespace = namespace or '/'
+        if namespace not in self.callbacks:
+            self.callbacks[namespace] = {0: itertools.count(1)}
+        id = six.next(self.callbacks[namespace][0])
+        self.callbacks[namespace][id] = callback
+        return id
+
+    def _handle_connect(self, namespace):
+        namespace = namespace or '/'
+        self.logger.info('Namespace {} is connected'.format(namespace))
+        self._trigger_event('connect', namespace=namespace)
+        if namespace == '/':
+            for n in self.namespaces:
+                self._send_packet(packet.Packet(packet.CONNECT, namespace=n))
+        elif namespace not in self.namespaces:
+            self.namespaces.append(namespace)
+
+    def _handle_disconnect(self, namespace):
+        namespace = namespace or '/'
+        self._trigger_event('disconnect', namespace=namespace)
+        if namespace in self.namespaces:
+            self.namespaces.remove(namespace)
+
+    def _handle_event(self, namespace, id, data):
+        namespace = namespace or '/'
+        self.logger.info('Received event "%s" [%s]', data[0], namespace)
+        r = self._trigger_event(data[0], namespace, *data[1:])
+        if id is not None:
+            # send ACK packet with the response returned by the handler
+            # tuples are expanded as multiple arguments
+            if r is None:
+                data = []
+            elif isinstance(r, tuple):
+                data = list(r)
+            else:
+                data = [r]
+            if six.PY2 and not self.binary:
+                binary = False  # pragma: nocover
+            else:
+                binary = None
+            self._send_packet(packet.Packet(packet.ACK, namespace=namespace,
+                              id=id, data=data, binary=binary))
+
+    def _handle_ack(self, namespace, id, data):
+        namespace = namespace or '/'
+        self.logger.info('Received ack [%s]', namespace)
+        callback = None
+        try:
+            callback = self.callbacks[namespace][id]
+        except KeyError:
+            # if we get an unknown callback we just ignore it
+            self.logger.warning('Unknown callback received, ignoring.')
+        else:
+            del self.callbacks[namespace][id]
+        if callback is not None:
+            callback(*data)
+
+    def _handle_error(self, namespace):
+        namespace = namespace or '/'
+        self.logger.info('Connection to namespace {} was rejected'.format(
+            namespace))
+        if namespace in self.namespaces:
+            self.namespaces.remove(namespace)
+
+    def _trigger_event(self, event, namespace, *args):
+        """Invoke an application event handler."""
+        # first see if we have an explicit handler for the event
+        if namespace in self.handlers and event in self.handlers[namespace]:
+            return self.handlers[namespace][event](*args)
+
+        # or else, forward the event to a namespace handler if one exists
+        elif namespace in self.namespace_handlers:
+            return self.namespace_handlers[namespace].trigger_event(
+                event, *args)
+
+    def _handle_reconnect(self):
+        self._reconnect_abort.clear()
+        reconnecting_clients.append(self)
+        attempt_count = 0
+        current_delay = self.reconnection_delay
+        while True:
+            delay = current_delay
+            current_delay *= 2
+            if delay > self.reconnection_delay_max:
+                delay = self.reconnection_delay_max
+            delay += self.randomization_factor * (2 * random.random() - 1)
+            self.logger.info(
+                'Connection failed, new attempt in {:.02f} seconds'.format(
+                    delay))
+            print('***', self._reconnect_abort.wait)
+            if self._reconnect_abort.wait(delay):
+                self.logger.info('Reconnect task aborted')
+                break
+            attempt_count += 1
+            try:
+                self.connect(self.connection_url,
+                             headers=self.connection_headers,
+                             transports=self.connection_transports,
+                             namespaces=self.connection_namespaces,
+                             socketio_path=self.socketio_path)
+            except (exceptions.ConnectionError, ValueError):
+                pass
+            else:
+                self.logger.info('Reconnection successful')
+                self._reconnect_task = None
+                break
+            if self.reconnection_attempts and \
+                    attempt_count >= self.reconnection_attempts:
+                self.logger.info(
+                    'Maximum reconnection attempts reached, giving up')
+                break
+        reconnecting_clients.remove(self)
+
+    def _handle_eio_connect(self):
+        """Handle the Engine.IO connection event."""
+        self.logger.info('Engine.IO connection established')
+        self.sid = self.eio.sid
+
+    def _handle_eio_message(self, data):
+        """Dispatch Engine.IO messages."""
+        if self._binary_packet:
+            pkt = self._binary_packet
+            if pkt.add_attachment(data):
+                self._binary_packet = None
+                if pkt.packet_type == packet.BINARY_EVENT:
+                    self._handle_event(pkt.namespace, pkt.id, pkt.data)
+                else:
+                    self._handle_ack(pkt.namespace, pkt.id, pkt.data)
+        else:
+            pkt = packet.Packet(encoded_packet=data)
+            if pkt.packet_type == packet.CONNECT:
+                self._handle_connect(pkt.namespace)
+            elif pkt.packet_type == packet.DISCONNECT:
+                self._handle_disconnect(pkt.namespace)
+            elif pkt.packet_type == packet.EVENT:
+                self._handle_event(pkt.namespace, pkt.id, pkt.data)
+            elif pkt.packet_type == packet.ACK:
+                self._handle_ack(pkt.namespace, pkt.id, pkt.data)
+            elif pkt.packet_type == packet.BINARY_EVENT or \
+                    pkt.packet_type == packet.BINARY_ACK:
+                self._binary_packet = pkt
+            elif pkt.packet_type == packet.ERROR:
+                self._handle_error(pkt.namespace)
+            else:
+                raise ValueError('Unknown packet type.')
+
+    def _handle_eio_disconnect(self):
+        """Handle the Engine.IO disconnection event."""
+        self.logger.info('Engine.IO connection dropped')
+        for n in self.namespaces:
+            self._trigger_event('disconnect', namespace=n)
+        self._trigger_event('disconnect', namespace='/')
+        self.callbacks = {}
+        self._binary_packet = None
+        self.sid = None
+        if self.eio.state == 'connected' and self.reconnection:
+            self._reconnect_task = self.start_background_task(
+                self._handle_reconnect)
+
+    def _engineio_client_class(self):
+        return engineio.Client
diff --git a/openpype/vendor/python/python_2/socketio/exceptions.py b/openpype/vendor/python/python_2/socketio/exceptions.py
new file mode 100644
index 0000000000..344aabb569
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/exceptions.py
@@ -0,0 +1,26 @@
+class SocketIOError(Exception):
+    pass
+
+
+class ConnectionError(SocketIOError):
+    pass
+
+
+class ConnectionRefusedError(ConnectionError):
+    """Connection refused exception.
+
+    This exception can be raised from a connect handler when the connection
+    is not accepted. The positional arguments provided with the exception are
+    returned with the error packet to the client.
+    """
+    def __init__(self, *args):
+        if len(args) == 0:
+            self.error_args = None
+        elif len(args) == 1:
+            self.error_args = args[0]
+        else:
+            self.error_args = args
+
+
+class TimeoutError(SocketIOError):
+    pass
diff --git a/openpype/vendor/python/python_2/socketio/kombu_manager.py b/openpype/vendor/python/python_2/socketio/kombu_manager.py
new file mode 100644
index 0000000000..4394a6d3ea
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/kombu_manager.py
@@ -0,0 +1,105 @@
+import pickle
+import uuid
+
+try:
+    import kombu
+except ImportError:
+    kombu = None
+
+from .pubsub_manager import PubSubManager
+
+
+class KombuManager(PubSubManager):  # pragma: no cover
+    """Client manager that uses kombu for inter-process messaging.
+
+    This class implements a client manager backend for event sharing across
+    multiple processes, using RabbitMQ, Redis or any other messaging mechanism
+    supported by `kombu <http://kombu.readthedocs.org/en/latest/>`_.
+
+    To use a kombu backend, initialize the :class:`Server` instance as
+    follows::
+
+        url = 'amqp://user:password@hostname:port//'
+        server = socketio.Server(client_manager=socketio.KombuManager(url))
+
+    :param url: The connection URL for the backend messaging queue. Example
+                connection URLs are ``'amqp://guest:guest@localhost:5672//'``
+                and ``'redis://localhost:6379/'`` for RabbitMQ and Redis
+                respectively. Consult the `kombu documentation
+                <http://kombu.readthedocs.org/en/latest/userguide\
+                /connections.html#urls>`_ for more on how to construct
+                connection URLs.
+    :param channel: The channel name on which the server sends and receives
+                    notifications. Must be the same in all the servers.
+    :param write_only: If set ot ``True``, only initialize to emit events. The
+                       default of ``False`` initializes the class for emitting
+                       and receiving.
+    """
+    name = 'kombu'
+
+    def __init__(self, url='amqp://guest:guest@localhost:5672//',
+                 channel='socketio', write_only=False, logger=None):
+        if kombu is None:
+            raise RuntimeError('Kombu package is not installed '
+                               '(Run "pip install kombu" in your '
+                               'virtualenv).')
+        super(KombuManager, self).__init__(channel=channel,
+                                           write_only=write_only,
+                                           logger=logger)
+        self.url = url
+        self.producer = self._producer()
+
+    def initialize(self):
+        super(KombuManager, self).initialize()
+
+        monkey_patched = True
+        if self.server.async_mode == 'eventlet':
+            from eventlet.patcher import is_monkey_patched
+            monkey_patched = is_monkey_patched('socket')
+        elif 'gevent' in self.server.async_mode:
+            from gevent.monkey import is_module_patched
+            monkey_patched = is_module_patched('socket')
+        if not monkey_patched:
+            raise RuntimeError(
+                'Kombu requires a monkey patched socket library to work '
+                'with ' + self.server.async_mode)
+
+    def _connection(self):
+        return kombu.Connection(self.url)
+
+    def _exchange(self):
+        return kombu.Exchange(self.channel, type='fanout', durable=False)
+
+    def _queue(self):
+        queue_name = 'flask-socketio.' + str(uuid.uuid4())
+        return kombu.Queue(queue_name, self._exchange(),
+                           durable=False,
+                           queue_arguments={'x-expires': 300000})
+
+    def _producer(self):
+        return self._connection().Producer(exchange=self._exchange())
+
+    def __error_callback(self, exception, interval):
+        self._get_logger().exception('Sleeping {}s'.format(interval))
+
+    def _publish(self, data):
+        connection = self._connection()
+        publish = connection.ensure(self.producer, self.producer.publish,
+                                    errback=self.__error_callback)
+        publish(pickle.dumps(data))
+
+    def _listen(self):
+        reader_queue = self._queue()
+
+        while True:
+            connection = self._connection().ensure_connection(
+                errback=self.__error_callback)
+            try:
+                with connection.SimpleQueue(reader_queue) as queue:
+                    while True:
+                        message = queue.get(block=True)
+                        message.ack()
+                        yield message.payload
+            except connection.connection_errors:
+                self._get_logger().exception("Connection error "
+                                             "while reading from queue")
diff --git a/openpype/vendor/python/python_2/socketio/middleware.py b/openpype/vendor/python/python_2/socketio/middleware.py
new file mode 100644
index 0000000000..1a69740857
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/middleware.py
@@ -0,0 +1,42 @@
+import engineio
+
+
+class WSGIApp(engineio.WSGIApp):
+    """WSGI middleware for Socket.IO.
+
+    This middleware dispatches traffic to a Socket.IO application. It can also
+    serve a list of static files to the client, or forward unrelated HTTP
+    traffic to another WSGI application.
+
+    :param socketio_app: The Socket.IO server. Must be an instance of the
+                         ``socketio.Server`` class.
+    :param wsgi_app: The WSGI app that receives all other traffic.
+    :param static_files: A dictionary with static file mapping rules. See the
+                         documentation for details on this argument.
+    :param socketio_path: The endpoint where the Socket.IO application should
+                          be installed. The default value is appropriate for
+                          most cases.
+
+    Example usage::
+
+        import socketio
+        import eventlet
+        from . import wsgi_app
+
+        sio = socketio.Server()
+        app = socketio.WSGIApp(sio, wsgi_app)
+        eventlet.wsgi.server(eventlet.listen(('', 8000)), app)
+    """
+    def __init__(self, socketio_app, wsgi_app=None, static_files=None,
+                 socketio_path='socket.io'):
+        super(WSGIApp, self).__init__(socketio_app, wsgi_app,
+                                      static_files=static_files,
+                                      engineio_path=socketio_path)
+
+
+class Middleware(WSGIApp):
+    """This class has been renamed to WSGIApp and is now deprecated."""
+    def __init__(self, socketio_app, wsgi_app=None,
+                 socketio_path='socket.io'):
+        super(Middleware, self).__init__(socketio_app, wsgi_app,
+                                         socketio_path=socketio_path)
diff --git a/openpype/vendor/python/python_2/socketio/namespace.py b/openpype/vendor/python/python_2/socketio/namespace.py
new file mode 100644
index 0000000000..418615ff8e
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/namespace.py
@@ -0,0 +1,191 @@
+class BaseNamespace(object):
+    def __init__(self, namespace=None):
+        self.namespace = namespace or '/'
+
+    def is_asyncio_based(self):
+        return False
+
+    def trigger_event(self, event, *args):
+        """Dispatch an event to the proper handler method.
+
+        In the most common usage, this method is not overloaded by subclasses,
+        as it performs the routing of events to methods. However, this
+        method can be overriden if special dispatching rules are needed, or if
+        having a single method that catches all events is desired.
+        """
+        handler_name = 'on_' + event
+        if hasattr(self, handler_name):
+            return getattr(self, handler_name)(*args)
+
+
+class Namespace(BaseNamespace):
+    """Base class for server-side class-based namespaces.
+
+    A class-based namespace is a class that contains all the event handlers
+    for a Socket.IO namespace. The event handlers are methods of the class
+    with the prefix ``on_``, such as ``on_connect``, ``on_disconnect``,
+    ``on_message``, ``on_json``, and so on.
+
+    :param namespace: The Socket.IO namespace to be used with all the event
+                      handlers defined in this class. If this argument is
+                      omitted, the default namespace is used.
+    """
+    def __init__(self, namespace=None):
+        super(Namespace, self).__init__(namespace=namespace)
+        self.server = None
+
+    def _set_server(self, server):
+        self.server = server
+
+    def emit(self, event, data=None, room=None, skip_sid=None, namespace=None,
+             callback=None):
+        """Emit a custom event to one or more connected clients.
+
+        The only difference with the :func:`socketio.Server.emit` method is
+        that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.server.emit(event, data=data, room=room, skip_sid=skip_sid,
+                                namespace=namespace or self.namespace,
+                                callback=callback)
+
+    def send(self, data, room=None, skip_sid=None, namespace=None,
+             callback=None):
+        """Send a message to one or more connected clients.
+
+        The only difference with the :func:`socketio.Server.send` method is
+        that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.server.send(data, room=room, skip_sid=skip_sid,
+                                namespace=namespace or self.namespace,
+                                callback=callback)
+
+    def enter_room(self, sid, room, namespace=None):
+        """Enter a room.
+
+        The only difference with the :func:`socketio.Server.enter_room` method
+        is that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.server.enter_room(sid, room,
+                                      namespace=namespace or self.namespace)
+
+    def leave_room(self, sid, room, namespace=None):
+        """Leave a room.
+
+        The only difference with the :func:`socketio.Server.leave_room` method
+        is that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.server.leave_room(sid, room,
+                                      namespace=namespace or self.namespace)
+
+    def close_room(self, room, namespace=None):
+        """Close a room.
+
+        The only difference with the :func:`socketio.Server.close_room` method
+        is that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.server.close_room(room,
+                                      namespace=namespace or self.namespace)
+
+    def rooms(self, sid, namespace=None):
+        """Return the rooms a client is in.
+
+        The only difference with the :func:`socketio.Server.rooms` method is
+        that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.server.rooms(sid, namespace=namespace or self.namespace)
+
+    def get_session(self, sid, namespace=None):
+        """Return the user session for a client.
+
+        The only difference with the :func:`socketio.Server.get_session`
+        method is that when the ``namespace`` argument is not given the
+        namespace associated with the class is used.
+        """
+        return self.server.get_session(
+            sid, namespace=namespace or self.namespace)
+
+    def save_session(self, sid, session, namespace=None):
+        """Store the user session for a client.
+
+        The only difference with the :func:`socketio.Server.save_session`
+        method is that when the ``namespace`` argument is not given the
+        namespace associated with the class is used.
+        """
+        return self.server.save_session(
+            sid, session, namespace=namespace or self.namespace)
+
+    def session(self, sid, namespace=None):
+        """Return the user session for a client with context manager syntax.
+
+        The only difference with the :func:`socketio.Server.session` method is
+        that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.server.session(sid, namespace=namespace or self.namespace)
+
+    def disconnect(self, sid, namespace=None):
+        """Disconnect a client.
+
+        The only difference with the :func:`socketio.Server.disconnect` method
+        is that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.server.disconnect(sid,
+                                      namespace=namespace or self.namespace)
+
+
+class ClientNamespace(BaseNamespace):
+    """Base class for client-side class-based namespaces.
+
+    A class-based namespace is a class that contains all the event handlers
+    for a Socket.IO namespace. The event handlers are methods of the class
+    with the prefix ``on_``, such as ``on_connect``, ``on_disconnect``,
+    ``on_message``, ``on_json``, and so on.
+
+    :param namespace: The Socket.IO namespace to be used with all the event
+                      handlers defined in this class. If this argument is
+                      omitted, the default namespace is used.
+    """
+    def __init__(self, namespace=None):
+        super(ClientNamespace, self).__init__(namespace=namespace)
+        self.client = None
+
+    def _set_client(self, client):
+        self.client = client
+
+    def emit(self, event, data=None, namespace=None, callback=None):
+        """Emit a custom event to the server.
+
+        The only difference with the :func:`socketio.Client.emit` method is
+        that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.client.emit(event, data=data,
+                                namespace=namespace or self.namespace,
+                                callback=callback)
+
+    def send(self, data, room=None, skip_sid=None, namespace=None,
+             callback=None):
+        """Send a message to the server.
+
+        The only difference with the :func:`socketio.Client.send` method is
+        that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.client.send(data, namespace=namespace or self.namespace,
+                                callback=callback)
+
+    def disconnect(self):
+        """Disconnect from the server.
+
+        The only difference with the :func:`socketio.Client.disconnect` method
+        is that when the ``namespace`` argument is not given the namespace
+        associated with the class is used.
+        """
+        return self.client.disconnect()
diff --git a/openpype/vendor/python/python_2/socketio/packet.py b/openpype/vendor/python/python_2/socketio/packet.py
new file mode 100644
index 0000000000..73b469d6d2
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/packet.py
@@ -0,0 +1,179 @@
+import functools
+import json as _json
+
+import six
+
+(CONNECT, DISCONNECT, EVENT, ACK, ERROR, BINARY_EVENT, BINARY_ACK) = \
+    (0, 1, 2, 3, 4, 5, 6)
+packet_names = ['CONNECT', 'DISCONNECT', 'EVENT', 'ACK', 'ERROR',
+                'BINARY_EVENT', 'BINARY_ACK']
+
+
+class Packet(object):
+    """Socket.IO packet."""
+
+    # the format of the Socket.IO packet is as follows:
+    #
+    # packet type: 1 byte, values 0-6
+    # num_attachments: ASCII encoded, only if num_attachments != 0
+    # '-': only if num_attachments != 0
+    # namespace: only if namespace != '/'
+    # ',': only if namespace and one of id and data are defined in this packet
+    # id: ASCII encoded, only if id is not None
+    # data: JSON dump of data payload
+
+    json = _json
+
+    def __init__(self, packet_type=EVENT, data=None, namespace=None, id=None,
+                 binary=None, encoded_packet=None):
+        self.packet_type = packet_type
+        self.data = data
+        self.namespace = namespace
+        self.id = id
+        if binary or (binary is None and self._data_is_binary(self.data)):
+            if self.packet_type == EVENT:
+                self.packet_type = BINARY_EVENT
+            elif self.packet_type == ACK:
+                self.packet_type = BINARY_ACK
+            else:
+                raise ValueError('Packet does not support binary payload.')
+        self.attachment_count = 0
+        self.attachments = []
+        if encoded_packet:
+            self.attachment_count = self.decode(encoded_packet)
+
+    def encode(self):
+        """Encode the packet for transmission.
+
+        If the packet contains binary elements, this function returns a list
+        of packets where the first is the original packet with placeholders for
+        the binary components and the remaining ones the binary attachments.
+        """
+        encoded_packet = six.text_type(self.packet_type)
+        if self.packet_type == BINARY_EVENT or self.packet_type == BINARY_ACK:
+            data, attachments = self._deconstruct_binary(self.data)
+            encoded_packet += six.text_type(len(attachments)) + '-'
+        else:
+            data = self.data
+            attachments = None
+        needs_comma = False
+        if self.namespace is not None and self.namespace != '/':
+            encoded_packet += self.namespace
+            needs_comma = True
+        if self.id is not None:
+            if needs_comma:
+                encoded_packet += ','
+                needs_comma = False
+            encoded_packet += six.text_type(self.id)
+        if data is not None:
+            if needs_comma:
+                encoded_packet += ','
+            encoded_packet += self.json.dumps(data, separators=(',', ':'))
+        if attachments is not None:
+            encoded_packet = [encoded_packet] + attachments
+        return encoded_packet
+
+    def decode(self, encoded_packet):
+        """Decode a transmitted package.
+
+        The return value indicates how many binary attachment packets are
+        necessary to fully decode the packet.
+        """
+        ep = encoded_packet
+        try:
+            self.packet_type = int(ep[0:1])
+        except TypeError:
+            self.packet_type = ep
+            ep = ''
+        self.namespace = None
+        self.data = None
+        ep = ep[1:]
+        dash = ep.find('-')
+        attachment_count = 0
+        if dash > 0 and ep[0:dash].isdigit():
+            attachment_count = int(ep[0:dash])
+            ep = ep[dash + 1:]
+        if ep and ep[0:1] == '/':
+            sep = ep.find(',')
+            if sep == -1:
+                self.namespace = ep
+                ep = ''
+            else:
+                self.namespace = ep[0:sep]
+                ep = ep[sep + 1:]
+            q = self.namespace.find('?')
+            if q != -1:
+                self.namespace = self.namespace[0:q]
+        if ep and ep[0].isdigit():
+            self.id = 0
+            while ep and ep[0].isdigit():
+                self.id = self.id * 10 + int(ep[0])
+                ep = ep[1:]
+        if ep:
+            self.data = self.json.loads(ep)
+        return attachment_count
+
+    def add_attachment(self, attachment):
+        if self.attachment_count <= len(self.attachments):
+            raise ValueError('Unexpected binary attachment')
+        self.attachments.append(attachment)
+        if self.attachment_count == len(self.attachments):
+            self.reconstruct_binary(self.attachments)
+            return True
+        return False
+
+    def reconstruct_binary(self, attachments):
+        """Reconstruct a decoded packet using the given list of binary
+        attachments.
+        """
+        self.data = self._reconstruct_binary_internal(self.data,
+                                                      self.attachments)
+
+    def _reconstruct_binary_internal(self, data, attachments):
+        if isinstance(data, list):
+            return [self._reconstruct_binary_internal(item, attachments)
+                    for item in data]
+        elif isinstance(data, dict):
+            if data.get('_placeholder') and 'num' in data:
+                return attachments[data['num']]
+            else:
+                return {key: self._reconstruct_binary_internal(value,
+                                                               attachments)
+                        for key, value in six.iteritems(data)}
+        else:
+            return data
+
+    def _deconstruct_binary(self, data):
+        """Extract binary components in the packet."""
+        attachments = []
+        data = self._deconstruct_binary_internal(data, attachments)
+        return data, attachments
+
+    def _deconstruct_binary_internal(self, data, attachments):
+        if isinstance(data, six.binary_type):
+            attachments.append(data)
+            return {'_placeholder': True, 'num': len(attachments) - 1}
+        elif isinstance(data, list):
+            return [self._deconstruct_binary_internal(item, attachments)
+                    for item in data]
+        elif isinstance(data, dict):
+            return {key: self._deconstruct_binary_internal(value, attachments)
+                    for key, value in six.iteritems(data)}
+        else:
+            return data
+
+    def _data_is_binary(self, data):
+        """Check if the data contains binary components."""
+        if isinstance(data, six.binary_type):
+            return True
+        elif isinstance(data, list):
+            return functools.reduce(
+                lambda a, b: a or b, [self._data_is_binary(item)
+                                      for item in data], False)
+        elif isinstance(data, dict):
+            return functools.reduce(
+                lambda a, b: a or b, [self._data_is_binary(item)
+                                      for item in six.itervalues(data)],
+                False)
+        else:
+            return False
diff --git a/openpype/vendor/python/python_2/socketio/pubsub_manager.py b/openpype/vendor/python/python_2/socketio/pubsub_manager.py
new file mode 100644
index 0000000000..2905b2c325
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/pubsub_manager.py
@@ -0,0 +1,154 @@
+from functools import partial
+import uuid
+
+import json
+import pickle
+import six
+
+from .base_manager import BaseManager
+
+
+class PubSubManager(BaseManager):
+    """Manage a client list attached to a pub/sub backend.
+
+    This is a base class that enables multiple servers to share the list of
+    clients, with the servers communicating events through a pub/sub backend.
+    The use of a pub/sub backend also allows any client connected to the
+    backend to emit events addressed to Socket.IO clients.
+
+    The actual backends must be implemented by subclasses, this class only
+    provides a pub/sub generic framework.
+
+    :param channel: The channel name on which the server sends and receives
+                    notifications.
+    """
+    name = 'pubsub'
+
+    def __init__(self, channel='socketio', write_only=False, logger=None):
+        super(PubSubManager, self).__init__()
+        self.channel = channel
+        self.write_only = write_only
+        self.host_id = uuid.uuid4().hex
+        self.logger = logger
+
+    def initialize(self):
+        super(PubSubManager, self).initialize()
+        if not self.write_only:
+            self.thread = self.server.start_background_task(self._thread)
+        self._get_logger().info(self.name + ' backend initialized.')
+
+    def emit(self, event, data, namespace=None, room=None, skip_sid=None,
+             callback=None, **kwargs):
+        """Emit a message to a single client, a room, or all the clients
+        connected to the namespace.
+
+        This method takes care or propagating the message to all the servers
+        that are connected through the message queue.
+
+        The parameters are the same as in :meth:`.Server.emit`.
+        """
+        if kwargs.get('ignore_queue'):
+            return super(PubSubManager, self).emit(
+                event, data, namespace=namespace, room=room, skip_sid=skip_sid,
+                callback=callback)
+        namespace = namespace or '/'
+        if callback is not None:
+            if self.server is None:
+                raise RuntimeError('Callbacks can only be issued from the '
+                                   'context of a server.')
+            if room is None:
+                raise ValueError('Cannot use callback without a room set.')
+            id = self._generate_ack_id(room, namespace, callback)
+            callback = (room, namespace, id)
+        else:
+            callback = None
+        self._publish({'method': 'emit', 'event': event, 'data': data,
+                       'namespace': namespace, 'room': room,
+                       'skip_sid': skip_sid, 'callback': callback,
+                       'host_id': self.host_id})
+
+    def close_room(self, room, namespace=None):
+        self._publish({'method': 'close_room', 'room': room,
+                       'namespace': namespace or '/'})
+
+    def _publish(self, data):
+        """Publish a message on the Socket.IO channel.
+
+        This method needs to be implemented by the different subclasses that
+        support pub/sub backends.
+        """
+        raise NotImplementedError('This method must be implemented in a '
+                                  'subclass.')  # pragma: no cover
+
+    def _listen(self):
+        """Return the next message published on the Socket.IO channel,
+        blocking until a message is available.
+
+        This method needs to be implemented by the different subclasses that
+        support pub/sub backends.
+        """
+        raise NotImplementedError('This method must be implemented in a '
+                                  'subclass.')  # pragma: no cover
+
+    def _handle_emit(self, message):
+        # Events with callbacks are very tricky to handle across hosts
+        # Here in the receiving end we set up a local callback that preserves
+        # the callback host and id from the sender
+        remote_callback = message.get('callback')
+        remote_host_id = message.get('host_id')
+        if remote_callback is not None and len(remote_callback) == 3:
+            callback = partial(self._return_callback, remote_host_id,
+                               *remote_callback)
+        else:
+            callback = None
+        super(PubSubManager, self).emit(message['event'], message['data'],
+                                        namespace=message.get('namespace'),
+                                        room=message.get('room'),
+                                        skip_sid=message.get('skip_sid'),
+                                        callback=callback)
+
+    def _handle_callback(self, message):
+        if self.host_id == message.get('host_id'):
+            try:
+                sid = message['sid']
+                namespace = message['namespace']
+                id = message['id']
+                args = message['args']
+            except KeyError:
+                return
+            self.trigger_callback(sid, namespace, id, args)
+
+    def _return_callback(self, host_id, sid, namespace, callback_id, *args):
+        # When an event callback is received, the callback is returned back
+        # the sender, which is identified by the host_id
+        self._publish({'method': 'callback', 'host_id': host_id,
+                       'sid': sid, 'namespace': namespace, 'id': callback_id,
+                       'args': args})
+
+    def _handle_close_room(self, message):
+        super(PubSubManager, self).close_room(
+            room=message.get('room'), namespace=message.get('namespace'))
+
+    def _thread(self):
+        for message in self._listen():
+            data = None
+            if isinstance(message, dict):
+                data = message
+            else:
+                if isinstance(message, six.binary_type):  # pragma: no cover
+                    try:
+                        data = pickle.loads(message)
+                    except:
+                        pass
+                if data is None:
+                    try:
+                        data = json.loads(message)
+                    except:
+                        pass
+            if data and 'method' in data:
+                if data['method'] == 'emit':
+                    self._handle_emit(data)
+                elif data['method'] == 'callback':
+                    self._handle_callback(data)
+                elif data['method'] == 'close_room':
+                    self._handle_close_room(data)
diff --git a/openpype/vendor/python/python_2/socketio/redis_manager.py b/openpype/vendor/python/python_2/socketio/redis_manager.py
new file mode 100644
index 0000000000..69be586fca
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/redis_manager.py
@@ -0,0 +1,111 @@
+import logging
+import pickle
+import time
+
+try:
+    import redis
+except ImportError:
+    redis = None
+
+from .pubsub_manager import PubSubManager
+
+logger = logging.getLogger('socketio')
+
+
+class RedisManager(PubSubManager):  # pragma: no cover
+    """Redis based client manager.
+
+    This class implements a Redis backend for event sharing across multiple
+    processes. Only kept here as one more example of how to build a custom
+    backend, since the kombu backend is perfectly adequate to support a Redis
+    message queue.
+
+    To use a Redis backend, initialize the :class:`Server` instance as
+    follows::
+
+        url = 'redis://hostname:port/0'
+        server = socketio.Server(client_manager=socketio.RedisManager(url))
+
+    :param url: The connection URL for the Redis server. For a default Redis
+                store running on the same host, use ``redis://``.
+    :param channel: The channel name on which the server sends and receives
+                    notifications. Must be the same in all the servers.
+    :param write_only: If set ot ``True``, only initialize to emit events. The
+                       default of ``False`` initializes the class for emitting
+                       and receiving.
+    """
+    name = 'redis'
+
+    def __init__(self, url='redis://localhost:6379/0', channel='socketio',
+                 write_only=False, logger=None):
+        if redis is None:
+            raise RuntimeError('Redis package is not installed '
+                               '(Run "pip install redis" in your '
+                               'virtualenv).')
+        self.redis_url = url
+        self._redis_connect()
+        super(RedisManager, self).__init__(channel=channel,
+                                           write_only=write_only,
+                                           logger=logger)
+
+    def initialize(self):
+        super(RedisManager, self).initialize()
+
+        monkey_patched = True
+        if self.server.async_mode == 'eventlet':
+            from eventlet.patcher import is_monkey_patched
+            monkey_patched = is_monkey_patched('socket')
+        elif 'gevent' in self.server.async_mode:
+            from gevent.monkey import is_module_patched
+            monkey_patched = is_module_patched('socket')
+        if not monkey_patched:
+            raise RuntimeError(
+                'Redis requires a monkey patched socket library to work '
+                'with ' + self.server.async_mode)
+
+    def _redis_connect(self):
+        self.redis = redis.Redis.from_url(self.redis_url)
+        self.pubsub = self.redis.pubsub()
+
+    def _publish(self, data):
+        retry = True
+        while True:
+            try:
+                if not retry:
+                    self._redis_connect()
+                return self.redis.publish(self.channel, pickle.dumps(data))
+            except redis.exceptions.ConnectionError:
+                if retry:
+                    logger.error('Cannot publish to redis... retrying')
+                    retry = False
+                else:
+                    logger.error('Cannot publish to redis... giving up')
+                    break
+
+    def _redis_listen_with_retries(self):
+        retry_sleep = 1
+        connect = False
+        while True:
+            try:
+                if connect:
+                    self._redis_connect()
+                    self.pubsub.subscribe(self.channel)
+                for message in self.pubsub.listen():
+                    yield message
+            except redis.exceptions.ConnectionError:
+                logger.error('Cannot receive from redis... '
+                             'retrying in {} secs'.format(retry_sleep))
+                connect = True
+                time.sleep(retry_sleep)
+                retry_sleep *= 2
+                if retry_sleep > 60:
+                    retry_sleep = 60
+
+    def _listen(self):
+        channel = self.channel.encode('utf-8')
+        self.pubsub.subscribe(self.channel)
+        for message in self._redis_listen_with_retries():
+            if message['channel'] == channel and \
+                    message['type'] == 'message' and 'data' in message:
+                yield message['data']
+        self.pubsub.unsubscribe(self.channel)
diff --git a/openpype/vendor/python/python_2/socketio/server.py b/openpype/vendor/python/python_2/socketio/server.py
new file mode 100644
index 0000000000..f9a74dc51b
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/server.py
@@ -0,0 +1,719 @@
+import logging
+
+import engineio
+import six
+
+from . import base_manager
+from . import exceptions
+from . import namespace
+from . import packet
+
+default_logger = logging.getLogger('socketio.server')
+
+
+class Server(object):
+    """A Socket.IO server.
+
+    This class implements a fully compliant Socket.IO web server with support
+    for websocket and long-polling transports.
+
+    :param client_manager: The client manager instance that will manage the
+                           client list. When this is omitted, the client list
+                           is stored in an in-memory structure, so the use of
+                           multiple connected servers is not possible.
+    :param logger: To enable logging set to ``True`` or pass a logger object to
+                   use. To disable logging set to ``False``. The default is
+                   ``False``.
+    :param binary: ``True`` to support binary payloads, ``False`` to treat all
+                   payloads as text. On Python 2, if this is set to ``True``,
+                   ``unicode`` values are treated as text, and ``str`` and
+                   ``bytes`` values are treated as binary.  This option has no
+                   effect on Python 3, where text and binary payloads are
+                   always automatically discovered.
+    :param json: An alternative json module to use for encoding and decoding
+                 packets. Custom json modules must have ``dumps`` and ``loads``
+                 functions that are compatible with the standard library
+                 versions.
+    :param async_handlers: If set to ``True``, event handlers for a client are
+                           executed in separate threads. To run handlers for a
+                           client synchronously, set to ``False``. The default
+                           is ``True``.
+    :param always_connect: When set to ``False``, new connections are
+                           provisory until the connect handler returns
+                           something other than ``False``, at which point they
+                           are accepted. When set to ``True``, connections are
+                           immediately accepted, and then if the connect
+                           handler returns ``False`` a disconnect is issued.
+                           Set to ``True`` if you need to emit events from the
+                           connect handler and your client is confused when it
+                           receives events before the connection acceptance.
+                           In any other case use the default of ``False``.
+    :param kwargs: Connection parameters for the underlying Engine.IO server.
+
+    The Engine.IO configuration supports the following settings:
+
+    :param async_mode: The asynchronous model to use. See the Deployment
+                       section in the documentation for a description of the
+                       available options. Valid async modes are "threading",
+                       "eventlet", "gevent" and "gevent_uwsgi". If this
+                       argument is not given, "eventlet" is tried first, then
+                       "gevent_uwsgi", then "gevent", and finally "threading".
+                       The first async mode that has all its dependencies
+                       installed is then one that is chosen.
+    :param ping_timeout: The time in seconds that the client waits for the
+                         server to respond before disconnecting. The default
+                         is 60 seconds.
+    :param ping_interval: The interval in seconds at which the client pings
+                          the server. The default is 25 seconds.
+    :param max_http_buffer_size: The maximum size of a message when using the
+                                 polling transport. The default is 100,000,000
+                                 bytes.
+    :param allow_upgrades: Whether to allow transport upgrades or not. The
+                           default is ``True``.
+    :param http_compression: Whether to compress packages when using the
+                             polling transport. The default is ``True``.
+    :param compression_threshold: Only compress messages when their byte size
+                                  is greater than this value. The default is
+                                  1024 bytes.
+    :param cookie: Name of the HTTP cookie that contains the client session
+                   id. If set to ``None``, a cookie is not sent to the client.
+                   The default is ``'io'``.
+    :param cors_allowed_origins: List of origins that are allowed to connect
+                                 to this server. All origins are allowed by
+                                 default.
+    :param cors_credentials: Whether credentials (cookies, authentication) are
+                             allowed in requests to this server. The default is
+                             ``True``.
+    :param engineio_logger: To enable Engine.IO logging set to ``True`` or pass
+                            a logger object to use. To disable logging set to
+                            ``False``. The default is ``False``.
+    """
+    def __init__(self, client_manager=None, logger=False, binary=False,
+                 json=None, async_handlers=True, always_connect=False,
+                 **kwargs):
+        engineio_options = kwargs
+        engineio_logger = engineio_options.pop('engineio_logger', None)
+        if engineio_logger is not None:
+            engineio_options['logger'] = engineio_logger
+        if json is not None:
+            packet.Packet.json = json
+            engineio_options['json'] = json
+        engineio_options['async_handlers'] = False
+        self.eio = self._engineio_server_class()(**engineio_options)
+        self.eio.on('connect', self._handle_eio_connect)
+        self.eio.on('message', self._handle_eio_message)
+        self.eio.on('disconnect', self._handle_eio_disconnect)
+        self.binary = binary
+
+        self.environ = {}
+        self.handlers = {}
+        self.namespace_handlers = {}
+
+        self._binary_packet = {}
+
+        if not isinstance(logger, bool):
+            self.logger = logger
+        else:
+            self.logger = default_logger
+            if not logging.root.handlers and \
+                    self.logger.level == logging.NOTSET:
+                if logger:
+                    self.logger.setLevel(logging.INFO)
+                else:
+                    self.logger.setLevel(logging.ERROR)
+                self.logger.addHandler(logging.StreamHandler())
+
+        if client_manager is None:
+            client_manager = base_manager.BaseManager()
+        self.manager = client_manager
+        self.manager.set_server(self)
+        self.manager_initialized = False
+
+        self.async_handlers = async_handlers
+        self.always_connect = always_connect
+
+        self.async_mode = self.eio.async_mode
+
+    def is_asyncio_based(self):
+        return False
+
+    def on(self, event, handler=None, namespace=None):
+        """Register an event handler.
+
+        :param event: The event name. It can be any string. The event names
+                      ``'connect'``, ``'message'`` and ``'disconnect'`` are
+                      reserved and should not be used.
+        :param handler: The function that should be invoked to handle the
+                        event. When this parameter is not given, the method
+                        acts as a decorator for the handler function.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the handler is associated with
+                          the default namespace.
+
+        Example usage::
+
+            # as a decorator:
+            @socket_io.on('connect', namespace='/chat')
+            def connect_handler(sid, environ):
+                print('Connection request')
+                if environ['REMOTE_ADDR'] in blacklisted:
+                    return False  # reject
+
+            # as a method:
+            def message_handler(sid, msg):
+                print('Received message: ', msg)
+                eio.send(sid, 'response')
+            socket_io.on('message', namespace='/chat', message_handler)
+
+        The handler function receives the ``sid`` (session ID) for the
+        client as first argument. The ``'connect'`` event handler receives the
+        WSGI environment as a second argument, and can return ``False`` to
+        reject the connection. The ``'message'`` handler and handlers for
+        custom event names receive the message payload as a second argument.
+        Any values returned from a message handler will be passed to the
+        client's acknowledgement callback function if it exists. The
+        ``'disconnect'`` handler does not take a second argument.
+        """
+        namespace = namespace or '/'
+
+        def set_handler(handler):
+            if namespace not in self.handlers:
+                self.handlers[namespace] = {}
+            self.handlers[namespace][event] = handler
+            return handler
+
+        if handler is None:
+            return set_handler
+        set_handler(handler)
+
+    def event(self, *args, **kwargs):
+        """Decorator to register an event handler.
+
+        This is a simplified version of the ``on()`` method that takes the
+        event name from the decorated function.
+
+        Example usage::
+
+            @sio.event
+            def my_event(data):
+                print('Received data: ', data)
+
+        The above example is equivalent to::
+
+            @sio.on('my_event')
+            def my_event(data):
+                print('Received data: ', data)
+
+        A custom namespace can be given as an argument to the decorator::
+
+            @sio.event(namespace='/test')
+            def my_event(data):
+                print('Received data: ', data)
+        """
+        if len(args) == 1 and len(kwargs) == 0 and callable(args[0]):
+            # the decorator was invoked without arguments
+            # args[0] is the decorated function
+            return self.on(args[0].__name__)(args[0])
+        else:
+            # the decorator was invoked with arguments
+            def set_handler(handler):
+                return self.on(handler.__name__, *args, **kwargs)(handler)
+
+            return set_handler
+
+    def register_namespace(self, namespace_handler):
+        """Register a namespace handler object.
+
+        :param namespace_handler: An instance of a :class:`Namespace`
+                                  subclass that handles all the event traffic
+                                  for a namespace.
+        """
+        if not isinstance(namespace_handler, namespace.Namespace):
+            raise ValueError('Not a namespace instance')
+        if self.is_asyncio_based() != namespace_handler.is_asyncio_based():
+            raise ValueError('Not a valid namespace class for this server')
+        namespace_handler._set_server(self)
+        self.namespace_handlers[namespace_handler.namespace] = \
+            namespace_handler
+
+    def emit(self, event, data=None, to=None, room=None, skip_sid=None,
+             namespace=None, callback=None, **kwargs):
+        """Emit a custom event to one or more connected clients.
+
+        :param event: The event name. It can be any string. The event names
+                      ``'connect'``, ``'message'`` and ``'disconnect'`` are
+                      reserved and should not be used.
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param to: The recipient of the message. This can be set to the
+                   session ID of a client to address only that client, or to
+                   to any custom room created by the application to address all
+                   the clients in that room, If this argument is omitted the
+                   event is broadcasted to all connected clients.
+        :param room: Alias for the ``to`` parameter.
+        :param skip_sid: The session ID of a client to skip when broadcasting
+                         to a room or to all clients. This can be used to
+                         prevent a message from being sent to the sender. To
+                         skip multiple sids, pass a list.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param callback: If given, this function will be called to acknowledge
+                         the the client has received the message. The arguments
+                         that will be passed to the function are those provided
+                         by the client. Callback functions can only be used
+                         when addressing an individual client.
+        :param ignore_queue: Only used when a message queue is configured. If
+                             set to ``True``, the event is emitted to the
+                             clients directly, without going through the queue.
+                             This is more efficient, but only works when a
+                             single server process is used. It is recommended
+                             to always leave this parameter with its default
+                             value of ``False``.
+        """
+        namespace = namespace or '/'
+        room = to or room
+        self.logger.info('emitting event "%s" to %s [%s]', event,
+                         room or 'all', namespace)
+        self.manager.emit(event, data, namespace, room=room,
+                          skip_sid=skip_sid, callback=callback, **kwargs)
+
+    def send(self, data, to=None, room=None, skip_sid=None, namespace=None,
+             callback=None, **kwargs):
+        """Send a message to one or more connected clients.
+
+        This function emits an event with the name ``'message'``. Use
+        :func:`emit` to issue custom event names.
+
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param to: The recipient of the message. This can be set to the
+                   session ID of a client to address only that client, or to
+                   to any custom room created by the application to address all
+                   the clients in that room, If this argument is omitted the
+                   event is broadcasted to all connected clients.
+        :param room: Alias for the ``to`` parameter.
+        :param skip_sid: The session ID of a client to skip when broadcasting
+                         to a room or to all clients. This can be used to
+                         prevent a message from being sent to the sender. To
+                         skip multiple sids, pass a list.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param callback: If given, this function will be called to acknowledge
+                         the the client has received the message. The arguments
+                         that will be passed to the function are those provided
+                         by the client. Callback functions can only be used
+                         when addressing an individual client.
+        :param ignore_queue: Only used when a message queue is configured. If
+                             set to ``True``, the event is emitted to the
+                             clients directly, without going through the queue.
+                             This is more efficient, but only works when a
+                             single server process is used. It is recommended
+                             to always leave this parameter with its default
+                             value of ``False``.
+        """
+        self.emit('message', data=data, to=to, room=room, skip_sid=skip_sid,
+                  namespace=namespace, callback=callback, **kwargs)
+
+    def call(self, event, data=None, to=None, sid=None, namespace=None,
+             timeout=60, **kwargs):
+        """Emit a custom event to a client and wait for the response.
+
+        :param event: The event name. It can be any string. The event names
+                      ``'connect'``, ``'message'`` and ``'disconnect'`` are
+                      reserved and should not be used.
+        :param data: The data to send to the client or clients. Data can be of
+                     type ``str``, ``bytes``, ``list`` or ``dict``. If a
+                     ``list`` or ``dict``, the data will be serialized as JSON.
+        :param to: The session ID of the recipient client.
+        :param sid: Alias for the ``to`` parameter.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the event is emitted to the
+                          default namespace.
+        :param timeout: The waiting timeout. If the timeout is reached before
+                        the client acknowledges the event, then a
+                        ``TimeoutError`` exception is raised.
+        :param ignore_queue: Only used when a message queue is configured. If
+                             set to ``True``, the event is emitted to the
+                             client directly, without going through the queue.
+                             This is more efficient, but only works when a
+                             single server process is used. It is recommended
+                             to always leave this parameter with its default
+                             value of ``False``.
+        """
+        if not self.async_handlers:
+            raise RuntimeError(
+                'Cannot use call() when async_handlers is False.')
+        callback_event = self.eio.create_event()
+        callback_args = []
+
+        def event_callback(*args):
+            callback_args.append(args)
+            callback_event.set()
+
+        self.emit(event, data=data, room=to or sid, namespace=namespace,
+                  callback=event_callback, **kwargs)
+        if not callback_event.wait(timeout=timeout):
+            raise exceptions.TimeoutError()
+        return callback_args[0] if len(callback_args[0]) > 1 \
+            else callback_args[0][0] if len(callback_args[0]) == 1 \
+            else None
+
+    def enter_room(self, sid, room, namespace=None):
+        """Enter a room.
+
+        This function adds the client to a room. The :func:`emit` and
+        :func:`send` functions can optionally broadcast events to all the
+        clients in a room.
+
+        :param sid: Session ID of the client.
+        :param room: Room name. If the room does not exist it is created.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the default namespace is used.
+        """
+        namespace = namespace or '/'
+        self.logger.info('%s is entering room %s [%s]', sid, room, namespace)
+        self.manager.enter_room(sid, namespace, room)
+
+    def leave_room(self, sid, room, namespace=None):
+        """Leave a room.
+
+        This function removes the client from a room.
+
+        :param sid: Session ID of the client.
+        :param room: Room name.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the default namespace is used.
+        """
+        namespace = namespace or '/'
+        self.logger.info('%s is leaving room %s [%s]', sid, room, namespace)
+        self.manager.leave_room(sid, namespace, room)
+
+    def close_room(self, room, namespace=None):
+        """Close a room.
+
+        This function removes all the clients from the given room.
+
+        :param room: Room name.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the default namespace is used.
+        """
+        namespace = namespace or '/'
+        self.logger.info('room %s is closing [%s]', room, namespace)
+        self.manager.close_room(room, namespace)
+
+    def rooms(self, sid, namespace=None):
+        """Return the rooms a client is in.
+
+        :param sid: Session ID of the client.
+        :param namespace: The Socket.IO namespace for the event. If this
+                          argument is omitted the default namespace is used.
+        """
+        namespace = namespace or '/'
+        return self.manager.get_rooms(sid, namespace)
+
+    def get_session(self, sid, namespace=None):
+        """Return the user session for a client.
+
+        :param sid: The session id of the client.
+        :param namespace: The Socket.IO namespace. If this argument is omitted
+                          the default namespace is used.
+
+        The return value is a dictionary. Modifications made to this
+        dictionary are not guaranteed to be preserved unless
+        ``save_session()`` is called, or when the ``session`` context manager
+        is used.
+        """
+        namespace = namespace or '/'
+        eio_session = self.eio.get_session(sid)
+        return eio_session.setdefault(namespace, {})
+
+    def save_session(self, sid, session, namespace=None):
+        """Store the user session for a client.
+
+        :param sid: The session id of the client.
+        :param session: The session dictionary.
+        :param namespace: The Socket.IO namespace. If this argument is omitted
+                          the default namespace is used.
+        """
+        namespace = namespace or '/'
+        eio_session = self.eio.get_session(sid)
+        eio_session[namespace] = session
+
+    def session(self, sid, namespace=None):
+        """Return the user session for a client with context manager syntax.
+
+        :param sid: The session id of the client.
+
+        This is a context manager that returns the user session dictionary for
+        the client. Any changes that are made to this dictionary inside the
+        context manager block are saved back to the session. Example usage::
+
+            @sio.on('connect')
+            def on_connect(sid, environ):
+                username = authenticate_user(environ)
+                if not username:
+                    return False
+                with sio.session(sid) as session:
+                    session['username'] = username
+
+            @sio.on('message')
+            def on_message(sid, msg):
+                with sio.session(sid) as session:
+                    print('received message from ', session['username'])
+        """
+        class _session_context_manager(object):
+            def __init__(self, server, sid, namespace):
+                self.server = server
+                self.sid = sid
+                self.namespace = namespace
+                self.session = None
+
+            def __enter__(self):
+                self.session = self.server.get_session(sid,
+                                                       namespace=namespace)
+                return self.session
+
+            def __exit__(self, *args):
+                self.server.save_session(sid, self.session,
+                                         namespace=namespace)
+
+        return _session_context_manager(self, sid, namespace)
+
+    def disconnect(self, sid, namespace=None):
+        """Disconnect a client.
+
+        :param sid: Session ID of the client.
+        :param namespace: The Socket.IO namespace to disconnect. If this
+                          argument is omitted the default namespace is used.
+        """
+        namespace = namespace or '/'
+        if self.manager.is_connected(sid, namespace=namespace):
+            self.logger.info('Disconnecting %s [%s]', sid, namespace)
+            self.manager.pre_disconnect(sid, namespace=namespace)
+            self._send_packet(sid, packet.Packet(packet.DISCONNECT,
+                                                 namespace=namespace))
+            self._trigger_event('disconnect', namespace, sid)
+            self.manager.disconnect(sid, namespace=namespace)
+
+    def transport(self, sid):
+        """Return the name of the transport used by the client.
+
+        The two possible values returned by this function are ``'polling'``
+        and ``'websocket'``.
+
+        :param sid: The session of the client.
+        """
+        return self.eio.transport(sid)
+
+    def handle_request(self, environ, start_response):
+        """Handle an HTTP request from the client.
+
+        This is the entry point of the Socket.IO application, using the same
+        interface as a WSGI application. For the typical usage, this function
+        is invoked by the :class:`Middleware` instance, but it can be invoked
+        directly when the middleware is not used.
+
+        :param environ: The WSGI environment.
+        :param start_response: The WSGI ``start_response`` function.
+
+        This function returns the HTTP response body to deliver to the client
+        as a byte sequence.
+        """
+        return self.eio.handle_request(environ, start_response)
+
+    def start_background_task(self, target, *args, **kwargs):
+        """Start a background task using the appropriate async model.
+
+        This is a utility function that applications can use to start a
+        background task using the method that is compatible with the
+        selected async mode.
+
+        :param target: the target function to execute.
+        :param args: arguments to pass to the function.
+        :param kwargs: keyword arguments to pass to the function.
+
+        This function returns an object compatible with the `Thread` class in
+        the Python standard library. The `start()` method on this object is
+        already called by this function.
+        """
+        return self.eio.start_background_task(target, *args, **kwargs)
+
+    def sleep(self, seconds=0):
+        """Sleep for the requested amount of time using the appropriate async
+        model.
+
+        This is a utility function that applications can use to put a task to
+        sleep without having to worry about using the correct call for the
+        selected async mode.
+        """
+        return self.eio.sleep(seconds)
+
+    def _emit_internal(self, sid, event, data, namespace=None, id=None):
+        """Send a message to a client."""
+        if six.PY2 and not self.binary:
+            binary = False  # pragma: nocover
+        else:
+            binary = None
+        # tuples are expanded to multiple arguments, everything else is sent
+        # as a single argument
+        if isinstance(data, tuple):
+            data = list(data)
+        else:
+            data = [data]
+        self._send_packet(sid, packet.Packet(packet.EVENT, namespace=namespace,
+                                             data=[event] + data, id=id,
+                                             binary=binary))
+
+    def _send_packet(self, sid, pkt):
+        """Send a Socket.IO packet to a client."""
+        encoded_packet = pkt.encode()
+        if isinstance(encoded_packet, list):
+            binary = False
+            for ep in encoded_packet:
+                self.eio.send(sid, ep, binary=binary)
+                binary = True
+        else:
+            self.eio.send(sid, encoded_packet, binary=False)
+
+    def _handle_connect(self, sid, namespace):
+        """Handle a client connection request."""
+        namespace = namespace or '/'
+        self.manager.connect(sid, namespace)
+        if self.always_connect:
+            self._send_packet(sid, packet.Packet(packet.CONNECT,
+                                                 namespace=namespace))
+        fail_reason = None
+        try:
+            success = self._trigger_event('connect', namespace, sid,
+                                          self.environ[sid])
+        except exceptions.ConnectionRefusedError as exc:
+            fail_reason = exc.error_args
+            success = False
+
+        if success is False:
+            if self.always_connect:
+                self.manager.pre_disconnect(sid, namespace)
+                self._send_packet(sid, packet.Packet(
+                    packet.DISCONNECT, data=fail_reason, namespace=namespace))
+            self.manager.disconnect(sid, namespace)
+            if not self.always_connect:
+                self._send_packet(sid, packet.Packet(
+                    packet.ERROR, data=fail_reason, namespace=namespace))
+            if sid in self.environ:  # pragma: no cover
+                del self.environ[sid]
+            return False
+        elif not self.always_connect:
+            self._send_packet(sid, packet.Packet(packet.CONNECT,
+                                                 namespace=namespace))
+
+    def _handle_disconnect(self, sid, namespace):
+        """Handle a client disconnect."""
+        namespace = namespace or '/'
+        if namespace == '/':
+            namespace_list = list(self.manager.get_namespaces())
+        else:
+            namespace_list = [namespace]
+        for n in namespace_list:
+            if n != '/' and self.manager.is_connected(sid, n):
+                self._trigger_event('disconnect', n, sid)
+                self.manager.disconnect(sid, n)
+        if namespace == '/' and self.manager.is_connected(sid, namespace):
+            self._trigger_event('disconnect', '/', sid)
+            self.manager.disconnect(sid, '/')
+
+    def _handle_event(self, sid, namespace, id, data):
+        """Handle an incoming client event."""
+        namespace = namespace or '/'
+        self.logger.info('received event "%s" from %s [%s]', data[0], sid,
+                         namespace)
+        if self.async_handlers:
+            self.start_background_task(self._handle_event_internal, self, sid,
+                                       data, namespace, id)
+        else:
+            self._handle_event_internal(self, sid, data, namespace, id)
+
+    def _handle_event_internal(self, server, sid, data, namespace, id):
+        r = server._trigger_event(data[0], namespace, sid, *data[1:])
+        if id is not None:
+            # send ACK packet with the response returned by the handler
+            # tuples are expanded as multiple arguments
+            if r is None:
+                data = []
+            elif isinstance(r, tuple):
+                data = list(r)
+            else:
+                data = [r]
+            if six.PY2 and not self.binary:
+                binary = False  # pragma: nocover
+            else:
+                binary = None
+            server._send_packet(sid, packet.Packet(packet.ACK,
+                                                   namespace=namespace,
+                                                   id=id, data=data,
+                                                   binary=binary))
+
+    def _handle_ack(self, sid, namespace, id, data):
+        """Handle ACK packets from the client."""
+        namespace = namespace or '/'
+        self.logger.info('received ack from %s [%s]', sid, namespace)
+        self.manager.trigger_callback(sid, namespace, id, data)
+
+    def _trigger_event(self, event, namespace, *args):
+        """Invoke an application event handler."""
+        # first see if we have an explicit handler for the event
+        if namespace in self.handlers and event in self.handlers[namespace]:
+            return self.handlers[namespace][event](*args)
+
+        # or else, forward the event to a namespace handler if one exists
+        elif namespace in self.namespace_handlers:
+            return self.namespace_handlers[namespace].trigger_event(
+                event, *args)
+
+    def _handle_eio_connect(self, sid, environ):
+        """Handle the Engine.IO connection event."""
+        if not self.manager_initialized:
+            self.manager_initialized = True
+            self.manager.initialize()
+        self.environ[sid] = environ
+        return self._handle_connect(sid, '/')
+
+    def _handle_eio_message(self, sid, data):
+        """Dispatch Engine.IO messages."""
+        if sid in self._binary_packet:
+            pkt = self._binary_packet[sid]
+            if pkt.add_attachment(data):
+                del self._binary_packet[sid]
+                if pkt.packet_type == packet.BINARY_EVENT:
+                    self._handle_event(sid, pkt.namespace, pkt.id, pkt.data)
+                else:
+                    self._handle_ack(sid, pkt.namespace, pkt.id, pkt.data)
+        else:
+            pkt = packet.Packet(encoded_packet=data)
+            if pkt.packet_type == packet.CONNECT:
+                self._handle_connect(sid, pkt.namespace)
+            elif pkt.packet_type == packet.DISCONNECT:
+                self._handle_disconnect(sid, pkt.namespace)
+            elif pkt.packet_type == packet.EVENT:
+                self._handle_event(sid, pkt.namespace, pkt.id, pkt.data)
+            elif pkt.packet_type == packet.ACK:
+                self._handle_ack(sid, pkt.namespace, pkt.id, pkt.data)
+            elif pkt.packet_type == packet.BINARY_EVENT or \
+                    pkt.packet_type == packet.BINARY_ACK:
+                self._binary_packet[sid] = pkt
+            elif pkt.packet_type == packet.ERROR:
+                raise ValueError('Unexpected ERROR packet.')
+            else:
+                raise ValueError('Unknown packet type.')
+
+    def _handle_eio_disconnect(self, sid):
+        """Handle Engine.IO disconnect event."""
+        self._handle_disconnect(sid, '/')
+        if sid in self.environ:
+            del self.environ[sid]
+
+    def _engineio_server_class(self):
+        return engineio.Server
diff --git a/openpype/vendor/python/python_2/socketio/tornado.py b/openpype/vendor/python/python_2/socketio/tornado.py
new file mode 100644
index 0000000000..5b2e6f684f
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/tornado.py
@@ -0,0 +1,11 @@
+import sys
+if sys.version_info >= (3, 5):
+    try:
+        from engineio.async_drivers.tornado import get_tornado_handler as \
+            get_engineio_handler
+    except ImportError:  # pragma: no cover
+        get_engineio_handler = None
+
+
+def get_tornado_handler(socketio_server):  # pragma: no cover
+    return get_engineio_handler(socketio_server.eio)
diff --git a/openpype/vendor/python/python_2/socketio/zmq_manager.py b/openpype/vendor/python/python_2/socketio/zmq_manager.py
new file mode 100644
index 0000000000..f2a2ae5dc6
--- /dev/null
+++ b/openpype/vendor/python/python_2/socketio/zmq_manager.py
@@ -0,0 +1,111 @@
+import pickle
+import re
+
+try:
+    import eventlet.green.zmq as zmq
+except ImportError:
+    zmq = None
+import six
+
+from .pubsub_manager import PubSubManager
+
+
+class ZmqManager(PubSubManager):  # pragma: no cover
+    """zmq based client manager.
+
+    NOTE: this zmq implementation should be considered experimental at this
+    time. At this time, eventlet is required to use zmq.
+
+    This class implements a zmq backend for event sharing across multiple
+    processes. To use a zmq backend, initialize the :class:`Server` instance as
+    follows::
+
+        url = 'zmq+tcp://hostname:port1+port2'
+        server = socketio.Server(client_manager=socketio.ZmqManager(url))
+
+    :param url: The connection URL for the zmq message broker,
+                which will need to be provided and running.
+    :param channel: The channel name on which the server sends and receives
+                    notifications. Must be the same in all the servers.
+    :param write_only: If set to ``True``, only initialize to emit events. The
+                       default of ``False`` initializes the class for emitting
+                       and receiving.
+
+    A zmq message broker must be running for the zmq_manager to work.
+    you can write your own or adapt one from the following simple broker
+    below::
+
+        import zmq
+
+        receiver = zmq.Context().socket(zmq.PULL)
+        receiver.bind("tcp://*:5555")
+
+        publisher = zmq.Context().socket(zmq.PUB)
+        publisher.bind("tcp://*:5556")
+
+        while True:
+            publisher.send(receiver.recv())
+    """
+    name = 'zmq'
+
+    def __init__(self, url='zmq+tcp://localhost:5555+5556',
+                 channel='socketio',
+                 write_only=False,
+                 logger=None):
+        if zmq is None:
+            raise RuntimeError('zmq package is not installed '
+                               '(Run "pip install pyzmq" in your '
+                               'virtualenv).')
+
+        r = re.compile(r':\d+\+\d+$')
+        if not (url.startswith('zmq+tcp://') and r.search(url)):
+            raise RuntimeError('unexpected connection string: ' + url)
+
+        url = url.replace('zmq+', '')
+        (sink_url, sub_port) = url.split('+')
+        sink_port = sink_url.split(':')[-1]
+        sub_url = sink_url.replace(sink_port, sub_port)
+
+        sink = zmq.Context().socket(zmq.PUSH)
+        sink.connect(sink_url)
+
+        sub = zmq.Context().socket(zmq.SUB)
+        sub.setsockopt_string(zmq.SUBSCRIBE, u'')
+        sub.connect(sub_url)
+
+        self.sink = sink
+        self.sub = sub
+        self.channel = channel
+        super(ZmqManager, self).__init__(channel=channel,
+                                         write_only=write_only,
+                                         logger=logger)
+
+    def _publish(self, data):
+        pickled_data = pickle.dumps(
+            {
+                'type': 'message',
+                'channel': self.channel,
+                'data': data
+            }
+        )
+        return self.sink.send(pickled_data)
+
+    def zmq_listen(self):
+        while True:
+            response = self.sub.recv()
+            if response is not None:
+                yield response
+
+    def _listen(self):
+        for message in self.zmq_listen():
+            if isinstance(message, six.binary_type):
+                try:
+                    message = pickle.loads(message)
+                except Exception:
+                    pass
+            if isinstance(message, dict) and \
+                    message['type'] == 'message' and \
+                    message['channel'] == self.channel and \
+                    'data' in message:
+                yield message['data']
+        return
diff --git a/openpype/vendor/python/python_2/websocket/__init__.py b/openpype/vendor/python/python_2/websocket/__init__.py
new file mode 100644
index 0000000000..f2c7b44c17
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/__init__.py
@@ -0,0 +1,28 @@
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+from ._abnf import *
+from ._app import WebSocketApp
+from ._core import *
+from ._exceptions import *
+from ._logging import *
+from ._socket import *
+
+__version__ = "0.59.0"
diff --git a/openpype/vendor/python/python_2/websocket/_abnf.py b/openpype/vendor/python/python_2/websocket/_abnf.py
new file mode 100644
index 0000000000..80fbe1f9b9
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_abnf.py
@@ -0,0 +1,458 @@
+"""
+
+"""
+
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+import array
+import os
+import struct
+
+import six
+
+from ._exceptions import *
+from ._utils import validate_utf8
+from threading import Lock
+
+try:
+    if six.PY3:
+        import numpy
+    else:
+        numpy = None
+except ImportError:
+    numpy = None
+
+try:
+    # If wsaccel is available we use compiled routines to mask data.
+    if not numpy:
+        from wsaccel.xormask import XorMaskerSimple
+
+        def _mask(_m, _d):
+            return XorMaskerSimple(_m).process(_d)
+except ImportError:
+    # wsaccel is not available, we rely on python implementations.
+    def _mask(_m, _d):
+        for i in range(len(_d)):
+            _d[i] ^= _m[i % 4]
+
+        if six.PY3:
+            return _d.tobytes()
+        else:
+            return _d.tostring()
+
+
+__all__ = [
+    'ABNF', 'continuous_frame', 'frame_buffer',
+    'STATUS_NORMAL',
+    'STATUS_GOING_AWAY',
+    'STATUS_PROTOCOL_ERROR',
+    'STATUS_UNSUPPORTED_DATA_TYPE',
+    'STATUS_STATUS_NOT_AVAILABLE',
+    'STATUS_ABNORMAL_CLOSED',
+    'STATUS_INVALID_PAYLOAD',
+    'STATUS_POLICY_VIOLATION',
+    'STATUS_MESSAGE_TOO_BIG',
+    'STATUS_INVALID_EXTENSION',
+    'STATUS_UNEXPECTED_CONDITION',
+    'STATUS_BAD_GATEWAY',
+    'STATUS_TLS_HANDSHAKE_ERROR',
+]
+
+# closing frame status codes.
+STATUS_NORMAL = 1000
+STATUS_GOING_AWAY = 1001
+STATUS_PROTOCOL_ERROR = 1002
+STATUS_UNSUPPORTED_DATA_TYPE = 1003
+STATUS_STATUS_NOT_AVAILABLE = 1005
+STATUS_ABNORMAL_CLOSED = 1006
+STATUS_INVALID_PAYLOAD = 1007
+STATUS_POLICY_VIOLATION = 1008
+STATUS_MESSAGE_TOO_BIG = 1009
+STATUS_INVALID_EXTENSION = 1010
+STATUS_UNEXPECTED_CONDITION = 1011
+STATUS_BAD_GATEWAY = 1014
+STATUS_TLS_HANDSHAKE_ERROR = 1015
+
+VALID_CLOSE_STATUS = (
+    STATUS_NORMAL,
+    STATUS_GOING_AWAY,
+    STATUS_PROTOCOL_ERROR,
+    STATUS_UNSUPPORTED_DATA_TYPE,
+    STATUS_INVALID_PAYLOAD,
+    STATUS_POLICY_VIOLATION,
+    STATUS_MESSAGE_TOO_BIG,
+    STATUS_INVALID_EXTENSION,
+    STATUS_UNEXPECTED_CONDITION,
+    STATUS_BAD_GATEWAY,
+)
+
+
+class ABNF(object):
+    """
+    ABNF frame class.
+    See http://tools.ietf.org/html/rfc5234
+    and http://tools.ietf.org/html/rfc6455#section-5.2
+    """
+
+    # operation code values.
+    OPCODE_CONT = 0x0
+    OPCODE_TEXT = 0x1
+    OPCODE_BINARY = 0x2
+    OPCODE_CLOSE = 0x8
+    OPCODE_PING = 0x9
+    OPCODE_PONG = 0xa
+
+    # available operation code value tuple
+    OPCODES = (OPCODE_CONT, OPCODE_TEXT, OPCODE_BINARY, OPCODE_CLOSE,
+               OPCODE_PING, OPCODE_PONG)
+
+    # opcode human readable string
+    OPCODE_MAP = {
+        OPCODE_CONT: "cont",
+        OPCODE_TEXT: "text",
+        OPCODE_BINARY: "binary",
+        OPCODE_CLOSE: "close",
+        OPCODE_PING: "ping",
+        OPCODE_PONG: "pong"
+    }
+
+    # data length threshold.
+    LENGTH_7 = 0x7e
+    LENGTH_16 = 1 << 16
+    LENGTH_63 = 1 << 63
+
+    def __init__(self, fin=0, rsv1=0, rsv2=0, rsv3=0,
+                 opcode=OPCODE_TEXT, mask=1, data=""):
+        """
+        Constructor for ABNF. Please check RFC for arguments.
+        """
+        self.fin = fin
+        self.rsv1 = rsv1
+        self.rsv2 = rsv2
+        self.rsv3 = rsv3
+        self.opcode = opcode
+        self.mask = mask
+        if data is None:
+            data = ""
+        self.data = data
+        self.get_mask_key = os.urandom
+
+    def validate(self, skip_utf8_validation=False):
+        """
+        Validate the ABNF frame.
+
+        Parameters
+        ----------
+        skip_utf8_validation: skip utf8 validation.
+        """
+        if self.rsv1 or self.rsv2 or self.rsv3:
+            raise WebSocketProtocolException("rsv is not implemented, yet")
+
+        if self.opcode not in ABNF.OPCODES:
+            raise WebSocketProtocolException("Invalid opcode %r", self.opcode)
+
+        if self.opcode == ABNF.OPCODE_PING and not self.fin:
+            raise WebSocketProtocolException("Invalid ping frame.")
+
+        if self.opcode == ABNF.OPCODE_CLOSE:
+            l = len(self.data)
+            if not l:
+                return
+            if l == 1 or l >= 126:
+                raise WebSocketProtocolException("Invalid close frame.")
+            if l > 2 and not skip_utf8_validation and not validate_utf8(self.data[2:]):
+                raise WebSocketProtocolException("Invalid close frame.")
+
+            code = 256 * \
+                six.byte2int(self.data[0:1]) + six.byte2int(self.data[1:2])
+            if not self._is_valid_close_status(code):
+                raise WebSocketProtocolException("Invalid close opcode.")
+
+    @staticmethod
+    def _is_valid_close_status(code):
+        return code in VALID_CLOSE_STATUS or (3000 <= code < 5000)
+
+    def __str__(self):
+        return "fin=" + str(self.fin) \
+            + " opcode=" + str(self.opcode) \
+            + " data=" + str(self.data)
+
+    @staticmethod
+    def create_frame(data, opcode, fin=1):
+        """
+        Create frame to send text, binary and other data.
+
+        Parameters
+        ----------
+        data: <type>
+            data to send. This is string value(byte array).
+            If opcode is OPCODE_TEXT and this value is unicode,
+            data value is converted into unicode string, automatically.
+        opcode: <type>
+            operation code. please see OPCODE_XXX.
+        fin: <type>
+            fin flag. if set to 0, create continue fragmentation.
+        """
+        if opcode == ABNF.OPCODE_TEXT and isinstance(data, six.text_type):
+            data = data.encode("utf-8")
+        # mask must be set if send data from client
+        return ABNF(fin, 0, 0, 0, opcode, 1, data)
+
+    def format(self):
+        """
+        Format this object to string(byte array) to send data to server.
+        """
+        if any(x not in (0, 1) for x in [self.fin, self.rsv1, self.rsv2, self.rsv3]):
+            raise ValueError("not 0 or 1")
+        if self.opcode not in ABNF.OPCODES:
+            raise ValueError("Invalid OPCODE")
+        length = len(self.data)
+        if length >= ABNF.LENGTH_63:
+            raise ValueError("data is too long")
+
+        frame_header = chr(self.fin << 7 |
+                           self.rsv1 << 6 | self.rsv2 << 5 | self.rsv3 << 4 |
+                           self.opcode)
+        if length < ABNF.LENGTH_7:
+            frame_header += chr(self.mask << 7 | length)
+            frame_header = six.b(frame_header)
+        elif length < ABNF.LENGTH_16:
+            frame_header += chr(self.mask << 7 | 0x7e)
+            frame_header = six.b(frame_header)
+            frame_header += struct.pack("!H", length)
+        else:
+            frame_header += chr(self.mask << 7 | 0x7f)
+            frame_header = six.b(frame_header)
+            frame_header += struct.pack("!Q", length)
+
+        if not self.mask:
+            return frame_header + self.data
+        else:
+            mask_key = self.get_mask_key(4)
+            return frame_header + self._get_masked(mask_key)
+
+    def _get_masked(self, mask_key):
+        s = ABNF.mask(mask_key, self.data)
+
+        if isinstance(mask_key, six.text_type):
+            mask_key = mask_key.encode('utf-8')
+
+        return mask_key + s
+
+    @staticmethod
+    def mask(mask_key, data):
+        """
+        Mask or unmask data. Just do xor for each byte
+
+        Parameters
+        ----------
+        mask_key: <type>
+            4 byte string(byte).
+        data: <type>
+            data to mask/unmask.
+        """
+        if data is None:
+            data = ""
+
+        if isinstance(mask_key, six.text_type):
+            mask_key = six.b(mask_key)
+
+        if isinstance(data, six.text_type):
+            data = six.b(data)
+
+        if numpy:
+            origlen = len(data)
+            _mask_key = mask_key[3] << 24 | mask_key[2] << 16 | mask_key[1] << 8 | mask_key[0]
+
+            # We need data to be a multiple of four...
+            data += bytes(" " * (4 - (len(data) % 4)), "us-ascii")
+            a = numpy.frombuffer(data, dtype="uint32")
+            masked = numpy.bitwise_xor(a, [_mask_key]).astype("uint32")
+            if len(data) > origlen:
+                return masked.tobytes()[:origlen]
+            return masked.tobytes()
+        else:
+            _m = array.array("B", mask_key)
+            _d = array.array("B", data)
+            return _mask(_m, _d)
+
+
+class frame_buffer(object):
+    _HEADER_MASK_INDEX = 5
+    _HEADER_LENGTH_INDEX = 6
+
+    def __init__(self, recv_fn, skip_utf8_validation):
+        self.recv = recv_fn
+        self.skip_utf8_validation = skip_utf8_validation
+        # Buffers over the packets from the layer beneath until desired amount
+        # bytes of bytes are received.
+        self.recv_buffer = []
+        self.clear()
+        self.lock = Lock()
+
+    def clear(self):
+        self.header = None
+        self.length = None
+        self.mask = None
+
+    def has_received_header(self):
+        return self.header is None
+
+    def recv_header(self):
+        header = self.recv_strict(2)
+        b1 = header[0]
+
+        if six.PY2:
+            b1 = ord(b1)
+
+        fin = b1 >> 7 & 1
+        rsv1 = b1 >> 6 & 1
+        rsv2 = b1 >> 5 & 1
+        rsv3 = b1 >> 4 & 1
+        opcode = b1 & 0xf
+        b2 = header[1]
+
+        if six.PY2:
+            b2 = ord(b2)
+
+        has_mask = b2 >> 7 & 1
+        length_bits = b2 & 0x7f
+
+        self.header = (fin, rsv1, rsv2, rsv3, opcode, has_mask, length_bits)
+
+    def has_mask(self):
+        if not self.header:
+            return False
+        return self.header[frame_buffer._HEADER_MASK_INDEX]
+
+    def has_received_length(self):
+        return self.length is None
+
+    def recv_length(self):
+        bits = self.header[frame_buffer._HEADER_LENGTH_INDEX]
+        length_bits = bits & 0x7f
+        if length_bits == 0x7e:
+            v = self.recv_strict(2)
+            self.length = struct.unpack("!H", v)[0]
+        elif length_bits == 0x7f:
+            v = self.recv_strict(8)
+            self.length = struct.unpack("!Q", v)[0]
+        else:
+            self.length = length_bits
+
+    def has_received_mask(self):
+        return self.mask is None
+
+    def recv_mask(self):
+        self.mask = self.recv_strict(4) if self.has_mask() else ""
+
+    def recv_frame(self):
+
+        with self.lock:
+            # Header
+            if self.has_received_header():
+                self.recv_header()
+            (fin, rsv1, rsv2, rsv3, opcode, has_mask, _) = self.header
+
+            # Frame length
+            if self.has_received_length():
+                self.recv_length()
+            length = self.length
+
+            # Mask
+            if self.has_received_mask():
+                self.recv_mask()
+            mask = self.mask
+
+            # Payload
+            payload = self.recv_strict(length)
+            if has_mask:
+                payload = ABNF.mask(mask, payload)
+
+            # Reset for next frame
+            self.clear()
+
+            frame = ABNF(fin, rsv1, rsv2, rsv3, opcode, has_mask, payload)
+            frame.validate(self.skip_utf8_validation)
+
+        return frame
+
+    def recv_strict(self, bufsize):
+        shortage = bufsize - sum(len(x) for x in self.recv_buffer)
+        while shortage > 0:
+            # Limit buffer size that we pass to socket.recv() to avoid
+            # fragmenting the heap -- the number of bytes recv() actually
+            # reads is limited by socket buffer and is relatively small,
+            # yet passing large numbers repeatedly causes lots of large
+            # buffers allocated and then shrunk, which results in
+            # fragmentation.
+            bytes_ = self.recv(min(16384, shortage))
+            self.recv_buffer.append(bytes_)
+            shortage -= len(bytes_)
+
+        unified = six.b("").join(self.recv_buffer)
+
+        if shortage == 0:
+            self.recv_buffer = []
+            return unified
+        else:
+            self.recv_buffer = [unified[bufsize:]]
+            return unified[:bufsize]
+
+
+class continuous_frame(object):
+
+    def __init__(self, fire_cont_frame, skip_utf8_validation):
+        self.fire_cont_frame = fire_cont_frame
+        self.skip_utf8_validation = skip_utf8_validation
+        self.cont_data = None
+        self.recving_frames = None
+
+    def validate(self, frame):
+        if not self.recving_frames and frame.opcode == ABNF.OPCODE_CONT:
+            raise WebSocketProtocolException("Illegal frame")
+        if self.recving_frames and \
+                frame.opcode in (ABNF.OPCODE_TEXT, ABNF.OPCODE_BINARY):
+            raise WebSocketProtocolException("Illegal frame")
+
+    def add(self, frame):
+        if self.cont_data:
+            self.cont_data[1] += frame.data
+        else:
+            if frame.opcode in (ABNF.OPCODE_TEXT, ABNF.OPCODE_BINARY):
+                self.recving_frames = frame.opcode
+            self.cont_data = [frame.opcode, frame.data]
+
+        if frame.fin:
+            self.recving_frames = None
+
+    def is_fire(self, frame):
+        return frame.fin or self.fire_cont_frame
+
+    def extract(self, frame):
+        data = self.cont_data
+        self.cont_data = None
+        frame.data = data[1]
+        if not self.fire_cont_frame and data[0] == ABNF.OPCODE_TEXT and not self.skip_utf8_validation and not validate_utf8(frame.data):
+            raise WebSocketPayloadException(
+                "cannot decode: " + repr(frame.data))
+
+        return [data[0], frame]
diff --git a/openpype/vendor/python/python_2/websocket/_app.py b/openpype/vendor/python/python_2/websocket/_app.py
new file mode 100644
index 0000000000..a3f91a38a3
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_app.py
@@ -0,0 +1,399 @@
+"""
+
+"""
+
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+import inspect
+import select
+import sys
+import threading
+import time
+import traceback
+
+import six
+
+from ._abnf import ABNF
+from ._core import WebSocket, getdefaulttimeout
+from ._exceptions import *
+from . import _logging
+
+
+__all__ = ["WebSocketApp"]
+
+
+class Dispatcher:
+    """
+    Dispatcher
+    """
+    def __init__(self, app, ping_timeout):
+        self.app = app
+        self.ping_timeout = ping_timeout
+
+    def read(self, sock, read_callback, check_callback):
+        while self.app.keep_running:
+            r, w, e = select.select(
+                (self.app.sock.sock, ), (), (), self.ping_timeout)
+            if r:
+                if not read_callback():
+                    break
+            check_callback()
+
+
+class SSLDispatcher:
+    """
+    SSLDispatcher
+    """
+    def __init__(self, app, ping_timeout):
+        self.app = app
+        self.ping_timeout = ping_timeout
+
+    def read(self, sock, read_callback, check_callback):
+        while self.app.keep_running:
+            r = self.select()
+            if r:
+                if not read_callback():
+                    break
+            check_callback()
+
+    def select(self):
+        sock = self.app.sock.sock
+        if sock.pending():
+            return [sock,]
+
+        r, w, e = select.select((sock, ), (), (), self.ping_timeout)
+        return r
+
+
+class WebSocketApp(object):
+    """
+    Higher level of APIs are provided. The interface is like JavaScript WebSocket object.
+    """
+
+    def __init__(self, url, header=None,
+                 on_open=None, on_message=None, on_error=None,
+                 on_close=None, on_ping=None, on_pong=None,
+                 on_cont_message=None,
+                 keep_running=True, get_mask_key=None, cookie=None,
+                 subprotocols=None,
+                 on_data=None):
+        """
+        WebSocketApp initialization
+
+        Parameters
+        ----------
+        url: <type>
+            websocket url.
+        header: list or dict
+            custom header for websocket handshake.
+        on_open: <type>
+            callable object which is called at opening websocket.
+            this function has one argument. The argument is this class object.
+        on_message: <type>
+            callable object which is called when received data.
+            on_message has 2 arguments.
+            The 1st argument is this class object.
+            The 2nd argument is utf-8 string which we get from the server.
+        on_error: <type>
+            callable object which is called when we get error.
+            on_error has 2 arguments.
+            The 1st argument is this class object.
+            The 2nd argument is exception object.
+        on_close: <type>
+            callable object which is called when closed the connection.
+            this function has one argument. The argument is this class object.
+        on_cont_message: <type>
+            callback object which is called when receive continued
+            frame data.
+            on_cont_message has 3 arguments.
+            The 1st argument is this class object.
+            The 2nd argument is utf-8 string which we get from the server.
+            The 3rd argument is continue flag. if 0, the data continue
+            to next frame data
+        on_data: <type>
+            callback object which is called when a message received.
+            This is called before on_message or on_cont_message,
+            and then on_message or on_cont_message is called.
+            on_data has 4 argument.
+            The 1st argument is this class object.
+            The 2nd argument is utf-8 string which we get from the server.
+            The 3rd argument is data type. ABNF.OPCODE_TEXT or ABNF.OPCODE_BINARY will be came.
+            The 4th argument is continue flag. if 0, the data continue
+        keep_running: <type>
+            this parameter is obsolete and ignored.
+        get_mask_key: func
+            a callable to produce new mask keys,
+            see the WebSocket.set_mask_key's docstring for more information
+        cookie: str
+            cookie value.
+        subprotocols: <type>
+            array of available sub protocols. default is None.
+        """
+        self.url = url
+        self.header = header if header is not None else []
+        self.cookie = cookie
+
+        self.on_open = on_open
+        self.on_message = on_message
+        self.on_data = on_data
+        self.on_error = on_error
+        self.on_close = on_close
+        self.on_ping = on_ping
+        self.on_pong = on_pong
+        self.on_cont_message = on_cont_message
+        self.keep_running = False
+        self.get_mask_key = get_mask_key
+        self.sock = None
+        self.last_ping_tm = 0
+        self.last_pong_tm = 0
+        self.subprotocols = subprotocols
+
+    def send(self, data, opcode=ABNF.OPCODE_TEXT):
+        """
+        send message
+
+        Parameters
+        ----------
+        data: <type>
+            Message to send. If you set opcode to OPCODE_TEXT,
+            data must be utf-8 string or unicode.
+        opcode: <type>
+            Operation code of data. default is OPCODE_TEXT.
+        """
+
+        if not self.sock or self.sock.send(data, opcode) == 0:
+            raise WebSocketConnectionClosedException(
+                "Connection is already closed.")
+
+    def close(self, **kwargs):
+        """
+        Close websocket connection.
+        """
+        self.keep_running = False
+        if self.sock:
+            self.sock.close(**kwargs)
+            self.sock = None
+
+    def _send_ping(self, interval, event, payload):
+        while not event.wait(interval):
+            self.last_ping_tm = time.time()
+            if self.sock:
+                try:
+                    self.sock.ping(payload)
+                except Exception as ex:
+                    _logging.warning("send_ping routine terminated: {}".format(ex))
+                    break
+
+    def run_forever(self, sockopt=None, sslopt=None,
+                    ping_interval=0, ping_timeout=None,
+                    ping_payload="",
+                    http_proxy_host=None, http_proxy_port=None,
+                    http_no_proxy=None, http_proxy_auth=None,
+                    skip_utf8_validation=False,
+                    host=None, origin=None, dispatcher=None,
+                    suppress_origin=False, proxy_type=None):
+        """
+        Run event loop for WebSocket framework.
+
+        This loop is an infinite loop and is alive while websocket is available.
+
+        Parameters
+        ----------
+        sockopt: tuple
+            values for socket.setsockopt.
+            sockopt must be tuple
+            and each element is argument of sock.setsockopt.
+        sslopt: dict
+            optional dict object for ssl socket option.
+        ping_interval: int or float
+            automatically send "ping" command
+            every specified period (in seconds)
+            if set to 0, not send automatically.
+        ping_timeout: int or float
+            timeout (in seconds) if the pong message is not received.
+        ping_payload: str
+            payload message to send with each ping.
+        http_proxy_host: <type>
+            http proxy host name.
+        http_proxy_port: <type>
+            http proxy port. If not set, set to 80.
+        http_no_proxy: <type>
+            host names, which doesn't use proxy.
+        skip_utf8_validation: bool
+            skip utf8 validation.
+        host: str
+            update host header.
+        origin: str
+            update origin header.
+        dispatcher: <type>
+            customize reading data from socket.
+        suppress_origin: bool
+            suppress outputting origin header.
+
+        Returns
+        -------
+        teardown: bool
+            False if caught KeyboardInterrupt, True if other exception was raised during a loop
+        """
+
+        if ping_timeout is not None and ping_timeout <= 0:
+            ping_timeout = None
+        if ping_timeout and ping_interval and ping_interval <= ping_timeout:
+            raise WebSocketException("Ensure ping_interval > ping_timeout")
+        if not sockopt:
+            sockopt = []
+        if not sslopt:
+            sslopt = {}
+        if self.sock:
+            raise WebSocketException("socket is already opened")
+        thread = None
+        self.keep_running = True
+        self.last_ping_tm = 0
+        self.last_pong_tm = 0
+
+        def teardown(close_frame=None):
+            """
+            Tears down the connection.
+
+            If close_frame is set, we will invoke the on_close handler with the
+            statusCode and reason from there.
+            """
+            if thread and thread.is_alive():
+                event.set()
+                thread.join()
+            self.keep_running = False
+            if self.sock:
+                self.sock.close()
+            close_args = self._get_close_args(
+                close_frame.data if close_frame else None)
+            self._callback(self.on_close, *close_args)
+            self.sock = None
+
+        try:
+            self.sock = WebSocket(
+                self.get_mask_key, sockopt=sockopt, sslopt=sslopt,
+                fire_cont_frame=self.on_cont_message is not None,
+                skip_utf8_validation=skip_utf8_validation,
+                enable_multithread=True if ping_interval else False)
+            self.sock.settimeout(getdefaulttimeout())
+            self.sock.connect(
+                self.url, header=self.header, cookie=self.cookie,
+                http_proxy_host=http_proxy_host,
+                http_proxy_port=http_proxy_port, http_no_proxy=http_no_proxy,
+                http_proxy_auth=http_proxy_auth, subprotocols=self.subprotocols,
+                host=host, origin=origin, suppress_origin=suppress_origin,
+                proxy_type=proxy_type)
+            if not dispatcher:
+                dispatcher = self.create_dispatcher(ping_timeout)
+
+            self._callback(self.on_open)
+
+            if ping_interval:
+                event = threading.Event()
+                thread = threading.Thread(
+                    target=self._send_ping, args=(ping_interval, event, ping_payload))
+                thread.daemon = True
+                thread.start()
+
+            def read():
+                if not self.keep_running:
+                    return teardown()
+
+                op_code, frame = self.sock.recv_data_frame(True)
+                if op_code == ABNF.OPCODE_CLOSE:
+                    return teardown(frame)
+                elif op_code == ABNF.OPCODE_PING:
+                    self._callback(self.on_ping, frame.data)
+                elif op_code == ABNF.OPCODE_PONG:
+                    self.last_pong_tm = time.time()
+                    self._callback(self.on_pong, frame.data)
+                elif op_code == ABNF.OPCODE_CONT and self.on_cont_message:
+                    self._callback(self.on_data, frame.data,
+                                   frame.opcode, frame.fin)
+                    self._callback(self.on_cont_message,
+                                   frame.data, frame.fin)
+                else:
+                    data = frame.data
+                    if six.PY3 and op_code == ABNF.OPCODE_TEXT:
+                        data = data.decode("utf-8")
+                    self._callback(self.on_data, data, frame.opcode, True)
+                    self._callback(self.on_message, data)
+
+                return True
+
+            def check():
+                if (ping_timeout):
+                    has_timeout_expired = time.time() - self.last_ping_tm > ping_timeout
+                    has_pong_not_arrived_after_last_ping = self.last_pong_tm - self.last_ping_tm < 0
+                    has_pong_arrived_too_late = self.last_pong_tm - self.last_ping_tm > ping_timeout
+
+                    if (self.last_ping_tm and
+                            has_timeout_expired and
+                            (has_pong_not_arrived_after_last_ping or has_pong_arrived_too_late)):
+                        raise WebSocketTimeoutException("ping/pong timed out")
+                return True
+
+            dispatcher.read(self.sock.sock, read, check)
+        except (Exception, KeyboardInterrupt, SystemExit) as e:
+            self._callback(self.on_error, e)
+            if isinstance(e, SystemExit):
+                # propagate SystemExit further
+                raise
+            teardown()
+            return not isinstance(e, KeyboardInterrupt)
+
+    def create_dispatcher(self, ping_timeout):
+        timeout = ping_timeout or 10
+        if self.sock.is_ssl():
+            return SSLDispatcher(self, timeout)
+
+        return Dispatcher(self, timeout)
+
+    def _get_close_args(self, data):
+        """
+        _get_close_args extracts the code, reason from the close body
+        if they exists, and if the self.on_close except three arguments
+        """
+        # if the on_close callback is "old", just return empty list
+        if sys.version_info < (3, 0):
+            if not self.on_close or len(inspect.getargspec(self.on_close).args) != 3:
+                return []
+        else:
+            if not self.on_close or len(inspect.getfullargspec(self.on_close).args) != 3:
+                return []
+
+        if data and len(data) >= 2:
+            code = 256 * six.byte2int(data[0:1]) + six.byte2int(data[1:2])
+            reason = data[2:].decode('utf-8')
+            return [code, reason]
+
+        return [None, None]
+
+    def _callback(self, callback, *args):
+        if callback:
+            try:
+                callback(self, *args)
+
+            except Exception as e:
+                _logging.error("error from callback {}: {}".format(callback, e))
+                if _logging.isEnabledForDebug():
+                    _, _, tb = sys.exc_info()
+                    traceback.print_tb(tb)
diff --git a/openpype/vendor/python/python_2/websocket/_cookiejar.py b/openpype/vendor/python/python_2/websocket/_cookiejar.py
new file mode 100644
index 0000000000..bc2891a650
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_cookiejar.py
@@ -0,0 +1,78 @@
+"""
+
+"""
+
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+try:
+    import Cookie
+except:
+    import http.cookies as Cookie
+
+
+class SimpleCookieJar(object):
+    def __init__(self):
+        self.jar = dict()
+
+    def add(self, set_cookie):
+        if set_cookie:
+            try:
+                simpleCookie = Cookie.SimpleCookie(set_cookie)
+            except:
+                simpleCookie = Cookie.SimpleCookie(set_cookie.encode('ascii', 'ignore'))
+
+            for k, v in simpleCookie.items():
+                domain = v.get("domain")
+                if domain:
+                    if not domain.startswith("."):
+                        domain = "." + domain
+                    cookie = self.jar.get(domain) if self.jar.get(domain) else Cookie.SimpleCookie()
+                    cookie.update(simpleCookie)
+                    self.jar[domain.lower()] = cookie
+
+    def set(self, set_cookie):
+        if set_cookie:
+            try:
+                simpleCookie = Cookie.SimpleCookie(set_cookie)
+            except:
+                simpleCookie = Cookie.SimpleCookie(set_cookie.encode('ascii', 'ignore'))
+
+            for k, v in simpleCookie.items():
+                domain = v.get("domain")
+                if domain:
+                    if not domain.startswith("."):
+                        domain = "." + domain
+                    self.jar[domain.lower()] = simpleCookie
+
+    def get(self, host):
+        if not host:
+            return ""
+
+        cookies = []
+        for domain, simpleCookie in self.jar.items():
+            host = host.lower()
+            if host.endswith(domain) or host == domain[1:]:
+                cookies.append(self.jar.get(domain))
+
+        return "; ".join(filter(
+            None, sorted(
+                ["%s=%s" % (k, v.value) for cookie in filter(None, cookies) for k, v in cookie.items()]
+            )))
diff --git a/openpype/vendor/python/python_2/websocket/_core.py b/openpype/vendor/python/python_2/websocket/_core.py
new file mode 100644
index 0000000000..1ff80f05d7
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_core.py
@@ -0,0 +1,595 @@
+from __future__ import print_function
+"""
+_core.py
+====================================
+WebSocket Python client
+"""
+
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+import socket
+import struct
+import threading
+import time
+
+import six
+
+# websocket modules
+from ._abnf import *
+from ._exceptions import *
+from ._handshake import *
+from ._http import *
+from ._logging import *
+from ._socket import *
+from ._ssl_compat import *
+from ._utils import *
+
+__all__ = ['WebSocket', 'create_connection']
+
+
+class WebSocket(object):
+    """
+    Low level WebSocket interface.
+
+    This class is based on the WebSocket protocol `draft-hixie-thewebsocketprotocol-76 <http://tools.ietf.org/html/draft-hixie-thewebsocketprotocol-76>`_
+
+    We can connect to the websocket server and send/receive data.
+    The following example is an echo client.
+
+    >>> import websocket
+    >>> ws = websocket.WebSocket()
+    >>> ws.connect("ws://echo.websocket.org")
+    >>> ws.send("Hello, Server")
+    >>> ws.recv()
+    'Hello, Server'
+    >>> ws.close()
+
+    Parameters
+    ----------
+    get_mask_key: func
+        a callable to produce new mask keys, see the set_mask_key
+        function's docstring for more details
+    sockopt: tuple
+        values for socket.setsockopt.
+        sockopt must be tuple and each element is argument of sock.setsockopt.
+    sslopt: dict
+        optional dict object for ssl socket option.
+    fire_cont_frame: bool
+        fire recv event for each cont frame. default is False
+    enable_multithread: bool
+        if set to True, lock send method.
+    skip_utf8_validation: bool
+        skip utf8 validation.
+    """
+
+    def __init__(self, get_mask_key=None, sockopt=None, sslopt=None,
+                 fire_cont_frame=False, enable_multithread=False,
+                 skip_utf8_validation=False, **_):
+        """
+        Initialize WebSocket object.
+
+        Parameters
+        ----------
+        sslopt: specify ssl certification verification options
+        """
+        self.sock_opt = sock_opt(sockopt, sslopt)
+        self.handshake_response = None
+        self.sock = None
+
+        self.connected = False
+        self.get_mask_key = get_mask_key
+        # These buffer over the build-up of a single frame.
+        self.frame_buffer = frame_buffer(self._recv, skip_utf8_validation)
+        self.cont_frame = continuous_frame(
+            fire_cont_frame, skip_utf8_validation)
+
+        if enable_multithread:
+            self.lock = threading.Lock()
+            self.readlock = threading.Lock()
+        else:
+            self.lock = NoLock()
+            self.readlock = NoLock()
+
+    def __iter__(self):
+        """
+        Allow iteration over websocket, implying sequential `recv` executions.
+        """
+        while True:
+            yield self.recv()
+
+    def __next__(self):
+        return self.recv()
+
+    def next(self):
+        return self.__next__()
+
+    def fileno(self):
+        return self.sock.fileno()
+
+    def set_mask_key(self, func):
+        """
+        Set function to create mask key. You can customize mask key generator.
+        Mainly, this is for testing purpose.
+
+        Parameters
+        ----------
+        func: func
+            callable object. the func takes 1 argument as integer.
+            The argument means length of mask key.
+            This func must return string(byte array),
+            which length is argument specified.
+        """
+        self.get_mask_key = func
+
+    def gettimeout(self):
+        """
+        Get the websocket timeout (in seconds) as an int or float
+
+        Returns
+        ----------
+        timeout: int or float
+             returns timeout value (in seconds). This value could be either float/integer.
+        """
+        return self.sock_opt.timeout
+
+    def settimeout(self, timeout):
+        """
+        Set the timeout to the websocket.
+
+        Parameters
+        ----------
+        timeout: int or float
+            timeout time (in seconds). This value could be either float/integer.
+        """
+        self.sock_opt.timeout = timeout
+        if self.sock:
+            self.sock.settimeout(timeout)
+
+    timeout = property(gettimeout, settimeout)
+
+    def getsubprotocol(self):
+        """
+        Get subprotocol
+        """
+        if self.handshake_response:
+            return self.handshake_response.subprotocol
+        else:
+            return None
+
+    subprotocol = property(getsubprotocol)
+
+    def getstatus(self):
+        """
+        Get handshake status
+        """
+        if self.handshake_response:
+            return self.handshake_response.status
+        else:
+            return None
+
+    status = property(getstatus)
+
+    def getheaders(self):
+        """
+        Get handshake response header
+        """
+        if self.handshake_response:
+            return self.handshake_response.headers
+        else:
+            return None
+
+    def is_ssl(self):
+        return isinstance(self.sock, ssl.SSLSocket)
+
+    headers = property(getheaders)
+
+    def connect(self, url, **options):
+        """
+        Connect to url. url is websocket url scheme.
+        ie. ws://host:port/resource
+        You can customize using 'options'.
+        If you set "header" list object, you can set your own custom header.
+
+        >>> ws = WebSocket()
+        >>> ws.connect("ws://echo.websocket.org/",
+                ...     header=["User-Agent: MyProgram",
+                ...             "x-custom: header"])
+
+        timeout: <type>
+            socket timeout time. This value is an integer or float.
+            if you set None for this value, it means "use default_timeout value"
+
+        Parameters
+        ----------
+        options:
+                 - header: list or dict
+                    custom http header list or dict.
+                 - cookie: str
+                    cookie value.
+                 - origin: str
+                    custom origin url.
+                 - suppress_origin: bool
+                    suppress outputting origin header.
+                 - host: str
+                    custom host header string.
+                 - http_proxy_host: <type>
+                    http proxy host name.
+                 - http_proxy_port: <type>
+                    http proxy port. If not set, set to 80.
+                 - http_no_proxy: <type>
+                    host names, which doesn't use proxy.
+                 - http_proxy_auth: <type>
+                    http proxy auth information. tuple of username and password. default is None
+                 - redirect_limit: <type>
+                    number of redirects to follow.
+                 - subprotocols: <type>
+                    array of available sub protocols. default is None.
+                 - socket: <type>
+                    pre-initialized stream socket.
+        """
+        self.sock_opt.timeout = options.get('timeout', self.sock_opt.timeout)
+        self.sock, addrs = connect(url, self.sock_opt, proxy_info(**options),
+                                   options.pop('socket', None))
+
+        try:
+            self.handshake_response = handshake(self.sock, *addrs, **options)
+            for attempt in range(options.pop('redirect_limit', 3)):
+                if self.handshake_response.status in SUPPORTED_REDIRECT_STATUSES:
+                    url = self.handshake_response.headers['location']
+                    self.sock.close()
+                    self.sock, addrs = connect(url, self.sock_opt, proxy_info(**options),
+                                               options.pop('socket', None))
+                    self.handshake_response = handshake(self.sock, *addrs, **options)
+            self.connected = True
+        except:
+            if self.sock:
+                self.sock.close()
+                self.sock = None
+            raise
+
+    def send(self, payload, opcode=ABNF.OPCODE_TEXT):
+        """
+        Send the data as string.
+
+        Parameters
+        ----------
+        payload:  <type>
+                  Payload must be utf-8 string or unicode,
+                  if the opcode is OPCODE_TEXT.
+                  Otherwise, it must be string(byte array)
+        opcode:   <type>
+                  operation code to send. Please see OPCODE_XXX.
+        """
+
+        frame = ABNF.create_frame(payload, opcode)
+        return self.send_frame(frame)
+
+    def send_frame(self, frame):
+        """
+        Send the data frame.
+
+        >>> ws = create_connection("ws://echo.websocket.org/")
+        >>> frame = ABNF.create_frame("Hello", ABNF.OPCODE_TEXT)
+        >>> ws.send_frame(frame)
+        >>> cont_frame = ABNF.create_frame("My name is ", ABNF.OPCODE_CONT, 0)
+        >>> ws.send_frame(frame)
+        >>> cont_frame = ABNF.create_frame("Foo Bar", ABNF.OPCODE_CONT, 1)
+        >>> ws.send_frame(frame)
+
+        Parameters
+        ----------
+        frame: <type>
+            frame data created by ABNF.create_frame
+        """
+        if self.get_mask_key:
+            frame.get_mask_key = self.get_mask_key
+        data = frame.format()
+        length = len(data)
+        if (isEnabledForTrace()):
+            trace("send: " + repr(data))
+
+        with self.lock:
+            while data:
+                l = self._send(data)
+                data = data[l:]
+
+        return length
+
+    def send_binary(self, payload):
+        return self.send(payload, ABNF.OPCODE_BINARY)
+
+    def ping(self, payload=""):
+        """
+        Send ping data.
+
+        Parameters
+        ----------
+        payload: <type>
+            data payload to send server.
+        """
+        if isinstance(payload, six.text_type):
+            payload = payload.encode("utf-8")
+        self.send(payload, ABNF.OPCODE_PING)
+
+    def pong(self, payload=""):
+        """
+        Send pong data.
+
+        Parameters
+        ----------
+        payload: <type>
+            data payload to send server.
+        """
+        if isinstance(payload, six.text_type):
+            payload = payload.encode("utf-8")
+        self.send(payload, ABNF.OPCODE_PONG)
+
+    def recv(self):
+        """
+        Receive string data(byte array) from the server.
+
+        Returns
+        ----------
+        data: string (byte array) value.
+        """
+        with self.readlock:
+            opcode, data = self.recv_data()
+        if six.PY3 and opcode == ABNF.OPCODE_TEXT:
+            return data.decode("utf-8")
+        elif opcode == ABNF.OPCODE_TEXT or opcode == ABNF.OPCODE_BINARY:
+            return data
+        else:
+            return ''
+
+    def recv_data(self, control_frame=False):
+        """
+        Receive data with operation code.
+
+        Parameters
+        ----------
+        control_frame: bool
+            a boolean flag indicating whether to return control frame
+            data, defaults to False
+
+        Returns
+        -------
+        opcode, frame.data: tuple
+            tuple of operation code and string(byte array) value.
+        """
+        opcode, frame = self.recv_data_frame(control_frame)
+        return opcode, frame.data
+
+    def recv_data_frame(self, control_frame=False):
+        """
+        Receive data with operation code.
+
+        Parameters
+        ----------
+        control_frame: bool
+            a boolean flag indicating whether to return control frame
+            data, defaults to False
+
+        Returns
+        -------
+        frame.opcode, frame: tuple
+            tuple of operation code and string(byte array) value.
+        """
+        while True:
+            frame = self.recv_frame()
+            if not frame:
+                # handle error:
+                # 'NoneType' object has no attribute 'opcode'
+                raise WebSocketProtocolException(
+                    "Not a valid frame %s" % frame)
+            elif frame.opcode in (ABNF.OPCODE_TEXT, ABNF.OPCODE_BINARY, ABNF.OPCODE_CONT):
+                self.cont_frame.validate(frame)
+                self.cont_frame.add(frame)
+
+                if self.cont_frame.is_fire(frame):
+                    return self.cont_frame.extract(frame)
+
+            elif frame.opcode == ABNF.OPCODE_CLOSE:
+                self.send_close()
+                return frame.opcode, frame
+            elif frame.opcode == ABNF.OPCODE_PING:
+                if len(frame.data) < 126:
+                    self.pong(frame.data)
+                else:
+                    raise WebSocketProtocolException(
+                        "Ping message is too long")
+                if control_frame:
+                    return frame.opcode, frame
+            elif frame.opcode == ABNF.OPCODE_PONG:
+                if control_frame:
+                    return frame.opcode, frame
+
+    def recv_frame(self):
+        """
+        Receive data as frame from server.
+
+        Returns
+        -------
+        self.frame_buffer.recv_frame(): ABNF frame object
+        """
+        return self.frame_buffer.recv_frame()
+
+    def send_close(self, status=STATUS_NORMAL, reason=six.b("")):
+        """
+        Send close data to the server.
+
+        Parameters
+        ----------
+        status: <type>
+            status code to send. see STATUS_XXX.
+        reason: str or bytes
+            the reason to close. This must be string or bytes.
+        """
+        if status < 0 or status >= ABNF.LENGTH_16:
+            raise ValueError("code is invalid range")
+        self.connected = False
+        self.send(struct.pack('!H', status) + reason, ABNF.OPCODE_CLOSE)
+
+    def close(self, status=STATUS_NORMAL, reason=six.b(""), timeout=3):
+        """
+        Close Websocket object
+
+        Parameters
+        ----------
+        status: <type>
+            status code to send. see STATUS_XXX.
+        reason: <type>
+            the reason to close. This must be string.
+        timeout: int or float
+            timeout until receive a close frame.
+            If None, it will wait forever until receive a close frame.
+        """
+        if self.connected:
+            if status < 0 or status >= ABNF.LENGTH_16:
+                raise ValueError("code is invalid range")
+
+            try:
+                self.connected = False
+                self.send(struct.pack('!H', status) + reason, ABNF.OPCODE_CLOSE)
+                sock_timeout = self.sock.gettimeout()
+                self.sock.settimeout(timeout)
+                start_time = time.time()
+                while timeout is None or time.time() - start_time < timeout:
+                    try:
+                        frame = self.recv_frame()
+                        if frame.opcode != ABNF.OPCODE_CLOSE:
+                            continue
+                        if isEnabledForError():
+                            recv_status = struct.unpack("!H", frame.data[0:2])[0]
+                            if recv_status >= 3000 and recv_status <= 4999:
+                                debug("close status: " + repr(recv_status))
+                            elif recv_status != STATUS_NORMAL:
+                                error("close status: " + repr(recv_status))
+                        break
+                    except:
+                        break
+                self.sock.settimeout(sock_timeout)
+                self.sock.shutdown(socket.SHUT_RDWR)
+            except:
+                pass
+
+            self.shutdown()
+
+    def abort(self):
+        """
+        Low-level asynchronous abort, wakes up other threads that are waiting in recv_*
+        """
+        if self.connected:
+            self.sock.shutdown(socket.SHUT_RDWR)
+
+    def shutdown(self):
+        """
+        close socket, immediately.
+        """
+        if self.sock:
+            self.sock.close()
+            self.sock = None
+            self.connected = False
+
+    def _send(self, data):
+        return send(self.sock, data)
+
+    def _recv(self, bufsize):
+        try:
+            return recv(self.sock, bufsize)
+        except WebSocketConnectionClosedException:
+            if self.sock:
+                self.sock.close()
+            self.sock = None
+            self.connected = False
+            raise
+
+
+def create_connection(url, timeout=None, class_=WebSocket, **options):
+    """
+    Connect to url and return websocket object.
+
+    Connect to url and return the WebSocket object.
+    Passing optional timeout parameter will set the timeout on the socket.
+    If no timeout is supplied,
+    the global default timeout setting returned by getdefaulttimeout() is used.
+    You can customize using 'options'.
+    If you set "header" list object, you can set your own custom header.
+
+    >>> conn = create_connection("ws://echo.websocket.org/",
+         ...     header=["User-Agent: MyProgram",
+         ...             "x-custom: header"])
+
+    Parameters
+    ----------
+    timeout: int or float
+             socket timeout time. This value could be either float/integer.
+             if you set None for this value,
+             it means "use default_timeout value"
+    class_: <type>
+            class to instantiate when creating the connection. It has to implement
+            settimeout and connect. It's __init__ should be compatible with
+            WebSocket.__init__, i.e. accept all of it's kwargs.
+    options: <type>
+             - header: list or dict
+                custom http header list or dict.
+             - cookie: str
+                cookie value.
+             - origin: str
+                custom origin url.
+             - suppress_origin: bool
+                suppress outputting origin header.
+             - host: <type>
+                custom host header string.
+             - http_proxy_host: <type>
+                http proxy host name.
+             - http_proxy_port: <type>
+                http proxy port. If not set, set to 80.
+             - http_no_proxy: <type>
+                host names, which doesn't use proxy.
+             - http_proxy_auth: <type>
+                http proxy auth information. tuple of username and password. default is None
+             - enable_multithread: bool
+                enable lock for multithread.
+             - redirect_limit: <type>
+                number of redirects to follow.
+             - sockopt: <type>
+                socket options
+             - sslopt: <type>
+                ssl option
+             - subprotocols: <type>
+                array of available sub protocols. default is None.
+             - skip_utf8_validation: bool
+                skip utf8 validation.
+             - socket: <type>
+                pre-initialized stream socket.
+    """
+    sockopt = options.pop("sockopt", [])
+    sslopt = options.pop("sslopt", {})
+    fire_cont_frame = options.pop("fire_cont_frame", False)
+    enable_multithread = options.pop("enable_multithread", False)
+    skip_utf8_validation = options.pop("skip_utf8_validation", False)
+    websock = class_(sockopt=sockopt, sslopt=sslopt,
+                     fire_cont_frame=fire_cont_frame,
+                     enable_multithread=enable_multithread,
+                     skip_utf8_validation=skip_utf8_validation, **options)
+    websock.settimeout(timeout if timeout is not None else getdefaulttimeout())
+    websock.connect(url, **options)
+    return websock
diff --git a/openpype/vendor/python/python_2/websocket/_exceptions.py b/openpype/vendor/python/python_2/websocket/_exceptions.py
new file mode 100644
index 0000000000..83c6e42b7d
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_exceptions.py
@@ -0,0 +1,86 @@
+"""
+Define WebSocket exceptions
+"""
+
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+
+
+class WebSocketException(Exception):
+    """
+    WebSocket exception class.
+    """
+    pass
+
+
+class WebSocketProtocolException(WebSocketException):
+    """
+    If the WebSocket protocol is invalid, this exception will be raised.
+    """
+    pass
+
+
+class WebSocketPayloadException(WebSocketException):
+    """
+    If the WebSocket payload is invalid, this exception will be raised.
+    """
+    pass
+
+
+class WebSocketConnectionClosedException(WebSocketException):
+    """
+    If remote host closed the connection or some network error happened,
+    this exception will be raised.
+    """
+    pass
+
+
+class WebSocketTimeoutException(WebSocketException):
+    """
+    WebSocketTimeoutException will be raised at socket timeout during read/write data.
+    """
+    pass
+
+
+class WebSocketProxyException(WebSocketException):
+    """
+    WebSocketProxyException will be raised when proxy error occurred.
+    """
+    pass
+
+
+class WebSocketBadStatusException(WebSocketException):
+    """
+    WebSocketBadStatusException will be raised when we get bad handshake status code.
+    """
+
+    def __init__(self, message, status_code, status_message=None, resp_headers=None):
+        msg = message % (status_code, status_message)
+        super(WebSocketBadStatusException, self).__init__(msg)
+        self.status_code = status_code
+        self.resp_headers = resp_headers
+
+
+class WebSocketAddressException(WebSocketException):
+    """
+    If the websocket address info cannot be found, this exception will be raised.
+    """
+    pass
diff --git a/openpype/vendor/python/python_2/websocket/_handshake.py b/openpype/vendor/python/python_2/websocket/_handshake.py
new file mode 100644
index 0000000000..c4d9d169da
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_handshake.py
@@ -0,0 +1,212 @@
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+import hashlib
+import hmac
+import os
+
+import six
+
+from ._cookiejar import SimpleCookieJar
+from ._exceptions import *
+from ._http import *
+from ._logging import *
+from ._socket import *
+
+if hasattr(six, 'PY3') and six.PY3:
+    from base64 import encodebytes as base64encode
+else:
+    from base64 import encodestring as base64encode
+
+if hasattr(six, 'PY3') and six.PY3:
+    if hasattr(six, 'PY34') and six.PY34:
+        from http import client as HTTPStatus
+    else:
+        from http import HTTPStatus
+else:
+    import httplib as HTTPStatus
+
+__all__ = ["handshake_response", "handshake", "SUPPORTED_REDIRECT_STATUSES"]
+
+if hasattr(hmac, "compare_digest"):
+    compare_digest = hmac.compare_digest
+else:
+    def compare_digest(s1, s2):
+        return s1 == s2
+
+# websocket supported version.
+VERSION = 13
+
+SUPPORTED_REDIRECT_STATUSES = (HTTPStatus.MOVED_PERMANENTLY, HTTPStatus.FOUND, HTTPStatus.SEE_OTHER,)
+SUCCESS_STATUSES = SUPPORTED_REDIRECT_STATUSES + (HTTPStatus.SWITCHING_PROTOCOLS,)
+
+CookieJar = SimpleCookieJar()
+
+
+class handshake_response(object):
+
+    def __init__(self, status, headers, subprotocol):
+        self.status = status
+        self.headers = headers
+        self.subprotocol = subprotocol
+        CookieJar.add(headers.get("set-cookie"))
+
+
+def handshake(sock, hostname, port, resource, **options):
+    headers, key = _get_handshake_headers(resource, hostname, port, options)
+
+    header_str = "\r\n".join(headers)
+    send(sock, header_str)
+    dump("request header", header_str)
+
+    status, resp = _get_resp_headers(sock)
+    if status in SUPPORTED_REDIRECT_STATUSES:
+        return handshake_response(status, resp, None)
+    success, subproto = _validate(resp, key, options.get("subprotocols"))
+    if not success:
+        raise WebSocketException("Invalid WebSocket Header")
+
+    return handshake_response(status, resp, subproto)
+
+
+def _pack_hostname(hostname):
+    # IPv6 address
+    if ':' in hostname:
+        return '[' + hostname + ']'
+
+    return hostname
+
+
+def _get_handshake_headers(resource, host, port, options):
+    headers = [
+        "GET %s HTTP/1.1" % resource,
+        "Upgrade: websocket"
+    ]
+    if port == 80 or port == 443:
+        hostport = _pack_hostname(host)
+    else:
+        hostport = "%s:%d" % (_pack_hostname(host), port)
+    if "host" in options and options["host"] is not None:
+        headers.append("Host: %s" % options["host"])
+    else:
+        headers.append("Host: %s" % hostport)
+
+    if "suppress_origin" not in options or not options["suppress_origin"]:
+        if "origin" in options and options["origin"] is not None:
+            headers.append("Origin: %s" % options["origin"])
+        else:
+            headers.append("Origin: http://%s" % hostport)
+
+    key = _create_sec_websocket_key()
+
+    # Append Sec-WebSocket-Key & Sec-WebSocket-Version if not manually specified
+    if 'header' not in options or 'Sec-WebSocket-Key' not in options['header']:
+        key = _create_sec_websocket_key()
+        headers.append("Sec-WebSocket-Key: %s" % key)
+    else:
+        key = options['header']['Sec-WebSocket-Key']
+
+    if 'header' not in options or 'Sec-WebSocket-Version' not in options['header']:
+        headers.append("Sec-WebSocket-Version: %s" % VERSION)
+
+    if 'connection' not in options or options['connection'] is None:
+        headers.append('Connection: Upgrade')
+    else:
+        headers.append(options['connection'])
+
+    subprotocols = options.get("subprotocols")
+    if subprotocols:
+        headers.append("Sec-WebSocket-Protocol: %s" % ",".join(subprotocols))
+
+    if "header" in options:
+        header = options["header"]
+        if isinstance(header, dict):
+            header = [
+                ": ".join([k, v])
+                for k, v in header.items()
+                if v is not None
+            ]
+        headers.extend(header)
+
+    server_cookie = CookieJar.get(host)
+    client_cookie = options.get("cookie", None)
+
+    cookie = "; ".join(filter(None, [server_cookie, client_cookie]))
+
+    if cookie:
+        headers.append("Cookie: %s" % cookie)
+
+    headers.append("")
+    headers.append("")
+
+    return headers, key
+
+
+def _get_resp_headers(sock, success_statuses=SUCCESS_STATUSES):
+    status, resp_headers, status_message = read_headers(sock)
+    if status not in success_statuses:
+        raise WebSocketBadStatusException("Handshake status %d %s", status, status_message, resp_headers)
+    return status, resp_headers
+
+
+_HEADERS_TO_CHECK = {
+    "upgrade": "websocket",
+    "connection": "upgrade",
+}
+
+
+def _validate(headers, key, subprotocols):
+    subproto = None
+    for k, v in _HEADERS_TO_CHECK.items():
+        r = headers.get(k, None)
+        if not r:
+            return False, None
+        r = [x.strip().lower() for x in r.split(',')]
+        if v not in r:
+            return False, None
+
+    if subprotocols:
+        subproto = headers.get("sec-websocket-protocol", None)
+        if not subproto or subproto.lower() not in [s.lower() for s in subprotocols]:
+            error("Invalid subprotocol: " + str(subprotocols))
+            return False, None
+        subproto = subproto.lower()
+
+    result = headers.get("sec-websocket-accept", None)
+    if not result:
+        return False, None
+    result = result.lower()
+
+    if isinstance(result, six.text_type):
+        result = result.encode('utf-8')
+
+    value = (key + "258EAFA5-E914-47DA-95CA-C5AB0DC85B11").encode('utf-8')
+    hashed = base64encode(hashlib.sha1(value).digest()).strip().lower()
+    success = compare_digest(hashed, result)
+
+    if success:
+        return True, subproto
+    else:
+        return False, None
+
+
+def _create_sec_websocket_key():
+    randomness = os.urandom(16)
+    return base64encode(randomness).decode('utf-8').strip()
diff --git a/openpype/vendor/python/python_2/websocket/_http.py b/openpype/vendor/python/python_2/websocket/_http.py
new file mode 100644
index 0000000000..b0dad48ce0
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_http.py
@@ -0,0 +1,335 @@
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+import errno
+import os
+import socket
+import sys
+
+import six
+
+from ._exceptions import *
+from ._logging import *
+from ._socket import*
+from ._ssl_compat import *
+from ._url import *
+
+if six.PY3:
+    from base64 import encodebytes as base64encode
+else:
+    from base64 import encodestring as base64encode
+
+__all__ = ["proxy_info", "connect", "read_headers"]
+
+try:
+    import socks
+    ProxyConnectionError = socks.ProxyConnectionError
+    HAS_PYSOCKS = True
+except:
+    class ProxyConnectionError(BaseException):
+        pass
+    HAS_PYSOCKS = False
+
+
+class proxy_info(object):
+
+    def __init__(self, **options):
+        self.type = options.get("proxy_type") or "http"
+        if not(self.type in ['http', 'socks4', 'socks5', 'socks5h']):
+            raise ValueError("proxy_type must be 'http', 'socks4', 'socks5' or 'socks5h'")
+        self.host = options.get("http_proxy_host", None)
+        if self.host:
+            self.port = options.get("http_proxy_port", 0)
+            self.auth = options.get("http_proxy_auth", None)
+            self.no_proxy = options.get("http_no_proxy", None)
+        else:
+            self.port = 0
+            self.auth = None
+            self.no_proxy = None
+
+
+def _open_proxied_socket(url, options, proxy):
+    hostname, port, resource, is_secure = parse_url(url)
+
+    if not HAS_PYSOCKS:
+        raise WebSocketException("PySocks module not found.")
+
+    ptype = socks.SOCKS5
+    rdns = False
+    if proxy.type == "socks4":
+        ptype = socks.SOCKS4
+    if proxy.type == "http":
+        ptype = socks.HTTP
+    if proxy.type[-1] == "h":
+        rdns = True
+
+    sock = socks.create_connection(
+        (hostname, port),
+        proxy_type=ptype,
+        proxy_addr=proxy.host,
+        proxy_port=proxy.port,
+        proxy_rdns=rdns,
+        proxy_username=proxy.auth[0] if proxy.auth else None,
+        proxy_password=proxy.auth[1] if proxy.auth else None,
+        timeout=options.timeout,
+        socket_options=DEFAULT_SOCKET_OPTION + options.sockopt
+    )
+
+    if is_secure:
+        if HAVE_SSL:
+            sock = _ssl_socket(sock, options.sslopt, hostname)
+        else:
+            raise WebSocketException("SSL not available.")
+
+    return sock, (hostname, port, resource)
+
+
+def connect(url, options, proxy, socket):
+    if proxy.host and not socket and not (proxy.type == 'http'):
+        return _open_proxied_socket(url, options, proxy)
+
+    hostname, port, resource, is_secure = parse_url(url)
+
+    if socket:
+        return socket, (hostname, port, resource)
+
+    addrinfo_list, need_tunnel, auth = _get_addrinfo_list(
+        hostname, port, is_secure, proxy)
+    if not addrinfo_list:
+        raise WebSocketException(
+            "Host not found.: " + hostname + ":" + str(port))
+
+    sock = None
+    try:
+        sock = _open_socket(addrinfo_list, options.sockopt, options.timeout)
+        if need_tunnel:
+            sock = _tunnel(sock, hostname, port, auth)
+
+        if is_secure:
+            if HAVE_SSL:
+                sock = _ssl_socket(sock, options.sslopt, hostname)
+            else:
+                raise WebSocketException("SSL not available.")
+
+        return sock, (hostname, port, resource)
+    except:
+        if sock:
+            sock.close()
+        raise
+
+
+def _get_addrinfo_list(hostname, port, is_secure, proxy):
+    phost, pport, pauth = get_proxy_info(
+        hostname, is_secure, proxy.host, proxy.port, proxy.auth, proxy.no_proxy)
+    try:
+        # when running on windows 10, getaddrinfo without socktype returns a socktype 0.
+        # This generates an error exception: `_on_error: exception Socket type must be stream or datagram, not 0`
+        # or `OSError: [Errno 22] Invalid argument` when creating socket. Force the socket type to SOCK_STREAM.
+        if not phost:
+            addrinfo_list = socket.getaddrinfo(
+                hostname, port, 0, socket.SOCK_STREAM, socket.SOL_TCP)
+            return addrinfo_list, False, None
+        else:
+            pport = pport and pport or 80
+            # when running on windows 10, the getaddrinfo used above
+            # returns a socktype 0. This generates an error exception:
+            # _on_error: exception Socket type must be stream or datagram, not 0
+            # Force the socket type to SOCK_STREAM
+            addrinfo_list = socket.getaddrinfo(phost, pport, 0, socket.SOCK_STREAM, socket.SOL_TCP)
+            return addrinfo_list, True, pauth
+    except socket.gaierror as e:
+        raise WebSocketAddressException(e)
+
+
+def _open_socket(addrinfo_list, sockopt, timeout):
+    err = None
+    for addrinfo in addrinfo_list:
+        family, socktype, proto = addrinfo[:3]
+        sock = socket.socket(family, socktype, proto)
+        sock.settimeout(timeout)
+        for opts in DEFAULT_SOCKET_OPTION:
+            sock.setsockopt(*opts)
+        for opts in sockopt:
+            sock.setsockopt(*opts)
+
+        address = addrinfo[4]
+        err = None
+        while not err:
+            try:
+                sock.connect(address)
+            except ProxyConnectionError as error:
+                err = WebSocketProxyException(str(error))
+                err.remote_ip = str(address[0])
+                continue
+            except socket.error as error:
+                error.remote_ip = str(address[0])
+                try:
+                    eConnRefused = (errno.ECONNREFUSED, errno.WSAECONNREFUSED)
+                except:
+                    eConnRefused = (errno.ECONNREFUSED, )
+                if error.errno == errno.EINTR:
+                    continue
+                elif error.errno in eConnRefused:
+                    err = error
+                    continue
+                else:
+                    raise error
+            else:
+                break
+        else:
+            continue
+        break
+    else:
+        if err:
+            raise err
+
+    return sock
+
+
+def _can_use_sni():
+    return six.PY2 and sys.version_info >= (2, 7, 9) or sys.version_info >= (3, 2)
+
+
+def _wrap_sni_socket(sock, sslopt, hostname, check_hostname):
+    context = ssl.SSLContext(sslopt.get('ssl_version', ssl.PROTOCOL_SSLv23))
+
+    if sslopt.get('cert_reqs', ssl.CERT_NONE) != ssl.CERT_NONE:
+        cafile = sslopt.get('ca_certs', None)
+        capath = sslopt.get('ca_cert_path', None)
+        if cafile or capath:
+            context.load_verify_locations(cafile=cafile, capath=capath)
+        elif hasattr(context, 'load_default_certs'):
+            context.load_default_certs(ssl.Purpose.SERVER_AUTH)
+    if sslopt.get('certfile', None):
+        context.load_cert_chain(
+            sslopt['certfile'],
+            sslopt.get('keyfile', None),
+            sslopt.get('password', None),
+        )
+    # see
+    # https://github.com/liris/websocket-client/commit/b96a2e8fa765753e82eea531adb19716b52ca3ca#commitcomment-10803153
+    context.verify_mode = sslopt['cert_reqs']
+    if HAVE_CONTEXT_CHECK_HOSTNAME:
+        context.check_hostname = check_hostname
+    if 'ciphers' in sslopt:
+        context.set_ciphers(sslopt['ciphers'])
+    if 'cert_chain' in sslopt:
+        certfile, keyfile, password = sslopt['cert_chain']
+        context.load_cert_chain(certfile, keyfile, password)
+    if 'ecdh_curve' in sslopt:
+        context.set_ecdh_curve(sslopt['ecdh_curve'])
+
+    return context.wrap_socket(
+        sock,
+        do_handshake_on_connect=sslopt.get('do_handshake_on_connect', True),
+        suppress_ragged_eofs=sslopt.get('suppress_ragged_eofs', True),
+        server_hostname=hostname,
+    )
+
+
+def _ssl_socket(sock, user_sslopt, hostname):
+    sslopt = dict(cert_reqs=ssl.CERT_REQUIRED)
+    sslopt.update(user_sslopt)
+
+    certPath = os.environ.get('WEBSOCKET_CLIENT_CA_BUNDLE')
+    if certPath and os.path.isfile(certPath) \
+            and user_sslopt.get('ca_certs', None) is None \
+            and user_sslopt.get('ca_cert', None) is None:
+        sslopt['ca_certs'] = certPath
+    elif certPath and os.path.isdir(certPath) \
+            and user_sslopt.get('ca_cert_path', None) is None:
+        sslopt['ca_cert_path'] = certPath
+
+    check_hostname = sslopt["cert_reqs"] != ssl.CERT_NONE and sslopt.pop(
+        'check_hostname', True)
+
+    if _can_use_sni():
+        sock = _wrap_sni_socket(sock, sslopt, hostname, check_hostname)
+    else:
+        sslopt.pop('check_hostname', True)
+        sock = ssl.wrap_socket(sock, **sslopt)
+
+    if not HAVE_CONTEXT_CHECK_HOSTNAME and check_hostname:
+        match_hostname(sock.getpeercert(), hostname)
+
+    return sock
+
+
+def _tunnel(sock, host, port, auth):
+    debug("Connecting proxy...")
+    connect_header = "CONNECT %s:%d HTTP/1.1\r\n" % (host, port)
+    connect_header += "Host: %s:%d\r\n" % (host, port)
+
+    # TODO: support digest auth.
+    if auth and auth[0]:
+        auth_str = auth[0]
+        if auth[1]:
+            auth_str += ":" + auth[1]
+        encoded_str = base64encode(auth_str.encode()).strip().decode().replace('\n', '')
+        connect_header += "Proxy-Authorization: Basic %s\r\n" % encoded_str
+    connect_header += "\r\n"
+    dump("request header", connect_header)
+
+    send(sock, connect_header)
+
+    try:
+        status, resp_headers, status_message = read_headers(sock)
+    except Exception as e:
+        raise WebSocketProxyException(str(e))
+
+    if status != 200:
+        raise WebSocketProxyException(
+            "failed CONNECT via proxy status: %r" % status)
+
+    return sock
+
+
+def read_headers(sock):
+    status = None
+    status_message = None
+    headers = {}
+    trace("--- response header ---")
+
+    while True:
+        line = recv_line(sock)
+        line = line.decode('utf-8').strip()
+        if not line:
+            break
+        trace(line)
+        if not status:
+
+            status_info = line.split(" ", 2)
+            status = int(status_info[1])
+            if len(status_info) > 2:
+                status_message = status_info[2]
+        else:
+            kv = line.split(":", 1)
+            if len(kv) == 2:
+                key, value = kv
+                if key.lower() == "set-cookie" and headers.get("set-cookie"):
+                    headers["set-cookie"] = headers.get("set-cookie") + "; " + value.strip()
+                else:
+                    headers[key.lower()] = value.strip()
+            else:
+                raise WebSocketException("Invalid header")
+
+    trace("-----------------------")
+
+    return status, headers, status_message
diff --git a/openpype/vendor/python/python_2/websocket/_logging.py b/openpype/vendor/python/python_2/websocket/_logging.py
new file mode 100644
index 0000000000..07d9009031
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_logging.py
@@ -0,0 +1,92 @@
+"""
+
+"""
+
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+import logging
+
+_logger = logging.getLogger('websocket')
+try:
+    from logging import NullHandler
+except ImportError:
+    class NullHandler(logging.Handler):
+        def emit(self, record):
+            pass
+
+_logger.addHandler(NullHandler())
+
+_traceEnabled = False
+
+__all__ = ["enableTrace", "dump", "error", "warning", "debug", "trace",
+           "isEnabledForError", "isEnabledForDebug", "isEnabledForTrace"]
+
+
+def enableTrace(traceable, handler=logging.StreamHandler()):
+    """
+    Turn on/off the traceability.
+
+    Parameters
+    ----------
+    traceable: bool
+        If set to True, traceability is enabled.
+    """
+    global _traceEnabled
+    _traceEnabled = traceable
+    if traceable:
+        _logger.addHandler(handler)
+        _logger.setLevel(logging.DEBUG)
+
+
+def dump(title, message):
+    if _traceEnabled:
+        _logger.debug("--- " + title + " ---")
+        _logger.debug(message)
+        _logger.debug("-----------------------")
+
+
+def error(msg):
+    _logger.error(msg)
+
+
+def warning(msg):
+    _logger.warning(msg)
+
+
+def debug(msg):
+    _logger.debug(msg)
+
+
+def trace(msg):
+    if _traceEnabled:
+        _logger.debug(msg)
+
+
+def isEnabledForError():
+    return _logger.isEnabledFor(logging.ERROR)
+
+
+def isEnabledForDebug():
+    return _logger.isEnabledFor(logging.DEBUG)
+
+
+def isEnabledForTrace():
+    return _traceEnabled
diff --git a/openpype/vendor/python/python_2/websocket/_socket.py b/openpype/vendor/python/python_2/websocket/_socket.py
new file mode 100644
index 0000000000..2c383ed4d3
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_socket.py
@@ -0,0 +1,176 @@
+"""
+
+"""
+
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+import errno
+import select
+import socket
+
+import six
+
+from ._exceptions import *
+from ._ssl_compat import *
+from ._utils import *
+
+DEFAULT_SOCKET_OPTION = [(socket.SOL_TCP, socket.TCP_NODELAY, 1)]
+if hasattr(socket, "SO_KEEPALIVE"):
+    DEFAULT_SOCKET_OPTION.append((socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1))
+if hasattr(socket, "TCP_KEEPIDLE"):
+    DEFAULT_SOCKET_OPTION.append((socket.SOL_TCP, socket.TCP_KEEPIDLE, 30))
+if hasattr(socket, "TCP_KEEPINTVL"):
+    DEFAULT_SOCKET_OPTION.append((socket.SOL_TCP, socket.TCP_KEEPINTVL, 10))
+if hasattr(socket, "TCP_KEEPCNT"):
+    DEFAULT_SOCKET_OPTION.append((socket.SOL_TCP, socket.TCP_KEEPCNT, 3))
+
+_default_timeout = None
+
+__all__ = ["DEFAULT_SOCKET_OPTION", "sock_opt", "setdefaulttimeout", "getdefaulttimeout",
+           "recv", "recv_line", "send"]
+
+
+class sock_opt(object):
+
+    def __init__(self, sockopt, sslopt):
+        if sockopt is None:
+            sockopt = []
+        if sslopt is None:
+            sslopt = {}
+        self.sockopt = sockopt
+        self.sslopt = sslopt
+        self.timeout = None
+
+
+def setdefaulttimeout(timeout):
+    """
+    Set the global timeout setting to connect.
+
+    Parameters
+    ----------
+    timeout: int or float
+        default socket timeout time (in seconds)
+    """
+    global _default_timeout
+    _default_timeout = timeout
+
+
+def getdefaulttimeout():
+    """
+    Get default timeout
+
+    Returns
+    ----------
+    _default_timeout: int or float
+        Return the global timeout setting (in seconds) to connect.
+    """
+    return _default_timeout
+
+
+def recv(sock, bufsize):
+    if not sock:
+        raise WebSocketConnectionClosedException("socket is already closed.")
+
+    def _recv():
+        try:
+            return sock.recv(bufsize)
+        except SSLWantReadError:
+            pass
+        except socket.error as exc:
+            error_code = extract_error_code(exc)
+            if error_code is None:
+                raise
+            if error_code != errno.EAGAIN or error_code != errno.EWOULDBLOCK:
+                raise
+
+        r, w, e = select.select((sock, ), (), (), sock.gettimeout())
+        if r:
+            return sock.recv(bufsize)
+
+    try:
+        if sock.gettimeout() == 0:
+            bytes_ = sock.recv(bufsize)
+        else:
+            bytes_ = _recv()
+    except socket.timeout as e:
+        message = extract_err_message(e)
+        raise WebSocketTimeoutException(message)
+    except SSLError as e:
+        message = extract_err_message(e)
+        if isinstance(message, str) and 'timed out' in message:
+            raise WebSocketTimeoutException(message)
+        else:
+            raise
+
+    if not bytes_:
+        raise WebSocketConnectionClosedException(
+            "Connection is already closed.")
+
+    return bytes_
+
+
+def recv_line(sock):
+    line = []
+    while True:
+        c = recv(sock, 1)
+        line.append(c)
+        if c == six.b("\n"):
+            break
+    return six.b("").join(line)
+
+
+def send(sock, data):
+    if isinstance(data, six.text_type):
+        data = data.encode('utf-8')
+
+    if not sock:
+        raise WebSocketConnectionClosedException("socket is already closed.")
+
+    def _send():
+        try:
+            return sock.send(data)
+        except SSLWantWriteError:
+            pass
+        except socket.error as exc:
+            error_code = extract_error_code(exc)
+            if error_code is None:
+                raise
+            if error_code != errno.EAGAIN or error_code != errno.EWOULDBLOCK:
+                raise
+
+        r, w, e = select.select((), (sock, ), (), sock.gettimeout())
+        if w:
+            return sock.send(data)
+
+    try:
+        if sock.gettimeout() == 0:
+            return sock.send(data)
+        else:
+            return _send()
+    except socket.timeout as e:
+        message = extract_err_message(e)
+        raise WebSocketTimeoutException(message)
+    except Exception as e:
+        message = extract_err_message(e)
+        if isinstance(message, str) and "timed out" in message:
+            raise WebSocketTimeoutException(message)
+        else:
+            raise
diff --git a/openpype/vendor/python/python_2/websocket/_ssl_compat.py b/openpype/vendor/python/python_2/websocket/_ssl_compat.py
new file mode 100644
index 0000000000..9e201ddf00
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_ssl_compat.py
@@ -0,0 +1,53 @@
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+__all__ = ["HAVE_SSL", "ssl", "SSLError", "SSLWantReadError", "SSLWantWriteError"]
+
+try:
+    import ssl
+    from ssl import SSLError
+    from ssl import SSLWantReadError
+    from ssl import SSLWantWriteError
+    if hasattr(ssl, 'SSLContext') and hasattr(ssl.SSLContext, 'check_hostname'):
+        HAVE_CONTEXT_CHECK_HOSTNAME = True
+    else:
+        HAVE_CONTEXT_CHECK_HOSTNAME = False
+        if hasattr(ssl, "match_hostname"):
+            from ssl import match_hostname
+        else:
+            from backports.ssl_match_hostname import match_hostname
+        __all__.append("match_hostname")
+    __all__.append("HAVE_CONTEXT_CHECK_HOSTNAME")
+
+    HAVE_SSL = True
+except ImportError:
+    # dummy class of SSLError for ssl none-support environment.
+    class SSLError(Exception):
+        pass
+
+    class SSLWantReadError(Exception):
+        pass
+
+    class SSLWantWriteError(Exception):
+        pass
+
+    ssl = None
+
+    HAVE_SSL = False
diff --git a/openpype/vendor/python/python_2/websocket/_url.py b/openpype/vendor/python/python_2/websocket/_url.py
new file mode 100644
index 0000000000..92ff939e39
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_url.py
@@ -0,0 +1,178 @@
+"""
+
+"""
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+
+import os
+import socket
+import struct
+
+from six.moves.urllib.parse import urlparse
+
+
+__all__ = ["parse_url", "get_proxy_info"]
+
+
+def parse_url(url):
+    """
+    parse url and the result is tuple of
+    (hostname, port, resource path and the flag of secure mode)
+
+    Parameters
+    ----------
+    url: str
+        url string.
+    """
+    if ":" not in url:
+        raise ValueError("url is invalid")
+
+    scheme, url = url.split(":", 1)
+
+    parsed = urlparse(url, scheme="http")
+    if parsed.hostname:
+        hostname = parsed.hostname
+    else:
+        raise ValueError("hostname is invalid")
+    port = 0
+    if parsed.port:
+        port = parsed.port
+
+    is_secure = False
+    if scheme == "ws":
+        if not port:
+            port = 80
+    elif scheme == "wss":
+        is_secure = True
+        if not port:
+            port = 443
+    else:
+        raise ValueError("scheme %s is invalid" % scheme)
+
+    if parsed.path:
+        resource = parsed.path
+    else:
+        resource = "/"
+
+    if parsed.query:
+        resource += "?" + parsed.query
+
+    return hostname, port, resource, is_secure
+
+
+DEFAULT_NO_PROXY_HOST = ["localhost", "127.0.0.1"]
+
+
+def _is_ip_address(addr):
+    try:
+        socket.inet_aton(addr)
+    except socket.error:
+        return False
+    else:
+        return True
+
+
+def _is_subnet_address(hostname):
+    try:
+        addr, netmask = hostname.split("/")
+        return _is_ip_address(addr) and 0 <= int(netmask) < 32
+    except ValueError:
+        return False
+
+
+def _is_address_in_network(ip, net):
+    ipaddr = struct.unpack('!I', socket.inet_aton(ip))[0]
+    netaddr, netmask = net.split('/')
+    netaddr = struct.unpack('!I', socket.inet_aton(netaddr))[0]
+
+    netmask = (0xFFFFFFFF << (32 - int(netmask))) & 0xFFFFFFFF
+    return ipaddr & netmask == netaddr
+
+
+def _is_no_proxy_host(hostname, no_proxy):
+    if not no_proxy:
+        v = os.environ.get("no_proxy", "").replace(" ", "")
+        if v:
+            no_proxy = v.split(",")
+    if not no_proxy:
+        no_proxy = DEFAULT_NO_PROXY_HOST
+
+    if '*' in no_proxy:
+        return True
+    if hostname in no_proxy:
+        return True
+    if _is_ip_address(hostname):
+        return any([_is_address_in_network(hostname, subnet) for subnet in no_proxy if _is_subnet_address(subnet)])
+    for domain in [domain for domain in no_proxy if domain.startswith('.')]:
+        if hostname.endswith(domain):
+            return True
+    return False
+
+
+def get_proxy_info(
+        hostname, is_secure, proxy_host=None, proxy_port=0, proxy_auth=None,
+        no_proxy=None, proxy_type='http'):
+    """
+    Try to retrieve proxy host and port from environment
+    if not provided in options.
+    Result is (proxy_host, proxy_port, proxy_auth).
+    proxy_auth is tuple of username and password
+    of proxy authentication information.
+
+    Parameters
+    ----------
+    hostname: <type>
+        websocket server name.
+    is_secure: <type>
+        is the connection secure? (wss) looks for "https_proxy" in env
+        before falling back to "http_proxy"
+    options: <type>
+        - http_proxy_host: <type>
+            http proxy host name.
+        - http_proxy_port: <type>
+            http proxy port.
+        - http_no_proxy: <type>
+            host names, which doesn't use proxy.
+        - http_proxy_auth: <type>
+            http proxy auth information. tuple of username and password. default is None
+        - proxy_type: <type>
+            if set to "socks5" PySocks wrapper will be used in place of a http proxy. default is "http"
+    """
+    if _is_no_proxy_host(hostname, no_proxy):
+        return None, 0, None
+
+    if proxy_host:
+        port = proxy_port
+        auth = proxy_auth
+        return proxy_host, port, auth
+
+    env_keys = ["http_proxy"]
+    if is_secure:
+        env_keys.insert(0, "https_proxy")
+
+    for key in env_keys:
+        value = os.environ.get(key, None)
+        if value:
+            proxy = urlparse(value)
+            auth = (proxy.username, proxy.password) if proxy.username else None
+            return proxy.hostname, proxy.port, auth
+
+    return None, 0, None
diff --git a/openpype/vendor/python/python_2/websocket/_utils.py b/openpype/vendor/python/python_2/websocket/_utils.py
new file mode 100644
index 0000000000..0072bce8ac
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/_utils.py
@@ -0,0 +1,110 @@
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+import six
+
+__all__ = ["NoLock", "validate_utf8", "extract_err_message", "extract_error_code"]
+
+
+class NoLock(object):
+
+    def __enter__(self):
+        pass
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        pass
+
+
+try:
+    # If wsaccel is available we use compiled routines to validate UTF-8
+    # strings.
+    from wsaccel.utf8validator import Utf8Validator
+
+    def _validate_utf8(utfbytes):
+        return Utf8Validator().validate(utfbytes)[0]
+
+except ImportError:
+    # UTF-8 validator
+    # python implementation of http://bjoern.hoehrmann.de/utf-8/decoder/dfa/
+
+    _UTF8_ACCEPT = 0
+    _UTF8_REJECT = 12
+
+    _UTF8D = [
+        # The first part of the table maps bytes to character classes that
+        # to reduce the size of the transition table and create bitmasks.
+        0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,  0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+        0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,  0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+        0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,  0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+        0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,  0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+        1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,  9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
+        7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,  7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,
+        8,8,2,2,2,2,2,2,2,2,2,2,2,2,2,2,  2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,
+        10,3,3,3,3,3,3,3,3,3,3,3,3,4,3,3, 11,6,6,6,5,8,8,8,8,8,8,8,8,8,8,8,
+
+        # The second part is a transition table that maps a combination
+        # of a state of the automaton and a character class to a state.
+        0,12,24,36,60,96,84,12,12,12,48,72, 12,12,12,12,12,12,12,12,12,12,12,12,
+        12, 0,12,12,12,12,12, 0,12, 0,12,12, 12,24,12,12,12,12,12,24,12,24,12,12,
+        12,12,12,12,12,12,12,24,12,12,12,12, 12,24,12,12,12,12,12,12,12,24,12,12,
+        12,12,12,12,12,12,12,36,12,36,12,12, 12,36,12,12,12,12,12,36,12,36,12,12,
+        12,36,12,12,12,12,12,12,12,12,12,12, ]
+
+    def _decode(state, codep, ch):
+        tp = _UTF8D[ch]
+
+        codep = (ch & 0x3f) | (codep << 6) if (
+            state != _UTF8_ACCEPT) else (0xff >> tp) & ch
+        state = _UTF8D[256 + state + tp]
+
+        return state, codep
+
+    def _validate_utf8(utfbytes):
+        state = _UTF8_ACCEPT
+        codep = 0
+        for i in utfbytes:
+            if six.PY2:
+                i = ord(i)
+            state, codep = _decode(state, codep, i)
+            if state == _UTF8_REJECT:
+                return False
+
+        return True
+
+
+def validate_utf8(utfbytes):
+    """
+    validate utf8 byte string.
+    utfbytes: utf byte string to check.
+    return value: if valid utf8 string, return true. Otherwise, return false.
+    """
+    return _validate_utf8(utfbytes)
+
+
+def extract_err_message(exception):
+    if exception.args:
+        return exception.args[0]
+    else:
+        return None
+
+
+def extract_error_code(exception):
+    if exception.args and len(exception.args) > 1:
+        return exception.args[0] if isinstance(exception.args[0], int) else None
diff --git a/openpype/vendor/python/python_2/websocket/tests/__init__.py b/openpype/vendor/python/python_2/websocket/tests/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/vendor/python/python_2/websocket/tests/data/header01.txt b/openpype/vendor/python/python_2/websocket/tests/data/header01.txt
new file mode 100644
index 0000000000..d44d24c205
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/tests/data/header01.txt
@@ -0,0 +1,6 @@
+HTTP/1.1 101 WebSocket Protocol Handshake
+Connection: Upgrade 
+Upgrade: WebSocket
+Sec-WebSocket-Accept: Kxep+hNu9n51529fGidYu7a3wO0=
+some_header: something
+
diff --git a/openpype/vendor/python/python_2/websocket/tests/data/header02.txt b/openpype/vendor/python/python_2/websocket/tests/data/header02.txt
new file mode 100644
index 0000000000..f481de928a
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/tests/data/header02.txt
@@ -0,0 +1,6 @@
+HTTP/1.1 101 WebSocket Protocol Handshake
+Connection: Upgrade
+Upgrade WebSocket
+Sec-WebSocket-Accept: Kxep+hNu9n51529fGidYu7a3wO0=
+some_header: something
+
diff --git a/openpype/vendor/python/python_2/websocket/tests/data/header03.txt b/openpype/vendor/python/python_2/websocket/tests/data/header03.txt
new file mode 100644
index 0000000000..012b7d18dd
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/tests/data/header03.txt
@@ -0,0 +1,6 @@
+HTTP/1.1 101 WebSocket Protocol Handshake
+Connection: Upgrade, Keep-Alive
+Upgrade: WebSocket
+Sec-WebSocket-Accept: Kxep+hNu9n51529fGidYu7a3wO0=
+some_header: something
+
diff --git a/openpype/vendor/python/python_2/websocket/tests/test_abnf.py b/openpype/vendor/python/python_2/websocket/tests/test_abnf.py
new file mode 100644
index 0000000000..acce020682
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/tests/test_abnf.py
@@ -0,0 +1,77 @@
+# -*- coding: utf-8 -*-
+#
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+
+import os
+import websocket as ws
+from websocket._abnf import *
+import sys
+sys.path[0:0] = [""]
+
+if sys.version_info[0] == 2 and sys.version_info[1] < 7:
+    import unittest2 as unittest
+else:
+    import unittest
+
+
+class ABNFTest(unittest.TestCase):
+
+    def testInit(self):
+        a = ABNF(0,0,0,0, opcode=ABNF.OPCODE_PING)
+        self.assertEqual(a.fin, 0)
+        self.assertEqual(a.rsv1, 0)
+        self.assertEqual(a.rsv2, 0)
+        self.assertEqual(a.rsv3, 0)
+        self.assertEqual(a.opcode, 9)
+        self.assertEqual(a.data, '')
+        a_bad = ABNF(0,1,0,0, opcode=77)
+        self.assertEqual(a_bad.rsv1, 1)
+        self.assertEqual(a_bad.opcode, 77)
+
+    def testValidate(self):
+        a = ABNF(0,0,0,0, opcode=ABNF.OPCODE_PING)
+        self.assertRaises(ws.WebSocketProtocolException, a.validate)
+        a_bad = ABNF(0,1,0,0, opcode=77)
+        self.assertRaises(ws.WebSocketProtocolException, a_bad.validate)
+        a_close = ABNF(0,1,0,0, opcode=ABNF.OPCODE_CLOSE, data="abcdefgh1234567890abcdefgh1234567890abcdefgh1234567890abcdefgh1234567890")
+        self.assertRaises(ws.WebSocketProtocolException, a_close.validate)
+
+#    This caused an error in the Python 2.7 Github Actions build
+#    Uncomment test case when Python 2 support no longer wanted
+#    def testMask(self):
+#        ab = ABNF(0,0,0,0, opcode=ABNF.OPCODE_PING)
+#        bytes_val = bytes("aaaa", 'utf-8')
+#        self.assertEqual(ab._get_masked(bytes_val), bytes_val)
+
+    def testFrameBuffer(self):
+        fb = frame_buffer(0, True)
+        self.assertEqual(fb.recv, 0)
+        self.assertEqual(fb.skip_utf8_validation, True)
+        fb.clear
+        self.assertEqual(fb.header, None)
+        self.assertEqual(fb.length, None)
+        self.assertEqual(fb.mask, None)
+        self.assertEqual(fb.has_mask(), False)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/openpype/vendor/python/python_2/websocket/tests/test_app.py b/openpype/vendor/python/python_2/websocket/tests/test_app.py
new file mode 100644
index 0000000000..e5a739008e
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/tests/test_app.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+#
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+
+import os
+import os.path
+import websocket as ws
+import sys
+sys.path[0:0] = [""]
+
+try:
+    import ssl
+except ImportError:
+    HAVE_SSL = False
+
+if sys.version_info[0] == 2 and sys.version_info[1] < 7:
+    import unittest2 as unittest
+else:
+    import unittest
+
+# Skip test to access the internet.
+TEST_WITH_INTERNET = os.environ.get('TEST_WITH_INTERNET', '0') == '1'
+TRACEABLE = True
+
+
+class WebSocketAppTest(unittest.TestCase):
+
+    class NotSetYet(object):
+        """ A marker class for signalling that a value hasn't been set yet.
+        """
+
+    def setUp(self):
+        ws.enableTrace(TRACEABLE)
+
+        WebSocketAppTest.keep_running_open = WebSocketAppTest.NotSetYet()
+        WebSocketAppTest.keep_running_close = WebSocketAppTest.NotSetYet()
+        WebSocketAppTest.get_mask_key_id = WebSocketAppTest.NotSetYet()
+
+    def tearDown(self):
+        WebSocketAppTest.keep_running_open = WebSocketAppTest.NotSetYet()
+        WebSocketAppTest.keep_running_close = WebSocketAppTest.NotSetYet()
+        WebSocketAppTest.get_mask_key_id = WebSocketAppTest.NotSetYet()
+
+    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    def testKeepRunning(self):
+        """ A WebSocketApp should keep running as long as its self.keep_running
+        is not False (in the boolean context).
+        """
+
+        def on_open(self, *args, **kwargs):
+            """ Set the keep_running flag for later inspection and immediately
+            close the connection.
+            """
+            WebSocketAppTest.keep_running_open = self.keep_running
+
+            self.close()
+
+        def on_close(self, *args, **kwargs):
+            """ Set the keep_running flag for the test to use.
+            """
+            WebSocketAppTest.keep_running_close = self.keep_running
+
+        app = ws.WebSocketApp('ws://echo.websocket.org/', on_open=on_open, on_close=on_close)
+        app.run_forever()
+
+        # if numpy is installed, this assertion fail
+        # self.assertFalse(isinstance(WebSocketAppTest.keep_running_open,
+        #                             WebSocketAppTest.NotSetYet))
+
+        # self.assertFalse(isinstance(WebSocketAppTest.keep_running_close,
+        #                             WebSocketAppTest.NotSetYet))
+
+        # self.assertEqual(True, WebSocketAppTest.keep_running_open)
+        # self.assertEqual(False, WebSocketAppTest.keep_running_close)
+
+    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    def testSockMaskKey(self):
+        """ A WebSocketApp should forward the received mask_key function down
+        to the actual socket.
+        """
+
+        def my_mask_key_func():
+            pass
+
+        def on_open(self, *args, **kwargs):
+            """ Set the value so the test can use it later on and immediately
+            close the connection.
+            """
+            WebSocketAppTest.get_mask_key_id = id(self.get_mask_key)
+            self.close()
+
+        app = ws.WebSocketApp('ws://echo.websocket.org/', on_open=on_open, get_mask_key=my_mask_key_func)
+        app.run_forever()
+
+        # if numpy is installed, this assertion fail
+        # Note: We can't use 'is' for comparing the functions directly, need to use 'id'.
+        # self.assertEqual(WebSocketAppTest.get_mask_key_id, id(my_mask_key_func))
+
+    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    def testPingInterval(self):
+        """ A WebSocketApp should ping regularly
+        """
+
+        def on_ping(app, msg):
+            print("Got a ping!")
+            app.close()
+
+        def on_pong(app, msg):
+            print("Got a pong! No need to respond")
+            app.close()
+
+        app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1', on_ping=on_ping, on_pong=on_pong)
+        app.run_forever(ping_interval=2, ping_timeout=1)  # , sslopt={"cert_reqs": ssl.CERT_NONE}
+        self.assertRaises(ws.WebSocketException, app.run_forever, ping_interval=2, ping_timeout=3, sslopt={"cert_reqs": ssl.CERT_NONE})
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/openpype/vendor/python/python_2/websocket/tests/test_cookiejar.py b/openpype/vendor/python/python_2/websocket/tests/test_cookiejar.py
new file mode 100644
index 0000000000..fc66e58b0e
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/tests/test_cookiejar.py
@@ -0,0 +1,117 @@
+"""
+
+"""
+
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+import unittest
+
+from websocket._cookiejar import SimpleCookieJar
+
+
+class CookieJarTest(unittest.TestCase):
+    def testAdd(self):
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.add("")
+        self.assertFalse(cookie_jar.jar, "Cookie with no domain should not be added to the jar")
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.add("a=b")
+        self.assertFalse(cookie_jar.jar, "Cookie with no domain should not be added to the jar")
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.add("a=b; domain=.abc")
+        self.assertTrue(".abc" in cookie_jar.jar)
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.add("a=b; domain=abc")
+        self.assertTrue(".abc" in cookie_jar.jar)
+        self.assertTrue("abc" not in cookie_jar.jar)
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.add("a=b; c=d; domain=abc")
+        self.assertEqual(cookie_jar.get("abc"), "a=b; c=d")
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.add("a=b; c=d; domain=abc")
+        cookie_jar.add("e=f; domain=abc")
+        self.assertEqual(cookie_jar.get("abc"), "a=b; c=d; e=f")
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.add("a=b; c=d; domain=abc")
+        cookie_jar.add("e=f; domain=.abc")
+        self.assertEqual(cookie_jar.get("abc"), "a=b; c=d; e=f")
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.add("a=b; c=d; domain=abc")
+        cookie_jar.add("e=f; domain=xyz")
+        self.assertEqual(cookie_jar.get("abc"), "a=b; c=d")
+        self.assertEqual(cookie_jar.get("xyz"), "e=f")
+        self.assertEqual(cookie_jar.get("something"), "")
+
+    def testSet(self):
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.set("a=b")
+        self.assertFalse(cookie_jar.jar, "Cookie with no domain should not be added to the jar")
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.set("a=b; domain=.abc")
+        self.assertTrue(".abc" in cookie_jar.jar)
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.set("a=b; domain=abc")
+        self.assertTrue(".abc" in cookie_jar.jar)
+        self.assertTrue("abc" not in cookie_jar.jar)
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.set("a=b; c=d; domain=abc")
+        self.assertEqual(cookie_jar.get("abc"), "a=b; c=d")
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.set("a=b; c=d; domain=abc")
+        cookie_jar.set("e=f; domain=abc")
+        self.assertEqual(cookie_jar.get("abc"), "e=f")
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.set("a=b; c=d; domain=abc")
+        cookie_jar.set("e=f; domain=.abc")
+        self.assertEqual(cookie_jar.get("abc"), "e=f")
+
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.set("a=b; c=d; domain=abc")
+        cookie_jar.set("e=f; domain=xyz")
+        self.assertEqual(cookie_jar.get("abc"), "a=b; c=d")
+        self.assertEqual(cookie_jar.get("xyz"), "e=f")
+        self.assertEqual(cookie_jar.get("something"), "")
+
+    def testGet(self):
+        cookie_jar = SimpleCookieJar()
+        cookie_jar.set("a=b; c=d; domain=abc.com")
+        self.assertEqual(cookie_jar.get("abc.com"), "a=b; c=d")
+        self.assertEqual(cookie_jar.get("x.abc.com"), "a=b; c=d")
+        self.assertEqual(cookie_jar.get("abc.com.es"), "")
+        self.assertEqual(cookie_jar.get("xabc.com"), "")
+
+        cookie_jar.set("a=b; c=d; domain=.abc.com")
+        self.assertEqual(cookie_jar.get("abc.com"), "a=b; c=d")
+        self.assertEqual(cookie_jar.get("x.abc.com"), "a=b; c=d")
+        self.assertEqual(cookie_jar.get("abc.com.es"), "")
+        self.assertEqual(cookie_jar.get("xabc.com"), "")
diff --git a/openpype/vendor/python/python_2/websocket/tests/test_http.py b/openpype/vendor/python/python_2/websocket/tests/test_http.py
new file mode 100644
index 0000000000..0336ff7d7f
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/tests/test_http.py
@@ -0,0 +1,109 @@
+# -*- coding: utf-8 -*-
+#
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+
+import os
+import os.path
+import websocket as ws
+from websocket._http import proxy_info, read_headers, _open_proxied_socket, _tunnel
+import sys
+sys.path[0:0] = [""]
+
+if sys.version_info[0] == 2 and sys.version_info[1] < 7:
+    import unittest2 as unittest
+else:
+    import unittest
+
+
+class SockMock(object):
+    def __init__(self):
+        self.data = []
+        self.sent = []
+
+    def add_packet(self, data):
+        self.data.append(data)
+
+    def gettimeout(self):
+        return None
+
+    def recv(self, bufsize):
+        if self.data:
+            e = self.data.pop(0)
+            if isinstance(e, Exception):
+                raise e
+            if len(e) > bufsize:
+                self.data.insert(0, e[bufsize:])
+            return e[:bufsize]
+
+    def send(self, data):
+        self.sent.append(data)
+        return len(data)
+
+    def close(self):
+        pass
+
+
+class HeaderSockMock(SockMock):
+
+    def __init__(self, fname):
+        SockMock.__init__(self)
+        path = os.path.join(os.path.dirname(__file__), fname)
+        with open(path, "rb") as f:
+            self.add_packet(f.read())
+
+
+class OptsList():
+
+    def __init__(self):
+        self.timeout = 0
+        self.sockopt = []
+
+
+class HttpTest(unittest.TestCase):
+
+    def testReadHeader(self):
+        status, header, status_message = read_headers(HeaderSockMock("data/header01.txt"))
+        self.assertEqual(status, 101)
+        self.assertEqual(header["connection"], "Upgrade")
+        # header02.txt is intentionally malformed
+        self.assertRaises(ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt"))
+
+    def testTunnel(self):
+        self.assertRaises(ws.WebSocketProxyException, _tunnel, HeaderSockMock("data/header01.txt"), "example.com", 80, ("username", "password"))
+        self.assertRaises(ws.WebSocketProxyException, _tunnel, HeaderSockMock("data/header02.txt"), "example.com", 80, ("username", "password"))
+
+    def testConnect(self):
+        # Not currently testing an actual proxy connection, so just check whether TypeError is raised
+        self.assertRaises(TypeError, _open_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="http"))
+        self.assertRaises(TypeError, _open_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks4"))
+        self.assertRaises(TypeError, _open_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks5h"))
+
+    def testProxyInfo(self):
+        self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http").type, "http")
+        self.assertRaises(ValueError, proxy_info, http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="badval")
+        self.assertEqual(proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="http").host, "example.com")
+        self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http").port, "8080")
+        self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http").auth, None)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/openpype/vendor/python/python_2/websocket/tests/test_url.py b/openpype/vendor/python/python_2/websocket/tests/test_url.py
new file mode 100644
index 0000000000..b1d8e06f23
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/tests/test_url.py
@@ -0,0 +1,309 @@
+# -*- coding: utf-8 -*-
+#
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+
+import sys
+import os
+
+from websocket._url import get_proxy_info, parse_url, _is_address_in_network, _is_no_proxy_host
+
+if sys.version_info[0] == 2 and sys.version_info[1] < 7:
+    import unittest2 as unittest
+else:
+    import unittest
+sys.path[0:0] = [""]
+
+
+class UrlTest(unittest.TestCase):
+
+    def test_address_in_network(self):
+        self.assertTrue(_is_address_in_network('127.0.0.1', '127.0.0.0/8'))
+        self.assertTrue(_is_address_in_network('127.1.0.1', '127.0.0.0/8'))
+        self.assertFalse(_is_address_in_network('127.1.0.1', '127.0.0.0/24'))
+
+    def testParseUrl(self):
+        p = parse_url("ws://www.example.com/r")
+        self.assertEqual(p[0], "www.example.com")
+        self.assertEqual(p[1], 80)
+        self.assertEqual(p[2], "/r")
+        self.assertEqual(p[3], False)
+
+        p = parse_url("ws://www.example.com/r/")
+        self.assertEqual(p[0], "www.example.com")
+        self.assertEqual(p[1], 80)
+        self.assertEqual(p[2], "/r/")
+        self.assertEqual(p[3], False)
+
+        p = parse_url("ws://www.example.com/")
+        self.assertEqual(p[0], "www.example.com")
+        self.assertEqual(p[1], 80)
+        self.assertEqual(p[2], "/")
+        self.assertEqual(p[3], False)
+
+        p = parse_url("ws://www.example.com")
+        self.assertEqual(p[0], "www.example.com")
+        self.assertEqual(p[1], 80)
+        self.assertEqual(p[2], "/")
+        self.assertEqual(p[3], False)
+
+        p = parse_url("ws://www.example.com:8080/r")
+        self.assertEqual(p[0], "www.example.com")
+        self.assertEqual(p[1], 8080)
+        self.assertEqual(p[2], "/r")
+        self.assertEqual(p[3], False)
+
+        p = parse_url("ws://www.example.com:8080/")
+        self.assertEqual(p[0], "www.example.com")
+        self.assertEqual(p[1], 8080)
+        self.assertEqual(p[2], "/")
+        self.assertEqual(p[3], False)
+
+        p = parse_url("ws://www.example.com:8080")
+        self.assertEqual(p[0], "www.example.com")
+        self.assertEqual(p[1], 8080)
+        self.assertEqual(p[2], "/")
+        self.assertEqual(p[3], False)
+
+        p = parse_url("wss://www.example.com:8080/r")
+        self.assertEqual(p[0], "www.example.com")
+        self.assertEqual(p[1], 8080)
+        self.assertEqual(p[2], "/r")
+        self.assertEqual(p[3], True)
+
+        p = parse_url("wss://www.example.com:8080/r?key=value")
+        self.assertEqual(p[0], "www.example.com")
+        self.assertEqual(p[1], 8080)
+        self.assertEqual(p[2], "/r?key=value")
+        self.assertEqual(p[3], True)
+
+        self.assertRaises(ValueError, parse_url, "http://www.example.com/r")
+
+        if sys.version_info[0] == 2 and sys.version_info[1] < 7:
+            return
+
+        p = parse_url("ws://[2a03:4000:123:83::3]/r")
+        self.assertEqual(p[0], "2a03:4000:123:83::3")
+        self.assertEqual(p[1], 80)
+        self.assertEqual(p[2], "/r")
+        self.assertEqual(p[3], False)
+
+        p = parse_url("ws://[2a03:4000:123:83::3]:8080/r")
+        self.assertEqual(p[0], "2a03:4000:123:83::3")
+        self.assertEqual(p[1], 8080)
+        self.assertEqual(p[2], "/r")
+        self.assertEqual(p[3], False)
+
+        p = parse_url("wss://[2a03:4000:123:83::3]/r")
+        self.assertEqual(p[0], "2a03:4000:123:83::3")
+        self.assertEqual(p[1], 443)
+        self.assertEqual(p[2], "/r")
+        self.assertEqual(p[3], True)
+
+        p = parse_url("wss://[2a03:4000:123:83::3]:8080/r")
+        self.assertEqual(p[0], "2a03:4000:123:83::3")
+        self.assertEqual(p[1], 8080)
+        self.assertEqual(p[2], "/r")
+        self.assertEqual(p[3], True)
+
+
+class IsNoProxyHostTest(unittest.TestCase):
+    def setUp(self):
+        self.no_proxy = os.environ.get("no_proxy", None)
+        if "no_proxy" in os.environ:
+            del os.environ["no_proxy"]
+
+    def tearDown(self):
+        if self.no_proxy:
+            os.environ["no_proxy"] = self.no_proxy
+        elif "no_proxy" in os.environ:
+            del os.environ["no_proxy"]
+
+    def testMatchAll(self):
+        self.assertTrue(_is_no_proxy_host("any.websocket.org", ['*']))
+        self.assertTrue(_is_no_proxy_host("192.168.0.1", ['*']))
+        self.assertTrue(_is_no_proxy_host("any.websocket.org", ['other.websocket.org', '*']))
+        os.environ['no_proxy'] = '*'
+        self.assertTrue(_is_no_proxy_host("any.websocket.org", None))
+        self.assertTrue(_is_no_proxy_host("192.168.0.1", None))
+        os.environ['no_proxy'] = 'other.websocket.org, *'
+        self.assertTrue(_is_no_proxy_host("any.websocket.org", None))
+
+    def testIpAddress(self):
+        self.assertTrue(_is_no_proxy_host("127.0.0.1", ['127.0.0.1']))
+        self.assertFalse(_is_no_proxy_host("127.0.0.2", ['127.0.0.1']))
+        self.assertTrue(_is_no_proxy_host("127.0.0.1", ['other.websocket.org', '127.0.0.1']))
+        self.assertFalse(_is_no_proxy_host("127.0.0.2", ['other.websocket.org', '127.0.0.1']))
+        os.environ['no_proxy'] = '127.0.0.1'
+        self.assertTrue(_is_no_proxy_host("127.0.0.1", None))
+        self.assertFalse(_is_no_proxy_host("127.0.0.2", None))
+        os.environ['no_proxy'] = 'other.websocket.org, 127.0.0.1'
+        self.assertTrue(_is_no_proxy_host("127.0.0.1", None))
+        self.assertFalse(_is_no_proxy_host("127.0.0.2", None))
+
+    def testIpAddressInRange(self):
+        self.assertTrue(_is_no_proxy_host("127.0.0.1", ['127.0.0.0/8']))
+        self.assertTrue(_is_no_proxy_host("127.0.0.2", ['127.0.0.0/8']))
+        self.assertFalse(_is_no_proxy_host("127.1.0.1", ['127.0.0.0/24']))
+        os.environ['no_proxy'] = '127.0.0.0/8'
+        self.assertTrue(_is_no_proxy_host("127.0.0.1", None))
+        self.assertTrue(_is_no_proxy_host("127.0.0.2", None))
+        os.environ['no_proxy'] = '127.0.0.0/24'
+        self.assertFalse(_is_no_proxy_host("127.1.0.1", None))
+
+    def testHostnameMatch(self):
+        self.assertTrue(_is_no_proxy_host("my.websocket.org", ['my.websocket.org']))
+        self.assertTrue(_is_no_proxy_host("my.websocket.org", ['other.websocket.org', 'my.websocket.org']))
+        self.assertFalse(_is_no_proxy_host("my.websocket.org", ['other.websocket.org']))
+        os.environ['no_proxy'] = 'my.websocket.org'
+        self.assertTrue(_is_no_proxy_host("my.websocket.org", None))
+        self.assertFalse(_is_no_proxy_host("other.websocket.org", None))
+        os.environ['no_proxy'] = 'other.websocket.org, my.websocket.org'
+        self.assertTrue(_is_no_proxy_host("my.websocket.org", None))
+
+    def testHostnameMatchDomain(self):
+        self.assertTrue(_is_no_proxy_host("any.websocket.org", ['.websocket.org']))
+        self.assertTrue(_is_no_proxy_host("my.other.websocket.org", ['.websocket.org']))
+        self.assertTrue(_is_no_proxy_host("any.websocket.org", ['my.websocket.org', '.websocket.org']))
+        self.assertFalse(_is_no_proxy_host("any.websocket.com", ['.websocket.org']))
+        os.environ['no_proxy'] = '.websocket.org'
+        self.assertTrue(_is_no_proxy_host("any.websocket.org", None))
+        self.assertTrue(_is_no_proxy_host("my.other.websocket.org", None))
+        self.assertFalse(_is_no_proxy_host("any.websocket.com", None))
+        os.environ['no_proxy'] = 'my.websocket.org, .websocket.org'
+        self.assertTrue(_is_no_proxy_host("any.websocket.org", None))
+
+
+class ProxyInfoTest(unittest.TestCase):
+    def setUp(self):
+        self.http_proxy = os.environ.get("http_proxy", None)
+        self.https_proxy = os.environ.get("https_proxy", None)
+        self.no_proxy = os.environ.get("no_proxy", None)
+        if "http_proxy" in os.environ:
+            del os.environ["http_proxy"]
+        if "https_proxy" in os.environ:
+            del os.environ["https_proxy"]
+        if "no_proxy" in os.environ:
+            del os.environ["no_proxy"]
+
+    def tearDown(self):
+        if self.http_proxy:
+            os.environ["http_proxy"] = self.http_proxy
+        elif "http_proxy" in os.environ:
+            del os.environ["http_proxy"]
+
+        if self.https_proxy:
+            os.environ["https_proxy"] = self.https_proxy
+        elif "https_proxy" in os.environ:
+            del os.environ["https_proxy"]
+
+        if self.no_proxy:
+            os.environ["no_proxy"] = self.no_proxy
+        elif "no_proxy" in os.environ:
+            del os.environ["no_proxy"]
+
+    def testProxyFromArgs(self):
+        self.assertEqual(get_proxy_info("echo.websocket.org", False, proxy_host="localhost"), ("localhost", 0, None))
+        self.assertEqual(get_proxy_info("echo.websocket.org", False, proxy_host="localhost", proxy_port=3128),
+                         ("localhost", 3128, None))
+        self.assertEqual(get_proxy_info("echo.websocket.org", True, proxy_host="localhost"), ("localhost", 0, None))
+        self.assertEqual(get_proxy_info("echo.websocket.org", True, proxy_host="localhost", proxy_port=3128),
+                         ("localhost", 3128, None))
+
+        self.assertEqual(get_proxy_info("echo.websocket.org", False, proxy_host="localhost", proxy_auth=("a", "b")),
+                         ("localhost", 0, ("a", "b")))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.org", False, proxy_host="localhost", proxy_port=3128, proxy_auth=("a", "b")),
+            ("localhost", 3128, ("a", "b")))
+        self.assertEqual(get_proxy_info("echo.websocket.org", True, proxy_host="localhost", proxy_auth=("a", "b")),
+                         ("localhost", 0, ("a", "b")))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.org", True, proxy_host="localhost", proxy_port=3128, proxy_auth=("a", "b")),
+            ("localhost", 3128, ("a", "b")))
+
+        self.assertEqual(get_proxy_info("echo.websocket.org", True, proxy_host="localhost", proxy_port=3128,
+                                        no_proxy=["example.com"], proxy_auth=("a", "b")),
+                         ("localhost", 3128, ("a", "b")))
+        self.assertEqual(get_proxy_info("echo.websocket.org", True, proxy_host="localhost", proxy_port=3128,
+                                        no_proxy=["echo.websocket.org"], proxy_auth=("a", "b")),
+                         (None, 0, None))
+
+    def testProxyFromEnv(self):
+        os.environ["http_proxy"] = "http://localhost/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", None, None))
+        os.environ["http_proxy"] = "http://localhost:3128/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", 3128, None))
+
+        os.environ["http_proxy"] = "http://localhost/"
+        os.environ["https_proxy"] = "http://localhost2/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", None, None))
+        os.environ["http_proxy"] = "http://localhost:3128/"
+        os.environ["https_proxy"] = "http://localhost2:3128/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", 3128, None))
+
+        os.environ["http_proxy"] = "http://localhost/"
+        os.environ["https_proxy"] = "http://localhost2/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", True), ("localhost2", None, None))
+        os.environ["http_proxy"] = "http://localhost:3128/"
+        os.environ["https_proxy"] = "http://localhost2:3128/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", True), ("localhost2", 3128, None))
+
+        os.environ["http_proxy"] = "http://a:b@localhost/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", None, ("a", "b")))
+        os.environ["http_proxy"] = "http://a:b@localhost:3128/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", 3128, ("a", "b")))
+
+        os.environ["http_proxy"] = "http://a:b@localhost/"
+        os.environ["https_proxy"] = "http://a:b@localhost2/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", None, ("a", "b")))
+        os.environ["http_proxy"] = "http://a:b@localhost:3128/"
+        os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", 3128, ("a", "b")))
+
+        os.environ["http_proxy"] = "http://a:b@localhost/"
+        os.environ["https_proxy"] = "http://a:b@localhost2/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", True), ("localhost2", None, ("a", "b")))
+        os.environ["http_proxy"] = "http://a:b@localhost:3128/"
+        os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
+        self.assertEqual(get_proxy_info("echo.websocket.org", True), ("localhost2", 3128, ("a", "b")))
+
+        os.environ["http_proxy"] = "http://a:b@localhost/"
+        os.environ["https_proxy"] = "http://a:b@localhost2/"
+        os.environ["no_proxy"] = "example1.com,example2.com"
+        self.assertEqual(get_proxy_info("example.1.com", True), ("localhost2", None, ("a", "b")))
+        os.environ["http_proxy"] = "http://a:b@localhost:3128/"
+        os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
+        os.environ["no_proxy"] = "example1.com,example2.com, echo.websocket.org"
+        self.assertEqual(get_proxy_info("echo.websocket.org", True), (None, 0, None))
+        os.environ["http_proxy"] = "http://a:b@localhost:3128/"
+        os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
+        os.environ["no_proxy"] = "example1.com,example2.com, .websocket.org"
+        self.assertEqual(get_proxy_info("echo.websocket.org", True), (None, 0, None))
+
+        os.environ["http_proxy"] = "http://a:b@localhost:3128/"
+        os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
+        os.environ["no_proxy"] = "127.0.0.0/8, 192.168.0.0/16"
+        self.assertEqual(get_proxy_info("127.0.0.1", False), (None, 0, None))
+        self.assertEqual(get_proxy_info("192.168.1.1", False), (None, 0, None))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/openpype/vendor/python/python_2/websocket/tests/test_websocket.py b/openpype/vendor/python/python_2/websocket/tests/test_websocket.py
new file mode 100644
index 0000000000..0d1d6395ed
--- /dev/null
+++ b/openpype/vendor/python/python_2/websocket/tests/test_websocket.py
@@ -0,0 +1,433 @@
+# -*- coding: utf-8 -*-
+#
+"""
+
+"""
+
+"""
+websocket - WebSocket client library for Python
+
+Copyright (C) 2010 Hiroki Ohtani(liris)
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+"""
+
+import sys
+sys.path[0:0] = [""]
+
+import os
+import os.path
+import socket
+
+import six
+
+# websocket-client
+import websocket as ws
+from websocket._handshake import _create_sec_websocket_key, \
+    _validate as _validate_header
+from websocket._http import read_headers
+from websocket._utils import validate_utf8
+
+if six.PY3:
+    from base64 import decodebytes as base64decode
+else:
+    from base64 import decodestring as base64decode
+
+if sys.version_info[0] == 2 and sys.version_info[1] < 7:
+    import unittest2 as unittest
+else:
+    import unittest
+
+try:
+    from ssl import SSLError
+except ImportError:
+    # dummy class of SSLError for ssl none-support environment.
+    class SSLError(Exception):
+        pass
+
+# Skip test to access the internet.
+TEST_WITH_INTERNET = os.environ.get('TEST_WITH_INTERNET', '0') == '1'
+TRACEABLE = True
+
+
+def create_mask_key(_):
+    return "abcd"
+
+
+class SockMock(object):
+    def __init__(self):
+        self.data = []
+        self.sent = []
+
+    def add_packet(self, data):
+        self.data.append(data)
+
+    def gettimeout(self):
+        return None
+
+    def recv(self, bufsize):
+        if self.data:
+            e = self.data.pop(0)
+            if isinstance(e, Exception):
+                raise e
+            if len(e) > bufsize:
+                self.data.insert(0, e[bufsize:])
+            return e[:bufsize]
+
+    def send(self, data):
+        self.sent.append(data)
+        return len(data)
+
+    def close(self):
+        pass
+
+
+class HeaderSockMock(SockMock):
+
+    def __init__(self, fname):
+        SockMock.__init__(self)
+        path = os.path.join(os.path.dirname(__file__), fname)
+        with open(path, "rb") as f:
+            self.add_packet(f.read())
+
+
+class WebSocketTest(unittest.TestCase):
+    def setUp(self):
+        ws.enableTrace(TRACEABLE)
+
+    def tearDown(self):
+        pass
+
+    def testDefaultTimeout(self):
+        self.assertEqual(ws.getdefaulttimeout(), None)
+        ws.setdefaulttimeout(10)
+        self.assertEqual(ws.getdefaulttimeout(), 10)
+        ws.setdefaulttimeout(None)
+
+    def testWSKey(self):
+        key = _create_sec_websocket_key()
+        self.assertTrue(key != 24)
+        self.assertTrue(six.u("¥n") not in key)
+
+    def testNonce(self):
+        """ WebSocket key should be a random 16-byte nonce.
+        """
+        key = _create_sec_websocket_key()
+        nonce = base64decode(key.encode("utf-8"))
+        self.assertEqual(16, len(nonce))
+
+    def testWsUtils(self):
+        key = "c6b8hTg4EeGb2gQMztV1/g=="
+        required_header = {
+            "upgrade": "websocket",
+            "connection": "upgrade",
+            "sec-websocket-accept": "Kxep+hNu9n51529fGidYu7a3wO0="}
+        self.assertEqual(_validate_header(required_header, key, None), (True, None))
+
+        header = required_header.copy()
+        header["upgrade"] = "http"
+        self.assertEqual(_validate_header(header, key, None), (False, None))
+        del header["upgrade"]
+        self.assertEqual(_validate_header(header, key, None), (False, None))
+
+        header = required_header.copy()
+        header["connection"] = "something"
+        self.assertEqual(_validate_header(header, key, None), (False, None))
+        del header["connection"]
+        self.assertEqual(_validate_header(header, key, None), (False, None))
+
+        header = required_header.copy()
+        header["sec-websocket-accept"] = "something"
+        self.assertEqual(_validate_header(header, key, None), (False, None))
+        del header["sec-websocket-accept"]
+        self.assertEqual(_validate_header(header, key, None), (False, None))
+
+        header = required_header.copy()
+        header["sec-websocket-protocol"] = "sub1"
+        self.assertEqual(_validate_header(header, key, ["sub1", "sub2"]), (True, "sub1"))
+        self.assertEqual(_validate_header(header, key, ["sub2", "sub3"]), (False, None))
+
+        header = required_header.copy()
+        header["sec-websocket-protocol"] = "sUb1"
+        self.assertEqual(_validate_header(header, key, ["Sub1", "suB2"]), (True, "sub1"))
+
+        header = required_header.copy()
+        self.assertEqual(_validate_header(header, key, ["Sub1", "suB2"]), (False, None))
+
+    def testReadHeader(self):
+        status, header, status_message = read_headers(HeaderSockMock("data/header01.txt"))
+        self.assertEqual(status, 101)
+        self.assertEqual(header["connection"], "Upgrade")
+
+        status, header, status_message = read_headers(HeaderSockMock("data/header03.txt"))
+        self.assertEqual(status, 101)
+        self.assertEqual(header["connection"], "Upgrade, Keep-Alive")
+
+        HeaderSockMock("data/header02.txt")
+        self.assertRaises(ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt"))
+
+    def testSend(self):
+        # TODO: add longer frame data
+        sock = ws.WebSocket()
+        sock.set_mask_key(create_mask_key)
+        s = sock.sock = HeaderSockMock("data/header01.txt")
+        sock.send("Hello")
+        self.assertEqual(s.sent[0], six.b("\x81\x85abcd)\x07\x0f\x08\x0e"))
+
+        sock.send("こんにちは")
+        self.assertEqual(s.sent[1], six.b("\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc"))
+
+        sock.send(u"こんにちは")
+        self.assertEqual(s.sent[1], six.b("\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc"))
+
+#        sock.send("x" * 5000)
+#        self.assertEqual(s.sent[1], six.b("\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc"))
+
+        self.assertEqual(sock.send_binary(b'1111111111101'), 19)
+
+    def testRecv(self):
+        # TODO: add longer frame data
+        sock = ws.WebSocket()
+        s = sock.sock = SockMock()
+        something = six.b("\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc")
+        s.add_packet(something)
+        data = sock.recv()
+        self.assertEqual(data, "こんにちは")
+
+        s.add_packet(six.b("\x81\x85abcd)\x07\x0f\x08\x0e"))
+        data = sock.recv()
+        self.assertEqual(data, "Hello")
+
+    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    def testIter(self):
+        count = 2
+        for _ in ws.create_connection('wss://stream.meetup.com/2/rsvps'):
+            count -= 1
+            if count == 0:
+                break
+
+    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    def testNext(self):
+        sock = ws.create_connection('wss://stream.meetup.com/2/rsvps')
+        self.assertEqual(str, type(next(sock)))
+
+    def testInternalRecvStrict(self):
+        sock = ws.WebSocket()
+        s = sock.sock = SockMock()
+        s.add_packet(six.b("foo"))
+        s.add_packet(socket.timeout())
+        s.add_packet(six.b("bar"))
+        # s.add_packet(SSLError("The read operation timed out"))
+        s.add_packet(six.b("baz"))
+        with self.assertRaises(ws.WebSocketTimeoutException):
+            sock.frame_buffer.recv_strict(9)
+        # if six.PY2:
+        #     with self.assertRaises(ws.WebSocketTimeoutException):
+        #         data = sock._recv_strict(9)
+        # else:
+        #     with self.assertRaises(SSLError):
+        #         data = sock._recv_strict(9)
+        data = sock.frame_buffer.recv_strict(9)
+        self.assertEqual(data, six.b("foobarbaz"))
+        with self.assertRaises(ws.WebSocketConnectionClosedException):
+            sock.frame_buffer.recv_strict(1)
+
+    def testRecvTimeout(self):
+        sock = ws.WebSocket()
+        s = sock.sock = SockMock()
+        s.add_packet(six.b("\x81"))
+        s.add_packet(socket.timeout())
+        s.add_packet(six.b("\x8dabcd\x29\x07\x0f\x08\x0e"))
+        s.add_packet(socket.timeout())
+        s.add_packet(six.b("\x4e\x43\x33\x0e\x10\x0f\x00\x40"))
+        with self.assertRaises(ws.WebSocketTimeoutException):
+            sock.recv()
+        with self.assertRaises(ws.WebSocketTimeoutException):
+            sock.recv()
+        data = sock.recv()
+        self.assertEqual(data, "Hello, World!")
+        with self.assertRaises(ws.WebSocketConnectionClosedException):
+            sock.recv()
+
+    def testRecvWithSimpleFragmentation(self):
+        sock = ws.WebSocket()
+        s = sock.sock = SockMock()
+        # OPCODE=TEXT, FIN=0, MSG="Brevity is "
+        s.add_packet(six.b("\x01\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C"))
+        # OPCODE=CONT, FIN=1, MSG="the soul of wit"
+        s.add_packet(six.b("\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17"))
+        data = sock.recv()
+        self.assertEqual(data, "Brevity is the soul of wit")
+        with self.assertRaises(ws.WebSocketConnectionClosedException):
+            sock.recv()
+
+    def testRecvWithFireEventOfFragmentation(self):
+        sock = ws.WebSocket(fire_cont_frame=True)
+        s = sock.sock = SockMock()
+        # OPCODE=TEXT, FIN=0, MSG="Brevity is "
+        s.add_packet(six.b("\x01\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C"))
+        # OPCODE=CONT, FIN=0, MSG="Brevity is "
+        s.add_packet(six.b("\x00\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C"))
+        # OPCODE=CONT, FIN=1, MSG="the soul of wit"
+        s.add_packet(six.b("\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17"))
+
+        _, data = sock.recv_data()
+        self.assertEqual(data, six.b("Brevity is "))
+        _, data = sock.recv_data()
+        self.assertEqual(data, six.b("Brevity is "))
+        _, data = sock.recv_data()
+        self.assertEqual(data, six.b("the soul of wit"))
+
+        # OPCODE=CONT, FIN=0, MSG="Brevity is "
+        s.add_packet(six.b("\x80\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C"))
+
+        with self.assertRaises(ws.WebSocketException):
+            sock.recv_data()
+
+        with self.assertRaises(ws.WebSocketConnectionClosedException):
+            sock.recv()
+
+    def testClose(self):
+        sock = ws.WebSocket()
+        sock.sock = SockMock()
+        sock.connected = True
+        sock.close()
+        self.assertEqual(sock.connected, False)
+
+        sock = ws.WebSocket()
+        s = sock.sock = SockMock()
+        sock.connected = True
+        s.add_packet(six.b('\x88\x80\x17\x98p\x84'))
+        sock.recv()
+        self.assertEqual(sock.connected, False)
+
+    def testRecvContFragmentation(self):
+        sock = ws.WebSocket()
+        s = sock.sock = SockMock()
+        # OPCODE=CONT, FIN=1, MSG="the soul of wit"
+        s.add_packet(six.b("\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17"))
+        self.assertRaises(ws.WebSocketException, sock.recv)
+
+    def testRecvWithProlongedFragmentation(self):
+        sock = ws.WebSocket()
+        s = sock.sock = SockMock()
+        # OPCODE=TEXT, FIN=0, MSG="Once more unto the breach, "
+        s.add_packet(six.b("\x01\x9babcd.\x0c\x00\x01A\x0f\x0c\x16\x04B\x16\n\x15"
+                           "\rC\x10\t\x07C\x06\x13\x07\x02\x07\tNC"))
+        # OPCODE=CONT, FIN=0, MSG="dear friends, "
+        s.add_packet(six.b("\x00\x8eabcd\x05\x07\x02\x16A\x04\x11\r\x04\x0c\x07"
+                           "\x17MB"))
+        # OPCODE=CONT, FIN=1, MSG="once more"
+        s.add_packet(six.b("\x80\x89abcd\x0e\x0c\x00\x01A\x0f\x0c\x16\x04"))
+        data = sock.recv()
+        self.assertEqual(
+            data,
+            "Once more unto the breach, dear friends, once more")
+        with self.assertRaises(ws.WebSocketConnectionClosedException):
+            sock.recv()
+
+    def testRecvWithFragmentationAndControlFrame(self):
+        sock = ws.WebSocket()
+        sock.set_mask_key(create_mask_key)
+        s = sock.sock = SockMock()
+        # OPCODE=TEXT, FIN=0, MSG="Too much "
+        s.add_packet(six.b("\x01\x89abcd5\r\x0cD\x0c\x17\x00\x0cA"))
+        # OPCODE=PING, FIN=1, MSG="Please PONG this"
+        s.add_packet(six.b("\x89\x90abcd1\x0e\x06\x05\x12\x07C4.,$D\x15\n\n\x17"))
+        # OPCODE=CONT, FIN=1, MSG="of a good thing"
+        s.add_packet(six.b("\x80\x8fabcd\x0e\x04C\x05A\x05\x0c\x0b\x05B\x17\x0c"
+                           "\x08\x0c\x04"))
+        data = sock.recv()
+        self.assertEqual(data, "Too much of a good thing")
+        with self.assertRaises(ws.WebSocketConnectionClosedException):
+            sock.recv()
+        self.assertEqual(
+            s.sent[0],
+            six.b("\x8a\x90abcd1\x0e\x06\x05\x12\x07C4.,$D\x15\n\n\x17"))
+
+    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    def testWebSocket(self):
+        s = ws.create_connection("ws://echo.websocket.org/")
+        self.assertNotEqual(s, None)
+        s.send("Hello, World")
+        result = s.recv()
+        self.assertEqual(result, "Hello, World")
+
+        s.send(u"こにゃにゃちは、世界")
+        result = s.recv()
+        self.assertEqual(result, "こにゃにゃちは、世界")
+        self.assertRaises(ValueError, s.send_close, -1, "")
+        s.close()
+
+    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    def testPingPong(self):
+        s = ws.create_connection("ws://echo.websocket.org/")
+        self.assertNotEqual(s, None)
+        s.ping("Hello")
+        s.pong("Hi")
+        s.close()
+
+    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    def testSecureWebSocket(self):
+        import ssl
+        s = ws.create_connection("wss://api.bitfinex.com/ws/2")
+        self.assertNotEqual(s, None)
+        self.assertTrue(isinstance(s.sock, ssl.SSLSocket))
+        self.assertEqual(s.getstatus(), 101)
+        self.assertNotEqual(s.getheaders(), None)
+        s.close()
+
+    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    def testWebSocketWithCustomHeader(self):
+        s = ws.create_connection("ws://echo.websocket.org/",
+                                 headers={"User-Agent": "PythonWebsocketClient"})
+        self.assertNotEqual(s, None)
+        s.send("Hello, World")
+        result = s.recv()
+        self.assertEqual(result, "Hello, World")
+        self.assertRaises(ValueError, s.close, -1, "")
+        s.close()
+
+    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    def testAfterClose(self):
+        s = ws.create_connection("ws://echo.websocket.org/")
+        self.assertNotEqual(s, None)
+        s.close()
+        self.assertRaises(ws.WebSocketConnectionClosedException, s.send, "Hello")
+        self.assertRaises(ws.WebSocketConnectionClosedException, s.recv)
+
+
+class SockOptTest(unittest.TestCase):
+    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    def testSockOpt(self):
+        sockopt = ((socket.IPPROTO_TCP, socket.TCP_NODELAY, 1),)
+        s = ws.create_connection("ws://echo.websocket.org", sockopt=sockopt)
+        self.assertNotEqual(s.sock.getsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY), 0)
+        s.close()
+
+
+class UtilsTest(unittest.TestCase):
+    def testUtf8Validator(self):
+        state = validate_utf8(six.b('\xf0\x90\x80\x80'))
+        self.assertEqual(state, True)
+        state = validate_utf8(six.b('\xce\xba\xe1\xbd\xb9\xcf\x83\xce\xbc\xce\xb5\xed\xa0\x80edited'))
+        self.assertEqual(state, False)
+        state = validate_utf8(six.b(''))
+        self.assertEqual(state, True)
+
+
+if __name__ == "__main__":
+    unittest.main()

From 78c2c651c102601e00c9c042e1490a559bff12e8 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 16:17:38 +0200
Subject: [PATCH 0515/1227] update gazu version

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 362f6a62d8..63bd08d644 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -40,7 +40,7 @@ clique = "1.6.*"
 Click = "^7"
 dnspython = "^2.1.0"
 ftrack-python-api = "2.0.*"
-gazu = "^0.8"
+gazu = "^0.8.28"
 google-api-python-client = "^1.12.8" # sync server google support (should be separate?)
 jsonschema = "^2.6.0"
 keyring = "^22.0.1"

From ca6d77fff79edd8d7073b6b36ce17990ce22edc7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Wed, 8 Jun 2022 16:25:51 +0200
Subject: [PATCH 0516/1227] :art: modify camera extractor to allow more data

---
 .../plugins/publish/extract_camera_alembic.py | 17 +++++++++-----
 .../publish/extract_camera_mayaScene.py       | 22 ++++++++++++++-----
 2 files changed, 27 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py b/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
index 5ad6b79d5c..4110ad474d 100644
--- a/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
+++ b/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
@@ -34,7 +34,6 @@ class ExtractCameraAlembic(openpype.api.Extractor):
                           dag=True, type="camera")
 
         # validate required settings
-        assert len(cameras) == 1, "Not a single camera found in extraction"
         assert isinstance(step, float), "Step must be a float value"
         camera = cameras[0]
 
@@ -44,8 +43,12 @@ class ExtractCameraAlembic(openpype.api.Extractor):
         path = os.path.join(dir_path, filename)
 
         # Perform alembic extraction
+        member_shapes = cmds.ls(
+            members, leaf=True, shapes=True, long=True, dag=True)
         with lib.maintained_selection():
-            cmds.select(camera, replace=True, noExpand=True)
+            cmds.select(
+                member_shapes,
+                replace=True, noExpand=True)
 
             # Enforce forward slashes for AbcExport because we're
             # embedding it into a job string
@@ -57,10 +60,12 @@ class ExtractCameraAlembic(openpype.api.Extractor):
             job_str += ' -step {0} '.format(step)
 
             if bake_to_worldspace:
-                transform = cmds.listRelatives(camera,
-                                               parent=True,
-                                               fullPath=True)[0]
-                job_str += ' -worldSpace -root {0}'.format(transform)
+                job_str += ' -worldSpace'
+                for member in member_shapes:
+                    self.log.info(f"processing {member}")
+                    transform = cmds.listRelatives(
+                        member, parent=True, fullPath=True)[0]
+                    job_str += ' -root {0}'.format(transform)
 
             job_str += ' -file "{0}"'.format(path)
 
diff --git a/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py b/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
index 49c156f9cd..1cb30e65ea 100644
--- a/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
+++ b/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
@@ -131,12 +131,12 @@ class ExtractCameraMayaScene(openpype.api.Extractor):
                              "bake to world space is ignored...")
 
         # get cameras
-        members = instance.data['setMembers']
+        members = cmds.ls(instance.data['setMembers'], leaf=True, shapes=True,
+                          long=True, dag=True)
         cameras = cmds.ls(members, leaf=True, shapes=True, long=True,
                           dag=True, type="camera")
 
         # validate required settings
-        assert len(cameras) == 1, "Single camera must be found in extraction"
         assert isinstance(step, float), "Step must be a float value"
         camera = cameras[0]
         transform = cmds.listRelatives(camera, parent=True, fullPath=True)
@@ -158,15 +158,24 @@ class ExtractCameraMayaScene(openpype.api.Extractor):
                             frame_range=[start, end],
                             step=step
                         )
-                        baked_shapes = cmds.ls(baked,
+                        baked_camera_shapes = cmds.ls(baked,
                                                type="camera",
                                                dag=True,
                                                shapes=True,
                                                long=True)
+
+                        members = members + baked_camera_shapes
+                        members.remove(camera)
                     else:
-                        baked_shapes = cameras
+                        baked_camera_shapes = cmds.ls(cameras,
+                                                      type="camera",
+                                                      dag=True,
+                                                      shapes=True,
+                                                      long=True)
                     # Fix PLN-178: Don't allow background color to be non-black
-                    for cam in baked_shapes:
+                    for cam in cmds.ls(
+                            baked_camera_shapes, type="camera", dag=True,
+                            shapes=True, long=True):
                         attrs = {"backgroundColorR": 0.0,
                                  "backgroundColorG": 0.0,
                                  "backgroundColorB": 0.0,
@@ -177,7 +186,8 @@ class ExtractCameraMayaScene(openpype.api.Extractor):
                             cmds.setAttr(plug, value)
 
                     self.log.info("Performing extraction..")
-                    cmds.select(baked_shapes, noExpand=True)
+                    cmds.select(cmds.ls(members, dag=True,
+                                        shapes=True, long=True), noExpand=True)
                     cmds.file(path,
                               force=True,
                               typ="mayaAscii" if self.scene_type == "ma" else "mayaBinary",  # noqa: E501

From f10caed2cdc4830c4a40c0246c7d37b45f368ba6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 16:56:01 +0200
Subject: [PATCH 0517/1227] added certifi to python 2 vendor

---
 .../python/python_2/certifi/__init__.py       |    3 +
 .../python/python_2/certifi/__main__.py       |   12 +
 .../vendor/python/python_2/certifi/cacert.pem | 4362 +++++++++++++++++
 .../vendor/python/python_2/certifi/core.py    |   60 +
 4 files changed, 4437 insertions(+)
 create mode 100644 openpype/vendor/python/python_2/certifi/__init__.py
 create mode 100644 openpype/vendor/python/python_2/certifi/__main__.py
 create mode 100644 openpype/vendor/python/python_2/certifi/cacert.pem
 create mode 100644 openpype/vendor/python/python_2/certifi/core.py

diff --git a/openpype/vendor/python/python_2/certifi/__init__.py b/openpype/vendor/python/python_2/certifi/__init__.py
new file mode 100644
index 0000000000..8db1a0e554
--- /dev/null
+++ b/openpype/vendor/python/python_2/certifi/__init__.py
@@ -0,0 +1,3 @@
+from .core import contents, where
+
+__version__ = "2021.10.08"
diff --git a/openpype/vendor/python/python_2/certifi/__main__.py b/openpype/vendor/python/python_2/certifi/__main__.py
new file mode 100644
index 0000000000..8945b5da85
--- /dev/null
+++ b/openpype/vendor/python/python_2/certifi/__main__.py
@@ -0,0 +1,12 @@
+import argparse
+
+from certifi import contents, where
+
+parser = argparse.ArgumentParser()
+parser.add_argument("-c", "--contents", action="store_true")
+args = parser.parse_args()
+
+if args.contents:
+    print(contents())
+else:
+    print(where())
diff --git a/openpype/vendor/python/python_2/certifi/cacert.pem b/openpype/vendor/python/python_2/certifi/cacert.pem
new file mode 100644
index 0000000000..6d0ccc0d1c
--- /dev/null
+++ b/openpype/vendor/python/python_2/certifi/cacert.pem
@@ -0,0 +1,4362 @@
+
+# Issuer: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA
+# Subject: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA
+# Label: "GlobalSign Root CA"
+# Serial: 4835703278459707669005204
+# MD5 Fingerprint: 3e:45:52:15:09:51:92:e1:b7:5d:37:9f:b1:87:29:8a
+# SHA1 Fingerprint: b1:bc:96:8b:d4:f4:9d:62:2a:a8:9a:81:f2:15:01:52:a4:1d:82:9c
+# SHA256 Fingerprint: eb:d4:10:40:e4:bb:3e:c7:42:c9:e3:81:d3:1e:f2:a4:1a:48:b6:68:5c:96:e7:ce:f3:c1:df:6c:d4:33:1c:99
+-----BEGIN CERTIFICATE-----
+MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkG
+A1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jv
+b3QgQ0ExGzAZBgNVBAMTEkdsb2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAw
+MDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9i
+YWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJHbG9iYWxT
+aWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDaDuaZ
+jc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavp
+xy0Sy6scTHAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp
+1Wrjsok6Vjk4bwY8iGlbKk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdG
+snUOhugZitVtbNV4FpWi6cgKOOvyJBNPc1STE4U6G7weNLWLBYy5d4ux2x8gkasJ
+U26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrXgzT/LCrBbBlDSgeF59N8
+9iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8E
+BTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0B
+AQUFAAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOz
+yj1hTdNGCbM+w6DjY1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE
+38NflNUVyRRBnMRddWQVDf9VMOyGj/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymP
+AbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhHhm4qxFYxldBniYUr+WymXUad
+DKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveCX4XSQRjbgbME
+HMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A==
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R2
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R2
+# Label: "GlobalSign Root CA - R2"
+# Serial: 4835703278459682885658125
+# MD5 Fingerprint: 94:14:77:7e:3e:5e:fd:8f:30:bd:41:b0:cf:e7:d0:30
+# SHA1 Fingerprint: 75:e0:ab:b6:13:85:12:27:1c:04:f8:5f:dd:de:38:e4:b7:24:2e:fe
+# SHA256 Fingerprint: ca:42:dd:41:74:5f:d0:b8:1e:b9:02:36:2c:f9:d8:bf:71:9d:a1:bd:1b:1e:fc:94:6f:5b:4c:99:f4:2c:1b:9e
+-----BEGIN CERTIFICATE-----
+MIIDujCCAqKgAwIBAgILBAAAAAABD4Ym5g0wDQYJKoZIhvcNAQEFBQAwTDEgMB4G
+A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjIxEzARBgNVBAoTCkdsb2JhbFNp
+Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDYxMjE1MDgwMDAwWhcNMjExMjE1
+MDgwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMjETMBEG
+A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBAKbPJA6+Lm8omUVCxKs+IVSbC9N/hHD6ErPL
+v4dfxn+G07IwXNb9rfF73OX4YJYJkhD10FPe+3t+c4isUoh7SqbKSaZeqKeMWhG8
+eoLrvozps6yWJQeXSpkqBy+0Hne/ig+1AnwblrjFuTosvNYSuetZfeLQBoZfXklq
+tTleiDTsvHgMCJiEbKjNS7SgfQx5TfC4LcshytVsW33hoCmEofnTlEnLJGKRILzd
+C9XZzPnqJworc5HGnRusyMvo4KD0L5CLTfuwNhv2GXqF4G3yYROIXJ/gkwpRl4pa
+zq+r1feqCapgvdzZX99yqWATXgAByUr6P6TqBwMhAo6CygPCm48CAwEAAaOBnDCB
+mTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUm+IH
+V2ccHsBqBt5ZtJot39wZhi4wNgYDVR0fBC8wLTAroCmgJ4YlaHR0cDovL2NybC5n
+bG9iYWxzaWduLm5ldC9yb290LXIyLmNybDAfBgNVHSMEGDAWgBSb4gdXZxwewGoG
+3lm0mi3f3BmGLjANBgkqhkiG9w0BAQUFAAOCAQEAmYFThxxol4aR7OBKuEQLq4Gs
+J0/WwbgcQ3izDJr86iw8bmEbTUsp9Z8FHSbBuOmDAGJFtqkIk7mpM0sYmsL4h4hO
+291xNBrBVNpGP+DTKqttVCL1OmLNIG+6KYnX3ZHu01yiPqFbQfXf5WRDLenVOavS
+ot+3i9DAgBkcRcAtjOj4LaR0VknFBbVPFd5uRHg5h6h+u/N5GJG79G+dwfCMNYxd
+AfvDbbnvRG15RjF+Cv6pgsH/76tuIMRQyV+dTZsXjAzlAcmgQWpzU/qlULRuJQ/7
+TBj0/VLZjmmx6BEP3ojY+x1J96relc8geMJgEtslQIxq/H5COEBkEveegeGTLg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
+# Subject: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
+# Label: "Entrust.net Premium 2048 Secure Server CA"
+# Serial: 946069240
+# MD5 Fingerprint: ee:29:31:bc:32:7e:9a:e6:e8:b5:f7:51:b4:34:71:90
+# SHA1 Fingerprint: 50:30:06:09:1d:97:d4:f5:ae:39:f7:cb:e7:92:7d:7d:65:2d:34:31
+# SHA256 Fingerprint: 6d:c4:71:72:e0:1c:bc:b0:bf:62:58:0d:89:5f:e2:b8:ac:9a:d4:f8:73:80:1e:0c:10:b9:c8:37:d2:1e:b1:77
+-----BEGIN CERTIFICATE-----
+MIIEKjCCAxKgAwIBAgIEOGPe+DANBgkqhkiG9w0BAQUFADCBtDEUMBIGA1UEChML
+RW50cnVzdC5uZXQxQDA+BgNVBAsUN3d3dy5lbnRydXN0Lm5ldC9DUFNfMjA0OCBp
+bmNvcnAuIGJ5IHJlZi4gKGxpbWl0cyBsaWFiLikxJTAjBgNVBAsTHChjKSAxOTk5
+IEVudHJ1c3QubmV0IExpbWl0ZWQxMzAxBgNVBAMTKkVudHJ1c3QubmV0IENlcnRp
+ZmljYXRpb24gQXV0aG9yaXR5ICgyMDQ4KTAeFw05OTEyMjQxNzUwNTFaFw0yOTA3
+MjQxNDE1MTJaMIG0MRQwEgYDVQQKEwtFbnRydXN0Lm5ldDFAMD4GA1UECxQ3d3d3
+LmVudHJ1c3QubmV0L0NQU18yMDQ4IGluY29ycC4gYnkgcmVmLiAobGltaXRzIGxp
+YWIuKTElMCMGA1UECxMcKGMpIDE5OTkgRW50cnVzdC5uZXQgTGltaXRlZDEzMDEG
+A1UEAxMqRW50cnVzdC5uZXQgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgKDIwNDgp
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArU1LqRKGsuqjIAcVFmQq
+K0vRvwtKTY7tgHalZ7d4QMBzQshowNtTK91euHaYNZOLGp18EzoOH1u3Hs/lJBQe
+sYGpjX24zGtLA/ECDNyrpUAkAH90lKGdCCmziAv1h3edVc3kw37XamSrhRSGlVuX
+MlBvPci6Zgzj/L24ScF2iUkZ/cCovYmjZy/Gn7xxGWC4LeksyZB2ZnuU4q941mVT
+XTzWnLLPKQP5L6RQstRIzgUyVYr9smRMDuSYB3Xbf9+5CFVghTAp+XtIpGmG4zU/
+HoZdenoVve8AjhUiVBcAkCaTvA5JaJG/+EfTnZVCwQ5N328mz8MYIWJmQ3DW1cAH
+4QIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
+HQ4EFgQUVeSB0RGAvtiJuQijMfmhJAkWuXAwDQYJKoZIhvcNAQEFBQADggEBADub
+j1abMOdTmXx6eadNl9cZlZD7Bh/KM3xGY4+WZiT6QBshJ8rmcnPyT/4xmf3IDExo
+U8aAghOY+rat2l098c5u9hURlIIM7j+VrxGrD9cv3h8Dj1csHsm7mhpElesYT6Yf
+zX1XEC+bBAlahLVu2B064dae0Wx5XnkcFMXj0EyTO2U87d89vqbllRrDtRnDvV5b
+u/8j72gZyxKTJ1wDLW8w0B62GqzeWvfRqqgnpv55gcR5mTNXuhKwqeBCbJPKVt7+
+bYQLCIt+jerXmCHG8+c8eS9enNFMFY3h7CI3zJpDC5fcgJCNs2ebb0gIFVbPv/Er
+fF6adulZkMV8gzURZVE=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust
+# Subject: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust
+# Label: "Baltimore CyberTrust Root"
+# Serial: 33554617
+# MD5 Fingerprint: ac:b6:94:a5:9c:17:e0:d7:91:52:9b:b1:97:06:a6:e4
+# SHA1 Fingerprint: d4:de:20:d0:5e:66:fc:53:fe:1a:50:88:2c:78:db:28:52:ca:e4:74
+# SHA256 Fingerprint: 16:af:57:a9:f6:76:b0:ab:12:60:95:aa:5e:ba:de:f2:2a:b3:11:19:d6:44:ac:95:cd:4b:93:db:f3:f2:6a:eb
+-----BEGIN CERTIFICATE-----
+MIIDdzCCAl+gAwIBAgIEAgAAuTANBgkqhkiG9w0BAQUFADBaMQswCQYDVQQGEwJJ
+RTESMBAGA1UEChMJQmFsdGltb3JlMRMwEQYDVQQLEwpDeWJlclRydXN0MSIwIAYD
+VQQDExlCYWx0aW1vcmUgQ3liZXJUcnVzdCBSb290MB4XDTAwMDUxMjE4NDYwMFoX
+DTI1MDUxMjIzNTkwMFowWjELMAkGA1UEBhMCSUUxEjAQBgNVBAoTCUJhbHRpbW9y
+ZTETMBEGA1UECxMKQ3liZXJUcnVzdDEiMCAGA1UEAxMZQmFsdGltb3JlIEN5YmVy
+VHJ1c3QgUm9vdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKMEuyKr
+mD1X6CZymrV51Cni4eiVgLGw41uOKymaZN+hXe2wCQVt2yguzmKiYv60iNoS6zjr
+IZ3AQSsBUnuId9Mcj8e6uYi1agnnc+gRQKfRzMpijS3ljwumUNKoUMMo6vWrJYeK
+mpYcqWe4PwzV9/lSEy/CG9VwcPCPwBLKBsua4dnKM3p31vjsufFoREJIE9LAwqSu
+XmD+tqYF/LTdB1kC1FkYmGP1pWPgkAx9XbIGevOF6uvUA65ehD5f/xXtabz5OTZy
+dc93Uk3zyZAsuT3lySNTPx8kmCFcB5kpvcY67Oduhjprl3RjM71oGDHweI12v/ye
+jl0qhqdNkNwnGjkCAwEAAaNFMEMwHQYDVR0OBBYEFOWdWTCCR1jMrPoIVDaGezq1
+BE3wMBIGA1UdEwEB/wQIMAYBAf8CAQMwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3
+DQEBBQUAA4IBAQCFDF2O5G9RaEIFoN27TyclhAO992T9Ldcw46QQF+vaKSm2eT92
+9hkTI7gQCvlYpNRhcL0EYWoSihfVCr3FvDB81ukMJY2GQE/szKN+OMY3EU/t3Wgx
+jkzSswF07r51XgdIGn9w/xZchMB5hbgF/X++ZRGjD8ACtPhSNzkE1akxehi/oCr0
+Epn3o0WC4zxe9Z2etciefC7IpJ5OCBRLbf1wbWsaY71k5h+3zvDyny67G7fyUIhz
+ksLi4xaNmjICq44Y3ekQEe5+NauQrz4wlHrQMz2nZQ/1/I6eYs9HRCwBXbsdtTLS
+R9I4LtD+gdwyah617jzV/OeBHRnDJELqYzmp
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc.
+# Subject: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc.
+# Label: "Entrust Root Certification Authority"
+# Serial: 1164660820
+# MD5 Fingerprint: d6:a5:c3:ed:5d:dd:3e:00:c1:3d:87:92:1f:1d:3f:e4
+# SHA1 Fingerprint: b3:1e:b1:b7:40:e3:6c:84:02:da:dc:37:d4:4d:f5:d4:67:49:52:f9
+# SHA256 Fingerprint: 73:c1:76:43:4f:1b:c6:d5:ad:f4:5b:0e:76:e7:27:28:7c:8d:e5:76:16:c1:e6:e6:14:1a:2b:2c:bc:7d:8e:4c
+-----BEGIN CERTIFICATE-----
+MIIEkTCCA3mgAwIBAgIERWtQVDANBgkqhkiG9w0BAQUFADCBsDELMAkGA1UEBhMC
+VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xOTA3BgNVBAsTMHd3dy5lbnRydXN0
+Lm5ldC9DUFMgaXMgaW5jb3Jwb3JhdGVkIGJ5IHJlZmVyZW5jZTEfMB0GA1UECxMW
+KGMpIDIwMDYgRW50cnVzdCwgSW5jLjEtMCsGA1UEAxMkRW50cnVzdCBSb290IENl
+cnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA2MTEyNzIwMjM0MloXDTI2MTEyNzIw
+NTM0MlowgbAxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMTkw
+NwYDVQQLEzB3d3cuZW50cnVzdC5uZXQvQ1BTIGlzIGluY29ycG9yYXRlZCBieSBy
+ZWZlcmVuY2UxHzAdBgNVBAsTFihjKSAyMDA2IEVudHJ1c3QsIEluYy4xLTArBgNV
+BAMTJEVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASIwDQYJ
+KoZIhvcNAQEBBQADggEPADCCAQoCggEBALaVtkNC+sZtKm9I35RMOVcF7sN5EUFo
+Nu3s/poBj6E4KPz3EEZmLk0eGrEaTsbRwJWIsMn/MYszA9u3g3s+IIRe7bJWKKf4
+4LlAcTfFy0cOlypowCKVYhXbR9n10Cv/gkvJrT7eTNuQgFA/CYqEAOwwCj0Yzfv9
+KlmaI5UXLEWeH25DeW0MXJj+SKfFI0dcXv1u5x609mhF0YaDW6KKjbHjKYD+JXGI
+rb68j6xSlkuqUY3kEzEZ6E5Nn9uss2rVvDlUccp6en+Q3X0dgNmBu1kmwhH+5pPi
+94DkZfs0Nw4pgHBNrziGLp5/V6+eF67rHMsoIV+2HNjnogQi+dPa2MsCAwEAAaOB
+sDCBrTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zArBgNVHRAEJDAi
+gA8yMDA2MTEyNzIwMjM0MlqBDzIwMjYxMTI3MjA1MzQyWjAfBgNVHSMEGDAWgBRo
+kORnpKZTgMeGZqTx90tD+4S9bTAdBgNVHQ4EFgQUaJDkZ6SmU4DHhmak8fdLQ/uE
+vW0wHQYJKoZIhvZ9B0EABBAwDhsIVjcuMTo0LjADAgSQMA0GCSqGSIb3DQEBBQUA
+A4IBAQCT1DCw1wMgKtD5Y+iRDAUgqV8ZyntyTtSx29CW+1RaGSwMCPeyvIWonX9t
+O1KzKtvn1ISMY/YPyyYBkVBs9F8U4pN0wBOeMDpQ47RgxRzwIkSNcUesyBrJ6Zua
+AGAT/3B+XxFNSRuzFVJ7yVTav52Vr2ua2J7p8eRDjeIRRDq/r72DQnNSi6q7pynP
+9WQcCk3RvKqsnyrQ/39/2n3qse0wJcGE2jTSW3iDVuycNsMm4hH2Z0kdkquM++v/
+eu6FSqdQgPCnXEqULl8FmTxSQeDNtGPPAUO6nIPcj2A781q0tHuu2guQOHXvgR1m
+0vdXcDazv/wor3ElhVsT/h5/WrQ8
+-----END CERTIFICATE-----
+
+# Issuer: CN=AAA Certificate Services O=Comodo CA Limited
+# Subject: CN=AAA Certificate Services O=Comodo CA Limited
+# Label: "Comodo AAA Services root"
+# Serial: 1
+# MD5 Fingerprint: 49:79:04:b0:eb:87:19:ac:47:b0:bc:11:51:9b:74:d0
+# SHA1 Fingerprint: d1:eb:23:a4:6d:17:d6:8f:d9:25:64:c2:f1:f1:60:17:64:d8:e3:49
+# SHA256 Fingerprint: d7:a7:a0:fb:5d:7e:27:31:d7:71:e9:48:4e:bc:de:f7:1d:5f:0c:3e:0a:29:48:78:2b:c8:3e:e0:ea:69:9e:f4
+-----BEGIN CERTIFICATE-----
+MIIEMjCCAxqgAwIBAgIBATANBgkqhkiG9w0BAQUFADB7MQswCQYDVQQGEwJHQjEb
+MBkGA1UECAwSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHDAdTYWxmb3JkMRow
+GAYDVQQKDBFDb21vZG8gQ0EgTGltaXRlZDEhMB8GA1UEAwwYQUFBIENlcnRpZmlj
+YXRlIFNlcnZpY2VzMB4XDTA0MDEwMTAwMDAwMFoXDTI4MTIzMTIzNTk1OVowezEL
+MAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE
+BwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNVBAMM
+GEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczCCASIwDQYJKoZIhvcNAQEBBQADggEP
+ADCCAQoCggEBAL5AnfRu4ep2hxxNRUSOvkbIgwadwSr+GB+O5AL686tdUIoWMQua
+BtDFcCLNSS1UY8y2bmhGC1Pqy0wkwLxyTurxFa70VJoSCsN6sjNg4tqJVfMiWPPe
+3M/vg4aijJRPn2jymJBGhCfHdr/jzDUsi14HZGWCwEiwqJH5YZ92IFCokcdmtet4
+YgNW8IoaE+oxox6gmf049vYnMlhvB/VruPsUK6+3qszWY19zjNoFmag4qMsXeDZR
+rOme9Hg6jc8P2ULimAyrL58OAd7vn5lJ8S3frHRNG5i1R8XlKdH5kBjHYpy+g8cm
+ez6KJcfA3Z3mNWgQIJ2P2N7Sw4ScDV7oL8kCAwEAAaOBwDCBvTAdBgNVHQ4EFgQU
+oBEKIz6W8Qfs4q8p74Klf9AwpLQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQF
+MAMBAf8wewYDVR0fBHQwcjA4oDagNIYyaHR0cDovL2NybC5jb21vZG9jYS5jb20v
+QUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNqA0oDKGMGh0dHA6Ly9jcmwuY29t
+b2RvLm5ldC9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2VzLmNybDANBgkqhkiG9w0BAQUF
+AAOCAQEACFb8AvCb6P+k+tZ7xkSAzk/ExfYAWMymtrwUSWgEdujm7l3sAg9g1o1Q
+GE8mTgHj5rCl7r+8dFRBv/38ErjHT1r0iWAFf2C3BUrz9vHCv8S5dIa2LX1rzNLz
+Rt0vxuBqw8M0Ayx9lt1awg6nCpnBBYurDC/zXDrPbDdVCYfeU0BsWO/8tqtlbgT2
+G9w84FoVxp7Z8VlIMCFlA2zs6SFz7JsDoeA3raAVGI/6ugLOpyypEBMs1OUIJqsi
+l2D4kF501KKaU73yqWjgom7C12yxow+ev+to51byrvLjKzg6CYG1a4XXvi3tPxq3
+smPi9WIsgtRqAEFQ8TmDn5XpNpaYbg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 2 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 2 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 2"
+# Serial: 1289
+# MD5 Fingerprint: 5e:39:7b:dd:f8:ba:ec:82:e9:ac:62:ba:0c:54:00:2b
+# SHA1 Fingerprint: ca:3a:fb:cf:12:40:36:4b:44:b2:16:20:88:80:48:39:19:93:7c:f7
+# SHA256 Fingerprint: 85:a0:dd:7d:d7:20:ad:b7:ff:05:f8:3d:54:2b:20:9d:c7:ff:45:28:f7:d6:77:b1:83:89:fe:a5:e5:c4:9e:86
+-----BEGIN CERTIFICATE-----
+MIIFtzCCA5+gAwIBAgICBQkwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x
+GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv
+b3QgQ0EgMjAeFw0wNjExMjQxODI3MDBaFw0zMTExMjQxODIzMzNaMEUxCzAJBgNV
+BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W
+YWRpcyBSb290IENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCa
+GMpLlA0ALa8DKYrwD4HIrkwZhR0In6spRIXzL4GtMh6QRr+jhiYaHv5+HBg6XJxg
+Fyo6dIMzMH1hVBHL7avg5tKifvVrbxi3Cgst/ek+7wrGsxDp3MJGF/hd/aTa/55J
+WpzmM+Yklvc/ulsrHHo1wtZn/qtmUIttKGAr79dgw8eTvI02kfN/+NsRE8Scd3bB
+rrcCaoF6qUWD4gXmuVbBlDePSHFjIuwXZQeVikvfj8ZaCuWw419eaxGrDPmF60Tp
++ARz8un+XJiM9XOva7R+zdRcAitMOeGylZUtQofX1bOQQ7dsE/He3fbE+Ik/0XX1
+ksOR1YqI0JDs3G3eicJlcZaLDQP9nL9bFqyS2+r+eXyt66/3FsvbzSUr5R/7mp/i
+Ucw6UwxI5g69ybR2BlLmEROFcmMDBOAENisgGQLodKcftslWZvB1JdxnwQ5hYIiz
+PtGo/KPaHbDRsSNU30R2be1B2MGyIrZTHN81Hdyhdyox5C315eXbyOD/5YDXC2Og
+/zOhD7osFRXql7PSorW+8oyWHhqPHWykYTe5hnMz15eWniN9gqRMgeKh0bpnX5UH
+oycR7hYQe7xFSkyyBNKr79X9DFHOUGoIMfmR2gyPZFwDwzqLID9ujWc9Otb+fVuI
+yV77zGHcizN300QyNQliBJIWENieJ0f7OyHj+OsdWwIDAQABo4GwMIGtMA8GA1Ud
+EwEB/wQFMAMBAf8wCwYDVR0PBAQDAgEGMB0GA1UdDgQWBBQahGK8SEwzJQTU7tD2
+A8QZRtGUazBuBgNVHSMEZzBlgBQahGK8SEwzJQTU7tD2A8QZRtGUa6FJpEcwRTEL
+MAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMT
+ElF1b1ZhZGlzIFJvb3QgQ0EgMoICBQkwDQYJKoZIhvcNAQEFBQADggIBAD4KFk2f
+BluornFdLwUvZ+YTRYPENvbzwCYMDbVHZF34tHLJRqUDGCdViXh9duqWNIAXINzn
+g/iN/Ae42l9NLmeyhP3ZRPx3UIHmfLTJDQtyU/h2BwdBR5YM++CCJpNVjP4iH2Bl
+fF/nJrP3MpCYUNQ3cVX2kiF495V5+vgtJodmVjB3pjd4M1IQWK4/YY7yarHvGH5K
+WWPKjaJW1acvvFYfzznB4vsKqBUsfU16Y8Zsl0Q80m/DShcK+JDSV6IZUaUtl0Ha
+B0+pUNqQjZRG4T7wlP0QADj1O+hA4bRuVhogzG9Yje0uRY/W6ZM/57Es3zrWIozc
+hLsib9D45MY56QSIPMO661V6bYCZJPVsAfv4l7CUW+v90m/xd2gNNWQjrLhVoQPR
+TUIZ3Ph1WVaj+ahJefivDrkRoHy3au000LYmYjgahwz46P0u05B/B5EqHdZ+XIWD
+mbA4CD/pXvk1B+TJYm5Xf6dQlfe6yJvmjqIBxdZmv3lh8zwc4bmCXF2gw+nYSL0Z
+ohEUGW6yhhtoPkg3Goi3XZZenMfvJ2II4pEZXNLxId26F0KCl3GBUzGpn/Z9Yr9y
+4aOTHcyKJloJONDO1w2AFrR4pTqHTI2KpdVGl/IsELm8VCLAAVBpQ570su9t+Oza
+8eOx79+Rj1QqCyXBJhnEUhAFZdWCEOrCMc0u
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 3"
+# Serial: 1478
+# MD5 Fingerprint: 31:85:3c:62:94:97:63:b9:aa:fd:89:4e:af:6f:e0:cf
+# SHA1 Fingerprint: 1f:49:14:f7:d8:74:95:1d:dd:ae:02:c0:be:fd:3a:2d:82:75:51:85
+# SHA256 Fingerprint: 18:f1:fc:7f:20:5d:f8:ad:dd:eb:7f:e0:07:dd:57:e3:af:37:5a:9c:4d:8d:73:54:6b:f4:f1:fe:d1:e1:8d:35
+-----BEGIN CERTIFICATE-----
+MIIGnTCCBIWgAwIBAgICBcYwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x
+GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv
+b3QgQ0EgMzAeFw0wNjExMjQxOTExMjNaFw0zMTExMjQxOTA2NDRaMEUxCzAJBgNV
+BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W
+YWRpcyBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDM
+V0IWVJzmmNPTTe7+7cefQzlKZbPoFog02w1ZkXTPkrgEQK0CSzGrvI2RaNggDhoB
+4hp7Thdd4oq3P5kazethq8Jlph+3t723j/z9cI8LoGe+AaJZz3HmDyl2/7FWeUUr
+H556VOijKTVopAFPD6QuN+8bv+OPEKhyq1hX51SGyMnzW9os2l2ObjyjPtr7guXd
+8lyyBTNvijbO0BNO/79KDDRMpsMhvVAEVeuxu537RR5kFd5VAYwCdrXLoT9Cabwv
+vWhDFlaJKjdhkf2mrk7AyxRllDdLkgbvBNDInIjbC3uBr7E9KsRlOni27tyAsdLT
+mZw67mtaa7ONt9XOnMK+pUsvFrGeaDsGb659n/je7Mwpp5ijJUMv7/FfJuGITfhe
+btfZFG4ZM2mnO4SJk8RTVROhUXhA+LjJou57ulJCg54U7QVSWllWp5f8nT8KKdjc
+T5EOE7zelaTfi5m+rJsziO+1ga8bxiJTyPbH7pcUsMV8eFLI8M5ud2CEpukqdiDt
+WAEXMJPpGovgc2PZapKUSU60rUqFxKMiMPwJ7Wgic6aIDFUhWMXhOp8q3crhkODZ
+c6tsgLjoC2SToJyMGf+z0gzskSaHirOi4XCPLArlzW1oUevaPwV/izLmE1xr/l9A
+4iLItLRkT9a6fUg+qGkM17uGcclzuD87nSVL2v9A6wIDAQABo4IBlTCCAZEwDwYD
+VR0TAQH/BAUwAwEB/zCB4QYDVR0gBIHZMIHWMIHTBgkrBgEEAb5YAAMwgcUwgZMG
+CCsGAQUFBwICMIGGGoGDQW55IHVzZSBvZiB0aGlzIENlcnRpZmljYXRlIGNvbnN0
+aXR1dGVzIGFjY2VwdGFuY2Ugb2YgdGhlIFF1b1ZhZGlzIFJvb3QgQ0EgMyBDZXJ0
+aWZpY2F0ZSBQb2xpY3kgLyBDZXJ0aWZpY2F0aW9uIFByYWN0aWNlIFN0YXRlbWVu
+dC4wLQYIKwYBBQUHAgEWIWh0dHA6Ly93d3cucXVvdmFkaXNnbG9iYWwuY29tL2Nw
+czALBgNVHQ8EBAMCAQYwHQYDVR0OBBYEFPLAE+CCQz777i9nMpY1XNu4ywLQMG4G
+A1UdIwRnMGWAFPLAE+CCQz777i9nMpY1XNu4ywLQoUmkRzBFMQswCQYDVQQGEwJC
+TTEZMBcGA1UEChMQUXVvVmFkaXMgTGltaXRlZDEbMBkGA1UEAxMSUXVvVmFkaXMg
+Um9vdCBDQSAzggIFxjANBgkqhkiG9w0BAQUFAAOCAgEAT62gLEz6wPJv92ZVqyM0
+7ucp2sNbtrCD2dDQ4iH782CnO11gUyeim/YIIirnv6By5ZwkajGxkHon24QRiSem
+d1o417+shvzuXYO8BsbRd2sPbSQvS3pspweWyuOEn62Iix2rFo1bZhfZFvSLgNLd
++LJ2w/w4E6oM3kJpK27zPOuAJ9v1pkQNn1pVWQvVDVJIxa6f8i+AxeoyUDUSly7B
+4f/xI4hROJ/yZlZ25w9Rl6VSDE1JUZU2Pb+iSwwQHYaZTKrzchGT5Or2m9qoXadN
+t54CrnMAyNojA+j56hl0YgCUyyIgvpSnWbWCar6ZeXqp8kokUvd0/bpO5qgdAm6x
+DYBEwa7TIzdfu4V8K5Iu6H6li92Z4b8nby1dqnuH/grdS/yO9SbkbnBCbjPsMZ57
+k8HkyWkaPcBrTiJt7qtYTcbQQcEr6k8Sh17rRdhs9ZgC06DYVYoGmRmioHfRMJ6s
+zHXug/WwYjnPbFfiTNKRCw51KBuav/0aQ/HKd/s7j2G4aSgWQgRecCocIdiP4b0j
+Wy10QJLZYxkNc91pvGJHvOB0K7Lrfb5BG7XARsWhIstfTsEokt4YutUqKLsRixeT
+mJlglFwjz1onl14LBQaTNx47aTbrqZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK
+4SVhM7JZG+Ju1zdXtg2pEto=
+-----END CERTIFICATE-----
+
+# Issuer: O=SECOM Trust.net OU=Security Communication RootCA1
+# Subject: O=SECOM Trust.net OU=Security Communication RootCA1
+# Label: "Security Communication Root CA"
+# Serial: 0
+# MD5 Fingerprint: f1:bc:63:6a:54:e0:b5:27:f5:cd:e7:1a:e3:4d:6e:4a
+# SHA1 Fingerprint: 36:b1:2b:49:f9:81:9e:d7:4c:9e:bc:38:0f:c6:56:8f:5d:ac:b2:f7
+# SHA256 Fingerprint: e7:5e:72:ed:9f:56:0e:ec:6e:b4:80:00:73:a4:3f:c3:ad:19:19:5a:39:22:82:01:78:95:97:4a:99:02:6b:6c
+-----BEGIN CERTIFICATE-----
+MIIDWjCCAkKgAwIBAgIBADANBgkqhkiG9w0BAQUFADBQMQswCQYDVQQGEwJKUDEY
+MBYGA1UEChMPU0VDT00gVHJ1c3QubmV0MScwJQYDVQQLEx5TZWN1cml0eSBDb21t
+dW5pY2F0aW9uIFJvb3RDQTEwHhcNMDMwOTMwMDQyMDQ5WhcNMjMwOTMwMDQyMDQ5
+WjBQMQswCQYDVQQGEwJKUDEYMBYGA1UEChMPU0VDT00gVHJ1c3QubmV0MScwJQYD
+VQQLEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTEwggEiMA0GCSqGSIb3
+DQEBAQUAA4IBDwAwggEKAoIBAQCzs/5/022x7xZ8V6UMbXaKL0u/ZPtM7orw8yl8
+9f/uKuDp6bpbZCKamm8sOiZpUQWZJtzVHGpxxpp9Hp3dfGzGjGdnSj74cbAZJ6kJ
+DKaVv0uMDPpVmDvY6CKhS3E4eayXkmmziX7qIWgGmBSWh9JhNrxtJ1aeV+7AwFb9
+Ms+k2Y7CI9eNqPPYJayX5HA49LY6tJ07lyZDo6G8SVlyTCMwhwFY9k6+HGhWZq/N
+QV3Is00qVUarH9oe4kA92819uZKAnDfdDJZkndwi92SL32HeFZRSFaB9UslLqCHJ
+xrHty8OVYNEP8Ktw+N/LTX7s1vqr2b1/VPKl6Xn62dZ2JChzAgMBAAGjPzA9MB0G
+A1UdDgQWBBSgc0mZaNyFW2XjmygvV5+9M7wHSDALBgNVHQ8EBAMCAQYwDwYDVR0T
+AQH/BAUwAwEB/zANBgkqhkiG9w0BAQUFAAOCAQEAaECpqLvkT115swW1F7NgE+vG
+kl3g0dNq/vu+m22/xwVtWSDEHPC32oRYAmP6SBbvT6UL90qY8j+eG61Ha2POCEfr
+Uj94nK9NrvjVT8+amCoQQTlSxN3Zmw7vkwGusi7KaEIkQmywszo+zenaSMQVy+n5
+Bw+SUEmK3TGXX8npN6o7WWWXlDLJs58+OmJYxUmtYg5xpTKqL8aJdkNAExNnPaJU
+JRDL8Try2frbSVa7pv6nQTXD4IhhyYjH3zYQIphZ6rBK+1YWc26sTfcioU+tHXot
+RSflMMFe8toTyyVCUZVHA4xsIcx0Qu1T/zOLjw9XARYvz6buyXAiFL39vmwLAw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
+# Subject: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
+# Label: "XRamp Global CA Root"
+# Serial: 107108908803651509692980124233745014957
+# MD5 Fingerprint: a1:0b:44:b3:ca:10:d8:00:6e:9d:0f:d8:0f:92:0a:d1
+# SHA1 Fingerprint: b8:01:86:d1:eb:9c:86:a5:41:04:cf:30:54:f3:4c:52:b7:e5:58:c6
+# SHA256 Fingerprint: ce:cd:dc:90:50:99:d8:da:df:c5:b1:d2:09:b7:37:cb:e2:c1:8c:fb:2c:10:c0:ff:0b:cf:0d:32:86:fc:1a:a2
+-----BEGIN CERTIFICATE-----
+MIIEMDCCAxigAwIBAgIQUJRs7Bjq1ZxN1ZfvdY+grTANBgkqhkiG9w0BAQUFADCB
+gjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3dy54cmFtcHNlY3VyaXR5LmNvbTEk
+MCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2VydmljZXMgSW5jMS0wKwYDVQQDEyRY
+UmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQxMTAxMTcx
+NDA0WhcNMzUwMTAxMDUzNzE5WjCBgjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3
+dy54cmFtcHNlY3VyaXR5LmNvbTEkMCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2Vy
+dmljZXMgSW5jMS0wKwYDVQQDEyRYUmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBB
+dXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCYJB69FbS6
+38eMpSe2OAtp87ZOqCwuIR1cRN8hXX4jdP5efrRKt6atH67gBhbim1vZZ3RrXYCP
+KZ2GG9mcDZhtdhAoWORlsH9KmHmf4MMxfoArtYzAQDsRhtDLooY2YKTVMIJt2W7Q
+DxIEM5dfT2Fa8OT5kavnHTu86M/0ay00fOJIYRyO82FEzG+gSqmUsE3a56k0enI4
+qEHMPJQRfevIpoy3hsvKMzvZPTeL+3o+hiznc9cKV6xkmxnr9A8ECIqsAxcZZPRa
+JSKNNCyy9mgdEm3Tih4U2sSPpuIjhdV6Db1q4Ons7Be7QhtnqiXtRYMh/MHJfNVi
+PvryxS3T/dRlAgMBAAGjgZ8wgZwwEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0P
+BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMZPoj0GY4QJnM5i5ASs
+jVy16bYbMDYGA1UdHwQvMC0wK6ApoCeGJWh0dHA6Ly9jcmwueHJhbXBzZWN1cml0
+eS5jb20vWEdDQS5jcmwwEAYJKwYBBAGCNxUBBAMCAQEwDQYJKoZIhvcNAQEFBQAD
+ggEBAJEVOQMBG2f7Shz5CmBbodpNl2L5JFMn14JkTpAuw0kbK5rc/Kh4ZzXxHfAR
+vbdI4xD2Dd8/0sm2qlWkSLoC295ZLhVbO50WfUfXN+pfTXYSNrsf16GBBEYgoyxt
+qZ4Bfj8pzgCT3/3JknOJiWSe5yvkHJEs0rnOfc5vMZnT5r7SHpDwCRR5XCOrTdLa
+IR9NmXmd4c8nnxCbHIgNsIpkQTG4DmyQJKSbXHGPurt+HBvbaoAPIbzp26a3QPSy
+i6mx5O+aGtA9aZnuqCij4Tyz8LIRnM98QObd50N9otg6tamN8jSZxNQQ4Qb9CYQQ
+O+7ETPTsJ3xCwnR8gooJybQDJbw=
+-----END CERTIFICATE-----
+
+# Issuer: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority
+# Subject: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority
+# Label: "Go Daddy Class 2 CA"
+# Serial: 0
+# MD5 Fingerprint: 91:de:06:25:ab:da:fd:32:17:0c:bb:25:17:2a:84:67
+# SHA1 Fingerprint: 27:96:ba:e6:3f:18:01:e2:77:26:1b:a0:d7:77:70:02:8f:20:ee:e4
+# SHA256 Fingerprint: c3:84:6b:f2:4b:9e:93:ca:64:27:4c:0e:c6:7c:1e:cc:5e:02:4f:fc:ac:d2:d7:40:19:35:0e:81:fe:54:6a:e4
+-----BEGIN CERTIFICATE-----
+MIIEADCCAuigAwIBAgIBADANBgkqhkiG9w0BAQUFADBjMQswCQYDVQQGEwJVUzEh
+MB8GA1UEChMYVGhlIEdvIERhZGR5IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBE
+YWRkeSBDbGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA0MDYyOTE3
+MDYyMFoXDTM0MDYyOTE3MDYyMFowYzELMAkGA1UEBhMCVVMxITAfBgNVBAoTGFRo
+ZSBHbyBEYWRkeSBHcm91cCwgSW5jLjExMC8GA1UECxMoR28gRGFkZHkgQ2xhc3Mg
+MiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASAwDQYJKoZIhvcNAQEBBQADggEN
+ADCCAQgCggEBAN6d1+pXGEmhW+vXX0iG6r7d/+TvZxz0ZWizV3GgXne77ZtJ6XCA
+PVYYYwhv2vLM0D9/AlQiVBDYsoHUwHU9S3/Hd8M+eKsaA7Ugay9qK7HFiH7Eux6w
+wdhFJ2+qN1j3hybX2C32qRe3H3I2TqYXP2WYktsqbl2i/ojgC95/5Y0V4evLOtXi
+EqITLdiOr18SPaAIBQi2XKVlOARFmR6jYGB0xUGlcmIbYsUfb18aQr4CUWWoriMY
+avx4A6lNf4DD+qta/KFApMoZFv6yyO9ecw3ud72a9nmYvLEHZ6IVDd2gWMZEewo+
+YihfukEHU1jPEX44dMX4/7VpkI+EdOqXG68CAQOjgcAwgb0wHQYDVR0OBBYEFNLE
+sNKR1EwRcbNhyz2h/t2oatTjMIGNBgNVHSMEgYUwgYKAFNLEsNKR1EwRcbNhyz2h
+/t2oatTjoWekZTBjMQswCQYDVQQGEwJVUzEhMB8GA1UEChMYVGhlIEdvIERhZGR5
+IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBEYWRkeSBDbGFzcyAyIENlcnRpZmlj
+YXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQAD
+ggEBADJL87LKPpH8EsahB4yOd6AzBhRckB4Y9wimPQoZ+YeAEW5p5JYXMP80kWNy
+OO7MHAGjHZQopDH2esRU1/blMVgDoszOYtuURXO1v0XJJLXVggKtI3lpjbi2Tc7P
+TMozI+gciKqdi0FuFskg5YmezTvacPd+mSYgFFQlq25zheabIZ0KbIIOqPjCDPoQ
+HmyW74cNxA9hi63ugyuV+I6ShHI56yDqg+2DzZduCLzrTia2cyvk0/ZM/iZx4mER
+dEr/VxqHD3VILs9RaRegAhJhldXRQLIQTO7ErBBDpqWeCtWVYpoNz4iCxTIM5Cuf
+ReYNnyicsbkqWletNw+vHX/bvZ8=
+-----END CERTIFICATE-----
+
+# Issuer: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority
+# Subject: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority
+# Label: "Starfield Class 2 CA"
+# Serial: 0
+# MD5 Fingerprint: 32:4a:4b:bb:c8:63:69:9b:be:74:9a:c6:dd:1d:46:24
+# SHA1 Fingerprint: ad:7e:1c:28:b0:64:ef:8f:60:03:40:20:14:c3:d0:e3:37:0e:b5:8a
+# SHA256 Fingerprint: 14:65:fa:20:53:97:b8:76:fa:a6:f0:a9:95:8e:55:90:e4:0f:cc:7f:aa:4f:b7:c2:c8:67:75:21:fb:5f:b6:58
+-----BEGIN CERTIFICATE-----
+MIIEDzCCAvegAwIBAgIBADANBgkqhkiG9w0BAQUFADBoMQswCQYDVQQGEwJVUzEl
+MCMGA1UEChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMp
+U3RhcmZpZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQw
+NjI5MTczOTE2WhcNMzQwNjI5MTczOTE2WjBoMQswCQYDVQQGEwJVUzElMCMGA1UE
+ChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMpU3RhcmZp
+ZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEgMA0GCSqGSIb3
+DQEBAQUAA4IBDQAwggEIAoIBAQC3Msj+6XGmBIWtDBFk385N78gDGIc/oav7PKaf
+8MOh2tTYbitTkPskpD6E8J7oX+zlJ0T1KKY/e97gKvDIr1MvnsoFAZMej2YcOadN
++lq2cwQlZut3f+dZxkqZJRRU6ybH838Z1TBwj6+wRir/resp7defqgSHo9T5iaU0
+X9tDkYI22WY8sbi5gv2cOj4QyDvvBmVmepsZGD3/cVE8MC5fvj13c7JdBmzDI1aa
+K4UmkhynArPkPw2vCHmCuDY96pzTNbO8acr1zJ3o/WSNF4Azbl5KXZnJHoe0nRrA
+1W4TNSNe35tfPe/W93bC6j67eA0cQmdrBNj41tpvi/JEoAGrAgEDo4HFMIHCMB0G
+A1UdDgQWBBS/X7fRzt0fhvRbVazc1xDCDqmI5zCBkgYDVR0jBIGKMIGHgBS/X7fR
+zt0fhvRbVazc1xDCDqmI56FspGowaDELMAkGA1UEBhMCVVMxJTAjBgNVBAoTHFN0
+YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAsTKVN0YXJmaWVsZCBD
+bGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8w
+DQYJKoZIhvcNAQEFBQADggEBAAWdP4id0ckaVaGsafPzWdqbAYcaT1epoXkJKtv3
+L7IezMdeatiDh6GX70k1PncGQVhiv45YuApnP+yz3SFmH8lU+nLMPUxA2IGvd56D
+eruix/U0F47ZEUD0/CwqTRV/p2JdLiXTAAsgGh1o+Re49L2L7ShZ3U0WixeDyLJl
+xy16paq8U4Zt3VekyvggQQto8PT7dL5WXXp59fkdheMtlb71cZBDzI0fmgAKhynp
+VSJYACPq4xJDKVtHCN2MQWplBqjlIapBtJUhlbl90TSrE9atvNziPTnNvT51cKEY
+WQPJIrSPnNVeKtelttQKbfi3QBFGmh95DmK/D5fs4C8fF5Q=
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Assured ID Root CA"
+# Serial: 17154717934120587862167794914071425081
+# MD5 Fingerprint: 87:ce:0b:7b:2a:0e:49:00:e1:58:71:9b:37:a8:93:72
+# SHA1 Fingerprint: 05:63:b8:63:0d:62:d7:5a:bb:c8:ab:1e:4b:df:b5:a8:99:b2:4d:43
+# SHA256 Fingerprint: 3e:90:99:b5:01:5e:8f:48:6c:00:bc:ea:9d:11:1e:e7:21:fa:ba:35:5a:89:bc:f1:df:69:56:1e:3d:c6:32:5c
+-----BEGIN CERTIFICATE-----
+MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
+b3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzExMTEwMDAwMDAwWjBlMQswCQYDVQQG
+EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
+cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwggEi
+MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg+XESpa7c
+JpSIqvTO9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lTXDGEKvYP
+mDI2dsze3Tyoou9q+yHyUmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5a3/UsDg+
+wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW/lmci3Zt1/GiSw0r/wty2p5g0I6QNcZ4
+VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpyoeb6pNnVFzF1roV9Iq4/
+AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whfGHdPAgMB
+AAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
+BBRF66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYun
+pyGd823IDzANBgkqhkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3cmbYMuRC
+dWKuh+vy1dneVrOfzM4UKLkNl2BcEkxY5NM9g0lFWJc1aRqoR+pWxnmrEthngYTf
+fwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38FnSbNd67IJKusm7Xi+fT8r87cm
+NW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i8b5QZ7dsvfPx
+H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe
++o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Global Root CA"
+# Serial: 10944719598952040374951832963794454346
+# MD5 Fingerprint: 79:e4:a9:84:0d:7d:3a:96:d7:c0:4f:e2:43:4c:89:2e
+# SHA1 Fingerprint: a8:98:5d:3a:65:e5:e5:c4:b2:d7:d6:6d:40:c6:dd:2f:b1:9c:54:36
+# SHA256 Fingerprint: 43:48:a0:e9:44:4c:78:cb:26:5e:05:8d:5e:89:44:b4:d8:4f:96:62:bd:26:db:25:7f:89:34:a4:43:c7:01:61
+-----BEGIN CERTIFICATE-----
+MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
+QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT
+MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
+b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG
+9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB
+CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97
+nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt
+43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P
+T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4
+gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO
+BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR
+TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw
+DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr
+hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg
+06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF
+PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls
+YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk
+CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4=
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert High Assurance EV Root CA"
+# Serial: 3553400076410547919724730734378100087
+# MD5 Fingerprint: d4:74:de:57:5c:39:b2:d3:9c:85:83:c5:c0:65:49:8a
+# SHA1 Fingerprint: 5f:b7:ee:06:33:e2:59:db:ad:0c:4c:9a:e6:d3:8f:1a:61:c7:dc:25
+# SHA256 Fingerprint: 74:31:e5:f4:c3:c1:ce:46:90:77:4f:0b:61:e0:54:40:88:3b:a9:a0:1e:d0:0b:a6:ab:d7:80:6e:d3:b1:18:cf
+-----BEGIN CERTIFICATE-----
+MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBs
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSswKQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5j
+ZSBFViBSb290IENBMB4XDTA2MTExMDAwMDAwMFoXDTMxMTExMDAwMDAwMFowbDEL
+MAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3
+LmRpZ2ljZXJ0LmNvbTErMCkGA1UEAxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2Ug
+RVYgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMbM5XPm
++9S75S0tMqbf5YE/yc0lSbZxKsPVlDRnogocsF9ppkCxxLeyj9CYpKlBWTrT3JTW
+PNt0OKRKzE0lgvdKpVMSOO7zSW1xkX5jtqumX8OkhPhPYlG++MXs2ziS4wblCJEM
+xChBVfvLWokVfnHoNb9Ncgk9vjo4UFt3MRuNs8ckRZqnrG0AFFoEt7oT61EKmEFB
+Ik5lYYeBQVCmeVyJ3hlKV9Uu5l0cUyx+mM0aBhakaHPQNAQTXKFx01p8VdteZOE3
+hzBWBOURtCmAEvF5OYiiAhF8J2a3iLd48soKqDirCmTCv2ZdlYTBoSUeh10aUAsg
+EsxBu24LUTi4S8sCAwEAAaNjMGEwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQF
+MAMBAf8wHQYDVR0OBBYEFLE+w2kD+L9HAdSYJhoIAu9jZCvDMB8GA1UdIwQYMBaA
+FLE+w2kD+L9HAdSYJhoIAu9jZCvDMA0GCSqGSIb3DQEBBQUAA4IBAQAcGgaX3Nec
+nzyIZgYIVyHbIUf4KmeqvxgydkAQV8GK83rZEWWONfqe/EW1ntlMMUu4kehDLI6z
+eM7b41N5cdblIZQB2lWHmiRk9opmzN6cN82oNLFpmyPInngiK3BD41VHMWEZ71jF
+hS9OMPagMRYjyOfiZRYzy78aG6A9+MpeizGLYAiJLQwGXFK3xPkKmNEVX58Svnw2
+Yzi9RKR/5CYrCsSXaQ3pjOLAEFe4yHYSkVXySGnYvCoCWw9E1CAx2/S6cCZdkGCe
+vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep
++OkuE6N36B9K
+-----END CERTIFICATE-----
+
+# Issuer: CN=DST Root CA X3 O=Digital Signature Trust Co.
+# Subject: CN=DST Root CA X3 O=Digital Signature Trust Co.
+# Label: "DST Root CA X3"
+# Serial: 91299735575339953335919266965803778155
+# MD5 Fingerprint: 41:03:52:dc:0f:f7:50:1b:16:f0:02:8e:ba:6f:45:c5
+# SHA1 Fingerprint: da:c9:02:4f:54:d8:f6:df:94:93:5f:b1:73:26:38:ca:6a:d7:7c:13
+# SHA256 Fingerprint: 06:87:26:03:31:a7:24:03:d9:09:f1:05:e6:9b:cf:0d:32:e1:bd:24:93:ff:c6:d9:20:6d:11:bc:d6:77:07:39
+-----BEGIN CERTIFICATE-----
+MIIDSjCCAjKgAwIBAgIQRK+wgNajJ7qJMDmGLvhAazANBgkqhkiG9w0BAQUFADA/
+MSQwIgYDVQQKExtEaWdpdGFsIFNpZ25hdHVyZSBUcnVzdCBDby4xFzAVBgNVBAMT
+DkRTVCBSb290IENBIFgzMB4XDTAwMDkzMDIxMTIxOVoXDTIxMDkzMDE0MDExNVow
+PzEkMCIGA1UEChMbRGlnaXRhbCBTaWduYXR1cmUgVHJ1c3QgQ28uMRcwFQYDVQQD
+Ew5EU1QgUm9vdCBDQSBYMzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
+AN+v6ZdQCINXtMxiZfaQguzH0yxrMMpb7NnDfcdAwRgUi+DoM3ZJKuM/IUmTrE4O
+rz5Iy2Xu/NMhD2XSKtkyj4zl93ewEnu1lcCJo6m67XMuegwGMoOifooUMM0RoOEq
+OLl5CjH9UL2AZd+3UWODyOKIYepLYYHsUmu5ouJLGiifSKOeDNoJjj4XLh7dIN9b
+xiqKqy69cK3FCxolkHRyxXtqqzTWMIn/5WgTe1QLyNau7Fqckh49ZLOMxt+/yUFw
+7BZy1SbsOFU5Q9D8/RhcQPGX69Wam40dutolucbY38EVAjqr2m7xPi71XAicPNaD
+aeQQmxkqtilX4+U9m5/wAl0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNV
+HQ8BAf8EBAMCAQYwHQYDVR0OBBYEFMSnsaR7LHH62+FLkHX/xBVghYkQMA0GCSqG
+SIb3DQEBBQUAA4IBAQCjGiybFwBcqR7uKGY3Or+Dxz9LwwmglSBd49lZRNI+DT69
+ikugdB/OEIKcdBodfpga3csTS7MgROSR6cz8faXbauX+5v3gTt23ADq1cEmv8uXr
+AvHRAosZy5Q6XkjEGB5YGV8eAlrwDPGxrancWYaLbumR9YbK+rlmM6pZW87ipxZz
+R8srzJmwN0jP41ZL9c8PDHIyh8bwRLtTcm1D9SZImlJnt1ir/md2cXjbDaJWFBM5
+JDGFoqgCWjBH4d1QB7wCCZAA62RjYJsWvIjJEubSfZGL+T0yjWW06XyxV3bqxbYo
+Ob8VZRzI9neWagqNdwvYkQsEjgfbKbYK7p2CNTUQ
+-----END CERTIFICATE-----
+
+# Issuer: CN=SwissSign Gold CA - G2 O=SwissSign AG
+# Subject: CN=SwissSign Gold CA - G2 O=SwissSign AG
+# Label: "SwissSign Gold CA - G2"
+# Serial: 13492815561806991280
+# MD5 Fingerprint: 24:77:d9:a8:91:d1:3b:fa:88:2d:c2:ff:f8:cd:33:93
+# SHA1 Fingerprint: d8:c5:38:8a:b7:30:1b:1b:6e:d4:7a:e6:45:25:3a:6f:9f:1a:27:61
+# SHA256 Fingerprint: 62:dd:0b:e9:b9:f5:0a:16:3e:a0:f8:e7:5c:05:3b:1e:ca:57:ea:55:c8:68:8f:64:7c:68:81:f2:c8:35:7b:95
+-----BEGIN CERTIFICATE-----
+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
+-----END CERTIFICATE-----
+
+# Issuer: CN=SwissSign Silver CA - G2 O=SwissSign AG
+# Subject: CN=SwissSign Silver CA - G2 O=SwissSign AG
+# Label: "SwissSign Silver CA - G2"
+# Serial: 5700383053117599563
+# MD5 Fingerprint: e0:06:a1:c9:7d:cf:c9:fc:0d:c0:56:75:96:d8:62:13
+# SHA1 Fingerprint: 9b:aa:e5:9f:56:ee:21:cb:43:5a:be:25:93:df:a7:f0:40:d1:1d:cb
+# SHA256 Fingerprint: be:6c:4d:a2:bb:b9:ba:59:b6:f3:93:97:68:37:42:46:c3:c0:05:99:3f:a9:8f:02:0d:1d:ed:be:d4:8a:81:d5
+-----BEGIN CERTIFICATE-----
+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
+-----END CERTIFICATE-----
+
+# Issuer: CN=SecureTrust CA O=SecureTrust Corporation
+# Subject: CN=SecureTrust CA O=SecureTrust Corporation
+# Label: "SecureTrust CA"
+# Serial: 17199774589125277788362757014266862032
+# MD5 Fingerprint: dc:32:c3:a7:6d:25:57:c7:68:09:9d:ea:2d:a9:a2:d1
+# SHA1 Fingerprint: 87:82:c6:c3:04:35:3b:cf:d2:96:92:d2:59:3e:7d:44:d9:34:ff:11
+# SHA256 Fingerprint: f1:c1:b5:0a:e5:a2:0d:d8:03:0e:c9:f6:bc:24:82:3d:d3:67:b5:25:57:59:b4:e7:1b:61:fc:e9:f7:37:5d:73
+-----BEGIN CERTIFICATE-----
+MIIDuDCCAqCgAwIBAgIQDPCOXAgWpa1Cf/DrJxhZ0DANBgkqhkiG9w0BAQUFADBI
+MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x
+FzAVBgNVBAMTDlNlY3VyZVRydXN0IENBMB4XDTA2MTEwNzE5MzExOFoXDTI5MTIz
+MTE5NDA1NVowSDELMAkGA1UEBhMCVVMxIDAeBgNVBAoTF1NlY3VyZVRydXN0IENv
+cnBvcmF0aW9uMRcwFQYDVQQDEw5TZWN1cmVUcnVzdCBDQTCCASIwDQYJKoZIhvcN
+AQEBBQADggEPADCCAQoCggEBAKukgeWVzfX2FI7CT8rU4niVWJxB4Q2ZQCQXOZEz
+Zum+4YOvYlyJ0fwkW2Gz4BERQRwdbvC4u/jep4G6pkjGnx29vo6pQT64lO0pGtSO
+0gMdA+9tDWccV9cGrcrI9f4Or2YlSASWC12juhbDCE/RRvgUXPLIXgGZbf2IzIao
+wW8xQmxSPmjL8xk037uHGFaAJsTQ3MBv396gwpEWoGQRS0S8Hvbn+mPeZqx2pHGj
+7DaUaHp3pLHnDi+BeuK1cobvomuL8A/b01k/unK8RCSc43Oz969XL0Imnal0ugBS
+8kvNU3xHCzaFDmapCJcWNFfBZveA4+1wVMeT4C4oFVmHursCAwEAAaOBnTCBmjAT
+BgkrBgEEAYI3FAIEBh4EAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB
+/zAdBgNVHQ4EFgQUQjK2FvoE/f5dS3rD/fdMQB1aQ68wNAYDVR0fBC0wKzApoCeg
+JYYjaHR0cDovL2NybC5zZWN1cmV0cnVzdC5jb20vU1RDQS5jcmwwEAYJKwYBBAGC
+NxUBBAMCAQAwDQYJKoZIhvcNAQEFBQADggEBADDtT0rhWDpSclu1pqNlGKa7UTt3
+6Z3q059c4EVlew3KW+JwULKUBRSuSceNQQcSc5R+DCMh/bwQf2AQWnL1mA6s7Ll/
+3XpvXdMc9P+IBWlCqQVxyLesJugutIxq/3HcuLHfmbx8IVQr5Fiiu1cprp6poxkm
+D5kuCLDv/WnPmRoJjeOnnyvJNjR7JLN4TJUXpAYmHrZkUjZfYGfZnMUFdAvnZyPS
+CPyI6a6Lf+Ew9Dd+/cYy2i2eRDAwbO4H3tI0/NL/QPZL9GZGBlSm8jIKYyYwa5vR
+3ItHuuG51WLQoqD0ZwV4KWMabwTW+MZMo5qxN7SN5ShLHZ4swrhovO0C7jE=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Secure Global CA O=SecureTrust Corporation
+# Subject: CN=Secure Global CA O=SecureTrust Corporation
+# Label: "Secure Global CA"
+# Serial: 9751836167731051554232119481456978597
+# MD5 Fingerprint: cf:f4:27:0d:d4:ed:dc:65:16:49:6d:3d:da:bf:6e:de
+# SHA1 Fingerprint: 3a:44:73:5a:e5:81:90:1f:24:86:61:46:1e:3b:9c:c4:5f:f5:3a:1b
+# SHA256 Fingerprint: 42:00:f5:04:3a:c8:59:0e:bb:52:7d:20:9e:d1:50:30:29:fb:cb:d4:1c:a1:b5:06:ec:27:f1:5a:de:7d:ac:69
+-----BEGIN CERTIFICATE-----
+MIIDvDCCAqSgAwIBAgIQB1YipOjUiolN9BPI8PjqpTANBgkqhkiG9w0BAQUFADBK
+MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x
+GTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwHhcNMDYxMTA3MTk0MjI4WhcNMjkx
+MjMxMTk1MjA2WjBKMQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3Qg
+Q29ycG9yYXRpb24xGTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwggEiMA0GCSqG
+SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvNS7YrGxVaQZx5RNoJLNP2MwhR/jxYDiJ
+iQPpvepeRlMJ3Fz1Wuj3RSoC6zFh1ykzTM7HfAo3fg+6MpjhHZevj8fcyTiW89sa
+/FHtaMbQbqR8JNGuQsiWUGMu4P51/pinX0kuleM5M2SOHqRfkNJnPLLZ/kG5VacJ
+jnIFHovdRIWCQtBJwB1g8NEXLJXr9qXBkqPFwqcIYA1gBBCWeZ4WNOaptvolRTnI
+HmX5k/Wq8VLcmZg9pYYaDDUz+kulBAYVHDGA76oYa8J719rO+TMg1fW9ajMtgQT7
+sFzUnKPiXB3jqUJ1XnvUd+85VLrJChgbEplJL4hL/VBi0XPnj3pDAgMBAAGjgZ0w
+gZowEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQF
+MAMBAf8wHQYDVR0OBBYEFK9EBMJBfkiD2045AuzshHrmzsmkMDQGA1UdHwQtMCsw
+KaAnoCWGI2h0dHA6Ly9jcmwuc2VjdXJldHJ1c3QuY29tL1NHQ0EuY3JsMBAGCSsG
+AQQBgjcVAQQDAgEAMA0GCSqGSIb3DQEBBQUAA4IBAQBjGghAfaReUw132HquHw0L
+URYD7xh8yOOvaliTFGCRsoTciE6+OYo68+aCiV0BN7OrJKQVDpI1WkpEXk5X+nXO
+H0jOZvQ8QCaSmGwb7iRGDBezUqXbpZGRzzfTb+cnCDpOGR86p1hcF895P4vkp9Mm
+I50mD1hp/Ed+stCNi5O/KU9DaXR2Z0vPB4zmAve14bRDtUstFJ/53CYNv6ZHdAbY
+iNE6KTCEztI5gGIbqMdXSbxqVVFnFUq+NQfk1XWYN3kwFNspnWzFacxHVaIw98xc
+f8LDmBxrThaA63p4ZUWiABqvDA1VZDRIuJK58bRQKfJPIx/abKwfROHdI3hRW8cW
+-----END CERTIFICATE-----
+
+# Issuer: CN=COMODO Certification Authority O=COMODO CA Limited
+# Subject: CN=COMODO Certification Authority O=COMODO CA Limited
+# Label: "COMODO Certification Authority"
+# Serial: 104350513648249232941998508985834464573
+# MD5 Fingerprint: 5c:48:dc:f7:42:72:ec:56:94:6d:1c:cc:71:35:80:75
+# SHA1 Fingerprint: 66:31:bf:9e:f7:4f:9e:b6:c9:d5:a6:0c:ba:6a:be:d1:f7:bd:ef:7b
+# SHA256 Fingerprint: 0c:2c:d6:3d:f7:80:6f:a3:99:ed:e8:09:11:6b:57:5b:f8:79:89:f0:65:18:f9:80:8c:86:05:03:17:8b:af:66
+-----BEGIN CERTIFICATE-----
+MIIEHTCCAwWgAwIBAgIQToEtioJl4AsC7j41AkblPTANBgkqhkiG9w0BAQUFADCB
+gTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
+A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxJzAlBgNV
+BAMTHkNPTU9ETyBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNjEyMDEwMDAw
+MDBaFw0yOTEyMzEyMzU5NTlaMIGBMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3Jl
+YXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRowGAYDVQQKExFDT01P
+RE8gQ0EgTGltaXRlZDEnMCUGA1UEAxMeQ09NT0RPIENlcnRpZmljYXRpb24gQXV0
+aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0ECLi3LjkRv3
+UcEbVASY06m/weaKXTuH+7uIzg3jLz8GlvCiKVCZrts7oVewdFFxze1CkU1B/qnI
+2GqGd0S7WWaXUF601CxwRM/aN5VCaTwwxHGzUvAhTaHYujl8HJ6jJJ3ygxaYqhZ8
+Q5sVW7euNJH+1GImGEaaP+vB+fGQV+useg2L23IwambV4EajcNxo2f8ESIl33rXp
++2dtQem8Ob0y2WIC8bGoPW43nOIv4tOiJovGuFVDiOEjPqXSJDlqR6sA1KGzqSX+
+DT+nHbrTUcELpNqsOO9VUCQFZUaTNE8tja3G1CEZ0o7KBWFxB3NH5YoZEr0ETc5O
+nKVIrLsm9wIDAQABo4GOMIGLMB0GA1UdDgQWBBQLWOWLxkwVN6RAqTCpIb5HNlpW
+/zAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zBJBgNVHR8EQjBAMD6g
+PKA6hjhodHRwOi8vY3JsLmNvbW9kb2NhLmNvbS9DT01PRE9DZXJ0aWZpY2F0aW9u
+QXV0aG9yaXR5LmNybDANBgkqhkiG9w0BAQUFAAOCAQEAPpiem/Yb6dc5t3iuHXIY
+SdOH5EOC6z/JqvWote9VfCFSZfnVDeFs9D6Mk3ORLgLETgdxb8CPOGEIqB6BCsAv
+IC9Bi5HcSEW88cbeunZrM8gALTFGTO3nnc+IlP8zwFboJIYmuNg4ON8qa90SzMc/
+RxdMosIGlgnW2/4/PEZB31jiVg88O8EckzXZOFKs7sjsLjBOlDW0JB9LeGna8gI4
+zJVSk/BwJVmcIGfE7vmLV2H0knZ9P4SNVbfo5azV8fUZVqZa+5Acr5Pr5RzUZ5dd
+BA6+C4OmF4O5MBKgxTMVBbkN+8cFduPYSo38NBejxiEovjBFMR7HeL5YYTisO+IB
+ZQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Network Solutions Certificate Authority O=Network Solutions L.L.C.
+# Subject: CN=Network Solutions Certificate Authority O=Network Solutions L.L.C.
+# Label: "Network Solutions Certificate Authority"
+# Serial: 116697915152937497490437556386812487904
+# MD5 Fingerprint: d3:f3:a6:16:c0:fa:6b:1d:59:b1:2d:96:4d:0e:11:2e
+# SHA1 Fingerprint: 74:f8:a3:c3:ef:e7:b3:90:06:4b:83:90:3c:21:64:60:20:e5:df:ce
+# SHA256 Fingerprint: 15:f0:ba:00:a3:ac:7a:f3:ac:88:4c:07:2b:10:11:a0:77:bd:77:c0:97:f4:01:64:b2:f8:59:8a:bd:83:86:0c
+-----BEGIN CERTIFICATE-----
+MIID5jCCAs6gAwIBAgIQV8szb8JcFuZHFhfjkDFo4DANBgkqhkiG9w0BAQUFADBi
+MQswCQYDVQQGEwJVUzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMu
+MTAwLgYDVQQDEydOZXR3b3JrIFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3Jp
+dHkwHhcNMDYxMjAxMDAwMDAwWhcNMjkxMjMxMjM1OTU5WjBiMQswCQYDVQQGEwJV
+UzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMuMTAwLgYDVQQDEydO
+ZXR3b3JrIFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwggEiMA0GCSqG
+SIb3DQEBAQUAA4IBDwAwggEKAoIBAQDkvH6SMG3G2I4rC7xGzuAnlt7e+foS0zwz
+c7MEL7xxjOWftiJgPl9dzgn/ggwbmlFQGiaJ3dVhXRncEg8tCqJDXRfQNJIg6nPP
+OCwGJgl6cvf6UDL4wpPTaaIjzkGxzOTVHzbRijr4jGPiFFlp7Q3Tf2vouAPlT2rl
+mGNpSAW+Lv8ztumXWWn4Zxmuk2GWRBXTcrA/vGp97Eh/jcOrqnErU2lBUzS1sLnF
+BgrEsEX1QV1uiUV7PTsmjHTC5dLRfbIR1PtYMiKagMnc/Qzpf14Dl847ABSHJ3A4
+qY5usyd2mFHgBeMhqxrVhSI8KbWaFsWAqPS7azCPL0YCorEMIuDTAgMBAAGjgZcw
+gZQwHQYDVR0OBBYEFCEwyfsA106Y2oeqKtCnLrFAMadMMA4GA1UdDwEB/wQEAwIB
+BjAPBgNVHRMBAf8EBTADAQH/MFIGA1UdHwRLMEkwR6BFoEOGQWh0dHA6Ly9jcmwu
+bmV0c29sc3NsLmNvbS9OZXR3b3JrU29sdXRpb25zQ2VydGlmaWNhdGVBdXRob3Jp
+dHkuY3JsMA0GCSqGSIb3DQEBBQUAA4IBAQC7rkvnt1frf6ott3NHhWrB5KUd5Oc8
+6fRZZXe1eltajSU24HqXLjjAV2CDmAaDn7l2em5Q4LqILPxFzBiwmZVRDuwduIj/
+h1AcgsLj4DKAv6ALR8jDMe+ZZzKATxcheQxpXN5eNK4CtSbqUN9/GGUsyfJj4akH
+/nxxH2szJGoeBfcFaMBqEssuXmHLrijTfsK0ZpEmXzwuJF/LWA/rKOyvEZbz3Htv
+wKeI8lN3s2Berq4o2jUsbzRF0ybh3uxbTydrFny9RAQYgrOJeRcQcT16ohZO9QHN
+pGxlaKFJdlxDydi8NmdspZS11My5vWo1ViHe2MPr+8ukYEywVaCge1ey
+-----END CERTIFICATE-----
+
+# Issuer: CN=COMODO ECC Certification Authority O=COMODO CA Limited
+# Subject: CN=COMODO ECC Certification Authority O=COMODO CA Limited
+# Label: "COMODO ECC Certification Authority"
+# Serial: 41578283867086692638256921589707938090
+# MD5 Fingerprint: 7c:62:ff:74:9d:31:53:5e:68:4a:d5:78:aa:1e:bf:23
+# SHA1 Fingerprint: 9f:74:4e:9f:2b:4d:ba:ec:0f:31:2c:50:b6:56:3b:8e:2d:93:c3:11
+# SHA256 Fingerprint: 17:93:92:7a:06:14:54:97:89:ad:ce:2f:8f:34:f7:f0:b6:6d:0f:3a:e3:a3:b8:4d:21:ec:15:db:ba:4f:ad:c7
+-----BEGIN CERTIFICATE-----
+MIICiTCCAg+gAwIBAgIQH0evqmIAcFBUTAGem2OZKjAKBggqhkjOPQQDAzCBhTEL
+MAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE
+BxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMT
+IkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwMzA2MDAw
+MDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdy
+ZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09N
+T0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlv
+biBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQDR3svdcmCFYX7deSR
+FtSrYpn1PlILBs5BAH+X4QokPB0BBO490o0JlwzgdeT6+3eKKvUDYEs2ixYjFq0J
+cfRK9ChQtP6IHG4/bC8vCVlbpVsLM5niwz2J+Wos77LTBumjQjBAMB0GA1UdDgQW
+BBR1cacZSBm8nZ3qQUfflMRId5nTeTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/
+BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjEA7wNbeqy3eApyt4jf/7VGFAkK+qDm
+fQjGGoe9GKhzvSbKYAydzpmfz1wPMOG+FDHqAjAU9JM8SaczepBGR7NjfRObTrdv
+GDeAU/7dIOA1mjbRxwG55tzd8/8dLDoWV9mSOdY=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certigna O=Dhimyotis
+# Subject: CN=Certigna O=Dhimyotis
+# Label: "Certigna"
+# Serial: 18364802974209362175
+# MD5 Fingerprint: ab:57:a6:5b:7d:42:82:19:b5:d8:58:26:28:5e:fd:ff
+# SHA1 Fingerprint: b1:2e:13:63:45:86:a4:6f:1a:b2:60:68:37:58:2d:c4:ac:fd:94:97
+# SHA256 Fingerprint: e3:b6:a2:db:2e:d7:ce:48:84:2f:7a:c5:32:41:c7:b7:1d:54:14:4b:fb:40:c1:1f:3f:1d:0b:42:f5:ee:a1:2d
+-----BEGIN CERTIFICATE-----
+MIIDqDCCApCgAwIBAgIJAP7c4wEPyUj/MA0GCSqGSIb3DQEBBQUAMDQxCzAJBgNV
+BAYTAkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hMB4X
+DTA3MDYyOTE1MTMwNVoXDTI3MDYyOTE1MTMwNVowNDELMAkGA1UEBhMCRlIxEjAQ
+BgNVBAoMCURoaW15b3RpczERMA8GA1UEAwwIQ2VydGlnbmEwggEiMA0GCSqGSIb3
+DQEBAQUAA4IBDwAwggEKAoIBAQDIaPHJ1tazNHUmgh7stL7qXOEm7RFHYeGifBZ4
+QCHkYJ5ayGPhxLGWkv8YbWkj4Sti993iNi+RB7lIzw7sebYs5zRLcAglozyHGxny
+gQcPOJAZ0xH+hrTy0V4eHpbNgGzOOzGTtvKg0KmVEn2lmsxryIRWijOp5yIVUxbw
+zBfsV1/pogqYCd7jX5xv3EjjhQsVWqa6n6xI4wmy9/Qy3l40vhx4XUJbzg4ij02Q
+130yGLMLLGq/jj8UEYkgDncUtT2UCIf3JR7VsmAA7G8qKCVuKj4YYxclPz5EIBb2
+JsglrgVKtOdjLPOMFlN+XPsRGgjBRmKfIrjxwo1p3Po6WAbfAgMBAAGjgbwwgbkw
+DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUGu3+QTmQtCRZvgHyUtVF9lo53BEw
+ZAYDVR0jBF0wW4AUGu3+QTmQtCRZvgHyUtVF9lo53BGhOKQ2MDQxCzAJBgNVBAYT
+AkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hggkA/tzj
+AQ/JSP8wDgYDVR0PAQH/BAQDAgEGMBEGCWCGSAGG+EIBAQQEAwIABzANBgkqhkiG
+9w0BAQUFAAOCAQEAhQMeknH2Qq/ho2Ge6/PAD/Kl1NqV5ta+aDY9fm4fTIrv0Q8h
+bV6lUmPOEvjvKtpv6zf+EwLHyzs+ImvaYS5/1HI93TDhHkxAGYwP15zRgzB7mFnc
+fca5DClMoTOi62c6ZYTTluLtdkVwj7Ur3vkj1kluPBS1xp81HlDQwY9qcEQCYsuu
+HWhBp6pX6FOqB9IG9tUUBguRA3UsbHK1YZWaDYu5Def131TN3ubY1gkIl2PlwS6w
+t0QmwCbAr1UwnjvVNioZBPRcHv/PLLf/0P2HQBHVESO7SMAhqaQoLf0V+LBOK/Qw
+WyH8EZE0vkHve52Xdf+XlcCWWC/qu0bXu+TZLg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Cybertrust Global Root O=Cybertrust, Inc
+# Subject: CN=Cybertrust Global Root O=Cybertrust, Inc
+# Label: "Cybertrust Global Root"
+# Serial: 4835703278459682877484360
+# MD5 Fingerprint: 72:e4:4a:87:e3:69:40:80:77:ea:bc:e3:f4:ff:f0:e1
+# SHA1 Fingerprint: 5f:43:e5:b1:bf:f8:78:8c:ac:1c:c7:ca:4a:9a:c6:22:2b:cc:34:c6
+# SHA256 Fingerprint: 96:0a:df:00:63:e9:63:56:75:0c:29:65:dd:0a:08:67:da:0b:9c:bd:6e:77:71:4a:ea:fb:23:49:ab:39:3d:a3
+-----BEGIN CERTIFICATE-----
+MIIDoTCCAomgAwIBAgILBAAAAAABD4WqLUgwDQYJKoZIhvcNAQEFBQAwOzEYMBYG
+A1UEChMPQ3liZXJ0cnVzdCwgSW5jMR8wHQYDVQQDExZDeWJlcnRydXN0IEdsb2Jh
+bCBSb290MB4XDTA2MTIxNTA4MDAwMFoXDTIxMTIxNTA4MDAwMFowOzEYMBYGA1UE
+ChMPQ3liZXJ0cnVzdCwgSW5jMR8wHQYDVQQDExZDeWJlcnRydXN0IEdsb2JhbCBS
+b290MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA+Mi8vRRQZhP/8NN5
+7CPytxrHjoXxEnOmGaoQ25yiZXRadz5RfVb23CO21O1fWLE3TdVJDm71aofW0ozS
+J8bi/zafmGWgE07GKmSb1ZASzxQG9Dvj1Ci+6A74q05IlG2OlTEQXO2iLb3VOm2y
+HLtgwEZLAfVJrn5GitB0jaEMAs7u/OePuGtm839EAL9mJRQr3RAwHQeWP032a7iP
+t3sMpTjr3kfb1V05/Iin89cqdPHoWqI7n1C6poxFNcJQZZXcY4Lv3b93TZxiyWNz
+FtApD0mpSPCzqrdsxacwOUBdrsTiXSZT8M4cIwhhqJQZugRiQOwfOHB3EgZxpzAY
+XSUnpQIDAQABo4GlMIGiMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/
+MB0GA1UdDgQWBBS2CHsNesysIEyGVjJez6tuhS1wVzA/BgNVHR8EODA2MDSgMqAw
+hi5odHRwOi8vd3d3Mi5wdWJsaWMtdHJ1c3QuY29tL2NybC9jdC9jdHJvb3QuY3Js
+MB8GA1UdIwQYMBaAFLYIew16zKwgTIZWMl7Pq26FLXBXMA0GCSqGSIb3DQEBBQUA
+A4IBAQBW7wojoFROlZfJ+InaRcHUowAl9B8Tq7ejhVhpwjCt2BWKLePJzYFa+HMj
+Wqd8BfP9IjsO0QbE2zZMcwSO5bAi5MXzLqXZI+O4Tkogp24CJJ8iYGd7ix1yCcUx
+XOl5n4BHPa2hCwcUPUf/A2kaDAtE52Mlp3+yybh2hO0j9n0Hq0V+09+zv+mKts2o
+omcrUtW3ZfA5TGOgkXmTUg9U3YO7n9GPp1Nzw8v/MOx8BLjYRB+TX3EJIrduPuoc
+A06dGiBh+4E37F78CkWr1+cXVdCg6mCbpvbjjFspwgZgFJ0tl0ypkxWdYcQBX0jW
+WL1WMRJOEcgh4LMRkWXbtKaIOM5V
+-----END CERTIFICATE-----
+
+# Issuer: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority
+# Subject: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority
+# Label: "ePKI Root Certification Authority"
+# Serial: 28956088682735189655030529057352760477
+# MD5 Fingerprint: 1b:2e:00:ca:26:06:90:3d:ad:fe:6f:15:68:d3:6b:b3
+# SHA1 Fingerprint: 67:65:0d:f1:7e:8e:7e:5b:82:40:a4:f4:56:4b:cf:e2:3d:69:c6:f0
+# SHA256 Fingerprint: c0:a6:f4:dc:63:a2:4b:fd:cf:54:ef:2a:6a:08:2a:0a:72:de:35:80:3e:2f:f5:ff:52:7a:e5:d8:72:06:df:d5
+-----BEGIN CERTIFICATE-----
+MIIFsDCCA5igAwIBAgIQFci9ZUdcr7iXAF7kBtK8nTANBgkqhkiG9w0BAQUFADBe
+MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0
+ZC4xKjAoBgNVBAsMIWVQS0kgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAe
+Fw0wNDEyMjAwMjMxMjdaFw0zNDEyMjAwMjMxMjdaMF4xCzAJBgNVBAYTAlRXMSMw
+IQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEqMCgGA1UECwwhZVBL
+SSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkqhkiG9w0BAQEF
+AAOCAg8AMIICCgKCAgEA4SUP7o3biDN1Z82tH306Tm2d0y8U82N0ywEhajfqhFAH
+SyZbCUNsIZ5qyNUD9WBpj8zwIuQf5/dqIjG3LBXy4P4AakP/h2XGtRrBp0xtInAh
+ijHyl3SJCRImHJ7K2RKilTza6We/CKBk49ZCt0Xvl/T29de1ShUCWH2YWEtgvM3X
+DZoTM1PRYfl61dd4s5oz9wCGzh1NlDivqOx4UXCKXBCDUSH3ET00hl7lSM2XgYI1
+TBnsZfZrxQWh7kcT1rMhJ5QQCtkkO7q+RBNGMD+XPNjX12ruOzjjK9SXDrkb5wdJ
+fzcq+Xd4z1TtW0ado4AOkUPB1ltfFLqfpo0kR0BZv3I4sjZsN/+Z0V0OWQqraffA
+sgRFelQArr5T9rXn4fg8ozHSqf4hUmTFpmfwdQcGlBSBVcYn5AGPF8Fqcde+S/uU
+WH1+ETOxQvdibBjWzwloPn9s9h6PYq2lY9sJpx8iQkEeb5mKPtf5P0B6ebClAZLS
+nT0IFaUQAS2zMnaolQ2zepr7BxB4EW/hj8e6DyUadCrlHJhBmd8hh+iVBmoKs2pH
+dmX2Os+PYhcZewoozRrSgx4hxyy/vv9haLdnG7t4TY3OZ+XkwY63I2binZB1NJip
+NiuKmpS5nezMirH4JYlcWrYvjB9teSSnUmjDhDXiZo1jDiVN1Rmy5nk3pyKdVDEC
+AwEAAaNqMGgwHQYDVR0OBBYEFB4M97Zn8uGSJglFwFU5Lnc/QkqiMAwGA1UdEwQF
+MAMBAf8wOQYEZyoHAAQxMC8wLQIBADAJBgUrDgMCGgUAMAcGBWcqAwAABBRFsMLH
+ClZ87lt4DJX5GFPBphzYEDANBgkqhkiG9w0BAQUFAAOCAgEACbODU1kBPpVJufGB
+uvl2ICO1J2B01GqZNF5sAFPZn/KmsSQHRGoqxqWOeBLoR9lYGxMqXnmbnwoqZ6Yl
+PwZpVnPDimZI+ymBV3QGypzqKOg4ZyYr8dW1P2WT+DZdjo2NQCCHGervJ8A9tDkP
+JXtoUHRVnAxZfVo9QZQlUgjgRywVMRnVvwdVxrsStZf0X4OFunHB2WyBEXYKCrC/
+gpf36j36+uwtqSiUO1bd0lEursC9CBWMd1I0ltabrNMdjmEPNXubrjlpC2JgQCA2
+j6/7Nu4tCEoduL+bXPjqpRugc6bY+G7gMwRfaKonh+3ZwZCc7b3jajWvY9+rGNm6
+5ulK6lCKD2GTHuItGeIwlDWSXQ62B68ZgI9HkFFLLk3dheLSClIKF5r8GrBQAuUB
+o2M3IUxExJtRmREOc5wGj1QupyheRDmHVi03vYVElOEMSyycw5KFNGHLD7ibSkNS
+/jQ6fbjpKdx2qcgw+BRxgMYeNkh0IkFch4LoGHGLQYlE535YW6i4jRPpp2zDR+2z
+Gp1iro2C6pSe3VkQw63d4k3jMdXH7OjysP6SHhYKGvzZ8/gntsm+HbRsZJB/9OTE
+W9c3rkIO3aQab3yIVMUWbuF6aC74Or8NpDyJO3inTmODBCEIZ43ygknQW/2xzQ+D
+hNQ+IIX3Sj0rnP0qCglN6oH4EZw=
+-----END CERTIFICATE-----
+
+# Issuer: O=certSIGN OU=certSIGN ROOT CA
+# Subject: O=certSIGN OU=certSIGN ROOT CA
+# Label: "certSIGN ROOT CA"
+# Serial: 35210227249154
+# MD5 Fingerprint: 18:98:c0:d6:e9:3a:fc:f9:b0:f5:0c:f7:4b:01:44:17
+# SHA1 Fingerprint: fa:b7:ee:36:97:26:62:fb:2d:b0:2a:f6:bf:03:fd:e8:7c:4b:2f:9b
+# SHA256 Fingerprint: ea:a9:62:c4:fa:4a:6b:af:eb:e4:15:19:6d:35:1c:cd:88:8d:4f:53:f3:fa:8a:e6:d7:c4:66:a9:4e:60:42:bb
+-----BEGIN CERTIFICATE-----
+MIIDODCCAiCgAwIBAgIGIAYFFnACMA0GCSqGSIb3DQEBBQUAMDsxCzAJBgNVBAYT
+AlJPMREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBD
+QTAeFw0wNjA3MDQxNzIwMDRaFw0zMTA3MDQxNzIwMDRaMDsxCzAJBgNVBAYTAlJP
+MREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBDQTCC
+ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALczuX7IJUqOtdu0KBuqV5Do
+0SLTZLrTk+jUrIZhQGpgV2hUhE28alQCBf/fm5oqrl0Hj0rDKH/v+yv6efHHrfAQ
+UySQi2bJqIirr1qjAOm+ukbuW3N7LBeCgV5iLKECZbO9xSsAfsT8AzNXDe3i+s5d
+RdY4zTW2ssHQnIFKquSyAVwdj1+ZxLGt24gh65AIgoDzMKND5pCCrlUoSe1b16kQ
+OA7+j0xbm0bqQfWwCHTD0IgztnzXdN/chNFDDnU5oSVAKOp4yw4sLjmdjItuFhwv
+JoIQ4uNllAoEwF73XVv4EOLQunpL+943AAAaWyjj0pxzPjKHmKHJUS/X3qwzs08C
+AwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAcYwHQYDVR0O
+BBYEFOCMm9slSbPxfIbWskKHC9BroNnkMA0GCSqGSIb3DQEBBQUAA4IBAQA+0hyJ
+LjX8+HXd5n9liPRyTMks1zJO890ZeUe9jjtbkw9QSSQTaxQGcu8J06Gh40CEyecY
+MnQ8SG4Pn0vU9x7Tk4ZkVJdjclDVVc/6IJMCopvDI5NOFlV2oHB5bc0hH88vLbwZ
+44gx+FkagQnIl6Z0x2DEW8xXjrJ1/RsCCdtZb3KTafcxQdaIOL+Hsr0Wefmq5L6I
+Jd1hJyMctTEHBDa0GpC9oHRxUIltvBTjD4au8as+x6AJzKNI0eDbZOeStc+vckNw
+i/nDhDwTqn6Sm1dTk/pwwpEOMfmbZ13pljheX7NzTogVZ96edhBiIL5VaZVDADlN
+9u6wWk5JRFRYX0KD
+-----END CERTIFICATE-----
+
+# Issuer: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services)
+# Subject: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services)
+# Label: "NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny"
+# Serial: 80544274841616
+# MD5 Fingerprint: c5:a1:b7:ff:73:dd:d6:d7:34:32:18:df:fc:3c:ad:88
+# SHA1 Fingerprint: 06:08:3f:59:3f:15:a1:04:a0:69:a4:6b:a9:03:d0:06:b7:97:09:91
+# SHA256 Fingerprint: 6c:61:da:c3:a2:de:f0:31:50:6b:e0:36:d2:a6:fe:40:19:94:fb:d1:3d:f9:c8:d4:66:59:92:74:c4:46:ec:98
+-----BEGIN CERTIFICATE-----
+MIIEFTCCAv2gAwIBAgIGSUEs5AAQMA0GCSqGSIb3DQEBCwUAMIGnMQswCQYDVQQG
+EwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFTATBgNVBAoMDE5ldExvY2sgS2Z0LjE3
+MDUGA1UECwwuVGFuw7pzw610dsOhbnlraWFkw7NrIChDZXJ0aWZpY2F0aW9uIFNl
+cnZpY2VzKTE1MDMGA1UEAwwsTmV0TG9jayBBcmFueSAoQ2xhc3MgR29sZCkgRsWR
+dGFuw7pzw610dsOhbnkwHhcNMDgxMjExMTUwODIxWhcNMjgxMjA2MTUwODIxWjCB
+pzELMAkGA1UEBhMCSFUxETAPBgNVBAcMCEJ1ZGFwZXN0MRUwEwYDVQQKDAxOZXRM
+b2NrIEtmdC4xNzA1BgNVBAsMLlRhbsO6c8OtdHbDoW55a2lhZMOzayAoQ2VydGlm
+aWNhdGlvbiBTZXJ2aWNlcykxNTAzBgNVBAMMLE5ldExvY2sgQXJhbnkgKENsYXNz
+IEdvbGQpIEbFkXRhbsO6c8OtdHbDoW55MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
+MIIBCgKCAQEAxCRec75LbRTDofTjl5Bu0jBFHjzuZ9lk4BqKf8owyoPjIMHj9DrT
+lF8afFttvzBPhCf2nx9JvMaZCpDyD/V/Q4Q3Y1GLeqVw/HpYzY6b7cNGbIRwXdrz
+AZAj/E4wqX7hJ2Pn7WQ8oLjJM2P+FpD/sLj916jAwJRDC7bVWaaeVtAkH3B5r9s5
+VA1lddkVQZQBr17s9o3x/61k/iCa11zr/qYfCGSji3ZVrR47KGAuhyXoqq8fxmRG
+ILdwfzzeSNuWU7c5d+Qa4scWhHaXWy+7GRWF+GmF9ZmnqfI0p6m2pgP8b4Y9VHx2
+BJtr+UBdADTHLpl1neWIA6pN+APSQnbAGwIDAKiLo0UwQzASBgNVHRMBAf8ECDAG
+AQH/AgEEMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUzPpnk/C2uNClwB7zU/2M
+U9+D15YwDQYJKoZIhvcNAQELBQADggEBAKt/7hwWqZw8UQCgwBEIBaeZ5m8BiFRh
+bvG5GK1Krf6BQCOUL/t1fC8oS2IkgYIL9WHxHG64YTjrgfpioTtaYtOUZcTh5m2C
++C8lcLIhJsFyUR+MLMOEkMNaj7rP9KdlpeuY0fsFskZ1FSNqb4VjMIDw1Z4fKRzC
+bLBQWV2QWzuoDTDPv31/zvGdg73JRm4gpvlhUbohL3u+pRVjodSVh/GeufOJ8z2F
+uLjbvrW5KfnaNwUASZQDhETnv0Mxz3WLJdH0pmT1kvarBes96aULNmLazAZfNou2
+XjG4Kvte9nHfRCaexOYNkbQudZWAUWpLMKawYqGT8ZvYzsRjdT9ZR7E=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hongkong Post Root CA 1 O=Hongkong Post
+# Subject: CN=Hongkong Post Root CA 1 O=Hongkong Post
+# Label: "Hongkong Post Root CA 1"
+# Serial: 1000
+# MD5 Fingerprint: a8:0d:6f:39:78:b9:43:6d:77:42:6d:98:5a:cc:23:ca
+# SHA1 Fingerprint: d6:da:a8:20:8d:09:d2:15:4d:24:b5:2f:cb:34:6e:b2:58:b2:8a:58
+# SHA256 Fingerprint: f9:e6:7d:33:6c:51:00:2a:c0:54:c6:32:02:2d:66:dd:a2:e7:e3:ff:f1:0a:d0:61:ed:31:d8:bb:b4:10:cf:b2
+-----BEGIN CERTIFICATE-----
+MIIDMDCCAhigAwIBAgICA+gwDQYJKoZIhvcNAQEFBQAwRzELMAkGA1UEBhMCSEsx
+FjAUBgNVBAoTDUhvbmdrb25nIFBvc3QxIDAeBgNVBAMTF0hvbmdrb25nIFBvc3Qg
+Um9vdCBDQSAxMB4XDTAzMDUxNTA1MTMxNFoXDTIzMDUxNTA0NTIyOVowRzELMAkG
+A1UEBhMCSEsxFjAUBgNVBAoTDUhvbmdrb25nIFBvc3QxIDAeBgNVBAMTF0hvbmdr
+b25nIFBvc3QgUm9vdCBDQSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
+AQEArP84tulmAknjorThkPlAj3n54r15/gK97iSSHSL22oVyaf7XPwnU3ZG1ApzQ
+jVrhVcNQhrkpJsLj2aDxaQMoIIBFIi1WpztUlVYiWR8o3x8gPW2iNr4joLFutbEn
+PzlTCeqrauh0ssJlXI6/fMN4hM2eFvz1Lk8gKgifd/PFHsSaUmYeSF7jEAaPIpjh
+ZY4bXSNmO7ilMlHIhqqhqZ5/dpTCpmy3QfDVyAY45tQM4vM7TG1QjMSDJ8EThFk9
+nnV0ttgCXjqQesBCNnLsak3c78QA3xMYV18meMjWCnl3v/evt3a5pQuEF10Q6m/h
+q5URX208o1xNg1vysxmKgIsLhwIDAQABoyYwJDASBgNVHRMBAf8ECDAGAQH/AgED
+MA4GA1UdDwEB/wQEAwIBxjANBgkqhkiG9w0BAQUFAAOCAQEADkbVPK7ih9legYsC
+mEEIjEy82tvuJxuC52pF7BaLT4Wg87JwvVqWuspube5Gi27nKi6Wsxkz67SfqLI3
+7piol7Yutmcn1KZJ/RyTZXaeQi/cImyaT/JaFTmxcdcrUehtHJjA2Sr0oYJ71clB
+oiMBdDhViw+5LmeiIAQ32pwL0xch4I+XeTRvhEgCIDMb5jREn5Fw9IBehEPCKdJs
+EhTkYY2sEJCehFC78JZvRZ+K88psT/oROhUVRsPNH4NbLUES7VBnQRM9IauUiqpO
+fMGx+6fWtScvl6tu4B3i0RwsH0Ti/L6RoZz71ilTc4afU9hDDl3WY4JxHYB0yvbi
+AmvZWg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
+# Subject: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
+# Label: "SecureSign RootCA11"
+# Serial: 1
+# MD5 Fingerprint: b7:52:74:e2:92:b4:80:93:f2:75:e4:cc:d7:f2:ea:26
+# SHA1 Fingerprint: 3b:c4:9f:48:f8:f3:73:a0:9c:1e:bd:f8:5b:b1:c3:65:c7:d8:11:b3
+# SHA256 Fingerprint: bf:0f:ee:fb:9e:3a:58:1a:d5:f9:e9:db:75:89:98:57:43:d2:61:08:5c:4d:31:4f:6f:5d:72:59:aa:42:16:12
+-----BEGIN CERTIFICATE-----
+MIIDbTCCAlWgAwIBAgIBATANBgkqhkiG9w0BAQUFADBYMQswCQYDVQQGEwJKUDEr
+MCkGA1UEChMiSmFwYW4gQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcywgSW5jLjEcMBoG
+A1UEAxMTU2VjdXJlU2lnbiBSb290Q0ExMTAeFw0wOTA0MDgwNDU2NDdaFw0yOTA0
+MDgwNDU2NDdaMFgxCzAJBgNVBAYTAkpQMSswKQYDVQQKEyJKYXBhbiBDZXJ0aWZp
+Y2F0aW9uIFNlcnZpY2VzLCBJbmMuMRwwGgYDVQQDExNTZWN1cmVTaWduIFJvb3RD
+QTExMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA/XeqpRyQBTvLTJsz
+i1oURaTnkBbR31fSIRCkF/3frNYfp+TbfPfs37gD2pRY/V1yfIw/XwFndBWW4wI8
+h9uuywGOwvNmxoVF9ALGOrVisq/6nL+k5tSAMJjzDbaTj6nU2DbysPyKyiyhFTOV
+MdrAG/LuYpmGYz+/3ZMqg6h2uRMft85OQoWPIucuGvKVCbIFtUROd6EgvanyTgp9
+UK31BQ1FT0Zx/Sg+U/sE2C3XZR1KG/rPO7AxmjVuyIsG0wCR8pQIZUyxNAYAeoni
+8McDWc/V1uinMrPmmECGxc0nEovMe863ETxiYAcjPitAbpSACW22s293bzUIUPsC
+h8U+iQIDAQABo0IwQDAdBgNVHQ4EFgQUW/hNT7KlhtQ60vFjmqC+CfZXt94wDgYD
+VR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEB
+AKChOBZmLqdWHyGcBvod7bkixTgm2E5P7KN/ed5GIaGHd48HCJqypMWvDzKYC3xm
+KbabfSVSSUOrTC4rbnpwrxYO4wJs+0LmGJ1F2FXI6Dvd5+H0LgscNFxsWEr7jIhQ
+X5Ucv+2rIrVls4W6ng+4reV6G4pQOh29Dbx7VFALuUKvVaAYga1lme++5Jy/xIWr
+QbJUb9wlze144o4MjQlJ3WN7WmmWAiGovVJZ6X01y8hSyn+B/tlr0/cR7SXf+Of5
+pPpyl4RTDaXQMhhRdlkUbA/r7F+AjHVDg8OFmP9Mni0N5HeDk061lgeLKBObjBmN
+QSdJQO7e5iNEOdyhIta6A/I=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd.
+# Subject: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd.
+# Label: "Microsec e-Szigno Root CA 2009"
+# Serial: 14014712776195784473
+# MD5 Fingerprint: f8:49:f4:03:bc:44:2d:83:be:48:69:7d:29:64:fc:b1
+# SHA1 Fingerprint: 89:df:74:fe:5c:f4:0f:4a:80:f9:e3:37:7d:54:da:91:e1:01:31:8e
+# SHA256 Fingerprint: 3c:5f:81:fe:a5:fa:b8:2c:64:bf:a2:ea:ec:af:cd:e8:e0:77:fc:86:20:a7:ca:e5:37:16:3d:f3:6e:db:f3:78
+-----BEGIN CERTIFICATE-----
+MIIECjCCAvKgAwIBAgIJAMJ+QwRORz8ZMA0GCSqGSIb3DQEBCwUAMIGCMQswCQYD
+VQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0
+ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3ppZ25vIFJvb3QgQ0EgMjAwOTEfMB0G
+CSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5odTAeFw0wOTA2MTYxMTMwMThaFw0y
+OTEyMzAxMTMwMThaMIGCMQswCQYDVQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3Qx
+FjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3pp
+Z25vIFJvb3QgQ0EgMjAwOTEfMB0GCSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5o
+dTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOn4j/NjrdqG2KfgQvvP
+kd6mJviZpWNwrZuuyjNAfW2WbqEORO7hE52UQlKavXWFdCyoDh2Tthi3jCyoz/tc
+cbna7P7ofo/kLx2yqHWH2Leh5TvPmUpG0IMZfcChEhyVbUr02MelTTMuhTlAdX4U
+fIASmFDHQWe4oIBhVKZsTh/gnQ4H6cm6M+f+wFUoLAKApxn1ntxVUwOXewdI/5n7
+N4okxFnMUBBjjqqpGrCEGob5X7uxUG6k0QrM1XF+H6cbfPVTbiJfyyvm1HxdrtbC
+xkzlBQHZ7Vf8wSN5/PrIJIOV87VqUQHQd9bpEqH5GoP7ghu5sJf0dgYzQ0mg/wu1
++rUCAwEAAaOBgDB+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G
+A1UdDgQWBBTLD8bfQkPMPcu1SCOhGnqmKrs0aDAfBgNVHSMEGDAWgBTLD8bfQkPM
+Pcu1SCOhGnqmKrs0aDAbBgNVHREEFDASgRBpbmZvQGUtc3ppZ25vLmh1MA0GCSqG
+SIb3DQEBCwUAA4IBAQDJ0Q5eLtXMs3w+y/w9/w0olZMEyL/azXm4Q5DwpL7v8u8h
+mLzU1F0G9u5C7DBsoKqpyvGvivo/C3NqPuouQH4frlRheesuCDfXI/OMn74dseGk
+ddug4lQUsbocKaQY9hK6ohQU4zE1yED/t+AFdlfBHFny+L/k7SViXITwfn4fs775
+tyERzAMBVnCnEJIeGzSBHq2cGsMEPO0CYdYeBvNfOofyK/FFh+U9rNHHV4S9a67c
+2Pm2G2JwCz02yULyMtd6YebS2z3PyKnJm9zbWETXbzivf3jTo60adbocwTZ8jx5t
+HMN1Rq41Bab2XD0h7lbwyYIiLXpUq3DDfSJlgnCW
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3
+# Label: "GlobalSign Root CA - R3"
+# Serial: 4835703278459759426209954
+# MD5 Fingerprint: c5:df:b8:49:ca:05:13:55:ee:2d:ba:1a:c3:3e:b0:28
+# SHA1 Fingerprint: d6:9b:56:11:48:f0:1c:77:c5:45:78:c1:09:26:df:5b:85:69:76:ad
+# SHA256 Fingerprint: cb:b5:22:d7:b7:f1:27:ad:6a:01:13:86:5b:df:1c:d4:10:2e:7d:07:59:af:63:5a:7c:f4:72:0d:c9:63:c5:3b
+-----BEGIN CERTIFICATE-----
+MIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4G
+A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNp
+Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4
+MTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEG
+A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWtiHL8
+RgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsT
+gHeMCOFJ0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmm
+KPZpO/bLyCiR5Z2KYVc3rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zd
+QQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjlOCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZ
+XriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2xmmFghcCAwEAAaNCMEAw
+DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI/wS3+o
+LkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZU
+RUm7lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMp
+jjM5RcOO5LlXbKr8EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK
+6fBdRoyV3XpYKBovHd7NADdBj+1EbddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQX
+mcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18YIvDQVETI53O9zJrlAGomecs
+Mx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH
+WD9f
+-----END CERTIFICATE-----
+
+# Issuer: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
+# Subject: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
+# Label: "Autoridad de Certificacion Firmaprofesional CIF A62634068"
+# Serial: 6047274297262753887
+# MD5 Fingerprint: 73:3a:74:7a:ec:bb:a3:96:a6:c2:e4:e2:c8:9b:c0:c3
+# SHA1 Fingerprint: ae:c5:fb:3f:c8:e1:bf:c4:e5:4f:03:07:5a:9a:e8:00:b7:f7:b6:fa
+# SHA256 Fingerprint: 04:04:80:28:bf:1f:28:64:d4:8f:9a:d4:d8:32:94:36:6a:82:88:56:55:3f:3b:14:30:3f:90:14:7f:5d:40:ef
+-----BEGIN CERTIFICATE-----
+MIIGFDCCA/ygAwIBAgIIU+w77vuySF8wDQYJKoZIhvcNAQEFBQAwUTELMAkGA1UE
+BhMCRVMxQjBABgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1h
+cHJvZmVzaW9uYWwgQ0lGIEE2MjYzNDA2ODAeFw0wOTA1MjAwODM4MTVaFw0zMDEy
+MzEwODM4MTVaMFExCzAJBgNVBAYTAkVTMUIwQAYDVQQDDDlBdXRvcmlkYWQgZGUg
+Q2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBBNjI2MzQwNjgwggIi
+MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDDUtd9
+thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQM
+cas9UX4PB99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefG
+L9ItWY16Ck6WaVICqjaY7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15i
+NA9wBj4gGFrO93IbJWyTdBSTo3OxDqqHECNZXyAFGUftaI6SEspd/NYrspI8IM/h
+X68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyIplD9amML9ZMWGxmPsu2b
+m8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctXMbScyJCy
+Z/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirja
+EbsXLZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/T
+KI8xWVvTyQKmtFLKbpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF
+6NkBiDkal4ZkQdU7hwxu+g/GvUgUvzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVh
+OSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMBIGA1UdEwEB/wQIMAYBAf8CAQEwDgYD
+VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBRlzeurNR4APn7VdMActHNHDhpkLzCBpgYD
+VR0gBIGeMIGbMIGYBgRVHSAAMIGPMC8GCCsGAQUFBwIBFiNodHRwOi8vd3d3LmZp
+cm1hcHJvZmVzaW9uYWwuY29tL2NwczBcBggrBgEFBQcCAjBQHk4AUABhAHMAZQBv
+ACAAZABlACAAbABhACAAQgBvAG4AYQBuAG8AdgBhACAANAA3ACAAQgBhAHIAYwBl
+AGwAbwBuAGEAIAAwADgAMAAxADcwDQYJKoZIhvcNAQEFBQADggIBABd9oPm03cXF
+661LJLWhAqvdpYhKsg9VSytXjDvlMd3+xDLx51tkljYyGOylMnfX40S2wBEqgLk9
+am58m9Ot/MPWo+ZkKXzR4Tgegiv/J2Wv+xYVxC5xhOW1//qkR71kMrv2JYSiJ0L1
+ILDCExARzRAVukKQKtJE4ZYm6zFIEv0q2skGz3QeqUvVhyj5eTSSPi5E6PaPT481
+PyWzOdxjKpBrIF/EUhJOlywqrJ2X3kjyo2bbwtKDlaZmp54lD+kLM5FlClrD2VQS
+3a/DTg4fJl4N3LON7NWBcN7STyQF82xO9UxJZo3R/9ILJUFI/lGExkKvgATP0H5k
+SeTy36LssUzAKh3ntLFlosS88Zj0qnAHY7S42jtM+kAiMFsRpvAFDsYCA0irhpuF
+3dvd6qJ2gHN99ZwExEWN57kci57q13XRcrHedUTnQn3iV2t93Jm8PYMo6oCTjcVM
+ZcFwgbg4/EMxsvYDNEeyrPsiBsse3RdHHF9mudMaotoRsaS8I8nkvof/uZS2+F0g
+StRf571oe2XyFR7SOqkt6dhrJKyXWERHrVkY8SFlcN7ONGCoQPHzPKTDKCOM/icz
+Q0CgFzzr6juwcqajuUpLXhZI9LK8yIySxZ2frHI2vDSANGupi5LAuBft7HZT9SQB
+jLMi6Et8Vcad+qMUu2WFbm5PEn4KPJ2V
+-----END CERTIFICATE-----
+
+# Issuer: CN=Izenpe.com O=IZENPE S.A.
+# Subject: CN=Izenpe.com O=IZENPE S.A.
+# Label: "Izenpe.com"
+# Serial: 917563065490389241595536686991402621
+# MD5 Fingerprint: a6:b0:cd:85:80:da:5c:50:34:a3:39:90:2f:55:67:73
+# SHA1 Fingerprint: 2f:78:3d:25:52:18:a7:4a:65:39:71:b5:2c:a2:9c:45:15:6f:e9:19
+# SHA256 Fingerprint: 25:30:cc:8e:98:32:15:02:ba:d9:6f:9b:1f:ba:1b:09:9e:2d:29:9e:0f:45:48:bb:91:4f:36:3b:c0:d4:53:1f
+-----BEGIN CERTIFICATE-----
+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
+-----END CERTIFICATE-----
+
+# Issuer: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc.
+# Subject: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc.
+# Label: "Go Daddy Root Certificate Authority - G2"
+# Serial: 0
+# MD5 Fingerprint: 80:3a:bc:22:c1:e6:fb:8d:9b:3b:27:4a:32:1b:9a:01
+# SHA1 Fingerprint: 47:be:ab:c9:22:ea:e8:0e:78:78:34:62:a7:9f:45:c2:54:fd:e6:8b
+# SHA256 Fingerprint: 45:14:0b:32:47:eb:9c:c8:c5:b4:f0:d7:b5:30:91:f7:32:92:08:9e:6e:5a:63:e2:74:9d:d3:ac:a9:19:8e:da
+-----BEGIN CERTIFICATE-----
+MIIDxTCCAq2gAwIBAgIBADANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMCVVMx
+EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoT
+EUdvRGFkZHkuY29tLCBJbmMuMTEwLwYDVQQDEyhHbyBEYWRkeSBSb290IENlcnRp
+ZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIz
+NTk1OVowgYMxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQH
+EwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjExMC8GA1UE
+AxMoR28gRGFkZHkgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIw
+DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL9xYgjx+lk09xvJGKP3gElY6SKD
+E6bFIEMBO4Tx5oVJnyfq9oQbTqC023CYxzIBsQU+B07u9PpPL1kwIuerGVZr4oAH
+/PMWdYA5UXvl+TW2dE6pjYIT5LY/qQOD+qK+ihVqf94Lw7YZFAXK6sOoBJQ7Rnwy
+DfMAZiLIjWltNowRGLfTshxgtDj6AozO091GB94KPutdfMh8+7ArU6SSYmlRJQVh
+GkSBjCypQ5Yj36w6gZoOKcUcqeldHraenjAKOc7xiID7S13MMuyFYkMlNAJWJwGR
+tDtwKj9useiciAF9n9T521NtYJ2/LOdYq7hfRvzOxBsDPAnrSTFcaUaz4EcCAwEA
+AaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE
+FDqahQcQZyi27/a9BUFuIMGU2g/eMA0GCSqGSIb3DQEBCwUAA4IBAQCZ21151fmX
+WWcDYfF+OwYxdS2hII5PZYe096acvNjpL9DbWu7PdIxztDhC2gV7+AJ1uP2lsdeu
+9tfeE8tTEH6KRtGX+rcuKxGrkLAngPnon1rpN5+r5N9ss4UXnT3ZJE95kTXWXwTr
+gIOrmgIttRD02JDHBHNA7XIloKmf7J6raBKZV8aPEjoJpL1E/QYVN8Gb5DKj7Tjo
+2GTzLH4U/ALqn83/B2gX2yKQOC16jdFU8WnjXzPKej17CuPKf1855eJ1usV2GDPO
+LPAvTK33sefOT6jEm0pUBsV/fdUID+Ic/n4XuKxe9tQWskMJDE32p2u0mYRlynqI
+4uJEvlz36hz1
+-----END CERTIFICATE-----
+
+# Issuer: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Subject: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Label: "Starfield Root Certificate Authority - G2"
+# Serial: 0
+# MD5 Fingerprint: d6:39:81:c6:52:7e:96:69:fc:fc:ca:66:ed:05:f2:96
+# SHA1 Fingerprint: b5:1c:06:7c:ee:2b:0c:3d:f8:55:ab:2d:92:f4:fe:39:d4:e7:0f:0e
+# SHA256 Fingerprint: 2c:e1:cb:0b:f9:d2:f9:e1:02:99:3f:be:21:51:52:c3:b2:dd:0c:ab:de:1c:68:e5:31:9b:83:91:54:db:b7:f5
+-----BEGIN CERTIFICATE-----
+MIID3TCCAsWgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBjzELMAkGA1UEBhMCVVMx
+EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT
+HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAMTKVN0YXJmaWVs
+ZCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAw
+MFoXDTM3MTIzMTIzNTk1OVowgY8xCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6
+b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFyZmllbGQgVGVj
+aG5vbG9naWVzLCBJbmMuMTIwMAYDVQQDEylTdGFyZmllbGQgUm9vdCBDZXJ0aWZp
+Y2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC
+ggEBAL3twQP89o/8ArFvW59I2Z154qK3A2FWGMNHttfKPTUuiUP3oWmb3ooa/RMg
+nLRJdzIpVv257IzdIvpy3Cdhl+72WoTsbhm5iSzchFvVdPtrX8WJpRBSiUZV9Lh1
+HOZ/5FSuS/hVclcCGfgXcVnrHigHdMWdSL5stPSksPNkN3mSwOxGXn/hbVNMYq/N
+Hwtjuzqd+/x5AJhhdM8mgkBj87JyahkNmcrUDnXMN/uLicFZ8WJ/X7NfZTD4p7dN
+dloedl40wOiWVpmKs/B/pM293DIxfJHP4F8R+GuqSVzRmZTRouNjWwl2tVZi4Ut0
+HZbUJtQIBFnQmA4O5t78w+wfkPECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAO
+BgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFHwMMh+n2TB/xH1oo2Kooc6rB1snMA0G
+CSqGSIb3DQEBCwUAA4IBAQARWfolTwNvlJk7mh+ChTnUdgWUXuEok21iXQnCoKjU
+sHU48TRqneSfioYmUeYs0cYtbpUgSpIB7LiKZ3sx4mcujJUDJi5DnUox9g61DLu3
+4jd/IroAow57UvtruzvE03lRTs2Q9GcHGcg8RnoNAX3FWOdt5oUwF5okxBDgBPfg
+8n/Uqgr/Qh037ZTlZFkSIHc40zI+OIF1lnP6aI+xy84fxez6nH7PfrHxBy22/L/K
+pL/QlwVKvOoYKAKQvVR4CSFx09F9HdkWsKlhPdAKACL8x3vLCWRFCztAgfd9fDL1
+mMpYjn0q7pBZc2T5NnReJaH1ZgUufzkVqSr7UIuOhWn0
+-----END CERTIFICATE-----
+
+# Issuer: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Subject: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Label: "Starfield Services Root Certificate Authority - G2"
+# Serial: 0
+# MD5 Fingerprint: 17:35:74:af:7b:61:1c:eb:f4:f9:3c:e2:ee:40:f9:a2
+# SHA1 Fingerprint: 92:5a:8f:8d:2c:6d:04:e0:66:5f:59:6a:ff:22:d8:63:e8:25:6f:3f
+# SHA256 Fingerprint: 56:8d:69:05:a2:c8:87:08:a4:b3:02:51:90:ed:cf:ed:b1:97:4a:60:6a:13:c6:e5:29:0f:cb:2a:e6:3e:da:b5
+-----BEGIN CERTIFICATE-----
+MIID7zCCAtegAwIBAgIBADANBgkqhkiG9w0BAQsFADCBmDELMAkGA1UEBhMCVVMx
+EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT
+HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xOzA5BgNVBAMTMlN0YXJmaWVs
+ZCBTZXJ2aWNlcyBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5
+MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgZgxCzAJBgNVBAYTAlVTMRAwDgYD
+VQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFy
+ZmllbGQgVGVjaG5vbG9naWVzLCBJbmMuMTswOQYDVQQDEzJTdGFyZmllbGQgU2Vy
+dmljZXMgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBANUMOsQq+U7i9b4Zl1+OiFOxHz/Lz58gE20p
+OsgPfTz3a3Y4Y9k2YKibXlwAgLIvWX/2h/klQ4bnaRtSmpDhcePYLQ1Ob/bISdm2
+8xpWriu2dBTrz/sm4xq6HZYuajtYlIlHVv8loJNwU4PahHQUw2eeBGg6345AWh1K
+Ts9DkTvnVtYAcMtS7nt9rjrnvDH5RfbCYM8TWQIrgMw0R9+53pBlbQLPLJGmpufe
+hRhJfGZOozptqbXuNC66DQO4M99H67FrjSXZm86B0UVGMpZwh94CDklDhbZsc7tk
+6mFBrMnUVN+HL8cisibMn1lUaJ/8viovxFUcdUBgF4UCVTmLfwUCAwEAAaNCMEAw
+DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJxfAN+q
+AdcwKziIorhtSpzyEZGDMA0GCSqGSIb3DQEBCwUAA4IBAQBLNqaEd2ndOxmfZyMI
+bw5hyf2E3F/YNoHN2BtBLZ9g3ccaaNnRbobhiCPPE95Dz+I0swSdHynVv/heyNXB
+ve6SbzJ08pGCL72CQnqtKrcgfU28elUSwhXqvfdqlS5sdJ/PHLTyxQGjhdByPq1z
+qwubdQxtRbeOlKyWN7Wg0I8VRw7j6IPdj/3vQQF3zCepYoUz8jcI73HPdwbeyBkd
+iEDPfUYd/x7H4c7/I9vG+o1VTqkC50cRRj70/b17KSa7qWFiNyi2LSr2EIZkyXCn
+0q23KXB56jzaYyWf/Wi3MOxw+3WKt21gZ7IeyLnp2KhvAotnDU0mV3HaIPzBSlCN
+sSi6
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Commercial O=AffirmTrust
+# Subject: CN=AffirmTrust Commercial O=AffirmTrust
+# Label: "AffirmTrust Commercial"
+# Serial: 8608355977964138876
+# MD5 Fingerprint: 82:92:ba:5b:ef:cd:8a:6f:a6:3d:55:f9:84:f6:d6:b7
+# SHA1 Fingerprint: f9:b5:b6:32:45:5f:9c:be:ec:57:5f:80:dc:e9:6e:2c:c7:b2:78:b7
+# SHA256 Fingerprint: 03:76:ab:1d:54:c5:f9:80:3c:e4:b2:e2:01:a0:ee:7e:ef:7b:57:b6:36:e8:a9:3c:9b:8d:48:60:c9:6f:5f:a7
+-----BEGIN CERTIFICATE-----
+MIIDTDCCAjSgAwIBAgIId3cGJyapsXwwDQYJKoZIhvcNAQELBQAwRDELMAkGA1UE
+BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz
+dCBDb21tZXJjaWFsMB4XDTEwMDEyOTE0MDYwNloXDTMwMTIzMTE0MDYwNlowRDEL
+MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp
+cm1UcnVzdCBDb21tZXJjaWFsMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
+AQEA9htPZwcroRX1BiLLHwGy43NFBkRJLLtJJRTWzsO3qyxPxkEylFf6EqdbDuKP
+Hx6GGaeqtS25Xw2Kwq+FNXkyLbscYjfysVtKPcrNcV/pQr6U6Mje+SJIZMblq8Yr
+ba0F8PrVC8+a5fBQpIs7R6UjW3p6+DM/uO+Zl+MgwdYoic+U+7lF7eNAFxHUdPAL
+MeIrJmqbTFeurCA+ukV6BfO9m2kVrn1OIGPENXY6BwLJN/3HR+7o8XYdcxXyl6S1
+yHp52UKqK39c/s4mT6NmgTWvRLpUHhwwMmWd5jyTXlBOeuM61G7MGvv50jeuJCqr
+VwMiKA1JdX+3KNp1v47j3A55MQIDAQABo0IwQDAdBgNVHQ4EFgQUnZPGU4teyq8/
+nx4P5ZmVvCT2lI8wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ
+KoZIhvcNAQELBQADggEBAFis9AQOzcAN/wr91LoWXym9e2iZWEnStB03TX8nfUYG
+XUPGhi4+c7ImfU+TqbbEKpqrIZcUsd6M06uJFdhrJNTxFq7YpFzUf1GO7RgBsZNj
+vbz4YYCanrHOQnDiqX0GJX0nof5v7LMeJNrjS1UaADs1tDvZ110w/YETifLCBivt
+Z8SOyUOyXGsViQK8YvxO8rUzqrJv0wqiUOP2O+guRMLbZjipM1ZI8W0bM40NjD9g
+N53Tym1+NH4Nn3J2ixufcv1SNUFFApYvHLKac0khsUlHRUe072o0EclNmsxZt9YC
+nlpOZbWUrhvfKbAW8b8Angc6F2S1BLUjIZkKlTuXfO8=
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Networking O=AffirmTrust
+# Subject: CN=AffirmTrust Networking O=AffirmTrust
+# Label: "AffirmTrust Networking"
+# Serial: 8957382827206547757
+# MD5 Fingerprint: 42:65:ca:be:01:9a:9a:4c:a9:8c:41:49:cd:c0:d5:7f
+# SHA1 Fingerprint: 29:36:21:02:8b:20:ed:02:f5:66:c5:32:d1:d6:ed:90:9f:45:00:2f
+# SHA256 Fingerprint: 0a:81:ec:5a:92:97:77:f1:45:90:4a:f3:8d:5d:50:9f:66:b5:e2:c5:8f:cd:b5:31:05:8b:0e:17:f3:f0:b4:1b
+-----BEGIN CERTIFICATE-----
+MIIDTDCCAjSgAwIBAgIIfE8EORzUmS0wDQYJKoZIhvcNAQEFBQAwRDELMAkGA1UE
+BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz
+dCBOZXR3b3JraW5nMB4XDTEwMDEyOTE0MDgyNFoXDTMwMTIzMTE0MDgyNFowRDEL
+MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp
+cm1UcnVzdCBOZXR3b3JraW5nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
+AQEAtITMMxcua5Rsa2FSoOujz3mUTOWUgJnLVWREZY9nZOIG41w3SfYvm4SEHi3y
+YJ0wTsyEheIszx6e/jarM3c1RNg1lho9Nuh6DtjVR6FqaYvZ/Ls6rnla1fTWcbua
+kCNrmreIdIcMHl+5ni36q1Mr3Lt2PpNMCAiMHqIjHNRqrSK6mQEubWXLviRmVSRL
+QESxG9fhwoXA3hA/Pe24/PHxI1Pcv2WXb9n5QHGNfb2V1M6+oF4nI979ptAmDgAp
+6zxG8D1gvz9Q0twmQVGeFDdCBKNwV6gbh+0t+nvujArjqWaJGctB+d1ENmHP4ndG
+yH329JKBNv3bNPFyfvMMFr20FQIDAQABo0IwQDAdBgNVHQ4EFgQUBx/S55zawm6i
+QLSwelAQUHTEyL0wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ
+KoZIhvcNAQEFBQADggEBAIlXshZ6qML91tmbmzTCnLQyFE2npN/svqe++EPbkTfO
+tDIuUFUaNU52Q3Eg75N3ThVwLofDwR1t3Mu1J9QsVtFSUzpE0nPIxBsFZVpikpzu
+QY0x2+c06lkh1QF612S4ZDnNye2v7UsDSKegmQGA3GWjNq5lWUhPgkvIZfFXHeVZ
+Lgo/bNjR9eUJtGxUAArgFU2HdW23WJZa3W3SAKD0m0i+wzekujbgfIeFlxoVot4u
+olu9rxj5kFDNcFn4J2dHy8egBzp90SxdbBk6ZrV9/ZFvgrG+CJPbFEfxojfHRZ48
+x3evZKiT3/Zpg4Jg8klCNO1aAFSFHBY2kgxc+qatv9s=
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Premium O=AffirmTrust
+# Subject: CN=AffirmTrust Premium O=AffirmTrust
+# Label: "AffirmTrust Premium"
+# Serial: 7893706540734352110
+# MD5 Fingerprint: c4:5d:0e:48:b6:ac:28:30:4e:0a:bc:f9:38:16:87:57
+# SHA1 Fingerprint: d8:a6:33:2c:e0:03:6f:b1:85:f6:63:4f:7d:6a:06:65:26:32:28:27
+# SHA256 Fingerprint: 70:a7:3f:7f:37:6b:60:07:42:48:90:45:34:b1:14:82:d5:bf:0e:69:8e:cc:49:8d:f5:25:77:eb:f2:e9:3b:9a
+-----BEGIN CERTIFICATE-----
+MIIFRjCCAy6gAwIBAgIIbYwURrGmCu4wDQYJKoZIhvcNAQEMBQAwQTELMAkGA1UE
+BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1UcnVz
+dCBQcmVtaXVtMB4XDTEwMDEyOTE0MTAzNloXDTQwMTIzMTE0MTAzNlowQTELMAkG
+A1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1U
+cnVzdCBQcmVtaXVtMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxBLf
+qV/+Qd3d9Z+K4/as4Tx4mrzY8H96oDMq3I0gW64tb+eT2TZwamjPjlGjhVtnBKAQ
+JG9dKILBl1fYSCkTtuG+kU3fhQxTGJoeJKJPj/CihQvL9Cl/0qRY7iZNyaqoe5rZ
++jjeRFcV5fiMyNlI4g0WJx0eyIOFJbe6qlVBzAMiSy2RjYvmia9mx+n/K+k8rNrS
+s8PhaJyJ+HoAVt70VZVs+7pk3WKL3wt3MutizCaam7uqYoNMtAZ6MMgpv+0GTZe5
+HMQxK9VfvFMSF5yZVylmd2EhMQcuJUmdGPLu8ytxjLW6OQdJd/zvLpKQBY0tL3d7
+70O/Nbua2Plzpyzy0FfuKE4mX4+QaAkvuPjcBukumj5Rp9EixAqnOEhss/n/fauG
+V+O61oV4d7pD6kh/9ti+I20ev9E2bFhc8e6kGVQa9QPSdubhjL08s9NIS+LI+H+S
+qHZGnEJlPqQewQcDWkYtuJfzt9WyVSHvutxMAJf7FJUnM7/oQ0dG0giZFmA7mn7S
+5u046uwBHjxIVkkJx0w3AJ6IDsBz4W9m6XJHMD4Q5QsDyZpCAGzFlH5hxIrff4Ia
+C1nEWTJ3s7xgaVY5/bQGeyzWZDbZvUjthB9+pSKPKrhC9IK31FOQeE4tGv2Bb0TX
+OwF0lkLgAOIua+rF7nKsu7/+6qqo+Nz2snmKtmcCAwEAAaNCMEAwHQYDVR0OBBYE
+FJ3AZ6YMItkm9UWrpmVSESfYRaxjMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/
+BAQDAgEGMA0GCSqGSIb3DQEBDAUAA4ICAQCzV00QYk465KzquByvMiPIs0laUZx2
+KI15qldGF9X1Uva3ROgIRL8YhNILgM3FEv0AVQVhh0HctSSePMTYyPtwni94loMg
+Nt58D2kTiKV1NpgIpsbfrM7jWNa3Pt668+s0QNiigfV4Py/VpfzZotReBA4Xrf5B
+8OWycvpEgjNC6C1Y91aMYj+6QrCcDFx+LmUmXFNPALJ4fqENmS2NuB2OosSw/WDQ
+MKSOyARiqcTtNd56l+0OOF6SL5Nwpamcb6d9Ex1+xghIsV5n61EIJenmJWtSKZGc
+0jlzCFfemQa0W50QBuHCAKi4HEoCChTQwUHK+4w1IX2COPKpVJEZNZOUbWo6xbLQ
+u4mGk+ibyQ86p3q4ofB4Rvr8Ny/lioTz3/4E2aFooC8k4gmVBtWVyuEklut89pMF
+u+1z6S3RdTnX5yTb2E5fQ4+e0BQ5v1VwSJlXMbSc7kqYA5YwH2AG7hsj/oFgIxpH
+YoWlzBk0gG+zrBrjn/B7SK3VAdlntqlyk+otZrWyuOQ9PLLvTIzq6we/qzWaVYa8
+GKa1qF60g2xraUDTn9zxw2lrueFtCfTxqlB2Cnp9ehehVZZCmTEJ3WARjQUwfuaO
+RtGdFNrHF+QFlozEJLUbzxQHskD4o55BhrwE0GuWyCqANP2/7waj3VjFhT0+j/6e
+KeC2uAloGRwYQw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Premium ECC O=AffirmTrust
+# Subject: CN=AffirmTrust Premium ECC O=AffirmTrust
+# Label: "AffirmTrust Premium ECC"
+# Serial: 8401224907861490260
+# MD5 Fingerprint: 64:b0:09:55:cf:b1:d5:99:e2:be:13:ab:a6:5d:ea:4d
+# SHA1 Fingerprint: b8:23:6b:00:2f:1d:16:86:53:01:55:6c:11:a4:37:ca:eb:ff:c3:bb
+# SHA256 Fingerprint: bd:71:fd:f6:da:97:e4:cf:62:d1:64:7a:dd:25:81:b0:7d:79:ad:f8:39:7e:b4:ec:ba:9c:5e:84:88:82:14:23
+-----BEGIN CERTIFICATE-----
+MIIB/jCCAYWgAwIBAgIIdJclisc/elQwCgYIKoZIzj0EAwMwRTELMAkGA1UEBhMC
+VVMxFDASBgNVBAoMC0FmZmlybVRydXN0MSAwHgYDVQQDDBdBZmZpcm1UcnVzdCBQ
+cmVtaXVtIEVDQzAeFw0xMDAxMjkxNDIwMjRaFw00MDEyMzExNDIwMjRaMEUxCzAJ
+BgNVBAYTAlVTMRQwEgYDVQQKDAtBZmZpcm1UcnVzdDEgMB4GA1UEAwwXQWZmaXJt
+VHJ1c3QgUHJlbWl1bSBFQ0MwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQNMF4bFZ0D
+0KF5Nbc6PJJ6yhUczWLznCZcBz3lVPqj1swS6vQUX+iOGasvLkjmrBhDeKzQN8O9
+ss0s5kfiGuZjuD0uL3jET9v0D6RoTFVya5UdThhClXjMNzyR4ptlKymjQjBAMB0G
+A1UdDgQWBBSaryl6wBE1NSZRMADDav5A1a7WPDAPBgNVHRMBAf8EBTADAQH/MA4G
+A1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNnADBkAjAXCfOHiFBar8jAQr9HX/Vs
+aobgxCd05DhT1wV/GzTjxi+zygk8N53X57hG8f2h4nECMEJZh0PUUd+60wkyWs6I
+flc9nF9Ca/UHLbXwgpP5WW+uZPpY5Yse42O+tYHNbwKMeQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Subject: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Label: "Certum Trusted Network CA"
+# Serial: 279744
+# MD5 Fingerprint: d5:e9:81:40:c5:18:69:fc:46:2c:89:75:62:0f:aa:78
+# SHA1 Fingerprint: 07:e0:32:e0:20:b7:2c:3f:19:2f:06:28:a2:59:3a:19:a7:0f:06:9e
+# SHA256 Fingerprint: 5c:58:46:8d:55:f5:8e:49:7e:74:39:82:d2:b5:00:10:b6:d1:65:37:4a:cf:83:a7:d4:a3:2d:b7:68:c4:40:8e
+-----BEGIN CERTIFICATE-----
+MIIDuzCCAqOgAwIBAgIDBETAMA0GCSqGSIb3DQEBBQUAMH4xCzAJBgNVBAYTAlBM
+MSIwIAYDVQQKExlVbml6ZXRvIFRlY2hub2xvZ2llcyBTLkEuMScwJQYDVQQLEx5D
+ZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxIjAgBgNVBAMTGUNlcnR1bSBU
+cnVzdGVkIE5ldHdvcmsgQ0EwHhcNMDgxMDIyMTIwNzM3WhcNMjkxMjMxMTIwNzM3
+WjB+MQswCQYDVQQGEwJQTDEiMCAGA1UEChMZVW5pemV0byBUZWNobm9sb2dpZXMg
+Uy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MSIw
+IAYDVQQDExlDZXJ0dW0gVHJ1c3RlZCBOZXR3b3JrIENBMIIBIjANBgkqhkiG9w0B
+AQEFAAOCAQ8AMIIBCgKCAQEA4/t9o3K6wvDJFIf1awFO4W5AB7ptJ11/91sts1rH
+UV+rpDKmYYe2bg+G0jACl/jXaVehGDldamR5xgFZrDwxSjh80gTSSyjoIF87B6LM
+TXPb865Px1bVWqeWifrzq2jUI4ZZJ88JJ7ysbnKDHDBy3+Ci6dLhdHUZvSqeexVU
+BBvXQzmtVSjF4hq79MDkrjhJM8x2hZ85RdKknvISjFH4fOQtf/WsX+sWn7Et0brM
+kUJ3TCXJkDhv2/DM+44el1k+1WBO5gUo7Ul5E0u6SNsv+XLTOcr+H9g0cvW0QM8x
+AcPs3hEtF10fuFDRXhmnad4HMyjKUJX5p1TLVIZQRan5SQIDAQABo0IwQDAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBQIds3LB/8k9sXN7buQvOKEN0Z19zAOBgNV
+HQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQEFBQADggEBAKaorSLOAT2mo/9i0Eidi15y
+sHhE49wcrwn9I0j6vSrEuVUEtRCjjSfeC4Jj0O7eDDd5QVsisrCaQVymcODU0HfL
+I9MA4GxWL+FpDQ3Zqr8hgVDZBqWo/5U30Kr+4rP1mS1FhIrlQgnXdAIv94nYmem8
+J9RHjboNRhx3zxSkHLmkMcScKHQDNP8zGSal6Q10tz6XxnboJ5ajZt3hrvJBW8qY
+VoNzcOSGGtIxQbovvi0TWnZvTuhOgQ4/WwMioBK+ZlgRSssDxLQqKi2WF+A5VLxI
+03YnnZotBqbJ7DnSq9ufmgsnAjUpsUCV5/nonFWIGUbWtzT1fs45mtk48VH3Tyw=
+-----END CERTIFICATE-----
+
+# Issuer: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA
+# Subject: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA
+# Label: "TWCA Root Certification Authority"
+# Serial: 1
+# MD5 Fingerprint: aa:08:8f:f6:f9:7b:b7:f2:b1:a7:1e:9b:ea:ea:bd:79
+# SHA1 Fingerprint: cf:9e:87:6d:d3:eb:fc:42:26:97:a3:b5:a3:7a:a0:76:a9:06:23:48
+# SHA256 Fingerprint: bf:d8:8f:e1:10:1c:41:ae:3e:80:1b:f8:be:56:35:0e:e9:ba:d1:a6:b9:bd:51:5e:dc:5c:6d:5b:87:11:ac:44
+-----BEGIN CERTIFICATE-----
+MIIDezCCAmOgAwIBAgIBATANBgkqhkiG9w0BAQUFADBfMQswCQYDVQQGEwJUVzES
+MBAGA1UECgwJVEFJV0FOLUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFU
+V0NBIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwODI4MDcyNDMz
+WhcNMzAxMjMxMTU1OTU5WjBfMQswCQYDVQQGEwJUVzESMBAGA1UECgwJVEFJV0FO
+LUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFUV0NBIFJvb3QgQ2VydGlm
+aWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
+AQCwfnK4pAOU5qfeCTiRShFAh6d8WWQUe7UREN3+v9XAu1bihSX0NXIP+FPQQeFE
+AcK0HMMxQhZHhTMidrIKbw/lJVBPhYa+v5guEGcevhEFhgWQxFnQfHgQsIBct+HH
+K3XLfJ+utdGdIzdjp9xCoi2SBBtQwXu4PhvJVgSLL1KbralW6cH/ralYhzC2gfeX
+RfwZVzsrb+RH9JlF/h3x+JejiB03HFyP4HYlmlD4oFT/RJB2I9IyxsOrBr/8+7/z
+rX2SYgJbKdM1o5OaQ2RgXbL6Mv87BK9NQGr5x+PvI/1ry+UPizgN7gr8/g+YnzAx
+3WxSZfmLgb4i4RxYA7qRG4kHAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqOFsmjd6LWvJPelSDGRjjCDWmujANBgkq
+hkiG9w0BAQUFAAOCAQEAPNV3PdrfibqHDAhUaiBQkr6wQT25JmSDCi/oQMCXKCeC
+MErJk/9q56YAf4lCmtYR5VPOL8zy2gXE/uJQxDqGfczafhAJO5I1KlOy/usrBdls
+XebQ79NqZp4VKIV66IIArB6nCWlWQtNoURi+VJq/REG6Sb4gumlc7rh3zc5sH62D
+lhh9DrUUOYTxKOkto557HnpyWoOzeW/vtPzQCqVYT0bf+215WfKEIlKuD8z7fDvn
+aspHYcN6+NOSBB+4IIThNlQWx0DeO4pz3N/GCUzf7Nr/1FNCocnyYh0igzyXxfkZ
+YiesZSLX0zzG5Y6yU8xJzrww/nsOM5D77dIUkR8Hrw==
+-----END CERTIFICATE-----
+
+# Issuer: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2
+# Subject: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2
+# Label: "Security Communication RootCA2"
+# Serial: 0
+# MD5 Fingerprint: 6c:39:7d:a4:0e:55:59:b2:3f:d6:41:b1:12:50:de:43
+# SHA1 Fingerprint: 5f:3b:8c:f2:f8:10:b3:7d:78:b4:ce:ec:19:19:c3:73:34:b9:c7:74
+# SHA256 Fingerprint: 51:3b:2c:ec:b8:10:d4:cd:e5:dd:85:39:1a:df:c6:c2:dd:60:d8:7b:b7:36:d2:b5:21:48:4a:a4:7a:0e:be:f6
+-----BEGIN CERTIFICATE-----
+MIIDdzCCAl+gAwIBAgIBADANBgkqhkiG9w0BAQsFADBdMQswCQYDVQQGEwJKUDEl
+MCMGA1UEChMcU0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UECxMe
+U2VjdXJpdHkgQ29tbXVuaWNhdGlvbiBSb290Q0EyMB4XDTA5MDUyOTA1MDAzOVoX
+DTI5MDUyOTA1MDAzOVowXTELMAkGA1UEBhMCSlAxJTAjBgNVBAoTHFNFQ09NIFRy
+dXN0IFN5c3RlbXMgQ08uLExURC4xJzAlBgNVBAsTHlNlY3VyaXR5IENvbW11bmlj
+YXRpb24gUm9vdENBMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANAV
+OVKxUrO6xVmCxF1SrjpDZYBLx/KWvNs2l9amZIyoXvDjChz335c9S672XewhtUGr
+zbl+dp+++T42NKA7wfYxEUV0kz1XgMX5iZnK5atq1LXaQZAQwdbWQonCv/Q4EpVM
+VAX3NuRFg3sUZdbcDE3R3n4MqzvEFb46VqZab3ZpUql6ucjrappdUtAtCms1FgkQ
+hNBqyjoGADdH5H5XTz+L62e4iKrFvlNVspHEfbmwhRkGeC7bYRr6hfVKkaHnFtWO
+ojnflLhwHyg/i/xAXmODPIMqGplrz95Zajv8bxbXH/1KEOtOghY6rCcMU/Gt1SSw
+awNQwS08Ft1ENCcadfsCAwEAAaNCMEAwHQYDVR0OBBYEFAqFqXdlBZh8QIH4D5cs
+OPEK7DzPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3
+DQEBCwUAA4IBAQBMOqNErLlFsceTfsgLCkLfZOoc7llsCLqJX2rKSpWeeo8HxdpF
+coJxDjrSzG+ntKEju/Ykn8sX/oymzsLS28yN/HH8AynBbF0zX2S2ZTuJbxh2ePXc
+okgfGT+Ok+vx+hfuzU7jBBJV1uXk3fs+BXziHV7Gp7yXT2g69ekuCkO2r1dcYmh8
+t/2jioSgrGK+KwmHNPBqAbubKVY8/gA3zyNs8U6qtnRGEmyR7jTV7JqR50S+kDFy
+1UkC9gLl9B/rfNmWVan/7Ir5mUf/NVoCqgTLiluHcSmRvaS0eg29mvVXIwAHIRc/
+SjnRBUkLp7Y3gaVdjKozXoEofKd9J+sAro03
+-----END CERTIFICATE-----
+
+# Issuer: CN=EC-ACC O=Agencia Catalana de Certificacio (NIF Q-0801176-I) OU=Serveis Publics de Certificacio/Vegeu https://www.catcert.net/verarrel (c)03/Jerarquia Entitats de Certificacio Catalanes
+# Subject: CN=EC-ACC O=Agencia Catalana de Certificacio (NIF Q-0801176-I) OU=Serveis Publics de Certificacio/Vegeu https://www.catcert.net/verarrel (c)03/Jerarquia Entitats de Certificacio Catalanes
+# Label: "EC-ACC"
+# Serial: -23701579247955709139626555126524820479
+# MD5 Fingerprint: eb:f5:9d:29:0d:61:f9:42:1f:7c:c2:ba:6d:e3:15:09
+# SHA1 Fingerprint: 28:90:3a:63:5b:52:80:fa:e6:77:4c:0b:6d:a7:d6:ba:a6:4a:f2:e8
+# SHA256 Fingerprint: 88:49:7f:01:60:2f:31:54:24:6a:e2:8c:4d:5a:ef:10:f1:d8:7e:bb:76:62:6f:4a:e0:b7:f9:5b:a7:96:87:99
+-----BEGIN CERTIFICATE-----
+MIIFVjCCBD6gAwIBAgIQ7is969Qh3hSoYqwE893EATANBgkqhkiG9w0BAQUFADCB
+8zELMAkGA1UEBhMCRVMxOzA5BgNVBAoTMkFnZW5jaWEgQ2F0YWxhbmEgZGUgQ2Vy
+dGlmaWNhY2lvIChOSUYgUS0wODAxMTc2LUkpMSgwJgYDVQQLEx9TZXJ2ZWlzIFB1
+YmxpY3MgZGUgQ2VydGlmaWNhY2lvMTUwMwYDVQQLEyxWZWdldSBodHRwczovL3d3
+dy5jYXRjZXJ0Lm5ldC92ZXJhcnJlbCAoYykwMzE1MDMGA1UECxMsSmVyYXJxdWlh
+IEVudGl0YXRzIGRlIENlcnRpZmljYWNpbyBDYXRhbGFuZXMxDzANBgNVBAMTBkVD
+LUFDQzAeFw0wMzAxMDcyMzAwMDBaFw0zMTAxMDcyMjU5NTlaMIHzMQswCQYDVQQG
+EwJFUzE7MDkGA1UEChMyQWdlbmNpYSBDYXRhbGFuYSBkZSBDZXJ0aWZpY2FjaW8g
+KE5JRiBRLTA4MDExNzYtSSkxKDAmBgNVBAsTH1NlcnZlaXMgUHVibGljcyBkZSBD
+ZXJ0aWZpY2FjaW8xNTAzBgNVBAsTLFZlZ2V1IGh0dHBzOi8vd3d3LmNhdGNlcnQu
+bmV0L3ZlcmFycmVsIChjKTAzMTUwMwYDVQQLEyxKZXJhcnF1aWEgRW50aXRhdHMg
+ZGUgQ2VydGlmaWNhY2lvIENhdGFsYW5lczEPMA0GA1UEAxMGRUMtQUNDMIIBIjAN
+BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsyLHT+KXQpWIR4NA9h0X84NzJB5R
+85iKw5K4/0CQBXCHYMkAqbWUZRkiFRfCQ2xmRJoNBD45b6VLeqpjt4pEndljkYRm
+4CgPukLjbo73FCeTae6RDqNfDrHrZqJyTxIThmV6PttPB/SnCWDaOkKZx7J/sxaV
+HMf5NLWUhdWZXqBIoH7nF2W4onW4HvPlQn2v7fOKSGRdghST2MDk/7NQcvJ29rNd
+QlB50JQ+awwAvthrDk4q7D7SzIKiGGUzE3eeml0aE9jD2z3Il3rucO2n5nzbcc8t
+lGLfbdb1OL4/pYUKGbio2Al1QnDE6u/LDsg0qBIimAy4E5S2S+zw0JDnJwIDAQAB
+o4HjMIHgMB0GA1UdEQQWMBSBEmVjX2FjY0BjYXRjZXJ0Lm5ldDAPBgNVHRMBAf8E
+BTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUoMOLRKo3pUW/l4Ba0fF4
+opvpXY0wfwYDVR0gBHgwdjB0BgsrBgEEAfV4AQMBCjBlMCwGCCsGAQUFBwIBFiBo
+dHRwczovL3d3dy5jYXRjZXJ0Lm5ldC92ZXJhcnJlbDA1BggrBgEFBQcCAjApGidW
+ZWdldSBodHRwczovL3d3dy5jYXRjZXJ0Lm5ldC92ZXJhcnJlbCAwDQYJKoZIhvcN
+AQEFBQADggEBAKBIW4IB9k1IuDlVNZyAelOZ1Vr/sXE7zDkJlF7W2u++AVtd0x7Y
+/X1PzaBB4DSTv8vihpw3kpBWHNzrKQXlxJ7HNd+KDM3FIUPpqojlNcAZQmNaAl6k
+SBg6hW/cnbw/nZzBh7h6YQjpdwt/cKt63dmXLGQehb+8dJahw3oS7AwaboMMPOhy
+Rp/7SNVel+axofjk70YllJyJ22k4vuxcDlbHZVHlUIiIv0LVKz3l+bqeLrPK9HOS
+Agu+TGbrIP65y7WZf+a2E/rKS03Z7lNGBjvGTq2TWoF+bCpLagVFjPIhpDGQh2xl
+nJ2lYJU6Un/10asIbvPuW/mIPX64b24D5EI=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hellenic Academic and Research Institutions RootCA 2011 O=Hellenic Academic and Research Institutions Cert. Authority
+# Subject: CN=Hellenic Academic and Research Institutions RootCA 2011 O=Hellenic Academic and Research Institutions Cert. Authority
+# Label: "Hellenic Academic and Research Institutions RootCA 2011"
+# Serial: 0
+# MD5 Fingerprint: 73:9f:4c:4b:73:5b:79:e9:fa:ba:1c:ef:6e:cb:d5:c9
+# SHA1 Fingerprint: fe:45:65:9b:79:03:5b:98:a1:61:b5:51:2e:ac:da:58:09:48:22:4d
+# SHA256 Fingerprint: bc:10:4f:15:a4:8b:e7:09:dc:a5:42:a7:e1:d4:b9:df:6f:05:45:27:e8:02:ea:a9:2d:59:54:44:25:8a:fe:71
+-----BEGIN CERTIFICATE-----
+MIIEMTCCAxmgAwIBAgIBADANBgkqhkiG9w0BAQUFADCBlTELMAkGA1UEBhMCR1Ix
+RDBCBgNVBAoTO0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1
+dGlvbnMgQ2VydC4gQXV0aG9yaXR5MUAwPgYDVQQDEzdIZWxsZW5pYyBBY2FkZW1p
+YyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25zIFJvb3RDQSAyMDExMB4XDTExMTIw
+NjEzNDk1MloXDTMxMTIwMTEzNDk1MlowgZUxCzAJBgNVBAYTAkdSMUQwQgYDVQQK
+EztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25zIENl
+cnQuIEF1dGhvcml0eTFAMD4GA1UEAxM3SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl
+c2VhcmNoIEluc3RpdHV0aW9ucyBSb290Q0EgMjAxMTCCASIwDQYJKoZIhvcNAQEB
+BQADggEPADCCAQoCggEBAKlTAOMupvaO+mDYLZU++CwqVE7NuYRhlFhPjz2L5EPz
+dYmNUeTDN9KKiE15HrcS3UN4SoqS5tdI1Q+kOilENbgH9mgdVc04UfCMJDGFr4PJ
+fel3r+0ae50X+bOdOFAPplp5kYCvN66m0zH7tSYJnTxa71HFK9+WXesyHgLacEns
+bgzImjeN9/E2YEsmLIKe0HjzDQ9jpFEw4fkrJxIH2Oq9GGKYsFk3fb7u8yBRQlqD
+75O6aRXxYp2fmTmCobd0LovUxQt7L/DICto9eQqakxylKHJzkUOap9FNhYS5qXSP
+FEDH3N6sQWRstBmbAmNtJGSPRLIl6s5ddAxjMlyNh+UCAwEAAaOBiTCBhjAPBgNV
+HRMBAf8EBTADAQH/MAsGA1UdDwQEAwIBBjAdBgNVHQ4EFgQUppFC/RNhSiOeCKQp
+5dgTBCPuQSUwRwYDVR0eBEAwPqA8MAWCAy5ncjAFggMuZXUwBoIELmVkdTAGggQu
+b3JnMAWBAy5ncjAFgQMuZXUwBoEELmVkdTAGgQQub3JnMA0GCSqGSIb3DQEBBQUA
+A4IBAQAf73lB4XtuP7KMhjdCSk4cNx6NZrokgclPEg8hwAOXhiVtXdMiKahsog2p
+6z0GW5k6x8zDmjR/qw7IThzh+uTczQ2+vyT+bOdrwg3IBp5OjWEopmr95fZi6hg8
+TqBTnbI6nOulnJEWtk2C4AwFSKls9cz4y51JtPACpf1wA+2KIaWuE4ZJwzNzvoc7
+dIsXRSZMFpGD/md9zU1jZ/rzAxKWeAaNsWftjj++n08C9bMJL/NMh98qy5V8Acys
+Nnq/onN694/BtZqhFLKPM58N7yLcZnuEvUUXBj08yrl3NI/K6s8/MT7jiOOASSXI
+l7WdmplNsDz4SgCbZN2fOUvRJ9e4
+-----END CERTIFICATE-----
+
+# Issuer: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967
+# Subject: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967
+# Label: "Actalis Authentication Root CA"
+# Serial: 6271844772424770508
+# MD5 Fingerprint: 69:c1:0d:4f:07:a3:1b:c3:fe:56:3d:04:bc:11:f6:a6
+# SHA1 Fingerprint: f3:73:b3:87:06:5a:28:84:8a:f2:f3:4a:ce:19:2b:dd:c7:8e:9c:ac
+# SHA256 Fingerprint: 55:92:60:84:ec:96:3a:64:b9:6e:2a:be:01:ce:0b:a8:6a:64:fb:fe:bc:c7:aa:b5:af:c1:55:b3:7f:d7:60:66
+-----BEGIN CERTIFICATE-----
+MIIFuzCCA6OgAwIBAgIIVwoRl0LE48wwDQYJKoZIhvcNAQELBQAwazELMAkGA1UE
+BhMCSVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8w
+MzM1ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290
+IENBMB4XDTExMDkyMjExMjIwMloXDTMwMDkyMjExMjIwMlowazELMAkGA1UEBhMC
+SVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8wMzM1
+ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290IENB
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAp8bEpSmkLO/lGMWwUKNv
+UTufClrJwkg4CsIcoBh/kbWHuUA/3R1oHwiD1S0eiKD4j1aPbZkCkpAW1V8IbInX
+4ay8IMKx4INRimlNAJZaby/ARH6jDuSRzVju3PvHHkVH3Se5CAGfpiEd9UEtL0z9
+KK3giq0itFZljoZUj5NDKd45RnijMCO6zfB9E1fAXdKDa0hMxKufgFpbOr3JpyI/
+gCczWw63igxdBzcIy2zSekciRDXFzMwujt0q7bd9Zg1fYVEiVRvjRuPjPdA1Yprb
+rxTIW6HMiRvhMCb8oJsfgadHHwTrozmSBp+Z07/T6k9QnBn+locePGX2oxgkg4YQ
+51Q+qDp2JE+BIcXjDwL4k5RHILv+1A7TaLndxHqEguNTVHnd25zS8gebLra8Pu2F
+be8lEfKXGkJh90qX6IuxEAf6ZYGyojnP9zz/GPvG8VqLWeICrHuS0E4UT1lF9gxe
+KF+w6D9Fz8+vm2/7hNN3WpVvrJSEnu68wEqPSpP4RCHiMUVhUE4Q2OM1fEwZtN4F
+v6MGn8i1zeQf1xcGDXqVdFUNaBr8EBtiZJ1t4JWgw5QHVw0U5r0F+7if5t+L4sbn
+fpb2U8WANFAoWPASUHEXMLrmeGO89LKtmyuy/uE5jF66CyCU3nuDuP/jVo23Eek7
+jPKxwV2dpAtMK9myGPW1n0sCAwEAAaNjMGEwHQYDVR0OBBYEFFLYiDrIn3hm7Ynz
+ezhwlMkCAjbQMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUUtiIOsifeGbt
+ifN7OHCUyQICNtAwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQAL
+e3KHwGCmSUyIWOYdiPcUZEim2FgKDk8TNd81HdTtBjHIgT5q1d07GjLukD0R0i70
+jsNjLiNmsGe+b7bAEzlgqqI0JZN1Ut6nna0Oh4lScWoWPBkdg/iaKWW+9D+a2fDz
+WochcYBNy+A4mz+7+uAwTc+G02UQGRjRlwKxK3JCaKygvU5a2hi/a5iB0P2avl4V
+SM0RFbnAKVy06Ij3Pjaut2L9HmLecHgQHEhb2rykOLpn7VU+Xlff1ANATIGk0k9j
+pwlCCRT8AKnCgHNPLsBA2RF7SOp6AsDT6ygBJlh0wcBzIm2Tlf05fbsq4/aC4yyX
+X04fkZT6/iyj2HYauE2yOE+b+h1IYHkm4vP9qdCa6HCPSXrW5b0KDtst842/6+Ok
+fcvHlXHo2qN8xcL4dJIEG4aspCJTQLas/kx2z/uUMsA1n3Y/buWQbqCmJqK4LL7R
+K4X9p2jIugErsWx0Hbhzlefut8cl8ABMALJ+tguLHPPAUJ4lueAI3jZm/zel0btU
+ZCzJJ7VLkn5l/9Mt4blOvH+kQSGQQXemOR/qnuOf0GZvBeyqdn6/axag67XH/JJU
+LysRJyU3eExRarDzzFhdFPFqSBX/wge2sY0PjlxQRrM9vwGYT7JZVEc+NHt4bVaT
+LnPqZih4zR0Uv6CPLy64Lo7yFIrM6bV8+2ydDKXhlg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Buypass Class 2 Root CA O=Buypass AS-983163327
+# Subject: CN=Buypass Class 2 Root CA O=Buypass AS-983163327
+# Label: "Buypass Class 2 Root CA"
+# Serial: 2
+# MD5 Fingerprint: 46:a7:d2:fe:45:fb:64:5a:a8:59:90:9b:78:44:9b:29
+# SHA1 Fingerprint: 49:0a:75:74:de:87:0a:47:fe:58:ee:f6:c7:6b:eb:c6:0b:12:40:99
+# SHA256 Fingerprint: 9a:11:40:25:19:7c:5b:b9:5d:94:e6:3d:55:cd:43:79:08:47:b6:46:b2:3c:df:11:ad:a4:a0:0e:ff:15:fb:48
+-----BEGIN CERTIFICATE-----
+MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd
+MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg
+Q2xhc3MgMiBSb290IENBMB4XDTEwMTAyNjA4MzgwM1oXDTQwMTAyNjA4MzgwM1ow
+TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw
+HgYDVQQDDBdCdXlwYXNzIENsYXNzIDIgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB
+BQADggIPADCCAgoCggIBANfHXvfBB9R3+0Mh9PT1aeTuMgHbo4Yf5FkNuud1g1Lr
+6hxhFUi7HQfKjK6w3Jad6sNgkoaCKHOcVgb/S2TwDCo3SbXlzwx87vFKu3MwZfPV
+L4O2fuPn9Z6rYPnT8Z2SdIrkHJasW4DptfQxh6NR/Md+oW+OU3fUl8FVM5I+GC91
+1K2GScuVr1QGbNgGE41b/+EmGVnAJLqBcXmQRFBoJJRfuLMR8SlBYaNByyM21cHx
+MlAQTn/0hpPshNOOvEu/XAFOBz3cFIqUCqTqc/sLUegTBxj6DvEr0VQVfTzh97QZ
+QmdiXnfgolXsttlpF9U6r0TtSsWe5HonfOV116rLJeffawrbD02TTqigzXsu8lkB
+arcNuAeBfos4GzjmCleZPe4h6KP1DBbdi+w0jpwqHAAVF41og9JwnxgIzRFo1clr
+Us3ERo/ctfPYV3Me6ZQ5BL/T3jjetFPsaRyifsSP5BtwrfKi+fv3FmRmaZ9JUaLi
+FRhnBkp/1Wy1TbMz4GHrXb7pmA8y1x1LPC5aAVKRCfLf6o3YBkBjqhHk/sM3nhRS
+P/TizPJhk9H9Z2vXUq6/aKtAQ6BXNVN48FP4YUIHZMbXb5tMOA1jrGKvNouicwoN
+9SG9dKpN6nIDSdvHXx1iY8f93ZHsM+71bbRuMGjeyNYmsHVee7QHIJihdjK4TWxP
+AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMmAd+BikoL1Rpzz
+uvdMw964o605MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAU18h
+9bqwOlI5LJKwbADJ784g7wbylp7ppHR/ehb8t/W2+xUbP6umwHJdELFx7rxP462s
+A20ucS6vxOOto70MEae0/0qyexAQH6dXQbLArvQsWdZHEIjzIVEpMMpghq9Gqx3t
+OluwlN5E40EIosHsHdb9T7bWR9AUC8rmyrV7d35BH16Dx7aMOZawP5aBQW9gkOLo
++fsicdl9sz1Gv7SEr5AcD48Saq/v7h56rgJKihcrdv6sVIkkLE8/trKnToyokZf7
+KcZ7XC25y2a2t6hbElGFtQl+Ynhw/qlqYLYdDnkM/crqJIByw5c/8nerQyIKx+u2
+DISCLIBrQYoIwOula9+ZEsuK1V6ADJHgJgg2SMX6OBE1/yWDLfJ6v9r9jv6ly0Us
+H8SIU653DtmadsWOLB2jutXsMq7Aqqz30XpN69QH4kj3Io6wpJ9qzo6ysmD0oyLQ
+I+uUWnpp3Q+/QFesa1lQ2aOZ4W7+jQF5JyMV3pKdewlNWudLSDBaGOYKbeaP4NK7
+5t98biGCwWg5TbSYWGZizEqQXsP6JwSxeRV0mcy+rSDeJmAc61ZRpqPq5KM/p/9h
+3PFaTWwyI0PurKju7koSCTxdccK+efrCh2gdC/1cacwG0Jp9VJkqyTkaGa9LKkPz
+Y11aWOIv4x3kqdbQCtCev9eBCfHJxyYNrJgWVqA=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Buypass Class 3 Root CA O=Buypass AS-983163327
+# Subject: CN=Buypass Class 3 Root CA O=Buypass AS-983163327
+# Label: "Buypass Class 3 Root CA"
+# Serial: 2
+# MD5 Fingerprint: 3d:3b:18:9e:2c:64:5a:e8:d5:88:ce:0e:f9:37:c2:ec
+# SHA1 Fingerprint: da:fa:f7:fa:66:84:ec:06:8f:14:50:bd:c7:c2:81:a5:bc:a9:64:57
+# SHA256 Fingerprint: ed:f7:eb:bc:a2:7a:2a:38:4d:38:7b:7d:40:10:c6:66:e2:ed:b4:84:3e:4c:29:b4:ae:1d:5b:93:32:e6:b2:4d
+-----BEGIN CERTIFICATE-----
+MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd
+MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg
+Q2xhc3MgMyBSb290IENBMB4XDTEwMTAyNjA4Mjg1OFoXDTQwMTAyNjA4Mjg1OFow
+TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw
+HgYDVQQDDBdCdXlwYXNzIENsYXNzIDMgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB
+BQADggIPADCCAgoCggIBAKXaCpUWUOOV8l6ddjEGMnqb8RB2uACatVI2zSRHsJ8Y
+ZLya9vrVediQYkwiL944PdbgqOkcLNt4EemOaFEVcsfzM4fkoF0LXOBXByow9c3E
+N3coTRiR5r/VUv1xLXA+58bEiuPwKAv0dpihi4dVsjoT/Lc+JzeOIuOoTyrvYLs9
+tznDDgFHmV0ST9tD+leh7fmdvhFHJlsTmKtdFoqwNxxXnUX/iJY2v7vKB3tvh2PX
+0DJq1l1sDPGzbjniazEuOQAnFN44wOwZZoYS6J1yFhNkUsepNxz9gjDthBgd9K5c
+/3ATAOux9TN6S9ZV+AWNS2mw9bMoNlwUxFFzTWsL8TQH2xc519woe2v1n/MuwU8X
+KhDzzMro6/1rqy6any2CbgTUUgGTLT2G/H783+9CHaZr77kgxve9oKeV/afmiSTY
+zIw0bOIjL9kSGiG5VZFvC5F5GQytQIgLcOJ60g7YaEi7ghM5EFjp2CoHxhLbWNvS
+O1UQRwUVZ2J+GGOmRj8JDlQyXr8NYnon74Do29lLBlo3WiXQCBJ31G8JUJc9yB3D
+34xFMFbG02SrZvPAXpacw8Tvw3xrizp5f7NJzz3iiZ+gMEuFuZyUJHmPfWupRWgP
+K9Dx2hzLabjKSWJtyNBjYt1gD1iqj6G8BaVmos8bdrKEZLFMOVLAMLrwjEsCsLa3
+AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFEe4zf/lb+74suwv
+Tg75JbCOPGvDMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAACAj
+QTUEkMJAYmDv4jVM1z+s4jSQuKFvdvoWFqRINyzpkMLyPPgKn9iB5btb2iUspKdV
+cSQy9sgL8rxq+JOssgfCX5/bzMiKqr5qb+FJEMwx14C7u8jYog5kV+qi9cKpMRXS
+IGrs/CIBKM+GuIAeqcwRpTzyFrNHnfzSgCHEy9BHcEGhyoMZCCxt8l13nIoUE9Q2
+HJLw5QY33KbmkJs4j1xrG0aGQ0JfPgEHU1RdZX33inOhmlRaHylDFCfChQ+1iHsa
+O5S3HWCntZznKWlXWpuTekMwGwPXYshApqr8ZORK15FTAaggiG6cX0S5y2CBNOxv
+033aSF/rtJC8LakcC6wc1aJoIIAE1vyxjy+7SjENSoYc6+I2KSb12tjE8nVhz36u
+dmNKekBlk4f4HoCMhuWG1o8O/FMsYOgWYRqiPkN7zTlgVGr18okmAWiDSKIz6MkE
+kbIRNBE+6tBDGR8Dk5AM/1E9V/RBbuHLoL7ryWPNbczk+DaqaJ3tvV2XcEQNtg41
+3OEMXbugUZTLfhbrES+jkkXITHHZvMmZUldGL1DPvTVp9D0VzgalLA8+9oG6lLvD
+u79leNKGef9JOxqDDPDeeOzI8k1MGt6CKfjBWtrt7uYnXuhF0J0cUahoq0Tj0Itq
+4/g7u9xN12TyUb7mqqta6THuBrxzvxNiCp/HuZc=
+-----END CERTIFICATE-----
+
+# Issuer: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Subject: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Label: "T-TeleSec GlobalRoot Class 3"
+# Serial: 1
+# MD5 Fingerprint: ca:fb:40:a8:4e:39:92:8a:1d:fe:8e:2f:c4:27:ea:ef
+# SHA1 Fingerprint: 55:a6:72:3e:cb:f2:ec:cd:c3:23:74:70:19:9d:2a:be:11:e3:81:d1
+# SHA256 Fingerprint: fd:73:da:d3:1c:64:4f:f1:b4:3b:ef:0c:cd:da:96:71:0b:9c:d9:87:5e:ca:7e:31:70:7a:f3:e9:6d:52:2b:bd
+-----BEGIN CERTIFICATE-----
+MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx
+KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd
+BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl
+YyBHbG9iYWxSb290IENsYXNzIDMwHhcNMDgxMDAxMTAyOTU2WhcNMzMxMDAxMjM1
+OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy
+aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50
+ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDMwggEiMA0G
+CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9dZPwYiJvJK7genasfb3ZJNW4t/zN
+8ELg63iIVl6bmlQdTQyK9tPPcPRStdiTBONGhnFBSivwKixVA9ZIw+A5OO3yXDw/
+RLyTPWGrTs0NvvAgJ1gORH8EGoel15YUNpDQSXuhdfsaa3Ox+M6pCSzyU9XDFES4
+hqX2iys52qMzVNn6chr3IhUciJFrf2blw2qAsCTz34ZFiP0Zf3WHHx+xGwpzJFu5
+ZeAsVMhg02YXP+HMVDNzkQI6pn97djmiH5a2OK61yJN0HZ65tOVgnS9W0eDrXltM
+EnAMbEQgqxHY9Bn20pxSN+f6tsIxO0rUFJmtxxr1XV/6B7h8DR/Wgx6zAgMBAAGj
+QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS1
+A/d2O2GCahKqGFPrAyGUv/7OyjANBgkqhkiG9w0BAQsFAAOCAQEAVj3vlNW92nOy
+WL6ukK2YJ5f+AbGwUgC4TeQbIXQbfsDuXmkqJa9c1h3a0nnJ85cp4IaH3gRZD/FZ
+1GSFS5mvJQQeyUapl96Cshtwn5z2r3Ex3XsFpSzTucpH9sry9uetuUg/vBa3wW30
+6gmv7PO15wWeph6KU1HWk4HMdJP2udqmJQV0eVp+QD6CSyYRMG7hP0HHRwA11fXT
+91Q+gT3aSWqas+8QPebrb9HIIkfLzM8BMZLZGOMivgkeGj5asuRrDFR6fUNOuIml
+e9eiPZaGzPImNC1qkp2aGtAw4l1OBLBfiyB+d8E9lYLRRpo7PHi4b6HQDWSieB4p
+TpPDpFQUWw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH
+# Subject: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH
+# Label: "D-TRUST Root Class 3 CA 2 2009"
+# Serial: 623603
+# MD5 Fingerprint: cd:e0:25:69:8d:47:ac:9c:89:35:90:f7:fd:51:3d:2f
+# SHA1 Fingerprint: 58:e8:ab:b0:36:15:33:fb:80:f7:9b:1b:6d:29:d3:ff:8d:5f:00:f0
+# SHA256 Fingerprint: 49:e7:a4:42:ac:f0:ea:62:87:05:00:54:b5:25:64:b6:50:e4:f4:9e:42:e3:48:d6:aa:38:e0:39:e9:57:b1:c1
+-----BEGIN CERTIFICATE-----
+MIIEMzCCAxugAwIBAgIDCYPzMA0GCSqGSIb3DQEBCwUAME0xCzAJBgNVBAYTAkRF
+MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMMHkQtVFJVU1QgUm9vdCBD
+bGFzcyAzIENBIDIgMjAwOTAeFw0wOTExMDUwODM1NThaFw0yOTExMDUwODM1NTha
+ME0xCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMM
+HkQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgMjAwOTCCASIwDQYJKoZIhvcNAQEB
+BQADggEPADCCAQoCggEBANOySs96R+91myP6Oi/WUEWJNTrGa9v+2wBoqOADER03
+UAifTUpolDWzU9GUY6cgVq/eUXjsKj3zSEhQPgrfRlWLJ23DEE0NkVJD2IfgXU42
+tSHKXzlABF9bfsyjxiupQB7ZNoTWSPOSHjRGICTBpFGOShrvUD9pXRl/RcPHAY9R
+ySPocq60vFYJfxLLHLGvKZAKyVXMD9O0Gu1HNVpK7ZxzBCHQqr0ME7UAyiZsxGsM
+lFqVlNpQmvH/pStmMaTJOKDfHR+4CS7zp+hnUquVH+BGPtikw8paxTGA6Eian5Rp
+/hnd2HN8gcqW3o7tszIFZYQ05ub9VxC1X3a/L7AQDcUCAwEAAaOCARowggEWMA8G
+A1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFP3aFMSfMN4hvR5COfyrYyNJ4PGEMA4G
+A1UdDwEB/wQEAwIBBjCB0wYDVR0fBIHLMIHIMIGAoH6gfIZ6bGRhcDovL2RpcmVj
+dG9yeS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwUm9vdCUyMENsYXNzJTIwMyUy
+MENBJTIwMiUyMDIwMDksTz1ELVRydXN0JTIwR21iSCxDPURFP2NlcnRpZmljYXRl
+cmV2b2NhdGlvbmxpc3QwQ6BBoD+GPWh0dHA6Ly93d3cuZC10cnVzdC5uZXQvY3Js
+L2QtdHJ1c3Rfcm9vdF9jbGFzc18zX2NhXzJfMjAwOS5jcmwwDQYJKoZIhvcNAQEL
+BQADggEBAH+X2zDI36ScfSF6gHDOFBJpiBSVYEQBrLLpME+bUMJm2H6NMLVwMeni
+acfzcNsgFYbQDfC+rAF1hM5+n02/t2A7nPPKHeJeaNijnZflQGDSNiH+0LS4F9p0
+o3/U37CYAqxva2ssJSRyoWXuJVrl5jLn8t+rSfrzkGkj2wTZ51xY/GXUl77M/C4K
+zCUqNQT4YJEVdT1B/yMfGchs64JTBKbkTCJNjYy6zltz7GRUUG3RnFX7acM2w4y8
+PIWmawomDeCTmGCufsYkl4phX5GOZpIJhzbNi5stPvZR1FDUWSi9g/LMKHtThm3Y
+Johw1+qRzT65ysCQblrGXnRl11z+o+I=
+-----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH
+# Subject: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH
+# Label: "D-TRUST Root Class 3 CA 2 EV 2009"
+# Serial: 623604
+# MD5 Fingerprint: aa:c6:43:2c:5e:2d:cd:c4:34:c0:50:4f:11:02:4f:b6
+# SHA1 Fingerprint: 96:c9:1b:0b:95:b4:10:98:42:fa:d0:d8:22:79:fe:60:fa:b9:16:83
+# SHA256 Fingerprint: ee:c5:49:6b:98:8c:e9:86:25:b9:34:09:2e:ec:29:08:be:d0:b0:f3:16:c2:d4:73:0c:84:ea:f1:f3:d3:48:81
+-----BEGIN CERTIFICATE-----
+MIIEQzCCAyugAwIBAgIDCYP0MA0GCSqGSIb3DQEBCwUAMFAxCzAJBgNVBAYTAkRF
+MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNVBAMMIUQtVFJVU1QgUm9vdCBD
+bGFzcyAzIENBIDIgRVYgMjAwOTAeFw0wOTExMDUwODUwNDZaFw0yOTExMDUwODUw
+NDZaMFAxCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNV
+BAMMIUQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgRVYgMjAwOTCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBAJnxhDRwui+3MKCOvXwEz75ivJn9gpfSegpn
+ljgJ9hBOlSJzmY3aFS3nBfwZcyK3jpgAvDw9rKFs+9Z5JUut8Mxk2og+KbgPCdM0
+3TP1YtHhzRnp7hhPTFiu4h7WDFsVWtg6uMQYZB7jM7K1iXdODL/ZlGsTl28So/6Z
+qQTMFexgaDbtCHu39b+T7WYxg4zGcTSHThfqr4uRjRxWQa4iN1438h3Z0S0NL2lR
+p75mpoo6Kr3HGrHhFPC+Oh25z1uxav60sUYgovseO3Dvk5h9jHOW8sXvhXCtKSb8
+HgQ+HKDYD8tSg2J87otTlZCpV6LqYQXY+U3EJ/pure3511H3a6UCAwEAAaOCASQw
+ggEgMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFNOUikxiEyoZLsyvcop9Ntea
+HNxnMA4GA1UdDwEB/wQEAwIBBjCB3QYDVR0fBIHVMIHSMIGHoIGEoIGBhn9sZGFw
+Oi8vZGlyZWN0b3J5LmQtdHJ1c3QubmV0L0NOPUQtVFJVU1QlMjBSb290JTIwQ2xh
+c3MlMjAzJTIwQ0ElMjAyJTIwRVYlMjAyMDA5LE89RC1UcnVzdCUyMEdtYkgsQz1E
+RT9jZXJ0aWZpY2F0ZXJldm9jYXRpb25saXN0MEagRKBChkBodHRwOi8vd3d3LmQt
+dHJ1c3QubmV0L2NybC9kLXRydXN0X3Jvb3RfY2xhc3NfM19jYV8yX2V2XzIwMDku
+Y3JsMA0GCSqGSIb3DQEBCwUAA4IBAQA07XtaPKSUiO8aEXUHL7P+PPoeUSbrh/Yp
+3uDx1MYkCenBz1UbtDDZzhr+BlGmFaQt77JLvyAoJUnRpjZ3NOhk31KxEcdzes05
+nsKtjHEh8lprr988TlWvsoRlFIm5d8sqMb7Po23Pb0iUMkZv53GMoKaEGTcH8gNF
+CSuGdXzfX2lXANtu2KZyIktQ1HWYVt+3GP9DQ1CuekR78HlR10M9p9OB0/DJT7na
+xpeG0ILD5EJt/rDiZE4OJudANCa1CInXCGNjOCd1HjPqbqjdn5lPdE2BiYBL3ZqX
+KVwvvoFBuYz/6n1gBp7N1z3TLqMVvKjmJuVvw9y4AyHqnxbxLFS1
+-----END CERTIFICATE-----
+
+# Issuer: CN=CA Disig Root R2 O=Disig a.s.
+# Subject: CN=CA Disig Root R2 O=Disig a.s.
+# Label: "CA Disig Root R2"
+# Serial: 10572350602393338211
+# MD5 Fingerprint: 26:01:fb:d8:27:a7:17:9a:45:54:38:1a:43:01:3b:03
+# SHA1 Fingerprint: b5:61:eb:ea:a4:de:e4:25:4b:69:1a:98:a5:57:47:c2:34:c7:d9:71
+# SHA256 Fingerprint: e2:3d:4a:03:6d:7b:70:e9:f5:95:b1:42:20:79:d2:b9:1e:df:bb:1f:b6:51:a0:63:3e:aa:8a:9d:c5:f8:07:03
+-----BEGIN CERTIFICATE-----
+MIIFaTCCA1GgAwIBAgIJAJK4iNuwisFjMA0GCSqGSIb3DQEBCwUAMFIxCzAJBgNV
+BAYTAlNLMRMwEQYDVQQHEwpCcmF0aXNsYXZhMRMwEQYDVQQKEwpEaXNpZyBhLnMu
+MRkwFwYDVQQDExBDQSBEaXNpZyBSb290IFIyMB4XDTEyMDcxOTA5MTUzMFoXDTQy
+MDcxOTA5MTUzMFowUjELMAkGA1UEBhMCU0sxEzARBgNVBAcTCkJyYXRpc2xhdmEx
+EzARBgNVBAoTCkRpc2lnIGEucy4xGTAXBgNVBAMTEENBIERpc2lnIFJvb3QgUjIw
+ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCio8QACdaFXS1tFPbCw3Oe
+NcJxVX6B+6tGUODBfEl45qt5WDza/3wcn9iXAng+a0EE6UG9vgMsRfYvZNSrXaNH
+PWSb6WiaxswbP7q+sos0Ai6YVRn8jG+qX9pMzk0DIaPY0jSTVpbLTAwAFjxfGs3I
+x2ymrdMxp7zo5eFm1tL7A7RBZckQrg4FY8aAamkw/dLukO8NJ9+flXP04SXabBbe
+QTg06ov80egEFGEtQX6sx3dOy1FU+16SGBsEWmjGycT6txOgmLcRK7fWV8x8nhfR
+yyX+hk4kLlYMeE2eARKmK6cBZW58Yh2EhN/qwGu1pSqVg8NTEQxzHQuyRpDRQjrO
+QG6Vrf/GlK1ul4SOfW+eioANSW1z4nuSHsPzwfPrLgVv2RvPN3YEyLRa5Beny912
+H9AZdugsBbPWnDTYltxhh5EF5EQIM8HauQhl1K6yNg3ruji6DOWbnuuNZt2Zz9aJ
+QfYEkoopKW1rOhzndX0CcQ7zwOe9yxndnWCywmZgtrEE7snmhrmaZkCo5xHtgUUD
+i/ZnWejBBhG93c+AAk9lQHhcR1DIm+YfgXvkRKhbhZri3lrVx/k6RGZL5DJUfORs
+nLMOPReisjQS1n6yqEm70XooQL6iFh/f5DcfEXP7kAplQ6INfPgGAVUzfbANuPT1
+rqVCV3w2EYx7XsQDnYx5nQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1Ud
+DwEB/wQEAwIBBjAdBgNVHQ4EFgQUtZn4r7CU9eMg1gqtzk5WpC5uQu0wDQYJKoZI
+hvcNAQELBQADggIBACYGXnDnZTPIgm7ZnBc6G3pmsgH2eDtpXi/q/075KMOYKmFM
+tCQSin1tERT3nLXK5ryeJ45MGcipvXrA1zYObYVybqjGom32+nNjf7xueQgcnYqf
+GopTpti72TVVsRHFqQOzVju5hJMiXn7B9hJSi+osZ7z+Nkz1uM/Rs0mSO9MpDpkb
+lvdhuDvEK7Z4bLQjb/D907JedR+Zlais9trhxTF7+9FGs9K8Z7RiVLoJ92Owk6Ka
++elSLotgEqv89WBW7xBci8QaQtyDW2QOy7W81k/BfDxujRNt+3vrMNDcTa/F1bal
+TFtxyegxvug4BkihGuLq0t4SOVga/4AOgnXmt8kHbA7v/zjxmHHEt38OFdAlab0i
+nSvtBfZGR6ztwPDUO+Ls7pZbkBNOHlY667DvlruWIxG68kOGdGSVyCh13x01utI3
+gzhTODY7z2zp+WsO0PsE6E9312UBeIYMej4hYvF/Y3EMyZ9E26gnonW+boE+18Dr
+G5gPcFw0sorMwIUY6256s/daoQe/qUKS82Ail+QUoQebTnbAjn39pCXHR+3/H3Os
+zMOl6W8KjptlwlCFtaOgUxLMVYdh84GuEEZhvUQhuMI9dM9+JDX6HAcOmz0iyu8x
+L4ysEr3vQCj8KWefshNPZiTEUxnpHikV7+ZtsH8tZ/3zbBt1RqPlShfppNcL
+-----END CERTIFICATE-----
+
+# Issuer: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV
+# Subject: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV
+# Label: "ACCVRAIZ1"
+# Serial: 6828503384748696800
+# MD5 Fingerprint: d0:a0:5a:ee:05:b6:09:94:21:a1:7d:f1:b2:29:82:02
+# SHA1 Fingerprint: 93:05:7a:88:15:c6:4f:ce:88:2f:fa:91:16:52:28:78:bc:53:64:17
+# SHA256 Fingerprint: 9a:6e:c0:12:e1:a7:da:9d:be:34:19:4d:47:8a:d7:c0:db:18:22:fb:07:1d:f1:29:81:49:6e:d1:04:38:41:13
+-----BEGIN CERTIFICATE-----
+MIIH0zCCBbugAwIBAgIIXsO3pkN/pOAwDQYJKoZIhvcNAQEFBQAwQjESMBAGA1UE
+AwwJQUNDVlJBSVoxMRAwDgYDVQQLDAdQS0lBQ0NWMQ0wCwYDVQQKDARBQ0NWMQsw
+CQYDVQQGEwJFUzAeFw0xMTA1MDUwOTM3MzdaFw0zMDEyMzEwOTM3MzdaMEIxEjAQ
+BgNVBAMMCUFDQ1ZSQUlaMTEQMA4GA1UECwwHUEtJQUNDVjENMAsGA1UECgwEQUND
+VjELMAkGA1UEBhMCRVMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCb
+qau/YUqXry+XZpp0X9DZlv3P4uRm7x8fRzPCRKPfmt4ftVTdFXxpNRFvu8gMjmoY
+HtiP2Ra8EEg2XPBjs5BaXCQ316PWywlxufEBcoSwfdtNgM3802/J+Nq2DoLSRYWo
+G2ioPej0RGy9ocLLA76MPhMAhN9KSMDjIgro6TenGEyxCQ0jVn8ETdkXhBilyNpA
+lHPrzg5XPAOBOp0KoVdDaaxXbXmQeOW1tDvYvEyNKKGno6e6Ak4l0Squ7a4DIrhr
+IA8wKFSVf+DuzgpmndFALW4ir50awQUZ0m/A8p/4e7MCQvtQqR0tkw8jq8bBD5L/
+0KIV9VMJcRz/RROE5iZe+OCIHAr8Fraocwa48GOEAqDGWuzndN9wrqODJerWx5eH
+k6fGioozl2A3ED6XPm4pFdahD9GILBKfb6qkxkLrQaLjlUPTAYVtjrs78yM2x/47
+4KElB0iryYl0/wiPgL/AlmXz7uxLaL2diMMxs0Dx6M/2OLuc5NF/1OVYm3z61PMO
+m3WR5LpSLhl+0fXNWhn8ugb2+1KoS5kE3fj5tItQo05iifCHJPqDQsGH+tUtKSpa
+cXpkatcnYGMN285J9Y0fkIkyF/hzQ7jSWpOGYdbhdQrqeWZ2iE9x6wQl1gpaepPl
+uUsXQA+xtrn13k/c4LOsOxFwYIRKQ26ZIMApcQrAZQIDAQABo4ICyzCCAscwfQYI
+KwYBBQUHAQEEcTBvMEwGCCsGAQUFBzAChkBodHRwOi8vd3d3LmFjY3YuZXMvZmls
+ZWFkbWluL0FyY2hpdm9zL2NlcnRpZmljYWRvcy9yYWl6YWNjdjEuY3J0MB8GCCsG
+AQUFBzABhhNodHRwOi8vb2NzcC5hY2N2LmVzMB0GA1UdDgQWBBTSh7Tj3zcnk1X2
+VuqB5TbMjB4/vTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNKHtOPfNyeT
+VfZW6oHlNsyMHj+9MIIBcwYDVR0gBIIBajCCAWYwggFiBgRVHSAAMIIBWDCCASIG
+CCsGAQUFBwICMIIBFB6CARAAQQB1AHQAbwByAGkAZABhAGQAIABkAGUAIABDAGUA
+cgB0AGkAZgBpAGMAYQBjAGkA8wBuACAAUgBhAO0AegAgAGQAZQAgAGwAYQAgAEEA
+QwBDAFYAIAAoAEEAZwBlAG4AYwBpAGEAIABkAGUAIABUAGUAYwBuAG8AbABvAGcA
+7QBhACAAeQAgAEMAZQByAHQAaQBmAGkAYwBhAGMAaQDzAG4AIABFAGwAZQBjAHQA
+cgDzAG4AaQBjAGEALAAgAEMASQBGACAAUQA0ADYAMAAxADEANQA2AEUAKQAuACAA
+QwBQAFMAIABlAG4AIABoAHQAdABwADoALwAvAHcAdwB3AC4AYQBjAGMAdgAuAGUA
+czAwBggrBgEFBQcCARYkaHR0cDovL3d3dy5hY2N2LmVzL2xlZ2lzbGFjaW9uX2Mu
+aHRtMFUGA1UdHwROMEwwSqBIoEaGRGh0dHA6Ly93d3cuYWNjdi5lcy9maWxlYWRt
+aW4vQXJjaGl2b3MvY2VydGlmaWNhZG9zL3JhaXphY2N2MV9kZXIuY3JsMA4GA1Ud
+DwEB/wQEAwIBBjAXBgNVHREEEDAOgQxhY2N2QGFjY3YuZXMwDQYJKoZIhvcNAQEF
+BQADggIBAJcxAp/n/UNnSEQU5CmH7UwoZtCPNdpNYbdKl02125DgBS4OxnnQ8pdp
+D70ER9m+27Up2pvZrqmZ1dM8MJP1jaGo/AaNRPTKFpV8M9xii6g3+CfYCS0b78gU
+JyCpZET/LtZ1qmxNYEAZSUNUY9rizLpm5U9EelvZaoErQNV/+QEnWCzI7UiRfD+m
+AM/EKXMRNt6GGT6d7hmKG9Ww7Y49nCrADdg9ZuM8Db3VlFzi4qc1GwQA9j9ajepD
+vV+JHanBsMyZ4k0ACtrJJ1vnE5Bc5PUzolVt3OAJTS+xJlsndQAJxGJ3KQhfnlms
+tn6tn1QwIgPBHnFk/vk4CpYY3QIUrCPLBhwepH2NDd4nQeit2hW3sCPdK6jT2iWH
+7ehVRE2I9DZ+hJp4rPcOVkkO1jMl1oRQQmwgEh0q1b688nCBpHBgvgW1m54ERL5h
+I6zppSSMEYCUWqKiuUnSwdzRp+0xESyeGabu4VXhwOrPDYTkF7eifKXeVSUG7szA
+h1xA2syVP1XgNce4hL60Xc16gwFy7ofmXx2utYXGJt/mwZrpHgJHnyqobalbz+xF
+d3+YJ5oyXSrjhO7FmGYvliAd3djDJ9ew+f7Zfc3Qn48LFFhRny+Lwzgt3uiP1o2H
+pPVWQxaZLPSkVrQ0uGE3ycJYgBugl6H8WY3pEfbRD0tVNEYqi4Y7
+-----END CERTIFICATE-----
+
+# Issuer: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA
+# Subject: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA
+# Label: "TWCA Global Root CA"
+# Serial: 3262
+# MD5 Fingerprint: f9:03:7e:cf:e6:9e:3c:73:7a:2a:90:07:69:ff:2b:96
+# SHA1 Fingerprint: 9c:bb:48:53:f6:a4:f6:d3:52:a4:e8:32:52:55:60:13:f5:ad:af:65
+# SHA256 Fingerprint: 59:76:90:07:f7:68:5d:0f:cd:50:87:2f:9f:95:d5:75:5a:5b:2b:45:7d:81:f3:69:2b:61:0a:98:67:2f:0e:1b
+-----BEGIN CERTIFICATE-----
+MIIFQTCCAymgAwIBAgICDL4wDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCVFcx
+EjAQBgNVBAoTCVRBSVdBTi1DQTEQMA4GA1UECxMHUm9vdCBDQTEcMBoGA1UEAxMT
+VFdDQSBHbG9iYWwgUm9vdCBDQTAeFw0xMjA2MjcwNjI4MzNaFw0zMDEyMzExNTU5
+NTlaMFExCzAJBgNVBAYTAlRXMRIwEAYDVQQKEwlUQUlXQU4tQ0ExEDAOBgNVBAsT
+B1Jvb3QgQ0ExHDAaBgNVBAMTE1RXQ0EgR2xvYmFsIFJvb3QgQ0EwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCwBdvI64zEbooh745NnHEKH1Jw7W2CnJfF
+10xORUnLQEK1EjRsGcJ0pDFfhQKX7EMzClPSnIyOt7h52yvVavKOZsTuKwEHktSz
+0ALfUPZVr2YOy+BHYC8rMjk1Ujoog/h7FsYYuGLWRyWRzvAZEk2tY/XTP3VfKfCh
+MBwqoJimFb3u/Rk28OKRQ4/6ytYQJ0lM793B8YVwm8rqqFpD/G2Gb3PpN0Wp8DbH
+zIh1HrtsBv+baz4X7GGqcXzGHaL3SekVtTzWoWH1EfcFbx39Eb7QMAfCKbAJTibc
+46KokWofwpFFiFzlmLhxpRUZyXx1EcxwdE8tmx2RRP1WKKD+u4ZqyPpcC1jcxkt2
+yKsi2XMPpfRaAok/T54igu6idFMqPVMnaR1sjjIsZAAmY2E2TqNGtz99sy2sbZCi
+laLOz9qC5wc0GZbpuCGqKX6mOL6OKUohZnkfs8O1CWfe1tQHRvMq2uYiN2DLgbYP
+oA/pyJV/v1WRBXrPPRXAb94JlAGD1zQbzECl8LibZ9WYkTunhHiVJqRaCPgrdLQA
+BDzfuBSO6N+pjWxnkjMdwLfS7JLIvgm/LCkFbwJrnu+8vyq8W8BQj0FwcYeyTbcE
+qYSjMq+u7msXi7Kx/mzhkIyIqJdIzshNy/MGz19qCkKxHh53L46g5pIOBvwFItIm
+4TFRfTLcDwIDAQABoyMwITAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB
+/zANBgkqhkiG9w0BAQsFAAOCAgEAXzSBdu+WHdXltdkCY4QWwa6gcFGn90xHNcgL
+1yg9iXHZqjNB6hQbbCEAwGxCGX6faVsgQt+i0trEfJdLjbDorMjupWkEmQqSpqsn
+LhpNgb+E1HAerUf+/UqdM+DyucRFCCEK2mlpc3INvjT+lIutwx4116KD7+U4x6WF
+H6vPNOw/KP4M8VeGTslV9xzU2KV9Bnpv1d8Q34FOIWWxtuEXeZVFBs5fzNxGiWNo
+RI2T9GRwoD2dKAXDOXC4Ynsg/eTb6QihuJ49CcdP+yz4k3ZB3lLg4VfSnQO8d57+
+nile98FRYB/e2guyLXW3Q0iT5/Z5xoRdgFlglPx4mI88k1HtQJAH32RjJMtOcQWh
+15QaiDLxInQirqWm2BJpTGCjAu4r7NRjkgtevi92a6O2JryPA9gK8kxkRr05YuWW
+6zRjESjMlfGt7+/cgFhI6Uu46mWs6fyAtbXIRfmswZ/ZuepiiI7E8UuDEq3mi4TW
+nsLrgxifarsbJGAzcMzs9zLzXNl5fe+epP7JI8Mk7hWSsT2RTyaGvWZzJBPqpK5j
+wa19hAM8EHiGG3njxPPyBJUgriOCxLM6AGK/5jYk4Ve6xx6QddVfP5VhK8E7zeWz
+aGHQRiapIVJpLesux+t3zqY6tQMzT3bR51xUAV3LePTJDL/PEo4XLSNolOer/qmy
+KwbQBM0=
+-----END CERTIFICATE-----
+
+# Issuer: CN=TeliaSonera Root CA v1 O=TeliaSonera
+# Subject: CN=TeliaSonera Root CA v1 O=TeliaSonera
+# Label: "TeliaSonera Root CA v1"
+# Serial: 199041966741090107964904287217786801558
+# MD5 Fingerprint: 37:41:49:1b:18:56:9a:26:f5:ad:c2:66:fb:40:a5:4c
+# SHA1 Fingerprint: 43:13:bb:96:f1:d5:86:9b:c1:4e:6a:92:f6:cf:f6:34:69:87:82:37
+# SHA256 Fingerprint: dd:69:36:fe:21:f8:f0:77:c1:23:a1:a5:21:c1:22:24:f7:22:55:b7:3e:03:a7:26:06:93:e8:a2:4b:0f:a3:89
+-----BEGIN CERTIFICATE-----
+MIIFODCCAyCgAwIBAgIRAJW+FqD3LkbxezmCcvqLzZYwDQYJKoZIhvcNAQEFBQAw
+NzEUMBIGA1UECgwLVGVsaWFTb25lcmExHzAdBgNVBAMMFlRlbGlhU29uZXJhIFJv
+b3QgQ0EgdjEwHhcNMDcxMDE4MTIwMDUwWhcNMzIxMDE4MTIwMDUwWjA3MRQwEgYD
+VQQKDAtUZWxpYVNvbmVyYTEfMB0GA1UEAwwWVGVsaWFTb25lcmEgUm9vdCBDQSB2
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMK+6yfwIaPzaSZVfp3F
+VRaRXP3vIb9TgHot0pGMYzHw7CTww6XScnwQbfQ3t+XmfHnqjLWCi65ItqwA3GV1
+7CpNX8GH9SBlK4GoRz6JI5UwFpB/6FcHSOcZrr9FZ7E3GwYq/t75rH2D+1665I+X
+Z75Ljo1kB1c4VWk0Nj0TSO9P4tNmHqTPGrdeNjPUtAa9GAH9d4RQAEX1jF3oI7x+
+/jXh7VB7qTCNGdMJjmhnXb88lxhTuylixcpecsHHltTbLaC0H2kD7OriUPEMPPCs
+81Mt8Bz17Ww5OXOAFshSsCPN4D7c3TxHoLs1iuKYaIu+5b9y7tL6pe0S7fyYGKkm
+dtwoSxAgHNN/Fnct7W+A90m7UwW7XWjH1Mh1Fj+JWov3F0fUTPHSiXk+TT2YqGHe
+Oh7S+F4D4MHJHIzTjU3TlTazN19jY5szFPAtJmtTfImMMsJu7D0hADnJoWjiUIMu
+sDor8zagrC/kb2HCUQk5PotTubtn2txTuXZZNp1D5SDgPTJghSJRt8czu90VL6R4
+pgd7gUY2BIbdeTXHlSw7sKMXNeVzH7RcWe/a6hBle3rQf5+ztCo3O3CLm1u5K7fs
+slESl1MpWtTwEhDcTwK7EpIvYtQ/aUN8Ddb8WHUBiJ1YFkveupD/RwGJBmr2X7KQ
+arMCpgKIv7NHfirZ1fpoeDVNAgMBAAGjPzA9MA8GA1UdEwEB/wQFMAMBAf8wCwYD
+VR0PBAQDAgEGMB0GA1UdDgQWBBTwj1k4ALP1j5qWDNXr+nuqF+gTEjANBgkqhkiG
+9w0BAQUFAAOCAgEAvuRcYk4k9AwI//DTDGjkk0kiP0Qnb7tt3oNmzqjMDfz1mgbl
+dxSR651Be5kqhOX//CHBXfDkH1e3damhXwIm/9fH907eT/j3HEbAek9ALCI18Bmx
+0GtnLLCo4MBANzX2hFxc469CeP6nyQ1Q6g2EdvZR74NTxnr/DlZJLo961gzmJ1Tj
+TQpgcmLNkQfWpb/ImWvtxBnmq0wROMVvMeJuScg/doAmAyYp4Db29iBT4xdwNBed
+Y2gea+zDTYa4EzAvXUYNR0PVG6pZDrlcjQZIrXSHX8f8MVRBE+LHIQ6e4B4N4cB7
+Q4WQxYpYxmUKeFfyxiMPAdkgS94P+5KFdSpcc41teyWRyu5FrgZLAMzTsVlQ2jqI
+OylDRl6XK1TOU2+NSueW+r9xDkKLfP0ooNBIytrEgUy7onOTJsjrDNYmiLbAJM+7
+vVvrdX3pCI6GMyx5dwlppYn8s3CQh3aP0yK7Qs69cwsgJirQmz1wHiRszYd2qReW
+t88NkvuOGKmYSdGe/mBEciG5Ge3C9THxOUiIkCR1VBatzvT4aRRkOfujuLpwQMcn
+HL/EVlP6Y2XQ8xwOFvVrhlhNGNTkDY6lnVuR3HYkUD/GKvvZt5y11ubQ2egZixVx
+SK236thZiNSQvxaz2emsWWFUyBy6ysHK4bkgTI86k4mloMy/0/Z1pHWWbVY=
+-----END CERTIFICATE-----
+
+# Issuer: CN=E-Tugra Certification Authority O=E-Tu\u011fra EBG Bili\u015fim Teknolojileri ve Hizmetleri A.\u015e. OU=E-Tugra Sertifikasyon Merkezi
+# Subject: CN=E-Tugra Certification Authority O=E-Tu\u011fra EBG Bili\u015fim Teknolojileri ve Hizmetleri A.\u015e. OU=E-Tugra Sertifikasyon Merkezi
+# Label: "E-Tugra Certification Authority"
+# Serial: 7667447206703254355
+# MD5 Fingerprint: b8:a1:03:63:b0:bd:21:71:70:8a:6f:13:3a:bb:79:49
+# SHA1 Fingerprint: 51:c6:e7:08:49:06:6e:f3:92:d4:5c:a0:0d:6d:a3:62:8f:c3:52:39
+# SHA256 Fingerprint: b0:bf:d5:2b:b0:d7:d9:bd:92:bf:5d:4d:c1:3d:a2:55:c0:2c:54:2f:37:83:65:ea:89:39:11:f5:5e:55:f2:3c
+-----BEGIN CERTIFICATE-----
+MIIGSzCCBDOgAwIBAgIIamg+nFGby1MwDQYJKoZIhvcNAQELBQAwgbIxCzAJBgNV
+BAYTAlRSMQ8wDQYDVQQHDAZBbmthcmExQDA+BgNVBAoMN0UtVHXEn3JhIEVCRyBC
+aWxpxZ9pbSBUZWtub2xvamlsZXJpIHZlIEhpem1ldGxlcmkgQS7Fni4xJjAkBgNV
+BAsMHUUtVHVncmEgU2VydGlmaWthc3lvbiBNZXJrZXppMSgwJgYDVQQDDB9FLVR1
+Z3JhIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTEzMDMwNTEyMDk0OFoXDTIz
+MDMwMzEyMDk0OFowgbIxCzAJBgNVBAYTAlRSMQ8wDQYDVQQHDAZBbmthcmExQDA+
+BgNVBAoMN0UtVHXEn3JhIEVCRyBCaWxpxZ9pbSBUZWtub2xvamlsZXJpIHZlIEhp
+em1ldGxlcmkgQS7Fni4xJjAkBgNVBAsMHUUtVHVncmEgU2VydGlmaWthc3lvbiBN
+ZXJrZXppMSgwJgYDVQQDDB9FLVR1Z3JhIENlcnRpZmljYXRpb24gQXV0aG9yaXR5
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA4vU/kwVRHoViVF56C/UY
+B4Oufq9899SKa6VjQzm5S/fDxmSJPZQuVIBSOTkHS0vdhQd2h8y/L5VMzH2nPbxH
+D5hw+IyFHnSOkm0bQNGZDbt1bsipa5rAhDGvykPL6ys06I+XawGb1Q5KCKpbknSF
+Q9OArqGIW66z6l7LFpp3RMih9lRozt6Plyu6W0ACDGQXwLWTzeHxE2bODHnv0ZEo
+q1+gElIwcxmOj+GMB6LDu0rw6h8VqO4lzKRG+Bsi77MOQ7osJLjFLFzUHPhdZL3D
+k14opz8n8Y4e0ypQBaNV2cvnOVPAmJ6MVGKLJrD3fY185MaeZkJVgkfnsliNZvcH
+fC425lAcP9tDJMW/hkd5s3kc91r0E+xs+D/iWR+V7kI+ua2oMoVJl0b+SzGPWsut
+dEcf6ZG33ygEIqDUD13ieU/qbIWGvaimzuT6w+Gzrt48Ue7LE3wBf4QOXVGUnhMM
+ti6lTPk5cDZvlsouDERVxcr6XQKj39ZkjFqzAQqptQpHF//vkUAqjqFGOjGY5RH8
+zLtJVor8udBhmm9lbObDyz51Sf6Pp+KJxWfXnUYTTjF2OySznhFlhqt/7x3U+Lzn
+rFpct1pHXFXOVbQicVtbC/DP3KBhZOqp12gKY6fgDT+gr9Oq0n7vUaDmUStVkhUX
+U8u3Zg5mTPj5dUyQ5xJwx0UCAwEAAaNjMGEwHQYDVR0OBBYEFC7j27JJ0JxUeVz6
+Jyr+zE7S6E5UMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAULuPbsknQnFR5
+XPonKv7MTtLoTlQwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQAF
+Nzr0TbdF4kV1JI+2d1LoHNgQk2Xz8lkGpD4eKexd0dCrfOAKkEh47U6YA5n+KGCR
+HTAduGN8qOY1tfrTYXbm1gdLymmasoR6d5NFFxWfJNCYExL/u6Au/U5Mh/jOXKqY
+GwXgAEZKgoClM4so3O0409/lPun++1ndYYRP0lSWE2ETPo+Aab6TR7U1Q9Jauz1c
+77NCR807VRMGsAnb/WP2OogKmW9+4c4bU2pEZiNRCHu8W1Ki/QY3OEBhj0qWuJA3
++GbHeJAAFS6LrVE1Uweoa2iu+U48BybNCAVwzDk/dr2l02cmAYamU9JgO3xDf1WK
+vJUawSg5TB9D0pH0clmKuVb8P7Sd2nCcdlqMQ1DujjByTd//SffGqWfZbawCEeI6
+FiWnWAjLb1NBnEg4R2gz0dfHj9R0IdTDBZB6/86WiLEVKV0jq9BgoRJP3vQXzTLl
+yb/IQ639Lo7xr+L0mPoSHyDYwKcMhcWQ9DstliaxLL5Mq+ux0orJ23gTDx4JnW2P
+AJ8C2sH6H3p6CcRK5ogql5+Ji/03X186zjhZhkuvcQu02PJwT58yE+Owp1fl2tpD
+y4Q08ijE6m30Ku/Ba3ba+367hTzSU8JNvnHhRdH9I2cNE3X7z2VnIp2usAnRCf8d
+NL/+I5c30jn6PQ0GC7TbO6Orb1wdtn7os4I07QZcJA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Subject: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Label: "T-TeleSec GlobalRoot Class 2"
+# Serial: 1
+# MD5 Fingerprint: 2b:9b:9e:e4:7b:6c:1f:00:72:1a:cc:c1:77:79:df:6a
+# SHA1 Fingerprint: 59:0d:2d:7d:88:4f:40:2e:61:7e:a5:62:32:17:65:cf:17:d8:94:e9
+# SHA256 Fingerprint: 91:e2:f5:78:8d:58:10:eb:a7:ba:58:73:7d:e1:54:8a:8e:ca:cd:01:45:98:bc:0b:14:3e:04:1b:17:05:25:52
+-----BEGIN CERTIFICATE-----
+MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx
+KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd
+BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl
+YyBHbG9iYWxSb290IENsYXNzIDIwHhcNMDgxMDAxMTA0MDE0WhcNMzMxMDAxMjM1
+OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy
+aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50
+ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDIwggEiMA0G
+CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCqX9obX+hzkeXaXPSi5kfl82hVYAUd
+AqSzm1nzHoqvNK38DcLZSBnuaY/JIPwhqgcZ7bBcrGXHX+0CfHt8LRvWurmAwhiC
+FoT6ZrAIxlQjgeTNuUk/9k9uN0goOA/FvudocP05l03Sx5iRUKrERLMjfTlH6VJi
+1hKTXrcxlkIF+3anHqP1wvzpesVsqXFP6st4vGCvx9702cu+fjOlbpSD8DT6Iavq
+jnKgP6TeMFvvhk1qlVtDRKgQFRzlAVfFmPHmBiiRqiDFt1MmUUOyCxGVWOHAD3bZ
+wI18gfNycJ5v/hqO2V81xrJvNHy+SE/iWjnX2J14np+GPgNeGYtEotXHAgMBAAGj
+QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS/
+WSA2AHmgoCJrjNXyYdK4LMuCSjANBgkqhkiG9w0BAQsFAAOCAQEAMQOiYQsfdOhy
+NsZt+U2e+iKo4YFWz827n+qrkRk4r6p8FU3ztqONpfSO9kSpp+ghla0+AGIWiPAC
+uvxhI+YzmzB6azZie60EI4RYZeLbK4rnJVM3YlNfvNoBYimipidx5joifsFvHZVw
+IEoHNN/q/xWA5brXethbdXwFeilHfkCoMRN3zUA7tFFHei4R40cR3p1m0IvVVGb6
+g1XqfMIpiRvpb7PO4gWEyS8+eIVibslfwXhjdFjASBgMmTnrpMwatXlajRWc2BQN
+9noHV8cigwUtPJslJj0Ys6lDfMjIq2SPDqO/nBudMNva0Bkuqjzx+zOAduTNrRlP
+BSeOE6Fuwg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Atos TrustedRoot 2011 O=Atos
+# Subject: CN=Atos TrustedRoot 2011 O=Atos
+# Label: "Atos TrustedRoot 2011"
+# Serial: 6643877497813316402
+# MD5 Fingerprint: ae:b9:c4:32:4b:ac:7f:5d:66:cc:77:94:bb:2a:77:56
+# SHA1 Fingerprint: 2b:b1:f5:3e:55:0c:1d:c5:f1:d4:e6:b7:6a:46:4b:55:06:02:ac:21
+# SHA256 Fingerprint: f3:56:be:a2:44:b7:a9:1e:b3:5d:53:ca:9a:d7:86:4a:ce:01:8e:2d:35:d5:f8:f9:6d:df:68:a6:f4:1a:a4:74
+-----BEGIN CERTIFICATE-----
+MIIDdzCCAl+gAwIBAgIIXDPLYixfszIwDQYJKoZIhvcNAQELBQAwPDEeMBwGA1UE
+AwwVQXRvcyBUcnVzdGVkUm9vdCAyMDExMQ0wCwYDVQQKDARBdG9zMQswCQYDVQQG
+EwJERTAeFw0xMTA3MDcxNDU4MzBaFw0zMDEyMzEyMzU5NTlaMDwxHjAcBgNVBAMM
+FUF0b3MgVHJ1c3RlZFJvb3QgMjAxMTENMAsGA1UECgwEQXRvczELMAkGA1UEBhMC
+REUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCVhTuXbyo7LjvPpvMp
+Nb7PGKw+qtn4TaA+Gke5vJrf8v7MPkfoepbCJI419KkM/IL9bcFyYie96mvr54rM
+VD6QUM+A1JX76LWC1BTFtqlVJVfbsVD2sGBkWXppzwO3bw2+yj5vdHLqqjAqc2K+
+SZFhyBH+DgMq92og3AIVDV4VavzjgsG1xZ1kCWyjWZgHJ8cblithdHFsQ/H3NYkQ
+4J7sVaE3IqKHBAUsR320HLliKWYoyrfhk/WklAOZuXCFteZI6o1Q/NnezG8HDt0L
+cp2AMBYHlT8oDv3FdU9T1nSatCQujgKRz3bFmx5VdJx4IbHwLfELn8LVlhgf8FQi
+eowHAgMBAAGjfTB7MB0GA1UdDgQWBBSnpQaxLKYJYO7Rl+lwrrw7GWzbITAPBgNV
+HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFKelBrEspglg7tGX6XCuvDsZbNshMBgG
+A1UdIAQRMA8wDQYLKwYBBAGwLQMEAQEwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3
+DQEBCwUAA4IBAQAmdzTblEiGKkGdLD4GkGDEjKwLVLgfuXvTBznk+j57sj1O7Z8j
+vZfza1zv7v1Apt+hk6EKhqzvINB5Ab149xnYJDE0BAGmuhWawyfc2E8PzBhj/5kP
+DpFrdRbhIfzYJsdHt6bPWHJxfrrhTZVHO8mvbaG0weyJ9rQPOLXiZNwlz6bb65pc
+maHFCN795trV1lpFDMS3wrUU77QR/w4VtfX128a961qn8FYiqTxlVMYVqL2Gns2D
+lmh6cYGJ4Qvh6hEbaAjMaZ7snkGeRDImeuKHCnE96+RapNLbxc3G3mB/ufNPRJLv
+KrcYPqcZ2Qt9sTdBQrC6YB3y/gkRsPCHe6ed
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 1 G3"
+# Serial: 687049649626669250736271037606554624078720034195
+# MD5 Fingerprint: a4:bc:5b:3f:fe:37:9a:fa:64:f0:e2:fa:05:3d:0b:ab
+# SHA1 Fingerprint: 1b:8e:ea:57:96:29:1a:c9:39:ea:b8:0a:81:1a:73:73:c0:93:79:67
+# SHA256 Fingerprint: 8a:86:6f:d1:b2:76:b5:7e:57:8e:92:1c:65:82:8a:2b:ed:58:e9:f2:f2:88:05:41:34:b7:f1:f4:bf:c9:cc:74
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIUeFhfLq0sGUvjNwc1NBMotZbUZZMwDQYJKoZIhvcNAQEL
+BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
+BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMSBHMzAeFw0xMjAxMTIxNzI3NDRaFw00
+MjAxMTIxNzI3NDRaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
+aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDEgRzMwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCgvlAQjunybEC0BJyFuTHK3C3kEakEPBtV
+wedYMB0ktMPvhd6MLOHBPd+C5k+tR4ds7FtJwUrVu4/sh6x/gpqG7D0DmVIB0jWe
+rNrwU8lmPNSsAgHaJNM7qAJGr6Qc4/hzWHa39g6QDbXwz8z6+cZM5cOGMAqNF341
+68Xfuw6cwI2H44g4hWf6Pser4BOcBRiYz5P1sZK0/CPTz9XEJ0ngnjybCKOLXSoh
+4Pw5qlPafX7PGglTvF0FBM+hSo+LdoINofjSxxR3W5A2B4GbPgb6Ul5jxaYA/qXp
+UhtStZI5cgMJYr2wYBZupt0lwgNm3fME0UDiTouG9G/lg6AnhF4EwfWQvTA9xO+o
+abw4m6SkltFi2mnAAZauy8RRNOoMqv8hjlmPSlzkYZqn0ukqeI1RPToV7qJZjqlc
+3sX5kCLliEVx3ZGZbHqfPT2YfF72vhZooF6uCyP8Wg+qInYtyaEQHeTTRCOQiJ/G
+KubX9ZqzWB4vMIkIG1SitZgj7Ah3HJVdYdHLiZxfokqRmu8hqkkWCKi9YSgxyXSt
+hfbZxbGL0eUQMk1fiyA6PEkfM4VZDdvLCXVDaXP7a3F98N/ETH3Goy7IlXnLc6KO
+Tk0k+17kBL5yG6YnLUlamXrXXAkgt3+UuU/xDRxeiEIbEbfnkduebPRq34wGmAOt
+zCjvpUfzUwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+BjAdBgNVHQ4EFgQUo5fW816iEOGrRZ88F2Q87gFwnMwwDQYJKoZIhvcNAQELBQAD
+ggIBABj6W3X8PnrHX3fHyt/PX8MSxEBd1DKquGrX1RUVRpgjpeaQWxiZTOOtQqOC
+MTaIzen7xASWSIsBx40Bz1szBpZGZnQdT+3Btrm0DWHMY37XLneMlhwqI2hrhVd2
+cDMT/uFPpiN3GPoajOi9ZcnPP/TJF9zrx7zABC4tRi9pZsMbj/7sPtPKlL92CiUN
+qXsCHKnQO18LwIE6PWThv6ctTr1NxNgpxiIY0MWscgKCP6o6ojoilzHdCGPDdRS5
+YCgtW2jgFqlmgiNR9etT2DGbe+m3nUvriBbP+V04ikkwj+3x6xn0dxoxGE1nVGwv
+b2X52z3sIexe9PSLymBlVNFxZPT5pqOBMzYzcfCkeF9OrYMh3jRJjehZrJ3ydlo2
+8hP0r+AJx2EqbPfgna67hkooby7utHnNkDPDs3b69fBsnQGQ+p6Q9pxyz0fawx/k
+NSBT8lTR32GDpgLiJTjehTItXnOQUl1CxM49S+H5GYQd1aJQzEH7QRTDvdbJWqNj
+ZgKAvQU6O0ec7AAmTPWIUb+oI38YB7AL7YsmoWTTYUrrXJ/es69nA7Mf3W1daWhp
+q1467HxpvMc7hU6eFbm0FU/DlXpY18ls6Wy58yljXrQs8C097Vpl4KlbQMJImYFt
+nh8GKjwStIsPm6Ik8KaN1nrgS7ZklmOVhMJKzRwuJIczYOXD
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 2 G3"
+# Serial: 390156079458959257446133169266079962026824725800
+# MD5 Fingerprint: af:0c:86:6e:bf:40:2d:7f:0b:3e:12:50:ba:12:3d:06
+# SHA1 Fingerprint: 09:3c:61:f3:8b:8b:dc:7d:55:df:75:38:02:05:00:e1:25:f5:c8:36
+# SHA256 Fingerprint: 8f:e4:fb:0a:f9:3a:4d:0d:67:db:0b:eb:b2:3e:37:c7:1b:f3:25:dc:bc:dd:24:0e:a0:4d:af:58:b4:7e:18:40
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIURFc0JFuBiZs18s64KztbpybwdSgwDQYJKoZIhvcNAQEL
+BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
+BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMiBHMzAeFw0xMjAxMTIxODU5MzJaFw00
+MjAxMTIxODU5MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
+aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDIgRzMwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQChriWyARjcV4g/Ruv5r+LrI3HimtFhZiFf
+qq8nUeVuGxbULX1QsFN3vXg6YOJkApt8hpvWGo6t/x8Vf9WVHhLL5hSEBMHfNrMW
+n4rjyduYNM7YMxcoRvynyfDStNVNCXJJ+fKH46nafaF9a7I6JaltUkSs+L5u+9ym
+c5GQYaYDFCDy54ejiK2toIz/pgslUiXnFgHVy7g1gQyjO/Dh4fxaXc6AcW34Sas+
+O7q414AB+6XrW7PFXmAqMaCvN+ggOp+oMiwMzAkd056OXbxMmO7FGmh77FOm6RQ1
+o9/NgJ8MSPsc9PG/Srj61YxxSscfrf5BmrODXfKEVu+lV0POKa2Mq1W/xPtbAd0j
+IaFYAI7D0GoT7RPjEiuA3GfmlbLNHiJuKvhB1PLKFAeNilUSxmn1uIZoL1NesNKq
+IcGY5jDjZ1XHm26sGahVpkUG0CM62+tlXSoREfA7T8pt9DTEceT/AFr2XK4jYIVz
+8eQQsSWu1ZK7E8EM4DnatDlXtas1qnIhO4M15zHfeiFuuDIIfR0ykRVKYnLP43eh
+vNURG3YBZwjgQQvD6xVu+KQZ2aKrr+InUlYrAoosFCT5v0ICvybIxo/gbjh9Uy3l
+7ZizlWNof/k19N+IxWA1ksB8aRxhlRbQ694Lrz4EEEVlWFA4r0jyWbYW8jwNkALG
+cC4BrTwV1wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+BjAdBgNVHQ4EFgQU7edvdlq/YOxJW8ald7tyFnGbxD0wDQYJKoZIhvcNAQELBQAD
+ggIBAJHfgD9DCX5xwvfrs4iP4VGyvD11+ShdyLyZm3tdquXK4Qr36LLTn91nMX66
+AarHakE7kNQIXLJgapDwyM4DYvmL7ftuKtwGTTwpD4kWilhMSA/ohGHqPHKmd+RC
+roijQ1h5fq7KpVMNqT1wvSAZYaRsOPxDMuHBR//47PERIjKWnML2W2mWeyAMQ0Ga
+W/ZZGYjeVYg3UQt4XAoeo0L9x52ID8DyeAIkVJOviYeIyUqAHerQbj5hLja7NQ4n
+lv1mNDthcnPxFlxHBlRJAHpYErAK74X9sbgzdWqTHBLmYF5vHX/JHyPLhGGfHoJE
++V+tYlUkmlKY7VHnoX6XOuYvHxHaU4AshZ6rNRDbIl9qxV6XU/IyAgkwo1jwDQHV
+csaxfGl7w/U2Rcxhbl5MlMVerugOXou/983g7aEOGzPuVBj+D77vfoRrQ+NwmNtd
+dbINWQeFFSM51vHfqSYP1kjHs6Yi9TM3WpVHn3u6GBVv/9YUZINJ0gpnIdsPNWNg
+KCLjsZWDzYWm3S8P52dSbrsvhXz1SnPnxT7AvSESBT/8twNJAlvIJebiVDj1eYeM
+HVOyToV7BjjHLPj4sHKNJeV3UvQDHEimUF+IIDBu8oJDqz2XhOdT+yHBTw8imoa4
+WSr2Rz0ZiC3oheGe7IUIarFsNMkd7EgrO3jtZsSOeWmD3n+M
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 3 G3"
+# Serial: 268090761170461462463995952157327242137089239581
+# MD5 Fingerprint: df:7d:b9:ad:54:6f:68:a1:df:89:57:03:97:43:b0:d7
+# SHA1 Fingerprint: 48:12:bd:92:3c:a8:c4:39:06:e7:30:6d:27:96:e6:a4:cf:22:2e:7d
+# SHA256 Fingerprint: 88:ef:81:de:20:2e:b0:18:45:2e:43:f8:64:72:5c:ea:5f:bd:1f:c2:d9:d2:05:73:07:09:c5:d8:b8:69:0f:46
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIULvWbAiin23r/1aOp7r0DoM8Sah0wDQYJKoZIhvcNAQEL
+BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
+BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMyBHMzAeFw0xMjAxMTIyMDI2MzJaFw00
+MjAxMTIyMDI2MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
+aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDMgRzMwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCzyw4QZ47qFJenMioKVjZ/aEzHs286IxSR
+/xl/pcqs7rN2nXrpixurazHb+gtTTK/FpRp5PIpM/6zfJd5O2YIyC0TeytuMrKNu
+FoM7pmRLMon7FhY4futD4tN0SsJiCnMK3UmzV9KwCoWdcTzeo8vAMvMBOSBDGzXR
+U7Ox7sWTaYI+FrUoRqHe6okJ7UO4BUaKhvVZR74bbwEhELn9qdIoyhA5CcoTNs+c
+ra1AdHkrAj80//ogaX3T7mH1urPnMNA3I4ZyYUUpSFlob3emLoG+B01vr87ERROR
+FHAGjx+f+IdpsQ7vw4kZ6+ocYfx6bIrc1gMLnia6Et3UVDmrJqMz6nWB2i3ND0/k
+A9HvFZcba5DFApCTZgIhsUfei5pKgLlVj7WiL8DWM2fafsSntARE60f75li59wzw
+eyuxwHApw0BiLTtIadwjPEjrewl5qW3aqDCYz4ByA4imW0aucnl8CAMhZa634Ryl
+sSqiMd5mBPfAdOhx3v89WcyWJhKLhZVXGqtrdQtEPREoPHtht+KPZ0/l7DxMYIBp
+VzgeAVuNVejH38DMdyM0SXV89pgR6y3e7UEuFAUCf+D+IOs15xGsIs5XPd7JMG0Q
+A4XN8f+MFrXBsj6IbGB/kE+V9/YtrQE5BwT6dYB9v0lQ7e/JxHwc64B+27bQ3RP+
+ydOc17KXqQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+BjAdBgNVHQ4EFgQUxhfQvKjqAkPyGwaZXSuQILnXnOQwDQYJKoZIhvcNAQELBQAD
+ggIBADRh2Va1EodVTd2jNTFGu6QHcrxfYWLopfsLN7E8trP6KZ1/AvWkyaiTt3px
+KGmPc+FSkNrVvjrlt3ZqVoAh313m6Tqe5T72omnHKgqwGEfcIHB9UqM+WXzBusnI
+FUBhynLWcKzSt/Ac5IYp8M7vaGPQtSCKFWGafoaYtMnCdvvMujAWzKNhxnQT5Wvv
+oxXqA/4Ti2Tk08HS6IT7SdEQTXlm66r99I0xHnAUrdzeZxNMgRVhvLfZkXdxGYFg
+u/BYpbWcC/ePIlUnwEsBbTuZDdQdm2NnL9DuDcpmvJRPpq3t/O5jrFc/ZSXPsoaP
+0Aj/uHYUbt7lJ+yreLVTubY/6CD50qi+YUbKh4yE8/nxoGibIh6BJpsQBJFxwAYf
+3KDTuVan45gtf4Od34wrnDKOMpTwATwiKp9Dwi7DmDkHOHv8XgBCH/MyJnmDhPbl
+8MFREsALHgQjDFSlTC9JxUrRtm5gDWv8a4uFJGS3iQ6rJUdbPM9+Sb3H6QrG2vd+
+DhcI00iX0HGS8A85PjRqHH3Y8iKuu2n0M7SmSFXRDw4m6Oy2Cy2nhTXN/VnIn9HN
+PlopNLk9hM6xZdRZkZFWdSHBd575euFgndOtBBj0fOtek49TSiIp+EgrPk2GrFt/
+ywaZWWDYWGWVjUTR939+J399roD1B0y2PpxxVJkES/1Y+Zj0
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Assured ID Root G2"
+# Serial: 15385348160840213938643033620894905419
+# MD5 Fingerprint: 92:38:b9:f8:63:24:82:65:2c:57:33:e6:fe:81:8f:9d
+# SHA1 Fingerprint: a1:4b:48:d9:43:ee:0a:0e:40:90:4f:3c:e0:a4:c0:91:93:51:5d:3f
+# SHA256 Fingerprint: 7d:05:eb:b6:82:33:9f:8c:94:51:ee:09:4e:eb:fe:fa:79:53:a1:14:ed:b2:f4:49:49:45:2f:ab:7d:2f:c1:85
+-----BEGIN CERTIFICATE-----
+MIIDljCCAn6gAwIBAgIQC5McOtY5Z+pnI7/Dr5r0SzANBgkqhkiG9w0BAQsFADBl
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
+b3QgRzIwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQG
+EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
+cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzIwggEi
+MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDZ5ygvUj82ckmIkzTz+GoeMVSA
+n61UQbVH35ao1K+ALbkKz3X9iaV9JPrjIgwrvJUXCzO/GU1BBpAAvQxNEP4Htecc
+biJVMWWXvdMX0h5i89vqbFCMP4QMls+3ywPgym2hFEwbid3tALBSfK+RbLE4E9Hp
+EgjAALAcKxHad3A2m67OeYfcgnDmCXRwVWmvo2ifv922ebPynXApVfSr/5Vh88lA
+bx3RvpO704gqu52/clpWcTs/1PPRCv4o76Pu2ZmvA9OPYLfykqGxvYmJHzDNw6Yu
+YjOuFgJ3RFrngQo8p0Quebg/BLxcoIfhG69Rjs3sLPr4/m3wOnyqi+RnlTGNAgMB
+AAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQW
+BBTOw0q5mVXyuNtgv6l+vVa1lzan1jANBgkqhkiG9w0BAQsFAAOCAQEAyqVVjOPI
+QW5pJ6d1Ee88hjZv0p3GeDgdaZaikmkuOGybfQTUiaWxMTeKySHMq2zNixya1r9I
+0jJmwYrA8y8678Dj1JGG0VDjA9tzd29KOVPt3ibHtX2vK0LRdWLjSisCx1BL4Gni
+lmwORGYQRI+tBev4eaymG+g3NJ1TyWGqolKvSnAWhsI6yLETcDbYz+70CjTVW0z9
+B5yiutkBclzzTcHdDrEcDcRjvq30FPuJ7KJBDkzMyFdA0G4Dqs0MjomZmWzwPDCv
+ON9vvKO+KSAnq3T/EyJ43pdSVR6DtVQgA+6uwE9W3jfMw3+qBCe703e4YtsXfJwo
+IhNzbM8m9Yop5w==
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Assured ID Root G3"
+# Serial: 15459312981008553731928384953135426796
+# MD5 Fingerprint: 7c:7f:65:31:0c:81:df:8d:ba:3e:99:e2:5c:ad:6e:fb
+# SHA1 Fingerprint: f5:17:a2:4f:9a:48:c6:c9:f8:a2:00:26:9f:dc:0f:48:2c:ab:30:89
+# SHA256 Fingerprint: 7e:37:cb:8b:4c:47:09:0c:ab:36:55:1b:a6:f4:5d:b8:40:68:0f:ba:16:6a:95:2d:b1:00:71:7f:43:05:3f:c2
+-----BEGIN CERTIFICATE-----
+MIICRjCCAc2gAwIBAgIQC6Fa+h3foLVJRK/NJKBs7DAKBggqhkjOPQQDAzBlMQsw
+CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu
+ZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3Qg
+RzMwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQGEwJV
+UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu
+Y29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzMwdjAQBgcq
+hkjOPQIBBgUrgQQAIgNiAAQZ57ysRGXtzbg/WPuNsVepRC0FFfLvC/8QdJ+1YlJf
+Zn4f5dwbRXkLzMZTCp2NXQLZqVneAlr2lSoOjThKiknGvMYDOAdfVdp+CW7if17Q
+RSAPWXYQ1qAk8C3eNvJsKTmjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/
+BAQDAgGGMB0GA1UdDgQWBBTL0L2p4ZgFUaFNN6KDec6NHSrkhDAKBggqhkjOPQQD
+AwNnADBkAjAlpIFFAmsSS3V0T8gj43DydXLefInwz5FyYZ5eEJJZVrmDxxDnOOlY
+JjZ91eQ0hjkCMHw2U/Aw5WJjOpnitqM7mzT6HtoQknFekROn3aRukswy1vUhZscv
+6pZjamVFkpUBtA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Global Root G2"
+# Serial: 4293743540046975378534879503202253541
+# MD5 Fingerprint: e4:a6:8a:c8:54:ac:52:42:46:0a:fd:72:48:1b:2a:44
+# SHA1 Fingerprint: df:3c:24:f9:bf:d6:66:76:1b:26:80:73:fe:06:d1:cc:8d:4f:82:a4
+# SHA256 Fingerprint: cb:3c:cb:b7:60:31:e5:e0:13:8f:8d:d3:9a:23:f9:de:47:ff:c3:5e:43:c1:14:4c:ea:27:d4:6a:5a:b1:cb:5f
+-----BEGIN CERTIFICATE-----
+MIIDjjCCAnagAwIBAgIQAzrx5qcRqaC7KGSxHQn65TANBgkqhkiG9w0BAQsFADBh
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBH
+MjAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVT
+MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
+b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEcyMIIBIjANBgkqhkiG
+9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuzfNNNx7a8myaJCtSnX/RrohCgiN9RlUyfuI
+2/Ou8jqJkTx65qsGGmvPrC3oXgkkRLpimn7Wo6h+4FR1IAWsULecYxpsMNzaHxmx
+1x7e/dfgy5SDN67sH0NO3Xss0r0upS/kqbitOtSZpLYl6ZtrAGCSYP9PIUkY92eQ
+q2EGnI/yuum06ZIya7XzV+hdG82MHauVBJVJ8zUtluNJbd134/tJS7SsVQepj5Wz
+tCO7TG1F8PapspUwtP1MVYwnSlcUfIKdzXOS0xZKBgyMUNGPHgm+F6HmIcr9g+UQ
+vIOlCsRnKPZzFBQ9RnbDhxSJITRNrw9FDKZJobq7nMWxM4MphQIDAQABo0IwQDAP
+BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUTiJUIBiV
+5uNu5g/6+rkS7QYXjzkwDQYJKoZIhvcNAQELBQADggEBAGBnKJRvDkhj6zHd6mcY
+1Yl9PMWLSn/pvtsrF9+wX3N3KjITOYFnQoQj8kVnNeyIv/iPsGEMNKSuIEyExtv4
+NeF22d+mQrvHRAiGfzZ0JFrabA0UWTW98kndth/Jsw1HKj2ZL7tcu7XUIOGZX1NG
+Fdtom/DzMNU+MeKNhJ7jitralj41E6Vf8PlwUHBHQRFXGU7Aj64GxJUTFy8bJZ91
+8rGOmaFvE7FBcf6IKshPECBV1/MUReXgRPTqh5Uykw7+U0b6LJ3/iyK5S9kJRaTe
+pLiaWN0bfVKfjllDiIGknibVb63dDcY3fe0Dkhvld1927jyNxF1WW6LZZm6zNTfl
+MrY=
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Global Root G3"
+# Serial: 7089244469030293291760083333884364146
+# MD5 Fingerprint: f5:5d:a4:50:a5:fb:28:7e:1e:0f:0d:cc:96:57:56:ca
+# SHA1 Fingerprint: 7e:04:de:89:6a:3e:66:6d:00:e6:87:d3:3f:fa:d9:3b:e8:3d:34:9e
+# SHA256 Fingerprint: 31:ad:66:48:f8:10:41:38:c7:38:f3:9e:a4:32:01:33:39:3e:3a:18:cc:02:29:6e:f9:7c:2a:c9:ef:67:31:d0
+-----BEGIN CERTIFICATE-----
+MIICPzCCAcWgAwIBAgIQBVVWvPJepDU1w6QP1atFcjAKBggqhkjOPQQDAzBhMQsw
+CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu
+ZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBHMzAe
+Fw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVTMRUw
+EwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20x
+IDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEczMHYwEAYHKoZIzj0CAQYF
+K4EEACIDYgAE3afZu4q4C/sLfyHS8L6+c/MzXRq8NOrexpu80JX28MzQC7phW1FG
+fp4tn+6OYwwX7Adw9c+ELkCDnOg/QW07rdOkFFk2eJ0DQ+4QE2xy3q6Ip6FrtUPO
+Z9wj/wMco+I+o0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAd
+BgNVHQ4EFgQUs9tIpPmhxdiuNkHMEWNpYim8S8YwCgYIKoZIzj0EAwMDaAAwZQIx
+AK288mw/EkrRLTnDCgmXc/SINoyIJ7vmiI1Qhadj+Z4y3maTD/HMsQmP3Wyr+mt/
+oAIwOWZbwmSNuJ5Q3KjVSaLtx9zRSX8XAbjIho9OjIgrqJqpisXRAL34VOKa5Vt8
+sycX
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Trusted Root G4"
+# Serial: 7451500558977370777930084869016614236
+# MD5 Fingerprint: 78:f2:fc:aa:60:1f:2f:b4:eb:c9:37:ba:53:2e:75:49
+# SHA1 Fingerprint: dd:fb:16:cd:49:31:c9:73:a2:03:7d:3f:c8:3a:4d:7d:77:5d:05:e4
+# SHA256 Fingerprint: 55:2f:7b:dc:f1:a7:af:9e:6c:e6:72:01:7f:4f:12:ab:f7:72:40:c7:8e:76:1a:c2:03:d1:d9:d2:0a:c8:99:88
+-----BEGIN CERTIFICATE-----
+MIIFkDCCA3igAwIBAgIQBZsbV56OITLiOQe9p3d1XDANBgkqhkiG9w0BAQwFADBi
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3Qg
+RzQwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBiMQswCQYDVQQGEwJV
+UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu
+Y29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz7MKnJS7JIT3y
+ithZwuEppz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS5F/WBTxSD1If
+xp4VpX6+n6lXFllVcq9ok3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7bXHiLQwb7iDV
+ySAdYyktzuxeTsiT+CFhmzTrBcZe7FsavOvJz82sNEBfsXpm7nfISKhmV1efVFiO
+DCu3T6cw2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGYQJB5w3jHtrHEtWoYOAMQ
+jdjUN6QuBX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14Ztk6MUSaM0C/
+CNdaSaTC5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2h4mXaXpI8OCi
+EhtmmnTK3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt6zPZxd9LBADM
+fRyVw4/3IbKyEbe7f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPRiQfhvbfmQ6QY
+uKZ3AeEPlAwhHbJUKSWJbOUOUlFHdL4mrLZBdd56rF+NP8m800ERElvlEFDrMcXK
+chYiCd98THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8oR7FwI+isX4KJpn15GkvmB0t
+9dmpsh3lGwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+hjAdBgNVHQ4EFgQU7NfjgtJxXWRM3y5nP+e6mK4cD08wDQYJKoZIhvcNAQEMBQAD
+ggIBALth2X2pbL4XxJEbw6GiAI3jZGgPVs93rnD5/ZpKmbnJeFwMDF/k5hQpVgs2
+SV1EY+CtnJYYZhsjDT156W1r1lT40jzBQ0CuHVD1UvyQO7uYmWlrx8GnqGikJ9yd
++SeuMIW59mdNOj6PWTkiU0TryF0Dyu1Qen1iIQqAyHNm0aAFYF/opbSnr6j3bTWc
+fFqK1qI4mfN4i/RN0iAL3gTujJtHgXINwBQy7zBZLq7gcfJW5GqXb5JQbZaNaHqa
+sjYUegbyJLkJEVDXCLG4iXqEI2FCKeWjzaIgQdfRnGTZ6iahixTXTBmyUEFxPT9N
+cCOGDErcgdLMMpSEDQgJlxxPwO5rIHQw0uA5NBCFIRUBCOhVMt5xSdkoF1BN5r5N
+0XWs0Mr7QbhDparTwwVETyw2m+L64kW4I1NsBm9nVX9GtUw/bihaeSbSpKhil9Ie
+4u1Ki7wb/UdKDd9nZn6yW0HQO+T0O/QEY+nvwlQAUaCKKsnOeMzV6ocEGLPOr0mI
+r/OSmbaz5mEP0oUA51Aa5BuVnRmhuZyxm7EAHu/QD09CbMkKvO5D+jpxpchNJqU1
+/YldvIViHTLSoCtU7ZpXwdv6EM8Zt4tKG48BtieVU+i2iW1bvGjUI+iLUaJW+fCm
+gKDWHrO8Dw9TdSmq6hN35N6MgSGtBxBHEa2HPQfRdbzP82Z+
+-----END CERTIFICATE-----
+
+# Issuer: CN=COMODO RSA Certification Authority O=COMODO CA Limited
+# Subject: CN=COMODO RSA Certification Authority O=COMODO CA Limited
+# Label: "COMODO RSA Certification Authority"
+# Serial: 101909084537582093308941363524873193117
+# MD5 Fingerprint: 1b:31:b0:71:40:36:cc:14:36:91:ad:c4:3e:fd:ec:18
+# SHA1 Fingerprint: af:e5:d2:44:a8:d1:19:42:30:ff:47:9f:e2:f8:97:bb:cd:7a:8c:b4
+# SHA256 Fingerprint: 52:f0:e1:c4:e5:8e:c6:29:29:1b:60:31:7f:07:46:71:b8:5d:7e:a8:0d:5b:07:27:34:63:53:4b:32:b4:02:34
+-----BEGIN CERTIFICATE-----
+MIIF2DCCA8CgAwIBAgIQTKr5yttjb+Af907YWwOGnTANBgkqhkiG9w0BAQwFADCB
+hTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
+A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNV
+BAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMTE5
+MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgT
+EkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMR
+Q09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNh
+dGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCR
+6FSS0gpWsawNJN3Fz0RndJkrN6N9I3AAcbxT38T6KhKPS38QVr2fcHK3YX/JSw8X
+pz3jsARh7v8Rl8f0hj4K+j5c+ZPmNHrZFGvnnLOFoIJ6dq9xkNfs/Q36nGz637CC
+9BR++b7Epi9Pf5l/tfxnQ3K9DADWietrLNPtj5gcFKt+5eNu/Nio5JIk2kNrYrhV
+/erBvGy2i/MOjZrkm2xpmfh4SDBF1a3hDTxFYPwyllEnvGfDyi62a+pGx8cgoLEf
+Zd5ICLqkTqnyg0Y3hOvozIFIQ2dOciqbXL1MGyiKXCJ7tKuY2e7gUYPDCUZObT6Z
++pUX2nwzV0E8jVHtC7ZcryxjGt9XyD+86V3Em69FmeKjWiS0uqlWPc9vqv9JWL7w
+qP/0uK3pN/u6uPQLOvnoQ0IeidiEyxPx2bvhiWC4jChWrBQdnArncevPDt09qZah
+SL0896+1DSJMwBGB7FY79tOi4lu3sgQiUpWAk2nojkxl8ZEDLXB0AuqLZxUpaVIC
+u9ffUGpVRr+goyhhf3DQw6KqLCGqR84onAZFdr+CGCe01a60y1Dma/RMhnEw6abf
+Fobg2P9A3fvQQoh/ozM6LlweQRGBY84YcWsr7KaKtzFcOmpH4MN5WdYgGq/yapiq
+crxXStJLnbsQ/LBMQeXtHT1eKJ2czL+zUdqnR+WEUwIDAQABo0IwQDAdBgNVHQ4E
+FgQUu69+Aj36pvE8hI6t7jiY7NkyMtQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB
+/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAArx1UaEt65Ru2yyTUEUAJNMnMvl
+wFTPoCWOAvn9sKIN9SCYPBMtrFaisNZ+EZLpLrqeLppysb0ZRGxhNaKatBYSaVqM
+4dc+pBroLwP0rmEdEBsqpIt6xf4FpuHA1sj+nq6PK7o9mfjYcwlYRm6mnPTXJ9OV
+2jeDchzTc+CiR5kDOF3VSXkAKRzH7JsgHAckaVd4sjn8OoSgtZx8jb8uk2Intzna
+FxiuvTwJaP+EmzzV1gsD41eeFPfR60/IvYcjt7ZJQ3mFXLrrkguhxuhoqEwWsRqZ
+CuhTLJK7oQkYdQxlqHvLI7cawiiFwxv/0Cti76R7CZGYZ4wUAc1oBmpjIXUDgIiK
+boHGhfKppC3n9KUkEEeDys30jXlYsQab5xoq2Z0B15R97QNKyvDb6KkBPvVWmcke
+jkk9u+UJueBPSZI9FoJAzMxZxuY67RIuaTxslbH9qh17f4a+Hg4yRvv7E491f0yL
+S0Zj/gA0QHDBw7mh3aZw4gSzQbzpgJHqZJx64SIDqZxubw5lT2yHh17zbqD5daWb
+QOhTsiedSrnAdyGN/4fy3ryM7xfft0kL0fJuMAsaDk527RH89elWsn2/x20Kk4yl
+0MC2Hb46TpSi125sC8KKfPog88Tk5c0NqMuRkrF8hey1FGlmDoLnzc7ILaZRfyHB
+NVOFBkpdn627G190
+-----END CERTIFICATE-----
+
+# Issuer: CN=USERTrust RSA Certification Authority O=The USERTRUST Network
+# Subject: CN=USERTrust RSA Certification Authority O=The USERTRUST Network
+# Label: "USERTrust RSA Certification Authority"
+# Serial: 2645093764781058787591871645665788717
+# MD5 Fingerprint: 1b:fe:69:d1:91:b7:19:33:a3:72:a8:0f:e1:55:e5:b5
+# SHA1 Fingerprint: 2b:8f:1b:57:33:0d:bb:a2:d0:7a:6c:51:f7:0e:e9:0d:da:b9:ad:8e
+# SHA256 Fingerprint: e7:93:c9:b0:2f:d8:aa:13:e2:1c:31:22:8a:cc:b0:81:19:64:3b:74:9c:89:89:64:b1:74:6d:46:c3:d4:cb:d2
+-----BEGIN CERTIFICATE-----
+MIIF3jCCA8agAwIBAgIQAf1tMPyjylGoG7xkDjUDLTANBgkqhkiG9w0BAQwFADCB
+iDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0pl
+cnNleSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNV
+BAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAw
+MjAxMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNV
+BAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVU
+aGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2Vy
+dGlmaWNhdGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK
+AoICAQCAEmUXNg7D2wiz0KxXDXbtzSfTTK1Qg2HiqiBNCS1kCdzOiZ/MPans9s/B
+3PHTsdZ7NygRK0faOca8Ohm0X6a9fZ2jY0K2dvKpOyuR+OJv0OwWIJAJPuLodMkY
+tJHUYmTbf6MG8YgYapAiPLz+E/CHFHv25B+O1ORRxhFnRghRy4YUVD+8M/5+bJz/
+Fp0YvVGONaanZshyZ9shZrHUm3gDwFA66Mzw3LyeTP6vBZY1H1dat//O+T23LLb2
+VN3I5xI6Ta5MirdcmrS3ID3KfyI0rn47aGYBROcBTkZTmzNg95S+UzeQc0PzMsNT
+79uq/nROacdrjGCT3sTHDN/hMq7MkztReJVni+49Vv4M0GkPGw/zJSZrM233bkf6
+c0Plfg6lZrEpfDKEY1WJxA3Bk1QwGROs0303p+tdOmw1XNtB1xLaqUkL39iAigmT
+Yo61Zs8liM2EuLE/pDkP2QKe6xJMlXzzawWpXhaDzLhn4ugTncxbgtNMs+1b/97l
+c6wjOy0AvzVVdAlJ2ElYGn+SNuZRkg7zJn0cTRe8yexDJtC/QV9AqURE9JnnV4ee
+UB9XVKg+/XRjL7FQZQnmWEIuQxpMtPAlR1n6BB6T1CZGSlCBst6+eLf8ZxXhyVeE
+Hg9j1uliutZfVS7qXMYoCAQlObgOK6nyTJccBz8NUvXt7y+CDwIDAQABo0IwQDAd
+BgNVHQ4EFgQUU3m/WqorSs9UgOHYm8Cd8rIDZsswDgYDVR0PAQH/BAQDAgEGMA8G
+A1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAFzUfA3P9wF9QZllDHPF
+Up/L+M+ZBn8b2kMVn54CVVeWFPFSPCeHlCjtHzoBN6J2/FNQwISbxmtOuowhT6KO
+VWKR82kV2LyI48SqC/3vqOlLVSoGIG1VeCkZ7l8wXEskEVX/JJpuXior7gtNn3/3
+ATiUFJVDBwn7YKnuHKsSjKCaXqeYalltiz8I+8jRRa8YFWSQEg9zKC7F4iRO/Fjs
+8PRF/iKz6y+O0tlFYQXBl2+odnKPi4w2r78NBc5xjeambx9spnFixdjQg3IM8WcR
+iQycE0xyNN+81XHfqnHd4blsjDwSXWXavVcStkNr/+XeTWYRUc+ZruwXtuhxkYze
+Sf7dNXGiFSeUHM9h4ya7b6NnJSFd5t0dCy5oGzuCr+yDZ4XUmFF0sbmZgIn/f3gZ
+XHlKYC6SQK5MNyosycdiyA5d9zZbyuAlJQG03RoHnHcAP9Dc1ew91Pq7P8yF1m9/
+qS3fuQL39ZeatTXaw2ewh0qpKJ4jjv9cJ2vhsE/zB+4ALtRZh8tSQZXq9EfX7mRB
+VXyNWQKV3WKdwrnuWih0hKWbt5DHDAff9Yk2dDLWKMGwsAvgnEzDHNb842m1R0aB
+L6KCq9NjRHDEjf8tM7qtj3u1cIiuPhnPQCjY/MiQu12ZIvVS5ljFH4gxQ+6IHdfG
+jjxDah2nGN59PRbxYvnKkKj9
+-----END CERTIFICATE-----
+
+# Issuer: CN=USERTrust ECC Certification Authority O=The USERTRUST Network
+# Subject: CN=USERTrust ECC Certification Authority O=The USERTRUST Network
+# Label: "USERTrust ECC Certification Authority"
+# Serial: 123013823720199481456569720443997572134
+# MD5 Fingerprint: fa:68:bc:d9:b5:7f:ad:fd:c9:1d:06:83:28:cc:24:c1
+# SHA1 Fingerprint: d1:cb:ca:5d:b2:d5:2a:7f:69:3b:67:4d:e5:f0:5a:1d:0c:95:7d:f0
+# SHA256 Fingerprint: 4f:f4:60:d5:4b:9c:86:da:bf:bc:fc:57:12:e0:40:0d:2b:ed:3f:bc:4d:4f:bd:aa:86:e0:6a:dc:d2:a9:ad:7a
+-----BEGIN CERTIFICATE-----
+MIICjzCCAhWgAwIBAgIQXIuZxVqUxdJxVt7NiYDMJjAKBggqhkjOPQQDAzCBiDEL
+MAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNl
+eSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMT
+JVVTRVJUcnVzdCBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMjAx
+MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT
+Ck5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVUaGUg
+VVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBFQ0MgQ2VydGlm
+aWNhdGlvbiBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQarFRaqflo
+I+d61SRvU8Za2EurxtW20eZzca7dnNYMYf3boIkDuAUU7FfO7l0/4iGzzvfUinng
+o4N+LZfQYcTxmdwlkWOrfzCjtHDix6EznPO/LlxTsV+zfTJ/ijTjeXmjQjBAMB0G
+A1UdDgQWBBQ64QmG1M8ZwpZ2dEl23OA1xmNjmjAOBgNVHQ8BAf8EBAMCAQYwDwYD
+VR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjA2Z6EWCNzklwBBHU6+4WMB
+zzuqQhFkoJ2UOQIReVx7Hfpkue4WQrO/isIJxOzksU0CMQDpKmFHjFJKS04YcPbW
+RNZu9YO6bVi9JNlWSOrvxKJGgYhqOkbRqZtNyWHa0V1Xahg=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
+# Label: "GlobalSign ECC Root CA - R4"
+# Serial: 14367148294922964480859022125800977897474
+# MD5 Fingerprint: 20:f0:27:68:d1:7e:a0:9d:0e:e6:2a:ca:df:5c:89:8e
+# SHA1 Fingerprint: 69:69:56:2e:40:80:f4:24:a1:e7:19:9f:14:ba:f3:ee:58:ab:6a:bb
+# SHA256 Fingerprint: be:c9:49:11:c2:95:56:76:db:6c:0a:55:09:86:d7:6e:3b:a0:05:66:7c:44:2c:97:62:b4:fb:b7:73:de:22:8c
+-----BEGIN CERTIFICATE-----
+MIIB4TCCAYegAwIBAgIRKjikHJYKBN5CsiilC+g0mAIwCgYIKoZIzj0EAwIwUDEk
+MCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI0MRMwEQYDVQQKEwpH
+bG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoX
+DTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBD
+QSAtIFI0MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWdu
+MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEuMZ5049sJQ6fLjkZHAOkrprlOQcJ
+FspjsbmG+IpXwVfOQvpzofdlQv8ewQCybnMO/8ch5RikqtlxP6jUuc6MHaNCMEAw
+DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFFSwe61F
+uOJAf/sKbvu+M8k8o4TVMAoGCCqGSM49BAMCA0gAMEUCIQDckqGgE6bPA7DmxCGX
+kPoUVy0D7O48027KqGx2vKLeuwIgJ6iFJzWbVsaj8kfSt24bAgAXqmemFZHe+pTs
+ewv4n4Q=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5
+# Label: "GlobalSign ECC Root CA - R5"
+# Serial: 32785792099990507226680698011560947931244
+# MD5 Fingerprint: 9f:ad:3b:1c:02:1e:8a:ba:17:74:38:81:0c:a2:bc:08
+# SHA1 Fingerprint: 1f:24:c6:30:cd:a4:18:ef:20:69:ff:ad:4f:dd:5f:46:3a:1b:69:aa
+# SHA256 Fingerprint: 17:9f:bc:14:8a:3d:d0:0f:d2:4e:a1:34:58:cc:43:bf:a7:f5:9c:81:82:d7:83:a5:13:f6:eb:ec:10:0c:89:24
+-----BEGIN CERTIFICATE-----
+MIICHjCCAaSgAwIBAgIRYFlJ4CYuu1X5CneKcflK2GwwCgYIKoZIzj0EAwMwUDEk
+MCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI1MRMwEQYDVQQKEwpH
+bG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoX
+DTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBD
+QSAtIFI1MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWdu
+MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAER0UOlvt9Xb/pOdEh+J8LttV7HpI6SFkc
+8GIxLcB6KP4ap1yztsyX50XUWPrRd21DosCHZTQKH3rd6zwzocWdTaRvQZU4f8ke
+hOvRnkmSh5SHDDqFSmafnVmTTZdhBoZKo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYD
+VR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUPeYpSJvqB8ohREom3m7e0oPQn1kwCgYI
+KoZIzj0EAwMDaAAwZQIxAOVpEslu28YxuglB4Zf4+/2a4n0Sye18ZNPLBSWLVtmg
+515dTguDnFt2KaAJJiFqYgIwcdK1j1zqO+F4CYWodZI7yFz9SO8NdCKoCOJuxUnO
+xwy8p2Fp8fc74SrL+SvzZpA3
+-----END CERTIFICATE-----
+
+# Issuer: CN=Staat der Nederlanden EV Root CA O=Staat der Nederlanden
+# Subject: CN=Staat der Nederlanden EV Root CA O=Staat der Nederlanden
+# Label: "Staat der Nederlanden EV Root CA"
+# Serial: 10000013
+# MD5 Fingerprint: fc:06:af:7b:e8:1a:f1:9a:b4:e8:d2:70:1f:c0:f5:ba
+# SHA1 Fingerprint: 76:e2:7e:c1:4f:db:82:c1:c0:a6:75:b5:05:be:3d:29:b4:ed:db:bb
+# SHA256 Fingerprint: 4d:24:91:41:4c:fe:95:67:46:ec:4c:ef:a6:cf:6f:72:e2:8a:13:29:43:2f:9d:8a:90:7a:c4:cb:5d:ad:c1:5a
+-----BEGIN CERTIFICATE-----
+MIIFcDCCA1igAwIBAgIEAJiWjTANBgkqhkiG9w0BAQsFADBYMQswCQYDVQQGEwJO
+TDEeMBwGA1UECgwVU3RhYXQgZGVyIE5lZGVybGFuZGVuMSkwJwYDVQQDDCBTdGFh
+dCBkZXIgTmVkZXJsYW5kZW4gRVYgUm9vdCBDQTAeFw0xMDEyMDgxMTE5MjlaFw0y
+MjEyMDgxMTEwMjhaMFgxCzAJBgNVBAYTAk5MMR4wHAYDVQQKDBVTdGFhdCBkZXIg
+TmVkZXJsYW5kZW4xKTAnBgNVBAMMIFN0YWF0IGRlciBOZWRlcmxhbmRlbiBFViBS
+b290IENBMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA48d+ifkkSzrS
+M4M1LGns3Amk41GoJSt5uAg94JG6hIXGhaTK5skuU6TJJB79VWZxXSzFYGgEt9nC
+UiY4iKTWO0Cmws0/zZiTs1QUWJZV1VD+hq2kY39ch/aO5ieSZxeSAgMs3NZmdO3d
+Z//BYY1jTw+bbRcwJu+r0h8QoPnFfxZpgQNH7R5ojXKhTbImxrpsX23Wr9GxE46p
+rfNeaXUmGD5BKyF/7otdBwadQ8QpCiv8Kj6GyzyDOvnJDdrFmeK8eEEzduG/L13l
+pJhQDBXd4Pqcfzho0LKmeqfRMb1+ilgnQ7O6M5HTp5gVXJrm0w912fxBmJc+qiXb
+j5IusHsMX/FjqTf5m3VpTCgmJdrV8hJwRVXj33NeN/UhbJCONVrJ0yPr08C+eKxC
+KFhmpUZtcALXEPlLVPxdhkqHz3/KRawRWrUgUY0viEeXOcDPusBCAUCZSCELa6fS
+/ZbV0b5GnUngC6agIk440ME8MLxwjyx1zNDFjFE7PZQIZCZhfbnDZY8UnCHQqv0X
+cgOPvZuM5l5Tnrmd74K74bzickFbIZTTRTeU0d8JOV3nI6qaHcptqAqGhYqCvkIH
+1vI4gnPah1vlPNOePqc7nvQDs/nxfRN0Av+7oeX6AHkcpmZBiFxgV6YuCcS6/ZrP
+px9Aw7vMWgpVSzs4dlG4Y4uElBbmVvMCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB
+/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFP6rAJCYniT8qcwaivsnuL8wbqg7
+MA0GCSqGSIb3DQEBCwUAA4ICAQDPdyxuVr5Os7aEAJSrR8kN0nbHhp8dB9O2tLsI
+eK9p0gtJ3jPFrK3CiAJ9Brc1AsFgyb/E6JTe1NOpEyVa/m6irn0F3H3zbPB+po3u
+2dfOWBfoqSmuc0iH55vKbimhZF8ZE/euBhD/UcabTVUlT5OZEAFTdfETzsemQUHS
+v4ilf0X8rLiltTMMgsT7B/Zq5SWEXwbKwYY5EdtYzXc7LMJMD16a4/CrPmEbUCTC
+wPTxGfARKbalGAKb12NMcIxHowNDXLldRqANb/9Zjr7dn3LDWyvfjFvO5QxGbJKy
+CqNMVEIYFRIYvdr8unRu/8G2oGTYqV9Vrp9canaW2HNnh/tNf1zuacpzEPuKqf2e
+vTY4SUmH9A4U8OmHuD+nT3pajnnUk+S7aFKErGzp85hwVXIy+TSrK0m1zSBi5Dp6
+Z2Orltxtrpfs/J92VoguZs9btsmksNcFuuEnL5O7Jiqik7Ab846+HUCjuTaPPoIa
+Gl6I6lD4WeKDRikL40Rc4ZW2aZCaFG+XroHPaO+Zmr615+F/+PoTRxZMzG0IQOeL
+eG9QgkRQP2YGiqtDhFZKDyAthg710tvSeopLzaXoTvFeJiUBWSOgftL2fiFX1ye8
+FVdMpEbB4IMeDExNH08GGeL5qPQ6gqGyeUN51q1veieQA6TqJIc/2b3Z6fJfUEkc
+7uzXLg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
+# Subject: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
+# Label: "IdenTrust Commercial Root CA 1"
+# Serial: 13298821034946342390520003877796839426
+# MD5 Fingerprint: b3:3e:77:73:75:ee:a0:d3:e3:7e:49:63:49:59:bb:c7
+# SHA1 Fingerprint: df:71:7e:aa:4a:d9:4e:c9:55:84:99:60:2d:48:de:5f:bc:f0:3a:25
+# SHA256 Fingerprint: 5d:56:49:9b:e4:d2:e0:8b:cf:ca:d0:8a:3e:38:72:3d:50:50:3b:de:70:69:48:e4:2f:55:60:30:19:e5:28:ae
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIQCgFCgAAAAUUjyES1AAAAAjANBgkqhkiG9w0BAQsFADBK
+MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScwJQYDVQQDEx5JZGVu
+VHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwHhcNMTQwMTE2MTgxMjIzWhcNMzQw
+MTE2MTgxMjIzWjBKMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScw
+JQYDVQQDEx5JZGVuVHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCnUBneP5k91DNG8W9RYYKyqU+PZ4ldhNlT
+3Qwo2dfw/66VQ3KZ+bVdfIrBQuExUHTRgQ18zZshq0PirK1ehm7zCYofWjK9ouuU
++ehcCuz/mNKvcbO0U59Oh++SvL3sTzIwiEsXXlfEU8L2ApeN2WIrvyQfYo3fw7gp
+S0l4PJNgiCL8mdo2yMKi1CxUAGc1bnO/AljwpN3lsKImesrgNqUZFvX9t++uP0D1
+bVoE/c40yiTcdCMbXTMTEl3EASX2MN0CXZ/g1Ue9tOsbobtJSdifWwLziuQkkORi
+T0/Br4sOdBeo0XKIanoBScy0RnnGF7HamB4HWfp1IYVl3ZBWzvurpWCdxJ35UrCL
+vYf5jysjCiN2O/cz4ckA82n5S6LgTrx+kzmEB/dEcH7+B1rlsazRGMzyNeVJSQjK
+Vsk9+w8YfYs7wRPCTY/JTw436R+hDmrfYi7LNQZReSzIJTj0+kuniVyc0uMNOYZK
+dHzVWYfCP04MXFL0PfdSgvHqo6z9STQaKPNBiDoT7uje/5kdX7rL6B7yuVBgwDHT
+c+XvvqDtMwt0viAgxGds8AgDelWAf0ZOlqf0Hj7h9tgJ4TNkK2PXMl6f+cB7D3hv
+l7yTmvmcEpB4eoCHFddydJxVdHixuuFucAS6T6C6aMN7/zHwcz09lCqxC0EOoP5N
+iGVreTO01wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB
+/zAdBgNVHQ4EFgQU7UQZwNPwBovupHu+QucmVMiONnYwDQYJKoZIhvcNAQELBQAD
+ggIBAA2ukDL2pkt8RHYZYR4nKM1eVO8lvOMIkPkp165oCOGUAFjvLi5+U1KMtlwH
+6oi6mYtQlNeCgN9hCQCTrQ0U5s7B8jeUeLBfnLOic7iPBZM4zY0+sLj7wM+x8uwt
+LRvM7Kqas6pgghstO8OEPVeKlh6cdbjTMM1gCIOQ045U8U1mwF10A0Cj7oV+wh93
+nAbowacYXVKV7cndJZ5t+qntozo00Fl72u1Q8zW/7esUTTHHYPTa8Yec4kjixsU3
++wYQ+nVZZjFHKdp2mhzpgq7vmrlR94gjmmmVYjzlVYA211QC//G5Xc7UI2/YRYRK
+W2XviQzdFKcgyxilJbQN+QHwotL0AMh0jqEqSI5l2xPE4iUXfeu+h1sXIFRRk0pT
+AwvsXcoz7WL9RccvW9xYoIA55vrX/hMUpu09lEpCdNTDd1lzzY9GvlU47/rokTLq
+l1gEIt44w8y8bckzOmoKaT+gyOpyj4xjhiO9bTyWnpXgSUyqorkqG5w2gXjtw+hG
+4iZZRHUe2XWJUc0QhJ1hYMtd+ZciTY6Y5uN/9lu7rs3KSoFrXgvzUeF0K+l+J6fZ
+mUlO+KWA2yUPHGNiiskzZ2s8EIPGrd6ozRaOjfAHN3Gf8qv8QfXBi+wAN10J5U6A
+7/qxXDgGpRtK4dw4LTzcqx+QGtVKnO7RcGzM7vRX+Bi6hG6H
+-----END CERTIFICATE-----
+
+# Issuer: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust
+# Subject: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust
+# Label: "IdenTrust Public Sector Root CA 1"
+# Serial: 13298821034946342390521976156843933698
+# MD5 Fingerprint: 37:06:a5:b0:fc:89:9d:ba:f4:6b:8c:1a:64:cd:d5:ba
+# SHA1 Fingerprint: ba:29:41:60:77:98:3f:f4:f3:ef:f2:31:05:3b:2e:ea:6d:4d:45:fd
+# SHA256 Fingerprint: 30:d0:89:5a:9a:44:8a:26:20:91:63:55:22:d1:f5:20:10:b5:86:7a:ca:e1:2c:78:ef:95:8f:d4:f4:38:9f:2f
+-----BEGIN CERTIFICATE-----
+MIIFZjCCA06gAwIBAgIQCgFCgAAAAUUjz0Z8AAAAAjANBgkqhkiG9w0BAQsFADBN
+MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MSowKAYDVQQDEyFJZGVu
+VHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwHhcNMTQwMTE2MTc1MzMyWhcN
+MzQwMTE2MTc1MzMyWjBNMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0
+MSowKAYDVQQDEyFJZGVuVHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwggIi
+MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC2IpT8pEiv6EdrCvsnduTyP4o7
+ekosMSqMjbCpwzFrqHd2hCa2rIFCDQjrVVi7evi8ZX3yoG2LqEfpYnYeEe4IFNGy
+RBb06tD6Hi9e28tzQa68ALBKK0CyrOE7S8ItneShm+waOh7wCLPQ5CQ1B5+ctMlS
+bdsHyo+1W/CD80/HLaXIrcuVIKQxKFdYWuSNG5qrng0M8gozOSI5Cpcu81N3uURF
+/YTLNiCBWS2ab21ISGHKTN9T0a9SvESfqy9rg3LvdYDaBjMbXcjaY8ZNzaxmMc3R
+3j6HEDbhuaR672BQssvKplbgN6+rNBM5Jeg5ZuSYeqoSmJxZZoY+rfGwyj4GD3vw
+EUs3oERte8uojHH01bWRNszwFcYr3lEXsZdMUD2xlVl8BX0tIdUAvwFnol57plzy
+9yLxkA2T26pEUWbMfXYD62qoKjgZl3YNa4ph+bz27nb9cCvdKTz4Ch5bQhyLVi9V
+GxyhLrXHFub4qjySjmm2AcG1hp2JDws4lFTo6tyePSW8Uybt1as5qsVATFSrsrTZ
+2fjXctscvG29ZV/viDUqZi/u9rNl8DONfJhBaUYPQxxp+pu10GFqzcpL2UyQRqsV
+WaFHVCkugyhfHMKiq3IXAAaOReyL4jM9f9oZRORicsPfIsbyVtTdX5Vy7W1f90gD
+W/3FKqD2cyOEEBsB5wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/
+BAUwAwEB/zAdBgNVHQ4EFgQU43HgntinQtnbcZFrlJPrw6PRFKMwDQYJKoZIhvcN
+AQELBQADggIBAEf63QqwEZE4rU1d9+UOl1QZgkiHVIyqZJnYWv6IAcVYpZmxI1Qj
+t2odIFflAWJBF9MJ23XLblSQdf4an4EKwt3X9wnQW3IV5B4Jaj0z8yGa5hV+rVHV
+DRDtfULAj+7AmgjVQdZcDiFpboBhDhXAuM/FSRJSzL46zNQuOAXeNf0fb7iAaJg9
+TaDKQGXSc3z1i9kKlT/YPyNtGtEqJBnZhbMX73huqVjRI9PHE+1yJX9dsXNw0H8G
+lwmEKYBhHfpe/3OsoOOJuBxxFcbeMX8S3OFtm6/n6J91eEyrRjuazr8FGF1NFTwW
+mhlQBJqymm9li1JfPFgEKCXAZmExfrngdbkaqIHWchezxQMxNRF4eKLg6TCMf4Df
+WN88uieW4oA0beOY02QnrEh+KHdcxiVhJfiFDGX6xDIvpZgF5PgLZxYWxoK4Mhn5
++bl53B/N66+rDt0b20XkeucC4pVd/GnwU2lhlXV5C15V5jgclKlZM57IcXR5f1GJ
+tshquDDIajjDbp7hNxbqBWJMWxJH7ae0s1hWx0nzfxJoCTFx8G34Tkf71oXuxVhA
+GaQdp/lLQzfcaFpPz+vCZHTetBXZ9FRUGi8c15dxVJCO2SCdUyt/q4/i6jC8UDfv
+8Ue1fXwsBOxonbRJRBD0ckscZOf85muQ3Wl9af0AVqW3rLatt8o+Ae+c
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only
+# Subject: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only
+# Label: "Entrust Root Certification Authority - G2"
+# Serial: 1246989352
+# MD5 Fingerprint: 4b:e2:c9:91:96:65:0c:f4:0e:5a:93:92:a0:0a:fe:b2
+# SHA1 Fingerprint: 8c:f4:27:fd:79:0c:3a:d1:66:06:8d:e8:1e:57:ef:bb:93:22:72:d4
+# SHA256 Fingerprint: 43:df:57:74:b0:3e:7f:ef:5f:e4:0d:93:1a:7b:ed:f1:bb:2e:6b:42:73:8c:4e:6d:38:41:10:3d:3a:a7:f3:39
+-----BEGIN CERTIFICATE-----
+MIIEPjCCAyagAwIBAgIESlOMKDANBgkqhkiG9w0BAQsFADCBvjELMAkGA1UEBhMC
+VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50
+cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3Qs
+IEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVz
+dCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRzIwHhcNMDkwNzA3MTcy
+NTU0WhcNMzAxMjA3MTc1NTU0WjCBvjELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUVu
+dHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50cnVzdC5uZXQvbGVnYWwt
+dGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3QsIEluYy4gLSBmb3IgYXV0
+aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVzdCBSb290IENlcnRpZmlj
+YXRpb24gQXV0aG9yaXR5IC0gRzIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK
+AoIBAQC6hLZy254Ma+KZ6TABp3bqMriVQRrJ2mFOWHLP/vaCeb9zYQYKpSfYs1/T
+RU4cctZOMvJyig/3gxnQaoCAAEUesMfnmr8SVycco2gvCoe9amsOXmXzHHfV1IWN
+cCG0szLni6LVhjkCsbjSR87kyUnEO6fe+1R9V77w6G7CebI6C1XiUJgWMhNcL3hW
+wcKUs/Ja5CeanyTXxuzQmyWC48zCxEXFjJd6BmsqEZ+pCm5IO2/b1BEZQvePB7/1
+U1+cPvQXLOZprE4yTGJ36rfo5bs0vBmLrpxR57d+tVOxMyLlbc9wPBr64ptntoP0
+jaWvYkxN4FisZDQSA/i2jZRjJKRxAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAP
+BgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqciZ60B7vfec7aVHUbI2fkBJmqzAN
+BgkqhkiG9w0BAQsFAAOCAQEAeZ8dlsa2eT8ijYfThwMEYGprmi5ZiXMRrEPR9RP/
+jTkrwPK9T3CMqS/qF8QLVJ7UG5aYMzyorWKiAHarWWluBh1+xLlEjZivEtRh2woZ
+Rkfz6/djwUAFQKXSt/S1mja/qYh2iARVBCuch38aNzx+LaUa2NSJXsq9rD1s2G2v
+1fN2D807iDginWyTmsQ9v4IbZT+mD12q/OWyFcq1rca8PdCE6OoGcrBNOTJ4vz4R
+nAuknZoh8/CbCzB428Hch0P+vGOaysXCHMnHjf87ElgI5rY97HosTvuDls4MPGmH
+VHOkc8KT/1EQrBVUAdj8BbGJoX90g5pJ19xOe4pIb4tF9g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only
+# Subject: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only
+# Label: "Entrust Root Certification Authority - EC1"
+# Serial: 51543124481930649114116133369
+# MD5 Fingerprint: b6:7e:1d:f0:58:c5:49:6c:24:3b:3d:ed:98:18:ed:bc
+# SHA1 Fingerprint: 20:d8:06:40:df:9b:25:f5:12:25:3a:11:ea:f7:59:8a:eb:14:b5:47
+# SHA256 Fingerprint: 02:ed:0e:b2:8c:14:da:45:16:5c:56:67:91:70:0d:64:51:d7:fb:56:f0:b2:ab:1d:3b:8e:b0:70:e5:6e:df:f5
+-----BEGIN CERTIFICATE-----
+MIIC+TCCAoCgAwIBAgINAKaLeSkAAAAAUNCR+TAKBggqhkjOPQQDAzCBvzELMAkG
+A1UEBhMCVVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3
+d3cuZW50cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDEyIEVu
+dHJ1c3QsIEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEzMDEGA1UEAxMq
+RW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRUMxMB4XDTEy
+MTIxODE1MjUzNloXDTM3MTIxODE1NTUzNlowgb8xCzAJBgNVBAYTAlVTMRYwFAYD
+VQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3QubmV0
+L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxMiBFbnRydXN0LCBJbmMuIC0g
+Zm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMzAxBgNVBAMTKkVudHJ1c3QgUm9vdCBD
+ZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEVDMTB2MBAGByqGSM49AgEGBSuBBAAi
+A2IABIQTydC6bUF74mzQ61VfZgIaJPRbiWlH47jCffHyAsWfoPZb1YsGGYZPUxBt
+ByQnoaD41UcZYUx9ypMn6nQM72+WCf5j7HBdNq1nd67JnXxVRDqiY1Ef9eNi1KlH
+Bz7MIKNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0O
+BBYEFLdj5xrdjekIplWDpOBqUEFlEUJJMAoGCCqGSM49BAMDA2cAMGQCMGF52OVC
+R98crlOZF7ZvHH3hvxGU0QOIdeSNiaSKd0bebWHvAvX7td/M/k7//qnmpwIwW5nX
+hTcGtXsI/esni0qU+eH6p44mCOh8kmhtc9hvJqwhAriZtyZBWyVgrtBIGu4G
+-----END CERTIFICATE-----
+
+# Issuer: CN=CFCA EV ROOT O=China Financial Certification Authority
+# Subject: CN=CFCA EV ROOT O=China Financial Certification Authority
+# Label: "CFCA EV ROOT"
+# Serial: 407555286
+# MD5 Fingerprint: 74:e1:b6:ed:26:7a:7a:44:30:33:94:ab:7b:27:81:30
+# SHA1 Fingerprint: e2:b8:29:4b:55:84:ab:6b:58:c2:90:46:6c:ac:3f:b8:39:8f:84:83
+# SHA256 Fingerprint: 5c:c3:d7:8e:4e:1d:5e:45:54:7a:04:e6:87:3e:64:f9:0c:f9:53:6d:1c:cc:2e:f8:00:f3:55:c4:c5:fd:70:fd
+-----BEGIN CERTIFICATE-----
+MIIFjTCCA3WgAwIBAgIEGErM1jANBgkqhkiG9w0BAQsFADBWMQswCQYDVQQGEwJD
+TjEwMC4GA1UECgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9y
+aXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJPT1QwHhcNMTIwODA4MDMwNzAxWhcNMjkx
+MjMxMDMwNzAxWjBWMQswCQYDVQQGEwJDTjEwMC4GA1UECgwnQ2hpbmEgRmluYW5j
+aWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJP
+T1QwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDXXWvNED8fBVnVBU03
+sQ7smCuOFR36k0sXgiFxEFLXUWRwFsJVaU2OFW2fvwwbwuCjZ9YMrM8irq93VCpL
+TIpTUnrD7i7es3ElweldPe6hL6P3KjzJIx1qqx2hp/Hz7KDVRM8Vz3IvHWOX6Jn5
+/ZOkVIBMUtRSqy5J35DNuF++P96hyk0g1CXohClTt7GIH//62pCfCqktQT+x8Rgp
+7hZZLDRJGqgG16iI0gNyejLi6mhNbiyWZXvKWfry4t3uMCz7zEasxGPrb382KzRz
+EpR/38wmnvFyXVBlWY9ps4deMm/DGIq1lY+wejfeWkU7xzbh72fROdOXW3NiGUgt
+hxwG+3SYIElz8AXSG7Ggo7cbcNOIabla1jj0Ytwli3i/+Oh+uFzJlU9fpy25IGvP
+a931DfSCt/SyZi4QKPaXWnuWFo8BGS1sbn85WAZkgwGDg8NNkt0yxoekN+kWzqot
+aK8KgWU6cMGbrU1tVMoqLUuFG7OA5nBFDWteNfB/O7ic5ARwiRIlk9oKmSJgamNg
+TnYGmE69g60dWIolhdLHZR4tjsbftsbhf4oEIRUpdPA+nJCdDC7xij5aqgwJHsfV
+PKPtl8MeNPo4+QgO48BdK4PRVmrJtqhUUy54Mmc9gn900PvhtgVguXDbjgv5E1hv
+cWAQUhC5wUEJ73IfZzF4/5YFjQIDAQABo2MwYTAfBgNVHSMEGDAWgBTj/i39KNAL
+tbq2osS/BqoFjJP7LzAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAd
+BgNVHQ4EFgQU4/4t/SjQC7W6tqLEvwaqBYyT+y8wDQYJKoZIhvcNAQELBQADggIB
+ACXGumvrh8vegjmWPfBEp2uEcwPenStPuiB/vHiyz5ewG5zz13ku9Ui20vsXiObT
+ej/tUxPQ4i9qecsAIyjmHjdXNYmEwnZPNDatZ8POQQaIxffu2Bq41gt/UP+TqhdL
+jOztUmCypAbqTuv0axn96/Ua4CUqmtzHQTb3yHQFhDmVOdYLO6Qn+gjYXB74BGBS
+ESgoA//vU2YApUo0FmZ8/Qmkrp5nGm9BC2sGE5uPhnEFtC+NiWYzKXZUmhH4J/qy
+P5Hgzg0b8zAarb8iXRvTvyUFTeGSGn+ZnzxEk8rUQElsgIfXBDrDMlI1Dlb4pd19
+xIsNER9Tyx6yF7Zod1rg1MvIB671Oi6ON7fQAUtDKXeMOZePglr4UeWJoBjnaH9d
+Ci77o0cOPaYjesYBx4/IXr9tgFa+iiS6M+qf4TIRnvHST4D2G0CvOJ4RUHlzEhLN
+5mydLIhyPDCBBpEi6lmt2hkuIsKNuYyH4Ga8cyNfIWRjgEj1oDwYPZTISEEdQLpe
+/v5WOaHIz16eGWRGENoXkbcFgKyLmZJ956LYBws2J+dIeWCKw9cTXPhyQN9Ky8+Z
+AAoACxGV2lZFA4gKn2fQ1XmxqI1AbQ3CekD6819kR5LLU7m7Wc5P/dAVUwHY3+vZ
+5nbv0CO7O6l5s9UCKc2Jo5YPSjXnTkLAdc0Hz+Ys63su
+-----END CERTIFICATE-----
+
+# Issuer: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed
+# Subject: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed
+# Label: "OISTE WISeKey Global Root GB CA"
+# Serial: 157768595616588414422159278966750757568
+# MD5 Fingerprint: a4:eb:b9:61:28:2e:b7:2f:98:b0:35:26:90:99:51:1d
+# SHA1 Fingerprint: 0f:f9:40:76:18:d3:d7:6a:4b:98:f0:a8:35:9e:0c:fd:27:ac:cc:ed
+# SHA256 Fingerprint: 6b:9c:08:e8:6e:b0:f7:67:cf:ad:65:cd:98:b6:21:49:e5:49:4a:67:f5:84:5e:7b:d1:ed:01:9f:27:b8:6b:d6
+-----BEGIN CERTIFICATE-----
+MIIDtTCCAp2gAwIBAgIQdrEgUnTwhYdGs/gjGvbCwDANBgkqhkiG9w0BAQsFADBt
+MQswCQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUg
+Rm91bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9i
+YWwgUm9vdCBHQiBDQTAeFw0xNDEyMDExNTAwMzJaFw0zOTEyMDExNTEwMzFaMG0x
+CzAJBgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBG
+b3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2Jh
+bCBSb290IEdCIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2Be3
+HEokKtaXscriHvt9OO+Y9bI5mE4nuBFde9IllIiCFSZqGzG7qFshISvYD06fWvGx
+WuR51jIjK+FTzJlFXHtPrby/h0oLS5daqPZI7H17Dc0hBt+eFf1Biki3IPShehtX
+1F1Q/7pn2COZH8g/497/b1t3sWtuuMlk9+HKQUYOKXHQuSP8yYFfTvdv37+ErXNk
+u7dCjmn21HYdfp2nuFeKUWdy19SouJVUQHMD9ur06/4oQnc/nSMbsrY9gBQHTC5P
+99UKFg29ZkM3fiNDecNAhvVMKdqOmq0NpQSHiB6F4+lT1ZvIiwNjeOvgGUpuuy9r
+M2RYk61pv48b74JIxwIDAQABo1EwTzALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUw
+AwEB/zAdBgNVHQ4EFgQUNQ/INmNe4qPs+TtmFc5RUuORmj0wEAYJKwYBBAGCNxUB
+BAMCAQAwDQYJKoZIhvcNAQELBQADggEBAEBM+4eymYGQfp3FsLAmzYh7KzKNbrgh
+cViXfa43FK8+5/ea4n32cZiZBKpDdHij40lhPnOMTZTg+XHEthYOU3gf1qKHLwI5
+gSk8rxWYITD+KJAAjNHhy/peyP34EEY7onhCkRd0VQreUGdNZtGn//3ZwLWoo4rO
+ZvUPQ82nK1d7Y0Zqqi5S2PTt4W2tKZB4SLrhI6qjiey1q5bAtEuiHZeeevJuQHHf
+aPFlTc58Bd9TZaml8LGXBHAVRgOY1NK/VLSgWH1Sb9pWJmLU2NuJMW8c8CLC02Ic
+Nc1MaRVUGpCY3useX8p3x8uOPUNpnJpY0CQ73xtAln41rYHHTnG6iBM=
+-----END CERTIFICATE-----
+
+# Issuer: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A.
+# Subject: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A.
+# Label: "SZAFIR ROOT CA2"
+# Serial: 357043034767186914217277344587386743377558296292
+# MD5 Fingerprint: 11:64:c1:89:b0:24:b1:8c:b1:07:7e:89:9e:51:9e:99
+# SHA1 Fingerprint: e2:52:fa:95:3f:ed:db:24:60:bd:6e:28:f3:9c:cc:cf:5e:b3:3f:de
+# SHA256 Fingerprint: a1:33:9d:33:28:1a:0b:56:e5:57:d3:d3:2b:1c:e7:f9:36:7e:b0:94:bd:5f:a7:2a:7e:50:04:c8:de:d7:ca:fe
+-----BEGIN CERTIFICATE-----
+MIIDcjCCAlqgAwIBAgIUPopdB+xV0jLVt+O2XwHrLdzk1uQwDQYJKoZIhvcNAQEL
+BQAwUTELMAkGA1UEBhMCUEwxKDAmBgNVBAoMH0tyYWpvd2EgSXpiYSBSb3psaWN6
+ZW5pb3dhIFMuQS4xGDAWBgNVBAMMD1NaQUZJUiBST09UIENBMjAeFw0xNTEwMTkw
+NzQzMzBaFw0zNTEwMTkwNzQzMzBaMFExCzAJBgNVBAYTAlBMMSgwJgYDVQQKDB9L
+cmFqb3dhIEl6YmEgUm96bGljemVuaW93YSBTLkEuMRgwFgYDVQQDDA9TWkFGSVIg
+Uk9PVCBDQTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC3vD5QqEvN
+QLXOYeeWyrSh2gwisPq1e3YAd4wLz32ohswmUeQgPYUM1ljj5/QqGJ3a0a4m7utT
+3PSQ1hNKDJA8w/Ta0o4NkjrcsbH/ON7Dui1fgLkCvUqdGw+0w8LBZwPd3BucPbOw
+3gAeqDRHu5rr/gsUvTaE2g0gv/pby6kWIK05YO4vdbbnl5z5Pv1+TW9NL++IDWr6
+3fE9biCloBK0TXC5ztdyO4mTp4CEHCdJckm1/zuVnsHMyAHs6A6KCpbns6aH5db5
+BSsNl0BwPLqsdVqc1U2dAgrSS5tmS0YHF2Wtn2yIANwiieDhZNRnvDF5YTy7ykHN
+XGoAyDw4jlivAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD
+AgEGMB0GA1UdDgQWBBQuFqlKGLXLzPVvUPMjX/hd56zwyDANBgkqhkiG9w0BAQsF
+AAOCAQEAtXP4A9xZWx126aMqe5Aosk3AM0+qmrHUuOQn/6mWmc5G4G18TKI4pAZw
+8PRBEew/R40/cof5O/2kbytTAOD/OblqBw7rHRz2onKQy4I9EYKL0rufKq8h5mOG
+nXkZ7/e7DDWQw4rtTw/1zBLZpD67oPwglV9PJi8RI4NOdQcPv5vRtB3pEAT+ymCP
+oky4rc/hkA/NrgrHXXu3UNLUYfrVFdvXn4dRVOul4+vJhaAlIDf7js4MNIThPIGy
+d05DpYhfhmehPea0XGG2Ptv+tyjFogeutcrKjSoS75ftwjCkySp6+/NNIxuZMzSg
+LvWpCz/UXeHPhJ/iGcJfitYgHuNztw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Subject: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Label: "Certum Trusted Network CA 2"
+# Serial: 44979900017204383099463764357512596969
+# MD5 Fingerprint: 6d:46:9e:d9:25:6d:08:23:5b:5e:74:7d:1e:27:db:f2
+# SHA1 Fingerprint: d3:dd:48:3e:2b:bf:4c:05:e8:af:10:f5:fa:76:26:cf:d3:dc:30:92
+# SHA256 Fingerprint: b6:76:f2:ed:da:e8:77:5c:d3:6c:b0:f6:3c:d1:d4:60:39:61:f4:9e:62:65:ba:01:3a:2f:03:07:b6:d0:b8:04
+-----BEGIN CERTIFICATE-----
+MIIF0jCCA7qgAwIBAgIQIdbQSk8lD8kyN/yqXhKN6TANBgkqhkiG9w0BAQ0FADCB
+gDELMAkGA1UEBhMCUEwxIjAgBgNVBAoTGVVuaXpldG8gVGVjaG5vbG9naWVzIFMu
+QS4xJzAlBgNVBAsTHkNlcnR1bSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEkMCIG
+A1UEAxMbQ2VydHVtIFRydXN0ZWQgTmV0d29yayBDQSAyMCIYDzIwMTExMDA2MDgz
+OTU2WhgPMjA0NjEwMDYwODM5NTZaMIGAMQswCQYDVQQGEwJQTDEiMCAGA1UEChMZ
+VW5pemV0byBUZWNobm9sb2dpZXMgUy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRp
+ZmljYXRpb24gQXV0aG9yaXR5MSQwIgYDVQQDExtDZXJ0dW0gVHJ1c3RlZCBOZXR3
+b3JrIENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC9+Xj45tWA
+DGSdhhuWZGc/IjoedQF97/tcZ4zJzFxrqZHmuULlIEub2pt7uZld2ZuAS9eEQCsn
+0+i6MLs+CRqnSZXvK0AkwpfHp+6bJe+oCgCXhVqqndwpyeI1B+twTUrWwbNWuKFB
+OJvR+zF/j+Bf4bE/D44WSWDXBo0Y+aomEKsq09DRZ40bRr5HMNUuctHFY9rnY3lE
+fktjJImGLjQ/KUxSiyqnwOKRKIm5wFv5HdnnJ63/mgKXwcZQkpsCLL2puTRZCr+E
+Sv/f/rOf69me4Jgj7KZrdxYq28ytOxykh9xGc14ZYmhFV+SQgkK7QtbwYeDBoz1m
+o130GO6IyY0XRSmZMnUCMe4pJshrAua1YkV/NxVaI2iJ1D7eTiew8EAMvE0Xy02i
+sx7QBlrd9pPPV3WZ9fqGGmd4s7+W/jTcvedSVuWz5XV710GRBdxdaeOVDUO5/IOW
+OZV7bIBaTxNyxtd9KXpEulKkKtVBRgkg/iKgtlswjbyJDNXXcPiHUv3a76xRLgez
+Tv7QCdpw75j6VuZt27VXS9zlLCUVyJ4ueE742pyehizKV/Ma5ciSixqClnrDvFAS
+adgOWkaLOusm+iPJtrCBvkIApPjW/jAux9JG9uWOdf3yzLnQh1vMBhBgu4M1t15n
+3kfsmUjxpKEV/q2MYo45VU85FrmxY53/twIDAQABo0IwQDAPBgNVHRMBAf8EBTAD
+AQH/MB0GA1UdDgQWBBS2oVQ5AsOgP46KvPrU+Bym0ToO/TAOBgNVHQ8BAf8EBAMC
+AQYwDQYJKoZIhvcNAQENBQADggIBAHGlDs7k6b8/ONWJWsQCYftMxRQXLYtPU2sQ
+F/xlhMcQSZDe28cmk4gmb3DWAl45oPePq5a1pRNcgRRtDoGCERuKTsZPpd1iHkTf
+CVn0W3cLN+mLIMb4Ck4uWBzrM9DPhmDJ2vuAL55MYIR4PSFk1vtBHxgP58l1cb29
+XN40hz5BsA72udY/CROWFC/emh1auVbONTqwX3BNXuMp8SMoclm2q8KMZiYcdywm
+djWLKKdpoPk79SPdhRB0yZADVpHnr7pH1BKXESLjokmUbOe3lEu6LaTaM4tMpkT/
+WjzGHWTYtTHkpjx6qFcL2+1hGsvxznN3Y6SHb0xRONbkX8eftoEq5IVIeVheO/jb
+AoJnwTnbw3RLPTYe+SmTiGhbqEQZIfCn6IENLOiTNrQ3ssqwGyZ6miUfmpqAnksq
+P/ujmv5zMnHCnsZy4YpoJ/HkD7TETKVhk/iXEAcqMCWpuchxuO9ozC1+9eB+D4Ko
+b7a6bINDd82Kkhehnlt4Fj1F4jNy3eFmypnTycUm/Q1oBEauttmbjL4ZvrHG8hnj
+XALKLNhvSgfZyTXaQHXyxKcZb55CEJh15pWLYLztxRLXis7VmFxWlgPF7ncGNf/P
+5O4/E2Hu29othfDNrp2yGAlFw5Khchf8R7agCyzxxN5DaAhqXzvwdmP7zAYspsbi
+DrW5viSP
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Subject: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Label: "Hellenic Academic and Research Institutions RootCA 2015"
+# Serial: 0
+# MD5 Fingerprint: ca:ff:e2:db:03:d9:cb:4b:e9:0f:ad:84:fd:7b:18:ce
+# SHA1 Fingerprint: 01:0c:06:95:a6:98:19:14:ff:bf:5f:c6:b0:b6:95:ea:29:e9:12:a6
+# SHA256 Fingerprint: a0:40:92:9a:02:ce:53:b4:ac:f4:f2:ff:c6:98:1c:e4:49:6f:75:5e:6d:45:fe:0b:2a:69:2b:cd:52:52:3f:36
+-----BEGIN CERTIFICATE-----
+MIIGCzCCA/OgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBpjELMAkGA1UEBhMCR1Ix
+DzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5k
+IFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxQDA+BgNVBAMT
+N0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgUm9v
+dENBIDIwMTUwHhcNMTUwNzA3MTAxMTIxWhcNNDAwNjMwMTAxMTIxWjCBpjELMAkG
+A1UEBhMCR1IxDzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNh
+ZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkx
+QDA+BgNVBAMTN0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1
+dGlvbnMgUm9vdENBIDIwMTUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC
+AQDC+Kk/G4n8PDwEXT2QNrCROnk8ZlrvbTkBSRq0t89/TSNTt5AA4xMqKKYx8ZEA
+4yjsriFBzh/a/X0SWwGDD7mwX5nh8hKDgE0GPt+sr+ehiGsxr/CL0BgzuNtFajT0
+AoAkKAoCFZVedioNmToUW/bLy1O8E00BiDeUJRtCvCLYjqOWXjrZMts+6PAQZe10
+4S+nfK8nNLspfZu2zwnI5dMK/IhlZXQK3HMcXM1AsRzUtoSMTFDPaI6oWa7CJ06C
+ojXdFPQf/7J31Ycvqm59JCfnxssm5uX+Zwdj2EUN3TpZZTlYepKZcj2chF6IIbjV
+9Cz82XBST3i4vTwri5WY9bPRaM8gFH5MXF/ni+X1NYEZN9cRCLdmvtNKzoNXADrD
+gfgXy5I2XdGj2HUb4Ysn6npIQf1FGQatJ5lOwXBH3bWfgVMS5bGMSF0xQxfjjMZ6
+Y5ZLKTBOhE5iGV48zpeQpX8B653g+IuJ3SWYPZK2fu/Z8VFRfS0myGlZYeCsargq
+NhEEelC9MoS+L9xy1dcdFkfkR2YgP/SWxa+OAXqlD3pk9Q0Yh9muiNX6hME6wGko
+LfINaFGq46V3xqSQDqE3izEjR8EJCOtu93ib14L8hCCZSRm2Ekax+0VVFqmjZayc
+Bw/qa9wfLgZy7IaIEuQt218FL+TwA9MmM+eAws1CoRc0CwIDAQABo0IwQDAPBgNV
+HRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUcRVnyMjJvXVd
+ctA4GGqd83EkVAswDQYJKoZIhvcNAQELBQADggIBAHW7bVRLqhBYRjTyYtcWNl0I
+XtVsyIe9tC5G8jH4fOpCtZMWVdyhDBKg2mF+D1hYc2Ryx+hFjtyp8iY/xnmMsVMI
+M4GwVhO+5lFc2JsKT0ucVlMC6U/2DWDqTUJV6HwbISHTGzrMd/K4kPFox/la/vot
+9L/J9UUbzjgQKjeKeaO04wlshYaT/4mWJ3iBj2fjRnRUjtkNaeJK9E10A/+yd+2V
+Z5fkscWrv2oj6NSU4kQoYsRL4vDY4ilrGnB+JGGTe08DMiUNRSQrlrRGar9KC/ea
+j8GsGsVn82800vpzY4zvFrCopEYq+OsS7HK07/grfoxSwIuEVPkvPuNVqNxmsdnh
+X9izjFk0WaSrT2y7HxjbdavYy5LNlDhhDgcGH0tGEPEVvo2FXDtKK4F5D7Rpn0lQ
+l033DlZdwJVqwjbDG2jJ9SrcR5q+ss7FJej6A7na+RZukYT1HCjI/CbM1xyQVqdf
+bzoEvM14iQuODy+jqk+iGxI9FghAD/FGTNeqewjBCvVtJ94Cj8rDtSvK6evIIVM4
+pcw72Hc3MKJP2W/R8kCtQXoXxdZKNYm3QdV8hn9VTYNKpXMgwDqvkPGaJI7ZjnHK
+e7iG2rKPmT4dEw0SEe7Uq/DpFXYC5ODfqiAeW2GFZECpkJcNrVPSWh2HagCXZWK0
+vm9qp/UsQu0yrbYhnr68
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Subject: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Label: "Hellenic Academic and Research Institutions ECC RootCA 2015"
+# Serial: 0
+# MD5 Fingerprint: 81:e5:b4:17:eb:c2:f5:e1:4b:0d:41:7b:49:92:fe:ef
+# SHA1 Fingerprint: 9f:f1:71:8d:92:d5:9a:f3:7d:74:97:b4:bc:6f:84:68:0b:ba:b6:66
+# SHA256 Fingerprint: 44:b5:45:aa:8a:25:e6:5a:73:ca:15:dc:27:fc:36:d2:4c:1c:b9:95:3a:06:65:39:b1:15:82:dc:48:7b:48:33
+-----BEGIN CERTIFICATE-----
+MIICwzCCAkqgAwIBAgIBADAKBggqhkjOPQQDAjCBqjELMAkGA1UEBhMCR1IxDzAN
+BgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl
+c2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxRDBCBgNVBAMTO0hl
+bGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgRUNDIFJv
+b3RDQSAyMDE1MB4XDTE1MDcwNzEwMzcxMloXDTQwMDYzMDEwMzcxMlowgaoxCzAJ
+BgNVBAYTAkdSMQ8wDQYDVQQHEwZBdGhlbnMxRDBCBgNVBAoTO0hlbGxlbmljIEFj
+YWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ2VydC4gQXV0aG9yaXR5
+MUQwQgYDVQQDEztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0
+dXRpb25zIEVDQyBSb290Q0EgMjAxNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABJKg
+QehLgoRc4vgxEZmGZE4JJS+dQS8KrjVPdJWyUWRrjWvmP3CV8AVER6ZyOFB2lQJa
+jq4onvktTpnvLEhvTCUp6NFxW98dwXU3tNf6e3pCnGoKVlp8aQuqgAkkbH7BRqNC
+MEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFLQi
+C4KZJAEOnLvkDv2/+5cgk5kqMAoGCCqGSM49BAMCA2cAMGQCMGfOFmI4oqxiRaep
+lSTAGiecMjvAwNW6qef4BENThe5SId6d9SWDPp5YSy/XZxMOIQIwBeF1Ad5o7Sof
+TUwJCA3sS61kFyjndc5FZXIhF8siQQ6ME5g4mlRtm8rifOoCWCKR
+-----END CERTIFICATE-----
+
+# Issuer: CN=ISRG Root X1 O=Internet Security Research Group
+# Subject: CN=ISRG Root X1 O=Internet Security Research Group
+# Label: "ISRG Root X1"
+# Serial: 172886928669790476064670243504169061120
+# MD5 Fingerprint: 0c:d2:f9:e0:da:17:73:e9:ed:86:4d:a5:e3:70:e7:4e
+# SHA1 Fingerprint: ca:bd:2a:79:a1:07:6a:31:f2:1d:25:36:35:cb:03:9d:43:29:a5:e8
+# SHA256 Fingerprint: 96:bc:ec:06:26:49:76:f3:74:60:77:9a:cf:28:c5:a7:cf:e8:a3:c0:aa:e1:1a:8f:fc:ee:05:c0:bd:df:08:c6
+-----BEGIN CERTIFICATE-----
+MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
+TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
+cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
+WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
+ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
+h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
+0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
+A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
+T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
+B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
+B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
+KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
+OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
+jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
+qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
+rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
+hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
+ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
+3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
+NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
+ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
+TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
+jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
+oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
+4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
+mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
+emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
+-----END CERTIFICATE-----
+
+# Issuer: O=FNMT-RCM OU=AC RAIZ FNMT-RCM
+# Subject: O=FNMT-RCM OU=AC RAIZ FNMT-RCM
+# Label: "AC RAIZ FNMT-RCM"
+# Serial: 485876308206448804701554682760554759
+# MD5 Fingerprint: e2:09:04:b4:d3:bd:d1:a0:14:fd:1a:d2:47:c4:57:1d
+# SHA1 Fingerprint: ec:50:35:07:b2:15:c4:95:62:19:e2:a8:9a:5b:42:99:2c:4c:2c:20
+# SHA256 Fingerprint: eb:c5:57:0c:29:01:8c:4d:67:b1:aa:12:7b:af:12:f7:03:b4:61:1e:bc:17:b7:da:b5:57:38:94:17:9b:93:fa
+-----BEGIN CERTIFICATE-----
+MIIFgzCCA2ugAwIBAgIPXZONMGc2yAYdGsdUhGkHMA0GCSqGSIb3DQEBCwUAMDsx
+CzAJBgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJ
+WiBGTk1ULVJDTTAeFw0wODEwMjkxNTU5NTZaFw0zMDAxMDEwMDAwMDBaMDsxCzAJ
+BgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJWiBG
+Tk1ULVJDTTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALpxgHpMhm5/
+yBNtwMZ9HACXjywMI7sQmkCpGreHiPibVmr75nuOi5KOpyVdWRHbNi63URcfqQgf
+BBckWKo3Shjf5TnUV/3XwSyRAZHiItQDwFj8d0fsjz50Q7qsNI1NOHZnjrDIbzAz
+WHFctPVrbtQBULgTfmxKo0nRIBnuvMApGGWn3v7v3QqQIecaZ5JCEJhfTzC8PhxF
+tBDXaEAUwED653cXeuYLj2VbPNmaUtu1vZ5Gzz3rkQUCwJaydkxNEJY7kvqcfw+Z
+374jNUUeAlz+taibmSXaXvMiwzn15Cou08YfxGyqxRxqAQVKL9LFwag0Jl1mpdIC
+IfkYtwb1TplvqKtMUejPUBjFd8g5CSxJkjKZqLsXF3mwWsXmo8RZZUc1g16p6DUL
+mbvkzSDGm0oGObVo/CK67lWMK07q87Hj/LaZmtVC+nFNCM+HHmpxffnTtOmlcYF7
+wk5HlqX2doWjKI/pgG6BU6VtX7hI+cL5NqYuSf+4lsKMB7ObiFj86xsc3i1w4peS
+MKGJ47xVqCfWS+2QrYv6YyVZLag13cqXM7zlzced0ezvXg5KkAYmY6252TUtB7p2
+ZSysV4999AeU14ECll2jB0nVetBX+RvnU0Z1qrB5QstocQjpYL05ac70r8NWQMet
+UqIJ5G+GR4of6ygnXYMgrwTJbFaai0b1AgMBAAGjgYMwgYAwDwYDVR0TAQH/BAUw
+AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFPd9xf3E6Jobd2Sn9R2gzL+H
+YJptMD4GA1UdIAQ3MDUwMwYEVR0gADArMCkGCCsGAQUFBwIBFh1odHRwOi8vd3d3
+LmNlcnQuZm5tdC5lcy9kcGNzLzANBgkqhkiG9w0BAQsFAAOCAgEAB5BK3/MjTvDD
+nFFlm5wioooMhfNzKWtN/gHiqQxjAb8EZ6WdmF/9ARP67Jpi6Yb+tmLSbkyU+8B1
+RXxlDPiyN8+sD8+Nb/kZ94/sHvJwnvDKuO+3/3Y3dlv2bojzr2IyIpMNOmqOFGYM
+LVN0V2Ue1bLdI4E7pWYjJ2cJj+F3qkPNZVEI7VFY/uY5+ctHhKQV8Xa7pO6kO8Rf
+77IzlhEYt8llvhjho6Tc+hj507wTmzl6NLrTQfv6MooqtyuGC2mDOL7Nii4LcK2N
+JpLuHvUBKwrZ1pebbuCoGRw6IYsMHkCtA+fdZn71uSANA+iW+YJF1DngoABd15jm
+fZ5nc8OaKveri6E6FO80vFIOiZiaBECEHX5FaZNXzuvO+FB8TxxuBEOb+dY7Ixjp
+6o7RTUaN8Tvkasq6+yO3m/qZASlaWFot4/nUbQ4mrcFuNLwy+AwF+mWj2zs3gyLp
+1txyM/1d8iC9djwj2ij3+RvrWWTV3F9yfiD8zYm1kGdNYno/Tq0dwzn+evQoFt9B
+9kiABdcPUXmsEKvU7ANm5mqwujGSQkBqvjrTcuFqN1W8rB2Vt2lh8kORdOag0wok
+RqEIr9baRRmW1FMdW4R58MD3R++Lj8UGrp1MYp3/RgT408m2ECVAdf4WqslKYIYv
+uu8wd+RU4riEmViAqhOLUTpPSPaLtrM=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 1 O=Amazon
+# Subject: CN=Amazon Root CA 1 O=Amazon
+# Label: "Amazon Root CA 1"
+# Serial: 143266978916655856878034712317230054538369994
+# MD5 Fingerprint: 43:c6:bf:ae:ec:fe:ad:2f:18:c6:88:68:30:fc:c8:e6
+# SHA1 Fingerprint: 8d:a7:f9:65:ec:5e:fc:37:91:0f:1c:6e:59:fd:c1:cc:6a:6e:de:16
+# SHA256 Fingerprint: 8e:cd:e6:88:4f:3d:87:b1:12:5b:a3:1a:c3:fc:b1:3d:70:16:de:7f:57:cc:90:4f:e1:cb:97:c6:ae:98:19:6e
+-----BEGIN CERTIFICATE-----
+MIIDQTCCAimgAwIBAgITBmyfz5m/jAo54vB4ikPmljZbyjANBgkqhkiG9w0BAQsF
+ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6
+b24gUm9vdCBDQSAxMB4XDTE1MDUyNjAwMDAwMFoXDTM4MDExNzAwMDAwMFowOTEL
+MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv
+b3QgQ0EgMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALJ4gHHKeNXj
+ca9HgFB0fW7Y14h29Jlo91ghYPl0hAEvrAIthtOgQ3pOsqTQNroBvo3bSMgHFzZM
+9O6II8c+6zf1tRn4SWiw3te5djgdYZ6k/oI2peVKVuRF4fn9tBb6dNqcmzU5L/qw
+IFAGbHrQgLKm+a/sRxmPUDgH3KKHOVj4utWp+UhnMJbulHheb4mjUcAwhmahRWa6
+VOujw5H5SNz/0egwLX0tdHA114gk957EWW67c4cX8jJGKLhD+rcdqsq08p8kDi1L
+93FcXmn/6pUCyziKrlA4b9v7LWIbxcceVOF34GfID5yHI9Y/QCB/IIDEgEw+OyQm
+jgSubJrIqg0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
+AYYwHQYDVR0OBBYEFIQYzIU07LwMlJQuCFmcx7IQTgoIMA0GCSqGSIb3DQEBCwUA
+A4IBAQCY8jdaQZChGsV2USggNiMOruYou6r4lK5IpDB/G/wkjUu0yKGX9rbxenDI
+U5PMCCjjmCXPI6T53iHTfIUJrU6adTrCC2qJeHZERxhlbI1Bjjt/msv0tadQ1wUs
+N+gDS63pYaACbvXy8MWy7Vu33PqUXHeeE6V/Uq2V8viTO96LXFvKWlJbYK8U90vv
+o/ufQJVtMVT8QtPHRh8jrdkPSHCa2XV4cdFyQzR1bldZwgJcJmApzyMZFo6IQ6XU
+5MsI+yMRQ+hDKXJioaldXgjUkK642M4UwtBV8ob2xJNDd2ZhwLnoQdeXeGADbkpy
+rqXRfboQnoZsG4q5WTP468SQvvG5
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 2 O=Amazon
+# Subject: CN=Amazon Root CA 2 O=Amazon
+# Label: "Amazon Root CA 2"
+# Serial: 143266982885963551818349160658925006970653239
+# MD5 Fingerprint: c8:e5:8d:ce:a8:42:e2:7a:c0:2a:5c:7c:9e:26:bf:66
+# SHA1 Fingerprint: 5a:8c:ef:45:d7:a6:98:59:76:7a:8c:8b:44:96:b5:78:cf:47:4b:1a
+# SHA256 Fingerprint: 1b:a5:b2:aa:8c:65:40:1a:82:96:01:18:f8:0b:ec:4f:62:30:4d:83:ce:c4:71:3a:19:c3:9c:01:1e:a4:6d:b4
+-----BEGIN CERTIFICATE-----
+MIIFQTCCAymgAwIBAgITBmyf0pY1hp8KD+WGePhbJruKNzANBgkqhkiG9w0BAQwF
+ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6
+b24gUm9vdCBDQSAyMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTEL
+MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv
+b3QgQ0EgMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK2Wny2cSkxK
+gXlRmeyKy2tgURO8TW0G/LAIjd0ZEGrHJgw12MBvIITplLGbhQPDW9tK6Mj4kHbZ
+W0/jTOgGNk3Mmqw9DJArktQGGWCsN0R5hYGCrVo34A3MnaZMUnbqQ523BNFQ9lXg
+1dKmSYXpN+nKfq5clU1Imj+uIFptiJXZNLhSGkOQsL9sBbm2eLfq0OQ6PBJTYv9K
+8nu+NQWpEjTj82R0Yiw9AElaKP4yRLuH3WUnAnE72kr3H9rN9yFVkE8P7K6C4Z9r
+2UXTu/Bfh+08LDmG2j/e7HJV63mjrdvdfLC6HM783k81ds8P+HgfajZRRidhW+me
+z/CiVX18JYpvL7TFz4QuK/0NURBs+18bvBt+xa47mAExkv8LV/SasrlX6avvDXbR
+8O70zoan4G7ptGmh32n2M8ZpLpcTnqWHsFcQgTfJU7O7f/aS0ZzQGPSSbtqDT6Zj
+mUyl+17vIWR6IF9sZIUVyzfpYgwLKhbcAS4y2j5L9Z469hdAlO+ekQiG+r5jqFoz
+7Mt0Q5X5bGlSNscpb/xVA1wf+5+9R+vnSUeVC06JIglJ4PVhHvG/LopyboBZ/1c6
++XUyo05f7O0oYtlNc/LMgRdg7c3r3NunysV+Ar3yVAhU/bQtCSwXVEqY0VThUWcI
+0u1ufm8/0i2BWSlmy5A5lREedCf+3euvAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMB
+Af8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSwDPBMMPQFWAJI/TPlUq9LhONm
+UjANBgkqhkiG9w0BAQwFAAOCAgEAqqiAjw54o+Ci1M3m9Zh6O+oAA7CXDpO8Wqj2
+LIxyh6mx/H9z/WNxeKWHWc8w4Q0QshNabYL1auaAn6AFC2jkR2vHat+2/XcycuUY
++gn0oJMsXdKMdYV2ZZAMA3m3MSNjrXiDCYZohMr/+c8mmpJ5581LxedhpxfL86kS
+k5Nrp+gvU5LEYFiwzAJRGFuFjWJZY7attN6a+yb3ACfAXVU3dJnJUH/jWS5E4ywl
+7uxMMne0nxrpS10gxdr9HIcWxkPo1LsmmkVwXqkLN1PiRnsn/eBG8om3zEK2yygm
+btmlyTrIQRNg91CMFa6ybRoVGld45pIq2WWQgj9sAq+uEjonljYE1x2igGOpm/Hl
+urR8FLBOybEfdF849lHqm/osohHUqS0nGkWxr7JOcQ3AWEbWaQbLU8uz/mtBzUF+
+fUwPfHJ5elnNXkoOrJupmHN5fLT0zLm4BwyydFy4x2+IoZCn9Kr5v2c69BoVYh63
+n749sSmvZ6ES8lgQGVMDMBu4Gon2nL2XA46jCfMdiyHxtN/kHNGfZQIG6lzWE7OE
+76KlXIx3KadowGuuQNKotOrN8I1LOJwZmhsoVLiJkO/KdYE+HvJkJMcYr07/R54H
+9jVlpNMKVv/1F2Rs76giJUmTtt8AF9pYfl3uxRuw0dFfIRDH+fO6AgonB8Xx1sfT
+4PsJYGw=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 3 O=Amazon
+# Subject: CN=Amazon Root CA 3 O=Amazon
+# Label: "Amazon Root CA 3"
+# Serial: 143266986699090766294700635381230934788665930
+# MD5 Fingerprint: a0:d4:ef:0b:f7:b5:d8:49:95:2a:ec:f5:c4:fc:81:87
+# SHA1 Fingerprint: 0d:44:dd:8c:3c:8c:1a:1a:58:75:64:81:e9:0f:2e:2a:ff:b3:d2:6e
+# SHA256 Fingerprint: 18:ce:6c:fe:7b:f1:4e:60:b2:e3:47:b8:df:e8:68:cb:31:d0:2e:bb:3a:da:27:15:69:f5:03:43:b4:6d:b3:a4
+-----BEGIN CERTIFICATE-----
+MIIBtjCCAVugAwIBAgITBmyf1XSXNmY/Owua2eiedgPySjAKBggqhkjOPQQDAjA5
+MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g
+Um9vdCBDQSAzMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG
+A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg
+Q0EgMzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABCmXp8ZBf8ANm+gBG1bG8lKl
+ui2yEujSLtf6ycXYqm0fc4E7O5hrOXwzpcVOho6AF2hiRVd9RFgdszflZwjrZt6j
+QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSr
+ttvXBp43rDCGB5Fwx5zEGbF4wDAKBggqhkjOPQQDAgNJADBGAiEA4IWSoxe3jfkr
+BqWTrBqYaGFy+uGh0PsceGCmQ5nFuMQCIQCcAu/xlJyzlvnrxir4tiz+OpAUFteM
+YyRIHN8wfdVoOw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 4 O=Amazon
+# Subject: CN=Amazon Root CA 4 O=Amazon
+# Label: "Amazon Root CA 4"
+# Serial: 143266989758080763974105200630763877849284878
+# MD5 Fingerprint: 89:bc:27:d5:eb:17:8d:06:6a:69:d5:fd:89:47:b4:cd
+# SHA1 Fingerprint: f6:10:84:07:d6:f8:bb:67:98:0c:c2:e2:44:c2:eb:ae:1c:ef:63:be
+# SHA256 Fingerprint: e3:5d:28:41:9e:d0:20:25:cf:a6:90:38:cd:62:39:62:45:8d:a5:c6:95:fb:de:a3:c2:2b:0b:fb:25:89:70:92
+-----BEGIN CERTIFICATE-----
+MIIB8jCCAXigAwIBAgITBmyf18G7EEwpQ+Vxe3ssyBrBDjAKBggqhkjOPQQDAzA5
+MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g
+Um9vdCBDQSA0MB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG
+A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg
+Q0EgNDB2MBAGByqGSM49AgEGBSuBBAAiA2IABNKrijdPo1MN/sGKe0uoe0ZLY7Bi
+9i0b2whxIdIA6GO9mif78DluXeo9pcmBqqNbIJhFXRbb/egQbeOc4OO9X4Ri83Bk
+M6DLJC9wuoihKqB1+IGuYgbEgds5bimwHvouXKNCMEAwDwYDVR0TAQH/BAUwAwEB
+/zAOBgNVHQ8BAf8EBAMCAYYwHQYDVR0OBBYEFNPsxzplbszh2naaVvuc84ZtV+WB
+MAoGCCqGSM49BAMDA2gAMGUCMDqLIfG9fhGt0O9Yli/W651+kI0rz2ZVwyzjKKlw
+CkcO8DdZEv8tmZQoTipPNU0zWgIxAOp1AE47xDqUEpHJWEadIRNyp4iciuRMStuW
+1KyLa2tJElMzrdfkviT8tQp21KW8EA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM
+# Subject: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM
+# Label: "TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1"
+# Serial: 1
+# MD5 Fingerprint: dc:00:81:dc:69:2f:3e:2f:b0:3b:f6:3d:5a:91:8e:49
+# SHA1 Fingerprint: 31:43:64:9b:ec:ce:27:ec:ed:3a:3f:0b:8f:0d:e4:e8:91:dd:ee:ca
+# SHA256 Fingerprint: 46:ed:c3:68:90:46:d5:3a:45:3f:b3:10:4a:b8:0d:ca:ec:65:8b:26:60:ea:16:29:dd:7e:86:79:90:64:87:16
+-----BEGIN CERTIFICATE-----
+MIIEYzCCA0ugAwIBAgIBATANBgkqhkiG9w0BAQsFADCB0jELMAkGA1UEBhMCVFIx
+GDAWBgNVBAcTD0dlYnplIC0gS29jYWVsaTFCMEAGA1UEChM5VHVya2l5ZSBCaWxp
+bXNlbCB2ZSBUZWtub2xvamlrIEFyYXN0aXJtYSBLdXJ1bXUgLSBUVUJJVEFLMS0w
+KwYDVQQLEyRLYW11IFNlcnRpZmlrYXN5b24gTWVya2V6aSAtIEthbXUgU00xNjA0
+BgNVBAMTLVRVQklUQUsgS2FtdSBTTSBTU0wgS29rIFNlcnRpZmlrYXNpIC0gU3Vy
+dW0gMTAeFw0xMzExMjUwODI1NTVaFw00MzEwMjUwODI1NTVaMIHSMQswCQYDVQQG
+EwJUUjEYMBYGA1UEBxMPR2ViemUgLSBLb2NhZWxpMUIwQAYDVQQKEzlUdXJraXll
+IEJpbGltc2VsIHZlIFRla25vbG9qaWsgQXJhc3Rpcm1hIEt1cnVtdSAtIFRVQklU
+QUsxLTArBgNVBAsTJEthbXUgU2VydGlmaWthc3lvbiBNZXJrZXppIC0gS2FtdSBT
+TTE2MDQGA1UEAxMtVFVCSVRBSyBLYW11IFNNIFNTTCBLb2sgU2VydGlmaWthc2kg
+LSBTdXJ1bSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAr3UwM6q7
+a9OZLBI3hNmNe5eA027n/5tQlT6QlVZC1xl8JoSNkvoBHToP4mQ4t4y86Ij5iySr
+LqP1N+RAjhgleYN1Hzv/bKjFxlb4tO2KRKOrbEz8HdDc72i9z+SqzvBV96I01INr
+N3wcwv61A+xXzry0tcXtAA9TNypN9E8Mg/uGz8v+jE69h/mniyFXnHrfA2eJLJ2X
+YacQuFWQfw4tJzh03+f92k4S400VIgLI4OD8D62K18lUUMw7D8oWgITQUVbDjlZ/
+iSIzL+aFCr2lqBs23tPcLG07xxO9WSMs5uWk99gL7eqQQESolbuT1dCANLZGeA4f
+AJNG4e7p+exPFwIDAQABo0IwQDAdBgNVHQ4EFgQUZT/HiobGPN08VFw1+DrtUgxH
+V8gwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL
+BQADggEBACo/4fEyjq7hmFxLXs9rHmoJ0iKpEsdeV31zVmSAhHqT5Am5EM2fKifh
+AHe+SMg1qIGf5LgsyX8OsNJLN13qudULXjS99HMpw+0mFZx+CFOKWI3QSyjfwbPf
+IPP54+M638yclNhOT8NrF7f3cuitZjO1JVOr4PhMqZ398g26rrnZqsZr+ZO7rqu4
+lzwDGrpDxpa5RXI4s6ehlj2Re37AIVNMh+3yC1SVUZPVIqUNivGTDj5UDrDYyU7c
+8jEyVupk+eq1nRZmQnLzf9OxMUP8pI4X8W0jq5Rm+K37DwhuJi1/FwcJsoz7UMCf
+lo3Ptv0AnVoUmr8CRPXBwp8iXqIPoeM=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD.
+# Subject: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD.
+# Label: "GDCA TrustAUTH R5 ROOT"
+# Serial: 9009899650740120186
+# MD5 Fingerprint: 63:cc:d9:3d:34:35:5c:6f:53:a3:e2:08:70:48:1f:b4
+# SHA1 Fingerprint: 0f:36:38:5b:81:1a:25:c3:9b:31:4e:83:ca:e9:34:66:70:cc:74:b4
+# SHA256 Fingerprint: bf:ff:8f:d0:44:33:48:7d:6a:8a:a6:0c:1a:29:76:7a:9f:c2:bb:b0:5e:42:0f:71:3a:13:b9:92:89:1d:38:93
+-----BEGIN CERTIFICATE-----
+MIIFiDCCA3CgAwIBAgIIfQmX/vBH6nowDQYJKoZIhvcNAQELBQAwYjELMAkGA1UE
+BhMCQ04xMjAwBgNVBAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZ
+IENPLixMVEQuMR8wHQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMB4XDTE0
+MTEyNjA1MTMxNVoXDTQwMTIzMTE1NTk1OVowYjELMAkGA1UEBhMCQ04xMjAwBgNV
+BAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZIENPLixMVEQuMR8w
+HQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMIICIjANBgkqhkiG9w0BAQEF
+AAOCAg8AMIICCgKCAgEA2aMW8Mh0dHeb7zMNOwZ+Vfy1YI92hhJCfVZmPoiC7XJj
+Dp6L3TQsAlFRwxn9WVSEyfFrs0yw6ehGXTjGoqcuEVe6ghWinI9tsJlKCvLriXBj
+TnnEt1u9ol2x8kECK62pOqPseQrsXzrj/e+APK00mxqriCZ7VqKChh/rNYmDf1+u
+KU49tm7srsHwJ5uu4/Ts765/94Y9cnrrpftZTqfrlYwiOXnhLQiPzLyRuEH3FMEj
+qcOtmkVEs7LXLM3GKeJQEK5cy4KOFxg2fZfmiJqwTTQJ9Cy5WmYqsBebnh52nUpm
+MUHfP/vFBu8btn4aRjb3ZGM74zkYI+dndRTVdVeSN72+ahsmUPI2JgaQxXABZG12
+ZuGR224HwGGALrIuL4xwp9E7PLOR5G62xDtw8mySlwnNR30YwPO7ng/Wi64HtloP
+zgsMR6flPri9fcebNaBhlzpBdRfMK5Z3KpIhHtmVdiBnaM8Nvd/WHwlqmuLMc3Gk
+L30SgLdTMEZeS1SZD2fJpcjyIMGC7J0R38IC+xo70e0gmu9lZJIQDSri3nDxGGeC
+jGHeuLzRL5z7D9Ar7Rt2ueQ5Vfj4oR24qoAATILnsn8JuLwwoC8N9VKejveSswoA
+HQBUlwbgsQfZxw9cZX08bVlX5O2ljelAU58VS6Bx9hoh49pwBiFYFIeFd3mqgnkC
+AwEAAaNCMEAwHQYDVR0OBBYEFOLJQJ9NzuiaoXzPDj9lxSmIahlRMA8GA1UdEwEB
+/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQDRSVfg
+p8xoWLoBDysZzY2wYUWsEe1jUGn4H3++Fo/9nesLqjJHdtJnJO29fDMylyrHBYZm
+DRd9FBUb1Ov9H5r2XpdptxolpAqzkT9fNqyL7FeoPueBihhXOYV0GkLH6VsTX4/5
+COmSdI31R9KrO9b7eGZONn356ZLpBN79SWP8bfsUcZNnL0dKt7n/HipzcEYwv1ry
+L3ml4Y0M2fmyYzeMN2WFcGpcWwlyua1jPLHd+PwyvzeG5LuOmCd+uh8W4XAR8gPf
+JWIyJyYYMoSf/wA6E7qaTfRPuBRwIrHKK5DOKcFw9C+df/KQHtZa37dG/OaG+svg
+IHZ6uqbL9XzeYqWxi+7egmaKTjowHz+Ay60nugxe19CxVsp3cbK1daFQqUBDF8Io
+2c9Si1vIY9RCPqAzekYu9wogRlR+ak8x8YF+QnQ4ZXMn7sZ8uI7XpTrXmKGcjBBV
+09tL7ECQ8s1uV9JiDnxXk7Gnbc2dg7sq5+W2O3FYrf3RRbxake5TFW/TRQl1brqQ
+XR4EzzffHqhmsYzmIGrv/EhOdJhCrylvLmrH+33RZjEizIYAfmaDDEL0vTSSwxrq
+T8p+ck0LcIymSLumoRT2+1hEmRSuqguTaaApJUqlyyvdimYHFngVV3Eb7PVHhPOe
+MTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=TrustCor RootCert CA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Subject: CN=TrustCor RootCert CA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Label: "TrustCor RootCert CA-1"
+# Serial: 15752444095811006489
+# MD5 Fingerprint: 6e:85:f1:dc:1a:00:d3:22:d5:b2:b2:ac:6b:37:05:45
+# SHA1 Fingerprint: ff:bd:cd:e7:82:c8:43:5e:3c:6f:26:86:5c:ca:a8:3a:45:5b:c3:0a
+# SHA256 Fingerprint: d4:0e:9c:86:cd:8f:e4:68:c1:77:69:59:f4:9e:a7:74:fa:54:86:84:b6:c4:06:f3:90:92:61:f4:dc:e2:57:5c
+-----BEGIN CERTIFICATE-----
+MIIEMDCCAxigAwIBAgIJANqb7HHzA7AZMA0GCSqGSIb3DQEBCwUAMIGkMQswCQYD
+VQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEk
+MCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5U
+cnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHzAdBgNVBAMMFlRydXN0Q29y
+IFJvb3RDZXJ0IENBLTEwHhcNMTYwMjA0MTIzMjE2WhcNMjkxMjMxMTcyMzE2WjCB
+pDELMAkGA1UEBhMCUEExDzANBgNVBAgMBlBhbmFtYTEUMBIGA1UEBwwLUGFuYW1h
+IENpdHkxJDAiBgNVBAoMG1RydXN0Q29yIFN5c3RlbXMgUy4gZGUgUi5MLjEnMCUG
+A1UECwweVHJ1c3RDb3IgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MR8wHQYDVQQDDBZU
+cnVzdENvciBSb290Q2VydCBDQS0xMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
+CgKCAQEAv463leLCJhJrMxnHQFgKq1mqjQCj/IDHUHuO1CAmujIS2CNUSSUQIpid
+RtLByZ5OGy4sDjjzGiVoHKZaBeYei0i/mJZ0PmnK6bV4pQa81QBeCQryJ3pS/C3V
+seq0iWEk8xoT26nPUu0MJLq5nux+AHT6k61sKZKuUbS701e/s/OojZz0JEsq1pme
+9J7+wH5COucLlVPat2gOkEz7cD+PSiyU8ybdY2mplNgQTsVHCJCZGxdNuWxu72CV
+EY4hgLW9oHPY0LJ3xEXqWib7ZnZ2+AYfYW0PVcWDtxBWcgYHpfOxGgMFZA6dWorW
+hnAbJN7+KIor0Gqw/Hqi3LJ5DotlDwIDAQABo2MwYTAdBgNVHQ4EFgQU7mtJPHo/
+DeOxCbeKyKsZn3MzUOcwHwYDVR0jBBgwFoAU7mtJPHo/DeOxCbeKyKsZn3MzUOcw
+DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQAD
+ggEBACUY1JGPE+6PHh0RU9otRCkZoB5rMZ5NDp6tPVxBb5UrJKF5mDo4Nvu7Zp5I
+/5CQ7z3UuJu0h3U/IJvOcs+hVcFNZKIZBqEHMwwLKeXx6quj7LUKdJDHfXLy11yf
+ke+Ri7fc7Waiz45mO7yfOgLgJ90WmMCV1Aqk5IGadZQ1nJBfiDcGrVmVCrDRZ9MZ
+yonnMlo2HD6CqFqTvsbQZJG2z9m2GM/bftJlo6bEjhcxwft+dtvTheNYsnd6djts
+L1Ac59v2Z3kf9YKVmgenFK+P3CghZwnS1k1aHBkcjndcw5QkPTJrS37UeJSDvjdN
+zl/HHk484IkzlQsPpTLWPFp5LBk=
+-----END CERTIFICATE-----
+
+# Issuer: CN=TrustCor RootCert CA-2 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Subject: CN=TrustCor RootCert CA-2 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Label: "TrustCor RootCert CA-2"
+# Serial: 2711694510199101698
+# MD5 Fingerprint: a2:e1:f8:18:0b:ba:45:d5:c7:41:2a:bb:37:52:45:64
+# SHA1 Fingerprint: b8:be:6d:cb:56:f1:55:b9:63:d4:12:ca:4e:06:34:c7:94:b2:1c:c0
+# SHA256 Fingerprint: 07:53:e9:40:37:8c:1b:d5:e3:83:6e:39:5d:ae:a5:cb:83:9e:50:46:f1:bd:0e:ae:19:51:cf:10:fe:c7:c9:65
+-----BEGIN CERTIFICATE-----
+MIIGLzCCBBegAwIBAgIIJaHfyjPLWQIwDQYJKoZIhvcNAQELBQAwgaQxCzAJBgNV
+BAYTAlBBMQ8wDQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5MSQw
+IgYDVQQKDBtUcnVzdENvciBTeXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRy
+dXN0Q29yIENlcnRpZmljYXRlIEF1dGhvcml0eTEfMB0GA1UEAwwWVHJ1c3RDb3Ig
+Um9vdENlcnQgQ0EtMjAeFw0xNjAyMDQxMjMyMjNaFw0zNDEyMzExNzI2MzlaMIGk
+MQswCQYDVQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEg
+Q2l0eTEkMCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYD
+VQQLDB5UcnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHzAdBgNVBAMMFlRy
+dXN0Q29yIFJvb3RDZXJ0IENBLTIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK
+AoICAQCnIG7CKqJiJJWQdsg4foDSq8GbZQWU9MEKENUCrO2fk8eHyLAnK0IMPQo+
+QVqedd2NyuCb7GgypGmSaIwLgQ5WoD4a3SwlFIIvl9NkRvRUqdw6VC0xK5mC8tkq
+1+9xALgxpL56JAfDQiDyitSSBBtlVkxs1Pu2YVpHI7TYabS3OtB0PAx1oYxOdqHp
+2yqlO/rOsP9+aij9JxzIsekp8VduZLTQwRVtDr4uDkbIXvRR/u8OYzo7cbrPb1nK
+DOObXUm4TOJXsZiKQlecdu/vvdFoqNL0Cbt3Nb4lggjEFixEIFapRBF37120Hape
+az6LMvYHL1cEksr1/p3C6eizjkxLAjHZ5DxIgif3GIJ2SDpxsROhOdUuxTTCHWKF
+3wP+TfSvPd9cW436cOGlfifHhi5qjxLGhF5DUVCcGZt45vz27Ud+ez1m7xMTiF88
+oWP7+ayHNZ/zgp6kPwqcMWmLmaSISo5uZk3vFsQPeSghYA2FFn3XVDjxklb9tTNM
+g9zXEJ9L/cb4Qr26fHMC4P99zVvh1Kxhe1fVSntb1IVYJ12/+CtgrKAmrhQhJ8Z3
+mjOAPF5GP/fDsaOGM8boXg25NSyqRsGFAnWAoOsk+xWq5Gd/bnc/9ASKL3x74xdh
+8N0JqSDIvgmk0H5Ew7IwSjiqqewYmgeCK9u4nBit2uBGF6zPXQIDAQABo2MwYTAd
+BgNVHQ4EFgQU2f4hQG6UnrybPZx9mCAZ5YwwYrIwHwYDVR0jBBgwFoAU2f4hQG6U
+nrybPZx9mCAZ5YwwYrIwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYw
+DQYJKoZIhvcNAQELBQADggIBAJ5Fngw7tu/hOsh80QA9z+LqBrWyOrsGS2h60COX
+dKcs8AjYeVrXWoSK2BKaG9l9XE1wxaX5q+WjiYndAfrs3fnpkpfbsEZC89NiqpX+
+MWcUaViQCqoL7jcjx1BRtPV+nuN79+TMQjItSQzL/0kMmx40/W5ulop5A7Zv2wnL
+/V9lFDfhOPXzYRZY5LVtDQsEGz9QLX+zx3oaFoBg+Iof6Rsqxvm6ARppv9JYx1RX
+CI/hOWB3S6xZhBqI8d3LT3jX5+EzLfzuQfogsL7L9ziUwOHQhQ+77Sxzq+3+knYa
+ZH9bDTMJBzN7Bj8RpFxwPIXAz+OQqIN3+tvmxYxoZxBnpVIt8MSZj3+/0WvitUfW
+2dCFmU2Umw9Lje4AWkcdEQOsQRivh7dvDDqPys/cA8GiCcjl/YBeyGBCARsaU1q7
+N6a3vLqE6R5sGtRk2tRD/pOLS/IseRYQ1JMLiI+h2IYURpFHmygk71dSTlxCnKr3
+Sewn6EAes6aJInKc9Q0ztFijMDvd1GpUk74aTfOTlPf8hAs/hCBcNANExdqtvArB
+As8e5ZTZ845b2EzwnexhF7sUMlQMAimTHpKG9n/v55IFDlndmQguLvqcAFLTxWYp
+5KeXRKQOKIETNcX2b2TmQcTVL8w0RSXPQQCWPUouwpaYT05KnJe32x+SMsj/D1Fu
+1uwJ
+-----END CERTIFICATE-----
+
+# Issuer: CN=TrustCor ECA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Subject: CN=TrustCor ECA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Label: "TrustCor ECA-1"
+# Serial: 9548242946988625984
+# MD5 Fingerprint: 27:92:23:1d:0a:f5:40:7c:e9:e6:6b:9d:d8:f5:e7:6c
+# SHA1 Fingerprint: 58:d1:df:95:95:67:6b:63:c0:f0:5b:1c:17:4d:8b:84:0b:c8:78:bd
+# SHA256 Fingerprint: 5a:88:5d:b1:9c:01:d9:12:c5:75:93:88:93:8c:af:bb:df:03:1a:b2:d4:8e:91:ee:15:58:9b:42:97:1d:03:9c
+-----BEGIN CERTIFICATE-----
+MIIEIDCCAwigAwIBAgIJAISCLF8cYtBAMA0GCSqGSIb3DQEBCwUAMIGcMQswCQYD
+VQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEk
+MCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5U
+cnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxFzAVBgNVBAMMDlRydXN0Q29y
+IEVDQS0xMB4XDTE2MDIwNDEyMzIzM1oXDTI5MTIzMTE3MjgwN1owgZwxCzAJBgNV
+BAYTAlBBMQ8wDQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5MSQw
+IgYDVQQKDBtUcnVzdENvciBTeXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRy
+dXN0Q29yIENlcnRpZmljYXRlIEF1dGhvcml0eTEXMBUGA1UEAwwOVHJ1c3RDb3Ig
+RUNBLTEwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDPj+ARtZ+odnbb
+3w9U73NjKYKtR8aja+3+XzP4Q1HpGjORMRegdMTUpwHmspI+ap3tDvl0mEDTPwOA
+BoJA6LHip1GnHYMma6ve+heRK9jGrB6xnhkB1Zem6g23xFUfJ3zSCNV2HykVh0A5
+3ThFEXXQmqc04L/NyFIduUd+Dbi7xgz2c1cWWn5DkR9VOsZtRASqnKmcp0yJF4Ou
+owReUoCLHhIlERnXDH19MURB6tuvsBzvgdAsxZohmz3tQjtQJvLsznFhBmIhVE5/
+wZ0+fyCMgMsq2JdiyIMzkX2woloPV+g7zPIlstR8L+xNxqE6FXrntl019fZISjZF
+ZtS6mFjBAgMBAAGjYzBhMB0GA1UdDgQWBBREnkj1zG1I1KBLf/5ZJC+Dl5mahjAf
+BgNVHSMEGDAWgBREnkj1zG1I1KBLf/5ZJC+Dl5mahjAPBgNVHRMBAf8EBTADAQH/
+MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAQEABT41XBVwm8nHc2Fv
+civUwo/yQ10CzsSUuZQRg2dd4mdsdXa/uwyqNsatR5Nj3B5+1t4u/ukZMjgDfxT2
+AHMsWbEhBuH7rBiVDKP/mZb3Kyeb1STMHd3BOuCYRLDE5D53sXOpZCz2HAF8P11F
+hcCF5yWPldwX8zyfGm6wyuMdKulMY/okYWLW2n62HGz1Ah3UKt1VkOsqEUc8Ll50
+soIipX1TH0XsJ5F95yIW6MBoNtjG8U+ARDL54dHRHareqKucBK+tIA5kmE2la8BI
+WJZpTdwHjFGTot+fDz2LYLSCjaoITmJF4PkL0uDgPFveXHEnJcLmA4GLEFPjx1Wi
+tJ/X5g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
+# Subject: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
+# Label: "SSL.com Root Certification Authority RSA"
+# Serial: 8875640296558310041
+# MD5 Fingerprint: 86:69:12:c0:70:f1:ec:ac:ac:c2:d5:bc:a5:5b:a1:29
+# SHA1 Fingerprint: b7:ab:33:08:d1:ea:44:77:ba:14:80:12:5a:6f:bd:a9:36:49:0c:bb
+# SHA256 Fingerprint: 85:66:6a:56:2e:e0:be:5c:e9:25:c1:d8:89:0a:6f:76:a8:7e:c1:6d:4d:7d:5f:29:ea:74:19:cf:20:12:3b:69
+-----BEGIN CERTIFICATE-----
+MIIF3TCCA8WgAwIBAgIIeyyb0xaAMpkwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UE
+BhMCVVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQK
+DA9TU0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZp
+Y2F0aW9uIEF1dGhvcml0eSBSU0EwHhcNMTYwMjEyMTczOTM5WhcNNDEwMjEyMTcz
+OTM5WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv
+dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNv
+bSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTCCAiIwDQYJKoZIhvcN
+AQEBBQADggIPADCCAgoCggIBAPkP3aMrfcvQKv7sZ4Wm5y4bunfh4/WvpOz6Sl2R
+xFdHaxh3a3by/ZPkPQ/CFp4LZsNWlJ4Xg4XOVu/yFv0AYvUiCVToZRdOQbngT0aX
+qhvIuG5iXmmxX9sqAn78bMrzQdjt0Oj8P2FI7bADFB0QDksZ4LtO7IZl/zbzXmcC
+C52GVWH9ejjt/uIZALdvoVBidXQ8oPrIJZK0bnoix/geoeOy3ZExqysdBP+lSgQ3
+6YWkMyv94tZVNHwZpEpox7Ko07fKoZOI68GXvIz5HdkihCR0xwQ9aqkpk8zruFvh
+/l8lqjRYyMEjVJ0bmBHDOJx+PYZspQ9AhnwC9FwCTyjLrnGfDzrIM/4RJTXq/LrF
+YD3ZfBjVsqnTdXgDciLKOsMf7yzlLqn6niy2UUb9rwPW6mBo6oUWNmuF6R7As93E
+JNyAKoFBbZQ+yODJgUEAnl6/f8UImKIYLEJAs/lvOCdLToD0PYFH4Ih86hzOtXVc
+US4cK38acijnALXRdMbX5J+tB5O2UzU1/Dfkw/ZdFr4hc96SCvigY2q8lpJqPvi8
+ZVWb3vUNiSYE/CUapiVpy8JtynziWV+XrOvvLsi81xtZPCvM8hnIk2snYxnP/Okm
++Mpxm3+T/jRnhE6Z6/yzeAkzcLpmpnbtG3PrGqUNxCITIJRWCk4sbE6x/c+cCbqi
+M+2HAgMBAAGjYzBhMB0GA1UdDgQWBBTdBAkHovV6fVJTEpKV7jiAJQ2mWTAPBgNV
+HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFN0ECQei9Xp9UlMSkpXuOIAlDaZZMA4G
+A1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAIBgRlCn7Jp0cHh5wYfGV
+cpNxJK1ok1iOMq8bs3AD/CUrdIWQPXhq9LmLpZc7tRiRux6n+UBbkflVma8eEdBc
+Hadm47GUBwwyOabqG7B52B2ccETjit3E+ZUfijhDPwGFpUenPUayvOUiaPd7nNgs
+PgohyC0zrL/FgZkxdMF1ccW+sfAjRfSda/wZY52jvATGGAslu1OJD7OAUN5F7kR/
+q5R4ZJjT9ijdh9hwZXT7DrkT66cPYakylszeu+1jTBi7qUD3oFRuIIhxdRjqerQ0
+cuAjJ3dctpDqhiVAq+8zD8ufgr6iIPv2tS0a5sKFsXQP+8hlAqRSAUfdSSLBv9jr
+a6x+3uxjMxW3IwiPxg+NQVrdjsW5j+VFP3jbutIbQLH+cU0/4IGiul607BXgk90I
+H37hVZkLId6Tngr75qNJvTYw/ud3sqB1l7UtgYgXZSD32pAAn8lSzDLKNXz1PQ/Y
+K9f1JmzJBjSWFupwWRoyeXkLtoh/D1JIPb9s2KJELtFOt3JY04kTlf5Eq/jXixtu
+nLwsoFvVagCvXzfh1foQC5ichucmj87w7G6KVwuA406ywKBjYZC6VWg3dGq2ktuf
+oYYitmUnDuy2n0Jg5GfCtdpBC8TTi2EbvPofkSvXRAdeuims2cXp71NIWuuA8ShY
+Ic2wBlX7Jz9TkHCpBB5XJ7k=
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com Root Certification Authority ECC O=SSL Corporation
+# Subject: CN=SSL.com Root Certification Authority ECC O=SSL Corporation
+# Label: "SSL.com Root Certification Authority ECC"
+# Serial: 8495723813297216424
+# MD5 Fingerprint: 2e:da:e4:39:7f:9c:8f:37:d1:70:9f:26:17:51:3a:8e
+# SHA1 Fingerprint: c3:19:7c:39:24:e6:54:af:1b:c4:ab:20:95:7a:e2:c3:0e:13:02:6a
+# SHA256 Fingerprint: 34:17:bb:06:cc:60:07:da:1b:96:1c:92:0b:8a:b4:ce:3f:ad:82:0e:4a:a3:0b:9a:cb:c4:a7:4e:bd:ce:bc:65
+-----BEGIN CERTIFICATE-----
+MIICjTCCAhSgAwIBAgIIdebfy8FoW6gwCgYIKoZIzj0EAwIwfDELMAkGA1UEBhMC
+VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T
+U0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZpY2F0
+aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNDAzWhcNNDEwMjEyMTgxNDAz
+WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0
+b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNvbSBS
+b290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49AgEGBSuB
+BAAiA2IABEVuqVDEpiM2nl8ojRfLliJkP9x6jh3MCLOicSS6jkm5BBtHllirLZXI
+7Z4INcgn64mMU1jrYor+8FsPazFSY0E7ic3s7LaNGdM0B9y7xgZ/wkWV7Mt/qCPg
+CemB+vNH06NjMGEwHQYDVR0OBBYEFILRhXMw5zUE044CkvvlpNHEIejNMA8GA1Ud
+EwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUgtGFczDnNQTTjgKS++Wk0cQh6M0wDgYD
+VR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2cAMGQCMG/n61kRpGDPYbCWe+0F+S8T
+kdzt5fxQaxFGRrMcIQBiu77D5+jNB5n5DQtdcj7EqgIwH7y6C+IwJPt8bYBVCpk+
+gA0z5Wajs6O7pdWLjwkspl1+4vAHCGht0nxpbl/f5Wpl
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation
+# Subject: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation
+# Label: "SSL.com EV Root Certification Authority RSA R2"
+# Serial: 6248227494352943350
+# MD5 Fingerprint: e1:1e:31:58:1a:ae:54:53:02:f6:17:6a:11:7b:4d:95
+# SHA1 Fingerprint: 74:3a:f0:52:9b:d0:32:a0:f4:4a:83:cd:d4:ba:a9:7b:7c:2e:c4:9a
+# SHA256 Fingerprint: 2e:7b:f1:6c:c2:24:85:a7:bb:e2:aa:86:96:75:07:61:b0:ae:39:be:3b:2f:e9:d0:cc:6d:4e:f7:34:91:42:5c
+-----BEGIN CERTIFICATE-----
+MIIF6zCCA9OgAwIBAgIIVrYpzTS8ePYwDQYJKoZIhvcNAQELBQAwgYIxCzAJBgNV
+BAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UE
+CgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQDDC5TU0wuY29tIEVWIFJvb3QgQ2Vy
+dGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIyMB4XDTE3MDUzMTE4MTQzN1oXDTQy
+MDUzMDE4MTQzN1owgYIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4G
+A1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQD
+DC5TU0wuY29tIEVWIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIy
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAjzZlQOHWTcDXtOlG2mvq
+M0fNTPl9fb69LT3w23jhhqXZuglXaO1XPqDQCEGD5yhBJB/jchXQARr7XnAjssuf
+OePPxU7Gkm0mxnu7s9onnQqG6YE3Bf7wcXHswxzpY6IXFJ3vG2fThVUCAtZJycxa
+4bH3bzKfydQ7iEGonL3Lq9ttewkfokxykNorCPzPPFTOZw+oz12WGQvE43LrrdF9
+HSfvkusQv1vrO6/PgN3B0pYEW3p+pKk8OHakYo6gOV7qd89dAFmPZiw+B6KjBSYR
+aZfqhbcPlgtLyEDhULouisv3D5oi53+aNxPN8k0TayHRwMwi8qFG9kRpnMphNQcA
+b9ZhCBHqurj26bNg5U257J8UZslXWNvNh2n4ioYSA0e/ZhN2rHd9NCSFg83XqpyQ
+Gp8hLH94t2S42Oim9HizVcuE0jLEeK6jj2HdzghTreyI/BXkmg3mnxp3zkyPuBQV
+PWKchjgGAGYS5Fl2WlPAApiiECtoRHuOec4zSnaqW4EWG7WK2NAAe15itAnWhmMO
+pgWVSbooi4iTsjQc2KRVbrcc0N6ZVTsj9CLg+SlmJuwgUHfbSguPvuUCYHBBXtSu
+UDkiFCbLsjtzdFVHB3mBOagwE0TlBIqulhMlQg+5U8Sb/M3kHN48+qvWBkofZ6aY
+MBzdLNvcGJVXZsb/XItW9XcCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNV
+HSMEGDAWgBT5YLvU49U09rj1BoAlp3PbRmmonjAdBgNVHQ4EFgQU+WC71OPVNPa4
+9QaAJadz20ZpqJ4wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQBW
+s47LCp1Jjr+kxJG7ZhcFUZh1++VQLHqe8RT6q9OKPv+RKY9ji9i0qVQBDb6Thi/5
+Sm3HXvVX+cpVHBK+Rw82xd9qt9t1wkclf7nxY/hoLVUE0fKNsKTPvDxeH3jnpaAg
+cLAExbf3cqfeIg29MyVGjGSSJuM+LmOW2puMPfgYCdcDzH2GguDKBAdRUNf/ktUM
+79qGn5nX67evaOI5JpS6aLe/g9Pqemc9YmeuJeVy6OLk7K4S9ksrPJ/psEDzOFSz
+/bdoyNrGj1E8svuR3Bznm53htw1yj+KkxKl4+esUrMZDBcJlOSgYAsOCsp0FvmXt
+ll9ldDz7CTUue5wT/RsPXcdtgTpWD8w74a8CLyKsRspGPKAcTNZEtF4uXBVmCeEm
+Kf7GUmG6sXP/wwyc5WxqlD8UykAWlYTzWamsX0xhk23RO8yilQwipmdnRC652dKK
+QbNmC1r7fSOl8hqw/96bg5Qu0T/fkreRrwU7ZcegbLHNYhLDkBvjJc40vG93drEQ
+w/cFGsDWr3RiSBd3kmmQYRzelYB0VI8YHMPzA9C/pEN1hlMYegouCRw2n5H9gooi
+S9EOUCXdywMMF8mDAAhONU2Ki+3wApRmLER/y5UnlhetCTCstnEXbosX9hwJ1C07
+mKVx01QT2WDz9UtmT/rx7iASjbSsV7FFY6GsdqnC+w==
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation
+# Subject: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation
+# Label: "SSL.com EV Root Certification Authority ECC"
+# Serial: 3182246526754555285
+# MD5 Fingerprint: 59:53:22:65:83:42:01:54:c0:ce:42:b9:5a:7c:f2:90
+# SHA1 Fingerprint: 4c:dd:51:a3:d1:f5:20:32:14:b0:c6:c5:32:23:03:91:c7:46:42:6d
+# SHA256 Fingerprint: 22:a2:c1:f7:bd:ed:70:4c:c1:e7:01:b5:f4:08:c3:10:88:0f:e9:56:b5:de:2a:4a:44:f9:9c:87:3a:25:a7:c8
+-----BEGIN CERTIFICATE-----
+MIIClDCCAhqgAwIBAgIILCmcWxbtBZUwCgYIKoZIzj0EAwIwfzELMAkGA1UEBhMC
+VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T
+U0wgQ29ycG9yYXRpb24xNDAyBgNVBAMMK1NTTC5jb20gRVYgUm9vdCBDZXJ0aWZp
+Y2F0aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNTIzWhcNNDEwMjEyMTgx
+NTIzWjB/MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv
+dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjE0MDIGA1UEAwwrU1NMLmNv
+bSBFViBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49
+AgEGBSuBBAAiA2IABKoSR5CYG/vvw0AHgyBO8TCCogbR8pKGYfL2IWjKAMTH6kMA
+VIbc/R/fALhBYlzccBYy3h+Z1MzFB8gIH2EWB1E9fVwHU+M1OIzfzZ/ZLg1Kthku
+WnBaBu2+8KGwytAJKaNjMGEwHQYDVR0OBBYEFFvKXuXe0oGqzagtZFG22XKbl+ZP
+MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUW8pe5d7SgarNqC1kUbbZcpuX
+5k8wDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2gAMGUCMQCK5kCJN+vp1RPZ
+ytRrJPOwPYdGWBrssd9v+1a6cGvHOMzosYxPD/fxZ3YOg9AeUY8CMD32IygmTMZg
+h5Mmm7I1HrrW9zzRHM76JTymGoEVW/MSD2zuZYrJh6j5B+BimoxcSg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6
+# Label: "GlobalSign Root CA - R6"
+# Serial: 1417766617973444989252670301619537
+# MD5 Fingerprint: 4f:dd:07:e4:d4:22:64:39:1e:0c:37:42:ea:d1:c6:ae
+# SHA1 Fingerprint: 80:94:64:0e:b5:a7:a1:ca:11:9c:1f:dd:d5:9f:81:02:63:a7:fb:d1
+# SHA256 Fingerprint: 2c:ab:ea:fe:37:d0:6c:a2:2a:ba:73:91:c0:03:3d:25:98:29:52:c4:53:64:73:49:76:3a:3a:b5:ad:6c:cf:69
+-----BEGIN CERTIFICATE-----
+MIIFgzCCA2ugAwIBAgIORea7A4Mzw4VlSOb/RVEwDQYJKoZIhvcNAQEMBQAwTDEg
+MB4GA1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjYxEzARBgNVBAoTCkdsb2Jh
+bFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMTQxMjEwMDAwMDAwWhcNMzQx
+MjEwMDAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSNjET
+MBEGA1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCAiIwDQYJ
+KoZIhvcNAQEBBQADggIPADCCAgoCggIBAJUH6HPKZvnsFMp7PPcNCPG0RQssgrRI
+xutbPK6DuEGSMxSkb3/pKszGsIhrxbaJ0cay/xTOURQh7ErdG1rG1ofuTToVBu1k
+ZguSgMpE3nOUTvOniX9PeGMIyBJQbUJmL025eShNUhqKGoC3GYEOfsSKvGRMIRxD
+aNc9PIrFsmbVkJq3MQbFvuJtMgamHvm566qjuL++gmNQ0PAYid/kD3n16qIfKtJw
+LnvnvJO7bVPiSHyMEAc4/2ayd2F+4OqMPKq0pPbzlUoSB239jLKJz9CgYXfIWHSw
+1CM69106yqLbnQneXUQtkPGBzVeS+n68UARjNN9rkxi+azayOeSsJDa38O+2HBNX
+k7besvjihbdzorg1qkXy4J02oW9UivFyVm4uiMVRQkQVlO6jxTiWm05OWgtH8wY2
+SXcwvHE35absIQh1/OZhFj931dmRl4QKbNQCTXTAFO39OfuD8l4UoQSwC+n+7o/h
+bguyCLNhZglqsQY6ZZZZwPA1/cnaKI0aEYdwgQqomnUdnjqGBQCe24DWJfncBZ4n
+WUx2OVvq+aWh2IMP0f/fMBH5hc8zSPXKbWQULHpYT9NLCEnFlWQaYw55PfWzjMpY
+rZxCRXluDocZXFSxZba/jJvcE+kNb7gu3GduyYsRtYQUigAZcIN5kZeR1Bonvzce
+MgfYFGM8KEyvAgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTAD
+AQH/MB0GA1UdDgQWBBSubAWjkxPioufi1xzWx/B/yGdToDAfBgNVHSMEGDAWgBSu
+bAWjkxPioufi1xzWx/B/yGdToDANBgkqhkiG9w0BAQwFAAOCAgEAgyXt6NH9lVLN
+nsAEoJFp5lzQhN7craJP6Ed41mWYqVuoPId8AorRbrcWc+ZfwFSY1XS+wc3iEZGt
+Ixg93eFyRJa0lV7Ae46ZeBZDE1ZXs6KzO7V33EByrKPrmzU+sQghoefEQzd5Mr61
+55wsTLxDKZmOMNOsIeDjHfrYBzN2VAAiKrlNIC5waNrlU/yDXNOd8v9EDERm8tLj
+vUYAGm0CuiVdjaExUd1URhxN25mW7xocBFymFe944Hn+Xds+qkxV/ZoVqW/hpvvf
+cDDpw+5CRu3CkwWJ+n1jez/QcYF8AOiYrg54NMMl+68KnyBr3TsTjxKM4kEaSHpz
+oHdpx7Zcf4LIHv5YGygrqGytXm3ABdJ7t+uA/iU3/gKbaKxCXcPu9czc8FB10jZp
+nOZ7BN9uBmm23goJSFmH63sUYHpkqmlD75HHTOwY3WzvUy2MmeFe8nI+z1TIvWfs
+pA9MRf/TuTAjB0yPEL+GltmZWrSZVxykzLsViVO6LAUP5MSeGbEYNNVMnbrt9x+v
+JJUEeKgDu+6B5dpffItKoZB0JaezPkvILFa9x8jvOOJckvB595yEunQtYQEgfn7R
+8k8HWV+LLUNS60YMlOH1Zkd5d9VUWx+tJDfLRVpOoERIyNiwmcUVhAn21klJwGW4
+5hpxbqCo8YLoRT5s1gLXCmeDBVrJpBA=
+-----END CERTIFICATE-----
+
+# Issuer: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed
+# Subject: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed
+# Label: "OISTE WISeKey Global Root GC CA"
+# Serial: 44084345621038548146064804565436152554
+# MD5 Fingerprint: a9:d6:b9:2d:2f:93:64:f8:a5:69:ca:91:e9:68:07:23
+# SHA1 Fingerprint: e0:11:84:5e:34:de:be:88:81:b9:9c:f6:16:26:d1:96:1f:c3:b9:31
+# SHA256 Fingerprint: 85:60:f9:1c:36:24:da:ba:95:70:b5:fe:a0:db:e3:6f:f1:1a:83:23:be:94:86:85:4f:b3:f3:4a:55:71:19:8d
+-----BEGIN CERTIFICATE-----
+MIICaTCCAe+gAwIBAgIQISpWDK7aDKtARb8roi066jAKBggqhkjOPQQDAzBtMQsw
+CQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUgRm91
+bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwg
+Um9vdCBHQyBDQTAeFw0xNzA1MDkwOTQ4MzRaFw00MjA1MDkwOTU4MzNaMG0xCzAJ
+BgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBGb3Vu
+ZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2JhbCBS
+b290IEdDIENBMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAETOlQwMYPchi82PG6s4ni
+eUqjFqdrVCTbUf/q9Akkwwsin8tqJ4KBDdLArzHkdIJuyiXZjHWd8dvQmqJLIX4W
+p2OQ0jnUsYd4XxiWD1AbNTcPasbc2RNNpI6QN+a9WzGRo1QwUjAOBgNVHQ8BAf8E
+BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUSIcUrOPDnpBgOtfKie7T
+rYy0UGYwEAYJKwYBBAGCNxUBBAMCAQAwCgYIKoZIzj0EAwMDaAAwZQIwJsdpW9zV
+57LnyAyMjMPdeYwbY9XJUpROTYJKcx6ygISpJcBMWm1JKWB4E+J+SOtkAjEA2zQg
+Mgj/mkkCtojeFK9dbJlxjRo/i9fgojaGHAeCOnZT/cKi7e97sIBPWA9LUzm9
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R1 O=Google Trust Services LLC
+# Subject: CN=GTS Root R1 O=Google Trust Services LLC
+# Label: "GTS Root R1"
+# Serial: 146587175971765017618439757810265552097
+# MD5 Fingerprint: 82:1a:ef:d4:d2:4a:f2:9f:e2:3d:97:06:14:70:72:85
+# SHA1 Fingerprint: e1:c9:50:e6:ef:22:f8:4c:56:45:72:8b:92:20:60:d7:d5:a7:a3:e8
+# SHA256 Fingerprint: 2a:57:54:71:e3:13:40:bc:21:58:1c:bd:2c:f1:3e:15:84:63:20:3e:ce:94:bc:f9:d3:cc:19:6b:f0:9a:54:72
+-----BEGIN CERTIFICATE-----
+MIIFWjCCA0KgAwIBAgIQbkepxUtHDA3sM9CJuRz04TANBgkqhkiG9w0BAQwFADBH
+MQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExM
+QzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIy
+MDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNl
+cnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQC2EQKLHuOhd5s73L+UPreVp0A8of2C+X0yBoJx9vaM
+f/vo27xqLpeXo4xL+Sv2sfnOhB2x+cWX3u+58qPpvBKJXqeqUqv4IyfLpLGcY9vX
+mX7wCl7raKb0xlpHDU0QM+NOsROjyBhsS+z8CZDfnWQpJSMHobTSPS5g4M/SCYe7
+zUjwTcLCeoiKu7rPWRnWr4+wB7CeMfGCwcDfLqZtbBkOtdh+JhpFAz2weaSUKK0P
+fyblqAj+lug8aJRT7oM6iCsVlgmy4HqMLnXWnOunVmSPlk9orj2XwoSPwLxAwAtc
+vfaHszVsrBhQf4TgTM2S0yDpM7xSma8ytSmzJSq0SPly4cpk9+aCEI3oncKKiPo4
+Zor8Y/kB+Xj9e1x3+naH+uzfsQ55lVe0vSbv1gHR6xYKu44LtcXFilWr06zqkUsp
+zBmkMiVOKvFlRNACzqrOSbTqn3yDsEB750Orp2yjj32JgfpMpf/VjsPOS+C12LOO
+Rc92wO1AK/1TD7Cn1TsNsYqiA94xrcx36m97PtbfkSIS5r762DL8EGMUUXLeXdYW
+k70paDPvOmbsB4om3xPXV2V4J95eSRQAogB/mqghtqmxlbCluQ0WEdrHbEg8QOB+
+DVrNVjzRlwW5y0vtOUucxD/SVRNuJLDWcfr0wbrM7Rv1/oFB2ACYPTrIrnqYNxgF
+lQIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
+HQ4EFgQU5K8rJnEaK0gnhS9SZizv8IkTcT4wDQYJKoZIhvcNAQEMBQADggIBADiW
+Cu49tJYeX++dnAsznyvgyv3SjgofQXSlfKqE1OXyHuY3UjKcC9FhHb8owbZEKTV1
+d5iyfNm9dKyKaOOpMQkpAWBz40d8U6iQSifvS9efk+eCNs6aaAyC58/UEBZvXw6Z
+XPYfcX3v73svfuo21pdwCxXu11xWajOl40k4DLh9+42FpLFZXvRq4d2h9mREruZR
+gyFmxhE+885H7pwoHyXa/6xmld01D1zvICxi/ZG6qcz8WpyTgYMpl0p8WnK0OdC3
+d8t5/Wk6kjftbjhlRn7pYL15iJdfOBL07q9bgsiG1eGZbYwE8na6SfZu6W0eX6Dv
+J4J2QPim01hcDyxC2kLGe4g0x8HYRZvBPsVhHdljUEn2NIVq4BjFbkerQUIpm/Zg
+DdIx02OYI5NaAIFItO/Nis3Jz5nu2Z6qNuFoS3FJFDYoOj0dzpqPJeaAcWErtXvM
++SUWgeExX6GjfhaknBZqlxi9dnKlC54dNuYvoS++cJEPqOba+MSSQGwlfnuzCdyy
+F62ARPBopY+Udf90WuioAnwMCeKpSwughQtiue+hMZL77/ZRBIls6Kl0obsXs7X9
+SQ98POyDGCBDTtWTurQ0sR8WNh8M5mQ5Fkzc4P4dyKliPUDqysU0ArSuiYgzNdws
+E3PYJ/HQcu51OyLemGhmW/HGY0dVHLqlCFF1pkgl
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R2 O=Google Trust Services LLC
+# Subject: CN=GTS Root R2 O=Google Trust Services LLC
+# Label: "GTS Root R2"
+# Serial: 146587176055767053814479386953112547951
+# MD5 Fingerprint: 44:ed:9a:0e:a4:09:3b:00:f2:ae:4c:a3:c6:61:b0:8b
+# SHA1 Fingerprint: d2:73:96:2a:2a:5e:39:9f:73:3f:e1:c7:1e:64:3f:03:38:34:fc:4d
+# SHA256 Fingerprint: c4:5d:7b:b0:8e:6d:67:e6:2e:42:35:11:0b:56:4e:5f:78:fd:92:ef:05:8c:84:0a:ea:4e:64:55:d7:58:5c:60
+-----BEGIN CERTIFICATE-----
+MIIFWjCCA0KgAwIBAgIQbkepxlqz5yDFMJo/aFLybzANBgkqhkiG9w0BAQwFADBH
+MQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExM
+QzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIy
+MDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNl
+cnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQDO3v2m++zsFDQ8BwZabFn3GTXd98GdVarTzTukk3Lv
+CvptnfbwhYBboUhSnznFt+4orO/LdmgUud+tAWyZH8QiHZ/+cnfgLFuv5AS/T3Kg
+GjSY6Dlo7JUle3ah5mm5hRm9iYz+re026nO8/4Piy33B0s5Ks40FnotJk9/BW9Bu
+XvAuMC6C/Pq8tBcKSOWIm8Wba96wyrQD8Nr0kLhlZPdcTK3ofmZemde4wj7I0BOd
+re7kRXuJVfeKH2JShBKzwkCX44ofR5GmdFrS+LFjKBC4swm4VndAoiaYecb+3yXu
+PuWgf9RhD1FLPD+M2uFwdNjCaKH5wQzpoeJ/u1U8dgbuak7MkogwTZq9TwtImoS1
+mKPV+3PBV2HdKFZ1E66HjucMUQkQdYhMvI35ezzUIkgfKtzra7tEscszcTJGr61K
+8YzodDqs5xoic4DSMPclQsciOzsSrZYuxsN2B6ogtzVJV+mSSeh2FnIxZyuWfoqj
+x5RWIr9qS34BIbIjMt/kmkRtWVtd9QCgHJvGeJeNkP+byKq0rxFROV7Z+2et1VsR
+nTKaG73VululycslaVNVJ1zgyjbLiGH7HrfQy+4W+9OmTN6SpdTi3/UGVN4unUu0
+kzCqgc7dGtxRcw1PcOnlthYhGXmy5okLdWTK1au8CcEYof/UVKGFPP0UJAOyh9Ok
+twIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
+HQ4EFgQUu//KjiOfT5nK2+JopqUVJxce2Q4wDQYJKoZIhvcNAQEMBQADggIBALZp
+8KZ3/p7uC4Gt4cCpx/k1HUCCq+YEtN/L9x0Pg/B+E02NjO7jMyLDOfxA325BS0JT
+vhaI8dI4XsRomRyYUpOM52jtG2pzegVATX9lO9ZY8c6DR2Dj/5epnGB3GFW1fgiT
+z9D2PGcDFWEJ+YF59exTpJ/JjwGLc8R3dtyDovUMSRqodt6Sm2T4syzFJ9MHwAiA
+pJiS4wGWAqoC7o87xdFtCjMwc3i5T1QWvwsHoaRc5svJXISPD+AVdyx+Jn7axEvb
+pxZ3B7DNdehyQtaVhJ2Gg/LkkM0JR9SLA3DaWsYDQvTtN6LwG1BUSw7YhN4ZKJmB
+R64JGz9I0cNv4rBgF/XuIwKl2gBbbZCr7qLpGzvpx0QnRY5rn/WkhLx3+WuXrD5R
+RaIRpsyF7gpo8j5QOHokYh4XIDdtak23CZvJ/KRY9bb7nE4Yu5UC56GtmwfuNmsk
+0jmGwZODUNKBRqhfYlcsu2xkiAhu7xNUX90txGdj08+JN7+dIPT7eoOboB6BAFDC
+5AwiWVIQ7UNWhwD4FFKnHYuTjKJNRn8nxnGbJN7k2oaLDX5rIMHAnuFl2GqjpuiF
+izoHCBy69Y9Vmhh1fuXsgWbRIXOhNUQLgD1bnF5vKheW0YMjiGZt5obicDIvUiLn
+yOd/xCxgXS/Dr55FBcOEArf9LAhST4Ldo/DUhgkC
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R3 O=Google Trust Services LLC
+# Subject: CN=GTS Root R3 O=Google Trust Services LLC
+# Label: "GTS Root R3"
+# Serial: 146587176140553309517047991083707763997
+# MD5 Fingerprint: 1a:79:5b:6b:04:52:9c:5d:c7:74:33:1b:25:9a:f9:25
+# SHA1 Fingerprint: 30:d4:24:6f:07:ff:db:91:89:8a:0b:e9:49:66:11:eb:8c:5e:46:e5
+# SHA256 Fingerprint: 15:d5:b8:77:46:19:ea:7d:54:ce:1c:a6:d0:b0:c4:03:e0:37:a9:17:f1:31:e8:a0:4e:1e:6b:7a:71:ba:bc:e5
+-----BEGIN CERTIFICATE-----
+MIICDDCCAZGgAwIBAgIQbkepx2ypcyRAiQ8DVd2NHTAKBggqhkjOPQQDAzBHMQsw
+CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
+MBIGA1UEAxMLR1RTIFJvb3QgUjMwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
+MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
+Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjMwdjAQBgcqhkjOPQIBBgUrgQQA
+IgNiAAQfTzOHMymKoYTey8chWEGJ6ladK0uFxh1MJ7x/JlFyb+Kf1qPKzEUURout
+736GjOyxfi//qXGdGIRFBEFVbivqJn+7kAHjSxm65FSWRQmx1WyRRK2EE46ajA2A
+DDL24CejQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud
+DgQWBBTB8Sa6oC2uhYHP0/EqEr24Cmf9vDAKBggqhkjOPQQDAwNpADBmAjEAgFuk
+fCPAlaUs3L6JbyO5o91lAFJekazInXJ0glMLfalAvWhgxeG4VDvBNhcl2MG9AjEA
+njWSdIUlUfUk7GRSJFClH9voy8l27OyCbvWFGFPouOOaKaqW04MjyaR7YbPMAuhd
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R4 O=Google Trust Services LLC
+# Subject: CN=GTS Root R4 O=Google Trust Services LLC
+# Label: "GTS Root R4"
+# Serial: 146587176229350439916519468929765261721
+# MD5 Fingerprint: 5d:b6:6a:c4:60:17:24:6a:1a:99:a8:4b:ee:5e:b4:26
+# SHA1 Fingerprint: 2a:1d:60:27:d9:4a:b1:0a:1c:4d:91:5c:cd:33:a0:cb:3e:2d:54:cb
+# SHA256 Fingerprint: 71:cc:a5:39:1f:9e:79:4b:04:80:25:30:b3:63:e1:21:da:8a:30:43:bb:26:66:2f:ea:4d:ca:7f:c9:51:a4:bd
+-----BEGIN CERTIFICATE-----
+MIICCjCCAZGgAwIBAgIQbkepyIuUtui7OyrYorLBmTAKBggqhkjOPQQDAzBHMQsw
+CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
+MBIGA1UEAxMLR1RTIFJvb3QgUjQwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
+MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
+Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjQwdjAQBgcqhkjOPQIBBgUrgQQA
+IgNiAATzdHOnaItgrkO4NcWBMHtLSZ37wWHO5t5GvWvVYRg1rkDdc/eJkTBa6zzu
+hXyiQHY7qca4R9gq55KRanPpsXI5nymfopjTX15YhmUPoYRlBtHci8nHc8iMai/l
+xKvRHYqjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud
+DgQWBBSATNbrdP9JNqPV2Py1PsVq8JQdjDAKBggqhkjOPQQDAwNnADBkAjBqUFJ0
+CMRw3J5QdCHojXohw0+WbhXRIjVhLfoIN+4Zba3bssx9BzT1YBkstTTZbyACMANx
+sbqjYAuG7ZoIapVon+Kz4ZNkfF6Tpt95LY2F45TPI11xzPKwTdb+mciUqXWi4w==
+-----END CERTIFICATE-----
+
+# Issuer: CN=UCA Global G2 Root O=UniTrust
+# Subject: CN=UCA Global G2 Root O=UniTrust
+# Label: "UCA Global G2 Root"
+# Serial: 124779693093741543919145257850076631279
+# MD5 Fingerprint: 80:fe:f0:c4:4a:f0:5c:62:32:9f:1c:ba:78:a9:50:f8
+# SHA1 Fingerprint: 28:f9:78:16:19:7a:ff:18:25:18:aa:44:fe:c1:a0:ce:5c:b6:4c:8a
+# SHA256 Fingerprint: 9b:ea:11:c9:76:fe:01:47:64:c1:be:56:a6:f9:14:b5:a5:60:31:7a:bd:99:88:39:33:82:e5:16:1a:a0:49:3c
+-----BEGIN CERTIFICATE-----
+MIIFRjCCAy6gAwIBAgIQXd+x2lqj7V2+WmUgZQOQ7zANBgkqhkiG9w0BAQsFADA9
+MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxGzAZBgNVBAMMElVDQSBH
+bG9iYWwgRzIgUm9vdDAeFw0xNjAzMTEwMDAwMDBaFw00MDEyMzEwMDAwMDBaMD0x
+CzAJBgNVBAYTAkNOMREwDwYDVQQKDAhVbmlUcnVzdDEbMBkGA1UEAwwSVUNBIEds
+b2JhbCBHMiBSb290MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxeYr
+b3zvJgUno4Ek2m/LAfmZmqkywiKHYUGRO8vDaBsGxUypK8FnFyIdK+35KYmToni9
+kmugow2ifsqTs6bRjDXVdfkX9s9FxeV67HeToI8jrg4aA3++1NDtLnurRiNb/yzm
+VHqUwCoV8MmNsHo7JOHXaOIxPAYzRrZUEaalLyJUKlgNAQLx+hVRZ2zA+te2G3/R
+VogvGjqNO7uCEeBHANBSh6v7hn4PJGtAnTRnvI3HLYZveT6OqTwXS3+wmeOwcWDc
+C/Vkw85DvG1xudLeJ1uK6NjGruFZfc8oLTW4lVYa8bJYS7cSN8h8s+1LgOGN+jIj
+tm+3SJUIsUROhYw6AlQgL9+/V087OpAh18EmNVQg7Mc/R+zvWr9LesGtOxdQXGLY
+D0tK3Cv6brxzks3sx1DoQZbXqX5t2Okdj4q1uViSukqSKwxW/YDrCPBeKW4bHAyv
+j5OJrdu9o54hyokZ7N+1wxrrFv54NkzWbtA+FxyQF2smuvt6L78RHBgOLXMDj6Dl
+NaBa4kx1HXHhOThTeEDMg5PXCp6dW4+K5OXgSORIskfNTip1KnvyIvbJvgmRlld6
+iIis7nCs+dwp4wwcOxJORNanTrAmyPPZGpeRaOrvjUYG0lZFWJo8DA+DuAUlwznP
+O6Q0ibd5Ei9Hxeepl2n8pndntd978XplFeRhVmUCAwEAAaNCMEAwDgYDVR0PAQH/
+BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFIHEjMz15DD/pQwIX4wV
+ZyF0Ad/fMA0GCSqGSIb3DQEBCwUAA4ICAQATZSL1jiutROTL/7lo5sOASD0Ee/oj
+L3rtNtqyzm325p7lX1iPyzcyochltq44PTUbPrw7tgTQvPlJ9Zv3hcU2tsu8+Mg5
+1eRfB70VVJd0ysrtT7q6ZHafgbiERUlMjW+i67HM0cOU2kTC5uLqGOiiHycFutfl
+1qnN3e92mI0ADs0b+gO3joBYDic/UvuUospeZcnWhNq5NXHzJsBPd+aBJ9J3O5oU
+b3n09tDh05S60FdRvScFDcH9yBIw7m+NESsIndTUv4BFFJqIRNow6rSn4+7vW4LV
+PtateJLbXDzz2K36uGt/xDYotgIVilQsnLAXc47QN6MUPJiVAAwpBVueSUmxX8fj
+y88nZY41F7dXyDDZQVu5FLbowg+UMaeUmMxq67XhJ/UQqAHojhJi6IjMtX9Gl8Cb
+EGY4GjZGXyJoPd/JxhMnq1MGrKI8hgZlb7F+sSlEmqO6SWkoaY/X5V+tBIZkbxqg
+DMUIYs6Ao9Dz7GjevjPHF1t/gMRMTLGmhIrDO7gJzRSBuhjjVFc2/tsvfEehOjPI
++Vg7RE+xygKJBJYoaMVLuCaJu9YzL1DV/pqJuhgyklTGW+Cd+V7lDSKb9triyCGy
+YiGqhkCyLmTTX8jjfhFnRR8F/uOi77Oos/N9j/gMHyIfLXC0uAE0djAA5SN4p1bX
+UB+K+wb1whnw0A==
+-----END CERTIFICATE-----
+
+# Issuer: CN=UCA Extended Validation Root O=UniTrust
+# Subject: CN=UCA Extended Validation Root O=UniTrust
+# Label: "UCA Extended Validation Root"
+# Serial: 106100277556486529736699587978573607008
+# MD5 Fingerprint: a1:f3:5f:43:c6:34:9b:da:bf:8c:7e:05:53:ad:96:e2
+# SHA1 Fingerprint: a3:a1:b0:6f:24:61:23:4a:e3:36:a5:c2:37:fc:a6:ff:dd:f0:d7:3a
+# SHA256 Fingerprint: d4:3a:f9:b3:54:73:75:5c:96:84:fc:06:d7:d8:cb:70:ee:5c:28:e7:73:fb:29:4e:b4:1e:e7:17:22:92:4d:24
+-----BEGIN CERTIFICATE-----
+MIIFWjCCA0KgAwIBAgIQT9Irj/VkyDOeTzRYZiNwYDANBgkqhkiG9w0BAQsFADBH
+MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNVBAMMHFVDQSBF
+eHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwHhcNMTUwMzEzMDAwMDAwWhcNMzgxMjMx
+MDAwMDAwWjBHMQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNV
+BAMMHFVDQSBFeHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQCpCQcoEwKwmeBkqh5DFnpzsZGgdT6o+uM4AHrsiWog
+D4vFsJszA1qGxliG1cGFu0/GnEBNyr7uaZa4rYEwmnySBesFK5pI0Lh2PpbIILvS
+sPGP2KxFRv+qZ2C0d35qHzwaUnoEPQc8hQ2E0B92CvdqFN9y4zR8V05WAT558aop
+O2z6+I9tTcg1367r3CTueUWnhbYFiN6IXSV8l2RnCdm/WhUFhvMJHuxYMjMR83dk
+sHYf5BA1FxvyDrFspCqjc/wJHx4yGVMR59mzLC52LqGj3n5qiAno8geK+LLNEOfi
+c0CTuwjRP+H8C5SzJe98ptfRr5//lpr1kXuYC3fUfugH0mK1lTnj8/FtDw5lhIpj
+VMWAtuCeS31HJqcBCF3RiJ7XwzJE+oJKCmhUfzhTA8ykADNkUVkLo4KRel7sFsLz
+KuZi2irbWWIQJUoqgQtHB0MGcIfS+pMRKXpITeuUx3BNr2fVUbGAIAEBtHoIppB/
+TuDvB0GHr2qlXov7z1CymlSvw4m6WC31MJixNnI5fkkE/SmnTHnkBVfblLkWU41G
+sx2VYVdWf6/wFlthWG82UBEL2KwrlRYaDh8IzTY0ZRBiZtWAXxQgXy0MoHgKaNYs
+1+lvK9JKBZP8nm9rZ/+I8U6laUpSNwXqxhaN0sSZ0YIrO7o1dfdRUVjzyAfd5LQD
+fwIDAQABo0IwQDAdBgNVHQ4EFgQU2XQ65DA9DfcS3H5aBZ8eNJr34RQwDwYDVR0T
+AQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQADggIBADaN
+l8xCFWQpN5smLNb7rhVpLGsaGvdftvkHTFnq88nIua7Mui563MD1sC3AO6+fcAUR
+ap8lTwEpcOPlDOHqWnzcSbvBHiqB9RZLcpHIojG5qtr8nR/zXUACE/xOHAbKsxSQ
+VBcZEhrxH9cMaVr2cXj0lH2RC47skFSOvG+hTKv8dGT9cZr4QQehzZHkPJrgmzI5
+c6sq1WnIeJEmMX3ixzDx/BR4dxIOE/TdFpS/S2d7cFOFyrC78zhNLJA5wA3CXWvp
+4uXViI3WLL+rG761KIcSF3Ru/H38j9CHJrAb+7lsq+KePRXBOy5nAliRn+/4Qh8s
+t2j1da3Ptfb/EX3C8CSlrdP6oDyp+l3cpaDvRKS+1ujl5BOWF3sGPjLtx7dCvHaj
+2GU4Kzg1USEODm8uNBNA4StnDG1KQTAYI1oyVZnJF+A83vbsea0rWBmirSwiGpWO
+vpaQXUJXxPkUAzUrHC1RVwinOt4/5Mi0A3PCwSaAuwtCH60NryZy2sy+s6ODWA2C
+xR9GUeOcGMyNm43sSet1UNWMKFnKdDTajAshqx7qG+XH/RU+wBeq+yNuJkbL+vmx
+cmtpzyKEC2IPrNkZAJSidjzULZrtBJ4tBmIQN1IchXIbJ+XMxjHsN+xjWZsLHXbM
+fjKaiJUINlK73nZfdklJrX+9ZSCyycErdhh2n1ax
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036
+# Subject: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036
+# Label: "Certigna Root CA"
+# Serial: 269714418870597844693661054334862075617
+# MD5 Fingerprint: 0e:5c:30:62:27:eb:5b:bc:d7:ae:62:ba:e9:d5:df:77
+# SHA1 Fingerprint: 2d:0d:52:14:ff:9e:ad:99:24:01:74:20:47:6e:6c:85:27:27:f5:43
+# SHA256 Fingerprint: d4:8d:3d:23:ee:db:50:a4:59:e5:51:97:60:1c:27:77:4b:9d:7b:18:c9:4d:5a:05:95:11:a1:02:50:b9:31:68
+-----BEGIN CERTIFICATE-----
+MIIGWzCCBEOgAwIBAgIRAMrpG4nxVQMNo+ZBbcTjpuEwDQYJKoZIhvcNAQELBQAw
+WjELMAkGA1UEBhMCRlIxEjAQBgNVBAoMCURoaW15b3RpczEcMBoGA1UECwwTMDAw
+MiA0ODE0NjMwODEwMDAzNjEZMBcGA1UEAwwQQ2VydGlnbmEgUm9vdCBDQTAeFw0x
+MzEwMDEwODMyMjdaFw0zMzEwMDEwODMyMjdaMFoxCzAJBgNVBAYTAkZSMRIwEAYD
+VQQKDAlEaGlteW90aXMxHDAaBgNVBAsMEzAwMDIgNDgxNDYzMDgxMDAwMzYxGTAX
+BgNVBAMMEENlcnRpZ25hIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAw
+ggIKAoICAQDNGDllGlmx6mQWDoyUJJV8g9PFOSbcDO8WV43X2KyjQn+Cyu3NW9sO
+ty3tRQgXstmzy9YXUnIo245Onoq2C/mehJpNdt4iKVzSs9IGPjA5qXSjklYcoW9M
+CiBtnyN6tMbaLOQdLNyzKNAT8kxOAkmhVECe5uUFoC2EyP+YbNDrihqECB63aCPu
+I9Vwzm1RaRDuoXrC0SIxwoKF0vJVdlB8JXrJhFwLrN1CTivngqIkicuQstDuI7pm
+TLtipPlTWmR7fJj6o0ieD5Wupxj0auwuA0Wv8HT4Ks16XdG+RCYyKfHx9WzMfgIh
+C59vpD++nVPiz32pLHxYGpfhPTc3GGYo0kDFUYqMwy3OU4gkWGQwFsWq4NYKpkDf
+ePb1BHxpE4S80dGnBs8B92jAqFe7OmGtBIyT46388NtEbVncSVmurJqZNjBBe3Yz
+IoejwpKGbvlw7q6Hh5UbxHq9MfPU0uWZ/75I7HX1eBYdpnDBfzwboZL7z8g81sWT
+Co/1VTp2lc5ZmIoJlXcymoO6LAQ6l73UL77XbJuiyn1tJslV1c/DeVIICZkHJC1k
+JWumIWmbat10TWuXekG9qxf5kBdIjzb5LdXF2+6qhUVB+s06RbFo5jZMm5BX7CO5
+hwjCxAnxl4YqKE3idMDaxIzb3+KhF1nOJFl0Mdp//TBt2dzhauH8XwIDAQABo4IB
+GjCCARYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE
+FBiHVuBud+4kNTxOc5of1uHieX4rMB8GA1UdIwQYMBaAFBiHVuBud+4kNTxOc5of
+1uHieX4rMEQGA1UdIAQ9MDswOQYEVR0gADAxMC8GCCsGAQUFBwIBFiNodHRwczov
+L3d3d3cuY2VydGlnbmEuZnIvYXV0b3JpdGVzLzBtBgNVHR8EZjBkMC+gLaArhilo
+dHRwOi8vY3JsLmNlcnRpZ25hLmZyL2NlcnRpZ25hcm9vdGNhLmNybDAxoC+gLYYr
+aHR0cDovL2NybC5kaGlteW90aXMuY29tL2NlcnRpZ25hcm9vdGNhLmNybDANBgkq
+hkiG9w0BAQsFAAOCAgEAlLieT/DjlQgi581oQfccVdV8AOItOoldaDgvUSILSo3L
+6btdPrtcPbEo/uRTVRPPoZAbAh1fZkYJMyjhDSSXcNMQH+pkV5a7XdrnxIxPTGRG
+HVyH41neQtGbqH6mid2PHMkwgu07nM3A6RngatgCdTer9zQoKJHyBApPNeNgJgH6
+0BGM+RFq7q89w1DTj18zeTyGqHNFkIwgtnJzFyO+B2XleJINugHA64wcZr+shncB
+lA2c5uk5jR+mUYyZDDl34bSb+hxnV29qao6pK0xXeXpXIs/NX2NGjVxZOob4Mkdi
+o2cNGJHc+6Zr9UhhcyNZjgKnvETq9Emd8VRY+WCv2hikLyhF3HqgiIZd8zvn/yk1
+gPxkQ5Tm4xxvvq0OKmOZK8l+hfZx6AYDlf7ej0gcWtSS6Cvu5zHbugRqh5jnxV/v
+faci9wHYTfmJ0A6aBVmknpjZbyvKcL5kwlWj9Omvw5Ip3IgWJJk8jSaYtlu3zM63
+Nwf9JtmYhST/WSMDmu2dnajkXjjO11INb9I/bbEFa0nOipFGc/T2L/Coc3cOZayh
+jWZSaX5LaAzHHjcng6WMxwLkFM1JAbBzs/3GkDpv0mztO+7skb6iQ12LAEpmJURw
+3kAP+HwV96LOPNdeE4yBFxgX0b3xdxA61GU5wSesVywlVP+i2k+KYTlerj1KjL0=
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI
+# Subject: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI
+# Label: "emSign Root CA - G1"
+# Serial: 235931866688319308814040
+# MD5 Fingerprint: 9c:42:84:57:dd:cb:0b:a7:2e:95:ad:b6:f3:da:bc:ac
+# SHA1 Fingerprint: 8a:c7:ad:8f:73:ac:4e:c1:b5:75:4d:a5:40:f4:fc:cf:7c:b5:8e:8c
+# SHA256 Fingerprint: 40:f6:af:03:46:a9:9a:a1:cd:1d:55:5a:4e:9c:ce:62:c7:f9:63:46:03:ee:40:66:15:83:3d:c8:c8:d0:03:67
+-----BEGIN CERTIFICATE-----
+MIIDlDCCAnygAwIBAgIKMfXkYgxsWO3W2DANBgkqhkiG9w0BAQsFADBnMQswCQYD
+VQQGEwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBU
+ZWNobm9sb2dpZXMgTGltaXRlZDEcMBoGA1UEAxMTZW1TaWduIFJvb3QgQ0EgLSBH
+MTAeFw0xODAyMTgxODMwMDBaFw00MzAyMTgxODMwMDBaMGcxCzAJBgNVBAYTAklO
+MRMwEQYDVQQLEwplbVNpZ24gUEtJMSUwIwYDVQQKExxlTXVkaHJhIFRlY2hub2xv
+Z2llcyBMaW1pdGVkMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEcxMIIBIjAN
+BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAk0u76WaK7p1b1TST0Bsew+eeuGQz
+f2N4aLTNLnF115sgxk0pvLZoYIr3IZpWNVrzdr3YzZr/k1ZLpVkGoZM0Kd0WNHVO
+8oG0x5ZOrRkVUkr+PHB1cM2vK6sVmjM8qrOLqs1D/fXqcP/tzxE7lM5OMhbTI0Aq
+d7OvPAEsbO2ZLIvZTmmYsvePQbAyeGHWDV/D+qJAkh1cF+ZwPjXnorfCYuKrpDhM
+tTk1b+oDafo6VGiFbdbyL0NVHpENDtjVaqSW0RM8LHhQ6DqS0hdW5TUaQBw+jSzt
+Od9C4INBdN+jzcKGYEho42kLVACL5HZpIQ15TjQIXhTCzLG3rdd8cIrHhQIDAQAB
+o0IwQDAdBgNVHQ4EFgQU++8Nhp6w492pufEhF38+/PB3KxowDgYDVR0PAQH/BAQD
+AgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAFn/8oz1h31x
+PaOfG1vR2vjTnGs2vZupYeveFix0PZ7mddrXuqe8QhfnPZHr5X3dPpzxz5KsbEjM
+wiI/aTvFthUvozXGaCocV685743QNcMYDHsAVhzNixl03r4PEuDQqqE/AjSxcM6d
+GNYIAwlG7mDgfrbESQRRfXBgvKqy/3lyeqYdPV8q+Mri/Tm3R7nrft8EI6/6nAYH
+6ftjk4BAtcZsCjEozgyfz7MjNYBBjWzEN3uBL4ChQEKF6dk4jeihU80Bv2noWgby
+RQuQ+q7hv53yrlc8pa6yVvSLZUDp/TGBLPQ5Cdjua6e0ph0VpZj3AYHYhX3zUVxx
+iN66zB+Afko=
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI
+# Subject: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI
+# Label: "emSign ECC Root CA - G3"
+# Serial: 287880440101571086945156
+# MD5 Fingerprint: ce:0b:72:d1:9f:88:8e:d0:50:03:e8:e3:b8:8b:67:40
+# SHA1 Fingerprint: 30:43:fa:4f:f2:57:dc:a0:c3:80:ee:2e:58:ea:78:b2:3f:e6:bb:c1
+# SHA256 Fingerprint: 86:a1:ec:ba:08:9c:4a:8d:3b:be:27:34:c6:12:ba:34:1d:81:3e:04:3c:f9:e8:a8:62:cd:5c:57:a3:6b:be:6b
+-----BEGIN CERTIFICATE-----
+MIICTjCCAdOgAwIBAgIKPPYHqWhwDtqLhDAKBggqhkjOPQQDAzBrMQswCQYDVQQG
+EwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNo
+bm9sb2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0g
+RzMwHhcNMTgwMjE4MTgzMDAwWhcNNDMwMjE4MTgzMDAwWjBrMQswCQYDVQQGEwJJ
+TjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9s
+b2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0gRzMw
+djAQBgcqhkjOPQIBBgUrgQQAIgNiAAQjpQy4LRL1KPOxst3iAhKAnjlfSU2fySU0
+WXTsuwYc58Byr+iuL+FBVIcUqEqy6HyC5ltqtdyzdc6LBtCGI79G1Y4PPwT01xyS
+fvalY8L1X44uT6EYGQIrMgqCZH0Wk9GjQjBAMB0GA1UdDgQWBBR8XQKEE9TMipuB
+zhccLikenEhjQjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggq
+hkjOPQQDAwNpADBmAjEAvvNhzwIQHWSVB7gYboiFBS+DCBeQyh+KTOgNG3qxrdWB
+CUfvO6wIBHxcmbHtRwfSAjEAnbpV/KlK6O3t5nYBQnvI+GDZjVGLVTv7jHvrZQnD
++JbNR6iC8hZVdyR+EhCVBCyj
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
+# Subject: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
+# Label: "emSign Root CA - C1"
+# Serial: 825510296613316004955058
+# MD5 Fingerprint: d8:e3:5d:01:21:fa:78:5a:b0:df:ba:d2:ee:2a:5f:68
+# SHA1 Fingerprint: e7:2e:f1:df:fc:b2:09:28:cf:5d:d4:d5:67:37:b1:51:cb:86:4f:01
+# SHA256 Fingerprint: 12:56:09:aa:30:1d:a0:a2:49:b9:7a:82:39:cb:6a:34:21:6f:44:dc:ac:9f:39:54:b1:42:92:f2:e8:c8:60:8f
+-----BEGIN CERTIFICATE-----
+MIIDczCCAlugAwIBAgILAK7PALrEzzL4Q7IwDQYJKoZIhvcNAQELBQAwVjELMAkG
+A1UEBhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEg
+SW5jMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEMxMB4XDTE4MDIxODE4MzAw
+MFoXDTQzMDIxODE4MzAwMFowVjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln
+biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQDExNlbVNpZ24gUm9v
+dCBDQSAtIEMxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz+upufGZ
+BczYKCFK83M0UYRWEPWgTywS4/oTmifQz/l5GnRfHXk5/Fv4cI7gklL35CX5VIPZ
+HdPIWoU/Xse2B+4+wM6ar6xWQio5JXDWv7V7Nq2s9nPczdcdioOl+yuQFTdrHCZH
+3DspVpNqs8FqOp099cGXOFgFixwR4+S0uF2FHYP+eF8LRWgYSKVGczQ7/g/IdrvH
+GPMF0Ybzhe3nudkyrVWIzqa2kbBPrH4VI5b2P/AgNBbeCsbEBEV5f6f9vtKppa+c
+xSMq9zwhbL2vj07FOrLzNBL834AaSaTUqZX3noleoomslMuoaJuvimUnzYnu3Yy1
+aylwQ6BpC+S5DwIDAQABo0IwQDAdBgNVHQ4EFgQU/qHgcB4qAzlSWkK+XJGFehiq
+TbUwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL
+BQADggEBAMJKVvoVIXsoounlHfv4LcQ5lkFMOycsxGwYFYDGrK9HWS8mC+M2sO87
+/kOXSTKZEhVb3xEp/6tT+LvBeA+snFOvV71ojD1pM/CjoCNjO2RnIkSt1XHLVip4
+kqNPEjE2NuLe/gDEo2APJ62gsIq1NnpSob0n9CAnYuhNlCQT5AoE6TyrLshDCUrG
+YQTlSTR+08TI9Q/Aqum6VF7zYytPT1DU/rl7mYw9wC68AivTxEDkigcxHpvOJpkT
++xHqmiIMERnHXhuBUDDIlhJu58tBf5E7oke3VIAb3ADMmpDqw8NQBmIMMMAVSKeo
+WXzhriKi4gp6D/piq1JM4fHfyr6DDUI=
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI
+# Subject: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI
+# Label: "emSign ECC Root CA - C3"
+# Serial: 582948710642506000014504
+# MD5 Fingerprint: 3e:53:b3:a3:81:ee:d7:10:f8:d3:b0:1d:17:92:f5:d5
+# SHA1 Fingerprint: b6:af:43:c2:9b:81:53:7d:f6:ef:6b:c3:1f:1f:60:15:0c:ee:48:66
+# SHA256 Fingerprint: bc:4d:80:9b:15:18:9d:78:db:3e:1d:8c:f4:f9:72:6a:79:5d:a1:64:3c:a5:f1:35:8e:1d:db:0e:dc:0d:7e:b3
+-----BEGIN CERTIFICATE-----
+MIICKzCCAbGgAwIBAgIKe3G2gla4EnycqDAKBggqhkjOPQQDAzBaMQswCQYDVQQG
+EwJVUzETMBEGA1UECxMKZW1TaWduIFBLSTEUMBIGA1UEChMLZU11ZGhyYSBJbmMx
+IDAeBgNVBAMTF2VtU2lnbiBFQ0MgUm9vdCBDQSAtIEMzMB4XDTE4MDIxODE4MzAw
+MFoXDTQzMDIxODE4MzAwMFowWjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln
+biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMSAwHgYDVQQDExdlbVNpZ24gRUND
+IFJvb3QgQ0EgLSBDMzB2MBAGByqGSM49AgEGBSuBBAAiA2IABP2lYa57JhAd6bci
+MK4G9IGzsUJxlTm801Ljr6/58pc1kjZGDoeVjbk5Wum739D+yAdBPLtVb4Ojavti
+sIGJAnB9SMVK4+kiVCJNk7tCDK93nCOmfddhEc5lx/h//vXyqaNCMEAwHQYDVR0O
+BBYEFPtaSNCAIEDyqOkAB2kZd6fmw/TPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMB
+Af8EBTADAQH/MAoGCCqGSM49BAMDA2gAMGUCMQC02C8Cif22TGK6Q04ThHK1rt0c
+3ta13FaPWEBaLd4gTCKDypOofu4SQMfWh0/434UCMBwUZOR8loMRnLDRWmFLpg9J
+0wD8ofzkpf9/rdcw0Md3f76BB1UwUCAU9Vc4CqgxUQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hongkong Post Root CA 3 O=Hongkong Post
+# Subject: CN=Hongkong Post Root CA 3 O=Hongkong Post
+# Label: "Hongkong Post Root CA 3"
+# Serial: 46170865288971385588281144162979347873371282084
+# MD5 Fingerprint: 11:fc:9f:bd:73:30:02:8a:fd:3f:f3:58:b9:cb:20:f0
+# SHA1 Fingerprint: 58:a2:d0:ec:20:52:81:5b:c1:f3:f8:64:02:24:4e:c2:8e:02:4b:02
+# SHA256 Fingerprint: 5a:2f:c0:3f:0c:83:b0:90:bb:fa:40:60:4b:09:88:44:6c:76:36:18:3d:f9:84:6e:17:10:1a:44:7f:b8:ef:d6
+-----BEGIN CERTIFICATE-----
+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
+mpv0
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only
+# Subject: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only
+# Label: "Entrust Root Certification Authority - G4"
+# Serial: 289383649854506086828220374796556676440
+# MD5 Fingerprint: 89:53:f1:83:23:b7:7c:8e:05:f1:8c:71:38:4e:1f:88
+# SHA1 Fingerprint: 14:88:4e:86:26:37:b0:26:af:59:62:5c:40:77:ec:35:29:ba:96:01
+# SHA256 Fingerprint: db:35:17:d1:f6:73:2a:2d:5a:b9:7c:53:3e:c7:07:79:ee:32:70:a6:2f:b4:ac:42:38:37:24:60:e6:f0:1e:88
+-----BEGIN CERTIFICATE-----
+MIIGSzCCBDOgAwIBAgIRANm1Q3+vqTkPAAAAAFVlrVgwDQYJKoZIhvcNAQELBQAw
+gb4xCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQL
+Ex9TZWUgd3d3LmVudHJ1c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykg
+MjAxNSBFbnRydXN0LCBJbmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAw
+BgNVBAMTKUVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0
+MB4XDTE1MDUyNzExMTExNloXDTM3MTIyNzExNDExNlowgb4xCzAJBgNVBAYTAlVT
+MRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1
+c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxNSBFbnRydXN0LCBJ
+bmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAwBgNVBAMTKUVudHJ1c3Qg
+Um9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0MIICIjANBgkqhkiG9w0B
+AQEFAAOCAg8AMIICCgKCAgEAsewsQu7i0TD/pZJH4i3DumSXbcr3DbVZwbPLqGgZ
+2K+EbTBwXX7zLtJTmeH+H17ZSK9dE43b/2MzTdMAArzE+NEGCJR5WIoV3imz/f3E
+T+iq4qA7ec2/a0My3dl0ELn39GjUu9CH1apLiipvKgS1sqbHoHrmSKvS0VnM1n4j
+5pds8ELl3FFLFUHtSUrJ3hCX1nbB76W1NhSXNdh4IjVS70O92yfbYVaCNNzLiGAM
+C1rlLAHGVK/XqsEQe9IFWrhAnoanw5CGAlZSCXqc0ieCU0plUmr1POeo8pyvi73T
+DtTUXm6Hnmo9RR3RXRv06QqsYJn7ibT/mCzPfB3pAqoEmh643IhuJbNsZvc8kPNX
+wbMv9W3y+8qh+CmdRouzavbmZwe+LGcKKh9asj5XxNMhIWNlUpEbsZmOeX7m640A
+2Vqq6nPopIICR5b+W45UYaPrL0swsIsjdXJ8ITzI9vF01Bx7owVV7rtNOzK+mndm
+nqxpkCIHH2E6lr7lmk/MBTwoWdPBDFSoWWG9yHJM6Nyfh3+9nEg2XpWjDrk4JFX8
+dWbrAuMINClKxuMrLzOg2qOGpRKX/YAr2hRC45K9PvJdXmd0LhyIRyk0X+IyqJwl
+N4y6mACXi0mWHv0liqzc2thddG5msP9E36EYxr5ILzeUePiVSj9/E15dWf10hkNj
+c0kCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYD
+VR0OBBYEFJ84xFYjwznooHFs6FRM5Og6sb9nMA0GCSqGSIb3DQEBCwUAA4ICAQAS
+5UKme4sPDORGpbZgQIeMJX6tuGguW8ZAdjwD+MlZ9POrYs4QjbRaZIxowLByQzTS
+Gwv2LFPSypBLhmb8qoMi9IsabyZIrHZ3CL/FmFz0Jomee8O5ZDIBf9PD3Vht7LGr
+hFV0d4QEJ1JrhkzO3bll/9bGXp+aEJlLdWr+aumXIOTkdnrG0CSqkM0gkLpHZPt/
+B7NTeLUKYvJzQ85BK4FqLoUWlFPUa19yIqtRLULVAJyZv967lDtX/Zr1hstWO1uI
+AeV8KEsD+UmDfLJ/fOPtjqF/YFOOVZ1QNBIPt5d7bIdKROf1beyAN/BYGW5KaHbw
+H5Lk6rWS02FREAutp9lfx1/cH6NcjKF+m7ee01ZvZl4HliDtC3T7Zk6LERXpgUl+
+b7DUUH8i119lAg2m9IUe2K4GS0qn0jFmwvjO5QimpAKWRGhXxNUzzxkvFMSUHHuk
+2fCfDrGA4tGeEWSpiBE6doLlYsKA2KSD7ZPvfC+QsDJMlhVoSFLUmQjAJOgc47Ol
+IQ6SwJAfzyBfyjs4x7dtOvPmRLgOMWuIjnDrnBdSqEGULoe256YSxXXfW8AKbnuk
+5F6G+TaU33fD6Q3AOfF5u0aOq0NZJ7cguyPpVkAh7DE9ZapD8j3fcEThuk0mEDuY
+n/PIjhs4ViFqUZPTkcpG2om3PVODLAgfi49T3f+sHw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Microsoft ECC Root Certificate Authority 2017 O=Microsoft Corporation
+# Subject: CN=Microsoft ECC Root Certificate Authority 2017 O=Microsoft Corporation
+# Label: "Microsoft ECC Root Certificate Authority 2017"
+# Serial: 136839042543790627607696632466672567020
+# MD5 Fingerprint: dd:a1:03:e6:4a:93:10:d1:bf:f0:19:42:cb:fe:ed:67
+# SHA1 Fingerprint: 99:9a:64:c3:7f:f4:7d:9f:ab:95:f1:47:69:89:14:60:ee:c4:c3:c5
+# SHA256 Fingerprint: 35:8d:f3:9d:76:4a:f9:e1:b7:66:e9:c9:72:df:35:2e:e1:5c:fa:c2:27:af:6a:d1:d7:0e:8e:4a:6e:dc:ba:02
+-----BEGIN CERTIFICATE-----
+MIICWTCCAd+gAwIBAgIQZvI9r4fei7FK6gxXMQHC7DAKBggqhkjOPQQDAzBlMQsw
+CQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYD
+VQQDEy1NaWNyb3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIw
+MTcwHhcNMTkxMjE4MjMwNjQ1WhcNNDIwNzE4MjMxNjA0WjBlMQswCQYDVQQGEwJV
+UzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1NaWNy
+b3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwdjAQBgcq
+hkjOPQIBBgUrgQQAIgNiAATUvD0CQnVBEyPNgASGAlEvaqiBYgtlzPbKnR5vSmZR
+ogPZnZH6thaxjG7efM3beaYvzrvOcS/lpaso7GMEZpn4+vKTEAXhgShC48Zo9OYb
+hGBKia/teQ87zvH2RPUBeMCjVDBSMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8E
+BTADAQH/MB0GA1UdDgQWBBTIy5lycFIM+Oa+sgRXKSrPQhDtNTAQBgkrBgEEAYI3
+FQEEAwIBADAKBggqhkjOPQQDAwNoADBlAjBY8k3qDPlfXu5gKcs68tvWMoQZP3zV
+L8KxzJOuULsJMsbG7X7JNpQS5GiFBqIb0C8CMQCZ6Ra0DvpWSNSkMBaReNtUjGUB
+iudQZsIxtzm6uBoiB078a1QWIP8rtedMDE2mT3M=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Microsoft RSA Root Certificate Authority 2017 O=Microsoft Corporation
+# Subject: CN=Microsoft RSA Root Certificate Authority 2017 O=Microsoft Corporation
+# Label: "Microsoft RSA Root Certificate Authority 2017"
+# Serial: 40975477897264996090493496164228220339
+# MD5 Fingerprint: 10:ff:00:ff:cf:c9:f8:c7:7a:c0:ee:35:8e:c9:0f:47
+# SHA1 Fingerprint: 73:a5:e6:4a:3b:ff:83:16:ff:0e:dc:cc:61:8a:90:6e:4e:ae:4d:74
+# SHA256 Fingerprint: c7:41:f7:0f:4b:2a:8d:88:bf:2e:71:c1:41:22:ef:53:ef:10:eb:a0:cf:a5:e6:4c:fa:20:f4:18:85:30:73:e0
+-----BEGIN CERTIFICATE-----
+MIIFqDCCA5CgAwIBAgIQHtOXCV/YtLNHcB6qvn9FszANBgkqhkiG9w0BAQwFADBl
+MQswCQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYw
+NAYDVQQDEy1NaWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5
+IDIwMTcwHhcNMTkxMjE4MjI1MTIyWhcNNDIwNzE4MjMwMDIzWjBlMQswCQYDVQQG
+EwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1N
+aWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwggIi
+MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKW76UM4wplZEWCpW9R2LBifOZ
+Nt9GkMml7Xhqb0eRaPgnZ1AzHaGm++DlQ6OEAlcBXZxIQIJTELy/xztokLaCLeX0
+ZdDMbRnMlfl7rEqUrQ7eS0MdhweSE5CAg2Q1OQT85elss7YfUJQ4ZVBcF0a5toW1
+HLUX6NZFndiyJrDKxHBKrmCk3bPZ7Pw71VdyvD/IybLeS2v4I2wDwAW9lcfNcztm
+gGTjGqwu+UcF8ga2m3P1eDNbx6H7JyqhtJqRjJHTOoI+dkC0zVJhUXAoP8XFWvLJ
+jEm7FFtNyP9nTUwSlq31/niol4fX/V4ggNyhSyL71Imtus5Hl0dVe49FyGcohJUc
+aDDv70ngNXtk55iwlNpNhTs+VcQor1fznhPbRiefHqJeRIOkpcrVE7NLP8TjwuaG
+YaRSMLl6IE9vDzhTyzMMEyuP1pq9KsgtsRx9S1HKR9FIJ3Jdh+vVReZIZZ2vUpC6
+W6IYZVcSn2i51BVrlMRpIpj0M+Dt+VGOQVDJNE92kKz8OMHY4Xu54+OU4UZpyw4K
+UGsTuqwPN1q3ErWQgR5WrlcihtnJ0tHXUeOrO8ZV/R4O03QK0dqq6mm4lyiPSMQH
++FJDOvTKVTUssKZqwJz58oHhEmrARdlns87/I6KJClTUFLkqqNfs+avNJVgyeY+Q
+W5g5xAgGwax/Dj0ApQIDAQABo1QwUjAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/
+BAUwAwEB/zAdBgNVHQ4EFgQUCctZf4aycI8awznjwNnpv7tNsiMwEAYJKwYBBAGC
+NxUBBAMCAQAwDQYJKoZIhvcNAQEMBQADggIBAKyvPl3CEZaJjqPnktaXFbgToqZC
+LgLNFgVZJ8og6Lq46BrsTaiXVq5lQ7GPAJtSzVXNUzltYkyLDVt8LkS/gxCP81OC
+gMNPOsduET/m4xaRhPtthH80dK2Jp86519efhGSSvpWhrQlTM93uCupKUY5vVau6
+tZRGrox/2KJQJWVggEbbMwSubLWYdFQl3JPk+ONVFT24bcMKpBLBaYVu32TxU5nh
+SnUgnZUP5NbcA/FZGOhHibJXWpS2qdgXKxdJ5XbLwVaZOjex/2kskZGT4d9Mozd2
+TaGf+G0eHdP67Pv0RR0Tbc/3WeUiJ3IrhvNXuzDtJE3cfVa7o7P4NHmJweDyAmH3
+pvwPuxwXC65B2Xy9J6P9LjrRk5Sxcx0ki69bIImtt2dmefU6xqaWM/5TkshGsRGR
+xpl/j8nWZjEgQRCHLQzWwa80mMpkg/sTV9HB8Dx6jKXB/ZUhoHHBk2dxEuqPiApp
+GWSZI1b7rCoucL5mxAyE7+WL85MB+GqQk2dLsmijtWKP6T+MejteD+eMuMZ87zf9
+dOLITzNy4ZQ5bb0Sr74MTnB8G2+NszKTc0QWbej09+CVgI+WXTik9KveCjCHk9hN
+AHFiRSdLOkKEW39lt2c0Ui2cFmuqqNh7o0JMcccMyj6D5KbvtwEwXlGjefVwaaZB
+RA+GsCyRxj3qrg+E
+-----END CERTIFICATE-----
+
+# Issuer: CN=e-Szigno Root CA 2017 O=Microsec Ltd.
+# Subject: CN=e-Szigno Root CA 2017 O=Microsec Ltd.
+# Label: "e-Szigno Root CA 2017"
+# Serial: 411379200276854331539784714
+# MD5 Fingerprint: de:1f:f6:9e:84:ae:a7:b4:21:ce:1e:58:7d:d1:84:98
+# SHA1 Fingerprint: 89:d4:83:03:4f:9e:9a:48:80:5f:72:37:d4:a9:a6:ef:cb:7c:1f:d1
+# SHA256 Fingerprint: be:b0:0b:30:83:9b:9b:c3:2c:32:e4:44:79:05:95:06:41:f2:64:21:b1:5e:d0:89:19:8b:51:8a:e2:ea:1b:99
+-----BEGIN CERTIFICATE-----
+MIICQDCCAeWgAwIBAgIMAVRI7yH9l1kN9QQKMAoGCCqGSM49BAMCMHExCzAJBgNV
+BAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMgTHRk
+LjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25vIFJv
+b3QgQ0EgMjAxNzAeFw0xNzA4MjIxMjA3MDZaFw00MjA4MjIxMjA3MDZaMHExCzAJ
+BgNVBAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMg
+THRkLjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25v
+IFJvb3QgQ0EgMjAxNzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABJbcPYrYsHtv
+xie+RJCxs1YVe45DJH0ahFnuY2iyxl6H0BVIHqiQrb1TotreOpCmYF9oMrWGQd+H
+Wyx7xf58etqjYzBhMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G
+A1UdDgQWBBSHERUI0arBeAyxr87GyZDvvzAEwDAfBgNVHSMEGDAWgBSHERUI0arB
+eAyxr87GyZDvvzAEwDAKBggqhkjOPQQDAgNJADBGAiEAtVfd14pVCzbhhkT61Nlo
+jbjcI4qKDdQvfepz7L9NbKgCIQDLpbQS+ue16M9+k/zzNY9vTlp8tLxOsvxyqltZ
++efcMQ==
+-----END CERTIFICATE-----
+
+# Issuer: O=CERTSIGN SA OU=certSIGN ROOT CA G2
+# Subject: O=CERTSIGN SA OU=certSIGN ROOT CA G2
+# Label: "certSIGN Root CA G2"
+# Serial: 313609486401300475190
+# MD5 Fingerprint: 8c:f1:75:8a:c6:19:cf:94:b7:f7:65:20:87:c3:97:c7
+# SHA1 Fingerprint: 26:f9:93:b4:ed:3d:28:27:b0:b9:4b:a7:e9:15:1d:a3:8d:92:e5:32
+# SHA256 Fingerprint: 65:7c:fe:2f:a7:3f:aa:38:46:25:71:f3:32:a2:36:3a:46:fc:e7:02:09:51:71:07:02:cd:fb:b6:ee:da:33:05
+-----BEGIN CERTIFICATE-----
+MIIFRzCCAy+gAwIBAgIJEQA0tk7GNi02MA0GCSqGSIb3DQEBCwUAMEExCzAJBgNV
+BAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJR04g
+Uk9PVCBDQSBHMjAeFw0xNzAyMDYwOTI3MzVaFw00MjAyMDYwOTI3MzVaMEExCzAJ
+BgNVBAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJ
+R04gUk9PVCBDQSBHMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMDF
+dRmRfUR0dIf+DjuW3NgBFszuY5HnC2/OOwppGnzC46+CjobXXo9X69MhWf05N0Iw
+vlDqtg+piNguLWkh59E3GE59kdUWX2tbAMI5Qw02hVK5U2UPHULlj88F0+7cDBrZ
+uIt4ImfkabBoxTzkbFpG583H+u/E7Eu9aqSs/cwoUe+StCmrqzWaTOTECMYmzPhp
+n+Sc8CnTXPnGFiWeI8MgwT0PPzhAsP6CRDiqWhqKa2NYOLQV07YRaXseVO6MGiKs
+cpc/I1mbySKEwQdPzH/iV8oScLumZfNpdWO9lfsbl83kqK/20U6o2YpxJM02PbyW
+xPFsqa7lzw1uKA2wDrXKUXt4FMMgL3/7FFXhEZn91QqhngLjYl/rNUssuHLoPj1P
+rCy7Lobio3aP5ZMqz6WryFyNSwb/EkaseMsUBzXgqd+L6a8VTxaJW732jcZZroiF
+DsGJ6x9nxUWO/203Nit4ZoORUSs9/1F3dmKh7Gc+PoGD4FapUB8fepmrY7+EF3fx
+DTvf95xhszWYijqy7DwaNz9+j5LP2RIUZNoQAhVB/0/E6xyjyfqZ90bp4RjZsbgy
+LcsUDFDYg2WD7rlcz8sFWkz6GZdr1l0T08JcVLwyc6B49fFtHsufpaafItzRUZ6C
+eWRgKRM+o/1Pcmqr4tTluCRVLERLiohEnMqE0yo7AgMBAAGjQjBAMA8GA1UdEwEB
+/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSCIS1mxteg4BXrzkwJ
+d8RgnlRuAzANBgkqhkiG9w0BAQsFAAOCAgEAYN4auOfyYILVAzOBywaK8SJJ6ejq
+kX/GM15oGQOGO0MBzwdw5AgeZYWR5hEit/UCI46uuR59H35s5r0l1ZUa8gWmr4UC
+b6741jH/JclKyMeKqdmfS0mbEVeZkkMR3rYzpMzXjWR91M08KCy0mpbqTfXERMQl
+qiCA2ClV9+BB/AYm/7k29UMUA2Z44RGx2iBfRgB4ACGlHgAoYXhvqAEBj500mv/0
+OJD7uNGzcgbJceaBxXntC6Z58hMLnPddDnskk7RI24Zf3lCGeOdA5jGokHZwYa+c
+NywRtYK3qq4kNFtyDGkNzVmf9nGvnAvRCjj5BiKDUyUM/FHE5r7iOZULJK2v0ZXk
+ltd0ZGtxTgI8qoXzIKNDOXZbbFD+mpwUHmUUihW9o4JFWklWatKcsWMy5WHgUyIO
+pwpJ6st+H6jiYoD2EEVSmAYY3qXNL3+q1Ok+CHLsIwMCPKaq2LxndD0UF/tUSxfj
+03k9bWtJySgOLnRQvwzZRjoQhsmnP+mg7H/rpXdYaXHmgwo38oZJar55CJD2AhZk
+PuXaTH4MNMn5X7azKFGnpyuqSfqNZSlO42sTp5SjLVFteAxEy9/eCG/Oo2Sr05WE
+1LlSVHJ7liXMvGnjSG4N0MedJ5qq+BOS3R7fY581qRY27Iy4g/Q9iY/NtBde17MX
+QRBdJ3NghVdJIgc=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc.
+# Subject: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc.
+# Label: "Trustwave Global Certification Authority"
+# Serial: 1846098327275375458322922162
+# MD5 Fingerprint: f8:1c:18:2d:2f:ba:5f:6d:a1:6c:bc:c7:ab:91:c7:0e
+# SHA1 Fingerprint: 2f:8f:36:4f:e1:58:97:44:21:59:87:a5:2a:9a:d0:69:95:26:7f:b5
+# SHA256 Fingerprint: 97:55:20:15:f5:dd:fc:3c:87:88:c0:06:94:45:55:40:88:94:45:00:84:f1:00:86:70:86:bc:1a:2b:b5:8d:c8
+-----BEGIN CERTIFICATE-----
+MIIF2jCCA8KgAwIBAgIMBfcOhtpJ80Y1LrqyMA0GCSqGSIb3DQEBCwUAMIGIMQsw
+CQYDVQQGEwJVUzERMA8GA1UECAwISWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28x
+ITAfBgNVBAoMGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1
+c3R3YXZlIEdsb2JhbCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0xNzA4MjMx
+OTM0MTJaFw00MjA4MjMxOTM0MTJaMIGIMQswCQYDVQQGEwJVUzERMA8GA1UECAwI
+SWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28xITAfBgNVBAoMGFRydXN0d2F2ZSBI
+b2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1c3R3YXZlIEdsb2JhbCBDZXJ0aWZp
+Y2F0aW9uIEF1dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB
+ALldUShLPDeS0YLOvR29zd24q88KPuFd5dyqCblXAj7mY2Hf8g+CY66j96xz0Xzn
+swuvCAAJWX/NKSqIk4cXGIDtiLK0thAfLdZfVaITXdHG6wZWiYj+rDKd/VzDBcdu
+7oaJuogDnXIhhpCujwOl3J+IKMujkkkP7NAP4m1ET4BqstTnoApTAbqOl5F2brz8
+1Ws25kCI1nsvXwXoLG0R8+eyvpJETNKXpP7ScoFDB5zpET71ixpZfR9oWN0EACyW
+80OzfpgZdNmcc9kYvkHHNHnZ9GLCQ7mzJ7Aiy/k9UscwR7PJPrhq4ufogXBeQotP
+JqX+OsIgbrv4Fo7NDKm0G2x2EOFYeUY+VM6AqFcJNykbmROPDMjWLBz7BegIlT1l
+RtzuzWniTY+HKE40Cz7PFNm73bZQmq131BnW2hqIyE4bJ3XYsgjxroMwuREOzYfw
+hI0Vcnyh78zyiGG69Gm7DIwLdVcEuE4qFC49DxweMqZiNu5m4iK4BUBjECLzMx10
+coos9TkpoNPnG4CELcU9402x/RpvumUHO1jsQkUm+9jaJXLE9gCxInm943xZYkqc
+BW89zubWR2OZxiRvchLIrH+QtAuRcOi35hYQcRfO3gZPSEF9NUqjifLJS3tBEW1n
+twiYTOURGa5CgNz7kAXU+FDKvuStx8KU1xad5hePrzb7AgMBAAGjQjBAMA8GA1Ud
+EwEB/wQFMAMBAf8wHQYDVR0OBBYEFJngGWcNYtt2s9o9uFvo/ULSMQ6HMA4GA1Ud
+DwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAmHNw4rDT7TnsTGDZqRKGFx6W
+0OhUKDtkLSGm+J1WE2pIPU/HPinbbViDVD2HfSMF1OQc3Og4ZYbFdada2zUFvXfe
+uyk3QAUHw5RSn8pk3fEbK9xGChACMf1KaA0HZJDmHvUqoai7PF35owgLEQzxPy0Q
+lG/+4jSHg9bP5Rs1bdID4bANqKCqRieCNqcVtgimQlRXtpla4gt5kNdXElE1GYhB
+aCXUNxeEFfsBctyV3lImIJgm4nb1J2/6ADtKYdkNy1GTKv0WBpanI5ojSP5RvbbE
+sLFUzt5sQa0WZ37b/TjNuThOssFgy50X31ieemKyJo90lZvkWx3SD92YHJtZuSPT
+MaCm/zjdzyBP6VhWOmfD0faZmZ26NraAL4hHT4a/RDqA5Dccprrql5gR0IRiR2Qe
+qu5AvzSxnI9O4fKSTx+O856X3vOmeWqJcU9LJxdI/uz0UA9PSX3MReO9ekDFQdxh
+VicGaeVyQYHTtgGJoC86cnn+OjC/QezHYj6RS8fZMXZC+fc8Y+wmjHMMfRod6qh8
+h6jCJ3zhM0EPz8/8AKAigJ5Kp28AsEFFtyLKaEjFQqKu3R3y4G5OBVixwJAWKqQ9
+EEC+j2Jjg6mcgn0tAumDMHzLJ8n9HmYAsC7TIS+OMxZsmO0QqAfWzJPP29FpHOTK
+yeC2nOnOcXHebD8WpHk=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc.
+# Subject: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc.
+# Label: "Trustwave Global ECC P256 Certification Authority"
+# Serial: 4151900041497450638097112925
+# MD5 Fingerprint: 5b:44:e3:8d:5d:36:86:26:e8:0d:05:d2:59:a7:83:54
+# SHA1 Fingerprint: b4:90:82:dd:45:0c:be:8b:5b:b1:66:d3:e2:a4:08:26:cd:ed:42:cf
+# SHA256 Fingerprint: 94:5b:bc:82:5e:a5:54:f4:89:d1:fd:51:a7:3d:df:2e:a6:24:ac:70:19:a0:52:05:22:5c:22:a7:8c:cf:a8:b4
+-----BEGIN CERTIFICATE-----
+MIICYDCCAgegAwIBAgIMDWpfCD8oXD5Rld9dMAoGCCqGSM49BAMCMIGRMQswCQYD
+VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf
+BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3
+YXZlIEdsb2JhbCBFQ0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x
+NzA4MjMxOTM1MTBaFw00MjA4MjMxOTM1MTBaMIGRMQswCQYDVQQGEwJVUzERMA8G
+A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0
+d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF
+Q0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTBZMBMGByqGSM49AgEGCCqG
+SM49AwEHA0IABH77bOYj43MyCMpg5lOcunSNGLB4kFKA3TjASh3RqMyTpJcGOMoN
+FWLGjgEqZZ2q3zSRLoHB5DOSMcT9CTqmP62jQzBBMA8GA1UdEwEB/wQFMAMBAf8w
+DwYDVR0PAQH/BAUDAwcGADAdBgNVHQ4EFgQUo0EGrJBt0UrrdaVKEJmzsaGLSvcw
+CgYIKoZIzj0EAwIDRwAwRAIgB+ZU2g6gWrKuEZ+Hxbb/ad4lvvigtwjzRM4q3wgh
+DDcCIC0mA6AFvWvR9lz4ZcyGbbOcNEhjhAnFjXca4syc4XR7
+-----END CERTIFICATE-----
+
+# Issuer: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc.
+# Subject: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc.
+# Label: "Trustwave Global ECC P384 Certification Authority"
+# Serial: 2704997926503831671788816187
+# MD5 Fingerprint: ea:cf:60:c4:3b:b9:15:29:40:a1:97:ed:78:27:93:d6
+# SHA1 Fingerprint: e7:f3:a3:c8:cf:6f:c3:04:2e:6d:0e:67:32:c5:9e:68:95:0d:5e:d2
+# SHA256 Fingerprint: 55:90:38:59:c8:c0:c3:eb:b8:75:9e:ce:4e:25:57:22:5f:f5:75:8b:bd:38:eb:d4:82:76:60:1e:1b:d5:80:97
+-----BEGIN CERTIFICATE-----
+MIICnTCCAiSgAwIBAgIMCL2Fl2yZJ6SAaEc7MAoGCCqGSM49BAMDMIGRMQswCQYD
+VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf
+BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3
+YXZlIEdsb2JhbCBFQ0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x
+NzA4MjMxOTM2NDNaFw00MjA4MjMxOTM2NDNaMIGRMQswCQYDVQQGEwJVUzERMA8G
+A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0
+d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF
+Q0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTB2MBAGByqGSM49AgEGBSuB
+BAAiA2IABGvaDXU1CDFHBa5FmVXxERMuSvgQMSOjfoPTfygIOiYaOs+Xgh+AtycJ
+j9GOMMQKmw6sWASr9zZ9lCOkmwqKi6vr/TklZvFe/oyujUF5nQlgziip04pt89ZF
+1PKYhDhloKNDMEEwDwYDVR0TAQH/BAUwAwEB/zAPBgNVHQ8BAf8EBQMDBwYAMB0G
+A1UdDgQWBBRVqYSJ0sEyvRjLbKYHTsjnnb6CkDAKBggqhkjOPQQDAwNnADBkAjA3
+AZKXRRJ+oPM+rRk6ct30UJMDEr5E0k9BpIycnR+j9sKS50gU/k6bpZFXrsY3crsC
+MGclCrEMXu6pY5Jv5ZAL/mYiykf9ijH3g/56vxC+GCsej/YpHpRZ744hN8tRmKVu
+Sw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp.
+# Subject: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp.
+# Label: "NAVER Global Root Certification Authority"
+# Serial: 9013692873798656336226253319739695165984492813
+# MD5 Fingerprint: c8:7e:41:f6:25:3b:f5:09:b3:17:e8:46:3d:bf:d0:9b
+# SHA1 Fingerprint: 8f:6b:f2:a9:27:4a:da:14:a0:c4:f4:8e:61:27:f9:c0:1e:78:5d:d1
+# SHA256 Fingerprint: 88:f4:38:dc:f8:ff:d1:fa:8f:42:91:15:ff:e5:f8:2a:e1:e0:6e:0c:70:c3:75:fa:ad:71:7b:34:a4:9e:72:65
+-----BEGIN CERTIFICATE-----
+MIIFojCCA4qgAwIBAgIUAZQwHqIL3fXFMyqxQ0Rx+NZQTQ0wDQYJKoZIhvcNAQEM
+BQAwaTELMAkGA1UEBhMCS1IxJjAkBgNVBAoMHU5BVkVSIEJVU0lORVNTIFBMQVRG
+T1JNIENvcnAuMTIwMAYDVQQDDClOQVZFUiBHbG9iYWwgUm9vdCBDZXJ0aWZpY2F0
+aW9uIEF1dGhvcml0eTAeFw0xNzA4MTgwODU4NDJaFw0zNzA4MTgyMzU5NTlaMGkx
+CzAJBgNVBAYTAktSMSYwJAYDVQQKDB1OQVZFUiBCVVNJTkVTUyBQTEFURk9STSBD
+b3JwLjEyMDAGA1UEAwwpTkFWRVIgR2xvYmFsIFJvb3QgQ2VydGlmaWNhdGlvbiBB
+dXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC21PGTXLVA
+iQqrDZBbUGOukJR0F0Vy1ntlWilLp1agS7gvQnXp2XskWjFlqxcX0TM62RHcQDaH
+38dq6SZeWYp34+hInDEW+j6RscrJo+KfziFTowI2MMtSAuXaMl3Dxeb57hHHi8lE
+HoSTGEq0n+USZGnQJoViAbbJAh2+g1G7XNr4rRVqmfeSVPc0W+m/6imBEtRTkZaz
+kVrd/pBzKPswRrXKCAfHcXLJZtM0l/aM9BhK4dA9WkW2aacp+yPOiNgSnABIqKYP
+szuSjXEOdMWLyEz59JuOuDxp7W87UC9Y7cSw0BwbagzivESq2M0UXZR4Yb8Obtoq
+vC8MC3GmsxY/nOb5zJ9TNeIDoKAYv7vxvvTWjIcNQvcGufFt7QSUqP620wbGQGHf
+nZ3zVHbOUzoBppJB7ASjjw2i1QnK1sua8e9DXcCrpUHPXFNwcMmIpi3Ua2FzUCaG
+YQ5fG8Ir4ozVu53BA0K6lNpfqbDKzE0K70dpAy8i+/Eozr9dUGWokG2zdLAIx6yo
+0es+nPxdGoMuK8u180SdOqcXYZaicdNwlhVNt0xz7hlcxVs+Qf6sdWA7G2POAN3a
+CJBitOUt7kinaxeZVL6HSuOpXgRM6xBtVNbv8ejyYhbLgGvtPe31HzClrkvJE+2K
+AQHJuFFYwGY6sWZLxNUxAmLpdIQM201GLQIDAQABo0IwQDAdBgNVHQ4EFgQU0p+I
+36HNLL3s9TsBAZMzJ7LrYEswDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMB
+Af8wDQYJKoZIhvcNAQEMBQADggIBADLKgLOdPVQG3dLSLvCkASELZ0jKbY7gyKoN
+qo0hV4/GPnrK21HUUrPUloSlWGB/5QuOH/XcChWB5Tu2tyIvCZwTFrFsDDUIbatj
+cu3cvuzHV+YwIHHW1xDBE1UBjCpD5EHxzzp6U5LOogMFDTjfArsQLtk70pt6wKGm
++LUx5vR1yblTmXVHIloUFcd4G7ad6Qz4G3bxhYTeodoS76TiEJd6eN4MUZeoIUCL
+hr0N8F5OSza7OyAfikJW4Qsav3vQIkMsRIz75Sq0bBwcupTgE34h5prCy8VCZLQe
+lHsIJchxzIdFV4XTnyliIoNRlwAYl3dqmJLJfGBs32x9SuRwTMKeuB330DTHD8z7
+p/8Dvq1wkNoL3chtl1+afwkyQf3NosxabUzyqkn+Zvjp2DXrDige7kgvOtB5CTh8
+piKCk5XQA76+AqAF3SAi428diDRgxuYKuQl1C/AH6GmWNcf7I4GOODm4RStDeKLR
+LBT/DShycpWbXgnbiUSYqqFJu3FS8r/2/yehNq+4tneI3TqkbZs0kNwUXTC/t+sX
+5Ie3cdCh13cV1ELX8vMxmV2b3RZtP+oGI/hGoiLtk/bdmuYqh7GYVPEi92tF4+KO
+dh2ajcQGjTa3FPOdVGm3jjzVpG2Tgbet9r1ke8LJaDmgkpzNNIaRkPpkUZ3+/uul
+9XXeifdy
+-----END CERTIFICATE-----
+
+# Issuer: CN=AC RAIZ FNMT-RCM SERVIDORES SEGUROS O=FNMT-RCM OU=Ceres
+# Subject: CN=AC RAIZ FNMT-RCM SERVIDORES SEGUROS O=FNMT-RCM OU=Ceres
+# Label: "AC RAIZ FNMT-RCM SERVIDORES SEGUROS"
+# Serial: 131542671362353147877283741781055151509
+# MD5 Fingerprint: 19:36:9c:52:03:2f:d2:d1:bb:23:cc:dd:1e:12:55:bb
+# SHA1 Fingerprint: 62:ff:d9:9e:c0:65:0d:03:ce:75:93:d2:ed:3f:2d:32:c9:e3:e5:4a
+# SHA256 Fingerprint: 55:41:53:b1:3d:2c:f9:dd:b7:53:bf:be:1a:4e:0a:e0:8d:0a:a4:18:70:58:fe:60:a2:b8:62:b2:e4:b8:7b:cb
+-----BEGIN CERTIFICATE-----
+MIICbjCCAfOgAwIBAgIQYvYybOXE42hcG2LdnC6dlTAKBggqhkjOPQQDAzB4MQsw
+CQYDVQQGEwJFUzERMA8GA1UECgwIRk5NVC1SQ00xDjAMBgNVBAsMBUNlcmVzMRgw
+FgYDVQRhDA9WQVRFUy1RMjgyNjAwNEoxLDAqBgNVBAMMI0FDIFJBSVogRk5NVC1S
+Q00gU0VSVklET1JFUyBTRUdVUk9TMB4XDTE4MTIyMDA5MzczM1oXDTQzMTIyMDA5
+MzczM1oweDELMAkGA1UEBhMCRVMxETAPBgNVBAoMCEZOTVQtUkNNMQ4wDAYDVQQL
+DAVDZXJlczEYMBYGA1UEYQwPVkFURVMtUTI4MjYwMDRKMSwwKgYDVQQDDCNBQyBS
+QUlaIEZOTVQtUkNNIFNFUlZJRE9SRVMgU0VHVVJPUzB2MBAGByqGSM49AgEGBSuB
+BAAiA2IABPa6V1PIyqvfNkpSIeSX0oNnnvBlUdBeh8dHsVnyV0ebAAKTRBdp20LH
+sbI6GA60XYyzZl2hNPk2LEnb80b8s0RpRBNm/dfF/a82Tc4DTQdxz69qBdKiQ1oK
+Um8BA06Oi6NCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYD
+VR0OBBYEFAG5L++/EYZg8k/QQW6rcx/n0m5JMAoGCCqGSM49BAMDA2kAMGYCMQCu
+SuMrQMN0EfKVrRYj3k4MGuZdpSRea0R7/DjiT8ucRRcRTBQnJlU5dUoDzBOQn5IC
+MQD6SmxgiHPz7riYYqnOK8LZiqZwMR2vsJRM60/G49HzYqc8/5MuB1xJAWdpEgJy
+v+c=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign Root R46 O=GlobalSign nv-sa
+# Subject: CN=GlobalSign Root R46 O=GlobalSign nv-sa
+# Label: "GlobalSign Root R46"
+# Serial: 1552617688466950547958867513931858518042577
+# MD5 Fingerprint: c4:14:30:e4:fa:66:43:94:2a:6a:1b:24:5f:19:d0:ef
+# SHA1 Fingerprint: 53:a2:b0:4b:ca:6b:d6:45:e6:39:8a:8e:c4:0d:d2:bf:77:c3:a2:90
+# SHA256 Fingerprint: 4f:a3:12:6d:8d:3a:11:d1:c4:85:5a:4f:80:7c:ba:d6:cf:91:9d:3a:5a:88:b0:3b:ea:2c:63:72:d9:3c:40:c9
+-----BEGIN CERTIFICATE-----
+MIIFWjCCA0KgAwIBAgISEdK7udcjGJ5AXwqdLdDfJWfRMA0GCSqGSIb3DQEBDAUA
+MEYxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYD
+VQQDExNHbG9iYWxTaWduIFJvb3QgUjQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMy
+MDAwMDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYt
+c2ExHDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQCsrHQy6LNl5brtQyYdpokNRbopiLKkHWPd08EsCVeJ
+OaFV6Wc0dwxu5FUdUiXSE2te4R2pt32JMl8Nnp8semNgQB+msLZ4j5lUlghYruQG
+vGIFAha/r6gjA7aUD7xubMLL1aa7DOn2wQL7Id5m3RerdELv8HQvJfTqa1VbkNud
+316HCkD7rRlr+/fKYIje2sGP1q7Vf9Q8g+7XFkyDRTNrJ9CG0Bwta/OrffGFqfUo
+0q3v84RLHIf8E6M6cqJaESvWJ3En7YEtbWaBkoe0G1h6zD8K+kZPTXhc+CtI4wSE
+y132tGqzZfxCnlEmIyDLPRT5ge1lFgBPGmSXZgjPjHvjK8Cd+RTyG/FWaha/LIWF
+zXg4mutCagI0GIMXTpRW+LaCtfOW3T3zvn8gdz57GSNrLNRyc0NXfeD412lPFzYE
++cCQYDdF3uYM2HSNrpyibXRdQr4G9dlkbgIQrImwTDsHTUB+JMWKmIJ5jqSngiCN
+I/onccnfxkF0oE32kRbcRoxfKWMxWXEM2G/CtjJ9++ZdU6Z+Ffy7dXxd7Pj2Fxzs
+x2sZy/N78CsHpdlseVR2bJ0cpm4O6XkMqCNqo98bMDGfsVR7/mrLZqrcZdCinkqa
+ByFrgY/bxFn63iLABJzjqls2k+g9vXqhnQt2sQvHnf3PmKgGwvgqo6GDoLclcqUC
+4wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
+HQ4EFgQUA1yrc4GHqMywptWU4jaWSf8FmSwwDQYJKoZIhvcNAQEMBQADggIBAHx4
+7PYCLLtbfpIrXTncvtgdokIzTfnvpCo7RGkerNlFo048p9gkUbJUHJNOxO97k4Vg
+JuoJSOD1u8fpaNK7ajFxzHmuEajwmf3lH7wvqMxX63bEIaZHU1VNaL8FpO7XJqti
+2kM3S+LGteWygxk6x9PbTZ4IevPuzz5i+6zoYMzRx6Fcg0XERczzF2sUyQQCPtIk
+pnnpHs6i58FZFZ8d4kuaPp92CC1r2LpXFNqD6v6MVenQTqnMdzGxRBF6XLE+0xRF
+FRhiJBPSy03OXIPBNvIQtQ6IbbjhVp+J3pZmOUdkLG5NrmJ7v2B0GbhWrJKsFjLt
+rWhV/pi60zTe9Mlhww6G9kuEYO4Ne7UyWHmRVSyBQ7N0H3qqJZ4d16GLuc1CLgSk
+ZoNNiTW2bKg2SnkheCLQQrzRQDGQob4Ez8pn7fXwgNNgyYMqIgXQBztSvwyeqiv5
+u+YfjyW6hY0XHgL+XVAEV8/+LbzvXMAaq7afJMbfc2hIkCwU9D9SGuTSyxTDYWnP
+4vkYxboznxSjBF25cfe1lNj2M8FawTSLfJvdkzrnE6JwYZ+vj+vYxXX4M2bUdGc6
+N3ec592kD3ZDZopD8p/7DEJ4Y9HiD2971KE9dJeFt0g5QdYg/NA6s/rob8SKunE3
+vouXsXgxT7PntgMTzlSdriVZzH81Xwj3QEUxeCp6
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign Root E46 O=GlobalSign nv-sa
+# Subject: CN=GlobalSign Root E46 O=GlobalSign nv-sa
+# Label: "GlobalSign Root E46"
+# Serial: 1552617690338932563915843282459653771421763
+# MD5 Fingerprint: b5:b8:66:ed:de:08:83:e3:c9:e2:01:34:06:ac:51:6f
+# SHA1 Fingerprint: 39:b4:6c:d5:fe:80:06:eb:e2:2f:4a:bb:08:33:a0:af:db:b9:dd:84
+# SHA256 Fingerprint: cb:b9:c4:4d:84:b8:04:3e:10:50:ea:31:a6:9f:51:49:55:d7:bf:d2:e2:c6:b4:93:01:01:9a:d6:1d:9f:50:58
+-----BEGIN CERTIFICATE-----
+MIICCzCCAZGgAwIBAgISEdK7ujNu1LzmJGjFDYQdmOhDMAoGCCqGSM49BAMDMEYx
+CzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYDVQQD
+ExNHbG9iYWxTaWduIFJvb3QgRTQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMyMDAw
+MDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2Ex
+HDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUrgQQA
+IgNiAAScDrHPt+ieUnd1NPqlRqetMhkytAepJ8qUuwzSChDH2omwlwxwEwkBjtjq
+R+q+soArzfwoDdusvKSGN+1wCAB16pMLey5SnCNoIwZD7JIvU4Tb+0cUB+hflGdd
+yXqBPCCjQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud
+DgQWBBQxCpCPtsad0kRLgLWi5h+xEk8blTAKBggqhkjOPQQDAwNoADBlAjEA31SQ
+7Zvvi5QCkxeCmb6zniz2C5GMn0oUsfZkvLtoURMMA/cVi4RguYv/Uo7njLwcAjA8
++RHUjE7AwWHCFUyqqx0LMV87HOIAl0Qx5v5zli/altP+CAezNIm8BZ/3Hobui3A=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GLOBALTRUST 2020 O=e-commerce monitoring GmbH
+# Subject: CN=GLOBALTRUST 2020 O=e-commerce monitoring GmbH
+# Label: "GLOBALTRUST 2020"
+# Serial: 109160994242082918454945253
+# MD5 Fingerprint: 8a:c7:6f:cb:6d:e3:cc:a2:f1:7c:83:fa:0e:78:d7:e8
+# SHA1 Fingerprint: d0:67:c1:13:51:01:0c:aa:d0:c7:6a:65:37:31:16:26:4f:53:71:a2
+# SHA256 Fingerprint: 9a:29:6a:51:82:d1:d4:51:a2:e3:7f:43:9b:74:da:af:a2:67:52:33:29:f9:0f:9a:0d:20:07:c3:34:e2:3c:9a
+-----BEGIN CERTIFICATE-----
+MIIFgjCCA2qgAwIBAgILWku9WvtPilv6ZeUwDQYJKoZIhvcNAQELBQAwTTELMAkG
+A1UEBhMCQVQxIzAhBgNVBAoTGmUtY29tbWVyY2UgbW9uaXRvcmluZyBHbWJIMRkw
+FwYDVQQDExBHTE9CQUxUUlVTVCAyMDIwMB4XDTIwMDIxMDAwMDAwMFoXDTQwMDYx
+MDAwMDAwMFowTTELMAkGA1UEBhMCQVQxIzAhBgNVBAoTGmUtY29tbWVyY2UgbW9u
+aXRvcmluZyBHbWJIMRkwFwYDVQQDExBHTE9CQUxUUlVTVCAyMDIwMIICIjANBgkq
+hkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAri5WrRsc7/aVj6B3GyvTY4+ETUWiD59b
+RatZe1E0+eyLinjF3WuvvcTfk0Uev5E4C64OFudBc/jbu9G4UeDLgztzOG53ig9Z
+YybNpyrOVPu44sB8R85gfD+yc/LAGbaKkoc1DZAoouQVBGM+uq/ufF7MpotQsjj3
+QWPKzv9pj2gOlTblzLmMCcpL3TGQlsjMH/1WljTbjhzqLL6FLmPdqqmV0/0plRPw
+yJiT2S0WR5ARg6I6IqIoV6Lr/sCMKKCmfecqQjuCgGOlYx8ZzHyyZqjC0203b+J+
+BlHZRYQfEs4kUmSFC0iAToexIiIwquuuvuAC4EDosEKAA1GqtH6qRNdDYfOiaxaJ
+SaSjpCuKAsR49GiKweR6NrFvG5Ybd0mN1MkGco/PU+PcF4UgStyYJ9ORJitHHmkH
+r96i5OTUawuzXnzUJIBHKWk7buis/UDr2O1xcSvy6Fgd60GXIsUf1DnQJ4+H4xj0
+4KlGDfV0OoIu0G4skaMxXDtG6nsEEFZegB31pWXogvziB4xiRfUg3kZwhqG8k9Me
+dKZssCz3AwyIDMvUclOGvGBG85hqwvG/Q/lwIHfKN0F5VVJjjVsSn8VoxIidrPIw
+q7ejMZdnrY8XD2zHc+0klGvIg5rQmjdJBKuxFshsSUktq6HQjJLyQUp5ISXbY9e2
+nKd+Qmn7OmMCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
+AQYwHQYDVR0OBBYEFNwuH9FhN3nkq9XVsxJxaD1qaJwiMB8GA1UdIwQYMBaAFNwu
+H9FhN3nkq9XVsxJxaD1qaJwiMA0GCSqGSIb3DQEBCwUAA4ICAQCR8EICaEDuw2jA
+VC/f7GLDw56KoDEoqoOOpFaWEhCGVrqXctJUMHytGdUdaG/7FELYjQ7ztdGl4wJC
+XtzoRlgHNQIw4Lx0SsFDKv/bGtCwr2zD/cuz9X9tAy5ZVp0tLTWMstZDFyySCstd
+6IwPS3BD0IL/qMy/pJTAvoe9iuOTe8aPmxadJ2W8esVCgmxcB9CpwYhgROmYhRZf
++I/KARDOJcP5YBugxZfD0yyIMaK9MOzQ0MAS8cE54+X1+NZK3TTN+2/BT+MAi1bi
+kvcoskJ3ciNnxz8RFbLEAwW+uxF7Cr+obuf/WEPPm2eggAe2HcqtbepBEX4tdJP7
+wry+UUTF72glJ4DjyKDUEuzZpTcdN3y0kcra1LGWge9oXHYQSa9+pTeAsRxSvTOB
+TI/53WXZFM2KJVj04sWDpQmQ1GwUY7VA3+vA/MRYfg0UFodUJ25W5HCEuGwyEn6C
+MUO+1918oa2u1qsgEu8KwxCMSZY13At1XrFP1U80DhEgB3VDRemjEdqso5nCtnkn
+4rnvyOL2NSl6dPrFf4IFYqYK6miyeUcGbvJXqBUzxvd4Sj1Ce2t+/vdG6tHrju+I
+aFvowdlxfv1k7/9nR4hYJS8+hge9+6jlgqispdNpQ80xiEmEU5LAsTkbOYMBMMTy
+qfrQA71yN2BWHzZ8vTmR9W0Nv3vXkg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz
+# Subject: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz
+# Label: "ANF Secure Server Root CA"
+# Serial: 996390341000653745
+# MD5 Fingerprint: 26:a6:44:5a:d9:af:4e:2f:b2:1d:b6:65:b0:4e:e8:96
+# SHA1 Fingerprint: 5b:6e:68:d0:cc:15:b6:a0:5f:1e:c1:5f:ae:02:fc:6b:2f:5d:6f:74
+# SHA256 Fingerprint: fb:8f:ec:75:91:69:b9:10:6b:1e:51:16:44:c6:18:c5:13:04:37:3f:6c:06:43:08:8d:8b:ef:fd:1b:99:75:99
+-----BEGIN CERTIFICATE-----
+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
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certum EC-384 CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
+# Subject: CN=Certum EC-384 CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
+# Label: "Certum EC-384 CA"
+# Serial: 160250656287871593594747141429395092468
+# MD5 Fingerprint: b6:65:b3:96:60:97:12:a1:ec:4e:e1:3d:a3:c6:c9:f1
+# SHA1 Fingerprint: f3:3e:78:3c:ac:df:f4:a2:cc:ac:67:55:69:56:d7:e5:16:3c:e1:ed
+# SHA256 Fingerprint: 6b:32:80:85:62:53:18:aa:50:d1:73:c9:8d:8b:da:09:d5:7e:27:41:3d:11:4c:f7:87:a0:f5:d0:6c:03:0c:f6
+-----BEGIN CERTIFICATE-----
+MIICZTCCAeugAwIBAgIQeI8nXIESUiClBNAt3bpz9DAKBggqhkjOPQQDAzB0MQsw
+CQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMScw
+JQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxGTAXBgNVBAMT
+EENlcnR1bSBFQy0zODQgQ0EwHhcNMTgwMzI2MDcyNDU0WhcNNDMwMzI2MDcyNDU0
+WjB0MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBT
+LkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxGTAX
+BgNVBAMTEENlcnR1bSBFQy0zODQgQ0EwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATE
+KI6rGFtqvm5kN2PkzeyrOvfMobgOgknXhimfoZTy42B4mIF4Bk3y7JoOV2CDn7Tm
+Fy8as10CW4kjPMIRBSqniBMY81CE1700LCeJVf/OTOffph8oxPBUw7l8t1Ot68Kj
+QjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI0GZnQkdjrzife81r1HfS+8
+EF9LMA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNoADBlAjADVS2m5hjEfO/J
+UG7BJw+ch69u1RsIGL2SKcHvlJF40jocVYli5RsJHrpka/F2tNQCMQC0QoSZ/6vn
+nvuRlydd3LBbMHHOXjgaatkl5+r3YZJW+OraNsKHZZYuciUvf9/DE8k=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certum Trusted Root CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
+# Subject: CN=Certum Trusted Root CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
+# Label: "Certum Trusted Root CA"
+# Serial: 40870380103424195783807378461123655149
+# MD5 Fingerprint: 51:e1:c2:e7:fe:4c:84:af:59:0e:2f:f4:54:6f:ea:29
+# SHA1 Fingerprint: c8:83:44:c0:18:ae:9f:cc:f1:87:b7:8f:22:d1:c5:d7:45:84:ba:e5
+# SHA256 Fingerprint: fe:76:96:57:38:55:77:3e:37:a9:5e:7a:d4:d9:cc:96:c3:01:57:c1:5d:31:76:5b:a9:b1:57:04:e1:ae:78:fd
+-----BEGIN CERTIFICATE-----
+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
+-----END CERTIFICATE-----
+
+# Issuer: CN=TunTrust Root CA O=Agence Nationale de Certification Electronique
+# Subject: CN=TunTrust Root CA O=Agence Nationale de Certification Electronique
+# Label: "TunTrust Root CA"
+# Serial: 108534058042236574382096126452369648152337120275
+# MD5 Fingerprint: 85:13:b9:90:5b:36:5c:b6:5e:b8:5a:f8:e0:31:57:b4
+# SHA1 Fingerprint: cf:e9:70:84:0f:e0:73:0f:9d:f6:0c:7f:2c:4b:ee:20:46:34:9c:bb
+# SHA256 Fingerprint: 2e:44:10:2a:b5:8c:b8:54:19:45:1c:8e:19:d9:ac:f3:66:2c:af:bc:61:4b:6a:53:96:0a:30:f7:d0:e2:eb:41
+-----BEGIN CERTIFICATE-----
+MIIFszCCA5ugAwIBAgIUEwLV4kBMkkaGFmddtLu7sms+/BMwDQYJKoZIhvcNAQEL
+BQAwYTELMAkGA1UEBhMCVE4xNzA1BgNVBAoMLkFnZW5jZSBOYXRpb25hbGUgZGUg
+Q2VydGlmaWNhdGlvbiBFbGVjdHJvbmlxdWUxGTAXBgNVBAMMEFR1blRydXN0IFJv
+b3QgQ0EwHhcNMTkwNDI2MDg1NzU2WhcNNDQwNDI2MDg1NzU2WjBhMQswCQYDVQQG
+EwJUTjE3MDUGA1UECgwuQWdlbmNlIE5hdGlvbmFsZSBkZSBDZXJ0aWZpY2F0aW9u
+IEVsZWN0cm9uaXF1ZTEZMBcGA1UEAwwQVHVuVHJ1c3QgUm9vdCBDQTCCAiIwDQYJ
+KoZIhvcNAQEBBQADggIPADCCAgoCggIBAMPN0/y9BFPdDCA61YguBUtB9YOCfvdZ
+n56eY+hz2vYGqU8ftPkLHzmMmiDQfgbU7DTZhrx1W4eI8NLZ1KMKsmwb60ksPqxd
+2JQDoOw05TDENX37Jk0bbjBU2PWARZw5rZzJJQRNmpA+TkBuimvNKWfGzC3gdOgF
+VwpIUPp6Q9p+7FuaDmJ2/uqdHYVy7BG7NegfJ7/Boce7SBbdVtfMTqDhuazb1YMZ
+GoXRlJfXyqNlC/M4+QKu3fZnz8k/9YosRxqZbwUN/dAdgjH8KcwAWJeRTIAAHDOF
+li/LQcKLEITDCSSJH7UP2dl3RxiSlGBcx5kDPP73lad9UKGAwqmDrViWVSHbhlnU
+r8a83YFuB9tgYv7sEG7aaAH0gxupPqJbI9dkxt/con3YS7qC0lH4Zr8GRuR5KiY2
+eY8fTpkdso8MDhz/yV3A/ZAQprE38806JG60hZC/gLkMjNWb1sjxVj8agIl6qeIb
+MlEsPvLfe/ZdeikZjuXIvTZxi11Mwh0/rViizz1wTaZQmCXcI/m4WEEIcb9PuISg
+jwBUFfyRbVinljvrS5YnzWuioYasDXxU5mZMZl+QviGaAkYt5IPCgLnPSz7ofzwB
+7I9ezX/SKEIBlYrilz0QIX32nRzFNKHsLA4KUiwSVXAkPcvCFDVDXSdOvsC9qnyW
+5/yeYa1E0wCXAgMBAAGjYzBhMB0GA1UdDgQWBBQGmpsfU33x9aTI04Y+oXNZtPdE
+ITAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFAaamx9TffH1pMjThj6hc1m0
+90QhMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAqgVutt0Vyb+z
+xiD2BkewhpMl0425yAA/l/VSJ4hxyXT968pk21vvHl26v9Hr7lxpuhbI87mP0zYu
+QEkHDVneixCwSQXi/5E/S7fdAo74gShczNxtr18UnH1YeA32gAm56Q6XKRm4t+v4
+FstVEuTGfbvE7Pi1HE4+Z7/FXxttbUcoqgRYYdZ2vyJ/0Adqp2RT8JeNnYA/u8EH
+22Wv5psymsNUk8QcCMNE+3tjEUPRahphanltkE8pjkcFwRJpadbGNjHh/PqAulxP
+xOu3Mqz4dWEX1xAZufHSCe96Qp1bWgvUxpVOKs7/B9dPfhgGiPEZtdmYu65xxBzn
+dFlY7wyJz4sfdZMaBBSSSFCp61cpABbjNhzI+L/wM9VBD8TMPN3pM0MBkRArHtG5
+Xc0yGYuPjCB31yLEQtyEFpslbei0VXF/sHyz03FJuc9SpAQ/3D2gu68zngowYI7b
+nV2UqL1g52KAdoGDDIzMMEZJ4gzSqK/rYXHv5yJiqfdcZGyfFoxnNidF9Ql7v/YQ
+CvGwjVRDjAS6oz/v4jXH+XTgbzRB0L9zZVcg+ZtnemZoJE6AZb0QmQZZ8mWvuMZH
+u/2QeItBcy6vVR/cO5JyboTT0GFMDcx2V+IthSIVNg3rAZ3r2OvEhJn7wAzMMujj
+d9qDRIueVSjAi1jTkD5OGwDxFa2DK5o=
+-----END CERTIFICATE-----
+
+# Issuer: CN=HARICA TLS RSA Root CA 2021 O=Hellenic Academic and Research Institutions CA
+# Subject: CN=HARICA TLS RSA Root CA 2021 O=Hellenic Academic and Research Institutions CA
+# Label: "HARICA TLS RSA Root CA 2021"
+# Serial: 76817823531813593706434026085292783742
+# MD5 Fingerprint: 65:47:9b:58:86:dd:2c:f0:fc:a2:84:1f:1e:96:c4:91
+# SHA1 Fingerprint: 02:2d:05:82:fa:88:ce:14:0c:06:79:de:7f:14:10:e9:45:d7:a5:6d
+# SHA256 Fingerprint: d9:5d:0e:8e:da:79:52:5b:f9:be:b1:1b:14:d2:10:0d:32:94:98:5f:0c:62:d9:fa:bd:9c:d9:99:ec:cb:7b:1d
+-----BEGIN CERTIFICATE-----
+MIIFpDCCA4ygAwIBAgIQOcqTHO9D88aOk8f0ZIk4fjANBgkqhkiG9w0BAQsFADBs
+MQswCQYDVQQGEwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl
+c2VhcmNoIEluc3RpdHV0aW9ucyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBSU0Eg
+Um9vdCBDQSAyMDIxMB4XDTIxMDIxOTEwNTUzOFoXDTQ1MDIxMzEwNTUzN1owbDEL
+MAkGA1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNl
+YXJjaCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgUlNBIFJv
+b3QgQ0EgMjAyMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAIvC569l
+mwVnlskNJLnQDmT8zuIkGCyEf3dRywQRNrhe7Wlxp57kJQmXZ8FHws+RFjZiPTgE
+4VGC/6zStGndLuwRo0Xua2s7TL+MjaQenRG56Tj5eg4MmOIjHdFOY9TnuEFE+2uv
+a9of08WRiFukiZLRgeaMOVig1mlDqa2YUlhu2wr7a89o+uOkXjpFc5gH6l8Cct4M
+pbOfrqkdtx2z/IpZ525yZa31MJQjB/OCFks1mJxTuy/K5FrZx40d/JiZ+yykgmvw
+Kh+OC19xXFyuQnspiYHLA6OZyoieC0AJQTPb5lh6/a6ZcMBaD9YThnEvdmn8kN3b
+LW7R8pv1GmuebxWMevBLKKAiOIAkbDakO/IwkfN4E8/BPzWr8R0RI7VDIp4BkrcY
+AuUR0YLbFQDMYTfBKnya4dC6s1BG7oKsnTH4+yPiAwBIcKMJJnkVU2DzOFytOOqB
+AGMUuTNe3QvboEUHGjMJ+E20pwKmafTCWQWIZYVWrkvL4N48fS0ayOn7H6NhStYq
+E613TBoYm5EPWNgGVMWX+Ko/IIqmhaZ39qb8HOLubpQzKoNQhArlT4b4UEV4AIHr
+W2jjJo3Me1xR9BQsQL4aYB16cmEdH2MtiKrOokWQCPxrvrNQKlr9qEgYRtaQQJKQ
+CoReaDH46+0N0x3GfZkYVVYnZS6NRcUk7M7jAgMBAAGjQjBAMA8GA1UdEwEB/wQF
+MAMBAf8wHQYDVR0OBBYEFApII6ZgpJIKM+qTW8VX6iVNvRLuMA4GA1UdDwEB/wQE
+AwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAPpBIqm5iFSVmewzVjIuJndftTgfvnNAU
+X15QvWiWkKQUEapobQk1OUAJ2vQJLDSle1mESSmXdMgHHkdt8s4cUCbjnj1AUz/3
+f5Z2EMVGpdAgS1D0NTsY9FVqQRtHBmg8uwkIYtlfVUKqrFOFrJVWNlar5AWMxaja
+H6NpvVMPxP/cyuN+8kyIhkdGGvMA9YCRotxDQpSbIPDRzbLrLFPCU3hKTwSUQZqP
+JzLB5UkZv/HywouoCjkxKLR9YjYsTewfM7Z+d21+UPCfDtcRj88YxeMn/ibvBZ3P
+zzfF0HvaO7AWhAw6k9a+F9sPPg4ZeAnHqQJyIkv3N3a6dcSFA1pj1bF1BcK5vZSt
+jBWZp5N99sXzqnTPBIWUmAD04vnKJGW/4GKvyMX6ssmeVkjaef2WdhW+o45WxLM0
+/L5H9MG0qPzVMIho7suuyWPEdr6sOBjhXlzPrjoiUevRi7PzKzMHVIf6tLITe7pT
+BGIBnfHAT+7hOtSLIBD6Alfm78ELt5BGnBkpjNxvoEppaZS3JGWg/6w/zgH7IS79
+aPib8qXPMThcFarmlwDB31qlpzmq6YR/PFGoOtmUW4y/Twhx5duoXNTSpv4Ao8YW
+xw/ogM4cKGR0GQjTQuPOAF1/sdwTsOEFy9EgqoZ0njnnkf3/W9b3raYvAwtt41dU
+63ZTGI0RmLo=
+-----END CERTIFICATE-----
+
+# Issuer: CN=HARICA TLS ECC Root CA 2021 O=Hellenic Academic and Research Institutions CA
+# Subject: CN=HARICA TLS ECC Root CA 2021 O=Hellenic Academic and Research Institutions CA
+# Label: "HARICA TLS ECC Root CA 2021"
+# Serial: 137515985548005187474074462014555733966
+# MD5 Fingerprint: ae:f7:4c:e5:66:35:d1:b7:9b:8c:22:93:74:d3:4b:b0
+# SHA1 Fingerprint: bc:b0:c1:9d:e9:98:92:70:19:38:57:e9:8d:a7:b4:5d:6e:ee:01:48
+# SHA256 Fingerprint: 3f:99:cc:47:4a:cf:ce:4d:fe:d5:87:94:66:5e:47:8d:15:47:73:9f:2e:78:0f:1b:b4:ca:9b:13:30:97:d4:01
+-----BEGIN CERTIFICATE-----
+MIICVDCCAdugAwIBAgIQZ3SdjXfYO2rbIvT/WeK/zjAKBggqhkjOPQQDAzBsMQsw
+CQYDVQQGEwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2Vh
+cmNoIEluc3RpdHV0aW9ucyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBFQ0MgUm9v
+dCBDQSAyMDIxMB4XDTIxMDIxOTExMDExMFoXDTQ1MDIxMzExMDEwOVowbDELMAkG
+A1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJj
+aCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgRUNDIFJvb3Qg
+Q0EgMjAyMTB2MBAGByqGSM49AgEGBSuBBAAiA2IABDgI/rGgltJ6rK9JOtDA4MM7
+KKrxcm1lAEeIhPyaJmuqS7psBAqIXhfyVYf8MLA04jRYVxqEU+kw2anylnTDUR9Y
+STHMmE5gEYd103KUkE+bECUqqHgtvpBBWJAVcqeht6NCMEAwDwYDVR0TAQH/BAUw
+AwEB/zAdBgNVHQ4EFgQUyRtTgRL+BNUW0aq8mm+3oJUZbsowDgYDVR0PAQH/BAQD
+AgGGMAoGCCqGSM49BAMDA2cAMGQCMBHervjcToiwqfAircJRQO9gcS3ujwLEXQNw
+SaSS6sUUiHCm0w2wqsosQJz76YJumgIwK0eaB8bRwoF8yguWGEEbo/QwCZ61IygN
+nxS2PFOiTAZpffpskcYqSUXm7LcT4Tps
+-----END CERTIFICATE-----
diff --git a/openpype/vendor/python/python_2/certifi/core.py b/openpype/vendor/python/python_2/certifi/core.py
new file mode 100644
index 0000000000..5d2b8cd32f
--- /dev/null
+++ b/openpype/vendor/python/python_2/certifi/core.py
@@ -0,0 +1,60 @@
+# -*- coding: utf-8 -*-
+
+"""
+certifi.py
+~~~~~~~~~~
+
+This module returns the installation location of cacert.pem or its contents.
+"""
+import os
+
+try:
+    from importlib.resources import path as get_path, read_text
+
+    _CACERT_CTX = None
+    _CACERT_PATH = None
+
+    def where():
+        # This is slightly terrible, but we want to delay extracting the file
+        # in cases where we're inside of a zipimport situation until someone
+        # actually calls where(), but we don't want to re-extract the file
+        # on every call of where(), so we'll do it once then store it in a
+        # global variable.
+        global _CACERT_CTX
+        global _CACERT_PATH
+        if _CACERT_PATH is None:
+            # This is slightly janky, the importlib.resources API wants you to
+            # manage the cleanup of this file, so it doesn't actually return a
+            # path, it returns a context manager that will give you the path
+            # when you enter it and will do any cleanup when you leave it. In
+            # the common case of not needing a temporary file, it will just
+            # return the file system location and the __exit__() is a no-op.
+            #
+            # We also have to hold onto the actual context manager, because
+            # it will do the cleanup whenever it gets garbage collected, so
+            # we will also store that at the global level as well.
+            _CACERT_CTX = get_path("certifi", "cacert.pem")
+            _CACERT_PATH = str(_CACERT_CTX.__enter__())
+
+        return _CACERT_PATH
+
+
+except ImportError:
+    # This fallback will work for Python versions prior to 3.7 that lack the
+    # importlib.resources module but relies on the existing `where` function
+    # so won't address issues with environments like PyOxidizer that don't set
+    # __file__ on modules.
+    def read_text(_module, _path, encoding="ascii"):
+        with open(where(), "r", encoding=encoding) as data:
+            return data.read()
+
+    # If we don't have importlib.resources, then we will just do the old logic
+    # of assuming we're on the filesystem and munge the path directly.
+    def where():
+        f = os.path.dirname(__file__)
+
+        return os.path.join(f, "cacert.pem")
+
+
+def contents():
+    return read_text("certifi", "cacert.pem", encoding="ascii")

From e2717ac9636154f0b8cfc733dd7bc45fd86589db Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 16:56:09 +0200
Subject: [PATCH 0518/1227] updated poetry lock file

---
 poetry.lock | 870 +++++++++++++++++++++++++++++-----------------------
 1 file changed, 493 insertions(+), 377 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index a79c865a9e..47509f334e 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -94,7 +94,7 @@ python-dateutil = ">=2.7.0"
 
 [[package]]
 name = "astroid"
-version = "2.9.3"
+version = "2.11.5"
 description = "An abstract syntax tree for Python with inference support."
 category = "dev"
 optional = false
@@ -104,7 +104,7 @@ python-versions = ">=3.6.2"
 lazy-object-proxy = ">=1.4.0"
 typed-ast = {version = ">=1.4.0,<2.0", markers = "implementation_name == \"cpython\" and python_version < \"3.8\""}
 typing-extensions = {version = ">=3.10", markers = "python_version < \"3.10\""}
-wrapt = ">=1.11,<1.14"
+wrapt = ">=1.11,<2"
 
 [[package]]
 name = "async-timeout"
@@ -172,7 +172,7 @@ pytz = ">=2015.7"
 
 [[package]]
 name = "bcrypt"
-version = "3.2.0"
+version = "3.2.2"
 description = "Modern password hashing for your software and your servers"
 category = "main"
 optional = false
@@ -180,7 +180,6 @@ python-versions = ">=3.6"
 
 [package.dependencies]
 cffi = ">=1.1"
-six = ">=1.4.1"
 
 [package.extras]
 tests = ["pytest (>=3.2.1,!=3.3.0)"]
@@ -201,7 +200,7 @@ wcwidth = ">=0.1.4"
 
 [[package]]
 name = "cachetools"
-version = "5.0.0"
+version = "5.2.0"
 description = "Extensible memoizing collections and decorators"
 category = "main"
 optional = false
@@ -209,11 +208,11 @@ python-versions = "~=3.7"
 
 [[package]]
 name = "certifi"
-version = "2021.10.8"
+version = "2022.5.18.1"
 description = "Python package for providing Mozilla's CA Bundle."
 category = "main"
 optional = false
-python-versions = "*"
+python-versions = ">=3.6"
 
 [[package]]
 name = "cffi"
@@ -226,17 +225,9 @@ python-versions = "*"
 [package.dependencies]
 pycparser = "*"
 
-[[package]]
-name = "chardet"
-version = "4.0.0"
-description = "Universal encoding detector for Python 2 and 3"
-category = "main"
-optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
-
 [[package]]
 name = "charset-normalizer"
-version = "2.0.11"
+version = "2.0.12"
 description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet."
 category = "main"
 optional = false
@@ -295,21 +286,21 @@ python-versions = "*"
 
 [[package]]
 name = "coverage"
-version = "6.3.1"
+version = "6.4.1"
 description = "Code coverage measurement for Python"
 category = "dev"
 optional = false
 python-versions = ">=3.7"
 
 [package.dependencies]
-tomli = {version = "*", optional = true, markers = "extra == \"toml\""}
+tomli = {version = "*", optional = true, markers = "python_full_version <= \"3.11.0a6\" and extra == \"toml\""}
 
 [package.extras]
 toml = ["tomli"]
 
 [[package]]
 name = "cryptography"
-version = "36.0.1"
+version = "37.0.2"
 description = "cryptography is a package which provides cryptographic recipes and primitives to Python developers."
 category = "main"
 optional = false
@@ -324,7 +315,7 @@ docstest = ["pyenchant (>=1.6.11)", "twine (>=1.12.0)", "sphinxcontrib-spelling
 pep8test = ["black", "flake8", "flake8-import-order", "pep8-naming"]
 sdist = ["setuptools_rust (>=0.11.4)"]
 ssh = ["bcrypt (>=3.1.5)"]
-test = ["pytest (>=6.2.0)", "pytest-cov", "pytest-subtests", "pytest-xdist", "pretend", "iso8601", "pytz", "hypothesis (>=1.11.4,!=3.79.2)"]
+test = ["pytest (>=6.2.0)", "pytest-benchmark", "pytest-cov", "pytest-subtests", "pytest-xdist", "pretend", "iso8601", "pytz", "hypothesis (>=1.11.4,!=3.79.2)"]
 
 [[package]]
 name = "cx-freeze"
@@ -346,9 +337,34 @@ category = "dev"
 optional = false
 python-versions = "*"
 
+[[package]]
+name = "deprecated"
+version = "1.2.13"
+description = "Python @deprecated decorator to deprecate old python classes, functions or methods."
+category = "main"
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
+
+[package.dependencies]
+wrapt = ">=1.10,<2"
+
+[package.extras]
+dev = ["tox", "bump2version (<1)", "sphinx (<2)", "importlib-metadata (<3)", "importlib-resources (<4)", "configparser (<5)", "sphinxcontrib-websupport (<2)", "zipp (<2)", "PyTest (<5)", "PyTest-Cov (<2.6)", "pytest", "pytest-cov"]
+
+[[package]]
+name = "dill"
+version = "0.3.5.1"
+description = "serialize all of python"
+category = "dev"
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, !=3.6.*"
+
+[package.extras]
+graph = ["objgraph (>=1.7.2)"]
+
 [[package]]
 name = "dnspython"
-version = "2.2.0"
+version = "2.2.1"
 description = "DNS toolkit"
 category = "main"
 optional = false
@@ -364,7 +380,7 @@ wmi = ["wmi (>=1.5.1,<2.0.0)"]
 
 [[package]]
 name = "docutils"
-version = "0.18.1"
+version = "0.17.1"
 description = "Docutils -- Python Documentation Utilities"
 category = "dev"
 optional = false
@@ -372,7 +388,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
 
 [[package]]
 name = "dropbox"
-version = "11.26.0"
+version = "11.31.0"
 description = "Official Dropbox API Client"
 category = "main"
 optional = false
@@ -397,7 +413,7 @@ prefixed = ">=0.3.2"
 
 [[package]]
 name = "evdev"
-version = "1.4.0"
+version = "1.5.0"
 description = "Bindings to the Linux input handling subsystem"
 category = "main"
 optional = false
@@ -451,6 +467,23 @@ category = "main"
 optional = false
 python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*"
 
+[[package]]
+name = "gazu"
+version = "0.8.28"
+description = "Gazu is a client for Zou, the API to store the data of your CG production."
+category = "main"
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
+
+[package.dependencies]
+deprecated = "1.2.13"
+python-socketio = {version = "4.6.1", extras = ["client"], markers = "python_version >= \"3.5\""}
+requests = ">=2.25.1,<=2.27.1"
+
+[package.extras]
+dev = ["wheel"]
+test = ["pytest-cov (==2.12.1)", "requests-mock (==1.9.3)", "pytest (==4.6.11)", "pytest (==6.1.2)", "pytest (==6.2.5)", "black (==21.12b0)", "pre-commit (==2.17.0)"]
+
 [[package]]
 name = "gitdb"
 version = "4.0.9"
@@ -464,7 +497,7 @@ smmap = ">=3.0.1,<6"
 
 [[package]]
 name = "gitpython"
-version = "3.1.26"
+version = "3.1.27"
 description = "GitPython is a python library used to interact with Git repositories"
 category = "dev"
 optional = false
@@ -476,7 +509,7 @@ typing-extensions = {version = ">=3.7.4.3", markers = "python_version < \"3.8\""
 
 [[package]]
 name = "google-api-core"
-version = "2.4.0"
+version = "2.8.1"
 description = "Google API client core library"
 category = "main"
 optional = false
@@ -484,18 +517,18 @@ python-versions = ">=3.6"
 
 [package.dependencies]
 google-auth = ">=1.25.0,<3.0dev"
-googleapis-common-protos = ">=1.52.0,<2.0dev"
-protobuf = ">=3.12.0"
+googleapis-common-protos = ">=1.56.2,<2.0dev"
+protobuf = ">=3.15.0,<4.0.0dev"
 requests = ">=2.18.0,<3.0.0dev"
 
 [package.extras]
 grpc = ["grpcio (>=1.33.2,<2.0dev)", "grpcio-status (>=1.33.2,<2.0dev)"]
-grpcgcp = ["grpcio-gcp (>=0.2.2)"]
-grpcio-gcp = ["grpcio-gcp (>=0.2.2)"]
+grpcgcp = ["grpcio-gcp (>=0.2.2,<1.0dev)"]
+grpcio-gcp = ["grpcio-gcp (>=0.2.2,<1.0dev)"]
 
 [[package]]
 name = "google-api-python-client"
-version = "1.12.10"
+version = "1.12.11"
 description = "Google API Client Library for Python"
 category = "main"
 optional = false
@@ -511,7 +544,7 @@ uritemplate = ">=3.0.0,<4dev"
 
 [[package]]
 name = "google-auth"
-version = "2.6.0"
+version = "2.7.0"
 description = "Google Authentication Library"
 category = "main"
 optional = false
@@ -525,6 +558,7 @@ six = ">=1.9.0"
 
 [package.extras]
 aiohttp = ["requests (>=2.20.0,<3.0.0dev)", "aiohttp (>=3.6.2,<4.0.0dev)"]
+enterprise_cert = ["cryptography (==36.0.2)", "pyopenssl (==22.0.0)"]
 pyopenssl = ["pyopenssl (>=20.0.0)"]
 reauth = ["pyu2f (>=0.1.5)"]
 
@@ -543,21 +577,21 @@ six = "*"
 
 [[package]]
 name = "googleapis-common-protos"
-version = "1.54.0"
+version = "1.56.2"
 description = "Common protobufs used in Google APIs"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-protobuf = ">=3.12.0"
+protobuf = ">=3.15.0,<4.0.0dev"
 
 [package.extras]
-grpc = ["grpcio (>=1.0.0)"]
+grpc = ["grpcio (>=1.0.0,<2.0.0dev)"]
 
 [[package]]
 name = "httplib2"
-version = "0.20.2"
+version = "0.20.4"
 description = "A comprehensive HTTP client library."
 category = "main"
 optional = false
@@ -568,11 +602,11 @@ pyparsing = {version = ">=2.4.2,<3.0.0 || >3.0.0,<3.0.1 || >3.0.1,<3.0.2 || >3.0
 
 [[package]]
 name = "idna"
-version = "2.10"
+version = "3.3"
 description = "Internationalized Domain Names in Applications (IDNA)"
 category = "main"
 optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
+python-versions = ">=3.5"
 
 [[package]]
 name = "imagesize"
@@ -584,7 +618,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "importlib-metadata"
-version = "4.10.1"
+version = "4.11.4"
 description = "Read metadata from Python packages"
 category = "main"
 optional = false
@@ -595,9 +629,9 @@ typing-extensions = {version = ">=3.6.4", markers = "python_version < \"3.8\""}
 zipp = ">=0.5"
 
 [package.extras]
-docs = ["sphinx", "jaraco.packaging (>=8.2)", "rst.linker (>=1.9)"]
+docs = ["sphinx", "jaraco.packaging (>=9)", "rst.linker (>=1.9)"]
 perf = ["ipython"]
-testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "packaging", "pyfakefs", "flufl.flake8", "pytest-perf (>=0.9.2)", "pytest-black (>=0.3.7)", "pytest-mypy", "importlib-resources (>=1.3)"]
+testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "packaging", "pyfakefs", "flufl.flake8", "pytest-perf (>=0.9.2)", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)", "importlib-resources (>=1.3)"]
 
 [[package]]
 name = "iniconfig"
@@ -663,7 +697,7 @@ i18n = ["Babel (>=0.8)"]
 
 [[package]]
 name = "jinxed"
-version = "1.1.0"
+version = "1.2.0"
 description = "Jinxed Terminal Library"
 category = "main"
 optional = false
@@ -777,7 +811,7 @@ pyparsing = ">=2.0.2,<3.0.5 || >3.0.5"
 
 [[package]]
 name = "paramiko"
-version = "2.10.1"
+version = "2.11.0"
 description = "SSH2 protocol library"
 category = "main"
 optional = false
@@ -809,7 +843,7 @@ testing = ["docopt", "pytest (<6.0.0)"]
 
 [[package]]
 name = "pathlib2"
-version = "2.3.6"
+version = "2.3.7.post1"
 description = "Object-oriented filesystem paths"
 category = "main"
 optional = false
@@ -820,23 +854,27 @@ six = "*"
 
 [[package]]
 name = "pillow"
-version = "9.0.1"
+version = "9.1.1"
 description = "Python Imaging Library (Fork)"
 category = "main"
 optional = false
 python-versions = ">=3.7"
 
+[package.extras]
+docs = ["olefile", "sphinx (>=2.4)", "sphinx-copybutton", "sphinx-issues (>=3.0.1)", "sphinx-removed-in", "sphinx-rtd-theme (>=1.0)", "sphinxext-opengraph"]
+tests = ["check-manifest", "coverage", "defusedxml", "markdown2", "olefile", "packaging", "pyroma", "pytest", "pytest-cov", "pytest-timeout"]
+
 [[package]]
 name = "platformdirs"
-version = "2.4.1"
+version = "2.5.2"
 description = "A small Python module for determining appropriate platform-specific dirs, e.g. a \"user data dir\"."
 category = "dev"
 optional = false
 python-versions = ">=3.7"
 
 [package.extras]
-docs = ["Sphinx (>=4)", "furo (>=2021.7.5b38)", "proselint (>=0.10.2)", "sphinx-autodoc-typehints (>=1.12)"]
-test = ["appdirs (==1.4.4)", "pytest (>=6)", "pytest-cov (>=2.7)", "pytest-mock (>=3.6)"]
+docs = ["furo (>=2021.7.5b38)", "proselint (>=0.10.2)", "sphinx-autodoc-typehints (>=1.12)", "sphinx (>=4)"]
+test = ["appdirs (==1.4.4)", "pytest-cov (>=2.7)", "pytest-mock (>=3.6)", "pytest (>=6)"]
 
 [[package]]
 name = "pluggy"
@@ -958,29 +996,33 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "pygments"
-version = "2.11.2"
+version = "2.12.0"
 description = "Pygments is a syntax highlighting package written in Python."
 category = "dev"
 optional = false
-python-versions = ">=3.5"
+python-versions = ">=3.6"
 
 [[package]]
 name = "pylint"
-version = "2.12.2"
+version = "2.13.9"
 description = "python code static checker"
 category = "dev"
 optional = false
 python-versions = ">=3.6.2"
 
 [package.dependencies]
-astroid = ">=2.9.0,<2.10"
+astroid = ">=2.11.5,<=2.12.0-dev0"
 colorama = {version = "*", markers = "sys_platform == \"win32\""}
+dill = ">=0.2"
 isort = ">=4.2.5,<6"
-mccabe = ">=0.6,<0.7"
+mccabe = ">=0.6,<0.8"
 platformdirs = ">=2.2.0"
-toml = ">=0.9.2"
+tomli = {version = ">=1.1.0", markers = "python_version < \"3.11\""}
 typing-extensions = {version = ">=3.10.0", markers = "python_version < \"3.10\""}
 
+[package.extras]
+testutil = ["gitpython (>3)"]
+
 [[package]]
 name = "pymongo"
 version = "3.12.3"
@@ -1031,7 +1073,7 @@ six = "*"
 
 [[package]]
 name = "pyobjc-core"
-version = "8.2"
+version = "8.5"
 description = "Python<->ObjC Interoperability Module"
 category = "main"
 optional = false
@@ -1039,39 +1081,39 @@ python-versions = ">=3.6"
 
 [[package]]
 name = "pyobjc-framework-applicationservices"
-version = "8.2"
+version = "8.5"
 description = "Wrappers for the framework ApplicationServices on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.2"
-pyobjc-framework-Cocoa = ">=8.2"
-pyobjc-framework-Quartz = ">=8.2"
+pyobjc-core = ">=8.5"
+pyobjc-framework-Cocoa = ">=8.5"
+pyobjc-framework-Quartz = ">=8.5"
 
 [[package]]
 name = "pyobjc-framework-cocoa"
-version = "8.2"
+version = "8.5"
 description = "Wrappers for the Cocoa frameworks on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.2"
+pyobjc-core = ">=8.5"
 
 [[package]]
 name = "pyobjc-framework-quartz"
-version = "8.2"
+version = "8.5"
 description = "Wrappers for the Quartz frameworks on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.2"
-pyobjc-framework-Cocoa = ">=8.2"
+pyobjc-core = ">=8.5"
+pyobjc-framework-Cocoa = ">=8.5"
 
 [[package]]
 name = "pyparsing"
@@ -1154,6 +1196,39 @@ python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7"
 [package.dependencies]
 six = ">=1.5"
 
+[[package]]
+name = "python-engineio"
+version = "3.14.2"
+description = "Engine.IO server"
+category = "main"
+optional = false
+python-versions = "*"
+
+[package.dependencies]
+six = ">=1.9.0"
+
+[package.extras]
+asyncio_client = ["aiohttp (>=3.4)"]
+client = ["requests (>=2.21.0)", "websocket-client (>=0.54.0)"]
+
+[[package]]
+name = "python-socketio"
+version = "4.6.1"
+description = "Socket.IO server"
+category = "main"
+optional = false
+python-versions = "*"
+
+[package.dependencies]
+python-engineio = ">=3.13.0,<4"
+requests = {version = ">=2.21.0", optional = true, markers = "extra == \"client\""}
+six = ">=1.9.0"
+websocket-client = {version = ">=0.54.0", optional = true, markers = "extra == \"client\""}
+
+[package.extras]
+asyncio_client = ["aiohttp (>=3.4)", "websockets (>=7.0)"]
+client = ["requests (>=2.21.0)", "websocket-client (>=0.54.0)"]
+
 [[package]]
 name = "python-xlib"
 version = "0.31"
@@ -1175,7 +1250,7 @@ python-versions = "*"
 
 [[package]]
 name = "pytz"
-version = "2021.3"
+version = "2022.1"
 description = "World timezone definitions, modern and historical"
 category = "dev"
 optional = false
@@ -1199,7 +1274,7 @@ python-versions = "*"
 
 [[package]]
 name = "qt.py"
-version = "1.3.6"
+version = "1.3.7"
 description = "Python 2 & 3 compatibility wrapper around all Qt bindings - PySide, PySide2, PyQt4 and PyQt5."
 category = "main"
 optional = false
@@ -1240,21 +1315,21 @@ sphinx = ">=1.3.1"
 
 [[package]]
 name = "requests"
-version = "2.25.1"
+version = "2.27.1"
 description = "Python HTTP for Humans."
 category = "main"
 optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*"
 
 [package.dependencies]
 certifi = ">=2017.4.17"
-chardet = ">=3.0.2,<5"
-idna = ">=2.5,<3"
+charset-normalizer = {version = ">=2.0.0,<2.1.0", markers = "python_version >= \"3\""}
+idna = {version = ">=2.5,<4", markers = "python_version >= \"3\""}
 urllib3 = ">=1.21.1,<1.27"
 
 [package.extras]
-security = ["pyOpenSSL (>=0.14)", "cryptography (>=1.3.4)"]
 socks = ["PySocks (>=1.5.6,!=1.5.7)", "win-inet-pton"]
+use_chardet_on_py3 = ["chardet (>=3.0.2,<5)"]
 
 [[package]]
 name = "rsa"
@@ -1269,7 +1344,7 @@ pyasn1 = ">=0.1.3"
 
 [[package]]
 name = "secretstorage"
-version = "3.3.1"
+version = "3.3.2"
 description = "Python bindings to FreeDesktop.org Secret Service API"
 category = "main"
 optional = false
@@ -1297,7 +1372,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*"
 
 [[package]]
 name = "slack-sdk"
-version = "3.13.0"
+version = "3.17.0"
 description = "The Slack API Platform SDK for Python"
 category = "main"
 optional = false
@@ -1305,7 +1380,7 @@ python-versions = ">=3.6.0"
 
 [package.extras]
 optional = ["aiodns (>1.0)", "aiohttp (>=3.7.3,<4)", "boto3 (<=2)", "SQLAlchemy (>=1,<2)", "websockets (>=10,<11)", "websocket-client (>=1,<2)"]
-testing = ["pytest (>=6.2.5,<7)", "pytest-asyncio (<1)", "Flask-Sockets (>=0.2,<1)", "Flask (>=1,<2)", "Werkzeug (<2)", "pytest-cov (>=2,<3)", "codecov (>=2,<3)", "flake8 (>=4,<5)", "black (==21.12b0)", "psutil (>=5,<6)", "databases (>=0.3)", "boto3 (<=2)", "moto (<2)"]
+testing = ["pytest (>=6.2.5,<7)", "pytest-asyncio (<1)", "Flask-Sockets (>=0.2,<1)", "Flask (>=1,<2)", "Werkzeug (<2)", "itsdangerous (==1.1.0)", "Jinja2 (==3.0.3)", "pytest-cov (>=2,<3)", "codecov (>=2,<3)", "flake8 (>=4,<5)", "black (==22.3.0)", "click (==8.0.4)", "psutil (>=5,<6)", "databases (>=0.5)", "boto3 (<=2)", "moto (>=3,<4)"]
 
 [[package]]
 name = "smmap"
@@ -1325,7 +1400,7 @@ python-versions = "*"
 
 [[package]]
 name = "speedcopy"
-version = "2.1.2"
+version = "2.1.4"
 description = "Replacement or alternative for python copyfile() utilizing server side copy on network shares for faster copying."
 category = "main"
 optional = false
@@ -1333,18 +1408,19 @@ python-versions = "*"
 
 [[package]]
 name = "sphinx"
-version = "3.5.3"
+version = "5.0.1"
 description = "Python documentation generator"
 category = "dev"
 optional = false
-python-versions = ">=3.5"
+python-versions = ">=3.6"
 
 [package.dependencies]
 alabaster = ">=0.7,<0.8"
 babel = ">=1.3"
 colorama = {version = ">=0.3.5", markers = "sys_platform == \"win32\""}
-docutils = ">=0.12"
+docutils = ">=0.14,<0.19"
 imagesize = "*"
+importlib-metadata = {version = ">=4.4", markers = "python_version < \"3.10\""}
 Jinja2 = ">=2.3"
 packaging = "*"
 Pygments = ">=2.0"
@@ -1352,19 +1428,19 @@ requests = ">=2.5.0"
 snowballstemmer = ">=1.1"
 sphinxcontrib-applehelp = "*"
 sphinxcontrib-devhelp = "*"
-sphinxcontrib-htmlhelp = "*"
+sphinxcontrib-htmlhelp = ">=2.0.0"
 sphinxcontrib-jsmath = "*"
 sphinxcontrib-qthelp = "*"
-sphinxcontrib-serializinghtml = "*"
+sphinxcontrib-serializinghtml = ">=1.1.5"
 
 [package.extras]
 docs = ["sphinxcontrib-websupport"]
-lint = ["flake8 (>=3.5.0)", "isort", "mypy (>=0.800)", "docutils-stubs"]
-test = ["pytest", "pytest-cov", "html5lib", "cython", "typed-ast"]
+lint = ["flake8 (>=3.5.0)", "isort", "mypy (>=0.950)", "docutils-stubs", "types-typed-ast", "types-requests"]
+test = ["pytest (>=4.6)", "html5lib", "cython", "typed-ast"]
 
 [[package]]
 name = "sphinx-qt-documentation"
-version = "0.3"
+version = "0.4"
 description = "Plugin for proper resolve intersphinx references for Qt elements"
 category = "dev"
 optional = false
@@ -1374,16 +1450,22 @@ python-versions = ">=3.6"
 docutils = "*"
 sphinx = "*"
 
+[package.extras]
+dev = ["pre-commit"]
+lint = ["black", "flake8", "pylint"]
+test = ["pytest (>=3.0.0)", "pytest-cov"]
+
 [[package]]
 name = "sphinx-rtd-theme"
-version = "0.5.1"
+version = "1.0.0"
 description = "Read the Docs theme for Sphinx"
 category = "dev"
 optional = false
-python-versions = "*"
+python-versions = ">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*"
 
 [package.dependencies]
-sphinx = "*"
+docutils = "<0.18"
+sphinx = ">=1.6"
 
 [package.extras]
 dev = ["transifex-client", "sphinxcontrib-httpdomain", "bump2version"]
@@ -1504,7 +1586,7 @@ python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*"
 
 [[package]]
 name = "tomli"
-version = "2.0.0"
+version = "2.0.1"
 description = "A lil' TOML parser"
 category = "dev"
 optional = false
@@ -1512,7 +1594,7 @@ python-versions = ">=3.7"
 
 [[package]]
 name = "typed-ast"
-version = "1.5.2"
+version = "1.5.4"
 description = "a fork of Python 2 and 3 ast modules with type comment support"
 category = "dev"
 optional = false
@@ -1536,14 +1618,14 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "urllib3"
-version = "1.26.8"
+version = "1.26.9"
 description = "HTTP library with thread-safe connection pooling, file post, and more."
 category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, <4"
 
 [package.extras]
-brotli = ["brotlipy (>=0.6.0)"]
+brotli = ["brotlicffi (>=0.8.0)", "brotli (>=1.0.9)", "brotlipy (>=0.6.0)"]
 secure = ["pyOpenSSL (>=0.14)", "cryptography (>=1.3.4)", "idna (>=2.0.0)", "certifi", "ipaddress"]
 socks = ["PySocks (>=1.5.6,!=1.5.7,<2.0)"]
 
@@ -1568,9 +1650,9 @@ six = "*"
 
 [[package]]
 name = "wrapt"
-version = "1.13.3"
+version = "1.14.1"
 description = "Module for decorators, wrappers and monkey patching."
-category = "dev"
+category = "main"
 optional = false
 python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7"
 
@@ -1606,20 +1688,20 @@ typing-extensions = {version = ">=3.7.4", markers = "python_version < \"3.8\""}
 
 [[package]]
 name = "zipp"
-version = "3.7.0"
+version = "3.8.0"
 description = "Backport of pathlib-compatible object wrapper for zip files"
 category = "main"
 optional = false
 python-versions = ">=3.7"
 
 [package.extras]
-docs = ["sphinx", "jaraco.packaging (>=8.2)", "rst.linker (>=1.9)"]
-testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "jaraco.itertools", "func-timeout", "pytest-black (>=0.3.7)", "pytest-mypy"]
+docs = ["sphinx", "jaraco.packaging (>=9)", "rst.linker (>=1.9)"]
+testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "jaraco.itertools", "func-timeout", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)"]
 
 [metadata]
 lock-version = "1.1"
 python-versions = "3.7.*"
-content-hash = "b02313c8255a1897b0f0617ad4884a5943696c363512921aab1cb2dd8f4fdbe0"
+content-hash = "bd8e0a03668c380c6e76c8cd6c71020692f4ea9f32de7a4f09433564faa9dad0"
 
 [metadata.files]
 acre = []
@@ -1722,8 +1804,8 @@ arrow = [
     {file = "arrow-0.17.0.tar.gz", hash = "sha256:ff08d10cda1d36c68657d6ad20d74fbea493d980f8b2d45344e00d6ed2bf6ed4"},
 ]
 astroid = [
-    {file = "astroid-2.9.3-py3-none-any.whl", hash = "sha256:506daabe5edffb7e696ad82483ad0228245a9742ed7d2d8c9cdb31537decf9f6"},
-    {file = "astroid-2.9.3.tar.gz", hash = "sha256:1efdf4e867d4d8ba4a9f6cf9ce07cd182c4c41de77f23814feb27ca93ca9d877"},
+    {file = "astroid-2.11.5-py3-none-any.whl", hash = "sha256:14ffbb4f6aa2cf474a0834014005487f7ecd8924996083ab411e7fa0b508ce0b"},
+    {file = "astroid-2.11.5.tar.gz", hash = "sha256:f4e4ec5294c4b07ac38bab9ca5ddd3914d4bf46f9006eb5c0ae755755061044e"},
 ]
 async-timeout = [
     {file = "async-timeout-4.0.2.tar.gz", hash = "sha256:2163e1640ddb52b7a8c80d0a67a08587e5d245cc9c553a74a847056bc2976b15"},
@@ -1750,28 +1832,29 @@ babel = [
     {file = "Babel-2.9.1.tar.gz", hash = "sha256:bc0c176f9f6a994582230df350aa6e05ba2ebe4b3ac317eab29d9be5d2768da0"},
 ]
 bcrypt = [
-    {file = "bcrypt-3.2.0-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:b589229207630484aefe5899122fb938a5b017b0f4349f769b8c13e78d99a8fd"},
-    {file = "bcrypt-3.2.0-cp36-abi3-macosx_10_9_x86_64.whl", hash = "sha256:c95d4cbebffafcdd28bd28bb4e25b31c50f6da605c81ffd9ad8a3d1b2ab7b1b6"},
-    {file = "bcrypt-3.2.0-cp36-abi3-manylinux1_x86_64.whl", hash = "sha256:63d4e3ff96188e5898779b6057878fecf3f11cfe6ec3b313ea09955d587ec7a7"},
-    {file = "bcrypt-3.2.0-cp36-abi3-manylinux2010_x86_64.whl", hash = "sha256:cd1ea2ff3038509ea95f687256c46b79f5fc382ad0aa3664d200047546d511d1"},
-    {file = "bcrypt-3.2.0-cp36-abi3-manylinux2014_aarch64.whl", hash = "sha256:cdcdcb3972027f83fe24a48b1e90ea4b584d35f1cc279d76de6fc4b13376239d"},
-    {file = "bcrypt-3.2.0-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:a0584a92329210fcd75eb8a3250c5a941633f8bfaf2a18f81009b097732839b7"},
-    {file = "bcrypt-3.2.0-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:56e5da069a76470679f312a7d3d23deb3ac4519991a0361abc11da837087b61d"},
-    {file = "bcrypt-3.2.0-cp36-abi3-win32.whl", hash = "sha256:a67fb841b35c28a59cebed05fbd3e80eea26e6d75851f0574a9273c80f3e9b55"},
-    {file = "bcrypt-3.2.0-cp36-abi3-win_amd64.whl", hash = "sha256:81fec756feff5b6818ea7ab031205e1d323d8943d237303baca2c5f9c7846f34"},
-    {file = "bcrypt-3.2.0.tar.gz", hash = "sha256:5b93c1726e50a93a033c36e5ca7fdcd29a5c7395af50a6892f5d9e7c6cfbfb29"},
+    {file = "bcrypt-3.2.2-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:7180d98a96f00b1050e93f5b0f556e658605dd9f524d0b0e68ae7944673f525e"},
+    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:61bae49580dce88095d669226d5076d0b9d927754cedbdf76c6c9f5099ad6f26"},
+    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:88273d806ab3a50d06bc6a2fc7c87d737dd669b76ad955f449c43095389bc8fb"},
+    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:6d2cb9d969bfca5bc08e45864137276e4c3d3d7de2b162171def3d188bf9d34a"},
+    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2b02d6bfc6336d1094276f3f588aa1225a598e27f8e3388f4db9948cb707b521"},
+    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:a2c46100e315c3a5b90fdc53e429c006c5f962529bc27e1dfd656292c20ccc40"},
+    {file = "bcrypt-3.2.2-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:7d9ba2e41e330d2af4af6b1b6ec9e6128e91343d0b4afb9282e54e5508f31baa"},
+    {file = "bcrypt-3.2.2-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:cd43303d6b8a165c29ec6756afd169faba9396a9472cdff753fe9f19b96ce2fa"},
+    {file = "bcrypt-3.2.2-cp36-abi3-win32.whl", hash = "sha256:4e029cef560967fb0cf4a802bcf4d562d3d6b4b1bf81de5ec1abbe0f1adb027e"},
+    {file = "bcrypt-3.2.2-cp36-abi3-win_amd64.whl", hash = "sha256:7ff2069240c6bbe49109fe84ca80508773a904f5a8cb960e02a977f7f519b129"},
+    {file = "bcrypt-3.2.2.tar.gz", hash = "sha256:433c410c2177057705da2a9f2cd01dd157493b2a7ac14c8593a16b3dab6b6bfb"},
 ]
 blessed = [
     {file = "blessed-1.19.1-py2.py3-none-any.whl", hash = "sha256:63b8554ae2e0e7f43749b6715c734cc8f3883010a809bf16790102563e6cf25b"},
     {file = "blessed-1.19.1.tar.gz", hash = "sha256:9a0d099695bf621d4680dd6c73f6ad547f6a3442fbdbe80c4b1daa1edbc492fc"},
 ]
 cachetools = [
-    {file = "cachetools-5.0.0-py3-none-any.whl", hash = "sha256:8fecd4203a38af17928be7b90689d8083603073622229ca7077b72d8e5a976e4"},
-    {file = "cachetools-5.0.0.tar.gz", hash = "sha256:486471dfa8799eb7ec503a8059e263db000cdda20075ce5e48903087f79d5fd6"},
+    {file = "cachetools-5.2.0-py3-none-any.whl", hash = "sha256:f9f17d2aec496a9aa6b76f53e3b614c965223c061982d434d160f930c698a9db"},
+    {file = "cachetools-5.2.0.tar.gz", hash = "sha256:6a94c6402995a99c3970cc7e4884bb60b4a8639938157eeed436098bf9831757"},
 ]
 certifi = [
-    {file = "certifi-2021.10.8-py2.py3-none-any.whl", hash = "sha256:d62a0163eb4c2344ac042ab2bdf75399a71a2d8c7d47eac2e2ee91b9d6339569"},
-    {file = "certifi-2021.10.8.tar.gz", hash = "sha256:78884e7c1d4b00ce3cea67b44566851c4343c120abd683433ce934a68ea58872"},
+    {file = "certifi-2022.5.18.1-py3-none-any.whl", hash = "sha256:f1d53542ee8cbedbe2118b5686372fb33c297fcd6379b050cca0ef13a597382a"},
+    {file = "certifi-2022.5.18.1.tar.gz", hash = "sha256:9c5705e395cd70084351dd8ad5c41e65655e08ce46f2ec9cf6c2c08390f71eb7"},
 ]
 cffi = [
     {file = "cffi-1.15.0-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:c2502a1a03b6312837279c8c1bd3ebedf6c12c4228ddbad40912d671ccc8a962"},
@@ -1825,13 +1908,9 @@ cffi = [
     {file = "cffi-1.15.0-cp39-cp39-win_amd64.whl", hash = "sha256:3773c4d81e6e818df2efbc7dd77325ca0dcb688116050fb2b3011218eda36139"},
     {file = "cffi-1.15.0.tar.gz", hash = "sha256:920f0d66a896c2d99f0adbb391f990a84091179542c205fa53ce5787aff87954"},
 ]
-chardet = [
-    {file = "chardet-4.0.0-py2.py3-none-any.whl", hash = "sha256:f864054d66fd9118f2e67044ac8981a54775ec5b67aed0441892edb553d21da5"},
-    {file = "chardet-4.0.0.tar.gz", hash = "sha256:0d6f53a15db4120f2b08c94f11e7d93d2c911ee118b6b30a04ec3ee8310179fa"},
-]
 charset-normalizer = [
-    {file = "charset-normalizer-2.0.11.tar.gz", hash = "sha256:98398a9d69ee80548c762ba991a4728bfc3836768ed226b3945908d1a688371c"},
-    {file = "charset_normalizer-2.0.11-py3-none-any.whl", hash = "sha256:2842d8f5e82a1f6aa437380934d5e1cd4fcf2003b06fed6940769c164a480a45"},
+    {file = "charset-normalizer-2.0.12.tar.gz", hash = "sha256:2857e29ff0d34db842cd7ca3230549d1a697f96ee6d3fb071cfa6c7393832597"},
+    {file = "charset_normalizer-2.0.12-py3-none-any.whl", hash = "sha256:6881edbebdb17b39b4eaaa821b438bf6eddffb4468cf344f09f89def34a8b1df"},
 ]
 click = [
     {file = "click-7.1.2-py2.py3-none-any.whl", hash = "sha256:dacca89f4bfadd5de3d7489b7c8a566eee0d3676333fbb50030263894c38c0dc"},
@@ -1854,69 +1933,71 @@ coolname = [
     {file = "coolname-1.1.0.tar.gz", hash = "sha256:410fe6ea9999bf96f2856ef0c726d5f38782bbefb7bb1aca0e91e0dc98ed09e3"},
 ]
 coverage = [
-    {file = "coverage-6.3.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:eeffd96882d8c06d31b65dddcf51db7c612547babc1c4c5db6a011abe9798525"},
-    {file = "coverage-6.3.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:621f6ea7260ea2ffdaec64fe5cb521669984f567b66f62f81445221d4754df4c"},
-    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:84f2436d6742c01136dd940ee158bfc7cf5ced3da7e4c949662b8703b5cd8145"},
-    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:de73fca6fb403dd72d4da517cfc49fcf791f74eee697d3219f6be29adf5af6ce"},
-    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:78fbb2be068a13a5d99dce9e1e7d168db880870f7bc73f876152130575bd6167"},
-    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:f5a4551dfd09c3bd12fca8144d47fe7745275adf3229b7223c2f9e29a975ebda"},
-    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:7bff3a98f63b47464480de1b5bdd80c8fade0ba2832c9381253c9b74c4153c27"},
-    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:a06c358f4aed05fa1099c39decc8022261bb07dfadc127c08cfbd1391b09689e"},
-    {file = "coverage-6.3.1-cp310-cp310-win32.whl", hash = "sha256:9fff3ff052922cb99f9e52f63f985d4f7a54f6b94287463bc66b7cdf3eb41217"},
-    {file = "coverage-6.3.1-cp310-cp310-win_amd64.whl", hash = "sha256:276b13cc085474e482566c477c25ed66a097b44c6e77132f3304ac0b039f83eb"},
-    {file = "coverage-6.3.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:56c4a409381ddd7bbff134e9756077860d4e8a583d310a6f38a2315b9ce301d0"},
-    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9eb494070aa060ceba6e4bbf44c1bc5fa97bfb883a0d9b0c9049415f9e944793"},
-    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5e15d424b8153756b7c903bde6d4610be0c3daca3986173c18dd5c1a1625e4cd"},
-    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:61d47a897c1e91f33f177c21de897267b38fbb45f2cd8e22a710bcef1df09ac1"},
-    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:25e73d4c81efa8ea3785274a2f7f3bfbbeccb6fcba2a0bdd3be9223371c37554"},
-    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:fac0bcc5b7e8169bffa87f0dcc24435446d329cbc2b5486d155c2e0f3b493ae1"},
-    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:72128176fea72012063200b7b395ed8a57849282b207321124d7ff14e26988e8"},
-    {file = "coverage-6.3.1-cp37-cp37m-win32.whl", hash = "sha256:1bc6d709939ff262fd1432f03f080c5042dc6508b6e0d3d20e61dd045456a1a0"},
-    {file = "coverage-6.3.1-cp37-cp37m-win_amd64.whl", hash = "sha256:618eeba986cea7f621d8607ee378ecc8c2504b98b3fdc4952b30fe3578304687"},
-    {file = "coverage-6.3.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:d5ed164af5c9078596cfc40b078c3b337911190d3faeac830c3f1274f26b8320"},
-    {file = "coverage-6.3.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:352c68e233409c31048a3725c446a9e48bbff36e39db92774d4f2380d630d8f8"},
-    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:448d7bde7ceb6c69e08474c2ddbc5b4cd13c9e4aa4a717467f716b5fc938a734"},
-    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9fde6b90889522c220dd56a670102ceef24955d994ff7af2cb786b4ba8fe11e4"},
-    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e647a0be741edbb529a72644e999acb09f2ad60465f80757da183528941ff975"},
-    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:6a5cdc3adb4f8bb8d8f5e64c2e9e282bc12980ef055ec6da59db562ee9bdfefa"},
-    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:2dd70a167843b4b4b2630c0c56f1b586fe965b4f8ac5da05b6690344fd065c6b"},
-    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:9ad0a117b8dc2061ce9461ea4c1b4799e55edceb236522c5b8f958ce9ed8fa9a"},
-    {file = "coverage-6.3.1-cp38-cp38-win32.whl", hash = "sha256:e92c7a5f7d62edff50f60a045dc9542bf939758c95b2fcd686175dd10ce0ed10"},
-    {file = "coverage-6.3.1-cp38-cp38-win_amd64.whl", hash = "sha256:482fb42eea6164894ff82abbcf33d526362de5d1a7ed25af7ecbdddd28fc124f"},
-    {file = "coverage-6.3.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:c5b81fb37db76ebea79aa963b76d96ff854e7662921ce742293463635a87a78d"},
-    {file = "coverage-6.3.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:a4f923b9ab265136e57cc14794a15b9dcea07a9c578609cd5dbbfff28a0d15e6"},
-    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:56d296cbc8254a7dffdd7bcc2eb70be5a233aae7c01856d2d936f5ac4e8ac1f1"},
-    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1245ab82e8554fa88c4b2ab1e098ae051faac5af829efdcf2ce6b34dccd5567c"},
-    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f2b05757c92ad96b33dbf8e8ec8d4ccb9af6ae3c9e9bd141c7cc44d20c6bcba"},
-    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:9e3dd806f34de38d4c01416344e98eab2437ac450b3ae39c62a0ede2f8b5e4ed"},
-    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:d651fde74a4d3122e5562705824507e2f5b2d3d57557f1916c4b27635f8fbe3f"},
-    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:704f89b87c4f4737da2860695a18c852b78ec7279b24eedacab10b29067d3a38"},
-    {file = "coverage-6.3.1-cp39-cp39-win32.whl", hash = "sha256:2aed4761809640f02e44e16b8b32c1a5dee5e80ea30a0ff0912158bde9c501f2"},
-    {file = "coverage-6.3.1-cp39-cp39-win_amd64.whl", hash = "sha256:9976fb0a5709988778ac9bc44f3d50fccd989987876dfd7716dee28beed0a9fa"},
-    {file = "coverage-6.3.1-pp36.pp37.pp38-none-any.whl", hash = "sha256:463e52616ea687fd323888e86bf25e864a3cc6335a043fad6bbb037dbf49bbe2"},
-    {file = "coverage-6.3.1.tar.gz", hash = "sha256:6c3f6158b02ac403868eea390930ae64e9a9a2a5bbfafefbb920d29258d9f2f8"},
+    {file = "coverage-6.4.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:f1d5aa2703e1dab4ae6cf416eb0095304f49d004c39e9db1d86f57924f43006b"},
+    {file = "coverage-6.4.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:4ce1b258493cbf8aec43e9b50d89982346b98e9ffdfaae8ae5793bc112fb0068"},
+    {file = "coverage-6.4.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:83c4e737f60c6936460c5be330d296dd5b48b3963f48634c53b3f7deb0f34ec4"},
+    {file = "coverage-6.4.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:84e65ef149028516c6d64461b95a8dbcfce95cfd5b9eb634320596173332ea84"},
+    {file = "coverage-6.4.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f69718750eaae75efe506406c490d6fc5a6161d047206cc63ce25527e8a3adad"},
+    {file = "coverage-6.4.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:e57816f8ffe46b1df8f12e1b348f06d164fd5219beba7d9433ba79608ef011cc"},
+    {file = "coverage-6.4.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:01c5615d13f3dd3aa8543afc069e5319cfa0c7d712f6e04b920431e5c564a749"},
+    {file = "coverage-6.4.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:75ab269400706fab15981fd4bd5080c56bd5cc07c3bccb86aab5e1d5a88dc8f4"},
+    {file = "coverage-6.4.1-cp310-cp310-win32.whl", hash = "sha256:a7f3049243783df2e6cc6deafc49ea123522b59f464831476d3d1448e30d72df"},
+    {file = "coverage-6.4.1-cp310-cp310-win_amd64.whl", hash = "sha256:ee2ddcac99b2d2aec413e36d7a429ae9ebcadf912946b13ffa88e7d4c9b712d6"},
+    {file = "coverage-6.4.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:fb73e0011b8793c053bfa85e53129ba5f0250fdc0392c1591fd35d915ec75c46"},
+    {file = "coverage-6.4.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:106c16dfe494de3193ec55cac9640dd039b66e196e4641fa8ac396181578b982"},
+    {file = "coverage-6.4.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:87f4f3df85aa39da00fd3ec4b5abeb7407e82b68c7c5ad181308b0e2526da5d4"},
+    {file = "coverage-6.4.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:961e2fb0680b4f5ad63234e0bf55dfb90d302740ae9c7ed0120677a94a1590cb"},
+    {file = "coverage-6.4.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:cec3a0f75c8f1031825e19cd86ee787e87cf03e4fd2865c79c057092e69e3a3b"},
+    {file = "coverage-6.4.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:129cd05ba6f0d08a766d942a9ed4b29283aff7b2cccf5b7ce279d50796860bb3"},
+    {file = "coverage-6.4.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:bf5601c33213d3cb19d17a796f8a14a9eaa5e87629a53979a5981e3e3ae166f6"},
+    {file = "coverage-6.4.1-cp37-cp37m-win32.whl", hash = "sha256:269eaa2c20a13a5bf17558d4dc91a8d078c4fa1872f25303dddcbba3a813085e"},
+    {file = "coverage-6.4.1-cp37-cp37m-win_amd64.whl", hash = "sha256:f02cbbf8119db68455b9d763f2f8737bb7db7e43720afa07d8eb1604e5c5ae28"},
+    {file = "coverage-6.4.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:ffa9297c3a453fba4717d06df579af42ab9a28022444cae7fa605af4df612d54"},
+    {file = "coverage-6.4.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:145f296d00441ca703a659e8f3eb48ae39fb083baba2d7ce4482fb2723e050d9"},
+    {file = "coverage-6.4.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d67d44996140af8b84284e5e7d398e589574b376fb4de8ccd28d82ad8e3bea13"},
+    {file = "coverage-6.4.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2bd9a6fc18aab8d2e18f89b7ff91c0f34ff4d5e0ba0b33e989b3cd4194c81fd9"},
+    {file = "coverage-6.4.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3384f2a3652cef289e38100f2d037956194a837221edd520a7ee5b42d00cc605"},
+    {file = "coverage-6.4.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:9b3e07152b4563722be523e8cd0b209e0d1a373022cfbde395ebb6575bf6790d"},
+    {file = "coverage-6.4.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:1480ff858b4113db2718848d7b2d1b75bc79895a9c22e76a221b9d8d62496428"},
+    {file = "coverage-6.4.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:865d69ae811a392f4d06bde506d531f6a28a00af36f5c8649684a9e5e4a85c83"},
+    {file = "coverage-6.4.1-cp38-cp38-win32.whl", hash = "sha256:664a47ce62fe4bef9e2d2c430306e1428ecea207ffd68649e3b942fa8ea83b0b"},
+    {file = "coverage-6.4.1-cp38-cp38-win_amd64.whl", hash = "sha256:26dff09fb0d82693ba9e6231248641d60ba606150d02ed45110f9ec26404ed1c"},
+    {file = "coverage-6.4.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:d9c80df769f5ec05ad21ea34be7458d1dc51ff1fb4b2219e77fe24edf462d6df"},
+    {file = "coverage-6.4.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:39ee53946bf009788108b4dd2894bf1349b4e0ca18c2016ffa7d26ce46b8f10d"},
+    {file = "coverage-6.4.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f5b66caa62922531059bc5ac04f836860412f7f88d38a476eda0a6f11d4724f4"},
+    {file = "coverage-6.4.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:fd180ed867e289964404051a958f7cccabdeed423f91a899829264bb7974d3d3"},
+    {file = "coverage-6.4.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:84631e81dd053e8a0d4967cedab6db94345f1c36107c71698f746cb2636c63e3"},
+    {file = "coverage-6.4.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:8c08da0bd238f2970230c2a0d28ff0e99961598cb2e810245d7fc5afcf1254e8"},
+    {file = "coverage-6.4.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:d42c549a8f41dc103a8004b9f0c433e2086add8a719da00e246e17cbe4056f72"},
+    {file = "coverage-6.4.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:309ce4a522ed5fca432af4ebe0f32b21d6d7ccbb0f5fcc99290e71feba67c264"},
+    {file = "coverage-6.4.1-cp39-cp39-win32.whl", hash = "sha256:fdb6f7bd51c2d1714cea40718f6149ad9be6a2ee7d93b19e9f00934c0f2a74d9"},
+    {file = "coverage-6.4.1-cp39-cp39-win_amd64.whl", hash = "sha256:342d4aefd1c3e7f620a13f4fe563154d808b69cccef415415aece4c786665397"},
+    {file = "coverage-6.4.1-pp36.pp37.pp38-none-any.whl", hash = "sha256:4803e7ccf93230accb928f3a68f00ffa80a88213af98ed338a57ad021ef06815"},
+    {file = "coverage-6.4.1.tar.gz", hash = "sha256:4321f075095a096e70aff1d002030ee612b65a205a0a0f5b815280d5dc58100c"},
 ]
 cryptography = [
-    {file = "cryptography-36.0.1-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:73bc2d3f2444bcfeac67dd130ff2ea598ea5f20b40e36d19821b4df8c9c5037b"},
-    {file = "cryptography-36.0.1-cp36-abi3-macosx_10_10_x86_64.whl", hash = "sha256:2d87cdcb378d3cfed944dac30596da1968f88fb96d7fc34fdae30a99054b2e31"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:74d6c7e80609c0f4c2434b97b80c7f8fdfaa072ca4baab7e239a15d6d70ed73a"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:6c0c021f35b421ebf5976abf2daacc47e235f8b6082d3396a2fe3ccd537ab173"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5d59a9d55027a8b88fd9fd2826c4392bd487d74bf628bb9d39beecc62a644c12"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0a817b961b46894c5ca8a66b599c745b9a3d9f822725221f0e0fe49dc043a3a3"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_24_x86_64.whl", hash = "sha256:94ae132f0e40fe48f310bba63f477f14a43116f05ddb69d6fa31e93f05848ae2"},
-    {file = "cryptography-36.0.1-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:7be0eec337359c155df191d6ae00a5e8bbb63933883f4f5dffc439dac5348c3f"},
-    {file = "cryptography-36.0.1-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:e0344c14c9cb89e76eb6a060e67980c9e35b3f36691e15e1b7a9e58a0a6c6dc3"},
-    {file = "cryptography-36.0.1-cp36-abi3-win32.whl", hash = "sha256:4caa4b893d8fad33cf1964d3e51842cd78ba87401ab1d2e44556826df849a8ca"},
-    {file = "cryptography-36.0.1-cp36-abi3-win_amd64.whl", hash = "sha256:391432971a66cfaf94b21c24ab465a4cc3e8bf4a939c1ca5c3e3a6e0abebdbcf"},
-    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:bb5829d027ff82aa872d76158919045a7c1e91fbf241aec32cb07956e9ebd3c9"},
-    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ebc15b1c22e55c4d5566e3ca4db8689470a0ca2babef8e3a9ee057a8b82ce4b1"},
-    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:596f3cd67e1b950bc372c33f1a28a0692080625592ea6392987dba7f09f17a94"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:30ee1eb3ebe1644d1c3f183d115a8c04e4e603ed6ce8e394ed39eea4a98469ac"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:ec63da4e7e4a5f924b90af42eddf20b698a70e58d86a72d943857c4c6045b3ee"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ca238ceb7ba0bdf6ce88c1b74a87bffcee5afbfa1e41e173b1ceb095b39add46"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:ca28641954f767f9822c24e927ad894d45d5a1e501767599647259cbf030b903"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:39bdf8e70eee6b1c7b289ec6e5d84d49a6bfa11f8b8646b5b3dfe41219153316"},
-    {file = "cryptography-36.0.1.tar.gz", hash = "sha256:53e5c1dc3d7a953de055d77bef2ff607ceef7a2aac0353b5d630ab67f7423638"},
+    {file = "cryptography-37.0.2-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:ef15c2df7656763b4ff20a9bc4381d8352e6640cfeb95c2972c38ef508e75181"},
+    {file = "cryptography-37.0.2-cp36-abi3-macosx_10_10_x86_64.whl", hash = "sha256:3c81599befb4d4f3d7648ed3217e00d21a9341a9a688ecdd615ff72ffbed7336"},
+    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:2bd1096476aaac820426239ab534b636c77d71af66c547b9ddcd76eb9c79e004"},
+    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:31fe38d14d2e5f787e0aecef831457da6cec68e0bb09a35835b0b44ae8b988fe"},
+    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:093cb351031656d3ee2f4fa1be579a8c69c754cf874206be1d4cf3b542042804"},
+    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:59b281eab51e1b6b6afa525af2bd93c16d49358404f814fe2c2410058623928c"},
+    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_24_x86_64.whl", hash = "sha256:0cc20f655157d4cfc7bada909dc5cc228211b075ba8407c46467f63597c78178"},
+    {file = "cryptography-37.0.2-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:f8ec91983e638a9bcd75b39f1396e5c0dc2330cbd9ce4accefe68717e6779e0a"},
+    {file = "cryptography-37.0.2-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:46f4c544f6557a2fefa7ac8ac7d1b17bf9b647bd20b16decc8fbcab7117fbc15"},
+    {file = "cryptography-37.0.2-cp36-abi3-win32.whl", hash = "sha256:731c8abd27693323b348518ed0e0705713a36d79fdbd969ad968fbef0979a7e0"},
+    {file = "cryptography-37.0.2-cp36-abi3-win_amd64.whl", hash = "sha256:471e0d70201c069f74c837983189949aa0d24bb2d751b57e26e3761f2f782b8d"},
+    {file = "cryptography-37.0.2-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a68254dd88021f24a68b613d8c51d5c5e74d735878b9e32cc0adf19d1f10aaf9"},
+    {file = "cryptography-37.0.2-pp37-pypy37_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:a7d5137e556cc0ea418dca6186deabe9129cee318618eb1ffecbd35bee55ddc1"},
+    {file = "cryptography-37.0.2-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:aeaba7b5e756ea52c8861c133c596afe93dd716cbcacae23b80bc238202dc023"},
+    {file = "cryptography-37.0.2-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:95e590dd70642eb2079d280420a888190aa040ad20f19ec8c6e097e38aa29e06"},
+    {file = "cryptography-37.0.2-pp38-pypy38_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:1b9362d34363f2c71b7853f6251219298124aa4cc2075ae2932e64c91a3e2717"},
+    {file = "cryptography-37.0.2-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:e53258e69874a306fcecb88b7534d61820db8a98655662a3dd2ec7f1afd9132f"},
+    {file = "cryptography-37.0.2-pp39-pypy39_pp73-macosx_10_10_x86_64.whl", hash = "sha256:1f3bfbd611db5cb58ca82f3deb35e83af34bb8cf06043fa61500157d50a70982"},
+    {file = "cryptography-37.0.2-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:419c57d7b63f5ec38b1199a9521d77d7d1754eb97827bbb773162073ccd8c8d4"},
+    {file = "cryptography-37.0.2-pp39-pypy39_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:dc26bb134452081859aa21d4990474ddb7e863aa39e60d1592800a8865a702de"},
+    {file = "cryptography-37.0.2-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:3b8398b3d0efc420e777c40c16764d6870bcef2eb383df9c6dbb9ffe12c64452"},
+    {file = "cryptography-37.0.2.tar.gz", hash = "sha256:f224ad253cc9cea7568f49077007d2263efa57396a2f2f78114066fd54b5c68e"},
 ]
 cx-freeze = [
     {file = "cx_Freeze-6.9-cp310-cp310-win32.whl", hash = "sha256:776d4fb68a4831691acbd3c374362b9b48ce2e568514a73c3d4cb14d5dcf1470"},
@@ -1946,25 +2027,33 @@ cx-logging = [
     {file = "cx_Logging-3.0-cp39-cp39-win_amd64.whl", hash = "sha256:302e9c4f65a936c288a4fa59a90e7e142d9ef994aa29676731acafdcccdbb3f5"},
     {file = "cx_Logging-3.0.tar.gz", hash = "sha256:ba8a7465facf7b98d8f494030fb481a2e8aeee29dc191e10383bb54ed42bdb34"},
 ]
+deprecated = [
+    {file = "Deprecated-1.2.13-py2.py3-none-any.whl", hash = "sha256:64756e3e14c8c5eea9795d93c524551432a0be75629f8f29e67ab8caf076c76d"},
+    {file = "Deprecated-1.2.13.tar.gz", hash = "sha256:43ac5335da90c31c24ba028af536a91d41d53f9e6901ddb021bcc572ce44e38d"},
+]
+dill = [
+    {file = "dill-0.3.5.1-py2.py3-none-any.whl", hash = "sha256:33501d03270bbe410c72639b350e941882a8b0fd55357580fbc873fba0c59302"},
+    {file = "dill-0.3.5.1.tar.gz", hash = "sha256:d75e41f3eff1eee599d738e76ba8f4ad98ea229db8b085318aa2b3333a208c86"},
+]
 dnspython = [
-    {file = "dnspython-2.2.0-py3-none-any.whl", hash = "sha256:081649da27ced5e75709a1ee542136eaba9842a0fe4c03da4fb0a3d3ed1f3c44"},
-    {file = "dnspython-2.2.0.tar.gz", hash = "sha256:e79351e032d0b606b98d38a4b0e6e2275b31a5b85c873e587cc11b73aca026d6"},
+    {file = "dnspython-2.2.1-py3-none-any.whl", hash = "sha256:a851e51367fb93e9e1361732c1d60dab63eff98712e503ea7d92e6eccb109b4f"},
+    {file = "dnspython-2.2.1.tar.gz", hash = "sha256:0f7569a4a6ff151958b64304071d370daa3243d15941a7beedf0c9fe5105603e"},
 ]
 docutils = [
-    {file = "docutils-0.18.1-py2.py3-none-any.whl", hash = "sha256:23010f129180089fbcd3bc08cfefccb3b890b0050e1ca00c867036e9d161b98c"},
-    {file = "docutils-0.18.1.tar.gz", hash = "sha256:679987caf361a7539d76e584cbeddc311e3aee937877c87346f31debc63e9d06"},
+    {file = "docutils-0.17.1-py2.py3-none-any.whl", hash = "sha256:cf316c8370a737a022b72b56874f6602acf974a37a9fba42ec2876387549fc61"},
+    {file = "docutils-0.17.1.tar.gz", hash = "sha256:686577d2e4c32380bb50cbb22f575ed742d58168cee37e99117a854bcd88f125"},
 ]
 dropbox = [
-    {file = "dropbox-11.26.0-py2-none-any.whl", hash = "sha256:abd29587fa692bde0c3a48ce8efb56c24d8df92c5f402bbcdd78f3089d5ced5c"},
-    {file = "dropbox-11.26.0-py3-none-any.whl", hash = "sha256:84becf043a63007ae67620946acb0fa164669ce691c7f1dbfdabb6712a258b29"},
-    {file = "dropbox-11.26.0.tar.gz", hash = "sha256:dd79e3dfc216688020959462aefac54ffce7c07a45e89f4fb258348885195a73"},
+    {file = "dropbox-11.31.0-py2-none-any.whl", hash = "sha256:393a99dfe30d42fd73c265b9b7d24bb21c9a961739cd097c3541e709eb2a209c"},
+    {file = "dropbox-11.31.0-py3-none-any.whl", hash = "sha256:5f924102fd6464def81573320c6aa4ea9cd3368e1b1c13d838403dd4c9ffc919"},
+    {file = "dropbox-11.31.0.tar.gz", hash = "sha256:f483d65b702775b9abf7b9328f702c68c6397fc01770477c6ddbfb1d858a5bcf"},
 ]
 enlighten = [
     {file = "enlighten-1.10.2-py2.py3-none-any.whl", hash = "sha256:b237fe562b320bf9f1d4bb76d0c98e0daf914372a76ab87c35cd02f57aa9d8c1"},
     {file = "enlighten-1.10.2.tar.gz", hash = "sha256:7a5b83cd0f4d095e59d80c648ebb5f7ffca0cd8bcf7ae6639828ee1ad000632a"},
 ]
 evdev = [
-    {file = "evdev-1.4.0.tar.gz", hash = "sha256:8782740eb1a86b187334c07feb5127d3faa0b236e113206dfe3ae8f77fb1aaf1"},
+    {file = "evdev-1.5.0.tar.gz", hash = "sha256:5b33b174f7c84576e7dd6071e438bf5ad227da95efd4356a39fe4c8355412fe6"},
 ]
 flake8 = [
     {file = "flake8-3.9.2-py2.py3-none-any.whl", hash = "sha256:bf8fd333346d844f616e8d47905ef3a3384edae6b4e9beb0c5101e25e3110907"},
@@ -2038,49 +2127,52 @@ ftrack-python-api = [
 future = [
     {file = "future-0.18.2.tar.gz", hash = "sha256:b1bead90b70cf6ec3f0710ae53a525360fa360d306a86583adc6bf83a4db537d"},
 ]
+gazu = [
+    {file = "gazu-0.8.28-py2.py3-none-any.whl", hash = "sha256:ec4f7c2688a2b37ee8a77737e4e30565ad362428c3ade9046136a998c043e51c"},
+]
 gitdb = [
     {file = "gitdb-4.0.9-py3-none-any.whl", hash = "sha256:8033ad4e853066ba6ca92050b9df2f89301b8fc8bf7e9324d412a63f8bf1a8fd"},
     {file = "gitdb-4.0.9.tar.gz", hash = "sha256:bac2fd45c0a1c9cf619e63a90d62bdc63892ef92387424b855792a6cabe789aa"},
 ]
 gitpython = [
-    {file = "GitPython-3.1.26-py3-none-any.whl", hash = "sha256:26ac35c212d1f7b16036361ca5cff3ec66e11753a0d677fb6c48fa4e1a9dd8d6"},
-    {file = "GitPython-3.1.26.tar.gz", hash = "sha256:fc8868f63a2e6d268fb25f481995ba185a85a66fcad126f039323ff6635669ee"},
+    {file = "GitPython-3.1.27-py3-none-any.whl", hash = "sha256:5b68b000463593e05ff2b261acff0ff0972df8ab1b70d3cdbd41b546c8b8fc3d"},
+    {file = "GitPython-3.1.27.tar.gz", hash = "sha256:1c885ce809e8ba2d88a29befeb385fcea06338d3640712b59ca623c220bb5704"},
 ]
 google-api-core = [
-    {file = "google-api-core-2.4.0.tar.gz", hash = "sha256:ba8787b7c61632cd0340f095e1c036bef9426b2594f10afb290ba311ae8cb2cb"},
-    {file = "google_api_core-2.4.0-py2.py3-none-any.whl", hash = "sha256:58e2c1171a3d51778bf4e428fbb4bf79cbd05007b4b44deaa80cf73c80eebc0f"},
+    {file = "google-api-core-2.8.1.tar.gz", hash = "sha256:958024c6aa3460b08f35741231076a4dd9a4c819a6a39d44da9627febe8b28f0"},
+    {file = "google_api_core-2.8.1-py3-none-any.whl", hash = "sha256:ce1daa49644b50398093d2a9ad886501aa845e2602af70c3001b9f402a9d7359"},
 ]
 google-api-python-client = [
-    {file = "google-api-python-client-1.12.10.tar.gz", hash = "sha256:1cb773647e7d97048d9d1c7fa746247fbad39fd1a3b5040f2cb2645dd7156b11"},
-    {file = "google_api_python_client-1.12.10-py2.py3-none-any.whl", hash = "sha256:5a8742b9b604b34e13462cc3d6aedbbf11d3af1ef558eb95defe74a29ebc5c28"},
+    {file = "google-api-python-client-1.12.11.tar.gz", hash = "sha256:1b4bd42a46321e13c0542a9e4d96fa05d73626f07b39f83a73a947d70ca706a9"},
+    {file = "google_api_python_client-1.12.11-py2.py3-none-any.whl", hash = "sha256:7e0a1a265c8d3088ee1987778c72683fcb376e32bada8d7767162bd9c503fd9b"},
 ]
 google-auth = [
-    {file = "google-auth-2.6.0.tar.gz", hash = "sha256:ad160fc1ea8f19e331a16a14a79f3d643d813a69534ba9611d2c80dc10439dad"},
-    {file = "google_auth-2.6.0-py2.py3-none-any.whl", hash = "sha256:218ca03d7744ca0c8b6697b6083334be7df49b7bf76a69d555962fd1a7657b5f"},
+    {file = "google-auth-2.7.0.tar.gz", hash = "sha256:8a954960f852d5f19e6af14dd8e75c20159609e85d8db37e4013cc8c3824a7e1"},
+    {file = "google_auth-2.7.0-py2.py3-none-any.whl", hash = "sha256:df549a1433108801b11bdcc0e312eaf0d5f0500db42f0523e4d65c78722e8475"},
 ]
 google-auth-httplib2 = [
     {file = "google-auth-httplib2-0.1.0.tar.gz", hash = "sha256:a07c39fd632becacd3f07718dfd6021bf396978f03ad3ce4321d060015cc30ac"},
     {file = "google_auth_httplib2-0.1.0-py2.py3-none-any.whl", hash = "sha256:31e49c36c6b5643b57e82617cb3e021e3e1d2df9da63af67252c02fa9c1f4a10"},
 ]
 googleapis-common-protos = [
-    {file = "googleapis-common-protos-1.54.0.tar.gz", hash = "sha256:a4031d6ec6c2b1b6dc3e0be7e10a1bd72fb0b18b07ef9be7b51f2c1004ce2437"},
-    {file = "googleapis_common_protos-1.54.0-py2.py3-none-any.whl", hash = "sha256:e54345a2add15dc5e1a7891c27731ff347b4c33765d79b5ed7026a6c0c7cbcae"},
+    {file = "googleapis-common-protos-1.56.2.tar.gz", hash = "sha256:b09b56f5463070c2153753ef123f07d2e49235e89148e9b2459ec8ed2f68d7d3"},
+    {file = "googleapis_common_protos-1.56.2-py2.py3-none-any.whl", hash = "sha256:023eaea9d8c1cceccd9587c6af6c20f33eeeb05d4148670f2b0322dc1511700c"},
 ]
 httplib2 = [
-    {file = "httplib2-0.20.2-py3-none-any.whl", hash = "sha256:6b937120e7d786482881b44b8eec230c1ee1c5c1d06bce8cc865f25abbbf713b"},
-    {file = "httplib2-0.20.2.tar.gz", hash = "sha256:e404681d2fbcec7506bcb52c503f2b021e95bee0ef7d01e5c221468a2406d8dc"},
+    {file = "httplib2-0.20.4-py3-none-any.whl", hash = "sha256:8b6a905cb1c79eefd03f8669fd993c36dc341f7c558f056cb5a33b5c2f458543"},
+    {file = "httplib2-0.20.4.tar.gz", hash = "sha256:58a98e45b4b1a48273073f905d2961666ecf0fbac4250ea5b47aef259eb5c585"},
 ]
 idna = [
-    {file = "idna-2.10-py2.py3-none-any.whl", hash = "sha256:b97d804b1e9b523befed77c48dacec60e6dcb0b5391d57af6a65a312a90648c0"},
-    {file = "idna-2.10.tar.gz", hash = "sha256:b307872f855b18632ce0c21c5e45be78c0ea7ae4c15c828c20788b26921eb3f6"},
+    {file = "idna-3.3-py3-none-any.whl", hash = "sha256:84d9dd047ffa80596e0f246e2eab0b391788b0503584e8945f2368256d2735ff"},
+    {file = "idna-3.3.tar.gz", hash = "sha256:9d643ff0a55b762d5cdb124b8eaa99c66322e2157b69160bc32796e824360e6d"},
 ]
 imagesize = [
     {file = "imagesize-1.3.0-py2.py3-none-any.whl", hash = "sha256:1db2f82529e53c3e929e8926a1fa9235aa82d0bd0c580359c67ec31b2fddaa8c"},
     {file = "imagesize-1.3.0.tar.gz", hash = "sha256:cd1750d452385ca327479d45b64d9c7729ecf0b3969a58148298c77092261f9d"},
 ]
 importlib-metadata = [
-    {file = "importlib_metadata-4.10.1-py3-none-any.whl", hash = "sha256:899e2a40a8c4a1aec681feef45733de8a6c58f3f6a0dbed2eb6574b4387a77b6"},
-    {file = "importlib_metadata-4.10.1.tar.gz", hash = "sha256:951f0d8a5b7260e9db5e41d429285b5f451e928479f19d80818878527d36e95e"},
+    {file = "importlib_metadata-4.11.4-py3-none-any.whl", hash = "sha256:c58c8eb8a762858f49e18436ff552e83914778e50e9d2f1660535ffb364552ec"},
+    {file = "importlib_metadata-4.11.4.tar.gz", hash = "sha256:5d26852efe48c0a32b0509ffbc583fda1a2266545a78d104a6f4aff3db17d700"},
 ]
 iniconfig = [
     {file = "iniconfig-1.1.1-py2.py3-none-any.whl", hash = "sha256:011e24c64b7f47f6ebd835bb12a743f2fbe9a26d4cecaa7f53bc4f35ee9da8b3"},
@@ -2103,8 +2195,8 @@ jinja2 = [
     {file = "Jinja2-2.11.3.tar.gz", hash = "sha256:a6d58433de0ae800347cab1fa3043cebbabe8baa9d29e668f1c768cb87a333c6"},
 ]
 jinxed = [
-    {file = "jinxed-1.1.0-py2.py3-none-any.whl", hash = "sha256:6a61ccf963c16aa885304f27e6e5693783676897cea0c7f223270c8b8e78baf8"},
-    {file = "jinxed-1.1.0.tar.gz", hash = "sha256:d8f1731f134e9e6b04d95095845ae6c10eb15cb223a5f0cabdea87d4a279c305"},
+    {file = "jinxed-1.2.0-py2.py3-none-any.whl", hash = "sha256:cfc2b2e4e3b4326954d546ba6d6b9a7a796ddcb0aef8d03161d005177eb0d48b"},
+    {file = "jinxed-1.2.0.tar.gz", hash = "sha256:032acda92d5c57cd216033cbbd53de731e6ed50deb63eb4781336ca55f72cda5"},
 ]
 jsonschema = [
     {file = "jsonschema-2.6.0-py2.py3-none-any.whl", hash = "sha256:000e68abd33c972a5248544925a0cae7d1125f9bf6c58280d37546b946769a08"},
@@ -2298,57 +2390,60 @@ packaging = [
     {file = "packaging-21.3.tar.gz", hash = "sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb"},
 ]
 paramiko = [
-    {file = "paramiko-2.10.1-py2.py3-none-any.whl", hash = "sha256:f6cbd3e1204abfdbcd40b3ecbc9d32f04027cd3080fe666245e21e7540ccfc1b"},
-    {file = "paramiko-2.10.1.tar.gz", hash = "sha256:443f4da23ec24e9a9c0ea54017829c282abdda1d57110bf229360775ccd27a31"},
+    {file = "paramiko-2.11.0-py2.py3-none-any.whl", hash = "sha256:655f25dc8baf763277b933dfcea101d636581df8d6b9774d1fb653426b72c270"},
+    {file = "paramiko-2.11.0.tar.gz", hash = "sha256:003e6bee7c034c21fbb051bf83dc0a9ee4106204dd3c53054c71452cc4ec3938"},
 ]
 parso = [
     {file = "parso-0.8.3-py2.py3-none-any.whl", hash = "sha256:c001d4636cd3aecdaf33cbb40aebb59b094be2a74c556778ef5576c175e19e75"},
     {file = "parso-0.8.3.tar.gz", hash = "sha256:8c07be290bb59f03588915921e29e8a50002acaf2cdc5fa0e0114f91709fafa0"},
 ]
 pathlib2 = [
-    {file = "pathlib2-2.3.6-py2.py3-none-any.whl", hash = "sha256:3a130b266b3a36134dcc79c17b3c7ac9634f083825ca6ea9d8f557ee6195c9c8"},
-    {file = "pathlib2-2.3.6.tar.gz", hash = "sha256:7d8bcb5555003cdf4a8d2872c538faa3a0f5d20630cb360e518ca3b981795e5f"},
+    {file = "pathlib2-2.3.7.post1-py2.py3-none-any.whl", hash = "sha256:5266a0fd000452f1b3467d782f079a4343c63aaa119221fbdc4e39577489ca5b"},
+    {file = "pathlib2-2.3.7.post1.tar.gz", hash = "sha256:9fe0edad898b83c0c3e199c842b27ed216645d2e177757b2dd67384d4113c641"},
 ]
 pillow = [
-    {file = "Pillow-9.0.1-1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:a5d24e1d674dd9d72c66ad3ea9131322819ff86250b30dc5821cbafcfa0b96b4"},
-    {file = "Pillow-9.0.1-1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:2632d0f846b7c7600edf53c48f8f9f1e13e62f66a6dbc15191029d950bfed976"},
-    {file = "Pillow-9.0.1-1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:b9618823bd237c0d2575283f2939655f54d51b4527ec3972907a927acbcc5bfc"},
-    {file = "Pillow-9.0.1-cp310-cp310-macosx_10_10_universal2.whl", hash = "sha256:9bfdb82cdfeccec50aad441afc332faf8606dfa5e8efd18a6692b5d6e79f00fd"},
-    {file = "Pillow-9.0.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:5100b45a4638e3c00e4d2320d3193bdabb2d75e79793af7c3eb139e4f569f16f"},
-    {file = "Pillow-9.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:528a2a692c65dd5cafc130de286030af251d2ee0483a5bf50c9348aefe834e8a"},
-    {file = "Pillow-9.0.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0f29d831e2151e0b7b39981756d201f7108d3d215896212ffe2e992d06bfe049"},
-    {file = "Pillow-9.0.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:855c583f268edde09474b081e3ddcd5cf3b20c12f26e0d434e1386cc5d318e7a"},
-    {file = "Pillow-9.0.1-cp310-cp310-win32.whl", hash = "sha256:d9d7942b624b04b895cb95af03a23407f17646815495ce4547f0e60e0b06f58e"},
-    {file = "Pillow-9.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:81c4b81611e3a3cb30e59b0cf05b888c675f97e3adb2c8672c3154047980726b"},
-    {file = "Pillow-9.0.1-cp37-cp37m-macosx_10_10_x86_64.whl", hash = "sha256:413ce0bbf9fc6278b2d63309dfeefe452835e1c78398efb431bab0672fe9274e"},
-    {file = "Pillow-9.0.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:80fe64a6deb6fcfdf7b8386f2cf216d329be6f2781f7d90304351811fb591360"},
-    {file = "Pillow-9.0.1-cp37-cp37m-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:cef9c85ccbe9bee00909758936ea841ef12035296c748aaceee535969e27d31b"},
-    {file = "Pillow-9.0.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1d19397351f73a88904ad1aee421e800fe4bbcd1aeee6435fb62d0a05ccd1030"},
-    {file = "Pillow-9.0.1-cp37-cp37m-win32.whl", hash = "sha256:d21237d0cd37acded35154e29aec853e945950321dd2ffd1a7d86fe686814669"},
-    {file = "Pillow-9.0.1-cp37-cp37m-win_amd64.whl", hash = "sha256:ede5af4a2702444a832a800b8eb7f0a7a1c0eed55b644642e049c98d589e5092"},
-    {file = "Pillow-9.0.1-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:b5b3f092fe345c03bca1e0b687dfbb39364b21ebb8ba90e3fa707374b7915204"},
-    {file = "Pillow-9.0.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:335ace1a22325395c4ea88e00ba3dc89ca029bd66bd5a3c382d53e44f0ccd77e"},
-    {file = "Pillow-9.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:db6d9fac65bd08cea7f3540b899977c6dee9edad959fa4eaf305940d9cbd861c"},
-    {file = "Pillow-9.0.1-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f154d173286a5d1863637a7dcd8c3437bb557520b01bddb0be0258dcb72696b5"},
-    {file = "Pillow-9.0.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:14d4b1341ac07ae07eb2cc682f459bec932a380c3b122f5540432d8977e64eae"},
-    {file = "Pillow-9.0.1-cp38-cp38-win32.whl", hash = "sha256:effb7749713d5317478bb3acb3f81d9d7c7f86726d41c1facca068a04cf5bb4c"},
-    {file = "Pillow-9.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:7f7609a718b177bf171ac93cea9fd2ddc0e03e84d8fa4e887bdfc39671d46b00"},
-    {file = "Pillow-9.0.1-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:80ca33961ced9c63358056bd08403ff866512038883e74f3a4bf88ad3eb66838"},
-    {file = "Pillow-9.0.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:1c3c33ac69cf059bbb9d1a71eeaba76781b450bc307e2291f8a4764d779a6b28"},
-    {file = "Pillow-9.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:12875d118f21cf35604176872447cdb57b07126750a33748bac15e77f90f1f9c"},
-    {file = "Pillow-9.0.1-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:514ceac913076feefbeaf89771fd6febde78b0c4c1b23aaeab082c41c694e81b"},
-    {file = "Pillow-9.0.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d3c5c79ab7dfce6d88f1ba639b77e77a17ea33a01b07b99840d6ed08031cb2a7"},
-    {file = "Pillow-9.0.1-cp39-cp39-win32.whl", hash = "sha256:718856856ba31f14f13ba885ff13874be7fefc53984d2832458f12c38205f7f7"},
-    {file = "Pillow-9.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:f25ed6e28ddf50de7e7ea99d7a976d6a9c415f03adcaac9c41ff6ff41b6d86ac"},
-    {file = "Pillow-9.0.1-pp37-pypy37_pp73-macosx_10_10_x86_64.whl", hash = "sha256:011233e0c42a4a7836498e98c1acf5e744c96a67dd5032a6f666cc1fb97eab97"},
-    {file = "Pillow-9.0.1-pp37-pypy37_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:253e8a302a96df6927310a9d44e6103055e8fb96a6822f8b7f514bb7ef77de56"},
-    {file = "Pillow-9.0.1-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6295f6763749b89c994fcb6d8a7f7ce03c3992e695f89f00b741b4580b199b7e"},
-    {file = "Pillow-9.0.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:a9f44cd7e162ac6191491d7249cceb02b8116b0f7e847ee33f739d7cb1ea1f70"},
-    {file = "Pillow-9.0.1.tar.gz", hash = "sha256:6c8bc8238a7dfdaf7a75f5ec5a663f4173f8c367e5a39f87e720495e1eed75fa"},
+    {file = "Pillow-9.1.1-cp310-cp310-macosx_10_10_x86_64.whl", hash = "sha256:42dfefbef90eb67c10c45a73a9bc1599d4dac920f7dfcbf4ec6b80cb620757fe"},
+    {file = "Pillow-9.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:ffde4c6fabb52891d81606411cbfaf77756e3b561b566efd270b3ed3791fde4e"},
+    {file = "Pillow-9.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9c857532c719fb30fafabd2371ce9b7031812ff3889d75273827633bca0c4602"},
+    {file = "Pillow-9.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:59789a7d06c742e9d13b883d5e3569188c16acb02eeed2510fd3bfdbc1bd1530"},
+    {file = "Pillow-9.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4d45dbe4b21a9679c3e8b3f7f4f42a45a7d3ddff8a4a16109dff0e1da30a35b2"},
+    {file = "Pillow-9.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:e9ed59d1b6ee837f4515b9584f3d26cf0388b742a11ecdae0d9237a94505d03a"},
+    {file = "Pillow-9.1.1-cp310-cp310-win32.whl", hash = "sha256:b3fe2ff1e1715d4475d7e2c3e8dabd7c025f4410f79513b4ff2de3d51ce0fa9c"},
+    {file = "Pillow-9.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:5b650dbbc0969a4e226d98a0b440c2f07a850896aed9266b6fedc0f7e7834108"},
+    {file = "Pillow-9.1.1-cp37-cp37m-macosx_10_10_x86_64.whl", hash = "sha256:0b4d5ad2cd3a1f0d1df882d926b37dbb2ab6c823ae21d041b46910c8f8cd844b"},
+    {file = "Pillow-9.1.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9370d6744d379f2de5d7fa95cdbd3a4d92f0b0ef29609b4b1687f16bc197063d"},
+    {file = "Pillow-9.1.1-cp37-cp37m-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b761727ed7d593e49671d1827044b942dd2f4caae6e51bab144d4accf8244a84"},
+    {file = "Pillow-9.1.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8a66fe50386162df2da701b3722781cbe90ce043e7d53c1fd6bd801bca6b48d4"},
+    {file = "Pillow-9.1.1-cp37-cp37m-win32.whl", hash = "sha256:2b291cab8a888658d72b575a03e340509b6b050b62db1f5539dd5cd18fd50578"},
+    {file = "Pillow-9.1.1-cp37-cp37m-win_amd64.whl", hash = "sha256:1d4331aeb12f6b3791911a6da82de72257a99ad99726ed6b63f481c0184b6fb9"},
+    {file = "Pillow-9.1.1-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:8844217cdf66eabe39567118f229e275f0727e9195635a15e0e4b9227458daaf"},
+    {file = "Pillow-9.1.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:b6617221ff08fbd3b7a811950b5c3f9367f6e941b86259843eab77c8e3d2b56b"},
+    {file = "Pillow-9.1.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:20d514c989fa28e73a5adbddd7a171afa5824710d0ab06d4e1234195d2a2e546"},
+    {file = "Pillow-9.1.1-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:088df396b047477dd1bbc7de6e22f58400dae2f21310d9e2ec2933b2ef7dfa4f"},
+    {file = "Pillow-9.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:53c27bd452e0f1bc4bfed07ceb235663a1df7c74df08e37fd6b03eb89454946a"},
+    {file = "Pillow-9.1.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:3f6c1716c473ebd1649663bf3b42702d0d53e27af8b64642be0dd3598c761fb1"},
+    {file = "Pillow-9.1.1-cp38-cp38-win32.whl", hash = "sha256:c67db410508b9de9c4694c57ed754b65a460e4812126e87f5052ecf23a011a54"},
+    {file = "Pillow-9.1.1-cp38-cp38-win_amd64.whl", hash = "sha256:f054b020c4d7e9786ae0404278ea318768eb123403b18453e28e47cdb7a0a4bf"},
+    {file = "Pillow-9.1.1-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:c17770a62a71718a74b7548098a74cd6880be16bcfff5f937f900ead90ca8e92"},
+    {file = "Pillow-9.1.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:f3f6a6034140e9e17e9abc175fc7a266a6e63652028e157750bd98e804a8ed9a"},
+    {file = "Pillow-9.1.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f372d0f08eff1475ef426344efe42493f71f377ec52237bf153c5713de987251"},
+    {file = "Pillow-9.1.1-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:09e67ef6e430f90caa093528bd758b0616f8165e57ed8d8ce014ae32df6a831d"},
+    {file = "Pillow-9.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:66daa16952d5bf0c9d5389c5e9df562922a59bd16d77e2a276e575d32e38afd1"},
+    {file = "Pillow-9.1.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:d78ca526a559fb84faaaf84da2dd4addef5edb109db8b81677c0bb1aad342601"},
+    {file = "Pillow-9.1.1-cp39-cp39-win32.whl", hash = "sha256:55e74faf8359ddda43fee01bffbc5bd99d96ea508d8a08c527099e84eb708f45"},
+    {file = "Pillow-9.1.1-cp39-cp39-win_amd64.whl", hash = "sha256:7c150dbbb4a94ea4825d1e5f2c5501af7141ea95825fadd7829f9b11c97aaf6c"},
+    {file = "Pillow-9.1.1-pp37-pypy37_pp73-macosx_10_10_x86_64.whl", hash = "sha256:769a7f131a2f43752455cc72f9f7a093c3ff3856bf976c5fb53a59d0ccc704f6"},
+    {file = "Pillow-9.1.1-pp37-pypy37_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:488f3383cf5159907d48d32957ac6f9ea85ccdcc296c14eca1a4e396ecc32098"},
+    {file = "Pillow-9.1.1-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b525a356680022b0af53385944026d3486fc8c013638cf9900eb87c866afb4c"},
+    {file = "Pillow-9.1.1-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:6e760cf01259a1c0a50f3c845f9cad1af30577fd8b670339b1659c6d0e7a41dd"},
+    {file = "Pillow-9.1.1-pp38-pypy38_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a4165205a13b16a29e1ac57efeee6be2dfd5b5408122d59ef2145bc3239fa340"},
+    {file = "Pillow-9.1.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:937a54e5694684f74dcbf6e24cc453bfc5b33940216ddd8f4cd8f0f79167f765"},
+    {file = "Pillow-9.1.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:baf3be0b9446a4083cc0c5bb9f9c964034be5374b5bc09757be89f5d2fa247b8"},
+    {file = "Pillow-9.1.1.tar.gz", hash = "sha256:7502539939b53d7565f3d11d87c78e7ec900d3c72945d4ee0e2f250d598309a0"},
 ]
 platformdirs = [
-    {file = "platformdirs-2.4.1-py3-none-any.whl", hash = "sha256:1d7385c7db91728b83efd0ca99a5afb296cab9d0ed8313a45ed8ba17967ecfca"},
-    {file = "platformdirs-2.4.1.tar.gz", hash = "sha256:440633ddfebcc36264232365d7840a970e75e1018d15b4327d11f91909045fda"},
+    {file = "platformdirs-2.5.2-py3-none-any.whl", hash = "sha256:027d8e83a2d7de06bbac4e5ef7e023c02b863d7ea5d079477e722bb41ab25788"},
+    {file = "platformdirs-2.5.2.tar.gz", hash = "sha256:58c8abb07dcb441e6ee4b11d8df0ac856038f944ab98b7be6b27b2a3c7feef19"},
 ]
 pluggy = [
     {file = "pluggy-1.0.0-py2.py3-none-any.whl", hash = "sha256:74134bbf457f031a36d68416e1509f34bd5ccc019f0bcc952c7b909d06b37bd3"},
@@ -2449,12 +2544,12 @@ pyflakes = [
     {file = "pyflakes-2.3.1.tar.gz", hash = "sha256:f5bc8ecabc05bb9d291eb5203d6810b49040f6ff446a756326104746cc00c1db"},
 ]
 pygments = [
-    {file = "Pygments-2.11.2-py3-none-any.whl", hash = "sha256:44238f1b60a76d78fc8ca0528ee429702aae011c265fe6a8dd8b63049ae41c65"},
-    {file = "Pygments-2.11.2.tar.gz", hash = "sha256:4e426f72023d88d03b2fa258de560726ce890ff3b630f88c21cbb8b2503b8c6a"},
+    {file = "Pygments-2.12.0-py3-none-any.whl", hash = "sha256:dc9c10fb40944260f6ed4c688ece0cd2048414940f1cea51b8b226318411c519"},
+    {file = "Pygments-2.12.0.tar.gz", hash = "sha256:5eb116118f9612ff1ee89ac96437bb6b49e8f04d8a13b514ba26f620208e26eb"},
 ]
 pylint = [
-    {file = "pylint-2.12.2-py3-none-any.whl", hash = "sha256:daabda3f7ed9d1c60f52d563b1b854632fd90035bcf01443e234d3dc794e3b74"},
-    {file = "pylint-2.12.2.tar.gz", hash = "sha256:9d945a73640e1fec07ee34b42f5669b770c759acd536ec7b16d7e4b87a9c9ff9"},
+    {file = "pylint-2.13.9-py3-none-any.whl", hash = "sha256:705c620d388035bdd9ff8b44c5bcdd235bfb49d276d488dd2c8ff1736aa42526"},
+    {file = "pylint-2.13.9.tar.gz", hash = "sha256:095567c96e19e6f57b5b907e67d265ff535e588fe26b12b5ebe1fc5645b2c731"},
 ]
 pymongo = [
     {file = "pymongo-3.12.3-cp27-cp27m-macosx_10_14_intel.whl", hash = "sha256:c164eda0be9048f83c24b9b2656900041e069ddf72de81c17d874d0c32f6079f"},
@@ -2583,40 +2678,40 @@ pynput = [
     {file = "pynput-1.7.6.tar.gz", hash = "sha256:3a5726546da54116b687785d38b1db56997ce1d28e53e8d22fc656d8b92e533c"},
 ]
 pyobjc-core = [
-    {file = "pyobjc-core-8.2.tar.gz", hash = "sha256:6afb8ee1dd0647cbfaaf99906eca3b43ce045b27e3d4510462d04e7e5361c89b"},
-    {file = "pyobjc_core-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:311e45556c3afa8831713b89017e0204562f51f35661d76c07ffe04985f44e1d"},
-    {file = "pyobjc_core-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:711f361e83382e405e4273ff085178b0cf730901ccf6801f834e7037e50278f9"},
-    {file = "pyobjc_core-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:bdd2e2960ec73214bcfe2d86bb4ca94f5f5119db86d129fa32d3c003b6532c50"},
-    {file = "pyobjc_core-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b879f91fc614c399aafa1d08cf5e279c267510e904bad5c336c3a6064c0eb3aa"},
-    {file = "pyobjc_core-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:b4ef4bdb99a330f5e15cc6273098964276fccbc432453cdba3c2963292bc066c"},
-    {file = "pyobjc_core-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:fd8e5be0955790ff8f9d17a0f356b6eb7eb1ce4995e0c94355c462dd52d22d6d"},
+    {file = "pyobjc-core-8.5.tar.gz", hash = "sha256:704c275439856c0d1287469f0d589a7d808d48b754a93d9ce5415d4eaf06d576"},
+    {file = "pyobjc_core-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:0c234143b48334443f5adcf26e668945a6d47bc1fa6223e80918c6c735a029d9"},
+    {file = "pyobjc_core-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:1486ee533f0d76f666804ce89723ada4db56bfde55e56151ba512d3f849857f8"},
+    {file = "pyobjc_core-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:412de06dfa728301c04b3e46fd7453320a8ae8b862e85236e547cd797a73b490"},
+    {file = "pyobjc_core-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:0b3e09cccb1be574a82cc9f929ae27fc4283eccc75496cb5d51534caa6bb83a3"},
+    {file = "pyobjc_core-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:eeafe21f879666ab7f57efcc6b007c9f5f8733d367b7e380c925203ed83f000d"},
+    {file = "pyobjc_core-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:c0071686976d7ea8c14690950e504a13cb22b4ebb2bc7b5ec47c1c1c0f6eff41"},
 ]
 pyobjc-framework-applicationservices = [
-    {file = "pyobjc-framework-ApplicationServices-8.2.tar.gz", hash = "sha256:f901b2ebb278b7d00033b45cf9ee9d43f651e096ff4c4defa261509238138da8"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:b5be1757a8df944a58449c628ed68fc76dd746fcd1e96ebb6db0f734e94cdfc8"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:32657c4b89983a98fbe831a14884954710719e763197968a20ac07e1daa21f1e"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:6ce2c9701590f752a75151b2fe1e462e7a7ad67dec3119a796711ea93ea01031"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:28124bc892045222305cf8953b163495bf662c401e54f48905dafb1104d9c1d1"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:d5c60d66c6ed2569cb042a6c14dd5b9f4d01e182a464b893cd6002ce445b4ddf"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:e1727fccc1d48922fa28a4cebf4a6d287d633f451cb03779968df60de8cb1bd0"},
+    {file = "pyobjc-framework-ApplicationServices-8.5.tar.gz", hash = "sha256:fa3015ef8e3add90af3447d7fdcc7f8dd083cc2a1d58f99a569480a2df10d2b1"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:436b16ebe448a829a8312e10208eec81a2adcae1fff674dbcc3262e1bd76e0ca"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:408958d14aa7fcf46f2163754c211078bc63be1368934d86188202914dce077d"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:1d6cd4ce192859a22e208da4d7177a1c3ceb1ef2f64c339fd881102b1210cadd"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:0251d092adb1d2d116fd9f147ceef0e53b158a46c21245131c40b9d7b786d0db"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:9742e69fe6d4545d0e02b0ad0a7a2432bc9944569ee07d6e90ffa5ef614df9f7"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:16f5677c14ea903c6aaca1dd121521825c39e816cae696d6ae32c0b287252ab2"},
 ]
 pyobjc-framework-cocoa = [
-    {file = "pyobjc-framework-Cocoa-8.2.tar.gz", hash = "sha256:f0901998e2f18415ef6d1f8a12b083f69fc93bd56b3e88040002e3c09bd8c304"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:5af73f150e242542735e0663bb5504f88aabaec2a54c60e856cfca3ff6dd9712"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:d1de3763ee01850c311da74de5c82c85ec199120e85ab45acaf203accc37a470"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:86d69bf667f99f3c43184d8830567195fff94c675fe7f60f899dd90553d9b265"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:9dbadb22826392c48b00087359f66579f8404a4f4f77498f31f9869c54bb0fa9"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:7adf8b57da1c1292c24375b8e74b6dd45f99a4d3c10ba925a9b38f63a97ba782"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:bc8279c8c1544087d46a7e99324f093029df89b8c527c5da2a682bad4cb3197e"},
+    {file = "pyobjc-framework-Cocoa-8.5.tar.gz", hash = "sha256:569bd3a020f64b536fb2d1c085b37553e50558c9f907e08b73ffc16ae68e1861"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:7a7c160416696bf6035dfcdf0e603aaa52858d6afcddfcc5ab41733619ac2529"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:6ceba444282030be8596b812260e8d28b671254a51052ad778d32da6e17db847"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:f46b2b161b8dd40c7b9e00bc69636c3e6480b2704a69aee22ee0154befbe163a"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b31d425aee8698cbf62b187338f5ca59427fa4dca2153a73866f7cb410713119"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:898359ac1f76eedec8aa156847682378a8950824421c40edb89391286e607dc4"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:baa2947f76b119a3360973d74d57d6dada87ac527bab9a88f31596af392f123c"},
 ]
 pyobjc-framework-quartz = [
-    {file = "pyobjc-framework-Quartz-8.2.tar.gz", hash = "sha256:219d8797235bf071723f8b0f30a681de0b12875e2d04ae902a3a269f72de0b66"},
-    {file = "pyobjc_framework_Quartz-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e5ab3117201a494b11bb1b80febf5dd288111a196b35731815b656ae30ee6ce3"},
-    {file = "pyobjc_framework_Quartz-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:4941b3039ab7bcf89cb4255c381358de2383c1ab45c9e00c3b64655f271a3b32"},
-    {file = "pyobjc_framework_Quartz-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:ab75a50dea84ec794641522d9f035fc6c19ec4eb37a56c9186b9943575fbc7ab"},
-    {file = "pyobjc_framework_Quartz-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:8cb687b20ebfc467034868b38945b573d1c50f237e379cf86c4f557c9766b759"},
-    {file = "pyobjc_framework_Quartz-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:8b5c3ca1fef900fa66aafe82fff07bc352c60ea7dceed2bb9b5b1db0957b4fea"},
-    {file = "pyobjc_framework_Quartz-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:7bca7e649da77056348d71032def44e345043319d71b0c592197888d92e3eec1"},
+    {file = "pyobjc-framework-Quartz-8.5.tar.gz", hash = "sha256:d2bc5467a792ddc04814f12a1e9c2fcaf699a1c3ad3d4264cfdce6b9c7b10624"},
+    {file = "pyobjc_framework_Quartz-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e9f0fb663f7872c9de94169031ac42b91ad01bd4cad49a9f1a0164be8f028426"},
+    {file = "pyobjc_framework_Quartz-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:567eec91287cfe9a1b6433717192c585935de8f3daa28d82ce72fdd6c7ac00f6"},
+    {file = "pyobjc_framework_Quartz-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:9f910ab41a712ffc7a8c3e3716a2d6f39ea4419004b26a2fd2d2f740ff5c262c"},
+    {file = "pyobjc_framework_Quartz-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:29d07066781628278bf0e5278abcfc96ef6724c66c5629a0b4c214d319a82e55"},
+    {file = "pyobjc_framework_Quartz-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:72abcde1a3d72be11f2c881c9b9872044c8f2de86d2047b67fe771713638b107"},
+    {file = "pyobjc_framework_Quartz-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:8809b9a2df2f461697bdb45b6d1b5a4f881f88f09450e3990858e64e3e26c530"},
 ]
 pyparsing = [
     {file = "pyparsing-2.4.7-py2.py3-none-any.whl", hash = "sha256:ef9d7589ef3c200abe66653d3f1ab1033c3c419ae9b9bdb1240a85b024efc88b"},
@@ -2641,6 +2736,14 @@ python-dateutil = [
     {file = "python-dateutil-2.8.2.tar.gz", hash = "sha256:0123cacc1627ae19ddf3c27a5de5bd67ee4586fbdd6440d9748f8abb483d3e86"},
     {file = "python_dateutil-2.8.2-py2.py3-none-any.whl", hash = "sha256:961d03dc3453ebbc59dbdea9e4e11c5651520a876d0f4db161e8674aae935da9"},
 ]
+python-engineio = [
+    {file = "python-engineio-3.14.2.tar.gz", hash = "sha256:eab4553f2804c1ce97054c8b22cf0d5a9ab23128075248b97e1a5b2f29553085"},
+    {file = "python_engineio-3.14.2-py2.py3-none-any.whl", hash = "sha256:5a9e6086d192463b04a1428ff1f85b6ba631bbb19d453b144ffc04f530542b84"},
+]
+python-socketio = [
+    {file = "python-socketio-4.6.1.tar.gz", hash = "sha256:cd1f5aa492c1eb2be77838e837a495f117e17f686029ebc03d62c09e33f4fa10"},
+    {file = "python_socketio-4.6.1-py2.py3-none-any.whl", hash = "sha256:5a21da53fdbdc6bb6c8071f40e13d100e0b279ad997681c2492478e06f370523"},
+]
 python-xlib = [
     {file = "python-xlib-0.31.tar.gz", hash = "sha256:74d83a081f532bc07f6d7afcd6416ec38403d68f68b9b9dc9e1f28fbf2d799e9"},
     {file = "python_xlib-0.31-py2.py3-none-any.whl", hash = "sha256:1ec6ce0de73d9e6592ead666779a5732b384e5b8fb1f1886bd0a81cafa477759"},
@@ -2649,8 +2752,8 @@ python3-xlib = [
     {file = "python3-xlib-0.15.tar.gz", hash = "sha256:dc4245f3ae4aa5949c1d112ee4723901ade37a96721ba9645f2bfa56e5b383f8"},
 ]
 pytz = [
-    {file = "pytz-2021.3-py2.py3-none-any.whl", hash = "sha256:3672058bc3453457b622aab7a1c3bfd5ab0bdae451512f6cf25f64ed37f5b87c"},
-    {file = "pytz-2021.3.tar.gz", hash = "sha256:acad2d8b20a1af07d4e4c9d2e9285c5ed9104354062f275f3fcd88dcef4f1326"},
+    {file = "pytz-2022.1-py2.py3-none-any.whl", hash = "sha256:e68985985296d9a66a881eb3193b0906246245294a881e7c8afe623866ac6a5c"},
+    {file = "pytz-2022.1.tar.gz", hash = "sha256:1e760e2fe6a8163bc0b3d9a19c4f84342afa0a2affebfaa84b01b978a02ecaa7"},
 ]
 pywin32 = [
     {file = "pywin32-301-cp35-cp35m-win32.whl", hash = "sha256:93367c96e3a76dfe5003d8291ae16454ca7d84bb24d721e0b74a07610b7be4a7"},
@@ -2669,8 +2772,8 @@ pywin32-ctypes = [
     {file = "pywin32_ctypes-0.2.0-py2.py3-none-any.whl", hash = "sha256:9dc2d991b3479cc2df15930958b674a48a227d5361d413827a4cfd0b5876fc98"},
 ]
 "qt.py" = [
-    {file = "Qt.py-1.3.6-py2.py3-none-any.whl", hash = "sha256:7edf6048d07a6924707506b5ba34a6e05d66dde9a3f4e3a62f9996ccab0b91c7"},
-    {file = "Qt.py-1.3.6.tar.gz", hash = "sha256:0d78656a2f814602eee304521c7bf5da0cec414818b3833712c77524294c404a"},
+    {file = "Qt.py-1.3.7-py2.py3-none-any.whl", hash = "sha256:150099d1c6f64c9621a2c9d79d45102ec781c30ee30ee69fc082c6e9be7324fe"},
+    {file = "Qt.py-1.3.7.tar.gz", hash = "sha256:803c7bdf4d6230f9a466be19d55934a173eabb61406d21cb91e80c2a3f773b1f"},
 ]
 qtawesome = [
     {file = "QtAwesome-0.7.3-py2.py3-none-any.whl", hash = "sha256:ddf4530b4af71cec13b24b88a4cdb56ec85b1e44c43c42d0698804c7137b09b0"},
@@ -2685,16 +2788,16 @@ recommonmark = [
     {file = "recommonmark-0.7.1.tar.gz", hash = "sha256:bdb4db649f2222dcd8d2d844f0006b958d627f732415d399791ee436a3686d67"},
 ]
 requests = [
-    {file = "requests-2.25.1-py2.py3-none-any.whl", hash = "sha256:c210084e36a42ae6b9219e00e48287def368a26d03a048ddad7bfee44f75871e"},
-    {file = "requests-2.25.1.tar.gz", hash = "sha256:27973dd4a904a4f13b263a19c866c13b92a39ed1c964655f025f3f8d3d75b804"},
+    {file = "requests-2.27.1-py2.py3-none-any.whl", hash = "sha256:f22fa1e554c9ddfd16e6e41ac79759e17be9e492b3587efa038054674760e72d"},
+    {file = "requests-2.27.1.tar.gz", hash = "sha256:68d7c56fd5a8999887728ef304a6d12edc7be74f1cfa47714fc8b414525c9a61"},
 ]
 rsa = [
     {file = "rsa-4.8-py3-none-any.whl", hash = "sha256:95c5d300c4e879ee69708c428ba566c59478fd653cc3a22243eeb8ed846950bb"},
     {file = "rsa-4.8.tar.gz", hash = "sha256:5c6bd9dc7a543b7fe4304a631f8a8a3b674e2bbfc49c2ae96200cdbe55df6b17"},
 ]
 secretstorage = [
-    {file = "SecretStorage-3.3.1-py3-none-any.whl", hash = "sha256:422d82c36172d88d6a0ed5afdec956514b189ddbfb72fefab0c8a1cee4eaf71f"},
-    {file = "SecretStorage-3.3.1.tar.gz", hash = "sha256:fd666c51a6bf200643495a04abb261f83229dcb6fd8472ec393df7ffc8b6f195"},
+    {file = "SecretStorage-3.3.2-py3-none-any.whl", hash = "sha256:755dc845b6ad76dcbcbc07ea3da75ae54bb1ea529eb72d15f83d26499a5df319"},
+    {file = "SecretStorage-3.3.2.tar.gz", hash = "sha256:0a8eb9645b320881c222e827c26f4cfcf55363e8b374a021981ef886657a912f"},
 ]
 semver = [
     {file = "semver-2.13.0-py2.py3-none-any.whl", hash = "sha256:ced8b23dceb22134307c1b8abfa523da14198793d9787ac838e70e29e77458d4"},
@@ -2705,8 +2808,8 @@ six = [
     {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"},
 ]
 slack-sdk = [
-    {file = "slack_sdk-3.13.0-py2.py3-none-any.whl", hash = "sha256:54f2a5f7419f1ab932af9e3200f7f2f93db96e0f0eb8ad7d3b4214aa9f124641"},
-    {file = "slack_sdk-3.13.0.tar.gz", hash = "sha256:aae6ce057e286a5e7fe7a9f256e85b886eee556def8e04b82b08f699e64d7f67"},
+    {file = "slack_sdk-3.17.0-py2.py3-none-any.whl", hash = "sha256:0816efc43d1d2db8286e8dbcbb2e86fd0f71c206c01c521c2cb054ecb40f9ced"},
+    {file = "slack_sdk-3.17.0.tar.gz", hash = "sha256:860cd0e50c454b955f14321c8c5486a47cc1e0e84116acdb009107f836752feb"},
 ]
 smmap = [
     {file = "smmap-5.0.0-py3-none-any.whl", hash = "sha256:2aba19d6a040e78d8b09de5c57e96207b09ed71d8e55ce0959eeee6c8e190d94"},
@@ -2717,20 +2820,20 @@ snowballstemmer = [
     {file = "snowballstemmer-2.2.0.tar.gz", hash = "sha256:09b16deb8547d3412ad7b590689584cd0fe25ec8db3be37788be3810cbf19cb1"},
 ]
 speedcopy = [
-    {file = "speedcopy-2.1.2-py3-none-any.whl", hash = "sha256:91e271b84c00952812dbf669d360b2610fd8fa198670373e02acf2a04db89a4c"},
-    {file = "speedcopy-2.1.2.tar.gz", hash = "sha256:1b2d779fadebd53a59384f7d286c40b2ef382e0d000fa53011699fcd3190d33f"},
+    {file = "speedcopy-2.1.4-py3-none-any.whl", hash = "sha256:e09eb1de67ae0e0b51d5b99a28882009d565a37a3cb3c6bae121e3a5d3cccb17"},
+    {file = "speedcopy-2.1.4.tar.gz", hash = "sha256:eff007a97e49ec1934df4fa8074f4bd1cf4a3b14c5499d914988785cff0c199a"},
 ]
 sphinx = [
-    {file = "Sphinx-3.5.3-py3-none-any.whl", hash = "sha256:3f01732296465648da43dec8fb40dc451ba79eb3e2cc5c6d79005fd98197107d"},
-    {file = "Sphinx-3.5.3.tar.gz", hash = "sha256:ce9c228456131bab09a3d7d10ae58474de562a6f79abb3dc811ae401cf8c1abc"},
+    {file = "Sphinx-5.0.1-py3-none-any.whl", hash = "sha256:36aa2a3c2f6d5230be94585bc5d74badd5f9ed8f3388b8eedc1726fe45b1ad30"},
+    {file = "Sphinx-5.0.1.tar.gz", hash = "sha256:f4da1187785a5bc7312cc271b0e867a93946c319d106363e102936a3d9857306"},
 ]
 sphinx-qt-documentation = [
-    {file = "sphinx_qt_documentation-0.3-py3-none-any.whl", hash = "sha256:bee247cb9e4fc03fc496d07adfdb943100e1103320c3e5e820e0cfa7c790d9b6"},
-    {file = "sphinx_qt_documentation-0.3.tar.gz", hash = "sha256:f09a0c9d9e989172ba3e282b92bf55613bb23ad47315ec5b0d38536b343ac6c8"},
+    {file = "sphinx_qt_documentation-0.4-py3-none-any.whl", hash = "sha256:fa131093f75cd1bd48699cd132e18e4d46ba9eaadc070e6026867cea75ecdb7b"},
+    {file = "sphinx_qt_documentation-0.4.tar.gz", hash = "sha256:f43ba17baa93e353fb94045027fb67f9d935ed158ce8662de93f08b88eec6774"},
 ]
 sphinx-rtd-theme = [
-    {file = "sphinx_rtd_theme-0.5.1-py2.py3-none-any.whl", hash = "sha256:fa6bebd5ab9a73da8e102509a86f3fcc36dec04a0b52ea80e5a033b2aba00113"},
-    {file = "sphinx_rtd_theme-0.5.1.tar.gz", hash = "sha256:eda689eda0c7301a80cf122dad28b1861e5605cbf455558f3775e1e8200e83a5"},
+    {file = "sphinx_rtd_theme-1.0.0-py2.py3-none-any.whl", hash = "sha256:4d35a56f4508cfee4c4fb604373ede6feae2a306731d533f409ef5c3496fdbd8"},
+    {file = "sphinx_rtd_theme-1.0.0.tar.gz", hash = "sha256:eec6d497e4c2195fa0e8b2016b337532b8a699a68bcb22a512870e16925c6a5c"},
 ]
 sphinxcontrib-applehelp = [
     {file = "sphinxcontrib-applehelp-1.0.2.tar.gz", hash = "sha256:a072735ec80e7675e3f432fcae8610ecf509c5f1869d17e2eecff44389cdbc58"},
@@ -2773,34 +2876,34 @@ toml = [
     {file = "toml-0.10.2.tar.gz", hash = "sha256:b3bda1d108d5dd99f4a20d24d9c348e91c4db7ab1b749200bded2f839ccbe68f"},
 ]
 tomli = [
-    {file = "tomli-2.0.0-py3-none-any.whl", hash = "sha256:b5bde28da1fed24b9bd1d4d2b8cba62300bfb4ec9a6187a957e8ddb9434c5224"},
-    {file = "tomli-2.0.0.tar.gz", hash = "sha256:c292c34f58502a1eb2bbb9f5bbc9a5ebc37bee10ffb8c2d6bbdfa8eb13cc14e1"},
+    {file = "tomli-2.0.1-py3-none-any.whl", hash = "sha256:939de3e7a6161af0c887ef91b7d41a53e7c5a1ca976325f429cb46ea9bc30ecc"},
+    {file = "tomli-2.0.1.tar.gz", hash = "sha256:de526c12914f0c550d15924c62d72abc48d6fe7364aa87328337a31007fe8a4f"},
 ]
 typed-ast = [
-    {file = "typed_ast-1.5.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:183b183b7771a508395d2cbffd6db67d6ad52958a5fdc99f450d954003900266"},
-    {file = "typed_ast-1.5.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:676d051b1da67a852c0447621fdd11c4e104827417bf216092ec3e286f7da596"},
-    {file = "typed_ast-1.5.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bc2542e83ac8399752bc16e0b35e038bdb659ba237f4222616b4e83fb9654985"},
-    {file = "typed_ast-1.5.2-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:74cac86cc586db8dfda0ce65d8bcd2bf17b58668dfcc3652762f3ef0e6677e76"},
-    {file = "typed_ast-1.5.2-cp310-cp310-win_amd64.whl", hash = "sha256:18fe320f354d6f9ad3147859b6e16649a0781425268c4dde596093177660e71a"},
-    {file = "typed_ast-1.5.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:31d8c6b2df19a777bc8826770b872a45a1f30cfefcfd729491baa5237faae837"},
-    {file = "typed_ast-1.5.2-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:963a0ccc9a4188524e6e6d39b12c9ca24cc2d45a71cfdd04a26d883c922b4b78"},
-    {file = "typed_ast-1.5.2-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:0eb77764ea470f14fcbb89d51bc6bbf5e7623446ac4ed06cbd9ca9495b62e36e"},
-    {file = "typed_ast-1.5.2-cp36-cp36m-win_amd64.whl", hash = "sha256:294a6903a4d087db805a7656989f613371915fc45c8cc0ddc5c5a0a8ad9bea4d"},
-    {file = "typed_ast-1.5.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:26a432dc219c6b6f38be20a958cbe1abffcc5492821d7e27f08606ef99e0dffd"},
-    {file = "typed_ast-1.5.2-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c7407cfcad702f0b6c0e0f3e7ab876cd1d2c13b14ce770e412c0c4b9728a0f88"},
-    {file = "typed_ast-1.5.2-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:f30ddd110634c2d7534b2d4e0e22967e88366b0d356b24de87419cc4410c41b7"},
-    {file = "typed_ast-1.5.2-cp37-cp37m-win_amd64.whl", hash = "sha256:8c08d6625bb258179b6e512f55ad20f9dfef019bbfbe3095247401e053a3ea30"},
-    {file = "typed_ast-1.5.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:90904d889ab8e81a956f2c0935a523cc4e077c7847a836abee832f868d5c26a4"},
-    {file = "typed_ast-1.5.2-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:bbebc31bf11762b63bf61aaae232becb41c5bf6b3461b80a4df7e791fabb3aca"},
-    {file = "typed_ast-1.5.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c29dd9a3a9d259c9fa19d19738d021632d673f6ed9b35a739f48e5f807f264fb"},
-    {file = "typed_ast-1.5.2-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:58ae097a325e9bb7a684572d20eb3e1809802c5c9ec7108e85da1eb6c1a3331b"},
-    {file = "typed_ast-1.5.2-cp38-cp38-win_amd64.whl", hash = "sha256:da0a98d458010bf4fe535f2d1e367a2e2060e105978873c04c04212fb20543f7"},
-    {file = "typed_ast-1.5.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:33b4a19ddc9fc551ebabca9765d54d04600c4a50eda13893dadf67ed81d9a098"},
-    {file = "typed_ast-1.5.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:1098df9a0592dd4c8c0ccfc2e98931278a6c6c53cb3a3e2cf7e9ee3b06153344"},
-    {file = "typed_ast-1.5.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:42c47c3b43fe3a39ddf8de1d40dbbfca60ac8530a36c9b198ea5b9efac75c09e"},
-    {file = "typed_ast-1.5.2-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:f290617f74a610849bd8f5514e34ae3d09eafd521dceaa6cf68b3f4414266d4e"},
-    {file = "typed_ast-1.5.2-cp39-cp39-win_amd64.whl", hash = "sha256:df05aa5b241e2e8045f5f4367a9f6187b09c4cdf8578bb219861c4e27c443db5"},
-    {file = "typed_ast-1.5.2.tar.gz", hash = "sha256:525a2d4088e70a9f75b08b3f87a51acc9cde640e19cc523c7e41aa355564ae27"},
+    {file = "typed_ast-1.5.4-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:669dd0c4167f6f2cd9f57041e03c3c2ebf9063d0757dc89f79ba1daa2bfca9d4"},
+    {file = "typed_ast-1.5.4-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:211260621ab1cd7324e0798d6be953d00b74e0428382991adfddb352252f1d62"},
+    {file = "typed_ast-1.5.4-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:267e3f78697a6c00c689c03db4876dd1efdfea2f251a5ad6555e82a26847b4ac"},
+    {file = "typed_ast-1.5.4-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:c542eeda69212fa10a7ada75e668876fdec5f856cd3d06829e6aa64ad17c8dfe"},
+    {file = "typed_ast-1.5.4-cp310-cp310-win_amd64.whl", hash = "sha256:a9916d2bb8865f973824fb47436fa45e1ebf2efd920f2b9f99342cb7fab93f72"},
+    {file = "typed_ast-1.5.4-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:79b1e0869db7c830ba6a981d58711c88b6677506e648496b1f64ac7d15633aec"},
+    {file = "typed_ast-1.5.4-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a94d55d142c9265f4ea46fab70977a1944ecae359ae867397757d836ea5a3f47"},
+    {file = "typed_ast-1.5.4-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:183afdf0ec5b1b211724dfef3d2cad2d767cbefac291f24d69b00546c1837fb6"},
+    {file = "typed_ast-1.5.4-cp36-cp36m-win_amd64.whl", hash = "sha256:639c5f0b21776605dd6c9dbe592d5228f021404dafd377e2b7ac046b0349b1a1"},
+    {file = "typed_ast-1.5.4-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:cf4afcfac006ece570e32d6fa90ab74a17245b83dfd6655a6f68568098345ff6"},
+    {file = "typed_ast-1.5.4-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ed855bbe3eb3715fca349c80174cfcfd699c2f9de574d40527b8429acae23a66"},
+    {file = "typed_ast-1.5.4-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:6778e1b2f81dfc7bc58e4b259363b83d2e509a65198e85d5700dfae4c6c8ff1c"},
+    {file = "typed_ast-1.5.4-cp37-cp37m-win_amd64.whl", hash = "sha256:0261195c2062caf107831e92a76764c81227dae162c4f75192c0d489faf751a2"},
+    {file = "typed_ast-1.5.4-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:2efae9db7a8c05ad5547d522e7dbe62c83d838d3906a3716d1478b6c1d61388d"},
+    {file = "typed_ast-1.5.4-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:7d5d014b7daa8b0bf2eaef684295acae12b036d79f54178b92a2b6a56f92278f"},
+    {file = "typed_ast-1.5.4-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:370788a63915e82fd6f212865a596a0fefcbb7d408bbbb13dea723d971ed8bdc"},
+    {file = "typed_ast-1.5.4-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:4e964b4ff86550a7a7d56345c7864b18f403f5bd7380edf44a3c1fb4ee7ac6c6"},
+    {file = "typed_ast-1.5.4-cp38-cp38-win_amd64.whl", hash = "sha256:683407d92dc953c8a7347119596f0b0e6c55eb98ebebd9b23437501b28dcbb8e"},
+    {file = "typed_ast-1.5.4-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:4879da6c9b73443f97e731b617184a596ac1235fe91f98d279a7af36c796da35"},
+    {file = "typed_ast-1.5.4-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:3e123d878ba170397916557d31c8f589951e353cc95fb7f24f6bb69adc1a8a97"},
+    {file = "typed_ast-1.5.4-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ebd9d7f80ccf7a82ac5f88c521115cc55d84e35bf8b446fcd7836eb6b98929a3"},
+    {file = "typed_ast-1.5.4-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:98f80dee3c03455e92796b58b98ff6ca0b2a6f652120c263efdba4d6c5e58f72"},
+    {file = "typed_ast-1.5.4-cp39-cp39-win_amd64.whl", hash = "sha256:0fdbcf2fef0ca421a3f5912555804296f0b0960f0418c440f5d6d3abb549f3e1"},
+    {file = "typed_ast-1.5.4.tar.gz", hash = "sha256:39e21ceb7388e4bb37f4c679d72707ed46c2fbf2a5609b8b8ebc4b067d977df2"},
 ]
 typing-extensions = [
     {file = "typing_extensions-4.0.1-py3-none-any.whl", hash = "sha256:7f001e5ac290a0c0401508864c7ec868be4e701886d5b573a9528ed3973d9d3b"},
@@ -2811,8 +2914,8 @@ uritemplate = [
     {file = "uritemplate-3.0.1.tar.gz", hash = "sha256:5af8ad10cec94f215e3f48112de2022e1d5a37ed427fbd88652fa908f2ab7cae"},
 ]
 urllib3 = [
-    {file = "urllib3-1.26.8-py2.py3-none-any.whl", hash = "sha256:000ca7f471a233c2251c6c7023ee85305721bfdf18621ebff4fd17a8653427ed"},
-    {file = "urllib3-1.26.8.tar.gz", hash = "sha256:0e7c33d9a63e7ddfcb86780aac87befc2fbddf46c58dbb487e0855f7ceec283c"},
+    {file = "urllib3-1.26.9-py2.py3-none-any.whl", hash = "sha256:44ece4d53fb1706f667c9bd1c648f5469a2ec925fcf3a776667042d645472c14"},
+    {file = "urllib3-1.26.9.tar.gz", hash = "sha256:aabaf16477806a5e1dd19aa41f8c2b7950dd3c746362d7e3223dbe6de6ac448e"},
 ]
 wcwidth = [
     {file = "wcwidth-0.2.5-py2.py3-none-any.whl", hash = "sha256:beb4802a9cebb9144e99086eff703a642a13d6a0052920003a230f3294bbe784"},
@@ -2823,57 +2926,70 @@ websocket-client = [
     {file = "websocket_client-0.59.0-py2.py3-none-any.whl", hash = "sha256:2e50d26ca593f70aba7b13a489435ef88b8fc3b5c5643c1ce8808ff9b40f0b32"},
 ]
 wrapt = [
-    {file = "wrapt-1.13.3-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:e05e60ff3b2b0342153be4d1b597bbcfd8330890056b9619f4ad6b8d5c96a81a"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux1_i686.whl", hash = "sha256:85148f4225287b6a0665eef08a178c15097366d46b210574a658c1ff5b377489"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux1_x86_64.whl", hash = "sha256:2dded5496e8f1592ec27079b28b6ad2a1ef0b9296d270f77b8e4a3a796cf6909"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux2010_i686.whl", hash = "sha256:e94b7d9deaa4cc7bac9198a58a7240aaf87fe56c6277ee25fa5b3aa1edebd229"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux2010_x86_64.whl", hash = "sha256:498e6217523111d07cd67e87a791f5e9ee769f9241fcf8a379696e25806965af"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux1_i686.whl", hash = "sha256:ec7e20258ecc5174029a0f391e1b948bf2906cd64c198a9b8b281b811cbc04de"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux1_x86_64.whl", hash = "sha256:87883690cae293541e08ba2da22cacaae0a092e0ed56bbba8d018cc486fbafbb"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux2010_i686.whl", hash = "sha256:f99c0489258086308aad4ae57da9e8ecf9e1f3f30fa35d5e170b4d4896554d80"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux2010_x86_64.whl", hash = "sha256:6a03d9917aee887690aa3f1747ce634e610f6db6f6b332b35c2dd89412912bca"},
-    {file = "wrapt-1.13.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:936503cb0a6ed28dbfa87e8fcd0a56458822144e9d11a49ccee6d9a8adb2ac44"},
-    {file = "wrapt-1.13.3-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:f9c51d9af9abb899bd34ace878fbec8bf357b3194a10c4e8e0a25512826ef056"},
-    {file = "wrapt-1.13.3-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:220a869982ea9023e163ba915077816ca439489de6d2c09089b219f4e11b6785"},
-    {file = "wrapt-1.13.3-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:0877fe981fd76b183711d767500e6b3111378ed2043c145e21816ee589d91096"},
-    {file = "wrapt-1.13.3-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:43e69ffe47e3609a6aec0fe723001c60c65305784d964f5007d5b4fb1bc6bf33"},
-    {file = "wrapt-1.13.3-cp310-cp310-win32.whl", hash = "sha256:78dea98c81915bbf510eb6a3c9c24915e4660302937b9ae05a0947164248020f"},
-    {file = "wrapt-1.13.3-cp310-cp310-win_amd64.whl", hash = "sha256:ea3e746e29d4000cd98d572f3ee2a6050a4f784bb536f4ac1f035987fc1ed83e"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux1_i686.whl", hash = "sha256:8c73c1a2ec7c98d7eaded149f6d225a692caa1bd7b2401a14125446e9e90410d"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux1_x86_64.whl", hash = "sha256:086218a72ec7d986a3eddb7707c8c4526d677c7b35e355875a0fe2918b059179"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux2010_i686.whl", hash = "sha256:e92d0d4fa68ea0c02d39f1e2f9cb5bc4b4a71e8c442207433d8db47ee79d7aa3"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux2010_x86_64.whl", hash = "sha256:d4a5f6146cfa5c7ba0134249665acd322a70d1ea61732723c7d3e8cc0fa80755"},
-    {file = "wrapt-1.13.3-cp35-cp35m-win32.whl", hash = "sha256:8aab36778fa9bba1a8f06a4919556f9f8c7b33102bd71b3ab307bb3fecb21851"},
-    {file = "wrapt-1.13.3-cp35-cp35m-win_amd64.whl", hash = "sha256:944b180f61f5e36c0634d3202ba8509b986b5fbaf57db3e94df11abee244ba13"},
-    {file = "wrapt-1.13.3-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:2ebdde19cd3c8cdf8df3fc165bc7827334bc4e353465048b36f7deeae8ee0918"},
-    {file = "wrapt-1.13.3-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:610f5f83dd1e0ad40254c306f4764fcdc846641f120c3cf424ff57a19d5f7ade"},
-    {file = "wrapt-1.13.3-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:5601f44a0f38fed36cc07db004f0eedeaadbdcec90e4e90509480e7e6060a5bc"},
-    {file = "wrapt-1.13.3-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:e6906d6f48437dfd80464f7d7af1740eadc572b9f7a4301e7dd3d65db285cacf"},
-    {file = "wrapt-1.13.3-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:766b32c762e07e26f50d8a3468e3b4228b3736c805018e4b0ec8cc01ecd88125"},
-    {file = "wrapt-1.13.3-cp36-cp36m-win32.whl", hash = "sha256:5f223101f21cfd41deec8ce3889dc59f88a59b409db028c469c9b20cfeefbe36"},
-    {file = "wrapt-1.13.3-cp36-cp36m-win_amd64.whl", hash = "sha256:f122ccd12fdc69628786d0c947bdd9cb2733be8f800d88b5a37c57f1f1d73c10"},
-    {file = "wrapt-1.13.3-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:46f7f3af321a573fc0c3586612db4decb7eb37172af1bc6173d81f5b66c2e068"},
-    {file = "wrapt-1.13.3-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:778fd096ee96890c10ce96187c76b3e99b2da44e08c9e24d5652f356873f6709"},
-    {file = "wrapt-1.13.3-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:0cb23d36ed03bf46b894cfec777eec754146d68429c30431c99ef28482b5c1df"},
-    {file = "wrapt-1.13.3-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:96b81ae75591a795d8c90edc0bfaab44d3d41ffc1aae4d994c5aa21d9b8e19a2"},
-    {file = "wrapt-1.13.3-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:7dd215e4e8514004c8d810a73e342c536547038fb130205ec4bba9f5de35d45b"},
-    {file = "wrapt-1.13.3-cp37-cp37m-win32.whl", hash = "sha256:47f0a183743e7f71f29e4e21574ad3fa95676136f45b91afcf83f6a050914829"},
-    {file = "wrapt-1.13.3-cp37-cp37m-win_amd64.whl", hash = "sha256:fd76c47f20984b43d93de9a82011bb6e5f8325df6c9ed4d8310029a55fa361ea"},
-    {file = "wrapt-1.13.3-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b73d4b78807bd299b38e4598b8e7bd34ed55d480160d2e7fdaabd9931afa65f9"},
-    {file = "wrapt-1.13.3-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:ec9465dd69d5657b5d2fa6133b3e1e989ae27d29471a672416fd729b429eb554"},
-    {file = "wrapt-1.13.3-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:dd91006848eb55af2159375134d724032a2d1d13bcc6f81cd8d3ed9f2b8e846c"},
-    {file = "wrapt-1.13.3-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:ae9de71eb60940e58207f8e71fe113c639da42adb02fb2bcbcaccc1ccecd092b"},
-    {file = "wrapt-1.13.3-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:51799ca950cfee9396a87f4a1240622ac38973b6df5ef7a41e7f0b98797099ce"},
-    {file = "wrapt-1.13.3-cp38-cp38-win32.whl", hash = "sha256:4b9c458732450ec42578b5642ac53e312092acf8c0bfce140ada5ca1ac556f79"},
-    {file = "wrapt-1.13.3-cp38-cp38-win_amd64.whl", hash = "sha256:7dde79d007cd6dfa65afe404766057c2409316135cb892be4b1c768e3f3a11cb"},
-    {file = "wrapt-1.13.3-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:981da26722bebb9247a0601e2922cedf8bb7a600e89c852d063313102de6f2cb"},
-    {file = "wrapt-1.13.3-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:705e2af1f7be4707e49ced9153f8d72131090e52be9278b5dbb1498c749a1e32"},
-    {file = "wrapt-1.13.3-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:25b1b1d5df495d82be1c9d2fad408f7ce5ca8a38085e2da41bb63c914baadff7"},
-    {file = "wrapt-1.13.3-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:77416e6b17926d953b5c666a3cb718d5945df63ecf922af0ee576206d7033b5e"},
-    {file = "wrapt-1.13.3-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:865c0b50003616f05858b22174c40ffc27a38e67359fa1495605f96125f76640"},
-    {file = "wrapt-1.13.3-cp39-cp39-win32.whl", hash = "sha256:0a017a667d1f7411816e4bf214646d0ad5b1da2c1ea13dec6c162736ff25a374"},
-    {file = "wrapt-1.13.3-cp39-cp39-win_amd64.whl", hash = "sha256:81bd7c90d28a4b2e1df135bfbd7c23aee3050078ca6441bead44c42483f9ebfb"},
-    {file = "wrapt-1.13.3.tar.gz", hash = "sha256:1fea9cd438686e6682271d36f3481a9f3636195578bab9ca3382e2f5f01fc185"},
+    {file = "wrapt-1.14.1-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:1b376b3f4896e7930f1f772ac4b064ac12598d1c38d04907e696cc4d794b43d3"},
+    {file = "wrapt-1.14.1-cp27-cp27m-manylinux1_i686.whl", hash = "sha256:903500616422a40a98a5a3c4ff4ed9d0066f3b4c951fa286018ecdf0750194ef"},
+    {file = "wrapt-1.14.1-cp27-cp27m-manylinux1_x86_64.whl", hash = "sha256:5a9a0d155deafd9448baff28c08e150d9b24ff010e899311ddd63c45c2445e28"},
+    {file = "wrapt-1.14.1-cp27-cp27m-manylinux2010_i686.whl", hash = "sha256:ddaea91abf8b0d13443f6dac52e89051a5063c7d014710dcb4d4abb2ff811a59"},
+    {file = "wrapt-1.14.1-cp27-cp27m-manylinux2010_x86_64.whl", hash = "sha256:36f582d0c6bc99d5f39cd3ac2a9062e57f3cf606ade29a0a0d6b323462f4dd87"},
+    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux1_i686.whl", hash = "sha256:7ef58fb89674095bfc57c4069e95d7a31cfdc0939e2a579882ac7d55aadfd2a1"},
+    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux1_x86_64.whl", hash = "sha256:e2f83e18fe2f4c9e7db597e988f72712c0c3676d337d8b101f6758107c42425b"},
+    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux2010_i686.whl", hash = "sha256:ee2b1b1769f6707a8a445162ea16dddf74285c3964f605877a20e38545c3c462"},
+    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux2010_x86_64.whl", hash = "sha256:833b58d5d0b7e5b9832869f039203389ac7cbf01765639c7309fd50ef619e0b1"},
+    {file = "wrapt-1.14.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:80bb5c256f1415f747011dc3604b59bc1f91c6e7150bd7db03b19170ee06b320"},
+    {file = "wrapt-1.14.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:07f7a7d0f388028b2df1d916e94bbb40624c59b48ecc6cbc232546706fac74c2"},
+    {file = "wrapt-1.14.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:02b41b633c6261feff8ddd8d11c711df6842aba629fdd3da10249a53211a72c4"},
+    {file = "wrapt-1.14.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2fe803deacd09a233e4762a1adcea5db5d31e6be577a43352936179d14d90069"},
+    {file = "wrapt-1.14.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:257fd78c513e0fb5cdbe058c27a0624c9884e735bbd131935fd49e9fe719d310"},
+    {file = "wrapt-1.14.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:4fcc4649dc762cddacd193e6b55bc02edca674067f5f98166d7713b193932b7f"},
+    {file = "wrapt-1.14.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:11871514607b15cfeb87c547a49bca19fde402f32e2b1c24a632506c0a756656"},
+    {file = "wrapt-1.14.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:8ad85f7f4e20964db4daadcab70b47ab05c7c1cf2a7c1e51087bfaa83831854c"},
+    {file = "wrapt-1.14.1-cp310-cp310-win32.whl", hash = "sha256:a9a52172be0b5aae932bef82a79ec0a0ce87288c7d132946d645eba03f0ad8a8"},
+    {file = "wrapt-1.14.1-cp310-cp310-win_amd64.whl", hash = "sha256:6d323e1554b3d22cfc03cd3243b5bb815a51f5249fdcbb86fda4bf62bab9e164"},
+    {file = "wrapt-1.14.1-cp35-cp35m-manylinux1_i686.whl", hash = "sha256:43ca3bbbe97af00f49efb06e352eae40434ca9d915906f77def219b88e85d907"},
+    {file = "wrapt-1.14.1-cp35-cp35m-manylinux1_x86_64.whl", hash = "sha256:6b1a564e6cb69922c7fe3a678b9f9a3c54e72b469875aa8018f18b4d1dd1adf3"},
+    {file = "wrapt-1.14.1-cp35-cp35m-manylinux2010_i686.whl", hash = "sha256:00b6d4ea20a906c0ca56d84f93065b398ab74b927a7a3dbd470f6fc503f95dc3"},
+    {file = "wrapt-1.14.1-cp35-cp35m-manylinux2010_x86_64.whl", hash = "sha256:a85d2b46be66a71bedde836d9e41859879cc54a2a04fad1191eb50c2066f6e9d"},
+    {file = "wrapt-1.14.1-cp35-cp35m-win32.whl", hash = "sha256:dbcda74c67263139358f4d188ae5faae95c30929281bc6866d00573783c422b7"},
+    {file = "wrapt-1.14.1-cp35-cp35m-win_amd64.whl", hash = "sha256:b21bb4c09ffabfa0e85e3a6b623e19b80e7acd709b9f91452b8297ace2a8ab00"},
+    {file = "wrapt-1.14.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:9e0fd32e0148dd5dea6af5fee42beb949098564cc23211a88d799e434255a1f4"},
+    {file = "wrapt-1.14.1-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9736af4641846491aedb3c3f56b9bc5568d92b0692303b5a305301a95dfd38b1"},
+    {file = "wrapt-1.14.1-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5b02d65b9ccf0ef6c34cba6cf5bf2aab1bb2f49c6090bafeecc9cd81ad4ea1c1"},
+    {file = "wrapt-1.14.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:21ac0156c4b089b330b7666db40feee30a5d52634cc4560e1905d6529a3897ff"},
+    {file = "wrapt-1.14.1-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:9f3e6f9e05148ff90002b884fbc2a86bd303ae847e472f44ecc06c2cd2fcdb2d"},
+    {file = "wrapt-1.14.1-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:6e743de5e9c3d1b7185870f480587b75b1cb604832e380d64f9504a0535912d1"},
+    {file = "wrapt-1.14.1-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:d79d7d5dc8a32b7093e81e97dad755127ff77bcc899e845f41bf71747af0c569"},
+    {file = "wrapt-1.14.1-cp36-cp36m-win32.whl", hash = "sha256:81b19725065dcb43df02b37e03278c011a09e49757287dca60c5aecdd5a0b8ed"},
+    {file = "wrapt-1.14.1-cp36-cp36m-win_amd64.whl", hash = "sha256:b014c23646a467558be7da3d6b9fa409b2c567d2110599b7cf9a0c5992b3b471"},
+    {file = "wrapt-1.14.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:88bd7b6bd70a5b6803c1abf6bca012f7ed963e58c68d76ee20b9d751c74a3248"},
+    {file = "wrapt-1.14.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b5901a312f4d14c59918c221323068fad0540e34324925c8475263841dbdfe68"},
+    {file = "wrapt-1.14.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d77c85fedff92cf788face9bfa3ebaa364448ebb1d765302e9af11bf449ca36d"},
+    {file = "wrapt-1.14.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8d649d616e5c6a678b26d15ece345354f7c2286acd6db868e65fcc5ff7c24a77"},
+    {file = "wrapt-1.14.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:7d2872609603cb35ca513d7404a94d6d608fc13211563571117046c9d2bcc3d7"},
+    {file = "wrapt-1.14.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:ee6acae74a2b91865910eef5e7de37dc6895ad96fa23603d1d27ea69df545015"},
+    {file = "wrapt-1.14.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:2b39d38039a1fdad98c87279b48bc5dce2c0ca0d73483b12cb72aa9609278e8a"},
+    {file = "wrapt-1.14.1-cp37-cp37m-win32.whl", hash = "sha256:60db23fa423575eeb65ea430cee741acb7c26a1365d103f7b0f6ec412b893853"},
+    {file = "wrapt-1.14.1-cp37-cp37m-win_amd64.whl", hash = "sha256:709fe01086a55cf79d20f741f39325018f4df051ef39fe921b1ebe780a66184c"},
+    {file = "wrapt-1.14.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:8c0ce1e99116d5ab21355d8ebe53d9460366704ea38ae4d9f6933188f327b456"},
+    {file = "wrapt-1.14.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:e3fb1677c720409d5f671e39bac6c9e0e422584e5f518bfd50aa4cbbea02433f"},
+    {file = "wrapt-1.14.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:642c2e7a804fcf18c222e1060df25fc210b9c58db7c91416fb055897fc27e8cc"},
+    {file = "wrapt-1.14.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7b7c050ae976e286906dd3f26009e117eb000fb2cf3533398c5ad9ccc86867b1"},
+    {file = "wrapt-1.14.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ef3f72c9666bba2bab70d2a8b79f2c6d2c1a42a7f7e2b0ec83bb2f9e383950af"},
+    {file = "wrapt-1.14.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:01c205616a89d09827986bc4e859bcabd64f5a0662a7fe95e0d359424e0e071b"},
+    {file = "wrapt-1.14.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:5a0f54ce2c092aaf439813735584b9537cad479575a09892b8352fea5e988dc0"},
+    {file = "wrapt-1.14.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:2cf71233a0ed05ccdabe209c606fe0bac7379fdcf687f39b944420d2a09fdb57"},
+    {file = "wrapt-1.14.1-cp38-cp38-win32.whl", hash = "sha256:aa31fdcc33fef9eb2552cbcbfee7773d5a6792c137b359e82879c101e98584c5"},
+    {file = "wrapt-1.14.1-cp38-cp38-win_amd64.whl", hash = "sha256:d1967f46ea8f2db647c786e78d8cc7e4313dbd1b0aca360592d8027b8508e24d"},
+    {file = "wrapt-1.14.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:3232822c7d98d23895ccc443bbdf57c7412c5a65996c30442ebe6ed3df335383"},
+    {file = "wrapt-1.14.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:988635d122aaf2bdcef9e795435662bcd65b02f4f4c1ae37fbee7401c440b3a7"},
+    {file = "wrapt-1.14.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9cca3c2cdadb362116235fdbd411735de4328c61425b0aa9f872fd76d02c4e86"},
+    {file = "wrapt-1.14.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d52a25136894c63de15a35bc0bdc5adb4b0e173b9c0d07a2be9d3ca64a332735"},
+    {file = "wrapt-1.14.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:40e7bc81c9e2b2734ea4bc1aceb8a8f0ceaac7c5299bc5d69e37c44d9081d43b"},
+    {file = "wrapt-1.14.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:b9b7a708dd92306328117d8c4b62e2194d00c365f18eff11a9b53c6f923b01e3"},
+    {file = "wrapt-1.14.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:6a9a25751acb379b466ff6be78a315e2b439d4c94c1e99cb7266d40a537995d3"},
+    {file = "wrapt-1.14.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:34aa51c45f28ba7f12accd624225e2b1e5a3a45206aa191f6f9aac931d9d56fe"},
+    {file = "wrapt-1.14.1-cp39-cp39-win32.whl", hash = "sha256:dee0ce50c6a2dd9056c20db781e9c1cfd33e77d2d569f5d1d9321c641bb903d5"},
+    {file = "wrapt-1.14.1-cp39-cp39-win_amd64.whl", hash = "sha256:dee60e1de1898bde3b238f18340eec6148986da0455d8ba7848d50470a7a32fb"},
+    {file = "wrapt-1.14.1.tar.gz", hash = "sha256:380a85cf89e0e69b7cfbe2ea9f765f004ff419f34194018a6827ac0e3edfed4d"},
 ]
 wsrpc-aiohttp = [
     {file = "wsrpc-aiohttp-3.2.0.tar.gz", hash = "sha256:f467abc51bcdc760fc5aeb7041abdeef46eeca3928dc43dd6e7fa7a533563818"},
@@ -2954,6 +3070,6 @@ yarl = [
     {file = "yarl-1.7.2.tar.gz", hash = "sha256:45399b46d60c253327a460e99856752009fcee5f5d3c80b2f7c0cae1c38d56dd"},
 ]
 zipp = [
-    {file = "zipp-3.7.0-py3-none-any.whl", hash = "sha256:b47250dd24f92b7dd6a0a8fc5244da14608f3ca90a5efcd37a3b1642fac9a375"},
-    {file = "zipp-3.7.0.tar.gz", hash = "sha256:9f50f446828eb9d45b267433fd3e9da8d801f614129124863f9c51ebceafb87d"},
+    {file = "zipp-3.8.0-py3-none-any.whl", hash = "sha256:c4f6e5bbf48e74f7a38e7cc5b0480ff42b0ae5178957d564d18932525d5cf099"},
+    {file = "zipp-3.8.0.tar.gz", hash = "sha256:56bf8aadb83c24db6c4b577e13de374ccfb67da2078beba1d037c17980bf43ad"},
 ]

From 93caf11efdc0f4bfe0504bdb5ac973babf06028a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 17:10:55 +0200
Subject: [PATCH 0519/1227] added fake 'charset_normalizer' for python 2 hosts

---
 openpype/vendor/python/python_2/charset_normalizer.py | 8 ++++++++
 1 file changed, 8 insertions(+)
 create mode 100644 openpype/vendor/python/python_2/charset_normalizer.py

diff --git a/openpype/vendor/python/python_2/charset_normalizer.py b/openpype/vendor/python/python_2/charset_normalizer.py
new file mode 100644
index 0000000000..84ec661759
--- /dev/null
+++ b/openpype/vendor/python/python_2/charset_normalizer.py
@@ -0,0 +1,8 @@
+"""Fake 'charset_normalizer' for Python 2 to raise ImportError.
+
+Needed for 'requests' module which first checks for existence of
+'charset_normalizer' (Python 3) but does not raise 'ImportError' but
+'SyntaxError'.
+"""
+
+raise ImportError("charset_normalizer not available")

From 248e38b52d1bfbd14226fbe79a12d4f2f5a8a016 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 8 Jun 2022 17:22:30 +0200
Subject: [PATCH 0520/1227] Deadline: adding condition for `review` instance
 data key

to be able to pass review to metadata json from nuke
---
 .../deadline/plugins/publish/submit_publish_job.py        | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 78ab935e42..1891731c93 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -640,6 +640,10 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
 
     def _solve_families(self, instance, preview=False):
         families = instance.get("families")
+
+        # test also instance data review attribute
+        preview = preview or instance.get("review")
+
         # if we have one representation with preview tag
         # flag whole instance for review and for ftrack
         if preview:
@@ -749,6 +753,10 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
                 "family": "prerender",
                 "families": []})
 
+        # also include review attribute if available
+        if "review" in data:
+            instance_skeleton_data["review"] = data["review"]
+
         # skip locking version if we are creating v01
         instance_version = instance.data.get("version")  # take this if exists
         if instance_version != 1:

From 6758bcc2a2aec0139ed2a448daba3c08ea60a584 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 8 Jun 2022 17:22:55 +0200
Subject: [PATCH 0521/1227] Nuke: wrong name in docstring

---
 openpype/hosts/nuke/plugins/publish/extract_render_local.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_render_local.py b/openpype/hosts/nuke/plugins/publish/extract_render_local.py
index 50a5d01483..057bca11ac 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_render_local.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_render_local.py
@@ -7,7 +7,7 @@ import clique
 
 class NukeRenderLocal(openpype.api.Extractor):
     # TODO: rewrite docstring to nuke
-    """Render the current Fusion composition locally.
+    """Render the current Nuke composition locally.
 
     Extract the result of savers by starting a comp render
     This will run the local render of Fusion.

From e4cee4a98ddd4150ee371d338350aefc4964df49 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 19:18:20 +0200
Subject: [PATCH 0522/1227] fix loader

---
 openpype/tools/loader/model.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/openpype/tools/loader/model.py b/openpype/tools/loader/model.py
index e8e0480d9c..f2b7e9a6a4 100644
--- a/openpype/tools/loader/model.py
+++ b/openpype/tools/loader/model.py
@@ -206,9 +206,6 @@ class SubsetsModel(TreeModel, BaseRepresentationModel):
         if subset_doc_projection:
             self.subset_doc_projection = subset_doc_projection
 
-        self.asset_doc_projection = asset_doc_projection
-        self.subset_doc_projection = subset_doc_projection
-
         self.repre_icons = {}
         self.sync_server = None
         self.active_site = self.active_provider = None

From 1cea16b97b416cda2cd12fca9365b046bc05a2eb Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 19:18:27 +0200
Subject: [PATCH 0523/1227] fix launcher

---
 openpype/tools/launcher/models.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/tools/launcher/models.py b/openpype/tools/launcher/models.py
index 307f591d96..3f899cc05e 100644
--- a/openpype/tools/launcher/models.py
+++ b/openpype/tools/launcher/models.py
@@ -651,9 +651,9 @@ class LauncherModel(QtCore.QObject):
             self._asset_refresh_thread = None
 
     def _refresh_assets(self):
-        asset_docs = get_assets(
-            self._last_project_name, fields=list(self._asset_projection.keys())
-        )
+        asset_docs = list(get_assets(
+            self._last_project_name, fields=self._asset_projection.keys()
+        ))
         if not self._refreshing_assets:
             return
         self._refreshing_assets = False

From 6fcf8722370fcbdf7fabba7dcc1012f8484f836a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 8 Jun 2022 19:20:53 +0200
Subject: [PATCH 0524/1227] fix get_last_version

---
 openpype/client/entities.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 2459ea3e92..66204a4b19 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -655,6 +655,10 @@ def get_last_versions(project_name, subset_ids, fields=None):
         doc["_version_id"]
         for doc in conn.aggregate(_pipeline)
     ]
+    fields = _prepare_fields(fields)
+    if fields and "parent" not in fields:
+        fields.append("parent")
+
     version_docs = get_versions(
         project_name, version_ids=version_ids, fields=fields
     )

From b63ae623f4715401528f61fe8e469f47a70a0e5c Mon Sep 17 00:00:00 2001
From: "felix.wang" <icyvapor@gmail.com>
Date: Wed, 8 Jun 2022 14:54:42 -0700
Subject: [PATCH 0525/1227] Borrowed child node discovery logic from
 Colorbleed, to properly support instanced objects.

---
 .../maya/plugins/publish/collect_instances.py | 49 ++++++++++++++++---
 .../plugins/publish/extract_pointcache.py     | 11 +++--
 2 files changed, 49 insertions(+), 11 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_instances.py b/openpype/hosts/maya/plugins/publish/collect_instances.py
index 1d59a68bf6..48cc446541 100644
--- a/openpype/hosts/maya/plugins/publish/collect_instances.py
+++ b/openpype/hosts/maya/plugins/publish/collect_instances.py
@@ -1,9 +1,50 @@
 from maya import cmds
+import maya.api.OpenMaya as om
 
 import pyblish.api
 import json
 
 
+def get_all_children(nodes):
+    """Return all children of `nodes` including each instanced child.
+    Using maya.cmds.listRelatives(allDescendents=True) includes only the first
+    instance. As such, this function acts as an optimal replacement with a
+    focus on a fast query.
+    Borrowed from Colorbleed: https://tinyurl.com/bdht6fyh
+
+    """
+
+    sel = om.MSelectionList()
+    traversed = set()
+    iterator = om.MItDag(om.MItDag.kDepthFirst)
+    for node in nodes:
+
+        if node in traversed:
+            # Ignore if already processed as a child
+            # before
+            continue
+
+        sel.clear()
+        sel.add(node)
+        dag = sel.getDagPath(0)
+
+        iterator.reset(dag)
+        iterator.next()  # ignore self
+        while not iterator.isDone():
+
+            path = iterator.fullPathName()
+
+            if path in traversed:
+                iterator.prune()
+                iterator.next()
+                continue
+
+            traversed.add(path)
+            iterator.next()
+
+    return list(traversed)
+
+
 class CollectInstances(pyblish.api.ContextPlugin):
     """Gather instances by objectSet and pre-defined attribute
 
@@ -86,12 +127,8 @@ class CollectInstances(pyblish.api.ContextPlugin):
             # Collect members
             members = cmds.ls(members, long=True) or []
 
-            # `maya.cmds.listRelatives(noIntermediate=True)` only works when
-            # `shapes=True` argument is passed, since we also want to include
-            # transforms we filter afterwards.
-            children = cmds.listRelatives(members,
-                                          allDescendents=True,
-                                          fullPath=True) or []
+            dag_members = cmds.ls(members, type="dagNode", long=True)
+            children = get_all_children(dag_members)
             children = cmds.ls(children, noIntermediate=True, long=True)
 
             parents = []
diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index 4aaf223403..33bcdaf92c 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -65,7 +65,7 @@ class ExtractAlembic(openpype.api.Extractor):
             "writeColorSets": writeColorSets,
             "writeFaceSets": writeFaceSets,
             "uvWrite": True,
-            "selection": False,
+            "selection": True,
             "worldSpace": instance.data.get("worldSpace", True)
         }
 
@@ -80,10 +80,11 @@ class ExtractAlembic(openpype.api.Extractor):
             options["writeUVSets"] = True
 
         with suspended_refresh():
-            extract_alembic(file=path,
-                            startFrame=start,
-                            endFrame=end,
-                            **options)
+            with maintained_selection():
+                extract_alembic(file=path,
+                                startFrame=start,
+                                endFrame=end,
+                                **options)
 
         if "representations" not in instance.data:
             instance.data["representations"] = []

From 122536675fb043fda7d62710149c65cfd089d674 Mon Sep 17 00:00:00 2001
From: "felix.wang" <icyvapor@gmail.com>
Date: Wed, 8 Jun 2022 14:58:50 -0700
Subject: [PATCH 0526/1227] Use next() builtin

---
 openpype/hosts/maya/plugins/publish/collect_instances.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_instances.py b/openpype/hosts/maya/plugins/publish/collect_instances.py
index 48cc446541..c76afe53f6 100644
--- a/openpype/hosts/maya/plugins/publish/collect_instances.py
+++ b/openpype/hosts/maya/plugins/publish/collect_instances.py
@@ -29,18 +29,18 @@ def get_all_children(nodes):
         dag = sel.getDagPath(0)
 
         iterator.reset(dag)
-        iterator.next()  # ignore self
+        next(iterator)  # ignore self
         while not iterator.isDone():
 
             path = iterator.fullPathName()
 
             if path in traversed:
                 iterator.prune()
-                iterator.next()
+                next(iterator)
                 continue
 
             traversed.add(path)
-            iterator.next()
+            next(iterator)
 
     return list(traversed)
 

From ce7b19d51b687f2e5a8abff64c8b741fd933bbad Mon Sep 17 00:00:00 2001
From: "felix.wang" <icyvapor@gmail.com>
Date: Wed, 8 Jun 2022 15:04:55 -0700
Subject: [PATCH 0527/1227] Change back to do actual selection.

---
 openpype/hosts/maya/plugins/publish/extract_pointcache.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index 33bcdaf92c..c4c8610ebb 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -81,6 +81,7 @@ class ExtractAlembic(openpype.api.Extractor):
 
         with suspended_refresh():
             with maintained_selection():
+                cmds.select(nodes, noExpand=True)
                 extract_alembic(file=path,
                                 startFrame=start,
                                 endFrame=end,

From a1e95dd15ad7c4e73837262b8f2de3bf543213c4 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 9 Jun 2022 10:58:18 +0300
Subject: [PATCH 0528/1227] Fix oiio subprocess arguments.

---
 openpype/plugins/publish/extract_jpeg_exr.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index f474714780..e509063dca 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -130,9 +130,8 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                     src_path, "-o",
                     dst_path
                     ]
-        subprocess_exr = " ".join(oiio_cmd)
-        self.log.info(f"running: {subprocess_exr}")
-        run_subprocess(subprocess_exr, logger=self.log)
+        self.log.info(f"running: {oiio_cmd}")
+        run_subprocess(oiio_cmd, logger=self.log)
 
     def create_thumbnail_ffmpeg(self, src_path, dst_path):
         self.log.info("outputting {}".format(dst_path))

From f79f9347ece5db8001608b595cff4cee67e16164 Mon Sep 17 00:00:00 2001
From: "Allan I. A" <76656700+Allan-I@users.noreply.github.com>
Date: Thu, 9 Jun 2022 11:12:48 +0300
Subject: [PATCH 0529/1227] Update openpype/plugins/publish/extract_jpeg_exr.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/plugins/publish/extract_jpeg_exr.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index e509063dca..0bbfd95862 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -161,5 +161,5 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         jpeg_items.append(path_to_subprocess_arg(dst_path))
         subprocess_command = " ".join(jpeg_items)
         run_subprocess(
-                subprocess_command, shell=True, logger=self.log
-            )
+            subprocess_command, shell=True, logger=self.log
+        )

From 012f21ce86e12daeee549830b4cbfdca03991709 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 9 Jun 2022 11:17:01 +0300
Subject: [PATCH 0530/1227] Fix error messages.

---
 openpype/plugins/publish/extract_jpeg_exr.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index e509063dca..874a1dc40d 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -83,12 +83,12 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                     self.log.info("Input can be read by OIIO, converting with oiiotool now.")
                     thumbnail_created = self.create_thumbnail_oiio(full_input_path, full_output_path) # noqa
                 else:
-                    self.log.info("converting with")
+                    self.log.info("Converting with FFMPEG because input can't be read by OIIO.")
                     thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path) # noqa
 
             # Skip the rest of the process if the thumbnail wasn't created
             if not thumbnail_created:
-
+                self.log.warning("Thumbanil has not been created.")
                 return
 
             new_repre = {

From 5e817c57e4c46087542fdf85b8866d063e80c933 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 9 Jun 2022 11:18:14 +0300
Subject: [PATCH 0531/1227] Fix style warning.

---
 openpype/plugins/publish/extract_jpeg_exr.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index c40c99b1f8..730d0167c7 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -80,10 +80,10 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                 # If the input can read by OIIO then use OIIO method for
                 # conversion otherwise use ffmpeg
                 if returncode == 0:
-                    self.log.info("Input can be read by OIIO, converting with oiiotool now.")
+                    self.log.info("Input can be read by OIIO, converting with oiiotool now.")   # noqa
                     thumbnail_created = self.create_thumbnail_oiio(full_input_path, full_output_path) # noqa
                 else:
-                    self.log.info("Converting with FFMPEG because input can't be read by OIIO.")
+                    self.log.info("Converting with FFMPEG because input can't be read by OIIO.")    # noqa
                     thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path) # noqa
 
             # Skip the rest of the process if the thumbnail wasn't created

From 5e0589dc57e77f813a32f95afcfc8f508d7cf2ec Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 9 Jun 2022 11:20:27 +0300
Subject: [PATCH 0532/1227] Restore removed logging messaage.

---
 openpype/plugins/publish/extract_jpeg_exr.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 730d0167c7..c658e17cab 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -130,7 +130,8 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                     src_path, "-o",
                     dst_path
                     ]
-        self.log.info(f"running: {oiio_cmd}")
+        subprocess_exr = " ".join(oiio_cmd)
+        self.log.info(f"running: {subprocess_exr}")
         run_subprocess(oiio_cmd, logger=self.log)
 
     def create_thumbnail_ffmpeg(self, src_path, dst_path):

From 886646c0269d3188c9f46deb5bc6f4a7d6a8f131 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 10:34:55 +0200
Subject: [PATCH 0533/1227] modified implemenetation to be able also use review
 session to download delivery

---
 .../event_handlers_user/action_delivery.py    | 244 ++++++++++++------
 1 file changed, 169 insertions(+), 75 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_delivery.py b/openpype/modules/ftrack/event_handlers_user/action_delivery.py
index 9ef2a1668e..86d88ef7cc 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_delivery.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_delivery.py
@@ -8,6 +8,9 @@ from bson.objectid import ObjectId
 from openpype.api import Anatomy, config
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 from openpype_modules.ftrack.lib.avalon_sync import CUST_ATTR_ID_KEY
+from openpype_modules.ftrack.lib.custom_attributes import (
+    query_custom_attributes
+)
 from openpype.lib.delivery import (
     path_from_representation,
     get_format_dict,
@@ -28,14 +31,14 @@ class Delivery(BaseAction):
     settings_key = "delivery_action"
 
     def __init__(self, *args, **kwargs):
-        self.db_con = AvalonMongoDB()
+        self.dbcon = AvalonMongoDB()
 
         super(Delivery, self).__init__(*args, **kwargs)
 
     def discover(self, session, entities, event):
         is_valid = False
         for entity in entities:
-            if entity.entity_type.lower() == "assetversion":
+            if entity.entity_type.lower() in ("assetversion", "reviewsession"):
                 is_valid = True
                 break
 
@@ -54,9 +57,9 @@ class Delivery(BaseAction):
 
         project_entity = self.get_project_from_entity(entities[0])
         project_name = project_entity["full_name"]
-        self.db_con.install()
-        self.db_con.Session["AVALON_PROJECT"] = project_name
-        project_doc = self.db_con.find_one({"type": "project"})
+        self.dbcon.install()
+        self.dbcon.Session["AVALON_PROJECT"] = project_name
+        project_doc = self.dbcon.find_one({"type": "project"}, {"name": True})
         if not project_doc:
             return {
                 "success": False,
@@ -65,8 +68,8 @@ class Delivery(BaseAction):
                 ).format(project_name)
             }
 
-        repre_names = self._get_repre_names(entities)
-        self.db_con.uninstall()
+        repre_names = self._get_repre_names(session, entities)
+        self.dbcon.uninstall()
 
         items.append({
             "type": "hidden",
@@ -195,47 +198,109 @@ class Delivery(BaseAction):
             "title": title
         }
 
-    def _get_repre_names(self, entities):
-        version_ids = self._get_interest_version_ids(entities)
-        repre_docs = self.db_con.find({
+    def _get_repre_names(self, session, entities):
+        version_ids = self._get_interest_version_ids(session, entities)
+        if not version_ids:
+            return []
+        repre_docs = self.dbcon.find({
             "type": "representation",
             "parent": {"$in": version_ids}
         })
         return list(sorted(repre_docs.distinct("name")))
 
-    def _get_interest_version_ids(self, entities):
-        parent_ent_by_id = {}
+    def _get_interest_version_ids(self, session, entities):
+        # Extract AssetVersion entities
+        asset_versions = self._extract_asset_versions(session, entities)
+        # Prepare Asset ids
+        asset_ids = {
+            asset_version["asset_id"]
+            for asset_version in asset_versions
+        }
+        # Query Asset entities
+        assets = session.query((
+            "select id, name, context_id from Asset where id in ({})"
+        ).format(self.join_query_keys(asset_ids))).all()
+        assets_by_id = {
+            asset["id"]: asset
+            for asset in assets
+        }
+        parent_ids = set()
         subset_names = set()
         version_nums = set()
-        for entity in entities:
-            asset = entity["asset"]
-            parent = asset["parent"]
-            parent_ent_by_id[parent["id"]] = parent
+        for asset_version in asset_versions:
+            asset_id = asset_version["asset_id"]
+            asset = assets_by_id[asset_id]
 
-            subset_name = asset["name"]
-            subset_names.add(subset_name)
+            parent_ids.add(asset["context_id"])
+            subset_names.add(asset["name"])
+            version_nums.add(asset_version["version"])
 
-            version = entity["version"]
-            version_nums.add(version)
-
-        asset_docs_by_ftrack_id = self._get_asset_docs(parent_ent_by_id)
+        asset_docs_by_ftrack_id = self._get_asset_docs(session, parent_ids)
         subset_docs = self._get_subset_docs(
-            asset_docs_by_ftrack_id, subset_names, entities
+            asset_docs_by_ftrack_id,
+            subset_names,
+            asset_versions,
+            assets_by_id
         )
         version_docs = self._get_version_docs(
-            asset_docs_by_ftrack_id, subset_docs, version_nums, entities
+            asset_docs_by_ftrack_id,
+            subset_docs,
+            version_nums,
+            asset_versions,
+            assets_by_id
         )
 
         return [version_doc["_id"] for version_doc in version_docs]
 
+    def _extract_asset_versions(self, session, entities):
+        asset_version_ids = set()
+        review_session_ids = set()
+        for entity in entities:
+            entity_type_low = entity.entity_type.lower()
+            if entity_type_low == "assetversion":
+                asset_version_ids.add(entity["id"])
+            elif entity_type_low == "reviewsession":
+                review_session_ids.add(entity["id"])
+
+        for version_id in self._get_asset_version_ids_from_review_sessions(
+            session, review_session_ids
+        ):
+            asset_version_ids.add(version_id)
+
+        asset_versions = session.query((
+            "select id, version, asset_id from AssetVersion where id in ({})"
+        ).format(self.join_query_keys(asset_version_ids))).all()
+
+        return asset_versions
+
+    def _get_asset_version_ids_from_review_sessions(
+        self, session, review_session_ids
+    ):
+        if not review_session_ids:
+            return set()
+        review_session_objects = session.query((
+            "select version_id from ReviewSessionObject"
+            " where review_session_id in ({})"
+        ).format(self.join_query_keys(review_session_ids))).all()
+
+        return {
+            review_session_object["version_id"]
+            for review_session_object in review_session_objects
+        }
+
     def _get_version_docs(
-        self, asset_docs_by_ftrack_id, subset_docs, version_nums, entities
+        self,
+        asset_docs_by_ftrack_id,
+        subset_docs,
+        version_nums,
+        asset_versions,
+        assets_by_id
     ):
         subset_docs_by_id = {
             subset_doc["_id"]: subset_doc
             for subset_doc in subset_docs
         }
-        version_docs = list(self.db_con.find({
+        version_docs = list(self.dbcon.find({
             "type": "version",
             "parent": {"$in": list(subset_docs_by_id.keys())},
             "name": {"$in": list(version_nums)}
@@ -255,11 +320,13 @@ class Delivery(BaseAction):
             )
 
         filtered_versions = []
-        for entity in entities:
-            asset = entity["asset"]
-
-            parent = asset["parent"]
-            asset_doc = asset_docs_by_ftrack_id[parent["id"]]
+        for asset_version in asset_versions:
+            asset_id = asset_version["asset_id"]
+            asset = assets_by_id[asset_id]
+            parent_id = asset["context_id"]
+            asset_doc = asset_docs_by_ftrack_id.get(parent_id)
+            if not asset_doc:
+                continue
 
             subsets_by_name = version_docs_by_parent_id.get(asset_doc["_id"])
             if not subsets_by_name:
@@ -270,20 +337,24 @@ class Delivery(BaseAction):
             if not version_docs_by_version:
                 continue
 
-            version = entity["version"]
+            version = asset_version["version"]
             version_doc = version_docs_by_version.get(version)
             if version_doc:
                 filtered_versions.append(version_doc)
         return filtered_versions
 
     def _get_subset_docs(
-        self, asset_docs_by_ftrack_id, subset_names, entities
+        self,
+        asset_docs_by_ftrack_id,
+        subset_names,
+        asset_versions,
+        assets_by_id
     ):
-        asset_doc_ids = list()
-        for asset_doc in asset_docs_by_ftrack_id.values():
-            asset_doc_ids.append(asset_doc["_id"])
-
-        subset_docs = list(self.db_con.find({
+        asset_doc_ids = [
+            asset_doc["_id"]
+            for asset_doc in asset_docs_by_ftrack_id.values()
+        ]
+        subset_docs = list(self.dbcon.find({
             "type": "subset",
             "parent": {"$in": asset_doc_ids},
             "name": {"$in": list(subset_names)}
@@ -295,11 +366,14 @@ class Delivery(BaseAction):
             subset_docs_by_parent_id[asset_id][subset_name] = subset_doc
 
         filtered_subsets = []
-        for entity in entities:
-            asset = entity["asset"]
+        for asset_version in asset_versions:
+            asset_id = asset_version["asset_id"]
+            asset = assets_by_id[asset_id]
 
-            parent = asset["parent"]
-            asset_doc = asset_docs_by_ftrack_id[parent["id"]]
+            parent_id = asset["context_id"]
+            asset_doc = asset_docs_by_ftrack_id.get(parent_id)
+            if not asset_doc:
+                continue
 
             subsets_by_name = subset_docs_by_parent_id.get(asset_doc["_id"])
             if not subsets_by_name:
@@ -311,40 +385,60 @@ class Delivery(BaseAction):
                 filtered_subsets.append(subset_doc)
         return filtered_subsets
 
-    def _get_asset_docs(self, parent_ent_by_id):
-        asset_docs = list(self.db_con.find({
+    def _get_asset_docs(self, session, parent_ids):
+        asset_docs = list(self.dbcon.find({
             "type": "asset",
-            "data.ftrackId": {"$in": list(parent_ent_by_id.keys())}
+            "data.ftrackId": {"$in": list(parent_ids)}
         }))
-        asset_docs_by_ftrack_id = {
-            asset_doc["data"]["ftrackId"]: asset_doc
-            for asset_doc in asset_docs
+
+        asset_docs_by_ftrack_id = {}
+        for asset_doc in asset_docs:
+            ftrack_id = asset_doc["data"].get("ftrackId")
+            if ftrack_id:
+                asset_docs_by_ftrack_id[ftrack_id] = asset_doc
+
+        attr_def = session.query((
+            "select id from CustomAttributeConfiguration where key is \"{}\""
+        ).format(CUST_ATTR_ID_KEY)).first()
+        if attr_def is None:
+            return asset_docs_by_ftrack_id
+
+        avalon_mongo_id_values = query_custom_attributes(
+            session, [attr_def["id"]], parent_ids, True
+        )
+        entity_ids_by_mongo_id = {
+            ObjectId(item["value"]): item["entity_id"]
+            for item in avalon_mongo_id_values
+            if item["value"]
         }
 
-        entities_by_mongo_id = {}
-        entities_by_names = {}
-        for ftrack_id, entity in parent_ent_by_id.items():
-            if ftrack_id not in asset_docs_by_ftrack_id:
-                parent_mongo_id = entity["custom_attributes"].get(
-                    CUST_ATTR_ID_KEY
-                )
-                if parent_mongo_id:
-                    entities_by_mongo_id[ObjectId(parent_mongo_id)] = entity
-                else:
-                    entities_by_names[entity["name"]] = entity
+        missing_ids = set(parent_ids)
+        for entity_id in set(entity_ids_by_mongo_id.values()):
+            if entity_id in missing_ids:
+                missing_ids.remove(entity_id)
+
+        entity_ids_by_name = {}
+        if missing_ids:
+            not_found_entities = session.query((
+                "select id, name from TypedContext where id in ({})"
+            ).format(self.join_query_keys(missing_ids))).all()
+            entity_ids_by_name = {
+                entity["name"]: entity["id"]
+                for entity in not_found_entities
+            }
 
         expressions = []
-        if entities_by_mongo_id:
+        if entity_ids_by_mongo_id:
             expression = {
                 "type": "asset",
-                "_id": {"$in": list(entities_by_mongo_id.keys())}
+                "_id": {"$in": list(entity_ids_by_mongo_id.keys())}
             }
             expressions.append(expression)
 
-        if entities_by_names:
+        if entity_ids_by_name:
             expression = {
                 "type": "asset",
-                "name": {"$in": list(entities_by_names.keys())}
+                "name": {"$in": list(entity_ids_by_name.keys())}
             }
             expressions.append(expression)
 
@@ -354,15 +448,15 @@ class Delivery(BaseAction):
             else:
                 filter = {"$or": expressions}
 
-            asset_docs = self.db_con.find(filter)
+            asset_docs = self.dbcon.find(filter)
             for asset_doc in asset_docs:
-                if asset_doc["_id"] in entities_by_mongo_id:
-                    entity = entities_by_mongo_id[asset_doc["_id"]]
-                    asset_docs_by_ftrack_id[entity["id"]] = asset_doc
+                if asset_doc["_id"] in entity_ids_by_mongo_id:
+                    entity_id = entity_ids_by_mongo_id[asset_doc["_id"]]
+                    asset_docs_by_ftrack_id[entity_id] = asset_doc
 
-                elif asset_doc["name"] in entities_by_names:
-                    entity = entities_by_names[asset_doc["name"]]
-                    asset_docs_by_ftrack_id[entity["id"]] = asset_doc
+                elif asset_doc["name"] in entity_ids_by_name:
+                    entity_id = entity_ids_by_name[asset_doc["name"]]
+                    asset_docs_by_ftrack_id[entity_id] = asset_doc
 
         return asset_docs_by_ftrack_id
 
@@ -396,7 +490,7 @@ class Delivery(BaseAction):
         session.commit()
 
         try:
-            self.db_con.install()
+            self.dbcon.install()
             report = self.real_launch(session, entities, event)
 
         except Exception as exc:
@@ -422,7 +516,7 @@ class Delivery(BaseAction):
             else:
                 job["status"] = "failed"
             session.commit()
-            self.db_con.uninstall()
+            self.dbcon.uninstall()
 
         if not report["success"]:
             self.show_interface(
@@ -464,11 +558,11 @@ class Delivery(BaseAction):
             if not os.path.exists(location_path):
                 os.makedirs(location_path)
 
-        self.db_con.Session["AVALON_PROJECT"] = project_name
+        self.dbcon.Session["AVALON_PROJECT"] = project_name
 
         self.log.debug("Collecting representations to process.")
-        version_ids = self._get_interest_version_ids(entities)
-        repres_to_deliver = list(self.db_con.find({
+        version_ids = self._get_interest_version_ids(session, entities)
+        repres_to_deliver = list(self.dbcon.find({
             "type": "representation",
             "parent": {"$in": version_ids},
             "name": {"$in": repre_names}

From 6b9a1b834d3de4f1d2b399c916a50ac1282a4b6f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 10:48:29 +0200
Subject: [PATCH 0534/1227] convert queried cursor to list in scene inventory

---
 openpype/tools/sceneinventory/view.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/tools/sceneinventory/view.py b/openpype/tools/sceneinventory/view.py
index 8164c48a5d..0b54d40ed7 100644
--- a/openpype/tools/sceneinventory/view.py
+++ b/openpype/tools/sceneinventory/view.py
@@ -669,11 +669,11 @@ class SceneInventoryView(QtWidgets.QTreeView):
             fields=["parent"]
         )
 
-        version_docs = get_versions(
+        version_docs = list(get_versions(
             project_name,
             subset_ids=[repre_version_doc["parent"]],
             hero=True
-        )
+        ))
         hero_version = None
         standard_versions = []
         for version_doc in version_docs:

From 39ea438d7d8c2010b914c300ae84f6536e71e0a4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 10:51:33 +0200
Subject: [PATCH 0535/1227] fix typo in passed kwarg

---
 openpype/tools/sceneinventory/view.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/tools/sceneinventory/view.py b/openpype/tools/sceneinventory/view.py
index 0b54d40ed7..63d181b2d6 100644
--- a/openpype/tools/sceneinventory/view.py
+++ b/openpype/tools/sceneinventory/view.py
@@ -92,7 +92,7 @@ class SceneInventoryView(QtWidgets.QTreeView):
 
         project_name = legacy_io.active_project()
         repre_docs = get_representations(
-            project_name, representaion_ids=repre_ids, fields=["parent"]
+            project_name, representation_ids=repre_ids, fields=["parent"]
         )
 
         version_ids = []

From a48d77e609f84a7a04bf5de95fce12e05461ca6c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 10:53:15 +0200
Subject: [PATCH 0536/1227] conver repres cursor to list

---
 openpype/tools/sceneinventory/switch_dialog.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/tools/sceneinventory/switch_dialog.py b/openpype/tools/sceneinventory/switch_dialog.py
index 92ef2b3553..aa4dcd73cd 100644
--- a/openpype/tools/sceneinventory/switch_dialog.py
+++ b/openpype/tools/sceneinventory/switch_dialog.py
@@ -165,11 +165,11 @@ class SwitchAssetDialog(QtWidgets.QDialog):
             content_loaders.add(item["loader"])
 
         project_name = self.active_project()
-        repres = get_representations(
+        repres = list(get_representations(
             project_name,
             representation_ids=repre_ids,
             archived=True
-        )
+        ))
         repres_by_id = {repre["_id"]: repre for repre in repres}
 
         # stash context values, works only for single representation

From bae1e38112cc8a756388b92f1447c5e69112e6ab Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 10:59:04 +0200
Subject: [PATCH 0537/1227] fix kwargs name in switch dialog

---
 openpype/tools/sceneinventory/switch_dialog.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/tools/sceneinventory/switch_dialog.py b/openpype/tools/sceneinventory/switch_dialog.py
index aa4dcd73cd..1d1d5cbb91 100644
--- a/openpype/tools/sceneinventory/switch_dialog.py
+++ b/openpype/tools/sceneinventory/switch_dialog.py
@@ -944,7 +944,7 @@ class SwitchAssetDialog(QtWidgets.QDialog):
         repre_docs = list(
             get_representations(
                 project_name,
-                subset_ids=subset_id_by_version_id.keys(),
+                version_ids=subset_id_by_version_id.keys(),
                 fields=["name", "parent"]
             )
         )
@@ -1102,7 +1102,7 @@ class SwitchAssetDialog(QtWidgets.QDialog):
 
             repre_docs = get_representations(
                 project_name,
-                subset_ids=subset_id_by_version_id.keys(),
+                version_ids=subset_id_by_version_id.keys(),
                 fields=["name", "parent"]
             )
             repres_by_subset_name = {}

From 57e72c2c3722f232b58a81454b3f46dbd7cba647 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 11:32:49 +0200
Subject: [PATCH 0538/1227] minor changesminor changes in representation widget

---
 openpype/tools/loader/model.py   | 23 +++++++++++------------
 openpype/tools/loader/widgets.py |  4 ++--
 2 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/openpype/tools/loader/model.py b/openpype/tools/loader/model.py
index f2b7e9a6a4..f030e94256 100644
--- a/openpype/tools/loader/model.py
+++ b/openpype/tools/loader/model.py
@@ -231,7 +231,7 @@ class SubsetsModel(TreeModel, BaseRepresentationModel):
         self._doc_fetching_stop = False
         self._doc_payload = {}
 
-        self.doc_fetched.connect(self.on_doc_fetched)
+        self.doc_fetched.connect(self._on_doc_fetched)
 
         self.refresh()
 
@@ -250,7 +250,7 @@ class SubsetsModel(TreeModel, BaseRepresentationModel):
 
     def set_grouping(self, state):
         self._grouping = state
-        self.on_doc_fetched()
+        self._on_doc_fetched()
 
     def get_subsets_families(self):
         return self._doc_payload.get("subset_families") or set()
@@ -528,7 +528,7 @@ class SubsetsModel(TreeModel, BaseRepresentationModel):
 
         self.fetch_subset_and_version()
 
-    def on_doc_fetched(self):
+    def _on_doc_fetched(self):
         self.clear()
         self._items_by_id = {}
         self.beginResetModel()
@@ -1019,7 +1019,6 @@ class RepresentationSortProxyModel(GroupMemberFilterProxyModel):
 
 
 class RepresentationModel(TreeModel, BaseRepresentationModel):
-
     doc_fetched = QtCore.Signal()
     refreshed = QtCore.Signal(bool)
 
@@ -1055,12 +1054,12 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
         'files.sites': 1
     }
 
-    def __init__(self, dbcon, header, version_ids):
+    def __init__(self, dbcon, header):
         super(RepresentationModel, self).__init__()
         self.dbcon = dbcon
         self._data = []
         self._header = header
-        self.version_ids = version_ids
+        self._version_ids = []
 
         manager = ModulesManager()
         sync_server = active_site = remote_site = None
@@ -1092,7 +1091,7 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
         self.remote_site = remote_site
         self.remote_provider = remote_provider
 
-        self.doc_fetched.connect(self.on_doc_fetched)
+        self.doc_fetched.connect(self._on_doc_fetched)
 
         self._docs = {}
         self._icons = lib.get_repre_icons()
@@ -1103,7 +1102,7 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
         self._items_by_id = {}
 
     def set_version_ids(self, version_ids):
-        self.version_ids = version_ids
+        self._version_ids = version_ids
         self.refresh()
 
     def data(self, index, role):
@@ -1171,7 +1170,7 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
 
         return super(RepresentationModel, self).data(index, role)
 
-    def on_doc_fetched(self):
+    def _on_doc_fetched(self):
         self.clear()
         self.beginResetModel()
         subsets = set()
@@ -1181,7 +1180,7 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
         group = None
         self._items_by_id = {}
         for doc in self._docs:
-            if len(self.version_ids) > 1:
+            if len(self._version_ids) > 1:
                 group = repre_groups.get(doc["name"])
                 if not group:
                     group_item = Item()
@@ -1265,12 +1264,12 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
             return
 
         repre_docs = []
-        if self.version_ids:
+        if self._version_ids:
             # Simple find here for now, expected to receive lower number of
             # representations and logic could be in Python
             repre_docs = list(get_representations(
                 project_name,
-                version_ids=self.version_ids,
+                version_ids=self._version_ids,
                 check_site_name=True,
                 fields=self.repre_projection.keys()
             ))
diff --git a/openpype/tools/loader/widgets.py b/openpype/tools/loader/widgets.py
index 921708922e..fd43435b15 100644
--- a/openpype/tools/loader/widgets.py
+++ b/openpype/tools/loader/widgets.py
@@ -1164,7 +1164,7 @@ class RepresentationWidget(QtWidgets.QWidget):
 
         headers = [item[0] for item in self.default_widths]
 
-        model = RepresentationModel(self.dbcon, headers, [])
+        model = RepresentationModel(self.dbcon, headers)
 
         proxy_model = RepresentationSortProxyModel(self)
         proxy_model.setSourceModel(model)
@@ -1231,7 +1231,7 @@ class RepresentationWidget(QtWidgets.QWidget):
         for item in items:
             repre_ids.append(item["_id"])
 
-        project_name = self.dbcon.actual_project()
+        project_name = self.dbcon.active_project()
         repre_docs = get_representations(
             project_name,
             representation_ids=repre_ids,

From de2fb5d1ff808d81a56a84c8240cac2465feae42 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 11:38:18 +0200
Subject: [PATCH 0539/1227] convert cursor of representations to list

---
 openpype/tools/loader/widgets.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/tools/loader/widgets.py b/openpype/tools/loader/widgets.py
index fd43435b15..0482bad642 100644
--- a/openpype/tools/loader/widgets.py
+++ b/openpype/tools/loader/widgets.py
@@ -1232,11 +1232,11 @@ class RepresentationWidget(QtWidgets.QWidget):
             repre_ids.append(item["_id"])
 
         project_name = self.dbcon.active_project()
-        repre_docs = get_representations(
+        repre_docs = list(get_representations(
             project_name,
             representation_ids=repre_ids,
             fields=["name", "parent"]
-        )
+        ))
 
         version_ids = [
             repre_doc["parent"]

From 2df00d5caefd92aad61112b110d8b7a9303f5230 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 11:38:43 +0200
Subject: [PATCH 0540/1227] remove site name check in representations widget

---
 openpype/client/entities.py    | 6 ------
 openpype/tools/loader/model.py | 1 -
 2 files changed, 7 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 66204a4b19..91646e7a1d 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -789,7 +789,6 @@ def get_representations(
     version_ids=None,
     extensions=None,
     names_by_version_ids=None,
-    check_site_name=False,
     archived=False,
     fields=None
 ):
@@ -809,8 +808,6 @@ def get_representations(
             file (without dot).
         names_by_version_ids (dict[ObjectId, list[str]]): Complex filtering
             using version ids and list of names under the version.
-        check_site_name (bool): Filter only representation that have existing
-            site name.
         archived (bool): Output will also contain archived representations.
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
@@ -827,9 +824,6 @@ def get_representations(
     else:
         query_filter = {"type": {"$in": repre_types}}
 
-    if check_site_name:
-        query_filter["files.site.name"] = {"$exists": True}
-
     if representation_ids is not None:
         representation_ids = _convert_ids(representation_ids)
         if not representation_ids:
diff --git a/openpype/tools/loader/model.py b/openpype/tools/loader/model.py
index f030e94256..46acc68f67 100644
--- a/openpype/tools/loader/model.py
+++ b/openpype/tools/loader/model.py
@@ -1270,7 +1270,6 @@ class RepresentationModel(TreeModel, BaseRepresentationModel):
             repre_docs = list(get_representations(
                 project_name,
                 version_ids=self._version_ids,
-                check_site_name=True,
                 fields=self.repre_projection.keys()
             ))
 

From 483ca9b301680cdfee8eee7f4270eb5a1654f312 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 11:49:03 +0200
Subject: [PATCH 0541/1227] fix args order

---
 openpype/tools/loader/model.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/tools/loader/model.py b/openpype/tools/loader/model.py
index 46acc68f67..b5dc16a680 100644
--- a/openpype/tools/loader/model.py
+++ b/openpype/tools/loader/model.py
@@ -267,7 +267,7 @@ class SubsetsModel(TreeModel, BaseRepresentationModel):
             else:
                 project_name = self.dbcon.active_project()
                 version_doc = get_version_by_name(
-                    project_name, subset_id, value
+                    project_name, value, subset_id
                 )
 
                 # update availability on active site when version changes

From a63e5592ab02c61c3712d6cc0a10716ffb2efb33 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 11:52:59 +0200
Subject: [PATCH 0542/1227] fixed asset links widget

---
 openpype/tools/assetlinks/widgets.py | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/openpype/tools/assetlinks/widgets.py b/openpype/tools/assetlinks/widgets.py
index 3078585ed1..1b168e542c 100644
--- a/openpype/tools/assetlinks/widgets.py
+++ b/openpype/tools/assetlinks/widgets.py
@@ -74,13 +74,13 @@ class SimpleLinkView(QtWidgets.QWidget):
             fields=["name", "parent"]
         ))
 
-        subset_docs = []
         versions_by_subset_id = collections.defaultdict(list)
-        if versions_by_subset_id:
-            for version_doc in version_docs:
-                subset_id = version_doc["parent"]
-                versions_by_subset_id[subset_id].append(version_doc)
+        for version_doc in version_docs:
+            subset_id = version_doc["parent"]
+            versions_by_subset_id[subset_id].append(version_doc)
 
+        subset_docs = []
+        if versions_by_subset_id:
             subset_docs = list(get_subsets(
                 self.project_name,
                 subset_ids=versions_by_subset_id.keys(),
@@ -117,13 +117,13 @@ class SimpleLinkView(QtWidgets.QWidget):
             version_doc["_id"],
             fields=["name", "parent"]
         ))
-        subset_docs = []
         versions_by_subset_id = collections.defaultdict(list)
-        if versions_by_subset_id:
-            for version_doc in version_docs:
-                subset_id = version_doc["parent"]
-                versions_by_subset_id[subset_id].append(version_doc)
+        for version_doc in version_docs:
+            subset_id = version_doc["parent"]
+            versions_by_subset_id[subset_id].append(version_doc)
 
+        subset_docs = []
+        if versions_by_subset_id:
             subset_docs = list(get_subsets(
                 self.project_name,
                 subset_ids=versions_by_subset_id.keys(),

From 5d36e381906d25ae8593c72ee0d409090e842ecf Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 15:21:12 +0200
Subject: [PATCH 0543/1227] extractor does not change output frame range

---
 .../plugins/publish/extract_sequence.py       | 34 ++-----------------
 1 file changed, 2 insertions(+), 32 deletions(-)

diff --git a/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py b/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
index d4fd1dff4b..77712347bd 100644
--- a/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
+++ b/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
@@ -73,14 +73,8 @@ class ExtractSequence(pyblish.api.Extractor):
 
         scene_bg_color = instance.context.data["sceneBgColor"]
 
-        # --- Fallbacks ----------------------------------------------------
-        # This is required if validations of ranges are ignored.
-        # - all of this code won't change processing if range to render
-        #   match to range of expected output
-
         # Prepare output frames
         output_frame_start = frame_start - handle_start
-        output_frame_end = frame_end + handle_end
 
         # Change output frame start to 0 if handles cause it's negative number
         if output_frame_start < 0:
@@ -90,32 +84,8 @@ class ExtractSequence(pyblish.api.Extractor):
             ).format(frame_start, handle_start))
             output_frame_start = 0
 
-        # Check Marks range and output range
-        output_range = output_frame_end - output_frame_start
-        marks_range = mark_out - mark_in
-
-        # Lower Mark Out if mark range is bigger than output
-        # - do not rendered not used frames
-        if output_range < marks_range:
-            new_mark_out = mark_out - (marks_range - output_range)
-            self.log.warning((
-                "Lowering render range to {} frames. Changed Mark Out {} -> {}"
-            ).format(marks_range + 1, mark_out, new_mark_out))
-            # Assign new mark out to variable
-            mark_out = new_mark_out
-
-        # Lower output frame end so representation has right `frameEnd` value
-        elif output_range > marks_range:
-            new_output_frame_end = (
-                output_frame_end - (output_range - marks_range)
-            )
-            self.log.warning((
-                "Lowering representation range to {} frames."
-                " Changed frame end {} -> {}"
-            ).format(output_range + 1, mark_out, new_output_frame_end))
-            output_frame_end = new_output_frame_end
-
-        # -------------------------------------------------------------------
+        # Calculate frame end
+        output_frame_end = output_frame_start + (mark_out - mark_in)
 
         # Save to staging dir
         output_dir = instance.data.get("stagingDir")

From d09697db6b2a8d1cf9b9ff35d4e743f43528ae27 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 15:21:20 +0200
Subject: [PATCH 0544/1227] make sure members are strings

---
 openpype/hosts/tvpaint/api/pipeline.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/tvpaint/api/pipeline.py b/openpype/hosts/tvpaint/api/pipeline.py
index f473f51457..60c61a8cbf 100644
--- a/openpype/hosts/tvpaint/api/pipeline.py
+++ b/openpype/hosts/tvpaint/api/pipeline.py
@@ -385,7 +385,7 @@ def ls():
             if "objectName" not in item and "members" in item:
                 members = item["members"]
                 if isinstance(members, list):
-                    members = "|".join(members)
+                    members = "|".join([str(member) for member in members])
                 item["objectName"] = members
     return output
 

From 34156e280bf7ebbd565e9754ae9f71fdf463d79f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 18:17:38 +0200
Subject: [PATCH 0545/1227] create new action to create daily review sessions

---
 .../action_create_review_session.py           | 286 ++++++++++++++++++
 1 file changed, 286 insertions(+)
 create mode 100644 openpype/modules/ftrack/event_handlers_server/action_create_review_session.py

diff --git a/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py b/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
new file mode 100644
index 0000000000..3b7cb224f0
--- /dev/null
+++ b/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
@@ -0,0 +1,286 @@
+import threading
+import datetime
+import copy
+import collections
+
+import ftrack_api
+
+from openpype.lib import get_datetime_data
+from openpype.api import get_project_settings
+from openpype_modules.ftrack.lib import ServerAction
+
+
+class CreateDailyReviewSessionServerAction(ServerAction):
+    """Create daily review session object per project.
+
+    Action creates review sessions based on settings. Settings define if is
+    action enabled and what is a template for review session name. Logic works
+    in a way that if review session with the name already exists then skip
+    process. If review session for current day does not exist but yesterdays
+    review exists and is empty then yesterdays is renamed otherwise creates
+    new review session.
+
+    Also contains cycle creation of dailies which is triggered each morning.
+    This option must be enabled in project settings. Cycle creation is also
+    checked on registration of action.
+    """
+
+    identifier = "create.daily.review.session"
+    #: Action label.
+    label = "OpenPype Admin"
+    variant = "- Create Daily Review Session (Server)"
+    #: Action description.
+    description = "Manually create daily review session"
+    role_list = {"Pypeclub", "Administrator", "Project Manager"}
+
+    settings_key = "create_daily_review_session"
+    default_template = "{yy}{mm}{dd}"
+
+    def __init__(self, *args, **kwargs):
+        super(CreateDailyReviewSessionServerAction, self).__init__(*args, **kwargs)
+
+        self._cycle_timer = None
+        self._last_cyle_time = None
+        self._day_delta = datetime.timedelta(days=1)
+
+    def discover(self, session, entities, event):
+        """Show action only on AssetVersions."""
+
+        valid_selection = False
+        for ent in event["data"]["selection"]:
+            # Ignore entities that are not tasks or projects
+            if ent["entityType"].lower() in (
+                "show", "task", "reviewsession", "assetversion"
+            ):
+                valid_selection = True
+                break
+            else:
+                self.log.info(ent["entityType"])
+
+        if not valid_selection:
+            return False
+        return self.valid_roles(session, entities, event)
+
+    def launch(self, session, entities, event):
+        project_entity = self.get_project_from_entity(entities[0], session)
+        project_name = project_entity["full_name"]
+        project_settings = self.get_project_settings_from_event(
+            event, project_name
+        )
+        action_settings = self._extract_action_settings(project_settings)
+        project_name_by_id = {
+            project_entity["id"]: project_name
+        }
+        settings_by_project_id = {
+            project_entity["id"]: action_settings
+        }
+        self._process_review_session(
+            session, settings_by_project_id, project_name_by_id
+        )
+        return True
+
+    def register(self, *args, **kwargs):
+        """Override register to be able trigger """
+        # Register server action as would be normally
+        super(CreateDailyReviewSessionServerAction, self).register(*args, **kwargs)
+
+        # Create threading timer which will trigger creation of report
+        #   at the 00:00:01 of next day
+        # - callback will trigger another timer which will have 1 day offset
+        now = datetime.datetime.now()
+        # Create object of today morning
+        today_morning = datetime.datetime(
+            now.year, now.month, now.day, 0, 0, 1
+        )
+        # Add a day delta (to calculate next day date)
+        next_day_morning = today_morning + self._day_delta
+        # Calculate first delta in seconds for first threading timer
+        first_delta = (next_day_morning - now).total_seconds()
+        # Store cycle time which will be used to create next timer
+        self._last_cyle_time = next_day_morning
+        # Create timer thread
+        self._cycle_timer = threading.Timer(first_delta, self._timer_callback)
+        self._cycle_timer.start()
+
+        self._check_review_session()
+
+    def _timer_callback(self):
+        if (
+            self._cycle_timer is not None
+            and self._last_cyle_time is not None
+        ):
+            now = datetime.datetime.now()
+            while self._last_cyle_time < now:
+                self._last_cyle_time = self._last_cyle_time + self._day_delta
+
+            delay = (self._last_cyle_time - now).total_seconds()
+
+            self._cycle_timer = threading.Timer(delay, self._timer_callback)
+            self._cycle_timer.start()
+        self._check_review_session()
+
+    def _check_review_session(self):
+        session = ftrack_api.Session(
+            server_url=self.session.server_url,
+            api_key=self.session.api_key,
+            api_user=self.session.api_user,
+            auto_connect_event_hub=False
+        )
+        project_entities = session.query(
+            "select id, full_name from Project"
+        ).all()
+        project_names_by_id = {
+            project_entity["id"]: project_entity["full_name"]
+            for project_entity in project_entities
+        }
+
+        action_settings_by_project_id = self._get_action_settings(
+            project_names_by_id
+        )
+        enabled_action_settings_by_project_id = {}
+        for item in action_settings_by_project_id.items():
+            project_id, action_settings = item
+            if action_settings.get("cycle_enabled"):
+                enabled_action_settings_by_project_id[project_id] = (
+                    action_settings
+                )
+
+        if not enabled_action_settings_by_project_id:
+            self.log.info((
+                "There are no projects that have enabled"
+                " cycle review sesison creation"
+            ))
+
+        else:
+            self._process_review_session(
+                session,
+                enabled_action_settings_by_project_id,
+                project_names_by_id
+            )
+
+        session.close()
+
+    def _process_review_session(
+        self, session, settings_by_project_id, project_names_by_id
+    ):
+        review_sessions = session.query((
+            "select id, name, project_id"
+            " from ReviewSession where project_id in ({})"
+        ).format(self.join_query_keys(settings_by_project_id))).all()
+
+        review_sessions_by_project_id = collections.defaultdict(list)
+        for review_session in review_sessions:
+            project_id = review_session["project_id"]
+            review_sessions_by_project_id[project_id].append(review_session)
+
+        # Prepare fill data for today's review sesison and yesterdays
+        now = datetime.datetime.now()
+        today_obj = datetime.datetime(
+            now.year, now.month, now.day, 0, 0, 0
+        )
+        yesterday_obj = today_obj - self._day_delta
+
+        today_fill_data = get_datetime_data(today_obj)
+        yesterday_fill_data = get_datetime_data(yesterday_obj)
+
+        # Loop through projects and try to create daily reviews
+        for project_id, action_settings in settings_by_project_id.items():
+            review_session_template = (
+                action_settings["review_session_template"]
+            ).strip() or self.default_template
+
+            today_project_fill_data = copy.deepcopy(today_fill_data)
+            yesterday_project_fill_data = copy.deepcopy(yesterday_fill_data)
+            project_name = project_names_by_id[project_id]
+            today_project_fill_data["project_name"] = project_name
+            yesterday_project_fill_data["project_name"] = project_name
+
+            today_session_name = self._fill_review_template(
+                review_session_template, today_project_fill_data
+            )
+            yesterday_session_name = self._fill_review_template(
+                review_session_template, yesterday_project_fill_data
+            )
+            # Skip if today's session name could not be filled
+            if not today_session_name:
+                continue
+
+            # Find matchin review session
+            project_review_sessions = review_sessions_by_project_id[project_id]
+            todays_session = None
+            yesterdays_session = None
+            for review_session in project_review_sessions:
+                session_name = review_session["name"]
+                if session_name == today_session_name:
+                    todays_session = review_session
+                    break
+                elif session_name == yesterday_session_name:
+                    yesterdays_session = review_session
+
+            # Skip if today's session already exist
+            if todays_session is not None:
+                self.log.debug((
+                    "Todays ReviewSession \"{}\""
+                    " in project \"{}\" already exists"
+                ).format(today_session_name, project_name))
+                continue
+
+            # Check if there is yesterday's session and is empty
+            # - in that case just rename it
+            if (
+                yesterdays_session is not None
+                and len(yesterdays_session["review_session_objects"]) == 0
+            ):
+                self.log.debug((
+                    "Renaming yesterdays empty review session \"{}\" to \"{}\""
+                    " in project \"{}\""
+                ).format(
+                    yesterday_session_name, today_session_name, project_name
+                ))
+                yesterdays_session["name"] = today_session_name
+                session.commit()
+                continue
+
+            # Create new review session with new name
+            self.log.debug((
+                "Creating new review session \"{}\" in project \"{}\""
+            ).format(today_session_name, project_name))
+            session.create("ReviewSession", {
+                "project_id": project_id,
+                "name": today_session_name
+            })
+            session.commit()
+
+    def _get_action_settings(self, project_names_by_id):
+        settings_by_project_id = {}
+        for project_id, project_name in project_names_by_id.items():
+            project_settings = get_project_settings(project_name)
+            action_settings = self._extract_action_settings(project_settings)
+            settings_by_project_id[project_id] = action_settings
+        return settings_by_project_id
+
+    def _extract_action_settings(self, project_settings):
+        return (
+            project_settings
+            .get("ftrack", {})
+            .get(self.settings_frack_subkey, {})
+            .get(self.settings_key)
+        ) or {}
+
+    def _fill_review_template(self, template, data):
+        output = None
+        try:
+            output = template.format(**data)
+        except Exception:
+            self.log.warning(
+                (
+                    "Failed to fill review session template {} with data {}"
+                ).format(template, data),
+                exc_info=True
+            )
+        return output
+
+
+def register(session):
+    '''Register plugin. Called when used as an plugin.'''
+    CreateDailyReviewSessionServerAction(session).register()

From 08d1f97f1112e7efc0190f146139c366d8f84de8 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 18:17:54 +0200
Subject: [PATCH 0546/1227] added settings for new action

---
 .../defaults/project_settings/ftrack.json     |  9 +++++
 .../schema_project_ftrack.json                | 38 +++++++++++++++++++
 2 files changed, 47 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/ftrack.json b/openpype/settings/defaults/project_settings/ftrack.json
index 9d59deea3d..831c34835e 100644
--- a/openpype/settings/defaults/project_settings/ftrack.json
+++ b/openpype/settings/defaults/project_settings/ftrack.json
@@ -116,6 +116,15 @@
                 "Administrator",
                 "Project manager"
             ]
+        },
+        "create_daily_review_session": {
+            "enabled": true,
+            "role_list": [
+                "Administrator",
+                "Project Manager"
+            ],
+            "cycle_enabled": false,
+            "review_session_template": "{yy}{mm}{dd}"
         }
     },
     "user_handlers": {
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json b/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
index 16cab49d5d..f8f9d5093d 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
@@ -388,6 +388,44 @@
                             "object_type": "text"
                         }
                     ]
+                },
+                {
+                    "key": "create_daily_review_session",
+                    "label": "Create daily review session",
+                    "type": "dict",
+                    "is_group": true,
+                    "checkbox_key": "enabled",
+                    "children": [
+                        {
+                            "type": "boolean",
+                            "key": "enabled"
+                        },
+                        {
+                            "type": "list",
+                            "key": "role_list",
+                            "label": "Roles",
+                            "object_type": "text",
+                            "use_label_wrap": true
+                        },
+                        {
+                            "type": "boolean",
+                            "key": "cycle_enabled",
+                            "label": "Create daily review session"
+                        },
+                        {
+                            "type": "separator"
+                        },
+                        {
+                            "type": "text",
+                            "key": "review_session_template",
+                            "label": "ReviewSession template",
+                            "placeholder": "Default: {yy}{mm}{dd}"
+                        },
+                        {
+                            "type": "label",
+                            "label": "Possible formatting keys in template:<br/>- \"project_name\" - &lt;Name of project&gt;<br/>- \"d\" - &lt;Day of month number&gt; in shortest possible way.<br/>- \"dd\" - &lt;Day of month number&gt; with 2 digits.<br/>- \"ddd\" - &lt;Week day name&gt; shortened week day. e.g.: `Mon`, ...<br/>- \"dddd\" - &lt;Week day name&gt; full name of week day. e.g.: `Monday`, ...<br/>- \"m\" - &lt;Month number&gt; in shortest possible way. e.g.: `1` if January<br/>- \"mm\" - &lt;Month number&gt; with 2 digits.<br/>- \"mmm\" - &lt;Month name&gt; shortened month name. e.g.: `Jan`, ...<br/>- \"mmmm\" -&lt;Month name&gt; full month name. e.g.: `January`, ...<br/>- \"yy\" - &lt;Year number&gt; shortened year. e.g.: `19`, `20`, ...<br/>- \"yyyy\" - &lt;Year number&gt; full year. e.g.: `2019`, `2020`, ..."
+                        }
+                    ]
                 }
             ]
         },

From 5999693fdf748025aa79cf9cf232d77406c4c9a6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 9 Jun 2022 18:27:00 +0200
Subject: [PATCH 0547/1227] fix too long lines

---
 .../event_handlers_server/action_create_review_session.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py b/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
index 3b7cb224f0..8a1d898193 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
@@ -37,7 +37,9 @@ class CreateDailyReviewSessionServerAction(ServerAction):
     default_template = "{yy}{mm}{dd}"
 
     def __init__(self, *args, **kwargs):
-        super(CreateDailyReviewSessionServerAction, self).__init__(*args, **kwargs)
+        super(CreateDailyReviewSessionServerAction, self).__init__(
+            *args, **kwargs
+        )
 
         self._cycle_timer = None
         self._last_cyle_time = None
@@ -82,7 +84,9 @@ class CreateDailyReviewSessionServerAction(ServerAction):
     def register(self, *args, **kwargs):
         """Override register to be able trigger """
         # Register server action as would be normally
-        super(CreateDailyReviewSessionServerAction, self).register(*args, **kwargs)
+        super(CreateDailyReviewSessionServerAction, self).register(
+            *args, **kwargs
+        )
 
         # Create threading timer which will trigger creation of report
         #   at the 00:00:01 of next day

From 0616db322d92be36cebd96c8d6e020fd7e9590c7 Mon Sep 17 00:00:00 2001
From: Felix Wang <icyvapor@gmail.com>
Date: Thu, 9 Jun 2022 10:42:20 -0700
Subject: [PATCH 0548/1227] Update
 openpype/hosts/maya/plugins/publish/collect_instances.py

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/hosts/maya/plugins/publish/collect_instances.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_instances.py b/openpype/hosts/maya/plugins/publish/collect_instances.py
index c76afe53f6..433fa9886d 100644
--- a/openpype/hosts/maya/plugins/publish/collect_instances.py
+++ b/openpype/hosts/maya/plugins/publish/collect_instances.py
@@ -10,7 +10,6 @@ def get_all_children(nodes):
     Using maya.cmds.listRelatives(allDescendents=True) includes only the first
     instance. As such, this function acts as an optimal replacement with a
     focus on a fast query.
-    Borrowed from Colorbleed: https://tinyurl.com/bdht6fyh
 
     """
 

From 79b181176ba470c77e690f11c980558e956da97c Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Thu, 9 Jun 2022 22:34:28 +0200
Subject: [PATCH 0549/1227] updated poetry installation source

---
 tools/create_env.ps1 | 2 +-
 tools/create_env.sh  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tools/create_env.ps1 b/tools/create_env.ps1
index f19a98f11b..c307ba2031 100644
--- a/tools/create_env.ps1
+++ b/tools/create_env.ps1
@@ -63,7 +63,7 @@ function Install-Poetry() {
     }
 
     $env:POETRY_HOME="$openpype_root\.poetry"
-    (Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py -UseBasicParsing).Content | & $($python) -
+    (Invoke-WebRequest -Uri https://install.python-poetry.org/ -UseBasicParsing).Content | & $($python) -
 }
 
 
diff --git a/tools/create_env.sh b/tools/create_env.sh
index 94b11d6776..fba3942b87 100755
--- a/tools/create_env.sh
+++ b/tools/create_env.sh
@@ -110,7 +110,7 @@ install_poetry () {
   echo -e "${BIGreen}>>>${RST} Installing Poetry ..."
   export POETRY_HOME="$openpype_root/.poetry"
   command -v curl >/dev/null 2>&1 || { echo -e "${BIRed}!!!${RST}${BIYellow} Missing ${RST}${BIBlue}curl${BIYellow} command.${RST}"; return 1; }
-  curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py | python -
+  curl -sSL https://install.python-poetry.org/ | python -
 }
 
 ##############################################################################

From 242b9f5f3a9ed734743d7b88cba7191be4841fa3 Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Fri, 10 Jun 2022 00:49:01 +0200
Subject: [PATCH 0550/1227] added module setting and tray item

---
 openpype/modules/ftrack/tray/ftrack_tray.py   | 44 ++++++++++++++-----
 .../defaults/system_settings/modules.json     | 14 ++++++
 .../module_settings/schema_ftrack.json        | 37 ++++++++++++++++
 tools/run_ftrack_eventserver.ps1              | 39 ++++++++++++++++
 4 files changed, 124 insertions(+), 10 deletions(-)
 create mode 100644 tools/run_ftrack_eventserver.ps1

diff --git a/openpype/modules/ftrack/tray/ftrack_tray.py b/openpype/modules/ftrack/tray/ftrack_tray.py
index c6201a94f6..699b33e187 100644
--- a/openpype/modules/ftrack/tray/ftrack_tray.py
+++ b/openpype/modules/ftrack/tray/ftrack_tray.py
@@ -2,6 +2,8 @@ import os
 import time
 import datetime
 import threading
+import platform
+from subprocess import Popen
 from Qt import QtCore, QtWidgets, QtGui
 
 import ftrack_api
@@ -12,6 +14,7 @@ from ..ftrack_module import FTRACK_MODULE_DIR
 from . import login_dialog
 
 from openpype.api import Logger, resources
+from openpype.settings import get_system_settings
 
 
 log = Logger().get_logger("FtrackModule")
@@ -42,12 +45,25 @@ class FtrackTrayWrapper:
         self.icon_not_logged = QtGui.QIcon(
             resources.get_resource("icons", "circle_orange.png")
         )
+        self.icon_ftrackapp = QtGui.QIcon(
+            resources.get_resource("icons", "inventory.png")
+        )
 
     def show_login_widget(self):
         self.widget_login.show()
         self.widget_login.activateWindow()
         self.widget_login.raise_()
 
+    def show_ftrack_browser(self):
+        am = get_system_settings()
+        browser_path = am["modules"]["ftrack"]["ftrack_browser_path"][platform.system().lower()][0]
+        browser_arg = am["modules"]["ftrack"]["ftrack_browser_arguments"][platform.system().lower()][0]
+        if "=" not in browser_arg:
+            browser_arg = '{:1}'.format(browser_arg)
+        cmd = f"{browser_path} {browser_arg}{self.module.ftrack_url}"
+        log.info(f"Opening Ftrack Browser: {cmd}")
+        Popen(cmd)
+
     def validate(self):
         validation = False
         cred = credentials.get_credentials()
@@ -251,16 +267,12 @@ class FtrackTrayWrapper:
         # Menu for Tray App
         tray_menu = QtWidgets.QMenu("Ftrack", parent_menu)
 
-        # Actions - basic
-        action_credentials = QtWidgets.QAction("Credentials", tray_menu)
-        action_credentials.triggered.connect(self.show_login_widget)
-        if self.bool_logged:
-            icon = self.icon_logged
-        else:
-            icon = self.icon_not_logged
-        action_credentials.setIcon(icon)
-        tray_menu.addAction(action_credentials)
-        self.action_credentials = action_credentials
+        # Ftrack Browser
+        browser_open = QtWidgets.QAction("Open Ftrack...", tray_menu)
+        browser_open.triggered.connect(self.show_ftrack_browser)
+        browser_open.setIcon(self.icon_ftrackapp)
+        tray_menu.addAction(browser_open)
+        self.browser_open = browser_open
 
         # Actions - server
         tray_server_menu = tray_menu.addMenu("Action server")
@@ -284,6 +296,18 @@ class FtrackTrayWrapper:
         tray_server_menu.addAction(self.action_server_stop)
 
         self.tray_server_menu = tray_server_menu
+
+        # Actions - basic
+        action_credentials = QtWidgets.QAction("Credentials", tray_menu)
+        action_credentials.triggered.connect(self.show_login_widget)
+        if self.bool_logged:
+            icon = self.icon_logged
+        else:
+            icon = self.icon_not_logged
+        action_credentials.setIcon(icon)
+        tray_menu.addAction(action_credentials)
+        self.action_credentials = action_credentials
+
         self.bool_logged = False
         self.set_menu_visibility()
 
diff --git a/openpype/settings/defaults/system_settings/modules.json b/openpype/settings/defaults/system_settings/modules.json
index 537e287366..aaf01b1631 100644
--- a/openpype/settings/defaults/system_settings/modules.json
+++ b/openpype/settings/defaults/system_settings/modules.json
@@ -15,6 +15,20 @@
     "ftrack": {
         "enabled": false,
         "ftrack_server": "",
+        "ftrack_browser_path": {
+            "windows": [
+                "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
+            ],
+            "darwin": [],
+            "linux": []
+        },
+        "ftrack_browser_arguments": {
+            "windows": [
+                "--app="
+            ],
+            "darwin": [],
+            "linux": []
+        },
         "ftrack_actions_path": {
             "windows": [],
             "darwin": [],
diff --git a/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json b/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
index 654ddf2938..f30d536052 100644
--- a/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
+++ b/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
@@ -19,6 +19,43 @@
         {
             "type": "splitter"
         },
+        {
+            "type": "path",
+            "key": "ftrack_browser_path",
+            "label": "Browser Path",
+            "use_label_wrap": true,
+            "multipath": true,
+            "multiplatform": true
+        },
+        {
+            "type": "dict",
+            "key": "ftrack_browser_arguments",
+            "label": "Browser Arguments",
+            "use_label_wrap": true,
+            "children": [
+                {
+                    "key": "windows",
+                    "label": "Windows",
+                    "type": "list",
+                    "object_type": "text"
+                },
+                {
+                    "key": "darwin",
+                    "label": "MacOS",
+                    "type": "list",
+                    "object_type": "text"
+                },
+                {
+                    "key": "linux",
+                    "label": "Linux",
+                    "type": "list",
+                    "object_type": "text"
+                }
+            ]
+        },
+        {
+            "type": "splitter"
+        },
         {
             "type": "label",
             "label": "Additional Ftrack event handlers paths"
diff --git a/tools/run_ftrack_eventserver.ps1 b/tools/run_ftrack_eventserver.ps1
new file mode 100644
index 0000000000..9c22f3d88e
--- /dev/null
+++ b/tools/run_ftrack_eventserver.ps1
@@ -0,0 +1,39 @@
+<#
+.SYNOPSIS
+  Helper script to start OpenPype Ftrack EventServer without relying on built executables.
+
+.DESCRIPTION
+
+
+.EXAMPLE
+
+PS> .\run_eventserver.ps1
+
+#>
+$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+$openpype_root = (Get-Item $script_dir).parent.FullName
+
+$env:_INSIDE_OPENPYPE_TOOL = "1"
+$env:OPENPYPE_DEBUG = "1"
+# $env:OPENPYPE_MONGO = "mongodb://127.0.0.1:27017"
+
+# make sure Poetry is in PATH
+if (-not (Test-Path 'env:POETRY_HOME')) {
+    $env:POETRY_HOME = "$openpype_root\.poetry"
+}
+$env:PATH = "$($env:PATH);$($env:POETRY_HOME)\bin"
+
+Set-Location -Path $openpype_root
+
+Write-Host ">>> " -NoNewline -ForegroundColor Green
+Write-Host "Reading Poetry ... " -NoNewline
+if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
+    Write-Host "NOT FOUND" -ForegroundColor Yellow
+    Write-Host "*** " -NoNewline -ForegroundColor Yellow
+    Write-Host "We need to install Poetry create virtual env first ..."
+    & "$openpype_root\tools\create_env.ps1"
+} else {
+    Write-Host "OK" -ForegroundColor Green
+}
+
+& "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\start.py" eventserver
\ No newline at end of file

From 3a7e329e85793962b7b15a70df33e5930147f94e Mon Sep 17 00:00:00 2001
From: "Allan I. A" <76656700+Allan-I@users.noreply.github.com>
Date: Fri, 10 Jun 2022 12:02:30 +0300
Subject: [PATCH 0551/1227] Update openpype/plugins/publish/extract_jpeg_exr.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/plugins/publish/extract_jpeg_exr.py | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index c658e17cab..b336787599 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -161,6 +161,14 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         # output file
         jpeg_items.append(path_to_subprocess_arg(dst_path))
         subprocess_command = " ".join(jpeg_items)
-        run_subprocess(
-            subprocess_command, shell=True, logger=self.log
-        )
+        try:
+            run_subprocess(
+                subprocess_command, shell=True, logger=self.log
+            )
+            return True
+        except Exception:
+            self.log.warning(
+                "Failed to create thubmnail using ffmpeg",
+                exc_info=True
+            )
+            return False

From 28d0ea37a7523c2a4560d21ec07fda68d04bc89f Mon Sep 17 00:00:00 2001
From: "Allan I. A" <76656700+Allan-I@users.noreply.github.com>
Date: Fri, 10 Jun 2022 12:02:42 +0300
Subject: [PATCH 0552/1227] Update openpype/plugins/publish/extract_jpeg_exr.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/plugins/publish/extract_jpeg_exr.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index b336787599..c1f7f38024 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -132,7 +132,15 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                     ]
         subprocess_exr = " ".join(oiio_cmd)
         self.log.info(f"running: {subprocess_exr}")
-        run_subprocess(oiio_cmd, logger=self.log)
+        try:
+            run_subprocess(oiio_cmd, logger=self.log)
+            return True
+        except Exception:
+            self.log.warning(
+                "Failed to create thubmnail using oiiotool",
+                exc_info=True
+            )
+            return False
 
     def create_thumbnail_ffmpeg(self, src_path, dst_path):
         self.log.info("outputting {}".format(dst_path))

From 51fb0385f81aefe0ebc71a4f8256b19976e8fce0 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 10 Jun 2022 12:16:31 +0200
Subject: [PATCH 0553/1227] mapped hosts queries

---
 openpype/client/entities.py | 294 +++++++++++++++++++++++++++++++++++-
 1 file changed, 293 insertions(+), 1 deletion(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 91646e7a1d..861ac300e5 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -1033,10 +1033,302 @@ def get_thumbnail(project_name, thumbnail_id, fields=None):
 
 
 """
-Custom data storage:
+## Custom data storage:
 - Webpublisher - jobs
 - Ftrack - events
+- Maya - Shaders
+    - openpype/hosts/maya/api/shader_definition_editor.py
+    - openpype/hosts/maya/plugins/publish/validate_model_name.py
 
+## Global launch hooks
+- openpype/hooks/pre_global_host_data.py
+    Query:
+    - project
+    - asset
+
+## Hosts
+### Aftereffects
+- openpype/hosts/aftereffects/plugins/create/workfile_creator.py
+    Query:
+    - asset
+
+### Blender
+- openpype/hosts/blender/api/pipeline.py
+    Query:
+    - asset
+- openpype/hosts/blender/plugins/publish/extract_layout.py
+    Query:
+    - representation
+
+### Celaction
+- openpype/hosts/celaction/plugins/publish/collect_audio.py
+    Query:
+    - subsets
+    - last versions
+    - representations
+
+### Fusion
+- openpype/hosts/fusion/api/lib.py
+    Query:
+    - asset
+    - subset
+    - version
+    - representation
+- openpype/hosts/fusion/plugins/load/load_sequence.py
+    Query:
+    - version
+- openpype/hosts/fusion/scripts/fusion_switch_shot.py
+    Query:
+    - project
+    - asset
+    - versions
+- openpype/hosts/fusion/utility_scripts/switch_ui.py
+    Query:
+    - assets
+
+### Harmony
+- openpype/hosts/harmony/api/pipeline.py
+    Query:
+    - representation
+
+### Hiero
+- openpype/hosts/hiero/api/lib.py
+    Query:
+    - project
+    - version
+    - versions
+    - representation
+- openpype/hosts/hiero/api/tags.py
+    Query:
+    - task types
+    - assets
+- openpype/hosts/hiero/plugins/load/load_clip.py
+    Query:
+    - version
+    - versions
+- openpype/hosts/hiero/plugins/publish_old_workflow/collect_assetbuilds.py
+    Query:
+    - assets
+
+### Houdini
+- openpype/hosts/houdini/api/lib.py
+    Query:
+    - asset
+- openpype/hosts/houdini/api/usd.py
+    Query:
+    - asset
+- openpype/hosts/houdini/plugins/create/create_hda.py
+    Query:
+    - asset
+    - subsets
+- openpype/hosts/houdini/plugins/publish/collect_usd_bootstrap.py
+    Query:
+    - asset
+    - subset
+- openpype/hosts/houdini/plugins/publish/extract_usd_layered.py
+    Query:
+    - asset
+    - subset
+    - version
+    - representation
+- openpype/hosts/houdini/plugins/publish/validate_usd_shade_model_exists.py
+    Query:
+    - asset
+    - subset
+- openpype/hosts/houdini/vendor/husdoutputprocessors/avalon_uri_processor.py
+    Query:
+    - project
+    - asset
+
+### Maya
+- openpype/hosts/maya/api/action.py
+    Query:
+    - asset
+- openpype/hosts/maya/api/commands.py
+    Query:
+    - asset
+    - project
+- openpype/hosts/maya/api/lib.py
+    Query:
+    - project
+    - asset
+    - subset
+    - subsets
+    - version
+    - representation
+- openpype/hosts/maya/api/setdress.py
+    Query:
+    - version
+    - representation
+- openpype/hosts/maya/plugins/inventory/import_modelrender.py
+    Query:
+    - representation
+- openpype/hosts/maya/plugins/load/load_audio.py
+    Query:
+    - asset
+    - subset
+    - version
+- openpype/hosts/maya/plugins/load/load_image_plane.py
+    Query:
+    - asset
+    - subset
+    - version
+- openpype/hosts/maya/plugins/load/load_look.py
+    Query:
+    - representation
+- openpype/hosts/maya/plugins/load/load_vrayproxy.py
+    Query:
+    - representation
+- openpype/hosts/maya/plugins/load/load_yeti_cache.py
+    Query:
+    - representation
+- openpype/hosts/maya/plugins/publish/collect_review.py
+    Query:
+    - subsets
+- openpype/hosts/maya/plugins/publish/validate_node_ids_in_database.py
+    Query:
+    - assets
+- openpype/hosts/maya/plugins/publish/validate_node_ids_related.py
+    Query:
+    - asset
+- openpype/hosts/maya/plugins/publish/validate_renderlayer_aovs.py
+    Query:
+    - asset
+    - subset
+
+### Nuke
+- openpype/hosts/nuke/api/command.py
+    Query:
+    - project
+    - asset
+- openpype/hosts/nuke/api/lib.py
+    Query:
+    - project
+    - asset
+    - version
+    - versions
+    - representation
+- openpype/hosts/nuke/plugins/load/load_backdrop.py
+    Query:
+    - version
+    - versions
+- openpype/hosts/nuke/plugins/load/load_camera_abc.py
+    Query:
+    - version
+    - versions
+- openpype/hosts/nuke/plugins/load/load_clip.py
+    Query:
+    - version
+    - versions
+- openpype/hosts/nuke/plugins/load/load_effects_ip.py
+    Query:
+    - version
+    - versions
+- openpype/hosts/nuke/plugins/load/load_effects.py
+    Query:
+    - version
+    - versions
+- openpype/hosts/nuke/plugins/load/load_gizmo_ip.py
+    Query:
+    - version
+    - versions
+- openpype/hosts/nuke/plugins/load/load_gizmo.py
+    Query:
+    - version
+    - versions
+- openpype/hosts/nuke/plugins/load/load_image.py
+    Query:
+    - version
+    - versions
+- openpype/hosts/nuke/plugins/load/load_model.py
+    Query:
+    - version
+    - versions
+- openpype/hosts/nuke/plugins/load/load_script_precomp.py
+    Query:
+    - version
+    - versions
+- openpype/hosts/nuke/plugins/publish/collect_reads.py
+    Query:
+    - asset
+- openpype/hosts/nuke/plugins/publish/precollect_instances.py
+    Query:
+    - asset
+- openpype/hosts/nuke/plugins/publish/precollect_writes.py
+    Query:
+    - representation
+- openpype/hosts/nuke/plugins/publish/validate_script.py
+    Query:
+    - asset
+    - project
+
+### Photoshop
+- openpype/hosts/photoshop/plugins/create/workfile_creator.py
+    Query:
+    - asset
+
+### Resolve
+- openpype/hosts/resolve/plugins/load/load_clip.py
+    Query:
+    - version
+    - versions
+
+### Standalone publisher
+- openpype/hosts/standalonepublisher/plugins/publish/collect_bulk_mov_instances.py
+    Query:
+    - asset
+- openpype/hosts/standalonepublisher/plugins/publish/collect_matching_asset.py
+    Query:
+    - assets
+- openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py
+    Query:
+    - project
+    - asset
+- openpype/hosts/standalonepublisher/plugins/publish/validate_task_existence.py
+    Query:
+    - assets
+
+### TVPaint
+- openpype/hosts/tvpaint/api/pipeline.py
+    Query:
+    - project
+    - asset
+- openpype/hosts/tvpaint/plugins/load/load_workfile.py
+    Query:
+    - project
+    - asset
+- openpype/hosts/tvpaint/plugins/publish/collect_instances.py
+    Query:
+    - asset
+- openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
+    Query:
+    - asset
+- openpype/hosts/tvpaint/plugins/publish/collect_workfile.py
+    Query:
+    - asset
+
+### Unreal
+- openpype/hosts/unreal/plugins/load/load_camera.py
+    Query:
+    - asset
+    - assets
+- openpype/hosts/unreal/plugins/load/load_layout.py
+    Query:
+    - asset
+    - assets
+- openpype/hosts/unreal/plugins/publish/extract_layout.py
+    Query:
+    - representation
+
+### Webpublisher
+- openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
+    Query:
+    - assets
+- openpype/hosts/webpublisher/plugins/publish/collect_published_files.py
+    Query:
+    - last versions
+
+## Tools
 openpype/tools/assetlinks/widgets.py
 - SimpleLinkView
     Query:

From 79db1b1c4354c95d4732f54f09bf2a2357c59572 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 10 Jun 2022 12:40:57 +0200
Subject: [PATCH 0554/1227] flame: adding staging dir to `cleanupFullPaths`

---
 .../hosts/flame/plugins/publish/extract_subset_resources.py     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index f3239af23e..6ad8f8cf96 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -445,4 +445,6 @@ class ExtractSubsetResources(openpype.api.Extractor):
                 )
             instance.data['stagingDir'] = staging_dir
 
+        instance.context.data["cleanupFullPaths"].append(staging_dir)
+
         return staging_dir

From b19fc26cf68043574f704ecc3eac6703734bf33f Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 10 Jun 2022 14:52:54 +0300
Subject: [PATCH 0555/1227] Handle muiltilayered flag

---
 openpype/plugins/publish/extract_jpeg_exr.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index c658e17cab..907b3ea4af 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -126,7 +126,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
     def create_thumbnail_oiio(self, src_path, dst_path):
         self.log.info("outputting {}".format(dst_path))
         oiio_tool_path = get_oiio_tools_path()
-        oiio_cmd = [oiio_tool_path,
+        oiio_cmd = [oiio_tool_path, "-a",
                     src_path, "-o",
                     dst_path
                     ]

From f782cf4f6df2bd1762c662a77d81dd33e54239dc Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 10 Jun 2022 14:53:40 +0200
Subject: [PATCH 0556/1227] hiero: otio p3 compatibility issue - metadata on
 effect use update

rather then __setter__
---
 openpype/hosts/hiero/api/otio/hiero_export.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/hiero/api/otio/hiero_export.py b/openpype/hosts/hiero/api/otio/hiero_export.py
index 1e4088d9c0..81cb43fa12 100644
--- a/openpype/hosts/hiero/api/otio/hiero_export.py
+++ b/openpype/hosts/hiero/api/otio/hiero_export.py
@@ -132,7 +132,7 @@ def create_time_effects(otio_clip, track_item):
         otio_effect = otio.schema.TimeEffect()
         otio_effect.name = name
         otio_effect.effect_name = effect_name
-        otio_effect.metadata = metadata
+        otio_effect.metadata.update(metadata)
 
         # add otio effect to clip effects
         otio_clip.effects.append(otio_effect)

From b227ba58568a3521ead74da5f2135b6e7645b132 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 10 Jun 2022 14:54:48 +0200
Subject: [PATCH 0557/1227] removed debug log

---
 .../event_handlers_server/action_create_review_session.py       | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py b/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
index 8a1d898193..8a8e86e7b9 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
@@ -56,8 +56,6 @@ class CreateDailyReviewSessionServerAction(ServerAction):
             ):
                 valid_selection = True
                 break
-            else:
-                self.log.info(ent["entityType"])
 
         if not valid_selection:
             return False

From 0ea1032a6114f80cee0a87c1d5736ebe293cefd9 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 10 Jun 2022 15:06:30 +0200
Subject: [PATCH 0558/1227] added global plugins

---
 openpype/client/entities.py | 48 +++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 861ac300e5..b61577ac70 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -1046,6 +1046,54 @@ def get_thumbnail(project_name, thumbnail_id, fields=None):
     - project
     - asset
 
+## Global load plugins
+- openpype/plugins/load/delete_old_versions.py
+    Query:
+    - versions
+    - representations
+- openpype/plugins/load/delivery.py
+    Query:
+    - representations
+
+## Global publish plugins
+- openpype/plugins/publish/collect_avalon_entities.py
+    Query:
+    - asset
+    - project
+- openpype/plugins/publish/collect_anatomy_instance_data.py
+    Query:
+    - assets
+    - subsets
+- openpype/plugins/publish/collect_scene_loaded_versions.py
+    Query:
+    - representations
+- openpype/plugins/publish/extract_hierarchy_avalon.py
+    Query:
+    - asset
+    - assets
+    - project
+    Create:
+    - asset
+    Update:
+    - asset
+- openpype/plugins/publish/integrate_hero_version.py
+    Query:
+    - version
+    - hero version
+    - representations
+- openpype/plugins/publish/integrate_new.py
+    Query:
+    - asset
+    - subset
+    - version
+    - representations
+- openpype/plugins/publish/integrate_thumbnail.py
+    Query:
+    - version
+- openpype/plugins/publish/validate_editorial_asset_name.py
+    Query:
+    - assets
+
 ## Hosts
 ### Aftereffects
 - openpype/hosts/aftereffects/plugins/create/workfile_creator.py

From 22372361eb29d243ba16df4e83e827d1c8d54f62 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 10 Jun 2022 15:12:50 +0200
Subject: [PATCH 0559/1227] added pipeline queries

---
 openpype/client/entities.py | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index b61577ac70..82f16ff032 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -1064,6 +1064,7 @@ def get_thumbnail(project_name, thumbnail_id, fields=None):
     Query:
     - assets
     - subsets
+    - last version
 - openpype/plugins/publish/collect_scene_loaded_versions.py
     Query:
     - representations
@@ -1094,6 +1095,23 @@ def get_thumbnail(project_name, thumbnail_id, fields=None):
     Query:
     - assets
 
+## Pipeline
+- openpype/pipeline/load/utils.py
+    Query:
+    - project
+    - assets
+    - subsets
+    - version
+    - versions
+    - representation
+    - representations
+- openpype/pipeline/mongodb.py
+    Query:
+    - project
+- openpype/pipeline/thumbnail.py
+    Query:
+    - project
+
 ## Hosts
 ### Aftereffects
 - openpype/hosts/aftereffects/plugins/create/workfile_creator.py

From 956ad8299b652b38e77215b545454ddba3715d87 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 10 Jun 2022 15:19:18 +0200
Subject: [PATCH 0560/1227] mapped lib

---
 openpype/client/entities.py | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 82f16ff032..82caaee7c5 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -1095,6 +1095,39 @@ def get_thumbnail(project_name, thumbnail_id, fields=None):
     Query:
     - assets
 
+## Lib
+- openpype/lib/applications.py
+    Query:
+    - project
+    - asset
+- openpype/lib/avalon_context.py
+    Query:
+    - project
+    - asset
+    - linked assets (new function get_linked_assets?)
+    - subset
+    - subsets
+    - version
+    - versions
+    - last version
+    - representations
+    - linked representations (new function get_linked_ids_for_representations)
+    Update:
+    - workfile data
+- openpype/lib/plugin_tools.py
+    Query:
+    - asset
+- openpype/lib/project_backpack.py
+    Query:
+    - project
+    - everything from mongo
+    Update:
+    - project
+- openpype/lib/usdlib.py
+    Query:
+    - project
+    - asset
+
 ## Pipeline
 - openpype/pipeline/load/utils.py
     Query:

From 924535a6ce57c3d07bb3cdb61cde92978edc9236 Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Fri, 10 Jun 2022 15:30:14 +0200
Subject: [PATCH 0561/1227] removed icon since not the same as other entries

---
 openpype/modules/ftrack/tray/ftrack_tray.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/openpype/modules/ftrack/tray/ftrack_tray.py b/openpype/modules/ftrack/tray/ftrack_tray.py
index 699b33e187..54d3f3132f 100644
--- a/openpype/modules/ftrack/tray/ftrack_tray.py
+++ b/openpype/modules/ftrack/tray/ftrack_tray.py
@@ -45,9 +45,6 @@ class FtrackTrayWrapper:
         self.icon_not_logged = QtGui.QIcon(
             resources.get_resource("icons", "circle_orange.png")
         )
-        self.icon_ftrackapp = QtGui.QIcon(
-            resources.get_resource("icons", "inventory.png")
-        )
 
     def show_login_widget(self):
         self.widget_login.show()
@@ -270,7 +267,6 @@ class FtrackTrayWrapper:
         # Ftrack Browser
         browser_open = QtWidgets.QAction("Open Ftrack...", tray_menu)
         browser_open.triggered.connect(self.show_ftrack_browser)
-        browser_open.setIcon(self.icon_ftrackapp)
         tray_menu.addAction(browser_open)
         self.browser_open = browser_open
 

From 5e82c96a3da493de7259ffc122c21ecc617340c7 Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Fri, 10 Jun 2022 15:53:39 +0200
Subject: [PATCH 0562/1227] info label in settings, handles lists better

---
 openpype/modules/ftrack/tray/ftrack_tray.py     | 17 +++++++++++------
 .../module_settings/schema_ftrack.json          |  4 ++++
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/openpype/modules/ftrack/tray/ftrack_tray.py b/openpype/modules/ftrack/tray/ftrack_tray.py
index 54d3f3132f..30e1d9f983 100644
--- a/openpype/modules/ftrack/tray/ftrack_tray.py
+++ b/openpype/modules/ftrack/tray/ftrack_tray.py
@@ -52,12 +52,17 @@ class FtrackTrayWrapper:
         self.widget_login.raise_()
 
     def show_ftrack_browser(self):
-        am = get_system_settings()
-        browser_path = am["modules"]["ftrack"]["ftrack_browser_path"][platform.system().lower()][0]
-        browser_arg = am["modules"]["ftrack"]["ftrack_browser_arguments"][platform.system().lower()][0]
-        if "=" not in browser_arg:
-            browser_arg = '{:1}'.format(browser_arg)
-        cmd = f"{browser_path} {browser_arg}{self.module.ftrack_url}"
+        settings = get_system_settings()
+        browser_paths = settings["modules"]["ftrack"]["ftrack_browser_path"][platform.system().lower()]
+        browser_args = settings["modules"]["ftrack"]["ftrack_browser_arguments"][platform.system().lower()]
+        browser_args.append(self.module.ftrack_url)
+        path = ""
+        for p in browser_paths:
+            if os.path.exists(p):
+                path = p
+                break
+        args = " ".join(str(item) for item in browser_args).replace("= ", "=")
+        cmd = f"{path} {args}"
         log.info(f"Opening Ftrack Browser: {cmd}")
         Popen(cmd)
 
diff --git a/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json b/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
index f30d536052..268c5479fe 100644
--- a/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
+++ b/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
@@ -33,6 +33,10 @@
             "label": "Browser Arguments",
             "use_label_wrap": true,
             "children": [
+                {
+                    "type": "label",
+                    "label": "Any arguent which is used to open Ftrack URL (as in \"app=\" for chrome) needs to be placed last in the list!"
+                },
                 {
                     "key": "windows",
                     "label": "Windows",

From 29e095e285468c9fafffcdaa004df576cc88d9f7 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Fri, 10 Jun 2022 16:24:04 +0200
Subject: [PATCH 0563/1227] Remove avalon DB path

---
 openpype/modules/shotgrid/aop/patch.py        | 52 -------------------
 openpype/modules/shotgrid/shotgrid_module.py  |  4 --
 .../schemas/projects_schema/schema_main.json  |  3 +-
 3 files changed, 1 insertion(+), 58 deletions(-)
 delete mode 100644 openpype/modules/shotgrid/aop/patch.py

diff --git a/openpype/modules/shotgrid/aop/patch.py b/openpype/modules/shotgrid/aop/patch.py
deleted file mode 100644
index 56477f3bf9..0000000000
--- a/openpype/modules/shotgrid/aop/patch.py
+++ /dev/null
@@ -1,52 +0,0 @@
-from copy import copy
-
-
-from openpype.api import Logger
-from openpype.modules.shotgrid.lib import (
-    credentials,
-    settings,
-    server,
-)
-
-_LOG = Logger().get_logger("ShotgridModule.patch")
-
-
-def _patched_projects(
-    self, projection=None, only_active=True
-):
-    all_projects = list(self._prev_projects(projection, only_active))
-    if (
-        not credentials.get_local_login()
-        or not settings.filter_projects_by_login()
-    ):
-        return all_projects
-    try:
-        linked_names = _fetch_linked_project_names() or set()
-        return [x for x in all_projects if _upper(x["name"]) in linked_names]
-    except Exception as e:
-        print(e)
-        return all_projects
-
-
-def _upper(x):
-    return str(x).strip().upper()
-
-
-def _fetch_linked_project_names():
-    return {
-        _upper(x["project_name"])
-        for x in server.find_linked_projects(credentials.get_local_login())
-    }
-
-
-def patch_avalon_db():
-    _LOG.debug("Run avalon patching")
-    try:
-        from avalon.api import AvalonMongoDB
-        if AvalonMongoDB.projects is _patched_projects:
-            return None
-        _LOG.debug("Patch Avalon.projects method")
-        AvalonMongoDB._prev_projects = copy(AvalonMongoDB.projects)
-        AvalonMongoDB.projects = _patched_projects
-    except Exception as e:
-        _LOG.error("Unable to patch avalon db {}".format(e))
diff --git a/openpype/modules/shotgrid/shotgrid_module.py b/openpype/modules/shotgrid/shotgrid_module.py
index 6e0cbe987b..dcc8187194 100644
--- a/openpype/modules/shotgrid/shotgrid_module.py
+++ b/openpype/modules/shotgrid/shotgrid_module.py
@@ -46,10 +46,6 @@ class ShotgridModule(
 
     def tray_init(self):
         from .tray.shotgrid_tray import ShotgridTrayWrapper
-        from .aop.patch import patch_avalon_db
-
-        patch_avalon_db()
-        threading.Timer(10.0, patch_avalon_db).start()
 
         self.tray_wrapper = ShotgridTrayWrapper(self)
 
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_main.json b/openpype/settings/entities/schemas/projects_schema/schema_main.json
index 0ce3ddbefb..80b1baad1b 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_main.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_main.json
@@ -64,11 +64,10 @@
                 },
                 {
                     "type": "schema",
-                },
-                {
                     "name": "schema_project_shotgrid"
                 },
                 {
+                    "type": "schema",
                     "name": "schema_project_kitsu"
                 },
                 {

From 8a21439b99e6d43426cad8c47d29631b73e5706c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 10 Jun 2022 16:37:52 +0200
Subject: [PATCH 0564/1227] aded ability to parse value from clipboard that
 does not come from settings ui

---
 openpype/tools/settings/settings/base.py | 96 ++++++++++++++++++------
 1 file changed, 71 insertions(+), 25 deletions(-)

diff --git a/openpype/tools/settings/settings/base.py b/openpype/tools/settings/settings/base.py
index 44ec09b2ca..64e0a95fee 100644
--- a/openpype/tools/settings/settings/base.py
+++ b/openpype/tools/settings/settings/base.py
@@ -1,3 +1,4 @@
+import os
 import sys
 import json
 import traceback
@@ -190,24 +191,29 @@ class BaseWidget(QtWidgets.QWidget):
         actions_mapping[action] = remove_from_project_override
         menu.addAction(action)
 
+    def _get_mime_data_from_entity(self):
+        if self.entity.is_dynamic_item or self.entity.is_in_dynamic_item:
+            entity_path = None
+        else:
+            entity_path = "/".join(
+                [self.entity.root_key, self.entity.path]
+            )
+
+        value = self.entity.value
+
+        # Copy for settings tool
+        return {
+            "value": value,
+            "__root_key__": self.entity.root_key,
+            "__settings_path__": entity_path
+        }
+
     def _copy_value_actions(self, menu):
         def copy_value():
             mime_data = QtCore.QMimeData()
 
-            if self.entity.is_dynamic_item or self.entity.is_in_dynamic_item:
-                entity_path = None
-            else:
-                entity_path = "/".join(
-                    [self.entity.root_key, self.entity.path]
-                )
-
-            value = self.entity.value
             # Copy for settings tool
-            settings_data = {
-                "root_key": self.entity.root_key,
-                "value": value,
-                "path": entity_path
-            }
+            settings_data = self._get_mime_data_from_entity()
             settings_encoded_data = QtCore.QByteArray()
             settings_stream = QtCore.QDataStream(
                 settings_encoded_data, QtCore.QIODevice.WriteOnly
@@ -218,6 +224,7 @@ class BaseWidget(QtWidgets.QWidget):
             )
 
             # Copy as json
+            value = settings_data["value"]
             json_encoded_data = None
             if isinstance(value, (dict, list)):
                 json_encoded_data = QtCore.QByteArray()
@@ -241,25 +248,64 @@ class BaseWidget(QtWidgets.QWidget):
         action = QtWidgets.QAction("Copy", menu)
         return [(action, copy_value)]
 
+    def _parse_source_data_for_paste(self, data):
+        settings_path = None
+        root_key = None
+        if isinstance(data, dict):
+            settings_path = data.pop("__settings_path__", settings_path)
+            root_key = data.pop("__root_key__", root_key)
+            data = data.pop("__value__", data)
+
+        return {
+            "value": data,
+            "__settings_path__": settings_path,
+            "__root_key__": root_key
+        }
+
+    def _get_value_from_clipboard(self):
+        clipboard = QtWidgets.QApplication.clipboard()
+        mime_data = clipboard.mimeData()
+        app_value = mime_data.data("application/copy_settings_value")
+        if app_value:
+            settings_stream = QtCore.QDataStream(
+                app_value, QtCore.QIODevice.ReadOnly
+            )
+            mime_data_value_str = settings_stream.readQString()
+            return json.loads(mime_data_value_str)
+
+        if mime_data.hasUrls():
+            for url in mime_data.urls():
+                local_file = url.toLocalFile()
+                try:
+                    with open(local_file, "r") as stream:
+                        value = json.load(stream)
+                except Exception:
+                    continue
+                if value:
+                    return self._parse_source_data_for_paste(value)
+
+        if mime_data.hasText():
+            text = mime_data.text()
+            try:
+                value = json.loads(text)
+            except Exception:
+                try:
+                    value = self.entity.convert_to_valid_type(text)
+                except Exception:
+                    return None
+            return self._parse_source_data_for_paste(value)
+
     def _paste_value_actions(self, menu):
         output = []
         # Allow paste of value only if were copied from this UI
-        clipboard = QtWidgets.QApplication.clipboard()
-        mime_data = clipboard.mimeData()
-        mime_value = mime_data.data("application/copy_settings_value")
+        mime_data_value = self._get_value_from_clipboard()
         # Skip if there is nothing to do
-        if not mime_value:
+        if not mime_data_value:
             return output
 
-        settings_stream = QtCore.QDataStream(
-            mime_value, QtCore.QIODevice.ReadOnly
-        )
-        mime_data_value_str = settings_stream.readQString()
-        mime_data_value = json.loads(mime_data_value_str)
-
         value = mime_data_value["value"]
-        path = mime_data_value["path"]
-        root_key = mime_data_value["root_key"]
+        path = mime_data_value["__settings_path__"]
+        root_key = mime_data_value["__root_key__"]
 
         # Try to find matching entity to be able paste values to same spot
         # - entity can't by dynamic or in dynamic item

From 213aa2241f00cdf8524aa95a05a408e59a8f791d Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Fri, 10 Jun 2022 16:41:09 +0200
Subject: [PATCH 0565/1227] :sparkles: add pointcache family to gpu cache
 loader

---
 openpype/hosts/maya/plugins/load/load_gpucache.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/load/load_gpucache.py b/openpype/hosts/maya/plugins/load/load_gpucache.py
index 6d5e945508..a9df22faaa 100644
--- a/openpype/hosts/maya/plugins/load/load_gpucache.py
+++ b/openpype/hosts/maya/plugins/load/load_gpucache.py
@@ -10,7 +10,7 @@ from openpype.api import get_project_settings
 class GpuCacheLoader(load.LoaderPlugin):
     """Load Alembic as gpuCache"""
 
-    families = ["model"]
+    families = ["model", "pointcache"]
     representations = ["abc"]
 
     label = "Import Gpu Cache"

From 4a45225ca27d175adc481a8899a3379bcab77dc1 Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Fri, 10 Jun 2022 16:55:50 +0200
Subject: [PATCH 0566/1227] moved menu entry to last position

---
 openpype/modules/ftrack/tray/ftrack_tray.py | 30 ++++++++++-----------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/openpype/modules/ftrack/tray/ftrack_tray.py b/openpype/modules/ftrack/tray/ftrack_tray.py
index 30e1d9f983..4329b03b45 100644
--- a/openpype/modules/ftrack/tray/ftrack_tray.py
+++ b/openpype/modules/ftrack/tray/ftrack_tray.py
@@ -269,11 +269,16 @@ class FtrackTrayWrapper:
         # Menu for Tray App
         tray_menu = QtWidgets.QMenu("Ftrack", parent_menu)
 
-        # Ftrack Browser
-        browser_open = QtWidgets.QAction("Open Ftrack...", tray_menu)
-        browser_open.triggered.connect(self.show_ftrack_browser)
-        tray_menu.addAction(browser_open)
-        self.browser_open = browser_open
+        # Actions - basic
+        action_credentials = QtWidgets.QAction("Credentials", tray_menu)
+        action_credentials.triggered.connect(self.show_login_widget)
+        if self.bool_logged:
+            icon = self.icon_logged
+        else:
+            icon = self.icon_not_logged
+        action_credentials.setIcon(icon)
+        tray_menu.addAction(action_credentials)
+        self.action_credentials = action_credentials
 
         # Actions - server
         tray_server_menu = tray_menu.addMenu("Action server")
@@ -298,16 +303,11 @@ class FtrackTrayWrapper:
 
         self.tray_server_menu = tray_server_menu
 
-        # Actions - basic
-        action_credentials = QtWidgets.QAction("Credentials", tray_menu)
-        action_credentials.triggered.connect(self.show_login_widget)
-        if self.bool_logged:
-            icon = self.icon_logged
-        else:
-            icon = self.icon_not_logged
-        action_credentials.setIcon(icon)
-        tray_menu.addAction(action_credentials)
-        self.action_credentials = action_credentials
+        # Ftrack Browser
+        browser_open = QtWidgets.QAction("Open Ftrack...", tray_menu)
+        browser_open.triggered.connect(self.show_ftrack_browser)
+        tray_menu.addAction(browser_open)
+        self.browser_open = browser_open
 
         self.bool_logged = False
         self.set_menu_visibility()

From 8add4b588d762d470a9e6138cb9c3c4542b75826 Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Fri, 10 Jun 2022 17:19:59 +0200
Subject: [PATCH 0567/1227] fixed checks and logged correct info

---
 openpype/modules/ftrack/tray/ftrack_tray.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/ftrack/tray/ftrack_tray.py b/openpype/modules/ftrack/tray/ftrack_tray.py
index 4329b03b45..e3df8eff12 100644
--- a/openpype/modules/ftrack/tray/ftrack_tray.py
+++ b/openpype/modules/ftrack/tray/ftrack_tray.py
@@ -3,7 +3,7 @@ import time
 import datetime
 import threading
 import platform
-from subprocess import Popen
+import subprocess
 from Qt import QtCore, QtWidgets, QtGui
 
 import ftrack_api
@@ -60,11 +60,18 @@ class FtrackTrayWrapper:
         for p in browser_paths:
             if os.path.exists(p):
                 path = p
+                log.debug(f"Found valid executable at path: {p}")
                 break
+            else:
+                log.warning(f"Path: {p} is not valid, please doublecheck your settings!")
+        if path == "":
+            log.warning("Found no valid executables to launch Ftrack with. Feature will not work as expected!")
+            return
         args = " ".join(str(item) for item in browser_args).replace("= ", "=")
+        log.debug(f"Computed arguments: {args}")
         cmd = f"{path} {args}"
-        log.info(f"Opening Ftrack Browser: {cmd}")
-        Popen(cmd)
+        log.debug(f"Opening Ftrack Browser...")
+        subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
 
     def validate(self):
         validation = False

From f2c252be4e442136bd98fda4691a62ab23626e71 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Fri, 10 Jun 2022 17:32:20 +0200
Subject: [PATCH 0568/1227] :recycle: add animation family there too

---
 openpype/hosts/maya/plugins/load/load_gpucache.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/load/load_gpucache.py b/openpype/hosts/maya/plugins/load/load_gpucache.py
index a9df22faaa..179819f904 100644
--- a/openpype/hosts/maya/plugins/load/load_gpucache.py
+++ b/openpype/hosts/maya/plugins/load/load_gpucache.py
@@ -10,7 +10,7 @@ from openpype.api import get_project_settings
 class GpuCacheLoader(load.LoaderPlugin):
     """Load Alembic as gpuCache"""
 
-    families = ["model", "pointcache"]
+    families = ["model", "animation", "pointcache"]
     representations = ["abc"]
 
     label = "Import Gpu Cache"

From 11fc8d26e70689f76bb6ddfac60923c70cd8bbc9 Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Fri, 10 Jun 2022 17:36:38 +0200
Subject: [PATCH 0569/1227] Line breaks as per hound's "suggestion"

---
 openpype/modules/ftrack/tray/ftrack_tray.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/ftrack/tray/ftrack_tray.py b/openpype/modules/ftrack/tray/ftrack_tray.py
index e3df8eff12..ee1e50f7f5 100644
--- a/openpype/modules/ftrack/tray/ftrack_tray.py
+++ b/openpype/modules/ftrack/tray/ftrack_tray.py
@@ -53,8 +53,10 @@ class FtrackTrayWrapper:
 
     def show_ftrack_browser(self):
         settings = get_system_settings()
-        browser_paths = settings["modules"]["ftrack"]["ftrack_browser_path"][platform.system().lower()]
-        browser_args = settings["modules"]["ftrack"]["ftrack_browser_arguments"][platform.system().lower()]
+        browser_paths = settings["modules"]["ftrack"]\
+            ["ftrack_browser_path"][platform.system().lower()]
+        browser_args = settings["modules"]["ftrack"]\
+            ["ftrack_browser_arguments"][platform.system().lower()]
         browser_args.append(self.module.ftrack_url)
         path = ""
         for p in browser_paths:
@@ -63,9 +65,11 @@ class FtrackTrayWrapper:
                 log.debug(f"Found valid executable at path: {p}")
                 break
             else:
-                log.warning(f"Path: {p} is not valid, please doublecheck your settings!")
+                log.warning(f"Path: {p} is not valid, please \
+                    doublecheck your settings!")
         if path == "":
-            log.warning("Found no valid executables to launch Ftrack with. Feature will not work as expected!")
+            log.warning("Found no valid executables to launch \
+                Ftrack with. Feature will not work as expected!")
             return
         args = " ".join(str(item) for item in browser_args).replace("= ", "=")
         log.debug(f"Computed arguments: {args}")

From 99bb5250711259a1103bd21bf750a4e332aba8bc Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 10 Jun 2022 17:38:14 +0200
Subject: [PATCH 0570/1227] nuke: anatomy compatibility hack

---
 openpype/hosts/nuke/api/lib.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 2c5989309b..505eb19419 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -539,7 +539,9 @@ def get_created_node_imageio_setting_legacy(nodeclass, creator, subset):
 
     imageio_nodes = get_nuke_imageio_settings()["nodes"]
     required_nodes = imageio_nodes["requiredNodes"]
-    override_nodes = imageio_nodes["overrideNodes"]
+
+    # HACK: for backward compatibility this needs to be optional
+    override_nodes = imageio_nodes.get("overrideNodes", [])
 
     imageio_node = None
     for node in required_nodes:

From 3b97531c15e17d5f4a95842dd07879772ecd2489 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 10 Jun 2022 17:38:51 +0200
Subject: [PATCH 0571/1227] Nuke: do not offer still creator plugin if anatomy
 is missing its preset

---
 .../nuke/plugins/create/create_write_still.py      | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/plugins/create/create_write_still.py b/openpype/hosts/nuke/plugins/create/create_write_still.py
index 4007ccf51e..3fbe288c78 100644
--- a/openpype/hosts/nuke/plugins/create/create_write_still.py
+++ b/openpype/hosts/nuke/plugins/create/create_write_still.py
@@ -2,7 +2,19 @@ import nuke
 
 from openpype.hosts.nuke.api import plugin
 from openpype.hosts.nuke.api.lib import (
-    create_write_node, create_write_node_legacy)
+    create_write_node,
+    create_write_node_legacy,
+    get_created_node_imageio_setting_legacy
+)
+
+# HACK: just to disable still image on projects which
+# are not having anatomy imageio preset for CreateWriteStill
+imageio_writes = get_created_node_imageio_setting_legacy(
+    "Write",
+    "CreateWriteStill",
+    "stillMain"
+)
+print(imageio_writes["knobs"])
 
 
 class CreateWriteStill(plugin.AbstractWriteRender):

From 24a31e5e1058705d6d58fc8559fc42cfd8d661b8 Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Fri, 10 Jun 2022 17:49:16 +0200
Subject: [PATCH 0572/1227] fixed hound complaints hopefully

---
 openpype/modules/ftrack/tray/ftrack_tray.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/openpype/modules/ftrack/tray/ftrack_tray.py b/openpype/modules/ftrack/tray/ftrack_tray.py
index ee1e50f7f5..7ac994e967 100644
--- a/openpype/modules/ftrack/tray/ftrack_tray.py
+++ b/openpype/modules/ftrack/tray/ftrack_tray.py
@@ -52,11 +52,10 @@ class FtrackTrayWrapper:
         self.widget_login.raise_()
 
     def show_ftrack_browser(self):
-        settings = get_system_settings()
-        browser_paths = settings["modules"]["ftrack"]\
-            ["ftrack_browser_path"][platform.system().lower()]
-        browser_args = settings["modules"]["ftrack"]\
-            ["ftrack_browser_arguments"][platform.system().lower()]
+        cur_os = platform.system().lower()
+        settings = get_system_settings()["modules"]["ftrack"]
+        browser_paths = settings["ftrack_browser_path"][cur_os]
+        browser_args = settings["ftrack_browser_arguments"][cur_os]
         browser_args.append(self.module.ftrack_url)
         path = ""
         for p in browser_paths:

From c77f9ce2e52c6f97cb9b4e8cb86ebcfeb5a11153 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 10 Jun 2022 17:51:55 +0200
Subject: [PATCH 0573/1227] added option to extract settings to file

---
 openpype/tools/settings/settings/base.py | 102 +++++++++++++++++++----
 1 file changed, 86 insertions(+), 16 deletions(-)

diff --git a/openpype/tools/settings/settings/base.py b/openpype/tools/settings/settings/base.py
index 64e0a95fee..3ade5e5ef8 100644
--- a/openpype/tools/settings/settings/base.py
+++ b/openpype/tools/settings/settings/base.py
@@ -3,6 +3,7 @@ import sys
 import json
 import traceback
 import functools
+import datetime
 
 from Qt import QtWidgets, QtGui, QtCore
 
@@ -13,10 +14,26 @@ from .widgets import ExpandingWidget
 from .lib import create_deffered_value_change_timer
 from .constants import DEFAULT_PROJECT_LABEL
 
+_MENU_SEPARATOR_REQ = object()
+SETTINGS_PATH_KEY = "__settings_path__"
+ROOT_KEY = "__root_key__"
+VALUE_KEY = "__value__"
+SAVE_TIME_KEY = "__extracted__"
+PROJECT_NAME_KEY = "__project_name__"
+
 
 class BaseWidget(QtWidgets.QWidget):
+    _last_save_dir = os.path.expanduser("~")
     allow_actions = True
 
+    @staticmethod
+    def get_last_save_dir():
+        return BaseWidget._last_save_dir
+
+    @staticmethod
+    def set_last_save_dir(save_dir):
+        BaseWidget._last_save_dir = save_dir
+
     def __init__(self, category_widget, entity, entity_widget):
         self.category_widget = category_widget
         self.entity = entity
@@ -203,9 +220,9 @@ class BaseWidget(QtWidgets.QWidget):
 
         # Copy for settings tool
         return {
-            "value": value,
-            "__root_key__": self.entity.root_key,
-            "__settings_path__": entity_path
+            VALUE_KEY: value,
+            ROOT_KEY: self.entity.root_key,
+            SETTINGS_PATH_KEY: entity_path
         }
 
     def _copy_value_actions(self, menu):
@@ -248,18 +265,62 @@ class BaseWidget(QtWidgets.QWidget):
         action = QtWidgets.QAction("Copy", menu)
         return [(action, copy_value)]
 
+    def _extract_to_file(self):
+        dialog = QtWidgets.QFileDialog(
+            self,
+            "Save settings values",
+            self.get_last_save_dir(),
+            "Values (*.json)"
+        )
+        # dialog.setOption(dialog.DontUseNativeDialog)
+        dialog.setAcceptMode(dialog.AcceptSave)
+        if dialog.exec() != dialog.Accepted:
+            return
+
+        selected_urls = dialog.selectedUrls()
+        if not selected_urls:
+            return
+
+        filepath = selected_urls[0].toLocalFile()
+        if not filepath:
+            return
+
+        if not filepath.lower().endswith(".json"):
+            filepath += ".json"
+
+        settings_data = self._get_mime_data_from_entity()
+        now = datetime.datetime.now()
+        settings_data[SAVE_TIME_KEY] = now.strftime("%Y-%m-%d %H:%M:%S")
+        if hasattr(self.category_widget, "project_name"):
+            settings_data[PROJECT_NAME_KEY] = self.category_widget.project_name
+
+        with open(filepath, "w") as stream:
+            json.dump(settings_data, stream, indent=4)
+
+        new_dir = os.path.dirname(filepath)
+        self.set_last_save_dir(new_dir)
+
+    def _extract_value_to_file_actions(self, menu):
+        save_action = QtWidgets.QAction("Extract to file", menu)
+        return [
+            _MENU_SEPARATOR_REQ,
+            (save_action, self._extract_to_file)
+        ]
+
     def _parse_source_data_for_paste(self, data):
         settings_path = None
         root_key = None
         if isinstance(data, dict):
-            settings_path = data.pop("__settings_path__", settings_path)
-            root_key = data.pop("__root_key__", root_key)
-            data = data.pop("__value__", data)
+            data.pop(SAVE_TIME_KEY, None)
+            data.pop(PROJECT_NAME_KEY, None)
+            settings_path = data.pop(SETTINGS_PATH_KEY, settings_path)
+            root_key = data.pop(ROOT_KEY, root_key)
+            data = data.pop(VALUE_KEY, data)
 
         return {
-            "value": data,
-            "__settings_path__": settings_path,
-            "__root_key__": root_key
+            VALUE_KEY: data,
+            SETTINGS_PATH_KEY: settings_path,
+            ROOT_KEY: root_key
         }
 
     def _get_value_from_clipboard(self):
@@ -303,9 +364,9 @@ class BaseWidget(QtWidgets.QWidget):
         if not mime_data_value:
             return output
 
-        value = mime_data_value["value"]
-        path = mime_data_value["__settings_path__"]
-        root_key = mime_data_value["__root_key__"]
+        value = mime_data_value[VALUE_KEY]
+        path = mime_data_value[SETTINGS_PATH_KEY]
+        root_key = mime_data_value[ROOT_KEY]
 
         # Try to find matching entity to be able paste values to same spot
         # - entity can't by dynamic or in dynamic item
@@ -437,10 +498,19 @@ class BaseWidget(QtWidgets.QWidget):
         ui_actions.extend(self._copy_value_actions(menu))
         ui_actions.extend(self._paste_value_actions(menu))
         if ui_actions:
-            menu.addSeparator()
-            for action, callback in ui_actions:
-                menu.addAction(action)
-                actions_mapping[action] = callback
+            ui_actions.insert(0, _MENU_SEPARATOR_REQ)
+
+        ui_actions.extend(self._extract_value_to_file_actions(menu))
+
+        for item in ui_actions:
+            if item is _MENU_SEPARATOR_REQ:
+                if len(menu.actions()) > 0:
+                    menu.addSeparator()
+                continue
+
+            action, callback = item
+            menu.addAction(action)
+            actions_mapping[action] = callback
 
         if not actions_mapping:
             action = QtWidgets.QAction("< No action >")

From b2ed0292adac2c914f50e95575b3494f43b33086 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 10 Jun 2022 17:53:34 +0200
Subject: [PATCH 0574/1227] Nuke: adding todo comment

---
 openpype/hosts/nuke/plugins/create/create_write_still.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/nuke/plugins/create/create_write_still.py b/openpype/hosts/nuke/plugins/create/create_write_still.py
index 3fbe288c78..bb08e8c2c6 100644
--- a/openpype/hosts/nuke/plugins/create/create_write_still.py
+++ b/openpype/hosts/nuke/plugins/create/create_write_still.py
@@ -9,6 +9,7 @@ from openpype.hosts.nuke.api.lib import (
 
 # HACK: just to disable still image on projects which
 # are not having anatomy imageio preset for CreateWriteStill
+# TODO: remove this code as soon as it will be obsolete
 imageio_writes = get_created_node_imageio_setting_legacy(
     "Write",
     "CreateWriteStill",

From 26b6bbab95c727b5f2dfcc07413c4d71d2d6f7a8 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Fri, 10 Jun 2022 18:18:50 +0200
Subject: [PATCH 0575/1227] update poetry lib

---
 poetry.lock | 70 ++++++++++++++++++++++++++---------------------------
 1 file changed, 35 insertions(+), 35 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 04be8c78f2..010dd57e17 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -161,11 +161,11 @@ toml = "*"
 
 [[package]]
 name = "babel"
-version = "2.9.1"
+version = "2.10.1"
 description = "Internationalization utilities"
 category = "dev"
 optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
+python-versions = ">=3.6"
 
 [package.dependencies]
 pytz = ">=2015.7"
@@ -909,7 +909,7 @@ python-versions = "*"
 
 [[package]]
 name = "protobuf"
-version = "3.20.0"
+version = "3.20.1"
 description = "Protocol Buffers"
 category = "main"
 optional = false
@@ -1617,11 +1617,11 @@ python-versions = ">=3.6"
 
 [[package]]
 name = "typing-extensions"
-version = "4.1.1"
-description = "Backported and Experimental Type Hints for Python 3.6+"
+version = "4.2.0"
+description = "Backported and Experimental Type Hints for Python 3.7+"
 category = "main"
 optional = false
-python-versions = ">=3.6"
+python-versions = ">=3.7"
 
 [[package]]
 name = "uritemplate"
@@ -1716,7 +1716,7 @@ testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-
 [metadata]
 lock-version = "1.1"
 python-versions = "3.7.*"
-content-hash = "bd8e0a03668c380c6e76c8cd6c71020692f4ea9f32de7a4f09433564faa9dad0"
+content-hash = "f7150d3d8098c26a004db9850ed328efe79695e77e830721a3e04c5941850cc5"
 
 [metadata.files]
 acre = []
@@ -1843,8 +1843,8 @@ autopep8 = [
     {file = "autopep8-1.5.7.tar.gz", hash = "sha256:276ced7e9e3cb22e5d7c14748384a5cf5d9002257c0ed50c0e075b68011bb6d0"},
 ]
 babel = [
-    {file = "Babel-2.9.1-py2.py3-none-any.whl", hash = "sha256:ab49e12b91d937cd11f0b67cb259a57ab4ad2b59ac7a3b41d6c06c0ac5b0def9"},
-    {file = "Babel-2.9.1.tar.gz", hash = "sha256:bc0c176f9f6a994582230df350aa6e05ba2ebe4b3ac317eab29d9be5d2768da0"},
+    {file = "Babel-2.10.1-py3-none-any.whl", hash = "sha256:3f349e85ad3154559ac4930c3918247d319f21910d5ce4b25d439ed8693b98d2"},
+    {file = "Babel-2.10.1.tar.gz", hash = "sha256:98aeaca086133efb3e1e2aad0396987490c8425929ddbcfe0550184fdc54cd13"},
 ]
 bcrypt = [
     {file = "bcrypt-3.2.2-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:7180d98a96f00b1050e93f5b0f556e658605dd9f524d0b0e68ae7944673f525e"},
@@ -2444,30 +2444,30 @@ prefixed = [
     {file = "prefixed-0.3.2.tar.gz", hash = "sha256:ca48277ba5fa8346dd4b760847da930c7b84416387c39e93affef086add2c029"},
 ]
 protobuf = [
-    {file = "protobuf-3.20.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:9d0f3aca8ca51c8b5e204ab92bd8afdb2a8e3df46bd0ce0bd39065d79aabcaa4"},
-    {file = "protobuf-3.20.0-cp310-cp310-manylinux2014_aarch64.whl", hash = "sha256:001c2160c03b6349c04de39cf1a58e342750da3632f6978a1634a3dcca1ec10e"},
-    {file = "protobuf-3.20.0-cp310-cp310-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:5b5860b790498f233cdc8d635a17fc08de62e59d4dcd8cdb6c6c0d38a31edf2b"},
-    {file = "protobuf-3.20.0-cp310-cp310-win32.whl", hash = "sha256:0b250c60256c8824219352dc2a228a6b49987e5bf94d3ffcf4c46585efcbd499"},
-    {file = "protobuf-3.20.0-cp310-cp310-win_amd64.whl", hash = "sha256:a1eebb6eb0653e594cb86cd8e536b9b083373fca9aba761ade6cd412d46fb2ab"},
-    {file = "protobuf-3.20.0-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:bc14037281db66aa60856cd4ce4541a942040686d290e3f3224dd3978f88f554"},
-    {file = "protobuf-3.20.0-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:47257d932de14a7b6c4ae1b7dbf592388153ee35ec7cae216b87ae6490ed39a3"},
-    {file = "protobuf-3.20.0-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:fbcbb068ebe67c4ff6483d2e2aa87079c325f8470b24b098d6bf7d4d21d57a69"},
-    {file = "protobuf-3.20.0-cp37-cp37m-manylinux2014_aarch64.whl", hash = "sha256:542f25a4adf3691a306dcc00bf9a73176554938ec9b98f20f929a044f80acf1b"},
-    {file = "protobuf-3.20.0-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:fd7133b885e356fa4920ead8289bb45dc6f185a164e99e10279f33732ed5ce15"},
-    {file = "protobuf-3.20.0-cp37-cp37m-win32.whl", hash = "sha256:8d84453422312f8275455d1cb52d850d6a4d7d714b784e41b573c6f5bfc2a029"},
-    {file = "protobuf-3.20.0-cp37-cp37m-win_amd64.whl", hash = "sha256:52bae32a147c375522ce09bd6af4d2949aca32a0415bc62df1456b3ad17c6001"},
-    {file = "protobuf-3.20.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:25d2fcd6eef340082718ec9ad2c58d734429f2b1f7335d989523852f2bba220b"},
-    {file = "protobuf-3.20.0-cp38-cp38-manylinux2014_aarch64.whl", hash = "sha256:88c8be0558bdfc35e68c42ae5bf785eb9390d25915d4863bbc7583d23da77074"},
-    {file = "protobuf-3.20.0-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:38fd9eb74b852e4ee14b16e9670cd401d147ee3f3ec0d4f7652e0c921d6227f8"},
-    {file = "protobuf-3.20.0-cp38-cp38-win32.whl", hash = "sha256:7dcd84dc31ebb35ade755e06d1561d1bd3b85e85dbdbf6278011fc97b22810db"},
-    {file = "protobuf-3.20.0-cp38-cp38-win_amd64.whl", hash = "sha256:1eb13f5a5a59ca4973bcfa2fc8fff644bd39f2109c3f7a60bd5860cb6a49b679"},
-    {file = "protobuf-3.20.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:1d24c81c2310f0063b8fc1c20c8ed01f3331be9374b4b5c2de846f69e11e21fb"},
-    {file = "protobuf-3.20.0-cp39-cp39-manylinux2014_aarch64.whl", hash = "sha256:8be43a91ab66fe995e85ccdbdd1046d9f0443d59e060c0840319290de25b7d33"},
-    {file = "protobuf-3.20.0-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:7a53d4035427b9dbfbb397f46642754d294f131e93c661d056366f2a31438263"},
-    {file = "protobuf-3.20.0-cp39-cp39-win32.whl", hash = "sha256:32bf4a90c207a0b4e70ca6dd09d43de3cb9898f7d5b69c2e9e3b966a7f342820"},
-    {file = "protobuf-3.20.0-cp39-cp39-win_amd64.whl", hash = "sha256:6efe066a7135233f97ce51a1aa007d4fb0be28ef093b4f88dac4ad1b3a2b7b6f"},
-    {file = "protobuf-3.20.0-py2.py3-none-any.whl", hash = "sha256:4eda68bd9e2a4879385e6b1ea528c976f59cd9728382005cc54c28bcce8db983"},
-    {file = "protobuf-3.20.0.tar.gz", hash = "sha256:71b2c3d1cd26ed1ec7c8196834143258b2ad7f444efff26fdc366c6f5e752702"},
+    {file = "protobuf-3.20.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:3cc797c9d15d7689ed507b165cd05913acb992d78b379f6014e013f9ecb20996"},
+    {file = "protobuf-3.20.1-cp310-cp310-manylinux2014_aarch64.whl", hash = "sha256:ff8d8fa42675249bb456f5db06c00de6c2f4c27a065955917b28c4f15978b9c3"},
+    {file = "protobuf-3.20.1-cp310-cp310-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:cd68be2559e2a3b84f517fb029ee611546f7812b1fdd0aa2ecc9bc6ec0e4fdde"},
+    {file = "protobuf-3.20.1-cp310-cp310-win32.whl", hash = "sha256:9016d01c91e8e625141d24ec1b20fed584703e527d28512aa8c8707f105a683c"},
+    {file = "protobuf-3.20.1-cp310-cp310-win_amd64.whl", hash = "sha256:32ca378605b41fd180dfe4e14d3226386d8d1b002ab31c969c366549e66a2bb7"},
+    {file = "protobuf-3.20.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:9be73ad47579abc26c12024239d3540e6b765182a91dbc88e23658ab71767153"},
+    {file = "protobuf-3.20.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:097c5d8a9808302fb0da7e20edf0b8d4703274d140fd25c5edabddcde43e081f"},
+    {file = "protobuf-3.20.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:e250a42f15bf9d5b09fe1b293bdba2801cd520a9f5ea2d7fb7536d4441811d20"},
+    {file = "protobuf-3.20.1-cp37-cp37m-manylinux2014_aarch64.whl", hash = "sha256:cdee09140e1cd184ba9324ec1df410e7147242b94b5f8b0c64fc89e38a8ba531"},
+    {file = "protobuf-3.20.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:af0ebadc74e281a517141daad9d0f2c5d93ab78e9d455113719a45a49da9db4e"},
+    {file = "protobuf-3.20.1-cp37-cp37m-win32.whl", hash = "sha256:755f3aee41354ae395e104d62119cb223339a8f3276a0cd009ffabfcdd46bb0c"},
+    {file = "protobuf-3.20.1-cp37-cp37m-win_amd64.whl", hash = "sha256:62f1b5c4cd6c5402b4e2d63804ba49a327e0c386c99b1675c8a0fefda23b2067"},
+    {file = "protobuf-3.20.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:06059eb6953ff01e56a25cd02cca1a9649a75a7e65397b5b9b4e929ed71d10cf"},
+    {file = "protobuf-3.20.1-cp38-cp38-manylinux2014_aarch64.whl", hash = "sha256:cb29edb9eab15742d791e1025dd7b6a8f6fcb53802ad2f6e3adcb102051063ab"},
+    {file = "protobuf-3.20.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:69ccfdf3657ba59569c64295b7d51325f91af586f8d5793b734260dfe2e94e2c"},
+    {file = "protobuf-3.20.1-cp38-cp38-win32.whl", hash = "sha256:dd5789b2948ca702c17027c84c2accb552fc30f4622a98ab5c51fcfe8c50d3e7"},
+    {file = "protobuf-3.20.1-cp38-cp38-win_amd64.whl", hash = "sha256:77053d28427a29987ca9caf7b72ccafee011257561259faba8dd308fda9a8739"},
+    {file = "protobuf-3.20.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:6f50601512a3d23625d8a85b1638d914a0970f17920ff39cec63aaef80a93fb7"},
+    {file = "protobuf-3.20.1-cp39-cp39-manylinux2014_aarch64.whl", hash = "sha256:284f86a6207c897542d7e956eb243a36bb8f9564c1742b253462386e96c6b78f"},
+    {file = "protobuf-3.20.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:7403941f6d0992d40161aa8bb23e12575637008a5a02283a930addc0508982f9"},
+    {file = "protobuf-3.20.1-cp39-cp39-win32.whl", hash = "sha256:db977c4ca738dd9ce508557d4fce0f5aebd105e158c725beec86feb1f6bc20d8"},
+    {file = "protobuf-3.20.1-cp39-cp39-win_amd64.whl", hash = "sha256:7e371f10abe57cee5021797126c93479f59fccc9693dafd6bd5633ab67808a91"},
+    {file = "protobuf-3.20.1-py2.py3-none-any.whl", hash = "sha256:adfc6cf69c7f8c50fd24c793964eef18f0ac321315439d94945820612849c388"},
+    {file = "protobuf-3.20.1.tar.gz", hash = "sha256:adc31566d027f45efe3f44eeb5b1f329da43891634d61c75a5944e9be6dd42c9"},
 ]
 py = [
     {file = "py-1.11.0-py2.py3-none-any.whl", hash = "sha256:607c53218732647dff4acdfcd50cb62615cedf612e72d1724fb1a0cc6405b378"},
@@ -2891,8 +2891,8 @@ typed-ast = [
     {file = "typed_ast-1.5.4.tar.gz", hash = "sha256:39e21ceb7388e4bb37f4c679d72707ed46c2fbf2a5609b8b8ebc4b067d977df2"},
 ]
 typing-extensions = [
-    {file = "typing_extensions-4.1.1-py3-none-any.whl", hash = "sha256:21c85e0fe4b9a155d0799430b0ad741cdce7e359660ccbd8b530613e8df88ce2"},
-    {file = "typing_extensions-4.1.1.tar.gz", hash = "sha256:1a9462dcc3347a79b1f1c0271fbe79e844580bb598bafa1ed208b94da3cdcd42"},
+    {file = "typing_extensions-4.2.0-py3-none-any.whl", hash = "sha256:6657594ee297170d19f67d55c05852a874e7eb634f4f753dbd667855e07c1708"},
+    {file = "typing_extensions-4.2.0.tar.gz", hash = "sha256:f1c24655a0da0d1b67f07e17a5e6b2a105894e6824b92096378bb3668ef02376"},
 ]
 uritemplate = [
     {file = "uritemplate-3.0.1-py2.py3-none-any.whl", hash = "sha256:07620c3f3f8eed1f12600845892b0e036a2420acf513c53f7de0abd911a5894f"},

From 8a06a4afc1866a5837b5cab7c4ad3845eb6ee050 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Fri, 10 Jun 2022 18:25:40 +0200
Subject: [PATCH 0576/1227] remove unused import

---
 openpype/modules/shotgrid/shotgrid_module.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/modules/shotgrid/shotgrid_module.py b/openpype/modules/shotgrid/shotgrid_module.py
index dcc8187194..5644f0c35f 100644
--- a/openpype/modules/shotgrid/shotgrid_module.py
+++ b/openpype/modules/shotgrid/shotgrid_module.py
@@ -1,5 +1,4 @@
 import os
-import threading
 
 from openpype_interfaces import (
     ITrayModule,

From e21caf109fc3405afb36e86ab7f9ff9dbb8b0726 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 10 Jun 2022 18:26:05 +0200
Subject: [PATCH 0577/1227] extraction can be called on whole settings

---
 openpype/tools/settings/settings/base.py      | 110 +++++++++++-------
 .../tools/settings/settings/categories.py     |  35 +++++-
 openpype/tools/settings/settings/constants.py |  13 +++
 3 files changed, 112 insertions(+), 46 deletions(-)

diff --git a/openpype/tools/settings/settings/base.py b/openpype/tools/settings/settings/base.py
index 3ade5e5ef8..aa2b448ccf 100644
--- a/openpype/tools/settings/settings/base.py
+++ b/openpype/tools/settings/settings/base.py
@@ -12,28 +12,71 @@ from openpype.tools.settings import CHILD_OFFSET
 
 from .widgets import ExpandingWidget
 from .lib import create_deffered_value_change_timer
-from .constants import DEFAULT_PROJECT_LABEL
+from .constants import (
+    DEFAULT_PROJECT_LABEL,
+    SETTINGS_PATH_KEY,
+    ROOT_KEY,
+    VALUE_KEY,
+    SAVE_TIME_KEY,
+    PROJECT_NAME_KEY,
+)
 
 _MENU_SEPARATOR_REQ = object()
-SETTINGS_PATH_KEY = "__settings_path__"
-ROOT_KEY = "__root_key__"
-VALUE_KEY = "__value__"
-SAVE_TIME_KEY = "__extracted__"
-PROJECT_NAME_KEY = "__project_name__"
+
+
+class ExtractHelper:
+    _last_save_dir = os.path.expanduser("~")
+
+    @classmethod
+    def get_last_save_dir(cls):
+        return cls._last_save_dir
+
+    @classmethod
+    def set_last_save_dir(cls, save_dir):
+        cls._last_save_dir = save_dir
+
+    @classmethod
+    def ask_for_save_filepath(cls, parent):
+        dialog = QtWidgets.QFileDialog(
+            parent,
+            "Save settings values",
+            cls.get_last_save_dir(),
+            "Values (*.json)"
+        )
+        # dialog.setOption(dialog.DontUseNativeDialog)
+        dialog.setAcceptMode(dialog.AcceptSave)
+        if dialog.exec() != dialog.Accepted:
+            return
+
+        selected_urls = dialog.selectedUrls()
+        if not selected_urls:
+            return
+
+        filepath = selected_urls[0].toLocalFile()
+        if not filepath:
+            return
+
+        if not filepath.lower().endswith(".json"):
+            filepath += ".json"
+        return filepath
+
+    @classmethod
+    def extract_settings_to_json(cls, filepath, settings_data, project_name):
+        now = datetime.datetime.now()
+        settings_data[SAVE_TIME_KEY] = now.strftime("%Y-%m-%d %H:%M:%S")
+        if project_name != 0:
+            settings_data[PROJECT_NAME_KEY] = project_name
+
+        with open(filepath, "w") as stream:
+            json.dump(settings_data, stream, indent=4)
+
+        new_dir = os.path.dirname(filepath)
+        cls.set_last_save_dir(new_dir)
 
 
 class BaseWidget(QtWidgets.QWidget):
-    _last_save_dir = os.path.expanduser("~")
     allow_actions = True
 
-    @staticmethod
-    def get_last_save_dir():
-        return BaseWidget._last_save_dir
-
-    @staticmethod
-    def set_last_save_dir(save_dir):
-        BaseWidget._last_save_dir = save_dir
-
     def __init__(self, category_widget, entity, entity_widget):
         self.category_widget = category_widget
         self.entity = entity
@@ -266,45 +309,24 @@ class BaseWidget(QtWidgets.QWidget):
         return [(action, copy_value)]
 
     def _extract_to_file(self):
-        dialog = QtWidgets.QFileDialog(
-            self,
-            "Save settings values",
-            self.get_last_save_dir(),
-            "Values (*.json)"
-        )
-        # dialog.setOption(dialog.DontUseNativeDialog)
-        dialog.setAcceptMode(dialog.AcceptSave)
-        if dialog.exec() != dialog.Accepted:
-            return
-
-        selected_urls = dialog.selectedUrls()
-        if not selected_urls:
-            return
-
-        filepath = selected_urls[0].toLocalFile()
+        filepath = ExtractHelper.ask_for_save_filepath(self)
         if not filepath:
             return
 
-        if not filepath.lower().endswith(".json"):
-            filepath += ".json"
-
         settings_data = self._get_mime_data_from_entity()
-        now = datetime.datetime.now()
-        settings_data[SAVE_TIME_KEY] = now.strftime("%Y-%m-%d %H:%M:%S")
+        project_name = 0
         if hasattr(self.category_widget, "project_name"):
-            settings_data[PROJECT_NAME_KEY] = self.category_widget.project_name
+            project_name = self.category_widget.project_name
 
-        with open(filepath, "w") as stream:
-            json.dump(settings_data, stream, indent=4)
-
-        new_dir = os.path.dirname(filepath)
-        self.set_last_save_dir(new_dir)
+        ExtractHelper.extract_settings_to_json(
+            filepath, settings_data, project_name
+        )
 
     def _extract_value_to_file_actions(self, menu):
-        save_action = QtWidgets.QAction("Extract to file", menu)
+        extract_action = QtWidgets.QAction("Extract to file", menu)
         return [
             _MENU_SEPARATOR_REQ,
-            (save_action, self._extract_to_file)
+            (extract_action, self._extract_to_file)
         ]
 
     def _parse_source_data_for_paste(self, data):
diff --git a/openpype/tools/settings/settings/categories.py b/openpype/tools/settings/settings/categories.py
index c8ade5fcdb..764f42f1a3 100644
--- a/openpype/tools/settings/settings/categories.py
+++ b/openpype/tools/settings/settings/categories.py
@@ -45,8 +45,15 @@ from .breadcrumbs_widget import (
     SystemSettingsBreadcrumbs,
     ProjectSettingsBreadcrumbs
 )
-
-from .base import GUIWidget
+from .constants import (
+    SETTINGS_PATH_KEY,
+    ROOT_KEY,
+    VALUE_KEY,
+)
+from .base import (
+    ExtractHelper,
+    GUIWidget,
+)
 from .list_item_widget import ListWidget
 from .list_strict_widget import ListStrictWidget
 from .dict_mutable_widget import DictMutableKeysWidget
@@ -627,11 +634,35 @@ class SettingsCategoryWidget(QtWidgets.QWidget):
                 self._on_context_version_trigger
             )
             submenu.addAction(action)
+
         menu.addMenu(submenu)
 
+        extract_action = QtWidgets.QAction("Extract to file", menu)
+        extract_action.triggered.connect(self._on_extract_to_file)
+
+        menu.addAction(extract_action)
+
     def _on_context_version_trigger(self, version):
         self._on_source_version_change(version)
 
+    def _on_extract_to_file(self):
+        filepath = ExtractHelper.ask_for_save_filepath(self)
+        if not filepath:
+            return
+
+        settings_data = {
+            SETTINGS_PATH_KEY: self.entity.root_key,
+            ROOT_KEY: self.entity.root_key,
+            VALUE_KEY: self.entity.value
+        }
+        project_name = 0
+        if hasattr(self, "project_name"):
+            project_name = self.project_name
+
+        ExtractHelper.extract_settings_to_json(
+            filepath, settings_data, project_name
+        )
+
     def _on_reset_crash(self):
         self.save_btn.setEnabled(False)
 
diff --git a/openpype/tools/settings/settings/constants.py b/openpype/tools/settings/settings/constants.py
index 9d6d7904d7..d98d18c8bf 100644
--- a/openpype/tools/settings/settings/constants.py
+++ b/openpype/tools/settings/settings/constants.py
@@ -7,6 +7,12 @@ PROJECT_IS_ACTIVE_ROLE = QtCore.Qt.UserRole + 2
 PROJECT_IS_SELECTED_ROLE = QtCore.Qt.UserRole + 3
 PROJECT_VERSION_ROLE = QtCore.Qt.UserRole + 4
 
+# Save/Extract keys
+SETTINGS_PATH_KEY = "__settings_path__"
+ROOT_KEY = "__root_key__"
+VALUE_KEY = "__value__"
+SAVE_TIME_KEY = "__extracted__"
+PROJECT_NAME_KEY = "__project_name__"
 
 __all__ = (
     "DEFAULT_PROJECT_LABEL",
@@ -15,4 +21,11 @@ __all__ = (
     "PROJECT_IS_ACTIVE_ROLE",
     "PROJECT_IS_SELECTED_ROLE",
     "PROJECT_VERSION_ROLE",
+
+    "SETTINGS_PATH_KEY",
+    "ROOT_KEY",
+    "SETTINGS_PATH_KEY",
+    "VALUE_KEY",
+    "SAVE_TIME_KEY",
+    "PROJECT_NAME_KEY",
 )

From 7d6ef39352ac63ce1bd3a9901f24ef74b7dd6ce4 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 10 Jun 2022 18:31:28 +0200
Subject: [PATCH 0578/1227] Fix #3319: Houdini VDB update wrong file attribute
 name

---
 openpype/hosts/houdini/plugins/load/load_vdb.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/load/load_vdb.py b/openpype/hosts/houdini/plugins/load/load_vdb.py
index 06bb9e45e4..54535446a3 100644
--- a/openpype/hosts/houdini/plugins/load/load_vdb.py
+++ b/openpype/hosts/houdini/plugins/load/load_vdb.py
@@ -102,7 +102,7 @@ class VdbLoader(load.LoaderPlugin):
         file_path = get_representation_path(representation)
         file_path = self.format_path(file_path)
 
-        file_node.setParms({"fileName": file_path})
+        file_node.setParms({"file": file_path})
 
         # Update attribute
         node.setParms({"representation": str(representation["_id"])})
@@ -110,4 +110,4 @@ class VdbLoader(load.LoaderPlugin):
     def remove(self, container):
 
         node = container["node"]
-        node.destroy()
+        node.destroy()
\ No newline at end of file

From 86f19dfa5e187906eb3707a172cb86a665ddfa9f Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 10 Jun 2022 18:33:33 +0200
Subject: [PATCH 0579/1227] Fix no new line at end of file

---
 openpype/hosts/houdini/plugins/load/load_vdb.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/houdini/plugins/load/load_vdb.py b/openpype/hosts/houdini/plugins/load/load_vdb.py
index 54535446a3..5e572c83e5 100644
--- a/openpype/hosts/houdini/plugins/load/load_vdb.py
+++ b/openpype/hosts/houdini/plugins/load/load_vdb.py
@@ -110,4 +110,4 @@ class VdbLoader(load.LoaderPlugin):
     def remove(self, container):
 
         node = container["node"]
-        node.destroy()
\ No newline at end of file
+        node.destroy()

From f1a5a122cf1801f0b812a3e10936b7336b630a15 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 9 Jun 2022 18:35:54 +0200
Subject: [PATCH 0580/1227] Project Manager: fix tools not being visible until
 when editable

(cherry picked from commit fbdd225c8b0cc579a022d69c179a5f90fc6a387d)
---
 openpype/tools/project_manager/project_manager/delegates.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/openpype/tools/project_manager/project_manager/delegates.py b/openpype/tools/project_manager/project_manager/delegates.py
index 31487ff132..b066bbb159 100644
--- a/openpype/tools/project_manager/project_manager/delegates.py
+++ b/openpype/tools/project_manager/project_manager/delegates.py
@@ -205,3 +205,9 @@ class ToolsDelegate(QtWidgets.QStyledItemDelegate):
 
     def setModelData(self, editor, model, index):
         model.setData(index, editor.value(), QtCore.Qt.EditRole)
+
+    def displayText(self, value, locale):
+        if value:
+            return ", ".join(value)
+        else:
+            return

From c486fb6f59a0d4ed977d8260c08c7d54bf5e3ba5 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 10 Jun 2022 13:06:49 +0200
Subject: [PATCH 0581/1227] Force edit mode on add task button

(cherry picked from commit 96ca15b565b952d4e17c2010e8846ca18272d681)
---
 openpype/tools/project_manager/project_manager/window.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/tools/project_manager/project_manager/window.py b/openpype/tools/project_manager/project_manager/window.py
index c281479d4f..10b28f535f 100644
--- a/openpype/tools/project_manager/project_manager/window.py
+++ b/openpype/tools/project_manager/project_manager/window.py
@@ -245,7 +245,8 @@ class ProjectManagerWindow(QtWidgets.QWidget):
         self.hierarchy_view.add_asset()
 
     def _on_add_task(self):
-        self.hierarchy_view.add_task()
+        # Colorbleed edit: force the task to directly be in edit mode
+        self.hierarchy_view._add_task_and_edit()
 
     def _on_create_folders(self):
         project_name = self._current_project()

From d2de1539136ad7d4da5902d78aed56dd204f4a50 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 10 Jun 2022 18:47:42 +0200
Subject: [PATCH 0582/1227] fix copy value to string

---
 openpype/tools/settings/settings/base.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/tools/settings/settings/base.py b/openpype/tools/settings/settings/base.py
index aa2b448ccf..6def284a83 100644
--- a/openpype/tools/settings/settings/base.py
+++ b/openpype/tools/settings/settings/base.py
@@ -284,7 +284,7 @@ class BaseWidget(QtWidgets.QWidget):
             )
 
             # Copy as json
-            value = settings_data["value"]
+            value = settings_data[VALUE_KEY]
             json_encoded_data = None
             if isinstance(value, (dict, list)):
                 json_encoded_data = QtCore.QByteArray()

From 44b1b638e58e7fc3da13fc54ad100d980a44a1ca Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 7 Jun 2022 15:58:30 +0200
Subject: [PATCH 0583/1227] Optimization: speed up validate mesh shader
 connections for large scenes

(cherry picked from commit 46752511e500a54ba9335a325ca09224ef600227)
---
 .../validate_mesh_shader_connections.py       | 61 +++++++++++--------
 1 file changed, 34 insertions(+), 27 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_mesh_shader_connections.py b/openpype/hosts/maya/plugins/publish/validate_mesh_shader_connections.py
index 0969573a90..e0835000f0 100644
--- a/openpype/hosts/maya/plugins/publish/validate_mesh_shader_connections.py
+++ b/openpype/hosts/maya/plugins/publish/validate_mesh_shader_connections.py
@@ -12,28 +12,41 @@ def pairs(iterable):
         yield i, y
 
 
-def get_invalid_sets(shape):
-    """Get sets that are considered related but do not contain the shape.
+def get_invalid_sets(shapes):
+    """Return invalid sets for the given shapes.
 
-    In some scenarios Maya keeps connections to multiple shaders
-    even if just a single one is assigned on the full object.
+    This takes a list of shape nodes to cache the set members for overlapping
+    sets in the queries. This avoids many Maya set member queries.
 
-    These are related sets returned by `maya.cmds.listSets` that don't
-    actually have the shape as member.
+    Returns:
+        dict: Dictionary of shapes and their invalid sets, e.g.
+            {"pCubeShape": ["set1", "set2"]}
 
     """
 
-    invalid = []
-    sets = cmds.listSets(object=shape, t=1, extendToShape=False) or []
-    for s in sets:
-        members = cmds.sets(s, query=True, nodesOnly=True)
-        if not members:
-            invalid.append(s)
-            continue
+    cache = dict()
+    invalid = dict()
 
-        members = set(cmds.ls(members, long=True))
-        if shape not in members:
-            invalid.append(s)
+    # Collect the sets from the shape
+    for shape in shapes:
+        invalid_sets = []
+        sets = cmds.listSets(object=shape, t=1, extendToShape=False) or []
+        for set_ in sets:
+
+            members = cache.get(set_, None)
+            if members is None:
+                members = set(cmds.ls(cmds.sets(set_,
+                                                query=True,
+                                                nodesOnly=True), long=True))
+                cache[set_] = members
+
+            # If the shape is not actually present as a member of the set
+            # consider it invalid
+            if shape not in members:
+                invalid_sets.append(set_)
+
+        if invalid_sets:
+            invalid[shape] = invalid_sets
 
     return invalid
 
@@ -92,15 +105,9 @@ class ValidateMeshShaderConnections(pyblish.api.InstancePlugin):
     @staticmethod
     def get_invalid(instance):
 
-        shapes = cmds.ls(instance[:], dag=1, leaf=1, shapes=1, long=True)
-
-        # todo: allow to check anything that can have a shader
-        shapes = cmds.ls(shapes, noIntermediate=True, long=True, type="mesh")
-
-        invalid = []
-        for shape in shapes:
-            if get_invalid_sets(shape):
-                invalid.append(shape)
+        nodes = instance[:]
+        shapes = cmds.ls(nodes, noIntermediate=True, long=True, type="mesh")
+        invalid = get_invalid_sets(shapes).keys()
 
         return invalid
 
@@ -108,7 +115,7 @@ class ValidateMeshShaderConnections(pyblish.api.InstancePlugin):
     def repair(cls, instance):
 
         shapes = cls.get_invalid(instance)
-        for shape in shapes:
-            invalid_sets = get_invalid_sets(shape)
+        invalid = get_invalid_sets(shapes)
+        for shape, invalid_sets in invalid.items():
             for set_node in invalid_sets:
                 disconnect(shape, set_node)

From cbc6fb8b330abc88c0e8c64c57a966cd09fd8077 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 10 Jun 2022 20:54:12 +0200
Subject: [PATCH 0584/1227] Make `add_task_and_edit` method public

---
 openpype/tools/project_manager/project_manager/view.py   | 6 +++---
 openpype/tools/project_manager/project_manager/window.py | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/tools/project_manager/project_manager/view.py b/openpype/tools/project_manager/project_manager/view.py
index 74f5a06b71..f995d45f44 100644
--- a/openpype/tools/project_manager/project_manager/view.py
+++ b/openpype/tools/project_manager/project_manager/view.py
@@ -386,7 +386,7 @@ class HierarchyView(QtWidgets.QTreeView):
         self._source_model.delete_indexes(indexes)
 
     def _on_ctrl_shift_enter_pressed(self):
-        self._add_task_and_edit()
+        self.add_task_and_edit()
 
     def add_asset(self, parent_index=None):
         if parent_index is None:
@@ -428,9 +428,9 @@ class HierarchyView(QtWidgets.QTreeView):
         self.edit(new_index)
 
     def _add_task_action(self):
-        self._add_task_and_edit()
+        self.add_task_and_edit()
 
-    def _add_task_and_edit(self):
+    def add_task_and_edit(self):
         new_index = self.add_task()
         if new_index is None:
             return
diff --git a/openpype/tools/project_manager/project_manager/window.py b/openpype/tools/project_manager/project_manager/window.py
index 10b28f535f..ed3445174d 100644
--- a/openpype/tools/project_manager/project_manager/window.py
+++ b/openpype/tools/project_manager/project_manager/window.py
@@ -246,7 +246,7 @@ class ProjectManagerWindow(QtWidgets.QWidget):
 
     def _on_add_task(self):
         # Colorbleed edit: force the task to directly be in edit mode
-        self.hierarchy_view._add_task_and_edit()
+        self.hierarchy_view.add_task_and_edit()
 
     def _on_create_folders(self):
         project_name = self._current_project()

From 46e17b4816b6506c2b4aabe94ec15c2c1e71fb5d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 10 Jun 2022 20:54:33 +0200
Subject: [PATCH 0585/1227] Remove comment

---
 openpype/tools/project_manager/project_manager/window.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/tools/project_manager/project_manager/window.py b/openpype/tools/project_manager/project_manager/window.py
index ed3445174d..458a36ac39 100644
--- a/openpype/tools/project_manager/project_manager/window.py
+++ b/openpype/tools/project_manager/project_manager/window.py
@@ -245,7 +245,6 @@ class ProjectManagerWindow(QtWidgets.QWidget):
         self.hierarchy_view.add_asset()
 
     def _on_add_task(self):
-        # Colorbleed edit: force the task to directly be in edit mode
         self.hierarchy_view.add_task_and_edit()
 
     def _on_create_folders(self):

From 01bec693275472ef976ffd29df2048aba16f3cf0 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Sat, 11 Jun 2022 03:44:47 +0000
Subject: [PATCH 0586/1227] [Automated] Bump version

---
 CHANGELOG.md        | 44 +++++++++++++++++++-------------------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 21 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1d7798cb48..d0d25908cd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,23 +1,39 @@
 # Changelog
 
-## [3.11.0-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.11.0-nightly.2](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.10.0...HEAD)
 
 ### 📖 Documentation
 
+- Documentation: Add app key to template documentation [\#3299](https://github.com/pypeclub/OpenPype/pull/3299)
 - doc: adding royal render and multiverse to the web site [\#3285](https://github.com/pypeclub/OpenPype/pull/3285)
 
 **🚀 Enhancements**
 
+- updated poetry installation source [\#3316](https://github.com/pypeclub/OpenPype/pull/3316)
+- TVPaint: Extractor use mark in/out range to render [\#3309](https://github.com/pypeclub/OpenPype/pull/3309)
+- Ftrack: Delivery action can work on ReviewSessions [\#3307](https://github.com/pypeclub/OpenPype/pull/3307)
+- Maya: Look assigner UI improvements [\#3298](https://github.com/pypeclub/OpenPype/pull/3298)
+- Ftrack: Action to transfer values of hierarchical attributes [\#3284](https://github.com/pypeclub/OpenPype/pull/3284)
+- Maya: better handling of legacy review subsets names [\#3269](https://github.com/pypeclub/OpenPype/pull/3269)
 - General: Updated windows oiio tool [\#3268](https://github.com/pypeclub/OpenPype/pull/3268)
 - Unreal: add support for skeletalMesh and staticMesh to loaders [\#3267](https://github.com/pypeclub/OpenPype/pull/3267)
 - Maya: reference loaders could store placeholder in referenced url [\#3264](https://github.com/pypeclub/OpenPype/pull/3264)
 - TVPaint: Init file for TVPaint worker also handle guideline images [\#3250](https://github.com/pypeclub/OpenPype/pull/3250)
 - Nuke: Change default icon path in settings [\#3247](https://github.com/pypeclub/OpenPype/pull/3247)
+- Maya: publishing of animation and pointcache on a farm [\#3225](https://github.com/pypeclub/OpenPype/pull/3225)
+- Maya: Look assigner UI improvements [\#3208](https://github.com/pypeclub/OpenPype/pull/3208)
+- Nuke: add pointcache and animation to loader [\#3186](https://github.com/pypeclub/OpenPype/pull/3186)
 
 **🐛 Bug fixes**
 
+- Houdini: Fix Houdini VDB manage update wrong file attribute name [\#3322](https://github.com/pypeclub/OpenPype/pull/3322)
+- General: Vendorized modules for Python 2 and update poetry lock [\#3305](https://github.com/pypeclub/OpenPype/pull/3305)
+- Fix - added local targets to install host [\#3303](https://github.com/pypeclub/OpenPype/pull/3303)
+- Settings: Add missing default settings for nuke gizmo [\#3301](https://github.com/pypeclub/OpenPype/pull/3301)
+- Maya: Fix swaped width and height in reviews [\#3300](https://github.com/pypeclub/OpenPype/pull/3300)
+- Maya: point cache publish handles Maya instances [\#3297](https://github.com/pypeclub/OpenPype/pull/3297)
 - Global: extract review slate issues [\#3286](https://github.com/pypeclub/OpenPype/pull/3286)
 - Webpublisher: return only active projects in ProjectsEndpoint [\#3281](https://github.com/pypeclub/OpenPype/pull/3281)
 - Hiero: add support for task tags 3.10.x [\#3279](https://github.com/pypeclub/OpenPype/pull/3279)
@@ -30,24 +46,15 @@
 - Unreal: Fixed Render creation in UE5 [\#3239](https://github.com/pypeclub/OpenPype/pull/3239)
 - Unreal: Fixed Camera loading in UE5 [\#3238](https://github.com/pypeclub/OpenPype/pull/3238)
 - Flame: debugging [\#3224](https://github.com/pypeclub/OpenPype/pull/3224)
-- add silent audio to slate [\#3162](https://github.com/pypeclub/OpenPype/pull/3162)
 
 **Merged pull requests:**
 
-- Maya: better handling of legacy review subsets names [\#3269](https://github.com/pypeclub/OpenPype/pull/3269)
-- Deadline: publishing of animation and pointcache on a farm [\#3225](https://github.com/pypeclub/OpenPype/pull/3225)
-- Nuke: add pointcache and animation to loader [\#3186](https://github.com/pypeclub/OpenPype/pull/3186)
-- Add a gizmo menu to nuke [\#3172](https://github.com/pypeclub/OpenPype/pull/3172)
+- Maya: add pointcache family to gpu cache loader [\#3318](https://github.com/pypeclub/OpenPype/pull/3318)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.10.0-nightly.6...3.10.0)
 
-**🆕 New features**
-
-- General: OpenPype modules publish plugins are registered in host [\#3180](https://github.com/pypeclub/OpenPype/pull/3180)
-- General: Creator plugins from addons can be registered [\#3179](https://github.com/pypeclub/OpenPype/pull/3179)
-
 **🚀 Enhancements**
 
 - Maya: FBX camera export [\#3253](https://github.com/pypeclub/OpenPype/pull/3253)
@@ -55,10 +62,6 @@
 - Project Manager: Allow to paste Tasks into multiple assets at the same time [\#3226](https://github.com/pypeclub/OpenPype/pull/3226)
 - Project manager: Sped up project load [\#3216](https://github.com/pypeclub/OpenPype/pull/3216)
 - Loader UI: Speed issues of loader with sync server [\#3199](https://github.com/pypeclub/OpenPype/pull/3199)
-- Looks: add basic support for Renderman [\#3190](https://github.com/pypeclub/OpenPype/pull/3190)
-- Maya: added clean\_import option to Import loader [\#3181](https://github.com/pypeclub/OpenPype/pull/3181)
-- Add the scripts menu definition to nuke [\#3168](https://github.com/pypeclub/OpenPype/pull/3168)
-- Maya: add maya 2023 to default applications [\#3167](https://github.com/pypeclub/OpenPype/pull/3167)
 
 **🐛 Bug fixes**
 
@@ -76,12 +79,6 @@
 - Photoshop: skip collector when automatic testing [\#3202](https://github.com/pypeclub/OpenPype/pull/3202)
 - Nuke: render/workfile version sync doesn't work on farm [\#3185](https://github.com/pypeclub/OpenPype/pull/3185)
 - Ftrack: Review image only if there are no mp4 reviews [\#3183](https://github.com/pypeclub/OpenPype/pull/3183)
-- Ftrack: Locations deepcopy issue [\#3177](https://github.com/pypeclub/OpenPype/pull/3177)
-- General: Avoid creating multiple thumbnails [\#3176](https://github.com/pypeclub/OpenPype/pull/3176)
-- General/Hiero: better clip duration calculation [\#3169](https://github.com/pypeclub/OpenPype/pull/3169)
-- General: Oiio conversion for ffmpeg checks for invalid characters [\#3166](https://github.com/pypeclub/OpenPype/pull/3166)
-- Fix for attaching render to subset [\#3164](https://github.com/pypeclub/OpenPype/pull/3164)
-- Harmony: fixed missing task name in render instance [\#3163](https://github.com/pypeclub/OpenPype/pull/3163)
 
 **🔀 Refactored code**
 
@@ -92,7 +89,6 @@
 - Harmony: message length in 21.1 [\#3257](https://github.com/pypeclub/OpenPype/pull/3257)
 - Harmony: 21.1 fix [\#3249](https://github.com/pypeclub/OpenPype/pull/3249)
 - Maya: added jpg to filter for Image Plane Loader [\#3223](https://github.com/pypeclub/OpenPype/pull/3223)
-- Webpublisher: replace space by underscore in subset names [\#3160](https://github.com/pypeclub/OpenPype/pull/3160)
 
 ## [3.9.8](https://github.com/pypeclub/OpenPype/tree/3.9.8) (2022-05-19)
 
@@ -103,15 +99,13 @@
 - nuke: generate publishing nodes inside render group node  [\#3206](https://github.com/pypeclub/OpenPype/pull/3206)
 - Loader UI: Speed issues of loader with sync server [\#3200](https://github.com/pypeclub/OpenPype/pull/3200)
 - Backport of fix for attaching renders to subsets [\#3195](https://github.com/pypeclub/OpenPype/pull/3195)
+- Looks: add basic support for Renderman [\#3190](https://github.com/pypeclub/OpenPype/pull/3190)
 
 **🐛 Bug fixes**
 
 - Standalone Publisher: Always create new representation for thumbnail [\#3204](https://github.com/pypeclub/OpenPype/pull/3204)
 - Nuke: render/workfile version sync doesn't work on farm  [\#3184](https://github.com/pypeclub/OpenPype/pull/3184)
 - Ftrack: Review image only if there are no mp4 reviews [\#3182](https://github.com/pypeclub/OpenPype/pull/3182)
-- Ftrack: Locations deepcopy issue [\#3175](https://github.com/pypeclub/OpenPype/pull/3175)
-- General: Avoid creating multiple thumbnails [\#3174](https://github.com/pypeclub/OpenPype/pull/3174)
-- General: TemplateResult can be copied [\#3170](https://github.com/pypeclub/OpenPype/pull/3170)
 
 **Merged pull requests:**
 
diff --git a/openpype/version.py b/openpype/version.py
index 4c78a6e0a1..4b0a688cbf 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.11.0-nightly.1"
+__version__ = "3.11.0-nightly.2"
diff --git a/pyproject.toml b/pyproject.toml
index 63bd08d644..4289c74ebe 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.11.0-nightly.1" # OpenPype
+version = "3.11.0-nightly.2" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From df26ddd1ebd77282cf0202f7cd4830fd49016165 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?G=C3=A1bor=20Marinov?= <gabor.marinov@moonrock.eu>
Date: Sun, 12 Jun 2022 00:18:07 +0200
Subject: [PATCH 0587/1227] Fix Nuke model loader to load full geo hierarchy by
 default

---
 openpype/hosts/nuke/plugins/load/load_model.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/openpype/hosts/nuke/plugins/load/load_model.py b/openpype/hosts/nuke/plugins/load/load_model.py
index 2f54595cb0..37670d8d4e 100644
--- a/openpype/hosts/nuke/plugins/load/load_model.py
+++ b/openpype/hosts/nuke/plugins/load/load_model.py
@@ -60,6 +60,10 @@ class AlembicModelLoader(load.LoaderPlugin):
                 inpanel=False
             )
             model_node.forceValidate()
+
+            # workaround to load all geo nodes, not just top level ones
+            model_node.knob('scene_view').setAllItems(model_node.knob('scene_view').getAllItems(), True)
+
             model_node["frame_rate"].setValue(float(fps))
 
             # workaround because nuke's bug is not adding
@@ -142,6 +146,9 @@ class AlembicModelLoader(load.LoaderPlugin):
             model_node["frame_rate"].setValue(float(fps))
             model_node["file"].setValue(file)
 
+            # workaround to load all geo nodes, not just top level ones
+            model_node.knob('scene_view').setAllItems(model_node.knob('scene_view').getAllItems(), True)
+
             # workaround because nuke's bug is
             # not adding animation keys properly
             xpos = model_node.xpos()

From 41ad5e09007eba53e0e91579157f39e29b596587 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?G=C3=A1bor=20Marinov?= <gabor.marinov@moonrock.eu>
Date: Sun, 12 Jun 2022 01:04:38 +0200
Subject: [PATCH 0588/1227] PEP-8

---
 openpype/hosts/nuke/plugins/load/load_model.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/load/load_model.py b/openpype/hosts/nuke/plugins/load/load_model.py
index 37670d8d4e..74f0b9731b 100644
--- a/openpype/hosts/nuke/plugins/load/load_model.py
+++ b/openpype/hosts/nuke/plugins/load/load_model.py
@@ -62,7 +62,9 @@ class AlembicModelLoader(load.LoaderPlugin):
             model_node.forceValidate()
 
             # workaround to load all geo nodes, not just top level ones
-            model_node.knob('scene_view').setAllItems(model_node.knob('scene_view').getAllItems(), True)
+            model_node.knob("scene_view").setAllItems(
+                model_node.knob("scene_view").getAllItems(), True
+            )
 
             model_node["frame_rate"].setValue(float(fps))
 
@@ -147,7 +149,9 @@ class AlembicModelLoader(load.LoaderPlugin):
             model_node["file"].setValue(file)
 
             # workaround to load all geo nodes, not just top level ones
-            model_node.knob('scene_view').setAllItems(model_node.knob('scene_view').getAllItems(), True)
+            model_node.knob("scene_view").setAllItems(
+                model_node.knob("scene_view").getAllItems(), True
+            )
 
             # workaround because nuke's bug is
             # not adding animation keys properly

From 02f9b7729668d5dce9dfee1aebe8177771e67c78 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?G=C3=A1bor=20Marinov?= <gabor.marinov@moonrock.eu>
Date: Mon, 13 Jun 2022 10:37:43 +0200
Subject: [PATCH 0589/1227] More elegant solution, does not require preferences
 settings

---
 openpype/hosts/nuke/plugins/load/load_model.py | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/load/load_model.py b/openpype/hosts/nuke/plugins/load/load_model.py
index 74f0b9731b..44e8490d4c 100644
--- a/openpype/hosts/nuke/plugins/load/load_model.py
+++ b/openpype/hosts/nuke/plugins/load/load_model.py
@@ -61,10 +61,10 @@ class AlembicModelLoader(load.LoaderPlugin):
             )
             model_node.forceValidate()
 
-            # workaround to load all geo nodes, not just top level ones
-            model_node.knob("scene_view").setAllItems(
-                model_node.knob("scene_view").getAllItems(), True
-            )
+            # Ensure all items are imported and selected.
+            scene_view = model_node.knob('scene_view')
+            scene_view.setImportedItems(scene_view.getAllItems())
+            scene_view.setSelectedItems(scene_view.getAllItems())
 
             model_node["frame_rate"].setValue(float(fps))
 
@@ -148,10 +148,10 @@ class AlembicModelLoader(load.LoaderPlugin):
             model_node["frame_rate"].setValue(float(fps))
             model_node["file"].setValue(file)
 
-            # workaround to load all geo nodes, not just top level ones
-            model_node.knob("scene_view").setAllItems(
-                model_node.knob("scene_view").getAllItems(), True
-            )
+            # Ensure all items are imported and selected.
+            scene_view = model_node.knob('scene_view')
+            scene_view.setImportedItems(scene_view.getAllItems())
+            scene_view.setSelectedItems(scene_view.getAllItems())
 
             # workaround because nuke's bug is
             # not adding animation keys properly

From 238e3a03216f25141a02fe4637b44b6a09b4523f Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 13 Jun 2022 13:28:07 +0200
Subject: [PATCH 0590/1227] add run eventserver launcher to gitignore

---
 .gitignore | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.gitignore b/.gitignore
index 28cfb4b1e9..8b268b7f28 100644
--- a/.gitignore
+++ b/.gitignore
@@ -102,3 +102,5 @@ website/.docusaurus
 
 .poetry/
 .python-version
+
+tools/run_eventserver.ps1

From 6033304282e7dc4a276ff7558161b66cfff0c3cb Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 13 Jun 2022 13:29:18 +0200
Subject: [PATCH 0591/1227] making wider extension filter for run eventserver
 gitignore

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

diff --git a/.gitignore b/.gitignore
index 8b268b7f28..7eaef69873 100644
--- a/.gitignore
+++ b/.gitignore
@@ -103,4 +103,4 @@ website/.docusaurus
 .poetry/
 .python-version
 
-tools/run_eventserver.ps1
+tools/run_eventserver.*

From 0163eae3fa80c720a527b134c1030362c4843ae5 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 13 Jun 2022 14:50:26 +0200
Subject: [PATCH 0592/1227] Remove unused code and add sugestions

---
 .../shotgrid/hooks/post_shotgrid_changes.py   |  9 --------
 openpype/modules/shotgrid/lib/settings.py     | 23 -------------------
 .../publish/collect_shotgrid_entities.py      |  5 ++--
 3 files changed, 2 insertions(+), 35 deletions(-)
 delete mode 100644 openpype/modules/shotgrid/hooks/post_shotgrid_changes.py

diff --git a/openpype/modules/shotgrid/hooks/post_shotgrid_changes.py b/openpype/modules/shotgrid/hooks/post_shotgrid_changes.py
deleted file mode 100644
index e8369ad3cb..0000000000
--- a/openpype/modules/shotgrid/hooks/post_shotgrid_changes.py
+++ /dev/null
@@ -1,9 +0,0 @@
-from openpype.lib import PostLaunchHook
-
-
-class PostShotgridHook(PostLaunchHook):
-    order = None
-
-    def execute(self, *args, **kwargs):
-        print(args, kwargs)
-        pass
diff --git a/openpype/modules/shotgrid/lib/settings.py b/openpype/modules/shotgrid/lib/settings.py
index 4a772de5b7..924099f04b 100644
--- a/openpype/modules/shotgrid/lib/settings.py
+++ b/openpype/modules/shotgrid/lib/settings.py
@@ -1,24 +1,11 @@
-import os
-
-from pymongo import MongoClient
 from openpype.api import get_system_settings, get_project_settings
 from openpype.modules.shotgrid.lib.const import MODULE_NAME
-from openpype.modules.shotgrid.lib.tools import memoize
 
 
-def get_project_list():
-    mongo_url = os.getenv("OPENPYPE_MONGO")
-    client = MongoClient(mongo_url)
-    db = client['avalon']
-    return db.list_collection_names()
-
-
-@memoize
 def get_shotgrid_project_settings(project):
     return get_project_settings(project).get(MODULE_NAME, {})
 
 
-@memoize
 def get_shotgrid_settings():
     return get_system_settings().get("modules", {}).get(MODULE_NAME, {})
 
@@ -29,13 +16,3 @@ def get_shotgrid_servers():
 
 def get_leecher_backend_url():
     return get_shotgrid_settings().get("leecher_backend_url")
-
-
-def filter_projects_by_login():
-    return bool(get_shotgrid_settings().get("filter_projects_by_login", False))
-
-
-def get_shotgrid_event_mongo_info():
-    database_name = os.environ["OPENPYPE_DATABASE_NAME"]
-    collection_name = "shotgrid_events"
-    return database_name, collection_name
diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
index a770c1eb87..9880425a41 100644
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
@@ -1,7 +1,7 @@
 import os
 
 import pyblish.api
-from pymongo import MongoClient
+from openpype.lib.mongo import OpenPypeMongoConnection
 
 from openpype.modules.shotgrid.lib.settings import (
     get_shotgrid_project_settings,
@@ -63,8 +63,7 @@ class CollectShotgridEntities(pyblish.api.ContextPlugin):
 
 
 def _get_shotgrid_collection(project):
-    mongo_url = os.getenv("OPENPYPE_MONGO")
-    client = MongoClient(mongo_url)
+    client = OpenPypeMongoConnection.get_mongo_client()
     return client.get_database("shotgrid_openpype").get_collection(project)
 
 

From cef804aa1670b755b5c0072a9f0d5990f6fa92d3 Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Mon, 13 Jun 2022 15:37:47 +0200
Subject: [PATCH 0593/1227] added eventserver utoility script for linux/mac

---
 tools/run_ftrack_eventserver.sh | 99 +++++++++++++++++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 tools/run_ftrack_eventserver.sh

diff --git a/tools/run_ftrack_eventserver.sh b/tools/run_ftrack_eventserver.sh
new file mode 100644
index 0000000000..97daa14c2d
--- /dev/null
+++ b/tools/run_ftrack_eventserver.sh
@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+
+art () {
+  cat <<-EOF
+
+             . .   ..     .    ..
+        _oOOP3OPP3Op_. .
+     .PPpo~·   ··   ~2p.  ··  ····  ·  ·
+    ·Ppo · .pPO3Op.· · O:· · · ·
+   .3Pp · oP3'· 'P33· · 4 ··   ·  ·   · ·· ·  ·  ·
+  ·~OP    3PO·  .Op3    : · ··  _____  _____  _____
+  ·P3O  · oP3oP3O3P' · · ·   · /    /·/    /·/    /
+   O3:·   O3p~ ·       ·:· · ·/____/·/____/ /____/
+   'P ·   3p3·  oP3~· ·.P:· ·  · ··  ·   · ·· ·  ·  ·
+  · ':  · Po'  ·Opo'· .3O· .  o[ by Pype Club ]]]==- - - ·  ·
+    · '_ ..  ·    . _OP3··  ·  ·https://openpype.io·· ·
+         ~P3·OPPPO3OP~ · ··  ·
+           ·  ' '· ·  ·· · · · ··  ·
+
+EOF
+}
+
+# Colors for terminal
+
+RST='\033[0m'             # Text Reset
+
+# Regular Colors
+Black='\033[0;30m'        # Black
+Red='\033[0;31m'          # Red
+Green='\033[0;32m'        # Green
+Yellow='\033[0;33m'       # Yellow
+Blue='\033[0;34m'         # Blue
+Purple='\033[0;35m'       # Purple
+Cyan='\033[0;36m'         # Cyan
+White='\033[0;37m'        # White
+
+# Bold
+BBlack='\033[1;30m'       # Black
+BRed='\033[1;31m'         # Red
+BGreen='\033[1;32m'       # Green
+BYellow='\033[1;33m'      # Yellow
+BBlue='\033[1;34m'        # Blue
+BPurple='\033[1;35m'      # Purple
+BCyan='\033[1;36m'        # Cyan
+BWhite='\033[1;37m'       # White
+
+# Bold High Intensity
+BIBlack='\033[1;90m'      # Black
+BIRed='\033[1;91m'        # Red
+BIGreen='\033[1;92m'      # Green
+BIYellow='\033[1;93m'     # Yellow
+BIBlue='\033[1;94m'       # Blue
+BIPurple='\033[1;95m'     # Purple
+BICyan='\033[1;96m'       # Cyan
+BIWhite='\033[1;97m'      # White
+
+
+##############################################################################
+# Return absolute path
+# Globals:
+#   None
+# Arguments:
+#   Path to resolve
+# Returns:
+#   None
+###############################################################################
+realpath () {
+  echo $(cd $(dirname "$1"); pwd)/$(basename "$1")
+}
+
+# Main
+main () {
+  echo -e "${BGreen}"
+  art
+  echo -e "${RST}"
+
+  # Directories
+  openpype_root=$(realpath $(dirname $(dirname "${BASH_SOURCE[0]}")))
+
+  if [[ -z $POETRY_HOME ]]; then
+    export POETRY_HOME="$openpype_root/.poetry"
+  fi
+
+  echo -e "${BIGreen}>>>${RST} Reading Poetry ... \c"
+  if [ -f "$POETRY_HOME/bin/poetry" ]; then
+    echo -e "${BIGreen}OK${RST}"
+  else
+    echo -e "${BIYellow}NOT FOUND${RST}"
+    echo -e "${BIYellow}***${RST} We need to install Poetry and virtual env ..."
+    . "$openpype_root/tools/create_env.sh" || { echo -e "${BIRed}!!!${RST} Poetry installation failed"; return; }
+  fi
+
+  pushd "$openpype_root" > /dev/null || return > /dev/null
+
+  echo -e "${BIGreen}>>>${RST} Running Ftrack Eventserver ..."
+  "$POETRY_HOME/bin/poetry" run python $openpype_root/start.py eventserver
+}
+
+main

From 27b8f77855d45446af3b7b742a58d30c2143d32f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 16:06:21 +0200
Subject: [PATCH 0594/1227] fix scene inventory

---
 openpype/tools/sceneinventory/model.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/tools/sceneinventory/model.py b/openpype/tools/sceneinventory/model.py
index 117bdfcba1..0bb9c4a658 100644
--- a/openpype/tools/sceneinventory/model.py
+++ b/openpype/tools/sceneinventory/model.py
@@ -198,12 +198,12 @@ class InventoryModel(TreeModel):
         self.clear()
 
         if self._hierarchy_view and selected:
-
             if not hasattr(host.pipeline, "update_hierarchy"):
                 # If host doesn't support hierarchical containers, then
                 # cherry-pick only.
                 self.add_items((item for item in items
                                 if item["objectName"] in selected))
+                return
 
             # Update hierarchy info for all containers
             items_by_name = {item["objectName"]: item

From cd6c37ece91caf7af0d40882b1a41f23190ebb38 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 16:06:57 +0200
Subject: [PATCH 0595/1227] added remaining custom mongo calls

---
 openpype/client/entities.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 82caaee7c5..a56288c1e8 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -1034,6 +1034,8 @@ def get_thumbnail(project_name, thumbnail_id, fields=None):
 
 """
 ## Custom data storage:
+- Settings - OP settings overrides and local settings
+- Logging - logs from PypeLogger
 - Webpublisher - jobs
 - Ftrack - events
 - Maya - Shaders

From 9cb5372d69e30e35a441c952178bb1aa2802e5a7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 16:29:09 +0200
Subject: [PATCH 0596/1227] use client functions to query data in standalone
 publisher plugins

---
 .../publish/collect_bulk_mov_instances.py     | 11 +++---
 .../plugins/publish/collect_hierarchy.py      | 36 ++++++++++---------
 .../plugins/publish/collect_matching_asset.py |  5 +--
 .../publish/validate_task_existence.py        | 20 ++++-------
 4 files changed, 33 insertions(+), 39 deletions(-)

diff --git a/openpype/hosts/standalonepublisher/plugins/publish/collect_bulk_mov_instances.py b/openpype/hosts/standalonepublisher/plugins/publish/collect_bulk_mov_instances.py
index 3e7fb19c00..052a97af7d 100644
--- a/openpype/hosts/standalonepublisher/plugins/publish/collect_bulk_mov_instances.py
+++ b/openpype/hosts/standalonepublisher/plugins/publish/collect_bulk_mov_instances.py
@@ -3,7 +3,7 @@ import json
 import pyblish.api
 
 from openpype.lib import get_subset_name_with_asset_doc
-from openpype.pipeline import legacy_io
+from openpype.client import get_asset_by_name
 
 
 class CollectBulkMovInstances(pyblish.api.InstancePlugin):
@@ -24,12 +24,9 @@ class CollectBulkMovInstances(pyblish.api.InstancePlugin):
 
     def process(self, instance):
         context = instance.context
+        project_name = context.data["projectEntity"]["name"]
         asset_name = instance.data["asset"]
-
-        asset_doc = legacy_io.find_one({
-            "type": "asset",
-            "name": asset_name
-        })
+        asset_doc = get_asset_by_name(project_name, asset_name)
         if not asset_doc:
             raise AssertionError((
                 "Couldn't find Asset document with name \"{}\""
@@ -52,7 +49,7 @@ class CollectBulkMovInstances(pyblish.api.InstancePlugin):
             self.subset_name_variant,
             task_name,
             asset_doc,
-            legacy_io.Session["AVALON_PROJECT"]
+            project_name
         )
         instance_name = f"{asset_name}_{subset_name}"
 
diff --git a/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py b/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py
index 77163651c4..78e63f7ef0 100644
--- a/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py
+++ b/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py
@@ -3,7 +3,7 @@ import re
 from copy import deepcopy
 import pyblish.api
 
-from openpype.pipeline import legacy_io
+from openpype.client import get_asset_by_id, get_project
 
 
 class CollectHierarchyInstance(pyblish.api.ContextPlugin):
@@ -61,27 +61,32 @@ class CollectHierarchyInstance(pyblish.api.ContextPlugin):
             **instance.data["anatomyData"])
 
     def create_hierarchy(self, instance):
-        parents = list()
-        hierarchy = list()
-        visual_hierarchy = [instance.context.data["assetEntity"]]
+        asset_doc = instance.context.data["assetEntity"]
+        project_doc = instance.context.data["projectEntity"]
+        project_name = project_doc["name"]
+        visual_hierarchy = [asset_doc]
+        current_doc = asset_doc
         while True:
-            visual_parent = legacy_io.find_one(
-                {"_id": visual_hierarchy[-1]["data"]["visualParent"]}
-            )
-            if visual_parent:
-                visual_hierarchy.append(visual_parent)
-            else:
-                visual_hierarchy.append(
-                    instance.context.data["projectEntity"])
+            visual_parent_id = current_doc["data"]["visualParent"]
+            visual_parent = None
+            if visual_parent_id:
+                visual_parent = get_asset_by_id(project_name, visual_parent_id)
+
+            if not visual_parent:
+                visual_hierarchy.append(project_doc)
                 break
+            visual_hierarchy.append(visual_parent)
+            current_doc = visual_parent
 
         # add current selection context hierarchy from standalonepublisher
+        parents = list()
         for entity in reversed(visual_hierarchy):
             parents.append({
                 "entity_type": entity["data"]["entityType"],
                 "entity_name": entity["name"]
             })
 
+        hierarchy = list()
         if self.shot_add_hierarchy:
             parent_template_patern = re.compile(r"\{([a-z]*?)\}")
             # fill the parents parts from presets
@@ -129,9 +134,8 @@ class CollectHierarchyInstance(pyblish.api.ContextPlugin):
         self.log.debug(f"Hierarchy: {hierarchy}")
         self.log.debug(f"parents: {parents}")
 
+        tasks_to_add = dict()
         if self.shot_add_tasks:
-            tasks_to_add = dict()
-            project_doc = legacy_io.find_one({"type": "project"})
             project_tasks = project_doc["config"]["tasks"]
             for task_name, task_data in self.shot_add_tasks.items():
                 _task_data = deepcopy(task_data)
@@ -150,9 +154,7 @@ class CollectHierarchyInstance(pyblish.api.ContextPlugin):
                             task_name,
                             list(project_tasks.keys())))
 
-            instance.data["tasks"] = tasks_to_add
-        else:
-            instance.data["tasks"] = dict()
+        instance.data["tasks"] = tasks_to_add
 
         # updating hierarchy data
         instance.data["anatomyData"].update({
diff --git a/openpype/hosts/standalonepublisher/plugins/publish/collect_matching_asset.py b/openpype/hosts/standalonepublisher/plugins/publish/collect_matching_asset.py
index 9d94bfdc91..82d7247b2b 100644
--- a/openpype/hosts/standalonepublisher/plugins/publish/collect_matching_asset.py
+++ b/openpype/hosts/standalonepublisher/plugins/publish/collect_matching_asset.py
@@ -4,7 +4,7 @@ import collections
 import pyblish.api
 from pprint import pformat
 
-from openpype.pipeline import legacy_io
+from openpype.client import get_assets
 
 
 class CollectMatchingAssetToInstance(pyblish.api.InstancePlugin):
@@ -119,8 +119,9 @@ class CollectMatchingAssetToInstance(pyblish.api.InstancePlugin):
 
     def _asset_docs_by_parent_id(self, instance):
         # Query all assets for project and store them by parent's id to list
+        project_name = instance.context.data["projectEntity"]["name"]
         asset_docs_by_parent_id = collections.defaultdict(list)
-        for asset_doc in legacy_io.find({"type": "asset"}):
+        for asset_doc in get_assets(project_name):
             parent_id = asset_doc["data"]["visualParent"]
             asset_docs_by_parent_id[parent_id].append(asset_doc)
         return asset_docs_by_parent_id
diff --git a/openpype/hosts/standalonepublisher/plugins/publish/validate_task_existence.py b/openpype/hosts/standalonepublisher/plugins/publish/validate_task_existence.py
index 4c761c7a4c..19ea1a4778 100644
--- a/openpype/hosts/standalonepublisher/plugins/publish/validate_task_existence.py
+++ b/openpype/hosts/standalonepublisher/plugins/publish/validate_task_existence.py
@@ -1,9 +1,7 @@
 import pyblish.api
 
-from openpype.pipeline import (
-    PublishXmlValidationError,
-    legacy_io,
-)
+from openpype.client import get_assets
+from openpype.pipeline import PublishXmlValidationError
 
 
 class ValidateTaskExistence(pyblish.api.ContextPlugin):
@@ -20,15 +18,11 @@ class ValidateTaskExistence(pyblish.api.ContextPlugin):
         for instance in context:
             asset_names.add(instance.data["asset"])
 
-        asset_docs = legacy_io.find(
-            {
-                "type": "asset",
-                "name": {"$in": list(asset_names)}
-            },
-            {
-                "name": 1,
-                "data.tasks": 1
-            }
+        project_name = context.data["projectEntity"]["name"]
+        asset_docs = get_assets(
+            project_name,
+            asset_names=asset_names,
+            fields=["name", "data.tasks"]
         )
         tasks_by_asset_names = {}
         for asset_doc in asset_docs:

From c01f65a9176413a388248986950162d21428da91 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 17:02:34 +0200
Subject: [PATCH 0597/1227] removed unused import

---
 .../standalonepublisher/plugins/publish/collect_hierarchy.py    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py b/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py
index 78e63f7ef0..7922ca7f31 100644
--- a/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py
+++ b/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py
@@ -3,7 +3,7 @@ import re
 from copy import deepcopy
 import pyblish.api
 
-from openpype.client import get_asset_by_id, get_project
+from openpype.client import get_asset_by_id
 
 
 class CollectHierarchyInstance(pyblish.api.ContextPlugin):

From 010ee05eff630531a77964c7bfe39460cee9421c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 17:26:46 +0200
Subject: [PATCH 0598/1227] use query functions in blender

---
 openpype/hosts/blender/api/pipeline.py        |  7 ++--
 .../blender/plugins/publish/extract_layout.py | 39 +++++++------------
 2 files changed, 16 insertions(+), 30 deletions(-)

diff --git a/openpype/hosts/blender/api/pipeline.py b/openpype/hosts/blender/api/pipeline.py
index 5b81764644..93d81145bc 100644
--- a/openpype/hosts/blender/api/pipeline.py
+++ b/openpype/hosts/blender/api/pipeline.py
@@ -10,6 +10,7 @@ from . import ops
 
 import pyblish.api
 
+from openpype.client import get_asset_by_name
 from openpype.pipeline import (
     schema,
     legacy_io,
@@ -83,11 +84,9 @@ def uninstall():
 
 
 def set_start_end_frames():
+    project_name = legacy_io.active_project()
     asset_name = legacy_io.Session["AVALON_ASSET"]
-    asset_doc = legacy_io.find_one({
-        "type": "asset",
-        "name": asset_name
-    })
+    asset_doc = get_asset_by_name(project_name, asset_name)
 
     scene = bpy.context.scene
 
diff --git a/openpype/hosts/blender/plugins/publish/extract_layout.py b/openpype/hosts/blender/plugins/publish/extract_layout.py
index 8ecc78a2c6..2b3fa6a608 100644
--- a/openpype/hosts/blender/plugins/publish/extract_layout.py
+++ b/openpype/hosts/blender/plugins/publish/extract_layout.py
@@ -1,13 +1,11 @@
 import os
 import json
 
-from bson.objectid import ObjectId
-
 import bpy
 import bpy_extras
 import bpy_extras.anim_utils
 
-from openpype.pipeline import legacy_io
+from openpype.client import get_representation_by_name
 from openpype.hosts.blender.api import plugin
 from openpype.hosts.blender.api.pipeline import AVALON_PROPERTY
 import openpype.api
@@ -131,43 +129,32 @@ class ExtractLayout(openpype.api.Extractor):
 
         fbx_count = 0
 
+        project_name = instance.context["projectEntity"]["name"]
         for asset in asset_group.children:
             metadata = asset.get(AVALON_PROPERTY)
 
-            parent = metadata["parent"]
+            version_id = metadata["parent"]
             family = metadata["family"]
 
-            self.log.debug("Parent: {}".format(parent))
+            self.log.debug("Parent: {}".format(version_id))
             # Get blend reference
-            blend = legacy_io.find_one(
-                {
-                    "type": "representation",
-                    "parent": ObjectId(parent),
-                    "name": "blend"
-                },
-                projection={"_id": True})
+            blend = get_representation_by_name(
+                project_name, "blend", version_id, fields=["_id"]
+            )
             blend_id = None
             if blend:
                 blend_id = blend["_id"]
             # Get fbx reference
-            fbx = legacy_io.find_one(
-                {
-                    "type": "representation",
-                    "parent": ObjectId(parent),
-                    "name": "fbx"
-                },
-                projection={"_id": True})
+            fbx = get_representation_by_name(
+                project_name, "fbx", version_id, fields=["_id"]
+            )
             fbx_id = None
             if fbx:
                 fbx_id = fbx["_id"]
             # Get abc reference
-            abc = legacy_io.find_one(
-                {
-                    "type": "representation",
-                    "parent": ObjectId(parent),
-                    "name": "abc"
-                },
-                projection={"_id": True})
+            abc = get_representation_by_name(
+                project_name, "abc", version_id, fields=["_id"]
+            )
             abc_id = None
             if abc:
                 abc_id = abc["_id"]

From 7c7c1486a401f2b260f013bf3c9dce0b3f123575 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 18:15:28 +0200
Subject: [PATCH 0599/1227] use own rest api endpoint instead of using private
 from avalon

---
 .../webserver_service/webpublish_routes.py    | 28 +++++++++++++------
 1 file changed, 19 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
index 70324fc39c..fcf9f10ffe 100644
--- a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
+++ b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
@@ -17,14 +17,24 @@ from openpype.lib.remote_publish import (
     REPROCESS_STATUS
 )
 from openpype.pipeline import AvalonMongoDB
-from openpype_modules.avalon_apps.rest_api import _RestApiEndpoint
 from openpype.settings import get_project_settings
+from openpype_modules.webserver.base_routes import RestApiEndpoint
 
 
 
 log = PypeLogger.get_logger("WebServer")
 
 
+class ResourceRestApiEndpoint(RestApiEndpoint):
+    def __init__(self, resource):
+        self.resource = resource
+        super(ResourceRestApiEndpoint, self).__init__()
+
+    @property
+    def dbcon(self):
+        return self.resource.dbcon
+
+
 class RestApiResource:
     """Resource carrying needed info and Avalon DB connection for publish."""
     def __init__(self, server_manager, executable, upload_dir,
@@ -67,7 +77,7 @@ class OpenPypeRestApiResource(RestApiResource):
         self.dbcon = mongo_client[database_name]["webpublishes"]
 
 
-class ProjectsEndpoint(_RestApiEndpoint):
+class ProjectsEndpoint(ResourceRestApiEndpoint):
     """Returns list of dict with project info (id, name)."""
     async def get(self) -> Response:
         output = []
@@ -84,7 +94,7 @@ class ProjectsEndpoint(_RestApiEndpoint):
         )
 
 
-class HiearchyEndpoint(_RestApiEndpoint):
+class HiearchyEndpoint(ResourceRestApiEndpoint):
     """Returns dictionary with context tree from assets."""
     async def get(self, project_name) -> Response:
         query_projection = {
@@ -183,7 +193,7 @@ class TaskNode(Node):
         self["attributes"] = {}
 
 
-class BatchPublishEndpoint(_RestApiEndpoint):
+class BatchPublishEndpoint(ResourceRestApiEndpoint):
     """Triggers headless publishing of batch."""
     async def post(self, request) -> Response:
         # Validate existence of openpype executable
@@ -288,7 +298,7 @@ class BatchPublishEndpoint(_RestApiEndpoint):
         )
 
 
-class TaskPublishEndpoint(_RestApiEndpoint):
+class TaskPublishEndpoint(ResourceRestApiEndpoint):
     """Prepared endpoint triggered after each task - for future development."""
     async def post(self, request) -> Response:
         return Response(
@@ -298,7 +308,7 @@ class TaskPublishEndpoint(_RestApiEndpoint):
         )
 
 
-class BatchStatusEndpoint(_RestApiEndpoint):
+class BatchStatusEndpoint(ResourceRestApiEndpoint):
     """Returns dict with info for batch_id."""
     async def get(self, batch_id) -> Response:
         output = self.dbcon.find_one({"batch_id": batch_id})
@@ -318,7 +328,7 @@ class BatchStatusEndpoint(_RestApiEndpoint):
         )
 
 
-class UserReportEndpoint(_RestApiEndpoint):
+class UserReportEndpoint(ResourceRestApiEndpoint):
     """Returns list of dict with batch info for user (email address)."""
     async def get(self, user) -> Response:
         output = list(self.dbcon.find({"user": user},
@@ -338,7 +348,7 @@ class UserReportEndpoint(_RestApiEndpoint):
         )
 
 
-class ConfiguredExtensionsEndpoint(_RestApiEndpoint):
+class ConfiguredExtensionsEndpoint(ResourceRestApiEndpoint):
     """Returns dict of extensions which have mapping to family.
 
         Returns:
@@ -378,7 +388,7 @@ class ConfiguredExtensionsEndpoint(_RestApiEndpoint):
         )
 
 
-class BatchReprocessEndpoint(_RestApiEndpoint):
+class BatchReprocessEndpoint(ResourceRestApiEndpoint):
     """Marks latest 'batch_id' for reprocessing, returns 404 if not found."""
     async def post(self, batch_id) -> Response:
         batches = self.dbcon.find({"batch_id": batch_id,

From 00c3554a5c1be7c07f48e6d018e275e2defd714f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 18:18:16 +0200
Subject: [PATCH 0600/1227] renamed 'OpenPypeRestApiResource' to
 'WebpublishRestApiResource'

---
 .../webserver_service/webpublish_routes.py        |  9 ++++-----
 .../webserver_service/webserver_cli.py            | 15 +++++++--------
 2 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
index fcf9f10ffe..d4aca1a797 100644
--- a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
+++ b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
@@ -20,9 +20,7 @@ from openpype.pipeline import AvalonMongoDB
 from openpype.settings import get_project_settings
 from openpype_modules.webserver.base_routes import RestApiEndpoint
 
-
-
-log = PypeLogger.get_logger("WebServer")
+log = PypeLogger.get_logger("WebpublishRoutes")
 
 
 class ResourceRestApiEndpoint(RestApiEndpoint):
@@ -69,9 +67,10 @@ class RestApiResource:
         ).encode("utf-8")
 
 
-class OpenPypeRestApiResource(RestApiResource):
+class WebpublishRestApiResource:
     """Resource carrying OP DB connection for storing batch info into DB."""
-    def __init__(self, ):
+
+    def __init__(self):
         mongo_client = OpenPypeMongoConnection.get_mongo_client()
         database_name = os.environ["OPENPYPE_DATABASE_NAME"]
         self.dbcon = mongo_client[database_name]["webpublishes"]
diff --git a/openpype/hosts/webpublisher/webserver_service/webserver_cli.py b/openpype/hosts/webpublisher/webserver_service/webserver_cli.py
index 909ea38bc6..f18aac1168 100644
--- a/openpype/hosts/webpublisher/webserver_service/webserver_cli.py
+++ b/openpype/hosts/webpublisher/webserver_service/webserver_cli.py
@@ -10,7 +10,7 @@ from openpype.lib import PypeLogger
 
 from .webpublish_routes import (
     RestApiResource,
-    OpenPypeRestApiResource,
+    WebpublishRestApiResource,
     HiearchyEndpoint,
     ProjectsEndpoint,
     ConfiguredExtensionsEndpoint,
@@ -27,7 +27,7 @@ from openpype.lib.remote_publish import (
 )
 
 
-log = PypeLogger().get_logger("webserver_gui")
+log = PypeLogger.get_logger("webserver_gui")
 
 
 def run_webserver(*args, **kwargs):
@@ -86,27 +86,26 @@ def run_webserver(*args, **kwargs):
     )
 
     # reporting
-    openpype_resource = OpenPypeRestApiResource()
-    batch_status_endpoint = BatchStatusEndpoint(openpype_resource)
+    webpublish_resource = WebpublishRestApiResource()
+    batch_status_endpoint = BatchStatusEndpoint(webpublish_resource)
     server_manager.add_route(
         "GET",
         "/api/batch_status/{batch_id}",
         batch_status_endpoint.dispatch
     )
 
-    user_status_endpoint = UserReportEndpoint(openpype_resource)
+    user_status_endpoint = UserReportEndpoint(webpublish_resource)
     server_manager.add_route(
         "GET",
         "/api/publishes/{user}",
         user_status_endpoint.dispatch
     )
 
-    webpublisher_batch_reprocess_endpoint = \
-        BatchReprocessEndpoint(openpype_resource)
+    batch_reprocess_endpoint = BatchReprocessEndpoint(webpublish_resource)
     server_manager.add_route(
         "POST",
         "/api/webpublish/reprocess/{batch_id}",
-        webpublisher_batch_reprocess_endpoint.dispatch
+        batch_reprocess_endpoint.dispatch
     )
 
     server_manager.start_server()

From 444b8aa67347121b44762120768fa6b84249eb3d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 18:19:35 +0200
Subject: [PATCH 0601/1227] use query functions from client

---
 .../webserver_service/webpublish_routes.py        | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
index d4aca1a797..cfbb0939b5 100644
--- a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
+++ b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
@@ -2,11 +2,15 @@
 import os
 import json
 import datetime
-from bson.objectid import ObjectId
 import collections
-from aiohttp.web_response import Response
 import subprocess
+from bson.objectid import ObjectId
+from aiohttp.web_response import Response
 
+from openpype.client import (
+    get_projects,
+    get_assets,
+)
 from openpype.lib import (
     OpenPypeMongoConnection,
     PypeLogger,
@@ -80,7 +84,7 @@ class ProjectsEndpoint(ResourceRestApiEndpoint):
     """Returns list of dict with project info (id, name)."""
     async def get(self) -> Response:
         output = []
-        for project_doc in self.dbcon.projects():
+        for project_doc in get_projects():
             ret_val = {
                 "id": project_doc["_id"],
                 "name": project_doc["name"]
@@ -105,10 +109,7 @@ class HiearchyEndpoint(ResourceRestApiEndpoint):
             "type": 1,
         }
 
-        asset_docs = self.dbcon.database[project_name].find(
-            {"type": "asset"},
-            query_projection
-        )
+        asset_docs = get_assets(project_name, field=query_projection.keys())
         asset_docs_by_id = {
             asset_doc["_id"]: asset_doc
             for asset_doc in asset_docs

From 840f1a431490f0dea02b8e5f9990cc8f5451e1f3 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 18:20:15 +0200
Subject: [PATCH 0602/1227] separated endpoints to those with dbcon and without

---
 .../webserver_service/webpublish_routes.py    | 36 ++++++++++++-------
 .../webserver_service/webserver_cli.py        |  6 ++--
 2 files changed, 25 insertions(+), 17 deletions(-)

diff --git a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
index cfbb0939b5..b1041bf6cb 100644
--- a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
+++ b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
@@ -20,7 +20,6 @@ from openpype.lib.remote_publish import (
     ERROR_STATUS,
     REPROCESS_STATUS
 )
-from openpype.pipeline import AvalonMongoDB
 from openpype.settings import get_project_settings
 from openpype_modules.webserver.base_routes import RestApiEndpoint
 
@@ -32,6 +31,8 @@ class ResourceRestApiEndpoint(RestApiEndpoint):
         self.resource = resource
         super(ResourceRestApiEndpoint, self).__init__()
 
+
+class WebpublishApiEndpoint(ResourceRestApiEndpoint):
     @property
     def dbcon(self):
         return self.resource.dbcon
@@ -49,9 +50,6 @@ class RestApiResource:
             studio_task_queue = collections.deque().dequeu
         self.studio_task_queue = studio_task_queue
 
-        self.dbcon = AvalonMongoDB()
-        self.dbcon.install()
-
     @staticmethod
     def json_dump_handler(value):
         if isinstance(value, datetime.datetime):
@@ -193,7 +191,7 @@ class TaskNode(Node):
         self["attributes"] = {}
 
 
-class BatchPublishEndpoint(ResourceRestApiEndpoint):
+class BatchPublishEndpoint(WebpublishApiEndpoint):
     """Triggers headless publishing of batch."""
     async def post(self, request) -> Response:
         # Validate existence of openpype executable
@@ -298,7 +296,7 @@ class BatchPublishEndpoint(ResourceRestApiEndpoint):
         )
 
 
-class TaskPublishEndpoint(ResourceRestApiEndpoint):
+class TaskPublishEndpoint(WebpublishApiEndpoint):
     """Prepared endpoint triggered after each task - for future development."""
     async def post(self, request) -> Response:
         return Response(
@@ -308,8 +306,12 @@ class TaskPublishEndpoint(ResourceRestApiEndpoint):
         )
 
 
-class BatchStatusEndpoint(ResourceRestApiEndpoint):
-    """Returns dict with info for batch_id."""
+class BatchStatusEndpoint(WebpublishApiEndpoint):
+    """Returns dict with info for batch_id.
+
+    Uses 'WebpublishRestApiResource'.
+    """
+
     async def get(self, batch_id) -> Response:
         output = self.dbcon.find_one({"batch_id": batch_id})
 
@@ -328,8 +330,12 @@ class BatchStatusEndpoint(ResourceRestApiEndpoint):
         )
 
 
-class UserReportEndpoint(ResourceRestApiEndpoint):
-    """Returns list of dict with batch info for user (email address)."""
+class UserReportEndpoint(WebpublishApiEndpoint):
+    """Returns list of dict with batch info for user (email address).
+
+    Uses 'WebpublishRestApiResource'.
+    """
+
     async def get(self, user) -> Response:
         output = list(self.dbcon.find({"user": user},
                                       projection={"log": False}))
@@ -348,7 +354,7 @@ class UserReportEndpoint(ResourceRestApiEndpoint):
         )
 
 
-class ConfiguredExtensionsEndpoint(ResourceRestApiEndpoint):
+class ConfiguredExtensionsEndpoint(WebpublishApiEndpoint):
     """Returns dict of extensions which have mapping to family.
 
         Returns:
@@ -388,8 +394,12 @@ class ConfiguredExtensionsEndpoint(ResourceRestApiEndpoint):
         )
 
 
-class BatchReprocessEndpoint(ResourceRestApiEndpoint):
-    """Marks latest 'batch_id' for reprocessing, returns 404 if not found."""
+class BatchReprocessEndpoint(WebpublishApiEndpoint):
+    """Marks latest 'batch_id' for reprocessing, returns 404 if not found.
+
+    Uses 'WebpublishRestApiResource'.
+    """
+
     async def post(self, batch_id) -> Response:
         batches = self.dbcon.find({"batch_id": batch_id,
                                    "status": ERROR_STATUS}).sort("_id", -1)
diff --git a/openpype/hosts/webpublisher/webserver_service/webserver_cli.py b/openpype/hosts/webpublisher/webserver_service/webserver_cli.py
index f18aac1168..1ed8f22b2c 100644
--- a/openpype/hosts/webpublisher/webserver_service/webserver_cli.py
+++ b/openpype/hosts/webpublisher/webserver_service/webserver_cli.py
@@ -69,16 +69,14 @@ def run_webserver(*args, **kwargs):
     )
 
     # triggers publish
-    webpublisher_task_publish_endpoint = \
-        BatchPublishEndpoint(resource)
+    webpublisher_task_publish_endpoint = BatchPublishEndpoint(resource)
     server_manager.add_route(
         "POST",
         "/api/webpublish/batch",
         webpublisher_task_publish_endpoint.dispatch
     )
 
-    webpublisher_batch_publish_endpoint = \
-        TaskPublishEndpoint(resource)
+    webpublisher_batch_publish_endpoint = TaskPublishEndpoint(resource)
     server_manager.add_route(
         "POST",
         "/api/webpublish/task",

From d9bde0c3c47012ae3a8ddf090822089344109708 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 18:38:43 +0200
Subject: [PATCH 0603/1227] implemented base classes for host implementation

---
 openpype/host/__init__.py |  13 ++
 openpype/host/host.py     | 308 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 321 insertions(+)
 create mode 100644 openpype/host/__init__.py
 create mode 100644 openpype/host/host.py

diff --git a/openpype/host/__init__.py b/openpype/host/__init__.py
new file mode 100644
index 0000000000..fcc9372a99
--- /dev/null
+++ b/openpype/host/__init__.py
@@ -0,0 +1,13 @@
+from .host import (
+    HostImplementation,
+    IWorkfileHost,
+    ILoadHost,
+    INewPublisher,
+)
+
+__all__ = (
+    "HostImplementation",
+    "IWorkfileHost",
+    "ILoadHost",
+    "INewPublisher",
+)
diff --git a/openpype/host/host.py b/openpype/host/host.py
new file mode 100644
index 0000000000..d311f752cd
--- /dev/null
+++ b/openpype/host/host.py
@@ -0,0 +1,308 @@
+from abc import ABCMeta, abstractproperty, abstractmethod
+import six
+
+
+@six.add_metaclass(ABCMeta)
+class HostImplementation(object):
+    """Base of host implementation class.
+
+    Host is pipeline implementation of DCC application. This class should help
+    to identify what must/should/can be implemented for specific functionality.
+
+    Compared to 'avalon' concept:
+    What was before considered as functions in host implementation folder. The
+    host implementation should primarily care about adding ability of creation
+    (mark subsets to be published) and optionaly about referencing published
+    representations as containers.
+
+    Host may need extend some functionality like working with workfiles
+    or loading. Not all host implementations may allow that for those purposes
+    can be logic extended with implementing functions for the purpose. There
+    are prepared interfaces to be able identify what must be implemented to
+    be able use that functionality.
+    - current statement is that it is not required to inherit from interfaces
+        but all of the methods are validated (only their existence!)
+
+    # Installation of host before (avalon concept):
+    ```python
+    from openpype.pipeline import install_host
+    import openpype.hosts.maya.api as host
+
+    install_host(host)
+    ```
+
+    # Installation of host now:
+    ```python
+    from openpype.pipeline import install_host
+    from openpype.hosts.maya.api import MayaHost
+
+    host = MayaHost()
+    install_host(host)
+    ```
+
+    # TODOs
+    - move content of 'install_host' as method of this class
+        - register host object
+        - install legacy_io
+        - install global plugin paths
+    - store registered plugin paths to this object
+    - handle current context (project, asset, task)
+        - this must be done in many separated steps
+    - have it's object of host tools instead of using globals
+
+    This implementation will probably change over time when more
+        functionality and responsibility will be added.
+    """
+
+    def __init__(self):
+        """Initialization of host.
+
+        Register DCC callbacks, host specific plugin paths, targets etc.
+        (Part of what 'install' did in 'avalon' concept.)
+
+        NOTE:
+            At this moment global "installation" must happen before host
+            installation. Because of this current limitation it is recommended
+            to implement 'install' method which is triggered after global
+            'install'.
+        """
+
+        pass
+
+    @abstractproperty
+    def name(self):
+        """Host implementation name."""
+
+        pass
+
+    def get_current_context(self):
+        """Get current context information.
+
+        This method should be used to get current context of host. Usage of
+        this method can be crutial for host implementations in DCCs where
+        can be opened multiple workfiles at one moment and change of context
+        can't be catched properly.
+
+        Default implementation returns values from 'legacy_io.Session'.
+
+        Returns:
+            dict: Context with 3 keys 'project_name', 'asset_name' and
+                'task_name'. All of them can be 'None'.
+        """
+
+        from openpype.pipeline import legacy_io
+
+        if legacy_io.is_installed():
+            legacy_io.install()
+
+        return {
+            "project_name": legacy_io.Session["AVALON_PROJECT"],
+            "asset_name": legacy_io.Session["AVALON_ASSET"],
+            "task_name": legacy_io.Session["AVALON_TASK"]
+        }
+
+    def get_context_title(self):
+        """Context title shown for UI purposes.
+
+        Should return current context title if possible.
+
+        NOTE: This method is used only for UI purposes so it is possible to
+            return some logical title for contextless cases.
+
+        Is not meant for "Context menu" label.
+
+        Returns:
+            str: Context title.
+            None: Default title is used based on UI implementation.
+        """
+
+        # Use current context to fill the context title
+        current_context = self.get_current_context()
+        project_name = current_context["project_name"]
+        asset_name = current_context["asset_name"]
+        task_name = current_context["task_name"]
+        items = []
+        if project_name:
+            items.append(project_name)
+            if asset_name:
+                items.append(asset_name)
+                if task_name:
+                    items.append(task_name)
+        if items:
+            return "/".join(items)
+        return None
+
+
+class ILoadHost:
+    """Implementation requirements to be able use reference of representations.
+
+    The load plugins can do referencing even without implementation of methods
+    here, but switch and removement of containers would not be possible.
+
+    QUESTIONS
+    - Is list container dependency of host or load plugins?
+    - Should this be directly in HostImplementation?
+        - how to find out if referencing is available?
+        - do we need to know that?
+    """
+
+    @abstractmethod
+    def ls(self):
+        """Retreive referenced containers from scene.
+
+        This can be implemented in hosts where referencing can be used.
+
+        TODO:
+            Rename function to something more self explanatory.
+                Suggestion: 'get_referenced_containers'
+
+        Returns:
+            list[dict]: Information about loaded containers.
+        """
+        return []
+
+
+@six.add_metaclass(ABCMeta)
+class IWorkfileHost:
+    """Implementation requirements to be able use workfile utils and tool.
+
+    This interface just provides what is needed to implement in host
+    implementation to support workfiles workflow, but does not have necessarily
+    to inherit from this interface.
+    """
+
+    @abstractmethod
+    def file_extensions(self):
+        """Extensions that can be used as save.
+
+        QUESTION: This could potentially use 'HostDefinition'.
+
+        TODO:
+            Rename to 'get_workfile_extensions'.
+        """
+
+        return []
+
+    @abstractmethod
+    def save_file(self, dst_path=None):
+        """Save currently opened scene.
+
+        TODO:
+            Rename to 'save_current_workfile'.
+
+        Args:
+            dst_path (str): Where the current scene should be saved. Or use
+                current path if 'None' is passed.
+        """
+
+        pass
+
+    @abstractmethod
+    def open_file(self, filepath):
+        """Open passed filepath in the host.
+
+        TODO:
+            Rename to 'open_workfile'.
+
+        Args:
+            filepath (str): Path to workfile.
+        """
+
+        pass
+
+    @abstractmethod
+    def current_file(self):
+        """Retreive path to current opened file.
+
+        TODO:
+            Rename to 'get_current_workfile'.
+
+        Returns:
+            str: Path to file which is currently opened.
+            None: If nothing is opened.
+        """
+
+        return None
+
+    def has_unsaved_changes(self):
+        """Currently opened scene is saved.
+
+        Not all hosts can know if current scene is saved because the API of
+        DCC does not support it.
+
+        Returns:
+            bool: True if scene is saved and False if has unsaved
+                modifications.
+            None: Can't tell if workfiles has modifications.
+        """
+
+        return None
+
+    def work_root(self, session):
+        """Modify workdir per host.
+
+        WARNING:
+        We must handle this modification with more sofisticated way because
+        this can't be called out of DCC so opening of last workfile
+        (calculated before DCC is launched) is complicated. Also breaking
+        defined work template is not a good idea.
+        Only place where it's really used and can make sense is Maya. There
+        workspace.mel can modify subfolders where to look for maya files.
+
+        Default implementation keeps workdir untouched.
+
+        Args:
+            session (dict): Session context data.
+
+        Returns:
+            str: Path to new workdir.
+        """
+
+        return session["AVALON_WORKDIR"]
+
+
+class INewPublisher:
+    """Functions related to new creation system in new publisher.
+
+    New publisher is not storing information only about each created instance
+    but also some global data. At this moment are data related only to context
+    publish plugins but that can extend in future.
+
+    HostImplementation does not have to inherit from this interface just have
+    to imlement mentioned all listed methods.
+    """
+
+    @abstractmethod
+    def get_context_data(self):
+        """Get global data related to creation-publishing from workfile.
+
+        These data are not related to any created instance but to whole
+        publishing context. Not saving/returning them will cause that each
+        reset of publishing resets all values to default ones.
+
+        Context data can contain information about enabled/disabled publish
+        plugins or other values that can be filled by artist.
+
+        Returns:
+            dict: Context data stored using 'update_context_data'.
+        """
+
+        pass
+
+    @abstractmethod
+    def update_context_data(self, data, changes):
+        """Store global context data to workfile.
+
+        Called when some values in context data has changed.
+
+        Without storing the values in a way that 'get_context_data' would
+        return them will each reset of publishing cause loose of filled values
+        by artist. Best practice is to store values into workfile, if possible.
+
+        Args:
+            data (dict): New data as are.
+            changes (dict): Only data that has been changed. Each value has
+                tuple with '(<old>, <new>)' value.
+        """
+
+        pass

From 626e6f9b7d734b072d99b0820c18e58a2880a8fe Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 18:39:41 +0200
Subject: [PATCH 0604/1227] moved import of settings to top

---
 openpype/hosts/maya/api/pipeline.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index d9276ddf4a..5905251e93 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -8,6 +8,7 @@ import maya.api.OpenMaya as om
 
 import pyblish.api
 
+from openpype.settings import get_project_settings
 import openpype.hosts.maya
 from openpype.tools.utils import host_tools
 from openpype.lib import (
@@ -46,8 +47,6 @@ self._events = {}
 
 
 def install():
-    from openpype.settings import get_project_settings
-
     project_settings = get_project_settings(os.getenv("AVALON_PROJECT"))
     # process path mapping
     dirmap_processor = MayaDirmap("maya", project_settings)

From 7f106cad33602b125be17220f2124050c546350e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 18:51:30 +0200
Subject: [PATCH 0605/1227] added maintained_selection to HostImplementation

---
 openpype/host/host.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/openpype/host/host.py b/openpype/host/host.py
index d311f752cd..4851ee59bf 100644
--- a/openpype/host/host.py
+++ b/openpype/host/host.py
@@ -1,3 +1,4 @@
+import contextlib
 from abc import ABCMeta, abstractproperty, abstractmethod
 import six
 
@@ -132,6 +133,19 @@ class HostImplementation(object):
             return "/".join(items)
         return None
 
+    @contextlib.contextmanager
+    def maintained_selection(self):
+        """Some functionlity will happen but selection should stay same.
+
+        This is DCC specific. Some may not allow to implement this ability
+        that is reason why default implementation is empty context manager.
+        """
+
+        try:
+            yield
+        finally:
+            pass
+
 
 class ILoadHost:
     """Implementation requirements to be able use reference of representations.

From 7ac1b6cadc60fab4d32207f6e5fd640f1d492cc8 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 19:18:01 +0200
Subject: [PATCH 0606/1227] added logger to HostImplementation

---
 openpype/host/host.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/openpype/host/host.py b/openpype/host/host.py
index 4851ee59bf..27b22e4850 100644
--- a/openpype/host/host.py
+++ b/openpype/host/host.py
@@ -1,3 +1,4 @@
+import logging
 import contextlib
 from abc import ABCMeta, abstractproperty, abstractmethod
 import six
@@ -55,6 +56,8 @@ class HostImplementation(object):
         functionality and responsibility will be added.
     """
 
+    _log = None
+
     def __init__(self):
         """Initialization of host.
 
@@ -70,6 +73,12 @@ class HostImplementation(object):
 
         pass
 
+    @property
+    def log(self):
+        if self._log is None:
+            self._log = logging.getLogger(self.__class__.__name__)
+        return self._log
+
     @abstractproperty
     def name(self):
         """Host implementation name."""

From 0ff8e2bcc686f1dbae795450d9635e0be7c3475d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 19:30:39 +0200
Subject: [PATCH 0607/1227] added validation methods to interfaces

---
 openpype/host/host.py | 112 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 112 insertions(+)

diff --git a/openpype/host/host.py b/openpype/host/host.py
index 27b22e4850..302c181598 100644
--- a/openpype/host/host.py
+++ b/openpype/host/host.py
@@ -4,6 +4,17 @@ from abc import ABCMeta, abstractproperty, abstractmethod
 import six
 
 
+class MissingMethodsError(ValueError):
+    def __init__(self, host, missing_methods):
+        joined_missing = ", ".join(
+            ['"{}"'.format(item) for item in missing_methods]
+        )
+        message = (
+            "Host \"{}\" miss methods {}".format(host.name, joined_missing)
+        )
+        super(MissingMethodsError, self).__init__(message)
+
+
 @six.add_metaclass(ABCMeta)
 class HostImplementation(object):
     """Base of host implementation class.
@@ -169,6 +180,36 @@ class ILoadHost:
         - do we need to know that?
     """
 
+    @staticmethod
+    def get_missing_load_methods(host):
+        """Look for missing methods on host implementation.
+
+        Method is used for validation of implemented functions related to
+        loading. Checks only existence of methods.
+
+        Args:
+            list[str]: Missing method implementations for loading workflow.
+        """
+
+        required = ["ls"]
+        missing = []
+        for name in required:
+            if not hasattr(host, name):
+                missing.append(name)
+        return missing
+
+    @staticmethod
+    def validate_load_methods(host):
+        """Validate implemented methods of host for load workflow.
+
+        Raises:
+            MissingMethodsError: If there are missing methods on host
+                implementation.
+        """
+        missing = ILoadHost.get_missing_load_methods(host)
+        if missing:
+            raise MissingMethodsError(host, missing)
+
     @abstractmethod
     def ls(self):
         """Retreive referenced containers from scene.
@@ -194,6 +235,43 @@ class IWorkfileHost:
     to inherit from this interface.
     """
 
+    @staticmethod
+    def get_missing_workfile_methods(host):
+        """Look for missing methods on host implementation.
+
+        Method is used for validation of implemented functions related to
+        workfiles. Checks only existence of methods.
+
+        Returns:
+            list[str]: Missing method implementations for workfiles workflow.
+        """
+
+        required = [
+            "open_file",
+            "save_file",
+            "current_file",
+            "has_unsaved_changes",
+            "file_extensions",
+            "work_root",
+        ]
+        missing = []
+        for name in required:
+            if not hasattr(host, name):
+                missing.append(name)
+        return missing
+
+    @staticmethod
+    def validate_workfile_methods(host):
+        """Validate implemented methods of host for workfiles workflow.
+
+        Raises:
+            MissingMethodsError: If there are missing methods on host
+                implementation.
+        """
+        missing = IWorkfileHost.get_missing_workfile_methods(host)
+        if missing:
+            raise MissingMethodsError(host, missing)
+
     @abstractmethod
     def file_extensions(self):
         """Extensions that can be used as save.
@@ -295,6 +373,40 @@ class INewPublisher:
     to imlement mentioned all listed methods.
     """
 
+    @staticmethod
+    def get_missing_publish_methods(host):
+        """Look for missing methods on host implementation.
+
+        Method is used for validation of implemented functions related to
+        new publish creation. Checks only existence of methods.
+
+        Args:
+            list[str]: Missing method implementations for new publsher
+                workflow.
+        """
+
+        required = [
+            "get_context_data",
+            "update_context_data",
+        ]
+        missing = []
+        for name in required:
+            if not hasattr(host, name):
+                missing.append(name)
+        return missing
+
+    @staticmethod
+    def validate_publish_methods(host):
+        """Validate implemented methods of host for create-publish workflow.
+
+        Raises:
+            MissingMethodsError: If there are missing methods on host
+                implementation.
+        """
+        missing = INewPublisher.get_missing_publish_methods(host)
+        if missing:
+            raise MissingMethodsError(host, missing)
+
     @abstractmethod
     def get_context_data(self):
         """Get global data related to creation-publishing from workfile.

From b81dbf9ee411a2a02d46da9f144c78eca4ddcf21 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 19:31:37 +0200
Subject: [PATCH 0608/1227] use validations from interfaces

---
 openpype/pipeline/create/context.py  | 15 +++++----------
 openpype/tools/utils/host_tools.py   | 15 ++++++++++-----
 openpype/tools/workfiles/__init__.py |  2 --
 openpype/tools/workfiles/app.py      | 28 ++--------------------------
 4 files changed, 17 insertions(+), 43 deletions(-)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index 2f1922c103..4bfa68c9d4 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -6,6 +6,7 @@ import inspect
 from uuid import uuid4
 from contextlib import contextmanager
 
+from openpype.host import INewPublisher
 from openpype.pipeline import legacy_io
 from openpype.pipeline.mongodb import (
     AvalonMongoDB,
@@ -651,12 +652,6 @@ class CreateContext:
         discover_publish_plugins(bool): Discover publish plugins during reset
             phase.
     """
-    # Methods required in host implementaion to be able create instances
-    #   or change context data.
-    required_methods = (
-        "get_context_data",
-        "update_context_data"
-    )
 
     def __init__(
         self, host, dbcon=None, headless=False, reset=True,
@@ -738,10 +733,10 @@ class CreateContext:
         Args:
             host(ModuleType): Host implementaion.
         """
-        missing = set()
-        for attr_name in cls.required_methods:
-            if not hasattr(host, attr_name):
-                missing.add(attr_name)
+
+        missing = set(
+            INewPublisher.get_missing_publish_methods(host)
+        )
         return missing
 
     @property
diff --git a/openpype/tools/utils/host_tools.py b/openpype/tools/utils/host_tools.py
index 9dbbe25fda..ae23e4d089 100644
--- a/openpype/tools/utils/host_tools.py
+++ b/openpype/tools/utils/host_tools.py
@@ -6,7 +6,7 @@ use singleton approach with global functions (using helper anyway).
 import os
 
 import pyblish.api
-
+from openpype.host import IWorkfileHost, ILoadHost
 from openpype.pipeline import (
     registered_host,
     legacy_io,
@@ -49,12 +49,11 @@ class HostToolsHelper:
     def get_workfiles_tool(self, parent):
         """Create, cache and return workfiles tool window."""
         if self._workfiles_tool is None:
-            from openpype.tools.workfiles.app import (
-                Window, validate_host_requirements
-            )
+            from openpype.tools.workfiles.app import Window
+
             # Host validation
             host = registered_host()
-            validate_host_requirements(host)
+            IWorkfileHost.validate_workfile_methods(host)
 
             workfiles_window = Window(parent=parent)
             self._workfiles_tool = workfiles_window
@@ -92,6 +91,9 @@ class HostToolsHelper:
         if self._loader_tool is None:
             from openpype.tools.loader import LoaderWindow
 
+            host = registered_host()
+            ILoadHost.validate_load_methods(host)
+
             loader_window = LoaderWindow(parent=parent or self._parent)
             self._loader_tool = loader_window
 
@@ -164,6 +166,9 @@ class HostToolsHelper:
         if self._scene_inventory_tool is None:
             from openpype.tools.sceneinventory import SceneInventoryWindow
 
+            host = registered_host()
+            ILoadHost.validate_load_methods(host)
+
             scene_inventory_window = SceneInventoryWindow(
                 parent=parent or self._parent
             )
diff --git a/openpype/tools/workfiles/__init__.py b/openpype/tools/workfiles/__init__.py
index 5fbc71797d..205fd44838 100644
--- a/openpype/tools/workfiles/__init__.py
+++ b/openpype/tools/workfiles/__init__.py
@@ -1,12 +1,10 @@
 from .window import Window
 from .app import (
     show,
-    validate_host_requirements,
 )
 
 __all__ = [
     "Window",
 
     "show",
-    "validate_host_requirements",
 ]
diff --git a/openpype/tools/workfiles/app.py b/openpype/tools/workfiles/app.py
index 352847ede8..2d0d551faf 100644
--- a/openpype/tools/workfiles/app.py
+++ b/openpype/tools/workfiles/app.py
@@ -1,6 +1,7 @@
 import sys
 import logging
 
+from openpype.host import IWorkfileHost
 from openpype.pipeline import (
     registered_host,
     legacy_io,
@@ -14,31 +15,6 @@ module = sys.modules[__name__]
 module.window = None
 
 
-def validate_host_requirements(host):
-    if host is None:
-        raise RuntimeError("No registered host.")
-
-    # Verify the host has implemented the api for Work Files
-    required = [
-        "open_file",
-        "save_file",
-        "current_file",
-        "has_unsaved_changes",
-        "work_root",
-        "file_extensions",
-    ]
-    missing = []
-    for name in required:
-        if not hasattr(host, name):
-            missing.append(name)
-    if missing:
-        raise RuntimeError(
-            "Host is missing required Work Files interfaces: "
-            "%s (host: %s)" % (", ".join(missing), host)
-        )
-    return True
-
-
 def show(root=None, debug=False, parent=None, use_context=True, save=True):
     """Show Work Files GUI"""
     # todo: remove `root` argument to show()
@@ -50,7 +26,7 @@ def show(root=None, debug=False, parent=None, use_context=True, save=True):
         pass
 
     host = registered_host()
-    validate_host_requirements(host)
+    IWorkfileHost.validate_workfile_methods(host)
 
     if debug:
         legacy_io.Session["AVALON_ASSET"] = "Mock"

From 3aa88814a1f6efbfb0d92ed6119c44e122b2fef4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 19:31:52 +0200
Subject: [PATCH 0609/1227] added is_installed function to legacy_io

---
 openpype/pipeline/legacy_io.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/openpype/pipeline/legacy_io.py b/openpype/pipeline/legacy_io.py
index c8e7e79600..d586756671 100644
--- a/openpype/pipeline/legacy_io.py
+++ b/openpype/pipeline/legacy_io.py
@@ -18,9 +18,13 @@ _database = database = None
 log = logging.getLogger(__name__)
 
 
+def is_installed():
+    return module._is_installed
+
+
 def install():
     """Establish a persistent connection to the database"""
-    if module._is_installed:
+    if is_installed():
         return
 
     session = session_data_from_environment(context_keys=True)
@@ -55,7 +59,7 @@ def uninstall():
 def requires_install(func):
     @functools.wraps(func)
     def decorated(*args, **kwargs):
-        if not module._is_installed:
+        if not is_installed():
             install()
         return func(*args, **kwargs)
     return decorated

From 97e6aa4120b24df7738c1635bcfeb14f1136663d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 13 Jun 2022 19:32:31 +0200
Subject: [PATCH 0610/1227] use HostImplementation class in Maya host

---
 openpype/hosts/maya/api/__init__.py      |   4 +-
 openpype/hosts/maya/api/pipeline.py      | 186 ++++++++++++++---------
 openpype/hosts/maya/startup/userSetup.py |   5 +-
 3 files changed, 120 insertions(+), 75 deletions(-)

diff --git a/openpype/hosts/maya/api/__init__.py b/openpype/hosts/maya/api/__init__.py
index 5d76bf0f04..6c28c59580 100644
--- a/openpype/hosts/maya/api/__init__.py
+++ b/openpype/hosts/maya/api/__init__.py
@@ -5,11 +5,11 @@ Anything that isn't defined here is INTERNAL and unreliable for external use.
 """
 
 from .pipeline import (
-    install,
     uninstall,
 
     ls,
     containerise,
+    MayaHostImplementation,
 )
 from .plugin import (
     Creator,
@@ -40,11 +40,11 @@ from .lib import (
 
 
 __all__ = [
-    "install",
     "uninstall",
 
     "ls",
     "containerise",
+    "MayaHostImplementation",
 
     "Creator",
     "Loader",
diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index 5905251e93..4924185f0a 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -1,7 +1,7 @@
 import os
-import sys
 import errno
 import logging
+import contextlib
 
 from maya import utils, cmds, OpenMaya
 import maya.api.OpenMaya as om
@@ -9,6 +9,7 @@ import maya.api.OpenMaya as om
 import pyblish.api
 
 from openpype.settings import get_project_settings
+from openpype.host import HostImplementation
 import openpype.hosts.maya
 from openpype.tools.utils import host_tools
 from openpype.lib import (
@@ -29,6 +30,14 @@ from openpype.pipeline import (
 )
 from openpype.hosts.maya.lib import copy_workspace_mel
 from . import menu, lib
+from .workio import (
+    open_file,
+    save_file,
+    file_extensions,
+    has_unsaved_changes,
+    work_root,
+    current_file
+)
 
 log = logging.getLogger("openpype.hosts.maya")
 
@@ -41,47 +50,121 @@ INVENTORY_PATH = os.path.join(PLUGINS_DIR, "inventory")
 
 AVALON_CONTAINERS = ":AVALON_CONTAINERS"
 
-self = sys.modules[__name__]
-self._ignore_lock = False
-self._events = {}
 
+class MayaHostImplementation(HostImplementation):
+    name = "maya"
 
-def install():
-    project_settings = get_project_settings(os.getenv("AVALON_PROJECT"))
-    # process path mapping
-    dirmap_processor = MayaDirmap("maya", project_settings)
-    dirmap_processor.process_dirmap()
+    def __init__(self):
+        super(MayaHostImplementation, self).__init__()
+        self._events = {}
 
-    pyblish.api.register_plugin_path(PUBLISH_PATH)
-    pyblish.api.register_host("mayabatch")
-    pyblish.api.register_host("mayapy")
-    pyblish.api.register_host("maya")
+    def install(self):
+        project_settings = get_project_settings(os.getenv("AVALON_PROJECT"))
+        # process path mapping
+        dirmap_processor = MayaDirmap("maya", project_settings)
+        dirmap_processor.process_dirmap()
 
-    register_loader_plugin_path(LOAD_PATH)
-    register_creator_plugin_path(CREATE_PATH)
-    register_inventory_action_path(INVENTORY_PATH)
-    log.info(PUBLISH_PATH)
+        pyblish.api.register_plugin_path(PUBLISH_PATH)
+        pyblish.api.register_host("mayabatch")
+        pyblish.api.register_host("mayapy")
+        pyblish.api.register_host("maya")
 
-    log.info("Installing callbacks ... ")
-    register_event_callback("init", on_init)
+        register_loader_plugin_path(LOAD_PATH)
+        register_creator_plugin_path(CREATE_PATH)
+        register_inventory_action_path(INVENTORY_PATH)
+        self.log.info(PUBLISH_PATH)
 
-    if lib.IS_HEADLESS:
-        log.info(("Running in headless mode, skipping Maya "
-                 "save/open/new callback installation.."))
+        self.log.info("Installing callbacks ... ")
+        register_event_callback("init", on_init)
 
-        return
+        if lib.IS_HEADLESS:
+            self.log.info((
+                "Running in headless mode, skipping Maya save/open/new"
+                " callback installation.."
+            ))
 
-    _set_project()
-    _register_callbacks()
+            return
 
-    menu.install()
+        _set_project()
+        self._register_callbacks()
 
-    register_event_callback("save", on_save)
-    register_event_callback("open", on_open)
-    register_event_callback("new", on_new)
-    register_event_callback("before.save", on_before_save)
-    register_event_callback("taskChanged", on_task_changed)
-    register_event_callback("workfile.save.before", before_workfile_save)
+        menu.install()
+
+        register_event_callback("save", on_save)
+        register_event_callback("open", on_open)
+        register_event_callback("new", on_new)
+        register_event_callback("before.save", on_before_save)
+        register_event_callback("taskChanged", on_task_changed)
+        register_event_callback("workfile.save.before", before_workfile_save)
+
+    def open_file(self, filepath):
+        return open_file(filepath)
+
+    def save_file(self, filepath=None):
+        return save_file(filepath)
+
+    def work_root(self, session):
+        return work_root(session)
+
+    def current_file(self):
+        return current_file()
+
+    def has_unsaved_changes(self):
+        return has_unsaved_changes()
+
+    def file_extensions(self):
+        return file_extensions()
+
+    def ls(self):
+        return ls()
+
+    @contextlib.contextmanager
+    def maintained_selection(self):
+        with lib.maintained_selection():
+            yield
+
+    def _register_callbacks(self):
+        for handler, event in self._events.copy().items():
+            if event is None:
+                continue
+
+            try:
+                OpenMaya.MMessage.removeCallback(event)
+                self._events[handler] = None
+            except RuntimeError as exc:
+                self.log.info(exc)
+
+        self._events[_on_scene_save] = OpenMaya.MSceneMessage.addCallback(
+            OpenMaya.MSceneMessage.kBeforeSave, _on_scene_save
+        )
+
+        self._events[_before_scene_save] = (
+            OpenMaya.MSceneMessage.addCheckCallback(
+                OpenMaya.MSceneMessage.kBeforeSaveCheck,
+                _before_scene_save
+            )
+        )
+
+        self._events[_on_scene_new] = OpenMaya.MSceneMessage.addCallback(
+            OpenMaya.MSceneMessage.kAfterNew, _on_scene_new
+        )
+
+        self._events[_on_maya_initialized] = (
+            OpenMaya.MSceneMessage.addCallback(
+                OpenMaya.MSceneMessage.kMayaInitialized,
+                _on_maya_initialized
+            )
+        )
+
+        self._events[_on_scene_open] = OpenMaya.MSceneMessage.addCallback(
+            OpenMaya.MSceneMessage.kAfterOpen, _on_scene_open
+        )
+
+        self.log.info("Installed event handler _on_scene_save..")
+        self.log.info("Installed event handler _before_scene_save..")
+        self.log.info("Installed event handler _on_scene_new..")
+        self.log.info("Installed event handler _on_maya_initialized..")
+        self.log.info("Installed event handler _on_scene_open..")
 
 
 def _set_project():
@@ -105,44 +188,6 @@ def _set_project():
     cmds.workspace(workdir, openWorkspace=True)
 
 
-def _register_callbacks():
-    for handler, event in self._events.copy().items():
-        if event is None:
-            continue
-
-        try:
-            OpenMaya.MMessage.removeCallback(event)
-            self._events[handler] = None
-        except RuntimeError as e:
-            log.info(e)
-
-    self._events[_on_scene_save] = OpenMaya.MSceneMessage.addCallback(
-        OpenMaya.MSceneMessage.kBeforeSave, _on_scene_save
-    )
-
-    self._events[_before_scene_save] = OpenMaya.MSceneMessage.addCheckCallback(
-        OpenMaya.MSceneMessage.kBeforeSaveCheck, _before_scene_save
-    )
-
-    self._events[_on_scene_new] = OpenMaya.MSceneMessage.addCallback(
-        OpenMaya.MSceneMessage.kAfterNew, _on_scene_new
-    )
-
-    self._events[_on_maya_initialized] = OpenMaya.MSceneMessage.addCallback(
-        OpenMaya.MSceneMessage.kMayaInitialized, _on_maya_initialized
-    )
-
-    self._events[_on_scene_open] = OpenMaya.MSceneMessage.addCallback(
-        OpenMaya.MSceneMessage.kAfterOpen, _on_scene_open
-    )
-
-    log.info("Installed event handler _on_scene_save..")
-    log.info("Installed event handler _before_scene_save..")
-    log.info("Installed event handler _on_scene_new..")
-    log.info("Installed event handler _on_maya_initialized..")
-    log.info("Installed event handler _on_scene_open..")
-
-
 def _on_maya_initialized(*args):
     emit_event("init")
 
@@ -474,7 +519,6 @@ def on_task_changed():
     workdir = legacy_io.Session["AVALON_WORKDIR"]
     if os.path.exists(workdir):
         log.info("Updating Maya workspace for task change to %s", workdir)
-
         _set_project()
 
         # Set Maya fileDialog's start-dir to /scenes
diff --git a/openpype/hosts/maya/startup/userSetup.py b/openpype/hosts/maya/startup/userSetup.py
index a3ab483add..daaf305612 100644
--- a/openpype/hosts/maya/startup/userSetup.py
+++ b/openpype/hosts/maya/startup/userSetup.py
@@ -1,10 +1,11 @@
 import os
 from openpype.api import get_project_settings
 from openpype.pipeline import install_host
-from openpype.hosts.maya import api
+from openpype.hosts.maya.api import MayaHostImplementation
 from maya import cmds
 
-install_host(api)
+host = MayaHostImplementation()
+install_host(host)
 
 
 print("starting OpenPype usersetup")

From df16589120736417862139467ed647c7e8286f11 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 11:07:18 +0200
Subject: [PATCH 0611/1227] added interfaces to inheritance

---
 openpype/hosts/maya/api/pipeline.py | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index 4924185f0a..f68bed9338 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -9,7 +9,7 @@ import maya.api.OpenMaya as om
 import pyblish.api
 
 from openpype.settings import get_project_settings
-from openpype.host import HostImplementation
+from openpype.host import HostImplementation, IWorkfileHost, ILoadHost
 import openpype.hosts.maya
 from openpype.tools.utils import host_tools
 from openpype.lib import (
@@ -51,12 +51,12 @@ INVENTORY_PATH = os.path.join(PLUGINS_DIR, "inventory")
 AVALON_CONTAINERS = ":AVALON_CONTAINERS"
 
 
-class MayaHostImplementation(HostImplementation):
+class MayaHostImplementation(HostImplementation, IWorkfileHost, ILoadHost):
     name = "maya"
 
     def __init__(self):
         super(MayaHostImplementation, self).__init__()
-        self._events = {}
+        self._op_events = {}
 
     def install(self):
         project_settings = get_project_settings(os.getenv("AVALON_PROJECT"))
@@ -124,39 +124,39 @@ class MayaHostImplementation(HostImplementation):
             yield
 
     def _register_callbacks(self):
-        for handler, event in self._events.copy().items():
+        for handler, event in self._op_events.copy().items():
             if event is None:
                 continue
 
             try:
                 OpenMaya.MMessage.removeCallback(event)
-                self._events[handler] = None
+                self._op_events[handler] = None
             except RuntimeError as exc:
                 self.log.info(exc)
 
-        self._events[_on_scene_save] = OpenMaya.MSceneMessage.addCallback(
+        self._op_events[_on_scene_save] = OpenMaya.MSceneMessage.addCallback(
             OpenMaya.MSceneMessage.kBeforeSave, _on_scene_save
         )
 
-        self._events[_before_scene_save] = (
+        self._op_events[_before_scene_save] = (
             OpenMaya.MSceneMessage.addCheckCallback(
                 OpenMaya.MSceneMessage.kBeforeSaveCheck,
                 _before_scene_save
             )
         )
 
-        self._events[_on_scene_new] = OpenMaya.MSceneMessage.addCallback(
+        self._op_events[_on_scene_new] = OpenMaya.MSceneMessage.addCallback(
             OpenMaya.MSceneMessage.kAfterNew, _on_scene_new
         )
 
-        self._events[_on_maya_initialized] = (
+        self._op_events[_on_maya_initialized] = (
             OpenMaya.MSceneMessage.addCallback(
                 OpenMaya.MSceneMessage.kMayaInitialized,
                 _on_maya_initialized
             )
         )
 
-        self._events[_on_scene_open] = OpenMaya.MSceneMessage.addCallback(
+        self._op_events[_on_scene_open] = OpenMaya.MSceneMessage.addCallback(
             OpenMaya.MSceneMessage.kAfterOpen, _on_scene_open
         )
 

From c177b60221aac07ecc304db832c8f2199c691d9f Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 14 Jun 2022 11:11:51 +0200
Subject: [PATCH 0612/1227] Fix - added OPENPYPE_MONGO to filter

Submit job has filter of allowed environment values, it missed OPENPYPE_MONGO.
---
 .../modules/deadline/plugins/publish/submit_publish_job.py     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 78ab935e42..39a2aa2761 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -128,7 +128,8 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
         "OPENPYPE_LOG_NO_COLORS",
         "OPENPYPE_USERNAME",
         "OPENPYPE_RENDER_JOB",
-        "OPENPYPE_PUBLISH_JOB"
+        "OPENPYPE_PUBLISH_JOB",
+        "OPENPYPE_MONGO"
     ]
 
     # custom deadline attributes

From fae33600f60555edab8d6187e4754eb946b1e8f4 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 14 Jun 2022 11:14:06 +0200
Subject: [PATCH 0613/1227] Nuke: adding empty representations to every
 instance

also clearing obsolete code
---
 .../plugins/publish/precollect_instances.py   |  8 ++---
 .../plugins/publish/precollect_workfile.py    | 36 ++++++++-----------
 2 files changed, 16 insertions(+), 28 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/precollect_instances.py b/openpype/hosts/nuke/plugins/publish/precollect_instances.py
index 1a8fa3e6ad..8bf7280cea 100644
--- a/openpype/hosts/nuke/plugins/publish/precollect_instances.py
+++ b/openpype/hosts/nuke/plugins/publish/precollect_instances.py
@@ -151,15 +151,11 @@ class PreCollectNukeInstances(pyblish.api.ContextPlugin):
                 "resolutionWidth": resolution_width,
                 "resolutionHeight": resolution_height,
                 "pixelAspect": pixel_aspect,
-                "review": review
+                "review": review,
+                "representations": []
 
             })
             self.log.info("collected instance: {}".format(instance.data))
             instances.append(instance)
 
-        # create instances in context data if not are created yet
-        if not context.data.get("instances"):
-            context.data["instances"] = list()
-
-        context.data["instances"].extend(instances)
         self.log.debug("context: {}".format(context))
diff --git a/openpype/hosts/nuke/plugins/publish/precollect_workfile.py b/openpype/hosts/nuke/plugins/publish/precollect_workfile.py
index a2d1c80628..7349a8f424 100644
--- a/openpype/hosts/nuke/plugins/publish/precollect_workfile.py
+++ b/openpype/hosts/nuke/plugins/publish/precollect_workfile.py
@@ -17,7 +17,7 @@ class CollectWorkfile(pyblish.api.ContextPlugin):
     label = "Pre-collect Workfile"
     hosts = ['nuke']
 
-    def process(self, context):
+    def process(self, context):  # sourcery skip: avoid-builtin-shadow
         root = nuke.root()
 
         current_file = os.path.normpath(nuke.root().name())
@@ -74,20 +74,6 @@ class CollectWorkfile(pyblish.api.ContextPlugin):
         }
         context.data.update(script_data)
 
-        # creating instance data
-        instance.data.update({
-            "subset": subset,
-            "label": base_name,
-            "name": base_name,
-            "publish": root.knob('publish').value(),
-            "family": family,
-            "families": [family],
-            "representations": list()
-        })
-
-        # adding basic script data
-        instance.data.update(script_data)
-
         # creating representation
         representation = {
             'name': 'nk',
@@ -96,12 +82,18 @@ class CollectWorkfile(pyblish.api.ContextPlugin):
             "stagingDir": staging_dir,
         }
 
-        instance.data["representations"].append(representation)
+        # creating instance data
+        instance.data.update({
+            "subset": subset,
+            "label": base_name,
+            "name": base_name,
+            "publish": root.knob('publish').value(),
+            "family": family,
+            "families": [family],
+            "representations": [representation]
+        })
+
+        # adding basic script data
+        instance.data.update(script_data)
 
         self.log.info('Publishing script version')
-
-        # create instances in context data if not are created yet
-        if not context.data.get("instances"):
-            context.data["instances"] = list()
-
-        context.data["instances"].append(instance)

From 6e2802cf9280fb00562b8adf25c7114a937783e4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 12:28:56 +0200
Subject: [PATCH 0614/1227] fix project entity access

---
 openpype/hosts/blender/plugins/publish/extract_layout.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/blender/plugins/publish/extract_layout.py b/openpype/hosts/blender/plugins/publish/extract_layout.py
index 2b3fa6a608..75d9cf440d 100644
--- a/openpype/hosts/blender/plugins/publish/extract_layout.py
+++ b/openpype/hosts/blender/plugins/publish/extract_layout.py
@@ -129,7 +129,7 @@ class ExtractLayout(openpype.api.Extractor):
 
         fbx_count = 0
 
-        project_name = instance.context["projectEntity"]["name"]
+        project_name = instance.context.data["projectEntity"]["name"]
         for asset in asset_group.children:
             metadata = asset.get(AVALON_PROPERTY)
 

From 73fb899e905efa2f7cfe9a54dcf8f4ccd06e6d61 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Tue, 14 Jun 2022 13:46:45 +0200
Subject: [PATCH 0615/1227] :construction: wip on validation of parent
 relationships

---
 .../publish/validate_camera_contents.py       | 22 ++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_camera_contents.py b/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
index 38cf65f006..eb93245f93 100644
--- a/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
+++ b/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
@@ -33,7 +33,7 @@ class ValidateCameraContents(pyblish.api.InstancePlugin):
         invalid = []
         cameras = cmds.ls(shapes, type='camera', long=True)
         if len(cameras) != 1:
-            cls.log.warning("Camera instance must have a single camera. "
+            cls.log.error("Camera instance must have a single camera. "
                             "Found {0}: {1}".format(len(cameras), cameras))
             invalid.extend(cameras)
 
@@ -51,16 +51,32 @@ class ValidateCameraContents(pyblish.api.InstancePlugin):
                 raise RuntimeError("No cameras found in empty instance.")
 
         if not cls.validate_shapes:
-            return
+            cls.log.info("not validating shapes in the content")
+
+            for member in members:
+                parents = cmds.ls(member, long=True)[0].split("|")[1:-1]
+                cls.log.info(parents)
+                parents_long_named = [
+                    "|".join(parents[:i]) for i in range(1, 1 + len(parents))
+                ]
+                cls.log.info(parents_long_named)
+                if cameras[0] in parents_long_named:
+                    cls.log.error(
+                        "{} is parented under camera {}".format(member, cameras[0]))
+                    invalid.extend(member)
+            return invalid
+
         # non-camera shapes
         valid_shapes = cmds.ls(shapes, type=('camera', 'locator'), long=True)
         shapes = set(shapes) - set(valid_shapes)
         if shapes:
             shapes = list(shapes)
-            cls.log.warning("Camera instance should only contain camera "
+            cls.log.error("Camera instance should only contain camera "
                             "shapes. Found: {0}".format(shapes))
             invalid.extend(shapes)
 
+
+
         invalid = list(set(invalid))
 
         return invalid

From d4e78369f019a8ebc46dd3702d8efc676d4f4473 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 14:03:12 +0200
Subject: [PATCH 0616/1227] added new function to retrieve only archived assets

---
 openpype/client/__init__.py |  2 +
 openpype/client/entities.py | 83 +++++++++++++++++++++++++++++++++++--
 2 files changed, 82 insertions(+), 3 deletions(-)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index 16b1dcf321..e3b4ef5132 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -5,6 +5,7 @@ from .entities import (
     get_asset_by_id,
     get_asset_by_name,
     get_assets,
+    get_archived_assets,
     get_asset_ids_with_subsets,
 
     get_subset_by_id,
@@ -41,6 +42,7 @@ __all__ = (
     "get_asset_by_id",
     "get_asset_by_name",
     "get_assets",
+    "get_archived_assets",
     "get_asset_ids_with_subsets",
 
     "get_subset_by_id",
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index a56288c1e8..0827e12288 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -135,8 +135,16 @@ def get_asset_by_name(project_name, asset_name, fields=None):
     return conn.find_one(query_filter, _prepare_fields(fields))
 
 
-def get_assets(
-    project_name, asset_ids=None, asset_names=None, archived=False, fields=None
+# NOTE this could be just public function?
+# - any better variable name instead of 'standard'?
+# - same approach can be used for rest of types
+def _get_assets(
+    project_name,
+    asset_ids=None,
+    asset_names=None,
+    standard=True,
+    archived=False,
+    fields=None
 ):
     """Assets for specified project by passed filters.
 
@@ -149,6 +157,8 @@ def get_assets(
         project_name (str): Name of project where to look for queried entities.
         asset_ids (list[str|ObjectId]): Asset ids that should be found.
         asset_names (list[str]): Name assets that should be found.
+        standard (bool): Query standart assets (type 'asset').
+        archived (bool): Query archived assets (type 'archived_asset').
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
@@ -157,10 +167,15 @@ def get_assets(
             passed filters.
     """
 
-    asset_types = ["asset"]
+    asset_types = []
+    if standard:
+        asset_types.append("asset")
     if archived:
         asset_types.append("archived_asset")
 
+    if not asset_types:
+        return []
+
     if len(asset_types) == 1:
         query_filter = {"type": asset_types[0]}
     else:
@@ -182,6 +197,68 @@ def get_assets(
     return conn.find(query_filter, _prepare_fields(fields))
 
 
+def get_assets(
+    project_name,
+    asset_ids=None,
+    asset_names=None,
+    archived=False,
+    fields=None
+):
+    """Assets for specified project by passed filters.
+
+    Passed filters (ids and names) are always combined so all conditions must
+    match.
+
+    To receive all assets from project just keep filters empty.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        asset_ids (list[str|ObjectId]): Asset ids that should be found.
+        asset_names (list[str]): Name assets that should be found.
+        archived (bool): Add also archived assets.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        Cursor: Query cursor as iterable which returns asset documents matching
+            passed filters.
+    """
+
+    return _get_assets(
+        project_name, asset_ids, asset_names, True, archived, fields
+    )
+
+
+def get_archived_assets(
+    project_name,
+    asset_ids=None,
+    asset_names=None,
+    fields=None
+):
+    """Archived assets for specified project by passed filters.
+
+    Passed filters (ids and names) are always combined so all conditions must
+    match.
+
+    To receive all archived assets from project just keep filters empty.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        asset_ids (list[str|ObjectId]): Asset ids that should be found.
+        asset_names (list[str]): Name assets that should be found.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        Cursor: Query cursor as iterable which returns asset documents matching
+            passed filters.
+    """
+
+    return _get_assets(
+        project_name, asset_ids, asset_names, False, True, fields
+    )
+
+
 def get_asset_ids_with_subsets(project_name, asset_ids=None):
     """Find out which assets have existing subsets.
 

From a57318823310729b281ced80390d8dad8f786fb5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 14:03:40 +0200
Subject: [PATCH 0617/1227] use query functions in sync to avalon event

---
 .../event_sync_to_avalon.py                   | 53 ++++++++-----------
 1 file changed, 23 insertions(+), 30 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/event_sync_to_avalon.py b/openpype/modules/ftrack/event_handlers_server/event_sync_to_avalon.py
index b5f199b3e4..a4e791aaf0 100644
--- a/openpype/modules/ftrack/event_handlers_server/event_sync_to_avalon.py
+++ b/openpype/modules/ftrack/event_handlers_server/event_sync_to_avalon.py
@@ -12,6 +12,12 @@ from pymongo import UpdateOne
 import arrow
 import ftrack_api
 
+from openpype.client import (
+    get_project,
+    get_assets,
+    get_archived_assets,
+    get_asset_ids_with_subsets
+)
 from openpype.pipeline import AvalonMongoDB, schema
 
 from openpype_modules.ftrack.lib import (
@@ -149,12 +155,11 @@ class SyncToAvalonEvent(BaseEvent):
     @property
     def avalon_entities(self):
         if self._avalon_ents is None:
+            project_name = self.cur_project["full_name"]
             self.dbcon.install()
-            self.dbcon.Session["AVALON_PROJECT"] = (
-                self.cur_project["full_name"]
-            )
-            avalon_project = self.dbcon.find_one({"type": "project"})
-            avalon_entities = list(self.dbcon.find({"type": "asset"}))
+            self.dbcon.Session["AVALON_PROJECT"] = project_name
+            avalon_project = get_project(project_name)
+            avalon_entities = list(get_assets(project_name))
             self._avalon_ents = (avalon_project, avalon_entities)
         return self._avalon_ents
 
@@ -284,28 +289,21 @@ class SyncToAvalonEvent(BaseEvent):
         self._avalon_ents_by_ftrack_id[ftrack_id] = doc
 
     @property
-    def avalon_subsets_by_parents(self):
-        if self._avalon_subsets_by_parents is None:
-            self._avalon_subsets_by_parents = collections.defaultdict(list)
-            self.dbcon.install()
-            self.dbcon.Session["AVALON_PROJECT"] = (
-                self.cur_project["full_name"]
+    def avalon_asset_ids_with_subsets(self):
+        if self._avalon_asset_ids_with_subsets is None:
+            project_name = self.cur_project["full_name"]
+            self._avalon_asset_ids_with_subsets = get_asset_ids_with_subsets(
+                project_name
             )
-            for subset in self.dbcon.find({"type": "subset"}):
-                self._avalon_subsets_by_parents[subset["parent"]].append(
-                    subset
-                )
-        return self._avalon_subsets_by_parents
+
+        return self._avalon_asset_ids_with_subsets
 
     @property
     def avalon_archived_by_id(self):
         if self._avalon_archived_by_id is None:
             self._avalon_archived_by_id = {}
-            self.dbcon.install()
-            self.dbcon.Session["AVALON_PROJECT"] = (
-                self.cur_project["full_name"]
-            )
-            for asset in self.dbcon.find({"type": "archived_asset"}):
+            project_name = self.cur_project["full_name"]
+            for asset in get_archived_assets(project_name):
                 self._avalon_archived_by_id[asset["_id"]] = asset
         return self._avalon_archived_by_id
 
@@ -327,7 +325,7 @@ class SyncToAvalonEvent(BaseEvent):
             avalon_project, avalon_entities = self.avalon_entities
             self._changeability_by_mongo_id[avalon_project["_id"]] = False
             self._bubble_changeability(
-                list(self.avalon_subsets_by_parents.keys())
+                list(self.avalon_asset_ids_with_subsets)
             )
 
         return self._changeability_by_mongo_id
@@ -449,14 +447,9 @@ class SyncToAvalonEvent(BaseEvent):
             if not entity:
                 # if entity is not found then it is subset without parent
                 if entity_id in unchangeable_ids:
-                    _subset_ids = [
-                        str(sub["_id"]) for sub in
-                        self.avalon_subsets_by_parents[entity_id]
-                    ]
-                    joined_subset_ids = "| ".join(_subset_ids)
                     self.log.warning((
-                        "Parent <{}> for subsets <{}> does not exist"
-                    ).format(str(entity_id), joined_subset_ids))
+                        "Parent <{}> with subsets does not exist"
+                    ).format(str(entity_id)))
                 else:
                     self.log.warning((
                         "In avalon are entities without valid parents that"
@@ -483,7 +476,7 @@ class SyncToAvalonEvent(BaseEvent):
         self._avalon_ents_by_parent_id = None
         self._avalon_ents_by_ftrack_id = None
         self._avalon_ents_by_name = None
-        self._avalon_subsets_by_parents = None
+        self._avalon_asset_ids_with_subsets = None
         self._changeability_by_mongo_id = None
         self._avalon_archived_by_id = None
         self._avalon_archived_by_name = None

From 177be6880f7bcf1de63a39ed07cd26a742345236 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 14:34:31 +0200
Subject: [PATCH 0618/1227] added versions argument to get_versions

---
 openpype/client/entities.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 0827e12288..6e1f4c556b 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -505,6 +505,7 @@ def _get_versions(
     project_name,
     subset_ids=None,
     version_ids=None,
+    versions=None,
     standard=True,
     hero=False,
     fields=None
@@ -535,6 +536,16 @@ def _get_versions(
             return []
         query_filter["_id"] = {"$in": version_ids}
 
+    if versions is not None:
+        versions = list(versions)
+        if not versions:
+            return []
+
+        if len(versions) == 1:
+            query_filter["name"] = versions[0]
+        else:
+            query_filter["name"] = {"$in": versions}
+
     conn = _get_project_connection(project_name)
 
     return conn.find(query_filter, _prepare_fields(fields))
@@ -544,6 +555,7 @@ def get_versions(
     project_name,
     version_ids=None,
     subset_ids=None,
+    versions=None,
     hero=False,
     fields=None
 ):
@@ -557,6 +569,8 @@ def get_versions(
             Filter ignored if 'None' is passed.
         subset_ids (list[str]): Subset ids that will be queried.
             Filter ignored if 'None' is passed.
+        versions (list[int]): Version names (as integers).
+            Filter ignored if 'None' is passed.
         hero (bool): Look also for hero versions.
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
@@ -569,6 +583,7 @@ def get_versions(
         project_name,
         subset_ids,
         version_ids,
+        versions,
         standard=True,
         hero=hero,
         fields=fields

From e6ddd6797d0ee9689d57b8bfd1e585dc55babffc Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 15:30:29 +0200
Subject: [PATCH 0619/1227] use query functions in prepare project

---
 .../action_prepare_project.py                      | 14 ++++----------
 .../event_handlers_user/action_prepare_project.py  | 14 ++++----------
 2 files changed, 8 insertions(+), 20 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py b/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py
index 975e49cb28..361aa98d16 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py
@@ -1,8 +1,8 @@
 import json
 
+from openpype.client import get_project
 from openpype.api import ProjectSettings
 from openpype.lib import create_project
-from openpype.pipeline import AvalonMongoDB
 from openpype.settings import SaveWarningExc
 
 from openpype_modules.ftrack.lib import (
@@ -363,12 +363,8 @@ class PrepareProjectServer(ServerAction):
         project_name = project_entity["full_name"]
 
         # Try to find project document
-        dbcon = AvalonMongoDB()
-        dbcon.install()
-        dbcon.Session["AVALON_PROJECT"] = project_name
-        project_doc = dbcon.find_one({
-            "type": "project"
-        })
+        project_doc = get_project(project_name)
+
         # Create project if is not available
         # - creation is required to be able set project anatomy and attributes
         if not project_doc:
@@ -376,9 +372,7 @@ class PrepareProjectServer(ServerAction):
             self.log.info("Creating project \"{} [{}]\"".format(
                 project_name, project_code
             ))
-            create_project(project_name, project_code, dbcon=dbcon)
-
-        dbcon.uninstall()
+            create_project(project_name, project_code)
 
         project_settings = ProjectSettings(project_name)
         project_anatomy_settings = project_settings["project_anatomy"]
diff --git a/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py b/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py
index 0b14e7aa2b..e9dc11de9f 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py
@@ -1,8 +1,8 @@
 import json
 
+from openpype.client import get_project
 from openpype.api import ProjectSettings
 from openpype.lib import create_project
-from openpype.pipeline import AvalonMongoDB
 from openpype.settings import SaveWarningExc
 
 from openpype_modules.ftrack.lib import (
@@ -389,12 +389,8 @@ class PrepareProjectLocal(BaseAction):
         project_name = project_entity["full_name"]
 
         # Try to find project document
-        dbcon = AvalonMongoDB()
-        dbcon.install()
-        dbcon.Session["AVALON_PROJECT"] = project_name
-        project_doc = dbcon.find_one({
-            "type": "project"
-        })
+        project_doc = get_project(project_name)
+
         # Create project if is not available
         # - creation is required to be able set project anatomy and attributes
         if not project_doc:
@@ -402,9 +398,7 @@ class PrepareProjectLocal(BaseAction):
             self.log.info("Creating project \"{} [{}]\"".format(
                 project_name, project_code
             ))
-            create_project(project_name, project_code, dbcon=dbcon)
-
-        dbcon.uninstall()
+            create_project(project_name, project_code)
 
         project_settings = ProjectSettings(project_name)
         project_anatomy_settings = project_settings["project_anatomy"]

From 77d496d88bc1a4c7e0aea436512d695ee72c92bd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 16:05:51 +0200
Subject: [PATCH 0620/1227] use query in applications action

---
 .../ftrack/event_handlers_user/action_applications.py  | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_applications.py b/openpype/modules/ftrack/event_handlers_user/action_applications.py
index b25bc1b5cb..102f04c956 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_applications.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_applications.py
@@ -1,5 +1,6 @@
 import os
 
+from openpype.client import get_project
 from openpype_modules.ftrack.lib import BaseAction
 from openpype.lib.applications import (
     ApplicationManager,
@@ -7,7 +8,6 @@ from openpype.lib.applications import (
     ApplictionExecutableNotFound,
     CUSTOM_LAUNCH_APP_GROUPS
 )
-from openpype.pipeline import AvalonMongoDB
 
 
 class AppplicationsAction(BaseAction):
@@ -25,7 +25,6 @@ class AppplicationsAction(BaseAction):
         super(AppplicationsAction, self).__init__(*args, **kwargs)
 
         self.application_manager = ApplicationManager()
-        self.dbcon = AvalonMongoDB()
 
     @property
     def discover_identifier(self):
@@ -110,12 +109,7 @@ class AppplicationsAction(BaseAction):
             if avalon_project_doc is None:
                 ft_project = self.get_project_from_entity(entity)
                 project_name = ft_project["full_name"]
-                if not self.dbcon.is_installed():
-                    self.dbcon.install()
-                self.dbcon.Session["AVALON_PROJECT"] = project_name
-                avalon_project_doc = self.dbcon.find_one({
-                    "type": "project"
-                }) or False
+                avalon_project_doc = get_project(project_name) or False
                 event["data"]["avalon_project_doc"] = avalon_project_doc
 
             if not avalon_project_doc:

From 7945ca0011c54eaed02655c64481c8dc2dd6bd6d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 16:06:12 +0200
Subject: [PATCH 0621/1227] use query functions in delete old versions action

---
 .../action_delete_old_versions.py             | 35 ++++++++++---------
 1 file changed, 18 insertions(+), 17 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_delete_old_versions.py b/openpype/modules/ftrack/event_handlers_user/action_delete_old_versions.py
index a0bf6622e9..3400c509ab 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_delete_old_versions.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_delete_old_versions.py
@@ -5,7 +5,12 @@ import uuid
 import clique
 from pymongo import UpdateOne
 
-
+from openpype.client import (
+    get_assets,
+    get_subsets,
+    get_versions,
+    get_representations
+)
 from openpype.api import Anatomy
 from openpype.lib import StringTemplate, TemplateUnsolved
 from openpype.pipeline import AvalonMongoDB
@@ -198,10 +203,9 @@ class DeleteOldVersions(BaseAction):
         self.log.debug("Project is set to {}".format(project_name))
 
         # Get Assets from avalon database
-        assets = list(self.dbcon.find({
-            "type": "asset",
-            "name": {"$in": avalon_asset_names}
-        }))
+        assets = list(
+            get_assets(project_name, asset_names=avalon_asset_names)
+        )
         asset_id_to_name_map = {
             asset["_id"]: asset["name"] for asset in assets
         }
@@ -210,10 +214,9 @@ class DeleteOldVersions(BaseAction):
         self.log.debug("Collected assets ({})".format(len(asset_ids)))
 
         # Get Subsets
-        subsets = list(self.dbcon.find({
-            "type": "subset",
-            "parent": {"$in": asset_ids}
-        }))
+        subsets = list(
+            get_subsets(project_name, asset_ids=asset_ids)
+        )
         subsets_by_id = {}
         subset_ids = []
         for subset in subsets:
@@ -230,10 +233,9 @@ class DeleteOldVersions(BaseAction):
         self.log.debug("Collected subsets ({})".format(len(subset_ids)))
 
         # Get Versions
-        versions = list(self.dbcon.find({
-            "type": "version",
-            "parent": {"$in": subset_ids}
-        }))
+        versions = list(
+            get_versions(project_name, subset_ids=subset_ids)
+        )
 
         versions_by_parent = collections.defaultdict(list)
         for ent in versions:
@@ -295,10 +297,9 @@ class DeleteOldVersions(BaseAction):
                 "message": msg
             }
 
-        repres = list(self.dbcon.find({
-            "type": "representation",
-            "parent": {"$in": version_ids}
-        }))
+        repres = list(
+            get_representations(project_name, version_ids=version_ids)
+        )
 
         self.log.debug(
             "Collected representations to remove ({})".format(len(repres))

From af0b97fafe625ad1094627435c22e33e5881a2d8 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 16:07:47 +0200
Subject: [PATCH 0622/1227] use query functions in delivery action

---
 .../event_handlers_user/action_delivery.py    | 152 ++++++++----------
 1 file changed, 66 insertions(+), 86 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_delivery.py b/openpype/modules/ftrack/event_handlers_user/action_delivery.py
index 86d88ef7cc..47f2853820 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_delivery.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_delivery.py
@@ -3,8 +3,13 @@ import copy
 import json
 import collections
 
-from bson.objectid import ObjectId
-
+from openpype.client import (
+    get_project,
+    get_assets,
+    get_subsets,
+    get_versions,
+    get_representations
+)
 from openpype.api import Anatomy, config
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 from openpype_modules.ftrack.lib.avalon_sync import CUST_ATTR_ID_KEY
@@ -18,11 +23,9 @@ from openpype.lib.delivery import (
     process_single_file,
     process_sequence
 )
-from openpype.pipeline import AvalonMongoDB
 
 
 class Delivery(BaseAction):
-
     identifier = "delivery.action"
     label = "Delivery"
     description = "Deliver data to client"
@@ -30,11 +33,6 @@ class Delivery(BaseAction):
     icon = statics_icon("ftrack", "action_icons", "Delivery.svg")
     settings_key = "delivery_action"
 
-    def __init__(self, *args, **kwargs):
-        self.dbcon = AvalonMongoDB()
-
-        super(Delivery, self).__init__(*args, **kwargs)
-
     def discover(self, session, entities, event):
         is_valid = False
         for entity in entities:
@@ -57,9 +55,7 @@ class Delivery(BaseAction):
 
         project_entity = self.get_project_from_entity(entities[0])
         project_name = project_entity["full_name"]
-        self.dbcon.install()
-        self.dbcon.Session["AVALON_PROJECT"] = project_name
-        project_doc = self.dbcon.find_one({"type": "project"}, {"name": True})
+        project_doc = get_project(project_name, fields=["name"])
         if not project_doc:
             return {
                 "success": False,
@@ -68,8 +64,7 @@ class Delivery(BaseAction):
                 ).format(project_name)
             }
 
-        repre_names = self._get_repre_names(session, entities)
-        self.dbcon.uninstall()
+        repre_names = self._get_repre_names(project_name, session, entities)
 
         items.append({
             "type": "hidden",
@@ -198,17 +193,21 @@ class Delivery(BaseAction):
             "title": title
         }
 
-    def _get_repre_names(self, session, entities):
-        version_ids = self._get_interest_version_ids(session, entities)
+    def _get_repre_names(self, project_name, session, entities):
+        version_ids = self._get_interest_version_ids(
+            project_name, session, entities
+        )
         if not version_ids:
             return []
-        repre_docs = self.dbcon.find({
-            "type": "representation",
-            "parent": {"$in": version_ids}
-        })
-        return list(sorted(repre_docs.distinct("name")))
+        repre_docs = get_representations(
+            project_name,
+            version_ids=version_ids,
+            fields=["name"]
+        )
+        repre_names = {repre_doc["name"] for repre_doc in repre_docs}
+        return list(sorted(repre_names))
 
-    def _get_interest_version_ids(self, session, entities):
+    def _get_interest_version_ids(self, project_name, session, entities):
         # Extract AssetVersion entities
         asset_versions = self._extract_asset_versions(session, entities)
         # Prepare Asset ids
@@ -235,14 +234,18 @@ class Delivery(BaseAction):
             subset_names.add(asset["name"])
             version_nums.add(asset_version["version"])
 
-        asset_docs_by_ftrack_id = self._get_asset_docs(session, parent_ids)
+        asset_docs_by_ftrack_id = self._get_asset_docs(
+            project_name, session, parent_ids
+        )
         subset_docs = self._get_subset_docs(
+            project_name,
             asset_docs_by_ftrack_id,
             subset_names,
             asset_versions,
             assets_by_id
         )
         version_docs = self._get_version_docs(
+            project_name,
             asset_docs_by_ftrack_id,
             subset_docs,
             version_nums,
@@ -290,6 +293,7 @@ class Delivery(BaseAction):
 
     def _get_version_docs(
         self,
+        project_name,
         asset_docs_by_ftrack_id,
         subset_docs,
         version_nums,
@@ -300,11 +304,11 @@ class Delivery(BaseAction):
             subset_doc["_id"]: subset_doc
             for subset_doc in subset_docs
         }
-        version_docs = list(self.dbcon.find({
-            "type": "version",
-            "parent": {"$in": list(subset_docs_by_id.keys())},
-            "name": {"$in": list(version_nums)}
-        }))
+        version_docs = list(get_versions(
+            project_name,
+            subset_ids=subset_docs_by_id.keys(),
+            versions=version_nums
+        ))
         version_docs_by_parent_id = collections.defaultdict(dict)
         for version_doc in version_docs:
             subset_doc = subset_docs_by_id[version_doc["parent"]]
@@ -345,6 +349,7 @@ class Delivery(BaseAction):
 
     def _get_subset_docs(
         self,
+        project_name,
         asset_docs_by_ftrack_id,
         subset_names,
         asset_versions,
@@ -354,11 +359,11 @@ class Delivery(BaseAction):
             asset_doc["_id"]
             for asset_doc in asset_docs_by_ftrack_id.values()
         ]
-        subset_docs = list(self.dbcon.find({
-            "type": "subset",
-            "parent": {"$in": asset_doc_ids},
-            "name": {"$in": list(subset_names)}
-        }))
+        subset_docs = list(get_subsets(
+            project_name,
+            asset_ids=asset_doc_ids,
+            subset_names=subset_names
+        ))
         subset_docs_by_parent_id = collections.defaultdict(dict)
         for subset_doc in subset_docs:
             asset_id = subset_doc["parent"]
@@ -385,15 +390,21 @@ class Delivery(BaseAction):
                 filtered_subsets.append(subset_doc)
         return filtered_subsets
 
-    def _get_asset_docs(self, session, parent_ids):
-        asset_docs = list(self.dbcon.find({
-            "type": "asset",
-            "data.ftrackId": {"$in": list(parent_ids)}
-        }))
+    def _get_asset_docs(self, project_name, session, parent_ids):
+        asset_docs = list(get_assets(
+            project_name, fields=["_id", "name", "data.ftrackId"]
+        ))
 
+        asset_docs_by_id = {}
+        asset_docs_by_name = {}
         asset_docs_by_ftrack_id = {}
         for asset_doc in asset_docs:
+            asset_id = str(asset_doc["_id"])
+            asset_name = asset_doc["name"]
             ftrack_id = asset_doc["data"].get("ftrackId")
+
+            asset_docs_by_id[asset_id] = asset_doc
+            asset_docs_by_name[asset_name] = asset_doc
             if ftrack_id:
                 asset_docs_by_ftrack_id[ftrack_id] = asset_doc
 
@@ -406,15 +417,15 @@ class Delivery(BaseAction):
         avalon_mongo_id_values = query_custom_attributes(
             session, [attr_def["id"]], parent_ids, True
         )
-        entity_ids_by_mongo_id = {
-            ObjectId(item["value"]): item["entity_id"]
-            for item in avalon_mongo_id_values
-            if item["value"]
-        }
-
         missing_ids = set(parent_ids)
-        for entity_id in set(entity_ids_by_mongo_id.values()):
-            if entity_id in missing_ids:
+        for item in avalon_mongo_id_values:
+            if not item["value"]:
+                continue
+            asset_id = item["value"]
+            entity_id = item["entity_id"]
+            asset_doc = asset_docs_by_id.get(asset_id)
+            if asset_doc:
+                asset_docs_by_ftrack_id[entity_id] = asset_doc
                 missing_ids.remove(entity_id)
 
         entity_ids_by_name = {}
@@ -427,36 +438,10 @@ class Delivery(BaseAction):
                 for entity in not_found_entities
             }
 
-        expressions = []
-        if entity_ids_by_mongo_id:
-            expression = {
-                "type": "asset",
-                "_id": {"$in": list(entity_ids_by_mongo_id.keys())}
-            }
-            expressions.append(expression)
-
-        if entity_ids_by_name:
-            expression = {
-                "type": "asset",
-                "name": {"$in": list(entity_ids_by_name.keys())}
-            }
-            expressions.append(expression)
-
-        if expressions:
-            if len(expressions) == 1:
-                filter = expressions[0]
-            else:
-                filter = {"$or": expressions}
-
-            asset_docs = self.dbcon.find(filter)
-            for asset_doc in asset_docs:
-                if asset_doc["_id"] in entity_ids_by_mongo_id:
-                    entity_id = entity_ids_by_mongo_id[asset_doc["_id"]]
-                    asset_docs_by_ftrack_id[entity_id] = asset_doc
-
-                elif asset_doc["name"] in entity_ids_by_name:
-                    entity_id = entity_ids_by_name[asset_doc["name"]]
-                    asset_docs_by_ftrack_id[entity_id] = asset_doc
+        for asset_name, entity_id in entity_ids_by_name.items():
+            asset_doc = asset_docs_by_name.get(asset_name)
+            if asset_doc:
+                asset_docs_by_ftrack_id[entity_id] = asset_doc
 
         return asset_docs_by_ftrack_id
 
@@ -490,7 +475,6 @@ class Delivery(BaseAction):
         session.commit()
 
         try:
-            self.dbcon.install()
             report = self.real_launch(session, entities, event)
 
         except Exception as exc:
@@ -516,7 +500,6 @@ class Delivery(BaseAction):
             else:
                 job["status"] = "failed"
             session.commit()
-            self.dbcon.uninstall()
 
         if not report["success"]:
             self.show_interface(
@@ -558,16 +541,13 @@ class Delivery(BaseAction):
             if not os.path.exists(location_path):
                 os.makedirs(location_path)
 
-        self.dbcon.Session["AVALON_PROJECT"] = project_name
-
         self.log.debug("Collecting representations to process.")
         version_ids = self._get_interest_version_ids(session, entities)
-        repres_to_deliver = list(self.dbcon.find({
-            "type": "representation",
-            "parent": {"$in": version_ids},
-            "name": {"$in": repre_names}
-        }))
-
+        repres_to_deliver = list(get_representations(
+            project_name,
+            representation_names=repre_names,
+            version_ids=version_ids
+        ))
         anatomy = Anatomy(project_name)
 
         format_dict = get_format_dict(anatomy, location_path)

From ac48f50fdffb2e1650ce3681679b3ad822b3889c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 16:07:58 +0200
Subject: [PATCH 0623/1227] use query action in fill workfile attribute

---
 .../event_handlers_user/action_fill_workfile_attr.py  | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_fill_workfile_attr.py b/openpype/modules/ftrack/event_handlers_user/action_fill_workfile_attr.py
index c7237a1150..d30c41a749 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_fill_workfile_attr.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_fill_workfile_attr.py
@@ -7,6 +7,10 @@ import datetime
 
 import ftrack_api
 
+from openpype.client import (
+    get_project,
+    get_assets,
+)
 from openpype.api import get_project_settings
 from openpype.lib import (
     get_workfile_template_key,
@@ -14,7 +18,6 @@ from openpype.lib import (
     Anatomy,
     StringTemplate,
 )
-from openpype.pipeline import AvalonMongoDB
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 from openpype_modules.ftrack.lib.avalon_sync import create_chunks
 
@@ -248,10 +251,8 @@ class FillWorkfileAttributeAction(BaseAction):
         # Find matchin asset documents and map them by ftrack task entities
         # - result stored to 'asset_docs_with_task_entities' is list with
         #   tuple `(asset document, [task entitis, ...])`
-        dbcon = AvalonMongoDB()
-        dbcon.Session["AVALON_PROJECT"] = project_name
         # Quety all asset documents
-        asset_docs = list(dbcon.find({"type": "asset"}))
+        asset_docs = list(get_assets(project_name))
         job_entity["data"] = json.dumps({
             "description": "(1/3) Asset documents queried."
         })
@@ -276,7 +277,7 @@ class FillWorkfileAttributeAction(BaseAction):
         # Keep placeholders in the template unfilled
         host_name = "{app}"
         extension = "{ext}"
-        project_doc = dbcon.find_one({"type": "project"})
+        project_doc = get_project(project_name)
         project_settings = get_project_settings(project_name)
         anatomy = Anatomy(project_name)
         templates_by_key = {}

From dd07bbe9b248cf0096e318c25fa73365217222fb Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 16:31:32 +0200
Subject: [PATCH 0624/1227] use query functions in event user assiment

---
 .../event_user_assigment.py                   | 23 ++++---------------
 1 file changed, 4 insertions(+), 19 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/event_user_assigment.py b/openpype/modules/ftrack/event_handlers_server/event_user_assigment.py
index 593fc5e596..82b79e986b 100644
--- a/openpype/modules/ftrack/event_handlers_server/event_user_assigment.py
+++ b/openpype/modules/ftrack/event_handlers_server/event_user_assigment.py
@@ -1,11 +1,9 @@
 import re
 import subprocess
 
+from openpype.client import get_asset_by_id, get_asset_by_name
 from openpype_modules.ftrack.lib import BaseEvent
 from openpype_modules.ftrack.lib.avalon_sync import CUST_ATTR_ID_KEY
-from openpype.pipeline import AvalonMongoDB
-
-from bson.objectid import ObjectId
 
 from openpype.api import Anatomy, get_project_settings
 
@@ -36,8 +34,6 @@ class UserAssigmentEvent(BaseEvent):
         3) path to publish files of task user was (de)assigned to
     """
 
-    db_con = AvalonMongoDB()
-
     def error(self, *err):
         for e in err:
             self.log.error(e)
@@ -101,26 +97,16 @@ class UserAssigmentEvent(BaseEvent):
         :rtype: dict
         """
         parent = task['parent']
-        self.db_con.install()
-        self.db_con.Session['AVALON_PROJECT'] = task['project']['full_name']
-
+        project_name = task["project"]["full_name"]
         avalon_entity = None
         parent_id = parent['custom_attributes'].get(CUST_ATTR_ID_KEY)
         if parent_id:
-            parent_id = ObjectId(parent_id)
-            avalon_entity = self.db_con.find_one({
-                '_id': parent_id,
-                'type': 'asset'
-            })
+            avalon_entity = get_asset_by_id(project_name, parent_id)
 
         if not avalon_entity:
-            avalon_entity = self.db_con.find_one({
-                'type': 'asset',
-                'name': parent['name']
-            })
+            avalon_entity = get_asset_by_name(project_name, parent["name"])
 
         if not avalon_entity:
-            self.db_con.uninstall()
             msg = 'Entity "{}" not found in avalon database'.format(
                 parent['name']
             )
@@ -129,7 +115,6 @@ class UserAssigmentEvent(BaseEvent):
                 'success': False,
                 'message': msg
             }
-        self.db_con.uninstall()
         return avalon_entity
 
     def _get_hierarchy(self, asset):

From 951a23484e98c1831063c81306ed9f298f957ce5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 16:31:51 +0200
Subject: [PATCH 0625/1227] use query functions in RV action

---
 .../ftrack/event_handlers_user/action_rv.py   | 71 +++++++++++--------
 1 file changed, 40 insertions(+), 31 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_rv.py b/openpype/modules/ftrack/event_handlers_user/action_rv.py
index 040ca75582..2480ea7f95 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_rv.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_rv.py
@@ -5,9 +5,16 @@ import json
 
 import ftrack_api
 
+from openpype.client import (
+    get_asset_by_name,
+    get_subset_by_name,
+    get_version_by_name,
+    get_representation_by_name
+)
+from openpype.api import Anatomy
 from openpype.pipeline import (
     get_representation_path,
-    legacy_io,
+    AvalonMongoDB,
 )
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 
@@ -255,9 +262,10 @@ class RVAction(BaseAction):
             "Component", list(event["data"]["values"].values())[0]
         )["version"]["asset"]["parent"]["link"][0]
         project = session.get(link["type"], link["id"])
-        os.environ["AVALON_PROJECT"] = project["name"]
-        legacy_io.Session["AVALON_PROJECT"] = project["name"]
-        legacy_io.install()
+        project_name = project["full_name"]
+        dbcon = AvalonMongoDB()
+        dbcon.Session["AVALON_PROJECT"] = project_name
+        anatomy = Anatomy(project_name)
 
         location = ftrack_api.Session().pick_location()
 
@@ -281,37 +289,38 @@ class RVAction(BaseAction):
             if online_source:
                 continue
 
-            asset = legacy_io.find_one({"type": "asset", "name": parent_name})
-            subset = legacy_io.find_one(
-                {
-                    "type": "subset",
-                    "name": component["version"]["asset"]["name"],
-                    "parent": asset["_id"]
-                }
+            subset_name = component["version"]["asset"]["name"]
+            version_name = component["version"]["version"]
+            representation_name = component["file_type"][1:]
+
+            asset_doc = get_asset_by_name(
+                project_name, parent_name, fields=["_id"]
             )
-            version = legacy_io.find_one(
-                {
-                    "type": "version",
-                    "name": component["version"]["version"],
-                    "parent": subset["_id"]
-                }
+            subset_doc = get_subset_by_name(
+                project_name,
+                subset_name=subset_name,
+                asset_id=asset_doc["_id"]
             )
-            representation = legacy_io.find_one(
-                {
-                    "type": "representation",
-                    "parent": version["_id"],
-                    "name": component["file_type"][1:]
-                }
+            version_doc = get_version_by_name(
+                project_name,
+                version=version_name,
+                subset_id=subset_doc["_id"]
             )
-            if representation is None:
-                representation = legacy_io.find_one(
-                    {
-                        "type": "representation",
-                        "parent": version["_id"],
-                        "name": "preview"
-                    }
+            repre_doc = get_representation_by_name(
+                project_name,
+                version_id=version_doc["_id"],
+                representation_name=representation_name
+            )
+            if not repre_doc:
+                repre_doc = get_representation_by_name(
+                    project_name,
+                    version_id=version_doc["_id"],
+                    representation_name="preview"
                 )
-            paths.append(get_representation_path(representation))
+
+            paths.append(get_representation_path(
+                repre_doc, root=anatomy.roots, dbcon=dbcon
+            ))
 
         return paths
 

From 38f058fca0ffaeef4cbe888433e3593fb282b048 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 16:32:34 +0200
Subject: [PATCH 0626/1227] use query functions in delete asset action

---
 .../action_delete_asset.py                    | 97 +++++++++----------
 1 file changed, 45 insertions(+), 52 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py b/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py
index ee5c3d0d97..b5b4ec5ac5 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py
@@ -4,6 +4,7 @@ from datetime import datetime
 
 from bson.objectid import ObjectId
 
+from openpype.client import get_assets, get_subsets
 from openpype.pipeline import AvalonMongoDB
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 from openpype_modules.ftrack.lib.avalon_sync import create_chunks
@@ -91,11 +92,9 @@ class DeleteAssetSubset(BaseAction):
                 continue
 
             ftrack_id = entity.get("entityId")
-            if not ftrack_id:
-                continue
-
-            ftrack_ids.append(ftrack_id)
-
+            if ftrack_id:
+                ftrack_ids.append(ftrack_id)
+                
         if project_in_selection:
             msg = "It is not possible to use this action on project entity."
             self.show_message(event, msg, True)
@@ -120,48 +119,49 @@ class DeleteAssetSubset(BaseAction):
                 "message": "Invalid selection for this action (Bug)"
             }
 
-        if entities[0].entity_type.lower() == "project":
-            project = entities[0]
-        else:
-            project = entities[0]["project"]
-
+        project = self.get_project_from_entity(entities[0], session)
         project_name = project["full_name"]
         self.dbcon.Session["AVALON_PROJECT"] = project_name
 
-        selected_av_entities = list(self.dbcon.find({
-            "type": "asset",
-            "data.ftrackId": {"$in": ftrack_ids}
-        }))
+        asset_docs = list(get_assets(
+            project_name,
+            fields=["_id", "name", "data.ftrackId", "data.parents"]
+        ))
+        selected_av_entities = []
+        found_ftrack_ids = set()
+        asset_docs_by_name = collections.defaultdict(list)
+        for asset_doc in asset_docs:
+            ftrack_id = asset_doc["data"].get("ftrackId")
+            if ftrack_id:
+                found_ftrack_ids.add(ftrack_id)
+                selected_av_entities.append(asset_doc)
+
+            asset_name = asset_doc["name"]
+            asset_docs_by_name[asset_name].append(asset_doc)
+
         found_without_ftrack_id = {}
-        if len(selected_av_entities) != len(ftrack_ids):
-            found_ftrack_ids = [
-                ent["data"]["ftrackId"] for ent in selected_av_entities
-            ]
-            for ftrack_id, entity in entity_mapping.items():
-                if ftrack_id in found_ftrack_ids:
+        for ftrack_id, entity in entity_mapping.items():
+            if ftrack_id in found_ftrack_ids:
+                continue
+
+            av_ents_by_name = asset_docs_by_name[entity["name"]]
+            if not av_ents_by_name:
+                continue
+
+            ent_path_items = [ent["name"] for ent in entity["link"]]
+            parents = ent_path_items[1:len(ent_path_items)-1:]
+            # TODO we should say to user that
+            # few of them are missing in avalon
+            for av_ent in av_ents_by_name:
+                if av_ent["data"]["parents"] != parents:
                     continue
 
-                av_ents_by_name = list(self.dbcon.find({
-                    "type": "asset",
-                    "name": entity["name"]
-                }))
-                if not av_ents_by_name:
-                    continue
-
-                ent_path_items = [ent["name"] for ent in entity["link"]]
-                parents = ent_path_items[1:len(ent_path_items)-1:]
-                # TODO we should say to user that
-                # few of them are missing in avalon
-                for av_ent in av_ents_by_name:
-                    if av_ent["data"]["parents"] != parents:
-                        continue
-
-                    # TODO we should say to user that found entity
-                    # with same name does not match same ftrack id?
-                    if "ftrackId" not in av_ent["data"]:
-                        selected_av_entities.append(av_ent)
-                        found_without_ftrack_id[str(av_ent["_id"])] = ftrack_id
-                        break
+                # TODO we should say to user that found entity
+                # with same name does not match same ftrack id?
+                if "ftrackId" not in av_ent["data"]:
+                    selected_av_entities.append(av_ent)
+                    found_without_ftrack_id[str(av_ent["_id"])] = ftrack_id
+                    break
 
         if not selected_av_entities:
             return {
@@ -206,10 +206,7 @@ class DeleteAssetSubset(BaseAction):
 
         items.append(id_item)
         asset_ids = [ent["_id"] for ent in selected_av_entities]
-        subsets_for_selection = self.dbcon.find({
-            "type": "subset",
-            "parent": {"$in": asset_ids}
-        })
+        subsets_for_selection = get_subsets(project_name, asset_ids=asset_ids)
 
         asset_ending = ""
         if len(selected_av_entities) > 1:
@@ -459,13 +456,9 @@ class DeleteAssetSubset(BaseAction):
         if len(assets_to_delete) > 0:
             map_av_ftrack_id = spec_data["without_ftrack_id"]
             # Prepare data when deleting whole avalon asset
-            avalon_assets = self.dbcon.find(
-                {"type": "asset"},
-                {
-                    "_id": 1,
-                    "data.visualParent": 1,
-                    "data.ftrackId": 1
-                }
+            avalon_assets = get_assets(
+                project_name,
+                fields=["_id", "data.visualParent", "data.ftrackId"]
             )
             avalon_assets_by_parent = collections.defaultdict(list)
             for asset in avalon_assets:

From 46e22241bd8d7d61b427f9d0f4fff930cc7549a2 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 16:32:55 +0200
Subject: [PATCH 0627/1227] use query functions in store thumbnails to avalon

---
 .../action_store_thumbnails_to_avalon.py      | 56 ++++++++++---------
 1 file changed, 30 insertions(+), 26 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_store_thumbnails_to_avalon.py b/openpype/modules/ftrack/event_handlers_user/action_store_thumbnails_to_avalon.py
index 62fdfa2bdd..d655dddcaf 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_store_thumbnails_to_avalon.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_store_thumbnails_to_avalon.py
@@ -5,6 +5,14 @@ import requests
 
 from bson.objectid import ObjectId
 
+from openpype.client import (
+    get_project,
+    get_asset_by_id,
+    get_assets,
+    get_subset_by_name,
+    get_version_by_name,
+    get_representations
+)
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 from openpype.api import Anatomy
 from openpype.pipeline import AvalonMongoDB
@@ -385,7 +393,7 @@ class StoreThumbnailsToAvalon(BaseAction):
 
         db_con.Session["AVALON_PROJECT"] = project_name
 
-        avalon_project = db_con.find_one({"type": "project"})
+        avalon_project = get_project(project_name)
         output["project"] = avalon_project
 
         if not avalon_project:
@@ -399,19 +407,17 @@ class StoreThumbnailsToAvalon(BaseAction):
         asset_mongo_id = parent["custom_attributes"].get(CUST_ATTR_ID_KEY)
         if asset_mongo_id:
             try:
-                asset_mongo_id = ObjectId(asset_mongo_id)
-                asset_ent = db_con.find_one({
-                    "type": "asset",
-                    "_id": asset_mongo_id
-                })
+                asset_ent = get_asset_by_id(project_name, asset_mongo_id)
             except Exception:
                 pass
 
         if not asset_ent:
-            asset_ent = db_con.find_one({
-                "type": "asset",
-                "data.ftrackId": parent["id"]
-            })
+            asset_docs = get_assets(project_name, asset_names=[parent["name"]])
+            for asset_doc in asset_docs:
+                ftrack_id = asset_doc.get("data", {}).get("ftrackId")
+                if ftrack_id == parent["id"]:
+                    asset_ent = asset_doc
+                    break
 
         output["asset"] = asset_ent
 
@@ -422,13 +428,11 @@ class StoreThumbnailsToAvalon(BaseAction):
             )
             return output
 
-        asset_mongo_id = asset_ent["_id"]
-
-        subset_ent = db_con.find_one({
-            "type": "subset",
-            "parent": asset_mongo_id,
-            "name": subset_name
-        })
+        subset_ent = get_subset_by_name(
+            project_name,
+            subset_name=subset_name,
+            asset_id=asset_ent["_id"]
+        )
 
         output["subset"] = subset_ent
 
@@ -439,11 +443,11 @@ class StoreThumbnailsToAvalon(BaseAction):
             ).format(subset_name, ent_path)
             return output
 
-        version_ent = db_con.find_one({
-            "type": "version",
-            "name": version,
-            "parent": subset_ent["_id"]
-        })
+        version_ent = get_version_by_name(
+            project_name,
+            version,
+            subset_ent["_id"]
+        )
 
         output["version"] = version_ent
 
@@ -454,10 +458,10 @@ class StoreThumbnailsToAvalon(BaseAction):
             ).format(version, subset_name, ent_path)
             return output
 
-        repre_ents = list(db_con.find({
-            "type": "representation",
-            "parent": version_ent["_id"]
-        }))
+        repre_ents = list(get_representations(
+            project_name,
+            version_ids=[version_ent["_id"]]
+        ))
 
         output["representations"] = repre_ents
         return output

From be2238718b402b2428335b61643cf0bab2165776 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 16:46:14 +0200
Subject: [PATCH 0628/1227] use query functions in avalon sync

---
 openpype/modules/ftrack/lib/avalon_sync.py | 70 +++++++++++-----------
 1 file changed, 36 insertions(+), 34 deletions(-)

diff --git a/openpype/modules/ftrack/lib/avalon_sync.py b/openpype/modules/ftrack/lib/avalon_sync.py
index e4ba651bfd..68b5c62c53 100644
--- a/openpype/modules/ftrack/lib/avalon_sync.py
+++ b/openpype/modules/ftrack/lib/avalon_sync.py
@@ -6,6 +6,14 @@ import numbers
 
 import six
 
+from openpype.client import (
+    get_project,
+    get_assets,
+    get_archived_assets,
+    get_subsets,
+    get_versions,
+    get_representations
+)
 from openpype.api import (
     Logger,
     get_anatomy_settings
@@ -576,6 +584,10 @@ class SyncEntitiesFactory:
         self.ft_project_id = ft_project_id
         self.entities_dict = entities_dict
 
+    @property
+    def project_name(self):
+        return self.entities_dict[self.ft_project_id]["name"]
+
     @property
     def avalon_ents_by_id(self):
         """
@@ -660,9 +672,9 @@ class SyncEntitiesFactory:
             (list) of assets
         """
         if self._avalon_archived_ents is None:
-            self._avalon_archived_ents = [
-                ent for ent in self.dbcon.find({"type": "archived_asset"})
-            ]
+            self._avalon_archived_ents = list(
+                get_archived_assets(self.project_name)
+            )
         return self._avalon_archived_ents
 
     @property
@@ -730,7 +742,7 @@ class SyncEntitiesFactory:
         """
         if self._subsets_by_parent_id is None:
             self._subsets_by_parent_id = collections.defaultdict(list)
-            for subset in self.dbcon.find({"type": "subset"}):
+            for subset in get_subsets(self.project_name):
                 self._subsets_by_parent_id[str(subset["parent"])].append(
                     subset
                 )
@@ -1421,8 +1433,8 @@ class SyncEntitiesFactory:
         # Avalon entities
         self.dbcon.install()
         self.dbcon.Session["AVALON_PROJECT"] = ft_project_name
-        avalon_project = self.dbcon.find_one({"type": "project"})
-        avalon_entities = self.dbcon.find({"type": "asset"})
+        avalon_project = get_project(ft_project_name)
+        avalon_entities = get_assets(ft_project_name)
         self.avalon_project = avalon_project
         self.avalon_entities = avalon_entities
 
@@ -2258,46 +2270,37 @@ class SyncEntitiesFactory:
         self._delete_subsets_without_asset(subsets_to_remove)
 
     def _delete_subsets_without_asset(self, not_existing_parents):
-        subset_ids = []
-        version_ids = []
         repre_ids = []
         to_delete = []
 
+        subset_ids = []
         for parent_id in not_existing_parents:
             subsets = self.subsets_by_parent_id.get(parent_id)
             if not subsets:
                 continue
             for subset in subsets:
-                if subset.get("type") != "subset":
-                    continue
-                subset_ids.append(subset["_id"])
+                if subset.get("type") == "subset":
+                    subset_ids.append(subset["_id"])
 
-        db_subsets = self.dbcon.find({
-            "_id": {"$in": subset_ids},
-            "type": "subset"
-        })
-        if not db_subsets:
-            return
-
-        db_versions = self.dbcon.find({
-            "parent": {"$in": subset_ids},
-            "type": "version"
-        })
-        if db_versions:
-            version_ids = [ver["_id"] for ver in db_versions]
-
-        db_repres = self.dbcon.find({
-            "parent": {"$in": version_ids},
-            "type": "representation"
-        })
-        if db_repres:
-            repre_ids = [repre["_id"] for repre in db_repres]
+        db_versions = get_versions(
+            self.project_name,
+            subset_ids=subset_ids,
+            fields=["_id"]
+        )
+        version_ids = [ver["_id"] for ver in db_versions]
+        db_repres = get_representations(
+            self.project_name,
+            version_ids=version_ids,
+            fields=["_id"]
+        )
+        repre_ids = [repre["_id"] for repre in db_repres]
 
         to_delete.extend(subset_ids)
         to_delete.extend(version_ids)
         to_delete.extend(repre_ids)
 
-        self.dbcon.delete_many({"_id": {"$in": to_delete}})
+        if to_delete:
+            self.dbcon.delete_many({"_id": {"$in": to_delete}})
 
     # Probably deprecated
     def _check_changeability(self, parent_id=None):
@@ -2779,8 +2782,7 @@ class SyncEntitiesFactory:
 
     def report(self):
         items = []
-        project_name = self.entities_dict[self.ft_project_id]["name"]
-        title = "Synchronization report ({}):".format(project_name)
+        title = "Synchronization report ({}):".format(self.project_name)
 
         keys = ["error", "warning", "info"]
         for key in keys:

From ce63c7c96dd5b3c9ab28d766e87390f7c5334eb2 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 16:46:27 +0200
Subject: [PATCH 0629/1227] use query functions in integrate ftrack hierarchy

---
 .../publish/integrate_hierarchy_ftrack.py     | 28 +++++++++++--------
 1 file changed, 16 insertions(+), 12 deletions(-)

diff --git a/openpype/modules/ftrack/plugins/publish/integrate_hierarchy_ftrack.py b/openpype/modules/ftrack/plugins/publish/integrate_hierarchy_ftrack.py
index 73398941eb..1a5d74bf26 100644
--- a/openpype/modules/ftrack/plugins/publish/integrate_hierarchy_ftrack.py
+++ b/openpype/modules/ftrack/plugins/publish/integrate_hierarchy_ftrack.py
@@ -3,7 +3,8 @@ import collections
 import six
 import pyblish.api
 from copy import deepcopy
-from openpype.pipeline import legacy_io
+from openpype.client import get_asset_by_id
+
 
 # Copy of constant `openpype_modules.ftrack.lib.avalon_sync.CUST_ATTR_AUTO_SYNC`
 CUST_ATTR_AUTO_SYNC = "avalon_auto_sync"
@@ -82,9 +83,6 @@ class IntegrateHierarchyToFtrack(pyblish.api.ContextPlugin):
         auto_sync_state = project[
             "custom_attributes"][CUST_ATTR_AUTO_SYNC]
 
-        if not legacy_io.Session:
-            legacy_io.install()
-
         self.ft_project = None
 
         # disable termporarily ftrack project's autosyncing
@@ -93,14 +91,14 @@ class IntegrateHierarchyToFtrack(pyblish.api.ContextPlugin):
 
         try:
             # import ftrack hierarchy
-            self.import_to_ftrack(hierarchy_context)
+            self.import_to_ftrack(project_name, hierarchy_context)
         except Exception:
             raise
         finally:
             if auto_sync_state:
                 self.auto_sync_on(project)
 
-    def import_to_ftrack(self, input_data, parent=None):
+    def import_to_ftrack(self, project_name, input_data, parent=None):
         # Prequery hiearchical custom attributes
         hier_custom_attributes = get_pype_attr(self.session)[1]
         hier_attr_by_key = {
@@ -222,7 +220,7 @@ class IntegrateHierarchyToFtrack(pyblish.api.ContextPlugin):
                     six.reraise(tp, value, tb)
 
             # Incoming links.
-            self.create_links(entity_data, entity)
+            self.create_links(project_name, entity_data, entity)
             try:
                 self.session.commit()
             except Exception:
@@ -255,9 +253,9 @@ class IntegrateHierarchyToFtrack(pyblish.api.ContextPlugin):
             # Import children.
             if 'childs' in entity_data:
                 self.import_to_ftrack(
-                    entity_data['childs'], entity)
+                    project_name, entity_data['childs'], entity)
 
-    def create_links(self, entity_data, entity):
+    def create_links(self, project_name, entity_data, entity):
         # Clear existing links.
         for link in entity.get("incoming_links", []):
             self.session.delete(link)
@@ -270,9 +268,15 @@ class IntegrateHierarchyToFtrack(pyblish.api.ContextPlugin):
                 six.reraise(tp, value, tb)
 
         # Create new links.
-        for input in entity_data.get("inputs", []):
-            input_id = legacy_io.find_one({"_id": input})["data"]["ftrackId"]
-            assetbuild = self.session.get("AssetBuild", input_id)
+        for asset_id in entity_data.get("inputs", []):
+            asset_doc = get_asset_by_id(project_name, asset_id)
+            ftrack_id = None
+            if asset_doc:
+                ftrack_id = asset_doc["data"].get("ftrackId")
+            if not ftrack_id:
+                continue
+
+            assetbuild = self.session.get("AssetBuild", ftrack_id)
             self.log.debug(
                 "Creating link from {0} to {1}".format(
                     assetbuild["name"], entity["name"]

From 07751a929219f64d5514a42c30e0d466afadf345 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 17:37:29 +0200
Subject: [PATCH 0630/1227] hound fixes

---
 .../ftrack/event_handlers_user/action_delete_asset.py        | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py b/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py
index b5b4ec5ac5..6dae3a4ca1 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py
@@ -94,7 +94,7 @@ class DeleteAssetSubset(BaseAction):
             ftrack_id = entity.get("entityId")
             if ftrack_id:
                 ftrack_ids.append(ftrack_id)
-                
+
         if project_in_selection:
             msg = "It is not possible to use this action on project entity."
             self.show_message(event, msg, True)
@@ -149,7 +149,8 @@ class DeleteAssetSubset(BaseAction):
                 continue
 
             ent_path_items = [ent["name"] for ent in entity["link"]]
-            parents = ent_path_items[1:len(ent_path_items)-1:]
+            end_index = len(ent_path_items) - 1
+            parents = ent_path_items[1:end_index:]
             # TODO we should say to user that
             # few of them are missing in avalon
             for av_ent in av_ents_by_name:

From 3d294edf6ef08441e71fdaf56c7b84e339de8a5e Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Tue, 14 Jun 2022 17:55:48 +0200
Subject: [PATCH 0631/1227] Fixed logic and settings, uses webbrowser module

---
 openpype/modules/ftrack/ftrack_module.py      |  3 +
 openpype/modules/ftrack/tray/ftrack_tray.py   | 63 +++++++-----
 .../defaults/system_settings/modules.json     | 15 +--
 .../module_settings/schema_ftrack.json        | 42 +-------
 tools/run_ftrack_eventserver.ps1              | 39 --------
 tools/run_ftrack_eventserver.sh               | 99 -------------------
 6 files changed, 47 insertions(+), 214 deletions(-)
 delete mode 100644 tools/run_ftrack_eventserver.ps1
 delete mode 100644 tools/run_ftrack_eventserver.sh

diff --git a/openpype/modules/ftrack/ftrack_module.py b/openpype/modules/ftrack/ftrack_module.py
index f99e189082..048e5ebfb1 100644
--- a/openpype/modules/ftrack/ftrack_module.py
+++ b/openpype/modules/ftrack/ftrack_module.py
@@ -42,6 +42,9 @@ class FtrackModule(
 
         self.ftrack_url = ftrack_url
 
+        ftrack_open_as_app = ftrack_settings["ftrack_open_as_app"]
+        self.ftrack_open_as_app = ftrack_open_as_app
+
         current_dir = os.path.dirname(os.path.abspath(__file__))
         low_platform = platform.system().lower()
 
diff --git a/openpype/modules/ftrack/tray/ftrack_tray.py b/openpype/modules/ftrack/tray/ftrack_tray.py
index 7ac994e967..065528dcff 100644
--- a/openpype/modules/ftrack/tray/ftrack_tray.py
+++ b/openpype/modules/ftrack/tray/ftrack_tray.py
@@ -1,9 +1,14 @@
+from hashlib import new
+from operator import pos
 import os
 import time
 import datetime
 import threading
 import platform
 import subprocess
+import posixpath, ntpath
+import webbrowser
+import shutil
 from Qt import QtCore, QtWidgets, QtGui
 
 import ftrack_api
@@ -14,7 +19,6 @@ from ..ftrack_module import FTRACK_MODULE_DIR
 from . import login_dialog
 
 from openpype.api import Logger, resources
-from openpype.settings import get_system_settings
 
 
 log = Logger().get_logger("FtrackModule")
@@ -52,29 +56,42 @@ class FtrackTrayWrapper:
         self.widget_login.raise_()
 
     def show_ftrack_browser(self):
-        cur_os = platform.system().lower()
-        settings = get_system_settings()["modules"]["ftrack"]
-        browser_paths = settings["ftrack_browser_path"][cur_os]
-        browser_args = settings["ftrack_browser_arguments"][cur_os]
-        browser_args.append(self.module.ftrack_url)
-        path = ""
-        for p in browser_paths:
-            if os.path.exists(p):
-                path = p
-                log.debug(f"Found valid executable at path: {p}")
-                break
+        env_pf64 = os.environ['ProgramW6432'].replace(
+            ntpath.sep, posixpath.sep)
+        env_pf32 = os.environ['ProgramFiles(x86)'].replace(
+            ntpath.sep, posixpath.sep)
+        env_loc = os.environ['LocalAppData'].replace(
+            ntpath.sep, posixpath.sep)
+        chromium_paths_win = [
+            f"{env_pf64}/Google/Chrome/Application/chrome.exe",
+            f"{env_pf32}/Google/Chrome/Application/chrome.exe",
+            f"{env_loc}/Google/Chrome/Application/chrome.exe",
+            f"{env_pf32}/Microsoft/Edge/Application/msedge.exe"
+        ]
+        cur_os = cur_os = platform.system().lower()
+        if cur_os == "windows":
+            is_chromium = False
+            for p in chromium_paths_win:
+                if os.path.exists(p):
+                    is_chromium = True
+                    chromium_path = p
+                    break
+            if is_chromium and self.module.ftrack_open_as_app:
+                webbrowser.get(f"{chromium_path} %s").open_new(
+                    f"--app={self.module.ftrack_url}")
             else:
-                log.warning(f"Path: {p} is not valid, please \
-                    doublecheck your settings!")
-        if path == "":
-            log.warning("Found no valid executables to launch \
-                Ftrack with. Feature will not work as expected!")
-            return
-        args = " ".join(str(item) for item in browser_args).replace("= ", "=")
-        log.debug(f"Computed arguments: {args}")
-        cmd = f"{path} {args}"
-        log.debug(f"Opening Ftrack Browser...")
-        subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+                webbrowser.get(using="windows-default").open_new(
+                    self.module.ftrack_url)
+        
+        else:
+            if self.module.ftrack_open_as_app:
+                try:
+                    webbrowser.get(using='chrome').open_new(
+                        f"--app={self.module.ftrack_url}")
+                except webbrowser.Error:
+                    webbrowser.open_new(self.module.ftrack_url)
+            else:
+                webbrowser.open_new(self.module.ftrack_url)
 
     def validate(self):
         validation = False
diff --git a/openpype/settings/defaults/system_settings/modules.json b/openpype/settings/defaults/system_settings/modules.json
index aaf01b1631..6d09652bb9 100644
--- a/openpype/settings/defaults/system_settings/modules.json
+++ b/openpype/settings/defaults/system_settings/modules.json
@@ -15,20 +15,7 @@
     "ftrack": {
         "enabled": false,
         "ftrack_server": "",
-        "ftrack_browser_path": {
-            "windows": [
-                "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
-            ],
-            "darwin": [],
-            "linux": []
-        },
-        "ftrack_browser_arguments": {
-            "windows": [
-                "--app="
-            ],
-            "darwin": [],
-            "linux": []
-        },
+        "ftrack_open_as_app": false,
         "ftrack_actions_path": {
             "windows": [],
             "darwin": [],
diff --git a/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json b/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
index 268c5479fe..570d856cf8 100644
--- a/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
+++ b/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
@@ -17,45 +17,9 @@
             "label": "Server"
         },
         {
-            "type": "splitter"
-        },
-        {
-            "type": "path",
-            "key": "ftrack_browser_path",
-            "label": "Browser Path",
-            "use_label_wrap": true,
-            "multipath": true,
-            "multiplatform": true
-        },
-        {
-            "type": "dict",
-            "key": "ftrack_browser_arguments",
-            "label": "Browser Arguments",
-            "use_label_wrap": true,
-            "children": [
-                {
-                    "type": "label",
-                    "label": "Any arguent which is used to open Ftrack URL (as in \"app=\" for chrome) needs to be placed last in the list!"
-                },
-                {
-                    "key": "windows",
-                    "label": "Windows",
-                    "type": "list",
-                    "object_type": "text"
-                },
-                {
-                    "key": "darwin",
-                    "label": "MacOS",
-                    "type": "list",
-                    "object_type": "text"
-                },
-                {
-                    "key": "linux",
-                    "label": "Linux",
-                    "type": "list",
-                    "object_type": "text"
-                }
-            ]
+            "type": "boolean",
+            "key": "ftrack_open_as_app",
+            "label": "Open in app mode"
         },
         {
             "type": "splitter"
diff --git a/tools/run_ftrack_eventserver.ps1 b/tools/run_ftrack_eventserver.ps1
deleted file mode 100644
index 9c22f3d88e..0000000000
--- a/tools/run_ftrack_eventserver.ps1
+++ /dev/null
@@ -1,39 +0,0 @@
-<#
-.SYNOPSIS
-  Helper script to start OpenPype Ftrack EventServer without relying on built executables.
-
-.DESCRIPTION
-
-
-.EXAMPLE
-
-PS> .\run_eventserver.ps1
-
-#>
-$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
-$openpype_root = (Get-Item $script_dir).parent.FullName
-
-$env:_INSIDE_OPENPYPE_TOOL = "1"
-$env:OPENPYPE_DEBUG = "1"
-# $env:OPENPYPE_MONGO = "mongodb://127.0.0.1:27017"
-
-# make sure Poetry is in PATH
-if (-not (Test-Path 'env:POETRY_HOME')) {
-    $env:POETRY_HOME = "$openpype_root\.poetry"
-}
-$env:PATH = "$($env:PATH);$($env:POETRY_HOME)\bin"
-
-Set-Location -Path $openpype_root
-
-Write-Host ">>> " -NoNewline -ForegroundColor Green
-Write-Host "Reading Poetry ... " -NoNewline
-if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
-    Write-Host "NOT FOUND" -ForegroundColor Yellow
-    Write-Host "*** " -NoNewline -ForegroundColor Yellow
-    Write-Host "We need to install Poetry create virtual env first ..."
-    & "$openpype_root\tools\create_env.ps1"
-} else {
-    Write-Host "OK" -ForegroundColor Green
-}
-
-& "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\start.py" eventserver
\ No newline at end of file
diff --git a/tools/run_ftrack_eventserver.sh b/tools/run_ftrack_eventserver.sh
deleted file mode 100644
index 97daa14c2d..0000000000
--- a/tools/run_ftrack_eventserver.sh
+++ /dev/null
@@ -1,99 +0,0 @@
-#!/usr/bin/env bash
-
-art () {
-  cat <<-EOF
-
-             . .   ..     .    ..
-        _oOOP3OPP3Op_. .
-     .PPpo~·   ··   ~2p.  ··  ····  ·  ·
-    ·Ppo · .pPO3Op.· · O:· · · ·
-   .3Pp · oP3'· 'P33· · 4 ··   ·  ·   · ·· ·  ·  ·
-  ·~OP    3PO·  .Op3    : · ··  _____  _____  _____
-  ·P3O  · oP3oP3O3P' · · ·   · /    /·/    /·/    /
-   O3:·   O3p~ ·       ·:· · ·/____/·/____/ /____/
-   'P ·   3p3·  oP3~· ·.P:· ·  · ··  ·   · ·· ·  ·  ·
-  · ':  · Po'  ·Opo'· .3O· .  o[ by Pype Club ]]]==- - - ·  ·
-    · '_ ..  ·    . _OP3··  ·  ·https://openpype.io·· ·
-         ~P3·OPPPO3OP~ · ··  ·
-           ·  ' '· ·  ·· · · · ··  ·
-
-EOF
-}
-
-# Colors for terminal
-
-RST='\033[0m'             # Text Reset
-
-# Regular Colors
-Black='\033[0;30m'        # Black
-Red='\033[0;31m'          # Red
-Green='\033[0;32m'        # Green
-Yellow='\033[0;33m'       # Yellow
-Blue='\033[0;34m'         # Blue
-Purple='\033[0;35m'       # Purple
-Cyan='\033[0;36m'         # Cyan
-White='\033[0;37m'        # White
-
-# Bold
-BBlack='\033[1;30m'       # Black
-BRed='\033[1;31m'         # Red
-BGreen='\033[1;32m'       # Green
-BYellow='\033[1;33m'      # Yellow
-BBlue='\033[1;34m'        # Blue
-BPurple='\033[1;35m'      # Purple
-BCyan='\033[1;36m'        # Cyan
-BWhite='\033[1;37m'       # White
-
-# Bold High Intensity
-BIBlack='\033[1;90m'      # Black
-BIRed='\033[1;91m'        # Red
-BIGreen='\033[1;92m'      # Green
-BIYellow='\033[1;93m'     # Yellow
-BIBlue='\033[1;94m'       # Blue
-BIPurple='\033[1;95m'     # Purple
-BICyan='\033[1;96m'       # Cyan
-BIWhite='\033[1;97m'      # White
-
-
-##############################################################################
-# Return absolute path
-# Globals:
-#   None
-# Arguments:
-#   Path to resolve
-# Returns:
-#   None
-###############################################################################
-realpath () {
-  echo $(cd $(dirname "$1"); pwd)/$(basename "$1")
-}
-
-# Main
-main () {
-  echo -e "${BGreen}"
-  art
-  echo -e "${RST}"
-
-  # Directories
-  openpype_root=$(realpath $(dirname $(dirname "${BASH_SOURCE[0]}")))
-
-  if [[ -z $POETRY_HOME ]]; then
-    export POETRY_HOME="$openpype_root/.poetry"
-  fi
-
-  echo -e "${BIGreen}>>>${RST} Reading Poetry ... \c"
-  if [ -f "$POETRY_HOME/bin/poetry" ]; then
-    echo -e "${BIGreen}OK${RST}"
-  else
-    echo -e "${BIYellow}NOT FOUND${RST}"
-    echo -e "${BIYellow}***${RST} We need to install Poetry and virtual env ..."
-    . "$openpype_root/tools/create_env.sh" || { echo -e "${BIRed}!!!${RST} Poetry installation failed"; return; }
-  fi
-
-  pushd "$openpype_root" > /dev/null || return > /dev/null
-
-  echo -e "${BIGreen}>>>${RST} Running Ftrack Eventserver ..."
-  "$POETRY_HOME/bin/poetry" run python $openpype_root/start.py eventserver
-}
-
-main

From bf8b64ae3067224d56c986fd2ca3a00ea8943624 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 17:56:21 +0200
Subject: [PATCH 0632/1227] use query functions in TVPaint

---
 openpype/hosts/tvpaint/api/pipeline.py            | 15 ++++++++-------
 .../hosts/tvpaint/plugins/load/load_workfile.py   | 13 +++++--------
 .../tvpaint/plugins/publish/collect_instances.py  | 11 +++++------
 .../plugins/publish/collect_scene_render.py       | 11 ++++-------
 .../tvpaint/plugins/publish/collect_workfile.py   | 11 +++++------
 5 files changed, 27 insertions(+), 34 deletions(-)

diff --git a/openpype/hosts/tvpaint/api/pipeline.py b/openpype/hosts/tvpaint/api/pipeline.py
index 60c61a8cbf..0118c0104b 100644
--- a/openpype/hosts/tvpaint/api/pipeline.py
+++ b/openpype/hosts/tvpaint/api/pipeline.py
@@ -8,6 +8,7 @@ import requests
 
 import pyblish.api
 
+from openpype.client import get_project, get_asset_by_name
 from openpype.hosts import tvpaint
 from openpype.api import get_current_project_settings
 from openpype.lib import register_event_callback
@@ -442,14 +443,14 @@ def set_context_settings(asset_doc=None):
 
     Change fps, resolution and frame start/end.
     """
-    if asset_doc is None:
-        # Use current session asset if not passed
-        asset_doc = legacy_io.find_one({
-            "type": "asset",
-            "name": legacy_io.Session["AVALON_ASSET"]
-        })
 
-    project_doc = legacy_io.find_one({"type": "project"})
+    project_name = legacy_io.active_project()
+    if asset_doc is None:
+        asset_name = legacy_io.Session["AVALON_ASSET"]
+        # Use current session asset if not passed
+        asset_doc = get_asset_by_name(project_name, asset_name)
+
+    project_doc = get_project(project_name)
 
     framerate = asset_doc["data"].get("fps")
     if framerate is None:
diff --git a/openpype/hosts/tvpaint/plugins/load/load_workfile.py b/openpype/hosts/tvpaint/plugins/load/load_workfile.py
index 0eab083c22..462f12abf0 100644
--- a/openpype/hosts/tvpaint/plugins/load/load_workfile.py
+++ b/openpype/hosts/tvpaint/plugins/load/load_workfile.py
@@ -1,5 +1,6 @@
 import os
 
+from openpype.client import get_project, get_asset_by_name
 from openpype.lib import (
     StringTemplate,
     get_workfile_template_key_from_context,
@@ -44,21 +45,17 @@ class LoadWorkfile(plugin.Loader):
 
         # Save workfile.
         host_name = "tvpaint"
+        project_name = context.get("project")
         asset_name = context.get("asset")
         task_name = context.get("task")
         # Far cases when there is workfile without context
         if not asset_name:
+            project_name = legacy_io.active_project()
             asset_name = legacy_io.Session["AVALON_ASSET"]
             task_name = legacy_io.Session["AVALON_TASK"]
 
-        project_doc = legacy_io.find_one({
-            "type": "project"
-        })
-        asset_doc = legacy_io.find_one({
-            "type": "asset",
-            "name": asset_name
-        })
-        project_name = project_doc["name"]
+        project_doc = get_project(project_name)
+        asset_doc = get_asset_by_name(project_name, asset_name)
 
         template_key = get_workfile_template_key_from_context(
             asset_name,
diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_instances.py b/openpype/hosts/tvpaint/plugins/publish/collect_instances.py
index 782907b65d..9b6d5c4879 100644
--- a/openpype/hosts/tvpaint/plugins/publish/collect_instances.py
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_instances.py
@@ -2,6 +2,7 @@ import json
 import copy
 import pyblish.api
 
+from openpype.client import get_asset_by_name
 from openpype.lib import get_subset_name_with_asset_doc
 from openpype.pipeline import legacy_io
 
@@ -92,17 +93,15 @@ class CollectInstances(pyblish.api.ContextPlugin):
             if family == "review":
                 # Change subset name of review instance
 
+                # Project name from workfile context
+                project_name = context.data["workfile_context"]["project"]
+
                 # Collect asset doc to get asset id
                 # - not sure if it's good idea to require asset id in
                 #   get_subset_name?
                 asset_name = context.data["workfile_context"]["asset"]
-                asset_doc = legacy_io.find_one({
-                    "type": "asset",
-                    "name": asset_name
-                })
+                asset_doc = get_asset_by_name(project_name, asset_name)
 
-                # Project name from workfile context
-                project_name = context.data["workfile_context"]["project"]
                 # Host name from environment variable
                 host_name = context.data["hostName"]
                 # Use empty variant value
diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
index 2b8dbdc5b4..20c5bb586a 100644
--- a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
@@ -2,8 +2,8 @@ import json
 import copy
 import pyblish.api
 
+from openpype.client import get_asset_by_name
 from openpype.lib import get_subset_name_with_asset_doc
-from openpype.pipeline import legacy_io
 
 
 class CollectRenderScene(pyblish.api.ContextPlugin):
@@ -56,14 +56,11 @@ class CollectRenderScene(pyblish.api.ContextPlugin):
         # - not sure if it's good idea to require asset id in
         #   get_subset_name?
         workfile_context = context.data["workfile_context"]
-        asset_name = workfile_context["asset"]
-        asset_doc = legacy_io.find_one({
-            "type": "asset",
-            "name": asset_name
-        })
-
         # Project name from workfile context
         project_name = context.data["workfile_context"]["project"]
+        asset_name = workfile_context["asset"]
+        asset_doc = get_asset_by_name(project_name, asset_name)
+
         # Host name from environment variable
         host_name = context.data["hostName"]
         # Variant is using render pass name
diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_workfile.py b/openpype/hosts/tvpaint/plugins/publish/collect_workfile.py
index 70d92f82e9..88c5f4dbc7 100644
--- a/openpype/hosts/tvpaint/plugins/publish/collect_workfile.py
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_workfile.py
@@ -2,6 +2,7 @@ import os
 import json
 import pyblish.api
 
+from openpype.client import get_asset_by_name
 from openpype.lib import get_subset_name_with_asset_doc
 from openpype.pipeline import legacy_io
 
@@ -22,19 +23,17 @@ class CollectWorkfile(pyblish.api.ContextPlugin):
         basename, ext = os.path.splitext(filename)
         instance = context.create_instance(name=basename)
 
+        # Project name from workfile context
+        project_name = context.data["workfile_context"]["project"]
+
         # Get subset name of workfile instance
         # Collect asset doc to get asset id
         # - not sure if it's good idea to require asset id in
         #   get_subset_name?
         family = "workfile"
         asset_name = context.data["workfile_context"]["asset"]
-        asset_doc = legacy_io.find_one({
-            "type": "asset",
-            "name": asset_name
-        })
+        asset_doc = get_asset_by_name(project_name, asset_name)
 
-        # Project name from workfile context
-        project_name = context.data["workfile_context"]["project"]
         # Host name from environment variable
         host_name = os.environ["AVALON_APP"]
         # Use empty variant value

From 6a4387a866d52e027d74805a54fe4f8a43004c38 Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Tue, 14 Jun 2022 17:58:56 +0200
Subject: [PATCH 0633/1227] finxed hounds

---
 openpype/modules/ftrack/tray/ftrack_tray.py | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/openpype/modules/ftrack/tray/ftrack_tray.py b/openpype/modules/ftrack/tray/ftrack_tray.py
index 065528dcff..70f6e69323 100644
--- a/openpype/modules/ftrack/tray/ftrack_tray.py
+++ b/openpype/modules/ftrack/tray/ftrack_tray.py
@@ -1,14 +1,12 @@
-from hashlib import new
-from operator import pos
 import os
 import time
 import datetime
 import threading
 import platform
-import subprocess
-import posixpath, ntpath
+import posixpath
+import ntpath
 import webbrowser
-import shutil
+
 from Qt import QtCore, QtWidgets, QtGui
 
 import ftrack_api
@@ -82,7 +80,7 @@ class FtrackTrayWrapper:
             else:
                 webbrowser.get(using="windows-default").open_new(
                     self.module.ftrack_url)
-        
+
         else:
             if self.module.ftrack_open_as_app:
                 try:

From 780ffefea972a3fb1b0c225136c1327878b95a91 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 14 Jun 2022 18:08:28 +0200
Subject: [PATCH 0634/1227] fix unhandled empty source on instance

---
 openpype/plugins/publish/integrate_new.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 91f6102501..2471105250 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -940,9 +940,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         families += current_families
 
         # create relative source path for DB
-        if "source" in instance.data:
-            source = instance.data["source"]
-        else:
+        source = instance.data.get("source")
+        if not source:
             source = context.data["currentFile"]
             anatomy = instance.context.data["anatomy"]
             source = self.get_rootless_path(anatomy, source)

From e98f81c70c4d8054f3cd2b8ef4ce6e0e1b7b11ba Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Tue, 14 Jun 2022 19:17:54 +0200
Subject: [PATCH 0635/1227] made the browser opening non blocking

---
 openpype/modules/ftrack/tray/ftrack_tray.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/modules/ftrack/tray/ftrack_tray.py b/openpype/modules/ftrack/tray/ftrack_tray.py
index 70f6e69323..e822fd4639 100644
--- a/openpype/modules/ftrack/tray/ftrack_tray.py
+++ b/openpype/modules/ftrack/tray/ftrack_tray.py
@@ -90,6 +90,7 @@ class FtrackTrayWrapper:
                     webbrowser.open_new(self.module.ftrack_url)
             else:
                 webbrowser.open_new(self.module.ftrack_url)
+        return
 
     def validate(self):
         validation = False

From ae9064ac5960b602c324b8d7aa6105725f4b70ea Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Wed, 15 Jun 2022 03:56:39 +0000
Subject: [PATCH 0636/1227] [Automated] Bump version

---
 CHANGELOG.md        | 39 ++++++++++++++++++---------------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 20 insertions(+), 23 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d0d25908cd..eb71071205 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## [3.11.0-nightly.2](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.11.0-nightly.3](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.10.0...HEAD)
 
@@ -11,7 +11,9 @@
 
 **🚀 Enhancements**
 
+- Settings: Settings can be extracted from UI [\#3323](https://github.com/pypeclub/OpenPype/pull/3323)
 - updated poetry installation source [\#3316](https://github.com/pypeclub/OpenPype/pull/3316)
+- Ftrack: Action to easily create daily review session [\#3310](https://github.com/pypeclub/OpenPype/pull/3310)
 - TVPaint: Extractor use mark in/out range to render [\#3309](https://github.com/pypeclub/OpenPype/pull/3309)
 - Ftrack: Delivery action can work on ReviewSessions [\#3307](https://github.com/pypeclub/OpenPype/pull/3307)
 - Maya: Look assigner UI improvements [\#3298](https://github.com/pypeclub/OpenPype/pull/3298)
@@ -20,15 +22,18 @@
 - General: Updated windows oiio tool [\#3268](https://github.com/pypeclub/OpenPype/pull/3268)
 - Unreal: add support for skeletalMesh and staticMesh to loaders [\#3267](https://github.com/pypeclub/OpenPype/pull/3267)
 - Maya: reference loaders could store placeholder in referenced url [\#3264](https://github.com/pypeclub/OpenPype/pull/3264)
+- Maya: FBX camera export [\#3253](https://github.com/pypeclub/OpenPype/pull/3253)
 - TVPaint: Init file for TVPaint worker also handle guideline images [\#3250](https://github.com/pypeclub/OpenPype/pull/3250)
 - Nuke: Change default icon path in settings [\#3247](https://github.com/pypeclub/OpenPype/pull/3247)
 - Maya: publishing of animation and pointcache on a farm [\#3225](https://github.com/pypeclub/OpenPype/pull/3225)
 - Maya: Look assigner UI improvements [\#3208](https://github.com/pypeclub/OpenPype/pull/3208)
-- Nuke: add pointcache and animation to loader [\#3186](https://github.com/pypeclub/OpenPype/pull/3186)
 
 **🐛 Bug fixes**
 
+- General: Handle empty source key on instance [\#3342](https://github.com/pypeclub/OpenPype/pull/3342)
 - Houdini: Fix Houdini VDB manage update wrong file attribute name [\#3322](https://github.com/pypeclub/OpenPype/pull/3322)
+- Nuke: anatomy compatibility issue hacks [\#3321](https://github.com/pypeclub/OpenPype/pull/3321)
+- hiero: otio p3 compatibility issue - metadata on effect use update 3.11 [\#3314](https://github.com/pypeclub/OpenPype/pull/3314)
 - General: Vendorized modules for Python 2 and update poetry lock [\#3305](https://github.com/pypeclub/OpenPype/pull/3305)
 - Fix - added local targets to install host [\#3303](https://github.com/pypeclub/OpenPype/pull/3303)
 - Settings: Add missing default settings for nuke gizmo [\#3301](https://github.com/pypeclub/OpenPype/pull/3301)
@@ -38,18 +43,24 @@
 - Webpublisher: return only active projects in ProjectsEndpoint [\#3281](https://github.com/pypeclub/OpenPype/pull/3281)
 - Hiero: add support for task tags 3.10.x [\#3279](https://github.com/pypeclub/OpenPype/pull/3279)
 - General: Fix Oiio tool path resolving [\#3278](https://github.com/pypeclub/OpenPype/pull/3278)
-- Maya: Fix udim support for e.g. uppercase \<UDIM\> tag [\#3266](https://github.com/pypeclub/OpenPype/pull/3266)
 - Nuke: bake reformat was failing on string type [\#3261](https://github.com/pypeclub/OpenPype/pull/3261)
 - Maya: hotfix Pxr multitexture in looks [\#3260](https://github.com/pypeclub/OpenPype/pull/3260)
-- Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
 - Unreal: Fixed Animation loading in UE5 [\#3240](https://github.com/pypeclub/OpenPype/pull/3240)
 - Unreal: Fixed Render creation in UE5 [\#3239](https://github.com/pypeclub/OpenPype/pull/3239)
 - Unreal: Fixed Camera loading in UE5 [\#3238](https://github.com/pypeclub/OpenPype/pull/3238)
+- TVPaint: Look for more groups than 12 [\#3228](https://github.com/pypeclub/OpenPype/pull/3228)
 - Flame: debugging [\#3224](https://github.com/pypeclub/OpenPype/pull/3224)
 
+**🔀 Refactored code**
+
+- Blender: Use client query functions [\#3331](https://github.com/pypeclub/OpenPype/pull/3331)
+- General: Define query functions [\#3288](https://github.com/pypeclub/OpenPype/pull/3288)
+
 **Merged pull requests:**
 
 - Maya: add pointcache family to gpu cache loader [\#3318](https://github.com/pypeclub/OpenPype/pull/3318)
+- Maya look: skip empty file attributes [\#3274](https://github.com/pypeclub/OpenPype/pull/3274)
+- Harmony: message length in 21.1 [\#3258](https://github.com/pypeclub/OpenPype/pull/3258)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
@@ -57,32 +68,26 @@
 
 **🚀 Enhancements**
 
-- Maya: FBX camera export [\#3253](https://github.com/pypeclub/OpenPype/pull/3253)
+- TVPaint: Init file for TVPaint worker also handle guideline images [\#3251](https://github.com/pypeclub/OpenPype/pull/3251)
 - General: updating common vendor `scriptmenu` to 1.5.2 [\#3246](https://github.com/pypeclub/OpenPype/pull/3246)
 - Project Manager: Allow to paste Tasks into multiple assets at the same time [\#3226](https://github.com/pypeclub/OpenPype/pull/3226)
 - Project manager: Sped up project load [\#3216](https://github.com/pypeclub/OpenPype/pull/3216)
-- Loader UI: Speed issues of loader with sync server [\#3199](https://github.com/pypeclub/OpenPype/pull/3199)
 
 **🐛 Bug fixes**
 
+- Maya: Fix udim support for e.g. uppercase \<UDIM\> tag [\#3266](https://github.com/pypeclub/OpenPype/pull/3266)
+- Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
 - nuke: use framerange issue [\#3254](https://github.com/pypeclub/OpenPype/pull/3254)
 - Ftrack: Chunk sizes for queries has minimal condition [\#3244](https://github.com/pypeclub/OpenPype/pull/3244)
 - Maya: renderman displays needs to be filtered [\#3242](https://github.com/pypeclub/OpenPype/pull/3242)
 - Ftrack: Validate that the user exists on ftrack [\#3237](https://github.com/pypeclub/OpenPype/pull/3237)
 - Maya: Fix support for multiple resolutions [\#3236](https://github.com/pypeclub/OpenPype/pull/3236)
-- TVPaint: Look for more groups than 12 [\#3228](https://github.com/pypeclub/OpenPype/pull/3228)
 - Hiero: debugging frame range and other 3.10 [\#3222](https://github.com/pypeclub/OpenPype/pull/3222)
 - Project Manager: Fix persistent editors on project change [\#3218](https://github.com/pypeclub/OpenPype/pull/3218)
 - Deadline: instance data overwrite fix [\#3214](https://github.com/pypeclub/OpenPype/pull/3214)
 - Ftrack: Push hierarchical attributes action works [\#3210](https://github.com/pypeclub/OpenPype/pull/3210)
 - Standalone Publisher: Always create new representation for thumbnail [\#3203](https://github.com/pypeclub/OpenPype/pull/3203)
 - Photoshop: skip collector when automatic testing [\#3202](https://github.com/pypeclub/OpenPype/pull/3202)
-- Nuke: render/workfile version sync doesn't work on farm [\#3185](https://github.com/pypeclub/OpenPype/pull/3185)
-- Ftrack: Review image only if there are no mp4 reviews [\#3183](https://github.com/pypeclub/OpenPype/pull/3183)
-
-**🔀 Refactored code**
-
-- Avalon repo removed from Jobs workflow [\#3193](https://github.com/pypeclub/OpenPype/pull/3193)
 
 **Merged pull requests:**
 
@@ -98,18 +103,10 @@
 
 - nuke: generate publishing nodes inside render group node  [\#3206](https://github.com/pypeclub/OpenPype/pull/3206)
 - Loader UI: Speed issues of loader with sync server [\#3200](https://github.com/pypeclub/OpenPype/pull/3200)
-- Backport of fix for attaching renders to subsets [\#3195](https://github.com/pypeclub/OpenPype/pull/3195)
-- Looks: add basic support for Renderman [\#3190](https://github.com/pypeclub/OpenPype/pull/3190)
 
 **🐛 Bug fixes**
 
 - Standalone Publisher: Always create new representation for thumbnail [\#3204](https://github.com/pypeclub/OpenPype/pull/3204)
-- Nuke: render/workfile version sync doesn't work on farm  [\#3184](https://github.com/pypeclub/OpenPype/pull/3184)
-- Ftrack: Review image only if there are no mp4 reviews [\#3182](https://github.com/pypeclub/OpenPype/pull/3182)
-
-**Merged pull requests:**
-
-- hiero: otio p3 compatibility issue - metadata on effect use update  [\#3194](https://github.com/pypeclub/OpenPype/pull/3194)
 
 ## [3.9.7](https://github.com/pypeclub/OpenPype/tree/3.9.7) (2022-05-11)
 
diff --git a/openpype/version.py b/openpype/version.py
index 4b0a688cbf..2f4d180983 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.11.0-nightly.2"
+__version__ = "3.11.0-nightly.3"
diff --git a/pyproject.toml b/pyproject.toml
index 4289c74ebe..e1b5c37289 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.11.0-nightly.2" # OpenPype
+version = "3.11.0-nightly.3" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 180fd1f843b9a7d7fa9046964c1f155b17412c94 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Wed, 15 Jun 2022 13:40:57 +0900
Subject: [PATCH 0637/1227] We want to strip namespaces by default for mvUsd.

---
 openpype/hosts/maya/plugins/create/create_multiverse_usd.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
index 034714d51b..adf0acc7c2 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
@@ -16,7 +16,7 @@ class CreateMultiverseUsd(plugin.Creator):
         self.data.update(lib.collect_animation_data(True))
 
         self.data["fileFormat"] = ["usd", "usda", "usdz"]
-        self.data["stripNamespaces"] = False
+        self.data["stripNamespaces"] = True
         self.data["mergeTransformAndShape"] = False
         self.data["writeAncestors"] = True
         self.data["flattenParentXforms"] = False

From 5af098d18afc6156165964fcd696e35afd0bf6be Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Wed, 15 Jun 2022 16:14:39 +0900
Subject: [PATCH 0638/1227] Adding Options to the main Studio Settings.

---
 .../defaults/project_settings/maya.json       |  8 ++++
 .../schemas/schema_maya_create.json           | 38 +++++++++++++++++++
 2 files changed, 46 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 4cdfe1ca5d..aaf47479b8 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -159,6 +159,14 @@
             "defaults": [
                 "Main"
             ]
+        },
+        "CreateMultiverseLook": {
+            "enabled": true,
+            "publish_mip_map": true
+        },
+        "CreateMultiverseUsd": {
+            "enabled": true,
+            "strip_namespaces": true
         }
     },
     "publish": {
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_create.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_create.json
index 6dc10ed2a5..4dd54c81a0 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_create.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_create.json
@@ -124,6 +124,44 @@
             ]
 
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "CreateMultiverseLook",
+            "label": "Create Multiverse Look",
+            "checkbox_key": "enabled",
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                },
+                {
+                    "type": "boolean",
+                    "key": "publish_mip_map",
+                    "label": "Publish Mip Maps"
+                }
+            ]
+        },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "CreateMultiverseUsd",
+            "label": "Create Multiverse USD",
+            "checkbox_key": "enabled",
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                },
+                {
+                    "type": "boolean",
+                    "key": "strip_namespaces",
+                    "label": "Strip Namespaces"
+                }
+            ]
+        },
         {
             "type": "schema_template",
             "name": "template_create_plugin",

From c14b8323dbc40cc4bf41712c52642e75ae391546 Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Fri, 6 May 2022 17:06:32 +0200
Subject: [PATCH 0639/1227] Add menu quad in hiero

---
 .../defaults/project_settings/hiero.json      | 32 +++++++++++++++++++
 .../projects_schema/schema_project_hiero.json |  4 +++
 .../common/scriptsmenu/launchfornuke.py       |  2 +-
 3 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/hiero.json b/openpype/settings/defaults/project_settings/hiero.json
index 1dff3aac51..eb75aff6c0 100644
--- a/openpype/settings/defaults/project_settings/hiero.json
+++ b/openpype/settings/defaults/project_settings/hiero.json
@@ -1,4 +1,36 @@
 {
+    "ext_mapping": {
+        "model": "hrox",
+        "mayaAscii": "hrox",
+        "camera": "hrox",
+        "rig": "hrox",
+        "workfile": "hrox",
+        "yetiRig": "hrox"
+    },
+    "heiro-dirmap": {
+        "enabled": false,
+        "paths": {
+            "source-path": [],
+            "destination-path": []
+        }
+    },
+    "scriptsmenu": {
+        "name": "OpenPype Tools",
+        "definition": [
+            {
+                "type": "action",
+                "command": "import openpype.hosts.hiero.api.commands as hiero; hiero.edit_shader_definitions()",
+                "sourcetype": "python",
+                "title": "Edit shader name definitions",
+                "tooltip": "Edit shader name definitions used in validation and renaming.",
+                "tags": [
+                    "pipeline",
+                    "shader"
+                ]
+            }
+        ]
+    },
+
     "create": {
         "CreateShotClip": {
             "hierarchy": "{folder}/{sequence}",
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_hiero.json b/openpype/settings/entities/schemas/projects_schema/schema_project_hiero.json
index f717eff7dd..39721c641a 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_hiero.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_hiero.json
@@ -206,6 +206,10 @@
         {
             "type": "schema",
             "name": "schema_publish_gui_filter"
+        },
+        {
+            "type": "schema",
+            "name": "schema_maya_scriptsmenu"
         }
     ]
 }
diff --git a/openpype/vendor/python/common/scriptsmenu/launchfornuke.py b/openpype/vendor/python/common/scriptsmenu/launchfornuke.py
index 72302a79a6..4f65a8e3ae 100644
--- a/openpype/vendor/python/common/scriptsmenu/launchfornuke.py
+++ b/openpype/vendor/python/common/scriptsmenu/launchfornuke.py
@@ -6,7 +6,7 @@ def _nuke_main_window():
     """Return Nuke's main window"""
     for obj in QtWidgets.QApplication.topLevelWidgets():
         if (obj.inherits('QMainWindow') and
-                    obj.metaObject().className() == 'Foundry::UI::DockMainWindow'):
+                obj.metaObject().className() == 'Foundry::UI::DockMainWindow'):
             return obj
     raise RuntimeError('Could not find Nuke MainWindow instance')
 

From 174c04a7f26dbe3c41c8c459222f97135fb4268d Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Fri, 6 May 2022 17:16:12 +0200
Subject: [PATCH 0640/1227] menu hiero

---
 .../common/scriptsmenu/launchforhiero.py      | 84 +++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 openpype/vendor/python/common/scriptsmenu/launchforhiero.py

diff --git a/openpype/vendor/python/common/scriptsmenu/launchforhiero.py b/openpype/vendor/python/common/scriptsmenu/launchforhiero.py
new file mode 100644
index 0000000000..8c3aa35126
--- /dev/null
+++ b/openpype/vendor/python/common/scriptsmenu/launchforhiero.py
@@ -0,0 +1,84 @@
+import logging
+
+import scriptsmenu
+from .vendor.Qt import QtWidgets
+
+log = logging.getLogger(__name__)
+
+
+def _hiero_main_window():
+    """Return Nuke's main window"""
+    for obj in QtWidgets.QApplication.topLevelWidgets():
+        if (obj.inherits('QMainWindow') and
+                obj.metaObject().className() == 'Foundry::UI::DockMainWindow'):
+            return obj
+    raise RuntimeError('Could not find HieroWindow instance')
+
+
+def _hiero_main_menubar():
+    """Retrieve the main menubar of the Nuke window"""
+    hiero_window = _hiero_main_window()
+    menubar = [i for i in hiero_window.children() if isinstance(
+        i,
+        QtWidgets.QMenuBar
+    )]
+
+    assert len(menubar) == 1, "Error, could not find menu bar!"
+    return menubar[0]
+
+
+def find_scripts_menu(title, parent):
+    """
+    Check if the menu exists with the given title in the parent
+
+    Args:
+        title (str): the title name of the scripts menu
+
+        parent (QtWidgets.QMenuBar): the menubar to check
+
+    Returns:
+        QtWidgets.QMenu or None
+
+    """
+
+    menu = None
+    search = [i for i in parent.children() if
+              isinstance(i, scriptsmenu.ScriptsMenu)
+              and i.title() == title]
+    if search:
+        assert len(search) < 2, ("Multiple instances of menu '{}' "
+                                 "in menu bar".format(title))
+        menu = search[0]
+
+    return menu
+
+
+def main(title="Scripts", parent=None, objectName=None):
+    """Build the main scripts menu in Maya
+
+    Args:
+        title (str): name of the menu in the application
+
+        parent (QtWidgets.QtMenuBar): the parent object for the menu
+
+        objectName (str): custom objectName for scripts menu
+
+    Returns:
+        scriptsmenu.ScriptsMenu instance
+
+    """
+    hieromainbar = parent or _hiero_main_menubar()
+    try:
+        # check menu already exists
+        menu = find_scripts_menu(title, hieromainbar)
+        if not menu:
+            log.info("Attempting to build menu ...")
+            object_name = objectName or title.lower()
+            menu = scriptsmenu.ScriptsMenu(title=title,
+                                           parent=hieromainbar,
+                                           objectName=object_name)
+    except Exception as e:
+        log.error(e)
+        return
+
+    return menu

From 3ea514f029085653a104b37dcae8b6d2cd6bf9cc Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Mon, 23 May 2022 15:11:56 +0200
Subject: [PATCH 0641/1227]  add script menu

---
 openpype/hosts/hiero/api/menu.py | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/openpype/hosts/hiero/api/menu.py b/openpype/hosts/hiero/api/menu.py
index e262abec00..d4e62c9e8a 100644
--- a/openpype/hosts/hiero/api/menu.py
+++ b/openpype/hosts/hiero/api/menu.py
@@ -9,6 +9,7 @@ from openpype.pipeline import legacy_io
 from openpype.tools.utils import host_tools
 
 from . import tags
+from openpype.settings import get_project_settings
 
 log = Logger.get_logger(__name__)
 
@@ -41,6 +42,7 @@ def menu_install():
     Installing menu into Hiero
 
     """
+    print("YOLOOOOOOOOOOOOOOOOOO")
     from Qt import QtGui
     from . import (
         publish, launch_workfiles_app, reload_config,
@@ -138,3 +140,32 @@ def menu_install():
     exeprimental_action.triggered.connect(
         lambda: host_tools.show_experimental_tools_dialog(parent=main_window)
     )
+
+
+def add_scripts_menu():
+    try:
+        from scriptsmenu import launchforhiero
+    except ImportError:
+        log.warning(
+            "Skipping studio.menu install, because "
+            "'scriptsmenu' module seems unavailable."
+        )
+        return
+
+    # load configuration of custom menu
+    project_settings = get_project_settings(os.getenv("AVALON_PROJECT"))
+    config = project_settings["hiero"]["scriptsmenu"]["definition"]
+    _menu = project_settings["hiero"]["scriptsmenu"]["name"]
+
+    if not config:
+        log.warning("Skipping studio menu, no definition found.")
+        return
+
+    # run the launcher for Maya menu
+    studio_menu = launchforhiero.main(title=_menu.title())
+
+    # apply configuration
+    studio_menu.build_from_configuration(studio_menu, config)
+
+
+add_scripts_menu()

From 4c9cd18f1cce331d4e434c531775450cab5b0b71 Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Mon, 23 May 2022 15:13:36 +0200
Subject: [PATCH 0642/1227] clen print

---
 openpype/hosts/hiero/api/menu.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/hiero/api/menu.py b/openpype/hosts/hiero/api/menu.py
index d4e62c9e8a..9e999da2f6 100644
--- a/openpype/hosts/hiero/api/menu.py
+++ b/openpype/hosts/hiero/api/menu.py
@@ -42,7 +42,7 @@ def menu_install():
     Installing menu into Hiero
 
     """
-    print("YOLOOOOOOOOOOOOOOOOOO")
+
     from Qt import QtGui
     from . import (
         publish, launch_workfiles_app, reload_config,

From 0e3607805925eaa1fc7ad9bc0e17f0144081a71d Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Mon, 23 May 2022 15:47:29 +0200
Subject: [PATCH 0643/1227] nothing change

---
 openpype/settings/defaults/project_settings/hiero.json      | 2 +-
 openpype/vendor/python/common/scriptsmenu/launchforhiero.py | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/hiero.json b/openpype/settings/defaults/project_settings/hiero.json
index eb75aff6c0..cec4bca8fd 100644
--- a/openpype/settings/defaults/project_settings/hiero.json
+++ b/openpype/settings/defaults/project_settings/hiero.json
@@ -7,7 +7,7 @@
         "workfile": "hrox",
         "yetiRig": "hrox"
     },
-    "heiro-dirmap": {
+    "hiero-dirmap": {
         "enabled": false,
         "paths": {
             "source-path": [],
diff --git a/openpype/vendor/python/common/scriptsmenu/launchforhiero.py b/openpype/vendor/python/common/scriptsmenu/launchforhiero.py
index 8c3aa35126..3f8e726083 100644
--- a/openpype/vendor/python/common/scriptsmenu/launchforhiero.py
+++ b/openpype/vendor/python/common/scriptsmenu/launchforhiero.py
@@ -7,6 +7,7 @@ log = logging.getLogger(__name__)
 
 
 def _hiero_main_window():
+    print("YEAAAAAAAAAAAAAAAAAAAH")
     """Return Nuke's main window"""
     for obj in QtWidgets.QApplication.topLevelWidgets():
         if (obj.inherits('QMainWindow') and

From 6ee781c8a6b4701f6166a877eda4e43b9a76e454 Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Tue, 7 Jun 2022 17:00:53 +0200
Subject: [PATCH 0644/1227] change launcher for api folder

---
 openpype/hosts/hiero/api/launchforhiero.py | 85 ++++++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 openpype/hosts/hiero/api/launchforhiero.py

diff --git a/openpype/hosts/hiero/api/launchforhiero.py b/openpype/hosts/hiero/api/launchforhiero.py
new file mode 100644
index 0000000000..3f8e726083
--- /dev/null
+++ b/openpype/hosts/hiero/api/launchforhiero.py
@@ -0,0 +1,85 @@
+import logging
+
+import scriptsmenu
+from .vendor.Qt import QtWidgets
+
+log = logging.getLogger(__name__)
+
+
+def _hiero_main_window():
+    print("YEAAAAAAAAAAAAAAAAAAAH")
+    """Return Nuke's main window"""
+    for obj in QtWidgets.QApplication.topLevelWidgets():
+        if (obj.inherits('QMainWindow') and
+                obj.metaObject().className() == 'Foundry::UI::DockMainWindow'):
+            return obj
+    raise RuntimeError('Could not find HieroWindow instance')
+
+
+def _hiero_main_menubar():
+    """Retrieve the main menubar of the Nuke window"""
+    hiero_window = _hiero_main_window()
+    menubar = [i for i in hiero_window.children() if isinstance(
+        i,
+        QtWidgets.QMenuBar
+    )]
+
+    assert len(menubar) == 1, "Error, could not find menu bar!"
+    return menubar[0]
+
+
+def find_scripts_menu(title, parent):
+    """
+    Check if the menu exists with the given title in the parent
+
+    Args:
+        title (str): the title name of the scripts menu
+
+        parent (QtWidgets.QMenuBar): the menubar to check
+
+    Returns:
+        QtWidgets.QMenu or None
+
+    """
+
+    menu = None
+    search = [i for i in parent.children() if
+              isinstance(i, scriptsmenu.ScriptsMenu)
+              and i.title() == title]
+    if search:
+        assert len(search) < 2, ("Multiple instances of menu '{}' "
+                                 "in menu bar".format(title))
+        menu = search[0]
+
+    return menu
+
+
+def main(title="Scripts", parent=None, objectName=None):
+    """Build the main scripts menu in Maya
+
+    Args:
+        title (str): name of the menu in the application
+
+        parent (QtWidgets.QtMenuBar): the parent object for the menu
+
+        objectName (str): custom objectName for scripts menu
+
+    Returns:
+        scriptsmenu.ScriptsMenu instance
+
+    """
+    hieromainbar = parent or _hiero_main_menubar()
+    try:
+        # check menu already exists
+        menu = find_scripts_menu(title, hieromainbar)
+        if not menu:
+            log.info("Attempting to build menu ...")
+            object_name = objectName or title.lower()
+            menu = scriptsmenu.ScriptsMenu(title=title,
+                                           parent=hieromainbar,
+                                           objectName=object_name)
+    except Exception as e:
+        log.error(e)
+        return
+
+    return menu

From 35a2c7dd13ddd3f0d780c60c0e492de676e92dcc Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Tue, 7 Jun 2022 17:27:33 +0200
Subject: [PATCH 0645/1227] revert vendor files

---
 .../common/scriptsmenu/launchforhiero.py      | 85 -------------------
 1 file changed, 85 deletions(-)
 delete mode 100644 openpype/vendor/python/common/scriptsmenu/launchforhiero.py

diff --git a/openpype/vendor/python/common/scriptsmenu/launchforhiero.py b/openpype/vendor/python/common/scriptsmenu/launchforhiero.py
deleted file mode 100644
index 3f8e726083..0000000000
--- a/openpype/vendor/python/common/scriptsmenu/launchforhiero.py
+++ /dev/null
@@ -1,85 +0,0 @@
-import logging
-
-import scriptsmenu
-from .vendor.Qt import QtWidgets
-
-log = logging.getLogger(__name__)
-
-
-def _hiero_main_window():
-    print("YEAAAAAAAAAAAAAAAAAAAH")
-    """Return Nuke's main window"""
-    for obj in QtWidgets.QApplication.topLevelWidgets():
-        if (obj.inherits('QMainWindow') and
-                obj.metaObject().className() == 'Foundry::UI::DockMainWindow'):
-            return obj
-    raise RuntimeError('Could not find HieroWindow instance')
-
-
-def _hiero_main_menubar():
-    """Retrieve the main menubar of the Nuke window"""
-    hiero_window = _hiero_main_window()
-    menubar = [i for i in hiero_window.children() if isinstance(
-        i,
-        QtWidgets.QMenuBar
-    )]
-
-    assert len(menubar) == 1, "Error, could not find menu bar!"
-    return menubar[0]
-
-
-def find_scripts_menu(title, parent):
-    """
-    Check if the menu exists with the given title in the parent
-
-    Args:
-        title (str): the title name of the scripts menu
-
-        parent (QtWidgets.QMenuBar): the menubar to check
-
-    Returns:
-        QtWidgets.QMenu or None
-
-    """
-
-    menu = None
-    search = [i for i in parent.children() if
-              isinstance(i, scriptsmenu.ScriptsMenu)
-              and i.title() == title]
-    if search:
-        assert len(search) < 2, ("Multiple instances of menu '{}' "
-                                 "in menu bar".format(title))
-        menu = search[0]
-
-    return menu
-
-
-def main(title="Scripts", parent=None, objectName=None):
-    """Build the main scripts menu in Maya
-
-    Args:
-        title (str): name of the menu in the application
-
-        parent (QtWidgets.QtMenuBar): the parent object for the menu
-
-        objectName (str): custom objectName for scripts menu
-
-    Returns:
-        scriptsmenu.ScriptsMenu instance
-
-    """
-    hieromainbar = parent or _hiero_main_menubar()
-    try:
-        # check menu already exists
-        menu = find_scripts_menu(title, hieromainbar)
-        if not menu:
-            log.info("Attempting to build menu ...")
-            object_name = objectName or title.lower()
-            menu = scriptsmenu.ScriptsMenu(title=title,
-                                           parent=hieromainbar,
-                                           objectName=object_name)
-    except Exception as e:
-        log.error(e)
-        return
-
-    return menu

From 4cf1edc3c39603be582d4e3a5013687d24718bf2 Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Tue, 7 Jun 2022 17:31:00 +0200
Subject: [PATCH 0646/1227] revert vendor files

---
 openpype/vendor/python/common/scriptsmenu/launchfornuke.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/vendor/python/common/scriptsmenu/launchfornuke.py b/openpype/vendor/python/common/scriptsmenu/launchfornuke.py
index 4f65a8e3ae..72302a79a6 100644
--- a/openpype/vendor/python/common/scriptsmenu/launchfornuke.py
+++ b/openpype/vendor/python/common/scriptsmenu/launchfornuke.py
@@ -6,7 +6,7 @@ def _nuke_main_window():
     """Return Nuke's main window"""
     for obj in QtWidgets.QApplication.topLevelWidgets():
         if (obj.inherits('QMainWindow') and
-                obj.metaObject().className() == 'Foundry::UI::DockMainWindow'):
+                    obj.metaObject().className() == 'Foundry::UI::DockMainWindow'):
             return obj
     raise RuntimeError('Could not find Nuke MainWindow instance')
 

From 5b83675a9b0684517d5bf0c0e5b47365bb1e2e67 Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Tue, 7 Jun 2022 17:54:18 +0200
Subject: [PATCH 0647/1227] change import in launch script

---
 openpype/hosts/hiero/api/launchforhiero.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/hiero/api/launchforhiero.py b/openpype/hosts/hiero/api/launchforhiero.py
index 3f8e726083..3d9328dc34 100644
--- a/openpype/hosts/hiero/api/launchforhiero.py
+++ b/openpype/hosts/hiero/api/launchforhiero.py
@@ -1,14 +1,13 @@
 import logging
 
 import scriptsmenu
-from .vendor.Qt import QtWidgets
+from .api.Qt import QtWidgets
 
 log = logging.getLogger(__name__)
 
 
 def _hiero_main_window():
-    print("YEAAAAAAAAAAAAAAAAAAAH")
-    """Return Nuke's main window"""
+    """Return Hiero's main window"""
     for obj in QtWidgets.QApplication.topLevelWidgets():
         if (obj.inherits('QMainWindow') and
                 obj.metaObject().className() == 'Foundry::UI::DockMainWindow'):
@@ -17,7 +16,7 @@ def _hiero_main_window():
 
 
 def _hiero_main_menubar():
-    """Retrieve the main menubar of the Nuke window"""
+    """Retrieve the main menubar of the Hiero window"""
     hiero_window = _hiero_main_window()
     menubar = [i for i in hiero_window.children() if isinstance(
         i,
@@ -55,7 +54,7 @@ def find_scripts_menu(title, parent):
 
 
 def main(title="Scripts", parent=None, objectName=None):
-    """Build the main scripts menu in Maya
+    """Build the main scripts menu in Hiero
 
     Args:
         title (str): name of the menu in the application

From 6cd20e110f6613b1f8c246eb0b489852f3d9507e Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Tue, 7 Jun 2022 18:03:05 +0200
Subject: [PATCH 0648/1227] change path launch script

---
 openpype/hosts/hiero/api/launchforhiero.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/hiero/api/launchforhiero.py b/openpype/hosts/hiero/api/launchforhiero.py
index 3d9328dc34..8b63b47c10 100644
--- a/openpype/hosts/hiero/api/launchforhiero.py
+++ b/openpype/hosts/hiero/api/launchforhiero.py
@@ -1,7 +1,7 @@
 import logging
 
 import scriptsmenu
-from .api.Qt import QtWidgets
+from .openpype.vendor.python.common.scriptsmenu.vendor.Qt import QtWidgets
 
 log = logging.getLogger(__name__)
 

From 6741b9e6336eb4a1b5d1fc837f021c4d45942b5d Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Wed, 8 Jun 2022 17:33:10 +0200
Subject: [PATCH 0649/1227] modif launch menu hiero

---
 openpype/hosts/hiero/api/launchforhiero.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/hiero/api/launchforhiero.py b/openpype/hosts/hiero/api/launchforhiero.py
index 8b63b47c10..5c230eb9fe 100644
--- a/openpype/hosts/hiero/api/launchforhiero.py
+++ b/openpype/hosts/hiero/api/launchforhiero.py
@@ -1,7 +1,8 @@
 import logging
 
-import scriptsmenu
-from .openpype.vendor.python.common.scriptsmenu.vendor.Qt import QtWidgets
+from openpype.vendor.python.common.scriptsmenu import scriptsmenu
+from openpype.vendor.python.common.scriptsmenu.vendor.Qt import QtWidgets
+
 
 log = logging.getLogger(__name__)
 

From 373524b9dfd40592be4904694681c2ab508b5653 Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Wed, 8 Jun 2022 17:33:40 +0200
Subject: [PATCH 0650/1227] modif menu hiero

---
 openpype/hosts/hiero/api/menu.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/hiero/api/menu.py b/openpype/hosts/hiero/api/menu.py
index 9e999da2f6..412f08272e 100644
--- a/openpype/hosts/hiero/api/menu.py
+++ b/openpype/hosts/hiero/api/menu.py
@@ -144,8 +144,9 @@ def menu_install():
 
 def add_scripts_menu():
     try:
-        from scriptsmenu import launchforhiero
+        from . import launchforhiero
     except ImportError:
+
         log.warning(
             "Skipping studio.menu install, because "
             "'scriptsmenu' module seems unavailable."

From 1eb3a55cc3610e7f12b1fa28e61deb942ee57cf4 Mon Sep 17 00:00:00 2001
From: Ophelie Abbonato <oabbonato@ws142.prs.vfx.int>
Date: Wed, 15 Jun 2022 09:58:56 +0200
Subject: [PATCH 0651/1227] change name string

---
 .../entities/schemas/projects_schema/schema_project_hiero.json  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_hiero.json b/openpype/settings/entities/schemas/projects_schema/schema_project_hiero.json
index 39721c641a..3108d2197e 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_hiero.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_hiero.json
@@ -209,7 +209,7 @@
         },
         {
             "type": "schema",
-            "name": "schema_maya_scriptsmenu"
+            "name": "schema_scriptsmenu"
         }
     ]
 }

From 1d22b862d1e95b56e64b8ae8db7234f7ed6eeb5e Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Wed, 15 Jun 2022 18:39:31 +0900
Subject: [PATCH 0652/1227] Adding ExtractAlembic to settings and setting the
 defaults to what they were, so nothing changes here except the option to
 remove certain items from families.

---
 .../defaults/project_settings/maya.json       | 24 ++++++++++++-------
 .../schemas/schema_maya_publish.json          | 24 +++++++++++++++++++
 2 files changed, 40 insertions(+), 8 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index aaf47479b8..df54e44c56 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -65,6 +65,14 @@
             "defaults": [],
             "joint_hints": "jnt_org"
         },
+        "CreateMultiverseLook": {
+            "enabled": true,
+            "publish_mip_map": true
+        },
+        "CreateMultiverseUsd": {
+            "enabled": true,
+            "strip_namespaces": true
+        },
         "CreateAnimation": {
             "enabled": true,
             "defaults": [
@@ -159,14 +167,6 @@
             "defaults": [
                 "Main"
             ]
-        },
-        "CreateMultiverseLook": {
-            "enabled": true,
-            "publish_mip_map": true
-        },
-        "CreateMultiverseUsd": {
-            "enabled": true,
-            "strip_namespaces": true
         }
     },
     "publish": {
@@ -383,6 +383,14 @@
             "optional": true,
             "active": true
         },
+        "ExtractAlembic": {
+            "enabled": true,
+            "families": [
+                "pointcache",
+                "model",
+                "vrayproxy"
+            ]
+        },
         "ValidateRigContents": {
             "enabled": false,
             "optional": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
index 2e5bc64e1c..bbe0418139 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
@@ -490,6 +490,30 @@
                             "label": "ValidateUniqueNames"
                         }
                     ]
+                },
+                {
+                    "type": "label",
+                    "label": "Extractors"
+                },
+                {
+                    "type": "dict",
+                    "collapsible": true,
+                    "key": "ExtractAlembic",
+                    "label": "Extract Alembic",
+                    "checkbox_key": "enabled",
+                    "children": [
+                        {
+                            "type": "boolean",
+                            "key": "enabled",
+                            "label": "Enabled"
+                        },
+                        {
+                            "key": "families",
+                            "label": "Families",
+                            "type": "list",
+                            "object_type": "text"
+                        }
+                    ]
                 }
             ]
         },

From 3977c25a804671e04d6c688346e1be5a485187e9 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 15 Jun 2022 14:31:36 +0200
Subject: [PATCH 0653/1227] Nuke: improving logic for `useSequenceForReview`
 argument

---
 openpype/hosts/nuke/plugins/publish/precollect_writes.py     | 5 +++++
 .../modules/deadline/plugins/publish/submit_publish_job.py   | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/plugins/publish/precollect_writes.py b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
index 8669f4f485..a0b4b77a2d 100644
--- a/openpype/hosts/nuke/plugins/publish/precollect_writes.py
+++ b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
@@ -175,6 +175,11 @@ class CollectNukeWrites(pyblish.api.InstancePlugin):
                 "frameEndHandle": last_frame,
             })
 
+            # make sure rendered sequence on farm will
+            # be used for exctract review
+            if instance.data["review"]:
+                instance.data["useSequenceForReview"] = True
+
         # * Add audio to instance if exists.
         # Find latest versions document
         version_doc = pype.get_latest_version(
diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 0583c25b57..3c036510b3 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -746,7 +746,7 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
             "resolutionHeight": data.get("resolutionHeight", 1080),
             "multipartExr": data.get("multipartExr", False),
             "jobBatchName": data.get("jobBatchName", ""),
-            "useSequenceForReview": data.get("useSequenceForReview", True)
+            "useSequenceForReview": data.get("useSequenceForReview")
         }
 
         if "prerender" in instance.data["families"]:

From 21d68b0d13914a13bbfc12040ee342b260a116ce Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 15 Jun 2022 14:35:40 +0200
Subject: [PATCH 0654/1227] use get last version for subset in collect
 published files

---
 .../publish/collect_published_files.py        | 74 ++++++-------------
 1 file changed, 22 insertions(+), 52 deletions(-)

diff --git a/openpype/hosts/webpublisher/plugins/publish/collect_published_files.py b/openpype/hosts/webpublisher/plugins/publish/collect_published_files.py
index bdd3caccfd..20e277d794 100644
--- a/openpype/hosts/webpublisher/plugins/publish/collect_published_files.py
+++ b/openpype/hosts/webpublisher/plugins/publish/collect_published_files.py
@@ -13,9 +13,13 @@ import tempfile
 import math
 
 import pyblish.api
+
+from openpype.client import (
+    get_asset_by_name,
+    get_last_version_by_subset_name
+)
 from openpype.lib import (
     prepare_template_data,
-    get_asset,
     get_ffprobe_streams,
     convert_ffprobe_fps_value,
 )
@@ -23,7 +27,6 @@ from openpype.lib.plugin_tools import (
     parse_json,
     get_subset_name_with_asset_doc
 )
-from openpype.pipeline import legacy_io
 
 
 class CollectPublishedFiles(pyblish.api.ContextPlugin):
@@ -56,8 +59,9 @@ class CollectPublishedFiles(pyblish.api.ContextPlugin):
 
         self.log.info("task_sub:: {}".format(task_subfolders))
 
+        project_name = context.data["project_name"]
         asset_name = context.data["asset"]
-        asset_doc = get_asset()
+        asset_doc = get_asset_by_name(project_name, asset_name)
         task_name = context.data["task"]
         task_type = context.data["taskType"]
         project_name = context.data["project_name"]
@@ -80,7 +84,9 @@ class CollectPublishedFiles(pyblish.api.ContextPlugin):
                 family, variant, task_name, asset_doc,
                 project_name=project_name, host_name="webpublisher"
             )
-            version = self._get_last_version(asset_name, subset_name) + 1
+            version = self._get_next_version(
+                project_name, asset_doc, subset_name
+            )
 
             instance = context.create_instance(subset_name)
             instance.data["asset"] = asset_name
@@ -219,55 +225,19 @@ class CollectPublishedFiles(pyblish.api.ContextPlugin):
                 config["families"],
                 config["tags"])
 
-    def _get_last_version(self, asset_name, subset_name):
-        """Returns version number or 0 for 'asset' and 'subset'"""
-        query = [
-            {
-                "$match": {"type": "asset", "name": asset_name}
-            },
-            {
-                "$lookup":
-                    {
-                        "from": os.environ["AVALON_PROJECT"],
-                        "localField": "_id",
-                        "foreignField": "parent",
-                        "as": "subsets"
-                    }
-            },
-            {
-                "$unwind": "$subsets"
-            },
-            {
-                "$match": {"subsets.type": "subset",
-                           "subsets.name": subset_name}},
-            {
-                "$lookup":
-                    {
-                        "from": os.environ["AVALON_PROJECT"],
-                        "localField": "subsets._id",
-                        "foreignField": "parent",
-                        "as": "versions"
-                    }
-            },
-            {
-                "$unwind": "$versions"
-            },
-            {
-                "$group": {
-                    "_id": {
-                        "asset_name": "$name",
-                        "subset_name": "$subsets.name"
-                    },
-                    'version': {'$max': "$versions.name"}
-                }
-            }
-        ]
-        version = list(legacy_io.aggregate(query))
+    def _get_next_version(self, project_name, asset_doc, subset_name):
+        """Returns version number or 1 for 'asset' and 'subset'"""
 
-        if version:
-            return version[0].get("version") or 0
-        else:
-            return 0
+        version_doc = get_last_version_by_subset_name(
+            project_name,
+            subset_name,
+            asset_doc["_id"],
+            fields=["name"]
+        )
+        version = 1
+        if version_doc:
+            version += int(version_doc["name"])
+        return version
 
     def _get_number_of_frames(self, file_url):
         """Return duration in frames"""

From a7f2587483ed5ea31090f1658937cb3904043fb6 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 15 Jun 2022 14:45:57 +0200
Subject: [PATCH 0655/1227] Nuke: reversing logic so it will not break other
 hosts

---
 openpype/hosts/nuke/plugins/publish/precollect_writes.py      | 4 ++--
 .../modules/deadline/plugins/publish/submit_publish_job.py    | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/precollect_writes.py b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
index a0b4b77a2d..e050fc8c52 100644
--- a/openpype/hosts/nuke/plugins/publish/precollect_writes.py
+++ b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
@@ -177,8 +177,8 @@ class CollectNukeWrites(pyblish.api.InstancePlugin):
 
             # make sure rendered sequence on farm will
             # be used for exctract review
-            if instance.data["review"]:
-                instance.data["useSequenceForReview"] = True
+            if not instance.data["review"]:
+                instance.data["useSequenceForReview"] = False
 
         # * Add audio to instance if exists.
         # Find latest versions document
diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 3c036510b3..0583c25b57 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -746,7 +746,7 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
             "resolutionHeight": data.get("resolutionHeight", 1080),
             "multipartExr": data.get("multipartExr", False),
             "jobBatchName": data.get("jobBatchName", ""),
-            "useSequenceForReview": data.get("useSequenceForReview")
+            "useSequenceForReview": data.get("useSequenceForReview", True)
         }
 
         if "prerender" in instance.data["families"]:

From 65a22a1ae98fb2489bd32f6f122fa60f84261162 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 15 Jun 2022 14:55:02 +0200
Subject: [PATCH 0656/1227] removing KnobScripter

also default mov colorspace
---
 .../nuke/startup/KnobScripter/__init__.py     |    1 -
 .../KnobScripter/icons/icon_clearConsole.png  |  Bin 1860 -> 0 bytes
 .../KnobScripter/icons/icon_download.png      |  Bin 1225 -> 0 bytes
 .../KnobScripter/icons/icon_exitnode.png      |  Bin 1883 -> 0 bytes
 .../startup/KnobScripter/icons/icon_pick.png  |  Bin 2184 -> 0 bytes
 .../startup/KnobScripter/icons/icon_prefs.png |  Bin 2277 -> 0 bytes
 .../KnobScripter/icons/icon_prefs2.png        |  Bin 2758 -> 0 bytes
 .../KnobScripter/icons/icon_refresh.png       |  Bin 1778 -> 0 bytes
 .../startup/KnobScripter/icons/icon_run.png   |  Bin 2341 -> 0 bytes
 .../startup/KnobScripter/icons/icon_save.png  |  Bin 1784 -> 0 bytes
 .../KnobScripter/icons/icon_search.png        |  Bin 2400 -> 0 bytes
 .../KnobScripter/icons/icon_snippets.png      |  Bin 1415 -> 0 bytes
 .../startup/KnobScripter/knob_scripter.py     | 4196 -----------------
 openpype/hosts/nuke/startup/init.py           |    4 -
 14 files changed, 4201 deletions(-)
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/__init__.py
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/icons/icon_clearConsole.png
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/icons/icon_download.png
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/icons/icon_exitnode.png
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/icons/icon_pick.png
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/icons/icon_prefs.png
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/icons/icon_prefs2.png
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/icons/icon_refresh.png
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/icons/icon_run.png
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/icons/icon_save.png
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/icons/icon_search.png
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/icons/icon_snippets.png
 delete mode 100644 openpype/hosts/nuke/startup/KnobScripter/knob_scripter.py
 delete mode 100644 openpype/hosts/nuke/startup/init.py

diff --git a/openpype/hosts/nuke/startup/KnobScripter/__init__.py b/openpype/hosts/nuke/startup/KnobScripter/__init__.py
deleted file mode 100644
index 8fe91d63f5..0000000000
--- a/openpype/hosts/nuke/startup/KnobScripter/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-import knob_scripter
\ No newline at end of file
diff --git a/openpype/hosts/nuke/startup/KnobScripter/icons/icon_clearConsole.png b/openpype/hosts/nuke/startup/KnobScripter/icons/icon_clearConsole.png
deleted file mode 100644
index 75ac04ef84b7235c071b512d1dc60410c32c5834..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1860
zcmV-K2fO%*P)<h;3K|Lk000e1NJLTq001xm001xu1^@s6R|5Hm000LINkl<ZXo2mR
zUu+!39ml^j+o(C)N%><#DIs?bN`PzW0}2v_#Jl&xLld=NpC!8j9&8?voWv4HeW-6&
zV%O#g6+#LK;h<PTwN*}b5q(VSS^ENkA|4<T!AOuq=Ak|Ql!Vw)m7VFs&g{;f_x?Dd
zv=aA|?7Pq1?9T7|o0;G5cMG(wZEb5?+rH06S{c;U)pgD2=;&nM{{8*eUEh5ZhyX-*
zu>e7RCJ^x#SI6>R>uc+m-hJ=glhZFx|L($t3ujvvu=R&qJDz{>`O~-d?z&UNca}b;
zaLeNAv-}81;cvdV_|?eB=+CRw>M8)xW&%bY9i80OyX(%71VD(oTg34M0%6=*<v5Bu
zH?pp6+paw{Ha4xep@7}H_uMtm-+v@tCjtn8S{6io)B=Z_B(e0H<-L3Fz8}Djh5`&q
zjVGRX{3U7_Ms375%is12b#`_T0M9fO@W6u)9=iRu+x9B?Q4|_-yh1t)q8w>~<q9ds
z)f6dwe_a7RJv}={M@Kys6}9}SOayqq;dveyV|AlekA0uPb3Jg*L)WF6a3Sk6fb9VA
zgERq0j*K7c$Yiz&Ig1c7!Kqo*8-mbz*8}qzn9tzAfoYj?hzL`m5c(w$(hq-;!SzDt
zIp?r#8<bLcbW~CmNsjj;QdeN#efxgBZ{K|ngcA}OZRLQr$dad~roem#009s9u;;mD
z=CgP#k+bPR0N^kBa3@`G&H>;x#@O)G)D%w}OQiZZ2=S3l2*_kIU5CdHA0uiLLuHWq
z+}GC!N@)OK7{FY>`H<&&W#4CN2#B0dvG4nEJr_I(od+;XDSfT4ukY<>q?QZ>1V|01
z3K$s~@ov1~##{6OQFTmZ0?RUC+xFinHRk1q0q1<k^W1WHCXz?b_kFl-9C_(H9LJe8
zP4gGwZDlfuCQad50eg1uxvRgw|FDo*B-%W+9M!})V_24Tk7L_&)S!kE5d?h5^SrXp
zSR~hHGV+@92BolVXV$dL!REC@EoCgm003%G<Eg2q-stY>zF99h>R*&W66YYv*<3E4
z&F1ozrKNcxgb1~Z`K9Hhd^VfQpFejF?&M_cwt-{YvsR%nsE$<}@uUy6KF!RW0Dvb6
z01Old#t)AjdbXurrwKEEu{`N|LjmW33KFHp9Ed1xbl#aY3ufeeE4`3nt567~_Vo1Z
zn3<XRup^V{`nH-cf0314Z*qw9AQAy!R=yvm28B}!x6RcCO9`Ok<KutGWHMc<C=sFd
zdK!lp*K)KYC7YI2v>kiSpz)bNn5BlP-1C-Y4ywy!wLq(^cSaOICfe&l%khep#~>hD
z*>A=~;2uGs1Sk=K{4PDmZ(t$=mgGblJ$m#g*4Njs#L2NH-v}bJRx3<oo@a19ZwC+f
zt3W~oIOl=uxexh_twN?`qGbg^WUCU_zjRgts@3ZH@#Duo)F+7=wN{uw>#zlw@5|mM
zh{jV&4Qd#X5YBnvy54D@En-9W+WO4ly#X9rSorh7m6a79g(BKD=^X8QSzuHEneSuL
zbrIAQDcf;oosvDP*9p$~kn4G6f01e3sGP15Bhd=M0B}(V@%7o2kG387<$-%C(TX!6
zNxh_|SJ$|a^99o!%;s`GZB!?EbGf>;h6v3IS<p_%IuI@EmtTDOx9!`vKXym{j?Q|H
z*JI!J;nismEHlhDgb?Ji+5FCIHeab!5+atDmhwBZxqNSLE|JnmGFl0qnVA8AC-q(^
zc;%Jj1J&y1NG=j-zy!=^Db5?P9a}mdrvw7PvI@nLT}q_buy^vxi;TrJmk8}_rLeR_
zGq<+3UU}}hqkjn}jI&XK<pEH+d3k9$xor#z+qP#5rZp&{^g*=LDNryA#gb#s(S(R#
zXnAS*bhCg#^J#+s0H{<dzd2PowcflR4|!r@0+wl=hE`!M%N%U>d&07;qGLOe2+Oki
zCnhHD)_-e+FLD0VeNtv%qy78LnKS=5aPZ)-wrtsgMEfickj|7)?C;zElhxJLvkyP=
zux(k^V01#Fmvqkc=JL6nxjZ$fQ7V=GNGUbqYEQH|H}VO225R)gRxB1j7#kb=S#7FJ
zV<NQLxG7HWr8d*d)qN^4KfiGB<BwN(gQ^wrcl}&Qx4Hs256(aR^zWb5E9&N_k_Q-Z
zDp0LQYaD)5%a_;InhOAcm6eZvyRfkE&qiaCmYzXkSuJoPT_SbS-+B9;)&u|url+R|
zKKbNR&8wOy>#e1hK{mrg#Lt{UAM5j_i<j`ii!T7cMIb#3CG5(TD;NHH^5l;*9UXgb
z=<Y^GXXnO4iB_3JS)`WHgfCydj5ptU3wEi5YPAXguLCGI^IusffcNFR{||p(Kt9~v
yjQt3}F#w<a4;}v(fInT0^KENe+uHWuvHt*s37PG;KyRD?0000<MNUMnLSTZD5t_yT

diff --git a/openpype/hosts/nuke/startup/KnobScripter/icons/icon_download.png b/openpype/hosts/nuke/startup/KnobScripter/icons/icon_download.png
deleted file mode 100644
index 1e3e9b7631e3a3237c51f1028fd22511e9b69c3b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1225
zcmV;)1UCDLP)<h;3K|Lk000e1NJLTq001%o001%w1^@s69zTe&000D#Nkl<ZXo2mS
zPe>zo6vsb5HDgS4Q~#AV?m<~ha_FV2aW7k1*xl;E!nTXu(nFy=2=-7acquKEieR1Q
z+>@t*dXS<ODUA@LC`fU)c#y8b(u3747<Vfox}r0`9wsxHL}jUyQA_iMK;F!c_ulvS
z-uwOD?>A7u{|u$xQlCJGi}u42Iy*bRO(YUWqobqip-`yFO<TooDXy)pz1rK``(u$P
zD)RY!SE_5OU!6`&kGN&8$SuVc6%~~L5{VFkit>t9z_qBjM&tx2z}IdmKTje6m2N3M
zZz8UtK;*KaK;*K)bs_?gZX4koh)4`FZljP|mkk9Xmkk9Xmkk9XFNA#qIfu=}JtFok
z{T#OU5~m76jg8mub##25+T8qeczAeVZ*OnM{$3!EC$I>GLQNeV9o-un8;?guMg|TJ
z4)&e+;fRQ$C|>ouSUeE8QX>R3H#fiC)6;WjcXxN&93ugdlUgk;Ep2^$ed8XFQVNoi
zk`mA0;NX`|d~uXofk2=p5V%r<5FjBO4mZbQvFY;i@|UbZ_Bz2%!c%JAcGcI{-vi2=
z_~M92DwSHFpP!#V%5*&o!jbUnu~=-{@An75h=vpviAsw^I^}d-XKZXN41DFp7sqRf
zqA1t;`uZM6qfxAi5RlqTJ*lmIIVglgO4#1s#_#v*9*?KUG_C6zsyaYCJ_Ya-aQCc!
zIKH6MH0|%%+1cxnNF-cW7eu7f%<uPC0EP^By<Uooi-jrcy3T+)z?4Bk13m-(xG*9B
znx>7<&d%P5L?YLM!Jy^5iCkINbyQWgllTM}bK*n3u1t?KO&iT3V`i-Yq$Q;zp)wVZ
zLx#i;P94bS-ETITx*+CiX6}cXNaU9U<o^;oi%eZGXe}qYuA>g9#HaF4!cBM;MVV4n
zRVI^3nMfpLYip~-2+R@iQN9gYRoK+jbld!|Y1+}!($b7W-CjjeCVIc=y)!*Com<#v
zibPda)hi7R4X>GUDwSGaTU%Sn8kC$#%9-ShOeT|Za&mI}n3l7_D}?xkJVoNx?OPw3
zJ|>e%+1=g!z4`96oxKEj%Zbr6o=Yk30zZ?7n#gKEjTPi75CMDBXm7c}4~zqup6Tp(
z4z!bxM*jG*;2mHc_%u5r?wuR*qcx`iwKrJ*v7_$kN6jMJ7-{C8qA2I#)xU;$egWfy
zx0IPcTQ&0Z+0(zOtE+<ofk*Ms)z#%)U0wY^*K`dbk!I78o)qgzzU8zHDY9k7tCY33
zw|5EzGTl*crM8X}SzKI<x3#r>Y)0k&`}a#F()gS#K*;PB!!8@MlPNGEMAmHOQ<g$n
zwjVrvV2!a-YiMYwe}8}fOhuWSxmmM&;s^&wtD2jeV`XIpj8!YsYwhgpJX>B~z7dT^
z8+~Oy!x5Y97q#Y2WMMq8$vL)j<b{O=`uqDiJUj&W0(g=;O^u48{C4w=o8^&Egfd@Q
zdJ>FqW>WS9*^PR!0%<(i+Dx(daFIv9KQjFt1K#5lya{YzsJYC)2_TS(+R5+&?*h$0
n`Du(V2<yNU@asi8;tKu&J9h$#PO~me00000NkvXXu0mjf1lCYv

diff --git a/openpype/hosts/nuke/startup/KnobScripter/icons/icon_exitnode.png b/openpype/hosts/nuke/startup/KnobScripter/icons/icon_exitnode.png
deleted file mode 100644
index 7714cd2b92267c4bfbc1322e4681188ad1f7a7a6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1883
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
VW=lh7gf9R9002ovPDHLkV1jt?fvf-k

diff --git a/openpype/hosts/nuke/startup/KnobScripter/icons/icon_pick.png b/openpype/hosts/nuke/startup/KnobScripter/icons/icon_pick.png
deleted file mode 100644
index 239553755060aa93162d8748796d7ea29bb7b07e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2184
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
KMNUMnLSTa35IYF~

diff --git a/openpype/hosts/nuke/startup/KnobScripter/icons/icon_prefs.png b/openpype/hosts/nuke/startup/KnobScripter/icons/icon_prefs.png
deleted file mode 100644
index efef5ffc92f782b5582ee8b6b898436d5d3ef19b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2277
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

diff --git a/openpype/hosts/nuke/startup/KnobScripter/icons/icon_prefs2.png b/openpype/hosts/nuke/startup/KnobScripter/icons/icon_prefs2.png
deleted file mode 100644
index 5c3c941d596365c5846e39dfa465167a97454e53..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2758
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
M07*qoM6N<$f-?anq5uE@

diff --git a/openpype/hosts/nuke/startup/KnobScripter/icons/icon_refresh.png b/openpype/hosts/nuke/startup/KnobScripter/icons/icon_refresh.png
deleted file mode 100644
index 559bfd74ab8b550503194ba2409795e77a52c83b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1778
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
Uw!?IYy#N3J07*qoM6N<$f)br{CIA2c

diff --git a/openpype/hosts/nuke/startup/KnobScripter/icons/icon_run.png b/openpype/hosts/nuke/startup/KnobScripter/icons/icon_run.png
deleted file mode 100644
index 6b2e4ddc2348254824b75b9d14b03c5eb28430fc..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2341
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
LNkvXXu0mjfRQGr7

diff --git a/openpype/hosts/nuke/startup/KnobScripter/icons/icon_save.png b/openpype/hosts/nuke/startup/KnobScripter/icons/icon_save.png
deleted file mode 100644
index e29c667f3455f4afa92f63ba8de4ce3c4b53a866..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1784
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
aD)tkwJPu`6Ec-S90000<MNUMnLSTYMBz(jG

diff --git a/openpype/hosts/nuke/startup/KnobScripter/icons/icon_search.png b/openpype/hosts/nuke/startup/KnobScripter/icons/icon_search.png
deleted file mode 100644
index d4ed2e1a2b47ec2d3aebfb0467e29b586b7e06a8..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2400
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
S3=G}?0000<MNUMnLSTZ5>A0%^

diff --git a/openpype/hosts/nuke/startup/KnobScripter/icons/icon_snippets.png b/openpype/hosts/nuke/startup/KnobScripter/icons/icon_snippets.png
deleted file mode 100644
index 479c44f19e3c0c824c0491b4c176123eb1547197..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1415
zcmV;21$g?2P)<h;3K|Lk000e1NJLTq000^Q000^Y1^@s6sY*=F000F}Nkl<ZNQv!K
zYfO_@7=F%IdZ*u4Fdzzr%|Qm}1Sioj9IL~{;NoUT)JU?CMV*U?7lw%jBZMs=fofp2
zk!163ylgHcicv&c)X4-Zbr{S5CoR%iDCII*Zf(zglp<u}?bm+nNxq!(<U8km&ilU4
zIl%vTLy*a2`SRr%n>KAK4h#sKNeKn0cL4<fUXg=>TArF8tM(uGMt}G2RbOnLZ=zHx
zSMSNqJt>xm{eAib042}P^L*}=0s!LuM`SWtz*40$z45-m)Ya8xnAi~>9v-dHXnvPU
zrQFeD$Nn7X>l<6YVZ*ypsgyrFJnX)F`EtjVD_1(6JbB_AbB(#>tXvo~H%7i@^_n@c
zF|h%4cj~(K74B;+DlS?a8yzdB<HEhYy(5{KnJX<8%T*$i`3Gn;hwdm8p;0<rZAV{U
zzh~8|&mt%VY&M%SCnu-gXf)aYTpRz)09*iAhGAlM?8sKHT>0sH{rv+@mgOV>#pu|m
zr|EuE&%%U-K_-*2f6JDv#mwHld1u4I!lGJRTWz;**Y)^B0D_vDs}`ft*bX2Yz##yw
z02}~D0Camio*U)mWs5pH%{G>0CEgMeFoYm4Kd<i5qes^8@CdG;px`=_kdW|6Z?D~v
zo4d!5lJao?rNmoLLXn!fLZMVDorEx*)46GEY;3rys_MX`)`4Mo#NlvwcJ11g)ZN`R
z7$3i2wjTiS`Fw#`By!H3H!qNYdK*kBIF1wK=jCs<*==hZ>KiV!w6y45F4riicMTaI
zJ32ZZewmT6-DEN?gD)+BNF@>hUmzR-s6Y9xprB^Shsh~6TbENTmbj%-sm$kmLMXgt
zd^N7uH{4XI_Gefumd7C>A#atJm){Hu3Jz;*)ITMDe7>-xxVSm~{RMNp-lflMJcWC+
z^x2qBvvy!$V5qRLaQ(O0*~LLKgB7hUZT9Wkx7{HCz_M(xTCHwYC=@eZ_kzBNTc277
zGdE|}_1JrwCtikdg<`=E2M^Y9GMTX5WE{M7@sg31v%&y*fPiH=ft+InLb2G-Un=2A
zB>sG{SmY-Z3K*Y5y}k9_U4o$@himKBZMWOn+S&l*OnHLh;^NXuN=km_^ZCp{wffdC
z=g+GEumHI6Q3gN+Kng&@Fg#IIRAf-nlBAGzYuCNwC-7rH0k_LdcjxY|Z>VoD0@w}U
zFWzJ!tJV6@Y&H)kCnqmUNJxm_@pwo~Oq3)gC51#rMh*-O4OQCh_M-qU0Qi+sdakFZ
z=h%Y>53VVfDp$!lIZFsZsjBpkT3u}ifI<Mxlbk;l>FMbe8#iwJ8a@k87>nR~P0fXy
zw{D#n931RtSvD{xCT7tGNlBlF&YCrc0yuu+M9Y!Ghg$%Y1DJSJpDP3aSy@?CX=!OI
zynQ8@koy;Zc9_b_%J#CdvL*m$0i2o~Z%XMVL$BALi;j*?3k?ko27nv2wU*)0Q8z;f
zal2f!%Vrxk7z{mOVPXCZ!;pLT?%4{9iW)s0PZfY8)5U!*ghGM8T7A%@(`o7H)2E#r
z#}xqB58${+BtBPBQPHi{YN<w}v5Q2aDgfUD@Ov#0A2^Pied^>%yH=;8DwV2}$KwSu
z48tobD!QoCYU!CXX9fai%%}!X3P3nroM}tv!^p_U-v)!>#<G-@FCro$<YKW{86O`X
znVOpVmDA}Q*|~G)U2|vWV*q;r48Bn|lQDn({MFUf)o!g;OSM`pt*)*fjf;!>4c^AT
z{j&Wp&BzC<)!N+N-rg4*8~c&N;c%6fmNwPb*P8+4188~U3|@dl06zivaeV&Y!av`O
VU4IwAq!s`G002ovPDHLkV1g(>ppyUq

diff --git a/openpype/hosts/nuke/startup/KnobScripter/knob_scripter.py b/openpype/hosts/nuke/startup/KnobScripter/knob_scripter.py
deleted file mode 100644
index 368ee64e32..0000000000
--- a/openpype/hosts/nuke/startup/KnobScripter/knob_scripter.py
+++ /dev/null
@@ -1,4196 +0,0 @@
-# -------------------------------------------------
-# KnobScripter by Adrian Pueyo
-# Complete python script editor for Nuke
-# adrianpueyo.com, 2016-2019
-import string
-import traceback
-from webbrowser import open as openUrl
-from threading import Event, Thread
-import platform
-import subprocess
-from functools import partial
-import re
-import sys
-from nukescripts import panels
-import json
-import os
-import nuke
-version = "2.3 wip"
-date = "Aug 12 2019"
-# -------------------------------------------------
-
-
-# Symlinks on windows...
-if os.name == "nt":
-    def symlink_ms(source, link_name):
-        import ctypes
-        csl = ctypes.windll.kernel32.CreateSymbolicLinkW
-        csl.argtypes = (ctypes.c_wchar_p, ctypes.c_wchar_p, ctypes.c_uint32)
-        csl.restype = ctypes.c_ubyte
-        flags = 1 if os.path.isdir(source) else 0
-        try:
-            if csl(link_name, source.replace('/', '\\'), flags) == 0:
-                raise ctypes.WinError()
-        except:
-            pass
-    os.symlink = symlink_ms
-
-try:
-    if nuke.NUKE_VERSION_MAJOR < 11:
-        from PySide import QtCore, QtGui, QtGui as QtWidgets
-        from PySide.QtCore import Qt
-    else:
-        from PySide2 import QtWidgets, QtGui, QtCore
-        from PySide2.QtCore import Qt
-except ImportError:
-    from Qt import QtCore, QtGui, QtWidgets
-
-KS_DIR = os.path.dirname(__file__)
-icons_path = KS_DIR + "/icons/"
-DebugMode = False
-AllKnobScripters = []  # All open instances at a given time
-
-PrefsPanel = ""
-SnippetEditPanel = ""
-
-nuke.tprint('KnobScripter v{}, built {}.\nCopyright (c) 2016-2019 Adrian Pueyo. All Rights Reserved.'.format(version, date))
-
-
-class KnobScripter(QtWidgets.QWidget):
-
-    def __init__(self, node="", knob="knobChanged"):
-        super(KnobScripter, self).__init__()
-
-        # Autosave the other knobscripters and add this one
-        for ks in AllKnobScripters:
-            try:
-                ks.autosave()
-            except:
-                pass
-        if self not in AllKnobScripters:
-            AllKnobScripters.append(self)
-
-        self.nodeMode = (node != "")
-        if node == "":
-            self.node = nuke.toNode("root")
-        else:
-            self.node = node
-
-        self.isPane = False
-        self.knob = knob
-        # For the option to also display the knob labels on the knob dropdown
-        self.show_labels = False
-        self.unsavedKnobs = {}
-        self.modifiedKnobs = set()
-        self.scrollPos = {}
-        self.cursorPos = {}
-        self.fontSize = 10
-        self.font = "Monospace"
-        self.tabSpaces = 4
-        self.windowDefaultSize = [500, 300]
-        self.color_scheme = "sublime"  # Can be nuke or sublime
-        self.pinned = 1
-        self.toLoadKnob = True
-        self.frw_open = False  # Find replace widget closed by default
-        self.icon_size = 17
-        self.btn_size = 24
-        self.qt_icon_size = QtCore.QSize(self.icon_size, self.icon_size)
-        self.qt_btn_size = QtCore.QSize(self.btn_size, self.btn_size)
-        self.origConsoleText = ""
-        self.nukeSE = self.findSE()
-        self.nukeSEOutput = self.findSEOutput(self.nukeSE)
-        self.nukeSEInput = self.findSEInput(self.nukeSE)
-        self.nukeSERunBtn = self.findSERunBtn(self.nukeSE)
-
-        self.scripts_dir = os.path.expandvars(
-            os.path.expanduser("~/.nuke/KnobScripter_Scripts"))
-        self.current_folder = "scripts"
-        self.folder_index = 0
-        self.current_script = "Untitled.py"
-        self.current_script_modified = False
-        self.script_index = 0
-        self.toAutosave = False
-
-        # Load prefs
-        self.prefs_txt = os.path.expandvars(
-            os.path.expanduser("~/.nuke/KnobScripter_Prefs.txt"))
-        self.loadedPrefs = self.loadPrefs()
-        if self.loadedPrefs != []:
-            try:
-                if "font_size" in self.loadedPrefs:
-                    self.fontSize = self.loadedPrefs['font_size']
-                self.windowDefaultSize = [
-                    self.loadedPrefs['window_default_w'], self.loadedPrefs['window_default_h']]
-                self.tabSpaces = self.loadedPrefs['tab_spaces']
-                self.pinned = self.loadedPrefs['pin_default']
-                if "font" in self.loadedPrefs:
-                    self.font = self.loadedPrefs['font']
-                if "color_scheme" in self.loadedPrefs:
-                    self.color_scheme = self.loadedPrefs['color_scheme']
-                if "show_labels" in self.loadedPrefs:
-                    self.show_labels = self.loadedPrefs['show_labels']
-            except TypeError:
-                log("KnobScripter: Failed to load preferences.")
-
-        # Load snippets
-        self.snippets_txt_path = os.path.expandvars(
-            os.path.expanduser("~/.nuke/KnobScripter_Snippets.txt"))
-        self.snippets = self.loadSnippets(maxDepth=5)
-
-        # Current state of script (loaded when exiting node mode)
-        self.state_txt_path = os.path.expandvars(
-            os.path.expanduser("~/.nuke/KnobScripter_State.txt"))
-
-        # Init UI
-        self.initUI()
-
-        # Talk to Nuke's Script Editor
-        self.setSEOutputEvent()  # Make the output windowS listen!
-        self.clearConsole()
-
-    def initUI(self):
-        ''' Initializes the tool UI'''
-        # -------------------
-        # 1. MAIN WINDOW
-        # -------------------
-        self.resize(self.windowDefaultSize[0], self.windowDefaultSize[1])
-        self.setWindowTitle("KnobScripter - %s %s" %
-                            (self.node.fullName(), self.knob))
-        self.setObjectName("com.adrianpueyo.knobscripter")
-        self.move(QtGui.QCursor().pos() - QtCore.QPoint(32, 74))
-
-        # ---------------------
-        # 2. TOP BAR
-        # ---------------------
-        # ---
-        # 2.1. Left buttons
-        self.change_btn = QtWidgets.QToolButton()
-        # self.exit_node_btn.setIcon(QtGui.QIcon(KS_DIR+"/KnobScripter/icons/icons8-delete-26.png"))
-        self.change_btn.setIcon(QtGui.QIcon(icons_path + "icon_pick.png"))
-        self.change_btn.setIconSize(self.qt_icon_size)
-        self.change_btn.setFixedSize(self.qt_btn_size)
-        self.change_btn.setToolTip(
-            "Change to node if selected. Otherwise, change to Script Mode.")
-        self.change_btn.clicked.connect(self.changeClicked)
-
-        # ---
-        # 2.2.A. Node mode UI
-        self.exit_node_btn = QtWidgets.QToolButton()
-        self.exit_node_btn.setIcon(QtGui.QIcon(
-            icons_path + "icon_exitnode.png"))
-        self.exit_node_btn.setIconSize(self.qt_icon_size)
-        self.exit_node_btn.setFixedSize(self.qt_btn_size)
-        self.exit_node_btn.setToolTip(
-            "Exit the node, and change to Script Mode.")
-        self.exit_node_btn.clicked.connect(self.exitNodeMode)
-        self.current_node_label_node = QtWidgets.QLabel(" Node:")
-        self.current_node_label_name = QtWidgets.QLabel(self.node.fullName())
-        self.current_node_label_name.setStyleSheet("font-weight:bold;")
-        self.current_knob_label = QtWidgets.QLabel("Knob: ")
-        self.current_knob_dropdown = QtWidgets.QComboBox()
-        self.current_knob_dropdown.setSizeAdjustPolicy(
-            QtWidgets.QComboBox.AdjustToContents)
-        self.updateKnobDropdown()
-        self.current_knob_dropdown.currentIndexChanged.connect(
-            lambda: self.loadKnobValue(False, updateDict=True))
-
-        # Layout
-        self.node_mode_bar_layout = QtWidgets.QHBoxLayout()
-        self.node_mode_bar_layout.addWidget(self.exit_node_btn)
-        self.node_mode_bar_layout.addSpacing(2)
-        self.node_mode_bar_layout.addWidget(self.current_node_label_node)
-        self.node_mode_bar_layout.addWidget(self.current_node_label_name)
-        self.node_mode_bar_layout.addSpacing(2)
-        self.node_mode_bar_layout.addWidget(self.current_knob_dropdown)
-        self.node_mode_bar = QtWidgets.QWidget()
-        self.node_mode_bar.setLayout(self.node_mode_bar_layout)
-
-        self.node_mode_bar_layout.setContentsMargins(0, 0, 0, 0)
-
-        # ---
-        # 2.2.B. Script mode UI
-        self.script_label = QtWidgets.QLabel("Script: ")
-
-        self.current_folder_dropdown = QtWidgets.QComboBox()
-        self.current_folder_dropdown.setSizeAdjustPolicy(
-            QtWidgets.QComboBox.AdjustToContents)
-        self.current_folder_dropdown.currentIndexChanged.connect(
-            self.folderDropdownChanged)
-        # self.current_folder_dropdown.setEditable(True)
-        # self.current_folder_dropdown.lineEdit().setReadOnly(True)
-        # self.current_folder_dropdown.lineEdit().setAlignment(Qt.AlignRight)
-
-        self.current_script_dropdown = QtWidgets.QComboBox()
-        self.current_script_dropdown.setSizeAdjustPolicy(
-            QtWidgets.QComboBox.AdjustToContents)
-        self.updateFoldersDropdown()
-        self.updateScriptsDropdown()
-        self.current_script_dropdown.currentIndexChanged.connect(
-            self.scriptDropdownChanged)
-
-        # Layout
-        self.script_mode_bar_layout = QtWidgets.QHBoxLayout()
-        self.script_mode_bar_layout.addWidget(self.script_label)
-        self.script_mode_bar_layout.addSpacing(2)
-        self.script_mode_bar_layout.addWidget(self.current_folder_dropdown)
-        self.script_mode_bar_layout.addWidget(self.current_script_dropdown)
-        self.script_mode_bar = QtWidgets.QWidget()
-        self.script_mode_bar.setLayout(self.script_mode_bar_layout)
-
-        self.script_mode_bar_layout.setContentsMargins(0, 0, 0, 0)
-
-        # ---
-        # 2.3. File-system buttons
-        # Refresh dropdowns
-        self.refresh_btn = QtWidgets.QToolButton()
-        self.refresh_btn.setIcon(QtGui.QIcon(icons_path + "icon_refresh.png"))
-        self.refresh_btn.setIconSize(QtCore.QSize(50, 50))
-        self.refresh_btn.setIconSize(self.qt_icon_size)
-        self.refresh_btn.setFixedSize(self.qt_btn_size)
-        self.refresh_btn.setToolTip("Refresh the dropdowns.\nShortcut: F5")
-        self.refresh_btn.setShortcut('F5')
-        self.refresh_btn.clicked.connect(self.refreshClicked)
-
-        # Reload script
-        self.reload_btn = QtWidgets.QToolButton()
-        self.reload_btn.setIcon(QtGui.QIcon(icons_path + "icon_download.png"))
-        self.reload_btn.setIconSize(QtCore.QSize(50, 50))
-        self.reload_btn.setIconSize(self.qt_icon_size)
-        self.reload_btn.setFixedSize(self.qt_btn_size)
-        self.reload_btn.setToolTip(
-            "Reload the current script. Will overwrite any changes made to it.\nShortcut: Ctrl+R")
-        self.reload_btn.setShortcut('Ctrl+R')
-        self.reload_btn.clicked.connect(self.reloadClicked)
-
-        # Save script
-        self.save_btn = QtWidgets.QToolButton()
-        self.save_btn.setIcon(QtGui.QIcon(icons_path + "icon_save.png"))
-        self.save_btn.setIconSize(QtCore.QSize(50, 50))
-        self.save_btn.setIconSize(self.qt_icon_size)
-        self.save_btn.setFixedSize(self.qt_btn_size)
-        self.save_btn.setToolTip(
-            "Save the script into the selected knob or python file.\nShortcut: Ctrl+S")
-        self.save_btn.setShortcut('Ctrl+S')
-        self.save_btn.clicked.connect(self.saveClicked)
-
-        # Layout
-        self.top_file_bar_layout = QtWidgets.QHBoxLayout()
-        self.top_file_bar_layout.addWidget(self.refresh_btn)
-        self.top_file_bar_layout.addWidget(self.reload_btn)
-        self.top_file_bar_layout.addWidget(self.save_btn)
-
-        # ---
-        # 2.4. Right Side buttons
-
-        # Run script
-        self.run_script_button = QtWidgets.QToolButton()
-        self.run_script_button.setIcon(
-            QtGui.QIcon(icons_path + "icon_run.png"))
-        self.run_script_button.setIconSize(self.qt_icon_size)
-        # self.run_script_button.setIconSize(self.qt_icon_size)
-        self.run_script_button.setFixedSize(self.qt_btn_size)
-        self.run_script_button.setToolTip(
-            "Execute the current selection on the KnobScripter, or the whole script if no selection.\nShortcut: Ctrl+Enter")
-        self.run_script_button.clicked.connect(self.runScript)
-
-        # Clear console
-        self.clear_console_button = QtWidgets.QToolButton()
-        self.clear_console_button.setIcon(
-            QtGui.QIcon(icons_path + "icon_clearConsole.png"))
-        self.clear_console_button.setIconSize(QtCore.QSize(50, 50))
-        self.clear_console_button.setIconSize(self.qt_icon_size)
-        self.clear_console_button.setFixedSize(self.qt_btn_size)
-        self.clear_console_button.setToolTip(
-            "Clear the text in the console window.\nShortcut: Click Backspace on the console.")
-        self.clear_console_button.clicked.connect(self.clearConsole)
-
-        # FindReplace button
-        self.find_button = QtWidgets.QToolButton()
-        self.find_button.setIcon(QtGui.QIcon(icons_path + "icon_search.png"))
-        self.find_button.setIconSize(self.qt_icon_size)
-        self.find_button.setFixedSize(self.qt_btn_size)
-        self.find_button.setToolTip(
-            "Call the snippets by writing the shortcut and pressing Tab.\nShortcut: Ctrl+F")
-        self.find_button.setShortcut('Ctrl+F')
-        #self.find_button.setMaximumWidth(self.find_button.fontMetrics().boundingRect("Find").width() + 20)
-        self.find_button.setCheckable(True)
-        self.find_button.setFocusPolicy(QtCore.Qt.NoFocus)
-        self.find_button.clicked[bool].connect(self.toggleFRW)
-        if self.frw_open:
-            self.find_button.toggle()
-
-        # Snippets
-        self.snippets_button = QtWidgets.QToolButton()
-        self.snippets_button.setIcon(
-            QtGui.QIcon(icons_path + "icon_snippets.png"))
-        self.snippets_button.setIconSize(QtCore.QSize(50, 50))
-        self.snippets_button.setIconSize(self.qt_icon_size)
-        self.snippets_button.setFixedSize(self.qt_btn_size)
-        self.snippets_button.setToolTip(
-            "Call the snippets by writing the shortcut and pressing Tab.")
-        self.snippets_button.clicked.connect(self.openSnippets)
-
-        # PIN
-        '''
-        self.pin_button = QtWidgets.QPushButton("P")
-        self.pin_button.setCheckable(True)
-        if self.pinned:
-            self.setWindowFlags(self.windowFlags() | QtCore.Qt.WindowStaysOnTopHint)
-            self.pin_button.toggle()
-        self.pin_button.setToolTip("Toggle 'Always On Top'. Keeps the KnobScripter on top of all other windows.")
-        self.pin_button.setFocusPolicy(QtCore.Qt.NoFocus)
-        self.pin_button.setFixedSize(self.qt_btn_size)
-        self.pin_button.clicked[bool].connect(self.pin)
-        '''
-
-        # Prefs
-        self.createPrefsMenu()
-        self.prefs_button = QtWidgets.QPushButton()
-        self.prefs_button.setIcon(QtGui.QIcon(icons_path + "icon_prefs.png"))
-        self.prefs_button.setIconSize(self.qt_icon_size)
-        self.prefs_button.setFixedSize(
-            QtCore.QSize(self.btn_size + 10, self.btn_size))
-        # self.prefs_button.clicked.connect(self.openPrefs)
-        self.prefs_button.setMenu(self.prefsMenu)
-        self.prefs_button.setStyleSheet("text-align:left;padding-left:2px;")
-        #self.prefs_button.setMaximumWidth(self.prefs_button.fontMetrics().boundingRect("Prefs").width() + 12)
-
-        # Layout
-        self.top_right_bar_layout = QtWidgets.QHBoxLayout()
-        self.top_right_bar_layout.addWidget(self.run_script_button)
-        self.top_right_bar_layout.addWidget(self.clear_console_button)
-        self.top_right_bar_layout.addWidget(self.find_button)
-        # self.top_right_bar_layout.addWidget(self.snippets_button)
-        # self.top_right_bar_layout.addWidget(self.pin_button)
-        # self.top_right_bar_layout.addSpacing(10)
-        self.top_right_bar_layout.addWidget(self.prefs_button)
-
-        # ---
-        # Layout
-        self.top_layout = QtWidgets.QHBoxLayout()
-        self.top_layout.setContentsMargins(0, 0, 0, 0)
-        # self.top_layout.setSpacing(10)
-        self.top_layout.addWidget(self.change_btn)
-        self.top_layout.addWidget(self.node_mode_bar)
-        self.top_layout.addWidget(self.script_mode_bar)
-        self.node_mode_bar.setVisible(False)
-        # self.top_layout.addSpacing(10)
-        self.top_layout.addLayout(self.top_file_bar_layout)
-        self.top_layout.addStretch()
-        self.top_layout.addLayout(self.top_right_bar_layout)
-
-        # ----------------------
-        # 3. SCRIPTING SECTION
-        # ----------------------
-        # Splitter
-        self.splitter = QtWidgets.QSplitter(Qt.Vertical)
-
-        # Output widget
-        self.script_output = ScriptOutputWidget(parent=self)
-        self.script_output.setReadOnly(1)
-        self.script_output.setAcceptRichText(0)
-        self.script_output.setTabStopWidth(
-            self.script_output.tabStopWidth() / 4)
-        self.script_output.setFocusPolicy(Qt.ClickFocus)
-        self.script_output.setAutoFillBackground(0)
-        self.script_output.installEventFilter(self)
-
-        # Script Editor
-        self.script_editor = KnobScripterTextEditMain(self, self.script_output)
-        self.script_editor.setMinimumHeight(30)
-        self.script_editor.setStyleSheet(
-            'background:#282828;color:#EEE;')  # Main Colors
-        self.script_editor.textChanged.connect(self.setModified)
-        self.highlighter = KSScriptEditorHighlighter(
-            self.script_editor.document(), self)
-        self.script_editor.cursorPositionChanged.connect(self.setTextSelection)
-        self.script_editor_font = QtGui.QFont()
-        self.script_editor_font.setFamily(self.font)
-        self.script_editor_font.setStyleHint(QtGui.QFont.Monospace)
-        self.script_editor_font.setFixedPitch(True)
-        self.script_editor_font.setPointSize(self.fontSize)
-        self.script_editor.setFont(self.script_editor_font)
-        self.script_editor.setTabStopWidth(
-            self.tabSpaces * QtGui.QFontMetrics(self.script_editor_font).width(' '))
-
-        # Add input and output to splitter
-        self.splitter.addWidget(self.script_output)
-        self.splitter.addWidget(self.script_editor)
-        self.splitter.setStretchFactor(0, 0)
-
-        # FindReplace widget
-        self.frw = FindReplaceWidget(self)
-        self.frw.setVisible(self.frw_open)
-
-        # ---
-        # Layout
-        self.scripting_layout = QtWidgets.QVBoxLayout()
-        self.scripting_layout.setContentsMargins(0, 0, 0, 0)
-        self.scripting_layout.setSpacing(0)
-        self.scripting_layout.addWidget(self.splitter)
-        self.scripting_layout.addWidget(self.frw)
-
-        # ---------------
-        # MASTER LAYOUT
-        # ---------------
-        self.master_layout = QtWidgets.QVBoxLayout()
-        self.master_layout.setSpacing(5)
-        self.master_layout.setContentsMargins(8, 8, 8, 8)
-        self.master_layout.addLayout(self.top_layout)
-        self.master_layout.addLayout(self.scripting_layout)
-        # self.master_layout.addLayout(self.bottom_layout)
-        self.setLayout(self.master_layout)
-
-        # ----------------
-        # MAIN WINDOW UI
-        # ----------------
-        size_policy = QtWidgets.QSizePolicy(
-            QtWidgets.QSizePolicy.Minimum, QtWidgets.QSizePolicy.Minimum)
-        self.setSizePolicy(size_policy)
-        self.setMinimumWidth(160)
-
-        if self.pinned:
-            self.setWindowFlags(self.windowFlags() |
-                                QtCore.Qt.WindowStaysOnTopHint)
-
-        # Set default values based on mode
-        if self.nodeMode:
-            self.current_knob_dropdown.blockSignals(True)
-            self.node_mode_bar.setVisible(True)
-            self.script_mode_bar.setVisible(False)
-            self.setCurrentKnob(self.knob)
-            self.loadKnobValue(check=False)
-            self.setKnobModified(False)
-            self.current_knob_dropdown.blockSignals(False)
-            self.splitter.setSizes([0, 1])
-        else:
-            self.exitNodeMode()
-        self.script_editor.setFocus()
-
-    # Preferences submenus
-    def createPrefsMenu(self):
-
-        # Actions
-        self.echoAct = QtWidgets.QAction("Echo python commands", self, checkable=True,
-                                         statusTip="Toggle nuke's 'Echo all python commands to ScriptEditor'", triggered=self.toggleEcho)
-        if nuke.toNode("preferences").knob("echoAllCommands").value():
-            self.echoAct.toggle()
-        self.pinAct = QtWidgets.QAction("Always on top", self, checkable=True,
-                                        statusTip="Keeps the KnobScripter window always on top or not.", triggered=self.togglePin)
-        if self.pinned:
-            self.setWindowFlags(self.windowFlags() |
-                                QtCore.Qt.WindowStaysOnTopHint)
-            self.pinAct.toggle()
-        self.helpAct = QtWidgets.QAction(
-            "&Help", self, statusTip="Open the KnobScripter help in your browser.", shortcut="F1", triggered=self.showHelp)
-        self.nukepediaAct = QtWidgets.QAction(
-            "Show in Nukepedia", self, statusTip="Open the KnobScripter download page on Nukepedia.", triggered=self.showInNukepedia)
-        self.githubAct = QtWidgets.QAction(
-            "Show in GitHub", self, statusTip="Open the KnobScripter repo on GitHub.", triggered=self.showInGithub)
-        self.snippetsAct = QtWidgets.QAction(
-            "Snippets", self, statusTip="Open the Snippets editor.", triggered=self.openSnippets)
-        self.snippetsAct.setIcon(QtGui.QIcon(icons_path + "icon_snippets.png"))
-        # self.snippetsAct = QtWidgets.QAction("Keywords", self, statusTip="Add custom keywords.", triggered=self.openSnippets) #TODO THIS
-        self.prefsAct = QtWidgets.QAction(
-            "Preferences", self, statusTip="Open the Preferences panel.", triggered=self.openPrefs)
-        self.prefsAct.setIcon(QtGui.QIcon(icons_path + "icon_prefs.png"))
-
-        # Menus
-        self.prefsMenu = QtWidgets.QMenu("Preferences")
-        self.prefsMenu.addAction(self.echoAct)
-        self.prefsMenu.addAction(self.pinAct)
-        self.prefsMenu.addSeparator()
-        self.prefsMenu.addAction(self.nukepediaAct)
-        self.prefsMenu.addAction(self.githubAct)
-        self.prefsMenu.addSeparator()
-        self.prefsMenu.addAction(self.helpAct)
-        self.prefsMenu.addSeparator()
-        self.prefsMenu.addAction(self.snippetsAct)
-        self.prefsMenu.addAction(self.prefsAct)
-
-    def initEcho(self):
-        ''' Initializes the echo chechable QAction based on nuke's state '''
-        echo_knob = nuke.toNode("preferences").knob("echoAllCommands")
-        self.echoAct.setChecked(echo_knob.value())
-
-    def toggleEcho(self):
-        ''' Toggle the "Echo python commands" from Nuke '''
-        echo_knob = nuke.toNode("preferences").knob("echoAllCommands")
-        echo_knob.setValue(self.echoAct.isChecked())
-
-    def togglePin(self):
-        ''' Toggle "always on top" based on the submenu button '''
-        self.pin(self.pinAct.isChecked())
-
-    def showInNukepedia(self):
-        openUrl("http://www.nukepedia.com/python/ui/knobscripter")
-
-    def showInGithub(self):
-        openUrl("https://github.com/adrianpueyo/KnobScripter")
-
-    def showHelp(self):
-        openUrl("https://vimeo.com/adrianpueyo/knobscripter2")
-
-    # Node Mode
-
-    def updateKnobDropdown(self):
-        ''' Populate knob dropdown list '''
-        self.current_knob_dropdown.clear()  # First remove all items
-        defaultKnobs = ["knobChanged", "onCreate", "onScriptLoad", "onScriptSave", "onScriptClose", "onDestroy",
-                        "updateUI", "autolabel", "beforeRender", "beforeFrameRender", "afterFrameRender", "afterRender"]
-        permittedKnobClasses = ["PyScript_Knob", "PythonCustomKnob"]
-        counter = 0
-        for i in self.node.knobs():
-            if i not in defaultKnobs and self.node.knob(i).Class() in permittedKnobClasses:
-                if self.show_labels:
-                    i_full = "{} ({})".format(self.node.knob(i).label(), i)
-                else:
-                    i_full = i
-
-                if i in self.unsavedKnobs.keys():
-                    self.current_knob_dropdown.addItem(i_full + "(*)", i)
-                else:
-                    self.current_knob_dropdown.addItem(i_full, i)
-
-                counter += 1
-        if counter > 0:
-            self.current_knob_dropdown.insertSeparator(counter)
-            counter += 1
-            self.current_knob_dropdown.insertSeparator(counter)
-            counter += 1
-        for i in self.node.knobs():
-            if i in defaultKnobs:
-                if i in self.unsavedKnobs.keys():
-                    self.current_knob_dropdown.addItem(i + "(*)", i)
-                else:
-                    self.current_knob_dropdown.addItem(i, i)
-                counter += 1
-        return
-
-    def loadKnobValue(self, check=True, updateDict=False):
-        ''' Get the content of the knob value and populate the editor '''
-        if self.toLoadKnob == False:
-            return
-        dropdown_value = self.current_knob_dropdown.itemData(
-            self.current_knob_dropdown.currentIndex())  # knobChanged...
-        try:
-            obtained_knobValue = str(self.node[dropdown_value].value())
-            obtained_scrollValue = 0
-            edited_knobValue = self.script_editor.toPlainText()
-        except:
-            error_message = QtWidgets.QMessageBox.information(
-                None, "", "Unable to find %s.%s" % (self.node.name(), dropdown_value))
-            error_message.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-            error_message.exec_()
-            return
-        # If there were changes to the previous knob, update the dictionary
-        if updateDict == True:
-            self.unsavedKnobs[self.knob] = edited_knobValue
-            self.scrollPos[self.knob] = self.script_editor.verticalScrollBar(
-            ).value()
-        prev_knob = self.knob  # knobChanged...
-
-        self.knob = self.current_knob_dropdown.itemData(
-            self.current_knob_dropdown.currentIndex())  # knobChanged...
-
-        if check and obtained_knobValue != edited_knobValue:
-            msgBox = QtWidgets.QMessageBox()
-            msgBox.setText("The Script Editor has been modified.")
-            msgBox.setInformativeText(
-                "Do you want to overwrite the current code on this editor?")
-            msgBox.setStandardButtons(
-                QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No)
-            msgBox.setIcon(QtWidgets.QMessageBox.Question)
-            msgBox.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-            msgBox.setDefaultButton(QtWidgets.QMessageBox.Yes)
-            reply = msgBox.exec_()
-            if reply == QtWidgets.QMessageBox.No:
-                self.setCurrentKnob(prev_knob)
-                return
-        # If order comes from a dropdown update, update value from dictionary if possible, otherwise update normally
-        self.setWindowTitle("KnobScripter - %s %s" %
-                            (self.node.name(), self.knob))
-        if updateDict:
-            if self.knob in self.unsavedKnobs:
-                if self.unsavedKnobs[self.knob] == obtained_knobValue:
-                    self.script_editor.setPlainText(obtained_knobValue)
-                    self.setKnobModified(False)
-                else:
-                    obtained_knobValue = self.unsavedKnobs[self.knob]
-                    self.script_editor.setPlainText(obtained_knobValue)
-                    self.setKnobModified(True)
-            else:
-                self.script_editor.setPlainText(obtained_knobValue)
-                self.setKnobModified(False)
-
-            if self.knob in self.scrollPos:
-                obtained_scrollValue = self.scrollPos[self.knob]
-        else:
-            self.script_editor.setPlainText(obtained_knobValue)
-
-        cursor = self.script_editor.textCursor()
-        self.script_editor.setTextCursor(cursor)
-        self.script_editor.verticalScrollBar().setValue(obtained_scrollValue)
-        return
-
-    def loadAllKnobValues(self):
-        ''' Load all knobs button's function '''
-        if len(self.unsavedKnobs) >= 1:
-            msgBox = QtWidgets.QMessageBox()
-            msgBox.setText(
-                "Do you want to reload all python and callback knobs?")
-            msgBox.setInformativeText(
-                "Unsaved changes on this editor will be lost.")
-            msgBox.setStandardButtons(
-                QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No)
-            msgBox.setIcon(QtWidgets.QMessageBox.Question)
-            msgBox.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-            msgBox.setDefaultButton(QtWidgets.QMessageBox.Yes)
-            reply = msgBox.exec_()
-            if reply == QtWidgets.QMessageBox.No:
-                return
-        self.unsavedKnobs = {}
-        return
-
-    def saveKnobValue(self, check=True):
-        ''' Save the text from the editor to the node's knobChanged knob '''
-        dropdown_value = self.current_knob_dropdown.itemData(
-            self.current_knob_dropdown.currentIndex())
-        try:
-            obtained_knobValue = str(self.node[dropdown_value].value())
-            self.knob = dropdown_value
-        except:
-            error_message = QtWidgets.QMessageBox.information(
-                None, "", "Unable to find %s.%s" % (self.node.name(), dropdown_value))
-            error_message.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-            error_message.exec_()
-            return
-        edited_knobValue = self.script_editor.toPlainText()
-        if check and obtained_knobValue != edited_knobValue:
-            msgBox = QtWidgets.QMessageBox()
-            msgBox.setText("Do you want to overwrite %s.%s?" %
-                           (self.node.name(), dropdown_value))
-            msgBox.setStandardButtons(
-                QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No)
-            msgBox.setIcon(QtWidgets.QMessageBox.Question)
-            msgBox.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-            msgBox.setDefaultButton(QtWidgets.QMessageBox.Yes)
-            reply = msgBox.exec_()
-            if reply == QtWidgets.QMessageBox.No:
-                return
-        self.node[dropdown_value].setValue(edited_knobValue)
-        self.setKnobModified(
-            modified=False, knob=dropdown_value, changeTitle=True)
-        nuke.tcl("modified 1")
-        if self.knob in self.unsavedKnobs:
-            del self.unsavedKnobs[self.knob]
-        return
-
-    def saveAllKnobValues(self, check=True):
-        ''' Save all knobs button's function '''
-        if self.updateUnsavedKnobs() > 0 and check:
-            msgBox = QtWidgets.QMessageBox()
-            msgBox.setText(
-                "Do you want to save all modified python and callback knobs?")
-            msgBox.setStandardButtons(
-                QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No)
-            msgBox.setIcon(QtWidgets.QMessageBox.Question)
-            msgBox.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-            msgBox.setDefaultButton(QtWidgets.QMessageBox.Yes)
-            reply = msgBox.exec_()
-            if reply == QtWidgets.QMessageBox.No:
-                return
-        saveErrors = 0
-        savedCount = 0
-        for k in self.unsavedKnobs.copy():
-            try:
-                self.node.knob(k).setValue(self.unsavedKnobs[k])
-                del self.unsavedKnobs[k]
-                savedCount += 1
-                nuke.tcl("modified 1")
-            except:
-                saveErrors += 1
-        if saveErrors > 0:
-            errorBox = QtWidgets.QMessageBox()
-            errorBox.setText("Error saving %s knob%s." %
-                             (str(saveErrors), int(saveErrors > 1) * "s"))
-            errorBox.setIcon(QtWidgets.QMessageBox.Warning)
-            errorBox.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-            errorBox.setDefaultButton(QtWidgets.QMessageBox.Yes)
-            reply = errorBox.exec_()
-        else:
-            log("KnobScripter: %s knobs saved" % str(savedCount))
-        return
-
-    def setCurrentKnob(self, knobToSet):
-        ''' Set current knob '''
-        KnobDropdownItems = []
-        for i in range(self.current_knob_dropdown.count()):
-            if self.current_knob_dropdown.itemData(i) is not None:
-                KnobDropdownItems.append(
-                    self.current_knob_dropdown.itemData(i))
-            else:
-                KnobDropdownItems.append("---")
-        if knobToSet in KnobDropdownItems:
-            index = KnobDropdownItems.index(knobToSet)
-            self.current_knob_dropdown.setCurrentIndex(index)
-        return
-
-    def updateUnsavedKnobs(self, first_time=False):
-        ''' Clear unchanged knobs from the dict and return the number of unsaved knobs '''
-        if not self.node:
-            # Node has been deleted, so simply return 0. Who cares.
-            return 0
-        edited_knobValue = self.script_editor.toPlainText()
-        self.unsavedKnobs[self.knob] = edited_knobValue
-        if len(self.unsavedKnobs) > 0:
-            for k in self.unsavedKnobs.copy():
-                if self.node.knob(k):
-                    if str(self.node.knob(k).value()) == str(self.unsavedKnobs[k]):
-                        del self.unsavedKnobs[k]
-                else:
-                    del self.unsavedKnobs[k]
-        # Set appropriate knobs modified...
-        knobs_dropdown = self.current_knob_dropdown
-        all_knobs = [knobs_dropdown.itemData(i)
-                     for i in range(knobs_dropdown.count())]
-        for key in all_knobs:
-            if key in self.unsavedKnobs.keys():
-                self.setKnobModified(
-                    modified=True, knob=key, changeTitle=False)
-            else:
-                self.setKnobModified(
-                    modified=False, knob=key, changeTitle=False)
-
-        return len(self.unsavedKnobs)
-
-    def setKnobModified(self, modified=True, knob="", changeTitle=True):
-        ''' Sets the current knob modified, title and whatever else we need '''
-        if knob == "":
-            knob = self.knob
-        if modified:
-            self.modifiedKnobs.add(knob)
-        else:
-            self.modifiedKnobs.discard(knob)
-
-        if changeTitle:
-            title_modified_string = " [modified]"
-            windowTitle = self.windowTitle().split(title_modified_string)[0]
-            if modified == True:
-                windowTitle += title_modified_string
-            self.setWindowTitle(windowTitle)
-
-        try:
-            knobs_dropdown = self.current_knob_dropdown
-            kd_index = knobs_dropdown.currentIndex()
-            kd_data = knobs_dropdown.itemData(kd_index)
-            if self.show_labels and i not in defaultKnobs:
-                kd_data = "{} ({})".format(
-                    self.node.knob(kd_data).label(), kd_data)
-            if modified == False:
-                knobs_dropdown.setItemText(kd_index, kd_data)
-            else:
-                knobs_dropdown.setItemText(kd_index, kd_data + "(*)")
-        except:
-            pass
-
-    # Script Mode
-    def updateFoldersDropdown(self):
-        ''' Populate folders dropdown list '''
-        self.current_folder_dropdown.blockSignals(True)
-        self.current_folder_dropdown.clear()  # First remove all items
-        defaultFolders = ["scripts"]
-        scriptFolders = []
-        counter = 0
-        for f in defaultFolders:
-            self.makeScriptFolder(f)
-            self.current_folder_dropdown.addItem(f + "/", f)
-            counter += 1
-
-        try:
-            scriptFolders = sorted([f for f in os.listdir(self.scripts_dir) if os.path.isdir(
-                os.path.join(self.scripts_dir, f))])  # Accepts symlinks!!!
-        except:
-            log("Couldn't read any script folders.")
-
-        for f in scriptFolders:
-            fname = f.split("/")[-1]
-            if fname in defaultFolders:
-                continue
-            self.current_folder_dropdown.addItem(fname + "/", fname)
-            counter += 1
-
-        # print scriptFolders
-        if counter > 0:
-            self.current_folder_dropdown.insertSeparator(counter)
-            counter += 1
-            # self.current_folder_dropdown.insertSeparator(counter)
-            #counter += 1
-        self.current_folder_dropdown.addItem("New", "create new")
-        self.current_folder_dropdown.addItem("Open...", "open in browser")
-        self.current_folder_dropdown.addItem("Add custom", "add custom path")
-        self.folder_index = self.current_folder_dropdown.currentIndex()
-        self.current_folder = self.current_folder_dropdown.itemData(
-            self.folder_index)
-        self.current_folder_dropdown.blockSignals(False)
-        return
-
-    def updateScriptsDropdown(self):
-        ''' Populate py scripts dropdown list '''
-        self.current_script_dropdown.blockSignals(True)
-        self.current_script_dropdown.clear()  # First remove all items
-        QtWidgets.QApplication.processEvents()
-        log("# Updating scripts dropdown...")
-        log("scripts dir:" + self.scripts_dir)
-        log("current folder:" + self.current_folder)
-        log("previous current script:" + self.current_script)
-        #current_folder = self.current_folder_dropdown.itemData(self.current_folder_dropdown.currentIndex())
-        current_folder_path = os.path.join(
-            self.scripts_dir, self.current_folder)
-        defaultScripts = ["Untitled.py"]
-        found_scripts = []
-        counter = 0
-        # All files and folders inside of the folder
-        dir_list = os.listdir(current_folder_path)
-        try:
-            found_scripts = sorted([f for f in dir_list if f.endswith(".py")])
-            found_temp_scripts = [
-                f for f in dir_list if f.endswith(".py.autosave")]
-        except:
-            log("Couldn't find any scripts in the selected folder.")
-        if not len(found_scripts):
-            for s in defaultScripts:
-                if s + ".autosave" in found_temp_scripts:
-                    self.current_script_dropdown.addItem(s + "(*)", s)
-                else:
-                    self.current_script_dropdown.addItem(s, s)
-                counter += 1
-        else:
-            for s in defaultScripts:
-                if s + ".autosave" in found_temp_scripts:
-                    self.current_script_dropdown.addItem(s + "(*)", s)
-                elif s in found_scripts:
-                    self.current_script_dropdown.addItem(s, s)
-            for s in found_scripts:
-                if s in defaultScripts:
-                    continue
-                sname = s.split("/")[-1]
-                if s + ".autosave" in found_temp_scripts:
-                    self.current_script_dropdown.addItem(sname + "(*)", sname)
-                else:
-                    self.current_script_dropdown.addItem(sname, sname)
-                counter += 1
-        # else: #Add the found scripts to the dropdown
-        if counter > 0:
-            counter += 1
-            self.current_script_dropdown.insertSeparator(counter)
-            counter += 1
-            self.current_script_dropdown.insertSeparator(counter)
-        self.current_script_dropdown.addItem("New", "create new")
-        self.current_script_dropdown.addItem("Duplicate", "create duplicate")
-        self.current_script_dropdown.addItem("Delete", "delete script")
-        self.current_script_dropdown.addItem("Open", "open in browser")
-        #self.script_index = self.current_script_dropdown.currentIndex()
-        self.script_index = 0
-        self.current_script = self.current_script_dropdown.itemData(
-            self.script_index)
-        log("Finished updating scripts dropdown.")
-        log("current_script:" + self.current_script)
-        self.current_script_dropdown.blockSignals(False)
-        return
-
-    def makeScriptFolder(self, name="scripts"):
-        folder_path = os.path.join(self.scripts_dir, name)
-        if not os.path.exists(folder_path):
-            try:
-                os.makedirs(folder_path)
-                return True
-            except:
-                print "Couldn't create the scripting folders.\nPlease check your OS write permissions."
-                return False
-
-    def makeScriptFile(self, name="Untitled.py", folder="scripts", empty=True):
-        script_path = os.path.join(self.scripts_dir, self.current_folder, name)
-        if not os.path.isfile(script_path):
-            try:
-                self.current_script_file = open(script_path, 'w')
-                return True
-            except:
-                print "Couldn't create the scripting folders.\nPlease check your OS write permissions."
-                return False
-
-    def setCurrentFolder(self, folderName):
-        ''' Set current folder ON THE DROPDOWN ONLY'''
-        folderList = [self.current_folder_dropdown.itemData(
-            i) for i in range(self.current_folder_dropdown.count())]
-        if folderName in folderList:
-            index = folderList.index(folderName)
-            self.current_folder_dropdown.setCurrentIndex(index)
-            self.current_folder = folderName
-        self.folder_index = self.current_folder_dropdown.currentIndex()
-        self.current_folder = self.current_folder_dropdown.itemData(
-            self.folder_index)
-        return
-
-    def setCurrentScript(self, scriptName):
-        ''' Set current script ON THE DROPDOWN ONLY '''
-        scriptList = [self.current_script_dropdown.itemData(
-            i) for i in range(self.current_script_dropdown.count())]
-        if scriptName in scriptList:
-            index = scriptList.index(scriptName)
-            self.current_script_dropdown.setCurrentIndex(index)
-            self.current_script = scriptName
-        self.script_index = self.current_script_dropdown.currentIndex()
-        self.current_script = self.current_script_dropdown.itemData(
-            self.script_index)
-        return
-
-    def loadScriptContents(self, check=False, pyOnly=False, folder=""):
-        ''' Get the contents of the selected script and populate the editor '''
-        log("# About to load script contents now.")
-        obtained_scrollValue = 0
-        obtained_cursorPosValue = [0, 0]  # Position, anchor
-        if folder == "":
-            folder = self.current_folder
-        script_path = os.path.join(
-            self.scripts_dir, folder, self.current_script)
-        script_path_temp = script_path + ".autosave"
-        if (self.current_folder + "/" + self.current_script) in self.scrollPos:
-            obtained_scrollValue = self.scrollPos[self.current_folder +
-                                                  "/" + self.current_script]
-        if (self.current_folder + "/" + self.current_script) in self.cursorPos:
-            obtained_cursorPosValue = self.cursorPos[self.current_folder +
-                                                     "/" + self.current_script]
-
-        # 1: If autosave exists and pyOnly is false, load it
-        if os.path.isfile(script_path_temp) and not pyOnly:
-            log("Loading .py.autosave file\n---")
-            with open(script_path_temp, 'r') as script:
-                content = script.read()
-            self.script_editor.setPlainText(content)
-            self.setScriptModified(True)
-            self.script_editor.verticalScrollBar().setValue(obtained_scrollValue)
-
-        # 2: Try to load the .py as first priority, if it exists
-        elif os.path.isfile(script_path):
-            log("Loading .py file\n---")
-            with open(script_path, 'r') as script:
-                content = script.read()
-            current_text = self.script_editor.toPlainText().encode("utf8")
-            if check and current_text != content and current_text.strip() != "":
-                msgBox = QtWidgets.QMessageBox()
-                msgBox.setText("The script has been modified.")
-                msgBox.setInformativeText(
-                    "Do you want to overwrite the current code on this editor?")
-                msgBox.setStandardButtons(
-                    QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No)
-                msgBox.setIcon(QtWidgets.QMessageBox.Question)
-                msgBox.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-                msgBox.setDefaultButton(QtWidgets.QMessageBox.Yes)
-                reply = msgBox.exec_()
-                if reply == QtWidgets.QMessageBox.No:
-                    return
-            # Clear trash
-            if os.path.isfile(script_path_temp):
-                os.remove(script_path_temp)
-                log("Removed " + script_path_temp)
-            self.setScriptModified(False)
-            self.script_editor.setPlainText(content)
-            self.script_editor.verticalScrollBar().setValue(obtained_scrollValue)
-            self.setScriptModified(False)
-            self.loadScriptState()
-            self.setScriptState()
-
-        # 3: If .py doesn't exist... only then stick to the autosave
-        elif os.path.isfile(script_path_temp):
-            with open(script_path_temp, 'r') as script:
-                content = script.read()
-
-            msgBox = QtWidgets.QMessageBox()
-            msgBox.setText("The .py file hasn't been found.")
-            msgBox.setInformativeText(
-                "Do you want to clear the current code on this editor?")
-            msgBox.setStandardButtons(
-                QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No)
-            msgBox.setIcon(QtWidgets.QMessageBox.Question)
-            msgBox.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-            msgBox.setDefaultButton(QtWidgets.QMessageBox.Yes)
-            reply = msgBox.exec_()
-            if reply == QtWidgets.QMessageBox.No:
-                return
-
-            # Clear trash
-            os.remove(script_path_temp)
-            log("Removed " + script_path_temp)
-            self.script_editor.setPlainText("")
-            self.updateScriptsDropdown()
-            self.loadScriptContents(check=False)
-            self.loadScriptState()
-            self.setScriptState()
-
-        else:
-            content = ""
-            self.script_editor.setPlainText(content)
-            self.setScriptModified(False)
-            if self.current_folder + "/" + self.current_script in self.scrollPos:
-                del self.scrollPos[self.current_folder +
-                                   "/" + self.current_script]
-            if self.current_folder + "/" + self.current_script in self.cursorPos:
-                del self.cursorPos[self.current_folder +
-                                   "/" + self.current_script]
-
-        self.setWindowTitle("KnobScripter - %s/%s" %
-                            (self.current_folder, self.current_script))
-        return
-
-    def saveScriptContents(self, temp=True):
-        ''' Save the current contents of the editor into the python file. If temp == True, saves a .py.autosave file '''
-        log("\n# About to save script contents now.")
-        log("Temp mode is: " + str(temp))
-        log("self.current_folder: " + self.current_folder)
-        log("self.current_script: " + self.current_script)
-        script_path = os.path.join(
-            self.scripts_dir, self.current_folder, self.current_script)
-        script_path_temp = script_path + ".autosave"
-        orig_content = ""
-        content = self.script_editor.toPlainText().encode('utf8')
-
-        if temp == True:
-            if os.path.isfile(script_path):
-                with open(script_path, 'r') as script:
-                    orig_content = script.read()
-            # If script path doesn't exist and autosave does but the script is empty...
-            elif content == "" and os.path.isfile(script_path_temp):
-                os.remove(script_path_temp)
-                return
-            if content != orig_content:
-                with open(script_path_temp, 'w') as script:
-                    script.write(content)
-            else:
-                if os.path.isfile(script_path_temp):
-                    os.remove(script_path_temp)
-                log("Nothing to save")
-                return
-        else:
-            with open(script_path, 'w') as script:
-                script.write(self.script_editor.toPlainText().encode('utf8'))
-            # Clear trash
-            if os.path.isfile(script_path_temp):
-                os.remove(script_path_temp)
-                log("Removed " + script_path_temp)
-            self.setScriptModified(False)
-        self.saveScrollValue()
-        self.saveCursorPosValue()
-        log("Saved " + script_path + "\n---")
-        return
-
-    def deleteScript(self, check=True, folder=""):
-        ''' Get the contents of the selected script and populate the editor '''
-        log("# About to delete the .py and/or autosave script now.")
-        if folder == "":
-            folder = self.current_folder
-        script_path = os.path.join(
-            self.scripts_dir, folder, self.current_script)
-        script_path_temp = script_path + ".autosave"
-        if check:
-            msgBox = QtWidgets.QMessageBox()
-            msgBox.setText("You're about to delete this script.")
-            msgBox.setInformativeText(
-                "Are you sure you want to delete {}?".format(self.current_script))
-            msgBox.setStandardButtons(
-                QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No)
-            msgBox.setIcon(QtWidgets.QMessageBox.Question)
-            msgBox.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-            msgBox.setDefaultButton(QtWidgets.QMessageBox.No)
-            reply = msgBox.exec_()
-            if reply == QtWidgets.QMessageBox.No:
-                return False
-
-        if os.path.isfile(script_path_temp):
-            os.remove(script_path_temp)
-            log("Removed " + script_path_temp)
-
-        if os.path.isfile(script_path):
-            os.remove(script_path)
-            log("Removed " + script_path)
-
-        return True
-
-    def folderDropdownChanged(self):
-        '''Executed when the current folder dropdown is changed'''
-        self.saveScriptState()
-        log("# folder dropdown changed")
-        folders_dropdown = self.current_folder_dropdown
-        fd_value = folders_dropdown.currentText()
-        fd_index = folders_dropdown.currentIndex()
-        fd_data = folders_dropdown.itemData(fd_index)
-        if fd_data == "create new":
-            panel = FileNameDialog(self, mode="folder")
-            # panel.setWidth(260)
-            # panel.addSingleLineInput("Name:","")
-            if panel.exec_():
-                # Accepted
-                folder_name = panel.text
-                if os.path.isdir(os.path.join(self.scripts_dir, folder_name)):
-                    self.messageBox("Folder already exists.")
-                    self.setCurrentFolder(self.current_folder)
-                if self.makeScriptFolder(name=folder_name):
-                    self.saveScriptContents(temp=True)
-                    # Success creating the folder
-                    self.current_folder = folder_name
-                    self.updateFoldersDropdown()
-                    self.setCurrentFolder(folder_name)
-                    self.updateScriptsDropdown()
-                    self.loadScriptContents(check=False)
-                else:
-                    self.messageBox("There was a problem creating the folder.")
-                    self.current_folder_dropdown.blockSignals(True)
-                    self.current_folder_dropdown.setCurrentIndex(
-                        self.folder_index)
-                    self.current_folder_dropdown.blockSignals(False)
-            else:
-                # Canceled/rejected
-                self.current_folder_dropdown.blockSignals(True)
-                self.current_folder_dropdown.setCurrentIndex(self.folder_index)
-                self.current_folder_dropdown.blockSignals(False)
-                return
-
-        elif fd_data == "open in browser":
-            current_folder_path = os.path.join(
-                self.scripts_dir, self.current_folder)
-            self.openInFileBrowser(current_folder_path)
-            self.current_folder_dropdown.blockSignals(True)
-            self.current_folder_dropdown.setCurrentIndex(self.folder_index)
-            self.current_folder_dropdown.blockSignals(False)
-            return
-
-        elif fd_data == "add custom path":
-            folder_path = nuke.getFilename('Select custom folder.')
-            if folder_path is not None:
-                if folder_path.endswith("/"):
-                    aliasName = folder_path.split("/")[-2]
-                else:
-                    aliasName = folder_path.split("/")[-1]
-                if not os.path.isdir(folder_path):
-                    self.messageBox(
-                        "Folder not found. Please try again with the full path to a folder.")
-                elif not len(aliasName):
-                    self.messageBox(
-                        "Folder with the same name already exists. Please delete or rename it first.")
-                else:
-                    # All good
-                    os.symlink(folder_path, os.path.join(
-                        self.scripts_dir, aliasName))
-                    self.saveScriptContents(temp=True)
-                    self.current_folder = aliasName
-                    self.updateFoldersDropdown()
-                    self.setCurrentFolder(aliasName)
-                    self.updateScriptsDropdown()
-                    self.loadScriptContents(check=False)
-                    self.script_editor.setFocus()
-                    return
-            self.current_folder_dropdown.blockSignals(True)
-            self.current_folder_dropdown.setCurrentIndex(self.folder_index)
-            self.current_folder_dropdown.blockSignals(False)
-        else:
-            # 1: Save current script as temp if needed
-            self.saveScriptContents(temp=True)
-            # 2: Set the new folder in the variables
-            self.current_folder = fd_data
-            self.folder_index = fd_index
-            # 3: Update the scripts dropdown
-            self.updateScriptsDropdown()
-            # 4: Load the current script!
-            self.loadScriptContents()
-            self.script_editor.setFocus()
-
-            self.loadScriptState()
-            self.setScriptState()
-
-        return
-
-    def scriptDropdownChanged(self):
-        '''Executed when the current script dropdown is changed. Should only be called by the manual dropdown change. Not by other functions.'''
-        self.saveScriptState()
-        scripts_dropdown = self.current_script_dropdown
-        sd_value = scripts_dropdown.currentText()
-        sd_index = scripts_dropdown.currentIndex()
-        sd_data = scripts_dropdown.itemData(sd_index)
-        if sd_data == "create new":
-            self.current_script_dropdown.blockSignals(True)
-            panel = FileNameDialog(self, mode="script")
-            if panel.exec_():
-                # Accepted
-                script_name = panel.text + ".py"
-                script_path = os.path.join(
-                    self.scripts_dir, self.current_folder, script_name)
-                log(script_name)
-                log(script_path)
-                if os.path.isfile(script_path):
-                    self.messageBox("Script already exists.")
-                    self.current_script_dropdown.setCurrentIndex(
-                        self.script_index)
-                if self.makeScriptFile(name=script_name, folder=self.current_folder):
-                    # Success creating the folder
-                    self.saveScriptContents(temp=True)
-                    self.updateScriptsDropdown()
-                    if self.current_script != "Untitled.py":
-                        self.script_editor.setPlainText("")
-                    self.current_script = script_name
-                    self.setCurrentScript(script_name)
-                    self.saveScriptContents(temp=False)
-                    # self.loadScriptContents()
-                else:
-                    self.messageBox("There was a problem creating the script.")
-                    self.current_script_dropdown.setCurrentIndex(
-                        self.script_index)
-            else:
-                # Canceled/rejected
-                self.current_script_dropdown.setCurrentIndex(self.script_index)
-                return
-            self.current_script_dropdown.blockSignals(False)
-
-        elif sd_data == "create duplicate":
-            self.current_script_dropdown.blockSignals(True)
-            current_folder_path = os.path.join(
-                self.scripts_dir, self.current_folder, self.current_script)
-            current_script_path = os.path.join(
-                self.scripts_dir, self.current_folder, self.current_script)
-
-            current_name = self.current_script
-            if self.current_script.endswith(".py"):
-                current_name = current_name[:-3]
-
-            test_name = current_name
-            while True:
-                test_name += "_copy"
-                new_script_path = os.path.join(
-                    self.scripts_dir, self.current_folder, test_name + ".py")
-                if not os.path.isfile(new_script_path):
-                    break
-
-            script_name = test_name + ".py"
-
-            if self.makeScriptFile(name=script_name, folder=self.current_folder):
-                # Success creating the folder
-                self.saveScriptContents(temp=True)
-                self.updateScriptsDropdown()
-                # self.script_editor.setPlainText("")
-                self.current_script = script_name
-                self.setCurrentScript(script_name)
-                self.script_editor.setFocus()
-            else:
-                self.messageBox("There was a problem duplicating the script.")
-                self.current_script_dropdown.setCurrentIndex(self.script_index)
-
-            self.current_script_dropdown.blockSignals(False)
-
-        elif sd_data == "open in browser":
-            current_script_path = os.path.join(
-                self.scripts_dir, self.current_folder, self.current_script)
-            self.openInFileBrowser(current_script_path)
-            self.current_script_dropdown.blockSignals(True)
-            self.current_script_dropdown.setCurrentIndex(self.script_index)
-            self.current_script_dropdown.blockSignals(False)
-            return
-
-        elif sd_data == "delete script":
-            if self.deleteScript():
-                self.updateScriptsDropdown()
-                self.loadScriptContents()
-            else:
-                self.current_script_dropdown.blockSignals(True)
-                self.current_script_dropdown.setCurrentIndex(self.script_index)
-                self.current_script_dropdown.blockSignals(False)
-
-        else:
-            self.saveScriptContents()
-            self.current_script = sd_data
-            self.script_index = sd_index
-            self.setCurrentScript(self.current_script)
-            self.loadScriptContents()
-            self.script_editor.setFocus()
-            self.loadScriptState()
-            self.setScriptState()
-        return
-
-    def setScriptModified(self, modified=True):
-        ''' Sets self.current_script_modified, title and whatever else we need '''
-        self.current_script_modified = modified
-        title_modified_string = " [modified]"
-        windowTitle = self.windowTitle().split(title_modified_string)[0]
-        if modified == True:
-            windowTitle += title_modified_string
-        self.setWindowTitle(windowTitle)
-        try:
-            scripts_dropdown = self.current_script_dropdown
-            sd_index = scripts_dropdown.currentIndex()
-            sd_data = scripts_dropdown.itemData(sd_index)
-            if modified == False:
-                scripts_dropdown.setItemText(sd_index, sd_data)
-            else:
-                scripts_dropdown.setItemText(sd_index, sd_data + "(*)")
-        except:
-            pass
-
-    def openInFileBrowser(self, path=""):
-        OS = platform.system()
-        if not os.path.exists(path):
-            path = KS_DIR
-        if OS == "Windows":
-            os.startfile(path)
-        elif OS == "Darwin":
-            subprocess.Popen(["open", path])
-        else:
-            subprocess.Popen(["xdg-open", path])
-
-    def loadScriptState(self):
-        '''
-        Loads the last state of the script from a file inside the SE directory's root.
-        SAVES self.scroll_pos, self.cursor_pos, self.last_open_script
-        '''
-        self.state_dict = {}
-        if not os.path.isfile(self.state_txt_path):
-            return False
-        else:
-            with open(self.state_txt_path, "r") as f:
-                self.state_dict = json.load(f)
-
-        log("Loading script state into self.state_dict, self.scrollPos, self.cursorPos")
-        log(self.state_dict)
-
-        if "scroll_pos" in self.state_dict:
-            self.scrollPos = self.state_dict["scroll_pos"]
-        if "cursor_pos" in self.state_dict:
-            self.cursorPos = self.state_dict["cursor_pos"]
-
-    def setScriptState(self):
-        '''
-        Sets the already script state from self.state_dict into the current script if applicable
-        '''
-        script_fullname = self.current_folder + "/" + self.current_script
-
-        if "scroll_pos" in self.state_dict:
-            if script_fullname in self.state_dict["scroll_pos"]:
-                self.script_editor.verticalScrollBar().setValue(
-                    int(self.state_dict["scroll_pos"][script_fullname]))
-
-        if "cursor_pos" in self.state_dict:
-            if script_fullname in self.state_dict["cursor_pos"]:
-                cursor = self.script_editor.textCursor()
-                cursor.setPosition(int(
-                    self.state_dict["cursor_pos"][script_fullname][1]), QtGui.QTextCursor.MoveAnchor)
-                cursor.setPosition(int(
-                    self.state_dict["cursor_pos"][script_fullname][0]), QtGui.QTextCursor.KeepAnchor)
-                self.script_editor.setTextCursor(cursor)
-
-        if 'splitter_sizes' in self.state_dict:
-            self.splitter.setSizes(self.state_dict['splitter_sizes'])
-
-    def setLastScript(self):
-        if 'last_folder' in self.state_dict and 'last_script' in self.state_dict:
-            self.updateFoldersDropdown()
-            self.setCurrentFolder(self.state_dict['last_folder'])
-            self.updateScriptsDropdown()
-            self.setCurrentScript(self.state_dict['last_script'])
-            self.loadScriptContents()
-            self.script_editor.setFocus()
-
-    def saveScriptState(self):
-        ''' Stores the current state of the script into a file inside the SE directory's root '''
-        log("About to save script state...")
-        '''
-        # self.state_dict = {}
-        if os.path.isfile(self.state_txt_path):
-            with open(self.state_txt_path, "r") as f:
-                self.state_dict = json.load(f)
-
-        if "scroll_pos" in self.state_dict:
-            self.scrollPos = self.state_dict["scroll_pos"]
-        if "cursor_pos" in self.state_dict:
-            self.cursorPos = self.state_dict["cursor_pos"]
-
-        '''
-        self.loadScriptState()
-
-        # Overwrite current values into the scriptState
-        self.saveScrollValue()
-        self.saveCursorPosValue()
-
-        self.state_dict['scroll_pos'] = self.scrollPos
-        self.state_dict['cursor_pos'] = self.cursorPos
-        self.state_dict['last_folder'] = self.current_folder
-        self.state_dict['last_script'] = self.current_script
-        self.state_dict['splitter_sizes'] = self.splitter.sizes()
-
-        with open(self.state_txt_path, "w") as f:
-            state = json.dump(self.state_dict, f, sort_keys=True, indent=4)
-        return state
-
-    # Autosave background loop
-    def autosave(self):
-        if self.toAutosave:
-            # Save the script...
-            self.saveScriptContents()
-            self.toAutosave = False
-            self.saveScriptState()
-            log("autosaving...")
-            return
-
-    # Global stuff
-    def setTextSelection(self):
-        self.highlighter.selected_text = self.script_editor.textCursor().selection().toPlainText()
-        return
-
-    def eventFilter(self, object, event):
-        if event.type() == QtCore.QEvent.KeyPress:
-            return QtWidgets.QWidget.eventFilter(self, object, event)
-        else:
-            return QtWidgets.QWidget.eventFilter(self, object, event)
-
-    def resizeEvent(self, res_event):
-        w = self.frameGeometry().width()
-        self.current_node_label_node.setVisible(w > 460)
-        self.script_label.setVisible(w > 460)
-        return super(KnobScripter, self).resizeEvent(res_event)
-
-    def changeClicked(self, newNode=""):
-        ''' Change node '''
-        try:
-            print "Changing from " + self.node.name()
-        except:
-            self.node = None
-            if not len(nuke.selectedNodes()):
-                self.exitNodeMode()
-                return
-        nuke.menu("Nuke").findItem(
-            "Edit/Node/Update KnobScripter Context").invoke()
-        selection = knobScripterSelectedNodes
-        if self.nodeMode:  # Only update the number of unsaved knobs if we were already in node mode
-            if self.node is not None:
-                updatedCount = self.updateUnsavedKnobs()
-            else:
-                updatedCount = 0
-        else:
-            updatedCount = 0
-            self.autosave()
-        if newNode != "" and nuke.exists(newNode):
-            selection = [newNode]
-        elif not len(selection):
-            node_dialog = ChooseNodeDialog(self)
-            if node_dialog.exec_():
-                # Accepted
-                selection = [nuke.toNode(node_dialog.name)]
-            else:
-                return
-
-        # Change to node mode...
-        self.node_mode_bar.setVisible(True)
-        self.script_mode_bar.setVisible(False)
-        if not self.nodeMode:
-            self.saveScriptContents()
-            self.toAutosave = False
-            self.saveScriptState()
-            self.splitter.setSizes([0, 1])
-        self.nodeMode = True
-
-        # If already selected, pass
-        if self.node is not None and selection[0].fullName() == self.node.fullName():
-            self.messageBox("Please select a different node first!")
-            return
-        elif updatedCount > 0:
-            msgBox = QtWidgets.QMessageBox()
-            msgBox.setText(
-                "Save changes to %s knob%s before changing the node?" % (str(updatedCount), int(updatedCount > 1) * "s"))
-            msgBox.setStandardButtons(
-                QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No | QtWidgets.QMessageBox.Cancel)
-            msgBox.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-            msgBox.setDefaultButton(QtWidgets.QMessageBox.Yes)
-            reply = msgBox.exec_()
-            if reply == QtWidgets.QMessageBox.Yes:
-                self.saveAllKnobValues(check=False)
-            elif reply == QtWidgets.QMessageBox.Cancel:
-                return
-        if len(selection) > 1:
-            self.messageBox(
-                "More than one node selected.\nChanging knobChanged editor to %s" % selection[0].fullName())
-        # Reinitialise everything, wooo!
-        self.current_knob_dropdown.blockSignals(True)
-        self.node = selection[0]
-
-        self.script_editor.setPlainText("")
-        self.unsavedKnobs = {}
-        self.scrollPos = {}
-        self.setWindowTitle("KnobScripter - %s %s" %
-                            (self.node.fullName(), self.knob))
-        self.current_node_label_name.setText(self.node.fullName())
-
-        self.toLoadKnob = False
-        self.updateKnobDropdown()  # onee
-        # self.current_knob_dropdown.repaint()
-        # self.current_knob_dropdown.setMinimumWidth(self.current_knob_dropdown.minimumSizeHint().width())
-        self.toLoadKnob = True
-        self.setCurrentKnob(self.knob)
-        self.loadKnobValue(False)
-        self.script_editor.setFocus()
-        self.setKnobModified(False)
-        self.current_knob_dropdown.blockSignals(False)
-        # self.current_knob_dropdown.setMinimumContentsLength(80)
-        return
-
-    def exitNodeMode(self):
-        self.nodeMode = False
-        self.setWindowTitle("KnobScripter - Script Mode")
-        self.node_mode_bar.setVisible(False)
-        self.script_mode_bar.setVisible(True)
-        self.node = nuke.toNode("root")
-        # self.updateFoldersDropdown()
-        # self.updateScriptsDropdown()
-        self.splitter.setSizes([1, 1])
-        self.loadScriptState()
-        self.setLastScript()
-
-        self.loadScriptContents(check=False)
-        self.setScriptState()
-
-    def clearConsole(self):
-        self.origConsoleText = self.nukeSEOutput.document().toPlainText().encode("utf8")
-        self.script_output.setPlainText("")
-
-    def toggleFRW(self, frw_pressed):
-        self.frw_open = frw_pressed
-        self.frw.setVisible(self.frw_open)
-        if self.frw_open:
-            self.frw.find_lineEdit.setFocus()
-            self.frw.find_lineEdit.selectAll()
-        else:
-            self.script_editor.setFocus()
-        return
-
-    def openSnippets(self):
-        ''' Whenever the 'snippets' button is pressed... open the panel '''
-        global SnippetEditPanel
-        if SnippetEditPanel == "":
-            SnippetEditPanel = SnippetsPanel(self)
-
-        if not SnippetEditPanel.isVisible():
-            SnippetEditPanel.reload()
-
-        if SnippetEditPanel.show():
-            self.snippets = self.loadSnippets(maxDepth=5)
-            SnippetEditPanel = ""
-
-    def loadSnippets(self, path="", maxDepth=5, depth=0):
-        '''
-        Load prefs recursive. When maximum recursion depth, ignores paths.
-        '''
-        max_depth = maxDepth
-        cur_depth = depth
-        if path == "":
-            path = self.snippets_txt_path
-        if not os.path.isfile(path):
-            return {}
-        else:
-            loaded_snippets = {}
-            with open(path, "r") as f:
-                file = json.load(f)
-                for i, (key, val) in enumerate(file.items()):
-                    if re.match(r"\[custom-path-[0-9]+\]$", key):
-                        if cur_depth < max_depth:
-                            new_dict = self.loadSnippets(
-                                path=val, maxDepth=max_depth, depth=cur_depth + 1)
-                            loaded_snippets.update(new_dict)
-                    else:
-                        loaded_snippets[key] = val
-                return loaded_snippets
-
-    def messageBox(self, the_text=""):
-        ''' Just a simple message box '''
-        if self.isPane:
-            msgBox = QtWidgets.QMessageBox()
-        else:
-            msgBox = QtWidgets.QMessageBox(self)
-        msgBox.setText(the_text)
-        msgBox.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-        msgBox.exec_()
-
-    def openPrefs(self):
-        ''' Open the preferences panel '''
-        global PrefsPanel
-        if PrefsPanel == "":
-            PrefsPanel = KnobScripterPrefs(self)
-
-        if PrefsPanel.show():
-            PrefsPanel = ""
-
-    def loadPrefs(self):
-        ''' Load prefs '''
-        if not os.path.isfile(self.prefs_txt):
-            return []
-        else:
-            with open(self.prefs_txt, "r") as f:
-                prefs = json.load(f)
-                return prefs
-
-    def runScript(self):
-        ''' Run the current script... '''
-        self.script_editor.runScript()
-
-    def saveScrollValue(self):
-        ''' Save scroll values '''
-        if self.nodeMode:
-            self.scrollPos[self.knob] = self.script_editor.verticalScrollBar(
-            ).value()
-        else:
-            self.scrollPos[self.current_folder + "/" +
-                           self.current_script] = self.script_editor.verticalScrollBar().value()
-
-    def saveCursorPosValue(self):
-        ''' Save cursor pos and anchor values '''
-        self.cursorPos[self.current_folder + "/" + self.current_script] = [
-            self.script_editor.textCursor().position(), self.script_editor.textCursor().anchor()]
-
-    def closeEvent(self, close_event):
-        if self.nodeMode:
-            updatedCount = self.updateUnsavedKnobs()
-            if updatedCount > 0:
-                msgBox = QtWidgets.QMessageBox()
-                msgBox.setText("Save changes to %s knob%s before closing?" % (
-                    str(updatedCount), int(updatedCount > 1) * "s"))
-                msgBox.setStandardButtons(
-                    QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No | QtWidgets.QMessageBox.Cancel)
-                msgBox.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
-                msgBox.setDefaultButton(QtWidgets.QMessageBox.Yes)
-                reply = msgBox.exec_()
-                if reply == QtWidgets.QMessageBox.Yes:
-                    self.saveAllKnobValues(check=False)
-                    close_event.accept()
-                    return
-                elif reply == QtWidgets.QMessageBox.Cancel:
-                    close_event.ignore()
-                    return
-            else:
-                close_event.accept()
-        else:
-            self.autosave()
-            if self in AllKnobScripters:
-                AllKnobScripters.remove(self)
-            close_event.accept()
-
-    # Landing functions
-
-    def refreshClicked(self):
-        ''' Function to refresh the dropdowns '''
-        if self.nodeMode:
-            knob = self.current_knob_dropdown.itemData(
-                self.current_knob_dropdown.currentIndex()).encode('UTF8')
-            self.current_knob_dropdown.blockSignals(True)
-            self.current_knob_dropdown.clear()  # First remove all items
-            self.updateKnobDropdown()
-            availableKnobs = []
-            for i in range(self.current_knob_dropdown.count()):
-                if self.current_knob_dropdown.itemData(i) is not None:
-                    availableKnobs.append(
-                        self.current_knob_dropdown.itemData(i).encode('UTF8'))
-            if knob in availableKnobs:
-                self.setCurrentKnob(knob)
-            self.current_knob_dropdown.blockSignals(False)
-        else:
-            folder = self.current_folder
-            script = self.current_script
-            self.autosave()
-            self.updateFoldersDropdown()
-            self.setCurrentFolder(folder)
-            self.updateScriptsDropdown()
-            self.setCurrentScript(script)
-            self.script_editor.setFocus()
-
-    def reloadClicked(self):
-        if self.nodeMode:
-            self.loadKnobValue()
-        else:
-            log("Node mode is off")
-            self.loadScriptContents(check=True, pyOnly=True)
-
-    def saveClicked(self):
-        if self.nodeMode:
-            self.saveKnobValue(False)
-        else:
-            self.saveScriptContents(temp=False)
-
-    def setModified(self):
-        if self.nodeMode:
-            self.setKnobModified(True)
-        elif not self.current_script_modified:
-            self.setScriptModified(True)
-        if not self.nodeMode:
-            self.toAutosave = True
-
-    def pin(self, pressed):
-        if pressed:
-            self.setWindowFlags(self.windowFlags() |
-                                QtCore.Qt.WindowStaysOnTopHint)
-            self.pinned = True
-            self.show()
-        else:
-            self.setWindowFlags(self.windowFlags() & ~
-                                QtCore.Qt.WindowStaysOnTopHint)
-            self.pinned = False
-            self.show()
-
-    def findSE(self):
-        for widget in QtWidgets.QApplication.allWidgets():
-            if "Script Editor" in widget.windowTitle():
-                return widget
-
-    # FunctiosaveScrollValuens for Nuke's Script Editor
-    def findScriptEditors(self):
-        script_editors = []
-        for widget in QtWidgets.QApplication.allWidgets():
-            if "Script Editor" in widget.windowTitle() and len(widget.children()) > 5:
-                script_editors.append(widget)
-        return script_editors
-
-    def findSEInput(self, se):
-        return se.children()[-1].children()[0]
-
-    def findSEOutput(self, se):
-        return se.children()[-1].children()[1]
-
-    def findSERunBtn(self, se):
-        for btn in se.children():
-            try:
-                if "Run the current script" in btn.toolTip():
-                    return btn
-            except:
-                pass
-        return False
-
-    def setSEOutputEvent(self):
-        nukeScriptEditors = self.findScriptEditors()
-        # Take the console from the first script editor found...
-        self.origConsoleText = self.nukeSEOutput.document().toPlainText().encode("utf8")
-        for se in nukeScriptEditors:
-            se_output = self.findSEOutput(se)
-            se_output.textChanged.connect(
-                partial(consoleChanged, se_output, self))
-            consoleChanged(se_output, self)  # Initialise.
-
-
-class KnobScripterPane(KnobScripter):
-    def __init__(self, node="", knob="knobChanged"):
-        super(KnobScripterPane, self).__init__()
-        self.isPane = True
-
-    def showEvent(self, the_event):
-        try:
-            killPaneMargins(self)
-        except:
-            pass
-        return KnobScripter.showEvent(self, the_event)
-
-    def hideEvent(self, the_event):
-        self.autosave()
-        return KnobScripter.hideEvent(self, the_event)
-
-
-def consoleChanged(self, ks):
-    ''' This will be called every time the ScriptEditor Output text is changed '''
-    try:
-        if ks:  # KS exists
-            ksOutput = ks.script_output  # The console TextEdit widget
-            ksText = self.document().toPlainText().encode("utf8")
-            # The text from the console that will be omitted
-            origConsoleText = ks.origConsoleText
-            if ksText.startswith(origConsoleText):
-                ksText = ksText[len(origConsoleText):]
-            else:
-                ks.origConsoleText = ""
-            ksOutput.setPlainText(ksText)
-            ksOutput.verticalScrollBar().setValue(ksOutput.verticalScrollBar().maximum())
-    except:
-        pass
-
-
-def killPaneMargins(widget_object):
-    if widget_object:
-        target_widgets = set()
-        target_widgets.add(widget_object.parentWidget().parentWidget())
-        target_widgets.add(widget_object.parentWidget(
-        ).parentWidget().parentWidget().parentWidget())
-
-        for widget_layout in target_widgets:
-            try:
-                widget_layout.layout().setContentsMargins(0, 0, 0, 0)
-            except:
-                pass
-
-
-def debug(lev=0):
-    ''' Convenience function to set the KnobScripter on debug mode'''
-    # levels = [logging.DEBUG, logging.INFO, logging.WARNING, logging.ERROR, logging.CRITICAL]
-    # for handler in logging.root.handlers[:]:
-    #     logging.root.removeHandler(handler)
-    # logging.basicConfig(level=levels[lev])
-    # Changed to a shitty way for now
-    global DebugMode
-    DebugMode = True
-
-
-def log(text):
-    ''' Display a debug info message. Yes, in a stupid way. I know.'''
-    global DebugMode
-    if DebugMode:
-        print(text)
-
-
-# ---------------------------------------------------------------------
-# Dialogs
-# ---------------------------------------------------------------------
-class FileNameDialog(QtWidgets.QDialog):
-    '''
-    Dialog for creating new... (mode = "folder", "script" or "knob").
-    '''
-
-    def __init__(self, parent=None, mode="folder", text=""):
-        if parent.isPane:
-            super(FileNameDialog, self).__init__()
-        else:
-            super(FileNameDialog, self).__init__(parent)
-            #self.setWindowFlags(self.windowFlags() | QtCore.Qt.WindowStaysOnTopHint)
-        self.mode = mode
-        self.text = text
-
-        title = "Create new {}.".format(self.mode)
-        self.setWindowTitle(title)
-
-        self.initUI()
-
-    def initUI(self):
-        # Widgets
-        self.name_label = QtWidgets.QLabel("Name: ")
-        self.name_label.setAlignment(
-            QtCore.Qt.AlignRight | QtCore.Qt.AlignVCenter)
-        self.name_lineEdit = QtWidgets.QLineEdit()
-        self.name_lineEdit.setText(self.text)
-        self.name_lineEdit.textChanged.connect(self.nameChanged)
-
-        # Buttons
-        self.button_box = QtWidgets.QDialogButtonBox(
-            QtWidgets.QDialogButtonBox.Ok | QtWidgets.QDialogButtonBox.Cancel)
-        self.button_box.button(
-            QtWidgets.QDialogButtonBox.Ok).setEnabled(self.text != "")
-        self.button_box.accepted.connect(self.clickedOk)
-        self.button_box.rejected.connect(self.clickedCancel)
-
-        # Layout
-        self.master_layout = QtWidgets.QVBoxLayout()
-        self.name_layout = QtWidgets.QHBoxLayout()
-        self.name_layout.addWidget(self.name_label)
-        self.name_layout.addWidget(self.name_lineEdit)
-        self.master_layout.addLayout(self.name_layout)
-        self.master_layout.addWidget(self.button_box)
-        self.setLayout(self.master_layout)
-
-        self.name_lineEdit.setFocus()
-        self.setMinimumWidth(250)
-
-    def nameChanged(self):
-        txt = self.name_lineEdit.text()
-        m = r"[\w]*$"
-        if self.mode == "knob":  # Knobs can't start with a number...
-            m = r"[a-zA-Z_]+" + m
-
-        if re.match(m, txt) or txt == "":
-            self.text = txt
-        else:
-            self.name_lineEdit.setText(self.text)
-
-        self.button_box.button(
-            QtWidgets.QDialogButtonBox.Ok).setEnabled(self.text != "")
-        return
-
-    def clickedOk(self):
-        self.accept()
-        return
-
-    def clickedCancel(self):
-        self.reject()
-        return
-
-
-class TextInputDialog(QtWidgets.QDialog):
-    '''
-    Simple dialog for a text input.
-    '''
-
-    def __init__(self, parent=None, name="", text="", title=""):
-        if parent.isPane:
-            super(TextInputDialog, self).__init__()
-        else:
-            super(TextInputDialog, self).__init__(parent)
-            #self.setWindowFlags(self.windowFlags() | QtCore.Qt.WindowStaysOnTopHint)
-
-        self.name = name  # title of textinput
-        self.text = text  # default content of textinput
-
-        self.setWindowTitle(title)
-
-        self.initUI()
-
-    def initUI(self):
-        # Widgets
-        self.name_label = QtWidgets.QLabel(self.name + ": ")
-        self.name_label.setAlignment(
-            QtCore.Qt.AlignRight | QtCore.Qt.AlignVCenter)
-        self.name_lineEdit = QtWidgets.QLineEdit()
-        self.name_lineEdit.setText(self.text)
-        self.name_lineEdit.textChanged.connect(self.nameChanged)
-
-        # Buttons
-        self.button_box = QtWidgets.QDialogButtonBox(
-            QtWidgets.QDialogButtonBox.Ok | QtWidgets.QDialogButtonBox.Cancel)
-        #self.button_box.button(QtWidgets.QDialogButtonBox.Ok).setEnabled(self.text != "")
-        self.button_box.accepted.connect(self.clickedOk)
-        self.button_box.rejected.connect(self.clickedCancel)
-
-        # Layout
-        self.master_layout = QtWidgets.QVBoxLayout()
-        self.name_layout = QtWidgets.QHBoxLayout()
-        self.name_layout.addWidget(self.name_label)
-        self.name_layout.addWidget(self.name_lineEdit)
-        self.master_layout.addLayout(self.name_layout)
-        self.master_layout.addWidget(self.button_box)
-        self.setLayout(self.master_layout)
-
-        self.name_lineEdit.setFocus()
-        self.setMinimumWidth(250)
-
-    def nameChanged(self):
-        self.text = self.name_lineEdit.text()
-
-    def clickedOk(self):
-        self.accept()
-        return
-
-    def clickedCancel(self):
-        self.reject()
-        return
-
-
-class ChooseNodeDialog(QtWidgets.QDialog):
-    '''
-    Dialog for selecting a node by its name. Only admits nodes that exist (including root, preferences...)
-    '''
-
-    def __init__(self, parent=None, name=""):
-        if parent.isPane:
-            super(ChooseNodeDialog, self).__init__()
-        else:
-            super(ChooseNodeDialog, self).__init__(parent)
-
-        self.name = name  # Name of node (will be "" by default)
-        self.allNodes = []
-
-        self.setWindowTitle("Enter the node's name...")
-
-        self.initUI()
-
-    def initUI(self):
-        # Widgets
-        self.name_label = QtWidgets.QLabel("Name: ")
-        self.name_label.setAlignment(
-            QtCore.Qt.AlignRight | QtCore.Qt.AlignVCenter)
-        self.name_lineEdit = QtWidgets.QLineEdit()
-        self.name_lineEdit.setText(self.name)
-        self.name_lineEdit.textChanged.connect(self.nameChanged)
-
-        self.allNodes = self.getAllNodes()
-        completer = QtWidgets.QCompleter(self.allNodes, self)
-        completer.setCaseSensitivity(QtCore.Qt.CaseInsensitive)
-        self.name_lineEdit.setCompleter(completer)
-
-        # Buttons
-        self.button_box = QtWidgets.QDialogButtonBox(
-            QtWidgets.QDialogButtonBox.Ok | QtWidgets.QDialogButtonBox.Cancel)
-        self.button_box.button(QtWidgets.QDialogButtonBox.Ok).setEnabled(
-            nuke.exists(self.name))
-        self.button_box.accepted.connect(self.clickedOk)
-        self.button_box.rejected.connect(self.clickedCancel)
-
-        # Layout
-        self.master_layout = QtWidgets.QVBoxLayout()
-        self.name_layout = QtWidgets.QHBoxLayout()
-        self.name_layout.addWidget(self.name_label)
-        self.name_layout.addWidget(self.name_lineEdit)
-        self.master_layout.addLayout(self.name_layout)
-        self.master_layout.addWidget(self.button_box)
-        self.setLayout(self.master_layout)
-
-        self.name_lineEdit.setFocus()
-        self.setMinimumWidth(250)
-
-    def getAllNodes(self):
-        self.allNodes = [n.fullName() for n in nuke.allNodes(
-            recurseGroups=True)]  # if parent is in current context??
-        self.allNodes.extend(["root", "preferences"])
-        return self.allNodes
-
-    def nameChanged(self):
-        self.name = self.name_lineEdit.text()
-        self.button_box.button(QtWidgets.QDialogButtonBox.Ok).setEnabled(
-            self.name in self.allNodes)
-
-    def clickedOk(self):
-        self.accept()
-        return
-
-    def clickedCancel(self):
-        self.reject()
-        return
-
-
-# ------------------------------------------------------------------------------------------------------
-# Script Editor Widget
-# Wouter Gilsing built an incredibly useful python script editor for his Hotbox Manager, so I had it
-# really easy for this part!
-# Starting from his script editor, I changed the style and added the sublime-like functionality.
-# I think this bit of code has the potential to get used in many nuke tools.
-# Credit to him: http://www.woutergilsing.com/
-# Originally used on W_Hotbox v1.5: http://www.nukepedia.com/python/ui/w_hotbox
-# ------------------------------------------------------------------------------------------------------
-class KnobScripterTextEdit(QtWidgets.QPlainTextEdit):
-    # Signal that will be emitted when the user has changed the text
-    userChangedEvent = QtCore.Signal()
-
-    def __init__(self, knobScripter=""):
-        super(KnobScripterTextEdit, self).__init__()
-
-        self.knobScripter = knobScripter
-        self.selected_text = ""
-
-        # Setup line numbers
-        if self.knobScripter != "":
-            self.tabSpaces = self.knobScripter.tabSpaces
-        else:
-            self.tabSpaces = 4
-        self.lineNumberArea = KSLineNumberArea(self)
-        self.blockCountChanged.connect(self.updateLineNumberAreaWidth)
-        self.updateRequest.connect(self.updateLineNumberArea)
-        self.updateLineNumberAreaWidth()
-
-        # Highlight line
-        self.cursorPositionChanged.connect(self.highlightCurrentLine)
-
-    # --------------------------------------------------------------------------------------------------
-    # This is adapted from an original version by Wouter Gilsing.
-    # Extract from his original comments:
-    # While researching the implementation of line number, I had a look at Nuke's Blinkscript node. [..]
-    # thefoundry.co.uk/products/nuke/developers/100/pythonreference/nukescripts.blinkscripteditor-pysrc.html
-    # I stripped and modified the useful bits of the line number related parts of the code [..]
-    # Credits to theFoundry for writing the blinkscripteditor, best example code I could wish for.
-    # --------------------------------------------------------------------------------------------------
-
-    def lineNumberAreaWidth(self):
-        digits = 1
-        maxNum = max(1, self.blockCount())
-        while (maxNum >= 10):
-            maxNum /= 10
-            digits += 1
-
-        space = 7 + self.fontMetrics().width('9') * digits
-        return space
-
-    def updateLineNumberAreaWidth(self):
-        self.setViewportMargins(self.lineNumberAreaWidth(), 0, 0, 0)
-
-    def updateLineNumberArea(self, rect, dy):
-
-        if (dy):
-            self.lineNumberArea.scroll(0, dy)
-        else:
-            self.lineNumberArea.update(
-                0, rect.y(), self.lineNumberArea.width(), rect.height())
-
-        if (rect.contains(self.viewport().rect())):
-            self.updateLineNumberAreaWidth()
-
-    def resizeEvent(self, event):
-        QtWidgets.QPlainTextEdit.resizeEvent(self, event)
-
-        cr = self.contentsRect()
-        self.lineNumberArea.setGeometry(QtCore.QRect(
-            cr.left(), cr.top(), self.lineNumberAreaWidth(), cr.height()))
-
-    def lineNumberAreaPaintEvent(self, event):
-
-        if self.isReadOnly():
-            return
-
-        painter = QtGui.QPainter(self.lineNumberArea)
-        painter.fillRect(event.rect(), QtGui.QColor(36, 36, 36))  # Number bg
-
-        block = self.firstVisibleBlock()
-        blockNumber = block.blockNumber()
-        top = int(self.blockBoundingGeometry(
-            block).translated(self.contentOffset()).top())
-        bottom = top + int(self.blockBoundingRect(block).height())
-        currentLine = self.document().findBlock(
-            self.textCursor().position()).blockNumber()
-
-        painter.setPen(self.palette().color(QtGui.QPalette.Text))
-
-        painterFont = QtGui.QFont()
-        painterFont.setFamily("Courier")
-        painterFont.setStyleHint(QtGui.QFont.Monospace)
-        painterFont.setFixedPitch(True)
-        if self.knobScripter != "":
-            painterFont.setPointSize(self.knobScripter.fontSize)
-            painter.setFont(self.knobScripter.script_editor_font)
-
-        while (block.isValid() and top <= event.rect().bottom()):
-
-            textColor = QtGui.QColor(110, 110, 110)  # Numbers
-
-            if blockNumber == currentLine and self.hasFocus():
-                textColor = QtGui.QColor(255, 170, 0)  # Number highlighted
-
-            painter.setPen(textColor)
-
-            number = "%s" % str(blockNumber + 1)
-            painter.drawText(-3, top, self.lineNumberArea.width(),
-                             self.fontMetrics().height(), QtCore.Qt.AlignRight, number)
-
-            # Move to the next block
-            block = block.next()
-            top = bottom
-            bottom = top + int(self.blockBoundingRect(block).height())
-            blockNumber += 1
-
-    def keyPressEvent(self, event):
-        '''
-        Custom actions for specific keystrokes
-        '''
-        key = event.key()
-        ctrl = bool(event.modifiers() & Qt.ControlModifier)
-        alt = bool(event.modifiers() & Qt.AltModifier)
-        shift = bool(event.modifiers() & Qt.ShiftModifier)
-        pre_scroll = self.verticalScrollBar().value()
-        #modifiers = QtWidgets.QApplication.keyboardModifiers()
-        #ctrl = (modifiers == Qt.ControlModifier)
-        #shift = (modifiers == Qt.ShiftModifier)
-
-        up_arrow = 16777235
-        down_arrow = 16777237
-
-        # if Tab convert to Space
-        if key == 16777217:
-            self.indentation('indent')
-
-        # if Shift+Tab remove indent
-        elif key == 16777218:
-            self.indentation('unindent')
-
-        # if BackSpace try to snap to previous indent level
-        elif key == 16777219:
-            if not self.unindentBackspace():
-                QtWidgets.QPlainTextEdit.keyPressEvent(self, event)
-        else:
-            # COOL BEHAVIORS SIMILAR TO SUBLIME GO NEXT!
-            cursor = self.textCursor()
-            cpos = cursor.position()
-            apos = cursor.anchor()
-            text_before_cursor = self.toPlainText()[:min(cpos, apos)]
-            text_after_cursor = self.toPlainText()[max(cpos, apos):]
-            text_all = self.toPlainText()
-            to_line_start = text_before_cursor[::-1].find("\n")
-            if to_line_start == -1:
-                # Position of the start of the line that includes the cursor selection start
-                linestart_pos = 0
-            else:
-                linestart_pos = len(text_before_cursor) - to_line_start
-
-            to_line_end = text_after_cursor.find("\n")
-            if to_line_end == -1:
-                # Position of the end of the line that includes the cursor selection end
-                lineend_pos = len(text_all)
-            else:
-                lineend_pos = max(cpos, apos) + to_line_end
-
-            text_before_lines = text_all[:linestart_pos]
-            text_after_lines = text_all[lineend_pos:]
-            if len(text_after_lines) and text_after_lines.startswith("\n"):
-                text_after_lines = text_after_lines[1:]
-            text_lines = text_all[linestart_pos:lineend_pos]
-
-            if cursor.hasSelection():
-                selection = cursor.selection().toPlainText()
-            else:
-                selection = ""
-            if key == Qt.Key_ParenLeft and (len(selection) > 0 or re.match(r"[\s)}\];]+", text_after_cursor) or not len(text_after_cursor)):  # (
-                cursor.insertText("(" + selection + ")")
-                cursor.setPosition(apos + 1, QtGui.QTextCursor.MoveAnchor)
-                cursor.setPosition(cpos + 1, QtGui.QTextCursor.KeepAnchor)
-                self.setTextCursor(cursor)
-            # )
-            elif key == Qt.Key_ParenRight and text_after_cursor.startswith(")"):
-                cursor.movePosition(QtGui.QTextCursor.NextCharacter)
-                self.setTextCursor(cursor)
-            elif key == Qt.Key_BracketLeft and (len(selection) > 0 or re.match(r"[\s)}\];]+", text_after_cursor) or not len(text_after_cursor)):  # [
-                cursor.insertText("[" + selection + "]")
-                cursor.setPosition(apos + 1, QtGui.QTextCursor.MoveAnchor)
-                cursor.setPosition(cpos + 1, QtGui.QTextCursor.KeepAnchor)
-                self.setTextCursor(cursor)
-            # ]
-            elif key in [Qt.Key_BracketRight, 43] and text_after_cursor.startswith("]"):
-                cursor.movePosition(QtGui.QTextCursor.NextCharacter)
-                self.setTextCursor(cursor)
-            elif key == Qt.Key_BraceLeft and (len(selection) > 0 or re.match(r"[\s)}\];]+", text_after_cursor) or not len(text_after_cursor)):  # {
-                cursor.insertText("{" + selection + "}")
-                cursor.setPosition(apos + 1, QtGui.QTextCursor.MoveAnchor)
-                cursor.setPosition(cpos + 1, QtGui.QTextCursor.KeepAnchor)
-                self.setTextCursor(cursor)
-            # }
-            elif key in [199, Qt.Key_BraceRight] and text_after_cursor.startswith("}"):
-                cursor.movePosition(QtGui.QTextCursor.NextCharacter)
-                self.setTextCursor(cursor)
-            elif key == 34:  # "
-                if len(selection) > 0:
-                    cursor.insertText('"' + selection + '"')
-                    cursor.setPosition(apos + 1, QtGui.QTextCursor.MoveAnchor)
-                    cursor.setPosition(cpos + 1, QtGui.QTextCursor.KeepAnchor)
-                # and not re.search(r"(?:[\s)\]]+|$)",text_before_cursor):
-                elif text_after_cursor.startswith('"') and '"' in text_before_cursor.split("\n")[-1]:
-                    cursor.movePosition(QtGui.QTextCursor.NextCharacter)
-                # If chars after cursor, act normal
-                elif not re.match(r"(?:[\s)\]]+|$)", text_after_cursor):
-                    QtWidgets.QPlainTextEdit.keyPressEvent(self, event)
-                # If chars before cursor, act normal
-                elif not re.search(r"[\s.({\[,]$", text_before_cursor) and text_before_cursor != "":
-                    QtWidgets.QPlainTextEdit.keyPressEvent(self, event)
-                else:
-                    cursor.insertText('"' + selection + '"')
-                    cursor.setPosition(apos + 1, QtGui.QTextCursor.MoveAnchor)
-                    cursor.setPosition(cpos + 1, QtGui.QTextCursor.KeepAnchor)
-                self.setTextCursor(cursor)
-            elif key == 39:  # '
-                if len(selection) > 0:
-                    cursor.insertText("'" + selection + "'")
-                    cursor.setPosition(apos + 1, QtGui.QTextCursor.MoveAnchor)
-                    cursor.setPosition(cpos + 1, QtGui.QTextCursor.KeepAnchor)
-                # and not re.search(r"(?:[\s)\]]+|$)",text_before_cursor):
-                elif text_after_cursor.startswith("'") and "'" in text_before_cursor.split("\n")[-1]:
-                    cursor.movePosition(QtGui.QTextCursor.NextCharacter)
-                # If chars after cursor, act normal
-                elif not re.match(r"(?:[\s)\]]+|$)", text_after_cursor):
-                    QtWidgets.QPlainTextEdit.keyPressEvent(self, event)
-                # If chars before cursor, act normal
-                elif not re.search(r"[\s.({\[,]$", text_before_cursor) and text_before_cursor != "":
-                    QtWidgets.QPlainTextEdit.keyPressEvent(self, event)
-                else:
-                    cursor.insertText("'" + selection + "'")
-                    cursor.setPosition(apos + 1, QtGui.QTextCursor.MoveAnchor)
-                    cursor.setPosition(cpos + 1, QtGui.QTextCursor.KeepAnchor)
-                self.setTextCursor(cursor)
-            elif key == 35 and len(selection):  # (yes, a hash)
-                # If there's a selection, insert a hash at the start of each line.. how the fuck?
-                if selection != "":
-                    selection_split = selection.split("\n")
-                    if all(i.startswith("#") for i in selection_split):
-                        selection_commented = "\n".join(
-                            [s[1:] for s in selection_split])  # Uncommented
-                    else:
-                        selection_commented = "#" + "\n#".join(selection_split)
-                    cursor.insertText(selection_commented)
-                    if apos > cpos:
-                        cursor.setPosition(
-                            apos + len(selection_commented) - len(selection), QtGui.QTextCursor.MoveAnchor)
-                        cursor.setPosition(cpos, QtGui.QTextCursor.KeepAnchor)
-                    else:
-                        cursor.setPosition(apos, QtGui.QTextCursor.MoveAnchor)
-                        cursor.setPosition(
-                            cpos + len(selection_commented) - len(selection), QtGui.QTextCursor.KeepAnchor)
-                    self.setTextCursor(cursor)
-
-            elif key == 68 and ctrl and shift:  # Ctrl+Shift+D, to duplicate text or line/s
-
-                if not len(selection):
-                    self.setPlainText(
-                        text_before_lines + text_lines + "\n" + text_lines + "\n" + text_after_lines)
-                    cursor.setPosition(
-                        apos + len(text_lines) + 1, QtGui.QTextCursor.MoveAnchor)
-                    cursor.setPosition(
-                        cpos + len(text_lines) + 1, QtGui.QTextCursor.KeepAnchor)
-                    self.setTextCursor(cursor)
-                    self.verticalScrollBar().setValue(pre_scroll)
-                    self.scrollToCursor()
-                else:
-                    if text_before_cursor.endswith("\n") and not selection.startswith("\n"):
-                        cursor.insertText(selection + "\n" + selection)
-                        cursor.setPosition(
-                            apos + len(selection) + 1, QtGui.QTextCursor.MoveAnchor)
-                        cursor.setPosition(
-                            cpos + len(selection) + 1, QtGui.QTextCursor.KeepAnchor)
-                    else:
-                        cursor.insertText(selection + selection)
-                        cursor.setPosition(
-                            apos + len(selection), QtGui.QTextCursor.MoveAnchor)
-                        cursor.setPosition(
-                            cpos + len(selection), QtGui.QTextCursor.KeepAnchor)
-                    self.setTextCursor(cursor)
-
-            # Ctrl+Shift+Up, to move the selected line/s up
-            elif key == up_arrow and ctrl and shift and len(text_before_lines):
-                prev_line_start_distance = text_before_lines[:-1][::-1].find(
-                    "\n")
-                if prev_line_start_distance == -1:
-                    prev_line_start_pos = 0  # Position of the start of the previous line
-                else:
-                    prev_line_start_pos = len(
-                        text_before_lines) - 1 - prev_line_start_distance
-                prev_line = text_before_lines[prev_line_start_pos:]
-
-                text_before_prev_line = text_before_lines[:prev_line_start_pos]
-
-                if prev_line.endswith("\n"):
-                    prev_line = prev_line[:-1]
-
-                if len(text_after_lines):
-                    text_after_lines = "\n" + text_after_lines
-
-                self.setPlainText(
-                    text_before_prev_line + text_lines + "\n" + prev_line + text_after_lines)
-                cursor.setPosition(apos - len(prev_line) - 1,
-                                   QtGui.QTextCursor.MoveAnchor)
-                cursor.setPosition(cpos - len(prev_line) - 1,
-                                   QtGui.QTextCursor.KeepAnchor)
-                self.setTextCursor(cursor)
-                self.verticalScrollBar().setValue(pre_scroll)
-                self.scrollToCursor()
-                return
-
-            elif key == down_arrow and ctrl and shift:  # Ctrl+Shift+Up, to move the selected line/s up
-                if not len(text_after_lines):
-                    text_after_lines = ""
-                next_line_end_distance = text_after_lines.find("\n")
-                if next_line_end_distance == -1:
-                    next_line_end_pos = len(text_all)
-                else:
-                    next_line_end_pos = next_line_end_distance
-                next_line = text_after_lines[:next_line_end_pos]
-                text_after_next_line = text_after_lines[next_line_end_pos:]
-
-                self.setPlainText(text_before_lines + next_line +
-                                  "\n" + text_lines + text_after_next_line)
-                cursor.setPosition(apos + len(next_line) + 1,
-                                   QtGui.QTextCursor.MoveAnchor)
-                cursor.setPosition(cpos + len(next_line) + 1,
-                                   QtGui.QTextCursor.KeepAnchor)
-                self.setTextCursor(cursor)
-                self.verticalScrollBar().setValue(pre_scroll)
-                self.scrollToCursor()
-                return
-
-            # If up key and nothing happens, go to start
-            elif key == up_arrow and not len(text_before_lines):
-                if not shift:
-                    cursor.setPosition(0, QtGui.QTextCursor.MoveAnchor)
-                    self.setTextCursor(cursor)
-                else:
-                    cursor.setPosition(0, QtGui.QTextCursor.KeepAnchor)
-                    self.setTextCursor(cursor)
-
-            # If up key and nothing happens, go to start
-            elif key == down_arrow and not len(text_after_lines):
-                if not shift:
-                    cursor.setPosition(
-                        len(text_all), QtGui.QTextCursor.MoveAnchor)
-                    self.setTextCursor(cursor)
-                else:
-                    cursor.setPosition(
-                        len(text_all), QtGui.QTextCursor.KeepAnchor)
-                    self.setTextCursor(cursor)
-
-            # if enter or return, match indent level
-            elif key in [16777220, 16777221]:
-                self.indentNewLine()
-            else:
-                QtWidgets.QPlainTextEdit.keyPressEvent(self, event)
-
-        self.scrollToCursor()
-
-    def scrollToCursor(self):
-        self.cursor = self.textCursor()
-        # Does nothing, but makes the scroll go to the right place...
-        self.cursor.movePosition(QtGui.QTextCursor.NoMove)
-        self.setTextCursor(self.cursor)
-
-    def getCursorInfo(self):
-
-        self.cursor = self.textCursor()
-
-        self.firstChar = self.cursor.selectionStart()
-        self.lastChar = self.cursor.selectionEnd()
-
-        self.noSelection = False
-        if self.firstChar == self.lastChar:
-            self.noSelection = True
-
-        self.originalPosition = self.cursor.position()
-        self.cursorBlockPos = self.cursor.positionInBlock()
-
-    def unindentBackspace(self):
-        '''
-        #snap to previous indent level
-        '''
-        self.getCursorInfo()
-
-        if not self.noSelection or self.cursorBlockPos == 0:
-            return False
-
-        # check text in front of cursor
-        textInFront = self.document().findBlock(
-            self.firstChar).text()[:self.cursorBlockPos]
-
-        # check whether solely spaces
-        if textInFront != ' ' * self.cursorBlockPos:
-            return False
-
-        # snap to previous indent level
-        spaces = len(textInFront)
-        for space in range(spaces - ((spaces - 1) / self.tabSpaces) * self.tabSpaces - 1):
-            self.cursor.deletePreviousChar()
-
-    def indentNewLine(self):
-
-        # in case selection covers multiple line, make it one line first
-        self.insertPlainText('')
-
-        self.getCursorInfo()
-
-        # check how many spaces after cursor
-        text = self.document().findBlock(self.firstChar).text()
-
-        textInFront = text[:self.cursorBlockPos]
-
-        if len(textInFront) == 0:
-            self.insertPlainText('\n')
-            return
-
-        indentLevel = 0
-        for i in textInFront:
-            if i == ' ':
-                indentLevel += 1
-            else:
-                break
-
-        indentLevel /= self.tabSpaces
-
-        # find out whether textInFront's last character was a ':'
-        # if that's the case add another indent.
-        # ignore any spaces at the end, however also
-        # make sure textInFront is not just an indent
-        if textInFront.count(' ') != len(textInFront):
-            while textInFront[-1] == ' ':
-                textInFront = textInFront[:-1]
-
-        if textInFront[-1] == ':':
-            indentLevel += 1
-
-        # new line
-        self.insertPlainText('\n')
-        # match indent
-        self.insertPlainText(' ' * (self.tabSpaces * indentLevel))
-
-    def indentation(self, mode):
-
-        pre_scroll = self.verticalScrollBar().value()
-        self.getCursorInfo()
-
-        # if nothing is selected and mode is set to indent, simply insert as many
-        # space as needed to reach the next indentation level.
-        if self.noSelection and mode == 'indent':
-
-            remainingSpaces = self.tabSpaces - \
-                (self.cursorBlockPos % self.tabSpaces)
-            self.insertPlainText(' ' * remainingSpaces)
-            return
-
-        selectedBlocks = self.findBlocks(self.firstChar, self.lastChar)
-        beforeBlocks = self.findBlocks(
-            last=self.firstChar - 1, exclude=selectedBlocks)
-        afterBlocks = self.findBlocks(
-            first=self.lastChar + 1, exclude=selectedBlocks)
-
-        beforeBlocksText = self.blocks2list(beforeBlocks)
-        selectedBlocksText = self.blocks2list(selectedBlocks, mode)
-        afterBlocksText = self.blocks2list(afterBlocks)
-
-        combinedText = '\n'.join(
-            beforeBlocksText + selectedBlocksText + afterBlocksText)
-
-        # make sure the line count stays the same
-        originalBlockCount = len(self.toPlainText().split('\n'))
-        combinedText = '\n'.join(combinedText.split('\n')[:originalBlockCount])
-
-        self.clear()
-        self.setPlainText(combinedText)
-
-        if self.noSelection:
-            self.cursor.setPosition(self.lastChar)
-
-        # check whether the the original selection was from top to bottom or vice versa
-        else:
-            if self.originalPosition == self.firstChar:
-                first = self.lastChar
-                last = self.firstChar
-                firstBlockSnap = QtGui.QTextCursor.EndOfBlock
-                lastBlockSnap = QtGui.QTextCursor.StartOfBlock
-            else:
-                first = self.firstChar
-                last = self.lastChar
-                firstBlockSnap = QtGui.QTextCursor.StartOfBlock
-                lastBlockSnap = QtGui.QTextCursor.EndOfBlock
-
-            self.cursor.setPosition(first)
-            self.cursor.movePosition(
-                firstBlockSnap, QtGui.QTextCursor.MoveAnchor)
-            self.cursor.setPosition(last, QtGui.QTextCursor.KeepAnchor)
-            self.cursor.movePosition(
-                lastBlockSnap, QtGui.QTextCursor.KeepAnchor)
-
-        self.setTextCursor(self.cursor)
-        self.verticalScrollBar().setValue(pre_scroll)
-
-    def findBlocks(self, first=0, last=None, exclude=[]):
-        blocks = []
-        if last == None:
-            last = self.document().characterCount()
-        for pos in range(first, last + 1):
-            block = self.document().findBlock(pos)
-            if block not in blocks and block not in exclude:
-                blocks.append(block)
-        return blocks
-
-    def blocks2list(self, blocks, mode=None):
-        text = []
-        for block in blocks:
-            blockText = block.text()
-            if mode == 'unindent':
-                if blockText.startswith(' ' * self.tabSpaces):
-                    blockText = blockText[self.tabSpaces:]
-                    self.lastChar -= self.tabSpaces
-                elif blockText.startswith('\t'):
-                    blockText = blockText[1:]
-                    self.lastChar -= 1
-
-            elif mode == 'indent':
-                blockText = ' ' * self.tabSpaces + blockText
-                self.lastChar += self.tabSpaces
-
-            text.append(blockText)
-
-        return text
-
-    def highlightCurrentLine(self):
-        '''
-        Highlight currently selected line
-        '''
-        extraSelections = []
-
-        selection = QtWidgets.QTextEdit.ExtraSelection()
-
-        lineColor = QtGui.QColor(62, 62, 62, 255)
-
-        selection.format.setBackground(lineColor)
-        selection.format.setProperty(
-            QtGui.QTextFormat.FullWidthSelection, True)
-        selection.cursor = self.textCursor()
-        selection.cursor.clearSelection()
-
-        extraSelections.append(selection)
-
-        self.setExtraSelections(extraSelections)
-        self.scrollToCursor()
-
-    def format(self, rgb, style=''):
-        '''
-        Return a QtWidgets.QTextCharFormat with the given attributes.
-        '''
-        color = QtGui.QColor(*rgb)
-        textFormat = QtGui.QTextCharFormat()
-        textFormat.setForeground(color)
-
-        if 'bold' in style:
-            textFormat.setFontWeight(QtGui.QFont.Bold)
-        if 'italic' in style:
-            textFormat.setFontItalic(True)
-        if 'underline' in style:
-            textFormat.setUnderlineStyle(QtGui.QTextCharFormat.SingleUnderline)
-
-        return textFormat
-
-
-class KSLineNumberArea(QtWidgets.QWidget):
-    def __init__(self, scriptEditor):
-        super(KSLineNumberArea, self).__init__(scriptEditor)
-
-        self.scriptEditor = scriptEditor
-        self.setStyleSheet("text-align: center;")
-
-    def paintEvent(self, event):
-        self.scriptEditor.lineNumberAreaPaintEvent(event)
-        return
-
-
-class KSScriptEditorHighlighter(QtGui.QSyntaxHighlighter):
-    '''
-    This is also adapted from an original version by Wouter Gilsing. His comments:
-
-    Modified, simplified version of some code found I found when researching:
-    wiki.python.org/moin/PyQt/Python%20syntax%20highlighting
-    They did an awesome job, so credits to them. I only needed to make some
-    modifications to make it fit my needs.
-    '''
-
-    def __init__(self, document, parent=None):
-
-        super(KSScriptEditorHighlighter, self).__init__(document)
-        self.knobScripter = parent
-        self.script_editor = self.knobScripter.script_editor
-        self.selected_text = ""
-        self.selected_text_prev = ""
-        self.rules_sublime = ""
-
-        self.styles = {
-            'keyword': self.format([238, 117, 181], 'bold'),
-            'string': self.format([242, 136, 135]),
-            'comment': self.format([143, 221, 144]),
-            'numbers': self.format([174, 129, 255]),
-            'custom': self.format([255, 170, 0], 'italic'),
-            'selected': self.format([255, 255, 255], 'bold underline'),
-            'underline': self.format([240, 240, 240], 'underline'),
-        }
-
-        self.keywords = [
-            'and', 'assert', 'break', 'class', 'continue', 'def',
-            'del', 'elif', 'else', 'except', 'exec', 'finally',
-            'for', 'from', 'global', 'if', 'import', 'in',
-            'is', 'lambda', 'not', 'or', 'pass', 'print',
-            'raise', 'return', 'try', 'while', 'yield', 'with', 'as'
-        ]
-
-        self.operatorKeywords = [
-            '=', '==', '!=', '<', '<=', '>', '>=',
-            '\+', '-', '\*', '/', '//', '\%', '\*\*',
-            '\+=', '-=', '\*=', '/=', '\%=',
-            '\^', '\|', '\&', '\~', '>>', '<<'
-        ]
-
-        self.variableKeywords = ['int', 'str',
-                                 'float', 'bool', 'list', 'dict', 'set']
-
-        self.numbers = ['True', 'False', 'None']
-        self.loadAltStyles()
-
-        self.tri_single = (QtCore.QRegExp("'''"), 1, self.styles['comment'])
-        self.tri_double = (QtCore.QRegExp('"""'), 2, self.styles['comment'])
-
-        # rules
-        rules = []
-
-        rules += [(r'\b%s\b' % i, 0, self.styles['keyword'])
-                  for i in self.keywords]
-        rules += [(i, 0, self.styles['keyword'])
-                  for i in self.operatorKeywords]
-        rules += [(r'\b%s\b' % i, 0, self.styles['numbers'])
-                  for i in self.numbers]
-
-        rules += [
-
-            # integers
-            (r'\b[0-9]+\b', 0, self.styles['numbers']),
-            # Double-quoted string, possibly containing escape sequences
-            (r'"[^"\\]*(\\.[^"\\]*)*"', 0, self.styles['string']),
-            # Single-quoted string, possibly containing escape sequences
-            (r"'[^'\\]*(\\.[^'\\]*)*'", 0, self.styles['string']),
-            # From '#' until a newline
-            (r'#[^\n]*', 0, self.styles['comment']),
-        ]
-
-        # Build a QRegExp for each pattern
-        self.rules_nuke = [(QtCore.QRegExp(pat), index, fmt)
-                           for (pat, index, fmt) in rules]
-        self.rules = self.rules_nuke
-
-    def loadAltStyles(self):
-        ''' Loads other color styles apart from Nuke's default. '''
-        self.styles_sublime = {
-            'base': self.format([255, 255, 255]),
-            'keyword': self.format([237, 36, 110]),
-            'string': self.format([237, 229, 122]),
-            'comment': self.format([125, 125, 125]),
-            'numbers': self.format([165, 120, 255]),
-            'functions': self.format([184, 237, 54]),
-            'blue': self.format([130, 226, 255], 'italic'),
-            'arguments': self.format([255, 170, 10], 'italic'),
-            'custom': self.format([200, 200, 200], 'italic'),
-            'underline': self.format([240, 240, 240], 'underline'),
-            'selected': self.format([255, 255, 255], 'bold underline'),
-        }
-
-        self.keywords_sublime = [
-            'and', 'assert', 'break', 'continue',
-            'del', 'elif', 'else', 'except', 'exec', 'finally',
-            'for', 'from', 'global', 'if', 'import', 'in',
-            'is', 'lambda', 'not', 'or', 'pass', 'print',
-            'raise', 'return', 'try', 'while', 'yield', 'with', 'as'
-        ]
-        self.operatorKeywords_sublime = [
-            '=', '==', '!=', '<', '<=', '>', '>=',
-            '\+', '-', '\*', '/', '//', '\%', '\*\*',
-            '\+=', '-=', '\*=', '/=', '\%=',
-            '\^', '\|', '\&', '\~', '>>', '<<'
-        ]
-
-        self.baseKeywords_sublime = [
-            ',',
-        ]
-
-        self.customKeywords_sublime = [
-            'nuke',
-        ]
-
-        self.blueKeywords_sublime = [
-            'def', 'class', 'int', 'str', 'float', 'bool', 'list', 'dict', 'set'
-        ]
-
-        self.argKeywords_sublime = [
-            'self',
-        ]
-
-        self.tri_single_sublime = (QtCore.QRegExp(
-            "'''"), 1, self.styles_sublime['comment'])
-        self.tri_double_sublime = (QtCore.QRegExp(
-            '"""'), 2, self.styles_sublime['comment'])
-        self.numbers_sublime = ['True', 'False', 'None']
-
-        # rules
-
-        rules = []
-        # First turn everything inside parentheses orange
-        rules += [(r"def [\w]+[\s]*\((.*)\)", 1,
-                   self.styles_sublime['arguments'])]
-        # Now restore unwanted stuff...
-        rules += [(i, 0, self.styles_sublime['base'])
-                  for i in self.baseKeywords_sublime]
-        rules += [(r"[^\(\w),.][\s]*[\w]+", 0, self.styles_sublime['base'])]
-
-        # Everything else
-        rules += [(r'\b%s\b' % i, 0, self.styles_sublime['keyword'])
-                  for i in self.keywords_sublime]
-        rules += [(i, 0, self.styles_sublime['keyword'])
-                  for i in self.operatorKeywords_sublime]
-        rules += [(i, 0, self.styles_sublime['custom'])
-                  for i in self.customKeywords_sublime]
-        rules += [(r'\b%s\b' % i, 0, self.styles_sublime['blue'])
-                  for i in self.blueKeywords_sublime]
-        rules += [(i, 0, self.styles_sublime['arguments'])
-                  for i in self.argKeywords_sublime]
-        rules += [(r'\b%s\b' % i, 0, self.styles_sublime['numbers'])
-                  for i in self.numbers_sublime]
-
-        rules += [
-
-            # integers
-            (r'\b[0-9]+\b', 0, self.styles_sublime['numbers']),
-            # Double-quoted string, possibly containing escape sequences
-            (r'"[^"\\]*(\\.[^"\\]*)*"', 0, self.styles_sublime['string']),
-            # Single-quoted string, possibly containing escape sequences
-            (r"'[^'\\]*(\\.[^'\\]*)*'", 0, self.styles_sublime['string']),
-            # From '#' until a newline
-            (r'#[^\n]*', 0, self.styles_sublime['comment']),
-            # Function definitions
-            (r"def[\s]+([\w\.]+)", 1, self.styles_sublime['functions']),
-            # Class definitions
-            (r"class[\s]+([\w\.]+)", 1, self.styles_sublime['functions']),
-            # Class argument (which is also a class so must be green)
-            (r"class[\s]+[\w\.]+[\s]*\((.*)\)",
-             1, self.styles_sublime['functions']),
-            # Function arguments also pick their style...
-            (r"def[\s]+[\w]+[\s]*\(([\w]+)", 1,
-             self.styles_sublime['arguments']),
-        ]
-
-        # Build a QRegExp for each pattern
-        self.rules_sublime = [(QtCore.QRegExp(pat), index, fmt)
-                              for (pat, index, fmt) in rules]
-
-    def format(self, rgb, style=''):
-        '''
-        Return a QtWidgets.QTextCharFormat with the given attributes.
-        '''
-
-        color = QtGui.QColor(*rgb)
-        textFormat = QtGui.QTextCharFormat()
-        textFormat.setForeground(color)
-
-        if 'bold' in style:
-            textFormat.setFontWeight(QtGui.QFont.Bold)
-        if 'italic' in style:
-            textFormat.setFontItalic(True)
-        if 'underline' in style:
-            textFormat.setUnderlineStyle(QtGui.QTextCharFormat.SingleUnderline)
-
-        return textFormat
-
-    def highlightBlock(self, text):
-        '''
-        Apply syntax highlighting to the given block of text.
-        '''
-        # Do other syntax formatting
-
-        if self.knobScripter.color_scheme:
-            self.color_scheme = self.knobScripter.color_scheme
-        else:
-            self.color_scheme = "nuke"
-
-        if self.color_scheme == "nuke":
-            self.rules = self.rules_nuke
-        elif self.color_scheme == "sublime":
-            self.rules = self.rules_sublime
-
-        for expression, nth, format in self.rules:
-            index = expression.indexIn(text, 0)
-
-            while index >= 0:
-                # We actually want the index of the nth match
-                index = expression.pos(nth)
-                length = len(expression.cap(nth))
-                self.setFormat(index, length, format)
-                index = expression.indexIn(text, index + length)
-
-        self.setCurrentBlockState(0)
-
-        # Multi-line strings etc. based on selected scheme
-        if self.color_scheme == "nuke":
-            in_multiline = self.match_multiline(text, *self.tri_single)
-            if not in_multiline:
-                in_multiline = self.match_multiline(text, *self.tri_double)
-        elif self.color_scheme == "sublime":
-            in_multiline = self.match_multiline(text, *self.tri_single_sublime)
-            if not in_multiline:
-                in_multiline = self.match_multiline(
-                    text, *self.tri_double_sublime)
-
-        # TODO if there's a selection, highlight same occurrences in the full document. If no selection but something highlighted, unhighlight full document. (do it thru regex or sth)
-
-    def match_multiline(self, text, delimiter, in_state, style):
-        '''
-        Check whether highlighting requires multiple lines.
-        '''
-        # If inside triple-single quotes, start at 0
-        if self.previousBlockState() == in_state:
-            start = 0
-            add = 0
-        # Otherwise, look for the delimiter on this line
-        else:
-            start = delimiter.indexIn(text)
-            # Move past this match
-            add = delimiter.matchedLength()
-
-        # As long as there's a delimiter match on this line...
-        while start >= 0:
-            # Look for the ending delimiter
-            end = delimiter.indexIn(text, start + add)
-            # Ending delimiter on this line?
-            if end >= add:
-                length = end - start + add + delimiter.matchedLength()
-                self.setCurrentBlockState(0)
-            # No; multi-line string
-            else:
-                self.setCurrentBlockState(in_state)
-                length = len(text) - start + add
-            # Apply formatting
-            self.setFormat(start, length, style)
-            # Look for the next match
-            start = delimiter.indexIn(text, start + length)
-
-        # Return True if still inside a multi-line string, False otherwise
-        if self.currentBlockState() == in_state:
-            return True
-        else:
-            return False
-
-# --------------------------------------------------------------------------------------
-# Script Output Widget
-# The output logger works the same way as Nuke's python script editor output window
-# --------------------------------------------------------------------------------------
-
-
-class ScriptOutputWidget(QtWidgets.QTextEdit):
-    def __init__(self, parent=None):
-        super(ScriptOutputWidget, self).__init__(parent)
-        self.knobScripter = parent
-        self.setSizePolicy(QtWidgets.QSizePolicy.Expanding,
-                           QtWidgets.QSizePolicy.Expanding)
-        self.setMinimumHeight(20)
-
-    def keyPressEvent(self, event):
-        ctrl = ((event.modifiers() and (Qt.ControlModifier)) != 0)
-        alt = ((event.modifiers() and (Qt.AltModifier)) != 0)
-        shift = ((event.modifiers() and (Qt.ShiftModifier)) != 0)
-        key = event.key()
-        if type(event) == QtGui.QKeyEvent:
-            # print event.key()
-            if key in [32]:  # Space
-                return KnobScripter.keyPressEvent(self.knobScripter, event)
-            elif key in [Qt.Key_Backspace, Qt.Key_Delete]:
-                self.knobScripter.clearConsole()
-        return QtWidgets.QTextEdit.keyPressEvent(self, event)
-
-    # def mousePressEvent(self, QMouseEvent):
-    #    if QMouseEvent.button() == Qt.RightButton:
-    #        self.knobScripter.clearConsole()
-    #    QtWidgets.QTextEdit.mousePressEvent(self, QMouseEvent)
-
-# ---------------------------------------------------------------------
-# Modified KnobScripterTextEdit to include snippets etc.
-# ---------------------------------------------------------------------
-
-
-class KnobScripterTextEditMain(KnobScripterTextEdit):
-    def __init__(self, knobScripter, output=None, parent=None):
-        super(KnobScripterTextEditMain, self).__init__(knobScripter)
-        self.knobScripter = knobScripter
-        self.script_output = output
-        self.nukeCompleter = None
-        self.currentNukeCompletion = None
-
-        ########
-        # FROM NUKE's SCRIPT EDITOR START
-        ########
-        self.setSizePolicy(QtWidgets.QSizePolicy.Expanding,
-                           QtWidgets.QSizePolicy.Expanding)
-
-        # Setup completer
-        self.nukeCompleter = QtWidgets.QCompleter(self)
-        self.nukeCompleter.setWidget(self)
-        self.nukeCompleter.setCompletionMode(
-            QtWidgets.QCompleter.UnfilteredPopupCompletion)
-        self.nukeCompleter.setCaseSensitivity(Qt.CaseSensitive)
-        try:
-            self.nukeCompleter.setModel(QtGui.QStringListModel())
-        except:
-            self.nukeCompleter.setModel(QtCore.QStringListModel())
-
-        self.nukeCompleter.activated.connect(self.insertNukeCompletion)
-        self.nukeCompleter.highlighted.connect(self.completerHighlightChanged)
-        ########
-        # FROM NUKE's SCRIPT EDITOR END
-        ########
-
-    def findLongestEndingMatch(self, text, dic):
-        '''
-        If the text ends with a key in the dictionary, it returns the key and value.
-        If there are several matches, returns the longest one.
-        False if no matches.
-        '''
-        longest = 0  # len of longest match
-        match_key = None
-        match_snippet = ""
-        for key, val in dic.items():
-            #match = re.search(r"[\s\.({\[,;=+-]"+key+r"(?:[\s)\]\"]+|$)",text)
-            match = re.search(r"[\s\.({\[,;=+-]" + key + r"$", text)
-            if match or text == key:
-                if len(key) > longest:
-                    longest = len(key)
-                    match_key = key
-                    match_snippet = val
-        if match_key is None:
-            return False
-        return match_key, match_snippet
-
-    def placeholderToEnd(self, text, placeholder):
-        '''Returns distance (int) from the first occurrence of the placeholder, to the end of the string with placeholders removed'''
-        search = re.search(placeholder, text)
-        if not search:
-            return -1
-        from_start = search.start()
-        total = len(re.sub(placeholder, "", text))
-        to_end = total - from_start
-        return to_end
-
-    def addSnippetText(self, snippet_text):
-        ''' Adds the selected text as a snippet (taking care of $$, $name$ etc) to the script editor '''
-        cursor_placeholder_find = r"(?<!\\)(\$\$)"  # Matches $$
-        # Matches $thing$
-        variables_placeholder_find = r"(?:^|[^\\\$])(\$[\w]*[^\t\n\r\f\v\$\\]+\$)(?:$|[^\$])"
-        text = snippet_text
-        while True:
-            placeholder_variable = re.search(variables_placeholder_find, text)
-            if not placeholder_variable:
-                break
-            word = placeholder_variable.groups()[0]
-            word_bare = word[1:-1]
-            panel = TextInputDialog(
-                self.knobScripter, name=word_bare, text="", title="Set text for " + word_bare)
-            if panel.exec_():
-                #    # Accepted
-                text = text.replace(word, panel.text)
-            else:
-                text = text.replace(word, "")
-
-        placeholder_to_end = self.placeholderToEnd(
-            text, cursor_placeholder_find)
-
-        cursors = re.finditer(r"(?<!\\)(\$\$)", text)
-        positions = []
-        cursor_len = 0
-        for m in cursors:
-            if len(positions) < 2:
-                positions.append(m.start())
-        if len(positions) > 1:
-            cursor_len = positions[1] - positions[0] - 2
-
-        text = re.sub(cursor_placeholder_find, "", text)
-        self.cursor.insertText(text)
-        if placeholder_to_end >= 0:
-            for i in range(placeholder_to_end):
-                self.cursor.movePosition(QtGui.QTextCursor.PreviousCharacter)
-            for i in range(cursor_len):
-                self.cursor.movePosition(
-                    QtGui.QTextCursor.NextCharacter, QtGui.QTextCursor.KeepAnchor)
-            self.setTextCursor(self.cursor)
-
-    def keyPressEvent(self, event):
-
-        ctrl = bool(event.modifiers() & Qt.ControlModifier)
-        alt = bool(event.modifiers() & Qt.AltModifier)
-        shift = bool(event.modifiers() & Qt.ShiftModifier)
-        key = event.key()
-
-        # ADAPTED FROM NUKE's SCRIPT EDITOR:
-        # Get completer state
-        self.nukeCompleterShowing = self.nukeCompleter.popup().isVisible()
-
-        # BEFORE ANYTHING ELSE, IF SPECIAL MODIFIERS SIMPLY IGNORE THE REST
-        if not self.nukeCompleterShowing and (ctrl or shift or alt):
-            # Bypassed!
-            if key not in [Qt.Key_Return, Qt.Key_Enter, Qt.Key_Tab]:
-                KnobScripterTextEdit.keyPressEvent(self, event)
-                return
-
-        # If the completer is showing
-        if self.nukeCompleterShowing:
-            tc = self.textCursor()
-            # If we're hitting enter, do completion
-            if key in [Qt.Key_Return, Qt.Key_Enter, Qt.Key_Tab]:
-                if not self.currentNukeCompletion:
-                    self.nukeCompleter.setCurrentRow(0)
-                    self.currentNukeCompletion = self.nukeCompleter.currentCompletion()
-                # print str(self.nukeCompleter.completionModel[0])
-                self.insertNukeCompletion(self.currentNukeCompletion)
-                self.nukeCompleter.popup().hide()
-                self.nukeCompleterShowing = False
-            # If you're hitting right or escape, hide the popup
-            elif key == Qt.Key_Right or key == Qt.Key_Escape:
-                self.nukeCompleter.popup().hide()
-                self.nukeCompleterShowing = False
-            # If you hit tab, escape or ctrl-space, hide the completer
-            elif key == Qt.Key_Tab or key == Qt.Key_Escape or (ctrl and key == Qt.Key_Space):
-                self.currentNukeCompletion = ""
-                self.nukeCompleter.popup().hide()
-                self.nukeCompleterShowing = False
-            # If none of the above, update the completion model
-            else:
-                QtWidgets.QPlainTextEdit.keyPressEvent(self, event)
-                # Edit completion model
-                colNum = tc.columnNumber()
-                posNum = tc.position()
-                inputText = self.toPlainText()
-                inputTextSplit = inputText.splitlines()
-                runningLength = 0
-                currentLine = None
-                for line in inputTextSplit:
-                    length = len(line)
-                    runningLength += length
-                    if runningLength >= posNum:
-                        currentLine = line
-                        break
-                    runningLength += 1
-                if currentLine:
-                    completionPart = currentLine.split(" ")[-1]
-                    if "(" in completionPart:
-                        completionPart = completionPart.split("(")[-1]
-                    self.completeNukePartUnderCursor(completionPart)
-            return
-
-        if type(event) == QtGui.QKeyEvent:
-            if key == Qt.Key_Escape:  # Close the knobscripter...
-                self.knobScripter.close()
-            elif not ctrl and not alt and not shift and event.key() == Qt.Key_Tab:
-                self.placeholder = "$$"
-                # 1. Set the cursor
-                self.cursor = self.textCursor()
-
-                # 2. Save text before and after
-                cpos = self.cursor.position()
-                text_before_cursor = self.toPlainText()[:cpos]
-                line_before_cursor = text_before_cursor.split('\n')[-1]
-                text_after_cursor = self.toPlainText()[cpos:]
-
-                # 3. Check coincidences in snippets dicts
-                try:  # Meaning snippet found
-                    match_key, match_snippet = self.findLongestEndingMatch(
-                        line_before_cursor, self.knobScripter.snippets)
-                    for i in range(len(match_key)):
-                        self.cursor.deletePreviousChar()
-                    # This function takes care of adding the appropriate snippet and moving the cursor...
-                    self.addSnippetText(match_snippet)
-                except:  # Meaning snippet not found...
-                    # ADAPTED FROM NUKE's SCRIPT EDITOR:
-                    tc = self.textCursor()
-                    allCode = self.toPlainText()
-                    colNum = tc.columnNumber()
-                    posNum = tc.position()
-
-                    # ...and if there's text in the editor
-                    if len(allCode.split()) > 0:
-                        # There is text in the editor
-                        currentLine = tc.block().text()
-
-                        # If you're not at the end of the line just add a tab
-                        if colNum < len(currentLine):
-                            # If there isn't a ')' directly to the right of the cursor add a tab
-                            if currentLine[colNum:colNum + 1] != ')':
-                                KnobScripterTextEdit.keyPressEvent(self, event)
-                                return
-                            # Else show the completer
-                            else:
-                                completionPart = currentLine[:colNum].split(
-                                    " ")[-1]
-                                if "(" in completionPart:
-                                    completionPart = completionPart.split(
-                                        "(")[-1]
-
-                                self.completeNukePartUnderCursor(
-                                    completionPart)
-
-                                return
-
-                        # If you are at the end of the line,
-                        else:
-                            # If there's nothing to the right of you add a tab
-                            if currentLine[colNum - 1:] == "" or currentLine.endswith(" "):
-                                KnobScripterTextEdit.keyPressEvent(self, event)
-                                return
-                            # Else update completionPart and show the completer
-                            completionPart = currentLine.split(" ")[-1]
-                            if "(" in completionPart:
-                                completionPart = completionPart.split("(")[-1]
-
-                            self.completeNukePartUnderCursor(completionPart)
-                            return
-
-                    KnobScripterTextEdit.keyPressEvent(self, event)
-            elif event.key() in [Qt.Key_Enter, Qt.Key_Return]:
-                modifiers = QtWidgets.QApplication.keyboardModifiers()
-                if modifiers == QtCore.Qt.ControlModifier:
-                    self.runScript()
-                else:
-                    KnobScripterTextEdit.keyPressEvent(self, event)
-            else:
-                KnobScripterTextEdit.keyPressEvent(self, event)
-
-    def getPyObjects(self, text):
-        ''' Returns a list containing all the functions, classes and variables found within the selected python text (code) '''
-        matches = []
-        # 1: Remove text inside triple quotes (leaving the quotes)
-        text_clean = '""'.join(text.split('"""')[::2])
-        text_clean = '""'.join(text_clean.split("'''")[::2])
-
-        # 2: Remove text inside of quotes (leaving the quotes) except if \"
-        lines = text_clean.split("\n")
-        text_clean = ""
-        for line in lines:
-            line_clean = '""'.join(line.split('"')[::2])
-            line_clean = '""'.join(line_clean.split("'")[::2])
-            line_clean = line_clean.split("#")[0]
-            text_clean += line_clean + "\n"
-
-        # 3. Split into segments (lines plus ";")
-        segments = re.findall(r"[^\n;]+", text_clean)
-
-        # 4. Go case by case.
-        for s in segments:
-            # Declared vars
-            matches += re.findall(r"([\w\.]+)(?=[,\s\w]*=[^=]+$)", s)
-            # Def functions and arguments
-            function = re.findall(r"[\s]*def[\s]+([\w\.]+)[\s]*\([\s]*", s)
-            if len(function):
-                matches += function
-                args = re.split(r"[\s]*def[\s]+([\w\.]+)[\s]*\([\s]*", s)
-                if len(args) > 1:
-                    args = args[-1]
-                    matches += re.findall(
-                        r"(?<![=\"\'])[\s]*([\w\.]+)[\s]*(?==|,|\))", args)
-            # Lambda
-            matches += re.findall(r"^[^#]*lambda[\s]+([\w\.]+)[\s()\w,]+", s)
-            # Classes
-            matches += re.findall(r"^[^#]*class[\s]+([\w\.]+)[\s()\w,]+", s)
-        return matches
-
-    # Nuke script editor's modules completer
-    def completionsForcompletionPart(self, completionPart):
-        def findModules(searchString):
-            sysModules = sys.modules
-            globalModules = globals()
-            allModules = dict(sysModules, **globalModules)
-            allKeys = list(set(globals().keys() + sys.modules.keys()))
-            allKeysSorted = [x for x in sorted(set(allKeys))]
-
-            if searchString == '':
-                matching = []
-                for x in allModules:
-                    if x.startswith(searchString):
-                        matching.append(x)
-                return matching
-            else:
-                try:
-                    if sys.modules.has_key(searchString):
-                        return dir(sys.modules['%s' % searchString])
-                    elif globals().has_key(searchString):
-                        return dir(globals()['%s' % searchString])
-                    else:
-                        return []
-                except:
-                    return None
-
-        completerText = completionPart
-
-        # Get text before last dot
-        moduleSearchString = '.'.join(completerText.split('.')[:-1])
-
-        # Get text after last dot
-        fragmentSearchString = completerText.split(
-            '.')[-1] if completerText.split('.')[-1] != moduleSearchString else ''
-
-        # Get all the modules that match module search string
-        allModules = findModules(moduleSearchString)
-
-        # If no modules found, do a dir
-        if not allModules:
-            if len(moduleSearchString.split('.')) == 1:
-                matchedModules = []
-            else:
-                try:
-                    trimmedModuleSearchString = '.'.join(
-                        moduleSearchString.split('.')[:-1])
-                    matchedModules = [x for x in dir(getattr(sys.modules[trimmedModuleSearchString], moduleSearchString.split(
-                        '.')[-1])) if '__' not in x and x.startswith(fragmentSearchString)]
-                except:
-                    matchedModules = []
-        else:
-            matchedModules = [
-                x for x in allModules if '__' not in x and x.startswith(fragmentSearchString)]
-
-        selfObjects = list(set(self.getPyObjects(self.toPlainText())))
-        for i in selfObjects:
-            if i.startswith(completionPart):
-                matchedModules.append(i)
-
-        return matchedModules
-
-    def completeNukePartUnderCursor(self, completionPart):
-
-        completionPart = completionPart.lstrip().rstrip()
-        completionList = self.completionsForcompletionPart(completionPart)
-        if len(completionList) == 0:
-            return
-        self.nukeCompleter.model().setStringList(completionList)
-        self.nukeCompleter.setCompletionPrefix(completionPart)
-
-        if self.nukeCompleter.popup().isVisible():
-            rect = self.cursorRect()
-            rect.setWidth(self.nukeCompleter.popup().sizeHintForColumn(
-                0) + self.nukeCompleter.popup().verticalScrollBar().sizeHint().width())
-            self.nukeCompleter.complete(rect)
-            return
-
-        # Make it visible
-        if len(completionList) == 1:
-            self.insertNukeCompletion(completionList[0])
-        else:
-            rect = self.cursorRect()
-            rect.setWidth(self.nukeCompleter.popup().sizeHintForColumn(
-                0) + self.nukeCompleter.popup().verticalScrollBar().sizeHint().width())
-            self.nukeCompleter.complete(rect)
-
-        return
-
-    def insertNukeCompletion(self, completion):
-        if completion:
-            completionPart = self.nukeCompleter.completionPrefix()
-            if len(completionPart.split('.')) == 0:
-                completionPartFragment = completionPart
-            else:
-                completionPartFragment = completionPart.split('.')[-1]
-
-            textToInsert = completion[len(completionPartFragment):]
-            tc = self.textCursor()
-            tc.insertText(textToInsert)
-        return
-
-    def completerHighlightChanged(self, highlighted):
-        self.currentNukeCompletion = highlighted
-
-    def runScript(self):
-        cursor = self.textCursor()
-        nukeSEInput = self.knobScripter.nukeSEInput
-        if cursor.hasSelection():
-            code = cursor.selection().toPlainText()
-        else:
-            code = self.toPlainText()
-
-        if code == "":
-            return
-
-        # Store original ScriptEditor status
-        nukeSECursor = nukeSEInput.textCursor()
-        origSelection = nukeSECursor.selectedText()
-        oldAnchor = nukeSECursor.anchor()
-        oldPosition = nukeSECursor.position()
-
-        # Add the code to be executed and select it
-        nukeSEInput.insertPlainText(code)
-
-        if oldAnchor < oldPosition:
-            newAnchor = oldAnchor
-            newPosition = nukeSECursor.position()
-        else:
-            newAnchor = nukeSECursor.position()
-            newPosition = oldPosition
-
-        nukeSECursor.setPosition(newAnchor, QtGui.QTextCursor.MoveAnchor)
-        nukeSECursor.setPosition(newPosition, QtGui.QTextCursor.KeepAnchor)
-        nukeSEInput.setTextCursor(nukeSECursor)
-
-        # Run the code!
-        self.knobScripter.nukeSERunBtn.click()
-
-        # Revert ScriptEditor to original
-        nukeSEInput.insertPlainText(origSelection)
-        nukeSECursor.setPosition(oldAnchor, QtGui.QTextCursor.MoveAnchor)
-        nukeSECursor.setPosition(oldPosition, QtGui.QTextCursor.KeepAnchor)
-        nukeSEInput.setTextCursor(nukeSECursor)
-
-# ---------------------------------------------------------------------
-# Preferences Panel
-# ---------------------------------------------------------------------
-
-
-class KnobScripterPrefs(QtWidgets.QDialog):
-    def __init__(self, knobScripter):
-        super(KnobScripterPrefs, self).__init__(knobScripter)
-
-        # Vars
-        self.knobScripter = knobScripter
-        self.prefs_txt = self.knobScripter.prefs_txt
-        self.setWindowFlags(self.windowFlags() |
-                            QtCore.Qt.WindowStaysOnTopHint)
-        self.oldFontSize = self.knobScripter.script_editor_font.pointSize()
-        self.oldFont = self.knobScripter.script_editor_font.family()
-        self.oldScheme = self.knobScripter.color_scheme
-        self.font = self.oldFont
-        self.oldDefaultW = self.knobScripter.windowDefaultSize[0]
-        self.oldDefaultH = self.knobScripter.windowDefaultSize[1]
-
-        # Widgets
-        kspTitle = QtWidgets.QLabel("KnobScripter v" + version)
-        kspTitle.setStyleSheet(
-            "font-weight:bold;color:#CCCCCC;font-size:24px;")
-        kspSubtitle = QtWidgets.QLabel(
-            "Script editor for python and callback knobs")
-        kspSubtitle.setStyleSheet("color:#999")
-        kspLine = QtWidgets.QFrame()
-        kspLine.setFrameShape(QtWidgets.QFrame.HLine)
-        kspLine.setFrameShadow(QtWidgets.QFrame.Sunken)
-        kspLine.setLineWidth(0)
-        kspLine.setMidLineWidth(1)
-        kspLine.setFrameShadow(QtWidgets.QFrame.Sunken)
-        kspLineBottom = QtWidgets.QFrame()
-        kspLineBottom.setFrameShape(QtWidgets.QFrame.HLine)
-        kspLineBottom.setFrameShadow(QtWidgets.QFrame.Sunken)
-        kspLineBottom.setLineWidth(0)
-        kspLineBottom.setMidLineWidth(1)
-        kspLineBottom.setFrameShadow(QtWidgets.QFrame.Sunken)
-        kspSignature = QtWidgets.QLabel(
-            '<a href="http://www.adrianpueyo.com/" style="color:#888;text-decoration:none"><b>adrianpueyo.com</b></a>, 2016-2019')
-        kspSignature.setOpenExternalLinks(True)
-        kspSignature.setStyleSheet('''color:#555;font-size:9px;''')
-        kspSignature.setAlignment(QtCore.Qt.AlignRight)
-
-        fontLabel = QtWidgets.QLabel("Font:")
-        self.fontBox = QtWidgets.QFontComboBox()
-        self.fontBox.setCurrentFont(QtGui.QFont(self.font))
-        self.fontBox.currentFontChanged.connect(self.fontChanged)
-
-        fontSizeLabel = QtWidgets.QLabel("Font size:")
-        self.fontSizeBox = QtWidgets.QSpinBox()
-        self.fontSizeBox.setValue(self.oldFontSize)
-        self.fontSizeBox.setMinimum(6)
-        self.fontSizeBox.setMaximum(100)
-        self.fontSizeBox.valueChanged.connect(self.fontSizeChanged)
-
-        windowWLabel = QtWidgets.QLabel("Width (px):")
-        windowWLabel.setToolTip("Default window width in pixels")
-        self.windowWBox = QtWidgets.QSpinBox()
-        self.windowWBox.setValue(self.knobScripter.windowDefaultSize[0])
-        self.windowWBox.setMinimum(200)
-        self.windowWBox.setMaximum(4000)
-        self.windowWBox.setToolTip("Default window width in pixels")
-
-        windowHLabel = QtWidgets.QLabel("Height (px):")
-        windowHLabel.setToolTip("Default window height in pixels")
-        self.windowHBox = QtWidgets.QSpinBox()
-        self.windowHBox.setValue(self.knobScripter.windowDefaultSize[1])
-        self.windowHBox.setMinimum(100)
-        self.windowHBox.setMaximum(2000)
-        self.windowHBox.setToolTip("Default window height in pixels")
-
-        # TODO: "Grab current dimensions" button
-
-        tabSpaceLabel = QtWidgets.QLabel("Tab spaces:")
-        tabSpaceLabel.setToolTip("Number of spaces to add with the tab key.")
-        self.tabSpace2 = QtWidgets.QRadioButton("2")
-        self.tabSpace4 = QtWidgets.QRadioButton("4")
-        tabSpaceButtonGroup = QtWidgets.QButtonGroup(self)
-        tabSpaceButtonGroup.addButton(self.tabSpace2)
-        tabSpaceButtonGroup.addButton(self.tabSpace4)
-        self.tabSpace2.setChecked(self.knobScripter.tabSpaces == 2)
-        self.tabSpace4.setChecked(self.knobScripter.tabSpaces == 4)
-
-        pinDefaultLabel = QtWidgets.QLabel("Always on top:")
-        pinDefaultLabel.setToolTip("Default mode of the PIN toggle.")
-        self.pinDefaultOn = QtWidgets.QRadioButton("On")
-        self.pinDefaultOff = QtWidgets.QRadioButton("Off")
-        pinDefaultButtonGroup = QtWidgets.QButtonGroup(self)
-        pinDefaultButtonGroup.addButton(self.pinDefaultOn)
-        pinDefaultButtonGroup.addButton(self.pinDefaultOff)
-        self.pinDefaultOn.setChecked(self.knobScripter.pinned == True)
-        self.pinDefaultOff.setChecked(self.knobScripter.pinned == False)
-        self.pinDefaultOn.clicked.connect(lambda: self.knobScripter.pin(True))
-        self.pinDefaultOff.clicked.connect(
-            lambda: self.knobScripter.pin(False))
-
-        colorSchemeLabel = QtWidgets.QLabel("Color scheme:")
-        colorSchemeLabel.setToolTip("Syntax highlighting text style.")
-        self.colorSchemeSublime = QtWidgets.QRadioButton("subl")
-        self.colorSchemeNuke = QtWidgets.QRadioButton("nuke")
-        colorSchemeButtonGroup = QtWidgets.QButtonGroup(self)
-        colorSchemeButtonGroup.addButton(self.colorSchemeSublime)
-        colorSchemeButtonGroup.addButton(self.colorSchemeNuke)
-        colorSchemeButtonGroup.buttonClicked.connect(self.colorSchemeChanged)
-        self.colorSchemeSublime.setChecked(
-            self.knobScripter.color_scheme == "sublime")
-        self.colorSchemeNuke.setChecked(
-            self.knobScripter.color_scheme == "nuke")
-
-        showLabelsLabel = QtWidgets.QLabel("Show labels:")
-        showLabelsLabel.setToolTip(
-            "Display knob labels on the knob dropdown\nOtherwise, shows the internal name only.")
-        self.showLabelsOn = QtWidgets.QRadioButton("On")
-        self.showLabelsOff = QtWidgets.QRadioButton("Off")
-        showLabelsButtonGroup = QtWidgets.QButtonGroup(self)
-        showLabelsButtonGroup.addButton(self.showLabelsOn)
-        showLabelsButtonGroup.addButton(self.showLabelsOff)
-        self.showLabelsOn.setChecked(self.knobScripter.pinned == True)
-        self.showLabelsOff.setChecked(self.knobScripter.pinned == False)
-        self.showLabelsOn.clicked.connect(lambda: self.knobScripter.pin(True))
-        self.showLabelsOff.clicked.connect(
-            lambda: self.knobScripter.pin(False))
-
-        self.buttonBox = QtWidgets.QDialogButtonBox(
-            QtWidgets.QDialogButtonBox.Ok | QtWidgets.QDialogButtonBox.Cancel)
-        self.buttonBox.accepted.connect(self.savePrefs)
-        self.buttonBox.rejected.connect(self.cancelPrefs)
-
-        # Loaded custom values
-        self.ksPrefs = self.knobScripter.loadPrefs()
-        if self.ksPrefs != []:
-            try:
-                self.fontSizeBox.setValue(self.ksPrefs['font_size'])
-                self.windowWBox.setValue(self.ksPrefs['window_default_w'])
-                self.windowHBox.setValue(self.ksPrefs['window_default_h'])
-                self.tabSpace2.setChecked(self.ksPrefs['tab_spaces'] == 2)
-                self.tabSpace4.setChecked(self.ksPrefs['tab_spaces'] == 4)
-                self.pinDefaultOn.setChecked(self.ksPrefs['pin_default'] == 1)
-                self.pinDefaultOff.setChecked(self.ksPrefs['pin_default'] == 0)
-                self.showLabelsOn.setChecked(self.ksPrefs['show_labels'] == 1)
-                self.showLabelsOff.setChecked(self.ksPrefs['show_labels'] == 0)
-                self.colorSchemeSublime.setChecked(
-                    self.ksPrefs['color_scheme'] == "sublime")
-                self.colorSchemeNuke.setChecked(
-                    self.ksPrefs['color_scheme'] == "nuke")
-            except:
-                pass
-
-        # Layouts
-        font_layout = QtWidgets.QHBoxLayout()
-        font_layout.addWidget(fontLabel)
-        font_layout.addWidget(self.fontBox)
-
-        fontSize_layout = QtWidgets.QHBoxLayout()
-        fontSize_layout.addWidget(fontSizeLabel)
-        fontSize_layout.addWidget(self.fontSizeBox)
-
-        windowW_layout = QtWidgets.QHBoxLayout()
-        windowW_layout.addWidget(windowWLabel)
-        windowW_layout.addWidget(self.windowWBox)
-
-        windowH_layout = QtWidgets.QHBoxLayout()
-        windowH_layout.addWidget(windowHLabel)
-        windowH_layout.addWidget(self.windowHBox)
-
-        tabSpacesButtons_layout = QtWidgets.QHBoxLayout()
-        tabSpacesButtons_layout.addWidget(self.tabSpace2)
-        tabSpacesButtons_layout.addWidget(self.tabSpace4)
-        tabSpaces_layout = QtWidgets.QHBoxLayout()
-        tabSpaces_layout.addWidget(tabSpaceLabel)
-        tabSpaces_layout.addLayout(tabSpacesButtons_layout)
-
-        pinDefaultButtons_layout = QtWidgets.QHBoxLayout()
-        pinDefaultButtons_layout.addWidget(self.pinDefaultOn)
-        pinDefaultButtons_layout.addWidget(self.pinDefaultOff)
-        pinDefault_layout = QtWidgets.QHBoxLayout()
-        pinDefault_layout.addWidget(pinDefaultLabel)
-        pinDefault_layout.addLayout(pinDefaultButtons_layout)
-
-        showLabelsButtons_layout = QtWidgets.QHBoxLayout()
-        showLabelsButtons_layout.addWidget(self.showLabelsOn)
-        showLabelsButtons_layout.addWidget(self.showLabelsOff)
-        showLabels_layout = QtWidgets.QHBoxLayout()
-        showLabels_layout.addWidget(showLabelsLabel)
-        showLabels_layout.addLayout(showLabelsButtons_layout)
-
-        colorSchemeButtons_layout = QtWidgets.QHBoxLayout()
-        colorSchemeButtons_layout.addWidget(self.colorSchemeSublime)
-        colorSchemeButtons_layout.addWidget(self.colorSchemeNuke)
-        colorScheme_layout = QtWidgets.QHBoxLayout()
-        colorScheme_layout.addWidget(colorSchemeLabel)
-        colorScheme_layout.addLayout(colorSchemeButtons_layout)
-
-        self.master_layout = QtWidgets.QVBoxLayout()
-        self.master_layout.addWidget(kspTitle)
-        self.master_layout.addWidget(kspSignature)
-        self.master_layout.addWidget(kspLine)
-        self.master_layout.addLayout(font_layout)
-        self.master_layout.addLayout(fontSize_layout)
-        self.master_layout.addLayout(windowW_layout)
-        self.master_layout.addLayout(windowH_layout)
-        self.master_layout.addLayout(tabSpaces_layout)
-        self.master_layout.addLayout(pinDefault_layout)
-        self.master_layout.addLayout(showLabels_layout)
-        self.master_layout.addLayout(colorScheme_layout)
-        self.master_layout.addWidget(self.buttonBox)
-        self.setLayout(self.master_layout)
-        self.setFixedSize(self.minimumSize())
-
-    def savePrefs(self):
-        self.font = self.fontBox.currentFont().family()
-        ks_prefs = {
-            'font_size': self.fontSizeBox.value(),
-            'window_default_w': self.windowWBox.value(),
-            'window_default_h': self.windowHBox.value(),
-            'tab_spaces': self.tabSpaceValue(),
-            'pin_default': self.pinDefaultValue(),
-            'show_labels': self.showLabelsValue(),
-            'font': self.font,
-            'color_scheme': self.colorSchemeValue(),
-        }
-        self.knobScripter.script_editor_font.setFamily(self.font)
-        self.knobScripter.script_editor.setFont(
-            self.knobScripter.script_editor_font)
-        self.knobScripter.font = self.font
-        self.knobScripter.color_scheme = self.colorSchemeValue()
-        self.knobScripter.tabSpaces = self.tabSpaceValue()
-        self.knobScripter.script_editor.tabSpaces = self.tabSpaceValue()
-        with open(self.prefs_txt, "w") as f:
-            prefs = json.dump(ks_prefs, f, sort_keys=True, indent=4)
-        self.accept()
-        self.knobScripter.highlighter.rehighlight()
-        self.knobScripter.show_labels = self.showLabelsValue()
-        if self.knobScripter.nodeMode:
-            self.knobScripter.refreshClicked()
-        return prefs
-
-    def cancelPrefs(self):
-        self.knobScripter.script_editor_font.setPointSize(self.oldFontSize)
-        self.knobScripter.script_editor.setFont(
-            self.knobScripter.script_editor_font)
-        self.knobScripter.color_scheme = self.oldScheme
-        self.knobScripter.highlighter.rehighlight()
-        self.reject()
-
-    def fontSizeChanged(self):
-        self.knobScripter.script_editor_font.setPointSize(
-            self.fontSizeBox.value())
-        self.knobScripter.script_editor.setFont(
-            self.knobScripter.script_editor_font)
-        return
-
-    def fontChanged(self):
-        self.font = self.fontBox.currentFont().family()
-        self.knobScripter.script_editor_font.setFamily(self.font)
-        self.knobScripter.script_editor.setFont(
-            self.knobScripter.script_editor_font)
-        return
-
-    def colorSchemeChanged(self):
-        self.knobScripter.color_scheme = self.colorSchemeValue()
-        self.knobScripter.highlighter.rehighlight()
-        return
-
-    def tabSpaceValue(self):
-        return 2 if self.tabSpace2.isChecked() else 4
-
-    def pinDefaultValue(self):
-        return 1 if self.pinDefaultOn.isChecked() else 0
-
-    def showLabelsValue(self):
-        return 1 if self.showLabelsOn.isChecked() else 0
-
-    def colorSchemeValue(self):
-        return "nuke" if self.colorSchemeNuke.isChecked() else "sublime"
-
-    def closeEvent(self, event):
-        self.cancelPrefs()
-        self.close()
-
-
-def updateContext():
-    '''
-    Get the current selection of nodes with their appropriate context
-    Doing this outside the KnobScripter -> forces context update inside groups when needed
-    '''
-    global knobScripterSelectedNodes
-    knobScripterSelectedNodes = nuke.selectedNodes()
-    return
-
-# --------------------------------
-# FindReplace
-# --------------------------------
-
-
-class FindReplaceWidget(QtWidgets.QWidget):
-    ''' SearchReplace Widget for the knobscripter. FindReplaceWidget(editor = QPlainTextEdit) '''
-
-    def __init__(self, parent):
-        super(FindReplaceWidget, self).__init__(parent)
-
-        self.editor = parent.script_editor
-
-        self.initUI()
-
-    def initUI(self):
-
-        # --------------
-        # Find Row
-        # --------------
-
-        # Widgets
-        self.find_label = QtWidgets.QLabel("Find:")
-        # self.find_label.setSizePolicy(QtWidgets.QSizePolicy.Fixed,QtWidgets.QSizePolicy.Fixed)
-        self.find_label.setFixedWidth(50)
-        self.find_label.setAlignment(
-            QtCore.Qt.AlignRight | QtCore.Qt.AlignVCenter)
-        self.find_lineEdit = QtWidgets.QLineEdit()
-        self.find_next_button = QtWidgets.QPushButton("Next")
-        self.find_next_button.clicked.connect(self.find)
-        self.find_prev_button = QtWidgets.QPushButton("Previous")
-        self.find_prev_button.clicked.connect(self.findBack)
-        self.find_lineEdit.returnPressed.connect(self.find_next_button.click)
-
-        # Layout
-        self.find_layout = QtWidgets.QHBoxLayout()
-        self.find_layout.addWidget(self.find_label)
-        self.find_layout.addWidget(self.find_lineEdit, stretch=1)
-        self.find_layout.addWidget(self.find_next_button)
-        self.find_layout.addWidget(self.find_prev_button)
-
-        # --------------
-        # Replace Row
-        # --------------
-
-        # Widgets
-        self.replace_label = QtWidgets.QLabel("Replace:")
-        # self.replace_label.setSizePolicy(QtWidgets.QSizePolicy.Fixed,QtWidgets.QSizePolicy.Fixed)
-        self.replace_label.setFixedWidth(50)
-        self.replace_label.setAlignment(
-            QtCore.Qt.AlignRight | QtCore.Qt.AlignVCenter)
-        self.replace_lineEdit = QtWidgets.QLineEdit()
-        self.replace_button = QtWidgets.QPushButton("Replace")
-        self.replace_button.clicked.connect(self.replace)
-        self.replace_all_button = QtWidgets.QPushButton("Replace All")
-        self.replace_all_button.clicked.connect(
-            lambda: self.replace(rep_all=True))
-        self.replace_lineEdit.returnPressed.connect(self.replace_button.click)
-
-        # Layout
-        self.replace_layout = QtWidgets.QHBoxLayout()
-        self.replace_layout.addWidget(self.replace_label)
-        self.replace_layout.addWidget(self.replace_lineEdit, stretch=1)
-        self.replace_layout.addWidget(self.replace_button)
-        self.replace_layout.addWidget(self.replace_all_button)
-
-        # Info text
-        self.info_text = QtWidgets.QLabel("")
-        self.info_text.setVisible(False)
-        self.info_text.mousePressEvent = lambda x: self.info_text.setVisible(
-            False)
-        #f = self.info_text.font()
-        # f.setItalic(True)
-        # self.info_text.setFont(f)
-        # self.info_text.clicked.connect(lambda:self.info_text.setVisible(False))
-
-        # Divider line
-        line = QtWidgets.QFrame()
-        line.setFrameShape(QtWidgets.QFrame.HLine)
-        line.setFrameShadow(QtWidgets.QFrame.Sunken)
-        line.setLineWidth(0)
-        line.setMidLineWidth(1)
-        line.setFrameShadow(QtWidgets.QFrame.Sunken)
-
-        # --------------
-        # Main Layout
-        # --------------
-
-        self.layout = QtWidgets.QVBoxLayout()
-        self.layout.addSpacing(4)
-        self.layout.addWidget(self.info_text)
-        self.layout.addLayout(self.find_layout)
-        self.layout.addLayout(self.replace_layout)
-        self.layout.setSpacing(4)
-        try:  # >n11
-            self.layout.setMargin(2)
-        except:  # <n10
-            self.layout.setContentsMargins(2, 2, 2, 2)
-        self.layout.addSpacing(4)
-        self.layout.addWidget(line)
-        self.setLayout(self.layout)
-        self.setTabOrder(self.find_lineEdit, self.replace_lineEdit)
-        # self.adjustSize()
-        # self.setMaximumHeight(180)
-
-    def find(self, find_str="", match_case=True):
-        if find_str == "":
-            find_str = self.find_lineEdit.text()
-
-        matches = self.editor.toPlainText().count(find_str)
-        if not matches or matches == 0:
-            self.info_text.setText("              No more matches.")
-            self.info_text.setVisible(True)
-            return
-        else:
-            self.info_text.setVisible(False)
-
-        # Beginning of undo block
-        cursor = self.editor.textCursor()
-        cursor.beginEditBlock()
-
-        # Use flags for case match
-        flags = QtGui.QTextDocument.FindFlags()
-        if match_case:
-            flags = flags | QtGui.QTextDocument.FindCaseSensitively
-
-        # Find next
-        r = self.editor.find(find_str, flags)
-
-        cursor.endEditBlock()
-
-        self.editor.setFocus()
-        self.editor.show()
-        return r
-
-    def findBack(self, find_str="", match_case=True):
-        if find_str == "":
-            find_str = self.find_lineEdit.text()
-
-        matches = self.editor.toPlainText().count(find_str)
-        if not matches or matches == 0:
-            self.info_text.setText("              No more matches.")
-            self.info_text.setVisible(True)
-            return
-        else:
-            self.info_text.setVisible(False)
-
-        # Beginning of undo block
-        cursor = self.editor.textCursor()
-        cursor.beginEditBlock()
-
-        # Use flags for case match
-        flags = QtGui.QTextDocument.FindFlags()
-        flags = flags | QtGui.QTextDocument.FindBackward
-        if match_case:
-            flags = flags | QtGui.QTextDocument.FindCaseSensitively
-
-        # Find prev
-        r = self.editor.find(find_str, flags)
-        cursor.endEditBlock()
-        self.editor.setFocus()
-        return r
-
-    def replace(self, find_str="", rep_str="", rep_all=False):
-        if find_str == "":
-            find_str = self.find_lineEdit.text()
-        if rep_str == "":
-            rep_str = self.replace_lineEdit.text()
-
-        matches = self.editor.toPlainText().count(find_str)
-        if not matches or matches == 0:
-            self.info_text.setText("              No more matches.")
-            self.info_text.setVisible(True)
-            return
-        else:
-            self.info_text.setVisible(False)
-
-        # Beginning of undo block
-        cursor = self.editor.textCursor()
-        cursor_orig_pos = cursor.position()
-        cursor.beginEditBlock()
-
-        # Use flags for case match
-        flags = QtGui.QTextDocument.FindFlags()
-        flags = flags | QtGui.QTextDocument.FindCaseSensitively
-
-        if rep_all == True:
-            cursor.movePosition(QtGui.QTextCursor.Start)
-            self.editor.setTextCursor(cursor)
-            cursor = self.editor.textCursor()
-            rep_count = 0
-            while True:
-                if not cursor.hasSelection() or cursor.selectedText() != find_str:
-                    self.editor.find(find_str, flags)  # Find next
-                    cursor = self.editor.textCursor()
-                    if not cursor.hasSelection():
-                        break
-                else:
-                    cursor.insertText(rep_str)
-                    rep_count += 1
-            self.info_text.setText(
-                "              Replaced " + str(rep_count) + " matches.")
-            self.info_text.setVisible(True)
-        else:  # If not "find all"
-            if not cursor.hasSelection() or cursor.selectedText() != find_str:
-                self.editor.find(find_str, flags)  # Find next
-                if not cursor.hasSelection() and matches > 0:  # If not found but there are matches, start over
-                    cursor.movePosition(QtGui.QTextCursor.Start)
-                    self.editor.setTextCursor(cursor)
-                    self.editor.find(find_str, flags)
-            else:
-                cursor.insertText(rep_str)
-                self.editor.find(
-                    rep_str, flags | QtGui.QTextDocument.FindBackward)
-
-        cursor.endEditBlock()
-        self.replace_lineEdit.setFocus()
-        return
-
-
-# --------------------------------
-# Snippets
-# --------------------------------
-class SnippetsPanel(QtWidgets.QDialog):
-    def __init__(self, parent):
-        super(SnippetsPanel, self).__init__(parent)
-
-        self.knobScripter = parent
-
-        self.setWindowFlags(self.windowFlags() |
-                            QtCore.Qt.WindowStaysOnTopHint)
-        self.setWindowTitle("Snippet editor")
-
-        self.snippets_txt_path = self.knobScripter.snippets_txt_path
-        self.snippets_dict = self.loadSnippetsDict(path=self.snippets_txt_path)
-        #self.snippets_dict = snippets_dic
-
-        # self.saveSnippets(snippets_dic)
-
-        self.initUI()
-        self.resize(500, 300)
-
-    def initUI(self):
-        self.layout = QtWidgets.QVBoxLayout()
-
-        # First Area (Titles)
-        title_layout = QtWidgets.QHBoxLayout()
-        shortcuts_label = QtWidgets.QLabel("Shortcut")
-        code_label = QtWidgets.QLabel("Code snippet")
-        title_layout.addWidget(shortcuts_label, stretch=1)
-        title_layout.addWidget(code_label, stretch=2)
-        self.layout.addLayout(title_layout)
-
-        # Main Scroll area
-        self.scroll_content = QtWidgets.QWidget()
-        self.scroll_layout = QtWidgets.QVBoxLayout()
-
-        self.buildSnippetWidgets()
-
-        self.scroll_content.setLayout(self.scroll_layout)
-
-        # Scroll Area Properties
-        self.scroll = QtWidgets.QScrollArea()
-        self.scroll.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOn)
-        self.scroll.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
-        self.scroll.setWidgetResizable(True)
-        self.scroll.setWidget(self.scroll_content)
-
-        self.layout.addWidget(self.scroll)
-
-        # File knob test
-        #self.filePath_lineEdit = SnippetFilePath(self)
-        # self.filePath_lineEdit
-        # self.layout.addWidget(self.filePath_lineEdit)
-
-        # Lower buttons
-        self.bottom_layout = QtWidgets.QHBoxLayout()
-
-        self.add_btn = QtWidgets.QPushButton("Add snippet")
-        self.add_btn.setToolTip("Create empty fields for an extra snippet.")
-        self.add_btn.clicked.connect(self.addSnippet)
-        self.bottom_layout.addWidget(self.add_btn)
-
-        self.addPath_btn = QtWidgets.QPushButton("Add custom path")
-        self.addPath_btn.setToolTip(
-            "Add a custom path to an external snippets .txt file.")
-        self.addPath_btn.clicked.connect(self.addCustomPath)
-        self.bottom_layout.addWidget(self.addPath_btn)
-
-        self.bottom_layout.addStretch()
-
-        self.save_btn = QtWidgets.QPushButton('OK')
-        self.save_btn.setToolTip(
-            "Save the snippets into a json file and close the panel.")
-        self.save_btn.clicked.connect(self.okPressed)
-        self.bottom_layout.addWidget(self.save_btn)
-
-        self.cancel_btn = QtWidgets.QPushButton("Cancel")
-        self.cancel_btn.setToolTip("Cancel any new snippets or modifications.")
-        self.cancel_btn.clicked.connect(self.close)
-        self.bottom_layout.addWidget(self.cancel_btn)
-
-        self.apply_btn = QtWidgets.QPushButton('Apply')
-        self.apply_btn.setToolTip("Save the snippets into a json file.")
-        self.apply_btn.setShortcut('Ctrl+S')
-        self.apply_btn.clicked.connect(self.applySnippets)
-        self.bottom_layout.addWidget(self.apply_btn)
-
-        self.help_btn = QtWidgets.QPushButton('Help')
-        self.help_btn.setShortcut('F1')
-        self.help_btn.clicked.connect(self.showHelp)
-        self.bottom_layout.addWidget(self.help_btn)
-
-        self.layout.addLayout(self.bottom_layout)
-
-        self.setLayout(self.layout)
-
-    def reload(self):
-        '''
-        Clears everything without saving and redoes the widgets etc.
-        Only to be called if the panel isn't shown meaning it's closed.
-        '''
-        for i in reversed(range(self.scroll_layout.count())):
-            self.scroll_layout.itemAt(i).widget().deleteLater()
-
-        self.snippets_dict = self.loadSnippetsDict(path=self.snippets_txt_path)
-
-        self.buildSnippetWidgets()
-
-    def buildSnippetWidgets(self):
-        for i, (key, val) in enumerate(self.snippets_dict.items()):
-            if re.match(r"\[custom-path-[0-9]+\]$", key):
-                file_edit = SnippetFilePath(val)
-                self.scroll_layout.insertWidget(-1, file_edit)
-            else:
-                snippet_edit = SnippetEdit(key, val, parent=self)
-                self.scroll_layout.insertWidget(-1, snippet_edit)
-
-    def loadSnippetsDict(self, path=""):
-        ''' Load prefs. TO REMOVE '''
-        if path == "":
-            path = self.knobScripter.snippets_txt_path
-        if not os.path.isfile(self.snippets_txt_path):
-            return {}
-        else:
-            with open(self.snippets_txt_path, "r") as f:
-                self.snippets = json.load(f)
-                return self.snippets
-
-    def getSnippetsAsDict(self):
-        dic = {}
-        num_snippets = self.scroll_layout.count()
-        path_i = 1
-        for s in range(num_snippets):
-            se = self.scroll_layout.itemAt(s).widget()
-            if se.__class__.__name__ == "SnippetEdit":
-                key = se.shortcut_editor.text()
-                val = se.script_editor.toPlainText()
-                if key != "":
-                    dic[key] = val
-            else:
-                path = se.filepath_lineEdit.text()
-                if path != "":
-                    dic["[custom-path-{}]".format(str(path_i))] = path
-                    path_i += 1
-        return dic
-
-    def saveSnippets(self, snippets=""):
-        if snippets == "":
-            snippets = self.getSnippetsAsDict()
-        with open(self.snippets_txt_path, "w") as f:
-            prefs = json.dump(snippets, f, sort_keys=True, indent=4)
-        return prefs
-
-    def applySnippets(self):
-        self.saveSnippets()
-        self.knobScripter.snippets = self.knobScripter.loadSnippets(maxDepth=5)
-        self.knobScripter.loadSnippets()
-
-    def okPressed(self):
-        self.applySnippets()
-        self.accept()
-
-    def addSnippet(self, key="", val=""):
-        se = SnippetEdit(key, val, parent=self)
-        self.scroll_layout.insertWidget(0, se)
-        self.show()
-        return se
-
-    def addCustomPath(self, path=""):
-        cpe = SnippetFilePath(path)
-        self.scroll_layout.insertWidget(0, cpe)
-        self.show()
-        cpe.browseSnippets()
-        return cpe
-
-    def showHelp(self):
-        ''' Create a new snippet, auto-completed with the help '''
-        help_key = "help"
-        help_val = """Snippets are a convenient way to have code blocks that you can call through a shortcut.\n\n1. Simply write a shortcut on the text input field on the left. You can see this one is set to "test".\n\n2. Then, write a code or whatever in this script editor. You can include $$ as the placeholder for where you'll want the mouse cursor to appear.\n\n3. Finally, click OK or Apply to save the snippets. On the main script editor, you'll be able to call any snippet by writing the shortcut (in this example: help) and pressing the Tab key.\n\nIn order to remove a snippet, simply leave the shortcut and contents blank, and save the snippets."""
-        help_se = self.addSnippet(help_key, help_val)
-        help_se.script_editor.resize(160, 160)
-
-
-class SnippetEdit(QtWidgets.QWidget):
-    ''' Simple widget containing two fields, for the snippet shortcut and content '''
-
-    def __init__(self, key="", val="", parent=None):
-        super(SnippetEdit, self).__init__(parent)
-
-        self.knobScripter = parent.knobScripter
-        self.color_scheme = self.knobScripter.color_scheme
-        self.layout = QtWidgets.QHBoxLayout()
-
-        self.shortcut_editor = QtWidgets.QLineEdit(self)
-        f = self.shortcut_editor.font()
-        f.setWeight(QtGui.QFont.Bold)
-        self.shortcut_editor.setFont(f)
-        self.shortcut_editor.setText(str(key))
-        #self.script_editor = QtWidgets.QTextEdit(self)
-        self.script_editor = KnobScripterTextEdit()
-        self.script_editor.setMinimumHeight(100)
-        self.script_editor.setStyleSheet(
-            'background:#282828;color:#EEE;')  # Main Colors
-        self.highlighter = KSScriptEditorHighlighter(
-            self.script_editor.document(), self)
-        self.script_editor_font = self.knobScripter.script_editor_font
-        self.script_editor.setFont(self.script_editor_font)
-        self.script_editor.resize(90, 90)
-        self.script_editor.setPlainText(str(val))
-        self.layout.addWidget(self.shortcut_editor,
-                              stretch=1, alignment=Qt.AlignTop)
-        self.layout.addWidget(self.script_editor, stretch=2)
-        self.layout.setContentsMargins(0, 0, 0, 0)
-
-        self.setLayout(self.layout)
-
-
-class SnippetFilePath(QtWidgets.QWidget):
-    ''' Simple widget containing a filepath lineEdit and a button to open the file browser '''
-
-    def __init__(self, path="", parent=None):
-        super(SnippetFilePath, self).__init__(parent)
-
-        self.layout = QtWidgets.QHBoxLayout()
-
-        self.custompath_label = QtWidgets.QLabel(self)
-        self.custompath_label.setText("Custom path: ")
-
-        self.filepath_lineEdit = QtWidgets.QLineEdit(self)
-        self.filepath_lineEdit.setText(str(path))
-        #self.script_editor = QtWidgets.QTextEdit(self)
-        self.filepath_lineEdit.setStyleSheet(
-            'background:#282828;color:#EEE;')  # Main Colors
-        self.script_editor_font = QtGui.QFont()
-        self.script_editor_font.setFamily("Courier")
-        self.script_editor_font.setStyleHint(QtGui.QFont.Monospace)
-        self.script_editor_font.setFixedPitch(True)
-        self.script_editor_font.setPointSize(11)
-        self.filepath_lineEdit.setFont(self.script_editor_font)
-
-        self.file_button = QtWidgets.QPushButton(self)
-        self.file_button.setText("Browse...")
-        self.file_button.clicked.connect(self.browseSnippets)
-
-        self.layout.addWidget(self.custompath_label)
-        self.layout.addWidget(self.filepath_lineEdit)
-        self.layout.addWidget(self.file_button)
-        self.layout.setContentsMargins(0, 10, 0, 10)
-
-        self.setLayout(self.layout)
-
-    def browseSnippets(self):
-        ''' Opens file panel for ...snippets.txt '''
-        browseLocation = nuke.getFilename('Select snippets file', '*.txt')
-
-        if not browseLocation:
-            return
-
-        self.filepath_lineEdit.setText(browseLocation)
-        return
-
-
-# --------------------------------
-# Implementation
-# --------------------------------
-
-def showKnobScripter(knob="knobChanged"):
-    selection = nuke.selectedNodes()
-    if not len(selection):
-        pan = KnobScripter()
-    else:
-        pan = KnobScripter(selection[0], knob)
-    pan.show()
-
-
-def addKnobScripterPanel():
-    global knobScripterPanel
-    try:
-        knobScripterPanel = panels.registerWidgetAsPanel('nuke.KnobScripterPane', 'Knob Scripter',
-                                                         'com.adrianpueyo.KnobScripterPane')
-        knobScripterPanel.addToPane(nuke.getPaneFor('Properties.1'))
-
-    except:
-        knobScripterPanel = panels.registerWidgetAsPanel(
-            'nuke.KnobScripterPane', 'Knob Scripter', 'com.adrianpueyo.KnobScripterPane')
-
-
-nuke.KnobScripterPane = KnobScripterPane
-log("KS LOADED")
-ksShortcut = "alt+z"
-addKnobScripterPanel()
-nuke.menu('Nuke').addCommand(
-    'Edit/Node/Open Floating Knob Scripter', showKnobScripter, ksShortcut)
-nuke.menu('Nuke').addCommand('Edit/Node/Update KnobScripter Context',
-                             updateContext).setVisible(False)
diff --git a/openpype/hosts/nuke/startup/init.py b/openpype/hosts/nuke/startup/init.py
deleted file mode 100644
index d7560814bf..0000000000
--- a/openpype/hosts/nuke/startup/init.py
+++ /dev/null
@@ -1,4 +0,0 @@
-import nuke
-
-# default write mov
-nuke.knobDefault('Write.mov.colorspace', 'sRGB')

From 09e92ebad87c09d0186f759ac738fc2389270ec3 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 15 Jun 2022 15:20:05 +0200
Subject: [PATCH 0657/1227] flame: make sure `representations` key is always on
 instance data

---
 .../hosts/flame/plugins/publish/collect_timeline_instances.py  | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
index 0aca7c38d5..aa19b78bf1 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
@@ -125,7 +125,8 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
                 "flameAddTasks": self.add_tasks,
                 "tasks": {
                     task["name"]: {"type": task["type"]}
-                    for task in self.add_tasks}
+                    for task in self.add_tasks},
+                "representations": []
             })
             self.log.debug("__ inst_data: {}".format(pformat(inst_data)))
 

From be328e5396760f683c42ed21ca01385e42ec2cf0 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 15 Jun 2022 15:20:34 +0200
Subject: [PATCH 0658/1227] flame: implementing `keep_original_representation`
 switch

---
 .../hosts/flame/plugins/publish/extract_subset_resources.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 0bad3f7cfc..255d57a8ee 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -22,6 +22,8 @@ class ExtractSubsetResources(openpype.api.Extractor):
     hosts = ["flame"]
 
     # plugin defaults
+    keep_original_representation = False
+
     default_presets = {
         "thumbnail": {
             "active": True,
@@ -44,7 +46,9 @@ class ExtractSubsetResources(openpype.api.Extractor):
     export_presets_mapping = {}
 
     def process(self, instance):
-        if "representations" not in instance.data:
+
+        if not self.keep_original_representation:
+            # remove previeous representation if not needed
             instance.data["representations"] = []
 
         # flame objects

From c25cb9e1f5749b4dd071c873b94fd1e5be1193bd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 15 Jun 2022 16:03:02 +0200
Subject: [PATCH 0659/1227] fixed missing "parent" in fields

---
 openpype/client/entities.py | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index a56288c1e8..1bfab5ad57 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -23,7 +23,7 @@ def _get_project_connection(project_name=None):
     return mongodb
 
 
-def _prepare_fields(fields):
+def _prepare_fields(fields, ensure_fields=None):
     if not fields:
         return None
 
@@ -33,6 +33,10 @@ def _prepare_fields(fields):
     }
     if "_id" not in output:
         output["_id"] = True
+
+    if ensure_fields:
+        for key in ensure_fields:
+            output[key] = True
     return output
 
 
@@ -655,9 +659,8 @@ def get_last_versions(project_name, subset_ids, fields=None):
         doc["_version_id"]
         for doc in conn.aggregate(_pipeline)
     ]
-    fields = _prepare_fields(fields)
-    if fields and "parent" not in fields:
-        fields.append("parent")
+
+    fields = _prepare_fields(fields, ["parent"])
 
     version_docs = get_versions(
         project_name, version_ids=version_ids, fields=fields

From 67532139b989f6e831400a12c21dab33516d3004 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 15 Jun 2022 16:05:00 +0200
Subject: [PATCH 0660/1227] changed variable name to required_fields

---
 openpype/client/entities.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 1bfab5ad57..cc4032712c 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -23,7 +23,7 @@ def _get_project_connection(project_name=None):
     return mongodb
 
 
-def _prepare_fields(fields, ensure_fields=None):
+def _prepare_fields(fields, required_fields=None):
     if not fields:
         return None
 
@@ -34,8 +34,8 @@ def _prepare_fields(fields, ensure_fields=None):
     if "_id" not in output:
         output["_id"] = True
 
-    if ensure_fields:
-        for key in ensure_fields:
+    if required_fields:
+        for key in required_fields:
             output[key] = True
     return output
 

From ca926cf3102d0ddb40d17e88c117415773314278 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 5 May 2022 17:05:23 +0200
Subject: [PATCH 0661/1227] nuke: adding extract thumbnail settings

---
 .../defaults/project_settings/nuke.json       |  3 ++
 .../schemas/schema_nuke_publish.json          | 28 +++++++++++++++++--
 2 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 16348bec85..6c45e2a9c1 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -166,6 +166,9 @@
         },
         "ExtractThumbnail": {
             "enabled": true,
+            "use_rendered": true,
+            "bake_viewer_process": true,
+            "bake_viewer_input_process": true,
             "nodes": {
                 "Reformat": [
                     [
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
index 04df957d67..575bfe79e7 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
@@ -135,9 +135,31 @@
                     "label": "Enabled"
                 },
                 {
-                    "type": "raw-json",
-                    "key": "nodes",
-                    "label": "Nodes"
+                    "type": "boolean",
+                    "key": "use_rendered",
+                    "label": "Use rendered images"
+                },
+                {
+                    "type": "boolean",
+                    "key": "bake_viewer_process",
+                    "label": "Bake viewer process"
+                },
+                {
+                    "type": "boolean",
+                    "key": "bake_viewer_input_process",
+                    "label": "Bake viewer input process"
+                },
+                {
+                    "type": "collapsible-wrap",
+                    "label": "Nodes",
+                    "collapsible": true,
+                    "children": [
+                        {
+                            "type": "raw-json",
+                            "key": "nodes",
+                            "label": "Nodes"
+                        }
+                    ]
                 }
             ]
         },

From e21106aa9250d5317a157adcac7b38cffab7d990 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 5 May 2022 17:06:19 +0200
Subject: [PATCH 0662/1227] nuke: adding new attributes to extract thumnail

---
 .../nuke/plugins/publish/extract_thumbnail.py | 96 +++++++++++--------
 1 file changed, 56 insertions(+), 40 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
index ef6d486ca2..ce01f12a41 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
@@ -23,9 +23,13 @@ class ExtractThumbnail(openpype.api.Extractor):
     families = ["review"]
     hosts = ["nuke"]
 
-    # presets
+    # settings
+    use_rendered = False
+    bake_viewer_process = True
+    bake_viewer_input_process = True
     nodes = {}
 
+
     def process(self, instance):
         if "render.farm" in instance.data["families"]:
             return
@@ -53,48 +57,58 @@ class ExtractThumbnail(openpype.api.Extractor):
             "StagingDir `{0}`...".format(instance.data["stagingDir"]))
 
         temporary_nodes = []
-        collection = instance.data.get("collection", None)
 
-        if collection:
-            # get path
-            fname = os.path.basename(collection.format(
-                "{head}{padding}{tail}"))
-            fhead = collection.format("{head}")
+        # try to connect already rendered images
+        if self.use_rendered:
+            collection = instance.data.get("collection", None)
+            self.log.debug("__ collection: `{}`".format(collection))
 
-            # get first and last frame
-            first_frame = min(collection.indexes)
-            last_frame = max(collection.indexes)
-        else:
-            fname = os.path.basename(instance.data.get("path", None))
-            fhead = os.path.splitext(fname)[0] + "."
-            first_frame = instance.data.get("frameStart", None)
-            last_frame = instance.data.get("frameEnd", None)
+            if collection:
+                # get path
+                fname = os.path.basename(collection.format(
+                    "{head}{padding}{tail}"))
+                fhead = collection.format("{head}")
 
-        if "#" in fhead:
-            fhead = fhead.replace("#", "")[:-1]
+                # get first and last frame
+                first_frame = min(collection.indexes)
+                last_frame = max(collection.indexes)
+            else:
+                fname = os.path.basename(instance.data.get("path", None))
+                fhead = os.path.splitext(fname)[0] + "."
+                first_frame = instance.data.get("frameStart", None)
+                last_frame = instance.data.get("frameEnd", None)
 
-        path_render = os.path.join(staging_dir, fname).replace("\\", "/")
-        # check if file exist otherwise connect to write node
-        if os.path.isfile(path_render):
-            rnode = nuke.createNode("Read")
+            self.log.debug("__ fhead: `{}`".format(fhead))
 
-            rnode["file"].setValue(path_render)
+            if "#" in fhead:
+                fhead = fhead.replace("#", "")[:-1]
 
-            rnode["first"].setValue(first_frame)
-            rnode["origfirst"].setValue(first_frame)
-            rnode["last"].setValue(last_frame)
-            rnode["origlast"].setValue(last_frame)
-            temporary_nodes.append(rnode)
-            previous_node = rnode
-        else:
-            previous_node = node
+            path_render = os.path.join(staging_dir, fname).replace("\\", "/")
+            self.log.debug("__ path_render: `{}`".format(path_render))
 
-        # get input process and connect it to baking
-        ipn = self.get_view_process_node()
-        if ipn is not None:
-            ipn.setInput(0, previous_node)
-            previous_node = ipn
-            temporary_nodes.append(ipn)
+            # check if file exist otherwise connect to write node
+            if os.path.isfile(path_render):
+                rnode = nuke.createNode("Read")
+
+                rnode["file"].setValue(path_render)
+
+                rnode["first"].setValue(first_frame)
+                rnode["origfirst"].setValue(first_frame)
+                rnode["last"].setValue(last_frame)
+                rnode["origlast"].setValue(last_frame)
+                temporary_nodes.append(rnode)
+                previous_node = rnode
+            else:
+                previous_node = node
+
+        # bake viewer input look node into thumbnail image
+        if self.bake_viewer_input_process:
+            # get input process and connect it to baking
+            ipn = self.get_view_process_node()
+            if ipn is not None:
+                ipn.setInput(0, previous_node)
+                previous_node = ipn
+                temporary_nodes.append(ipn)
 
         reformat_node = nuke.createNode("Reformat")
 
@@ -110,10 +124,12 @@ class ExtractThumbnail(openpype.api.Extractor):
         previous_node = reformat_node
         temporary_nodes.append(reformat_node)
 
-        dag_node = nuke.createNode("OCIODisplay")
-        dag_node.setInput(0, previous_node)
-        previous_node = dag_node
-        temporary_nodes.append(dag_node)
+        # bake viewer colorspace into thumbnail image
+        if self.bake_viewer_process:
+            dag_node = nuke.createNode("OCIODisplay")
+            dag_node.setInput(0, previous_node)
+            previous_node = dag_node
+            temporary_nodes.append(dag_node)
 
         # create write node
         write_node = nuke.createNode("Write")

From 79f81b6b36bb94d077f1b3ef7e35db06e68b002f Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 5 May 2022 21:09:47 +0200
Subject: [PATCH 0663/1227] nuke: refactory extract thumbnail for new settings
 attributes

---
 .../nuke/plugins/publish/extract_thumbnail.py | 41 +++++++++----------
 1 file changed, 20 insertions(+), 21 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
index ce01f12a41..092fc07d6c 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
@@ -42,11 +42,17 @@ class ExtractThumbnail(openpype.api.Extractor):
             self.render_thumbnail(instance)
 
     def render_thumbnail(self, instance):
+        first_frame = instance.data["frameStartHandle"]
+        last_frame = instance.data["frameEndHandle"]
+
+        # find frame range and define middle thumb frame
+        mid_frame = int((last_frame - first_frame) / 2)
+
         node = instance[0]  # group node
         self.log.info("Creating staging dir...")
 
         if "representations" not in instance.data:
-            instance.data["representations"] = list()
+            instance.data["representations"] = []
 
         staging_dir = os.path.normpath(
             os.path.dirname(instance.data['path']))
@@ -69,21 +75,19 @@ class ExtractThumbnail(openpype.api.Extractor):
                     "{head}{padding}{tail}"))
                 fhead = collection.format("{head}")
 
-                # get first and last frame
-                first_frame = min(collection.indexes)
-                last_frame = max(collection.indexes)
+                thumb_fname = list(collection)[mid_frame]
             else:
-                fname = os.path.basename(instance.data.get("path", None))
+                fname = thumb_fname = os.path.basename(
+                    instance.data.get("path", None))
                 fhead = os.path.splitext(fname)[0] + "."
-                first_frame = instance.data.get("frameStart", None)
-                last_frame = instance.data.get("frameEnd", None)
 
             self.log.debug("__ fhead: `{}`".format(fhead))
 
             if "#" in fhead:
                 fhead = fhead.replace("#", "")[:-1]
 
-            path_render = os.path.join(staging_dir, fname).replace("\\", "/")
+            path_render = os.path.join(
+                staging_dir, thumb_fname).replace("\\", "/")
             self.log.debug("__ path_render: `{}`".format(path_render))
 
             # check if file exist otherwise connect to write node
@@ -92,10 +96,13 @@ class ExtractThumbnail(openpype.api.Extractor):
 
                 rnode["file"].setValue(path_render)
 
-                rnode["first"].setValue(first_frame)
-                rnode["origfirst"].setValue(first_frame)
-                rnode["last"].setValue(last_frame)
-                rnode["origlast"].setValue(last_frame)
+                # turn it raw if none of baking is ON
+                if all([
+                    not self.bake_viewer_input_process,
+                    not self.bake_viewer_process
+                ]):
+                    rnode["raw"].setValue(True)
+
                 temporary_nodes.append(rnode)
                 previous_node = rnode
             else:
@@ -144,26 +151,18 @@ class ExtractThumbnail(openpype.api.Extractor):
         temporary_nodes.append(write_node)
         tags = ["thumbnail", "publish_on_farm"]
 
-        # retime for
-        mid_frame = int((int(last_frame) - int(first_frame)) / 2) \
-            + int(first_frame)
-        first_frame = int(last_frame) / 2
-        last_frame = int(last_frame) / 2
-
         repre = {
             'name': name,
             'ext': "jpg",
             "outputName": "thumb",
             'files': file,
             "stagingDir": staging_dir,
-            "frameStart": first_frame,
-            "frameEnd": last_frame,
             "tags": tags
         }
         instance.data["representations"].append(repre)
 
         # Render frames
-        nuke.execute(write_node.name(), int(mid_frame), int(mid_frame))
+        nuke.execute(write_node.name(), mid_frame, mid_frame)
 
         self.log.debug(
             "representations: {}".format(instance.data["representations"]))

From 75b6acb0a4af5491e5a38a287f8ead9f88381123 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 15 Jun 2022 18:47:58 +0200
Subject: [PATCH 0664/1227] OP-3214 - removed wrong targets on Extractor

This caused missing extractors that should be running on a farm (Slate extractor for Nuke...).
Explicitly set all plugins creating jobs on DL to be triggered only on local.
---
 openpype/api.py                                      |  2 --
 .../plugins/publish/submit_aftereffects_deadline.py  |  1 +
 .../plugins/publish/submit_harmony_deadline.py       |  1 +
 .../deadline/plugins/publish/submit_maya_deadline.py |  1 +
 .../publish/submit_maya_remote_publish_deadline.py   |  3 ++-
 .../deadline/plugins/publish/submit_nuke_deadline.py |  1 +
 .../deadline/plugins/publish/submit_publish_job.py   |  1 +
 openpype/plugin.py                                   | 12 ------------
 8 files changed, 7 insertions(+), 15 deletions(-)

diff --git a/openpype/api.py b/openpype/api.py
index e049a683c6..9ce745b653 100644
--- a/openpype/api.py
+++ b/openpype/api.py
@@ -44,7 +44,6 @@ from . import resources
 
 from .plugin import (
     Extractor,
-    Integrator,
 
     ValidatePipelineOrder,
     ValidateContentsOrder,
@@ -87,7 +86,6 @@ __all__ = [
 
     # plugin classes
     "Extractor",
-    "Integrator",
     # ordering
     "ValidatePipelineOrder",
     "ValidateContentsOrder",
diff --git a/openpype/modules/deadline/plugins/publish/submit_aftereffects_deadline.py b/openpype/modules/deadline/plugins/publish/submit_aftereffects_deadline.py
index b6584f239e..de8df3dd9e 100644
--- a/openpype/modules/deadline/plugins/publish/submit_aftereffects_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_aftereffects_deadline.py
@@ -33,6 +33,7 @@ class AfterEffectsSubmitDeadline(
     hosts = ["aftereffects"]
     families = ["render.farm"]  # cannot be "render' as that is integrated
     use_published = True
+    targets = ["local"]
 
     priority = 50
     chunk_size = 1000000
diff --git a/openpype/modules/deadline/plugins/publish/submit_harmony_deadline.py b/openpype/modules/deadline/plugins/publish/submit_harmony_deadline.py
index 912f0f4026..2cf502224f 100644
--- a/openpype/modules/deadline/plugins/publish/submit_harmony_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_harmony_deadline.py
@@ -238,6 +238,7 @@ class HarmonySubmitDeadline(
     order = pyblish.api.IntegratorOrder + 0.1
     hosts = ["harmony"]
     families = ["render.farm"]
+    targets = ["local"]
 
     optional = True
     use_published = False
diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
index 8562c85f7d..9964e3c646 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
@@ -287,6 +287,7 @@ class MayaSubmitDeadline(pyblish.api.InstancePlugin):
     order = pyblish.api.IntegratorOrder + 0.1
     hosts = ["maya"]
     families = ["renderlayer"]
+    targets = ["local"]
 
     use_published = True
     tile_assembler_plugin = "OpenPypeTileAssembler"
diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
index 4f82818d6d..57572fcb24 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_remote_publish_deadline.py
@@ -10,7 +10,7 @@ import openpype.api
 import pyblish.api
 
 
-class MayaSubmitRemotePublishDeadline(openpype.api.Integrator):
+class MayaSubmitRemotePublishDeadline(pyblish.api.InstancePlugin):
     """Submit Maya scene to perform a local publish in Deadline.
 
     Publishing in Deadline can be helpful for scenes that publish very slow.
@@ -31,6 +31,7 @@ class MayaSubmitRemotePublishDeadline(openpype.api.Integrator):
     order = pyblish.api.IntegratorOrder
     hosts = ["maya"]
     families = ["publish.farm"]
+    targets = ["local"]
 
     def process(self, instance):
         settings = get_project_settings(os.getenv("AVALON_PROJECT"))
diff --git a/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py b/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
index 94c703d66d..ca68c87f9a 100644
--- a/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
@@ -23,6 +23,7 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin):
     hosts = ["nuke", "nukestudio"]
     families = ["render.farm", "prerender.farm"]
     optional = True
+    targets = ["local"]
 
     # presets
     priority = 50
diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 0583c25b57..860d9fd01b 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -103,6 +103,7 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
     order = pyblish.api.IntegratorOrder + 0.2
     icon = "tractor"
     deadline_plugin = "OpenPype"
+    targets = ["local"]
 
     hosts = ["fusion", "maya", "nuke", "celaction", "aftereffects", "harmony"]
 
diff --git a/openpype/plugin.py b/openpype/plugin.py
index 6637ad1d8b..bb9bc2ff85 100644
--- a/openpype/plugin.py
+++ b/openpype/plugin.py
@@ -18,16 +18,6 @@ class InstancePlugin(pyblish.api.InstancePlugin):
         super(InstancePlugin, cls).process(cls, *args, **kwargs)
 
 
-class Integrator(InstancePlugin):
-    """Integrator base class.
-
-    Wraps pyblish instance plugin. Targets set to "local" which means all
-    integrators should run on "local" publishes, by default.
-    "remote" targets could be used for integrators that should run externally.
-    """
-    targets = ["local"]
-
-
 class Extractor(InstancePlugin):
     """Extractor base class.
 
@@ -38,8 +28,6 @@ class Extractor(InstancePlugin):
 
     """
 
-    targets = ["local"]
-
     order = 2.0
 
     def staging_dir(self, instance):

From db1316dd688dc2bba62395aa968ab8af7b5ce552 Mon Sep 17 00:00:00 2001
From: maxpareschi <max.pareschi@gmail.com>
Date: Wed, 15 Jun 2022 20:56:33 +0200
Subject: [PATCH 0665/1227] Did this the easy way and let's go!

---
 openpype/modules/ftrack/ftrack_module.py      |  3 --
 openpype/modules/ftrack/tray/ftrack_tray.py   | 42 +------------------
 .../defaults/system_settings/modules.json     |  1 -
 .../module_settings/schema_ftrack.json        |  5 ---
 4 files changed, 1 insertion(+), 50 deletions(-)

diff --git a/openpype/modules/ftrack/ftrack_module.py b/openpype/modules/ftrack/ftrack_module.py
index 048e5ebfb1..f99e189082 100644
--- a/openpype/modules/ftrack/ftrack_module.py
+++ b/openpype/modules/ftrack/ftrack_module.py
@@ -42,9 +42,6 @@ class FtrackModule(
 
         self.ftrack_url = ftrack_url
 
-        ftrack_open_as_app = ftrack_settings["ftrack_open_as_app"]
-        self.ftrack_open_as_app = ftrack_open_as_app
-
         current_dir = os.path.dirname(os.path.abspath(__file__))
         low_platform = platform.system().lower()
 
diff --git a/openpype/modules/ftrack/tray/ftrack_tray.py b/openpype/modules/ftrack/tray/ftrack_tray.py
index e822fd4639..2919ae22fb 100644
--- a/openpype/modules/ftrack/tray/ftrack_tray.py
+++ b/openpype/modules/ftrack/tray/ftrack_tray.py
@@ -2,10 +2,6 @@ import os
 import time
 import datetime
 import threading
-import platform
-import posixpath
-import ntpath
-import webbrowser
 
 from Qt import QtCore, QtWidgets, QtGui
 
@@ -54,43 +50,7 @@ class FtrackTrayWrapper:
         self.widget_login.raise_()
 
     def show_ftrack_browser(self):
-        env_pf64 = os.environ['ProgramW6432'].replace(
-            ntpath.sep, posixpath.sep)
-        env_pf32 = os.environ['ProgramFiles(x86)'].replace(
-            ntpath.sep, posixpath.sep)
-        env_loc = os.environ['LocalAppData'].replace(
-            ntpath.sep, posixpath.sep)
-        chromium_paths_win = [
-            f"{env_pf64}/Google/Chrome/Application/chrome.exe",
-            f"{env_pf32}/Google/Chrome/Application/chrome.exe",
-            f"{env_loc}/Google/Chrome/Application/chrome.exe",
-            f"{env_pf32}/Microsoft/Edge/Application/msedge.exe"
-        ]
-        cur_os = cur_os = platform.system().lower()
-        if cur_os == "windows":
-            is_chromium = False
-            for p in chromium_paths_win:
-                if os.path.exists(p):
-                    is_chromium = True
-                    chromium_path = p
-                    break
-            if is_chromium and self.module.ftrack_open_as_app:
-                webbrowser.get(f"{chromium_path} %s").open_new(
-                    f"--app={self.module.ftrack_url}")
-            else:
-                webbrowser.get(using="windows-default").open_new(
-                    self.module.ftrack_url)
-
-        else:
-            if self.module.ftrack_open_as_app:
-                try:
-                    webbrowser.get(using='chrome').open_new(
-                        f"--app={self.module.ftrack_url}")
-                except webbrowser.Error:
-                    webbrowser.open_new(self.module.ftrack_url)
-            else:
-                webbrowser.open_new(self.module.ftrack_url)
-        return
+        QtGui.QDesktopServices.openUrl(self.module.ftrack_url)
 
     def validate(self):
         validation = False
diff --git a/openpype/settings/defaults/system_settings/modules.json b/openpype/settings/defaults/system_settings/modules.json
index 6d09652bb9..537e287366 100644
--- a/openpype/settings/defaults/system_settings/modules.json
+++ b/openpype/settings/defaults/system_settings/modules.json
@@ -15,7 +15,6 @@
     "ftrack": {
         "enabled": false,
         "ftrack_server": "",
-        "ftrack_open_as_app": false,
         "ftrack_actions_path": {
             "windows": [],
             "darwin": [],
diff --git a/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json b/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
index 570d856cf8..654ddf2938 100644
--- a/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
+++ b/openpype/settings/entities/schemas/system_schema/module_settings/schema_ftrack.json
@@ -16,11 +16,6 @@
             "key": "ftrack_server",
             "label": "Server"
         },
-        {
-            "type": "boolean",
-            "key": "ftrack_open_as_app",
-            "label": "Open in app mode"
-        },
         {
             "type": "splitter"
         },

From f87f461578b4eb2308aaff68d5576ff1743156cf Mon Sep 17 00:00:00 2001
From: pberto <pberto@gmail.com>
Date: Thu, 16 Jun 2022 15:07:01 +0900
Subject: [PATCH 0666/1227] docs: updated / simplified docs in light of
 upcoming changes

---
 website/docs/artist_hosts_maya_multiverse.md  |  21 +++++++++++++++++-
 website/docs/assets/maya-multiverse_setup.png | Bin 164855 -> 458197 bytes
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/website/docs/artist_hosts_maya_multiverse.md b/website/docs/artist_hosts_maya_multiverse.md
index e6520bafa0..a173e79125 100644
--- a/website/docs/artist_hosts_maya_multiverse.md
+++ b/website/docs/artist_hosts_maya_multiverse.md
@@ -65,6 +65,25 @@ the one depicted here:
 
 ![Maya - Multiverse Setup](assets/maya-multiverse_setup.png)
 
+
+```
+{
+    "MULTIVERSE_PATH": "/Path/to/Multiverse-{MULTIVERSE_VERSION}",
+    "MAYA_MODULE_PATH": "{MULTIVERSE}/Maya;{MAYA_MODULE_PATH}"
+}
+
+{
+    "MULTIVERSE_VERSION": "7.1.0-py27"
+}
+
+```
+
+The Multiverse Maya module file (.mod) pointed above contains all the necessary
+environment variables to run Multiverse.
+
+The OpenPype settings will contain blocks to enable/disable the Multiverse
+Creators and Loader, along with sensible studio setting.
+
 For more information about setup of Multiverse please refer to the relative page
 on the [Multiverse official documentation](https://multi-verse.io/docs).
 
@@ -94,7 +113,7 @@ You can choose the USD file format in the Creators' set nodes:
 - Assets: `.usd` (default) or `.usda` or `.usdz`
 - Compositions: `.usda` (default) or `.usd`
 - Overrides: `.usda` (default) or `.usd`
-- Looks: `.ma`
+- Looks: `.ma` (default)
 
 ![Maya - Multiverse Asset Creator](assets/maya-multiverse_openpype_asset_creator.png)
 
diff --git a/website/docs/assets/maya-multiverse_setup.png b/website/docs/assets/maya-multiverse_setup.png
index 8aa89ef7e504272e7b5f9abbfea0ec0ca3d1d783..72bdb0d3798f5e7234812ae3d8d8e70e2dac1bdf 100644
GIT binary patch
literal 458197
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%0A0#Rhm>vO*#ez
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%0DG^)#N*7t@wNCzvF#Dix
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%0Am_x
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

literal 164855
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
CH}}2(


From d5bd1a17eb85846cfc13ef22729523ee0670f101 Mon Sep 17 00:00:00 2001
From: DMO <dmo@j-cube.jp>
Date: Thu, 16 Jun 2022 16:36:17 +0900
Subject: [PATCH 0667/1227] Setting defaults of CreateMultiverseUsd to
 reasonable values.

Creating a schema entry for multiverse creators and setting defaults.
---
 .../plugins/create/create_multiverse_usd.py   |  6 ++--
 .../defaults/project_settings/deadline.json   |  2 +-
 .../defaults/project_settings/maya.json       | 16 +++++++++-
 .../schemas/schema_maya_create.json           | 31 +++++++------------
 4 files changed, 31 insertions(+), 24 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
index adf0acc7c2..5290d5143f 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
@@ -37,15 +37,15 @@ class CreateMultiverseUsd(plugin.Creator):
         self.data["writeUVs"] = True
         self.data["writeColorSets"] = False
         self.data["writeTangents"] = False
-        self.data["writeRefPositions"] = False
+        self.data["writeRefPositions"] = True
         self.data["writeBlendShapes"] = False
-        self.data["writeDisplayColor"] = False
+        self.data["writeDisplayColor"] = True
         self.data["writeSkinWeights"] = False
         self.data["writeMaterialAssignment"] = False
         self.data["writeHardwareShader"] = False
         self.data["writeShadingNetworks"] = False
         self.data["writeTransformMatrix"] = True
-        self.data["writeUsdAttributes"] = False
+        self.data["writeUsdAttributes"] = True
         self.data["writeInstancesAsReferences"] = False
         self.data["timeVaryingTopology"] = False
         self.data["customMaterialNamespace"] = ''
diff --git a/openpype/settings/defaults/project_settings/deadline.json b/openpype/settings/defaults/project_settings/deadline.json
index f0b2a7e555..5c5a14bf21 100644
--- a/openpype/settings/defaults/project_settings/deadline.json
+++ b/openpype/settings/defaults/project_settings/deadline.json
@@ -98,4 +98,4 @@
             }
         }
     }
-}
+}
\ No newline at end of file
diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index df54e44c56..7e404188cf 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -71,7 +71,21 @@
         },
         "CreateMultiverseUsd": {
             "enabled": true,
-            "strip_namespaces": true
+            "defaults": [
+                "Main"
+            ]
+        },
+        "CreateMultiverseUsdComp": {
+            "enabled": true,
+            "defaults": [
+                "Main"
+            ]
+        },
+        "CreateMultiverseUsdOver": {
+            "enabled": true,
+            "defaults": [
+                "Main"
+            ]
         },
         "CreateAnimation": {
             "enabled": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_create.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_create.json
index 4dd54c81a0..09287a8b50 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_create.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_create.json
@@ -143,29 +143,22 @@
                 }
             ]
         },
-        {
-            "type": "dict",
-            "collapsible": true,
-            "key": "CreateMultiverseUsd",
-            "label": "Create Multiverse USD",
-            "checkbox_key": "enabled",
-            "children": [
-                {
-                    "type": "boolean",
-                    "key": "enabled",
-                    "label": "Enabled"
-                },
-                {
-                    "type": "boolean",
-                    "key": "strip_namespaces",
-                    "label": "Strip Namespaces"
-                }
-            ]
-        },
         {
             "type": "schema_template",
             "name": "template_create_plugin",
             "template_data": [
+                {
+                    "key": "CreateMultiverseUsd",
+                    "label": "Create Multiverse USD"
+                },
+                {
+                    "key": "CreateMultiverseUsdComp",
+                    "label": "Create Multiverse USD Composition"
+                },
+                {
+                    "key": "CreateMultiverseUsdOver",
+                    "label": "Create Multiverse USD Override"
+                },
                 {
                     "key": "CreateAnimation",
                     "label": "Create Animation"

From eb3e0d626565697ff3fa7029cca9a4e318a61a8d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 11:35:57 +0200
Subject: [PATCH 0668/1227] add new representation only if was created

---
 openpype/plugins/publish/extract_jpeg_exr.py | 22 +++++++++++---------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index 3017656621..de01ebd2de 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -92,17 +92,19 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                 return
 
             new_repre = {
-                    "name": "thumbnail",
-                    "ext": "jpg",
-                    "files": jpeg_file,
-                    "stagingDir": stagingdir,
-                    "thumbnail": True,
-                    "tags": ["thumbnail"]
-                }
+                "name": "thumbnail",
+                "ext": "jpg",
+                "files": jpeg_file,
+                "stagingDir": stagingdir,
+                "thumbnail": True,
+                "tags": ["thumbnail"]
+            }
 
-        # adding representation
-        self.log.debug("Adding: {}".format(new_repre))
-        instance.data["representations"].append(new_repre)
+            # adding representation
+            self.log.debug(
+                "Adding thumbnail representation: {}".format(new_repre)
+            )
+            instance.data["representations"].append(new_repre)
 
     def _get_filtered_repres(self, instance):
         filtered_repres = []

From 5bdbebf4cc163d182d599561967088382ba0adc7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 11:36:03 +0200
Subject: [PATCH 0669/1227] create only one thumbnail

---
 openpype/plugins/publish/extract_jpeg_exr.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index de01ebd2de..a467728e77 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -105,6 +105,8 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
                 "Adding thumbnail representation: {}".format(new_repre)
             )
             instance.data["representations"].append(new_repre)
+            # There is no need to create more then one thumbnail
+            break
 
     def _get_filtered_repres(self, instance):
         filtered_repres = []

From b722062928b081f9d7a7e51ec37d7118834459c0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 16 Jun 2022 12:35:06 +0200
Subject: [PATCH 0670/1227] Fix: Kitsu module first synchronization Add a
 `None` to `pop(...)` to avoid process abortion at early stage of production

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 673a195747..08e50d959b 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -85,7 +85,7 @@ def update_op_assets(
         # Frame in, fallback on 0
         frame_in = int(item_data.get("frame_in") or 0)
         item_data["frameStart"] = frame_in
-        item_data.pop("frame_in")
+        item_data.pop("frame_in", None)
         # Frame out, fallback on frame_in + duration
         frames_duration = int(item.get("nb_frames") or 1)
         frame_out = (
@@ -94,7 +94,7 @@ def update_op_assets(
             else frame_in + frames_duration
         )
         item_data["frameEnd"] = int(frame_out)
-        item_data.pop("frame_out")
+        item_data.pop("frame_out", None)
         # Fps, fallback to project's value when entity fps is deleted
         if not item_data.get("fps") and item_doc["data"].get("fps"):
             item_data["fps"] = project_doc["data"]["fps"]

From edf13e877f7416c2a64e1a123003bdfffce10d64 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 14:45:06 +0200
Subject: [PATCH 0671/1227] removed requirement of pypeclub role in default
 settings

---
 .../defaults/system_settings/modules.json      | 18 ++++++------------
 1 file changed, 6 insertions(+), 12 deletions(-)

diff --git a/openpype/settings/defaults/system_settings/modules.json b/openpype/settings/defaults/system_settings/modules.json
index 537e287366..8cd4114cb0 100644
--- a/openpype/settings/defaults/system_settings/modules.json
+++ b/openpype/settings/defaults/system_settings/modules.json
@@ -59,13 +59,11 @@
                 "applications": {
                     "write_security_roles": [
                         "API",
-                        "Administrator",
-                        "Pypeclub"
+                        "Administrator"
                     ],
                     "read_security_roles": [
                         "API",
-                        "Administrator",
-                        "Pypeclub"
+                        "Administrator"
                     ]
                 }
             },
@@ -73,25 +71,21 @@
                 "tools_env": {
                     "write_security_roles": [
                         "API",
-                        "Administrator",
-                        "Pypeclub"
+                        "Administrator"
                     ],
                     "read_security_roles": [
                         "API",
-                        "Administrator",
-                        "Pypeclub"
+                        "Administrator"
                     ]
                 },
                 "avalon_mongo_id": {
                     "write_security_roles": [
                         "API",
-                        "Administrator",
-                        "Pypeclub"
+                        "Administrator"
                     ],
                     "read_security_roles": [
                         "API",
-                        "Administrator",
-                        "Pypeclub"
+                        "Administrator"
                     ]
                 },
                 "fps": {

From 8857423828377a319fd80292f9b0ca0e49e5b2ad Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 14:49:52 +0200
Subject: [PATCH 0672/1227] Changed label of custom attribute action

---
 .../ftrack/event_handlers_user/action_create_cust_attrs.py    | 4 ++--
 website/docs/module_ftrack.md                                 | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_create_cust_attrs.py b/openpype/modules/ftrack/event_handlers_user/action_create_cust_attrs.py
index 88dc8213bd..d04440a564 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_create_cust_attrs.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_create_cust_attrs.py
@@ -140,9 +140,9 @@ class CustomAttributes(BaseAction):
     identifier = 'create.update.attributes'
     #: Action label.
     label = "OpenPype Admin"
-    variant = '- Create/Update Avalon Attributes'
+    variant = '- Create/Update Custom Attributes'
     #: Action description.
-    description = 'Creates Avalon/Mongo ID for double check'
+    description = 'Creates required custom attributes in ftrack'
     icon = statics_icon("ftrack", "action_icons", "OpenPypeAdmin.svg")
     settings_key = "create_update_attributes"
 
diff --git a/website/docs/module_ftrack.md b/website/docs/module_ftrack.md
index fd9687ed9d..667782754f 100644
--- a/website/docs/module_ftrack.md
+++ b/website/docs/module_ftrack.md
@@ -26,7 +26,7 @@ You can only use our Ftrack Actions and publish to Ftrack if each artist is logg
 ### Custom Attributes
 After successfully connecting OpenPype with you Ftrack, you can right click on any project in Ftrack and you should see a bunch of actions available. The most important one is called `OpenPype Admin` and contains multiple options inside.
 
-To prepare Ftrack for working with OpenPype you'll need to run [OpenPype Admin - Create/Update Avalon Attributes](manager_ftrack_actions.md#create-update-avalon-attributes), which creates and sets the Custom Attributes necessary for OpenPype to function. 
+To prepare Ftrack for working with OpenPype you'll need to run [OpenPype Admin - Create/Update Custom Attributes](manager_ftrack_actions.md#create-update-avalon-attributes), which creates and sets the Custom Attributes necessary for OpenPype to function. 
 
 
 

From bcb52309517350de2ad0aa91f28ab317dfffdbce Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 16 Jun 2022 15:05:46 +0200
Subject: [PATCH 0673/1227] Fix - add default target for New Publisher

---
 openpype/pipeline/create/context.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index 2f1922c103..7931ea400a 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -829,9 +829,10 @@ class CreateContext:
             discover_result = publish_plugins_discover()
             publish_plugins = discover_result.plugins
 
-            targets = pyblish.logic.registered_targets() or ["default"]
+            targets = set(pyblish.logic.registered_targets())
+            targets.add("default")
             plugins_by_targets = pyblish.logic.plugins_by_targets(
-                publish_plugins, targets
+                publish_plugins, list(targets)
             )
             # Collect plugins that can have attribute definitions
             for plugin in publish_plugins:

From 98646b9c0ad95aed664c6b5e10fe266cdba9040b Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 16 Jun 2022 15:32:05 +0200
Subject: [PATCH 0674/1227] standalone: adding rename shot switch and hierarchy
 switch

---
 .../plugins/publish/collect_hierarchy.py      | 19 ++++++++++++-------
 .../project_settings/standalonepublisher.json |  6 ++++--
 .../schema_project_standalonepublisher.json   | 15 +++++++++++++--
 3 files changed, 29 insertions(+), 11 deletions(-)

diff --git a/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py b/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py
index 77163651c4..2452f77e56 100644
--- a/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py
+++ b/openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py
@@ -1,4 +1,5 @@
 import os
+from pprint import pformat
 import re
 from copy import deepcopy
 import pyblish.api
@@ -21,6 +22,7 @@ class CollectHierarchyInstance(pyblish.api.ContextPlugin):
     families = ["shot"]
 
     # presets
+    shot_rename = True
     shot_rename_template = None
     shot_rename_search_patterns = None
     shot_add_hierarchy = None
@@ -46,7 +48,7 @@ class CollectHierarchyInstance(pyblish.api.ContextPlugin):
         parent_name = instance.context.data["assetEntity"]["name"]
         clip = instance.data["item"]
         clip_name = os.path.splitext(clip.name)[0].lower()
-        if self.shot_rename_search_patterns:
+        if self.shot_rename_search_patterns and self.shot_rename:
             search_text += parent_name + clip_name
             instance.data["anatomyData"].update({"clip_name": clip_name})
             for type, pattern in self.shot_rename_search_patterns.items():
@@ -56,9 +58,9 @@ class CollectHierarchyInstance(pyblish.api.ContextPlugin):
                     continue
                 instance.data["anatomyData"][type] = match[-1]
 
-        # format to new shot name
-        instance.data["asset"] = self.shot_rename_template.format(
-            **instance.data["anatomyData"])
+            # format to new shot name
+            instance.data["asset"] = self.shot_rename_template.format(
+                **instance.data["anatomyData"])
 
     def create_hierarchy(self, instance):
         parents = list()
@@ -82,7 +84,7 @@ class CollectHierarchyInstance(pyblish.api.ContextPlugin):
                 "entity_name": entity["name"]
             })
 
-        if self.shot_add_hierarchy:
+        if self.shot_add_hierarchy.get("enabled"):
             parent_template_patern = re.compile(r"\{([a-z]*?)\}")
             # fill the parents parts from presets
             shot_add_hierarchy = self.shot_add_hierarchy.copy()
@@ -126,8 +128,8 @@ class CollectHierarchyInstance(pyblish.api.ContextPlugin):
         instance.data["parents"] = parents
 
         # print
-        self.log.debug(f"Hierarchy: {hierarchy}")
-        self.log.debug(f"parents: {parents}")
+        self.log.warning(f"Hierarchy: {hierarchy}")
+        self.log.info(f"parents: {parents}")
 
         if self.shot_add_tasks:
             tasks_to_add = dict()
@@ -161,6 +163,9 @@ class CollectHierarchyInstance(pyblish.api.ContextPlugin):
         })
 
     def process(self, context):
+        self.log.info("self.shot_add_hierarchy: {}".format(
+            pformat(self.shot_add_hierarchy)
+        ))
         for instance in context:
             if instance.data["family"] in self.families:
                 self.processing_instance(instance)
diff --git a/openpype/settings/defaults/project_settings/standalonepublisher.json b/openpype/settings/defaults/project_settings/standalonepublisher.json
index e36232d3f7..b6e2e056a1 100644
--- a/openpype/settings/defaults/project_settings/standalonepublisher.json
+++ b/openpype/settings/defaults/project_settings/standalonepublisher.json
@@ -257,12 +257,14 @@
             ]
         },
         "CollectHierarchyInstance": {
+            "shot_rename": true,
             "shot_rename_template": "{project[code]}_{_sequence_}_{_shot_}",
             "shot_rename_search_patterns": {
-                "_sequence_": "(\\d{4})(?=_\\d{4})",
-                "_shot_": "(\\d{4})(?!_\\d{4})"
+                "_sequence_": "(sc\\d{3})",
+                "_shot_": "(sh\\d{3})"
             },
             "shot_add_hierarchy": {
+                "enabled": true,
                 "parents_path": "{project}/{folder}/{sequence}",
                 "parents": {
                     "project": "{project[name]}",
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_standalonepublisher.json b/openpype/settings/entities/schemas/projects_schema/schema_project_standalonepublisher.json
index 37fcaac69f..ae25007683 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_standalonepublisher.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_standalonepublisher.json
@@ -271,6 +271,11 @@
                     "label": "Collect Instance Hierarchy",
                     "is_group": true,
                     "children": [
+                        {
+                            "type": "boolean",
+                            "key": "shot_rename",
+                            "label": "Shot Rename"
+                        },
                         {
                             "type": "text",
                             "key": "shot_rename_template",
@@ -289,7 +294,13 @@
                             "type": "dict",
                             "key": "shot_add_hierarchy",
                             "label": "Shot hierarchy",
+                            "checkbox_key": "enabled",
                             "children": [
+                                {
+                                    "type": "boolean",
+                                    "key": "enabled",
+                                    "label": "Enabled"
+                                },
                                 {
                                     "type": "text",
                                     "key": "parents_path",
@@ -343,8 +354,8 @@
                             "type": "number",
                             "key": "timeline_frame_start",
                             "label": "Timeline start frame",
-                            "default": 900000,
-                            "minimum": 1,
+                            "default": 90000,
+                            "minimum": 0,
                             "maximum": 10000000
                         },
                         {

From 2da7261abff69322970ee6daafcc0068ce04216d Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 16 Jun 2022 15:32:37 +0200
Subject: [PATCH 0675/1227] standalone: ensure extension with dot at start

---
 .../plugins/publish/extract_trim_video_audio.py              | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/standalonepublisher/plugins/publish/extract_trim_video_audio.py b/openpype/hosts/standalonepublisher/plugins/publish/extract_trim_video_audio.py
index f327895b83..51dc84e9a2 100644
--- a/openpype/hosts/standalonepublisher/plugins/publish/extract_trim_video_audio.py
+++ b/openpype/hosts/standalonepublisher/plugins/publish/extract_trim_video_audio.py
@@ -39,11 +39,14 @@ class ExtractTrimVideoAudio(openpype.api.Extractor):
         # Generate mov file.
         fps = instance.data["fps"]
         video_file_path = instance.data["editorialSourcePath"]
-        extensions = instance.data.get("extensions", [".mov"])
+        extensions = instance.data.get("extensions", ["mov"])
 
         for ext in extensions:
             self.log.info("Processing ext: `{}`".format(ext))
 
+            if not ext.startswith("."):
+                ext = "." + ext
+
             clip_trimed_path = os.path.join(
                 staging_dir, instance.data["name"] + ext)
             # # check video file metadata

From 84134acb7c4291d1bf864e34f68a5a47f3da513c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 15:35:03 +0200
Subject: [PATCH 0676/1227] copied editorial to openpype.pipeline

---
 openpype/pipeline/editorial.py | 282 +++++++++++++++++++++++++++++++++
 1 file changed, 282 insertions(+)
 create mode 100644 openpype/pipeline/editorial.py

diff --git a/openpype/pipeline/editorial.py b/openpype/pipeline/editorial.py
new file mode 100644
index 0000000000..f62a1842e0
--- /dev/null
+++ b/openpype/pipeline/editorial.py
@@ -0,0 +1,282 @@
+import os
+import re
+import clique
+
+import opentimelineio as otio
+from opentimelineio import opentime as _ot
+
+
+def otio_range_to_frame_range(otio_range):
+    start = _ot.to_frames(
+        otio_range.start_time, otio_range.start_time.rate)
+    end = start + _ot.to_frames(
+        otio_range.duration, otio_range.duration.rate)
+    return start, end
+
+
+def otio_range_with_handles(otio_range, instance):
+    handle_start = instance.data["handleStart"]
+    handle_end = instance.data["handleEnd"]
+    handles_duration = handle_start + handle_end
+    fps = float(otio_range.start_time.rate)
+    start = _ot.to_frames(otio_range.start_time, fps)
+    duration = _ot.to_frames(otio_range.duration, fps)
+
+    return _ot.TimeRange(
+        start_time=_ot.RationalTime((start - handle_start), fps),
+        duration=_ot.RationalTime((duration + handles_duration), fps)
+    )
+
+
+def is_overlapping_otio_ranges(test_otio_range, main_otio_range, strict=False):
+    test_start, test_end = otio_range_to_frame_range(test_otio_range)
+    main_start, main_end = otio_range_to_frame_range(main_otio_range)
+    covering_exp = bool(
+        (test_start <= main_start) and (test_end >= main_end)
+    )
+    inside_exp = bool(
+        (test_start >= main_start) and (test_end <= main_end)
+    )
+    overlaying_right_exp = bool(
+        (test_start <= main_end) and (test_end >= main_end)
+    )
+    overlaying_left_exp = bool(
+        (test_end >= main_start) and (test_start <= main_start)
+    )
+
+    if not strict:
+        return any((
+            covering_exp,
+            inside_exp,
+            overlaying_right_exp,
+            overlaying_left_exp
+        ))
+    else:
+        return covering_exp
+
+
+def convert_to_padded_path(path, padding):
+    """
+    Return correct padding in sequence string
+
+    Args:
+        path (str): path url or simple file name
+        padding (int): number of padding
+
+    Returns:
+        type: string with reformated path
+
+    Example:
+        convert_to_padded_path("plate.%d.exr") > plate.%04d.exr
+
+    """
+    if "%d" in path:
+        path = re.sub("%d", "%0{padding}d".format(padding=padding), path)
+    return path
+
+
+def trim_media_range(media_range, source_range):
+    """
+    Trim input media range with clip source range.
+
+    Args:
+        media_range (otio._ot._ot.TimeRange): available range of media
+        source_range (otio._ot._ot.TimeRange): clip required range
+
+    Returns:
+        otio._ot._ot.TimeRange: trimmed media range
+
+    """
+    rw_media_start = _ot.RationalTime(
+        media_range.start_time.value + source_range.start_time.value,
+        media_range.start_time.rate
+    )
+    rw_media_duration = _ot.RationalTime(
+        source_range.duration.value,
+        media_range.duration.rate
+    )
+    return _ot.TimeRange(
+        rw_media_start, rw_media_duration)
+
+
+def range_from_frames(start, duration, fps):
+    """
+    Returns otio time range.
+
+    Args:
+        start (int): frame start
+        duration (int): frame duration
+        fps (float): frame range
+
+    Returns:
+        otio._ot._ot.TimeRange: created range
+
+    """
+    return _ot.TimeRange(
+        _ot.RationalTime(start, fps),
+        _ot.RationalTime(duration, fps)
+    )
+
+
+def frames_to_seconds(frames, framerate):
+    """
+    Returning seconds.
+
+    Args:
+        frames (int): frame
+        framerate (float): frame rate
+
+    Returns:
+        float: second value
+    """
+
+    rt = _ot.from_frames(frames, framerate)
+    return _ot.to_seconds(rt)
+
+
+def frames_to_timecode(frames, framerate):
+    rt = _ot.from_frames(frames, framerate)
+    return _ot.to_timecode(rt)
+
+
+def make_sequence_collection(path, otio_range, metadata):
+    """
+    Make collection from path otio range and otio metadata.
+
+    Args:
+        path (str): path to image sequence with `%d`
+        otio_range (otio._ot._ot.TimeRange): range to be used
+        metadata (dict): data where padding value can be found
+
+    Returns:
+        list: dir_path (str): path to sequence, collection object
+
+    """
+    if "%" not in path:
+        return None
+    file_name = os.path.basename(path)
+    dir_path = os.path.dirname(path)
+    head = file_name.split("%")[0]
+    tail = os.path.splitext(file_name)[-1]
+    first, last = otio_range_to_frame_range(otio_range)
+    collection = clique.Collection(
+        head=head, tail=tail, padding=metadata["padding"])
+    collection.indexes.update([i for i in range(first, last)])
+    return dir_path, collection
+
+
+def _sequence_resize(source, length):
+    step = float(len(source) - 1) / (length - 1)
+    for i in range(length):
+        low, ratio = divmod(i * step, 1)
+        high = low + 1 if ratio > 0 else low
+        yield (1 - ratio) * source[int(low)] + ratio * source[int(high)]
+
+
+def get_media_range_with_retimes(otio_clip, handle_start, handle_end):
+    source_range = otio_clip.source_range
+    available_range = otio_clip.available_range()
+    media_in = available_range.start_time.value
+    media_out = available_range.end_time_inclusive().value
+
+    # modifiers
+    time_scalar = 1.
+    offset_in = 0
+    offset_out = 0
+    time_warp_nodes = []
+
+    # Check for speed effects and adjust playback speed accordingly
+    for effect in otio_clip.effects:
+        if isinstance(effect, otio.schema.LinearTimeWarp):
+            time_scalar = effect.time_scalar
+
+        elif isinstance(effect, otio.schema.FreezeFrame):
+            # For freeze frame, playback speed must be set after range
+            time_scalar = 0.
+
+        elif isinstance(effect, otio.schema.TimeEffect):
+            # For freeze frame, playback speed must be set after range
+            name = effect.name
+            effect_name = effect.effect_name
+            if "TimeWarp" not in effect_name:
+                continue
+            metadata = effect.metadata
+            lookup = metadata.get("lookup")
+            if not lookup:
+                continue
+
+            # time warp node
+            tw_node = {
+                "Class": "TimeWarp",
+                "name": name
+            }
+            tw_node.update(metadata)
+            tw_node["lookup"] = list(lookup)
+
+            # get first and last frame offsets
+            offset_in += lookup[0]
+            offset_out += lookup[-1]
+
+            # add to timewarp nodes
+            time_warp_nodes.append(tw_node)
+
+    # multiply by time scalar
+    offset_in *= time_scalar
+    offset_out *= time_scalar
+
+    # filip offset if reversed speed
+    if time_scalar < 0:
+        _offset_in = offset_out
+        _offset_out = offset_in
+        offset_in = _offset_in
+        offset_out = _offset_out
+
+    # scale handles
+    handle_start *= abs(time_scalar)
+    handle_end *= abs(time_scalar)
+
+    # filip handles if reversed speed
+    if time_scalar < 0:
+        _handle_start = handle_end
+        _handle_end = handle_start
+        handle_start = _handle_start
+        handle_end = _handle_end
+
+    source_in = source_range.start_time.value
+
+    media_in_trimmed = (
+        media_in + source_in + offset_in)
+    media_out_trimmed = (
+        media_in + source_in + (
+            ((source_range.duration.value - 1) * abs(
+                time_scalar)) + offset_out))
+
+    # calculate available handles
+    if (media_in_trimmed - media_in) < handle_start:
+        handle_start = (media_in_trimmed - media_in)
+    if (media_out - media_out_trimmed) < handle_end:
+        handle_end = (media_out - media_out_trimmed)
+
+    # create version data
+    version_data = {
+        "versionData": {
+            "retime": True,
+            "speed": time_scalar,
+            "timewarps": time_warp_nodes,
+            "handleStart": round(handle_start),
+            "handleEnd": round(handle_end)
+        }
+    }
+
+    returning_dict = {
+        "mediaIn": media_in_trimmed,
+        "mediaOut": media_out_trimmed,
+        "handleStart": round(handle_start),
+        "handleEnd": round(handle_end)
+    }
+
+    # add version data only if retime
+    if time_warp_nodes or time_scalar != 1.:
+        returning_dict.update(version_data)
+
+    return returning_dict

From 228c84af83d111918b5366be2625d1a869584058 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 15:36:17 +0200
Subject: [PATCH 0677/1227] import editorial functions from
 openpype.pipeline.editorial

---
 .../publish/collect_timeline_instances.py     |  9 +++++---
 .../plugins/publish/precollect_instances.py   |  6 ++---
 openpype/hosts/resolve/api/lib.py             |  4 ++--
 .../publish/collect_otio_frame_ranges.py      | 11 ++++++----
 .../publish/collect_otio_subset_resources.py  | 12 ++++++----
 .../plugins/publish/extract_otio_review.py    | 22 ++++++++++++-------
 .../publish/extract_otio_trimming_video.py    |  5 +++--
 7 files changed, 43 insertions(+), 26 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
index 0aca7c38d5..8c2d172732 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
@@ -2,7 +2,10 @@ import re
 import pyblish
 import openpype.hosts.flame.api as opfapi
 from openpype.hosts.flame.otio import flame_export
-import openpype.lib as oplib
+from openpype.pipeline.editorial import (
+    is_overlapping_otio_ranges,
+    get_media_range_with_retimes
+)
 
 # # developer reload modules
 from pprint import pformat
@@ -271,7 +274,7 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
 
         # HACK: it is here to serve for versions bellow 2021.1
         if not any([head, tail]):
-            retimed_attributes = oplib.get_media_range_with_retimes(
+            retimed_attributes = get_media_range_with_retimes(
                 otio_clip, handle_start, handle_end)
             self.log.debug(
                 ">> retimed_attributes: {}".format(retimed_attributes))
@@ -370,7 +373,7 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
                 continue
             if otio_clip.name not in segment.name.get_value():
                 continue
-            if oplib.is_overlapping_otio_ranges(
+            if is_overlapping_otio_ranges(
                     parent_range, timeline_range, strict=True):
 
                 # add pypedata marker to otio_clip metadata
diff --git a/openpype/hosts/hiero/plugins/publish/precollect_instances.py b/openpype/hosts/hiero/plugins/publish/precollect_instances.py
index b891a37d9d..2d0ec6fc99 100644
--- a/openpype/hosts/hiero/plugins/publish/precollect_instances.py
+++ b/openpype/hosts/hiero/plugins/publish/precollect_instances.py
@@ -1,5 +1,5 @@
 import pyblish
-import openpype
+from openpype.pipeline.editorial import is_overlapping_otio_ranges
 from openpype.hosts.hiero import api as phiero
 from openpype.hosts.hiero.api.otio import hiero_export
 import hiero
@@ -275,7 +275,7 @@ class PrecollectInstances(pyblish.api.ContextPlugin):
             parent_range = otio_audio.range_in_parent()
 
             # if any overaling clip found then return True
-            if openpype.lib.is_overlapping_otio_ranges(
+            if is_overlapping_otio_ranges(
                     parent_range, timeline_range, strict=False):
                 return True
 
@@ -304,7 +304,7 @@ class PrecollectInstances(pyblish.api.ContextPlugin):
                 continue
             self.log.debug("__ parent_range: {}".format(parent_range))
             self.log.debug("__ timeline_range: {}".format(timeline_range))
-            if openpype.lib.is_overlapping_otio_ranges(
+            if is_overlapping_otio_ranges(
                     parent_range, timeline_range, strict=True):
 
                 # add pypedata marker to otio_clip metadata
diff --git a/openpype/hosts/resolve/api/lib.py b/openpype/hosts/resolve/api/lib.py
index 22f83c6eed..c4717bd370 100644
--- a/openpype/hosts/resolve/api/lib.py
+++ b/openpype/hosts/resolve/api/lib.py
@@ -4,7 +4,7 @@ import re
 import os
 import contextlib
 from opentimelineio import opentime
-import openpype
+from openpype.pipeline.editorial import is_overlapping_otio_ranges
 
 from ..otio import davinci_export as otio_export
 
@@ -824,7 +824,7 @@ def get_otio_clip_instance_data(otio_timeline, timeline_item_data):
             continue
         if otio_clip.name not in timeline_item.GetName():
             continue
-        if openpype.lib.is_overlapping_otio_ranges(
+        if is_overlapping_otio_ranges(
                 parent_range, timeline_range, strict=True):
 
             # add pypedata marker to otio_clip metadata
diff --git a/openpype/plugins/publish/collect_otio_frame_ranges.py b/openpype/plugins/publish/collect_otio_frame_ranges.py
index 8eaf9d6f29..c86e777850 100644
--- a/openpype/plugins/publish/collect_otio_frame_ranges.py
+++ b/openpype/plugins/publish/collect_otio_frame_ranges.py
@@ -8,8 +8,11 @@ Requires:
 # import os
 import opentimelineio as otio
 import pyblish.api
-import openpype.lib
 from pprint import pformat
+from openpype.pipeline.editorial import (
+    otio_range_to_frame_range,
+    otio_range_with_handles
+)
 
 
 class CollectOtioFrameRanges(pyblish.api.InstancePlugin):
@@ -31,9 +34,9 @@ class CollectOtioFrameRanges(pyblish.api.InstancePlugin):
         otio_tl_range = otio_clip.range_in_parent()
         otio_src_range = otio_clip.source_range
         otio_avalable_range = otio_clip.available_range()
-        otio_tl_range_handles = openpype.lib.otio_range_with_handles(
+        otio_tl_range_handles = otio_range_with_handles(
             otio_tl_range, instance)
-        otio_src_range_handles = openpype.lib.otio_range_with_handles(
+        otio_src_range_handles = otio_range_with_handles(
             otio_src_range, instance)
 
         # get source avalable start frame
@@ -42,7 +45,7 @@ class CollectOtioFrameRanges(pyblish.api.InstancePlugin):
             otio_avalable_range.start_time.rate)
 
         # convert to frames
-        range_convert = openpype.lib.otio_range_to_frame_range
+        range_convert = otio_range_to_frame_range
         tl_start, tl_end = range_convert(otio_tl_range)
         tl_start_h, tl_end_h = range_convert(otio_tl_range_handles)
         src_start, src_end = range_convert(otio_src_range)
diff --git a/openpype/plugins/publish/collect_otio_subset_resources.py b/openpype/plugins/publish/collect_otio_subset_resources.py
index 40d4f35bdc..fc6a9b50f2 100644
--- a/openpype/plugins/publish/collect_otio_subset_resources.py
+++ b/openpype/plugins/publish/collect_otio_subset_resources.py
@@ -10,7 +10,11 @@ import os
 import clique
 import opentimelineio as otio
 import pyblish.api
-import openpype.lib as oplib
+from openpype.pipeline.editorial import (
+    get_media_range_with_retimes,
+    range_from_frames,
+    make_sequence_collection
+)
 
 
 class CollectOtioSubsetResources(pyblish.api.InstancePlugin):
@@ -42,7 +46,7 @@ class CollectOtioSubsetResources(pyblish.api.InstancePlugin):
         available_duration = otio_avalable_range.duration.value
 
         # get available range trimmed with processed retimes
-        retimed_attributes = oplib.get_media_range_with_retimes(
+        retimed_attributes = get_media_range_with_retimes(
             otio_clip, handle_start, handle_end)
         self.log.debug(
             ">> retimed_attributes: {}".format(retimed_attributes))
@@ -64,7 +68,7 @@ class CollectOtioSubsetResources(pyblish.api.InstancePlugin):
         a_frame_end_h = media_out + handle_end
 
         # create trimmed otio time range
-        trimmed_media_range_h = oplib.range_from_frames(
+        trimmed_media_range_h = range_from_frames(
             a_frame_start_h, (a_frame_end_h - a_frame_start_h) + 1,
             media_fps
         )
@@ -144,7 +148,7 @@ class CollectOtioSubsetResources(pyblish.api.InstancePlugin):
                 # in case it is file sequence but not new OTIO schema
                 # `ImageSequenceReference`
                 path = media_ref.target_url
-                collection_data = oplib.make_sequence_collection(
+                collection_data = make_sequence_collection(
                     path, trimmed_media_range_h, metadata)
                 self.staging_dir, collection = collection_data
 
diff --git a/openpype/plugins/publish/extract_otio_review.py b/openpype/plugins/publish/extract_otio_review.py
index 35adc97442..2ce5323468 100644
--- a/openpype/plugins/publish/extract_otio_review.py
+++ b/openpype/plugins/publish/extract_otio_review.py
@@ -19,6 +19,13 @@ import clique
 import opentimelineio as otio
 from pyblish import api
 import openpype
+from openpype.pipeline.editorial import (
+    otio_range_to_frame_range,
+    trim_media_range,
+    range_from_frames,
+    frames_to_seconds,
+    make_sequence_collection
+)
 
 
 class ExtractOTIOReview(openpype.api.Extractor):
@@ -161,7 +168,7 @@ class ExtractOTIOReview(openpype.api.Extractor):
                         dirname = media_ref.target_url_base
                         head = media_ref.name_prefix
                         tail = media_ref.name_suffix
-                        first, last = openpype.lib.otio_range_to_frame_range(
+                        first, last = otio_range_to_frame_range(
                             available_range)
                         collection = clique.Collection(
                             head=head,
@@ -180,7 +187,7 @@ class ExtractOTIOReview(openpype.api.Extractor):
                         # in case it is file sequence but not new OTIO schema
                         # `ImageSequenceReference`
                         path = media_ref.target_url
-                        collection_data = openpype.lib.make_sequence_collection(
+                        collection_data = make_sequence_collection(
                             path, available_range, metadata)
                         dir_path, collection = collection_data
 
@@ -305,8 +312,8 @@ class ExtractOTIOReview(openpype.api.Extractor):
             duration = avl_durtation
 
         # return correct trimmed range
-        return openpype.lib.trim_media_range(
-            avl_range, openpype.lib.range_from_frames(start, duration, fps)
+        return trim_media_range(
+            avl_range, range_from_frames(start, duration, fps)
         )
 
     def _render_seqment(self, sequence=None,
@@ -357,8 +364,8 @@ class ExtractOTIOReview(openpype.api.Extractor):
             frame_start = otio_range.start_time.value
             input_fps = otio_range.start_time.rate
             frame_duration = otio_range.duration.value
-            sec_start = openpype.lib.frames_to_secons(frame_start, input_fps)
-            sec_duration = openpype.lib.frames_to_secons(
+            sec_start = frames_to_seconds(frame_start, input_fps)
+            sec_duration = frames_to_seconds(
                 frame_duration, input_fps
             )
 
@@ -370,8 +377,7 @@ class ExtractOTIOReview(openpype.api.Extractor):
             ])
 
         elif gap:
-            sec_duration = openpype.lib.frames_to_secons(
-                gap, self.actual_fps)
+            sec_duration = frames_to_seconds(gap, self.actual_fps)
 
             # form command for rendering gap files
             command.extend([
diff --git a/openpype/plugins/publish/extract_otio_trimming_video.py b/openpype/plugins/publish/extract_otio_trimming_video.py
index e8e2994f36..19625fa568 100644
--- a/openpype/plugins/publish/extract_otio_trimming_video.py
+++ b/openpype/plugins/publish/extract_otio_trimming_video.py
@@ -9,6 +9,7 @@ import os
 from pyblish import api
 import openpype
 from copy import deepcopy
+from openpype.pipeline.editorial import frames_to_seconds
 
 
 class ExtractOTIOTrimmingVideo(openpype.api.Extractor):
@@ -81,8 +82,8 @@ class ExtractOTIOTrimmingVideo(openpype.api.Extractor):
         frame_start = otio_range.start_time.value
         input_fps = otio_range.start_time.rate
         frame_duration = otio_range.duration.value - 1
-        sec_start = openpype.lib.frames_to_secons(frame_start, input_fps)
-        sec_duration = openpype.lib.frames_to_secons(frame_duration, input_fps)
+        sec_start = frames_to_seconds(frame_start, input_fps)
+        sec_duration = frames_to_seconds(frame_duration, input_fps)
 
         # form command for rendering gap files
         command.extend([

From c4f3ad901b8bea13735bf3a2308d7c3ee957d8a2 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 15:36:57 +0200
Subject: [PATCH 0678/1227] kept editorial functions in openpype.lib with
 deprecated decorator

---
 openpype/lib/editorial.py | 315 +++++++-------------------------------
 1 file changed, 59 insertions(+), 256 deletions(-)

diff --git a/openpype/lib/editorial.py b/openpype/lib/editorial.py
index 32d6dc3688..2730ba1f3c 100644
--- a/openpype/lib/editorial.py
+++ b/openpype/lib/editorial.py
@@ -1,289 +1,92 @@
-import os
-import re
-import clique
-from .import_utils import discover_host_vendor_module
-
-try:
-    import opentimelineio as otio
-    from opentimelineio import opentime as _ot
-except ImportError:
-    if not os.environ.get("AVALON_APP"):
-        raise
-    otio = discover_host_vendor_module("opentimelineio")
-    _ot = discover_host_vendor_module("opentimelineio.opentime")
+import warnings
+import functools
 
 
-def otio_range_to_frame_range(otio_range):
-    start = _ot.to_frames(
-        otio_range.start_time, otio_range.start_time.rate)
-    end = start + _ot.to_frames(
-        otio_range.duration, otio_range.duration.rate)
-    return start, end
+def editorial_deprecated(func):
+    """Mark functions as deprecated.
 
-
-def otio_range_with_handles(otio_range, instance):
-    handle_start = instance.data["handleStart"]
-    handle_end = instance.data["handleEnd"]
-    handles_duration = handle_start + handle_end
-    fps = float(otio_range.start_time.rate)
-    start = _ot.to_frames(otio_range.start_time, fps)
-    duration = _ot.to_frames(otio_range.duration, fps)
-
-    return _ot.TimeRange(
-        start_time=_ot.RationalTime((start - handle_start), fps),
-        duration=_ot.RationalTime((duration + handles_duration), fps)
-    )
-
-
-def is_overlapping_otio_ranges(test_otio_range, main_otio_range, strict=False):
-    test_start, test_end = otio_range_to_frame_range(test_otio_range)
-    main_start, main_end = otio_range_to_frame_range(main_otio_range)
-    covering_exp = bool(
-        (test_start <= main_start) and (test_end >= main_end)
-    )
-    inside_exp = bool(
-        (test_start >= main_start) and (test_end <= main_end)
-    )
-    overlaying_right_exp = bool(
-        (test_start <= main_end) and (test_end >= main_end)
-    )
-    overlaying_left_exp = bool(
-        (test_end >= main_start) and (test_start <= main_start)
-    )
-
-    if not strict:
-        return any((
-            covering_exp,
-            inside_exp,
-            overlaying_right_exp,
-            overlaying_left_exp
-        ))
-    else:
-        return covering_exp
-
-
-def convert_to_padded_path(path, padding):
+    It will result in a warning being emitted when the function is used.
     """
-    Return correct padding in sequence string
 
-    Args:
-        path (str): path url or simple file name
-        padding (int): number of padding
-
-    Returns:
-        type: string with reformated path
-
-    Example:
-        convert_to_padded_path("plate.%d.exr") > plate.%04d.exr
-
-    """
-    if "%d" in path:
-        path = re.sub("%d", "%0{padding}d".format(padding=padding), path)
-    return path
+    @functools.wraps(func)
+    def new_func(*args, **kwargs):
+        warnings.warn(
+            (
+                "Call to deprecated function '{}'."
+                " Function was moved to 'openpype.pipeline.editorial'."
+            ).format(func.__name__),
+            category=DeprecationWarning,
+            stacklevel=2
+        )
+        return func(*args, **kwargs)
+    return new_func
 
 
-def trim_media_range(media_range, source_range):
-    """
-    Trim input media range with clip source range.
+@editorial_deprecated
+def otio_range_to_frame_range(*args, **kwargs):
+    from openpype.pipeline.editorial import otio_range_to_frame_range
 
-    Args:
-        media_range (otio._ot._ot.TimeRange): available range of media
-        source_range (otio._ot._ot.TimeRange): clip required range
-
-    Returns:
-        otio._ot._ot.TimeRange: trimmed media range
-
-    """
-    rw_media_start = _ot.RationalTime(
-        media_range.start_time.value + source_range.start_time.value,
-        media_range.start_time.rate
-    )
-    rw_media_duration = _ot.RationalTime(
-        source_range.duration.value,
-        media_range.duration.rate
-    )
-    return _ot.TimeRange(
-        rw_media_start, rw_media_duration)
+    return otio_range_to_frame_range(*args, **kwargs)
 
 
-def range_from_frames(start, duration, fps):
-    """
-    Returns otio time range.
+@editorial_deprecated
+def otio_range_with_handles(*args, **kwargs):
+    from openpype.pipeline.editorial import otio_range_with_handles
 
-    Args:
-        start (int): frame start
-        duration (int): frame duration
-        fps (float): frame range
-
-    Returns:
-        otio._ot._ot.TimeRange: created range
-
-    """
-    return _ot.TimeRange(
-        _ot.RationalTime(start, fps),
-        _ot.RationalTime(duration, fps)
-    )
+    return otio_range_with_handles(*args, **kwargs)
 
 
-def frames_to_secons(frames, framerate):
-    """
-    Returning secons.
+@editorial_deprecated
+def is_overlapping_otio_ranges(*args, **kwargs):
+    from openpype.pipeline.editorial import is_overlapping_otio_ranges
 
-    Args:
-        frames (int): frame
-        framerate (float): frame rate
-
-    Returns:
-        float: second value
-
-    """
-    rt = _ot.from_frames(frames, framerate)
-    return _ot.to_seconds(rt)
+    return is_overlapping_otio_ranges(*args, **kwargs)
 
 
-def frames_to_timecode(frames, framerate):
-    rt = _ot.from_frames(frames, framerate)
-    return _ot.to_timecode(rt)
+@editorial_deprecated
+def convert_to_padded_path(*args, **kwargs):
+    from openpype.pipeline.editorial import convert_to_padded_path
+
+    return convert_to_padded_path(*args, **kwargs)
 
 
-def make_sequence_collection(path, otio_range, metadata):
-    """
-    Make collection from path otio range and otio metadata.
+@editorial_deprecated
+def trim_media_range(*args, **kwargs):
+    from openpype.pipeline.editorial import trim_media_range
 
-    Args:
-        path (str): path to image sequence with `%d`
-        otio_range (otio._ot._ot.TimeRange): range to be used
-        metadata (dict): data where padding value can be found
-
-    Returns:
-        list: dir_path (str): path to sequence, collection object
-
-    """
-    if "%" not in path:
-        return None
-    file_name = os.path.basename(path)
-    dir_path = os.path.dirname(path)
-    head = file_name.split("%")[0]
-    tail = os.path.splitext(file_name)[-1]
-    first, last = otio_range_to_frame_range(otio_range)
-    collection = clique.Collection(
-        head=head, tail=tail, padding=metadata["padding"])
-    collection.indexes.update([i for i in range(first, last)])
-    return dir_path, collection
+    return trim_media_range(*args, **kwargs)
 
 
-def _sequence_resize(source, length):
-    step = float(len(source) - 1) / (length - 1)
-    for i in range(length):
-        low, ratio = divmod(i * step, 1)
-        high = low + 1 if ratio > 0 else low
-        yield (1 - ratio) * source[int(low)] + ratio * source[int(high)]
+@editorial_deprecated
+def range_from_frames(*args, **kwargs):
+    from openpype.pipeline.editorial import range_from_frames
+
+    return range_from_frames(*args, **kwargs)
 
 
-def get_media_range_with_retimes(otio_clip, handle_start, handle_end):
-    source_range = otio_clip.source_range
-    available_range = otio_clip.available_range()
-    media_in = available_range.start_time.value
-    media_out = available_range.end_time_inclusive().value
+@editorial_deprecated
+def frames_to_seconds(*args, **kwargs):
+    from openpype.pipeline.editorial import frames_to_seconds
 
-    # modifiers
-    time_scalar = 1.
-    offset_in = 0
-    offset_out = 0
-    time_warp_nodes = []
+    return frames_to_seconds(*args, **kwargs)
 
-    # Check for speed effects and adjust playback speed accordingly
-    for effect in otio_clip.effects:
-        if isinstance(effect, otio.schema.LinearTimeWarp):
-            time_scalar = effect.time_scalar
 
-        elif isinstance(effect, otio.schema.FreezeFrame):
-            # For freeze frame, playback speed must be set after range
-            time_scalar = 0.
+@editorial_deprecated
+def frames_to_timecode(*args, **kwargs):
+    from openpype.pipeline.editorial import frames_to_timecode
 
-        elif isinstance(effect, otio.schema.TimeEffect):
-            # For freeze frame, playback speed must be set after range
-            name = effect.name
-            effect_name = effect.effect_name
-            if "TimeWarp" not in effect_name:
-                continue
-            metadata = effect.metadata
-            lookup = metadata.get("lookup")
-            if not lookup:
-                continue
+    return frames_to_timecode(*args, **kwargs)
 
-            # time warp node
-            tw_node = {
-                "Class": "TimeWarp",
-                "name": name
-            }
-            tw_node.update(metadata)
-            tw_node["lookup"] = list(lookup)
 
-            # get first and last frame offsets
-            offset_in += lookup[0]
-            offset_out += lookup[-1]
+@editorial_deprecated
+def make_sequence_collection(*args, **kwargs):
+    from openpype.pipeline.editorial import make_sequence_collection
 
-            # add to timewarp nodes
-            time_warp_nodes.append(tw_node)
+    return make_sequence_collection(*args, **kwargs)
 
-    # multiply by time scalar
-    offset_in *= time_scalar
-    offset_out *= time_scalar
 
-    # filip offset if reversed speed
-    if time_scalar < 0:
-        _offset_in = offset_out
-        _offset_out = offset_in
-        offset_in = _offset_in
-        offset_out = _offset_out
+@editorial_deprecated
+def get_media_range_with_retimes(*args, **kwargs):
+    from openpype.pipeline.editorial import get_media_range_with_retimes
 
-    # scale handles
-    handle_start *= abs(time_scalar)
-    handle_end *= abs(time_scalar)
-
-    # filip handles if reversed speed
-    if time_scalar < 0:
-        _handle_start = handle_end
-        _handle_end = handle_start
-        handle_start = _handle_start
-        handle_end = _handle_end
-
-    source_in = source_range.start_time.value
-
-    media_in_trimmed = (
-        media_in + source_in + offset_in)
-    media_out_trimmed = (
-        media_in + source_in + (
-            ((source_range.duration.value - 1) * abs(
-                time_scalar)) + offset_out))
-
-    # calculate available handles
-    if (media_in_trimmed - media_in) < handle_start:
-        handle_start = (media_in_trimmed - media_in)
-    if (media_out - media_out_trimmed) < handle_end:
-        handle_end = (media_out - media_out_trimmed)
-
-    # create version data
-    version_data = {
-        "versionData": {
-            "retime": True,
-            "speed": time_scalar,
-            "timewarps": time_warp_nodes,
-            "handleStart": round(handle_start),
-            "handleEnd": round(handle_end)
-        }
-    }
-
-    returning_dict = {
-        "mediaIn": media_in_trimmed,
-        "mediaOut": media_out_trimmed,
-        "handleStart": round(handle_start),
-        "handleEnd": round(handle_end)
-    }
-
-    # add version data only if retime
-    if time_warp_nodes or time_scalar != 1.:
-        returning_dict.update(version_data)
-
-    return returning_dict
+    return get_media_range_with_retimes(*args, **kwargs)

From 4c046b442aef143a065b84c7c933fba14d1a34f5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 15:37:14 +0200
Subject: [PATCH 0679/1227] removed unused discover_host_vendor_module

---
 openpype/lib/import_utils.py | 25 -------------------------
 1 file changed, 25 deletions(-)
 delete mode 100644 openpype/lib/import_utils.py

diff --git a/openpype/lib/import_utils.py b/openpype/lib/import_utils.py
deleted file mode 100644
index e88c07fca6..0000000000
--- a/openpype/lib/import_utils.py
+++ /dev/null
@@ -1,25 +0,0 @@
-import os
-import sys
-import importlib
-from .log import PypeLogger as Logger
-
-log = Logger().get_logger(__name__)
-
-
-def discover_host_vendor_module(module_name):
-    host = os.environ["AVALON_APP"]
-    pype_root = os.environ["OPENPYPE_REPOS_ROOT"]
-    main_module = module_name.split(".")[0]
-    module_path = os.path.join(
-        pype_root, "hosts", host, "vendor", main_module)
-
-    log.debug(
-        "Importing module from host vendor path: `{}`".format(module_path))
-
-    if not os.path.exists(module_path):
-        log.warning(
-            "Path not existing: `{}`".format(module_path))
-        return None
-
-    sys.path.insert(1, module_path)
-    return importlib.import_module(module_name)

From 5b9d2f2915f59e4b98f00bdf5855a7f093a7c46a Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 16 Jun 2022 16:41:09 +0200
Subject: [PATCH 0680/1227] Fix - add AE validation scene on render.local

It was missing for local rendering.
---
 .../aftereffects/plugins/publish/validate_scene_settings.py     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/aftereffects/plugins/publish/validate_scene_settings.py b/openpype/hosts/aftereffects/plugins/publish/validate_scene_settings.py
index 14e224fdc2..6fe63fc41e 100644
--- a/openpype/hosts/aftereffects/plugins/publish/validate_scene_settings.py
+++ b/openpype/hosts/aftereffects/plugins/publish/validate_scene_settings.py
@@ -54,7 +54,7 @@ class ValidateSceneSettings(OptionalPyblishPluginMixin,
 
     order = pyblish.api.ValidatorOrder
     label = "Validate Scene Settings"
-    families = ["render.farm", "render"]
+    families = ["render.farm", "render.local", "render"]
     hosts = ["aftereffects"]
     optional = True
 

From ab0bc2108c5d9a954e7fb9adde3cda732ace9afe Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 16 Jun 2022 16:44:18 +0200
Subject: [PATCH 0681/1227] deadline: fixing misidentification of revieables

---
 .../deadline/plugins/publish/submit_publish_job.py    | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 0583c25b57..d2f709825c 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -642,9 +642,6 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
     def _solve_families(self, instance, preview=False):
         families = instance.get("families")
 
-        # test also instance data review attribute
-        preview = preview or instance.get("review")
-
         # if we have one representation with preview tag
         # flag whole instance for review and for ftrack
         if preview:
@@ -726,6 +723,10 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
 
         families = ["render"]
 
+        # pass review to families if marked as review
+        if data.get("review"):
+            families.append("review")
+
         instance_skeleton_data = {
             "family": "render",
             "subset": subset,
@@ -754,10 +755,6 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
                 "family": "prerender",
                 "families": []})
 
-        # also include review attribute if available
-        if "review" in data:
-            instance_skeleton_data["review"] = data["review"]
-
         # skip locking version if we are creating v01
         instance_version = instance.data.get("version")  # take this if exists
         if instance_version != 1:

From 2890c950f5b58fd7654497aae22016d2d1df56ca Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 16:46:31 +0200
Subject: [PATCH 0682/1227] trigger open events

---
 openpype/tools/workfiles/files_widget.py | 45 ++++++++++++++++++++----
 1 file changed, 38 insertions(+), 7 deletions(-)

diff --git a/openpype/tools/workfiles/files_widget.py b/openpype/tools/workfiles/files_widget.py
index 68fe8301c9..709f05b26b 100644
--- a/openpype/tools/workfiles/files_widget.py
+++ b/openpype/tools/workfiles/files_widget.py
@@ -90,7 +90,9 @@ class FilesWidget(QtWidgets.QWidget):
         self._task_type = None
 
         # Pype's anatomy object for current project
-        self.anatomy = Anatomy(legacy_io.Session["AVALON_PROJECT"])
+        project_name = legacy_io.Session["AVALON_PROJECT"]
+        self.anatomy = Anatomy(project_name)
+        self.project_name = project_name
         # Template key used to get work template from anatomy templates
         self.template_key = "work"
 
@@ -98,6 +100,7 @@ class FilesWidget(QtWidgets.QWidget):
         self._workfiles_root = None
         self._workdir_path = None
         self.host = registered_host()
+        self.host_name = os.environ["AVALON_APP"]
 
         # Whether to automatically select the latest modified
         # file on a refresh of the files model.
@@ -385,8 +388,9 @@ class FilesWidget(QtWidgets.QWidget):
             return None
 
         if self._asset_doc is None:
-            project_name = legacy_io.active_project()
-            self._asset_doc = get_asset_by_id(project_name, self._asset_id)
+            self._asset_doc = get_asset_by_id(
+                self.project_name, self._asset_id
+            )
 
         return self._asset_doc
 
@@ -396,8 +400,8 @@ class FilesWidget(QtWidgets.QWidget):
         session = legacy_io.Session.copy()
         self.template_key = get_workfile_template_key(
             self._task_type,
-            session["AVALON_APP"],
-            project_name=session["AVALON_PROJECT"]
+            self.host_name,
+            project_name=self.project_name
         )
         changes = compute_session_changes(
             session,
@@ -453,8 +457,35 @@ class FilesWidget(QtWidgets.QWidget):
                 # Save current scene, continue to open file
                 host.save_file(current_file)
 
+        asset_name = None
+        asset_doc = self._get_asset_doc()
+        if asset_doc:
+            asset_name = asset_doc["name"]
+
+        emit_event(
+            "workfile.open.before",
+            {
+                "filepath": filepath,
+                "project_name": self.project_name,
+                "asset_name": asset_name,
+                "task_name": self._task_name,
+                "host_name": self.host_name
+            },
+            source="workfiles.tool"
+        )
         self._enter_session()
         host.open_file(filepath)
+        emit_event(
+            "workfile.open.after",
+            {
+                "filepath": filepath,
+                "project_name": self.project_name,
+                "asset_name": asset_name,
+                "task_name": self._task_name,
+                "host_name": self.host_name
+            },
+            source="workfiles.tool"
+        )
         self.file_opened.emit()
 
     def save_changes_prompt(self):
@@ -602,10 +633,10 @@ class FilesWidget(QtWidgets.QWidget):
         # Create extra folders
         create_workdir_extra_folders(
             self._workdir_path,
-            legacy_io.Session["AVALON_APP"],
+            self.host_name,
             self._task_type,
             self._task_name,
-            legacy_io.Session["AVALON_PROJECT"]
+            self.project_name
         )
         # Trigger after save events
         emit_event(

From ee4b635edd51523e46864e00c5ec873e477e3e3b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 16:51:55 +0200
Subject: [PATCH 0683/1227] trigger open workfile events in workfiles tool

---
 openpype/tools/workfiles/files_widget.py | 54 +++++++++++++++---------
 1 file changed, 33 insertions(+), 21 deletions(-)

diff --git a/openpype/tools/workfiles/files_widget.py b/openpype/tools/workfiles/files_widget.py
index 709f05b26b..a7e54471dc 100644
--- a/openpype/tools/workfiles/files_widget.py
+++ b/openpype/tools/workfiles/files_widget.py
@@ -1,6 +1,7 @@
 import os
 import logging
 import shutil
+import copy
 
 import Qt
 from Qt import QtWidgets, QtCore
@@ -434,6 +435,21 @@ class FilesWidget(QtWidgets.QWidget):
             template_key=self.template_key
         )
 
+    def _get_event_context_data(self):
+        asset_id = None
+        asset_name = None
+        asset_doc = self._get_asset_doc()
+        if asset_doc:
+            asset_id = asset_doc["_id"]
+            asset_name = asset_doc["name"]
+        return {
+            "project_name": self.project_name,
+            "asset_id": asset_id,
+            "asset_name": asset_name,
+            "task_name": self._task_name,
+            "host_name": self.host_name
+        }
+
     def open_file(self, filepath):
         host = self.host
         if host.has_unsaved_changes():
@@ -457,33 +473,19 @@ class FilesWidget(QtWidgets.QWidget):
                 # Save current scene, continue to open file
                 host.save_file(current_file)
 
-        asset_name = None
-        asset_doc = self._get_asset_doc()
-        if asset_doc:
-            asset_name = asset_doc["name"]
-
+        event_data_before = self._get_event_context_data()
+        event_data_before["filepath"] = filepath
+        event_data_after = copy.deepcopy(event_data_before)
         emit_event(
             "workfile.open.before",
-            {
-                "filepath": filepath,
-                "project_name": self.project_name,
-                "asset_name": asset_name,
-                "task_name": self._task_name,
-                "host_name": self.host_name
-            },
+            event_data_before,
             source="workfiles.tool"
         )
         self._enter_session()
         host.open_file(filepath)
         emit_event(
             "workfile.open.after",
-            {
-                "filepath": filepath,
-                "project_name": self.project_name,
-                "asset_name": asset_name,
-                "task_name": self._task_name,
-                "host_name": self.host_name
-            },
+            event_data_after,
             source="workfiles.tool"
         )
         self.file_opened.emit()
@@ -598,9 +600,14 @@ class FilesWidget(QtWidgets.QWidget):
         src_path = self._get_selected_filepath()
 
         # Trigger before save event
+        event_data_before = self._get_event_context_data()
+        event_data_before.update({
+            "filename": work_filename,
+            "workdir_path": self._workdir_path
+        })
         emit_event(
             "workfile.save.before",
-            {"filename": work_filename, "workdir_path": self._workdir_path},
+            event_data_before,
             source="workfiles.tool"
         )
 
@@ -638,10 +645,15 @@ class FilesWidget(QtWidgets.QWidget):
             self._task_name,
             self.project_name
         )
+        event_data_after = self._get_event_context_data()
+        event_data_after.update({
+            "filename": work_filename,
+            "workdir_path": self._workdir_path
+        })
         # Trigger after save events
         emit_event(
             "workfile.save.after",
-            {"filename": work_filename, "workdir_path": self._workdir_path},
+            event_data_after,
             source="workfiles.tool"
         )
 

From 94f9d6309822431dc00218687207cefcc4397b11 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 17:05:26 +0200
Subject: [PATCH 0684/1227] modules have method that can be called on host
 installation

---
 openpype/modules/base.py | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/openpype/modules/base.py b/openpype/modules/base.py
index bca64b19f8..b9ccec13cc 100644
--- a/openpype/modules/base.py
+++ b/openpype/modules/base.py
@@ -463,6 +463,25 @@ class OpenPypeModule:
 
         pass
 
+    def on_host_install(self, host, host_name, project_name):
+        """Host was installed which gives option to handle in-host logic.
+
+        It is a good option to register in-host event callbacks which are
+        specific for the module. The module is kept in memory for rest of
+        the process.
+
+        Arguments may change in future. E.g. 'host_name' should be possible
+        to receive from 'host' object.
+
+        Args:
+            host (ModuleType): Access to installed/registered host object.
+            host_name (str): Name of host.
+            project_name (str): Project name which is main part of host
+                context.
+        """
+
+        pass
+
     def cli(self, module_click_group):
         """Add commands to click group.
 

From 0c28a29650491603a04ad9f9178e7cdc81c9f73b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 17:05:48 +0200
Subject: [PATCH 0685/1227] trigger on_host_install method on host installation

---
 openpype/pipeline/context_tools.py | 33 ++++++++++++++++++++++++++++--
 1 file changed, 31 insertions(+), 2 deletions(-)

diff --git a/openpype/pipeline/context_tools.py b/openpype/pipeline/context_tools.py
index c6e09cfba1..8643c3d69d 100644
--- a/openpype/pipeline/context_tools.py
+++ b/openpype/pipeline/context_tools.py
@@ -33,6 +33,9 @@ from . import (
 _is_installed = False
 _registered_root = {"_": ""}
 _registered_host = {"_": None}
+# Keep modules manager (and it's modules) in memory
+# - that gives option to register modules' callbacks
+_modules_manager = None
 
 log = logging.getLogger(__name__)
 
@@ -44,6 +47,23 @@ PUBLISH_PATH = os.path.join(PLUGINS_DIR, "publish")
 LOAD_PATH = os.path.join(PLUGINS_DIR, "load")
 
 
+def _get_modules_manager():
+    """Get or create modules manager for host installation.
+
+    This is not meant for public usage. Reason is to keep modules
+    in memory of process to be able trigger their event callbacks if they
+    need any.
+
+    Returns:
+        ModulesManager: Manager wrapping discovered modules.
+    """
+
+    global _modules_manager
+    if _modules_manager is None:
+        _modules_manager = ModulesManager()
+    return _modules_manager
+
+
 def register_root(path):
     """Register currently active root"""
     log.info("Registering root: %s" % path)
@@ -70,10 +90,12 @@ def install_host(host):
             avalon host-interface.
     """
     global _is_installed
+    global _modules_manager
 
     _is_installed = True
 
     legacy_io.install()
+    modules_manager = _get_modules_manager()
 
     missing = list()
     for key in ("AVALON_PROJECT", "AVALON_ASSET"):
@@ -112,7 +134,14 @@ def install_host(host):
     else:
         pyblish.api.register_target("local")
 
-    install_openpype_plugins()
+    project_name = os.environ.get("AVALON_PROJECT")
+    host_name = os.environ.get("AVALON_APP")
+
+    # Give option to handle host installation
+    for module in modules_manager.get_enabled_modules():
+        module.on_host_install(host, host_name, project_name)
+
+    install_openpype_plugins(project_name, host_name)
 
 
 def install_openpype_plugins(project_name=None, host_name=None):
@@ -124,7 +153,7 @@ def install_openpype_plugins(project_name=None, host_name=None):
     pyblish.api.register_discovery_filter(filter_pyblish_plugins)
     register_loader_plugin_path(LOAD_PATH)
 
-    modules_manager = ModulesManager()
+    modules_manager = _get_modules_manager()
     publish_plugin_dirs = modules_manager.collect_plugin_paths()["publish"]
     for path in publish_plugin_dirs:
         pyblish.api.register_plugin_path(path)

From 89a7d438b4b37e0903ae33f54de58bb04a03b9c4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 17:42:46 +0200
Subject: [PATCH 0686/1227] added human readable keys into taskChanged topic
 data

---
 openpype/lib/avalon_context.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 9d8a92cfe9..243e89e00d 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -797,8 +797,14 @@ def update_current_task(task=None, asset=None, app=None, template_key=None):
         else:
             os.environ[key] = value
 
+    data = changes.copy()
+    # Convert env keys to human readable keys
+    data["project_name"] = legacy_io.Session["AVALON_PROJECT"]
+    data["asset_name"] = legacy_io.Session["AVALON_ASSET"]
+    data["task_name"] = legacy_io.Session["AVALON_TASK"]
+
     # Emit session change
-    emit_event("taskChanged", changes.copy())
+    emit_event("taskChanged", data)
 
     return changes
 

From cbb876c155fb6f31356d74404f7763689e09a6d7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 16 Jun 2022 17:43:18 +0200
Subject: [PATCH 0687/1227] moved timer change on task change to timers manager
 module

---
 .../modules/timers_manager/timers_manager.py   | 18 ++++++++++++++++++
 openpype/pipeline/context_tools.py             |  8 --------
 2 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/openpype/modules/timers_manager/timers_manager.py b/openpype/modules/timers_manager/timers_manager.py
index 3f77a2b7dc..3cf1614316 100644
--- a/openpype/modules/timers_manager/timers_manager.py
+++ b/openpype/modules/timers_manager/timers_manager.py
@@ -7,6 +7,7 @@ from openpype_interfaces import (
     ITrayService,
     ILaunchHookPaths
 )
+from openpype.lib.events import register_event_callback
 from openpype.pipeline import AvalonMongoDB
 
 from .exceptions import InvalidContextError
@@ -422,3 +423,20 @@ class TimersManager(OpenPypeModule, ITrayService, ILaunchHookPaths):
         }
 
         return requests.post(rest_api_url, json=data)
+
+    def on_host_install(self, host, host_name, project_name):
+        self.log.debug("Installing task changed callback")
+        register_event_callback("taskChanged", self._on_host_task_change)
+
+    def _on_host_task_change(self, event):
+        project_name = event["project_name"]
+        asset_name = event["asset_name"]
+        task_name = event["task_name"]
+        self.log.debug((
+            "Sending message that timer should change to"
+            " Project: {} Asset: {} Task: {}"
+        ).format(project_name, asset_name, task_name))
+
+        self.start_timer_with_webserver(
+            project_name, asset_name, task_name, self.log
+        )
diff --git a/openpype/pipeline/context_tools.py b/openpype/pipeline/context_tools.py
index 8643c3d69d..3e63eeba27 100644
--- a/openpype/pipeline/context_tools.py
+++ b/openpype/pipeline/context_tools.py
@@ -16,9 +16,7 @@ from openpype.modules import load_modules, ModulesManager
 from openpype.settings import get_project_settings
 from openpype.lib import (
     Anatomy,
-    register_event_callback,
     filter_pyblish_plugins,
-    change_timer_to_current_context,
 )
 
 from . import (
@@ -117,8 +115,6 @@ def install_host(host):
 
     register_host(host)
 
-    register_event_callback("taskChanged", _on_task_change)
-
     def modified_emit(obj, record):
         """Method replacing `emit` in Pyblish's MessageHandler."""
         record.msg = record.getMessage()
@@ -197,10 +193,6 @@ def install_openpype_plugins(project_name=None, host_name=None):
             register_inventory_action(path)
 
 
-def _on_task_change():
-    change_timer_to_current_context()
-
-
 def uninstall_host():
     """Undo all of what `install()` did"""
     host = registered_host()

From 3da1720702a2f21350e8a9cb4f17bbca4e11db23 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 16 Jun 2022 18:04:08 +0200
Subject: [PATCH 0688/1227] Fix - validate_scene_settings was failing for
 legacy instances

Fix - renderLocal is published to 'render' folder same as render farm
---
 .../hosts/aftereffects/plugins/publish/collect_render.py    | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/aftereffects/plugins/publish/collect_render.py b/openpype/hosts/aftereffects/plugins/publish/collect_render.py
index fa23bf92b0..97b3175c57 100644
--- a/openpype/hosts/aftereffects/plugins/publish/collect_render.py
+++ b/openpype/hosts/aftereffects/plugins/publish/collect_render.py
@@ -21,7 +21,7 @@ class AERenderInstance(RenderInstance):
     projectEntity = attr.ib(default=None)
     stagingDir = attr.ib(default=None)
     app_version = attr.ib(default=None)
-    publish_attributes = attr.ib(default=None)
+    publish_attributes = attr.ib(default={})
     file_name = attr.ib(default=None)
 
 
@@ -90,7 +90,7 @@ class CollectAERender(abstract_collect_render.AbstractCollectRender):
 
             subset_name = inst.data["subset"]
             instance = AERenderInstance(
-                family=family,
+                family="render",
                 families=inst.data.get("families", []),
                 version=version,
                 time="",
@@ -116,7 +116,7 @@ class CollectAERender(abstract_collect_render.AbstractCollectRender):
                 toBeRenderedOn='deadline',
                 fps=fps,
                 app_version=app_version,
-                publish_attributes=inst.data.get("publish_attributes"),
+                publish_attributes=inst.data.get("publish_attributes", {}),
                 file_name=render_q.file_name
             )
 

From d4df16bb87aac5b667bed8b5ecdd9f6afd52f20b Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 17 Jun 2022 08:08:05 +0300
Subject: [PATCH 0689/1227] Test resolution values against settings

---
 .../maya/plugins/publish/extract_playblast.py      | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index bb1ecf279d..ce1bb8ae83 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -51,7 +51,21 @@ class ExtractPlayblast(openpype.api.Extractor):
         )
         preset = lib.load_capture_preset(data=self.capture_preset)
 
+        capture_presets = openpype.api.get_current_project_settings()["maya"]["publish"]["ExtractPlayblast"]["capture_preset"] # noqa
+        width_preset = capture_presets["Resolution"]["width"]
+        height_preset = capture_presets["Resolution"]["height"]
         preset['camera'] = camera
+
+        if width_preset == 0:
+            preset['width'] = instance.data.get("resolutionWidth")
+        else:
+            preset["width"] = width_preset
+
+        if height_preset == 0:
+            preset['width'] = instance.data.get("resolutionHeight")
+        else:
+            preset['height'] = height_preset
+
         preset['start_frame'] = start
         preset['end_frame'] = end
         camera_option = preset.get("camera_option", {})

From e9168118d73cb265a4f5597b5d577197b41db4e1 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 17 Jun 2022 10:25:36 +0200
Subject: [PATCH 0690/1227] handle prerender earlier prerender

---
 .../deadline/plugins/publish/submit_publish_job.py   | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index ae4ada709a..6d08e72839 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -722,14 +722,17 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
                 " This may cause issues."
             ).format(source))
 
-        families = ["render"]
+        family = "render"
+        if "prerender" in instance.data["families"]:
+            family = "prerender"
+        families = [family]
 
         # pass review to families if marked as review
         if data.get("review"):
             families.append("review")
 
         instance_skeleton_data = {
-            "family": "render",
+            "family": family,
             "subset": subset,
             "families": families,
             "asset": asset,
@@ -751,11 +754,6 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
             "useSequenceForReview": data.get("useSequenceForReview", True)
         }
 
-        if "prerender" in instance.data["families"]:
-            instance_skeleton_data.update({
-                "family": "prerender",
-                "families": []})
-
         # skip locking version if we are creating v01
         instance_version = instance.data.get("version")  # take this if exists
         if instance_version != 1:

From a1676d5c44de04d880996afc738d245bcd65e66d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 17 Jun 2022 10:58:26 +0200
Subject: [PATCH 0691/1227] create representation variable all the time

---
 .../hosts/nuke/plugins/publish/precollect_writes.py  | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/precollect_writes.py b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
index e050fc8c52..7e50679ed5 100644
--- a/openpype/hosts/nuke/plugins/publish/precollect_writes.py
+++ b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
@@ -72,12 +72,12 @@ class CollectNukeWrites(pyblish.api.InstancePlugin):
             if "representations" not in instance.data:
                 instance.data["representations"] = list()
 
-                representation = {
-                    'name': ext,
-                    'ext': ext,
-                    "stagingDir": output_dir,
-                    "tags": list()
-                }
+            representation = {
+                'name': ext,
+                'ext': ext,
+                "stagingDir": output_dir,
+                "tags": list()
+            }
 
             try:
                 collected_frames = [f for f in os.listdir(output_dir)

From 7c7ae5d3dccefb409870b91ad8ef50097268c815 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 17 Jun 2022 11:38:14 +0200
Subject: [PATCH 0692/1227] Fix Maya 2019 support

`__iter__` is only implemented in Maya 2020+ for Maya Python 2.0 iterators.
---
 openpype/hosts/maya/plugins/publish/collect_instances.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_instances.py b/openpype/hosts/maya/plugins/publish/collect_instances.py
index 433fa9886d..6cc9b9d7e4 100644
--- a/openpype/hosts/maya/plugins/publish/collect_instances.py
+++ b/openpype/hosts/maya/plugins/publish/collect_instances.py
@@ -28,18 +28,18 @@ def get_all_children(nodes):
         dag = sel.getDagPath(0)
 
         iterator.reset(dag)
-        next(iterator)  # ignore self
+        iterator.next()  # ignore self
         while not iterator.isDone():
 
             path = iterator.fullPathName()
 
             if path in traversed:
                 iterator.prune()
-                next(iterator)
+                iterator.next()
                 continue
 
             traversed.add(path)
-            next(iterator)
+            iterator.next()
 
     return list(traversed)
 

From 5b1ab9e7d3694f127eb3457f5e8e2dab767008dd Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 17 Jun 2022 11:52:35 +0200
Subject: [PATCH 0693/1227] Shush hound

---
 openpype/hosts/maya/plugins/publish/collect_instances.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_instances.py b/openpype/hosts/maya/plugins/publish/collect_instances.py
index 6cc9b9d7e4..ad1f794680 100644
--- a/openpype/hosts/maya/plugins/publish/collect_instances.py
+++ b/openpype/hosts/maya/plugins/publish/collect_instances.py
@@ -28,18 +28,19 @@ def get_all_children(nodes):
         dag = sel.getDagPath(0)
 
         iterator.reset(dag)
-        iterator.next()  # ignore self
+        # ignore self
+        iterator.next()  # noqa: B305
         while not iterator.isDone():
 
             path = iterator.fullPathName()
 
             if path in traversed:
                 iterator.prune()
-                iterator.next()
+                iterator.next()  # noqa: B305
                 continue
 
             traversed.add(path)
-            iterator.next()
+            iterator.next()  # noqa: B305
 
     return list(traversed)
 

From b9abbcd61629d5103413399b5048ca5ad2d23545 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 17 Jun 2022 12:11:00 +0200
Subject: [PATCH 0694/1227] fixed extract thumbnail in nuke

---
 .../nuke/plugins/publish/extract_thumbnail.py | 62 +++++++++----------
 1 file changed, 30 insertions(+), 32 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
index 092fc07d6c..a622271855 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
@@ -65,48 +65,46 @@ class ExtractThumbnail(openpype.api.Extractor):
         temporary_nodes = []
 
         # try to connect already rendered images
-        if self.use_rendered:
-            collection = instance.data.get("collection", None)
-            self.log.debug("__ collection: `{}`".format(collection))
+        previous_node = node
+        collection = instance.data.get("collection", None)
+        self.log.debug("__ collection: `{}`".format(collection))
 
-            if collection:
-                # get path
-                fname = os.path.basename(collection.format(
-                    "{head}{padding}{tail}"))
-                fhead = collection.format("{head}")
+        if collection:
+            # get path
+            fname = os.path.basename(collection.format(
+                "{head}{padding}{tail}"))
+            fhead = collection.format("{head}")
 
-                thumb_fname = list(collection)[mid_frame]
-            else:
-                fname = thumb_fname = os.path.basename(
-                    instance.data.get("path", None))
-                fhead = os.path.splitext(fname)[0] + "."
+            thumb_fname = list(collection)[mid_frame]
+        else:
+            fname = thumb_fname = os.path.basename(
+                instance.data.get("path", None))
+            fhead = os.path.splitext(fname)[0] + "."
 
-            self.log.debug("__ fhead: `{}`".format(fhead))
+        self.log.debug("__ fhead: `{}`".format(fhead))
 
-            if "#" in fhead:
-                fhead = fhead.replace("#", "")[:-1]
+        if "#" in fhead:
+            fhead = fhead.replace("#", "")[:-1]
 
-            path_render = os.path.join(
-                staging_dir, thumb_fname).replace("\\", "/")
-            self.log.debug("__ path_render: `{}`".format(path_render))
+        path_render = os.path.join(
+            staging_dir, thumb_fname).replace("\\", "/")
+        self.log.debug("__ path_render: `{}`".format(path_render))
 
+        if self.use_rendered and os.path.isfile(path_render):
             # check if file exist otherwise connect to write node
-            if os.path.isfile(path_render):
-                rnode = nuke.createNode("Read")
+            rnode = nuke.createNode("Read")
 
-                rnode["file"].setValue(path_render)
+            rnode["file"].setValue(path_render)
 
-                # turn it raw if none of baking is ON
-                if all([
-                    not self.bake_viewer_input_process,
-                    not self.bake_viewer_process
-                ]):
-                    rnode["raw"].setValue(True)
+            # turn it raw if none of baking is ON
+            if all([
+                not self.bake_viewer_input_process,
+                not self.bake_viewer_process
+            ]):
+                rnode["raw"].setValue(True)
 
-                temporary_nodes.append(rnode)
-                previous_node = rnode
-            else:
-                previous_node = node
+            temporary_nodes.append(rnode)
+            previous_node = rnode
 
         # bake viewer input look node into thumbnail image
         if self.bake_viewer_input_process:

From d230cb7d49170d71eeaf8b3f201b3e966817132b Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 17 Jun 2022 12:39:44 +0200
Subject: [PATCH 0695/1227] Fix - audio validator for Harmony has wrong logic

Wrong condition stayed after change from asset to raise (it should be negated).
---
 openpype/hosts/harmony/plugins/publish/validate_audio.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/harmony/plugins/publish/validate_audio.py b/openpype/hosts/harmony/plugins/publish/validate_audio.py
index cb6b2307cd..e9b8609803 100644
--- a/openpype/hosts/harmony/plugins/publish/validate_audio.py
+++ b/openpype/hosts/harmony/plugins/publish/validate_audio.py
@@ -47,6 +47,6 @@ class ValidateAudio(pyblish.api.InstancePlugin):
         formatting_data = {
             "audio_url": audio_path
         }
-        if os.path.isfile(audio_path):
+        if not os.path.isfile(audio_path):
             raise PublishXmlValidationError(self, msg,
                                             formatting_data=formatting_data)

From 29def2f2679ca95fa645ef6afe16a1b48bf1b9ad Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 17 Jun 2022 13:17:05 +0200
Subject: [PATCH 0696/1227] fix kwarg key

---
 .../hosts/webpublisher/webserver_service/webpublish_routes.py   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
index b1041bf6cb..457bcd7f93 100644
--- a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
+++ b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
@@ -107,7 +107,7 @@ class HiearchyEndpoint(ResourceRestApiEndpoint):
             "type": 1,
         }
 
-        asset_docs = get_assets(project_name, field=query_projection.keys())
+        asset_docs = get_assets(project_name, fields=query_projection.keys())
         asset_docs_by_id = {
             asset_doc["_id"]: asset_doc
             for asset_doc in asset_docs

From 434e6bf78a8595eeb7c444d72711e547970b1d17 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 17 Jun 2022 13:51:41 +0200
Subject: [PATCH 0697/1227] Fix - added json support to all resources

encode method was missing for WebpublishRestApiResource
---
 .../webserver_service/webpublish_routes.py    | 30 +++++++++++--------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
index 457bcd7f93..4cb3cee8e1 100644
--- a/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
+++ b/openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
@@ -38,18 +38,11 @@ class WebpublishApiEndpoint(ResourceRestApiEndpoint):
         return self.resource.dbcon
 
 
-class RestApiResource:
-    """Resource carrying needed info and Avalon DB connection for publish."""
-    def __init__(self, server_manager, executable, upload_dir,
-                 studio_task_queue=None):
-        self.server_manager = server_manager
-        self.upload_dir = upload_dir
-        self.executable = executable
-
-        if studio_task_queue is None:
-            studio_task_queue = collections.deque().dequeu
-        self.studio_task_queue = studio_task_queue
+class JsonApiResource:
+    """Resource for json manipulation.
 
+    All resources handling sending output to REST should inherit from
+    """
     @staticmethod
     def json_dump_handler(value):
         if isinstance(value, datetime.datetime):
@@ -69,7 +62,20 @@ class RestApiResource:
         ).encode("utf-8")
 
 
-class WebpublishRestApiResource:
+class RestApiResource(JsonApiResource):
+    """Resource carrying needed info and Avalon DB connection for publish."""
+    def __init__(self, server_manager, executable, upload_dir,
+                 studio_task_queue=None):
+        self.server_manager = server_manager
+        self.upload_dir = upload_dir
+        self.executable = executable
+
+        if studio_task_queue is None:
+            studio_task_queue = collections.deque().dequeu
+        self.studio_task_queue = studio_task_queue
+
+
+class WebpublishRestApiResource(JsonApiResource):
     """Resource carrying OP DB connection for storing batch info into DB."""
 
     def __init__(self):

From 0dfe3b69745fc9d9fb94143aa0cc3039640ab669 Mon Sep 17 00:00:00 2001
From: "Allan I. A" <76656700+Allan-I@users.noreply.github.com>
Date: Fri, 17 Jun 2022 15:04:46 +0300
Subject: [PATCH 0698/1227] Update
 openpype/hosts/maya/plugins/publish/extract_playblast.py

Simplify settings capture statement.

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index ce1bb8ae83..9e1970780b 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -51,7 +51,7 @@ class ExtractPlayblast(openpype.api.Extractor):
         )
         preset = lib.load_capture_preset(data=self.capture_preset)
 
-        capture_presets = openpype.api.get_current_project_settings()["maya"]["publish"]["ExtractPlayblast"]["capture_preset"] # noqa
+        capture_presets = self.capture_preset
         width_preset = capture_presets["Resolution"]["width"]
         height_preset = capture_presets["Resolution"]["height"]
         preset['camera'] = camera

From a28f76374e583e6bf5d2f8490a39945a63da418f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 17 Jun 2022 14:33:26 +0200
Subject: [PATCH 0699/1227] use get_openpype_username to fill data for
 templates filling

---
 openpype/lib/avalon_context.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 9d8a92cfe9..c27c5f572e 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -7,7 +7,6 @@ import platform
 import logging
 import collections
 import functools
-import getpass
 
 from bson.objectid import ObjectId
 
@@ -19,6 +18,7 @@ from .anatomy import Anatomy
 from .profiles_filtering import filter_profiles
 from .events import emit_event
 from .path_templates import StringTemplate
+from .local_settings import get_openpype_username
 
 legacy_io = None
 
@@ -550,7 +550,7 @@ def get_workdir_data(project_doc, asset_doc, task_name, host_name):
         "asset": asset_doc["name"],
         "parent": parent_name,
         "app": host_name,
-        "user": getpass.getuser(),
+        "user": get_openpype_username(),
         "hierarchy": hierarchy,
     }
 

From cd90fb603ea3815445b9e181374428c2a5c4a18d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 17 Jun 2022 14:37:38 +0200
Subject: [PATCH 0700/1227] remove unused imports

---
 openpype/plugins/publish/collect_current_pype_user.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/plugins/publish/collect_current_pype_user.py b/openpype/plugins/publish/collect_current_pype_user.py
index 1a52a59012..2d507ba292 100644
--- a/openpype/plugins/publish/collect_current_pype_user.py
+++ b/openpype/plugins/publish/collect_current_pype_user.py
@@ -1,5 +1,3 @@
-import os
-import getpass
 import pyblish.api
 from openpype.lib import get_openpype_username
 

From 1f42006f571343cf832b078d453e6804d68a3cbd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 17 Jun 2022 14:38:03 +0200
Subject: [PATCH 0701/1227] added user key to available template keys

---
 website/docs/admin_settings_project_anatomy.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/website/docs/admin_settings_project_anatomy.md b/website/docs/admin_settings_project_anatomy.md
index 6e0b49f152..106faeb806 100644
--- a/website/docs/admin_settings_project_anatomy.md
+++ b/website/docs/admin_settings_project_anatomy.md
@@ -68,6 +68,7 @@ We have a few required anatomy templates for OpenPype to work properly, however
 | `representation` | Representation name |
 | `frame` | Frame number for sequence files. |
 | `app` | Application Name |
+| `user` | User's login name (can be overridden in local settings) |
 | `output` |  |
 | `comment` |  |
 

From 34a79bfec9bd448986957885eaedfeae9424eab0 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 17 Jun 2022 15:31:51 +0200
Subject: [PATCH 0702/1227] fix showing after plugin hide and don't ignore
 close events

---
 openpype/tools/pyblish_pype/window.py | 89 ++++++++++-----------------
 1 file changed, 34 insertions(+), 55 deletions(-)

diff --git a/openpype/tools/pyblish_pype/window.py b/openpype/tools/pyblish_pype/window.py
index d27ec34345..78590259bc 100644
--- a/openpype/tools/pyblish_pype/window.py
+++ b/openpype/tools/pyblish_pype/window.py
@@ -468,10 +468,8 @@ class Window(QtWidgets.QDialog):
             current_page == "terminal"
         )
 
-        self.state = {
-            "is_closing": False,
-            "current_page": current_page
-        }
+        self._current_page = current_page
+        self._hidden_for_plugin_process = False
 
         self.tabs[current_page].setChecked(True)
 
@@ -590,14 +588,14 @@ class Window(QtWidgets.QDialog):
                 target_page = page
                 if direction is None:
                     direction = -1
-            elif name == self.state["current_page"]:
+            elif name == self._current_page:
                 previous_page = page
                 if direction is None:
                     direction = 1
             else:
                 page.setVisible(False)
 
-        self.state["current_page"] = target
+        self._current_page = target
         self.slide_page(previous_page, target_page, direction)
 
     def slide_page(self, previous_page, target_page, direction):
@@ -684,7 +682,7 @@ class Window(QtWidgets.QDialog):
         comment_visible=None,
         terminal_filters_visibile=None
     ):
-        target = self.state["current_page"]
+        target = self._current_page
         comment_visibility = (
             not self.perspective_widget.isVisible()
             and not target == "terminal"
@@ -845,7 +843,7 @@ class Window(QtWidgets.QDialog):
 
     def apply_log_suspend_value(self, value):
         self._suspend_logs = value
-        if self.state["current_page"] == "terminal":
+        if self._current_page == "terminal":
             self.tabs["overview"].setChecked(True)
 
         self.tabs["terminal"].setVisible(not self._suspend_logs)
@@ -882,9 +880,21 @@ class Window(QtWidgets.QDialog):
         visibility = True
         if hasattr(plugin, "hide_ui_on_process") and plugin.hide_ui_on_process:
             visibility = False
+        self._hidden_for_plugin_process = not visibility
 
-        if self.isVisible() != visibility:
-            self.setVisible(visibility)
+        self._ensure_visible(visibility)
+
+    def _ensure_visible(self, visible):
+        if self.isVisible() == visible:
+            return
+
+        if not visible:
+            self.setVisible(visible)
+        else:
+            self.show()
+            self.raise_()
+            self.activateWindow()
+            self.showNormal()
 
     def on_plugin_action_menu_requested(self, pos):
         """The user right-clicked on a plug-in
@@ -955,7 +965,7 @@ class Window(QtWidgets.QDialog):
         self.intent_box.setEnabled(True)
 
         # Refresh tab
-        self.on_tab_changed(self.state["current_page"])
+        self.on_tab_changed(self._current_page)
         self.update_compatibility()
 
         self.button_suspend_logs.setEnabled(False)
@@ -1027,8 +1037,9 @@ class Window(QtWidgets.QDialog):
 
         self._update_state()
 
-        if not self.isVisible():
-            self.setVisible(True)
+        if self._hidden_for_plugin_process:
+            self._hidden_for_plugin_process = False
+            self._ensure_visible(True)
 
     def on_was_skipped(self, plugin):
         plugin_item = self.plugin_model.plugin_items[plugin.id]
@@ -1103,8 +1114,9 @@ class Window(QtWidgets.QDialog):
                 plugin_item, instance_item
             )
 
-        if not self.isVisible():
-            self.setVisible(True)
+        if self._hidden_for_plugin_process:
+            self._hidden_for_plugin_process = False
+            self._ensure_visible(True)
 
     # -------------------------------------------------------------------------
     #
@@ -1223,53 +1235,20 @@ class Window(QtWidgets.QDialog):
 
         """
 
-        # Make it snappy, but take care to clean it all up.
-        # TODO(marcus): Enable GUI to return on problem, such
-        # as asking whether or not the user really wants to quit
-        # given there are things currently running.
-        self.hide()
+        self.info(self.tr("Closing.."))
 
-        if self.state["is_closing"]:
+        if self.controller.is_running:
+            self.info(self.tr("..as soon as processing is finished.."))
+            self.controller.stop()
 
-            # Explicitly clear potentially referenced data
-            self.info(self.tr("Cleaning up models.."))
-            self.intent_model.deleteLater()
-            self.plugin_model.deleteLater()
-            self.terminal_model.deleteLater()
-            self.terminal_proxy.deleteLater()
-            self.plugin_proxy.deleteLater()
+            self.info(self.tr("Cleaning up controller.."))
+            self.controller.cleanup()
 
             self.overview_instance_view.setModel(None)
             self.overview_plugin_view.setModel(None)
             self.terminal_view.setModel(None)
 
-            self.info(self.tr("Cleaning up controller.."))
-            self.controller.cleanup()
-
-            self.info(self.tr("All clean!"))
-            self.info(self.tr("Good bye"))
-            return super(Window, self).closeEvent(event)
-
-        self.info(self.tr("Closing.."))
-
-        def on_problem():
-            self.heads_up(
-                "Warning", "Had trouble closing down. "
-                "Please tell someone and try again."
-            )
-            self.show()
-
-        if self.controller.is_running:
-            self.info(self.tr("..as soon as processing is finished.."))
-            self.controller.stop()
-            self.finished.connect(self.close)
-            util.defer(200, on_problem)
-            return event.ignore()
-
-        self.state["is_closing"] = True
-
-        util.defer(200, self.close)
-        return event.ignore()
+        event.accept()
 
     def reject(self):
         """Handle ESC key"""

From e54073608b59c4fe814a0fa3a1e49faef8e5a551 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 17 Jun 2022 15:48:28 +0200
Subject: [PATCH 0703/1227] Nuke: multiple bake stream correct frame range on
 farm

---
 .../plugins/publish/submit_nuke_deadline.py   | 70 ++++++++++++-------
 1 file changed, 44 insertions(+), 26 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py b/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
index ca68c87f9a..93fb511a34 100644
--- a/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
@@ -55,8 +55,8 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin):
         self._ver = re.search(r"\d+\.\d+", context.data.get("hostVersion"))
         self._deadline_user = context.data.get(
             "deadlineUser", getpass.getuser())
-        self._frame_start = int(instance.data["frameStartHandle"])
-        self._frame_end = int(instance.data["frameEndHandle"])
+        submit_frame_start = int(instance.data["frameStartHandle"])
+        submit_frame_end = int(instance.data["frameEndHandle"])
 
         # get output path
         render_path = instance.data['path']
@@ -82,13 +82,16 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin):
 
         # exception for slate workflow
         if "slate" in instance.data["families"]:
-            self._frame_start -= 1
+            submit_frame_start -= 1
 
-        response = self.payload_submit(instance,
-                                       script_path,
-                                       render_path,
-                                       node.name()
-                                       )
+        response = self.payload_submit(
+            instance,
+            script_path,
+            render_path,
+            node.name(),
+            submit_frame_start,
+            submit_frame_end
+        )
         # Store output dir for unified publisher (filesequence)
         instance.data["deadlineSubmissionJob"] = response.json()
         instance.data["outputDir"] = os.path.dirname(
@@ -96,20 +99,22 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin):
         instance.data["publishJobState"] = "Suspended"
 
         if instance.data.get("bakingNukeScripts"):
+            # exception for slate workflow
+            if "slate" in instance.data["families"]:
+                submit_frame_start += 1
+
             for baking_script in instance.data["bakingNukeScripts"]:
                 render_path = baking_script["bakeRenderPath"]
                 script_path = baking_script["bakeScriptPath"]
                 exe_node_name = baking_script["bakeWriteNodeName"]
 
-                # exception for slate workflow
-                if "slate" in instance.data["families"]:
-                    self._frame_start += 1
-
                 resp = self.payload_submit(
                     instance,
                     script_path,
                     render_path,
                     exe_node_name,
+                    submit_frame_start,
+                    submit_frame_end,
                     response.json()
                 )
 
@@ -126,13 +131,16 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin):
             families.insert(0, "prerender")
         instance.data["families"] = families
 
-    def payload_submit(self,
-                       instance,
-                       script_path,
-                       render_path,
-                       exe_node_name,
-                       responce_data=None
-                       ):
+    def payload_submit(
+        self,
+        instance,
+        script_path,
+        render_path,
+        exe_node_name,
+        start_frame,
+        end_frame,
+        responce_data=None
+    ):
         render_dir = os.path.normpath(os.path.dirname(render_path))
         script_name = os.path.basename(script_path)
         jobname = "%s - %s" % (script_name, instance.name)
@@ -192,8 +200,8 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin):
 
                 "Plugin": "Nuke",
                 "Frames": "{start}-{end}".format(
-                    start=self._frame_start,
-                    end=self._frame_end
+                    start=start_frame,
+                    end=end_frame
                 ),
                 "Comment": self._comment,
 
@@ -293,7 +301,13 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin):
         self.log.info(json.dumps(payload, indent=4, sort_keys=True))
 
         # adding expectied files to instance.data
-        self.expected_files(instance, render_path)
+        self.expected_files(
+            instance,
+            render_path,
+            start_frame,
+            end_frame
+        )
+
         self.log.debug("__ expectedFiles: `{}`".format(
             instance.data["expectedFiles"]))
         response = requests.post(self.deadline_url, json=payload, timeout=10)
@@ -339,9 +353,13 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin):
             self.log.debug("_ path: `{}`".format(path))
         return path
 
-    def expected_files(self,
-                       instance,
-                       path):
+    def expected_files(
+        self,
+        instance,
+        path,
+        start_frame,
+        end_frame
+    ):
         """ Create expected files in instance data
         """
         if not instance.data.get("expectedFiles"):
@@ -359,7 +377,7 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin):
             instance.data["expectedFiles"].append(path)
             return
 
-        for i in range(self._frame_start, (self._frame_end + 1)):
+        for i in range(start_frame, (end_frame + 1)):
             instance.data["expectedFiles"].append(
                 os.path.join(dir, (file % i)).replace("\\", "/"))
 

From bd01ee948cb93414be4e8ef5657bb65491d936df Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 17 Jun 2022 16:09:34 +0200
Subject: [PATCH 0704/1227] OP-2448 - added support for single frame playblast
 review

Before clique.assemble returns empty collections
---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 3 ++-
 openpype/plugins/publish/extract_review.py               | 7 ++++---
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index bb1ecf279d..3e8655be7d 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -111,7 +111,8 @@ class ExtractPlayblast(openpype.api.Extractor):
         self.log.debug("playblast path  {}".format(path))
 
         collected_files = os.listdir(stagingdir)
-        collections, remainder = clique.assemble(collected_files)
+        collections, remainder = clique.assemble(collected_files,
+                                                 minimum_items=1)
 
         self.log.debug("filename {}".format(filename))
         frame_collection = None
diff --git a/openpype/plugins/publish/extract_review.py b/openpype/plugins/publish/extract_review.py
index 879125dac3..de9e3926bd 100644
--- a/openpype/plugins/publish/extract_review.py
+++ b/openpype/plugins/publish/extract_review.py
@@ -762,8 +762,9 @@ class ExtractReview(pyblish.api.InstancePlugin):
         """
         start_frame = int(start_frame)
         end_frame = int(end_frame)
-        collections = clique.assemble(files)[0]
-        assert len(collections) == 1, "Multiple collections found."
+        collections = clique.assemble(files, minimum_items=1)[0]
+        msg = "Multiple collections {} found.".format(collections)
+        assert len(collections) == 1, msg
         col = collections[0]
 
         # do nothing if no gap is found in input range
@@ -845,7 +846,7 @@ class ExtractReview(pyblish.api.InstancePlugin):
         dst_staging_dir = new_repre["stagingDir"]
 
         if temp_data["input_is_sequence"]:
-            collections = clique.assemble(repre["files"])[0]
+            collections = clique.assemble(repre["files"], minimum_items=1)[0]
             full_input_path = os.path.join(
                 src_staging_dir,
                 collections[0].format("{head}{padding}{tail}")

From 285bfdf57e25bc4784633fb31caffb1b5962a381 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 17 Jun 2022 16:41:10 +0200
Subject: [PATCH 0705/1227] OP-2448 - revert changes with minimum_review

This solution might be too dangerous and have unforeseeable consequences.
---
 openpype/plugins/publish/extract_review.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_review.py b/openpype/plugins/publish/extract_review.py
index de9e3926bd..b6e5fee1fe 100644
--- a/openpype/plugins/publish/extract_review.py
+++ b/openpype/plugins/publish/extract_review.py
@@ -762,7 +762,7 @@ class ExtractReview(pyblish.api.InstancePlugin):
         """
         start_frame = int(start_frame)
         end_frame = int(end_frame)
-        collections = clique.assemble(files, minimum_items=1)[0]
+        collections = clique.assemble(files)[0]
         msg = "Multiple collections {} found.".format(collections)
         assert len(collections) == 1, msg
         col = collections[0]
@@ -846,7 +846,7 @@ class ExtractReview(pyblish.api.InstancePlugin):
         dst_staging_dir = new_repre["stagingDir"]
 
         if temp_data["input_is_sequence"]:
-            collections = clique.assemble(repre["files"], minimum_items=1)[0]
+            collections = clique.assemble(repre["files"])[0]
             full_input_path = os.path.join(
                 src_staging_dir,
                 collections[0].format("{head}{padding}{tail}")

From fc93785ef22f3fea1226a47a37e0a6404e9c61c3 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 17 Jun 2022 16:46:14 +0200
Subject: [PATCH 0706/1227] OP-2448 - safer variant of passing collected files

Later process doesn't handle well single frame file in a list, it should be always as a regular string.
---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 3e8655be7d..ba939d5428 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -135,10 +135,15 @@ class ExtractPlayblast(openpype.api.Extractor):
         # Add camera node name to representation data
         camera_node_name = pm.ls(camera)[0].getTransform().name()
 
+        collected_files = list(frame_collection)
+        # single frame file shouldn't be in list, only as a string
+        if len(collected_files) == 1:
+            collected_files = collected_files[0]
+
         representation = {
             'name': 'png',
             'ext': 'png',
-            'files': list(frame_collection),
+            'files': collected_files,
             "stagingDir": stagingdir,
             "frameStart": start,
             "frameEnd": end,

From c368fb587f6bc89668ce07024154768f6de2ef7d Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Fri, 17 Jun 2022 15:29:09 +0000
Subject: [PATCH 0707/1227] [Automated] Bump version

---
 CHANGELOG.md        | 33 +++++----------------------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 7 insertions(+), 30 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index eb71071205..8f9eb04f45 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## [3.11.0-nightly.3](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.11.0-nightly.4](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.10.0...HEAD)
 
@@ -22,11 +22,7 @@
 - General: Updated windows oiio tool [\#3268](https://github.com/pypeclub/OpenPype/pull/3268)
 - Unreal: add support for skeletalMesh and staticMesh to loaders [\#3267](https://github.com/pypeclub/OpenPype/pull/3267)
 - Maya: reference loaders could store placeholder in referenced url [\#3264](https://github.com/pypeclub/OpenPype/pull/3264)
-- Maya: FBX camera export [\#3253](https://github.com/pypeclub/OpenPype/pull/3253)
-- TVPaint: Init file for TVPaint worker also handle guideline images [\#3250](https://github.com/pypeclub/OpenPype/pull/3250)
 - Nuke: Change default icon path in settings [\#3247](https://github.com/pypeclub/OpenPype/pull/3247)
-- Maya: publishing of animation and pointcache on a farm [\#3225](https://github.com/pypeclub/OpenPype/pull/3225)
-- Maya: Look assigner UI improvements [\#3208](https://github.com/pypeclub/OpenPype/pull/3208)
 
 **🐛 Bug fixes**
 
@@ -43,13 +39,13 @@
 - Webpublisher: return only active projects in ProjectsEndpoint [\#3281](https://github.com/pypeclub/OpenPype/pull/3281)
 - Hiero: add support for task tags 3.10.x [\#3279](https://github.com/pypeclub/OpenPype/pull/3279)
 - General: Fix Oiio tool path resolving [\#3278](https://github.com/pypeclub/OpenPype/pull/3278)
+- Maya: Fix udim support for e.g. uppercase \<UDIM\> tag [\#3266](https://github.com/pypeclub/OpenPype/pull/3266)
 - Nuke: bake reformat was failing on string type [\#3261](https://github.com/pypeclub/OpenPype/pull/3261)
 - Maya: hotfix Pxr multitexture in looks [\#3260](https://github.com/pypeclub/OpenPype/pull/3260)
+- Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
 - Unreal: Fixed Animation loading in UE5 [\#3240](https://github.com/pypeclub/OpenPype/pull/3240)
 - Unreal: Fixed Render creation in UE5 [\#3239](https://github.com/pypeclub/OpenPype/pull/3239)
 - Unreal: Fixed Camera loading in UE5 [\#3238](https://github.com/pypeclub/OpenPype/pull/3238)
-- TVPaint: Look for more groups than 12 [\#3228](https://github.com/pypeclub/OpenPype/pull/3228)
-- Flame: debugging [\#3224](https://github.com/pypeclub/OpenPype/pull/3224)
 
 **🔀 Refactored code**
 
@@ -60,7 +56,6 @@
 
 - Maya: add pointcache family to gpu cache loader [\#3318](https://github.com/pypeclub/OpenPype/pull/3318)
 - Maya look: skip empty file attributes [\#3274](https://github.com/pypeclub/OpenPype/pull/3274)
-- Harmony: message length in 21.1 [\#3258](https://github.com/pypeclub/OpenPype/pull/3258)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
@@ -68,46 +63,28 @@
 
 **🚀 Enhancements**
 
-- TVPaint: Init file for TVPaint worker also handle guideline images [\#3251](https://github.com/pypeclub/OpenPype/pull/3251)
+- Maya: FBX camera export [\#3253](https://github.com/pypeclub/OpenPype/pull/3253)
 - General: updating common vendor `scriptmenu` to 1.5.2 [\#3246](https://github.com/pypeclub/OpenPype/pull/3246)
 - Project Manager: Allow to paste Tasks into multiple assets at the same time [\#3226](https://github.com/pypeclub/OpenPype/pull/3226)
-- Project manager: Sped up project load [\#3216](https://github.com/pypeclub/OpenPype/pull/3216)
 
 **🐛 Bug fixes**
 
-- Maya: Fix udim support for e.g. uppercase \<UDIM\> tag [\#3266](https://github.com/pypeclub/OpenPype/pull/3266)
-- Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
 - nuke: use framerange issue [\#3254](https://github.com/pypeclub/OpenPype/pull/3254)
 - Ftrack: Chunk sizes for queries has minimal condition [\#3244](https://github.com/pypeclub/OpenPype/pull/3244)
 - Maya: renderman displays needs to be filtered [\#3242](https://github.com/pypeclub/OpenPype/pull/3242)
 - Ftrack: Validate that the user exists on ftrack [\#3237](https://github.com/pypeclub/OpenPype/pull/3237)
 - Maya: Fix support for multiple resolutions [\#3236](https://github.com/pypeclub/OpenPype/pull/3236)
-- Hiero: debugging frame range and other 3.10 [\#3222](https://github.com/pypeclub/OpenPype/pull/3222)
-- Project Manager: Fix persistent editors on project change [\#3218](https://github.com/pypeclub/OpenPype/pull/3218)
-- Deadline: instance data overwrite fix [\#3214](https://github.com/pypeclub/OpenPype/pull/3214)
-- Ftrack: Push hierarchical attributes action works [\#3210](https://github.com/pypeclub/OpenPype/pull/3210)
-- Standalone Publisher: Always create new representation for thumbnail [\#3203](https://github.com/pypeclub/OpenPype/pull/3203)
-- Photoshop: skip collector when automatic testing [\#3202](https://github.com/pypeclub/OpenPype/pull/3202)
+- TVPaint: Look for more groups than 12 [\#3228](https://github.com/pypeclub/OpenPype/pull/3228)
 
 **Merged pull requests:**
 
 - Harmony: message length in 21.1 [\#3257](https://github.com/pypeclub/OpenPype/pull/3257)
 - Harmony: 21.1 fix [\#3249](https://github.com/pypeclub/OpenPype/pull/3249)
-- Maya: added jpg to filter for Image Plane Loader [\#3223](https://github.com/pypeclub/OpenPype/pull/3223)
 
 ## [3.9.8](https://github.com/pypeclub/OpenPype/tree/3.9.8) (2022-05-19)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.9.7...3.9.8)
 
-**🚀 Enhancements**
-
-- nuke: generate publishing nodes inside render group node  [\#3206](https://github.com/pypeclub/OpenPype/pull/3206)
-- Loader UI: Speed issues of loader with sync server [\#3200](https://github.com/pypeclub/OpenPype/pull/3200)
-
-**🐛 Bug fixes**
-
-- Standalone Publisher: Always create new representation for thumbnail [\#3204](https://github.com/pypeclub/OpenPype/pull/3204)
-
 ## [3.9.7](https://github.com/pypeclub/OpenPype/tree/3.9.7) (2022-05-11)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.9.6...3.9.7)
diff --git a/openpype/version.py b/openpype/version.py
index 2f4d180983..4c28b4a369 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.11.0-nightly.3"
+__version__ = "3.11.0-nightly.4"
diff --git a/pyproject.toml b/pyproject.toml
index e1b5c37289..99935b3d70 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.11.0-nightly.3" # OpenPype
+version = "3.11.0-nightly.4" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 961c7b6c511765684696c6b5292e85193e24f31e Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Fri, 17 Jun 2022 15:39:35 +0000
Subject: [PATCH 0708/1227] [Automated] Release

---
 CHANGELOG.md        | 10 ++++++----
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8f9eb04f45..686b34177c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,8 @@
 # Changelog
 
-## [3.11.0-nightly.4](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.11.0](https://github.com/pypeclub/OpenPype/tree/3.11.0) (2022-06-17)
 
-[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.10.0...HEAD)
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.10.0...3.11.0)
 
 ### 📖 Documentation
 
@@ -22,6 +22,7 @@
 - General: Updated windows oiio tool [\#3268](https://github.com/pypeclub/OpenPype/pull/3268)
 - Unreal: add support for skeletalMesh and staticMesh to loaders [\#3267](https://github.com/pypeclub/OpenPype/pull/3267)
 - Maya: reference loaders could store placeholder in referenced url [\#3264](https://github.com/pypeclub/OpenPype/pull/3264)
+- TVPaint: Init file for TVPaint worker also handle guideline images [\#3250](https://github.com/pypeclub/OpenPype/pull/3250)
 - Nuke: Change default icon path in settings [\#3247](https://github.com/pypeclub/OpenPype/pull/3247)
 
 **🐛 Bug fixes**
@@ -39,10 +40,12 @@
 - Webpublisher: return only active projects in ProjectsEndpoint [\#3281](https://github.com/pypeclub/OpenPype/pull/3281)
 - Hiero: add support for task tags 3.10.x [\#3279](https://github.com/pypeclub/OpenPype/pull/3279)
 - General: Fix Oiio tool path resolving [\#3278](https://github.com/pypeclub/OpenPype/pull/3278)
+- Hiero: add support for task tags [\#3277](https://github.com/pypeclub/OpenPype/pull/3277)
 - Maya: Fix udim support for e.g. uppercase \<UDIM\> tag [\#3266](https://github.com/pypeclub/OpenPype/pull/3266)
 - Nuke: bake reformat was failing on string type [\#3261](https://github.com/pypeclub/OpenPype/pull/3261)
 - Maya: hotfix Pxr multitexture in looks [\#3260](https://github.com/pypeclub/OpenPype/pull/3260)
 - Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
+- nuke: use framerange issue [\#3254](https://github.com/pypeclub/OpenPype/pull/3254)
 - Unreal: Fixed Animation loading in UE5 [\#3240](https://github.com/pypeclub/OpenPype/pull/3240)
 - Unreal: Fixed Render creation in UE5 [\#3239](https://github.com/pypeclub/OpenPype/pull/3239)
 - Unreal: Fixed Camera loading in UE5 [\#3238](https://github.com/pypeclub/OpenPype/pull/3238)
@@ -56,6 +59,7 @@
 
 - Maya: add pointcache family to gpu cache loader [\#3318](https://github.com/pypeclub/OpenPype/pull/3318)
 - Maya look: skip empty file attributes [\#3274](https://github.com/pypeclub/OpenPype/pull/3274)
+- Harmony: message length in 21.1 [\#3257](https://github.com/pypeclub/OpenPype/pull/3257)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
@@ -69,7 +73,6 @@
 
 **🐛 Bug fixes**
 
-- nuke: use framerange issue [\#3254](https://github.com/pypeclub/OpenPype/pull/3254)
 - Ftrack: Chunk sizes for queries has minimal condition [\#3244](https://github.com/pypeclub/OpenPype/pull/3244)
 - Maya: renderman displays needs to be filtered [\#3242](https://github.com/pypeclub/OpenPype/pull/3242)
 - Ftrack: Validate that the user exists on ftrack [\#3237](https://github.com/pypeclub/OpenPype/pull/3237)
@@ -78,7 +81,6 @@
 
 **Merged pull requests:**
 
-- Harmony: message length in 21.1 [\#3257](https://github.com/pypeclub/OpenPype/pull/3257)
 - Harmony: 21.1 fix [\#3249](https://github.com/pypeclub/OpenPype/pull/3249)
 
 ## [3.9.8](https://github.com/pypeclub/OpenPype/tree/3.9.8) (2022-05-19)
diff --git a/openpype/version.py b/openpype/version.py
index 4c28b4a369..41e61b0500 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.11.0-nightly.4"
+__version__ = "3.11.0"
diff --git a/pyproject.toml b/pyproject.toml
index 99935b3d70..2700704530 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.11.0-nightly.4" # OpenPype
+version = "3.11.0" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From d1b0c37c93c5a8c8dfd105d6cae8bc61e074be15 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 17 Jun 2022 18:48:08 +0300
Subject: [PATCH 0709/1227] Add resolution overrides to creator.

---
 openpype/hosts/maya/plugins/create/create_review.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/hosts/maya/plugins/create/create_review.py b/openpype/hosts/maya/plugins/create/create_review.py
index fbf3399f61..331f0818eb 100644
--- a/openpype/hosts/maya/plugins/create/create_review.py
+++ b/openpype/hosts/maya/plugins/create/create_review.py
@@ -15,6 +15,8 @@ class CreateReview(plugin.Creator):
     keepImages = False
     isolate = False
     imagePlane = True
+    resolutionWidth = 0
+    resolutionHeight = 0
     transparency = [
         "preset",
         "simple",
@@ -33,6 +35,8 @@ class CreateReview(plugin.Creator):
         for key, value in animation_data.items():
             data[key] = value
 
+        data["resolutionWidth"] = self.resolutionWidth
+        data["resolutionHeight"] = self.resolutionHeight
         data["isolate"] = self.isolate
         data["keepImages"] = self.keepImages
         data["imagePlane"] = self.imagePlane

From eb3afe63c53df0969b2717a353f8320c9d69aa0a Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 17 Jun 2022 18:48:23 +0300
Subject: [PATCH 0710/1227] Add resolution overrides to collector.

---
 openpype/hosts/maya/plugins/publish/collect_review.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/collect_review.py b/openpype/hosts/maya/plugins/publish/collect_review.py
index e9e0d74c03..ded549a849 100644
--- a/openpype/hosts/maya/plugins/publish/collect_review.py
+++ b/openpype/hosts/maya/plugins/publish/collect_review.py
@@ -70,6 +70,8 @@ class CollectReview(pyblish.api.InstancePlugin):
                 data['handles'] = instance.data.get('handles', None)
                 data['step'] = instance.data['step']
                 data['fps'] = instance.data['fps']
+                data['resolutionWidth'] = instance.data['resolutionWidth']
+                data['resolutionHeight'] = instance.data['resolutionHeight']
                 data["isolate"] = instance.data["isolate"]
                 cmds.setAttr(str(instance) + '.active', 1)
                 self.log.debug('data {}'.format(instance.context[i].data))

From 491e356bc654352f11feb4609f97071e4a651645 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 17 Jun 2022 18:48:39 +0300
Subject: [PATCH 0711/1227] Correct resolution overrides in extractor

---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 9e1970780b..9e6363502e 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -54,15 +54,17 @@ class ExtractPlayblast(openpype.api.Extractor):
         capture_presets = self.capture_preset
         width_preset = capture_presets["Resolution"]["width"]
         height_preset = capture_presets["Resolution"]["height"]
+        instance_width = instance.data.get("resolutionWidth")
+        instance_height = instance.data.get("resolutionHeight")
         preset['camera'] = camera
 
-        if width_preset == 0:
+        if instance_width != 0:
             preset['width'] = instance.data.get("resolutionWidth")
         else:
             preset["width"] = width_preset
 
-        if height_preset == 0:
-            preset['width'] = instance.data.get("resolutionHeight")
+        if instance_height != 0:
+            preset['height'] = instance.data.get("resolutionHeight")
         else:
             preset['height'] = height_preset
 

From 594707f8340ea3b9cbc9ac4df6193a1e3dc95a76 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Sat, 18 Jun 2022 00:34:25 +0300
Subject: [PATCH 0712/1227] Add comments

---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 9e6363502e..32cbeed81b 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -50,14 +50,20 @@ class ExtractPlayblast(openpype.api.Extractor):
                                ['override_viewport_options']
         )
         preset = lib.load_capture_preset(data=self.capture_preset)
-
+        # Grab capture presets from the project settings
         capture_presets = self.capture_preset
+        # Set resolution variables from capture presets
         width_preset = capture_presets["Resolution"]["width"]
         height_preset = capture_presets["Resolution"]["height"]
+        # Set resolution variables from instance values
         instance_width = instance.data.get("resolutionWidth")
         instance_height = instance.data.get("resolutionHeight")
         preset['camera'] = camera
 
+        # Tests if instance resolution width is set,
+        # if it is a value other than zero, that value is
+        # used, if not then the project settings resolution is
+        # used
         if instance_width != 0:
             preset['width'] = instance.data.get("resolutionWidth")
         else:

From 44a46382470e4e79b9e679e9395f94dacb556a70 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Sat, 18 Jun 2022 03:45:44 +0000
Subject: [PATCH 0713/1227] [Automated] Bump version

---
 CHANGELOG.md        | 44 ++++++++++++++++++++++++++++++++++++++------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 40 insertions(+), 8 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 686b34177c..553102aecf 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,43 @@
 # Changelog
 
+## [3.11.1-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.11.0...HEAD)
+
+**🆕 New features**
+
+- Flame: custom export temp folder [\#3346](https://github.com/pypeclub/OpenPype/pull/3346)
+- Nuke: removing third-party plugins   [\#3344](https://github.com/pypeclub/OpenPype/pull/3344)
+
+**🚀 Enhancements**
+
+- Pyblish Pype: Hiding/Close issues [\#3367](https://github.com/pypeclub/OpenPype/pull/3367)
+- Ftrack: Removed requirement of pypeclub role from default settings [\#3354](https://github.com/pypeclub/OpenPype/pull/3354)
+- Kitsu: Prevent crash on missing frames information [\#3352](https://github.com/pypeclub/OpenPype/pull/3352)
+- Ftrack: Open browser from tray [\#3320](https://github.com/pypeclub/OpenPype/pull/3320)
+- Enhancement: More control over thumbnail processing. [\#3259](https://github.com/pypeclub/OpenPype/pull/3259)
+
+**🐛 Bug fixes**
+
+- Nuke: bake streams with slate on farm [\#3368](https://github.com/pypeclub/OpenPype/pull/3368)
+- Harmony: audio validator has wrong logic [\#3364](https://github.com/pypeclub/OpenPype/pull/3364)
+- Nuke: Fix missing variable in extract thumbnail [\#3363](https://github.com/pypeclub/OpenPype/pull/3363)
+- Nuke: Fix precollect writes [\#3361](https://github.com/pypeclub/OpenPype/pull/3361)
+- AE- fix validate\_scene\_settings and renderLocal [\#3358](https://github.com/pypeclub/OpenPype/pull/3358)
+- deadline: fixing misidentification of revieables [\#3356](https://github.com/pypeclub/OpenPype/pull/3356)
+- General: Create only one thumbnail per instance [\#3351](https://github.com/pypeclub/OpenPype/pull/3351)
+- nuke: adding extract thumbnail settings 3.10 [\#3347](https://github.com/pypeclub/OpenPype/pull/3347)
+- General: Fix last version function [\#3345](https://github.com/pypeclub/OpenPype/pull/3345)
+- Deadline: added OPENPYPE\_MONGO to filter [\#3336](https://github.com/pypeclub/OpenPype/pull/3336)
+- Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
+
+**🔀 Refactored code**
+
+- Webpublisher: Use client query functions [\#3333](https://github.com/pypeclub/OpenPype/pull/3333)
+
 ## [3.11.0](https://github.com/pypeclub/OpenPype/tree/3.11.0) (2022-06-17)
 
-[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.10.0...3.11.0)
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.11.0-nightly.4...3.11.0)
 
 ### 📖 Documentation
 
@@ -40,15 +75,12 @@
 - Webpublisher: return only active projects in ProjectsEndpoint [\#3281](https://github.com/pypeclub/OpenPype/pull/3281)
 - Hiero: add support for task tags 3.10.x [\#3279](https://github.com/pypeclub/OpenPype/pull/3279)
 - General: Fix Oiio tool path resolving [\#3278](https://github.com/pypeclub/OpenPype/pull/3278)
-- Hiero: add support for task tags [\#3277](https://github.com/pypeclub/OpenPype/pull/3277)
 - Maya: Fix udim support for e.g. uppercase \<UDIM\> tag [\#3266](https://github.com/pypeclub/OpenPype/pull/3266)
 - Nuke: bake reformat was failing on string type [\#3261](https://github.com/pypeclub/OpenPype/pull/3261)
 - Maya: hotfix Pxr multitexture in looks [\#3260](https://github.com/pypeclub/OpenPype/pull/3260)
 - Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
-- nuke: use framerange issue [\#3254](https://github.com/pypeclub/OpenPype/pull/3254)
 - Unreal: Fixed Animation loading in UE5 [\#3240](https://github.com/pypeclub/OpenPype/pull/3240)
 - Unreal: Fixed Render creation in UE5 [\#3239](https://github.com/pypeclub/OpenPype/pull/3239)
-- Unreal: Fixed Camera loading in UE5 [\#3238](https://github.com/pypeclub/OpenPype/pull/3238)
 
 **🔀 Refactored code**
 
@@ -59,7 +91,6 @@
 
 - Maya: add pointcache family to gpu cache loader [\#3318](https://github.com/pypeclub/OpenPype/pull/3318)
 - Maya look: skip empty file attributes [\#3274](https://github.com/pypeclub/OpenPype/pull/3274)
-- Harmony: message length in 21.1 [\#3257](https://github.com/pypeclub/OpenPype/pull/3257)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
@@ -69,10 +100,10 @@
 
 - Maya: FBX camera export [\#3253](https://github.com/pypeclub/OpenPype/pull/3253)
 - General: updating common vendor `scriptmenu` to 1.5.2 [\#3246](https://github.com/pypeclub/OpenPype/pull/3246)
-- Project Manager: Allow to paste Tasks into multiple assets at the same time [\#3226](https://github.com/pypeclub/OpenPype/pull/3226)
 
 **🐛 Bug fixes**
 
+- nuke: use framerange issue [\#3254](https://github.com/pypeclub/OpenPype/pull/3254)
 - Ftrack: Chunk sizes for queries has minimal condition [\#3244](https://github.com/pypeclub/OpenPype/pull/3244)
 - Maya: renderman displays needs to be filtered [\#3242](https://github.com/pypeclub/OpenPype/pull/3242)
 - Ftrack: Validate that the user exists on ftrack [\#3237](https://github.com/pypeclub/OpenPype/pull/3237)
@@ -81,6 +112,7 @@
 
 **Merged pull requests:**
 
+- Harmony: message length in 21.1 [\#3257](https://github.com/pypeclub/OpenPype/pull/3257)
 - Harmony: 21.1 fix [\#3249](https://github.com/pypeclub/OpenPype/pull/3249)
 
 ## [3.9.8](https://github.com/pypeclub/OpenPype/tree/3.9.8) (2022-05-19)
diff --git a/openpype/version.py b/openpype/version.py
index 41e61b0500..8e44b02ffc 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.11.0"
+__version__ = "3.11.1-nightly.1"
diff --git a/pyproject.toml b/pyproject.toml
index 2700704530..8ba829a1c9 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.11.0" # OpenPype
+version = "3.11.1-nightly.1" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From da1fb174bca44ec40ce00ea51b034d79bcebcca9 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Mon, 20 Jun 2022 08:48:15 +0000
Subject: [PATCH 0714/1227] [Automated] Release

---
 CHANGELOG.md        | 7 +++----
 openpype/version.py | 2 +-
 pyproject.toml      | 2 +-
 3 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 553102aecf..48d0d8181e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,8 @@
 # Changelog
 
-## [3.11.1-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.11.1](https://github.com/pypeclub/OpenPype/tree/3.11.1) (2022-06-20)
 
-[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.11.0...HEAD)
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.11.0...3.11.1)
 
 **🆕 New features**
 
@@ -26,7 +26,6 @@
 - AE- fix validate\_scene\_settings and renderLocal [\#3358](https://github.com/pypeclub/OpenPype/pull/3358)
 - deadline: fixing misidentification of revieables [\#3356](https://github.com/pypeclub/OpenPype/pull/3356)
 - General: Create only one thumbnail per instance [\#3351](https://github.com/pypeclub/OpenPype/pull/3351)
-- nuke: adding extract thumbnail settings 3.10 [\#3347](https://github.com/pypeclub/OpenPype/pull/3347)
 - General: Fix last version function [\#3345](https://github.com/pypeclub/OpenPype/pull/3345)
 - Deadline: added OPENPYPE\_MONGO to filter [\#3336](https://github.com/pypeclub/OpenPype/pull/3336)
 - Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
@@ -91,6 +90,7 @@
 
 - Maya: add pointcache family to gpu cache loader [\#3318](https://github.com/pypeclub/OpenPype/pull/3318)
 - Maya look: skip empty file attributes [\#3274](https://github.com/pypeclub/OpenPype/pull/3274)
+- Harmony: 21.1 fix [\#3248](https://github.com/pypeclub/OpenPype/pull/3248)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
@@ -108,7 +108,6 @@
 - Maya: renderman displays needs to be filtered [\#3242](https://github.com/pypeclub/OpenPype/pull/3242)
 - Ftrack: Validate that the user exists on ftrack [\#3237](https://github.com/pypeclub/OpenPype/pull/3237)
 - Maya: Fix support for multiple resolutions [\#3236](https://github.com/pypeclub/OpenPype/pull/3236)
-- TVPaint: Look for more groups than 12 [\#3228](https://github.com/pypeclub/OpenPype/pull/3228)
 
 **Merged pull requests:**
 
diff --git a/openpype/version.py b/openpype/version.py
index 8e44b02ffc..7bf368108a 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.11.1-nightly.1"
+__version__ = "3.11.1"
diff --git a/pyproject.toml b/pyproject.toml
index 8ba829a1c9..ae89e7d9d8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.11.1-nightly.1" # OpenPype
+version = "3.11.1" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 8b1576aed2b74dd5e01842d2a87bc04c77f755f6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 20 Jun 2022 11:22:05 +0200
Subject: [PATCH 0715/1227] remove unused line

---
 openpype/pipeline/context_tools.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/pipeline/context_tools.py b/openpype/pipeline/context_tools.py
index 3e63eeba27..4a147c230b 100644
--- a/openpype/pipeline/context_tools.py
+++ b/openpype/pipeline/context_tools.py
@@ -88,7 +88,6 @@ def install_host(host):
             avalon host-interface.
     """
     global _is_installed
-    global _modules_manager
 
     _is_installed = True
 

From c762fa92f6ab7f692c751fefdffe5f9c9571d582 Mon Sep 17 00:00:00 2001
From: macman <allan.ihsan@gmail.com>
Date: Mon, 20 Jun 2022 13:39:52 +0300
Subject: [PATCH 0716/1227] Handle excluding `model` family from frame range
 validator.

---
 openpype/hosts/maya/plugins/publish/validate_frame_range.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_frame_range.py b/openpype/hosts/maya/plugins/publish/validate_frame_range.py
index 98b5b4d79b..4415815d32 100644
--- a/openpype/hosts/maya/plugins/publish/validate_frame_range.py
+++ b/openpype/hosts/maya/plugins/publish/validate_frame_range.py
@@ -27,6 +27,7 @@ class ValidateFrameRange(pyblish.api.InstancePlugin):
                 "yeticache"]
     optional = True
     actions = [openpype.api.RepairAction]
+    exclude_families = ["model"]
 
     def process(self, instance):
         context = instance.context
@@ -56,7 +57,9 @@ class ValidateFrameRange(pyblish.api.InstancePlugin):
 
         # compare with data on instance
         errors = []
-
+        if [ef for ef in self.exclude_families
+                if instance.data["family"] in ef]:
+            return
         if(inst_start != frame_start_handle):
             errors.append("Instance start frame [ {} ] doesn't "
                           "match the one set on instance [ {} ]: "

From 3a1d9c9fcadab29f3b2962527dedea4da49abd4a Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 20 Jun 2022 13:11:01 +0200
Subject: [PATCH 0717/1227] Added far future value for null values for dates

Null values were sorted as last, this keeps queued items together with last synched.
---
 openpype/modules/sync_server/tray/models.py | 60 +++++++++++++--------
 1 file changed, 37 insertions(+), 23 deletions(-)

diff --git a/openpype/modules/sync_server/tray/models.py b/openpype/modules/sync_server/tray/models.py
index c49edeafb9..6d1e85c17a 100644
--- a/openpype/modules/sync_server/tray/models.py
+++ b/openpype/modules/sync_server/tray/models.py
@@ -1,6 +1,7 @@
 import os
 import attr
 from bson.objectid import ObjectId
+import datetime
 
 from Qt import QtCore
 from Qt.QtCore import Qt
@@ -413,6 +414,23 @@ class _SyncRepresentationModel(QtCore.QAbstractTableModel):
                 return index
         return None
 
+    def _convert_date(self, date_value, current_date):
+        """Converts 'date_value' to string.
+
+        Value of date_value might contain date in the future, used for nicely
+        sort queued items next to last downloaded.
+        """
+        try:
+            converted_date = None
+            # ignore date in the future - for sorting only
+            if date_value and date_value < current_date:
+                converted_date = date_value.strftime("%Y%m%dT%H%M%SZ")
+        except (AttributeError, TypeError):
+            # ignore unparseable values
+            pass
+
+        return converted_date
+
 
 class SyncRepresentationSummaryModel(_SyncRepresentationModel):
     """
@@ -560,7 +578,7 @@ class SyncRepresentationSummaryModel(_SyncRepresentationModel):
         remote_provider = lib.translate_provider_for_icon(self.sync_server,
                                                           self.project,
                                                           remote_site)
-
+        current_date = datetime.datetime.now()
         for repre in result.get("paginatedResults"):
             files = repre.get("files", [])
             if isinstance(files, dict):  # aggregate returns dictionary
@@ -570,14 +588,10 @@ class SyncRepresentationSummaryModel(_SyncRepresentationModel):
             if not files:
                 continue
 
-            local_updated = remote_updated = None
-            if repre.get('updated_dt_local'):
-                local_updated = \
-                    repre.get('updated_dt_local').strftime("%Y%m%dT%H%M%SZ")
-
-            if repre.get('updated_dt_remote'):
-                remote_updated = \
-                    repre.get('updated_dt_remote').strftime("%Y%m%dT%H%M%SZ")
+            local_updated = self._convert_date(repre.get('updated_dt_local'),
+                                               current_date)
+            remote_updated = self._convert_date(repre.get('updated_dt_remote'),
+                                                current_date)
 
             avg_progress_remote = lib.convert_progress(
                 repre.get('avg_progress_remote', '0'))
@@ -645,6 +659,8 @@ class SyncRepresentationSummaryModel(_SyncRepresentationModel):
         if limit == 0:
             limit = SyncRepresentationSummaryModel.PAGE_SIZE
 
+        # replace null with value in the future for better sorting
+        dummy_max_date = datetime.datetime(2099, 1, 1)
         aggr = [
             {"$match": self.get_match_part()},
             {'$unwind': '$files'},
@@ -687,7 +703,7 @@ class SyncRepresentationSummaryModel(_SyncRepresentationModel):
                               {'$cond': [
                                   {'$size': "$order_remote.last_failed_dt"},
                                   "$order_remote.last_failed_dt",
-                                  []
+                                  [dummy_max_date]
                               ]}
                               ]}},
                 'updated_dt_local': {'$first': {
@@ -696,7 +712,7 @@ class SyncRepresentationSummaryModel(_SyncRepresentationModel):
                               {'$cond': [
                                   {'$size': "$order_local.last_failed_dt"},
                                   "$order_local.last_failed_dt",
-                                  []
+                                  [dummy_max_date]
                               ]}
                               ]}},
                 'files_size': {'$ifNull': ["$files.size", 0]},
@@ -1039,6 +1055,7 @@ class SyncRepresentationDetailModel(_SyncRepresentationModel):
                                                           self.project,
                                                           remote_site)
 
+        current_date = datetime.datetime.now()
         for repre in result.get("paginatedResults"):
             # log.info("!!! repre:: {}".format(repre))
             files = repre.get("files", [])
@@ -1046,16 +1063,12 @@ class SyncRepresentationDetailModel(_SyncRepresentationModel):
                 files = [files]
 
             for file in files:
-                local_updated = remote_updated = None
-                if repre.get('updated_dt_local'):
-                    local_updated = \
-                        repre.get('updated_dt_local').strftime(
-                            "%Y%m%dT%H%M%SZ")
-
-                if repre.get('updated_dt_remote'):
-                    remote_updated = \
-                        repre.get('updated_dt_remote').strftime(
-                            "%Y%m%dT%H%M%SZ")
+                local_updated = self._convert_date(
+                    repre.get('updated_dt_local'),
+                    current_date)
+                remote_updated = self._convert_date(
+                    repre.get('updated_dt_remote'),
+                    current_date)
 
                 remote_progress = lib.convert_progress(
                     repre.get('progress_remote', '0'))
@@ -1104,6 +1117,7 @@ class SyncRepresentationDetailModel(_SyncRepresentationModel):
         if limit == 0:
             limit = SyncRepresentationSummaryModel.PAGE_SIZE
 
+        dummy_max_date = datetime.datetime(2099, 1, 1)
         aggr = [
             {"$match": self.get_match_part()},
             {"$unwind": "$files"},
@@ -1147,7 +1161,7 @@ class SyncRepresentationDetailModel(_SyncRepresentationModel):
                             '$cond': [
                                 {'$size': "$order_remote.last_failed_dt"},
                                 "$order_remote.last_failed_dt",
-                                []
+                                [dummy_max_date]
                             ]
                         }
                     ]
@@ -1160,7 +1174,7 @@ class SyncRepresentationDetailModel(_SyncRepresentationModel):
                             '$cond': [
                                 {'$size': "$order_local.last_failed_dt"},
                                 "$order_local.last_failed_dt",
-                                []
+                                [dummy_max_date]
                             ]
                         }
                     ]

From 20bc7300b1946e5ef082b4a43c922e108a46cabb Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 20 Jun 2022 13:14:16 +0200
Subject: [PATCH 0718/1227] fix delivery action

---
 .../modules/ftrack/event_handlers_user/action_delivery.py     | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_delivery.py b/openpype/modules/ftrack/event_handlers_user/action_delivery.py
index 47f2853820..4b799b092b 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_delivery.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_delivery.py
@@ -542,7 +542,9 @@ class Delivery(BaseAction):
                 os.makedirs(location_path)
 
         self.log.debug("Collecting representations to process.")
-        version_ids = self._get_interest_version_ids(session, entities)
+        version_ids = self._get_interest_version_ids(
+            project_name, session, entities
+        )
         repres_to_deliver = list(get_representations(
             project_name,
             representation_names=repre_names,

From 665fab4e35b76b2d9cb37195fb203ff3203c1ef5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 20 Jun 2022 13:15:32 +0200
Subject: [PATCH 0719/1227] fix delete asset action to filter assets right way

---
 .../modules/ftrack/event_handlers_user/action_delete_asset.py  | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py b/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py
index 6dae3a4ca1..03d029b0c1 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_delete_asset.py
@@ -134,7 +134,8 @@ class DeleteAssetSubset(BaseAction):
             ftrack_id = asset_doc["data"].get("ftrackId")
             if ftrack_id:
                 found_ftrack_ids.add(ftrack_id)
-                selected_av_entities.append(asset_doc)
+                if ftrack_id in entity_mapping:
+                    selected_av_entities.append(asset_doc)
 
             asset_name = asset_doc["name"]
             asset_docs_by_name[asset_name].append(asset_doc)

From d49c2bac223f77b20710e029c6edb9caf1577d20 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 20 Jun 2022 13:42:04 +0200
Subject: [PATCH 0720/1227] reverted poetry.lock changes

---
 poetry.lock | 197 ++++++++++++++++++++++++++++++----------------------
 1 file changed, 114 insertions(+), 83 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 010dd57e17..f6ccf1ffc9 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -161,11 +161,11 @@ toml = "*"
 
 [[package]]
 name = "babel"
-version = "2.10.1"
+version = "2.9.1"
 description = "Internationalization utilities"
 category = "dev"
 optional = false
-python-versions = ">=3.6"
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [package.dependencies]
 pytz = ">=2015.7"
@@ -671,14 +671,14 @@ testing = ["colorama", "docopt", "pytest (>=3.1.0)"]
 
 [[package]]
 name = "jeepney"
-version = "0.8.0"
+version = "0.7.1"
 description = "Low-level, pure Python DBus protocol wrapper."
 category = "main"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.6"
 
 [package.extras]
-test = ["pytest", "pytest-trio", "pytest-asyncio (>=0.17)", "testpath", "trio", "async-timeout"]
+test = ["pytest", "pytest-trio", "pytest-asyncio", "testpath", "trio", "async-timeout"]
 trio = ["trio", "async-generator"]
 
 [[package]]
@@ -756,11 +756,11 @@ pymongo = "*"
 
 [[package]]
 name = "markupsafe"
-version = "2.1.1"
+version = "2.0.1"
 description = "Safely add untrusted strings to HTML/XML markup."
 category = "dev"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.6"
 
 [[package]]
 name = "mccabe"
@@ -909,11 +909,11 @@ python-versions = "*"
 
 [[package]]
 name = "protobuf"
-version = "3.20.1"
+version = "3.19.4"
 description = "Protocol Buffers"
 category = "main"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.5"
 
 [[package]]
 name = "py"
@@ -1617,11 +1617,11 @@ python-versions = ">=3.6"
 
 [[package]]
 name = "typing-extensions"
-version = "4.2.0"
-description = "Backported and Experimental Type Hints for Python 3.7+"
+version = "4.0.1"
+description = "Backported and Experimental Type Hints for Python 3.6+"
 category = "main"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.6"
 
 [[package]]
 name = "uritemplate"
@@ -1716,7 +1716,7 @@ testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-
 [metadata]
 lock-version = "1.1"
 python-versions = "3.7.*"
-content-hash = "f7150d3d8098c26a004db9850ed328efe79695e77e830721a3e04c5941850cc5"
+content-hash = "bd8e0a03668c380c6e76c8cd6c71020692f4ea9f32de7a4f09433564faa9dad0"
 
 [metadata.files]
 acre = []
@@ -1843,8 +1843,8 @@ autopep8 = [
     {file = "autopep8-1.5.7.tar.gz", hash = "sha256:276ced7e9e3cb22e5d7c14748384a5cf5d9002257c0ed50c0e075b68011bb6d0"},
 ]
 babel = [
-    {file = "Babel-2.10.1-py3-none-any.whl", hash = "sha256:3f349e85ad3154559ac4930c3918247d319f21910d5ce4b25d439ed8693b98d2"},
-    {file = "Babel-2.10.1.tar.gz", hash = "sha256:98aeaca086133efb3e1e2aad0396987490c8425929ddbcfe0550184fdc54cd13"},
+    {file = "Babel-2.9.1-py2.py3-none-any.whl", hash = "sha256:ab49e12b91d937cd11f0b67cb259a57ab4ad2b59ac7a3b41d6c06c0ac5b0def9"},
+    {file = "Babel-2.9.1.tar.gz", hash = "sha256:bc0c176f9f6a994582230df350aa6e05ba2ebe4b3ac317eab29d9be5d2768da0"},
 ]
 bcrypt = [
     {file = "bcrypt-3.2.2-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:7180d98a96f00b1050e93f5b0f556e658605dd9f524d0b0e68ae7944673f525e"},
@@ -2202,8 +2202,8 @@ jedi = [
     {file = "jedi-0.13.3.tar.gz", hash = "sha256:2bb0603e3506f708e792c7f4ad8fc2a7a9d9c2d292a358fbbd58da531695595b"},
 ]
 jeepney = [
-    {file = "jeepney-0.8.0-py3-none-any.whl", hash = "sha256:c0a454ad016ca575060802ee4d590dd912e35c122fa04e70306de3d076cce755"},
-    {file = "jeepney-0.8.0.tar.gz", hash = "sha256:5efe48d255973902f6badc3ce55e2aa6c5c3b3bc642059ef3a91247bcfcc5806"},
+    {file = "jeepney-0.7.1-py3-none-any.whl", hash = "sha256:1b5a0ea5c0e7b166b2f5895b91a08c14de8915afda4407fb5022a195224958ac"},
+    {file = "jeepney-0.7.1.tar.gz", hash = "sha256:fa9e232dfa0c498bd0b8a3a73b8d8a31978304dcef0515adc859d4e096f96f4f"},
 ]
 jinja2 = [
     {file = "Jinja2-2.11.3-py2.py3-none-any.whl", hash = "sha256:03e47ad063331dd6a3f04a43eddca8a966a26ba0c5b7207a9a9e4e08f1b29419"},
@@ -2264,46 +2264,75 @@ log4mongo = [
     {file = "log4mongo-1.7.0.tar.gz", hash = "sha256:dc374617206162a0b14167fbb5feac01dbef587539a235dadba6200362984a68"},
 ]
 markupsafe = [
-    {file = "MarkupSafe-2.1.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:86b1f75c4e7c2ac2ccdaec2b9022845dbb81880ca318bb7a0a01fbf7813e3812"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:f121a1420d4e173a5d96e47e9a0c0dcff965afdf1626d28de1460815f7c4ee7a"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a49907dd8420c5685cfa064a1335b6754b74541bbb3706c259c02ed65b644b3e"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:10c1bfff05d95783da83491be968e8fe789263689c02724e0c691933c52994f5"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b7bd98b796e2b6553da7225aeb61f447f80a1ca64f41d83612e6139ca5213aa4"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:b09bf97215625a311f669476f44b8b318b075847b49316d3e28c08e41a7a573f"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:694deca8d702d5db21ec83983ce0bb4b26a578e71fbdbd4fdcd387daa90e4d5e"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:efc1913fd2ca4f334418481c7e595c00aad186563bbc1ec76067848c7ca0a933"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-win32.whl", hash = "sha256:4a33dea2b688b3190ee12bd7cfa29d39c9ed176bda40bfa11099a3ce5d3a7ac6"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:dda30ba7e87fbbb7eab1ec9f58678558fd9a6b8b853530e176eabd064da81417"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:671cd1187ed5e62818414afe79ed29da836dde67166a9fac6d435873c44fdd02"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3799351e2336dc91ea70b034983ee71cf2f9533cdff7c14c90ea126bfd95d65a"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e72591e9ecd94d7feb70c1cbd7be7b3ebea3f548870aa91e2732960fa4d57a37"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6fbf47b5d3728c6aea2abb0589b5d30459e369baa772e0f37a0320185e87c980"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:d5ee4f386140395a2c818d149221149c54849dfcfcb9f1debfe07a8b8bd63f9a"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:bcb3ed405ed3222f9904899563d6fc492ff75cce56cba05e32eff40e6acbeaa3"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:e1c0b87e09fa55a220f058d1d49d3fb8df88fbfab58558f1198e08c1e1de842a"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-win32.whl", hash = "sha256:8dc1c72a69aa7e082593c4a203dcf94ddb74bb5c8a731e4e1eb68d031e8498ff"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-win_amd64.whl", hash = "sha256:97a68e6ada378df82bc9f16b800ab77cbf4b2fada0081794318520138c088e4a"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:e8c843bbcda3a2f1e3c2ab25913c80a3c5376cd00c6e8c4a86a89a28c8dc5452"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:0212a68688482dc52b2d45013df70d169f542b7394fc744c02a57374a4207003"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8e576a51ad59e4bfaac456023a78f6b5e6e7651dcd383bcc3e18d06f9b55d6d1"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4b9fe39a2ccc108a4accc2676e77da025ce383c108593d65cc909add5c3bd601"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:96e37a3dc86e80bf81758c152fe66dbf60ed5eca3d26305edf01892257049925"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:6d0072fea50feec76a4c418096652f2c3238eaa014b2f94aeb1d56a66b41403f"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:089cf3dbf0cd6c100f02945abeb18484bd1ee57a079aefd52cffd17fba910b88"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:6a074d34ee7a5ce3effbc526b7083ec9731bb3cbf921bbe1d3005d4d2bdb3a63"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-win32.whl", hash = "sha256:421be9fbf0ffe9ffd7a378aafebbf6f4602d564d34be190fc19a193232fd12b1"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-win_amd64.whl", hash = "sha256:fc7b548b17d238737688817ab67deebb30e8073c95749d55538ed473130ec0c7"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:e04e26803c9c3851c931eac40c695602c6295b8d432cbe78609649ad9bd2da8a"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:b87db4360013327109564f0e591bd2a3b318547bcef31b468a92ee504d07ae4f"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:99a2a507ed3ac881b975a2976d59f38c19386d128e7a9a18b7df6fff1fd4c1d6"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:56442863ed2b06d19c37f94d999035e15ee982988920e12a5b4ba29b62ad1f77"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3ce11ee3f23f79dbd06fb3d63e2f6af7b12db1d46932fe7bd8afa259a5996603"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:33b74d289bd2f5e527beadcaa3f401e0df0a89927c1559c8566c066fa4248ab7"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:43093fb83d8343aac0b1baa75516da6092f58f41200907ef92448ecab8825135"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:8e3dcf21f367459434c18e71b2a9532d96547aef8a871872a5bd69a715c15f96"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-win32.whl", hash = "sha256:d4306c36ca495956b6d568d276ac11fdd9c30a36f1b6eb928070dc5360b22e1c"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-win_amd64.whl", hash = "sha256:46d00d6cfecdde84d40e572d63735ef81423ad31184100411e6e3388d405e247"},
-    {file = "MarkupSafe-2.1.1.tar.gz", hash = "sha256:7f91197cc9e48f989d12e4e6fbc46495c446636dfc81b9ccf50bb0ec74b91d4b"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:d8446c54dc28c01e5a2dbac5a25f071f6653e6e40f3a8818e8b45d790fe6ef53"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:36bc903cbb393720fad60fc28c10de6acf10dc6cc883f3e24ee4012371399a38"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2d7d807855b419fc2ed3e631034685db6079889a1f01d5d9dac950f764da3dad"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:add36cb2dbb8b736611303cd3bfcee00afd96471b09cda130da3581cbdc56a6d"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:168cd0a3642de83558a5153c8bd34f175a9a6e7f6dc6384b9655d2697312a646"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:4dc8f9fb58f7364b63fd9f85013b780ef83c11857ae79f2feda41e270468dd9b"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:20dca64a3ef2d6e4d5d615a3fd418ad3bde77a47ec8a23d984a12b5b4c74491a"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:cdfba22ea2f0029c9261a4bd07e830a8da012291fbe44dc794e488b6c9bb353a"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-win32.whl", hash = "sha256:99df47edb6bda1249d3e80fdabb1dab8c08ef3975f69aed437cb69d0a5de1e28"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:e0f138900af21926a02425cf736db95be9f4af72ba1bb21453432a07f6082134"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:f9081981fe268bd86831e5c75f7de206ef275defcb82bc70740ae6dc507aee51"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux1_i686.whl", hash = "sha256:0955295dd5eec6cb6cc2fe1698f4c6d84af2e92de33fbcac4111913cd100a6ff"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux1_x86_64.whl", hash = "sha256:0446679737af14f45767963a1a9ef7620189912317d095f2d9ffa183a4d25d2b"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2010_i686.whl", hash = "sha256:f826e31d18b516f653fe296d967d700fddad5901ae07c622bb3705955e1faa94"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2010_x86_64.whl", hash = "sha256:fa130dd50c57d53368c9d59395cb5526eda596d3ffe36666cd81a44d56e48872"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2014_aarch64.whl", hash = "sha256:905fec760bd2fa1388bb5b489ee8ee5f7291d692638ea5f67982d968366bef9f"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bf5d821ffabf0ef3533c39c518f3357b171a1651c1ff6827325e4489b0e46c3c"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:0d4b31cc67ab36e3392bbf3862cfbadac3db12bdd8b02a2731f509ed5b829724"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:baa1a4e8f868845af802979fcdbf0bb11f94f1cb7ced4c4b8a351bb60d108145"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:deb993cacb280823246a026e3b2d81c493c53de6acfd5e6bfe31ab3402bb37dd"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:63f3268ba69ace99cab4e3e3b5840b03340efed0948ab8f78d2fd87ee5442a4f"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:8d206346619592c6200148b01a2142798c989edcb9c896f9ac9722a99d4e77e6"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-win32.whl", hash = "sha256:6c4ca60fa24e85fe25b912b01e62cb969d69a23a5d5867682dd3e80b5b02581d"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-win_amd64.whl", hash = "sha256:b2f4bf27480f5e5e8ce285a8c8fd176c0b03e93dcc6646477d4630e83440c6a9"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:0717a7390a68be14b8c793ba258e075c6f4ca819f15edfc2a3a027c823718567"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux1_i686.whl", hash = "sha256:6557b31b5e2c9ddf0de32a691f2312a32f77cd7681d8af66c2692efdbef84c18"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux1_x86_64.whl", hash = "sha256:49e3ceeabbfb9d66c3aef5af3a60cc43b85c33df25ce03d0031a608b0a8b2e3f"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2010_i686.whl", hash = "sha256:d7f9850398e85aba693bb640262d3611788b1f29a79f0c93c565694658f4071f"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2010_x86_64.whl", hash = "sha256:6a7fae0dd14cf60ad5ff42baa2e95727c3d81ded453457771d02b7d2b3f9c0c2"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2014_aarch64.whl", hash = "sha256:b7f2d075102dc8c794cbde1947378051c4e5180d52d276987b8d28a3bd58c17d"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e9936f0b261d4df76ad22f8fee3ae83b60d7c3e871292cd42f40b81b70afae85"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:2a7d351cbd8cfeb19ca00de495e224dea7e7d919659c2841bbb7f420ad03e2d6"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:60bf42e36abfaf9aff1f50f52644b336d4f0a3fd6d8a60ca0d054ac9f713a864"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:d6c7ebd4e944c85e2c3421e612a7057a2f48d478d79e61800d81468a8d842207"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:f0567c4dc99f264f49fe27da5f735f414c4e7e7dd850cfd8e69f0862d7c74ea9"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:89c687013cb1cd489a0f0ac24febe8c7a666e6e221b783e53ac50ebf68e45d86"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-win32.whl", hash = "sha256:a30e67a65b53ea0a5e62fe23682cfe22712e01f453b95233b25502f7c61cb415"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-win_amd64.whl", hash = "sha256:611d1ad9a4288cf3e3c16014564df047fe08410e628f89805e475368bd304914"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:5bb28c636d87e840583ee3adeb78172efc47c8b26127267f54a9c0ec251d41a9"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:be98f628055368795d818ebf93da628541e10b75b41c559fdf36d104c5787066"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux1_i686.whl", hash = "sha256:1d609f577dc6e1aa17d746f8bd3c31aa4d258f4070d61b2aa5c4166c1539de35"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux1_x86_64.whl", hash = "sha256:7d91275b0245b1da4d4cfa07e0faedd5b0812efc15b702576d103293e252af1b"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2010_i686.whl", hash = "sha256:01a9b8ea66f1658938f65b93a85ebe8bc016e6769611be228d797c9d998dd298"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2010_x86_64.whl", hash = "sha256:47ab1e7b91c098ab893b828deafa1203de86d0bc6ab587b160f78fe6c4011f75"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2014_aarch64.whl", hash = "sha256:97383d78eb34da7e1fa37dd273c20ad4320929af65d156e35a5e2d89566d9dfb"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6fcf051089389abe060c9cd7caa212c707e58153afa2c649f00346ce6d260f1b"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:5855f8438a7d1d458206a2466bf82b0f104a3724bf96a1c781ab731e4201731a"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:3dd007d54ee88b46be476e293f48c85048603f5f516008bee124ddd891398ed6"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:aca6377c0cb8a8253e493c6b451565ac77e98c2951c45f913e0b52facdcff83f"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:04635854b943835a6ea959e948d19dcd311762c5c0c6e1f0e16ee57022669194"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:6300b8454aa6930a24b9618fbb54b5a68135092bc666f7b06901f897fa5c2fee"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-win32.whl", hash = "sha256:023cb26ec21ece8dc3907c0e8320058b2e0cb3c55cf9564da612bc325bed5e64"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:984d76483eb32f1bcb536dc27e4ad56bba4baa70be32fa87152832cdd9db0833"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:2ef54abee730b502252bcdf31b10dacb0a416229b72c18b19e24a4509f273d26"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:3c112550557578c26af18a1ccc9e090bfe03832ae994343cfdacd287db6a6ae7"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux1_i686.whl", hash = "sha256:53edb4da6925ad13c07b6d26c2a852bd81e364f95301c66e930ab2aef5b5ddd8"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux1_x86_64.whl", hash = "sha256:f5653a225f31e113b152e56f154ccbe59eeb1c7487b39b9d9f9cdb58e6c79dc5"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2010_i686.whl", hash = "sha256:4efca8f86c54b22348a5467704e3fec767b2db12fc39c6d963168ab1d3fc9135"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2010_x86_64.whl", hash = "sha256:ab3ef638ace319fa26553db0624c4699e31a28bb2a835c5faca8f8acf6a5a902"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2014_aarch64.whl", hash = "sha256:f8ba0e8349a38d3001fae7eadded3f6606f0da5d748ee53cc1dab1d6527b9509"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c47adbc92fc1bb2b3274c4b3a43ae0e4573d9fbff4f54cd484555edbf030baf1"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:37205cac2a79194e3750b0af2a5720d95f786a55ce7df90c3af697bfa100eaac"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:1f2ade76b9903f39aa442b4aadd2177decb66525062db244b35d71d0ee8599b6"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:4296f2b1ce8c86a6aea78613c34bb1a672ea0e3de9c6ba08a960efe0b0a09047"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:9f02365d4e99430a12647f09b6cc8bab61a6564363f313126f775eb4f6ef798e"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5b6d930f030f8ed98e3e6c98ffa0652bdb82601e7a016ec2ab5d7ff23baa78d1"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-win32.whl", hash = "sha256:10f82115e21dc0dfec9ab5c0223652f7197feb168c940f3ef61563fc2d6beb74"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:693ce3f9e70a6cf7d2fb9e6c9d8b204b6b39897a2c4a1aa65728d5ac97dcc1d8"},
+    {file = "MarkupSafe-2.0.1.tar.gz", hash = "sha256:594c67807fb16238b30c44bdf74f36c02cdf22d1c8cda91ef8a0ed8dabf5620a"},
 ]
 mccabe = [
     {file = "mccabe-0.6.1-py2.py3-none-any.whl", hash = "sha256:ab8a6258860da4b6677da4bd2fe5dc2c659cff31b3ee4f7f5d64e79735b80d42"},
@@ -2444,30 +2473,32 @@ prefixed = [
     {file = "prefixed-0.3.2.tar.gz", hash = "sha256:ca48277ba5fa8346dd4b760847da930c7b84416387c39e93affef086add2c029"},
 ]
 protobuf = [
-    {file = "protobuf-3.20.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:3cc797c9d15d7689ed507b165cd05913acb992d78b379f6014e013f9ecb20996"},
-    {file = "protobuf-3.20.1-cp310-cp310-manylinux2014_aarch64.whl", hash = "sha256:ff8d8fa42675249bb456f5db06c00de6c2f4c27a065955917b28c4f15978b9c3"},
-    {file = "protobuf-3.20.1-cp310-cp310-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:cd68be2559e2a3b84f517fb029ee611546f7812b1fdd0aa2ecc9bc6ec0e4fdde"},
-    {file = "protobuf-3.20.1-cp310-cp310-win32.whl", hash = "sha256:9016d01c91e8e625141d24ec1b20fed584703e527d28512aa8c8707f105a683c"},
-    {file = "protobuf-3.20.1-cp310-cp310-win_amd64.whl", hash = "sha256:32ca378605b41fd180dfe4e14d3226386d8d1b002ab31c969c366549e66a2bb7"},
-    {file = "protobuf-3.20.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:9be73ad47579abc26c12024239d3540e6b765182a91dbc88e23658ab71767153"},
-    {file = "protobuf-3.20.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:097c5d8a9808302fb0da7e20edf0b8d4703274d140fd25c5edabddcde43e081f"},
-    {file = "protobuf-3.20.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:e250a42f15bf9d5b09fe1b293bdba2801cd520a9f5ea2d7fb7536d4441811d20"},
-    {file = "protobuf-3.20.1-cp37-cp37m-manylinux2014_aarch64.whl", hash = "sha256:cdee09140e1cd184ba9324ec1df410e7147242b94b5f8b0c64fc89e38a8ba531"},
-    {file = "protobuf-3.20.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:af0ebadc74e281a517141daad9d0f2c5d93ab78e9d455113719a45a49da9db4e"},
-    {file = "protobuf-3.20.1-cp37-cp37m-win32.whl", hash = "sha256:755f3aee41354ae395e104d62119cb223339a8f3276a0cd009ffabfcdd46bb0c"},
-    {file = "protobuf-3.20.1-cp37-cp37m-win_amd64.whl", hash = "sha256:62f1b5c4cd6c5402b4e2d63804ba49a327e0c386c99b1675c8a0fefda23b2067"},
-    {file = "protobuf-3.20.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:06059eb6953ff01e56a25cd02cca1a9649a75a7e65397b5b9b4e929ed71d10cf"},
-    {file = "protobuf-3.20.1-cp38-cp38-manylinux2014_aarch64.whl", hash = "sha256:cb29edb9eab15742d791e1025dd7b6a8f6fcb53802ad2f6e3adcb102051063ab"},
-    {file = "protobuf-3.20.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:69ccfdf3657ba59569c64295b7d51325f91af586f8d5793b734260dfe2e94e2c"},
-    {file = "protobuf-3.20.1-cp38-cp38-win32.whl", hash = "sha256:dd5789b2948ca702c17027c84c2accb552fc30f4622a98ab5c51fcfe8c50d3e7"},
-    {file = "protobuf-3.20.1-cp38-cp38-win_amd64.whl", hash = "sha256:77053d28427a29987ca9caf7b72ccafee011257561259faba8dd308fda9a8739"},
-    {file = "protobuf-3.20.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:6f50601512a3d23625d8a85b1638d914a0970f17920ff39cec63aaef80a93fb7"},
-    {file = "protobuf-3.20.1-cp39-cp39-manylinux2014_aarch64.whl", hash = "sha256:284f86a6207c897542d7e956eb243a36bb8f9564c1742b253462386e96c6b78f"},
-    {file = "protobuf-3.20.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:7403941f6d0992d40161aa8bb23e12575637008a5a02283a930addc0508982f9"},
-    {file = "protobuf-3.20.1-cp39-cp39-win32.whl", hash = "sha256:db977c4ca738dd9ce508557d4fce0f5aebd105e158c725beec86feb1f6bc20d8"},
-    {file = "protobuf-3.20.1-cp39-cp39-win_amd64.whl", hash = "sha256:7e371f10abe57cee5021797126c93479f59fccc9693dafd6bd5633ab67808a91"},
-    {file = "protobuf-3.20.1-py2.py3-none-any.whl", hash = "sha256:adfc6cf69c7f8c50fd24c793964eef18f0ac321315439d94945820612849c388"},
-    {file = "protobuf-3.20.1.tar.gz", hash = "sha256:adc31566d027f45efe3f44eeb5b1f329da43891634d61c75a5944e9be6dd42c9"},
+    {file = "protobuf-3.19.4-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:f51d5a9f137f7a2cec2d326a74b6e3fc79d635d69ffe1b036d39fc7d75430d37"},
+    {file = "protobuf-3.19.4-cp310-cp310-manylinux2014_aarch64.whl", hash = "sha256:09297b7972da685ce269ec52af761743714996b4381c085205914c41fcab59fb"},
+    {file = "protobuf-3.19.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:072fbc78d705d3edc7ccac58a62c4c8e0cec856987da7df8aca86e647be4e35c"},
+    {file = "protobuf-3.19.4-cp310-cp310-win32.whl", hash = "sha256:7bb03bc2873a2842e5ebb4801f5c7ff1bfbdf426f85d0172f7644fcda0671ae0"},
+    {file = "protobuf-3.19.4-cp310-cp310-win_amd64.whl", hash = "sha256:f358aa33e03b7a84e0d91270a4d4d8f5df6921abe99a377828839e8ed0c04e07"},
+    {file = "protobuf-3.19.4-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:1c91ef4110fdd2c590effb5dca8fdbdcb3bf563eece99287019c4204f53d81a4"},
+    {file = "protobuf-3.19.4-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c438268eebb8cf039552897d78f402d734a404f1360592fef55297285f7f953f"},
+    {file = "protobuf-3.19.4-cp36-cp36m-win32.whl", hash = "sha256:835a9c949dc193953c319603b2961c5c8f4327957fe23d914ca80d982665e8ee"},
+    {file = "protobuf-3.19.4-cp36-cp36m-win_amd64.whl", hash = "sha256:4276cdec4447bd5015453e41bdc0c0c1234eda08420b7c9a18b8d647add51e4b"},
+    {file = "protobuf-3.19.4-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:6cbc312be5e71869d9d5ea25147cdf652a6781cf4d906497ca7690b7b9b5df13"},
+    {file = "protobuf-3.19.4-cp37-cp37m-manylinux2014_aarch64.whl", hash = "sha256:54a1473077f3b616779ce31f477351a45b4fef8c9fd7892d6d87e287a38df368"},
+    {file = "protobuf-3.19.4-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:435bb78b37fc386f9275a7035fe4fb1364484e38980d0dd91bc834a02c5ec909"},
+    {file = "protobuf-3.19.4-cp37-cp37m-win32.whl", hash = "sha256:16f519de1313f1b7139ad70772e7db515b1420d208cb16c6d7858ea989fc64a9"},
+    {file = "protobuf-3.19.4-cp37-cp37m-win_amd64.whl", hash = "sha256:cdc076c03381f5c1d9bb1abdcc5503d9ca8b53cf0a9d31a9f6754ec9e6c8af0f"},
+    {file = "protobuf-3.19.4-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:69da7d39e39942bd52848438462674c463e23963a1fdaa84d88df7fbd7e749b2"},
+    {file = "protobuf-3.19.4-cp38-cp38-manylinux2014_aarch64.whl", hash = "sha256:48ed3877fa43e22bcacc852ca76d4775741f9709dd9575881a373bd3e85e54b2"},
+    {file = "protobuf-3.19.4-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bd95d1dfb9c4f4563e6093a9aa19d9c186bf98fa54da5252531cc0d3a07977e7"},
+    {file = "protobuf-3.19.4-cp38-cp38-win32.whl", hash = "sha256:b38057450a0c566cbd04890a40edf916db890f2818e8682221611d78dc32ae26"},
+    {file = "protobuf-3.19.4-cp38-cp38-win_amd64.whl", hash = "sha256:7ca7da9c339ca8890d66958f5462beabd611eca6c958691a8fe6eccbd1eb0c6e"},
+    {file = "protobuf-3.19.4-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:36cecbabbda242915529b8ff364f2263cd4de7c46bbe361418b5ed859677ba58"},
+    {file = "protobuf-3.19.4-cp39-cp39-manylinux2014_aarch64.whl", hash = "sha256:c1068287025f8ea025103e37d62ffd63fec8e9e636246b89c341aeda8a67c934"},
+    {file = "protobuf-3.19.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:96bd766831596d6014ca88d86dc8fe0fb2e428c0b02432fd9db3943202bf8c5e"},
+    {file = "protobuf-3.19.4-cp39-cp39-win32.whl", hash = "sha256:84123274d982b9e248a143dadd1b9815049f4477dc783bf84efe6250eb4b836a"},
+    {file = "protobuf-3.19.4-cp39-cp39-win_amd64.whl", hash = "sha256:3112b58aac3bac9c8be2b60a9daf6b558ca3f7681c130dcdd788ade7c9ffbdca"},
+    {file = "protobuf-3.19.4-py2.py3-none-any.whl", hash = "sha256:8961c3a78ebfcd000920c9060a262f082f29838682b1f7201889300c1fbe0616"},
+    {file = "protobuf-3.19.4.tar.gz", hash = "sha256:9df0c10adf3e83015ced42a9a7bd64e13d06c4cf45c340d2c63020ea04499d0a"},
 ]
 py = [
     {file = "py-1.11.0-py2.py3-none-any.whl", hash = "sha256:607c53218732647dff4acdfcd50cb62615cedf612e72d1724fb1a0cc6405b378"},
@@ -2891,8 +2922,8 @@ typed-ast = [
     {file = "typed_ast-1.5.4.tar.gz", hash = "sha256:39e21ceb7388e4bb37f4c679d72707ed46c2fbf2a5609b8b8ebc4b067d977df2"},
 ]
 typing-extensions = [
-    {file = "typing_extensions-4.2.0-py3-none-any.whl", hash = "sha256:6657594ee297170d19f67d55c05852a874e7eb634f4f753dbd667855e07c1708"},
-    {file = "typing_extensions-4.2.0.tar.gz", hash = "sha256:f1c24655a0da0d1b67f07e17a5e6b2a105894e6824b92096378bb3668ef02376"},
+    {file = "typing_extensions-4.0.1-py3-none-any.whl", hash = "sha256:7f001e5ac290a0c0401508864c7ec868be4e701886d5b573a9528ed3973d9d3b"},
+    {file = "typing_extensions-4.0.1.tar.gz", hash = "sha256:4ca091dea149f945ec56afb48dae714f21e8692ef22a395223bcd328961b6a0e"},
 ]
 uritemplate = [
     {file = "uritemplate-3.0.1-py2.py3-none-any.whl", hash = "sha256:07620c3f3f8eed1f12600845892b0e036a2420acf513c53f7de0abd911a5894f"},

From b4c6cb414cbd9118c4c8d8a6527c14940f11b771 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Fri, 10 Jun 2022 18:25:40 +0200
Subject: [PATCH 0721/1227] remove unused import

---
 openpype/modules/shotgrid/shotgrid_module.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/modules/shotgrid/shotgrid_module.py b/openpype/modules/shotgrid/shotgrid_module.py
index dcc8187194..5644f0c35f 100644
--- a/openpype/modules/shotgrid/shotgrid_module.py
+++ b/openpype/modules/shotgrid/shotgrid_module.py
@@ -1,5 +1,4 @@
 import os
-import threading
 
 from openpype_interfaces import (
     ITrayModule,

From 151bf297c7b72788a6ff8a8f87d98c73b67d1aaf Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 13 Jun 2022 14:50:26 +0200
Subject: [PATCH 0722/1227] Remove unused code and add sugestions

---
 .../shotgrid/hooks/post_shotgrid_changes.py   |  9 --------
 openpype/modules/shotgrid/lib/settings.py     | 23 -------------------
 .../publish/collect_shotgrid_entities.py      |  5 ++--
 3 files changed, 2 insertions(+), 35 deletions(-)
 delete mode 100644 openpype/modules/shotgrid/hooks/post_shotgrid_changes.py

diff --git a/openpype/modules/shotgrid/hooks/post_shotgrid_changes.py b/openpype/modules/shotgrid/hooks/post_shotgrid_changes.py
deleted file mode 100644
index e8369ad3cb..0000000000
--- a/openpype/modules/shotgrid/hooks/post_shotgrid_changes.py
+++ /dev/null
@@ -1,9 +0,0 @@
-from openpype.lib import PostLaunchHook
-
-
-class PostShotgridHook(PostLaunchHook):
-    order = None
-
-    def execute(self, *args, **kwargs):
-        print(args, kwargs)
-        pass
diff --git a/openpype/modules/shotgrid/lib/settings.py b/openpype/modules/shotgrid/lib/settings.py
index 4a772de5b7..924099f04b 100644
--- a/openpype/modules/shotgrid/lib/settings.py
+++ b/openpype/modules/shotgrid/lib/settings.py
@@ -1,24 +1,11 @@
-import os
-
-from pymongo import MongoClient
 from openpype.api import get_system_settings, get_project_settings
 from openpype.modules.shotgrid.lib.const import MODULE_NAME
-from openpype.modules.shotgrid.lib.tools import memoize
 
 
-def get_project_list():
-    mongo_url = os.getenv("OPENPYPE_MONGO")
-    client = MongoClient(mongo_url)
-    db = client['avalon']
-    return db.list_collection_names()
-
-
-@memoize
 def get_shotgrid_project_settings(project):
     return get_project_settings(project).get(MODULE_NAME, {})
 
 
-@memoize
 def get_shotgrid_settings():
     return get_system_settings().get("modules", {}).get(MODULE_NAME, {})
 
@@ -29,13 +16,3 @@ def get_shotgrid_servers():
 
 def get_leecher_backend_url():
     return get_shotgrid_settings().get("leecher_backend_url")
-
-
-def filter_projects_by_login():
-    return bool(get_shotgrid_settings().get("filter_projects_by_login", False))
-
-
-def get_shotgrid_event_mongo_info():
-    database_name = os.environ["OPENPYPE_DATABASE_NAME"]
-    collection_name = "shotgrid_events"
-    return database_name, collection_name
diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
index a770c1eb87..9880425a41 100644
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
@@ -1,7 +1,7 @@
 import os
 
 import pyblish.api
-from pymongo import MongoClient
+from openpype.lib.mongo import OpenPypeMongoConnection
 
 from openpype.modules.shotgrid.lib.settings import (
     get_shotgrid_project_settings,
@@ -63,8 +63,7 @@ class CollectShotgridEntities(pyblish.api.ContextPlugin):
 
 
 def _get_shotgrid_collection(project):
-    mongo_url = os.getenv("OPENPYPE_MONGO")
-    client = MongoClient(mongo_url)
+    client = OpenPypeMongoConnection.get_mongo_client()
     return client.get_database("shotgrid_openpype").get_collection(project)
 
 

From ad0aea007a7604a02430c5a55366e458802b853e Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 20 Jun 2022 13:49:21 +0200
Subject: [PATCH 0723/1227] remove unused method

---
 openpype/modules/shotgrid/lib/server.py |   26 -
 openpype/modules/shotgrid/lib/tools.py  |   16 -
 poetry.lock                             | 1009 ++++++++++-------------
 3 files changed, 453 insertions(+), 598 deletions(-)
 delete mode 100644 openpype/modules/shotgrid/lib/server.py
 delete mode 100644 openpype/modules/shotgrid/lib/tools.py

diff --git a/openpype/modules/shotgrid/lib/server.py b/openpype/modules/shotgrid/lib/server.py
deleted file mode 100644
index 50645d4089..0000000000
--- a/openpype/modules/shotgrid/lib/server.py
+++ /dev/null
@@ -1,26 +0,0 @@
-import traceback
-
-import requests
-
-from openpype.api import Logger
-from openpype.modules.shotgrid.lib import (
-    settings as settings_lib,
-)
-
-_LOG = Logger().get_logger("ShotgridModule.server")
-
-
-def find_linked_projects(email):
-    url = "".join(
-        [
-            settings_lib.get_leecher_backend_url(),
-            "/user/",
-            email,
-            "/project-user-links",
-        ]
-    )
-    try:
-        return requests.get(url).json()
-    except requests.exceptions.RequestException as e:
-        _LOG.error(e)
-        traceback.print_stack()
diff --git a/openpype/modules/shotgrid/lib/tools.py b/openpype/modules/shotgrid/lib/tools.py
deleted file mode 100644
index 6305e9ca50..0000000000
--- a/openpype/modules/shotgrid/lib/tools.py
+++ /dev/null
@@ -1,16 +0,0 @@
-from functools import wraps
-
-
-def memoize(function):
-    memo = {}
-
-    @wraps(function)
-    def wrapper(*args):
-        try:
-            return memo[args]
-        except KeyError:
-            rv = function(*args)
-            memo[args] = rv
-            return rv
-
-    return wrapper
diff --git a/poetry.lock b/poetry.lock
index 04be8c78f2..9ae486d59a 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -94,7 +94,7 @@ python-dateutil = ">=2.7.0"
 
 [[package]]
 name = "astroid"
-version = "2.11.5"
+version = "2.9.3"
 description = "An abstract syntax tree for Python with inference support."
 category = "dev"
 optional = false
@@ -104,7 +104,7 @@ python-versions = ">=3.6.2"
 lazy-object-proxy = ">=1.4.0"
 typed-ast = {version = ">=1.4.0,<2.0", markers = "implementation_name == \"cpython\" and python_version < \"3.8\""}
 typing-extensions = {version = ">=3.10", markers = "python_version < \"3.10\""}
-wrapt = ">=1.11,<2"
+wrapt = ">=1.11,<1.14"
 
 [[package]]
 name = "async-timeout"
@@ -172,7 +172,7 @@ pytz = ">=2015.7"
 
 [[package]]
 name = "bcrypt"
-version = "3.2.2"
+version = "3.2.0"
 description = "Modern password hashing for your software and your servers"
 category = "main"
 optional = false
@@ -180,6 +180,7 @@ python-versions = ">=3.6"
 
 [package.dependencies]
 cffi = ">=1.1"
+six = ">=1.4.1"
 
 [package.extras]
 tests = ["pytest (>=3.2.1,!=3.3.0)"]
@@ -200,7 +201,7 @@ wcwidth = ">=0.1.4"
 
 [[package]]
 name = "cachetools"
-version = "5.2.0"
+version = "5.0.0"
 description = "Extensible memoizing collections and decorators"
 category = "main"
 optional = false
@@ -208,11 +209,11 @@ python-versions = "~=3.7"
 
 [[package]]
 name = "certifi"
-version = "2022.5.18.1"
+version = "2021.10.8"
 description = "Python package for providing Mozilla's CA Bundle."
 category = "main"
 optional = false
-python-versions = ">=3.6"
+python-versions = "*"
 
 [[package]]
 name = "cffi"
@@ -225,9 +226,17 @@ python-versions = "*"
 [package.dependencies]
 pycparser = "*"
 
+[[package]]
+name = "chardet"
+version = "4.0.0"
+description = "Universal encoding detector for Python 2 and 3"
+category = "main"
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
+
 [[package]]
 name = "charset-normalizer"
-version = "2.0.12"
+version = "2.0.11"
 description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet."
 category = "main"
 optional = false
@@ -286,21 +295,21 @@ python-versions = "*"
 
 [[package]]
 name = "coverage"
-version = "6.4.1"
+version = "6.3.1"
 description = "Code coverage measurement for Python"
 category = "dev"
 optional = false
 python-versions = ">=3.7"
 
 [package.dependencies]
-tomli = {version = "*", optional = true, markers = "python_full_version <= \"3.11.0a6\" and extra == \"toml\""}
+tomli = {version = "*", optional = true, markers = "extra == \"toml\""}
 
 [package.extras]
 toml = ["tomli"]
 
 [[package]]
 name = "cryptography"
-version = "37.0.2"
+version = "36.0.1"
 description = "cryptography is a package which provides cryptographic recipes and primitives to Python developers."
 category = "main"
 optional = false
@@ -315,7 +324,7 @@ docstest = ["pyenchant (>=1.6.11)", "twine (>=1.12.0)", "sphinxcontrib-spelling
 pep8test = ["black", "flake8", "flake8-import-order", "pep8-naming"]
 sdist = ["setuptools_rust (>=0.11.4)"]
 ssh = ["bcrypt (>=3.1.5)"]
-test = ["pytest (>=6.2.0)", "pytest-benchmark", "pytest-cov", "pytest-subtests", "pytest-xdist", "pretend", "iso8601", "pytz", "hypothesis (>=1.11.4,!=3.79.2)"]
+test = ["pytest (>=6.2.0)", "pytest-cov", "pytest-subtests", "pytest-xdist", "pretend", "iso8601", "pytz", "hypothesis (>=1.11.4,!=3.79.2)"]
 
 [[package]]
 name = "cx-freeze"
@@ -337,34 +346,9 @@ category = "dev"
 optional = false
 python-versions = "*"
 
-[[package]]
-name = "deprecated"
-version = "1.2.13"
-description = "Python @deprecated decorator to deprecate old python classes, functions or methods."
-category = "main"
-optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
-
-[package.dependencies]
-wrapt = ">=1.10,<2"
-
-[package.extras]
-dev = ["tox", "bump2version (<1)", "sphinx (<2)", "importlib-metadata (<3)", "importlib-resources (<4)", "configparser (<5)", "sphinxcontrib-websupport (<2)", "zipp (<2)", "PyTest (<5)", "PyTest-Cov (<2.6)", "pytest", "pytest-cov"]
-
-[[package]]
-name = "dill"
-version = "0.3.5.1"
-description = "serialize all of python"
-category = "dev"
-optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, !=3.6.*"
-
-[package.extras]
-graph = ["objgraph (>=1.7.2)"]
-
 [[package]]
 name = "dnspython"
-version = "2.2.1"
+version = "2.2.0"
 description = "DNS toolkit"
 category = "main"
 optional = false
@@ -380,7 +364,7 @@ wmi = ["wmi (>=1.5.1,<2.0.0)"]
 
 [[package]]
 name = "docutils"
-version = "0.17.1"
+version = "0.18.1"
 description = "Docutils -- Python Documentation Utilities"
 category = "dev"
 optional = false
@@ -388,7 +372,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
 
 [[package]]
 name = "dropbox"
-version = "11.31.0"
+version = "11.26.0"
 description = "Official Dropbox API Client"
 category = "main"
 optional = false
@@ -413,7 +397,7 @@ prefixed = ">=0.3.2"
 
 [[package]]
 name = "evdev"
-version = "1.5.0"
+version = "1.4.0"
 description = "Bindings to the Linux input handling subsystem"
 category = "main"
 optional = false
@@ -467,23 +451,6 @@ category = "main"
 optional = false
 python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*"
 
-[[package]]
-name = "gazu"
-version = "0.8.28"
-description = "Gazu is a client for Zou, the API to store the data of your CG production."
-category = "main"
-optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
-
-[package.dependencies]
-deprecated = "1.2.13"
-python-socketio = {version = "4.6.1", extras = ["client"], markers = "python_version >= \"3.5\""}
-requests = ">=2.25.1,<=2.27.1"
-
-[package.extras]
-dev = ["wheel"]
-test = ["pytest-cov (==2.12.1)", "requests-mock (==1.9.3)", "pytest (==4.6.11)", "pytest (==6.1.2)", "pytest (==6.2.5)", "black (==21.12b0)", "pre-commit (==2.17.0)"]
-
 [[package]]
 name = "gitdb"
 version = "4.0.9"
@@ -497,7 +464,7 @@ smmap = ">=3.0.1,<6"
 
 [[package]]
 name = "gitpython"
-version = "3.1.27"
+version = "3.1.26"
 description = "GitPython is a python library used to interact with Git repositories"
 category = "dev"
 optional = false
@@ -509,7 +476,7 @@ typing-extensions = {version = ">=3.7.4.3", markers = "python_version < \"3.8\""
 
 [[package]]
 name = "google-api-core"
-version = "2.8.1"
+version = "2.4.0"
 description = "Google API client core library"
 category = "main"
 optional = false
@@ -517,18 +484,18 @@ python-versions = ">=3.6"
 
 [package.dependencies]
 google-auth = ">=1.25.0,<3.0dev"
-googleapis-common-protos = ">=1.56.2,<2.0dev"
-protobuf = ">=3.15.0,<4.0.0dev"
+googleapis-common-protos = ">=1.52.0,<2.0dev"
+protobuf = ">=3.12.0"
 requests = ">=2.18.0,<3.0.0dev"
 
 [package.extras]
 grpc = ["grpcio (>=1.33.2,<2.0dev)", "grpcio-status (>=1.33.2,<2.0dev)"]
-grpcgcp = ["grpcio-gcp (>=0.2.2,<1.0dev)"]
-grpcio-gcp = ["grpcio-gcp (>=0.2.2,<1.0dev)"]
+grpcgcp = ["grpcio-gcp (>=0.2.2)"]
+grpcio-gcp = ["grpcio-gcp (>=0.2.2)"]
 
 [[package]]
 name = "google-api-python-client"
-version = "1.12.11"
+version = "1.12.10"
 description = "Google API Client Library for Python"
 category = "main"
 optional = false
@@ -544,7 +511,7 @@ uritemplate = ">=3.0.0,<4dev"
 
 [[package]]
 name = "google-auth"
-version = "2.7.0"
+version = "2.6.0"
 description = "Google Authentication Library"
 category = "main"
 optional = false
@@ -558,7 +525,6 @@ six = ">=1.9.0"
 
 [package.extras]
 aiohttp = ["requests (>=2.20.0,<3.0.0dev)", "aiohttp (>=3.6.2,<4.0.0dev)"]
-enterprise_cert = ["cryptography (==36.0.2)", "pyopenssl (==22.0.0)"]
 pyopenssl = ["pyopenssl (>=20.0.0)"]
 reauth = ["pyu2f (>=0.1.5)"]
 
@@ -577,21 +543,21 @@ six = "*"
 
 [[package]]
 name = "googleapis-common-protos"
-version = "1.56.2"
+version = "1.54.0"
 description = "Common protobufs used in Google APIs"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-protobuf = ">=3.15.0,<4.0.0dev"
+protobuf = ">=3.12.0"
 
 [package.extras]
-grpc = ["grpcio (>=1.0.0,<2.0.0dev)"]
+grpc = ["grpcio (>=1.0.0)"]
 
 [[package]]
 name = "httplib2"
-version = "0.20.4"
+version = "0.20.2"
 description = "A comprehensive HTTP client library."
 category = "main"
 optional = false
@@ -602,11 +568,11 @@ pyparsing = {version = ">=2.4.2,<3.0.0 || >3.0.0,<3.0.1 || >3.0.1,<3.0.2 || >3.0
 
 [[package]]
 name = "idna"
-version = "3.3"
+version = "2.10"
 description = "Internationalized Domain Names in Applications (IDNA)"
 category = "main"
 optional = false
-python-versions = ">=3.5"
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "imagesize"
@@ -618,7 +584,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "importlib-metadata"
-version = "4.11.4"
+version = "4.10.1"
 description = "Read metadata from Python packages"
 category = "main"
 optional = false
@@ -629,9 +595,9 @@ typing-extensions = {version = ">=3.6.4", markers = "python_version < \"3.8\""}
 zipp = ">=0.5"
 
 [package.extras]
-docs = ["sphinx", "jaraco.packaging (>=9)", "rst.linker (>=1.9)"]
+docs = ["sphinx", "jaraco.packaging (>=8.2)", "rst.linker (>=1.9)"]
 perf = ["ipython"]
-testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "packaging", "pyfakefs", "flufl.flake8", "pytest-perf (>=0.9.2)", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)", "importlib-resources (>=1.3)"]
+testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "packaging", "pyfakefs", "flufl.flake8", "pytest-perf (>=0.9.2)", "pytest-black (>=0.3.7)", "pytest-mypy", "importlib-resources (>=1.3)"]
 
 [[package]]
 name = "iniconfig"
@@ -671,14 +637,14 @@ testing = ["colorama", "docopt", "pytest (>=3.1.0)"]
 
 [[package]]
 name = "jeepney"
-version = "0.8.0"
+version = "0.7.1"
 description = "Low-level, pure Python DBus protocol wrapper."
 category = "main"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.6"
 
 [package.extras]
-test = ["pytest", "pytest-trio", "pytest-asyncio (>=0.17)", "testpath", "trio", "async-timeout"]
+test = ["pytest", "pytest-trio", "pytest-asyncio", "testpath", "trio", "async-timeout"]
 trio = ["trio", "async-generator"]
 
 [[package]]
@@ -697,7 +663,7 @@ i18n = ["Babel (>=0.8)"]
 
 [[package]]
 name = "jinxed"
-version = "1.2.0"
+version = "1.1.0"
 description = "Jinxed Terminal Library"
 category = "main"
 optional = false
@@ -756,11 +722,11 @@ pymongo = "*"
 
 [[package]]
 name = "markupsafe"
-version = "2.1.1"
+version = "2.0.1"
 description = "Safely add untrusted strings to HTML/XML markup."
 category = "dev"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.6"
 
 [[package]]
 name = "mccabe"
@@ -811,7 +777,7 @@ pyparsing = ">=2.0.2,<3.0.5 || >3.0.5"
 
 [[package]]
 name = "paramiko"
-version = "2.11.0"
+version = "2.10.1"
 description = "SSH2 protocol library"
 category = "main"
 optional = false
@@ -843,7 +809,7 @@ testing = ["docopt", "pytest (<6.0.0)"]
 
 [[package]]
 name = "pathlib2"
-version = "2.3.7.post1"
+version = "2.3.6"
 description = "Object-oriented filesystem paths"
 category = "main"
 optional = false
@@ -854,27 +820,23 @@ six = "*"
 
 [[package]]
 name = "pillow"
-version = "9.1.1"
+version = "9.0.1"
 description = "Python Imaging Library (Fork)"
 category = "main"
 optional = false
 python-versions = ">=3.7"
 
-[package.extras]
-docs = ["olefile", "sphinx (>=2.4)", "sphinx-copybutton", "sphinx-issues (>=3.0.1)", "sphinx-removed-in", "sphinx-rtd-theme (>=1.0)", "sphinxext-opengraph"]
-tests = ["check-manifest", "coverage", "defusedxml", "markdown2", "olefile", "packaging", "pyroma", "pytest", "pytest-cov", "pytest-timeout"]
-
 [[package]]
 name = "platformdirs"
-version = "2.5.2"
+version = "2.4.1"
 description = "A small Python module for determining appropriate platform-specific dirs, e.g. a \"user data dir\"."
 category = "dev"
 optional = false
 python-versions = ">=3.7"
 
 [package.extras]
-docs = ["furo (>=2021.7.5b38)", "proselint (>=0.10.2)", "sphinx-autodoc-typehints (>=1.12)", "sphinx (>=4)"]
-test = ["appdirs (==1.4.4)", "pytest-cov (>=2.7)", "pytest-mock (>=3.6)", "pytest (>=6)"]
+docs = ["Sphinx (>=4)", "furo (>=2021.7.5b38)", "proselint (>=0.10.2)", "sphinx-autodoc-typehints (>=1.12)"]
+test = ["appdirs (==1.4.4)", "pytest (>=6)", "pytest-cov (>=2.7)", "pytest-mock (>=3.6)"]
 
 [[package]]
 name = "pluggy"
@@ -913,7 +875,7 @@ version = "3.20.0"
 description = "Protocol Buffers"
 category = "main"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.5"
 
 [[package]]
 name = "py"
@@ -996,33 +958,29 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "pygments"
-version = "2.12.0"
+version = "2.11.2"
 description = "Pygments is a syntax highlighting package written in Python."
 category = "dev"
 optional = false
-python-versions = ">=3.6"
+python-versions = ">=3.5"
 
 [[package]]
 name = "pylint"
-version = "2.13.9"
+version = "2.12.2"
 description = "python code static checker"
 category = "dev"
 optional = false
 python-versions = ">=3.6.2"
 
 [package.dependencies]
-astroid = ">=2.11.5,<=2.12.0-dev0"
+astroid = ">=2.9.0,<2.10"
 colorama = {version = "*", markers = "sys_platform == \"win32\""}
-dill = ">=0.2"
 isort = ">=4.2.5,<6"
-mccabe = ">=0.6,<0.8"
+mccabe = ">=0.6,<0.7"
 platformdirs = ">=2.2.0"
-tomli = {version = ">=1.1.0", markers = "python_version < \"3.11\""}
+toml = ">=0.9.2"
 typing-extensions = {version = ">=3.10.0", markers = "python_version < \"3.10\""}
 
-[package.extras]
-testutil = ["gitpython (>3)"]
-
 [[package]]
 name = "pymongo"
 version = "3.12.3"
@@ -1073,7 +1031,7 @@ six = "*"
 
 [[package]]
 name = "pyobjc-core"
-version = "8.5"
+version = "8.2"
 description = "Python<->ObjC Interoperability Module"
 category = "main"
 optional = false
@@ -1081,39 +1039,39 @@ python-versions = ">=3.6"
 
 [[package]]
 name = "pyobjc-framework-applicationservices"
-version = "8.5"
+version = "8.2"
 description = "Wrappers for the framework ApplicationServices on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.5"
-pyobjc-framework-Cocoa = ">=8.5"
-pyobjc-framework-Quartz = ">=8.5"
+pyobjc-core = ">=8.2"
+pyobjc-framework-Cocoa = ">=8.2"
+pyobjc-framework-Quartz = ">=8.2"
 
 [[package]]
 name = "pyobjc-framework-cocoa"
-version = "8.5"
+version = "8.2"
 description = "Wrappers for the Cocoa frameworks on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.5"
+pyobjc-core = ">=8.2"
 
 [[package]]
 name = "pyobjc-framework-quartz"
-version = "8.5"
+version = "8.2"
 description = "Wrappers for the Quartz frameworks on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.5"
-pyobjc-framework-Cocoa = ">=8.5"
+pyobjc-core = ">=8.2"
+pyobjc-framework-Cocoa = ">=8.2"
 
 [[package]]
 name = "pyparsing"
@@ -1196,39 +1154,6 @@ python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7"
 [package.dependencies]
 six = ">=1.5"
 
-[[package]]
-name = "python-engineio"
-version = "3.14.2"
-description = "Engine.IO server"
-category = "main"
-optional = false
-python-versions = "*"
-
-[package.dependencies]
-six = ">=1.9.0"
-
-[package.extras]
-asyncio_client = ["aiohttp (>=3.4)"]
-client = ["requests (>=2.21.0)", "websocket-client (>=0.54.0)"]
-
-[[package]]
-name = "python-socketio"
-version = "4.6.1"
-description = "Socket.IO server"
-category = "main"
-optional = false
-python-versions = "*"
-
-[package.dependencies]
-python-engineio = ">=3.13.0,<4"
-requests = {version = ">=2.21.0", optional = true, markers = "extra == \"client\""}
-six = ">=1.9.0"
-websocket-client = {version = ">=0.54.0", optional = true, markers = "extra == \"client\""}
-
-[package.extras]
-asyncio_client = ["aiohttp (>=3.4)", "websockets (>=7.0)"]
-client = ["requests (>=2.21.0)", "websocket-client (>=0.54.0)"]
-
 [[package]]
 name = "python-xlib"
 version = "0.31"
@@ -1250,7 +1175,7 @@ python-versions = "*"
 
 [[package]]
 name = "pytz"
-version = "2022.1"
+version = "2021.3"
 description = "World timezone definitions, modern and historical"
 category = "dev"
 optional = false
@@ -1274,7 +1199,7 @@ python-versions = "*"
 
 [[package]]
 name = "qt.py"
-version = "1.3.7"
+version = "1.3.6"
 description = "Python 2 & 3 compatibility wrapper around all Qt bindings - PySide, PySide2, PyQt4 and PyQt5."
 category = "main"
 optional = false
@@ -1315,21 +1240,21 @@ sphinx = ">=1.3.1"
 
 [[package]]
 name = "requests"
-version = "2.27.1"
+version = "2.25.1"
 description = "Python HTTP for Humans."
 category = "main"
 optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*"
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
 
 [package.dependencies]
 certifi = ">=2017.4.17"
-charset-normalizer = {version = ">=2.0.0,<2.1.0", markers = "python_version >= \"3\""}
-idna = {version = ">=2.5,<4", markers = "python_version >= \"3\""}
+chardet = ">=3.0.2,<5"
+idna = ">=2.5,<3"
 urllib3 = ">=1.21.1,<1.27"
 
 [package.extras]
+security = ["pyOpenSSL (>=0.14)", "cryptography (>=1.3.4)"]
 socks = ["PySocks (>=1.5.6,!=1.5.7)", "win-inet-pton"]
-use_chardet_on_py3 = ["chardet (>=3.0.2,<5)"]
 
 [[package]]
 name = "rsa"
@@ -1344,7 +1269,7 @@ pyasn1 = ">=0.1.3"
 
 [[package]]
 name = "secretstorage"
-version = "3.3.2"
+version = "3.3.1"
 description = "Python bindings to FreeDesktop.org Secret Service API"
 category = "main"
 optional = false
@@ -1362,21 +1287,6 @@ category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
-[[package]]
-name = "shotgun-api3"
-version = "3.3.3"
-description = "Shotgun Python API"
-category = "main"
-optional = false
-python-versions = "*"
-develop = false
-
-[package.source]
-type = "git"
-url = "https://github.com/shotgunsoftware/python-api.git"
-reference = "v3.3.3"
-resolved_reference = "b9f066c0edbea6e0733242e18f32f75489064840"
-
 [[package]]
 name = "six"
 version = "1.16.0"
@@ -1387,7 +1297,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*"
 
 [[package]]
 name = "slack-sdk"
-version = "3.17.0"
+version = "3.13.0"
 description = "The Slack API Platform SDK for Python"
 category = "main"
 optional = false
@@ -1395,7 +1305,7 @@ python-versions = ">=3.6.0"
 
 [package.extras]
 optional = ["aiodns (>1.0)", "aiohttp (>=3.7.3,<4)", "boto3 (<=2)", "SQLAlchemy (>=1,<2)", "websockets (>=10,<11)", "websocket-client (>=1,<2)"]
-testing = ["pytest (>=6.2.5,<7)", "pytest-asyncio (<1)", "Flask-Sockets (>=0.2,<1)", "Flask (>=1,<2)", "Werkzeug (<2)", "itsdangerous (==1.1.0)", "Jinja2 (==3.0.3)", "pytest-cov (>=2,<3)", "codecov (>=2,<3)", "flake8 (>=4,<5)", "black (==22.3.0)", "click (==8.0.4)", "psutil (>=5,<6)", "databases (>=0.5)", "boto3 (<=2)", "moto (>=3,<4)"]
+testing = ["pytest (>=6.2.5,<7)", "pytest-asyncio (<1)", "Flask-Sockets (>=0.2,<1)", "Flask (>=1,<2)", "Werkzeug (<2)", "pytest-cov (>=2,<3)", "codecov (>=2,<3)", "flake8 (>=4,<5)", "black (==21.12b0)", "psutil (>=5,<6)", "databases (>=0.3)", "boto3 (<=2)", "moto (<2)"]
 
 [[package]]
 name = "smmap"
@@ -1415,7 +1325,7 @@ python-versions = "*"
 
 [[package]]
 name = "speedcopy"
-version = "2.1.4"
+version = "2.1.2"
 description = "Replacement or alternative for python copyfile() utilizing server side copy on network shares for faster copying."
 category = "main"
 optional = false
@@ -1423,19 +1333,18 @@ python-versions = "*"
 
 [[package]]
 name = "sphinx"
-version = "5.0.1"
+version = "3.5.3"
 description = "Python documentation generator"
 category = "dev"
 optional = false
-python-versions = ">=3.6"
+python-versions = ">=3.5"
 
 [package.dependencies]
 alabaster = ">=0.7,<0.8"
 babel = ">=1.3"
 colorama = {version = ">=0.3.5", markers = "sys_platform == \"win32\""}
-docutils = ">=0.14,<0.19"
+docutils = ">=0.12"
 imagesize = "*"
-importlib-metadata = {version = ">=4.4", markers = "python_version < \"3.10\""}
 Jinja2 = ">=2.3"
 packaging = "*"
 Pygments = ">=2.0"
@@ -1443,19 +1352,19 @@ requests = ">=2.5.0"
 snowballstemmer = ">=1.1"
 sphinxcontrib-applehelp = "*"
 sphinxcontrib-devhelp = "*"
-sphinxcontrib-htmlhelp = ">=2.0.0"
+sphinxcontrib-htmlhelp = "*"
 sphinxcontrib-jsmath = "*"
 sphinxcontrib-qthelp = "*"
-sphinxcontrib-serializinghtml = ">=1.1.5"
+sphinxcontrib-serializinghtml = "*"
 
 [package.extras]
 docs = ["sphinxcontrib-websupport"]
-lint = ["flake8 (>=3.5.0)", "isort", "mypy (>=0.950)", "docutils-stubs", "types-typed-ast", "types-requests"]
-test = ["pytest (>=4.6)", "html5lib", "cython", "typed-ast"]
+lint = ["flake8 (>=3.5.0)", "isort", "mypy (>=0.800)", "docutils-stubs"]
+test = ["pytest", "pytest-cov", "html5lib", "cython", "typed-ast"]
 
 [[package]]
 name = "sphinx-qt-documentation"
-version = "0.4"
+version = "0.3"
 description = "Plugin for proper resolve intersphinx references for Qt elements"
 category = "dev"
 optional = false
@@ -1465,22 +1374,16 @@ python-versions = ">=3.6"
 docutils = "*"
 sphinx = "*"
 
-[package.extras]
-dev = ["pre-commit"]
-lint = ["black", "flake8", "pylint"]
-test = ["pytest (>=3.0.0)", "pytest-cov"]
-
 [[package]]
 name = "sphinx-rtd-theme"
-version = "1.0.0"
+version = "0.5.1"
 description = "Read the Docs theme for Sphinx"
 category = "dev"
 optional = false
-python-versions = ">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*"
+python-versions = "*"
 
 [package.dependencies]
-docutils = "<0.18"
-sphinx = ">=1.6"
+sphinx = "*"
 
 [package.extras]
 dev = ["transifex-client", "sphinxcontrib-httpdomain", "bump2version"]
@@ -1601,7 +1504,7 @@ python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*"
 
 [[package]]
 name = "tomli"
-version = "2.0.1"
+version = "2.0.0"
 description = "A lil' TOML parser"
 category = "dev"
 optional = false
@@ -1609,7 +1512,7 @@ python-versions = ">=3.7"
 
 [[package]]
 name = "typed-ast"
-version = "1.5.4"
+version = "1.5.2"
 description = "a fork of Python 2 and 3 ast modules with type comment support"
 category = "dev"
 optional = false
@@ -1633,14 +1536,14 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "urllib3"
-version = "1.26.9"
+version = "1.26.8"
 description = "HTTP library with thread-safe connection pooling, file post, and more."
 category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, <4"
 
 [package.extras]
-brotli = ["brotlicffi (>=0.8.0)", "brotli (>=1.0.9)", "brotlipy (>=0.6.0)"]
+brotli = ["brotlipy (>=0.6.0)"]
 secure = ["pyOpenSSL (>=0.14)", "cryptography (>=1.3.4)", "idna (>=2.0.0)", "certifi", "ipaddress"]
 socks = ["PySocks (>=1.5.6,!=1.5.7,<2.0)"]
 
@@ -1665,9 +1568,9 @@ six = "*"
 
 [[package]]
 name = "wrapt"
-version = "1.14.1"
+version = "1.13.3"
 description = "Module for decorators, wrappers and monkey patching."
-category = "main"
+category = "dev"
 optional = false
 python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7"
 
@@ -1703,15 +1606,15 @@ typing-extensions = {version = ">=3.7.4", markers = "python_version < \"3.8\""}
 
 [[package]]
 name = "zipp"
-version = "3.8.0"
+version = "3.7.0"
 description = "Backport of pathlib-compatible object wrapper for zip files"
 category = "main"
 optional = false
 python-versions = ">=3.7"
 
 [package.extras]
-docs = ["sphinx", "jaraco.packaging (>=9)", "rst.linker (>=1.9)"]
-testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "jaraco.itertools", "func-timeout", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)"]
+docs = ["sphinx", "jaraco.packaging (>=8.2)", "rst.linker (>=1.9)"]
+testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "jaraco.itertools", "func-timeout", "pytest-black (>=0.3.7)", "pytest-mypy"]
 
 [metadata]
 lock-version = "1.1"
@@ -1819,8 +1722,8 @@ arrow = [
     {file = "arrow-0.17.0.tar.gz", hash = "sha256:ff08d10cda1d36c68657d6ad20d74fbea493d980f8b2d45344e00d6ed2bf6ed4"},
 ]
 astroid = [
-    {file = "astroid-2.11.5-py3-none-any.whl", hash = "sha256:14ffbb4f6aa2cf474a0834014005487f7ecd8924996083ab411e7fa0b508ce0b"},
-    {file = "astroid-2.11.5.tar.gz", hash = "sha256:f4e4ec5294c4b07ac38bab9ca5ddd3914d4bf46f9006eb5c0ae755755061044e"},
+    {file = "astroid-2.9.3-py3-none-any.whl", hash = "sha256:506daabe5edffb7e696ad82483ad0228245a9742ed7d2d8c9cdb31537decf9f6"},
+    {file = "astroid-2.9.3.tar.gz", hash = "sha256:1efdf4e867d4d8ba4a9f6cf9ce07cd182c4c41de77f23814feb27ca93ca9d877"},
 ]
 async-timeout = [
     {file = "async-timeout-4.0.2.tar.gz", hash = "sha256:2163e1640ddb52b7a8c80d0a67a08587e5d245cc9c553a74a847056bc2976b15"},
@@ -1847,29 +1750,28 @@ babel = [
     {file = "Babel-2.9.1.tar.gz", hash = "sha256:bc0c176f9f6a994582230df350aa6e05ba2ebe4b3ac317eab29d9be5d2768da0"},
 ]
 bcrypt = [
-    {file = "bcrypt-3.2.2-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:7180d98a96f00b1050e93f5b0f556e658605dd9f524d0b0e68ae7944673f525e"},
-    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:61bae49580dce88095d669226d5076d0b9d927754cedbdf76c6c9f5099ad6f26"},
-    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:88273d806ab3a50d06bc6a2fc7c87d737dd669b76ad955f449c43095389bc8fb"},
-    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:6d2cb9d969bfca5bc08e45864137276e4c3d3d7de2b162171def3d188bf9d34a"},
-    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2b02d6bfc6336d1094276f3f588aa1225a598e27f8e3388f4db9948cb707b521"},
-    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:a2c46100e315c3a5b90fdc53e429c006c5f962529bc27e1dfd656292c20ccc40"},
-    {file = "bcrypt-3.2.2-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:7d9ba2e41e330d2af4af6b1b6ec9e6128e91343d0b4afb9282e54e5508f31baa"},
-    {file = "bcrypt-3.2.2-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:cd43303d6b8a165c29ec6756afd169faba9396a9472cdff753fe9f19b96ce2fa"},
-    {file = "bcrypt-3.2.2-cp36-abi3-win32.whl", hash = "sha256:4e029cef560967fb0cf4a802bcf4d562d3d6b4b1bf81de5ec1abbe0f1adb027e"},
-    {file = "bcrypt-3.2.2-cp36-abi3-win_amd64.whl", hash = "sha256:7ff2069240c6bbe49109fe84ca80508773a904f5a8cb960e02a977f7f519b129"},
-    {file = "bcrypt-3.2.2.tar.gz", hash = "sha256:433c410c2177057705da2a9f2cd01dd157493b2a7ac14c8593a16b3dab6b6bfb"},
+    {file = "bcrypt-3.2.0-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:b589229207630484aefe5899122fb938a5b017b0f4349f769b8c13e78d99a8fd"},
+    {file = "bcrypt-3.2.0-cp36-abi3-macosx_10_9_x86_64.whl", hash = "sha256:c95d4cbebffafcdd28bd28bb4e25b31c50f6da605c81ffd9ad8a3d1b2ab7b1b6"},
+    {file = "bcrypt-3.2.0-cp36-abi3-manylinux1_x86_64.whl", hash = "sha256:63d4e3ff96188e5898779b6057878fecf3f11cfe6ec3b313ea09955d587ec7a7"},
+    {file = "bcrypt-3.2.0-cp36-abi3-manylinux2010_x86_64.whl", hash = "sha256:cd1ea2ff3038509ea95f687256c46b79f5fc382ad0aa3664d200047546d511d1"},
+    {file = "bcrypt-3.2.0-cp36-abi3-manylinux2014_aarch64.whl", hash = "sha256:cdcdcb3972027f83fe24a48b1e90ea4b584d35f1cc279d76de6fc4b13376239d"},
+    {file = "bcrypt-3.2.0-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:a0584a92329210fcd75eb8a3250c5a941633f8bfaf2a18f81009b097732839b7"},
+    {file = "bcrypt-3.2.0-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:56e5da069a76470679f312a7d3d23deb3ac4519991a0361abc11da837087b61d"},
+    {file = "bcrypt-3.2.0-cp36-abi3-win32.whl", hash = "sha256:a67fb841b35c28a59cebed05fbd3e80eea26e6d75851f0574a9273c80f3e9b55"},
+    {file = "bcrypt-3.2.0-cp36-abi3-win_amd64.whl", hash = "sha256:81fec756feff5b6818ea7ab031205e1d323d8943d237303baca2c5f9c7846f34"},
+    {file = "bcrypt-3.2.0.tar.gz", hash = "sha256:5b93c1726e50a93a033c36e5ca7fdcd29a5c7395af50a6892f5d9e7c6cfbfb29"},
 ]
 blessed = [
     {file = "blessed-1.19.1-py2.py3-none-any.whl", hash = "sha256:63b8554ae2e0e7f43749b6715c734cc8f3883010a809bf16790102563e6cf25b"},
     {file = "blessed-1.19.1.tar.gz", hash = "sha256:9a0d099695bf621d4680dd6c73f6ad547f6a3442fbdbe80c4b1daa1edbc492fc"},
 ]
 cachetools = [
-    {file = "cachetools-5.2.0-py3-none-any.whl", hash = "sha256:f9f17d2aec496a9aa6b76f53e3b614c965223c061982d434d160f930c698a9db"},
-    {file = "cachetools-5.2.0.tar.gz", hash = "sha256:6a94c6402995a99c3970cc7e4884bb60b4a8639938157eeed436098bf9831757"},
+    {file = "cachetools-5.0.0-py3-none-any.whl", hash = "sha256:8fecd4203a38af17928be7b90689d8083603073622229ca7077b72d8e5a976e4"},
+    {file = "cachetools-5.0.0.tar.gz", hash = "sha256:486471dfa8799eb7ec503a8059e263db000cdda20075ce5e48903087f79d5fd6"},
 ]
 certifi = [
-    {file = "certifi-2022.5.18.1-py3-none-any.whl", hash = "sha256:f1d53542ee8cbedbe2118b5686372fb33c297fcd6379b050cca0ef13a597382a"},
-    {file = "certifi-2022.5.18.1.tar.gz", hash = "sha256:9c5705e395cd70084351dd8ad5c41e65655e08ce46f2ec9cf6c2c08390f71eb7"},
+    {file = "certifi-2021.10.8-py2.py3-none-any.whl", hash = "sha256:d62a0163eb4c2344ac042ab2bdf75399a71a2d8c7d47eac2e2ee91b9d6339569"},
+    {file = "certifi-2021.10.8.tar.gz", hash = "sha256:78884e7c1d4b00ce3cea67b44566851c4343c120abd683433ce934a68ea58872"},
 ]
 cffi = [
     {file = "cffi-1.15.0-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:c2502a1a03b6312837279c8c1bd3ebedf6c12c4228ddbad40912d671ccc8a962"},
@@ -1923,9 +1825,13 @@ cffi = [
     {file = "cffi-1.15.0-cp39-cp39-win_amd64.whl", hash = "sha256:3773c4d81e6e818df2efbc7dd77325ca0dcb688116050fb2b3011218eda36139"},
     {file = "cffi-1.15.0.tar.gz", hash = "sha256:920f0d66a896c2d99f0adbb391f990a84091179542c205fa53ce5787aff87954"},
 ]
+chardet = [
+    {file = "chardet-4.0.0-py2.py3-none-any.whl", hash = "sha256:f864054d66fd9118f2e67044ac8981a54775ec5b67aed0441892edb553d21da5"},
+    {file = "chardet-4.0.0.tar.gz", hash = "sha256:0d6f53a15db4120f2b08c94f11e7d93d2c911ee118b6b30a04ec3ee8310179fa"},
+]
 charset-normalizer = [
-    {file = "charset-normalizer-2.0.12.tar.gz", hash = "sha256:2857e29ff0d34db842cd7ca3230549d1a697f96ee6d3fb071cfa6c7393832597"},
-    {file = "charset_normalizer-2.0.12-py3-none-any.whl", hash = "sha256:6881edbebdb17b39b4eaaa821b438bf6eddffb4468cf344f09f89def34a8b1df"},
+    {file = "charset-normalizer-2.0.11.tar.gz", hash = "sha256:98398a9d69ee80548c762ba991a4728bfc3836768ed226b3945908d1a688371c"},
+    {file = "charset_normalizer-2.0.11-py3-none-any.whl", hash = "sha256:2842d8f5e82a1f6aa437380934d5e1cd4fcf2003b06fed6940769c164a480a45"},
 ]
 click = [
     {file = "click-7.1.2-py2.py3-none-any.whl", hash = "sha256:dacca89f4bfadd5de3d7489b7c8a566eee0d3676333fbb50030263894c38c0dc"},
@@ -1948,71 +1854,69 @@ coolname = [
     {file = "coolname-1.1.0.tar.gz", hash = "sha256:410fe6ea9999bf96f2856ef0c726d5f38782bbefb7bb1aca0e91e0dc98ed09e3"},
 ]
 coverage = [
-    {file = "coverage-6.4.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:f1d5aa2703e1dab4ae6cf416eb0095304f49d004c39e9db1d86f57924f43006b"},
-    {file = "coverage-6.4.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:4ce1b258493cbf8aec43e9b50d89982346b98e9ffdfaae8ae5793bc112fb0068"},
-    {file = "coverage-6.4.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:83c4e737f60c6936460c5be330d296dd5b48b3963f48634c53b3f7deb0f34ec4"},
-    {file = "coverage-6.4.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:84e65ef149028516c6d64461b95a8dbcfce95cfd5b9eb634320596173332ea84"},
-    {file = "coverage-6.4.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f69718750eaae75efe506406c490d6fc5a6161d047206cc63ce25527e8a3adad"},
-    {file = "coverage-6.4.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:e57816f8ffe46b1df8f12e1b348f06d164fd5219beba7d9433ba79608ef011cc"},
-    {file = "coverage-6.4.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:01c5615d13f3dd3aa8543afc069e5319cfa0c7d712f6e04b920431e5c564a749"},
-    {file = "coverage-6.4.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:75ab269400706fab15981fd4bd5080c56bd5cc07c3bccb86aab5e1d5a88dc8f4"},
-    {file = "coverage-6.4.1-cp310-cp310-win32.whl", hash = "sha256:a7f3049243783df2e6cc6deafc49ea123522b59f464831476d3d1448e30d72df"},
-    {file = "coverage-6.4.1-cp310-cp310-win_amd64.whl", hash = "sha256:ee2ddcac99b2d2aec413e36d7a429ae9ebcadf912946b13ffa88e7d4c9b712d6"},
-    {file = "coverage-6.4.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:fb73e0011b8793c053bfa85e53129ba5f0250fdc0392c1591fd35d915ec75c46"},
-    {file = "coverage-6.4.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:106c16dfe494de3193ec55cac9640dd039b66e196e4641fa8ac396181578b982"},
-    {file = "coverage-6.4.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:87f4f3df85aa39da00fd3ec4b5abeb7407e82b68c7c5ad181308b0e2526da5d4"},
-    {file = "coverage-6.4.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:961e2fb0680b4f5ad63234e0bf55dfb90d302740ae9c7ed0120677a94a1590cb"},
-    {file = "coverage-6.4.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:cec3a0f75c8f1031825e19cd86ee787e87cf03e4fd2865c79c057092e69e3a3b"},
-    {file = "coverage-6.4.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:129cd05ba6f0d08a766d942a9ed4b29283aff7b2cccf5b7ce279d50796860bb3"},
-    {file = "coverage-6.4.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:bf5601c33213d3cb19d17a796f8a14a9eaa5e87629a53979a5981e3e3ae166f6"},
-    {file = "coverage-6.4.1-cp37-cp37m-win32.whl", hash = "sha256:269eaa2c20a13a5bf17558d4dc91a8d078c4fa1872f25303dddcbba3a813085e"},
-    {file = "coverage-6.4.1-cp37-cp37m-win_amd64.whl", hash = "sha256:f02cbbf8119db68455b9d763f2f8737bb7db7e43720afa07d8eb1604e5c5ae28"},
-    {file = "coverage-6.4.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:ffa9297c3a453fba4717d06df579af42ab9a28022444cae7fa605af4df612d54"},
-    {file = "coverage-6.4.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:145f296d00441ca703a659e8f3eb48ae39fb083baba2d7ce4482fb2723e050d9"},
-    {file = "coverage-6.4.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d67d44996140af8b84284e5e7d398e589574b376fb4de8ccd28d82ad8e3bea13"},
-    {file = "coverage-6.4.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2bd9a6fc18aab8d2e18f89b7ff91c0f34ff4d5e0ba0b33e989b3cd4194c81fd9"},
-    {file = "coverage-6.4.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3384f2a3652cef289e38100f2d037956194a837221edd520a7ee5b42d00cc605"},
-    {file = "coverage-6.4.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:9b3e07152b4563722be523e8cd0b209e0d1a373022cfbde395ebb6575bf6790d"},
-    {file = "coverage-6.4.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:1480ff858b4113db2718848d7b2d1b75bc79895a9c22e76a221b9d8d62496428"},
-    {file = "coverage-6.4.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:865d69ae811a392f4d06bde506d531f6a28a00af36f5c8649684a9e5e4a85c83"},
-    {file = "coverage-6.4.1-cp38-cp38-win32.whl", hash = "sha256:664a47ce62fe4bef9e2d2c430306e1428ecea207ffd68649e3b942fa8ea83b0b"},
-    {file = "coverage-6.4.1-cp38-cp38-win_amd64.whl", hash = "sha256:26dff09fb0d82693ba9e6231248641d60ba606150d02ed45110f9ec26404ed1c"},
-    {file = "coverage-6.4.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:d9c80df769f5ec05ad21ea34be7458d1dc51ff1fb4b2219e77fe24edf462d6df"},
-    {file = "coverage-6.4.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:39ee53946bf009788108b4dd2894bf1349b4e0ca18c2016ffa7d26ce46b8f10d"},
-    {file = "coverage-6.4.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f5b66caa62922531059bc5ac04f836860412f7f88d38a476eda0a6f11d4724f4"},
-    {file = "coverage-6.4.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:fd180ed867e289964404051a958f7cccabdeed423f91a899829264bb7974d3d3"},
-    {file = "coverage-6.4.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:84631e81dd053e8a0d4967cedab6db94345f1c36107c71698f746cb2636c63e3"},
-    {file = "coverage-6.4.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:8c08da0bd238f2970230c2a0d28ff0e99961598cb2e810245d7fc5afcf1254e8"},
-    {file = "coverage-6.4.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:d42c549a8f41dc103a8004b9f0c433e2086add8a719da00e246e17cbe4056f72"},
-    {file = "coverage-6.4.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:309ce4a522ed5fca432af4ebe0f32b21d6d7ccbb0f5fcc99290e71feba67c264"},
-    {file = "coverage-6.4.1-cp39-cp39-win32.whl", hash = "sha256:fdb6f7bd51c2d1714cea40718f6149ad9be6a2ee7d93b19e9f00934c0f2a74d9"},
-    {file = "coverage-6.4.1-cp39-cp39-win_amd64.whl", hash = "sha256:342d4aefd1c3e7f620a13f4fe563154d808b69cccef415415aece4c786665397"},
-    {file = "coverage-6.4.1-pp36.pp37.pp38-none-any.whl", hash = "sha256:4803e7ccf93230accb928f3a68f00ffa80a88213af98ed338a57ad021ef06815"},
-    {file = "coverage-6.4.1.tar.gz", hash = "sha256:4321f075095a096e70aff1d002030ee612b65a205a0a0f5b815280d5dc58100c"},
+    {file = "coverage-6.3.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:eeffd96882d8c06d31b65dddcf51db7c612547babc1c4c5db6a011abe9798525"},
+    {file = "coverage-6.3.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:621f6ea7260ea2ffdaec64fe5cb521669984f567b66f62f81445221d4754df4c"},
+    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:84f2436d6742c01136dd940ee158bfc7cf5ced3da7e4c949662b8703b5cd8145"},
+    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:de73fca6fb403dd72d4da517cfc49fcf791f74eee697d3219f6be29adf5af6ce"},
+    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:78fbb2be068a13a5d99dce9e1e7d168db880870f7bc73f876152130575bd6167"},
+    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:f5a4551dfd09c3bd12fca8144d47fe7745275adf3229b7223c2f9e29a975ebda"},
+    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:7bff3a98f63b47464480de1b5bdd80c8fade0ba2832c9381253c9b74c4153c27"},
+    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:a06c358f4aed05fa1099c39decc8022261bb07dfadc127c08cfbd1391b09689e"},
+    {file = "coverage-6.3.1-cp310-cp310-win32.whl", hash = "sha256:9fff3ff052922cb99f9e52f63f985d4f7a54f6b94287463bc66b7cdf3eb41217"},
+    {file = "coverage-6.3.1-cp310-cp310-win_amd64.whl", hash = "sha256:276b13cc085474e482566c477c25ed66a097b44c6e77132f3304ac0b039f83eb"},
+    {file = "coverage-6.3.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:56c4a409381ddd7bbff134e9756077860d4e8a583d310a6f38a2315b9ce301d0"},
+    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9eb494070aa060ceba6e4bbf44c1bc5fa97bfb883a0d9b0c9049415f9e944793"},
+    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5e15d424b8153756b7c903bde6d4610be0c3daca3986173c18dd5c1a1625e4cd"},
+    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:61d47a897c1e91f33f177c21de897267b38fbb45f2cd8e22a710bcef1df09ac1"},
+    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:25e73d4c81efa8ea3785274a2f7f3bfbbeccb6fcba2a0bdd3be9223371c37554"},
+    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:fac0bcc5b7e8169bffa87f0dcc24435446d329cbc2b5486d155c2e0f3b493ae1"},
+    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:72128176fea72012063200b7b395ed8a57849282b207321124d7ff14e26988e8"},
+    {file = "coverage-6.3.1-cp37-cp37m-win32.whl", hash = "sha256:1bc6d709939ff262fd1432f03f080c5042dc6508b6e0d3d20e61dd045456a1a0"},
+    {file = "coverage-6.3.1-cp37-cp37m-win_amd64.whl", hash = "sha256:618eeba986cea7f621d8607ee378ecc8c2504b98b3fdc4952b30fe3578304687"},
+    {file = "coverage-6.3.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:d5ed164af5c9078596cfc40b078c3b337911190d3faeac830c3f1274f26b8320"},
+    {file = "coverage-6.3.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:352c68e233409c31048a3725c446a9e48bbff36e39db92774d4f2380d630d8f8"},
+    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:448d7bde7ceb6c69e08474c2ddbc5b4cd13c9e4aa4a717467f716b5fc938a734"},
+    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9fde6b90889522c220dd56a670102ceef24955d994ff7af2cb786b4ba8fe11e4"},
+    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e647a0be741edbb529a72644e999acb09f2ad60465f80757da183528941ff975"},
+    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:6a5cdc3adb4f8bb8d8f5e64c2e9e282bc12980ef055ec6da59db562ee9bdfefa"},
+    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:2dd70a167843b4b4b2630c0c56f1b586fe965b4f8ac5da05b6690344fd065c6b"},
+    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:9ad0a117b8dc2061ce9461ea4c1b4799e55edceb236522c5b8f958ce9ed8fa9a"},
+    {file = "coverage-6.3.1-cp38-cp38-win32.whl", hash = "sha256:e92c7a5f7d62edff50f60a045dc9542bf939758c95b2fcd686175dd10ce0ed10"},
+    {file = "coverage-6.3.1-cp38-cp38-win_amd64.whl", hash = "sha256:482fb42eea6164894ff82abbcf33d526362de5d1a7ed25af7ecbdddd28fc124f"},
+    {file = "coverage-6.3.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:c5b81fb37db76ebea79aa963b76d96ff854e7662921ce742293463635a87a78d"},
+    {file = "coverage-6.3.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:a4f923b9ab265136e57cc14794a15b9dcea07a9c578609cd5dbbfff28a0d15e6"},
+    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:56d296cbc8254a7dffdd7bcc2eb70be5a233aae7c01856d2d936f5ac4e8ac1f1"},
+    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1245ab82e8554fa88c4b2ab1e098ae051faac5af829efdcf2ce6b34dccd5567c"},
+    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f2b05757c92ad96b33dbf8e8ec8d4ccb9af6ae3c9e9bd141c7cc44d20c6bcba"},
+    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:9e3dd806f34de38d4c01416344e98eab2437ac450b3ae39c62a0ede2f8b5e4ed"},
+    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:d651fde74a4d3122e5562705824507e2f5b2d3d57557f1916c4b27635f8fbe3f"},
+    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:704f89b87c4f4737da2860695a18c852b78ec7279b24eedacab10b29067d3a38"},
+    {file = "coverage-6.3.1-cp39-cp39-win32.whl", hash = "sha256:2aed4761809640f02e44e16b8b32c1a5dee5e80ea30a0ff0912158bde9c501f2"},
+    {file = "coverage-6.3.1-cp39-cp39-win_amd64.whl", hash = "sha256:9976fb0a5709988778ac9bc44f3d50fccd989987876dfd7716dee28beed0a9fa"},
+    {file = "coverage-6.3.1-pp36.pp37.pp38-none-any.whl", hash = "sha256:463e52616ea687fd323888e86bf25e864a3cc6335a043fad6bbb037dbf49bbe2"},
+    {file = "coverage-6.3.1.tar.gz", hash = "sha256:6c3f6158b02ac403868eea390930ae64e9a9a2a5bbfafefbb920d29258d9f2f8"},
 ]
 cryptography = [
-    {file = "cryptography-37.0.2-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:ef15c2df7656763b4ff20a9bc4381d8352e6640cfeb95c2972c38ef508e75181"},
-    {file = "cryptography-37.0.2-cp36-abi3-macosx_10_10_x86_64.whl", hash = "sha256:3c81599befb4d4f3d7648ed3217e00d21a9341a9a688ecdd615ff72ffbed7336"},
-    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:2bd1096476aaac820426239ab534b636c77d71af66c547b9ddcd76eb9c79e004"},
-    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:31fe38d14d2e5f787e0aecef831457da6cec68e0bb09a35835b0b44ae8b988fe"},
-    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:093cb351031656d3ee2f4fa1be579a8c69c754cf874206be1d4cf3b542042804"},
-    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:59b281eab51e1b6b6afa525af2bd93c16d49358404f814fe2c2410058623928c"},
-    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_24_x86_64.whl", hash = "sha256:0cc20f655157d4cfc7bada909dc5cc228211b075ba8407c46467f63597c78178"},
-    {file = "cryptography-37.0.2-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:f8ec91983e638a9bcd75b39f1396e5c0dc2330cbd9ce4accefe68717e6779e0a"},
-    {file = "cryptography-37.0.2-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:46f4c544f6557a2fefa7ac8ac7d1b17bf9b647bd20b16decc8fbcab7117fbc15"},
-    {file = "cryptography-37.0.2-cp36-abi3-win32.whl", hash = "sha256:731c8abd27693323b348518ed0e0705713a36d79fdbd969ad968fbef0979a7e0"},
-    {file = "cryptography-37.0.2-cp36-abi3-win_amd64.whl", hash = "sha256:471e0d70201c069f74c837983189949aa0d24bb2d751b57e26e3761f2f782b8d"},
-    {file = "cryptography-37.0.2-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a68254dd88021f24a68b613d8c51d5c5e74d735878b9e32cc0adf19d1f10aaf9"},
-    {file = "cryptography-37.0.2-pp37-pypy37_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:a7d5137e556cc0ea418dca6186deabe9129cee318618eb1ffecbd35bee55ddc1"},
-    {file = "cryptography-37.0.2-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:aeaba7b5e756ea52c8861c133c596afe93dd716cbcacae23b80bc238202dc023"},
-    {file = "cryptography-37.0.2-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:95e590dd70642eb2079d280420a888190aa040ad20f19ec8c6e097e38aa29e06"},
-    {file = "cryptography-37.0.2-pp38-pypy38_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:1b9362d34363f2c71b7853f6251219298124aa4cc2075ae2932e64c91a3e2717"},
-    {file = "cryptography-37.0.2-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:e53258e69874a306fcecb88b7534d61820db8a98655662a3dd2ec7f1afd9132f"},
-    {file = "cryptography-37.0.2-pp39-pypy39_pp73-macosx_10_10_x86_64.whl", hash = "sha256:1f3bfbd611db5cb58ca82f3deb35e83af34bb8cf06043fa61500157d50a70982"},
-    {file = "cryptography-37.0.2-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:419c57d7b63f5ec38b1199a9521d77d7d1754eb97827bbb773162073ccd8c8d4"},
-    {file = "cryptography-37.0.2-pp39-pypy39_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:dc26bb134452081859aa21d4990474ddb7e863aa39e60d1592800a8865a702de"},
-    {file = "cryptography-37.0.2-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:3b8398b3d0efc420e777c40c16764d6870bcef2eb383df9c6dbb9ffe12c64452"},
-    {file = "cryptography-37.0.2.tar.gz", hash = "sha256:f224ad253cc9cea7568f49077007d2263efa57396a2f2f78114066fd54b5c68e"},
+    {file = "cryptography-36.0.1-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:73bc2d3f2444bcfeac67dd130ff2ea598ea5f20b40e36d19821b4df8c9c5037b"},
+    {file = "cryptography-36.0.1-cp36-abi3-macosx_10_10_x86_64.whl", hash = "sha256:2d87cdcb378d3cfed944dac30596da1968f88fb96d7fc34fdae30a99054b2e31"},
+    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:74d6c7e80609c0f4c2434b97b80c7f8fdfaa072ca4baab7e239a15d6d70ed73a"},
+    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:6c0c021f35b421ebf5976abf2daacc47e235f8b6082d3396a2fe3ccd537ab173"},
+    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5d59a9d55027a8b88fd9fd2826c4392bd487d74bf628bb9d39beecc62a644c12"},
+    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0a817b961b46894c5ca8a66b599c745b9a3d9f822725221f0e0fe49dc043a3a3"},
+    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_24_x86_64.whl", hash = "sha256:94ae132f0e40fe48f310bba63f477f14a43116f05ddb69d6fa31e93f05848ae2"},
+    {file = "cryptography-36.0.1-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:7be0eec337359c155df191d6ae00a5e8bbb63933883f4f5dffc439dac5348c3f"},
+    {file = "cryptography-36.0.1-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:e0344c14c9cb89e76eb6a060e67980c9e35b3f36691e15e1b7a9e58a0a6c6dc3"},
+    {file = "cryptography-36.0.1-cp36-abi3-win32.whl", hash = "sha256:4caa4b893d8fad33cf1964d3e51842cd78ba87401ab1d2e44556826df849a8ca"},
+    {file = "cryptography-36.0.1-cp36-abi3-win_amd64.whl", hash = "sha256:391432971a66cfaf94b21c24ab465a4cc3e8bf4a939c1ca5c3e3a6e0abebdbcf"},
+    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:bb5829d027ff82aa872d76158919045a7c1e91fbf241aec32cb07956e9ebd3c9"},
+    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ebc15b1c22e55c4d5566e3ca4db8689470a0ca2babef8e3a9ee057a8b82ce4b1"},
+    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:596f3cd67e1b950bc372c33f1a28a0692080625592ea6392987dba7f09f17a94"},
+    {file = "cryptography-36.0.1-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:30ee1eb3ebe1644d1c3f183d115a8c04e4e603ed6ce8e394ed39eea4a98469ac"},
+    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:ec63da4e7e4a5f924b90af42eddf20b698a70e58d86a72d943857c4c6045b3ee"},
+    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ca238ceb7ba0bdf6ce88c1b74a87bffcee5afbfa1e41e173b1ceb095b39add46"},
+    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:ca28641954f767f9822c24e927ad894d45d5a1e501767599647259cbf030b903"},
+    {file = "cryptography-36.0.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:39bdf8e70eee6b1c7b289ec6e5d84d49a6bfa11f8b8646b5b3dfe41219153316"},
+    {file = "cryptography-36.0.1.tar.gz", hash = "sha256:53e5c1dc3d7a953de055d77bef2ff607ceef7a2aac0353b5d630ab67f7423638"},
 ]
 cx-freeze = [
     {file = "cx_Freeze-6.9-cp310-cp310-win32.whl", hash = "sha256:776d4fb68a4831691acbd3c374362b9b48ce2e568514a73c3d4cb14d5dcf1470"},
@@ -2042,33 +1946,25 @@ cx-logging = [
     {file = "cx_Logging-3.0-cp39-cp39-win_amd64.whl", hash = "sha256:302e9c4f65a936c288a4fa59a90e7e142d9ef994aa29676731acafdcccdbb3f5"},
     {file = "cx_Logging-3.0.tar.gz", hash = "sha256:ba8a7465facf7b98d8f494030fb481a2e8aeee29dc191e10383bb54ed42bdb34"},
 ]
-deprecated = [
-    {file = "Deprecated-1.2.13-py2.py3-none-any.whl", hash = "sha256:64756e3e14c8c5eea9795d93c524551432a0be75629f8f29e67ab8caf076c76d"},
-    {file = "Deprecated-1.2.13.tar.gz", hash = "sha256:43ac5335da90c31c24ba028af536a91d41d53f9e6901ddb021bcc572ce44e38d"},
-]
-dill = [
-    {file = "dill-0.3.5.1-py2.py3-none-any.whl", hash = "sha256:33501d03270bbe410c72639b350e941882a8b0fd55357580fbc873fba0c59302"},
-    {file = "dill-0.3.5.1.tar.gz", hash = "sha256:d75e41f3eff1eee599d738e76ba8f4ad98ea229db8b085318aa2b3333a208c86"},
-]
 dnspython = [
-    {file = "dnspython-2.2.1-py3-none-any.whl", hash = "sha256:a851e51367fb93e9e1361732c1d60dab63eff98712e503ea7d92e6eccb109b4f"},
-    {file = "dnspython-2.2.1.tar.gz", hash = "sha256:0f7569a4a6ff151958b64304071d370daa3243d15941a7beedf0c9fe5105603e"},
+    {file = "dnspython-2.2.0-py3-none-any.whl", hash = "sha256:081649da27ced5e75709a1ee542136eaba9842a0fe4c03da4fb0a3d3ed1f3c44"},
+    {file = "dnspython-2.2.0.tar.gz", hash = "sha256:e79351e032d0b606b98d38a4b0e6e2275b31a5b85c873e587cc11b73aca026d6"},
 ]
 docutils = [
-    {file = "docutils-0.17.1-py2.py3-none-any.whl", hash = "sha256:cf316c8370a737a022b72b56874f6602acf974a37a9fba42ec2876387549fc61"},
-    {file = "docutils-0.17.1.tar.gz", hash = "sha256:686577d2e4c32380bb50cbb22f575ed742d58168cee37e99117a854bcd88f125"},
+    {file = "docutils-0.18.1-py2.py3-none-any.whl", hash = "sha256:23010f129180089fbcd3bc08cfefccb3b890b0050e1ca00c867036e9d161b98c"},
+    {file = "docutils-0.18.1.tar.gz", hash = "sha256:679987caf361a7539d76e584cbeddc311e3aee937877c87346f31debc63e9d06"},
 ]
 dropbox = [
-    {file = "dropbox-11.31.0-py2-none-any.whl", hash = "sha256:393a99dfe30d42fd73c265b9b7d24bb21c9a961739cd097c3541e709eb2a209c"},
-    {file = "dropbox-11.31.0-py3-none-any.whl", hash = "sha256:5f924102fd6464def81573320c6aa4ea9cd3368e1b1c13d838403dd4c9ffc919"},
-    {file = "dropbox-11.31.0.tar.gz", hash = "sha256:f483d65b702775b9abf7b9328f702c68c6397fc01770477c6ddbfb1d858a5bcf"},
+    {file = "dropbox-11.26.0-py2-none-any.whl", hash = "sha256:abd29587fa692bde0c3a48ce8efb56c24d8df92c5f402bbcdd78f3089d5ced5c"},
+    {file = "dropbox-11.26.0-py3-none-any.whl", hash = "sha256:84becf043a63007ae67620946acb0fa164669ce691c7f1dbfdabb6712a258b29"},
+    {file = "dropbox-11.26.0.tar.gz", hash = "sha256:dd79e3dfc216688020959462aefac54ffce7c07a45e89f4fb258348885195a73"},
 ]
 enlighten = [
     {file = "enlighten-1.10.2-py2.py3-none-any.whl", hash = "sha256:b237fe562b320bf9f1d4bb76d0c98e0daf914372a76ab87c35cd02f57aa9d8c1"},
     {file = "enlighten-1.10.2.tar.gz", hash = "sha256:7a5b83cd0f4d095e59d80c648ebb5f7ffca0cd8bcf7ae6639828ee1ad000632a"},
 ]
 evdev = [
-    {file = "evdev-1.5.0.tar.gz", hash = "sha256:5b33b174f7c84576e7dd6071e438bf5ad227da95efd4356a39fe4c8355412fe6"},
+    {file = "evdev-1.4.0.tar.gz", hash = "sha256:8782740eb1a86b187334c07feb5127d3faa0b236e113206dfe3ae8f77fb1aaf1"},
 ]
 flake8 = [
     {file = "flake8-3.9.2-py2.py3-none-any.whl", hash = "sha256:bf8fd333346d844f616e8d47905ef3a3384edae6b4e9beb0c5101e25e3110907"},
@@ -2142,52 +2038,49 @@ ftrack-python-api = [
 future = [
     {file = "future-0.18.2.tar.gz", hash = "sha256:b1bead90b70cf6ec3f0710ae53a525360fa360d306a86583adc6bf83a4db537d"},
 ]
-gazu = [
-    {file = "gazu-0.8.28-py2.py3-none-any.whl", hash = "sha256:ec4f7c2688a2b37ee8a77737e4e30565ad362428c3ade9046136a998c043e51c"},
-]
 gitdb = [
     {file = "gitdb-4.0.9-py3-none-any.whl", hash = "sha256:8033ad4e853066ba6ca92050b9df2f89301b8fc8bf7e9324d412a63f8bf1a8fd"},
     {file = "gitdb-4.0.9.tar.gz", hash = "sha256:bac2fd45c0a1c9cf619e63a90d62bdc63892ef92387424b855792a6cabe789aa"},
 ]
 gitpython = [
-    {file = "GitPython-3.1.27-py3-none-any.whl", hash = "sha256:5b68b000463593e05ff2b261acff0ff0972df8ab1b70d3cdbd41b546c8b8fc3d"},
-    {file = "GitPython-3.1.27.tar.gz", hash = "sha256:1c885ce809e8ba2d88a29befeb385fcea06338d3640712b59ca623c220bb5704"},
+    {file = "GitPython-3.1.26-py3-none-any.whl", hash = "sha256:26ac35c212d1f7b16036361ca5cff3ec66e11753a0d677fb6c48fa4e1a9dd8d6"},
+    {file = "GitPython-3.1.26.tar.gz", hash = "sha256:fc8868f63a2e6d268fb25f481995ba185a85a66fcad126f039323ff6635669ee"},
 ]
 google-api-core = [
-    {file = "google-api-core-2.8.1.tar.gz", hash = "sha256:958024c6aa3460b08f35741231076a4dd9a4c819a6a39d44da9627febe8b28f0"},
-    {file = "google_api_core-2.8.1-py3-none-any.whl", hash = "sha256:ce1daa49644b50398093d2a9ad886501aa845e2602af70c3001b9f402a9d7359"},
+    {file = "google-api-core-2.4.0.tar.gz", hash = "sha256:ba8787b7c61632cd0340f095e1c036bef9426b2594f10afb290ba311ae8cb2cb"},
+    {file = "google_api_core-2.4.0-py2.py3-none-any.whl", hash = "sha256:58e2c1171a3d51778bf4e428fbb4bf79cbd05007b4b44deaa80cf73c80eebc0f"},
 ]
 google-api-python-client = [
-    {file = "google-api-python-client-1.12.11.tar.gz", hash = "sha256:1b4bd42a46321e13c0542a9e4d96fa05d73626f07b39f83a73a947d70ca706a9"},
-    {file = "google_api_python_client-1.12.11-py2.py3-none-any.whl", hash = "sha256:7e0a1a265c8d3088ee1987778c72683fcb376e32bada8d7767162bd9c503fd9b"},
+    {file = "google-api-python-client-1.12.10.tar.gz", hash = "sha256:1cb773647e7d97048d9d1c7fa746247fbad39fd1a3b5040f2cb2645dd7156b11"},
+    {file = "google_api_python_client-1.12.10-py2.py3-none-any.whl", hash = "sha256:5a8742b9b604b34e13462cc3d6aedbbf11d3af1ef558eb95defe74a29ebc5c28"},
 ]
 google-auth = [
-    {file = "google-auth-2.7.0.tar.gz", hash = "sha256:8a954960f852d5f19e6af14dd8e75c20159609e85d8db37e4013cc8c3824a7e1"},
-    {file = "google_auth-2.7.0-py2.py3-none-any.whl", hash = "sha256:df549a1433108801b11bdcc0e312eaf0d5f0500db42f0523e4d65c78722e8475"},
+    {file = "google-auth-2.6.0.tar.gz", hash = "sha256:ad160fc1ea8f19e331a16a14a79f3d643d813a69534ba9611d2c80dc10439dad"},
+    {file = "google_auth-2.6.0-py2.py3-none-any.whl", hash = "sha256:218ca03d7744ca0c8b6697b6083334be7df49b7bf76a69d555962fd1a7657b5f"},
 ]
 google-auth-httplib2 = [
     {file = "google-auth-httplib2-0.1.0.tar.gz", hash = "sha256:a07c39fd632becacd3f07718dfd6021bf396978f03ad3ce4321d060015cc30ac"},
     {file = "google_auth_httplib2-0.1.0-py2.py3-none-any.whl", hash = "sha256:31e49c36c6b5643b57e82617cb3e021e3e1d2df9da63af67252c02fa9c1f4a10"},
 ]
 googleapis-common-protos = [
-    {file = "googleapis-common-protos-1.56.2.tar.gz", hash = "sha256:b09b56f5463070c2153753ef123f07d2e49235e89148e9b2459ec8ed2f68d7d3"},
-    {file = "googleapis_common_protos-1.56.2-py2.py3-none-any.whl", hash = "sha256:023eaea9d8c1cceccd9587c6af6c20f33eeeb05d4148670f2b0322dc1511700c"},
+    {file = "googleapis-common-protos-1.54.0.tar.gz", hash = "sha256:a4031d6ec6c2b1b6dc3e0be7e10a1bd72fb0b18b07ef9be7b51f2c1004ce2437"},
+    {file = "googleapis_common_protos-1.54.0-py2.py3-none-any.whl", hash = "sha256:e54345a2add15dc5e1a7891c27731ff347b4c33765d79b5ed7026a6c0c7cbcae"},
 ]
 httplib2 = [
-    {file = "httplib2-0.20.4-py3-none-any.whl", hash = "sha256:8b6a905cb1c79eefd03f8669fd993c36dc341f7c558f056cb5a33b5c2f458543"},
-    {file = "httplib2-0.20.4.tar.gz", hash = "sha256:58a98e45b4b1a48273073f905d2961666ecf0fbac4250ea5b47aef259eb5c585"},
+    {file = "httplib2-0.20.2-py3-none-any.whl", hash = "sha256:6b937120e7d786482881b44b8eec230c1ee1c5c1d06bce8cc865f25abbbf713b"},
+    {file = "httplib2-0.20.2.tar.gz", hash = "sha256:e404681d2fbcec7506bcb52c503f2b021e95bee0ef7d01e5c221468a2406d8dc"},
 ]
 idna = [
-    {file = "idna-3.3-py3-none-any.whl", hash = "sha256:84d9dd047ffa80596e0f246e2eab0b391788b0503584e8945f2368256d2735ff"},
-    {file = "idna-3.3.tar.gz", hash = "sha256:9d643ff0a55b762d5cdb124b8eaa99c66322e2157b69160bc32796e824360e6d"},
+    {file = "idna-2.10-py2.py3-none-any.whl", hash = "sha256:b97d804b1e9b523befed77c48dacec60e6dcb0b5391d57af6a65a312a90648c0"},
+    {file = "idna-2.10.tar.gz", hash = "sha256:b307872f855b18632ce0c21c5e45be78c0ea7ae4c15c828c20788b26921eb3f6"},
 ]
 imagesize = [
     {file = "imagesize-1.3.0-py2.py3-none-any.whl", hash = "sha256:1db2f82529e53c3e929e8926a1fa9235aa82d0bd0c580359c67ec31b2fddaa8c"},
     {file = "imagesize-1.3.0.tar.gz", hash = "sha256:cd1750d452385ca327479d45b64d9c7729ecf0b3969a58148298c77092261f9d"},
 ]
 importlib-metadata = [
-    {file = "importlib_metadata-4.11.4-py3-none-any.whl", hash = "sha256:c58c8eb8a762858f49e18436ff552e83914778e50e9d2f1660535ffb364552ec"},
-    {file = "importlib_metadata-4.11.4.tar.gz", hash = "sha256:5d26852efe48c0a32b0509ffbc583fda1a2266545a78d104a6f4aff3db17d700"},
+    {file = "importlib_metadata-4.10.1-py3-none-any.whl", hash = "sha256:899e2a40a8c4a1aec681feef45733de8a6c58f3f6a0dbed2eb6574b4387a77b6"},
+    {file = "importlib_metadata-4.10.1.tar.gz", hash = "sha256:951f0d8a5b7260e9db5e41d429285b5f451e928479f19d80818878527d36e95e"},
 ]
 iniconfig = [
     {file = "iniconfig-1.1.1-py2.py3-none-any.whl", hash = "sha256:011e24c64b7f47f6ebd835bb12a743f2fbe9a26d4cecaa7f53bc4f35ee9da8b3"},
@@ -2202,16 +2095,16 @@ jedi = [
     {file = "jedi-0.13.3.tar.gz", hash = "sha256:2bb0603e3506f708e792c7f4ad8fc2a7a9d9c2d292a358fbbd58da531695595b"},
 ]
 jeepney = [
-    {file = "jeepney-0.8.0-py3-none-any.whl", hash = "sha256:c0a454ad016ca575060802ee4d590dd912e35c122fa04e70306de3d076cce755"},
-    {file = "jeepney-0.8.0.tar.gz", hash = "sha256:5efe48d255973902f6badc3ce55e2aa6c5c3b3bc642059ef3a91247bcfcc5806"},
+    {file = "jeepney-0.7.1-py3-none-any.whl", hash = "sha256:1b5a0ea5c0e7b166b2f5895b91a08c14de8915afda4407fb5022a195224958ac"},
+    {file = "jeepney-0.7.1.tar.gz", hash = "sha256:fa9e232dfa0c498bd0b8a3a73b8d8a31978304dcef0515adc859d4e096f96f4f"},
 ]
 jinja2 = [
     {file = "Jinja2-2.11.3-py2.py3-none-any.whl", hash = "sha256:03e47ad063331dd6a3f04a43eddca8a966a26ba0c5b7207a9a9e4e08f1b29419"},
     {file = "Jinja2-2.11.3.tar.gz", hash = "sha256:a6d58433de0ae800347cab1fa3043cebbabe8baa9d29e668f1c768cb87a333c6"},
 ]
 jinxed = [
-    {file = "jinxed-1.2.0-py2.py3-none-any.whl", hash = "sha256:cfc2b2e4e3b4326954d546ba6d6b9a7a796ddcb0aef8d03161d005177eb0d48b"},
-    {file = "jinxed-1.2.0.tar.gz", hash = "sha256:032acda92d5c57cd216033cbbd53de731e6ed50deb63eb4781336ca55f72cda5"},
+    {file = "jinxed-1.1.0-py2.py3-none-any.whl", hash = "sha256:6a61ccf963c16aa885304f27e6e5693783676897cea0c7f223270c8b8e78baf8"},
+    {file = "jinxed-1.1.0.tar.gz", hash = "sha256:d8f1731f134e9e6b04d95095845ae6c10eb15cb223a5f0cabdea87d4a279c305"},
 ]
 jsonschema = [
     {file = "jsonschema-2.6.0-py2.py3-none-any.whl", hash = "sha256:000e68abd33c972a5248544925a0cae7d1125f9bf6c58280d37546b946769a08"},
@@ -2264,46 +2157,75 @@ log4mongo = [
     {file = "log4mongo-1.7.0.tar.gz", hash = "sha256:dc374617206162a0b14167fbb5feac01dbef587539a235dadba6200362984a68"},
 ]
 markupsafe = [
-    {file = "MarkupSafe-2.1.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:86b1f75c4e7c2ac2ccdaec2b9022845dbb81880ca318bb7a0a01fbf7813e3812"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:f121a1420d4e173a5d96e47e9a0c0dcff965afdf1626d28de1460815f7c4ee7a"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a49907dd8420c5685cfa064a1335b6754b74541bbb3706c259c02ed65b644b3e"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:10c1bfff05d95783da83491be968e8fe789263689c02724e0c691933c52994f5"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b7bd98b796e2b6553da7225aeb61f447f80a1ca64f41d83612e6139ca5213aa4"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:b09bf97215625a311f669476f44b8b318b075847b49316d3e28c08e41a7a573f"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:694deca8d702d5db21ec83983ce0bb4b26a578e71fbdbd4fdcd387daa90e4d5e"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:efc1913fd2ca4f334418481c7e595c00aad186563bbc1ec76067848c7ca0a933"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-win32.whl", hash = "sha256:4a33dea2b688b3190ee12bd7cfa29d39c9ed176bda40bfa11099a3ce5d3a7ac6"},
-    {file = "MarkupSafe-2.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:dda30ba7e87fbbb7eab1ec9f58678558fd9a6b8b853530e176eabd064da81417"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:671cd1187ed5e62818414afe79ed29da836dde67166a9fac6d435873c44fdd02"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3799351e2336dc91ea70b034983ee71cf2f9533cdff7c14c90ea126bfd95d65a"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e72591e9ecd94d7feb70c1cbd7be7b3ebea3f548870aa91e2732960fa4d57a37"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6fbf47b5d3728c6aea2abb0589b5d30459e369baa772e0f37a0320185e87c980"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:d5ee4f386140395a2c818d149221149c54849dfcfcb9f1debfe07a8b8bd63f9a"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:bcb3ed405ed3222f9904899563d6fc492ff75cce56cba05e32eff40e6acbeaa3"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:e1c0b87e09fa55a220f058d1d49d3fb8df88fbfab58558f1198e08c1e1de842a"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-win32.whl", hash = "sha256:8dc1c72a69aa7e082593c4a203dcf94ddb74bb5c8a731e4e1eb68d031e8498ff"},
-    {file = "MarkupSafe-2.1.1-cp37-cp37m-win_amd64.whl", hash = "sha256:97a68e6ada378df82bc9f16b800ab77cbf4b2fada0081794318520138c088e4a"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:e8c843bbcda3a2f1e3c2ab25913c80a3c5376cd00c6e8c4a86a89a28c8dc5452"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:0212a68688482dc52b2d45013df70d169f542b7394fc744c02a57374a4207003"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8e576a51ad59e4bfaac456023a78f6b5e6e7651dcd383bcc3e18d06f9b55d6d1"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4b9fe39a2ccc108a4accc2676e77da025ce383c108593d65cc909add5c3bd601"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:96e37a3dc86e80bf81758c152fe66dbf60ed5eca3d26305edf01892257049925"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:6d0072fea50feec76a4c418096652f2c3238eaa014b2f94aeb1d56a66b41403f"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:089cf3dbf0cd6c100f02945abeb18484bd1ee57a079aefd52cffd17fba910b88"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:6a074d34ee7a5ce3effbc526b7083ec9731bb3cbf921bbe1d3005d4d2bdb3a63"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-win32.whl", hash = "sha256:421be9fbf0ffe9ffd7a378aafebbf6f4602d564d34be190fc19a193232fd12b1"},
-    {file = "MarkupSafe-2.1.1-cp38-cp38-win_amd64.whl", hash = "sha256:fc7b548b17d238737688817ab67deebb30e8073c95749d55538ed473130ec0c7"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:e04e26803c9c3851c931eac40c695602c6295b8d432cbe78609649ad9bd2da8a"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:b87db4360013327109564f0e591bd2a3b318547bcef31b468a92ee504d07ae4f"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:99a2a507ed3ac881b975a2976d59f38c19386d128e7a9a18b7df6fff1fd4c1d6"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:56442863ed2b06d19c37f94d999035e15ee982988920e12a5b4ba29b62ad1f77"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3ce11ee3f23f79dbd06fb3d63e2f6af7b12db1d46932fe7bd8afa259a5996603"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:33b74d289bd2f5e527beadcaa3f401e0df0a89927c1559c8566c066fa4248ab7"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:43093fb83d8343aac0b1baa75516da6092f58f41200907ef92448ecab8825135"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:8e3dcf21f367459434c18e71b2a9532d96547aef8a871872a5bd69a715c15f96"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-win32.whl", hash = "sha256:d4306c36ca495956b6d568d276ac11fdd9c30a36f1b6eb928070dc5360b22e1c"},
-    {file = "MarkupSafe-2.1.1-cp39-cp39-win_amd64.whl", hash = "sha256:46d00d6cfecdde84d40e572d63735ef81423ad31184100411e6e3388d405e247"},
-    {file = "MarkupSafe-2.1.1.tar.gz", hash = "sha256:7f91197cc9e48f989d12e4e6fbc46495c446636dfc81b9ccf50bb0ec74b91d4b"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:d8446c54dc28c01e5a2dbac5a25f071f6653e6e40f3a8818e8b45d790fe6ef53"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:36bc903cbb393720fad60fc28c10de6acf10dc6cc883f3e24ee4012371399a38"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2d7d807855b419fc2ed3e631034685db6079889a1f01d5d9dac950f764da3dad"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:add36cb2dbb8b736611303cd3bfcee00afd96471b09cda130da3581cbdc56a6d"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:168cd0a3642de83558a5153c8bd34f175a9a6e7f6dc6384b9655d2697312a646"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:4dc8f9fb58f7364b63fd9f85013b780ef83c11857ae79f2feda41e270468dd9b"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:20dca64a3ef2d6e4d5d615a3fd418ad3bde77a47ec8a23d984a12b5b4c74491a"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:cdfba22ea2f0029c9261a4bd07e830a8da012291fbe44dc794e488b6c9bb353a"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-win32.whl", hash = "sha256:99df47edb6bda1249d3e80fdabb1dab8c08ef3975f69aed437cb69d0a5de1e28"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:e0f138900af21926a02425cf736db95be9f4af72ba1bb21453432a07f6082134"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:f9081981fe268bd86831e5c75f7de206ef275defcb82bc70740ae6dc507aee51"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux1_i686.whl", hash = "sha256:0955295dd5eec6cb6cc2fe1698f4c6d84af2e92de33fbcac4111913cd100a6ff"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux1_x86_64.whl", hash = "sha256:0446679737af14f45767963a1a9ef7620189912317d095f2d9ffa183a4d25d2b"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2010_i686.whl", hash = "sha256:f826e31d18b516f653fe296d967d700fddad5901ae07c622bb3705955e1faa94"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2010_x86_64.whl", hash = "sha256:fa130dd50c57d53368c9d59395cb5526eda596d3ffe36666cd81a44d56e48872"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2014_aarch64.whl", hash = "sha256:905fec760bd2fa1388bb5b489ee8ee5f7291d692638ea5f67982d968366bef9f"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bf5d821ffabf0ef3533c39c518f3357b171a1651c1ff6827325e4489b0e46c3c"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:0d4b31cc67ab36e3392bbf3862cfbadac3db12bdd8b02a2731f509ed5b829724"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:baa1a4e8f868845af802979fcdbf0bb11f94f1cb7ced4c4b8a351bb60d108145"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:deb993cacb280823246a026e3b2d81c493c53de6acfd5e6bfe31ab3402bb37dd"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:63f3268ba69ace99cab4e3e3b5840b03340efed0948ab8f78d2fd87ee5442a4f"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:8d206346619592c6200148b01a2142798c989edcb9c896f9ac9722a99d4e77e6"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-win32.whl", hash = "sha256:6c4ca60fa24e85fe25b912b01e62cb969d69a23a5d5867682dd3e80b5b02581d"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-win_amd64.whl", hash = "sha256:b2f4bf27480f5e5e8ce285a8c8fd176c0b03e93dcc6646477d4630e83440c6a9"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:0717a7390a68be14b8c793ba258e075c6f4ca819f15edfc2a3a027c823718567"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux1_i686.whl", hash = "sha256:6557b31b5e2c9ddf0de32a691f2312a32f77cd7681d8af66c2692efdbef84c18"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux1_x86_64.whl", hash = "sha256:49e3ceeabbfb9d66c3aef5af3a60cc43b85c33df25ce03d0031a608b0a8b2e3f"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2010_i686.whl", hash = "sha256:d7f9850398e85aba693bb640262d3611788b1f29a79f0c93c565694658f4071f"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2010_x86_64.whl", hash = "sha256:6a7fae0dd14cf60ad5ff42baa2e95727c3d81ded453457771d02b7d2b3f9c0c2"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2014_aarch64.whl", hash = "sha256:b7f2d075102dc8c794cbde1947378051c4e5180d52d276987b8d28a3bd58c17d"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e9936f0b261d4df76ad22f8fee3ae83b60d7c3e871292cd42f40b81b70afae85"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:2a7d351cbd8cfeb19ca00de495e224dea7e7d919659c2841bbb7f420ad03e2d6"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:60bf42e36abfaf9aff1f50f52644b336d4f0a3fd6d8a60ca0d054ac9f713a864"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:d6c7ebd4e944c85e2c3421e612a7057a2f48d478d79e61800d81468a8d842207"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:f0567c4dc99f264f49fe27da5f735f414c4e7e7dd850cfd8e69f0862d7c74ea9"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:89c687013cb1cd489a0f0ac24febe8c7a666e6e221b783e53ac50ebf68e45d86"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-win32.whl", hash = "sha256:a30e67a65b53ea0a5e62fe23682cfe22712e01f453b95233b25502f7c61cb415"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-win_amd64.whl", hash = "sha256:611d1ad9a4288cf3e3c16014564df047fe08410e628f89805e475368bd304914"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:5bb28c636d87e840583ee3adeb78172efc47c8b26127267f54a9c0ec251d41a9"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:be98f628055368795d818ebf93da628541e10b75b41c559fdf36d104c5787066"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux1_i686.whl", hash = "sha256:1d609f577dc6e1aa17d746f8bd3c31aa4d258f4070d61b2aa5c4166c1539de35"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux1_x86_64.whl", hash = "sha256:7d91275b0245b1da4d4cfa07e0faedd5b0812efc15b702576d103293e252af1b"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2010_i686.whl", hash = "sha256:01a9b8ea66f1658938f65b93a85ebe8bc016e6769611be228d797c9d998dd298"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2010_x86_64.whl", hash = "sha256:47ab1e7b91c098ab893b828deafa1203de86d0bc6ab587b160f78fe6c4011f75"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2014_aarch64.whl", hash = "sha256:97383d78eb34da7e1fa37dd273c20ad4320929af65d156e35a5e2d89566d9dfb"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6fcf051089389abe060c9cd7caa212c707e58153afa2c649f00346ce6d260f1b"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:5855f8438a7d1d458206a2466bf82b0f104a3724bf96a1c781ab731e4201731a"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:3dd007d54ee88b46be476e293f48c85048603f5f516008bee124ddd891398ed6"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:aca6377c0cb8a8253e493c6b451565ac77e98c2951c45f913e0b52facdcff83f"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:04635854b943835a6ea959e948d19dcd311762c5c0c6e1f0e16ee57022669194"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:6300b8454aa6930a24b9618fbb54b5a68135092bc666f7b06901f897fa5c2fee"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-win32.whl", hash = "sha256:023cb26ec21ece8dc3907c0e8320058b2e0cb3c55cf9564da612bc325bed5e64"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:984d76483eb32f1bcb536dc27e4ad56bba4baa70be32fa87152832cdd9db0833"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:2ef54abee730b502252bcdf31b10dacb0a416229b72c18b19e24a4509f273d26"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:3c112550557578c26af18a1ccc9e090bfe03832ae994343cfdacd287db6a6ae7"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux1_i686.whl", hash = "sha256:53edb4da6925ad13c07b6d26c2a852bd81e364f95301c66e930ab2aef5b5ddd8"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux1_x86_64.whl", hash = "sha256:f5653a225f31e113b152e56f154ccbe59eeb1c7487b39b9d9f9cdb58e6c79dc5"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2010_i686.whl", hash = "sha256:4efca8f86c54b22348a5467704e3fec767b2db12fc39c6d963168ab1d3fc9135"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2010_x86_64.whl", hash = "sha256:ab3ef638ace319fa26553db0624c4699e31a28bb2a835c5faca8f8acf6a5a902"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2014_aarch64.whl", hash = "sha256:f8ba0e8349a38d3001fae7eadded3f6606f0da5d748ee53cc1dab1d6527b9509"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c47adbc92fc1bb2b3274c4b3a43ae0e4573d9fbff4f54cd484555edbf030baf1"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:37205cac2a79194e3750b0af2a5720d95f786a55ce7df90c3af697bfa100eaac"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:1f2ade76b9903f39aa442b4aadd2177decb66525062db244b35d71d0ee8599b6"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:4296f2b1ce8c86a6aea78613c34bb1a672ea0e3de9c6ba08a960efe0b0a09047"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:9f02365d4e99430a12647f09b6cc8bab61a6564363f313126f775eb4f6ef798e"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5b6d930f030f8ed98e3e6c98ffa0652bdb82601e7a016ec2ab5d7ff23baa78d1"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-win32.whl", hash = "sha256:10f82115e21dc0dfec9ab5c0223652f7197feb168c940f3ef61563fc2d6beb74"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:693ce3f9e70a6cf7d2fb9e6c9d8b204b6b39897a2c4a1aa65728d5ac97dcc1d8"},
+    {file = "MarkupSafe-2.0.1.tar.gz", hash = "sha256:594c67807fb16238b30c44bdf74f36c02cdf22d1c8cda91ef8a0ed8dabf5620a"},
 ]
 mccabe = [
     {file = "mccabe-0.6.1-py2.py3-none-any.whl", hash = "sha256:ab8a6258860da4b6677da4bd2fe5dc2c659cff31b3ee4f7f5d64e79735b80d42"},
@@ -2376,60 +2298,57 @@ packaging = [
     {file = "packaging-21.3.tar.gz", hash = "sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb"},
 ]
 paramiko = [
-    {file = "paramiko-2.11.0-py2.py3-none-any.whl", hash = "sha256:655f25dc8baf763277b933dfcea101d636581df8d6b9774d1fb653426b72c270"},
-    {file = "paramiko-2.11.0.tar.gz", hash = "sha256:003e6bee7c034c21fbb051bf83dc0a9ee4106204dd3c53054c71452cc4ec3938"},
+    {file = "paramiko-2.10.1-py2.py3-none-any.whl", hash = "sha256:f6cbd3e1204abfdbcd40b3ecbc9d32f04027cd3080fe666245e21e7540ccfc1b"},
+    {file = "paramiko-2.10.1.tar.gz", hash = "sha256:443f4da23ec24e9a9c0ea54017829c282abdda1d57110bf229360775ccd27a31"},
 ]
 parso = [
     {file = "parso-0.8.3-py2.py3-none-any.whl", hash = "sha256:c001d4636cd3aecdaf33cbb40aebb59b094be2a74c556778ef5576c175e19e75"},
     {file = "parso-0.8.3.tar.gz", hash = "sha256:8c07be290bb59f03588915921e29e8a50002acaf2cdc5fa0e0114f91709fafa0"},
 ]
 pathlib2 = [
-    {file = "pathlib2-2.3.7.post1-py2.py3-none-any.whl", hash = "sha256:5266a0fd000452f1b3467d782f079a4343c63aaa119221fbdc4e39577489ca5b"},
-    {file = "pathlib2-2.3.7.post1.tar.gz", hash = "sha256:9fe0edad898b83c0c3e199c842b27ed216645d2e177757b2dd67384d4113c641"},
+    {file = "pathlib2-2.3.6-py2.py3-none-any.whl", hash = "sha256:3a130b266b3a36134dcc79c17b3c7ac9634f083825ca6ea9d8f557ee6195c9c8"},
+    {file = "pathlib2-2.3.6.tar.gz", hash = "sha256:7d8bcb5555003cdf4a8d2872c538faa3a0f5d20630cb360e518ca3b981795e5f"},
 ]
 pillow = [
-    {file = "Pillow-9.1.1-cp310-cp310-macosx_10_10_x86_64.whl", hash = "sha256:42dfefbef90eb67c10c45a73a9bc1599d4dac920f7dfcbf4ec6b80cb620757fe"},
-    {file = "Pillow-9.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:ffde4c6fabb52891d81606411cbfaf77756e3b561b566efd270b3ed3791fde4e"},
-    {file = "Pillow-9.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9c857532c719fb30fafabd2371ce9b7031812ff3889d75273827633bca0c4602"},
-    {file = "Pillow-9.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:59789a7d06c742e9d13b883d5e3569188c16acb02eeed2510fd3bfdbc1bd1530"},
-    {file = "Pillow-9.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4d45dbe4b21a9679c3e8b3f7f4f42a45a7d3ddff8a4a16109dff0e1da30a35b2"},
-    {file = "Pillow-9.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:e9ed59d1b6ee837f4515b9584f3d26cf0388b742a11ecdae0d9237a94505d03a"},
-    {file = "Pillow-9.1.1-cp310-cp310-win32.whl", hash = "sha256:b3fe2ff1e1715d4475d7e2c3e8dabd7c025f4410f79513b4ff2de3d51ce0fa9c"},
-    {file = "Pillow-9.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:5b650dbbc0969a4e226d98a0b440c2f07a850896aed9266b6fedc0f7e7834108"},
-    {file = "Pillow-9.1.1-cp37-cp37m-macosx_10_10_x86_64.whl", hash = "sha256:0b4d5ad2cd3a1f0d1df882d926b37dbb2ab6c823ae21d041b46910c8f8cd844b"},
-    {file = "Pillow-9.1.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9370d6744d379f2de5d7fa95cdbd3a4d92f0b0ef29609b4b1687f16bc197063d"},
-    {file = "Pillow-9.1.1-cp37-cp37m-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b761727ed7d593e49671d1827044b942dd2f4caae6e51bab144d4accf8244a84"},
-    {file = "Pillow-9.1.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8a66fe50386162df2da701b3722781cbe90ce043e7d53c1fd6bd801bca6b48d4"},
-    {file = "Pillow-9.1.1-cp37-cp37m-win32.whl", hash = "sha256:2b291cab8a888658d72b575a03e340509b6b050b62db1f5539dd5cd18fd50578"},
-    {file = "Pillow-9.1.1-cp37-cp37m-win_amd64.whl", hash = "sha256:1d4331aeb12f6b3791911a6da82de72257a99ad99726ed6b63f481c0184b6fb9"},
-    {file = "Pillow-9.1.1-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:8844217cdf66eabe39567118f229e275f0727e9195635a15e0e4b9227458daaf"},
-    {file = "Pillow-9.1.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:b6617221ff08fbd3b7a811950b5c3f9367f6e941b86259843eab77c8e3d2b56b"},
-    {file = "Pillow-9.1.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:20d514c989fa28e73a5adbddd7a171afa5824710d0ab06d4e1234195d2a2e546"},
-    {file = "Pillow-9.1.1-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:088df396b047477dd1bbc7de6e22f58400dae2f21310d9e2ec2933b2ef7dfa4f"},
-    {file = "Pillow-9.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:53c27bd452e0f1bc4bfed07ceb235663a1df7c74df08e37fd6b03eb89454946a"},
-    {file = "Pillow-9.1.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:3f6c1716c473ebd1649663bf3b42702d0d53e27af8b64642be0dd3598c761fb1"},
-    {file = "Pillow-9.1.1-cp38-cp38-win32.whl", hash = "sha256:c67db410508b9de9c4694c57ed754b65a460e4812126e87f5052ecf23a011a54"},
-    {file = "Pillow-9.1.1-cp38-cp38-win_amd64.whl", hash = "sha256:f054b020c4d7e9786ae0404278ea318768eb123403b18453e28e47cdb7a0a4bf"},
-    {file = "Pillow-9.1.1-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:c17770a62a71718a74b7548098a74cd6880be16bcfff5f937f900ead90ca8e92"},
-    {file = "Pillow-9.1.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:f3f6a6034140e9e17e9abc175fc7a266a6e63652028e157750bd98e804a8ed9a"},
-    {file = "Pillow-9.1.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f372d0f08eff1475ef426344efe42493f71f377ec52237bf153c5713de987251"},
-    {file = "Pillow-9.1.1-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:09e67ef6e430f90caa093528bd758b0616f8165e57ed8d8ce014ae32df6a831d"},
-    {file = "Pillow-9.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:66daa16952d5bf0c9d5389c5e9df562922a59bd16d77e2a276e575d32e38afd1"},
-    {file = "Pillow-9.1.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:d78ca526a559fb84faaaf84da2dd4addef5edb109db8b81677c0bb1aad342601"},
-    {file = "Pillow-9.1.1-cp39-cp39-win32.whl", hash = "sha256:55e74faf8359ddda43fee01bffbc5bd99d96ea508d8a08c527099e84eb708f45"},
-    {file = "Pillow-9.1.1-cp39-cp39-win_amd64.whl", hash = "sha256:7c150dbbb4a94ea4825d1e5f2c5501af7141ea95825fadd7829f9b11c97aaf6c"},
-    {file = "Pillow-9.1.1-pp37-pypy37_pp73-macosx_10_10_x86_64.whl", hash = "sha256:769a7f131a2f43752455cc72f9f7a093c3ff3856bf976c5fb53a59d0ccc704f6"},
-    {file = "Pillow-9.1.1-pp37-pypy37_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:488f3383cf5159907d48d32957ac6f9ea85ccdcc296c14eca1a4e396ecc32098"},
-    {file = "Pillow-9.1.1-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b525a356680022b0af53385944026d3486fc8c013638cf9900eb87c866afb4c"},
-    {file = "Pillow-9.1.1-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:6e760cf01259a1c0a50f3c845f9cad1af30577fd8b670339b1659c6d0e7a41dd"},
-    {file = "Pillow-9.1.1-pp38-pypy38_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a4165205a13b16a29e1ac57efeee6be2dfd5b5408122d59ef2145bc3239fa340"},
-    {file = "Pillow-9.1.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:937a54e5694684f74dcbf6e24cc453bfc5b33940216ddd8f4cd8f0f79167f765"},
-    {file = "Pillow-9.1.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:baf3be0b9446a4083cc0c5bb9f9c964034be5374b5bc09757be89f5d2fa247b8"},
-    {file = "Pillow-9.1.1.tar.gz", hash = "sha256:7502539939b53d7565f3d11d87c78e7ec900d3c72945d4ee0e2f250d598309a0"},
+    {file = "Pillow-9.0.1-1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:a5d24e1d674dd9d72c66ad3ea9131322819ff86250b30dc5821cbafcfa0b96b4"},
+    {file = "Pillow-9.0.1-1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:2632d0f846b7c7600edf53c48f8f9f1e13e62f66a6dbc15191029d950bfed976"},
+    {file = "Pillow-9.0.1-1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:b9618823bd237c0d2575283f2939655f54d51b4527ec3972907a927acbcc5bfc"},
+    {file = "Pillow-9.0.1-cp310-cp310-macosx_10_10_universal2.whl", hash = "sha256:9bfdb82cdfeccec50aad441afc332faf8606dfa5e8efd18a6692b5d6e79f00fd"},
+    {file = "Pillow-9.0.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:5100b45a4638e3c00e4d2320d3193bdabb2d75e79793af7c3eb139e4f569f16f"},
+    {file = "Pillow-9.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:528a2a692c65dd5cafc130de286030af251d2ee0483a5bf50c9348aefe834e8a"},
+    {file = "Pillow-9.0.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0f29d831e2151e0b7b39981756d201f7108d3d215896212ffe2e992d06bfe049"},
+    {file = "Pillow-9.0.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:855c583f268edde09474b081e3ddcd5cf3b20c12f26e0d434e1386cc5d318e7a"},
+    {file = "Pillow-9.0.1-cp310-cp310-win32.whl", hash = "sha256:d9d7942b624b04b895cb95af03a23407f17646815495ce4547f0e60e0b06f58e"},
+    {file = "Pillow-9.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:81c4b81611e3a3cb30e59b0cf05b888c675f97e3adb2c8672c3154047980726b"},
+    {file = "Pillow-9.0.1-cp37-cp37m-macosx_10_10_x86_64.whl", hash = "sha256:413ce0bbf9fc6278b2d63309dfeefe452835e1c78398efb431bab0672fe9274e"},
+    {file = "Pillow-9.0.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:80fe64a6deb6fcfdf7b8386f2cf216d329be6f2781f7d90304351811fb591360"},
+    {file = "Pillow-9.0.1-cp37-cp37m-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:cef9c85ccbe9bee00909758936ea841ef12035296c748aaceee535969e27d31b"},
+    {file = "Pillow-9.0.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1d19397351f73a88904ad1aee421e800fe4bbcd1aeee6435fb62d0a05ccd1030"},
+    {file = "Pillow-9.0.1-cp37-cp37m-win32.whl", hash = "sha256:d21237d0cd37acded35154e29aec853e945950321dd2ffd1a7d86fe686814669"},
+    {file = "Pillow-9.0.1-cp37-cp37m-win_amd64.whl", hash = "sha256:ede5af4a2702444a832a800b8eb7f0a7a1c0eed55b644642e049c98d589e5092"},
+    {file = "Pillow-9.0.1-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:b5b3f092fe345c03bca1e0b687dfbb39364b21ebb8ba90e3fa707374b7915204"},
+    {file = "Pillow-9.0.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:335ace1a22325395c4ea88e00ba3dc89ca029bd66bd5a3c382d53e44f0ccd77e"},
+    {file = "Pillow-9.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:db6d9fac65bd08cea7f3540b899977c6dee9edad959fa4eaf305940d9cbd861c"},
+    {file = "Pillow-9.0.1-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f154d173286a5d1863637a7dcd8c3437bb557520b01bddb0be0258dcb72696b5"},
+    {file = "Pillow-9.0.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:14d4b1341ac07ae07eb2cc682f459bec932a380c3b122f5540432d8977e64eae"},
+    {file = "Pillow-9.0.1-cp38-cp38-win32.whl", hash = "sha256:effb7749713d5317478bb3acb3f81d9d7c7f86726d41c1facca068a04cf5bb4c"},
+    {file = "Pillow-9.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:7f7609a718b177bf171ac93cea9fd2ddc0e03e84d8fa4e887bdfc39671d46b00"},
+    {file = "Pillow-9.0.1-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:80ca33961ced9c63358056bd08403ff866512038883e74f3a4bf88ad3eb66838"},
+    {file = "Pillow-9.0.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:1c3c33ac69cf059bbb9d1a71eeaba76781b450bc307e2291f8a4764d779a6b28"},
+    {file = "Pillow-9.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:12875d118f21cf35604176872447cdb57b07126750a33748bac15e77f90f1f9c"},
+    {file = "Pillow-9.0.1-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:514ceac913076feefbeaf89771fd6febde78b0c4c1b23aaeab082c41c694e81b"},
+    {file = "Pillow-9.0.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d3c5c79ab7dfce6d88f1ba639b77e77a17ea33a01b07b99840d6ed08031cb2a7"},
+    {file = "Pillow-9.0.1-cp39-cp39-win32.whl", hash = "sha256:718856856ba31f14f13ba885ff13874be7fefc53984d2832458f12c38205f7f7"},
+    {file = "Pillow-9.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:f25ed6e28ddf50de7e7ea99d7a976d6a9c415f03adcaac9c41ff6ff41b6d86ac"},
+    {file = "Pillow-9.0.1-pp37-pypy37_pp73-macosx_10_10_x86_64.whl", hash = "sha256:011233e0c42a4a7836498e98c1acf5e744c96a67dd5032a6f666cc1fb97eab97"},
+    {file = "Pillow-9.0.1-pp37-pypy37_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:253e8a302a96df6927310a9d44e6103055e8fb96a6822f8b7f514bb7ef77de56"},
+    {file = "Pillow-9.0.1-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6295f6763749b89c994fcb6d8a7f7ce03c3992e695f89f00b741b4580b199b7e"},
+    {file = "Pillow-9.0.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:a9f44cd7e162ac6191491d7249cceb02b8116b0f7e847ee33f739d7cb1ea1f70"},
+    {file = "Pillow-9.0.1.tar.gz", hash = "sha256:6c8bc8238a7dfdaf7a75f5ec5a663f4173f8c367e5a39f87e720495e1eed75fa"},
 ]
 platformdirs = [
-    {file = "platformdirs-2.5.2-py3-none-any.whl", hash = "sha256:027d8e83a2d7de06bbac4e5ef7e023c02b863d7ea5d079477e722bb41ab25788"},
-    {file = "platformdirs-2.5.2.tar.gz", hash = "sha256:58c8abb07dcb441e6ee4b11d8df0ac856038f944ab98b7be6b27b2a3c7feef19"},
+    {file = "platformdirs-2.4.1-py3-none-any.whl", hash = "sha256:1d7385c7db91728b83efd0ca99a5afb296cab9d0ed8313a45ed8ba17967ecfca"},
+    {file = "platformdirs-2.4.1.tar.gz", hash = "sha256:440633ddfebcc36264232365d7840a970e75e1018d15b4327d11f91909045fda"},
 ]
 pluggy = [
     {file = "pluggy-1.0.0-py2.py3-none-any.whl", hash = "sha256:74134bbf457f031a36d68416e1509f34bd5ccc019f0bcc952c7b909d06b37bd3"},
@@ -2528,12 +2447,12 @@ pyflakes = [
     {file = "pyflakes-2.3.1.tar.gz", hash = "sha256:f5bc8ecabc05bb9d291eb5203d6810b49040f6ff446a756326104746cc00c1db"},
 ]
 pygments = [
-    {file = "Pygments-2.12.0-py3-none-any.whl", hash = "sha256:dc9c10fb40944260f6ed4c688ece0cd2048414940f1cea51b8b226318411c519"},
-    {file = "Pygments-2.12.0.tar.gz", hash = "sha256:5eb116118f9612ff1ee89ac96437bb6b49e8f04d8a13b514ba26f620208e26eb"},
+    {file = "Pygments-2.11.2-py3-none-any.whl", hash = "sha256:44238f1b60a76d78fc8ca0528ee429702aae011c265fe6a8dd8b63049ae41c65"},
+    {file = "Pygments-2.11.2.tar.gz", hash = "sha256:4e426f72023d88d03b2fa258de560726ce890ff3b630f88c21cbb8b2503b8c6a"},
 ]
 pylint = [
-    {file = "pylint-2.13.9-py3-none-any.whl", hash = "sha256:705c620d388035bdd9ff8b44c5bcdd235bfb49d276d488dd2c8ff1736aa42526"},
-    {file = "pylint-2.13.9.tar.gz", hash = "sha256:095567c96e19e6f57b5b907e67d265ff535e588fe26b12b5ebe1fc5645b2c731"},
+    {file = "pylint-2.12.2-py3-none-any.whl", hash = "sha256:daabda3f7ed9d1c60f52d563b1b854632fd90035bcf01443e234d3dc794e3b74"},
+    {file = "pylint-2.12.2.tar.gz", hash = "sha256:9d945a73640e1fec07ee34b42f5669b770c759acd536ec7b16d7e4b87a9c9ff9"},
 ]
 pymongo = [
     {file = "pymongo-3.12.3-cp27-cp27m-macosx_10_14_intel.whl", hash = "sha256:c164eda0be9048f83c24b9b2656900041e069ddf72de81c17d874d0c32f6079f"},
@@ -2662,40 +2581,40 @@ pynput = [
     {file = "pynput-1.7.6.tar.gz", hash = "sha256:3a5726546da54116b687785d38b1db56997ce1d28e53e8d22fc656d8b92e533c"},
 ]
 pyobjc-core = [
-    {file = "pyobjc-core-8.5.tar.gz", hash = "sha256:704c275439856c0d1287469f0d589a7d808d48b754a93d9ce5415d4eaf06d576"},
-    {file = "pyobjc_core-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:0c234143b48334443f5adcf26e668945a6d47bc1fa6223e80918c6c735a029d9"},
-    {file = "pyobjc_core-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:1486ee533f0d76f666804ce89723ada4db56bfde55e56151ba512d3f849857f8"},
-    {file = "pyobjc_core-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:412de06dfa728301c04b3e46fd7453320a8ae8b862e85236e547cd797a73b490"},
-    {file = "pyobjc_core-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:0b3e09cccb1be574a82cc9f929ae27fc4283eccc75496cb5d51534caa6bb83a3"},
-    {file = "pyobjc_core-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:eeafe21f879666ab7f57efcc6b007c9f5f8733d367b7e380c925203ed83f000d"},
-    {file = "pyobjc_core-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:c0071686976d7ea8c14690950e504a13cb22b4ebb2bc7b5ec47c1c1c0f6eff41"},
+    {file = "pyobjc-core-8.2.tar.gz", hash = "sha256:6afb8ee1dd0647cbfaaf99906eca3b43ce045b27e3d4510462d04e7e5361c89b"},
+    {file = "pyobjc_core-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:311e45556c3afa8831713b89017e0204562f51f35661d76c07ffe04985f44e1d"},
+    {file = "pyobjc_core-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:711f361e83382e405e4273ff085178b0cf730901ccf6801f834e7037e50278f9"},
+    {file = "pyobjc_core-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:bdd2e2960ec73214bcfe2d86bb4ca94f5f5119db86d129fa32d3c003b6532c50"},
+    {file = "pyobjc_core-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b879f91fc614c399aafa1d08cf5e279c267510e904bad5c336c3a6064c0eb3aa"},
+    {file = "pyobjc_core-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:b4ef4bdb99a330f5e15cc6273098964276fccbc432453cdba3c2963292bc066c"},
+    {file = "pyobjc_core-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:fd8e5be0955790ff8f9d17a0f356b6eb7eb1ce4995e0c94355c462dd52d22d6d"},
 ]
 pyobjc-framework-applicationservices = [
-    {file = "pyobjc-framework-ApplicationServices-8.5.tar.gz", hash = "sha256:fa3015ef8e3add90af3447d7fdcc7f8dd083cc2a1d58f99a569480a2df10d2b1"},
-    {file = "pyobjc_framework_ApplicationServices-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:436b16ebe448a829a8312e10208eec81a2adcae1fff674dbcc3262e1bd76e0ca"},
-    {file = "pyobjc_framework_ApplicationServices-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:408958d14aa7fcf46f2163754c211078bc63be1368934d86188202914dce077d"},
-    {file = "pyobjc_framework_ApplicationServices-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:1d6cd4ce192859a22e208da4d7177a1c3ceb1ef2f64c339fd881102b1210cadd"},
-    {file = "pyobjc_framework_ApplicationServices-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:0251d092adb1d2d116fd9f147ceef0e53b158a46c21245131c40b9d7b786d0db"},
-    {file = "pyobjc_framework_ApplicationServices-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:9742e69fe6d4545d0e02b0ad0a7a2432bc9944569ee07d6e90ffa5ef614df9f7"},
-    {file = "pyobjc_framework_ApplicationServices-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:16f5677c14ea903c6aaca1dd121521825c39e816cae696d6ae32c0b287252ab2"},
+    {file = "pyobjc-framework-ApplicationServices-8.2.tar.gz", hash = "sha256:f901b2ebb278b7d00033b45cf9ee9d43f651e096ff4c4defa261509238138da8"},
+    {file = "pyobjc_framework_ApplicationServices-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:b5be1757a8df944a58449c628ed68fc76dd746fcd1e96ebb6db0f734e94cdfc8"},
+    {file = "pyobjc_framework_ApplicationServices-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:32657c4b89983a98fbe831a14884954710719e763197968a20ac07e1daa21f1e"},
+    {file = "pyobjc_framework_ApplicationServices-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:6ce2c9701590f752a75151b2fe1e462e7a7ad67dec3119a796711ea93ea01031"},
+    {file = "pyobjc_framework_ApplicationServices-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:28124bc892045222305cf8953b163495bf662c401e54f48905dafb1104d9c1d1"},
+    {file = "pyobjc_framework_ApplicationServices-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:d5c60d66c6ed2569cb042a6c14dd5b9f4d01e182a464b893cd6002ce445b4ddf"},
+    {file = "pyobjc_framework_ApplicationServices-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:e1727fccc1d48922fa28a4cebf4a6d287d633f451cb03779968df60de8cb1bd0"},
 ]
 pyobjc-framework-cocoa = [
-    {file = "pyobjc-framework-Cocoa-8.5.tar.gz", hash = "sha256:569bd3a020f64b536fb2d1c085b37553e50558c9f907e08b73ffc16ae68e1861"},
-    {file = "pyobjc_framework_Cocoa-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:7a7c160416696bf6035dfcdf0e603aaa52858d6afcddfcc5ab41733619ac2529"},
-    {file = "pyobjc_framework_Cocoa-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:6ceba444282030be8596b812260e8d28b671254a51052ad778d32da6e17db847"},
-    {file = "pyobjc_framework_Cocoa-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:f46b2b161b8dd40c7b9e00bc69636c3e6480b2704a69aee22ee0154befbe163a"},
-    {file = "pyobjc_framework_Cocoa-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b31d425aee8698cbf62b187338f5ca59427fa4dca2153a73866f7cb410713119"},
-    {file = "pyobjc_framework_Cocoa-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:898359ac1f76eedec8aa156847682378a8950824421c40edb89391286e607dc4"},
-    {file = "pyobjc_framework_Cocoa-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:baa2947f76b119a3360973d74d57d6dada87ac527bab9a88f31596af392f123c"},
+    {file = "pyobjc-framework-Cocoa-8.2.tar.gz", hash = "sha256:f0901998e2f18415ef6d1f8a12b083f69fc93bd56b3e88040002e3c09bd8c304"},
+    {file = "pyobjc_framework_Cocoa-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:5af73f150e242542735e0663bb5504f88aabaec2a54c60e856cfca3ff6dd9712"},
+    {file = "pyobjc_framework_Cocoa-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:d1de3763ee01850c311da74de5c82c85ec199120e85ab45acaf203accc37a470"},
+    {file = "pyobjc_framework_Cocoa-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:86d69bf667f99f3c43184d8830567195fff94c675fe7f60f899dd90553d9b265"},
+    {file = "pyobjc_framework_Cocoa-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:9dbadb22826392c48b00087359f66579f8404a4f4f77498f31f9869c54bb0fa9"},
+    {file = "pyobjc_framework_Cocoa-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:7adf8b57da1c1292c24375b8e74b6dd45f99a4d3c10ba925a9b38f63a97ba782"},
+    {file = "pyobjc_framework_Cocoa-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:bc8279c8c1544087d46a7e99324f093029df89b8c527c5da2a682bad4cb3197e"},
 ]
 pyobjc-framework-quartz = [
-    {file = "pyobjc-framework-Quartz-8.5.tar.gz", hash = "sha256:d2bc5467a792ddc04814f12a1e9c2fcaf699a1c3ad3d4264cfdce6b9c7b10624"},
-    {file = "pyobjc_framework_Quartz-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e9f0fb663f7872c9de94169031ac42b91ad01bd4cad49a9f1a0164be8f028426"},
-    {file = "pyobjc_framework_Quartz-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:567eec91287cfe9a1b6433717192c585935de8f3daa28d82ce72fdd6c7ac00f6"},
-    {file = "pyobjc_framework_Quartz-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:9f910ab41a712ffc7a8c3e3716a2d6f39ea4419004b26a2fd2d2f740ff5c262c"},
-    {file = "pyobjc_framework_Quartz-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:29d07066781628278bf0e5278abcfc96ef6724c66c5629a0b4c214d319a82e55"},
-    {file = "pyobjc_framework_Quartz-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:72abcde1a3d72be11f2c881c9b9872044c8f2de86d2047b67fe771713638b107"},
-    {file = "pyobjc_framework_Quartz-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:8809b9a2df2f461697bdb45b6d1b5a4f881f88f09450e3990858e64e3e26c530"},
+    {file = "pyobjc-framework-Quartz-8.2.tar.gz", hash = "sha256:219d8797235bf071723f8b0f30a681de0b12875e2d04ae902a3a269f72de0b66"},
+    {file = "pyobjc_framework_Quartz-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e5ab3117201a494b11bb1b80febf5dd288111a196b35731815b656ae30ee6ce3"},
+    {file = "pyobjc_framework_Quartz-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:4941b3039ab7bcf89cb4255c381358de2383c1ab45c9e00c3b64655f271a3b32"},
+    {file = "pyobjc_framework_Quartz-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:ab75a50dea84ec794641522d9f035fc6c19ec4eb37a56c9186b9943575fbc7ab"},
+    {file = "pyobjc_framework_Quartz-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:8cb687b20ebfc467034868b38945b573d1c50f237e379cf86c4f557c9766b759"},
+    {file = "pyobjc_framework_Quartz-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:8b5c3ca1fef900fa66aafe82fff07bc352c60ea7dceed2bb9b5b1db0957b4fea"},
+    {file = "pyobjc_framework_Quartz-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:7bca7e649da77056348d71032def44e345043319d71b0c592197888d92e3eec1"},
 ]
 pyparsing = [
     {file = "pyparsing-2.4.7-py2.py3-none-any.whl", hash = "sha256:ef9d7589ef3c200abe66653d3f1ab1033c3c419ae9b9bdb1240a85b024efc88b"},
@@ -2720,14 +2639,6 @@ python-dateutil = [
     {file = "python-dateutil-2.8.2.tar.gz", hash = "sha256:0123cacc1627ae19ddf3c27a5de5bd67ee4586fbdd6440d9748f8abb483d3e86"},
     {file = "python_dateutil-2.8.2-py2.py3-none-any.whl", hash = "sha256:961d03dc3453ebbc59dbdea9e4e11c5651520a876d0f4db161e8674aae935da9"},
 ]
-python-engineio = [
-    {file = "python-engineio-3.14.2.tar.gz", hash = "sha256:eab4553f2804c1ce97054c8b22cf0d5a9ab23128075248b97e1a5b2f29553085"},
-    {file = "python_engineio-3.14.2-py2.py3-none-any.whl", hash = "sha256:5a9e6086d192463b04a1428ff1f85b6ba631bbb19d453b144ffc04f530542b84"},
-]
-python-socketio = [
-    {file = "python-socketio-4.6.1.tar.gz", hash = "sha256:cd1f5aa492c1eb2be77838e837a495f117e17f686029ebc03d62c09e33f4fa10"},
-    {file = "python_socketio-4.6.1-py2.py3-none-any.whl", hash = "sha256:5a21da53fdbdc6bb6c8071f40e13d100e0b279ad997681c2492478e06f370523"},
-]
 python-xlib = [
     {file = "python-xlib-0.31.tar.gz", hash = "sha256:74d83a081f532bc07f6d7afcd6416ec38403d68f68b9b9dc9e1f28fbf2d799e9"},
     {file = "python_xlib-0.31-py2.py3-none-any.whl", hash = "sha256:1ec6ce0de73d9e6592ead666779a5732b384e5b8fb1f1886bd0a81cafa477759"},
@@ -2736,8 +2647,8 @@ python3-xlib = [
     {file = "python3-xlib-0.15.tar.gz", hash = "sha256:dc4245f3ae4aa5949c1d112ee4723901ade37a96721ba9645f2bfa56e5b383f8"},
 ]
 pytz = [
-    {file = "pytz-2022.1-py2.py3-none-any.whl", hash = "sha256:e68985985296d9a66a881eb3193b0906246245294a881e7c8afe623866ac6a5c"},
-    {file = "pytz-2022.1.tar.gz", hash = "sha256:1e760e2fe6a8163bc0b3d9a19c4f84342afa0a2affebfaa84b01b978a02ecaa7"},
+    {file = "pytz-2021.3-py2.py3-none-any.whl", hash = "sha256:3672058bc3453457b622aab7a1c3bfd5ab0bdae451512f6cf25f64ed37f5b87c"},
+    {file = "pytz-2021.3.tar.gz", hash = "sha256:acad2d8b20a1af07d4e4c9d2e9285c5ed9104354062f275f3fcd88dcef4f1326"},
 ]
 pywin32 = [
     {file = "pywin32-301-cp35-cp35m-win32.whl", hash = "sha256:93367c96e3a76dfe5003d8291ae16454ca7d84bb24d721e0b74a07610b7be4a7"},
@@ -2756,8 +2667,8 @@ pywin32-ctypes = [
     {file = "pywin32_ctypes-0.2.0-py2.py3-none-any.whl", hash = "sha256:9dc2d991b3479cc2df15930958b674a48a227d5361d413827a4cfd0b5876fc98"},
 ]
 "qt.py" = [
-    {file = "Qt.py-1.3.7-py2.py3-none-any.whl", hash = "sha256:150099d1c6f64c9621a2c9d79d45102ec781c30ee30ee69fc082c6e9be7324fe"},
-    {file = "Qt.py-1.3.7.tar.gz", hash = "sha256:803c7bdf4d6230f9a466be19d55934a173eabb61406d21cb91e80c2a3f773b1f"},
+    {file = "Qt.py-1.3.6-py2.py3-none-any.whl", hash = "sha256:7edf6048d07a6924707506b5ba34a6e05d66dde9a3f4e3a62f9996ccab0b91c7"},
+    {file = "Qt.py-1.3.6.tar.gz", hash = "sha256:0d78656a2f814602eee304521c7bf5da0cec414818b3833712c77524294c404a"},
 ]
 qtawesome = [
     {file = "QtAwesome-0.7.3-py2.py3-none-any.whl", hash = "sha256:ddf4530b4af71cec13b24b88a4cdb56ec85b1e44c43c42d0698804c7137b09b0"},
@@ -2772,29 +2683,28 @@ recommonmark = [
     {file = "recommonmark-0.7.1.tar.gz", hash = "sha256:bdb4db649f2222dcd8d2d844f0006b958d627f732415d399791ee436a3686d67"},
 ]
 requests = [
-    {file = "requests-2.27.1-py2.py3-none-any.whl", hash = "sha256:f22fa1e554c9ddfd16e6e41ac79759e17be9e492b3587efa038054674760e72d"},
-    {file = "requests-2.27.1.tar.gz", hash = "sha256:68d7c56fd5a8999887728ef304a6d12edc7be74f1cfa47714fc8b414525c9a61"},
+    {file = "requests-2.25.1-py2.py3-none-any.whl", hash = "sha256:c210084e36a42ae6b9219e00e48287def368a26d03a048ddad7bfee44f75871e"},
+    {file = "requests-2.25.1.tar.gz", hash = "sha256:27973dd4a904a4f13b263a19c866c13b92a39ed1c964655f025f3f8d3d75b804"},
 ]
 rsa = [
     {file = "rsa-4.8-py3-none-any.whl", hash = "sha256:95c5d300c4e879ee69708c428ba566c59478fd653cc3a22243eeb8ed846950bb"},
     {file = "rsa-4.8.tar.gz", hash = "sha256:5c6bd9dc7a543b7fe4304a631f8a8a3b674e2bbfc49c2ae96200cdbe55df6b17"},
 ]
 secretstorage = [
-    {file = "SecretStorage-3.3.2-py3-none-any.whl", hash = "sha256:755dc845b6ad76dcbcbc07ea3da75ae54bb1ea529eb72d15f83d26499a5df319"},
-    {file = "SecretStorage-3.3.2.tar.gz", hash = "sha256:0a8eb9645b320881c222e827c26f4cfcf55363e8b374a021981ef886657a912f"},
+    {file = "SecretStorage-3.3.1-py3-none-any.whl", hash = "sha256:422d82c36172d88d6a0ed5afdec956514b189ddbfb72fefab0c8a1cee4eaf71f"},
+    {file = "SecretStorage-3.3.1.tar.gz", hash = "sha256:fd666c51a6bf200643495a04abb261f83229dcb6fd8472ec393df7ffc8b6f195"},
 ]
 semver = [
     {file = "semver-2.13.0-py2.py3-none-any.whl", hash = "sha256:ced8b23dceb22134307c1b8abfa523da14198793d9787ac838e70e29e77458d4"},
     {file = "semver-2.13.0.tar.gz", hash = "sha256:fa0fe2722ee1c3f57eac478820c3a5ae2f624af8264cbdf9000c980ff7f75e3f"},
 ]
-shotgun-api3 = []
 six = [
     {file = "six-1.16.0-py2.py3-none-any.whl", hash = "sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254"},
     {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"},
 ]
 slack-sdk = [
-    {file = "slack_sdk-3.17.0-py2.py3-none-any.whl", hash = "sha256:0816efc43d1d2db8286e8dbcbb2e86fd0f71c206c01c521c2cb054ecb40f9ced"},
-    {file = "slack_sdk-3.17.0.tar.gz", hash = "sha256:860cd0e50c454b955f14321c8c5486a47cc1e0e84116acdb009107f836752feb"},
+    {file = "slack_sdk-3.13.0-py2.py3-none-any.whl", hash = "sha256:54f2a5f7419f1ab932af9e3200f7f2f93db96e0f0eb8ad7d3b4214aa9f124641"},
+    {file = "slack_sdk-3.13.0.tar.gz", hash = "sha256:aae6ce057e286a5e7fe7a9f256e85b886eee556def8e04b82b08f699e64d7f67"},
 ]
 smmap = [
     {file = "smmap-5.0.0-py3-none-any.whl", hash = "sha256:2aba19d6a040e78d8b09de5c57e96207b09ed71d8e55ce0959eeee6c8e190d94"},
@@ -2805,20 +2715,20 @@ snowballstemmer = [
     {file = "snowballstemmer-2.2.0.tar.gz", hash = "sha256:09b16deb8547d3412ad7b590689584cd0fe25ec8db3be37788be3810cbf19cb1"},
 ]
 speedcopy = [
-    {file = "speedcopy-2.1.4-py3-none-any.whl", hash = "sha256:e09eb1de67ae0e0b51d5b99a28882009d565a37a3cb3c6bae121e3a5d3cccb17"},
-    {file = "speedcopy-2.1.4.tar.gz", hash = "sha256:eff007a97e49ec1934df4fa8074f4bd1cf4a3b14c5499d914988785cff0c199a"},
+    {file = "speedcopy-2.1.2-py3-none-any.whl", hash = "sha256:91e271b84c00952812dbf669d360b2610fd8fa198670373e02acf2a04db89a4c"},
+    {file = "speedcopy-2.1.2.tar.gz", hash = "sha256:1b2d779fadebd53a59384f7d286c40b2ef382e0d000fa53011699fcd3190d33f"},
 ]
 sphinx = [
-    {file = "Sphinx-5.0.1-py3-none-any.whl", hash = "sha256:36aa2a3c2f6d5230be94585bc5d74badd5f9ed8f3388b8eedc1726fe45b1ad30"},
-    {file = "Sphinx-5.0.1.tar.gz", hash = "sha256:f4da1187785a5bc7312cc271b0e867a93946c319d106363e102936a3d9857306"},
+    {file = "Sphinx-3.5.3-py3-none-any.whl", hash = "sha256:3f01732296465648da43dec8fb40dc451ba79eb3e2cc5c6d79005fd98197107d"},
+    {file = "Sphinx-3.5.3.tar.gz", hash = "sha256:ce9c228456131bab09a3d7d10ae58474de562a6f79abb3dc811ae401cf8c1abc"},
 ]
 sphinx-qt-documentation = [
-    {file = "sphinx_qt_documentation-0.4-py3-none-any.whl", hash = "sha256:fa131093f75cd1bd48699cd132e18e4d46ba9eaadc070e6026867cea75ecdb7b"},
-    {file = "sphinx_qt_documentation-0.4.tar.gz", hash = "sha256:f43ba17baa93e353fb94045027fb67f9d935ed158ce8662de93f08b88eec6774"},
+    {file = "sphinx_qt_documentation-0.3-py3-none-any.whl", hash = "sha256:bee247cb9e4fc03fc496d07adfdb943100e1103320c3e5e820e0cfa7c790d9b6"},
+    {file = "sphinx_qt_documentation-0.3.tar.gz", hash = "sha256:f09a0c9d9e989172ba3e282b92bf55613bb23ad47315ec5b0d38536b343ac6c8"},
 ]
 sphinx-rtd-theme = [
-    {file = "sphinx_rtd_theme-1.0.0-py2.py3-none-any.whl", hash = "sha256:4d35a56f4508cfee4c4fb604373ede6feae2a306731d533f409ef5c3496fdbd8"},
-    {file = "sphinx_rtd_theme-1.0.0.tar.gz", hash = "sha256:eec6d497e4c2195fa0e8b2016b337532b8a699a68bcb22a512870e16925c6a5c"},
+    {file = "sphinx_rtd_theme-0.5.1-py2.py3-none-any.whl", hash = "sha256:fa6bebd5ab9a73da8e102509a86f3fcc36dec04a0b52ea80e5a033b2aba00113"},
+    {file = "sphinx_rtd_theme-0.5.1.tar.gz", hash = "sha256:eda689eda0c7301a80cf122dad28b1861e5605cbf455558f3775e1e8200e83a5"},
 ]
 sphinxcontrib-applehelp = [
     {file = "sphinxcontrib-applehelp-1.0.2.tar.gz", hash = "sha256:a072735ec80e7675e3f432fcae8610ecf509c5f1869d17e2eecff44389cdbc58"},
@@ -2861,34 +2771,34 @@ toml = [
     {file = "toml-0.10.2.tar.gz", hash = "sha256:b3bda1d108d5dd99f4a20d24d9c348e91c4db7ab1b749200bded2f839ccbe68f"},
 ]
 tomli = [
-    {file = "tomli-2.0.1-py3-none-any.whl", hash = "sha256:939de3e7a6161af0c887ef91b7d41a53e7c5a1ca976325f429cb46ea9bc30ecc"},
-    {file = "tomli-2.0.1.tar.gz", hash = "sha256:de526c12914f0c550d15924c62d72abc48d6fe7364aa87328337a31007fe8a4f"},
+    {file = "tomli-2.0.0-py3-none-any.whl", hash = "sha256:b5bde28da1fed24b9bd1d4d2b8cba62300bfb4ec9a6187a957e8ddb9434c5224"},
+    {file = "tomli-2.0.0.tar.gz", hash = "sha256:c292c34f58502a1eb2bbb9f5bbc9a5ebc37bee10ffb8c2d6bbdfa8eb13cc14e1"},
 ]
 typed-ast = [
-    {file = "typed_ast-1.5.4-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:669dd0c4167f6f2cd9f57041e03c3c2ebf9063d0757dc89f79ba1daa2bfca9d4"},
-    {file = "typed_ast-1.5.4-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:211260621ab1cd7324e0798d6be953d00b74e0428382991adfddb352252f1d62"},
-    {file = "typed_ast-1.5.4-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:267e3f78697a6c00c689c03db4876dd1efdfea2f251a5ad6555e82a26847b4ac"},
-    {file = "typed_ast-1.5.4-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:c542eeda69212fa10a7ada75e668876fdec5f856cd3d06829e6aa64ad17c8dfe"},
-    {file = "typed_ast-1.5.4-cp310-cp310-win_amd64.whl", hash = "sha256:a9916d2bb8865f973824fb47436fa45e1ebf2efd920f2b9f99342cb7fab93f72"},
-    {file = "typed_ast-1.5.4-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:79b1e0869db7c830ba6a981d58711c88b6677506e648496b1f64ac7d15633aec"},
-    {file = "typed_ast-1.5.4-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a94d55d142c9265f4ea46fab70977a1944ecae359ae867397757d836ea5a3f47"},
-    {file = "typed_ast-1.5.4-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:183afdf0ec5b1b211724dfef3d2cad2d767cbefac291f24d69b00546c1837fb6"},
-    {file = "typed_ast-1.5.4-cp36-cp36m-win_amd64.whl", hash = "sha256:639c5f0b21776605dd6c9dbe592d5228f021404dafd377e2b7ac046b0349b1a1"},
-    {file = "typed_ast-1.5.4-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:cf4afcfac006ece570e32d6fa90ab74a17245b83dfd6655a6f68568098345ff6"},
-    {file = "typed_ast-1.5.4-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ed855bbe3eb3715fca349c80174cfcfd699c2f9de574d40527b8429acae23a66"},
-    {file = "typed_ast-1.5.4-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:6778e1b2f81dfc7bc58e4b259363b83d2e509a65198e85d5700dfae4c6c8ff1c"},
-    {file = "typed_ast-1.5.4-cp37-cp37m-win_amd64.whl", hash = "sha256:0261195c2062caf107831e92a76764c81227dae162c4f75192c0d489faf751a2"},
-    {file = "typed_ast-1.5.4-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:2efae9db7a8c05ad5547d522e7dbe62c83d838d3906a3716d1478b6c1d61388d"},
-    {file = "typed_ast-1.5.4-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:7d5d014b7daa8b0bf2eaef684295acae12b036d79f54178b92a2b6a56f92278f"},
-    {file = "typed_ast-1.5.4-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:370788a63915e82fd6f212865a596a0fefcbb7d408bbbb13dea723d971ed8bdc"},
-    {file = "typed_ast-1.5.4-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:4e964b4ff86550a7a7d56345c7864b18f403f5bd7380edf44a3c1fb4ee7ac6c6"},
-    {file = "typed_ast-1.5.4-cp38-cp38-win_amd64.whl", hash = "sha256:683407d92dc953c8a7347119596f0b0e6c55eb98ebebd9b23437501b28dcbb8e"},
-    {file = "typed_ast-1.5.4-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:4879da6c9b73443f97e731b617184a596ac1235fe91f98d279a7af36c796da35"},
-    {file = "typed_ast-1.5.4-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:3e123d878ba170397916557d31c8f589951e353cc95fb7f24f6bb69adc1a8a97"},
-    {file = "typed_ast-1.5.4-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ebd9d7f80ccf7a82ac5f88c521115cc55d84e35bf8b446fcd7836eb6b98929a3"},
-    {file = "typed_ast-1.5.4-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:98f80dee3c03455e92796b58b98ff6ca0b2a6f652120c263efdba4d6c5e58f72"},
-    {file = "typed_ast-1.5.4-cp39-cp39-win_amd64.whl", hash = "sha256:0fdbcf2fef0ca421a3f5912555804296f0b0960f0418c440f5d6d3abb549f3e1"},
-    {file = "typed_ast-1.5.4.tar.gz", hash = "sha256:39e21ceb7388e4bb37f4c679d72707ed46c2fbf2a5609b8b8ebc4b067d977df2"},
+    {file = "typed_ast-1.5.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:183b183b7771a508395d2cbffd6db67d6ad52958a5fdc99f450d954003900266"},
+    {file = "typed_ast-1.5.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:676d051b1da67a852c0447621fdd11c4e104827417bf216092ec3e286f7da596"},
+    {file = "typed_ast-1.5.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bc2542e83ac8399752bc16e0b35e038bdb659ba237f4222616b4e83fb9654985"},
+    {file = "typed_ast-1.5.2-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:74cac86cc586db8dfda0ce65d8bcd2bf17b58668dfcc3652762f3ef0e6677e76"},
+    {file = "typed_ast-1.5.2-cp310-cp310-win_amd64.whl", hash = "sha256:18fe320f354d6f9ad3147859b6e16649a0781425268c4dde596093177660e71a"},
+    {file = "typed_ast-1.5.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:31d8c6b2df19a777bc8826770b872a45a1f30cfefcfd729491baa5237faae837"},
+    {file = "typed_ast-1.5.2-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:963a0ccc9a4188524e6e6d39b12c9ca24cc2d45a71cfdd04a26d883c922b4b78"},
+    {file = "typed_ast-1.5.2-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:0eb77764ea470f14fcbb89d51bc6bbf5e7623446ac4ed06cbd9ca9495b62e36e"},
+    {file = "typed_ast-1.5.2-cp36-cp36m-win_amd64.whl", hash = "sha256:294a6903a4d087db805a7656989f613371915fc45c8cc0ddc5c5a0a8ad9bea4d"},
+    {file = "typed_ast-1.5.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:26a432dc219c6b6f38be20a958cbe1abffcc5492821d7e27f08606ef99e0dffd"},
+    {file = "typed_ast-1.5.2-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c7407cfcad702f0b6c0e0f3e7ab876cd1d2c13b14ce770e412c0c4b9728a0f88"},
+    {file = "typed_ast-1.5.2-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:f30ddd110634c2d7534b2d4e0e22967e88366b0d356b24de87419cc4410c41b7"},
+    {file = "typed_ast-1.5.2-cp37-cp37m-win_amd64.whl", hash = "sha256:8c08d6625bb258179b6e512f55ad20f9dfef019bbfbe3095247401e053a3ea30"},
+    {file = "typed_ast-1.5.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:90904d889ab8e81a956f2c0935a523cc4e077c7847a836abee832f868d5c26a4"},
+    {file = "typed_ast-1.5.2-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:bbebc31bf11762b63bf61aaae232becb41c5bf6b3461b80a4df7e791fabb3aca"},
+    {file = "typed_ast-1.5.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c29dd9a3a9d259c9fa19d19738d021632d673f6ed9b35a739f48e5f807f264fb"},
+    {file = "typed_ast-1.5.2-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:58ae097a325e9bb7a684572d20eb3e1809802c5c9ec7108e85da1eb6c1a3331b"},
+    {file = "typed_ast-1.5.2-cp38-cp38-win_amd64.whl", hash = "sha256:da0a98d458010bf4fe535f2d1e367a2e2060e105978873c04c04212fb20543f7"},
+    {file = "typed_ast-1.5.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:33b4a19ddc9fc551ebabca9765d54d04600c4a50eda13893dadf67ed81d9a098"},
+    {file = "typed_ast-1.5.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:1098df9a0592dd4c8c0ccfc2e98931278a6c6c53cb3a3e2cf7e9ee3b06153344"},
+    {file = "typed_ast-1.5.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:42c47c3b43fe3a39ddf8de1d40dbbfca60ac8530a36c9b198ea5b9efac75c09e"},
+    {file = "typed_ast-1.5.2-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:f290617f74a610849bd8f5514e34ae3d09eafd521dceaa6cf68b3f4414266d4e"},
+    {file = "typed_ast-1.5.2-cp39-cp39-win_amd64.whl", hash = "sha256:df05aa5b241e2e8045f5f4367a9f6187b09c4cdf8578bb219861c4e27c443db5"},
+    {file = "typed_ast-1.5.2.tar.gz", hash = "sha256:525a2d4088e70a9f75b08b3f87a51acc9cde640e19cc523c7e41aa355564ae27"},
 ]
 typing-extensions = [
     {file = "typing_extensions-4.1.1-py3-none-any.whl", hash = "sha256:21c85e0fe4b9a155d0799430b0ad741cdce7e359660ccbd8b530613e8df88ce2"},
@@ -2899,8 +2809,8 @@ uritemplate = [
     {file = "uritemplate-3.0.1.tar.gz", hash = "sha256:5af8ad10cec94f215e3f48112de2022e1d5a37ed427fbd88652fa908f2ab7cae"},
 ]
 urllib3 = [
-    {file = "urllib3-1.26.9-py2.py3-none-any.whl", hash = "sha256:44ece4d53fb1706f667c9bd1c648f5469a2ec925fcf3a776667042d645472c14"},
-    {file = "urllib3-1.26.9.tar.gz", hash = "sha256:aabaf16477806a5e1dd19aa41f8c2b7950dd3c746362d7e3223dbe6de6ac448e"},
+    {file = "urllib3-1.26.8-py2.py3-none-any.whl", hash = "sha256:000ca7f471a233c2251c6c7023ee85305721bfdf18621ebff4fd17a8653427ed"},
+    {file = "urllib3-1.26.8.tar.gz", hash = "sha256:0e7c33d9a63e7ddfcb86780aac87befc2fbddf46c58dbb487e0855f7ceec283c"},
 ]
 wcwidth = [
     {file = "wcwidth-0.2.5-py2.py3-none-any.whl", hash = "sha256:beb4802a9cebb9144e99086eff703a642a13d6a0052920003a230f3294bbe784"},
@@ -2911,70 +2821,57 @@ websocket-client = [
     {file = "websocket_client-0.59.0-py2.py3-none-any.whl", hash = "sha256:2e50d26ca593f70aba7b13a489435ef88b8fc3b5c5643c1ce8808ff9b40f0b32"},
 ]
 wrapt = [
-    {file = "wrapt-1.14.1-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:1b376b3f4896e7930f1f772ac4b064ac12598d1c38d04907e696cc4d794b43d3"},
-    {file = "wrapt-1.14.1-cp27-cp27m-manylinux1_i686.whl", hash = "sha256:903500616422a40a98a5a3c4ff4ed9d0066f3b4c951fa286018ecdf0750194ef"},
-    {file = "wrapt-1.14.1-cp27-cp27m-manylinux1_x86_64.whl", hash = "sha256:5a9a0d155deafd9448baff28c08e150d9b24ff010e899311ddd63c45c2445e28"},
-    {file = "wrapt-1.14.1-cp27-cp27m-manylinux2010_i686.whl", hash = "sha256:ddaea91abf8b0d13443f6dac52e89051a5063c7d014710dcb4d4abb2ff811a59"},
-    {file = "wrapt-1.14.1-cp27-cp27m-manylinux2010_x86_64.whl", hash = "sha256:36f582d0c6bc99d5f39cd3ac2a9062e57f3cf606ade29a0a0d6b323462f4dd87"},
-    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux1_i686.whl", hash = "sha256:7ef58fb89674095bfc57c4069e95d7a31cfdc0939e2a579882ac7d55aadfd2a1"},
-    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux1_x86_64.whl", hash = "sha256:e2f83e18fe2f4c9e7db597e988f72712c0c3676d337d8b101f6758107c42425b"},
-    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux2010_i686.whl", hash = "sha256:ee2b1b1769f6707a8a445162ea16dddf74285c3964f605877a20e38545c3c462"},
-    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux2010_x86_64.whl", hash = "sha256:833b58d5d0b7e5b9832869f039203389ac7cbf01765639c7309fd50ef619e0b1"},
-    {file = "wrapt-1.14.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:80bb5c256f1415f747011dc3604b59bc1f91c6e7150bd7db03b19170ee06b320"},
-    {file = "wrapt-1.14.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:07f7a7d0f388028b2df1d916e94bbb40624c59b48ecc6cbc232546706fac74c2"},
-    {file = "wrapt-1.14.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:02b41b633c6261feff8ddd8d11c711df6842aba629fdd3da10249a53211a72c4"},
-    {file = "wrapt-1.14.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2fe803deacd09a233e4762a1adcea5db5d31e6be577a43352936179d14d90069"},
-    {file = "wrapt-1.14.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:257fd78c513e0fb5cdbe058c27a0624c9884e735bbd131935fd49e9fe719d310"},
-    {file = "wrapt-1.14.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:4fcc4649dc762cddacd193e6b55bc02edca674067f5f98166d7713b193932b7f"},
-    {file = "wrapt-1.14.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:11871514607b15cfeb87c547a49bca19fde402f32e2b1c24a632506c0a756656"},
-    {file = "wrapt-1.14.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:8ad85f7f4e20964db4daadcab70b47ab05c7c1cf2a7c1e51087bfaa83831854c"},
-    {file = "wrapt-1.14.1-cp310-cp310-win32.whl", hash = "sha256:a9a52172be0b5aae932bef82a79ec0a0ce87288c7d132946d645eba03f0ad8a8"},
-    {file = "wrapt-1.14.1-cp310-cp310-win_amd64.whl", hash = "sha256:6d323e1554b3d22cfc03cd3243b5bb815a51f5249fdcbb86fda4bf62bab9e164"},
-    {file = "wrapt-1.14.1-cp35-cp35m-manylinux1_i686.whl", hash = "sha256:43ca3bbbe97af00f49efb06e352eae40434ca9d915906f77def219b88e85d907"},
-    {file = "wrapt-1.14.1-cp35-cp35m-manylinux1_x86_64.whl", hash = "sha256:6b1a564e6cb69922c7fe3a678b9f9a3c54e72b469875aa8018f18b4d1dd1adf3"},
-    {file = "wrapt-1.14.1-cp35-cp35m-manylinux2010_i686.whl", hash = "sha256:00b6d4ea20a906c0ca56d84f93065b398ab74b927a7a3dbd470f6fc503f95dc3"},
-    {file = "wrapt-1.14.1-cp35-cp35m-manylinux2010_x86_64.whl", hash = "sha256:a85d2b46be66a71bedde836d9e41859879cc54a2a04fad1191eb50c2066f6e9d"},
-    {file = "wrapt-1.14.1-cp35-cp35m-win32.whl", hash = "sha256:dbcda74c67263139358f4d188ae5faae95c30929281bc6866d00573783c422b7"},
-    {file = "wrapt-1.14.1-cp35-cp35m-win_amd64.whl", hash = "sha256:b21bb4c09ffabfa0e85e3a6b623e19b80e7acd709b9f91452b8297ace2a8ab00"},
-    {file = "wrapt-1.14.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:9e0fd32e0148dd5dea6af5fee42beb949098564cc23211a88d799e434255a1f4"},
-    {file = "wrapt-1.14.1-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9736af4641846491aedb3c3f56b9bc5568d92b0692303b5a305301a95dfd38b1"},
-    {file = "wrapt-1.14.1-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5b02d65b9ccf0ef6c34cba6cf5bf2aab1bb2f49c6090bafeecc9cd81ad4ea1c1"},
-    {file = "wrapt-1.14.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:21ac0156c4b089b330b7666db40feee30a5d52634cc4560e1905d6529a3897ff"},
-    {file = "wrapt-1.14.1-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:9f3e6f9e05148ff90002b884fbc2a86bd303ae847e472f44ecc06c2cd2fcdb2d"},
-    {file = "wrapt-1.14.1-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:6e743de5e9c3d1b7185870f480587b75b1cb604832e380d64f9504a0535912d1"},
-    {file = "wrapt-1.14.1-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:d79d7d5dc8a32b7093e81e97dad755127ff77bcc899e845f41bf71747af0c569"},
-    {file = "wrapt-1.14.1-cp36-cp36m-win32.whl", hash = "sha256:81b19725065dcb43df02b37e03278c011a09e49757287dca60c5aecdd5a0b8ed"},
-    {file = "wrapt-1.14.1-cp36-cp36m-win_amd64.whl", hash = "sha256:b014c23646a467558be7da3d6b9fa409b2c567d2110599b7cf9a0c5992b3b471"},
-    {file = "wrapt-1.14.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:88bd7b6bd70a5b6803c1abf6bca012f7ed963e58c68d76ee20b9d751c74a3248"},
-    {file = "wrapt-1.14.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b5901a312f4d14c59918c221323068fad0540e34324925c8475263841dbdfe68"},
-    {file = "wrapt-1.14.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d77c85fedff92cf788face9bfa3ebaa364448ebb1d765302e9af11bf449ca36d"},
-    {file = "wrapt-1.14.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8d649d616e5c6a678b26d15ece345354f7c2286acd6db868e65fcc5ff7c24a77"},
-    {file = "wrapt-1.14.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:7d2872609603cb35ca513d7404a94d6d608fc13211563571117046c9d2bcc3d7"},
-    {file = "wrapt-1.14.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:ee6acae74a2b91865910eef5e7de37dc6895ad96fa23603d1d27ea69df545015"},
-    {file = "wrapt-1.14.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:2b39d38039a1fdad98c87279b48bc5dce2c0ca0d73483b12cb72aa9609278e8a"},
-    {file = "wrapt-1.14.1-cp37-cp37m-win32.whl", hash = "sha256:60db23fa423575eeb65ea430cee741acb7c26a1365d103f7b0f6ec412b893853"},
-    {file = "wrapt-1.14.1-cp37-cp37m-win_amd64.whl", hash = "sha256:709fe01086a55cf79d20f741f39325018f4df051ef39fe921b1ebe780a66184c"},
-    {file = "wrapt-1.14.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:8c0ce1e99116d5ab21355d8ebe53d9460366704ea38ae4d9f6933188f327b456"},
-    {file = "wrapt-1.14.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:e3fb1677c720409d5f671e39bac6c9e0e422584e5f518bfd50aa4cbbea02433f"},
-    {file = "wrapt-1.14.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:642c2e7a804fcf18c222e1060df25fc210b9c58db7c91416fb055897fc27e8cc"},
-    {file = "wrapt-1.14.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7b7c050ae976e286906dd3f26009e117eb000fb2cf3533398c5ad9ccc86867b1"},
-    {file = "wrapt-1.14.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ef3f72c9666bba2bab70d2a8b79f2c6d2c1a42a7f7e2b0ec83bb2f9e383950af"},
-    {file = "wrapt-1.14.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:01c205616a89d09827986bc4e859bcabd64f5a0662a7fe95e0d359424e0e071b"},
-    {file = "wrapt-1.14.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:5a0f54ce2c092aaf439813735584b9537cad479575a09892b8352fea5e988dc0"},
-    {file = "wrapt-1.14.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:2cf71233a0ed05ccdabe209c606fe0bac7379fdcf687f39b944420d2a09fdb57"},
-    {file = "wrapt-1.14.1-cp38-cp38-win32.whl", hash = "sha256:aa31fdcc33fef9eb2552cbcbfee7773d5a6792c137b359e82879c101e98584c5"},
-    {file = "wrapt-1.14.1-cp38-cp38-win_amd64.whl", hash = "sha256:d1967f46ea8f2db647c786e78d8cc7e4313dbd1b0aca360592d8027b8508e24d"},
-    {file = "wrapt-1.14.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:3232822c7d98d23895ccc443bbdf57c7412c5a65996c30442ebe6ed3df335383"},
-    {file = "wrapt-1.14.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:988635d122aaf2bdcef9e795435662bcd65b02f4f4c1ae37fbee7401c440b3a7"},
-    {file = "wrapt-1.14.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9cca3c2cdadb362116235fdbd411735de4328c61425b0aa9f872fd76d02c4e86"},
-    {file = "wrapt-1.14.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d52a25136894c63de15a35bc0bdc5adb4b0e173b9c0d07a2be9d3ca64a332735"},
-    {file = "wrapt-1.14.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:40e7bc81c9e2b2734ea4bc1aceb8a8f0ceaac7c5299bc5d69e37c44d9081d43b"},
-    {file = "wrapt-1.14.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:b9b7a708dd92306328117d8c4b62e2194d00c365f18eff11a9b53c6f923b01e3"},
-    {file = "wrapt-1.14.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:6a9a25751acb379b466ff6be78a315e2b439d4c94c1e99cb7266d40a537995d3"},
-    {file = "wrapt-1.14.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:34aa51c45f28ba7f12accd624225e2b1e5a3a45206aa191f6f9aac931d9d56fe"},
-    {file = "wrapt-1.14.1-cp39-cp39-win32.whl", hash = "sha256:dee0ce50c6a2dd9056c20db781e9c1cfd33e77d2d569f5d1d9321c641bb903d5"},
-    {file = "wrapt-1.14.1-cp39-cp39-win_amd64.whl", hash = "sha256:dee60e1de1898bde3b238f18340eec6148986da0455d8ba7848d50470a7a32fb"},
-    {file = "wrapt-1.14.1.tar.gz", hash = "sha256:380a85cf89e0e69b7cfbe2ea9f765f004ff419f34194018a6827ac0e3edfed4d"},
+    {file = "wrapt-1.13.3-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:e05e60ff3b2b0342153be4d1b597bbcfd8330890056b9619f4ad6b8d5c96a81a"},
+    {file = "wrapt-1.13.3-cp27-cp27m-manylinux1_i686.whl", hash = "sha256:85148f4225287b6a0665eef08a178c15097366d46b210574a658c1ff5b377489"},
+    {file = "wrapt-1.13.3-cp27-cp27m-manylinux1_x86_64.whl", hash = "sha256:2dded5496e8f1592ec27079b28b6ad2a1ef0b9296d270f77b8e4a3a796cf6909"},
+    {file = "wrapt-1.13.3-cp27-cp27m-manylinux2010_i686.whl", hash = "sha256:e94b7d9deaa4cc7bac9198a58a7240aaf87fe56c6277ee25fa5b3aa1edebd229"},
+    {file = "wrapt-1.13.3-cp27-cp27m-manylinux2010_x86_64.whl", hash = "sha256:498e6217523111d07cd67e87a791f5e9ee769f9241fcf8a379696e25806965af"},
+    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux1_i686.whl", hash = "sha256:ec7e20258ecc5174029a0f391e1b948bf2906cd64c198a9b8b281b811cbc04de"},
+    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux1_x86_64.whl", hash = "sha256:87883690cae293541e08ba2da22cacaae0a092e0ed56bbba8d018cc486fbafbb"},
+    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux2010_i686.whl", hash = "sha256:f99c0489258086308aad4ae57da9e8ecf9e1f3f30fa35d5e170b4d4896554d80"},
+    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux2010_x86_64.whl", hash = "sha256:6a03d9917aee887690aa3f1747ce634e610f6db6f6b332b35c2dd89412912bca"},
+    {file = "wrapt-1.13.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:936503cb0a6ed28dbfa87e8fcd0a56458822144e9d11a49ccee6d9a8adb2ac44"},
+    {file = "wrapt-1.13.3-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:f9c51d9af9abb899bd34ace878fbec8bf357b3194a10c4e8e0a25512826ef056"},
+    {file = "wrapt-1.13.3-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:220a869982ea9023e163ba915077816ca439489de6d2c09089b219f4e11b6785"},
+    {file = "wrapt-1.13.3-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:0877fe981fd76b183711d767500e6b3111378ed2043c145e21816ee589d91096"},
+    {file = "wrapt-1.13.3-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:43e69ffe47e3609a6aec0fe723001c60c65305784d964f5007d5b4fb1bc6bf33"},
+    {file = "wrapt-1.13.3-cp310-cp310-win32.whl", hash = "sha256:78dea98c81915bbf510eb6a3c9c24915e4660302937b9ae05a0947164248020f"},
+    {file = "wrapt-1.13.3-cp310-cp310-win_amd64.whl", hash = "sha256:ea3e746e29d4000cd98d572f3ee2a6050a4f784bb536f4ac1f035987fc1ed83e"},
+    {file = "wrapt-1.13.3-cp35-cp35m-manylinux1_i686.whl", hash = "sha256:8c73c1a2ec7c98d7eaded149f6d225a692caa1bd7b2401a14125446e9e90410d"},
+    {file = "wrapt-1.13.3-cp35-cp35m-manylinux1_x86_64.whl", hash = "sha256:086218a72ec7d986a3eddb7707c8c4526d677c7b35e355875a0fe2918b059179"},
+    {file = "wrapt-1.13.3-cp35-cp35m-manylinux2010_i686.whl", hash = "sha256:e92d0d4fa68ea0c02d39f1e2f9cb5bc4b4a71e8c442207433d8db47ee79d7aa3"},
+    {file = "wrapt-1.13.3-cp35-cp35m-manylinux2010_x86_64.whl", hash = "sha256:d4a5f6146cfa5c7ba0134249665acd322a70d1ea61732723c7d3e8cc0fa80755"},
+    {file = "wrapt-1.13.3-cp35-cp35m-win32.whl", hash = "sha256:8aab36778fa9bba1a8f06a4919556f9f8c7b33102bd71b3ab307bb3fecb21851"},
+    {file = "wrapt-1.13.3-cp35-cp35m-win_amd64.whl", hash = "sha256:944b180f61f5e36c0634d3202ba8509b986b5fbaf57db3e94df11abee244ba13"},
+    {file = "wrapt-1.13.3-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:2ebdde19cd3c8cdf8df3fc165bc7827334bc4e353465048b36f7deeae8ee0918"},
+    {file = "wrapt-1.13.3-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:610f5f83dd1e0ad40254c306f4764fcdc846641f120c3cf424ff57a19d5f7ade"},
+    {file = "wrapt-1.13.3-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:5601f44a0f38fed36cc07db004f0eedeaadbdcec90e4e90509480e7e6060a5bc"},
+    {file = "wrapt-1.13.3-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:e6906d6f48437dfd80464f7d7af1740eadc572b9f7a4301e7dd3d65db285cacf"},
+    {file = "wrapt-1.13.3-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:766b32c762e07e26f50d8a3468e3b4228b3736c805018e4b0ec8cc01ecd88125"},
+    {file = "wrapt-1.13.3-cp36-cp36m-win32.whl", hash = "sha256:5f223101f21cfd41deec8ce3889dc59f88a59b409db028c469c9b20cfeefbe36"},
+    {file = "wrapt-1.13.3-cp36-cp36m-win_amd64.whl", hash = "sha256:f122ccd12fdc69628786d0c947bdd9cb2733be8f800d88b5a37c57f1f1d73c10"},
+    {file = "wrapt-1.13.3-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:46f7f3af321a573fc0c3586612db4decb7eb37172af1bc6173d81f5b66c2e068"},
+    {file = "wrapt-1.13.3-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:778fd096ee96890c10ce96187c76b3e99b2da44e08c9e24d5652f356873f6709"},
+    {file = "wrapt-1.13.3-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:0cb23d36ed03bf46b894cfec777eec754146d68429c30431c99ef28482b5c1df"},
+    {file = "wrapt-1.13.3-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:96b81ae75591a795d8c90edc0bfaab44d3d41ffc1aae4d994c5aa21d9b8e19a2"},
+    {file = "wrapt-1.13.3-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:7dd215e4e8514004c8d810a73e342c536547038fb130205ec4bba9f5de35d45b"},
+    {file = "wrapt-1.13.3-cp37-cp37m-win32.whl", hash = "sha256:47f0a183743e7f71f29e4e21574ad3fa95676136f45b91afcf83f6a050914829"},
+    {file = "wrapt-1.13.3-cp37-cp37m-win_amd64.whl", hash = "sha256:fd76c47f20984b43d93de9a82011bb6e5f8325df6c9ed4d8310029a55fa361ea"},
+    {file = "wrapt-1.13.3-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b73d4b78807bd299b38e4598b8e7bd34ed55d480160d2e7fdaabd9931afa65f9"},
+    {file = "wrapt-1.13.3-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:ec9465dd69d5657b5d2fa6133b3e1e989ae27d29471a672416fd729b429eb554"},
+    {file = "wrapt-1.13.3-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:dd91006848eb55af2159375134d724032a2d1d13bcc6f81cd8d3ed9f2b8e846c"},
+    {file = "wrapt-1.13.3-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:ae9de71eb60940e58207f8e71fe113c639da42adb02fb2bcbcaccc1ccecd092b"},
+    {file = "wrapt-1.13.3-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:51799ca950cfee9396a87f4a1240622ac38973b6df5ef7a41e7f0b98797099ce"},
+    {file = "wrapt-1.13.3-cp38-cp38-win32.whl", hash = "sha256:4b9c458732450ec42578b5642ac53e312092acf8c0bfce140ada5ca1ac556f79"},
+    {file = "wrapt-1.13.3-cp38-cp38-win_amd64.whl", hash = "sha256:7dde79d007cd6dfa65afe404766057c2409316135cb892be4b1c768e3f3a11cb"},
+    {file = "wrapt-1.13.3-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:981da26722bebb9247a0601e2922cedf8bb7a600e89c852d063313102de6f2cb"},
+    {file = "wrapt-1.13.3-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:705e2af1f7be4707e49ced9153f8d72131090e52be9278b5dbb1498c749a1e32"},
+    {file = "wrapt-1.13.3-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:25b1b1d5df495d82be1c9d2fad408f7ce5ca8a38085e2da41bb63c914baadff7"},
+    {file = "wrapt-1.13.3-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:77416e6b17926d953b5c666a3cb718d5945df63ecf922af0ee576206d7033b5e"},
+    {file = "wrapt-1.13.3-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:865c0b50003616f05858b22174c40ffc27a38e67359fa1495605f96125f76640"},
+    {file = "wrapt-1.13.3-cp39-cp39-win32.whl", hash = "sha256:0a017a667d1f7411816e4bf214646d0ad5b1da2c1ea13dec6c162736ff25a374"},
+    {file = "wrapt-1.13.3-cp39-cp39-win_amd64.whl", hash = "sha256:81bd7c90d28a4b2e1df135bfbd7c23aee3050078ca6441bead44c42483f9ebfb"},
+    {file = "wrapt-1.13.3.tar.gz", hash = "sha256:1fea9cd438686e6682271d36f3481a9f3636195578bab9ca3382e2f5f01fc185"},
 ]
 wsrpc-aiohttp = [
     {file = "wsrpc-aiohttp-3.2.0.tar.gz", hash = "sha256:f467abc51bcdc760fc5aeb7041abdeef46eeca3928dc43dd6e7fa7a533563818"},
@@ -3055,6 +2952,6 @@ yarl = [
     {file = "yarl-1.7.2.tar.gz", hash = "sha256:45399b46d60c253327a460e99856752009fcee5f5d3c80b2f7c0cae1c38d56dd"},
 ]
 zipp = [
-    {file = "zipp-3.8.0-py3-none-any.whl", hash = "sha256:c4f6e5bbf48e74f7a38e7cc5b0480ff42b0ae5178957d564d18932525d5cf099"},
-    {file = "zipp-3.8.0.tar.gz", hash = "sha256:56bf8aadb83c24db6c4b577e13de374ccfb67da2078beba1d037c17980bf43ad"},
+    {file = "zipp-3.7.0-py3-none-any.whl", hash = "sha256:b47250dd24f92b7dd6a0a8fc5244da14608f3ca90a5efcd37a3b1642fac9a375"},
+    {file = "zipp-3.7.0.tar.gz", hash = "sha256:9f50f446828eb9d45b267433fd3e9da8d801f614129124863f9c51ebceafb87d"},
 ]

From 50ec61f1b08ae6895e7817634aa50473626339b0 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 20 Jun 2022 13:49:59 +0200
Subject: [PATCH 0724/1227] use context to get shotgrid project id

---
 .../plugins/publish/collect_shotgrid_entities.py     | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
index 9880425a41..8af47194e6 100644
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
@@ -23,9 +23,11 @@ class CollectShotgridEntities(pyblish.api.ContextPlugin):
         self.log.info(avalon_project)
         self.log.info(avalon_asset)
 
-        sg_project = _get_shotgrid_project(avalon_project)
+        sg_project = _get_shotgrid_project(context)
         sg_task = _get_shotgrid_task(
-            avalon_project, avalon_asset, avalon_task_name
+            avalon_project,
+            avalon_asset,
+            avalon_task_name
         )
         sg_entity = _get_shotgrid_entity(avalon_project, avalon_asset)
 
@@ -67,9 +69,9 @@ def _get_shotgrid_collection(project):
     return client.get_database("shotgrid_openpype").get_collection(project)
 
 
-def _get_shotgrid_project(avalon_project):
-    proj_settings = get_shotgrid_project_settings(avalon_project["name"])
-    shotgrid_project_id = proj_settings.get("shotgrid_project_id")
+def _get_shotgrid_project(context):
+    shotgrid_project_id = context.data["project_settings"].get(
+        "shotgrid_project_id")
     if shotgrid_project_id:
         return {"type": "Project", "id": shotgrid_project_id}
     return {}

From 43c41d2793e18dd0f8b54cdd748dbcd672e8cc35 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 20 Jun 2022 14:04:24 +0200
Subject: [PATCH 0725/1227] Fix - added unc path to zifile command in Harmony

Extracting too large url resulted in 'File not found' issue (side effect was that files in offending directory were skipped).
UNC path seems to help.
---
 .../deadline/plugins/publish/submit_harmony_deadline.py       | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_harmony_deadline.py b/openpype/modules/deadline/plugins/publish/submit_harmony_deadline.py
index 2cf502224f..a1ee5e0957 100644
--- a/openpype/modules/deadline/plugins/publish/submit_harmony_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_harmony_deadline.py
@@ -322,7 +322,9 @@ class HarmonySubmitDeadline(
         )
         unzip_dir = (published_scene.parent / published_scene.stem)
         with _ZipFile(published_scene, "r") as zip_ref:
-            zip_ref.extractall(unzip_dir.as_posix())
+            # UNC path (//?/) added to minimalize risk with extracting
+            # to large file paths
+            zip_ref.extractall("//?/" + str(unzip_dir.as_posix()))
 
         # find any xstage files in directory, prefer the one with the same name
         # as directory (plus extension)

From 47d2a611e9046cb2c87654f3d5d405cb222a0c57 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 20 Jun 2022 14:14:13 +0200
Subject: [PATCH 0726/1227] update poetry lock

---
 poetry.lock | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/poetry.lock b/poetry.lock
index 9ae486d59a..23a70ffb0b 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1287,6 +1287,21 @@ category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
+[[package]]
+name = "shotgun-api3"
+version = "3.3.3"
+description = "Shotgun Python API"
+category = "main"
+optional = false
+python-versions = "*"
+develop = false
+
+[package.source]
+type = "git"
+url = "https://github.com/shotgunsoftware/python-api.git"
+reference = "v3.3.3"
+resolved_reference = "b9f066c0edbea6e0733242e18f32f75489064840"
+
 [[package]]
 name = "six"
 version = "1.16.0"

From ad3380b3a01c8ba3d97c2e2c4dc8ba54da83403c Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 20 Jun 2022 14:17:57 +0200
Subject: [PATCH 0727/1227] remove unused import

---
 .../shotgrid/plugins/publish/collect_shotgrid_entities.py     | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
index 8af47194e6..0b03ac2e5d 100644
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
+++ b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
@@ -3,10 +3,6 @@ import os
 import pyblish.api
 from openpype.lib.mongo import OpenPypeMongoConnection
 
-from openpype.modules.shotgrid.lib.settings import (
-    get_shotgrid_project_settings,
-)
-
 
 class CollectShotgridEntities(pyblish.api.ContextPlugin):
     """Collect shotgrid entities according to the current context"""

From 0417fb17ca38bc79e60b4c7aa70f111cee217f6f Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Mon, 20 Jun 2022 14:48:00 +0200
Subject: [PATCH 0728/1227] poetry lock rebase

---
 poetry.lock | 868 +++++++++++++++++++++++++++++-----------------------
 1 file changed, 492 insertions(+), 376 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 810fa50b90..3e6620b4a2 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -94,7 +94,7 @@ python-dateutil = ">=2.7.0"
 
 [[package]]
 name = "astroid"
-version = "2.9.3"
+version = "2.11.5"
 description = "An abstract syntax tree for Python with inference support."
 category = "dev"
 optional = false
@@ -104,7 +104,7 @@ python-versions = ">=3.6.2"
 lazy-object-proxy = ">=1.4.0"
 typed-ast = {version = ">=1.4.0,<2.0", markers = "implementation_name == \"cpython\" and python_version < \"3.8\""}
 typing-extensions = {version = ">=3.10", markers = "python_version < \"3.10\""}
-wrapt = ">=1.11,<1.14"
+wrapt = ">=1.11,<2"
 
 [[package]]
 name = "async-timeout"
@@ -172,7 +172,7 @@ pytz = ">=2015.7"
 
 [[package]]
 name = "bcrypt"
-version = "3.2.0"
+version = "3.2.2"
 description = "Modern password hashing for your software and your servers"
 category = "main"
 optional = false
@@ -180,7 +180,6 @@ python-versions = ">=3.6"
 
 [package.dependencies]
 cffi = ">=1.1"
-six = ">=1.4.1"
 
 [package.extras]
 tests = ["pytest (>=3.2.1,!=3.3.0)"]
@@ -201,7 +200,7 @@ wcwidth = ">=0.1.4"
 
 [[package]]
 name = "cachetools"
-version = "5.0.0"
+version = "5.2.0"
 description = "Extensible memoizing collections and decorators"
 category = "main"
 optional = false
@@ -209,11 +208,11 @@ python-versions = "~=3.7"
 
 [[package]]
 name = "certifi"
-version = "2021.10.8"
+version = "2022.5.18.1"
 description = "Python package for providing Mozilla's CA Bundle."
 category = "main"
 optional = false
-python-versions = "*"
+python-versions = ">=3.6"
 
 [[package]]
 name = "cffi"
@@ -226,17 +225,9 @@ python-versions = "*"
 [package.dependencies]
 pycparser = "*"
 
-[[package]]
-name = "chardet"
-version = "4.0.0"
-description = "Universal encoding detector for Python 2 and 3"
-category = "main"
-optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
-
 [[package]]
 name = "charset-normalizer"
-version = "2.0.11"
+version = "2.0.12"
 description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet."
 category = "main"
 optional = false
@@ -295,21 +286,21 @@ python-versions = "*"
 
 [[package]]
 name = "coverage"
-version = "6.3.1"
+version = "6.4.1"
 description = "Code coverage measurement for Python"
 category = "dev"
 optional = false
 python-versions = ">=3.7"
 
 [package.dependencies]
-tomli = {version = "*", optional = true, markers = "extra == \"toml\""}
+tomli = {version = "*", optional = true, markers = "python_full_version <= \"3.11.0a6\" and extra == \"toml\""}
 
 [package.extras]
 toml = ["tomli"]
 
 [[package]]
 name = "cryptography"
-version = "36.0.1"
+version = "37.0.2"
 description = "cryptography is a package which provides cryptographic recipes and primitives to Python developers."
 category = "main"
 optional = false
@@ -324,7 +315,7 @@ docstest = ["pyenchant (>=1.6.11)", "twine (>=1.12.0)", "sphinxcontrib-spelling
 pep8test = ["black", "flake8", "flake8-import-order", "pep8-naming"]
 sdist = ["setuptools_rust (>=0.11.4)"]
 ssh = ["bcrypt (>=3.1.5)"]
-test = ["pytest (>=6.2.0)", "pytest-cov", "pytest-subtests", "pytest-xdist", "pretend", "iso8601", "pytz", "hypothesis (>=1.11.4,!=3.79.2)"]
+test = ["pytest (>=6.2.0)", "pytest-benchmark", "pytest-cov", "pytest-subtests", "pytest-xdist", "pretend", "iso8601", "pytz", "hypothesis (>=1.11.4,!=3.79.2)"]
 
 [[package]]
 name = "cx-freeze"
@@ -346,9 +337,34 @@ category = "dev"
 optional = false
 python-versions = "*"
 
+[[package]]
+name = "deprecated"
+version = "1.2.13"
+description = "Python @deprecated decorator to deprecate old python classes, functions or methods."
+category = "main"
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
+
+[package.dependencies]
+wrapt = ">=1.10,<2"
+
+[package.extras]
+dev = ["tox", "bump2version (<1)", "sphinx (<2)", "importlib-metadata (<3)", "importlib-resources (<4)", "configparser (<5)", "sphinxcontrib-websupport (<2)", "zipp (<2)", "PyTest (<5)", "PyTest-Cov (<2.6)", "pytest", "pytest-cov"]
+
+[[package]]
+name = "dill"
+version = "0.3.5.1"
+description = "serialize all of python"
+category = "dev"
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, !=3.6.*"
+
+[package.extras]
+graph = ["objgraph (>=1.7.2)"]
+
 [[package]]
 name = "dnspython"
-version = "2.2.0"
+version = "2.2.1"
 description = "DNS toolkit"
 category = "main"
 optional = false
@@ -364,7 +380,7 @@ wmi = ["wmi (>=1.5.1,<2.0.0)"]
 
 [[package]]
 name = "docutils"
-version = "0.18.1"
+version = "0.17.1"
 description = "Docutils -- Python Documentation Utilities"
 category = "dev"
 optional = false
@@ -372,7 +388,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
 
 [[package]]
 name = "dropbox"
-version = "11.26.0"
+version = "11.31.0"
 description = "Official Dropbox API Client"
 category = "main"
 optional = false
@@ -397,7 +413,7 @@ prefixed = ">=0.3.2"
 
 [[package]]
 name = "evdev"
-version = "1.4.0"
+version = "1.5.0"
 description = "Bindings to the Linux input handling subsystem"
 category = "main"
 optional = false
@@ -451,6 +467,23 @@ category = "main"
 optional = false
 python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*"
 
+[[package]]
+name = "gazu"
+version = "0.8.28"
+description = "Gazu is a client for Zou, the API to store the data of your CG production."
+category = "main"
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
+
+[package.dependencies]
+deprecated = "1.2.13"
+python-socketio = {version = "4.6.1", extras = ["client"], markers = "python_version >= \"3.5\""}
+requests = ">=2.25.1,<=2.27.1"
+
+[package.extras]
+dev = ["wheel"]
+test = ["pytest-cov (==2.12.1)", "requests-mock (==1.9.3)", "pytest (==4.6.11)", "pytest (==6.1.2)", "pytest (==6.2.5)", "black (==21.12b0)", "pre-commit (==2.17.0)"]
+
 [[package]]
 name = "gitdb"
 version = "4.0.9"
@@ -464,7 +497,7 @@ smmap = ">=3.0.1,<6"
 
 [[package]]
 name = "gitpython"
-version = "3.1.26"
+version = "3.1.27"
 description = "GitPython is a python library used to interact with Git repositories"
 category = "dev"
 optional = false
@@ -476,7 +509,7 @@ typing-extensions = {version = ">=3.7.4.3", markers = "python_version < \"3.8\""
 
 [[package]]
 name = "google-api-core"
-version = "2.4.0"
+version = "2.8.1"
 description = "Google API client core library"
 category = "main"
 optional = false
@@ -484,18 +517,18 @@ python-versions = ">=3.6"
 
 [package.dependencies]
 google-auth = ">=1.25.0,<3.0dev"
-googleapis-common-protos = ">=1.52.0,<2.0dev"
-protobuf = ">=3.12.0"
+googleapis-common-protos = ">=1.56.2,<2.0dev"
+protobuf = ">=3.15.0,<4.0.0dev"
 requests = ">=2.18.0,<3.0.0dev"
 
 [package.extras]
 grpc = ["grpcio (>=1.33.2,<2.0dev)", "grpcio-status (>=1.33.2,<2.0dev)"]
-grpcgcp = ["grpcio-gcp (>=0.2.2)"]
-grpcio-gcp = ["grpcio-gcp (>=0.2.2)"]
+grpcgcp = ["grpcio-gcp (>=0.2.2,<1.0dev)"]
+grpcio-gcp = ["grpcio-gcp (>=0.2.2,<1.0dev)"]
 
 [[package]]
 name = "google-api-python-client"
-version = "1.12.10"
+version = "1.12.11"
 description = "Google API Client Library for Python"
 category = "main"
 optional = false
@@ -511,7 +544,7 @@ uritemplate = ">=3.0.0,<4dev"
 
 [[package]]
 name = "google-auth"
-version = "2.6.0"
+version = "2.7.0"
 description = "Google Authentication Library"
 category = "main"
 optional = false
@@ -525,6 +558,7 @@ six = ">=1.9.0"
 
 [package.extras]
 aiohttp = ["requests (>=2.20.0,<3.0.0dev)", "aiohttp (>=3.6.2,<4.0.0dev)"]
+enterprise_cert = ["cryptography (==36.0.2)", "pyopenssl (==22.0.0)"]
 pyopenssl = ["pyopenssl (>=20.0.0)"]
 reauth = ["pyu2f (>=0.1.5)"]
 
@@ -543,21 +577,21 @@ six = "*"
 
 [[package]]
 name = "googleapis-common-protos"
-version = "1.54.0"
+version = "1.56.2"
 description = "Common protobufs used in Google APIs"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-protobuf = ">=3.12.0"
+protobuf = ">=3.15.0,<4.0.0dev"
 
 [package.extras]
-grpc = ["grpcio (>=1.0.0)"]
+grpc = ["grpcio (>=1.0.0,<2.0.0dev)"]
 
 [[package]]
 name = "httplib2"
-version = "0.20.2"
+version = "0.20.4"
 description = "A comprehensive HTTP client library."
 category = "main"
 optional = false
@@ -568,11 +602,11 @@ pyparsing = {version = ">=2.4.2,<3.0.0 || >3.0.0,<3.0.1 || >3.0.1,<3.0.2 || >3.0
 
 [[package]]
 name = "idna"
-version = "2.10"
+version = "3.3"
 description = "Internationalized Domain Names in Applications (IDNA)"
 category = "main"
 optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
+python-versions = ">=3.5"
 
 [[package]]
 name = "imagesize"
@@ -584,7 +618,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "importlib-metadata"
-version = "4.10.1"
+version = "4.11.4"
 description = "Read metadata from Python packages"
 category = "main"
 optional = false
@@ -595,9 +629,9 @@ typing-extensions = {version = ">=3.6.4", markers = "python_version < \"3.8\""}
 zipp = ">=0.5"
 
 [package.extras]
-docs = ["sphinx", "jaraco.packaging (>=8.2)", "rst.linker (>=1.9)"]
+docs = ["sphinx", "jaraco.packaging (>=9)", "rst.linker (>=1.9)"]
 perf = ["ipython"]
-testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "packaging", "pyfakefs", "flufl.flake8", "pytest-perf (>=0.9.2)", "pytest-black (>=0.3.7)", "pytest-mypy", "importlib-resources (>=1.3)"]
+testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "packaging", "pyfakefs", "flufl.flake8", "pytest-perf (>=0.9.2)", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)", "importlib-resources (>=1.3)"]
 
 [[package]]
 name = "iniconfig"
@@ -663,7 +697,7 @@ i18n = ["Babel (>=0.8)"]
 
 [[package]]
 name = "jinxed"
-version = "1.1.0"
+version = "1.2.0"
 description = "Jinxed Terminal Library"
 category = "main"
 optional = false
@@ -777,7 +811,7 @@ pyparsing = ">=2.0.2,<3.0.5 || >3.0.5"
 
 [[package]]
 name = "paramiko"
-version = "2.10.1"
+version = "2.11.0"
 description = "SSH2 protocol library"
 category = "main"
 optional = false
@@ -809,7 +843,7 @@ testing = ["docopt", "pytest (<6.0.0)"]
 
 [[package]]
 name = "pathlib2"
-version = "2.3.6"
+version = "2.3.7.post1"
 description = "Object-oriented filesystem paths"
 category = "main"
 optional = false
@@ -820,23 +854,27 @@ six = "*"
 
 [[package]]
 name = "pillow"
-version = "9.0.1"
+version = "9.1.1"
 description = "Python Imaging Library (Fork)"
 category = "main"
 optional = false
 python-versions = ">=3.7"
 
+[package.extras]
+docs = ["olefile", "sphinx (>=2.4)", "sphinx-copybutton", "sphinx-issues (>=3.0.1)", "sphinx-removed-in", "sphinx-rtd-theme (>=1.0)", "sphinxext-opengraph"]
+tests = ["check-manifest", "coverage", "defusedxml", "markdown2", "olefile", "packaging", "pyroma", "pytest", "pytest-cov", "pytest-timeout"]
+
 [[package]]
 name = "platformdirs"
-version = "2.4.1"
+version = "2.5.2"
 description = "A small Python module for determining appropriate platform-specific dirs, e.g. a \"user data dir\"."
 category = "dev"
 optional = false
 python-versions = ">=3.7"
 
 [package.extras]
-docs = ["Sphinx (>=4)", "furo (>=2021.7.5b38)", "proselint (>=0.10.2)", "sphinx-autodoc-typehints (>=1.12)"]
-test = ["appdirs (==1.4.4)", "pytest (>=6)", "pytest-cov (>=2.7)", "pytest-mock (>=3.6)"]
+docs = ["furo (>=2021.7.5b38)", "proselint (>=0.10.2)", "sphinx-autodoc-typehints (>=1.12)", "sphinx (>=4)"]
+test = ["appdirs (==1.4.4)", "pytest-cov (>=2.7)", "pytest-mock (>=3.6)", "pytest (>=6)"]
 
 [[package]]
 name = "pluggy"
@@ -958,29 +996,33 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "pygments"
-version = "2.11.2"
+version = "2.12.0"
 description = "Pygments is a syntax highlighting package written in Python."
 category = "dev"
 optional = false
-python-versions = ">=3.5"
+python-versions = ">=3.6"
 
 [[package]]
 name = "pylint"
-version = "2.12.2"
+version = "2.13.9"
 description = "python code static checker"
 category = "dev"
 optional = false
 python-versions = ">=3.6.2"
 
 [package.dependencies]
-astroid = ">=2.9.0,<2.10"
+astroid = ">=2.11.5,<=2.12.0-dev0"
 colorama = {version = "*", markers = "sys_platform == \"win32\""}
+dill = ">=0.2"
 isort = ">=4.2.5,<6"
-mccabe = ">=0.6,<0.7"
+mccabe = ">=0.6,<0.8"
 platformdirs = ">=2.2.0"
-toml = ">=0.9.2"
+tomli = {version = ">=1.1.0", markers = "python_version < \"3.11\""}
 typing-extensions = {version = ">=3.10.0", markers = "python_version < \"3.10\""}
 
+[package.extras]
+testutil = ["gitpython (>3)"]
+
 [[package]]
 name = "pymongo"
 version = "3.12.3"
@@ -1031,7 +1073,7 @@ six = "*"
 
 [[package]]
 name = "pyobjc-core"
-version = "8.2"
+version = "8.5"
 description = "Python<->ObjC Interoperability Module"
 category = "main"
 optional = false
@@ -1039,39 +1081,39 @@ python-versions = ">=3.6"
 
 [[package]]
 name = "pyobjc-framework-applicationservices"
-version = "8.2"
+version = "8.5"
 description = "Wrappers for the framework ApplicationServices on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.2"
-pyobjc-framework-Cocoa = ">=8.2"
-pyobjc-framework-Quartz = ">=8.2"
+pyobjc-core = ">=8.5"
+pyobjc-framework-Cocoa = ">=8.5"
+pyobjc-framework-Quartz = ">=8.5"
 
 [[package]]
 name = "pyobjc-framework-cocoa"
-version = "8.2"
+version = "8.5"
 description = "Wrappers for the Cocoa frameworks on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.2"
+pyobjc-core = ">=8.5"
 
 [[package]]
 name = "pyobjc-framework-quartz"
-version = "8.2"
+version = "8.5"
 description = "Wrappers for the Quartz frameworks on macOS"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.dependencies]
-pyobjc-core = ">=8.2"
-pyobjc-framework-Cocoa = ">=8.2"
+pyobjc-core = ">=8.5"
+pyobjc-framework-Cocoa = ">=8.5"
 
 [[package]]
 name = "pyparsing"
@@ -1154,6 +1196,39 @@ python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7"
 [package.dependencies]
 six = ">=1.5"
 
+[[package]]
+name = "python-engineio"
+version = "3.14.2"
+description = "Engine.IO server"
+category = "main"
+optional = false
+python-versions = "*"
+
+[package.dependencies]
+six = ">=1.9.0"
+
+[package.extras]
+asyncio_client = ["aiohttp (>=3.4)"]
+client = ["requests (>=2.21.0)", "websocket-client (>=0.54.0)"]
+
+[[package]]
+name = "python-socketio"
+version = "4.6.1"
+description = "Socket.IO server"
+category = "main"
+optional = false
+python-versions = "*"
+
+[package.dependencies]
+python-engineio = ">=3.13.0,<4"
+requests = {version = ">=2.21.0", optional = true, markers = "extra == \"client\""}
+six = ">=1.9.0"
+websocket-client = {version = ">=0.54.0", optional = true, markers = "extra == \"client\""}
+
+[package.extras]
+asyncio_client = ["aiohttp (>=3.4)", "websockets (>=7.0)"]
+client = ["requests (>=2.21.0)", "websocket-client (>=0.54.0)"]
+
 [[package]]
 name = "python-xlib"
 version = "0.31"
@@ -1175,7 +1250,7 @@ python-versions = "*"
 
 [[package]]
 name = "pytz"
-version = "2021.3"
+version = "2022.1"
 description = "World timezone definitions, modern and historical"
 category = "dev"
 optional = false
@@ -1199,7 +1274,7 @@ python-versions = "*"
 
 [[package]]
 name = "qt.py"
-version = "1.3.6"
+version = "1.3.7"
 description = "Python 2 & 3 compatibility wrapper around all Qt bindings - PySide, PySide2, PyQt4 and PyQt5."
 category = "main"
 optional = false
@@ -1240,21 +1315,21 @@ sphinx = ">=1.3.1"
 
 [[package]]
 name = "requests"
-version = "2.25.1"
+version = "2.27.1"
 description = "Python HTTP for Humans."
 category = "main"
 optional = false
-python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*"
 
 [package.dependencies]
 certifi = ">=2017.4.17"
-chardet = ">=3.0.2,<5"
-idna = ">=2.5,<3"
+charset-normalizer = {version = ">=2.0.0,<2.1.0", markers = "python_version >= \"3\""}
+idna = {version = ">=2.5,<4", markers = "python_version >= \"3\""}
 urllib3 = ">=1.21.1,<1.27"
 
 [package.extras]
-security = ["pyOpenSSL (>=0.14)", "cryptography (>=1.3.4)"]
 socks = ["PySocks (>=1.5.6,!=1.5.7)", "win-inet-pton"]
+use_chardet_on_py3 = ["chardet (>=3.0.2,<5)"]
 
 [[package]]
 name = "rsa"
@@ -1269,7 +1344,7 @@ pyasn1 = ">=0.1.3"
 
 [[package]]
 name = "secretstorage"
-version = "3.3.1"
+version = "3.3.2"
 description = "Python bindings to FreeDesktop.org Secret Service API"
 category = "main"
 optional = false
@@ -1312,7 +1387,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*"
 
 [[package]]
 name = "slack-sdk"
-version = "3.13.0"
+version = "3.17.0"
 description = "The Slack API Platform SDK for Python"
 category = "main"
 optional = false
@@ -1320,7 +1395,7 @@ python-versions = ">=3.6.0"
 
 [package.extras]
 optional = ["aiodns (>1.0)", "aiohttp (>=3.7.3,<4)", "boto3 (<=2)", "SQLAlchemy (>=1,<2)", "websockets (>=10,<11)", "websocket-client (>=1,<2)"]
-testing = ["pytest (>=6.2.5,<7)", "pytest-asyncio (<1)", "Flask-Sockets (>=0.2,<1)", "Flask (>=1,<2)", "Werkzeug (<2)", "pytest-cov (>=2,<3)", "codecov (>=2,<3)", "flake8 (>=4,<5)", "black (==21.12b0)", "psutil (>=5,<6)", "databases (>=0.3)", "boto3 (<=2)", "moto (<2)"]
+testing = ["pytest (>=6.2.5,<7)", "pytest-asyncio (<1)", "Flask-Sockets (>=0.2,<1)", "Flask (>=1,<2)", "Werkzeug (<2)", "itsdangerous (==1.1.0)", "Jinja2 (==3.0.3)", "pytest-cov (>=2,<3)", "codecov (>=2,<3)", "flake8 (>=4,<5)", "black (==22.3.0)", "click (==8.0.4)", "psutil (>=5,<6)", "databases (>=0.5)", "boto3 (<=2)", "moto (>=3,<4)"]
 
 [[package]]
 name = "smmap"
@@ -1340,7 +1415,7 @@ python-versions = "*"
 
 [[package]]
 name = "speedcopy"
-version = "2.1.2"
+version = "2.1.4"
 description = "Replacement or alternative for python copyfile() utilizing server side copy on network shares for faster copying."
 category = "main"
 optional = false
@@ -1348,18 +1423,19 @@ python-versions = "*"
 
 [[package]]
 name = "sphinx"
-version = "3.5.3"
+version = "5.0.1"
 description = "Python documentation generator"
 category = "dev"
 optional = false
-python-versions = ">=3.5"
+python-versions = ">=3.6"
 
 [package.dependencies]
 alabaster = ">=0.7,<0.8"
 babel = ">=1.3"
 colorama = {version = ">=0.3.5", markers = "sys_platform == \"win32\""}
-docutils = ">=0.12"
+docutils = ">=0.14,<0.19"
 imagesize = "*"
+importlib-metadata = {version = ">=4.4", markers = "python_version < \"3.10\""}
 Jinja2 = ">=2.3"
 packaging = "*"
 Pygments = ">=2.0"
@@ -1367,19 +1443,19 @@ requests = ">=2.5.0"
 snowballstemmer = ">=1.1"
 sphinxcontrib-applehelp = "*"
 sphinxcontrib-devhelp = "*"
-sphinxcontrib-htmlhelp = "*"
+sphinxcontrib-htmlhelp = ">=2.0.0"
 sphinxcontrib-jsmath = "*"
 sphinxcontrib-qthelp = "*"
-sphinxcontrib-serializinghtml = "*"
+sphinxcontrib-serializinghtml = ">=1.1.5"
 
 [package.extras]
 docs = ["sphinxcontrib-websupport"]
-lint = ["flake8 (>=3.5.0)", "isort", "mypy (>=0.800)", "docutils-stubs"]
-test = ["pytest", "pytest-cov", "html5lib", "cython", "typed-ast"]
+lint = ["flake8 (>=3.5.0)", "isort", "mypy (>=0.950)", "docutils-stubs", "types-typed-ast", "types-requests"]
+test = ["pytest (>=4.6)", "html5lib", "cython", "typed-ast"]
 
 [[package]]
 name = "sphinx-qt-documentation"
-version = "0.3"
+version = "0.4"
 description = "Plugin for proper resolve intersphinx references for Qt elements"
 category = "dev"
 optional = false
@@ -1389,16 +1465,22 @@ python-versions = ">=3.6"
 docutils = "*"
 sphinx = "*"
 
+[package.extras]
+dev = ["pre-commit"]
+lint = ["black", "flake8", "pylint"]
+test = ["pytest (>=3.0.0)", "pytest-cov"]
+
 [[package]]
 name = "sphinx-rtd-theme"
-version = "0.5.1"
+version = "1.0.0"
 description = "Read the Docs theme for Sphinx"
 category = "dev"
 optional = false
-python-versions = "*"
+python-versions = ">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*"
 
 [package.dependencies]
-sphinx = "*"
+docutils = "<0.18"
+sphinx = ">=1.6"
 
 [package.extras]
 dev = ["transifex-client", "sphinxcontrib-httpdomain", "bump2version"]
@@ -1519,7 +1601,7 @@ python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*"
 
 [[package]]
 name = "tomli"
-version = "2.0.0"
+version = "2.0.1"
 description = "A lil' TOML parser"
 category = "dev"
 optional = false
@@ -1527,7 +1609,7 @@ python-versions = ">=3.7"
 
 [[package]]
 name = "typed-ast"
-version = "1.5.2"
+version = "1.5.4"
 description = "a fork of Python 2 and 3 ast modules with type comment support"
 category = "dev"
 optional = false
@@ -1551,14 +1633,14 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "urllib3"
-version = "1.26.8"
+version = "1.26.9"
 description = "HTTP library with thread-safe connection pooling, file post, and more."
 category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, <4"
 
 [package.extras]
-brotli = ["brotlipy (>=0.6.0)"]
+brotli = ["brotlicffi (>=0.8.0)", "brotli (>=1.0.9)", "brotlipy (>=0.6.0)"]
 secure = ["pyOpenSSL (>=0.14)", "cryptography (>=1.3.4)", "idna (>=2.0.0)", "certifi", "ipaddress"]
 socks = ["PySocks (>=1.5.6,!=1.5.7,<2.0)"]
 
@@ -1583,9 +1665,9 @@ six = "*"
 
 [[package]]
 name = "wrapt"
-version = "1.13.3"
+version = "1.14.1"
 description = "Module for decorators, wrappers and monkey patching."
-category = "dev"
+category = "main"
 optional = false
 python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7"
 
@@ -1621,15 +1703,15 @@ typing-extensions = {version = ">=3.7.4", markers = "python_version < \"3.8\""}
 
 [[package]]
 name = "zipp"
-version = "3.7.0"
+version = "3.8.0"
 description = "Backport of pathlib-compatible object wrapper for zip files"
 category = "main"
 optional = false
 python-versions = ">=3.7"
 
 [package.extras]
-docs = ["sphinx", "jaraco.packaging (>=8.2)", "rst.linker (>=1.9)"]
-testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "jaraco.itertools", "func-timeout", "pytest-black (>=0.3.7)", "pytest-mypy"]
+docs = ["sphinx", "jaraco.packaging (>=9)", "rst.linker (>=1.9)"]
+testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-cov", "pytest-enabler (>=1.0.1)", "jaraco.itertools", "func-timeout", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)"]
 
 [metadata]
 lock-version = "1.1"
@@ -1737,8 +1819,8 @@ arrow = [
     {file = "arrow-0.17.0.tar.gz", hash = "sha256:ff08d10cda1d36c68657d6ad20d74fbea493d980f8b2d45344e00d6ed2bf6ed4"},
 ]
 astroid = [
-    {file = "astroid-2.9.3-py3-none-any.whl", hash = "sha256:506daabe5edffb7e696ad82483ad0228245a9742ed7d2d8c9cdb31537decf9f6"},
-    {file = "astroid-2.9.3.tar.gz", hash = "sha256:1efdf4e867d4d8ba4a9f6cf9ce07cd182c4c41de77f23814feb27ca93ca9d877"},
+    {file = "astroid-2.11.5-py3-none-any.whl", hash = "sha256:14ffbb4f6aa2cf474a0834014005487f7ecd8924996083ab411e7fa0b508ce0b"},
+    {file = "astroid-2.11.5.tar.gz", hash = "sha256:f4e4ec5294c4b07ac38bab9ca5ddd3914d4bf46f9006eb5c0ae755755061044e"},
 ]
 async-timeout = [
     {file = "async-timeout-4.0.2.tar.gz", hash = "sha256:2163e1640ddb52b7a8c80d0a67a08587e5d245cc9c553a74a847056bc2976b15"},
@@ -1765,28 +1847,29 @@ babel = [
     {file = "Babel-2.9.1.tar.gz", hash = "sha256:bc0c176f9f6a994582230df350aa6e05ba2ebe4b3ac317eab29d9be5d2768da0"},
 ]
 bcrypt = [
-    {file = "bcrypt-3.2.0-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:b589229207630484aefe5899122fb938a5b017b0f4349f769b8c13e78d99a8fd"},
-    {file = "bcrypt-3.2.0-cp36-abi3-macosx_10_9_x86_64.whl", hash = "sha256:c95d4cbebffafcdd28bd28bb4e25b31c50f6da605c81ffd9ad8a3d1b2ab7b1b6"},
-    {file = "bcrypt-3.2.0-cp36-abi3-manylinux1_x86_64.whl", hash = "sha256:63d4e3ff96188e5898779b6057878fecf3f11cfe6ec3b313ea09955d587ec7a7"},
-    {file = "bcrypt-3.2.0-cp36-abi3-manylinux2010_x86_64.whl", hash = "sha256:cd1ea2ff3038509ea95f687256c46b79f5fc382ad0aa3664d200047546d511d1"},
-    {file = "bcrypt-3.2.0-cp36-abi3-manylinux2014_aarch64.whl", hash = "sha256:cdcdcb3972027f83fe24a48b1e90ea4b584d35f1cc279d76de6fc4b13376239d"},
-    {file = "bcrypt-3.2.0-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:a0584a92329210fcd75eb8a3250c5a941633f8bfaf2a18f81009b097732839b7"},
-    {file = "bcrypt-3.2.0-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:56e5da069a76470679f312a7d3d23deb3ac4519991a0361abc11da837087b61d"},
-    {file = "bcrypt-3.2.0-cp36-abi3-win32.whl", hash = "sha256:a67fb841b35c28a59cebed05fbd3e80eea26e6d75851f0574a9273c80f3e9b55"},
-    {file = "bcrypt-3.2.0-cp36-abi3-win_amd64.whl", hash = "sha256:81fec756feff5b6818ea7ab031205e1d323d8943d237303baca2c5f9c7846f34"},
-    {file = "bcrypt-3.2.0.tar.gz", hash = "sha256:5b93c1726e50a93a033c36e5ca7fdcd29a5c7395af50a6892f5d9e7c6cfbfb29"},
+    {file = "bcrypt-3.2.2-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:7180d98a96f00b1050e93f5b0f556e658605dd9f524d0b0e68ae7944673f525e"},
+    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:61bae49580dce88095d669226d5076d0b9d927754cedbdf76c6c9f5099ad6f26"},
+    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:88273d806ab3a50d06bc6a2fc7c87d737dd669b76ad955f449c43095389bc8fb"},
+    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:6d2cb9d969bfca5bc08e45864137276e4c3d3d7de2b162171def3d188bf9d34a"},
+    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2b02d6bfc6336d1094276f3f588aa1225a598e27f8e3388f4db9948cb707b521"},
+    {file = "bcrypt-3.2.2-cp36-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:a2c46100e315c3a5b90fdc53e429c006c5f962529bc27e1dfd656292c20ccc40"},
+    {file = "bcrypt-3.2.2-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:7d9ba2e41e330d2af4af6b1b6ec9e6128e91343d0b4afb9282e54e5508f31baa"},
+    {file = "bcrypt-3.2.2-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:cd43303d6b8a165c29ec6756afd169faba9396a9472cdff753fe9f19b96ce2fa"},
+    {file = "bcrypt-3.2.2-cp36-abi3-win32.whl", hash = "sha256:4e029cef560967fb0cf4a802bcf4d562d3d6b4b1bf81de5ec1abbe0f1adb027e"},
+    {file = "bcrypt-3.2.2-cp36-abi3-win_amd64.whl", hash = "sha256:7ff2069240c6bbe49109fe84ca80508773a904f5a8cb960e02a977f7f519b129"},
+    {file = "bcrypt-3.2.2.tar.gz", hash = "sha256:433c410c2177057705da2a9f2cd01dd157493b2a7ac14c8593a16b3dab6b6bfb"},
 ]
 blessed = [
     {file = "blessed-1.19.1-py2.py3-none-any.whl", hash = "sha256:63b8554ae2e0e7f43749b6715c734cc8f3883010a809bf16790102563e6cf25b"},
     {file = "blessed-1.19.1.tar.gz", hash = "sha256:9a0d099695bf621d4680dd6c73f6ad547f6a3442fbdbe80c4b1daa1edbc492fc"},
 ]
 cachetools = [
-    {file = "cachetools-5.0.0-py3-none-any.whl", hash = "sha256:8fecd4203a38af17928be7b90689d8083603073622229ca7077b72d8e5a976e4"},
-    {file = "cachetools-5.0.0.tar.gz", hash = "sha256:486471dfa8799eb7ec503a8059e263db000cdda20075ce5e48903087f79d5fd6"},
+    {file = "cachetools-5.2.0-py3-none-any.whl", hash = "sha256:f9f17d2aec496a9aa6b76f53e3b614c965223c061982d434d160f930c698a9db"},
+    {file = "cachetools-5.2.0.tar.gz", hash = "sha256:6a94c6402995a99c3970cc7e4884bb60b4a8639938157eeed436098bf9831757"},
 ]
 certifi = [
-    {file = "certifi-2021.10.8-py2.py3-none-any.whl", hash = "sha256:d62a0163eb4c2344ac042ab2bdf75399a71a2d8c7d47eac2e2ee91b9d6339569"},
-    {file = "certifi-2021.10.8.tar.gz", hash = "sha256:78884e7c1d4b00ce3cea67b44566851c4343c120abd683433ce934a68ea58872"},
+    {file = "certifi-2022.5.18.1-py3-none-any.whl", hash = "sha256:f1d53542ee8cbedbe2118b5686372fb33c297fcd6379b050cca0ef13a597382a"},
+    {file = "certifi-2022.5.18.1.tar.gz", hash = "sha256:9c5705e395cd70084351dd8ad5c41e65655e08ce46f2ec9cf6c2c08390f71eb7"},
 ]
 cffi = [
     {file = "cffi-1.15.0-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:c2502a1a03b6312837279c8c1bd3ebedf6c12c4228ddbad40912d671ccc8a962"},
@@ -1840,13 +1923,9 @@ cffi = [
     {file = "cffi-1.15.0-cp39-cp39-win_amd64.whl", hash = "sha256:3773c4d81e6e818df2efbc7dd77325ca0dcb688116050fb2b3011218eda36139"},
     {file = "cffi-1.15.0.tar.gz", hash = "sha256:920f0d66a896c2d99f0adbb391f990a84091179542c205fa53ce5787aff87954"},
 ]
-chardet = [
-    {file = "chardet-4.0.0-py2.py3-none-any.whl", hash = "sha256:f864054d66fd9118f2e67044ac8981a54775ec5b67aed0441892edb553d21da5"},
-    {file = "chardet-4.0.0.tar.gz", hash = "sha256:0d6f53a15db4120f2b08c94f11e7d93d2c911ee118b6b30a04ec3ee8310179fa"},
-]
 charset-normalizer = [
-    {file = "charset-normalizer-2.0.11.tar.gz", hash = "sha256:98398a9d69ee80548c762ba991a4728bfc3836768ed226b3945908d1a688371c"},
-    {file = "charset_normalizer-2.0.11-py3-none-any.whl", hash = "sha256:2842d8f5e82a1f6aa437380934d5e1cd4fcf2003b06fed6940769c164a480a45"},
+    {file = "charset-normalizer-2.0.12.tar.gz", hash = "sha256:2857e29ff0d34db842cd7ca3230549d1a697f96ee6d3fb071cfa6c7393832597"},
+    {file = "charset_normalizer-2.0.12-py3-none-any.whl", hash = "sha256:6881edbebdb17b39b4eaaa821b438bf6eddffb4468cf344f09f89def34a8b1df"},
 ]
 click = [
     {file = "click-7.1.2-py2.py3-none-any.whl", hash = "sha256:dacca89f4bfadd5de3d7489b7c8a566eee0d3676333fbb50030263894c38c0dc"},
@@ -1869,69 +1948,71 @@ coolname = [
     {file = "coolname-1.1.0.tar.gz", hash = "sha256:410fe6ea9999bf96f2856ef0c726d5f38782bbefb7bb1aca0e91e0dc98ed09e3"},
 ]
 coverage = [
-    {file = "coverage-6.3.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:eeffd96882d8c06d31b65dddcf51db7c612547babc1c4c5db6a011abe9798525"},
-    {file = "coverage-6.3.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:621f6ea7260ea2ffdaec64fe5cb521669984f567b66f62f81445221d4754df4c"},
-    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:84f2436d6742c01136dd940ee158bfc7cf5ced3da7e4c949662b8703b5cd8145"},
-    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:de73fca6fb403dd72d4da517cfc49fcf791f74eee697d3219f6be29adf5af6ce"},
-    {file = "coverage-6.3.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:78fbb2be068a13a5d99dce9e1e7d168db880870f7bc73f876152130575bd6167"},
-    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:f5a4551dfd09c3bd12fca8144d47fe7745275adf3229b7223c2f9e29a975ebda"},
-    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:7bff3a98f63b47464480de1b5bdd80c8fade0ba2832c9381253c9b74c4153c27"},
-    {file = "coverage-6.3.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:a06c358f4aed05fa1099c39decc8022261bb07dfadc127c08cfbd1391b09689e"},
-    {file = "coverage-6.3.1-cp310-cp310-win32.whl", hash = "sha256:9fff3ff052922cb99f9e52f63f985d4f7a54f6b94287463bc66b7cdf3eb41217"},
-    {file = "coverage-6.3.1-cp310-cp310-win_amd64.whl", hash = "sha256:276b13cc085474e482566c477c25ed66a097b44c6e77132f3304ac0b039f83eb"},
-    {file = "coverage-6.3.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:56c4a409381ddd7bbff134e9756077860d4e8a583d310a6f38a2315b9ce301d0"},
-    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9eb494070aa060ceba6e4bbf44c1bc5fa97bfb883a0d9b0c9049415f9e944793"},
-    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5e15d424b8153756b7c903bde6d4610be0c3daca3986173c18dd5c1a1625e4cd"},
-    {file = "coverage-6.3.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:61d47a897c1e91f33f177c21de897267b38fbb45f2cd8e22a710bcef1df09ac1"},
-    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:25e73d4c81efa8ea3785274a2f7f3bfbbeccb6fcba2a0bdd3be9223371c37554"},
-    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:fac0bcc5b7e8169bffa87f0dcc24435446d329cbc2b5486d155c2e0f3b493ae1"},
-    {file = "coverage-6.3.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:72128176fea72012063200b7b395ed8a57849282b207321124d7ff14e26988e8"},
-    {file = "coverage-6.3.1-cp37-cp37m-win32.whl", hash = "sha256:1bc6d709939ff262fd1432f03f080c5042dc6508b6e0d3d20e61dd045456a1a0"},
-    {file = "coverage-6.3.1-cp37-cp37m-win_amd64.whl", hash = "sha256:618eeba986cea7f621d8607ee378ecc8c2504b98b3fdc4952b30fe3578304687"},
-    {file = "coverage-6.3.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:d5ed164af5c9078596cfc40b078c3b337911190d3faeac830c3f1274f26b8320"},
-    {file = "coverage-6.3.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:352c68e233409c31048a3725c446a9e48bbff36e39db92774d4f2380d630d8f8"},
-    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:448d7bde7ceb6c69e08474c2ddbc5b4cd13c9e4aa4a717467f716b5fc938a734"},
-    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9fde6b90889522c220dd56a670102ceef24955d994ff7af2cb786b4ba8fe11e4"},
-    {file = "coverage-6.3.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e647a0be741edbb529a72644e999acb09f2ad60465f80757da183528941ff975"},
-    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:6a5cdc3adb4f8bb8d8f5e64c2e9e282bc12980ef055ec6da59db562ee9bdfefa"},
-    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:2dd70a167843b4b4b2630c0c56f1b586fe965b4f8ac5da05b6690344fd065c6b"},
-    {file = "coverage-6.3.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:9ad0a117b8dc2061ce9461ea4c1b4799e55edceb236522c5b8f958ce9ed8fa9a"},
-    {file = "coverage-6.3.1-cp38-cp38-win32.whl", hash = "sha256:e92c7a5f7d62edff50f60a045dc9542bf939758c95b2fcd686175dd10ce0ed10"},
-    {file = "coverage-6.3.1-cp38-cp38-win_amd64.whl", hash = "sha256:482fb42eea6164894ff82abbcf33d526362de5d1a7ed25af7ecbdddd28fc124f"},
-    {file = "coverage-6.3.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:c5b81fb37db76ebea79aa963b76d96ff854e7662921ce742293463635a87a78d"},
-    {file = "coverage-6.3.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:a4f923b9ab265136e57cc14794a15b9dcea07a9c578609cd5dbbfff28a0d15e6"},
-    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:56d296cbc8254a7dffdd7bcc2eb70be5a233aae7c01856d2d936f5ac4e8ac1f1"},
-    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1245ab82e8554fa88c4b2ab1e098ae051faac5af829efdcf2ce6b34dccd5567c"},
-    {file = "coverage-6.3.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f2b05757c92ad96b33dbf8e8ec8d4ccb9af6ae3c9e9bd141c7cc44d20c6bcba"},
-    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:9e3dd806f34de38d4c01416344e98eab2437ac450b3ae39c62a0ede2f8b5e4ed"},
-    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:d651fde74a4d3122e5562705824507e2f5b2d3d57557f1916c4b27635f8fbe3f"},
-    {file = "coverage-6.3.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:704f89b87c4f4737da2860695a18c852b78ec7279b24eedacab10b29067d3a38"},
-    {file = "coverage-6.3.1-cp39-cp39-win32.whl", hash = "sha256:2aed4761809640f02e44e16b8b32c1a5dee5e80ea30a0ff0912158bde9c501f2"},
-    {file = "coverage-6.3.1-cp39-cp39-win_amd64.whl", hash = "sha256:9976fb0a5709988778ac9bc44f3d50fccd989987876dfd7716dee28beed0a9fa"},
-    {file = "coverage-6.3.1-pp36.pp37.pp38-none-any.whl", hash = "sha256:463e52616ea687fd323888e86bf25e864a3cc6335a043fad6bbb037dbf49bbe2"},
-    {file = "coverage-6.3.1.tar.gz", hash = "sha256:6c3f6158b02ac403868eea390930ae64e9a9a2a5bbfafefbb920d29258d9f2f8"},
+    {file = "coverage-6.4.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:f1d5aa2703e1dab4ae6cf416eb0095304f49d004c39e9db1d86f57924f43006b"},
+    {file = "coverage-6.4.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:4ce1b258493cbf8aec43e9b50d89982346b98e9ffdfaae8ae5793bc112fb0068"},
+    {file = "coverage-6.4.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:83c4e737f60c6936460c5be330d296dd5b48b3963f48634c53b3f7deb0f34ec4"},
+    {file = "coverage-6.4.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:84e65ef149028516c6d64461b95a8dbcfce95cfd5b9eb634320596173332ea84"},
+    {file = "coverage-6.4.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f69718750eaae75efe506406c490d6fc5a6161d047206cc63ce25527e8a3adad"},
+    {file = "coverage-6.4.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:e57816f8ffe46b1df8f12e1b348f06d164fd5219beba7d9433ba79608ef011cc"},
+    {file = "coverage-6.4.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:01c5615d13f3dd3aa8543afc069e5319cfa0c7d712f6e04b920431e5c564a749"},
+    {file = "coverage-6.4.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:75ab269400706fab15981fd4bd5080c56bd5cc07c3bccb86aab5e1d5a88dc8f4"},
+    {file = "coverage-6.4.1-cp310-cp310-win32.whl", hash = "sha256:a7f3049243783df2e6cc6deafc49ea123522b59f464831476d3d1448e30d72df"},
+    {file = "coverage-6.4.1-cp310-cp310-win_amd64.whl", hash = "sha256:ee2ddcac99b2d2aec413e36d7a429ae9ebcadf912946b13ffa88e7d4c9b712d6"},
+    {file = "coverage-6.4.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:fb73e0011b8793c053bfa85e53129ba5f0250fdc0392c1591fd35d915ec75c46"},
+    {file = "coverage-6.4.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:106c16dfe494de3193ec55cac9640dd039b66e196e4641fa8ac396181578b982"},
+    {file = "coverage-6.4.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:87f4f3df85aa39da00fd3ec4b5abeb7407e82b68c7c5ad181308b0e2526da5d4"},
+    {file = "coverage-6.4.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:961e2fb0680b4f5ad63234e0bf55dfb90d302740ae9c7ed0120677a94a1590cb"},
+    {file = "coverage-6.4.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:cec3a0f75c8f1031825e19cd86ee787e87cf03e4fd2865c79c057092e69e3a3b"},
+    {file = "coverage-6.4.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:129cd05ba6f0d08a766d942a9ed4b29283aff7b2cccf5b7ce279d50796860bb3"},
+    {file = "coverage-6.4.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:bf5601c33213d3cb19d17a796f8a14a9eaa5e87629a53979a5981e3e3ae166f6"},
+    {file = "coverage-6.4.1-cp37-cp37m-win32.whl", hash = "sha256:269eaa2c20a13a5bf17558d4dc91a8d078c4fa1872f25303dddcbba3a813085e"},
+    {file = "coverage-6.4.1-cp37-cp37m-win_amd64.whl", hash = "sha256:f02cbbf8119db68455b9d763f2f8737bb7db7e43720afa07d8eb1604e5c5ae28"},
+    {file = "coverage-6.4.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:ffa9297c3a453fba4717d06df579af42ab9a28022444cae7fa605af4df612d54"},
+    {file = "coverage-6.4.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:145f296d00441ca703a659e8f3eb48ae39fb083baba2d7ce4482fb2723e050d9"},
+    {file = "coverage-6.4.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d67d44996140af8b84284e5e7d398e589574b376fb4de8ccd28d82ad8e3bea13"},
+    {file = "coverage-6.4.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2bd9a6fc18aab8d2e18f89b7ff91c0f34ff4d5e0ba0b33e989b3cd4194c81fd9"},
+    {file = "coverage-6.4.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3384f2a3652cef289e38100f2d037956194a837221edd520a7ee5b42d00cc605"},
+    {file = "coverage-6.4.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:9b3e07152b4563722be523e8cd0b209e0d1a373022cfbde395ebb6575bf6790d"},
+    {file = "coverage-6.4.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:1480ff858b4113db2718848d7b2d1b75bc79895a9c22e76a221b9d8d62496428"},
+    {file = "coverage-6.4.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:865d69ae811a392f4d06bde506d531f6a28a00af36f5c8649684a9e5e4a85c83"},
+    {file = "coverage-6.4.1-cp38-cp38-win32.whl", hash = "sha256:664a47ce62fe4bef9e2d2c430306e1428ecea207ffd68649e3b942fa8ea83b0b"},
+    {file = "coverage-6.4.1-cp38-cp38-win_amd64.whl", hash = "sha256:26dff09fb0d82693ba9e6231248641d60ba606150d02ed45110f9ec26404ed1c"},
+    {file = "coverage-6.4.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:d9c80df769f5ec05ad21ea34be7458d1dc51ff1fb4b2219e77fe24edf462d6df"},
+    {file = "coverage-6.4.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:39ee53946bf009788108b4dd2894bf1349b4e0ca18c2016ffa7d26ce46b8f10d"},
+    {file = "coverage-6.4.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f5b66caa62922531059bc5ac04f836860412f7f88d38a476eda0a6f11d4724f4"},
+    {file = "coverage-6.4.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:fd180ed867e289964404051a958f7cccabdeed423f91a899829264bb7974d3d3"},
+    {file = "coverage-6.4.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:84631e81dd053e8a0d4967cedab6db94345f1c36107c71698f746cb2636c63e3"},
+    {file = "coverage-6.4.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:8c08da0bd238f2970230c2a0d28ff0e99961598cb2e810245d7fc5afcf1254e8"},
+    {file = "coverage-6.4.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:d42c549a8f41dc103a8004b9f0c433e2086add8a719da00e246e17cbe4056f72"},
+    {file = "coverage-6.4.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:309ce4a522ed5fca432af4ebe0f32b21d6d7ccbb0f5fcc99290e71feba67c264"},
+    {file = "coverage-6.4.1-cp39-cp39-win32.whl", hash = "sha256:fdb6f7bd51c2d1714cea40718f6149ad9be6a2ee7d93b19e9f00934c0f2a74d9"},
+    {file = "coverage-6.4.1-cp39-cp39-win_amd64.whl", hash = "sha256:342d4aefd1c3e7f620a13f4fe563154d808b69cccef415415aece4c786665397"},
+    {file = "coverage-6.4.1-pp36.pp37.pp38-none-any.whl", hash = "sha256:4803e7ccf93230accb928f3a68f00ffa80a88213af98ed338a57ad021ef06815"},
+    {file = "coverage-6.4.1.tar.gz", hash = "sha256:4321f075095a096e70aff1d002030ee612b65a205a0a0f5b815280d5dc58100c"},
 ]
 cryptography = [
-    {file = "cryptography-36.0.1-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:73bc2d3f2444bcfeac67dd130ff2ea598ea5f20b40e36d19821b4df8c9c5037b"},
-    {file = "cryptography-36.0.1-cp36-abi3-macosx_10_10_x86_64.whl", hash = "sha256:2d87cdcb378d3cfed944dac30596da1968f88fb96d7fc34fdae30a99054b2e31"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:74d6c7e80609c0f4c2434b97b80c7f8fdfaa072ca4baab7e239a15d6d70ed73a"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:6c0c021f35b421ebf5976abf2daacc47e235f8b6082d3396a2fe3ccd537ab173"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5d59a9d55027a8b88fd9fd2826c4392bd487d74bf628bb9d39beecc62a644c12"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0a817b961b46894c5ca8a66b599c745b9a3d9f822725221f0e0fe49dc043a3a3"},
-    {file = "cryptography-36.0.1-cp36-abi3-manylinux_2_24_x86_64.whl", hash = "sha256:94ae132f0e40fe48f310bba63f477f14a43116f05ddb69d6fa31e93f05848ae2"},
-    {file = "cryptography-36.0.1-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:7be0eec337359c155df191d6ae00a5e8bbb63933883f4f5dffc439dac5348c3f"},
-    {file = "cryptography-36.0.1-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:e0344c14c9cb89e76eb6a060e67980c9e35b3f36691e15e1b7a9e58a0a6c6dc3"},
-    {file = "cryptography-36.0.1-cp36-abi3-win32.whl", hash = "sha256:4caa4b893d8fad33cf1964d3e51842cd78ba87401ab1d2e44556826df849a8ca"},
-    {file = "cryptography-36.0.1-cp36-abi3-win_amd64.whl", hash = "sha256:391432971a66cfaf94b21c24ab465a4cc3e8bf4a939c1ca5c3e3a6e0abebdbcf"},
-    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:bb5829d027ff82aa872d76158919045a7c1e91fbf241aec32cb07956e9ebd3c9"},
-    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ebc15b1c22e55c4d5566e3ca4db8689470a0ca2babef8e3a9ee057a8b82ce4b1"},
-    {file = "cryptography-36.0.1-pp37-pypy37_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:596f3cd67e1b950bc372c33f1a28a0692080625592ea6392987dba7f09f17a94"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:30ee1eb3ebe1644d1c3f183d115a8c04e4e603ed6ce8e394ed39eea4a98469ac"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:ec63da4e7e4a5f924b90af42eddf20b698a70e58d86a72d943857c4c6045b3ee"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ca238ceb7ba0bdf6ce88c1b74a87bffcee5afbfa1e41e173b1ceb095b39add46"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:ca28641954f767f9822c24e927ad894d45d5a1e501767599647259cbf030b903"},
-    {file = "cryptography-36.0.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:39bdf8e70eee6b1c7b289ec6e5d84d49a6bfa11f8b8646b5b3dfe41219153316"},
-    {file = "cryptography-36.0.1.tar.gz", hash = "sha256:53e5c1dc3d7a953de055d77bef2ff607ceef7a2aac0353b5d630ab67f7423638"},
+    {file = "cryptography-37.0.2-cp36-abi3-macosx_10_10_universal2.whl", hash = "sha256:ef15c2df7656763b4ff20a9bc4381d8352e6640cfeb95c2972c38ef508e75181"},
+    {file = "cryptography-37.0.2-cp36-abi3-macosx_10_10_x86_64.whl", hash = "sha256:3c81599befb4d4f3d7648ed3217e00d21a9341a9a688ecdd615ff72ffbed7336"},
+    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:2bd1096476aaac820426239ab534b636c77d71af66c547b9ddcd76eb9c79e004"},
+    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_24_aarch64.whl", hash = "sha256:31fe38d14d2e5f787e0aecef831457da6cec68e0bb09a35835b0b44ae8b988fe"},
+    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:093cb351031656d3ee2f4fa1be579a8c69c754cf874206be1d4cf3b542042804"},
+    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:59b281eab51e1b6b6afa525af2bd93c16d49358404f814fe2c2410058623928c"},
+    {file = "cryptography-37.0.2-cp36-abi3-manylinux_2_24_x86_64.whl", hash = "sha256:0cc20f655157d4cfc7bada909dc5cc228211b075ba8407c46467f63597c78178"},
+    {file = "cryptography-37.0.2-cp36-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:f8ec91983e638a9bcd75b39f1396e5c0dc2330cbd9ce4accefe68717e6779e0a"},
+    {file = "cryptography-37.0.2-cp36-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:46f4c544f6557a2fefa7ac8ac7d1b17bf9b647bd20b16decc8fbcab7117fbc15"},
+    {file = "cryptography-37.0.2-cp36-abi3-win32.whl", hash = "sha256:731c8abd27693323b348518ed0e0705713a36d79fdbd969ad968fbef0979a7e0"},
+    {file = "cryptography-37.0.2-cp36-abi3-win_amd64.whl", hash = "sha256:471e0d70201c069f74c837983189949aa0d24bb2d751b57e26e3761f2f782b8d"},
+    {file = "cryptography-37.0.2-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a68254dd88021f24a68b613d8c51d5c5e74d735878b9e32cc0adf19d1f10aaf9"},
+    {file = "cryptography-37.0.2-pp37-pypy37_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:a7d5137e556cc0ea418dca6186deabe9129cee318618eb1ffecbd35bee55ddc1"},
+    {file = "cryptography-37.0.2-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:aeaba7b5e756ea52c8861c133c596afe93dd716cbcacae23b80bc238202dc023"},
+    {file = "cryptography-37.0.2-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:95e590dd70642eb2079d280420a888190aa040ad20f19ec8c6e097e38aa29e06"},
+    {file = "cryptography-37.0.2-pp38-pypy38_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:1b9362d34363f2c71b7853f6251219298124aa4cc2075ae2932e64c91a3e2717"},
+    {file = "cryptography-37.0.2-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:e53258e69874a306fcecb88b7534d61820db8a98655662a3dd2ec7f1afd9132f"},
+    {file = "cryptography-37.0.2-pp39-pypy39_pp73-macosx_10_10_x86_64.whl", hash = "sha256:1f3bfbd611db5cb58ca82f3deb35e83af34bb8cf06043fa61500157d50a70982"},
+    {file = "cryptography-37.0.2-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:419c57d7b63f5ec38b1199a9521d77d7d1754eb97827bbb773162073ccd8c8d4"},
+    {file = "cryptography-37.0.2-pp39-pypy39_pp73-manylinux_2_24_x86_64.whl", hash = "sha256:dc26bb134452081859aa21d4990474ddb7e863aa39e60d1592800a8865a702de"},
+    {file = "cryptography-37.0.2-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:3b8398b3d0efc420e777c40c16764d6870bcef2eb383df9c6dbb9ffe12c64452"},
+    {file = "cryptography-37.0.2.tar.gz", hash = "sha256:f224ad253cc9cea7568f49077007d2263efa57396a2f2f78114066fd54b5c68e"},
 ]
 cx-freeze = [
     {file = "cx_Freeze-6.9-cp310-cp310-win32.whl", hash = "sha256:776d4fb68a4831691acbd3c374362b9b48ce2e568514a73c3d4cb14d5dcf1470"},
@@ -1961,25 +2042,33 @@ cx-logging = [
     {file = "cx_Logging-3.0-cp39-cp39-win_amd64.whl", hash = "sha256:302e9c4f65a936c288a4fa59a90e7e142d9ef994aa29676731acafdcccdbb3f5"},
     {file = "cx_Logging-3.0.tar.gz", hash = "sha256:ba8a7465facf7b98d8f494030fb481a2e8aeee29dc191e10383bb54ed42bdb34"},
 ]
+deprecated = [
+    {file = "Deprecated-1.2.13-py2.py3-none-any.whl", hash = "sha256:64756e3e14c8c5eea9795d93c524551432a0be75629f8f29e67ab8caf076c76d"},
+    {file = "Deprecated-1.2.13.tar.gz", hash = "sha256:43ac5335da90c31c24ba028af536a91d41d53f9e6901ddb021bcc572ce44e38d"},
+]
+dill = [
+    {file = "dill-0.3.5.1-py2.py3-none-any.whl", hash = "sha256:33501d03270bbe410c72639b350e941882a8b0fd55357580fbc873fba0c59302"},
+    {file = "dill-0.3.5.1.tar.gz", hash = "sha256:d75e41f3eff1eee599d738e76ba8f4ad98ea229db8b085318aa2b3333a208c86"},
+]
 dnspython = [
-    {file = "dnspython-2.2.0-py3-none-any.whl", hash = "sha256:081649da27ced5e75709a1ee542136eaba9842a0fe4c03da4fb0a3d3ed1f3c44"},
-    {file = "dnspython-2.2.0.tar.gz", hash = "sha256:e79351e032d0b606b98d38a4b0e6e2275b31a5b85c873e587cc11b73aca026d6"},
+    {file = "dnspython-2.2.1-py3-none-any.whl", hash = "sha256:a851e51367fb93e9e1361732c1d60dab63eff98712e503ea7d92e6eccb109b4f"},
+    {file = "dnspython-2.2.1.tar.gz", hash = "sha256:0f7569a4a6ff151958b64304071d370daa3243d15941a7beedf0c9fe5105603e"},
 ]
 docutils = [
-    {file = "docutils-0.18.1-py2.py3-none-any.whl", hash = "sha256:23010f129180089fbcd3bc08cfefccb3b890b0050e1ca00c867036e9d161b98c"},
-    {file = "docutils-0.18.1.tar.gz", hash = "sha256:679987caf361a7539d76e584cbeddc311e3aee937877c87346f31debc63e9d06"},
+    {file = "docutils-0.17.1-py2.py3-none-any.whl", hash = "sha256:cf316c8370a737a022b72b56874f6602acf974a37a9fba42ec2876387549fc61"},
+    {file = "docutils-0.17.1.tar.gz", hash = "sha256:686577d2e4c32380bb50cbb22f575ed742d58168cee37e99117a854bcd88f125"},
 ]
 dropbox = [
-    {file = "dropbox-11.26.0-py2-none-any.whl", hash = "sha256:abd29587fa692bde0c3a48ce8efb56c24d8df92c5f402bbcdd78f3089d5ced5c"},
-    {file = "dropbox-11.26.0-py3-none-any.whl", hash = "sha256:84becf043a63007ae67620946acb0fa164669ce691c7f1dbfdabb6712a258b29"},
-    {file = "dropbox-11.26.0.tar.gz", hash = "sha256:dd79e3dfc216688020959462aefac54ffce7c07a45e89f4fb258348885195a73"},
+    {file = "dropbox-11.31.0-py2-none-any.whl", hash = "sha256:393a99dfe30d42fd73c265b9b7d24bb21c9a961739cd097c3541e709eb2a209c"},
+    {file = "dropbox-11.31.0-py3-none-any.whl", hash = "sha256:5f924102fd6464def81573320c6aa4ea9cd3368e1b1c13d838403dd4c9ffc919"},
+    {file = "dropbox-11.31.0.tar.gz", hash = "sha256:f483d65b702775b9abf7b9328f702c68c6397fc01770477c6ddbfb1d858a5bcf"},
 ]
 enlighten = [
     {file = "enlighten-1.10.2-py2.py3-none-any.whl", hash = "sha256:b237fe562b320bf9f1d4bb76d0c98e0daf914372a76ab87c35cd02f57aa9d8c1"},
     {file = "enlighten-1.10.2.tar.gz", hash = "sha256:7a5b83cd0f4d095e59d80c648ebb5f7ffca0cd8bcf7ae6639828ee1ad000632a"},
 ]
 evdev = [
-    {file = "evdev-1.4.0.tar.gz", hash = "sha256:8782740eb1a86b187334c07feb5127d3faa0b236e113206dfe3ae8f77fb1aaf1"},
+    {file = "evdev-1.5.0.tar.gz", hash = "sha256:5b33b174f7c84576e7dd6071e438bf5ad227da95efd4356a39fe4c8355412fe6"},
 ]
 flake8 = [
     {file = "flake8-3.9.2-py2.py3-none-any.whl", hash = "sha256:bf8fd333346d844f616e8d47905ef3a3384edae6b4e9beb0c5101e25e3110907"},
@@ -2053,49 +2142,52 @@ ftrack-python-api = [
 future = [
     {file = "future-0.18.2.tar.gz", hash = "sha256:b1bead90b70cf6ec3f0710ae53a525360fa360d306a86583adc6bf83a4db537d"},
 ]
+gazu = [
+    {file = "gazu-0.8.28-py2.py3-none-any.whl", hash = "sha256:ec4f7c2688a2b37ee8a77737e4e30565ad362428c3ade9046136a998c043e51c"},
+]
 gitdb = [
     {file = "gitdb-4.0.9-py3-none-any.whl", hash = "sha256:8033ad4e853066ba6ca92050b9df2f89301b8fc8bf7e9324d412a63f8bf1a8fd"},
     {file = "gitdb-4.0.9.tar.gz", hash = "sha256:bac2fd45c0a1c9cf619e63a90d62bdc63892ef92387424b855792a6cabe789aa"},
 ]
 gitpython = [
-    {file = "GitPython-3.1.26-py3-none-any.whl", hash = "sha256:26ac35c212d1f7b16036361ca5cff3ec66e11753a0d677fb6c48fa4e1a9dd8d6"},
-    {file = "GitPython-3.1.26.tar.gz", hash = "sha256:fc8868f63a2e6d268fb25f481995ba185a85a66fcad126f039323ff6635669ee"},
+    {file = "GitPython-3.1.27-py3-none-any.whl", hash = "sha256:5b68b000463593e05ff2b261acff0ff0972df8ab1b70d3cdbd41b546c8b8fc3d"},
+    {file = "GitPython-3.1.27.tar.gz", hash = "sha256:1c885ce809e8ba2d88a29befeb385fcea06338d3640712b59ca623c220bb5704"},
 ]
 google-api-core = [
-    {file = "google-api-core-2.4.0.tar.gz", hash = "sha256:ba8787b7c61632cd0340f095e1c036bef9426b2594f10afb290ba311ae8cb2cb"},
-    {file = "google_api_core-2.4.0-py2.py3-none-any.whl", hash = "sha256:58e2c1171a3d51778bf4e428fbb4bf79cbd05007b4b44deaa80cf73c80eebc0f"},
+    {file = "google-api-core-2.8.1.tar.gz", hash = "sha256:958024c6aa3460b08f35741231076a4dd9a4c819a6a39d44da9627febe8b28f0"},
+    {file = "google_api_core-2.8.1-py3-none-any.whl", hash = "sha256:ce1daa49644b50398093d2a9ad886501aa845e2602af70c3001b9f402a9d7359"},
 ]
 google-api-python-client = [
-    {file = "google-api-python-client-1.12.10.tar.gz", hash = "sha256:1cb773647e7d97048d9d1c7fa746247fbad39fd1a3b5040f2cb2645dd7156b11"},
-    {file = "google_api_python_client-1.12.10-py2.py3-none-any.whl", hash = "sha256:5a8742b9b604b34e13462cc3d6aedbbf11d3af1ef558eb95defe74a29ebc5c28"},
+    {file = "google-api-python-client-1.12.11.tar.gz", hash = "sha256:1b4bd42a46321e13c0542a9e4d96fa05d73626f07b39f83a73a947d70ca706a9"},
+    {file = "google_api_python_client-1.12.11-py2.py3-none-any.whl", hash = "sha256:7e0a1a265c8d3088ee1987778c72683fcb376e32bada8d7767162bd9c503fd9b"},
 ]
 google-auth = [
-    {file = "google-auth-2.6.0.tar.gz", hash = "sha256:ad160fc1ea8f19e331a16a14a79f3d643d813a69534ba9611d2c80dc10439dad"},
-    {file = "google_auth-2.6.0-py2.py3-none-any.whl", hash = "sha256:218ca03d7744ca0c8b6697b6083334be7df49b7bf76a69d555962fd1a7657b5f"},
+    {file = "google-auth-2.7.0.tar.gz", hash = "sha256:8a954960f852d5f19e6af14dd8e75c20159609e85d8db37e4013cc8c3824a7e1"},
+    {file = "google_auth-2.7.0-py2.py3-none-any.whl", hash = "sha256:df549a1433108801b11bdcc0e312eaf0d5f0500db42f0523e4d65c78722e8475"},
 ]
 google-auth-httplib2 = [
     {file = "google-auth-httplib2-0.1.0.tar.gz", hash = "sha256:a07c39fd632becacd3f07718dfd6021bf396978f03ad3ce4321d060015cc30ac"},
     {file = "google_auth_httplib2-0.1.0-py2.py3-none-any.whl", hash = "sha256:31e49c36c6b5643b57e82617cb3e021e3e1d2df9da63af67252c02fa9c1f4a10"},
 ]
 googleapis-common-protos = [
-    {file = "googleapis-common-protos-1.54.0.tar.gz", hash = "sha256:a4031d6ec6c2b1b6dc3e0be7e10a1bd72fb0b18b07ef9be7b51f2c1004ce2437"},
-    {file = "googleapis_common_protos-1.54.0-py2.py3-none-any.whl", hash = "sha256:e54345a2add15dc5e1a7891c27731ff347b4c33765d79b5ed7026a6c0c7cbcae"},
+    {file = "googleapis-common-protos-1.56.2.tar.gz", hash = "sha256:b09b56f5463070c2153753ef123f07d2e49235e89148e9b2459ec8ed2f68d7d3"},
+    {file = "googleapis_common_protos-1.56.2-py2.py3-none-any.whl", hash = "sha256:023eaea9d8c1cceccd9587c6af6c20f33eeeb05d4148670f2b0322dc1511700c"},
 ]
 httplib2 = [
-    {file = "httplib2-0.20.2-py3-none-any.whl", hash = "sha256:6b937120e7d786482881b44b8eec230c1ee1c5c1d06bce8cc865f25abbbf713b"},
-    {file = "httplib2-0.20.2.tar.gz", hash = "sha256:e404681d2fbcec7506bcb52c503f2b021e95bee0ef7d01e5c221468a2406d8dc"},
+    {file = "httplib2-0.20.4-py3-none-any.whl", hash = "sha256:8b6a905cb1c79eefd03f8669fd993c36dc341f7c558f056cb5a33b5c2f458543"},
+    {file = "httplib2-0.20.4.tar.gz", hash = "sha256:58a98e45b4b1a48273073f905d2961666ecf0fbac4250ea5b47aef259eb5c585"},
 ]
 idna = [
-    {file = "idna-2.10-py2.py3-none-any.whl", hash = "sha256:b97d804b1e9b523befed77c48dacec60e6dcb0b5391d57af6a65a312a90648c0"},
-    {file = "idna-2.10.tar.gz", hash = "sha256:b307872f855b18632ce0c21c5e45be78c0ea7ae4c15c828c20788b26921eb3f6"},
+    {file = "idna-3.3-py3-none-any.whl", hash = "sha256:84d9dd047ffa80596e0f246e2eab0b391788b0503584e8945f2368256d2735ff"},
+    {file = "idna-3.3.tar.gz", hash = "sha256:9d643ff0a55b762d5cdb124b8eaa99c66322e2157b69160bc32796e824360e6d"},
 ]
 imagesize = [
     {file = "imagesize-1.3.0-py2.py3-none-any.whl", hash = "sha256:1db2f82529e53c3e929e8926a1fa9235aa82d0bd0c580359c67ec31b2fddaa8c"},
     {file = "imagesize-1.3.0.tar.gz", hash = "sha256:cd1750d452385ca327479d45b64d9c7729ecf0b3969a58148298c77092261f9d"},
 ]
 importlib-metadata = [
-    {file = "importlib_metadata-4.10.1-py3-none-any.whl", hash = "sha256:899e2a40a8c4a1aec681feef45733de8a6c58f3f6a0dbed2eb6574b4387a77b6"},
-    {file = "importlib_metadata-4.10.1.tar.gz", hash = "sha256:951f0d8a5b7260e9db5e41d429285b5f451e928479f19d80818878527d36e95e"},
+    {file = "importlib_metadata-4.11.4-py3-none-any.whl", hash = "sha256:c58c8eb8a762858f49e18436ff552e83914778e50e9d2f1660535ffb364552ec"},
+    {file = "importlib_metadata-4.11.4.tar.gz", hash = "sha256:5d26852efe48c0a32b0509ffbc583fda1a2266545a78d104a6f4aff3db17d700"},
 ]
 iniconfig = [
     {file = "iniconfig-1.1.1-py2.py3-none-any.whl", hash = "sha256:011e24c64b7f47f6ebd835bb12a743f2fbe9a26d4cecaa7f53bc4f35ee9da8b3"},
@@ -2118,8 +2210,8 @@ jinja2 = [
     {file = "Jinja2-2.11.3.tar.gz", hash = "sha256:a6d58433de0ae800347cab1fa3043cebbabe8baa9d29e668f1c768cb87a333c6"},
 ]
 jinxed = [
-    {file = "jinxed-1.1.0-py2.py3-none-any.whl", hash = "sha256:6a61ccf963c16aa885304f27e6e5693783676897cea0c7f223270c8b8e78baf8"},
-    {file = "jinxed-1.1.0.tar.gz", hash = "sha256:d8f1731f134e9e6b04d95095845ae6c10eb15cb223a5f0cabdea87d4a279c305"},
+    {file = "jinxed-1.2.0-py2.py3-none-any.whl", hash = "sha256:cfc2b2e4e3b4326954d546ba6d6b9a7a796ddcb0aef8d03161d005177eb0d48b"},
+    {file = "jinxed-1.2.0.tar.gz", hash = "sha256:032acda92d5c57cd216033cbbd53de731e6ed50deb63eb4781336ca55f72cda5"},
 ]
 jsonschema = [
     {file = "jsonschema-2.6.0-py2.py3-none-any.whl", hash = "sha256:000e68abd33c972a5248544925a0cae7d1125f9bf6c58280d37546b946769a08"},
@@ -2313,57 +2405,60 @@ packaging = [
     {file = "packaging-21.3.tar.gz", hash = "sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb"},
 ]
 paramiko = [
-    {file = "paramiko-2.10.1-py2.py3-none-any.whl", hash = "sha256:f6cbd3e1204abfdbcd40b3ecbc9d32f04027cd3080fe666245e21e7540ccfc1b"},
-    {file = "paramiko-2.10.1.tar.gz", hash = "sha256:443f4da23ec24e9a9c0ea54017829c282abdda1d57110bf229360775ccd27a31"},
+    {file = "paramiko-2.11.0-py2.py3-none-any.whl", hash = "sha256:655f25dc8baf763277b933dfcea101d636581df8d6b9774d1fb653426b72c270"},
+    {file = "paramiko-2.11.0.tar.gz", hash = "sha256:003e6bee7c034c21fbb051bf83dc0a9ee4106204dd3c53054c71452cc4ec3938"},
 ]
 parso = [
     {file = "parso-0.8.3-py2.py3-none-any.whl", hash = "sha256:c001d4636cd3aecdaf33cbb40aebb59b094be2a74c556778ef5576c175e19e75"},
     {file = "parso-0.8.3.tar.gz", hash = "sha256:8c07be290bb59f03588915921e29e8a50002acaf2cdc5fa0e0114f91709fafa0"},
 ]
 pathlib2 = [
-    {file = "pathlib2-2.3.6-py2.py3-none-any.whl", hash = "sha256:3a130b266b3a36134dcc79c17b3c7ac9634f083825ca6ea9d8f557ee6195c9c8"},
-    {file = "pathlib2-2.3.6.tar.gz", hash = "sha256:7d8bcb5555003cdf4a8d2872c538faa3a0f5d20630cb360e518ca3b981795e5f"},
+    {file = "pathlib2-2.3.7.post1-py2.py3-none-any.whl", hash = "sha256:5266a0fd000452f1b3467d782f079a4343c63aaa119221fbdc4e39577489ca5b"},
+    {file = "pathlib2-2.3.7.post1.tar.gz", hash = "sha256:9fe0edad898b83c0c3e199c842b27ed216645d2e177757b2dd67384d4113c641"},
 ]
 pillow = [
-    {file = "Pillow-9.0.1-1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:a5d24e1d674dd9d72c66ad3ea9131322819ff86250b30dc5821cbafcfa0b96b4"},
-    {file = "Pillow-9.0.1-1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:2632d0f846b7c7600edf53c48f8f9f1e13e62f66a6dbc15191029d950bfed976"},
-    {file = "Pillow-9.0.1-1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:b9618823bd237c0d2575283f2939655f54d51b4527ec3972907a927acbcc5bfc"},
-    {file = "Pillow-9.0.1-cp310-cp310-macosx_10_10_universal2.whl", hash = "sha256:9bfdb82cdfeccec50aad441afc332faf8606dfa5e8efd18a6692b5d6e79f00fd"},
-    {file = "Pillow-9.0.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:5100b45a4638e3c00e4d2320d3193bdabb2d75e79793af7c3eb139e4f569f16f"},
-    {file = "Pillow-9.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:528a2a692c65dd5cafc130de286030af251d2ee0483a5bf50c9348aefe834e8a"},
-    {file = "Pillow-9.0.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0f29d831e2151e0b7b39981756d201f7108d3d215896212ffe2e992d06bfe049"},
-    {file = "Pillow-9.0.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:855c583f268edde09474b081e3ddcd5cf3b20c12f26e0d434e1386cc5d318e7a"},
-    {file = "Pillow-9.0.1-cp310-cp310-win32.whl", hash = "sha256:d9d7942b624b04b895cb95af03a23407f17646815495ce4547f0e60e0b06f58e"},
-    {file = "Pillow-9.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:81c4b81611e3a3cb30e59b0cf05b888c675f97e3adb2c8672c3154047980726b"},
-    {file = "Pillow-9.0.1-cp37-cp37m-macosx_10_10_x86_64.whl", hash = "sha256:413ce0bbf9fc6278b2d63309dfeefe452835e1c78398efb431bab0672fe9274e"},
-    {file = "Pillow-9.0.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:80fe64a6deb6fcfdf7b8386f2cf216d329be6f2781f7d90304351811fb591360"},
-    {file = "Pillow-9.0.1-cp37-cp37m-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:cef9c85ccbe9bee00909758936ea841ef12035296c748aaceee535969e27d31b"},
-    {file = "Pillow-9.0.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1d19397351f73a88904ad1aee421e800fe4bbcd1aeee6435fb62d0a05ccd1030"},
-    {file = "Pillow-9.0.1-cp37-cp37m-win32.whl", hash = "sha256:d21237d0cd37acded35154e29aec853e945950321dd2ffd1a7d86fe686814669"},
-    {file = "Pillow-9.0.1-cp37-cp37m-win_amd64.whl", hash = "sha256:ede5af4a2702444a832a800b8eb7f0a7a1c0eed55b644642e049c98d589e5092"},
-    {file = "Pillow-9.0.1-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:b5b3f092fe345c03bca1e0b687dfbb39364b21ebb8ba90e3fa707374b7915204"},
-    {file = "Pillow-9.0.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:335ace1a22325395c4ea88e00ba3dc89ca029bd66bd5a3c382d53e44f0ccd77e"},
-    {file = "Pillow-9.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:db6d9fac65bd08cea7f3540b899977c6dee9edad959fa4eaf305940d9cbd861c"},
-    {file = "Pillow-9.0.1-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f154d173286a5d1863637a7dcd8c3437bb557520b01bddb0be0258dcb72696b5"},
-    {file = "Pillow-9.0.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:14d4b1341ac07ae07eb2cc682f459bec932a380c3b122f5540432d8977e64eae"},
-    {file = "Pillow-9.0.1-cp38-cp38-win32.whl", hash = "sha256:effb7749713d5317478bb3acb3f81d9d7c7f86726d41c1facca068a04cf5bb4c"},
-    {file = "Pillow-9.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:7f7609a718b177bf171ac93cea9fd2ddc0e03e84d8fa4e887bdfc39671d46b00"},
-    {file = "Pillow-9.0.1-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:80ca33961ced9c63358056bd08403ff866512038883e74f3a4bf88ad3eb66838"},
-    {file = "Pillow-9.0.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:1c3c33ac69cf059bbb9d1a71eeaba76781b450bc307e2291f8a4764d779a6b28"},
-    {file = "Pillow-9.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:12875d118f21cf35604176872447cdb57b07126750a33748bac15e77f90f1f9c"},
-    {file = "Pillow-9.0.1-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:514ceac913076feefbeaf89771fd6febde78b0c4c1b23aaeab082c41c694e81b"},
-    {file = "Pillow-9.0.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d3c5c79ab7dfce6d88f1ba639b77e77a17ea33a01b07b99840d6ed08031cb2a7"},
-    {file = "Pillow-9.0.1-cp39-cp39-win32.whl", hash = "sha256:718856856ba31f14f13ba885ff13874be7fefc53984d2832458f12c38205f7f7"},
-    {file = "Pillow-9.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:f25ed6e28ddf50de7e7ea99d7a976d6a9c415f03adcaac9c41ff6ff41b6d86ac"},
-    {file = "Pillow-9.0.1-pp37-pypy37_pp73-macosx_10_10_x86_64.whl", hash = "sha256:011233e0c42a4a7836498e98c1acf5e744c96a67dd5032a6f666cc1fb97eab97"},
-    {file = "Pillow-9.0.1-pp37-pypy37_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:253e8a302a96df6927310a9d44e6103055e8fb96a6822f8b7f514bb7ef77de56"},
-    {file = "Pillow-9.0.1-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6295f6763749b89c994fcb6d8a7f7ce03c3992e695f89f00b741b4580b199b7e"},
-    {file = "Pillow-9.0.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:a9f44cd7e162ac6191491d7249cceb02b8116b0f7e847ee33f739d7cb1ea1f70"},
-    {file = "Pillow-9.0.1.tar.gz", hash = "sha256:6c8bc8238a7dfdaf7a75f5ec5a663f4173f8c367e5a39f87e720495e1eed75fa"},
+    {file = "Pillow-9.1.1-cp310-cp310-macosx_10_10_x86_64.whl", hash = "sha256:42dfefbef90eb67c10c45a73a9bc1599d4dac920f7dfcbf4ec6b80cb620757fe"},
+    {file = "Pillow-9.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:ffde4c6fabb52891d81606411cbfaf77756e3b561b566efd270b3ed3791fde4e"},
+    {file = "Pillow-9.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9c857532c719fb30fafabd2371ce9b7031812ff3889d75273827633bca0c4602"},
+    {file = "Pillow-9.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:59789a7d06c742e9d13b883d5e3569188c16acb02eeed2510fd3bfdbc1bd1530"},
+    {file = "Pillow-9.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4d45dbe4b21a9679c3e8b3f7f4f42a45a7d3ddff8a4a16109dff0e1da30a35b2"},
+    {file = "Pillow-9.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:e9ed59d1b6ee837f4515b9584f3d26cf0388b742a11ecdae0d9237a94505d03a"},
+    {file = "Pillow-9.1.1-cp310-cp310-win32.whl", hash = "sha256:b3fe2ff1e1715d4475d7e2c3e8dabd7c025f4410f79513b4ff2de3d51ce0fa9c"},
+    {file = "Pillow-9.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:5b650dbbc0969a4e226d98a0b440c2f07a850896aed9266b6fedc0f7e7834108"},
+    {file = "Pillow-9.1.1-cp37-cp37m-macosx_10_10_x86_64.whl", hash = "sha256:0b4d5ad2cd3a1f0d1df882d926b37dbb2ab6c823ae21d041b46910c8f8cd844b"},
+    {file = "Pillow-9.1.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9370d6744d379f2de5d7fa95cdbd3a4d92f0b0ef29609b4b1687f16bc197063d"},
+    {file = "Pillow-9.1.1-cp37-cp37m-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b761727ed7d593e49671d1827044b942dd2f4caae6e51bab144d4accf8244a84"},
+    {file = "Pillow-9.1.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8a66fe50386162df2da701b3722781cbe90ce043e7d53c1fd6bd801bca6b48d4"},
+    {file = "Pillow-9.1.1-cp37-cp37m-win32.whl", hash = "sha256:2b291cab8a888658d72b575a03e340509b6b050b62db1f5539dd5cd18fd50578"},
+    {file = "Pillow-9.1.1-cp37-cp37m-win_amd64.whl", hash = "sha256:1d4331aeb12f6b3791911a6da82de72257a99ad99726ed6b63f481c0184b6fb9"},
+    {file = "Pillow-9.1.1-cp38-cp38-macosx_10_10_x86_64.whl", hash = "sha256:8844217cdf66eabe39567118f229e275f0727e9195635a15e0e4b9227458daaf"},
+    {file = "Pillow-9.1.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:b6617221ff08fbd3b7a811950b5c3f9367f6e941b86259843eab77c8e3d2b56b"},
+    {file = "Pillow-9.1.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:20d514c989fa28e73a5adbddd7a171afa5824710d0ab06d4e1234195d2a2e546"},
+    {file = "Pillow-9.1.1-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:088df396b047477dd1bbc7de6e22f58400dae2f21310d9e2ec2933b2ef7dfa4f"},
+    {file = "Pillow-9.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:53c27bd452e0f1bc4bfed07ceb235663a1df7c74df08e37fd6b03eb89454946a"},
+    {file = "Pillow-9.1.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:3f6c1716c473ebd1649663bf3b42702d0d53e27af8b64642be0dd3598c761fb1"},
+    {file = "Pillow-9.1.1-cp38-cp38-win32.whl", hash = "sha256:c67db410508b9de9c4694c57ed754b65a460e4812126e87f5052ecf23a011a54"},
+    {file = "Pillow-9.1.1-cp38-cp38-win_amd64.whl", hash = "sha256:f054b020c4d7e9786ae0404278ea318768eb123403b18453e28e47cdb7a0a4bf"},
+    {file = "Pillow-9.1.1-cp39-cp39-macosx_10_10_x86_64.whl", hash = "sha256:c17770a62a71718a74b7548098a74cd6880be16bcfff5f937f900ead90ca8e92"},
+    {file = "Pillow-9.1.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:f3f6a6034140e9e17e9abc175fc7a266a6e63652028e157750bd98e804a8ed9a"},
+    {file = "Pillow-9.1.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f372d0f08eff1475ef426344efe42493f71f377ec52237bf153c5713de987251"},
+    {file = "Pillow-9.1.1-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:09e67ef6e430f90caa093528bd758b0616f8165e57ed8d8ce014ae32df6a831d"},
+    {file = "Pillow-9.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:66daa16952d5bf0c9d5389c5e9df562922a59bd16d77e2a276e575d32e38afd1"},
+    {file = "Pillow-9.1.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:d78ca526a559fb84faaaf84da2dd4addef5edb109db8b81677c0bb1aad342601"},
+    {file = "Pillow-9.1.1-cp39-cp39-win32.whl", hash = "sha256:55e74faf8359ddda43fee01bffbc5bd99d96ea508d8a08c527099e84eb708f45"},
+    {file = "Pillow-9.1.1-cp39-cp39-win_amd64.whl", hash = "sha256:7c150dbbb4a94ea4825d1e5f2c5501af7141ea95825fadd7829f9b11c97aaf6c"},
+    {file = "Pillow-9.1.1-pp37-pypy37_pp73-macosx_10_10_x86_64.whl", hash = "sha256:769a7f131a2f43752455cc72f9f7a093c3ff3856bf976c5fb53a59d0ccc704f6"},
+    {file = "Pillow-9.1.1-pp37-pypy37_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:488f3383cf5159907d48d32957ac6f9ea85ccdcc296c14eca1a4e396ecc32098"},
+    {file = "Pillow-9.1.1-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b525a356680022b0af53385944026d3486fc8c013638cf9900eb87c866afb4c"},
+    {file = "Pillow-9.1.1-pp38-pypy38_pp73-macosx_10_10_x86_64.whl", hash = "sha256:6e760cf01259a1c0a50f3c845f9cad1af30577fd8b670339b1659c6d0e7a41dd"},
+    {file = "Pillow-9.1.1-pp38-pypy38_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a4165205a13b16a29e1ac57efeee6be2dfd5b5408122d59ef2145bc3239fa340"},
+    {file = "Pillow-9.1.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:937a54e5694684f74dcbf6e24cc453bfc5b33940216ddd8f4cd8f0f79167f765"},
+    {file = "Pillow-9.1.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:baf3be0b9446a4083cc0c5bb9f9c964034be5374b5bc09757be89f5d2fa247b8"},
+    {file = "Pillow-9.1.1.tar.gz", hash = "sha256:7502539939b53d7565f3d11d87c78e7ec900d3c72945d4ee0e2f250d598309a0"},
 ]
 platformdirs = [
-    {file = "platformdirs-2.4.1-py3-none-any.whl", hash = "sha256:1d7385c7db91728b83efd0ca99a5afb296cab9d0ed8313a45ed8ba17967ecfca"},
-    {file = "platformdirs-2.4.1.tar.gz", hash = "sha256:440633ddfebcc36264232365d7840a970e75e1018d15b4327d11f91909045fda"},
+    {file = "platformdirs-2.5.2-py3-none-any.whl", hash = "sha256:027d8e83a2d7de06bbac4e5ef7e023c02b863d7ea5d079477e722bb41ab25788"},
+    {file = "platformdirs-2.5.2.tar.gz", hash = "sha256:58c8abb07dcb441e6ee4b11d8df0ac856038f944ab98b7be6b27b2a3c7feef19"},
 ]
 pluggy = [
     {file = "pluggy-1.0.0-py2.py3-none-any.whl", hash = "sha256:74134bbf457f031a36d68416e1509f34bd5ccc019f0bcc952c7b909d06b37bd3"},
@@ -2464,12 +2559,12 @@ pyflakes = [
     {file = "pyflakes-2.3.1.tar.gz", hash = "sha256:f5bc8ecabc05bb9d291eb5203d6810b49040f6ff446a756326104746cc00c1db"},
 ]
 pygments = [
-    {file = "Pygments-2.11.2-py3-none-any.whl", hash = "sha256:44238f1b60a76d78fc8ca0528ee429702aae011c265fe6a8dd8b63049ae41c65"},
-    {file = "Pygments-2.11.2.tar.gz", hash = "sha256:4e426f72023d88d03b2fa258de560726ce890ff3b630f88c21cbb8b2503b8c6a"},
+    {file = "Pygments-2.12.0-py3-none-any.whl", hash = "sha256:dc9c10fb40944260f6ed4c688ece0cd2048414940f1cea51b8b226318411c519"},
+    {file = "Pygments-2.12.0.tar.gz", hash = "sha256:5eb116118f9612ff1ee89ac96437bb6b49e8f04d8a13b514ba26f620208e26eb"},
 ]
 pylint = [
-    {file = "pylint-2.12.2-py3-none-any.whl", hash = "sha256:daabda3f7ed9d1c60f52d563b1b854632fd90035bcf01443e234d3dc794e3b74"},
-    {file = "pylint-2.12.2.tar.gz", hash = "sha256:9d945a73640e1fec07ee34b42f5669b770c759acd536ec7b16d7e4b87a9c9ff9"},
+    {file = "pylint-2.13.9-py3-none-any.whl", hash = "sha256:705c620d388035bdd9ff8b44c5bcdd235bfb49d276d488dd2c8ff1736aa42526"},
+    {file = "pylint-2.13.9.tar.gz", hash = "sha256:095567c96e19e6f57b5b907e67d265ff535e588fe26b12b5ebe1fc5645b2c731"},
 ]
 pymongo = [
     {file = "pymongo-3.12.3-cp27-cp27m-macosx_10_14_intel.whl", hash = "sha256:c164eda0be9048f83c24b9b2656900041e069ddf72de81c17d874d0c32f6079f"},
@@ -2598,40 +2693,40 @@ pynput = [
     {file = "pynput-1.7.6.tar.gz", hash = "sha256:3a5726546da54116b687785d38b1db56997ce1d28e53e8d22fc656d8b92e533c"},
 ]
 pyobjc-core = [
-    {file = "pyobjc-core-8.2.tar.gz", hash = "sha256:6afb8ee1dd0647cbfaaf99906eca3b43ce045b27e3d4510462d04e7e5361c89b"},
-    {file = "pyobjc_core-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:311e45556c3afa8831713b89017e0204562f51f35661d76c07ffe04985f44e1d"},
-    {file = "pyobjc_core-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:711f361e83382e405e4273ff085178b0cf730901ccf6801f834e7037e50278f9"},
-    {file = "pyobjc_core-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:bdd2e2960ec73214bcfe2d86bb4ca94f5f5119db86d129fa32d3c003b6532c50"},
-    {file = "pyobjc_core-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b879f91fc614c399aafa1d08cf5e279c267510e904bad5c336c3a6064c0eb3aa"},
-    {file = "pyobjc_core-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:b4ef4bdb99a330f5e15cc6273098964276fccbc432453cdba3c2963292bc066c"},
-    {file = "pyobjc_core-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:fd8e5be0955790ff8f9d17a0f356b6eb7eb1ce4995e0c94355c462dd52d22d6d"},
+    {file = "pyobjc-core-8.5.tar.gz", hash = "sha256:704c275439856c0d1287469f0d589a7d808d48b754a93d9ce5415d4eaf06d576"},
+    {file = "pyobjc_core-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:0c234143b48334443f5adcf26e668945a6d47bc1fa6223e80918c6c735a029d9"},
+    {file = "pyobjc_core-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:1486ee533f0d76f666804ce89723ada4db56bfde55e56151ba512d3f849857f8"},
+    {file = "pyobjc_core-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:412de06dfa728301c04b3e46fd7453320a8ae8b862e85236e547cd797a73b490"},
+    {file = "pyobjc_core-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:0b3e09cccb1be574a82cc9f929ae27fc4283eccc75496cb5d51534caa6bb83a3"},
+    {file = "pyobjc_core-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:eeafe21f879666ab7f57efcc6b007c9f5f8733d367b7e380c925203ed83f000d"},
+    {file = "pyobjc_core-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:c0071686976d7ea8c14690950e504a13cb22b4ebb2bc7b5ec47c1c1c0f6eff41"},
 ]
 pyobjc-framework-applicationservices = [
-    {file = "pyobjc-framework-ApplicationServices-8.2.tar.gz", hash = "sha256:f901b2ebb278b7d00033b45cf9ee9d43f651e096ff4c4defa261509238138da8"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:b5be1757a8df944a58449c628ed68fc76dd746fcd1e96ebb6db0f734e94cdfc8"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:32657c4b89983a98fbe831a14884954710719e763197968a20ac07e1daa21f1e"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:6ce2c9701590f752a75151b2fe1e462e7a7ad67dec3119a796711ea93ea01031"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:28124bc892045222305cf8953b163495bf662c401e54f48905dafb1104d9c1d1"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:d5c60d66c6ed2569cb042a6c14dd5b9f4d01e182a464b893cd6002ce445b4ddf"},
-    {file = "pyobjc_framework_ApplicationServices-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:e1727fccc1d48922fa28a4cebf4a6d287d633f451cb03779968df60de8cb1bd0"},
+    {file = "pyobjc-framework-ApplicationServices-8.5.tar.gz", hash = "sha256:fa3015ef8e3add90af3447d7fdcc7f8dd083cc2a1d58f99a569480a2df10d2b1"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:436b16ebe448a829a8312e10208eec81a2adcae1fff674dbcc3262e1bd76e0ca"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:408958d14aa7fcf46f2163754c211078bc63be1368934d86188202914dce077d"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:1d6cd4ce192859a22e208da4d7177a1c3ceb1ef2f64c339fd881102b1210cadd"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:0251d092adb1d2d116fd9f147ceef0e53b158a46c21245131c40b9d7b786d0db"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:9742e69fe6d4545d0e02b0ad0a7a2432bc9944569ee07d6e90ffa5ef614df9f7"},
+    {file = "pyobjc_framework_ApplicationServices-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:16f5677c14ea903c6aaca1dd121521825c39e816cae696d6ae32c0b287252ab2"},
 ]
 pyobjc-framework-cocoa = [
-    {file = "pyobjc-framework-Cocoa-8.2.tar.gz", hash = "sha256:f0901998e2f18415ef6d1f8a12b083f69fc93bd56b3e88040002e3c09bd8c304"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:5af73f150e242542735e0663bb5504f88aabaec2a54c60e856cfca3ff6dd9712"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:d1de3763ee01850c311da74de5c82c85ec199120e85ab45acaf203accc37a470"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:86d69bf667f99f3c43184d8830567195fff94c675fe7f60f899dd90553d9b265"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:9dbadb22826392c48b00087359f66579f8404a4f4f77498f31f9869c54bb0fa9"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:7adf8b57da1c1292c24375b8e74b6dd45f99a4d3c10ba925a9b38f63a97ba782"},
-    {file = "pyobjc_framework_Cocoa-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:bc8279c8c1544087d46a7e99324f093029df89b8c527c5da2a682bad4cb3197e"},
+    {file = "pyobjc-framework-Cocoa-8.5.tar.gz", hash = "sha256:569bd3a020f64b536fb2d1c085b37553e50558c9f907e08b73ffc16ae68e1861"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:7a7c160416696bf6035dfcdf0e603aaa52858d6afcddfcc5ab41733619ac2529"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:6ceba444282030be8596b812260e8d28b671254a51052ad778d32da6e17db847"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:f46b2b161b8dd40c7b9e00bc69636c3e6480b2704a69aee22ee0154befbe163a"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b31d425aee8698cbf62b187338f5ca59427fa4dca2153a73866f7cb410713119"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:898359ac1f76eedec8aa156847682378a8950824421c40edb89391286e607dc4"},
+    {file = "pyobjc_framework_Cocoa-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:baa2947f76b119a3360973d74d57d6dada87ac527bab9a88f31596af392f123c"},
 ]
 pyobjc-framework-quartz = [
-    {file = "pyobjc-framework-Quartz-8.2.tar.gz", hash = "sha256:219d8797235bf071723f8b0f30a681de0b12875e2d04ae902a3a269f72de0b66"},
-    {file = "pyobjc_framework_Quartz-8.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e5ab3117201a494b11bb1b80febf5dd288111a196b35731815b656ae30ee6ce3"},
-    {file = "pyobjc_framework_Quartz-8.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:4941b3039ab7bcf89cb4255c381358de2383c1ab45c9e00c3b64655f271a3b32"},
-    {file = "pyobjc_framework_Quartz-8.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:ab75a50dea84ec794641522d9f035fc6c19ec4eb37a56c9186b9943575fbc7ab"},
-    {file = "pyobjc_framework_Quartz-8.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:8cb687b20ebfc467034868b38945b573d1c50f237e379cf86c4f557c9766b759"},
-    {file = "pyobjc_framework_Quartz-8.2-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:8b5c3ca1fef900fa66aafe82fff07bc352c60ea7dceed2bb9b5b1db0957b4fea"},
-    {file = "pyobjc_framework_Quartz-8.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:7bca7e649da77056348d71032def44e345043319d71b0c592197888d92e3eec1"},
+    {file = "pyobjc-framework-Quartz-8.5.tar.gz", hash = "sha256:d2bc5467a792ddc04814f12a1e9c2fcaf699a1c3ad3d4264cfdce6b9c7b10624"},
+    {file = "pyobjc_framework_Quartz-8.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e9f0fb663f7872c9de94169031ac42b91ad01bd4cad49a9f1a0164be8f028426"},
+    {file = "pyobjc_framework_Quartz-8.5-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:567eec91287cfe9a1b6433717192c585935de8f3daa28d82ce72fdd6c7ac00f6"},
+    {file = "pyobjc_framework_Quartz-8.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:9f910ab41a712ffc7a8c3e3716a2d6f39ea4419004b26a2fd2d2f740ff5c262c"},
+    {file = "pyobjc_framework_Quartz-8.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:29d07066781628278bf0e5278abcfc96ef6724c66c5629a0b4c214d319a82e55"},
+    {file = "pyobjc_framework_Quartz-8.5-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:72abcde1a3d72be11f2c881c9b9872044c8f2de86d2047b67fe771713638b107"},
+    {file = "pyobjc_framework_Quartz-8.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:8809b9a2df2f461697bdb45b6d1b5a4f881f88f09450e3990858e64e3e26c530"},
 ]
 pyparsing = [
     {file = "pyparsing-2.4.7-py2.py3-none-any.whl", hash = "sha256:ef9d7589ef3c200abe66653d3f1ab1033c3c419ae9b9bdb1240a85b024efc88b"},
@@ -2656,6 +2751,14 @@ python-dateutil = [
     {file = "python-dateutil-2.8.2.tar.gz", hash = "sha256:0123cacc1627ae19ddf3c27a5de5bd67ee4586fbdd6440d9748f8abb483d3e86"},
     {file = "python_dateutil-2.8.2-py2.py3-none-any.whl", hash = "sha256:961d03dc3453ebbc59dbdea9e4e11c5651520a876d0f4db161e8674aae935da9"},
 ]
+python-engineio = [
+    {file = "python-engineio-3.14.2.tar.gz", hash = "sha256:eab4553f2804c1ce97054c8b22cf0d5a9ab23128075248b97e1a5b2f29553085"},
+    {file = "python_engineio-3.14.2-py2.py3-none-any.whl", hash = "sha256:5a9e6086d192463b04a1428ff1f85b6ba631bbb19d453b144ffc04f530542b84"},
+]
+python-socketio = [
+    {file = "python-socketio-4.6.1.tar.gz", hash = "sha256:cd1f5aa492c1eb2be77838e837a495f117e17f686029ebc03d62c09e33f4fa10"},
+    {file = "python_socketio-4.6.1-py2.py3-none-any.whl", hash = "sha256:5a21da53fdbdc6bb6c8071f40e13d100e0b279ad997681c2492478e06f370523"},
+]
 python-xlib = [
     {file = "python-xlib-0.31.tar.gz", hash = "sha256:74d83a081f532bc07f6d7afcd6416ec38403d68f68b9b9dc9e1f28fbf2d799e9"},
     {file = "python_xlib-0.31-py2.py3-none-any.whl", hash = "sha256:1ec6ce0de73d9e6592ead666779a5732b384e5b8fb1f1886bd0a81cafa477759"},
@@ -2664,8 +2767,8 @@ python3-xlib = [
     {file = "python3-xlib-0.15.tar.gz", hash = "sha256:dc4245f3ae4aa5949c1d112ee4723901ade37a96721ba9645f2bfa56e5b383f8"},
 ]
 pytz = [
-    {file = "pytz-2021.3-py2.py3-none-any.whl", hash = "sha256:3672058bc3453457b622aab7a1c3bfd5ab0bdae451512f6cf25f64ed37f5b87c"},
-    {file = "pytz-2021.3.tar.gz", hash = "sha256:acad2d8b20a1af07d4e4c9d2e9285c5ed9104354062f275f3fcd88dcef4f1326"},
+    {file = "pytz-2022.1-py2.py3-none-any.whl", hash = "sha256:e68985985296d9a66a881eb3193b0906246245294a881e7c8afe623866ac6a5c"},
+    {file = "pytz-2022.1.tar.gz", hash = "sha256:1e760e2fe6a8163bc0b3d9a19c4f84342afa0a2affebfaa84b01b978a02ecaa7"},
 ]
 pywin32 = [
     {file = "pywin32-301-cp35-cp35m-win32.whl", hash = "sha256:93367c96e3a76dfe5003d8291ae16454ca7d84bb24d721e0b74a07610b7be4a7"},
@@ -2684,8 +2787,8 @@ pywin32-ctypes = [
     {file = "pywin32_ctypes-0.2.0-py2.py3-none-any.whl", hash = "sha256:9dc2d991b3479cc2df15930958b674a48a227d5361d413827a4cfd0b5876fc98"},
 ]
 "qt.py" = [
-    {file = "Qt.py-1.3.6-py2.py3-none-any.whl", hash = "sha256:7edf6048d07a6924707506b5ba34a6e05d66dde9a3f4e3a62f9996ccab0b91c7"},
-    {file = "Qt.py-1.3.6.tar.gz", hash = "sha256:0d78656a2f814602eee304521c7bf5da0cec414818b3833712c77524294c404a"},
+    {file = "Qt.py-1.3.7-py2.py3-none-any.whl", hash = "sha256:150099d1c6f64c9621a2c9d79d45102ec781c30ee30ee69fc082c6e9be7324fe"},
+    {file = "Qt.py-1.3.7.tar.gz", hash = "sha256:803c7bdf4d6230f9a466be19d55934a173eabb61406d21cb91e80c2a3f773b1f"},
 ]
 qtawesome = [
     {file = "QtAwesome-0.7.3-py2.py3-none-any.whl", hash = "sha256:ddf4530b4af71cec13b24b88a4cdb56ec85b1e44c43c42d0698804c7137b09b0"},
@@ -2700,16 +2803,16 @@ recommonmark = [
     {file = "recommonmark-0.7.1.tar.gz", hash = "sha256:bdb4db649f2222dcd8d2d844f0006b958d627f732415d399791ee436a3686d67"},
 ]
 requests = [
-    {file = "requests-2.25.1-py2.py3-none-any.whl", hash = "sha256:c210084e36a42ae6b9219e00e48287def368a26d03a048ddad7bfee44f75871e"},
-    {file = "requests-2.25.1.tar.gz", hash = "sha256:27973dd4a904a4f13b263a19c866c13b92a39ed1c964655f025f3f8d3d75b804"},
+    {file = "requests-2.27.1-py2.py3-none-any.whl", hash = "sha256:f22fa1e554c9ddfd16e6e41ac79759e17be9e492b3587efa038054674760e72d"},
+    {file = "requests-2.27.1.tar.gz", hash = "sha256:68d7c56fd5a8999887728ef304a6d12edc7be74f1cfa47714fc8b414525c9a61"},
 ]
 rsa = [
     {file = "rsa-4.8-py3-none-any.whl", hash = "sha256:95c5d300c4e879ee69708c428ba566c59478fd653cc3a22243eeb8ed846950bb"},
     {file = "rsa-4.8.tar.gz", hash = "sha256:5c6bd9dc7a543b7fe4304a631f8a8a3b674e2bbfc49c2ae96200cdbe55df6b17"},
 ]
 secretstorage = [
-    {file = "SecretStorage-3.3.1-py3-none-any.whl", hash = "sha256:422d82c36172d88d6a0ed5afdec956514b189ddbfb72fefab0c8a1cee4eaf71f"},
-    {file = "SecretStorage-3.3.1.tar.gz", hash = "sha256:fd666c51a6bf200643495a04abb261f83229dcb6fd8472ec393df7ffc8b6f195"},
+    {file = "SecretStorage-3.3.2-py3-none-any.whl", hash = "sha256:755dc845b6ad76dcbcbc07ea3da75ae54bb1ea529eb72d15f83d26499a5df319"},
+    {file = "SecretStorage-3.3.2.tar.gz", hash = "sha256:0a8eb9645b320881c222e827c26f4cfcf55363e8b374a021981ef886657a912f"},
 ]
 semver = [
     {file = "semver-2.13.0-py2.py3-none-any.whl", hash = "sha256:ced8b23dceb22134307c1b8abfa523da14198793d9787ac838e70e29e77458d4"},
@@ -2720,8 +2823,8 @@ six = [
     {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"},
 ]
 slack-sdk = [
-    {file = "slack_sdk-3.13.0-py2.py3-none-any.whl", hash = "sha256:54f2a5f7419f1ab932af9e3200f7f2f93db96e0f0eb8ad7d3b4214aa9f124641"},
-    {file = "slack_sdk-3.13.0.tar.gz", hash = "sha256:aae6ce057e286a5e7fe7a9f256e85b886eee556def8e04b82b08f699e64d7f67"},
+    {file = "slack_sdk-3.17.0-py2.py3-none-any.whl", hash = "sha256:0816efc43d1d2db8286e8dbcbb2e86fd0f71c206c01c521c2cb054ecb40f9ced"},
+    {file = "slack_sdk-3.17.0.tar.gz", hash = "sha256:860cd0e50c454b955f14321c8c5486a47cc1e0e84116acdb009107f836752feb"},
 ]
 smmap = [
     {file = "smmap-5.0.0-py3-none-any.whl", hash = "sha256:2aba19d6a040e78d8b09de5c57e96207b09ed71d8e55ce0959eeee6c8e190d94"},
@@ -2732,20 +2835,20 @@ snowballstemmer = [
     {file = "snowballstemmer-2.2.0.tar.gz", hash = "sha256:09b16deb8547d3412ad7b590689584cd0fe25ec8db3be37788be3810cbf19cb1"},
 ]
 speedcopy = [
-    {file = "speedcopy-2.1.2-py3-none-any.whl", hash = "sha256:91e271b84c00952812dbf669d360b2610fd8fa198670373e02acf2a04db89a4c"},
-    {file = "speedcopy-2.1.2.tar.gz", hash = "sha256:1b2d779fadebd53a59384f7d286c40b2ef382e0d000fa53011699fcd3190d33f"},
+    {file = "speedcopy-2.1.4-py3-none-any.whl", hash = "sha256:e09eb1de67ae0e0b51d5b99a28882009d565a37a3cb3c6bae121e3a5d3cccb17"},
+    {file = "speedcopy-2.1.4.tar.gz", hash = "sha256:eff007a97e49ec1934df4fa8074f4bd1cf4a3b14c5499d914988785cff0c199a"},
 ]
 sphinx = [
-    {file = "Sphinx-3.5.3-py3-none-any.whl", hash = "sha256:3f01732296465648da43dec8fb40dc451ba79eb3e2cc5c6d79005fd98197107d"},
-    {file = "Sphinx-3.5.3.tar.gz", hash = "sha256:ce9c228456131bab09a3d7d10ae58474de562a6f79abb3dc811ae401cf8c1abc"},
+    {file = "Sphinx-5.0.1-py3-none-any.whl", hash = "sha256:36aa2a3c2f6d5230be94585bc5d74badd5f9ed8f3388b8eedc1726fe45b1ad30"},
+    {file = "Sphinx-5.0.1.tar.gz", hash = "sha256:f4da1187785a5bc7312cc271b0e867a93946c319d106363e102936a3d9857306"},
 ]
 sphinx-qt-documentation = [
-    {file = "sphinx_qt_documentation-0.3-py3-none-any.whl", hash = "sha256:bee247cb9e4fc03fc496d07adfdb943100e1103320c3e5e820e0cfa7c790d9b6"},
-    {file = "sphinx_qt_documentation-0.3.tar.gz", hash = "sha256:f09a0c9d9e989172ba3e282b92bf55613bb23ad47315ec5b0d38536b343ac6c8"},
+    {file = "sphinx_qt_documentation-0.4-py3-none-any.whl", hash = "sha256:fa131093f75cd1bd48699cd132e18e4d46ba9eaadc070e6026867cea75ecdb7b"},
+    {file = "sphinx_qt_documentation-0.4.tar.gz", hash = "sha256:f43ba17baa93e353fb94045027fb67f9d935ed158ce8662de93f08b88eec6774"},
 ]
 sphinx-rtd-theme = [
-    {file = "sphinx_rtd_theme-0.5.1-py2.py3-none-any.whl", hash = "sha256:fa6bebd5ab9a73da8e102509a86f3fcc36dec04a0b52ea80e5a033b2aba00113"},
-    {file = "sphinx_rtd_theme-0.5.1.tar.gz", hash = "sha256:eda689eda0c7301a80cf122dad28b1861e5605cbf455558f3775e1e8200e83a5"},
+    {file = "sphinx_rtd_theme-1.0.0-py2.py3-none-any.whl", hash = "sha256:4d35a56f4508cfee4c4fb604373ede6feae2a306731d533f409ef5c3496fdbd8"},
+    {file = "sphinx_rtd_theme-1.0.0.tar.gz", hash = "sha256:eec6d497e4c2195fa0e8b2016b337532b8a699a68bcb22a512870e16925c6a5c"},
 ]
 sphinxcontrib-applehelp = [
     {file = "sphinxcontrib-applehelp-1.0.2.tar.gz", hash = "sha256:a072735ec80e7675e3f432fcae8610ecf509c5f1869d17e2eecff44389cdbc58"},
@@ -2788,34 +2891,34 @@ toml = [
     {file = "toml-0.10.2.tar.gz", hash = "sha256:b3bda1d108d5dd99f4a20d24d9c348e91c4db7ab1b749200bded2f839ccbe68f"},
 ]
 tomli = [
-    {file = "tomli-2.0.0-py3-none-any.whl", hash = "sha256:b5bde28da1fed24b9bd1d4d2b8cba62300bfb4ec9a6187a957e8ddb9434c5224"},
-    {file = "tomli-2.0.0.tar.gz", hash = "sha256:c292c34f58502a1eb2bbb9f5bbc9a5ebc37bee10ffb8c2d6bbdfa8eb13cc14e1"},
+    {file = "tomli-2.0.1-py3-none-any.whl", hash = "sha256:939de3e7a6161af0c887ef91b7d41a53e7c5a1ca976325f429cb46ea9bc30ecc"},
+    {file = "tomli-2.0.1.tar.gz", hash = "sha256:de526c12914f0c550d15924c62d72abc48d6fe7364aa87328337a31007fe8a4f"},
 ]
 typed-ast = [
-    {file = "typed_ast-1.5.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:183b183b7771a508395d2cbffd6db67d6ad52958a5fdc99f450d954003900266"},
-    {file = "typed_ast-1.5.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:676d051b1da67a852c0447621fdd11c4e104827417bf216092ec3e286f7da596"},
-    {file = "typed_ast-1.5.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bc2542e83ac8399752bc16e0b35e038bdb659ba237f4222616b4e83fb9654985"},
-    {file = "typed_ast-1.5.2-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:74cac86cc586db8dfda0ce65d8bcd2bf17b58668dfcc3652762f3ef0e6677e76"},
-    {file = "typed_ast-1.5.2-cp310-cp310-win_amd64.whl", hash = "sha256:18fe320f354d6f9ad3147859b6e16649a0781425268c4dde596093177660e71a"},
-    {file = "typed_ast-1.5.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:31d8c6b2df19a777bc8826770b872a45a1f30cfefcfd729491baa5237faae837"},
-    {file = "typed_ast-1.5.2-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:963a0ccc9a4188524e6e6d39b12c9ca24cc2d45a71cfdd04a26d883c922b4b78"},
-    {file = "typed_ast-1.5.2-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:0eb77764ea470f14fcbb89d51bc6bbf5e7623446ac4ed06cbd9ca9495b62e36e"},
-    {file = "typed_ast-1.5.2-cp36-cp36m-win_amd64.whl", hash = "sha256:294a6903a4d087db805a7656989f613371915fc45c8cc0ddc5c5a0a8ad9bea4d"},
-    {file = "typed_ast-1.5.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:26a432dc219c6b6f38be20a958cbe1abffcc5492821d7e27f08606ef99e0dffd"},
-    {file = "typed_ast-1.5.2-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c7407cfcad702f0b6c0e0f3e7ab876cd1d2c13b14ce770e412c0c4b9728a0f88"},
-    {file = "typed_ast-1.5.2-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:f30ddd110634c2d7534b2d4e0e22967e88366b0d356b24de87419cc4410c41b7"},
-    {file = "typed_ast-1.5.2-cp37-cp37m-win_amd64.whl", hash = "sha256:8c08d6625bb258179b6e512f55ad20f9dfef019bbfbe3095247401e053a3ea30"},
-    {file = "typed_ast-1.5.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:90904d889ab8e81a956f2c0935a523cc4e077c7847a836abee832f868d5c26a4"},
-    {file = "typed_ast-1.5.2-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:bbebc31bf11762b63bf61aaae232becb41c5bf6b3461b80a4df7e791fabb3aca"},
-    {file = "typed_ast-1.5.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c29dd9a3a9d259c9fa19d19738d021632d673f6ed9b35a739f48e5f807f264fb"},
-    {file = "typed_ast-1.5.2-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:58ae097a325e9bb7a684572d20eb3e1809802c5c9ec7108e85da1eb6c1a3331b"},
-    {file = "typed_ast-1.5.2-cp38-cp38-win_amd64.whl", hash = "sha256:da0a98d458010bf4fe535f2d1e367a2e2060e105978873c04c04212fb20543f7"},
-    {file = "typed_ast-1.5.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:33b4a19ddc9fc551ebabca9765d54d04600c4a50eda13893dadf67ed81d9a098"},
-    {file = "typed_ast-1.5.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:1098df9a0592dd4c8c0ccfc2e98931278a6c6c53cb3a3e2cf7e9ee3b06153344"},
-    {file = "typed_ast-1.5.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:42c47c3b43fe3a39ddf8de1d40dbbfca60ac8530a36c9b198ea5b9efac75c09e"},
-    {file = "typed_ast-1.5.2-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:f290617f74a610849bd8f5514e34ae3d09eafd521dceaa6cf68b3f4414266d4e"},
-    {file = "typed_ast-1.5.2-cp39-cp39-win_amd64.whl", hash = "sha256:df05aa5b241e2e8045f5f4367a9f6187b09c4cdf8578bb219861c4e27c443db5"},
-    {file = "typed_ast-1.5.2.tar.gz", hash = "sha256:525a2d4088e70a9f75b08b3f87a51acc9cde640e19cc523c7e41aa355564ae27"},
+    {file = "typed_ast-1.5.4-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:669dd0c4167f6f2cd9f57041e03c3c2ebf9063d0757dc89f79ba1daa2bfca9d4"},
+    {file = "typed_ast-1.5.4-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:211260621ab1cd7324e0798d6be953d00b74e0428382991adfddb352252f1d62"},
+    {file = "typed_ast-1.5.4-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:267e3f78697a6c00c689c03db4876dd1efdfea2f251a5ad6555e82a26847b4ac"},
+    {file = "typed_ast-1.5.4-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:c542eeda69212fa10a7ada75e668876fdec5f856cd3d06829e6aa64ad17c8dfe"},
+    {file = "typed_ast-1.5.4-cp310-cp310-win_amd64.whl", hash = "sha256:a9916d2bb8865f973824fb47436fa45e1ebf2efd920f2b9f99342cb7fab93f72"},
+    {file = "typed_ast-1.5.4-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:79b1e0869db7c830ba6a981d58711c88b6677506e648496b1f64ac7d15633aec"},
+    {file = "typed_ast-1.5.4-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a94d55d142c9265f4ea46fab70977a1944ecae359ae867397757d836ea5a3f47"},
+    {file = "typed_ast-1.5.4-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:183afdf0ec5b1b211724dfef3d2cad2d767cbefac291f24d69b00546c1837fb6"},
+    {file = "typed_ast-1.5.4-cp36-cp36m-win_amd64.whl", hash = "sha256:639c5f0b21776605dd6c9dbe592d5228f021404dafd377e2b7ac046b0349b1a1"},
+    {file = "typed_ast-1.5.4-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:cf4afcfac006ece570e32d6fa90ab74a17245b83dfd6655a6f68568098345ff6"},
+    {file = "typed_ast-1.5.4-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ed855bbe3eb3715fca349c80174cfcfd699c2f9de574d40527b8429acae23a66"},
+    {file = "typed_ast-1.5.4-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:6778e1b2f81dfc7bc58e4b259363b83d2e509a65198e85d5700dfae4c6c8ff1c"},
+    {file = "typed_ast-1.5.4-cp37-cp37m-win_amd64.whl", hash = "sha256:0261195c2062caf107831e92a76764c81227dae162c4f75192c0d489faf751a2"},
+    {file = "typed_ast-1.5.4-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:2efae9db7a8c05ad5547d522e7dbe62c83d838d3906a3716d1478b6c1d61388d"},
+    {file = "typed_ast-1.5.4-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:7d5d014b7daa8b0bf2eaef684295acae12b036d79f54178b92a2b6a56f92278f"},
+    {file = "typed_ast-1.5.4-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:370788a63915e82fd6f212865a596a0fefcbb7d408bbbb13dea723d971ed8bdc"},
+    {file = "typed_ast-1.5.4-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:4e964b4ff86550a7a7d56345c7864b18f403f5bd7380edf44a3c1fb4ee7ac6c6"},
+    {file = "typed_ast-1.5.4-cp38-cp38-win_amd64.whl", hash = "sha256:683407d92dc953c8a7347119596f0b0e6c55eb98ebebd9b23437501b28dcbb8e"},
+    {file = "typed_ast-1.5.4-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:4879da6c9b73443f97e731b617184a596ac1235fe91f98d279a7af36c796da35"},
+    {file = "typed_ast-1.5.4-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:3e123d878ba170397916557d31c8f589951e353cc95fb7f24f6bb69adc1a8a97"},
+    {file = "typed_ast-1.5.4-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ebd9d7f80ccf7a82ac5f88c521115cc55d84e35bf8b446fcd7836eb6b98929a3"},
+    {file = "typed_ast-1.5.4-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:98f80dee3c03455e92796b58b98ff6ca0b2a6f652120c263efdba4d6c5e58f72"},
+    {file = "typed_ast-1.5.4-cp39-cp39-win_amd64.whl", hash = "sha256:0fdbcf2fef0ca421a3f5912555804296f0b0960f0418c440f5d6d3abb549f3e1"},
+    {file = "typed_ast-1.5.4.tar.gz", hash = "sha256:39e21ceb7388e4bb37f4c679d72707ed46c2fbf2a5609b8b8ebc4b067d977df2"},
 ]
 typing-extensions = [
     {file = "typing_extensions-4.0.1-py3-none-any.whl", hash = "sha256:7f001e5ac290a0c0401508864c7ec868be4e701886d5b573a9528ed3973d9d3b"},
@@ -2826,8 +2929,8 @@ uritemplate = [
     {file = "uritemplate-3.0.1.tar.gz", hash = "sha256:5af8ad10cec94f215e3f48112de2022e1d5a37ed427fbd88652fa908f2ab7cae"},
 ]
 urllib3 = [
-    {file = "urllib3-1.26.8-py2.py3-none-any.whl", hash = "sha256:000ca7f471a233c2251c6c7023ee85305721bfdf18621ebff4fd17a8653427ed"},
-    {file = "urllib3-1.26.8.tar.gz", hash = "sha256:0e7c33d9a63e7ddfcb86780aac87befc2fbddf46c58dbb487e0855f7ceec283c"},
+    {file = "urllib3-1.26.9-py2.py3-none-any.whl", hash = "sha256:44ece4d53fb1706f667c9bd1c648f5469a2ec925fcf3a776667042d645472c14"},
+    {file = "urllib3-1.26.9.tar.gz", hash = "sha256:aabaf16477806a5e1dd19aa41f8c2b7950dd3c746362d7e3223dbe6de6ac448e"},
 ]
 wcwidth = [
     {file = "wcwidth-0.2.5-py2.py3-none-any.whl", hash = "sha256:beb4802a9cebb9144e99086eff703a642a13d6a0052920003a230f3294bbe784"},
@@ -2838,57 +2941,70 @@ websocket-client = [
     {file = "websocket_client-0.59.0-py2.py3-none-any.whl", hash = "sha256:2e50d26ca593f70aba7b13a489435ef88b8fc3b5c5643c1ce8808ff9b40f0b32"},
 ]
 wrapt = [
-    {file = "wrapt-1.13.3-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:e05e60ff3b2b0342153be4d1b597bbcfd8330890056b9619f4ad6b8d5c96a81a"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux1_i686.whl", hash = "sha256:85148f4225287b6a0665eef08a178c15097366d46b210574a658c1ff5b377489"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux1_x86_64.whl", hash = "sha256:2dded5496e8f1592ec27079b28b6ad2a1ef0b9296d270f77b8e4a3a796cf6909"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux2010_i686.whl", hash = "sha256:e94b7d9deaa4cc7bac9198a58a7240aaf87fe56c6277ee25fa5b3aa1edebd229"},
-    {file = "wrapt-1.13.3-cp27-cp27m-manylinux2010_x86_64.whl", hash = "sha256:498e6217523111d07cd67e87a791f5e9ee769f9241fcf8a379696e25806965af"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux1_i686.whl", hash = "sha256:ec7e20258ecc5174029a0f391e1b948bf2906cd64c198a9b8b281b811cbc04de"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux1_x86_64.whl", hash = "sha256:87883690cae293541e08ba2da22cacaae0a092e0ed56bbba8d018cc486fbafbb"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux2010_i686.whl", hash = "sha256:f99c0489258086308aad4ae57da9e8ecf9e1f3f30fa35d5e170b4d4896554d80"},
-    {file = "wrapt-1.13.3-cp27-cp27mu-manylinux2010_x86_64.whl", hash = "sha256:6a03d9917aee887690aa3f1747ce634e610f6db6f6b332b35c2dd89412912bca"},
-    {file = "wrapt-1.13.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:936503cb0a6ed28dbfa87e8fcd0a56458822144e9d11a49ccee6d9a8adb2ac44"},
-    {file = "wrapt-1.13.3-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:f9c51d9af9abb899bd34ace878fbec8bf357b3194a10c4e8e0a25512826ef056"},
-    {file = "wrapt-1.13.3-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:220a869982ea9023e163ba915077816ca439489de6d2c09089b219f4e11b6785"},
-    {file = "wrapt-1.13.3-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:0877fe981fd76b183711d767500e6b3111378ed2043c145e21816ee589d91096"},
-    {file = "wrapt-1.13.3-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:43e69ffe47e3609a6aec0fe723001c60c65305784d964f5007d5b4fb1bc6bf33"},
-    {file = "wrapt-1.13.3-cp310-cp310-win32.whl", hash = "sha256:78dea98c81915bbf510eb6a3c9c24915e4660302937b9ae05a0947164248020f"},
-    {file = "wrapt-1.13.3-cp310-cp310-win_amd64.whl", hash = "sha256:ea3e746e29d4000cd98d572f3ee2a6050a4f784bb536f4ac1f035987fc1ed83e"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux1_i686.whl", hash = "sha256:8c73c1a2ec7c98d7eaded149f6d225a692caa1bd7b2401a14125446e9e90410d"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux1_x86_64.whl", hash = "sha256:086218a72ec7d986a3eddb7707c8c4526d677c7b35e355875a0fe2918b059179"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux2010_i686.whl", hash = "sha256:e92d0d4fa68ea0c02d39f1e2f9cb5bc4b4a71e8c442207433d8db47ee79d7aa3"},
-    {file = "wrapt-1.13.3-cp35-cp35m-manylinux2010_x86_64.whl", hash = "sha256:d4a5f6146cfa5c7ba0134249665acd322a70d1ea61732723c7d3e8cc0fa80755"},
-    {file = "wrapt-1.13.3-cp35-cp35m-win32.whl", hash = "sha256:8aab36778fa9bba1a8f06a4919556f9f8c7b33102bd71b3ab307bb3fecb21851"},
-    {file = "wrapt-1.13.3-cp35-cp35m-win_amd64.whl", hash = "sha256:944b180f61f5e36c0634d3202ba8509b986b5fbaf57db3e94df11abee244ba13"},
-    {file = "wrapt-1.13.3-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:2ebdde19cd3c8cdf8df3fc165bc7827334bc4e353465048b36f7deeae8ee0918"},
-    {file = "wrapt-1.13.3-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:610f5f83dd1e0ad40254c306f4764fcdc846641f120c3cf424ff57a19d5f7ade"},
-    {file = "wrapt-1.13.3-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:5601f44a0f38fed36cc07db004f0eedeaadbdcec90e4e90509480e7e6060a5bc"},
-    {file = "wrapt-1.13.3-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:e6906d6f48437dfd80464f7d7af1740eadc572b9f7a4301e7dd3d65db285cacf"},
-    {file = "wrapt-1.13.3-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:766b32c762e07e26f50d8a3468e3b4228b3736c805018e4b0ec8cc01ecd88125"},
-    {file = "wrapt-1.13.3-cp36-cp36m-win32.whl", hash = "sha256:5f223101f21cfd41deec8ce3889dc59f88a59b409db028c469c9b20cfeefbe36"},
-    {file = "wrapt-1.13.3-cp36-cp36m-win_amd64.whl", hash = "sha256:f122ccd12fdc69628786d0c947bdd9cb2733be8f800d88b5a37c57f1f1d73c10"},
-    {file = "wrapt-1.13.3-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:46f7f3af321a573fc0c3586612db4decb7eb37172af1bc6173d81f5b66c2e068"},
-    {file = "wrapt-1.13.3-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:778fd096ee96890c10ce96187c76b3e99b2da44e08c9e24d5652f356873f6709"},
-    {file = "wrapt-1.13.3-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:0cb23d36ed03bf46b894cfec777eec754146d68429c30431c99ef28482b5c1df"},
-    {file = "wrapt-1.13.3-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:96b81ae75591a795d8c90edc0bfaab44d3d41ffc1aae4d994c5aa21d9b8e19a2"},
-    {file = "wrapt-1.13.3-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:7dd215e4e8514004c8d810a73e342c536547038fb130205ec4bba9f5de35d45b"},
-    {file = "wrapt-1.13.3-cp37-cp37m-win32.whl", hash = "sha256:47f0a183743e7f71f29e4e21574ad3fa95676136f45b91afcf83f6a050914829"},
-    {file = "wrapt-1.13.3-cp37-cp37m-win_amd64.whl", hash = "sha256:fd76c47f20984b43d93de9a82011bb6e5f8325df6c9ed4d8310029a55fa361ea"},
-    {file = "wrapt-1.13.3-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b73d4b78807bd299b38e4598b8e7bd34ed55d480160d2e7fdaabd9931afa65f9"},
-    {file = "wrapt-1.13.3-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:ec9465dd69d5657b5d2fa6133b3e1e989ae27d29471a672416fd729b429eb554"},
-    {file = "wrapt-1.13.3-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:dd91006848eb55af2159375134d724032a2d1d13bcc6f81cd8d3ed9f2b8e846c"},
-    {file = "wrapt-1.13.3-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:ae9de71eb60940e58207f8e71fe113c639da42adb02fb2bcbcaccc1ccecd092b"},
-    {file = "wrapt-1.13.3-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:51799ca950cfee9396a87f4a1240622ac38973b6df5ef7a41e7f0b98797099ce"},
-    {file = "wrapt-1.13.3-cp38-cp38-win32.whl", hash = "sha256:4b9c458732450ec42578b5642ac53e312092acf8c0bfce140ada5ca1ac556f79"},
-    {file = "wrapt-1.13.3-cp38-cp38-win_amd64.whl", hash = "sha256:7dde79d007cd6dfa65afe404766057c2409316135cb892be4b1c768e3f3a11cb"},
-    {file = "wrapt-1.13.3-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:981da26722bebb9247a0601e2922cedf8bb7a600e89c852d063313102de6f2cb"},
-    {file = "wrapt-1.13.3-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:705e2af1f7be4707e49ced9153f8d72131090e52be9278b5dbb1498c749a1e32"},
-    {file = "wrapt-1.13.3-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:25b1b1d5df495d82be1c9d2fad408f7ce5ca8a38085e2da41bb63c914baadff7"},
-    {file = "wrapt-1.13.3-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:77416e6b17926d953b5c666a3cb718d5945df63ecf922af0ee576206d7033b5e"},
-    {file = "wrapt-1.13.3-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:865c0b50003616f05858b22174c40ffc27a38e67359fa1495605f96125f76640"},
-    {file = "wrapt-1.13.3-cp39-cp39-win32.whl", hash = "sha256:0a017a667d1f7411816e4bf214646d0ad5b1da2c1ea13dec6c162736ff25a374"},
-    {file = "wrapt-1.13.3-cp39-cp39-win_amd64.whl", hash = "sha256:81bd7c90d28a4b2e1df135bfbd7c23aee3050078ca6441bead44c42483f9ebfb"},
-    {file = "wrapt-1.13.3.tar.gz", hash = "sha256:1fea9cd438686e6682271d36f3481a9f3636195578bab9ca3382e2f5f01fc185"},
+    {file = "wrapt-1.14.1-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:1b376b3f4896e7930f1f772ac4b064ac12598d1c38d04907e696cc4d794b43d3"},
+    {file = "wrapt-1.14.1-cp27-cp27m-manylinux1_i686.whl", hash = "sha256:903500616422a40a98a5a3c4ff4ed9d0066f3b4c951fa286018ecdf0750194ef"},
+    {file = "wrapt-1.14.1-cp27-cp27m-manylinux1_x86_64.whl", hash = "sha256:5a9a0d155deafd9448baff28c08e150d9b24ff010e899311ddd63c45c2445e28"},
+    {file = "wrapt-1.14.1-cp27-cp27m-manylinux2010_i686.whl", hash = "sha256:ddaea91abf8b0d13443f6dac52e89051a5063c7d014710dcb4d4abb2ff811a59"},
+    {file = "wrapt-1.14.1-cp27-cp27m-manylinux2010_x86_64.whl", hash = "sha256:36f582d0c6bc99d5f39cd3ac2a9062e57f3cf606ade29a0a0d6b323462f4dd87"},
+    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux1_i686.whl", hash = "sha256:7ef58fb89674095bfc57c4069e95d7a31cfdc0939e2a579882ac7d55aadfd2a1"},
+    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux1_x86_64.whl", hash = "sha256:e2f83e18fe2f4c9e7db597e988f72712c0c3676d337d8b101f6758107c42425b"},
+    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux2010_i686.whl", hash = "sha256:ee2b1b1769f6707a8a445162ea16dddf74285c3964f605877a20e38545c3c462"},
+    {file = "wrapt-1.14.1-cp27-cp27mu-manylinux2010_x86_64.whl", hash = "sha256:833b58d5d0b7e5b9832869f039203389ac7cbf01765639c7309fd50ef619e0b1"},
+    {file = "wrapt-1.14.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:80bb5c256f1415f747011dc3604b59bc1f91c6e7150bd7db03b19170ee06b320"},
+    {file = "wrapt-1.14.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:07f7a7d0f388028b2df1d916e94bbb40624c59b48ecc6cbc232546706fac74c2"},
+    {file = "wrapt-1.14.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:02b41b633c6261feff8ddd8d11c711df6842aba629fdd3da10249a53211a72c4"},
+    {file = "wrapt-1.14.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2fe803deacd09a233e4762a1adcea5db5d31e6be577a43352936179d14d90069"},
+    {file = "wrapt-1.14.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:257fd78c513e0fb5cdbe058c27a0624c9884e735bbd131935fd49e9fe719d310"},
+    {file = "wrapt-1.14.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:4fcc4649dc762cddacd193e6b55bc02edca674067f5f98166d7713b193932b7f"},
+    {file = "wrapt-1.14.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:11871514607b15cfeb87c547a49bca19fde402f32e2b1c24a632506c0a756656"},
+    {file = "wrapt-1.14.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:8ad85f7f4e20964db4daadcab70b47ab05c7c1cf2a7c1e51087bfaa83831854c"},
+    {file = "wrapt-1.14.1-cp310-cp310-win32.whl", hash = "sha256:a9a52172be0b5aae932bef82a79ec0a0ce87288c7d132946d645eba03f0ad8a8"},
+    {file = "wrapt-1.14.1-cp310-cp310-win_amd64.whl", hash = "sha256:6d323e1554b3d22cfc03cd3243b5bb815a51f5249fdcbb86fda4bf62bab9e164"},
+    {file = "wrapt-1.14.1-cp35-cp35m-manylinux1_i686.whl", hash = "sha256:43ca3bbbe97af00f49efb06e352eae40434ca9d915906f77def219b88e85d907"},
+    {file = "wrapt-1.14.1-cp35-cp35m-manylinux1_x86_64.whl", hash = "sha256:6b1a564e6cb69922c7fe3a678b9f9a3c54e72b469875aa8018f18b4d1dd1adf3"},
+    {file = "wrapt-1.14.1-cp35-cp35m-manylinux2010_i686.whl", hash = "sha256:00b6d4ea20a906c0ca56d84f93065b398ab74b927a7a3dbd470f6fc503f95dc3"},
+    {file = "wrapt-1.14.1-cp35-cp35m-manylinux2010_x86_64.whl", hash = "sha256:a85d2b46be66a71bedde836d9e41859879cc54a2a04fad1191eb50c2066f6e9d"},
+    {file = "wrapt-1.14.1-cp35-cp35m-win32.whl", hash = "sha256:dbcda74c67263139358f4d188ae5faae95c30929281bc6866d00573783c422b7"},
+    {file = "wrapt-1.14.1-cp35-cp35m-win_amd64.whl", hash = "sha256:b21bb4c09ffabfa0e85e3a6b623e19b80e7acd709b9f91452b8297ace2a8ab00"},
+    {file = "wrapt-1.14.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:9e0fd32e0148dd5dea6af5fee42beb949098564cc23211a88d799e434255a1f4"},
+    {file = "wrapt-1.14.1-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9736af4641846491aedb3c3f56b9bc5568d92b0692303b5a305301a95dfd38b1"},
+    {file = "wrapt-1.14.1-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5b02d65b9ccf0ef6c34cba6cf5bf2aab1bb2f49c6090bafeecc9cd81ad4ea1c1"},
+    {file = "wrapt-1.14.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:21ac0156c4b089b330b7666db40feee30a5d52634cc4560e1905d6529a3897ff"},
+    {file = "wrapt-1.14.1-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:9f3e6f9e05148ff90002b884fbc2a86bd303ae847e472f44ecc06c2cd2fcdb2d"},
+    {file = "wrapt-1.14.1-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:6e743de5e9c3d1b7185870f480587b75b1cb604832e380d64f9504a0535912d1"},
+    {file = "wrapt-1.14.1-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:d79d7d5dc8a32b7093e81e97dad755127ff77bcc899e845f41bf71747af0c569"},
+    {file = "wrapt-1.14.1-cp36-cp36m-win32.whl", hash = "sha256:81b19725065dcb43df02b37e03278c011a09e49757287dca60c5aecdd5a0b8ed"},
+    {file = "wrapt-1.14.1-cp36-cp36m-win_amd64.whl", hash = "sha256:b014c23646a467558be7da3d6b9fa409b2c567d2110599b7cf9a0c5992b3b471"},
+    {file = "wrapt-1.14.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:88bd7b6bd70a5b6803c1abf6bca012f7ed963e58c68d76ee20b9d751c74a3248"},
+    {file = "wrapt-1.14.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b5901a312f4d14c59918c221323068fad0540e34324925c8475263841dbdfe68"},
+    {file = "wrapt-1.14.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d77c85fedff92cf788face9bfa3ebaa364448ebb1d765302e9af11bf449ca36d"},
+    {file = "wrapt-1.14.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8d649d616e5c6a678b26d15ece345354f7c2286acd6db868e65fcc5ff7c24a77"},
+    {file = "wrapt-1.14.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:7d2872609603cb35ca513d7404a94d6d608fc13211563571117046c9d2bcc3d7"},
+    {file = "wrapt-1.14.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:ee6acae74a2b91865910eef5e7de37dc6895ad96fa23603d1d27ea69df545015"},
+    {file = "wrapt-1.14.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:2b39d38039a1fdad98c87279b48bc5dce2c0ca0d73483b12cb72aa9609278e8a"},
+    {file = "wrapt-1.14.1-cp37-cp37m-win32.whl", hash = "sha256:60db23fa423575eeb65ea430cee741acb7c26a1365d103f7b0f6ec412b893853"},
+    {file = "wrapt-1.14.1-cp37-cp37m-win_amd64.whl", hash = "sha256:709fe01086a55cf79d20f741f39325018f4df051ef39fe921b1ebe780a66184c"},
+    {file = "wrapt-1.14.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:8c0ce1e99116d5ab21355d8ebe53d9460366704ea38ae4d9f6933188f327b456"},
+    {file = "wrapt-1.14.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:e3fb1677c720409d5f671e39bac6c9e0e422584e5f518bfd50aa4cbbea02433f"},
+    {file = "wrapt-1.14.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:642c2e7a804fcf18c222e1060df25fc210b9c58db7c91416fb055897fc27e8cc"},
+    {file = "wrapt-1.14.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7b7c050ae976e286906dd3f26009e117eb000fb2cf3533398c5ad9ccc86867b1"},
+    {file = "wrapt-1.14.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ef3f72c9666bba2bab70d2a8b79f2c6d2c1a42a7f7e2b0ec83bb2f9e383950af"},
+    {file = "wrapt-1.14.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:01c205616a89d09827986bc4e859bcabd64f5a0662a7fe95e0d359424e0e071b"},
+    {file = "wrapt-1.14.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:5a0f54ce2c092aaf439813735584b9537cad479575a09892b8352fea5e988dc0"},
+    {file = "wrapt-1.14.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:2cf71233a0ed05ccdabe209c606fe0bac7379fdcf687f39b944420d2a09fdb57"},
+    {file = "wrapt-1.14.1-cp38-cp38-win32.whl", hash = "sha256:aa31fdcc33fef9eb2552cbcbfee7773d5a6792c137b359e82879c101e98584c5"},
+    {file = "wrapt-1.14.1-cp38-cp38-win_amd64.whl", hash = "sha256:d1967f46ea8f2db647c786e78d8cc7e4313dbd1b0aca360592d8027b8508e24d"},
+    {file = "wrapt-1.14.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:3232822c7d98d23895ccc443bbdf57c7412c5a65996c30442ebe6ed3df335383"},
+    {file = "wrapt-1.14.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:988635d122aaf2bdcef9e795435662bcd65b02f4f4c1ae37fbee7401c440b3a7"},
+    {file = "wrapt-1.14.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9cca3c2cdadb362116235fdbd411735de4328c61425b0aa9f872fd76d02c4e86"},
+    {file = "wrapt-1.14.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d52a25136894c63de15a35bc0bdc5adb4b0e173b9c0d07a2be9d3ca64a332735"},
+    {file = "wrapt-1.14.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:40e7bc81c9e2b2734ea4bc1aceb8a8f0ceaac7c5299bc5d69e37c44d9081d43b"},
+    {file = "wrapt-1.14.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:b9b7a708dd92306328117d8c4b62e2194d00c365f18eff11a9b53c6f923b01e3"},
+    {file = "wrapt-1.14.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:6a9a25751acb379b466ff6be78a315e2b439d4c94c1e99cb7266d40a537995d3"},
+    {file = "wrapt-1.14.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:34aa51c45f28ba7f12accd624225e2b1e5a3a45206aa191f6f9aac931d9d56fe"},
+    {file = "wrapt-1.14.1-cp39-cp39-win32.whl", hash = "sha256:dee0ce50c6a2dd9056c20db781e9c1cfd33e77d2d569f5d1d9321c641bb903d5"},
+    {file = "wrapt-1.14.1-cp39-cp39-win_amd64.whl", hash = "sha256:dee60e1de1898bde3b238f18340eec6148986da0455d8ba7848d50470a7a32fb"},
+    {file = "wrapt-1.14.1.tar.gz", hash = "sha256:380a85cf89e0e69b7cfbe2ea9f765f004ff419f34194018a6827ac0e3edfed4d"},
 ]
 wsrpc-aiohttp = [
     {file = "wsrpc-aiohttp-3.2.0.tar.gz", hash = "sha256:f467abc51bcdc760fc5aeb7041abdeef46eeca3928dc43dd6e7fa7a533563818"},
@@ -2969,6 +3085,6 @@ yarl = [
     {file = "yarl-1.7.2.tar.gz", hash = "sha256:45399b46d60c253327a460e99856752009fcee5f5d3c80b2f7c0cae1c38d56dd"},
 ]
 zipp = [
-    {file = "zipp-3.7.0-py3-none-any.whl", hash = "sha256:b47250dd24f92b7dd6a0a8fc5244da14608f3ca90a5efcd37a3b1642fac9a375"},
-    {file = "zipp-3.7.0.tar.gz", hash = "sha256:9f50f446828eb9d45b267433fd3e9da8d801f614129124863f9c51ebceafb87d"},
+    {file = "zipp-3.8.0-py3-none-any.whl", hash = "sha256:c4f6e5bbf48e74f7a38e7cc5b0480ff42b0ae5178957d564d18932525d5cf099"},
+    {file = "zipp-3.8.0.tar.gz", hash = "sha256:56bf8aadb83c24db6c4b577e13de374ccfb67da2078beba1d037c17980bf43ad"},
 ]

From e5fbdd1d43ee2a51a0bfec38d3859c5b8b20a080 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 20 Jun 2022 15:11:26 +0200
Subject: [PATCH 0729/1227] added shotgun-api3 source files to poetry lock

---
 poetry.lock | 1 +
 1 file changed, 1 insertion(+)

diff --git a/poetry.lock b/poetry.lock
index 3e6620b4a2..f6ccf1ffc9 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -2818,6 +2818,7 @@ semver = [
     {file = "semver-2.13.0-py2.py3-none-any.whl", hash = "sha256:ced8b23dceb22134307c1b8abfa523da14198793d9787ac838e70e29e77458d4"},
     {file = "semver-2.13.0.tar.gz", hash = "sha256:fa0fe2722ee1c3f57eac478820c3a5ae2f624af8264cbdf9000c980ff7f75e3f"},
 ]
+shotgun-api3 = []
 six = [
     {file = "six-1.16.0-py2.py3-none-any.whl", hash = "sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254"},
     {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"},

From 8ac3ed77d55def1ea674009cf630783059ea7823 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 20 Jun 2022 15:19:26 +0200
Subject: [PATCH 0730/1227] Nuke: fix none existing rendered files error

addressing the comment https://github.com/pypeclub/OpenPype/pull/3245#pullrequestreview-1004589515
---
 .../plugins/publish/extract_slate_frame.py    | 49 +++++++++++++++----
 1 file changed, 39 insertions(+), 10 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
index 87cb333ae1..e0c4bdb953 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
@@ -74,6 +74,30 @@ class ExtractSlateFrame(openpype.api.Extractor):
         self.log.info(
             "StagingDir `{0}`...".format(instance.data["stagingDir"]))
 
+    def _check_frames_exists(self, instance):
+        # rendering path from group write node
+        fpath = instance.data["path"]
+
+        # instance frame range with handles
+        first = instance.data["frameStartHandle"]
+        last = instance.data["frameEndHandle"]
+
+        padding = fpath.count('#')
+
+        test_path_template = fpath
+        if padding:
+            repl_string = "#" * padding
+            test_path_template = fpath.replace(
+                repl_string, "%0{}d".format(padding))
+
+        for frame in range(first, last + 1):
+            test_file = test_path_template % frame
+            if not os.path.exists(test_file):
+                self.log.debug("__ test_file: `{}`".format(test_file))
+                return None
+
+        return True
+
     def render_slate(
         self,
         instance,
@@ -128,16 +152,21 @@ class ExtractSlateFrame(openpype.api.Extractor):
         self.log.debug("__ first_frame: {}".format(first_frame))
         self.log.debug("__ slate_first_frame: {}".format(slate_first_frame))
 
-        # Read node
-        r_node = nuke.createNode("Read")
-        r_node["file"].setValue(fpath)
-        r_node["first"].setValue(first_frame)
-        r_node["origfirst"].setValue(first_frame)
-        r_node["last"].setValue(last_frame)
-        r_node["origlast"].setValue(last_frame)
-        r_node["colorspace"].setValue(instance.data["colorspace"])
-        previous_node = r_node
-        temporary_nodes = [previous_node]
+        # fallback if files does not exists
+        if self._check_frames_exists(instance):
+            # Read node
+            r_node = nuke.createNode("Read")
+            r_node["file"].setValue(fpath)
+            r_node["first"].setValue(first_frame)
+            r_node["origfirst"].setValue(first_frame)
+            r_node["last"].setValue(last_frame)
+            r_node["origlast"].setValue(last_frame)
+            r_node["colorspace"].setValue(instance.data["colorspace"])
+            previous_node = r_node
+            temporary_nodes = [previous_node]
+        else:
+            previous_node = slate_node.dependencies().pop()
+            temporary_nodes = []
 
         # only create colorspace baking if toggled on
         if bake_viewer_process:

From 497e4c0cca40ee8e39b03ec00c08a594ffc76dbd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 20 Jun 2022 18:31:29 +0200
Subject: [PATCH 0731/1227] use query functions in aftereffects

---
 .../aftereffects/plugins/create/workfile_creator.py   | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/aftereffects/plugins/create/workfile_creator.py b/openpype/hosts/aftereffects/plugins/create/workfile_creator.py
index 88e55e21b5..badb3675fd 100644
--- a/openpype/hosts/aftereffects/plugins/create/workfile_creator.py
+++ b/openpype/hosts/aftereffects/plugins/create/workfile_creator.py
@@ -1,4 +1,5 @@
 import openpype.hosts.aftereffects.api as api
+from openpype.client import get_asset_by_name
 from openpype.pipeline import (
     AutoCreator,
     CreatedInstance,
@@ -41,10 +42,7 @@ class AEWorkfileCreator(AutoCreator):
         host_name = legacy_io.Session["AVALON_APP"]
 
         if existing_instance is None:
-            asset_doc = legacy_io.find_one({
-                "type": "asset",
-                "name": asset_name
-            })
+            asset_doc = get_asset_by_name(project_name, asset_name)
             subset_name = self.get_subset_name(
                 variant, task_name, asset_doc, project_name, host_name
             )
@@ -69,10 +67,7 @@ class AEWorkfileCreator(AutoCreator):
             existing_instance["asset"] != asset_name
             or existing_instance["task"] != task_name
         ):
-            asset_doc = legacy_io.find_one({
-                "type": "asset",
-                "name": asset_name
-            })
+            asset_doc = get_asset_by_name(project_name, asset_name)
             subset_name = self.get_subset_name(
                 variant, task_name, asset_doc, project_name, host_name
             )

From b9a67fb80117e980462222f733df5f64968b16b0 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 20 Jun 2022 18:43:14 +0200
Subject: [PATCH 0732/1227] pass asset document to 'get_asset_settings'

---
 openpype/hosts/aftereffects/api/pipeline.py              | 4 ++--
 .../plugins/publish/validate_scene_settings.py           | 9 +++++++--
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/aftereffects/api/pipeline.py b/openpype/hosts/aftereffects/api/pipeline.py
index a428a1470d..0bc47665b0 100644
--- a/openpype/hosts/aftereffects/api/pipeline.py
+++ b/openpype/hosts/aftereffects/api/pipeline.py
@@ -65,14 +65,14 @@ def on_pyblish_instance_toggled(instance, old_value, new_value):
     instance[0].Visible = new_value
 
 
-def get_asset_settings():
+def get_asset_settings(asset_doc):
     """Get settings on current asset from database.
 
     Returns:
         dict: Scene data.
 
     """
-    asset_data = lib.get_asset()["data"]
+    asset_data = asset_doc["data"]
     fps = asset_data.get("fps")
     frame_start = asset_data.get("frameStart")
     frame_end = asset_data.get("frameEnd")
diff --git a/openpype/hosts/aftereffects/plugins/publish/validate_scene_settings.py b/openpype/hosts/aftereffects/plugins/publish/validate_scene_settings.py
index 6fe63fc41e..78f98d7445 100644
--- a/openpype/hosts/aftereffects/plugins/publish/validate_scene_settings.py
+++ b/openpype/hosts/aftereffects/plugins/publish/validate_scene_settings.py
@@ -1,5 +1,9 @@
 # -*- coding: utf-8 -*-
-"""Validate scene settings."""
+"""Validate scene settings.
+Requires:
+    instance    -> assetEntity
+    instance    -> anatomyData
+"""
 import os
 import re
 
@@ -67,7 +71,8 @@ class ValidateSceneSettings(OptionalPyblishPluginMixin,
         if not self.is_active(instance.data):
             return
 
-        expected_settings = get_asset_settings()
+        asset_doc = instance.data["assetEntity"]
+        expected_settings = get_asset_settings(asset_doc)
         self.log.info("config from DB::{}".format(expected_settings))
 
         task_name = instance.data["anatomyData"]["task"]["name"]

From d39481042dd7fde38a57acf466da8a23fe877ad3 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 20 Jun 2022 18:50:26 +0200
Subject: [PATCH 0733/1227] use query functions in photoshop creator

---
 .../photoshop/plugins/create/workfile_creator.py      | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/photoshop/plugins/create/workfile_creator.py b/openpype/hosts/photoshop/plugins/create/workfile_creator.py
index 875a9b8a94..43302329f1 100644
--- a/openpype/hosts/photoshop/plugins/create/workfile_creator.py
+++ b/openpype/hosts/photoshop/plugins/create/workfile_creator.py
@@ -1,4 +1,5 @@
 import openpype.hosts.photoshop.api as api
+from openpype.client import get_asset_by_name
 from openpype.pipeline import (
     AutoCreator,
     CreatedInstance,
@@ -40,10 +41,7 @@ class PSWorkfileCreator(AutoCreator):
         task_name = legacy_io.Session["AVALON_TASK"]
         host_name = legacy_io.Session["AVALON_APP"]
         if existing_instance is None:
-            asset_doc = legacy_io.find_one({
-                "type": "asset",
-                "name": asset_name
-            })
+            asset_doc = get_asset_by_name(project_name, asset_name)
             subset_name = self.get_subset_name(
                 variant, task_name, asset_doc, project_name, host_name
             )
@@ -67,10 +65,7 @@ class PSWorkfileCreator(AutoCreator):
             existing_instance["asset"] != asset_name
             or existing_instance["task"] != task_name
         ):
-            asset_doc = legacy_io.find_one({
-                "type": "asset",
-                "name": asset_name
-            })
+            asset_doc = get_asset_by_name(project_name, asset_name)
             subset_name = self.get_subset_name(
                 variant, task_name, asset_doc, project_name, host_name
             )

From d3afa478b71974fff455669a394eaff3bca3468e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 20 Jun 2022 19:01:47 +0200
Subject: [PATCH 0734/1227] use query functions in celaction

---
 .../plugins/publish/collect_audio.py          | 47 +++++++------------
 1 file changed, 17 insertions(+), 30 deletions(-)

diff --git a/openpype/hosts/celaction/plugins/publish/collect_audio.py b/openpype/hosts/celaction/plugins/publish/collect_audio.py
index 8acda5fc7c..c6e3bf2c03 100644
--- a/openpype/hosts/celaction/plugins/publish/collect_audio.py
+++ b/openpype/hosts/celaction/plugins/publish/collect_audio.py
@@ -4,6 +4,11 @@ from pprint import pformat
 
 import pyblish.api
 
+from openpype.client import (
+    get_subsets,
+    get_last_versions,
+    get_representations
+)
 from openpype.pipeline import legacy_io
 
 
@@ -60,10 +65,10 @@ class AppendCelactionAudio(pyblish.api.ContextPlugin):
         """
 
         # Query all subsets for asset
-        subset_docs = legacy_io.find({
-            "type": "subset",
-            "parent": asset_doc["_id"]
-        })
+        project_name = legacy_io.active_project()
+        subset_docs = get_subsets(
+            project_name, asset_ids=[asset_doc["_id"]], fields=["_id"]
+        )
         # Collect all subset ids
         subset_ids = [
             subset_doc["_id"]
@@ -76,37 +81,19 @@ class AppendCelactionAudio(pyblish.api.ContextPlugin):
             "Try this for start `r'.*'`: asset: `{}`"
         ).format(asset_doc["name"])
 
-        # Last version aggregation
-        pipeline = [
-            # Find all versions of those subsets
-            {"$match": {
-                "type": "version",
-                "parent": {"$in": subset_ids}
-            }},
-            # Sorting versions all together
-            {"$sort": {"name": 1}},
-            # Group them by "parent", but only take the last
-            {"$group": {
-                "_id": "$parent",
-                "_version_id": {"$last": "$_id"},
-                "name": {"$last": "$name"}
-            }}
-        ]
-        last_versions_by_subset_id = dict()
-        for doc in legacy_io.aggregate(pipeline):
-            doc["parent"] = doc["_id"]
-            doc["_id"] = doc.pop("_version_id")
-            last_versions_by_subset_id[doc["parent"]] = doc
+        last_versions_by_subset_id = get_last_versions(
+            project_name, subset_ids, fields=["_id", "parent"]
+        )
 
         version_docs_by_id = {}
         for version_doc in last_versions_by_subset_id.values():
             version_docs_by_id[version_doc["_id"]] = version_doc
 
-        repre_docs = legacy_io.find({
-            "type": "representation",
-            "parent": {"$in": list(version_docs_by_id.keys())},
-            "name": {"$in": representations}
-        })
+        repre_docs = get_representations(
+            project_name,
+            version_ids=version_docs_by_id.keys(),
+            representation_names=representations
+        )
         repre_docs_by_version_id = collections.defaultdict(list)
         for repre_doc in repre_docs:
             version_id = repre_doc["parent"]

From a93b978f354b6ed34034f0f4caaa98b8c637468e Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 20 Jun 2022 21:48:08 +0200
Subject: [PATCH 0735/1227] flame: fixing thumbnail duplication issue

---
 .../hosts/flame/plugins/publish/extract_subset_resources.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 5e0a5e344d..dd672ec375 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -86,7 +86,11 @@ class ExtractSubsetResources(openpype.api.Extractor):
         # add default preset type for thumbnail and reviewable video
         # update them with settings and override in case the same
         # are found in there
-        export_presets = deepcopy(self.default_presets)
+        _preset_keys = [k.split('_')[0] for k in self.export_presets_mapping]
+        export_presets = {
+            k: v for k, v in deepcopy(self.default_presets)
+            if k not in _preset_keys
+        }
         export_presets.update(self.export_presets_mapping)
 
         # loop all preset names and

From 70d9b6fcb73c7ac3abb74d2218fcf2e53e845427 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 20 Jun 2022 22:00:41 +0200
Subject: [PATCH 0736/1227] flame: fixing dict iter with items

---
 .../hosts/flame/plugins/publish/extract_subset_resources.py     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index dd672ec375..1b6900e405 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -88,7 +88,7 @@ class ExtractSubsetResources(openpype.api.Extractor):
         # are found in there
         _preset_keys = [k.split('_')[0] for k in self.export_presets_mapping]
         export_presets = {
-            k: v for k, v in deepcopy(self.default_presets)
+            k: v for k, v in deepcopy(self.default_presets).items()
             if k not in _preset_keys
         }
         export_presets.update(self.export_presets_mapping)

From 250f73656ac382e7d9bb441326bbd6f55118e0eb Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 20 Jun 2022 22:04:36 +0200
Subject: [PATCH 0737/1227] Flame: fixing NoneType in abs

---
 .../flame/plugins/publish/collect_timeline_instances.py    | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
index aa19b78bf1..b8489de758 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
@@ -1,4 +1,5 @@
 import re
+from types import NoneType
 import pyblish
 import openpype.hosts.flame.api as opfapi
 from openpype.hosts.flame.otio import flame_export
@@ -75,6 +76,12 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
                 marker_data["handleEnd"]
             )
 
+            # make sure there is not NoneType rather 0
+            if isinstance(head, NoneType):
+                head = 0
+            if isinstance(tail, NoneType):
+                tail = 0
+
             # make sure value is absolute
             if head != 0:
                 head = abs(head)

From a29a9af927c339acac56711351a3b995846e4111 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 20 Jun 2022 22:11:15 +0200
Subject: [PATCH 0738/1227] flame: unique name swapped with repre name

unique name could be more than `thumbnail`
---
 .../flame/plugins/publish/extract_subset_resources.py     | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 1b6900e405..3ae8779398 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -228,7 +228,11 @@ class ExtractSubsetResources(openpype.api.Extractor):
 
             # make sure only first segment is used if underscore in name
             # HACK: `ftrackreview_withLUT` will result only in `ftrackreview`
-            repr_name = unique_name.split("_")[0]
+            if (
+                "thumbnail" in unique_name
+                or "ftrackreview" in unique_name
+            ):
+                repr_name = unique_name.split("_")[0]
 
             # create representation data
             representation_data = {
@@ -267,7 +271,7 @@ class ExtractSubsetResources(openpype.api.Extractor):
                     if os.path.splitext(f)[-1] == ".mov"
                 ]
                 # then try if thumbnail is not in unique name
-                or unique_name == "thumbnail"
+                or repr_name == "thumbnail"
             ):
                 representation_data["files"] = files.pop()
             else:

From 035b202b58fc3c8a2e0f381ce4856a4f551e18a4 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 20 Jun 2022 22:19:05 +0200
Subject: [PATCH 0739/1227] Flame: fixing repr_name missing

---
 openpype/hosts/flame/plugins/publish/extract_subset_resources.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
index 3ae8779398..d34f5d5854 100644
--- a/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
+++ b/openpype/hosts/flame/plugins/publish/extract_subset_resources.py
@@ -226,6 +226,7 @@ class ExtractSubsetResources(openpype.api.Extractor):
             opfapi.export_clip(
                 export_dir_path, exporting_clip, preset_path, **export_kwargs)
 
+            repr_name = unique_name
             # make sure only first segment is used if underscore in name
             # HACK: `ftrackreview_withLUT` will result only in `ftrackreview`
             if (

From 144ef08260f58fcbc3eff56f80073db46432c055 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Tue, 21 Jun 2022 08:29:04 +0200
Subject: [PATCH 0740/1227] change default settings

---
 openpype/settings/defaults/system_settings/modules.json | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/settings/defaults/system_settings/modules.json b/openpype/settings/defaults/system_settings/modules.json
index d55691d7a2..9d8910689a 100644
--- a/openpype/settings/defaults/system_settings/modules.json
+++ b/openpype/settings/defaults/system_settings/modules.json
@@ -132,8 +132,7 @@
         }
     },
     "shotgrid": {
-        "enabled": true,
-        "filter_projects_by_login": true,
+        "enabled": false,
         "leecher_manager_url": "http://127.0.0.1:3000",
         "leecher_backend_url": "http://127.0.0.1:8090",
         "shotgrid_settings": {}

From fa8d37d9b68ebb1c1ac85ec6bd8c00fd348e4f80 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 10:55:07 +0200
Subject: [PATCH 0741/1227] use query functions in harmony

---
 openpype/hosts/harmony/api/README.md   |  3 ++-
 openpype/hosts/harmony/api/pipeline.py | 18 ++++++++----------
 2 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/openpype/hosts/harmony/api/README.md b/openpype/hosts/harmony/api/README.md
index dd45eb14dd..b39f900886 100644
--- a/openpype/hosts/harmony/api/README.md
+++ b/openpype/hosts/harmony/api/README.md
@@ -610,7 +610,8 @@ class ImageSequenceLoader(load.LoaderPlugin):
     def update(self, container, representation):
         node = container.pop("node")
 
-        version = legacy_io.find_one({"_id": representation["parent"]})
+        project_name = legacy_io.active_project()
+        version = get_version_by_id(project_name, representation["parent"])
         files = []
         for f in version["data"]["files"]:
             files.append(
diff --git a/openpype/hosts/harmony/api/pipeline.py b/openpype/hosts/harmony/api/pipeline.py
index b953d0e984..86b5753f7e 100644
--- a/openpype/hosts/harmony/api/pipeline.py
+++ b/openpype/hosts/harmony/api/pipeline.py
@@ -2,10 +2,10 @@ import os
 from pathlib import Path
 import logging
 
-from bson.objectid import ObjectId
 import pyblish.api
 
 from openpype import lib
+from openpype.client import get_representation_by_id
 from openpype.lib import register_event_callback
 from openpype.pipeline import (
     legacy_io,
@@ -104,22 +104,20 @@ def check_inventory():
     If it does it will colorize outdated nodes and display warning message
     in Harmony.
     """
-    if not lib.any_outdated():
-        return
 
+    project_name = legacy_io.active_project()
     outdated_containers = []
     for container in ls():
-        representation = container['representation']
-        representation_doc = legacy_io.find_one(
-            {
-                "_id": ObjectId(representation),
-                "type": "representation"
-            },
-            projection={"parent": True}
+        representation_id = container['representation']
+        representation_doc = get_representation_by_id(
+            project_name, representation_id, fields=["parent"]
         )
         if representation_doc and not lib.is_latest(representation_doc):
             outdated_containers.append(container)
 
+    if not outdated_containers:
+        return
+
     # Colour nodes.
     outdated_nodes = []
     for container in outdated_containers:

From 6de95ba8064a9ec06757dc8d8fc2b0e15e12498b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 11:04:02 +0200
Subject: [PATCH 0742/1227] resolve is using query functions

---
 .../hosts/resolve/plugins/load/load_clip.py   | 29 +++++++++++--------
 1 file changed, 17 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/resolve/plugins/load/load_clip.py b/openpype/hosts/resolve/plugins/load/load_clip.py
index cf88b14e81..86dd6850e7 100644
--- a/openpype/hosts/resolve/plugins/load/load_clip.py
+++ b/openpype/hosts/resolve/plugins/load/load_clip.py
@@ -1,6 +1,10 @@
 from copy import deepcopy
 from importlib import reload
 
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id,
+)
 from openpype.hosts import resolve
 from openpype.pipeline import (
     get_representation_path,
@@ -96,10 +100,8 @@ class LoadClip(resolve.TimelineItemLoader):
         namespace = container['namespace']
         timeline_item_data = resolve.get_pype_timeline_item_by_name(namespace)
         timeline_item = timeline_item_data["clip"]["item"]
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
+        project_name = legacy_io.active_project()
+        version = get_version_by_id(project_name, representation["parent"])
         version_data = version.get("data", {})
         version_name = version.get("name", None)
         colorspace = version_data.get("colorspace", None)
@@ -138,19 +140,22 @@ class LoadClip(resolve.TimelineItemLoader):
 
     @classmethod
     def set_item_color(cls, timeline_item, version):
-
         # define version name
         version_name = version.get("name", None)
         # get all versions in list
-        versions = legacy_io.find({
-            "type": "version",
-            "parent": version["parent"]
-        }).distinct('name')
-
-        max_version = max(versions)
+        project_name = legacy_io.active_project()
+        last_version_doc = get_last_version_by_subset_id(
+            project_name,
+            version["parent"],
+            fields=["name"]
+        )
+        if last_version_doc:
+            last_version = last_version_doc["name"]
+        else:
+            last_version = None
 
         # set clip colour
-        if version_name == max_version:
+        if version_name == last_version:
             timeline_item.SetClipColor(cls.clip_color_last)
         else:
             timeline_item.SetClipColor(cls.clip_color)

From 2fd9063de4b92818cc26151243da2e5bdcd4af05 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 11:20:09 +0200
Subject: [PATCH 0743/1227] use query functions in fusion

---
 openpype/hosts/fusion/api/lib.py              | 53 +++++++++----------
 .../hosts/fusion/utility_scripts/switch_ui.py | 13 +++--
 2 files changed, 35 insertions(+), 31 deletions(-)

diff --git a/openpype/hosts/fusion/api/lib.py b/openpype/hosts/fusion/api/lib.py
index 29f3a3a3eb..001eb636ee 100644
--- a/openpype/hosts/fusion/api/lib.py
+++ b/openpype/hosts/fusion/api/lib.py
@@ -3,9 +3,16 @@ import sys
 import re
 import contextlib
 
-from bson.objectid import ObjectId
 from Qt import QtGui
 
+from openpype.client import (
+    get_asset_by_name,
+    get_subset_by_name,
+    get_last_version_by_subset_id,
+    get_representation_by_id,
+    get_representation_by_name,
+    get_representation_parents,
+)
 from openpype.pipeline import (
     switch_container,
     legacy_io,
@@ -93,13 +100,16 @@ def switch_item(container,
         raise ValueError("Must have at least one change provided to switch.")
 
     # Collect any of current asset, subset and representation if not provided
-    # so we can use the original name from those.
+    #   so we can use the original name from those.
+    project_name = legacy_io.active_project()
     if any(not x for x in [asset_name, subset_name, representation_name]):
-        _id = ObjectId(container["representation"])
-        representation = legacy_io.find_one({
-            "type": "representation", "_id": _id
-        })
-        version, subset, asset, project = legacy_io.parenthood(representation)
+        repre_id = container["representation"]
+        representation = get_representation_by_id(project_name, repre_id)
+        repre_parent_docs = get_representation_parents(representation)
+        if repre_parent_docs:
+            version, subset, asset, _ = repre_parent_docs
+        else:
+            version = subset = asset = None
 
         if asset_name is None:
             asset_name = asset["name"]
@@ -111,39 +121,26 @@ def switch_item(container,
             representation_name = representation["name"]
 
     # Find the new one
-    asset = legacy_io.find_one({
-        "name": asset_name,
-        "type": "asset"
-    })
+    asset = get_asset_by_name(project_name, asset_name, fields=["_id"])
     assert asset, ("Could not find asset in the database with the name "
                    "'%s'" % asset_name)
 
-    subset = legacy_io.find_one({
-        "name": subset_name,
-        "type": "subset",
-        "parent": asset["_id"]
-    })
+    subset = get_subset_by_name(
+        project_name, subset_name, asset["_id"], fields=["_id"]
+    )
     assert subset, ("Could not find subset in the database with the name "
                     "'%s'" % subset_name)
 
-    version = legacy_io.find_one(
-        {
-            "type": "version",
-            "parent": subset["_id"]
-        },
-        sort=[('name', -1)]
+    version = get_last_version_by_subset_id(
+        project_name, subset["_id"], fields=["_id"]
     )
-
     assert version, "Could not find a version for {}.{}".format(
         asset_name, subset_name
     )
 
-    representation = legacy_io.find_one({
-        "name": representation_name,
-        "type": "representation",
-        "parent": version["_id"]}
+    representation = get_representation_by_name(
+        project_name, representation_name, version["_id"]
     )
-
     assert representation, ("Could not find representation in the database "
                             "with the name '%s'" % representation_name)
 
diff --git a/openpype/hosts/fusion/utility_scripts/switch_ui.py b/openpype/hosts/fusion/utility_scripts/switch_ui.py
index 70eb3d0a19..01d55db647 100644
--- a/openpype/hosts/fusion/utility_scripts/switch_ui.py
+++ b/openpype/hosts/fusion/utility_scripts/switch_ui.py
@@ -7,6 +7,7 @@ from Qt import QtWidgets, QtCore
 
 import qtawesome as qta
 
+from openpype.client import get_assets
 from openpype import style
 from openpype.pipeline import (
     install_host,
@@ -142,7 +143,7 @@ class App(QtWidgets.QWidget):
         # Clear any existing items
         self._assets.clear()
 
-        asset_names = [a["name"] for a in self.collect_assets()]
+        asset_names = self.collect_asset_names()
         completer = QtWidgets.QCompleter(asset_names)
 
         self._assets.setCompleter(completer)
@@ -165,8 +166,14 @@ class App(QtWidgets.QWidget):
         items = glob.glob("{}/*.comp".format(directory))
         return items
 
-    def collect_assets(self):
-        return list(legacy_io.find({"type": "asset"}, {"name": True}))
+    def collect_asset_names(self):
+        project_name = legacy_io.active_project()
+        asset_docs = get_assets(project_name, fields=["name"])
+        asset_names = {
+            asset_doc["name"]
+            for asset_doc in asset_docs
+        }
+        return list(asset_names)
 
     def populate_comp_box(self, files):
         """Ensure we display the filename only but the path is stored as well

From 645b89ced5419d6f74ff5c5782981a72d0e70df1 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 11:38:18 +0200
Subject: [PATCH 0744/1227] use query functions in remaining places

---
 .../hosts/fusion/plugins/load/load_sequence.py   |  7 +++----
 .../hosts/fusion/scripts/fusion_switch_shot.py   | 16 +++++++++++-----
 2 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/fusion/plugins/load/load_sequence.py b/openpype/hosts/fusion/plugins/load/load_sequence.py
index b860abd88b..9baa652b60 100644
--- a/openpype/hosts/fusion/plugins/load/load_sequence.py
+++ b/openpype/hosts/fusion/plugins/load/load_sequence.py
@@ -1,6 +1,7 @@
 import os
 import contextlib
 
+from openpype.client import get_version_by_id
 from openpype.pipeline import (
     load,
     legacy_io,
@@ -211,10 +212,8 @@ class FusionLoadSequence(load.LoaderPlugin):
         path = self._get_first_image(root)
 
         # Get start frame from version data
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
+        project_name = legacy_io.active_project()
+        version = get_version_by_id(project_name, representation["parent"])
         start = version["data"].get("frameStart")
         if start is None:
             self.log.warning("Missing start frame for updated version"
diff --git a/openpype/hosts/fusion/scripts/fusion_switch_shot.py b/openpype/hosts/fusion/scripts/fusion_switch_shot.py
index 704f420796..52a157c56e 100644
--- a/openpype/hosts/fusion/scripts/fusion_switch_shot.py
+++ b/openpype/hosts/fusion/scripts/fusion_switch_shot.py
@@ -4,6 +4,11 @@ import sys
 import logging
 
 # Pipeline imports
+from openpype.client import (
+    get_project,
+    get_asset_by_name,
+    get_versions,
+)
 from openpype.pipeline import (
     legacy_io,
     install_host,
@@ -164,9 +169,9 @@ def update_frame_range(comp, representations):
 
     """
 
-    version_ids = [r["parent"] for r in representations]
-    versions = legacy_io.find({"type": "version", "_id": {"$in": version_ids}})
-    versions = list(versions)
+    project_name = legacy_io.active_project()
+    version_ids = {r["parent"] for r in representations}
+    versions = list(get_versions(project_name, version_ids))
 
     versions = [v for v in versions
                 if v["data"].get("frameStart", None) is not None]
@@ -203,11 +208,12 @@ def switch(asset_name, filepath=None, new=True):
 
     # Assert asset name exists
     # It is better to do this here then to wait till switch_shot does it
-    asset = legacy_io.find_one({"type": "asset", "name": asset_name})
+    project_name = legacy_io.active_project()
+    asset = get_asset_by_name(project_name, asset_name)
     assert asset, "Could not find '%s' in the database" % asset_name
 
     # Get current project
-    self._project = legacy_io.find_one({"type": "project"})
+    self._project = get_project(project_name)
 
     # Go to comp
     if not filepath:

From 2c7c10a404400903089ab561e85661d2f84fb0bd Mon Sep 17 00:00:00 2001
From: murphy <murphy@e-area.cz>
Date: Tue, 21 Jun 2022 12:03:31 +0200
Subject: [PATCH 0745/1227] vray device aspect ratio fix

Vray has different attribute name for device aspect ratio from other renderers.

 (.aspectRatio instead of .deviceAspectRatio)


Testing
- open/create a maya scene with vray renderer set
- run OpenPype -> Set Resolution

resolution should be set without an error message about nonexistent vray attribute
---
 openpype/hosts/maya/api/lib.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index bce03a648b..d5763160bc 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2141,7 +2141,7 @@ def set_scene_resolution(width, height, pixelAspect):
     cmds.setAttr("%s.height" % control_node, height)
 
     deviceAspectRatio = ((float(width) / float(height)) * float(pixelAspect))
-    cmds.setAttr("%s.deviceAspectRatio" % control_node, deviceAspectRatio)
+    cmds.setAttr("%s.aspectRatio" % control_node, deviceAspectRatio)
     cmds.setAttr("%s.pixelAspect" % control_node, pixelAspect)
 
 

From 861fbee46c36762f50bffbe9aa00a9a60af30cfb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Tue, 21 Jun 2022 14:14:39 +0200
Subject: [PATCH 0746/1227] :ambulance: limit attribute name only to vray

---
 openpype/hosts/maya/api/lib.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index d5763160bc..3e239d5361 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2126,9 +2126,11 @@ def set_scene_resolution(width, height, pixelAspect):
 
     control_node = "defaultResolution"
     current_renderer = cmds.getAttr("defaultRenderGlobals.currentRenderer")
+    aspect_ration_attr = "deviceAspectRatio"
 
     # Give VRay a helping hand as it is slightly different from the rest
     if current_renderer == "vray":
+        aspect_ration_attr = "aspectRatio"
         vray_node = "vraySettings"
         if cmds.objExists(vray_node):
             control_node = vray_node
@@ -2141,7 +2143,8 @@ def set_scene_resolution(width, height, pixelAspect):
     cmds.setAttr("%s.height" % control_node, height)
 
     deviceAspectRatio = ((float(width) / float(height)) * float(pixelAspect))
-    cmds.setAttr("%s.aspectRatio" % control_node, deviceAspectRatio)
+    cmds.setAttr(
+        "{}.{}".format(control_node, aspect_ration_attr), deviceAspectRatio)
     cmds.setAttr("%s.pixelAspect" % control_node, pixelAspect)
 
 

From 94af9cdcc949ee4b84cb2cedc4d35cec9e47af11 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Tue, 21 Jun 2022 14:16:00 +0200
Subject: [PATCH 0747/1227] :pencil2: fix typo in variable name

---
 openpype/hosts/maya/api/lib.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 3e239d5361..92a3efcd1f 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2126,11 +2126,11 @@ def set_scene_resolution(width, height, pixelAspect):
 
     control_node = "defaultResolution"
     current_renderer = cmds.getAttr("defaultRenderGlobals.currentRenderer")
-    aspect_ration_attr = "deviceAspectRatio"
+    aspect_ratio_attr = "deviceAspectRatio"
 
     # Give VRay a helping hand as it is slightly different from the rest
     if current_renderer == "vray":
-        aspect_ration_attr = "aspectRatio"
+        aspect_ratio_attr = "aspectRatio"
         vray_node = "vraySettings"
         if cmds.objExists(vray_node):
             control_node = vray_node
@@ -2144,7 +2144,7 @@ def set_scene_resolution(width, height, pixelAspect):
 
     deviceAspectRatio = ((float(width) / float(height)) * float(pixelAspect))
     cmds.setAttr(
-        "{}.{}".format(control_node, aspect_ration_attr), deviceAspectRatio)
+        "{}.{}".format(control_node, aspect_ratio_attr), deviceAspectRatio)
     cmds.setAttr("%s.pixelAspect" % control_node, pixelAspect)
 
 

From 783f07e616a8a9749f2f37e44870a37c99719317 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 14:35:06 +0200
Subject: [PATCH 0748/1227] make sure exit code is set to not None

---
 openpype/hosts/tvpaint/api/communication_server.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/openpype/hosts/tvpaint/api/communication_server.py b/openpype/hosts/tvpaint/api/communication_server.py
index 65cb9aa2f3..6ac3e6324c 100644
--- a/openpype/hosts/tvpaint/api/communication_server.py
+++ b/openpype/hosts/tvpaint/api/communication_server.py
@@ -707,6 +707,9 @@ class BaseCommunicator:
         if exit_code is not None:
             self.exit_code = exit_code
 
+        if self.exit_code is None:
+            self.exit_code = 0
+
     def stop(self):
         """Stop communication and currently running python process."""
         log.info("Stopping communication")

From 28d7e2ab517f0a311b689bb18582dcd737308ed1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Tue, 21 Jun 2022 14:50:59 +0200
Subject: [PATCH 0749/1227] :recycle: clean up some superfluous output

---
 .../hosts/maya/plugins/publish/validate_camera_contents.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_camera_contents.py b/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
index eb93245f93..87712a4cea 100644
--- a/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
+++ b/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
@@ -51,18 +51,17 @@ class ValidateCameraContents(pyblish.api.InstancePlugin):
                 raise RuntimeError("No cameras found in empty instance.")
 
         if not cls.validate_shapes:
-            cls.log.info("not validating shapes in the content")
+            cls.log.info("Not validating shapes in the content.")
 
             for member in members:
                 parents = cmds.ls(member, long=True)[0].split("|")[1:-1]
-                cls.log.info(parents)
                 parents_long_named = [
                     "|".join(parents[:i]) for i in range(1, 1 + len(parents))
                 ]
-                cls.log.info(parents_long_named)
                 if cameras[0] in parents_long_named:
                     cls.log.error(
-                        "{} is parented under camera {}".format(member, cameras[0]))
+                        "{} is parented under camera {}".format(
+                            member, cameras[0]))
                     invalid.extend(member)
             return invalid
 

From 9136af76fadf21af6ce6b93292809174f95f70a4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Tue, 21 Jun 2022 15:06:00 +0200
Subject: [PATCH 0750/1227] :recycle: simplify prefix reduction

---
 .../hosts/maya/plugins/publish/validate_rendersettings.py   | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_rendersettings.py b/openpype/hosts/maya/plugins/publish/validate_rendersettings.py
index 5875e65e47..1dab3274a0 100644
--- a/openpype/hosts/maya/plugins/publish/validate_rendersettings.py
+++ b/openpype/hosts/maya/plugins/publish/validate_rendersettings.py
@@ -218,11 +218,7 @@ class ValidateRenderSettings(pyblish.api.InstancePlugin):
                 default_prefix = re.sub(
                     cls.R_AOV_TOKEN, "", default_prefix)
                 # remove aov token from prefix to pass validation
-                # first resolve it and then remove if dangling
-                default_prefix = default_prefix.replace(
-                    "{aov_separator}", instance.data.get("aovSeparator", "_"))
-                default_prefix = default_prefix.rstrip(
-                    instance.data.get("aovSeparator", "_"))
+                default_prefix = default_prefix.split("{aov_separator}")[0]
             elif not re.search(cls.R_AOV_TOKEN, prefix):
                 invalid = True
                 cls.log.error("Wrong image prefix [ {} ] - "

From 569d7c98fc7eaed14bb20ea86c5ea78c1d2941d2 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 21 Jun 2022 16:06:53 +0300
Subject: [PATCH 0751/1227] Add hardware fog keys to Schema

---
 .../schemas/schema_maya_capture.json          | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index d6b81c8687..a5e1cb45d9 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -224,6 +224,42 @@
                             "key": "twoSidedLighting",
                             "label": "Two Sided Lighting"
                         },
+                        {
+                            "type": "splitter"
+                        },
+                        {
+                            "type": "boolean",
+                            "key": "hwFogEnable",
+                            "label": "Enable Hardware Fog"
+                        },
+                        {
+                            "type": "number",
+                            "key": "hwFogStart",
+                            "label": "Hardware Fog Start"
+                        },
+                        {
+                            "type": "number",
+                            "key": "hwFogEnd",
+                            "label": "Hardware Fog End"
+                        },
+                        {
+                            "type": "number",
+                            "key": "hwFogAlpha",
+                            "label": "Hardware Fog Alpha"
+                        },
+                        {
+                            "type": "number",
+                            "key": "hwFogFalloff",
+                            "label": "Hardware Fog Falloff"
+                        },
+                        {
+                            "type": "number",
+                            "key": "hwFogDensity",
+                            "label": "Hardware Fog Density"
+                        },
+                        {
+                            "type": "splitter"
+                        },
                         {
                             "type": "boolean",
                             "key": "ssaoEnable",

From cb6e093ee33be1aa9af97dca37e07cad7387b4af Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 21 Jun 2022 16:25:11 +0300
Subject: [PATCH 0752/1227] Add SSAO options to schema

---
 .../schemas/schema_maya_capture.json          | 42 ++++++++++++++++++-
 1 file changed, 40 insertions(+), 2 deletions(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index a5e1cb45d9..919c847a9b 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -227,6 +227,34 @@
                         {
                             "type": "splitter"
                         },
+                        {
+                            "type": "boolean",
+                            "key": "ssaoEnable",
+                            "label": "Screen Space Ambient Occlusion"
+                        },
+                        {
+                            "type": "number",
+                            "key": "ssaoAmount",
+                            "label": "SSAO Amount"
+                        },
+                        {
+                            "type": "number",
+                            "key": "ssaoFilterRadius",
+                            "label": "SSAO Filter Radius"
+                        },
+                        {
+                            "type": "number",
+                            "key": "ssaoRadius",
+                            "label": "SSAO Radius"
+                        },
+                        {
+                            "type": "number",
+                            "key": "ssaoSamples",
+                            "label": "SSAO Samples"
+                        },
+                        {
+                            "type": "splitter"
+                        },
                         {
                             "type": "boolean",
                             "key": "hwFogEnable",
@@ -262,8 +290,18 @@
                         },
                         {
                             "type": "boolean",
-                            "key": "ssaoEnable",
-                            "label": "Screen Space Ambient Occlusion"
+                            "key": "motionBlurEnable",
+                            "label": "Enable Motion Blur"
+                        },
+                        {
+                            "type": "number",
+                            "key": "motionBlurShutterOpenFraction",
+                            "label": "Shutter Open Fraction"
+                        },
+                        {
+                            "type": "number",
+                            "key": "hwFogFalloff",
+                            "label": "Hardware Fog Falloff"
                         },
                         {
                             "type": "splitter"

From d08316d19ce5c097e3740cffd1163cd85f51cad5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 15:25:23 +0200
Subject: [PATCH 0753/1227] generate uuids is using query functions and before
 that tries to look for asset entity

---
 openpype/hosts/maya/api/action.py | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/maya/api/action.py b/openpype/hosts/maya/api/action.py
index ca1006b6aa..90605734e7 100644
--- a/openpype/hosts/maya/api/action.py
+++ b/openpype/hosts/maya/api/action.py
@@ -3,6 +3,7 @@ from __future__ import absolute_import
 
 import pyblish.api
 
+from openpype.client import get_asset_by_name
 from openpype.pipeline import legacy_io
 from openpype.api import get_errored_instances_from_context
 
@@ -74,12 +75,21 @@ class GenerateUUIDsOnInvalidAction(pyblish.api.Action):
 
         from . import lib
 
-        asset = instance.data['asset']
-        asset_id = legacy_io.find_one(
-            {"name": asset, "type": "asset"},
-            projection={"_id": True}
-        )['_id']
-        for node, _id in lib.generate_ids(nodes, asset_id=asset_id):
+        # Expecting this is called on validators in which case 'assetEntity'
+        #   should be always available, but kept a way to query it by name.
+        asset_doc = instance.data.get("assetEntity")
+        if not asset_doc:
+            asset_name = instance.data["asset"]
+            project_name = legacy_io.active_project()
+            self.log.info((
+                "Asset is not stored on instance."
+                " Querying by name \"{}\" from project \"{}\""
+            ).format(asset_name, project_name))
+            asset_doc = get_asset_by_name(
+                project_name, asset_name, fields=["_id"]
+            )
+
+        for node, _id in lib.generate_ids(nodes, asset_id=asset_doc["_id"]):
             lib.set_id(node, _id, overwrite=True)
 
 

From c9cfcd2b8025e64d02b5b49c99707ce07eaac9ea Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 15:26:02 +0200
Subject: [PATCH 0754/1227] use query functions in commands and lib

---
 openpype/hosts/maya/api/commands.py |   9 +-
 openpype/hosts/maya/api/lib.py      | 132 +++++++++++++++-------------
 2 files changed, 79 insertions(+), 62 deletions(-)

diff --git a/openpype/hosts/maya/api/commands.py b/openpype/hosts/maya/api/commands.py
index dd616b6dd6..355edf3ae4 100644
--- a/openpype/hosts/maya/api/commands.py
+++ b/openpype/hosts/maya/api/commands.py
@@ -2,6 +2,7 @@
 """OpenPype script commands to be used directly in Maya."""
 from maya import cmds
 
+from openpype.client import get_asset_by_name, get_project
 from openpype.pipeline import legacy_io
 
 
@@ -79,8 +80,9 @@ def reset_frame_range():
     cmds.currentUnit(time=fps)
 
     # Set frame start/end
+    project_name = legacy_io.active_project()
     asset_name = legacy_io.Session["AVALON_ASSET"]
-    asset = legacy_io.find_one({"name": asset_name, "type": "asset"})
+    asset = get_asset_by_name(project_name, asset_name)
 
     frame_start = asset["data"].get("frameStart")
     frame_end = asset["data"].get("frameEnd")
@@ -145,8 +147,9 @@ def reset_resolution():
     resolution_height = 1080
 
     # Get resolution from asset
+    project_name = legacy_io.active_project()
     asset_name = legacy_io.Session["AVALON_ASSET"]
-    asset_doc = legacy_io.find_one({"name": asset_name, "type": "asset"})
+    asset_doc = get_asset_by_name(project_name, asset_name)
     resolution = _resolution_from_document(asset_doc)
     # Try get resolution from project
     if resolution is None:
@@ -155,7 +158,7 @@ def reset_resolution():
             "Asset \"{}\" does not have set resolution."
             " Trying to get resolution from project"
         ).format(asset_name))
-        project_doc = legacy_io.find_one({"type": "project"})
+        project_doc = get_project(project_name)
         resolution = _resolution_from_document(project_doc)
 
     if resolution is None:
diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index bce03a648b..96d98aa6ae 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -12,11 +12,18 @@ import contextlib
 from collections import OrderedDict, defaultdict
 from math import ceil
 from six import string_types
-import bson
 
 from maya import cmds, mel
 import maya.api.OpenMaya as om
 
+from openpype.client import (
+    get_project,
+    get_asset_by_name,
+    get_subsets,
+    get_subset_by_name,
+    get_last_versions,
+    get_representation_by_name
+)
 from openpype import lib
 from openpype.api import get_anatomy_settings
 from openpype.pipeline import (
@@ -1387,15 +1394,11 @@ def generate_ids(nodes, asset_id=None):
 
     if asset_id is None:
         # Get the asset ID from the database for the asset of current context
-        asset_data = legacy_io.find_one(
-            {
-                "type": "asset",
-                "name": legacy_io.Session["AVALON_ASSET"]
-            },
-            projection={"_id": True}
-        )
-        assert asset_data, "No current asset found in Session"
-        asset_id = asset_data['_id']
+        project_name = legacy_io.active_project()
+        asset_name = legacy_io.Session["AVALON_ASSET"]
+        asset_doc = get_asset_by_name(project_name, asset_name, fields=["_id"])
+        assert asset_doc, "No current asset found in Session"
+        asset_id = asset_doc['_id']
 
     node_ids = []
     for node in nodes:
@@ -1548,13 +1551,13 @@ def list_looks(asset_id):
 
     # # get all subsets with look leading in
     # the name associated with the asset
-    subset = legacy_io.find({
-        "parent": bson.ObjectId(asset_id),
-        "type": "subset",
-        "name": {"$regex": "look*"}
-    })
-
-    return list(subset)
+    project_name = legacy_io.active_project()
+    subset_docs = get_subsets(project_name, asset_ids=[asset_id])
+    return [
+        subset_doc
+        for subset_doc in subset_docs
+        if subset_doc["name"].startswith("look")
+    ]
 
 
 def assign_look_by_version(nodes, version_id):
@@ -1570,18 +1573,15 @@ def assign_look_by_version(nodes, version_id):
         None
     """
 
-    # Get representations of shader file and relationships
-    look_representation = legacy_io.find_one({
-        "type": "representation",
-        "parent": version_id,
-        "name": "ma"
-    })
+    project_name = legacy_io.active_project()
 
-    json_representation = legacy_io.find_one({
-        "type": "representation",
-        "parent": version_id,
-        "name": "json"
-    })
+    # Get representations of shader file and relationships
+    look_representation = get_representation_by_name(
+        project_name, "ma", version_id
+    )
+    json_representation = get_representation_by_name(
+        project_name, "json", version_id
+    )
 
     # See if representation is already loaded, if so reuse it.
     host = registered_host()
@@ -1639,42 +1639,54 @@ def assign_look(nodes, subset="lookDefault"):
         parts = pype_id.split(":", 1)
         grouped[parts[0]].append(node)
 
+    project_name = legacy_io.active_project()
+    subset_docs = get_subsets(
+        project_name, subset_names=[subset], asset_ids=grouped.keys()
+    )
+    subset_docs_by_asset_id = {
+        str(subset_doc["parent"]): subset_doc
+        for subset_doc in subset_docs
+    }
+    subset_ids = {
+        subset_doc["_id"]
+        for subset_doc in subset_docs_by_asset_id.values()
+    }
+    last_version_docs = get_last_versions(
+        project_name,
+        subset_ids=subset_ids,
+        fields=["_id", "name", "data.families"]
+    )
+    last_version_docs_by_subset_id = {
+        last_version_doc["parent"]: last_version_doc
+        for last_version_doc in last_version_docs
+    }
+
     for asset_id, asset_nodes in grouped.items():
         # create objectId for database
-        try:
-            asset_id = bson.ObjectId(asset_id)
-        except bson.errors.InvalidId:
-            log.warning("Asset ID is not compatible with bson")
-            continue
-        subset_data = legacy_io.find_one({
-            "type": "subset",
-            "name": subset,
-            "parent": asset_id
-        })
-
-        if not subset_data:
+        subset_doc = subset_docs_by_asset_id.get(asset_id)
+        if not subset_doc:
             log.warning("No subset '{}' found for {}".format(subset, asset_id))
             continue
 
-        # get last version
-        # with backwards compatibility
-        version = legacy_io.find_one(
-            {
-                "parent": subset_data['_id'],
-                "type": "version",
-                "data.families": {"$in": ["look"]}
-            },
-            sort=[("name", -1)],
-            projection={
-                "_id": True,
-                "name": True
-            }
-        )
+        last_version = last_version_docs_by_subset_id.get(subset_doc["_id"])
+        if not last_version:
+            log.warning((
+                "Not found last version for subset '{}' on asset with id {}"
+            ).format(subset, asset_id))
+            continue
 
-        log.debug("Assigning look '{}' <v{:03d}>".format(subset,
-                                                         version["name"]))
+        families = last_version.get("data", {}).get("families") or []
+        if "look" not in families:
+            log.warning((
+                "Last version for subset '{}' on asset with id {}"
+                " does not have look family"
+            ).format(subset, asset_id))
+            continue
 
-        assign_look_by_version(asset_nodes, version['_id'])
+        log.debug("Assigning look '{}' <v{:03d}>".format(
+            subset, last_version["name"]))
+
+        assign_look_by_version(asset_nodes, last_version["_id"])
 
 
 def apply_shaders(relationships, shadernodes, nodes):
@@ -2155,7 +2167,8 @@ def reset_scene_resolution():
         None
     """
 
-    project_doc = legacy_io.find_one({"type": "project"})
+    project_name = legacy_io.active_project()
+    project_doc = get_project(project_name)
     project_data = project_doc["data"]
     asset_data = lib.get_asset()["data"]
 
@@ -2188,7 +2201,8 @@ def set_context_settings():
     """
 
     # Todo (Wijnand): apply renderer and resolution of project
-    project_doc = legacy_io.find_one({"type": "project"})
+    project_name = legacy_io.active_project()
+    project_doc = get_project(project_name)
     project_data = project_doc["data"]
     asset_data = lib.get_asset()["data"]
 

From 8cd440e99f69a3dfe031bf48fbba69d6b10f7727 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 15:29:34 +0200
Subject: [PATCH 0755/1227] use query functions in setdress

---
 openpype/hosts/maya/api/setdress.py | 66 ++++++++++++++++-------------
 1 file changed, 36 insertions(+), 30 deletions(-)

diff --git a/openpype/hosts/maya/api/setdress.py b/openpype/hosts/maya/api/setdress.py
index f8d3ed79b8..bea8f154b1 100644
--- a/openpype/hosts/maya/api/setdress.py
+++ b/openpype/hosts/maya/api/setdress.py
@@ -6,10 +6,16 @@ import contextlib
 import copy
 
 import six
-from bson.objectid import ObjectId
 
 from maya import cmds
 
+from openpype.client import (
+    get_version_by_name,
+    get_last_version_by_subset_id,
+    get_representation_by_id,
+    get_representation_by_name,
+    get_representation_parents,
+)
 from openpype.pipeline import (
     schema,
     legacy_io,
@@ -283,36 +289,35 @@ def update_package_version(container, version):
     """
 
     # Versioning (from `core.maya.pipeline`)
-    current_representation = legacy_io.find_one({
-        "_id": ObjectId(container["representation"])
-    })
+    project_name = legacy_io.active_project()
+    current_representation = get_representation_by_id(
+        project_name, container["representation"]
+    )
 
     assert current_representation is not None, "This is a bug"
 
-    version_, subset, asset, project = legacy_io.parenthood(
-        current_representation
+    repre_parents = get_representation_parents(
+        project_name, current_representation
     )
+    version_doc = subset_doc = asset_doc = project_doc = None
+    if repre_parents:
+        version_doc, subset_doc, asset_doc, project_doc = repre_parents
 
     if version == -1:
-        new_version = legacy_io.find_one({
-            "type": "version",
-            "parent": subset["_id"]
-        }, sort=[("name", -1)])
+        new_version = get_last_version_by_subset_id(
+            project_name, subset_doc["_id"]
+        )
     else:
-        new_version = legacy_io.find_one({
-            "type": "version",
-            "parent": subset["_id"],
-            "name": version,
-        })
+        new_version = get_version_by_name(
+            project_name, version, subset_doc["_id"]
+        )
 
     assert new_version is not None, "This is a bug"
 
     # Get the new representation (new file)
-    new_representation = legacy_io.find_one({
-        "type": "representation",
-        "parent": new_version["_id"],
-        "name": current_representation["name"]
-    })
+    new_representation = get_representation_by_name(
+        project_name, current_representation["name"], new_version["_id"]
+    )
 
     update_package(container, new_representation)
 
@@ -330,10 +335,10 @@ def update_package(set_container, representation):
     """
 
     # Load the original package data
-    current_representation = legacy_io.find_one({
-        "_id": ObjectId(set_container['representation']),
-        "type": "representation"
-    })
+    project_name = legacy_io.active_project()
+    current_representation = get_representation_by_id(
+        project_name, set_container["representation"]
+    )
 
     current_file = get_representation_path(current_representation)
     assert current_file.endswith(".json")
@@ -380,6 +385,7 @@ def update_scene(set_container, containers, current_data, new_data, new_file):
     from openpype.hosts.maya.lib import DEFAULT_MATRIX, get_container_transforms
 
     set_namespace = set_container['namespace']
+    project_name = legacy_io.active_project()
 
     # Update the setdress hierarchy alembic
     set_root = get_container_transforms(set_container, root=True)
@@ -481,12 +487,12 @@ def update_scene(set_container, containers, current_data, new_data, new_file):
                 # Check whether the conversion can be done by the Loader.
                 # They *must* use the same asset, subset and Loader for
                 # `update_container` to make sense.
-                old = legacy_io.find_one({
-                    "_id": ObjectId(representation_current)
-                })
-                new = legacy_io.find_one({
-                    "_id": ObjectId(representation_new)
-                })
+                old = get_representation_by_id(
+                    project_name, representation_current
+                )
+                new = get_representation_by_id(
+                    project_name, representation_new
+                )
                 is_valid = compare_representations(old=old, new=new)
                 if not is_valid:
                     log.error("Skipping: %s. See log for details.",

From d4d2f8fe3e9a23ed39cbaa27802f8cb48d09c65f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 15:30:30 +0200
Subject: [PATCH 0756/1227] added comment to look queries

---
 openpype/hosts/maya/api/lib.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 96d98aa6ae..6863edf3e0 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -1551,6 +1551,8 @@ def list_looks(asset_id):
 
     # # get all subsets with look leading in
     # the name associated with the asset
+    # TODO this should probably look for family 'look' instead of checking
+    #   subset name that can not start with family
     project_name = legacy_io.active_project()
     subset_docs = get_subsets(project_name, asset_ids=[asset_id])
     return [

From a78381265e31f5bb27ef10006b1e4c0c7f869a7e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 15:31:14 +0200
Subject: [PATCH 0757/1227] use query functions in maya plugins

---
 .../plugins/inventory/import_modelrender.py   | 53 ++++++++++++-------
 .../hosts/maya/plugins/load/load_audio.py     | 18 +++++--
 .../maya/plugins/load/load_image_plane.py     | 18 +++++--
 openpype/hosts/maya/plugins/load/load_look.py | 10 ++--
 .../hosts/maya/plugins/load/load_vrayproxy.py | 11 ++--
 .../maya/plugins/publish/collect_review.py    | 15 ++++--
 .../publish/validate_node_ids_in_database.py  |  9 +++-
 .../publish/validate_node_ids_related.py      | 11 +---
 .../publish/validate_renderlayer_aovs.py      | 23 ++++----
 9 files changed, 101 insertions(+), 67 deletions(-)

diff --git a/openpype/hosts/maya/plugins/inventory/import_modelrender.py b/openpype/hosts/maya/plugins/inventory/import_modelrender.py
index a5367f16e5..8a7390bc8d 100644
--- a/openpype/hosts/maya/plugins/inventory/import_modelrender.py
+++ b/openpype/hosts/maya/plugins/inventory/import_modelrender.py
@@ -1,6 +1,10 @@
+import re
 import json
-from bson.objectid import ObjectId
 
+from openpype.client import (
+    get_representation_by_id,
+    get_representations
+)
 from openpype.pipeline import (
     InventoryAction,
     get_representation_context,
@@ -31,6 +35,7 @@ class ImportModelRender(InventoryAction):
     def process(self, containers):
         from maya import cmds
 
+        project_name = legacy_io.active_project()
         for container in containers:
             con_name = container["objectName"]
             nodes = []
@@ -40,9 +45,9 @@ class ImportModelRender(InventoryAction):
                 else:
                     nodes.append(n)
 
-            repr_doc = legacy_io.find_one({
-                "_id": ObjectId(container["representation"]),
-            })
+            repr_doc = get_representation_by_id(
+                project_name, container["representation"], fields=["parent"]
+            )
             version_id = repr_doc["parent"]
 
             print("Importing render sets for model %r" % con_name)
@@ -63,26 +68,38 @@ class ImportModelRender(InventoryAction):
 
         from maya import cmds
 
+        project_name = legacy_io.active_project()
+        repre_docs = get_representations(
+            project_name, version_ids=[version_id], fields=["_id", "name"]
+        )
         # Get representations of shader file and relationships
-        look_repr = legacy_io.find_one({
-            "type": "representation",
-            "parent": version_id,
-            "name": {"$regex": self.scene_type_regex},
-        })
-        if not look_repr:
+        json_repre = None
+        look_repres = []
+        scene_type_regex = re.compile(self.scene_type_regex)
+        for repre_doc in repre_docs:
+            repre_name = repre_doc["name"]
+            if repre_name == self.look_data_type:
+                json_repre = repre_doc
+                continue
+
+            if scene_type_regex.fullmatch(repre_name):
+                look_repres.append(repre_doc)
+
+        # QUESTION should we care if there is more then one look
+        #   representation? (since it's based on regex match)
+        look_repre = None
+        if look_repres:
+            look_repre = look_repres[0]
+
+        # QUESTION shouldn't be json representation validated too?
+        if not look_repre:
             print("No model render sets for this model version..")
             return
 
-        json_repr = legacy_io.find_one({
-            "type": "representation",
-            "parent": version_id,
-            "name": self.look_data_type,
-        })
-
-        context = get_representation_context(look_repr["_id"])
+        context = get_representation_context(look_repre["_id"])
         maya_file = self.filepath_from_context(context)
 
-        context = get_representation_context(json_repr["_id"])
+        context = get_representation_context(json_repre["_id"])
         json_file = self.filepath_from_context(context)
 
         # Import the look file
diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index ce814e1299..6f60cb5726 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -1,5 +1,10 @@
 from maya import cmds, mel
 
+from openpype.client import (
+    get_asset_by_id,
+    get_subset_by_id,
+    get_version_by_id,
+)
 from openpype.pipeline import (
     legacy_io,
     load,
@@ -65,9 +70,16 @@ class AudioLoader(load.LoaderPlugin):
         )
 
         # Set frame range.
-        version = legacy_io.find_one({"_id": representation["parent"]})
-        subset = legacy_io.find_one({"_id": version["parent"]})
-        asset = legacy_io.find_one({"_id": subset["parent"]})
+        project_name = legacy_io.active_project()
+        version = get_version_by_id(
+            project_name, representation["parent"], fields=["parent"]
+        )
+        subset = get_subset_by_id(
+            project_name, version["parent"], fields=["parent"]
+        )
+        asset = get_asset_by_id(
+            project_name, subset["parent"], fields=["parent"]
+        )
         audio_node.sourceStart.set(1 - asset["data"]["frameStart"])
         audio_node.sourceEnd.set(asset["data"]["frameEnd"])
 
diff --git a/openpype/hosts/maya/plugins/load/load_image_plane.py b/openpype/hosts/maya/plugins/load/load_image_plane.py
index 5e44917f28..b267921bdc 100644
--- a/openpype/hosts/maya/plugins/load/load_image_plane.py
+++ b/openpype/hosts/maya/plugins/load/load_image_plane.py
@@ -1,5 +1,10 @@
 from Qt import QtWidgets, QtCore
 
+from openpype.client import (
+    get_asset_by_id,
+    get_subset_by_id,
+    get_version_by_id,
+)
 from openpype.pipeline import (
     legacy_io,
     load,
@@ -216,9 +221,16 @@ class ImagePlaneLoader(load.LoaderPlugin):
         )
 
         # Set frame range.
-        version = legacy_io.find_one({"_id": representation["parent"]})
-        subset = legacy_io.find_one({"_id": version["parent"]})
-        asset = legacy_io.find_one({"_id": subset["parent"]})
+        project_name = legacy_io.active_project()
+        version = get_version_by_id(
+            project_name, representation["parent"], fields=["parent"]
+        )
+        subset = get_subset_by_id(
+            project_name, version["parent"], fields=["parent"]
+        )
+        asset = get_asset_by_id(
+            project_name, subset["parent"], fields=["parent"]
+        )
         start_frame = asset["data"]["frameStart"]
         end_frame = asset["data"]["frameEnd"]
         image_plane_shape.frameOffset.set(1 - start_frame)
diff --git a/openpype/hosts/maya/plugins/load/load_look.py b/openpype/hosts/maya/plugins/load/load_look.py
index ae3a683241..7392adc4dd 100644
--- a/openpype/hosts/maya/plugins/load/load_look.py
+++ b/openpype/hosts/maya/plugins/load/load_look.py
@@ -5,6 +5,7 @@ from collections import defaultdict
 
 from Qt import QtWidgets
 
+from openpype.client import get_representation_by_name
 from openpype.pipeline import (
     legacy_io,
     get_representation_path,
@@ -75,11 +76,10 @@ class LookLoader(openpype.hosts.maya.api.plugin.ReferenceLoader):
         shader_nodes = cmds.ls(members, type='shadingEngine')
         nodes = set(self._get_nodes_with_shader(shader_nodes))
 
-        json_representation = legacy_io.find_one({
-            "type": "representation",
-            "parent": representation['parent'],
-            "name": "json"
-        })
+        project_name = legacy_io.active_project()
+        json_representation = get_representation_by_name(
+            project_name, "json", representation["parent"]
+        )
 
         # Load relationships
         shader_relation = get_representation_path(json_representation)
diff --git a/openpype/hosts/maya/plugins/load/load_vrayproxy.py b/openpype/hosts/maya/plugins/load/load_vrayproxy.py
index 22d56139f6..e3d6166d3a 100644
--- a/openpype/hosts/maya/plugins/load/load_vrayproxy.py
+++ b/openpype/hosts/maya/plugins/load/load_vrayproxy.py
@@ -7,10 +7,9 @@ loader will use them instead of native vray vrmesh format.
 """
 import os
 
-from bson.objectid import ObjectId
-
 import maya.cmds as cmds
 
+from openpype.client import get_representation_by_name
 from openpype.api import get_project_settings
 from openpype.pipeline import (
     legacy_io,
@@ -185,12 +184,8 @@ class VRayProxyLoader(load.LoaderPlugin):
         """
         self.log.debug(
             "Looking for abc in published representations of this version.")
-        abc_rep = legacy_io.find_one({
-            "type": "representation",
-            "parent": ObjectId(version_id),
-            "name": "abc"
-        })
-
+        project_name = legacy_io.active_project()
+        abc_rep = get_representation_by_name(project_name, "abc", version_id)
         if abc_rep:
             self.log.debug("Found, we'll link alembic to vray proxy.")
             file_name = get_representation_path(abc_rep)
diff --git a/openpype/hosts/maya/plugins/publish/collect_review.py b/openpype/hosts/maya/plugins/publish/collect_review.py
index e9e0d74c03..15b89ad53c 100644
--- a/openpype/hosts/maya/plugins/publish/collect_review.py
+++ b/openpype/hosts/maya/plugins/publish/collect_review.py
@@ -3,6 +3,7 @@ import pymel.core as pm
 
 import pyblish.api
 
+from openpype.client import get_subset_by_name
 from openpype.pipeline import legacy_io
 
 
@@ -78,11 +79,15 @@ class CollectReview(pyblish.api.InstancePlugin):
                 self.log.debug('isntance data {}'.format(instance.data))
         else:
             legacy_subset_name = task + 'Review'
-            asset_doc_id = instance.context.data['assetEntity']["_id"]
-            subsets = legacy_io.find({"type": "subset",
-                                      "name": legacy_subset_name,
-                                      "parent": asset_doc_id}).distinct("_id")
-            if len(list(subsets)) > 0:
+            asset_doc = instance.context.data['assetEntity']
+            project_name = legacy_io.active_project()
+            subset_doc = get_subset_by_name(
+                project_name,
+                legacy_subset_name,
+                asset_doc["_id"],
+                fields=["_id"]
+            )
+            if subset_doc:
                 self.log.debug("Existing subsets found, keep legacy name.")
                 instance.data['subset'] = legacy_subset_name
 
diff --git a/openpype/hosts/maya/plugins/publish/validate_node_ids_in_database.py b/openpype/hosts/maya/plugins/publish/validate_node_ids_in_database.py
index 068d6b38a1..632b531668 100644
--- a/openpype/hosts/maya/plugins/publish/validate_node_ids_in_database.py
+++ b/openpype/hosts/maya/plugins/publish/validate_node_ids_in_database.py
@@ -1,6 +1,7 @@
 import pyblish.api
 
 import openpype.api
+from openpype.client import get_assets
 from openpype.pipeline import legacy_io
 import openpype.hosts.maya.api.action
 from openpype.hosts.maya.api import lib
@@ -42,8 +43,12 @@ class ValidateNodeIdsInDatabase(pyblish.api.InstancePlugin):
                                                       nodes=instance[:])
 
         # check ids against database ids
-        db_asset_ids = legacy_io.find({"type": "asset"}).distinct("_id")
-        db_asset_ids = set(str(i) for i in db_asset_ids)
+        project_name = legacy_io.active_project()
+        asset_docs = get_assets(project_name, fields=["_id"])
+        db_asset_ids = {
+            str(asset_doc["_id"])
+            for asset_doc in asset_docs
+        }
 
         # Get all asset IDs
         for node in id_required_nodes:
diff --git a/openpype/hosts/maya/plugins/publish/validate_node_ids_related.py b/openpype/hosts/maya/plugins/publish/validate_node_ids_related.py
index 38407e4176..c8bac6e569 100644
--- a/openpype/hosts/maya/plugins/publish/validate_node_ids_related.py
+++ b/openpype/hosts/maya/plugins/publish/validate_node_ids_related.py
@@ -1,7 +1,6 @@
 import pyblish.api
 import openpype.api
 
-from openpype.pipeline import legacy_io
 import openpype.hosts.maya.api.action
 from openpype.hosts.maya.api import lib
 
@@ -36,15 +35,7 @@ class ValidateNodeIDsRelated(pyblish.api.InstancePlugin):
         """Return the member nodes that are invalid"""
         invalid = list()
 
-        asset = instance.data['asset']
-        asset_data = legacy_io.find_one(
-            {
-                "name": asset,
-                "type": "asset"
-            },
-            projection={"_id": True}
-        )
-        asset_id = str(asset_data['_id'])
+        asset_id = str(instance.data['assetEntity']["_id"])
 
         # We do want to check the referenced nodes as we it might be
         # part of the end product
diff --git a/openpype/hosts/maya/plugins/publish/validate_renderlayer_aovs.py b/openpype/hosts/maya/plugins/publish/validate_renderlayer_aovs.py
index e65150eb0f..6b6fb03eec 100644
--- a/openpype/hosts/maya/plugins/publish/validate_renderlayer_aovs.py
+++ b/openpype/hosts/maya/plugins/publish/validate_renderlayer_aovs.py
@@ -1,8 +1,8 @@
 import pyblish.api
 
+from openpype.client import get_subset_by_name
 import openpype.hosts.maya.api.action
 from openpype.pipeline import legacy_io
-import openpype.api
 
 
 class ValidateRenderLayerAOVs(pyblish.api.InstancePlugin):
@@ -33,26 +33,23 @@ class ValidateRenderLayerAOVs(pyblish.api.InstancePlugin):
             raise RuntimeError("Found unregistered subsets: {}".format(invalid))
 
     def get_invalid(self, instance):
-
         invalid = []
 
-        asset_name = instance.data["asset"]
+        project_name = legacy_io.active_project()
+        asset_doc = instance.data["assetEntity"]
         render_passses = instance.data.get("renderPasses", [])
         for render_pass in render_passses:
-            is_valid = self.validate_subset_registered(asset_name, render_pass)
+            is_valid = self.validate_subset_registered(
+                project_name, asset_doc, render_pass
+            )
             if not is_valid:
                 invalid.append(render_pass)
 
         return invalid
 
-    def validate_subset_registered(self, asset_name, subset_name):
+    def validate_subset_registered(self, project_name, asset_doc, subset_name):
         """Check if subset is registered in the database under the asset"""
 
-        asset = legacy_io.find_one({"type": "asset", "name": asset_name})
-        is_valid = legacy_io.find_one({
-            "type": "subset",
-            "name": subset_name,
-            "parent": asset["_id"]
-        })
-
-        return is_valid
+        return get_subset_by_name(
+            project_name, subset_name, asset_doc["_id"], fields=["_id"]
+        )

From 240c7113601141dffe08233e3be5a9b9f5944447 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 15:53:32 +0200
Subject: [PATCH 0758/1227] remove unused import

---
 openpype/hosts/maya/api/lib.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 6863edf3e0..edca1f45b8 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -20,7 +20,6 @@ from openpype.client import (
     get_project,
     get_asset_by_name,
     get_subsets,
-    get_subset_by_name,
     get_last_versions,
     get_representation_by_name
 )

From 697916c3cdba015b68f0376902422606ac27f9fe Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 21 Jun 2022 17:03:10 +0300
Subject: [PATCH 0759/1227] Append enum for fog falloff.

---
 .../schemas/schema_maya_capture.json          | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index 919c847a9b..caf001f7e1 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -260,6 +260,16 @@
                             "key": "hwFogEnable",
                             "label": "Enable Hardware Fog"
                         },
+                        {
+                            "type": "enum",
+                            "key": "hwFogFalloff",
+                            "label": "Hardware Fog Falloff",
+                            "enum_items": [
+                                { "0": "Linear"},
+                                { "1": "Exponential"},
+                                { "2": "Exponential Squared"}
+                            ]
+                        },
                         {
                             "type": "number",
                             "key": "hwFogStart",
@@ -275,11 +285,6 @@
                             "key": "hwFogAlpha",
                             "label": "Hardware Fog Alpha"
                         },
-                        {
-                            "type": "number",
-                            "key": "hwFogFalloff",
-                            "label": "Hardware Fog Falloff"
-                        },
                         {
                             "type": "number",
                             "key": "hwFogDensity",
@@ -298,11 +303,6 @@
                             "key": "motionBlurShutterOpenFraction",
                             "label": "Shutter Open Fraction"
                         },
-                        {
-                            "type": "number",
-                            "key": "hwFogFalloff",
-                            "label": "Hardware Fog Falloff"
-                        },
                         {
                             "type": "splitter"
                         },

From ed0ba7e3ab306f1674def5f7cc69666cb96e8dc6 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 21 Jun 2022 17:39:46 +0300
Subject: [PATCH 0760/1227] Append Antialiasing and MotionBlur Sampling

---
 .../schemas/schema_maya_capture.json             | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index caf001f7e1..fa5be19cda 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -201,6 +201,14 @@
                             "label": "Texture Clamp Resolution",
                             "decimal": 0
                         },
+                        {
+                            "type": "splitter"
+                        },
+                        {
+                            "type": "boolean",
+                            "key": "lineAAEnable",
+                            "label": "Smooth Wireframe"
+                        },
                         {
                             "type": "number",
                             "key": "multiSample",
@@ -209,6 +217,9 @@
                             "minimum": 0,
                             "maximum": 32
                         },
+                        {
+                            "type": "splitter"
+                        },
                         {
                             "type": "boolean",
                             "key": "shadows",
@@ -303,6 +314,11 @@
                             "key": "motionBlurShutterOpenFraction",
                             "label": "Shutter Open Fraction"
                         },
+                        {
+                            "type": "number",
+                            "key": "motionBlurSampleCount",
+                            "label": "Sample Count"
+                        },
                         {
                             "type": "splitter"
                         },

From de6bd72c2ed1ef40b3cecfa4a7caed9cf93937ea Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 21 Jun 2022 18:01:49 +0300
Subject: [PATCH 0761/1227] Appen defaults.

---
 .../settings/defaults/project_settings/maya.json   | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 69fbf5bfdf..6780921001 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -491,11 +491,25 @@
                     "override_viewport_options": true,
                     "displayLights": "default",
                     "textureMaxResolution": 1024,
+                    "lineAAEnable": true,
                     "multiSample": 4,
                     "shadows": true,
                     "textures": true,
                     "twoSidedLighting": true,
                     "ssaoEnable": true,
+                    "ssaoAmount": 0,
+                    "ssaoFilterRadius": 0,
+                    "ssaoRadius": 0,
+                    "ssaoSamples": 0,
+                    "hwFogEnable": true,
+                    "hwFogFalloff": "0",
+                    "hwFogStart": 0,
+                    "hwFogEnd": 0,
+                    "hwFogAlpha": 0,
+                    "hwFogDensity": 0,
+                    "motionBlurEnable": true,
+                    "motionBlurShutterOpenFraction": 0,
+                    "motionBlurSampleCount": 0,
                     "cameras": false,
                     "clipGhosts": false,
                     "controlVertices": false,

From 269c752bfc9ff109b8a75e57b3f78349d7bf1b75 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 21 Jun 2022 18:01:49 +0300
Subject: [PATCH 0762/1227] Append settings defaults.

---
 .../settings/defaults/project_settings/maya.json   | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 69fbf5bfdf..6780921001 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -491,11 +491,25 @@
                     "override_viewport_options": true,
                     "displayLights": "default",
                     "textureMaxResolution": 1024,
+                    "lineAAEnable": true,
                     "multiSample": 4,
                     "shadows": true,
                     "textures": true,
                     "twoSidedLighting": true,
                     "ssaoEnable": true,
+                    "ssaoAmount": 0,
+                    "ssaoFilterRadius": 0,
+                    "ssaoRadius": 0,
+                    "ssaoSamples": 0,
+                    "hwFogEnable": true,
+                    "hwFogFalloff": "0",
+                    "hwFogStart": 0,
+                    "hwFogEnd": 0,
+                    "hwFogAlpha": 0,
+                    "hwFogDensity": 0,
+                    "motionBlurEnable": true,
+                    "motionBlurShutterOpenFraction": 0,
+                    "motionBlurSampleCount": 0,
                     "cameras": false,
                     "clipGhosts": false,
                     "controlVertices": false,

From ecda9a6099f6efe52d8ef3121d894c76277098a4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 21 Jun 2022 18:18:36 +0200
Subject: [PATCH 0763/1227] remove unused functions

---
 openpype/hosts/nuke/api/__init__.py |   6 --
 openpype/hosts/nuke/api/command.py  | 114 ----------------------------
 openpype/hosts/nuke/api/lib.py      |  23 ------
 3 files changed, 143 deletions(-)

diff --git a/openpype/hosts/nuke/api/__init__.py b/openpype/hosts/nuke/api/__init__.py
index b571c4098c..9e3ef1a397 100644
--- a/openpype/hosts/nuke/api/__init__.py
+++ b/openpype/hosts/nuke/api/__init__.py
@@ -8,9 +8,6 @@ from .workio import (
 )
 
 from .command import (
-    reset_frame_range,
-    get_handles,
-    reset_resolution,
     viewer_update_and_undo_stop
 )
 
@@ -42,9 +39,6 @@ __all__ = (
     "current_file",
     "work_root",
 
-    "reset_frame_range",
-    "get_handles",
-    "reset_resolution",
     "viewer_update_and_undo_stop",
 
     "OpenPypeCreator",
diff --git a/openpype/hosts/nuke/api/command.py b/openpype/hosts/nuke/api/command.py
index c756c48a12..2f772469d8 100644
--- a/openpype/hosts/nuke/api/command.py
+++ b/openpype/hosts/nuke/api/command.py
@@ -1,124 +1,10 @@
 import logging
 import contextlib
 import nuke
-from bson.objectid import ObjectId
-
-from openpype.pipeline import legacy_io
 
 log = logging.getLogger(__name__)
 
 
-def reset_frame_range():
-    """ Set frame range to current asset
-        Also it will set a Viewer range with
-        displayed handles
-    """
-
-    fps = float(legacy_io.Session.get("AVALON_FPS", 25))
-
-    nuke.root()["fps"].setValue(fps)
-    name = legacy_io.Session["AVALON_ASSET"]
-    asset = legacy_io.find_one({"name": name, "type": "asset"})
-    asset_data = asset["data"]
-
-    handles = get_handles(asset)
-
-    frame_start = int(asset_data.get(
-        "frameStart",
-        asset_data.get("edit_in")))
-
-    frame_end = int(asset_data.get(
-        "frameEnd",
-        asset_data.get("edit_out")))
-
-    if not all([frame_start, frame_end]):
-        missing = ", ".join(["frame_start", "frame_end"])
-        msg = "'{}' are not set for asset '{}'!".format(missing, name)
-        log.warning(msg)
-        nuke.message(msg)
-        return
-
-    frame_start -= handles
-    frame_end += handles
-
-    nuke.root()["first_frame"].setValue(frame_start)
-    nuke.root()["last_frame"].setValue(frame_end)
-
-    # setting active viewers
-    vv = nuke.activeViewer().node()
-    vv["frame_range_lock"].setValue(True)
-    vv["frame_range"].setValue("{0}-{1}".format(
-        int(asset_data["frameStart"]),
-        int(asset_data["frameEnd"]))
-    )
-
-
-def get_handles(asset):
-    """ Gets handles data
-
-    Arguments:
-        asset (dict): avalon asset entity
-
-    Returns:
-        handles (int)
-    """
-    data = asset["data"]
-    if "handles" in data and data["handles"] is not None:
-        return int(data["handles"])
-
-    parent_asset = None
-    if "visualParent" in data:
-        vp = data["visualParent"]
-        if vp is not None:
-            parent_asset = legacy_io.find_one({"_id": ObjectId(vp)})
-
-    if parent_asset is None:
-        parent_asset = legacy_io.find_one({"_id": ObjectId(asset["parent"])})
-
-    if parent_asset is not None:
-        return get_handles(parent_asset)
-    else:
-        return 0
-
-
-def reset_resolution():
-    """Set resolution to project resolution."""
-    project = legacy_io.find_one({"type": "project"})
-    p_data = project["data"]
-
-    width = p_data.get("resolution_width",
-                       p_data.get("resolutionWidth"))
-    height = p_data.get("resolution_height",
-                        p_data.get("resolutionHeight"))
-
-    if not all([width, height]):
-        missing = ", ".join(["width", "height"])
-        msg = "No resolution information `{0}` found for '{1}'.".format(
-            missing,
-            project["name"])
-        log.warning(msg)
-        nuke.message(msg)
-        return
-
-    current_width = nuke.root()["format"].value().width()
-    current_height = nuke.root()["format"].value().height()
-
-    if width != current_width or height != current_height:
-
-        fmt = None
-        for f in nuke.formats():
-            if f.width() == width and f.height() == height:
-                fmt = f.name()
-
-        if not fmt:
-            nuke.addFormat(
-                "{0} {1} {2}".format(int(width), int(height), project["name"])
-            )
-            fmt = project["name"]
-
-        nuke.root()["format"].setValue(fmt)
-
-
 @contextlib.contextmanager
 def viewer_update_and_undo_stop():
     """Lock viewer from updating and stop recording undo steps"""
diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 505eb19419..7e44aaa7c5 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -2151,29 +2151,6 @@ class WorkfileSettings(object):
         set_context_favorites(favorite_items)
 
 
-def get_hierarchical_attr(entity, attr, default=None):
-    attr_parts = attr.split('.')
-    value = entity
-    for part in attr_parts:
-        value = value.get(part)
-        if not value:
-            break
-
-    if value or entity["type"].lower() == "project":
-        return value
-
-    parent_id = entity["parent"]
-    if (
-        entity["type"].lower() == "asset"
-        and entity.get("data", {}).get("visualParent")
-    ):
-        parent_id = entity["data"]["visualParent"]
-
-    parent = legacy_io.find_one({"_id": parent_id})
-
-    return get_hierarchical_attr(parent, attr)
-
-
 def get_write_node_template_attr(node):
     ''' Gets all defined data from presets
 

From 45d228ce9fdc0791c79b079782613136f2ff7bc0 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Wed, 22 Jun 2022 01:07:45 +0200
Subject: [PATCH 0764/1227] :bug: fix handling of extra geometry

---
 .../plugins/publish/extract_camera_alembic.py |  6 ++---
 .../publish/extract_camera_mayaScene.py       | 24 +++++++++++--------
 .../publish/validate_camera_contents.py       | 13 +---------
 3 files changed, 18 insertions(+), 25 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py b/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
index 4110ad474d..893aa63b01 100644
--- a/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
+++ b/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
@@ -61,10 +61,10 @@ class ExtractCameraAlembic(openpype.api.Extractor):
 
             if bake_to_worldspace:
                 job_str += ' -worldSpace'
-                for member in member_shapes:
-                    self.log.info(f"processing {member}")
+                for member in members:
                     transform = cmds.listRelatives(
-                        member, parent=True, fullPath=True)[0]
+                        member, parent=True, fullPath=True)
+                    transform = transform[0] if transform else member
                     job_str += ' -root {0}'.format(transform)
 
             job_str += ' -file "{0}"'.format(path)
diff --git a/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py b/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
index 1cb30e65ea..569efbe335 100644
--- a/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
+++ b/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
@@ -172,18 +172,22 @@ class ExtractCameraMayaScene(openpype.api.Extractor):
                                                       dag=True,
                                                       shapes=True,
                                                       long=True)
+                    attrs = {"backgroundColorR": 0.0,
+                             "backgroundColorG": 0.0,
+                             "backgroundColorB": 0.0,
+                             "overscan": 1.0}
+
                     # Fix PLN-178: Don't allow background color to be non-black
-                    for cam in cmds.ls(
+                    for cam, (attr, value) in itertools.product(cmds.ls(
                             baked_camera_shapes, type="camera", dag=True,
-                            shapes=True, long=True):
-                        attrs = {"backgroundColorR": 0.0,
-                                 "backgroundColorG": 0.0,
-                                 "backgroundColorB": 0.0,
-                                 "overscan": 1.0}
-                        for attr, value in attrs.items():
-                            plug = "{0}.{1}".format(cam, attr)
-                            unlock(plug)
-                            cmds.setAttr(plug, value)
+                            shapes=True, long=True), attrs.items()):
+                        # the above call still pull in shapes that are not
+                        # cameras, so we filter them out here
+                        if cmds.nodeType(cam) != "camera":
+                            continue
+                        plug = "{0}.{1}".format(cam, attr)
+                        unlock(plug)
+                        cmds.setAttr(plug, value)
 
                     self.log.info("Performing extraction..")
                     cmds.select(cmds.ls(members, dag=True,
diff --git a/openpype/hosts/maya/plugins/publish/validate_camera_contents.py b/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
index eb93245f93..e209487ae4 100644
--- a/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
+++ b/openpype/hosts/maya/plugins/publish/validate_camera_contents.py
@@ -52,20 +52,9 @@ class ValidateCameraContents(pyblish.api.InstancePlugin):
 
         if not cls.validate_shapes:
             cls.log.info("not validating shapes in the content")
-
-            for member in members:
-                parents = cmds.ls(member, long=True)[0].split("|")[1:-1]
-                cls.log.info(parents)
-                parents_long_named = [
-                    "|".join(parents[:i]) for i in range(1, 1 + len(parents))
-                ]
-                cls.log.info(parents_long_named)
-                if cameras[0] in parents_long_named:
-                    cls.log.error(
-                        "{} is parented under camera {}".format(member, cameras[0]))
-                    invalid.extend(member)
             return invalid
 
+
         # non-camera shapes
         valid_shapes = cmds.ls(shapes, type=('camera', 'locator'), long=True)
         shapes = set(shapes) - set(valid_shapes)

From d2bfcb80cb1597c35f6bbce1e7a4c51a909533b4 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Wed, 22 Jun 2022 03:53:06 +0000
Subject: [PATCH 0765/1227] [Automated] Bump version

---
 CHANGELOG.md        | 46 ++++++++++++++++++++++++++++++++++++---------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 39 insertions(+), 11 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 48d0d8181e..f0a9a9651d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,42 @@
 # Changelog
 
+## [3.11.2-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.11.1...HEAD)
+
+### 📖 Documentation
+
+- General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
+- Feature/multiverse [\#3350](https://github.com/pypeclub/OpenPype/pull/3350)
+
+**🚀 Enhancements**
+
+- Hosts: More options for in-host callbacks [\#3357](https://github.com/pypeclub/OpenPype/pull/3357)
+- TVPaint: Extractor use mark in/out range to render [\#3308](https://github.com/pypeclub/OpenPype/pull/3308)
+- Maya: Allow more data to be published along camera 🎥  [\#3304](https://github.com/pypeclub/OpenPype/pull/3304)
+
+**🐛 Bug fixes**
+
+- TVPaint: Make sure exit code is set to not None [\#3382](https://github.com/pypeclub/OpenPype/pull/3382)
+- Maya: vray device aspect ratio fix [\#3381](https://github.com/pypeclub/OpenPype/pull/3381)
+- Harmony: added unc path to zifile command in Harmony [\#3372](https://github.com/pypeclub/OpenPype/pull/3372)
+
+**🔀 Refactored code**
+
+- Harmony: Use client query functions [\#3378](https://github.com/pypeclub/OpenPype/pull/3378)
+- Photoshop: Use client query functions [\#3375](https://github.com/pypeclub/OpenPype/pull/3375)
+- AfterEffects: Use client query functions [\#3374](https://github.com/pypeclub/OpenPype/pull/3374)
+- TVPaint: Use client query functions [\#3340](https://github.com/pypeclub/OpenPype/pull/3340)
+- Ftrack: Use client query functions [\#3339](https://github.com/pypeclub/OpenPype/pull/3339)
+- Standalone Publisher: Use client query functions [\#3330](https://github.com/pypeclub/OpenPype/pull/3330)
+
+**Merged pull requests:**
+
+- Maya - added support for single frame playblast review [\#3369](https://github.com/pypeclub/OpenPype/pull/3369)
+
 ## [3.11.1](https://github.com/pypeclub/OpenPype/tree/3.11.1) (2022-06-20)
 
-[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.11.0...3.11.1)
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.11.1-nightly.1...3.11.1)
 
 **🆕 New features**
 
@@ -26,9 +60,9 @@
 - AE- fix validate\_scene\_settings and renderLocal [\#3358](https://github.com/pypeclub/OpenPype/pull/3358)
 - deadline: fixing misidentification of revieables [\#3356](https://github.com/pypeclub/OpenPype/pull/3356)
 - General: Create only one thumbnail per instance [\#3351](https://github.com/pypeclub/OpenPype/pull/3351)
+- nuke: adding extract thumbnail settings 3.10 [\#3347](https://github.com/pypeclub/OpenPype/pull/3347)
 - General: Fix last version function [\#3345](https://github.com/pypeclub/OpenPype/pull/3345)
 - Deadline: added OPENPYPE\_MONGO to filter [\#3336](https://github.com/pypeclub/OpenPype/pull/3336)
-- Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
 
 **🔀 Refactored code**
 
@@ -61,10 +95,10 @@
 
 **🐛 Bug fixes**
 
-- General: Handle empty source key on instance [\#3342](https://github.com/pypeclub/OpenPype/pull/3342)
 - Houdini: Fix Houdini VDB manage update wrong file attribute name [\#3322](https://github.com/pypeclub/OpenPype/pull/3322)
 - Nuke: anatomy compatibility issue hacks [\#3321](https://github.com/pypeclub/OpenPype/pull/3321)
 - hiero: otio p3 compatibility issue - metadata on effect use update 3.11 [\#3314](https://github.com/pypeclub/OpenPype/pull/3314)
+- Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
 - General: Vendorized modules for Python 2 and update poetry lock [\#3305](https://github.com/pypeclub/OpenPype/pull/3305)
 - Fix - added local targets to install host [\#3303](https://github.com/pypeclub/OpenPype/pull/3303)
 - Settings: Add missing default settings for nuke gizmo [\#3301](https://github.com/pypeclub/OpenPype/pull/3301)
@@ -78,8 +112,6 @@
 - Nuke: bake reformat was failing on string type [\#3261](https://github.com/pypeclub/OpenPype/pull/3261)
 - Maya: hotfix Pxr multitexture in looks [\#3260](https://github.com/pypeclub/OpenPype/pull/3260)
 - Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
-- Unreal: Fixed Animation loading in UE5 [\#3240](https://github.com/pypeclub/OpenPype/pull/3240)
-- Unreal: Fixed Render creation in UE5 [\#3239](https://github.com/pypeclub/OpenPype/pull/3239)
 
 **🔀 Refactored code**
 
@@ -90,7 +122,6 @@
 
 - Maya: add pointcache family to gpu cache loader [\#3318](https://github.com/pypeclub/OpenPype/pull/3318)
 - Maya look: skip empty file attributes [\#3274](https://github.com/pypeclub/OpenPype/pull/3274)
-- Harmony: 21.1 fix [\#3248](https://github.com/pypeclub/OpenPype/pull/3248)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
@@ -105,9 +136,6 @@
 
 - nuke: use framerange issue [\#3254](https://github.com/pypeclub/OpenPype/pull/3254)
 - Ftrack: Chunk sizes for queries has minimal condition [\#3244](https://github.com/pypeclub/OpenPype/pull/3244)
-- Maya: renderman displays needs to be filtered [\#3242](https://github.com/pypeclub/OpenPype/pull/3242)
-- Ftrack: Validate that the user exists on ftrack [\#3237](https://github.com/pypeclub/OpenPype/pull/3237)
-- Maya: Fix support for multiple resolutions [\#3236](https://github.com/pypeclub/OpenPype/pull/3236)
 
 **Merged pull requests:**
 
diff --git a/openpype/version.py b/openpype/version.py
index 7bf368108a..79e3b445f9 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.11.1"
+__version__ = "3.11.2-nightly.1"
diff --git a/pyproject.toml b/pyproject.toml
index ae89e7d9d8..4b297fe042 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.11.1" # OpenPype
+version = "3.11.2-nightly.1" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 759cea424c30b06960fc7a247055b96c58ab0eea Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 22 Jun 2022 10:45:14 +0300
Subject: [PATCH 0766/1227] Start separating "lineAAEnable"

---
 openpype/vendor/python/common/capture.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/openpype/vendor/python/common/capture.py b/openpype/vendor/python/common/capture.py
index 6b4c40a6e8..ae3a0d5cc1 100644
--- a/openpype/vendor/python/common/capture.py
+++ b/openpype/vendor/python/common/capture.py
@@ -361,7 +361,6 @@ Viewport2Options = {
     "floatingPointRTFormat": 1,
     "gammaCorrectionEnable": False,
     "gammaValue": 2.2,
-    "lineAAEnable": False,
     "maxHardwareLights": 8,
     "motionBlurEnable": False,
     "motionBlurSampleCount": 8,
@@ -383,6 +382,10 @@ Viewport2Options = {
     "vertexAnimationCache": 0
 }
 
+Viewport2OAAoption = {
+    "lineAAenable": False,
+}
+
 
 def apply_view(panel, **options):
     """Apply options to panel"""
@@ -496,6 +499,13 @@ def parse_view(panel):
         except ValueError:
             continue
 
+    for key in Viewport2OAAoption.keys():
+        attr = "hardwareRenderingGlobals.{0}".format(key)
+        try:
+            viewport2_options[key] = cmds.getAttr(attr)
+        except ValueError:
+            continue
+
     return {
         "camera": camera,
         "display_options": display_options,

From 277682c03dcdbed093905188def33545f8a9b24a Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 22 Jun 2022 10:56:49 +0300
Subject: [PATCH 0767/1227] Revert "Start separating "lineAAEnable""

This reverts commit 759cea424c30b06960fc7a247055b96c58ab0eea.
---
 openpype/vendor/python/common/capture.py | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/openpype/vendor/python/common/capture.py b/openpype/vendor/python/common/capture.py
index ae3a0d5cc1..6b4c40a6e8 100644
--- a/openpype/vendor/python/common/capture.py
+++ b/openpype/vendor/python/common/capture.py
@@ -361,6 +361,7 @@ Viewport2Options = {
     "floatingPointRTFormat": 1,
     "gammaCorrectionEnable": False,
     "gammaValue": 2.2,
+    "lineAAEnable": False,
     "maxHardwareLights": 8,
     "motionBlurEnable": False,
     "motionBlurSampleCount": 8,
@@ -382,10 +383,6 @@ Viewport2Options = {
     "vertexAnimationCache": 0
 }
 
-Viewport2OAAoption = {
-    "lineAAenable": False,
-}
-
 
 def apply_view(panel, **options):
     """Apply options to panel"""
@@ -499,13 +496,6 @@ def parse_view(panel):
         except ValueError:
             continue
 
-    for key in Viewport2OAAoption.keys():
-        attr = "hardwareRenderingGlobals.{0}".format(key)
-        try:
-            viewport2_options[key] = cmds.getAttr(attr)
-        except ValueError:
-            continue
-
     return {
         "camera": camera,
         "display_options": display_options,

From f39a95422dd4c694743c458e285315c83e5121ef Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Wed, 22 Jun 2022 11:06:44 +0200
Subject: [PATCH 0768/1227] Update integrations section on the web

---
 website/src/pages/index.js       |  45 +++++++++++++++++--------------
 website/static/img/app_hibob.png | Bin 0 -> 15943 bytes
 2 files changed, 25 insertions(+), 20 deletions(-)
 create mode 100644 website/static/img/app_hibob.png

diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index 115102ed04..0886706015 100644
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -361,7 +361,7 @@ function Home() {
 
                 <a className="link" href="https://www.blackmagicdesign.com/products/davinciresolve">
                   <img src="/img/app_resolve.png" alt="" title=""></img>
-                  <span className="caption">DaVinci Resolve (Beta)</span>
+                  <span className="caption">Resolve (Beta)</span>
                 </a>
 
                 <a className="link" href="https://www.blackmagicdesign.com/products/fusion">
@@ -374,6 +374,16 @@ function Home() {
                   <span className="caption">Ftrack</span>
                 </a>
 
+                <a className="link" href="https://www.shotgridsoftware.com/">
+                  <img src="/img/app_shotgrid.png" alt="" title=""></img>
+                  <span className="caption">Shotgrid (Beta)</span>
+                </a>
+
+                <a className="link" href="https://www.cg-wire.com/en/kitsu.html">
+                  <img src="/img/app_kitsu.png" alt="" title=""></img>
+                  <span className="caption">Kitsu (Beta)</span>
+                </a>
+
                 <a className="link" href="https://clockify.me">
                   <img src="/img/app_clockify.png" alt="" title=""></img>
                   <span className="caption">Clockify</span>
@@ -384,12 +394,7 @@ function Home() {
                   <span className="caption">Deadline</span>
                 </a>
 				
-                <a className="link" href="https://www.vvertex.com">
-                  <img src="/img/app_muster.png" alt="" title=""></img>
-                  <span className="caption">Muster</span>
-                </a>
-
-				<a className="link" href="https://www.royalrender.de/index.php/startseite.html">
+				        <a className="link" href="https://www.royalrender.de/index.php/startseite.html">
                   <img src="/img/app_royalrender.png" alt="" title=""></img>
                   <span className="caption">Royal Render</span>
                 </a>
@@ -399,30 +404,30 @@ function Home() {
                   <span className="caption">Slack</span>
                 </a>
 
-              </div>
-
-              <p> <b>In development by us or OpenPype community.</b></p>
-
-              <div className={classnames('showcase',)}>
-			  
                 <a className="link" href="https://j-cube.jp/solutions/multiverse/">
                   <img src="/img/app_multiverse.png" alt="" title=""></img>
                   <span className="caption">Multiverse</span>
                 </a>
 
-                <a className="link" href="https://www.shotgridsoftware.com/">
-                  <img src="/img/app_shotgrid.png" alt="" title=""></img>
-                  <span className="caption">Shotgrid</span>
-                </a>
+              </div>
 
+              <p> <b>Planned or in development by us and OpenPype community.</b></p>
+
+              <div className={classnames('showcase',)}>
+			  
                 <a className="link" href="https://fatfi.sh/aquarium/en">
                   <img src="/img/app_aquarium.png" alt="" title=""></img>
                   <span className="caption">Aquarium</span>
                 </a>
 
-                <a className="link" href="https://www.cg-wire.com/en/kitsu.html">
-                  <img src="/img/app_kitsu.png" alt="" title=""></img>
-                  <span className="caption">Kitsu</span>
+                <a className="link" href="https://www.vvertex.com">
+                  <img src="/img/app_muster.png" alt="" title=""></img>
+                  <span className="caption">Muster</span>
+                </a>
+
+                <a className="link" href="https://www.hibob.com">
+                  <img src="/img/app_hibob.png" alt="Hi Bob" title="Hi Bob"></img>
+                  <span className="caption">Bob</span>
                 </a>
 
               </div>
diff --git a/website/static/img/app_hibob.png b/website/static/img/app_hibob.png
new file mode 100644
index 0000000000000000000000000000000000000000..91dd8d3f6bae8ae50f7a74e0d3d2d8fba8b66b50
GIT binary patch
literal 15943
zcmXwAWmr_-*S*6GF!TVDf^-QI(%oGO5+cITDInbpA>AQel8SVf3?&E%2-1yoBQi9+
z^ZP%~`(f^Unfu&x&+N1I+H0>J^+HRT0GApU000726$KsiH}by^6bpUTS#-n(0D3@G
zLH3pR{9&h04vk)`@O{AO=PyTjyK~P|KGd+mK0-Uhxay#^`m*|szw&1=iCH6kaX#Hw
z`3BgXbUGQFEOQ$CZ0U@~cpi<*2n`<5Yf6kABnd;9O(t3<zxMO}{KYNrBH_!?Zsy4H
zO>vBNilzORy?>vN>jTEz@*-Y{mr96`lg>72nh)!g9%YEH9V>9-l~QMs+mXcR9MDiE
zf7j_ZbaZIUi2MkB!IY6LTkh59q&H%QHT>%_FLYcXRY>I@l|m>!KIiwu3Ey<pb<I%Q
zvLbKs)o<j<TTPF|+p~`EoF2mdL@BWt87W+Rd`7c-qz`d9)YS5S@ebD&0fw3L^=$nN
zTTT-oUX2*L`z<H5iK{Bo6E0;`C(;*e!Wu~qUZi=1rNJNz;RRPsyS$dK4Yv*-#{Y>w
z3Qtz9<%pz@qF40}VmxCD2C+}8IAH$Fd0}*ssZb5f4vl0-^_}5gRBL*)n-o=XH%7?(
zt729tAa2jYc|{tT1;jqtXX0b3Gk<KhtD{((F)Eqfv6_Niruu|4IK_DNoq|YgaKFby
z7`+UCuNlD`P7xz8!W=6!17vQ?3WLH!*vRkmExM(jhTgNC<v$Q1pnVGT3{iv3pcn`<
z4h&>h0<Vw8`>qf2#fr{{Pix~7Vdt+roI0}%7=6w7#orM(?>F7%*Uo#;h=BwOi+W{(
zx<;om{7<vCh}ZuZE81ZAf5D>Dv&lFQfySc*YKq7JePB1ohvsGtKTkPH(i4yf1(}cS
zXJ!IFDal}_$YN$y5J^oK0E%oUg#LRTOh<~8KR99fx&N)*W5hyCY^3TwFkn}t;w35K
z3isOfRjilu`u5vSh1b(hdGo7-bu~FI@NmE!n~a4tw$r$IrOd!ayRg9A?P<g676-QI
zf<xyTFJS(#Ms><BHzAWNfE<Zz*D{8^OGO6A?MsIpKOFJ5)@pePD-=J@;+@8whQRY6
zb-(9!W3T%SBL3LzJ8HJP0^2|ciZn?WJ{vQ?%?7n>v_5qeI(ub*GPasy9*$MZt2!js
z8wTpBacB>*4TT)lsXVZHAD3ILs*C`LA0hWyz$?BJWp2YWA%pdNfs?!f0YYW~XA?PX
zL|U*){CooY;p<KcE+h!Wa?@3a9H&nNs64_!G0f{)Vhm6smC`r8p}{wU2~^X{=2+u#
zdP_@An!p!=%Ow~U0ZMJ7ZnbA?OZ|~ct9gJ@3R$t)fRa%=)r=A%^KWK?8s@_z=jEaj
zfLuYT$SgQBY1$r-&#As3h@|bouiARs?aW%vAU)4Hb+3a2h+pRTb>lzXMb}nPM8J5<
z_w4d-K`JK_nV1re<%od~FgnxgF<rV<omYZG*Fxy`iaA2%7>`OLSa!JO|16vn`8N;P
z6hRLw2=;c}`LrQsCQu+0hqfXvwu1lfk>HK(GpQqzYQo1`pThR(KO2wrgP1`fc#vXy
ztOtk;+?pM$_oPy8(Su&~cAoLQ?ovRr#2!ahIRwbU9wF8fK9P;=vsC&+Wa>J_sI)_k
z`R&Uud@f3N$Jrr|A2)gCJ;!gr50=}45^Ynqd|>o>vi+8w@oo7M>Gfn7YnXWF)PYS9
z#Ey9>E;bVTeH%|~FI@4Cn#Ef)l-N*YW4@+wAErW5zsd-Fc3i!n`Dh**bjw7GHA2ph
zD0Y>VNw@q~yB2&bi480+n|-qR{6*=yVGjcLM`U+wv<0cjFTsQ`h9edQXewz<7t}Yv
z6IZ2IXD!V{BtNO6e~^ZS?YAWFkTd9*+O-@HbW+8<c=y{*4+mL_B0QUYqP@??{SD>)
z`1V|EGTM8wbDu=k61>0&vde3i<fm%xQo?Wxrczi`J?5o1Cm;&E@O#}{9!);^MGkNc
z<&HO@jTfIzfBQ+0!48g8<w)pa{-KC9VS*i)XDyVGTfqC(*Ur4Jk**OTcurKcl=?oV
z+{XQ`gcZO%Iagjj+dVVha-LCjc%7dM0U`jVY$09d^fIjbsOt0XKlT7YxZSK#H{|Y3
zi`~Wf@2QfG*@DT+jmFSuG60K|QCMX!zLlm^OyU5`S*WCA;ukK?rbvj&^RbYD>R@TQ
zW}6|0yAfwhq^)3RWIJjSL~bxud2>Vx)JT!=J@pW5WyGWx&Y%vwC^O(VA?gWlbToL{
z9iq}bdCdZvFzH8ah+3lvg&hq`d#SNp0wzNpoFRyxzseiyDu%0YkX*)jYhFRuzOep`
z;4oK5jO;n%YdQON>V*{P%Yi&EAfr+r##D9Vl6bBxzb|Hbfw5tzc=)1%5;VB6t!q<8
z+I5oEKLnG;%kJj)(`BMZen@Y7@tl5YF;6sf1x)VKV3$J0t2=)v45hR4haXC2rv6iV
ztyl#G4KlxZX^^h=?WRpv_v`Uj{>uJ4&j|)=3%N>DaFA7tq;3uykhKOW768l1*acXi
zmt9@W{IUE11Np0b#5S~BecC@nbx}@1rL9U6UcsJKg>{b+9CR(xuifNE#kKGi7AG?5
zoN{*?Tq2npr51@d^b~0AcDha8zh|<|nmK4n0nQeU^QbS?w^1XmBMRe2@{LBa{DnE&
z?3LV(_kV~?IGS15vjNMHB?HEEOo|4s9s3%L?PHAu_I1Z~Bh}zn7Jkv#_k7&MvrefW
z)25yBaoWn?zujiqH0FVA0uNiZBcDdKY<7~h8=4v#By?<y(D$-AuIIc8H?LtzE5C|4
zABthE@gb&#;X4d!E<lXn_4j|qsc0#5waY?PG+e13Jx>GQa<-d$KJ+^flE{6<qu%-}
zC2ob6*SEs+VQZVix_ApU!oHe&*n;B%!Qp3SHasJXBdWY(P%f(b-9B1Qv$_({-N;#@
zy3fUsj^AphjL^vA_xkA;NQDoC1Nc#nESx1E<xT8Qow0|R!!38KhQ#!bOFlGsRy+9Y
z+z7jIvBJP=X&P*51o!u6(jKwAr^+0C$qX}1We{n%Ur3^1AcQrsp}YDZJkV48vc%-%
z#e_HoFB|rV$q&>9-wdho{!B&^zCPF~T7II%4nCEZUuLMm)TI2nc&`bdIvL>U*s?W<
zejwHnVly5n{k)iGUL%PwLo%DVI^z{8Jiss}1^gYnlZ`uHwWQwLeD{LL8Izj1FDa%&
z@?{nE+vxIINz7Qqx|`%QtQdWM1=WEoxwGrzpvG56ur%D;-t@1ca>4h^VUC(l7Z}2S
zlt4)M;c7J%g~Cn|Q}1#2xD7EK=0Gq4vqU>UO?H6P<-V3S$|HgC{P0E=TQHb9L}n<{
zU9##sYU6=0sz8wc8E<H+>(ZEz^zEJVM@ElN<rs;DVx$xSz7GvZ((p&>%Eklai2f_U
zzlkSY(lmdP(Axlm!1P!qV583tl<T`yP1#mU>U#s&nlUBj$w9YXJ83Ut@J8^F76{ba
z@`a@8`+A&RH|F-6u(4+WmgKFM>w-T+6|{}Q-|r+^EcDfs`tvJ(4wi>cuPze{1Rc9U
zpSXoxxK*-Y3DjS>F}5st796)Z%Q^33H~t1SWwGcsc-2d~QPyM7_f9|%w!QKWL9aC!
z*wtVozsl1GR+h~OaoeOVjUos|o1VSEIsqeC3WX13dJPPiyhn)Pm7O;@Nto9e2@h`i
zxZfxGZKDHdBE|EN&@b_b=6R&Fm^F?JOJhuf{@c4GPR8GpyN)JQjc6DZAs@EBCZKx}
zq})j*QaGlid5C%xcL;*<7MScQuBMcIx^E!$50#m`IRjMGYNnwyP56a^6!I4b0GB9k
z74?E{hS#893yTiFxB^7+cA-$W%DC3mE&b;qt+gT^01k6H&XZ3!zKQeYygXXk4P(kI
zD;2~0iL&HoK?s7|9m7Uryo~~$H``Ft)jCZ@6@*fE3Wlh8`u)Z69<F^V*~-T|In)Sd
ze*8A&cq@g+xgbxAtzNq0`7;^i2-zh*ubpJUbZpK2`p#Wq&5`dpqD%e;-k8CEI0jQt
z5se3kR!qsBY(}?yMPBVUILmza8RpTodW8$Rqx1pMlOcoDp6}YVs3Xp^cQ9^ypztpu
zpg~@#P>Q#1A?p9`Kx~H>Pcr3}$i<tLVZ1rv5|$ha0Rckvd6Re_F}^e0gqlYAaSo)k
zfvm<qSq&X>G_hD(!;+?K$_{IYMQq?xWGevTXz=Olml(*T4B6aVEi@!#r9JYZX2ukG
zQ(*5zYEb?z)(+GDD|Y797?t1@xP6iD{5#%OR%&;Nd1~HX4xYRs#4SB{;$vbyZKUz(
zxBrMwVaR$1Ci3j2+90ooOd99$Gze#=Hq-2*k%PwNbN*CosaPHxldz1-pHs7W<_VdR
zNT#6=z1PZf1+&f@FZDq?yF0wlK6wgLzqg%sZ)cs^ayh(Q)5P+-3OH%Wu<oDQ_*uI>
z15H?MhT*^7roJvi%yhG^<P>&5;JSVhK8`kJ{NAUH1MOkXs5w;xgZd~+qvCz^R>sV1
z9tj5+Wpt4tAO9ze;4JLh;J`gC0E_xj2Sw)oDwk*~n_NQ?>JmSUlVBXYvwBpLBf`y^
zSURD6wc7O^HS(ACJ?cS$*HfJ1V~7+#to3$eB*ftdCjESSG5~jZxULq;3U2OuJMi83
z;*?zR%<a8kQ0-ACMV(}QL!AO*7@+xXBy}Tyjt*)UE><;GAX6g0Fs3R18>h|5Kny1f
zc55uwRA#B1dAr?-ILzGb$Irl-Y0SoVc-{3bkQR83SEEP)U=3ExP^GDzJWGadqz#jQ
zxci&7g^Hb&6>KVFb{exRgTRkmletv=%~yXX<VhJA*rIeMf0+SDMCZR4vtBXZzD9ns
ztl?o)D()@%7D(0nKMU00yFx&QI3T9zr6`4gt$tU|>l5m>ldRs19XzlW^<d?&saBJX
zR7enyrC;gft%Y`d(u=A|xS{gJvE$_f2)J-eQ6vVc8E6~W-e20!Heh7U<)y)<kfs)X
ze?bq-luz6z$4Bz%M9!l_ZL)cV-A<Iulg;@gy-%~;p7nMVk7?P#7ww$|rw>0Xtf7&Y
zUrG_--q6$=PBmTZ#HEIxh~p2E34TcEVlPZmk4%p_{L$>MS}XHkjwHO-=*a;_0@?Z@
z*KpH~zq;iW>OTcE&8^AlNiR*jf2Nr+oiq{8ydN0POB+PFP<5l16isx0dL&w)!GO$i
z1_1Yg-x?FlrDO>4qL-?<xrEBq1hoZYERA@`G54xkN%R&CI*yGDXt>V4Z{XP2y(=>b
zWB|pY2$`HgkxdOyfYQa=qtlKyS*I$75w*I+DHs%Y$k8Xx3`+$H4DaxO7usd~xnvnS
zX#670Lv@LbtOjXuH1Ciaq=B5#zsz0WKhKC`7?@@-%WK(BB{E%45+)Y)!dvCxxe(v7
zBCuXvEq0{^l;RFQ*GiH>17R`>Uj-=@*2RDVyEfhE-3&T3I%e#qsBU7wUnV(fiz2l*
z!4u1as1eJNz(PffS&s&ez8?W>L6^oz^@aRS%#+OgLivjT(@wi5A6;k#?W%%U+9lg4
zC%Uh&6VNZqi|ZJ&O;Ss)0B5+T0?;L-R@-|ejh?43O7%XQe;b<e-BbBQ(mkdqKyZa9
z{Em9$G?Jp+Yd-5yV3=ROUpySo1iR4afoeK}#Pt0-9xxrWDCBY;c}?cs=<0!-YiE<t
zIBeZyW3&dB;jN#ff5sS`0Ft?>3zSSEgOOg{8@9db4!yPVm;i!vL<P&aDK2B$lwM#p
zm!Z$zUhBPo6!E4^ZJ_h9xKs;~hX+TW`6M1-&iBbs<KnH$PY|{LT8)GD82RC|)opv4
zvs(*4>&Rzz^`6xD6=`N26u|h>vr-Bm|C%}YLLf^&rJ@lWix<e5cF1w9lp&FqU7?9%
z@~diO0Ol814B-9cE);E>I7>au6m80IoTi_qgRqt=T)+?-6WP}H4--a*SMwK5QXN+a
zjrt2>2!x<u8Do#D`Y!q3^(XpGM8xE3Vd@2y7U)z!<j|l<=)=s==h44a&9T1%t^0Q>
z^c5Y){>?I4D2Qql{PD`a{FMSAn3DLqPcnimQP+ef?muy&T^1wvPcl|M2M1YSSYxRG
z40Jmj*c}1TTUQ!N7r^#~1588&-@Y=m91kd6Dc82EDMA!7d*47WTSXA57t}^v<Izel
z)M*FnkX0BHPFkltsn6&*oSVvQxdki4%qVdVjd53N^VY~9?%G^{Bxe(G8wfMdxsw=)
z$kmx!`8<tiPQ2WHU+OEtLqAyY_$f59tT2BUvnc^VXbSjDbn`BI!8T-XdJNm3pBV7x
zW`UQc*csslb&_s=mECraeVIX$0{DWDB5tmQTB`5CNA+(C>AcB&;gljZIP2r&^p>D1
z6j$^Yx%{rxEa~)L3~Kh6n%*-_sCXW(!(EL<s<<KbJCgg?pjAVS7hGE|0@mjxH>28q
zKGLtIvbr+n^IaEdhEJ}snBSemv?F=qWOBUdL-Iu_rWfMF8V_U!o5+a{d~ge%P=_zH
zKi;Ki?pgjvlOrvG*?B}TPOMpQmn|X8vFU5I=$7r1s(zNvx|;j16+f~;pN8Z+!*k1g
z+|~P?X>t(!D*#^*!jZXHXxFA^ARH@|+IZ<xb>O7^l3M1J{e%D%_6*L8b9ZxCfWoYi
za-|MQ`a>+T4jaV$sf)|1&ELm&*M3*}<kM%6zApHyJR!!YIPKA%NpW5P=(9&c_thHd
z>XJ|&)eW!)B-WG#LAQ7=-Cm`UKANC;Iob{^CRp8N`E{r~<ph@AeDqDX6XT(&8FwzD
z;T>t6ulCtJyCG&IMtYDZdKLuLldT`zy$sqPfQg-ZXJ8+QbHkp@Br=tW|8#FD{_*XN
zb=n&!r8+rdhb2Q#g_hj)UxOsW3-$?z2jK2ND6;+nTzn#Cti=l5H1~_%L1~=Gt2tm2
zNbSdw7BTGYsXaHxi1fjL$!mQ5ix-C?&Rw(gwVlFPmP~*Hyv+ZOO+!V#5v++<D=mE?
zWmq7OJze8yUNP)m<Q_`GA2MRZ3dN5?nhg_+IEv=PjP?w6?kC;uy@kJ#?eI|j_<pEO
zans!|8uMP23@0kg(~Ou_KjP#KNFsd4S}t8X)P!zH1Auj{&NF3R2C;PX^SlN>w8*Qu
z>}l>$crm)WJ*w=wq^ACK{1-Wv^X{8+=9XWH2*hV>Sb`4Gx*}z3atCUV^5@5(lcv4C
z2m%u^OElZE{s<=fxWMn`sCjJxsv#B9klEn}0iB%?%W2T9SiahhE;YgMZ#OPi@u2Qw
zzX<vFgKo>=AH|(y&IY8R7C+>OUPv*$(plAp(@Mz7cxp`7fyb{)v<t6(Rm(Jl7aj+I
zZK1JMOpoNxC>WY;l$?mP_uG<-1O@gdCG)%9SYZ}8tXZSJewLCX&41a5=z5e5@)u_H
zzI~8eI5d@CJ(2I=vzjmci1#lAlQ5I-ioEcs*y5Mxz5(&=MNC0ZbH8Z@|3w4V6y1r|
zDIPQFJSNzADPT|e;^LKz1|>es!{hUzO;BlGl9beE8X(b_V3lX{ySFuj&@}JQpBPC$
zEQ9%^_i-5v6ap6AHdP9@<z$qB+dq*wngy61$jHNh1RsJxZH!0txa#%4^pD;H%Q81Y
z9Bp@4;P5mPoYjKVCyn@mCkc2m0sM!pV&(Bnf2gmf>HSCT3{MujLVILS)Z05-WOmnU
zCDTCn2ebr?ypulwM0g1oBWF`mHCH^*V{)jA!)m@9wA?6BI!bVyIyjAU+;jgSSmHg^
zzwg4qrQ?sf-=Eh=P7=iqnh{{p5qbMKW8B@%mqo`{wo0Deo>YQ3F)i{HZSTf-kR2Pg
zJIW6r0SFr`WY65sn!d)86BFR{eBw1nlAy4^rxTk2U!_#u*Ps*(LTU>x9`mv2grtQ#
z+R5z;OX2bR;{OYO_e4IGEX3Z*uT)Gx^eY2G(He-b3Anq*yS}hkrT6>vZ`<C+&z{_Z
zgaHOGVaTGcS#_A{7P+YTm4WbR#O_Fe(guU{*a+Aw6NYdR<Gvr5?L7@Go?<n0M7{HQ
zDI(aX{S<;*SAv80Es)kWU&+OEQT^zT59Ge~Wey4wtc)q6PV*!g3;LCnAJE%9vw2gj
zUqII<fhuy7`ZGqhM61L5kz463D2TAb44K_>`p8+YR&r8AF7Lw|zNY|k%|uGfP9q~!
zFK%^vNcY~zW|E~YR!7K&eVhN@SSw4hHViOgy8PHXetENBFw=Q(C}Xi99bskWR~p!a
zQ6Ru$iNM#!wQbG&+NU5GN@q+pB%MP1v~R~HHJq9{T&uJ|nPfGI*^ndAP6jOm$}vP<
zi$#8~8CbU5F*w{Wm*eTVx**DL$3+>K%Iuwa$)oWXrcLqe+tVit{3Wf7C4!N#??2Kb
z2+;h*lb>$2Zkb83xUJh12YK-pM><W8sNc*vfM9pqH2h|!t2^LcaOYV&LYQP#b|GH?
zWM40HGb2yaO0<!L-6Li$`jv_BgU5Ja0UUmC!S%aMfz?9}D)9C+P=rVtb4eKE%b8bp
zn$8(T_u-Fj=~g&zkyWA&UR*Gk;t&jvDiZ9leylfydPQ={|L3H!;cn=$%Kdw=&V?l5
zdCW7w7~Ul|es4COECyfURY@+J%j`^hZ6MouLe$a~2-;P^`28sS^u7q@zs&*7b?1sz
ztXwW~)vZ303<Dep=B7hVx&rY-%L0i1jcy`x^XOU2FA-jK>K}%wv0lm>MX_M1zNaKM
z%Avt^zklYM_JY^{87?sT*qJeK=1%2qCSbKvbvz1>espPUK^4n;fjkW*@U_>Xu{O2f
z1A0kH$2LuPUcJMVChZ_5w&R%bDGDZkCrDk1-Pgt+Gq6jG>YxD}m4My1Di7Pfk<C1(
zp6NJWJWp(RtM<Y;QszZp*nW>r6o~4am3dXU&}-~@P)`)tM2mm7cQNZRT9(v-;vSF2
zgdNY*{iggUlV1~@Bmi&E15O~XGpqihQ1P?N#|~J}>=7c)qHtoR``v}v^X@UG(=s;Y
z%DCwdq~;jZQvNvXstBFDaeb-<{<#u-Yh4(I<pC2U>W*tIMb-z@A{TH^(yI7XPz5To
z;0d4E{uX@c=Ztl@0=&NmJsD4FD%<rTf2;$w5MB`<BBg;2o)LvE3&sZPN=JNizJvNQ
zCwZ9RuHk|Z9)q&b<y)tni2I{7?;jS~7NWCxQQRy5zBxws2P3XWrz8lZgr?w}JvfLj
z=7-h^7YWAaZIiwub!nmtub|+LOQ>_(pWRwj_bYw7(eY36sxRDV`>vE3&v(UZZ?dY9
zOUwJ4*N<eN&o9cQAKb^g<MPOo1qOCG7#H}ljd2lz{4^yWq2Pu=D}s|pe(){)KyLm8
zT@0KPj?s-$n{lsy+sF`EWo`^27Rd{1p};H0E%`))N1S=#9dOaboBV;J1b>{-#|yZO
z5UTkpG20-Bln>#*hl3OSNE@7<b+poUs)N;P)JtEh0vj)v$WOqnMk{!m*7hVZ?a;*2
zD_!jevb%vh&b}`n3S3-X?NbbqXkn$szNAt?#G63wjOeb#oJNd7I?ORXz2tNm{hW#M
z@{iBoznC3v9nD^utOVio0??nfuAL=j>pE?cX@>iOAG7kq5NFrY;}7Vhr7+)-mEW31
zp|**IixECqAa7JCe5~-0eh>C#-o5(k1C<RYuG8lVJ^kDq+Kd8&ER;B?$&e@w*UD|>
zr_(^WDnjII#>K1jsqd)NN4F-LPjXevSHB-)G=alH`#}#HU~N_83*7a}8{}0t7JlFZ
z>K8&N-{%*#B{eknhVW#?^E%3PsvD)@n=BhmMGeJ!Qz7K#Prl=irXs(DXY)U=i64JB
z>t$mgd@J&iji+>hf2uJA3095tqK)2Yl$KjhLifkKR?_fjJRp5ZH=xs0gNKHmxjc?B
z(m~ALsWv@cx4~gBW0uz{j}pxRb|;z)nr{>}%jGoFNF<G!Hsu-PGrt>;!nU~Nln$q+
z99qEzcrRW<{(Nc<7Ct~N6%5(<m1givjJ#MC>&_%N@sSL>AUv@##{C)jaNArETIr~I
zmfX)V`BojE!L<Jz(RR$zcN`$1?XX>DqY{jKuN-{HkUw3C)f7>-zmk}pmoacTgw`WY
zXEAVP!^u=7Z!jiI1EKC4%vIX0*}BkbwqOw}Q|6g_@}toui#^ECdqMAuM#48(a-kGw
z&@Z-4HcGP$GO<q7naYkt$Gg=O>poQa%<muQWU(R2R2gb6-~sK12^kCMwRSb*mG>BB
zP+&X*Q7lUg!>A-6A&^C5(2A~SM`NfL_{9OShgrg#nS@Zncc{M}YClmU|IATg2>k{I
zkK=sg=YPLhh;3ld;ZiJ0=eL9%eCs7|Ux_X7FBw1g<9K!UboE)CV{yJ8v2U*@{UgeS
zxRME9S7Jmeo>&de(M5j9-QLP}e0z?F4EF+22mhK!+}0=h7VntqKS$~cYOt3&-Xx=E
z35Ohs0=zb)eFtUtxD8>?U+Y~F1N}!oN(A84@IEu?2c10KRmtI5FC39K;_tYrT3D?7
zSj7iIpctu-N)y}hNs5}QmC)tnaU*X8HBI>0_OpUsYX6Ifv){{#7(t%hlQv=VS#asI
zPhD$VU7|_%N;zN5{k+HgZNZQf+vdcAmJvh5f4RTSn1UN-5C9&3d{1bP3ySAn&cM?v
z|2X(~Th^>)tP7WxF0&qP-KQiJCR={-+4Kuxlg$`U@5F))Ed@YC%?zNsnZ70UlKuD}
z?{3PMmsV$#JJQBKv-hj*eJ>YecMNVm_($IVmxc~Aw4gam5>EvaBM4_U@06{0-~k^O
zE1cQZ{?0Vck%&Ty5d~~$yw&QM5Ub$_mqMf^0m<jjFL;jmWf>`f#wl>q-_So#;eMzZ
z%RUT9zXX?YrI#8BJgb3Q?Yve}Q7vNn2lH)@d5Yc&ch>^{FHuHbN0<50eCk9DE2`2^
z0C<A&pBDg14VO$w=1)T(IhSXT6~?o?s3DFv&MB0KYhXPKU+|g0OS2~t73v~ea<#9E
z)YlK%t{gxdoej?YieDB&*J~3q37Y{Nn1<{Ef$e?!pLdbO7IRNtJ-M_Aa7Impy%l_K
zb20ZMg^xXLJ~(&aSro-5i;`(SZs23`;Sb&S*DS74-MnFo43x9U?zC9+viF}11?waw
ze%P1G!Uu9+d-d&}(A9kDJ){b9MwwPyk<r8c&Q~TsN*hCI4B7g`J)bb@;(+{$!T*;n
z=UYL07I#?7{Lh6%qH;Pb7zo=3sc2_JMpxkDVg@oIrwZ=&805NJm6fOn>=#zM|Ji1y
zMqB%_zLLY2VQmPpz7YIn+;yf2EIcEj53fQ?Ty?tmP0TGp-oGDyTF7d0J7Oxhq+)C^
zc8<%THb@}Mw2^6e4B6BJykc%iK&~2ESOtHi5&k%2?pNx%j!!bax(4)l%D#Qu1ejc8
zMd)!Z@c(Gw3&kMuy@0ukNnRYU{!wgdlIgHm`^_RZw2RXC$HjqcCrRW)eXzwHdks8K
zn2uuh_F8;{XEsV#+>Z|R+t0EP^MAsxyO%Wx`&L+&C|~F~j+JkXO)nBru67a05fN_x
zEF1jDN;$xd-NgsVa2?A|i#g03>3I$e16_+me|F?$!;>!73+9)IkUxk&MGqck#*vt-
z0;B_{I|=J15tOUd_^4^@@67#rcnc{vOFr6w1V3a-nAhuJW-Od}5^>eU)Lo5#<8iCL
zbGDt*k3$h$L^$lQ%<t{he0Ty&IezL_OYJlQH`5BCm+ge`d?qv6rAQgV3{{#k5^R(F
z6Y9Q#3DC4SAC2@r(Ebd^r*VU@zuK-0vySQ4hc57gK*;t#i8i!^`-!33_jj2f9y5}o
z{RIG0C;sJW=3(YRcQTZId7U#zhP_ddpD2SFfKhn#s&csbJ@0bDTK#r=EmA4+hG54)
z*)Whkb~qm7Oo#eVA&2G$qpwLi?6AMaXazgId-8aEWG#0$39`7|6hc^??@#BxStFUE
z@BwyEcsutMX!!c(+6!SS*trMFp=cTIM!}=aI0<~!DM#yh{Q5s_(LnvuCfF%uc0%-4
zZ9M(nBi1KEgXVi)NohK?(;Jq*@%VJ1+qHLQ+)38lOthC&Suj1mIIX8PjMDIS#;}xY
zO_cNfudm45Cy<fX<a&Ym3Qd+c{Qj_yf8zb!%hS8`D?9yk$S`<Z^)Qiwj_^qP(orRI
zF7I?~>LlbL&%|&hKNLwE5l{7COthUg(_MW8$W8an)ui>KG~AOlNnVU}#;bL$zD9f`
zCpym(ekqk=f{tXhc{wnM^mZONc=qOOk~Po@bM80dI-!f=cGf|rQ}lhngHD}fie0Mg
z<F$+YV~!Aw{5nwyeqDU}yYy|4;j9JIJF7ZL(p*b*D6}UgM#%FWHt?&{%8pfW=SRyv
z0#xL(x;=re(rBwNo;k=}N0kjYI*&vUeon}N?q~6LYagFvtGnH=@+e??_7{}G{<WpU
zjBbb_gwo6p$M`&Ci-9fJ?ys_yfma|jOc7|3AWGRl2qr#xg*FRZz{tmvKf{y&7Y7gv
zI<dG;n~+0SJs_dOkdMvC)-vqTCfaWu`=WSg{#~ab5V$8VgMs)H|Az9ZJTm*Lo&mVC
zr;EM#MizJ6RRb^n&}qf_`#2Blncc}yo$hA6Bx$F_%s%Xj9e{g3#=*E8wS6@KZjOiT
z{74i4!areX8mrFcWyZ3=WgdJebhO`%F8mx#ebW4qE;2md6nwWDBQu`ich(hxpfh>l
z)Q&upx4r&bMo--vxSBn%@b8)O-vn)pa=Ld?CUcHsVQkDQr48Z=<Bvgrq<R{Fusv48
z0L)Fa=@G2#X(qdlWA6HBjIzi|YCG0mZ8!`Tss2>^gtx~gKl++30C#WMrlYfmv^}ri
zgE*seLqJ!~s|)e{=&{7i0MDA#c5id?QMP!}{SSE<8&75j)J4%D5P<8kF+=~o+W#)T
zeBxb~fwHz)v+hDhTuvsYctVo+K0kgH<v140j*n?H58W2ePMq(s`kj_l55&fo?H0ZK
z9ncQmdtwU3Pm(7kPdWriPz%|D!V!TduLYKGoXe#T4>3<~_<PkQ>WHsfg(XpJD~M)8
zZo$$OOzUI>&|&^LDe|8oJs|8}X$csfL_7qV!0t-4vJf+Zb-uHCyA9<igAZ>Am;+Z1
zUvB!m3I64q{Ve~IckkPSYKzxHzj`WOrdtBP^>u(?XjaJT8uLGSo}%4gXGZ_!-4E{>
z0`?2BBa&JUrN)1$OI$pqbFFZ99GjiluoBIFzlkuE+~BzTkVA%`H1`c)w)Pg4^B!b=
znTy_HYH>Sxnl8vL&mCyD>)WdgZ>Gr)AD}-CI_Tmq7NK{mE8RhKC-a}I^<!F*jtLyW
z-|2tfRfifDSWP}Fm)@uKtI@l%e@IdmlDjJ%zzd|+V?jT4`*}kZDVD&=dgPBFEZ|a2
zI_BTti4X>0P;s+fMF12*yaa0``CGlLnT7+&*S(hCz=Rn%A@}vvqtf8Yv7pC)TdZDO
zeB0quSVP)s21sIaX0^tHAe!_vzy({u@k%T*eN=WqQkdy?;BWTvzf0G<ZV&cwDAUR=
zMyHi@!u7_}zgGiJ*qaC#Y=r3O!P_9Y=p|0ycU*wm@CyJp(_JA2?x~ZpfQc*H<K%kD
z$)#+l$}DVvOYS=SCTa1qf$j-eL9-L<KqOT#6JdAHaUbmHnyUckdYJ+lz?4V-8(X3x
zak%v0)GM~_9RSBIU;x7KPlf}=FQkclc1Q%gR>GzqPa_RGTv87ip3W}zAHN|wzbTVd
ze;i!Q|DIZLvsRMy?o-kPwSqej0C$KPeB@4bmL}Bbl`(*F7Yo=nxjXg<zsdxOA7VH@
zVzK40MvCXQ3bJ?`(EKe2kE2#*<bOv<2$#a9>3j1oFI>G2<UZZ-F&`Uad(7|yAq6P?
z7wYT-lIy?3iZTt7efXO&j$=dfS8!x{I{qF)JGUKw=lXx`QY6Ks^=n$Ya0pU9R?UYz
zbI6cb`J9o}CF3IxVOLlA+;G1j_e3<y_ek}BQgeITBVMPe=FaXnWY!Tuf*9NUz;H5l
zM?Y53M`HW%n-on-sT(5OYh*vWEkR+ddLN>;g&^*@9k%ACt$bb2!_c_KF`FQb9q^!k
zvg#5~On$Gt?N8a@2#TE~{BXW|LGOLbS3@XC`3OH2<j@TfPC*q=p{+7tXZ27*=hN~r
zNh2A(rwjanU|u&B73Pc}<?JI>NBd*mgu^{|SNUF?gr(!#%ao6)192_!;wCSmhft5+
z>9EamIzUgZX$?<)3lod{9e*i9_BR75`0JFoMclJ{X&KLJfpDkL%w-5G6+;8eNQtnu
z3#mOOp^RC8bJ-7vNcoM$7LZLi{Ofu+Ii~wQ-u?}Ek5Yq+yftdV{s0czDkH~XJo!=i
z_}Dv^i8!>aeMuD)4bh=(7Dq>3CLZrXiCbF7v_$DMiX63{SmeYXa(vX!<gNMFtbP<L
z|D@^BI|mC`+*(hY94Q||2=8{ztp-B<gEKIy7FvwBYo4juKhZ{L*`9tE`$lP)w2#`L
zJBb%v^fja8sLVI+*hP`D3QYUmGOs^FBvk|nZWLn^Flbm#L%w`C%={tBSRLFarRj3)
z4Fa#+y(X-D9k!bD{KMy4_-h9qm#G|i(yd!bKa&Iu)5uQ<x_NNdllY<s(+BYE*vaJ6
zSLh@#d8y8-sxn@g=bAt{i6_JLohBv<6YW2uQ1B9_Bu9R&h(>o`-J%f0kJoR(iP!0-
z<~yS+ar6D=@pIVq+g-Zx`eRpqDE}lGX(_k?^_}noa6~&6Liq07kWRKAJLsF^*hX2J
zY7dS6sFU?6Cm`dcpv?(Dc#r0`o{>7-cd2e7+-4xS&~edi)FX`B)^j&y$4ECK+1r4J
z;H2|}xI%&L^FrkrS*$>JY@ON#hEY){rB)i&t&iRP=i^GMHWNzNs_C<XtGVpf#fRVI
z0N^{_28`b#FP`WdNt1tMWi=*cw{g;DNS_h}+fl5Kgz|Y`cQKsy<tt|+e;P21i{bt4
zUI>awig%XHIVXp+3r?@U!dc)y($PeS7Sq5^iGTvOh?{(U0NRH(()o5F9SA;2>XHoQ
zF6a)*#3U|lJkx*Hy&5&c)VlWhrIPJ899gXbY4`18*aOmlepHM)vg|@*jy;X!DeUsj
zMMqeL6vI7e;k&7$C2!+}dmBGqNWDI?y`Z)BI6lnP^lM6Kp8}4no0;DbG116I&08d_
zU~+!^0mZ|3IzUh))jEBKagzhS@6Nv`={;_Lvi>#g$xQw*p1zCIn0ta%`1lBK!2=%P
zJ8$qfrSWgZD*y_Q@5A5QtHWtwVa7)kR>Y$@Z^hQ}lTZc*trcuATC3~zTFSSIF#P;f
zNh&lA0|%s4^2<w?ZJq84t1oi^U_u#gRb0>J<qXs<z%zQR&v!yJyIP2V_(Q6<mszct
z0KzGOMDP6#Td&h~TB3jk;51b$S>MW&lzy%PIUU`k3>=#oe=wB}*D99L@uhB<H)dS%
zO-glHIq0t%3ncq7c8kBBQxtGgbh*m&1WmdPu_7Tr;d@eEzH`y#o80TxLt55zcd@%|
ze}Bzffp1gC#TUj@RlgC!`4m~N8@})t26d5bkqs2>nu@`nNxKk9w|#01)Y6OS3oqln
z921tkI0%=pFg<x;&xP@YzS-uBF1|?Ign+J*<Tu;NLpCcG^Jr|18?5$^=MI3%kxnjC
z)tT!H6^jJJ0;AcyxsI9<Bcu!U`rF~P`%}e(c;lG0cDjGmPL@d1s9KPlka%hsf|^F@
z!7DKOzB!2GpbeH3fCT@@4DFIbQ&v0azQiml)=P)io031l)(t($wHV-SV-G8ptlT@T
zc^2fV9kyXWS_xZ6ur<10>PT_DR>@l}N*YIdEWbJ^KY(Sk*#tePd~H3)S;F`Ck`+Jb
zZs0}N0{;6g29uT5-(2LafA!?paV|l~cZsEFkL+EKW^;btXJaF@VUUlhebi)$H1Yd_
zlJNkGb!eG6I-pLr9ESK5Z*(~j1(<=g6dfLr!UtdJ9*SJdGep3^^}?Lq(uD2J%k+1z
z0Nt@~h|70gOm~g#G6OV#(JT;Kd~rZ#__kFtCC{1{`v-mZZ9JxAvvl$gyKJXN{DF#@
zk5Rde*BuCfBU+s%*6(4NZ*#nM4;bxo<bEIiIyk(*ETHozX!t}`=)f(rBw7~#9a}V&
z$qHj%u9V-h`Pxha^;DdDBHL8qR+xw}pmz!2imXSS3j{g|?nk4peDv#N0RcD<FBfOw
zVt(VhwmW&6IJLiLcX(_7z(CFv-S7VJy5bm@YKsNzDaNMT0IAY05hxtBT@b@lDK31l
zd0fs1-EZTEiQPPcBp9z*eT=s-uN(3b!bmDw>-^Z|XR?nvQrhFmPHMR^6KQq_e<ECO
zP|WL(ULft-Rr`Hg@8t)`P$`haCLvtnot7^vD(i_6ROzzJh}Op>2z|mJ2EuI#2KItX
z57vw-wI-XU)iEH0D$-AsfBgUqlqB8nfmKW&)CXe{WLFnSiM{vL46zT1=H}N~ntxjR
zQzdTSs)}YUFSX*KR!kJ_drjdFdoOng-pJfM3l_0>Ez}5}e|9LOluC08ml0M|j~781
zWC`Ef@1xDQDQ&FVciWC2RDt4{(OuU*!G5@u_$I9TH~Sw(3N`3GPGkMUaUzZiMwcig
zaNc2%LCX~DteDA+rj=&;FPMR%Nlr*uE^J>`N9(PnnqAGl9Kk^0HTK%KR?^Yo>K-3!
zyv6hE!h9dF3~arnzX0=mwPC+iJZyc$z^X>lBGxpQ7hk!3jN5VcRA}$WlZsC^a(5jE
zQT;Hj%=n#e%PdIfgT&J#G2LU@D)J_q(lVcD87c^*I9>brDV!ZM(2jDE4jWm}#5#Ve
zPLDE${+h=BH37B94-Fw#!L9idqAT<d$=l)#^R<!w?a;Y;?i@mlO)q;RfFN`PdStZ`
z6Gyh4TB)Gh5-&d)z`^=AUZ~0$)z6@BcWbe(c?7px)6b`gB5%e_0-grnvlSX&V%96l
zViqJX=FP>5x)~)JFsny9YV$Rbd5d7;7k76G@mhjadfynC1>q6^<hH?>4VW^TAbQ8E
zDdrB`@fY{jRJmv5!!OI5`W&^ja_pL^K%7+v#|`JV>!g30#mMyl*AMWE*A>q8yd&Dj
zbtyu@Uy~7CBxrkX&Y##1gSa0~?zJ|~Mj%7~p3W>+)$qZ`oT9i2Kb6CpY-ntA>2W5l
zmfObp5=w2HXfrGK`S;N@>DT5A>D%#vhl!c>9NLf5Z<JF1j9%thu~)qjI<axe#jzFi
zd%U`K^eZKiO-GZe&WCZUJV!4pX3a!Pn9JH4NzbU#qxWy5k|}SW)NKnRU6kjo$^2A_
z(3Mnr;jTp!YUnFWmV)dyZ6Y{8zch!fsWY`5({+)}uS%s@J*`$UlVcLGU=JCz^3dHc
zU7*`g>C32GF@;gEyIDrto##)zf7{vct#v_F6q)A$_A6NkrTQB6$l2gGTC0{g;TK2a
z?7K>#hV#W!l(CL=)#XodpOVh9Nh{t)iCLe?NQadrb1V(41<a{WY16?0-_ytVPuzTv
z$73bWRWmpaS-F1Dq1MMEWv`NsukZj+>>vRNkoES42@TP{xdP8L8l4N0{qOxN1jaCL
zjag3&F14zD1j+LAmzz)~hHyLk|D|{%R2^&NW)^_U4FEDreCZ3~8hiI$;BaIKw}a-O
zUERy7)Gal1w;fu%xBNp8(+|saegvW7aQAaM&g<4ZfZ6=(;-VD=q@8^==`D-Y*_UDY
z@LRL|l<7VRAC3n5&8uO|`!AM$TUA$4bK35BhB%w|g_YYVFY=yao)*l(Cz82G*D52n
zuP-|3Sd1^S@qQM-!^PL&7vxQ4FJ$IpX7fgPY>`fh;c4Te<j?y`fK@?H9%HKyA-DjD
z=JbM?$FLby|DNq`U!T*~zD9m(6}16+#7&yG)vZ;9BPb2hLWEg4NLu22EAZ$Yi)iWW
z&9VDv<HH32avFYmEr>0Uuc@)<W22FR5>U3iqjub3W-z9;3=ZSujo$nBLOVZ0k9jiD
zb5UsL(0>eJ*WFSrFI(qGJuckJu12$eLLcpa8k);HP{ov)#sQP}mEid~y%|IMLkmNe
zKVfyJVD|su7bjGCF3lbFF`j(}ZOJW}xNSr<D>xBtpQo+1N~(n_#t_p-obPSLHG7P*
z^wuAc({sL+%pKiId&${Qb>`8uRBt>T;4x7{>0<qjtP<-!xmL2jdV!zpvJoo=QwgD?
z7S!bP=UpyM6lF$nv6&te0RH<!oa2=$r={;MuYejgJ4wpq@Xw(3@2KCic{D$@E0q#;
zjDl(#x0{@osp8b!y(;9MOIZ;EfZ^OGj_hS2odhY|C(C-tfCoS3{1KmQ+~FMO?2}8U
zF$^XdRZp};GWpJQ%}_(3z0JM0+w>nL{I*t<x>4WLW3IQN%Gi#yx?Y8w%9B<Zroqj;
z(CbF_bi-h~oO&+L)izLjKNO^ha7-niFbXJb+(u<n@~wgR^^>D5SjYfiw&S^dC3^8}
zOa`>6jE&s%ahrEqL*yIIrE?4DAfC(n^g4C@U}GqU8A+^Q9m$+=HMEtt5QG-W6ru!z
z<{<P2(92lu2GssPx;=u5facsf97iq5QX}M>Lq~1aP6qbklGpV=zWW*7-=3MeF`K9M
zZ1bq&^S*?Sp!t*Jzm@hkvyv=pVi(*EA>;`{gO$NSd3BQ1HIGZ|K#MlKxzm5Q^B=Mn
z#7A5aU5@1R;&h^$`&b5VPxBe<?$4aqFugzjR+2?~Q!zWHc2KFpt5diy-YFq9Y%fGP
zV)3%`JI>S0&u+<{0f_v?jcqS{rK-y?#zhQ(qr{QXurb&8!;RMF{Ez+-?og|2;^HvR
zz=a+rx`I4E5-Nk1oJ-DjbQlhpV`K}Hq755sdIovc@(-W1GGcCWQ{^ER6Yr;I^Uy*y
z6k+Ze!aRaVe38|)IN`SNfTdIq8H($Sh5-*`uzB(SVtC!gxOR5x@^z=c=z)h0eGQ&-
zs3zJhNYWHRX%wng-!M|F4+aGj2|IP%JpuZDm9x9++f3ofc<Q(b^ujly_hlpb{<G%d
zSZaxHq4(CaDFPIc@l&4(5#~A*0XHGvyV~8~H23|Y27JdJ0GFA*7vm4=GRYeDoKq!-
z;bs)`$P(OcdiojiFJf_M8aQNxR5{Ok-^3x=&)?b^R;YkZOo;w}2BlR@LSr|ZWg|_<
zp}1imMlUM=2mPLPSRES|1&~48G;*cX8;wC&#lFz(Ee>Ev7e!ftTN4~mO@hFA`$><^
zFMZ<Dv(xO!;`Xl+LJ*eUO}vAnc2xJVc3VZaEv(ec0W)QzOYp-3anX^}f57+8y)A9y
z@2gyN+d~i6QfS_o_DRT{Rr+~WA}{Ywsd3l4u#HaI+Y%4I3=kW8v7R;w&ZY!)s-f<~
z25t7!sLf0Yj6~7rdOHC9`|E*tZO*&%L|!J<L&nc<(=#Bp)=n?c@WQ{)JJ=$w1jtv_
zPlmL7Yu(;n8SZo53Fp>(zF@)vEFTO&7-4f{8-rwYzej3)?YQV%--&#sMPO3aq0RpT
zsG5f^4OP>_cLoA)ia&&Tz6Gz7%g>qGd4H*x0Y5CNrOrU;$7T^cJLUUy?p0Gr!MF+I
z|4l)8LK78W#%Oo##67+U)hb&fdN{?dyQR=<vU1F78PoUU7yDn=XL3N@5C=&Ll>@K;
zL<D)QK=u1>13}8I5ZRgVpF`&r$9U2NooHjF<49I_maI~Y8ABzRfJ*}W`Z`2YI!K`C
z^cU@~Dd?>a15k7vjdNI0Z&jzP_09kDv#USRJ|3ZF+#2i@I5SfUCjFou!-^LceswZ%
zEKX~gWM1lGv{6%zB=8;X;$q7hO8I%Qf|oN-<(KDPHp{q3%BFHJ7Avlv7sW+Cr%+@g
zm$okk$pGG+c{q|aoR6CKxYLm+P6@;f5HreSeNZrN@5S&>XZ}_q+ItXNTG3Jtw|A>1
zLmb@1^+Vc}!B+9c<Og1-PORUI`L&z{xS~0+?J6H-P(ASzkR_PB8b&3~l!b$=L1qGK
zq|`Dx?L1T((rgSt^S2w7)s|5aJJwInohq|{M<IOnE39r;JHfhA6Iu#%E>y=ji4uuW
z6?TfIX)1~+f8i(qYYYdOwt1$@ddbGlD}YphDdncts4!OLF!M>utiGXe=?(ZjnF(}|
z83P$aRih>xK;|E`zO2;T6lpBGBYE`~D`jdfi+yO7AEU=MMd4)n5sh^sr@t8`zxLDs
ziXF&$jh7Pkl@yB^r!VagcRU4SoqOWDbCzG=-{yl{|J6wetb24&Sr``CzA9)=cQtjA
zaGfLBoOp^UWh$R<pFGRMj$hm;C)Ykc@^k@W7#cZ<*D)|=nkgV1m)w3Iu8iXFe=f)T
zl8u=%w#8MMxrUhes9t56Zuw-=#&zlY(UBAJXIK3)R-m3Z97PBozV>i(x<+!)*#-+G
zOk&vZp4m~0JY|j*Q-vsV7B`0UidDS6YbVaAdw1*|5*RNLfk=17%07E6vDal2_!S3{
z$~?#zg@DlmXmM7C2XFN~hO~l4ko~gv!Zcrk(=ji){@hpRWR~t?1*}BS+*!%e8&k6(
zBSivj5}%xx{FtHb`ns9F1_QY+W+#Iv$XKfhFY?gm?TAPAZ3L$!+L81WNQS&yE>hdu
z86cAFFqzd@E=f#|)F7#er2hf-Gvb^be?Q@^2+ITg`h#(+km8b8Hqf4I@q{FbO0svM
zywj#qoqjocB|sDS{syxT`s=5_vgQy?FI#{uF`iMOAl=$?x_2^M&98YVn9(D`kI*B+
zj4)yW{?zFgaCU23UgPQU117(mEed*-ztSht%=AB;VMO7FOFV_IFI0Of;EtHKZa{-*
zRSpHY;DPtM+ZIXRmULK@ZJ)WsN=6Pk-gMc``GWnLR0X&;@hipdz5n#tvTMY}Kz@H}
za3#c7vET@$STN#Y?I8i%0=oRr^Z4mXT(J@A3Egi`+M-lQ+26s=RmWi<`Dnh45U<At
z!r%~3k*wx+>T2w;+0tjt%~wea*K9Oy0#9oj72Sm$*Hk_nBEK~JLA&L!+?q*%<nQPV
O1gI)%DOAb9L;epuiBM1g

literal 0
HcmV?d00001


From 340144157a185ed5fe8f596c834d4cc605546f51 Mon Sep 17 00:00:00 2001
From: Milan Kolar <mkolar@users.noreply.github.com>
Date: Wed, 22 Jun 2022 13:49:54 +0200
Subject: [PATCH 0769/1227] Revert "Shotgrid: Add production beta of shotgrid
 integration"

---
 .gitignore                                    |   3 -
 .../plugins/publish/submit_maya_deadline.py   |   1 -
 openpype/modules/shotgrid/README.md           |  19 --
 openpype/modules/shotgrid/__init__.py         |   5 -
 openpype/modules/shotgrid/lib/__init__.py     |   0
 openpype/modules/shotgrid/lib/const.py        |   1 -
 openpype/modules/shotgrid/lib/credentials.py  | 125 -----------
 openpype/modules/shotgrid/lib/record.py       |  20 --
 openpype/modules/shotgrid/lib/settings.py     |  18 --
 .../publish/collect_shotgrid_entities.py      | 100 ---------
 .../publish/collect_shotgrid_session.py       | 123 -----------
 .../publish/integrate_shotgrid_publish.py     |  77 -------
 .../publish/integrate_shotgrid_version.py     |  92 --------
 .../plugins/publish/validate_shotgrid_user.py |  38 ----
 openpype/modules/shotgrid/server/README.md    |   5 -
 openpype/modules/shotgrid/shotgrid_module.py  |  58 -----
 .../tests/shotgrid/lib/test_credentials.py    |  34 ---
 .../shotgrid/tray/credential_dialog.py        | 201 ------------------
 .../modules/shotgrid/tray/shotgrid_tray.py    |  75 -------
 openpype/resources/app_icons/shotgrid.png     | Bin 45744 -> 0 bytes
 .../defaults/project_settings/shotgrid.json   |  22 --
 .../defaults/system_settings/modules.json     |   8 +-
 openpype/settings/entities/__init__.py        |   2 -
 openpype/settings/entities/enum_entity.py     | 114 ++++------
 .../schemas/projects_schema/schema_main.json  |   4 -
 .../schema_project_shotgrid.json              |  98 ---------
 .../schemas/schema_representation_tags.json   |   3 -
 .../schemas/system_schema/schema_modules.json |  54 -----
 poetry.lock                                   |  16 --
 pyproject.toml                                |   1 -
 30 files changed, 38 insertions(+), 1279 deletions(-)
 delete mode 100644 openpype/modules/shotgrid/README.md
 delete mode 100644 openpype/modules/shotgrid/__init__.py
 delete mode 100644 openpype/modules/shotgrid/lib/__init__.py
 delete mode 100644 openpype/modules/shotgrid/lib/const.py
 delete mode 100644 openpype/modules/shotgrid/lib/credentials.py
 delete mode 100644 openpype/modules/shotgrid/lib/record.py
 delete mode 100644 openpype/modules/shotgrid/lib/settings.py
 delete mode 100644 openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
 delete mode 100644 openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
 delete mode 100644 openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_publish.py
 delete mode 100644 openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_version.py
 delete mode 100644 openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py
 delete mode 100644 openpype/modules/shotgrid/server/README.md
 delete mode 100644 openpype/modules/shotgrid/shotgrid_module.py
 delete mode 100644 openpype/modules/shotgrid/tests/shotgrid/lib/test_credentials.py
 delete mode 100644 openpype/modules/shotgrid/tray/credential_dialog.py
 delete mode 100644 openpype/modules/shotgrid/tray/shotgrid_tray.py
 delete mode 100644 openpype/resources/app_icons/shotgrid.png
 delete mode 100644 openpype/settings/defaults/project_settings/shotgrid.json
 delete mode 100644 openpype/settings/entities/schemas/projects_schema/schema_project_shotgrid.json

diff --git a/.gitignore b/.gitignore
index e18c94a1f4..28cfb4b1e9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -102,6 +102,3 @@ website/.docusaurus
 
 .poetry/
 .python-version
-.editorconfig
-.pre-commit-config.yaml
-mypy.ini
diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
index dff80e62b9..9964e3c646 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
@@ -519,7 +519,6 @@ class MayaSubmitDeadline(pyblish.api.InstancePlugin):
             "FTRACK_API_KEY",
             "FTRACK_API_USER",
             "FTRACK_SERVER",
-            "OPENPYPE_SG_USER",
             "AVALON_PROJECT",
             "AVALON_ASSET",
             "AVALON_TASK",
diff --git a/openpype/modules/shotgrid/README.md b/openpype/modules/shotgrid/README.md
deleted file mode 100644
index cbee0e9bf4..0000000000
--- a/openpype/modules/shotgrid/README.md
+++ /dev/null
@@ -1,19 +0,0 @@
-## Shotgrid Module
-
-### Pre-requisites
-
-Install and launch a [shotgrid leecher](https://github.com/Ellipsanime/shotgrid-leecher) server
-
-### Quickstart
-
-The goal of this tutorial is to synchronize an already existing shotgrid project with OpenPype.
-
-- Activate the shotgrid module in the **system settings** and inform the shotgrid leecher server API url
-
-- Create a new OpenPype project with the **project manager**
-
-- Inform the shotgrid authentication infos (url, script name, api key) and the shotgrid project ID related to this OpenPype project in the **project settings**
-
-- Use the batch interface (Tray > shotgrid > Launch batch), select your project and click "batch"
-
-- You can now access your shotgrid entities within the **avalon launcher** and publish informations to shotgrid with **pyblish**
diff --git a/openpype/modules/shotgrid/__init__.py b/openpype/modules/shotgrid/__init__.py
deleted file mode 100644
index f1337a9492..0000000000
--- a/openpype/modules/shotgrid/__init__.py
+++ /dev/null
@@ -1,5 +0,0 @@
-from .shotgrid_module import (
-    ShotgridModule,
-)
-
-__all__ = ("ShotgridModule",)
diff --git a/openpype/modules/shotgrid/lib/__init__.py b/openpype/modules/shotgrid/lib/__init__.py
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/openpype/modules/shotgrid/lib/const.py b/openpype/modules/shotgrid/lib/const.py
deleted file mode 100644
index 2a34800fac..0000000000
--- a/openpype/modules/shotgrid/lib/const.py
+++ /dev/null
@@ -1 +0,0 @@
-MODULE_NAME = "shotgrid"
diff --git a/openpype/modules/shotgrid/lib/credentials.py b/openpype/modules/shotgrid/lib/credentials.py
deleted file mode 100644
index 337c4f6ecb..0000000000
--- a/openpype/modules/shotgrid/lib/credentials.py
+++ /dev/null
@@ -1,125 +0,0 @@
-
-from urllib.parse import urlparse
-
-import shotgun_api3
-from shotgun_api3.shotgun import AuthenticationFault
-
-from openpype.lib import OpenPypeSecureRegistry, OpenPypeSettingsRegistry
-from openpype.modules.shotgrid.lib.record import Credentials
-
-
-def _get_shotgrid_secure_key(hostname, key):
-    """Secure item key for entered hostname."""
-    return f"shotgrid/{hostname}/{key}"
-
-
-def _get_secure_value_and_registry(
-    hostname,
-    name,
-):
-    key = _get_shotgrid_secure_key(hostname, name)
-    registry = OpenPypeSecureRegistry(key)
-    return registry.get_item(name, None), registry
-
-
-def get_shotgrid_hostname(shotgrid_url):
-
-    if not shotgrid_url:
-        raise Exception("Shotgrid url cannot be a null")
-    valid_shotgrid_url = (
-        f"//{shotgrid_url}" if "//" not in shotgrid_url else shotgrid_url
-    )
-    return urlparse(valid_shotgrid_url).hostname
-
-
-# Credentials storing function (using keyring)
-
-
-def get_credentials(shotgrid_url):
-    hostname = get_shotgrid_hostname(shotgrid_url)
-    if not hostname:
-        return None
-    login_value, _ = _get_secure_value_and_registry(
-        hostname,
-        Credentials.login_key_prefix(),
-    )
-    password_value, _ = _get_secure_value_and_registry(
-        hostname,
-        Credentials.password_key_prefix(),
-    )
-    return Credentials(login_value, password_value)
-
-
-def save_credentials(login, password, shotgrid_url):
-    hostname = get_shotgrid_hostname(shotgrid_url)
-    _, login_registry = _get_secure_value_and_registry(
-        hostname,
-        Credentials.login_key_prefix(),
-    )
-    _, password_registry = _get_secure_value_and_registry(
-        hostname,
-        Credentials.password_key_prefix(),
-    )
-    clear_credentials(shotgrid_url)
-    login_registry.set_item(Credentials.login_key_prefix(), login)
-    password_registry.set_item(Credentials.password_key_prefix(), password)
-
-
-def clear_credentials(shotgrid_url):
-    hostname = get_shotgrid_hostname(shotgrid_url)
-    login_value, login_registry = _get_secure_value_and_registry(
-        hostname,
-        Credentials.login_key_prefix(),
-    )
-    password_value, password_registry = _get_secure_value_and_registry(
-        hostname,
-        Credentials.password_key_prefix(),
-    )
-
-    if login_value is not None:
-        login_registry.delete_item(Credentials.login_key_prefix())
-
-    if password_value is not None:
-        password_registry.delete_item(Credentials.password_key_prefix())
-
-
-# Login storing function (using json)
-
-
-def get_local_login():
-    reg = OpenPypeSettingsRegistry()
-    try:
-        return str(reg.get_item("shotgrid_login"))
-    except Exception:
-        return None
-
-
-def save_local_login(login):
-    reg = OpenPypeSettingsRegistry()
-    reg.set_item("shotgrid_login", login)
-
-
-def clear_local_login():
-    reg = OpenPypeSettingsRegistry()
-    reg.delete_item("shotgrid_login")
-
-
-def check_credentials(
-    login,
-    password,
-    shotgrid_url,
-):
-
-    if not shotgrid_url or not login or not password:
-        return False
-    try:
-        session = shotgun_api3.Shotgun(
-            shotgrid_url,
-            login=login,
-            password=password,
-        )
-        session.preferences_read()
-        session.close()
-    except AuthenticationFault:
-        return False
-    return True
diff --git a/openpype/modules/shotgrid/lib/record.py b/openpype/modules/shotgrid/lib/record.py
deleted file mode 100644
index f62f4855d5..0000000000
--- a/openpype/modules/shotgrid/lib/record.py
+++ /dev/null
@@ -1,20 +0,0 @@
-
-class Credentials:
-    login = None
-    password = None
-
-    def __init__(self, login, password) -> None:
-        super().__init__()
-        self.login = login
-        self.password = password
-
-    def is_empty(self):
-        return not (self.login and self.password)
-
-    @staticmethod
-    def login_key_prefix():
-        return "login"
-
-    @staticmethod
-    def password_key_prefix():
-        return "password"
diff --git a/openpype/modules/shotgrid/lib/settings.py b/openpype/modules/shotgrid/lib/settings.py
deleted file mode 100644
index 924099f04b..0000000000
--- a/openpype/modules/shotgrid/lib/settings.py
+++ /dev/null
@@ -1,18 +0,0 @@
-from openpype.api import get_system_settings, get_project_settings
-from openpype.modules.shotgrid.lib.const import MODULE_NAME
-
-
-def get_shotgrid_project_settings(project):
-    return get_project_settings(project).get(MODULE_NAME, {})
-
-
-def get_shotgrid_settings():
-    return get_system_settings().get("modules", {}).get(MODULE_NAME, {})
-
-
-def get_shotgrid_servers():
-    return get_shotgrid_settings().get("shotgrid_settings", {})
-
-
-def get_leecher_backend_url():
-    return get_shotgrid_settings().get("leecher_backend_url")
diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
deleted file mode 100644
index 0b03ac2e5d..0000000000
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_entities.py
+++ /dev/null
@@ -1,100 +0,0 @@
-import os
-
-import pyblish.api
-from openpype.lib.mongo import OpenPypeMongoConnection
-
-
-class CollectShotgridEntities(pyblish.api.ContextPlugin):
-    """Collect shotgrid entities according to the current context"""
-
-    order = pyblish.api.CollectorOrder + 0.499
-    label = "Shotgrid entities"
-
-    def process(self, context):
-
-        avalon_project = context.data.get("projectEntity")
-        avalon_asset = context.data.get("assetEntity")
-        avalon_task_name = os.getenv("AVALON_TASK")
-
-        self.log.info(avalon_project)
-        self.log.info(avalon_asset)
-
-        sg_project = _get_shotgrid_project(context)
-        sg_task = _get_shotgrid_task(
-            avalon_project,
-            avalon_asset,
-            avalon_task_name
-        )
-        sg_entity = _get_shotgrid_entity(avalon_project, avalon_asset)
-
-        if sg_project:
-            context.data["shotgridProject"] = sg_project
-            self.log.info(
-                "Collected correspondig shotgrid project : {}".format(
-                    sg_project
-                )
-            )
-
-        if sg_task:
-            context.data["shotgridTask"] = sg_task
-            self.log.info(
-                "Collected correspondig shotgrid task : {}".format(sg_task)
-            )
-
-        if sg_entity:
-            context.data["shotgridEntity"] = sg_entity
-            self.log.info(
-                "Collected correspondig shotgrid entity : {}".format(sg_entity)
-            )
-
-    def _find_existing_version(self, code, context):
-
-        filters = [
-            ["project", "is", context.data.get("shotgridProject")],
-            ["sg_task", "is", context.data.get("shotgridTask")],
-            ["entity", "is", context.data.get("shotgridEntity")],
-            ["code", "is", code],
-        ]
-
-        sg = context.data.get("shotgridSession")
-        return sg.find_one("Version", filters, [])
-
-
-def _get_shotgrid_collection(project):
-    client = OpenPypeMongoConnection.get_mongo_client()
-    return client.get_database("shotgrid_openpype").get_collection(project)
-
-
-def _get_shotgrid_project(context):
-    shotgrid_project_id = context.data["project_settings"].get(
-        "shotgrid_project_id")
-    if shotgrid_project_id:
-        return {"type": "Project", "id": shotgrid_project_id}
-    return {}
-
-
-def _get_shotgrid_task(avalon_project, avalon_asset, avalon_task):
-    sg_col = _get_shotgrid_collection(avalon_project["name"])
-    shotgrid_task_hierarchy_row = sg_col.find_one(
-        {
-            "type": "Task",
-            "_id": {"$regex": "^" + avalon_task + "_[0-9]*"},
-            "parent": {"$regex": ".*," + avalon_asset["name"] + ","},
-        }
-    )
-    if shotgrid_task_hierarchy_row:
-        return {"type": "Task", "id": shotgrid_task_hierarchy_row["src_id"]}
-    return {}
-
-
-def _get_shotgrid_entity(avalon_project, avalon_asset):
-    sg_col = _get_shotgrid_collection(avalon_project["name"])
-    shotgrid_entity_hierarchy_row = sg_col.find_one(
-        {"_id": avalon_asset["name"]}
-    )
-    if shotgrid_entity_hierarchy_row:
-        return {
-            "type": shotgrid_entity_hierarchy_row["type"],
-            "id": shotgrid_entity_hierarchy_row["src_id"],
-        }
-    return {}
diff --git a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py b/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
deleted file mode 100644
index 9d5d2271bf..0000000000
--- a/openpype/modules/shotgrid/plugins/publish/collect_shotgrid_session.py
+++ /dev/null
@@ -1,123 +0,0 @@
-import os
-
-import pyblish.api
-import shotgun_api3
-from shotgun_api3.shotgun import AuthenticationFault
-
-from openpype.lib import OpenPypeSettingsRegistry
-from openpype.modules.shotgrid.lib.settings import (
-    get_shotgrid_servers,
-    get_shotgrid_project_settings,
-)
-
-
-class CollectShotgridSession(pyblish.api.ContextPlugin):
-    """Collect shotgrid session using user credentials"""
-
-    order = pyblish.api.CollectorOrder
-    label = "Shotgrid user session"
-
-    def process(self, context):
-
-        certificate_path = os.getenv("SHOTGUN_API_CACERTS")
-        if certificate_path is None or not os.path.exists(certificate_path):
-            self.log.info(
-                "SHOTGUN_API_CACERTS does not contains a valid \
-                path: {}".format(
-                    certificate_path
-                )
-            )
-            certificate_path = get_shotgrid_certificate()
-            self.log.info("Get Certificate from shotgrid_api")
-
-        if not os.path.exists(certificate_path):
-            self.log.error(
-                "Could not find certificate in shotgun_api3: \
-                {}".format(
-                    certificate_path
-                )
-            )
-            return
-
-        set_shotgrid_certificate(certificate_path)
-        self.log.info("Set Certificate: {}".format(certificate_path))
-
-        avalon_project = os.getenv("AVALON_PROJECT")
-
-        shotgrid_settings = get_shotgrid_project_settings(avalon_project)
-        self.log.info("shotgrid settings: {}".format(shotgrid_settings))
-        shotgrid_servers_settings = get_shotgrid_servers()
-        self.log.info(
-            "shotgrid_servers_settings: {}".format(shotgrid_servers_settings)
-        )
-
-        shotgrid_server = shotgrid_settings.get("shotgrid_server", "")
-        if not shotgrid_server:
-            self.log.error(
-                "No Shotgrid server found, please choose a credential"
-                "in script name and script key in OpenPype settings"
-            )
-
-        shotgrid_server_setting = shotgrid_servers_settings.get(
-            shotgrid_server, {}
-        )
-        shotgrid_url = shotgrid_server_setting.get("shotgrid_url", "")
-
-        shotgrid_script_name = shotgrid_server_setting.get(
-            "shotgrid_script_name", ""
-        )
-        shotgrid_script_key = shotgrid_server_setting.get(
-            "shotgrid_script_key", ""
-        )
-        if not shotgrid_script_name and not shotgrid_script_key:
-            self.log.error(
-                "No Shotgrid api credential found, please enter "
-                "script name and script key in OpenPype settings"
-            )
-
-        login = get_login() or os.getenv("OPENPYPE_SG_USER")
-
-        if not login:
-            self.log.error(
-                "No Shotgrid login found, please "
-                "login to shotgrid withing openpype Tray"
-            )
-
-        session = shotgun_api3.Shotgun(
-            base_url=shotgrid_url,
-            script_name=shotgrid_script_name,
-            api_key=shotgrid_script_key,
-            sudo_as_login=login,
-        )
-
-        try:
-            session.preferences_read()
-        except AuthenticationFault:
-            raise ValueError(
-                "Could not connect to shotgrid {} with user {}".format(
-                    shotgrid_url, login
-                )
-            )
-
-        self.log.info(
-            "Logged to shotgrid {} with user {}".format(shotgrid_url, login)
-        )
-        context.data["shotgridSession"] = session
-        context.data["shotgridUser"] = login
-
-
-def get_shotgrid_certificate():
-    shotgun_api_path = os.path.dirname(shotgun_api3.__file__)
-    return os.path.join(shotgun_api_path, "lib", "certifi", "cacert.pem")
-
-
-def set_shotgrid_certificate(certificate):
-    os.environ["SHOTGUN_API_CACERTS"] = certificate
-
-
-def get_login():
-    reg = OpenPypeSettingsRegistry()
-    try:
-        return str(reg.get_item("shotgrid_login"))
-    except Exception:
-        return None
diff --git a/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_publish.py b/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_publish.py
deleted file mode 100644
index cfd2d10fd9..0000000000
--- a/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_publish.py
+++ /dev/null
@@ -1,77 +0,0 @@
-import os
-import pyblish.api
-
-
-class IntegrateShotgridPublish(pyblish.api.InstancePlugin):
-    """
-    Create published Files from representations and add it to version. If
-    representation is tagged add shotgrid review, it will add it in
-    path to movie for a movie file or path to frame for an image sequence.
-    """
-
-    order = pyblish.api.IntegratorOrder + 0.499
-    label = "Shotgrid Published Files"
-
-    def process(self, instance):
-
-        context = instance.context
-
-        self.sg = context.data.get("shotgridSession")
-
-        shotgrid_version = instance.data.get("shotgridVersion")
-
-        for representation in instance.data.get("representations", []):
-
-            local_path = representation.get("published_path")
-            code = os.path.basename(local_path)
-
-            if representation.get("tags", []):
-                continue
-
-            published_file = self._find_existing_publish(
-                code, context, shotgrid_version
-            )
-
-            published_file_data = {
-                "project": context.data.get("shotgridProject"),
-                "code": code,
-                "entity": context.data.get("shotgridEntity"),
-                "task": context.data.get("shotgridTask"),
-                "version": shotgrid_version,
-                "path": {"local_path": local_path},
-            }
-            if not published_file:
-                published_file = self._create_published(published_file_data)
-                self.log.info(
-                    "Create Shotgrid PublishedFile: {}".format(published_file)
-                )
-            else:
-                self.sg.update(
-                    published_file["type"],
-                    published_file["id"],
-                    published_file_data,
-                )
-                self.log.info(
-                    "Update Shotgrid PublishedFile: {}".format(published_file)
-                )
-
-            if instance.data["family"] == "image":
-                self.sg.upload_thumbnail(
-                    published_file["type"], published_file["id"], local_path
-                )
-            instance.data["shotgridPublishedFile"] = published_file
-
-    def _find_existing_publish(self, code, context, shotgrid_version):
-
-        filters = [
-            ["project", "is", context.data.get("shotgridProject")],
-            ["task", "is", context.data.get("shotgridTask")],
-            ["entity", "is", context.data.get("shotgridEntity")],
-            ["version", "is", shotgrid_version],
-            ["code", "is", code],
-        ]
-        return self.sg.find_one("PublishedFile", filters, [])
-
-    def _create_published(self, published_file_data):
-
-        return self.sg.create("PublishedFile", published_file_data)
diff --git a/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_version.py b/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_version.py
deleted file mode 100644
index a1b7140e22..0000000000
--- a/openpype/modules/shotgrid/plugins/publish/integrate_shotgrid_version.py
+++ /dev/null
@@ -1,92 +0,0 @@
-import os
-import pyblish.api
-
-
-class IntegrateShotgridVersion(pyblish.api.InstancePlugin):
-    """Integrate Shotgrid Version"""
-
-    order = pyblish.api.IntegratorOrder + 0.497
-    label = "Shotgrid Version"
-
-    sg = None
-
-    def process(self, instance):
-
-        context = instance.context
-        self.sg = context.data.get("shotgridSession")
-
-        # TODO: Use path template solver to build version code from settings
-        anatomy = instance.data.get("anatomyData", {})
-        code = "_".join(
-            [
-                anatomy["project"]["code"],
-                anatomy["parent"],
-                anatomy["asset"],
-                anatomy["task"]["name"],
-                "v{:03}".format(int(anatomy["version"])),
-            ]
-        )
-
-        version = self._find_existing_version(code, context)
-
-        if not version:
-            version = self._create_version(code, context)
-            self.log.info("Create Shotgrid version: {}".format(version))
-        else:
-            self.log.info("Use existing Shotgrid version: {}".format(version))
-
-        data_to_update = {}
-        status = context.data.get("intent", {}).get("value")
-        if status:
-            data_to_update["sg_status_list"] = status
-
-        for representation in instance.data.get("representations", []):
-            local_path = representation.get("published_path")
-            code = os.path.basename(local_path)
-
-            if "shotgridreview" in representation.get("tags", []):
-
-                if representation["ext"] in ["mov", "avi"]:
-                    self.log.info(
-                        "Upload review: {} for version shotgrid {}".format(
-                            local_path, version.get("id")
-                        )
-                    )
-                    self.sg.upload(
-                        "Version",
-                        version.get("id"),
-                        local_path,
-                        field_name="sg_uploaded_movie",
-                    )
-
-                    data_to_update["sg_path_to_movie"] = local_path
-
-                elif representation["ext"] in ["jpg", "png", "exr", "tga"]:
-                    path_to_frame = local_path.replace("0000", "#")
-                    data_to_update["sg_path_to_frames"] = path_to_frame
-
-        self.log.info("Update Shotgrid version with {}".format(data_to_update))
-        self.sg.update("Version", version["id"], data_to_update)
-
-        instance.data["shotgridVersion"] = version
-
-    def _find_existing_version(self, code, context):
-
-        filters = [
-            ["project", "is", context.data.get("shotgridProject")],
-            ["sg_task", "is", context.data.get("shotgridTask")],
-            ["entity", "is", context.data.get("shotgridEntity")],
-            ["code", "is", code],
-        ]
-        return self.sg.find_one("Version", filters, [])
-
-    def _create_version(self, code, context):
-
-        version_data = {
-            "project": context.data.get("shotgridProject"),
-            "sg_task": context.data.get("shotgridTask"),
-            "entity": context.data.get("shotgridEntity"),
-            "code": code,
-        }
-
-        return self.sg.create("Version", version_data)
diff --git a/openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py b/openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py
deleted file mode 100644
index c14c980e2a..0000000000
--- a/openpype/modules/shotgrid/plugins/publish/validate_shotgrid_user.py
+++ /dev/null
@@ -1,38 +0,0 @@
-import pyblish.api
-import openpype.api
-
-
-class ValidateShotgridUser(pyblish.api.ContextPlugin):
-    """
-    Check if user is valid and have access to the project.
-    """
-
-    label = "Validate Shotgrid User"
-    order = openpype.api.ValidateContentsOrder
-
-    def process(self, context):
-        sg = context.data.get("shotgridSession")
-
-        login = context.data.get("shotgridUser")
-        self.log.info("Login shotgrid set in OpenPype is {}".format(login))
-        project = context.data.get("shotgridProject")
-        self.log.info("Current shotgun project is {}".format(project))
-
-        if not (login and sg and project):
-            raise KeyError()
-
-        user = sg.find_one("HumanUser", [["login", "is", login]], ["projects"])
-
-        self.log.info(user)
-        self.log.info(login)
-        user_projects_id = [p["id"] for p in user.get("projects", [])]
-        if not project.get("id") in user_projects_id:
-            raise PermissionError(
-                "Login {} don't have access to the project {}".format(
-                    login, project
-                )
-            )
-
-        self.log.info(
-            "Login {} have access to the project {}".format(login, project)
-        )
diff --git a/openpype/modules/shotgrid/server/README.md b/openpype/modules/shotgrid/server/README.md
deleted file mode 100644
index 15e056ff3e..0000000000
--- a/openpype/modules/shotgrid/server/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-
-### Shotgrid server
-
-Please refer to the external project that covers Openpype/Shotgrid communication:
-  - https://github.com/Ellipsanime/shotgrid-leecher
diff --git a/openpype/modules/shotgrid/shotgrid_module.py b/openpype/modules/shotgrid/shotgrid_module.py
deleted file mode 100644
index 5644f0c35f..0000000000
--- a/openpype/modules/shotgrid/shotgrid_module.py
+++ /dev/null
@@ -1,58 +0,0 @@
-import os
-
-from openpype_interfaces import (
-    ITrayModule,
-    IPluginPaths,
-    ILaunchHookPaths,
-)
-
-from openpype.modules import OpenPypeModule
-
-SHOTGRID_MODULE_DIR = os.path.dirname(os.path.abspath(__file__))
-
-
-class ShotgridModule(
-    OpenPypeModule, ITrayModule, IPluginPaths, ILaunchHookPaths
-):
-    leecher_manager_url = None
-    name = "shotgrid"
-    enabled = False
-    project_id = None
-    tray_wrapper = None
-
-    def initialize(self, modules_settings):
-        shotgrid_settings = modules_settings.get(self.name, dict())
-        self.enabled = shotgrid_settings.get("enabled", False)
-        self.leecher_manager_url = shotgrid_settings.get(
-            "leecher_manager_url", ""
-        )
-
-    def connect_with_modules(self, enabled_modules):
-        pass
-
-    def get_global_environments(self):
-        return {"PROJECT_ID": self.project_id}
-
-    def get_plugin_paths(self):
-        return {
-            "publish": [
-                os.path.join(SHOTGRID_MODULE_DIR, "plugins", "publish")
-            ]
-        }
-
-    def get_launch_hook_paths(self):
-        return os.path.join(SHOTGRID_MODULE_DIR, "hooks")
-
-    def tray_init(self):
-        from .tray.shotgrid_tray import ShotgridTrayWrapper
-
-        self.tray_wrapper = ShotgridTrayWrapper(self)
-
-    def tray_start(self):
-        return self.tray_wrapper.validate()
-
-    def tray_exit(self, *args, **kwargs):
-        return self.tray_wrapper
-
-    def tray_menu(self, tray_menu):
-        return self.tray_wrapper.tray_menu(tray_menu)
diff --git a/openpype/modules/shotgrid/tests/shotgrid/lib/test_credentials.py b/openpype/modules/shotgrid/tests/shotgrid/lib/test_credentials.py
deleted file mode 100644
index 1f78cf77c9..0000000000
--- a/openpype/modules/shotgrid/tests/shotgrid/lib/test_credentials.py
+++ /dev/null
@@ -1,34 +0,0 @@
-import pytest
-from assertpy import assert_that
-
-import openpype.modules.shotgrid.lib.credentials as sut
-
-
-def test_missing_shotgrid_url():
-    with pytest.raises(Exception) as ex:
-        # arrange
-        url = ""
-        # act
-        sut.get_shotgrid_hostname(url)
-        # assert
-        assert_that(ex).is_equal_to("Shotgrid url cannot be a null")
-
-
-def test_full_shotgrid_url():
-    # arrange
-    url = "https://shotgrid.com/myinstance"
-    # act
-    actual = sut.get_shotgrid_hostname(url)
-    # assert
-    assert_that(actual).is_not_empty()
-    assert_that(actual).is_equal_to("shotgrid.com")
-
-
-def test_incomplete_shotgrid_url():
-    # arrange
-    url = "shotgrid.com/myinstance"
-    # act
-    actual = sut.get_shotgrid_hostname(url)
-    # assert
-    assert_that(actual).is_not_empty()
-    assert_that(actual).is_equal_to("shotgrid.com")
diff --git a/openpype/modules/shotgrid/tray/credential_dialog.py b/openpype/modules/shotgrid/tray/credential_dialog.py
deleted file mode 100644
index 9d841d98be..0000000000
--- a/openpype/modules/shotgrid/tray/credential_dialog.py
+++ /dev/null
@@ -1,201 +0,0 @@
-import os
-from Qt import QtCore, QtWidgets, QtGui
-
-from openpype import style
-from openpype import resources
-from openpype.modules.shotgrid.lib import settings, credentials
-
-
-class CredentialsDialog(QtWidgets.QDialog):
-    SIZE_W = 450
-    SIZE_H = 200
-
-    _module = None
-    _is_logged = False
-    url_label = None
-    login_label = None
-    password_label = None
-    url_input = None
-    login_input = None
-    password_input = None
-    input_layout = None
-    login_button = None
-    buttons_layout = None
-    main_widget = None
-
-    login_changed = QtCore.Signal()
-
-    def __init__(self, module, parent=None):
-        super(CredentialsDialog, self).__init__(parent)
-
-        self._module = module
-        self._is_logged = False
-
-        self.setWindowTitle("OpenPype - Shotgrid Login")
-
-        icon = QtGui.QIcon(resources.get_openpype_icon_filepath())
-        self.setWindowIcon(icon)
-
-        self.setWindowFlags(
-            QtCore.Qt.WindowCloseButtonHint
-            | QtCore.Qt.WindowMinimizeButtonHint
-        )
-        self.setMinimumSize(QtCore.QSize(self.SIZE_W, self.SIZE_H))
-        self.setMaximumSize(QtCore.QSize(self.SIZE_W + 100, self.SIZE_H + 100))
-        self.setStyleSheet(style.load_stylesheet())
-
-        self.ui_init()
-
-    def ui_init(self):
-        self.url_label = QtWidgets.QLabel("Shotgrid server:")
-        self.login_label = QtWidgets.QLabel("Login:")
-        self.password_label = QtWidgets.QLabel("Password:")
-
-        self.url_input = QtWidgets.QComboBox()
-        # self.url_input.setReadOnly(True)
-
-        self.login_input = QtWidgets.QLineEdit()
-        self.login_input.setPlaceholderText("login")
-
-        self.password_input = QtWidgets.QLineEdit()
-        self.password_input.setPlaceholderText("password")
-        self.password_input.setEchoMode(QtWidgets.QLineEdit.Password)
-
-        self.error_label = QtWidgets.QLabel("")
-        self.error_label.setStyleSheet("color: red;")
-        self.error_label.setWordWrap(True)
-        self.error_label.hide()
-
-        self.input_layout = QtWidgets.QFormLayout()
-        self.input_layout.setContentsMargins(10, 15, 10, 5)
-
-        self.input_layout.addRow(self.url_label, self.url_input)
-        self.input_layout.addRow(self.login_label, self.login_input)
-        self.input_layout.addRow(self.password_label, self.password_input)
-        self.input_layout.addRow(self.error_label)
-
-        self.login_button = QtWidgets.QPushButton("Login")
-        self.login_button.setToolTip("Log in shotgrid instance")
-        self.login_button.clicked.connect(self._on_shotgrid_login_clicked)
-
-        self.logout_button = QtWidgets.QPushButton("Logout")
-        self.logout_button.setToolTip("Log out shotgrid instance")
-        self.logout_button.clicked.connect(self._on_shotgrid_logout_clicked)
-
-        self.buttons_layout = QtWidgets.QHBoxLayout()
-        self.buttons_layout.addWidget(self.logout_button)
-        self.buttons_layout.addWidget(self.login_button)
-
-        self.main_widget = QtWidgets.QVBoxLayout(self)
-        self.main_widget.addLayout(self.input_layout)
-        self.main_widget.addLayout(self.buttons_layout)
-        self.setLayout(self.main_widget)
-
-    def show(self, *args, **kwargs):
-        super(CredentialsDialog, self).show(*args, **kwargs)
-        self._fill_shotgrid_url()
-        self._fill_shotgrid_login()
-
-    def _fill_shotgrid_url(self):
-        servers = settings.get_shotgrid_servers()
-
-        if servers:
-            for _, v in servers.items():
-                self.url_input.addItem("{}".format(v.get('shotgrid_url')))
-            self._valid_input(self.url_input)
-            self.login_button.show()
-            self.logout_button.show()
-            enabled = True
-        else:
-            self.set_error("Ask your admin to add shotgrid server in settings")
-            self._invalid_input(self.url_input)
-            self.login_button.hide()
-            self.logout_button.hide()
-            enabled = False
-
-        self.login_input.setEnabled(enabled)
-        self.password_input.setEnabled(enabled)
-
-    def _fill_shotgrid_login(self):
-        login = credentials.get_local_login()
-
-        if login:
-            self.login_input.setText(login)
-
-    def _clear_shotgrid_login(self):
-        self.login_input.setText("")
-        self.password_input.setText("")
-
-    def _on_shotgrid_login_clicked(self):
-        login = self.login_input.text().strip()
-        password = self.password_input.text().strip()
-        missing = []
-
-        if login == "":
-            missing.append("login")
-            self._invalid_input(self.login_input)
-
-        if password == "":
-            missing.append("password")
-            self._invalid_input(self.password_input)
-
-        url = self.url_input.currentText()
-        if url == "":
-            missing.append("url")
-            self._invalid_input(self.url_input)
-
-        if len(missing) > 0:
-            self.set_error("You didn't enter {}".format(" and ".join(missing)))
-            return
-
-        # if credentials.check_credentials(
-        #     login=login,
-        #     password=password,
-        #     shotgrid_url=url,
-        # ):
-        credentials.save_local_login(
-            login=login
-        )
-        os.environ['OPENPYPE_SG_USER'] = login
-        self._on_login()
-
-        self.set_error("CANT LOGIN")
-
-    def _on_shotgrid_logout_clicked(self):
-        credentials.clear_local_login()
-        del os.environ['OPENPYPE_SG_USER']
-        self._clear_shotgrid_login()
-        self._on_logout()
-
-    def set_error(self, msg):
-        self.error_label.setText(msg)
-        self.error_label.show()
-
-    def _on_login(self):
-        self._is_logged = True
-        self.login_changed.emit()
-        self._close_widget()
-
-    def _on_logout(self):
-        self._is_logged = False
-        self.login_changed.emit()
-
-    def _close_widget(self):
-        self.hide()
-
-    def _valid_input(self, input_widget):
-        input_widget.setStyleSheet("")
-
-    def _invalid_input(self, input_widget):
-        input_widget.setStyleSheet("border: 1px solid red;")
-
-    def login_with_credentials(
-        self, url, login, password
-    ):
-        verification = credentials.check_credentials(url, login, password)
-        if verification:
-            credentials.save_credentials(login, password, False)
-            self._module.set_credentials_to_env(login, password)
-            self.set_credentials(login, password)
-            self.login_changed.emit()
-        return verification
diff --git a/openpype/modules/shotgrid/tray/shotgrid_tray.py b/openpype/modules/shotgrid/tray/shotgrid_tray.py
deleted file mode 100644
index 4038d77b03..0000000000
--- a/openpype/modules/shotgrid/tray/shotgrid_tray.py
+++ /dev/null
@@ -1,75 +0,0 @@
-import os
-import webbrowser
-
-from Qt import QtWidgets
-
-from openpype.modules.shotgrid.lib import credentials
-from openpype.modules.shotgrid.tray.credential_dialog import (
-    CredentialsDialog,
-)
-
-
-class ShotgridTrayWrapper:
-    module = None
-    credentials_dialog = None
-    logged_user_label = None
-
-    def __init__(self, module):
-        self.module = module
-        self.credentials_dialog = CredentialsDialog(module)
-        self.credentials_dialog.login_changed.connect(self.set_login_label)
-        self.logged_user_label = QtWidgets.QAction("")
-        self.logged_user_label.setDisabled(True)
-        self.set_login_label()
-
-    def show_batch_dialog(self):
-        if self.module.leecher_manager_url:
-            webbrowser.open(self.module.leecher_manager_url)
-
-    def show_connect_dialog(self):
-        self.show_credential_dialog()
-
-    def show_credential_dialog(self):
-        self.credentials_dialog.show()
-        self.credentials_dialog.activateWindow()
-        self.credentials_dialog.raise_()
-
-    def set_login_label(self):
-        login = credentials.get_local_login()
-        if login:
-            self.logged_user_label.setText("{}".format(login))
-        else:
-            self.logged_user_label.setText(
-                "No User logged in {0}".format(login)
-            )
-
-    def tray_menu(self, tray_menu):
-        # Add login to user menu
-        menu = QtWidgets.QMenu("Shotgrid", tray_menu)
-        show_connect_action = QtWidgets.QAction("Connect to Shotgrid", menu)
-        show_connect_action.triggered.connect(self.show_connect_dialog)
-        menu.addAction(self.logged_user_label)
-        menu.addSeparator()
-        menu.addAction(show_connect_action)
-        tray_menu.addMenu(menu)
-
-        # Add manager to Admin menu
-        for m in tray_menu.findChildren(QtWidgets.QMenu):
-            if m.title() == "Admin":
-                shotgrid_manager_action = QtWidgets.QAction(
-                    "Shotgrid manager", menu
-                )
-                shotgrid_manager_action.triggered.connect(
-                    self.show_batch_dialog
-                )
-                m.addAction(shotgrid_manager_action)
-
-    def validate(self):
-        login = credentials.get_local_login()
-
-        if not login:
-            self.show_credential_dialog()
-        else:
-            os.environ["OPENPYPE_SG_USER"] = login
-
-        return True
diff --git a/openpype/resources/app_icons/shotgrid.png b/openpype/resources/app_icons/shotgrid.png
deleted file mode 100644
index 6d0cc047f9ed86e0db45ea557404ab7edb2f5bf2..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 45744
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
N8$~sR3OTc&{{b(fTU!7C

diff --git a/openpype/settings/defaults/project_settings/shotgrid.json b/openpype/settings/defaults/project_settings/shotgrid.json
deleted file mode 100644
index 83b6f69074..0000000000
--- a/openpype/settings/defaults/project_settings/shotgrid.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-    "shotgrid_project_id": 0,
-    "shotgrid_server": "",
-    "event": {
-        "enabled": false
-    },
-    "fields": {
-        "asset": {
-            "type": "sg_asset_type"
-        },
-        "sequence": {
-            "episode_link": "episode"
-        },
-        "shot": {
-            "episode_link": "sg_episode",
-            "sequence_link": "sg_sequence"
-        },
-        "task": {
-            "step": "step"
-        }
-    }
-}
diff --git a/openpype/settings/defaults/system_settings/modules.json b/openpype/settings/defaults/system_settings/modules.json
index 9d8910689a..8cd4114cb0 100644
--- a/openpype/settings/defaults/system_settings/modules.json
+++ b/openpype/settings/defaults/system_settings/modules.json
@@ -131,12 +131,6 @@
             }
         }
     },
-    "shotgrid": {
-        "enabled": false,
-        "leecher_manager_url": "http://127.0.0.1:3000",
-        "leecher_backend_url": "http://127.0.0.1:8090",
-        "shotgrid_settings": {}
-    },
     "kitsu": {
         "enabled": false,
         "server": ""
@@ -209,4 +203,4 @@
             "linux": ""
         }
     }
-}
+}
\ No newline at end of file
diff --git a/openpype/settings/entities/__init__.py b/openpype/settings/entities/__init__.py
index b2cb2204f4..a173e2454f 100644
--- a/openpype/settings/entities/__init__.py
+++ b/openpype/settings/entities/__init__.py
@@ -107,7 +107,6 @@ from .enum_entity import (
     TaskTypeEnumEntity,
     DeadlineUrlEnumEntity,
     AnatomyTemplatesEnumEntity,
-    ShotgridUrlEnumEntity
 )
 
 from .list_entity import ListEntity
@@ -172,7 +171,6 @@ __all__ = (
     "ToolsEnumEntity",
     "TaskTypeEnumEntity",
     "DeadlineUrlEnumEntity",
-    "ShotgridUrlEnumEntity",
     "AnatomyTemplatesEnumEntity",
 
     "ListEntity",
diff --git a/openpype/settings/entities/enum_entity.py b/openpype/settings/entities/enum_entity.py
index 3b3dd47e61..92a397afba 100644
--- a/openpype/settings/entities/enum_entity.py
+++ b/openpype/settings/entities/enum_entity.py
@@ -1,7 +1,10 @@
 import copy
 from .input_entities import InputEntity
 from .exceptions import EntitySchemaError
-from .lib import NOT_SET, STRING_TYPE
+from .lib import (
+    NOT_SET,
+    STRING_TYPE
+)
 
 
 class BaseEnumEntity(InputEntity):
@@ -23,7 +26,7 @@ class BaseEnumEntity(InputEntity):
         for item in self.enum_items:
             key = tuple(item.keys())[0]
             if key in enum_keys:
-                reason = 'Key "{}" is more than once in enum items.'.format(
+                reason = "Key \"{}\" is more than once in enum items.".format(
                     key
                 )
                 raise EntitySchemaError(self, reason)
@@ -31,7 +34,7 @@ class BaseEnumEntity(InputEntity):
             enum_keys.add(key)
 
             if not isinstance(key, STRING_TYPE):
-                reason = 'Key "{}" has invalid type {}, expected {}.'.format(
+                reason = "Key \"{}\" has invalid type {}, expected {}.".format(
                     key, type(key), STRING_TYPE
                 )
                 raise EntitySchemaError(self, reason)
@@ -56,7 +59,7 @@ class BaseEnumEntity(InputEntity):
         for item in check_values:
             if item not in self.valid_keys:
                 raise ValueError(
-                    '{} Invalid value "{}". Expected one of: {}'.format(
+                    "{} Invalid value \"{}\". Expected one of: {}".format(
                         self.path, item, self.valid_keys
                     )
                 )
@@ -81,7 +84,7 @@ class EnumEntity(BaseEnumEntity):
         self.valid_keys = set(all_keys)
 
         if self.multiselection:
-            self.valid_value_types = (list,)
+            self.valid_value_types = (list, )
             value_on_not_set = []
             if enum_default:
                 if not isinstance(enum_default, list):
@@ -106,7 +109,7 @@ class EnumEntity(BaseEnumEntity):
                         self.value_on_not_set = key
                         break
 
-            self.valid_value_types = (STRING_TYPE,)
+            self.valid_value_types = (STRING_TYPE, )
 
         # GUI attribute
         self.placeholder = self.schema_data.get("placeholder")
@@ -149,7 +152,6 @@ class HostsEnumEntity(BaseEnumEntity):
     Host name is not the same as application name. Host name defines
     implementation instead of application name.
     """
-
     schema_types = ["hosts-enum"]
     all_host_names = [
         "aftereffects",
@@ -167,7 +169,7 @@ class HostsEnumEntity(BaseEnumEntity):
         "tvpaint",
         "unreal",
         "standalonepublisher",
-        "webpublisher",
+        "webpublisher"
     ]
 
     def _item_initialization(self):
@@ -208,7 +210,7 @@ class HostsEnumEntity(BaseEnumEntity):
         self.valid_keys = valid_keys
 
         if self.multiselection:
-            self.valid_value_types = (list,)
+            self.valid_value_types = (list, )
             self.value_on_not_set = []
         else:
             for key in valid_keys:
@@ -216,7 +218,7 @@ class HostsEnumEntity(BaseEnumEntity):
                     self.value_on_not_set = key
                     break
 
-            self.valid_value_types = (STRING_TYPE,)
+            self.valid_value_types = (STRING_TYPE, )
 
         # GUI attribute
         self.placeholder = self.schema_data.get("placeholder")
@@ -224,10 +226,14 @@ class HostsEnumEntity(BaseEnumEntity):
     def schema_validations(self):
         if self.hosts_filter:
             enum_len = len(self.enum_items)
-            if enum_len == 0 or (enum_len == 1 and self.use_empty_value):
-                joined_filters = ", ".join(
-                    ['"{}"'.format(item) for item in self.hosts_filter]
-                )
+            if (
+                enum_len == 0
+                or (enum_len == 1 and self.use_empty_value)
+            ):
+                joined_filters = ", ".join([
+                    '"{}"'.format(item)
+                    for item in self.hosts_filter
+                ])
                 reason = (
                     "All host names were removed after applying"
                     " host filters. {}"
@@ -240,25 +246,24 @@ class HostsEnumEntity(BaseEnumEntity):
                     invalid_filters.add(item)
 
             if invalid_filters:
-                joined_filters = ", ".join(
-                    ['"{}"'.format(item) for item in self.hosts_filter]
-                )
-                expected_hosts = ", ".join(
-                    ['"{}"'.format(item) for item in self.all_host_names]
-                )
-                self.log.warning(
-                    (
-                        "Host filters containt invalid host names:"
-                        ' "{}" Expected values are {}'
-                    ).format(joined_filters, expected_hosts)
-                )
+                joined_filters = ", ".join([
+                    '"{}"'.format(item)
+                    for item in self.hosts_filter
+                ])
+                expected_hosts = ", ".join([
+                    '"{}"'.format(item)
+                    for item in self.all_host_names
+                ])
+                self.log.warning((
+                    "Host filters containt invalid host names:"
+                    " \"{}\" Expected values are {}"
+                ).format(joined_filters, expected_hosts))
 
         super(HostsEnumEntity, self).schema_validations()
 
 
 class AppsEnumEntity(BaseEnumEntity):
     """Enum of applications for project anatomy attributes."""
-
     schema_types = ["apps-enum"]
 
     def _item_initialization(self):
@@ -266,7 +271,7 @@ class AppsEnumEntity(BaseEnumEntity):
         self.value_on_not_set = []
         self.enum_items = []
         self.valid_keys = set()
-        self.valid_value_types = (list,)
+        self.valid_value_types = (list, )
         self.placeholder = None
 
     def _get_enum_values(self):
@@ -347,7 +352,7 @@ class ToolsEnumEntity(BaseEnumEntity):
         self.value_on_not_set = []
         self.enum_items = []
         self.valid_keys = set()
-        self.valid_value_types = (list,)
+        self.valid_value_types = (list, )
         self.placeholder = None
 
     def _get_enum_values(self):
@@ -404,10 +409,10 @@ class TaskTypeEnumEntity(BaseEnumEntity):
     def _item_initialization(self):
         self.multiselection = self.schema_data.get("multiselection", True)
         if self.multiselection:
-            self.valid_value_types = (list,)
+            self.valid_value_types = (list, )
             self.value_on_not_set = []
         else:
-            self.valid_value_types = (STRING_TYPE,)
+            self.valid_value_types = (STRING_TYPE, )
             self.value_on_not_set = ""
 
         self.enum_items = []
@@ -502,8 +507,7 @@ class DeadlineUrlEnumEntity(BaseEnumEntity):
         enum_items_list = []
         for server_name, url_entity in deadline_urls_entity.items():
             enum_items_list.append(
-                {server_name: "{}: {}".format(server_name, url_entity.value)}
-            )
+                {server_name: "{}: {}".format(server_name, url_entity.value)})
             valid_keys.add(server_name)
         return enum_items_list, valid_keys
 
@@ -526,50 +530,6 @@ class DeadlineUrlEnumEntity(BaseEnumEntity):
                 self._current_value = tuple(self.valid_keys)[0]
 
 
-class ShotgridUrlEnumEntity(BaseEnumEntity):
-    schema_types = ["shotgrid_url-enum"]
-
-    def _item_initialization(self):
-        self.multiselection = False
-
-        self.enum_items = []
-        self.valid_keys = set()
-
-        self.valid_value_types = (STRING_TYPE,)
-        self.value_on_not_set = ""
-
-        # GUI attribute
-        self.placeholder = self.schema_data.get("placeholder")
-
-    def _get_enum_values(self):
-        shotgrid_settings = self.get_entity_from_path(
-            "system_settings/modules/shotgrid/shotgrid_settings"
-        )
-
-        valid_keys = set()
-        enum_items_list = []
-        for server_name, settings in shotgrid_settings.items():
-            enum_items_list.append(
-                {
-                    server_name: "{}: {}".format(
-                        server_name, settings["shotgrid_url"].value
-                    )
-                }
-            )
-            valid_keys.add(server_name)
-        return enum_items_list, valid_keys
-
-    def set_override_state(self, *args, **kwargs):
-        super(ShotgridUrlEnumEntity, self).set_override_state(*args, **kwargs)
-
-        self.enum_items, self.valid_keys = self._get_enum_values()
-        if not self.valid_keys:
-            self._current_value = ""
-
-        elif self._current_value not in self.valid_keys:
-            self._current_value = tuple(self.valid_keys)[0]
-
-
 class AnatomyTemplatesEnumEntity(BaseEnumEntity):
     schema_types = ["anatomy-templates-enum"]
 
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_main.json b/openpype/settings/entities/schemas/projects_schema/schema_main.json
index 80b1baad1b..6c07209de3 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_main.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_main.json
@@ -62,10 +62,6 @@
                     "type": "schema",
                     "name": "schema_project_ftrack"
                 },
-                {
-                    "type": "schema",
-                    "name": "schema_project_shotgrid"
-                },
                 {
                     "type": "schema",
                     "name": "schema_project_kitsu"
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_shotgrid.json b/openpype/settings/entities/schemas/projects_schema/schema_project_shotgrid.json
deleted file mode 100644
index 4faeca89f3..0000000000
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_shotgrid.json
+++ /dev/null
@@ -1,98 +0,0 @@
-{
-    "type": "dict",
-    "key": "shotgrid",
-    "label": "Shotgrid",
-    "collapsible": true,
-    "is_file": true,
-    "children": [
-        {
-            "type": "number",
-            "key": "shotgrid_project_id",
-            "label": "Shotgrid project id"
-        },
-        {
-            "type": "shotgrid_url-enum",
-            "key": "shotgrid_server",
-            "label": "Shotgrid Server"
-        },
-        {
-            "type": "dict",
-            "key": "event",
-            "label": "Event Handler",
-            "collapsible": true,
-            "checkbox_key": "enabled",
-            "children": [
-                {
-                    "type": "boolean",
-                    "key": "enabled",
-                    "label": "Enabled"
-                }
-            ]
-        },
-        {
-            "type": "dict",
-            "key": "fields",
-            "label": "Fields Template",
-            "collapsible": true,
-            "children": [
-                {
-                    "type": "dict",
-                    "key": "asset",
-                    "label": "Asset",
-                    "collapsible": true,
-                    "children": [
-                        {
-                            "type": "text",
-                            "key": "type",
-                            "label": "Asset Type"
-                        }
-                    ]
-                },
-                {
-                    "type": "dict",
-                    "key": "sequence",
-                    "label": "Sequence",
-                    "collapsible": true,
-                    "children": [
-                        {
-                            "type": "text",
-                            "key": "episode_link",
-                            "label": "Episode link"
-                        }
-                    ]
-                },
-                {
-                    "type": "dict",
-                    "key": "shot",
-                    "label": "Shot",
-                    "collapsible": true,
-                    "children": [
-                        {
-                            "type": "text",
-                            "key": "episode_link",
-                            "label": "Episode link"
-                        },
-                        {
-                            "type": "text",
-                            "key": "sequence_link",
-                            "label": "Sequence link"
-                        }
-                    ]
-                },
-                {
-                    "type": "dict",
-                    "key": "task",
-                    "label": "Task",
-                    "collapsible": true,
-                    "children": [
-                        {
-                            "type": "text",
-                            "key": "step",
-                            "label": "Step link"
-                        }
-                    ]
-                }
-            ]
-        }
-    ]
-}
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
index a4b28f47bc..484fbf9d07 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_representation_tags.json
@@ -13,9 +13,6 @@
         {
             "ftrackreview": "Add review to Ftrack"
         },
-        {
-            "shotgridreview": "Add review to Shotgrid"
-        },
         {
             "delete": "Delete output"
         },
diff --git a/openpype/settings/entities/schemas/system_schema/schema_modules.json b/openpype/settings/entities/schemas/system_schema/schema_modules.json
index 952b38040c..d22b9016a7 100644
--- a/openpype/settings/entities/schemas/system_schema/schema_modules.json
+++ b/openpype/settings/entities/schemas/system_schema/schema_modules.json
@@ -48,60 +48,6 @@
             "type": "schema",
             "name": "schema_kitsu"
         },
-        {
-            "type": "dict",
-            "key": "shotgrid",
-            "label": "Shotgrid",
-            "collapsible": true,
-            "checkbox_key": "enabled",
-            "children": [
-                {
-                    "type": "boolean",
-                    "key": "enabled",
-                    "label": "Enabled"
-                },
-                {
-                    "type": "text",
-                    "key": "leecher_manager_url",
-                    "label": "Shotgrid Leecher Manager URL"
-                },
-                {
-                    "type": "text",
-                    "key": "leecher_backend_url",
-                    "label": "Shotgrid Leecher Backend URL"
-                },
-                {
-                    "type": "boolean",
-                    "key": "filter_projects_by_login",
-                    "label": "Filter projects by SG login"
-                },
-                {
-                    "type": "dict-modifiable",
-                    "key": "shotgrid_settings",
-                    "label": "Shotgrid Servers",
-                    "object_type": {
-                        "type": "dict",
-                        "children": [
-                            {
-                                "key": "shotgrid_url",
-                                "label": "Server URL",
-                                "type": "text"
-                            },
-                            {
-                                "key": "shotgrid_script_name",
-                                "label": "Script Name",
-                                "type": "text"
-                            },
-                            {
-                                "key": "shotgrid_script_key",
-                                "label": "Script api key",
-                                "type": "text"
-                            }
-                        ]
-                    }
-                }
-            ]
-        },
         {
             "type": "dict",
             "key": "timers_manager",
diff --git a/poetry.lock b/poetry.lock
index f6ccf1ffc9..47509f334e 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1362,21 +1362,6 @@ category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
-[[package]]
-name = "shotgun-api3"
-version = "3.3.3"
-description = "Shotgun Python API"
-category = "main"
-optional = false
-python-versions = "*"
-develop = false
-
-[package.source]
-type = "git"
-url = "https://github.com/shotgunsoftware/python-api.git"
-reference = "v3.3.3"
-resolved_reference = "b9f066c0edbea6e0733242e18f32f75489064840"
-
 [[package]]
 name = "six"
 version = "1.16.0"
@@ -2818,7 +2803,6 @@ semver = [
     {file = "semver-2.13.0-py2.py3-none-any.whl", hash = "sha256:ced8b23dceb22134307c1b8abfa523da14198793d9787ac838e70e29e77458d4"},
     {file = "semver-2.13.0.tar.gz", hash = "sha256:fa0fe2722ee1c3f57eac478820c3a5ae2f624af8264cbdf9000c980ff7f75e3f"},
 ]
-shotgun-api3 = []
 six = [
     {file = "six-1.16.0-py2.py3-none-any.whl", hash = "sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254"},
     {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"},
diff --git a/pyproject.toml b/pyproject.toml
index c68de91623..4b297fe042 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -40,7 +40,6 @@ clique = "1.6.*"
 Click = "^7"
 dnspython = "^2.1.0"
 ftrack-python-api = "2.0.*"
-shotgun_api3 = {git = "https://github.com/shotgunsoftware/python-api.git", rev = "v3.3.3"}
 gazu = "^0.8.28"
 google-api-python-client = "^1.12.8" # sync server google support (should be separate?)
 jsonschema = "^2.6.0"

From 6d4f05e3da277f11fc7614c340f63024f1997036 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 22 Jun 2022 14:12:05 +0200
Subject: [PATCH 0770/1227] added ability to pass asset name to
 'get_last_version_by_subset_name'

---
 openpype/client/entities.py | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 4b4a3729fe..9864fee469 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -789,14 +789,19 @@ def get_last_version_by_subset_id(project_name, subset_id, fields=None):
 
 
 def get_last_version_by_subset_name(
-    project_name, subset_name, asset_id, fields=None
+    project_name, subset_name, asset_id=None, asset_name=None, fields=None
 ):
-    """Last version for passed subset name under asset id.
+    """Last version for passed subset name under asset id/name.
+
+    It is required to pass 'asset_id' or 'asset_name'. Asset id is recommended
+    if is available.
 
     Args:
         project_name (str): Name of project where to look for queried entities.
         subset_name (str): Name of subset.
-        asset_id (str|ObjectId): Asset id which is parnt of passed subset name.
+        asset_id (str|ObjectId): Asset id which is parent of passed
+            subset name.
+        asset_name (str): Asset name which is parent of passed subset name.
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
@@ -805,6 +810,14 @@ def get_last_version_by_subset_name(
         Dict: Version document which can be reduced to specified 'fields'.
     """
 
+    if not asset_id and not asset_name:
+        return None
+
+    if not asset_id:
+        asset_doc = get_asset_by_name(project_name, asset_name, fields=["_id"])
+        if not asset_doc:
+            return None
+        asset_id = asset_doc["_id"]
     subset_doc = get_subset_by_name(
         project_name, subset_name, asset_id, fields=["_id"]
     )

From f43042eb169ad9214ad01511a3c4dee5fe469083 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 22 Jun 2022 15:12:40 +0300
Subject: [PATCH 0771/1227] Change hwFogEnable into fogging flag.

---
 .../projects_schema/schemas/schema_maya_capture.json | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index fa5be19cda..217aa947fc 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -268,7 +268,7 @@
                         },
                         {
                             "type": "boolean",
-                            "key": "hwFogEnable",
+                            "key": "fogging",
                             "label": "Enable Hardware Fog"
                         },
                         {
@@ -304,21 +304,11 @@
                         {
                             "type": "splitter"
                         },
-                        {
-                            "type": "boolean",
-                            "key": "motionBlurEnable",
-                            "label": "Enable Motion Blur"
-                        },
                         {
                             "type": "number",
                             "key": "motionBlurShutterOpenFraction",
                             "label": "Shutter Open Fraction"
                         },
-                        {
-                            "type": "number",
-                            "key": "motionBlurSampleCount",
-                            "label": "Sample Count"
-                        },
                         {
                             "type": "splitter"
                         },

From 8d849b7e08139b4e1a13db79f41cf35f43ef7893 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Wed, 22 Jun 2022 14:13:32 +0200
Subject: [PATCH 0772/1227] :recycle: remove unnecessary check

---
 .../hosts/maya/plugins/publish/extract_camera_mayaScene.py | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py b/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
index ac696ebdef..8d6c4b5f3c 100644
--- a/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
+++ b/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
@@ -181,16 +181,11 @@ class ExtractCameraMayaScene(openpype.api.Extractor):
                     # Fix PLN-178: Don't allow background color to be non-black
                     for cam, (attr, value) in itertools.product(cmds.ls(
                             baked_camera_shapes, type="camera", dag=True,
-                            shapes=True, long=True), attrs.items()):
-                        # the above call still pull in shapes that are not
-                        # cameras, so we filter them out here
-                        if cmds.nodeType(cam) != "camera":
-                            continue
+                            long=True), attrs.items()):
                         plug = "{0}.{1}".format(cam, attr)
                         unlock(plug)
                         cmds.setAttr(plug, value)
 
-
                     self.log.info("Performing extraction..")
                     cmds.select(cmds.ls(members, dag=True,
                                         shapes=True, long=True), noExpand=True)

From 4e59ae973e055953cbf77f0f9c8932120e0d19b2 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 22 Jun 2022 14:19:15 +0200
Subject: [PATCH 0773/1227] use query functions in loaders

---
 .../hosts/nuke/plugins/load/load_backdrop.py  | 35 ++++++++-------
 .../nuke/plugins/load/load_camera_abc.py      | 38 ++++++++--------
 openpype/hosts/nuke/plugins/load/load_clip.py | 37 +++++++--------
 .../hosts/nuke/plugins/load/load_effects.py   | 35 ++++++++-------
 .../nuke/plugins/load/load_effects_ip.py      | 33 +++++++-------
 .../hosts/nuke/plugins/load/load_gizmo.py     | 34 +++++++-------
 .../hosts/nuke/plugins/load/load_gizmo_ip.py  | 34 +++++++-------
 .../hosts/nuke/plugins/load/load_image.py     | 34 +++++++-------
 .../hosts/nuke/plugins/load/load_model.py     | 38 ++++++++--------
 .../nuke/plugins/load/load_script_precomp.py  | 45 +++++++++----------
 10 files changed, 183 insertions(+), 180 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/load/load_backdrop.py b/openpype/hosts/nuke/plugins/load/load_backdrop.py
index 143fdf1f30..164ab6f9f4 100644
--- a/openpype/hosts/nuke/plugins/load/load_backdrop.py
+++ b/openpype/hosts/nuke/plugins/load/load_backdrop.py
@@ -1,6 +1,10 @@
 import nuke
 import nukescripts
 
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id,
+)
 from openpype.pipeline import (
     legacy_io,
     load,
@@ -188,18 +192,17 @@ class LoadBackdropNodes(load.LoaderPlugin):
 
         # get main variables
         # Get version from io
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
+        project_name = legacy_io.active_project()
+        version_doc = get_version_by_id(project_name, representation["parent"])
+
         # get corresponding node
         GN = nuke.toNode(container['objectName'])
 
         file = get_representation_path(representation).replace("\\", "/")
-        context = representation["context"]
+
         name = container['name']
-        version_data = version.get("data", {})
-        vname = version.get("name", None)
+        version_data = version_doc.get("data", {})
+        vname = version_doc.get("name", None)
         first = version_data.get("frameStart", None)
         last = version_data.get("frameEnd", None)
         namespace = container['namespace']
@@ -237,20 +240,18 @@ class LoadBackdropNodes(load.LoaderPlugin):
             GN["name"].setValue(object_name)
 
         # get all versions in list
-        versions = legacy_io.find({
-            "type": "version",
-            "parent": version["parent"]
-        }).distinct('name')
-
-        max_version = max(versions)
+        last_version_doc = get_last_version_by_subset_id(
+            project_name, version_doc["parent"], fields=["_id"]
+        )
 
         # change color of node
-        if version.get("name") not in [max_version]:
-            GN["tile_color"].setValue(int("0xd88467ff", 16))
+        if version_doc["_id"] == last_version_doc["_id"]:
+            color_value = self.node_color
         else:
-            GN["tile_color"].setValue(int(self.node_color, 16))
+            color_value = "0xd88467ff"
+        GN["tile_color"].setValue(int(color_value, 16))
 
-        self.log.info("updated to version: {}".format(version.get("name")))
+        self.log.info("updated to version: {}".format(version_doc.get("name")))
 
         return update_container(GN, data_imprint)
 
diff --git a/openpype/hosts/nuke/plugins/load/load_camera_abc.py b/openpype/hosts/nuke/plugins/load/load_camera_abc.py
index 964ca5ec90..f5dfc8c0ab 100644
--- a/openpype/hosts/nuke/plugins/load/load_camera_abc.py
+++ b/openpype/hosts/nuke/plugins/load/load_camera_abc.py
@@ -1,5 +1,9 @@
 import nuke
 
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id
+)
 from openpype.pipeline import (
     legacy_io,
     load,
@@ -102,17 +106,16 @@ class AlembicCameraLoader(load.LoaderPlugin):
             None
         """
         # Get version from io
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
+        project_name = legacy_io.active_project()
+        version_doc = get_version_by_id(project_name, representation["parent"])
+
         object_name = container['objectName']
         # get corresponding node
         camera_node = nuke.toNode(object_name)
 
         # get main variables
-        version_data = version.get("data", {})
-        vname = version.get("name", None)
+        version_data = version_doc.get("data", {})
+        vname = version_doc.get("name", None)
         first = version_data.get("frameStart", None)
         last = version_data.get("frameEnd", None)
         fps = version_data.get("fps") or nuke.root()["fps"].getValue()
@@ -165,28 +168,27 @@ class AlembicCameraLoader(load.LoaderPlugin):
                 d.setInput(index, camera_node)
 
         # color node by correct color by actual version
-        self.node_version_color(version, camera_node)
+        self.node_version_color(version_doc, camera_node)
 
-        self.log.info("updated to version: {}".format(version.get("name")))
+        self.log.info("updated to version: {}".format(version_doc.get("name")))
 
         return update_container(camera_node, data_imprint)
 
-    def node_version_color(self, version, node):
+    def node_version_color(self, version_doc, node):
         """ Coloring a node by correct color by actual version
         """
         # get all versions in list
-        versions = legacy_io.find({
-            "type": "version",
-            "parent": version["parent"]
-        }).distinct('name')
-
-        max_version = max(versions)
+        project_name = legacy_io.active_project()
+        last_version_doc = get_last_version_by_subset_id(
+            project_name, version_doc["parent"], fields=["_id"]
+        )
 
         # change color of node
-        if version.get("name") not in [max_version]:
-            node["tile_color"].setValue(int("0xd88467ff", 16))
+        if version_doc["_id"] == last_version_doc["_id"]:
+            color_value = self.node_color
         else:
-            node["tile_color"].setValue(int(self.node_color, 16))
+            color_value = "0xd88467ff"
+        node["tile_color"].setValue(int(color_value, 16))
 
     def switch(self, container, representation):
         self.update(container, representation)
diff --git a/openpype/hosts/nuke/plugins/load/load_clip.py b/openpype/hosts/nuke/plugins/load/load_clip.py
index 681561e303..d177e6ba76 100644
--- a/openpype/hosts/nuke/plugins/load/load_clip.py
+++ b/openpype/hosts/nuke/plugins/load/load_clip.py
@@ -1,6 +1,10 @@
 import nuke
 import qargparse
 
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id,
+)
 from openpype.pipeline import (
     legacy_io,
     get_representation_path,
@@ -196,11 +200,10 @@ class LoadClip(plugin.NukeLoader):
 
         start_at_workfile = bool("start at" in read_node['frame_mode'].value())
 
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
-        version_data = version.get("data", {})
+        project_name = legacy_io.active_project()
+        version_doc = get_version_by_id(project_name, representation["parent"])
+
+        version_data = version_doc.get("data", {})
         repre_id = representation["_id"]
 
         repre_cont = representation["context"]
@@ -251,7 +254,7 @@ class LoadClip(plugin.NukeLoader):
                 "representation": str(representation["_id"]),
                 "frameStart": str(first),
                 "frameEnd": str(last),
-                "version": str(version.get("name")),
+                "version": str(version_doc.get("name")),
                 "db_colorspace": colorspace,
                 "source": version_data.get("source"),
                 "handleStart": str(self.handle_start),
@@ -264,26 +267,24 @@ class LoadClip(plugin.NukeLoader):
             if used_colorspace:
                 updated_dict["used_colorspace"] = used_colorspace
 
+            last_version_doc = get_last_version_by_subset_id(
+                project_name, version_doc["parent"], fields=["_id"]
+            )
             # change color of read_node
-            # get all versions in list
-            versions = legacy_io.find({
-                "type": "version",
-                "parent": version["parent"]
-            }).distinct('name')
-
-            max_version = max(versions)
-
-            if version.get("name") not in [max_version]:
-                read_node["tile_color"].setValue(int("0xd84f20ff", 16))
+            if version_doc["_id"] == last_version_doc["_id"]:
+                color_value = "0x4ecd25ff"
             else:
-                read_node["tile_color"].setValue(int("0x4ecd25ff", 16))
+                color_value = "0xd84f20ff"
+            read_node["tile_color"].setValue(int(color_value, 16))
 
             # Update the imprinted representation
             update_container(
                 read_node,
                 updated_dict
             )
-            self.log.info("updated to version: {}".format(version.get("name")))
+            self.log.info(
+                "updated to version: {}".format(version_doc.get("name"))
+            )
 
         if version_data.get("retime", None):
             self._make_retimes(read_node, version_data)
diff --git a/openpype/hosts/nuke/plugins/load/load_effects.py b/openpype/hosts/nuke/plugins/load/load_effects.py
index 6a30330ed0..d164e0604c 100644
--- a/openpype/hosts/nuke/plugins/load/load_effects.py
+++ b/openpype/hosts/nuke/plugins/load/load_effects.py
@@ -3,6 +3,10 @@ from collections import OrderedDict
 import nuke
 import six
 
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id,
+)
 from openpype.pipeline import (
     legacy_io,
     load,
@@ -148,17 +152,16 @@ class LoadEffects(load.LoaderPlugin):
         """
         # get main variables
         # Get version from io
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
+        project_name = legacy_io.active_project()
+        version_doc = get_version_by_id(project_name, representation["parent"])
+
         # get corresponding node
         GN = nuke.toNode(container['objectName'])
 
         file = get_representation_path(representation).replace("\\", "/")
         name = container['name']
-        version_data = version.get("data", {})
-        vname = version.get("name", None)
+        version_data = version_doc.get("data", {})
+        vname = version_doc.get("name", None)
         first = version_data.get("frameStart", None)
         last = version_data.get("frameEnd", None)
         workfile_first_frame = int(nuke.root()["first_frame"].getValue())
@@ -243,21 +246,19 @@ class LoadEffects(load.LoaderPlugin):
         # try to find parent read node
         self.connect_read_node(GN, namespace, json_f["assignTo"])
 
-        # get all versions in list
-        versions = legacy_io.find({
-            "type": "version",
-            "parent": version["parent"]
-        }).distinct('name')
-
-        max_version = max(versions)
+        last_version_doc = get_last_version_by_subset_id(
+            project_name, version_doc["parent"], fields=["_id"]
+        )
 
         # change color of node
-        if version.get("name") not in [max_version]:
-            GN["tile_color"].setValue(int("0xd84f20ff", 16))
+        if version_doc["_id"] == last_version_doc["_id"]:
+            color_value = "0x3469ffff"
         else:
-            GN["tile_color"].setValue(int("0x3469ffff", 16))
+            color_value = "0xd84f20ff"
 
-        self.log.info("updated to version: {}".format(version.get("name")))
+        GN["tile_color"].setValue(int(color_value, 16))
+
+        self.log.info("updated to version: {}".format(version_doc.get("name")))
 
     def connect_read_node(self, group_node, asset, subset):
         """
diff --git a/openpype/hosts/nuke/plugins/load/load_effects_ip.py b/openpype/hosts/nuke/plugins/load/load_effects_ip.py
index eaf151b3b8..44565c139d 100644
--- a/openpype/hosts/nuke/plugins/load/load_effects_ip.py
+++ b/openpype/hosts/nuke/plugins/load/load_effects_ip.py
@@ -3,6 +3,10 @@ from collections import OrderedDict
 import six
 import nuke
 
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id,
+)
 from openpype.pipeline import (
     legacy_io,
     load,
@@ -153,17 +157,16 @@ class LoadEffectsInputProcess(load.LoaderPlugin):
 
         # get main variables
         # Get version from io
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
+        project_name = legacy_io.active_project()
+        version_doc = get_version_by_id(project_name, representation["parent"])
+
         # get corresponding node
         GN = nuke.toNode(container['objectName'])
 
         file = get_representation_path(representation).replace("\\", "/")
         name = container['name']
-        version_data = version.get("data", {})
-        vname = version.get("name", None)
+        version_data = version_doc.get("data", {})
+        vname = version_doc.get("name", None)
         first = version_data.get("frameStart", None)
         last = version_data.get("frameEnd", None)
         workfile_first_frame = int(nuke.root()["first_frame"].getValue())
@@ -251,20 +254,18 @@ class LoadEffectsInputProcess(load.LoaderPlugin):
         #     return
 
         # get all versions in list
-        versions = legacy_io.find({
-            "type": "version",
-            "parent": version["parent"]
-        }).distinct('name')
-
-        max_version = max(versions)
+        last_version_doc = get_last_version_by_subset_id(
+            project_name, version_doc["parent"], fields=["_id"]
+        )
 
         # change color of node
-        if version.get("name") not in [max_version]:
-            GN["tile_color"].setValue(int("0xd84f20ff", 16))
+        if version_doc["_id"] == last_version_doc["_id"]:
+            color_value = "0x3469ffff"
         else:
-            GN["tile_color"].setValue(int("0x3469ffff", 16))
+            color_value = "0xd84f20ff"
+        GN["tile_color"].setValue(int(color_value, 16))
 
-        self.log.info("updated to version: {}".format(version.get("name")))
+        self.log.info("updated to version: {}".format(version_doc.get("name")))
 
     def connect_active_viewer(self, group_node):
         """
diff --git a/openpype/hosts/nuke/plugins/load/load_gizmo.py b/openpype/hosts/nuke/plugins/load/load_gizmo.py
index 4ea9d64d7d..9a18eeef5c 100644
--- a/openpype/hosts/nuke/plugins/load/load_gizmo.py
+++ b/openpype/hosts/nuke/plugins/load/load_gizmo.py
@@ -1,5 +1,9 @@
 import nuke
 
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id,
+)
 from openpype.pipeline import (
     legacy_io,
     load,
@@ -101,17 +105,16 @@ class LoadGizmo(load.LoaderPlugin):
 
         # get main variables
         # Get version from io
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
+        project_name = legacy_io.active_project()
+        version_doc = get_version_by_id(project_name, representation["parent"])
+
         # get corresponding node
         GN = nuke.toNode(container['objectName'])
 
         file = get_representation_path(representation).replace("\\", "/")
         name = container['name']
-        version_data = version.get("data", {})
-        vname = version.get("name", None)
+        version_data = version_doc.get("data", {})
+        vname = version_doc.get("name", None)
         first = version_data.get("frameStart", None)
         last = version_data.get("frameEnd", None)
         namespace = container['namespace']
@@ -148,21 +151,18 @@ class LoadGizmo(load.LoaderPlugin):
             GN.setXYpos(xpos, ypos)
             GN["name"].setValue(object_name)
 
-        # get all versions in list
-        versions = legacy_io.find({
-            "type": "version",
-            "parent": version["parent"]
-        }).distinct('name')
-
-        max_version = max(versions)
+        last_version_doc = get_last_version_by_subset_id(
+            project_name, version_doc["parent"], fields=["_id"]
+        )
 
         # change color of node
-        if version.get("name") not in [max_version]:
-            GN["tile_color"].setValue(int("0xd88467ff", 16))
+        if version_doc["_id"] == last_version_doc["_id"]:
+            color_value = self.node_color
         else:
-            GN["tile_color"].setValue(int(self.node_color, 16))
+            color_value = "0xd88467ff"
+        GN["tile_color"].setValue(int(color_value, 16))
 
-        self.log.info("updated to version: {}".format(version.get("name")))
+        self.log.info("updated to version: {}".format(version_doc.get("name")))
 
         return update_container(GN, data_imprint)
 
diff --git a/openpype/hosts/nuke/plugins/load/load_gizmo_ip.py b/openpype/hosts/nuke/plugins/load/load_gizmo_ip.py
index 38dd70935e..2890dbfd2c 100644
--- a/openpype/hosts/nuke/plugins/load/load_gizmo_ip.py
+++ b/openpype/hosts/nuke/plugins/load/load_gizmo_ip.py
@@ -1,6 +1,10 @@
 import nuke
 import six
 
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id,
+)
 from openpype.pipeline import (
     legacy_io,
     load,
@@ -108,17 +112,16 @@ class LoadGizmoInputProcess(load.LoaderPlugin):
 
         # get main variables
         # Get version from io
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
+        project_name = legacy_io.active_project()
+        version_doc = get_version_by_id(project_name, representation["parent"])
+
         # get corresponding node
         GN = nuke.toNode(container['objectName'])
 
         file = get_representation_path(representation).replace("\\", "/")
         name = container['name']
-        version_data = version.get("data", {})
-        vname = version.get("name", None)
+        version_data = version_doc.get("data", {})
+        vname = version_doc.get("name", None)
         first = version_data.get("frameStart", None)
         last = version_data.get("frameEnd", None)
         namespace = container['namespace']
@@ -155,21 +158,18 @@ class LoadGizmoInputProcess(load.LoaderPlugin):
             GN.setXYpos(xpos, ypos)
             GN["name"].setValue(object_name)
 
-        # get all versions in list
-        versions = legacy_io.find({
-            "type": "version",
-            "parent": version["parent"]
-        }).distinct('name')
-
-        max_version = max(versions)
+        last_version_doc = get_last_version_by_subset_id(
+            project_name, version_doc["parent"], fields=["_id"]
+        )
 
         # change color of node
-        if version.get("name") not in [max_version]:
-            GN["tile_color"].setValue(int("0xd88467ff", 16))
+        if version_doc["_id"] == last_version_doc["_id"]:
+            color_value = self.node_color
         else:
-            GN["tile_color"].setValue(int(self.node_color, 16))
+            color_value = "0xd88467ff"
+        GN["tile_color"].setValue(int(color_value, 16))
 
-        self.log.info("updated to version: {}".format(version.get("name")))
+        self.log.info("updated to version: {}".format(version_doc.get("name")))
 
         return update_container(GN, data_imprint)
 
diff --git a/openpype/hosts/nuke/plugins/load/load_image.py b/openpype/hosts/nuke/plugins/load/load_image.py
index 6df286a4f7..3e81ef999b 100644
--- a/openpype/hosts/nuke/plugins/load/load_image.py
+++ b/openpype/hosts/nuke/plugins/load/load_image.py
@@ -2,6 +2,10 @@ import nuke
 
 import qargparse
 
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id,
+)
 from openpype.pipeline import (
     legacy_io,
     load,
@@ -186,20 +190,13 @@ class LoadImage(load.LoaderPlugin):
                 format(frame_number, "0{}".format(padding)))
 
         # Get start frame from version data
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
+        project_name = legacy_io.active_project()
+        version_doc = get_version_by_id(project_name, representation["parent"])
+        last_version_doc = get_last_version_by_subset_id(
+            project_name, version_doc["parent"], fields=["_id"]
+        )
 
-        # get all versions in list
-        versions = legacy_io.find({
-            "type": "version",
-            "parent": version["parent"]
-        }).distinct('name')
-
-        max_version = max(versions)
-
-        version_data = version.get("data", {})
+        version_data = version_doc.get("data", {})
 
         last = first = int(frame_number)
 
@@ -215,7 +212,7 @@ class LoadImage(load.LoaderPlugin):
             "representation": str(representation["_id"]),
             "frameStart": str(first),
             "frameEnd": str(last),
-            "version": str(version.get("name")),
+            "version": str(version_doc.get("name")),
             "colorspace": version_data.get("colorspace"),
             "source": version_data.get("source"),
             "fps": str(version_data.get("fps")),
@@ -223,17 +220,18 @@ class LoadImage(load.LoaderPlugin):
         })
 
         # change color of node
-        if version.get("name") not in [max_version]:
-            node["tile_color"].setValue(int("0xd84f20ff", 16))
+        if version_doc["_id"] == last_version_doc["_id"]:
+            color_value = "0x4ecd25ff"
         else:
-            node["tile_color"].setValue(int("0x4ecd25ff", 16))
+            color_value = "0xd84f20ff"
+        node["tile_color"].setValue(int(color_value, 16))
 
         # Update the imprinted representation
         update_container(
             node,
             updated_dict
         )
-        self.log.info("updated to version: {}".format(version.get("name")))
+        self.log.info("updated to version: {}".format(version_doc.get("name")))
 
     def remove(self, container):
         node = nuke.toNode(container['objectName'])
diff --git a/openpype/hosts/nuke/plugins/load/load_model.py b/openpype/hosts/nuke/plugins/load/load_model.py
index 2f54595cb0..c317b15450 100644
--- a/openpype/hosts/nuke/plugins/load/load_model.py
+++ b/openpype/hosts/nuke/plugins/load/load_model.py
@@ -1,5 +1,9 @@
 import nuke
 
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id,
+)
 from openpype.pipeline import (
     legacy_io,
     load,
@@ -100,17 +104,15 @@ class AlembicModelLoader(load.LoaderPlugin):
             None
         """
         # Get version from io
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
+        project_name = legacy_io.active_project()
+        version_doc = get_version_by_id(project_name, representation["parent"])
         object_name = container['objectName']
         # get corresponding node
         model_node = nuke.toNode(object_name)
 
         # get main variables
-        version_data = version.get("data", {})
-        vname = version.get("name", None)
+        version_data = version_doc.get("data", {})
+        vname = version_doc.get("name", None)
         first = version_data.get("frameStart", None)
         last = version_data.get("frameEnd", None)
         fps = version_data.get("fps") or nuke.root()["fps"].getValue()
@@ -163,28 +165,26 @@ class AlembicModelLoader(load.LoaderPlugin):
                 d.setInput(index, model_node)
 
         # color node by correct color by actual version
-        self.node_version_color(version, model_node)
+        self.node_version_color(version_doc, model_node)
 
-        self.log.info("updated to version: {}".format(version.get("name")))
+        self.log.info("updated to version: {}".format(version_doc.get("name")))
 
         return update_container(model_node, data_imprint)
 
     def node_version_color(self, version, node):
-        """ Coloring a node by correct color by actual version
-        """
-        # get all versions in list
-        versions = legacy_io.find({
-            "type": "version",
-            "parent": version["parent"]
-        }).distinct('name')
+        """ Coloring a node by correct color by actual version"""
 
-        max_version = max(versions)
+        project_name = legacy_io.active_project()
+        last_version_doc = get_last_version_by_subset_id(
+            project_name, version["parent"], fields=["_id"]
+        )
 
         # change color of node
-        if version.get("name") not in [max_version]:
-            node["tile_color"].setValue(int("0xd88467ff", 16))
+        if version["_id"] == last_version_doc["_id"]:
+            color_value = self.node_color
         else:
-            node["tile_color"].setValue(int(self.node_color, 16))
+            color_value = "0xd88467ff"
+        node["tile_color"].setValue(int(color_value, 16))
 
     def switch(self, container, representation):
         self.update(container, representation)
diff --git a/openpype/hosts/nuke/plugins/load/load_script_precomp.py b/openpype/hosts/nuke/plugins/load/load_script_precomp.py
index bd351ad785..21e384b538 100644
--- a/openpype/hosts/nuke/plugins/load/load_script_precomp.py
+++ b/openpype/hosts/nuke/plugins/load/load_script_precomp.py
@@ -1,5 +1,9 @@
 import nuke
 
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id,
+)
 from openpype.pipeline import (
     legacy_io,
     load,
@@ -116,29 +120,23 @@ class LinkAsGroup(load.LoaderPlugin):
         root = get_representation_path(representation).replace("\\", "/")
 
         # Get start frame from version data
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
-
-        # get all versions in list
-        versions = legacy_io.find({
-            "type": "version",
-            "parent": version["parent"]
-        }).distinct('name')
-
-        max_version = max(versions)
+        project_name = legacy_io.active_project()
+        version_doc = get_version_by_id(project_name, representation["parent"])
+        last_version_doc = get_last_version_by_subset_id(
+            project_name, version_doc["parent"], fields=["_id"]
+        )
 
         updated_dict = {}
+        version_data = version_doc["data"]
         updated_dict.update({
             "representation": str(representation["_id"]),
-            "frameEnd": version["data"].get("frameEnd"),
-            "version": version.get("name"),
-            "colorspace": version["data"].get("colorspace"),
-            "source": version["data"].get("source"),
-            "handles": version["data"].get("handles"),
-            "fps": version["data"].get("fps"),
-            "author": version["data"].get("author")
+            "frameEnd": version_data.get("frameEnd"),
+            "version": version_doc.get("name"),
+            "colorspace": version_data.get("colorspace"),
+            "source": version_data.get("source"),
+            "handles": version_data.get("handles"),
+            "fps": version_data.get("fps"),
+            "author": version_data.get("author")
         })
 
         # Update the imprinted representation
@@ -150,12 +148,13 @@ class LinkAsGroup(load.LoaderPlugin):
         node["file"].setValue(root)
 
         # change color of node
-        if version.get("name") not in [max_version]:
-            node["tile_color"].setValue(int("0xd84f20ff", 16))
+        if version_doc["_id"] == last_version_doc["_id"]:
+            color_value = "0xff0ff0ff"
         else:
-            node["tile_color"].setValue(int("0xff0ff0ff", 16))
+            color_value = "0xd84f20ff"
+        node["tile_color"].setValue(int(color_value, 16))
 
-        self.log.info("updated to version: {}".format(version.get("name")))
+        self.log.info("updated to version: {}".format(version_doc.get("name")))
 
     def remove(self, container):
         node = nuke.toNode(container['objectName'])

From f919c24989739e40e46028b3dfdd82642e38507c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 22 Jun 2022 14:20:05 +0200
Subject: [PATCH 0774/1227] remove unnecessary query of asset document

---
 .../hosts/nuke/plugins/publish/precollect_instances.py     | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/precollect_instances.py b/openpype/hosts/nuke/plugins/publish/precollect_instances.py
index 8bf7280cea..4b3b70fa12 100644
--- a/openpype/hosts/nuke/plugins/publish/precollect_instances.py
+++ b/openpype/hosts/nuke/plugins/publish/precollect_instances.py
@@ -1,7 +1,6 @@
 import nuke
 import pyblish.api
 
-from openpype.pipeline import legacy_io
 from openpype.hosts.nuke.api.lib import (
     add_publish_knob,
     get_avalon_knob_data
@@ -20,12 +19,6 @@ class PreCollectNukeInstances(pyblish.api.ContextPlugin):
     sync_workfile_version_on_families = []
 
     def process(self, context):
-        asset_data = legacy_io.find_one({
-            "type": "asset",
-            "name": legacy_io.Session["AVALON_ASSET"]
-        })
-
-        self.log.debug("asset_data: {}".format(asset_data["data"]))
         instances = []
 
         root = nuke.root()

From 2ce3200fa5579fc18963f0e25023156179c3996d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 22 Jun 2022 14:21:22 +0200
Subject: [PATCH 0775/1227] use query functions in validate script plugin

---
 .../nuke/plugins/publish/validate_script.py   | 56 +++++++++++++++----
 1 file changed, 44 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/validate_script.py b/openpype/hosts/nuke/plugins/publish/validate_script.py
index 10c9e93f8b..9bda0da85e 100644
--- a/openpype/hosts/nuke/plugins/publish/validate_script.py
+++ b/openpype/hosts/nuke/plugins/publish/validate_script.py
@@ -1,5 +1,6 @@
 import pyblish.api
 
+from openpype.client import get_project, get_asset_by_id
 from openpype import lib
 from openpype.pipeline import legacy_io
 
@@ -19,6 +20,7 @@ class ValidateScript(pyblish.api.InstancePlugin):
         asset_name = ctx_data["asset"]
         asset = lib.get_asset(asset_name)
         asset_data = asset["data"]
+        project_name = legacy_io.active_project()
 
         # These attributes will be checked
         attributes = [
@@ -48,12 +50,19 @@ class ValidateScript(pyblish.api.InstancePlugin):
                 asset_attributes[attr] = asset_data[attr]
 
             elif attr in hierarchical_attributes:
-                # Try to find fps on parent
-                parent = asset['parent']
-                if asset_data['visualParent'] is not None:
-                    parent = asset_data['visualParent']
+                # TODO this should be probably removed
+                #   Hierarchical attributes is not a thing since Pype 2?
 
-                value = self.check_parent_hierarchical(parent, attr)
+                # Try to find attribute on parent
+                parent_id = asset['parent']
+                parent_type = "project"
+                if asset_data['visualParent'] is not None:
+                    parent_type = "asset"
+                    parent_id = asset_data['visualParent']
+
+                value = self.check_parent_hierarchical(
+                    project_name, parent_type, parent_id, attr
+                )
                 if value is None:
                     missing_attributes.append(attr)
                 else:
@@ -113,12 +122,35 @@ class ValidateScript(pyblish.api.InstancePlugin):
             message = msg.format(", ".join(not_matching))
             raise ValueError(message)
 
-    def check_parent_hierarchical(self, entityId, attr):
-        if entityId is None:
+    def check_parent_hierarchical(
+        self, project_name, parent_type, parent_id, attr
+    ):
+        if parent_id is None:
             return None
-        entity = legacy_io.find_one({"_id": entityId})
-        if attr in entity['data']:
+
+        doc = None
+        if parent_type == "project":
+            doc = get_project(project_name)
+        elif parent_type == "asset":
+            doc = get_asset_by_id(project_name, parent_id)
+
+        if not doc:
+            return None
+
+        doc_data = doc["data"]
+        if attr in doc_data:
             self.log.info(attr)
-            return entity['data'][attr]
-        else:
-            return self.check_parent_hierarchical(entity['parent'], attr)
+            return doc_data[attr]
+
+        if parent_type == "project":
+            return None
+
+        parent_id = doc_data.get("visualParent")
+        new_parent_type = "asset"
+        if parent_id is None:
+            parent_id = doc["parent"]
+            new_parent_type = "project"
+
+        return self.check_parent_hierarchical(
+            project_name, new_parent_type, parent_id, attr
+        )

From 796f32bccdfd171dc8f768227bcdff4d41c53e8d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 22 Jun 2022 14:23:35 +0200
Subject: [PATCH 0776/1227] use query functions in publish plugins

---
 .../nuke/plugins/publish/collect_reads.py     | 12 ++++-----
 .../nuke/plugins/publish/precollect_writes.py | 26 ++++++++++++++-----
 2 files changed, 25 insertions(+), 13 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/collect_reads.py b/openpype/hosts/nuke/plugins/publish/collect_reads.py
index 4d6944f523..b79d9646d5 100644
--- a/openpype/hosts/nuke/plugins/publish/collect_reads.py
+++ b/openpype/hosts/nuke/plugins/publish/collect_reads.py
@@ -3,6 +3,7 @@ import re
 import nuke
 import pyblish.api
 
+from openpype.client import get_asset_by_name
 from openpype.pipeline import legacy_io
 
 
@@ -16,12 +17,11 @@ class CollectNukeReads(pyblish.api.InstancePlugin):
     families = ["source"]
 
     def process(self, instance):
-        asset_data = legacy_io.find_one({
-            "type": "asset",
-            "name": legacy_io.Session["AVALON_ASSET"]
-        })
+        project_name = legacy_io.active_project()
+        asset_name = legacy_io.Session["AVALON_ASSET"]
+        asset_doc = get_asset_by_name(project_name, asset_name)
 
-        self.log.debug("asset_data: {}".format(asset_data["data"]))
+        self.log.debug("asset_doc: {}".format(asset_doc["data"]))
 
         self.log.debug("checking instance: {}".format(instance))
 
@@ -127,7 +127,7 @@ class CollectNukeReads(pyblish.api.InstancePlugin):
             "frameStart": first_frame,
             "frameEnd": last_frame,
             "colorspace": colorspace,
-            "handles": int(asset_data["data"].get("handles", 0)),
+            "handles": int(asset_doc["data"].get("handles", 0)),
             "step": 1,
             "fps": int(nuke.root()['fps'].value())
         })
diff --git a/openpype/hosts/nuke/plugins/publish/precollect_writes.py b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
index 7e50679ed5..a7c07975e2 100644
--- a/openpype/hosts/nuke/plugins/publish/precollect_writes.py
+++ b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
@@ -4,7 +4,10 @@ from pprint import pformat
 import nuke
 import pyblish.api
 
-import openpype.api as pype
+from openpype.client import (
+    get_last_version_by_subset_name,
+    get_representations,
+)
 from openpype.pipeline import (
     legacy_io,
     get_representation_path,
@@ -180,17 +183,26 @@ class CollectNukeWrites(pyblish.api.InstancePlugin):
             if not instance.data["review"]:
                 instance.data["useSequenceForReview"] = False
 
+        project_name = legacy_io.active_project()
+        asset_name = instance.data["asset"]
         # * Add audio to instance if exists.
         # Find latest versions document
-        version_doc = pype.get_latest_version(
-            instance.data["asset"], "audioMain"
+        last_version_doc = get_last_version_by_subset_name(
+            project_name, "audioMain", asset_name=asset_name, fields=["_id"]
         )
+
         repre_doc = None
-        if version_doc:
+        if last_version_doc:
             # Try to find it's representation (Expected there is only one)
-            repre_doc = legacy_io.find_one(
-                {"type": "representation", "parent": version_doc["_id"]}
-            )
+            repre_docs = list(get_representations(
+                project_name, version_ids=[last_version_doc["_id"]]
+            ))
+            if not repre_docs:
+                self.log.warning(
+                    "Version document does not contain any representations"
+                )
+            else:
+                repre_doc = repre_docs[0]
 
         # Add audio to instance if representation was found
         if repre_doc:

From 20bee203523e2979df32f010a305024d94a4310e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 22 Jun 2022 14:25:23 +0200
Subject: [PATCH 0777/1227] use query functions in nuke lib

---
 openpype/hosts/nuke/api/lib.py | 135 ++++++++++++++++++++++-----------
 1 file changed, 89 insertions(+), 46 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 7e44aaa7c5..57a81f7909 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -7,10 +7,16 @@ import contextlib
 from collections import OrderedDict
 
 import clique
-from bson.objectid import ObjectId
 
 import nuke
 
+from openpype.client import (
+    get_project,
+    get_asset_by_name,
+    get_versions,
+    get_last_versions,
+    get_representations,
+)
 from openpype.api import (
     Logger,
     Anatomy,
@@ -734,47 +740,84 @@ def check_inventory_versions():
     from .pipeline import parse_container
 
     # get all Loader nodes by avalon attribute metadata
-    for each in nuke.allNodes():
-        container = parse_container(each)
+    node_with_repre_id = []
+    repre_ids = set()
+    # Find all containers and collect it's node and representation ids
+    for node in nuke.allNodes():
+        container = parse_container(node)
 
         if container:
             node = nuke.toNode(container["objectName"])
             avalon_knob_data = read_avalon_data(node)
+            repre_id = avalon_knob_data["representation"]
 
-            # get representation from io
-            representation = legacy_io.find_one({
-                "type": "representation",
-                "_id": ObjectId(avalon_knob_data["representation"])
-            })
+            repre_ids.add(repre_id)
+            node_with_repre_id.append((node, repre_id))
 
-            # Failsafe for not finding the representation.
-            if not representation:
-                log.warning(
-                    "Could not find the representation on "
-                    "node \"{}\"".format(node.name())
-                )
-                continue
+    # Skip if nothing was found
+    if not repre_ids:
+        return
 
-            # Get start frame from version data
-            version = legacy_io.find_one({
-                "type": "version",
-                "_id": representation["parent"]
-            })
+    project_name = legacy_io.active_project()
+    # Find representations based on found containers
+    repre_docs = get_representations(
+        project_name,
+        repre_ids=repre_ids,
+        fields=["_id", "parent"]
+    )
+    # Store representations by id and collect version ids
+    repre_docs_by_id = {}
+    version_ids = set()
+    for repre_doc in repre_docs:
+        # Use stringed representation id to match value in containers
+        repre_id = str(repre_doc["_id"])
+        repre_docs_by_id[repre_id] = repre_doc
+        version_ids.add(repre_doc["parent"])
 
-            # get all versions in list
-            versions = legacy_io.find({
-                "type": "version",
-                "parent": version["parent"]
-            }).distinct("name")
+    version_docs = get_versions(
+        project_name, version_ids, fields=["_id", "name", "parent"]
+    )
+    # Store versions by id and collect subset ids
+    version_docs_by_id = {}
+    subset_ids = set()
+    for version_doc in version_docs:
+        version_docs_by_id[version_doc["_id"]] = version_doc
+        subset_ids.add(version_doc["parent"])
 
-            max_version = max(versions)
+    # Query last versions based on subset ids
+    last_versions_by_subset_id = get_last_versions(
+        project_name, subset_ids=subset_ids, fields=["_id", "parent"]
+    )
 
-            # check the available version and do match
-            # change color of node if not max version
-            if version.get("name") not in [max_version]:
-                node["tile_color"].setValue(int("0xd84f20ff", 16))
-            else:
-                node["tile_color"].setValue(int("0x4ecd25ff", 16))
+    # Loop through collected container nodes and their representation ids
+    for item in node_with_repre_id:
+        # Some python versions of nuke can't unfold tuple in for loop
+        node, repre_id = item
+        repre_doc = repre_docs_by_id.get(repre_id)
+        # Failsafe for not finding the representation.
+        if not repre_doc:
+            log.warning((
+                "Could not find the representation on node \"{}\""
+            ).format(node.name()))
+            continue
+
+        version_id = repre_doc["parent"]
+        version_doc = version_docs_by_id.get(version_id)
+        if not version_doc:
+            log.warning((
+                "Could not find the version on node \"{}\""
+            ).format(node.name()))
+            continue
+
+        # Get last version based on subset id
+        subset_id = version_doc["parent"]
+        last_version = last_versions_by_subset_id[subset_id]
+        # Check if last version is same as current version
+        if last_version["_id"] == version_doc["_id"]:
+            color_value = "0x4ecd25ff"
+        else:
+            color_value = "0xd84f20ff"
+        node["tile_color"].setValue(int(color_value, 16))
 
 
 def writes_version_sync():
@@ -899,11 +942,9 @@ def format_anatomy(data):
         file = script_name()
         data["version"] = get_version_from_path(file)
 
-    project_doc = legacy_io.find_one({"type": "project"})
-    asset_doc = legacy_io.find_one({
-        "type": "asset",
-        "name": data["avalon"]["asset"]
-    })
+    project_name = anatomy.project_name
+    project_doc = get_project(project_name)
+    asset_doc = get_asset_by_name(project_name, data["avalon"]["asset"])
     task_name = os.environ["AVALON_TASK"]
     host_name = os.environ["AVALON_APP"]
     context_data = get_workdir_data(
@@ -1692,12 +1733,13 @@ class WorkfileSettings(object):
 
     """
 
-    def __init__(self,
-                 root_node=None,
-                 nodes=None,
-                 **kwargs):
-        Context._project_doc = kwargs.get(
-            "project") or legacy_io.find_one({"type": "project"})
+    def __init__(self, root_node=None, nodes=None, **kwargs):
+        project_doc = kwargs.get("project")
+        if project_doc is None:
+            project_name = legacy_io.active_project()
+            project_doc = get_project(project_name)
+
+        Context._project_doc = project_doc
         self._asset = (
             kwargs.get("asset_name")
             or legacy_io.Session["AVALON_ASSET"]
@@ -2047,9 +2089,10 @@ class WorkfileSettings(object):
     def reset_resolution(self):
         """Set resolution to project resolution."""
         log.info("Resetting resolution")
-        project = legacy_io.find_one({"type": "project"})
-        asset = legacy_io.Session["AVALON_ASSET"]
-        asset = legacy_io.find_one({"name": asset, "type": "asset"})
+        project_name = legacy_io.active_project()
+        project = get_project(project_name)
+        asset_name = legacy_io.Session["AVALON_ASSET"]
+        asset = get_asset_by_name(project_name, asset_name)
         asset_data = asset.get('data', {})
 
         data = {

From da89c2d06bf04376e85ddd9594740067e99009e2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?=
 <33513211+antirotor@users.noreply.github.com>
Date: Wed, 22 Jun 2022 14:53:50 +0200
Subject: [PATCH 0778/1227] :pencil2: fixing typo

---
 openpype/hosts/maya/plugins/publish/collect_look.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index e8ada57f8f..ec583bcce7 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -40,7 +40,7 @@ FILE_NODES = {
 
     "aiImage": "filename",
 
-    "RedshiftNormalMap": "text0",
+    "RedshiftNormalMap": "tex0",
 
     "PxrBump": "filename",
     "PxrNormalMap": "filename",

From 38522154e78c22cd0037dbbe91c2ea1f820b057c Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 22 Jun 2022 16:45:51 +0300
Subject: [PATCH 0779/1227] Remove flags

---
 .../defaults/project_settings/maya.json       |  9 +------
 .../schemas/schema_maya_capture.json          | 25 -------------------
 2 files changed, 1 insertion(+), 33 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 0f40651c35..f9201286ab 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -496,25 +496,18 @@
                     "override_viewport_options": true,
                     "displayLights": "default",
                     "textureMaxResolution": 1024,
-                    "lineAAEnable": true,
                     "multiSample": 4,
                     "shadows": true,
                     "textures": true,
                     "twoSidedLighting": true,
                     "ssaoEnable": true,
-                    "ssaoAmount": 0,
                     "ssaoFilterRadius": 0,
-                    "ssaoRadius": 0,
                     "ssaoSamples": 0,
-                    "hwFogEnable": true,
+                    "fogging": true,
                     "hwFogFalloff": "0",
                     "hwFogStart": 0,
                     "hwFogEnd": 0,
                     "hwFogAlpha": 0,
-                    "hwFogDensity": 0,
-                    "motionBlurEnable": true,
-                    "motionBlurShutterOpenFraction": 0,
-                    "motionBlurSampleCount": 0,
                     "cameras": false,
                     "clipGhosts": false,
                     "controlVertices": false,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index 217aa947fc..c7842e5031 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -204,11 +204,6 @@
                         {
                             "type": "splitter"
                         },
-                        {
-                            "type": "boolean",
-                            "key": "lineAAEnable",
-                            "label": "Smooth Wireframe"
-                        },
                         {
                             "type": "number",
                             "key": "multiSample",
@@ -243,21 +238,11 @@
                             "key": "ssaoEnable",
                             "label": "Screen Space Ambient Occlusion"
                         },
-                        {
-                            "type": "number",
-                            "key": "ssaoAmount",
-                            "label": "SSAO Amount"
-                        },
                         {
                             "type": "number",
                             "key": "ssaoFilterRadius",
                             "label": "SSAO Filter Radius"
                         },
-                        {
-                            "type": "number",
-                            "key": "ssaoRadius",
-                            "label": "SSAO Radius"
-                        },
                         {
                             "type": "number",
                             "key": "ssaoSamples",
@@ -296,19 +281,9 @@
                             "key": "hwFogAlpha",
                             "label": "Hardware Fog Alpha"
                         },
-                        {
-                            "type": "number",
-                            "key": "hwFogDensity",
-                            "label": "Hardware Fog Density"
-                        },
                         {
                             "type": "splitter"
                         },
-                        {
-                            "type": "number",
-                            "key": "motionBlurShutterOpenFraction",
-                            "label": "Shutter Open Fraction"
-                        },
                         {
                             "type": "splitter"
                         },

From 1ed58ef89cd17b3485b38292e3774dfacba6c36c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 22 Jun 2022 16:16:37 +0200
Subject: [PATCH 0780/1227] use query functions in hiero

---
 openpype/hosts/hiero/api/lib.py               | 80 +++++++++++++------
 openpype/hosts/hiero/api/tags.py              |  9 ++-
 .../hosts/hiero/plugins/load/load_clip.py     | 37 ++++-----
 .../collect_assetbuilds.py                    |  4 +-
 4 files changed, 84 insertions(+), 46 deletions(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 06dfd2f2ee..482ddafa4d 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -14,6 +14,12 @@ import hiero
 from Qt import QtWidgets
 from bson.objectid import ObjectId
 
+from openpype.client import (
+    get_project,
+    get_versions,
+    get_last_versions,
+    get_representations,
+)
 from openpype.pipeline import legacy_io
 from openpype.api import (Logger, Anatomy, get_anatomy_settings)
 from . import tags
@@ -477,7 +483,7 @@ def sync_avalon_data_to_workfile():
         project.setProjectRoot(active_project_root)
 
     # get project data from avalon db
-    project_doc = legacy_io.find_one({"type": "project"})
+    project_doc = get_project(project_name)
     project_data = project_doc["data"]
 
     log.debug("project_data: {}".format(project_data))
@@ -1065,35 +1071,63 @@ def check_inventory_versions(track_items=None):
     clip_color_last = "green"
     clip_color = "red"
 
-    # get all track items from current timeline
+    item_with_repre_id = []
+    repre_ids = set()
+    # Find all containers and collect it's node and representation ids
     for track_item in track_item:
         container = parse_container(track_item)
         if container:
-            # get representation from io
-            representation = legacy_io.find_one({
-                "type": "representation",
-                "_id": ObjectId(container["representation"])
-            })
+            repre_id = container["representation"]
+            repre_ids.add(repre_id)
+            item_with_repre_id.append((track_item, repre_id))
 
-            # Get start frame from version data
-            version = legacy_io.find_one({
-                "type": "version",
-                "_id": representation["parent"]
-            })
+    # Skip if nothing was found
+    if not repre_ids:
+        return
 
-            # get all versions in list
-            versions = legacy_io.find({
-                "type": "version",
-                "parent": version["parent"]
-            }).distinct('name')
+    project_name = legacy_io.active_project()
+    # Find representations based on found containers
+    repre_docs = get_representations(
+        project_name,
+        repre_ids=repre_ids,
+        fields=["_id", "parent"]
+    )
+    # Store representations by id and collect version ids
+    repre_docs_by_id = {}
+    version_ids = set()
+    for repre_doc in repre_docs:
+        # Use stringed representation id to match value in containers
+        repre_id = str(repre_doc["_id"])
+        repre_docs_by_id[repre_id] = repre_doc
+        version_ids.add(repre_doc["parent"])
 
-            max_version = max(versions)
+    version_docs = get_versions(
+        project_name, version_ids, fields=["_id", "name", "parent"]
+    )
+    # Store versions by id and collect subset ids
+    version_docs_by_id = {}
+    subset_ids = set()
+    for version_doc in version_docs:
+        version_docs_by_id[version_doc["_id"]] = version_doc
+        subset_ids.add(version_doc["parent"])
 
-            # set clip colour
-            if version.get("name") == max_version:
-                track_item.source().binItem().setColor(clip_color_last)
-            else:
-                track_item.source().binItem().setColor(clip_color)
+    # Query last versions based on subset ids
+    last_versions_by_subset_id = get_last_versions(
+        project_name, subset_ids=subset_ids, fields=["_id", "parent"]
+    )
+
+    for item in item_with_repre_id:
+        # Some python versions of nuke can't unfold tuple in for loop
+        track_item, repre_id = item
+
+        repre_doc = repre_docs_by_id[repre_id]
+        version_doc = version_docs_by_id[repre_doc["parent"]]
+        last_version_doc = last_versions_by_subset_id[version_doc["parent"]]
+        # Check if last version is same as current version
+        if version_doc["_id"] == last_version_doc["_id"]:
+            track_item.source().binItem().setColor(clip_color_last)
+        else:
+            track_item.source().binItem().setColor(clip_color)
 
 
 def selection_changed_timeline(event):
diff --git a/openpype/hosts/hiero/api/tags.py b/openpype/hosts/hiero/api/tags.py
index 8c6ff2a77b..10df96fa53 100644
--- a/openpype/hosts/hiero/api/tags.py
+++ b/openpype/hosts/hiero/api/tags.py
@@ -2,6 +2,7 @@ import re
 import os
 import hiero
 
+from openpype.client import get_project, get_assets
 from openpype.api import Logger
 from openpype.pipeline import legacy_io
 
@@ -141,7 +142,9 @@ def add_tags_to_workfile():
     nks_pres_tags = tag_data()
 
     # Get project task types.
-    tasks = legacy_io.find_one({"type": "project"})["config"]["tasks"]
+    project_name = legacy_io.active_project()
+    project_doc = get_project(project_name)
+    tasks = project_doc["config"]["tasks"]
     nks_pres_tags["[Tasks]"] = {}
     log.debug("__ tasks: {}".format(tasks))
     for task_type in tasks.keys():
@@ -159,7 +162,9 @@ def add_tags_to_workfile():
     # asset builds and shots.
     if int(os.getenv("TAG_ASSETBUILD_STARTUP", 0)) == 1:
         nks_pres_tags["[AssetBuilds]"] = {}
-        for asset in legacy_io.find({"type": "asset"}):
+        for asset in get_assets(
+            project_name, fields=["name", "data.entityType"]
+        ):
             if asset["data"]["entityType"] == "AssetBuild":
                 nks_pres_tags["[AssetBuilds]"][asset["name"]] = {
                     "editable": "1",
diff --git a/openpype/hosts/hiero/plugins/load/load_clip.py b/openpype/hosts/hiero/plugins/load/load_clip.py
index a3365253b3..2a7d1af41e 100644
--- a/openpype/hosts/hiero/plugins/load/load_clip.py
+++ b/openpype/hosts/hiero/plugins/load/load_clip.py
@@ -1,3 +1,7 @@
+from openpype.client import (
+    get_version_by_id,
+    get_last_version_by_subset_id
+)
 from openpype.pipeline import (
     legacy_io,
     get_representation_path,
@@ -103,12 +107,12 @@ class LoadClip(phiero.SequenceLoader):
         namespace = container['namespace']
         track_item = phiero.get_track_items(
             track_item_name=namespace).pop()
-        version = legacy_io.find_one({
-            "type": "version",
-            "_id": representation["parent"]
-        })
-        version_data = version.get("data", {})
-        version_name = version.get("name", None)
+
+        project_name = legacy_io.active_project()
+        version_doc = get_version_by_id(project_name, representation["parent"])
+
+        version_data = version_doc.get("data", {})
+        version_name = version_doc.get("name", None)
         colorspace = version_data.get("colorspace", None)
         object_name = "{}_{}".format(name, namespace)
         file = get_representation_path(representation).replace("\\", "/")
@@ -143,7 +147,7 @@ class LoadClip(phiero.SequenceLoader):
         })
 
         # update color of clip regarding the version order
-        self.set_item_color(track_item, version)
+        self.set_item_color(track_item, version_doc)
 
         return phiero.update_container(track_item, data_imprint)
 
@@ -166,21 +170,14 @@ class LoadClip(phiero.SequenceLoader):
             cls.sequence = cls.track.parent()
 
     @classmethod
-    def set_item_color(cls, track_item, version):
-
+    def set_item_color(cls, track_item, version_doc):
+        project_name = legacy_io.active_project()
+        last_version_doc = get_last_version_by_subset_id(
+            project_name, version_doc["parent"], fields=["_id"]
+        )
         clip = track_item.source()
-        # define version name
-        version_name = version.get("name", None)
-        # get all versions in list
-        versions = legacy_io.find({
-            "type": "version",
-            "parent": version["parent"]
-        }).distinct('name')
-
-        max_version = max(versions)
-
         # set clip colour
-        if version_name == max_version:
+        if version_doc["_id"] == last_version_doc["_id"]:
             clip.binItem().setColor(cls.clip_color_last)
         else:
             clip.binItem().setColor(cls.clip_color)
diff --git a/openpype/hosts/hiero/plugins/publish_old_workflow/collect_assetbuilds.py b/openpype/hosts/hiero/plugins/publish_old_workflow/collect_assetbuilds.py
index 10baf25803..5f96533052 100644
--- a/openpype/hosts/hiero/plugins/publish_old_workflow/collect_assetbuilds.py
+++ b/openpype/hosts/hiero/plugins/publish_old_workflow/collect_assetbuilds.py
@@ -1,4 +1,5 @@
 from pyblish import api
+from openpype.client import get_assets
 from openpype.pipeline import legacy_io
 
 
@@ -17,8 +18,9 @@ class CollectAssetBuilds(api.ContextPlugin):
     hosts = ["hiero"]
 
     def process(self, context):
+        project_name = legacy_io.active_project()
         asset_builds = {}
-        for asset in legacy_io.find({"type": "asset"}):
+        for asset in get_assets(project_name):
             if asset["data"]["entityType"] == "AssetBuild":
                 self.log.debug("Found \"{}\" in database.".format(asset))
                 asset_builds[asset["name"]] = asset

From 52179d4015e981e4c0cdd56c979e230e61ecc7d4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 22 Jun 2022 16:17:07 +0200
Subject: [PATCH 0781/1227] remove unused import

---
 openpype/hosts/hiero/api/lib.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 482ddafa4d..8c8c31bc4c 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -12,7 +12,6 @@ import shutil
 import hiero
 
 from Qt import QtWidgets
-from bson.objectid import ObjectId
 
 from openpype.client import (
     get_project,

From 137ef3e22bbe9495e69a4379c3f85f367f3b4a7d Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 22 Jun 2022 17:35:51 +0300
Subject: [PATCH 0782/1227] Remove keys that fail.

---
 .../defaults/project_settings/maya.json       |  6 ---
 .../schemas/schema_maya_capture.json          | 38 -------------------
 2 files changed, 44 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index f9201286ab..8494989556 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -501,13 +501,7 @@
                     "textures": true,
                     "twoSidedLighting": true,
                     "ssaoEnable": true,
-                    "ssaoFilterRadius": 0,
-                    "ssaoSamples": 0,
                     "fogging": true,
-                    "hwFogFalloff": "0",
-                    "hwFogStart": 0,
-                    "hwFogEnd": 0,
-                    "hwFogAlpha": 0,
                     "cameras": false,
                     "clipGhosts": false,
                     "controlVertices": false,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index c7842e5031..ace9fc22da 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -238,16 +238,6 @@
                             "key": "ssaoEnable",
                             "label": "Screen Space Ambient Occlusion"
                         },
-                        {
-                            "type": "number",
-                            "key": "ssaoFilterRadius",
-                            "label": "SSAO Filter Radius"
-                        },
-                        {
-                            "type": "number",
-                            "key": "ssaoSamples",
-                            "label": "SSAO Samples"
-                        },
                         {
                             "type": "splitter"
                         },
@@ -256,34 +246,6 @@
                             "key": "fogging",
                             "label": "Enable Hardware Fog"
                         },
-                        {
-                            "type": "enum",
-                            "key": "hwFogFalloff",
-                            "label": "Hardware Fog Falloff",
-                            "enum_items": [
-                                { "0": "Linear"},
-                                { "1": "Exponential"},
-                                { "2": "Exponential Squared"}
-                            ]
-                        },
-                        {
-                            "type": "number",
-                            "key": "hwFogStart",
-                            "label": "Hardware Fog Start"
-                        },
-                        {
-                            "type": "number",
-                            "key": "hwFogEnd",
-                            "label": "Hardware Fog End"
-                        },
-                        {
-                            "type": "number",
-                            "key": "hwFogAlpha",
-                            "label": "Hardware Fog Alpha"
-                        },
-                        {
-                            "type": "splitter"
-                        },
                         {
                             "type": "splitter"
                         },

From bcecebf9ff016d5fd8b8480769783a71e8cb6d1a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 22 Jun 2022 16:58:11 +0200
Subject: [PATCH 0783/1227] husdoutputprocessors is using project anatomy and
 query functions

---
 .../avalon_uri_processor.py                   | 31 +++++--------------
 1 file changed, 7 insertions(+), 24 deletions(-)

diff --git a/openpype/hosts/houdini/vendor/husdoutputprocessors/avalon_uri_processor.py b/openpype/hosts/houdini/vendor/husdoutputprocessors/avalon_uri_processor.py
index 01a29472e7..202287f1c3 100644
--- a/openpype/hosts/houdini/vendor/husdoutputprocessors/avalon_uri_processor.py
+++ b/openpype/hosts/houdini/vendor/husdoutputprocessors/avalon_uri_processor.py
@@ -4,19 +4,9 @@ import husdoutputprocessors.base as base
 
 import colorbleed.usdlib as usdlib
 
-from openpype.pipeline import (
-    legacy_io,
-    registered_root,
-)
-
-
-def _get_project_publish_template():
-    """Return publish template from database for current project"""
-    project = legacy_io.find_one(
-        {"type": "project"},
-        projection={"config.template.publish": True}
-    )
-    return project["config"]["template"]["publish"]
+from openpype.client import get_asset_by_name
+from openpype.api import Anatomy
+from openpype.pipeline import legacy_io
 
 
 class AvalonURIOutputProcessor(base.OutputProcessorBase):
@@ -35,7 +25,6 @@ class AvalonURIOutputProcessor(base.OutputProcessorBase):
             ever created in a Houdini session. Therefore be very careful
             about what data gets put in this object.
         """
-        self._template = None
         self._use_publish_paths = False
         self._cache = dict()
 
@@ -60,14 +49,11 @@ class AvalonURIOutputProcessor(base.OutputProcessorBase):
         return self._parameters
 
     def beginSave(self, config_node, t):
-        self._template = _get_project_publish_template()
-
         parm = self._parms["use_publish_paths"]
         self._use_publish_paths = config_node.parm(parm).evalAtTime(t)
         self._cache.clear()
 
     def endSave(self):
-        self._template = None
         self._use_publish_paths = None
         self._cache.clear()
 
@@ -138,22 +124,19 @@ class AvalonURIOutputProcessor(base.OutputProcessorBase):
         """
 
         PROJECT = legacy_io.Session["AVALON_PROJECT"]
-        asset_doc = legacy_io.find_one({
-            "name": asset,
-            "type": "asset"
-        })
+        anatomy = Anatomy(PROJECT)
+        asset_doc = get_asset_by_name(PROJECT, asset)
         if not asset_doc:
             raise RuntimeError("Invalid asset name: '%s'" % asset)
 
-        root = registered_root()
-        path = self._template.format(**{
-            "root": root,
+        formatted_anatomy = anatomy.format({
             "project": PROJECT,
             "asset": asset_doc["name"],
             "subset": subset,
             "representation": ext,
             "version": 0  # stub version zero
         })
+        path = formatted_anatomy["publish"]["path"]
 
         # Remove the version folder
         subset_folder = os.path.dirname(os.path.dirname(path))

From fe77fe64adfcd2bf2c9eb77d6c5181c0fb20dd5f Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Wed, 22 Jun 2022 17:10:36 +0200
Subject: [PATCH 0784/1227] add new studios to main page

---
 website/src/pages/index.js                |  27 ++++++++++++++++++-
 website/static/img/Logo_On_White-HR.png   | Bin 0 -> 77588 bytes
 website/static/img/NoGhost_Logo_black.svg |  31 ++++++++++++++++++++++
 website/static/img/agora_studio.png       | Bin 0 -> 133985 bytes
 website/static/img/igg-logo.png           | Bin 80331 -> 96336 bytes
 website/static/img/methodmadness.png      | Bin 0 -> 8650 bytes
 website/static/img/noghost.png            | Bin 0 -> 22435 bytes
 website/static/img/staticvfx.png          | Bin 0 -> 12912 bytes
 8 files changed, 57 insertions(+), 1 deletion(-)
 create mode 100644 website/static/img/Logo_On_White-HR.png
 create mode 100644 website/static/img/NoGhost_Logo_black.svg
 create mode 100644 website/static/img/agora_studio.png
 create mode 100644 website/static/img/methodmadness.png
 create mode 100644 website/static/img/noghost.png
 create mode 100644 website/static/img/staticvfx.png

diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index 0886706015..ae7119e928 100644
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -153,7 +153,32 @@ const studios = [
       title: "IGG Canada",
       image: "/img/igg-logo.png",
       infoLink: "https://www.igg.com/",
-  }
+  },
+  {
+      title: "Agora Studio",
+      image: "/img/agora_studio.png",
+      infoLink: "https://agora.studio/",
+  },
+  {
+      title: "Lucan Visuals",
+      image: "/img/lucan_Logo_On_White-HR.png",
+      infoLink: "https://www.lucan.tv/",
+  },
+  {
+      title: "No Ghost",
+      image: "/img/noghost.png",
+      infoLink: "https://www.noghost.co.uk/",
+  },
+  {
+    title: "Static VFX",
+    image: "/img/staticvfx.png",
+    infoLink: "http://www.staticvfx.com/",
+  },
+  {
+    title: "Method n Madness",
+    image: "/img/methodmadness.png",
+    infoLink: "https://www.methodnmadness.com/",
+}
 ];
 
 function Service({imageUrl, title, description}) {
diff --git a/website/static/img/Logo_On_White-HR.png b/website/static/img/Logo_On_White-HR.png
new file mode 100644
index 0000000000000000000000000000000000000000..c86030e1e78092c7ecd1de2cd129198c99680ee4
GIT binary patch
literal 77588
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
Hng;$4d7@BX

literal 0
HcmV?d00001

diff --git a/website/static/img/NoGhost_Logo_black.svg b/website/static/img/NoGhost_Logo_black.svg
new file mode 100644
index 0000000000..b499b1621f
--- /dev/null
+++ b/website/static/img/NoGhost_Logo_black.svg
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 25.3.1, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 1341 216" style="enable-background:new 0 0 1341 216;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#000000;}
+</style>
+<g>
+	<path class="st0" d="M132,0.3l0,18l47,81.1c3.9,7.3,2.3,16.6-4.2,22.2c-7.6,6.5-19,5.7-25.6-1.9c-0.9-1-2.2-3.2-2.2-3.2L79.7,0.3
+		H39.3C17.8,0.3,0.4,17.7,0.4,39.2L0.3,215.8h83.8l0-17.9l-46.3-80.1c-4.6-7.4-3.3-17.3,3.4-23.2c5.5-4.9,13.6-5.7,20.2-2.5
+		c4,1.9,6.4,4.7,8.1,7.9l66.8,115.8h40.3c21.5,0,38.9-17.4,38.9-38.9V0.3H132z"/>
+	<path class="st0" d="M367.8,0.3H227.6v176c0,21.8,17.7,39.5,39.5,39.5h140.2v-176C407.3,18,389.6,0.3,367.8,0.3z M350,191.9
+		c-10.1,0-18.9-5.5-23.5-13.7l0,0L261.8,66.4c-2.9-4.3-4.6-9.5-4.6-15.1c0-14.9,12.1-27,27-27c10.7,0,20,6.2,24.3,15.3l0,0
+		l64.4,111.3c0.3,0.4,0.5,0.8,0.7,1.3l0.1,0.1l0,0c2,3.8,3.2,8.1,3.2,12.7C377,179.8,364.9,191.9,350,191.9z"/>
+	<path class="st0" d="M984.5,0.3H844.3v176c0,21.8,17.7,39.5,39.5,39.5H1024v-176C1024,18,1006.3,0.3,984.5,0.3z M966.7,191.9
+		c-10.1,0-18.9-5.5-23.5-13.7l0,0L878.6,66.4c-2.9-4.3-4.6-9.5-4.6-15.1c0-14.9,12.1-27,27-27c10.7,0,20,6.2,24.3,15.3l0,0
+		l64.2,111.3c0.3,0.4,0.5,0.8,0.7,1.3l0.1,0.1l0,0c2,3.8,3.2,8.1,3.2,12.7C993.7,179.8,981.6,191.9,966.7,191.9z"/>
+	<path class="st0" d="M554.5,96.5v17.9l28.7,49.7c0.3,0.4,0.5,0.8,0.7,1.3l0.1,0.2l0,0c1.2,2.4,1.9,5.2,1.9,8.1
+		c0,10-8.1,18.1-18.1,18.1c-6.3,0-11.8-3.2-15.1-8l0,0l-0.7-1.3c-0.1-0.1-0.1-0.2-0.2-0.3L497.4,88l0,0c-1.8-2.8-2.8-6.1-2.8-9.7
+		c0-10,8.1-18.1,18.1-18.1c0,0,0,0,0,0h95c14.9,0,26.9-12.1,26.9-26.9V0.3H529.2c0,0,0,0,0,0c-50,0-90.8,40-91.9,89.8l0,0v35.9l0,0
+		c1.2,49.8,41.9,89.7,91.9,89.7h0h105.5V96.5H554.5z"/>
+	<path class="st0" d="M748.6,0.3l0,18.2l26,45.1c1.3,2.5,2.1,5.4,2.1,8.4c0,10-8.1,18.1-18.1,18.1h-29.5c-10,0-18.1-8.1-18.1-18.1
+		V0.3h-64.2v215.5h83.8l0-17.9l-26.4-45.7c-1.3-2.5-2-5.3-2-8.2c0-10,8.1-18.1,18.1-18.1c0,0,0,0,0,0h29.5c0,0,0,0,0,0
+		c10,0,18.1,8.1,18.1,18.1l0,71.9h64.5V0.3H748.6z"/>
+	<path class="st0" d="M1269.1,60.2c0.1,0,71.6,0,71.6,0v-33c0-14.9-12.1-26.9-26.9-26.9h-93.7c-1.2,0-2.4,0-3.6,0
+		c-123.6,0-149.9,0-154.1,0c-14.9,0-26.9,12.1-26.9,26.9c0,5.3,1.6,10.3,4.2,14.5l71.2,123.3c1.4,2.6,2.3,5.6,2.3,8.8
+		c0,10-8.1,18.1-18.1,18.1c-6.6,0-12.4-3.6-15.6-8.9l-15.7-27.1h-28.3v59.9h134.5c14.9,0,26.9-12.1,26.9-26.9c0-5-1.4-9.8-3.8-13.8
+		l-71.5-123.7l0,0c-1.5-2.6-2.3-5.6-2.3-8.8c0-10,8.1-18.1,18.1-18.1c7.2,0,13.4,4.2,16.4,10.3l14.8,25.4h40.4v155.6h83.8l-0.1-60.6
+		l-39.5-68c-1.5-2.6-2.3-5.6-2.3-8.8C1251,68.3,1259.1,60.2,1269.1,60.2z"/>
+</g>
+</svg>
diff --git a/website/static/img/agora_studio.png b/website/static/img/agora_studio.png
new file mode 100644
index 0000000000000000000000000000000000000000..48b07b877504267eb302aa7ebf9e0b49540ed686
GIT binary patch
literal 133985
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
V6EOF;;@B_M*D=QBowWV^{{U&xqwfF!

literal 0
HcmV?d00001

diff --git a/website/static/img/igg-logo.png b/website/static/img/igg-logo.png
index 3c7f7718f79ae866bd9f07bd51878f5d2a6eceea..9fc7a7f84f1b968c04ff213d6648616496bc07d9 100644
GIT binary patch
literal 96336
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%0A%VsM|U#I>^O_
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

literal 80331
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
CA{hw)

diff --git a/website/static/img/methodmadness.png b/website/static/img/methodmadness.png
new file mode 100644
index 0000000000000000000000000000000000000000..9dd0681d4a029b11c8db74154934333db42e1851
GIT binary patch
literal 8650
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

literal 0
HcmV?d00001

diff --git a/website/static/img/noghost.png b/website/static/img/noghost.png
new file mode 100644
index 0000000000000000000000000000000000000000..febaedcae8212926ae8d7eb3705c8304531f8375
GIT binary patch
literal 22435
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
D(4BF@

literal 0
HcmV?d00001

diff --git a/website/static/img/staticvfx.png b/website/static/img/staticvfx.png
new file mode 100644
index 0000000000000000000000000000000000000000..41efd7f12005db1c67e168d1447eaa0596603e1b
GIT binary patch
literal 12912
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

literal 0
HcmV?d00001


From dc8ea4eb08075ac365fc6ffab4c9c391bfc9f06d Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Wed, 22 Jun 2022 17:11:34 +0200
Subject: [PATCH 0785/1227] fix lucan logo name

---
 ...o_On_White-HR.png => lucan_Logo_On_White-HR.png} | Bin
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename website/static/img/{Logo_On_White-HR.png => lucan_Logo_On_White-HR.png} (100%)

diff --git a/website/static/img/Logo_On_White-HR.png b/website/static/img/lucan_Logo_On_White-HR.png
similarity index 100%
rename from website/static/img/Logo_On_White-HR.png
rename to website/static/img/lucan_Logo_On_White-HR.png

From a4b09cccc21c1ade1d170fc23cd112e8efc9f4e4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 22 Jun 2022 17:39:30 +0200
Subject: [PATCH 0786/1227] use query functions in houdini

---
 openpype/hosts/houdini/api/lib.py             | 35 ++++++++--------
 openpype/hosts/houdini/api/usd.py             |  7 ++--
 .../houdini/plugins/create/create_hda.py      | 24 +++++------
 .../plugins/publish/collect_usd_bootstrap.py  | 22 +++++-----
 .../plugins/publish/extract_usd_layered.py    | 41 ++++++++++---------
 .../validate_usd_shade_model_exists.py        | 23 ++++-------
 6 files changed, 73 insertions(+), 79 deletions(-)

diff --git a/openpype/hosts/houdini/api/lib.py b/openpype/hosts/houdini/api/lib.py
index 96ca019f8f..dd8a5ba473 100644
--- a/openpype/hosts/houdini/api/lib.py
+++ b/openpype/hosts/houdini/api/lib.py
@@ -4,6 +4,7 @@ from contextlib import contextmanager
 
 import six
 
+from openpype.client import get_asset_by_name
 from openpype.api import get_asset
 from openpype.pipeline import legacy_io
 
@@ -74,16 +75,13 @@ def generate_ids(nodes, asset_id=None):
     """
 
     if asset_id is None:
+        project_name = legacy_io.active_project()
+        asset_name = legacy_io.Session["AVALON_ASSET"]
         # Get the asset ID from the database for the asset of current context
-        asset_data = legacy_io.find_one(
-            {
-                "type": "asset",
-                "name": legacy_io.Session["AVALON_ASSET"]
-            },
-            projection={"_id": True}
-        )
-        assert asset_data, "No current asset found in Session"
-        asset_id = asset_data['_id']
+        asset_doc = get_asset_by_name(project_name, asset_name, fields=["_id"])
+
+        assert asset_doc, "No current asset found in Session"
+        asset_id = asset_doc['_id']
 
     node_ids = []
     for node in nodes:
@@ -430,26 +428,29 @@ def maintained_selection():
 def reset_framerange():
     """Set frame range to current asset"""
 
+    project_name = legacy_io.active_project()
     asset_name = legacy_io.Session["AVALON_ASSET"]
-    asset = legacy_io.find_one({"name": asset_name, "type": "asset"})
+    # Get the asset ID from the database for the asset of current context
+    asset_doc = get_asset_by_name(project_name, asset_name)
+    asset_data = asset_doc["data"]
 
-    frame_start = asset["data"].get("frameStart")
-    frame_end = asset["data"].get("frameEnd")
+    frame_start = asset_data.get("frameStart")
+    frame_end = asset_data.get("frameEnd")
     # Backwards compatibility
     if frame_start is None or frame_end is None:
-        frame_start = asset["data"].get("edit_in")
-        frame_end = asset["data"].get("edit_out")
+        frame_start = asset_data.get("edit_in")
+        frame_end = asset_data.get("edit_out")
 
     if frame_start is None or frame_end is None:
         log.warning("No edit information found for %s" % asset_name)
         return
 
-    handles = asset["data"].get("handles") or 0
-    handle_start = asset["data"].get("handleStart")
+    handles = asset_data.get("handles") or 0
+    handle_start = asset_data.get("handleStart")
     if handle_start is None:
         handle_start = handles
 
-    handle_end = asset["data"].get("handleEnd")
+    handle_end = asset_data.get("handleEnd")
     if handle_end is None:
         handle_end = handles
 
diff --git a/openpype/hosts/houdini/api/usd.py b/openpype/hosts/houdini/api/usd.py
index e9991e38ec..4f4a3d8e6f 100644
--- a/openpype/hosts/houdini/api/usd.py
+++ b/openpype/hosts/houdini/api/usd.py
@@ -6,6 +6,7 @@ import logging
 from Qt import QtWidgets, QtCore, QtGui
 
 from openpype import style
+from openpype.client import get_asset_by_name
 from openpype.pipeline import legacy_io
 from openpype.tools.utils.assets_widget import SingleSelectAssetsWidget
 
@@ -46,10 +47,8 @@ class SelectAssetDialog(QtWidgets.QWidget):
         select_id = None
         name = self._parm.eval()
         if name:
-            db_asset = legacy_io.find_one(
-                {"name": name, "type": "asset"},
-                {"_id": True}
-            )
+            project_name = legacy_io.active_project()
+            db_asset = get_asset_by_name(project_name, name, fields=["_id"])
             if db_asset:
                 select_id = db_asset["_id"]
 
diff --git a/openpype/hosts/houdini/plugins/create/create_hda.py b/openpype/hosts/houdini/plugins/create/create_hda.py
index 5fc78c7539..d15d5bcd29 100644
--- a/openpype/hosts/houdini/plugins/create/create_hda.py
+++ b/openpype/hosts/houdini/plugins/create/create_hda.py
@@ -1,6 +1,10 @@
 # -*- coding: utf-8 -*-
 import hou
 
+from openpye.client import (
+    get_asset_by_name,
+    get_subsets,
+)
 from openpype.pipeline import legacy_io
 from openpype.hosts.houdini.api import lib
 from openpype.hosts.houdini.api import plugin
@@ -23,20 +27,16 @@ class CreateHDA(plugin.Creator):
         # type: (str) -> bool
         """Check if existing subset name versions already exists."""
         # Get all subsets of the current asset
-        asset_id = legacy_io.find_one(
-            {"name": self.data["asset"], "type": "asset"},
-            projection={"_id": True}
-        )['_id']
-        subset_docs = legacy_io.find(
-            {
-                "type": "subset",
-                "parent": asset_id
-            },
-            {"name": 1}
+        project_name = legacy_io.active_project()
+        asset_doc = get_asset_by_name(
+            project_name, self.data["asset"], fields=["_id"]
+        )
+        subset_docs = get_subsets(
+            project_name, asset_ids=[asset_doc["_id"]], fields=["name"]
         )
-        existing_subset_names = set(subset_docs.distinct("name"))
         existing_subset_names_low = {
-            _name.lower() for _name in existing_subset_names
+            subset_doc["name"].lower()
+            for subset_doc in subset_docs
         }
         return subset_name.lower() in existing_subset_names_low
 
diff --git a/openpype/hosts/houdini/plugins/publish/collect_usd_bootstrap.py b/openpype/hosts/houdini/plugins/publish/collect_usd_bootstrap.py
index 3f0d10e0ba..cf8d61cda3 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_usd_bootstrap.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_usd_bootstrap.py
@@ -1,5 +1,6 @@
 import pyblish.api
 
+from openyppe.client import get_subset_by_name, get_asset_by_name
 from openpype.pipeline import legacy_io
 import openpype.lib.usdlib as usdlib
 
@@ -50,10 +51,8 @@ class CollectUsdBootstrap(pyblish.api.InstancePlugin):
 
         self.log.debug("Add bootstrap for: %s" % bootstrap)
 
-        asset = legacy_io.find_one({
-            "name": instance.data["asset"],
-            "type": "asset"
-        })
+        project_name = legacy_io.active_project()
+        asset = get_asset_by_name(project_name, instance.data["asset"])
         assert asset, "Asset must exist: %s" % asset
 
         # Check which are not about to be created and don't exist yet
@@ -70,7 +69,7 @@ class CollectUsdBootstrap(pyblish.api.InstancePlugin):
 
         self.log.debug("Checking required bootstrap: %s" % required)
         for subset in required:
-            if self._subset_exists(instance, subset, asset):
+            if self._subset_exists(project_name, instance, subset, asset):
                 continue
 
             self.log.debug(
@@ -93,7 +92,7 @@ class CollectUsdBootstrap(pyblish.api.InstancePlugin):
             for key in ["asset"]:
                 new.data[key] = instance.data[key]
 
-    def _subset_exists(self, instance, subset, asset):
+    def _subset_exists(self, project_name, instance, subset, asset):
         """Return whether subset exists in current context or in database."""
         # Allow it to be created during this publish session
         context = instance.context
@@ -106,9 +105,8 @@ class CollectUsdBootstrap(pyblish.api.InstancePlugin):
 
         # Or, if they already exist in the database we can
         # skip them too.
-        return bool(
-            legacy_io.find_one(
-                {"name": subset, "type": "subset", "parent": asset["_id"]},
-                {"_id": True}
-            )
-        )
+        if get_subset_by_name(
+            project_name, subset, asset["_id"], fields=["_id"]
+        ):
+            return True
+        return False
diff --git a/openpype/hosts/houdini/plugins/publish/extract_usd_layered.py b/openpype/hosts/houdini/plugins/publish/extract_usd_layered.py
index bfcd93c1cb..80919c023b 100644
--- a/openpype/hosts/houdini/plugins/publish/extract_usd_layered.py
+++ b/openpype/hosts/houdini/plugins/publish/extract_usd_layered.py
@@ -7,6 +7,12 @@ from collections import deque
 import pyblish.api
 import openpype.api
 
+from openpype.client import (
+    get_asset_by_name,
+    get_subset_by_name,
+    get_last_version_by_subset_id,
+    get_representation_by_name,
+)
 from openpype.pipeline import (
     get_representation_path,
     legacy_io,
@@ -244,11 +250,14 @@ class ExtractUSDLayered(openpype.api.Extractor):
 
         # Set up the dependency for publish if they have new content
         # compared to previous publishes
+        project_name = legacy_io.active_project()
         for dependency in active_dependencies:
             dependency_fname = dependency.data["usdFilename"]
 
             filepath = os.path.join(staging_dir, dependency_fname)
-            similar = self._compare_with_latest_publish(dependency, filepath)
+            similar = self._compare_with_latest_publish(
+                project_name, dependency, filepath
+            )
             if similar:
                 # Deactivate this dependency
                 self.log.debug(
@@ -268,7 +277,7 @@ class ExtractUSDLayered(openpype.api.Extractor):
             instance.data["files"] = []
         instance.data["files"].append(fname)
 
-    def _compare_with_latest_publish(self, dependency, new_file):
+    def _compare_with_latest_publish(self, project_name, dependency, new_file):
         import filecmp
 
         _, ext = os.path.splitext(new_file)
@@ -276,35 +285,29 @@ class ExtractUSDLayered(openpype.api.Extractor):
         # Compare this dependency with the latest published version
         # to detect whether we should make this into a new publish
         # version. If not, skip it.
-        asset = legacy_io.find_one(
-            {"name": dependency.data["asset"], "type": "asset"}
+        asset = get_asset_by_name(
+            project_name, dependency.data["asset"], fields=["_id"]
         )
-        subset = legacy_io.find_one(
-            {
-                "name": dependency.data["subset"],
-                "type": "subset",
-                "parent": asset["_id"],
-            }
+        subset = get_subset_by_name(
+            project_name,
+            dependency.data["subset"],
+            asset["_id"],
+            fields=["_id"]
         )
         if not subset:
             # Subset doesn't exist yet. Definitely new file
             self.log.debug("No existing subset..")
             return False
 
-        version = legacy_io.find_one(
-            {"type": "version", "parent": subset["_id"], },
-            sort=[("name", -1)]
+        version = get_last_version_by_subset_id(
+            project_name, subset["_id"], fields=["_id"]
         )
         if not version:
             self.log.debug("No existing version..")
             return False
 
-        representation = legacy_io.find_one(
-            {
-                "name": ext.lstrip("."),
-                "type": "representation",
-                "parent": version["_id"],
-            }
+        representation = get_representation_by_name(
+            project_name, ext.lstrip("."), version["_id"]
         )
         if not representation:
             self.log.debug("No existing representation..")
diff --git a/openpype/hosts/houdini/plugins/publish/validate_usd_shade_model_exists.py b/openpype/hosts/houdini/plugins/publish/validate_usd_shade_model_exists.py
index 44719ae488..b979b87d84 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_usd_shade_model_exists.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_usd_shade_model_exists.py
@@ -2,6 +2,7 @@ import re
 
 import pyblish.api
 
+from openpype.client import get_subset_by_name
 import openpype.api
 from openpype.pipeline import legacy_io
 
@@ -15,31 +16,23 @@ class ValidateUSDShadeModelExists(pyblish.api.InstancePlugin):
     label = "USD Shade model exists"
 
     def process(self, instance):
-
-        asset = instance.data["asset"]
+        project_name = legacy_io.active_project()
+        asset_name = instance.data["asset"]
         subset = instance.data["subset"]
 
         # Assume shading variation starts after a dot separator
         shade_subset = subset.split(".", 1)[0]
         model_subset = re.sub("^usdShade", "usdModel", shade_subset)
 
-        asset_doc = legacy_io.find_one(
-            {"name": asset, "type": "asset"},
-            {"_id": True}
-        )
+        asset_doc = instance.data.get("assetEntity")
         if not asset_doc:
-            raise RuntimeError("Asset does not exist: %s" % asset)
+            raise RuntimeError("Asset document is not filled on instance.")
 
-        subset_doc = legacy_io.find_one(
-            {
-                "name": model_subset,
-                "type": "subset",
-                "parent": asset_doc["_id"],
-            },
-            {"_id": True}
+        subset_doc = get_subset_by_name(
+            project_name, model_subset, asset_doc["_id"], fields=["_id"]
         )
         if not subset_doc:
             raise RuntimeError(
                 "USD Model subset not found: "
-                "%s (%s)" % (model_subset, asset)
+                "%s (%s)" % (model_subset, asset_name)
             )

From 796348d4afc38a29eac73c97484d516eb5ba774b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 22 Jun 2022 18:05:37 +0200
Subject: [PATCH 0787/1227] renamed 'HostImplementation' to 'HostBase' and
 `MayaHostImplementation' to 'MayaHost'

---
 openpype/host/__init__.py           | 4 ++--
 openpype/host/host.py               | 6 +++---
 openpype/hosts/maya/api/__init__.py | 4 ++--
 openpype/hosts/maya/api/pipeline.py | 6 +++---
 4 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/openpype/host/__init__.py b/openpype/host/__init__.py
index fcc9372a99..84a2fa930a 100644
--- a/openpype/host/__init__.py
+++ b/openpype/host/__init__.py
@@ -1,12 +1,12 @@
 from .host import (
-    HostImplementation,
+    HostBase,
     IWorkfileHost,
     ILoadHost,
     INewPublisher,
 )
 
 __all__ = (
-    "HostImplementation",
+    "HostBase",
     "IWorkfileHost",
     "ILoadHost",
     "INewPublisher",
diff --git a/openpype/host/host.py b/openpype/host/host.py
index 302c181598..2a59daf473 100644
--- a/openpype/host/host.py
+++ b/openpype/host/host.py
@@ -16,7 +16,7 @@ class MissingMethodsError(ValueError):
 
 
 @six.add_metaclass(ABCMeta)
-class HostImplementation(object):
+class HostBase(object):
     """Base of host implementation class.
 
     Host is pipeline implementation of DCC application. This class should help
@@ -175,7 +175,7 @@ class ILoadHost:
 
     QUESTIONS
     - Is list container dependency of host or load plugins?
-    - Should this be directly in HostImplementation?
+    - Should this be directly in HostBase?
         - how to find out if referencing is available?
         - do we need to know that?
     """
@@ -369,7 +369,7 @@ class INewPublisher:
     but also some global data. At this moment are data related only to context
     publish plugins but that can extend in future.
 
-    HostImplementation does not have to inherit from this interface just have
+    HostBase does not have to inherit from this interface just have
     to imlement mentioned all listed methods.
     """
 
diff --git a/openpype/hosts/maya/api/__init__.py b/openpype/hosts/maya/api/__init__.py
index 6c28c59580..a6c5f50e1a 100644
--- a/openpype/hosts/maya/api/__init__.py
+++ b/openpype/hosts/maya/api/__init__.py
@@ -9,7 +9,7 @@ from .pipeline import (
 
     ls,
     containerise,
-    MayaHostImplementation,
+    MayaHost,
 )
 from .plugin import (
     Creator,
@@ -44,7 +44,7 @@ __all__ = [
 
     "ls",
     "containerise",
-    "MayaHostImplementation",
+    "MayaHost",
 
     "Creator",
     "Loader",
diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index f68bed9338..bfb9b289e0 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -9,7 +9,7 @@ import maya.api.OpenMaya as om
 import pyblish.api
 
 from openpype.settings import get_project_settings
-from openpype.host import HostImplementation, IWorkfileHost, ILoadHost
+from openpype.host import HostBase, IWorkfileHost, ILoadHost
 import openpype.hosts.maya
 from openpype.tools.utils import host_tools
 from openpype.lib import (
@@ -51,11 +51,11 @@ INVENTORY_PATH = os.path.join(PLUGINS_DIR, "inventory")
 AVALON_CONTAINERS = ":AVALON_CONTAINERS"
 
 
-class MayaHostImplementation(HostImplementation, IWorkfileHost, ILoadHost):
+class MayaHost(HostBase, IWorkfileHost, ILoadHost):
     name = "maya"
 
     def __init__(self):
-        super(MayaHostImplementation, self).__init__()
+        super(MayaHost, self).__init__()
         self._op_events = {}
 
     def install(self):

From 5b037244fe4e43c7a738e9fe2ace5c6f1883e72e Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 23 Jun 2022 11:36:22 +0300
Subject: [PATCH 0788/1227] Append capture schema.

---
 .../schemas/schema_maya_capture.json          | 71 ++++++++++++++++++-
 1 file changed, 70 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index ace9fc22da..f8dba0be4b 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -238,14 +238,83 @@
                             "key": "ssaoEnable",
                             "label": "Screen Space Ambient Occlusion"
                         },
+                        {
+                            "type": "number",
+                            "key": "ssaoAmount",
+                            "label": "SSAO Amount"
+                        },
+                        {
+                            "type": "number",
+                            "key": "ssaoRadius",
+                            "label": "SSAO Radius"
+                        },
+                        {
+                            "type": "number",
+                            "key": "ssaoFilterRadius",
+                            "label": "SSAO Filter Radius"
+                        },
+                        {
+                            "type": "number",
+                            "key": "ssaoSamples",
+                            "label": "SSAO Samples",
+                            "decimal": 0,
+                            "minimum": 8,
+                            "maximum": 32
+                        },
                         {
                             "type": "splitter"
                         },
                         {
                             "type": "boolean",
-                            "key": "fogging",
+                            "key": "hwFogEnable",
                             "label": "Enable Hardware Fog"
                         },
+                        {
+                            "type": "enum",
+                            "key": "hwFogFalloff",
+                            "label": "Hardware Falloff",
+                            "enum_items": [
+                                { "0": "Linear"},
+                                { "1": "Exponential"},
+                                { "2": "Exponential Squared"}
+                            ]
+                        },
+                        {
+                            "type": "number",
+                            "key": "hwFogStart",
+                            "label": "Fog Start"
+                        },
+                        {
+                            "type": "number",
+                            "key": "hwFogEnd",
+                            "label": "Fog End"
+                        },
+                        {
+                            "type": "number",
+                            "key": "hwFogAlpha",
+                            "label": "Enable Fog Alpha"
+                        },
+                        {
+                            "type": "splitter"
+                        },
+                        {
+                            "type": "boolean",
+                            "key": "motionBlurEnable",
+                            "label": "Enable Motion Blur"
+                        },
+                        {
+                            "type": "number",
+                            "key": "motionBlurSampleCount",
+                            "label": "Motion Blur Sample Count",
+                            "decimal": 0,
+                            "minimum": 8,
+                            "maximum": 32
+                        },
+                        {
+                            "type": "number",
+                            "key": "motionBlurShutterOpenFraction",
+                            "label": "Shutter Open Fraction"
+                        },
                         {
                             "type": "splitter"
                         },

From 4a521ec081e22b226655f49a41a38dbe31ef8f49 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 23 Jun 2022 11:39:23 +0300
Subject: [PATCH 0789/1227] Adjust

---
 .../settings/defaults/project_settings/maya.json    | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 8494989556..437adbc1f0 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -501,7 +501,18 @@
                     "textures": true,
                     "twoSidedLighting": true,
                     "ssaoEnable": true,
-                    "fogging": true,
+                    "ssaoAmount": 0,
+                    "ssaoRadius": 0,
+                    "ssaoFilterRadius": 0,
+                    "ssaoSamples": 8,
+                    "hwFogEnable": true,
+                    "hwFogFalloff": "0",
+                    "hwFogStart": 0,
+                    "hwFogEnd": 0,
+                    "hwFogAlpha": 0,
+                    "motionBlurEnable": true,
+                    "motionBlurSampleCount": 8,
+                    "motionBlurShutterOpenFraction": 0,
                     "cameras": false,
                     "clipGhosts": false,
                     "controlVertices": false,

From ea6b098bb2f86d027815e8e685ff5932a85fcc73 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 23 Jun 2022 11:40:01 +0300
Subject: [PATCH 0790/1227] Adjust `load_capture_preset()` to work with
 additional settings.

---
 openpype/hosts/maya/api/lib.py | 62 +++++++++++++++++++++++++++++++++-
 1 file changed, 61 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index de9a9da911..bd403ad340 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2525,8 +2525,19 @@ def load_capture_preset(data=None):
         if key == 'ssaoEnable':
             if preset[id][key] is True:
                 temp_options2['ssaoEnable'] = True
+                temp_options2['ssaoSamples'] = preset[id][key]
             else:
                 temp_options2['ssaoEnable'] = False
+                temp_options2['ssaoSamples'] = preset[id][key]
+
+        if key == 'ssaoAmount':
+            temp_options2['ssaoAmount'] = preset[id][key]
+
+        if key == 'ssaoRadius':
+            temp_options2['ssaoRadius'] = preset[id][key]
+
+        if key == 'ssaoFilterRadius':
+            temp_options2['ssaoFilterRadius'] = preset[id][key]
 
         if key == 'alphaCut':
             temp_options2['transparencyAlgorithm'] = 5
@@ -2535,6 +2546,42 @@ def load_capture_preset(data=None):
         if key == 'headsUpDisplay':
             temp_options['headsUpDisplay'] = True
 
+        if key == 'hwFogEnable':
+            if preset[id][key] is True:
+                temp_options2['hwFogEnable'] = True
+            else:
+                temp_options2['hwFogEnable'] = False
+
+        if key == 'hwFogStart':
+            temp_options2['hwFogStart'] = preset[id][key]
+
+        if key == 'hwFogEnd':
+            temp_options2['hwFogEnd'] = preset[id][key]
+
+        if key == 'hwFogAlpha':
+            temp_options2['hwFogAlpha'] = preset[id][key]
+
+        if key == 'hwFogFalloff':
+            temp_options2['hwFogFalloff'] = preset[id][key]
+
+        if key == 'motionBlurEnable':
+            if preset[id][key] is True:
+                temp_options2['motionBlurEnable'] = True
+            else:
+                temp_options2['motionBlurEnable'] = False
+
+        if key == 'motionBlurSampleCount':
+            temp_options2['motionBlurSampleCount'] = preset[id][key]
+
+        if key == 'motionBlurShutterOpenFraction':
+            temp_options2['motionBlurShutterOpenFraction'] = preset[id][key]
+
+        if key == 'lineAAEnable':
+            if preset[id][key] is True:
+                temp_options2['lineAAEnable'] = True
+            else:
+                temp_options2['lineAAEnable'] = False
+
         else:
             temp_options[str(key)] = preset[id][key]
 
@@ -2544,7 +2591,20 @@ def load_capture_preset(data=None):
                 'gpuCacheDisplayFilter',
                 'multiSample',
                 'ssaoEnable',
-                'textureMaxResolution'
+                'ssaoSamples',
+                'ssaoAmount',
+                'ssaoFilterRadius',
+                'ssaoRadius',
+                'hwFogEnable',
+                'hwFogStart',
+                'hwFogEnd',
+                'hwFogAlpha',
+                'hwFogFalloff',
+                'textureMaxResolution',
+                'motionBlurEnable',
+                'motionBlurSampleCount',
+                'motionBlurShutterOpenFraction',
+                'lineAAEnable',
                 ]:
         temp_options.pop(key, None)
 

From 20cf87c07d08a058eff3684eeb8e0df0fae1fb1d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 23 Jun 2022 11:03:08 +0200
Subject: [PATCH 0791/1227] forgotten changes of MayaHost imports

---
 openpype/hosts/maya/startup/userSetup.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/startup/userSetup.py b/openpype/hosts/maya/startup/userSetup.py
index daaf305612..10e68c2ddb 100644
--- a/openpype/hosts/maya/startup/userSetup.py
+++ b/openpype/hosts/maya/startup/userSetup.py
@@ -1,10 +1,10 @@
 import os
 from openpype.api import get_project_settings
 from openpype.pipeline import install_host
-from openpype.hosts.maya.api import MayaHostImplementation
+from openpype.hosts.maya.api import MayaHost
 from maya import cmds
 
-host = MayaHostImplementation()
+host = MayaHost()
 install_host(host)
 
 

From f5e3f56981660fd6131cf80d802cb6ed382a6915 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 23 Jun 2022 12:31:50 +0300
Subject: [PATCH 0792/1227] Append AA flag as schema key.

---
 .../schemas/schema_maya_capture.json                | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index f8dba0be4b..2c5aed8a67 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -233,6 +233,14 @@
                         {
                             "type": "splitter"
                         },
+                        {
+                            "type": "boolean",
+                            "key": "lineAAEnable",
+                            "label": "Enable Anti-Aliasing"
+                        },
+                        {
+                            "type": "splitter"
+                        },
                         {
                             "type": "boolean",
                             "key": "ssaoEnable",
@@ -313,7 +321,10 @@
                         {
                             "type": "number",
                             "key": "motionBlurShutterOpenFraction",
-                            "label": "Shutter Open Fraction"
+                            "label": "Shutter Open Fraction",
+                            "decimal": 3,
+                            "minimum": 0.01,
+                            "maximum": 32
                         },
                         {
                             "type": "splitter"

From f497956c5fc31657f9798137c303b359004046c9 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 23 Jun 2022 12:31:58 +0300
Subject: [PATCH 0793/1227] Adjust schema defaults.

---
 openpype/settings/defaults/project_settings/maya.json | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 437adbc1f0..48a34068db 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -500,6 +500,7 @@
                     "shadows": true,
                     "textures": true,
                     "twoSidedLighting": true,
+                    "lineAAEnable": true,
                     "ssaoEnable": true,
                     "ssaoAmount": 0,
                     "ssaoRadius": 0,
@@ -512,7 +513,7 @@
                     "hwFogAlpha": 0,
                     "motionBlurEnable": true,
                     "motionBlurSampleCount": 8,
-                    "motionBlurShutterOpenFraction": 0,
+                    "motionBlurShutterOpenFraction": 0.01,
                     "cameras": false,
                     "clipGhosts": false,
                     "controlVertices": false,

From 98b912f0b36634c345faaf0e617385460a402af1 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 23 Jun 2022 12:32:15 +0300
Subject: [PATCH 0794/1227] Change key check placement.

---
 openpype/hosts/maya/api/lib.py | 25 +++++++++++--------------
 1 file changed, 11 insertions(+), 14 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index bd403ad340..12cbac2a32 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2525,10 +2525,11 @@ def load_capture_preset(data=None):
         if key == 'ssaoEnable':
             if preset[id][key] is True:
                 temp_options2['ssaoEnable'] = True
-                temp_options2['ssaoSamples'] = preset[id][key]
             else:
                 temp_options2['ssaoEnable'] = False
-                temp_options2['ssaoSamples'] = preset[id][key]
+
+        if key == 'ssaoSamples':
+            temp_options2['ssaoSamples'] = preset[id][key]
 
         if key == 'ssaoAmount':
             temp_options2['ssaoAmount'] = preset[id][key]
@@ -2549,20 +2550,16 @@ def load_capture_preset(data=None):
         if key == 'hwFogEnable':
             if preset[id][key] is True:
                 temp_options2['hwFogEnable'] = True
+                temp_options2['hwFogStart'] = preset[id][key]
+                temp_options2['hwFogEnd'] = preset[id][key]
+                temp_options2['hwFogAlpha'] = preset[id][key]
+                temp_options2['hwFogFalloff'] = preset[id][key]
             else:
                 temp_options2['hwFogEnable'] = False
-
-        if key == 'hwFogStart':
-            temp_options2['hwFogStart'] = preset[id][key]
-
-        if key == 'hwFogEnd':
-            temp_options2['hwFogEnd'] = preset[id][key]
-
-        if key == 'hwFogAlpha':
-            temp_options2['hwFogAlpha'] = preset[id][key]
-
-        if key == 'hwFogFalloff':
-            temp_options2['hwFogFalloff'] = preset[id][key]
+                temp_options2['hwFogStart'] = preset[id][key]
+                temp_options2['hwFogEnd'] = preset[id][key]
+                temp_options2['hwFogAlpha'] = preset[id][key]
+                temp_options2['hwFogFalloff'] = preset[id][key]
 
         if key == 'motionBlurEnable':
             if preset[id][key] is True:

From ae897ed2901de70da53ff16bfc5a6d3fa1bc1432 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 23 Jun 2022 13:07:38 +0300
Subject: [PATCH 0795/1227] Append Fog Color Key to schema.

---
 .../schemas/projects_schema/schemas/schema_maya_capture.json | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index 2c5aed8a67..08207824b1 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -302,6 +302,11 @@
                             "key": "hwFogAlpha",
                             "label": "Enable Fog Alpha"
                         },
+                        {
+                            "type": "color",
+                            "key": "hwFogColor",
+                            "label": "Fog Color"
+                        },
                         {
                             "type": "splitter"
                         },

From 4c1bba042d69bfbc807f2aea81a004fe27593163 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 23 Jun 2022 13:08:13 +0300
Subject: [PATCH 0796/1227] Append Fog Color to functionk, fix loop bug.

---
 openpype/hosts/maya/api/lib.py | 25 +++++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 12cbac2a32..4b76757e97 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2550,16 +2550,24 @@ def load_capture_preset(data=None):
         if key == 'hwFogEnable':
             if preset[id][key] is True:
                 temp_options2['hwFogEnable'] = True
-                temp_options2['hwFogStart'] = preset[id][key]
-                temp_options2['hwFogEnd'] = preset[id][key]
-                temp_options2['hwFogAlpha'] = preset[id][key]
-                temp_options2['hwFogFalloff'] = preset[id][key]
+
             else:
                 temp_options2['hwFogEnable'] = False
-                temp_options2['hwFogStart'] = preset[id][key]
-                temp_options2['hwFogEnd'] = preset[id][key]
-                temp_options2['hwFogAlpha'] = preset[id][key]
-                temp_options2['hwFogFalloff'] = preset[id][key]
+
+        if key == 'hwFogStart':
+            temp_options2['hwFogStart'] = preset[id][key]
+
+        if key == 'hwFogEnd':
+            temp_options2['hwFogEnd'] = preset[id][key]
+
+        if key == 'hwFogAlpha':
+            temp_options2['hwFogAlpha'] = preset[id][key]
+
+        if key == 'hwFogFalloff':
+            temp_options2['hwFogFalloff'] = int(preset[id][key])
+
+        if key == 'hwFogColor':
+            temp_options2['hwFogColor'] = preset[id][key]
 
         if key == 'motionBlurEnable':
             if preset[id][key] is True:
@@ -2597,6 +2605,7 @@ def load_capture_preset(data=None):
                 'hwFogEnd',
                 'hwFogAlpha',
                 'hwFogFalloff',
+                'hwFogColor',
                 'textureMaxResolution',
                 'motionBlurEnable',
                 'motionBlurSampleCount',

From bb339e0bbd9828a650f213d8839fecf7ca0f3ff7 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Thu, 23 Jun 2022 13:08:26 +0300
Subject: [PATCH 0797/1227] Append schema default for color.

---
 openpype/settings/defaults/project_settings/maya.json | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 48a34068db..874e23400e 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -511,6 +511,12 @@
                     "hwFogStart": 0,
                     "hwFogEnd": 0,
                     "hwFogAlpha": 0,
+                    "hwFogColor": [
+                        158,
+                        53,
+                        53,
+                        255
+                    ],
                     "motionBlurEnable": true,
                     "motionBlurSampleCount": 8,
                     "motionBlurShutterOpenFraction": 0.01,

From 25b7f98022e7ac3a9e85352713130ba1121a05bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Thu, 23 Jun 2022 12:59:01 +0200
Subject: [PATCH 0798/1227] Renaming: Kitsu Plural func sync_all_projects

---
 openpype/modules/kitsu/kitsu_module.py             | 4 ++--
 openpype/modules/kitsu/utils/update_op_with_zou.py | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/kitsu/kitsu_module.py b/openpype/modules/kitsu/kitsu_module.py
index 8e7ab6f78c..d19d14dda7 100644
--- a/openpype/modules/kitsu/kitsu_module.py
+++ b/openpype/modules/kitsu/kitsu_module.py
@@ -129,8 +129,8 @@ def sync_service(login, password):
         login (str): Kitsu user login
         password (str): Kitsu user password
     """
-    from .utils.update_op_with_zou import sync_all_project
+    from .utils.update_op_with_zou import sync_all_projects
     from .utils.sync_service import start_listeners
 
-    sync_all_project(login, password)
+    sync_all_projects(login, password)
     start_listeners(login, password)
diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 08e50d959b..cd98c0d204 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -250,7 +250,7 @@ def write_project_to_op(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
     )
 
 
-def sync_all_project(login: str, password: str):
+def sync_all_projects(login: str, password: str):
     """Update all OP projects in DB with Zou data.
 
     Args:

From 5325b6eb508d695ea29be31c3ff73347ada7346b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Thu, 23 Jun 2022 13:57:57 +0200
Subject: [PATCH 0799/1227] :package: update OIIO for linux

---
 pyproject.toml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 4b297fe042..5bf4f18db8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -114,6 +114,8 @@ build-backend = "poetry.core.masonry.api"
 # https://pip.pypa.io/en/stable/cli/pip_install/#requirement-specifiers
 version = "==5.15.2"
 
+# TODO: we will need to handle different linux flavours here and
+#       also different macos versions too.
 [openpype.thirdparty.ffmpeg.windows]
 url = "https://distribute.openpype.io/thirdparty/ffmpeg-4.4-windows.zip"
 hash = "dd51ba29d64ee238e7c4c3c7301b19754c3f0ee2e2a729c20a0e2789e72db925"
@@ -131,8 +133,8 @@ url = "https://distribute.openpype.io/thirdparty/oiio_tools-2.3.10-windows.zip"
 hash = "b9950f5d2fa3720b52b8be55bacf5f56d33f9e029d38ee86534995f3d8d253d2"
 
 [openpype.thirdparty.oiio.linux]
-url = "https://distribute.openpype.io/thirdparty/oiio_tools-2.2.12-linux.tgz"
-hash = "de63a8bf7f6c45ff59ecafeba13123f710c2cbc1783ec9e0b938e980d4f5c37f"
+url = "https://distribute.openpype.io/thirdparty/oiio_tools-2.2.20-linux-centos7"
+hash = "BE1ABF8A50E9DA5913298447421AF0A17829D83ED6252AE1D40DA7FA36A78787"
 
 [openpype.thirdparty.oiio.darwin]
 url = "https://distribute.openpype.io/thirdparty/oiio-2.2.0-darwin.tgz"

From 68ee05bd36312f7bb5f476125dee26bf7241f239 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 23 Jun 2022 14:00:18 +0200
Subject: [PATCH 0800/1227] filter representations before integration starts

---
 openpype/plugins/publish/integrate_new.py | 62 +++++++++++++++--------
 1 file changed, 41 insertions(+), 21 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 2471105250..918ca4ba94 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -145,9 +145,43 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         if instance.data.get("farm"):
             return
 
+        # Prepare repsentations that should be integrated
+        repres = instance.data.get("representations")
+        # Raise error if instance don't have any representations
+        if not repres:
+            raise ValueError(
+                "Instance {} has no files to transfer".format(
+                    instance.data["family"]
+                )
+            )
+
+        # Validate type of stored representations
+        if not isinstance(repres, (list, tuple)):
+            raise TypeError(
+                "Instance 'files' must be a list, got: {0} {1}".format(
+                    str(type(repres)), str(repres)
+                )
+            )
+
+        # Filter representations
+        filtered_repres = []
+        for repre in repres:
+            if "delete" in repre.get("tags", []):
+                continue
+            filtered_repres.append(repre)
+
+        # Skip instance if there are not representations to integrate
+        #   all representations should not be integrated
+        if not filtered_repres:
+            self.log.warning((
+                "Skipping, there are no representations"
+                " to integrate for instance {}"
+            ).format(instance.data["family"]))
+            return
+
         self.integrated_file_sizes = {}
         try:
-            self.register(instance)
+            self.register(instance, filtered_repres)
             self.log.info("Integrated Asset in to the database ...")
             self.log.info("instance.data: {}".format(instance.data))
             self.handle_destination_files(self.integrated_file_sizes,
@@ -158,7 +192,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             self.handle_destination_files(self.integrated_file_sizes, 'remove')
             six.reraise(*sys.exc_info())
 
-    def register(self, instance):
+    def register(self, instance, repres):
         # Required environment variables
         anatomy_data = instance.data["anatomyData"]
 
@@ -236,18 +270,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "Establishing staging directory @ {0}".format(stagingdir)
             )
 
-        # Ensure at least one file is set up for transfer in staging dir.
-        repres = instance.data.get("representations")
-        repres = instance.data.get("representations")
-        msg = "Instance {} has no files to transfer".format(
-            instance.data["family"])
-        assert repres, msg
-        assert isinstance(repres, (list, tuple)), (
-            "Instance 'files' must be a list, got: {0} {1}".format(
-                str(type(repres)), str(repres)
-            )
-        )
-
         subset = self.get_subset(asset_entity, instance)
         instance.data["subsetEntity"] = subset
 
@@ -270,7 +292,10 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         self.log.debug("Creating version ...")
 
-        new_repre_names_low = [_repre["name"].lower() for _repre in repres]
+        new_repre_names_low = [
+            _repre["name"].lower()
+            for _repre in repres
+        ]
 
         existing_version = legacy_io.find_one({
             'type': 'version',
@@ -373,18 +398,13 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         if profile:
             template_name = profile["template_name"]
 
-
-
         published_representations = {}
-        for idx, repre in enumerate(instance.data["representations"]):
+        for idx, repre in enumerate(repres):
             # reset transfers for next representation
             # instance.data['transfers'] is used as a global variable
             # in current codebase
             instance.data['transfers'] = list(orig_transfers)
 
-            if "delete" in repre.get("tags", []):
-                continue
-
             published_files = []
 
             # create template data for Anatomy

From 7cb38127658e2ba43780e0a537350f407229f5d1 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 23 Jun 2022 14:09:47 +0200
Subject: [PATCH 0801/1227] moved reset of tranfers to the end of repre
 iteration

---
 openpype/plugins/publish/integrate_new.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 918ca4ba94..4c14c17dae 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -400,11 +400,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         published_representations = {}
         for idx, repre in enumerate(repres):
-            # reset transfers for next representation
-            # instance.data['transfers'] is used as a global variable
-            # in current codebase
-            instance.data['transfers'] = list(orig_transfers)
-
             published_files = []
 
             # create template data for Anatomy
@@ -682,6 +677,10 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "published_files": published_files
             }
             self.log.debug("__ representations: {}".format(representations))
+            # reset transfers for next representation
+            # instance.data['transfers'] is used as a global variable
+            # in current codebase
+            instance.data['transfers'] = list(orig_transfers)
 
         # Remove old representations if there are any (before insertion of new)
         if existing_repres:

From 0a20a69e0e37a656d2004abf17259029c1750d6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Thu, 23 Jun 2022 14:46:06 +0200
Subject: [PATCH 0802/1227] :bug: fix extension

---
 pyproject.toml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 5bf4f18db8..3a5acb8490 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -133,8 +133,8 @@ url = "https://distribute.openpype.io/thirdparty/oiio_tools-2.3.10-windows.zip"
 hash = "b9950f5d2fa3720b52b8be55bacf5f56d33f9e029d38ee86534995f3d8d253d2"
 
 [openpype.thirdparty.oiio.linux]
-url = "https://distribute.openpype.io/thirdparty/oiio_tools-2.2.20-linux-centos7"
-hash = "BE1ABF8A50E9DA5913298447421AF0A17829D83ED6252AE1D40DA7FA36A78787"
+url = "https://distribute.openpype.io/thirdparty/oiio_tools-2.2.20-linux-centos7.tgz"
+hash = "be1abf8a50e9da5913298447421af0a17829d83ed6252ae1d40da7fa36a78787"
 
 [openpype.thirdparty.oiio.darwin]
 url = "https://distribute.openpype.io/thirdparty/oiio-2.2.0-darwin.tgz"

From ecd2686ad19af5ef9a47d197c2f439be6bc143bd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 23 Jun 2022 14:47:16 +0200
Subject: [PATCH 0803/1227] added some docstrings

---
 openpype/host/host.py | 95 ++++++++++++++++++++++++++++---------------
 1 file changed, 62 insertions(+), 33 deletions(-)

diff --git a/openpype/host/host.py b/openpype/host/host.py
index 2a59daf473..ab75ec5bc3 100644
--- a/openpype/host/host.py
+++ b/openpype/host/host.py
@@ -5,6 +5,13 @@ import six
 
 
 class MissingMethodsError(ValueError):
+    """Exception when host miss some required methods for specific workflow.
+
+    Args:
+        host (HostBase): Host implementation where are missing methods.
+        missing_methods (list[str]): List of missing methods.
+    """
+
     def __init__(self, host, missing_methods):
         joined_missing = ", ".join(
             ['"{}"'.format(item) for item in missing_methods]
@@ -53,15 +60,15 @@ class HostBase(object):
     install_host(host)
     ```
 
-    # TODOs
-    - move content of 'install_host' as method of this class
-        - register host object
-        - install legacy_io
-        - install global plugin paths
-    - store registered plugin paths to this object
-    - handle current context (project, asset, task)
-        - this must be done in many separated steps
-    - have it's object of host tools instead of using globals
+    Todo:
+        - move content of 'install_host' as method of this class
+            - register host object
+            - install legacy_io
+            - install global plugin paths
+        - store registered plugin paths to this object
+        - handle current context (project, asset, task)
+            - this must be done in many separated steps
+        - have it's object of host tools instead of using globals
 
     This implementation will probably change over time when more
         functionality and responsibility will be added.
@@ -75,7 +82,7 @@ class HostBase(object):
         Register DCC callbacks, host specific plugin paths, targets etc.
         (Part of what 'install' did in 'avalon' concept.)
 
-        NOTE:
+        Note:
             At this moment global "installation" must happen before host
             installation. Because of this current limitation it is recommended
             to implement 'install' method which is triggered after global
@@ -127,10 +134,10 @@ class HostBase(object):
 
         Should return current context title if possible.
 
-        NOTE: This method is used only for UI purposes so it is possible to
-            return some logical title for contextless cases.
-
-        Is not meant for "Context menu" label.
+        Note:
+            This method is used only for UI purposes so it is possible to
+                return some logical title for contextless cases.
+            Is not meant for "Context menu" label.
 
         Returns:
             str: Context title.
@@ -159,6 +166,9 @@ class HostBase(object):
 
         This is DCC specific. Some may not allow to implement this ability
         that is reason why default implementation is empty context manager.
+
+        Yields:
+            None: Yield when is ready to restore selected at the end.
         """
 
         try:
@@ -173,11 +183,11 @@ class ILoadHost:
     The load plugins can do referencing even without implementation of methods
     here, but switch and removement of containers would not be possible.
 
-    QUESTIONS
-    - Is list container dependency of host or load plugins?
-    - Should this be directly in HostBase?
-        - how to find out if referencing is available?
-        - do we need to know that?
+    Questions:
+        - Is list container dependency of host or load plugins?
+        - Should this be directly in HostBase?
+            - how to find out if referencing is available?
+            - do we need to know that?
     """
 
     @staticmethod
@@ -188,6 +198,9 @@ class ILoadHost:
         loading. Checks only existence of methods.
 
         Args:
+            HostBase: Object of host where to look for required methods.
+
+        Returns:
             list[str]: Missing method implementations for loading workflow.
         """
 
@@ -202,6 +215,9 @@ class ILoadHost:
     def validate_load_methods(host):
         """Validate implemented methods of host for load workflow.
 
+        Args:
+            HostBase: Object of host to validate.
+
         Raises:
             MissingMethodsError: If there are missing methods on host
                 implementation.
@@ -216,7 +232,7 @@ class ILoadHost:
 
         This can be implemented in hosts where referencing can be used.
 
-        TODO:
+        Todo:
             Rename function to something more self explanatory.
                 Suggestion: 'get_referenced_containers'
 
@@ -242,6 +258,9 @@ class IWorkfileHost:
         Method is used for validation of implemented functions related to
         workfiles. Checks only existence of methods.
 
+        Args:
+            HostBase: Object of host where to look for required methods.
+
         Returns:
             list[str]: Missing method implementations for workfiles workflow.
         """
@@ -264,6 +283,9 @@ class IWorkfileHost:
     def validate_workfile_methods(host):
         """Validate implemented methods of host for workfiles workflow.
 
+        Args:
+            HostBase: Object of host to validate.
+
         Raises:
             MissingMethodsError: If there are missing methods on host
                 implementation.
@@ -276,9 +298,10 @@ class IWorkfileHost:
     def file_extensions(self):
         """Extensions that can be used as save.
 
-        QUESTION: This could potentially use 'HostDefinition'.
+        Questions:
+            This could potentially use 'HostDefinition'.
 
-        TODO:
+        Todo:
             Rename to 'get_workfile_extensions'.
         """
 
@@ -288,7 +311,7 @@ class IWorkfileHost:
     def save_file(self, dst_path=None):
         """Save currently opened scene.
 
-        TODO:
+        Todo:
             Rename to 'save_current_workfile'.
 
         Args:
@@ -302,7 +325,7 @@ class IWorkfileHost:
     def open_file(self, filepath):
         """Open passed filepath in the host.
 
-        TODO:
+        Todo:
             Rename to 'open_workfile'.
 
         Args:
@@ -315,7 +338,7 @@ class IWorkfileHost:
     def current_file(self):
         """Retreive path to current opened file.
 
-        TODO:
+        Todo:
             Rename to 'get_current_workfile'.
 
         Returns:
@@ -342,16 +365,16 @@ class IWorkfileHost:
     def work_root(self, session):
         """Modify workdir per host.
 
-        WARNING:
-        We must handle this modification with more sofisticated way because
-        this can't be called out of DCC so opening of last workfile
-        (calculated before DCC is launched) is complicated. Also breaking
-        defined work template is not a good idea.
-        Only place where it's really used and can make sense is Maya. There
-        workspace.mel can modify subfolders where to look for maya files.
-
         Default implementation keeps workdir untouched.
 
+        Warnings:
+            We must handle this modification with more sofisticated way because
+            this can't be called out of DCC so opening of last workfile
+            (calculated before DCC is launched) is complicated. Also breaking
+            defined work template is not a good idea.
+            Only place where it's really used and can make sense is Maya. There
+            workspace.mel can modify subfolders where to look for maya files.
+
         Args:
             session (dict): Session context data.
 
@@ -381,6 +404,9 @@ class INewPublisher:
         new publish creation. Checks only existence of methods.
 
         Args:
+            HostBase: Object of host where to look for required methods.
+
+        Returns:
             list[str]: Missing method implementations for new publsher
                 workflow.
         """
@@ -399,6 +425,9 @@ class INewPublisher:
     def validate_publish_methods(host):
         """Validate implemented methods of host for create-publish workflow.
 
+        Args:
+            HostBase: Object of host to validate.
+
         Raises:
             MissingMethodsError: If there are missing methods on host
                 implementation.

From 4a8dfc3db9988b61572aa307fe01b8fe1e011e8e Mon Sep 17 00:00:00 2001
From: Kaa Maurice <kaalium@gmail.com>
Date: Thu, 16 Jun 2022 14:15:26 +0200
Subject: [PATCH 0804/1227] blender install pyside2 for all platforms

---
 .../hosts/blender/hooks/pre_pyside_install.py | 112 ++++++++++++------
 1 file changed, 75 insertions(+), 37 deletions(-)

diff --git a/openpype/hosts/blender/hooks/pre_pyside_install.py b/openpype/hosts/blender/hooks/pre_pyside_install.py
index a37f8f0379..aaa545b2cf 100644
--- a/openpype/hosts/blender/hooks/pre_pyside_install.py
+++ b/openpype/hosts/blender/hooks/pre_pyside_install.py
@@ -1,6 +1,7 @@
 import os
 import re
 import subprocess
+from platform import system
 from openpype.lib import PreLaunchHook
 
 
@@ -13,12 +14,9 @@ class InstallPySideToBlender(PreLaunchHook):
 
     For pipeline implementation is required to have Qt binding installed in
     blender's python packages.
-
-    Prelaunch hook can work only on Windows right now.
     """
 
     app_groups = ["blender"]
-    platforms = ["windows"]
 
     def execute(self):
         # Prelaunch hook is not crucial
@@ -34,25 +32,28 @@ class InstallPySideToBlender(PreLaunchHook):
         # Get blender's python directory
         version_regex = re.compile(r"^[2-3]\.[0-9]+$")
 
+        platform = system().lower()
         executable = self.launch_context.executable.executable_path
-        if os.path.basename(executable).lower() != "blender.exe":
+        expected_executable = "blender"
+        if platform == "windows":
+            expected_executable += ".exe"
+
+        if os.path.basename(executable).lower() != expected_executable:
             self.log.info((
-                "Executable does not lead to blender.exe file. Can't determine"
-                " blender's python to check/install PySide2."
+                f"Executable does not lead to {expected_executable} file."
+                "Can't determine blender's python to check/install PySide2."
             ))
             return
 
-        executable_dir = os.path.dirname(executable)
+        versions_dir = os.path.dirname(executable)
+        if platform == "darwin":
+            versions_dir = os.path.join(
+                os.path.dirname(versions_dir), "Resources"
+            )
         version_subfolders = []
-        for name in os.listdir(executable_dir):
-            fullpath = os.path.join(name, executable_dir)
-            if not os.path.isdir(fullpath):
-                continue
-
-            if not version_regex.match(name):
-                continue
-
-            version_subfolders.append(name)
+        for dir_entry in os.scandir(versions_dir):
+            if dir_entry.is_dir() and version_regex.match(dir_entry.name):
+                version_subfolders.append(dir_entry.name)
 
         if not version_subfolders:
             self.log.info(
@@ -72,16 +73,21 @@ class InstallPySideToBlender(PreLaunchHook):
 
         version_subfolder = version_subfolders[0]
 
-        pythond_dir = os.path.join(
-            os.path.dirname(executable),
-            version_subfolder,
-            "python"
-        )
+        python_dir = os.path.join(versions_dir, version_subfolder, "python")
+        python_lib = os.path.join(python_dir, "lib")
+        python_version = "python"
+
+        if platform != "windows":
+            for dir_entry in os.scandir(python_lib):
+                if dir_entry.is_dir() and dir_entry.name.startswith("python"):
+                    python_lib = dir_entry.path
+                    python_version = dir_entry.name
+                    break
 
         # Change PYTHONPATH to contain blender's packages as first
         python_paths = [
-            os.path.join(pythond_dir, "lib"),
-            os.path.join(pythond_dir, "lib", "site-packages"),
+            python_lib,
+            os.path.join(python_lib, "site-packages"),
         ]
         python_path = self.launch_context.env.get("PYTHONPATH") or ""
         for path in python_path.split(os.pathsep):
@@ -91,7 +97,12 @@ class InstallPySideToBlender(PreLaunchHook):
         self.launch_context.env["PYTHONPATH"] = os.pathsep.join(python_paths)
 
         # Get blender's python executable
-        python_executable = os.path.join(pythond_dir, "bin", "python.exe")
+        python_bin = os.path.join(python_dir, "bin")
+        if platform == "windows":
+            python_executable = os.path.join(python_bin, "python.exe")
+        else:
+            python_executable = os.path.join(python_bin, python_version)
+
         if not os.path.exists(python_executable):
             self.log.warning(
                 "Couldn't find python executable for blender. {}".format(
@@ -106,7 +117,15 @@ class InstallPySideToBlender(PreLaunchHook):
             return
 
         # Install PySide2 in blender's python
-        self.install_pyside_windows(python_executable)
+        if platform == "windows":
+            result = self.install_pyside_windows(python_executable)
+        else:
+            result = self.install_pyside(python_executable)
+
+        if result:
+            self.log.info("Successfully installed PySide2 module to blender.")
+        else:
+            self.log.warning("Failed to install PySide2 module to blender.")
 
     def install_pyside_windows(self, python_executable):
         """Install PySide2 python module to blender's python.
@@ -144,21 +163,38 @@ class InstallPySideToBlender(PreLaunchHook):
                 lpDirectory=os.path.dirname(python_executable)
             )
             process_handle = process_info["hProcess"]
-            obj = win32event.WaitForSingleObject(
-                process_handle, win32event.INFINITE
-            )
+            win32event.WaitForSingleObject(process_handle, win32event.INFINITE)
             returncode = win32process.GetExitCodeProcess(process_handle)
-            if returncode == 0:
-                self.log.info(
-                    "Successfully installed PySide2 module to blender."
-                )
-                return
+            return returncode == 0
         except pywintypes.error:
             pass
 
-        self.log.warning("Failed to install PySide2 module to blender.")
+    @staticmethod
+    def install_pyside(python_executable):
+        """Install PySide2 python module to blender's python."""
+        try:
+            # Parameters
+            # - use "-m pip" as module pip to install PySide2 and argument
+            #   "--ignore-installed" is to force install module to blender's
+            #   site-packages and make sure it is binary compatible
+            args = [
+                python_executable,
+                "-m",
+                "pip",
+                "install",
+                "--ignore-installed",
+                "PySide2",
+            ]
+            process = subprocess.Popen(
+                args, stdout=subprocess.PIPE, universal_newlines=True
+            )
+            stdout, _ = process.communicate()
+            return process.returncode == 0
+        except subprocess.SubprocessError:
+            pass
 
-    def is_pyside_installed(self, python_executable):
+    @staticmethod
+    def is_pyside_installed(python_executable):
         """Check if PySide2 module is in blender's pip list.
 
         Check that PySide2 is installed directly in blender's site-packages.
@@ -167,9 +203,11 @@ class InstallPySideToBlender(PreLaunchHook):
         """
         # Get pip list from blender's python executable
         args = [python_executable, "-m", "pip", "list"]
-        process = subprocess.Popen(args, stdout=subprocess.PIPE)
+        process = subprocess.Popen(
+            args, stdout=subprocess.PIPE, universal_newlines=True
+        )
         stdout, _ = process.communicate()
-        lines = stdout.decode().split("\r\n")
+        lines = stdout.split(os.linesep)
         # Second line contain dashes that define maximum length of module name.
         #   Second column of dashes define maximum length of module version.
         package_dashes, *_ = lines[1].split(" ")

From b42505b430fa77608c722d91fce2f50ff38ba5e6 Mon Sep 17 00:00:00 2001
From: Kaa Maurice <kaalium@gmail.com>
Date: Tue, 21 Jun 2022 15:19:34 +0200
Subject: [PATCH 0805/1227] fix pre_pyside_install for all platform

---
 openpype/hosts/blender/hooks/pre_pyside_install.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/blender/hooks/pre_pyside_install.py b/openpype/hosts/blender/hooks/pre_pyside_install.py
index aaa545b2cf..d2c07e860d 100644
--- a/openpype/hosts/blender/hooks/pre_pyside_install.py
+++ b/openpype/hosts/blender/hooks/pre_pyside_install.py
@@ -203,11 +203,9 @@ class InstallPySideToBlender(PreLaunchHook):
         """
         # Get pip list from blender's python executable
         args = [python_executable, "-m", "pip", "list"]
-        process = subprocess.Popen(
-            args, stdout=subprocess.PIPE, universal_newlines=True
-        )
+        process = subprocess.Popen(args, stdout=subprocess.PIPE)
         stdout, _ = process.communicate()
-        lines = stdout.split(os.linesep)
+        lines = stdout.decode().split(os.linesep)
         # Second line contain dashes that define maximum length of module name.
         #   Second column of dashes define maximum length of module version.
         package_dashes, *_ = lines[1].split(" ")

From 1d6fff34746c34e76775d59118c1748a75ff1031 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Thu, 23 Jun 2022 15:11:18 +0200
Subject: [PATCH 0806/1227] :memo: update requirements for oiio on centos 7

---
 website/docs/dev_requirements.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/website/docs/dev_requirements.md b/website/docs/dev_requirements.md
index a10aea7865..eb4b132297 100644
--- a/website/docs/dev_requirements.md
+++ b/website/docs/dev_requirements.md
@@ -87,9 +87,11 @@ This can also be hosted on the cloud in fully distributed deployments.
 - [**Avalon**](https://github.com/getavalon)
 - [**Pyblish**](https://github.com/pyblish)
 - [**OpenTimelineIO**](https://github.com/PixarAnimationStudios/OpenTimelineIO)
-- [**OpenImageIO**](https://github.com/OpenImageIO/oiio)
+- [**OpenImageIO**](https://github.com/OpenImageIO/oiio) [^centos7]
 - [**FFmpeg**](https://github.com/FFmpeg/FFmpeg)
 
+[^centos7]: On Centos 7 you need to install additional libraries to support OIIO there - mainly boost
+and libraw (`sudo yum install boost-1.53.0` and `sudo yum install LibRaw`)
 
 ### Python modules we use and their licenses
 

From e36c80fd09adea0322bc03c3c4da1764cc620d62 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 23 Jun 2022 15:41:41 +0200
Subject: [PATCH 0807/1227] added type hints

---
 openpype/host/host.py | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/openpype/host/host.py b/openpype/host/host.py
index ab75ec5bc3..676f0e6771 100644
--- a/openpype/host/host.py
+++ b/openpype/host/host.py
@@ -3,6 +3,9 @@ import contextlib
 from abc import ABCMeta, abstractproperty, abstractmethod
 import six
 
+# NOTE can't import 'typing' because of issues in Maya 2020
+#   - shiboken crashes on 'typing' module import
+
 
 class MissingMethodsError(ValueError):
     """Exception when host miss some required methods for specific workflow.
@@ -77,6 +80,7 @@ class HostBase(object):
     _log = None
 
     def __init__(self):
+        # type: () -> None
         """Initialization of host.
 
         Register DCC callbacks, host specific plugin paths, targets etc.
@@ -93,17 +97,20 @@ class HostBase(object):
 
     @property
     def log(self):
+        # type: () -> logging.Logger
         if self._log is None:
             self._log = logging.getLogger(self.__class__.__name__)
         return self._log
 
     @abstractproperty
     def name(self):
+        # type: () -> str
         """Host implementation name."""
 
         pass
 
     def get_current_context(self):
+        # type: () -> Mapping[str, Union[str, None]]
         """Get current context information.
 
         This method should be used to get current context of host. Usage of
@@ -130,6 +137,7 @@ class HostBase(object):
         }
 
     def get_context_title(self):
+        # type: () -> Union[str, None]
         """Context title shown for UI purposes.
 
         Should return current context title if possible.
@@ -162,6 +170,7 @@ class HostBase(object):
 
     @contextlib.contextmanager
     def maintained_selection(self):
+        # type: () ->  None
         """Some functionlity will happen but selection should stay same.
 
         This is DCC specific. Some may not allow to implement this ability
@@ -192,6 +201,7 @@ class ILoadHost:
 
     @staticmethod
     def get_missing_load_methods(host):
+        # type: (HostBase) ->  List[str]
         """Look for missing methods on host implementation.
 
         Method is used for validation of implemented functions related to
@@ -213,6 +223,7 @@ class ILoadHost:
 
     @staticmethod
     def validate_load_methods(host):
+        # type: (HostBase) ->  None
         """Validate implemented methods of host for load workflow.
 
         Args:
@@ -228,6 +239,7 @@ class ILoadHost:
 
     @abstractmethod
     def ls(self):
+        # type: (HostBase) ->  List[Mapping[str, Any]]
         """Retreive referenced containers from scene.
 
         This can be implemented in hosts where referencing can be used.
@@ -253,6 +265,7 @@ class IWorkfileHost:
 
     @staticmethod
     def get_missing_workfile_methods(host):
+        # type: (HostBase) ->  List[str]
         """Look for missing methods on host implementation.
 
         Method is used for validation of implemented functions related to
@@ -281,6 +294,7 @@ class IWorkfileHost:
 
     @staticmethod
     def validate_workfile_methods(host):
+        # type: (HostBase) ->  None
         """Validate implemented methods of host for workfiles workflow.
 
         Args:
@@ -296,6 +310,7 @@ class IWorkfileHost:
 
     @abstractmethod
     def file_extensions(self):
+        # type: () ->  List[str]
         """Extensions that can be used as save.
 
         Questions:
@@ -309,6 +324,7 @@ class IWorkfileHost:
 
     @abstractmethod
     def save_file(self, dst_path=None):
+        # type: (Optional[str]) ->  None
         """Save currently opened scene.
 
         Todo:
@@ -323,6 +339,7 @@ class IWorkfileHost:
 
     @abstractmethod
     def open_file(self, filepath):
+        # type: (str) ->  None
         """Open passed filepath in the host.
 
         Todo:
@@ -336,6 +353,7 @@ class IWorkfileHost:
 
     @abstractmethod
     def current_file(self):
+        # type: () ->  Union[str, None]
         """Retreive path to current opened file.
 
         Todo:
@@ -349,6 +367,7 @@ class IWorkfileHost:
         return None
 
     def has_unsaved_changes(self):
+        # type: () ->  Union[bool, None]
         """Currently opened scene is saved.
 
         Not all hosts can know if current scene is saved because the API of
@@ -363,6 +382,7 @@ class IWorkfileHost:
         return None
 
     def work_root(self, session):
+        # type: (Mapping[str, str]) ->  str
         """Modify workdir per host.
 
         Default implementation keeps workdir untouched.
@@ -398,6 +418,7 @@ class INewPublisher:
 
     @staticmethod
     def get_missing_publish_methods(host):
+        # type: (HostBase) ->  List[str]
         """Look for missing methods on host implementation.
 
         Method is used for validation of implemented functions related to
@@ -423,6 +444,7 @@ class INewPublisher:
 
     @staticmethod
     def validate_publish_methods(host):
+        # type: (HostBase) ->  None
         """Validate implemented methods of host for create-publish workflow.
 
         Args:
@@ -438,6 +460,7 @@ class INewPublisher:
 
     @abstractmethod
     def get_context_data(self):
+        # type: () ->  Mapping[str, Any]
         """Get global data related to creation-publishing from workfile.
 
         These data are not related to any created instance but to whole
@@ -455,6 +478,7 @@ class INewPublisher:
 
     @abstractmethod
     def update_context_data(self, data, changes):
+        # type: (Mapping[str, Any], Mapping[str, Any]) ->  None
         """Store global context data to workfile.
 
         Called when some values in context data has changed.

From 07e67a14b76047129fa0dcf49ec1be452c6af79b Mon Sep 17 00:00:00 2001
From: Kaa Maurice <kaalium@gmail.com>
Date: Thu, 23 Jun 2022 16:05:46 +0200
Subject: [PATCH 0808/1227] more exceptions for pre pisyde install

---
 openpype/hosts/blender/hooks/pre_pyside_install.py | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/blender/hooks/pre_pyside_install.py b/openpype/hosts/blender/hooks/pre_pyside_install.py
index d2c07e860d..9e1046453b 100644
--- a/openpype/hosts/blender/hooks/pre_pyside_install.py
+++ b/openpype/hosts/blender/hooks/pre_pyside_install.py
@@ -169,8 +169,7 @@ class InstallPySideToBlender(PreLaunchHook):
         except pywintypes.error:
             pass
 
-    @staticmethod
-    def install_pyside(python_executable):
+    def install_pyside(self, python_executable):
         """Install PySide2 python module to blender's python."""
         try:
             # Parameters
@@ -188,13 +187,16 @@ class InstallPySideToBlender(PreLaunchHook):
             process = subprocess.Popen(
                 args, stdout=subprocess.PIPE, universal_newlines=True
             )
-            stdout, _ = process.communicate()
+            process.communicate()
             return process.returncode == 0
+        except PermissionError:
+            self.log.warning("Permission denied with command: \"{}\".".format(" ".join(args)))
+        except OSError as error:
+            self.log.warning("OS error has occurred with command: \"{error}\".")
         except subprocess.SubprocessError:
             pass
 
-    @staticmethod
-    def is_pyside_installed(python_executable):
+    def is_pyside_installed(self, python_executable):
         """Check if PySide2 module is in blender's pip list.
 
         Check that PySide2 is installed directly in blender's site-packages.

From 262d179e15e1236f09fd86352a697eaff23a899d Mon Sep 17 00:00:00 2001
From: Kaa Maurice <kaalium@gmail.com>
Date: Thu, 23 Jun 2022 16:09:50 +0200
Subject: [PATCH 0809/1227] fix last commit draft code

---
 openpype/hosts/blender/hooks/pre_pyside_install.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/blender/hooks/pre_pyside_install.py b/openpype/hosts/blender/hooks/pre_pyside_install.py
index 9e1046453b..d0f2b3d417 100644
--- a/openpype/hosts/blender/hooks/pre_pyside_install.py
+++ b/openpype/hosts/blender/hooks/pre_pyside_install.py
@@ -190,9 +190,12 @@ class InstallPySideToBlender(PreLaunchHook):
             process.communicate()
             return process.returncode == 0
         except PermissionError:
-            self.log.warning("Permission denied with command: \"{}\".".format(" ".join(args)))
+            self.log.warning(
+                "Permission denied with command:"
+                "\"{}\".".format(" ".join(args))
+            )
         except OSError as error:
-            self.log.warning("OS error has occurred with command: \"{error}\".")
+            self.log.warning(f"OS error has occurred: \"{error}\".")
         except subprocess.SubprocessError:
             pass
 

From bf592641e870556c474da160b1e107a3377388a4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 23 Jun 2022 17:13:29 +0200
Subject: [PATCH 0810/1227] added new names of methods and old variants are
 marked as deprecated

---
 openpype/host/host.py               | 142 ++++++++++++++++++----------
 openpype/hosts/maya/api/pipeline.py |  12 +--
 2 files changed, 100 insertions(+), 54 deletions(-)

diff --git a/openpype/host/host.py b/openpype/host/host.py
index 676f0e6771..1755c19216 100644
--- a/openpype/host/host.py
+++ b/openpype/host/host.py
@@ -105,7 +105,7 @@ class HostBase(object):
     @abstractproperty
     def name(self):
         # type: () -> str
-        """Host implementation name."""
+        """Host name."""
 
         pass
 
@@ -201,19 +201,22 @@ class ILoadHost:
 
     @staticmethod
     def get_missing_load_methods(host):
-        # type: (HostBase) ->  List[str]
-        """Look for missing methods on host implementation.
+        # type: (Union[ModuleType, HostBase]) ->  List[str]
+        """Look for missing methods on "old type" host implementation.
 
         Method is used for validation of implemented functions related to
         loading. Checks only existence of methods.
 
         Args:
-            HostBase: Object of host where to look for required methods.
+            Union[ModuleType, HostBase]: Object of host where to look for required methods.
 
         Returns:
             list[str]: Missing method implementations for loading workflow.
         """
 
+        if isinstance(host, ILoadHost):
+            return []
+
         required = ["ls"]
         missing = []
         for name in required:
@@ -223,11 +226,11 @@ class ILoadHost:
 
     @staticmethod
     def validate_load_methods(host):
-        # type: (HostBase) ->  None
-        """Validate implemented methods of host for load workflow.
+        # type: (Union[ModuleType, HostBase]) ->  None
+        """Validate implemented methods of "old type" host for load workflow.
 
         Args:
-            HostBase: Object of host to validate.
+            Union[ModuleType, HostBase]: Object of host to validate.
 
         Raises:
             MissingMethodsError: If there are missing methods on host
@@ -238,8 +241,8 @@ class ILoadHost:
             raise MissingMethodsError(host, missing)
 
     @abstractmethod
-    def ls(self):
-        # type: (HostBase) ->  List[Mapping[str, Any]]
+    def get_referenced_containers(self):
+        # type: () ->  List[Mapping[str, Any]]
         """Retreive referenced containers from scene.
 
         This can be implemented in hosts where referencing can be used.
@@ -251,33 +254,42 @@ class ILoadHost:
         Returns:
             list[dict]: Information about loaded containers.
         """
-        return []
+
+        pass
+
+    # --- Deprecated method names ---
+    def ls(self):
+        """Deprecated variant of 'get_referenced_containers'.
+
+        Todo:
+            Remove when all usages are replaced.
+        """
+
+        return self.get_referenced_containers()
 
 
 @six.add_metaclass(ABCMeta)
 class IWorkfileHost:
-    """Implementation requirements to be able use workfile utils and tool.
-
-    This interface just provides what is needed to implement in host
-    implementation to support workfiles workflow, but does not have necessarily
-    to inherit from this interface.
-    """
+    """Implementation requirements to be able use workfile utils and tool."""
 
     @staticmethod
     def get_missing_workfile_methods(host):
-        # type: (HostBase) ->  List[str]
-        """Look for missing methods on host implementation.
+        # type: (Union[ModuleType, HostBase]) ->  List[str]
+        """Look for missing methods on "old type" host implementation.
 
         Method is used for validation of implemented functions related to
         workfiles. Checks only existence of methods.
 
         Args:
-            HostBase: Object of host where to look for required methods.
+            Union[ModuleType, HostBase]: Object of host where to look for required methods.
 
         Returns:
             list[str]: Missing method implementations for workfiles workflow.
         """
 
+        if isinstance(host, IWorkfileHost):
+            return []
+
         required = [
             "open_file",
             "save_file",
@@ -294,42 +306,37 @@ class IWorkfileHost:
 
     @staticmethod
     def validate_workfile_methods(host):
-        # type: (HostBase) ->  None
-        """Validate implemented methods of host for workfiles workflow.
+        # type: (Union[ModuleType, HostBase]) ->  None
+        """Validate methods of "old type" host for workfiles workflow.
 
         Args:
-            HostBase: Object of host to validate.
+            Union[ModuleType, HostBase]: Object of host to validate.
 
         Raises:
             MissingMethodsError: If there are missing methods on host
                 implementation.
         """
+
         missing = IWorkfileHost.get_missing_workfile_methods(host)
         if missing:
             raise MissingMethodsError(host, missing)
 
     @abstractmethod
-    def file_extensions(self):
+    def get_workfile_extensions(self):
         # type: () ->  List[str]
         """Extensions that can be used as save.
 
         Questions:
             This could potentially use 'HostDefinition'.
-
-        Todo:
-            Rename to 'get_workfile_extensions'.
         """
 
         return []
 
     @abstractmethod
-    def save_file(self, dst_path=None):
+    def save_current_workfile(self, dst_path=None):
         # type: (Optional[str]) ->  None
         """Save currently opened scene.
 
-        Todo:
-            Rename to 'save_current_workfile'.
-
         Args:
             dst_path (str): Where the current scene should be saved. Or use
                 current path if 'None' is passed.
@@ -338,13 +345,10 @@ class IWorkfileHost:
         pass
 
     @abstractmethod
-    def open_file(self, filepath):
+    def open_workfile(self, filepath):
         # type: (str) ->  None
         """Open passed filepath in the host.
 
-        Todo:
-            Rename to 'open_workfile'.
-
         Args:
             filepath (str): Path to workfile.
         """
@@ -352,13 +356,10 @@ class IWorkfileHost:
         pass
 
     @abstractmethod
-    def current_file(self):
+    def get_current_workfile(self):
         # type: () ->  Union[str, None]
         """Retreive path to current opened file.
 
-        Todo:
-            Rename to 'get_current_workfile'.
-
         Returns:
             str: Path to file which is currently opened.
             None: If nothing is opened.
@@ -366,7 +367,7 @@ class IWorkfileHost:
 
         return None
 
-    def has_unsaved_changes(self):
+    def workfile_has_unsaved_changes(self):
         # type: () ->  Union[bool, None]
         """Currently opened scene is saved.
 
@@ -404,6 +405,51 @@ class IWorkfileHost:
 
         return session["AVALON_WORKDIR"]
 
+    # --- Deprecated method names ---
+    def file_extensions(self):
+        """Deprecated variant of 'get_workfile_extensions'.
+
+        Todo:
+            Remove when all usages are replaced.
+        """
+        return self.get_workfile_extensions()
+
+    def save_file(self, dst_path=None):
+        """Deprecated variant of 'save_current_workfile'.
+
+        Todo:
+            Remove when all usages are replaced.
+        """
+
+        self.save_current_workfile()
+
+    def open_file(self, filepath):
+        """Deprecated variant of 'open_workfile'.
+
+        Todo:
+            Remove when all usages are replaced.
+        """
+
+        return self.open_workfile(filepath)
+
+    def current_file(self):
+        """Deprecated variant of 'get_current_workfile'.
+
+        Todo:
+            Remove when all usages are replaced.
+        """
+
+        return self.get_current_workfile()
+
+    def has_unsaved_changes(self):
+        """Deprecated variant of 'workfile_has_unsaved_changes'.
+
+        Todo:
+            Remove when all usages are replaced.
+        """
+
+        return self.workfile_has_unsaved_changes()
+
 
 class INewPublisher:
     """Functions related to new creation system in new publisher.
@@ -411,27 +457,27 @@ class INewPublisher:
     New publisher is not storing information only about each created instance
     but also some global data. At this moment are data related only to context
     publish plugins but that can extend in future.
-
-    HostBase does not have to inherit from this interface just have
-    to imlement mentioned all listed methods.
     """
 
     @staticmethod
     def get_missing_publish_methods(host):
-        # type: (HostBase) ->  List[str]
-        """Look for missing methods on host implementation.
+        # type: (Union[ModuleType, HostBase]) ->  List[str]
+        """Look for missing methods on "old type" host implementation.
 
         Method is used for validation of implemented functions related to
         new publish creation. Checks only existence of methods.
 
         Args:
-            HostBase: Object of host where to look for required methods.
+            Union[ModuleType, HostBase]: Host module where to look for required methods.
 
         Returns:
             list[str]: Missing method implementations for new publsher
                 workflow.
         """
 
+        if isinstance(host, INewPublisher):
+            return []
+
         required = [
             "get_context_data",
             "update_context_data",
@@ -444,11 +490,11 @@ class INewPublisher:
 
     @staticmethod
     def validate_publish_methods(host):
-        # type: (HostBase) ->  None
-        """Validate implemented methods of host for create-publish workflow.
+        # type: (Union[ModuleType, HostBase]) ->  None
+        """Validate implemented methods of "old type" host.
 
         Args:
-            HostBase: Object of host to validate.
+            Union[ModuleType, HostBase]: Host module to validate.
 
         Raises:
             MissingMethodsError: If there are missing methods on host
diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index bfb9b289e0..b8c6042e4f 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -97,25 +97,25 @@ class MayaHost(HostBase, IWorkfileHost, ILoadHost):
         register_event_callback("taskChanged", on_task_changed)
         register_event_callback("workfile.save.before", before_workfile_save)
 
-    def open_file(self, filepath):
+    def open_workfile(self, filepath):
         return open_file(filepath)
 
-    def save_file(self, filepath=None):
+    def save_current_workfile(self, filepath=None):
         return save_file(filepath)
 
     def work_root(self, session):
         return work_root(session)
 
-    def current_file(self):
+    def get_current_workfile(self):
         return current_file()
 
-    def has_unsaved_changes(self):
+    def workfile_has_unsaved_changes(self):
         return has_unsaved_changes()
 
-    def file_extensions(self):
+    def get_workfile_extensions(self):
         return file_extensions()
 
-    def ls(self):
+    def get_referenced_containers(self):
         return ls()
 
     @contextlib.contextmanager

From 779f4230bcaa6f499d1e293baf6cd6d964a15644 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 23 Jun 2022 17:16:55 +0200
Subject: [PATCH 0811/1227] use new method names based on inheritance in
 workfiles tool and sceneinventory

---
 openpype/tools/sceneinventory/model.py   |  6 +++-
 openpype/tools/workfiles/files_widget.py | 44 +++++++++++++++++++-----
 2 files changed, 40 insertions(+), 10 deletions(-)

diff --git a/openpype/tools/sceneinventory/model.py b/openpype/tools/sceneinventory/model.py
index 0bb9c4a658..2894932e96 100644
--- a/openpype/tools/sceneinventory/model.py
+++ b/openpype/tools/sceneinventory/model.py
@@ -6,6 +6,7 @@ from collections import defaultdict
 from Qt import QtCore, QtGui
 import qtawesome
 
+from openpype.host import ILoadHost
 from openpype.client import (
     get_asset_by_id,
     get_subset_by_id,
@@ -193,7 +194,10 @@ class InventoryModel(TreeModel):
 
         host = registered_host()
         if not items:  # for debugging or testing, injecting items from outside
-            items = host.ls()
+            if isinstance(host, ILoadHost):
+                items = host.get_referenced_containers()
+            else:
+                items = host.ls()
 
         self.clear()
 
diff --git a/openpype/tools/workfiles/files_widget.py b/openpype/tools/workfiles/files_widget.py
index a7e54471dc..8669a28f6c 100644
--- a/openpype/tools/workfiles/files_widget.py
+++ b/openpype/tools/workfiles/files_widget.py
@@ -6,6 +6,7 @@ import copy
 import Qt
 from Qt import QtWidgets, QtCore
 
+from openpype.host import IWorkfileHost
 from openpype.client import get_asset_by_id
 from openpype.tools.utils import PlaceholderLineEdit
 from openpype.tools.utils.delegates import PrettyTimeDelegate
@@ -125,7 +126,7 @@ class FilesWidget(QtWidgets.QWidget):
         filter_layout.addWidget(published_checkbox, 0)
 
         # Create the Files models
-        extensions = set(self.host.file_extensions())
+        extensions = set(self.self._get_host_extensions())
 
         views_widget = QtWidgets.QWidget(self)
         # --- Workarea view ---
@@ -452,7 +453,12 @@ class FilesWidget(QtWidgets.QWidget):
 
     def open_file(self, filepath):
         host = self.host
-        if host.has_unsaved_changes():
+        if isinstance(host, IWorkfileHost):
+            has_unsaved_changes = host.workfile_has_unsaved_changes()
+        else:
+            has_unsaved_changes = host.has_unsaved_changes()
+
+        if has_unsaved_changes:
             result = self.save_changes_prompt()
             if result is None:
                 # Cancel operation
@@ -460,7 +466,10 @@ class FilesWidget(QtWidgets.QWidget):
 
             # Save first if has changes
             if result:
-                current_file = host.current_file()
+                if isinstance(host, IWorkfileHost):
+                    current_file = host.get_current_workfile()
+                else:
+                    current_file = host.current_file()
                 if not current_file:
                     # If the user requested to save the current scene
                     # we can't actually automatically do so if the current
@@ -471,7 +480,10 @@ class FilesWidget(QtWidgets.QWidget):
                     return
 
                 # Save current scene, continue to open file
-                host.save_file(current_file)
+                if isinstance(host, IWorkfileHost):
+                    host.save_current_workfile(current_file)
+                else:
+                    host.save_file(current_file)
 
         event_data_before = self._get_event_context_data()
         event_data_before["filepath"] = filepath
@@ -482,7 +494,10 @@ class FilesWidget(QtWidgets.QWidget):
             source="workfiles.tool"
         )
         self._enter_session()
-        host.open_file(filepath)
+        if isinstance(host, IWorkfileHost):
+            host.open_workfile(filepath)
+        else:
+            host.open_file(filepath)
         emit_event(
             "workfile.open.after",
             event_data_after,
@@ -524,7 +539,7 @@ class FilesWidget(QtWidgets.QWidget):
             filepath = self._get_selected_filepath()
             extensions = [os.path.splitext(filepath)[1]]
         else:
-            extensions = self.host.file_extensions()
+            extensions = self._get_host_extensions()
 
         window = SaveAsDialog(
             parent=self,
@@ -572,9 +587,14 @@ class FilesWidget(QtWidgets.QWidget):
 
         self.open_file(path)
 
+    def _get_host_extensions(self):
+        if isinstance(self.host, IWorkfileHost):
+            return self.host.get_workfile_extensions()
+        return self.host.file_extensions()
+
     def on_browse_pressed(self):
         ext_filter = "Work File (*{0})".format(
-            " *".join(self.host.file_extensions())
+            " *".join(self._get_host_extensions())
         )
         kwargs = {
             "caption": "Work Files",
@@ -632,10 +652,16 @@ class FilesWidget(QtWidgets.QWidget):
         self._enter_session()
 
         if not self.published_enabled:
-            self.host.save_file(filepath)
+            if isinstance(self.host, IWorkfileHost):
+                self.host.save_current_workfile(filepath)
+            else:
+                self.host.save_file(filepath)
         else:
             shutil.copy(src_path, filepath)
-            self.host.open_file(filepath)
+            if isinstance(self.host, IWorkfileHost):
+                self.host.open_workfile(filepath)
+            else:
+                self.host.open_file(filepath)
 
         # Create extra folders
         create_workdir_extra_folders(

From 3ab8b75ada8c5bb56359903928b78ff281ba5fad Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 23 Jun 2022 17:18:25 +0200
Subject: [PATCH 0812/1227] fix double accessed self

---
 openpype/tools/workfiles/files_widget.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/tools/workfiles/files_widget.py b/openpype/tools/workfiles/files_widget.py
index 8669a28f6c..c019518d8e 100644
--- a/openpype/tools/workfiles/files_widget.py
+++ b/openpype/tools/workfiles/files_widget.py
@@ -126,7 +126,7 @@ class FilesWidget(QtWidgets.QWidget):
         filter_layout.addWidget(published_checkbox, 0)
 
         # Create the Files models
-        extensions = set(self.self._get_host_extensions())
+        extensions = set(self._get_host_extensions())
 
         views_widget = QtWidgets.QWidget(self)
         # --- Workarea view ---

From 18859001b137ec61c281a5b7750f456f19abb27f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Thu, 23 Jun 2022 17:23:34 +0200
Subject: [PATCH 0813/1227] :bug: keep baked camera out of hierarchy

---
 .../plugins/publish/extract_camera_alembic.py    | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py b/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
index a8e13e645f..054aadcbee 100644
--- a/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
+++ b/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
@@ -30,7 +30,7 @@ class ExtractCameraAlembic(openpype.api.Extractor):
 
         # get cameras
         members = instance.data['setMembers']
-        cameras = cmds.ls(members, leaf=True, shapes=True, long=True,
+        cameras = cmds.ls(members, leaf=True, long=True,
                           dag=True, type="camera")
 
         # validate required settings
@@ -62,7 +62,21 @@ class ExtractCameraAlembic(openpype.api.Extractor):
             if bake_to_worldspace:
                 job_str += ' -worldSpace'
 
+                # if baked, drop the camera hierarchy to maintain
+                # clean output and backwards compatibility
+                camera_root = cmds.listRelatives(
+                    camera, parent=True, fullPath=True)[0]
+                job_str += ' -root {0}'.format(camera_root)
+
                 for member in members:
+                    member_content = cmds.listRelatives(
+                        member, ad=True, fullPath=True) or []
+                    # skip hierarchy if it contains only camera
+                    # `member_content` will contain camera + its parents
+                    if camera in member_content \
+                            and len(member_content) == len(camera.split("|")) - 2:  # noqa
+                        continue
+
                     transform = cmds.listRelatives(
                         member, parent=True, fullPath=True)
                     transform = transform[0] if transform else member

From f2ef34c1a2b5dc531c476f5661a79bd8dfeb7d15 Mon Sep 17 00:00:00 2001
From: "Allan I. A" <76656700+Allan-I@users.noreply.github.com>
Date: Thu, 23 Jun 2022 19:18:28 +0300
Subject: [PATCH 0814/1227] Update openpype/hosts/maya/api/lib.py
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Simplify key test.

Co-authored-by: Ondřej Samohel <33513211+antirotor@users.noreply.github.com>
---
 openpype/hosts/maya/api/lib.py | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 4b76757e97..b9f23a2c0e 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2548,11 +2548,7 @@ def load_capture_preset(data=None):
             temp_options['headsUpDisplay'] = True
 
         if key == 'hwFogEnable':
-            if preset[id][key] is True:
-                temp_options2['hwFogEnable'] = True
-
-            else:
-                temp_options2['hwFogEnable'] = False
+            temp_options2['hwFogEnable'] = preset[id][key] or False
 
         if key == 'hwFogStart':
             temp_options2['hwFogStart'] = preset[id][key]

From 3af840f8881432634f776a904655be32536de000 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 04:00:33 +0300
Subject: [PATCH 0815/1227] Add Color Options

---
 openpype/hosts/maya/api/lib.py                | 14 ++++++++---
 .../defaults/project_settings/maya.json       |  9 +++----
 .../schemas/schema_maya_capture.json          | 25 ++++++++++++++++---
 3 files changed, 36 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 4b76757e97..c6585f5a8f 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2566,8 +2566,14 @@ def load_capture_preset(data=None):
         if key == 'hwFogFalloff':
             temp_options2['hwFogFalloff'] = int(preset[id][key])
 
-        if key == 'hwFogColor':
-            temp_options2['hwFogColor'] = preset[id][key]
+        if key == 'hwFogColorR':
+            temp_options2['hwFogColorR'] = preset[id][key]
+
+        if key == 'hwFogColorG':
+            temp_options2['hwFogColorG'] = preset[id][key]
+
+        if key == 'hwFogColorB':
+            temp_options2['hwFogColorB'] = preset[id][key]
 
         if key == 'motionBlurEnable':
             if preset[id][key] is True:
@@ -2605,7 +2611,9 @@ def load_capture_preset(data=None):
                 'hwFogEnd',
                 'hwFogAlpha',
                 'hwFogFalloff',
-                'hwFogColor',
+                'hwFogColorR',
+                'hwFogColorG',
+                'hwFogColorB',
                 'textureMaxResolution',
                 'motionBlurEnable',
                 'motionBlurSampleCount',
diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 874e23400e..7057160a40 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -511,12 +511,9 @@
                     "hwFogStart": 0,
                     "hwFogEnd": 0,
                     "hwFogAlpha": 0,
-                    "hwFogColor": [
-                        158,
-                        53,
-                        53,
-                        255
-                    ],
+                    "hwFogColorR": 0,
+                    "hwFogColorG": 0,
+                    "hwFogColorB": 0,
                     "motionBlurEnable": true,
                     "motionBlurSampleCount": 8,
                     "motionBlurShutterOpenFraction": 0.01,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index 08207824b1..42685623ce 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -303,9 +303,28 @@
                             "label": "Enable Fog Alpha"
                         },
                         {
-                            "type": "color",
-                            "key": "hwFogColor",
-                            "label": "Fog Color"
+                            "type": "number",
+                            "key": "hwFogColorR",
+                            "label": "Fog Color R",
+                            "decimal": 2,
+                            "minimum": 0,
+                            "maximum": 1
+                        },
+                        {
+                            "type": "number",
+                            "key": "hwFogColorG",
+                            "label": "Fog Color G",
+                            "decimal": 2,
+                            "minimum": 0,
+                            "maximum": 1
+                        },
+                        {
+                            "type": "number",
+                            "key": "hwFogColorB",
+                            "label": "Fog Color B",
+                            "decimal": 2,
+                            "minimum": 0,
+                            "maximum": 1
                         },
                         {
                             "type": "splitter"

From 0c1688eaa5d64de6935b8fbcbe43ea8074d5b443 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 11:06:57 +0300
Subject: [PATCH 0816/1227] Fix comparison statements.

---
 .../maya/plugins/publish/extract_playblast.py    | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 32cbeed81b..4ba8bd5976 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -56,23 +56,23 @@ class ExtractPlayblast(openpype.api.Extractor):
         width_preset = capture_presets["Resolution"]["width"]
         height_preset = capture_presets["Resolution"]["height"]
         # Set resolution variables from instance values
-        instance_width = instance.data.get("resolutionWidth")
-        instance_height = instance.data.get("resolutionHeight")
+        instance_width = instance.context.data.get("resolutionWidth")
+        instance_height = instance.context.data.get("resolutionHeight")
         preset['camera'] = camera
 
         # Tests if instance resolution width is set,
         # if it is a value other than zero, that value is
         # used, if not then the project settings resolution is
         # used
-        if instance_width != 0:
-            preset['width'] = instance.data.get("resolutionWidth")
-        else:
+        if width_preset != 0:
             preset["width"] = width_preset
-
-        if instance_height != 0:
-            preset['height'] = instance.data.get("resolutionHeight")
         else:
+            preset['width'] = instance_width
+
+        if height_preset != 0:
             preset['height'] = height_preset
+        else:
+            preset['height'] = instance_height
 
         preset['start_frame'] = start
         preset['end_frame'] = end

From c6d473f6b0354ebc7beffd0641eef3d8ea6a79b1 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 11:08:11 +0300
Subject: [PATCH 0817/1227] Fix comments.

---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 4ba8bd5976..8378b5c22a 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -55,14 +55,14 @@ class ExtractPlayblast(openpype.api.Extractor):
         # Set resolution variables from capture presets
         width_preset = capture_presets["Resolution"]["width"]
         height_preset = capture_presets["Resolution"]["height"]
-        # Set resolution variables from instance values
+        # Set resolution variables from asset values
         instance_width = instance.context.data.get("resolutionWidth")
         instance_height = instance.context.data.get("resolutionHeight")
         preset['camera'] = camera
 
-        # Tests if instance resolution width is set,
+        # Tests if project resolution is set,
         # if it is a value other than zero, that value is
-        # used, if not then the project settings resolution is
+        # used, if not then the asset resolution is
         # used
         if width_preset != 0:
             preset["width"] = width_preset

From d0f1f897fcfb67623d21dd87a25e969ab03180a7 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 11:18:20 +0300
Subject: [PATCH 0818/1227] Append SSAO Radius minimum.

---
 .../schemas/projects_schema/schemas/schema_maya_capture.json | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index 42685623ce..d9d565943f 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -259,7 +259,10 @@
                         {
                             "type": "number",
                             "key": "ssaoFilterRadius",
-                            "label": "SSAO Filter Radius"
+                            "label": "SSAO Filter Radius",
+                            "decimal": 0,
+                            "minimum": 1,
+                            "maximum": 32
                         },
                         {
                             "type": "number",

From 54b8056238250d8699b2c59bfafd13947a88ff4d Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 11:19:25 +0300
Subject: [PATCH 0819/1227] Adjust defaults.

---
 openpype/settings/defaults/project_settings/maya.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 7057160a40..293648385b 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -504,7 +504,7 @@
                     "ssaoEnable": true,
                     "ssaoAmount": 0,
                     "ssaoRadius": 0,
-                    "ssaoFilterRadius": 0,
+                    "ssaoFilterRadius": 1,
                     "ssaoSamples": 8,
                     "hwFogEnable": true,
                     "hwFogFalloff": "0",

From 59fee838079b1cbc887d36b1021360235cb09f72 Mon Sep 17 00:00:00 2001
From: Petr Dvorak <dvorak.peta@gmail.com>
Date: Fri, 24 Jun 2022 11:35:39 +0200
Subject: [PATCH 0820/1227] Changes in schema settings for AE and Harmony

---
 .../system_settings/applications.json         | 18 ++-------
 .../host_settings/schema_aftereffects.json    | 38 +++++++------------
 .../host_settings/schema_harmony.json         | 38 +++++++------------
 3 files changed, 31 insertions(+), 63 deletions(-)

diff --git a/openpype/settings/defaults/system_settings/applications.json b/openpype/settings/defaults/system_settings/applications.json
index 6c90a99661..b70b59b95b 100644
--- a/openpype/settings/defaults/system_settings/applications.json
+++ b/openpype/settings/defaults/system_settings/applications.json
@@ -986,8 +986,6 @@
         },
         "variants": {
             "21": {
-                "enabled": true,
-                "variant_label": "21",
                 "executables": {
                     "windows": [
                         "c:\\Program Files (x86)\\Toon Boom Animation\\Toon Boom Harmony 21 Premium\\win64\\bin\\HarmonyPremium.exe"
@@ -1005,8 +1003,6 @@
                 "environment": {}
             },
             "20": {
-                "enabled": true,
-                "variant_label": "20",
                 "executables": {
                     "windows": [
                         "c:\\Program Files (x86)\\Toon Boom Animation\\Toon Boom Harmony 20 Premium\\win64\\bin\\HarmonyPremium.exe"
@@ -1024,8 +1020,6 @@
                 "environment": {}
             },
             "17": {
-                "enabled": true,
-                "variant_label": "17",
                 "executables": {
                     "windows": [
                         "c:\\Program Files (x86)\\Toon Boom Animation\\Toon Boom Harmony 17 Premium\\win64\\bin\\HarmonyPremium.exe"
@@ -1155,11 +1149,9 @@
         },
         "variants": {
             "2020": {
-                "enabled": true,
-                "variant_label": "2020",
                 "executables": {
                     "windows": [
-                        ""
+                        "C:\\Program Files\\Adobe\\Adobe After Effects 2020\\Support Files\\Photoshop.exe"
                     ],
                     "darwin": [],
                     "linux": []
@@ -1172,11 +1164,9 @@
                 "environment": {}
             },
             "2021": {
-                "enabled": true,
-                "variant_label": "2021",
                 "executables": {
                     "windows": [
-                        "C:\\Program Files\\Adobe\\Adobe After Effects 2021\\Support Files\\AfterFX.exe"
+                        "C:\\Program Files\\Adobe\\Adobe After Effects 2021\\Support Files\\Photoshop.exe"
                     ],
                     "darwin": [],
                     "linux": []
@@ -1189,11 +1179,9 @@
                 "environment": {}
             },
             "2022": {
-                "enabled": true,
-                "variant_label": "2022",
                 "executables": {
                     "windows": [
-                        "C:\\Program Files\\Adobe\\Adobe After Effects 2022\\Support Files\\AfterFX.exe"
+                        "C:\\Program Files\\Adobe\\Adobe After Effects 2022\\Support Files\\Photoshop.exe"
                     ],
                     "darwin": [],
                     "linux": []
diff --git a/openpype/settings/entities/schemas/system_schema/host_settings/schema_aftereffects.json b/openpype/settings/entities/schemas/system_schema/host_settings/schema_aftereffects.json
index 334c9aa235..b92a2edf85 100644
--- a/openpype/settings/entities/schemas/system_schema/host_settings/schema_aftereffects.json
+++ b/openpype/settings/entities/schemas/system_schema/host_settings/schema_aftereffects.json
@@ -20,31 +20,21 @@
             "type": "raw-json"
         },
         {
-            "type": "dict",
+            "type": "dict-modifiable",
             "key": "variants",
-            "children": [
-                {
-                    "type": "schema_template",
-                    "name": "template_host_variant",
-                    "template_data": [
-                        {
-                            "app_variant_label": "2020",
-                            "app_variant": "2020",
-                            "variant_skip_paths": ["use_python_2"]
-                        },
-                        {
-                            "app_variant_label": "2021",
-                            "app_variant": "2021",
-                            "variant_skip_paths": ["use_python_2"]
-                        },
-                        {
-                            "app_variant_label": "2022",
-                            "app_variant": "2022",
-                            "variant_skip_paths": ["use_python_2"]
-                        }
-                    ]
-                }
-            ]
+            "collapsible_key": true,
+            "use_label_wrap": false,
+            "object_type": {
+                "type": "dict",
+                "collapsible": true,
+                "children": [
+                    {
+                        "type": "schema_template",
+                        "name": "template_host_variant_items",
+                        "skip_paths": ["use_python_2"]
+                    }
+                ]
+            }
         }
     ]
 }
diff --git a/openpype/settings/entities/schemas/system_schema/host_settings/schema_harmony.json b/openpype/settings/entities/schemas/system_schema/host_settings/schema_harmony.json
index 69ce7735e8..d5d041d0c2 100644
--- a/openpype/settings/entities/schemas/system_schema/host_settings/schema_harmony.json
+++ b/openpype/settings/entities/schemas/system_schema/host_settings/schema_harmony.json
@@ -20,31 +20,21 @@
             "type": "raw-json"
         },
         {
-            "type": "dict",
+            "type": "dict-modifiable",
             "key": "variants",
-            "children": [
-                {
-                    "type": "schema_template",
-                    "name": "template_host_variant",
-                    "template_data": [
-                        {
-                            "app_variant_label": "21",
-                            "app_variant": "21",
-                            "variant_skip_paths": ["use_python_2"]
-                        },
-                        {
-                            "app_variant_label": "20",
-                            "app_variant": "20",
-                            "variant_skip_paths": ["use_python_2"]
-                        },
-                        {
-                            "app_variant_label": "17",
-                            "app_variant": "17",
-                            "variant_skip_paths": ["use_python_2"]
-                        }
-                    ]
-                }
-            ]
+            "collapsible_key": true,
+            "use_label_wrap": false,
+            "object_type": {
+                "type": "dict",
+                "collapsible": true,
+                "children": [
+                    {
+                        "type": "schema_template",
+                        "name": "template_host_variant_items",
+                        "skip_paths": ["use_python_2"]
+                    }
+                ]
+            }
         }
     ]
 }

From 96fefa32c039fee52bc2120ab3c8c23bb63d8de6 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 12:50:20 +0300
Subject: [PATCH 0821/1227] Add Fog Density

---
 .../projects_schema/schemas/schema_maya_capture.json       | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index d9d565943f..6e5eb43dd0 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -290,6 +290,11 @@
                                 { "2": "Exponential Squared"}
                             ]
                         },
+                        {
+                            "type": "number",
+                            "key": "hwFogDensity",
+                            "label": "Fog Density"
+                        },
                         {
                             "type": "number",
                             "key": "hwFogStart",
@@ -303,7 +308,7 @@
                         {
                             "type": "number",
                             "key": "hwFogAlpha",
-                            "label": "Enable Fog Alpha"
+                            "label": "Fog Alpha"
                         },
                         {
                             "type": "number",

From 66cce36da5646553e6ffde4ec278433c47aea202 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 12:50:30 +0300
Subject: [PATCH 0822/1227] Adjust defaults to Maya Values

---
 .../defaults/project_settings/maya.json        | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 293648385b..bd8d1fecf5 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -502,21 +502,21 @@
                     "twoSidedLighting": true,
                     "lineAAEnable": true,
                     "ssaoEnable": true,
-                    "ssaoAmount": 0,
-                    "ssaoRadius": 0,
-                    "ssaoFilterRadius": 1,
-                    "ssaoSamples": 8,
+                    "ssaoAmount": 1,
+                    "ssaoRadius": 16,
+                    "ssaoFilterRadius": 16,
+                    "ssaoSamples": 16,
                     "hwFogEnable": true,
                     "hwFogFalloff": "0",
                     "hwFogStart": 0,
-                    "hwFogEnd": 0,
+                    "hwFogEnd": 100,
                     "hwFogAlpha": 0,
-                    "hwFogColorR": 0,
-                    "hwFogColorG": 0,
-                    "hwFogColorB": 0,
+                    "hwFogColorR": 1.0,
+                    "hwFogColorG": 1.0,
+                    "hwFogColorB": 1.0,
                     "motionBlurEnable": true,
                     "motionBlurSampleCount": 8,
-                    "motionBlurShutterOpenFraction": 0.01,
+                    "motionBlurShutterOpenFraction": 0.2,
                     "cameras": false,
                     "clipGhosts": false,
                     "controlVertices": false,

From 5b9168b421ed91870beb11bccc2dc9bf71136370 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 12:51:54 +0300
Subject: [PATCH 0823/1227] Append density default

---
 openpype/settings/defaults/project_settings/maya.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index bd8d1fecf5..bf6c18bb95 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -508,6 +508,7 @@
                     "ssaoSamples": 16,
                     "hwFogEnable": true,
                     "hwFogFalloff": "0",
+                    "hwFogDensity": 0,
                     "hwFogStart": 0,
                     "hwFogEnd": 100,
                     "hwFogAlpha": 0,

From 76cf10a61186d38a4dd1f4c3bc33edce7d605e06 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 13:08:47 +0300
Subject: [PATCH 0824/1227] Add missing hwFogDensity key.

---
 openpype/hosts/maya/api/lib.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 166f348319..924dc03729 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2537,6 +2537,9 @@ def load_capture_preset(data=None):
         if key == 'ssaoRadius':
             temp_options2['ssaoRadius'] = preset[id][key]
 
+        if key == 'hwFogDensity':
+            temp_options2['hwFogDensity'] = preset[id][key]
+
         if key == 'ssaoFilterRadius':
             temp_options2['ssaoFilterRadius'] = preset[id][key]
 
@@ -2610,6 +2613,7 @@ def load_capture_preset(data=None):
                 'hwFogColorR',
                 'hwFogColorG',
                 'hwFogColorB',
+                'hwFogDensity',
                 'textureMaxResolution',
                 'motionBlurEnable',
                 'motionBlurSampleCount',

From 3968e1607e4c08e31c16d731c8e3d7fdafcd01d6 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 14:10:29 +0300
Subject: [PATCH 0825/1227] Change logic into correct setting.

---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 8378b5c22a..ff15546033 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -65,14 +65,14 @@ class ExtractPlayblast(openpype.api.Extractor):
         # used, if not then the asset resolution is
         # used
         if width_preset != 0:
-            preset["width"] = width_preset
+            preset["width"] = instance_width
         else:
-            preset['width'] = instance_width
+            preset['width'] = width_preset
 
         if height_preset != 0:
-            preset['height'] = height_preset
-        else:
             preset['height'] = instance_height
+        else:
+            preset['height'] = height_preset
 
         preset['start_frame'] = start
         preset['end_frame'] = end

From 0486b99a3438f8b70635e06087a0bbc9f9676b1d Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 14:14:41 +0300
Subject: [PATCH 0826/1227] Change hwFogDensity into float key.

---
 .../schemas/projects_schema/schemas/schema_maya_capture.json | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index 6e5eb43dd0..a87918878d 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -293,7 +293,10 @@
                         {
                             "type": "number",
                             "key": "hwFogDensity",
-                            "label": "Fog Density"
+                            "label": "Fog Density",
+                            "decimal": 2,
+                            "minimum": 0,
+                            "maximum": 1
                         },
                         {
                             "type": "number",

From 07b708bcdd3baa9004f6566d15ce8a378b47a528 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 24 Jun 2022 13:26:24 +0200
Subject: [PATCH 0827/1227] added plate to supported families

---
 openpype/hosts/fusion/plugins/load/load_sequence.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/fusion/plugins/load/load_sequence.py b/openpype/hosts/fusion/plugins/load/load_sequence.py
index b860abd88b..3e28f3e411 100644
--- a/openpype/hosts/fusion/plugins/load/load_sequence.py
+++ b/openpype/hosts/fusion/plugins/load/load_sequence.py
@@ -123,7 +123,7 @@ def loader_shift(loader, frame, relative=True):
 class FusionLoadSequence(load.LoaderPlugin):
     """Load image sequence into Fusion"""
 
-    families = ["imagesequence", "review", "render"]
+    families = ["imagesequence", "review", "render", "plate"]
     representations = ["*"]
 
     label = "Load sequence"

From 9778d2747b8a09754778d50cf1d1af6af643dd14 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 24 Jun 2022 14:30:32 +0300
Subject: [PATCH 0828/1227] Revert "Change logic into correct setting."

This reverts commit 3968e1607e4c08e31c16d731c8e3d7fdafcd01d6.
---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index ff15546033..8378b5c22a 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -65,14 +65,14 @@ class ExtractPlayblast(openpype.api.Extractor):
         # used, if not then the asset resolution is
         # used
         if width_preset != 0:
-            preset["width"] = instance_width
+            preset["width"] = width_preset
         else:
-            preset['width'] = width_preset
+            preset['width'] = instance_width
 
         if height_preset != 0:
-            preset['height'] = instance_height
-        else:
             preset['height'] = height_preset
+        else:
+            preset['height'] = instance_height
 
         preset['start_frame'] = start
         preset['end_frame'] = end

From a50f73ab7f495d901fdecfa5b4ca1b3f6589160d Mon Sep 17 00:00:00 2001
From: 64qam <dvorak.peta@gmail.com>
Date: Fri, 24 Jun 2022 13:43:08 +0200
Subject: [PATCH 0829/1227] Apply suggestions from code review

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../settings/defaults/system_settings/applications.json     | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/settings/defaults/system_settings/applications.json b/openpype/settings/defaults/system_settings/applications.json
index b70b59b95b..30b0a5cbe3 100644
--- a/openpype/settings/defaults/system_settings/applications.json
+++ b/openpype/settings/defaults/system_settings/applications.json
@@ -1151,7 +1151,7 @@
             "2020": {
                 "executables": {
                     "windows": [
-                        "C:\\Program Files\\Adobe\\Adobe After Effects 2020\\Support Files\\Photoshop.exe"
+                        "C:\\Program Files\\Adobe\\Adobe After Effects 2020\\Support Files\\AfterFX.exe"
                     ],
                     "darwin": [],
                     "linux": []
@@ -1166,7 +1166,7 @@
             "2021": {
                 "executables": {
                     "windows": [
-                        "C:\\Program Files\\Adobe\\Adobe After Effects 2021\\Support Files\\Photoshop.exe"
+                        "C:\\Program Files\\Adobe\\Adobe After Effects 2021\\Support Files\\AfterFX.exe"
                     ],
                     "darwin": [],
                     "linux": []
@@ -1181,7 +1181,7 @@
             "2022": {
                 "executables": {
                     "windows": [
-                        "C:\\Program Files\\Adobe\\Adobe After Effects 2022\\Support Files\\Photoshop.exe"
+                        "C:\\Program Files\\Adobe\\Adobe After Effects 2022\\Support Files\\AfterFX.exe"
                     ],
                     "darwin": [],
                     "linux": []

From 87a71842cacc409007e789fcb4dbf889869ed83d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 24 Jun 2022 14:50:29 +0200
Subject: [PATCH 0830/1227] use nuke api to get expected output files instead
 of guessing based on files in output directory

---
 .../plugins/publish/extract_render_local.py   | 27 ++++++++++++-------
 .../nuke/plugins/publish/precollect_writes.py | 25 +++++++++++++----
 2 files changed, 38 insertions(+), 14 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_render_local.py b/openpype/hosts/nuke/plugins/publish/extract_render_local.py
index 057bca11ac..1595fe03fb 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_render_local.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_render_local.py
@@ -42,12 +42,22 @@ class NukeRenderLocal(openpype.api.Extractor):
         self.log.info("Start frame: {}".format(first_frame))
         self.log.info("End frame: {}".format(last_frame))
 
-        # write node url might contain nuke's ctl expressin
-        # as [python ...]/path...
-        path = node["file"].evaluate()
+        node_file = node["file"]
+        # Collecte expected filepaths for each frame
+        # - for cases that output is still image is first created set of
+        #   paths which is then sorted and converted to list
+        expected_paths = list(sorted({
+            node_file.evaluate(frame)
+            for frame in range(first_frame, last_frame + 1)
+        }))
+        # Extract only filenames for representation
+        filenames = [
+            os.path.basename(filepath)
+            for filepath in expected_paths
+        ]
 
         # Ensure output directory exists.
-        out_dir = os.path.dirname(path)
+        out_dir = os.path.dirname(expected_paths[0])
         if not os.path.exists(out_dir):
             os.makedirs(out_dir)
 
@@ -67,12 +77,11 @@ class NukeRenderLocal(openpype.api.Extractor):
         if "representations" not in instance.data:
             instance.data["representations"] = []
 
-        collected_frames = os.listdir(out_dir)
-        if len(collected_frames) == 1:
+        if len(filenames) == 1:
             repre = {
                 'name': ext,
                 'ext': ext,
-                'files': collected_frames.pop(),
+                'files': filenames[0],
                 "stagingDir": out_dir
             }
         else:
@@ -81,7 +90,7 @@ class NukeRenderLocal(openpype.api.Extractor):
                 'ext': ext,
                 'frameStart': "%0{}d".format(
                     len(str(last_frame))) % first_frame,
-                'files': collected_frames,
+                'files': filenames,
                 "stagingDir": out_dir
             }
         instance.data["representations"].append(repre)
@@ -105,7 +114,7 @@ class NukeRenderLocal(openpype.api.Extractor):
             families.remove('still.local')
         instance.data["families"] = families
 
-        collections, remainder = clique.assemble(collected_frames)
+        collections, remainder = clique.assemble(filenames)
         self.log.info('collections: {}'.format(str(collections)))
 
         if collections:
diff --git a/openpype/hosts/nuke/plugins/publish/precollect_writes.py b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
index a7c07975e2..a267652f11 100644
--- a/openpype/hosts/nuke/plugins/publish/precollect_writes.py
+++ b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
@@ -56,9 +56,21 @@ class CollectNukeWrites(pyblish.api.InstancePlugin):
             first_frame = int(node["first"].getValue())
             last_frame = int(node["last"].getValue())
 
-        # get path
-        path = nuke.filename(node)
-        output_dir = os.path.dirname(path)
+        # Prepare expected output paths by evaluating each frame of write node
+        #   - paths are first collected to set to avoid duplicated paths, then
+        #       sorted and converted to list
+        node_file = node["file"]
+        expected_paths = list(sorted({
+            node_file.evaluate(frame)
+            for frame in range(first_frame, last_frame + 1)
+        }))
+        expected_filenames = [
+            os.path.basename(filepath)
+            for filepath in expected_paths
+        ]
+
+        output_dir = os.path.dirname(expected_paths[0])
+
         self.log.debug('output dir: {}'.format(output_dir))
 
         # create label
@@ -83,8 +95,11 @@ class CollectNukeWrites(pyblish.api.InstancePlugin):
             }
 
             try:
-                collected_frames = [f for f in os.listdir(output_dir)
-                                    if ext in f]
+                collected_frames = [
+                    filename
+                    for filename in os.listdir(output_dir)
+                    if filename in expected_filenames
+                ]
                 if collected_frames:
                     collected_frames_len = len(collected_frames)
                     frame_start_str = "%0{}d".format(

From 4c6677e3ce80ef55e08a13099f3918314f891abe Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 24 Jun 2022 15:01:16 +0200
Subject: [PATCH 0831/1227] fix missing path variable

---
 openpype/hosts/nuke/plugins/publish/precollect_writes.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/precollect_writes.py b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
index a267652f11..049958bd07 100644
--- a/openpype/hosts/nuke/plugins/publish/precollect_writes.py
+++ b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
@@ -68,8 +68,8 @@ class CollectNukeWrites(pyblish.api.InstancePlugin):
             os.path.basename(filepath)
             for filepath in expected_paths
         ]
-
-        output_dir = os.path.dirname(expected_paths[0])
+        path = nuke.filename(node)
+        output_dir = os.path.dirname(path)
 
         self.log.debug('output dir: {}'.format(output_dir))
 

From ca38d5d484f217ecaaf71888bf67c44707850d4c Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Fri, 24 Jun 2022 15:19:03 +0200
Subject: [PATCH 0832/1227] fix typo

---
 openpype/hosts/houdini/plugins/create/create_hda.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_hda.py b/openpype/hosts/houdini/plugins/create/create_hda.py
index d15d5bcd29..b98da8b8bb 100644
--- a/openpype/hosts/houdini/plugins/create/create_hda.py
+++ b/openpype/hosts/houdini/plugins/create/create_hda.py
@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 import hou
 
-from openpye.client import (
+from openpype.client import (
     get_asset_by_name,
     get_subsets,
 )

From ae0427bbad4db877472799b207cf1db206eadd76 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Fri, 24 Jun 2022 16:49:37 +0200
Subject: [PATCH 0833/1227] :bug: fix loading and updating vbd/bgeo sequences

---
 .../hosts/houdini/plugins/load/load_bgeo.py   |  6 ++---
 .../hosts/houdini/plugins/load/load_vdb.py    | 27 +++++++------------
 2 files changed, 12 insertions(+), 21 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/load/load_bgeo.py b/openpype/hosts/houdini/plugins/load/load_bgeo.py
index a463d51383..1c0cb81bee 100644
--- a/openpype/hosts/houdini/plugins/load/load_bgeo.py
+++ b/openpype/hosts/houdini/plugins/load/load_bgeo.py
@@ -70,7 +70,6 @@ class BgeoLoader(load.LoaderPlugin):
         # The path is either a single file or sequence in a folder.
         if not is_sequence:
             filename = path
-            print("single")
         else:
             filename = re.sub(r"(.*)\.(\d+)\.(bgeo.*)", "\\1.$F4.\\3", path)
 
@@ -94,9 +93,10 @@ class BgeoLoader(load.LoaderPlugin):
 
         # Update the file path
         file_path = get_representation_path(representation)
-        file_path = self.format_path(file_path)
+        is_sequence = bool(representation["context"].get("frame"))
+        file_path = self.format_path(file_path, is_sequence)
 
-        file_node.setParms({"fileName": file_path})
+        file_node.setParms({"file": file_path})
 
         # Update attribute
         node.setParms({"representation": str(representation["_id"])})
diff --git a/openpype/hosts/houdini/plugins/load/load_vdb.py b/openpype/hosts/houdini/plugins/load/load_vdb.py
index 9455b76b89..efbac334ab 100644
--- a/openpype/hosts/houdini/plugins/load/load_vdb.py
+++ b/openpype/hosts/houdini/plugins/load/load_vdb.py
@@ -31,6 +31,7 @@ class VdbLoader(load.LoaderPlugin):
 
         # Create a new geo node
         container = obj.createNode("geo", node_name=node_name)
+        is_sequence = bool(context["representation"]["context"].get("frame"))
 
         # Remove the file node, it only loads static meshes
         # Houdini 17 has removed the file node from the geo node
@@ -40,7 +41,7 @@ class VdbLoader(load.LoaderPlugin):
 
         # Explicitly create a file node
         file_node = container.createNode("file", node_name=node_name)
-        file_node.setParms({"file": self.format_path(self.fname)})
+        file_node.setParms({"file": self.format_path(self.fname, is_sequence)})
 
         # Set display on last node
         file_node.setDisplayFlag(True)
@@ -57,30 +58,19 @@ class VdbLoader(load.LoaderPlugin):
             suffix="",
         )
 
-    def format_path(self, path):
+    @staticmethod
+    def format_path(path, is_sequence):
         """Format file path correctly for single vdb or vdb sequence."""
         if not os.path.exists(path):
             raise RuntimeError("Path does not exist: %s" % path)
 
         # The path is either a single file or sequence in a folder.
-        is_single_file = os.path.isfile(path)
-        if is_single_file:
+        if not is_sequence:
             filename = path
         else:
-            # The path points to the publish .vdb sequence folder so we
-            # find the first file in there that ends with .vdb
-            files = sorted(os.listdir(path))
-            first = next((x for x in files if x.endswith(".vdb")), None)
-            if first is None:
-                raise RuntimeError(
-                    "Couldn't find first .vdb file of "
-                    "sequence in: %s" % path
-                )
+            filename = re.sub(r"(.*)\.(\d+)\.vdb$", "\\1.$F4.vdb", path)
 
-            # Set <frame>.vdb to $F.vdb
-            first = re.sub(r"\.(\d+)\.vdb$", ".$F.vdb", first)
-
-            filename = os.path.join(path, first)
+            filename = os.path.join(path, filename)
 
         filename = os.path.normpath(filename)
         filename = filename.replace("\\", "/")
@@ -100,7 +90,8 @@ class VdbLoader(load.LoaderPlugin):
 
         # Update the file path
         file_path = get_representation_path(representation)
-        file_path = self.format_path(file_path)
+        is_sequence = bool(representation["context"].get("frame"))
+        file_path = self.format_path(file_path, is_sequence)
 
         file_node.setParms({"file": file_path})
 

From a080eb00ece263ddb645f7f562934fd8f5364073 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Fri, 24 Jun 2022 17:05:45 +0200
Subject: [PATCH 0834/1227] Convert basic families from old standalone publiser
 to the new one

---
 .../project_settings/traypublisher.json       | 184 +++++++++++++++++-
 1 file changed, 182 insertions(+), 2 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/traypublisher.json b/openpype/settings/defaults/project_settings/traypublisher.json
index 0b54cfd39e..da5fb2e8b5 100644
--- a/openpype/settings/defaults/project_settings/traypublisher.json
+++ b/openpype/settings/defaults/project_settings/traypublisher.json
@@ -8,8 +8,8 @@
             "default_variants": [
                 "Main"
             ],
-            "description": "Publish workfile backup",
-            "detailed_description": "",
+            "description": "Backup of a working scene",
+            "detailed_description": "Workfiles are full scenes from any application that are directly edited by artists. They represent a state of work on a task at a given point and are usually not directly referenced into other scenes.",
             "allow_sequences": true,
             "extensions": [
                 ".ma",
@@ -30,6 +30,186 @@
                 ".psb",
                 ".aep"
             ]
+        },
+        {
+            "family": "model",
+            "identifier": "",
+            "label": "Model",
+            "icon": "fa.cubes",
+            "default_variants": [
+                "Main",
+                "Proxy",
+                "Sculpt"
+            ],
+            "description": "Clean models",
+            "detailed_description": "Models should only contain geometry data, without any extras like cameras, locators or bones. It should be ready to be loaded into other scenes as is.\n",
+            "allow_sequences": false,
+            "extensions": [
+                ".ma",
+                ".mb",
+                ".obj",
+                ".abc",
+                ".fbx",
+                ".bgeo",
+                ".bgeogz",
+                ".bgeosc",
+                ".usd",
+                ".blend"
+            ]
+        },
+        {
+            "family": "pointcache",
+            "identifier": "",
+            "label": "Pointcache",
+            "icon": "fa.gears",
+            "default_variants": [
+                "Main"
+            ],
+            "description": "Geometry Caches",
+            "detailed_description": "Alembic or bgeo cache of animated data",
+            "allow_sequences": true,
+            "extensions": [
+                ".abc",
+                ".bgeo",
+                ".bgeogz",
+                ".bgeosc"
+            ]
+        },
+        {
+            "family": "plate",
+            "identifier": "",
+            "label": "Plate",
+            "icon": "mdi.camera-image",
+            "default_variants": [
+                "Main",
+                "BG",
+                "Animatic",
+                "Reference",
+                "Offline"
+            ],
+            "description": "Footage Plates",
+            "detailed_description": "Any type of image seqeuence coming from outside of the studio. Usually camera footage, but could also be animatics used for reference.",
+            "allow_sequences": true,
+            "extensions": [
+                ".exr",
+                ".png",
+                ".dpx",
+                ".jpg",
+                ".tiff",
+                ".tif",
+                ".mov",
+                ".mp4",
+                ".avi"
+            ]
+        },
+        {
+            "family": "render",
+            "identifier": "",
+            "label": "Render",
+            "icon": "mdi.folder-multiple-image",
+            "default_variants": [],
+            "description": "Rendered images or video",
+            "detailed_description": "Sequence or single file renders",
+            "allow_sequences": true,
+            "extensions": [
+                ".exr",
+                ".png",
+                ".dpx",
+                ".jpg",
+                ".tiff",
+                ".tif",
+                ".mov",
+                ".mp4",
+                ".avi"
+            ]
+        },
+        {
+            "family": "camera",
+            "identifier": "",
+            "label": "Camera",
+            "icon": "fa.video-camera",
+            "default_variants": [],
+            "description": "3d Camera",
+            "detailed_description": "Ideally this should be only camera itself with baked animation, however, it can technically also include helper geometry.",
+            "allow_sequences": false,
+            "extensions": [
+                ".abc",
+                ".ma",
+                ".hip",
+                ".blend",
+                ".fbx",
+                ".usd"
+            ]
+        },
+        {
+            "family": "image",
+            "identifier": "",
+            "label": "Image",
+            "icon": "fa.image",
+            "default_variants": [
+                "Reference",
+                "Texture",
+                "Concept",
+                "Background"
+            ],
+            "description": "Single image",
+            "detailed_description": "Any image data can be published as image family. References, textures, concept art, matte paints. This is a fallback 2d family for everything that doesn't fit more specific family.",
+            "allow_sequences": false,
+            "extensions": [
+                ".exr",
+                ".jpg",
+                ".dpx",
+                ".bmp",
+                ".tif",
+                ".tiff",
+                ".png",
+                ".psb",
+                ".psd"
+            ]
+        },
+        {
+            "family": "vdb",
+            "identifier": "",
+            "label": "VDB Volumes",
+            "icon": "fa.cloud",
+            "default_variants": [],
+            "description": "Sparse volumetric data",
+            "detailed_description": "Hierarchical data structure for the efficient storage and manipulation of sparse volumetric data discretized on three-dimensional grids",
+            "allow_sequences": true,
+            "extensions": [
+                ".vdb"
+            ]
+        },
+        {
+            "family": "matchmove",
+            "identifier": "",
+            "label": "Matchmove",
+            "icon": "fa.empire",
+            "default_variants": [
+                "Camera",
+                "Object",
+                "Mocap"
+            ],
+            "description": "Matchmoving script",
+            "detailed_description": "Script exported from matchmoving application to be later processed into a tracked camera with additional data",
+            "allow_sequences": false,
+            "extensions": []
+        },
+        {
+            "family": "rig",
+            "identifier": "",
+            "label": "Rig",
+            "icon": "fa.wheelchair",
+            "default_variants": [],
+            "description": "CG rig file",
+            "detailed_description": "CG rigged character or prop. Rig should be clean of any extra data and directly loadable into it's respective application\t",
+            "allow_sequences": false,
+            "extensions": [
+                ".ma",
+                ".blend",
+                ".hip",
+                ".hda"
+            ]
         }
     ]
 }
\ No newline at end of file

From 0b07036fa832adb4e408b3797060bd9d7026ede3 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Fri, 24 Jun 2022 17:34:14 +0200
Subject: [PATCH 0835/1227] :recycle: use sets for member comparsion

---
 .../plugins/publish/extract_camera_alembic.py | 21 ++++++++++++-------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py b/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
index 054aadcbee..b744bfd0fe 100644
--- a/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
+++ b/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
@@ -69,14 +69,19 @@ class ExtractCameraAlembic(openpype.api.Extractor):
                 job_str += ' -root {0}'.format(camera_root)
 
                 for member in members:
-                    member_content = cmds.listRelatives(
-                        member, ad=True, fullPath=True) or []
-                    # skip hierarchy if it contains only camera
-                    # `member_content` will contain camera + its parents
-                    if camera in member_content \
-                            and len(member_content) == len(camera.split("|")) - 2:  # noqa
-                        continue
-
+                    descendants = cmds.listRelatives(member,
+                                                     allDescendents=True,
+                                                     fullPath=True) or []
+                    shapes = cmds.ls(descendants, shapes=True,
+                                     noIntermediate=True, long=True)
+                    cameras = cmds.ls(shapes, type="camera", long=True)
+                    if cameras:
+                        if not set(shapes) - set(cameras):
+                            continue
+                        self.log.warning((
+                            "Camera hierarchy contains additional geometry. "
+                            "Extraction will fail.")
+                        )
                     transform = cmds.listRelatives(
                         member, parent=True, fullPath=True)
                     transform = transform[0] if transform else member

From 8412fca0b1d7786417623770f3bb866a732154be Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Fri, 24 Jun 2022 17:41:44 +0200
Subject: [PATCH 0836/1227] :recycle: refactor format function

---
 openpype/hosts/houdini/plugins/load/load_bgeo.py |  9 +++++----
 openpype/hosts/houdini/plugins/load/load_vdb.py  | 10 +++++-----
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/load/load_bgeo.py b/openpype/hosts/houdini/plugins/load/load_bgeo.py
index 1c0cb81bee..b298d423bc 100644
--- a/openpype/hosts/houdini/plugins/load/load_bgeo.py
+++ b/openpype/hosts/houdini/plugins/load/load_bgeo.py
@@ -44,7 +44,8 @@ class BgeoLoader(load.LoaderPlugin):
 
         # Explicitly create a file node
         file_node = container.createNode("file", node_name=node_name)
-        file_node.setParms({"file": self.format_path(self.fname, is_sequence)})
+        file_node.setParms(
+            {"file": self.format_path(self.fname, context["representation"])})
 
         # Set display on last node
         file_node.setDisplayFlag(True)
@@ -62,11 +63,12 @@ class BgeoLoader(load.LoaderPlugin):
         )
 
     @staticmethod
-    def format_path(path, is_sequence):
+    def format_path(path, representation):
         """Format file path correctly for single bgeo or bgeo sequence."""
         if not os.path.exists(path):
             raise RuntimeError("Path does not exist: %s" % path)
 
+        is_sequence = bool(representation["context"].get("frame"))
         # The path is either a single file or sequence in a folder.
         if not is_sequence:
             filename = path
@@ -93,8 +95,7 @@ class BgeoLoader(load.LoaderPlugin):
 
         # Update the file path
         file_path = get_representation_path(representation)
-        is_sequence = bool(representation["context"].get("frame"))
-        file_path = self.format_path(file_path, is_sequence)
+        file_path = self.format_path(file_path, representation)
 
         file_node.setParms({"file": file_path})
 
diff --git a/openpype/hosts/houdini/plugins/load/load_vdb.py b/openpype/hosts/houdini/plugins/load/load_vdb.py
index efbac334ab..c558a7a0e7 100644
--- a/openpype/hosts/houdini/plugins/load/load_vdb.py
+++ b/openpype/hosts/houdini/plugins/load/load_vdb.py
@@ -31,7 +31,6 @@ class VdbLoader(load.LoaderPlugin):
 
         # Create a new geo node
         container = obj.createNode("geo", node_name=node_name)
-        is_sequence = bool(context["representation"]["context"].get("frame"))
 
         # Remove the file node, it only loads static meshes
         # Houdini 17 has removed the file node from the geo node
@@ -41,7 +40,8 @@ class VdbLoader(load.LoaderPlugin):
 
         # Explicitly create a file node
         file_node = container.createNode("file", node_name=node_name)
-        file_node.setParms({"file": self.format_path(self.fname, is_sequence)})
+        file_node.setParms(
+            {"file": self.format_path(self.fname, context["representation"])})
 
         # Set display on last node
         file_node.setDisplayFlag(True)
@@ -59,11 +59,12 @@ class VdbLoader(load.LoaderPlugin):
         )
 
     @staticmethod
-    def format_path(path, is_sequence):
+    def format_path(path, representation):
         """Format file path correctly for single vdb or vdb sequence."""
         if not os.path.exists(path):
             raise RuntimeError("Path does not exist: %s" % path)
 
+        is_sequence = bool(representation["context"].get("frame"))
         # The path is either a single file or sequence in a folder.
         if not is_sequence:
             filename = path
@@ -90,8 +91,7 @@ class VdbLoader(load.LoaderPlugin):
 
         # Update the file path
         file_path = get_representation_path(representation)
-        is_sequence = bool(representation["context"].get("frame"))
-        file_path = self.format_path(file_path, is_sequence)
+        file_path = self.format_path(file_path, representation)
 
         file_node.setParms({"file": file_path})
 

From 5ec1f8c1ccf094bf11d7f9e9bd722d4606e0d127 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Fri, 24 Jun 2022 17:47:28 +0200
Subject: [PATCH 0837/1227] add unreal texture and tweak model help

---
 .../defaults/project_settings/traypublisher.json  | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/traypublisher.json b/openpype/settings/defaults/project_settings/traypublisher.json
index da5fb2e8b5..5afaaee78c 100644
--- a/openpype/settings/defaults/project_settings/traypublisher.json
+++ b/openpype/settings/defaults/project_settings/traypublisher.json
@@ -42,7 +42,7 @@
                 "Sculpt"
             ],
             "description": "Clean models",
-            "detailed_description": "Models should only contain geometry data, without any extras like cameras, locators or bones. It should be ready to be loaded into other scenes as is.\n",
+            "detailed_description": "Models should only contain geometry data, without any extras like cameras, locators or bones.\n\nKeep in mind that models published from tray publisher are not validated for correctness. ",
             "allow_sequences": false,
             "extensions": [
                 ".ma",
@@ -210,6 +210,19 @@
                 ".hip",
                 ".hda"
             ]
+        },
+        {
+            "family": "simpleUnrealTexture",
+            "identifier": "",
+            "label": "Simple UE texture",
+            "icon": "fa.image",
+            "default_variants": [
+                ""
+            ],
+            "description": "Simple Unreal Engine texture",
+            "detailed_description": "Texture files with Unreal Engine naming conventions",
+            "allow_sequences": false,
+            "extensions": []
         }
     ]
 }
\ No newline at end of file

From fcefcc74348f7f7be89c3d34caa4ca88819dbd1e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 24 Jun 2022 17:52:29 +0200
Subject: [PATCH 0838/1227] removed type hints

---
 openpype/host/host.py | 30 ++++++------------------------
 1 file changed, 6 insertions(+), 24 deletions(-)

diff --git a/openpype/host/host.py b/openpype/host/host.py
index 1755c19216..94eeeb986f 100644
--- a/openpype/host/host.py
+++ b/openpype/host/host.py
@@ -80,7 +80,6 @@ class HostBase(object):
     _log = None
 
     def __init__(self):
-        # type: () -> None
         """Initialization of host.
 
         Register DCC callbacks, host specific plugin paths, targets etc.
@@ -97,20 +96,17 @@ class HostBase(object):
 
     @property
     def log(self):
-        # type: () -> logging.Logger
         if self._log is None:
             self._log = logging.getLogger(self.__class__.__name__)
         return self._log
 
     @abstractproperty
     def name(self):
-        # type: () -> str
         """Host name."""
 
         pass
 
     def get_current_context(self):
-        # type: () -> Mapping[str, Union[str, None]]
         """Get current context information.
 
         This method should be used to get current context of host. Usage of
@@ -137,7 +133,6 @@ class HostBase(object):
         }
 
     def get_context_title(self):
-        # type: () -> Union[str, None]
         """Context title shown for UI purposes.
 
         Should return current context title if possible.
@@ -170,7 +165,6 @@ class HostBase(object):
 
     @contextlib.contextmanager
     def maintained_selection(self):
-        # type: () ->  None
         """Some functionlity will happen but selection should stay same.
 
         This is DCC specific. Some may not allow to implement this ability
@@ -201,14 +195,14 @@ class ILoadHost:
 
     @staticmethod
     def get_missing_load_methods(host):
-        # type: (Union[ModuleType, HostBase]) ->  List[str]
         """Look for missing methods on "old type" host implementation.
 
         Method is used for validation of implemented functions related to
         loading. Checks only existence of methods.
 
         Args:
-            Union[ModuleType, HostBase]: Object of host where to look for required methods.
+            Union[ModuleType, HostBase]: Object of host where to look for
+                required methods.
 
         Returns:
             list[str]: Missing method implementations for loading workflow.
@@ -226,7 +220,6 @@ class ILoadHost:
 
     @staticmethod
     def validate_load_methods(host):
-        # type: (Union[ModuleType, HostBase]) ->  None
         """Validate implemented methods of "old type" host for load workflow.
 
         Args:
@@ -242,7 +235,6 @@ class ILoadHost:
 
     @abstractmethod
     def get_referenced_containers(self):
-        # type: () ->  List[Mapping[str, Any]]
         """Retreive referenced containers from scene.
 
         This can be implemented in hosts where referencing can be used.
@@ -274,14 +266,14 @@ class IWorkfileHost:
 
     @staticmethod
     def get_missing_workfile_methods(host):
-        # type: (Union[ModuleType, HostBase]) ->  List[str]
         """Look for missing methods on "old type" host implementation.
 
         Method is used for validation of implemented functions related to
         workfiles. Checks only existence of methods.
 
         Args:
-            Union[ModuleType, HostBase]: Object of host where to look for required methods.
+            Union[ModuleType, HostBase]: Object of host where to look for
+                required methods.
 
         Returns:
             list[str]: Missing method implementations for workfiles workflow.
@@ -306,7 +298,6 @@ class IWorkfileHost:
 
     @staticmethod
     def validate_workfile_methods(host):
-        # type: (Union[ModuleType, HostBase]) ->  None
         """Validate methods of "old type" host for workfiles workflow.
 
         Args:
@@ -323,7 +314,6 @@ class IWorkfileHost:
 
     @abstractmethod
     def get_workfile_extensions(self):
-        # type: () ->  List[str]
         """Extensions that can be used as save.
 
         Questions:
@@ -334,7 +324,6 @@ class IWorkfileHost:
 
     @abstractmethod
     def save_current_workfile(self, dst_path=None):
-        # type: (Optional[str]) ->  None
         """Save currently opened scene.
 
         Args:
@@ -346,7 +335,6 @@ class IWorkfileHost:
 
     @abstractmethod
     def open_workfile(self, filepath):
-        # type: (str) ->  None
         """Open passed filepath in the host.
 
         Args:
@@ -357,7 +345,6 @@ class IWorkfileHost:
 
     @abstractmethod
     def get_current_workfile(self):
-        # type: () ->  Union[str, None]
         """Retreive path to current opened file.
 
         Returns:
@@ -368,7 +355,6 @@ class IWorkfileHost:
         return None
 
     def workfile_has_unsaved_changes(self):
-        # type: () ->  Union[bool, None]
         """Currently opened scene is saved.
 
         Not all hosts can know if current scene is saved because the API of
@@ -383,7 +369,6 @@ class IWorkfileHost:
         return None
 
     def work_root(self, session):
-        # type: (Mapping[str, str]) ->  str
         """Modify workdir per host.
 
         Default implementation keeps workdir untouched.
@@ -461,14 +446,14 @@ class INewPublisher:
 
     @staticmethod
     def get_missing_publish_methods(host):
-        # type: (Union[ModuleType, HostBase]) ->  List[str]
         """Look for missing methods on "old type" host implementation.
 
         Method is used for validation of implemented functions related to
         new publish creation. Checks only existence of methods.
 
         Args:
-            Union[ModuleType, HostBase]: Host module where to look for required methods.
+            Union[ModuleType, HostBase]: Host module where to look for
+                required methods.
 
         Returns:
             list[str]: Missing method implementations for new publsher
@@ -490,7 +475,6 @@ class INewPublisher:
 
     @staticmethod
     def validate_publish_methods(host):
-        # type: (Union[ModuleType, HostBase]) ->  None
         """Validate implemented methods of "old type" host.
 
         Args:
@@ -506,7 +490,6 @@ class INewPublisher:
 
     @abstractmethod
     def get_context_data(self):
-        # type: () ->  Mapping[str, Any]
         """Get global data related to creation-publishing from workfile.
 
         These data are not related to any created instance but to whole
@@ -524,7 +507,6 @@ class INewPublisher:
 
     @abstractmethod
     def update_context_data(self, data, changes):
-        # type: (Mapping[str, Any], Mapping[str, Any]) ->  None
         """Store global context data to workfile.
 
         Called when some values in context data has changed.

From b4d141f1a5e7ebc04e055b0d376f4433699112cf Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 24 Jun 2022 17:53:19 +0200
Subject: [PATCH 0839/1227] initial commit of docstrings

---
 website/docs/dev_host_implementation.md | 74 +++++++++++++++++++++++++
 website/sidebars.js                     |  1 +
 2 files changed, 75 insertions(+)
 create mode 100644 website/docs/dev_host_implementation.md

diff --git a/website/docs/dev_host_implementation.md b/website/docs/dev_host_implementation.md
new file mode 100644
index 0000000000..e3a2fff5e2
--- /dev/null
+++ b/website/docs/dev_host_implementation.md
@@ -0,0 +1,74 @@
+---
+id: dev_host_implementation
+title: Host implementation
+sidebar_label: Host implementation
+toc_max_heading_level: 4
+---
+
+Host is an integration of DCC but in most of cases have logic that need to be handled before DCC is launched. Then based on abilities (or purpose) of DCC the integration can support different pipeline workflows.
+
+## Pipeline workflows
+Workflows available in OpenPype are Workfiles, Load and Create-Publish. Each of them may require some functionality available in integration (e.g. call host API to achieve certain functionality). We'll go through them later.
+
+## How to implement and manage host
+At this moment there is not fully unified way how host should be implemented but we're working on it. Host should have a "public face" code that can be used outside of DCC and in-DCC integration code. The main reason is that in-DCC code can have specific dependencies for python modules not available out of it's process. Hosts are located in `openpype/hosts/{host name}` folder. Current code (at many places) expect that the host name has equivalent folder there. So each subfolder should be named with the name of host it represents.
+
+### Recommended folder structure
+```
+openpype/hosts/{host name}
+│
+│  # Content of DCC integration - with in-DCC imports
+├─ api
+│   ├─ __init__.py
+│   └─ [DCC integration files]
+│
+│  # Plugins related to host - dynamically imported (can contain in-DCC imports)
+├─ plugins
+│   ├─ create
+│   │   └─ [create plugin files]
+│   ├─ load
+│   │   └─ [load plugin files]
+│   └─ publish
+│       └─ [publish plugin files]
+│
+│  # Launch hooks - used to modify how application is launched
+├─ hooks
+│   └─ [some pre/post launch hooks]
+|
+│  # Code initializing host integration in-DCC (DCC specific - example from Maya)
+├─ startup
+│   └─ userSetup.py
+│
+│  # Public interface
+├─ __init__.py
+└─ [other public code]
+```
+
+### Launch Hooks
+Launch hooks are not directly connected to host implementation, but they can be used to modify launch of process which may be crutial for the implementation. Launch hook are plugins called when DCC is launched. They are processed in sequence before and after launch. Pre launch hooks can change how process of DCC is launched, e.g. change subprocess flags, modify environments or modify launch arguments. If prelaunch hook crashes the application is not launched at all. Postlaunch hooks are triggered after launch of subprocess. They can be used to change statuses in your project tracker, start timer, etc. Crashed postlaunch hooks have no effect on rest of postlaunch hooks or launched process. They can be filtered by platform, host and application and order is defined by integer value. Hooks inside host are automatically loaded (one reason why folder name should match host name) or can be defined from modules. Hooks execution share same launch context where can be stored data used across multiple hooks (please be very specific in stored keys e.g. 'project' vs. 'project_name'). For more detailed information look into `openpype/lib/applications.py`.
+
+### Public interface
+Public face is at this moment related to launching of the DCC. At this moment there there is only option to modify environment variables before launch by implementing function `add_implementation_envs` (must be available in `openpype/hosts/{host name}/__init__.py`). The function is called after pre launch hooks, as last step before subprocess launch, to be able set environment variables crutial for proper integration. It is also good place for functions that are used in prelaunch hooks and in-DCC integration. Future plans are to be able get workfiles extensions from here. Right now workfiles extensions are hardcoded in `openpype/pipeline/constants.py` under `HOST_WORKFILE_EXTENSIONS`, we would like to handle hosts as addons similar to OpenPype modules, and more improvements which are now hardcoded.
+
+### Integration
+We've prepared base class `HostBase` in `openpype/host/host.py` to define minimum requirements and provide some default implementations. The minimum requirement for a host is `name` attribute, this host would not be able to do much but is valid. To extend functionality we've prepared interfaces that helps to identify what is host capable of and if is possible to use certain tools with it. For those cases we defined interfaces for each workflow. `IWorkfileHost` interface add requirement to implement workfiles related methods which makes host usable in combination with Workfiles tool. `ILoadHost` interface add requirements to be able load, update, switch or remove referenced representations which should add support to use Loader and Scene Inventory tools. `INewPublisher` interface is required to be able use host with new OpenPype publish workflow. This is what must or can be implemented to allow certain functionality. `HostBase` will have more responsibility which will be taken from global variables, this process won't happen at once but will be slow to keep backwards compatibility for some time.
+
+#### Example
+```python
+from openpype.host import HostBase, IWorkfileHost, ILoadHost
+
+
+class MayaHost(HostBase, IWorkfileHost, ILoadHost):
+    def open_workfile(self, filepath):
+        ...
+
+    def save_current_workfile(self, filepath=None):
+        ...
+
+    def get_current_workfile(self):
+        ...
+    ...
+```
+
+### Install integration
+We have host class, now where and how to initialize it.
diff --git a/website/sidebars.js b/website/sidebars.js
index d4fec9fba2..0e578bd085 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -155,6 +155,7 @@ module.exports = {
             type: "category",
             label: "Hosts integrations",
             items: [
+                "dev_host_implementation",
                 "dev_publishing"
             ]
         }

From b4817f70a6b2058aff705ebc5dcae67ff2965c15 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 24 Jun 2022 19:11:21 +0200
Subject: [PATCH 0840/1227] show what is allowed to drop in the files widget

---
 openpype/style/style.css                      |   3 +
 .../widgets/attribute_defs/files_widget.py    | 125 ++++++++++++++++--
 2 files changed, 117 insertions(+), 11 deletions(-)

diff --git a/openpype/style/style.css b/openpype/style/style.css
index d76d833be1..72d12a9230 100644
--- a/openpype/style/style.css
+++ b/openpype/style/style.css
@@ -1418,3 +1418,6 @@ InViewButton, InViewButton:disabled {
 InViewButton:hover {
     background: rgba(255, 255, 255, 37);
 }
+SupportLabel {
+    color: {color:font-disabled};
+}
diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index 23cf8342b1..24e3f4bb25 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -26,26 +26,122 @@ IS_SEQUENCE_ROLE = QtCore.Qt.UserRole + 7
 EXT_ROLE = QtCore.Qt.UserRole + 8
 
 
+class SupportLabel(QtWidgets.QLabel):
+    pass
+
+
 class DropEmpty(QtWidgets.QWidget):
-    _drop_enabled_text = "Drag & Drop\n(drop files here)"
+    _empty_extensions = "Any file"
 
-    def __init__(self, parent):
+    def __init__(self, single_item, allow_sequences, parent):
         super(DropEmpty, self).__init__(parent)
-        label_widget = QtWidgets.QLabel(self._drop_enabled_text, self)
-        label_widget.setAlignment(QtCore.Qt.AlignCenter)
 
-        label_widget.setAttribute(QtCore.Qt.WA_TranslucentBackground)
+        drop_label_widget = QtWidgets.QLabel("Drag & Drop files here", self)
 
-        layout = QtWidgets.QHBoxLayout(self)
+        detail_widget = QtWidgets.QWidget(self)
+        items_label_widget = SupportLabel(detail_widget)
+        extensions_label_widget = SupportLabel(detail_widget)
+        extensions_label_widget.setWordWrap(True)
+
+        detail_layout = QtWidgets.QVBoxLayout(detail_widget)
+        detail_layout.setContentsMargins(0, 0, 0, 0)
+        detail_layout.addStretch(1)
+        detail_layout.addWidget(
+            items_label_widget, 0, alignment=QtCore.Qt.AlignCenter
+        )
+        detail_layout.addWidget(
+            extensions_label_widget, 0, alignment=QtCore.Qt.AlignCenter
+        )
+
+        layout = QtWidgets.QVBoxLayout(self)
         layout.setContentsMargins(0, 0, 0, 0)
         layout.addSpacing(10)
         layout.addWidget(
-            label_widget,
-            alignment=QtCore.Qt.AlignCenter
+            drop_label_widget, 0, alignment=QtCore.Qt.AlignCenter
         )
+        layout.addWidget(detail_widget, 1)
         layout.addSpacing(10)
 
-        self._label_widget = label_widget
+        for widget in (
+            detail_widget,
+            drop_label_widget,
+            items_label_widget,
+            extensions_label_widget,
+        ):
+            if isinstance(widget, QtWidgets.QLabel):
+                widget.setAlignment(QtCore.Qt.AlignCenter)
+            widget.setAttribute(QtCore.Qt.WA_TranslucentBackground)
+
+        self._single_item = single_item
+        self._allow_sequences = allow_sequences
+        self._allowed_extensions = set()
+        self._allow_folders = None
+
+        self._drop_label_widget = drop_label_widget
+        self._items_label_widget = items_label_widget
+        self._extensions_label_widget = extensions_label_widget
+
+        self.set_allow_folders(False)
+
+    def set_extensions(self, extensions):
+        if extensions:
+            extensions = {
+                ext.replace(".", "")
+                for ext in extensions
+            }
+        if extensions == self._allowed_extensions:
+            return
+        self._allowed_extensions = extensions
+
+        self._update_items_label()
+
+    def set_allow_folders(self, allowed):
+        if self._allow_folders == allowed:
+            return
+
+        self._allow_folders = allowed
+        self._update_items_label()
+
+    def _update_items_label(self):
+        extensions_label = ""
+        if self._allowed_extensions:
+            extensions_label = ", ".join(sorted(self._allowed_extensions))
+
+        allowed_items = []
+        if self._allow_folders:
+            allowed_items.append("folder")
+
+        if extensions_label:
+            allowed_items.append("file")
+            if self._allow_sequences:
+                allowed_items.append("sequence")
+
+        num_label = "Single"
+        if not self._single_item:
+            num_label = "Multiple"
+            allowed_items = [item + "s" for item in allowed_items]
+
+        if not allowed_items:
+            allowed_items_label = ""
+        elif len(allowed_items) == 1:
+            allowed_items_label = allowed_items[0]
+        elif len(allowed_items) == 2:
+            allowed_items_label = " or ".join(allowed_items)
+        else:
+            last_item = allowed_items.pop(-1)
+            new_last_item = " or ".join(last_item, allowed_items.pop(-1))
+            allowed_items.append(new_last_item)
+            allowed_items_label = ", ".join(allowed_items)
+
+        if allowed_items_label:
+            items_label = "{} {}".format(num_label, allowed_items_label)
+            if extensions_label:
+                items_label += " of"
+        else:
+            items_label = "It is not allowed to add anything here!"
+
+        self._items_label_widget.setText(items_label)
+        self._extensions_label_widget.setText(extensions_label)
 
     def paintEvent(self, event):
         super(DropEmpty, self).paintEvent(event)
@@ -188,7 +284,12 @@ class FilesProxyModel(QtCore.QSortFilterProxyModel):
 
     def set_allowed_extensions(self, extensions=None):
         if extensions is not None:
-            extensions = set(extensions)
+            _extensions = set()
+            for ext in set(extensions):
+                if not ext.startswith("."):
+                    ext = ".{}".format(ext)
+                _extensions.add(ext.lower())
+            extensions = _extensions
 
         if self._allowed_extensions != extensions:
             self._allowed_extensions = extensions
@@ -444,7 +545,7 @@ class FilesWidget(QtWidgets.QFrame):
         super(FilesWidget, self).__init__(parent)
         self.setAcceptDrops(True)
 
-        empty_widget = DropEmpty(self)
+        empty_widget = DropEmpty(single_item, allow_sequences, self)
 
         files_model = FilesModel(single_item, allow_sequences)
         files_proxy_model = FilesProxyModel()
@@ -519,6 +620,8 @@ class FilesWidget(QtWidgets.QFrame):
     def set_filters(self, folders_allowed, exts_filter):
         self._files_proxy_model.set_allow_folders(folders_allowed)
         self._files_proxy_model.set_allowed_extensions(exts_filter)
+        self._empty_widget.set_extensions(exts_filter)
+        self._empty_widget.set_allow_folders(folders_allowed)
 
     def _on_rows_inserted(self, parent_index, start_row, end_row):
         for row in range(start_row, end_row + 1):

From 462807c2726b0cff2e351db8edc759114fb52cc3 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 24 Jun 2022 19:19:25 +0200
Subject: [PATCH 0841/1227] removed unnecessary widgets

---
 .../widgets/attribute_defs/files_widget.py    | 59 ++++++++-----------
 1 file changed, 23 insertions(+), 36 deletions(-)

diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index 24e3f4bb25..af5a1d130b 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -38,20 +38,8 @@ class DropEmpty(QtWidgets.QWidget):
 
         drop_label_widget = QtWidgets.QLabel("Drag & Drop files here", self)
 
-        detail_widget = QtWidgets.QWidget(self)
-        items_label_widget = SupportLabel(detail_widget)
-        extensions_label_widget = SupportLabel(detail_widget)
-        extensions_label_widget.setWordWrap(True)
-
-        detail_layout = QtWidgets.QVBoxLayout(detail_widget)
-        detail_layout.setContentsMargins(0, 0, 0, 0)
-        detail_layout.addStretch(1)
-        detail_layout.addWidget(
-            items_label_widget, 0, alignment=QtCore.Qt.AlignCenter
-        )
-        detail_layout.addWidget(
-            extensions_label_widget, 0, alignment=QtCore.Qt.AlignCenter
-        )
+        items_label_widget = SupportLabel(self)
+        items_label_widget.setWordWrap(True)
 
         layout = QtWidgets.QVBoxLayout(self)
         layout.setContentsMargins(0, 0, 0, 0)
@@ -59,17 +47,17 @@ class DropEmpty(QtWidgets.QWidget):
         layout.addWidget(
             drop_label_widget, 0, alignment=QtCore.Qt.AlignCenter
         )
-        layout.addWidget(detail_widget, 1)
+        layout.addStretch(1)
+        layout.addWidget(
+            items_label_widget, 0, alignment=QtCore.Qt.AlignCenter
+        )
         layout.addSpacing(10)
 
         for widget in (
-            detail_widget,
             drop_label_widget,
             items_label_widget,
-            extensions_label_widget,
         ):
-            if isinstance(widget, QtWidgets.QLabel):
-                widget.setAlignment(QtCore.Qt.AlignCenter)
+            widget.setAlignment(QtCore.Qt.AlignCenter)
             widget.setAttribute(QtCore.Qt.WA_TranslucentBackground)
 
         self._single_item = single_item
@@ -79,7 +67,6 @@ class DropEmpty(QtWidgets.QWidget):
 
         self._drop_label_widget = drop_label_widget
         self._items_label_widget = items_label_widget
-        self._extensions_label_widget = extensions_label_widget
 
         self.set_allow_folders(False)
 
@@ -103,27 +90,29 @@ class DropEmpty(QtWidgets.QWidget):
         self._update_items_label()
 
     def _update_items_label(self):
-        extensions_label = ""
-        if self._allowed_extensions:
-            extensions_label = ", ".join(sorted(self._allowed_extensions))
-
         allowed_items = []
         if self._allow_folders:
             allowed_items.append("folder")
 
-        if extensions_label:
+        if self._allowed_extensions:
             allowed_items.append("file")
             if self._allow_sequences:
                 allowed_items.append("sequence")
 
-        num_label = "Single"
         if not self._single_item:
-            num_label = "Multiple"
             allowed_items = [item + "s" for item in allowed_items]
 
         if not allowed_items:
-            allowed_items_label = ""
-        elif len(allowed_items) == 1:
+            self._items_label_widget.setText(
+                "It is not allowed to add anything here!"
+            )
+            return
+
+        items_label = "Multiple "
+        if self._single_item:
+            items_label = "Single "
+
+        if len(allowed_items) == 1:
             allowed_items_label = allowed_items[0]
         elif len(allowed_items) == 2:
             allowed_items_label = " or ".join(allowed_items)
@@ -133,15 +122,13 @@ class DropEmpty(QtWidgets.QWidget):
             allowed_items.append(new_last_item)
             allowed_items_label = ", ".join(allowed_items)
 
-        if allowed_items_label:
-            items_label = "{} {}".format(num_label, allowed_items_label)
-            if extensions_label:
-                items_label += " of"
-        else:
-            items_label = "It is not allowed to add anything here!"
+        items_label += allowed_items_label
+        if self._allowed_extensions:
+            items_label += " of\n{}".format(
+                ", ".join(sorted(self._allowed_extensions))
+            )
 
         self._items_label_widget.setText(items_label)
-        self._extensions_label_widget.setText(extensions_label)
 
     def paintEvent(self, event):
         super(DropEmpty, self).paintEvent(event)

From 3e6856b9ba01856309088df81c7dd14e1e72bf98 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Sat, 25 Jun 2022 03:51:29 +0000
Subject: [PATCH 0842/1227] [Automated] Bump version

---
 CHANGELOG.md        | 38 ++++++++++++++------------------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 16 insertions(+), 26 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f0a9a9651d..aa720137a3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,29 +1,39 @@
 # Changelog
 
-## [3.11.2-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.0-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.11.1...HEAD)
 
 ### 📖 Documentation
 
+- Linux: update OIIO package [\#3401](https://github.com/pypeclub/OpenPype/pull/3401)
 - General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
 - Feature/multiverse [\#3350](https://github.com/pypeclub/OpenPype/pull/3350)
 
 **🚀 Enhancements**
 
 - Hosts: More options for in-host callbacks [\#3357](https://github.com/pypeclub/OpenPype/pull/3357)
-- TVPaint: Extractor use mark in/out range to render [\#3308](https://github.com/pypeclub/OpenPype/pull/3308)
 - Maya: Allow more data to be published along camera 🎥  [\#3304](https://github.com/pypeclub/OpenPype/pull/3304)
 
 **🐛 Bug fixes**
 
+- Nuke: Collect representation files based on Write [\#3407](https://github.com/pypeclub/OpenPype/pull/3407)
+- General: Filter representations before integration start [\#3398](https://github.com/pypeclub/OpenPype/pull/3398)
+- Maya: look collector typo [\#3392](https://github.com/pypeclub/OpenPype/pull/3392)
 - TVPaint: Make sure exit code is set to not None [\#3382](https://github.com/pypeclub/OpenPype/pull/3382)
 - Maya: vray device aspect ratio fix [\#3381](https://github.com/pypeclub/OpenPype/pull/3381)
 - Harmony: added unc path to zifile command in Harmony [\#3372](https://github.com/pypeclub/OpenPype/pull/3372)
+- Standalone: settings improvements [\#3355](https://github.com/pypeclub/OpenPype/pull/3355)
+- Nuke: Load full model hierarchy by default [\#3328](https://github.com/pypeclub/OpenPype/pull/3328)
 
 **🔀 Refactored code**
 
+- Kitsu: renaming to plural func sync\_all\_projects [\#3397](https://github.com/pypeclub/OpenPype/pull/3397)
+- Hiero: Use client query functions [\#3393](https://github.com/pypeclub/OpenPype/pull/3393)
+- Nuke: Use client query functions [\#3391](https://github.com/pypeclub/OpenPype/pull/3391)
+- Maya: Use client query functions [\#3385](https://github.com/pypeclub/OpenPype/pull/3385)
 - Harmony: Use client query functions [\#3378](https://github.com/pypeclub/OpenPype/pull/3378)
+- Celaction: Use client query functions [\#3376](https://github.com/pypeclub/OpenPype/pull/3376)
 - Photoshop: Use client query functions [\#3375](https://github.com/pypeclub/OpenPype/pull/3375)
 - AfterEffects: Use client query functions [\#3374](https://github.com/pypeclub/OpenPype/pull/3374)
 - TVPaint: Use client query functions [\#3340](https://github.com/pypeclub/OpenPype/pull/3340)
@@ -49,7 +59,6 @@
 - Ftrack: Removed requirement of pypeclub role from default settings [\#3354](https://github.com/pypeclub/OpenPype/pull/3354)
 - Kitsu: Prevent crash on missing frames information [\#3352](https://github.com/pypeclub/OpenPype/pull/3352)
 - Ftrack: Open browser from tray [\#3320](https://github.com/pypeclub/OpenPype/pull/3320)
-- Enhancement: More control over thumbnail processing. [\#3259](https://github.com/pypeclub/OpenPype/pull/3259)
 
 **🐛 Bug fixes**
 
@@ -63,6 +72,7 @@
 - nuke: adding extract thumbnail settings 3.10 [\#3347](https://github.com/pypeclub/OpenPype/pull/3347)
 - General: Fix last version function [\#3345](https://github.com/pypeclub/OpenPype/pull/3345)
 - Deadline: added OPENPYPE\_MONGO to filter [\#3336](https://github.com/pypeclub/OpenPype/pull/3336)
+- Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
 
 **🔀 Refactored code**
 
@@ -90,15 +100,13 @@
 - General: Updated windows oiio tool [\#3268](https://github.com/pypeclub/OpenPype/pull/3268)
 - Unreal: add support for skeletalMesh and staticMesh to loaders [\#3267](https://github.com/pypeclub/OpenPype/pull/3267)
 - Maya: reference loaders could store placeholder in referenced url [\#3264](https://github.com/pypeclub/OpenPype/pull/3264)
-- TVPaint: Init file for TVPaint worker also handle guideline images [\#3250](https://github.com/pypeclub/OpenPype/pull/3250)
-- Nuke: Change default icon path in settings [\#3247](https://github.com/pypeclub/OpenPype/pull/3247)
 
 **🐛 Bug fixes**
 
+- General: Handle empty source key on instance [\#3342](https://github.com/pypeclub/OpenPype/pull/3342)
 - Houdini: Fix Houdini VDB manage update wrong file attribute name [\#3322](https://github.com/pypeclub/OpenPype/pull/3322)
 - Nuke: anatomy compatibility issue hacks [\#3321](https://github.com/pypeclub/OpenPype/pull/3321)
 - hiero: otio p3 compatibility issue - metadata on effect use update 3.11 [\#3314](https://github.com/pypeclub/OpenPype/pull/3314)
-- Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
 - General: Vendorized modules for Python 2 and update poetry lock [\#3305](https://github.com/pypeclub/OpenPype/pull/3305)
 - Fix - added local targets to install host [\#3303](https://github.com/pypeclub/OpenPype/pull/3303)
 - Settings: Add missing default settings for nuke gizmo [\#3301](https://github.com/pypeclub/OpenPype/pull/3301)
@@ -109,9 +117,6 @@
 - Hiero: add support for task tags 3.10.x [\#3279](https://github.com/pypeclub/OpenPype/pull/3279)
 - General: Fix Oiio tool path resolving [\#3278](https://github.com/pypeclub/OpenPype/pull/3278)
 - Maya: Fix udim support for e.g. uppercase \<UDIM\> tag [\#3266](https://github.com/pypeclub/OpenPype/pull/3266)
-- Nuke: bake reformat was failing on string type [\#3261](https://github.com/pypeclub/OpenPype/pull/3261)
-- Maya: hotfix Pxr multitexture in looks [\#3260](https://github.com/pypeclub/OpenPype/pull/3260)
-- Unreal: Fix Camera Loading if Layout is missing [\#3255](https://github.com/pypeclub/OpenPype/pull/3255)
 
 **🔀 Refactored code**
 
@@ -127,21 +132,6 @@
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.10.0-nightly.6...3.10.0)
 
-**🚀 Enhancements**
-
-- Maya: FBX camera export [\#3253](https://github.com/pypeclub/OpenPype/pull/3253)
-- General: updating common vendor `scriptmenu` to 1.5.2 [\#3246](https://github.com/pypeclub/OpenPype/pull/3246)
-
-**🐛 Bug fixes**
-
-- nuke: use framerange issue [\#3254](https://github.com/pypeclub/OpenPype/pull/3254)
-- Ftrack: Chunk sizes for queries has minimal condition [\#3244](https://github.com/pypeclub/OpenPype/pull/3244)
-
-**Merged pull requests:**
-
-- Harmony: message length in 21.1 [\#3257](https://github.com/pypeclub/OpenPype/pull/3257)
-- Harmony: 21.1 fix [\#3249](https://github.com/pypeclub/OpenPype/pull/3249)
-
 ## [3.9.8](https://github.com/pypeclub/OpenPype/tree/3.9.8) (2022-05-19)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.9.7...3.9.8)
diff --git a/openpype/version.py b/openpype/version.py
index 79e3b445f9..a30bca9f0f 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.11.2-nightly.1"
+__version__ = "3.12.0-nightly.1"
diff --git a/pyproject.toml b/pyproject.toml
index 3a5acb8490..47e6453551 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.11.2-nightly.1" # OpenPype
+version = "3.12.0-nightly.1" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From f25c662c37ced86fde5c22764665c55b9268edea Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Sat, 25 Jun 2022 11:21:25 +0300
Subject: [PATCH 0843/1227] Replace `hwFogEnable` with `fogging` flag.

---
 openpype/hosts/maya/api/lib.py                               | 5 ++---
 openpype/settings/defaults/project_settings/maya.json        | 2 +-
 .../schemas/projects_schema/schemas/schema_maya_capture.json | 2 +-
 3 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 924dc03729..cd41ba3ffd 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2550,8 +2550,8 @@ def load_capture_preset(data=None):
         if key == 'headsUpDisplay':
             temp_options['headsUpDisplay'] = True
 
-        if key == 'hwFogEnable':
-            temp_options2['hwFogEnable'] = preset[id][key] or False
+        if key == 'fogging':
+            temp_options['fogging'] = preset[id][key] or False
 
         if key == 'hwFogStart':
             temp_options2['hwFogStart'] = preset[id][key]
@@ -2605,7 +2605,6 @@ def load_capture_preset(data=None):
                 'ssaoAmount',
                 'ssaoFilterRadius',
                 'ssaoRadius',
-                'hwFogEnable',
                 'hwFogStart',
                 'hwFogEnd',
                 'hwFogAlpha',
diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index bf6c18bb95..77bc8118df 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -506,7 +506,7 @@
                     "ssaoRadius": 16,
                     "ssaoFilterRadius": 16,
                     "ssaoSamples": 16,
-                    "hwFogEnable": true,
+                    "fogging": true,
                     "hwFogFalloff": "0",
                     "hwFogDensity": 0,
                     "hwFogStart": 0,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index a87918878d..2323fbaba0 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -277,7 +277,7 @@
                         },
                         {
                             "type": "boolean",
-                            "key": "hwFogEnable",
+                            "key": "fogging",
                             "label": "Enable Hardware Fog"
                         },
                         {

From 070e1fbe7eeae73372439d4a479960d6f5f11701 Mon Sep 17 00:00:00 2001
From: "clement.hector" <clement.hector@fixstudio.com>
Date: Sat, 25 Jun 2022 17:40:02 +0200
Subject: [PATCH 0844/1227] change default project_folder_structure

---
 openpype/settings/defaults/project_settings/global.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index 9c0c6f6958..68a7b4966d 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -333,7 +333,7 @@
             ]
         }
     },
-    "project_folder_structure": "{\"__project_root__\": {\"prod\": {}, \"resources\": {\"footage\": {\"plates\": {}, \"offline\": {}}, \"audio\": {}, \"art_dept\": {}}, \"editorial\": {}, \"assets[ftrack.Library]\": {\"characters[ftrack]\": {}, \"locations[ftrack]\": {}}, \"shots[ftrack.Sequence]\": {\"scripts\": {}, \"editorial[ftrack.Folder]\": {}}}}",
+    "project_folder_structure": "{\"__project_root__\": {\"prod\": {}, \"resources\": {\"footage\": {\"plates\": {}, \"offline\": {}}, \"audio\": {}, \"art_dept\": {}}, \"editorial\": {}, \"assets\": {\"characters\": {}, \"locations\": {}}, \"shots\": {}}}",
     "sync_server": {
         "enabled": false,
         "config": {

From 46bfbd28506be577532cb68f319a3051e63957ee Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Mon, 27 Jun 2022 06:13:35 +0300
Subject: [PATCH 0845/1227] Make appropriate feature fixes.

---
 .../maya/plugins/create/create_review.py      |  8 +++---
 .../maya/plugins/publish/collect_review.py    |  4 +--
 .../maya/plugins/publish/extract_playblast.py | 26 ++++++++++++-------
 3 files changed, 23 insertions(+), 15 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_review.py b/openpype/hosts/maya/plugins/create/create_review.py
index 331f0818eb..83b7f34d82 100644
--- a/openpype/hosts/maya/plugins/create/create_review.py
+++ b/openpype/hosts/maya/plugins/create/create_review.py
@@ -15,8 +15,8 @@ class CreateReview(plugin.Creator):
     keepImages = False
     isolate = False
     imagePlane = True
-    resolutionWidth = 0
-    resolutionHeight = 0
+    attrWidth = 0
+    attrHeight = 0
     transparency = [
         "preset",
         "simple",
@@ -35,8 +35,8 @@ class CreateReview(plugin.Creator):
         for key, value in animation_data.items():
             data[key] = value
 
-        data["resolutionWidth"] = self.resolutionWidth
-        data["resolutionHeight"] = self.resolutionHeight
+        data["attrWidth"] = self.attrWidth
+        data["attrHeight"] = self.attrHeight
         data["isolate"] = self.isolate
         data["keepImages"] = self.keepImages
         data["imagePlane"] = self.imagePlane
diff --git a/openpype/hosts/maya/plugins/publish/collect_review.py b/openpype/hosts/maya/plugins/publish/collect_review.py
index 0769747205..83c4760535 100644
--- a/openpype/hosts/maya/plugins/publish/collect_review.py
+++ b/openpype/hosts/maya/plugins/publish/collect_review.py
@@ -71,8 +71,8 @@ class CollectReview(pyblish.api.InstancePlugin):
                 data['handles'] = instance.data.get('handles', None)
                 data['step'] = instance.data['step']
                 data['fps'] = instance.data['fps']
-                data['resolutionWidth'] = instance.data['resolutionWidth']
-                data['resolutionHeight'] = instance.data['resolutionHeight']
+                data['attrWidth'] = instance.data['attrWidth']
+                data['attrHeight'] = instance.data['attrHeight']
                 data["isolate"] = instance.data["isolate"]
                 cmds.setAttr(str(instance) + '.active', 1)
                 self.log.debug('data {}'.format(instance.context[i].data))
diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 7cd829dafb..6f7dd5e16a 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -1,6 +1,7 @@
 import os
 import glob
 import contextlib
+
 import clique
 import capture
 
@@ -56,23 +57,30 @@ class ExtractPlayblast(openpype.api.Extractor):
         width_preset = capture_presets["Resolution"]["width"]
         height_preset = capture_presets["Resolution"]["height"]
         # Set resolution variables from asset values
-        instance_width = instance.context.data.get("resolutionWidth")
-        instance_height = instance.context.data.get("resolutionHeight")
+        asset_width = instance.data.get("resolutionWidth")
+        asset_height = instance.data.get("resolutionHeight")
+        review_instance_width = instance.data.get("attrWidth")
+        review_instance_height = instance.data.get("attrHeight")
         preset['camera'] = camera
 
         # Tests if project resolution is set,
         # if it is a value other than zero, that value is
         # used, if not then the asset resolution is
         # used
-        if width_preset != 0:
-            preset["width"] = width_preset
-        else:
-            preset['width'] = instance_width
 
-        if height_preset != 0:
+        if review_instance_width != 0:
+            preset['width'] = review_instance_width
+        elif width_preset == 0:
+            preset['width'] = asset_width
+        elif width_preset != 0:
+            preset['width'] = width_preset
+
+        if review_instance_height != 0:
+            preset['height'] = review_instance_height
+        elif height_preset == 0:
+            preset['height'] = asset_height
+        elif height_preset != 0:
             preset['height'] = height_preset
-        else:
-            preset['height'] = instance_height
 
         preset['start_frame'] = start
         preset['end_frame'] = end

From 37c98c045e7047a6e35ee807ba476a916c04a84b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 27 Jun 2022 10:14:43 +0200
Subject: [PATCH 0846/1227] added spacing

---
 openpype/widgets/attribute_defs/files_widget.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index af5a1d130b..3135da6691 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -47,6 +47,7 @@ class DropEmpty(QtWidgets.QWidget):
         layout.addWidget(
             drop_label_widget, 0, alignment=QtCore.Qt.AlignCenter
         )
+        layout.addSpacing(10)
         layout.addStretch(1)
         layout.addWidget(
             items_label_widget, 0, alignment=QtCore.Qt.AlignCenter

From 798734fdd8906fc1f2c9fe67e131bc8f8b85ff25 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 27 Jun 2022 10:37:33 +0200
Subject: [PATCH 0847/1227] fix keyword argument

---
 openpype/hosts/nuke/api/lib.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 4b69747275..45a1e72703 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -777,7 +777,7 @@ def check_inventory_versions():
     # Find representations based on found containers
     repre_docs = get_representations(
         project_name,
-        repre_ids=repre_ids,
+        representation_ids=repre_ids,
         fields=["_id", "parent"]
     )
     # Store representations by id and collect version ids

From b74e144dbb6d9fda8ac701d957d7c9fa98005139 Mon Sep 17 00:00:00 2001
From: "Allan I. A" <76656700+Allan-I@users.noreply.github.com>
Date: Mon, 27 Jun 2022 12:15:13 +0300
Subject: [PATCH 0848/1227] Update
 openpype/settings/defaults/project_settings/maya.json
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondřej Samohel <33513211+antirotor@users.noreply.github.com>
---
 openpype/settings/defaults/project_settings/maya.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 77bc8118df..2f1dca6978 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -506,7 +506,7 @@
                     "ssaoRadius": 16,
                     "ssaoFilterRadius": 16,
                     "ssaoSamples": 16,
-                    "fogging": true,
+                    "fogging": false,
                     "hwFogFalloff": "0",
                     "hwFogDensity": 0,
                     "hwFogStart": 0,

From 800a2f90d2baaf59ad662a42a920012fac827931 Mon Sep 17 00:00:00 2001
From: "Allan I. A" <76656700+Allan-I@users.noreply.github.com>
Date: Mon, 27 Jun 2022 12:15:21 +0300
Subject: [PATCH 0849/1227] Update
 openpype/settings/defaults/project_settings/maya.json
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondřej Samohel <33513211+antirotor@users.noreply.github.com>
---
 openpype/settings/defaults/project_settings/maya.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 2f1dca6978..117b260853 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -515,7 +515,7 @@
                     "hwFogColorR": 1.0,
                     "hwFogColorG": 1.0,
                     "hwFogColorB": 1.0,
-                    "motionBlurEnable": true,
+                    "motionBlurEnable": false,
                     "motionBlurSampleCount": 8,
                     "motionBlurShutterOpenFraction": 0.2,
                     "cameras": false,

From bd07eaf262ddd017eb9fc80541df60b06e048a50 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Mon, 27 Jun 2022 09:46:14 +0000
Subject: [PATCH 0850/1227] [Automated] Bump version

---
 CHANGELOG.md        | 5 +++--
 openpype/version.py | 2 +-
 pyproject.toml      | 2 +-
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index aa720137a3..d118bbff54 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## [3.12.0-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.0-nightly.2](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.11.1...HEAD)
 
@@ -8,7 +8,7 @@
 
 - Linux: update OIIO package [\#3401](https://github.com/pypeclub/OpenPype/pull/3401)
 - General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
-- Feature/multiverse [\#3350](https://github.com/pypeclub/OpenPype/pull/3350)
+- Multiverse: expose some settings to GUI [\#3350](https://github.com/pypeclub/OpenPype/pull/3350)
 
 **🚀 Enhancements**
 
@@ -17,6 +17,7 @@
 
 **🐛 Bug fixes**
 
+- Nuke: Fix keyword argument in query function [\#3414](https://github.com/pypeclub/OpenPype/pull/3414)
 - Nuke: Collect representation files based on Write [\#3407](https://github.com/pypeclub/OpenPype/pull/3407)
 - General: Filter representations before integration start [\#3398](https://github.com/pypeclub/OpenPype/pull/3398)
 - Maya: look collector typo [\#3392](https://github.com/pypeclub/OpenPype/pull/3392)
diff --git a/openpype/version.py b/openpype/version.py
index a30bca9f0f..02f928d83c 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.0-nightly.1"
+__version__ = "3.12.0-nightly.2"
diff --git a/pyproject.toml b/pyproject.toml
index 47e6453551..a159559763 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.0-nightly.1" # OpenPype
+version = "3.12.0-nightly.2" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From c3ffa95eceb7023c9c57853ffe5eb86e95896cbe Mon Sep 17 00:00:00 2001
From: "Allan I. A" <76656700+Allan-I@users.noreply.github.com>
Date: Mon, 27 Jun 2022 13:16:35 +0300
Subject: [PATCH 0851/1227] Fix pyenv typo

---
 website/docs/dev_build.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/dev_build.md b/website/docs/dev_build.md
index c797326ce6..4e80f6e19d 100644
--- a/website/docs/dev_build.md
+++ b/website/docs/dev_build.md
@@ -214,7 +214,7 @@ $ brew install cmake
 3) Install [pyenv](https://github.com/pyenv/pyenv):
 ```shell
 $ brew install pyenv
-$ echo 'eval "$(pypenv init -)"' >> ~/.zshrc
+$ echo 'eval "$(pyenv init -)"' >> ~/.zshrc
 $ pyenv init
 $ exec "$SHELL"
 $ PATH=$(pyenv root)/shims:$PATH

From 6af7f906e5b3cde5d76aac36676e2a3ee3f18ac6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 27 Jun 2022 13:19:15 +0200
Subject: [PATCH 0852/1227] added host installation and usage of tools in host

---
 website/docs/dev_host_implementation.md | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/website/docs/dev_host_implementation.md b/website/docs/dev_host_implementation.md
index e3a2fff5e2..3702483ad1 100644
--- a/website/docs/dev_host_implementation.md
+++ b/website/docs/dev_host_implementation.md
@@ -14,7 +14,7 @@ Workflows available in OpenPype are Workfiles, Load and Create-Publish. Each of
 At this moment there is not fully unified way how host should be implemented but we're working on it. Host should have a "public face" code that can be used outside of DCC and in-DCC integration code. The main reason is that in-DCC code can have specific dependencies for python modules not available out of it's process. Hosts are located in `openpype/hosts/{host name}` folder. Current code (at many places) expect that the host name has equivalent folder there. So each subfolder should be named with the name of host it represents.
 
 ### Recommended folder structure
-```
+```python
 openpype/hosts/{host name}
 │
 │  # Content of DCC integration - with in-DCC imports
@@ -51,7 +51,7 @@ Launch hooks are not directly connected to host implementation, but they can be
 Public face is at this moment related to launching of the DCC. At this moment there there is only option to modify environment variables before launch by implementing function `add_implementation_envs` (must be available in `openpype/hosts/{host name}/__init__.py`). The function is called after pre launch hooks, as last step before subprocess launch, to be able set environment variables crutial for proper integration. It is also good place for functions that are used in prelaunch hooks and in-DCC integration. Future plans are to be able get workfiles extensions from here. Right now workfiles extensions are hardcoded in `openpype/pipeline/constants.py` under `HOST_WORKFILE_EXTENSIONS`, we would like to handle hosts as addons similar to OpenPype modules, and more improvements which are now hardcoded.
 
 ### Integration
-We've prepared base class `HostBase` in `openpype/host/host.py` to define minimum requirements and provide some default implementations. The minimum requirement for a host is `name` attribute, this host would not be able to do much but is valid. To extend functionality we've prepared interfaces that helps to identify what is host capable of and if is possible to use certain tools with it. For those cases we defined interfaces for each workflow. `IWorkfileHost` interface add requirement to implement workfiles related methods which makes host usable in combination with Workfiles tool. `ILoadHost` interface add requirements to be able load, update, switch or remove referenced representations which should add support to use Loader and Scene Inventory tools. `INewPublisher` interface is required to be able use host with new OpenPype publish workflow. This is what must or can be implemented to allow certain functionality. `HostBase` will have more responsibility which will be taken from global variables, this process won't happen at once but will be slow to keep backwards compatibility for some time.
+We've prepared base class `HostBase` in `openpype/host/host.py` to define minimum requirements and provide some default method implementations. The minimum requirement for a host is `name` attribute, this host would not be able to do much but is valid. To extend functionality we've prepared interfaces that helps to identify what is host capable of and if is possible to use certain tools with it. For those cases we defined interfaces for each workflow. `IWorkfileHost` interface add requirement to implement workfiles related methods which makes host usable in combination with Workfiles tool. `ILoadHost` interface add requirements to be able load, update, switch or remove referenced representations which should add support to use Loader and Scene Inventory tools. `INewPublisher` interface is required to be able use host with new OpenPype publish workflow. This is what must or can be implemented to allow certain functionality. `HostBase` will have more responsibility which will be taken from global variables in future. This process won't happen at once, but will be slow to keep backwards compatibility for some time.
 
 #### Example
 ```python
@@ -71,4 +71,19 @@ class MayaHost(HostBase, IWorkfileHost, ILoadHost):
 ```
 
 ### Install integration
-We have host class, now where and how to initialize it.
+We have prepared a host class, now where and how to initialize it's object? This part is DCC specific. In DCCs like Maya with embedded python and Qt we use advantage of being able to initialize object of the class directly in DCC process on start, the same happens in Nuke, Hiero and Houdini. In DCCs like Photoshop or Harmony there is launched OpenPype (python) process next to it which handles host initialization and communication with the DCC process (e.g. using sockects). Created object of host must be installed and registered to global scope of OpenPype. Which means that at this moment one process can handle only one host at a time.
+
+#### Install example (Maya startup file)
+```python
+from openpype.pipeline import install_host
+from openpype.hosts.maya.api import MayaHost
+
+
+host = MayaHost()
+install_host(host)
+```
+
+Function `install_host` cares about installing global plugins, callbacks and register host. Host registration means that the object is kept in memory and is accessible using `get_registered_host()`.
+
+### Using UI tools
+Most of functionality in DCCs is provided to artists by using UI tools. We're trying to keep UIs consistent so we use same set of tools in each host, all or most of them are Qt based. There is a `HostToolsHelper` in `openpype/tools/utils/host_tools.py` which unify showing of default tools, they can be showed almost at any point. Some of them are validating if host is capable of using them (Workfiles, Loader and Scene Inventory) which is related to [pipeline workflows](#pipeline-workflows). `HostToolsHelper` provides API to show tools but host integration must care about giving artists ability to show them. Most of DCCs have some extendable menu bar where is possible to add custom actions, which is preferred approach how to give ability to show the tools.

From 96218779a2f602be9f4196f2c33ca3178839153b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 27 Jun 2022 14:06:58 +0200
Subject: [PATCH 0853/1227] renamed 'save_current_workfile' -> 'save_workfile'

---
 openpype/host/host.py                    | 6 +++---
 openpype/hosts/maya/api/pipeline.py      | 2 +-
 openpype/tools/workfiles/files_widget.py | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/host/host.py b/openpype/host/host.py
index 94eeeb986f..b7e31d0854 100644
--- a/openpype/host/host.py
+++ b/openpype/host/host.py
@@ -323,7 +323,7 @@ class IWorkfileHost:
         return []
 
     @abstractmethod
-    def save_current_workfile(self, dst_path=None):
+    def save_workfile(self, dst_path=None):
         """Save currently opened scene.
 
         Args:
@@ -400,13 +400,13 @@ class IWorkfileHost:
         return self.get_workfile_extensions()
 
     def save_file(self, dst_path=None):
-        """Deprecated variant of 'save_current_workfile'.
+        """Deprecated variant of 'save_workfile'.
 
         Todo:
             Remove when all usages are replaced.
         """
 
-        self.save_current_workfile()
+        self.save_workfile()
 
     def open_file(self, filepath):
         """Deprecated variant of 'open_workfile'.
diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index b8c6042e4f..bad77f00c9 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -100,7 +100,7 @@ class MayaHost(HostBase, IWorkfileHost, ILoadHost):
     def open_workfile(self, filepath):
         return open_file(filepath)
 
-    def save_current_workfile(self, filepath=None):
+    def save_workfile(self, filepath=None):
         return save_file(filepath)
 
     def work_root(self, session):
diff --git a/openpype/tools/workfiles/files_widget.py b/openpype/tools/workfiles/files_widget.py
index c019518d8e..48ab0fc66e 100644
--- a/openpype/tools/workfiles/files_widget.py
+++ b/openpype/tools/workfiles/files_widget.py
@@ -481,7 +481,7 @@ class FilesWidget(QtWidgets.QWidget):
 
                 # Save current scene, continue to open file
                 if isinstance(host, IWorkfileHost):
-                    host.save_current_workfile(current_file)
+                    host.save_workfile(current_file)
                 else:
                     host.save_file(current_file)
 
@@ -653,7 +653,7 @@ class FilesWidget(QtWidgets.QWidget):
 
         if not self.published_enabled:
             if isinstance(self.host, IWorkfileHost):
-                self.host.save_current_workfile(filepath)
+                self.host.save_workfile(filepath)
             else:
                 self.host.save_file(filepath)
         else:

From 8aa5770c0cb8e72ad95d16169080284b025f4510 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?=
 <33513211+antirotor@users.noreply.github.com>
Date: Mon, 27 Jun 2022 14:09:23 +0200
Subject: [PATCH 0854/1227] :bug: fix resurfacing of avalon import

---
 openpype/lib/path_tools.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/lib/path_tools.py b/openpype/lib/path_tools.py
index a016aa5c25..795866756a 100644
--- a/openpype/lib/path_tools.py
+++ b/openpype/lib/path_tools.py
@@ -11,7 +11,7 @@ from openpype.settings import get_project_settings
 from .anatomy import Anatomy
 from .profiles_filtering import filter_profiles
 
-import avalon.api
+from openpype.pipeline import AvalonMongoDB
 
 log = logging.getLogger(__name__)
 
@@ -204,7 +204,7 @@ def concatenate_splitted_paths(split_paths, anatomy):
 
 
 def get_format_data(anatomy):
-    dbcon = avalon.api.AvalonMongoDB()
+    dbcon = AvalonMongoDB()
     dbcon.Session["AVALON_PROJECT"] = anatomy.project_name
     project_doc = dbcon.find_one({"type": "project"})
     project_code = project_doc["data"]["code"]

From 918ee531838c283cd4ac8312215ae7351ba8fadf Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 27 Jun 2022 14:10:35 +0200
Subject: [PATCH 0855/1227] renamed 'get_referenced_containers' ->
 'get_containers'

---
 openpype/host/host.py                  | 8 ++++----
 openpype/hosts/maya/api/pipeline.py    | 2 +-
 openpype/tools/sceneinventory/model.py | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/host/host.py b/openpype/host/host.py
index b7e31d0854..48907e7ec7 100644
--- a/openpype/host/host.py
+++ b/openpype/host/host.py
@@ -234,14 +234,14 @@ class ILoadHost:
             raise MissingMethodsError(host, missing)
 
     @abstractmethod
-    def get_referenced_containers(self):
+    def get_containers(self):
         """Retreive referenced containers from scene.
 
         This can be implemented in hosts where referencing can be used.
 
         Todo:
             Rename function to something more self explanatory.
-                Suggestion: 'get_referenced_containers'
+                Suggestion: 'get_containers'
 
         Returns:
             list[dict]: Information about loaded containers.
@@ -251,13 +251,13 @@ class ILoadHost:
 
     # --- Deprecated method names ---
     def ls(self):
-        """Deprecated variant of 'get_referenced_containers'.
+        """Deprecated variant of 'get_containers'.
 
         Todo:
             Remove when all usages are replaced.
         """
 
-        return self.get_referenced_containers()
+        return self.get_containers()
 
 
 @six.add_metaclass(ABCMeta)
diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index bad77f00c9..d08e8d1926 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -115,7 +115,7 @@ class MayaHost(HostBase, IWorkfileHost, ILoadHost):
     def get_workfile_extensions(self):
         return file_extensions()
 
-    def get_referenced_containers(self):
+    def get_containers(self):
         return ls()
 
     @contextlib.contextmanager
diff --git a/openpype/tools/sceneinventory/model.py b/openpype/tools/sceneinventory/model.py
index 2894932e96..63fbe04c5c 100644
--- a/openpype/tools/sceneinventory/model.py
+++ b/openpype/tools/sceneinventory/model.py
@@ -195,7 +195,7 @@ class InventoryModel(TreeModel):
         host = registered_host()
         if not items:  # for debugging or testing, injecting items from outside
             if isinstance(host, ILoadHost):
-                items = host.get_referenced_containers()
+                items = host.get_containers()
             else:
                 items = host.ls()
 

From aa9183b2c20ff07485b3987e8fa84504833e13c1 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 27 Jun 2022 14:23:42 +0200
Subject: [PATCH 0856/1227] use client query function 'get_project'

---
 openpype/lib/path_tools.py | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/openpype/lib/path_tools.py b/openpype/lib/path_tools.py
index 795866756a..caad20f4d6 100644
--- a/openpype/lib/path_tools.py
+++ b/openpype/lib/path_tools.py
@@ -6,13 +6,12 @@ import logging
 import six
 import platform
 
+from openpype.client import get_project
 from openpype.settings import get_project_settings
 
 from .anatomy import Anatomy
 from .profiles_filtering import filter_profiles
 
-from openpype.pipeline import AvalonMongoDB
-
 log = logging.getLogger(__name__)
 
 
@@ -204,9 +203,7 @@ def concatenate_splitted_paths(split_paths, anatomy):
 
 
 def get_format_data(anatomy):
-    dbcon = AvalonMongoDB()
-    dbcon.Session["AVALON_PROJECT"] = anatomy.project_name
-    project_doc = dbcon.find_one({"type": "project"})
+    project_doc = get_project(anatomy.project_name, fields=["data.code"])
     project_code = project_doc["data"]["code"]
 
     return {

From 1da6eef8d3501644cfb9751e45082aba85899e3b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 27 Jun 2022 14:54:20 +0200
Subject: [PATCH 0857/1227] fix subset name change on change of creator plugin

---
 openpype/tools/publisher/widgets/create_dialog.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index 53bbef8b75..3a68835dc7 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -977,7 +977,12 @@ class CreateDialog(QtWidgets.QDialog):
             elif variant:
                 self.variant_hints_menu.addAction(variant)
 
-        self.variant_input.setText(default_variant or "Main")
+        variant_text = default_variant or "Main"
+        # Make sure subset name is updated to new plugin
+        if variant_text == self.variant_input.text():
+            self._on_variant_change()
+        else:
+            self.variant_input.setText(variant_text)
 
     def _on_variant_widget_resize(self):
         self.variant_hints_btn.setFixedHeight(self.variant_input.height())

From edff8ed4005122c90e2f823385327184149647ae Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 27 Jun 2022 18:25:07 +0200
Subject: [PATCH 0858/1227] use query functions in load camera

---
 .../hosts/unreal/plugins/load/load_camera.py  | 45 ++++++++++---------
 1 file changed, 23 insertions(+), 22 deletions(-)

diff --git a/openpype/hosts/unreal/plugins/load/load_camera.py b/openpype/hosts/unreal/plugins/load/load_camera.py
index e93be486b0..a61d5642c0 100644
--- a/openpype/hosts/unreal/plugins/load/load_camera.py
+++ b/openpype/hosts/unreal/plugins/load/load_camera.py
@@ -6,7 +6,7 @@ import unreal
 from unreal import EditorAssetLibrary
 from unreal import EditorLevelLibrary
 from unreal import EditorLevelUtils
-
+from openpype.client import get_assets, get_asset_by_name
 from openpype.pipeline import (
     AVALON_CONTAINER_ID,
     legacy_io,
@@ -24,14 +24,6 @@ class CameraLoader(plugin.Loader):
     icon = "cube"
     color = "orange"
 
-    def _get_data(self, asset_name):
-        asset_doc = legacy_io.find_one({
-            "type": "asset",
-            "name": asset_name
-        })
-
-        return asset_doc.get("data")
-
     def _set_sequence_hierarchy(
         self, seq_i, seq_j, min_frame_j, max_frame_j
     ):
@@ -177,6 +169,19 @@ class CameraLoader(plugin.Loader):
         EditorLevelLibrary.save_all_dirty_levels()
         EditorLevelLibrary.load_level(level)
 
+        project_name = legacy_io.active_project()
+        # TODO refactor
+        #   - variables does not match their meaning
+        #       - why scene is stored to sequences?
+        #       - asset documents vs. elements
+        #   - cleanup variable names in whole function
+        #       - e.g. 'asset', 'asset_name', 'asset_data', 'asset_doc'
+        #   - this loop should be a method
+        #   - really inefficient queries of asset documents
+        #       - it looks like the loader cares about much more then should?
+        #   - existing asset in scene is considered as "with correct values"
+        #   - variable 'elements' is modified during it's loop?
+        #   - separate into more methods (spaghetti)
         # Get all the sequences in the hierarchy. It will create them, if
         # they don't exist.
         sequences = []
@@ -201,26 +206,22 @@ class CameraLoader(plugin.Loader):
                     factory=unreal.LevelSequenceFactoryNew()
                 )
 
-                asset_data = legacy_io.find_one({
-                    "type": "asset",
-                    "name": h.split('/')[-1]
-                })
-
-                id = asset_data.get('_id')
+                asset_data = get_asset_by_name(project_name, h.split('/')[-1])
 
                 start_frames = []
                 end_frames = []
 
-                elements = list(
-                    legacy_io.find({"type": "asset", "data.visualParent": id}))
+                elements = list(get_assets(
+                    project_name, parent_ids=[asset_data["_id"]]
+                ))
+
                 for e in elements:
                     start_frames.append(e.get('data').get('clipIn'))
                     end_frames.append(e.get('data').get('clipOut'))
 
-                    elements.extend(legacy_io.find({
-                        "type": "asset",
-                        "data.visualParent": e.get('_id')
-                    }))
+                    elements.extend(get_assets(
+                        project_name, parent_ids=[e["_id"]]
+                    ))
 
                 min_frame = min(start_frames)
                 max_frame = max(end_frames)
@@ -256,7 +257,7 @@ class CameraLoader(plugin.Loader):
                 sequences[i], sequences[i + 1],
                 frame_ranges[i + 1][0], frame_ranges[i + 1][1])
 
-        data = self._get_data(asset)
+        data = get_asset_by_name(project_name, asset)["data"]
         cam_seq.set_display_rate(
             unreal.FrameRate(data.get("fps"), 1.0))
         cam_seq.set_playback_start(0)

From 447d9eab5c178287ddc011c1ee7d40b1a60d21f8 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 27 Jun 2022 18:40:35 +0200
Subject: [PATCH 0859/1227] use query functions in unreal

---
 .../hosts/unreal/plugins/load/load_camera.py  | 16 +++++--
 .../hosts/unreal/plugins/load/load_layout.py  | 42 +++++++++----------
 .../unreal/plugins/publish/extract_layout.py  | 16 ++++---
 3 files changed, 39 insertions(+), 35 deletions(-)

diff --git a/openpype/hosts/unreal/plugins/load/load_camera.py b/openpype/hosts/unreal/plugins/load/load_camera.py
index a61d5642c0..15adf8a5d5 100644
--- a/openpype/hosts/unreal/plugins/load/load_camera.py
+++ b/openpype/hosts/unreal/plugins/load/load_camera.py
@@ -171,6 +171,8 @@ class CameraLoader(plugin.Loader):
 
         project_name = legacy_io.active_project()
         # TODO refactor
+        #   - Creationg of hierarchy should be a function in unreal integration
+        #       - it's used in multiple loaders but must not be loader's logic
         #   - variables does not match their meaning
         #       - why scene is stored to sequences?
         #       - asset documents vs. elements
@@ -206,13 +208,19 @@ class CameraLoader(plugin.Loader):
                     factory=unreal.LevelSequenceFactoryNew()
                 )
 
-                asset_data = get_asset_by_name(project_name, h.split('/')[-1])
+                asset_data = get_asset_by_name(
+                    project_name,
+                    h.split('/')[-1],
+                    fields=["_id", "data.fps"]
+                )
 
                 start_frames = []
                 end_frames = []
 
                 elements = list(get_assets(
-                    project_name, parent_ids=[asset_data["_id"]]
+                    project_name,
+                    parent_ids=[asset_data["_id"]],
+                    fields=["_id", "data.clipIn", "data.clipOut"]
                 ))
 
                 for e in elements:
@@ -220,7 +228,9 @@ class CameraLoader(plugin.Loader):
                     end_frames.append(e.get('data').get('clipOut'))
 
                     elements.extend(get_assets(
-                        project_name, parent_ids=[e["_id"]]
+                        project_name,
+                        parent_ids=[e["_id"]],
+                        fields=["_id", "data.clipIn", "data.clipOut"]
                     ))
 
                 min_frame = min(start_frames)
diff --git a/openpype/hosts/unreal/plugins/load/load_layout.py b/openpype/hosts/unreal/plugins/load/load_layout.py
index c65cd25ac8..3f16a68ead 100644
--- a/openpype/hosts/unreal/plugins/load/load_layout.py
+++ b/openpype/hosts/unreal/plugins/load/load_layout.py
@@ -1,6 +1,5 @@
 # -*- coding: utf-8 -*-
 """Loader for layouts."""
-import os
 import json
 from pathlib import Path
 
@@ -12,6 +11,7 @@ from unreal import AssetToolsHelpers
 from unreal import FBXImportType
 from unreal import MathLibrary as umath
 
+from openpype.client import get_asset_by_name, get_assets
 from openpype.pipeline import (
     discover_loader_plugins,
     loaders_from_representation,
@@ -88,15 +88,6 @@ class LayoutLoader(plugin.Loader):
 
         return None
 
-    @staticmethod
-    def _get_data(asset_name):
-        asset_doc = legacy_io.find_one({
-            "type": "asset",
-            "name": asset_name
-        })
-
-        return asset_doc.get("data")
-
     @staticmethod
     def _set_sequence_hierarchy(
         seq_i, seq_j, max_frame_i, min_frame_j, max_frame_j, map_paths
@@ -364,26 +355,30 @@ class LayoutLoader(plugin.Loader):
             factory=unreal.LevelSequenceFactoryNew()
         )
 
-        asset_data = legacy_io.find_one({
-            "type": "asset",
-            "name": h_dir.split('/')[-1]
-        })
-
-        id = asset_data.get('_id')
+        project_name = legacy_io.active_project()
+        asset_data = get_asset_by_name(
+            project_name,
+            h_dir.split('/')[-1],
+            fields=["_id", "data.fps"]
+        )
 
         start_frames = []
         end_frames = []
 
-        elements = list(
-            legacy_io.find({"type": "asset", "data.visualParent": id}))
+        elements = list(get_assets(
+            project_name,
+            parent_ids=[asset_data["_id"]],
+            fields=["_id", "data.clipIn", "data.clipOut"]
+        ))
         for e in elements:
             start_frames.append(e.get('data').get('clipIn'))
             end_frames.append(e.get('data').get('clipOut'))
 
-            elements.extend(legacy_io.find({
-                "type": "asset",
-                "data.visualParent": e.get('_id')
-            }))
+            elements.extend(get_assets(
+                project_name,
+                parent_ids=[e["_id"]],
+                fields=["_id", "data.clipIn", "data.clipOut"]
+            ))
 
         min_frame = min(start_frames)
         max_frame = max(end_frames)
@@ -659,7 +654,8 @@ class LayoutLoader(plugin.Loader):
                 frame_ranges[i + 1][0], frame_ranges[i + 1][1],
                 [level])
 
-        data = self._get_data(asset)
+        project_name = legacy_io.active_project()
+        data = get_asset_by_name(project_name, asset)["data"]
         shot.set_display_rate(
             unreal.FrameRate(data.get("fps"), 1.0))
         shot.set_playback_start(0)
diff --git a/openpype/hosts/unreal/plugins/publish/extract_layout.py b/openpype/hosts/unreal/plugins/publish/extract_layout.py
index 87e6693a97..8924df36a7 100644
--- a/openpype/hosts/unreal/plugins/publish/extract_layout.py
+++ b/openpype/hosts/unreal/plugins/publish/extract_layout.py
@@ -9,6 +9,7 @@ import unreal
 from unreal import EditorLevelLibrary as ell
 from unreal import EditorAssetLibrary as eal
 
+from openpype.client import get_representation_by_name
 import openpype.api
 from openpype.pipeline import legacy_io
 
@@ -34,6 +35,7 @@ class ExtractLayout(openpype.api.Extractor):
             "Wrong level loaded"
 
         json_data = []
+        project_name = legacy_io.active_project()
 
         for member in instance[:]:
             actor = ell.get_actor_reference(member)
@@ -57,17 +59,13 @@ class ExtractLayout(openpype.api.Extractor):
                     self.log.error("AssetContainer not found.")
                     return
 
-                parent = eal.get_metadata_tag(asset_container, "parent")
+                parent_id = eal.get_metadata_tag(asset_container, "parent")
                 family = eal.get_metadata_tag(asset_container, "family")
 
-                self.log.info("Parent: {}".format(parent))
-                blend = legacy_io.find_one(
-                    {
-                        "type": "representation",
-                        "parent": ObjectId(parent),
-                        "name": "blend"
-                    },
-                    projection={"_id": True})
+                self.log.info("Parent: {}".format(parent_id))
+                blend = get_representation_by_name(
+                    project_name, "blend", parent_id, fields=["_id"]
+                )
                 blend_id = blend["_id"]
 
                 json_element = {}

From e7883fbbcca294a7b3a78e2da82445110b0545a8 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 27 Jun 2022 18:42:02 +0200
Subject: [PATCH 0860/1227] removed unused import

---
 openpype/hosts/unreal/plugins/create/create_render.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/unreal/plugins/create/create_render.py b/openpype/hosts/unreal/plugins/create/create_render.py
index a3e125a94e..950799cc10 100644
--- a/openpype/hosts/unreal/plugins/create/create_render.py
+++ b/openpype/hosts/unreal/plugins/create/create_render.py
@@ -1,6 +1,5 @@
 import unreal
 
-from openpype.pipeline import legacy_io
 from openpype.hosts.unreal.api import pipeline
 from openpype.hosts.unreal.api.plugin import Creator
 

From 12eb1cc53b0e3b6023bf03596719671496edd909 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 27 Jun 2022 18:51:10 +0200
Subject: [PATCH 0861/1227] modified comments

---
 openpype/hosts/unreal/plugins/load/load_camera.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/unreal/plugins/load/load_camera.py b/openpype/hosts/unreal/plugins/load/load_camera.py
index 15adf8a5d5..ca6b0ce736 100644
--- a/openpype/hosts/unreal/plugins/load/load_camera.py
+++ b/openpype/hosts/unreal/plugins/load/load_camera.py
@@ -173,17 +173,15 @@ class CameraLoader(plugin.Loader):
         # TODO refactor
         #   - Creationg of hierarchy should be a function in unreal integration
         #       - it's used in multiple loaders but must not be loader's logic
+        #       - hard to say what is purpose of the loop
         #   - variables does not match their meaning
         #       - why scene is stored to sequences?
         #       - asset documents vs. elements
         #   - cleanup variable names in whole function
         #       - e.g. 'asset', 'asset_name', 'asset_data', 'asset_doc'
-        #   - this loop should be a method
         #   - really inefficient queries of asset documents
-        #       - it looks like the loader cares about much more then should?
         #   - existing asset in scene is considered as "with correct values"
-        #   - variable 'elements' is modified during it's loop?
-        #   - separate into more methods (spaghetti)
+        #   - variable 'elements' is modified during it's loop
         # Get all the sequences in the hierarchy. It will create them, if
         # they don't exist.
         sequences = []

From 409bf1b6e51c9ea6ab1fe6be1aca58dda8aa0bb4 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 28 Jun 2022 05:24:42 +0300
Subject: [PATCH 0862/1227] Rename `attr` into `instance` refactor.

---
 openpype/hosts/maya/plugins/create/create_review.py      | 4 ++--
 openpype/hosts/maya/plugins/publish/collect_review.py    | 4 ++--
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_review.py b/openpype/hosts/maya/plugins/create/create_review.py
index 83b7f34d82..44dc8a3158 100644
--- a/openpype/hosts/maya/plugins/create/create_review.py
+++ b/openpype/hosts/maya/plugins/create/create_review.py
@@ -35,8 +35,8 @@ class CreateReview(plugin.Creator):
         for key, value in animation_data.items():
             data[key] = value
 
-        data["attrWidth"] = self.attrWidth
-        data["attrHeight"] = self.attrHeight
+        data["instanceHeight"] = self.attrWidth
+        data["instanceWidth"] = self.attrHeight
         data["isolate"] = self.isolate
         data["keepImages"] = self.keepImages
         data["imagePlane"] = self.imagePlane
diff --git a/openpype/hosts/maya/plugins/publish/collect_review.py b/openpype/hosts/maya/plugins/publish/collect_review.py
index 83c4760535..fec1fbfa11 100644
--- a/openpype/hosts/maya/plugins/publish/collect_review.py
+++ b/openpype/hosts/maya/plugins/publish/collect_review.py
@@ -71,8 +71,8 @@ class CollectReview(pyblish.api.InstancePlugin):
                 data['handles'] = instance.data.get('handles', None)
                 data['step'] = instance.data['step']
                 data['fps'] = instance.data['fps']
-                data['attrWidth'] = instance.data['attrWidth']
-                data['attrHeight'] = instance.data['attrHeight']
+                data['instanceHeight'] = instance.data['instanceHeight']
+                data['instanceHeight'] = instance.data['instanceHeight']
                 data["isolate"] = instance.data["isolate"]
                 cmds.setAttr(str(instance) + '.active', 1)
                 self.log.debug('data {}'.format(instance.context[i].data))
diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 6f7dd5e16a..7f9875f564 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -59,8 +59,8 @@ class ExtractPlayblast(openpype.api.Extractor):
         # Set resolution variables from asset values
         asset_width = instance.data.get("resolutionWidth")
         asset_height = instance.data.get("resolutionHeight")
-        review_instance_width = instance.data.get("attrWidth")
-        review_instance_height = instance.data.get("attrHeight")
+        review_instance_width = instance.data.get("instanceWidth")
+        review_instance_height = instance.data.get("instanceHeight")
         preset['camera'] = camera
 
         # Tests if project resolution is set,

From aca0c2a52b652f013922d71d27b55314c361ebe6 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 28 Jun 2022 05:25:54 +0300
Subject: [PATCH 0863/1227] Fix thumbnail extractor to match playblast
 resolution.

---
 .../maya/plugins/publish/extract_thumbnail.py | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
index c2cefc56f1..119ad10496 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -60,7 +60,32 @@ class ExtractThumbnail(openpype.api.Extractor):
             "overscan": 1.0,
             "depthOfField": cmds.getAttr("{0}.depthOfField".format(camera)),
         }
+        capture_presets = capture_preset
+        # Set resolution variables from capture presets
+        width_preset = capture_presets["Resolution"]["width"]
+        height_preset = capture_presets["Resolution"]["height"]
+        # Set resolution variables from asset values
+        asset_width = instance.data.get("resolutionWidth")
+        asset_height = instance.data.get("resolutionHeight")
+        review_instance_width = instance.data.get("instanceWidth")
+        review_instance_height = instance.data.get("instanceHeight")
+        # Tests if project resolution is set,
+        # if it is a value other than zero, that value is
+        # used, if not then the asset resolution is
+        # used
+        if review_instance_width != 0:
+            preset['width'] = review_instance_width
+        elif width_preset == 0:
+            preset['width'] = asset_width
+        elif width_preset != 0:
+            preset['width'] = width_preset
 
+        if review_instance_height != 0:
+            preset['height'] = review_instance_height
+        elif height_preset == 0:
+            preset['height'] = asset_height
+        elif height_preset != 0:
+            preset['height'] = height_preset
         stagingDir = self.staging_dir(instance)
         filename = "{0}".format(instance.name)
         path = os.path.join(stagingDir, filename)

From dd5cef560a44a513ae3395fd84f6c02c1adffff8 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 28 Jun 2022 05:56:36 +0300
Subject: [PATCH 0864/1227] Adjust setting position

---
 .../schemas/schema_maya_capture.json             | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index 2323fbaba0..0a63315622 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -204,14 +204,6 @@
                         {
                             "type": "splitter"
                         },
-                        {
-                            "type": "number",
-                            "key": "multiSample",
-                            "label": "Anti Aliasing Samples",
-                            "decimal": 0,
-                            "minimum": 0,
-                            "maximum": 32
-                        },
                         {
                             "type": "splitter"
                         },
@@ -238,6 +230,14 @@
                             "key": "lineAAEnable",
                             "label": "Enable Anti-Aliasing"
                         },
+                        {
+                            "type": "number",
+                            "key": "multiSample",
+                            "label": "Anti Aliasing Samples",
+                            "decimal": 0,
+                            "minimum": 0,
+                            "maximum": 32
+                        },
                         {
                             "type": "splitter"
                         },

From e9f67f8747cad536c591884701fc441f177d3574 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 28 Jun 2022 05:56:51 +0300
Subject: [PATCH 0865/1227] Adjust some defaults.

---
 openpype/settings/defaults/project_settings/maya.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 117b260853..bb7719dc30 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -496,19 +496,19 @@
                     "override_viewport_options": true,
                     "displayLights": "default",
                     "textureMaxResolution": 1024,
-                    "multiSample": 4,
                     "shadows": true,
                     "textures": true,
                     "twoSidedLighting": true,
                     "lineAAEnable": true,
-                    "ssaoEnable": true,
+                    "multiSample": 8,
+                    "ssaoEnable": false,
                     "ssaoAmount": 1,
                     "ssaoRadius": 16,
                     "ssaoFilterRadius": 16,
                     "ssaoSamples": 16,
                     "fogging": false,
                     "hwFogFalloff": "0",
-                    "hwFogDensity": 0,
+                    "hwFogDensity": 0.0,
                     "hwFogStart": 0,
                     "hwFogEnd": 100,
                     "hwFogAlpha": 0,

From 3b8b479712af6e95545539921f0439de547c460b Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 28 Jun 2022 09:07:28 +0200
Subject: [PATCH 0866/1227] Skip extraction when no visible nodes found in
 frame range

---
 openpype/hosts/maya/plugins/publish/extract_animation.py  | 7 +++++++
 openpype/hosts/maya/plugins/publish/extract_pointcache.py | 7 +++++++
 2 files changed, 14 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_animation.py b/openpype/hosts/maya/plugins/publish/extract_animation.py
index b04e2bf0c4..4b650b4b26 100644
--- a/openpype/hosts/maya/plugins/publish/extract_animation.py
+++ b/openpype/hosts/maya/plugins/publish/extract_animation.py
@@ -86,6 +86,13 @@ class ExtractAnimation(openpype.api.Extractor):
             nodes = get_visible_in_frame_range(nodes,
                                                start=start,
                                                end=end)
+            if not nodes:
+                self.log.warning(
+                    "No visible nodes found in frame range {}-{}. "
+                    "Skipping extraction because `visibleOnly` is enabled on "
+                    "the instance.".format(start, end)
+                )
+                return
 
         with suspended_refresh():
             with maintained_selection():
diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index f582a106d9..768ee6da3d 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -89,6 +89,13 @@ class ExtractAlembic(openpype.api.Extractor):
             nodes = get_visible_in_frame_range(nodes,
                                                start=start,
                                                end=end)
+            if not nodes:
+                self.log.warning(
+                    "No visible nodes found in frame range {}-{}. "
+                    "Skipping extraction because `visibleOnly` is enabled on "
+                    "the instance.".format(start, end)
+                )
+                return
 
         with suspended_refresh():
             with maintained_selection():

From 0c674fcc61a636ebfc5e888e0f0f782dffa366f1 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Tue, 28 Jun 2022 09:15:09 +0200
Subject: [PATCH 0867/1227] expand spacing of the drop zone

---
 openpype/widgets/attribute_defs/files_widget.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index 3135da6691..698a91a1a5 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -43,11 +43,11 @@ class DropEmpty(QtWidgets.QWidget):
 
         layout = QtWidgets.QVBoxLayout(self)
         layout.setContentsMargins(0, 0, 0, 0)
-        layout.addSpacing(10)
+        layout.addSpacing(20)
         layout.addWidget(
             drop_label_widget, 0, alignment=QtCore.Qt.AlignCenter
         )
-        layout.addSpacing(10)
+        layout.addSpacing(30)
         layout.addStretch(1)
         layout.addWidget(
             items_label_widget, 0, alignment=QtCore.Qt.AlignCenter

From 46bfa3122f1f6cfbc9f70b8ad65b68974c072dd6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 28 Jun 2022 10:33:51 +0200
Subject: [PATCH 0868/1227] fix typo in typo

---
 openpype/lib/editorial.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/lib/editorial.py b/openpype/lib/editorial.py
index 2730ba1f3c..18028c5f06 100644
--- a/openpype/lib/editorial.py
+++ b/openpype/lib/editorial.py
@@ -65,7 +65,7 @@ def range_from_frames(*args, **kwargs):
 
 
 @editorial_deprecated
-def frames_to_seconds(*args, **kwargs):
+def frames_to_secons(*args, **kwargs):
     from openpype.pipeline.editorial import frames_to_seconds
 
     return frames_to_seconds(*args, **kwargs)

From 843d92484df1c19b53d95bac49ea44aeb8e2a784 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 28 Jun 2022 10:42:48 +0200
Subject: [PATCH 0869/1227] added special deprecation warning error

---
 openpype/lib/editorial.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/openpype/lib/editorial.py b/openpype/lib/editorial.py
index 18028c5f06..49220b4f15 100644
--- a/openpype/lib/editorial.py
+++ b/openpype/lib/editorial.py
@@ -1,7 +1,16 @@
+"""Code related to editorial utility functions was moved
+to 'openpype.pipeline.editorial' please change your imports as soon as
+possible. File will be probably removed in OpenPype 3.14.*
+"""
+
 import warnings
 import functools
 
 
+class EditorialDeprecatedWarning(DeprecationWarning):
+    pass
+
+
 def editorial_deprecated(func):
     """Mark functions as deprecated.
 
@@ -10,12 +19,13 @@ def editorial_deprecated(func):
 
     @functools.wraps(func)
     def new_func(*args, **kwargs):
+        warnings.simplefilter("always", EditorialDeprecatedWarning)
         warnings.warn(
             (
                 "Call to deprecated function '{}'."
                 " Function was moved to 'openpype.pipeline.editorial'."
             ).format(func.__name__),
-            category=DeprecationWarning,
+            category=EditorialDeprecatedWarning,
             stacklevel=2
         )
         return func(*args, **kwargs)

From f846ef45d473ba4849f4bb0ed73fc7f9fcb1a546 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 28 Jun 2022 10:52:12 +0200
Subject: [PATCH 0870/1227] removed signature validation from host registration

---
 openpype/pipeline/context_tools.py | 65 ------------------------------
 1 file changed, 65 deletions(-)

diff --git a/openpype/pipeline/context_tools.py b/openpype/pipeline/context_tools.py
index 4a147c230b..f1b7b565c3 100644
--- a/openpype/pipeline/context_tools.py
+++ b/openpype/pipeline/context_tools.py
@@ -1,11 +1,9 @@
 """Core pipeline functionality"""
 
 import os
-import sys
 import json
 import types
 import logging
-import inspect
 import platform
 
 import pyblish.api
@@ -235,73 +233,10 @@ def register_host(host):
             required, or browse the source code.
 
     """
-    signatures = {
-        "ls": []
-    }
 
-    _validate_signature(host, signatures)
     _registered_host["_"] = host
 
 
-def _validate_signature(module, signatures):
-    # Required signatures for each member
-
-    missing = list()
-    invalid = list()
-    success = True
-
-    for member in signatures:
-        if not hasattr(module, member):
-            missing.append(member)
-            success = False
-
-        else:
-            attr = getattr(module, member)
-            if sys.version_info.major >= 3:
-                signature = inspect.getfullargspec(attr)[0]
-            else:
-                signature = inspect.getargspec(attr)[0]
-            required_signature = signatures[member]
-
-            assert isinstance(signature, list)
-            assert isinstance(required_signature, list)
-
-            if not all(member in signature
-                       for member in required_signature):
-                invalid.append({
-                    "member": member,
-                    "signature": ", ".join(signature),
-                    "required": ", ".join(required_signature)
-                })
-                success = False
-
-    if not success:
-        report = list()
-
-        if missing:
-            report.append(
-                "Incomplete interface for module: '%s'\n"
-                "Missing: %s" % (module, ", ".join(
-                    "'%s'" % member for member in missing))
-            )
-
-        if invalid:
-            report.append(
-                "'%s': One or more members were found, but didn't "
-                "have the right argument signature." % module.__name__
-            )
-
-            for member in invalid:
-                report.append(
-                    "     Found: {member}({signature})".format(**member)
-                )
-                report.append(
-                    "  Expected: {member}({required})".format(**member)
-                )
-
-        raise ValueError("\n".join(report))
-
-
 def registered_host():
     """Return currently registered host"""
     return _registered_host["_"]

From 4450d3e7374ad1e158e8890c8ad0a16bb9845857 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 28 Jun 2022 12:44:24 +0200
Subject: [PATCH 0871/1227] add parent_ids to possible query filters

---
 openpype/client/entities.py | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 9864fee469..28cd994254 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -146,6 +146,7 @@ def _get_assets(
     project_name,
     asset_ids=None,
     asset_names=None,
+    parent_ids=None,
     standard=True,
     archived=False,
     fields=None
@@ -161,6 +162,7 @@ def _get_assets(
         project_name (str): Name of project where to look for queried entities.
         asset_ids (list[str|ObjectId]): Asset ids that should be found.
         asset_names (list[str]): Name assets that should be found.
+        parent_ids (list[str|ObjectId]): Parent asset ids.
         standard (bool): Query standart assets (type 'asset').
         archived (bool): Query archived assets (type 'archived_asset').
         fields (list[str]): Fields that should be returned. All fields are
@@ -196,6 +198,12 @@ def _get_assets(
             return []
         query_filter["name"] = {"$in": list(asset_names)}
 
+    if parent_ids is not None:
+        parent_ids = _convert_ids(parent_ids)
+        if not parent_ids:
+            return []
+        query_filter["data.visualParent"] = {"$in": parent_ids}
+
     conn = _get_project_connection(project_name)
 
     return conn.find(query_filter, _prepare_fields(fields))
@@ -205,6 +213,7 @@ def get_assets(
     project_name,
     asset_ids=None,
     asset_names=None,
+    parent_ids=None,
     archived=False,
     fields=None
 ):
@@ -219,6 +228,7 @@ def get_assets(
         project_name (str): Name of project where to look for queried entities.
         asset_ids (list[str|ObjectId]): Asset ids that should be found.
         asset_names (list[str]): Name assets that should be found.
+        parent_ids (list[str|ObjectId]): Parent asset ids.
         archived (bool): Add also archived assets.
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
@@ -229,7 +239,13 @@ def get_assets(
     """
 
     return _get_assets(
-        project_name, asset_ids, asset_names, True, archived, fields
+        project_name,
+        asset_ids,
+        asset_names,
+        parent_ids,
+        True,
+        archived,
+        fields
     )
 
 
@@ -237,6 +253,7 @@ def get_archived_assets(
     project_name,
     asset_ids=None,
     asset_names=None,
+    parent_ids=None,
     fields=None
 ):
     """Archived assets for specified project by passed filters.
@@ -250,6 +267,7 @@ def get_archived_assets(
         project_name (str): Name of project where to look for queried entities.
         asset_ids (list[str|ObjectId]): Asset ids that should be found.
         asset_names (list[str]): Name assets that should be found.
+        parent_ids (list[str|ObjectId]): Parent asset ids.
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
@@ -259,7 +277,7 @@ def get_archived_assets(
     """
 
     return _get_assets(
-        project_name, asset_ids, asset_names, False, True, fields
+        project_name, asset_ids, asset_names, parent_ids, False, True, fields
     )
 
 

From 35e5f7a3d256c799c18765a3d1e712e60a28ca9b Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 28 Jun 2022 14:02:25 +0300
Subject: [PATCH 0872/1227] Expose excluded families in publisher schema.

---
 .../defaults/project_settings/maya.json       |  3 +-
 .../schemas/schema_maya_publish.json          | 35 +++++++++++++++----
 2 files changed, 31 insertions(+), 7 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index cdd3a62d00..89aa7a66e6 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -204,7 +204,8 @@
         "ValidateFrameRange": {
             "enabled": true,
             "optional": true,
-            "active": true
+            "active": true,
+            "exclude_families": []
         },
         "ValidateShaderName": {
             "enabled": false,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
index 41b681d893..84182973a1 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
@@ -62,13 +62,36 @@
                 }
             ]
         },
-        {
-            "type": "schema_template",
-            "name": "template_publish_plugin",
-            "template_data": [
+        {   
+            "type": "dict",
+            "collapsible": true,
+            "key": "ValidateFrameRange",
+            "label": "Validate Frame Range",
+            "checkbox_key": "enabled",
+            "children": [
                 {
-                    "key": "ValidateFrameRange",
-                    "label": "Validate Frame Range"
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                },
+                {
+                    "type": "boolean",
+                    "key": "optional",
+                    "label": "Optional"
+                },
+                {
+                    "type": "boolean",
+                    "key": "active",
+                    "label": "Active"
+                },
+                {
+                    "type": "splitter"
+                },
+                {
+                    "key": "exclude_families",
+                    "label": "Families",
+                    "type": "list",
+                    "object_type": "text"
                 }
             ]
         },

From c7b5a6ac84cd8ec3ecbce11add48f7982458c770 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 28 Jun 2022 14:02:39 +0300
Subject: [PATCH 0873/1227] Add additional exclude families.

---
 openpype/hosts/maya/plugins/publish/validate_frame_range.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_frame_range.py b/openpype/hosts/maya/plugins/publish/validate_frame_range.py
index 4415815d32..d07a8db957 100644
--- a/openpype/hosts/maya/plugins/publish/validate_frame_range.py
+++ b/openpype/hosts/maya/plugins/publish/validate_frame_range.py
@@ -27,7 +27,7 @@ class ValidateFrameRange(pyblish.api.InstancePlugin):
                 "yeticache"]
     optional = True
     actions = [openpype.api.RepairAction]
-    exclude_families = ["model"]
+    exclude_families = ["model", "rig", "staticMesh"]
 
     def process(self, instance):
         context = instance.context

From 809153b1449da7b6614a296ce19e95a446882f95 Mon Sep 17 00:00:00 2001
From: "Allan I. A" <76656700+Allan-I@users.noreply.github.com>
Date: Tue, 28 Jun 2022 14:42:11 +0300
Subject: [PATCH 0874/1227] Update
 openpype/settings/defaults/project_settings/maya.json
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Move default families.

Co-authored-by: Ondřej Samohel <33513211+antirotor@users.noreply.github.com>
---
 openpype/settings/defaults/project_settings/maya.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 89aa7a66e6..9bebd92cb9 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -205,7 +205,7 @@
             "enabled": true,
             "optional": true,
             "active": true,
-            "exclude_families": []
+            "exclude_families": ["model", "rig", "staticMesh"]
         },
         "ValidateShaderName": {
             "enabled": false,

From 027cdf4f3a0dfc10b96555bf9920c3e9e3287cbe Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 28 Jun 2022 14:49:31 +0300
Subject: [PATCH 0875/1227] Remove unnecessary defaults.

---
 openpype/hosts/maya/plugins/publish/validate_frame_range.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_frame_range.py b/openpype/hosts/maya/plugins/publish/validate_frame_range.py
index d07a8db957..c51766379e 100644
--- a/openpype/hosts/maya/plugins/publish/validate_frame_range.py
+++ b/openpype/hosts/maya/plugins/publish/validate_frame_range.py
@@ -27,7 +27,7 @@ class ValidateFrameRange(pyblish.api.InstancePlugin):
                 "yeticache"]
     optional = True
     actions = [openpype.api.RepairAction]
-    exclude_families = ["model", "rig", "staticMesh"]
+    exclude_families = []
 
     def process(self, instance):
         context = instance.context

From 449824ff479723b54ef2a5547cef1399a88c9ba6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 28 Jun 2022 14:05:07 +0200
Subject: [PATCH 0876/1227] added aiohttps middlewares dependency

---
 poetry.lock    | 17 +++++++++++++++++
 pyproject.toml |  3 ++-
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/poetry.lock b/poetry.lock
index 47509f334e..7221e191ff 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -46,6 +46,19 @@ python-versions = ">=3.5"
 [package.dependencies]
 aiohttp = ">=3,<4"
 
+[[package]]
+name = "aiohttp-middlewares"
+version = "2.0.0"
+description = "Collection of useful middlewares for aiohttp applications."
+category = "main"
+optional = false
+python-versions = ">=3.7,<4.0"
+
+[package.dependencies]
+aiohttp = ">=3.8.1,<4.0.0"
+async-timeout = ">=4.0.2,<5.0.0"
+yarl = ">=1.5.1,<2.0.0"
+
 [[package]]
 name = "aiosignal"
 version = "1.2.0"
@@ -1783,6 +1796,10 @@ aiohttp-json-rpc = [
     {file = "aiohttp-json-rpc-0.13.3.tar.gz", hash = "sha256:6237a104478c22c6ef96c7227a01d6832597b414e4b79a52d85593356a169e99"},
     {file = "aiohttp_json_rpc-0.13.3-py3-none-any.whl", hash = "sha256:4fbd197aced61bd2df7ae3237ead7d3e08833c2ccf48b8581e1828c95ebee680"},
 ]
+aiohttp-middlewares = [
+    {file = "aiohttp-middlewares-2.0.0.tar.gz", hash = "sha256:e08ba04dc0e8fe379aa5e9444a68485c275677ee1e18c55cbb855de0c3629502"},
+    {file = "aiohttp_middlewares-2.0.0-py3-none-any.whl", hash = "sha256:29cf1513176b4013844711975ff520e26a8a5d8f9fefbbddb5e91224a86b043e"},
+]
 aiosignal = [
     {file = "aiosignal-1.2.0-py3-none-any.whl", hash = "sha256:26e62109036cd181df6e6ad646f91f0dcfd05fe16d0cb924138ff2ab75d64e3a"},
     {file = "aiosignal-1.2.0.tar.gz", hash = "sha256:78ed67db6c7b7ced4f98e495e572106d5c432a93e1ddd1bf475e1dc05f5b7df2"},
diff --git a/pyproject.toml b/pyproject.toml
index a159559763..09dfdf45cd 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -68,6 +68,7 @@ slack-sdk = "^3.6.0"
 requests = "^2.25.1"
 pysftp = "^0.2.9"
 dropbox = "^11.20.0"
+aiohttp-middlewares = "^2.0.0"
 
 
 [tool.poetry.dev-dependencies]
@@ -154,4 +155,4 @@ exclude = [
 ignore = ["website", "docs", ".git"]
 
 reportMissingImports = true
-reportMissingTypeStubs = false
\ No newline at end of file
+reportMissingTypeStubs = false

From 81cb958470371a635e7bc038a5907e32b394f073 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 28 Jun 2022 14:08:53 +0200
Subject: [PATCH 0877/1227] added cors middleware

---
 openpype/modules/webserver/cors_middleware.py | 284 ++++++++++++++++++
 openpype/modules/webserver/server.py          |  11 +-
 2 files changed, 294 insertions(+), 1 deletion(-)
 create mode 100644 openpype/modules/webserver/cors_middleware.py

diff --git a/openpype/modules/webserver/cors_middleware.py b/openpype/modules/webserver/cors_middleware.py
new file mode 100644
index 0000000000..0c47f9194e
--- /dev/null
+++ b/openpype/modules/webserver/cors_middleware.py
@@ -0,0 +1,284 @@
+r"""
+===============
+CORS Middleware
+===============
+.. versionadded:: 0.2.0
+Dealing with CORS headers for aiohttp applications.
+**IMPORTANT:** There is a `aiohttp-cors
+<https://pypi.org/project/aiohttp_cors/>`_ library, which handles CORS
+headers by attaching additional handlers to aiohttp application for
+OPTIONS (preflight) requests. In same time this CORS middleware mimics the
+logic of `django-cors-headers <https://pypi.org/project/django-cors-headers>`_,
+where all handling done in the middleware without any additional handlers. This
+approach allows aiohttp application to respond with CORS headers for OPTIONS or
+wildcard handlers, which is not possible with ``aiohttp-cors`` due to
+https://github.com/aio-libs/aiohttp-cors/issues/241 issue.
+For detailed information about CORS (Cross Origin Resource Sharing) please
+visit:
+- `Wikipedia <https://en.m.wikipedia.org/wiki/Cross-origin_resource_sharing>`_
+- Or `MDN <https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS>`_
+Configuration
+=============
+**IMPORTANT:** By default, CORS middleware do not allow any origins to access
+content from your aiohttp appliction. Which means, you need carefully check
+possible options and provide custom values for your needs.
+Usage
+=====
+.. code-block:: python
+    import re
+    from aiohttp import web
+    from aiohttp_middlewares import cors_middleware
+    from aiohttp_middlewares.cors import DEFAULT_ALLOW_HEADERS
+    # Unsecure configuration to allow all CORS requests
+    app = web.Application(
+        middlewares=[cors_middleware(allow_all=True)]
+    )
+    # Allow CORS requests from URL http://localhost:3000
+    app = web.Application(
+        middlewares=[
+            cors_middleware(origins=["http://localhost:3000"])
+        ]
+    )
+    # Allow CORS requests from all localhost urls
+    app = web.Application(
+        middlewares=[
+            cors_middleware(
+                origins=[re.compile(r"^https?\:\/\/localhost")]
+            )
+        ]
+    )
+    # Allow CORS requests from https://frontend.myapp.com as well
+    # as allow credentials
+    CORS_ALLOW_ORIGINS = ["https://frontend.myapp.com"]
+    app = web.Application(
+        middlewares=[
+            cors_middleware(
+                origins=CORS_ALLOW_ORIGINS,
+                allow_credentials=True,
+            )
+        ]
+    )
+    # Allow CORS requests only for API urls
+    app = web.Application(
+        middelwares=[
+            cors_middleware(
+                origins=CORS_ALLOW_ORIGINS,
+                urls=[re.compile(r"^\/api")],
+            )
+        ]
+    )
+    # Allow CORS requests for POST & PATCH methods, and for all
+    # default headers and `X-Client-UID`
+    app = web.Application(
+        middlewares=[
+            cors_middleware(
+                origings=CORS_ALLOW_ORIGINS,
+                allow_methods=("POST", "PATCH"),
+                allow_headers=DEFAULT_ALLOW_HEADERS
+                + ("X-Client-UID",),
+            )
+        ]
+    )
+"""
+
+import logging
+import re
+from typing import Pattern, Tuple
+
+from aiohttp import web
+
+from aiohttp_middlewares.annotations import (
+    Handler,
+    Middleware,
+    StrCollection,
+    UrlCollection,
+)
+from aiohttp_middlewares.utils import match_path
+
+
+ACCESS_CONTROL = "Access-Control"
+ACCESS_CONTROL_ALLOW = f"{ACCESS_CONTROL}-Allow"
+ACCESS_CONTROL_ALLOW_CREDENTIALS = f"{ACCESS_CONTROL_ALLOW}-Credentials"
+ACCESS_CONTROL_ALLOW_HEADERS = f"{ACCESS_CONTROL_ALLOW}-Headers"
+ACCESS_CONTROL_ALLOW_METHODS = f"{ACCESS_CONTROL_ALLOW}-Methods"
+ACCESS_CONTROL_ALLOW_ORIGIN = f"{ACCESS_CONTROL_ALLOW}-Origin"
+ACCESS_CONTROL_EXPOSE_HEADERS = f"{ACCESS_CONTROL}-Expose-Headers"
+ACCESS_CONTROL_MAX_AGE = f"{ACCESS_CONTROL}-Max-Age"
+ACCESS_CONTROL_REQUEST_METHOD = f"{ACCESS_CONTROL}-Request-Method"
+
+DEFAULT_ALLOW_HEADERS = (
+    "accept",
+    "accept-encoding",
+    "authorization",
+    "content-type",
+    "dnt",
+    "origin",
+    "user-agent",
+    "x-csrftoken",
+    "x-requested-with",
+)
+DEFAULT_ALLOW_METHODS = ("DELETE", "GET", "OPTIONS", "PATCH", "POST", "PUT")
+DEFAULT_URLS: Tuple[Pattern[str]] = (re.compile(r".*"),)
+
+logger = logging.getLogger(__name__)
+
+
+def cors_middleware(
+    *,
+    allow_all: bool = False,
+    origins: UrlCollection = None,
+    urls: UrlCollection = None,
+    expose_headers: StrCollection = None,
+    allow_headers: StrCollection = DEFAULT_ALLOW_HEADERS,
+    allow_methods: StrCollection = DEFAULT_ALLOW_METHODS,
+    allow_credentials: bool = False,
+    max_age: int = None,
+) -> Middleware:
+    """Middleware to provide CORS headers for aiohttp applications.
+    :param allow_all:
+        When enabled, allow any Origin to access content from your aiohttp web
+        application. **Please be careful with enabling this option as it may
+        result in security issues for your application.** By default: ``False``
+    :param origins:
+        Allow content access for given list of origins. Support supplying
+        strings for exact origin match or regex instances. By default: ``None``
+    :param urls:
+        Allow contect access for given list of URLs in aiohttp application.
+        By default: *apply CORS headers for all URLs*
+    :param expose_headers:
+        List of headers to be exposed with every CORS request. By default:
+        ``None``
+    :param allow_headers:
+        List of allowed headers. By default:
+        .. code-block:: python
+            (
+                "accept",
+                "accept-encoding",
+                "authorization",
+                "content-type",
+                "dnt",
+                "origin",
+                "user-agent",
+                "x-csrftoken",
+                "x-requested-with",
+            )
+    :param allow_methods:
+        List of allowed methods. By default:
+        .. code-block:: python
+            ("DELETE", "GET", "OPTIONS", "PATCH", "POST", "PUT")
+    :param allow_credentials:
+        When enabled apply allow credentials header in response, which results
+        in sharing cookies on shared resources. **Please be careful with
+        allowing credentials for CORS requests.** By default: ``False``
+    :param max_age: Access control max age in seconds. By default: ``None``
+    """
+    check_urls: UrlCollection = DEFAULT_URLS if urls is None else urls
+
+    @web.middleware
+    async def middleware(
+        request: web.Request, handler: Handler
+    ) -> web.StreamResponse:
+        # Initial vars
+        request_method = request.method
+        request_path = request.rel_url.path
+
+        # Is this an OPTIONS request
+        is_options_request = request_method == "OPTIONS"
+
+        # Is this a preflight request
+        is_preflight_request = (
+            is_options_request
+            and ACCESS_CONTROL_REQUEST_METHOD in request.headers
+        )
+
+        # Log extra data
+        log_extra = {
+            "is_preflight_request": is_preflight_request,
+            "method": request_method.lower(),
+            "path": request_path,
+        }
+
+        # Check whether CORS should be enabled for given URL or not. By default
+        # CORS enabled for all URLs
+        if not match_items(check_urls, request_path):
+            logger.debug(
+                "Request should not be processed via CORS middleware",
+                extra=log_extra,
+            )
+            return await handler(request)
+
+        # If this is a preflight request - generate empty response
+        if is_preflight_request:
+            response = web.StreamResponse()
+        # Otherwise - call actual handler
+        else:
+            response = await handler(request)
+
+        # Now check origin heaer
+        origin = request.headers.get("Origin")
+        # Empty origin - do nothing
+        if not origin:
+            logger.debug(
+                "Request does not have Origin header. CORS headers not "
+                "available for given requests",
+                extra=log_extra,
+            )
+            return response
+
+        # Set allow credentials header if necessary
+        if allow_credentials:
+            response.headers[ACCESS_CONTROL_ALLOW_CREDENTIALS] = "true"
+
+        # Check whether current origin satisfies CORS policy
+        if not allow_all and not (origins and match_items(origins, origin)):
+            logger.debug(
+                "CORS headers not allowed for given Origin", extra=log_extra
+            )
+            return response
+
+        # Now start supplying CORS headers
+        # First one is Access-Control-Allow-Origin
+        if allow_all and not allow_credentials:
+            cors_origin = "*"
+        else:
+            cors_origin = origin
+        response.headers[ACCESS_CONTROL_ALLOW_ORIGIN] = cors_origin
+
+        # Then Access-Control-Expose-Headers
+        if expose_headers:
+            response.headers[ACCESS_CONTROL_EXPOSE_HEADERS] = ", ".join(
+                expose_headers
+            )
+
+        # Now, if this is an options request, respond with extra Allow headers
+        if is_options_request:
+            response.headers[ACCESS_CONTROL_ALLOW_HEADERS] = ", ".join(
+                allow_headers
+            )
+            response.headers[ACCESS_CONTROL_ALLOW_METHODS] = ", ".join(
+                allow_methods
+            )
+            if max_age is not None:
+                response.headers[ACCESS_CONTROL_MAX_AGE] = str(max_age)
+
+        # If this is preflight request - do not allow other middlewares to
+        # process this request
+        if is_preflight_request:
+            logger.debug(
+                "Provide CORS headers with empty response for preflight "
+                "request",
+                extra=log_extra,
+            )
+            raise web.HTTPOk(text="", headers=response.headers)
+
+        # Otherwise return normal response
+        logger.debug("Provide CORS headers for request", extra=log_extra)
+        return response
+
+    return middleware
+
+
+
+def match_items(items: UrlCollection, value: str) -> bool:
+    """Go through all items and try to match item with given value."""
+    return any(match_path(item, value) for item in items)
diff --git a/openpype/modules/webserver/server.py b/openpype/modules/webserver/server.py
index 83a29e074e..82b681f406 100644
--- a/openpype/modules/webserver/server.py
+++ b/openpype/modules/webserver/server.py
@@ -1,15 +1,18 @@
+import re
 import threading
 import asyncio
 
 from aiohttp import web
 
 from openpype.lib import PypeLogger
+from .cors_middleware import cors_middleware
 
 log = PypeLogger.get_logger("WebServer")
 
 
 class WebServerManager:
     """Manger that care about web server thread."""
+
     def __init__(self, port=None, host=None):
         self.port = port or 8079
         self.host = host or "localhost"
@@ -18,7 +21,13 @@ class WebServerManager:
         self.handlers = {}
         self.on_stop_callbacks = []
 
-        self.app = web.Application()
+        self.app = web.Application(
+            middlewares=[
+                cors_middleware(
+                    origins=[re.compile(r"^https?\:\/\/localhost")]
+                )
+            ]
+        )
 
         # add route with multiple methods for single "external app"
 

From 4133adf5ed469f9e97a7c288d279f05cbba43ce1 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 28 Jun 2022 14:10:37 +0200
Subject: [PATCH 0878/1227] removed redundant line

---
 openpype/modules/webserver/cors_middleware.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/modules/webserver/cors_middleware.py b/openpype/modules/webserver/cors_middleware.py
index 0c47f9194e..f1cd7b04b3 100644
--- a/openpype/modules/webserver/cors_middleware.py
+++ b/openpype/modules/webserver/cors_middleware.py
@@ -278,7 +278,6 @@ def cors_middleware(
     return middleware
 
 
-
 def match_items(items: UrlCollection, value: str) -> bool:
     """Go through all items and try to match item with given value."""
     return any(match_path(item, value) for item in items)

From b6312221b643f1c30a7e2dee67429564c8686ff1 Mon Sep 17 00:00:00 2001
From: kaa <kaalium@gmail.com>
Date: Tue, 28 Jun 2022 14:36:45 +0200
Subject: [PATCH 0879/1227] Check for python with enabled pymalloc

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/hosts/blender/hooks/pre_pyside_install.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/openpype/hosts/blender/hooks/pre_pyside_install.py b/openpype/hosts/blender/hooks/pre_pyside_install.py
index d0f2b3d417..e5f66d2a26 100644
--- a/openpype/hosts/blender/hooks/pre_pyside_install.py
+++ b/openpype/hosts/blender/hooks/pre_pyside_install.py
@@ -102,6 +102,9 @@ class InstallPySideToBlender(PreLaunchHook):
             python_executable = os.path.join(python_bin, "python.exe")
         else:
             python_executable = os.path.join(python_bin, python_version)
+            # Check for python with enabled 'pymalloc'
+            if not os.path.exists(python_executable):
+                python_executable += "m"
 
         if not os.path.exists(python_executable):
             self.log.warning(

From db6a061733d5f15fbea57ac44850271abb097b41 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Tue, 28 Jun 2022 13:45:54 +0000
Subject: [PATCH 0880/1227] [Automated] Bump version

---
 CHANGELOG.md        | 28 ++++++++++++++++------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 18 insertions(+), 14 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d118bbff54..f4535a516c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,35 +1,45 @@
 # Changelog
 
-## [3.12.0-nightly.2](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.0-nightly.3](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.11.1...HEAD)
 
 ### 📖 Documentation
 
+- Fix typo in documentation: pyenv on mac [\#3417](https://github.com/pypeclub/OpenPype/pull/3417)
 - Linux: update OIIO package [\#3401](https://github.com/pypeclub/OpenPype/pull/3401)
-- General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
-- Multiverse: expose some settings to GUI [\#3350](https://github.com/pypeclub/OpenPype/pull/3350)
 
 **🚀 Enhancements**
 
+- Webserver: Added CORS middleware [\#3422](https://github.com/pypeclub/OpenPype/pull/3422)
+- Attribute Defs UI: Files widget show what is allowed to drop in [\#3411](https://github.com/pypeclub/OpenPype/pull/3411)
+- General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
 - Hosts: More options for in-host callbacks [\#3357](https://github.com/pypeclub/OpenPype/pull/3357)
+- Multiverse: expose some settings to GUI [\#3350](https://github.com/pypeclub/OpenPype/pull/3350)
 - Maya: Allow more data to be published along camera 🎥  [\#3304](https://github.com/pypeclub/OpenPype/pull/3304)
 
 **🐛 Bug fixes**
 
+- NewPublisher: Fix subset name change on change of creator plugin [\#3420](https://github.com/pypeclub/OpenPype/pull/3420)
+- Bug: fix invalid avalon import [\#3418](https://github.com/pypeclub/OpenPype/pull/3418)
 - Nuke: Fix keyword argument in query function [\#3414](https://github.com/pypeclub/OpenPype/pull/3414)
+- Houdini: fix loading and updating vbd/bgeo sequences [\#3408](https://github.com/pypeclub/OpenPype/pull/3408)
 - Nuke: Collect representation files based on Write [\#3407](https://github.com/pypeclub/OpenPype/pull/3407)
 - General: Filter representations before integration start [\#3398](https://github.com/pypeclub/OpenPype/pull/3398)
 - Maya: look collector typo [\#3392](https://github.com/pypeclub/OpenPype/pull/3392)
 - TVPaint: Make sure exit code is set to not None [\#3382](https://github.com/pypeclub/OpenPype/pull/3382)
 - Maya: vray device aspect ratio fix [\#3381](https://github.com/pypeclub/OpenPype/pull/3381)
+- Flame: bunch of publishing issues [\#3377](https://github.com/pypeclub/OpenPype/pull/3377)
 - Harmony: added unc path to zifile command in Harmony [\#3372](https://github.com/pypeclub/OpenPype/pull/3372)
 - Standalone: settings improvements [\#3355](https://github.com/pypeclub/OpenPype/pull/3355)
 - Nuke: Load full model hierarchy by default [\#3328](https://github.com/pypeclub/OpenPype/pull/3328)
 
 **🔀 Refactored code**
 
+- Unreal: Use client query functions [\#3421](https://github.com/pypeclub/OpenPype/pull/3421)
+- General: Move editorial lib to pipeline [\#3419](https://github.com/pypeclub/OpenPype/pull/3419)
 - Kitsu: renaming to plural func sync\_all\_projects [\#3397](https://github.com/pypeclub/OpenPype/pull/3397)
+- Houdini: Use client query functions [\#3395](https://github.com/pypeclub/OpenPype/pull/3395)
 - Hiero: Use client query functions [\#3393](https://github.com/pypeclub/OpenPype/pull/3393)
 - Nuke: Use client query functions [\#3391](https://github.com/pypeclub/OpenPype/pull/3391)
 - Maya: Use client query functions [\#3385](https://github.com/pypeclub/OpenPype/pull/3385)
@@ -43,6 +53,7 @@
 
 **Merged pull requests:**
 
+- Sync Queue: Added far future value for null values for dates [\#3371](https://github.com/pypeclub/OpenPype/pull/3371)
 - Maya - added support for single frame playblast review [\#3369](https://github.com/pypeclub/OpenPype/pull/3369)
 
 ## [3.11.1](https://github.com/pypeclub/OpenPype/tree/3.11.1) (2022-06-20)
@@ -73,7 +84,6 @@
 - nuke: adding extract thumbnail settings 3.10 [\#3347](https://github.com/pypeclub/OpenPype/pull/3347)
 - General: Fix last version function [\#3345](https://github.com/pypeclub/OpenPype/pull/3345)
 - Deadline: added OPENPYPE\_MONGO to filter [\#3336](https://github.com/pypeclub/OpenPype/pull/3336)
-- Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
 
 **🔀 Refactored code**
 
@@ -97,17 +107,15 @@
 - Ftrack: Delivery action can work on ReviewSessions [\#3307](https://github.com/pypeclub/OpenPype/pull/3307)
 - Maya: Look assigner UI improvements [\#3298](https://github.com/pypeclub/OpenPype/pull/3298)
 - Ftrack: Action to transfer values of hierarchical attributes [\#3284](https://github.com/pypeclub/OpenPype/pull/3284)
-- Maya: better handling of legacy review subsets names [\#3269](https://github.com/pypeclub/OpenPype/pull/3269)
-- General: Updated windows oiio tool [\#3268](https://github.com/pypeclub/OpenPype/pull/3268)
-- Unreal: add support for skeletalMesh and staticMesh to loaders [\#3267](https://github.com/pypeclub/OpenPype/pull/3267)
-- Maya: reference loaders could store placeholder in referenced url [\#3264](https://github.com/pypeclub/OpenPype/pull/3264)
 
 **🐛 Bug fixes**
 
 - General: Handle empty source key on instance [\#3342](https://github.com/pypeclub/OpenPype/pull/3342)
+- General: Handle empty source key on instance [\#3341](https://github.com/pypeclub/OpenPype/pull/3341)
 - Houdini: Fix Houdini VDB manage update wrong file attribute name [\#3322](https://github.com/pypeclub/OpenPype/pull/3322)
 - Nuke: anatomy compatibility issue hacks [\#3321](https://github.com/pypeclub/OpenPype/pull/3321)
 - hiero: otio p3 compatibility issue - metadata on effect use update 3.11 [\#3314](https://github.com/pypeclub/OpenPype/pull/3314)
+- Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
 - General: Vendorized modules for Python 2 and update poetry lock [\#3305](https://github.com/pypeclub/OpenPype/pull/3305)
 - Fix - added local targets to install host [\#3303](https://github.com/pypeclub/OpenPype/pull/3303)
 - Settings: Add missing default settings for nuke gizmo [\#3301](https://github.com/pypeclub/OpenPype/pull/3301)
@@ -115,9 +123,6 @@
 - Maya: point cache publish handles Maya instances [\#3297](https://github.com/pypeclub/OpenPype/pull/3297)
 - Global: extract review slate issues [\#3286](https://github.com/pypeclub/OpenPype/pull/3286)
 - Webpublisher: return only active projects in ProjectsEndpoint [\#3281](https://github.com/pypeclub/OpenPype/pull/3281)
-- Hiero: add support for task tags 3.10.x [\#3279](https://github.com/pypeclub/OpenPype/pull/3279)
-- General: Fix Oiio tool path resolving [\#3278](https://github.com/pypeclub/OpenPype/pull/3278)
-- Maya: Fix udim support for e.g. uppercase \<UDIM\> tag [\#3266](https://github.com/pypeclub/OpenPype/pull/3266)
 
 **🔀 Refactored code**
 
@@ -127,7 +132,6 @@
 **Merged pull requests:**
 
 - Maya: add pointcache family to gpu cache loader [\#3318](https://github.com/pypeclub/OpenPype/pull/3318)
-- Maya look: skip empty file attributes [\#3274](https://github.com/pypeclub/OpenPype/pull/3274)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
diff --git a/openpype/version.py b/openpype/version.py
index 02f928d83c..54808bfa81 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.0-nightly.2"
+__version__ = "3.12.0-nightly.3"
diff --git a/pyproject.toml b/pyproject.toml
index 09dfdf45cd..df5630270d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.0-nightly.2" # OpenPype
+version = "3.12.0-nightly.3" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From f92e0f8fa3c2a07aa9b5396be2fba4f50973535e Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Tue, 28 Jun 2022 13:55:09 +0000
Subject: [PATCH 0881/1227] [Automated] Release

---
 CHANGELOG.md        | 9 ++++-----
 openpype/version.py | 2 +-
 pyproject.toml      | 2 +-
 3 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f4535a516c..003ca72a24 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,8 @@
 # Changelog
 
-## [3.12.0-nightly.3](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.0](https://github.com/pypeclub/OpenPype/tree/3.12.0) (2022-06-28)
 
-[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.11.1...HEAD)
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.11.1...3.12.0)
 
 ### 📖 Documentation
 
@@ -29,7 +29,6 @@
 - Maya: look collector typo [\#3392](https://github.com/pypeclub/OpenPype/pull/3392)
 - TVPaint: Make sure exit code is set to not None [\#3382](https://github.com/pypeclub/OpenPype/pull/3382)
 - Maya: vray device aspect ratio fix [\#3381](https://github.com/pypeclub/OpenPype/pull/3381)
-- Flame: bunch of publishing issues [\#3377](https://github.com/pypeclub/OpenPype/pull/3377)
 - Harmony: added unc path to zifile command in Harmony [\#3372](https://github.com/pypeclub/OpenPype/pull/3372)
 - Standalone: settings improvements [\#3355](https://github.com/pypeclub/OpenPype/pull/3355)
 - Nuke: Load full model hierarchy by default [\#3328](https://github.com/pypeclub/OpenPype/pull/3328)
@@ -74,6 +73,7 @@
 
 **🐛 Bug fixes**
 
+- Flame: bunch of publishing issues [\#3377](https://github.com/pypeclub/OpenPype/pull/3377)
 - Nuke: bake streams with slate on farm [\#3368](https://github.com/pypeclub/OpenPype/pull/3368)
 - Harmony: audio validator has wrong logic [\#3364](https://github.com/pypeclub/OpenPype/pull/3364)
 - Nuke: Fix missing variable in extract thumbnail [\#3363](https://github.com/pypeclub/OpenPype/pull/3363)
@@ -84,6 +84,7 @@
 - nuke: adding extract thumbnail settings 3.10 [\#3347](https://github.com/pypeclub/OpenPype/pull/3347)
 - General: Fix last version function [\#3345](https://github.com/pypeclub/OpenPype/pull/3345)
 - Deadline: added OPENPYPE\_MONGO to filter [\#3336](https://github.com/pypeclub/OpenPype/pull/3336)
+- Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
 
 **🔀 Refactored code**
 
@@ -111,11 +112,9 @@
 **🐛 Bug fixes**
 
 - General: Handle empty source key on instance [\#3342](https://github.com/pypeclub/OpenPype/pull/3342)
-- General: Handle empty source key on instance [\#3341](https://github.com/pypeclub/OpenPype/pull/3341)
 - Houdini: Fix Houdini VDB manage update wrong file attribute name [\#3322](https://github.com/pypeclub/OpenPype/pull/3322)
 - Nuke: anatomy compatibility issue hacks [\#3321](https://github.com/pypeclub/OpenPype/pull/3321)
 - hiero: otio p3 compatibility issue - metadata on effect use update 3.11 [\#3314](https://github.com/pypeclub/OpenPype/pull/3314)
-- Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
 - General: Vendorized modules for Python 2 and update poetry lock [\#3305](https://github.com/pypeclub/OpenPype/pull/3305)
 - Fix - added local targets to install host [\#3303](https://github.com/pypeclub/OpenPype/pull/3303)
 - Settings: Add missing default settings for nuke gizmo [\#3301](https://github.com/pypeclub/OpenPype/pull/3301)
diff --git a/openpype/version.py b/openpype/version.py
index 54808bfa81..65e439ef33 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.0-nightly.3"
+__version__ = "3.12.0"
diff --git a/pyproject.toml b/pyproject.toml
index df5630270d..bd5d3ad89d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.0-nightly.3" # OpenPype
+version = "3.12.0" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 05e709ec065e7b7fe422e49225f5c2866028162b Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Tue, 28 Jun 2022 16:41:13 +0200
Subject: [PATCH 0882/1227] create default action in custom menu redirecting to
 openpype hiero doc

---
 openpype/settings/defaults/project_settings/hiero.json | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/hiero.json b/openpype/settings/defaults/project_settings/hiero.json
index cec4bca8fd..3b0127c24a 100644
--- a/openpype/settings/defaults/project_settings/hiero.json
+++ b/openpype/settings/defaults/project_settings/hiero.json
@@ -19,14 +19,10 @@
         "definition": [
             {
                 "type": "action",
-                "command": "import openpype.hosts.hiero.api.commands as hiero; hiero.edit_shader_definitions()",
                 "sourcetype": "python",
-                "title": "Edit shader name definitions",
-                "tooltip": "Edit shader name definitions used in validation and renaming.",
-                "tags": [
-                    "pipeline",
-                    "shader"
-                ]
+                "title": "OpenPype Docs",
+                "command": "import webbrowser;webbrowser.open(url='https://openpype.io/docs/artist_hosts_hiero')",
+                "tooltip": "Open the OpenPype Hiero user doc page"
             }
         ]
     },

From c69482df0a8a4b67952a908c6f4431524c039413 Mon Sep 17 00:00:00 2001
From: Kaa Maurice <kaalium@gmail.com>
Date: Tue, 28 Jun 2022 17:06:13 +0200
Subject: [PATCH 0883/1227] Blender bugfix on open set fps

---
 openpype/hosts/blender/api/pipeline.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/blender/api/pipeline.py b/openpype/hosts/blender/api/pipeline.py
index 93d81145bc..ea405b028e 100644
--- a/openpype/hosts/blender/api/pipeline.py
+++ b/openpype/hosts/blender/api/pipeline.py
@@ -93,7 +93,7 @@ def set_start_end_frames():
     # Default scene settings
     frameStart = scene.frame_start
     frameEnd = scene.frame_end
-    fps = scene.render.fps
+    fps = scene.render.fps / scene.render.fps_base
     resolution_x = scene.render.resolution_x
     resolution_y = scene.render.resolution_y
 
@@ -116,7 +116,8 @@ def set_start_end_frames():
 
     scene.frame_start = frameStart
     scene.frame_end = frameEnd
-    scene.render.fps = fps
+    scene.render.fps = round(fps)
+    scene.render.fps_base = round(fps) / fps
     scene.render.resolution_x = resolution_x
     scene.render.resolution_y = resolution_y
 

From e9edb1cb68bc65c161a5dfa1e4b4eeda322a0b23 Mon Sep 17 00:00:00 2001
From: "Allan I. A" <76656700+Allan-I@users.noreply.github.com>
Date: Tue, 28 Jun 2022 18:20:57 +0300
Subject: [PATCH 0884/1227] Adjust dimensions to grab correct values from
 asset.

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 7f9875f564..8d1c62d64c 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -57,8 +57,9 @@ class ExtractPlayblast(openpype.api.Extractor):
         width_preset = capture_presets["Resolution"]["width"]
         height_preset = capture_presets["Resolution"]["height"]
         # Set resolution variables from asset values
-        asset_width = instance.data.get("resolutionWidth")
-        asset_height = instance.data.get("resolutionHeight")
+        asset_data = instance.data["assetEntity"]["data"]
+        asset_width = asset_data.get("width")
+        asset_height = asset_data.get("height")
         review_instance_width = instance.data.get("instanceWidth")
         review_instance_height = instance.data.get("instanceHeight")
         preset['camera'] = camera

From 397a3f7fc4ebfe02ca033f775208301432e9db38 Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Tue, 28 Jun 2022 17:21:09 +0200
Subject: [PATCH 0885/1227] add docs for hiero custom menu

---
 website/docs/admin_hosts_hiero.md               |   9 +++++++++
 website/docs/assets/hiero-admin_scriptsmenu.png | Bin 0 -> 23368 bytes
 website/sidebars.js                             |   1 +
 3 files changed, 10 insertions(+)
 create mode 100644 website/docs/admin_hosts_hiero.md
 create mode 100644 website/docs/assets/hiero-admin_scriptsmenu.png

diff --git a/website/docs/admin_hosts_hiero.md b/website/docs/admin_hosts_hiero.md
new file mode 100644
index 0000000000..b75d8dee7d
--- /dev/null
+++ b/website/docs/admin_hosts_hiero.md
@@ -0,0 +1,9 @@
+---
+id: admin_hosts_hiero
+title: Hiero
+sidebar_label: Hiero
+---
+
+## Custom Menu
+You can add your custom tools menu into Hiero by extending definitions in **Hiero -> Scripts Menu Definition**.
+![Custom menu definition](assets/hiero-admin_scriptsmenu.png)
diff --git a/website/docs/assets/hiero-admin_scriptsmenu.png b/website/docs/assets/hiero-admin_scriptsmenu.png
new file mode 100644
index 0000000000000000000000000000000000000000..6de136a434e19f78fe871be147a8e5580f3af552
GIT binary patch
literal 23368
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
J3MGrM{{f4=o!<Ze

literal 0
HcmV?d00001

diff --git a/website/sidebars.js b/website/sidebars.js
index ee816dd678..460b16947d 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -89,6 +89,7 @@ module.exports = {
             label: "Integrations",
             items: [
                 "admin_hosts_blender",
+                "admin_hosts_hiero",
                 "admin_hosts_maya",
                 "admin_hosts_nuke",
                 "admin_hosts_resolve",

From eac2793754505b2e418beb73ff1e75bea4be44fa Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Tue, 28 Jun 2022 17:26:54 +0200
Subject: [PATCH 0886/1227] refactor imports

---
 openpype/hosts/hiero/api/launchforhiero.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/hiero/api/launchforhiero.py b/openpype/hosts/hiero/api/launchforhiero.py
index 5c230eb9fe..5f7dbe23c9 100644
--- a/openpype/hosts/hiero/api/launchforhiero.py
+++ b/openpype/hosts/hiero/api/launchforhiero.py
@@ -1,7 +1,7 @@
 import logging
 
-from openpype.vendor.python.common.scriptsmenu import scriptsmenu
-from openpype.vendor.python.common.scriptsmenu.vendor.Qt import QtWidgets
+from scriptsmenu import scriptsmenu
+from Qt import QtWidgets
 
 
 log = logging.getLogger(__name__)

From be2f9a06aa611f1abb94c416416f5c5ad48c0ae6 Mon Sep 17 00:00:00 2001
From: "Allan I. A" <76656700+Allan-I@users.noreply.github.com>
Date: Tue, 28 Jun 2022 18:42:44 +0300
Subject: [PATCH 0887/1227] Simplify testing of cases for resolution

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../maya/plugins/publish/extract_playblast.py      | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 8d1c62d64c..0852053b8b 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -69,18 +69,14 @@ class ExtractPlayblast(openpype.api.Extractor):
         # used, if not then the asset resolution is
         # used
 
-        if review_instance_width != 0:
+        if review_instance_width and review_instance_height:
             preset['width'] = review_instance_width
-        elif width_preset == 0:
-            preset['width'] = asset_width
-        elif width_preset != 0:
-            preset['width'] = width_preset
-
-        if review_instance_height != 0:
             preset['height'] = review_instance_height
-        elif height_preset == 0:
+        elif asset_width and asset_height:
+            preset['width'] = asset_width
             preset['height'] = asset_height
-        elif height_preset != 0:
+        elif width_preset and height_preset:
+            preset['width'] = width_preset
             preset['height'] = height_preset
 
         preset['start_frame'] = start

From c67308d03223656465525647c7254e65d61922f6 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 28 Jun 2022 18:48:59 +0300
Subject: [PATCH 0888/1227] Variable rename.

---
 openpype/hosts/maya/plugins/create/create_review.py   | 4 ++--
 openpype/hosts/maya/plugins/publish/collect_review.py | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_review.py b/openpype/hosts/maya/plugins/create/create_review.py
index 44dc8a3158..bafc62e82c 100644
--- a/openpype/hosts/maya/plugins/create/create_review.py
+++ b/openpype/hosts/maya/plugins/create/create_review.py
@@ -35,8 +35,8 @@ class CreateReview(plugin.Creator):
         for key, value in animation_data.items():
             data[key] = value
 
-        data["instanceHeight"] = self.attrWidth
-        data["instanceWidth"] = self.attrHeight
+        data["Width"] = self.attrWidth
+        data["Height"] = self.attrHeight
         data["isolate"] = self.isolate
         data["keepImages"] = self.keepImages
         data["imagePlane"] = self.imagePlane
diff --git a/openpype/hosts/maya/plugins/publish/collect_review.py b/openpype/hosts/maya/plugins/publish/collect_review.py
index fec1fbfa11..b0b5ef37e8 100644
--- a/openpype/hosts/maya/plugins/publish/collect_review.py
+++ b/openpype/hosts/maya/plugins/publish/collect_review.py
@@ -71,8 +71,8 @@ class CollectReview(pyblish.api.InstancePlugin):
                 data['handles'] = instance.data.get('handles', None)
                 data['step'] = instance.data['step']
                 data['fps'] = instance.data['fps']
-                data['instanceHeight'] = instance.data['instanceHeight']
-                data['instanceHeight'] = instance.data['instanceHeight']
+                data['Width'] = instance.data['Width']
+                data['Height'] = instance.data['Height']
                 data["isolate"] = instance.data["isolate"]
                 cmds.setAttr(str(instance) + '.active', 1)
                 self.log.debug('data {}'.format(instance.context[i].data))

From bc18f8f755a771c27fcc9de452ba514d8039d555 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 28 Jun 2022 19:04:10 +0300
Subject: [PATCH 0889/1227] Simplify logic in thumbnail extractor.

---
 .../maya/plugins/publish/extract_thumbnail.py | 23 ++++++++-----------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
index 119ad10496..bc15327aa7 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -65,26 +65,23 @@ class ExtractThumbnail(openpype.api.Extractor):
         width_preset = capture_presets["Resolution"]["width"]
         height_preset = capture_presets["Resolution"]["height"]
         # Set resolution variables from asset values
-        asset_width = instance.data.get("resolutionWidth")
-        asset_height = instance.data.get("resolutionHeight")
-        review_instance_width = instance.data.get("instanceWidth")
-        review_instance_height = instance.data.get("instanceHeight")
+        asset_data = instance.data["assetEntity"]["data"]
+        asset_width = asset_data.get("width")
+        asset_height = asset_data.get("height")
+        review_instance_width = instance.data.get("Width")
+        review_instance_height = instance.data.get("Height")
         # Tests if project resolution is set,
         # if it is a value other than zero, that value is
         # used, if not then the asset resolution is
         # used
-        if review_instance_width != 0:
+        if review_instance_width and review_instance_height:
             preset['width'] = review_instance_width
-        elif width_preset == 0:
-            preset['width'] = asset_width
-        elif width_preset != 0:
-            preset['width'] = width_preset
-
-        if review_instance_height != 0:
             preset['height'] = review_instance_height
-        elif height_preset == 0:
+        elif asset_width and asset_height:
+            preset['width'] = asset_width
             preset['height'] = asset_height
-        elif height_preset != 0:
+        elif width_preset and height_preset:
+            preset['width'] = width_preset
             preset['height'] = height_preset
         stagingDir = self.staging_dir(instance)
         filename = "{0}".format(instance.name)

From 4514ed8e18abf6dae25310d4f8acb86d3870b5f3 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 28 Jun 2022 19:04:26 +0300
Subject: [PATCH 0890/1227] Change naming in interface.

---
 openpype/hosts/maya/plugins/create/create_review.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_review.py b/openpype/hosts/maya/plugins/create/create_review.py
index bafc62e82c..9f6721762b 100644
--- a/openpype/hosts/maya/plugins/create/create_review.py
+++ b/openpype/hosts/maya/plugins/create/create_review.py
@@ -15,8 +15,8 @@ class CreateReview(plugin.Creator):
     keepImages = False
     isolate = False
     imagePlane = True
-    attrWidth = 0
-    attrHeight = 0
+    Width = 0
+    Height = 0
     transparency = [
         "preset",
         "simple",
@@ -35,8 +35,8 @@ class CreateReview(plugin.Creator):
         for key, value in animation_data.items():
             data[key] = value
 
-        data["Width"] = self.attrWidth
-        data["Height"] = self.attrHeight
+        data["Width"] = self.Width
+        data["Height"] = self.Height
         data["isolate"] = self.isolate
         data["keepImages"] = self.keepImages
         data["imagePlane"] = self.imagePlane

From 92bf597224cba29ff532ff1b63015f1346639e28 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Tue, 28 Jun 2022 19:15:36 +0300
Subject: [PATCH 0891/1227] Fix instance variable name.

---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 0852053b8b..fbf4035505 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -60,8 +60,8 @@ class ExtractPlayblast(openpype.api.Extractor):
         asset_data = instance.data["assetEntity"]["data"]
         asset_width = asset_data.get("width")
         asset_height = asset_data.get("height")
-        review_instance_width = instance.data.get("instanceWidth")
-        review_instance_height = instance.data.get("instanceHeight")
+        review_instance_width = instance.data.get("Width")
+        review_instance_height = instance.data.get("Height")
         preset['camera'] = camera
 
         # Tests if project resolution is set,

From a310f499740b0989762663e25b45bad09d766225 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 28 Jun 2022 18:43:11 +0200
Subject: [PATCH 0892/1227] store write node to instance data

---
 openpype/hosts/nuke/plugins/publish/precollect_writes.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/nuke/plugins/publish/precollect_writes.py b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
index 049958bd07..a97f34b370 100644
--- a/openpype/hosts/nuke/plugins/publish/precollect_writes.py
+++ b/openpype/hosts/nuke/plugins/publish/precollect_writes.py
@@ -35,6 +35,7 @@ class CollectNukeWrites(pyblish.api.InstancePlugin):
         if node is None:
             return
 
+        instance.data["writeNode"] = node
         self.log.debug("checking instance: {}".format(instance))
 
         # Determine defined file type

From 7c48b61206ef38e593c84a4c4291941eb0923f1f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 28 Jun 2022 18:43:30 +0200
Subject: [PATCH 0893/1227] add file to representation files when slate is
 rendered

---
 .../plugins/publish/extract_slate_frame.py    | 44 ++++++++++++++++++-
 1 file changed, 43 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
index e0c4bdb953..6d930d358d 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
@@ -4,6 +4,7 @@ import nuke
 import copy
 
 import pyblish.api
+import six
 
 import openpype
 from openpype.hosts.nuke.api import (
@@ -12,7 +13,6 @@ from openpype.hosts.nuke.api import (
     get_view_process_node
 )
 
-
 class ExtractSlateFrame(openpype.api.Extractor):
     """Extracts movie and thumbnail with baked in luts
 
@@ -236,6 +236,48 @@ class ExtractSlateFrame(openpype.api.Extractor):
             int(slate_first_frame)
         )
 
+        # Add file to representation files
+        # - get write node
+        write_node = instance.data["writeNode"]
+        # - evaluate filepaths for first frame and slate frame
+        first_filename = os.path.basename(
+            write_node["file"].evaluate(first_frame))
+        slate_filename = os.path.basename(
+            write_node["file"].evaluate(slate_first_frame))
+
+        # Find matching representation based on first filename
+        matching_repre = None
+        is_sequence = None
+        for repre in instance.data["representations"]:
+            files = repre["files"]
+            if (
+                not isinstance(files, six.string_types)
+                and first_filename in files
+            ):
+                matching_repre = repre
+                is_sequence = True
+                break
+
+            elif files == first_filename:
+                matching_repre = repre
+                is_sequence = False
+                break
+
+        if not matching_repre:
+            self.log.info((
+                "Matching reresentaion was not found."
+                " Representation files were not filled with slate."
+            ))
+            return
+
+        # Add frame to matching representation files
+        if not is_sequence:
+            matching_repre["files"] = [first_filename, slate_filename]
+        elif slate_filename not in matching_repre["files"]:
+            matching_repre["files"].insert(0, slate_filename)
+
+        self.log.warning("Added slate frame to representation files")
+
     def add_comment_slate_node(self, instance, node):
 
         comment = instance.context.data.get("comment")

From ee273892e871b57607a8f8ad1792d3c5ef5ad95b Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 28 Jun 2022 21:10:11 +0200
Subject: [PATCH 0894/1227] Add alembic visible only validator

---
 openpype/hosts/maya/api/lib.py                |  4 +-
 .../plugins/publish/validate_visible_only.py  | 53 +++++++++++++++++++
 2 files changed, 55 insertions(+), 2 deletions(-)
 create mode 100644 openpype/hosts/maya/plugins/publish/validate_visible_only.py

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index b5bdca456e..ab9c06280f 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -3241,8 +3241,8 @@ def get_visible_in_frame_range(nodes, start, end):
 
     Args:
         nodes (list): List of node names to consider.
-        start (int): Start frame.
-        end (int): End frame.
+        start (int, float): Start frame.
+        end (int, float): End frame.
 
     Returns:
         list: List of node names. These will be long full path names so
diff --git a/openpype/hosts/maya/plugins/publish/validate_visible_only.py b/openpype/hosts/maya/plugins/publish/validate_visible_only.py
new file mode 100644
index 0000000000..9094a421c6
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/validate_visible_only.py
@@ -0,0 +1,53 @@
+import pyblish.api
+
+import openpype.api
+from openpype.hosts.maya.api.lib import get_visible_in_frame_range
+import openpype.hosts.maya.api.action
+
+
+class ValidateAlembicVisibleOnly(pyblish.api.InstancePlugin):
+    """Validates at least a single node is visible in frame range.
+
+    This validation only validates if the `visibleOnly` flag is enabled
+    on the instance - otherwise the validation is skipped.
+
+    """
+    order = openpype.api.ValidateContentsOrder + 0.05
+    label = "Alembic Visible Only"
+    hosts = ["maya"]
+    families = ["pointcache", "animation"]
+    actions = [openpype.hosts.maya.api.action.SelectInvalidAction]
+
+    def process(self, instance):
+
+        if not instance.data.get("visibleOnly", False):
+            self.log.debug("Visible only is disabled. Validation skipped..")
+            return
+
+        invalid = self.get_invalid(instance)
+        if invalid:
+            start, end = self.get_frame_range(instance)
+            raise RuntimeError("No visible nodes found in "
+                               "frame range {}-{}.".format(start, end))
+
+    @classmethod
+    def get_invalid(cls, instance):
+
+        if instance.data["family"] == "animation":
+            # Special behavior to use the nodes in out_SET
+            nodes = instance.data["out_hierarchy"]
+        else:
+            nodes = instance[:]
+
+        start, end = cls.get_frame_range(instance)
+        visible = get_visible_in_frame_range(nodes, start, end)
+
+        if not visible:
+            # Return the nodes we have considered so the user can identify
+            # them with the select invalid action
+            return nodes
+
+    @staticmethod
+    def get_frame_range(instance):
+        data = instance.data
+        return data["frameStartHandle"], data["frameEndHandle"]

From 96150eba27fc64e519b7c1756e6b0f36f886746a Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 28 Jun 2022 21:10:45 +0200
Subject: [PATCH 0895/1227] Remove no visible nodes warning in extractors since
 validator catches those cases

---
 openpype/hosts/maya/plugins/publish/extract_animation.py  | 7 -------
 openpype/hosts/maya/plugins/publish/extract_pointcache.py | 7 -------
 2 files changed, 14 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_animation.py b/openpype/hosts/maya/plugins/publish/extract_animation.py
index 4b650b4b26..b04e2bf0c4 100644
--- a/openpype/hosts/maya/plugins/publish/extract_animation.py
+++ b/openpype/hosts/maya/plugins/publish/extract_animation.py
@@ -86,13 +86,6 @@ class ExtractAnimation(openpype.api.Extractor):
             nodes = get_visible_in_frame_range(nodes,
                                                start=start,
                                                end=end)
-            if not nodes:
-                self.log.warning(
-                    "No visible nodes found in frame range {}-{}. "
-                    "Skipping extraction because `visibleOnly` is enabled on "
-                    "the instance.".format(start, end)
-                )
-                return
 
         with suspended_refresh():
             with maintained_selection():
diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index 768ee6da3d..f582a106d9 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -89,13 +89,6 @@ class ExtractAlembic(openpype.api.Extractor):
             nodes = get_visible_in_frame_range(nodes,
                                                start=start,
                                                end=end)
-            if not nodes:
-                self.log.warning(
-                    "No visible nodes found in frame range {}-{}. "
-                    "Skipping extraction because `visibleOnly` is enabled on "
-                    "the instance.".format(start, end)
-                )
-                return
 
         with suspended_refresh():
             with maintained_selection():

From a29d1d493243915db96d6d09a40471c3177b9558 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 28 Jun 2022 21:25:17 +0200
Subject: [PATCH 0896/1227] Use iterator to speed up visible only validation
 for most cases

---
 openpype/hosts/maya/api/lib.py                    | 15 +++++++--------
 .../maya/plugins/publish/extract_animation.py     |  8 ++++----
 .../maya/plugins/publish/extract_pointcache.py    |  8 ++++----
 .../maya/plugins/publish/validate_visible_only.py |  6 ++----
 4 files changed, 17 insertions(+), 20 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index ab9c06280f..637f9e951b 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -3224,8 +3224,8 @@ def maintained_time():
         cmds.currentTime(ct, edit=True)
 
 
-def get_visible_in_frame_range(nodes, start, end):
-    """Return nodes that are visible in start-end frame range.
+def iter_visible_in_frame_range(nodes, start, end):
+    """Yield nodes that are visible in start-end frame range.
 
     - Ignores intermediateObjects completely.
     - Considers animated visibility attributes + upstream visibilities.
@@ -3261,7 +3261,7 @@ def get_visible_in_frame_range(nodes, start, end):
     # Consider only non-intermediate dag nodes and use the "long" names.
     nodes = cmds.ls(nodes, long=True, noIntermediate=True, type="dagNode")
     if not nodes:
-        return []
+        return
 
     with maintained_time():
         # Go to first frame of the range if the current time is outside
@@ -3275,7 +3275,8 @@ def get_visible_in_frame_range(nodes, start, end):
         if len(visible) == len(nodes) or start == end:
             # All are visible on frame one, so they are at least visible once
             # inside the frame range.
-            return visible
+            for node in visible:
+                yield node
 
     # For the invisible ones check whether its visibility and/or
     # any of its parents visibility attributes are animated. If so, it might
@@ -3358,7 +3359,7 @@ def get_visible_in_frame_range(nodes, start, end):
             node_dependencies[node] = dependencies
 
     if not node_dependencies:
-        return list(visible)
+        return
 
     # Now we only have to check the visibilities for nodes that have animated
     # visibility dependencies upstream. The fastest way to check these
@@ -3409,7 +3410,7 @@ def get_visible_in_frame_range(nodes, start, end):
 
                 else:
                     # All dependencies are visible.
-                    visible.add(node)
+                    yield node
                     # Remove node with dependencies for next frame iterations
                     # because it was visible at least once.
                     node_dependencies.pop(node)
@@ -3417,5 +3418,3 @@ def get_visible_in_frame_range(nodes, start, end):
         # If no more nodes to process break the frame iterations..
         if not node_dependencies:
             break
-
-    return list(visible)
diff --git a/openpype/hosts/maya/plugins/publish/extract_animation.py b/openpype/hosts/maya/plugins/publish/extract_animation.py
index b04e2bf0c4..b0beb5968e 100644
--- a/openpype/hosts/maya/plugins/publish/extract_animation.py
+++ b/openpype/hosts/maya/plugins/publish/extract_animation.py
@@ -7,7 +7,7 @@ from openpype.hosts.maya.api.lib import (
     extract_alembic,
     suspended_refresh,
     maintained_selection,
-    get_visible_in_frame_range
+    iter_visible_in_frame_range
 )
 
 
@@ -83,9 +83,9 @@ class ExtractAnimation(openpype.api.Extractor):
             # flag does not filter out those that are only hidden on some
             # frames as it counts "animated" or "connected" visibilities as
             # if it's always visible.
-            nodes = get_visible_in_frame_range(nodes,
-                                               start=start,
-                                               end=end)
+            nodes = list(iter_visible_in_frame_range(nodes,
+                                                     start=start,
+                                                     end=end))
 
         with suspended_refresh():
             with maintained_selection():
diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index f582a106d9..7aa3aaee2a 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -7,7 +7,7 @@ from openpype.hosts.maya.api.lib import (
     extract_alembic,
     suspended_refresh,
     maintained_selection,
-    get_visible_in_frame_range
+    iter_visible_in_frame_range
 )
 
 
@@ -86,9 +86,9 @@ class ExtractAlembic(openpype.api.Extractor):
             # flag does not filter out those that are only hidden on some
             # frames as it counts "animated" or "connected" visibilities as
             # if it's always visible.
-            nodes = get_visible_in_frame_range(nodes,
-                                               start=start,
-                                               end=end)
+            nodes = list(iter_visible_in_frame_range(nodes,
+                                                     start=start,
+                                                     end=end))
 
         with suspended_refresh():
             with maintained_selection():
diff --git a/openpype/hosts/maya/plugins/publish/validate_visible_only.py b/openpype/hosts/maya/plugins/publish/validate_visible_only.py
index 9094a421c6..2a10171113 100644
--- a/openpype/hosts/maya/plugins/publish/validate_visible_only.py
+++ b/openpype/hosts/maya/plugins/publish/validate_visible_only.py
@@ -1,7 +1,7 @@
 import pyblish.api
 
 import openpype.api
-from openpype.hosts.maya.api.lib import get_visible_in_frame_range
+from openpype.hosts.maya.api.lib import iter_visible_in_frame_range
 import openpype.hosts.maya.api.action
 
 
@@ -40,9 +40,7 @@ class ValidateAlembicVisibleOnly(pyblish.api.InstancePlugin):
             nodes = instance[:]
 
         start, end = cls.get_frame_range(instance)
-        visible = get_visible_in_frame_range(nodes, start, end)
-
-        if not visible:
+        if not any(iter_visible_in_frame_range(nodes, start, end)):
             # Return the nodes we have considered so the user can identify
             # them with the select invalid action
             return nodes

From a99cc8f4971c52b55104eade2cac6c679db76d0f Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 28 Jun 2022 21:30:22 +0200
Subject: [PATCH 0897/1227] Fix iterator

---
 openpype/hosts/maya/api/lib.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 637f9e951b..43f738bfc7 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -3272,11 +3272,12 @@ def iter_visible_in_frame_range(nodes, start, end):
             cmds.currentTime(start)
 
         visible = cmds.ls(nodes, long=True, visible=True)
+        for node in visible:
+            yield node
         if len(visible) == len(nodes) or start == end:
             # All are visible on frame one, so they are at least visible once
             # inside the frame range.
-            for node in visible:
-                yield node
+            return
 
     # For the invisible ones check whether its visibility and/or
     # any of its parents visibility attributes are animated. If so, it might

From 778f485a1813b267ee47c5147b45e66011507d1f Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Wed, 29 Jun 2022 04:03:54 +0000
Subject: [PATCH 0898/1227] [Automated] Bump version

---
 CHANGELOG.md        | 18 +++++++++++-------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 003ca72a24..438a563391 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,16 @@
 # Changelog
 
+## [3.12.1-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.0...HEAD)
+
+**🚀 Enhancements**
+
+- Blender: pre pyside install for all platforms [\#3400](https://github.com/pypeclub/OpenPype/pull/3400)
+
 ## [3.12.0](https://github.com/pypeclub/OpenPype/tree/3.12.0) (2022-06-28)
 
-[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.11.1...3.12.0)
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.12.0-nightly.3...3.12.0)
 
 ### 📖 Documentation
 
@@ -29,6 +37,7 @@
 - Maya: look collector typo [\#3392](https://github.com/pypeclub/OpenPype/pull/3392)
 - TVPaint: Make sure exit code is set to not None [\#3382](https://github.com/pypeclub/OpenPype/pull/3382)
 - Maya: vray device aspect ratio fix [\#3381](https://github.com/pypeclub/OpenPype/pull/3381)
+- Flame: bunch of publishing issues [\#3377](https://github.com/pypeclub/OpenPype/pull/3377)
 - Harmony: added unc path to zifile command in Harmony [\#3372](https://github.com/pypeclub/OpenPype/pull/3372)
 - Standalone: settings improvements [\#3355](https://github.com/pypeclub/OpenPype/pull/3355)
 - Nuke: Load full model hierarchy by default [\#3328](https://github.com/pypeclub/OpenPype/pull/3328)
@@ -48,6 +57,7 @@
 - AfterEffects: Use client query functions [\#3374](https://github.com/pypeclub/OpenPype/pull/3374)
 - TVPaint: Use client query functions [\#3340](https://github.com/pypeclub/OpenPype/pull/3340)
 - Ftrack: Use client query functions [\#3339](https://github.com/pypeclub/OpenPype/pull/3339)
+- Webpublisher: Use client query functions [\#3333](https://github.com/pypeclub/OpenPype/pull/3333)
 - Standalone Publisher: Use client query functions [\#3330](https://github.com/pypeclub/OpenPype/pull/3330)
 
 **Merged pull requests:**
@@ -73,7 +83,6 @@
 
 **🐛 Bug fixes**
 
-- Flame: bunch of publishing issues [\#3377](https://github.com/pypeclub/OpenPype/pull/3377)
 - Nuke: bake streams with slate on farm [\#3368](https://github.com/pypeclub/OpenPype/pull/3368)
 - Harmony: audio validator has wrong logic [\#3364](https://github.com/pypeclub/OpenPype/pull/3364)
 - Nuke: Fix missing variable in extract thumbnail [\#3363](https://github.com/pypeclub/OpenPype/pull/3363)
@@ -86,10 +95,6 @@
 - Deadline: added OPENPYPE\_MONGO to filter [\#3336](https://github.com/pypeclub/OpenPype/pull/3336)
 - Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
 
-**🔀 Refactored code**
-
-- Webpublisher: Use client query functions [\#3333](https://github.com/pypeclub/OpenPype/pull/3333)
-
 ## [3.11.0](https://github.com/pypeclub/OpenPype/tree/3.11.0) (2022-06-17)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.11.0-nightly.4...3.11.0)
@@ -121,7 +126,6 @@
 - Maya: Fix swaped width and height in reviews [\#3300](https://github.com/pypeclub/OpenPype/pull/3300)
 - Maya: point cache publish handles Maya instances [\#3297](https://github.com/pypeclub/OpenPype/pull/3297)
 - Global: extract review slate issues [\#3286](https://github.com/pypeclub/OpenPype/pull/3286)
-- Webpublisher: return only active projects in ProjectsEndpoint [\#3281](https://github.com/pypeclub/OpenPype/pull/3281)
 
 **🔀 Refactored code**
 
diff --git a/openpype/version.py b/openpype/version.py
index 65e439ef33..633b0b4f33 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.0"
+__version__ = "3.12.1-nightly.1"
diff --git a/pyproject.toml b/pyproject.toml
index bd5d3ad89d..26a7b4bf1e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.0" # OpenPype
+version = "3.12.1-nightly.1" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 0e8892e2819237cc557e7195e87acef3ffefea5c Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 29 Jun 2022 11:33:24 +0200
Subject: [PATCH 0899/1227] Re-use `maintained_time` from lib

---
 .../hosts/maya/plugins/publish/extract_playblast.py | 13 +------------
 .../hosts/maya/plugins/publish/extract_thumbnail.py | 12 +-----------
 2 files changed, 2 insertions(+), 23 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index ba939d5428..246b2cc0f1 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -1,6 +1,4 @@
 import os
-import glob
-import contextlib
 import clique
 import capture
 
@@ -90,7 +88,7 @@ class ExtractPlayblast(openpype.api.Extractor):
         else:
             preset["viewport_options"] = {"imagePlane": image_plane}
 
-        with maintained_time():
+        with lib.maintained_time():
             filename = preset.get("filename", "%TEMP%")
 
             # Force viewer to False in call to capture because we have our own
@@ -153,12 +151,3 @@ class ExtractPlayblast(openpype.api.Extractor):
             'camera_name': camera_node_name
         }
         instance.data["representations"].append(representation)
-
-
-@contextlib.contextmanager
-def maintained_time():
-    ct = cmds.currentTime(query=True)
-    try:
-        yield
-    finally:
-        cmds.currentTime(ct, edit=True)
diff --git a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
index c2cefc56f1..915c52109d 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -1,5 +1,4 @@
 import os
-import contextlib
 import glob
 
 import capture
@@ -81,7 +80,7 @@ class ExtractThumbnail(openpype.api.Extractor):
         if preset.pop("isolate_view", False) and instance.data.get("isolate"):
             preset["isolate"] = instance.data["setMembers"]
 
-        with maintained_time():
+        with lib.maintained_time():
             filename = preset.get("filename", "%TEMP%")
 
             # Force viewer to False in call to capture because we have our own
@@ -152,12 +151,3 @@ class ExtractThumbnail(openpype.api.Extractor):
             filepath = max(files, key=os.path.getmtime)
 
         return filepath
-
-
-@contextlib.contextmanager
-def maintained_time():
-    ct = cmds.currentTime(query=True)
-    try:
-        yield
-    finally:
-        cmds.currentTime(ct, edit=True)

From eebfb02b916e94d955d0715a4beb5a3cf642f4d2 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 29 Jun 2022 11:33:41 +0200
Subject: [PATCH 0900/1227] Remove unused variable `filename`

---
 openpype/hosts/maya/plugins/publish/extract_thumbnail.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
index 915c52109d..37661c3c77 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -81,8 +81,6 @@ class ExtractThumbnail(openpype.api.Extractor):
             preset["isolate"] = instance.data["setMembers"]
 
         with lib.maintained_time():
-            filename = preset.get("filename", "%TEMP%")
-
             # Force viewer to False in call to capture because we have our own
             # viewer opening call to allow a signal to trigger between
             # playblast and viewer

From 275f5f8bf939734614fecd12b14f79b94d8a071c Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 29 Jun 2022 11:34:11 +0200
Subject: [PATCH 0901/1227] Remove redundant initialization of `capture_preset`

---
 openpype/hosts/maya/plugins/publish/extract_thumbnail.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
index 37661c3c77..20a226796a 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -27,7 +27,6 @@ class ExtractThumbnail(openpype.api.Extractor):
 
         camera = instance.data['review_camera']
 
-        capture_preset = ""
         capture_preset = (
             instance.context.data["project_settings"]['maya']['publish']['ExtractPlayblast']['capture_preset']
         )

From 6779d0a88afc917c9da5f865ba32fc4c68907e1d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 29 Jun 2022 13:17:33 +0200
Subject: [PATCH 0902/1227] Draft implementation for VDB to Arnold loader

---
 .../maya/plugins/load/load_vdb_to_arnold.py   | 137 ++++++++++++++++++
 1 file changed, 137 insertions(+)
 create mode 100644 openpype/hosts/maya/plugins/load/load_vdb_to_arnold.py

diff --git a/openpype/hosts/maya/plugins/load/load_vdb_to_arnold.py b/openpype/hosts/maya/plugins/load/load_vdb_to_arnold.py
new file mode 100644
index 0000000000..89166c2dc8
--- /dev/null
+++ b/openpype/hosts/maya/plugins/load/load_vdb_to_arnold.py
@@ -0,0 +1,137 @@
+import os
+
+from openpype.api import get_project_settings
+from openpype.pipeline import load
+
+# TODO aiVolume doesn't automatically set velocity fps correctly, set manual?
+
+
+class LoadVDBtoArnold(load.LoaderPlugin):
+    """Load OpenVDB for Arnold in aiVolume"""
+
+    families = ["vdbcache"]
+    representations = ["vdb"]
+
+    label = "Load VDB to Arnold"
+    icon = "cloud"
+    color = "orange"
+
+    def load(self, context, name, namespace, data):
+
+        from maya import cmds
+        from openpype.hosts.maya.api.pipeline import containerise
+        from openpype.hosts.maya.api.lib import unique_namespace
+
+        try:
+            family = context["representation"]["context"]["family"]
+        except ValueError:
+            family = "vdbcache"
+
+        # Check if the plugin for arnold is available on the pc
+        try:
+            cmds.loadPlugin("mtoa", quiet=True)
+        except Exception as exc:
+            self.log.error("Encountered exception:\n%s" % exc)
+            return
+
+        asset = context['asset']
+        asset_name = asset["name"]
+        namespace = namespace or unique_namespace(
+            asset_name + "_",
+            prefix="_" if asset_name[0].isdigit() else "",
+            suffix="_",
+        )
+
+        # Root group
+        label = "{}:{}".format(namespace, name)
+        root = cmds.group(name=label, empty=True)
+
+        settings = get_project_settings(os.environ['AVALON_PROJECT'])
+        colors = settings['maya']['load']['colors']
+
+        c = colors.get(family)
+        if c is not None:
+            cmds.setAttr(root + ".useOutlinerColor", 1)
+            cmds.setAttr(root + ".outlinerColor",
+                         (float(c[0]) / 255),
+                         (float(c[1]) / 255),
+                         (float(c[2]) / 255)
+                         )
+
+        # Create VRayVolumeGrid
+        grid_node = cmds.createNode("aiVolume",
+                                    name="{}Shape".format(root),
+                                    parent=root)
+
+        self._set_path(grid_node,
+                       path=self.fname,
+                       representation=context["representation"])
+
+        # Lock the shape node so the user can't delete the transform/shape
+        # as if it was referenced
+        cmds.lockNode(grid_node, lock=True)
+
+        nodes = [root, grid_node]
+        self[:] = nodes
+
+        return containerise(
+            name=name,
+            namespace=namespace,
+            nodes=nodes,
+            context=context,
+            loader=self.__class__.__name__)
+
+    def update(self, container, representation):
+
+        from maya import cmds
+
+        path = api.get_representation_path(representation)
+
+        # Find VRayVolumeGrid
+        members = cmds.sets(container['objectName'], query=True)
+        grid_nodes = cmds.ls(members, type="aiVolume", long=True)
+        assert len(grid_nodes) == 1, "This is a bug"
+
+        # Update the VRayVolumeGrid
+        self._set_path(grid_nodes[0], path=path, representation=representation)
+
+        # Update container representation
+        cmds.setAttr(container["objectName"] + ".representation",
+                     str(representation["_id"]),
+                     type="string")
+
+    def switch(self, container, representation):
+        self.update(container, representation)
+
+    def remove(self, container):
+
+        from maya import cmds
+
+        # Get all members of the avalon container, ensure they are unlocked
+        # and delete everything
+        members = cmds.sets(container['objectName'], query=True)
+        cmds.lockNode(members, lock=False)
+        cmds.delete([container['objectName']] + members)
+
+        # Clean up the namespace
+        try:
+            cmds.namespace(removeNamespace=container['namespace'],
+                           deleteNamespaceContent=True)
+        except RuntimeError:
+            pass
+
+    @staticmethod
+    def _set_path(grid_node,
+                  path,
+                  representation):
+        """Apply the settings for the VDB path to the aiVolume node"""
+        from maya import cmds
+
+        if not os.path.exists(path):
+            raise RuntimeError("Path does not exist: %s" % path)
+
+        is_sequence = bool(representation["context"].get("frame"))
+        cmds.setAttr(grid_node + ".useFrameExtension", is_sequence)
+
+        # Set file path
+        cmds.setAttr(grid_node + ".filename", path, type="string")

From 251a54581c7c910bac425b24af06052dae46ea25 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 29 Jun 2022 13:23:11 +0200
Subject: [PATCH 0903/1227] Fix missing import

---
 openpype/hosts/maya/plugins/load/load_vdb_to_arnold.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/load/load_vdb_to_arnold.py b/openpype/hosts/maya/plugins/load/load_vdb_to_arnold.py
index 89166c2dc8..d458c5abda 100644
--- a/openpype/hosts/maya/plugins/load/load_vdb_to_arnold.py
+++ b/openpype/hosts/maya/plugins/load/load_vdb_to_arnold.py
@@ -1,8 +1,10 @@
 import os
 
 from openpype.api import get_project_settings
-from openpype.pipeline import load
-
+from openpype.pipeline import (
+    load,
+    get_representation_path
+)
 # TODO aiVolume doesn't automatically set velocity fps correctly, set manual?
 
 
@@ -85,7 +87,7 @@ class LoadVDBtoArnold(load.LoaderPlugin):
 
         from maya import cmds
 
-        path = api.get_representation_path(representation)
+        path = get_representation_path(representation)
 
         # Find VRayVolumeGrid
         members = cmds.sets(container['objectName'], query=True)

From 866bbf0487b5339b7f0f4bafef548b04aca39f67 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 14:04:30 +0200
Subject: [PATCH 0904/1227] anatomy was moved to openpype pipeline

---
 openpype/lib/anatomy.py      | 1263 +---------------------------------
 openpype/pipeline/anatomy.py | 1260 +++++++++++++++++++++++++++++++++
 2 files changed, 1263 insertions(+), 1260 deletions(-)
 create mode 100644 openpype/pipeline/anatomy.py

diff --git a/openpype/lib/anatomy.py b/openpype/lib/anatomy.py
index 3fbc05ee88..b62b207ade 100644
--- a/openpype/lib/anatomy.py
+++ b/openpype/lib/anatomy.py
@@ -1,1260 +1,3 @@
-import os
-import re
-import copy
-import platform
-import collections
-import numbers
-
-from openpype.settings.lib import (
-    get_default_anatomy_settings,
-    get_anatomy_settings
-)
-from .path_templates import (
-    TemplateUnsolved,
-    TemplateResult,
-    TemplatesDict,
-    FormatObject,
-)
-from .log import PypeLogger
-
-log = PypeLogger().get_logger(__name__)
-
-try:
-    StringType = basestring
-except NameError:
-    StringType = str
-
-
-class ProjectNotSet(Exception):
-    """Exception raised when is created Anatomy without project name."""
-
-
-class RootCombinationError(Exception):
-    """This exception is raised when templates has combined root types."""
-
-    def __init__(self, roots):
-        joined_roots = ", ".join(
-            ["\"{}\"".format(_root) for _root in roots]
-        )
-        # TODO better error message
-        msg = (
-            "Combination of root with and"
-            " without root name in AnatomyTemplates. {}"
-        ).format(joined_roots)
-
-        super(RootCombinationError, self).__init__(msg)
-
-
-class Anatomy:
-    """Anatomy module helps to keep project settings.
-
-    Wraps key project specifications, AnatomyTemplates and Roots.
-
-    Args:
-        project_name (str): Project name to look on overrides.
-    """
-
-    root_key_regex = re.compile(r"{(root?[^}]+)}")
-    root_name_regex = re.compile(r"root\[([^]]+)\]")
-
-    def __init__(self, project_name=None, site_name=None):
-        if not project_name:
-            project_name = os.environ.get("AVALON_PROJECT")
-
-        if not project_name:
-            raise ProjectNotSet((
-                "Implementation bug: Project name is not set. Anatomy requires"
-                " to load data for specific project."
-            ))
-
-        self.project_name = project_name
-
-        self._data = self._prepare_anatomy_data(
-            get_anatomy_settings(project_name, site_name)
-        )
-        self._site_name = site_name
-        self._templates_obj = AnatomyTemplates(self)
-        self._roots_obj = Roots(self)
-
-    # Anatomy used as dictionary
-    # - implemented only getters returning copy
-    def __getitem__(self, key):
-        return copy.deepcopy(self._data[key])
-
-    def get(self, key, default=None):
-        return copy.deepcopy(self._data).get(key, default)
-
-    def keys(self):
-        return copy.deepcopy(self._data).keys()
-
-    def values(self):
-        return copy.deepcopy(self._data).values()
-
-    def items(self):
-        return copy.deepcopy(self._data).items()
-
-    @staticmethod
-    def default_data():
-        """Default project anatomy data.
-
-        Always return fresh loaded data. May be used as data for new project.
-
-        Not used inside Anatomy itself.
-        """
-        return get_default_anatomy_settings(clear_metadata=False)
-
-    @staticmethod
-    def _prepare_anatomy_data(anatomy_data):
-        """Prepare anatomy data for further processing.
-
-        Method added to replace `{task}` with `{task[name]}` in templates.
-        """
-        templates_data = anatomy_data.get("templates")
-        if templates_data:
-            # Replace `{task}` with `{task[name]}` in templates
-            value_queue = collections.deque()
-            value_queue.append(templates_data)
-            while value_queue:
-                item = value_queue.popleft()
-                if not isinstance(item, dict):
-                    continue
-
-                for key in tuple(item.keys()):
-                    value = item[key]
-                    if isinstance(value, dict):
-                        value_queue.append(value)
-
-                    elif isinstance(value, StringType):
-                        item[key] = value.replace("{task}", "{task[name]}")
-        return anatomy_data
-
-    def reset(self):
-        """Reset values of cached data in templates and roots objects."""
-        self._data = self._prepare_anatomy_data(
-            get_anatomy_settings(self.project_name, self._site_name)
-        )
-        self.templates_obj.reset()
-        self.roots_obj.reset()
-
-    @property
-    def templates(self):
-        """Wrap property `templates` of Anatomy's AnatomyTemplates instance."""
-        return self._templates_obj.templates
-
-    @property
-    def templates_obj(self):
-        """Return `AnatomyTemplates` object of current Anatomy instance."""
-        return self._templates_obj
-
-    def format(self, *args, **kwargs):
-        """Wrap `format` method of Anatomy's `templates_obj`."""
-        return self._templates_obj.format(*args, **kwargs)
-
-    def format_all(self, *args, **kwargs):
-        """Wrap `format_all` method of Anatomy's `templates_obj`."""
-        return self._templates_obj.format_all(*args, **kwargs)
-
-    @property
-    def roots(self):
-        """Wrap `roots` property of Anatomy's `roots_obj`."""
-        return self._roots_obj.roots
-
-    @property
-    def roots_obj(self):
-        """Return `Roots` object of current Anatomy instance."""
-        return self._roots_obj
-
-    def root_environments(self):
-        """Return OPENPYPE_ROOT_* environments for current project in dict."""
-        return self._roots_obj.root_environments()
-
-    def root_environmets_fill_data(self, template=None):
-        """Environment variable values in dictionary for rootless path.
-
-        Args:
-            template (str): Template for environment variable key fill.
-                By default is set to `"${}"`.
-        """
-        return self.roots_obj.root_environmets_fill_data(template)
-
-    def find_root_template_from_path(self, *args, **kwargs):
-        """Wrapper for Roots `find_root_template_from_path`."""
-        return self.roots_obj.find_root_template_from_path(*args, **kwargs)
-
-    def path_remapper(self, *args, **kwargs):
-        """Wrapper for Roots `path_remapper`."""
-        return self.roots_obj.path_remapper(*args, **kwargs)
-
-    def all_root_paths(self):
-        """Wrapper for Roots `all_root_paths`."""
-        return self.roots_obj.all_root_paths()
-
-    def set_root_environments(self):
-        """Set OPENPYPE_ROOT_* environments for current project."""
-        self._roots_obj.set_root_environments()
-
-    def root_names(self):
-        """Return root names for current project."""
-        return self.root_names_from_templates(self.templates)
-
-    def _root_keys_from_templates(self, data):
-        """Extract root key from templates in data.
-
-        Args:
-            data (dict): Data that may contain templates as string.
-
-        Return:
-            set: Set of all root names from templates as strings.
-
-        Output example: `{"root[work]", "root[publish]"}`
-        """
-
-        output = set()
-        if isinstance(data, dict):
-            for value in data.values():
-                for root in self._root_keys_from_templates(value):
-                    output.add(root)
-
-        elif isinstance(data, str):
-            for group in re.findall(self.root_key_regex, data):
-                output.add(group)
-
-        return output
-
-    def root_value_for_template(self, template):
-        """Returns value of root key from template."""
-        root_templates = []
-        for group in re.findall(self.root_key_regex, template):
-            root_templates.append("{" + group + "}")
-
-        if not root_templates:
-            return None
-
-        return root_templates[0].format(**{"root": self.roots})
-
-    def root_names_from_templates(self, templates):
-        """Extract root names form anatomy templates.
-
-        Returns None if values in templates contain only "{root}".
-        Empty list is returned if there is no "root" in templates.
-        Else returns all root names from templates in list.
-
-        RootCombinationError is raised when templates contain both root types,
-        basic "{root}" and with root name specification "{root[work]}".
-
-        Args:
-            templates (dict): Anatomy templates where roots are not filled.
-
-        Return:
-            list/None: List of all root names from templates as strings when
-            multiroot setup is used, otherwise None is returned.
-        """
-        roots = list(self._root_keys_from_templates(templates))
-        # Return empty list if no roots found in templates
-        if not roots:
-            return roots
-
-        # Raise exception when root keys have roots with and without root name.
-        # Invalid output example: ["root", "root[project]", "root[render]"]
-        if len(roots) > 1 and "root" in roots:
-            raise RootCombinationError(roots)
-
-        # Return None if "root" without root name in templates
-        if len(roots) == 1 and roots[0] == "root":
-            return None
-
-        names = set()
-        for root in roots:
-            for group in re.findall(self.root_name_regex, root):
-                names.add(group)
-        return list(names)
-
-    def fill_root(self, template_path):
-        """Fill template path where is only "root" key unfilled.
-
-        Args:
-            template_path (str): Path with "root" key in.
-                Example path: "{root}/projects/MyProject/Shot01/Lighting/..."
-
-        Return:
-            str: formatted path
-        """
-        # NOTE does not care if there are different keys than "root"
-        return template_path.format(**{"root": self.roots})
-
-    @classmethod
-    def fill_root_with_path(cls, rootless_path, root_path):
-        """Fill path without filled "root" key with passed path.
-
-        This is helper to fill root with different directory path than anatomy
-        has defined no matter if is single or multiroot.
-
-        Output path is same as input path if `rootless_path` does not contain
-        unfilled root key.
-
-        Args:
-            rootless_path (str): Path without filled "root" key. Example:
-                "{root[work]}/MyProject/..."
-            root_path (str): What should replace root key in `rootless_path`.
-
-        Returns:
-            str: Path with filled root.
-        """
-        output = str(rootless_path)
-        for group in re.findall(cls.root_key_regex, rootless_path):
-            replacement = "{" + group + "}"
-            output = output.replace(replacement, root_path)
-
-        return output
-
-    def replace_root_with_env_key(self, filepath, template=None):
-        """Replace root of path with environment key.
-
-        # Example:
-        ## Project with roots:
-        ```
-        {
-            "nas": {
-                "windows": P:/projects",
-                ...
-            }
-            ...
-        }
-        ```
-
-        ## Entered filepath
-        "P:/projects/project/asset/task/animation_v001.ma"
-
-        ## Entered template
-        "<{}>"
-
-        ## Output
-        "<OPENPYPE_PROJECT_ROOT_NAS>/project/asset/task/animation_v001.ma"
-
-        Args:
-            filepath (str): Full file path where root should be replaced.
-            template (str): Optional template for environment key. Must
-                have one index format key.
-                Default value if not entered: "${}"
-
-        Returns:
-            str: Path where root is replaced with environment root key.
-
-        Raise:
-            ValueError: When project's roots were not found in entered path.
-        """
-        success, rootless_path = self.find_root_template_from_path(filepath)
-        if not success:
-            raise ValueError(
-                "{}: Project's roots were not found in path: {}".format(
-                    self.project_name, filepath
-                )
-            )
-
-        data = self.root_environmets_fill_data(template)
-        return rootless_path.format(**data)
-
-
-class AnatomyTemplateUnsolved(TemplateUnsolved):
-    """Exception for unsolved template when strict is set to True."""
-
-    msg = "Anatomy template \"{0}\" is unsolved.{1}{2}"
-
-
-class AnatomyTemplateResult(TemplateResult):
-    rootless = None
-
-    def __new__(cls, result, rootless_path):
-        new_obj = super(AnatomyTemplateResult, cls).__new__(
-            cls,
-            str(result),
-            result.template,
-            result.solved,
-            result.used_values,
-            result.missing_keys,
-            result.invalid_types
-        )
-        new_obj.rootless = rootless_path
-        return new_obj
-
-    def validate(self):
-        if not self.solved:
-            raise AnatomyTemplateUnsolved(
-                self.template,
-                self.missing_keys,
-                self.invalid_types
-            )
-
-
-class AnatomyTemplates(TemplatesDict):
-    inner_key_pattern = re.compile(r"(\{@.*?[^{}0]*\})")
-    inner_key_name_pattern = re.compile(r"\{@(.*?[^{}0]*)\}")
-
-    def __init__(self, anatomy):
-        super(AnatomyTemplates, self).__init__()
-        self.anatomy = anatomy
-        self.loaded_project = None
-
-    def __getitem__(self, key):
-        return self.templates[key]
-
-    def get(self, key, default=None):
-        return self.templates.get(key, default)
-
-    def reset(self):
-        self._raw_templates = None
-        self._templates = None
-        self._objected_templates = None
-
-    @property
-    def project_name(self):
-        return self.anatomy.project_name
-
-    @property
-    def roots(self):
-        return self.anatomy.roots
-
-    @property
-    def templates(self):
-        self._validate_discovery()
-        return self._templates
-
-    @property
-    def objected_templates(self):
-        self._validate_discovery()
-        return self._objected_templates
-
-    def _validate_discovery(self):
-        if self.project_name != self.loaded_project:
-            self.reset()
-
-        if self._templates is None:
-            self._discover()
-            self.loaded_project = self.project_name
-
-    def _format_value(self, value, data):
-        if isinstance(value, RootItem):
-            return self._solve_dict(value, data)
-
-        result = super(AnatomyTemplates, self)._format_value(value, data)
-        if isinstance(result, TemplateResult):
-            rootless_path = self._rootless_path(result, data)
-            result = AnatomyTemplateResult(result, rootless_path)
-        return result
-
-    def set_templates(self, templates):
-        if not templates:
-            self.reset()
-            return
-
-        self._raw_templates = copy.deepcopy(templates)
-        templates = copy.deepcopy(templates)
-        v_queue = collections.deque()
-        v_queue.append(templates)
-        while v_queue:
-            item = v_queue.popleft()
-            if not isinstance(item, dict):
-                continue
-
-            for key in tuple(item.keys()):
-                value = item[key]
-                if isinstance(value, dict):
-                    v_queue.append(value)
-
-                elif (
-                    isinstance(value, StringType)
-                    and "{task}" in value
-                ):
-                    item[key] = value.replace("{task}", "{task[name]}")
-
-        solved_templates = self.solve_template_inner_links(templates)
-        self._templates = solved_templates
-        self._objected_templates = self.create_ojected_templates(
-            solved_templates
-        )
-
-    def default_templates(self):
-        """Return default templates data with solved inner keys."""
-        return self.solve_template_inner_links(
-            self.anatomy["templates"]
-        )
-
-    def _discover(self):
-        """ Loads anatomy templates from yaml.
-        Default templates are loaded if project is not set or project does
-        not have set it's own.
-        TODO: create templates if not exist.
-
-        Returns:
-            TemplatesResultDict: Contain templates data for current project of
-                default templates.
-        """
-
-        if self.project_name is None:
-            # QUESTION create project specific if not found?
-            raise AssertionError((
-                "Project \"{0}\" does not have his own templates."
-                " Trying to use default."
-            ).format(self.project_name))
-
-        self.set_templates(self.anatomy["templates"])
-
-    @classmethod
-    def replace_inner_keys(cls, matches, value, key_values, key):
-        """Replacement of inner keys in template values."""
-        for match in matches:
-            anatomy_sub_keys = (
-                cls.inner_key_name_pattern.findall(match)
-            )
-            if key in anatomy_sub_keys:
-                raise ValueError((
-                    "Unsolvable recursion in inner keys, "
-                    "key: \"{}\" is in his own value."
-                    " Can't determine source, please check Anatomy templates."
-                ).format(key))
-
-            for anatomy_sub_key in anatomy_sub_keys:
-                replace_value = key_values.get(anatomy_sub_key)
-                if replace_value is None:
-                    raise KeyError((
-                        "Anatomy templates can't be filled."
-                        " Anatomy key `{0}` has"
-                        " invalid inner key `{1}`."
-                    ).format(key, anatomy_sub_key))
-
-                valid = isinstance(replace_value, (numbers.Number, StringType))
-                if not valid:
-                    raise ValueError((
-                        "Anatomy templates can't be filled."
-                        " Anatomy key `{0}` has"
-                        " invalid inner key `{1}`"
-                        " with value `{2}`."
-                    ).format(key, anatomy_sub_key, str(replace_value)))
-
-                value = value.replace(match, str(replace_value))
-
-        return value
-
-    @classmethod
-    def prepare_inner_keys(cls, key_values):
-        """Check values of inner keys.
-
-        Check if inner key exist in template group and has valid value.
-        It is also required to avoid infinite loop with unsolvable recursion
-        when first inner key's value refers to second inner key's value where
-        first is used.
-        """
-        keys_to_solve = set(key_values.keys())
-        while True:
-            found = False
-            for key in tuple(keys_to_solve):
-                value = key_values[key]
-
-                if isinstance(value, StringType):
-                    matches = cls.inner_key_pattern.findall(value)
-                    if not matches:
-                        keys_to_solve.remove(key)
-                        continue
-
-                    found = True
-                    key_values[key] = cls.replace_inner_keys(
-                        matches, value, key_values, key
-                    )
-                    continue
-
-                elif not isinstance(value, dict):
-                    keys_to_solve.remove(key)
-                    continue
-
-                subdict_found = False
-                for _key, _value in tuple(value.items()):
-                    matches = cls.inner_key_pattern.findall(_value)
-                    if not matches:
-                        continue
-
-                    subdict_found = True
-                    found = True
-                    key_values[key][_key] = cls.replace_inner_keys(
-                        matches, _value, key_values,
-                        "{}.{}".format(key, _key)
-                    )
-
-                if not subdict_found:
-                    keys_to_solve.remove(key)
-
-            if not found:
-                break
-
-        return key_values
-
-    @classmethod
-    def solve_template_inner_links(cls, templates):
-        """Solve templates inner keys identified by "{@*}".
-
-        Process is split into 2 parts.
-        First is collecting all global keys (keys in top hierarchy where value
-        is not dictionary). All global keys are set for all group keys (keys
-        in top hierarchy where value is dictionary). Value of a key is not
-        overridden in group if already contain value for the key.
-
-        In second part all keys with "at" symbol in value are replaced with
-        value of the key afterward "at" symbol from the group.
-
-        Args:
-            templates (dict): Raw templates data.
-
-        Example:
-            templates::
-                key_1: "value_1",
-                key_2: "{@key_1}/{filling_key}"
-
-                group_1:
-                    key_3: "value_3/{@key_2}"
-
-                group_2:
-                    key_2": "value_2"
-                    key_4": "value_4/{@key_2}"
-
-            output::
-                key_1: "value_1"
-                key_2: "value_1/{filling_key}"
-
-                group_1: {
-                    key_1: "value_1"
-                    key_2: "value_1/{filling_key}"
-                    key_3: "value_3/value_1/{filling_key}"
-
-                group_2: {
-                    key_1: "value_1"
-                    key_2: "value_2"
-                    key_4: "value_3/value_2"
-        """
-        default_key_values = templates.pop("defaults", {})
-        for key, value in tuple(templates.items()):
-            if isinstance(value, dict):
-                continue
-            default_key_values[key] = templates.pop(key)
-
-        # Pop "others" key before before expected keys are processed
-        other_templates = templates.pop("others") or {}
-
-        keys_by_subkey = {}
-        for sub_key, sub_value in templates.items():
-            key_values = {}
-            key_values.update(default_key_values)
-            key_values.update(sub_value)
-            keys_by_subkey[sub_key] = cls.prepare_inner_keys(key_values)
-
-        for sub_key, sub_value in other_templates.items():
-            if sub_key in keys_by_subkey:
-                log.warning((
-                    "Key \"{}\" is duplicated in others. Skipping."
-                ).format(sub_key))
-                continue
-
-            key_values = {}
-            key_values.update(default_key_values)
-            key_values.update(sub_value)
-            keys_by_subkey[sub_key] = cls.prepare_inner_keys(key_values)
-
-        default_keys_by_subkeys = cls.prepare_inner_keys(default_key_values)
-
-        for key, value in default_keys_by_subkeys.items():
-            keys_by_subkey[key] = value
-
-        return keys_by_subkey
-
-    def _dict_to_subkeys_list(self, subdict, pre_keys=None):
-        if pre_keys is None:
-            pre_keys = []
-        output = []
-        for key in subdict:
-            value = subdict[key]
-            result = list(pre_keys)
-            result.append(key)
-            if isinstance(value, dict):
-                for item in self._dict_to_subkeys_list(value, result):
-                    output.append(item)
-            else:
-                output.append(result)
-        return output
-
-    def _keys_to_dicts(self, key_list, value):
-        if not key_list:
-            return None
-        if len(key_list) == 1:
-            return {key_list[0]: value}
-        return {key_list[0]: self._keys_to_dicts(key_list[1:], value)}
-
-    def _rootless_path(self, result, final_data):
-        used_values = result.used_values
-        missing_keys = result.missing_keys
-        template = result.template
-        invalid_types = result.invalid_types
-        if (
-            "root" not in used_values
-            or "root" in missing_keys
-            or "{root" not in template
-        ):
-            return
-
-        for invalid_type in invalid_types:
-            if "root" in invalid_type:
-                return
-
-        root_keys = self._dict_to_subkeys_list({"root": used_values["root"]})
-        if not root_keys:
-            return
-
-        output = str(result)
-        for used_root_keys in root_keys:
-            if not used_root_keys:
-                continue
-
-            used_value = used_values
-            root_key = None
-            for key in used_root_keys:
-                used_value = used_value[key]
-                if root_key is None:
-                    root_key = key
-                else:
-                    root_key += "[{}]".format(key)
-
-            root_key = "{" + root_key + "}"
-            output = output.replace(str(used_value), root_key)
-
-        return output
-
-    def format(self, data, strict=True):
-        copy_data = copy.deepcopy(data)
-        roots = self.roots
-        if roots:
-            copy_data["root"] = roots
-        result = super(AnatomyTemplates, self).format(copy_data)
-        result.strict = strict
-        return result
-
-    def format_all(self, in_data, only_keys=True):
-        """ Solves templates based on entered data.
-
-        Args:
-            data (dict): Containing keys to be filled into template.
-
-        Returns:
-            TemplatesResultDict: Output `TemplateResult` have `strict`
-                attribute set to False so accessing unfilled keys in templates
-                won't raise any exceptions.
-        """
-        return self.format(in_data, strict=False)
-
-
-class RootItem(FormatObject):
-    """Represents one item or roots.
-
-    Holds raw data of root item specification. Raw data contain value
-    for each platform, but current platform value is used when object
-    is used for formatting of template.
-
-    Args:
-        root_raw_data (dict): Dictionary containing root values by platform
-            names. ["windows", "linux" and "darwin"]
-        name (str, optional): Root name which is representing. Used with
-            multi root setup otherwise None value is expected.
-        parent_keys (list, optional): All dictionary parent keys. Values of
-            `parent_keys` are used for get full key which RootItem is
-            representing. Used for replacing root value in path with
-            formattable key. e.g. parent_keys == ["work"] -> {root[work]}
-        parent (object, optional): It is expected to be `Roots` object.
-            Value of `parent` won't affect code logic much.
-    """
-
-    def __init__(
-        self, root_raw_data, name=None, parent_keys=None, parent=None
-    ):
-        lowered_platform_keys = {}
-        for key, value in root_raw_data.items():
-            lowered_platform_keys[key.lower()] = value
-        self.raw_data = lowered_platform_keys
-        self.cleaned_data = self._clean_roots(lowered_platform_keys)
-        self.name = name
-        self.parent_keys = parent_keys or []
-        self.parent = parent
-
-        self.available_platforms = list(lowered_platform_keys.keys())
-        self.value = lowered_platform_keys.get(platform.system().lower())
-        self.clean_value = self.clean_root(self.value)
-
-    def __format__(self, *args, **kwargs):
-        return self.value.__format__(*args, **kwargs)
-
-    def __str__(self):
-        return str(self.value)
-
-    def __repr__(self):
-        return self.__str__()
-
-    def __getitem__(self, key):
-        if isinstance(key, numbers.Number):
-            return self.value[key]
-
-        additional_info = ""
-        if self.parent and self.parent.project_name:
-            additional_info += " for project \"{}\"".format(
-                self.parent.project_name
-            )
-
-        raise AssertionError(
-            "Root key \"{}\" is missing{}.".format(
-                key, additional_info
-            )
-        )
-
-    def full_key(self):
-        """Full key value for dictionary formatting in template.
-
-        Returns:
-            str: Return full replacement key for formatting. This helps when
-                multiple roots are set. In that case e.g. `"root[work]"` is
-                returned.
-        """
-        if not self.name:
-            return "root"
-
-        joined_parent_keys = "".join(
-            ["[{}]".format(key) for key in self.parent_keys]
-        )
-        return "root{}".format(joined_parent_keys)
-
-    def clean_path(self, path):
-        """Just replace backslashes with forward slashes."""
-        return str(path).replace("\\", "/")
-
-    def clean_root(self, root):
-        """Makes sure root value does not end with slash."""
-        if root:
-            root = self.clean_path(root)
-            while root.endswith("/"):
-                root = root[:-1]
-        return root
-
-    def _clean_roots(self, raw_data):
-        """Clean all values of raw root item values."""
-        cleaned = {}
-        for key, value in raw_data.items():
-            cleaned[key] = self.clean_root(value)
-        return cleaned
-
-    def path_remapper(self, path, dst_platform=None, src_platform=None):
-        """Remap path for specific platform.
-
-        Args:
-            path (str): Source path which need to be remapped.
-            dst_platform (str, optional): Specify destination platform
-                for which remapping should happen.
-            src_platform (str, optional): Specify source platform. This is
-                recommended to not use and keep unset until you really want
-                to use specific platform.
-            roots (dict/RootItem/None, optional): It is possible to remap
-                path with different roots then instance where method was
-                called has.
-
-        Returns:
-            str/None: When path does not contain known root then
-                None is returned else returns remapped path with "{root}"
-                or "{root[<name>]}".
-        """
-        cleaned_path = self.clean_path(path)
-        if dst_platform:
-            dst_root_clean = self.cleaned_data.get(dst_platform)
-            if not dst_root_clean:
-                key_part = ""
-                full_key = self.full_key()
-                if full_key != "root":
-                    key_part += "\"{}\" ".format(full_key)
-
-                log.warning(
-                    "Root {}miss platform \"{}\" definition.".format(
-                        key_part, dst_platform
-                    )
-                )
-                return None
-
-            if cleaned_path.startswith(dst_root_clean):
-                return cleaned_path
-
-        if src_platform:
-            src_root_clean = self.cleaned_data.get(src_platform)
-            if src_root_clean is None:
-                log.warning(
-                    "Root \"{}\" miss platform \"{}\" definition.".format(
-                        self.full_key(), src_platform
-                    )
-                )
-                return None
-
-            if not cleaned_path.startswith(src_root_clean):
-                return None
-
-            subpath = cleaned_path[len(src_root_clean):]
-            if dst_platform:
-                # `dst_root_clean` is used from upper condition
-                return dst_root_clean + subpath
-            return self.clean_value + subpath
-
-        result, template = self.find_root_template_from_path(path)
-        if not result:
-            return None
-
-        def parent_dict(keys, value):
-            if not keys:
-                return value
-
-            key = keys.pop(0)
-            return {key: parent_dict(keys, value)}
-
-        if dst_platform:
-            format_value = parent_dict(list(self.parent_keys), dst_root_clean)
-        else:
-            format_value = parent_dict(list(self.parent_keys), self.value)
-
-        return template.format(**{"root": format_value})
-
-    def find_root_template_from_path(self, path):
-        """Replaces known root value with formattable key in path.
-
-        All platform values are checked for this replacement.
-
-        Args:
-            path (str): Path where root value should be found.
-
-        Returns:
-            tuple: Tuple contain 2 values: `success` (bool) and `path` (str).
-                When success it True then path should contain replaced root
-                value with formattable key.
-
-        Example:
-            When input path is::
-                "C:/windows/path/root/projects/my_project/file.ext"
-
-            And raw data of item looks like::
-                {
-                    "windows": "C:/windows/path/root",
-                    "linux": "/mount/root"
-                }
-
-            Output will be::
-                (True, "{root}/projects/my_project/file.ext")
-
-            If any of raw data value wouldn't match path's root output is::
-                (False, "C:/windows/path/root/projects/my_project/file.ext")
-        """
-        result = False
-        output = str(path)
-
-        root_paths = list(self.cleaned_data.values())
-        mod_path = self.clean_path(path)
-        for root_path in root_paths:
-            # Skip empty paths
-            if not root_path:
-                continue
-
-            if mod_path.startswith(root_path):
-                result = True
-                replacement = "{" + self.full_key() + "}"
-                output = replacement + mod_path[len(root_path):]
-                break
-
-        return (result, output)
-
-
-class Roots:
-    """Object which should be used for formatting "root" key in templates.
-
-    Args:
-        anatomy Anatomy: Anatomy object created for a specific project.
-    """
-
-    env_prefix = "OPENPYPE_PROJECT_ROOT"
-    roots_filename = "roots.json"
-
-    def __init__(self, anatomy):
-        self.anatomy = anatomy
-        self.loaded_project = None
-        self._roots = None
-
-    def __format__(self, *args, **kwargs):
-        return self.roots.__format__(*args, **kwargs)
-
-    def __getitem__(self, key):
-        return self.roots[key]
-
-    def reset(self):
-        """Reset current roots value."""
-        self._roots = None
-
-    def path_remapper(
-        self, path, dst_platform=None, src_platform=None, roots=None
-    ):
-        """Remap path for specific platform.
-
-        Args:
-            path (str): Source path which need to be remapped.
-            dst_platform (str, optional): Specify destination platform
-                for which remapping should happen.
-            src_platform (str, optional): Specify source platform. This is
-                recommended to not use and keep unset until you really want
-                to use specific platform.
-            roots (dict/RootItem/None, optional): It is possible to remap
-                path with different roots then instance where method was
-                called has.
-
-        Returns:
-            str/None: When path does not contain known root then
-                None is returned else returns remapped path with "{root}"
-                or "{root[<name>]}".
-        """
-        if roots is None:
-            roots = self.roots
-
-        if roots is None:
-            raise ValueError("Roots are not set. Can't find path.")
-
-        if "{root" in path:
-            path = path.format(**{"root": roots})
-            # If `dst_platform` is not specified then return else continue.
-            if not dst_platform:
-                return path
-
-        if isinstance(roots, RootItem):
-            return roots.path_remapper(path, dst_platform, src_platform)
-
-        for _root in roots.values():
-            result = self.path_remapper(
-                path, dst_platform, src_platform, _root
-            )
-            if result is not None:
-                return result
-
-    def find_root_template_from_path(self, path, roots=None):
-        """Find root value in entered path and replace it with formatting key.
-
-        Args:
-            path (str): Source path where root will be searched.
-            roots (Roots/dict, optional): It is possible to use different
-                roots than instance where method was triggered has.
-
-        Returns:
-            tuple: Output contains tuple with bool representing success as
-                first value and path with or without replaced root with
-                formatting key as second value.
-
-        Raises:
-            ValueError: When roots are not entered and can't be loaded.
-        """
-        if roots is None:
-            log.debug(
-                "Looking for matching root in path \"{}\".".format(path)
-            )
-            roots = self.roots
-
-        if roots is None:
-            raise ValueError("Roots are not set. Can't find path.")
-
-        if isinstance(roots, RootItem):
-            return roots.find_root_template_from_path(path)
-
-        for root_name, _root in roots.items():
-            success, result = self.find_root_template_from_path(path, _root)
-            if success:
-                log.info("Found match in root \"{}\".".format(root_name))
-                return success, result
-
-        log.warning("No matching root was found in current setting.")
-        return (False, path)
-
-    def set_root_environments(self):
-        """Set root environments for current project."""
-        for key, value in self.root_environments().items():
-            os.environ[key] = value
-
-    def root_environments(self):
-        """Use root keys to create unique keys for environment variables.
-
-        Concatenates prefix "OPENPYPE_ROOT" with root keys to create unique
-        keys.
-
-        Returns:
-            dict: Result is `{(str): (str)}` dicitonary where key represents
-                unique key concatenated by keys and value is root value of
-                current platform root.
-
-        Example:
-            With raw root values::
-                "work": {
-                    "windows": "P:/projects/work",
-                    "linux": "/mnt/share/projects/work",
-                    "darwin": "/darwin/path/work"
-                },
-                "publish": {
-                    "windows": "P:/projects/publish",
-                    "linux": "/mnt/share/projects/publish",
-                    "darwin": "/darwin/path/publish"
-                }
-
-            Result on windows platform::
-                {
-                    "OPENPYPE_ROOT_WORK": "P:/projects/work",
-                    "OPENPYPE_ROOT_PUBLISH": "P:/projects/publish"
-                }
-
-            Short example when multiroot is not used::
-                {
-                    "OPENPYPE_ROOT": "P:/projects"
-                }
-        """
-        return self._root_environments()
-
-    def all_root_paths(self, roots=None):
-        """Return all paths for all roots of all platforms."""
-        if roots is None:
-            roots = self.roots
-
-        output = []
-        if isinstance(roots, RootItem):
-            for value in roots.raw_data.values():
-                output.append(value)
-            return output
-
-        for _roots in roots.values():
-            output.extend(self.all_root_paths(_roots))
-        return output
-
-    def _root_environments(self, keys=None, roots=None):
-        if not keys:
-            keys = []
-        if roots is None:
-            roots = self.roots
-
-        if isinstance(roots, RootItem):
-            key_items = [self.env_prefix]
-            for _key in keys:
-                key_items.append(_key.upper())
-
-            key = "_".join(key_items)
-            # Make sure key and value does not contain unicode
-            #   - can happen in Python 2 hosts
-            return {str(key): str(roots.value)}
-
-        output = {}
-        for _key, _value in roots.items():
-            _keys = list(keys)
-            _keys.append(_key)
-            output.update(self._root_environments(_keys, _value))
-        return output
-
-    def root_environmets_fill_data(self, template=None):
-        """Environment variable values in dictionary for rootless path.
-
-        Args:
-            template (str): Template for environment variable key fill.
-                By default is set to `"${}"`.
-        """
-        if template is None:
-            template = "${}"
-        return self._root_environmets_fill_data(template)
-
-    def _root_environmets_fill_data(self, template, keys=None, roots=None):
-        if keys is None and roots is None:
-            return {
-                "root": self._root_environmets_fill_data(
-                    template, [], self.roots
-                )
-            }
-
-        if isinstance(roots, RootItem):
-            key_items = [Roots.env_prefix]
-            for _key in keys:
-                key_items.append(_key.upper())
-            key = "_".join(key_items)
-            return template.format(key)
-
-        output = {}
-        for key, value in roots.items():
-            _keys = list(keys)
-            _keys.append(key)
-            output[key] = self._root_environmets_fill_data(
-                template, _keys, value
-            )
-        return output
-
-    @property
-    def project_name(self):
-        """Return project name which will be used for loading root values."""
-        return self.anatomy.project_name
-
-    @property
-    def roots(self):
-        """Property for filling "root" key in templates.
-
-        This property returns roots for current project or default root values.
-        Warning:
-            Default roots value may cause issues when project use different
-            roots settings. That may happen when project use multiroot
-            templates but default roots miss their keys.
-        """
-        if self.project_name != self.loaded_project:
-            self._roots = None
-
-        if self._roots is None:
-            self._roots = self._discover()
-            self.loaded_project = self.project_name
-        return self._roots
-
-    def _discover(self):
-        """ Loads current project's roots or default.
-
-        Default roots are loaded if project override's does not contain roots.
-
-        Returns:
-            `RootItem` or `dict` with multiple `RootItem`s when multiroot
-            setting is used.
-        """
-
-        return self._parse_dict(self.anatomy["roots"], parent=self)
-
-    @staticmethod
-    def _parse_dict(data, key=None, parent_keys=None, parent=None):
-        """Parse roots raw data into RootItem or dictionary with RootItems.
-
-        Converting raw roots data to `RootItem` helps to handle platform keys.
-        This method is recursive to be able handle multiroot setup and
-        is static to be able to load default roots without creating new object.
-
-        Args:
-            data (dict): Should contain raw roots data to be parsed.
-            key (str, optional): Current root key. Set by recursion.
-            parent_keys (list): Parent dictionary keys. Set by recursion.
-            parent (Roots, optional): Parent object set in `RootItem`
-                helps to keep RootItem instance updated with `Roots` object.
-
-        Returns:
-            `RootItem` or `dict` with multiple `RootItem`s when multiroot
-            setting is used.
-        """
-        if not parent_keys:
-            parent_keys = []
-        is_last = False
-        for value in data.values():
-            if isinstance(value, StringType):
-                is_last = True
-                break
-
-        if is_last:
-            return RootItem(data, key, parent_keys, parent=parent)
-
-        output = {}
-        for _key, value in data.items():
-            _parent_keys = list(parent_keys)
-            _parent_keys.append(_key)
-            output[_key] = Roots._parse_dict(value, _key, _parent_keys, parent)
-        return output
+def Anatomy(*args, **kwargs):
+    from openpype.pipeline import Anatomy
+    return Anatomy(*args, **kwargs)
diff --git a/openpype/pipeline/anatomy.py b/openpype/pipeline/anatomy.py
new file mode 100644
index 0000000000..33dfe64cb0
--- /dev/null
+++ b/openpype/pipeline/anatomy.py
@@ -0,0 +1,1260 @@
+import os
+import re
+import copy
+import platform
+import collections
+import numbers
+
+from openpype.settings.lib import (
+    get_default_anatomy_settings,
+    get_anatomy_settings
+)
+from openpype.lib.path_templates import (
+    TemplateUnsolved,
+    TemplateResult,
+    TemplatesDict,
+    FormatObject,
+)
+from openpype.lib.log import PypeLogger
+
+log = PypeLogger.get_logger(__name__)
+
+try:
+    StringType = basestring
+except NameError:
+    StringType = str
+
+
+class ProjectNotSet(Exception):
+    """Exception raised when is created Anatomy without project name."""
+
+
+class RootCombinationError(Exception):
+    """This exception is raised when templates has combined root types."""
+
+    def __init__(self, roots):
+        joined_roots = ", ".join(
+            ["\"{}\"".format(_root) for _root in roots]
+        )
+        # TODO better error message
+        msg = (
+            "Combination of root with and"
+            " without root name in AnatomyTemplates. {}"
+        ).format(joined_roots)
+
+        super(RootCombinationError, self).__init__(msg)
+
+
+class Anatomy:
+    """Anatomy module helps to keep project settings.
+
+    Wraps key project specifications, AnatomyTemplates and Roots.
+
+    Args:
+        project_name (str): Project name to look on overrides.
+    """
+
+    root_key_regex = re.compile(r"{(root?[^}]+)}")
+    root_name_regex = re.compile(r"root\[([^]]+)\]")
+
+    def __init__(self, project_name=None, site_name=None):
+        if not project_name:
+            project_name = os.environ.get("AVALON_PROJECT")
+
+        if not project_name:
+            raise ProjectNotSet((
+                "Implementation bug: Project name is not set. Anatomy requires"
+                " to load data for specific project."
+            ))
+
+        self.project_name = project_name
+
+        self._data = self._prepare_anatomy_data(
+            get_anatomy_settings(project_name, site_name)
+        )
+        self._site_name = site_name
+        self._templates_obj = AnatomyTemplates(self)
+        self._roots_obj = Roots(self)
+
+    # Anatomy used as dictionary
+    # - implemented only getters returning copy
+    def __getitem__(self, key):
+        return copy.deepcopy(self._data[key])
+
+    def get(self, key, default=None):
+        return copy.deepcopy(self._data).get(key, default)
+
+    def keys(self):
+        return copy.deepcopy(self._data).keys()
+
+    def values(self):
+        return copy.deepcopy(self._data).values()
+
+    def items(self):
+        return copy.deepcopy(self._data).items()
+
+    @staticmethod
+    def default_data():
+        """Default project anatomy data.
+
+        Always return fresh loaded data. May be used as data for new project.
+
+        Not used inside Anatomy itself.
+        """
+        return get_default_anatomy_settings(clear_metadata=False)
+
+    @staticmethod
+    def _prepare_anatomy_data(anatomy_data):
+        """Prepare anatomy data for further processing.
+
+        Method added to replace `{task}` with `{task[name]}` in templates.
+        """
+        templates_data = anatomy_data.get("templates")
+        if templates_data:
+            # Replace `{task}` with `{task[name]}` in templates
+            value_queue = collections.deque()
+            value_queue.append(templates_data)
+            while value_queue:
+                item = value_queue.popleft()
+                if not isinstance(item, dict):
+                    continue
+
+                for key in tuple(item.keys()):
+                    value = item[key]
+                    if isinstance(value, dict):
+                        value_queue.append(value)
+
+                    elif isinstance(value, StringType):
+                        item[key] = value.replace("{task}", "{task[name]}")
+        return anatomy_data
+
+    def reset(self):
+        """Reset values of cached data in templates and roots objects."""
+        self._data = self._prepare_anatomy_data(
+            get_anatomy_settings(self.project_name, self._site_name)
+        )
+        self.templates_obj.reset()
+        self.roots_obj.reset()
+
+    @property
+    def templates(self):
+        """Wrap property `templates` of Anatomy's AnatomyTemplates instance."""
+        return self._templates_obj.templates
+
+    @property
+    def templates_obj(self):
+        """Return `AnatomyTemplates` object of current Anatomy instance."""
+        return self._templates_obj
+
+    def format(self, *args, **kwargs):
+        """Wrap `format` method of Anatomy's `templates_obj`."""
+        return self._templates_obj.format(*args, **kwargs)
+
+    def format_all(self, *args, **kwargs):
+        """Wrap `format_all` method of Anatomy's `templates_obj`."""
+        return self._templates_obj.format_all(*args, **kwargs)
+
+    @property
+    def roots(self):
+        """Wrap `roots` property of Anatomy's `roots_obj`."""
+        return self._roots_obj.roots
+
+    @property
+    def roots_obj(self):
+        """Return `Roots` object of current Anatomy instance."""
+        return self._roots_obj
+
+    def root_environments(self):
+        """Return OPENPYPE_ROOT_* environments for current project in dict."""
+        return self._roots_obj.root_environments()
+
+    def root_environmets_fill_data(self, template=None):
+        """Environment variable values in dictionary for rootless path.
+
+        Args:
+            template (str): Template for environment variable key fill.
+                By default is set to `"${}"`.
+        """
+        return self.roots_obj.root_environmets_fill_data(template)
+
+    def find_root_template_from_path(self, *args, **kwargs):
+        """Wrapper for Roots `find_root_template_from_path`."""
+        return self.roots_obj.find_root_template_from_path(*args, **kwargs)
+
+    def path_remapper(self, *args, **kwargs):
+        """Wrapper for Roots `path_remapper`."""
+        return self.roots_obj.path_remapper(*args, **kwargs)
+
+    def all_root_paths(self):
+        """Wrapper for Roots `all_root_paths`."""
+        return self.roots_obj.all_root_paths()
+
+    def set_root_environments(self):
+        """Set OPENPYPE_ROOT_* environments for current project."""
+        self._roots_obj.set_root_environments()
+
+    def root_names(self):
+        """Return root names for current project."""
+        return self.root_names_from_templates(self.templates)
+
+    def _root_keys_from_templates(self, data):
+        """Extract root key from templates in data.
+
+        Args:
+            data (dict): Data that may contain templates as string.
+
+        Return:
+            set: Set of all root names from templates as strings.
+
+        Output example: `{"root[work]", "root[publish]"}`
+        """
+
+        output = set()
+        if isinstance(data, dict):
+            for value in data.values():
+                for root in self._root_keys_from_templates(value):
+                    output.add(root)
+
+        elif isinstance(data, str):
+            for group in re.findall(self.root_key_regex, data):
+                output.add(group)
+
+        return output
+
+    def root_value_for_template(self, template):
+        """Returns value of root key from template."""
+        root_templates = []
+        for group in re.findall(self.root_key_regex, template):
+            root_templates.append("{" + group + "}")
+
+        if not root_templates:
+            return None
+
+        return root_templates[0].format(**{"root": self.roots})
+
+    def root_names_from_templates(self, templates):
+        """Extract root names form anatomy templates.
+
+        Returns None if values in templates contain only "{root}".
+        Empty list is returned if there is no "root" in templates.
+        Else returns all root names from templates in list.
+
+        RootCombinationError is raised when templates contain both root types,
+        basic "{root}" and with root name specification "{root[work]}".
+
+        Args:
+            templates (dict): Anatomy templates where roots are not filled.
+
+        Return:
+            list/None: List of all root names from templates as strings when
+            multiroot setup is used, otherwise None is returned.
+        """
+        roots = list(self._root_keys_from_templates(templates))
+        # Return empty list if no roots found in templates
+        if not roots:
+            return roots
+
+        # Raise exception when root keys have roots with and without root name.
+        # Invalid output example: ["root", "root[project]", "root[render]"]
+        if len(roots) > 1 and "root" in roots:
+            raise RootCombinationError(roots)
+
+        # Return None if "root" without root name in templates
+        if len(roots) == 1 and roots[0] == "root":
+            return None
+
+        names = set()
+        for root in roots:
+            for group in re.findall(self.root_name_regex, root):
+                names.add(group)
+        return list(names)
+
+    def fill_root(self, template_path):
+        """Fill template path where is only "root" key unfilled.
+
+        Args:
+            template_path (str): Path with "root" key in.
+                Example path: "{root}/projects/MyProject/Shot01/Lighting/..."
+
+        Return:
+            str: formatted path
+        """
+        # NOTE does not care if there are different keys than "root"
+        return template_path.format(**{"root": self.roots})
+
+    @classmethod
+    def fill_root_with_path(cls, rootless_path, root_path):
+        """Fill path without filled "root" key with passed path.
+
+        This is helper to fill root with different directory path than anatomy
+        has defined no matter if is single or multiroot.
+
+        Output path is same as input path if `rootless_path` does not contain
+        unfilled root key.
+
+        Args:
+            rootless_path (str): Path without filled "root" key. Example:
+                "{root[work]}/MyProject/..."
+            root_path (str): What should replace root key in `rootless_path`.
+
+        Returns:
+            str: Path with filled root.
+        """
+        output = str(rootless_path)
+        for group in re.findall(cls.root_key_regex, rootless_path):
+            replacement = "{" + group + "}"
+            output = output.replace(replacement, root_path)
+
+        return output
+
+    def replace_root_with_env_key(self, filepath, template=None):
+        """Replace root of path with environment key.
+
+        # Example:
+        ## Project with roots:
+        ```
+        {
+            "nas": {
+                "windows": P:/projects",
+                ...
+            }
+            ...
+        }
+        ```
+
+        ## Entered filepath
+        "P:/projects/project/asset/task/animation_v001.ma"
+
+        ## Entered template
+        "<{}>"
+
+        ## Output
+        "<OPENPYPE_PROJECT_ROOT_NAS>/project/asset/task/animation_v001.ma"
+
+        Args:
+            filepath (str): Full file path where root should be replaced.
+            template (str): Optional template for environment key. Must
+                have one index format key.
+                Default value if not entered: "${}"
+
+        Returns:
+            str: Path where root is replaced with environment root key.
+
+        Raise:
+            ValueError: When project's roots were not found in entered path.
+        """
+        success, rootless_path = self.find_root_template_from_path(filepath)
+        if not success:
+            raise ValueError(
+                "{}: Project's roots were not found in path: {}".format(
+                    self.project_name, filepath
+                )
+            )
+
+        data = self.root_environmets_fill_data(template)
+        return rootless_path.format(**data)
+
+
+class AnatomyTemplateUnsolved(TemplateUnsolved):
+    """Exception for unsolved template when strict is set to True."""
+
+    msg = "Anatomy template \"{0}\" is unsolved.{1}{2}"
+
+
+class AnatomyTemplateResult(TemplateResult):
+    rootless = None
+
+    def __new__(cls, result, rootless_path):
+        new_obj = super(AnatomyTemplateResult, cls).__new__(
+            cls,
+            str(result),
+            result.template,
+            result.solved,
+            result.used_values,
+            result.missing_keys,
+            result.invalid_types
+        )
+        new_obj.rootless = rootless_path
+        return new_obj
+
+    def validate(self):
+        if not self.solved:
+            raise AnatomyTemplateUnsolved(
+                self.template,
+                self.missing_keys,
+                self.invalid_types
+            )
+
+
+class AnatomyTemplates(TemplatesDict):
+    inner_key_pattern = re.compile(r"(\{@.*?[^{}0]*\})")
+    inner_key_name_pattern = re.compile(r"\{@(.*?[^{}0]*)\}")
+
+    def __init__(self, anatomy):
+        super(AnatomyTemplates, self).__init__()
+        self.anatomy = anatomy
+        self.loaded_project = None
+
+    def __getitem__(self, key):
+        return self.templates[key]
+
+    def get(self, key, default=None):
+        return self.templates.get(key, default)
+
+    def reset(self):
+        self._raw_templates = None
+        self._templates = None
+        self._objected_templates = None
+
+    @property
+    def project_name(self):
+        return self.anatomy.project_name
+
+    @property
+    def roots(self):
+        return self.anatomy.roots
+
+    @property
+    def templates(self):
+        self._validate_discovery()
+        return self._templates
+
+    @property
+    def objected_templates(self):
+        self._validate_discovery()
+        return self._objected_templates
+
+    def _validate_discovery(self):
+        if self.project_name != self.loaded_project:
+            self.reset()
+
+        if self._templates is None:
+            self._discover()
+            self.loaded_project = self.project_name
+
+    def _format_value(self, value, data):
+        if isinstance(value, RootItem):
+            return self._solve_dict(value, data)
+
+        result = super(AnatomyTemplates, self)._format_value(value, data)
+        if isinstance(result, TemplateResult):
+            rootless_path = self._rootless_path(result, data)
+            result = AnatomyTemplateResult(result, rootless_path)
+        return result
+
+    def set_templates(self, templates):
+        if not templates:
+            self.reset()
+            return
+
+        self._raw_templates = copy.deepcopy(templates)
+        templates = copy.deepcopy(templates)
+        v_queue = collections.deque()
+        v_queue.append(templates)
+        while v_queue:
+            item = v_queue.popleft()
+            if not isinstance(item, dict):
+                continue
+
+            for key in tuple(item.keys()):
+                value = item[key]
+                if isinstance(value, dict):
+                    v_queue.append(value)
+
+                elif (
+                    isinstance(value, StringType)
+                    and "{task}" in value
+                ):
+                    item[key] = value.replace("{task}", "{task[name]}")
+
+        solved_templates = self.solve_template_inner_links(templates)
+        self._templates = solved_templates
+        self._objected_templates = self.create_ojected_templates(
+            solved_templates
+        )
+
+    def default_templates(self):
+        """Return default templates data with solved inner keys."""
+        return self.solve_template_inner_links(
+            self.anatomy["templates"]
+        )
+
+    def _discover(self):
+        """ Loads anatomy templates from yaml.
+        Default templates are loaded if project is not set or project does
+        not have set it's own.
+        TODO: create templates if not exist.
+
+        Returns:
+            TemplatesResultDict: Contain templates data for current project of
+                default templates.
+        """
+
+        if self.project_name is None:
+            # QUESTION create project specific if not found?
+            raise AssertionError((
+                "Project \"{0}\" does not have his own templates."
+                " Trying to use default."
+            ).format(self.project_name))
+
+        self.set_templates(self.anatomy["templates"])
+
+    @classmethod
+    def replace_inner_keys(cls, matches, value, key_values, key):
+        """Replacement of inner keys in template values."""
+        for match in matches:
+            anatomy_sub_keys = (
+                cls.inner_key_name_pattern.findall(match)
+            )
+            if key in anatomy_sub_keys:
+                raise ValueError((
+                    "Unsolvable recursion in inner keys, "
+                    "key: \"{}\" is in his own value."
+                    " Can't determine source, please check Anatomy templates."
+                ).format(key))
+
+            for anatomy_sub_key in anatomy_sub_keys:
+                replace_value = key_values.get(anatomy_sub_key)
+                if replace_value is None:
+                    raise KeyError((
+                        "Anatomy templates can't be filled."
+                        " Anatomy key `{0}` has"
+                        " invalid inner key `{1}`."
+                    ).format(key, anatomy_sub_key))
+
+                valid = isinstance(replace_value, (numbers.Number, StringType))
+                if not valid:
+                    raise ValueError((
+                        "Anatomy templates can't be filled."
+                        " Anatomy key `{0}` has"
+                        " invalid inner key `{1}`"
+                        " with value `{2}`."
+                    ).format(key, anatomy_sub_key, str(replace_value)))
+
+                value = value.replace(match, str(replace_value))
+
+        return value
+
+    @classmethod
+    def prepare_inner_keys(cls, key_values):
+        """Check values of inner keys.
+
+        Check if inner key exist in template group and has valid value.
+        It is also required to avoid infinite loop with unsolvable recursion
+        when first inner key's value refers to second inner key's value where
+        first is used.
+        """
+        keys_to_solve = set(key_values.keys())
+        while True:
+            found = False
+            for key in tuple(keys_to_solve):
+                value = key_values[key]
+
+                if isinstance(value, StringType):
+                    matches = cls.inner_key_pattern.findall(value)
+                    if not matches:
+                        keys_to_solve.remove(key)
+                        continue
+
+                    found = True
+                    key_values[key] = cls.replace_inner_keys(
+                        matches, value, key_values, key
+                    )
+                    continue
+
+                elif not isinstance(value, dict):
+                    keys_to_solve.remove(key)
+                    continue
+
+                subdict_found = False
+                for _key, _value in tuple(value.items()):
+                    matches = cls.inner_key_pattern.findall(_value)
+                    if not matches:
+                        continue
+
+                    subdict_found = True
+                    found = True
+                    key_values[key][_key] = cls.replace_inner_keys(
+                        matches, _value, key_values,
+                        "{}.{}".format(key, _key)
+                    )
+
+                if not subdict_found:
+                    keys_to_solve.remove(key)
+
+            if not found:
+                break
+
+        return key_values
+
+    @classmethod
+    def solve_template_inner_links(cls, templates):
+        """Solve templates inner keys identified by "{@*}".
+
+        Process is split into 2 parts.
+        First is collecting all global keys (keys in top hierarchy where value
+        is not dictionary). All global keys are set for all group keys (keys
+        in top hierarchy where value is dictionary). Value of a key is not
+        overridden in group if already contain value for the key.
+
+        In second part all keys with "at" symbol in value are replaced with
+        value of the key afterward "at" symbol from the group.
+
+        Args:
+            templates (dict): Raw templates data.
+
+        Example:
+            templates::
+                key_1: "value_1",
+                key_2: "{@key_1}/{filling_key}"
+
+                group_1:
+                    key_3: "value_3/{@key_2}"
+
+                group_2:
+                    key_2": "value_2"
+                    key_4": "value_4/{@key_2}"
+
+            output::
+                key_1: "value_1"
+                key_2: "value_1/{filling_key}"
+
+                group_1: {
+                    key_1: "value_1"
+                    key_2: "value_1/{filling_key}"
+                    key_3: "value_3/value_1/{filling_key}"
+
+                group_2: {
+                    key_1: "value_1"
+                    key_2: "value_2"
+                    key_4: "value_3/value_2"
+        """
+        default_key_values = templates.pop("defaults", {})
+        for key, value in tuple(templates.items()):
+            if isinstance(value, dict):
+                continue
+            default_key_values[key] = templates.pop(key)
+
+        # Pop "others" key before before expected keys are processed
+        other_templates = templates.pop("others") or {}
+
+        keys_by_subkey = {}
+        for sub_key, sub_value in templates.items():
+            key_values = {}
+            key_values.update(default_key_values)
+            key_values.update(sub_value)
+            keys_by_subkey[sub_key] = cls.prepare_inner_keys(key_values)
+
+        for sub_key, sub_value in other_templates.items():
+            if sub_key in keys_by_subkey:
+                log.warning((
+                    "Key \"{}\" is duplicated in others. Skipping."
+                ).format(sub_key))
+                continue
+
+            key_values = {}
+            key_values.update(default_key_values)
+            key_values.update(sub_value)
+            keys_by_subkey[sub_key] = cls.prepare_inner_keys(key_values)
+
+        default_keys_by_subkeys = cls.prepare_inner_keys(default_key_values)
+
+        for key, value in default_keys_by_subkeys.items():
+            keys_by_subkey[key] = value
+
+        return keys_by_subkey
+
+    def _dict_to_subkeys_list(self, subdict, pre_keys=None):
+        if pre_keys is None:
+            pre_keys = []
+        output = []
+        for key in subdict:
+            value = subdict[key]
+            result = list(pre_keys)
+            result.append(key)
+            if isinstance(value, dict):
+                for item in self._dict_to_subkeys_list(value, result):
+                    output.append(item)
+            else:
+                output.append(result)
+        return output
+
+    def _keys_to_dicts(self, key_list, value):
+        if not key_list:
+            return None
+        if len(key_list) == 1:
+            return {key_list[0]: value}
+        return {key_list[0]: self._keys_to_dicts(key_list[1:], value)}
+
+    def _rootless_path(self, result, final_data):
+        used_values = result.used_values
+        missing_keys = result.missing_keys
+        template = result.template
+        invalid_types = result.invalid_types
+        if (
+            "root" not in used_values
+            or "root" in missing_keys
+            or "{root" not in template
+        ):
+            return
+
+        for invalid_type in invalid_types:
+            if "root" in invalid_type:
+                return
+
+        root_keys = self._dict_to_subkeys_list({"root": used_values["root"]})
+        if not root_keys:
+            return
+
+        output = str(result)
+        for used_root_keys in root_keys:
+            if not used_root_keys:
+                continue
+
+            used_value = used_values
+            root_key = None
+            for key in used_root_keys:
+                used_value = used_value[key]
+                if root_key is None:
+                    root_key = key
+                else:
+                    root_key += "[{}]".format(key)
+
+            root_key = "{" + root_key + "}"
+            output = output.replace(str(used_value), root_key)
+
+        return output
+
+    def format(self, data, strict=True):
+        copy_data = copy.deepcopy(data)
+        roots = self.roots
+        if roots:
+            copy_data["root"] = roots
+        result = super(AnatomyTemplates, self).format(copy_data)
+        result.strict = strict
+        return result
+
+    def format_all(self, in_data, only_keys=True):
+        """ Solves templates based on entered data.
+
+        Args:
+            data (dict): Containing keys to be filled into template.
+
+        Returns:
+            TemplatesResultDict: Output `TemplateResult` have `strict`
+                attribute set to False so accessing unfilled keys in templates
+                won't raise any exceptions.
+        """
+        return self.format(in_data, strict=False)
+
+
+class RootItem(FormatObject):
+    """Represents one item or roots.
+
+    Holds raw data of root item specification. Raw data contain value
+    for each platform, but current platform value is used when object
+    is used for formatting of template.
+
+    Args:
+        root_raw_data (dict): Dictionary containing root values by platform
+            names. ["windows", "linux" and "darwin"]
+        name (str, optional): Root name which is representing. Used with
+            multi root setup otherwise None value is expected.
+        parent_keys (list, optional): All dictionary parent keys. Values of
+            `parent_keys` are used for get full key which RootItem is
+            representing. Used for replacing root value in path with
+            formattable key. e.g. parent_keys == ["work"] -> {root[work]}
+        parent (object, optional): It is expected to be `Roots` object.
+            Value of `parent` won't affect code logic much.
+    """
+
+    def __init__(
+        self, root_raw_data, name=None, parent_keys=None, parent=None
+    ):
+        lowered_platform_keys = {}
+        for key, value in root_raw_data.items():
+            lowered_platform_keys[key.lower()] = value
+        self.raw_data = lowered_platform_keys
+        self.cleaned_data = self._clean_roots(lowered_platform_keys)
+        self.name = name
+        self.parent_keys = parent_keys or []
+        self.parent = parent
+
+        self.available_platforms = list(lowered_platform_keys.keys())
+        self.value = lowered_platform_keys.get(platform.system().lower())
+        self.clean_value = self.clean_root(self.value)
+
+    def __format__(self, *args, **kwargs):
+        return self.value.__format__(*args, **kwargs)
+
+    def __str__(self):
+        return str(self.value)
+
+    def __repr__(self):
+        return self.__str__()
+
+    def __getitem__(self, key):
+        if isinstance(key, numbers.Number):
+            return self.value[key]
+
+        additional_info = ""
+        if self.parent and self.parent.project_name:
+            additional_info += " for project \"{}\"".format(
+                self.parent.project_name
+            )
+
+        raise AssertionError(
+            "Root key \"{}\" is missing{}.".format(
+                key, additional_info
+            )
+        )
+
+    def full_key(self):
+        """Full key value for dictionary formatting in template.
+
+        Returns:
+            str: Return full replacement key for formatting. This helps when
+                multiple roots are set. In that case e.g. `"root[work]"` is
+                returned.
+        """
+        if not self.name:
+            return "root"
+
+        joined_parent_keys = "".join(
+            ["[{}]".format(key) for key in self.parent_keys]
+        )
+        return "root{}".format(joined_parent_keys)
+
+    def clean_path(self, path):
+        """Just replace backslashes with forward slashes."""
+        return str(path).replace("\\", "/")
+
+    def clean_root(self, root):
+        """Makes sure root value does not end with slash."""
+        if root:
+            root = self.clean_path(root)
+            while root.endswith("/"):
+                root = root[:-1]
+        return root
+
+    def _clean_roots(self, raw_data):
+        """Clean all values of raw root item values."""
+        cleaned = {}
+        for key, value in raw_data.items():
+            cleaned[key] = self.clean_root(value)
+        return cleaned
+
+    def path_remapper(self, path, dst_platform=None, src_platform=None):
+        """Remap path for specific platform.
+
+        Args:
+            path (str): Source path which need to be remapped.
+            dst_platform (str, optional): Specify destination platform
+                for which remapping should happen.
+            src_platform (str, optional): Specify source platform. This is
+                recommended to not use and keep unset until you really want
+                to use specific platform.
+            roots (dict/RootItem/None, optional): It is possible to remap
+                path with different roots then instance where method was
+                called has.
+
+        Returns:
+            str/None: When path does not contain known root then
+                None is returned else returns remapped path with "{root}"
+                or "{root[<name>]}".
+        """
+        cleaned_path = self.clean_path(path)
+        if dst_platform:
+            dst_root_clean = self.cleaned_data.get(dst_platform)
+            if not dst_root_clean:
+                key_part = ""
+                full_key = self.full_key()
+                if full_key != "root":
+                    key_part += "\"{}\" ".format(full_key)
+
+                log.warning(
+                    "Root {}miss platform \"{}\" definition.".format(
+                        key_part, dst_platform
+                    )
+                )
+                return None
+
+            if cleaned_path.startswith(dst_root_clean):
+                return cleaned_path
+
+        if src_platform:
+            src_root_clean = self.cleaned_data.get(src_platform)
+            if src_root_clean is None:
+                log.warning(
+                    "Root \"{}\" miss platform \"{}\" definition.".format(
+                        self.full_key(), src_platform
+                    )
+                )
+                return None
+
+            if not cleaned_path.startswith(src_root_clean):
+                return None
+
+            subpath = cleaned_path[len(src_root_clean):]
+            if dst_platform:
+                # `dst_root_clean` is used from upper condition
+                return dst_root_clean + subpath
+            return self.clean_value + subpath
+
+        result, template = self.find_root_template_from_path(path)
+        if not result:
+            return None
+
+        def parent_dict(keys, value):
+            if not keys:
+                return value
+
+            key = keys.pop(0)
+            return {key: parent_dict(keys, value)}
+
+        if dst_platform:
+            format_value = parent_dict(list(self.parent_keys), dst_root_clean)
+        else:
+            format_value = parent_dict(list(self.parent_keys), self.value)
+
+        return template.format(**{"root": format_value})
+
+    def find_root_template_from_path(self, path):
+        """Replaces known root value with formattable key in path.
+
+        All platform values are checked for this replacement.
+
+        Args:
+            path (str): Path where root value should be found.
+
+        Returns:
+            tuple: Tuple contain 2 values: `success` (bool) and `path` (str).
+                When success it True then path should contain replaced root
+                value with formattable key.
+
+        Example:
+            When input path is::
+                "C:/windows/path/root/projects/my_project/file.ext"
+
+            And raw data of item looks like::
+                {
+                    "windows": "C:/windows/path/root",
+                    "linux": "/mount/root"
+                }
+
+            Output will be::
+                (True, "{root}/projects/my_project/file.ext")
+
+            If any of raw data value wouldn't match path's root output is::
+                (False, "C:/windows/path/root/projects/my_project/file.ext")
+        """
+        result = False
+        output = str(path)
+
+        root_paths = list(self.cleaned_data.values())
+        mod_path = self.clean_path(path)
+        for root_path in root_paths:
+            # Skip empty paths
+            if not root_path:
+                continue
+
+            if mod_path.startswith(root_path):
+                result = True
+                replacement = "{" + self.full_key() + "}"
+                output = replacement + mod_path[len(root_path):]
+                break
+
+        return (result, output)
+
+
+class Roots:
+    """Object which should be used for formatting "root" key in templates.
+
+    Args:
+        anatomy Anatomy: Anatomy object created for a specific project.
+    """
+
+    env_prefix = "OPENPYPE_PROJECT_ROOT"
+    roots_filename = "roots.json"
+
+    def __init__(self, anatomy):
+        self.anatomy = anatomy
+        self.loaded_project = None
+        self._roots = None
+
+    def __format__(self, *args, **kwargs):
+        return self.roots.__format__(*args, **kwargs)
+
+    def __getitem__(self, key):
+        return self.roots[key]
+
+    def reset(self):
+        """Reset current roots value."""
+        self._roots = None
+
+    def path_remapper(
+        self, path, dst_platform=None, src_platform=None, roots=None
+    ):
+        """Remap path for specific platform.
+
+        Args:
+            path (str): Source path which need to be remapped.
+            dst_platform (str, optional): Specify destination platform
+                for which remapping should happen.
+            src_platform (str, optional): Specify source platform. This is
+                recommended to not use and keep unset until you really want
+                to use specific platform.
+            roots (dict/RootItem/None, optional): It is possible to remap
+                path with different roots then instance where method was
+                called has.
+
+        Returns:
+            str/None: When path does not contain known root then
+                None is returned else returns remapped path with "{root}"
+                or "{root[<name>]}".
+        """
+        if roots is None:
+            roots = self.roots
+
+        if roots is None:
+            raise ValueError("Roots are not set. Can't find path.")
+
+        if "{root" in path:
+            path = path.format(**{"root": roots})
+            # If `dst_platform` is not specified then return else continue.
+            if not dst_platform:
+                return path
+
+        if isinstance(roots, RootItem):
+            return roots.path_remapper(path, dst_platform, src_platform)
+
+        for _root in roots.values():
+            result = self.path_remapper(
+                path, dst_platform, src_platform, _root
+            )
+            if result is not None:
+                return result
+
+    def find_root_template_from_path(self, path, roots=None):
+        """Find root value in entered path and replace it with formatting key.
+
+        Args:
+            path (str): Source path where root will be searched.
+            roots (Roots/dict, optional): It is possible to use different
+                roots than instance where method was triggered has.
+
+        Returns:
+            tuple: Output contains tuple with bool representing success as
+                first value and path with or without replaced root with
+                formatting key as second value.
+
+        Raises:
+            ValueError: When roots are not entered and can't be loaded.
+        """
+        if roots is None:
+            log.debug(
+                "Looking for matching root in path \"{}\".".format(path)
+            )
+            roots = self.roots
+
+        if roots is None:
+            raise ValueError("Roots are not set. Can't find path.")
+
+        if isinstance(roots, RootItem):
+            return roots.find_root_template_from_path(path)
+
+        for root_name, _root in roots.items():
+            success, result = self.find_root_template_from_path(path, _root)
+            if success:
+                log.info("Found match in root \"{}\".".format(root_name))
+                return success, result
+
+        log.warning("No matching root was found in current setting.")
+        return (False, path)
+
+    def set_root_environments(self):
+        """Set root environments for current project."""
+        for key, value in self.root_environments().items():
+            os.environ[key] = value
+
+    def root_environments(self):
+        """Use root keys to create unique keys for environment variables.
+
+        Concatenates prefix "OPENPYPE_ROOT" with root keys to create unique
+        keys.
+
+        Returns:
+            dict: Result is `{(str): (str)}` dicitonary where key represents
+                unique key concatenated by keys and value is root value of
+                current platform root.
+
+        Example:
+            With raw root values::
+                "work": {
+                    "windows": "P:/projects/work",
+                    "linux": "/mnt/share/projects/work",
+                    "darwin": "/darwin/path/work"
+                },
+                "publish": {
+                    "windows": "P:/projects/publish",
+                    "linux": "/mnt/share/projects/publish",
+                    "darwin": "/darwin/path/publish"
+                }
+
+            Result on windows platform::
+                {
+                    "OPENPYPE_ROOT_WORK": "P:/projects/work",
+                    "OPENPYPE_ROOT_PUBLISH": "P:/projects/publish"
+                }
+
+            Short example when multiroot is not used::
+                {
+                    "OPENPYPE_ROOT": "P:/projects"
+                }
+        """
+        return self._root_environments()
+
+    def all_root_paths(self, roots=None):
+        """Return all paths for all roots of all platforms."""
+        if roots is None:
+            roots = self.roots
+
+        output = []
+        if isinstance(roots, RootItem):
+            for value in roots.raw_data.values():
+                output.append(value)
+            return output
+
+        for _roots in roots.values():
+            output.extend(self.all_root_paths(_roots))
+        return output
+
+    def _root_environments(self, keys=None, roots=None):
+        if not keys:
+            keys = []
+        if roots is None:
+            roots = self.roots
+
+        if isinstance(roots, RootItem):
+            key_items = [self.env_prefix]
+            for _key in keys:
+                key_items.append(_key.upper())
+
+            key = "_".join(key_items)
+            # Make sure key and value does not contain unicode
+            #   - can happen in Python 2 hosts
+            return {str(key): str(roots.value)}
+
+        output = {}
+        for _key, _value in roots.items():
+            _keys = list(keys)
+            _keys.append(_key)
+            output.update(self._root_environments(_keys, _value))
+        return output
+
+    def root_environmets_fill_data(self, template=None):
+        """Environment variable values in dictionary for rootless path.
+
+        Args:
+            template (str): Template for environment variable key fill.
+                By default is set to `"${}"`.
+        """
+        if template is None:
+            template = "${}"
+        return self._root_environmets_fill_data(template)
+
+    def _root_environmets_fill_data(self, template, keys=None, roots=None):
+        if keys is None and roots is None:
+            return {
+                "root": self._root_environmets_fill_data(
+                    template, [], self.roots
+                )
+            }
+
+        if isinstance(roots, RootItem):
+            key_items = [Roots.env_prefix]
+            for _key in keys:
+                key_items.append(_key.upper())
+            key = "_".join(key_items)
+            return template.format(key)
+
+        output = {}
+        for key, value in roots.items():
+            _keys = list(keys)
+            _keys.append(key)
+            output[key] = self._root_environmets_fill_data(
+                template, _keys, value
+            )
+        return output
+
+    @property
+    def project_name(self):
+        """Return project name which will be used for loading root values."""
+        return self.anatomy.project_name
+
+    @property
+    def roots(self):
+        """Property for filling "root" key in templates.
+
+        This property returns roots for current project or default root values.
+        Warning:
+            Default roots value may cause issues when project use different
+            roots settings. That may happen when project use multiroot
+            templates but default roots miss their keys.
+        """
+        if self.project_name != self.loaded_project:
+            self._roots = None
+
+        if self._roots is None:
+            self._roots = self._discover()
+            self.loaded_project = self.project_name
+        return self._roots
+
+    def _discover(self):
+        """ Loads current project's roots or default.
+
+        Default roots are loaded if project override's does not contain roots.
+
+        Returns:
+            `RootItem` or `dict` with multiple `RootItem`s when multiroot
+            setting is used.
+        """
+
+        return self._parse_dict(self.anatomy["roots"], parent=self)
+
+    @staticmethod
+    def _parse_dict(data, key=None, parent_keys=None, parent=None):
+        """Parse roots raw data into RootItem or dictionary with RootItems.
+
+        Converting raw roots data to `RootItem` helps to handle platform keys.
+        This method is recursive to be able handle multiroot setup and
+        is static to be able to load default roots without creating new object.
+
+        Args:
+            data (dict): Should contain raw roots data to be parsed.
+            key (str, optional): Current root key. Set by recursion.
+            parent_keys (list): Parent dictionary keys. Set by recursion.
+            parent (Roots, optional): Parent object set in `RootItem`
+                helps to keep RootItem instance updated with `Roots` object.
+
+        Returns:
+            `RootItem` or `dict` with multiple `RootItem`s when multiroot
+            setting is used.
+        """
+        if not parent_keys:
+            parent_keys = []
+        is_last = False
+        for value in data.values():
+            if isinstance(value, StringType):
+                is_last = True
+                break
+
+        if is_last:
+            return RootItem(data, key, parent_keys, parent=parent)
+
+        output = {}
+        for _key, value in data.items():
+            _parent_keys = list(parent_keys)
+            _parent_keys.append(_key)
+            output[_key] = Roots._parse_dict(value, _key, _parent_keys, parent)
+        return output

From f0a5daa6434086453b8b3ff1e5ccd57bf055228b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 14:05:45 +0200
Subject: [PATCH 0905/1227] use six.string_types to determine string type

---
 openpype/pipeline/anatomy.py | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/openpype/pipeline/anatomy.py b/openpype/pipeline/anatomy.py
index 33dfe64cb0..b5b87b6432 100644
--- a/openpype/pipeline/anatomy.py
+++ b/openpype/pipeline/anatomy.py
@@ -5,6 +5,8 @@ import platform
 import collections
 import numbers
 
+import six
+
 from openpype.settings.lib import (
     get_default_anatomy_settings,
     get_anatomy_settings
@@ -19,11 +21,6 @@ from openpype.lib.log import PypeLogger
 
 log = PypeLogger.get_logger(__name__)
 
-try:
-    StringType = basestring
-except NameError:
-    StringType = str
-
 
 class ProjectNotSet(Exception):
     """Exception raised when is created Anatomy without project name."""
@@ -124,7 +121,7 @@ class Anatomy:
                     if isinstance(value, dict):
                         value_queue.append(value)
 
-                    elif isinstance(value, StringType):
+                    elif isinstance(value, six.string_types):
                         item[key] = value.replace("{task}", "{task[name]}")
         return anatomy_data
 
@@ -462,7 +459,7 @@ class AnatomyTemplates(TemplatesDict):
                     v_queue.append(value)
 
                 elif (
-                    isinstance(value, StringType)
+                    isinstance(value, six.string_types)
                     and "{task}" in value
                 ):
                     item[key] = value.replace("{task}", "{task[name]}")
@@ -522,8 +519,10 @@ class AnatomyTemplates(TemplatesDict):
                         " invalid inner key `{1}`."
                     ).format(key, anatomy_sub_key))
 
-                valid = isinstance(replace_value, (numbers.Number, StringType))
-                if not valid:
+                if not (
+                    isinstance(replace_value, numbers.Number)
+                    or isinstance(replace_value, six.string_types)
+                ):
                     raise ValueError((
                         "Anatomy templates can't be filled."
                         " Anatomy key `{0}` has"
@@ -550,7 +549,7 @@ class AnatomyTemplates(TemplatesDict):
             for key in tuple(keys_to_solve):
                 value = key_values[key]
 
-                if isinstance(value, StringType):
+                if isinstance(value, six.string_types):
                     matches = cls.inner_key_pattern.findall(value)
                     if not matches:
                         keys_to_solve.remove(key)
@@ -1245,7 +1244,7 @@ class Roots:
             parent_keys = []
         is_last = False
         for value in data.values():
-            if isinstance(value, StringType):
+            if isinstance(value, six.string_types):
                 is_last = True
                 break
 

From 929fe06127e6960b17327bdffbfaf061e767b93f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 14:13:25 +0200
Subject: [PATCH 0906/1227] added deprecation warning to anatomy lib

---
 openpype/lib/anatomy.py | 37 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/openpype/lib/anatomy.py b/openpype/lib/anatomy.py
index b62b207ade..6d339f058f 100644
--- a/openpype/lib/anatomy.py
+++ b/openpype/lib/anatomy.py
@@ -1,3 +1,38 @@
+"""Code related to project Anatomy was moved
+to 'openpype.pipeline.anatomy' please change your imports as soon as
+possible. File will be probably removed in OpenPype 3.14.*
+"""
+
+import warnings
+import functools
+
+
+class AnatomyDeprecatedWarning(DeprecationWarning):
+    pass
+
+
+def anatomy_deprecated(func):
+    """Mark functions as deprecated.
+
+    It will result in a warning being emitted when the function is used.
+    """
+
+    @functools.wraps(func)
+    def new_func(*args, **kwargs):
+        warnings.simplefilter("always", AnatomyDeprecatedWarning)
+        warnings.warn(
+            (
+                "Deprecated import of 'Anatomy'."
+                " Class was moved to 'openpype.pipeline.anatomy'."
+                " Please change your imports of Anatomy in codebase."
+            ),
+            category=AnatomyDeprecatedWarning
+        )
+        return func(*args, **kwargs)
+    return new_func
+
+
+@anatomy_deprecated
 def Anatomy(*args, **kwargs):
-    from openpype.pipeline import Anatomy
+    from openpype.pipeline.anatomy import Anatomy
     return Anatomy(*args, **kwargs)

From ffb2a8c33aed22539675462ad0f040f717dca29c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 14:14:21 +0200
Subject: [PATCH 0907/1227] removed unused method

---
 openpype/pipeline/anatomy.py | 15 +--------------
 1 file changed, 1 insertion(+), 14 deletions(-)

diff --git a/openpype/pipeline/anatomy.py b/openpype/pipeline/anatomy.py
index b5b87b6432..8a05a3794d 100644
--- a/openpype/pipeline/anatomy.py
+++ b/openpype/pipeline/anatomy.py
@@ -7,10 +7,7 @@ import numbers
 
 import six
 
-from openpype.settings.lib import (
-    get_default_anatomy_settings,
-    get_anatomy_settings
-)
+from openpype.settings.lib import get_anatomy_settings
 from openpype.lib.path_templates import (
     TemplateUnsolved,
     TemplateResult,
@@ -90,16 +87,6 @@ class Anatomy:
     def items(self):
         return copy.deepcopy(self._data).items()
 
-    @staticmethod
-    def default_data():
-        """Default project anatomy data.
-
-        Always return fresh loaded data. May be used as data for new project.
-
-        Not used inside Anatomy itself.
-        """
-        return get_default_anatomy_settings(clear_metadata=False)
-
     @staticmethod
     def _prepare_anatomy_data(anatomy_data):
         """Prepare anatomy data for further processing.

From bcaafb479d42d099f22e4f96a9f9fe196b32390c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 14:40:40 +0200
Subject: [PATCH 0908/1227] added Anatomy to openpype.pipeline init file

---
 openpype/pipeline/__init__.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/pipeline/__init__.py b/openpype/pipeline/__init__.py
index 2e441fbf27..2cf785d981 100644
--- a/openpype/pipeline/__init__.py
+++ b/openpype/pipeline/__init__.py
@@ -6,6 +6,7 @@ from .constants import (
 from .mongodb import (
     AvalonMongoDB,
 )
+from .anatomy import Anatomy
 
 from .create import (
     BaseCreator,
@@ -96,6 +97,9 @@ __all__ = (
     # --- MongoDB ---
     "AvalonMongoDB",
 
+    # --- Anatomy ---
+    "Anatomy",
+
     # --- Create ---
     "BaseCreator",
     "Creator",

From a4e371889a61d3f7a36874e00c92ec99db196258 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 14:44:12 +0200
Subject: [PATCH 0909/1227] fix anatomy result copy

---
 openpype/pipeline/anatomy.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/openpype/pipeline/anatomy.py b/openpype/pipeline/anatomy.py
index 8a05a3794d..73081f18fb 100644
--- a/openpype/pipeline/anatomy.py
+++ b/openpype/pipeline/anatomy.py
@@ -369,6 +369,17 @@ class AnatomyTemplateResult(TemplateResult):
                 self.invalid_types
             )
 
+    def copy(self):
+        tmp = TemplateResult(
+            str(self),
+            self.template,
+            self.solved,
+            self.used_values,
+            self.missing_keys,
+            self.invalid_types
+        )
+        return self.__class__(tmp, self.rootless)
+
 
 class AnatomyTemplates(TemplatesDict):
     inner_key_pattern = re.compile(r"(\{@.*?[^{}0]*\})")

From 6d894e8ef0291a93a25719c8de45cc79090544c8 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 29 Jun 2022 15:00:17 +0200
Subject: [PATCH 0910/1227] Reduce code duplication - merge animation +
 pointcache extractor logic

---
 .../maya/plugins/publish/extract_animation.py | 111 ------------------
 .../plugins/publish/extract_pointcache.py     |  38 ++++--
 2 files changed, 30 insertions(+), 119 deletions(-)
 delete mode 100644 openpype/hosts/maya/plugins/publish/extract_animation.py

diff --git a/openpype/hosts/maya/plugins/publish/extract_animation.py b/openpype/hosts/maya/plugins/publish/extract_animation.py
deleted file mode 100644
index b0beb5968e..0000000000
--- a/openpype/hosts/maya/plugins/publish/extract_animation.py
+++ /dev/null
@@ -1,111 +0,0 @@
-import os
-
-from maya import cmds
-
-import openpype.api
-from openpype.hosts.maya.api.lib import (
-    extract_alembic,
-    suspended_refresh,
-    maintained_selection,
-    iter_visible_in_frame_range
-)
-
-
-class ExtractAnimation(openpype.api.Extractor):
-    """Produce an alembic of just point positions and normals.
-
-    Positions and normals, uvs, creases are preserved, but nothing more,
-    for plain and predictable point caches.
-
-    Plugin can run locally or remotely (on a farm - if instance is marked with
-    "farm" it will be skipped in local processing, but processed on farm)
-    """
-
-    label = "Extract Animation"
-    hosts = ["maya"]
-    families = ["animation"]
-    targets = ["local", "remote"]
-
-    def process(self, instance):
-        if instance.data.get("farm"):
-            self.log.debug("Should be processed on farm, skipping.")
-            return
-
-        # Collect the out set nodes
-        out_sets = [node for node in instance if node.endswith("out_SET")]
-        if len(out_sets) != 1:
-            raise RuntimeError("Couldn't find exactly one out_SET: "
-                               "{0}".format(out_sets))
-        out_set = out_sets[0]
-        roots = cmds.sets(out_set, query=True)
-
-        # Include all descendants
-        nodes = roots + cmds.listRelatives(roots,
-                                           allDescendents=True,
-                                           fullPath=True) or []
-
-        # Collect the start and end including handles
-        start = instance.data["frameStartHandle"]
-        end = instance.data["frameEndHandle"]
-
-        self.log.info("Extracting animation..")
-        dirname = self.staging_dir(instance)
-
-        parent_dir = self.staging_dir(instance)
-        filename = "{name}.abc".format(**instance.data)
-        path = os.path.join(parent_dir, filename)
-
-        options = {
-            "step": instance.data.get("step", 1.0) or 1.0,
-            "attr": ["cbId"],
-            "writeVisibility": True,
-            "writeCreases": True,
-            "uvWrite": True,
-            "selection": True,
-            "worldSpace": instance.data.get("worldSpace", True),
-            "writeColorSets": instance.data.get("writeColorSets", False),
-            "writeFaceSets": instance.data.get("writeFaceSets", False)
-        }
-
-        if not instance.data.get("includeParentHierarchy", True):
-            # Set the root nodes if we don't want to include parents
-            # The roots are to be considered the ones that are the actual
-            # direct members of the set
-            options["root"] = roots
-
-        if int(cmds.about(version=True)) >= 2017:
-            # Since Maya 2017 alembic supports multiple uv sets - write them.
-            options["writeUVSets"] = True
-
-        if instance.data.get("visibleOnly", False):
-            # If we only want to include nodes that are visible in the frame
-            # range then we need to do our own check. Alembic's `visibleOnly`
-            # flag does not filter out those that are only hidden on some
-            # frames as it counts "animated" or "connected" visibilities as
-            # if it's always visible.
-            nodes = list(iter_visible_in_frame_range(nodes,
-                                                     start=start,
-                                                     end=end))
-
-        with suspended_refresh():
-            with maintained_selection():
-                cmds.select(nodes, noExpand=True)
-                extract_alembic(file=path,
-                                startFrame=float(start),
-                                endFrame=float(end),
-                                **options)
-
-        if "representations" not in instance.data:
-            instance.data["representations"] = []
-
-        representation = {
-            'name': 'abc',
-            'ext': 'abc',
-            'files': filename,
-            "stagingDir": dirname,
-        }
-        instance.data["representations"].append(representation)
-
-        instance.context.data["cleanupFullPaths"].append(path)
-
-        self.log.info("Extracted {} to {}".format(instance, dirname))
diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index 7aa3aaee2a..a7ba5b3745 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -33,7 +33,7 @@ class ExtractAlembic(openpype.api.Extractor):
             self.log.debug("Should be processed on farm, skipping.")
             return
 
-        nodes = instance[:]
+        nodes, roots = self.get_members_and_roots(instance)
 
         # Collect the start and end including handles
         start = float(instance.data.get("frameStartHandle", 1))
@@ -46,10 +46,6 @@ class ExtractAlembic(openpype.api.Extractor):
         attr_prefixes = instance.data.get("attrPrefix", "").split(";")
         attr_prefixes = [value for value in attr_prefixes if value.strip()]
 
-        # Get extra export arguments
-        writeColorSets = instance.data.get("writeColorSets", False)
-        writeFaceSets = instance.data.get("writeFaceSets", False)
-
         self.log.info("Extracting pointcache..")
         dirname = self.staging_dir(instance)
 
@@ -63,8 +59,8 @@ class ExtractAlembic(openpype.api.Extractor):
             "attrPrefix": attr_prefixes,
             "writeVisibility": True,
             "writeCreases": True,
-            "writeColorSets": writeColorSets,
-            "writeFaceSets": writeFaceSets,
+            "writeColorSets": instance.data.get("writeColorSets", False),
+            "writeFaceSets": instance.data.get("writeFaceSets", False),
             "uvWrite": True,
             "selection": True,
             "worldSpace": instance.data.get("worldSpace", True)
@@ -74,7 +70,7 @@ class ExtractAlembic(openpype.api.Extractor):
             # Set the root nodes if we don't want to include parents
             # The roots are to be considered the ones that are the actual
             # direct members of the set
-            options["root"] = instance.data.get("setMembers")
+            options["root"] = roots
 
         if int(cmds.about(version=True)) >= 2017:
             # Since Maya 2017 alembic supports multiple uv sets - write them.
@@ -112,3 +108,29 @@ class ExtractAlembic(openpype.api.Extractor):
         instance.context.data["cleanupFullPaths"].append(path)
 
         self.log.info("Extracted {} to {}".format(instance, dirname))
+
+    def get_members_and_roots(self, instance):
+        return instance[:], instance.data.get("setMembers")
+
+
+class ExtractAnimation(ExtractAlembic):
+    label = "Extract Animation"
+    families = ["animation"]
+
+    def get_members_and_roots(self, instance):
+
+        # Collect the out set nodes
+        out_sets = [node for node in instance if node.endswith("out_SET")]
+        if len(out_sets) != 1:
+            raise RuntimeError("Couldn't find exactly one out_SET: "
+                               "{0}".format(out_sets))
+        out_set = out_sets[0]
+        roots = cmds.sets(out_set, query=True)
+
+        # Include all descendants
+        nodes = roots + cmds.listRelatives(roots,
+                                           allDescendents=True,
+                                           fullPath=True) or []
+
+        return nodes, roots
+

From af2c57674eb9263587ec082db70e12f69ccf2555 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 15:21:21 +0200
Subject: [PATCH 0911/1227] use new Anatomy source in tools

---
 openpype/tools/loader/widgets.py         | 3 +--
 openpype/tools/texture_copy/app.py       | 3 +--
 openpype/tools/workfiles/files_widget.py | 2 +-
 3 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/openpype/tools/loader/widgets.py b/openpype/tools/loader/widgets.py
index 1f6d8b9fa2..13e18b3757 100644
--- a/openpype/tools/loader/widgets.py
+++ b/openpype/tools/loader/widgets.py
@@ -17,8 +17,7 @@ from openpype.client import (
     get_thumbnail_id_from_source,
     get_thumbnail,
 )
-from openpype.api import Anatomy
-from openpype.pipeline import HeroVersionType
+from openpype.pipeline import HeroVersionType, Anatomy
 from openpype.pipeline.thumbnail import get_thumbnail_binary
 from openpype.pipeline.load import (
     discover_loader_plugins,
diff --git a/openpype/tools/texture_copy/app.py b/openpype/tools/texture_copy/app.py
index 746a72b3ec..a695bb8c4d 100644
--- a/openpype/tools/texture_copy/app.py
+++ b/openpype/tools/texture_copy/app.py
@@ -6,8 +6,7 @@ import speedcopy
 
 from openpype.client import get_project, get_asset_by_name
 from openpype.lib import Terminal
-from openpype.api import Anatomy
-from openpype.pipeline import legacy_io
+from openpype.pipeline import legacy_io, Anatomy
 
 
 t = Terminal()
diff --git a/openpype/tools/workfiles/files_widget.py b/openpype/tools/workfiles/files_widget.py
index a7e54471dc..c92e4fe904 100644
--- a/openpype/tools/workfiles/files_widget.py
+++ b/openpype/tools/workfiles/files_widget.py
@@ -11,7 +11,6 @@ from openpype.tools.utils import PlaceholderLineEdit
 from openpype.tools.utils.delegates import PrettyTimeDelegate
 from openpype.lib import (
     emit_event,
-    Anatomy,
     get_workfile_template_key,
     create_workdir_extra_folders,
 )
@@ -22,6 +21,7 @@ from openpype.lib.avalon_context import (
 from openpype.pipeline import (
     registered_host,
     legacy_io,
+    Anatomy,
 )
 from .model import (
     WorkAreaFilesModel,

From b6ea950b3a091053b034d90ce82f421e9cb25be9 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 15:22:49 +0200
Subject: [PATCH 0912/1227] use new Anatomy import in rest of pipeline

---
 openpype/pipeline/context_tools.py           | 7 ++-----
 openpype/pipeline/load/utils.py              | 2 +-
 openpype/plugins/load/delete_old_versions.py | 3 +--
 openpype/plugins/load/delivery.py            | 4 ++--
 4 files changed, 6 insertions(+), 10 deletions(-)

diff --git a/openpype/pipeline/context_tools.py b/openpype/pipeline/context_tools.py
index 4a147c230b..047482f6ff 100644
--- a/openpype/pipeline/context_tools.py
+++ b/openpype/pipeline/context_tools.py
@@ -14,11 +14,8 @@ from pyblish.lib import MessageHandler
 import openpype
 from openpype.modules import load_modules, ModulesManager
 from openpype.settings import get_project_settings
-from openpype.lib import (
-    Anatomy,
-    filter_pyblish_plugins,
-)
-
+from openpype.lib import filter_pyblish_plugins
+from .anatomy import Anatomy
 from . import (
     legacy_io,
     register_loader_plugin_path,
diff --git a/openpype/pipeline/load/utils.py b/openpype/pipeline/load/utils.py
index 99e5d11f82..e813b7934f 100644
--- a/openpype/pipeline/load/utils.py
+++ b/openpype/pipeline/load/utils.py
@@ -9,10 +9,10 @@ import numbers
 import six
 from bson.objectid import ObjectId
 
-from openpype.lib import Anatomy
 from openpype.pipeline import (
     schema,
     legacy_io,
+    Anatomy,
 )
 
 log = logging.getLogger(__name__)
diff --git a/openpype/plugins/load/delete_old_versions.py b/openpype/plugins/load/delete_old_versions.py
index c3e9e9fa0a..7465f53855 100644
--- a/openpype/plugins/load/delete_old_versions.py
+++ b/openpype/plugins/load/delete_old_versions.py
@@ -9,9 +9,8 @@ import qargparse
 from Qt import QtWidgets, QtCore
 
 from openpype import style
-from openpype.pipeline import load, AvalonMongoDB
+from openpype.pipeline import load, AvalonMongoDB, Anatomy
 from openpype.lib import StringTemplate
-from openpype.api import Anatomy
 
 
 class DeleteOldVersions(load.SubsetLoaderPlugin):
diff --git a/openpype/plugins/load/delivery.py b/openpype/plugins/load/delivery.py
index 7df07e3f64..0361ab2be5 100644
--- a/openpype/plugins/load/delivery.py
+++ b/openpype/plugins/load/delivery.py
@@ -3,8 +3,8 @@ from collections import defaultdict
 
 from Qt import QtWidgets, QtCore, QtGui
 
-from openpype.pipeline import load, AvalonMongoDB
-from openpype.api import Anatomy, config
+from openpype.lib import config
+from openpype.pipeline import load, AvalonMongoDB, Anatomy
 from openpype import resources, style
 
 from openpype.lib.delivery import (

From 168c3b38a46d656f31c14b940fbd6b533a926766 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 15:28:59 +0200
Subject: [PATCH 0913/1227] modified imports in sync server

---
 openpype/modules/sync_server/providers/local_drive.py |  5 +++--
 openpype/modules/sync_server/sync_server_module.py    | 10 ++++------
 2 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/openpype/modules/sync_server/providers/local_drive.py b/openpype/modules/sync_server/providers/local_drive.py
index 68f604b39c..172cb338cf 100644
--- a/openpype/modules/sync_server/providers/local_drive.py
+++ b/openpype/modules/sync_server/providers/local_drive.py
@@ -4,10 +4,11 @@ import shutil
 import threading
 import time
 
-from openpype.api import Logger, Anatomy
+from openpype.api import Logger
+from openpype.pipeline import Anatomy
 from .abstract_provider import AbstractProvider
 
-log = Logger().get_logger("SyncServer")
+log = Logger.get_logger("SyncServer")
 
 
 class LocalDriveHandler(AbstractProvider):
diff --git a/openpype/modules/sync_server/sync_server_module.py b/openpype/modules/sync_server/sync_server_module.py
index 698b296a52..4027561d22 100644
--- a/openpype/modules/sync_server/sync_server_module.py
+++ b/openpype/modules/sync_server/sync_server_module.py
@@ -9,14 +9,12 @@ from collections import deque, defaultdict
 
 from openpype.modules import OpenPypeModule
 from openpype_interfaces import ITrayModule
-from openpype.api import (
-    Anatomy,
+from openpype.settings import (
     get_project_settings,
     get_system_settings,
-    get_local_site_id
 )
-from openpype.lib import PypeLogger
-from openpype.pipeline import AvalonMongoDB
+from openpype.lib import PypeLogger, get_local_site_id
+from openpype.pipeline import AvalonMongoDB, Anatomy
 from openpype.settings.lib import (
     get_default_anatomy_settings,
     get_anatomy_settings
@@ -28,7 +26,7 @@ from .providers import lib
 from .utils import time_function, SyncStatus, SiteAlreadyPresentError
 
 
-log = PypeLogger().get_logger("SyncServer")
+log = PypeLogger.get_logger("SyncServer")
 
 
 class SyncServerModule(OpenPypeModule, ITrayModule):

From 05fe6ca5cf53802a2fffd55282ef011341023637 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 15:29:23 +0200
Subject: [PATCH 0914/1227] collect anatomy objec plugin is using new Anatomy
 import

---
 openpype/plugins/publish/collect_anatomy_object.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/collect_anatomy_object.py b/openpype/plugins/publish/collect_anatomy_object.py
index 2c87918728..b1415098b6 100644
--- a/openpype/plugins/publish/collect_anatomy_object.py
+++ b/openpype/plugins/publish/collect_anatomy_object.py
@@ -4,11 +4,11 @@ Requires:
     os.environ -> AVALON_PROJECT
 
 Provides:
-    context -> anatomy (pype.api.Anatomy)
+    context -> anatomy (openpype.pipeline.anatomy.Anatomy)
 """
 import os
-from openpype.api import Anatomy
 import pyblish.api
+from openpype.pipeline import Anatomy
 
 
 class CollectAnatomyObject(pyblish.api.ContextPlugin):

From 7bcc7277c394a408ad289a90c131fe8e807eff2f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 15:29:59 +0200
Subject: [PATCH 0915/1227] ftrack is using new source of anatomy

---
 .../ftrack/event_handlers_server/event_user_assigment.py      | 4 ++--
 .../ftrack/event_handlers_user/action_create_folders.py       | 2 +-
 .../ftrack/event_handlers_user/action_delete_old_versions.py  | 3 +--
 .../modules/ftrack/event_handlers_user/action_delivery.py     | 3 ++-
 .../ftrack/event_handlers_user/action_fill_workfile_attr.py   | 4 ++--
 openpype/modules/ftrack/event_handlers_user/action_rv.py      | 2 +-
 .../event_handlers_user/action_store_thumbnails_to_avalon.py  | 3 +--
 7 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/event_user_assigment.py b/openpype/modules/ftrack/event_handlers_server/event_user_assigment.py
index 82b79e986b..88d252e8cf 100644
--- a/openpype/modules/ftrack/event_handlers_server/event_user_assigment.py
+++ b/openpype/modules/ftrack/event_handlers_server/event_user_assigment.py
@@ -2,11 +2,11 @@ import re
 import subprocess
 
 from openpype.client import get_asset_by_id, get_asset_by_name
+from openpype.settings import get_project_settings
+from openpype.pipeline import Anatomy
 from openpype_modules.ftrack.lib import BaseEvent
 from openpype_modules.ftrack.lib.avalon_sync import CUST_ATTR_ID_KEY
 
-from openpype.api import Anatomy, get_project_settings
-
 
 class UserAssigmentEvent(BaseEvent):
     """
diff --git a/openpype/modules/ftrack/event_handlers_user/action_create_folders.py b/openpype/modules/ftrack/event_handlers_user/action_create_folders.py
index 81f38e0c39..9806f83773 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_create_folders.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_create_folders.py
@@ -1,7 +1,7 @@
 import os
 import collections
 import copy
-from openpype.api import Anatomy
+from openpype.pipeline import Anatomy
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 
 
diff --git a/openpype/modules/ftrack/event_handlers_user/action_delete_old_versions.py b/openpype/modules/ftrack/event_handlers_user/action_delete_old_versions.py
index 3400c509ab..79d04a7854 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_delete_old_versions.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_delete_old_versions.py
@@ -11,9 +11,8 @@ from openpype.client import (
     get_versions,
     get_representations
 )
-from openpype.api import Anatomy
 from openpype.lib import StringTemplate, TemplateUnsolved
-from openpype.pipeline import AvalonMongoDB
+from openpype.pipeline import AvalonMongoDB, Anatomy
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 
 
diff --git a/openpype/modules/ftrack/event_handlers_user/action_delivery.py b/openpype/modules/ftrack/event_handlers_user/action_delivery.py
index 4b799b092b..ad82af39a3 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_delivery.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_delivery.py
@@ -10,12 +10,13 @@ from openpype.client import (
     get_versions,
     get_representations
 )
-from openpype.api import Anatomy, config
+from openpype.pipeline import Anatomy
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 from openpype_modules.ftrack.lib.avalon_sync import CUST_ATTR_ID_KEY
 from openpype_modules.ftrack.lib.custom_attributes import (
     query_custom_attributes
 )
+from openpype.lib import config
 from openpype.lib.delivery import (
     path_from_representation,
     get_format_dict,
diff --git a/openpype/modules/ftrack/event_handlers_user/action_fill_workfile_attr.py b/openpype/modules/ftrack/event_handlers_user/action_fill_workfile_attr.py
index d30c41a749..d91649d7ba 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_fill_workfile_attr.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_fill_workfile_attr.py
@@ -11,13 +11,13 @@ from openpype.client import (
     get_project,
     get_assets,
 )
-from openpype.api import get_project_settings
+from openpype.settings import get_project_settings
 from openpype.lib import (
     get_workfile_template_key,
     get_workdir_data,
-    Anatomy,
     StringTemplate,
 )
+from openpype.pipeline import Anatomy
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 from openpype_modules.ftrack.lib.avalon_sync import create_chunks
 
diff --git a/openpype/modules/ftrack/event_handlers_user/action_rv.py b/openpype/modules/ftrack/event_handlers_user/action_rv.py
index 2480ea7f95..d05f0c47f6 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_rv.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_rv.py
@@ -11,10 +11,10 @@ from openpype.client import (
     get_version_by_name,
     get_representation_by_name
 )
-from openpype.api import Anatomy
 from openpype.pipeline import (
     get_representation_path,
     AvalonMongoDB,
+    Anatomy,
 )
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 
diff --git a/openpype/modules/ftrack/event_handlers_user/action_store_thumbnails_to_avalon.py b/openpype/modules/ftrack/event_handlers_user/action_store_thumbnails_to_avalon.py
index d655dddcaf..8748f426bd 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_store_thumbnails_to_avalon.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_store_thumbnails_to_avalon.py
@@ -14,8 +14,7 @@ from openpype.client import (
     get_representations
 )
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
-from openpype.api import Anatomy
-from openpype.pipeline import AvalonMongoDB
+from openpype.pipeline import AvalonMongoDB, Anatomy
 
 from openpype_modules.ftrack.lib.avalon_sync import CUST_ATTR_ID_KEY
 

From b4daf3bf769df737d31246fe3adaefeedb48b5c7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 29 Jun 2022 15:32:48 +0200
Subject: [PATCH 0916/1227] use new anatomy source in hosts

---
 openpype/hooks/pre_global_host_data.py                    | 3 +--
 openpype/hosts/hiero/api/lib.py                           | 5 +++--
 .../vendor/husdoutputprocessors/avalon_uri_processor.py   | 3 +--
 openpype/hosts/maya/api/plugin.py                         | 2 +-
 openpype/hosts/nuke/api/lib.py                            | 8 +++++---
 openpype/hosts/tvpaint/plugins/load/load_workfile.py      | 2 +-
 openpype/hosts/unreal/api/rendering.py                    | 2 +-
 .../unreal/plugins/publish/collect_render_instances.py    | 2 +-
 .../deadline/plugins/publish/submit_publish_job.py        | 2 +-
 9 files changed, 15 insertions(+), 14 deletions(-)

diff --git a/openpype/hooks/pre_global_host_data.py b/openpype/hooks/pre_global_host_data.py
index ea5e290d6f..6577e37cbe 100644
--- a/openpype/hooks/pre_global_host_data.py
+++ b/openpype/hooks/pre_global_host_data.py
@@ -1,11 +1,10 @@
-from openpype.api import Anatomy
 from openpype.lib import (
     PreLaunchHook,
     EnvironmentPrepData,
     prepare_app_environments,
     prepare_context_environments
 )
-from openpype.pipeline import AvalonMongoDB
+from openpype.pipeline import AvalonMongoDB, Anatomy
 
 
 class GlobalHostDataHook(PreLaunchHook):
diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index 8c8c31bc4c..2f66f3ddd7 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -19,8 +19,9 @@ from openpype.client import (
     get_last_versions,
     get_representations,
 )
-from openpype.pipeline import legacy_io
-from openpype.api import (Logger, Anatomy, get_anatomy_settings)
+from openpype.settings import get_anatomy_settings
+from openpype.pipeline import legacy_io, Anatomy
+from openpype.api import Logger
 from . import tags
 
 try:
diff --git a/openpype/hosts/houdini/vendor/husdoutputprocessors/avalon_uri_processor.py b/openpype/hosts/houdini/vendor/husdoutputprocessors/avalon_uri_processor.py
index 202287f1c3..d7d1c79d73 100644
--- a/openpype/hosts/houdini/vendor/husdoutputprocessors/avalon_uri_processor.py
+++ b/openpype/hosts/houdini/vendor/husdoutputprocessors/avalon_uri_processor.py
@@ -5,8 +5,7 @@ import husdoutputprocessors.base as base
 import colorbleed.usdlib as usdlib
 
 from openpype.client import get_asset_by_name
-from openpype.api import Anatomy
-from openpype.pipeline import legacy_io
+from openpype.pipeline import legacy_io, Anatomy
 
 
 class AvalonURIOutputProcessor(base.OutputProcessorBase):
diff --git a/openpype/hosts/maya/api/plugin.py b/openpype/hosts/maya/api/plugin.py
index f05893a7b4..9280805945 100644
--- a/openpype/hosts/maya/api/plugin.py
+++ b/openpype/hosts/maya/api/plugin.py
@@ -9,8 +9,8 @@ from openpype.pipeline import (
     LoaderPlugin,
     get_representation_path,
     AVALON_CONTAINER_ID,
+    Anatomy,
 )
-from openpype.api import Anatomy
 from openpype.settings import get_project_settings
 from .pipeline import containerise
 from . import lib
diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 45a1e72703..f565ec8546 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -20,21 +20,23 @@ from openpype.client import (
 )
 from openpype.api import (
     Logger,
-    Anatomy,
     BuildWorkfile,
     get_version_from_path,
-    get_anatomy_settings,
     get_workdir_data,
     get_asset,
     get_current_project_settings,
 )
 from openpype.tools.utils import host_tools
 from openpype.lib.path_tools import HostDirmap
-from openpype.settings import get_project_settings
+from openpype.settings import (
+    get_project_settings,
+    get_anatomy_settings,
+)
 from openpype.modules import ModulesManager
 from openpype.pipeline import (
     discover_legacy_creator_plugins,
     legacy_io,
+    Anatomy,
 )
 
 from . import gizmo_menu
diff --git a/openpype/hosts/tvpaint/plugins/load/load_workfile.py b/openpype/hosts/tvpaint/plugins/load/load_workfile.py
index 462f12abf0..c6dc765a27 100644
--- a/openpype/hosts/tvpaint/plugins/load/load_workfile.py
+++ b/openpype/hosts/tvpaint/plugins/load/load_workfile.py
@@ -10,8 +10,8 @@ from openpype.lib import (
 from openpype.pipeline import (
     registered_host,
     legacy_io,
+    Anatomy,
 )
-from openpype.api import Anatomy
 from openpype.hosts.tvpaint.api import lib, pipeline, plugin
 
 
diff --git a/openpype/hosts/unreal/api/rendering.py b/openpype/hosts/unreal/api/rendering.py
index b2732506fc..29e4747f6e 100644
--- a/openpype/hosts/unreal/api/rendering.py
+++ b/openpype/hosts/unreal/api/rendering.py
@@ -2,7 +2,7 @@ import os
 
 import unreal
 
-from openpype.api import Anatomy
+from openpype.pipeline import Anatomy
 from openpype.hosts.unreal.api import pipeline
 
 
diff --git a/openpype/hosts/unreal/plugins/publish/collect_render_instances.py b/openpype/hosts/unreal/plugins/publish/collect_render_instances.py
index 9fb45ea7a7..cb28f4bf60 100644
--- a/openpype/hosts/unreal/plugins/publish/collect_render_instances.py
+++ b/openpype/hosts/unreal/plugins/publish/collect_render_instances.py
@@ -3,7 +3,7 @@ from pathlib import Path
 
 import unreal
 
-from openpype.api import Anatomy
+from openpype.pipeline import Anatomy
 from openpype.hosts.unreal.api import pipeline
 import pyblish.api
 
diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index b54b00d099..9dd1428a63 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -1045,7 +1045,7 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
                     get publish_path
 
         Args:
-            anatomy (pype.lib.anatomy.Anatomy):
+            anatomy (openpype.pipeline.anatomy.Anatomy):
             template_data (dict): pre-calculated collected data for process
             asset (string): asset name
             subset (string): subset name (actually group name of subset)

From 19a5ed7be3967bd3ea25167c11b802275e20ac5b Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 29 Jun 2022 17:22:21 +0200
Subject: [PATCH 0917/1227] Refactor `iter_visible_in_frame_range` ->
 `iter_visible_nodes_in_range`

---
 openpype/hosts/maya/api/lib.py                               | 2 +-
 openpype/hosts/maya/plugins/publish/extract_animation.py     | 4 ++--
 openpype/hosts/maya/plugins/publish/extract_pointcache.py    | 4 ++--
 openpype/hosts/maya/plugins/publish/validate_visible_only.py | 4 ++--
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 43f738bfc7..34340a13a5 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -3224,7 +3224,7 @@ def maintained_time():
         cmds.currentTime(ct, edit=True)
 
 
-def iter_visible_in_frame_range(nodes, start, end):
+def iter_visible_nodes_in_range(nodes, start, end):
     """Yield nodes that are visible in start-end frame range.
 
     - Ignores intermediateObjects completely.
diff --git a/openpype/hosts/maya/plugins/publish/extract_animation.py b/openpype/hosts/maya/plugins/publish/extract_animation.py
index b0beb5968e..8ed2d8d7a3 100644
--- a/openpype/hosts/maya/plugins/publish/extract_animation.py
+++ b/openpype/hosts/maya/plugins/publish/extract_animation.py
@@ -7,7 +7,7 @@ from openpype.hosts.maya.api.lib import (
     extract_alembic,
     suspended_refresh,
     maintained_selection,
-    iter_visible_in_frame_range
+    iter_visible_nodes_in_range
 )
 
 
@@ -83,7 +83,7 @@ class ExtractAnimation(openpype.api.Extractor):
             # flag does not filter out those that are only hidden on some
             # frames as it counts "animated" or "connected" visibilities as
             # if it's always visible.
-            nodes = list(iter_visible_in_frame_range(nodes,
+            nodes = list(iter_visible_nodes_in_range(nodes,
                                                      start=start,
                                                      end=end))
 
diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index 7aa3aaee2a..775b5e9939 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -7,7 +7,7 @@ from openpype.hosts.maya.api.lib import (
     extract_alembic,
     suspended_refresh,
     maintained_selection,
-    iter_visible_in_frame_range
+    iter_visible_nodes_in_range
 )
 
 
@@ -86,7 +86,7 @@ class ExtractAlembic(openpype.api.Extractor):
             # flag does not filter out those that are only hidden on some
             # frames as it counts "animated" or "connected" visibilities as
             # if it's always visible.
-            nodes = list(iter_visible_in_frame_range(nodes,
+            nodes = list(iter_visible_nodes_in_range(nodes,
                                                      start=start,
                                                      end=end))
 
diff --git a/openpype/hosts/maya/plugins/publish/validate_visible_only.py b/openpype/hosts/maya/plugins/publish/validate_visible_only.py
index 2a10171113..59a7f976ab 100644
--- a/openpype/hosts/maya/plugins/publish/validate_visible_only.py
+++ b/openpype/hosts/maya/plugins/publish/validate_visible_only.py
@@ -1,7 +1,7 @@
 import pyblish.api
 
 import openpype.api
-from openpype.hosts.maya.api.lib import iter_visible_in_frame_range
+from openpype.hosts.maya.api.lib import iter_visible_nodes_in_range
 import openpype.hosts.maya.api.action
 
 
@@ -40,7 +40,7 @@ class ValidateAlembicVisibleOnly(pyblish.api.InstancePlugin):
             nodes = instance[:]
 
         start, end = cls.get_frame_range(instance)
-        if not any(iter_visible_in_frame_range(nodes, start, end)):
+        if not any(iter_visible_nodes_in_range(nodes, start, end)):
             # Return the nodes we have considered so the user can identify
             # them with the select invalid action
             return nodes

From c0b03113a5e126d2afeee462eb8df51e031a2962 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 30 Jun 2022 10:21:25 +0200
Subject: [PATCH 0918/1227] Added minimal permissions for MongoDB

Collected from Discord discussions.
---
 website/docs/admin_use.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/website/docs/admin_use.md b/website/docs/admin_use.md
index f84905c486..1c4ae9e01c 100644
--- a/website/docs/admin_use.md
+++ b/website/docs/admin_use.md
@@ -105,6 +105,10 @@ save it in secure way to your systems keyring - on Windows it is **Credential Ma
 This can be also set beforehand with environment variable `OPENPYPE_MONGO`. If set it takes precedence
 over the one set in keyring.
 
+:::tip Minimal permissions for DB user
+- `readWrite` role to `openpype` and `avalon` databases
+- `find` permission on `openpype`, `avalon` and `local`
+  
 #### Check for OpenPype version path
 When connection to MongoDB is made, OpenPype will get various settings from there - one among them is
 directory location where OpenPype versions are stored. If this directory exists OpenPype tries to

From 5822275b6c565a9852ce4a4f824befb1c7c5efe1 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 10:34:36 +0200
Subject: [PATCH 0919/1227] move abstract meta pyblish class into
 openpype.pipeline.publish

---
 openpype/lib/abstract_metaplugins.py         | 35 +++++++++++++++++---
 openpype/pipeline/publish/__init__.py        |  6 ++++
 openpype/pipeline/publish/publish_plugins.py | 14 ++++++++
 3 files changed, 50 insertions(+), 5 deletions(-)

diff --git a/openpype/lib/abstract_metaplugins.py b/openpype/lib/abstract_metaplugins.py
index f8163956ad..6199a96ef1 100644
--- a/openpype/lib/abstract_metaplugins.py
+++ b/openpype/lib/abstract_metaplugins.py
@@ -1,10 +1,35 @@
-from abc import ABCMeta
-from pyblish.plugin import MetaPlugin, ExplicitMetaPlugin
+"""Content was moved to 'openpype.pipeline.farm.abstract_metaplugins'.
+
+Please change your imports as soon as possible.
+
+File will be probably removed in OpenPype 3.14.*
+"""
+
+import warnings
+from openpype.pipeline.publish import (
+    AbstractMetaInstancePlugin,
+    AbstractMetaContextPlugin
+)
 
 
-class AbstractMetaInstancePlugin(ABCMeta, MetaPlugin):
+class MetaPluginsDeprecated(DeprecationWarning):
     pass
 
 
-class AbstractMetaContextPlugin(ABCMeta, ExplicitMetaPlugin):
-    pass
+warnings.simplefilter("always", MetaPluginsDeprecated)
+warnings.warn(
+    (
+        "Content of 'abstract_metaplugins' was moved."
+        "\nUsing deprecated source of 'abstract_metaplugins'. Content was"
+        " moved to 'openpype.pipeline.farm.abstract_metaplugins'."
+        " Please change your imports as soon as possible."
+    ),
+    category=MetaPluginsDeprecated,
+    stacklevel=4
+)
+
+
+__all__ = (
+    "AbstractMetaInstancePlugin",
+    "AbstractMetaContextPlugin",
+)
diff --git a/openpype/pipeline/publish/__init__.py b/openpype/pipeline/publish/__init__.py
index af5d7c4a91..03d730f37a 100644
--- a/openpype/pipeline/publish/__init__.py
+++ b/openpype/pipeline/publish/__init__.py
@@ -1,4 +1,7 @@
 from .publish_plugins import (
+    AbstractMetaInstancePlugin,
+    AbstractMetaContextPlugin,
+
     PublishValidationError,
     PublishXmlValidationError,
     KnownPublishError,
@@ -15,6 +18,9 @@ from .lib import (
 
 
 __all__ = (
+    "AbstractMetaInstancePlugin",
+    "AbstractMetaContextPlugin",
+
     "PublishValidationError",
     "PublishXmlValidationError",
     "KnownPublishError",
diff --git a/openpype/pipeline/publish/publish_plugins.py b/openpype/pipeline/publish/publish_plugins.py
index 2402a005c2..71a2c675b6 100644
--- a/openpype/pipeline/publish/publish_plugins.py
+++ b/openpype/pipeline/publish/publish_plugins.py
@@ -1,7 +1,17 @@
+from abc import ABCMeta
+from pyblish.plugin import MetaPlugin, ExplicitMetaPlugin
 from openpype.lib import BoolDef
 from .lib import load_help_content_from_plugin
 
 
+class AbstractMetaInstancePlugin(ABCMeta, MetaPlugin):
+    pass
+
+
+class AbstractMetaContextPlugin(ABCMeta, ExplicitMetaPlugin):
+    pass
+
+
 class PublishValidationError(Exception):
     """Validation error happened during publishing.
 
@@ -16,6 +26,7 @@ class PublishValidationError(Exception):
         description(str): Detailed description of an error. It is possible
             to use Markdown syntax.
     """
+
     def __init__(self, message, title=None, description=None, detail=None):
         self.message = message
         self.title = title or "< Missing title >"
@@ -49,6 +60,7 @@ class KnownPublishError(Exception):
 
     Message will be shown in UI for artist.
     """
+
     pass
 
 
@@ -92,6 +104,7 @@ class OpenPypePyblishPluginMixin:
         Returns:
             list<AbtractAttrDef>: Attribute definitions for plugin.
         """
+
         return []
 
     @classmethod
@@ -116,6 +129,7 @@ class OpenPypePyblishPluginMixin:
         Args:
             data(dict): Data from instance or context.
         """
+
         return (
             data
             .get("publish_attributes", {})

From 2d8c41cc6e6e53ecc21372f75bfd590397a33a28 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 10:39:05 +0200
Subject: [PATCH 0920/1227] moved render abstractions to
 openpype.pipeline.publish

---
 .../plugins/publish/collect_render.py         |   6 +-
 .../plugins/publish/collect_farm_render.py    |   8 +-
 openpype/lib/abstract_collect_render.py       | 280 ++----------------
 openpype/lib/abstract_expected_files.py       |  71 ++---
 .../deadline/abstract_submit_deadline.py      |   2 +-
 openpype/pipeline/publish/__init__.py         |  11 +
 .../publish/abstract_collect_render.py        | 268 +++++++++++++++++
 .../publish/abstract_expected_files.py        |  53 ++++
 8 files changed, 386 insertions(+), 313 deletions(-)
 create mode 100644 openpype/pipeline/publish/abstract_collect_render.py
 create mode 100644 openpype/pipeline/publish/abstract_expected_files.py

diff --git a/openpype/hosts/aftereffects/plugins/publish/collect_render.py b/openpype/hosts/aftereffects/plugins/publish/collect_render.py
index 97b3175c57..bb199a61f7 100644
--- a/openpype/hosts/aftereffects/plugins/publish/collect_render.py
+++ b/openpype/hosts/aftereffects/plugins/publish/collect_render.py
@@ -6,8 +6,8 @@ import attr
 import pyblish.api
 
 from openpype.settings import get_project_settings
-from openpype.lib import abstract_collect_render
-from openpype.lib.abstract_collect_render import RenderInstance
+from openpype.pipeline import publish
+from openpype.pipeline.publish import RenderInstance
 
 from openpype.hosts.aftereffects.api import get_stub
 
@@ -25,7 +25,7 @@ class AERenderInstance(RenderInstance):
     file_name = attr.ib(default=None)
 
 
-class CollectAERender(abstract_collect_render.AbstractCollectRender):
+class CollectAERender(publish.AbstractCollectRender):
 
     order = pyblish.api.CollectorOrder + 0.405
     label = "Collect After Effects Render Layers"
diff --git a/openpype/hosts/harmony/plugins/publish/collect_farm_render.py b/openpype/hosts/harmony/plugins/publish/collect_farm_render.py
index 3e9e680efd..f6b26eb3e8 100644
--- a/openpype/hosts/harmony/plugins/publish/collect_farm_render.py
+++ b/openpype/hosts/harmony/plugins/publish/collect_farm_render.py
@@ -4,11 +4,10 @@ from pathlib import Path
 
 import attr
 
-import openpype.lib
-import openpype.lib.abstract_collect_render
-from openpype.lib.abstract_collect_render import RenderInstance
 from openpype.lib import get_formatted_current_time
 from openpype.pipeline import legacy_io
+from openpype.pipeline import publish
+from openpype.pipeline.publish import RenderInstance
 import openpype.hosts.harmony.api as harmony
 
 
@@ -20,8 +19,7 @@ class HarmonyRenderInstance(RenderInstance):
     leadingZeros = attr.ib(default=3)
 
 
-class CollectFarmRender(openpype.lib.abstract_collect_render.
-                        AbstractCollectRender):
+class CollectFarmRender(publish.AbstractCollectRender):
     """Gather all publishable renders."""
 
     # https://docs.toonboom.com/help/harmony-17/premium/reference/node/output/write-node-image-formats.html
diff --git a/openpype/lib/abstract_collect_render.py b/openpype/lib/abstract_collect_render.py
index 3d81f6d794..2cc1c23822 100644
--- a/openpype/lib/abstract_collect_render.py
+++ b/openpype/lib/abstract_collect_render.py
@@ -1,269 +1,33 @@
 # -*- coding: utf-8 -*-
-"""Collect render template.
+"""Content was moved to 'openpype.pipeline.farm.abstract_collect_render'.
 
-TODO: use @dataclass when times come.
+Please change your imports as soon as possible.
 
+File will be probably removed in OpenPype 3.14.*
 """
-from abc import abstractmethod
 
-import attr
-import six
-
-import pyblish.api
-
-from openpype.pipeline import legacy_io
-
-from .abstract_metaplugins import AbstractMetaContextPlugin
+import warnings
+from openpype.pipeline.publish import AbstractCollectRender, RenderInstance
 
 
-@attr.s
-class RenderInstance(object):
-    """Data collected by collectors.
-
-    This data class later on passed to collected instances.
-    Those attributes are required later on.
-
-    """
-
-    # metadata
-    version = attr.ib()  # instance version
-    time = attr.ib()  # time of instance creation (get_formatted_current_time)
-    source = attr.ib()  # path to source scene file
-    label = attr.ib()  # label to show in GUI
-    subset = attr.ib()  # subset name
-    task = attr.ib()  # task name
-    asset = attr.ib()  # asset name (AVALON_ASSET)
-    attachTo = attr.ib()  # subset name to attach render to
-    setMembers = attr.ib()  # list of nodes/members producing render output
-    publish = attr.ib()  # bool, True to publish instance
-    name = attr.ib()  # instance name
-
-    # format settings
-    resolutionWidth = attr.ib()  # resolution width (1920)
-    resolutionHeight = attr.ib()  # resolution height (1080)
-    pixelAspect = attr.ib()  # pixel aspect (1.0)
-
-    # time settings
-    frameStart = attr.ib()  # start frame
-    frameEnd = attr.ib()  # start end
-    frameStep = attr.ib()  # frame step
-
-    handleStart = attr.ib(default=None)  # start frame
-    handleEnd = attr.ib(default=None)  # start frame
-
-    # for software (like Harmony) where frame range cannot be set by DB
-    # handles need to be propagated if exist
-    ignoreFrameHandleCheck = attr.ib(default=False)
-
-    # --------------------
-    # With default values
-    # metadata
-    renderer = attr.ib(default="")  # renderer - can be used in Deadline
-    review = attr.ib(default=False)  # generate review from instance (bool)
-    priority = attr.ib(default=50)  # job priority on farm
-
-    family = attr.ib(default="renderlayer")
-    families = attr.ib(default=["renderlayer"])  # list of families
-
-    # format settings
-    multipartExr = attr.ib(default=False)  # flag for multipart exrs
-    convertToScanline = attr.ib(default=False)  # flag for exr conversion
-
-    tileRendering = attr.ib(default=False)  # bool: treat render as tiles
-    tilesX = attr.ib(default=0)  # number of tiles in X
-    tilesY = attr.ib(default=0)  # number of tiles in Y
-
-    # submit_publish_job
-    toBeRenderedOn = attr.ib(default=None)
-    deadlineSubmissionJob = attr.ib(default=None)
-    anatomyData = attr.ib(default=None)
-    outputDir = attr.ib(default=None)
-    context = attr.ib(default=None)
-
-    @frameStart.validator
-    def check_frame_start(self, _, value):
-        """Validate if frame start is not larger then end."""
-        if value > self.frameEnd:
-            raise ValueError("frameStart must be smaller "
-                             "or equal then frameEnd")
-
-    @frameEnd.validator
-    def check_frame_end(self, _, value):
-        """Validate if frame end is not less then start."""
-        if value < self.frameStart:
-            raise ValueError("frameEnd must be smaller "
-                             "or equal then frameStart")
-
-    @tilesX.validator
-    def check_tiles_x(self, _, value):
-        """Validate if tile x isn't less then 1."""
-        if not self.tileRendering:
-            return
-        if value < 1:
-            raise ValueError("tile X size cannot be less then 1")
-
-        if value == 1 and self.tilesY == 1:
-            raise ValueError("both tiles X a Y sizes are set to 1")
-
-    @tilesY.validator
-    def check_tiles_y(self, _, value):
-        """Validate if tile y isn't less then 1."""
-        if not self.tileRendering:
-            return
-        if value < 1:
-            raise ValueError("tile Y size cannot be less then 1")
-
-        if value == 1 and self.tilesX == 1:
-            raise ValueError("both tiles X a Y sizes are set to 1")
+class CollectRenderDeprecated(DeprecationWarning):
+    pass
 
 
-@six.add_metaclass(AbstractMetaContextPlugin)
-class AbstractCollectRender(pyblish.api.ContextPlugin):
-    """Gather all publishable render layers from renderSetup."""
+warnings.simplefilter("always", CollectRenderDeprecated)
+warnings.warn(
+    (
+        "Content of 'abstract_collect_render' was moved."
+        "\nUsing deprecated source of 'abstract_collect_render'. Content was"
+        " move to 'openpype.pipeline.farm.abstract_collect_render'."
+        " Please change your imports as soon as possible."
+    ),
+    category=CollectRenderDeprecated,
+    stacklevel=4
+)
 
-    order = pyblish.api.CollectorOrder + 0.01
-    label = "Collect Render"
-    sync_workfile_version = False
 
-    def __init__(self, *args, **kwargs):
-        """Constructor."""
-        super(AbstractCollectRender, self).__init__(*args, **kwargs)
-        self._file_path = None
-        self._asset = legacy_io.Session["AVALON_ASSET"]
-        self._context = None
-
-    def process(self, context):
-        """Entry point to collector."""
-        self._context = context
-        for instance in context:
-            # make sure workfile instance publishing is enabled
-            try:
-                if "workfile" in instance.data["families"]:
-                    instance.data["publish"] = True
-                # TODO merge renderFarm and render.farm
-                if ("renderFarm" in instance.data["families"] or
-                        "render.farm" in instance.data["families"]):
-                    instance.data["remove"] = True
-            except KeyError:
-                # be tolerant if 'families' is missing.
-                pass
-
-        self._file_path = context.data["currentFile"].replace("\\", "/")
-
-        render_instances = self.get_instances(context)
-        for render_instance in render_instances:
-            exp_files = self.get_expected_files(render_instance)
-            assert exp_files, "no file names were generated, this is bug"
-
-            # if we want to attach render to subset, check if we have AOV's
-            # in expectedFiles. If so, raise error as we cannot attach AOV
-            # (considered to be subset on its own) to another subset
-            if render_instance.attachTo:
-                assert isinstance(exp_files, list), (
-                    "attaching multiple AOVs or renderable cameras to "
-                    "subset is not supported"
-                )
-
-            frame_start_render = int(render_instance.frameStart)
-            frame_end_render = int(render_instance.frameEnd)
-            if (render_instance.ignoreFrameHandleCheck or
-                    int(context.data['frameStartHandle']) == frame_start_render
-                    and int(context.data['frameEndHandle']) == frame_end_render):  # noqa: W503, E501
-
-                handle_start = context.data['handleStart']
-                handle_end = context.data['handleEnd']
-                frame_start = context.data['frameStart']
-                frame_end = context.data['frameEnd']
-                frame_start_handle = context.data['frameStartHandle']
-                frame_end_handle = context.data['frameEndHandle']
-            else:
-                handle_start = 0
-                handle_end = 0
-                frame_start = frame_start_render
-                frame_end = frame_end_render
-                frame_start_handle = frame_start_render
-                frame_end_handle = frame_end_render
-
-            data = {
-                "handleStart": handle_start,
-                "handleEnd": handle_end,
-                "frameStart": frame_start,
-                "frameEnd": frame_end,
-                "frameStartHandle": frame_start_handle,
-                "frameEndHandle": frame_end_handle,
-                "byFrameStep": int(render_instance.frameStep),
-
-                "author": context.data["user"],
-                # Add source to allow tracing back to the scene from
-                # which was submitted originally
-                "expectedFiles": exp_files,
-            }
-            if self.sync_workfile_version:
-                data["version"] = context.data["version"]
-
-            # add additional data
-            data = self.add_additional_data(data)
-            render_instance_dict = attr.asdict(render_instance)
-
-            instance = context.create_instance(render_instance.name)
-            instance.data["label"] = render_instance.label
-            instance.data.update(render_instance_dict)
-            instance.data.update(data)
-
-        self.post_collecting_action()
-
-    @abstractmethod
-    def get_instances(self, context):
-        """Get all renderable instances and their data.
-
-        Args:
-            context (pyblish.api.Context): Context object.
-
-        Returns:
-            list of :class:`RenderInstance`: All collected renderable instances
-                (like render layers, write nodes, etc.)
-
-        """
-        pass
-
-    @abstractmethod
-    def get_expected_files(self, render_instance):
-        """Get list of expected files.
-
-        Returns:
-            list: expected files. This can be either simple list of files with
-                their paths, or list of dictionaries, where key is name of AOV
-                for example and value is list of files for that AOV.
-
-        Example::
-
-            ['/path/to/file.001.exr', '/path/to/file.002.exr']
-
-            or as dictionary:
-
-            [
-                {
-                    "beauty": ['/path/to/beauty.001.exr', ...],
-                    "mask": ['/path/to/mask.001.exr']
-                }
-            ]
-
-        """
-        pass
-
-    def add_additional_data(self, data):
-        """Add additional data to collected instance.
-
-        This can be overridden by host implementation to add custom
-        additional data.
-
-        """
-        return data
-
-    def post_collecting_action(self):
-        """Execute some code after collection is done.
-
-        This is useful for example for restoring current render layer.
-
-        """
-        pass
+__all__ = (
+    "AbstractCollectRender",
+    "RenderInstance"
+)
diff --git a/openpype/lib/abstract_expected_files.py b/openpype/lib/abstract_expected_files.py
index f9f3c17ef5..bb433a8b11 100644
--- a/openpype/lib/abstract_expected_files.py
+++ b/openpype/lib/abstract_expected_files.py
@@ -1,53 +1,32 @@
 # -*- coding: utf-8 -*-
-"""Abstract ExpectedFile class definition."""
-from abc import ABCMeta, abstractmethod
-import six
+"""Content was moved to 'openpype.pipeline.farm.abstract_expected_files'.
+
+Please change your imports as soon as possible.
+
+File will be probably removed in OpenPype 3.14.*
+"""
+
+import warnings
+from openpype.pipeline.publish import ExpectedFiles
 
 
-@six.add_metaclass(ABCMeta)
-class ExpectedFiles:
-    """Class grouping functionality for all supported renderers.
-
-    Attributes:
-        multipart (bool): Flag if multipart exrs are used.
-
-    """
-
-    multipart = False
-
-    @abstractmethod
-    def get(self, render_instance):
-        """Get expected files for given renderer and render layer.
-
-        This method should return dictionary of all files we are expecting
-        to be rendered from the host. Usually `render_instance` corresponds
-        to *render layer*. Result can be either flat list with the file
-        paths or it can be list of dictionaries. Each key corresponds to
-        for example AOV name or channel, etc.
-
-        Example::
-
-            ['/path/to/file.001.exr', '/path/to/file.002.exr']
-
-            or as dictionary:
-
-            [
-                {
-                    "beauty": ['/path/to/beauty.001.exr', ...],
-                    "mask": ['/path/to/mask.001.exr']
-                }
-            ]
+class ExpectedFilesDeprecated(DeprecationWarning):
+    pass
 
 
-        Args:
-            render_instance (:class:`RenderInstance`): Data passed from
-                collector to determine files. This should be instance of
-                :class:`abstract_collect_render.RenderInstance`
+warnings.simplefilter("always", ExpectedFilesDeprecated)
+warnings.warn(
+    (
+        "Content of 'abstract_expected_files' was moved."
+        "\nUsing deprecated source of 'abstract_expected_files'. Content was"
+        " move to 'openpype.pipeline.farm.abstract_expected_files'."
+        " Please change your imports as soon as possible."
+    ),
+    category=ExpectedFilesDeprecated,
+    stacklevel=4
+)
 
-        Returns:
-            list: Full paths to expected rendered files.
-            list of dict: Path to expected rendered files categorized by
-                AOVs, etc.
 
-        """
-        raise NotImplementedError()
+__all__ = (
+    "ExpectedFiles",
+)
diff --git a/openpype/modules/deadline/abstract_submit_deadline.py b/openpype/modules/deadline/abstract_submit_deadline.py
index 22902d79ea..3f54273a56 100644
--- a/openpype/modules/deadline/abstract_submit_deadline.py
+++ b/openpype/modules/deadline/abstract_submit_deadline.py
@@ -15,7 +15,7 @@ import attr
 import requests
 
 import pyblish.api
-from openpype.lib.abstract_metaplugins import AbstractMetaInstancePlugin
+from openpype.pipeline.publish import AbstractMetaInstancePlugin
 
 
 def requests_post(*args, **kwargs):
diff --git a/openpype/pipeline/publish/__init__.py b/openpype/pipeline/publish/__init__.py
index 03d730f37a..aa7fe0bdbf 100644
--- a/openpype/pipeline/publish/__init__.py
+++ b/openpype/pipeline/publish/__init__.py
@@ -16,6 +16,12 @@ from .lib import (
     load_help_content_from_filepath,
 )
 
+from .abstract_expected_files import ExpectedFiles
+from .abstract_collect_render import (
+    RenderInstance,
+    AbstractCollectRender,
+)
+
 
 __all__ = (
     "AbstractMetaInstancePlugin",
@@ -31,4 +37,9 @@ __all__ = (
     "publish_plugins_discover",
     "load_help_content_from_plugin",
     "load_help_content_from_filepath",
+
+    "ExpectedFiles",
+
+    "RenderInstance",
+    "AbstractCollectRender",
 )
diff --git a/openpype/pipeline/publish/abstract_collect_render.py b/openpype/pipeline/publish/abstract_collect_render.py
new file mode 100644
index 0000000000..2e537227c3
--- /dev/null
+++ b/openpype/pipeline/publish/abstract_collect_render.py
@@ -0,0 +1,268 @@
+# -*- coding: utf-8 -*-
+"""Collect render template.
+
+TODO: use @dataclass when times come.
+
+"""
+from abc import abstractmethod
+
+import attr
+import six
+
+import pyblish.api
+
+from openpype.pipeline import legacy_io
+from .publish_plugins import AbstractMetaContextPlugin
+
+
+@attr.s
+class RenderInstance(object):
+    """Data collected by collectors.
+
+    This data class later on passed to collected instances.
+    Those attributes are required later on.
+
+    """
+
+    # metadata
+    version = attr.ib()  # instance version
+    time = attr.ib()  # time of instance creation (get_formatted_current_time)
+    source = attr.ib()  # path to source scene file
+    label = attr.ib()  # label to show in GUI
+    subset = attr.ib()  # subset name
+    task = attr.ib()  # task name
+    asset = attr.ib()  # asset name (AVALON_ASSET)
+    attachTo = attr.ib()  # subset name to attach render to
+    setMembers = attr.ib()  # list of nodes/members producing render output
+    publish = attr.ib()  # bool, True to publish instance
+    name = attr.ib()  # instance name
+
+    # format settings
+    resolutionWidth = attr.ib()  # resolution width (1920)
+    resolutionHeight = attr.ib()  # resolution height (1080)
+    pixelAspect = attr.ib()  # pixel aspect (1.0)
+
+    # time settings
+    frameStart = attr.ib()  # start frame
+    frameEnd = attr.ib()  # start end
+    frameStep = attr.ib()  # frame step
+
+    handleStart = attr.ib(default=None)  # start frame
+    handleEnd = attr.ib(default=None)  # start frame
+
+    # for software (like Harmony) where frame range cannot be set by DB
+    # handles need to be propagated if exist
+    ignoreFrameHandleCheck = attr.ib(default=False)
+
+    # --------------------
+    # With default values
+    # metadata
+    renderer = attr.ib(default="")  # renderer - can be used in Deadline
+    review = attr.ib(default=False)  # generate review from instance (bool)
+    priority = attr.ib(default=50)  # job priority on farm
+
+    family = attr.ib(default="renderlayer")
+    families = attr.ib(default=["renderlayer"])  # list of families
+
+    # format settings
+    multipartExr = attr.ib(default=False)  # flag for multipart exrs
+    convertToScanline = attr.ib(default=False)  # flag for exr conversion
+
+    tileRendering = attr.ib(default=False)  # bool: treat render as tiles
+    tilesX = attr.ib(default=0)  # number of tiles in X
+    tilesY = attr.ib(default=0)  # number of tiles in Y
+
+    # submit_publish_job
+    toBeRenderedOn = attr.ib(default=None)
+    deadlineSubmissionJob = attr.ib(default=None)
+    anatomyData = attr.ib(default=None)
+    outputDir = attr.ib(default=None)
+    context = attr.ib(default=None)
+
+    @frameStart.validator
+    def check_frame_start(self, _, value):
+        """Validate if frame start is not larger then end."""
+        if value > self.frameEnd:
+            raise ValueError("frameStart must be smaller "
+                             "or equal then frameEnd")
+
+    @frameEnd.validator
+    def check_frame_end(self, _, value):
+        """Validate if frame end is not less then start."""
+        if value < self.frameStart:
+            raise ValueError("frameEnd must be smaller "
+                             "or equal then frameStart")
+
+    @tilesX.validator
+    def check_tiles_x(self, _, value):
+        """Validate if tile x isn't less then 1."""
+        if not self.tileRendering:
+            return
+        if value < 1:
+            raise ValueError("tile X size cannot be less then 1")
+
+        if value == 1 and self.tilesY == 1:
+            raise ValueError("both tiles X a Y sizes are set to 1")
+
+    @tilesY.validator
+    def check_tiles_y(self, _, value):
+        """Validate if tile y isn't less then 1."""
+        if not self.tileRendering:
+            return
+        if value < 1:
+            raise ValueError("tile Y size cannot be less then 1")
+
+        if value == 1 and self.tilesX == 1:
+            raise ValueError("both tiles X a Y sizes are set to 1")
+
+
+@six.add_metaclass(AbstractMetaContextPlugin)
+class AbstractCollectRender(pyblish.api.ContextPlugin):
+    """Gather all publishable render layers from renderSetup."""
+
+    order = pyblish.api.CollectorOrder + 0.01
+    label = "Collect Render"
+    sync_workfile_version = False
+
+    def __init__(self, *args, **kwargs):
+        """Constructor."""
+        super(AbstractCollectRender, self).__init__(*args, **kwargs)
+        self._file_path = None
+        self._asset = legacy_io.Session["AVALON_ASSET"]
+        self._context = None
+
+    def process(self, context):
+        """Entry point to collector."""
+        self._context = context
+        for instance in context:
+            # make sure workfile instance publishing is enabled
+            try:
+                if "workfile" in instance.data["families"]:
+                    instance.data["publish"] = True
+                # TODO merge renderFarm and render.farm
+                if ("renderFarm" in instance.data["families"] or
+                        "render.farm" in instance.data["families"]):
+                    instance.data["remove"] = True
+            except KeyError:
+                # be tolerant if 'families' is missing.
+                pass
+
+        self._file_path = context.data["currentFile"].replace("\\", "/")
+
+        render_instances = self.get_instances(context)
+        for render_instance in render_instances:
+            exp_files = self.get_expected_files(render_instance)
+            assert exp_files, "no file names were generated, this is bug"
+
+            # if we want to attach render to subset, check if we have AOV's
+            # in expectedFiles. If so, raise error as we cannot attach AOV
+            # (considered to be subset on its own) to another subset
+            if render_instance.attachTo:
+                assert isinstance(exp_files, list), (
+                    "attaching multiple AOVs or renderable cameras to "
+                    "subset is not supported"
+                )
+
+            frame_start_render = int(render_instance.frameStart)
+            frame_end_render = int(render_instance.frameEnd)
+            if (render_instance.ignoreFrameHandleCheck or
+                    int(context.data['frameStartHandle']) == frame_start_render
+                    and int(context.data['frameEndHandle']) == frame_end_render):  # noqa: W503, E501
+
+                handle_start = context.data['handleStart']
+                handle_end = context.data['handleEnd']
+                frame_start = context.data['frameStart']
+                frame_end = context.data['frameEnd']
+                frame_start_handle = context.data['frameStartHandle']
+                frame_end_handle = context.data['frameEndHandle']
+            else:
+                handle_start = 0
+                handle_end = 0
+                frame_start = frame_start_render
+                frame_end = frame_end_render
+                frame_start_handle = frame_start_render
+                frame_end_handle = frame_end_render
+
+            data = {
+                "handleStart": handle_start,
+                "handleEnd": handle_end,
+                "frameStart": frame_start,
+                "frameEnd": frame_end,
+                "frameStartHandle": frame_start_handle,
+                "frameEndHandle": frame_end_handle,
+                "byFrameStep": int(render_instance.frameStep),
+
+                "author": context.data["user"],
+                # Add source to allow tracing back to the scene from
+                # which was submitted originally
+                "expectedFiles": exp_files,
+            }
+            if self.sync_workfile_version:
+                data["version"] = context.data["version"]
+
+            # add additional data
+            data = self.add_additional_data(data)
+            render_instance_dict = attr.asdict(render_instance)
+
+            instance = context.create_instance(render_instance.name)
+            instance.data["label"] = render_instance.label
+            instance.data.update(render_instance_dict)
+            instance.data.update(data)
+
+        self.post_collecting_action()
+
+    @abstractmethod
+    def get_instances(self, context):
+        """Get all renderable instances and their data.
+
+        Args:
+            context (pyblish.api.Context): Context object.
+
+        Returns:
+            list of :class:`RenderInstance`: All collected renderable instances
+                (like render layers, write nodes, etc.)
+
+        """
+        pass
+
+    @abstractmethod
+    def get_expected_files(self, render_instance):
+        """Get list of expected files.
+
+        Returns:
+            list: expected files. This can be either simple list of files with
+                their paths, or list of dictionaries, where key is name of AOV
+                for example and value is list of files for that AOV.
+
+        Example::
+
+            ['/path/to/file.001.exr', '/path/to/file.002.exr']
+
+            or as dictionary:
+
+            [
+                {
+                    "beauty": ['/path/to/beauty.001.exr', ...],
+                    "mask": ['/path/to/mask.001.exr']
+                }
+            ]
+
+        """
+        pass
+
+    def add_additional_data(self, data):
+        """Add additional data to collected instance.
+
+        This can be overridden by host implementation to add custom
+        additional data.
+
+        """
+        return data
+
+    def post_collecting_action(self):
+        """Execute some code after collection is done.
+
+        This is useful for example for restoring current render layer.
+
+        """
+        pass
diff --git a/openpype/pipeline/publish/abstract_expected_files.py b/openpype/pipeline/publish/abstract_expected_files.py
new file mode 100644
index 0000000000..f9f3c17ef5
--- /dev/null
+++ b/openpype/pipeline/publish/abstract_expected_files.py
@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+"""Abstract ExpectedFile class definition."""
+from abc import ABCMeta, abstractmethod
+import six
+
+
+@six.add_metaclass(ABCMeta)
+class ExpectedFiles:
+    """Class grouping functionality for all supported renderers.
+
+    Attributes:
+        multipart (bool): Flag if multipart exrs are used.
+
+    """
+
+    multipart = False
+
+    @abstractmethod
+    def get(self, render_instance):
+        """Get expected files for given renderer and render layer.
+
+        This method should return dictionary of all files we are expecting
+        to be rendered from the host. Usually `render_instance` corresponds
+        to *render layer*. Result can be either flat list with the file
+        paths or it can be list of dictionaries. Each key corresponds to
+        for example AOV name or channel, etc.
+
+        Example::
+
+            ['/path/to/file.001.exr', '/path/to/file.002.exr']
+
+            or as dictionary:
+
+            [
+                {
+                    "beauty": ['/path/to/beauty.001.exr', ...],
+                    "mask": ['/path/to/mask.001.exr']
+                }
+            ]
+
+
+        Args:
+            render_instance (:class:`RenderInstance`): Data passed from
+                collector to determine files. This should be instance of
+                :class:`abstract_collect_render.RenderInstance`
+
+        Returns:
+            list: Full paths to expected rendered files.
+            list of dict: Path to expected rendered files categorized by
+                AOVs, etc.
+
+        """
+        raise NotImplementedError()

From a48a7297e2510a6b4f5c872b95ad16c5fa5a93a7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 10:49:13 +0200
Subject: [PATCH 0921/1227] fixed imports in docstrings and warning messages

---
 openpype/lib/abstract_collect_render.py | 4 ++--
 openpype/lib/abstract_expected_files.py | 4 ++--
 openpype/lib/abstract_metaplugins.py    | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/lib/abstract_collect_render.py b/openpype/lib/abstract_collect_render.py
index 2cc1c23822..e4ff87aa0f 100644
--- a/openpype/lib/abstract_collect_render.py
+++ b/openpype/lib/abstract_collect_render.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-"""Content was moved to 'openpype.pipeline.farm.abstract_collect_render'.
+"""Content was moved to 'openpype.pipeline.publish.abstract_collect_render'.
 
 Please change your imports as soon as possible.
 
@@ -19,7 +19,7 @@ warnings.warn(
     (
         "Content of 'abstract_collect_render' was moved."
         "\nUsing deprecated source of 'abstract_collect_render'. Content was"
-        " move to 'openpype.pipeline.farm.abstract_collect_render'."
+        " move to 'openpype.pipeline.publish.abstract_collect_render'."
         " Please change your imports as soon as possible."
     ),
     category=CollectRenderDeprecated,
diff --git a/openpype/lib/abstract_expected_files.py b/openpype/lib/abstract_expected_files.py
index bb433a8b11..f24d844fe5 100644
--- a/openpype/lib/abstract_expected_files.py
+++ b/openpype/lib/abstract_expected_files.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-"""Content was moved to 'openpype.pipeline.farm.abstract_expected_files'.
+"""Content was moved to 'openpype.pipeline.publish.abstract_expected_files'.
 
 Please change your imports as soon as possible.
 
@@ -19,7 +19,7 @@ warnings.warn(
     (
         "Content of 'abstract_expected_files' was moved."
         "\nUsing deprecated source of 'abstract_expected_files'. Content was"
-        " move to 'openpype.pipeline.farm.abstract_expected_files'."
+        " move to 'openpype.pipeline.publish.abstract_expected_files'."
         " Please change your imports as soon as possible."
     ),
     category=ExpectedFilesDeprecated,
diff --git a/openpype/lib/abstract_metaplugins.py b/openpype/lib/abstract_metaplugins.py
index 6199a96ef1..346b5d86b3 100644
--- a/openpype/lib/abstract_metaplugins.py
+++ b/openpype/lib/abstract_metaplugins.py
@@ -1,4 +1,4 @@
-"""Content was moved to 'openpype.pipeline.farm.abstract_metaplugins'.
+"""Content was moved to 'openpype.pipeline.publish.publish_plugins'.
 
 Please change your imports as soon as possible.
 
@@ -21,7 +21,7 @@ warnings.warn(
     (
         "Content of 'abstract_metaplugins' was moved."
         "\nUsing deprecated source of 'abstract_metaplugins'. Content was"
-        " moved to 'openpype.pipeline.farm.abstract_metaplugins'."
+        " moved to 'openpype.pipeline.publish.publish_plugins'."
         " Please change your imports as soon as possible."
     ),
     category=MetaPluginsDeprecated,

From 3b90f7e507afa4f87304db67fe0b77e647283c22 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 11:07:10 +0200
Subject: [PATCH 0922/1227] log viewer escape characters in log message

---
 openpype/modules/log_viewer/tray/widgets.py | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/openpype/modules/log_viewer/tray/widgets.py b/openpype/modules/log_viewer/tray/widgets.py
index ed08e62109..c7ac64ab70 100644
--- a/openpype/modules/log_viewer/tray/widgets.py
+++ b/openpype/modules/log_viewer/tray/widgets.py
@@ -1,3 +1,4 @@
+import html
 from Qt import QtCore, QtWidgets
 import qtawesome
 from .models import LogModel, LogsFilterProxy
@@ -286,7 +287,7 @@ class OutputWidget(QtWidgets.QWidget):
             if level == "debug":
                 line_f = (
                     "<font color=\"Yellow\"> -"
-                    " <font color=\"Lime\">{{  {loggerName}  }}: ["
+                    " <font color=\"Lime\">{{  {logger_name}  }}: ["
                     " <font color=\"White\">{message}"
                     " <font color=\"Lime\">]"
                 )
@@ -299,7 +300,7 @@ class OutputWidget(QtWidgets.QWidget):
             elif level == "warning":
                 line_f = (
                     "<font color=\"Yellow\">*** WRN:"
-                    " <font color=\"Lime\"> >>> {{ {loggerName} }}: ["
+                    " <font color=\"Lime\"> >>> {{ {logger_name} }}: ["
                     " <font color=\"White\">{message}"
                     " <font color=\"Lime\">]"
                 )
@@ -307,16 +308,25 @@ class OutputWidget(QtWidgets.QWidget):
                 line_f = (
                     "<font color=\"Red\">!!! ERR:"
                     " <font color=\"White\">{timestamp}"
-                    " <font color=\"Lime\">>>> {{ {loggerName} }}: ["
+                    " <font color=\"Lime\">>>> {{ {logger_name} }}: ["
                     " <font color=\"White\">{message}"
                     " <font color=\"Lime\">]"
                 )
 
+            logger_name = log["loggerName"]
+            timestamp = ""
+            if not show_timecode:
+                timestamp = log["timestamp"]
+            message = log["message"]
             exc = log.get("exception")
             if exc:
-                log["message"] = exc["message"]
+                message = exc["message"]
 
-            line = line_f.format(**log)
+            line = line_f.format(
+                message=html.escape(message),
+                logger_name=logger_name,
+                timestamp=timestamp
+            )
 
             if show_timecode:
                 timestamp = log["timestamp"]

From aa741a1148c31a8fc76c6fca90ee885b88e7db33 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 11:34:34 +0200
Subject: [PATCH 0923/1227] use query functions in load logic

---
 openpype/pipeline/load/utils.py | 149 +++++++++++++-------------------
 1 file changed, 62 insertions(+), 87 deletions(-)

diff --git a/openpype/pipeline/load/utils.py b/openpype/pipeline/load/utils.py
index 99e5d11f82..b6e5c38fbe 100644
--- a/openpype/pipeline/load/utils.py
+++ b/openpype/pipeline/load/utils.py
@@ -6,9 +6,20 @@ import logging
 import inspect
 import numbers
 
-import six
-from bson.objectid import ObjectId
-
+from openpype.client import (
+    get_project,
+    get_assets,
+    get_subsets,
+    get_versions,
+    get_version_by_id,
+    get_last_version_by_subset_id,
+    get_hero_version_by_subset_id,
+    get_version_by_name,
+    get_representations,
+    get_representation_by_id,
+    get_representation_by_name,
+    get_representation_parents
+)
 from openpype.lib import Anatomy
 from openpype.pipeline import (
     schema,
@@ -52,13 +63,10 @@ def get_repres_contexts(representation_ids, dbcon=None):
 
     Returns:
         dict: The full representation context by representation id.
-            keys are repre_id, value is dictionary with full:
-                                                        asset_doc
-                                                        version_doc
-                                                        subset_doc
-                                                        repre_doc
-
+            keys are repre_id, value is dictionary with full documents of
+            asset, subset, version and representation.
     """
+
     if not dbcon:
         dbcon = legacy_io
 
@@ -66,26 +74,18 @@ def get_repres_contexts(representation_ids, dbcon=None):
     if not representation_ids:
         return contexts
 
-    _representation_ids = []
-    for repre_id in representation_ids:
-        if isinstance(repre_id, six.string_types):
-            repre_id = ObjectId(repre_id)
-        _representation_ids.append(repre_id)
+    project_name = dbcon.active_project()
+    repre_docs = get_representations(project_name, representation_ids)
 
-    repre_docs = dbcon.find({
-        "type": "representation",
-        "_id": {"$in": _representation_ids}
-    })
     repre_docs_by_id = {}
     version_ids = set()
     for repre_doc in repre_docs:
         version_ids.add(repre_doc["parent"])
         repre_docs_by_id[repre_doc["_id"]] = repre_doc
 
-    version_docs = dbcon.find({
-        "type": {"$in": ["version", "hero_version"]},
-        "_id": {"$in": list(version_ids)}
-    })
+    version_docs = get_versions(
+        project_name, verison_ids=version_ids, hero=True
+    )
 
     version_docs_by_id = {}
     hero_version_docs = []
@@ -99,10 +99,7 @@ def get_repres_contexts(representation_ids, dbcon=None):
         subset_ids.add(version_doc["parent"])
 
     if versions_for_hero:
-        _version_docs = dbcon.find({
-            "type": "version",
-            "_id": {"$in": list(versions_for_hero)}
-        })
+        _version_docs = get_versions(project_name, versions_for_hero)
         _version_data_by_id = {
             version_doc["_id"]: version_doc["data"]
             for version_doc in _version_docs
@@ -114,26 +111,20 @@ def get_repres_contexts(representation_ids, dbcon=None):
             version_data = copy.deepcopy(_version_data_by_id[version_id])
             version_docs_by_id[hero_version_id]["data"] = version_data
 
-    subset_docs = dbcon.find({
-        "type": "subset",
-        "_id": {"$in": list(subset_ids)}
-    })
+    subset_docs = get_subsets(project_name, subset_ids=subset_ids)
     subset_docs_by_id = {}
     asset_ids = set()
     for subset_doc in subset_docs:
         subset_docs_by_id[subset_doc["_id"]] = subset_doc
         asset_ids.add(subset_doc["parent"])
 
-    asset_docs = dbcon.find({
-        "type": "asset",
-        "_id": {"$in": list(asset_ids)}
-    })
+    asset_docs = get_assets(project_name, asset_ids)
     asset_docs_by_id = {
         asset_doc["_id"]: asset_doc
         for asset_doc in asset_docs
     }
 
-    project_doc = dbcon.find_one({"type": "project"})
+    project_doc = get_project(project_name)
 
     for repre_id, repre_doc in repre_docs_by_id.items():
         version_doc = version_docs_by_id[repre_doc["parent"]]
@@ -173,32 +164,21 @@ def get_subset_contexts(subset_ids, dbcon=None):
     if not subset_ids:
         return contexts
 
-    _subset_ids = set()
-    for subset_id in subset_ids:
-        if isinstance(subset_id, six.string_types):
-            subset_id = ObjectId(subset_id)
-        _subset_ids.add(subset_id)
-
-    subset_docs = dbcon.find({
-        "type": "subset",
-        "_id": {"$in": list(_subset_ids)}
-    })
+    project_name = legacy_io.active_project()
+    subset_docs = get_subsets(project_name, subset_ids)
     subset_docs_by_id = {}
     asset_ids = set()
     for subset_doc in subset_docs:
         subset_docs_by_id[subset_doc["_id"]] = subset_doc
         asset_ids.add(subset_doc["parent"])
 
-    asset_docs = dbcon.find({
-        "type": "asset",
-        "_id": {"$in": list(asset_ids)}
-    })
+    asset_docs = get_assets(project_name, asset_ids)
     asset_docs_by_id = {
         asset_doc["_id"]: asset_doc
         for asset_doc in asset_docs
     }
 
-    project_doc = dbcon.find_one({"type": "project"})
+    project_doc = get_project(project_name)
 
     for subset_id, subset_doc in subset_docs_by_id.items():
         asset_doc = asset_docs_by_id[subset_doc["parent"]]
@@ -224,16 +204,17 @@ def get_representation_context(representation):
 
     Returns:
         dict: The full representation context.
-
     """
 
     assert representation is not None, "This is a bug"
 
-    if isinstance(representation, (six.string_types, ObjectId)):
-        representation = legacy_io.find_one(
-            {"_id": ObjectId(str(representation))})
+    if not isinstance(representation, dict):
+        representation = get_representation_by_id(representation)
 
-    version, subset, asset, project = legacy_io.parenthood(representation)
+    project_name = legacy_io.active_project()
+    version, subset, asset, project = get_representation_parents(
+        project_name, representation
+    )
 
     assert all([representation, version, subset, asset, project]), (
         "This is a bug"
@@ -405,42 +386,36 @@ def update_container(container, version=-1):
     """Update a container"""
 
     # Compute the different version from 'representation'
-    current_representation = legacy_io.find_one({
-        "_id": ObjectId(container["representation"])
-    })
+    project_name = legacy_io.active_project()
+    current_representation = get_representation_by_id(
+        project_name, container["representation"]
+    )
 
     assert current_representation is not None, "This is a bug"
 
-    current_version, subset, asset, project = legacy_io.parenthood(
-        current_representation)
-
+    current_version = get_version_by_id(
+        project_name, current_representation["_id"], fields=["parent"]
+    )
     if version == -1:
-        new_version = legacy_io.find_one({
-            "type": "version",
-            "parent": subset["_id"]
-        }, sort=[("name", -1)])
+        new_version = get_last_version_by_subset_id(
+            project_name, current_version["parent"], fields=["_id"]
+        )
+
+    elif isinstance(version, HeroVersionType):
+        new_version = get_hero_version_by_subset_id(
+            project_name, current_version["parent"], fields=["_id"]
+        )
+
     else:
-        if isinstance(version, HeroVersionType):
-            version_query = {
-                "parent": subset["_id"],
-                "type": "hero_version"
-            }
-        else:
-            version_query = {
-                "parent": subset["_id"],
-                "type": "version",
-                "name": version
-            }
-        new_version = legacy_io.find_one(version_query)
+        new_version = get_version_by_name(
+            project_name, version, current_version["parent"], fields=["_id"]
+        )
 
     assert new_version is not None, "This is a bug"
 
-    new_representation = legacy_io.find_one({
-        "type": "representation",
-        "parent": new_version["_id"],
-        "name": current_representation["name"]
-    })
-
+    new_representation = get_representation_by_name(
+        project_name, current_representation["name"], new_version["_id"]
+    )
     assert new_representation is not None, "Representation wasn't found"
 
     path = get_representation_path(new_representation)
@@ -482,10 +457,10 @@ def switch_container(container, representation, loader_plugin=None):
         ))
 
     # Get the new representation to switch to
-    new_representation = legacy_io.find_one({
-        "type": "representation",
-        "_id": representation["_id"],
-    })
+    project_name = legacy_io.active_project()
+    new_representation = get_representation_by_id(
+        project_name, representation["_id"]
+    )
 
     new_context = get_representation_context(new_representation)
     if not is_compatible_loader(loader_plugin, new_context):

From 2527ac03728d8c85abd63248a3db539f8451b0be Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 11:47:32 +0200
Subject: [PATCH 0924/1227] make sure _get_project_connection has project name
 passed

---
 openpype/client/entities.py | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 28cd994254..a58926499f 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -15,12 +15,15 @@ from bson.objectid import ObjectId
 from openpype.lib.mongo import OpenPypeMongoConnection
 
 
-def _get_project_connection(project_name=None):
+def _get_project_database():
     db_name = os.environ.get("AVALON_DB") or "avalon"
-    mongodb = OpenPypeMongoConnection.get_mongo_client()[db_name]
-    if project_name:
-        return mongodb[project_name]
-    return mongodb
+    return OpenPypeMongoConnection.get_mongo_client()[db_name]
+
+
+def _get_project_connection(project_name):
+    if not project_name:
+        raise ValueError("Invalid project name {}".format(str(project_name)))
+    return _get_project_database()[project_name]
 
 
 def _prepare_fields(fields, required_fields=None):
@@ -55,7 +58,7 @@ def _convert_ids(in_ids):
 
 
 def get_projects(active=True, inactive=False, fields=None):
-    mongodb = _get_project_connection()
+    mongodb = _get_project_database()
     for project_name in mongodb.collection_names():
         if project_name in ("system.indexes",):
             continue

From 63f5ea427a2bd41d38d352bb6f5b132a39c348bc Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 11:50:40 +0200
Subject: [PATCH 0925/1227] make sure output of get_representations_parents
 always returns values for passed repre ids

---
 openpype/client/entities.py         | 5 +++--
 openpype/hosts/maya/api/setdress.py | 7 ++-----
 2 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index a58926499f..8b0c259817 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -1012,8 +1012,10 @@ def get_representations_parents(project_name, representations):
     versions_by_subset_id = collections.defaultdict(list)
     subsets_by_subset_id = {}
     subsets_by_asset_id = collections.defaultdict(list)
+    output = {}
     for representation in representations:
         repre_id = representation["_id"]
+        output[repre_id] = (None, None, None, None)
         version_id = representation["parent"]
         repres_by_version_id[version_id].append(representation)
 
@@ -1043,7 +1045,6 @@ def get_representations_parents(project_name, representations):
 
     project = get_project(project_name)
 
-    output = {}
     for version_id, representations in repres_by_version_id.items():
         asset = None
         subset = None
@@ -1083,7 +1084,7 @@ def get_representation_parents(project_name, representation):
     parents_by_repre_id = get_representations_parents(
         project_name, [representation]
     )
-    return parents_by_repre_id.get(repre_id)
+    return parents_by_repre_id[repre_id]
 
 
 def get_thumbnail_id_from_source(project_name, src_type, src_id):
diff --git a/openpype/hosts/maya/api/setdress.py b/openpype/hosts/maya/api/setdress.py
index bea8f154b1..159bfe9eb3 100644
--- a/openpype/hosts/maya/api/setdress.py
+++ b/openpype/hosts/maya/api/setdress.py
@@ -296,12 +296,9 @@ def update_package_version(container, version):
 
     assert current_representation is not None, "This is a bug"
 
-    repre_parents = get_representation_parents(
-        project_name, current_representation
+    version_doc, subset_doc, asset_doc, project_doc = (
+        get_representation_parents(project_name, current_representation)
     )
-    version_doc = subset_doc = asset_doc = project_doc = None
-    if repre_parents:
-        version_doc, subset_doc, asset_doc, project_doc = repre_parents
 
     if version == -1:
         new_version = get_last_version_by_subset_id(

From dd1e1960da94ab22b28a68f647a685064a0da479 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 11:54:23 +0200
Subject: [PATCH 0926/1227] fix few issues

---
 openpype/pipeline/load/utils.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/pipeline/load/utils.py b/openpype/pipeline/load/utils.py
index b6e5c38fbe..3d2f798769 100644
--- a/openpype/pipeline/load/utils.py
+++ b/openpype/pipeline/load/utils.py
@@ -84,7 +84,7 @@ def get_repres_contexts(representation_ids, dbcon=None):
         repre_docs_by_id[repre_doc["_id"]] = repre_doc
 
     version_docs = get_versions(
-        project_name, verison_ids=version_ids, hero=True
+        project_name, version_ids, hero=True
     )
 
     version_docs_by_id = {}
@@ -111,7 +111,7 @@ def get_repres_contexts(representation_ids, dbcon=None):
             version_data = copy.deepcopy(_version_data_by_id[version_id])
             version_docs_by_id[hero_version_id]["data"] = version_data
 
-    subset_docs = get_subsets(project_name, subset_ids=subset_ids)
+    subset_docs = get_subsets(project_name, subset_ids)
     subset_docs_by_id = {}
     asset_ids = set()
     for subset_doc in subset_docs:
@@ -164,7 +164,7 @@ def get_subset_contexts(subset_ids, dbcon=None):
     if not subset_ids:
         return contexts
 
-    project_name = legacy_io.active_project()
+    project_name = dbcon.active_project()
     subset_docs = get_subsets(project_name, subset_ids)
     subset_docs_by_id = {}
     asset_ids = set()

From 81e977129022b2db7ca1f5593756fb0add035cfa Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 30 Jun 2022 11:55:25 +0200
Subject: [PATCH 0927/1227] :construction_worker: clean old files and add
 version subfolder

---
 inno_setup.iss | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/inno_setup.iss b/inno_setup.iss
index ead9907955..fa050ef1d6 100644
--- a/inno_setup.iss
+++ b/inno_setup.iss
@@ -18,7 +18,8 @@ AppPublisher=Orbi Tools s.r.o
 AppPublisherURL=http://pype.club
 AppSupportURL=http://pype.club
 AppUpdatesURL=http://pype.club
-DefaultDirName={autopf}\{#MyAppName}
+DefaultDirName={autopf}\{#MyAppName}\{#AppVer}
+UsePreviousAppDir=no
 DisableProgramGroupPage=yes
 OutputBaseFilename={#MyAppName}-{#AppVer}-install
 AllowCancelDuringInstall=yes
@@ -27,7 +28,7 @@ AllowCancelDuringInstall=yes
 PrivilegesRequiredOverridesAllowed=dialog
 SetupIconFile=igniter\openpype.ico
 OutputDir=build\
-Compression=lzma
+Compression=lzma2
 SolidCompression=yes
 WizardStyle=modern
 
@@ -37,6 +38,11 @@ Name: "english"; MessagesFile: "compiler:Default.isl"
 [Tasks]
 Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked
 
+[InstallDelete]
+; clean everything in previous installation folder
+Type: filesandordirs; Name: "{app}\*"
+
+
 [Files]
 Source: "build\{#build}\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs createallsubdirs
 ; NOTE: Don't use "Flags: ignoreversion" on any shared system files

From c473f6b777022692fdae72cd927f01afbd51ba2e Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 30 Jun 2022 14:17:57 +0200
Subject: [PATCH 0928/1227] :bug: fix unicode encoding hash in tile rendering

---
 .../modules/deadline/plugins/publish/submit_maya_deadline.py  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
index 9964e3c646..3707c5709f 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
@@ -710,7 +710,9 @@ class MayaSubmitDeadline(pyblish.api.InstancePlugin):
                 new_payload["JobInfo"].update(tiles_data["JobInfo"])
                 new_payload["PluginInfo"].update(tiles_data["PluginInfo"])
 
-                job_hash = hashlib.sha256("{}_{}".format(file_index, file))
+                self.log.info("hashing {} - {}".format(file_index, file))
+                job_hash = hashlib.sha256(
+                    ("{}_{}".format(file_index, file)).encode("utf-8"))
                 frame_jobs[frame] = job_hash.hexdigest()
                 new_payload["JobInfo"]["ExtraInfo0"] = job_hash.hexdigest()
                 new_payload["JobInfo"]["ExtraInfo1"] = file

From 4e7358f73b007d8a53ae55c5a3b255a45b299876 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 14:47:08 +0200
Subject: [PATCH 0929/1227] removed unused function 'get_hierarchy'

---
 openpype/api.py                               |  2 -
 openpype/lib/__init__.py                      |  2 -
 openpype/lib/avalon_context.py                | 51 -------------------
 .../tests/test_lib_restructuralization.py     |  1 -
 4 files changed, 56 deletions(-)

diff --git a/openpype/api.py b/openpype/api.py
index 9ce745b653..fac2ae572b 100644
--- a/openpype/api.py
+++ b/openpype/api.py
@@ -15,7 +15,6 @@ from .lib import (
     run_subprocess,
     version_up,
     get_asset,
-    get_hierarchy,
     get_workdir_data,
     get_version_from_path,
     get_last_version_from_path,
@@ -101,7 +100,6 @@ __all__ = [
     # get contextual data
     "version_up",
     "get_asset",
-    "get_hierarchy",
     "get_workdir_data",
     "get_version_from_path",
     "get_last_version_from_path",
diff --git a/openpype/lib/__init__.py b/openpype/lib/__init__.py
index 8d4e733b7d..fb52a9aca7 100644
--- a/openpype/lib/__init__.py
+++ b/openpype/lib/__init__.py
@@ -120,7 +120,6 @@ from .avalon_context import (
     is_latest,
     any_outdated,
     get_asset,
-    get_hierarchy,
     get_linked_assets,
     get_latest_version,
     get_system_general_anatomy_data,
@@ -292,7 +291,6 @@ __all__ = [
     "is_latest",
     "any_outdated",
     "get_asset",
-    "get_hierarchy",
     "get_linked_assets",
     "get_latest_version",
     "get_system_general_anatomy_data",
diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index a03f066300..ad34e24644 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -213,57 +213,6 @@ def get_asset(asset_name=None):
     return asset_document
 
 
-@with_pipeline_io
-def get_hierarchy(asset_name=None):
-    """
-    Obtain asset hierarchy path string from mongo db
-
-    Args:
-        asset_name (str)
-
-    Returns:
-        (string): asset hierarchy path
-
-    """
-    if not asset_name:
-        asset_name = legacy_io.Session.get(
-            "AVALON_ASSET",
-            os.environ["AVALON_ASSET"]
-        )
-
-    asset_entity = legacy_io.find_one({
-        "type": 'asset',
-        "name": asset_name
-    })
-
-    not_set = "PARENTS_NOT_SET"
-    entity_parents = asset_entity.get("data", {}).get("parents", not_set)
-
-    # If entity already have parents then just return joined
-    if entity_parents != not_set:
-        return "/".join(entity_parents)
-
-    # Else query parents through visualParents and store result to entity
-    hierarchy_items = []
-    entity = asset_entity
-    while True:
-        parent_id = entity.get("data", {}).get("visualParent")
-        if not parent_id:
-            break
-        entity = legacy_io.find_one({"_id": parent_id})
-        hierarchy_items.append(entity["name"])
-
-    # Add parents to entity data for next query
-    entity_data = asset_entity.get("data", {})
-    entity_data["parents"] = hierarchy_items
-    legacy_io.update_many(
-        {"_id": asset_entity["_id"]},
-        {"$set": {"data": entity_data}}
-    )
-
-    return "/".join(hierarchy_items)
-
-
 def get_system_general_anatomy_data():
     system_settings = get_system_settings()
     studio_name = system_settings["general"]["studio_name"]
diff --git a/openpype/tests/test_lib_restructuralization.py b/openpype/tests/test_lib_restructuralization.py
index 94080e550d..ccccc76a08 100644
--- a/openpype/tests/test_lib_restructuralization.py
+++ b/openpype/tests/test_lib_restructuralization.py
@@ -21,7 +21,6 @@ def test_backward_compatibility(printer):
         from openpype.lib import is_latest
         from openpype.lib import any_outdated
         from openpype.lib import get_asset
-        from openpype.lib import get_hierarchy
         from openpype.lib import get_linked_assets
         from openpype.lib import get_latest_version
         from openpype.lib import get_ffprobe_streams

From cda8d670c003a85f324fb3e0ce160b1745c1703e Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 30 Jun 2022 15:08:19 +0200
Subject: [PATCH 0930/1227] Added settings for Harmony ImageSequenceLoader

Currently to fix issue with reference representations with wrong names (png_mp4 instead of png), but it could be helpful regardless.
---
 .../defaults/project_settings/harmony.json    | 16 +++++++++++
 .../schema_project_harmony.json               | 28 +++++++++++++++++++
 2 files changed, 44 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/harmony.json b/openpype/settings/defaults/project_settings/harmony.json
index 1508b02e1b..d843bc8e70 100644
--- a/openpype/settings/defaults/project_settings/harmony.json
+++ b/openpype/settings/defaults/project_settings/harmony.json
@@ -1,4 +1,20 @@
 {
+    "load": {
+        "ImageSequenceLoader": {
+            "family": [
+                "shot",
+                "render",
+                "image",
+                "plate",
+                "reference"
+            ],
+            "representations": [
+                "jpeg",
+                "png",
+                "jpg"
+            ]
+        }
+    },
     "publish": {
         "CollectPalettes": {
             "allowed_tasks": [
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_harmony.json b/openpype/settings/entities/schemas/projects_schema/schema_project_harmony.json
index c049ce3084..311f742f81 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_harmony.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_harmony.json
@@ -5,6 +5,34 @@
     "label": "Harmony",
     "is_file": true,
     "children": [
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "load",
+            "label": "Loader plugins",
+            "children": [
+                {
+                    "type": "dict",
+                    "collapsible": true,
+                    "key": "ImageSequenceLoader",
+                    "label": "Load Image Sequence",
+                    "children": [
+                        {
+                            "type": "list",
+                            "key": "family",
+                            "label": "Families",
+                            "object_type": "text"
+                        },
+                        {
+                            "type": "list",
+                            "key": "representations",
+                            "label": "Representations",
+                            "object_type": "text"
+                        }
+                    ]
+                }
+            ]
+        },
         {
             "type": "dict",
             "collapsible": true,

From 752615d0d46992b92270790901cff2acadea701c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 30 Jun 2022 15:14:19 +0200
Subject: [PATCH 0931/1227] general: add prerender to thumbnail exporter

---
 openpype/plugins/publish/extract_jpeg_exr.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_jpeg_exr.py
index a467728e77..42c4cbe062 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_jpeg_exr.py
@@ -19,7 +19,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
     label = "Extract Thumbnail"
     order = pyblish.api.ExtractorOrder
     families = [
-        "imagesequence", "render", "render2d",
+        "imagesequence", "render", "render2d", "prerender",
         "source", "plate", "take"
     ]
     hosts = ["shell", "fusion", "resolve"]

From f65bab000f42af9d4d11d0e600ead9dabaa3e5ba Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 30 Jun 2022 15:14:54 +0200
Subject: [PATCH 0932/1227] Nuke: add prerender.farm family to extract review
 mov

---
 .../hosts/nuke/plugins/publish/extract_review_data_mov.py    | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py b/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
index 5ea7c352b9..fc16e189fb 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
@@ -104,7 +104,10 @@ class ExtractReviewDataMov(openpype.api.Extractor):
                     self, instance, o_name, o_data["extension"],
                     multiple_presets)
 
-                if "render.farm" in families:
+                if (
+                    "render.farm" in families or
+                    "prerender.farm" in families
+                ):
                     if "review" in instance.data["families"]:
                         instance.data["families"].remove("review")
 

From e147cd4132e983e9d70c2be02356a75fd5f70f11 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:04:25 +0200
Subject: [PATCH 0933/1227] added 'get_workfile_info' to openpype.client which
 replace 'get_workfile_doc' in openpype.lib

---
 openpype/client/__init__.py        |  4 ++
 openpype/client/entities.py        | 32 ++++++++++++++++
 openpype/lib/avalon_context.py     | 59 +++++++++++++++++++++++++++---
 openpype/tools/workfiles/window.py | 17 ++++++---
 4 files changed, 100 insertions(+), 12 deletions(-)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index e3b4ef5132..e1c8ea9f03 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -33,6 +33,8 @@ from .entities import (
     get_thumbnail,
     get_thumbnails,
     get_thumbnail_id_from_source,
+
+    get_workfile_info,
 )
 
 __all__ = (
@@ -70,4 +72,6 @@ __all__ = (
     "get_thumbnail",
     "get_thumbnails",
     "get_thumbnail_id_from_source",
+
+    "get_workfile_info",
 )
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 28cd994254..9771461d2e 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -1158,6 +1158,38 @@ def get_thumbnail(project_name, thumbnail_id, fields=None):
     return conn.find_one(query_filter, _prepare_fields(fields))
 
 
+def get_workfile_info(
+    project_name, asset_id, task_name, filename, fields=None
+):
+    """Document with workfile information.
+
+    Warning:
+        Query is based on filename and context which does not meant it will
+        find always right expected result. There is a limited amound of usage
+        and is recommended to not expect that all workfiles are stored in
+        database.
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        asset_id (str|ObjectId): Id of asset entity.
+        task_name (str): Task name on asset.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+    """
+
+    if not asset_id or not task_name or not filename:
+        return None
+
+    query_filter = {
+        "type": "workfile",
+        "parent": _convert_id(asset_id),
+        "task_name": task_name,
+        "filename": filename
+    }
+    conn = _get_project_connection(project_name)
+    return conn.find_one(query_filter, _prepare_fields(fields))
+
+
 """
 ## Custom data storage:
 - Settings - OP settings overrides and local settings
diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index ad34e24644..412d7fa1d3 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -9,7 +9,11 @@ import collections
 import functools
 
 from bson.objectid import ObjectId
+import warnings
 
+from openpype.client import (
+    get_workfile_info,
+)
 from openpype.settings import (
     get_project_settings,
     get_system_settings
@@ -36,6 +40,51 @@ PROJECT_NAME_REGEX = re.compile(
 )
 
 
+class AvalonContextDeprecatedWarning(DeprecationWarning):
+    pass
+
+
+def deprecated(new_destination):
+    """Mark functions as deprecated.
+
+    It will result in a warning being emitted when the function is used.
+    """
+
+    func = None
+    if callable(new_destination):
+        func = new_destination
+        new_destination = None
+
+    def _decorator(decorated_func):
+        if new_destination is None:
+            warning_message = (
+                " Please check content of deprecated function to figure out"
+                " possible replacement."
+            )
+        else:
+            warning_message = " Please replace your usage with '{}'.".format(
+                new_destination
+            )
+
+        @functools.wraps(decorated_func)
+        def wrapper(*args, **kwargs):
+            warnings.simplefilter("always", AvalonContextDeprecatedWarning)
+            warnings.warn(
+                (
+                    "Call to deprecated function '{}'"
+                    "\nFunction was moved or removed.{}"
+                ).format(decorated_func.__name__, warning_message),
+                category=AvalonContextDeprecatedWarning,
+                stacklevel=4
+            )
+            return decorated_func(*args, **kwargs)
+        return wrapper
+
+    if func is None:
+        return _decorator
+    return _decorator(func)
+
+
 def create_project(
     project_name, project_code, library_project=False, dbcon=None
 ):
@@ -759,6 +808,7 @@ def update_current_task(task=None, asset=None, app=None, template_key=None):
 
 
 @with_pipeline_io
+@deprecated("openpype.client.get_workfile_info")
 def get_workfile_doc(asset_id, task_name, filename, dbcon=None):
     """Return workfile document for entered context.
 
@@ -775,16 +825,13 @@ def get_workfile_doc(asset_id, task_name, filename, dbcon=None):
     Returns:
         dict: Workfile document or None.
     """
+
     # Use legacy_io if dbcon is not entered
     if not dbcon:
         dbcon = legacy_io
 
-    return dbcon.find_one({
-        "type": "workfile",
-        "parent": asset_id,
-        "task_name": task_name,
-        "filename": filename
-    })
+    project_name = dbcon.active_project()
+    return get_workfile_info(project_name, asset_id, task_name, filename)
 
 
 @with_pipeline_io
diff --git a/openpype/tools/workfiles/window.py b/openpype/tools/workfiles/window.py
index 9f4cea2f8a..c1efe026f2 100644
--- a/openpype/tools/workfiles/window.py
+++ b/openpype/tools/workfiles/window.py
@@ -2,10 +2,13 @@ import os
 import datetime
 from Qt import QtCore, QtWidgets
 
-from openpype.client import get_asset_by_id, get_asset_by_name
+from openpype.client import (
+    get_asset_by_id,
+    get_asset_by_name,
+    get_workfile_info,
+)
 from openpype import style
 from openpype.lib import (
-    get_workfile_doc,
     create_workfile_doc,
     save_workfile_data_to_doc,
 )
@@ -255,8 +258,9 @@ class Window(QtWidgets.QMainWindow):
         workfile_doc = None
         if asset_id and task_name and filepath:
             filename = os.path.split(filepath)[1]
-            workfile_doc = get_workfile_doc(
-                asset_id, task_name, filename, legacy_io
+            project_name = legacy_io.active_project()
+            workfile_doc = get_workfile_info(
+                project_name, asset_id, task_name, filename
             )
         self.side_panel.set_context(
             asset_id, task_name, filepath, workfile_doc
@@ -289,8 +293,9 @@ class Window(QtWidgets.QMainWindow):
             return
 
         filename = os.path.split(filepath)[1]
-        return get_workfile_doc(
-            asset_id, task_name, filename, legacy_io
+        project_name = legacy_io.active_project()
+        return get_workfile_info(
+            project_name, asset_id, task_name, filename
         )
 
     def _create_workfile_doc(self, filepath, force=False):

From 9f29726d98b7e87f608dd70aa512b8e0c56df949 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:05:22 +0200
Subject: [PATCH 0934/1227] modified and moved project doc validation

---
 openpype/lib/avalon_context.py | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 412d7fa1d3..fec87e53d1 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -12,6 +12,7 @@ from bson.objectid import ObjectId
 import warnings
 
 from openpype.client import (
+    get_project,
     get_workfile_info,
 )
 from openpype.settings import (
@@ -114,6 +115,11 @@ def create_project(
     from openpype.pipeline import AvalonMongoDB
     from openpype.pipeline.schema import validate
 
+    if get_project(project_name, fields=["name"]):
+        raise ValueError("Project with name \"{}\" already exists".format(
+            project_name
+        ))
+
     if dbcon is None:
         dbcon = AvalonMongoDB()
 
@@ -123,15 +129,6 @@ def create_project(
         ).format(project_name))
 
     database = dbcon.database
-    project_doc = database[project_name].find_one(
-        {"type": "project"},
-        {"name": 1}
-    )
-    if project_doc:
-        raise ValueError("Project with name \"{}\" already exists".format(
-            project_name
-        ))
-
     project_doc = {
         "type": "project",
         "name": project_name,
@@ -154,7 +151,7 @@ def create_project(
         database[project_name].delete_one({"type": "project"})
         raise
 
-    project_doc = database[project_name].find_one({"type": "project"})
+    project_doc = get_project(project_name)
 
     try:
         # Validate created project document

From 5b600b850614b5d67fe6f7eb59c42754b83460b3 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:11:54 +0200
Subject: [PATCH 0935/1227] is_latest use new query functions

---
 openpype/lib/avalon_context.py | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index fec87e53d1..02b4cad6f2 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -13,6 +13,8 @@ import warnings
 
 from openpype.client import (
     get_project,
+    get_version_by_id,
+    get_last_version_by_subset_id,
     get_workfile_info,
 )
 from openpype.settings import (
@@ -183,23 +185,24 @@ def is_latest(representation):
 
     Returns:
         bool: Whether the representation is of latest version.
-
     """
 
-    version = legacy_io.find_one({"_id": representation['parent']})
+    project_name = legacy_io.active_project()
+    version = get_version_by_id(
+        project_name,
+        representation["parent"],
+        hero=True,
+        fields=["_id", "type", "parent"]
+    )
     if version["type"] == "hero_version":
         return True
 
     # Get highest version under the parent
-    highest_version = legacy_io.find_one({
-        "type": "version",
-        "parent": version["parent"]
-    }, sort=[("name", -1)], projection={"name": True})
+    last_version = get_last_version_by_subset_id(
+        project_name, version["parent"], fields=["_id"]
+    )
 
-    if version['name'] == highest_version['name']:
-        return True
-    else:
-        return False
+    return version["_id"] == last_version["_id"]
 
 
 @with_pipeline_io

From a0bc06c62084f4116c3e0519522b15f7d4bcde0e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:18:12 +0200
Subject: [PATCH 0936/1227] use query functions for rest of avalon context
 functions

---
 openpype/lib/avalon_context.py | 232 +++++++++++++--------------------
 1 file changed, 90 insertions(+), 142 deletions(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 02b4cad6f2..7b00032027 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -13,8 +13,15 @@ import warnings
 
 from openpype.client import (
     get_project,
+    get_assets,
+    get_asset_by_name,
+    get_subset_by_name,
+    get_subsets,
     get_version_by_id,
+    get_last_versions,
     get_last_version_by_subset_id,
+    get_representations,
+    get_representation_by_id,
     get_workfile_info,
 )
 from openpype.settings import (
@@ -210,6 +217,7 @@ def any_outdated():
     """Return whether the current scene has any outdated content"""
     from openpype.pipeline import registered_host
 
+    project_name = legacy_io.active_project()
     checked = set()
     host = registered_host()
     for container in host.ls():
@@ -217,12 +225,8 @@ def any_outdated():
         if representation in checked:
             continue
 
-        representation_doc = legacy_io.find_one(
-            {
-                "_id": ObjectId(representation),
-                "type": "representation"
-            },
-            projection={"parent": True}
+        representation_doc = get_representation_by_id(
+            project_name, representation, fields=["parent"]
         )
         if representation_doc and not is_latest(representation_doc):
             return True
@@ -240,22 +244,20 @@ def any_outdated():
 def get_asset(asset_name=None):
     """ Returning asset document from database by its name.
 
-        Doesn't count with duplicities on asset names!
+    Doesn't count with duplicities on asset names!
 
-        Args:
-            asset_name (str)
+    Args:
+        asset_name (str)
 
-        Returns:
-            (MongoDB document)
+    Returns:
+        (MongoDB document)
     """
+
+    project_name = legacy_io.active_project()
     if not asset_name:
         asset_name = legacy_io.Session["AVALON_ASSET"]
 
-    asset_document = legacy_io.find_one({
-        "name": asset_name,
-        "type": "asset"
-    })
-
+    asset_document = get_asset_by_name(project_name, asset_name)
     if not asset_document:
         raise TypeError("Entity \"{}\" was not found in DB".format(asset_name))
 
@@ -311,11 +313,13 @@ def get_linked_assets(asset_doc):
     Returns:
         (list) Asset documents of input links for passed asset doc.
     """
+
     link_ids = get_linked_asset_ids(asset_doc)
     if not link_ids:
         return []
 
-    return list(legacy_io.find({"_id": {"$in": link_ids}}))
+    project_name = legacy_io.active_project()
+    return list(get_assets(project_name, link_ids))
 
 
 @with_pipeline_io
@@ -337,20 +341,14 @@ def get_latest_version(asset_name, subset_name, dbcon=None, project_name=None):
         dict: Last version document for entered .
     """
 
-    if not dbcon:
-        log.debug("Using `legacy_io` for query.")
-        dbcon = legacy_io
-        # Make sure is installed
-        dbcon.install()
+    if not project_name:
+        if not dbcon:
+            log.debug("Using `legacy_io` for query.")
+            dbcon = legacy_io
+            # Make sure is installed
+            dbcon.install()
 
-    if project_name and project_name != dbcon.Session.get("AVALON_PROJECT"):
-        # `legacy_io` has only `_database` attribute
-        # but `AvalonMongoDB` has `database`
-        database = getattr(dbcon, "database", dbcon._database)
-        collection = database[project_name]
-    else:
-        project_name = dbcon.Session.get("AVALON_PROJECT")
-        collection = dbcon
+        project_name = dbcon.active_project()
 
     log.debug((
         "Getting latest version for Project: \"{}\" Asset: \"{}\""
@@ -358,19 +356,15 @@ def get_latest_version(asset_name, subset_name, dbcon=None, project_name=None):
     ).format(project_name, asset_name, subset_name))
 
     # Query asset document id by asset name
-    asset_doc = collection.find_one(
-        {"type": "asset", "name": asset_name},
-        {"_id": True}
-    )
+    asset_doc = get_asset_by_name(project_name, asset_name, fields=["_id"])
     if not asset_doc:
         log.info(
             "Asset \"{}\" was not found in Database.".format(asset_name)
         )
         return None
 
-    subset_doc = collection.find_one(
-        {"type": "subset", "name": subset_name, "parent": asset_doc["_id"]},
-        {"_id": True}
+    subset_doc = get_subset_by_name(
+        project_name, subset_name, asset_doc["_id"]
     )
     if not subset_doc:
         log.info(
@@ -378,10 +372,7 @@ def get_latest_version(asset_name, subset_name, dbcon=None, project_name=None):
         )
         return None
 
-    version_doc = collection.find_one(
-        {"type": "version", "parent": subset_doc["_id"]},
-        sort=[("name", -1)],
-    )
+    version_doc = get_last_version_by_subset_id(project_name, subset_doc["_id"])
     if not version_doc:
         log.info(
             "Subset \"{}\" does not have any version yet.".format(subset_name)
@@ -418,28 +409,17 @@ def get_workfile_template_key_from_context(
         ValueError: When both 'dbcon' and 'project_name' were not
             passed.
     """
-    if not dbcon:
-        if not project_name:
+    if not project_name:
+        if not dbcon:
             raise ValueError((
                 "`get_workfile_template_key_from_context` requires to pass"
                 " one of 'dbcon' or 'project_name' arguments."
             ))
-        from openpype.pipeline import AvalonMongoDB
 
-        dbcon = AvalonMongoDB()
-        dbcon.Session["AVALON_PROJECT"] = project_name
+        project_name = dbcon.active_project()
 
-    elif not project_name:
-        project_name = dbcon.Session["AVALON_PROJECT"]
-
-    asset_doc = dbcon.find_one(
-        {
-            "type": "asset",
-            "name": asset_name
-        },
-        {
-            "data.tasks": 1
-        }
+    asset_doc = get_asset_by_name(
+        project_name, asset_name, fields=["data.tasks"]
     )
     asset_tasks = asset_doc.get("data", {}).get("tasks") or {}
     task_info = asset_tasks.get(task_name) or {}
@@ -632,6 +612,7 @@ def get_workdir(
     Returns:
         TemplateResult: Workdir path.
     """
+
     if not anatomy:
         anatomy = Anatomy(project_doc["name"])
 
@@ -659,15 +640,11 @@ def template_data_from_session(session=None):
         session = legacy_io.Session
 
     project_name = session["AVALON_PROJECT"]
-    project_doc = legacy_io.database[project_name].find_one({
-        "type": "project"
-    })
-    asset_doc = legacy_io.database[project_name].find_one({
-        "type": "asset",
-        "name": session["AVALON_ASSET"]
-    })
+    asset_name = session["AVALON_ASSET"]
     task_name = session["AVALON_TASK"]
     host_name = session["AVALON_APP"]
+    project_doc = get_project(project_name)
+    asset_doc = get_asset_by_name(project_name, asset_name)
     return get_workdir_data(project_doc, asset_doc, task_name, host_name)
 
 
@@ -692,8 +669,8 @@ def compute_session_changes(
 
     Returns:
         dict: The required changes in the Session dictionary.
-
     """
+
     changes = dict()
 
     # If no changes, return directly
@@ -711,12 +688,9 @@ def compute_session_changes(
 
     if not asset_document or not asset_tasks:
         # Assume asset name
-        asset_document = legacy_io.find_one(
-            {
-                "name": asset,
-                "type": "asset"
-            },
-            {"data.tasks": True}
+        project_name = session["AVALON_PROJECT"]
+        asset_document = get_asset_by_name(
+            project_name, asset, fields=["data.tasks"]
         )
         assert asset_document, "Asset must exist"
 
@@ -864,12 +838,13 @@ def create_workfile_doc(asset_doc, task_name, filename, workdir, dbcon=None):
     doc_data = copy.deepcopy(doc_filter)
 
     # Prepare project for workdir data
-    project_doc = dbcon.find_one({"type": "project"})
+    project_name = dbcon.active_project()
+    project_doc = get_project(project_name)
     workdir_data = get_workdir_data(
         project_doc, asset_doc, task_name, dbcon.Session["AVALON_APP"]
     )
     # Prepare anatomy
-    anatomy = Anatomy(project_doc["name"])
+    anatomy = Anatomy(project_name)
     # Get workdir path (result is anatomy.TemplateResult)
     template_workdir = get_workdir_with_workdir_data(
         workdir_data, anatomy
@@ -984,12 +959,9 @@ class BuildWorkfile:
         from openpype.pipeline import discover_loader_plugins
 
         # Get current asset name and entity
+        project_name = legacy_io.active_project()
         current_asset_name = legacy_io.Session["AVALON_ASSET"]
-        current_asset_entity = legacy_io.find_one({
-            "type": "asset",
-            "name": current_asset_name
-        })
-
+        current_asset_entity = get_asset_by_name(project_name, current_asset_name)
         # Skip if asset was not found
         if not current_asset_entity:
             print("Asset entity with name `{}` was not found".format(
@@ -1494,7 +1466,7 @@ class BuildWorkfile:
         return loaded_containers
 
     @with_pipeline_io
-    def _collect_last_version_repres(self, asset_entities):
+    def _collect_last_version_repres(self, asset_docs):
         """Collect subsets, versions and representations for asset_entities.
 
         Args:
@@ -1527,64 +1499,56 @@ class BuildWorkfile:
         ```
         """
 
-        if not asset_entities:
-            return {}
+        output = {}
+        if not asset_docs:
+            return output
 
-        asset_entity_by_ids = {asset["_id"]: asset for asset in asset_entities}
+        asset_docs_by_ids = {asset["_id"]: asset for asset in asset_docs}
 
-        subsets = list(legacy_io.find({
-            "type": "subset",
-            "parent": {"$in": list(asset_entity_by_ids.keys())}
-        }))
+        project_name = legacy_io.active_project()
+        subsets = list(get_subsets(
+            project_name, asset_ids=asset_docs_by_ids.keys()
+        ))
         subset_entity_by_ids = {subset["_id"]: subset for subset in subsets}
 
-        sorted_versions = list(legacy_io.find({
-            "type": "version",
-            "parent": {"$in": list(subset_entity_by_ids.keys())}
-        }).sort("name", -1))
+        last_version_by_subset_id = get_last_versions(
+            project_name, subset_entity_by_ids.keys()
+        )
+        last_version_docs_by_id = {
+            version["_id"]: version
+            for version in last_version_by_subset_id.values()
+        }
+        repre_docs = get_representations(
+            project_name, version_ids=last_version_docs_by_id.keys()
+        )
 
-        subset_id_with_latest_version = []
-        last_versions_by_id = {}
-        for version in sorted_versions:
-            subset_id = version["parent"]
-            if subset_id in subset_id_with_latest_version:
-                continue
-            subset_id_with_latest_version.append(subset_id)
-            last_versions_by_id[version["_id"]] = version
+        for repre_doc in repre_docs:
+            version_id = repre_doc["parent"]
+            version_doc = last_version_docs_by_id[version_id]
 
-        repres = legacy_io.find({
-            "type": "representation",
-            "parent": {"$in": list(last_versions_by_id.keys())}
-        })
+            subset_id = version_doc["parent"]
+            subset_doc = subset_entity_by_ids[subset_id]
 
-        output = {}
-        for repre in repres:
-            version_id = repre["parent"]
-            version = last_versions_by_id[version_id]
-
-            subset_id = version["parent"]
-            subset = subset_entity_by_ids[subset_id]
-
-            asset_id = subset["parent"]
-            asset = asset_entity_by_ids[asset_id]
+            asset_id = subset_doc["parent"]
+            asset_doc = asset_docs_by_ids[asset_id]
 
             if asset_id not in output:
                 output[asset_id] = {
-                    "asset_entity": asset,
+                    "asset_entity": asset_doc,
                     "subsets": {}
                 }
 
             if subset_id not in output[asset_id]["subsets"]:
                 output[asset_id]["subsets"][subset_id] = {
-                    "subset_entity": subset,
+                    "subset_entity": subset_doc,
                     "version": {
-                        "version_entity": version,
+                        "version_entity": version_doc,
                         "repres": []
                     }
                 }
 
             output[asset_id]["subsets"][subset_id]["version"]["repres"].append(
-                repre
+                repre_doc
             )
 
         return output
@@ -1790,35 +1754,19 @@ def get_custom_workfile_template_by_string_context(
             context. (Existence of formatted path is not validated.)
     """
 
-    if dbcon is None:
-        from openpype.pipeline import AvalonMongoDB
+    project_name = None
+    if anatomy is not None:
+        project_name = anatomy.project_name
 
-        dbcon = AvalonMongoDB()
+    if not project_name and dbcon is not None:
+        project_name = dbcon.active_project()
 
-    dbcon.install()
+    if not project_name:
+        raise ValueError("Can't determina project")
 
-    if dbcon.Session["AVALON_PROJECT"] != project_name:
-        dbcon.Session["AVALON_PROJECT"] = project_name
-
-    project_doc = dbcon.find_one(
-        {"type": "project"},
-        # All we need is "name" and "data.code" keys
-        {
-            "name": 1,
-            "data.code": 1
-        }
-    )
-    asset_doc = dbcon.find_one(
-        {
-            "type": "asset",
-            "name": asset_name
-        },
-        # All we need is "name" and "data.tasks" keys
-        {
-            "name": 1,
-            "data.tasks": 1
-        }
-    )
+    project_doc = get_project(project_name, fields=["name", "data.code"])
+    asset_doc = get_asset_by_name(
+        project_name, asset_name, fields=["name", "data.tasks"])
 
     return get_custom_workfile_template_by_context(
         template_profiles, project_doc, asset_doc, task_name, anatomy

From 57e0f576c82df6f1510e8954e99db98fb580d1d7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:18:19 +0200
Subject: [PATCH 0937/1227] removed unused import

---
 openpype/lib/avalon_context.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 7b00032027..9fc632aa27 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -7,8 +7,6 @@ import platform
 import logging
 import collections
 import functools
-
-from bson.objectid import ObjectId
 import warnings
 
 from openpype.client import (

From 13123a41277e08fec2345a888834c254e10c8034 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:18:34 +0200
Subject: [PATCH 0938/1227] get_system_general_anatomy_data can accept already
 prepare system settings

---
 openpype/lib/avalon_context.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 9fc632aa27..70a4e59279 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -262,8 +262,9 @@ def get_asset(asset_name=None):
     return asset_document
 
 
-def get_system_general_anatomy_data():
-    system_settings = get_system_settings()
+def get_system_general_anatomy_data(system_settings=None):
+    if not system_settings:
+        system_settings = get_system_settings()
     studio_name = system_settings["general"]["studio_name"]
     studio_code = system_settings["general"]["studio_code"]
     return {

From cb62b175719c9df96ca4641c7a93ad3b1f12777c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:29:54 +0200
Subject: [PATCH 0939/1227] added ability to receive all project documents

---
 openpype/client/__init__.py |  2 ++
 openpype/client/entities.py | 15 +++++++++++++++
 2 files changed, 17 insertions(+)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index e1c8ea9f03..4fee889f18 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -1,6 +1,7 @@
 from .entities import (
     get_projects,
     get_project,
+    get_whole_project,
 
     get_asset_by_id,
     get_asset_by_name,
@@ -40,6 +41,7 @@ from .entities import (
 __all__ = (
     "get_projects",
     "get_project",
+    "get_whole_project",
 
     "get_asset_by_id",
     "get_asset_by_name",
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 9771461d2e..698fba796d 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -94,6 +94,21 @@ def get_project(project_name, active=True, inactive=False, fields=None):
     return conn.find_one(query_filter, _prepare_fields(fields))
 
 
+def get_whole_project(project_name):
+    """Receive all documents from project.
+
+    Helper that can be used to get all document from whole project. For example
+    for backups etc.
+
+    Returns:
+        Cursor: Query cursor as iterable which returns all documents from
+            project collection.
+    """
+
+    conn = _get_project_connection(project_name)
+    return conn.find({})
+
+
 def get_asset_by_id(project_name, asset_id, fields=None):
     """Receive asset data by it's id.
 

From 7416508e8056bcab5de784b4dda4fea0c9859f92 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:33:21 +0200
Subject: [PATCH 0940/1227] use query functions in project backpack

---
 openpype/lib/project_backpack.py | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/openpype/lib/project_backpack.py b/openpype/lib/project_backpack.py
index 396479c725..f0188e6765 100644
--- a/openpype/lib/project_backpack.py
+++ b/openpype/lib/project_backpack.py
@@ -24,7 +24,10 @@ from bson.json_util import (
     dumps,
     CANONICAL_JSON_OPTIONS
 )
-
+from openpype.client import (
+    get_project,
+    get_whole_project,
+)
 from openpype.pipeline import AvalonMongoDB
 
 DOCUMENTS_FILE_NAME = "database"
@@ -55,9 +58,7 @@ def pack_project(project_name, destination_dir=None):
     """
     print("Creating package of project \"{}\"".format(project_name))
     # Validate existence of project
-    dbcon = AvalonMongoDB()
-    dbcon.Session["AVALON_PROJECT"] = project_name
-    project_doc = dbcon.find_one({"type": "project"})
+    project_doc = get_project(project_name)
     if not project_doc:
         raise ValueError("Project \"{}\" was not found in database".format(
             project_name
@@ -118,7 +119,7 @@ def pack_project(project_name, destination_dir=None):
         temp_docs_json = s.name
 
     # Query all project documents and store them to temp json
-    docs = list(dbcon.find({}))
+    docs = list(get_whole_project(project_name))
     data = dumps(
         docs, json_options=CANONICAL_JSON_OPTIONS
     )
@@ -147,7 +148,7 @@ def pack_project(project_name, destination_dir=None):
     # Cleanup
     os.remove(temp_docs_json)
     os.remove(temp_metadata_json)
-    dbcon.uninstall()
+
     print("*** Packing finished ***")
 
 
@@ -207,7 +208,7 @@ def unpack_project(path_to_zip, new_root=None):
         print("Using different root path {}".format(new_root))
         root_path = new_root
 
-        project_doc = collection.find_one({"type": "project"})
+        project_doc = get_project(project_name)
         roots = project_doc["config"]["roots"]
         key = tuple(roots.keys())[0]
         update_key = "config.roots.{}.{}".format(key, low_platform)

From 8f46a73ab710ed98a55b475dba44a558213d3a17 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:33:25 +0200
Subject: [PATCH 0941/1227] use query functions in applications

---
 openpype/lib/applications.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index a81bdeca0f..6bdf0a237f 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -11,6 +11,10 @@ from abc import ABCMeta, abstractmethod
 
 import six
 
+from openpype.client import (
+    get_project,
+    get_asset_by_name,
+)
 from openpype.settings import (
     get_system_settings,
     get_project_settings,
@@ -1313,11 +1317,8 @@ def get_app_environments_for_context(
     dbcon.install()
 
     # Project document
-    project_doc = dbcon.find_one({"type": "project"})
-    asset_doc = dbcon.find_one({
-        "type": "asset",
-        "name": asset_name
-    })
+    project_doc = get_project(project_name)
+    asset_doc = get_asset_by_name(project_name, asset_name)
 
     if modules_manager is None:
         from openpype.modules import ModulesManager

From eed6acd53c36e7c831d0201cb9d45a9dd31768fd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:50:36 +0200
Subject: [PATCH 0942/1227] use query function in plugin tools

---
 openpype/lib/plugin_tools.py | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/openpype/lib/plugin_tools.py b/openpype/lib/plugin_tools.py
index bcbf06a0e8..1d3c1eec6b 100644
--- a/openpype/lib/plugin_tools.py
+++ b/openpype/lib/plugin_tools.py
@@ -6,10 +6,10 @@ import logging
 import re
 import json
 
-from .profiles_filtering import filter_profiles
-
+from openpype.client import get_asset_by_id
 from openpype.settings import get_project_settings
 
+from .profiles_filtering import filter_profiles
 
 log = logging.getLogger(__name__)
 
@@ -135,24 +135,17 @@ def get_subset_name(
     This is legacy function should be replaced with
     `get_subset_name_with_asset_doc` where asset document is expected.
     """
-    if dbcon is None:
-        from openpype.pipeline import AvalonMongoDB
 
-        dbcon = AvalonMongoDB()
-        dbcon.Session["AVALON_PROJECT"] = project_name
+    if project_name is None:
+        project_name = dbcon.project_name
 
-    dbcon.install()
-
-    asset_doc = dbcon.find_one(
-        {"_id": asset_id},
-        {"data.tasks": True}
-    ) or {}
+    asset_doc = get_asset_by_id(project_name, asset_id, fields=["data.tasks"])
 
     return get_subset_name_with_asset_doc(
         family,
         variant,
         task_name,
-        asset_doc,
+        asset_doc or {},
         project_name,
         host_name,
         default_template,

From 720aba7c44e24cd80cbcb3d498e73ec3cf503659 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:53:24 +0200
Subject: [PATCH 0943/1227] modified usdlib to use query functions and use
 anatomy for formatting

---
 openpype/lib/usdlib.py | 37 ++++++++++++++++++++++---------------
 1 file changed, 22 insertions(+), 15 deletions(-)

diff --git a/openpype/lib/usdlib.py b/openpype/lib/usdlib.py
index 86de19b4be..2943f6660a 100644
--- a/openpype/lib/usdlib.py
+++ b/openpype/lib/usdlib.py
@@ -8,10 +8,9 @@ except ImportError:
     # Allow to fall back on Multiverse 6.3.0+ pxr usd library
     from mvpxr import Usd, UsdGeom, Sdf, Kind
 
-from openpype.pipeline import (
-    registered_root,
-    legacy_io,
-)
+from openpype.client import get_project, get_asset_by_name
+from openpype.pipeline import legacy_io
+from openpypa.lib import Anatomy
 
 log = logging.getLogger(__name__)
 
@@ -128,7 +127,8 @@ def create_model(filename, asset, variant_subsets):
 
     """
 
-    asset_doc = legacy_io.find_one({"name": asset, "type": "asset"})
+    project_name = legacy_io.active_project()
+    asset_doc = get_asset_by_name(project_name, asset)
     assert asset_doc, "Asset not found: %s" % asset
 
     variants = []
@@ -178,7 +178,8 @@ def create_shade(filename, asset, variant_subsets):
 
     """
 
-    asset_doc = legacy_io.find_one({"name": asset, "type": "asset"})
+    project_name = legacy_io.active_project()
+    asset_doc = get_asset_by_name(project_name, asset)
     assert asset_doc, "Asset not found: %s" % asset
 
     variants = []
@@ -213,7 +214,8 @@ def create_shade_variation(filename, asset, model_variant, shade_variants):
 
     """
 
-    asset_doc = legacy_io.find_one({"name": asset, "type": "asset"})
+    project_name = legacy_io.active_project()
+    asset_doc = get_asset_by_name(project_name, asset)
     assert asset_doc, "Asset not found: %s" % asset
 
     variants = []
@@ -313,21 +315,25 @@ def get_usd_master_path(asset, subset, representation):
 
     """
 
-    project = legacy_io.find_one(
-        {"type": "project"}, projection={"config.template.publish": True}
+    project_name = legacy_io.active_project()
+    anatomy = Anatomy(project_name)
+    project_doc = get_project(
+        project_name,
+        fields=["name", "data.code"]
     )
-    template = project["config"]["template"]["publish"]
 
     if isinstance(asset, dict) and "name" in asset:
         # Allow explicitly passing asset document
         asset_doc = asset
     else:
-        asset_doc = legacy_io.find_one({"name": asset, "type": "asset"})
+        asset_doc = get_asset_by_name(project_name, asset, fields=["name"])
 
-    path = template.format(
-        **{
-            "root": registered_root(),
-            "project": legacy_io.Session["AVALON_PROJECT"],
+    formatted_result = anatomy.format(
+        {
+            "project": {
+                "name": project_name,
+                "code": project_doc.get("data", {}).get("code")
+            },
             "asset": asset_doc["name"],
             "subset": subset,
             "representation": representation,
@@ -335,6 +341,7 @@ def get_usd_master_path(asset, subset, representation):
         }
     )
 
+    path = formatted_result["publish"]["path"]
     # Remove the version folder
     subset_folder = os.path.dirname(os.path.dirname(path))
     master_folder = os.path.join(subset_folder, "master")

From 2296a56118265962c87b9c44964affff9fabb129 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 16:56:15 +0200
Subject: [PATCH 0944/1227] fix anatomy import

---
 openpype/lib/usdlib.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/lib/usdlib.py b/openpype/lib/usdlib.py
index 2943f6660a..20703ee308 100644
--- a/openpype/lib/usdlib.py
+++ b/openpype/lib/usdlib.py
@@ -9,8 +9,7 @@ except ImportError:
     from mvpxr import Usd, UsdGeom, Sdf, Kind
 
 from openpype.client import get_project, get_asset_by_name
-from openpype.pipeline import legacy_io
-from openpypa.lib import Anatomy
+from openpype.pipeline import legacy_io, Anatomy
 
 log = logging.getLogger(__name__)
 

From bdff4d5eb0c03ec2a6687e3baa963f6dc5f50cf4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 17:05:13 +0200
Subject: [PATCH 0945/1227] modified docstring

---
 openpype/client/entities.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 698fba796d..cb20916153 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -1180,9 +1180,8 @@ def get_workfile_info(
 
     Warning:
         Query is based on filename and context which does not meant it will
-        find always right expected result. There is a limited amound of usage
-        and is recommended to not expect that all workfiles are stored in
-        database.
+        find always right and expected result. Information have limited usage
+        and is not recommended to use it as source information about workfile.
 
     Args:
         project_name (str): Name of project where to look for queried entities.

From 49cb5a3e162a40e31c02d66bbbe2b2ad90a2b246 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 17:28:22 +0200
Subject: [PATCH 0946/1227] hound fixes

---
 openpype/lib/avalon_context.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 70a4e59279..61976f5a5b 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -371,7 +371,9 @@ def get_latest_version(asset_name, subset_name, dbcon=None, project_name=None):
         )
         return None
 
-    version_doc = get_last_version_by_subset_id(project_name, subset_doc["_id"])
+    version_doc = get_last_version_by_subset_id(
+        project_name, subset_doc["_id"]
+    )
     if not version_doc:
         log.info(
             "Subset \"{}\" does not have any version yet.".format(subset_name)
@@ -960,7 +962,9 @@ class BuildWorkfile:
         # Get current asset name and entity
         project_name = legacy_io.active_project()
         current_asset_name = legacy_io.Session["AVALON_ASSET"]
-        current_asset_entity = get_asset_by_name(project_name, current_asset_name)
+        current_asset_entity = get_asset_by_name(
+            project_name, current_asset_name
+        )
         # Skip if asset was not found
         if not current_asset_entity:
             print("Asset entity with name `{}` was not found".format(

From 728bfd6571ead30f3971578f5c4767c85fdde378 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 17:56:30 +0200
Subject: [PATCH 0947/1227] normalize workdir

---
 openpype/lib/avalon_context.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index a03f066300..5ff3b15119 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -604,7 +604,10 @@ def get_workdir_with_workdir_data(
 
     anatomy_filled = anatomy.format(workdir_data)
     # Output is TemplateResult object which contain useful data
-    return anatomy_filled[template_key]["folder"]
+    path = anatomy_filled[template_key]["folder"]
+    if path:
+        path = os.path.normpath(path)
+    return path
 
 
 def get_workdir(

From 3bf3c0bab4fb73efa3c736df6890609767163151 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 17:56:54 +0200
Subject: [PATCH 0948/1227] modified anatomy imports in lib itself

---
 openpype/lib/applications.py   | 7 ++-----
 openpype/lib/avalon_context.py | 9 ++++++++-
 openpype/lib/path_tools.py     | 2 +-
 3 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index a81bdeca0f..d229848645 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -20,10 +20,7 @@ from openpype.settings.constants import (
     METADATA_KEYS,
     M_DYNAMIC_KEY_LABEL
 )
-from . import (
-    PypeLogger,
-    Anatomy
-)
+from . import PypeLogger
 from .profiles_filtering import filter_profiles
 from .local_settings import get_openpype_username
 from .avalon_context import (
@@ -1305,7 +1302,7 @@ def get_app_environments_for_context(
         dict: Environments for passed context and application.
     """
 
-    from openpype.pipeline import AvalonMongoDB
+    from openpype.pipeline import AvalonMongoDB, Anatomy
 
     # Avalon database connection
     dbcon = AvalonMongoDB()
diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 5ff3b15119..a7078f9eca 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -14,7 +14,6 @@ from openpype.settings import (
     get_project_settings,
     get_system_settings
 )
-from .anatomy import Anatomy
 from .profiles_filtering import filter_profiles
 from .events import emit_event
 from .path_templates import StringTemplate
@@ -593,6 +592,7 @@ def get_workdir_with_workdir_data(
         ))
 
     if not anatomy:
+        from openpype.pipeline import Anatomy
         anatomy = Anatomy(project_name)
 
     if not template_key:
@@ -638,6 +638,7 @@ def get_workdir(
         TemplateResult: Workdir path.
     """
     if not anatomy:
+        from openpype.pipeline import Anatomy
         anatomy = Anatomy(project_doc["name"])
 
     workdir_data = get_workdir_data(
@@ -750,6 +751,8 @@ def compute_session_changes(
 
 @with_pipeline_io
 def get_workdir_from_session(session=None, template_key=None):
+    from openpype.pipeline import Anatomy
+
     if session is None:
         session = legacy_io.Session
     project_name = session["AVALON_PROJECT"]
@@ -856,6 +859,8 @@ def create_workfile_doc(asset_doc, task_name, filename, workdir, dbcon=None):
         dbcon (AvalonMongoDB): Optionally enter avalon AvalonMongoDB object and
             `legacy_io` is used if not entered.
     """
+    from openpype.pipeline import Anatomy
+
     # Use legacy_io if dbcon is not entered
     if not dbcon:
         dbcon = legacy_io
@@ -1676,6 +1681,7 @@ def _get_task_context_data_for_anatomy(
     """
 
     if anatomy is None:
+        from openpype.pipeline import Anatomy
         anatomy = Anatomy(project_doc["name"])
 
     asset_name = asset_doc["name"]
@@ -1744,6 +1750,7 @@ def get_custom_workfile_template_by_context(
     """
 
     if anatomy is None:
+        from openpype.pipeline import Anatomy
         anatomy = Anatomy(project_doc["name"])
 
     # get project, asset, task anatomy context data
diff --git a/openpype/lib/path_tools.py b/openpype/lib/path_tools.py
index caad20f4d6..4f28be3302 100644
--- a/openpype/lib/path_tools.py
+++ b/openpype/lib/path_tools.py
@@ -9,7 +9,6 @@ import platform
 from openpype.client import get_project
 from openpype.settings import get_project_settings
 
-from .anatomy import Anatomy
 from .profiles_filtering import filter_profiles
 
 log = logging.getLogger(__name__)
@@ -227,6 +226,7 @@ def fill_paths(path_list, anatomy):
 
 
 def create_project_folders(basic_paths, project_name):
+    from openpype.pipeline import Anatomy
     anatomy = Anatomy(project_name)
 
     concat_paths = concatenate_splitted_paths(basic_paths, anatomy)

From a2b8df6964010f9d835022ef9c28c74f87dfbfbc Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 30 Jun 2022 18:04:45 +0200
Subject: [PATCH 0949/1227] normalize when workdir is received from session

---
 openpype/lib/avalon_context.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index a7078f9eca..616460410e 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -768,7 +768,10 @@ def get_workdir_from_session(session=None, template_key=None):
             host_name,
             project_name=project_name
         )
-    return anatomy_filled[template_key]["folder"]
+    path = anatomy_filled[template_key]["folder"]
+    if path:
+        path = os.path.normpath(path)
+    return path
 
 
 @with_pipeline_io

From a9462ac4ed89db38f0895d6ce14190c44ee77cb4 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 30 Jun 2022 22:20:02 +0200
Subject: [PATCH 0950/1227] Nuke: fixing metadata slate TC difference

---
 .../nuke/plugins/publish/extract_slate_frame.py   | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
index 6d930d358d..6997180c9f 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
@@ -152,6 +152,7 @@ class ExtractSlateFrame(openpype.api.Extractor):
         self.log.debug("__ first_frame: {}".format(first_frame))
         self.log.debug("__ slate_first_frame: {}".format(slate_first_frame))
 
+        above_slate_node = slate_node.dependencies().pop()
         # fallback if files does not exists
         if self._check_frames_exists(instance):
             # Read node
@@ -164,8 +165,16 @@ class ExtractSlateFrame(openpype.api.Extractor):
             r_node["colorspace"].setValue(instance.data["colorspace"])
             previous_node = r_node
             temporary_nodes = [previous_node]
+
+            # adding copy metadata node for correct frame metadata
+            cm_node = nuke.createNode("CopyMetaData")
+            cm_node.setInput(0, previous_node)
+            cm_node.setInput(1, above_slate_node)
+            previous_node = cm_node
+            temporary_nodes.append(cm_node)
+
         else:
-            previous_node = slate_node.dependencies().pop()
+            previous_node = above_slate_node
             temporary_nodes = []
 
         # only create colorspace baking if toggled on
@@ -221,8 +230,8 @@ class ExtractSlateFrame(openpype.api.Extractor):
             write_node.name(), int(slate_first_frame), int(slate_first_frame))
 
         # Clean up
-        for node in temporary_nodes:
-            nuke.delete(node)
+        # for node in temporary_nodes:
+        #     nuke.delete(node)
 
     def _render_slate_to_sequence(self, instance):
         # set slate frame

From 9d556a9ae8f3f42770c4296cd799a427674db062 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 30 Jun 2022 23:47:27 +0200
Subject: [PATCH 0951/1227] Match set path logic more to Arnold VDB loader from
 #3433

---
 .../maya/plugins/load/load_vdb_to_redshift.py | 52 +++++++------------
 1 file changed, 20 insertions(+), 32 deletions(-)

diff --git a/openpype/hosts/maya/plugins/load/load_vdb_to_redshift.py b/openpype/hosts/maya/plugins/load/load_vdb_to_redshift.py
index 7867f49bd1..c6a69dfe35 100644
--- a/openpype/hosts/maya/plugins/load/load_vdb_to_redshift.py
+++ b/openpype/hosts/maya/plugins/load/load_vdb_to_redshift.py
@@ -84,7 +84,9 @@ class LoadVDBtoRedShift(load.LoaderPlugin):
                                       name="{}RVSShape".format(label),
                                       parent=root)
 
-        self._apply_settings(volume_node, path=self.fname)
+        self._set_path(volume_node,
+                       path=self.fname,
+                       representation=context["representation"])
 
         nodes = [root, volume_node]
         self[:] = nodes
@@ -96,36 +98,6 @@ class LoadVDBtoRedShift(load.LoaderPlugin):
             context=context,
             loader=self.__class__.__name__)
 
-    def _apply_settings(self,
-                        grid_node,
-                        path):
-        """Apply the settings for the VDB path to the VRayVolumeGrid"""
-        from maya import cmds
-
-        # The path points to a single file. However the vdb files could be
-        # either just that single file or a sequence in a folder so we check
-        # whether it's a sequence
-        folder = os.path.dirname(path)
-        files = os.listdir(folder)
-        is_single_file = len(files) == 1
-        if is_single_file:
-            filename = path
-        else:
-            # The path points to the publish .vdb sequence filepath so we
-            # find the first file in there that ends with .vdb
-            files = sorted(files)
-            first = next((x for x in files if x.endswith(".vdb")), None)
-            if first is None:
-                raise RuntimeError("Couldn't find first .vdb file of "
-                                   "sequence in: %s" % path)
-            filename = os.path.join(path, first)
-
-        # Tell Redshift whether it should load as sequence or single file
-        cmds.setAttr(grid_node + ".useFrameExtension", not is_single_file)
-
-        # Set file path
-        cmds.setAttr(grid_node + ".fileName", filename, type="string")
-
     def update(self, container, representation):
         from maya import cmds
 
@@ -137,7 +109,7 @@ class LoadVDBtoRedShift(load.LoaderPlugin):
         assert len(grid_nodes) == 1, "This is a bug"
 
         # Update the VRayVolumeGrid
-        self._apply_settings(grid_nodes[0], path=path)
+        self._set_path(grid_nodes[0], path=path, representation=representation)
 
         # Update container representation
         cmds.setAttr(container["objectName"] + ".representation",
@@ -162,3 +134,19 @@ class LoadVDBtoRedShift(load.LoaderPlugin):
 
     def switch(self, container, representation):
         self.update(container, representation)
+
+    @staticmethod
+    def _set_path(grid_node,
+                  path,
+                  representation):
+        """Apply the settings for the VDB path to the RedshiftVolumeShape"""
+        from maya import cmds
+
+        if not os.path.exists(path):
+            raise RuntimeError("Path does not exist: %s" % path)
+
+        is_sequence = bool(representation["context"].get("frame"))
+        cmds.setAttr(grid_node + ".useFrameExtension", is_sequence)
+
+        # Set file path
+        cmds.setAttr(grid_node + ".fileName", path, type="string")

From b35d8886e2b0070abde920cd5a18b8786f7575aa Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 09:16:51 +0200
Subject: [PATCH 0952/1227] use query functions in avalon rest api calls

---
 openpype/modules/avalon_apps/rest_api.py | 37 +++++++++---------------
 1 file changed, 13 insertions(+), 24 deletions(-)

diff --git a/openpype/modules/avalon_apps/rest_api.py b/openpype/modules/avalon_apps/rest_api.py
index b35f5bf357..a52ce1b6df 100644
--- a/openpype/modules/avalon_apps/rest_api.py
+++ b/openpype/modules/avalon_apps/rest_api.py
@@ -5,7 +5,12 @@ from bson.objectid import ObjectId
 
 from aiohttp.web_response import Response
 
-from openpype.pipeline import AvalonMongoDB
+from openpype.client import (
+    get_projects,
+    get_project,
+    get_assets,
+    get_asset_by_name,
+)
 from openpype_modules.webserver.base_routes import RestApiEndpoint
 
 
@@ -14,19 +19,13 @@ class _RestApiEndpoint(RestApiEndpoint):
         self.resource = resource
         super(_RestApiEndpoint, self).__init__()
 
-    @property
-    def dbcon(self):
-        return self.resource.dbcon
-
 
 class AvalonProjectsEndpoint(_RestApiEndpoint):
     async def get(self) -> Response:
-        output = []
-        for project_name in self.dbcon.database.collection_names():
-            project_doc = self.dbcon.database[project_name].find_one({
-                "type": "project"
-            })
-            output.append(project_doc)
+        output = [
+            project_doc
+            for project_doc in get_projects()
+        ]
         return Response(
             status=200,
             body=self.resource.encode(output),
@@ -36,9 +35,7 @@ class AvalonProjectsEndpoint(_RestApiEndpoint):
 
 class AvalonProjectEndpoint(_RestApiEndpoint):
     async def get(self, project_name) -> Response:
-        project_doc = self.dbcon.database[project_name].find_one({
-            "type": "project"
-        })
+        project_doc = get_project(project_name)
         if project_doc:
             return Response(
                 status=200,
@@ -53,9 +50,7 @@ class AvalonProjectEndpoint(_RestApiEndpoint):
 
 class AvalonAssetsEndpoint(_RestApiEndpoint):
     async def get(self, project_name) -> Response:
-        asset_docs = list(self.dbcon.database[project_name].find({
-            "type": "asset"
-        }))
+        asset_docs = list(get_assets(project_name))
         return Response(
             status=200,
             body=self.resource.encode(asset_docs),
@@ -65,10 +60,7 @@ class AvalonAssetsEndpoint(_RestApiEndpoint):
 
 class AvalonAssetEndpoint(_RestApiEndpoint):
     async def get(self, project_name, asset_name) -> Response:
-        asset_doc = self.dbcon.database[project_name].find_one({
-            "type": "asset",
-            "name": asset_name
-        })
+        asset_doc = get_asset_by_name(project_name, asset_name)
         if asset_doc:
             return Response(
                 status=200,
@@ -88,9 +80,6 @@ class AvalonRestApiResource:
         self.module = avalon_module
         self.server_manager = server_manager
 
-        self.dbcon = AvalonMongoDB()
-        self.dbcon.install()
-
         self.prefix = "/avalon"
 
         self.endpoint_defs = (

From f18a9833a62a0f1910976e00c36668be58d6ce0a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 09:40:38 +0200
Subject: [PATCH 0953/1227] use query functions in clockify launcher actions

---
 .../launcher_actions/ClockifyStart.py         | 30 +++++--------
 .../clockify/launcher_actions/ClockifySync.py | 44 ++++++++-----------
 2 files changed, 29 insertions(+), 45 deletions(-)

diff --git a/openpype/modules/clockify/launcher_actions/ClockifyStart.py b/openpype/modules/clockify/launcher_actions/ClockifyStart.py
index 4669f98b01..7663aecc31 100644
--- a/openpype/modules/clockify/launcher_actions/ClockifyStart.py
+++ b/openpype/modules/clockify/launcher_actions/ClockifyStart.py
@@ -1,16 +1,9 @@
-from openpype.api import Logger
-from openpype.pipeline import (
-    legacy_io,
-    LauncherAction,
-)
+from openpype.client import get_asset_by_name
+from openpype.pipeline import LauncherAction
 from openpype_modules.clockify.clockify_api import ClockifyAPI
 
 
-log = Logger.get_logger(__name__)
-
-
 class ClockifyStart(LauncherAction):
-
     name = "clockify_start_timer"
     label = "Clockify - Start Timer"
     icon = "clockify_icon"
@@ -24,20 +17,19 @@ class ClockifyStart(LauncherAction):
         return False
 
     def process(self, session, **kwargs):
-        project_name = session['AVALON_PROJECT']
-        asset_name = session['AVALON_ASSET']
-        task_name = session['AVALON_TASK']
+        project_name = session["AVALON_PROJECT"]
+        asset_name = session["AVALON_ASSET"]
+        task_name = session["AVALON_TASK"]
 
         description = asset_name
-        asset = legacy_io.find_one({
-            'type': 'asset',
-            'name': asset_name
-        })
-        if asset is not None:
-            desc_items = asset.get('data', {}).get('parents', [])
+        asset_doc = get_asset_by_name(
+            project_name, asset_name, fields=["data.parents"]
+        )
+        if asset_doc is not None:
+            desc_items = asset_doc.get("data", {}).get("parents", [])
             desc_items.append(asset_name)
             desc_items.append(task_name)
-            description = '/'.join(desc_items)
+            description = "/".join(desc_items)
 
         project_id = self.clockapi.get_project_id(project_name)
         tag_ids = []
diff --git a/openpype/modules/clockify/launcher_actions/ClockifySync.py b/openpype/modules/clockify/launcher_actions/ClockifySync.py
index 356bbd0306..c346a1b4f6 100644
--- a/openpype/modules/clockify/launcher_actions/ClockifySync.py
+++ b/openpype/modules/clockify/launcher_actions/ClockifySync.py
@@ -1,11 +1,6 @@
+from openpype.client import get_projects, get_project
 from openpype_modules.clockify.clockify_api import ClockifyAPI
-from openpype.api import Logger
-from openpype.pipeline import (
-    legacy_io,
-    LauncherAction,
-)
-
-log = Logger.get_logger(__name__)
+from openpype.pipeline import LauncherAction
 
 
 class ClockifySync(LauncherAction):
@@ -22,39 +17,36 @@ class ClockifySync(LauncherAction):
         return self.have_permissions
 
     def process(self, session, **kwargs):
-        project_name = session.get('AVALON_PROJECT', None)
+        project_name = session.get("AVALON_PROJECT") or ""
 
         projects_to_sync = []
-        if project_name.strip() == '' or project_name is None:
-            for project in legacy_io.projects():
-                projects_to_sync.append(project)
+        if project_name.strip():
+            projects_to_sync = [get_project(project_name)]
         else:
-            project = legacy_io.find_one({'type': 'project'})
-            projects_to_sync.append(project)
+            projects_to_sync = get_projects()
 
         projects_info = {}
         for project in projects_to_sync:
-            task_types = project['config']['tasks'].keys()
-            projects_info[project['name']] = task_types
+            task_types = project["config"]["tasks"].keys()
+            projects_info[project["name"]] = task_types
 
         clockify_projects = self.clockapi.get_projects()
         for project_name, task_types in projects_info.items():
-            if project_name not in clockify_projects:
-                response = self.clockapi.add_project(project_name)
-                if 'id' not in response:
-                    self.log.error('Project {} can\'t be created'.format(
-                        project_name
-                    ))
-                    continue
-                project_id = response['id']
-            else:
-                project_id = clockify_projects[project_name]
+            if project_name in clockify_projects:
+                continue
+
+            response = self.clockapi.add_project(project_name)
+            if "id" not in response:
+                self.log.error("Project {} can't be created".format(
+                    project_name
+                ))
+                continue
 
             clockify_workspace_tags = self.clockapi.get_tags()
             for task_type in task_types:
                 if task_type not in clockify_workspace_tags:
                     response = self.clockapi.add_tag(task_type)
-                    if 'id' not in response:
+                    if "id" not in response:
                         self.log.error('Task {} can\'t be created'.format(
                             task_type
                         ))

From 7dc7bde29334a0debe738af6ef6f07d374f40bcf Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 10:48:33 +0200
Subject: [PATCH 0954/1227] subset documents can be queried based on
 combination of asset id and subset names

---
 openpype/client/entities.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 28cd994254..5e242ea180 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -381,6 +381,7 @@ def get_subsets(
     subset_ids=None,
     subset_names=None,
     asset_ids=None,
+    names_by_asset_ids=None,
     archived=False,
     fields=None
 ):
@@ -396,6 +397,9 @@ def get_subsets(
             Filter ignored if 'None' is passed.
         asset_ids (list[str|ObjectId]): Asset ids under which should look for
             the subsets. Filter ignored if 'None' is passed.
+        names_by_asset_ids (dict[ObjectId, list[str]]): Complex filtering
+            using asset ids and list of subset names under the asset.
+        archived (bool): Look for archived subsets too.
         fields (list[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
@@ -429,6 +433,18 @@ def get_subsets(
             return []
         query_filter["name"] = {"$in": list(subset_names)}
 
+    if names_by_asset_ids is not None:
+        or_query = []
+        for asset_id, names in names_by_asset_ids.items():
+            if asset_id and names:
+                or_query.append({
+                    "parent": _convert_id(asset_id),
+                    "name": {"$in": list(names)}
+                })
+        if not or_query:
+            return []
+        query_filter["$or"] = or_query
+
     conn = _get_project_connection(project_name)
     return conn.find(query_filter, _prepare_fields(fields))
 

From de4147ef93c2c45631b72664d067d7c070887f48 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 10:49:06 +0200
Subject: [PATCH 0955/1227] get last version does not do double query if only
 _id, name or parent are requested

---
 openpype/client/entities.py | 50 ++++++++++++++++++++++++++++++++-----
 1 file changed, 44 insertions(+), 6 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 5e242ea180..aed465c46f 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -755,7 +755,10 @@ def get_last_versions(project_name, subset_ids, fields=None):
     """Latest versions for entered subset_ids.
 
     Args:
+        project_name (str): Name of project where to look for queried entities.
         subset_ids (list): List of subset ids.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
 
     Returns:
         dict[ObjectId, int]: Key is subset id and value is last version name.
@@ -765,7 +768,34 @@ def get_last_versions(project_name, subset_ids, fields=None):
     if not subset_ids:
         return {}
 
-    _pipeline = [
+    if fields is not None:
+        fields = list(fields)
+        if not fields:
+            return {}
+
+    # Avoid double query if only name and _id are requested
+    name_needed = False
+    limit_query = False
+    if fields:
+        fields_s = set(fields)
+        if "name" in fields_s:
+            name_needed = True
+            fields_s.remove("name")
+
+        for field in ("_id", "parent"):
+            if field in fields_s:
+                fields_s.remove(field)
+        limit_query = len(fields_s) == 0
+
+    group_item = {
+        "_id": "$parent",
+        "_version_id": {"$last": "$_id"}
+    }
+    # Add name if name is needed (only for limit query)
+    if name_needed:
+        group_item["name"] = {"$last": "$name"}
+
+    aggregation_pipeline = [
         # Find all versions of those subsets
         {"$match": {
             "type": "version",
@@ -774,16 +804,24 @@ def get_last_versions(project_name, subset_ids, fields=None):
         # Sorting versions all together
         {"$sort": {"name": 1}},
         # Group them by "parent", but only take the last
-        {"$group": {
-            "_id": "$parent",
-            "_version_id": {"$last": "$_id"}
-        }}
+        {"$group": group_item}
     ]
 
     conn = _get_project_connection(project_name)
+    aggregate_result = conn.aggregate(aggregation_pipeline)
+    if limit_query:
+        output = {}
+        for item in aggregate_result:
+            subset_id = item["_id"]
+            item_data = {"_id": item["_version_id"], "parent": subset_id}
+            if name_needed:
+                item_data["name"] = item["name"]
+            output[subset_id] = item_data
+        return output
+
     version_ids = [
         doc["_version_id"]
-        for doc in conn.aggregate(_pipeline)
+        for doc in aggregate_result
     ]
 
     fields = _prepare_fields(fields, ["parent"])

From f5cceb3e056e71c2204df75b1eb6b87598f161a1 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 10:49:39 +0200
Subject: [PATCH 0956/1227] use query functions in delete old versions

---
 openpype/plugins/load/delete_old_versions.py | 37 +++++++++-----------
 1 file changed, 16 insertions(+), 21 deletions(-)

diff --git a/openpype/plugins/load/delete_old_versions.py b/openpype/plugins/load/delete_old_versions.py
index 7465f53855..039893aa54 100644
--- a/openpype/plugins/load/delete_old_versions.py
+++ b/openpype/plugins/load/delete_old_versions.py
@@ -8,6 +8,7 @@ import ftrack_api
 import qargparse
 from Qt import QtWidgets, QtCore
 
+from openpype.client import get_versions, get_representations
 from openpype import style
 from openpype.pipeline import load, AvalonMongoDB, Anatomy
 from openpype.lib import StringTemplate
@@ -197,18 +198,10 @@ class DeleteOldVersions(load.SubsetLoaderPlugin):
     def get_data(self, context, versions_count):
         subset = context["subset"]
         asset = context["asset"]
-        anatomy = Anatomy(context["project"]["name"])
+        project_name = context["project"]["name"]
+        anatomy = Anatomy(project_name)
 
-        self.dbcon = AvalonMongoDB()
-        self.dbcon.Session["AVALON_PROJECT"] = context["project"]["name"]
-        self.dbcon.install()
-
-        versions = list(
-            self.dbcon.find({
-                "type": "version",
-                "parent": {"$in": [subset["_id"]]}
-            })
-        )
+        versions = list(get_versions(project_name, subset_ids=[subset["_id"]]))
 
         versions_by_parent = collections.defaultdict(list)
         for ent in versions:
@@ -267,10 +260,9 @@ class DeleteOldVersions(load.SubsetLoaderPlugin):
             print(msg)
             return
 
-        repres = list(self.dbcon.find({
-            "type": "representation",
-            "parent": {"$in": version_ids}
-        }))
+        repres = list(get_representations(
+            project_name, version_ids=version_ids
+        ))
 
         self.log.debug(
             "Collected representations to remove ({})".format(len(repres))
@@ -329,7 +321,7 @@ class DeleteOldVersions(load.SubsetLoaderPlugin):
 
         return data
 
-    def main(self, data, remove_publish_folder):
+    def main(self, project_name, data, remove_publish_folder):
         # Size of files.
         size = 0
         if not data:
@@ -366,9 +358,11 @@ class DeleteOldVersions(load.SubsetLoaderPlugin):
             ))
 
         if mongo_changes_bulk:
-            self.dbcon.bulk_write(mongo_changes_bulk)
-
-        self.dbcon.uninstall()
+            dbcon = AvalonMongoDB()
+            dbcon.Session["AVALON_PROJECT"] = project_name
+            dbcon.install()
+            dbcon.bulk_write(mongo_changes_bulk)
+            dbcon.uninstall()
 
         # Set attribute `is_published` to `False` on ftrack AssetVersions
         session = ftrack_api.Session()
@@ -422,7 +416,8 @@ class DeleteOldVersions(load.SubsetLoaderPlugin):
                 if not data:
                     continue
 
-                size += self.main(data, remove_publish_folder)
+                project_name = context["project"]["name"]
+                size += self.main(project_name, data, remove_publish_folder)
                 print("Progressing {}/{}".format(count + 1, len(contexts)))
 
             msg = "Total size of files: " + self.sizeof_fmt(size)
@@ -448,7 +443,7 @@ class CalculateOldVersions(DeleteOldVersions):
         )
     ]
 
-    def main(self, data, remove_publish_folder):
+    def main(self, project_name, data, remove_publish_folder):
         size = 0
 
         if not data:

From bc2f8387fe5eb31f70aa7c39fd3cb67848d23cbf Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 10:50:06 +0200
Subject: [PATCH 0957/1227] delivery is using guery functions

---
 openpype/plugins/load/delivery.py | 22 +++++++++-------------
 1 file changed, 9 insertions(+), 13 deletions(-)

diff --git a/openpype/plugins/load/delivery.py b/openpype/plugins/load/delivery.py
index 0361ab2be5..7585ea4c59 100644
--- a/openpype/plugins/load/delivery.py
+++ b/openpype/plugins/load/delivery.py
@@ -3,8 +3,9 @@ from collections import defaultdict
 
 from Qt import QtWidgets, QtCore, QtGui
 
+from openpype.client import get_representations
 from openpype.lib import config
-from openpype.pipeline import load, AvalonMongoDB, Anatomy
+from openpype.pipeline import load, Anatomy
 from openpype import resources, style
 
 from openpype.lib.delivery import (
@@ -68,17 +69,13 @@ class DeliveryOptionsDialog(QtWidgets.QDialog):
 
         self.setStyleSheet(style.load_stylesheet())
 
-        project = contexts[0]["project"]["name"]
-        self.anatomy = Anatomy(project)
+        project_name = contexts[0]["project"]["name"]
+        self.anatomy = Anatomy(project_name)
         self._representations = None
         self.log = log
         self.currently_uploaded = 0
 
-        self.dbcon = AvalonMongoDB()
-        self.dbcon.Session["AVALON_PROJECT"] = project
-        self.dbcon.install()
-
-        self._set_representations(contexts)
+        self._set_representations(project_name, contexts)
 
         dropdown = QtWidgets.QComboBox()
         self.templates = self._get_templates(self.anatomy)
@@ -238,13 +235,12 @@ class DeliveryOptionsDialog(QtWidgets.QDialog):
 
         return templates
 
-    def _set_representations(self, contexts):
+    def _set_representations(self, project_name, contexts):
         version_ids = [context["version"]["_id"] for context in contexts]
 
-        repres = list(self.dbcon.find({
-            "type": "representation",
-            "parent": {"$in": version_ids}
-        }))
+        repres = list(get_representations(
+            project_name, version_ids=version_ids
+        ))
 
         self._representations = repres
 

From 3f3ae1fd7dabd3908543ec0fb7d8ab66b0e8f9a3 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 10:58:44 +0200
Subject: [PATCH 0958/1227] use query functions in collect anatomy instance
 data

---
 .../publish/collect_anatomy_instance_data.py  | 78 ++++++-------------
 1 file changed, 24 insertions(+), 54 deletions(-)

diff --git a/openpype/plugins/publish/collect_anatomy_instance_data.py b/openpype/plugins/publish/collect_anatomy_instance_data.py
index 6a6ea170b5..c75534cf83 100644
--- a/openpype/plugins/publish/collect_anatomy_instance_data.py
+++ b/openpype/plugins/publish/collect_anatomy_instance_data.py
@@ -27,6 +27,11 @@ import collections
 
 import pyblish.api
 
+from openpype.client import (
+    get_assets,
+    get_subsets,
+    get_last_versions
+)
 from openpype.pipeline import legacy_io
 
 
@@ -44,13 +49,14 @@ class CollectAnatomyInstanceData(pyblish.api.ContextPlugin):
     def process(self, context):
         self.log.info("Collecting anatomy data for all instances.")
 
-        self.fill_missing_asset_docs(context)
-        self.fill_latest_versions(context)
+        project_name = legacy_io.active_project()
+        self.fill_missing_asset_docs(context, project_name)
+        self.fill_latest_versions(context, project_name)
         self.fill_anatomy_data(context)
 
         self.log.info("Anatomy Data collection finished.")
 
-    def fill_missing_asset_docs(self, context):
+    def fill_missing_asset_docs(self, context, project_name):
         self.log.debug("Qeurying asset documents for instances.")
 
         context_asset_doc = context.data.get("assetEntity")
@@ -84,10 +90,8 @@ class CollectAnatomyInstanceData(pyblish.api.ContextPlugin):
         self.log.debug("Querying asset documents with names: {}".format(
             ", ".join(["\"{}\"".format(name) for name in asset_names])
         ))
-        asset_docs = legacy_io.find({
-            "type": "asset",
-            "name": {"$in": asset_names}
-        })
+
+        asset_docs = get_assets(project_name, asset_names=asset_names)
         asset_docs_by_name = {
             asset_doc["name"]: asset_doc
             for asset_doc in asset_docs
@@ -111,7 +115,7 @@ class CollectAnatomyInstanceData(pyblish.api.ContextPlugin):
                 "Not found asset documents with names \"{}\"."
             ).format(joined_asset_names))
 
-    def fill_latest_versions(self, context):
+    def fill_latest_versions(self, context, project_name):
         """Try to find latest version for each instance's subset.
 
         Key "latestVersion" is always set to latest version or `None`.
@@ -126,7 +130,7 @@ class CollectAnatomyInstanceData(pyblish.api.ContextPlugin):
         self.log.debug("Qeurying latest versions for instances.")
 
         hierarchy = {}
-        subset_filters = []
+        names_by_asset_ids = collections.defaultdict(set)
         for instance in context:
             # Make sure `"latestVersion"` key is set
             latest_version = instance.data.get("latestVersion")
@@ -147,67 +151,33 @@ class CollectAnatomyInstanceData(pyblish.api.ContextPlugin):
             if subset_name not in hierarchy[asset_id]:
                 hierarchy[asset_id][subset_name] = []
             hierarchy[asset_id][subset_name].append(instance)
-            subset_filters.append({
-                "parent": asset_id,
-                "name": subset_name
-            })
+            names_by_asset_ids[asset_id].add(subset_name)
 
         subset_docs = []
-        if subset_filters:
-            subset_docs = list(legacy_io.find({
-                "type": "subset",
-                "$or": subset_filters
-            }))
+        if names_by_asset_ids:
+            subset_docs = list(get_subsets(
+                project_name, names_by_asset_ids=names_by_asset_ids
+            ))
 
         subset_ids = [
             subset_doc["_id"]
             for subset_doc in subset_docs
         ]
 
-        last_version_by_subset_id = self._query_last_versions(subset_ids)
+        last_version_docs_by_subset_id = get_last_versions(
+            project_name, subset_ids, fields=["name"]
+        )
         for subset_doc in subset_docs:
             subset_id = subset_doc["_id"]
-            last_version = last_version_by_subset_id.get(subset_id)
-            if last_version is None:
+            last_version_doc = last_version_docs_by_subset_id.get(subset_id)
+            if last_version_docs_by_subset_id is None:
                 continue
 
             asset_id = subset_doc["parent"]
             subset_name = subset_doc["name"]
             _instances = hierarchy[asset_id][subset_name]
             for _instance in _instances:
-                _instance.data["latestVersion"] = last_version
-
-    def _query_last_versions(self, subset_ids):
-        """Retrieve all latest versions for entered subset_ids.
-
-        Args:
-            subset_ids (list): List of subset ids with type `ObjectId`.
-
-        Returns:
-            dict: Key is subset id and value is last version name.
-        """
-        _pipeline = [
-            # Find all versions of those subsets
-            {"$match": {
-                "type": "version",
-                "parent": {"$in": subset_ids}
-            }},
-            # Sorting versions all together
-            {"$sort": {"name": 1}},
-            # Group them by "parent", but only take the last
-            {"$group": {
-                "_id": "$parent",
-                "_version_id": {"$last": "$_id"},
-                "name": {"$last": "$name"}
-            }}
-        ]
-
-        last_version_by_subset_id = {}
-        for doc in legacy_io.aggregate(_pipeline):
-            subset_id = doc["_id"]
-            last_version_by_subset_id[subset_id] = doc["name"]
-
-        return last_version_by_subset_id
+                _instance.data["latestVersion"] = last_version_doc["name"]
 
     def fill_anatomy_data(self, context):
         self.log.debug("Storing anatomy data to instance data.")

From d1e7ae25d4e97abd2734ecf5e86d0ce89f6a09e5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 11:35:44 +0200
Subject: [PATCH 0959/1227] added function to receive archived representations

---
 openpype/client/__init__.py |   2 +
 openpype/client/entities.py | 146 +++++++++++++++++++++++++++---------
 2 files changed, 113 insertions(+), 35 deletions(-)

diff --git a/openpype/client/__init__.py b/openpype/client/__init__.py
index e3b4ef5132..6094b4e0ab 100644
--- a/openpype/client/__init__.py
+++ b/openpype/client/__init__.py
@@ -29,6 +29,7 @@ from .entities import (
     get_representations,
     get_representation_parents,
     get_representations_parents,
+    get_archived_representations,
 
     get_thumbnail,
     get_thumbnails,
@@ -66,6 +67,7 @@ __all__ = (
     "get_representations",
     "get_representation_parents",
     "get_representations_parents",
+    "get_archived_representations",
 
     "get_thumbnail",
     "get_thumbnails",
diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index aed465c46f..9d425810b9 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -918,7 +918,7 @@ def get_representation_by_id(project_name, representation_id, fields=None):
     if not representation_id:
         return None
 
-    repre_types = ["representation", "archived_representations"]
+    repre_types = ["representation", "archived_representation"]
     query_filter = {
         "type": {"$in": repre_types}
     }
@@ -962,43 +962,26 @@ def get_representation_by_name(
     return conn.find_one(query_filter, _prepare_fields(fields))
 
 
-def get_representations(
+def _get_representations(
     project_name,
-    representation_ids=None,
-    representation_names=None,
-    version_ids=None,
-    extensions=None,
-    names_by_version_ids=None,
-    archived=False,
-    fields=None
+    representation_ids,
+    representation_names,
+    version_ids,
+    extensions,
+    names_by_version_ids,
+    standard,
+    archived,
+    fields
 ):
-    """Representaion entities data from one project filtered by filters.
-
-    Filters are additive (all conditions must pass to return subset).
-
-    Args:
-        project_name (str): Name of project where to look for queried entities.
-        representation_ids (list[str|ObjectId]): Representation ids used as
-            filter. Filter ignored if 'None' is passed.
-        representation_names (list[str]): Representations names used as filter.
-            Filter ignored if 'None' is passed.
-        version_ids (list[str]): Subset ids used as parent filter. Filter
-            ignored if 'None' is passed.
-        extensions (list[str]): Filter by extension of main representation
-            file (without dot).
-        names_by_version_ids (dict[ObjectId, list[str]]): Complex filtering
-            using version ids and list of names under the version.
-        archived (bool): Output will also contain archived representations.
-        fields (list[str]): Fields that should be returned. All fields are
-            returned if 'None' is passed.
-
-    Returns:
-        Cursor: Iterable cursor yielding all matching representations.
-    """
-
-    repre_types = ["representation"]
+    repre_types = []
+    if standard:
+        repre_types.append("representation")
     if archived:
-        repre_types.append("archived_representations")
+        repre_types.append("archived_representation")
+
+    if not repre_types:
+        return []
+
     if len(repre_types) == 1:
         query_filter = {"type": repre_types[0]}
     else:
@@ -1043,6 +1026,99 @@ def get_representations(
     return conn.find(query_filter, _prepare_fields(fields))
 
 
+def get_representations(
+    project_name,
+    representation_ids=None,
+    representation_names=None,
+    version_ids=None,
+    extensions=None,
+    names_by_version_ids=None,
+    archived=False,
+    standard=True,
+    fields=None
+):
+    """Representaion entities data from one project filtered by filters.
+
+    Filters are additive (all conditions must pass to return subset).
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        representation_ids (list[str|ObjectId]): Representation ids used as
+            filter. Filter ignored if 'None' is passed.
+        representation_names (list[str]): Representations names used as filter.
+            Filter ignored if 'None' is passed.
+        version_ids (list[str]): Subset ids used as parent filter. Filter
+            ignored if 'None' is passed.
+        extensions (list[str]): Filter by extension of main representation
+            file (without dot).
+        names_by_version_ids (dict[ObjectId, list[str]]): Complex filtering
+            using version ids and list of names under the version.
+        archived (bool): Output will also contain archived representations.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        Cursor: Iterable cursor yielding all matching representations.
+    """
+
+    return _get_representations(
+        project_name=project_name,
+        representation_ids=representation_ids,
+        representation_names=representation_names,
+        version_ids=version_ids,
+        extensions=extensions,
+        names_by_version_ids=names_by_version_ids,
+        standard=True,
+        archived=archived,
+        fields=fields
+    )
+
+
+def get_archived_representations(
+    project_name,
+    representation_ids=None,
+    representation_names=None,
+    version_ids=None,
+    extensions=None,
+    names_by_version_ids=None,
+    fields=None
+):
+    """Archived representaion entities data from project with applied filters.
+
+    Filters are additive (all conditions must pass to return subset).
+
+    Args:
+        project_name (str): Name of project where to look for queried entities.
+        representation_ids (list[str|ObjectId]): Representation ids used as
+            filter. Filter ignored if 'None' is passed.
+        representation_names (list[str]): Representations names used as filter.
+            Filter ignored if 'None' is passed.
+        version_ids (list[str]): Subset ids used as parent filter. Filter
+            ignored if 'None' is passed.
+        extensions (list[str]): Filter by extension of main representation
+            file (without dot).
+        names_by_version_ids (dict[ObjectId, list[str]]): Complex filtering
+            using version ids and list of names under the version.
+        fields (list[str]): Fields that should be returned. All fields are
+            returned if 'None' is passed.
+
+    Returns:
+        Cursor: Iterable cursor yielding all matching representations.
+    """
+
+    return _get_representations(
+        project_name=project_name,
+        representation_ids=representation_ids,
+        representation_names=representation_names,
+        version_ids=version_ids,
+        extensions=extensions,
+        names_by_version_ids=names_by_version_ids,
+        standard=False,
+        archived=True,
+        fields=fields
+    )
+
+
 def get_representations_parents(project_name, representations):
     """Prepare parents of representation entities.
 

From 12d23347fc20409900d9ac032852765e38b6a842 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 11:45:52 +0200
Subject: [PATCH 0960/1227] integrate hero version use query functions

---
 .../plugins/publish/integrate_hero_version.py | 50 +++++++++++--------
 1 file changed, 29 insertions(+), 21 deletions(-)

diff --git a/openpype/plugins/publish/integrate_hero_version.py b/openpype/plugins/publish/integrate_hero_version.py
index a706b653c4..5f97a9bd41 100644
--- a/openpype/plugins/publish/integrate_hero_version.py
+++ b/openpype/plugins/publish/integrate_hero_version.py
@@ -8,6 +8,12 @@ from bson.objectid import ObjectId
 from pymongo import InsertOne, ReplaceOne
 import pyblish.api
 
+from openpype.client import (
+    get_version_by_id,
+    get_hero_version_by_subset_id,
+    get_archived_representations,
+    get_representations,
+)
 from openpype.lib import (
     create_hard_link,
     filter_profiles
@@ -85,9 +91,13 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
             hero_template
         ))
 
-        self.integrate_instance(instance, template_key, hero_template)
+        self.integrate_instance(
+            instance, project_name, template_key, hero_template
+        )
 
-    def integrate_instance(self, instance, template_key, hero_template):
+    def integrate_instance(
+        self, instance, project_name, template_key, hero_template
+    ):
         anatomy = instance.context.data["anatomy"]
         published_repres = instance.data["published_representations"]
         hero_publish_dir = self.get_publish_dir(instance, template_key)
@@ -118,8 +128,8 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
                 "Published version entity was not sent in representation data."
                 " Querying entity from database."
             ))
-            src_version_entity = (
-                self.version_from_representations(published_repres)
+            src_version_entity = self.version_from_representations(
+                project_name, published_repres
             )
 
         if not src_version_entity:
@@ -170,8 +180,8 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
             other_file_paths_mapping.append((file_path, dst_filepath))
 
         # Current version
-        old_version, old_repres = (
-            self.current_hero_ents(src_version_entity)
+        old_version, old_repres = self.current_hero_ents(
+            project_name, src_version_entity
         )
 
         old_repres_by_name = {
@@ -223,11 +233,11 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
         if old_repres_by_name:
             old_repres_to_delete = old_repres_by_name
 
-        archived_repres = list(legacy_io.find({
+        archived_repres = list(get_archived_representations(
+            project_name,
             # Check what is type of archived representation
-            "type": "archived_repsentation",
-            "parent": new_version_id
-        }))
+            version_ids=[new_version_id]
+        ))
         archived_repres_by_name = {}
         for repre in archived_repres:
             repre_name_low = repre["name"].lower()
@@ -586,25 +596,23 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
 
         shutil.copy(src_path, dst_path)
 
-    def version_from_representations(self, repres):
+    def version_from_representations(self, project_name, repres):
         for repre in repres:
-            version = legacy_io.find_one({"_id": repre["parent"]})
+            version = get_version_by_id(project_name, repre["parent"])
             if version:
                 return version
 
-    def current_hero_ents(self, version):
-        hero_version = legacy_io.find_one({
-            "parent": version["parent"],
-            "type": "hero_version"
-        })
+    def current_hero_ents(self, project_name, version):
+        hero_version = get_hero_version_by_subset_id(
+            project_name, version["parent"]
+        )
 
         if not hero_version:
             return (None, [])
 
-        hero_repres = list(legacy_io.find({
-            "parent": hero_version["_id"],
-            "type": "representation"
-        }))
+        hero_repres = list(get_representations(
+            project_name, version_ids=[hero_version["_id"]]
+        ))
         return (hero_version, hero_repres)
 
     def _update_path(self, anatomy, path, src_file, dst_file):

From f0f0a87c5d7e81c226dd22fba6589040cf62bfff Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 11:47:01 +0200
Subject: [PATCH 0961/1227] global plugins are using query functions

---
 .../publish/collect_avalon_entities.py        | 13 +++----
 .../publish/collect_scene_loaded_versions.py  | 33 +++++++++--------
 .../publish/extract_hierarchy_avalon.py       | 36 ++++++++++++-------
 .../plugins/publish/integrate_thumbnail.py    |  3 +-
 .../publish/validate_editorial_asset_name.py  |  7 ++--
 5 files changed, 53 insertions(+), 39 deletions(-)

diff --git a/openpype/plugins/publish/collect_avalon_entities.py b/openpype/plugins/publish/collect_avalon_entities.py
index 3e7843407f..6cd0d136e8 100644
--- a/openpype/plugins/publish/collect_avalon_entities.py
+++ b/openpype/plugins/publish/collect_avalon_entities.py
@@ -10,6 +10,7 @@ Provides:
 
 import pyblish.api
 
+from openpype.client import get_project, get_asset_by_name
 from openpype.pipeline import legacy_io
 
 
@@ -25,10 +26,7 @@ class CollectAvalonEntities(pyblish.api.ContextPlugin):
         asset_name = legacy_io.Session["AVALON_ASSET"]
         task_name = legacy_io.Session["AVALON_TASK"]
 
-        project_entity = legacy_io.find_one({
-            "type": "project",
-            "name": project_name
-        })
+        project_entity = get_project(project_name)
         assert project_entity, (
             "Project '{0}' was not found."
         ).format(project_name)
@@ -39,11 +37,8 @@ class CollectAvalonEntities(pyblish.api.ContextPlugin):
         if not asset_name:
             self.log.info("Context is not set. Can't collect global data.")
             return
-        asset_entity = legacy_io.find_one({
-            "type": "asset",
-            "name": asset_name,
-            "parent": project_entity["_id"]
-        })
+
+        asset_entity = get_asset_by_name(project_name, asset_name)
         assert asset_entity, (
             "No asset found by the name '{0}' in project '{1}'"
         ).format(asset_name, project_name)
diff --git a/openpype/plugins/publish/collect_scene_loaded_versions.py b/openpype/plugins/publish/collect_scene_loaded_versions.py
index bb34e3ce31..5ff2b46e3b 100644
--- a/openpype/plugins/publish/collect_scene_loaded_versions.py
+++ b/openpype/plugins/publish/collect_scene_loaded_versions.py
@@ -1,7 +1,6 @@
-from bson.objectid import ObjectId
-
 import pyblish.api
 
+from openpype.client import get_representations
 from openpype.pipeline import (
     registered_host,
     legacy_io,
@@ -39,23 +38,29 @@ class CollectSceneLoadedVersions(pyblish.api.ContextPlugin):
             return
 
         loaded_versions = []
-        _containers = list(host.ls())
-        _repr_ids = [ObjectId(c["representation"]) for c in _containers]
-        repre_docs = legacy_io.find(
-            {"_id": {"$in": _repr_ids}},
-            projection={"_id": 1, "parent": 1}
+        containers = list(host.ls())
+        repre_ids = {
+            container["representation"]
+            for container in containers
+        }
+
+        project_name = legacy_io.active_project()
+        repre_docs = get_representations(
+            project_name,
+            representation_ids=repre_ids,
+            fields=["_id", "parent"]
         )
-        version_by_repr = {
-            str(doc["_id"]): doc["parent"]
+        repre_doc_by_str_id = {
+            str(doc["_id"]): doc
             for doc in repre_docs
         }
 
         # QUESTION should we add same representation id when loaded multiple
         #   times?
-        for con in _containers:
+        for con in containers:
             repre_id = con["representation"]
-            version_id = version_by_repr.get(repre_id)
-            if version_id is None:
+            repre_doc = repre_doc_by_str_id.get(repre_id)
+            if repre_doc is None:
                 self.log.warning((
                     "Skipping container,"
                     " did not find representation document. {}"
@@ -66,8 +71,8 @@ class CollectSceneLoadedVersions(pyblish.api.ContextPlugin):
             # may have more then one representation that are same version
             version = {
                 "subsetName": con["name"],
-                "representation": ObjectId(repre_id),
-                "version": version_id,
+                "representation": repre_doc["_id"],
+                "version": repre_doc["parent"],
             }
             loaded_versions.append(version)
 
diff --git a/openpype/plugins/publish/extract_hierarchy_avalon.py b/openpype/plugins/publish/extract_hierarchy_avalon.py
index 1f7ce839ed..8d447ba595 100644
--- a/openpype/plugins/publish/extract_hierarchy_avalon.py
+++ b/openpype/plugins/publish/extract_hierarchy_avalon.py
@@ -1,5 +1,11 @@
 from copy import deepcopy
 import pyblish.api
+from openpype.client import (
+    get_project,
+    get_asset_by_id,
+    get_asset_by_name,
+    get_archived_assets
+)
 from openpype.pipeline import legacy_io
 
 
@@ -19,14 +25,14 @@ class ExtractHierarchyToAvalon(pyblish.api.ContextPlugin):
         if not legacy_io.Session:
             legacy_io.install()
 
+        project_name = legacy_io.active_project()
         hierarchy_context = self._get_active_assets(context)
         self.log.debug("__ hierarchy_context: {}".format(hierarchy_context))
 
         self.project = None
-        self.import_to_avalon(hierarchy_context)
+        self.import_to_avalon(project_name, hierarchy_context)
 
-
-    def import_to_avalon(self, input_data, parent=None):
+    def import_to_avalon(self, project_name, input_data, parent=None):
         for name in input_data:
             self.log.info("input_data[name]: {}".format(input_data[name]))
             entity_data = input_data[name]
@@ -62,7 +68,7 @@ class ExtractHierarchyToAvalon(pyblish.api.ContextPlugin):
             update_data = True
             # Process project
             if entity_type.lower() == "project":
-                entity = legacy_io.find_one({"type": "project"})
+                entity = get_project(project_name)
                 # TODO: should be in validator?
                 assert (entity is not None), "Did not find project in DB"
 
@@ -79,7 +85,7 @@ class ExtractHierarchyToAvalon(pyblish.api.ContextPlugin):
                 )
             # Else process assset
             else:
-                entity = legacy_io.find_one({"type": "asset", "name": name})
+                entity = get_asset_by_name(project_name, name)
                 if entity:
                     # Do not override data, only update
                     cur_entity_data = entity.get("data") or {}
@@ -103,10 +109,10 @@ class ExtractHierarchyToAvalon(pyblish.api.ContextPlugin):
                     # Skip updating data
                     update_data = False
 
-                    archived_entities = legacy_io.find({
-                        "type": "archived_asset",
-                        "name": name
-                    })
+                    archived_entities = get_archived_assets(
+                        project_name,
+                        asset_names=[name]
+                    )
                     unarchive_entity = None
                     for archived_entity in archived_entities:
                         archived_parents = (
@@ -120,7 +126,9 @@ class ExtractHierarchyToAvalon(pyblish.api.ContextPlugin):
 
                     if unarchive_entity is None:
                         # Create entity if doesn"t exist
-                        entity = self.create_avalon_asset(name, data)
+                        entity = self.create_avalon_asset(
+                            project_name, name, data
+                        )
                     else:
                         # Unarchive if entity was archived
                         entity = self.unarchive_entity(unarchive_entity, data)
@@ -133,7 +141,9 @@ class ExtractHierarchyToAvalon(pyblish.api.ContextPlugin):
                 )
 
             if "childs" in entity_data:
-                self.import_to_avalon(entity_data["childs"], entity)
+                self.import_to_avalon(
+                    project_name, entity_data["childs"], entity
+                )
 
     def unarchive_entity(self, entity, data):
         # Unarchived asset should not use same data
@@ -151,7 +161,7 @@ class ExtractHierarchyToAvalon(pyblish.api.ContextPlugin):
         )
         return new_entity
 
-    def create_avalon_asset(self, name, data):
+    def create_avalon_asset(self, project_name, name, data):
         item = {
             "schema": "openpype:asset-3.0",
             "name": name,
@@ -162,7 +172,7 @@ class ExtractHierarchyToAvalon(pyblish.api.ContextPlugin):
         self.log.debug("Creating asset: {}".format(item))
         entity_id = legacy_io.insert_one(item).inserted_id
 
-        return legacy_io.find_one({"_id": entity_id})
+        return get_asset_by_id(project_name, entity_id)
 
     def _get_active_assets(self, context):
         """ Returns only asset dictionary.
diff --git a/openpype/plugins/publish/integrate_thumbnail.py b/openpype/plugins/publish/integrate_thumbnail.py
index 5d6fc561ea..fd50858a91 100644
--- a/openpype/plugins/publish/integrate_thumbnail.py
+++ b/openpype/plugins/publish/integrate_thumbnail.py
@@ -8,6 +8,7 @@ import six
 import pyblish.api
 from bson.objectid import ObjectId
 
+from openpype.client import get_version_by_id
 from openpype.pipeline import legacy_io
 
 
@@ -70,7 +71,7 @@ class IntegrateThumbnails(pyblish.api.InstancePlugin):
 
         thumbnail_template = anatomy.templates["publish"]["thumbnail"]
 
-        version = legacy_io.find_one({"_id": thumb_repre["parent"]})
+        version = get_version_by_id(project_name, thumb_repre["parent"])
         if not version:
             raise AssertionError(
                 "There does not exist version with id {}".format(
diff --git a/openpype/plugins/publish/validate_editorial_asset_name.py b/openpype/plugins/publish/validate_editorial_asset_name.py
index f9cdaebf0c..702e87b58d 100644
--- a/openpype/plugins/publish/validate_editorial_asset_name.py
+++ b/openpype/plugins/publish/validate_editorial_asset_name.py
@@ -3,6 +3,7 @@ from pprint import pformat
 import pyblish.api
 
 from openpype.pipeline import legacy_io
+from openpype.client import get_assets
 
 
 class ValidateEditorialAssetName(pyblish.api.ContextPlugin):
@@ -29,8 +30,10 @@ class ValidateEditorialAssetName(pyblish.api.ContextPlugin):
         if not legacy_io.Session:
             legacy_io.install()
 
-        db_assets = list(legacy_io.find(
-            {"type": "asset"}, {"name": 1, "data.parents": 1}))
+        project_name = legacy_io.active_project()
+        db_assets = list(get_assets(
+            project_name, fields=["name", "data.parents"]
+        ))
         self.log.debug("__ db_assets: {}".format(db_assets))
 
         asset_db_docs = {

From 646e9edd9b11fe2d6095d9c511e1e61c096b19c4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 11:49:28 +0200
Subject: [PATCH 0962/1227] integrate asset new is using query functions

---
 openpype/plugins/publish/integrate_new.py | 53 +++++++++++------------
 1 file changed, 25 insertions(+), 28 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 4c14c17dae..c264f0fd59 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -16,6 +16,14 @@ from pymongo import DeleteOne, InsertOne
 import pyblish.api
 
 import openpype.api
+from openpype.client import (
+    get_asset_by_name,
+    get_subset_by_id,
+    get_version_by_id,
+    get_version_by_name,
+    get_representations,
+    get_archived_representations,
+)
 from openpype.lib.profiles_filtering import filter_profiles
 from openpype.lib import (
     prepare_template_data,
@@ -201,6 +209,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         context = instance.context
 
         project_entity = instance.data["projectEntity"]
+        project_name = project_entity["name"]
 
         context_asset_name = None
         context_asset_doc = context.data.get("assetEntity")
@@ -210,11 +219,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         asset_name = instance.data["asset"]
         asset_entity = instance.data.get("assetEntity")
         if not asset_entity or asset_entity["name"] != context_asset_name:
-            asset_entity = legacy_io.find_one({
-                "type": "asset",
-                "name": asset_name,
-                "parent": project_entity["_id"]
-            })
+            asset_entity = get_asset_by_name(project_name, asset_name)
             assert asset_entity, (
                 "No asset found by the name \"{0}\" in project \"{1}\""
             ).format(asset_name, project_entity["name"])
@@ -270,7 +275,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "Establishing staging directory @ {0}".format(stagingdir)
             )
 
-        subset = self.get_subset(asset_entity, instance)
+        subset = self.get_subset(project_name, asset_entity, instance)
         instance.data["subsetEntity"] = subset
 
         version_number = instance.data["version"]
@@ -297,11 +302,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             for _repre in repres
         ]
 
-        existing_version = legacy_io.find_one({
-            'type': 'version',
-            'parent': subset["_id"],
-            'name': version_number
-        })
+        existing_version = get_version_by_name(
+            project_name, version_number, subset["_id"]
+        )
 
         if existing_version is None:
             version_id = legacy_io.insert_one(version).inserted_id
@@ -322,10 +325,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             version_id = existing_version['_id']
 
             # Find representations of existing version and archive them
-            current_repres = list(legacy_io.find({
-                "type": "representation",
-                "parent": version_id
-            }))
+            current_repres = list(get_representations(
+                project_name, version_ids=[version_id]
+            ))
             bulk_writes = []
             for repre in current_repres:
                 if append_repres:
@@ -345,18 +347,17 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
             # bulk updates
             if bulk_writes:
-                project_name = legacy_io.Session["AVALON_PROJECT"]
                 legacy_io.database[project_name].bulk_write(
                     bulk_writes
                 )
 
-        version = legacy_io.find_one({"_id": version_id})
+        version = get_version_by_id(project_name, version_id)
         instance.data["versionEntity"] = version
 
-        existing_repres = list(legacy_io.find({
-            "parent": version_id,
-            "type": "archived_representation"
-        }))
+        existing_repres = list(get_archived_representations(
+            project_name,
+            version_ids=[version_id]
+        ))
 
         instance.data['version'] = version['name']
 
@@ -792,13 +793,9 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         create_hard_link(src, dst)
 
-    def get_subset(self, asset, instance):
+    def get_subset(self, project_name, asset, instance):
         subset_name = instance.data["subset"]
-        subset = legacy_io.find_one({
-            "type": "subset",
-            "parent": asset["_id"],
-            "name": subset_name
-        })
+        subset = get_subset_by_name(project_name, subset_name, asset["_id"])
 
         if subset is None:
             self.log.info("Subset '%s' not found, creating ..." % subset_name)
@@ -825,7 +822,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "parent": asset["_id"]
             }).inserted_id
 
-            subset = legacy_io.find_one({"_id": _id})
+            subset = get_subset_by_id(project_name, _id)
 
         # QUESTION Why is changing of group and updating it's
         #   families in 'get_subset'?

From 26bdde12d0d81bf3c5bd60ec69659716a904d0e9 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Jul 2022 11:54:17 +0200
Subject: [PATCH 0963/1227] add missing import

---
 openpype/plugins/publish/integrate_new.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index c264f0fd59..f870220421 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -19,6 +19,7 @@ import openpype.api
 from openpype.client import (
     get_asset_by_name,
     get_subset_by_id,
+    get_subset_by_name,
     get_version_by_id,
     get_version_by_name,
     get_representations,

From 9bfff7a2cc67e704045e31a5f041677ea89d2514 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Fri, 1 Jul 2022 15:23:25 +0300
Subject: [PATCH 0964/1227] Fix asset data key.

---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 5 ++---
 openpype/hosts/maya/plugins/publish/extract_thumbnail.py | 4 ++--
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index fbf4035505..4c3224e1b4 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -58,8 +58,8 @@ class ExtractPlayblast(openpype.api.Extractor):
         height_preset = capture_presets["Resolution"]["height"]
         # Set resolution variables from asset values
         asset_data = instance.data["assetEntity"]["data"]
-        asset_width = asset_data.get("width")
-        asset_height = asset_data.get("height")
+        asset_width = asset_data.get("resolutionWidth")
+        asset_height = asset_data.get("resolutionHeight")
         review_instance_width = instance.data.get("Width")
         review_instance_height = instance.data.get("Height")
         preset['camera'] = camera
@@ -68,7 +68,6 @@ class ExtractPlayblast(openpype.api.Extractor):
         # if it is a value other than zero, that value is
         # used, if not then the asset resolution is
         # used
-
         if review_instance_width and review_instance_height:
             preset['width'] = review_instance_width
             preset['height'] = review_instance_height
diff --git a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
index bc15327aa7..c7d7cf150d 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -66,8 +66,8 @@ class ExtractThumbnail(openpype.api.Extractor):
         height_preset = capture_presets["Resolution"]["height"]
         # Set resolution variables from asset values
         asset_data = instance.data["assetEntity"]["data"]
-        asset_width = asset_data.get("width")
-        asset_height = asset_data.get("height")
+        asset_width = asset_data.get("resolutionWidth")
+        asset_height = asset_data.get("resolutionHeight")
         review_instance_width = instance.data.get("Width")
         review_instance_height = instance.data.get("Height")
         # Tests if project resolution is set,

From 0537317fcf96dabb75679fbb9cd9b9f0d0d7ac8c Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 1 Jul 2022 15:54:33 +0200
Subject: [PATCH 0965/1227] Shush the hound

---
 openpype/hosts/maya/plugins/publish/extract_pointcache.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index a7ba5b3745..bcf96eb128 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -133,4 +133,3 @@ class ExtractAnimation(ExtractAlembic):
                                            fullPath=True) or []
 
         return nodes, roots
-

From 45cc1ed9ae9e5ad1a309146d9c5ae1903a34b3cc Mon Sep 17 00:00:00 2001
From: Kaa Maurice <kaalium@gmail.com>
Date: Fri, 1 Jul 2022 16:37:01 +0200
Subject: [PATCH 0966/1227] bugfix: delete_old_version use settings to process
 ftrack logic.

---
 openpype/plugins/load/delete_old_versions.py | 65 ++++++++++----------
 1 file changed, 34 insertions(+), 31 deletions(-)

diff --git a/openpype/plugins/load/delete_old_versions.py b/openpype/plugins/load/delete_old_versions.py
index 7465f53855..f626775180 100644
--- a/openpype/plugins/load/delete_old_versions.py
+++ b/openpype/plugins/load/delete_old_versions.py
@@ -4,13 +4,14 @@ import uuid
 
 import clique
 from pymongo import UpdateOne
-import ftrack_api
+import importlib
 import qargparse
 from Qt import QtWidgets, QtCore
 
 from openpype import style
 from openpype.pipeline import load, AvalonMongoDB, Anatomy
 from openpype.lib import StringTemplate
+from openpype.settings import get_system_settings
 
 
 class DeleteOldVersions(load.SubsetLoaderPlugin):
@@ -370,37 +371,39 @@ class DeleteOldVersions(load.SubsetLoaderPlugin):
 
         self.dbcon.uninstall()
 
-        # Set attribute `is_published` to `False` on ftrack AssetVersions
-        session = ftrack_api.Session()
-        query = (
-            "AssetVersion where asset.parent.id is \"{}\""
-            " and asset.name is \"{}\""
-            " and version is \"{}\""
-        )
-        for v in data["versions"]:
-            try:
-                ftrack_version = session.query(
-                    query.format(
-                        data["asset"]["data"]["ftrackId"],
-                        data["subset"]["name"],
-                        v["name"]
-                    )
-                ).one()
-            except ftrack_api.exception.NoResultFoundError:
-                continue
-
-            ftrack_version["is_published"] = False
-
-        try:
-            session.commit()
-
-        except Exception:
-            msg = (
-                "Could not set `is_published` attribute to `False`"
-                " for selected AssetVersions."
+        if get_system_settings()["modules"]["ftrack"]["enabled"]:
+            # Set attribute `is_published` to `False` on ftrack AssetVersions
+            ftrack_api = importlib.import_module("ftrack_api")
+            session = ftrack_api.Session()
+            query = (
+                "AssetVersion where asset.parent.id is \"{}\""
+                " and asset.name is \"{}\""
+                " and version is \"{}\""
             )
-            self.log.error(msg)
-            self.message(msg)
+            for v in data["versions"]:
+                try:
+                    ftrack_version = session.query(
+                        query.format(
+                            data["asset"]["data"]["ftrackId"],
+                            data["subset"]["name"],
+                            v["name"]
+                        )
+                    ).one()
+                except ftrack_api.exception.NoResultFoundError:
+                    continue
+
+                ftrack_version["is_published"] = False
+
+            try:
+                session.commit()
+
+            except Exception:
+                msg = (
+                    "Could not set `is_published` attribute to `False`"
+                    " for selected AssetVersions."
+                )
+                self.log.error(msg)
+                self.message(msg)
 
         return size
 

From 7122675350c58d2ec02fe6a9ceab7f4f86a8fcfb Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Sat, 2 Jul 2022 04:00:05 +0000
Subject: [PATCH 0967/1227] [Automated] Bump version

---
 CHANGELOG.md        | 46 +++++++++++++++++++++++++++------------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 30 insertions(+), 20 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 438a563391..9b5d40a52f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,13 +1,36 @@
 # Changelog
 
-## [3.12.1-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.1-nightly.2](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.0...HEAD)
 
+### 📖 Documentation
+
+- Docs: Added minimal permissions for MongoDB [\#3441](https://github.com/pypeclub/OpenPype/pull/3441)
+
+**🆕 New features**
+
+- Maya: Add VDB to Arnold loader [\#3433](https://github.com/pypeclub/OpenPype/pull/3433)
+
 **🚀 Enhancements**
 
+- Blender: Bugfix - Set fps properly on open [\#3426](https://github.com/pypeclub/OpenPype/pull/3426)
 - Blender: pre pyside install for all platforms [\#3400](https://github.com/pypeclub/OpenPype/pull/3400)
 
+**🐛 Bug fixes**
+
+- Nuke: prerender reviewable fails [\#3450](https://github.com/pypeclub/OpenPype/pull/3450)
+- Maya: fix hashing in Python 3 for tile rendering [\#3447](https://github.com/pypeclub/OpenPype/pull/3447)
+- LogViewer: Escape html characters in log message [\#3443](https://github.com/pypeclub/OpenPype/pull/3443)
+- Nuke: Slate frame is integrated [\#3427](https://github.com/pypeclub/OpenPype/pull/3427)
+
+**🔀 Refactored code**
+
+- Clockify: Use query functions in clockify actions [\#3458](https://github.com/pypeclub/OpenPype/pull/3458)
+- General: Use query functions in rest api calls [\#3457](https://github.com/pypeclub/OpenPype/pull/3457)
+- General: Use Anatomy after move to pipeline [\#3436](https://github.com/pypeclub/OpenPype/pull/3436)
+- General: Anatomy moved to pipeline [\#3435](https://github.com/pypeclub/OpenPype/pull/3435)
+
 ## [3.12.0](https://github.com/pypeclub/OpenPype/tree/3.12.0) (2022-06-28)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.12.0-nightly.3...3.12.0)
@@ -24,7 +47,6 @@
 - General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
 - Hosts: More options for in-host callbacks [\#3357](https://github.com/pypeclub/OpenPype/pull/3357)
 - Multiverse: expose some settings to GUI [\#3350](https://github.com/pypeclub/OpenPype/pull/3350)
-- Maya: Allow more data to be published along camera 🎥  [\#3304](https://github.com/pypeclub/OpenPype/pull/3304)
 
 **🐛 Bug fixes**
 
@@ -57,7 +79,6 @@
 - AfterEffects: Use client query functions [\#3374](https://github.com/pypeclub/OpenPype/pull/3374)
 - TVPaint: Use client query functions [\#3340](https://github.com/pypeclub/OpenPype/pull/3340)
 - Ftrack: Use client query functions [\#3339](https://github.com/pypeclub/OpenPype/pull/3339)
-- Webpublisher: Use client query functions [\#3333](https://github.com/pypeclub/OpenPype/pull/3333)
 - Standalone Publisher: Use client query functions [\#3330](https://github.com/pypeclub/OpenPype/pull/3330)
 
 **Merged pull requests:**
@@ -93,17 +114,15 @@
 - nuke: adding extract thumbnail settings 3.10 [\#3347](https://github.com/pypeclub/OpenPype/pull/3347)
 - General: Fix last version function [\#3345](https://github.com/pypeclub/OpenPype/pull/3345)
 - Deadline: added OPENPYPE\_MONGO to filter [\#3336](https://github.com/pypeclub/OpenPype/pull/3336)
-- Nuke: fixing farm publishing if review is disabled [\#3306](https://github.com/pypeclub/OpenPype/pull/3306)
+
+**🔀 Refactored code**
+
+- Webpublisher: Use client query functions [\#3333](https://github.com/pypeclub/OpenPype/pull/3333)
 
 ## [3.11.0](https://github.com/pypeclub/OpenPype/tree/3.11.0) (2022-06-17)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.11.0-nightly.4...3.11.0)
 
-### 📖 Documentation
-
-- Documentation: Add app key to template documentation [\#3299](https://github.com/pypeclub/OpenPype/pull/3299)
-- doc: adding royal render and multiverse to the web site [\#3285](https://github.com/pypeclub/OpenPype/pull/3285)
-
 **🚀 Enhancements**
 
 - Settings: Settings can be extracted from UI [\#3323](https://github.com/pypeclub/OpenPype/pull/3323)
@@ -111,8 +130,6 @@
 - Ftrack: Action to easily create daily review session [\#3310](https://github.com/pypeclub/OpenPype/pull/3310)
 - TVPaint: Extractor use mark in/out range to render [\#3309](https://github.com/pypeclub/OpenPype/pull/3309)
 - Ftrack: Delivery action can work on ReviewSessions [\#3307](https://github.com/pypeclub/OpenPype/pull/3307)
-- Maya: Look assigner UI improvements [\#3298](https://github.com/pypeclub/OpenPype/pull/3298)
-- Ftrack: Action to transfer values of hierarchical attributes [\#3284](https://github.com/pypeclub/OpenPype/pull/3284)
 
 **🐛 Bug fixes**
 
@@ -120,17 +137,10 @@
 - Houdini: Fix Houdini VDB manage update wrong file attribute name [\#3322](https://github.com/pypeclub/OpenPype/pull/3322)
 - Nuke: anatomy compatibility issue hacks [\#3321](https://github.com/pypeclub/OpenPype/pull/3321)
 - hiero: otio p3 compatibility issue - metadata on effect use update 3.11 [\#3314](https://github.com/pypeclub/OpenPype/pull/3314)
-- General: Vendorized modules for Python 2 and update poetry lock [\#3305](https://github.com/pypeclub/OpenPype/pull/3305)
-- Fix - added local targets to install host [\#3303](https://github.com/pypeclub/OpenPype/pull/3303)
-- Settings: Add missing default settings for nuke gizmo [\#3301](https://github.com/pypeclub/OpenPype/pull/3301)
-- Maya: Fix swaped width and height in reviews [\#3300](https://github.com/pypeclub/OpenPype/pull/3300)
-- Maya: point cache publish handles Maya instances [\#3297](https://github.com/pypeclub/OpenPype/pull/3297)
-- Global: extract review slate issues [\#3286](https://github.com/pypeclub/OpenPype/pull/3286)
 
 **🔀 Refactored code**
 
 - Blender: Use client query functions [\#3331](https://github.com/pypeclub/OpenPype/pull/3331)
-- General: Define query functions [\#3288](https://github.com/pypeclub/OpenPype/pull/3288)
 
 **Merged pull requests:**
 
diff --git a/openpype/version.py b/openpype/version.py
index 633b0b4f33..92cdcf9fdd 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.1-nightly.1"
+__version__ = "3.12.1-nightly.2"
diff --git a/pyproject.toml b/pyproject.toml
index 26a7b4bf1e..401b24243b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.1-nightly.1" # OpenPype
+version = "3.12.1-nightly.2" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From bcdcf5b6af6ebb65c4bf803a30c4ba2afffca5fa Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Sat, 2 Jul 2022 22:16:58 +0200
Subject: [PATCH 0968/1227] resolve: removing small blockers

---
 openpype/hosts/resolve/api/lib.py             | 13 ++--
 openpype/hosts/resolve/api/plugin.py          |  2 +-
 .../plugins/create/create_shot_clip.py        | 68 ++++++++++---------
 .../hosts/resolve/plugins/load/load_clip.py   |  2 +-
 .../plugins/publish/precollect_workfile.py    |  3 +-
 5 files changed, 45 insertions(+), 43 deletions(-)

diff --git a/openpype/hosts/resolve/api/lib.py b/openpype/hosts/resolve/api/lib.py
index c4717bd370..93ccdaf812 100644
--- a/openpype/hosts/resolve/api/lib.py
+++ b/openpype/hosts/resolve/api/lib.py
@@ -319,14 +319,13 @@ def get_current_timeline_items(
     selected_track_count = timeline.GetTrackCount(track_type)
 
     # loop all tracks and get items
-    _clips = dict()
+    _clips = {}
     for track_index in range(1, (int(selected_track_count) + 1)):
         _track_name = timeline.GetTrackName(track_type, track_index)
 
         # filter out all unmathed track names
-        if track_name:
-            if _track_name not in track_name:
-                continue
+        if track_name and _track_name not in track_name:
+            continue
 
         timeline_items = timeline.GetItemListInTrack(
             track_type, track_index)
@@ -348,12 +347,8 @@ def get_current_timeline_items(
                 "index": clip_index
             }
             ti_color = ti.GetClipColor()
-            if filter is True:
-                if selecting_color in ti_color:
-                    selected_clips.append(data)
-            else:
+            if filter and selecting_color in ti_color or not filter:
                 selected_clips.append(data)
-
     return selected_clips
 
 
diff --git a/openpype/hosts/resolve/api/plugin.py b/openpype/hosts/resolve/api/plugin.py
index 8e1436021c..49b478fb3b 100644
--- a/openpype/hosts/resolve/api/plugin.py
+++ b/openpype/hosts/resolve/api/plugin.py
@@ -506,7 +506,7 @@ class Creator(LegacyCreator):
         super(Creator, self).__init__(*args, **kwargs)
         from openpype.api import get_current_project_settings
         resolve_p_settings = get_current_project_settings().get("resolve")
-        self.presets = dict()
+        self.presets = {}
         if resolve_p_settings:
             self.presets = resolve_p_settings["create"].get(
                 self.__class__.__name__, {})
diff --git a/openpype/hosts/resolve/plugins/create/create_shot_clip.py b/openpype/hosts/resolve/plugins/create/create_shot_clip.py
index 62d5557a50..dbf10c5163 100644
--- a/openpype/hosts/resolve/plugins/create/create_shot_clip.py
+++ b/openpype/hosts/resolve/plugins/create/create_shot_clip.py
@@ -116,12 +116,13 @@ class CreateShotClip(resolve.Creator):
                     "order": 0},
                 "vSyncTrack": {
                     "value": gui_tracks,  # noqa
-                   "type": "QComboBox",
-                   "label": "Hero track",
-                   "target": "ui",
-                   "toolTip": "Select driving track name which should be mastering all others",  # noqa
-                "order": 1}
+                    "type": "QComboBox",
+                    "label": "Hero track",
+                    "target": "ui",
+                    "toolTip": "Select driving track name which should be mastering all others",  # noqa
+                    "order": 1
                 }
+            }
         },
         "publishSettings": {
             "type": "section",
@@ -172,28 +173,31 @@ class CreateShotClip(resolve.Creator):
             "target": "ui",
             "order": 4,
             "value": {
-               "workfileFrameStart": {
-                   "value": 1001,
-                   "type": "QSpinBox",
-                   "label": "Workfiles Start Frame",
-                   "target": "tag",
-                   "toolTip": "Set workfile starting frame number",  # noqa
-                   "order": 0},
-               "handleStart": {
-                   "value": 0,
-                   "type": "QSpinBox",
-                   "label": "Handle start (head)",
-                   "target": "tag",
-                   "toolTip": "Handle at start of clip",  # noqa
-                   "order": 1},
-               "handleEnd": {
-                   "value": 0,
-                   "type": "QSpinBox",
-                   "label": "Handle end (tail)",
-                   "target": "tag",
-                   "toolTip": "Handle at end of clip",  # noqa
-                   "order": 2},
-           }
+                "workfileFrameStart": {
+                    "value": 1001,
+                    "type": "QSpinBox",
+                    "label": "Workfiles Start Frame",
+                    "target": "tag",
+                    "toolTip": "Set workfile starting frame number",  # noqa
+                    "order": 0
+                },
+                "handleStart": {
+                    "value": 0,
+                    "type": "QSpinBox",
+                    "label": "Handle start (head)",
+                    "target": "tag",
+                    "toolTip": "Handle at start of clip",  # noqa
+                    "order": 1
+                },
+                "handleEnd": {
+                    "value": 0,
+                    "type": "QSpinBox",
+                    "label": "Handle end (tail)",
+                    "target": "tag",
+                    "toolTip": "Handle at end of clip",  # noqa
+                    "order": 2
+                }
+            }
         }
     }
 
@@ -229,8 +233,10 @@ class CreateShotClip(resolve.Creator):
         v_sync_track = widget.result["vSyncTrack"]["value"]
 
         # sort selected trackItems by
-        sorted_selected_track_items = list()
-        unsorted_selected_track_items = list()
+        sorted_selected_track_items = []
+        unsorted_selected_track_items = []
+        print("_____ selected ______")
+        print(self.selected)
         for track_item_data in self.selected:
             if track_item_data["track"]["name"] in v_sync_track:
                 sorted_selected_track_items.append(track_item_data)
@@ -253,10 +259,10 @@ class CreateShotClip(resolve.Creator):
             "sq_frame_start": sq_frame_start,
             "sq_markers": sq_markers
         }
-
+        print(kwargs)
         for i, track_item_data in enumerate(sorted_selected_track_items):
             self.rename_index = i
-
+            self.log.info(track_item_data)
             # convert track item to timeline media pool item
             track_item = resolve.PublishClip(
                 self, track_item_data, **kwargs).convert()
diff --git a/openpype/hosts/resolve/plugins/load/load_clip.py b/openpype/hosts/resolve/plugins/load/load_clip.py
index cf88b14e81..567be2be87 100644
--- a/openpype/hosts/resolve/plugins/load/load_clip.py
+++ b/openpype/hosts/resolve/plugins/load/load_clip.py
@@ -19,7 +19,7 @@ class LoadClip(resolve.TimelineItemLoader):
     """
 
     families = ["render2d", "source", "plate", "render", "review"]
-    representations = ["exr", "dpx", "jpg", "jpeg", "png", "h264", ".mov"]
+    representations = ["exr", "dpx", "jpg", "jpeg", "png", "h264", "mov"]
 
     label = "Load as clip"
     order = -10
diff --git a/openpype/hosts/resolve/plugins/publish/precollect_workfile.py b/openpype/hosts/resolve/plugins/publish/precollect_workfile.py
index a58f288770..53e67aee0e 100644
--- a/openpype/hosts/resolve/plugins/publish/precollect_workfile.py
+++ b/openpype/hosts/resolve/plugins/publish/precollect_workfile.py
@@ -30,7 +30,8 @@ class PrecollectWorkfile(pyblish.api.ContextPlugin):
             "asset": asset,
             "subset": "{}{}".format(asset, subset.capitalize()),
             "item": project,
-            "family": "workfile"
+            "family": "workfile",
+            "families": []
         }
 
         # create instance with workfile

From ad9b01c0c7fb1c40b6d56b889a6a7d766390502d Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Mon, 4 Jul 2022 02:45:58 +0300
Subject: [PATCH 0969/1227] Alter final logic and change attribute naming to
 more pythonic convention.

---
 openpype/hosts/maya/plugins/create/create_review.py |  4 ++--
 .../hosts/maya/plugins/publish/collect_review.py    |  4 ++--
 .../hosts/maya/plugins/publish/extract_playblast.py | 13 +++++++------
 .../hosts/maya/plugins/publish/extract_thumbnail.py | 10 +++++-----
 4 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_review.py b/openpype/hosts/maya/plugins/create/create_review.py
index 9f6721762b..ba51ffa009 100644
--- a/openpype/hosts/maya/plugins/create/create_review.py
+++ b/openpype/hosts/maya/plugins/create/create_review.py
@@ -35,8 +35,8 @@ class CreateReview(plugin.Creator):
         for key, value in animation_data.items():
             data[key] = value
 
-        data["Width"] = self.Width
-        data["Height"] = self.Height
+        data["review_width"] = self.Width
+        data["review_height"] = self.Height
         data["isolate"] = self.isolate
         data["keepImages"] = self.keepImages
         data["imagePlane"] = self.imagePlane
diff --git a/openpype/hosts/maya/plugins/publish/collect_review.py b/openpype/hosts/maya/plugins/publish/collect_review.py
index b0b5ef37e8..eb872c2935 100644
--- a/openpype/hosts/maya/plugins/publish/collect_review.py
+++ b/openpype/hosts/maya/plugins/publish/collect_review.py
@@ -71,8 +71,8 @@ class CollectReview(pyblish.api.InstancePlugin):
                 data['handles'] = instance.data.get('handles', None)
                 data['step'] = instance.data['step']
                 data['fps'] = instance.data['fps']
-                data['Width'] = instance.data['Width']
-                data['Height'] = instance.data['Height']
+                data['review_width'] = instance.data['review_width']
+                data['review_height'] = instance.data['review_height']
                 data["isolate"] = instance.data["isolate"]
                 cmds.setAttr(str(instance) + '.active', 1)
                 self.log.debug('data {}'.format(instance.context[i].data))
diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 4c3224e1b4..0b60e01e45 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -60,8 +60,8 @@ class ExtractPlayblast(openpype.api.Extractor):
         asset_data = instance.data["assetEntity"]["data"]
         asset_width = asset_data.get("resolutionWidth")
         asset_height = asset_data.get("resolutionHeight")
-        review_instance_width = instance.data.get("Width")
-        review_instance_height = instance.data.get("Height")
+        review_instance_width = instance.data.get("review_width")
+        review_instance_height = instance.data.get("review_height")
         preset['camera'] = camera
 
         # Tests if project resolution is set,
@@ -71,13 +71,14 @@ class ExtractPlayblast(openpype.api.Extractor):
         if review_instance_width and review_instance_height:
             preset['width'] = review_instance_width
             preset['height'] = review_instance_height
-        elif asset_width and asset_height:
-            preset['width'] = asset_width
-            preset['height'] = asset_height
         elif width_preset and height_preset:
             preset['width'] = width_preset
             preset['height'] = height_preset
-
+        elif asset_width and asset_height:
+            preset['width'] = asset_width
+            preset['height'] = asset_height
+        
+        
         preset['start_frame'] = start
         preset['end_frame'] = end
         camera_option = preset.get("camera_option", {})
diff --git a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
index c7d7cf150d..2f7e6c5e05 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -68,8 +68,8 @@ class ExtractThumbnail(openpype.api.Extractor):
         asset_data = instance.data["assetEntity"]["data"]
         asset_width = asset_data.get("resolutionWidth")
         asset_height = asset_data.get("resolutionHeight")
-        review_instance_width = instance.data.get("Width")
-        review_instance_height = instance.data.get("Height")
+        review_instance_width = instance.data.get("review_width")
+        review_instance_height = instance.data.get("review_height")
         # Tests if project resolution is set,
         # if it is a value other than zero, that value is
         # used, if not then the asset resolution is
@@ -77,12 +77,12 @@ class ExtractThumbnail(openpype.api.Extractor):
         if review_instance_width and review_instance_height:
             preset['width'] = review_instance_width
             preset['height'] = review_instance_height
-        elif asset_width and asset_height:
-            preset['width'] = asset_width
-            preset['height'] = asset_height
         elif width_preset and height_preset:
             preset['width'] = width_preset
             preset['height'] = height_preset
+        elif asset_width and asset_height:
+            preset['width'] = asset_width
+            preset['height'] = asset_height
         stagingDir = self.staging_dir(instance)
         filename = "{0}".format(instance.name)
         path = os.path.join(stagingDir, filename)

From 8307ea8ea204f30937589a6f7f8bc493081861ab Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Mon, 4 Jul 2022 02:47:10 +0300
Subject: [PATCH 0970/1227] Style fix.

---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 0b60e01e45..2c6e76e5ad 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -77,8 +77,6 @@ class ExtractPlayblast(openpype.api.Extractor):
         elif asset_width and asset_height:
             preset['width'] = asset_width
             preset['height'] = asset_height
-        
-        
         preset['start_frame'] = start
         preset['end_frame'] = end
         camera_option = preset.get("camera_option", {})

From 4e4bf771724376bf6ff2587d77bb1ebb938d793c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 10:37:36 +0200
Subject: [PATCH 0971/1227] use direct import of ftrack_api

---
 openpype/plugins/load/delete_old_versions.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/load/delete_old_versions.py b/openpype/plugins/load/delete_old_versions.py
index f626775180..622e6b41b7 100644
--- a/openpype/plugins/load/delete_old_versions.py
+++ b/openpype/plugins/load/delete_old_versions.py
@@ -4,7 +4,6 @@ import uuid
 
 import clique
 from pymongo import UpdateOne
-import importlib
 import qargparse
 from Qt import QtWidgets, QtCore
 
@@ -373,7 +372,8 @@ class DeleteOldVersions(load.SubsetLoaderPlugin):
 
         if get_system_settings()["modules"]["ftrack"]["enabled"]:
             # Set attribute `is_published` to `False` on ftrack AssetVersions
-            ftrack_api = importlib.import_module("ftrack_api")
+            import ftrack_api
+
             session = ftrack_api.Session()
             query = (
                 "AssetVersion where asset.parent.id is \"{}\""

From 5baedfc3a068a338603cc5e956e6446b655e9af0 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 10:37:57 +0200
Subject: [PATCH 0972/1227] use ftrack module to determine if ftrack is enabled

---
 openpype/plugins/load/delete_old_versions.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/load/delete_old_versions.py b/openpype/plugins/load/delete_old_versions.py
index 622e6b41b7..2a0b7492bc 100644
--- a/openpype/plugins/load/delete_old_versions.py
+++ b/openpype/plugins/load/delete_old_versions.py
@@ -10,7 +10,7 @@ from Qt import QtWidgets, QtCore
 from openpype import style
 from openpype.pipeline import load, AvalonMongoDB, Anatomy
 from openpype.lib import StringTemplate
-from openpype.settings import get_system_settings
+from openpype.modules import ModulesManager
 
 
 class DeleteOldVersions(load.SubsetLoaderPlugin):
@@ -370,7 +370,9 @@ class DeleteOldVersions(load.SubsetLoaderPlugin):
 
         self.dbcon.uninstall()
 
-        if get_system_settings()["modules"]["ftrack"]["enabled"]:
+        modules_manager = ModulesManager()
+        ftrack_module = modules_manager.modules_by_name.get("ftrack")
+        if ftrack_module and ftrack_module.enabled:
             # Set attribute `is_published` to `False` on ftrack AssetVersions
             import ftrack_api
 

From 409362e4ffeb2d269d0a418643764b965ca14d8a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 10:50:40 +0200
Subject: [PATCH 0973/1227] moveed the ftrack logic into separated method

---
 openpype/plugins/load/delete_old_versions.py | 103 ++++++++++++-------
 1 file changed, 67 insertions(+), 36 deletions(-)

diff --git a/openpype/plugins/load/delete_old_versions.py b/openpype/plugins/load/delete_old_versions.py
index 2a0b7492bc..1f48e651b4 100644
--- a/openpype/plugins/load/delete_old_versions.py
+++ b/openpype/plugins/load/delete_old_versions.py
@@ -370,45 +370,76 @@ class DeleteOldVersions(load.SubsetLoaderPlugin):
 
         self.dbcon.uninstall()
 
-        modules_manager = ModulesManager()
-        ftrack_module = modules_manager.modules_by_name.get("ftrack")
-        if ftrack_module and ftrack_module.enabled:
-            # Set attribute `is_published` to `False` on ftrack AssetVersions
-            import ftrack_api
-
-            session = ftrack_api.Session()
-            query = (
-                "AssetVersion where asset.parent.id is \"{}\""
-                " and asset.name is \"{}\""
-                " and version is \"{}\""
-            )
-            for v in data["versions"]:
-                try:
-                    ftrack_version = session.query(
-                        query.format(
-                            data["asset"]["data"]["ftrackId"],
-                            data["subset"]["name"],
-                            v["name"]
-                        )
-                    ).one()
-                except ftrack_api.exception.NoResultFoundError:
-                    continue
-
-                ftrack_version["is_published"] = False
-
-            try:
-                session.commit()
-
-            except Exception:
-                msg = (
-                    "Could not set `is_published` attribute to `False`"
-                    " for selected AssetVersions."
-                )
-                self.log.error(msg)
-                self.message(msg)
+        self._ftrack_delete_versions(data)
 
         return size
 
+    def _ftrack_delete_versions(self, data):
+        """Delete version on ftrack.
+
+        Handling of ftrack logic in this plugin is not ideal. But in OP3 it is
+        almost impossible to solve the issue other way.
+
+        Note:
+            Asset versions on ftrack are not deleted but marked as
+                "not published" which cause that they're invisible.
+
+        Args:
+            data (dict): Data sent to subset loader with full context.
+        """
+
+        # First check for ftrack id on asset document
+        #   - skip if ther is none
+        asset_ftrack_id = data["asset"]["data"].get("ftrackId")
+        if not asset_ftrack_id:
+            self.log.info((
+                "Asset does not have filled ftrack id. Skipped delete"
+                " of ftrack version."
+            ))
+            return
+
+        # Check if ftrack module is enabled
+        modules_manager = ModulesManager()
+        ftrack_module = modules_manager.modules_by_name.get("ftrack")
+        if not ftrack_module or not ftrack_module.enabled:
+            return
+
+        import ftrack_api
+
+        session = ftrack_api.Session()
+        subset_name = data["subset"]["name"]
+        versions = {
+            '"{}"'.format(version_doc["name"])
+            for version_doc in data["versions"]
+        }
+        asset_versions = session.query(
+            (
+                "select id, is_published from AssetVersion where"
+                " asset.parent.id is \"{}\""
+                " and asset.name is \"{}\""
+                " and version in (\"{}\")"
+            ).format(
+                asset_ftrack_id,
+                subset_name,
+                ",".join(versions)
+            )
+        )
+
+        # Set attribute `is_published` to `False` on ftrack AssetVersions
+        for asset_version in asset_versions:
+            asset_version["is_published"] = False
+
+        try:
+            session.commit()
+
+        except Exception:
+            msg = (
+                "Could not set `is_published` attribute to `False`"
+                " for selected AssetVersions."
+            )
+            self.log.error(msg)
+            self.message(msg)
+
     def load(self, contexts, name=None, namespace=None, options=None):
         try:
             size = 0

From 9f174cc92c4aeb869d4e847d7558e7cda18302ff Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 11:11:34 +0200
Subject: [PATCH 0974/1227] fix query

---
 openpype/plugins/load/delete_old_versions.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/load/delete_old_versions.py b/openpype/plugins/load/delete_old_versions.py
index 1f48e651b4..6b469357f7 100644
--- a/openpype/plugins/load/delete_old_versions.py
+++ b/openpype/plugins/load/delete_old_versions.py
@@ -417,7 +417,7 @@ class DeleteOldVersions(load.SubsetLoaderPlugin):
                 "select id, is_published from AssetVersion where"
                 " asset.parent.id is \"{}\""
                 " and asset.name is \"{}\""
-                " and version in (\"{}\")"
+                " and version in ({})"
             ).format(
                 asset_ftrack_id,
                 subset_name,

From 408593bf14d4ae5c5cd022ddfd3c87969178a0c7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 11:12:46 +0200
Subject: [PATCH 0975/1227] define query result

---
 openpype/plugins/load/delete_old_versions.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/load/delete_old_versions.py b/openpype/plugins/load/delete_old_versions.py
index 6b469357f7..0952cd9bd6 100644
--- a/openpype/plugins/load/delete_old_versions.py
+++ b/openpype/plugins/load/delete_old_versions.py
@@ -423,7 +423,7 @@ class DeleteOldVersions(load.SubsetLoaderPlugin):
                 subset_name,
                 ",".join(versions)
             )
-        )
+        ).all()
 
         # Set attribute `is_published` to `False` on ftrack AssetVersions
         for asset_version in asset_versions:

From 01c48a3c194adf6e83421380d7bf002eca445dcd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 11:40:28 +0200
Subject: [PATCH 0976/1227] trigger 'openpype.project.prepare' event on project
 preparation

---
 .../ftrack/event_handlers_server/action_prepare_project.py   | 5 +++++
 .../ftrack/event_handlers_user/action_prepare_project.py     | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py b/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py
index 361aa98d16..50cadb7f09 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py
@@ -1,4 +1,5 @@
 import json
+import copy
 
 from openpype.client import get_project
 from openpype.api import ProjectSettings
@@ -400,6 +401,10 @@ class PrepareProjectServer(ServerAction):
                 self.log.debug("- Key \"{}\" set to \"{}\"".format(key, value))
             session.commit()
 
+        event_data = copy.deepcopy(in_data)
+        event_data["project_name"] = project_name
+        self.trigger_event("openpype.project.prepared", event_data)
+
         return True
 
 
diff --git a/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py b/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py
index e9dc11de9f..9cac2f4386 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py
@@ -1,4 +1,5 @@
 import json
+import copy
 
 from openpype.client import get_project
 from openpype.api import ProjectSettings
@@ -433,6 +434,10 @@ class PrepareProjectLocal(BaseAction):
                 self.process_identifier()
             )
             self.trigger_action(trigger_identifier, event)
+
+        event_data = copy.deepcopy(in_data)
+        event_data["project_name"] = project_name
+        self.trigger_event("openpype.project.prepared", event_data)
         return True
 
 

From 91a9dcdbd491d7c4cc4b28a0abcbda3a1fd70a5d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 11:42:00 +0200
Subject: [PATCH 0977/1227] Don't use dictionary as default value

---
 openpype/modules/ftrack/lib/ftrack_base_handler.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/ftrack/lib/ftrack_base_handler.py b/openpype/modules/ftrack/lib/ftrack_base_handler.py
index 2130abc20c..c0fad6aadc 100644
--- a/openpype/modules/ftrack/lib/ftrack_base_handler.py
+++ b/openpype/modules/ftrack/lib/ftrack_base_handler.py
@@ -535,7 +535,7 @@ class BaseHandler(object):
         )
 
     def trigger_event(
-        self, topic, event_data={}, session=None, source=None,
+        self, topic, event_data=None, session=None, source=None,
         event=None, on_error="ignore"
     ):
         if session is None:
@@ -543,6 +543,9 @@ class BaseHandler(object):
 
         if not source and event:
             source = event.get("source")
+
+        if event_data is None:
+            event_data = {}
         # Create and trigger event
         event = ftrack_api.event.base.Event(
             topic=topic,

From b340bd532d6233c3fadf86295e98eb617412e066 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 11:47:06 +0200
Subject: [PATCH 0978/1227] trigger ftrack event 'openpype.project.created' on
 project creation

---
 .../event_handlers_server/action_prepare_project.py      | 4 ++++
 .../ftrack/event_handlers_user/action_prepare_project.py | 4 ++++
 openpype/modules/ftrack/lib/avalon_sync.py               | 9 +++++++++
 3 files changed, 17 insertions(+)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py b/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py
index 50cadb7f09..713a4d9aba 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_prepare_project.py
@@ -374,6 +374,10 @@ class PrepareProjectServer(ServerAction):
                 project_name, project_code
             ))
             create_project(project_name, project_code)
+            self.trigger_event(
+                "openpype.project.created",
+                {"project_name": project_name}
+            )
 
         project_settings = ProjectSettings(project_name)
         project_anatomy_settings = project_settings["project_anatomy"]
diff --git a/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py b/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py
index 9cac2f4386..e89595109e 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_prepare_project.py
@@ -400,6 +400,10 @@ class PrepareProjectLocal(BaseAction):
                 project_name, project_code
             ))
             create_project(project_name, project_code)
+            self.trigger_event(
+                "openpype.project.created",
+                {"project_name": project_name}
+            )
 
         project_settings = ProjectSettings(project_name)
         project_anatomy_settings = project_settings["project_anatomy"]
diff --git a/openpype/modules/ftrack/lib/avalon_sync.py b/openpype/modules/ftrack/lib/avalon_sync.py
index 68b5c62c53..6161a2131e 100644
--- a/openpype/modules/ftrack/lib/avalon_sync.py
+++ b/openpype/modules/ftrack/lib/avalon_sync.py
@@ -443,6 +443,7 @@ class SyncEntitiesFactory:
         }
 
         self.create_list = []
+        self.project_created = False
         self.unarchive_list = []
         self.updates = collections.defaultdict(dict)
 
@@ -2016,6 +2017,13 @@ class SyncEntitiesFactory:
         if len(self.create_list) > 0:
             self.dbcon.insert_many(self.create_list)
 
+        if self.project_created:
+            event = ftrack_api.event.base.Event(
+                topic="openpype.project.created",
+                data={"project_name": self.project_name}
+            )
+            self.session.event_hub.publish(event)
+
         self.session.commit()
 
         self.log.debug("* Processing entities for update")
@@ -2214,6 +2222,7 @@ class SyncEntitiesFactory:
         self._avalon_ents_by_name[project_item["name"]] = str(new_id)
 
         self.create_list.append(project_item)
+        self.project_created = True
 
         # store mongo id to ftrack entity
         entity = self.entities_dict[self.ft_project_id]["entity"]

From 606b057ab0d16e82e801aaaaddc1744be2256ae8 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 12:25:32 +0200
Subject: [PATCH 0979/1227] trigger 'openpype.project.created' in sync actions
 because session avalon sync is not with event hub

---
 .../event_handlers_server/action_sync_to_avalon.py     | 10 +++++++++-
 .../event_handlers_user/action_sync_to_avalon.py       | 10 +++++++++-
 openpype/modules/ftrack/lib/avalon_sync.py             |  7 -------
 3 files changed, 18 insertions(+), 9 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_sync_to_avalon.py b/openpype/modules/ftrack/event_handlers_server/action_sync_to_avalon.py
index 58f79e8a2b..df9147bdf7 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_sync_to_avalon.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_sync_to_avalon.py
@@ -1,7 +1,8 @@
 import time
 import sys
 import json
-import traceback
+
+import ftrack_api
 
 from openpype_modules.ftrack.lib import ServerAction
 from openpype_modules.ftrack.lib.avalon_sync import SyncEntitiesFactory
@@ -180,6 +181,13 @@ class SyncToAvalonServer(ServerAction):
                 "* Total time: {}".format(time_7 - time_start)
             )
 
+            if self.entities_factory.project_created:
+                event = ftrack_api.event.base.Event(
+                    topic="openpype.project.created",
+                    data={"project_name": project_name}
+                )
+                self.session.event_hub.publish(event)
+
             report = self.entities_factory.report()
             if report and report.get("items"):
                 default_title = "Synchronization report ({}):".format(
diff --git a/openpype/modules/ftrack/event_handlers_user/action_sync_to_avalon.py b/openpype/modules/ftrack/event_handlers_user/action_sync_to_avalon.py
index cd2f371f38..e52a061471 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_sync_to_avalon.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_sync_to_avalon.py
@@ -1,7 +1,8 @@
 import time
 import sys
 import json
-import traceback
+
+import ftrack_api
 
 from openpype_modules.ftrack.lib import BaseAction, statics_icon
 from openpype_modules.ftrack.lib.avalon_sync import SyncEntitiesFactory
@@ -184,6 +185,13 @@ class SyncToAvalonLocal(BaseAction):
                 "* Total time: {}".format(time_7 - time_start)
             )
 
+            if self.entities_factory.project_created:
+                event = ftrack_api.event.base.Event(
+                    topic="openpype.project.created",
+                    data={"project_name": project_name}
+                )
+                self.session.event_hub.publish(event)
+
             report = self.entities_factory.report()
             if report and report.get("items"):
                 default_title = "Synchronization report ({}):".format(
diff --git a/openpype/modules/ftrack/lib/avalon_sync.py b/openpype/modules/ftrack/lib/avalon_sync.py
index 6161a2131e..f8883cefbd 100644
--- a/openpype/modules/ftrack/lib/avalon_sync.py
+++ b/openpype/modules/ftrack/lib/avalon_sync.py
@@ -2017,13 +2017,6 @@ class SyncEntitiesFactory:
         if len(self.create_list) > 0:
             self.dbcon.insert_many(self.create_list)
 
-        if self.project_created:
-            event = ftrack_api.event.base.Event(
-                topic="openpype.project.created",
-                data={"project_name": self.project_name}
-            )
-            self.session.event_hub.publish(event)
-
         self.session.commit()
 
         self.log.debug("* Processing entities for update")

From 4781fc56b48b6f66dc33803c35ee7d9be56729ec Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Mon, 4 Jul 2022 12:50:39 +0200
Subject: [PATCH 0980/1227] remove the global scope add_scripts_menu call from
 menu.py and add it in the install function of pipeline.py

---
 openpype/hosts/hiero/api/menu.py     | 5 +----
 openpype/hosts/hiero/api/pipeline.py | 1 +
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/hiero/api/menu.py b/openpype/hosts/hiero/api/menu.py
index 412f08272e..541a1f1f92 100644
--- a/openpype/hosts/hiero/api/menu.py
+++ b/openpype/hosts/hiero/api/menu.py
@@ -162,11 +162,8 @@ def add_scripts_menu():
         log.warning("Skipping studio menu, no definition found.")
         return
 
-    # run the launcher for Maya menu
+    # run the launcher for Hiero menu
     studio_menu = launchforhiero.main(title=_menu.title())
 
     # apply configuration
     studio_menu.build_from_configuration(studio_menu, config)
-
-
-add_scripts_menu()
diff --git a/openpype/hosts/hiero/api/pipeline.py b/openpype/hosts/hiero/api/pipeline.py
index 9b628ec70b..b243a38b06 100644
--- a/openpype/hosts/hiero/api/pipeline.py
+++ b/openpype/hosts/hiero/api/pipeline.py
@@ -48,6 +48,7 @@ def install():
 
     # install menu
     menu.menu_install()
+    menu.add_scripts_menu()
 
     # register hiero events
     events.register_hiero_events()

From 6c658f7da3fdf9bf716d8adfaf17f69641e78d87 Mon Sep 17 00:00:00 2001
From: Thomas Fricard <tfricard@ws114.prs.vfx.int>
Date: Mon, 4 Jul 2022 14:24:07 +0200
Subject: [PATCH 0981/1227] fix default json project_settings by setting
 defaults through run_settings UI

---
 .../defaults/project_settings/hiero.json      | 42 ++++++-------------
 1 file changed, 13 insertions(+), 29 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/hiero.json b/openpype/settings/defaults/project_settings/hiero.json
index 3b0127c24a..e9e7199330 100644
--- a/openpype/settings/defaults/project_settings/hiero.json
+++ b/openpype/settings/defaults/project_settings/hiero.json
@@ -1,32 +1,4 @@
 {
-    "ext_mapping": {
-        "model": "hrox",
-        "mayaAscii": "hrox",
-        "camera": "hrox",
-        "rig": "hrox",
-        "workfile": "hrox",
-        "yetiRig": "hrox"
-    },
-    "hiero-dirmap": {
-        "enabled": false,
-        "paths": {
-            "source-path": [],
-            "destination-path": []
-        }
-    },
-    "scriptsmenu": {
-        "name": "OpenPype Tools",
-        "definition": [
-            {
-                "type": "action",
-                "sourcetype": "python",
-                "title": "OpenPype Docs",
-                "command": "import webbrowser;webbrowser.open(url='https://openpype.io/docs/artist_hosts_hiero')",
-                "tooltip": "Open the OpenPype Hiero user doc page"
-            }
-        ]
-    },
-
     "create": {
         "CreateShotClip": {
             "hierarchy": "{folder}/{sequence}",
@@ -79,5 +51,17 @@
             ]
         }
     },
-    "filters": {}
+    "filters": {},
+    "scriptsmenu": {
+        "name": "OpenPype Tools",
+        "definition": [
+            {
+                "type": "action",
+                "sourcetype": "python",
+                "title": "OpenPype Docs",
+                "command": "import webbrowser;webbrowser.open(url='https://openpype.io/docs/artist_hosts_hiero')",
+                "tooltip": "Open the OpenPype Hiero user doc page"
+            }
+        ]
+    }
 }
\ No newline at end of file

From eedc67edcc37dcfeae0254e4e856ec4b7df409cf Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 16:28:59 +0200
Subject: [PATCH 0982/1227] use project entity from context instead of requery

---
 .../deadline/plugins/publish/submit_houdini_remote_publish.py   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_houdini_remote_publish.py b/openpype/modules/deadline/plugins/publish/submit_houdini_remote_publish.py
index f834ae7e92..fdf67b51bc 100644
--- a/openpype/modules/deadline/plugins/publish/submit_houdini_remote_publish.py
+++ b/openpype/modules/deadline/plugins/publish/submit_houdini_remote_publish.py
@@ -55,7 +55,7 @@ class HoudiniSubmitPublishDeadline(pyblish.api.ContextPlugin):
         scenename = os.path.basename(scene)
 
         # Get project code
-        project = legacy_io.find_one({"type": "project"})
+        project = context.data["projectEntity"]
         code = project["data"].get("code", project["name"])
 
         job_name = "{scene} [PUBLISH]".format(scene=scenename)

From 5ba81e8c284e9ee38ceb84dae2aee25d054f8685 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 16:37:36 +0200
Subject: [PATCH 0983/1227] use query function in submit to deadline

---
 .../plugins/publish/submit_publish_job.py     | 26 ++++++++++++++-----
 1 file changed, 19 insertions(+), 7 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 9dd1428a63..b098eaba8e 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -11,6 +11,7 @@ import clique
 import pyblish.api
 
 import openpype.api
+from openpype.client import get_representations
 from openpype.pipeline import (
     get_representation_path,
     legacy_io,
@@ -18,15 +19,23 @@ from openpype.pipeline import (
 from openpype.pipeline.farm.patterning import match_aov_pattern
 
 
-def get_resources(version, extension=None):
+def get_resources(project_name, version, extension=None):
     """Get the files from the specific version."""
-    query = {"type": "representation", "parent": version["_id"]}
+
+    # TODO this functions seems to be weird
+    #   - it's looking for representation with one extension or first (any)
+    #       representation from a version?
+    #  - not sure how this should work, maybe it does for specific use cases
+    #       but probably can't be used for all resources from 2D workflows
+    extensions = None
     if extension:
-        query["name"] = extension
-
-    representation = legacy_io.find_one(query)
-    assert representation, "This is a bug"
+        extensions = [extension]
+    repre_docs = list(get_representations(
+        project_name, version_ids=[version["_id"]], extensions=extensions
+    ))
+    assert repre_docs, "This is a bug"
 
+    representation = repre_docs[0]
     directory = get_representation_path(representation)
     print("Source: ", directory)
     resources = sorted(
@@ -330,13 +339,16 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
         self.log.info("Preparing to copy ...")
         start = instance.data.get("frameStart")
         end = instance.data.get("frameEnd")
+        project_name = legacy_io.active_project()
 
         # get latest version of subset
         # this will stop if subset wasn't published yet
         version = openpype.api.get_latest_version(instance.data.get("asset"),
                                                   instance.data.get("subset"))
         # get its files based on extension
-        subset_resources = get_resources(version, representation.get("ext"))
+        subset_resources = get_resources(
+            project_name, version, representation.get("ext")
+        )
         r_col, _ = clique.assemble(subset_resources)
 
         # if override remove all frames we are expecting to be rendered

From eb352d0958fda52b2a77ca10bb56a9fb80894e16 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 16:51:54 +0200
Subject: [PATCH 0984/1227] fix 'hero' kwargs

---
 openpype/lib/avalon_context.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 9ffa5f2732..76ed6cbbd3 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -195,7 +195,6 @@ def is_latest(representation):
     version = get_version_by_id(
         project_name,
         representation["parent"],
-        hero=True,
         fields=["_id", "type", "parent"]
     )
     if version["type"] == "hero_version":

From 3612ceb9378053e124440661a89944d76c5a4d88 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Jul 2022 19:12:52 +0200
Subject: [PATCH 0985/1227] fix query of current version

---
 openpype/pipeline/load/utils.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/pipeline/load/utils.py b/openpype/pipeline/load/utils.py
index eca581ba37..2c1b2ea8ea 100644
--- a/openpype/pipeline/load/utils.py
+++ b/openpype/pipeline/load/utils.py
@@ -394,7 +394,7 @@ def update_container(container, version=-1):
     assert current_representation is not None, "This is a bug"
 
     current_version = get_version_by_id(
-        project_name, current_representation["_id"], fields=["parent"]
+        project_name, current_representation["parent"], fields=["parent"]
     )
     if version == -1:
         new_version = get_last_version_by_subset_id(

From 488f58a52ed9d518082e28d30e1687fc562cbce4 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Jul 2022 09:15:00 +0200
Subject: [PATCH 0986/1227] Resolve conflicts

---
 openpype/hosts/maya/plugins/publish/extract_animation.py | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 openpype/hosts/maya/plugins/publish/extract_animation.py

diff --git a/openpype/hosts/maya/plugins/publish/extract_animation.py b/openpype/hosts/maya/plugins/publish/extract_animation.py
deleted file mode 100644
index e69de29bb2..0000000000

From 3e058c6e8ac79ebb9933d0ad02957b0467f3a578 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Jul 2022 09:20:00 +0200
Subject: [PATCH 0987/1227] Move IntegrateAsset

---
 openpype/plugins/publish/integrate.py | 832 ++++++++++++++++++++++++++
 1 file changed, 832 insertions(+)
 create mode 100644 openpype/plugins/publish/integrate.py

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
new file mode 100644
index 0000000000..6ad0849ff7
--- /dev/null
+++ b/openpype/plugins/publish/integrate.py
@@ -0,0 +1,832 @@
+import os
+import logging
+import sys
+import copy
+import clique
+import six
+
+from bson.objectid import ObjectId
+from pymongo import DeleteMany, ReplaceOne, InsertOne, UpdateOne
+import pyblish.api
+
+import openpype.api
+from openpype.modules import ModulesManager
+from openpype.lib.profiles_filtering import filter_profiles
+from openpype.lib.file_transaction import FileTransaction
+from openpype.pipeline import legacy_io
+
+log = logging.getLogger(__name__)
+
+
+def assemble(files):
+    """Convenience `clique.assemble` wrapper for files of a single collection.
+
+    Unlike `clique.assemble` this wrapper does not allow more than a single
+    Collection nor any remainder files. Errors will be raised when not only
+    a single collection is assembled.
+
+    Returns:
+        clique.Collection: A single sequence Collection
+
+    Raises:
+        ValueError: Error is raised when files do not result in a single
+                    collected Collection.
+
+    """
+    # todo: move this to lib?
+    # Get the sequence as a collection. The files must be of a single
+    # sequence and have no remainder outside of the collections.
+    patterns = [clique.PATTERNS["frames"]]
+    collections, remainder = clique.assemble(files,
+                                             minimum_items=1,
+                                             patterns=patterns)
+    if not collections:
+        raise ValueError("No collections found in files: "
+                         "{}".format(files))
+    if remainder:
+        raise ValueError("Files found not detected as part"
+                         " of a sequence: {}".format(remainder))
+    if len(collections) > 1:
+        raise ValueError("Files in sequence are not part of a"
+                         " single sequence collection: "
+                         "{}".format(collections))
+    return collections[0]
+
+
+def get_instance_families(instance):
+    """Get all families of the instance"""
+    # todo: move this to lib?
+    family = instance.data.get("family")
+    families = []
+    if family:
+        families.append(family)
+
+    for _family in (instance.data.get("families") or []):
+        if _family not in families:
+            families.append(_family)
+
+    return families
+
+
+def get_frame_padded(frame, padding):
+    """Return frame number as string with `padding` amount of padded zeros"""
+    return "{frame:0{padding}d}".format(padding=padding, frame=frame)
+
+
+def get_first_frame_padded(collection):
+    """Return first frame as padded number from `clique.Collection`"""
+    start_frame = next(iter(collection.indexes))
+    return get_frame_padded(start_frame, padding=collection.padding)
+
+
+def bulk_write(writes):
+    """Convenience function to bulk write into active project database"""
+    project = legacy_io.Session["AVALON_PROJECT"]
+    return legacy_io._database[project].bulk_write(writes)
+
+
+class IntegrateAsset(pyblish.api.InstancePlugin):
+    """Register publish in the database and transfer files to destinations.
+
+    Steps:
+        1) Register the subset and version
+        2) Transfer the representation files to the destination
+        3) Register the representation
+
+    Requires:
+        instance.data['representations'] - must be a list and each member
+        must be a dictionary with following data:
+            'files': list of filenames for sequence, string for single file.
+                     Only the filename is allowed, without the folder path.
+            'stagingDir': "path/to/folder/with/files"
+            'name': representation name (usually the same as extension)
+            'ext': file extension
+        optional data
+            "frameStart"
+            "frameEnd"
+            'fps'
+            "data": additional metadata for each representation.
+    """
+
+    label = "Integrate Asset New"
+    order = pyblish.api.IntegratorOrder
+    families = ["workfile",
+                "pointcache",
+                "camera",
+                "animation",
+                "model",
+                "mayaAscii",
+                "mayaScene",
+                "setdress",
+                "layout",
+                "ass",
+                "vdbcache",
+                "scene",
+                "vrayproxy",
+                "vrayscene_layer",
+                "render",
+                "prerender",
+                "imagesequence",
+                "review",
+                "rendersetup",
+                "rig",
+                "plate",
+                "look",
+                "audio",
+                "yetiRig",
+                "yeticache",
+                "nukenodes",
+                "gizmo",
+                "source",
+                "matchmove",
+                "image",
+                "assembly",
+                "fbx",
+                "textures",
+                "action",
+                "harmony.template",
+                "harmony.palette",
+                "editorial",
+                "background",
+                "camerarig",
+                "redshiftproxy",
+                "effect",
+                "xgen",
+                "hda",
+                "usd",
+                "staticMesh",
+                "skeletalMesh",
+                "usdComposition",
+                "usdOverride",
+                "simpleUnrealTexture"
+                ]
+    exclude_families = ["clip", "render.farm"]
+    default_template_name = "publish"
+
+    # Representation context keys that should always be written to
+    # the database even if not used by the destination template
+    db_representation_context_keys = [
+        "project", "asset", "task", "subset", "version", "representation",
+        "family", "hierarchy", "username"
+    ]
+
+    # Attributes set by settings
+    template_name_profiles = None
+
+    def process(self, instance):
+
+        # Exclude instances that also contain families from exclude families
+        families = set(get_instance_families(instance))
+        exclude = families & set(self.exclude_families)
+        if exclude:
+            self.log.debug("Instance not integrated due to exclude "
+                           "families found: {}".format(", ".join(exclude)))
+            return
+
+        file_transactions = FileTransaction(log=self.log)
+        try:
+            self.register(instance, file_transactions)
+        except Exception:
+            # clean destination
+            # todo: preferably we'd also rollback *any* changes to the database
+            file_transactions.rollback()
+            self.log.critical("Error when registering", exc_info=True)
+            six.reraise(*sys.exc_info())
+
+        # Finalizing can't rollback safely so no use for moving it to
+        # the try, except.
+        file_transactions.finalize()
+
+    def register(self, instance, file_transactions):
+
+        instance_stagingdir = instance.data.get("stagingDir")
+        if not instance_stagingdir:
+            self.log.info((
+                "{0} is missing reference to staging directory."
+                " Will try to get it from representation."
+            ).format(instance))
+
+        else:
+            self.log.debug(
+                "Establishing staging directory "
+                "@ {0}".format(instance_stagingdir)
+            )
+
+        # Ensure at least one representation is set up for registering.
+        repres = instance.data.get("representations")
+        assert repres, "Instance has no representations data"
+        assert isinstance(repres, (list, tuple)), (
+            "Instance 'representations' must be a list, got: {0} {1}".format(
+                str(type(repres)), str(repres)
+            )
+        )
+
+        template_name = self.get_template_name(instance)
+
+        subset, subset_writes = self.prepare_subset(instance)
+        version, version_writes = self.prepare_version(instance, subset)
+        instance.data["versionEntity"] = version
+
+        # Get existing representations (if any)
+        existing_repres_by_name = {
+            repres["name"].lower(): repres for repres in legacy_io.find(
+                {
+                    "parent": version["_id"],
+                    "type": "representation"
+                },
+                # Only care about id and name of existing representations
+                projection={"_id": True, "name": True}
+            )
+        }
+
+        # Prepare all representations
+        prepared_representations = []
+        for repre in instance.data["representations"]:
+
+            if "delete" in repre.get("tags", []):
+                self.log.debug("Skipping representation marked for deletion: "
+                               "{}".format(repre))
+                continue
+
+            # todo: reduce/simplify what is returned from this function
+            prepared = self.prepare_representation(repre,
+                                                   template_name,
+                                                   existing_repres_by_name,
+                                                   version,
+                                                   instance_stagingdir,
+                                                   instance)
+
+            for src, dst in prepared["transfers"]:
+                # todo: add support for hardlink transfers
+                file_transactions.add(src, dst)
+
+            prepared_representations.append(prepared)
+
+        if not prepared_representations:
+            # Even though we check `instance.data["representations"]` earlier
+            # this could still happen if all representations were tagged with
+            # "delete" and thus are skipped for integration
+            raise RuntimeError("No representations prepared to publish.")
+
+        # Each instance can also have pre-defined transfers not explicitly
+        # part of a representation - like texture resources used by a
+        # .ma representation. Those destination paths are pre-defined, etc.
+        # todo: should we move or simplify this logic?
+        resource_destinations = set()
+        for src, dst in instance.data.get("transfers", []):
+            file_transactions.add(src, dst, mode=FileTransaction.MODE_COPY)
+            resource_destinations.add(os.path.abspath(dst))
+        for src, dst in instance.data.get("hardlinks", []):
+            file_transactions.add(src, dst, mode=FileTransaction.MODE_HARDLINK)
+            resource_destinations.add(os.path.abspath(dst))
+
+        # Bulk write to the database
+        # We write the subset and version to the database before the File
+        # Transaction to reduce the chances of another publish trying to
+        # publish to the same version number since that chance can greatly
+        # increase if the file transaction takes a long time.
+        bulk_write(subset_writes + version_writes)
+        self.log.info("Subset {subset[name]} and Version {version[name]} "
+                      "written to database..".format(subset=subset,
+                                                     version=version))
+
+        # Process all file transfers of all integrations now
+        self.log.debug("Integrating source files to destination ...")
+        file_transactions.process()
+        self.log.debug("Backed up existing files: "
+                       "{}".format(file_transactions.backups))
+        self.log.debug("Transferred files: "
+                       "{}".format(file_transactions.transferred))
+        self.log.debug("Retrieving Representation Site Sync information ...")
+
+        # Get the accessible sites for Site Sync
+        manager = ModulesManager()
+        sync_server_module = manager.modules_by_name["sync_server"]
+        sites = sync_server_module.compute_resource_sync_sites(
+            project_name=instance.data["projectEntity"]["name"]
+        )
+        self.log.debug("Sync Server Sites: {}".format(sites))
+
+        # Compute the resource file infos once (files belonging to the
+        # version instance instead of an individual representation) so
+        # we can re-use those file infos per representation
+        anatomy = instance.context.data["anatomy"]
+        resource_file_infos = self.get_files_info(resource_destinations,
+                                                  sites=sites,
+                                                  anatomy=anatomy)
+
+        # Finalize the representations now the published files are integrated
+        # Get 'files' info for representations and its attached resources
+        representation_writes = []
+        new_repre_names_low = set()
+        for prepared in prepared_representations:
+            representation = prepared["representation"]
+            transfers = prepared["transfers"]
+            destinations = [dst for src, dst in transfers]
+            representation["files"] = self.get_files_info(
+                destinations, sites=sites, anatomy=anatomy
+            )
+
+            # Add the version resource file infos to each representation
+            representation["files"] += resource_file_infos
+
+            # Set up representation for writing to the database. Since
+            # we *might* be overwriting an existing entry if the version
+            # already existed we'll use ReplaceOnce with `upsert=True`
+            representation_writes.append(ReplaceOne(
+                filter={"_id": representation["_id"]},
+                replacement=representation,
+                upsert=True
+            ))
+
+            new_repre_names_low.add(representation["name"].lower())
+
+        # Delete any existing representations that didn't get any new data
+        # if the instance is not set to append mode
+        if not instance.data.get("append", False):
+            delete_names = set()
+            for name, existing_repres in existing_repres_by_name.items():
+                if name not in new_repre_names_low:
+                    # We add the exact representation name because `name` is
+                    # lowercase for name matching only and not in the database
+                    delete_names.add(existing_repres["name"])
+            if delete_names:
+                representation_writes.append(DeleteMany(
+                    filter={
+                        "parent": version["_id"],
+                        "name": {"$in": list(delete_names)}
+                    }
+                ))
+
+        # Write representations to the database
+        bulk_write(representation_writes)
+
+        # Backwards compatibility
+        # todo: can we avoid the need to store this?
+        instance.data["published_representations"] = {
+            p["representation"]["_id"]: p for p in prepared_representations
+        }
+
+        self.log.info("Registered {} representations"
+                      "".format(len(prepared_representations)))
+
+    def prepare_subset(self, instance):
+        asset = instance.data.get("assetEntity")
+        subset_name = instance.data["subset"]
+        self.log.debug("Subset: {}".format(subset_name))
+
+        # Get existing subset if it exists
+        subset = legacy_io.find_one({
+            "type": "subset",
+            "parent": asset["_id"],
+            "name": subset_name
+        })
+
+        # Define subset data
+        data = {
+            "families": get_instance_families(instance)
+        }
+
+        subset_group = instance.data.get("subsetGroup")
+        if subset_group:
+            data["subsetGroup"] = subset_group
+
+        bulk_writes = []
+        if subset is None:
+            # Create a new subset
+            self.log.info("Subset '%s' not found, creating ..." % subset_name)
+            subset = {
+                "_id": ObjectId(),
+                "schema": "openpype:subset-3.0",
+                "type": "subset",
+                "name": subset_name,
+                "data": data,
+                "parent": asset["_id"]
+            }
+            bulk_writes.append(InsertOne(subset))
+
+        else:
+            # Update existing subset data with new data and set in database.
+            # We also change the found subset in-place so we don't need to
+            # re-query the subset afterwards
+            subset["data"].update(data)
+            bulk_writes.append(UpdateOne(
+                {"type": "subset", "_id": subset["_id"]},
+                {"$set": {
+                    "data": subset["data"]
+                }}
+            ))
+
+        self.log.info("Prepared subset: {}".format(subset_name))
+        return subset, bulk_writes
+
+    def prepare_version(self, instance, subset):
+
+        version_number = instance.data["version"]
+
+        version = {
+            "schema": "openpype:version-3.0",
+            "type": "version",
+            "parent": subset["_id"],
+            "name": version_number,
+            "data": self.create_version_data(instance)
+        }
+
+        existing_version = legacy_io.find_one({
+            'type': 'version',
+            'parent': subset["_id"],
+            'name': version_number
+        }, projection={"_id": True})
+
+        if existing_version:
+            self.log.debug("Updating existing version ...")
+            version["_id"] = existing_version["_id"]
+        else:
+            self.log.debug("Creating new version ...")
+            version["_id"] = ObjectId()
+
+        bulk_writes = [ReplaceOne(
+            filter={"_id": version["_id"]},
+            replacement=version,
+            upsert=True
+        )]
+
+        self.log.info("Prepared version: v{0:03d}".format(version["name"]))
+
+        return version, bulk_writes
+
+    def prepare_representation(self, repre,
+                               template_name,
+                               existing_repres_by_name,
+                               version,
+                               instance_stagingdir,
+                               instance):
+
+        # pre-flight validations
+        if repre["ext"].startswith("."):
+            raise ValueError("Extension must not start with a dot '.': "
+                             "{}".format(repre["ext"]))
+
+        if repre.get("transfers"):
+            raise ValueError("Representation is not allowed to have transfers"
+                             "data before integration. They are computed in "
+                             "the integrator"
+                             "Got: {}".format(repre["transfers"]))
+
+        # create template data for Anatomy
+        template_data = copy.deepcopy(instance.data["anatomyData"])
+
+        # required representation keys
+        files = repre['files']
+        template_data["representation"] = repre["name"]
+        template_data["ext"] = repre["ext"]
+
+        # optionals
+        # retrieve additional anatomy data from representation if exists
+        for key, anatomy_key in {
+            # Representation Key: Anatomy data key
+            "resolutionWidth": "resolution_width",
+            "resolutionHeight": "resolution_height",
+            "fps": "fps",
+            "outputName": "output",
+            "originalBasename": "originalBasename"
+        }.items():
+            # Allow to take value from representation
+            # if not found also consider instance.data
+            if key in repre:
+                value = repre[key]
+            elif key in instance.data:
+                value = instance.data[key]
+            else:
+                continue
+            template_data[anatomy_key] = value
+
+        if repre.get('stagingDir'):
+            stagingdir = repre['stagingDir']
+        else:
+            # Fall back to instance staging dir if not explicitly
+            # set for representation in the instance
+            self.log.debug("Representation uses instance staging dir: "
+                           "{}".format(instance_stagingdir))
+            stagingdir = instance_stagingdir
+        if not stagingdir:
+            raise ValueError("No staging directory set for representation: "
+                             "{}".format(repre))
+
+        self.log.debug("Anatomy template name: {}".format(template_name))
+        anatomy = instance.context.data['anatomy']
+        template = os.path.normpath(anatomy.templates[template_name]["path"])
+
+        is_udim = bool(repre.get("udim"))
+        is_sequence_representation = isinstance(files, (list, tuple))
+        if is_sequence_representation:
+            # Collection of files (sequence)
+            assert not any(os.path.isabs(fname) for fname in files), (
+                "Given file names contain full paths"
+            )
+
+            src_collection = assemble(files)
+
+            # If the representation has `frameStart` set it renumbers the
+            # frame indices of the published collection. It will start from
+            # that `frameStart` index instead. Thus if that frame start
+            # differs from the collection we want to shift the destination
+            # frame indices from the source collection.
+            destination_indexes = list(src_collection.indexes)
+            destination_padding = len(get_first_frame_padded(src_collection))
+            if repre.get("frameStart") is not None and not is_udim:
+                index_frame_start = int(repre.get("frameStart"))
+
+                render_template = anatomy.templates[template_name]
+                # todo: should we ALWAYS manage the frame padding even when not
+                #       having `frameStart` set?
+                frame_start_padding = int(
+                    render_template.get(
+                        "frame_padding",
+                        render_template.get("padding")
+                    )
+                )
+
+                # Shift destination sequence to the start frame
+                src_start_frame = next(iter(src_collection.indexes))
+                shift = index_frame_start - src_start_frame
+                if shift:
+                    destination_indexes = [
+                        frame + shift for frame in destination_indexes
+                    ]
+                destination_padding = frame_start_padding
+
+            # To construct the destination template with anatomy we require
+            # a Frame or UDIM tile set for the template data. We use the first
+            # index of the destination for that because that could've shifted
+            # from the source indexes, etc.
+            first_index_padded = get_frame_padded(frame=destination_indexes[0],
+                                                  padding=destination_padding)
+            if is_udim:
+                # UDIM representations handle ranges in a different manner
+                template_data["udim"] = first_index_padded
+            else:
+                template_data["frame"] = first_index_padded
+
+            # Construct destination collection from template
+            anatomy_filled = anatomy.format(template_data)
+            template_filled = anatomy_filled[template_name]["path"]
+            repre_context = template_filled.used_values
+            self.log.debug("Template filled: {}".format(str(template_filled)))
+            dst_collection = assemble([os.path.normpath(template_filled)])
+
+            # Update the destination indexes and padding
+            dst_collection.indexes.clear()
+            dst_collection.indexes.update(set(destination_indexes))
+            dst_collection.padding = destination_padding
+            assert (
+                len(src_collection.indexes) == len(dst_collection.indexes)
+            ), "This is a bug"
+
+            # Multiple file transfers
+            transfers = []
+            for src_file_name, dst in zip(src_collection, dst_collection):
+                src = os.path.join(stagingdir, src_file_name)
+                transfers.append((src, dst))
+
+        else:
+            # Single file
+            fname = files
+            assert not os.path.isabs(fname), (
+                "Given file name is a full path"
+            )
+
+            # Manage anatomy template data
+            template_data.pop("frame", None)
+            if is_udim:
+                template_data["udim"] = repre["udim"][0]
+
+            # Construct destination filepath from template
+            anatomy_filled = anatomy.format(template_data)
+            template_filled = anatomy_filled[template_name]["path"]
+            repre_context = template_filled.used_values
+            dst = os.path.normpath(template_filled)
+
+            # Single file transfer
+            src = os.path.join(stagingdir, fname)
+            transfers = [(src, dst)]
+
+        # todo: Are we sure the assumption each representation
+        #       ends up in the same folder is valid?
+        if not instance.data.get("publishDir"):
+            instance.data["publishDir"] = (
+                anatomy_filled
+                [template_name]
+                ["folder"]
+            )
+
+        for key in self.db_representation_context_keys:
+            # Also add these values to the context even if not used by the
+            # destination template
+            value = template_data.get(key)
+            if not value:
+                continue
+            repre_context[key] = template_data[key]
+
+        # Explicitly store the full list even though template data might
+        # have a different value because it uses just a single udim tile
+        if repre.get("udim"):
+            repre_context["udim"] = repre.get("udim")  # store list
+
+        # Use previous representation's id if there is a name match
+        existing = existing_repres_by_name.get(repre["name"].lower())
+        if existing:
+            repre_id = existing["_id"]
+        else:
+            repre_id = ObjectId()
+
+        # Backwards compatibility:
+        # Store first transferred destination as published path data
+        # todo: can we remove this?
+        # todo: We shouldn't change data that makes its way back into
+        #       instance.data[] until we know the publish actually succeeded
+        #       otherwise `published_path` might not actually be valid?
+        published_path = transfers[0][1]
+        repre["published_path"] = published_path  # Backwards compatibility
+
+        # todo: `repre` is not the actual `representation` entity
+        #       we should simplify/clarify difference between data above
+        #       and the actual representation entity for the database
+        data = repre.get("data", {})
+        data.update({'path': published_path, 'template': template})
+        representation = {
+            "_id": repre_id,
+            "schema": "openpype:representation-2.0",
+            "type": "representation",
+            "parent": version["_id"],
+            "name": repre['name'],
+            "data": data,
+
+            # Imprint shortcut to context for performance reasons.
+            "context": repre_context
+        }
+
+        # todo: simplify/streamline which additional data makes its way into
+        #       the representation context
+        if repre.get("outputName"):
+            representation["context"]["output"] = repre['outputName']
+
+        if is_sequence_representation and repre.get("frameStart") is not None:
+            representation['context']['frame'] = template_data["frame"]
+
+        return {
+            "representation": representation,
+            "anatomy_data": template_data,
+            "transfers": transfers,
+            # todo: avoid the need for 'published_files' used by Integrate Hero
+            # backwards compatibility
+            "published_files": [transfer[1] for transfer in transfers]
+        }
+
+    def create_version_data(self, instance):
+        """Create the data dictionary for the version
+
+        Args:
+            instance: the current instance being published
+
+        Returns:
+            dict: the required information for version["data"]
+        """
+
+        context = instance.context
+
+        # create relative source path for DB
+        if "source" in instance.data:
+            source = instance.data["source"]
+        else:
+            source = context.data["currentFile"]
+            anatomy = instance.context.data["anatomy"]
+            source = self.get_rootless_path(anatomy, source)
+        self.log.debug("Source: {}".format(source))
+
+        version_data = {
+            "families": get_instance_families(instance),
+            "time": context.data["time"],
+            "author": context.data["user"],
+            "source": source,
+            "comment": context.data.get("comment"),
+            "machine": context.data.get("machine"),
+            "fps": instance.data.get("fps", context.data.get("fps"))
+        }
+
+        # todo: preferably we wouldn't need this "if dict" etc. logic and
+        #       instead be able to rely what the input value is if it's set.
+        intent_value = context.data.get("intent")
+        if intent_value and isinstance(intent_value, dict):
+            intent_value = intent_value.get("value")
+
+        if intent_value:
+            version_data["intent"] = intent_value
+
+        # Include optional data if present in
+        optionals = [
+            "frameStart", "frameEnd", "step", "handles",
+            "handleEnd", "handleStart", "sourceHashes"
+        ]
+        for key in optionals:
+            if key in instance.data:
+                version_data[key] = instance.data[key]
+
+        # Include instance.data[versionData] directly
+        version_data_instance = instance.data.get('versionData')
+        if version_data_instance:
+            version_data.update(version_data_instance)
+
+        return version_data
+
+    def get_template_name(self, instance):
+        """Return anatomy template name to use for integration"""
+        # Define publish template name from profiles
+        filter_criteria = self.get_profile_filter_criteria(instance)
+        profile = filter_profiles(self.template_name_profiles,
+                                  filter_criteria,
+                                  logger=self.log)
+        if profile:
+            return profile["template_name"]
+        else:
+            return self.default_template_name
+
+    def get_profile_filter_criteria(self, instance):
+        """Return filter criteria for `filter_profiles`"""
+        # Anatomy data is pre-filled by Collectors
+        anatomy_data = instance.data["anatomyData"]
+
+        # Task can be optional in anatomy data
+        task = anatomy_data.get("task", {})
+
+        # Return filter criteria
+        return {
+            "families": anatomy_data["family"],
+            "tasks": task.get("name"),
+            "hosts": anatomy_data["app"],
+            "task_types": task.get("type")
+        }
+
+    def get_rootless_path(self, anatomy, path):
+        """Returns, if possible, path without absolute portion from root
+            (eg. 'c:\' or '/opt/..')
+
+         This information is platform dependent and shouldn't be captured.
+         Example:
+             'c:/projects/MyProject1/Assets/publish...' >
+             '{root}/MyProject1/Assets...'
+
+        Args:
+            anatomy: anatomy part from instance
+            path: path (absolute)
+        Returns:
+            path: modified path if possible, or unmodified path
+            + warning logged
+        """
+        success, rootless_path = anatomy.find_root_template_from_path(path)
+        if success:
+            path = rootless_path
+        else:
+            self.log.warning((
+                "Could not find root path for remapping \"{}\"."
+                " This may cause issues on farm."
+            ).format(path))
+        return path
+
+    def get_files_info(self, destinations, sites, anatomy):
+        """Prepare 'files' info portion for representations.
+
+        Arguments:
+            destinations (list): List of transferred file destinations
+            sites (list): array of published locations
+            anatomy: anatomy part from instance
+        Returns:
+            output_resources: array of dictionaries to be added to 'files' key
+            in representation
+        """
+        file_infos = []
+        for file_path in destinations:
+            file_info = self.prepare_file_info(file_path, anatomy, sites=sites)
+            file_infos.append(file_info)
+        return file_infos
+
+    def prepare_file_info(self, path, anatomy, sites):
+        """ Prepare information for one file (asset or resource)
+
+        Arguments:
+            path: destination url of published file
+            anatomy: anatomy part from instance
+            sites: array of published locations,
+                [ {'name':'studio', 'created_dt':date} by default
+                keys expected ['studio', 'site1', 'gdrive1']
+
+        Returns:
+            dict: file info dictionary
+        """
+        return {
+            "_id": ObjectId(),
+            "path": self.get_rootless_path(anatomy, path),
+            "size": os.path.getsize(path),
+            "hash": openpype.api.source_hash(path),
+            "sites": sites
+        }

From fd2d07e94c0fb34730547c396e09ddc314b56983 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Jul 2022 09:22:29 +0200
Subject: [PATCH 0988/1227] Revert integrator to latest develop

---
 openpype/plugins/publish/integrate_new.py | 1710 +++++++++++++--------
 1 file changed, 1088 insertions(+), 622 deletions(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index a07e8a1e0f..4c14c17dae 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -1,111 +1,63 @@
 import os
+from os.path import getsize
 import logging
 import sys
 import copy
 import clique
+import errno
 import six
+import re
+import shutil
+from collections import deque, defaultdict
+from datetime import datetime
 
 from bson.objectid import ObjectId
-from pymongo import DeleteMany, ReplaceOne, InsertOne, UpdateOne
+from pymongo import DeleteOne, InsertOne
 import pyblish.api
 
 import openpype.api
-from openpype.modules import ModulesManager
 from openpype.lib.profiles_filtering import filter_profiles
-from openpype.lib.file_transaction import FileTransaction
+from openpype.lib import (
+    prepare_template_data,
+    create_hard_link,
+    StringTemplate,
+    TemplateUnsolved
+)
 from openpype.pipeline import legacy_io
 
+# this is needed until speedcopy for linux is fixed
+if sys.platform == "win32":
+    from speedcopy import copyfile
+else:
+    from shutil import copyfile
+
 log = logging.getLogger(__name__)
 
 
-def assemble(files):
-    """Convenience `clique.assemble` wrapper for files of a single collection.
-
-    Unlike `clique.assemble` this wrapper does not allow more than a single
-    Collection nor any remainder files. Errors will be raised when not only
-    a single collection is assembled.
-
-    Returns:
-        clique.Collection: A single sequence Collection
-
-    Raises:
-        ValueError: Error is raised when files do not result in a single
-                    collected Collection.
-
-    """
-    # todo: move this to lib?
-    # Get the sequence as a collection. The files must be of a single
-    # sequence and have no remainder outside of the collections.
-    patterns = [clique.PATTERNS["frames"]]
-    collections, remainder = clique.assemble(files,
-                                             minimum_items=1,
-                                             patterns=patterns)
-    if not collections:
-        raise ValueError("No collections found in files: "
-                         "{}".format(files))
-    if remainder:
-        raise ValueError("Files found not detected as part"
-                         " of a sequence: {}".format(remainder))
-    if len(collections) > 1:
-        raise ValueError("Files in sequence are not part of a"
-                         " single sequence collection: "
-                         "{}".format(collections))
-    return collections[0]
-
-
-def get_instance_families(instance):
-    """Get all families of the instance"""
-    # todo: move this to lib?
-    family = instance.data.get("family")
-    families = []
-    if family:
-        families.append(family)
-
-    for _family in (instance.data.get("families") or []):
-        if _family not in families:
-            families.append(_family)
-
-    return families
-
-
-def get_frame_padded(frame, padding):
-    """Return frame number as string with `padding` amount of padded zeros"""
-    return "{frame:0{padding}d}".format(padding=padding, frame=frame)
-
-
-def get_first_frame_padded(collection):
-    """Return first frame as padded number from `clique.Collection`"""
-    start_frame = next(iter(collection.indexes))
-    return get_frame_padded(start_frame, padding=collection.padding)
-
-
-def bulk_write(writes):
-    """Convenience function to bulk write into active project database"""
-    project = legacy_io.Session["AVALON_PROJECT"]
-    return legacy_io._database[project].bulk_write(writes)
-
-
 class IntegrateAssetNew(pyblish.api.InstancePlugin):
-    """Register publish in the database and transfer files to destinations.
+    """Resolve any dependency issues
 
-    Steps:
-        1) Register the subset and version
-        2) Transfer the representation files to the destination
-        3) Register the representation
+    This plug-in resolves any paths which, if not updated might break
+    the published file.
 
-    Requires:
-        instance.data['representations'] - must be a list and each member
-        must be a dictionary with following data:
-            'files': list of filenames for sequence, string for single file.
-                     Only the filename is allowed, without the folder path.
-            'stagingDir': "path/to/folder/with/files"
-            'name': representation name (usually the same as extension)
-            'ext': file extension
-        optional data
-            "frameStart"
-            "frameEnd"
-            'fps'
-            "data": additional metadata for each representation.
+    The order of families is important, when working with lookdev you want to
+    first publish the texture, update the texture paths in the nodes and then
+    publish the shading network. Same goes for file dependent assets.
+
+    Requirements for instance to be correctly integrated
+
+    instance.data['representations'] - must be a list and each member
+    must be a dictionary with following data:
+        'files': list of filenames for sequence, string for single file.
+                 Only the filename is allowed, without the folder path.
+        'stagingDir': "path/to/folder/with/files"
+        'name': representation name (usually the same as extension)
+        'ext': file extension
+    optional data
+        "frameStart"
+        "frameEnd"
+        'fps'
+        "data": additional metadata for each representation.
     """
 
     label = "Integrate Asset New"
@@ -140,6 +92,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "source",
                 "matchmove",
                 "image",
+                "source",
                 "assembly",
                 "fbx",
                 "textures",
@@ -156,51 +109,157 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "usd",
                 "staticMesh",
                 "skeletalMesh",
-                "usdComposition",
-                "usdOverride",
+                "mvLook",
+                "mvUsd",
+                "mvUsdComposition",
+                "mvUsdOverride",
                 "simpleUnrealTexture"
                 ]
-    exclude_families = ["clip", "render.farm"]
-    default_template_name = "publish"
-
-    # Representation context keys that should always be written to
-    # the database even if not used by the destination template
+    exclude_families = ["render.farm"]
     db_representation_context_keys = [
         "project", "asset", "task", "subset", "version", "representation",
-        "family", "hierarchy", "username"
+        "family", "hierarchy", "task", "username"
     ]
+    default_template_name = "publish"
+
+    # suffix to denote temporary files, use without '.'
+    TMP_FILE_EXT = 'tmp'
+
+    # file_url : file_size of all published and uploaded files
+    integrated_file_sizes = {}
 
     # Attributes set by settings
     template_name_profiles = None
+    subset_grouping_profiles = None
 
     def process(self, instance):
+        for ef in self.exclude_families:
+            if (
+                    instance.data["family"] == ef or
+                    ef in instance.data["families"]):
+                self.log.debug("Excluded family '{}' in '{}' or {}".format(
+                    ef, instance.data["family"], instance.data["families"]))
+                return
 
-        # Exclude instances that also contain families from exclude families
-        families = set(get_instance_families(instance))
-        exclude = families & set(self.exclude_families)
-        if exclude:
-            self.log.debug("Instance not integrated due to exclude "
-                           "families found: {}".format(", ".join(exclude)))
+        # instance should be published on a farm
+        if instance.data.get("farm"):
             return
 
-        file_transactions = FileTransaction(log=self.log)
+        # Prepare repsentations that should be integrated
+        repres = instance.data.get("representations")
+        # Raise error if instance don't have any representations
+        if not repres:
+            raise ValueError(
+                "Instance {} has no files to transfer".format(
+                    instance.data["family"]
+                )
+            )
+
+        # Validate type of stored representations
+        if not isinstance(repres, (list, tuple)):
+            raise TypeError(
+                "Instance 'files' must be a list, got: {0} {1}".format(
+                    str(type(repres)), str(repres)
+                )
+            )
+
+        # Filter representations
+        filtered_repres = []
+        for repre in repres:
+            if "delete" in repre.get("tags", []):
+                continue
+            filtered_repres.append(repre)
+
+        # Skip instance if there are not representations to integrate
+        #   all representations should not be integrated
+        if not filtered_repres:
+            self.log.warning((
+                "Skipping, there are no representations"
+                " to integrate for instance {}"
+            ).format(instance.data["family"]))
+            return
+
+        self.integrated_file_sizes = {}
         try:
-            self.register(instance, file_transactions)
+            self.register(instance, filtered_repres)
+            self.log.info("Integrated Asset in to the database ...")
+            self.log.info("instance.data: {}".format(instance.data))
+            self.handle_destination_files(self.integrated_file_sizes,
+                                          'finalize')
         except Exception:
             # clean destination
-            # todo: preferably we'd also rollback *any* changes to the database
-            file_transactions.rollback()
             self.log.critical("Error when registering", exc_info=True)
+            self.handle_destination_files(self.integrated_file_sizes, 'remove')
             six.reraise(*sys.exc_info())
 
-        # Finalizing can't rollback safely so no use for moving it to
-        # the try, except.
-        file_transactions.finalize()
+    def register(self, instance, repres):
+        # Required environment variables
+        anatomy_data = instance.data["anatomyData"]
 
-    def register(self, instance, file_transactions):
+        legacy_io.install()
 
-        instance_stagingdir = instance.data.get("stagingDir")
-        if not instance_stagingdir:
+        context = instance.context
+
+        project_entity = instance.data["projectEntity"]
+
+        context_asset_name = None
+        context_asset_doc = context.data.get("assetEntity")
+        if context_asset_doc:
+            context_asset_name = context_asset_doc["name"]
+
+        asset_name = instance.data["asset"]
+        asset_entity = instance.data.get("assetEntity")
+        if not asset_entity or asset_entity["name"] != context_asset_name:
+            asset_entity = legacy_io.find_one({
+                "type": "asset",
+                "name": asset_name,
+                "parent": project_entity["_id"]
+            })
+            assert asset_entity, (
+                "No asset found by the name \"{0}\" in project \"{1}\""
+            ).format(asset_name, project_entity["name"])
+
+            instance.data["assetEntity"] = asset_entity
+
+            # update anatomy data with asset specific keys
+            # - name should already been set
+            hierarchy = ""
+            parents = asset_entity["data"]["parents"]
+            if parents:
+                hierarchy = "/".join(parents)
+            anatomy_data["hierarchy"] = hierarchy
+
+        # Make sure task name in anatomy data is same as on instance.data
+        asset_tasks = (
+            asset_entity.get("data", {}).get("tasks")
+        ) or {}
+        task_name = instance.data.get("task")
+        if task_name:
+            task_info = asset_tasks.get(task_name) or {}
+            task_type = task_info.get("type")
+
+            project_task_types = project_entity["config"]["tasks"]
+            task_code = project_task_types.get(task_type, {}).get("short_name")
+            anatomy_data["task"] = {
+                "name": task_name,
+                "type": task_type,
+                "short": task_code
+            }
+
+        elif "task" in anatomy_data:
+            # Just set 'task_name' variable to context task
+            task_name = anatomy_data["task"]["name"]
+            task_type = anatomy_data["task"]["type"]
+
+        else:
+            task_name = None
+            task_type = None
+
+        # Fill family in anatomy data
+        anatomy_data["family"] = instance.data.get("family")
+
+        stagingdir = instance.data.get("stagingDir")
+        if not stagingdir:
             self.log.info((
                 "{0} is missing reference to staging directory."
                 " Will try to get it from representation."
@@ -208,515 +267,718 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
         else:
             self.log.debug(
-                "Establishing staging directory "
-                "@ {0}".format(instance_stagingdir)
+                "Establishing staging directory @ {0}".format(stagingdir)
             )
 
-        # Ensure at least one representation is set up for registering.
-        repres = instance.data.get("representations")
-        assert repres, "Instance has no representations data"
-        assert isinstance(repres, (list, tuple)), (
-            "Instance 'representations' must be a list, got: {0} {1}".format(
-                str(type(repres)), str(repres)
-            )
+        subset = self.get_subset(asset_entity, instance)
+        instance.data["subsetEntity"] = subset
+
+        version_number = instance.data["version"]
+        self.log.debug("Next version: v{}".format(version_number))
+
+        version_data = self.create_version_data(context, instance)
+
+        version_data_instance = instance.data.get('versionData')
+        if version_data_instance:
+            version_data.update(version_data_instance)
+
+        # TODO rename method from `create_version` to
+        # `prepare_version` or similar...
+        version = self.create_version(
+            subset=subset,
+            version_number=version_number,
+            data=version_data
         )
 
-        template_name = self.get_template_name(instance)
+        self.log.debug("Creating version ...")
 
-        subset, subset_writes = self.prepare_subset(instance)
-        version, version_writes = self.prepare_version(instance, subset)
+        new_repre_names_low = [
+            _repre["name"].lower()
+            for _repre in repres
+        ]
+
+        existing_version = legacy_io.find_one({
+            'type': 'version',
+            'parent': subset["_id"],
+            'name': version_number
+        })
+
+        if existing_version is None:
+            version_id = legacy_io.insert_one(version).inserted_id
+        else:
+            # Check if instance have set `append` mode which cause that
+            # only replicated representations are set to archive
+            append_repres = instance.data.get("append", False)
+
+            # Update version data
+            # TODO query by _id and
+            legacy_io.update_many({
+                'type': 'version',
+                'parent': subset["_id"],
+                'name': version_number
+            }, {
+                '$set': version
+            })
+            version_id = existing_version['_id']
+
+            # Find representations of existing version and archive them
+            current_repres = list(legacy_io.find({
+                "type": "representation",
+                "parent": version_id
+            }))
+            bulk_writes = []
+            for repre in current_repres:
+                if append_repres:
+                    # archive only duplicated representations
+                    if repre["name"].lower() not in new_repre_names_low:
+                        continue
+                # Representation must change type,
+                # `_id` must be stored to other key and replaced with new
+                # - that is because new representations should have same ID
+                repre_id = repre["_id"]
+                bulk_writes.append(DeleteOne({"_id": repre_id}))
+
+                repre["orig_id"] = repre_id
+                repre["_id"] = ObjectId()
+                repre["type"] = "archived_representation"
+                bulk_writes.append(InsertOne(repre))
+
+            # bulk updates
+            if bulk_writes:
+                project_name = legacy_io.Session["AVALON_PROJECT"]
+                legacy_io.database[project_name].bulk_write(
+                    bulk_writes
+                )
+
+        version = legacy_io.find_one({"_id": version_id})
         instance.data["versionEntity"] = version
 
-        # Get existing representations (if any)
-        existing_repres_by_name = {
-            repres["name"].lower(): repres for repres in legacy_io.find(
-                {
-                    "parent": version["_id"],
-                    "type": "representation"
-                },
-                # Only care about id and name of existing representations
-                projection={"_id": True, "name": True}
-            )
+        existing_repres = list(legacy_io.find({
+            "parent": version_id,
+            "type": "archived_representation"
+        }))
+
+        instance.data['version'] = version['name']
+
+        intent_value = instance.context.data.get("intent")
+        if intent_value and isinstance(intent_value, dict):
+            intent_value = intent_value.get("value")
+
+        if intent_value:
+            anatomy_data["intent"] = intent_value
+
+        anatomy = instance.context.data['anatomy']
+
+        # Find the representations to transfer amongst the files
+        # Each should be a single representation (as such, a single extension)
+        representations = []
+        destination_list = []
+
+        orig_transfers = []
+        if 'transfers' not in instance.data:
+            instance.data['transfers'] = []
+        else:
+            orig_transfers = list(instance.data['transfers'])
+
+        family = self.main_family_from_instance(instance)
+
+        key_values = {
+            "families": family,
+            "tasks": task_name,
+            "hosts": instance.context.data["hostName"],
+            "task_types": task_type
         }
-
-        # Prepare all representations
-        prepared_representations = []
-        for repre in instance.data["representations"]:
-
-            if "delete" in repre.get("tags", []):
-                self.log.debug("Skipping representation marked for deletion: "
-                               "{}".format(repre))
-                continue
-
-            # todo: reduce/simplify what is returned from this function
-            prepared = self.prepare_representation(repre,
-                                                   template_name,
-                                                   existing_repres_by_name,
-                                                   version,
-                                                   instance_stagingdir,
-                                                   instance)
-
-            for src, dst in prepared["transfers"]:
-                # todo: add support for hardlink transfers
-                file_transactions.add(src, dst)
-
-            prepared_representations.append(prepared)
-
-        if not prepared_representations:
-            # Even though we check `instance.data["representations"]` earlier
-            # this could still happen if all representations were tagged with
-            # "delete" and thus are skipped for integration
-            raise RuntimeError("No representations prepared to publish.")
-
-        # Each instance can also have pre-defined transfers not explicitly
-        # part of a representation - like texture resources used by a
-        # .ma representation. Those destination paths are pre-defined, etc.
-        # todo: should we move or simplify this logic?
-        resource_destinations = set()
-        for src, dst in instance.data.get("transfers", []):
-            file_transactions.add(src, dst, mode=FileTransaction.MODE_COPY)
-            resource_destinations.add(os.path.abspath(dst))
-        for src, dst in instance.data.get("hardlinks", []):
-            file_transactions.add(src, dst, mode=FileTransaction.MODE_HARDLINK)
-            resource_destinations.add(os.path.abspath(dst))
-
-        # Bulk write to the database
-        # We write the subset and version to the database before the File
-        # Transaction to reduce the chances of another publish trying to
-        # publish to the same version number since that chance can greatly
-        # increase if the file transaction takes a long time.
-        bulk_write(subset_writes + version_writes)
-        self.log.info("Subset {subset[name]} and Version {version[name]} "
-                      "written to database..".format(subset=subset,
-                                                     version=version))
-
-        # Process all file transfers of all integrations now
-        self.log.debug("Integrating source files to destination ...")
-        file_transactions.process()
-        self.log.debug("Backed up existing files: "
-                       "{}".format(file_transactions.backups))
-        self.log.debug("Transferred files: "
-                       "{}".format(file_transactions.transferred))
-        self.log.debug("Retrieving Representation Site Sync information ...")
-
-        # Get the accessible sites for Site Sync
-        manager = ModulesManager()
-        sync_server_module = manager.modules_by_name["sync_server"]
-        sites = sync_server_module.compute_resource_sync_sites(
-            project_name=instance.data["projectEntity"]["name"]
+        profile = filter_profiles(
+            self.template_name_profiles,
+            key_values,
+            logger=self.log
         )
-        self.log.debug("Sync Server Sites: {}".format(sites))
 
-        # Compute the resource file infos once (files belonging to the
-        # version instance instead of an individual representation) so
-        # we can re-use those file infos per representation
-        anatomy = instance.context.data["anatomy"]
-        resource_file_infos = self.get_files_info(resource_destinations,
-                                                  sites=sites,
-                                                  anatomy=anatomy)
+        template_name = "publish"
+        if profile:
+            template_name = profile["template_name"]
 
-        # Finalize the representations now the published files are integrated
-        # Get 'files' info for representations and its attached resources
-        representation_writes = []
-        new_repre_names_low = set()
-        for prepared in prepared_representations:
-            representation = prepared["representation"]
-            transfers = prepared["transfers"]
-            destinations = [dst for src, dst in transfers]
+        published_representations = {}
+        for idx, repre in enumerate(repres):
+            published_files = []
+
+            # create template data for Anatomy
+            template_data = copy.deepcopy(anatomy_data)
+            if intent_value is not None:
+                template_data["intent"] = intent_value
+
+            resolution_width = repre.get("resolutionWidth")
+            resolution_height = repre.get("resolutionHeight")
+            fps = instance.data.get("fps")
+
+            if resolution_width:
+                template_data["resolution_width"] = resolution_width
+            if resolution_width:
+                template_data["resolution_height"] = resolution_height
+            if resolution_width:
+                template_data["fps"] = fps
+
+            if "originalBasename" in instance.data:
+                template_data.update({
+                    "originalBasename": instance.data.get("originalBasename")
+                })
+
+            files = repre['files']
+            if repre.get('stagingDir'):
+                stagingdir = repre['stagingDir']
+
+            if repre.get("outputName"):
+                template_data["output"] = repre['outputName']
+
+            template_data["representation"] = repre["name"]
+
+            ext = repre["ext"]
+            if ext.startswith("."):
+                self.log.warning((
+                    "Implementaion warning: <\"{}\">"
+                    " Representation's extension stored under \"ext\" key "
+                    " started with dot (\"{}\")."
+                ).format(repre["name"], ext))
+                ext = ext[1:]
+            repre["ext"] = ext
+            template_data["ext"] = ext
+
+            self.log.info(template_name)
+            template = os.path.normpath(
+                anatomy.templates[template_name]["path"])
+
+            sequence_repre = isinstance(files, list)
+            repre_context = None
+            if sequence_repre:
+                self.log.debug(
+                    "files: {}".format(files))
+                src_collections, remainder = clique.assemble(files)
+                self.log.debug(
+                    "src_tail_collections: {}".format(str(src_collections)))
+                src_collection = src_collections[0]
+
+                # Assert that each member has identical suffix
+                src_head = src_collection.format("{head}")
+                src_tail = src_collection.format("{tail}")
+
+                # fix dst_padding
+                valid_files = [x for x in files if src_collection.match(x)]
+                padd_len = len(
+                    valid_files[0].replace(src_head, "").replace(src_tail, "")
+                )
+                src_padding_exp = "%0{}d".format(padd_len)
+
+                test_dest_files = list()
+                for i in [1, 2]:
+                    template_data["representation"] = repre['ext']
+                    if not repre.get("udim"):
+                        template_data["frame"] = src_padding_exp % i
+                    else:
+                        template_data["udim"] = src_padding_exp % i
+
+                    anatomy_filled = anatomy.format(template_data)
+                    template_filled = anatomy_filled[template_name]["path"]
+                    if repre_context is None:
+                        repre_context = template_filled.used_values
+                    test_dest_files.append(
+                        os.path.normpath(template_filled)
+                    )
+                if not repre.get("udim"):
+                    template_data["frame"] = repre_context["frame"]
+                else:
+                    template_data["udim"] = repre_context["udim"]
+
+                self.log.debug(
+                    "test_dest_files: {}".format(str(test_dest_files)))
+
+                dst_collections, remainder = clique.assemble(test_dest_files)
+                dst_collection = dst_collections[0]
+                dst_head = dst_collection.format("{head}")
+                dst_tail = dst_collection.format("{tail}")
+
+                index_frame_start = None
+
+                # TODO use frame padding from right template group
+                if repre.get("frameStart") is not None:
+                    frame_start_padding = int(
+                        anatomy.templates["render"].get(
+                            "frame_padding",
+                            anatomy.templates["render"].get("padding")
+                        )
+                    )
+
+                    index_frame_start = int(repre.get("frameStart"))
+
+                # exception for slate workflow
+                if index_frame_start and "slate" in instance.data["families"]:
+                    index_frame_start -= 1
+
+                dst_padding_exp = src_padding_exp
+                dst_start_frame = None
+                collection_start = list(src_collection.indexes)[0]
+                for i in src_collection.indexes:
+                    # TODO 1.) do not count padding in each index iteration
+                    # 2.) do not count dst_padding from src_padding before
+                    #   index_frame_start check
+                    frame_number = i - collection_start
+                    src_padding = src_padding_exp % i
+
+                    src_file_name = "{0}{1}{2}".format(
+                        src_head, src_padding, src_tail)
+
+                    dst_padding = src_padding_exp % frame_number
+
+                    if index_frame_start is not None:
+                        dst_padding_exp = "%0{}d".format(frame_start_padding)
+                        dst_padding = dst_padding_exp % (index_frame_start + frame_number)  # noqa: E501
+                    elif repre.get("udim"):
+                        dst_padding = int(i)
+
+                    dst = "{0}{1}{2}".format(
+                        dst_head,
+                        dst_padding,
+                        dst_tail
+                    )
+
+                    self.log.debug("destination: `{}`".format(dst))
+                    src = os.path.join(stagingdir, src_file_name)
+
+                    self.log.debug("source: {}".format(src))
+                    instance.data["transfers"].append([src, dst])
+
+                    published_files.append(dst)
+
+                    # for adding first frame into db
+                    if not dst_start_frame:
+                        dst_start_frame = dst_padding
+
+                # Store used frame value to template data
+                if repre.get("frame"):
+                    template_data["frame"] = dst_start_frame
+
+                dst = "{0}{1}{2}".format(
+                    dst_head,
+                    dst_start_frame,
+                    dst_tail
+                )
+                repre['published_path'] = dst
+
+            else:
+                # Single file
+                #  _______
+                # |      |\
+                # |       |
+                # |       |
+                # |       |
+                # |_______|
+                #
+                template_data.pop("frame", None)
+                fname = files
+                assert not os.path.isabs(fname), (
+                    "Given file name is a full path"
+                )
+
+                template_data["representation"] = repre['ext']
+                # Store used frame value to template data
+                if repre.get("udim"):
+                    template_data["udim"] = repre["udim"][0]
+                src = os.path.join(stagingdir, fname)
+                anatomy_filled = anatomy.format(template_data)
+                template_filled = anatomy_filled[template_name]["path"]
+                repre_context = template_filled.used_values
+                dst = os.path.normpath(template_filled)
+
+                instance.data["transfers"].append([src, dst])
+
+                published_files.append(dst)
+                repre['published_path'] = dst
+                self.log.debug("__ dst: {}".format(dst))
+
+            if not instance.data.get("publishDir"):
+                instance.data["publishDir"] = (
+                    anatomy_filled
+                    [template_name]
+                    ["folder"]
+                )
+            if repre.get("udim"):
+                repre_context["udim"] = repre.get("udim")  # store list
+
+            repre["publishedFiles"] = published_files
+
+            for key in self.db_representation_context_keys:
+                value = template_data.get(key)
+                if not value:
+                    continue
+                repre_context[key] = template_data[key]
+
+            # Use previous representation's id if there are any
+            repre_id = None
+            repre_name_low = repre["name"].lower()
+            for _repre in existing_repres:
+                # NOTE should we check lowered names?
+                if repre_name_low == _repre["name"]:
+                    repre_id = _repre["orig_id"]
+                    break
+
+            # Create new id if existing representations does not match
+            if repre_id is None:
+                repre_id = ObjectId()
+
+            data = repre.get("data") or {}
+            data.update({'path': dst, 'template': template})
+            representation = {
+                "_id": repre_id,
+                "schema": "openpype:representation-2.0",
+                "type": "representation",
+                "parent": version_id,
+                "name": repre['name'],
+                "data": data,
+                "dependencies": instance.data.get("dependencies", "").split(),
+
+                # Imprint shortcut to context
+                # for performance reasons.
+                "context": repre_context
+            }
+
+            if repre.get("outputName"):
+                representation["context"]["output"] = repre['outputName']
+
+            if sequence_repre and repre.get("frameStart") is not None:
+                representation['context']['frame'] = (
+                    dst_padding_exp % int(repre.get("frameStart"))
+                )
+
+            # any file that should be physically copied is expected in
+            # 'transfers' or 'hardlinks'
+            if instance.data.get('transfers', False) or \
+               instance.data.get('hardlinks', False):
+                # could throw exception, will be caught in 'process'
+                # all integration to DB is being done together lower,
+                # so no rollback needed
+                self.log.debug("Integrating source files to destination ...")
+                self.integrated_file_sizes.update(self.integrate(instance))
+                self.log.debug("Integrated files {}".
+                               format(self.integrated_file_sizes))
+
+            # get 'files' info for representation and all attached resources
+            self.log.debug("Preparing files information ...")
             representation["files"] = self.get_files_info(
-                destinations, sites=sites, anatomy=anatomy
-            )
+                instance,
+                self.integrated_file_sizes)
 
-            # Add the version resource file infos to each representation
-            representation["files"] += resource_file_infos
+            self.log.debug("__ representation: {}".format(representation))
+            destination_list.append(dst)
+            self.log.debug("__ destination_list: {}".format(destination_list))
+            instance.data['destination_list'] = destination_list
+            representations.append(representation)
+            published_representations[repre_id] = {
+                "representation": representation,
+                "anatomy_data": template_data,
+                "published_files": published_files
+            }
+            self.log.debug("__ representations: {}".format(representations))
+            # reset transfers for next representation
+            # instance.data['transfers'] is used as a global variable
+            # in current codebase
+            instance.data['transfers'] = list(orig_transfers)
 
-            # Set up representation for writing to the database. Since
-            # we *might* be overwriting an existing entry if the version
-            # already existed we'll use ReplaceOnce with `upsert=True`
-            representation_writes.append(ReplaceOne(
-                filter={"_id": representation["_id"]},
-                replacement=representation,
-                upsert=True
-            ))
+        # Remove old representations if there are any (before insertion of new)
+        if existing_repres:
+            repre_ids_to_remove = []
+            for repre in existing_repres:
+                repre_ids_to_remove.append(repre["_id"])
+            legacy_io.delete_many({"_id": {"$in": repre_ids_to_remove}})
 
-            new_repre_names_low.add(representation["name"].lower())
+        for rep in instance.data["representations"]:
+            self.log.debug("__ rep: {}".format(rep))
 
-        # Delete any existing representations that didn't get any new data
-        # if the instance is not set to append mode
-        if not instance.data.get("append", False):
-            delete_names = set()
-            for name, existing_repres in existing_repres_by_name.items():
-                if name not in new_repre_names_low:
-                    # We add the exact representation name because `name` is
-                    # lowercase for name matching only and not in the database
-                    delete_names.add(existing_repres["name"])
-            if delete_names:
-                representation_writes.append(DeleteMany(
-                    filter={
-                        "parent": version["_id"],
-                        "name": {"$in": list(delete_names)}
-                    }
-                ))
+        legacy_io.insert_many(representations)
+        instance.data["published_representations"] = (
+            published_representations
+        )
+        # self.log.debug("Representation: {}".format(representations))
+        self.log.info("Registered {} items".format(len(representations)))
 
-        # Write representations to the database
-        bulk_write(representation_writes)
+    def integrate(self, instance):
+        """ Move the files.
 
-        # Backwards compatibility
-        # todo: can we avoid the need to store this?
-        instance.data["published_representations"] = {
-            p["representation"]["_id"]: p for p in prepared_representations
-        }
+            Through `instance.data["transfers"]`
 
-        self.log.info("Registered {} representations"
-                      "".format(len(prepared_representations)))
+            Args:
+                instance: the instance to integrate
+            Returns:
+                integrated_file_sizes: dictionary of destination file url and
+                its size in bytes
+        """
+        # store destination url and size for reporting and rollback
+        integrated_file_sizes = {}
+        transfers = list(instance.data.get("transfers", list()))
+        for src, dest in transfers:
+            if os.path.normpath(src) != os.path.normpath(dest):
+                dest = self.get_dest_temp_url(dest)
+                self.copy_file(src, dest)
+                # TODO needs to be updated during site implementation
+                integrated_file_sizes[dest] = os.path.getsize(dest)
 
-    def prepare_subset(self, instance):
-        asset = instance.data.get("assetEntity")
+        # Produce hardlinked copies
+        # Note: hardlink can only be produced between two files on the same
+        # server/disk and editing one of the two will edit both files at once.
+        # As such it is recommended to only make hardlinks between static files
+        # to ensure publishes remain safe and non-edited.
+        hardlinks = instance.data.get("hardlinks", list())
+        for src, dest in hardlinks:
+            dest = self.get_dest_temp_url(dest)
+            self.log.debug("Hardlinking file ... {} -> {}".format(src, dest))
+            if not os.path.exists(dest):
+                self.hardlink_file(src, dest)
+
+            # TODO needs to be updated during site implementation
+            integrated_file_sizes[dest] = os.path.getsize(dest)
+
+        return integrated_file_sizes
+
+    def copy_file(self, src, dst):
+        """ Copy given source to destination
+
+        Arguments:
+            src (str): the source file which needs to be copied
+            dst (str): the destination of the sourc file
+        Returns:
+            None
+        """
+        src = os.path.normpath(src)
+        dst = os.path.normpath(dst)
+        self.log.debug("Copying file ... {} -> {}".format(src, dst))
+        dirname = os.path.dirname(dst)
+        try:
+            os.makedirs(dirname)
+        except OSError as e:
+            if e.errno == errno.EEXIST:
+                pass
+            else:
+                self.log.critical("An unexpected error occurred.")
+                six.reraise(*sys.exc_info())
+
+        # copy file with speedcopy and check if size of files are simetrical
+        while True:
+            if not shutil._samefile(src, dst):
+                copyfile(src, dst)
+            else:
+                self.log.critical(
+                    "files are the same {} to {}".format(src, dst)
+                )
+                os.remove(dst)
+                try:
+                    shutil.copyfile(src, dst)
+                    self.log.debug("Copying files with shutil...")
+                except OSError as e:
+                    self.log.critical("Cannot copy {} to {}".format(src, dst))
+                    self.log.critical(e)
+                    six.reraise(*sys.exc_info())
+            if str(getsize(src)) in str(getsize(dst)):
+                break
+
+    def hardlink_file(self, src, dst):
+        dirname = os.path.dirname(dst)
+
+        try:
+            os.makedirs(dirname)
+        except OSError as e:
+            if e.errno == errno.EEXIST:
+                pass
+            else:
+                self.log.critical("An unexpected error occurred.")
+                six.reraise(*sys.exc_info())
+
+        create_hard_link(src, dst)
+
+    def get_subset(self, asset, instance):
         subset_name = instance.data["subset"]
-        self.log.debug("Subset: {}".format(subset_name))
-
-        # Get existing subset if it exists
         subset = legacy_io.find_one({
             "type": "subset",
             "parent": asset["_id"],
             "name": subset_name
         })
 
-        # Define subset data
-        data = {
-            "families": get_instance_families(instance)
-        }
-
-        subset_group = instance.data.get("subsetGroup")
-        if subset_group:
-            data["subsetGroup"] = subset_group
-
-        bulk_writes = []
         if subset is None:
-            # Create a new subset
             self.log.info("Subset '%s' not found, creating ..." % subset_name)
-            subset = {
-                "_id": ObjectId(),
+            self.log.debug("families.  %s" % instance.data.get('families'))
+            self.log.debug(
+                "families.  %s" % type(instance.data.get('families')))
+
+            family = instance.data.get("family")
+            families = []
+            if family:
+                families.append(family)
+
+            for _family in (instance.data.get("families") or []):
+                if _family not in families:
+                    families.append(_family)
+
+            _id = legacy_io.insert_one({
                 "schema": "openpype:subset-3.0",
                 "type": "subset",
                 "name": subset_name,
-                "data": data,
+                "data": {
+                    "families": families
+                },
                 "parent": asset["_id"]
-            }
-            bulk_writes.append(InsertOne(subset))
+            }).inserted_id
 
-        else:
-            # Update existing subset data with new data and set in database.
-            # We also change the found subset in-place so we don't need to
-            # re-query the subset afterwards
-            subset["data"].update(data)
-            bulk_writes.append(UpdateOne(
-                {"type": "subset", "_id": subset["_id"]},
-                {"$set": {
-                    "data": subset["data"]
-                }}
-            ))
+            subset = legacy_io.find_one({"_id": _id})
 
-        self.log.info("Prepared subset: {}".format(subset_name))
-        return subset, bulk_writes
+        # QUESTION Why is changing of group and updating it's
+        #   families in 'get_subset'?
+        self._set_subset_group(instance, subset["_id"])
 
-    def prepare_version(self, instance, subset):
+        # Update families on subset.
+        families = [instance.data["family"]]
+        families.extend(instance.data.get("families", []))
+        legacy_io.update_many(
+            {"type": "subset", "_id": ObjectId(subset["_id"])},
+            {"$set": {"data.families": families}}
+        )
 
-        version_number = instance.data["version"]
+        return subset
 
-        version = {
-            "schema": "openpype:version-3.0",
-            "type": "version",
-            "parent": subset["_id"],
-            "name": version_number,
-            "data": self.create_version_data(instance)
+    def _set_subset_group(self, instance, subset_id):
+        """
+            Mark subset as belonging to group in DB.
+
+            Uses Settings > Global > Publish plugins > IntegrateAssetNew
+
+            Args:
+                instance (dict): processed instance
+                subset_id (str): DB's subset _id
+
+        """
+        # Fist look into instance data
+        subset_group = instance.data.get("subsetGroup")
+        if not subset_group:
+            subset_group = self._get_subset_group(instance)
+
+        if subset_group:
+            legacy_io.update_many({
+                'type': 'subset',
+                '_id': ObjectId(subset_id)
+            }, {'$set': {'data.subsetGroup': subset_group}})
+
+    def _get_subset_group(self, instance):
+        """Look into subset group profiles set by settings.
+
+        Attribute 'subset_grouping_profiles' is defined by OpenPype settings.
+        """
+        # Skip if 'subset_grouping_profiles' is empty
+        if not self.subset_grouping_profiles:
+            return None
+
+        # QUESTION
+        #   - is there a chance that task name is not filled in anatomy
+        #       data?
+        #   - should we use context task in that case?
+        anatomy_data = instance.data["anatomyData"]
+        task_name = None
+        task_type = None
+        if "task" in anatomy_data:
+            task_name = anatomy_data["task"]["name"]
+            task_type = anatomy_data["task"]["type"]
+        filtering_criteria = {
+            "families": instance.data["family"],
+            "hosts": instance.context.data["hostName"],
+            "tasks": task_name,
+            "task_types": task_type
         }
+        matching_profile = filter_profiles(
+            self.subset_grouping_profiles,
+            filtering_criteria
+        )
+        # Skip if there is not matchin profile
+        if not matching_profile:
+            return None
 
-        existing_version = legacy_io.find_one({
-            'type': 'version',
-            'parent': subset["_id"],
-            'name': version_number
-        }, projection={"_id": True})
+        filled_template = None
+        template = matching_profile["template"]
+        fill_pairs = (
+            ("family", filtering_criteria["families"]),
+            ("task", filtering_criteria["tasks"]),
+            ("host", filtering_criteria["hosts"]),
+            ("subset", instance.data["subset"]),
+            ("renderlayer", instance.data.get("renderlayer"))
+        )
+        fill_pairs = prepare_template_data(fill_pairs)
 
-        if existing_version:
-            self.log.debug("Updating existing version ...")
-            version["_id"] = existing_version["_id"]
-        else:
-            self.log.debug("Creating new version ...")
-            version["_id"] = ObjectId()
-
-        bulk_writes = [ReplaceOne(
-            filter={"_id": version["_id"]},
-            replacement=version,
-            upsert=True
-        )]
-
-        self.log.info("Prepared version: v{0:03d}".format(version["name"]))
-
-        return version, bulk_writes
-
-    def prepare_representation(self, repre,
-                               template_name,
-                               existing_repres_by_name,
-                               version,
-                               instance_stagingdir,
-                               instance):
-
-        # pre-flight validations
-        if repre["ext"].startswith("."):
-            raise ValueError("Extension must not start with a dot '.': "
-                             "{}".format(repre["ext"]))
-
-        if repre.get("transfers"):
-            raise ValueError("Representation is not allowed to have transfers"
-                             "data before integration. They are computed in "
-                             "the integrator"
-                             "Got: {}".format(repre["transfers"]))
-
-        # create template data for Anatomy
-        template_data = copy.deepcopy(instance.data["anatomyData"])
-
-        # required representation keys
-        files = repre['files']
-        template_data["representation"] = repre["name"]
-        template_data["ext"] = repre["ext"]
-
-        # optionals
-        # retrieve additional anatomy data from representation if exists
-        for key, anatomy_key in {
-            # Representation Key: Anatomy data key
-            "resolutionWidth": "resolution_width",
-            "resolutionHeight": "resolution_height",
-            "fps": "fps",
-            "outputName": "output",
-            "originalBasename": "originalBasename"
-        }.items():
-            # Allow to take value from representation
-            # if not found also consider instance.data
-            if key in repre:
-                value = repre[key]
-            elif key in instance.data:
-                value = instance.data[key]
-            else:
-                continue
-            template_data[anatomy_key] = value
-
-        if repre.get('stagingDir'):
-            stagingdir = repre['stagingDir']
-        else:
-            # Fall back to instance staging dir if not explicitly
-            # set for representation in the instance
-            self.log.debug("Representation uses instance staging dir: "
-                           "{}".format(instance_stagingdir))
-            stagingdir = instance_stagingdir
-        if not stagingdir:
-            raise ValueError("No staging directory set for representation: "
-                             "{}".format(repre))
-
-        self.log.debug("Anatomy template name: {}".format(template_name))
-        anatomy = instance.context.data['anatomy']
-        template = os.path.normpath(anatomy.templates[template_name]["path"])
-
-        is_udim = bool(repre.get("udim"))
-        is_sequence_representation = isinstance(files, (list, tuple))
-        if is_sequence_representation:
-            # Collection of files (sequence)
-            assert not any(os.path.isabs(fname) for fname in files), (
-                "Given file names contain full paths"
+        try:
+            filled_template = StringTemplate.format_strict_template(
+                template, fill_pairs
             )
+        except (KeyError, TemplateUnsolved):
+            keys = []
+            if fill_pairs:
+                keys = fill_pairs.keys()
 
-            src_collection = assemble(files)
+            msg = "Subset grouping failed. " \
+                  "Only {} are expected in Settings".format(','.join(keys))
+            self.log.warning(msg)
 
-            # If the representation has `frameStart` set it renumbers the
-            # frame indices of the published collection. It will start from
-            # that `frameStart` index instead. Thus if that frame start
-            # differs from the collection we want to shift the destination
-            # frame indices from the source collection.
-            destination_indexes = list(src_collection.indexes)
-            destination_padding = len(get_first_frame_padded(src_collection))
-            if repre.get("frameStart") is not None and not is_udim:
-                index_frame_start = int(repre.get("frameStart"))
+        return filled_template
 
-                render_template = anatomy.templates[template_name]
-                # todo: should we ALWAYS manage the frame padding even when not
-                #       having `frameStart` set?
-                frame_start_padding = int(
-                    render_template.get(
-                        "frame_padding",
-                        render_template.get("padding")
-                    )
-                )
-
-                # Shift destination sequence to the start frame
-                src_start_frame = next(iter(src_collection.indexes))
-                shift = index_frame_start - src_start_frame
-                if shift:
-                    destination_indexes = [
-                        frame + shift for frame in destination_indexes
-                    ]
-                destination_padding = frame_start_padding
-
-            # To construct the destination template with anatomy we require
-            # a Frame or UDIM tile set for the template data. We use the first
-            # index of the destination for that because that could've shifted
-            # from the source indexes, etc.
-            first_index_padded = get_frame_padded(frame=destination_indexes[0],
-                                                  padding=destination_padding)
-            if is_udim:
-                # UDIM representations handle ranges in a different manner
-                template_data["udim"] = first_index_padded
-            else:
-                template_data["frame"] = first_index_padded
-
-            # Construct destination collection from template
-            anatomy_filled = anatomy.format(template_data)
-            template_filled = anatomy_filled[template_name]["path"]
-            repre_context = template_filled.used_values
-            self.log.debug("Template filled: {}".format(str(template_filled)))
-            dst_collection = assemble([os.path.normpath(template_filled)])
-
-            # Update the destination indexes and padding
-            dst_collection.indexes.clear()
-            dst_collection.indexes.update(set(destination_indexes))
-            dst_collection.padding = destination_padding
-            assert (
-                len(src_collection.indexes) == len(dst_collection.indexes)
-            ), "This is a bug"
-
-            # Multiple file transfers
-            transfers = []
-            for src_file_name, dst in zip(src_collection, dst_collection):
-                src = os.path.join(stagingdir, src_file_name)
-                transfers.append((src, dst))
-
-        else:
-            # Single file
-            fname = files
-            assert not os.path.isabs(fname), (
-                "Given file name is a full path"
-            )
-
-            # Manage anatomy template data
-            template_data.pop("frame", None)
-            if is_udim:
-                template_data["udim"] = repre["udim"][0]
-
-            # Construct destination filepath from template
-            anatomy_filled = anatomy.format(template_data)
-            template_filled = anatomy_filled[template_name]["path"]
-            repre_context = template_filled.used_values
-            dst = os.path.normpath(template_filled)
-
-            # Single file transfer
-            src = os.path.join(stagingdir, fname)
-            transfers = [(src, dst)]
-
-        # todo: Are we sure the assumption each representation
-        #       ends up in the same folder is valid?
-        if not instance.data.get("publishDir"):
-            instance.data["publishDir"] = (
-                anatomy_filled
-                [template_name]
-                ["folder"]
-            )
-
-        for key in self.db_representation_context_keys:
-            # Also add these values to the context even if not used by the
-            # destination template
-            value = template_data.get(key)
-            if not value:
-                continue
-            repre_context[key] = template_data[key]
-
-        # Explicitly store the full list even though template data might
-        # have a different value because it uses just a single udim tile
-        if repre.get("udim"):
-            repre_context["udim"] = repre.get("udim")  # store list
-
-        # Use previous representation's id if there is a name match
-        existing = existing_repres_by_name.get(repre["name"].lower())
-        if existing:
-            repre_id = existing["_id"]
-        else:
-            repre_id = ObjectId()
-
-        # Backwards compatibility:
-        # Store first transferred destination as published path data
-        # todo: can we remove this?
-        # todo: We shouldn't change data that makes its way back into
-        #       instance.data[] until we know the publish actually succeeded
-        #       otherwise `published_path` might not actually be valid?
-        published_path = transfers[0][1]
-        repre["published_path"] = published_path  # Backwards compatibility
-
-        # todo: `repre` is not the actual `representation` entity
-        #       we should simplify/clarify difference between data above
-        #       and the actual representation entity for the database
-        data = repre.get("data", {})
-        data.update({'path': published_path, 'template': template})
-        representation = {
-            "_id": repre_id,
-            "schema": "openpype:representation-2.0",
-            "type": "representation",
-            "parent": version["_id"],
-            "name": repre['name'],
-            "data": data,
-
-            # Imprint shortcut to context for performance reasons.
-            "context": repre_context
-        }
-
-        # todo: simplify/streamline which additional data makes its way into
-        #       the representation context
-        if repre.get("outputName"):
-            representation["context"]["output"] = repre['outputName']
-
-        if is_sequence_representation and repre.get("frameStart") is not None:
-            representation['context']['frame'] = template_data["frame"]
-
-        return {
-            "representation": representation,
-            "anatomy_data": template_data,
-            "transfers": transfers,
-            # todo: avoid the need for 'published_files' used by Integrate Hero
-            # backwards compatibility
-            "published_files": [transfer[1] for transfer in transfers]
-        }
-
-    def create_version_data(self, instance):
-        """Create the data dictionary for the version
+    def create_version(self, subset, version_number, data=None):
+        """ Copy given source to destination
 
         Args:
+            subset (dict): the registered subset of the asset
+            version_number (int): the version number
+
+        Returns:
+            dict: collection of data to create a version
+        """
+
+        return {"schema": "openpype:version-3.0",
+                "type": "version",
+                "parent": subset["_id"],
+                "name": version_number,
+                "data": data}
+
+    def create_version_data(self, context, instance):
+        """Create the data collection for the version
+
+        Args:
+            context: the current context
             instance: the current instance being published
 
         Returns:
-            dict: the required information for version["data"]
+            dict: the required information with instance.data as key
         """
 
-        context = instance.context
+        families = []
+        current_families = instance.data.get("families", list())
+        instance_family = instance.data.get("family", None)
+
+        if instance_family is not None:
+            families.append(instance_family)
+        families += current_families
 
         # create relative source path for DB
-        if "source" in instance.data:
-            source = instance.data["source"]
-        else:
+        source = instance.data.get("source")
+        if not source:
             source = context.data["currentFile"]
             anatomy = instance.context.data["anatomy"]
             source = self.get_rootless_path(anatomy, source)
-        self.log.debug("Source: {}".format(source))
 
+        self.log.debug("Source: {}".format(source))
         version_data = {
-            "families": get_instance_families(instance),
+            "families": families,
             "time": context.data["time"],
             "author": context.data["user"],
             "source": source,
             "comment": context.data.get("comment"),
             "machine": context.data.get("machine"),
-            "fps": instance.data.get("fps", context.data.get("fps"))
+            "fps": context.data.get(
+                "fps", instance.data.get("fps")
+            )
         }
 
-        # todo: preferably we wouldn't need this "if dict" etc. logic and
-        #       instead be able to rely what the input value is if it's set.
-        intent_value = context.data.get("intent")
+        intent_value = instance.context.data.get("intent")
         if intent_value and isinstance(intent_value, dict):
             intent_value = intent_value.get("value")
 
@@ -732,58 +994,33 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             if key in instance.data:
                 version_data[key] = instance.data[key]
 
-        # Include instance.data[versionData] directly
-        version_data_instance = instance.data.get('versionData')
-        if version_data_instance:
-            version_data.update(version_data_instance)
-
         return version_data
 
-    def get_template_name(self, instance):
-        """Return anatomy template name to use for integration"""
-        # Define publish template name from profiles
-        filter_criteria = self.get_profile_filter_criteria(instance)
-        profile = filter_profiles(self.template_name_profiles,
-                                  filter_criteria,
-                                  logger=self.log)
-        if profile:
-            return profile["template_name"]
-        else:
-            return self.default_template_name
-
-    def get_profile_filter_criteria(self, instance):
-        """Return filter criteria for `filter_profiles`"""
-        # Anatomy data is pre-filled by Collectors
-        anatomy_data = instance.data["anatomyData"]
-
-        # Task can be optional in anatomy data
-        task = anatomy_data.get("task", {})
-
-        # Return filter criteria
-        return {
-            "families": anatomy_data["family"],
-            "tasks": task.get("name"),
-            "hosts": anatomy_data["app"],
-            "task_types": task.get("type")
-        }
+    def main_family_from_instance(self, instance):
+        """Returns main family of entered instance."""
+        family = instance.data.get("family")
+        if not family:
+            family = instance.data["families"][0]
+        return family
 
     def get_rootless_path(self, anatomy, path):
-        """Returns, if possible, path without absolute portion from root
-            (eg. 'c:\' or '/opt/..')
-
-         This information is platform dependent and shouldn't be captured.
-         Example:
-             'c:/projects/MyProject1/Assets/publish...' >
-             '{root}/MyProject1/Assets...'
+        """  Returns, if possible, path without absolute portion from host
+             (eg. 'c:\' or '/opt/..')
+             This information is host dependent and shouldn't be captured.
+             Example:
+                 'c:/projects/MyProject1/Assets/publish...' >
+                 '{root}/MyProject1/Assets...'
 
         Args:
-            anatomy: anatomy part from instance
-            path: path (absolute)
+                anatomy: anatomy part from instance
+                path: path (absolute)
         Returns:
-            path: modified path if possible, or unmodified path
-            + warning logged
+                path: modified path if possible, or unmodified path
+                + warning logged
         """
-        success, rootless_path = anatomy.find_root_template_from_path(path)
+        success, rootless_path = (
+            anatomy.find_root_template_from_path(path)
+        )
         if success:
             path = rootless_path
         else:
@@ -793,40 +1030,269 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
             ).format(path))
         return path
 
-    def get_files_info(self, destinations, sites, anatomy):
-        """Prepare 'files' info portion for representations.
+    def get_files_info(self, instance, integrated_file_sizes):
+        """ Prepare 'files' portion for attached resources and main asset.
+            Combining records from 'transfers' and 'hardlinks' parts from
+            instance.
+            All attached resources should be added, currently without
+            Context info.
 
         Arguments:
-            destinations (list): List of transferred file destinations
-            sites (list): array of published locations
-            anatomy: anatomy part from instance
+            instance: the current instance being published
+            integrated_file_sizes: dictionary of destination path (absolute)
+            and its file size
         Returns:
             output_resources: array of dictionaries to be added to 'files' key
             in representation
         """
-        file_infos = []
-        for file_path in destinations:
-            file_info = self.prepare_file_info(file_path, anatomy, sites=sites)
-            file_infos.append(file_info)
-        return file_infos
+        resources = list(instance.data.get("transfers", []))
+        resources.extend(list(instance.data.get("hardlinks", [])))
 
-    def prepare_file_info(self, path, anatomy, sites):
+        self.log.debug("get_resource_files_info.resources:{}".
+                       format(resources))
+
+        output_resources = []
+        anatomy = instance.context.data["anatomy"]
+        for _src, dest in resources:
+            path = self.get_rootless_path(anatomy, dest)
+            dest = self.get_dest_temp_url(dest)
+            file_hash = openpype.api.source_hash(dest)
+            if self.TMP_FILE_EXT and \
+               ',{}'.format(self.TMP_FILE_EXT) in file_hash:
+                file_hash = file_hash.replace(',{}'.format(self.TMP_FILE_EXT),
+                                              '')
+
+            file_info = self.prepare_file_info(path,
+                                               integrated_file_sizes[dest],
+                                               file_hash,
+                                               instance=instance)
+            output_resources.append(file_info)
+
+        return output_resources
+
+    def get_dest_temp_url(self, dest):
+        """ Enhance destination path with TMP_FILE_EXT to denote temporary
+            file.
+            Temporary files will be renamed after successful registration
+            into DB and full copy to destination
+
+        Arguments:
+            dest: destination url of published file (absolute)
+        Returns:
+            dest: destination path + '.TMP_FILE_EXT'
+        """
+        if self.TMP_FILE_EXT and '.{}'.format(self.TMP_FILE_EXT) not in dest:
+            dest += '.{}'.format(self.TMP_FILE_EXT)
+        return dest
+
+    def prepare_file_info(self, path, size=None, file_hash=None,
+                          sites=None, instance=None):
         """ Prepare information for one file (asset or resource)
 
         Arguments:
-            path: destination url of published file
-            anatomy: anatomy part from instance
-            sites: array of published locations,
-                [ {'name':'studio', 'created_dt':date} by default
-                keys expected ['studio', 'site1', 'gdrive1']
-
+            path: destination url of published file (rootless)
+            size(optional): size of file in bytes
+            file_hash(optional): hash of file for synchronization validation
+            sites(optional): array of published locations,
+                            [ {'name':'studio', 'created_dt':date} by default
+                                keys expected ['studio', 'site1', 'gdrive1']
+            instance(dict, optional): to get collected settings
         Returns:
-            dict: file info dictionary
+            rec: dictionary with filled info
         """
-        return {
+        local_site = 'studio'  # default
+        remote_site = None
+        always_accesible = []
+        sync_project_presets = None
+
+        rec = {
             "_id": ObjectId(),
-            "path": self.get_rootless_path(anatomy, path),
-            "size": os.path.getsize(path),
-            "hash": openpype.api.source_hash(path),
-            "sites": sites
+            "path": path
         }
+        if size:
+            rec["size"] = size
+
+        if file_hash:
+            rec["hash"] = file_hash
+
+        if sites:
+            rec["sites"] = sites
+        else:
+            system_sync_server_presets = (
+                instance.context.data["system_settings"]
+                                     ["modules"]
+                                     ["sync_server"])
+            log.debug("system_sett:: {}".format(system_sync_server_presets))
+
+            if system_sync_server_presets["enabled"]:
+                sync_project_presets = (
+                    instance.context.data["project_settings"]
+                                         ["global"]
+                                         ["sync_server"])
+
+            if sync_project_presets and sync_project_presets["enabled"]:
+                local_site, remote_site = self._get_sites(sync_project_presets)
+
+                always_accesible = sync_project_presets["config"]. \
+                    get("always_accessible_on", [])
+
+            already_attached_sites = {}
+            meta = {"name": local_site, "created_dt": datetime.now()}
+            rec["sites"] = [meta]
+            already_attached_sites[meta["name"]] = meta["created_dt"]
+
+            if sync_project_presets and sync_project_presets["enabled"]:
+                if remote_site and \
+                        remote_site not in already_attached_sites.keys():
+                    # add remote
+                    meta = {"name": remote_site.strip()}
+                    rec["sites"].append(meta)
+                    already_attached_sites[meta["name"]] = None
+
+                # add alternative sites
+                rec, already_attached_sites = self._add_alternative_sites(
+                    system_sync_server_presets, already_attached_sites, rec)
+
+                # add skeleton for site where it should be always synced to
+                for always_on_site in set(always_accesible):
+                    if always_on_site not in already_attached_sites.keys():
+                        meta = {"name": always_on_site.strip()}
+                        rec["sites"].append(meta)
+                        already_attached_sites[meta["name"]] = None
+
+            log.debug("final sites:: {}".format(rec["sites"]))
+
+        return rec
+
+    def _get_sites(self, sync_project_presets):
+        """Returns tuple (local_site, remote_site)"""
+        local_site_id = openpype.api.get_local_site_id()
+        local_site = sync_project_presets["config"]. \
+            get("active_site", "studio").strip()
+
+        if local_site == 'local':
+            local_site = local_site_id
+
+        remote_site = sync_project_presets["config"].get("remote_site")
+
+        if remote_site == 'local':
+            remote_site = local_site_id
+
+        return local_site, remote_site
+
+    def _add_alternative_sites(self,
+                               system_sync_server_presets,
+                               already_attached_sites,
+                               rec):
+        """Loop through all configured sites and add alternatives.
+
+            See SyncServerModule.handle_alternate_site
+        """
+        conf_sites = system_sync_server_presets.get("sites", {})
+
+        alt_site_pairs = self._get_alt_site_pairs(conf_sites)
+
+        already_attached_keys = list(already_attached_sites.keys())
+        for added_site in already_attached_keys:
+            real_created = already_attached_sites[added_site]
+            for alt_site in alt_site_pairs.get(added_site, []):
+                if alt_site in already_attached_sites.keys():
+                    continue
+                meta = {"name": alt_site}
+                # alt site inherits state of 'created_dt'
+                if real_created:
+                    meta["created_dt"] = real_created
+                rec["sites"].append(meta)
+                already_attached_sites[meta["name"]] = real_created
+
+        return rec, already_attached_sites
+
+    def _get_alt_site_pairs(self, conf_sites):
+        """Returns dict of site and its alternative sites.
+
+        If `site` has alternative site, it means that alt_site has 'site' as
+        alternative site
+        Args:
+            conf_sites (dict)
+        Returns:
+            (dict): {'site': [alternative sites]...}
+        """
+        alt_site_pairs = defaultdict(list)
+        for site_name, site_info in conf_sites.items():
+            alt_sites = set(site_info.get("alternative_sites", []))
+            alt_site_pairs[site_name].extend(alt_sites)
+
+            for alt_site in alt_sites:
+                alt_site_pairs[alt_site].append(site_name)
+
+        for site_name, alt_sites in alt_site_pairs.items():
+            sites_queue = deque(alt_sites)
+            while sites_queue:
+                alt_site = sites_queue.popleft()
+
+                # safety against wrong config
+                # {"SFTP": {"alternative_site": "SFTP"}
+                if alt_site == site_name or alt_site not in alt_site_pairs:
+                    continue
+
+                for alt_alt_site in alt_site_pairs[alt_site]:
+                    if (
+                            alt_alt_site != site_name
+                            and alt_alt_site not in alt_sites
+                    ):
+                        alt_sites.append(alt_alt_site)
+                        sites_queue.append(alt_alt_site)
+
+        return alt_site_pairs
+
+    def handle_destination_files(self, integrated_file_sizes, mode):
+        """ Clean destination files
+            Called when error happened during integrating to DB or to disk
+            OR called to rename uploaded files from temporary name to final to
+            highlight publishing in progress/broken
+            Used to clean unwanted files
+
+        Arguments:
+            integrated_file_sizes: dictionary, file urls as keys, size as value
+            mode: 'remove' - clean files,
+                  'finalize' - rename files,
+                               remove TMP_FILE_EXT suffix denoting temp file
+        """
+        if integrated_file_sizes:
+            for file_url, _file_size in integrated_file_sizes.items():
+                if not os.path.exists(file_url):
+                    self.log.debug(
+                        "File {} was not found.".format(file_url)
+                    )
+                    continue
+
+                try:
+                    if mode == 'remove':
+                        self.log.debug("Removing file {}".format(file_url))
+                        os.remove(file_url)
+                    if mode == 'finalize':
+                        new_name = re.sub(
+                            r'\.{}$'.format(self.TMP_FILE_EXT),
+                            '',
+                            file_url
+                        )
+
+                        if os.path.exists(new_name):
+                            self.log.debug(
+                                "Overwriting file {} to {}".format(
+                                    file_url, new_name
+                                )
+                            )
+                            shutil.copy(file_url, new_name)
+                            os.remove(file_url)
+                        else:
+                            self.log.debug(
+                                "Renaming file {} to {}".format(
+                                    file_url, new_name
+                                )
+                            )
+                            os.rename(file_url, new_name)
+                except OSError:
+                    self.log.error("Cannot {} file {}".format(mode, file_url),
+                                   exc_info=True)
+                    six.reraise(*sys.exc_info())

From 271a829f6d441bcf26e6ddaf33510f984dc0c703 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Jul 2022 09:24:38 +0200
Subject: [PATCH 0989/1227] Remove duplicate source family

---
 openpype/plugins/publish/integrate_new.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index 4c14c17dae..fd3cf8882d 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -92,7 +92,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
                 "source",
                 "matchmove",
                 "image",
-                "source",
                 "assembly",
                 "fbx",
                 "textures",

From 148ac26bf961aa8e44ffcd453efbdbb0f4a8df75 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Jul 2022 09:28:00 +0200
Subject: [PATCH 0990/1227] Update USD families with latest develop

---
 openpype/plugins/publish/integrate.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 6ad0849ff7..6253a3ec11 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -156,8 +156,10 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
                 "usd",
                 "staticMesh",
                 "skeletalMesh",
-                "usdComposition",
-                "usdOverride",
+                "mvLook",
+                "mvUsd",
+                "mvUsdComposition",
+                "mvUsdOverride",
                 "simpleUnrealTexture"
                 ]
     exclude_families = ["clip", "render.farm"]

From 035c4d2f93fd0a29ba8f6f1789a327878861284a Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Jul 2022 09:30:07 +0200
Subject: [PATCH 0991/1227] Set up old vs. new integrator per host

---
 openpype/plugins/publish/integrate.py     | 1 +
 openpype/plugins/publish/integrate_new.py | 4 ++++
 2 files changed, 5 insertions(+)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 6253a3ec11..d098147603 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -110,6 +110,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
 
     label = "Integrate Asset New"
     order = pyblish.api.IntegratorOrder
+    hosts = ["maya"]
     families = ["workfile",
                 "pointcache",
                 "camera",
diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index fd3cf8882d..c9848abc14 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -62,6 +62,10 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
 
     label = "Integrate Asset New"
     order = pyblish.api.IntegratorOrder
+    hosts = ["aftereffects", "blender", "celaction", "flame", "harmony",
+             "hiero", "houdini", "nuke", "photoshop", "resolve",
+             "standalonepublisher", "traypublisher", "tvpaint", "unreal",
+             "webpublisher"]
     families = ["workfile",
                 "pointcache",
                 "camera",

From a3757636e7705b34699adff7e1e23f7ff57284d6 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Jul 2022 09:31:53 +0200
Subject: [PATCH 0992/1227] Remove 'intent' context data override

@iLLiCiTiT says: Intent should be a dictionary with "value" and "label", to be able tell if you want use value or label of the intent in templates.
---
 openpype/plugins/publish/collect_anatomy_context_data.py | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/openpype/plugins/publish/collect_anatomy_context_data.py b/openpype/plugins/publish/collect_anatomy_context_data.py
index 8db9d0d3d7..0794adfb67 100644
--- a/openpype/plugins/publish/collect_anatomy_context_data.py
+++ b/openpype/plugins/publish/collect_anatomy_context_data.py
@@ -92,13 +92,5 @@ class CollectAnatomyContextData(pyblish.api.ContextPlugin):
                 }
             })
 
-        # todo: some code actually expects the dict itself and others doesn't
-        #       question: what should it be?
-        intent = context.data.get("intent")
-        if intent and isinstance(intent, dict):
-            intent = intent.get("value")
-        if intent:
-            context_data["intent"] = intent
-
         self.log.info("Global anatomy Data collected")
         self.log.debug(json.dumps(context_data, indent=4))

From deaeed3f0b5b7eb602efa0b23a4e34ec1774571a Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 5 Jul 2022 10:35:42 +0200
Subject: [PATCH 0993/1227] nuke: make it clean nodes again

---
 openpype/hosts/nuke/plugins/publish/extract_slate_frame.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
index 6997180c9f..99ade4cf9b 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_slate_frame.py
@@ -230,8 +230,8 @@ class ExtractSlateFrame(openpype.api.Extractor):
             write_node.name(), int(slate_first_frame), int(slate_first_frame))
 
         # Clean up
-        # for node in temporary_nodes:
-        #     nuke.delete(node)
+        for node in temporary_nodes:
+            nuke.delete(node)
 
     def _render_slate_to_sequence(self, instance):
         # set slate frame

From b4697b6e1a0cc778765d617b68d1e516ca7dcea9 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Jul 2022 10:36:37 +0200
Subject: [PATCH 0994/1227] Refactor integrator labels

---
 openpype/plugins/publish/integrate.py     | 2 +-
 openpype/plugins/publish/integrate_new.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index d098147603..5e86eb014a 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -108,7 +108,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
             "data": additional metadata for each representation.
     """
 
-    label = "Integrate Asset New"
+    label = "Integrate Asset"
     order = pyblish.api.IntegratorOrder
     hosts = ["maya"]
     families = ["workfile",
diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_new.py
index c9848abc14..baa14b285c 100644
--- a/openpype/plugins/publish/integrate_new.py
+++ b/openpype/plugins/publish/integrate_new.py
@@ -60,7 +60,7 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
         "data": additional metadata for each representation.
     """
 
-    label = "Integrate Asset New"
+    label = "Integrate Asset (legacy)"
     order = pyblish.api.IntegratorOrder
     hosts = ["aftereffects", "blender", "celaction", "flame", "harmony",
              "hiero", "houdini", "nuke", "photoshop", "resolve",

From b96cb503dafcbfed7adf144d863096adf2fd1e39 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 5 Jul 2022 11:35:07 +0200
Subject: [PATCH 0995/1227] flame: fix loading with missing template part

---
 openpype/hosts/flame/plugins/load/load_clip.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/flame/plugins/load/load_clip.py b/openpype/hosts/flame/plugins/load/load_clip.py
index e0a7297381..0b049214ff 100644
--- a/openpype/hosts/flame/plugins/load/load_clip.py
+++ b/openpype/hosts/flame/plugins/load/load_clip.py
@@ -2,7 +2,7 @@ import os
 import flame
 from pprint import pformat
 import openpype.hosts.flame.api as opfapi
-
+from openpype.lib import StringTemplate
 
 class LoadClip(opfapi.ClipLoader):
     """Load a subset to timeline as clip
@@ -22,7 +22,7 @@ class LoadClip(opfapi.ClipLoader):
     # settings
     reel_group_name = "OpenPype_Reels"
     reel_name = "Loaded"
-    clip_name_template = "{asset}_{subset}_{output}"
+    clip_name_template = "{asset}_{subset}<_{output}>"
 
     def load(self, context, name, namespace, options):
 
@@ -36,7 +36,7 @@ class LoadClip(opfapi.ClipLoader):
         version_data = version.get("data", {})
         version_name = version.get("name", None)
         colorspace = version_data.get("colorspace", None)
-        clip_name = self.clip_name_template.format(
+        clip_name = StringTemplate(self.clip_name_template).format(
             **context["representation"]["context"])
 
         # TODO: settings in imageio

From 110ed4d752cdf5a10086b8029dfae118d4ffca2b Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 5 Jul 2022 11:40:31 +0200
Subject: [PATCH 0996/1227] flame: fixing loading name template

---
 openpype/hosts/flame/plugins/load/load_clip.py         | 2 +-
 openpype/hosts/flame/plugins/load/load_clip_batch.py   | 7 ++++---
 openpype/settings/defaults/project_settings/flame.json | 4 ++--
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/flame/plugins/load/load_clip.py b/openpype/hosts/flame/plugins/load/load_clip.py
index 0b049214ff..b12f2f9690 100644
--- a/openpype/hosts/flame/plugins/load/load_clip.py
+++ b/openpype/hosts/flame/plugins/load/load_clip.py
@@ -37,7 +37,7 @@ class LoadClip(opfapi.ClipLoader):
         version_name = version.get("name", None)
         colorspace = version_data.get("colorspace", None)
         clip_name = StringTemplate(self.clip_name_template).format(
-            **context["representation"]["context"])
+            context["representation"]["context"])
 
         # TODO: settings in imageio
         # convert colorspace with ocio to flame mapping
diff --git a/openpype/hosts/flame/plugins/load/load_clip_batch.py b/openpype/hosts/flame/plugins/load/load_clip_batch.py
index 5de3226035..fb4a3dc6e9 100644
--- a/openpype/hosts/flame/plugins/load/load_clip_batch.py
+++ b/openpype/hosts/flame/plugins/load/load_clip_batch.py
@@ -2,6 +2,7 @@ import os
 import flame
 from pprint import pformat
 import openpype.hosts.flame.api as opfapi
+from openpype.lib import StringTemplate
 
 
 class LoadClipBatch(opfapi.ClipLoader):
@@ -21,7 +22,7 @@ class LoadClipBatch(opfapi.ClipLoader):
 
     # settings
     reel_name = "OP_LoadedReel"
-    clip_name_template = "{asset}_{subset}_{output}"
+    clip_name_template = "{asset}_{subset}<_{output}>"
 
     def load(self, context, name, namespace, options):
 
@@ -39,8 +40,8 @@ class LoadClipBatch(opfapi.ClipLoader):
         if not context["representation"]["context"].get("output"):
             self.clip_name_template.replace("output", "representation")
 
-        clip_name = self.clip_name_template.format(
-            **context["representation"]["context"])
+        clip_name = StringTemplate(self.clip_name_template).format(
+            context["representation"]["context"])
 
         # TODO: settings in imageio
         # convert colorspace with ocio to flame mapping
diff --git a/openpype/settings/defaults/project_settings/flame.json b/openpype/settings/defaults/project_settings/flame.json
index a7836b9c1f..bfdc58d9ee 100644
--- a/openpype/settings/defaults/project_settings/flame.json
+++ b/openpype/settings/defaults/project_settings/flame.json
@@ -98,7 +98,7 @@
             ],
             "reel_group_name": "OpenPype_Reels",
             "reel_name": "Loaded",
-            "clip_name_template": "{asset}_{subset}_{output}"
+            "clip_name_template": "{asset}_{subset}<_{output}>"
         },
         "LoadClipBatch": {
             "enabled": true,
@@ -121,7 +121,7 @@
                 "exr16fpdwaa"
             ],
             "reel_name": "OP_LoadedReel",
-            "clip_name_template": "{asset}_{subset}_{output}"
+            "clip_name_template": "{asset}_{subset}<_{output}>"
         }
     }
 }
\ No newline at end of file

From 6e3fd1122bc9614d124b8bc49edac70c121bb39c Mon Sep 17 00:00:00 2001
From: Kaa Maurice <kaalium@gmail.com>
Date: Tue, 5 Jul 2022 17:13:11 +0200
Subject: [PATCH 0997/1227] Kitsu bugfix update assets attributes

---
 .../plugins/publish/collect_kitsu_entities.py | 18 ++++---
 openpype/modules/kitsu/utils/sync_service.py  | 32 +++++++-----
 .../modules/kitsu/utils/update_op_with_zou.py | 52 ++++++++++++-------
 3 files changed, 65 insertions(+), 37 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
index 84c400bde9..d28ded06c7 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
@@ -32,11 +32,17 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
         context.data["kitsu_project"] = kitsu_project
         self.log.debug("Collect kitsu project: {}".format(kitsu_project))
 
-        kitsu_asset = gazu.asset.get_asset(zou_asset_data["id"])
-        if not kitsu_asset:
-            raise AssertionError("Asset not found in kitsu!")
-        context.data["kitsu_asset"] = kitsu_asset
-        self.log.debug("Collect kitsu asset: {}".format(kitsu_asset))
+        entity_type = zou_asset_data["type"]
+        if entity_type == "Shot":
+            kitsu_entity = gazu.shot.get_shot(zou_asset_data["id"])
+        else:
+            kitsu_entity = gazu.asset.get_asset(zou_asset_data["id"])
+
+        if not kitsu_entity:
+            raise AssertionError(f"{entity_type} not found in kitsu!")
+
+        context.data["kitsu_entity"] = kitsu_entity
+        self.log.debug(f"Collect kitsu {entity_type}: {kitsu_entity}")
 
         if zou_task_data:
             kitsu_task = gazu.task.get_task(zou_task_data["id"])
@@ -57,7 +63,7 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
                 )
 
             kitsu_task = gazu.task.get_task_by_name(
-                kitsu_asset, kitsu_task_type
+                kitsu_entity, kitsu_task_type
             )
             if not kitsu_task:
                 raise AssertionError("Task not found in kitsu!")
diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 6c003942f8..577050c5af 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -165,10 +165,12 @@ class Listener:
         zou_ids_and_asset_docs[asset["project_id"]] = project_doc
 
         # Update
-        asset_doc_id, asset_update = update_op_assets(
+        update_op_result = update_op_assets(
             self.dbcon, project_doc, [asset], zou_ids_and_asset_docs
-        )[0]
-        self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
+        )
+        if update_op_result:
+            asset_doc_id, asset_update = update_op_result[0]
+            self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
     def _delete_asset(self, data):
         """Delete asset of OP DB."""
@@ -212,10 +214,12 @@ class Listener:
         zou_ids_and_asset_docs[episode["project_id"]] = project_doc
 
         # Update
-        asset_doc_id, asset_update = update_op_assets(
+        update_op_result = update_op_assets(
             self.dbcon, project_doc, [episode], zou_ids_and_asset_docs
-        )[0]
-        self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
+        )
+        if update_op_result:
+            asset_doc_id, asset_update = update_op_result[0]
+            self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
     def _delete_episode(self, data):
         """Delete shot of OP DB."""
@@ -260,10 +264,12 @@ class Listener:
         zou_ids_and_asset_docs[sequence["project_id"]] = project_doc
 
         # Update
-        asset_doc_id, asset_update = update_op_assets(
+        update_op_result = update_op_assets(
             self.dbcon, project_doc, [sequence], zou_ids_and_asset_docs
-        )[0]
-        self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
+        )
+        if update_op_result:
+            asset_doc_id, asset_update = update_op_result[0]
+            self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
     def _delete_sequence(self, data):
         """Delete sequence of OP DB."""
@@ -308,10 +314,12 @@ class Listener:
         zou_ids_and_asset_docs[shot["project_id"]] = project_doc
 
         # Update
-        asset_doc_id, asset_update = update_op_assets(
+        update_op_result = update_op_assets(
             self.dbcon, project_doc, [shot], zou_ids_and_asset_docs
-        )[0]
-        self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
+        )
+        if update_op_result:
+            asset_doc_id, asset_update = update_op_result[0]
+            self.dbcon.update_one({"_id": asset_doc_id}, asset_update)
 
     def _delete_shot(self, data):
         """Delete shot of OP DB."""
diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index cd98c0d204..f8ee6688d2 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -82,22 +82,37 @@ def update_op_assets(
         item_data["zou"] = item
 
         # == Asset settings ==
-        # Frame in, fallback on 0
-        frame_in = int(item_data.get("frame_in") or 0)
+        # Frame in, fallback to project's value or default value (1001)
+        # TODO: get default from settings/project_anatomy/attributes.json
+        try:
+            frame_in = int(
+                item_data.pop(
+                    "frame_in", project_doc["data"].get("frameStart")
+                )
+            )
+        except (TypeError, ValueError):
+            frame_in = 1001
         item_data["frameStart"] = frame_in
-        item_data.pop("frame_in", None)
-        # Frame out, fallback on frame_in + duration
-        frames_duration = int(item.get("nb_frames") or 1)
-        frame_out = (
-            item_data["frame_out"]
-            if item_data.get("frame_out")
-            else frame_in + frames_duration
-        )
-        item_data["frameEnd"] = int(frame_out)
-        item_data.pop("frame_out", None)
-        # Fps, fallback to project's value when entity fps is deleted
-        if not item_data.get("fps") and item_doc["data"].get("fps"):
-            item_data["fps"] = project_doc["data"]["fps"]
+        # Frames duration, fallback on 0
+        try:
+            frames_duration = int(item_data.pop("nb_frames", 0))
+        except (TypeError, ValueError):
+            frames_duration = 0
+        # Frame out, fallback on frame_in + duration or project's value or 1001
+        frame_out = item_data.pop("frame_out", None)
+        if not frame_out:
+            frame_out = frame_in + frames_duration
+        try:
+            frame_out = int(frame_out)
+        except (TypeError, ValueError):
+            frame_out = 1001
+        item_data["frameEnd"] = frame_out
+        # Fps, fallback to project's value or default value (25.0)
+        try:
+            fps = float(item_data.get("fps", project_doc["data"].get("fps")))
+        except (TypeError, ValueError):
+            fps = 25.0
+        item_data["fps"] = fps
 
         # Tasks
         tasks_list = []
@@ -106,7 +121,6 @@ def update_op_assets(
             tasks_list = all_tasks_for_asset(item)
         elif item_type == "Shot":
             tasks_list = all_tasks_for_shot(item)
-            # TODO frame in and out
         item_data["tasks"] = {
             t["task_type_name"]: {"type": t["task_type_name"]}
             for t in tasks_list
@@ -229,9 +243,9 @@ def write_project_to_op(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
     project_data.update(
         {
             "code": project_code,
-            "fps": project["fps"],
-            "resolutionWidth": project["resolution"].split("x")[0],
-            "resolutionHeight": project["resolution"].split("x")[1],
+            "fps": float(project["fps"]),
+            "resolutionWidth": int(project["resolution"].split("x")[0]),
+            "resolutionHeight": int(project["resolution"].split("x")[1]),
             "zou_id": project["id"],
         }
     )

From 603d193bc823f3fb7c1fc848125844841c65c366 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Wed, 6 Jul 2022 04:04:01 +0000
Subject: [PATCH 0998/1227] [Automated] Bump version

---
 CHANGELOG.md        | 27 ++++++++++++---------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 14 insertions(+), 17 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9b5d40a52f..0b43d2fed1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## [3.12.1-nightly.2](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.1-nightly.3](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.0...HEAD)
 
@@ -14,8 +14,10 @@
 
 **🚀 Enhancements**
 
+- Windows installer: Clean old files and add version subfolder [\#3445](https://github.com/pypeclub/OpenPype/pull/3445)
 - Blender: Bugfix - Set fps properly on open [\#3426](https://github.com/pypeclub/OpenPype/pull/3426)
 - Blender: pre pyside install for all platforms [\#3400](https://github.com/pypeclub/OpenPype/pull/3400)
+- Maya: Ability to set resolution for playblasts from asset, and override through review instance. [\#3360](https://github.com/pypeclub/OpenPype/pull/3360)
 
 **🐛 Bug fixes**
 
@@ -23,13 +25,20 @@
 - Maya: fix hashing in Python 3 for tile rendering [\#3447](https://github.com/pypeclub/OpenPype/pull/3447)
 - LogViewer: Escape html characters in log message [\#3443](https://github.com/pypeclub/OpenPype/pull/3443)
 - Nuke: Slate frame is integrated [\#3427](https://github.com/pypeclub/OpenPype/pull/3427)
+- Maya: Camera extra data - additional fix for \#3304 [\#3386](https://github.com/pypeclub/OpenPype/pull/3386)
+- Harmony: added unc path to zifile command in Harmony [\#3372](https://github.com/pypeclub/OpenPype/pull/3372)
+- Maya: Handle excluding `model` family from frame range validator. [\#3370](https://github.com/pypeclub/OpenPype/pull/3370)
 
 **🔀 Refactored code**
 
+- Maya: Re-use `maintained\_time` from lib [\#3460](https://github.com/pypeclub/OpenPype/pull/3460)
 - Clockify: Use query functions in clockify actions [\#3458](https://github.com/pypeclub/OpenPype/pull/3458)
 - General: Use query functions in rest api calls [\#3457](https://github.com/pypeclub/OpenPype/pull/3457)
+- General: Use query functions in load utils [\#3446](https://github.com/pypeclub/OpenPype/pull/3446)
 - General: Use Anatomy after move to pipeline [\#3436](https://github.com/pypeclub/OpenPype/pull/3436)
 - General: Anatomy moved to pipeline [\#3435](https://github.com/pypeclub/OpenPype/pull/3435)
+- Resolve: Use client query functions [\#3379](https://github.com/pypeclub/OpenPype/pull/3379)
+- General: Host implementation defined with class [\#3337](https://github.com/pypeclub/OpenPype/pull/3337)
 
 ## [3.12.0](https://github.com/pypeclub/OpenPype/tree/3.12.0) (2022-06-28)
 
@@ -44,7 +53,6 @@
 
 - Webserver: Added CORS middleware [\#3422](https://github.com/pypeclub/OpenPype/pull/3422)
 - Attribute Defs UI: Files widget show what is allowed to drop in [\#3411](https://github.com/pypeclub/OpenPype/pull/3411)
-- General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
 - Hosts: More options for in-host callbacks [\#3357](https://github.com/pypeclub/OpenPype/pull/3357)
 - Multiverse: expose some settings to GUI [\#3350](https://github.com/pypeclub/OpenPype/pull/3350)
 
@@ -60,7 +68,6 @@
 - TVPaint: Make sure exit code is set to not None [\#3382](https://github.com/pypeclub/OpenPype/pull/3382)
 - Maya: vray device aspect ratio fix [\#3381](https://github.com/pypeclub/OpenPype/pull/3381)
 - Flame: bunch of publishing issues [\#3377](https://github.com/pypeclub/OpenPype/pull/3377)
-- Harmony: added unc path to zifile command in Harmony [\#3372](https://github.com/pypeclub/OpenPype/pull/3372)
 - Standalone: settings improvements [\#3355](https://github.com/pypeclub/OpenPype/pull/3355)
 - Nuke: Load full model hierarchy by default [\#3328](https://github.com/pypeclub/OpenPype/pull/3328)
 
@@ -70,9 +77,9 @@
 - General: Move editorial lib to pipeline [\#3419](https://github.com/pypeclub/OpenPype/pull/3419)
 - Kitsu: renaming to plural func sync\_all\_projects [\#3397](https://github.com/pypeclub/OpenPype/pull/3397)
 - Houdini: Use client query functions [\#3395](https://github.com/pypeclub/OpenPype/pull/3395)
-- Hiero: Use client query functions [\#3393](https://github.com/pypeclub/OpenPype/pull/3393)
 - Nuke: Use client query functions [\#3391](https://github.com/pypeclub/OpenPype/pull/3391)
 - Maya: Use client query functions [\#3385](https://github.com/pypeclub/OpenPype/pull/3385)
+- Fusion: Use client query functions [\#3380](https://github.com/pypeclub/OpenPype/pull/3380)
 - Harmony: Use client query functions [\#3378](https://github.com/pypeclub/OpenPype/pull/3378)
 - Celaction: Use client query functions [\#3376](https://github.com/pypeclub/OpenPype/pull/3376)
 - Photoshop: Use client query functions [\#3375](https://github.com/pypeclub/OpenPype/pull/3375)
@@ -98,9 +105,9 @@
 **🚀 Enhancements**
 
 - Pyblish Pype: Hiding/Close issues [\#3367](https://github.com/pypeclub/OpenPype/pull/3367)
+- General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
 - Ftrack: Removed requirement of pypeclub role from default settings [\#3354](https://github.com/pypeclub/OpenPype/pull/3354)
 - Kitsu: Prevent crash on missing frames information [\#3352](https://github.com/pypeclub/OpenPype/pull/3352)
-- Ftrack: Open browser from tray [\#3320](https://github.com/pypeclub/OpenPype/pull/3320)
 
 **🐛 Bug fixes**
 
@@ -126,26 +133,16 @@
 **🚀 Enhancements**
 
 - Settings: Settings can be extracted from UI [\#3323](https://github.com/pypeclub/OpenPype/pull/3323)
-- updated poetry installation source [\#3316](https://github.com/pypeclub/OpenPype/pull/3316)
-- Ftrack: Action to easily create daily review session [\#3310](https://github.com/pypeclub/OpenPype/pull/3310)
-- TVPaint: Extractor use mark in/out range to render [\#3309](https://github.com/pypeclub/OpenPype/pull/3309)
-- Ftrack: Delivery action can work on ReviewSessions [\#3307](https://github.com/pypeclub/OpenPype/pull/3307)
 
 **🐛 Bug fixes**
 
 - General: Handle empty source key on instance [\#3342](https://github.com/pypeclub/OpenPype/pull/3342)
 - Houdini: Fix Houdini VDB manage update wrong file attribute name [\#3322](https://github.com/pypeclub/OpenPype/pull/3322)
-- Nuke: anatomy compatibility issue hacks [\#3321](https://github.com/pypeclub/OpenPype/pull/3321)
-- hiero: otio p3 compatibility issue - metadata on effect use update 3.11 [\#3314](https://github.com/pypeclub/OpenPype/pull/3314)
 
 **🔀 Refactored code**
 
 - Blender: Use client query functions [\#3331](https://github.com/pypeclub/OpenPype/pull/3331)
 
-**Merged pull requests:**
-
-- Maya: add pointcache family to gpu cache loader [\#3318](https://github.com/pypeclub/OpenPype/pull/3318)
-
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.10.0-nightly.6...3.10.0)
diff --git a/openpype/version.py b/openpype/version.py
index 92cdcf9fdd..3cb7f4572b 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.1-nightly.2"
+__version__ = "3.12.1-nightly.3"
diff --git a/pyproject.toml b/pyproject.toml
index 401b24243b..4803249923 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.1-nightly.2" # OpenPype
+version = "3.12.1-nightly.3" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 4ddebd51790b994048667edbbf150b557823a360 Mon Sep 17 00:00:00 2001
From: Kaa Maurice <kaalium@gmail.com>
Date: Wed, 6 Jul 2022 14:49:08 +0200
Subject: [PATCH 0999/1227] Kitsu update tasks with zou key

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index f8ee6688d2..de74b0c677 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -122,7 +122,7 @@ def update_op_assets(
         elif item_type == "Shot":
             tasks_list = all_tasks_for_shot(item)
         item_data["tasks"] = {
-            t["task_type_name"]: {"type": t["task_type_name"]}
+            t["task_type_name"]: {"type": t["task_type_name"], "zou": t}
             for t in tasks_list
         }
 

From f76d84dff177c31f46d369f0ccd97d0a253251a7 Mon Sep 17 00:00:00 2001
From: Allan Ihsan <allan.ihsan@gmail.com>
Date: Wed, 6 Jul 2022 22:57:02 +0300
Subject: [PATCH 1000/1227] Append "Depth of Field" to plablast options and
 function.

---
 openpype/hosts/maya/api/lib.py                               | 4 ++++
 openpype/settings/defaults/project_settings/maya.json        | 1 +
 .../schemas/projects_schema/schemas/schema_maya_capture.json | 5 +++++
 openpype/vendor/python/common/capture.py                     | 3 ++-
 4 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index cd41ba3ffd..a159554b54 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2522,6 +2522,9 @@ def load_capture_preset(data=None):
                 temp_options2['multiSampleEnable'] = False
                 temp_options2['multiSampleCount'] = preset[id][key]
 
+        if key == 'renderDepthOfField':
+            temp_options2['renderDepthOfField'] = preset[id][key]
+
         if key == 'ssaoEnable':
             if preset[id][key] is True:
                 temp_options2['ssaoEnable'] = True
@@ -2618,6 +2621,7 @@ def load_capture_preset(data=None):
                 'motionBlurSampleCount',
                 'motionBlurShutterOpenFraction',
                 'lineAAEnable',
+                'renderDepthOfField'
                 ]:
         temp_options.pop(key, None)
 
diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index bb7719dc30..39a8688267 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -496,6 +496,7 @@
                     "override_viewport_options": true,
                     "displayLights": "default",
                     "textureMaxResolution": 1024,
+                    "renderDepthOfField": true,
                     "shadows": true,
                     "textures": true,
                     "twoSidedLighting": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index 0a63315622..7a40f349cc 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -204,6 +204,11 @@
                         {
                             "type": "splitter"
                         },
+                        {
+                            "type":"boolean",
+                            "key": "renderDepthOfField",
+                            "label": "Depth of Field"
+                        },
                         {
                             "type": "splitter"
                         },
diff --git a/openpype/vendor/python/common/capture.py b/openpype/vendor/python/common/capture.py
index 6b4c40a6e8..4d9e1da3e4 100644
--- a/openpype/vendor/python/common/capture.py
+++ b/openpype/vendor/python/common/capture.py
@@ -380,7 +380,8 @@ Viewport2Options = {
     "transparencyAlgorithm": 1,
     "transparencyQuality": 0.33,
     "useMaximumHardwareLights": True,
-    "vertexAnimationCache": 0
+    "vertexAnimationCache": 0,
+    "renderDepthOfField": 0
 }
 
 

From d9d8f7c315b6592d305cd8b4d045a0def6f49644 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 7 Jul 2022 15:37:21 +0200
Subject: [PATCH 1001/1227] fix add missing project name in args

---
 openpype/pipeline/load/utils.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/openpype/pipeline/load/utils.py b/openpype/pipeline/load/utils.py
index 2c1b2ea8ea..2c213aff6f 100644
--- a/openpype/pipeline/load/utils.py
+++ b/openpype/pipeline/load/utils.py
@@ -208,10 +208,12 @@ def get_representation_context(representation):
 
     assert representation is not None, "This is a bug"
 
-    if not isinstance(representation, dict):
-        representation = get_representation_by_id(representation)
-
     project_name = legacy_io.active_project()
+    if not isinstance(representation, dict):
+        representation = get_representation_by_id(
+            project_name, representation
+        )
+
     version, subset, asset, project = get_representation_parents(
         project_name, representation
     )

From 5ad1f8ba7e110a8679df6581069c3a00035130df Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 7 Jul 2022 15:45:57 +0200
Subject: [PATCH 1002/1227] thumbnails

---
 .../{extract_jpeg_exr.py => extract_thumbnail.py}  | 14 ++++----------
 1 file changed, 4 insertions(+), 10 deletions(-)
 rename openpype/plugins/publish/{extract_jpeg_exr.py => extract_thumbnail.py} (92%)

diff --git a/openpype/plugins/publish/extract_jpeg_exr.py b/openpype/plugins/publish/extract_thumbnail.py
similarity index 92%
rename from openpype/plugins/publish/extract_jpeg_exr.py
rename to openpype/plugins/publish/extract_thumbnail.py
index 42c4cbe062..7a438ca701 100644
--- a/openpype/plugins/publish/extract_jpeg_exr.py
+++ b/openpype/plugins/publish/extract_thumbnail.py
@@ -71,18 +71,12 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             if not is_oiio_supported():
                 thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path) # noqa
             else:
-                # Check if the file can be read by OIIO
-                oiio_tool_path = get_oiio_tools_path()
-                args = [
-                    oiio_tool_path, "--info", "-i", full_output_path
-                ]
-                returncode = execute(args, silent=True)
                 # If the input can read by OIIO then use OIIO method for
                 # conversion otherwise use ffmpeg
-                if returncode == 0:
-                    self.log.info("Input can be read by OIIO, converting with oiiotool now.")   # noqa
-                    thumbnail_created = self.create_thumbnail_oiio(full_input_path, full_output_path) # noqa
-                else:
+                self.log.info("Trying to convert with OIIO")   # noqa
+                thumbnail_created = self.create_thumbnail_oiio(full_input_path, full_output_path) # noqa
+
+                if not thumbnail_created:
                     self.log.info("Converting with FFMPEG because input can't be read by OIIO.")    # noqa
                     thumbnail_created = self.create_thumbnail_ffmpeg(full_input_path, full_output_path) # noqa
 

From 0665e5b75963036189fa8dfdae8f91af7e32c174 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 11:14:07 +0200
Subject: [PATCH 1003/1227] pass create context after settings

---
 openpype/pipeline/create/context.py         | 2 +-
 openpype/pipeline/create/creator_plugins.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index 12cd9bbc68..9f387ec676 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -873,9 +873,9 @@ class CreateContext:
                 continue
 
             creator = creator_class(
-                self,
                 system_settings,
                 project_settings,
+                self,
                 self.headless
             )
             creators[creator_identifier] = creator
diff --git a/openpype/pipeline/create/creator_plugins.py b/openpype/pipeline/create/creator_plugins.py
index 8006d4f4f8..1d09116fb6 100644
--- a/openpype/pipeline/create/creator_plugins.py
+++ b/openpype/pipeline/create/creator_plugins.py
@@ -70,7 +70,7 @@ class BaseCreator:
     host_name = None
 
     def __init__(
-        self, create_context, system_settings, project_settings, headless=False
+        self, system_settings, project_settings, create_context, headless=False
     ):
         # Reference to CreateContext
         self.create_context = create_context

From 2e8e4f8f54fb026fffbff30e45532056e900f5a5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 11:30:49 +0200
Subject: [PATCH 1004/1227] pass project settings before system settings

---
 openpype/pipeline/create/context.py         | 2 +-
 openpype/pipeline/create/creator_plugins.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index 9f387ec676..260856286b 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -873,8 +873,8 @@ class CreateContext:
                 continue
 
             creator = creator_class(
-                system_settings,
                 project_settings,
+                system_settings,
                 self,
                 self.headless
             )
diff --git a/openpype/pipeline/create/creator_plugins.py b/openpype/pipeline/create/creator_plugins.py
index 1d09116fb6..41847ac322 100644
--- a/openpype/pipeline/create/creator_plugins.py
+++ b/openpype/pipeline/create/creator_plugins.py
@@ -70,7 +70,7 @@ class BaseCreator:
     host_name = None
 
     def __init__(
-        self, system_settings, project_settings, create_context, headless=False
+        self, project_settings, system_settings, create_context, headless=False
     ):
         # Reference to CreateContext
         self.create_context = create_context

From 56764f638fe9283d33a057d7ff22dfb1c055e992 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 11:34:08 +0200
Subject: [PATCH 1005/1227] modified after effects creator init to use new args
 order

---
 .../hosts/aftereffects/plugins/create/create_render.py     | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/aftereffects/plugins/create/create_render.py b/openpype/hosts/aftereffects/plugins/create/create_render.py
index 215c148f37..1019709dd6 100644
--- a/openpype/hosts/aftereffects/plugins/create/create_render.py
+++ b/openpype/hosts/aftereffects/plugins/create/create_render.py
@@ -17,11 +17,8 @@ class RenderCreator(Creator):
 
     create_allow_context_change = True
 
-    def __init__(
-        self, create_context, system_settings, project_settings, headless=False
-    ):
-        super(RenderCreator, self).__init__(create_context, system_settings,
-                                            project_settings, headless)
+    def __init__(self, project_settings, *args, **kwargs):
+        super(RenderCreator, self).__init__(project_settings, *args, **kwargs)
         self._default_variants = (project_settings["aftereffects"]
                                                   ["create"]
                                                   ["RenderCreator"]

From 4e81bd27a7759d2d4aa5aa4741dcf2881a8c1650 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 10:49:35 +0200
Subject: [PATCH 1006/1227] create plugins have access to project name

---
 openpype/pipeline/create/context.py         | 4 ++++
 openpype/pipeline/create/creator_plugins.py | 6 ++++++
 2 files changed, 10 insertions(+)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index 260856286b..9d870a2234 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -748,6 +748,10 @@ class CreateContext:
     def host_name(self):
         return os.environ["AVALON_APP"]
 
+    @property
+    def project_name(self):
+        return self.dbcon.active_project()
+
     @property
     def log(self):
         """Dynamic access to logger."""
diff --git a/openpype/pipeline/create/creator_plugins.py b/openpype/pipeline/create/creator_plugins.py
index 41847ac322..b888feb606 100644
--- a/openpype/pipeline/create/creator_plugins.py
+++ b/openpype/pipeline/create/creator_plugins.py
@@ -92,6 +92,12 @@ class BaseCreator:
         """Family that plugin represents."""
         pass
 
+    @property
+    def project_name(self):
+        """Family that plugin represents."""
+
+        self.create_context.project_name
+
     @property
     def log(self):
         if self._log is None:

From bde50a36297ec2c7bc31b3ba64757008d7070ac4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 11:15:09 +0200
Subject: [PATCH 1007/1227] use project_name attribute

---
 openpype/pipeline/create/context.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index 9d870a2234..7758a660d3 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -843,9 +843,8 @@ class CreateContext:
         self.plugins_with_defs = plugins_with_defs
 
         # Prepare settings
-        project_name = self.dbcon.Session["AVALON_PROJECT"]
         system_settings = get_system_settings()
-        project_settings = get_project_settings(project_name)
+        project_settings = get_project_settings(self.project_name)
 
         # Discover and prepare creators
         creators = {}

From 85485f26d8f7d3b387f67f26e31d9ff075ad817d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 17:15:38 +0200
Subject: [PATCH 1008/1227] fix return of value

---
 openpype/pipeline/create/creator_plugins.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/pipeline/create/creator_plugins.py b/openpype/pipeline/create/creator_plugins.py
index b888feb606..4c7b9f8d94 100644
--- a/openpype/pipeline/create/creator_plugins.py
+++ b/openpype/pipeline/create/creator_plugins.py
@@ -96,7 +96,7 @@ class BaseCreator:
     def project_name(self):
         """Family that plugin represents."""
 
-        self.create_context.project_name
+        return self.create_context.project_name
 
     @property
     def log(self):

From 68582819812675cd9461be89ceb9a56a7d7f2d1b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 17:33:52 +0200
Subject: [PATCH 1009/1227] better handling when context change is not enabled

---
 .../tools/publisher/widgets/create_dialog.py  | 23 +++++++++++++++----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index 3a68835dc7..b5e178b409 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -616,7 +616,7 @@ class CreateDialog(QtWidgets.QDialog):
             prereq_available = False
             creator_btn_tooltips.append("Creator is not selected")
 
-        if self._asset_doc is None:
+        if self._context_change_is_enabled() and self._asset_doc is None:
             # QUESTION how to handle invalid asset?
             prereq_available = False
             creator_btn_tooltips.append("Context is not selected")
@@ -1010,13 +1010,18 @@ class CreateDialog(QtWidgets.QDialog):
         if variant_value is None:
             variant_value = self.variant_input.text()
 
-        self.create_btn.setEnabled(True)
         if not self._compiled_name_pattern.match(variant_value):
             self.create_btn.setEnabled(False)
             self._set_variant_state_property("invalid")
             self.subset_name_input.setText("< Invalid variant >")
             return
 
+        if not self._context_change_is_enabled():
+            self.create_btn.setEnabled(True)
+            self._set_variant_state_property("")
+            self.subset_name_input.setText("< Valid variant >")
+            return
+
         project_name = self.controller.project_name
         task_name = self._get_task_name()
 
@@ -1034,6 +1039,7 @@ class CreateDialog(QtWidgets.QDialog):
 
         self.subset_name_input.setText(subset_name)
 
+        self.create_btn.setEnabled(True)
         self._validate_subset_name(subset_name, variant_value)
 
     def _validate_subset_name(self, subset_name, variant_value):
@@ -1145,10 +1151,17 @@ class CreateDialog(QtWidgets.QDialog):
         creator_label = index.data(QtCore.Qt.DisplayRole)
         creator_identifier = index.data(CREATOR_IDENTIFIER_ROLE)
         family = index.data(FAMILY_ROLE)
-        subset_name = self.subset_name_input.text()
         variant = self.variant_input.text()
-        asset_name = self._get_asset_name()
-        task_name = self._get_task_name()
+        # Care about subset name only if context change is enabled
+        if self._context_change_is_enabled():
+            subset_name = self.subset_name_input.text()
+            asset_name = self._get_asset_name()
+            task_name = self._get_task_name()
+        else:
+            subset_name = variant
+            asset_name = None
+            task_name = None
+
         pre_create_data = self._pre_create_widget.current_value()
         # Where to define these data?
         # - what data show be stored?

From 6bd6c3c17586786e1acb16b01ea5fc55ac6b235a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 17:35:22 +0200
Subject: [PATCH 1010/1227] subset name is None when context is not enabled

---
 openpype/tools/publisher/widgets/create_dialog.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index b5e178b409..ed2f65114b 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -1158,7 +1158,7 @@ class CreateDialog(QtWidgets.QDialog):
             asset_name = self._get_asset_name()
             task_name = self._get_task_name()
         else:
-            subset_name = variant
+            subset_name = None
             asset_name = None
             task_name = None
 

From 8849e5ac7f2f1707e206cbfc6d8dceca3a3d562c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 18:54:23 +0200
Subject: [PATCH 1011/1227] made clear prerequirements checks

---
 openpype/tools/publisher/widgets/create_dialog.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index ed2f65114b..d25b42d04d 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -465,7 +465,7 @@ class CreateDialog(QtWidgets.QDialog):
         desc_width_anim_timer = QtCore.QTimer()
         desc_width_anim_timer.setInterval(10)
 
-        prereq_timer.timeout.connect(self._on_prereq_timer)
+        prereq_timer.timeout.connect(self._invalidate_prereq)
 
         desc_width_anim_timer.timeout.connect(self._on_desc_animation)
 
@@ -600,16 +600,16 @@ class CreateDialog(QtWidgets.QDialog):
         self._tasks_widget.set_asset_name(asset_name)
         self._tasks_widget.select_task_name(task_name)
 
-        self._invalidate_prereq()
+        self._invalidate_prereq_deffered()
 
-    def _invalidate_prereq(self):
+    def _invalidate_prereq_deffered(self):
         self._prereq_timer.start()
 
     def _on_asset_filter_height_change(self, height):
         self._creators_header_widget.setMinimumHeight(height)
         self._creators_header_widget.setMaximumHeight(height)
 
-    def _on_prereq_timer(self):
+    def _invalidate_prereq(self):
         prereq_available = True
         creator_btn_tooltips = []
         if self.creators_model.rowCount() < 1:
@@ -726,11 +726,11 @@ class CreateDialog(QtWidgets.QDialog):
         asset_name = self._assets_widget.get_selected_asset_name()
         self._tasks_widget.set_asset_name(asset_name)
         if self._context_change_is_enabled():
-            self._invalidate_prereq()
+            self._invalidate_prereq_deffered()
 
     def _on_task_change(self):
         if self._context_change_is_enabled():
-            self._invalidate_prereq()
+            self._invalidate_prereq_deffered()
 
     def _on_current_session_context_request(self):
         self._assets_widget.set_current_session_asset()

From 9bec04254732d440f89c91f72da4f61e4cddcc76 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 18:55:00 +0200
Subject: [PATCH 1012/1227] added sorting for creators

---
 openpype/tools/publisher/widgets/create_dialog.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index d25b42d04d..4cc63f50a8 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -342,7 +342,9 @@ class CreateDialog(QtWidgets.QDialog):
 
         creators_view = QtWidgets.QListView(self)
         creators_model = QtGui.QStandardItemModel()
-        creators_view.setModel(creators_model)
+        creators_sort_model = QtCore.QSortFilterProxyModel()
+        creators_sort_model.setSourceModel(creators_model)
+        creators_view.setModel(creators_sort_model)
 
         variant_widget = VariantInputsWidget(self)
 
@@ -516,6 +518,7 @@ class CreateDialog(QtWidgets.QDialog):
         self.creators_model = creators_model
         self.creators_view = creators_view
         self.create_btn = create_btn
+        self._creators_sort_model = creators_sort_model
 
         self._creator_short_desc_widget = creator_short_desc_widget
         self._pre_create_widget = pre_create_widget
@@ -703,6 +706,7 @@ class CreateDialog(QtWidgets.QDialog):
         if self.creators_model.rowCount() < 1:
             return
 
+        self._creators_sort_model.sort(0)
         # Make sure there is a selection
         indexes = self.creators_view.selectedIndexes()
         if not indexes:

From 231446b012ef84f3492dcbd48ef20f85aa039445 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 18:56:23 +0200
Subject: [PATCH 1013/1227] disable creators view only if there are not
 creators

---
 openpype/tools/publisher/widgets/create_dialog.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index 4cc63f50a8..8e43887238 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -615,7 +615,12 @@ class CreateDialog(QtWidgets.QDialog):
     def _invalidate_prereq(self):
         prereq_available = True
         creator_btn_tooltips = []
-        if self.creators_model.rowCount() < 1:
+
+        available_creators = self.creators_model.rowCount() > 0
+        if available_creators != self.creators_view.isEnabled():
+            self.creators_view.setEnabled(available_creators)
+
+        if not available_creators:
             prereq_available = False
             creator_btn_tooltips.append("Creator is not selected")
 
@@ -628,7 +633,6 @@ class CreateDialog(QtWidgets.QDialog):
             self._prereq_available = prereq_available
 
             self.create_btn.setEnabled(prereq_available)
-            self.creators_view.setEnabled(prereq_available)
             self.variant_input.setEnabled(prereq_available)
             self.variant_hints_btn.setEnabled(prereq_available)
 

From 65b089f52ca0f96414f895b815ad22e98714f5a4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 18:57:06 +0200
Subject: [PATCH 1014/1227] trigger invalidation of prerequiremets if context
 widget changed enable state

---
 openpype/tools/publisher/widgets/create_dialog.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index 8e43887238..757ee58468 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -576,7 +576,10 @@ class CreateDialog(QtWidgets.QDialog):
     def _set_context_enabled(self, enabled):
         self._assets_widget.set_enabled(enabled)
         self._tasks_widget.set_enabled(enabled)
+        check_prereq = self._context_widget.isEnabled() != enabled
         self._context_widget.setEnabled(enabled)
+        if check_prereq:
+            self._invalidate_prereq()
 
     def refresh(self):
         # Get context before refresh to keep selection of asset and

From e833a0323d970a2b6baee5f91b584357f785c258 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 18:57:26 +0200
Subject: [PATCH 1015/1227] removed else statement

---
 openpype/tools/publisher/widgets/create_dialog.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index 757ee58468..68c4888ec3 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -1164,14 +1164,13 @@ class CreateDialog(QtWidgets.QDialog):
         family = index.data(FAMILY_ROLE)
         variant = self.variant_input.text()
         # Care about subset name only if context change is enabled
+        subset_name = None
+        asset_name = None
+        task_name = None
         if self._context_change_is_enabled():
             subset_name = self.subset_name_input.text()
             asset_name = self._get_asset_name()
             task_name = self._get_task_name()
-        else:
-            subset_name = None
-            asset_name = None
-            task_name = None
 
         pre_create_data = self._pre_create_widget.current_value()
         # Where to define these data?

From 50d8fc0761424e6053c3529edaa31966277d5527 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 18:58:17 +0200
Subject: [PATCH 1016/1227] use first index from sorting model instead of
 creators model

---
 openpype/tools/publisher/widgets/create_dialog.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index 68c4888ec3..d03b207727 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -717,7 +717,7 @@ class CreateDialog(QtWidgets.QDialog):
         # Make sure there is a selection
         indexes = self.creators_view.selectedIndexes()
         if not indexes:
-            index = self.creators_model.index(0, 0)
+            index = self._creators_sort_model.index(0, 0)
             self.creators_view.setCurrentIndex(index)
         else:
             index = indexes[0]

From bf6868826b88c4215c84a48323403a4d2736eb54 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 8 Jul 2022 18:58:38 +0200
Subject: [PATCH 1017/1227] converted some attributes to private

---
 .../tools/publisher/widgets/create_dialog.py  | 47 ++++++++++---------
 1 file changed, 24 insertions(+), 23 deletions(-)

diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index d03b207727..d4740b2493 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -515,10 +515,10 @@ class CreateDialog(QtWidgets.QDialog):
         self.variant_hints_group = variant_hints_group
 
         self._creators_header_widget = creators_header_widget
-        self.creators_model = creators_model
-        self.creators_view = creators_view
-        self.create_btn = create_btn
+        self._creators_model = creators_model
         self._creators_sort_model = creators_sort_model
+        self._creators_view = creators_view
+        self._create_btn = create_btn
 
         self._creator_short_desc_widget = creator_short_desc_widget
         self._pre_create_widget = pre_create_widget
@@ -619,9 +619,9 @@ class CreateDialog(QtWidgets.QDialog):
         prereq_available = True
         creator_btn_tooltips = []
 
-        available_creators = self.creators_model.rowCount() > 0
-        if available_creators != self.creators_view.isEnabled():
-            self.creators_view.setEnabled(available_creators)
+        available_creators = self._creators_model.rowCount() > 0
+        if available_creators != self._creators_view.isEnabled():
+            self._creators_view.setEnabled(available_creators)
 
         if not available_creators:
             prereq_available = False
@@ -635,14 +635,15 @@ class CreateDialog(QtWidgets.QDialog):
         if prereq_available != self._prereq_available:
             self._prereq_available = prereq_available
 
-            self.create_btn.setEnabled(prereq_available)
+            self._create_btn.setEnabled(prereq_available)
+
             self.variant_input.setEnabled(prereq_available)
             self.variant_hints_btn.setEnabled(prereq_available)
 
         tooltip = ""
         if creator_btn_tooltips:
             tooltip = "\n".join(creator_btn_tooltips)
-        self.create_btn.setToolTip(tooltip)
+        self._create_btn.setToolTip(tooltip)
 
         self._on_variant_change()
 
@@ -680,8 +681,8 @@ class CreateDialog(QtWidgets.QDialog):
         # Refresh creators and add their families to list
         existing_items = {}
         old_creators = set()
-        for row in range(self.creators_model.rowCount()):
-            item = self.creators_model.item(row, 0)
+        for row in range(self._creators_model.rowCount()):
+            item = self._creators_model.item(row, 0)
             identifier = item.data(CREATOR_IDENTIFIER_ROLE)
             existing_items[identifier] = item
             old_creators.add(identifier)
@@ -698,7 +699,7 @@ class CreateDialog(QtWidgets.QDialog):
                 item.setFlags(
                     QtCore.Qt.ItemIsEnabled | QtCore.Qt.ItemIsSelectable
                 )
-                self.creators_model.appendRow(item)
+                self._creators_model.appendRow(item)
 
             label = creator.label or identifier
             item.setData(label, QtCore.Qt.DisplayRole)
@@ -708,17 +709,17 @@ class CreateDialog(QtWidgets.QDialog):
         # Remove families that are no more available
         for identifier in (old_creators - new_creators):
             item = existing_items[identifier]
-            self.creators_model.takeRow(item.row())
+            self._creators_model.takeRow(item.row())
 
-        if self.creators_model.rowCount() < 1:
+        if self._creators_model.rowCount() < 1:
             return
 
         self._creators_sort_model.sort(0)
         # Make sure there is a selection
-        indexes = self.creators_view.selectedIndexes()
+        indexes = self._creators_view.selectedIndexes()
         if not indexes:
             index = self._creators_sort_model.index(0, 0)
-            self.creators_view.setCurrentIndex(index)
+            self._creators_view.setCurrentIndex(index)
         else:
             index = indexes[0]
 
@@ -1022,13 +1023,13 @@ class CreateDialog(QtWidgets.QDialog):
             variant_value = self.variant_input.text()
 
         if not self._compiled_name_pattern.match(variant_value):
-            self.create_btn.setEnabled(False)
+            self._create_btn.setEnabled(False)
             self._set_variant_state_property("invalid")
             self.subset_name_input.setText("< Invalid variant >")
             return
 
         if not self._context_change_is_enabled():
-            self.create_btn.setEnabled(True)
+            self._create_btn.setEnabled(True)
             self._set_variant_state_property("")
             self.subset_name_input.setText("< Valid variant >")
             return
@@ -1043,14 +1044,14 @@ class CreateDialog(QtWidgets.QDialog):
                 variant_value, task_name, asset_doc, project_name
             )
         except TaskNotSetError:
-            self.create_btn.setEnabled(False)
+            self._create_btn.setEnabled(False)
             self._set_variant_state_property("invalid")
             self.subset_name_input.setText("< Missing task >")
             return
 
         self.subset_name_input.setText(subset_name)
 
-        self.create_btn.setEnabled(True)
+        self._create_btn.setEnabled(True)
         self._validate_subset_name(subset_name, variant_value)
 
     def _validate_subset_name(self, subset_name, variant_value):
@@ -1105,8 +1106,8 @@ class CreateDialog(QtWidgets.QDialog):
         self._set_variant_state_property(property_value)
 
         variant_is_valid = variant_value.strip() != ""
-        if variant_is_valid != self.create_btn.isEnabled():
-            self.create_btn.setEnabled(variant_is_valid)
+        if variant_is_valid != self._create_btn.isEnabled():
+            self._create_btn.setEnabled(variant_is_valid)
 
     def _set_variant_state_property(self, state):
         current_value = self.variant_input.property("state")
@@ -1151,11 +1152,11 @@ class CreateDialog(QtWidgets.QDialog):
         self._update_help_btn()
 
     def _on_create(self):
-        indexes = self.creators_view.selectedIndexes()
+        indexes = self._creators_view.selectedIndexes()
         if not indexes or len(indexes) > 1:
             return
 
-        if not self.create_btn.isEnabled():
+        if not self._create_btn.isEnabled():
             return
 
         index = indexes[0]

From a62eeb807d64817920c38f2474d327d4113f9db2 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Sat, 9 Jul 2022 03:46:02 +0000
Subject: [PATCH 1018/1227] [Automated] Bump version

---
 CHANGELOG.md        | 41 ++++++++++++++++++-----------------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 20 insertions(+), 25 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0b43d2fed1..9a0c058f73 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## [3.12.1-nightly.3](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.1-nightly.4](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.0...HEAD)
 
@@ -14,31 +14,43 @@
 
 **🚀 Enhancements**
 
+- General: Creator Plugins have access to project [\#3476](https://github.com/pypeclub/OpenPype/pull/3476)
+- General: Better arguments order in creator init [\#3475](https://github.com/pypeclub/OpenPype/pull/3475)
+- Ftrack: Trigger custom ftrack events on project creation and preparation [\#3465](https://github.com/pypeclub/OpenPype/pull/3465)
 - Windows installer: Clean old files and add version subfolder [\#3445](https://github.com/pypeclub/OpenPype/pull/3445)
 - Blender: Bugfix - Set fps properly on open [\#3426](https://github.com/pypeclub/OpenPype/pull/3426)
+- Hiero: Add custom scripts menu [\#3425](https://github.com/pypeclub/OpenPype/pull/3425)
 - Blender: pre pyside install for all platforms [\#3400](https://github.com/pypeclub/OpenPype/pull/3400)
 - Maya: Ability to set resolution for playblasts from asset, and override through review instance. [\#3360](https://github.com/pypeclub/OpenPype/pull/3360)
 
 **🐛 Bug fixes**
 
+- General: thumbnail extractor fix [\#3474](https://github.com/pypeclub/OpenPype/pull/3474)
+- Kitsu: bugfix with sync-service ans publish plugins [\#3473](https://github.com/pypeclub/OpenPype/pull/3473)
+- Flame: solved problem with multi-selected loading [\#3470](https://github.com/pypeclub/OpenPype/pull/3470)
+- General: Fix query function in update logic [\#3468](https://github.com/pypeclub/OpenPype/pull/3468)
+- Resolve: removed few bugs [\#3464](https://github.com/pypeclub/OpenPype/pull/3464)
+- General: Delete old versions is safer when ftrack is disabled [\#3462](https://github.com/pypeclub/OpenPype/pull/3462)
+- Nuke: fixing metadata slate TC difference [\#3455](https://github.com/pypeclub/OpenPype/pull/3455)
 - Nuke: prerender reviewable fails [\#3450](https://github.com/pypeclub/OpenPype/pull/3450)
 - Maya: fix hashing in Python 3 for tile rendering [\#3447](https://github.com/pypeclub/OpenPype/pull/3447)
 - LogViewer: Escape html characters in log message [\#3443](https://github.com/pypeclub/OpenPype/pull/3443)
 - Nuke: Slate frame is integrated [\#3427](https://github.com/pypeclub/OpenPype/pull/3427)
 - Maya: Camera extra data - additional fix for \#3304 [\#3386](https://github.com/pypeclub/OpenPype/pull/3386)
-- Harmony: added unc path to zifile command in Harmony [\#3372](https://github.com/pypeclub/OpenPype/pull/3372)
 - Maya: Handle excluding `model` family from frame range validator. [\#3370](https://github.com/pypeclub/OpenPype/pull/3370)
 
 **🔀 Refactored code**
 
+- Maya: Merge animation + pointcache extractor logic [\#3461](https://github.com/pypeclub/OpenPype/pull/3461)
 - Maya: Re-use `maintained\_time` from lib [\#3460](https://github.com/pypeclub/OpenPype/pull/3460)
+- General: Use query functions in global plugins [\#3459](https://github.com/pypeclub/OpenPype/pull/3459)
 - Clockify: Use query functions in clockify actions [\#3458](https://github.com/pypeclub/OpenPype/pull/3458)
 - General: Use query functions in rest api calls [\#3457](https://github.com/pypeclub/OpenPype/pull/3457)
 - General: Use query functions in load utils [\#3446](https://github.com/pypeclub/OpenPype/pull/3446)
 - General: Use Anatomy after move to pipeline [\#3436](https://github.com/pypeclub/OpenPype/pull/3436)
 - General: Anatomy moved to pipeline [\#3435](https://github.com/pypeclub/OpenPype/pull/3435)
+- Fusion: Use client query functions [\#3380](https://github.com/pypeclub/OpenPype/pull/3380)
 - Resolve: Use client query functions [\#3379](https://github.com/pypeclub/OpenPype/pull/3379)
-- General: Host implementation defined with class [\#3337](https://github.com/pypeclub/OpenPype/pull/3337)
 
 ## [3.12.0](https://github.com/pypeclub/OpenPype/tree/3.12.0) (2022-06-28)
 
@@ -53,6 +65,7 @@
 
 - Webserver: Added CORS middleware [\#3422](https://github.com/pypeclub/OpenPype/pull/3422)
 - Attribute Defs UI: Files widget show what is allowed to drop in [\#3411](https://github.com/pypeclub/OpenPype/pull/3411)
+- General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
 - Hosts: More options for in-host callbacks [\#3357](https://github.com/pypeclub/OpenPype/pull/3357)
 - Multiverse: expose some settings to GUI [\#3350](https://github.com/pypeclub/OpenPype/pull/3350)
 
@@ -68,8 +81,8 @@
 - TVPaint: Make sure exit code is set to not None [\#3382](https://github.com/pypeclub/OpenPype/pull/3382)
 - Maya: vray device aspect ratio fix [\#3381](https://github.com/pypeclub/OpenPype/pull/3381)
 - Flame: bunch of publishing issues [\#3377](https://github.com/pypeclub/OpenPype/pull/3377)
+- Harmony: added unc path to zifile command in Harmony [\#3372](https://github.com/pypeclub/OpenPype/pull/3372)
 - Standalone: settings improvements [\#3355](https://github.com/pypeclub/OpenPype/pull/3355)
-- Nuke: Load full model hierarchy by default [\#3328](https://github.com/pypeclub/OpenPype/pull/3328)
 
 **🔀 Refactored code**
 
@@ -77,16 +90,13 @@
 - General: Move editorial lib to pipeline [\#3419](https://github.com/pypeclub/OpenPype/pull/3419)
 - Kitsu: renaming to plural func sync\_all\_projects [\#3397](https://github.com/pypeclub/OpenPype/pull/3397)
 - Houdini: Use client query functions [\#3395](https://github.com/pypeclub/OpenPype/pull/3395)
+- Hiero: Use client query functions [\#3393](https://github.com/pypeclub/OpenPype/pull/3393)
 - Nuke: Use client query functions [\#3391](https://github.com/pypeclub/OpenPype/pull/3391)
 - Maya: Use client query functions [\#3385](https://github.com/pypeclub/OpenPype/pull/3385)
-- Fusion: Use client query functions [\#3380](https://github.com/pypeclub/OpenPype/pull/3380)
 - Harmony: Use client query functions [\#3378](https://github.com/pypeclub/OpenPype/pull/3378)
 - Celaction: Use client query functions [\#3376](https://github.com/pypeclub/OpenPype/pull/3376)
 - Photoshop: Use client query functions [\#3375](https://github.com/pypeclub/OpenPype/pull/3375)
 - AfterEffects: Use client query functions [\#3374](https://github.com/pypeclub/OpenPype/pull/3374)
-- TVPaint: Use client query functions [\#3340](https://github.com/pypeclub/OpenPype/pull/3340)
-- Ftrack: Use client query functions [\#3339](https://github.com/pypeclub/OpenPype/pull/3339)
-- Standalone Publisher: Use client query functions [\#3330](https://github.com/pypeclub/OpenPype/pull/3330)
 
 **Merged pull requests:**
 
@@ -105,7 +115,6 @@
 **🚀 Enhancements**
 
 - Pyblish Pype: Hiding/Close issues [\#3367](https://github.com/pypeclub/OpenPype/pull/3367)
-- General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
 - Ftrack: Removed requirement of pypeclub role from default settings [\#3354](https://github.com/pypeclub/OpenPype/pull/3354)
 - Kitsu: Prevent crash on missing frames information [\#3352](https://github.com/pypeclub/OpenPype/pull/3352)
 
@@ -120,28 +129,14 @@
 - General: Create only one thumbnail per instance [\#3351](https://github.com/pypeclub/OpenPype/pull/3351)
 - nuke: adding extract thumbnail settings 3.10 [\#3347](https://github.com/pypeclub/OpenPype/pull/3347)
 - General: Fix last version function [\#3345](https://github.com/pypeclub/OpenPype/pull/3345)
-- Deadline: added OPENPYPE\_MONGO to filter [\#3336](https://github.com/pypeclub/OpenPype/pull/3336)
-
-**🔀 Refactored code**
-
-- Webpublisher: Use client query functions [\#3333](https://github.com/pypeclub/OpenPype/pull/3333)
 
 ## [3.11.0](https://github.com/pypeclub/OpenPype/tree/3.11.0) (2022-06-17)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.11.0-nightly.4...3.11.0)
 
-**🚀 Enhancements**
-
-- Settings: Settings can be extracted from UI [\#3323](https://github.com/pypeclub/OpenPype/pull/3323)
-
 **🐛 Bug fixes**
 
 - General: Handle empty source key on instance [\#3342](https://github.com/pypeclub/OpenPype/pull/3342)
-- Houdini: Fix Houdini VDB manage update wrong file attribute name [\#3322](https://github.com/pypeclub/OpenPype/pull/3322)
-
-**🔀 Refactored code**
-
-- Blender: Use client query functions [\#3331](https://github.com/pypeclub/OpenPype/pull/3331)
 
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
diff --git a/openpype/version.py b/openpype/version.py
index 3cb7f4572b..3239b0e2a2 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.1-nightly.3"
+__version__ = "3.12.1-nightly.4"
diff --git a/pyproject.toml b/pyproject.toml
index 4803249923..f5bd7cc946 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.1-nightly.3" # OpenPype
+version = "3.12.1-nightly.4" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 5cf03a43cb5794e1b00a5bd729d62ba8257fb5b4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 11 Jul 2022 11:40:24 +0200
Subject: [PATCH 1019/1227] deffer workfiles tool show using qtimer

---
 openpype/hosts/nuke/api/lib.py | 60 ++++++++++++++++++++++++++++------
 1 file changed, 50 insertions(+), 10 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index f565ec8546..0929415c00 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -10,6 +10,7 @@ from collections import OrderedDict
 import clique
 
 import nuke
+from Qt import QtCore, QtWidgets
 
 from openpype.client import (
     get_project,
@@ -27,6 +28,7 @@ from openpype.api import (
     get_current_project_settings,
 )
 from openpype.tools.utils import host_tools
+from openpype.lib import env_value_to_bool
 from openpype.lib.path_tools import HostDirmap
 from openpype.settings import (
     get_project_settings,
@@ -63,7 +65,10 @@ class Context:
     main_window = None
     context_label = None
     project_name = os.getenv("AVALON_PROJECT")
+    # Workfile related code
     workfiles_launched = False
+    workfiles_tool_timer = None
+
     # Seems unused
     _project_doc = None
 
@@ -2384,12 +2389,19 @@ def select_nodes(nodes):
 
 
 def launch_workfiles_app():
-    '''Function letting start workfiles after start of host
-    '''
-    from openpype.lib import (
-        env_value_to_bool
-    )
-    from .pipeline import get_main_window
+    """Show workfiles tool on nuke launch.
+
+    Trigger to show workfiles tool on application launch. Can be executed only
+    once all other calls are ignored.
+
+    Workfiles tool show is deffered after application initialization using
+    QTimer.
+    """
+
+    if Context.workfiles_launched:
+        return
+
+    Context.workfiles_launched = True
 
     # get all imortant settings
     open_at_start = env_value_to_bool(
@@ -2400,10 +2412,38 @@ def launch_workfiles_app():
     if not open_at_start:
         return
 
-    if not Context.workfiles_launched:
-        Context.workfiles_launched = True
-        main_window = get_main_window()
-        host_tools.show_workfiles(parent=main_window)
+    # Show workfiles tool using timer
+    # - this will be probably triggered during initialization in that case
+    #   the application is not be able to show uis so it must be
+    #   deffered using timer
+    # - timer should be processed when initialization ends
+    #       When applications starts to process events.
+    timer = QtCore.QTimer()
+    timer.timeout.connect(_launch_workfile_app)
+    timer.setInterval(100)
+    Context.workfiles_tool_timer = timer
+    timer.start()
+
+
+def _launch_workfile_app():
+    # Safeguard to not show window when application is still starting up
+    #   or is already closing down.
+    closing_down = QtWidgets.QApplication.closingDown()
+    starting_up = QtWidgets.QApplication.startingUp()
+
+    # Stop the timer if application finished start up of is closing down
+    if closing_down or not starting_up:
+        Context.workfiles_tool_timer.stop()
+        Context.workfiles_tool_timer = None
+
+    # Skip if application is starting up or closing down
+    if starting_up or closing_down:
+        return
+
+    from .pipeline import get_main_window
+
+    main_window = get_main_window()
+    host_tools.show_workfiles(parent=main_window)
 
 
 def process_workfile_builder():

From 4dbc094e5980a2453992516e0f32d6cf868ec7f7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 11 Jul 2022 11:40:38 +0200
Subject: [PATCH 1020/1227] trigger launch workfiles app on install

---
 openpype/hosts/nuke/api/pipeline.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/api/pipeline.py b/openpype/hosts/nuke/api/pipeline.py
index 2785eb65cd..2e3621ba8f 100644
--- a/openpype/hosts/nuke/api/pipeline.py
+++ b/openpype/hosts/nuke/api/pipeline.py
@@ -120,8 +120,9 @@ def install():
     nuke.addOnCreate(workfile_settings.set_context_settings, nodeClass="Root")
     nuke.addOnCreate(workfile_settings.set_favorites, nodeClass="Root")
     nuke.addOnCreate(process_workfile_builder, nodeClass="Root")
-    nuke.addOnCreate(launch_workfiles_app, nodeClass="Root")
+
     _install_menu()
+    launch_workfiles_app()
 
 
 def uninstall():

From 85e89526d5019a151156a6686dc169708d6e8d4c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 11 Jul 2022 17:42:54 +0200
Subject: [PATCH 1021/1227] added attribute instance label on instance

---
 openpype/pipeline/create/context.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index 7758a660d3..61cbe8caff 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -496,6 +496,13 @@ class CreatedInstance:
     def subset_name(self):
         return self._data["subset"]
 
+    @property
+    def instance_label(self):
+        label = self._data.get("label")
+        if not label:
+            label = self.subset_name
+        return label
+
     @property
     def creator_identifier(self):
         return self.creator.identifier

From 6feeca860b167785a5fb4306c4a50d30ae996087 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 11 Jul 2022 17:46:45 +0200
Subject: [PATCH 1022/1227] use 'label' to display instance in views

---
 openpype/pipeline/create/context.py                   | 2 +-
 openpype/tools/publisher/widgets/card_view_widgets.py | 7 ++++---
 openpype/tools/publisher/widgets/list_view_widgets.py | 2 +-
 3 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index 61cbe8caff..7f0341c127 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -497,7 +497,7 @@ class CreatedInstance:
         return self._data["subset"]
 
     @property
-    def instance_label(self):
+    def label(self):
         label = self._data.get("label")
         if not label:
             label = self.subset_name
diff --git a/openpype/tools/publisher/widgets/card_view_widgets.py b/openpype/tools/publisher/widgets/card_view_widgets.py
index 086cd5c59c..3c294c9c7c 100644
--- a/openpype/tools/publisher/widgets/card_view_widgets.py
+++ b/openpype/tools/publisher/widgets/card_view_widgets.py
@@ -303,13 +303,14 @@ class InstanceCardWidget(CardWidget):
         self._last_variant = variant
         self._last_subset_name = subset_name
         # Make `variant` bold
-        found_parts = set(re.findall(variant, subset_name, re.IGNORECASE))
+        label = self.instance.label
+        found_parts = set(re.findall(variant, label, re.IGNORECASE))
         if found_parts:
             for part in found_parts:
                 replacement = "<b>{}</b>".format(part)
-                subset_name = subset_name.replace(part, replacement)
+                label = label.replace(part, replacement)
 
-        self._label_widget.setText(subset_name)
+        self._label_widget.setText(label)
         # HTML text will cause that label start catch mouse clicks
         # - disabling with changing interaction flag
         self._label_widget.setTextInteractionFlags(
diff --git a/openpype/tools/publisher/widgets/list_view_widgets.py b/openpype/tools/publisher/widgets/list_view_widgets.py
index 6bddaf66c8..1b1a19599a 100644
--- a/openpype/tools/publisher/widgets/list_view_widgets.py
+++ b/openpype/tools/publisher/widgets/list_view_widgets.py
@@ -113,7 +113,7 @@ class InstanceListItemWidget(QtWidgets.QWidget):
 
         self.instance = instance
 
-        subset_name_label = QtWidgets.QLabel(instance["subset"], self)
+        subset_name_label = QtWidgets.QLabel(instance.label, self)
         subset_name_label.setObjectName("ListViewSubsetName")
 
         active_checkbox = NiceCheckbox(parent=self)

From 74e57f9f49cdbb4812cd6d0c5348c5877f4e61e1 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 11 Jul 2022 18:15:46 +0200
Subject: [PATCH 1023/1227] OP-3446 - implemented render_mov_batch in
 TrayPublisher

---
 openpype/hosts/traypublisher/api/batch_lib.py |  61 ++++++
 .../plugins/create/create_mov_batch.py        | 191 ++++++++++++++++++
 .../plugins/publish/collect_mov_batch.py      |  34 ++++
 .../project_settings/traypublisher.json       |  15 +-
 .../schema_project_traypublisher.json         |  71 +++++++
 5 files changed, 371 insertions(+), 1 deletion(-)
 create mode 100644 openpype/hosts/traypublisher/api/batch_lib.py
 create mode 100644 openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
 create mode 100644 openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py

diff --git a/openpype/hosts/traypublisher/api/batch_lib.py b/openpype/hosts/traypublisher/api/batch_lib.py
new file mode 100644
index 0000000000..2486d405bd
--- /dev/null
+++ b/openpype/hosts/traypublisher/api/batch_lib.py
@@ -0,0 +1,61 @@
+# Helper functions to find matching asset for (multiple) processed source files
+import os
+import collections
+
+from openpype.client import get_assets
+
+
+def get_children_assets_by_name(project_name, top_asset_doc):
+    """ Get all children for 'top_asset_doc' by theirs name
+
+    Args:
+        project_name (str)
+        top_asset_doc (asset doc) (eg dict)
+    Returns:
+        (dict) {"shot1": shot1_asset_doc}
+    """
+    assets_by_parent_id = get_asset_docs_by_parent_id(project_name)
+    _children_docs = get_children_docs(
+        assets_by_parent_id, top_asset_doc
+    )
+    children_docs = {
+        children_doc["name"].lower(): children_doc
+        for children_doc in _children_docs
+    }
+    return children_docs
+
+
+def get_asset_docs_by_parent_id(project_name):
+    """ Query all assets for project and store them by parent's id to list
+
+    Args:
+         project_name (str)
+    Returns:
+        (dict) { _id of parent :[asset_doc1, asset_doc2]}
+    """
+    asset_docs_by_parent_id = collections.defaultdict(list)
+    for asset_doc in get_assets(project_name):
+        parent_id = asset_doc["data"]["visualParent"]
+        asset_docs_by_parent_id[parent_id].append(asset_doc)
+    return asset_docs_by_parent_id
+
+
+def get_children_docs(documents_by_parent_id, parent_doc):
+    """ Recursively find all children in reverse order
+
+    Last children first.
+    Args:
+         documents_by_parent_id (dict)
+         parent_doc (asset doc, eg dict)
+    Returns
+        (list) of asset docs
+    """
+    output = []
+    children = documents_by_parent_id.get(parent_doc["_id"]) or tuple()
+    for child in children:
+        output.extend(
+            get_children_docs(documents_by_parent_id, child)
+        )
+    output.append(parent_doc)
+    return output
+
diff --git a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
new file mode 100644
index 0000000000..5297d73ba9
--- /dev/null
+++ b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
@@ -0,0 +1,191 @@
+import copy
+import os
+import re
+
+from openpype.client import get_assets
+from openpype.hosts.traypublisher.api import pipeline
+from openpype.lib import FileDef, TextDef, get_subset_name_with_asset_doc
+from openpype.pipeline import (
+    CreatedInstance
+)
+
+from openpype.hosts.traypublisher.api.plugin import TrayPublishCreator
+
+
+class BatchMovCreator(TrayPublishCreator):
+    """Creates instances from .mov file(s)."""
+    identifier = "render_mov_batch"
+    label = "Batch Mov"
+    family = "render"
+    description = "Publish batch of movs"
+    host_name = "traypublisher"
+
+    create_allow_context_change = False
+    version_regex = re.compile(r"^(.+)_v([0-9]+)$")
+
+    default_tasks = ["Compositing"]
+
+    extensions = [".mov"]
+
+    def __init__(self, project_settings, *args, **kwargs):
+        super(BatchMovCreator, self).__init__(project_settings,
+                                              *args, **kwargs)
+        self._default_variants = (project_settings["traypublisher"]
+                                                  ["BatchMovCreator"]
+                                                  ["default_variants"])
+
+    def get_icon(self):
+        return "fa.file"
+
+    def create(self, subset_name, data, pre_create_data):
+        file_paths = pre_create_data.get("filepath")
+        if not file_paths:
+            return
+
+        for file_info in file_paths:
+            instance_data = copy.deepcopy(data)
+            file_name = file_info["filenames"][0]
+            filepath = os.path.join(file_info["directory"], file_name)
+            instance_data["creator_attributes"] = {"filepath": filepath}
+
+            asset_doc, version = self.get_asset_doc_from_file_name(
+                file_name, self.project_name)
+
+            subset_name, task_name = self._get_subset_and_task(
+                asset_doc, data["variant"], self.project_name)
+
+            instance_data["task"] = task_name
+            instance_data["asset"] = asset_doc["name"]
+
+            # Create new instance
+            new_instance = CreatedInstance(self.family, subset_name,
+                                           instance_data, self)
+            # Host implementation of storing metadata about instance
+            pipeline.HostContext.add_instance(new_instance.data_to_store())
+            # Add instance to current context
+            self._add_instance_to_context(new_instance)
+
+    def get_asset_doc_from_file_name(self, source_filename, project_name):
+        """Try to parse out asset name from file name provided.
+
+        Artists might provide various file name formats.
+        Currently handled:
+            - chair.mov
+            - chair_v001.mov
+            - my_chair_to_upload.mov
+        """
+        version = None
+        asset_name = os.path.splitext(source_filename)[0]
+        # Always first check if source filename is in assets
+        matching_asset_doc = self._get_asset_by_name_case_not_sensitive(
+            project_name, asset_name)
+
+        if matching_asset_doc is None:
+            matching_asset_doc, version = (
+                self._parse_with_version(project_name, asset_name))
+
+        if matching_asset_doc is None:
+            matching_asset_doc = self._parse_containing(project_name,
+                                                        asset_name)
+
+        if matching_asset_doc is None:
+            raise ValueError(
+                "Cannot guess asset name from {}".format(source_filename))
+
+        return matching_asset_doc, version
+
+    def _parse_with_version(self, project_name, asset_name):
+        """Try to parse asset name from a file name containing version too
+
+        Eg. 'chair_v001.mov' >> 'chair', 1
+        """
+        self.log.debug((
+           "Asset doc by \"{}\" was not found, trying version regex."
+        ).format(asset_name))
+
+        matching_asset_doc = version_number = None
+
+        regex_result = self.version_regex.findall(asset_name)
+        if regex_result:
+            _asset_name, _version_number = regex_result[0]
+            matching_asset_doc = self._get_asset_by_name_case_not_sensitive(
+                project_name, _asset_name)
+            if matching_asset_doc:
+                version_number = int(_version_number)
+
+        return matching_asset_doc, version_number
+
+    def _parse_containing(self, project_name, asset_name):
+        """Look if file name contains any existing asset name"""
+        for asset_doc in get_assets(project_name, fields=["name"]):
+            if asset_doc["name"].lower() in asset_name.lower():
+                return get_assets(project_name,
+                                  asset_names=[asset_doc["name"]])
+
+    def _get_subset_and_task(self, asset_doc, variant, project_name):
+        """Create subset name according to standard template process"""
+        task_name = self._get_task_name(asset_doc)
+
+        subset_name = get_subset_name_with_asset_doc(
+            self.family,
+            variant,
+            task_name,
+            asset_doc,
+            project_name
+        )
+
+        return subset_name, task_name
+
+    def _get_task_name(self, asset_doc):
+        """Get applicable task from 'asset_doc' """
+        available_task_names = {}
+        asset_tasks = asset_doc.get("data", {}).get("tasks") or {}
+        for task_name in asset_tasks.keys():
+            available_task_names[task_name.lower()] = task_name
+
+        task_name = None
+        for _task_name in self.default_tasks:
+            _task_name_low = _task_name.lower()
+            if _task_name_low in available_task_names:
+                task_name = available_task_names[_task_name_low]
+                break
+
+        return task_name
+
+    def get_default_variants(self):
+        return self._default_variants
+
+    def get_instance_attr_defs(self):
+        return []
+
+    def get_pre_create_attr_defs(self):
+        # Use same attributes as for instance attributes
+        return [
+            FileDef(
+                "filepath",
+                folders=False,
+                single_item=False,
+                extensions=self.extensions,
+                label="Filepath"
+            )
+        ]
+
+    def get_detail_description(self):
+        return """# Publish batch of .mov to multiple assets.
+        
+        File names must then contain only asset name, or asset name + version.
+        (eg. 'chair.mov', 'chair_v001.mov', not really safe `my_chair_v001.mov`
+        """
+
+    def _get_asset_by_name_case_not_sensitive(self, project_name, asset_name):
+        """Handle more cases in file names"""
+        asset_name = re.compile(asset_name, re.IGNORECASE)
+
+        assets = list(get_assets(project_name, asset_names=[asset_name]))
+        if assets:
+            if len(assets) > 1:
+                self.log.warning("Too many records found for {}".format(
+                    asset_name))
+                return
+
+            return assets.pop()
diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
new file mode 100644
index 0000000000..2a5e356684
--- /dev/null
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
@@ -0,0 +1,34 @@
+import os
+
+import pyblish.api
+from openpype.pipeline import OpenPypePyblishPluginMixin
+
+
+class CollectMovBatch(
+    pyblish.api.InstancePlugin, OpenPypePyblishPluginMixin
+):
+    """Collect file url for batch mov and create representation."""
+
+    label = "Collect Mov Batch Files"
+    order = pyblish.api.CollectorOrder
+
+    hosts = ["traypublisher"]
+
+    def process(self, instance):
+        if not instance.data.get("creator_identifier") == "render_mov_batch":
+            return
+
+        file_url = instance.data["creator_attributes"]["filepath"]
+        file_name = os.path.basename(file_url)
+        _, ext = os.path.splitext(file_name)
+
+        repre = {
+            "name": ext[1:],
+            "ext": ext[1:],
+            "files": file_name,
+            "stagingDir": os.path.dirname(file_url)
+        }
+
+        instance.data["representations"].append(repre)
+
+        self.log.debug("instance.data {}".format(instance.data))
diff --git a/openpype/settings/defaults/project_settings/traypublisher.json b/openpype/settings/defaults/project_settings/traypublisher.json
index 0b54cfd39e..6d2d32a037 100644
--- a/openpype/settings/defaults/project_settings/traypublisher.json
+++ b/openpype/settings/defaults/project_settings/traypublisher.json
@@ -31,5 +31,18 @@
                 ".aep"
             ]
         }
-    ]
+    ],
+    "BatchMovCreator": {
+        "family": "render_mov_batch",
+        "identifier": "",
+        "label": "Batch Mov",
+        "icon": "fa.file",
+        "default_variants": [],
+        "description": "",
+        "detailed_description": "",
+        "default_tasks": "Compositing",
+        "extensions": [
+            ".mov"
+        ]
+    }
 }
\ No newline at end of file
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
index 55c1b7b7d7..7cb74d86a7 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
@@ -78,6 +78,77 @@
                     }
                 ]
             }
+        },
+         {
+            "type": "dict",
+            "collapsible": true,
+            "key": "BatchMovCreator",
+            "label": "Batch Mov Creator",
+            "use_label_wrap": true,
+            "collapsible_key": true,
+            "children": [
+                {
+                    "type": "text",
+                    "key": "family",
+                    "label": "Family"
+                },
+                {
+                    "type": "text",
+                    "key": "identifier",
+                    "label": "Identifier",
+                    "placeholder": "< Use 'Family' >",
+                    "tooltip": "All creators must have unique identifier.\nBy default is used 'family' but if you need to have more creators with same families\nyou have to set identifier too."
+                },
+                {
+                    "type": "text",
+                    "key": "label",
+                    "label": "Label"
+                },
+                {
+                    "type": "text",
+                    "key": "icon",
+                    "label": "Icon"
+                },
+                {
+                    "type": "list",
+                    "key": "default_variants",
+                    "label": "Default variants",
+                    "object_type": {
+                        "type": "text"
+                    }
+                },
+                {
+                    "type": "separator"
+                },
+                {
+                    "type": "text",
+                    "key": "description",
+                    "label": "Description"
+                },
+                {
+                    "type": "text",
+                    "key": "detailed_description",
+                    "label": "Detailed Description",
+                    "multiline": true
+                },
+                {
+                    "type": "separator"
+                },
+                {
+                    "type": "text",
+                    "key": "default_tasks",
+                    "label": "Default task"
+                },
+                {
+                    "type": "list",
+                    "key": "extensions",
+                    "label": "Extensions",
+                    "use_label_wrap": true,
+                    "collapsible_key": true,
+                    "collapsed": false,
+                    "object_type": "text"
+                }
+            ]
         }
     ]
 }

From 620060b7d6a07ef9264429a56ff797b233085a99 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 11 Jul 2022 18:19:27 +0200
Subject: [PATCH 1024/1227] use plist.load as plist.readPlist is deprecated

---
 openpype/lib/applications.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index 82f77ef9e3..f46197e15f 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -665,7 +665,11 @@ class ApplicationExecutable:
             if os.path.exists(plist_filepath):
                 import plistlib
 
-                parsed_plist = plistlib.readPlist(plist_filepath)
+                if hasattr(plistlib, "load"):
+                    with open(plist_filepath, "rb") as stream:
+                        parsed_plist = plistlib.load(stream)
+                else:
+                    parsed_plist = plistlib.readPlist(plist_filepath)
                 executable_filename = parsed_plist.get("CFBundleExecutable")
 
             if executable_filename:

From e0c2499cf95eb0d5d9d591781d9eb1b7618d660c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 11 Jul 2022 18:48:42 +0200
Subject: [PATCH 1025/1227] align creator attributes from top to bottom

---
 openpype/tools/publisher/widgets/widgets.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/tools/publisher/widgets/widgets.py b/openpype/tools/publisher/widgets/widgets.py
index 7096b9fb50..5a5f8c4c37 100644
--- a/openpype/tools/publisher/widgets/widgets.py
+++ b/openpype/tools/publisher/widgets/widgets.py
@@ -1225,6 +1225,7 @@ class CreatorAttrsWidget(QtWidgets.QWidget):
     different creators. If creator have same (similar) definitions their
     widgets are merged into one (different label does not count).
     """
+
     def __init__(self, controller, parent):
         super(CreatorAttrsWidget, self).__init__(parent)
 
@@ -1275,6 +1276,7 @@ class CreatorAttrsWidget(QtWidgets.QWidget):
         content_layout = QtWidgets.QGridLayout(content_widget)
         content_layout.setColumnStretch(0, 0)
         content_layout.setColumnStretch(1, 1)
+        content_layout.setAlignment(QtCore.Qt.AlignTop)
 
         row = 0
         for attr_def, attr_instances, values in result:

From a7c945f51f484a848401072fd230334710f3b734 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 12 Jul 2022 11:01:52 +0200
Subject: [PATCH 1026/1227] OP-3446 - fix return type

---
 .../traypublisher/plugins/create/create_mov_batch.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
index 5297d73ba9..d796b304a3 100644
--- a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
@@ -2,11 +2,12 @@ import copy
 import os
 import re
 
-from openpype.client import get_assets
+from openpype.client import get_assets, get_asset_by_name
 from openpype.hosts.traypublisher.api import pipeline
-from openpype.lib import FileDef, TextDef, get_subset_name_with_asset_doc
+from openpype.lib import FileDef, get_subset_name_with_asset_doc
 from openpype.pipeline import (
-    CreatedInstance
+    CreatedInstance,
+    CreatorError
 )
 
 from openpype.hosts.traypublisher.api.plugin import TrayPublishCreator
@@ -89,7 +90,7 @@ class BatchMovCreator(TrayPublishCreator):
                                                         asset_name)
 
         if matching_asset_doc is None:
-            raise ValueError(
+            raise CreatorError(
                 "Cannot guess asset name from {}".format(source_filename))
 
         return matching_asset_doc, version
@@ -119,8 +120,7 @@ class BatchMovCreator(TrayPublishCreator):
         """Look if file name contains any existing asset name"""
         for asset_doc in get_assets(project_name, fields=["name"]):
             if asset_doc["name"].lower() in asset_name.lower():
-                return get_assets(project_name,
-                                  asset_names=[asset_doc["name"]])
+                return get_asset_by_name(project_name, asset_doc["name"])
 
     def _get_subset_and_task(self, asset_doc, variant, project_name):
         """Create subset name according to standard template process"""

From c3384c4005132c2eb973d0bda8a191bb3fd6791c Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 12 Jul 2022 11:02:06 +0200
Subject: [PATCH 1027/1227] OP-3446 - remove obsolete methods

---
 openpype/hosts/traypublisher/api/batch_lib.py | 61 -------------------
 1 file changed, 61 deletions(-)
 delete mode 100644 openpype/hosts/traypublisher/api/batch_lib.py

diff --git a/openpype/hosts/traypublisher/api/batch_lib.py b/openpype/hosts/traypublisher/api/batch_lib.py
deleted file mode 100644
index 2486d405bd..0000000000
--- a/openpype/hosts/traypublisher/api/batch_lib.py
+++ /dev/null
@@ -1,61 +0,0 @@
-# Helper functions to find matching asset for (multiple) processed source files
-import os
-import collections
-
-from openpype.client import get_assets
-
-
-def get_children_assets_by_name(project_name, top_asset_doc):
-    """ Get all children for 'top_asset_doc' by theirs name
-
-    Args:
-        project_name (str)
-        top_asset_doc (asset doc) (eg dict)
-    Returns:
-        (dict) {"shot1": shot1_asset_doc}
-    """
-    assets_by_parent_id = get_asset_docs_by_parent_id(project_name)
-    _children_docs = get_children_docs(
-        assets_by_parent_id, top_asset_doc
-    )
-    children_docs = {
-        children_doc["name"].lower(): children_doc
-        for children_doc in _children_docs
-    }
-    return children_docs
-
-
-def get_asset_docs_by_parent_id(project_name):
-    """ Query all assets for project and store them by parent's id to list
-
-    Args:
-         project_name (str)
-    Returns:
-        (dict) { _id of parent :[asset_doc1, asset_doc2]}
-    """
-    asset_docs_by_parent_id = collections.defaultdict(list)
-    for asset_doc in get_assets(project_name):
-        parent_id = asset_doc["data"]["visualParent"]
-        asset_docs_by_parent_id[parent_id].append(asset_doc)
-    return asset_docs_by_parent_id
-
-
-def get_children_docs(documents_by_parent_id, parent_doc):
-    """ Recursively find all children in reverse order
-
-    Last children first.
-    Args:
-         documents_by_parent_id (dict)
-         parent_doc (asset doc, eg dict)
-    Returns
-        (list) of asset docs
-    """
-    output = []
-    children = documents_by_parent_id.get(parent_doc["_id"]) or tuple()
-    for child in children:
-        output.extend(
-            get_children_docs(documents_by_parent_id, child)
-        )
-    output.append(parent_doc)
-    return output
-

From 24e26ce63a478941dd4334c7558b92c5eb853b95 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 12 Jul 2022 11:05:35 +0200
Subject: [PATCH 1028/1227] OP-3446 - fill defaults_variant explicitly

No need to overwrite method
---
 .../traypublisher/plugins/create/create_mov_batch.py     | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
index d796b304a3..1577b622ab 100644
--- a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
@@ -31,9 +31,9 @@ class BatchMovCreator(TrayPublishCreator):
     def __init__(self, project_settings, *args, **kwargs):
         super(BatchMovCreator, self).__init__(project_settings,
                                               *args, **kwargs)
-        self._default_variants = (project_settings["traypublisher"]
-                                                  ["BatchMovCreator"]
-                                                  ["default_variants"])
+        self.default_variants = (project_settings["traypublisher"]
+                                                 ["BatchMovCreator"]
+                                                 ["default_variants"])
 
     def get_icon(self):
         return "fa.file"
@@ -152,9 +152,6 @@ class BatchMovCreator(TrayPublishCreator):
 
         return task_name
 
-    def get_default_variants(self):
-        return self._default_variants
-
     def get_instance_attr_defs(self):
         return []
 

From 89eddfa63d91eb1de766363b9d9c8c7899d39ad1 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 12 Jul 2022 11:17:55 +0200
Subject: [PATCH 1029/1227] OP-3446 - fix pulling configuration from Settings

---
 .../traypublisher/plugins/create/create_mov_batch.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
index 1577b622ab..e54fc44acc 100644
--- a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
@@ -24,10 +24,6 @@ class BatchMovCreator(TrayPublishCreator):
     create_allow_context_change = False
     version_regex = re.compile(r"^(.+)_v([0-9]+)$")
 
-    default_tasks = ["Compositing"]
-
-    extensions = [".mov"]
-
     def __init__(self, project_settings, *args, **kwargs):
         super(BatchMovCreator, self).__init__(project_settings,
                                               *args, **kwargs)
@@ -35,6 +31,14 @@ class BatchMovCreator(TrayPublishCreator):
                                                  ["BatchMovCreator"]
                                                  ["default_variants"])
 
+        self.default_tasks = (project_settings["traypublisher"]
+                                              ["BatchMovCreator"]
+                                              ["default_tasks"])
+
+        self.extensions = (project_settings["traypublisher"]
+                                           ["BatchMovCreator"]
+                                           ["extensions"])
+
     def get_icon(self):
         return "fa.file"
 

From 1fe8c96c261e9687b5aaca52e53d88897fef540a Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 12 Jul 2022 11:18:31 +0200
Subject: [PATCH 1030/1227] OP-3446 - modifying Settings to list

---
 .../settings/defaults/project_settings/traypublisher.json  | 4 ++--
 .../projects_schema/schema_project_traypublisher.json      | 7 +++++--
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/traypublisher.json b/openpype/settings/defaults/project_settings/traypublisher.json
index 6d2d32a037..36526d01b0 100644
--- a/openpype/settings/defaults/project_settings/traypublisher.json
+++ b/openpype/settings/defaults/project_settings/traypublisher.json
@@ -37,10 +37,10 @@
         "identifier": "",
         "label": "Batch Mov",
         "icon": "fa.file",
-        "default_variants": [],
+        "default_variants": ["Main"],
         "description": "",
         "detailed_description": "",
-        "default_tasks": "Compositing",
+        "default_tasks": ["Compositing"],
         "extensions": [
             ".mov"
         ]
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
index 7cb74d86a7..308883d46f 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
@@ -135,9 +135,12 @@
                     "type": "separator"
                 },
                 {
-                    "type": "text",
+                    "type": "list",
                     "key": "default_tasks",
-                    "label": "Default task"
+                    "label": "Default tasks",
+                    "object_type": {
+                        "type": "text"
+                    }
                 },
                 {
                     "type": "list",

From 20b0292af170360db2aecb0483afe3ae13dd3bcd Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 12 Jul 2022 11:19:27 +0200
Subject: [PATCH 1031/1227] OP-3446 - removed unneeded, comes from class

---
 openpype/hosts/traypublisher/plugins/create/create_mov_batch.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
index e54fc44acc..fdada96c87 100644
--- a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
@@ -19,7 +19,6 @@ class BatchMovCreator(TrayPublishCreator):
     label = "Batch Mov"
     family = "render"
     description = "Publish batch of movs"
-    host_name = "traypublisher"
 
     create_allow_context_change = False
     version_regex = re.compile(r"^(.+)_v([0-9]+)$")

From 7abbc26184b054a56118d0a8323b309e10e61179 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 11:36:13 +0200
Subject: [PATCH 1032/1227] first sequence frame is taken from the input
 sequence instead of output frame

---
 openpype/plugins/publish/extract_review.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/extract_review.py b/openpype/plugins/publish/extract_review.py
index b6e5fee1fe..107a0994a3 100644
--- a/openpype/plugins/publish/extract_review.py
+++ b/openpype/plugins/publish/extract_review.py
@@ -446,8 +446,11 @@ class ExtractReview(pyblish.api.InstancePlugin):
             with_audio = False
 
         input_is_sequence = self.input_is_sequence(repre)
+        first_sequence_frame = None
         input_allow_bg = False
         if input_is_sequence and repre["files"]:
+            cols, _ = clique.assemble(repre["files"])
+            first_sequence_frame = list(sorted(cols[0].indexes))[0]
             ext = os.path.splitext(repre["files"][0])[1].replace(".", "")
             if ext in self.alpha_exts:
                 input_allow_bg = True
@@ -467,6 +470,7 @@ class ExtractReview(pyblish.api.InstancePlugin):
             "resolution_height": instance.data.get("resolutionHeight"),
             "origin_repre": repre,
             "input_is_sequence": input_is_sequence,
+            "first_sequence_frame": first_sequence_frame,
             "input_allow_bg": input_allow_bg,
             "with_audio": with_audio,
             "without_handles": without_handles,
@@ -545,9 +549,9 @@ class ExtractReview(pyblish.api.InstancePlugin):
         if temp_data["input_is_sequence"]:
             # Set start frame of input sequence (just frame in filename)
             # - definition of input filepath
-            ffmpeg_input_args.append(
-                "-start_number {}".format(temp_data["output_frame_start"])
-            )
+            ffmpeg_input_args.extend([
+                "-start_number", str(temp_data["first_sequence_frame"])
+            ])
 
             # TODO add fps mapping `{fps: fraction}` ?
             # - e.g.: {

From 0524ce303623074414bdabfd4b15ec41b1e00d9e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 11:54:39 +0200
Subject: [PATCH 1033/1227] added some comment related to first frame

---
 openpype/plugins/publish/extract_review.py | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_review.py b/openpype/plugins/publish/extract_review.py
index 107a0994a3..a184f0f3d1 100644
--- a/openpype/plugins/publish/extract_review.py
+++ b/openpype/plugins/publish/extract_review.py
@@ -446,11 +446,17 @@ class ExtractReview(pyblish.api.InstancePlugin):
             with_audio = False
 
         input_is_sequence = self.input_is_sequence(repre)
-        first_sequence_frame = None
         input_allow_bg = False
+        first_sequence_frame = None
         if input_is_sequence and repre["files"]:
+            # Calculate first frame that should be used
             cols, _ = clique.assemble(repre["files"])
-            first_sequence_frame = list(sorted(cols[0].indexes))[0]
+            input_frames = list(sorted(cols[0].indexes))
+            # WARNING: This is an issue as we don't know if first frame
+            #   is with or without handles!
+            # - in theory we should add handle start but how do we know we can?
+            first_sequence_frame = input_frames[0]
+
             ext = os.path.splitext(repre["files"][0])[1].replace(".", "")
             if ext in self.alpha_exts:
                 input_allow_bg = True

From ab24d18f31840bfe0e4e2a95085f9e3d0ca8bdbd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 12:02:05 +0200
Subject: [PATCH 1034/1227] try partially solve issue with handles

---
 openpype/plugins/publish/extract_review.py | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_review.py b/openpype/plugins/publish/extract_review.py
index a184f0f3d1..1b6e2a1d61 100644
--- a/openpype/plugins/publish/extract_review.py
+++ b/openpype/plugins/publish/extract_review.py
@@ -452,10 +452,16 @@ class ExtractReview(pyblish.api.InstancePlugin):
             # Calculate first frame that should be used
             cols, _ = clique.assemble(repre["files"])
             input_frames = list(sorted(cols[0].indexes))
+            first_sequence_frame = input_frames[0]
             # WARNING: This is an issue as we don't know if first frame
             #   is with or without handles!
-            # - in theory we should add handle start but how do we know we can?
-            first_sequence_frame = input_frames[0]
+            # - handle start is added but how do not know if we should
+            output_duration = (output_frame_end - output_frame_start) + 1
+            if (
+                without_handles
+                and len(input_frames) - handle_start >= output_duration
+            ):
+                first_sequence_frame += handle_start
 
             ext = os.path.splitext(repre["files"][0])[1].replace(".", "")
             if ext in self.alpha_exts:

From 636206f9d2bab1e22337ebbd09c7db68b99e2fa2 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 12 Jul 2022 12:19:22 +0200
Subject: [PATCH 1035/1227] Update
 openpype/hosts/traypublisher/plugins/create/create_mov_batch.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../plugins/create/create_mov_batch.py          | 17 ++++++-----------
 1 file changed, 6 insertions(+), 11 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
index fdada96c87..20d3ecbd7c 100644
--- a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
@@ -26,17 +26,12 @@ class BatchMovCreator(TrayPublishCreator):
     def __init__(self, project_settings, *args, **kwargs):
         super(BatchMovCreator, self).__init__(project_settings,
                                               *args, **kwargs)
-        self.default_variants = (project_settings["traypublisher"]
-                                                 ["BatchMovCreator"]
-                                                 ["default_variants"])
-
-        self.default_tasks = (project_settings["traypublisher"]
-                                              ["BatchMovCreator"]
-                                              ["default_tasks"])
-
-        self.extensions = (project_settings["traypublisher"]
-                                           ["BatchMovCreator"]
-                                           ["extensions"])
+        creator_settings = (
+            project_settings["traypublisher"]["BatchMovCreator"]
+        )
+        self.default_variants = creator_settings["default_variants"]
+        self.default_tasks = creator_settings["default_tasks"]
+        self.extensions = creator_settings["extensions"]
 
     def get_icon(self):
         return "fa.file"

From 6936f836882159e48d81a17272df1249cc11b806 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 12:38:28 +0200
Subject: [PATCH 1036/1227] fix issue with changing instance label

---
 .../tools/publisher/widgets/list_view_widgets.py     | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/tools/publisher/widgets/list_view_widgets.py b/openpype/tools/publisher/widgets/list_view_widgets.py
index 1b1a19599a..8cc6dc45eb 100644
--- a/openpype/tools/publisher/widgets/list_view_widgets.py
+++ b/openpype/tools/publisher/widgets/list_view_widgets.py
@@ -132,7 +132,7 @@ class InstanceListItemWidget(QtWidgets.QWidget):
 
         active_checkbox.stateChanged.connect(self._on_active_change)
 
-        self._subset_name_label = subset_name_label
+        self._instance_label_widget = subset_name_label
         self._active_checkbox = active_checkbox
 
         self._has_valid_context = None
@@ -146,8 +146,8 @@ class InstanceListItemWidget(QtWidgets.QWidget):
         state = ""
         if not valid:
             state = "invalid"
-        self._subset_name_label.setProperty("state", state)
-        self._subset_name_label.style().polish(self._subset_name_label)
+        self._instance_label_widget.setProperty("state", state)
+        self._instance_label_widget.style().polish(self._instance_label_widget)
 
     def is_active(self):
         """Instance is activated."""
@@ -176,9 +176,9 @@ class InstanceListItemWidget(QtWidgets.QWidget):
     def update_instance_values(self):
         """Update instance data propagated to widgets."""
         # Check subset name
-        subset_name = self.instance["subset"]
-        if subset_name != self._subset_name_label.text():
-            self._subset_name_label.setText(subset_name)
+        label = self.instance.label
+        if label != self._instance_label_widget.text():
+            self._instance_label_widget.setText(label)
         # Check active state
         self.set_active(self.instance["active"])
         # Check valid states

From 64d80f2d05c7639505db50a9c512d01d6e1cf224 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 12 Jul 2022 13:40:24 +0200
Subject: [PATCH 1037/1227] nuke: adding retime loading option to clip loader

---
 openpype/hosts/nuke/plugins/load/load_clip.py | 30 ++++++++++++++-----
 1 file changed, 23 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/load/load_clip.py b/openpype/hosts/nuke/plugins/load/load_clip.py
index d177e6ba76..e9530c58c0 100644
--- a/openpype/hosts/nuke/plugins/load/load_clip.py
+++ b/openpype/hosts/nuke/plugins/load/load_clip.py
@@ -55,7 +55,8 @@ class LoadClip(plugin.NukeLoader):
 
     # option gui
     defaults = {
-        "start_at_workfile": True
+        "start_at_workfile": True,
+        "add_retime": True
     }
 
     options = [
@@ -63,6 +64,11 @@ class LoadClip(plugin.NukeLoader):
             "start_at_workfile",
             help="Load at workfile start frame",
             default=True
+        ),
+        qargparse.Boolean(
+            "add_retime",
+            help="Load with retime",
+            default=True
         )
     ]
 
@@ -88,6 +94,9 @@ class LoadClip(plugin.NukeLoader):
         start_at_workfile = options.get(
             "start_at_workfile", self.defaults["start_at_workfile"])
 
+        add_retime = options.get(
+            "add_retime", self.defaults["add_retime"])
+
         version = context['version']
         version_data = version.get("data", {})
         repre_id = repre["_id"]
@@ -151,7 +160,7 @@ class LoadClip(plugin.NukeLoader):
             data_imprint = {}
             for k in add_keys:
                 if k == 'version':
-                    data_imprint.update({k: context["version"]['name']})
+                    data_imprint[k] = context["version"]['name']
                 elif k == 'colorspace':
                     colorspace = repre["data"].get(k)
                     colorspace = colorspace or version_data.get(k)
@@ -159,10 +168,13 @@ class LoadClip(plugin.NukeLoader):
                     if used_colorspace:
                         data_imprint["used_colorspace"] = used_colorspace
                 else:
-                    data_imprint.update(
-                        {k: context["version"]['data'].get(k, str(None))})
+                    data_imprint[k] = context["version"]['data'].get(
+                        k, str(None))
 
-            data_imprint.update({"objectName": read_name})
+            data_imprint["objectName"] = read_name
+
+            if add_retime and version_data.get("retime", None):
+                data_imprint["addRetime"] = True
 
             read_node["tile_color"].setValue(int("0x4ecd25ff", 16))
 
@@ -174,7 +186,7 @@ class LoadClip(plugin.NukeLoader):
                 loader=self.__class__.__name__,
                 data=data_imprint)
 
-        if version_data.get("retime", None):
+        if add_retime and version_data.get("retime", None):
             self._make_retimes(read_node, version_data)
 
         self.set_as_member(read_node)
@@ -200,6 +212,10 @@ class LoadClip(plugin.NukeLoader):
 
         start_at_workfile = bool("start at" in read_node['frame_mode'].value())
 
+        # TODO: find `addRetime` add openpipe data
+        # add_retime = options.get(
+        #     "add_retime", self.defaults["add_retime"])
+
         project_name = legacy_io.active_project()
         version_doc = get_version_by_id(project_name, representation["parent"])
 
@@ -286,7 +302,7 @@ class LoadClip(plugin.NukeLoader):
                 "updated to version: {}".format(version_doc.get("name"))
             )
 
-        if version_data.get("retime", None):
+        if add_retime and version_data.get("retime", None):
             self._make_retimes(read_node, version_data)
         else:
             self.clear_members(read_node)

From 43424e0fa963b5506e7e60e924c750aaa9bbf4a2 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 14:28:40 +0200
Subject: [PATCH 1038/1227] creator plugin can set group label for ui

---
 openpype/pipeline/create/creator_plugins.py | 45 ++++++++++++++++-----
 1 file changed, 36 insertions(+), 9 deletions(-)

diff --git a/openpype/pipeline/create/creator_plugins.py b/openpype/pipeline/create/creator_plugins.py
index 4c7b9f8d94..8fa7b98efa 100644
--- a/openpype/pipeline/create/creator_plugins.py
+++ b/openpype/pipeline/create/creator_plugins.py
@@ -1,5 +1,4 @@
 import copy
-import logging
 
 from abc import (
     ABCMeta,
@@ -47,6 +46,9 @@ class BaseCreator:
 
     # Label shown in UI
     label = None
+    group_label = None
+    # Cached group label after first call 'get_group_label'
+    _group_label = None
 
     # Variable to store logger
     _log = None
@@ -85,11 +87,13 @@ class BaseCreator:
 
         Default implementation returns plugin's family.
         """
+
         return self.family
 
     @abstractproperty
     def family(self):
         """Family that plugin represents."""
+
         pass
 
     @property
@@ -98,6 +102,16 @@ class BaseCreator:
 
         return self.create_context.project_name
 
+    def get_group_label(self):
+        if self._group_label is None:
+            if self.group_label:
+                self._group_label = self.group_label
+            elif self.label:
+                self._group_label = self.label
+            else:
+                self._group_label = self.identifier
+        return self._group_label
+
     @property
     def log(self):
         if self._log is None:
@@ -121,6 +135,7 @@ class BaseCreator:
         - must expect all data that were passed to init in previous
             implementation
         """
+
         pass
 
     @abstractmethod
@@ -147,6 +162,7 @@ class BaseCreator:
                     self._add_instance_to_context(instance)
         ```
         """
+
         pass
 
     @abstractmethod
@@ -154,9 +170,10 @@ class BaseCreator:
         """Store changes of existing instances so they can be recollected.
 
         Args:
-            update_list(list<UpdateData>): Gets list of tuples. Each item
+            update_list(List[UpdateData]): Gets list of tuples. Each item
                 contain changed instance and it's changes.
         """
+
         pass
 
     @abstractmethod
@@ -167,9 +184,10 @@ class BaseCreator:
         'True' if did so.
 
         Args:
-            instance(list<CreatedInstance>): Instance objects which should be
+            instance(List[CreatedInstance]): Instance objects which should be
                 removed.
         """
+
         pass
 
     def get_icon(self):
@@ -177,6 +195,7 @@ class BaseCreator:
 
         Can return path to image file or awesome icon name.
         """
+
         return self.icon
 
     def get_dynamic_data(
@@ -187,6 +206,7 @@ class BaseCreator:
         These may be get dynamically created based on current context of
         workfile.
         """
+
         return {}
 
     def get_subset_name(
@@ -211,6 +231,7 @@ class BaseCreator:
             project_name(str): Project name.
             host_name(str): Which host creates subset.
         """
+
         dynamic_data = self.get_dynamic_data(
             variant, task_name, asset_doc, project_name, host_name
         )
@@ -237,9 +258,10 @@ class BaseCreator:
         keys/values when plugin attributes change.
 
         Returns:
-            list<AbtractAttrDef>: Attribute definitions that can be tweaked for
+            List[AbtractAttrDef]: Attribute definitions that can be tweaked for
                 created instance.
         """
+
         return self.instance_attr_defs
 
 
@@ -297,6 +319,7 @@ class Creator(BaseCreator):
         Returns:
             str: Short description of family.
         """
+
         return self.description
 
     def get_detail_description(self):
@@ -307,6 +330,7 @@ class Creator(BaseCreator):
         Returns:
             str: Detailed description of family for artist.
         """
+
         return self.detailed_description
 
     def get_default_variants(self):
@@ -318,8 +342,9 @@ class Creator(BaseCreator):
         By default returns `default_variants` value.
 
         Returns:
-            list<str>: Whisper variants for user input.
+            List[str]: Whisper variants for user input.
         """
+
         return copy.deepcopy(self.default_variants)
 
     def get_default_variant(self):
@@ -338,11 +363,13 @@ class Creator(BaseCreator):
         """Plugin attribute definitions needed for creation.
         Attribute definitions of plugin that define how creation will work.
         Values of these definitions are passed to `create` method.
-        NOTE:
-        Convert method should be implemented which should care about updating
-        keys/values when plugin attributes change.
+
+        Note:
+            Convert method should be implemented which should care about
+            updating keys/values when plugin attributes change.
+
         Returns:
-            list<AbtractAttrDef>: Attribute definitions that can be tweaked for
+            List[AbtractAttrDef]: Attribute definitions that can be tweaked for
                 created instance.
         """
         return self.pre_create_attr_defs

From cf23aad3cfcc13b209f683b4e6da81c261c3ebb8 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 14:28:53 +0200
Subject: [PATCH 1039/1227] instance has group_label attribute which can be
 used in UI

---
 openpype/pipeline/create/context.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index 7f0341c127..a6d3282726 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -503,6 +503,13 @@ class CreatedInstance:
             label = self.subset_name
         return label
 
+    @property
+    def group_label(self):
+        label = self._data.get("group_label")
+        if label:
+            return label
+        return self.creator.get_group_label()
+
     @property
     def creator_identifier(self):
         return self.creator.identifier

From b29973f9cc3562ec0fdf11cf704e025ea5ff7687 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 14:41:30 +0200
Subject: [PATCH 1040/1227] added some docstrings

---
 openpype/pipeline/create/creator_plugins.py | 47 ++++++++++++++++++---
 1 file changed, 42 insertions(+), 5 deletions(-)

diff --git a/openpype/pipeline/create/creator_plugins.py b/openpype/pipeline/create/creator_plugins.py
index 8fa7b98efa..49d928ded1 100644
--- a/openpype/pipeline/create/creator_plugins.py
+++ b/openpype/pipeline/create/creator_plugins.py
@@ -103,17 +103,34 @@ class BaseCreator:
         return self.create_context.project_name
 
     def get_group_label(self):
+        """Group label under which are instances grouped in UI.
+
+        Default implementation use attributes in this order:
+            - 'group_label' -> 'label' -> 'identifier'
+                Keep in mind that 'identifier' use 'family' by default.
+
+        Returns:
+            str: Group label that can be used for grouping of instances in UI.
+                Group label can be overriden by instance itself.
+        """
+
         if self._group_label is None:
+            label = self.identifier
             if self.group_label:
-                self._group_label = self.group_label
+                label = self.group_label
             elif self.label:
-                self._group_label = self.label
-            else:
-                self._group_label = self.identifier
+                label = self.label
+            self._group_label = label
         return self._group_label
 
     @property
     def log(self):
+        """Logger of the plugin.
+
+        Returns:
+            logging.Logger: Logger with name of the plugin.
+        """
+
         if self._log is None:
             from openpype.api import Logger
 
@@ -121,10 +138,30 @@ class BaseCreator:
         return self._log
 
     def _add_instance_to_context(self, instance):
-        """Helper method to ad d"""
+        """Helper method to add instance to create context.
+
+        Instances should be stored to DCC workfile metadata to be able reload
+        them and also stored to CreateContext in which is creator plugin
+        existing at the moment to be able use it without refresh of
+        CreateContext.
+
+        Args:
+            instance (CreatedInstance): New created instance.
+        """
+
         self.create_context.creator_adds_instance(instance)
 
     def _remove_instance_from_context(self, instance):
+        """Helper method to remove instance from create context.
+
+        Instances must be removed from DCC workfile metadat aand from create
+        context in which plugin is existing at the moment of removement to
+        propagate the change without restarting create context.
+
+        Args:
+            instance (CreatedInstance): Instance which should be removed.
+        """
+
         self.create_context.creator_removed_instance(instance)
 
     @abstractmethod

From d8497b4be4c554e245641856425baf98bcb68974 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 14:43:50 +0200
Subject: [PATCH 1041/1227] use group label in UI

---
 openpype/tools/publisher/widgets/card_view_widgets.py | 2 +-
 openpype/tools/publisher/widgets/list_view_widgets.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/tools/publisher/widgets/card_view_widgets.py b/openpype/tools/publisher/widgets/card_view_widgets.py
index 3c294c9c7c..b6fcee7edb 100644
--- a/openpype/tools/publisher/widgets/card_view_widgets.py
+++ b/openpype/tools/publisher/widgets/card_view_widgets.py
@@ -436,7 +436,7 @@ class InstanceCardView(AbstractInstanceView):
         instances_by_group = collections.defaultdict(list)
         identifiers_by_group = collections.defaultdict(set)
         for instance in self.controller.instances:
-            group_name = instance.creator_label
+            group_name = instance.group_label
             instances_by_group[group_name].append(instance)
             identifiers_by_group[group_name].add(
                 instance.creator_identifier
diff --git a/openpype/tools/publisher/widgets/list_view_widgets.py b/openpype/tools/publisher/widgets/list_view_widgets.py
index 1b1a19599a..2701413c7a 100644
--- a/openpype/tools/publisher/widgets/list_view_widgets.py
+++ b/openpype/tools/publisher/widgets/list_view_widgets.py
@@ -519,7 +519,7 @@ class InstanceListView(AbstractInstanceView):
         instances_by_group_name = collections.defaultdict(list)
         group_names = set()
         for instance in self.controller.instances:
-            group_label = instance.creator_label
+            group_label = instance.group_label
             group_names.add(group_label)
             instances_by_group_name[group_label].append(instance)
 

From 2e94247180b6cff6449f79dc3b6c3e8208ae4144 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 14:46:29 +0200
Subject: [PATCH 1042/1227] changed attribute name '_group_label' ->
 '_cached_group_label'

---
 openpype/pipeline/create/creator_plugins.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/pipeline/create/creator_plugins.py b/openpype/pipeline/create/creator_plugins.py
index 49d928ded1..91b9d80234 100644
--- a/openpype/pipeline/create/creator_plugins.py
+++ b/openpype/pipeline/create/creator_plugins.py
@@ -48,7 +48,7 @@ class BaseCreator:
     label = None
     group_label = None
     # Cached group label after first call 'get_group_label'
-    _group_label = None
+    _cached_group_label = None
 
     # Variable to store logger
     _log = None
@@ -114,14 +114,14 @@ class BaseCreator:
                 Group label can be overriden by instance itself.
         """
 
-        if self._group_label is None:
+        if self._cached_group_label is None:
             label = self.identifier
             if self.group_label:
                 label = self.group_label
             elif self.label:
                 label = self.label
-            self._group_label = label
-        return self._group_label
+            self._cached_group_label = label
+        return self._cached_group_label
 
     @property
     def log(self):

From dfb041d8524fe8b1cc415a5be86a49cb0148f529 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 15:06:46 +0200
Subject: [PATCH 1043/1227] timers manager is using client query functions

---
 .../modules/timers_manager/timers_manager.py  | 25 ++++++-------------
 1 file changed, 8 insertions(+), 17 deletions(-)

diff --git a/openpype/modules/timers_manager/timers_manager.py b/openpype/modules/timers_manager/timers_manager.py
index 3cf1614316..3453e4bc4c 100644
--- a/openpype/modules/timers_manager/timers_manager.py
+++ b/openpype/modules/timers_manager/timers_manager.py
@@ -2,13 +2,13 @@ import os
 import platform
 
 
+from openpype.client import get_asset_by_name
 from openpype.modules import OpenPypeModule
 from openpype_interfaces import (
     ITrayService,
     ILaunchHookPaths
 )
 from openpype.lib.events import register_event_callback
-from openpype.pipeline import AvalonMongoDB
 
 from .exceptions import InvalidContextError
 
@@ -197,22 +197,13 @@ class TimersManager(OpenPypeModule, ITrayService, ILaunchHookPaths):
                 " Project: \"{}\" Asset: \"{}\" Task: \"{}\""
             ).format(str(project_name), str(asset_name), str(task_name)))
 
-        dbconn = AvalonMongoDB()
-        dbconn.install()
-        dbconn.Session["AVALON_PROJECT"] = project_name
-
-        asset_doc = dbconn.find_one(
-            {
-                "type": "asset",
-                "name": asset_name
-            },
-            {
-                "data.tasks": True,
-                "data.parents": True
-            }
+        asset_doc = get_asset_by_name(
+            project_name,
+            asset_name,
+            fields=["_id", "name", "data.tasks", "data.parents"]
         )
+
         if not asset_doc:
-            dbconn.uninstall()
             raise InvalidContextError((
                 "Asset \"{}\" not found in project \"{}\""
             ).format(asset_name, project_name))
@@ -220,7 +211,6 @@ class TimersManager(OpenPypeModule, ITrayService, ILaunchHookPaths):
         asset_data = asset_doc.get("data") or {}
         asset_tasks = asset_data.get("tasks") or {}
         if task_name not in asset_tasks:
-            dbconn.uninstall()
             raise InvalidContextError((
                 "Task \"{}\" not found on asset \"{}\" in project \"{}\""
             ).format(task_name, asset_name, project_name))
@@ -238,9 +228,10 @@ class TimersManager(OpenPypeModule, ITrayService, ILaunchHookPaths):
         hierarchy_items = asset_data.get("parents") or []
         hierarchy_items.append(asset_name)
 
-        dbconn.uninstall()
         return {
             "project_name": project_name,
+            "asset_id": str(asset_doc["_id"]),
+            "asset_name": asset_doc["name"],
             "task_name": task_name,
             "task_type": task_type,
             "hierarchy": hierarchy_items

From 48e33db9224460f1ab72aa80a6bc775684a02ab4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Tue, 12 Jul 2022 16:02:13 +0200
Subject: [PATCH 1044/1227] Use group key

---
 openpype/pipeline/create/context.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index a6d3282726..aecdb04635 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -505,7 +505,7 @@ class CreatedInstance:
 
     @property
     def group_label(self):
-        label = self._data.get("group_label")
+        label = self._data.get("group")
         if label:
             return label
         return self.creator.get_group_label()

From dada2f4831045370265037a8b1c01c43f4dd2f92 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 16:06:35 +0200
Subject: [PATCH 1045/1227] added function which extract project name based on
 project id

---
 .../modules/kitsu/utils/update_op_with_zou.py | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index de74b0c677..c39d1c5e36 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -33,6 +33,20 @@ def create_op_asset(gazu_entity: dict) -> dict:
     }
 
 
+def get_kitsu_project_name(project_id: str):
+    """Get project name based on project id in kitsu.
+
+    Args:
+        project_id (str): Id of project in Kitsu.
+
+    Returns:
+        str: Project name which has project in Kitsu.
+    """
+
+    project = gazu.project.get_project(project_id)
+    return project["name"]
+
+
 def set_op_project(dbcon: AvalonMongoDB, project_id: str):
     """Set project context.
 
@@ -40,9 +54,8 @@ def set_op_project(dbcon: AvalonMongoDB, project_id: str):
         dbcon (AvalonMongoDB): Connection to DB
         project_id (str): Project zou ID
     """
-    project = gazu.project.get_project(project_id)
-    project_name = project["name"]
-    dbcon.Session["AVALON_PROJECT"] = project_name
+
+    dbcon.Session["AVALON_PROJECT"] = get_kitsu_project_name(project_id)
 
 
 def update_op_assets(

From b4d11d4ae709fc65f41ec9c09cbf5e52a183677c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 16:07:10 +0200
Subject: [PATCH 1046/1227] use project name function to drop project
 collection

---
 openpype/modules/kitsu/utils/sync_service.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 577050c5af..677d269bca 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -7,6 +7,7 @@ from .credentials import validate_credentials
 from .update_op_with_zou import (
     create_op_asset,
     set_op_project,
+    get_kitsu_project_name,
     write_project_to_op,
     update_op_assets,
 )
@@ -124,12 +125,11 @@ class Listener:
 
     def _delete_project(self, data):
         """Delete project."""
-        project_doc = self.dbcon.find_one(
-            {"type": "project", "data.zou_id": data["project_id"]}
-        )
+
+        project_name = get_kitsu_project_name(data["project_id"])
 
         # Delete project collection
-        self.dbcon.database[project_doc["name"]].drop()
+        self.dbcon.database[project_name].drop()
 
     # == Asset ==
 

From ee370cb7a315237608f3b60a6b6778d3fc900852 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 16:07:40 +0200
Subject: [PATCH 1047/1227] change project in session instead of replacing
 AvalonMongoDB with pymongo.Collection

---
 openpype/modules/kitsu/utils/sync_service.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 677d269bca..d93197a4bc 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -120,7 +120,7 @@ class Listener:
 
         # Write into DB
         if update_project:
-            self.dbcon = self.dbcon.database[project_name]
+            self.dbcon.Session["AVALON_PROJECT"] = project_name
             self.dbcon.bulk_write([update_project])
 
     def _delete_project(self, data):

From e2920ffdb53df5dd8d68b8800436f19edca2ff9c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 16:08:15 +0200
Subject: [PATCH 1048/1227] use query functions in sync service

---
 openpype/modules/kitsu/utils/sync_service.py | 29 +++++++++++++-------
 1 file changed, 19 insertions(+), 10 deletions(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index d93197a4bc..38c1176df9 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -2,6 +2,10 @@ import os
 
 import gazu
 
+from openpype.client import (
+    get_project,
+    get_assets
+)
 from openpype.pipeline import AvalonMongoDB
 from .credentials import validate_credentials
 from .update_op_with_zou import (
@@ -150,7 +154,8 @@ class Listener:
     def _update_asset(self, data):
         """Update asset into OP DB."""
         set_op_project(self.dbcon, data["project_id"])
-        project_doc = self.dbcon.find_one({"type": "project"})
+        project_name = self.dbcon.active_project()
+        project_doc = get_project(project_name)
 
         # Get gazu entity
         asset = gazu.asset.get_asset(data["asset_id"])
@@ -159,7 +164,7 @@ class Listener:
         # Query all assets of the local project
         zou_ids_and_asset_docs = {
             asset_doc["data"]["zou"]["id"]: asset_doc
-            for asset_doc in self.dbcon.find({"type": "asset"})
+            for asset_doc in get_assets(project_name)
             if asset_doc["data"].get("zou", {}).get("id")
         }
         zou_ids_and_asset_docs[asset["project_id"]] = project_doc
@@ -199,7 +204,8 @@ class Listener:
     def _update_episode(self, data):
         """Update episode into OP DB."""
         set_op_project(self.dbcon, data["project_id"])
-        project_doc = self.dbcon.find_one({"type": "project"})
+        project_name = self.dbcon.active_project()
+        project_doc = get_project(project_name)
 
         # Get gazu entity
         episode = gazu.shot.get_episode(data["episode_id"])
@@ -208,7 +214,7 @@ class Listener:
         # Query all assets of the local project
         zou_ids_and_asset_docs = {
             asset_doc["data"]["zou"]["id"]: asset_doc
-            for asset_doc in self.dbcon.find({"type": "asset"})
+            for asset_doc in get_assets(project_name)
             if asset_doc["data"].get("zou", {}).get("id")
         }
         zou_ids_and_asset_docs[episode["project_id"]] = project_doc
@@ -249,7 +255,8 @@ class Listener:
     def _update_sequence(self, data):
         """Update sequence into OP DB."""
         set_op_project(self.dbcon, data["project_id"])
-        project_doc = self.dbcon.find_one({"type": "project"})
+        project_name = self.dbcon.active_project()
+        project_doc = get_project(project_name)
 
         # Get gazu entity
         sequence = gazu.shot.get_sequence(data["sequence_id"])
@@ -258,7 +265,7 @@ class Listener:
         # Query all assets of the local project
         zou_ids_and_asset_docs = {
             asset_doc["data"]["zou"]["id"]: asset_doc
-            for asset_doc in self.dbcon.find({"type": "asset"})
+            for asset_doc in get_assets(project_name)
             if asset_doc["data"].get("zou", {}).get("id")
         }
         zou_ids_and_asset_docs[sequence["project_id"]] = project_doc
@@ -299,7 +306,8 @@ class Listener:
     def _update_shot(self, data):
         """Update shot into OP DB."""
         set_op_project(self.dbcon, data["project_id"])
-        project_doc = self.dbcon.find_one({"type": "project"})
+        project_name = self.dbcon.active_project()
+        project_doc = get_project(project_name)
 
         # Get gazu entity
         shot = gazu.shot.get_shot(data["shot_id"])
@@ -308,7 +316,7 @@ class Listener:
         # Query all assets of the local project
         zou_ids_and_asset_docs = {
             asset_doc["data"]["zou"]["id"]: asset_doc
-            for asset_doc in self.dbcon.find({"type": "asset"})
+            for asset_doc in get_assets(project_name)
             if asset_doc["data"].get("zou", {}).get("id")
         }
         zou_ids_and_asset_docs[shot["project_id"]] = project_doc
@@ -359,10 +367,11 @@ class Listener:
 
     def _delete_task(self, data):
         """Delete task of OP DB."""
-        set_op_project(self.dbcon, data["project_id"])
 
+        set_op_project(self.dbcon, data["project_id"])
+        project_name = self.dbcon.active_project()
         # Find asset doc
-        asset_docs = [doc for doc in self.dbcon.find({"type": "asset"})]
+        asset_docs = list(get_assets(project_name))
         for doc in asset_docs:
             # Match task
             for name, task in doc["data"]["tasks"].items():

From d393d6c8956af8365afe5309780762740ff0205c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 16:09:30 +0200
Subject: [PATCH 1049/1227] a little bit more complicated way how to get asset
 matching zou id

---
 openpype/modules/kitsu/utils/sync_service.py | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 38c1176df9..3848eda7ae 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -343,14 +343,25 @@ class Listener:
         """Create new task into OP DB."""
         # Get project entity
         set_op_project(self.dbcon, data["project_id"])
+        project_name = self.dbcon.active_project()
 
         # Get gazu entity
         task = gazu.task.get_task(data["task_id"])
 
         # Find asset doc
-        asset_doc = self.dbcon.find_one(
-            {"type": "asset", "data.zou.id": task["entity"]["id"]}
+        parent_name = task["entity"]["name"]
+        parent_zou_id = task["entity"]["id"]
+        asset_docs = get_assets(
+            project_name,
+            asset_names=[parent_name],
+            fields=["_id", "data.zou.id", "data.tasks"]
         )
+        asset_doc = None
+        for _asset_doc in asset_docs:
+            doc_zou_id = _asset_doc.get("data", {}).get("zou", {}).get("id")
+            if doc_zou_id == parent_zou_id:
+                asset_doc = _asset_doc
+                break
 
         # Update asset tasks with new one
         asset_tasks = asset_doc["data"].get("tasks")

From 20c2cedf75436e463cc6799ab1f3bcb579116abc Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 16:09:47 +0200
Subject: [PATCH 1050/1227] use query functions in op to zou sync

---
 openpype/modules/kitsu/utils/update_zou_with_op.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_zou_with_op.py b/openpype/modules/kitsu/utils/update_zou_with_op.py
index 81d421206f..b7bc418c98 100644
--- a/openpype/modules/kitsu/utils/update_zou_with_op.py
+++ b/openpype/modules/kitsu/utils/update_zou_with_op.py
@@ -6,6 +6,7 @@ from typing import List
 import gazu
 from pymongo import UpdateOne
 
+from openpype.client import get_project
 from openpype.pipeline import AvalonMongoDB
 from openpype.api import get_project_settings
 from openpype.modules.kitsu.utils.credentials import validate_credentials
@@ -53,9 +54,7 @@ def sync_zou_from_op_project(
     """
     # Get project doc if not provided
     if not project_doc:
-        project_doc = dbcon.database[project_name].find_one(
-            {"type": "project"}
-        )
+        project_doc = get_project(project_name)
 
     # Get all entities from zou
     print(f"Synchronizing {project_name}...")
@@ -96,7 +95,7 @@ def sync_zou_from_op_project(
     dbcon.Session["AVALON_PROJECT"] = project_name
     asset_docs = {
         asset_doc["_id"]: asset_doc
-        for asset_doc in dbcon.find({"type": "asset"})
+        for asset_doc in get_assets(project_name)
     }
 
     # Create new assets

From 96863fa8aed63dee0b72f6a38e532525f5b6863d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 16:10:37 +0200
Subject: [PATCH 1051/1227] use query functions in zou to op sync

---
 .../modules/kitsu/utils/update_op_with_zou.py | 23 +++++++++++--------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index c39d1c5e36..86dee3ce65 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -10,6 +10,12 @@ from gazu.task import (
     all_tasks_for_shot,
 )
 
+from openpype.client import (
+    get_project,
+    get_assets,
+    get_asset_by_id,
+    get_asset_by_name
+)
 from openpype.pipeline import AvalonMongoDB
 from openpype.api import get_project_settings
 from openpype.lib import create_project
@@ -85,9 +91,7 @@ def update_op_assets(
         if not item_doc:  # Create asset
             op_asset = create_op_asset(item)
             insert_result = dbcon.insert_one(op_asset)
-            item_doc = dbcon.find_one(
-                {"type": "asset", "_id": insert_result.inserted_id}
-            )
+            item_doc = get_asset_by_id(project_name, insert_result.inserted_id)
 
         # Update asset
         item_data = deepcopy(item_doc["data"])
@@ -235,7 +239,7 @@ def write_project_to_op(project: dict, dbcon: AvalonMongoDB) -> UpdateOne:
         UpdateOne: Update instance for the project
     """
     project_name = project["name"]
-    project_doc = dbcon.database[project_name].find_one({"type": "project"})
+    project_doc = get_project(project_name)
     if not project_doc:
         print(f"Creating project '{project_name}'")
         project_doc = create_project(project_name, project_name, dbcon=dbcon)
@@ -332,19 +336,20 @@ def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
     bulk_writes.append(write_project_to_op(project, dbcon))
 
     # Try to find project document
-    dbcon.Session["AVALON_PROJECT"] = project["name"]
-    project_doc = dbcon.find_one({"type": "project"})
+    project_name = project["name"]
+    dbcon.Session["AVALON_PROJECT"] = project_name
+    project_doc = get_project(project_name)
 
     # Query all assets of the local project
     zou_ids_and_asset_docs = {
         asset_doc["data"]["zou"]["id"]: asset_doc
-        for asset_doc in dbcon.find({"type": "asset"})
+        for asset_doc in get_assets(project_name)
         if asset_doc["data"].get("zou", {}).get("id")
     }
     zou_ids_and_asset_docs[project["id"]] = project_doc
 
     # Create entities root folders
-    project_module_settings = get_project_settings(project["name"])["kitsu"]
+    project_module_settings = get_project_settings(project_name)["kitsu"]
     for entity_type, root in project_module_settings["entities_root"].items():
         parent_folders = root.split("/")
         direct_parent_doc = None
@@ -384,7 +389,7 @@ def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
         zou_ids_and_asset_docs.update(
             {
                 asset_doc["data"]["zou"]["id"]: asset_doc
-                for asset_doc in dbcon.find({"type": "asset"})
+                for asset_doc in get_assets(projec_name)
                 if asset_doc["data"].get("zou")
             }
         )

From 767dc3dbaba27063289c6853c306acdda8493869 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 16:11:26 +0200
Subject: [PATCH 1052/1227] a little bit more complicated queries using zou id

---
 .../modules/kitsu/utils/update_op_with_zou.py | 53 +++++++++++++++----
 1 file changed, 44 insertions(+), 9 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 86dee3ce65..bf3705447c 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -179,14 +179,32 @@ def update_op_assets(
         )
         if visual_parent_doc_id is None:
             # Find root folder doc
-            root_folder_doc = dbcon.find_one(
-                {
-                    "type": "asset",
-                    "name": entity_parent_folders[-1],
-                    "data.root_of": substitute_item_type,
-                },
-                ["_id"],
+            root_folder_docs = get_assets(
+                project_name,
+                asset_name=[entity_parent_folders[-1]],
+                fields=["_id", "data.root_of"]
             )
+            # NOTE: Not sure why it's checking for entity type?
+            #   OP3 does not support multiple assets with same names so type
+            #       filtering is irelevant.
+            # This way mimics previous implementation:
+            # ```
+            # root_folder_doc = dbcon.find_one(
+            #     {
+            #         "type": "asset",
+            #         "name": entity_parent_folders[-1],
+            #         "data.root_of": substitute_item_type,
+            #     },
+            #     ["_id"],
+            # )
+            # ```
+            root_folder_doc = None
+            for folder_doc in root_folder_docs:
+                root_of = folder_doc.get("data", {}).get("root_of")
+                if root_of == substitute_item_type:
+                    root_folder_doc = folder_doc
+                    break
+
             if root_folder_doc:
                 visual_parent_doc_id = root_folder_doc["_id"]
 
@@ -354,9 +372,26 @@ def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
         parent_folders = root.split("/")
         direct_parent_doc = None
         for i, folder in enumerate(parent_folders, 1):
-            parent_doc = dbcon.find_one(
-                {"type": "asset", "name": folder, "data.root_of": entity_type}
+            parent_doc = get_asset_by_name(
+                project_name, folder, fields=["_id", "data.root_of"]
             )
+            # NOTE: Not sure why it's checking for entity type?
+            #   OP3 does not support multiple assets with same names so type
+            #       filtering is irelevant.
+            #   Also all of the entities could find be queried at once using
+            #       'get_assets'.
+            # This way mimics previous implementation:
+            # ```
+            # parent_doc = dbcon.find_one(
+            #   {"type": "asset", "name": folder, "data.root_of": entity_type}
+            # )
+            # ```
+            if (
+                parent_doc
+                and parent_doc.get("data", {}).get("root_of") != entity_type
+            ):
+                parent_doc = None
+
             if not parent_doc:
                 direct_parent_doc = dbcon.insert_one(
                     {

From 498ed608ebce7d639fcc091da979307f0f21da62 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 12 Jul 2022 16:24:22 +0200
Subject: [PATCH 1053/1227] nuke: setting loader option defaults from settings

---
 openpype/hosts/nuke/plugins/load/load_clip.py | 36 ++++++++-------
 .../defaults/project_settings/nuke.json       |  6 ++-
 .../schemas/schema_nuke_load.json             | 46 ++++++++++++++++++-
 3 files changed, 68 insertions(+), 20 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/load/load_clip.py b/openpype/hosts/nuke/plugins/load/load_clip.py
index e9530c58c0..43dd5a66eb 100644
--- a/openpype/hosts/nuke/plugins/load/load_clip.py
+++ b/openpype/hosts/nuke/plugins/load/load_clip.py
@@ -54,26 +54,28 @@ class LoadClip(plugin.NukeLoader):
     script_start = int(nuke.root()["first_frame"].value())
 
     # option gui
-    defaults = {
+    options_defaults = {
         "start_at_workfile": True,
         "add_retime": True
     }
 
-    options = [
-        qargparse.Boolean(
-            "start_at_workfile",
-            help="Load at workfile start frame",
-            default=True
-        ),
-        qargparse.Boolean(
-            "add_retime",
-            help="Load with retime",
-            default=True
-        )
-    ]
-
     node_name_template = "{class_name}_{ext}"
 
+    @classmethod
+    def get_options(cls, *args):
+        return [
+            qargparse.Boolean(
+                "start_at_workfile",
+                help="Load at workfile start frame",
+                default=cls.options_defaults["start_at_workfile"]
+            ),
+            qargparse.Boolean(
+                "add_retime",
+                help="Load with retime",
+                default=cls.options_defaults["add_retime"]
+            )
+        ]
+
     @classmethod
     def get_representations(cls):
         return (
@@ -92,10 +94,10 @@ class LoadClip(plugin.NukeLoader):
         file = self.fname.replace("\\", "/")
 
         start_at_workfile = options.get(
-            "start_at_workfile", self.defaults["start_at_workfile"])
+            "start_at_workfile", self.options_defaults["start_at_workfile"])
 
         add_retime = options.get(
-            "add_retime", self.defaults["add_retime"])
+            "add_retime", self.options_defaults["add_retime"])
 
         version = context['version']
         version_data = version.get("data", {})
@@ -214,7 +216,7 @@ class LoadClip(plugin.NukeLoader):
 
         # TODO: find `addRetime` add openpipe data
         # add_retime = options.get(
-        #     "add_retime", self.defaults["add_retime"])
+        #     "add_retime", self.options_defaults["add_retime"])
 
         project_name = legacy_io.active_project()
         version_doc = get_version_by_id(project_name, representation["parent"])
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 6c45e2a9c1..3e29122074 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -287,7 +287,11 @@
         "LoadClip": {
             "enabled": true,
             "_representations": [],
-            "node_name_template": "{class_name}_{ext}"
+            "node_name_template": "{class_name}_{ext}",
+            "options_defaults": {
+                "start_at_workfile": true,
+                "add_retime": true
+            }
         }
     },
     "workfile_builder": {
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_load.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_load.json
index 5bd8337e4c..805424c632 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_load.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_load.json
@@ -11,10 +11,52 @@
                 {
                     "key": "LoadImage",
                     "label": "Image Loader"
+                }
+            ]
+        },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "LoadClip",
+            "label": "Clip Loader",
+            "checkbox_key": "enabled",
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
                 },
                 {
-                    "key": "LoadClip",
-                    "label": "Clip Loader"
+                    "type": "list",
+                    "key": "_representations",
+                    "label": "Representations",
+                    "object_type": "text"
+                },
+                {
+                    "type": "text",
+                    "key": "node_name_template",
+                    "label": "Node name template"
+                },
+                {
+                    "type": "splitter"
+                },
+                {
+                    "type": "dict",
+                    "collapsible": false,
+                    "key": "options_defaults",
+                    "label": "Loader option defaults",
+                    "children": [
+                        {
+                            "type": "boolean",
+                            "key": "start_at_workfile",
+                            "label": "Start at worfile beggining"
+                        },
+                        {
+                            "type": "boolean",
+                            "key": "add_retime",
+                            "label": "Add retime"
+                        }
+                    ]
                 }
             ]
         }

From d04e95e28f9a206c4a7390a7a1c82f418736b7c9 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 12 Jul 2022 16:48:39 +0200
Subject: [PATCH 1054/1227] nuke: updating clip with retime options

---
 openpype/hosts/nuke/plugins/load/load_clip.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/load/load_clip.py b/openpype/hosts/nuke/plugins/load/load_clip.py
index 43dd5a66eb..b2dc4a52d7 100644
--- a/openpype/hosts/nuke/plugins/load/load_clip.py
+++ b/openpype/hosts/nuke/plugins/load/load_clip.py
@@ -212,11 +212,12 @@ class LoadClip(plugin.NukeLoader):
         read_node = nuke.toNode(container['objectName'])
         file = get_representation_path(representation).replace("\\", "/")
 
-        start_at_workfile = bool("start at" in read_node['frame_mode'].value())
+        start_at_workfile = "start at" in read_node['frame_mode'].value()
 
-        # TODO: find `addRetime` add openpipe data
-        # add_retime = options.get(
-        #     "add_retime", self.options_defaults["add_retime"])
+        add_retime = [
+            key for key in read_node.knobs().keys()
+            if "addRetime" in key
+        ]
 
         project_name = legacy_io.active_project()
         version_doc = get_version_by_id(project_name, representation["parent"])

From 2988af04ffcd1a42a4ca40fe4a2dbe80f163ffff Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 16:57:49 +0200
Subject: [PATCH 1055/1227] added missing import

---
 openpype/modules/kitsu/utils/update_zou_with_op.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_zou_with_op.py b/openpype/modules/kitsu/utils/update_zou_with_op.py
index b7bc418c98..57d7094e95 100644
--- a/openpype/modules/kitsu/utils/update_zou_with_op.py
+++ b/openpype/modules/kitsu/utils/update_zou_with_op.py
@@ -6,7 +6,7 @@ from typing import List
 import gazu
 from pymongo import UpdateOne
 
-from openpype.client import get_project
+from openpype.client import get_project, get_assets
 from openpype.pipeline import AvalonMongoDB
 from openpype.api import get_project_settings
 from openpype.modules.kitsu.utils.credentials import validate_credentials

From 5e14a54d8248b7ddb3f02b778d89ca4a391f15c8 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 17:02:54 +0200
Subject: [PATCH 1056/1227] fix typo

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index bf3705447c..f56a131b8e 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -424,7 +424,7 @@ def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
         zou_ids_and_asset_docs.update(
             {
                 asset_doc["data"]["zou"]["id"]: asset_doc
-                for asset_doc in get_assets(projec_name)
+                for asset_doc in get_assets(project_name)
                 if asset_doc["data"].get("zou")
             }
         )

From 9d4d8873358bcb6fde08e46817f47a09d858c68d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 17:13:50 +0200
Subject: [PATCH 1057/1227] keep mismatch target plugins in report

---
 openpype/pipeline/create/context.py | 10 ++++++++++
 openpype/tools/publisher/control.py | 15 +++++++++------
 2 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index 7f0341c127..ac345ea47b 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -709,6 +709,7 @@ class CreateContext:
         self.manual_creators = {}
 
         self.publish_discover_result = None
+        self.publish_plugins_mismatch_targets = []
         self.publish_plugins = []
         self.plugins_with_defs = []
         self._attr_plugins_by_family = {}
@@ -831,6 +832,7 @@ class CreateContext:
         discover_result = DiscoverResult()
         plugins_with_defs = []
         plugins_by_targets = []
+        plugins_mismatch_targets = []
         if discover_publish_plugins:
             discover_result = publish_plugins_discover()
             publish_plugins = discover_result.plugins
@@ -840,11 +842,19 @@ class CreateContext:
             plugins_by_targets = pyblish.logic.plugins_by_targets(
                 publish_plugins, list(targets)
             )
+
             # Collect plugins that can have attribute definitions
             for plugin in publish_plugins:
                 if OpenPypePyblishPluginMixin in inspect.getmro(plugin):
                     plugins_with_defs.append(plugin)
 
+            plugins_mismatch_targets = [
+                plugin
+                for plugin in publish_plugins
+                if plugin not in plugins_by_targets
+            ]
+
+        self.publish_plugins_mismatch_targets = plugins_mismatch_targets
         self.publish_discover_result = discover_result
         self.publish_plugins = plugins_by_targets
         self.plugins_with_defs = plugins_with_defs
diff --git a/openpype/tools/publisher/control.py b/openpype/tools/publisher/control.py
index 915fb7f32e..f692bb4000 100644
--- a/openpype/tools/publisher/control.py
+++ b/openpype/tools/publisher/control.py
@@ -154,15 +154,20 @@ class PublishReport:
         self._all_instances_by_id = {}
         self._current_context = None
 
-    def reset(self, context, publish_discover_result=None):
+    def reset(self, context, create_context):
         """Reset report and clear all data."""
-        self._publish_discover_result = publish_discover_result
+
+        self._publish_discover_result = create_context.publish_discover_result
         self._plugin_data = []
         self._plugin_data_with_plugin = []
         self._current_plugin_data = {}
         self._all_instances_by_id = {}
         self._current_context = context
 
+        for plugin in create_context.publish_plugins_mismatch_targets:
+            plugin_data = self._add_plugin_data_item(plugin)
+            plugin_data["skipped"] = True
+
     def add_plugin_iter(self, plugin, context):
         """Add report about single iteration of plugin."""
         for instance in context:
@@ -205,6 +210,7 @@ class PublishReport:
             "name": plugin.__name__,
             "label": label,
             "order": plugin.order,
+            "targets": list(plugin.targets),
             "instances_data": [],
             "actions_data": [],
             "skipped": False,
@@ -777,10 +783,7 @@ class PublisherController:
         # - pop the key after first collector using it would be safest option?
         self._publish_context.data["create_context"] = self.create_context
 
-        self._publish_report.reset(
-            self._publish_context,
-            self.create_context.publish_discover_result
-        )
+        self._publish_report.reset(self._publish_context, self.create_context)
         self._publish_validation_errors = []
         self._publish_current_plugin_validation_errors = None
         self._publish_error = None

From 8a951ee60f837dbce81442574f922691707ce614 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 17:27:47 +0200
Subject: [PATCH 1058/1227] removed GlobalEvent

---
 openpype/lib/events.py | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/openpype/lib/events.py b/openpype/lib/events.py
index 3762cec9f9..4a7d648a7e 100644
--- a/openpype/lib/events.py
+++ b/openpype/lib/events.py
@@ -253,13 +253,6 @@ class EventSystem(object):
             self._registered_callbacks.remove(callback)
 
 
-class GlobalEvent(Event):
-    def __init__(self, topic, data=None, source=None):
-        event_system = GlobalEventSystem.get_global_event_system()
-
-        super(GlobalEvent, self).__init__(topic, data, source, event_system)
-
-
 class GlobalEventSystem:
     _global_event_system = None
 
@@ -276,7 +269,7 @@ class GlobalEventSystem:
 
     @classmethod
     def emit(cls, topic, data, source):
-        event = GlobalEvent(topic, data, source)
+        event = Event(topic, data, source, cls.get_global_event_system())
         event.emit()
         return event
 

From 8ab6b41db5689312c39e07426fda869d9c2cc421 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 17:34:51 +0200
Subject: [PATCH 1059/1227] simplified global event emit

---
 openpype/lib/events.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/openpype/lib/events.py b/openpype/lib/events.py
index 4a7d648a7e..215e36bc4e 100644
--- a/openpype/lib/events.py
+++ b/openpype/lib/events.py
@@ -180,7 +180,10 @@ class Event(object):
         topic (str): Identifier of event.
         data (Any): Data specific for event. Dictionary is recommended.
         source (str): Identifier of source.
+        event_system (EventSystem): Event system in which can be event
+            triggered.
     """
+
     _data = {}
 
     def __init__(self, topic, data=None, source=None, event_system=None):
@@ -269,9 +272,8 @@ class GlobalEventSystem:
 
     @classmethod
     def emit(cls, topic, data, source):
-        event = Event(topic, data, source, cls.get_global_event_system())
-        event.emit()
-        return event
+        event_system = cls.get_global_event_system()
+        return event_system.emit(topic, data, source)
 
 
 def register_event_callback(topic, callback):

From 804bb9b3382970088581f07f2a3492f0fa59bfe7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 17:48:55 +0200
Subject: [PATCH 1060/1227] fix group accessing

---
 openpype/tools/publisher/widgets/card_view_widgets.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/openpype/tools/publisher/widgets/card_view_widgets.py b/openpype/tools/publisher/widgets/card_view_widgets.py
index b6fcee7edb..fc8bb2af10 100644
--- a/openpype/tools/publisher/widgets/card_view_widgets.py
+++ b/openpype/tools/publisher/widgets/card_view_widgets.py
@@ -98,6 +98,7 @@ class GroupWidget(QtWidgets.QWidget):
             instances(list<CreatedInstance>): List of instances in
                 CreateContext.
         """
+    
         # Store instances by id and by subset name
         instances_by_id = {}
         instances_by_subset_name = collections.defaultdict(list)
@@ -142,6 +143,7 @@ class GroupWidget(QtWidgets.QWidget):
 
 class CardWidget(BaseClickableFrame):
     """Clickable card used as bigger button."""
+
     selected = QtCore.Signal(str, str)
     # Group identifier of card
     # - this must be set because if send when mouse is released with card id
@@ -178,6 +180,7 @@ class ContextCardWidget(CardWidget):
 
     Is not visually under group widget and is always at the top of card view.
     """
+
     def __init__(self, parent):
         super(ContextCardWidget, self).__init__(parent)
 
@@ -204,13 +207,14 @@ class ContextCardWidget(CardWidget):
 
 class InstanceCardWidget(CardWidget):
     """Card widget representing instance."""
+
     active_changed = QtCore.Signal()
 
     def __init__(self, instance, group_icon, parent):
         super(InstanceCardWidget, self).__init__(parent)
 
         self._id = instance.id
-        self._group_identifier = instance.creator_label
+        self._group_identifier = instance.group_label
         self._group_icon = group_icon
 
         self.instance = instance

From fde803e6ef4de6c33503e6dc8cc785ae2a9d9649 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 17:49:10 +0200
Subject: [PATCH 1061/1227] set line edit on comboboxes

---
 openpype/widgets/attribute_defs/widgets.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/openpype/widgets/attribute_defs/widgets.py b/openpype/widgets/attribute_defs/widgets.py
index b6493b80a8..63d40e2df1 100644
--- a/openpype/widgets/attribute_defs/widgets.py
+++ b/openpype/widgets/attribute_defs/widgets.py
@@ -374,6 +374,10 @@ class EnumAttrWidget(_BaseAttrDefWidget):
         combo_delegate = QtWidgets.QStyledItemDelegate(input_widget)
         input_widget.setItemDelegate(combo_delegate)
 
+        line_edit = QtWidgets.QLineEdit(input_widget)
+        line_edit.setReadOnly(True)
+        input_widget.setLineEdit(line_edit)
+
         if self.attr_def.tooltip:
             input_widget.setToolTip(self.attr_def.tooltip)
 
@@ -408,7 +412,8 @@ class EnumAttrWidget(_BaseAttrDefWidget):
                 self._input_widget.setCurrentIndex(idx)
 
         else:
-            self._input_widget.lineEdit().setText("Multiselection")
+            line_edit = self._input_widget.lineEdit()
+            line_edit.setText("Multiselection")
 
 
 class UnknownAttrWidget(_BaseAttrDefWidget):

From bfd565e29d40f0daca2ddbdb01d036d9dc6b543a Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 12 Jul 2022 17:57:07 +0200
Subject: [PATCH 1062/1227] OP-3446 - add traypublisher to host enum

---
 openpype/settings/entities/enum_entity.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/settings/entities/enum_entity.py b/openpype/settings/entities/enum_entity.py
index 92a397afba..03998677ce 100644
--- a/openpype/settings/entities/enum_entity.py
+++ b/openpype/settings/entities/enum_entity.py
@@ -169,6 +169,7 @@ class HostsEnumEntity(BaseEnumEntity):
         "tvpaint",
         "unreal",
         "standalonepublisher",
+        "traypublisher",
         "webpublisher"
     ]
 

From 4fe4ac163e96d7a08cce31d30a8d8fdb85b35cc1 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 12 Jul 2022 17:57:47 +0200
Subject: [PATCH 1063/1227] OP-3446 - add traypublisher ftrack setting

---
 .../defaults/project_settings/ftrack.json     | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/ftrack.json b/openpype/settings/defaults/project_settings/ftrack.json
index 831c34835e..eb90778353 100644
--- a/openpype/settings/defaults/project_settings/ftrack.json
+++ b/openpype/settings/defaults/project_settings/ftrack.json
@@ -268,6 +268,49 @@
                         }
                     ]
                 },
+                {
+                    "hosts": [
+                        "traypublisher"
+                    ],
+                    "families": [],
+                    "task_types": [],
+                    "tasks": [],
+                    "add_ftrack_family": true,
+                    "advanced_filtering": []
+                },
+                {
+                    "hosts": [
+                        "traypublisher"
+                    ],
+                    "families": [
+                        "matchmove",
+                        "shot"
+                    ],
+                    "task_types": [],
+                    "tasks": [],
+                    "add_ftrack_family": false,
+                    "advanced_filtering": []
+                },
+                {
+                    "hosts": [
+                        "traypublisher"
+                    ],
+                    "families": [
+                        "plate"
+                    ],
+                    "task_types": [],
+                    "tasks": [],
+                    "add_ftrack_family": false,
+                    "advanced_filtering": [
+                        {
+                            "families": [
+                                "clip",
+                                "review"
+                            ],
+                            "add_ftrack_family": true
+                        }
+                    ]
+                },
                 {
                     "hosts": [
                         "maya"

From cec639cf7ed62ed28b37c4839752e72d0e845e9b Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 12 Jul 2022 18:04:55 +0200
Subject: [PATCH 1064/1227] OP-3446 - updated settings for TrayPublisher

---
 .../project_settings/traypublisher.json       |  6 ---
 .../schema_project_traypublisher.json         | 39 -------------------
 2 files changed, 45 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/traypublisher.json b/openpype/settings/defaults/project_settings/traypublisher.json
index 36526d01b0..cb3d3d1d1a 100644
--- a/openpype/settings/defaults/project_settings/traypublisher.json
+++ b/openpype/settings/defaults/project_settings/traypublisher.json
@@ -33,13 +33,7 @@
         }
     ],
     "BatchMovCreator": {
-        "family": "render_mov_batch",
-        "identifier": "",
-        "label": "Batch Mov",
-        "icon": "fa.file",
         "default_variants": ["Main"],
-        "description": "",
-        "detailed_description": "",
         "default_tasks": ["Compositing"],
         "extensions": [
             ".mov"
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
index 308883d46f..d4ad57767a 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
@@ -87,28 +87,6 @@
             "use_label_wrap": true,
             "collapsible_key": true,
             "children": [
-                {
-                    "type": "text",
-                    "key": "family",
-                    "label": "Family"
-                },
-                {
-                    "type": "text",
-                    "key": "identifier",
-                    "label": "Identifier",
-                    "placeholder": "< Use 'Family' >",
-                    "tooltip": "All creators must have unique identifier.\nBy default is used 'family' but if you need to have more creators with same families\nyou have to set identifier too."
-                },
-                {
-                    "type": "text",
-                    "key": "label",
-                    "label": "Label"
-                },
-                {
-                    "type": "text",
-                    "key": "icon",
-                    "label": "Icon"
-                },
                 {
                     "type": "list",
                     "key": "default_variants",
@@ -117,23 +95,6 @@
                         "type": "text"
                     }
                 },
-                {
-                    "type": "separator"
-                },
-                {
-                    "type": "text",
-                    "key": "description",
-                    "label": "Description"
-                },
-                {
-                    "type": "text",
-                    "key": "detailed_description",
-                    "label": "Detailed Description",
-                    "multiline": true
-                },
-                {
-                    "type": "separator"
-                },
                 {
                     "type": "list",
                     "key": "default_tasks",

From 018896f9239f3fb3a036512a892a8f48593dca85 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 18:28:03 +0200
Subject: [PATCH 1065/1227] added docstrings

---
 openpype/lib/events.py | 57 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/openpype/lib/events.py b/openpype/lib/events.py
index 215e36bc4e..301d62e2a6 100644
--- a/openpype/lib/events.py
+++ b/openpype/lib/events.py
@@ -229,23 +229,74 @@ class Event(object):
 
 
 class EventSystem(object):
+    """Encapsulate event handling into an object.
+
+    System wraps registered callbacks and triggered events into single object
+    so it is possible to create mutltiple independent systems that have their
+    topics and callbacks.
+
+
+    """
+
     def __init__(self):
         self._registered_callbacks = []
 
     def add_callback(self, topic, callback):
+        """Register callback in event system.
+
+        Args:
+            topic (str): Topic for EventCallback.
+            callback (Callable): Function or method that will be called
+                when topic is triggered.
+
+        Returns:
+            EventCallback: Created callback object which can be used to
+                stop listening.
+        """
+
         callback = EventCallback(topic, callback)
         self._registered_callbacks.append(callback)
         return callback
 
     def create_event(self, topic, data, source):
+        """Create new event which is bound to event system.
+
+        Args:
+            topic (str): Event topic.
+            data (dict): Data related to event.
+            source (str): Source of event.
+
+        Returns:
+            Event: Object of event.
+        """
+
         return Event(topic, data, source, self)
 
     def emit(self, topic, data, source):
+        """Create event based on passed data and emit it.
+
+        This is easiest way how to trigger event in an event system.
+
+        Args:
+            topic (str): Event topic.
+            data (dict): Data related to event.
+            source (str): Source of event.
+
+        Returns:
+            Event: Created and emitted event.
+        """
+
         event = self.create_event(topic, data, source)
         event.emit()
         return event
 
     def emit_event(self, event):
+        """Emit event object.
+
+        Args:
+            event (Event): Prepared event with topic and data.
+        """
+
         invalid_callbacks = []
         for callback in self._registered_callbacks:
             callback.process_event(event)
@@ -257,6 +308,12 @@ class EventSystem(object):
 
 
 class GlobalEventSystem:
+    """Event system living in global scope of process.
+
+    This is primarily used in host implementation to trigger events
+    related to DCC changes or changes of context in the host implementation.
+    """
+
     _global_event_system = None
 
     @classmethod

From e8f30eea9a8914ed09360d56bcd7b2a60d8367fc Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Tue, 12 Jul 2022 18:30:46 +0200
Subject: [PATCH 1066/1227] Added typing notation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Félix David <felixg.david@gmail.com>
---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index f56a131b8e..a68d6d31c3 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -39,7 +39,7 @@ def create_op_asset(gazu_entity: dict) -> dict:
     }
 
 
-def get_kitsu_project_name(project_id: str):
+def get_kitsu_project_name(project_id: str)->str:
     """Get project name based on project id in kitsu.
 
     Args:

From 77ffca938a7cd4a3600dd8167bf4e2f346c11fd7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 18:53:58 +0200
Subject: [PATCH 1067/1227] make enum line edit transparent for mouse

---
 openpype/widgets/attribute_defs/widgets.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/widgets/attribute_defs/widgets.py b/openpype/widgets/attribute_defs/widgets.py
index 63d40e2df1..7a7035317b 100644
--- a/openpype/widgets/attribute_defs/widgets.py
+++ b/openpype/widgets/attribute_defs/widgets.py
@@ -376,6 +376,7 @@ class EnumAttrWidget(_BaseAttrDefWidget):
 
         line_edit = QtWidgets.QLineEdit(input_widget)
         line_edit.setReadOnly(True)
+        line_edit.setAttribute(QtCore.Qt.WA_TransparentForMouseEvents)
         input_widget.setLineEdit(line_edit)
 
         if self.attr_def.tooltip:
@@ -413,7 +414,7 @@ class EnumAttrWidget(_BaseAttrDefWidget):
 
         else:
             line_edit = self._input_widget.lineEdit()
-            line_edit.setText("Multiselection")
+            line_edit.setText("< Multiselection> ")
 
 
 class UnknownAttrWidget(_BaseAttrDefWidget):

From 81469cbc54126487a1d3e35d78d36294a966ed14 Mon Sep 17 00:00:00 2001
From: iLLiCiTiT <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 23:25:44 +0200
Subject: [PATCH 1068/1227] implemented combobox that can have custom text

---
 openpype/tools/utils/__init__.py |  2 ++
 openpype/tools/utils/widgets.py  | 22 ++++++++++++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/openpype/tools/utils/__init__.py b/openpype/tools/utils/__init__.py
index 0f367510bd..5ccc1b40b3 100644
--- a/openpype/tools/utils/__init__.py
+++ b/openpype/tools/utils/__init__.py
@@ -1,4 +1,5 @@
 from .widgets import (
+    CustomTextComboBox,
     PlaceholderLineEdit,
     BaseClickableFrame,
     ClickableFrame,
@@ -28,6 +29,7 @@ from .overlay_messages import (
 
 
 __all__ = (
+    "CustomTextComboBox",
     "PlaceholderLineEdit",
     "BaseClickableFrame",
     "ClickableFrame",
diff --git a/openpype/tools/utils/widgets.py b/openpype/tools/utils/widgets.py
index d5ae909be8..df0d349822 100644
--- a/openpype/tools/utils/widgets.py
+++ b/openpype/tools/utils/widgets.py
@@ -11,6 +11,28 @@ from openpype.style import (
 log = logging.getLogger(__name__)
 
 
+class CustomTextComboBox(QtWidgets.QComboBox):
+    """Combobox which can have different text showed."""
+
+    def __init__(self, *args, **kwargs):
+        self._custom_text = None
+        super(CustomTextComboBox, self).__init__(*args, **kwargs)
+
+    def set_custom_text(self, text=None):
+        if self._custom_text != text:
+            self._custom_text = text
+            self.repaint()
+
+    def paintEvent(self, event):
+        painter = QtWidgets.QStylePainter(self)
+        option = QtWidgets.QStyleOptionComboBox()
+        self.initStyleOption(option)
+        if self._custom_text is not None:
+            option.currentText = self._custom_text
+        painter.drawComplexControl(QtWidgets.QStyle.CC_ComboBox, option)
+        painter.drawControl(QtWidgets.QStyle.CE_ComboBoxLabel, option)
+
+
 class PlaceholderLineEdit(QtWidgets.QLineEdit):
     """Set placeholder color of QLineEdit in Qt 5.12 and higher."""
     def __init__(self, *args, **kwargs):

From cc893a64b44a297f218050e816a37bd6e1d9f583 Mon Sep 17 00:00:00 2001
From: iLLiCiTiT <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 23:26:09 +0200
Subject: [PATCH 1069/1227] use combobox with custom text in EnumAttrWidget

---
 openpype/widgets/attribute_defs/widgets.py | 24 ++++++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/openpype/widgets/attribute_defs/widgets.py b/openpype/widgets/attribute_defs/widgets.py
index 7a7035317b..e4c4aba170 100644
--- a/openpype/widgets/attribute_defs/widgets.py
+++ b/openpype/widgets/attribute_defs/widgets.py
@@ -15,6 +15,7 @@ from openpype.lib.attribute_definitions import (
     UISeparatorDef,
     UILabelDef
 )
+from openpype.tools.utils import CustomTextComboBox
 from openpype.widgets.nice_checkbox import NiceCheckbox
 
 from .files_widget import FilesWidget
@@ -369,8 +370,12 @@ class BoolAttrWidget(_BaseAttrDefWidget):
 
 
 class EnumAttrWidget(_BaseAttrDefWidget):
+    def __init__(self, *args, **kwargs):
+        self._multivalue = False
+        super(EnumAttrWidget, self).__init__(*args, **kwargs)
+
     def _ui_init(self):
-        input_widget = QtWidgets.QComboBox(self)
+        input_widget = CustomTextComboBox(self)
         combo_delegate = QtWidgets.QStyledItemDelegate(input_widget)
         input_widget.setItemDelegate(combo_delegate)
 
@@ -399,6 +404,9 @@ class EnumAttrWidget(_BaseAttrDefWidget):
 
     def _on_value_change(self):
         new_value = self.current_value()
+        if self._multivalue:
+            self._multivalue = False
+            self._input_widget.set_custom_text(None)
         self.value_changed.emit(new_value, self.attr_def.id)
 
     def current_value(self):
@@ -406,15 +414,23 @@ class EnumAttrWidget(_BaseAttrDefWidget):
         return self._input_widget.itemData(idx)
 
     def set_value(self, value, multivalue=False):
+        if multivalue:
+            set_value = set(value)
+            if len(set_value) == 1:
+                multivalue = False
+                value = tuple(set_value)[0]
+
         if not multivalue:
             idx = self._input_widget.findData(value)
             cur_idx = self._input_widget.currentIndex()
             if idx != cur_idx and idx >= 0:
                 self._input_widget.setCurrentIndex(idx)
 
-        else:
-            line_edit = self._input_widget.lineEdit()
-            line_edit.setText("< Multiselection> ")
+        custom_text = None
+        if multivalue:
+            custom_text = "< Multiselection >"
+        self._input_widget.set_custom_text(custom_text)
+        self._multivalue = multivalue
 
 
 class UnknownAttrWidget(_BaseAttrDefWidget):

From 9811e8a1d5dc586e7b3e7786e03bc5c0ef2f3974 Mon Sep 17 00:00:00 2001
From: iLLiCiTiT <jakub.trllo@gmail.com>
Date: Tue, 12 Jul 2022 23:37:51 +0200
Subject: [PATCH 1070/1227] fix empty line

---
 openpype/tools/publisher/widgets/card_view_widgets.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/tools/publisher/widgets/card_view_widgets.py b/openpype/tools/publisher/widgets/card_view_widgets.py
index fc8bb2af10..04df85b0fb 100644
--- a/openpype/tools/publisher/widgets/card_view_widgets.py
+++ b/openpype/tools/publisher/widgets/card_view_widgets.py
@@ -98,7 +98,7 @@ class GroupWidget(QtWidgets.QWidget):
             instances(list<CreatedInstance>): List of instances in
                 CreateContext.
         """
-    
+
         # Store instances by id and by subset name
         instances_by_id = {}
         instances_by_subset_name = collections.defaultdict(list)

From 0222a1518d1131e31d586f47dbf4f11b1c1ebbd0 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Wed, 13 Jul 2022 03:57:50 +0000
Subject: [PATCH 1071/1227] [Automated] Bump version

---
 CHANGELOG.md        | 30 +++++++++++-------------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 13 insertions(+), 21 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9a0c058f73..55ee51b38a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## [3.12.1-nightly.4](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.1-nightly.5](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.0...HEAD)
 
@@ -14,6 +14,9 @@
 
 **🚀 Enhancements**
 
+- TrayPublisher: Added more options for grouping of instances [\#3494](https://github.com/pypeclub/OpenPype/pull/3494)
+- NewPublisher: Align creator attributes from top to bottom [\#3487](https://github.com/pypeclub/OpenPype/pull/3487)
+- NewPublisher: Added ability to use label of instance [\#3484](https://github.com/pypeclub/OpenPype/pull/3484)
 - General: Creator Plugins have access to project [\#3476](https://github.com/pypeclub/OpenPype/pull/3476)
 - General: Better arguments order in creator init [\#3475](https://github.com/pypeclub/OpenPype/pull/3475)
 - Ftrack: Trigger custom ftrack events on project creation and preparation [\#3465](https://github.com/pypeclub/OpenPype/pull/3465)
@@ -25,6 +28,11 @@
 
 **🐛 Bug fixes**
 
+- TrayPublisher: Keep use instance label in list view [\#3493](https://github.com/pypeclub/OpenPype/pull/3493)
+- General: Extract review use first frame of input sequence [\#3491](https://github.com/pypeclub/OpenPype/pull/3491)
+- General: Fix Plist loading for application launch [\#3485](https://github.com/pypeclub/OpenPype/pull/3485)
+- Nuke: Workfile tools open on start [\#3479](https://github.com/pypeclub/OpenPype/pull/3479)
+- New Publisher: Disabled context change allows creation [\#3478](https://github.com/pypeclub/OpenPype/pull/3478)
 - General: thumbnail extractor fix [\#3474](https://github.com/pypeclub/OpenPype/pull/3474)
 - Kitsu: bugfix with sync-service ans publish plugins [\#3473](https://github.com/pypeclub/OpenPype/pull/3473)
 - Flame: solved problem with multi-selected loading [\#3470](https://github.com/pypeclub/OpenPype/pull/3470)
@@ -46,7 +54,9 @@
 - General: Use query functions in global plugins [\#3459](https://github.com/pypeclub/OpenPype/pull/3459)
 - Clockify: Use query functions in clockify actions [\#3458](https://github.com/pypeclub/OpenPype/pull/3458)
 - General: Use query functions in rest api calls [\#3457](https://github.com/pypeclub/OpenPype/pull/3457)
+- General: Use query functions in openpype lib functions [\#3454](https://github.com/pypeclub/OpenPype/pull/3454)
 - General: Use query functions in load utils [\#3446](https://github.com/pypeclub/OpenPype/pull/3446)
+- General: Move publish plugin and publish render abstractions [\#3442](https://github.com/pypeclub/OpenPype/pull/3442)
 - General: Use Anatomy after move to pipeline [\#3436](https://github.com/pypeclub/OpenPype/pull/3436)
 - General: Anatomy moved to pipeline [\#3435](https://github.com/pypeclub/OpenPype/pull/3435)
 - Fusion: Use client query functions [\#3380](https://github.com/pypeclub/OpenPype/pull/3380)
@@ -66,8 +76,6 @@
 - Webserver: Added CORS middleware [\#3422](https://github.com/pypeclub/OpenPype/pull/3422)
 - Attribute Defs UI: Files widget show what is allowed to drop in [\#3411](https://github.com/pypeclub/OpenPype/pull/3411)
 - General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
-- Hosts: More options for in-host callbacks [\#3357](https://github.com/pypeclub/OpenPype/pull/3357)
-- Multiverse: expose some settings to GUI [\#3350](https://github.com/pypeclub/OpenPype/pull/3350)
 
 **🐛 Bug fixes**
 
@@ -82,7 +90,6 @@
 - Maya: vray device aspect ratio fix [\#3381](https://github.com/pypeclub/OpenPype/pull/3381)
 - Flame: bunch of publishing issues [\#3377](https://github.com/pypeclub/OpenPype/pull/3377)
 - Harmony: added unc path to zifile command in Harmony [\#3372](https://github.com/pypeclub/OpenPype/pull/3372)
-- Standalone: settings improvements [\#3355](https://github.com/pypeclub/OpenPype/pull/3355)
 
 **🔀 Refactored code**
 
@@ -107,16 +114,9 @@
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.11.1-nightly.1...3.11.1)
 
-**🆕 New features**
-
-- Flame: custom export temp folder [\#3346](https://github.com/pypeclub/OpenPype/pull/3346)
-- Nuke: removing third-party plugins   [\#3344](https://github.com/pypeclub/OpenPype/pull/3344)
-
 **🚀 Enhancements**
 
 - Pyblish Pype: Hiding/Close issues [\#3367](https://github.com/pypeclub/OpenPype/pull/3367)
-- Ftrack: Removed requirement of pypeclub role from default settings [\#3354](https://github.com/pypeclub/OpenPype/pull/3354)
-- Kitsu: Prevent crash on missing frames information [\#3352](https://github.com/pypeclub/OpenPype/pull/3352)
 
 **🐛 Bug fixes**
 
@@ -125,19 +125,11 @@
 - Nuke: Fix missing variable in extract thumbnail [\#3363](https://github.com/pypeclub/OpenPype/pull/3363)
 - Nuke: Fix precollect writes [\#3361](https://github.com/pypeclub/OpenPype/pull/3361)
 - AE- fix validate\_scene\_settings and renderLocal [\#3358](https://github.com/pypeclub/OpenPype/pull/3358)
-- deadline: fixing misidentification of revieables [\#3356](https://github.com/pypeclub/OpenPype/pull/3356)
-- General: Create only one thumbnail per instance [\#3351](https://github.com/pypeclub/OpenPype/pull/3351)
-- nuke: adding extract thumbnail settings 3.10 [\#3347](https://github.com/pypeclub/OpenPype/pull/3347)
-- General: Fix last version function [\#3345](https://github.com/pypeclub/OpenPype/pull/3345)
 
 ## [3.11.0](https://github.com/pypeclub/OpenPype/tree/3.11.0) (2022-06-17)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.11.0-nightly.4...3.11.0)
 
-**🐛 Bug fixes**
-
-- General: Handle empty source key on instance [\#3342](https://github.com/pypeclub/OpenPype/pull/3342)
-
 ## [3.10.0](https://github.com/pypeclub/OpenPype/tree/3.10.0) (2022-05-26)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.10.0-nightly.6...3.10.0)
diff --git a/openpype/version.py b/openpype/version.py
index 3239b0e2a2..08bb4706cc 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.1-nightly.4"
+__version__ = "3.12.1-nightly.5"
diff --git a/pyproject.toml b/pyproject.toml
index f5bd7cc946..1251299612 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.1-nightly.4" # OpenPype
+version = "3.12.1-nightly.5" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 8bbf693a92a247894a10ef531ac433b3740ac154 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Wed, 13 Jul 2022 09:03:41 +0200
Subject: [PATCH 1072/1227] add unpack and pack tools

---
 tools/pack_project.ps1 | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 tools/pack_project.ps1

diff --git a/tools/pack_project.ps1 b/tools/pack_project.ps1
new file mode 100644
index 0000000000..36ec3cb96b
--- /dev/null
+++ b/tools/pack_project.ps1
@@ -0,0 +1,39 @@
+<#
+.SYNOPSIS
+  Helper script OpenPype Packing project.
+
+.DESCRIPTION
+  Once you are happy with the project and want to preserve it for future work, just change the project name on line 38 and copy the file into .\OpenPype\tools. Then use the cmd form .EXAMPLE
+
+.EXAMPLE
+
+PS> .\tools\run_pack_project.ps1
+
+#>
+$current_dir = Get-Location
+$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+$openpype_root = (Get-Item $script_dir).parent.FullName
+
+$env:_INSIDE_OPENPYPE_TOOL = "1"
+
+# make sure Poetry is in PATH
+if (-not (Test-Path 'env:POETRY_HOME')) {
+    $env:POETRY_HOME = "$openpype_root\.poetry"
+}
+$env:PATH = "$($env:PATH);$($env:POETRY_HOME)\bin"
+
+Set-Location -Path $openpype_root
+
+Write-Host ">>> " -NoNewline -ForegroundColor Green
+Write-Host "Reading Poetry ... " -NoNewline
+if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
+    Write-Host "NOT FOUND" -ForegroundColor Yellow
+    Write-Host "*** " -NoNewline -ForegroundColor Yellow
+    Write-Host "We need to install Poetry create virtual env first ..."
+    & "$openpype_root\tools\create_env.ps1"
+} else {
+    Write-Host "OK" -ForegroundColor Green
+}
+
+& "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\start.py" pack-project --project "OP02_VFX_demo"
+Set-Location -Path $current_dir
\ No newline at end of file

From 9a3a01c9ed6afeec9015b3dd06c5ef2e2438cc60 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Wed, 13 Jul 2022 09:03:50 +0200
Subject: [PATCH 1073/1227] add unpack tool

---
 tools/unpack_project.ps1.lnk | Bin 0 -> 1426 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 tools/unpack_project.ps1.lnk

diff --git a/tools/unpack_project.ps1.lnk b/tools/unpack_project.ps1.lnk
new file mode 100644
index 0000000000000000000000000000000000000000..56eee50ca235b0ea76eca52ed0040137a07f9786
GIT binary patch
literal 1426
zcma)6Nla5w6ulruP?QphqQQWe7!+DM$QVq(Dv(G@^%ueVBh=p-3T^+VzX+HpPPi}<
z7aBAqCImFPkOeN(2ohYVi6aX&xO0fcpsBdf6%x;T9cXYNuerk;{<-&^d;4mLC@w7?
znrMP+svM<6%7TA?w)yjnZYplvb~woFi%o7mzn%~}7#A{8?TAmKOzZpF$*k#8w`OoE
zk#hC=tLrG=Tq;Hn%{!fB;1gB&J(5aws>`pElaeTbevCibt8J2OIf4!+%G}GLS42N7
z<zB|mKU7C5xyTPqR1V#YnFl`;8A%5$=I4<XGXoVvOgNWD)^ObYwznrW<aK)-J}L{x
zWw}J+Zv4h*S;nKytHEPI@{$|K4)Sq4OBk<D2s$(*$xathX&BGBXL4Aw74v(fbTHnQ
z&O>qUUdjQINJh5!4B6SkXoqYGs)lM6m(SXzU~5Mh(IWUNBwId5JhPHPj4i0c>6^(^
zOA7FOxN8^ph|;6?mTVJt4FzP`qeky-5duJ+urt0t*ps0d=dq)*dyWFgQ^w61-)Z38
zNURmucUe?tu~wLOA2;Z%0?N8CoGsgn;0jeNQDZD9d{e_5wIfpnd`i?xjqv=4(t`XY
zMATufa!xXEx)s7KLt=ItgpC$RI%ElCef3bG2DaYqbIKhmq5F7qiM-SzE07rBRpc~?
z?LNgJwKgh#xy2;~bc%{AY(Z!piP7SS|Bx!i5F#$>64_)%Yltz8E5<a_Vq;ZMHdS#P
z0WI$UT`sgw7Q~OnJc5~u7&0$BBR13mjl9LYSYJpnJ6((R(1YeiWLO2w+A(z2h?40c
z1}X#}M-f3md`2)@c_0V&7lai9f6;*pJ)VQvtD36%=cY|-@3g6GuL**}3^c&9!Rw&)
zIFx{_u=)7w)ZP>Ik8ApZ@ehW+<h=TNcI#d0|DJm4+4Fa|9vVLVZ~rMUl7Qa>YY?o$
z$8!ypV>QL*(b?4(H(&9-bYq=AS($M1AOhY51Ee7QHn3R%#E4g-kYBZg?-fxItRC-1
z5rmPTMaQw1q!_ajoYiwAJ#6SLBdms!7+K@pIozvM->5FvUEAJyegoE<Ayf^yy^G#l
Tev)XpG&3T%)ph5x^~m@O1(Yc!

literal 0
HcmV?d00001


From 60940c0af657af62713b22956837af3e958d0816 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Wed, 13 Jul 2022 09:19:34 +0200
Subject: [PATCH 1074/1227] fix forgotten variables

---
 openpype/lib/project_backpack.py |   2 +-
 tools/pack_project.ps1           |   2 +-
 tools/unpack_project.ps1         |  39 +++++++++++++++++++++++++++++++
 tools/unpack_project.ps1.lnk     | Bin 1426 -> 0 bytes
 4 files changed, 41 insertions(+), 2 deletions(-)
 create mode 100644 tools/unpack_project.ps1
 delete mode 100644 tools/unpack_project.ps1.lnk

diff --git a/openpype/lib/project_backpack.py b/openpype/lib/project_backpack.py
index f0188e6765..ff2f1d4b88 100644
--- a/openpype/lib/project_backpack.py
+++ b/openpype/lib/project_backpack.py
@@ -53,7 +53,7 @@ def pack_project(project_name, destination_dir=None):
 
     Args:
         project_name(str): Project that should be packaged.
-        destination_dir(str): Optinal path where zip will be stored. Project's
+        destination_dir(str): Optional path where zip will be stored. Project's
             root is used if not passed.
     """
     print("Creating package of project \"{}\"".format(project_name))
diff --git a/tools/pack_project.ps1 b/tools/pack_project.ps1
index 36ec3cb96b..856247f7ca 100644
--- a/tools/pack_project.ps1
+++ b/tools/pack_project.ps1
@@ -35,5 +35,5 @@ if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
     Write-Host "OK" -ForegroundColor Green
 }
 
-& "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\start.py" pack-project --project "OP02_VFX_demo"
+& "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\start.py" pack-project --project $ARGS
 Set-Location -Path $current_dir
\ No newline at end of file
diff --git a/tools/unpack_project.ps1 b/tools/unpack_project.ps1
new file mode 100644
index 0000000000..e7b9e87a7f
--- /dev/null
+++ b/tools/unpack_project.ps1
@@ -0,0 +1,39 @@
+<#
+.SYNOPSIS
+  Helper script OpenPype Unpacking project.
+
+.DESCRIPTION
+  Make sure you had dropped the project from your db and removed the poject data in case you were having them previously. Then on line 38 change the <Path to zip> to any path where the zip with project is - usually we are having it here https://drive.google.com/drive/u/0/folders/0AKE4mxImOsAGUk9PVA . Copy the file into .\OpenPype\tools. Then use the cmd form .EXAMPLE
+
+.EXAMPLE
+
+PS> .\tools\run_unpack_project.ps1
+
+#>
+$current_dir = Get-Location
+$script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+$openpype_root = (Get-Item $script_dir).parent.FullName
+
+$env:_INSIDE_OPENPYPE_TOOL = "1"
+
+# make sure Poetry is in PATH
+if (-not (Test-Path 'env:POETRY_HOME')) {
+    $env:POETRY_HOME = "$openpype_root\.poetry"
+}
+$env:PATH = "$($env:PATH);$($env:POETRY_HOME)\bin"
+
+Set-Location -Path $openpype_root
+
+Write-Host ">>> " -NoNewline -ForegroundColor Green
+Write-Host "Reading Poetry ... " -NoNewline
+if (-not (Test-Path -PathType Container -Path "$($env:POETRY_HOME)\bin")) {
+    Write-Host "NOT FOUND" -ForegroundColor Yellow
+    Write-Host "*** " -NoNewline -ForegroundColor Yellow
+    Write-Host "We need to install Poetry create virtual env first ..."
+    & "$openpype_root\tools\create_env.ps1"
+} else {
+    Write-Host "OK" -ForegroundColor Green
+}
+
+& "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\start.py" unpack-project --zipfile $ARGS
+Set-Location -Path $current_dir
\ No newline at end of file
diff --git a/tools/unpack_project.ps1.lnk b/tools/unpack_project.ps1.lnk
deleted file mode 100644
index 56eee50ca235b0ea76eca52ed0040137a07f9786..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1426
zcma)6Nla5w6ulruP?QphqQQWe7!+DM$QVq(Dv(G@^%ueVBh=p-3T^+VzX+HpPPi}<
z7aBAqCImFPkOeN(2ohYVi6aX&xO0fcpsBdf6%x;T9cXYNuerk;{<-&^d;4mLC@w7?
znrMP+svM<6%7TA?w)yjnZYplvb~woFi%o7mzn%~}7#A{8?TAmKOzZpF$*k#8w`OoE
zk#hC=tLrG=Tq;Hn%{!fB;1gB&J(5aws>`pElaeTbevCibt8J2OIf4!+%G}GLS42N7
z<zB|mKU7C5xyTPqR1V#YnFl`;8A%5$=I4<XGXoVvOgNWD)^ObYwznrW<aK)-J}L{x
zWw}J+Zv4h*S;nKytHEPI@{$|K4)Sq4OBk<D2s$(*$xathX&BGBXL4Aw74v(fbTHnQ
z&O>qUUdjQINJh5!4B6SkXoqYGs)lM6m(SXzU~5Mh(IWUNBwId5JhPHPj4i0c>6^(^
zOA7FOxN8^ph|;6?mTVJt4FzP`qeky-5duJ+urt0t*ps0d=dq)*dyWFgQ^w61-)Z38
zNURmucUe?tu~wLOA2;Z%0?N8CoGsgn;0jeNQDZD9d{e_5wIfpnd`i?xjqv=4(t`XY
zMATufa!xXEx)s7KLt=ItgpC$RI%ElCef3bG2DaYqbIKhmq5F7qiM-SzE07rBRpc~?
z?LNgJwKgh#xy2;~bc%{AY(Z!piP7SS|Bx!i5F#$>64_)%Yltz8E5<a_Vq;ZMHdS#P
z0WI$UT`sgw7Q~OnJc5~u7&0$BBR13mjl9LYSYJpnJ6((R(1YeiWLO2w+A(z2h?40c
z1}X#}M-f3md`2)@c_0V&7lai9f6;*pJ)VQvtD36%=cY|-@3g6GuL**}3^c&9!Rw&)
zIFx{_u=)7w)ZP>Ik8ApZ@ehW+<h=TNcI#d0|DJm4+4Fa|9vVLVZ~rMUl7Qa>YY?o$
z$8!ypV>QL*(b?4(H(&9-bYq=AS($M1AOhY51Ee7QHn3R%#E4g-kYBZg?-fxItRC-1
z5rmPTMaQw1q!_ajoYiwAJ#6SLBdms!7+K@pIozvM->5FvUEAJyegoE<Ayf^yy^G#l
Tev)XpG&3T%)ph5x^~m@O1(Yc!


From cda2c37b9548f90e63f34f04e2873169e167c3f9 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Wed, 13 Jul 2022 07:26:22 +0000
Subject: [PATCH 1075/1227] [Automated] Bump version

---
 CHANGELOG.md        | 15 +++++----------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 7 insertions(+), 12 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 55ee51b38a..59c51396e3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,13 +1,9 @@
 # Changelog
 
-## [3.12.1-nightly.5](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.1-nightly.6](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.0...HEAD)
 
-### 📖 Documentation
-
-- Docs: Added minimal permissions for MongoDB [\#3441](https://github.com/pypeclub/OpenPype/pull/3441)
-
 **🆕 New features**
 
 - Maya: Add VDB to Arnold loader [\#3433](https://github.com/pypeclub/OpenPype/pull/3433)
@@ -24,7 +20,7 @@
 - Blender: Bugfix - Set fps properly on open [\#3426](https://github.com/pypeclub/OpenPype/pull/3426)
 - Hiero: Add custom scripts menu [\#3425](https://github.com/pypeclub/OpenPype/pull/3425)
 - Blender: pre pyside install for all platforms [\#3400](https://github.com/pypeclub/OpenPype/pull/3400)
-- Maya: Ability to set resolution for playblasts from asset, and override through review instance. [\#3360](https://github.com/pypeclub/OpenPype/pull/3360)
+- Maya: Add additional playblast options to review Extractor. [\#3384](https://github.com/pypeclub/OpenPype/pull/3384)
 
 **🐛 Bug fixes**
 
@@ -40,7 +36,6 @@
 - Resolve: removed few bugs [\#3464](https://github.com/pypeclub/OpenPype/pull/3464)
 - General: Delete old versions is safer when ftrack is disabled [\#3462](https://github.com/pypeclub/OpenPype/pull/3462)
 - Nuke: fixing metadata slate TC difference [\#3455](https://github.com/pypeclub/OpenPype/pull/3455)
-- Nuke: prerender reviewable fails [\#3450](https://github.com/pypeclub/OpenPype/pull/3450)
 - Maya: fix hashing in Python 3 for tile rendering [\#3447](https://github.com/pypeclub/OpenPype/pull/3447)
 - LogViewer: Escape html characters in log message [\#3443](https://github.com/pypeclub/OpenPype/pull/3443)
 - Nuke: Slate frame is integrated [\#3427](https://github.com/pypeclub/OpenPype/pull/3427)
@@ -59,8 +54,8 @@
 - General: Move publish plugin and publish render abstractions [\#3442](https://github.com/pypeclub/OpenPype/pull/3442)
 - General: Use Anatomy after move to pipeline [\#3436](https://github.com/pypeclub/OpenPype/pull/3436)
 - General: Anatomy moved to pipeline [\#3435](https://github.com/pypeclub/OpenPype/pull/3435)
-- Fusion: Use client query functions [\#3380](https://github.com/pypeclub/OpenPype/pull/3380)
 - Resolve: Use client query functions [\#3379](https://github.com/pypeclub/OpenPype/pull/3379)
+- Photoshop: Use client query functions [\#3375](https://github.com/pypeclub/OpenPype/pull/3375)
 
 ## [3.12.0](https://github.com/pypeclub/OpenPype/tree/3.12.0) (2022-06-28)
 
@@ -68,6 +63,7 @@
 
 ### 📖 Documentation
 
+- Docs: Added minimal permissions for MongoDB [\#3441](https://github.com/pypeclub/OpenPype/pull/3441)
 - Fix typo in documentation: pyenv on mac [\#3417](https://github.com/pypeclub/OpenPype/pull/3417)
 - Linux: update OIIO package [\#3401](https://github.com/pypeclub/OpenPype/pull/3401)
 
@@ -100,9 +96,9 @@
 - Hiero: Use client query functions [\#3393](https://github.com/pypeclub/OpenPype/pull/3393)
 - Nuke: Use client query functions [\#3391](https://github.com/pypeclub/OpenPype/pull/3391)
 - Maya: Use client query functions [\#3385](https://github.com/pypeclub/OpenPype/pull/3385)
+- Fusion: Use client query functions [\#3380](https://github.com/pypeclub/OpenPype/pull/3380)
 - Harmony: Use client query functions [\#3378](https://github.com/pypeclub/OpenPype/pull/3378)
 - Celaction: Use client query functions [\#3376](https://github.com/pypeclub/OpenPype/pull/3376)
-- Photoshop: Use client query functions [\#3375](https://github.com/pypeclub/OpenPype/pull/3375)
 - AfterEffects: Use client query functions [\#3374](https://github.com/pypeclub/OpenPype/pull/3374)
 
 **Merged pull requests:**
@@ -124,7 +120,6 @@
 - Harmony: audio validator has wrong logic [\#3364](https://github.com/pypeclub/OpenPype/pull/3364)
 - Nuke: Fix missing variable in extract thumbnail [\#3363](https://github.com/pypeclub/OpenPype/pull/3363)
 - Nuke: Fix precollect writes [\#3361](https://github.com/pypeclub/OpenPype/pull/3361)
-- AE- fix validate\_scene\_settings and renderLocal [\#3358](https://github.com/pypeclub/OpenPype/pull/3358)
 
 ## [3.11.0](https://github.com/pypeclub/OpenPype/tree/3.11.0) (2022-06-17)
 
diff --git a/openpype/version.py b/openpype/version.py
index 08bb4706cc..26c7e4fa34 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.1-nightly.5"
+__version__ = "3.12.1-nightly.6"
diff --git a/pyproject.toml b/pyproject.toml
index 1251299612..ed7799a7ba 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.1-nightly.5" # OpenPype
+version = "3.12.1-nightly.6" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From f9b23a27d20b07b549fcf43277bfc796d73e6da8 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Wed, 13 Jul 2022 07:43:12 +0000
Subject: [PATCH 1076/1227] [Automated] Release

---
 CHANGELOG.md        | 16 ++++++++++------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 59c51396e3..cc5bf39a29 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,12 @@
 # Changelog
 
-## [3.12.1-nightly.6](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.1](https://github.com/pypeclub/OpenPype/tree/3.12.1) (2022-07-13)
 
-[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.0...HEAD)
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.0...3.12.1)
+
+### 📖 Documentation
+
+- Docs: Added minimal permissions for MongoDB [\#3441](https://github.com/pypeclub/OpenPype/pull/3441)
 
 **🆕 New features**
 
@@ -36,11 +40,13 @@
 - Resolve: removed few bugs [\#3464](https://github.com/pypeclub/OpenPype/pull/3464)
 - General: Delete old versions is safer when ftrack is disabled [\#3462](https://github.com/pypeclub/OpenPype/pull/3462)
 - Nuke: fixing metadata slate TC difference [\#3455](https://github.com/pypeclub/OpenPype/pull/3455)
+- Nuke: prerender reviewable fails [\#3450](https://github.com/pypeclub/OpenPype/pull/3450)
 - Maya: fix hashing in Python 3 for tile rendering [\#3447](https://github.com/pypeclub/OpenPype/pull/3447)
 - LogViewer: Escape html characters in log message [\#3443](https://github.com/pypeclub/OpenPype/pull/3443)
 - Nuke: Slate frame is integrated [\#3427](https://github.com/pypeclub/OpenPype/pull/3427)
 - Maya: Camera extra data - additional fix for \#3304 [\#3386](https://github.com/pypeclub/OpenPype/pull/3386)
 - Maya: Handle excluding `model` family from frame range validator. [\#3370](https://github.com/pypeclub/OpenPype/pull/3370)
+- Harmony: audio validator has wrong logic [\#3364](https://github.com/pypeclub/OpenPype/pull/3364)
 
 **🔀 Refactored code**
 
@@ -54,8 +60,8 @@
 - General: Move publish plugin and publish render abstractions [\#3442](https://github.com/pypeclub/OpenPype/pull/3442)
 - General: Use Anatomy after move to pipeline [\#3436](https://github.com/pypeclub/OpenPype/pull/3436)
 - General: Anatomy moved to pipeline [\#3435](https://github.com/pypeclub/OpenPype/pull/3435)
+- Fusion: Use client query functions [\#3380](https://github.com/pypeclub/OpenPype/pull/3380)
 - Resolve: Use client query functions [\#3379](https://github.com/pypeclub/OpenPype/pull/3379)
-- Photoshop: Use client query functions [\#3375](https://github.com/pypeclub/OpenPype/pull/3375)
 
 ## [3.12.0](https://github.com/pypeclub/OpenPype/tree/3.12.0) (2022-06-28)
 
@@ -63,7 +69,6 @@
 
 ### 📖 Documentation
 
-- Docs: Added minimal permissions for MongoDB [\#3441](https://github.com/pypeclub/OpenPype/pull/3441)
 - Fix typo in documentation: pyenv on mac [\#3417](https://github.com/pypeclub/OpenPype/pull/3417)
 - Linux: update OIIO package [\#3401](https://github.com/pypeclub/OpenPype/pull/3401)
 
@@ -96,9 +101,9 @@
 - Hiero: Use client query functions [\#3393](https://github.com/pypeclub/OpenPype/pull/3393)
 - Nuke: Use client query functions [\#3391](https://github.com/pypeclub/OpenPype/pull/3391)
 - Maya: Use client query functions [\#3385](https://github.com/pypeclub/OpenPype/pull/3385)
-- Fusion: Use client query functions [\#3380](https://github.com/pypeclub/OpenPype/pull/3380)
 - Harmony: Use client query functions [\#3378](https://github.com/pypeclub/OpenPype/pull/3378)
 - Celaction: Use client query functions [\#3376](https://github.com/pypeclub/OpenPype/pull/3376)
+- Photoshop: Use client query functions [\#3375](https://github.com/pypeclub/OpenPype/pull/3375)
 - AfterEffects: Use client query functions [\#3374](https://github.com/pypeclub/OpenPype/pull/3374)
 
 **Merged pull requests:**
@@ -117,7 +122,6 @@
 **🐛 Bug fixes**
 
 - Nuke: bake streams with slate on farm [\#3368](https://github.com/pypeclub/OpenPype/pull/3368)
-- Harmony: audio validator has wrong logic [\#3364](https://github.com/pypeclub/OpenPype/pull/3364)
 - Nuke: Fix missing variable in extract thumbnail [\#3363](https://github.com/pypeclub/OpenPype/pull/3363)
 - Nuke: Fix precollect writes [\#3361](https://github.com/pypeclub/OpenPype/pull/3361)
 
diff --git a/openpype/version.py b/openpype/version.py
index 26c7e4fa34..c7b0de0381 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.1-nightly.6"
+__version__ = "3.12.1"
diff --git a/pyproject.toml b/pyproject.toml
index ed7799a7ba..4bdaaab4ed 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.1-nightly.6" # OpenPype
+version = "3.12.1" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From c9e714a7afc37f98c9cb4792fa42b53b1b2272c3 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 12:00:21 +0200
Subject: [PATCH 1077/1227] implemented tray publisher host using HostBase

---
 openpype/hosts/traypublisher/api/__init__.py | 16 +-----
 openpype/hosts/traypublisher/api/pipeline.py | 60 ++++++++++----------
 openpype/tools/traypublisher/window.py       | 13 +++--
 3 files changed, 41 insertions(+), 48 deletions(-)

diff --git a/openpype/hosts/traypublisher/api/__init__.py b/openpype/hosts/traypublisher/api/__init__.py
index c461c0c526..4e7284b09a 100644
--- a/openpype/hosts/traypublisher/api/__init__.py
+++ b/openpype/hosts/traypublisher/api/__init__.py
@@ -1,20 +1,8 @@
 from .pipeline import (
-    install,
-    ls,
-
-    set_project_name,
-    get_context_title,
-    get_context_data,
-    update_context_data,
+    TrayPublisherHost,
 )
 
 
 __all__ = (
-    "install",
-    "ls",
-
-    "set_project_name",
-    "get_context_title",
-    "get_context_data",
-    "update_context_data",
+    "TrayPublisherHost",
 )
diff --git a/openpype/hosts/traypublisher/api/pipeline.py b/openpype/hosts/traypublisher/api/pipeline.py
index 954a0bae47..2d9db7801e 100644
--- a/openpype/hosts/traypublisher/api/pipeline.py
+++ b/openpype/hosts/traypublisher/api/pipeline.py
@@ -9,6 +9,8 @@ from openpype.pipeline import (
     register_creator_plugin_path,
     legacy_io,
 )
+from openpype.host import HostBase, INewPublisher
+
 
 ROOT_DIR = os.path.dirname(os.path.dirname(
     os.path.abspath(__file__)
@@ -17,6 +19,35 @@ PUBLISH_PATH = os.path.join(ROOT_DIR, "plugins", "publish")
 CREATE_PATH = os.path.join(ROOT_DIR, "plugins", "create")
 
 
+class TrayPublisherHost(HostBase, INewPublisher):
+    name = "traypublisher"
+
+    def install(self):
+        os.environ["AVALON_APP"] = self.name
+        legacy_io.Session["AVALON_APP"] = self.name
+
+        pyblish.api.register_host("traypublisher")
+        pyblish.api.register_plugin_path(PUBLISH_PATH)
+        register_creator_plugin_path(CREATE_PATH)
+
+    def get_context_title(self):
+        return HostContext.get_project_name()
+
+    def get_context_data(self):
+        return HostContext.get_context_data()
+
+    def update_context_data(self, data, changes):
+        HostContext.save_context_data(data, changes)
+
+    def set_project_name(self, project_name):
+        # TODO Deregister project specific plugins and register new project
+        #   plugins
+        os.environ["AVALON_PROJECT"] = project_name
+        legacy_io.Session["AVALON_PROJECT"] = project_name
+        legacy_io.install()
+        HostContext.set_project_name(project_name)
+
+
 class HostContext:
     _context_json_path = None
 
@@ -150,32 +181,3 @@ def get_context_data():
 
 def update_context_data(data, changes):
     HostContext.save_context_data(data)
-
-
-def get_context_title():
-    return HostContext.get_project_name()
-
-
-def ls():
-    """Probably will never return loaded containers."""
-    return []
-
-
-def install():
-    """This is called before a project is known.
-
-    Project is defined with 'set_project_name'.
-    """
-    os.environ["AVALON_APP"] = "traypublisher"
-
-    pyblish.api.register_host("traypublisher")
-    pyblish.api.register_plugin_path(PUBLISH_PATH)
-    register_creator_plugin_path(CREATE_PATH)
-
-
-def set_project_name(project_name):
-    # TODO Deregister project specific plugins and register new project plugins
-    os.environ["AVALON_PROJECT"] = project_name
-    legacy_io.Session["AVALON_PROJECT"] = project_name
-    legacy_io.install()
-    HostContext.set_project_name(project_name)
diff --git a/openpype/tools/traypublisher/window.py b/openpype/tools/traypublisher/window.py
index 5934c4aa8a..cc33287091 100644
--- a/openpype/tools/traypublisher/window.py
+++ b/openpype/tools/traypublisher/window.py
@@ -12,9 +12,7 @@ from openpype.pipeline import (
     install_host,
     AvalonMongoDB,
 )
-from openpype.hosts.traypublisher import (
-    api as traypublisher
-)
+from openpype.hosts.traypublisher.api import TrayPublisherHost
 from openpype.tools.publisher import PublisherWindow
 from openpype.tools.utils.constants import PROJECT_NAME_ROLE
 from openpype.tools.utils.models import (
@@ -111,9 +109,13 @@ class StandaloneOverlayWidget(QtWidgets.QFrame):
         if project_name:
             self._set_project(project_name)
 
+    @property
+    def host(self):
+        return self._publisher_window.controller.host
+
     def _set_project(self, project_name):
         self._project_name = project_name
-        traypublisher.set_project_name(project_name)
+        self.host.set_project_name(project_name)
         self.setVisible(False)
         self.project_selected.emit(project_name)
 
@@ -190,7 +192,8 @@ class TrayPublishWindow(PublisherWindow):
 
 
 def main():
-    install_host(traypublisher)
+    host = TrayPublisherHost()
+    install_host(host)
     app = QtWidgets.QApplication([])
     window = TrayPublishWindow()
     window.show()

From 74cd74f053023324a9a6c46e67cfd5023147cda6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 12:00:29 +0200
Subject: [PATCH 1078/1227] creatos have access to host

---
 openpype/pipeline/create/creator_plugins.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/pipeline/create/creator_plugins.py b/openpype/pipeline/create/creator_plugins.py
index 91b9d80234..52c76db5ef 100644
--- a/openpype/pipeline/create/creator_plugins.py
+++ b/openpype/pipeline/create/creator_plugins.py
@@ -102,6 +102,10 @@ class BaseCreator:
 
         return self.create_context.project_name
 
+    @property
+    def host(self):
+        return self.create_context.host
+
     def get_group_label(self):
         """Group label under which are instances grouped in UI.
 

From 2fbe33750df3c25b1089208bf093326720fec21e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 12:01:55 +0200
Subject: [PATCH 1079/1227] implemented helper method to store new instance

---
 openpype/hosts/traypublisher/api/plugin.py | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/traypublisher/api/plugin.py b/openpype/hosts/traypublisher/api/plugin.py
index 202664cfc6..cc93d7c157 100644
--- a/openpype/hosts/traypublisher/api/plugin.py
+++ b/openpype/hosts/traypublisher/api/plugin.py
@@ -37,6 +37,21 @@ class TrayPublishCreator(Creator):
         # Use same attributes as for instance attrobites
         return self.get_instance_attr_defs()
 
+    def _store_new_instance(self, new_instance):
+        """Tray publisher specific method to store instance.
+
+        Instance is stored into "workfile" of traypublisher and also add it
+        to CreateContext.
+
+        Args:
+            new_instance (CreatedInstance): Instance that should be stored.
+        """
+
+        # Host implementation of storing metadata about instance
+        HostContext.add_instance(new_instance.data_to_store())
+        # Add instance to current context
+        self._add_instance_to_context(new_instance)
+
 
 class SettingsCreator(TrayPublishCreator):
     create_allow_context_change = True
@@ -58,10 +73,8 @@ class SettingsCreator(TrayPublishCreator):
         data["settings_creator"] = True
         # Create new instance
         new_instance = CreatedInstance(self.family, subset_name, data, self)
-        # Host implementation of storing metadata about instance
-        HostContext.add_instance(new_instance.data_to_store())
-        # Add instance to current context
-        self._add_instance_to_context(new_instance)
+
+        self._store_new_instance(new_instance)
 
     def get_instance_attr_defs(self):
         return [

From 9d6eb0d5c2efdbfbee8b40aac3e19cef87f9973e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 12:30:09 +0200
Subject: [PATCH 1080/1227] added extract to file action to project list
 context actions

---
 openpype/tools/settings/settings/categories.py | 3 +++
 openpype/tools/settings/settings/widgets.py    | 5 +++++
 2 files changed, 8 insertions(+)

diff --git a/openpype/tools/settings/settings/categories.py b/openpype/tools/settings/settings/categories.py
index 764f42f1a3..f42027d9e2 100644
--- a/openpype/tools/settings/settings/categories.py
+++ b/openpype/tools/settings/settings/categories.py
@@ -854,6 +854,9 @@ class ProjectWidget(SettingsCategoryWidget):
         project_list_widget.version_change_requested.connect(
             self._on_source_version_change
         )
+        project_list_widget.extract_to_file_requested.connect(
+            self._on_extract_to_file
+        )
 
         self.project_list_widget = project_list_widget
 
diff --git a/openpype/tools/settings/settings/widgets.py b/openpype/tools/settings/settings/widgets.py
index 45c21d5685..1d94094897 100644
--- a/openpype/tools/settings/settings/widgets.py
+++ b/openpype/tools/settings/settings/widgets.py
@@ -1008,6 +1008,7 @@ class ProjectSortFilterProxy(QtCore.QSortFilterProxyModel):
 class ProjectListWidget(QtWidgets.QWidget):
     project_changed = QtCore.Signal()
     version_change_requested = QtCore.Signal(str)
+    extract_to_file_requested = QtCore.Signal()
 
     def __init__(self, parent, only_active=False):
         self._parent = parent
@@ -1099,6 +1100,10 @@ class ProjectListWidget(QtWidgets.QWidget):
                 self.version_change_requested
             )
             submenu.addAction(action)
+
+        extract_action = QtWidgets.QAction("Extract to file", menu)
+        extract_action.triggered.connect(self.extract_to_file_requested)
+
         menu.addMenu(submenu)
         menu.exec_(QtGui.QCursor.pos())
 

From 4e137c1f4bd88ad35b4df733a72f26d590c80284 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 12:33:31 +0200
Subject: [PATCH 1081/1227] add action to menu

---
 openpype/tools/settings/settings/widgets.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/tools/settings/settings/widgets.py b/openpype/tools/settings/settings/widgets.py
index 1d94094897..88d923c16a 100644
--- a/openpype/tools/settings/settings/widgets.py
+++ b/openpype/tools/settings/settings/widgets.py
@@ -1105,6 +1105,7 @@ class ProjectListWidget(QtWidgets.QWidget):
         extract_action.triggered.connect(self.extract_to_file_requested)
 
         menu.addMenu(submenu)
+        menu.addAction(extract_action)
         menu.exec_(QtGui.QCursor.pos())
 
     def on_item_clicked(self, new_index):

From f6129b5f5b84d03816e17cfd6489df4d4d300116 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 12:41:15 +0200
Subject: [PATCH 1082/1227] trigger 'openpype.project.structure.created' topic
 on finish of create project structure action

---
 .../event_handlers_user/action_create_project_structure.py   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/openpype/modules/ftrack/event_handlers_user/action_create_project_structure.py b/openpype/modules/ftrack/event_handlers_user/action_create_project_structure.py
index ebea8872f9..df914de854 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_create_project_structure.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_create_project_structure.py
@@ -84,6 +84,11 @@ class CreateProjectFolders(BaseAction):
             create_project_folders(basic_paths, project_name)
             self.create_ftrack_entities(basic_paths, project_entity)
 
+            self.trigger_event(
+                "openpype.project.structure.created",
+                {"project_name": project_name}
+            )
+
         except Exception as exc:
             self.log.warning("Creating of structure crashed.", exc_info=True)
             session.rollback()

From 927674be1afa804225b1a407b02de0b5ff5146e9 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 13 Jul 2022 15:11:58 +0200
Subject: [PATCH 1083/1227] OP-3446 - store source file as a 'source'

This will be stored in DB in version.
Potentially it could be used to populate Ftrack Note.
---
 .../hosts/traypublisher/plugins/publish/collect_mov_batch.py    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
index 2a5e356684..c81d1f77a5 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
@@ -31,4 +31,6 @@ class CollectMovBatch(
 
         instance.data["representations"].append(repre)
 
+        instance.data["source"] = file_url
+
         self.log.debug("instance.data {}".format(instance.data))

From 450a20dcca1b74d01c23beebdd170b356a8ccb34 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 13 Jul 2022 15:28:01 +0200
Subject: [PATCH 1084/1227] OP-3481 - add source key to Note formatting

Allows to fill value from instance.data["source"] as a {source} in Ftrack Note.
---
 openpype/modules/ftrack/plugins/publish/integrate_ftrack_note.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/modules/ftrack/plugins/publish/integrate_ftrack_note.py b/openpype/modules/ftrack/plugins/publish/integrate_ftrack_note.py
index 952b21546d..77a7ebdfcf 100644
--- a/openpype/modules/ftrack/plugins/publish/integrate_ftrack_note.py
+++ b/openpype/modules/ftrack/plugins/publish/integrate_ftrack_note.py
@@ -116,6 +116,7 @@ class IntegrateFtrackNote(pyblish.api.InstancePlugin):
                 "app_name": app_name,
                 "app_label": app_label,
                 "published_paths": "<br/>".join(sorted(published_paths)),
+                "source": instance.data.get("source", '')
             }
             comment = template.format(**format_data)
             if not comment:

From 5d0e68385e13f8f69397a8f78c4c179307ffe1fe Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 13 Jul 2022 15:28:15 +0200
Subject: [PATCH 1085/1227] OP-3481 - add source key to Note formatting

Allows to fill value from instance.data["source"] as a {source} in Ftrack Note.
---
 .../entities/schemas/projects_schema/schema_project_ftrack.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json b/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
index f8f9d5093d..c0069dcdab 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
@@ -822,7 +822,7 @@
                         },
                         {
                             "type": "label",
-                            "label": "Template may contain formatting keys <b>intent</b>, <b>comment</b>, <b>host_name</b>, <b>app_name</b>, <b>app_label</b> and <b>published_paths</b>."
+                            "label": "Template may contain formatting keys <b>intent</b>, <b>comment</b>, <b>host_name</b>, <b>app_name</b>, <b>app_label</b>, <b>published_paths</b> and <b>source</b>."
                         },
                         {
                             "type": "text",

From 0047ca458c3e6febe9b9826fd8938bea4c05339d Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 13 Jul 2022 15:30:10 +0200
Subject: [PATCH 1086/1227] OP-3481 - simple creators fill 'source' key

Source filepats used to fill source value used later in Ftrack note or version in DB.
---
 .../traypublisher/plugins/publish/collect_simple_instances.py   | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index b2be43c701..2fb6fcf3ce 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -45,6 +45,8 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
             "files": filenames
         })
 
+        instance.data["source"] = filepaths
+
         self.log.debug("Created Simple Settings instance {}".format(
             instance.data
         ))

From dbcf9097d38d8d7a4b094e161291859905ef3a3d Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 13 Jul 2022 15:43:22 +0200
Subject: [PATCH 1087/1227] OP-3481 - fix source, must be string

---
 .../traypublisher/plugins/publish/collect_simple_instances.py   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index 2fb6fcf3ce..1f473ff71c 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -45,7 +45,7 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
             "files": filenames
         })
 
-        instance.data["source"] = filepaths
+        instance.data["source"] = "\n".join(filepaths)
 
         self.log.debug("Created Simple Settings instance {}".format(
             instance.data

From d294ad51748fa5ba02c6ca387f1c3af7ec1ba855 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 16:10:01 +0200
Subject: [PATCH 1088/1227] add also default values of missing attribute
 definitions

---
 openpype/pipeline/create/context.py | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index aecdb04635..a7a8eba383 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -29,6 +29,7 @@ UpdateData = collections.namedtuple("UpdateData", ["instance", "changes"])
 
 class ImmutableKeyError(TypeError):
     """Accessed key is immutable so does not allow changes or removements."""
+
     def __init__(self, key, msg=None):
         self.immutable_key = key
         if not msg:
@@ -40,6 +41,7 @@ class ImmutableKeyError(TypeError):
 
 class HostMissRequiredMethod(Exception):
     """Host does not have implemented required functions for creation."""
+
     def __init__(self, host, missing_methods):
         self.missing_methods = missing_methods
         self.host = host
@@ -66,6 +68,7 @@ class InstanceMember:
     TODO:
     Implement and use!
     """
+
     def __init__(self, instance, name):
         self.instance = instance
 
@@ -94,6 +97,7 @@ class AttributeValues:
         values(dict): Values after possible conversion.
         origin_data(dict): Values loaded from host before conversion.
     """
+
     def __init__(self, attr_defs, values, origin_data=None):
         from openpype.lib.attribute_definitions import UnknownDef
 
@@ -174,6 +178,10 @@ class AttributeValues:
         output = {}
         for key in self._data:
             output[key] = self[key]
+
+        for key, attr_def in self._attr_defs_by_key.items():
+            if key not in output:
+                output[key] = attr_def.default
         return output
 
     @staticmethod
@@ -196,6 +204,7 @@ class CreatorAttributeValues(AttributeValues):
     Args:
         instance (CreatedInstance): Instance for which are values hold.
     """
+
     def __init__(self, instance, *args, **kwargs):
         self.instance = instance
         super(CreatorAttributeValues, self).__init__(*args, **kwargs)
@@ -211,6 +220,7 @@ class PublishAttributeValues(AttributeValues):
         publish_attributes(PublishAttributes): Wrapper for multiple publish
             attributes is used as parent object.
     """
+
     def __init__(self, publish_attributes, *args, **kwargs):
         self.publish_attributes = publish_attributes
         super(PublishAttributeValues, self).__init__(*args, **kwargs)
@@ -232,6 +242,7 @@ class PublishAttributes:
         attr_plugins(list): List of publish plugins that may have defined
             attribute definitions.
     """
+
     def __init__(self, parent, origin_data, attr_plugins=None):
         self.parent = parent
         self._origin_data = copy.deepcopy(origin_data)
@@ -270,6 +281,7 @@ class PublishAttributes:
             key(str): Plugin name.
             default: Default value if plugin was not found.
         """
+
         if key not in self._data:
             return default
 
@@ -287,11 +299,13 @@ class PublishAttributes:
 
     def plugin_names_order(self):
         """Plugin names order by their 'order' attribute."""
+
         for name in self._plugin_names_order:
             yield name
 
     def data_to_store(self):
         """Convert attribute values to "data to store"."""
+
         output = {}
         for key, attr_value in self._data.items():
             output[key] = attr_value.data_to_store()
@@ -299,6 +313,7 @@ class PublishAttributes:
 
     def changes(self):
         """Return changes per each key."""
+
         changes = {}
         for key, attr_val in self._data.items():
             attr_changes = attr_val.changes()
@@ -314,6 +329,7 @@ class PublishAttributes:
 
     def set_publish_plugins(self, attr_plugins):
         """Set publish plugins attribute definitions."""
+
         self._plugin_names_order = []
         self._missing_plugins = []
         self.attr_plugins = attr_plugins or []
@@ -365,6 +381,7 @@ class CreatedInstance:
             `openpype.pipeline.registered_host`.
         new(bool): Is instance new.
     """
+
     # Keys that can't be changed or removed from data after loading using
     #   creator.
     # - 'creator_attributes' and 'publish_attributes' can change values of
@@ -566,6 +583,7 @@ class CreatedInstance:
     @property
     def id(self):
         """Instance identifier."""
+
         return self._data["instance_id"]
 
     @property
@@ -574,10 +592,12 @@ class CreatedInstance:
 
         Access to data is needed to modify values.
         """
+
         return self
 
     def changes(self):
         """Calculate and return changes."""
+
         changes = {}
         new_keys = set()
         for key, new_value in self._data.items():

From ba6afb8be5107affa0179a1ac4f7c64241ba35a3 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 16:10:22 +0200
Subject: [PATCH 1089/1227] added jpeg extension to default settings

---
 openpype/settings/defaults/project_settings/traypublisher.json | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/traypublisher.json b/openpype/settings/defaults/project_settings/traypublisher.json
index 5afaaee78c..d3e8028cdb 100644
--- a/openpype/settings/defaults/project_settings/traypublisher.json
+++ b/openpype/settings/defaults/project_settings/traypublisher.json
@@ -116,6 +116,7 @@
                 ".png",
                 ".dpx",
                 ".jpg",
+                ".jpeg",
                 ".tiff",
                 ".tif",
                 ".mov",
@@ -158,6 +159,7 @@
             "extensions": [
                 ".exr",
                 ".jpg",
+                ".jpeg",
                 ".dpx",
                 ".bmp",
                 ".tif",

From ac118ddefd8d2d0d576de43115d914e2e403f925 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 16:10:42 +0200
Subject: [PATCH 1090/1227] fill "source" in simple instances

---
 .../plugins/publish/collect_simple_instances.py        | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index b2be43c701..bbd0221c88 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -1,4 +1,6 @@
 import os
+
+import clique
 import pyblish.api
 
 
@@ -29,6 +31,14 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
             for filename in filepath_item["filenames"]
         ]
 
+        cols, rems = clique.assemble(filepaths)
+        source = None
+        if cols:
+            source = cols[0].format("{head}{padding}{tail}")
+        elif rems:
+            source = rems[0]
+
+        instance.data["source"] = source
         instance.data["sourceFilepaths"] = filepaths
         instance.data["stagingDir"] = filepath_item["directory"]
 

From 5592b4fb83ad0f3f4b5e222ed0f8361d0ebee346 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 16:10:59 +0200
Subject: [PATCH 1091/1227] fill representation in instance data update

---
 openpype/plugins/publish/collect_from_create_context.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/collect_from_create_context.py b/openpype/plugins/publish/collect_from_create_context.py
index f6ead98809..d2be633cbe 100644
--- a/openpype/plugins/publish/collect_from_create_context.py
+++ b/openpype/plugins/publish/collect_from_create_context.py
@@ -47,12 +47,11 @@ class CollectFromCreateContext(pyblish.api.ContextPlugin):
             "label": subset,
             "name": subset,
             "family": in_data["family"],
-            "families": instance_families
+            "families": instance_families,
+            "representations": []
         })
         for key, value in in_data.items():
             if key not in instance.data:
                 instance.data[key] = value
         self.log.info("collected instance: {}".format(instance.data))
         self.log.info("parsing data: {}".format(in_data))
-
-        instance.data["representations"] = list()

From 45473c5a832b4db881ca328ad89324ada93ae0e5 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Wed, 13 Jul 2022 16:24:08 +0200
Subject: [PATCH 1092/1227] add host and families settings to integrators

---
 .../defaults/project_settings/global.json     | 171 ++++++++++++++++++
 .../schemas/schema_global_publish.json        |  79 ++++++++
 2 files changed, 250 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index 4e9b61100e..545c792d47 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -171,6 +171,177 @@
             ]
         },
         "IntegrateAssetNew": {
+            "hosts": [
+                "aftereffects",
+                "blender",
+                "celaction",
+                "flame",
+                "fusion",
+                "harmony",
+                "hiero",
+                "houdini",
+                "nuke",
+                "photoshop",
+                "resolve",
+                "tvpaint",
+                "unreal",
+                "standalonepublisher",
+                "webpublisher"
+            ],
+            "families": [
+                "workfile",
+                "pointcache",
+                "camera",
+                "animation",
+                "model",
+                "mayaAscii",
+                "mayaScene",
+                "setdress",
+                "layout",
+                "ass",
+                "vdbcache",
+                "scene",
+                "vrayproxy",
+                "vrayscene_layer",
+                "render",
+                "prerender",
+                "imagesequence",
+                "review",
+                "rendersetup",
+                "rig",
+                "plate",
+                "look",
+                "audio",
+                "yetiRig",
+                "yeticache",
+                "nukenodes",
+                "gizmo",
+                "source",
+                "matchmove",
+                "image",
+                "assembly",
+                "fbx",
+                "textures",
+                "action",
+                "harmony.template",
+                "harmony.palette",
+                "editorial",
+                "background",
+                "camerarig",
+                "redshiftproxy",
+                "effect",
+                "xgen",
+                "hda",
+                "usd",
+                "staticMesh",
+                "skeletalMesh",
+                "mvLook",
+                "mvUsd",
+                "mvUsdComposition",
+                "mvUsdOverride",
+                "simpleUnrealTexture"
+            ],
+            "template_name_profiles": [
+                {
+                    "families": [],
+                    "hosts": [],
+                    "task_types": [],
+                    "tasks": [],
+                    "template_name": "publish"
+                },
+                {
+                    "families": [
+                        "review",
+                        "render",
+                        "prerender"
+                    ],
+                    "hosts": [],
+                    "task_types": [],
+                    "tasks": [],
+                    "template_name": "render"
+                },
+                {
+                    "families": [
+                        "simpleUnrealTexture"
+                    ],
+                    "hosts": [
+                        "standalonepublisher"
+                    ],
+                    "task_types": [],
+                    "tasks": [],
+                    "template_name": "simpleUnrealTexture"
+                },
+                {
+                    "families": [
+                        "staticMesh",
+                        "skeletalMesh"
+                    ],
+                    "hosts": [
+                        "maya"
+                    ],
+                    "task_types": [],
+                    "tasks": [],
+                    "template_name": "maya2unreal"
+                }
+            ]
+        },
+        "IntegrateAsset": {
+            "hosts": [
+                "maya"
+            ],
+            "families": [
+                "workfile",
+                "pointcache",
+                "camera",
+                "animation",
+                "model",
+                "mayaAscii",
+                "mayaScene",
+                "setdress",
+                "layout",
+                "ass",
+                "vdbcache",
+                "scene",
+                "vrayproxy",
+                "vrayscene_layer",
+                "render",
+                "prerender",
+                "imagesequence",
+                "review",
+                "rendersetup",
+                "rig",
+                "plate",
+                "look",
+                "audio",
+                "yetiRig",
+                "yeticache",
+                "nukenodes",
+                "gizmo",
+                "source",
+                "matchmove",
+                "image",
+                "assembly",
+                "fbx",
+                "textures",
+                "action",
+                "harmony.template",
+                "harmony.palette",
+                "editorial",
+                "background",
+                "camerarig",
+                "redshiftproxy",
+                "effect",
+                "xgen",
+                "hda",
+                "usd",
+                "staticMesh",
+                "skeletalMesh",
+                "mvLook",
+                "mvUsd",
+                "mvUsdComposition",
+                "mvUsdOverride",
+                "simpleUnrealTexture"
+            ],
             "template_name_profiles": [
                 {
                     "families": [],
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
index e368916cc9..71eed2e2de 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
@@ -587,6 +587,85 @@
             "label": "IntegrateAssetNew",
             "is_group": true,
             "children": [
+                {
+                    "type": "list",
+                    "key": "hosts",
+                    "label": "Hosts",
+                    "object_type": "text"
+                },
+                {
+                    "key": "families",
+                    "label": "Families",
+                    "type": "list",
+                    "object_type": "text"
+                },
+                {
+                    "type": "list",
+                    "key": "template_name_profiles",
+                    "label": "Template name profiles",
+                    "use_label_wrap": true,
+                    "object_type": {
+                        "type": "dict",
+                        "children": [
+                            {
+                                "type": "label",
+                                "label": ""
+                            },
+                            {
+                                "key": "families",
+                                "label": "Families",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "hosts-enum",
+                                "key": "hosts",
+                                "label": "Hosts",
+                                "multiselection": true
+                            },
+                            {
+                                "key": "task_types",
+                                "label": "Task types",
+                                "type": "task-types-enum"
+                            },
+                            {
+                                "key": "tasks",
+                                "label": "Task names",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "separator"
+                            },
+                            {
+                                "type": "text",
+                                "key": "template_name",
+                                "label": "Template name"
+                            }
+                        ]
+                    }
+                }
+            ]
+        },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "IntegrateAsset",
+            "label": "IntegrateAsset",
+            "is_group": true,
+            "children": [
+                {
+                    "type": "list",
+                    "key": "hosts",
+                    "label": "Hosts",
+                    "object_type": "text"
+                },
+                {
+                    "key": "families",
+                    "label": "Families",
+                    "type": "list",
+                    "object_type": "text"
+                },
                 {
                     "type": "list",
                     "key": "template_name_profiles",

From be4ac5b56b9c815a268696ff23f072d14b029192 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Wed, 13 Jul 2022 17:25:51 +0200
Subject: [PATCH 1093/1227] add multiple items and review boolean to tray
 creator settings

---
 openpype/hosts/traypublisher/api/plugin.py    |  7 +++++-
 .../project_settings/traypublisher.json       | 24 ++++++++++++++++++-
 .../schema_project_traypublisher.json         | 10 ++++++++
 3 files changed, 39 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/traypublisher/api/plugin.py b/openpype/hosts/traypublisher/api/plugin.py
index 202664cfc6..a5d08c2967 100644
--- a/openpype/hosts/traypublisher/api/plugin.py
+++ b/openpype/hosts/traypublisher/api/plugin.py
@@ -1,3 +1,4 @@
+from openpype.lib.attribute_definitions import BoolDef
 from openpype.pipeline import (
     Creator,
     CreatedInstance
@@ -70,8 +71,10 @@ class SettingsCreator(TrayPublishCreator):
                 folders=False,
                 extensions=self.extensions,
                 allow_sequences=self.allow_sequences,
+                single_item=not self.allow_multiple_items,
                 label="Filepath",
-            )
+            ),
+            BoolDef("allow_review", label="Reviewable", default=True)
         ]
 
     @classmethod
@@ -92,6 +95,8 @@ class SettingsCreator(TrayPublishCreator):
                 "detailed_description": item_data["detailed_description"],
                 "extensions": item_data["extensions"],
                 "allow_sequences": item_data["allow_sequences"],
+                "allow_multiple_items": item_data["allow_multiple_items"],
+                "allow_review": item_data["allow_review"],
                 "default_variants": item_data["default_variants"]
             }
         )
diff --git a/openpype/settings/defaults/project_settings/traypublisher.json b/openpype/settings/defaults/project_settings/traypublisher.json
index d3e8028cdb..e59200a13b 100644
--- a/openpype/settings/defaults/project_settings/traypublisher.json
+++ b/openpype/settings/defaults/project_settings/traypublisher.json
@@ -10,7 +10,9 @@
             ],
             "description": "Backup of a working scene",
             "detailed_description": "Workfiles are full scenes from any application that are directly edited by artists. They represent a state of work on a task at a given point and are usually not directly referenced into other scenes.",
-            "allow_sequences": true,
+            "allow_sequences": false,
+            "allow_multiple_items": false,
+            "allow_review": false,
             "extensions": [
                 ".ma",
                 ".mb",
@@ -44,6 +46,8 @@
             "description": "Clean models",
             "detailed_description": "Models should only contain geometry data, without any extras like cameras, locators or bones.\n\nKeep in mind that models published from tray publisher are not validated for correctness. ",
             "allow_sequences": false,
+            "allow_multiple_items": true,
+            "allow_review": false,
             "extensions": [
                 ".ma",
                 ".mb",
@@ -68,6 +72,8 @@
             "description": "Geometry Caches",
             "detailed_description": "Alembic or bgeo cache of animated data",
             "allow_sequences": true,
+            "allow_multiple_items": true,
+            "allow_review": false,
             "extensions": [
                 ".abc",
                 ".bgeo",
@@ -90,6 +96,8 @@
             "description": "Footage Plates",
             "detailed_description": "Any type of image seqeuence coming from outside of the studio. Usually camera footage, but could also be animatics used for reference.",
             "allow_sequences": true,
+            "allow_multiple_items": true,
+            "allow_review": true,
             "extensions": [
                 ".exr",
                 ".png",
@@ -111,6 +119,8 @@
             "description": "Rendered images or video",
             "detailed_description": "Sequence or single file renders",
             "allow_sequences": true,
+            "allow_multiple_items": true,
+            "allow_review": true,
             "extensions": [
                 ".exr",
                 ".png",
@@ -133,6 +143,8 @@
             "description": "3d Camera",
             "detailed_description": "Ideally this should be only camera itself with baked animation, however, it can technically also include helper geometry.",
             "allow_sequences": false,
+            "allow_multiple_items": true,
+            "allow_review": false,
             "extensions": [
                 ".abc",
                 ".ma",
@@ -156,6 +168,8 @@
             "description": "Single image",
             "detailed_description": "Any image data can be published as image family. References, textures, concept art, matte paints. This is a fallback 2d family for everything that doesn't fit more specific family.",
             "allow_sequences": false,
+            "allow_multiple_items": true,
+            "allow_review": true,
             "extensions": [
                 ".exr",
                 ".jpg",
@@ -178,6 +192,8 @@
             "description": "Sparse volumetric data",
             "detailed_description": "Hierarchical data structure for the efficient storage and manipulation of sparse volumetric data discretized on three-dimensional grids",
             "allow_sequences": true,
+            "allow_multiple_items": true,
+            "allow_review": false,
             "extensions": [
                 ".vdb"
             ]
@@ -195,6 +211,8 @@
             "description": "Matchmoving script",
             "detailed_description": "Script exported from matchmoving application to be later processed into a tracked camera with additional data",
             "allow_sequences": false,
+            "allow_multiple_items": true,
+            "allow_review": false,
             "extensions": []
         },
         {
@@ -206,6 +224,8 @@
             "description": "CG rig file",
             "detailed_description": "CG rigged character or prop. Rig should be clean of any extra data and directly loadable into it's respective application\t",
             "allow_sequences": false,
+            "allow_multiple_items": false,
+            "allow_review": false,
             "extensions": [
                 ".ma",
                 ".blend",
@@ -224,6 +244,8 @@
             "description": "Simple Unreal Engine texture",
             "detailed_description": "Texture files with Unreal Engine naming conventions",
             "allow_sequences": false,
+            "allow_multiple_items": true,
+            "allow_review": false,
             "extensions": []
         }
     ]
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
index 55c1b7b7d7..08c95609c0 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
@@ -67,6 +67,16 @@
                         "label": "Allow sequences",
                         "type": "boolean"
                     },
+                    {
+                        "key": "allow_multiple_items",
+                        "label": "Allow multiple items",
+                        "type": "boolean"
+                    },
+                    {
+                        "key": "allow_review",
+                        "label": "Allow review",
+                        "type": "boolean"
+                    },
                     {
                         "type": "list",
                         "key": "extensions",

From 654b0fb1eb8883815c8493ddf665d824d9830bdb Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Wed, 13 Jul 2022 17:26:07 +0200
Subject: [PATCH 1094/1227] delete obsolete create_review_family plugin

---
 .../plugins/publish/collect_review_family.py  | 31 -------------------
 1 file changed, 31 deletions(-)
 delete mode 100644 openpype/hosts/traypublisher/plugins/publish/collect_review_family.py

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_review_family.py b/openpype/hosts/traypublisher/plugins/publish/collect_review_family.py
deleted file mode 100644
index 965e251527..0000000000
--- a/openpype/hosts/traypublisher/plugins/publish/collect_review_family.py
+++ /dev/null
@@ -1,31 +0,0 @@
-import pyblish.api
-from openpype.lib import BoolDef
-from openpype.pipeline import OpenPypePyblishPluginMixin
-
-
-class CollectReviewFamily(
-    pyblish.api.InstancePlugin, OpenPypePyblishPluginMixin
-):
-    """Add review family."""
-
-    label = "Collect Review Family"
-    order = pyblish.api.CollectorOrder - 0.49
-
-    hosts = ["traypublisher"]
-    families = [
-        "image",
-        "render",
-        "plate",
-        "review"
-    ]
-
-    def process(self, instance):
-        values = self.get_attr_values_from_data(instance.data)
-        if values.get("add_review_family"):
-            instance.data["families"].append("review")
-
-    @classmethod
-    def get_attribute_defs(cls):
-        return [
-            BoolDef("add_review_family", label="Review", default=True)
-        ]

From 540e94e72680d9899689b18592deb09267e9ac3d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Wed, 13 Jul 2022 17:44:29 +0200
Subject: [PATCH 1095/1227] :bug: fix git submodules weirdness

---
 .../UE_5.0/Content/Python/__init__.py => .gitmodules           | 3 ++-
 openpype/hosts/unreal/integration/UE_5.0/Content/__init__.py   | 0
 2 files changed, 2 insertions(+), 1 deletion(-)
 rename openpype/hosts/unreal/integration/UE_5.0/Content/Python/__init__.py => .gitmodules (79%)
 delete mode 100644 openpype/hosts/unreal/integration/UE_5.0/Content/__init__.py

diff --git a/openpype/hosts/unreal/integration/UE_5.0/Content/Python/__init__.py b/.gitmodules
similarity index 79%
rename from openpype/hosts/unreal/integration/UE_5.0/Content/Python/__init__.py
rename to .gitmodules
index 1e3eb5e792..b515851c81 100644
--- a/openpype/hosts/unreal/integration/UE_5.0/Content/Python/__init__.py
+++ b/.gitmodules
@@ -1,6 +1,7 @@
 [submodule "vendor/powershell/BurntToast"]
     path = vendor/powershell/BurntToast
     url = https://github.com/Windos/BurntToast.git
+
 [submodule "vendor/powershell/PSWriteColor"]
     path = vendor/powershell/PSWriteColor
-    url = https://github.com/EvotecIT/PSWriteColor.git
\ No newline at end of file
+    url = https://github.com/EvotecIT/PSWriteColor.git
diff --git a/openpype/hosts/unreal/integration/UE_5.0/Content/__init__.py b/openpype/hosts/unreal/integration/UE_5.0/Content/__init__.py
deleted file mode 100644
index e69de29bb2..0000000000

From 2d2bf24c454d828a732f12a1dc628e1bfb375595 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Wed, 13 Jul 2022 18:06:03 +0200
Subject: [PATCH 1096/1227] :bug: init submodules first

---
 tools/create_env.ps1 | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/tools/create_env.ps1 b/tools/create_env.ps1
index b1337b5635..387bdf919c 100644
--- a/tools/create_env.ps1
+++ b/tools/create_env.ps1
@@ -28,9 +28,11 @@ $current_dir = Get-Location
 $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
+& git submodule update --init --recursive
 # Install PSWriteColor to support colorized output to terminal
 $env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
 
+
 function Exit-WithCode($exitcode) {
    # Only exit this host process if it's a child of another PowerShell parent process...
    $parentPID = (Get-CimInstance -ClassName Win32_Process -Filter "ProcessId=$PID" | Select-Object -Property ParentProcessId).ParentProcessId

From a427648abd8cb24a6ba906d5eb1ef7eb8212f96b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 19:05:23 +0200
Subject: [PATCH 1097/1227] implemented internal drag and drop and disabled
 sorting

---
 .../widgets/attribute_defs/files_widget.py    | 62 ++++++++++++++++++-
 1 file changed, 60 insertions(+), 2 deletions(-)

diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index 698a91a1a5..4652e12ab1 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -1,6 +1,7 @@
 import os
 import collections
 import uuid
+import json
 
 from Qt import QtWidgets, QtCore, QtGui
 
@@ -245,6 +246,62 @@ class FilesModel(QtGui.QStandardItemModel):
 
         return item_id, item
 
+    def mimeData(self, indexes):
+        item_ids = [
+            index.data(ITEM_ID_ROLE)
+            for index in indexes
+        ]
+        encoded_data = QtCore.QByteArray()
+        stream = QtCore.QDataStream(encoded_data, QtCore.QIODevice.WriteOnly)
+        stream.writeQString(json.dumps(item_ids))
+        mime_data = super(FilesModel, self).mimeData(indexes)
+        mime_data.setData("files_widget/internal_move", encoded_data)
+        return mime_data
+
+    def dropMimeData(self, mime_data, action, row, col, index):
+        internal_move_data = mime_data.data("files_widget/internal_move")
+        if isinstance(internal_move_data, QtCore.QByteArray):
+            # Raw data are already QByteArrat and we don't have to load them
+            encoded_data = internal_move_data
+        else:
+            encoded_data = QtCore.QByteArray.fromRawData(internal_move_data)
+        stream = QtCore.QDataStream(encoded_data, QtCore.QIODevice.ReadOnly)
+        text = stream.readQString()
+        try:
+            item_ids = json.loads(text)
+        except Exception:
+            return False
+
+        # Find matching item after which will be items moved
+        #   - store item before moved items are removed
+        root = self.invisibleRootItem()
+        if row >= 0:
+            src_item = self.item(row)
+        else:
+            src_item_id = index.data(ITEM_ID_ROLE)
+            src_item = self._items_by_id.get(src_item_id)
+
+        # Take out items that should be moved
+        items = []
+        for item_id in item_ids:
+            item = self._items_by_id.get(item_id)
+            if item:
+                self.takeRow(item.row())
+                items.append(item)
+
+        # Skip if there are not items that can be moved
+        if not items:
+            return False
+
+        # Calculate row where items should be inserted
+        if src_item:
+            src_row = src_item.row()
+        else:
+            src_row = root.rowCount()
+
+        root.insertRow(src_row, items)
+        return True
+
 
 class FilesProxyModel(QtCore.QSortFilterProxyModel):
     def __init__(self, *args, **kwargs):
@@ -428,6 +485,9 @@ class FilesView(QtWidgets.QListView):
             QtWidgets.QAbstractItemView.ExtendedSelection
         )
         self.setContextMenuPolicy(QtCore.Qt.CustomContextMenu)
+        self.setAcceptDrops(True)
+        self.setDragEnabled(True)
+        self.setDragDropMode(self.InternalMove)
 
         remove_btn = InViewButton(self)
         pix_enabled = paint_image_with_color(
@@ -637,8 +697,6 @@ class FilesWidget(QtWidgets.QFrame):
             )
             self._widgets_by_id[item_id] = widget
 
-        self._files_proxy_model.sort(0)
-
         if not self._in_set_value:
             self.value_changed.emit()
 

From 2fbc1aa00676d542b7765773f376f3eee677c348 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 19:06:03 +0200
Subject: [PATCH 1098/1227] make drop available

---
 openpype/widgets/attribute_defs/files_widget.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index 4652e12ab1..eeb8f2d6dc 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -805,8 +805,12 @@ class FilesWidget(QtWidgets.QFrame):
         event.accept()
 
     def dropEvent(self, event):
+        if self._multivalue:
+            return
+
         mime_data = event.mimeData()
-        if not self._multivalue and mime_data.hasUrls():
+        if mime_data.hasUrls():
+            event.accept()
             filepaths = []
             for url in mime_data.urls():
                 filepath = url.toLocalFile()
@@ -817,7 +821,8 @@ class FilesWidget(QtWidgets.QFrame):
             filepaths = self._files_proxy_model.filter_valid_files(filepaths)
             if filepaths:
                 self._add_filepaths(filepaths)
-        event.accept()
+
+        super(FilesWidget, self).dropEvent(event)
 
     def _add_filepaths(self, filepaths):
         self._files_model.add_filepaths(filepaths)

From 08a9613c660f06d1158b2c8d9a2ffc5303a92e23 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 19:32:44 +0200
Subject: [PATCH 1099/1227] fix label height in files widget

---
 .../widgets/attribute_defs/files_widget.py    | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index eeb8f2d6dc..0b3a81e903 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -62,6 +62,14 @@ class DropEmpty(QtWidgets.QWidget):
             widget.setAlignment(QtCore.Qt.AlignCenter)
             widget.setAttribute(QtCore.Qt.WA_TranslucentBackground)
 
+        update_size_timer = QtCore.QTimer()
+        update_size_timer.setInterval(10)
+        update_size_timer.setSingleShot(True)
+
+        update_size_timer.timeout.connect(self._on_update_size_timer)
+
+        self._update_size_timer = update_size_timer
+
         self._single_item = single_item
         self._allow_sequences = allow_sequences
         self._allowed_extensions = set()
@@ -130,7 +138,28 @@ class DropEmpty(QtWidgets.QWidget):
                 ", ".join(sorted(self._allowed_extensions))
             )
 
+        if self._items_label_widget.text() == items_label:
+            return
+
         self._items_label_widget.setText(items_label)
+        self._update_size_timer.start()
+
+    def resizeEvent(self, event):
+        super(DropEmpty, self).resizeEvent(event)
+        self._update_size_timer.start()
+
+    def _on_update_size_timer(self):
+        """Recalculate height of label with extensions.
+
+        Dynamic QLabel with word wrap does not handle properly it's sizeHint
+        calculations on show. This way it is recalculated. It is good practice
+        to trigger this method with small offset using '_update_size_timer'.
+        """
+
+        width = self._items_label_widget.width()
+        height = self._items_label_widget.heightForWidth(width)
+        self._items_label_widget.setMinimumHeight(height)
+        self._items_label_widget.updateGeometry()
 
     def paintEvent(self, event):
         super(DropEmpty, self).paintEvent(event)
@@ -613,6 +642,7 @@ class FilesWidget(QtWidgets.QFrame):
         files_view.context_menu_requested.connect(
             self._on_context_menu_requested
         )
+
         self._in_set_value = False
         self._single_item = single_item
         self._multivalue = False

From 731aecd71c58153dc45586ff67bc362d37e9f281 Mon Sep 17 00:00:00 2001
From: iLLiCiTiT <jakub.trllo@gmail.com>
Date: Wed, 13 Jul 2022 21:48:50 +0200
Subject: [PATCH 1100/1227] sort plugins separatelly and don't count on order
 from report

---
 .../publisher/publish_report_viewer/report_items.py    | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/openpype/tools/publisher/publish_report_viewer/report_items.py b/openpype/tools/publisher/publish_report_viewer/report_items.py
index b47d14da25..8a01569723 100644
--- a/openpype/tools/publisher/publish_report_viewer/report_items.py
+++ b/openpype/tools/publisher/publish_report_viewer/report_items.py
@@ -83,10 +83,8 @@ class PublishReport:
 
         logs = []
         plugins_items_by_id = {}
-        plugins_id_order = []
         for plugin_data in data["plugins_data"]:
             item = PluginItem(plugin_data)
-            plugins_id_order.append(item.id)
             plugins_items_by_id[item.id] = item
             for instance_data_item in plugin_data["instances_data"]:
                 instance_id = instance_data_item["id"]
@@ -95,6 +93,14 @@ class PublishReport:
                         copy.deepcopy(log_item_data), item.id, instance_id
                     )
                     logs.append(log_item)
+        sorted_plugins = sorted(
+            plugins_items_by_id.values(),
+            key=lambda item: item.order
+        )
+        plugins_id_order = [
+            plugin_item.id
+            for plugin_item in sorted_plugins
+        ]
 
         logs_by_instance_id = collections.defaultdict(list)
         for log_item in logs:

From 84068bdd50a2a5bd5547d969d5f2fb74068067a5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 11:32:29 +0200
Subject: [PATCH 1101/1227] added ability to zoom text in report

---
 .../publish_report_viewer/widgets.py          | 67 ++++++++++++++++++-
 1 file changed, 65 insertions(+), 2 deletions(-)

diff --git a/openpype/tools/publisher/publish_report_viewer/widgets.py b/openpype/tools/publisher/publish_report_viewer/widgets.py
index fd226ea0e4..61eb814a56 100644
--- a/openpype/tools/publisher/publish_report_viewer/widgets.py
+++ b/openpype/tools/publisher/publish_report_viewer/widgets.py
@@ -1,3 +1,4 @@
+from math import ceil
 from Qt import QtWidgets, QtCore, QtGui
 
 from openpype.widgets.nice_checkbox import NiceCheckbox
@@ -137,13 +138,75 @@ class PluginLoadReportWidget(QtWidgets.QWidget):
         self._model.set_report(report)
 
 
+class ZoomPlainText(QtWidgets.QPlainTextEdit):
+    def __init__(self, *args, **kwargs):
+        super(ZoomPlainText, self).__init__(*args, **kwargs)
+
+        anim_timer = QtCore.QTimer()
+        anim_timer.setInterval(20)
+
+        anim_timer.timeout.connect(self._scaling_callback)
+
+        self._anim_timer = anim_timer
+        self._zoom_enabled = False
+        self._scheduled_scalings = 0
+        self._point_size = None
+
+    def wheelEvent(self, event):
+        if not self._zoom_enabled:
+            super(ZoomPlainText, self).wheelEvent(event)
+            return
+
+        degrees = float(event.delta()) / 8
+        steps = int(ceil(degrees / 5))
+        self._scheduled_scalings += steps
+        if (self._scheduled_scalings * steps < 0):
+            self._scheduled_scalings = steps
+
+        self._anim_timer.start()
+
+    def _scaling_callback(self):
+        if self._scheduled_scalings == 0:
+            self._anim_timer.stop()
+            return
+
+        factor = 1.0 + (self._scheduled_scalings / 300)
+        font = self.font()
+        if self._point_size is None:
+            self._point_size = font.pointSizeF()
+
+        self._point_size *= factor
+        if self._point_size < 1:
+            self._point_size = 1.0
+
+        font.setPointSizeF(self._point_size)
+        # Using 'self.setFont(font)' would not be propagated when stylesheets
+        #   are applied on this widget
+        self.setStyleSheet("font-size: {}pt".format(font.pointSize()))
+
+        if self._scheduled_scalings > 0:
+            self._scheduled_scalings -= 1
+        else:
+            self._scheduled_scalings += 1
+
+    def keyPressEvent(self, event):
+        if event.key() == QtCore.Qt.Key_Control:
+            self._zoom_enabled = True
+        super(ZoomPlainText, self).keyPressEvent(event)
+
+    def keyReleaseEvent(self, event):
+        if event.key() == QtCore.Qt.Key_Control:
+            self._zoom_enabled = False
+        super(ZoomPlainText, self).keyReleaseEvent(event)
+
+
 class DetailsWidget(QtWidgets.QWidget):
     def __init__(self, parent):
         super(DetailsWidget, self).__init__(parent)
 
-        output_widget = QtWidgets.QPlainTextEdit(self)
-        output_widget.setTextInteractionFlags(QtCore.Qt.TextBrowserInteraction)
+        output_widget = ZoomPlainText(self)
         output_widget.setObjectName("PublishLogConsole")
+        output_widget.setTextInteractionFlags(QtCore.Qt.TextBrowserInteraction)
 
         layout = QtWidgets.QVBoxLayout(self)
         layout.setContentsMargins(0, 0, 0, 0)

From c16a2d6ed53caa68d44b986c1aec375fda8e34f0 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 12:17:19 +0200
Subject: [PATCH 1102/1227] moved collect cleanup keys earlier

---
 openpype/plugins/publish/collect_cleanup_keys.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/collect_cleanup_keys.py b/openpype/plugins/publish/collect_cleanup_keys.py
index 635b038387..b9cd1a9fc9 100644
--- a/openpype/plugins/publish/collect_cleanup_keys.py
+++ b/openpype/plugins/publish/collect_cleanup_keys.py
@@ -14,7 +14,7 @@ class CollectCleanupKeys(pyblish.api.ContextPlugin):
     """Prepare keys for 'ExplicitCleanUp' plugin."""
 
     label = "Collect Cleanup Keys"
-    order = pyblish.api.CollectorOrder
+    order = pyblish.api.CollectorOrder - 0.5
 
     def process(self, context):
         context.data["cleanupFullPaths"] = []

From 43d744b24b54f21ca2f7e622ca491af91833e689 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 12:17:43 +0200
Subject: [PATCH 1103/1227] instance data is filled with instance asset
 specific values if are not already available on instance

---
 .../publish/collect_anatomy_instance_data.py   | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/openpype/plugins/publish/collect_anatomy_instance_data.py b/openpype/plugins/publish/collect_anatomy_instance_data.py
index c75534cf83..f67d3373d9 100644
--- a/openpype/plugins/publish/collect_anatomy_instance_data.py
+++ b/openpype/plugins/publish/collect_anatomy_instance_data.py
@@ -51,6 +51,7 @@ class CollectAnatomyInstanceData(pyblish.api.ContextPlugin):
 
         project_name = legacy_io.active_project()
         self.fill_missing_asset_docs(context, project_name)
+        self.fill_instance_data_from_asset(context)
         self.fill_latest_versions(context, project_name)
         self.fill_anatomy_data(context)
 
@@ -115,6 +116,23 @@ class CollectAnatomyInstanceData(pyblish.api.ContextPlugin):
                 "Not found asset documents with names \"{}\"."
             ).format(joined_asset_names))
 
+    def fill_instance_data_from_asset(self, context):
+        for instance in context:
+            asset_doc = instance.data.get("assetEntity")
+            if not asset_doc:
+                continue
+
+            asset_data = asset_doc["data"]
+            for key in (
+                "fps",
+                "frameStart",
+                "frameEnd",
+                "handleStart",
+                "handleEnd",
+            ):
+                if key not in instance.data and key in asset_data:
+                    instance.data[key] = asset_data[key]
+
     def fill_latest_versions(self, context, project_name):
         """Try to find latest version for each instance's subset.
 

From 4f133d26b4312bcba7b3b2ddbcac19131667d590 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 12:29:13 +0200
Subject: [PATCH 1104/1227] changed allow_review to reviewable which affect
 default value of reviewable on instances

---
 openpype/hosts/traypublisher/api/plugin.py    |  8 +++++--
 .../project_settings/traypublisher.json       | 22 +++++++++----------
 .../schema_project_traypublisher.json         |  4 ++--
 3 files changed, 19 insertions(+), 15 deletions(-)

diff --git a/openpype/hosts/traypublisher/api/plugin.py b/openpype/hosts/traypublisher/api/plugin.py
index 3877d33055..6966935091 100644
--- a/openpype/hosts/traypublisher/api/plugin.py
+++ b/openpype/hosts/traypublisher/api/plugin.py
@@ -87,7 +87,11 @@ class SettingsCreator(TrayPublishCreator):
                 single_item=not self.allow_multiple_items,
                 label="Filepath",
             ),
-            BoolDef("allow_review", label="Reviewable", default=True)
+            BoolDef(
+                "reviewable",
+                label="Reviewable",
+                default=self.reviewable
+            )
         ]
 
     @classmethod
@@ -109,7 +113,7 @@ class SettingsCreator(TrayPublishCreator):
                 "extensions": item_data["extensions"],
                 "allow_sequences": item_data["allow_sequences"],
                 "allow_multiple_items": item_data["allow_multiple_items"],
-                "allow_review": item_data["allow_review"],
+                "reviewable": item_data["reviewable"],
                 "default_variants": item_data["default_variants"]
             }
         )
diff --git a/openpype/settings/defaults/project_settings/traypublisher.json b/openpype/settings/defaults/project_settings/traypublisher.json
index e59200a13b..619d54dbaf 100644
--- a/openpype/settings/defaults/project_settings/traypublisher.json
+++ b/openpype/settings/defaults/project_settings/traypublisher.json
@@ -12,7 +12,7 @@
             "detailed_description": "Workfiles are full scenes from any application that are directly edited by artists. They represent a state of work on a task at a given point and are usually not directly referenced into other scenes.",
             "allow_sequences": false,
             "allow_multiple_items": false,
-            "allow_review": false,
+            "reviewable": false,
             "extensions": [
                 ".ma",
                 ".mb",
@@ -47,7 +47,7 @@
             "detailed_description": "Models should only contain geometry data, without any extras like cameras, locators or bones.\n\nKeep in mind that models published from tray publisher are not validated for correctness. ",
             "allow_sequences": false,
             "allow_multiple_items": true,
-            "allow_review": false,
+            "reviewable": false,
             "extensions": [
                 ".ma",
                 ".mb",
@@ -73,7 +73,7 @@
             "detailed_description": "Alembic or bgeo cache of animated data",
             "allow_sequences": true,
             "allow_multiple_items": true,
-            "allow_review": false,
+            "reviewable": false,
             "extensions": [
                 ".abc",
                 ".bgeo",
@@ -97,7 +97,7 @@
             "detailed_description": "Any type of image seqeuence coming from outside of the studio. Usually camera footage, but could also be animatics used for reference.",
             "allow_sequences": true,
             "allow_multiple_items": true,
-            "allow_review": true,
+            "reviewable": true,
             "extensions": [
                 ".exr",
                 ".png",
@@ -120,7 +120,7 @@
             "detailed_description": "Sequence or single file renders",
             "allow_sequences": true,
             "allow_multiple_items": true,
-            "allow_review": true,
+            "reviewable": true,
             "extensions": [
                 ".exr",
                 ".png",
@@ -144,7 +144,7 @@
             "detailed_description": "Ideally this should be only camera itself with baked animation, however, it can technically also include helper geometry.",
             "allow_sequences": false,
             "allow_multiple_items": true,
-            "allow_review": false,
+            "reviewable": false,
             "extensions": [
                 ".abc",
                 ".ma",
@@ -169,7 +169,7 @@
             "detailed_description": "Any image data can be published as image family. References, textures, concept art, matte paints. This is a fallback 2d family for everything that doesn't fit more specific family.",
             "allow_sequences": false,
             "allow_multiple_items": true,
-            "allow_review": true,
+            "reviewable": true,
             "extensions": [
                 ".exr",
                 ".jpg",
@@ -193,7 +193,7 @@
             "detailed_description": "Hierarchical data structure for the efficient storage and manipulation of sparse volumetric data discretized on three-dimensional grids",
             "allow_sequences": true,
             "allow_multiple_items": true,
-            "allow_review": false,
+            "reviewable": false,
             "extensions": [
                 ".vdb"
             ]
@@ -212,7 +212,7 @@
             "detailed_description": "Script exported from matchmoving application to be later processed into a tracked camera with additional data",
             "allow_sequences": false,
             "allow_multiple_items": true,
-            "allow_review": false,
+            "reviewable": false,
             "extensions": []
         },
         {
@@ -225,7 +225,7 @@
             "detailed_description": "CG rigged character or prop. Rig should be clean of any extra data and directly loadable into it's respective application\t",
             "allow_sequences": false,
             "allow_multiple_items": false,
-            "allow_review": false,
+            "reviewable": false,
             "extensions": [
                 ".ma",
                 ".blend",
@@ -245,7 +245,7 @@
             "detailed_description": "Texture files with Unreal Engine naming conventions",
             "allow_sequences": false,
             "allow_multiple_items": true,
-            "allow_review": false,
+            "reviewable": false,
             "extensions": []
         }
     ]
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
index 08c95609c0..269b47459c 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
@@ -73,8 +73,8 @@
                         "type": "boolean"
                     },
                     {
-                        "key": "allow_review",
-                        "label": "Allow review",
+                        "key": "reviewable",
+                        "label": "Reviewable",
                         "type": "boolean"
                     },
                     {

From 1eceb7296df14e914a3c1de2c76dd1dcb84ab6ad Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 12:29:43 +0200
Subject: [PATCH 1105/1227] define some extensions for which reviewable could
 work

---
 .../publish/collect_simple_instances.py       | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index f76306cf05..4992d0a8be 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -12,6 +12,28 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
 
     hosts = ["traypublisher"]
 
+    _image_extensions = [
+        ".ani", ".anim", ".apng", ".art", ".bmp", ".bpg", ".bsave", ".cal",
+        ".cin", ".cpc", ".cpt", ".dds", ".dpx", ".ecw", ".exr", ".fits",
+        ".flic", ".flif", ".fpx", ".gif", ".hdri", ".hevc", ".icer",
+        ".icns", ".ico", ".cur", ".ics", ".ilbm", ".jbig", ".jbig2",
+        ".jng", ".jpeg", ".jpeg-ls", ".jpeg", ".2000", ".jpg", ".xr",
+        ".jpeg", ".xt", ".jpeg-hdr", ".kra", ".mng", ".miff", ".nrrd",
+        ".ora", ".pam", ".pbm", ".pgm", ".ppm", ".pnm", ".pcx", ".pgf",
+        ".pictor", ".png", ".psb", ".psp", ".qtvr", ".ras",
+        ".rgbe", ".logluv", ".tiff", ".sgi", ".tga", ".tiff", ".tiff/ep",
+        ".tiff/it", ".ufo", ".ufp", ".wbmp", ".webp", ".xbm", ".xcf",
+        ".xpm", ".xwd"
+    ]
+    _video_extensions = [
+        ".3g2", ".3gp", ".amv", ".asf", ".avi", ".drc", ".f4a", ".f4b",
+        ".f4p", ".f4v", ".flv", ".gif", ".gifv", ".m2v", ".m4p", ".m4v",
+        ".mkv", ".mng", ".mov", ".mp2", ".mp4", ".mpe", ".mpeg", ".mpg",
+        ".mpv", ".mxf", ".nsv", ".ogg", ".ogv", ".qt", ".rm", ".rmvb",
+        ".roq", ".svi", ".vob", ".webm", ".wmv", ".yuv"
+    ]
+    _review_extensions = _image_extensions + _video_extensions
+
     def process(self, instance):
         if not instance.data.get("settings_creator"):
             return

From a2a83623ff8f3f9ddece29227b60428721e5b56c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 12:30:40 +0200
Subject: [PATCH 1106/1227] instance staging dir lead to temp

---
 .../plugins/publish/collect_simple_instances.py     | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index 4992d0a8be..6a583b2e50 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -38,11 +38,15 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
         if not instance.data.get("settings_creator"):
             return
 
-        if "families" not in instance.data:
-            instance.data["families"] = []
+        # Create instance's staging dir in temp
+        tmp_folder = tempfile.mkdtemp(prefix="traypublisher_")
+        instance.data["stagingDir"] = tmp_folder
+        instance.context.data["cleanupFullPaths"].append(tmp_folder)
+
+        self.log.debug(
+            "Created temp staging directory for instance {}".format(tmp_folder)
+        )
 
-        if "representations" not in instance.data:
-            instance.data["representations"] = []
         repres = instance.data["representations"]
 
         creator_attributes = instance.data["creator_attributes"]
@@ -62,7 +66,6 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
 
         instance.data["source"] = source
         instance.data["sourceFilepaths"] = filepaths
-        instance.data["stagingDir"] = filepath_item["directory"]
 
         filenames = filepath_item["filenames"]
         _, ext = os.path.splitext(filenames[0])

From a088db2db9db034c752d7dd299614c3a8e739357 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 12:46:57 +0200
Subject: [PATCH 1107/1227] modified validator if not existing paths as there
 is a chance that filepaths are not filled at all

---
 .../plugins/publish/validate_filepaths.py     | 29 ++++++++++++++++---
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/validate_filepaths.py b/openpype/hosts/traypublisher/plugins/publish/validate_filepaths.py
index c7302b1005..e02116e10b 100644
--- a/openpype/hosts/traypublisher/plugins/publish/validate_filepaths.py
+++ b/openpype/hosts/traypublisher/plugins/publish/validate_filepaths.py
@@ -3,8 +3,17 @@ import pyblish.api
 from openpype.pipeline import PublishValidationError
 
 
-class ValidateWorkfilePath(pyblish.api.InstancePlugin):
-    """Validate existence of workfile instance existence."""
+class ValidateFilePath(pyblish.api.InstancePlugin):
+    """Validate existence of source filepaths on instance.
+
+    Plugins looks into key 'sourceFilepaths' and validate if paths there
+    actually exist on disk.
+
+    Also validate if the key is filled but is empty. In that case also
+    crashes so do not fill the key if unfilled value should not cause error.
+
+    This is primarily created for Simple Creator instances.
+    """
 
     label = "Validate Workfile"
     order = pyblish.api.ValidatorOrder - 0.49
@@ -14,12 +23,24 @@ class ValidateWorkfilePath(pyblish.api.InstancePlugin):
     def process(self, instance):
         if "sourceFilepaths" not in instance.data:
             self.log.info((
-                "Can't validate source filepaths existence."
+                "Skipped validation of source filepaths existence."
                 " Instance does not have collected 'sourceFilepaths'"
             ))
             return
 
-        filepaths = instance.data.get("sourceFilepaths")
+        filepaths = instance.data["sourceFilepaths"]
+        if not filepaths:
+            raise PublishValidationError(
+                (
+                    "Source filepaths of '{}' instance \"{}\" are not filled"
+                ).format(instance.data["family"], instance.data["name"]),
+                "File not filled",
+                (
+                    "## Files were not filled"
+                    "\nThis could mean that you didn't enter files into file"
+                    "input."
+                )
+            )
 
         not_found_files = [
             filepath

From bc09a92d52be3782015337c436f89f9ef832a3cd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 12:47:22 +0200
Subject: [PATCH 1108/1227] modified simple instance collector to be able
 handle multivalue of fileitems

---
 .../publish/collect_simple_instances.py       | 121 ++++++++++++++----
 1 file changed, 93 insertions(+), 28 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index 6a583b2e50..1b2129f48e 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -1,4 +1,6 @@
 import os
+import json
+import tempfile
 
 import clique
 import pyblish.api
@@ -38,50 +40,113 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
         if not instance.data.get("settings_creator"):
             return
 
+        instance_label = instance.data["name"]
         # Create instance's staging dir in temp
         tmp_folder = tempfile.mkdtemp(prefix="traypublisher_")
         instance.data["stagingDir"] = tmp_folder
         instance.context.data["cleanupFullPaths"].append(tmp_folder)
 
-        self.log.debug(
-            "Created temp staging directory for instance {}".format(tmp_folder)
-        )
+        self.log.debug((
+            "Created temp staging directory for instance {}. {}"
+        ).format(instance_label, tmp_folder))
 
         repres = instance.data["representations"]
 
         creator_attributes = instance.data["creator_attributes"]
-        filepath_item = creator_attributes["filepath"]
-        self.log.info(filepath_item)
-        filepaths = [
-            os.path.join(filepath_item["directory"], filename)
-            for filename in filepath_item["filenames"]
-        ]
+        self.log.info(json.dumps(creator_attributes))
+        filepath_items = creator_attributes["filepath"]
+        if not isinstance(filepath_items, list):
+            filepath_items = [filepath_items]
 
-        cols, rems = clique.assemble(filepaths)
+        # Last found representation is used as source for instance
         source = None
+        # Check if review is enabled and should be created
+        reviewable = creator_attributes.get("reviewable")
+        # Store review representation - first found that can be used for
+        #   review is stored
+        review_representation = None
+        review_path = None
+
+        # Make sure there are no representations with same name
+        repre_names_counter = {}
+        # Store created names for logging
+        _repre_names = []
+        # Store filepaths for validation of their existence
+        source_filepaths = []
+
+        # Create representations
+        for filepath_item in filepath_items:
+            filepaths = [
+                os.path.join(filepath_item["directory"], filename)
+                for filename in filepath_item["filenames"]
+            ]
+            source_filepaths.extend(filepaths)
+
+            source = self._calculate_source(filepaths)
+            filenames = filepath_item["filenames"]
+            _, ext = os.path.splitext(filenames[0])
+            if len(filenames) == 1:
+                filenames = filenames[0]
+
+            repre_name = repre_ext = ext[1:]
+            if repre_name not in repre_names_counter:
+                repre_names_counter[repre_name] = 2
+            else:
+                counter = repre_names_counter[repre_name]
+                repre_names_counter[repre_name] += 1
+                repre_name = "{}_{}".format(repre_name, counter)
+
+            _repre_names.append('"{}"'.format(repre_name))
+            representation = {
+                "ext": repre_ext,
+                "name": repre_name,
+                "stagingDir": filepath_item["directory"],
+                "files": filenames,
+                "tags": []
+            }
+            repres.append(representation)
+
+            if (
+                reviewable
+                and review_representation is None
+                and ext in self._review_extensions
+            ):
+                review_representation = representation
+                review_path = source
+
+        instance.data["source"] = source
+        instance.data["sourceFilepaths"] = source_filepaths
+
+        if reviewable:
+            self._prepare_review(instance, review_representation, review_path)
+
+        self.log.debug((
+            "Created Simple Settings instance \"{}\""
+            " with {} representations: {}"
+        ).format(instance_label, len(repres), ", ".join(_repre_names)))
+
+    def _calculate_source(self, filepaths):
+        if not filepaths:
+            return None
+        cols, rems = clique.assemble(filepaths)
         if cols:
             source = cols[0].format("{head}{padding}{tail}")
         elif rems:
             source = rems[0]
+        return source
 
-        instance.data["source"] = source
-        instance.data["sourceFilepaths"] = filepaths
+    def _prepare_review(self, instance, review_representation, review_path):
+        if not review_representation:
+            self.log.waring((
+                "Didn't find any representation"
+                " that could be used as source for review"
+            ))
+            return
 
-        filenames = filepath_item["filenames"]
-        _, ext = os.path.splitext(filenames[0])
-        ext = ext[1:]
-        if len(filenames) == 1:
-            filenames = filenames[0]
+        if "review" not in instance.data["families"]:
+            instance.data["families"].append("review")
 
-        repres.append({
-            "ext": ext,
-            "name": ext,
-            "stagingDir": filepath_item["directory"],
-            "files": filenames
-        })
-
-        instance.data["source"] = "\n".join(filepaths)
-
-        self.log.debug("Created Simple Settings instance {}".format(
-            instance.data
+        review_representation["tags"].append("review")
+        self.log.debug("Representation {} was marked for review. {}".format(
+            review_representation["name"], review_path
         ))

From b51c44d6f203a9cf0958bbc83504e4202ec1b98f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 12:52:35 +0200
Subject: [PATCH 1109/1227] modified error message

---
 .../plugins/publish/validate_filepaths.py      | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/validate_filepaths.py b/openpype/hosts/traypublisher/plugins/publish/validate_filepaths.py
index e02116e10b..749199fbd3 100644
--- a/openpype/hosts/traypublisher/plugins/publish/validate_filepaths.py
+++ b/openpype/hosts/traypublisher/plugins/publish/validate_filepaths.py
@@ -28,18 +28,22 @@ class ValidateFilePath(pyblish.api.InstancePlugin):
             ))
             return
 
+        family = instance.data["family"]
+        label = instance.data["name"]
         filepaths = instance.data["sourceFilepaths"]
         if not filepaths:
             raise PublishValidationError(
                 (
                     "Source filepaths of '{}' instance \"{}\" are not filled"
-                ).format(instance.data["family"], instance.data["name"]),
+                ).format(family, label),
                 "File not filled",
                 (
                     "## Files were not filled"
-                    "\nThis could mean that you didn't enter files into file"
-                    "input."
-                )
+                    "\nThis mean that you didn't enter any files into required"
+                    " file input."
+                    "\n- Please refresh publishing and check instance"
+                    " <b>{}</b>"
+                ).format(label)
             )
 
         not_found_files = [
@@ -55,11 +59,7 @@ class ValidateFilePath(pyblish.api.InstancePlugin):
             raise PublishValidationError(
                 (
                     "Filepath of '{}' instance \"{}\" does not exist:\n{}"
-                ).format(
-                    instance.data["family"],
-                    instance.data["name"],
-                    joined_paths
-                ),
+                ).format(family, label, joined_paths),
                 "File not found",
                 (
                     "## Files were not found\nFiles\n{}"

From 465c506162cba6b55981f56fba382b38c79ffc11 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 12:52:41 +0200
Subject: [PATCH 1110/1227] fix typo

---
 .../traypublisher/plugins/publish/collect_simple_instances.py   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index 1b2129f48e..8dd2964252 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -137,7 +137,7 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
 
     def _prepare_review(self, instance, review_representation, review_path):
         if not review_representation:
-            self.log.waring((
+            self.log.warning((
                 "Didn't find any representation"
                 " that could be used as source for review"
             ))

From 9c1dd8b5ca4df655bf533ac23773926caee1afd6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 12:59:45 +0200
Subject: [PATCH 1111/1227] save changes before reset

---
 openpype/tools/publisher/control.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/tools/publisher/control.py b/openpype/tools/publisher/control.py
index f692bb4000..b48bb61386 100644
--- a/openpype/tools/publisher/control.py
+++ b/openpype/tools/publisher/control.py
@@ -575,6 +575,8 @@ class PublisherController:
         # Stop publishing
         self.stop_publish()
 
+        self.save_changes()
+
         # Reset avalon context
         self.create_context.reset_avalon_context()
 

From 36ae9ff49cff8a460bcd46ef49e7c43c440874a7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 13:38:40 +0200
Subject: [PATCH 1112/1227] added some docstring to plugin

---
 .../plugins/publish/collect_simple_instances.py  | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index 8dd2964252..424cf7d88d 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -7,7 +7,21 @@ import pyblish.api
 
 
 class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
-    """Collect data for instances created by settings creators."""
+    """Collect data for instances created by settings creators.
+
+    Plugin create representations based on 'filepath' attribute stored
+    on instance.
+
+    Representations can be marked for review and in that case is also added
+    'review' family to instance families. For review can be marked only one
+    representation so **first** representation that has extension available
+    in '_review_extensions' is used for review.
+
+    For 'source' on instance is used path from last created representation.
+
+    Set staging directory on instance. That is probably never used because
+    each created representation has it's own staging dir.
+    """
 
     label = "Collect Settings Simple Instances"
     order = pyblish.api.CollectorOrder - 0.49

From 8083c1ed0aea6b0d9185d86c18d4b2e3c552ea50 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 13:42:30 +0200
Subject: [PATCH 1113/1227] remove not relevant lines

---
 .../traypublisher/plugins/publish/collect_simple_instances.py   | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index 424cf7d88d..e8e1c1013c 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -140,8 +140,6 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
         ).format(instance_label, len(repres), ", ".join(_repre_names)))
 
     def _calculate_source(self, filepaths):
-        if not filepaths:
-            return None
         cols, rems = clique.assemble(filepaths)
         if cols:
             source = cols[0].format("{head}{padding}{tail}")

From b5fa8b524e6fa13669e8f755c97d75f3ea217158 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 13:51:20 +0200
Subject: [PATCH 1114/1227] unify imports

---
 openpype/hosts/traypublisher/api/plugin.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/hosts/traypublisher/api/plugin.py b/openpype/hosts/traypublisher/api/plugin.py
index 6966935091..46fb4fdb51 100644
--- a/openpype/hosts/traypublisher/api/plugin.py
+++ b/openpype/hosts/traypublisher/api/plugin.py
@@ -1,9 +1,8 @@
-from openpype.lib.attribute_definitions import BoolDef
+from openpype.lib.attribute_definitions import BoolDef, FileDef
 from openpype.pipeline import (
     Creator,
     CreatedInstance
 )
-from openpype.lib import FileDef
 
 from .pipeline import (
     list_instances,

From 7729d53921659abe7751cd007cda78156681afc1 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 14:34:50 +0200
Subject: [PATCH 1115/1227] files item can have custom extensions label

---
 openpype/lib/attribute_definitions.py         | 13 +++++++---
 .../widgets/attribute_defs/files_widget.py    | 26 ++++++++++++++-----
 openpype/widgets/attribute_defs/widgets.py    |  5 +++-
 3 files changed, 34 insertions(+), 10 deletions(-)

diff --git a/openpype/lib/attribute_definitions.py b/openpype/lib/attribute_definitions.py
index a1f7c1e0f4..17658eef93 100644
--- a/openpype/lib/attribute_definitions.py
+++ b/openpype/lib/attribute_definitions.py
@@ -14,6 +14,7 @@ class AbstractAttrDefMeta(ABCMeta):
 
     Each object of `AbtractAttrDef` mus have defined 'key' attribute.
     """
+
     def __call__(self, *args, **kwargs):
         obj = super(AbstractAttrDefMeta, self).__call__(*args, **kwargs)
         init_class = getattr(obj, "__init__class__", None)
@@ -45,6 +46,7 @@ class AbtractAttrDef:
         is_label_horizontal(bool): UI specific argument. Specify if label is
             next to value input or ahead.
     """
+
     is_value_def = True
 
     def __init__(
@@ -77,6 +79,7 @@ class AbtractAttrDef:
         Convert passed value to a valid type. Use default if value can't be
         converted.
         """
+
         pass
 
 
@@ -113,6 +116,7 @@ class UnknownDef(AbtractAttrDef):
     This attribute can be used to keep existing data unchanged but does not
     have known definition of type.
     """
+
     def __init__(self, key, default=None, **kwargs):
         kwargs["default"] = default
         super(UnknownDef, self).__init__(key, **kwargs)
@@ -204,6 +208,7 @@ class TextDef(AbtractAttrDef):
         placeholder(str): UI placeholder for attribute.
         default(str, None): Default value. Empty string used when not defined.
     """
+
     def __init__(
         self, key, multiline=None, regex=None, placeholder=None, default=None,
         **kwargs
@@ -531,14 +536,15 @@ class FileDef(AbtractAttrDef):
     Args:
         single_item(bool): Allow only single path item.
         folders(bool): Allow folder paths.
-        extensions(list<str>): Allow files with extensions. Empty list will
+        extensions(List[str]): Allow files with extensions. Empty list will
             allow all extensions and None will disable files completely.
-        default(str, list<str>): Defautl value.
+        extensions_label(str): Custom label shown instead of extensions in UI.
+        default(str, List[str]): Default value.
     """
 
     def __init__(
         self, key, single_item=True, folders=None, extensions=None,
-        allow_sequences=True, default=None, **kwargs
+        allow_sequences=True, extensions_label=None, default=None, **kwargs
     ):
         if folders is None and extensions is None:
             folders = True
@@ -578,6 +584,7 @@ class FileDef(AbtractAttrDef):
         self.folders = folders
         self.extensions = set(extensions)
         self.allow_sequences = allow_sequences
+        self.extensions_label = extensions_label
         super(FileDef, self).__init__(key, default=default, **kwargs)
 
     def __eq__(self, other):
diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index 0b3a81e903..508da4893b 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -34,7 +34,7 @@ class SupportLabel(QtWidgets.QLabel):
 class DropEmpty(QtWidgets.QWidget):
     _empty_extensions = "Any file"
 
-    def __init__(self, single_item, allow_sequences, parent):
+    def __init__(self, single_item, allow_sequences, extensions_label, parent):
         super(DropEmpty, self).__init__(parent)
 
         drop_label_widget = QtWidgets.QLabel("Drag & Drop files here", self)
@@ -70,7 +70,11 @@ class DropEmpty(QtWidgets.QWidget):
 
         self._update_size_timer = update_size_timer
 
+        if extensions_label and not extensions_label.startswith(" "):
+            extensions_label = " " + extensions_label
+
         self._single_item = single_item
+        self._extensions_label = extensions_label
         self._allow_sequences = allow_sequences
         self._allowed_extensions = set()
         self._allow_folders = None
@@ -123,24 +127,32 @@ class DropEmpty(QtWidgets.QWidget):
             items_label = "Single "
 
         if len(allowed_items) == 1:
-            allowed_items_label = allowed_items[0]
+            extensions_label = allowed_items[0]
         elif len(allowed_items) == 2:
-            allowed_items_label = " or ".join(allowed_items)
+            extensions_label = " or ".join(allowed_items)
         else:
             last_item = allowed_items.pop(-1)
             new_last_item = " or ".join(last_item, allowed_items.pop(-1))
             allowed_items.append(new_last_item)
-            allowed_items_label = ", ".join(allowed_items)
+            extensions_label = ", ".join(allowed_items)
+
+        allowed_items_label = extensions_label
 
         items_label += allowed_items_label
+        label_tooltip = None
         if self._allowed_extensions:
             items_label += " of\n{}".format(
                 ", ".join(sorted(self._allowed_extensions))
             )
 
+        if self._extensions_label:
+            label_tooltip = items_label
+            items_label = self._extensions_label
+
         if self._items_label_widget.text() == items_label:
             return
 
+        self._items_label_widget.setToolTip(label_tooltip)
         self._items_label_widget.setText(items_label)
         self._update_size_timer.start()
 
@@ -618,11 +630,13 @@ class FilesView(QtWidgets.QListView):
 class FilesWidget(QtWidgets.QFrame):
     value_changed = QtCore.Signal()
 
-    def __init__(self, single_item, allow_sequences, parent):
+    def __init__(self, single_item, allow_sequences, extensions_label, parent):
         super(FilesWidget, self).__init__(parent)
         self.setAcceptDrops(True)
 
-        empty_widget = DropEmpty(single_item, allow_sequences, self)
+        empty_widget = DropEmpty(
+            single_item, allow_sequences, extensions_label, self
+        )
 
         files_model = FilesModel(single_item, allow_sequences)
         files_proxy_model = FilesProxyModel()
diff --git a/openpype/widgets/attribute_defs/widgets.py b/openpype/widgets/attribute_defs/widgets.py
index b6493b80a8..975b2df955 100644
--- a/openpype/widgets/attribute_defs/widgets.py
+++ b/openpype/widgets/attribute_defs/widgets.py
@@ -443,7 +443,10 @@ class UnknownAttrWidget(_BaseAttrDefWidget):
 class FileAttrWidget(_BaseAttrDefWidget):
     def _ui_init(self):
         input_widget = FilesWidget(
-            self.attr_def.single_item, self.attr_def.allow_sequences, self
+            self.attr_def.single_item,
+            self.attr_def.allow_sequences,
+            self.attr_def.extensions_label,
+            self
         )
 
         if self.attr_def.tooltip:

From 1baf0457baac213c2f443d02c217bcedfb5870f5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 14:35:31 +0200
Subject: [PATCH 1116/1227] added second file input for reviewables

---
 openpype/hosts/traypublisher/api/plugin.py | 38 ++++++++++++++++++----
 1 file changed, 32 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/traypublisher/api/plugin.py b/openpype/hosts/traypublisher/api/plugin.py
index 46fb4fdb51..cb02a5600e 100644
--- a/openpype/hosts/traypublisher/api/plugin.py
+++ b/openpype/hosts/traypublisher/api/plugin.py
@@ -1,4 +1,4 @@
-from openpype.lib.attribute_definitions import BoolDef, FileDef
+from openpype.lib.attribute_definitions import FileDef
 from openpype.pipeline import (
     Creator,
     CreatedInstance
@@ -12,6 +12,29 @@ from .pipeline import (
 )
 
 
+IMAGE_EXTENSIONS = [
+    ".ani", ".anim", ".apng", ".art", ".bmp", ".bpg", ".bsave", ".cal",
+    ".cin", ".cpc", ".cpt", ".dds", ".dpx", ".ecw", ".exr", ".fits",
+    ".flic", ".flif", ".fpx", ".gif", ".hdri", ".hevc", ".icer",
+    ".icns", ".ico", ".cur", ".ics", ".ilbm", ".jbig", ".jbig2",
+    ".jng", ".jpeg", ".jpeg-ls", ".jpeg", ".2000", ".jpg", ".xr",
+    ".jpeg", ".xt", ".jpeg-hdr", ".kra", ".mng", ".miff", ".nrrd",
+    ".ora", ".pam", ".pbm", ".pgm", ".ppm", ".pnm", ".pcx", ".pgf",
+    ".pictor", ".png", ".psb", ".psp", ".qtvr", ".ras",
+    ".rgbe", ".logluv", ".tiff", ".sgi", ".tga", ".tiff", ".tiff/ep",
+    ".tiff/it", ".ufo", ".ufp", ".wbmp", ".webp", ".xbm", ".xcf",
+    ".xpm", ".xwd"
+]
+VIDEO_EXTENSIONS = [
+    ".3g2", ".3gp", ".amv", ".asf", ".avi", ".drc", ".f4a", ".f4b",
+    ".f4p", ".f4v", ".flv", ".gif", ".gifv", ".m2v", ".m4p", ".m4v",
+    ".mkv", ".mng", ".mov", ".mp2", ".mp4", ".mpe", ".mpeg", ".mpg",
+    ".mpv", ".mxf", ".nsv", ".ogg", ".ogv", ".qt", ".rm", ".rmvb",
+    ".roq", ".svi", ".vob", ".webm", ".wmv", ".yuv"
+]
+REVIEW_EXTENSIONS = IMAGE_EXTENSIONS + VIDEO_EXTENSIONS
+
+
 class TrayPublishCreator(Creator):
     create_allow_context_change = True
     host_name = "traypublisher"
@@ -84,12 +107,16 @@ class SettingsCreator(TrayPublishCreator):
                 extensions=self.extensions,
                 allow_sequences=self.allow_sequences,
                 single_item=not self.allow_multiple_items,
-                label="Filepath",
+                label="Representations",
             ),
-            BoolDef(
+            FileDef(
                 "reviewable",
-                label="Reviewable",
-                default=self.reviewable
+                folders=False,
+                extensions=REVIEW_EXTENSIONS,
+                allow_sequences=True,
+                single_item=True,
+                label="Reviewable representations",
+                extensions_label="Single reviewable item"
             )
         ]
 
@@ -112,7 +139,6 @@ class SettingsCreator(TrayPublishCreator):
                 "extensions": item_data["extensions"],
                 "allow_sequences": item_data["allow_sequences"],
                 "allow_multiple_items": item_data["allow_multiple_items"],
-                "reviewable": item_data["reviewable"],
                 "default_variants": item_data["default_variants"]
             }
         )

From 8a6ee91ec2251939a9e9c8f5624765ad2c37b826 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 14:36:00 +0200
Subject: [PATCH 1117/1227] removed reviewable key from settings (unused)

---
 .../defaults/project_settings/traypublisher.json  | 15 +--------------
 .../schema_project_traypublisher.json             |  5 -----
 2 files changed, 1 insertion(+), 19 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/traypublisher.json b/openpype/settings/defaults/project_settings/traypublisher.json
index 619d54dbaf..80c4a6bed1 100644
--- a/openpype/settings/defaults/project_settings/traypublisher.json
+++ b/openpype/settings/defaults/project_settings/traypublisher.json
@@ -12,7 +12,6 @@
             "detailed_description": "Workfiles are full scenes from any application that are directly edited by artists. They represent a state of work on a task at a given point and are usually not directly referenced into other scenes.",
             "allow_sequences": false,
             "allow_multiple_items": false,
-            "reviewable": false,
             "extensions": [
                 ".ma",
                 ".mb",
@@ -47,7 +46,6 @@
             "detailed_description": "Models should only contain geometry data, without any extras like cameras, locators or bones.\n\nKeep in mind that models published from tray publisher are not validated for correctness. ",
             "allow_sequences": false,
             "allow_multiple_items": true,
-            "reviewable": false,
             "extensions": [
                 ".ma",
                 ".mb",
@@ -73,7 +71,6 @@
             "detailed_description": "Alembic or bgeo cache of animated data",
             "allow_sequences": true,
             "allow_multiple_items": true,
-            "reviewable": false,
             "extensions": [
                 ".abc",
                 ".bgeo",
@@ -97,7 +94,6 @@
             "detailed_description": "Any type of image seqeuence coming from outside of the studio. Usually camera footage, but could also be animatics used for reference.",
             "allow_sequences": true,
             "allow_multiple_items": true,
-            "reviewable": true,
             "extensions": [
                 ".exr",
                 ".png",
@@ -120,7 +116,6 @@
             "detailed_description": "Sequence or single file renders",
             "allow_sequences": true,
             "allow_multiple_items": true,
-            "reviewable": true,
             "extensions": [
                 ".exr",
                 ".png",
@@ -144,7 +139,6 @@
             "detailed_description": "Ideally this should be only camera itself with baked animation, however, it can technically also include helper geometry.",
             "allow_sequences": false,
             "allow_multiple_items": true,
-            "reviewable": false,
             "extensions": [
                 ".abc",
                 ".ma",
@@ -169,7 +163,6 @@
             "detailed_description": "Any image data can be published as image family. References, textures, concept art, matte paints. This is a fallback 2d family for everything that doesn't fit more specific family.",
             "allow_sequences": false,
             "allow_multiple_items": true,
-            "reviewable": true,
             "extensions": [
                 ".exr",
                 ".jpg",
@@ -193,7 +186,6 @@
             "detailed_description": "Hierarchical data structure for the efficient storage and manipulation of sparse volumetric data discretized on three-dimensional grids",
             "allow_sequences": true,
             "allow_multiple_items": true,
-            "reviewable": false,
             "extensions": [
                 ".vdb"
             ]
@@ -212,7 +204,6 @@
             "detailed_description": "Script exported from matchmoving application to be later processed into a tracked camera with additional data",
             "allow_sequences": false,
             "allow_multiple_items": true,
-            "reviewable": false,
             "extensions": []
         },
         {
@@ -225,7 +216,6 @@
             "detailed_description": "CG rigged character or prop. Rig should be clean of any extra data and directly loadable into it's respective application\t",
             "allow_sequences": false,
             "allow_multiple_items": false,
-            "reviewable": false,
             "extensions": [
                 ".ma",
                 ".blend",
@@ -238,14 +228,11 @@
             "identifier": "",
             "label": "Simple UE texture",
             "icon": "fa.image",
-            "default_variants": [
-                ""
-            ],
+            "default_variants": [],
             "description": "Simple Unreal Engine texture",
             "detailed_description": "Texture files with Unreal Engine naming conventions",
             "allow_sequences": false,
             "allow_multiple_items": true,
-            "reviewable": false,
             "extensions": []
         }
     ]
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
index 269b47459c..f11621c76e 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
@@ -72,11 +72,6 @@
                         "label": "Allow multiple items",
                         "type": "boolean"
                     },
-                    {
-                        "key": "reviewable",
-                        "label": "Reviewable",
-                        "type": "boolean"
-                    },
                     {
                         "type": "list",
                         "key": "extensions",

From 64b4bdaf880a8b639e921045c4c14a2d6b0cd95b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 15:19:25 +0200
Subject: [PATCH 1118/1227] handle review representations using reviewable file
 input

---
 .../publish/collect_simple_instances.py       | 249 +++++++++++-------
 1 file changed, 154 insertions(+), 95 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index e8e1c1013c..b4328d948c 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -1,5 +1,4 @@
 import os
-import json
 import tempfile
 
 import clique
@@ -28,28 +27,6 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
 
     hosts = ["traypublisher"]
 
-    _image_extensions = [
-        ".ani", ".anim", ".apng", ".art", ".bmp", ".bpg", ".bsave", ".cal",
-        ".cin", ".cpc", ".cpt", ".dds", ".dpx", ".ecw", ".exr", ".fits",
-        ".flic", ".flif", ".fpx", ".gif", ".hdri", ".hevc", ".icer",
-        ".icns", ".ico", ".cur", ".ics", ".ilbm", ".jbig", ".jbig2",
-        ".jng", ".jpeg", ".jpeg-ls", ".jpeg", ".2000", ".jpg", ".xr",
-        ".jpeg", ".xt", ".jpeg-hdr", ".kra", ".mng", ".miff", ".nrrd",
-        ".ora", ".pam", ".pbm", ".pgm", ".ppm", ".pnm", ".pcx", ".pgf",
-        ".pictor", ".png", ".psb", ".psp", ".qtvr", ".ras",
-        ".rgbe", ".logluv", ".tiff", ".sgi", ".tga", ".tiff", ".tiff/ep",
-        ".tiff/it", ".ufo", ".ufp", ".wbmp", ".webp", ".xbm", ".xcf",
-        ".xpm", ".xwd"
-    ]
-    _video_extensions = [
-        ".3g2", ".3gp", ".amv", ".asf", ".avi", ".drc", ".f4a", ".f4b",
-        ".f4p", ".f4v", ".flv", ".gif", ".gifv", ".m2v", ".m4p", ".m4v",
-        ".mkv", ".mng", ".mov", ".mp2", ".mp4", ".mpe", ".mpeg", ".mpg",
-        ".mpv", ".mxf", ".nsv", ".ogg", ".ogv", ".qt", ".rm", ".rmvb",
-        ".roq", ".svi", ".vob", ".webm", ".wmv", ".yuv"
-    ]
-    _review_extensions = _image_extensions + _video_extensions
-
     def process(self, instance):
         if not instance.data.get("settings_creator"):
             return
@@ -64,97 +41,133 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
             "Created temp staging directory for instance {}. {}"
         ).format(instance_label, tmp_folder))
 
-        repres = instance.data["representations"]
+        # Store filepaths for validation of their existence
+        source_filepaths = []
+        # Make sure there are no representations with same name
+        repre_names_counter = {}
+        # Store created names for logging
+        repre_names = []
+        # Store set of filepaths per each representation
+        representation_files_mapping = []
+        source = self._create_main_representations(
+            instance,
+            source_filepaths,
+            repre_names_counter,
+            repre_names,
+            representation_files_mapping
+        )
 
+        self._create_review_representation(
+            instance,
+            source_filepaths,
+            repre_names_counter,
+            repre_names,
+            representation_files_mapping
+        )
+
+        instance.data["source"] = source
+        instance.data["sourceFilepaths"] = list(set(source_filepaths))
+
+        self.log.debug(
+            (
+                "Created Simple Settings instance \"{}\""
+                " with {} representations: {}"
+            ).format(
+                instance_label,
+                len(instance.data["representations"]),
+                ", ".join(repre_names)
+            )
+        )
+
+    def _create_main_representations(
+        self,
+        instance,
+        source_filepaths,
+        repre_names_counter,
+        repre_names,
+        representation_files_mapping
+    ):
         creator_attributes = instance.data["creator_attributes"]
-        self.log.info(json.dumps(creator_attributes))
         filepath_items = creator_attributes["filepath"]
         if not isinstance(filepath_items, list):
             filepath_items = [filepath_items]
 
-        # Last found representation is used as source for instance
         source = None
-        # Check if review is enabled and should be created
-        reviewable = creator_attributes.get("reviewable")
-        # Store review representation - first found that can be used for
-        #   review is stored
-        review_representation = None
-        review_path = None
-
-        # Make sure there are no representations with same name
-        repre_names_counter = {}
-        # Store created names for logging
-        _repre_names = []
-        # Store filepaths for validation of their existence
-        source_filepaths = []
-
-        # Create representations
         for filepath_item in filepath_items:
-            filepaths = [
+            # Skip if filepath item does not have filenames
+            if not filepath_item["filenames"]:
+                continue
+
+            filepaths = {
                 os.path.join(filepath_item["directory"], filename)
                 for filename in filepath_item["filenames"]
-            ]
+            }
             source_filepaths.extend(filepaths)
 
             source = self._calculate_source(filepaths)
-            filenames = filepath_item["filenames"]
-            _, ext = os.path.splitext(filenames[0])
-            if len(filenames) == 1:
-                filenames = filenames[0]
-
-            repre_name = repre_ext = ext[1:]
-            if repre_name not in repre_names_counter:
-                repre_names_counter[repre_name] = 2
-            else:
-                counter = repre_names_counter[repre_name]
-                repre_names_counter[repre_name] += 1
-                repre_name = "{}_{}".format(repre_name, counter)
-
-            _repre_names.append('"{}"'.format(repre_name))
-            representation = {
-                "ext": repre_ext,
-                "name": repre_name,
-                "stagingDir": filepath_item["directory"],
-                "files": filenames,
-                "tags": []
-            }
-            repres.append(representation)
-
-            if (
-                reviewable
-                and review_representation is None
-                and ext in self._review_extensions
-            ):
-                review_representation = representation
-                review_path = source
-
-        instance.data["source"] = source
-        instance.data["sourceFilepaths"] = source_filepaths
-
-        if reviewable:
-            self._prepare_review(instance, review_representation, review_path)
-
-        self.log.debug((
-            "Created Simple Settings instance \"{}\""
-            " with {} representations: {}"
-        ).format(instance_label, len(repres), ", ".join(_repre_names)))
-
-    def _calculate_source(self, filepaths):
-        cols, rems = clique.assemble(filepaths)
-        if cols:
-            source = cols[0].format("{head}{padding}{tail}")
-        elif rems:
-            source = rems[0]
+            representation = self._create_representation_data(
+                filepath_item, repre_names_counter, repre_names
+            )
+            instance.data["representations"].append(representation)
+            representation_files_mapping.append(
+                (filepaths, representation, source)
+            )
         return source
 
-    def _prepare_review(self, instance, review_representation, review_path):
-        if not review_representation:
+    def _create_review_representation(
+        self,
+        instance,
+        source_filepaths,
+        repre_names_counter,
+        repre_names,
+        representation_files_mapping
+    ):
+        # Skip review representation creation if there are no representations
+        #   created for "main" part
+        #   - review representation must not be created in that case so
+        #       validation can care about it
+        if not representation_files_mapping:
             self.log.warning((
-                "Didn't find any representation"
-                " that could be used as source for review"
+                "There are missing source representations."
+                " Creation of review representation was skipped."
             ))
             return
 
+        creator_attributes = instance.data["creator_attributes"]
+        review_file_item = creator_attributes["reviewable"]
+        filenames = review_file_item.get("filenames")
+        if not filenames:
+            self.log.debug((
+                "Filepath for review is not defined."
+                " Skipping review representation creation."
+            ))
+            return
+
+        filepaths = {
+            os.path.join(review_file_item["directory"], filename)
+            for filename in filenames
+        }
+        source_filepaths.extend(filepaths)
+        # First try to find out representation with same filepaths
+        #   so it's not needed to create new representation just for review
+        review_representation = None
+        # Review path (only for logging)
+        review_path = None
+        for item in representation_files_mapping:
+            _filepaths, representation, repre_path = item
+            if _filepaths == filepaths:
+                review_representation = representation
+                review_path = repre_path
+                break
+
+        if review_representation is None:
+            self.log.debug("Creating new review representation")
+            review_path = self._calculate_source(filepaths)
+            review_representation = self._create_representation_data(
+                review_file_item, repre_names_counter, repre_names
+            )
+            instance.data["representations"].append(review_representation)
+
         if "review" not in instance.data["families"]:
             instance.data["families"].append("review")
 
@@ -162,3 +175,49 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
         self.log.debug("Representation {} was marked for review. {}".format(
             review_representation["name"], review_path
         ))
+
+    def _create_representation_data(
+        self, filepath_item, repre_names_counter, repre_names
+    ):
+        """Create new representation data based on file item.
+
+        Args:
+            filepath_item (Dict[str, Any]): Item with information about
+                representation paths.
+            repre_names_counter (Dict[str, int]): Store count of representation
+                names.
+            repre_names (List[str]): All used representation names. For
+                logging purposes.
+
+        Returns:
+            Dict: Prepared base representation data.
+        """
+
+        filenames = filepath_item["filenames"]
+        _, ext = os.path.splitext(filenames[0])
+        if len(filenames) == 1:
+            filenames = filenames[0]
+
+        repre_name = repre_ext = ext[1:]
+        if repre_name not in repre_names_counter:
+            repre_names_counter[repre_name] = 2
+        else:
+            counter = repre_names_counter[repre_name]
+            repre_names_counter[repre_name] += 1
+            repre_name = "{}_{}".format(repre_name, counter)
+        repre_names.append(repre_names)
+        return {
+            "ext": repre_ext,
+            "name": repre_name,
+            "stagingDir": filepath_item["directory"],
+            "files": filenames,
+            "tags": []
+        }
+
+    def _calculate_source(self, filepaths):
+        cols, rems = clique.assemble(filepaths)
+        if cols:
+            source = cols[0].format("{head}{padding}{tail}")
+        elif rems:
+            source = rems[0]
+        return source

From 1561a4790661dbfe1411b31fe58dcf77cb4bacf7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 15:19:45 +0200
Subject: [PATCH 1119/1227] changed key 'filepath' to 'representation_files'

---
 openpype/hosts/traypublisher/api/plugin.py                      | 2 +-
 .../traypublisher/plugins/publish/collect_simple_instances.py   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/traypublisher/api/plugin.py b/openpype/hosts/traypublisher/api/plugin.py
index cb02a5600e..9b9425855e 100644
--- a/openpype/hosts/traypublisher/api/plugin.py
+++ b/openpype/hosts/traypublisher/api/plugin.py
@@ -102,7 +102,7 @@ class SettingsCreator(TrayPublishCreator):
     def get_instance_attr_defs(self):
         return [
             FileDef(
-                "filepath",
+                "representation_files",
                 folders=False,
                 extensions=self.extensions,
                 allow_sequences=self.allow_sequences,
diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index b4328d948c..15dac9a4c0 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -88,7 +88,7 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
         representation_files_mapping
     ):
         creator_attributes = instance.data["creator_attributes"]
-        filepath_items = creator_attributes["filepath"]
+        filepath_items = creator_attributes["representation_files"]
         if not isinstance(filepath_items, list):
             filepath_items = [filepath_items]
 

From 2b1654a1e24d70c215cbfcc4e8d0922dcb663a9f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 15:22:19 +0200
Subject: [PATCH 1120/1227] fix variable usage

---
 .../traypublisher/plugins/publish/collect_simple_instances.py   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index 15dac9a4c0..a5b95138bd 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -205,7 +205,7 @@ class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
             counter = repre_names_counter[repre_name]
             repre_names_counter[repre_name] += 1
             repre_name = "{}_{}".format(repre_name, counter)
-        repre_names.append(repre_names)
+        repre_names.append(repre_name)
         return {
             "ext": repre_ext,
             "name": repre_name,

From 97492867cbcbc528499dc7c0c4490fafa4e945c3 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 16:11:01 +0200
Subject: [PATCH 1121/1227] modified docstring

---
 .../plugins/publish/collect_simple_instances.py       | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
index a5b95138bd..c0ae694c3c 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_simple_instances.py
@@ -8,15 +8,20 @@ import pyblish.api
 class CollectSettingsSimpleInstances(pyblish.api.InstancePlugin):
     """Collect data for instances created by settings creators.
 
-    Plugin create representations based on 'filepath' attribute stored
-    on instance.
+    Plugin create representations for simple instances based
+    on 'representation_files' attribute stored on instance data.
+
+    There is also possibility to have reviewable representation which can be
+    stored under 'reviewable' attribute stored on instance data. If there was
+    already created representation with the same files as 'revieable' containes
 
     Representations can be marked for review and in that case is also added
     'review' family to instance families. For review can be marked only one
     representation so **first** representation that has extension available
     in '_review_extensions' is used for review.
 
-    For 'source' on instance is used path from last created representation.
+    For instance 'source' is used path from last representation created
+    from 'representation_files'.
 
     Set staging directory on instance. That is probably never used because
     each created representation has it's own staging dir.

From c3649e0a571048cb0660656ce9dcf10176399b5d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Thu, 14 Jul 2022 16:31:32 +0200
Subject: [PATCH 1122/1227] :bug: fix rfm api context for getting displays and
 multipart flag

---
 openpype/hosts/maya/api/lib_renderproducts.py | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/maya/api/lib_renderproducts.py b/openpype/hosts/maya/api/lib_renderproducts.py
index 2d3bda5245..a8337ccf4d 100644
--- a/openpype/hosts/maya/api/lib_renderproducts.py
+++ b/openpype/hosts/maya/api/lib_renderproducts.py
@@ -1087,7 +1087,7 @@ class RenderProductsRenderman(ARenderProducts):
             "d_tiff": "tif"
         }
 
-        displays = get_displays()["displays"]
+        displays = get_displays(override_dst="render")["displays"]
         for name, display in displays.items():
             enabled = display["params"]["enable"]["value"]
             if not enabled:
@@ -1106,9 +1106,16 @@ class RenderProductsRenderman(ARenderProducts):
                 display["driverNode"]["type"], "exr")
 
             for camera in cameras:
-                product = RenderProduct(productName=aov_name,
-                                        ext=extensions,
-                                        camera=camera)
+                # Create render product and set it as multipart only on
+                # display types supporting it. In all other cases, Renderman
+                # will create separate output per channel.
+                product = RenderProduct(
+                    productName=aov_name,
+                    ext=extensions,
+                    camera=camera,
+                    multipart=display["driverNode"]["type"] in ["d_openexr", "d_deepexr", "d_tiff"]  # noqa
+                )
+
                 products.append(product)
 
         return products

From fbd239299f70105486db3276c218adfcccdf1e82 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Thu, 14 Jul 2022 17:00:26 +0200
Subject: [PATCH 1123/1227] :recycle: comment on non-multipart code and raise
 exception

---
 openpype/hosts/maya/api/lib_renderproducts.py | 32 +++++++++++++++----
 1 file changed, 26 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/maya/api/lib_renderproducts.py b/openpype/hosts/maya/api/lib_renderproducts.py
index a8337ccf4d..0bc8682290 100644
--- a/openpype/hosts/maya/api/lib_renderproducts.py
+++ b/openpype/hosts/maya/api/lib_renderproducts.py
@@ -1109,12 +1109,28 @@ class RenderProductsRenderman(ARenderProducts):
                 # Create render product and set it as multipart only on
                 # display types supporting it. In all other cases, Renderman
                 # will create separate output per channel.
-                product = RenderProduct(
-                    productName=aov_name,
-                    ext=extensions,
-                    camera=camera,
-                    multipart=display["driverNode"]["type"] in ["d_openexr", "d_deepexr", "d_tiff"]  # noqa
-                )
+                if display["driverNode"]["type"] in ["d_openexr", "d_deepexr", "d_tiff"]:  # noqa
+                    product = RenderProduct(
+                        productName=aov_name,
+                        ext=extensions,
+                        camera=camera,
+                        multipart=True
+                    )
+                else:
+                    # this code should handle the case where no multipart
+                    # capable format is selected. But since it involves
+                    # shady logic to determine what channel become what
+                    # lets not do that as all productions will use exr anyway.
+                    """
+                    for channel in display['params']['displayChannels']['value']:  # noqa
+                        product = RenderProduct(
+                            productName="{}_{}".format(aov_name, channel),
+                            ext=extensions,
+                            camera=camera,
+                            multipart=False
+                        )
+                    """
+                    raise UnsupportedImageFormatException("Only exr, deep exr and tiff formats are supported.")
 
                 products.append(product)
 
@@ -1208,3 +1224,7 @@ class UnsupportedRendererException(Exception):
 
     Raised when requesting data from unsupported renderer.
     """
+
+
+class UnsupportedImageFormatException(Exception):
+    """Custom exception to report unsupported output image format."""

From ef5b571ea6dbfae4df12a18f8412a4e90a88cf1d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Thu, 14 Jul 2022 17:17:25 +0200
Subject: [PATCH 1124/1227] :dog: hound fix

---
 openpype/hosts/maya/api/lib_renderproducts.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/api/lib_renderproducts.py b/openpype/hosts/maya/api/lib_renderproducts.py
index 0bc8682290..123b934428 100644
--- a/openpype/hosts/maya/api/lib_renderproducts.py
+++ b/openpype/hosts/maya/api/lib_renderproducts.py
@@ -1130,7 +1130,8 @@ class RenderProductsRenderman(ARenderProducts):
                             multipart=False
                         )
                     """
-                    raise UnsupportedImageFormatException("Only exr, deep exr and tiff formats are supported.")
+                    raise UnsupportedImageFormatException(
+                        "Only exr, deep exr and tiff formats are supported.")
 
                 products.append(product)
 

From f346fb8cfd3b59d85b961cba5026cd8e0f66e21a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 17:38:01 +0200
Subject: [PATCH 1125/1227] implemented helper function for loading of internal
 data

---
 .../widgets/attribute_defs/files_widget.py    | 29 ++++++++++++-------
 1 file changed, 18 insertions(+), 11 deletions(-)

diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index 508da4893b..9b4b1d6dc7 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -27,6 +27,20 @@ IS_SEQUENCE_ROLE = QtCore.Qt.UserRole + 7
 EXT_ROLE = QtCore.Qt.UserRole + 8
 
 
+def convert_bytes_to_json(bytes_value):
+    if isinstance(bytes_value, QtCore.QByteArray):
+        # Raw data are already QByteArray and we don't have to load them
+        encoded_data = bytes_value
+    else:
+        encoded_data = QtCore.QByteArray.fromRawData(bytes_value)
+    stream = QtCore.QDataStream(encoded_data, QtCore.QIODevice.ReadOnly)
+    text = stream.readQString()
+    try:
+        return json.loads(text)
+    except Exception:
+        return None
+
+
 class SupportLabel(QtWidgets.QLabel):
     pass
 
@@ -300,17 +314,10 @@ class FilesModel(QtGui.QStandardItemModel):
         return mime_data
 
     def dropMimeData(self, mime_data, action, row, col, index):
-        internal_move_data = mime_data.data("files_widget/internal_move")
-        if isinstance(internal_move_data, QtCore.QByteArray):
-            # Raw data are already QByteArrat and we don't have to load them
-            encoded_data = internal_move_data
-        else:
-            encoded_data = QtCore.QByteArray.fromRawData(internal_move_data)
-        stream = QtCore.QDataStream(encoded_data, QtCore.QIODevice.ReadOnly)
-        text = stream.readQString()
-        try:
-            item_ids = json.loads(text)
-        except Exception:
+        item_ids = convert_bytes_to_json(
+            mime_data.data("files_widget/internal_move")
+        )
+        if item_ids is None:
             return False
 
         # Find matching item after which will be items moved

From ef515039a0a356f2ad5571f20d20976ae799563a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 17:40:01 +0200
Subject: [PATCH 1126/1227] added helper method for conversion of data to bytes

---
 openpype/widgets/attribute_defs/files_widget.py | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index 9b4b1d6dc7..26398020ed 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -41,6 +41,13 @@ def convert_bytes_to_json(bytes_value):
         return None
 
 
+def convert_data_to_bytes(data):
+    bytes_value = QtCore.QByteArray()
+    stream = QtCore.QDataStream(bytes_value, QtCore.QIODevice.WriteOnly)
+    stream.writeQString(json.dumps(data))
+    return bytes_value
+
+
 class SupportLabel(QtWidgets.QLabel):
     pass
 
@@ -306,11 +313,10 @@ class FilesModel(QtGui.QStandardItemModel):
             index.data(ITEM_ID_ROLE)
             for index in indexes
         ]
-        encoded_data = QtCore.QByteArray()
-        stream = QtCore.QDataStream(encoded_data, QtCore.QIODevice.WriteOnly)
-        stream.writeQString(json.dumps(item_ids))
-        mime_data = super(FilesModel, self).mimeData(indexes)
-        mime_data.setData("files_widget/internal_move", encoded_data)
+
+        item_ids_data = convert_data_to_bytes(item_ids)
+        mime_data = QtCore.QMimeData()
+        mime_data.setData("files_widget/internal_move", item_ids_data)
         return mime_data
 
     def dropMimeData(self, mime_data, action, row, col, index):

From 53dd6cf11159b7732ce81ff05a533dd7e4affaa0 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 17:45:39 +0200
Subject: [PATCH 1127/1227] it is possible to move file items across widgets

---
 .../widgets/attribute_defs/files_widget.py    | 65 ++++++++++++++++++-
 1 file changed, 64 insertions(+), 1 deletion(-)

diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index 26398020ed..98f1d2738a 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -225,6 +225,7 @@ class FilesModel(QtGui.QStandardItemModel):
     def __init__(self, single_item, allow_sequences):
         super(FilesModel, self).__init__()
 
+        self._id = str(uuid.uuid4())
         self._single_item = single_item
         self._multivalue = False
         self._allow_sequences = allow_sequences
@@ -234,6 +235,10 @@ class FilesModel(QtGui.QStandardItemModel):
         self._filenames_by_dirpath = collections.defaultdict(set)
         self._items_by_dirpath = collections.defaultdict(list)
 
+    @property
+    def id(self):
+        return self._id
+
     def set_multivalue(self, multivalue):
         """Disable filtering."""
 
@@ -315,8 +320,20 @@ class FilesModel(QtGui.QStandardItemModel):
         ]
 
         item_ids_data = convert_data_to_bytes(item_ids)
-        mime_data = QtCore.QMimeData()
+        mime_data = super(FilesModel, self).mimeData(indexes)
         mime_data.setData("files_widget/internal_move", item_ids_data)
+
+        file_items = []
+        for item_id in item_ids:
+            file_item = self.get_file_item_by_id(item_id)
+            if file_item:
+                file_items.append(file_item.to_dict())
+
+        full_item_data = convert_data_to_bytes({
+            "items": file_items,
+            "id": self._id
+        })
+        mime_data.setData("files_widget/full_data", full_item_data)
         return mime_data
 
     def dropMimeData(self, mime_data, action, row, col, index):
@@ -858,6 +875,11 @@ class FilesWidget(QtWidgets.QFrame):
                 event.setDropAction(QtCore.Qt.CopyAction)
                 event.accept()
 
+        full_data_value = mime_data.data("files_widget/full_data")
+        if self._handle_full_data_drag(full_data_value):
+            event.setDropAction(QtCore.Qt.CopyAction)
+            event.accept()
+
     def dragLeaveEvent(self, event):
         event.accept()
 
@@ -868,6 +890,7 @@ class FilesWidget(QtWidgets.QFrame):
         mime_data = event.mimeData()
         if mime_data.hasUrls():
             event.accept()
+            # event.setDropAction(QtCore.Qt.CopyAction)
             filepaths = []
             for url in mime_data.urls():
                 filepath = url.toLocalFile()
@@ -879,8 +902,48 @@ class FilesWidget(QtWidgets.QFrame):
             if filepaths:
                 self._add_filepaths(filepaths)
 
+        if self._handle_full_data_drop(
+            mime_data.data("files_widget/full_data")
+        ):
+            event.accept()
+            event.setDropAction(QtCore.Qt.CopyAction)
+
+        # print(self._files_model.id, event)
         super(FilesWidget, self).dropEvent(event)
 
+    def _handle_full_data_drag(self, value):
+        if value is None:
+            return False
+
+        full_data = convert_bytes_to_json(value)
+        if full_data is None:
+            return False
+
+        if full_data["id"] == self._files_model.id:
+            return False
+        return True
+
+    def _handle_full_data_drop(self, value):
+        if value is None:
+            return False
+
+        full_data = convert_bytes_to_json(value)
+        if full_data is None:
+            return False
+
+        if full_data["id"] == self._files_model.id:
+            return False
+
+        for item in full_data["items"]:
+            filepaths = [
+                os.path.join(item["directory"], filename)
+                for filename in item["filenames"]
+            ]
+            filepaths = self._files_proxy_model.filter_valid_files(filepaths)
+            if filepaths:
+                self._add_filepaths(filepaths)
+        return True
+
     def _add_filepaths(self, filepaths):
         self._files_model.add_filepaths(filepaths)
         self._update_visibility()

From 9a83b83bb53837ffc84fb72f347a5c8875d9f6c1 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 17:50:24 +0200
Subject: [PATCH 1128/1227] it is possible to copy file items

---
 openpype/widgets/attribute_defs/files_widget.py | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index 98f1d2738a..d29aa1b607 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -905,10 +905,9 @@ class FilesWidget(QtWidgets.QFrame):
         if self._handle_full_data_drop(
             mime_data.data("files_widget/full_data")
         ):
-            event.accept()
             event.setDropAction(QtCore.Qt.CopyAction)
+            event.accept()
 
-        # print(self._files_model.id, event)
         super(FilesWidget, self).dropEvent(event)
 
     def _handle_full_data_drag(self, value):
@@ -942,8 +941,19 @@ class FilesWidget(QtWidgets.QFrame):
             filepaths = self._files_proxy_model.filter_valid_files(filepaths)
             if filepaths:
                 self._add_filepaths(filepaths)
+
+        if self._copy_modifiers_enabled():
+            return False
         return True
 
+    def _copy_modifiers_enabled(self):
+        if (
+            QtWidgets.QApplication.keyboardModifiers()
+            & QtCore.Qt.ControlModifier
+        ):
+            return True
+        return False
+
     def _add_filepaths(self, filepaths):
         self._files_model.add_filepaths(filepaths)
         self._update_visibility()

From e0fe2e84b5225a47e9c64472a91d74691d46f5dc Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 14 Jul 2022 18:22:48 +0200
Subject: [PATCH 1129/1227] remove unnecessary line edit

---
 openpype/widgets/attribute_defs/widgets.py | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/openpype/widgets/attribute_defs/widgets.py b/openpype/widgets/attribute_defs/widgets.py
index e4c4aba170..d0ba8814c7 100644
--- a/openpype/widgets/attribute_defs/widgets.py
+++ b/openpype/widgets/attribute_defs/widgets.py
@@ -379,11 +379,6 @@ class EnumAttrWidget(_BaseAttrDefWidget):
         combo_delegate = QtWidgets.QStyledItemDelegate(input_widget)
         input_widget.setItemDelegate(combo_delegate)
 
-        line_edit = QtWidgets.QLineEdit(input_widget)
-        line_edit.setReadOnly(True)
-        line_edit.setAttribute(QtCore.Qt.WA_TransparentForMouseEvents)
-        input_widget.setLineEdit(line_edit)
-
         if self.attr_def.tooltip:
             input_widget.setToolTip(self.attr_def.tooltip)
 

From a6c029d9fb1462054ca74817393beaebf32c7346 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 10:13:32 +0200
Subject: [PATCH 1130/1227] skip validation of zou id

---
 openpype/modules/kitsu/utils/sync_service.py | 17 ++++-------------
 1 file changed, 4 insertions(+), 13 deletions(-)

diff --git a/openpype/modules/kitsu/utils/sync_service.py b/openpype/modules/kitsu/utils/sync_service.py
index 3848eda7ae..441b95a7ec 100644
--- a/openpype/modules/kitsu/utils/sync_service.py
+++ b/openpype/modules/kitsu/utils/sync_service.py
@@ -4,7 +4,8 @@ import gazu
 
 from openpype.client import (
     get_project,
-    get_assets
+    get_assets,
+    get_asset_by_name
 )
 from openpype.pipeline import AvalonMongoDB
 from .credentials import validate_credentials
@@ -350,18 +351,8 @@ class Listener:
 
         # Find asset doc
         parent_name = task["entity"]["name"]
-        parent_zou_id = task["entity"]["id"]
-        asset_docs = get_assets(
-            project_name,
-            asset_names=[parent_name],
-            fields=["_id", "data.zou.id", "data.tasks"]
-        )
-        asset_doc = None
-        for _asset_doc in asset_docs:
-            doc_zou_id = _asset_doc.get("data", {}).get("zou", {}).get("id")
-            if doc_zou_id == parent_zou_id:
-                asset_doc = _asset_doc
-                break
+
+        asset_doc = get_asset_by_name(project_name, parent_name)
 
         # Update asset tasks with new one
         asset_tasks = asset_doc["data"].get("tasks")

From c210c93b325aaef0aac5f90fddbe5253a4702166 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 10:15:32 +0200
Subject: [PATCH 1131/1227] changes from comments

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index a68d6d31c3..4695a49159 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -39,14 +39,14 @@ def create_op_asset(gazu_entity: dict) -> dict:
     }
 
 
-def get_kitsu_project_name(project_id: str)->str:
+def get_kitsu_project_name(project_id: str) -> str:
     """Get project name based on project id in kitsu.
 
     Args:
-        project_id (str): Id of project in Kitsu.
+        project_id (str): UUID of project in Kitsu.
 
     Returns:
-        str: Project name which has project in Kitsu.
+        str: Name of Kitsu project.
     """
 
     project = gazu.project.get_project(project_id)
@@ -178,7 +178,7 @@ def update_op_assets(
             asset_doc_ids[parent_zou_id]["_id"] if parent_zou_id else None
         )
         if visual_parent_doc_id is None:
-            # Find root folder doc
+            # Find root folder docs
             root_folder_docs = get_assets(
                 project_name,
                 asset_name=[entity_parent_folders[-1]],

From baa1256b380630b0d23f4a57ed34431e947d4c85 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 11:22:22 +0200
Subject: [PATCH 1132/1227] added settings to define when cycle review session
 creation happens

---
 .../defaults/project_settings/ftrack.json     |  5 ++++
 .../schema_project_ftrack.json                | 25 +++++++++++++++++++
 2 files changed, 30 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/ftrack.json b/openpype/settings/defaults/project_settings/ftrack.json
index 831c34835e..b102b340be 100644
--- a/openpype/settings/defaults/project_settings/ftrack.json
+++ b/openpype/settings/defaults/project_settings/ftrack.json
@@ -124,6 +124,11 @@
                 "Project Manager"
             ],
             "cycle_enabled": false,
+            "cycle_hour_start": [
+                0,
+                0,
+                0
+            ],
             "review_session_template": "{yy}{mm}{dd}"
         }
     },
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json b/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
index c0069dcdab..4119184ca9 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
@@ -412,6 +412,31 @@
                             "key": "cycle_enabled",
                             "label": "Create daily review session"
                         },
+                        {
+                            "type": "list-strict",
+                            "key": "cycle_hour_start",
+                            "label": "Create daily review session at",
+                            "tooltip": "This may take affect on next day",
+                            "object_types": [
+                                {
+                                    "label": "HMS",
+                                    "type": "number",
+                                    "minimum": 0,
+                                    "maximum": 23,
+                                    "decimal": 0
+                                }, {
+                                    "type": "number",
+                                    "minimum": 0,
+                                    "maximum": 59,
+                                    "decimal": 0
+                                }, {
+                                    "type": "number",
+                                    "minimum": 0,
+                                    "maximum": 59,
+                                    "decimal": 0
+                                }
+                            ]
+                        },
                         {
                             "type": "separator"
                         },

From beb53f7ccb513cd37a54a19b366ecccf120b8605 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 11:23:07 +0200
Subject: [PATCH 1133/1227] use time settings to determine when to trigger
 creation

---
 .../action_create_review_session.py           | 63 ++++++++++++-------
 1 file changed, 42 insertions(+), 21 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py b/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
index 8a8e86e7b9..68d498a83a 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
@@ -6,7 +6,10 @@ import collections
 import ftrack_api
 
 from openpype.lib import get_datetime_data
-from openpype.api import get_project_settings
+from openpype.settings.lib import (
+    get_project_settings,
+    get_default_project_settings
+)
 from openpype_modules.ftrack.lib import ServerAction
 
 
@@ -79,6 +82,35 @@ class CreateDailyReviewSessionServerAction(ServerAction):
         )
         return True
 
+    def _calculate_next_cycle_delta(self):
+        studio_default_settings = get_default_project_settings()
+        action_settings = (
+            studio_default_settings
+            ["ftrack"]
+            [self.settings_frack_subkey]
+            [self.settings_key]
+        )
+        cycle_hour_start = action_settings.get("cycle_hour_start")
+        if not cycle_hour_start:
+            h = m = s = 0
+        else:
+            h, m, s = cycle_hour_start
+
+        # Create threading timer which will trigger creation of report
+        #   at the 00:00:01 of next day
+        # - callback will trigger another timer which will have 1 day offset
+        now = datetime.datetime.now()
+        # Create object of today morning
+        expected_next_trigger = datetime.datetime(
+            now.year, now.month, now.day, h, m, s
+        )
+        if expected_next_trigger > now:
+            seconds = (expected_next_trigger - now).total_seconds()
+        else:
+            expected_next_trigger += self._day_delta
+            seconds = (expected_next_trigger - now).total_seconds()
+        return seconds, expected_next_trigger
+
     def register(self, *args, **kwargs):
         """Override register to be able trigger """
         # Register server action as would be normally
@@ -86,22 +118,12 @@ class CreateDailyReviewSessionServerAction(ServerAction):
             *args, **kwargs
         )
 
-        # Create threading timer which will trigger creation of report
-        #   at the 00:00:01 of next day
-        # - callback will trigger another timer which will have 1 day offset
-        now = datetime.datetime.now()
-        # Create object of today morning
-        today_morning = datetime.datetime(
-            now.year, now.month, now.day, 0, 0, 1
-        )
-        # Add a day delta (to calculate next day date)
-        next_day_morning = today_morning + self._day_delta
-        # Calculate first delta in seconds for first threading timer
-        first_delta = (next_day_morning - now).total_seconds()
+        seconds_delta, cycle_time = self._calculate_next_cycle_delta()
+
         # Store cycle time which will be used to create next timer
-        self._last_cyle_time = next_day_morning
+        self._last_cyle_time = cycle_time
         # Create timer thread
-        self._cycle_timer = threading.Timer(first_delta, self._timer_callback)
+        self._cycle_timer = threading.Timer(seconds_delta, self._timer_callback)
         self._cycle_timer.start()
 
         self._check_review_session()
@@ -111,13 +133,12 @@ class CreateDailyReviewSessionServerAction(ServerAction):
             self._cycle_timer is not None
             and self._last_cyle_time is not None
         ):
-            now = datetime.datetime.now()
-            while self._last_cyle_time < now:
-                self._last_cyle_time = self._last_cyle_time + self._day_delta
+            seconds_delta, cycle_time = self._calculate_next_cycle_delta()
+            self._last_cyle_time = cycle_time
 
-            delay = (self._last_cyle_time - now).total_seconds()
-
-            self._cycle_timer = threading.Timer(delay, self._timer_callback)
+            self._cycle_timer = threading.Timer(
+                seconds_delta, self._timer_callback
+            )
             self._cycle_timer.start()
         self._check_review_session()
 

From e74f526def58d48fe5d77c44ea5b3615d595da4b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 11:42:48 +0200
Subject: [PATCH 1134/1227] modified labels

---
 .../projects_schema/schema_project_ftrack.json      | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json b/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
index 4119184ca9..e008fd85ee 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_ftrack.json
@@ -410,7 +410,10 @@
                         {
                             "type": "boolean",
                             "key": "cycle_enabled",
-                            "label": "Create daily review session"
+                            "label": "Run automatically every day"
+                        },
+                        {
+                            "type": "separator"
                         },
                         {
                             "type": "list-strict",
@@ -419,17 +422,19 @@
                             "tooltip": "This may take affect on next day",
                             "object_types": [
                                 {
-                                    "label": "HMS",
+                                    "label": "H:",
                                     "type": "number",
                                     "minimum": 0,
                                     "maximum": 23,
                                     "decimal": 0
                                 }, {
+                                    "label": "M:",
                                     "type": "number",
                                     "minimum": 0,
                                     "maximum": 59,
                                     "decimal": 0
                                 }, {
+                                    "label": "S:",
                                     "type": "number",
                                     "minimum": 0,
                                     "maximum": 59,
@@ -437,6 +442,10 @@
                                 }
                             ]
                         },
+                        {
+                            "type": "label",
+                            "label": "This can't be overriden per project and any change will take effect on the next day or on restart of event server."
+                        },
                         {
                             "type": "separator"
                         },

From af06e1a8511979ccc1398f1fda9887c98289f0ee Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 12:02:19 +0200
Subject: [PATCH 1135/1227] fix too long line

---
 .../event_handlers_server/action_create_review_session.py     | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py b/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
index 68d498a83a..21382007a0 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_create_review_session.py
@@ -123,7 +123,9 @@ class CreateDailyReviewSessionServerAction(ServerAction):
         # Store cycle time which will be used to create next timer
         self._last_cyle_time = cycle_time
         # Create timer thread
-        self._cycle_timer = threading.Timer(seconds_delta, self._timer_callback)
+        self._cycle_timer = threading.Timer(
+            seconds_delta, self._timer_callback
+        )
         self._cycle_timer.start()
 
         self._check_review_session()

From 9f2bbbbe386d874cee06fb8b684d377cfb5cd339 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 15 Jul 2022 13:12:09 +0200
Subject: [PATCH 1136/1227] OP-3589 - added thumbnail extract to traypublisher

Added check if thumbnail representation is not present, created by different plugin by any chance.
ExtractThumbnailSP should be removed when SP is removed, no need to copy and have 2 plugins.
---
 openpype/plugins/publish/extract_thumbnail.py | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_thumbnail.py b/openpype/plugins/publish/extract_thumbnail.py
index 7a438ca701..e6df5b3ee0 100644
--- a/openpype/plugins/publish/extract_thumbnail.py
+++ b/openpype/plugins/publish/extract_thumbnail.py
@@ -22,7 +22,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
         "imagesequence", "render", "render2d", "prerender",
         "source", "plate", "take"
     ]
-    hosts = ["shell", "fusion", "resolve"]
+    hosts = ["shell", "fusion", "resolve", "traypublisher"]
     enabled = False
 
     # presetable attribute
@@ -46,6 +46,10 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             self.log.info("Skipping - no review set on instance.")
             return
 
+        if self._has_thumbnail_already(instance):
+            self.log.info("Thumbnail representation already present.")
+            return
+
         filtered_repres = self._get_filtered_repres(instance)
         for repre in filtered_repres:
             repre_files = repre["files"]
@@ -102,6 +106,14 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             # There is no need to create more then one thumbnail
             break
 
+    def _has_thumbnail_already(self, instance):
+        for repre in instance.data.get("representations", []):
+            self.log.info("repre {}".format(repre))
+            if repre["name"] == "thumbnail":
+                return True
+
+        return False
+
     def _get_filtered_repres(self, instance):
         filtered_repres = []
         src_repres = instance.data.get("representations") or []

From a8c219211d5f2dddaf6b4dd31fd59d1137bbd0c1 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 15 Jul 2022 13:25:42 +0200
Subject: [PATCH 1137/1227] OP-3589 - copied ValidateFrameRange from SP

SP will be removed in the future, copied this to TrayPublisher to keep functionality.
---
 .../publish/help/validate_frame_ranges.xml    | 15 ++++
 .../plugins/publish/validate_frame_ranges.py  | 72 +++++++++++++++++++
 2 files changed, 87 insertions(+)
 create mode 100644 openpype/hosts/traypublisher/plugins/publish/help/validate_frame_ranges.xml
 create mode 100644 openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py

diff --git a/openpype/hosts/traypublisher/plugins/publish/help/validate_frame_ranges.xml b/openpype/hosts/traypublisher/plugins/publish/help/validate_frame_ranges.xml
new file mode 100644
index 0000000000..933df1c7c5
--- /dev/null
+++ b/openpype/hosts/traypublisher/plugins/publish/help/validate_frame_ranges.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<root>
+<error id="main">
+<title>Invalid frame range</title>
+<description>
+## Invalid frame range
+
+Expected duration or '{duration}' frames set in database, workfile contains only '{found}' frames.
+
+### How to repair?
+
+Modify configuration in the database or tweak frame range in the workfile.
+</description>
+</error>
+</root>
\ No newline at end of file
diff --git a/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
new file mode 100644
index 0000000000..89289fc6d4
--- /dev/null
+++ b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
@@ -0,0 +1,72 @@
+import re
+
+import pyblish.api
+
+import openpype.api
+from openpype import lib
+from openpype.pipeline import (
+    PublishXmlValidationError,
+    OptionalPyblishPluginMixin
+)
+
+
+class ValidateFrameRange(OptionalPyblishPluginMixin,
+                         pyblish.api.InstancePlugin):
+    """Validating frame range of rendered files against state in DB."""
+
+    label = "Validate Frame Range"
+    hosts = ["traypublisher"]
+    families = ["render"]
+    order = openpype.api.ValidateContentsOrder
+
+    optional = True
+    # published data might be sequence (.mov, .mp4) in that counting files
+    # doesnt make sense
+    check_extensions = ["exr", "dpx", "jpg", "jpeg", "png", "tiff", "tga",
+                        "gif", "svg"]
+    skip_timelines_check = []  # skip for specific task names (regex)
+
+    def process(self, instance):
+        # Skip the instance if is not active by data on the instance
+        if not self.is_active(instance.data):
+            return
+
+        if any(re.search(pattern, instance.data["task"])
+               for pattern in self.skip_timelines_check):
+            self.log.info("Skipping for {} task".format(instance.data["task"]))
+
+        asset_data = lib.get_asset(instance.data["asset"])["data"]
+        frame_start = asset_data["frameStart"]
+        frame_end = asset_data["frameEnd"]
+        handle_start = asset_data["handleStart"]
+        handle_end = asset_data["handleEnd"]
+        duration = (frame_end - frame_start + 1) + handle_start + handle_end
+
+        repre = instance.data.get("representations", [None])
+        if not repre:
+            self.log.info("No representations, skipping.")
+            return
+
+        ext = repre[0]['ext'].replace(".", '')
+
+        if not ext or ext.lower() not in self.check_extensions:
+            self.log.warning("Cannot check for extension {}".format(ext))
+            return
+
+        files = instance.data.get("representations", [None])[0]["files"]
+        if isinstance(files, str):
+            files = [files]
+        frames = len(files)
+
+        msg = "Frame duration from DB:'{}' ". format(int(duration)) +\
+              " doesn't match number of files:'{}'".format(frames) +\
+              " Please change frame range for Asset or limit no. of files"
+
+        formatting_data = {"duration": duration,
+                           "found": frames}
+        if frames != duration:
+            raise PublishXmlValidationError(self, msg,
+                                            formatting_data=formatting_data)
+
+        self.log.debug("Valid ranges expected '{}' - found '{}'".
+                       format(int(duration), frames))

From 870cc2bc0607b36328f03c2b75be4c5b12e39d6e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 13:34:26 +0200
Subject: [PATCH 1138/1227] fix hash of oiio centos file

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 4bdaaab4ed..078503a284 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -135,7 +135,7 @@ hash = "b9950f5d2fa3720b52b8be55bacf5f56d33f9e029d38ee86534995f3d8d253d2"
 
 [openpype.thirdparty.oiio.linux]
 url = "https://distribute.openpype.io/thirdparty/oiio_tools-2.2.20-linux-centos7.tgz"
-hash = "be1abf8a50e9da5913298447421af0a17829d83ed6252ae1d40da7fa36a78787"
+hash = "3894dec7e4e521463891a869586850e8605f5fd604858b674c87323bf33e273d"
 
 [openpype.thirdparty.oiio.darwin]
 url = "https://distribute.openpype.io/thirdparty/oiio-2.2.0-darwin.tgz"

From 0111f4ae0f70b48e1098f8e28ed50ac969f1a8f3 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 14:38:59 +0200
Subject: [PATCH 1139/1227] added option to launch openpype with interactive
 console

---
 openpype/cli.py           | 16 +++++++++++++++-
 openpype/pype_commands.py |  2 +-
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/openpype/cli.py b/openpype/cli.py
index 2aa4a46929..d6970f2509 100644
--- a/openpype/cli.py
+++ b/openpype/cli.py
@@ -2,7 +2,7 @@
 """Package for handling pype command line arguments."""
 import os
 import sys
-
+import code
 import click
 
 # import sys
@@ -424,3 +424,17 @@ def pack_project(project, dirpath):
 def unpack_project(zipfile, root):
     """Create a package of project with all files and database dump."""
     PypeCommands().unpack_project(zipfile, root)
+
+
+@main.command()
+def interactive():
+    """Interative (Python like) console.
+
+    Helpfull command not only for development to directly work with python
+    interpreter.
+
+    Warning:
+        Executable 'openpype_gui' on windows won't work.
+    """
+
+    code.interact()
diff --git a/openpype/pype_commands.py b/openpype/pype_commands.py
index 90c582a319..124eacbe39 100644
--- a/openpype/pype_commands.py
+++ b/openpype/pype_commands.py
@@ -7,7 +7,7 @@ import time
 
 from openpype.lib import PypeLogger
 from openpype.api import get_app_environments_for_context
-from openpype.lib.plugin_tools import parse_json, get_batch_asset_task_info
+from openpype.lib.plugin_tools import get_batch_asset_task_info
 from openpype.lib.remote_publish import (
     get_webpublish_conn,
     start_webpublish_log,

From b60acdd6d77d488464ffdfad871b076926d94896 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 14:45:32 +0200
Subject: [PATCH 1140/1227] added banner to interpreter

---
 openpype/cli.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/openpype/cli.py b/openpype/cli.py
index d6970f2509..9a2dfaa141 100644
--- a/openpype/cli.py
+++ b/openpype/cli.py
@@ -437,4 +437,9 @@ def interactive():
         Executable 'openpype_gui' on windows won't work.
     """
 
-    code.interact()
+    from openpype.version import __version__
+
+    banner = "OpenPype {}\nPython {} on {}".format(
+        __version__, sys.version, sys.platform
+    )
+    code.interact(banner)

From a395a85b67065e34c445e2b522afedb8d0f6cf42 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 15 Jul 2022 15:07:11 +0200
Subject: [PATCH 1141/1227] OP-3446 - explicitly adding review

Creator now should handle adding review on instance and on applicable representation tags.
---
 .../plugins/create/create_mov_batch.py          | 15 +++++++++++++--
 .../plugins/publish/collect_mov_batch.py        | 17 +++++++++++++++--
 2 files changed, 28 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
index 20d3ecbd7c..67f8848e05 100644
--- a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
@@ -4,7 +4,7 @@ import re
 
 from openpype.client import get_assets, get_asset_by_name
 from openpype.hosts.traypublisher.api import pipeline
-from openpype.lib import FileDef, get_subset_name_with_asset_doc
+from openpype.lib import FileDef, BoolDef, get_subset_name_with_asset_doc
 from openpype.pipeline import (
     CreatedInstance,
     CreatorError
@@ -151,7 +151,13 @@ class BatchMovCreator(TrayPublishCreator):
         return task_name
 
     def get_instance_attr_defs(self):
-        return []
+        return [
+            BoolDef(
+                "add_review_family",
+                default=True,
+                label="Review"
+            )
+        ]
 
     def get_pre_create_attr_defs(self):
         # Use same attributes as for instance attributes
@@ -162,6 +168,11 @@ class BatchMovCreator(TrayPublishCreator):
                 single_item=False,
                 extensions=self.extensions,
                 label="Filepath"
+            ),
+            BoolDef(
+                "add_review_family",
+                default=True,
+                label="Review"
             )
         ]
 
diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
index c81d1f77a5..e4011d0003 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
@@ -2,12 +2,17 @@ import os
 
 import pyblish.api
 from openpype.pipeline import OpenPypePyblishPluginMixin
+from openpype.lib import BoolDef
 
 
 class CollectMovBatch(
     pyblish.api.InstancePlugin, OpenPypePyblishPluginMixin
 ):
-    """Collect file url for batch mov and create representation."""
+    """Collect file url for batch mov and create representation.
+
+    Adds review on instance and to repre.tags based on value of toggle button
+    on creator.
+    """
 
     label = "Collect Mov Batch Files"
     order = pyblish.api.CollectorOrder
@@ -18,7 +23,9 @@ class CollectMovBatch(
         if not instance.data.get("creator_identifier") == "render_mov_batch":
             return
 
-        file_url = instance.data["creator_attributes"]["filepath"]
+        creator_attributes = instance.data["creator_attributes"]
+
+        file_url = creator_attributes["filepath"]
         file_name = os.path.basename(file_url)
         _, ext = os.path.splitext(file_name)
 
@@ -29,6 +36,12 @@ class CollectMovBatch(
             "stagingDir": os.path.dirname(file_url)
         }
 
+        if creator_attributes["add_review_family"]:
+            if not repre.get("tags"):
+                repre["tags"] = []
+            repre["tags"].append("review")
+            instance.data["families"].append("review")
+
         instance.data["representations"].append(repre)
 
         instance.data["source"] = file_url

From a1b93b1d4812cd44dc20f8f69e5f6953d91e7d52 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 15 Jul 2022 15:08:16 +0200
Subject: [PATCH 1142/1227] OP-3446 - Hound

---
 .../hosts/traypublisher/plugins/publish/collect_mov_batch.py     | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
index e4011d0003..99065d2408 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
@@ -2,7 +2,6 @@ import os
 
 import pyblish.api
 from openpype.pipeline import OpenPypePyblishPluginMixin
-from openpype.lib import BoolDef
 
 
 class CollectMovBatch(

From b9be23496924fe4ac99e764b11a82db348ef0b3e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 15:19:07 +0200
Subject: [PATCH 1143/1227] removed default host used on deregister of host

---
 openpype/pipeline/context_tools.py | 24 +-----------------------
 1 file changed, 1 insertion(+), 23 deletions(-)

diff --git a/openpype/pipeline/context_tools.py b/openpype/pipeline/context_tools.py
index e719e46514..fd4dc6e3fd 100644
--- a/openpype/pipeline/context_tools.py
+++ b/openpype/pipeline/context_tools.py
@@ -240,29 +240,7 @@ def registered_host():
 
 
 def deregister_host():
-    _registered_host["_"] = default_host()
-
-
-def default_host():
-    """A default host, in place of anything better
-
-    This may be considered as reference for the
-    interface a host must implement. It also ensures
-    that the system runs, even when nothing is there
-    to support it.
-
-    """
-
-    host = types.ModuleType("defaultHost")
-
-    def ls():
-        return list()
-
-    host.__dict__.update({
-        "ls": ls
-    })
-
-    return host
+    _registered_host["_"] = None
 
 
 def debug_host():

From 636e46cfd673f13bba211024bf1b56180f17abad Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 15:29:18 +0200
Subject: [PATCH 1144/1227] implemented functions to query project and asset
 documents based on current context

---
 openpype/pipeline/context_tools.py | 52 ++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/openpype/pipeline/context_tools.py b/openpype/pipeline/context_tools.py
index fd4dc6e3fd..80ad939ccd 100644
--- a/openpype/pipeline/context_tools.py
+++ b/openpype/pipeline/context_tools.py
@@ -10,6 +10,11 @@ import pyblish.api
 from pyblish.lib import MessageHandler
 
 import openpype
+from openpype.client import (
+    get_project,
+    get_asset_by_id,
+    get_asset_by_name,
+)
 from openpype.modules import load_modules, ModulesManager
 from openpype.settings import get_project_settings
 from openpype.lib import filter_pyblish_plugins
@@ -282,3 +287,50 @@ def debug_host():
     })
 
     return host
+
+
+def get_current_project(fields=None):
+    """Helper function to get project document based on global Session.
+
+    This function should be called only in process where host is installed.
+
+    Returns:
+        dict: Project document.
+        None: Project is not set.
+    """
+
+    project_name = legacy_io.active_project()
+    return get_project(project_name, fields=fields)
+
+
+def get_current_project_asset(asset_name=None, asset_id=None, fields=None):
+    """Helper function to get asset document based on global Session.
+
+    This function should be called only in process where host is installed.
+
+    Asset is found out based on passed asset name or id (not both). Asset name
+    is not used for filtering if asset id is passed. When both asset name and
+    id are missing then asset name from current process is used.
+
+    Args:
+        asset_name (str): Name of asset used for filter.
+        asset_id (Union[str, ObjectId]): Asset document id. If entered then
+            is used as only filter.
+        fields (Union[List[str], None]): Limit returned data of asset documents
+            to specific keys.
+
+    Returns:
+        dict: Asset document.
+        None: Asset is not set or not exist.
+    """
+
+    project_name = legacy_io.active_project()
+    if asset_id:
+        return get_asset_by_id(project_name, asset_id, fields=fields)
+
+    if not asset_name:
+        asset_name = legacy_io.Session.get("AVALON_ASSET")
+        # Skip if is not set even on context
+        if not asset_name:
+            return None
+    return get_asset_by_name(project_name, asset_name, fields=fields)

From 35bd841939a78a5d963bb2972c4b14b0bace13b4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 15:31:51 +0200
Subject: [PATCH 1145/1227] marked 'get_asset' as deprecated

---
 openpype/lib/avalon_context.py | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 76ed6cbbd3..7ed22d6de6 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -236,7 +236,7 @@ def any_outdated():
     return False
 
 
-@with_pipeline_io
+@deprecated("openpype.pipeline.context_tools.get_current_project_asset")
 def get_asset(asset_name=None):
     """ Returning asset document from database by its name.
 
@@ -249,15 +249,9 @@ def get_asset(asset_name=None):
         (MongoDB document)
     """
 
-    project_name = legacy_io.active_project()
-    if not asset_name:
-        asset_name = legacy_io.Session["AVALON_ASSET"]
+    from openpype.pipeline.context_tools import get_current_project_asset
 
-    asset_document = get_asset_by_name(project_name, asset_name)
-    if not asset_document:
-        raise TypeError("Entity \"{}\" was not found in DB".format(asset_name))
-
-    return asset_document
+    return get_current_project_asset(asset_name=asset_name)
 
 
 def get_system_general_anatomy_data(system_settings=None):

From de0c0effe60e38f07bc47f577f8e5fb67f61814c Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Fri, 15 Jul 2022 15:39:54 +0200
Subject: [PATCH 1146/1227] reencode with concat, fix audio

---
 .../plugins/publish/extract_review_slate.py   | 51 ++++++++++---------
 1 file changed, 27 insertions(+), 24 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 28685c2e90..737b7db295 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -285,36 +285,32 @@ class ExtractReviewSlate(openpype.api.Extractor):
                     audio_channels,
                     audio_sample_rate,
                     audio_channel_layout,
+                    input_frame_rate
                 )
 
                 # replace slate with silent slate for concat
                 slate_v_path = slate_silent_path
 
-            # create ffmpeg concat text file path
-            conc_text_file = input_file.replace(ext, "") + "_concat" + ".txt"
-            conc_text_path = os.path.join(
-                os.path.normpath(stagingdir), conc_text_file)
-            _remove_at_end.append(conc_text_path)
-            self.log.debug("__ conc_text_path: {}".format(conc_text_path))
-
-            new_line = "\n"
-            with open(conc_text_path, "w") as conc_text_f:
-                conc_text_f.writelines([
-                    "file {}".format(
-                        slate_v_path.replace("\\", "/")),
-                    new_line,
-                    "file {}".format(input_path.replace("\\", "/"))
-                ])
-
-            # concat slate and videos together
+            # concat slate and videos together with concat filter
+            # this will reencode the output
+            if input_audio:
+                fmap = [
+                    "[0:v] [0:a] [1:v] [1:a] concat=n=2:v=1:a=1 [v] [a]",
+                    "-map", '[v]',
+                    "-map", '[a]'
+                ]
+            else:
+                fmap = [
+                    "[0:v] [1:v] concat=n=2:v=1:a=0 [v]",
+                    "-map", '[v]'
+                ]
             concat_args = [
                 ffmpeg_path,
-                "-y",
-                "-f", "concat",
-                "-safe", "0",
-                "-i", conc_text_path,
-                "-c", "copy",
+                "-i", slate_v_path,
+                "-i", input_path,
+                "-filter_complex",
             ]
+            concat_args.extend(fmap)
             if offset_timecode:
                 concat_args.extend(["-timecode", offset_timecode])
             # NOTE: Added because of OP Atom demuxers
@@ -328,6 +324,10 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 copy_args = (
                     "-metadata",
                     "-metadata:s:v:0",
+                    "-codec:v",
+                    "-pixfmt",
+                    "-b:v",
+                    "-b:a",
                 )
                 args = source_ffmpeg_cmd.split(" ")
                 for indx, arg in enumerate(args):
@@ -335,12 +335,14 @@ class ExtractReviewSlate(openpype.api.Extractor):
                         concat_args.append(arg)
                         # assumes arg has one parameter
                         concat_args.append(args[indx + 1])
+            concat_args.append("-y")
             # add final output path
             concat_args.append(output_path)
 
             # ffmpeg concat subprocess
             self.log.debug(
-                "Executing concat: {}".format(" ".join(concat_args))
+                "Executing concat filter: {}".format
+                (" ".join(concat_args))
             )
             openpype.api.run_subprocess(
                 concat_args, logger=self.log
@@ -488,9 +490,10 @@ class ExtractReviewSlate(openpype.api.Extractor):
         audio_channels,
         audio_sample_rate,
         audio_channel_layout,
+        input_frame_rate
     ):
         # Get duration of one frame in micro seconds
-        items = audio_sample_rate.split("/")
+        items = input_frame_rate.split("/")
         if len(items) == 1:
             one_frame_duration = 1.0 / float(items[0])
         elif len(items) == 2:

From ad8a7c86e4b655014e6dc776c813e9966cb9e1f3 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 15:57:01 +0200
Subject: [PATCH 1147/1227] use 'get_current_project_asset' in hosts

---
 openpype/hosts/harmony/api/pipeline.py             |  5 ++++-
 openpype/hosts/hiero/api/plugin.py                 |  3 ++-
 openpype/hosts/houdini/api/lib.py                  |  4 ++--
 openpype/hosts/maya/api/lib.py                     | 14 ++++++++------
 .../hosts/maya/plugins/create/create_render.py     |  6 +++---
 .../maya/plugins/publish/validate_maya_units.py    | 10 +++++++---
 openpype/hosts/nuke/api/lib.py                     |  4 ++--
 .../hosts/nuke/plugins/publish/validate_script.py  | 10 +++++-----
 openpype/hosts/resolve/api/plugin.py               |  4 ++--
 .../plugins/publish/collect_editorial.py           |  3 ++-
 .../plugins/publish/collect_editorial_instances.py |  8 ++++++--
 .../plugins/publish/validate_frame_ranges.py       |  5 +++--
 .../hosts/unreal/plugins/load/load_animation.py    |  9 ++++++---
 openpype/hosts/unreal/plugins/load/load_layout.py  |  5 +++--
 14 files changed, 55 insertions(+), 35 deletions(-)

diff --git a/openpype/hosts/harmony/api/pipeline.py b/openpype/hosts/harmony/api/pipeline.py
index 86b5753f7e..94ca134205 100644
--- a/openpype/hosts/harmony/api/pipeline.py
+++ b/openpype/hosts/harmony/api/pipeline.py
@@ -15,6 +15,7 @@ from openpype.pipeline import (
     deregister_creator_plugin_path,
     AVALON_CONTAINER_ID,
 )
+from openpype.pipeline.context_tools import get_current_project_asset
 import openpype.hosts.harmony
 import openpype.hosts.harmony.api as harmony
 
@@ -50,7 +51,9 @@ def get_asset_settings():
         dict: Scene data.
 
     """
-    asset_data = lib.get_asset()["data"]
+
+    asset_doc = get_current_project_asset()
+    asset_data = asset_doc["data"]
     fps = asset_data.get("fps")
     frame_start = asset_data.get("frameStart")
     frame_end = asset_data.get("frameEnd")
diff --git a/openpype/hosts/hiero/api/plugin.py b/openpype/hosts/hiero/api/plugin.py
index add416d04e..28a9dfb492 100644
--- a/openpype/hosts/hiero/api/plugin.py
+++ b/openpype/hosts/hiero/api/plugin.py
@@ -10,6 +10,7 @@ import qargparse
 
 import openpype.api as openpype
 from openpype.pipeline import LoaderPlugin, LegacyCreator
+from openpype.pipeline.context_tools import get_current_project_asset
 from . import lib
 
 log = openpype.Logger().get_logger(__name__)
@@ -484,7 +485,7 @@ class ClipLoader:
 
         """
         asset_name = self.context["representation"]["context"]["asset"]
-        asset_doc = openpype.get_asset(asset_name)
+        asset_doc = get_current_project_asset(asset_name)
         log.debug("__ asset_doc: {}".format(pformat(asset_doc)))
         self.data["assetData"] = asset_doc["data"]
 
diff --git a/openpype/hosts/houdini/api/lib.py b/openpype/hosts/houdini/api/lib.py
index dd8a5ba473..c8a7f92bb9 100644
--- a/openpype/hosts/houdini/api/lib.py
+++ b/openpype/hosts/houdini/api/lib.py
@@ -5,8 +5,8 @@ from contextlib import contextmanager
 import six
 
 from openpype.client import get_asset_by_name
-from openpype.api import get_asset
 from openpype.pipeline import legacy_io
+from openpype.pipeline.context_tools import get_current_project_asset
 
 
 import hou
@@ -16,7 +16,7 @@ log = logging.getLogger(__name__)
 
 def get_asset_fps():
     """Return current asset fps."""
-    return get_asset()["data"].get("fps")
+    return get_current_project_asset()["data"].get("fps")
 
 
 def set_id(node, unique_id, overwrite=False):
diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index e4221978c0..58e160cb2f 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -23,7 +23,6 @@ from openpype.client import (
     get_last_versions,
     get_representation_by_name
 )
-from openpype import lib
 from openpype.api import get_anatomy_settings
 from openpype.pipeline import (
     legacy_io,
@@ -33,6 +32,7 @@ from openpype.pipeline import (
     load_container,
     registered_host,
 )
+from openpype.pipeline.context_tools import get_current_project_asset
 from .commands import reset_frame_range
 
 
@@ -2174,7 +2174,7 @@ def reset_scene_resolution():
     project_name = legacy_io.active_project()
     project_doc = get_project(project_name)
     project_data = project_doc["data"]
-    asset_data = lib.get_asset()["data"]
+    asset_data = get_current_project_asset()["data"]
 
     # Set project resolution
     width_key = "resolutionWidth"
@@ -2208,7 +2208,8 @@ def set_context_settings():
     project_name = legacy_io.active_project()
     project_doc = get_project(project_name)
     project_data = project_doc["data"]
-    asset_data = lib.get_asset()["data"]
+    asset_doc = get_current_project_asset(fields=["data.fps"])
+    asset_data = asset_doc.get("data", {})
 
     # Set project fps
     fps = asset_data.get("fps", project_data.get("fps", 25))
@@ -2233,7 +2234,7 @@ def validate_fps():
 
     """
 
-    fps = lib.get_asset()["data"]["fps"]
+    fps = get_current_project_asset(fields=["data.fps"])["data"]["fps"]
     # TODO(antirotor): This is hack as for framerates having multiple
     # decimal places. FTrack is ceiling decimal values on
     # fps to two decimal places but Maya 2019+ is reporting those fps
@@ -3051,8 +3052,9 @@ def update_content_on_context_change():
     This will update scene content to match new asset on context change
     """
     scene_sets = cmds.listSets(allSets=True)
-    new_asset = legacy_io.Session["AVALON_ASSET"]
-    new_data = lib.get_asset()["data"]
+    asset_doc = get_current_project_asset()
+    new_asset = asset_doc["name"]
+    new_data = asset_doc["data"]
     for s in scene_sets:
         try:
             if cmds.getAttr("{}.id".format(s)) == "pyblish.avalon.instance":
diff --git a/openpype/hosts/maya/plugins/create/create_render.py b/openpype/hosts/maya/plugins/create/create_render.py
index 93ee6679e5..de07a0b23d 100644
--- a/openpype/hosts/maya/plugins/create/create_render.py
+++ b/openpype/hosts/maya/plugins/create/create_render.py
@@ -15,13 +15,13 @@ from openpype.hosts.maya.api import (
 from openpype.lib import requests_get
 from openpype.api import (
     get_system_settings,
-    get_project_settings,
-    get_asset)
+    get_project_settings)
 from openpype.modules import ModulesManager
 from openpype.pipeline import (
     CreatorError,
     legacy_io,
 )
+from openpype.pipeline.context_tools import get_current_project_asset
 
 
 class CreateRender(plugin.Creator):
@@ -413,7 +413,7 @@ class CreateRender(plugin.Creator):
                      prefix,
                      type="string")
 
-        asset = get_asset()
+        asset = get_current_project_asset()
 
         if renderer == "arnold":
             # set format to exr
diff --git a/openpype/hosts/maya/plugins/publish/validate_maya_units.py b/openpype/hosts/maya/plugins/publish/validate_maya_units.py
index d5a8c350d5..5f67adec76 100644
--- a/openpype/hosts/maya/plugins/publish/validate_maya_units.py
+++ b/openpype/hosts/maya/plugins/publish/validate_maya_units.py
@@ -2,8 +2,8 @@ import maya.cmds as cmds
 
 import pyblish.api
 import openpype.api
-from openpype import lib
 import openpype.hosts.maya.api.lib as mayalib
+from openpype.pipeline.context_tools import get_current_project_asset
 from math import ceil
 
 
@@ -41,7 +41,9 @@ class ValidateMayaUnits(pyblish.api.ContextPlugin):
         # now flooring the value?
         fps = float_round(context.data.get('fps'), 2, ceil)
 
-        asset_fps = lib.get_asset()["data"]["fps"]
+        # TODO repace query with using 'context.data["assetEntity"]'
+        asset_doc = get_current_project_asset()
+        asset_fps = asset_doc["data"]["fps"]
 
         self.log.info('Units (linear): {0}'.format(linearunits))
         self.log.info('Units (angular): {0}'.format(angularunits))
@@ -91,5 +93,7 @@ class ValidateMayaUnits(pyblish.api.ContextPlugin):
         cls.log.debug(current_linear)
 
         cls.log.info("Setting time unit to match project")
-        asset_fps = lib.get_asset()["data"]["fps"]
+        # TODO repace query with using 'context.data["assetEntity"]'
+        asset_doc = get_current_project_asset()
+        asset_fps = asset_doc["data"]["fps"]
         mayalib.set_scene_fps(asset_fps)
diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 0929415c00..7be7c1169c 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -24,7 +24,6 @@ from openpype.api import (
     BuildWorkfile,
     get_version_from_path,
     get_workdir_data,
-    get_asset,
     get_current_project_settings,
 )
 from openpype.tools.utils import host_tools
@@ -40,6 +39,7 @@ from openpype.pipeline import (
     legacy_io,
     Anatomy,
 )
+from openpype.pipeline.context_tools import get_current_project_asset
 
 from . import gizmo_menu
 
@@ -1766,7 +1766,7 @@ class WorkfileSettings(object):
             kwargs.get("asset_name")
             or legacy_io.Session["AVALON_ASSET"]
         )
-        self._asset_entity = get_asset(self._asset)
+        self._asset_entity = get_current_project_asset(self._asset)
         self._root_node = root_node or nuke.root()
         self._nodes = self.get_nodes(nodes=nodes)
 
diff --git a/openpype/hosts/nuke/plugins/publish/validate_script.py b/openpype/hosts/nuke/plugins/publish/validate_script.py
index 9bda0da85e..b8d7494b9d 100644
--- a/openpype/hosts/nuke/plugins/publish/validate_script.py
+++ b/openpype/hosts/nuke/plugins/publish/validate_script.py
@@ -1,7 +1,6 @@
 import pyblish.api
 
-from openpype.client import get_project, get_asset_by_id
-from openpype import lib
+from openpype.client import get_project, get_asset_by_id, get_asset_by_name
 from openpype.pipeline import legacy_io
 
 
@@ -17,10 +16,11 @@ class ValidateScript(pyblish.api.InstancePlugin):
 
     def process(self, instance):
         ctx_data = instance.context.data
-        asset_name = ctx_data["asset"]
-        asset = lib.get_asset(asset_name)
-        asset_data = asset["data"]
         project_name = legacy_io.active_project()
+        asset_name = ctx_data["asset"]
+        # TODO repace query with using 'instance.data["assetEntity"]'
+        asset = get_asset_by_name(project_name, asset_name)
+        asset_data = asset["data"]
 
         # These attributes will be checked
         attributes = [
diff --git a/openpype/hosts/resolve/api/plugin.py b/openpype/hosts/resolve/api/plugin.py
index 49b478fb3b..b03125d502 100644
--- a/openpype/hosts/resolve/api/plugin.py
+++ b/openpype/hosts/resolve/api/plugin.py
@@ -4,11 +4,11 @@ import uuid
 import qargparse
 from Qt import QtWidgets, QtCore
 
-import openpype.api as pype
 from openpype.pipeline import (
     LegacyCreator,
     LoaderPlugin,
 )
+from openpype.pipeline.context_tools import get_current_project_asset
 from openpype.hosts import resolve
 from . import lib
 
@@ -375,7 +375,7 @@ class ClipLoader:
 
         """
         asset_name = self.context["representation"]["context"]["asset"]
-        self.data["assetData"] = pype.get_asset(asset_name)["data"]
+        self.data["assetData"] = get_current_project_asset(asset_name)["data"]
 
     def load(self):
         # create project bin for the media to be imported into
diff --git a/openpype/hosts/standalonepublisher/plugins/publish/collect_editorial.py b/openpype/hosts/standalonepublisher/plugins/publish/collect_editorial.py
index 0a1d29ccdc..8633d4bf9d 100644
--- a/openpype/hosts/standalonepublisher/plugins/publish/collect_editorial.py
+++ b/openpype/hosts/standalonepublisher/plugins/publish/collect_editorial.py
@@ -19,6 +19,7 @@ import os
 import opentimelineio as otio
 import pyblish.api
 from openpype import lib as plib
+from openpype.pipeline.context_tools import get_current_project_asset
 
 
 class OTIO_View(pyblish.api.Action):
@@ -116,7 +117,7 @@ class CollectEditorial(pyblish.api.InstancePlugin):
             if extension == ".edl":
                 # EDL has no frame rate embedded so needs explicit
                 # frame rate else 24 is asssumed.
-                kwargs["rate"] = plib.get_asset()["data"]["fps"]
+                kwargs["rate"] = get_current_project_asset()["data"]["fps"]
 
             instance.data["otio_timeline"] = otio.adapters.read_from_file(
                 file_path, **kwargs)
diff --git a/openpype/hosts/standalonepublisher/plugins/publish/collect_editorial_instances.py b/openpype/hosts/standalonepublisher/plugins/publish/collect_editorial_instances.py
index d0d36bb717..3237fbbe12 100644
--- a/openpype/hosts/standalonepublisher/plugins/publish/collect_editorial_instances.py
+++ b/openpype/hosts/standalonepublisher/plugins/publish/collect_editorial_instances.py
@@ -1,8 +1,12 @@
 import os
+from copy import deepcopy
+
 import opentimelineio as otio
 import pyblish.api
+
 from openpype import lib as plib
-from copy import deepcopy
+from openpype.pipeline.context_tools import get_current_project_asset
+
 
 class CollectInstances(pyblish.api.InstancePlugin):
     """Collect instances from editorial's OTIO sequence"""
@@ -48,7 +52,7 @@ class CollectInstances(pyblish.api.InstancePlugin):
 
         # get timeline otio data
         timeline = instance.data["otio_timeline"]
-        fps = plib.get_asset()["data"]["fps"]
+        fps = get_current_project_asset()["data"]["fps"]
 
         tracks = timeline.each_child(
             descended_from_type=otio.schema.Track
diff --git a/openpype/hosts/standalonepublisher/plugins/publish/validate_frame_ranges.py b/openpype/hosts/standalonepublisher/plugins/publish/validate_frame_ranges.py
index 005157af62..ff7f60354e 100644
--- a/openpype/hosts/standalonepublisher/plugins/publish/validate_frame_ranges.py
+++ b/openpype/hosts/standalonepublisher/plugins/publish/validate_frame_ranges.py
@@ -3,8 +3,8 @@ import re
 import pyblish.api
 
 import openpype.api
-from openpype import lib
 from openpype.pipeline import PublishXmlValidationError
+from openpype.pipeline.context_tools import get_current_project_asset
 
 
 class ValidateFrameRange(pyblish.api.InstancePlugin):
@@ -27,7 +27,8 @@ class ValidateFrameRange(pyblish.api.InstancePlugin):
                for pattern in self.skip_timelines_check):
             self.log.info("Skipping for {} task".format(instance.data["task"]))
 
-        asset_data = lib.get_asset(instance.data["asset"])["data"]
+        # TODO repace query with using 'instance.data["assetEntity"]'
+        asset_data = get_current_project_asset(instance.data["asset"])["data"]
         frame_start = asset_data["frameStart"]
         frame_end = asset_data["frameEnd"]
         handle_start = asset_data["handleStart"]
diff --git a/openpype/hosts/unreal/plugins/load/load_animation.py b/openpype/hosts/unreal/plugins/load/load_animation.py
index da2830bc52..1fe0bef462 100644
--- a/openpype/hosts/unreal/plugins/load/load_animation.py
+++ b/openpype/hosts/unreal/plugins/load/load_animation.py
@@ -8,13 +8,13 @@ from unreal import EditorAssetLibrary
 from unreal import MovieSceneSkeletalAnimationTrack
 from unreal import MovieSceneSkeletalAnimationSection
 
+from openpype.pipeline.context_tools import get_current_project_asset
 from openpype.pipeline import (
     get_representation_path,
     AVALON_CONTAINER_ID
 )
 from openpype.hosts.unreal.api import plugin
 from openpype.hosts.unreal.api import pipeline as unreal_pipeline
-from openpype.api import get_asset
 
 
 class AnimationFBXLoader(plugin.Loader):
@@ -53,6 +53,8 @@ class AnimationFBXLoader(plugin.Loader):
         if not actor:
             return None
 
+        asset_doc = get_current_project_asset(fields=["data.fps"])
+
         task.set_editor_property('filename', self.fname)
         task.set_editor_property('destination_path', asset_dir)
         task.set_editor_property('destination_name', asset_name)
@@ -80,7 +82,7 @@ class AnimationFBXLoader(plugin.Loader):
         task.options.anim_sequence_import_data.set_editor_property(
             'use_default_sample_rate', False)
         task.options.anim_sequence_import_data.set_editor_property(
-            'custom_sample_rate', get_asset()["data"].get("fps"))
+            'custom_sample_rate', asset_doc.get("data", {}).get("fps"))
         task.options.anim_sequence_import_data.set_editor_property(
             'import_custom_attribute', True)
         task.options.anim_sequence_import_data.set_editor_property(
@@ -246,6 +248,7 @@ class AnimationFBXLoader(plugin.Loader):
     def update(self, container, representation):
         name = container["asset_name"]
         source_path = get_representation_path(representation)
+        asset_doc = get_current_project_asset(fields=["data.fps"])
         destination_path = container["namespace"]
 
         task = unreal.AssetImportTask()
@@ -279,7 +282,7 @@ class AnimationFBXLoader(plugin.Loader):
         task.options.anim_sequence_import_data.set_editor_property(
             'use_default_sample_rate', False)
         task.options.anim_sequence_import_data.set_editor_property(
-            'custom_sample_rate', get_asset()["data"].get("fps"))
+            'custom_sample_rate', asset_doc.get("data", {}).get("fps"))
         task.options.anim_sequence_import_data.set_editor_property(
             'import_custom_attribute', True)
         task.options.anim_sequence_import_data.set_editor_property(
diff --git a/openpype/hosts/unreal/plugins/load/load_layout.py b/openpype/hosts/unreal/plugins/load/load_layout.py
index 3f16a68ead..01d589c69b 100644
--- a/openpype/hosts/unreal/plugins/load/load_layout.py
+++ b/openpype/hosts/unreal/plugins/load/load_layout.py
@@ -20,7 +20,7 @@ from openpype.pipeline import (
     AVALON_CONTAINER_ID,
     legacy_io,
 )
-from openpype.api import get_asset
+from openpype.pipeline.context_tools import get_current_project_asset
 from openpype.hosts.unreal.api import plugin
 from openpype.hosts.unreal.api import pipeline as unreal_pipeline
 
@@ -225,6 +225,7 @@ class LayoutLoader(plugin.Loader):
 
         anim_path = f"{asset_dir}/animations/{anim_file_name}"
 
+        asset_doc = get_current_project_asset()
         # Import animation
         task = unreal.AssetImportTask()
         task.options = unreal.FbxImportUI()
@@ -259,7 +260,7 @@ class LayoutLoader(plugin.Loader):
         task.options.anim_sequence_import_data.set_editor_property(
             'use_default_sample_rate', False)
         task.options.anim_sequence_import_data.set_editor_property(
-            'custom_sample_rate', get_asset()["data"].get("fps"))
+            'custom_sample_rate', asset_doc.get("data", {}).get("fps"))
         task.options.anim_sequence_import_data.set_editor_property(
             'import_custom_attribute', True)
         task.options.anim_sequence_import_data.set_editor_property(

From b5d7ae0d2a38d93ba5014c9a1aec455b9ca982ce Mon Sep 17 00:00:00 2001
From: jrsndlr <jrsndlr@gmail.com>
Date: Fri, 15 Jul 2022 16:29:05 +0200
Subject: [PATCH 1148/1227] no need to copy codec and pixel format

---
 openpype/plugins/publish/extract_review_slate.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 737b7db295..2edaf10e6b 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -324,8 +324,6 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 copy_args = (
                     "-metadata",
                     "-metadata:s:v:0",
-                    "-codec:v",
-                    "-pixfmt",
                     "-b:v",
                     "-b:a",
                 )

From e8b4a3389e9ac0095bdafcdd008398dc69aac38c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 16:33:47 +0200
Subject: [PATCH 1149/1227] added comment do harmony plugin

---
 .../hosts/harmony/plugins/publish/validate_scene_settings.py  | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/hosts/harmony/plugins/publish/validate_scene_settings.py b/openpype/hosts/harmony/plugins/publish/validate_scene_settings.py
index 4c3a6c4465..936533abd6 100644
--- a/openpype/hosts/harmony/plugins/publish/validate_scene_settings.py
+++ b/openpype/hosts/harmony/plugins/publish/validate_scene_settings.py
@@ -55,6 +55,10 @@ class ValidateSceneSettings(pyblish.api.InstancePlugin):
 
     def process(self, instance):
         """Plugin entry point."""
+
+        # TODO 'get_asset_settings' could expect asset document as argument
+        #   which is available on 'context.data["assetEntity"]'
+        #   - the same approach can be used in 'ValidateSceneSettingsRepair'
         expected_settings = harmony.get_asset_settings()
         self.log.info("scene settings from DB:".format(expected_settings))
 

From a081a0f3e1e21f6ced4ff4ee3b74d40cd97e788e Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 15 Jul 2022 17:43:05 +0200
Subject: [PATCH 1150/1227] Added wrapper around cmds.setAttr

Logs and captures exception when attribute is not possible to set (when locked)
---
 openpype/vendor/python/common/capture.py | 32 ++++++++++++++++--------
 1 file changed, 22 insertions(+), 10 deletions(-)

diff --git a/openpype/vendor/python/common/capture.py b/openpype/vendor/python/common/capture.py
index 4d9e1da3e4..71b86a5f1a 100644
--- a/openpype/vendor/python/common/capture.py
+++ b/openpype/vendor/python/common/capture.py
@@ -403,7 +403,7 @@ def apply_view(panel, **options):
     camera_options = options.get("camera_options", {})
     _iteritems = getattr(camera_options, "iteritems", camera_options.items)
     for key, value in _iteritems:
-        cmds.setAttr("{0}.{1}".format(camera, key), value)
+        _safe_setAttr("{0}.{1}".format(camera, key), value)
 
     # Viewport options
     viewport_options = options.get("viewport_options", {})
@@ -417,7 +417,7 @@ def apply_view(panel, **options):
     )
     for key, value in _iteritems():
         attr = "hardwareRenderingGlobals.{0}".format(key)
-        cmds.setAttr(attr, value)
+        _safe_setAttr(attr, value)
 
 
 def parse_active_panel():
@@ -551,10 +551,10 @@ def apply_scene(**options):
         cmds.playbackOptions(maxTime=options["end_frame"])
 
     if "width" in options:
-        cmds.setAttr("defaultResolution.width", options["width"])
+        _safe_setAttr("defaultResolution.width", options["width"])
 
     if "height" in options:
-        cmds.setAttr("defaultResolution.height", options["height"])
+        _safe_setAttr("defaultResolution.height", options["height"])
 
     if "compression" in options:
         cmds.optionVar(
@@ -665,7 +665,7 @@ def _applied_camera_options(options, panel):
 
     _iteritems = getattr(options, "iteritems", options.items)
     for opt, value in _iteritems():
-        cmds.setAttr(camera + "." + opt, value)
+        _safe_setAttr(camera + "." + opt, value)
 
     try:
         yield
@@ -673,7 +673,7 @@ def _applied_camera_options(options, panel):
         if old_options:
             _iteritems = getattr(old_options, "iteritems", old_options.items)
             for opt, value in _iteritems():
-                cmds.setAttr(camera + "." + opt, value)
+                _safe_setAttr(camera + "." + opt, value)
 
 
 @contextlib.contextmanager
@@ -760,7 +760,7 @@ def _applied_viewport2_options(options):
     # Apply settings
     _iteritems = getattr(options, "iteritems", options.items)
     for opt, value in _iteritems():
-        cmds.setAttr("hardwareRenderingGlobals." + opt, value)
+        _safe_setAttr("hardwareRenderingGlobals." + opt, value)
 
     try:
         yield
@@ -768,7 +768,7 @@ def _applied_viewport2_options(options):
         # Restore previous settings
         _iteritems = getattr(original, "iteritems", original.items)
         for opt, value in _iteritems():
-            cmds.setAttr("hardwareRenderingGlobals." + opt, value)
+            _safe_setAttr("hardwareRenderingGlobals." + opt, value)
 
 
 @contextlib.contextmanager
@@ -802,14 +802,14 @@ def _maintain_camera(panel, camera):
     else:
         state = dict((camera, cmds.getAttr(camera + ".rnd"))
                      for camera in cmds.ls(type="camera"))
-        cmds.setAttr(camera + ".rnd", True)
+        _safe_setAttr(camera + ".rnd", True)
 
     try:
         yield
     finally:
         _iteritems = getattr(state, "iteritems", state.items)
         for camera, renderable in _iteritems():
-            cmds.setAttr(camera + ".rnd", renderable)
+            _safe_setAttr(camera + ".rnd", renderable)
 
 
 @contextlib.contextmanager
@@ -846,6 +846,18 @@ def _in_standalone():
     return not hasattr(cmds, "about") or cmds.about(batch=True)
 
 
+def _safe_setAttr(*args, **kwargs):
+    """Wrapper to handle failures when attribute is locked.
+
+    Temporary hotfix until better approach (store value, unlock, set new,
+    return old, lock again) is implemented.
+    """
+    try:
+        cmds.setAttr(*args, **kwargs)
+    except RuntimeError:
+        print("Cannot setAttr {}!".format(args))
+
+
 # --------------------------------
 #
 # Apply version specific settings

From 1f18e5c9d35606276b1325f741662cd49e131a64 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Fri, 15 Jul 2022 18:06:37 +0200
Subject: [PATCH 1151/1227] :recycle: move submodules

---
 .gitmodules                    | 8 ++++----
 vendor/powershell/BurntToast   | 1 -
 vendor/powershell/PSWriteColor | 1 -
 vendor/powershell/README.md    | 0
 4 files changed, 4 insertions(+), 6 deletions(-)
 delete mode 160000 vendor/powershell/BurntToast
 delete mode 160000 vendor/powershell/PSWriteColor
 delete mode 100644 vendor/powershell/README.md

diff --git a/.gitmodules b/.gitmodules
index b515851c81..6a5d29ec02 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,7 +1,7 @@
-[submodule "vendor/powershell/BurntToast"]
-    path = vendor/powershell/BurntToast
+[submodule "tools/modules/powershell/BurntToast"]
+    path = tools/modules/powershell/PSWriteColor
     url = https://github.com/Windos/BurntToast.git
 
-[submodule "vendor/powershell/PSWriteColor"]
-    path = vendor/powershell/PSWriteColor
+[submodule "tools/modules/powershell/PSWriteColor"]
+    path = tools/modules/powershell/PSWriteColor
     url = https://github.com/EvotecIT/PSWriteColor.git
diff --git a/vendor/powershell/BurntToast b/vendor/powershell/BurntToast
deleted file mode 160000
index ae0acdd870..0000000000
--- a/vendor/powershell/BurntToast
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit ae0acdd870a2fd8d9f0d147de22dc36d6c5e399e
diff --git a/vendor/powershell/PSWriteColor b/vendor/powershell/PSWriteColor
deleted file mode 160000
index 12eda384eb..0000000000
--- a/vendor/powershell/PSWriteColor
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 12eda384ebd7a7954e15855e312215c009c97114
diff --git a/vendor/powershell/README.md b/vendor/powershell/README.md
deleted file mode 100644
index e69de29bb2..0000000000

From 47079516f892a3bf2e550746c87a73e2ff389524 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Fri, 15 Jul 2022 18:14:38 +0200
Subject: [PATCH 1152/1227] :truck: set scripts to new path

---
 .gitmodules                         | 2 +-
 tools/build.ps1                     | 2 +-
 tools/build_win_installer.ps1       | 2 +-
 tools/create_env.ps1                | 2 +-
 tools/create_zip.ps1                | 2 +-
 tools/fetch_thirdparty_libs.ps1     | 2 +-
 tools/make_docs.ps1                 | 2 +-
 tools/modules/powershell/BurntToast | 1 +
 tools/run_mongo.ps1                 | 2 +-
 tools/run_project_manager.ps1       | 2 +-
 tools/run_settings.ps1              | 2 +-
 tools/run_tests.ps1                 | 2 +-
 tools/run_tray.ps1                  | 2 +-
 13 files changed, 13 insertions(+), 12 deletions(-)
 create mode 160000 tools/modules/powershell/BurntToast

diff --git a/.gitmodules b/.gitmodules
index 6a5d29ec02..dfd89cdb3c 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,5 +1,5 @@
 [submodule "tools/modules/powershell/BurntToast"]
-    path = tools/modules/powershell/PSWriteColor
+    path = tools/modules/powershell/BurntToast
     url = https://github.com/Windos/BurntToast.git
 
 [submodule "tools/modules/powershell/PSWriteColor"]
diff --git a/tools/build.ps1 b/tools/build.ps1
index efb41e6c1b..442328b8dc 100644
--- a/tools/build.ps1
+++ b/tools/build.ps1
@@ -33,7 +33,7 @@ $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
 # Install PSWriteColor to support colorized output to terminal
-$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\tools\modules\powershell"
 
 function Start-Progress {
     param([ScriptBlock]$code)
diff --git a/tools/build_win_installer.ps1 b/tools/build_win_installer.ps1
index 8024a5a3b2..d7325edfc4 100644
--- a/tools/build_win_installer.ps1
+++ b/tools/build_win_installer.ps1
@@ -16,7 +16,7 @@ $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
 # Install PSWriteColor to support colorized output to terminal
-$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\tools\modules\powershell"
 
 function Start-Progress {
     param([ScriptBlock]$code)
diff --git a/tools/create_env.ps1 b/tools/create_env.ps1
index c0cbe9775b..2b2f0c3904 100644
--- a/tools/create_env.ps1
+++ b/tools/create_env.ps1
@@ -30,7 +30,7 @@ $openpype_root = (Get-Item $script_dir).parent.FullName
 
 & git submodule update --init --recursive
 # Install PSWriteColor to support colorized output to terminal
-$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\tools\modules\powershell"
 
 
 function Exit-WithCode($exitcode) {
diff --git a/tools/create_zip.ps1 b/tools/create_zip.ps1
index b4b66424ca..7b852b7c54 100644
--- a/tools/create_zip.ps1
+++ b/tools/create_zip.ps1
@@ -24,7 +24,7 @@ $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
 # Install PSWriteColor to support colorized output to terminal
-$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\tools\modules\powershell"
 
 function Exit-WithCode($exitcode) {
    # Only exit this host process if it's a child of another PowerShell parent process...
diff --git a/tools/fetch_thirdparty_libs.ps1 b/tools/fetch_thirdparty_libs.ps1
index 41a3585ff9..05eb073fdd 100644
--- a/tools/fetch_thirdparty_libs.ps1
+++ b/tools/fetch_thirdparty_libs.ps1
@@ -16,7 +16,7 @@ $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
 # Install PSWriteColor to support colorized output to terminal
-$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\tools\modules\powershell"
 
 $env:_INSIDE_OPENPYPE_TOOL = "1"
 
diff --git a/tools/make_docs.ps1 b/tools/make_docs.ps1
index d356f081de..43ecd0c09c 100644
--- a/tools/make_docs.ps1
+++ b/tools/make_docs.ps1
@@ -49,7 +49,7 @@ $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
 # Install PSWriteColor to support colorized output to terminal
-$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\tools\modules\powershell"
 
 Write-Host $art -ForegroundColor DarkGreen
 
diff --git a/tools/modules/powershell/BurntToast b/tools/modules/powershell/BurntToast
new file mode 160000
index 0000000000..f58c9a26d6
--- /dev/null
+++ b/tools/modules/powershell/BurntToast
@@ -0,0 +1 @@
+Subproject commit f58c9a26d6ede30ecc7998e92b26974887e945fe
diff --git a/tools/run_mongo.ps1 b/tools/run_mongo.ps1
index 934ce67181..b6b091a9d1 100644
--- a/tools/run_mongo.ps1
+++ b/tools/run_mongo.ps1
@@ -16,7 +16,7 @@ $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
 # Install PSWriteColor to support colorized output to terminal
-$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\tools\modules\powershell"
 
 $art = @"
 
diff --git a/tools/run_project_manager.ps1 b/tools/run_project_manager.ps1
index 2932358c2a..c1813e4ed9 100644
--- a/tools/run_project_manager.ps1
+++ b/tools/run_project_manager.ps1
@@ -36,7 +36,7 @@ $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
 # Install PSWriteColor to support colorized output to terminal
-$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\tools\modules\powershell"
 
 $env:_INSIDE_OPENPYPE_TOOL = "1"
 
diff --git a/tools/run_settings.ps1 b/tools/run_settings.ps1
index 918ea367ab..c74ae1ea3a 100644
--- a/tools/run_settings.ps1
+++ b/tools/run_settings.ps1
@@ -16,7 +16,7 @@ $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
 # Install PSWriteColor to support colorized output to terminal
-$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\tools\modules\powershell"
 
 $env:_INSIDE_OPENPYPE_TOOL = "1"
 
diff --git a/tools/run_tests.ps1 b/tools/run_tests.ps1
index 7995c6a8e9..4fa598c413 100644
--- a/tools/run_tests.ps1
+++ b/tools/run_tests.ps1
@@ -16,7 +16,7 @@ $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
 # Install PSWriteColor to support colorized output to terminal
-$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\tools\modules\powershell"
 
 function Exit-WithCode($exitcode) {
    # Only exit this host process if it's a child of another PowerShell parent process...
diff --git a/tools/run_tray.ps1 b/tools/run_tray.ps1
index 7dee3d0064..40157c4e81 100644
--- a/tools/run_tray.ps1
+++ b/tools/run_tray.ps1
@@ -15,7 +15,7 @@ $script_dir = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
 $openpype_root = (Get-Item $script_dir).parent.FullName
 
 # Install PSWriteColor to support colorized output to terminal
-$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\vendor\powershell"
+$env:PSModulePath = $env:PSModulePath + ";$($openpype_root)\tools\modules\powershell"
 
 $env:_INSIDE_OPENPYPE_TOOL = "1"
 

From fce30b519f7c6df3a59a2c8328d314c2cf7b2aa8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Fri, 15 Jul 2022 18:15:31 +0200
Subject: [PATCH 1153/1227] :heavy_plus_sign: add PSWriteColor to right place

---
 tools/modules/powershell/PSWriteColor | 1 +
 1 file changed, 1 insertion(+)
 create mode 160000 tools/modules/powershell/PSWriteColor

diff --git a/tools/modules/powershell/PSWriteColor b/tools/modules/powershell/PSWriteColor
new file mode 160000
index 0000000000..12eda384eb
--- /dev/null
+++ b/tools/modules/powershell/PSWriteColor
@@ -0,0 +1 @@
+Subproject commit 12eda384ebd7a7954e15855e312215c009c97114

From 623e5d18c0d2290d68104e64656b9a6cd1d48602 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Fri, 15 Jul 2022 18:19:21 +0200
Subject: [PATCH 1154/1227] :hammer: catch exception for toasts

---
 tools/build.ps1                 | 6 ++++--
 tools/build_win_installer.ps1   | 6 +++---
 tools/create_env.ps1            | 7 ++++---
 tools/fetch_thirdparty_libs.ps1 | 5 ++++-
 4 files changed, 15 insertions(+), 9 deletions(-)

diff --git a/tools/build.ps1 b/tools/build.ps1
index 442328b8dc..195b2dc75e 100644
--- a/tools/build.ps1
+++ b/tools/build.ps1
@@ -189,6 +189,8 @@ Write-Color -Text ">>> ", "Restoring current directory" -Color Green, Gray
 Set-Location -Path $current_dir
 
 $endTime = [int][double]::Parse((Get-Date -UFormat %s))
-New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype build complete!", "All done in $($endTime - $startTime) secs. You will find OpenPype and build log in build directory."
-
+try
+{
+    New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype build complete!", "All done in $( $endTime - $startTime ) secs. You will find OpenPype and build log in build directory."
+} catch {}
 Write-Color -Text "*** ", "All done in ", $($endTime - $startTime), " secs. You will find OpenPype and build log in ", "'.\build'", " directory." -Color Green, Gray, White, Gray, White, Gray
diff --git a/tools/build_win_installer.ps1 b/tools/build_win_installer.ps1
index d7325edfc4..b9d1ca2d3f 100644
--- a/tools/build_win_installer.ps1
+++ b/tools/build_win_installer.ps1
@@ -171,7 +171,7 @@ if ($LASTEXITCODE -ne 0) {
 
 Write-Color -Text ">>> ", "Restoring current directory" -Color Green, Gray
 Set-Location -Path $current_dir
-
-New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype build complete!", "All done. You will find You will find OpenPype installer in '.\build' directory."
-
+try {
+    New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype build complete!", "All done. You will find You will find OpenPype installer in '.\build' directory."
+} catch {}
 Write-Color -Text "*** ", "All done. You will find OpenPype installer in ", "'.\build'", " directory." -Color Green, Gray, White, Gray
diff --git a/tools/create_env.ps1 b/tools/create_env.ps1
index 2b2f0c3904..3f956e5c6a 100644
--- a/tools/create_env.ps1
+++ b/tools/create_env.ps1
@@ -180,7 +180,8 @@ if ($LASTEXITCODE -ne 0) {
 }
 $endTime = [int][double]::Parse((Get-Date -UFormat %s))
 Set-Location -Path $current_dir
-
-New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype", "Virtual environment created.", "All done in $($endTime - $startTime) secs."
-
+try
+{
+    New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype", "Virtual environment created.", "All done in $( $endTime - $startTime ) secs."
+} catch {}
 Write-Color -Text ">>> ", "Virtual environment created." -Color Green, White
diff --git a/tools/fetch_thirdparty_libs.ps1 b/tools/fetch_thirdparty_libs.ps1
index 05eb073fdd..4df007ad67 100644
--- a/tools/fetch_thirdparty_libs.ps1
+++ b/tools/fetch_thirdparty_libs.ps1
@@ -38,4 +38,7 @@ $startTime = [int][double]::Parse((Get-Date -UFormat %s))
 & "$($env:POETRY_HOME)\bin\poetry" run python "$($openpype_root)\tools\fetch_thirdparty_libs.py"
 $endTime = [int][double]::Parse((Get-Date -UFormat %s))
 Set-Location -Path $current_dir
-New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype", "Dependencies downloaded", "All done in $($endTime - $startTime) secs."
+try
+{
+    New-BurntToastNotification -AppLogo "$openpype_root/openpype/resources/icons/openpype_icon.png" -Text "OpenPype", "Dependencies downloaded", "All done in $( $endTime - $startTime ) secs."
+} catch {}
\ No newline at end of file

From 1c71fe206d2a531fbd921fd49368a74a966e3426 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 18:20:01 +0200
Subject: [PATCH 1155/1227] added interactive command to documentation

---
 website/docs/admin_openpype_commands.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/website/docs/admin_openpype_commands.md b/website/docs/admin_openpype_commands.md
index 53b4799d6e..53fc12410f 100644
--- a/website/docs/admin_openpype_commands.md
+++ b/website/docs/admin_openpype_commands.md
@@ -45,6 +45,7 @@ For more information [see here](admin_use.md#run-openpype).
 | publish | Pype takes JSON from provided path and use it to publish data in it. | [📑](#publish-arguments) |
 | extractenvironments | Extract environment variables for entered context to a json file. | [📑](#extractenvironments-arguments) |
 | run | Execute given python script within OpenPype environment. | [📑](#run-arguments) |
+| interactive | Start python like interactive console session. | |
 | projectmanager | Launch Project Manager UI | [📑](#projectmanager-arguments) |
 | settings | Open Settings UI | [📑](#settings-arguments) |
 | standalonepublisher | Open Standalone Publisher UI | [📑](#standalonepublisher-arguments) |

From 188556a7253837838e6ae60c72cd2d73b5bd6da5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?=
 <33513211+antirotor@users.noreply.github.com>
Date: Fri, 15 Jul 2022 18:34:43 +0200
Subject: [PATCH 1156/1227] :pencil2: fix typos in arguments

---
 tools/run_mongo.ps1 | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/tools/run_mongo.ps1 b/tools/run_mongo.ps1
index b6b091a9d1..c64ff75969 100644
--- a/tools/run_mongo.ps1
+++ b/tools/run_mongo.ps1
@@ -50,7 +50,7 @@ function Exit-WithCode($exitcode) {
 
 function Find-Mongo ($preferred_version) {
     $defaultPath = "C:\Program Files\MongoDB\Server"
-    Write-Color -Text ">>> ", "Detecting MongoDB ... " -Color Geen, Gray -NoNewline
+    Write-Color -Text ">>> ", "Detecting MongoDB ... " -Color Green, Gray -NoNewline
     if (-not (Get-Command "mongod" -ErrorAction SilentlyContinue)) {
         if(Test-Path "$($defaultPath)\*\bin\mongod.exe" -PathType Leaf) {
         # we have mongo server installed on standard Windows location
@@ -61,7 +61,7 @@ function Find-Mongo ($preferred_version) {
             Write-Color -Text "OK" -Color Green
             $use_version = $mongoVersions[-1]
             foreach ($v in $mongoVersions) {
-                Write-Color -Text "  - found [ ", $v, " ]" - Color Cyan, White, Cyan -NoNewLine
+                Write-Color -Text "  - found [ ", $v, " ]" -Color Cyan, White, Cyan -NoNewLine
                 $version = Split-Path $v -Leaf
 
                 if ($preferred_version -eq $version) {
@@ -110,6 +110,6 @@ $preferred_version = "5.0"
 
 $mongoPath = Find-Mongo $preferred_version
 Write-Color -Text ">>> ", "Using DB path: ", "[ ", "$($dbpath)", " ]" -Color Green, Gray, Cyan, White, Cyan
-Write-Color -Text ">>> ", "Port: ", "[ ", "$($port)", " ]", -Color Green, Gray, Cyan, White, Cyan
+Write-Color -Text ">>> ", "Port: ", "[ ", "$($port)", " ]" -Color Green, Gray, Cyan, White, Cyan
 
 Start-Process -FilePath $mongopath "--dbpath $($dbpath) --port $($port)" -PassThru | Out-Null

From ace2bf4ecb1ac6eb43205090f9c670a9332d3927 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Sat, 16 Jul 2022 03:49:48 +0000
Subject: [PATCH 1157/1227] [Automated] Bump version

---
 CHANGELOG.md        | 54 +++++++++++++++++++++++----------------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 30 insertions(+), 28 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cc5bf39a29..95427e9ea9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,35 @@
 # Changelog
 
+## [3.12.2-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.1...HEAD)
+
+**🚀 Enhancements**
+
+- Ftrack: Automatic daily review session creation can define trigger hour [\#3516](https://github.com/pypeclub/OpenPype/pull/3516)
+- Ftrack: add source into Note [\#3509](https://github.com/pypeclub/OpenPype/pull/3509)
+- Ftrack: Trigger custom ftrack topic of project structure creation [\#3506](https://github.com/pypeclub/OpenPype/pull/3506)
+- Settings UI: Add extract to file action on project view [\#3505](https://github.com/pypeclub/OpenPype/pull/3505)
+- General: Event system [\#3499](https://github.com/pypeclub/OpenPype/pull/3499)
+- NewPublisher: Keep plugins with mismatch target in report [\#3498](https://github.com/pypeclub/OpenPype/pull/3498)
+- Nuke: load clip with options from settings [\#3497](https://github.com/pypeclub/OpenPype/pull/3497)
+- Migrate basic families to the new Tray Publisher [\#3469](https://github.com/pypeclub/OpenPype/pull/3469)
+
+**🐛 Bug fixes**
+
+- General: Fix hash of centos oiio archive [\#3519](https://github.com/pypeclub/OpenPype/pull/3519)
+- TrayPublisher: Simple creation enhancements and fixes [\#3513](https://github.com/pypeclub/OpenPype/pull/3513)
+- NewPublisher: Publish attributes are properly collected [\#3510](https://github.com/pypeclub/OpenPype/pull/3510)
+- TrayPublisher: Make sure host name is filled [\#3504](https://github.com/pypeclub/OpenPype/pull/3504)
+- NewPublisher: Groups work and enum multivalue [\#3501](https://github.com/pypeclub/OpenPype/pull/3501)
+
+**🔀 Refactored code**
+
+- TimersManager: Use query functions [\#3495](https://github.com/pypeclub/OpenPype/pull/3495)
+
 ## [3.12.1](https://github.com/pypeclub/OpenPype/tree/3.12.1) (2022-07-13)
 
-[Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.0...3.12.1)
+[Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.12.1-nightly.6...3.12.1)
 
 ### 📖 Documentation
 
@@ -45,8 +72,6 @@
 - LogViewer: Escape html characters in log message [\#3443](https://github.com/pypeclub/OpenPype/pull/3443)
 - Nuke: Slate frame is integrated [\#3427](https://github.com/pypeclub/OpenPype/pull/3427)
 - Maya: Camera extra data - additional fix for \#3304 [\#3386](https://github.com/pypeclub/OpenPype/pull/3386)
-- Maya: Handle excluding `model` family from frame range validator. [\#3370](https://github.com/pypeclub/OpenPype/pull/3370)
-- Harmony: audio validator has wrong logic [\#3364](https://github.com/pypeclub/OpenPype/pull/3364)
 
 **🔀 Refactored code**
 
@@ -76,7 +101,6 @@
 
 - Webserver: Added CORS middleware [\#3422](https://github.com/pypeclub/OpenPype/pull/3422)
 - Attribute Defs UI: Files widget show what is allowed to drop in [\#3411](https://github.com/pypeclub/OpenPype/pull/3411)
-- General: Add ability to change user value for templates [\#3366](https://github.com/pypeclub/OpenPype/pull/3366)
 
 **🐛 Bug fixes**
 
@@ -87,10 +111,7 @@
 - Nuke: Collect representation files based on Write [\#3407](https://github.com/pypeclub/OpenPype/pull/3407)
 - General: Filter representations before integration start [\#3398](https://github.com/pypeclub/OpenPype/pull/3398)
 - Maya: look collector typo [\#3392](https://github.com/pypeclub/OpenPype/pull/3392)
-- TVPaint: Make sure exit code is set to not None [\#3382](https://github.com/pypeclub/OpenPype/pull/3382)
 - Maya: vray device aspect ratio fix [\#3381](https://github.com/pypeclub/OpenPype/pull/3381)
-- Flame: bunch of publishing issues [\#3377](https://github.com/pypeclub/OpenPype/pull/3377)
-- Harmony: added unc path to zifile command in Harmony [\#3372](https://github.com/pypeclub/OpenPype/pull/3372)
 
 **🔀 Refactored code**
 
@@ -101,30 +122,11 @@
 - Hiero: Use client query functions [\#3393](https://github.com/pypeclub/OpenPype/pull/3393)
 - Nuke: Use client query functions [\#3391](https://github.com/pypeclub/OpenPype/pull/3391)
 - Maya: Use client query functions [\#3385](https://github.com/pypeclub/OpenPype/pull/3385)
-- Harmony: Use client query functions [\#3378](https://github.com/pypeclub/OpenPype/pull/3378)
-- Celaction: Use client query functions [\#3376](https://github.com/pypeclub/OpenPype/pull/3376)
-- Photoshop: Use client query functions [\#3375](https://github.com/pypeclub/OpenPype/pull/3375)
-- AfterEffects: Use client query functions [\#3374](https://github.com/pypeclub/OpenPype/pull/3374)
-
-**Merged pull requests:**
-
-- Sync Queue: Added far future value for null values for dates [\#3371](https://github.com/pypeclub/OpenPype/pull/3371)
-- Maya - added support for single frame playblast review [\#3369](https://github.com/pypeclub/OpenPype/pull/3369)
 
 ## [3.11.1](https://github.com/pypeclub/OpenPype/tree/3.11.1) (2022-06-20)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.11.1-nightly.1...3.11.1)
 
-**🚀 Enhancements**
-
-- Pyblish Pype: Hiding/Close issues [\#3367](https://github.com/pypeclub/OpenPype/pull/3367)
-
-**🐛 Bug fixes**
-
-- Nuke: bake streams with slate on farm [\#3368](https://github.com/pypeclub/OpenPype/pull/3368)
-- Nuke: Fix missing variable in extract thumbnail [\#3363](https://github.com/pypeclub/OpenPype/pull/3363)
-- Nuke: Fix precollect writes [\#3361](https://github.com/pypeclub/OpenPype/pull/3361)
-
 ## [3.11.0](https://github.com/pypeclub/OpenPype/tree/3.11.0) (2022-06-17)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.11.0-nightly.4...3.11.0)
diff --git a/openpype/version.py b/openpype/version.py
index c7b0de0381..e9206379e1 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.1"
+__version__ = "3.12.2-nightly.1"
diff --git a/pyproject.toml b/pyproject.toml
index 078503a284..19d65b50f9 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.1" # OpenPype
+version = "3.12.2-nightly.1" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 971aef4342e8353a83fc2fe9bf2500a48069aa3d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 18 Jul 2022 10:35:56 +0200
Subject: [PATCH 1158/1227] Removed query list from python file

---
 openpype/client/entities.py | 604 ------------------------------------
 1 file changed, 604 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 9d65355d1b..38552d9a56 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -1348,622 +1348,18 @@ def get_workfile_info(
     - openpype/hosts/maya/api/shader_definition_editor.py
     - openpype/hosts/maya/plugins/publish/validate_model_name.py
 
-## Global launch hooks
-- openpype/hooks/pre_global_host_data.py
-    Query:
-    - project
-    - asset
-
-## Global load plugins
-- openpype/plugins/load/delete_old_versions.py
-    Query:
-    - versions
-    - representations
-- openpype/plugins/load/delivery.py
-    Query:
-    - representations
-
 ## Global publish plugins
-- openpype/plugins/publish/collect_avalon_entities.py
-    Query:
-    - asset
-    - project
-- openpype/plugins/publish/collect_anatomy_instance_data.py
-    Query:
-    - assets
-    - subsets
-    - last version
-- openpype/plugins/publish/collect_scene_loaded_versions.py
-    Query:
-    - representations
 - openpype/plugins/publish/extract_hierarchy_avalon.py
-    Query:
-    - asset
-    - assets
-    - project
     Create:
     - asset
     Update:
     - asset
-- openpype/plugins/publish/integrate_hero_version.py
-    Query:
-    - version
-    - hero version
-    - representations
-- openpype/plugins/publish/integrate_new.py
-    Query:
-    - asset
-    - subset
-    - version
-    - representations
-- openpype/plugins/publish/integrate_thumbnail.py
-    Query:
-    - version
-- openpype/plugins/publish/validate_editorial_asset_name.py
-    Query:
-    - assets
 
 ## Lib
-- openpype/lib/applications.py
-    Query:
-    - project
-    - asset
 - openpype/lib/avalon_context.py
-    Query:
-    - project
-    - asset
-    - linked assets (new function get_linked_assets?)
-    - subset
-    - subsets
-    - version
-    - versions
-    - last version
-    - representations
-    - linked representations (new function get_linked_ids_for_representations)
     Update:
     - workfile data
-- openpype/lib/plugin_tools.py
-    Query:
-    - asset
 - openpype/lib/project_backpack.py
-    Query:
-    - project
-    - everything from mongo
     Update:
     - project
-- openpype/lib/usdlib.py
-    Query:
-    - project
-    - asset
-
-## Pipeline
-- openpype/pipeline/load/utils.py
-    Query:
-    - project
-    - assets
-    - subsets
-    - version
-    - versions
-    - representation
-    - representations
-- openpype/pipeline/mongodb.py
-    Query:
-    - project
-- openpype/pipeline/thumbnail.py
-    Query:
-    - project
-
-## Hosts
-### Aftereffects
-- openpype/hosts/aftereffects/plugins/create/workfile_creator.py
-    Query:
-    - asset
-
-### Blender
-- openpype/hosts/blender/api/pipeline.py
-    Query:
-    - asset
-- openpype/hosts/blender/plugins/publish/extract_layout.py
-    Query:
-    - representation
-
-### Celaction
-- openpype/hosts/celaction/plugins/publish/collect_audio.py
-    Query:
-    - subsets
-    - last versions
-    - representations
-
-### Fusion
-- openpype/hosts/fusion/api/lib.py
-    Query:
-    - asset
-    - subset
-    - version
-    - representation
-- openpype/hosts/fusion/plugins/load/load_sequence.py
-    Query:
-    - version
-- openpype/hosts/fusion/scripts/fusion_switch_shot.py
-    Query:
-    - project
-    - asset
-    - versions
-- openpype/hosts/fusion/utility_scripts/switch_ui.py
-    Query:
-    - assets
-
-### Harmony
-- openpype/hosts/harmony/api/pipeline.py
-    Query:
-    - representation
-
-### Hiero
-- openpype/hosts/hiero/api/lib.py
-    Query:
-    - project
-    - version
-    - versions
-    - representation
-- openpype/hosts/hiero/api/tags.py
-    Query:
-    - task types
-    - assets
-- openpype/hosts/hiero/plugins/load/load_clip.py
-    Query:
-    - version
-    - versions
-- openpype/hosts/hiero/plugins/publish_old_workflow/collect_assetbuilds.py
-    Query:
-    - assets
-
-### Houdini
-- openpype/hosts/houdini/api/lib.py
-    Query:
-    - asset
-- openpype/hosts/houdini/api/usd.py
-    Query:
-    - asset
-- openpype/hosts/houdini/plugins/create/create_hda.py
-    Query:
-    - asset
-    - subsets
-- openpype/hosts/houdini/plugins/publish/collect_usd_bootstrap.py
-    Query:
-    - asset
-    - subset
-- openpype/hosts/houdini/plugins/publish/extract_usd_layered.py
-    Query:
-    - asset
-    - subset
-    - version
-    - representation
-- openpype/hosts/houdini/plugins/publish/validate_usd_shade_model_exists.py
-    Query:
-    - asset
-    - subset
-- openpype/hosts/houdini/vendor/husdoutputprocessors/avalon_uri_processor.py
-    Query:
-    - project
-    - asset
-
-### Maya
-- openpype/hosts/maya/api/action.py
-    Query:
-    - asset
-- openpype/hosts/maya/api/commands.py
-    Query:
-    - asset
-    - project
-- openpype/hosts/maya/api/lib.py
-    Query:
-    - project
-    - asset
-    - subset
-    - subsets
-    - version
-    - representation
-- openpype/hosts/maya/api/setdress.py
-    Query:
-    - version
-    - representation
-- openpype/hosts/maya/plugins/inventory/import_modelrender.py
-    Query:
-    - representation
-- openpype/hosts/maya/plugins/load/load_audio.py
-    Query:
-    - asset
-    - subset
-    - version
-- openpype/hosts/maya/plugins/load/load_image_plane.py
-    Query:
-    - asset
-    - subset
-    - version
-- openpype/hosts/maya/plugins/load/load_look.py
-    Query:
-    - representation
-- openpype/hosts/maya/plugins/load/load_vrayproxy.py
-    Query:
-    - representation
-- openpype/hosts/maya/plugins/load/load_yeti_cache.py
-    Query:
-    - representation
-- openpype/hosts/maya/plugins/publish/collect_review.py
-    Query:
-    - subsets
-- openpype/hosts/maya/plugins/publish/validate_node_ids_in_database.py
-    Query:
-    - assets
-- openpype/hosts/maya/plugins/publish/validate_node_ids_related.py
-    Query:
-    - asset
-- openpype/hosts/maya/plugins/publish/validate_renderlayer_aovs.py
-    Query:
-    - asset
-    - subset
-
-### Nuke
-- openpype/hosts/nuke/api/command.py
-    Query:
-    - project
-    - asset
-- openpype/hosts/nuke/api/lib.py
-    Query:
-    - project
-    - asset
-    - version
-    - versions
-    - representation
-- openpype/hosts/nuke/plugins/load/load_backdrop.py
-    Query:
-    - version
-    - versions
-- openpype/hosts/nuke/plugins/load/load_camera_abc.py
-    Query:
-    - version
-    - versions
-- openpype/hosts/nuke/plugins/load/load_clip.py
-    Query:
-    - version
-    - versions
-- openpype/hosts/nuke/plugins/load/load_effects_ip.py
-    Query:
-    - version
-    - versions
-- openpype/hosts/nuke/plugins/load/load_effects.py
-    Query:
-    - version
-    - versions
-- openpype/hosts/nuke/plugins/load/load_gizmo_ip.py
-    Query:
-    - version
-    - versions
-- openpype/hosts/nuke/plugins/load/load_gizmo.py
-    Query:
-    - version
-    - versions
-- openpype/hosts/nuke/plugins/load/load_image.py
-    Query:
-    - version
-    - versions
-- openpype/hosts/nuke/plugins/load/load_model.py
-    Query:
-    - version
-    - versions
-- openpype/hosts/nuke/plugins/load/load_script_precomp.py
-    Query:
-    - version
-    - versions
-- openpype/hosts/nuke/plugins/publish/collect_reads.py
-    Query:
-    - asset
-- openpype/hosts/nuke/plugins/publish/precollect_instances.py
-    Query:
-    - asset
-- openpype/hosts/nuke/plugins/publish/precollect_writes.py
-    Query:
-    - representation
-- openpype/hosts/nuke/plugins/publish/validate_script.py
-    Query:
-    - asset
-    - project
-
-### Photoshop
-- openpype/hosts/photoshop/plugins/create/workfile_creator.py
-    Query:
-    - asset
-
-### Resolve
-- openpype/hosts/resolve/plugins/load/load_clip.py
-    Query:
-    - version
-    - versions
-
-### Standalone publisher
-- openpype/hosts/standalonepublisher/plugins/publish/collect_bulk_mov_instances.py
-    Query:
-    - asset
-- openpype/hosts/standalonepublisher/plugins/publish/collect_matching_asset.py
-    Query:
-    - assets
-- openpype/hosts/standalonepublisher/plugins/publish/collect_hierarchy.py
-    Query:
-    - project
-    - asset
-- openpype/hosts/standalonepublisher/plugins/publish/validate_task_existence.py
-    Query:
-    - assets
-
-### TVPaint
-- openpype/hosts/tvpaint/api/pipeline.py
-    Query:
-    - project
-    - asset
-- openpype/hosts/tvpaint/plugins/load/load_workfile.py
-    Query:
-    - project
-    - asset
-- openpype/hosts/tvpaint/plugins/publish/collect_instances.py
-    Query:
-    - asset
-- openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
-    Query:
-    - asset
-- openpype/hosts/tvpaint/plugins/publish/collect_workfile.py
-    Query:
-    - asset
-
-### Unreal
-- openpype/hosts/unreal/plugins/load/load_camera.py
-    Query:
-    - asset
-    - assets
-- openpype/hosts/unreal/plugins/load/load_layout.py
-    Query:
-    - asset
-    - assets
-- openpype/hosts/unreal/plugins/publish/extract_layout.py
-    Query:
-    - representation
-
-### Webpublisher
-- openpype/hosts/webpublisher/webserver_service/webpublish_routes.py
-    Query:
-    - assets
-- openpype/hosts/webpublisher/plugins/publish/collect_published_files.py
-    Query:
-    - last versions
-
-## Tools
-openpype/tools/assetlinks/widgets.py
-- SimpleLinkView
-    Query:
-    - get_versions
-    - get_subsets
-    - get_assets
-    - get_output_link_versions
-
-openpype/tools/creator/window.py
-- CreatorWindow
-    Query:
-    - get_asset_by_name
-    - get_subsets
-
-openpype/tools/launcher/models.py
-- LauncherModel
-    Query:
-    - get_project
-    - get_assets
-
-openpype/tools/libraryloader/app.py
-- LibraryLoaderWindow
-    Query:
-    - get_project
-
-openpype/tools/loader/app.py
-- LoaderWindow
-    Query:
-    - get_project
-- show
-    Query:
-    - get_projects
-
-openpype/tools/loader/model.py
-- SubsetsModel
-    Query:
-    - get_assets
-    - get_subsets
-    - get_last_versions
-    - get_versions
-    - get_hero_versions
-    - get_version_by_name
-- RepresentationModel
-    Query:
-    - get_representations
-    - sync server specific queries (separated into multiple functions?)
-        - NOT REPLACED
-
-openpype/tools/loader/widgets.py
-- FamilyModel
-    Query:
-    - get_subset_families
-- VersionTextEdit
-    Query:
-    - get_subset_by_id
-    - get_version_by_id
-- SubsetWidget
-    Query:
-    - get_subsets
-    - get_representations
-    Update:
-    - Subset groups (combination of asset id and subset names)
-- RepresentationWidget
-    Query:
-    - get_subsets
-    - get_versions
-    - get_representations
-- ThumbnailWidget
-    Query:
-    - get_thumbnail_id_from_source
-    - get_thumbnail
-
-openpype/tools/mayalookassigner/app.py
-- MayaLookAssignerWindow
-    Query:
-    - get_last_version_by_subset_id
-
-openpype/tools/mayalookassigner/commands.py
-- create_items_from_nodes
-    Query:
-    - get_asset_by_id
-
-openpype/tools/mayalookassigner/vray_proxies.py
-- get_look_relationships
-    Query:
-    - get_representation_by_name
-- load_look
-    Query:
-    - get_representation_by_name
-- vrayproxy_assign_look
-    Query:
-    - get_last_version_by_subset_name
-
-openpype/tools/project_manager/project_manager/model.py
-- HierarchyModel
-    Query:
-    - get_asset_ids_with_subsets
-    - get_project
-    - get_assets
-
-openpype/tools/project_manager/project_manager/view.py
-- ProjectDocCache
-    Query:
-    - get_project
-
-openpype/tools/project_manager/project_manager/widgets.py
-- CreateProjectDialog
-    Query:
-    - get_projects
-
-openpype/tools/publisher/widgets/create_dialog.py
-- CreateDialog
-    Query:
-    - get_asset_by_name
-    - get_subsets
-
-openpype/tools/publisher/control.py
-- AssetDocsCache
-    Query:
-    - get_assets
-
-openpype/tools/sceneinventory/model.py
-- InventoryModel
-    Query:
-    - get_asset_by_id
-    - get_subset_by_id
-    - get_version_by_id
-    - get_last_version_by_subset_id
-    - get_representation
-
-openpype/tools/sceneinventory/switch_dialog.py
-- SwitchAssetDialog
-    Query:
-    - get_asset_by_name
-    - get_assets
-    - get_subset_by_name
-    - get_subsets
-    - get_versions
-    - get_hero_versions
-    - get_last_versions
-    - get_representations
-
-openpype/tools/sceneinventory/view.py
-- SceneInventoryView
-    Query:
-    - get_version_by_id
-    - get_versions
-    - get_hero_versions
-    - get_representation_by_id
-    - get_representations
-
-openpype/tools/standalonepublish/widgets/model_asset.py
-- AssetModel
-    Query:
-    - get_assets
-
-openpype/tools/standalonepublish/widgets/widget_asset.py
-- AssetWidget
-    Query:
-    - get_project
-    - get_asset_by_id
-
-openpype/tools/standalonepublish/widgets/widget_family.py
-- FamilyWidget
-    Query:
-    - get_asset_by_name
-    - get_subset_by_name
-    - get_subsets
-    - get_last_version_by_subset_id
-
-openpype/tools/standalonepublish/app.py
-- Window
-    Query:
-    - get_asset_by_id
-
-openpype/tools/texture_copy/app.py
-- TextureCopy
-    Query:
-    - get_project
-    - get_asset_by_name
-
-openpype/tools/workfiles/files_widget.py
-- FilesWidget
-    Query:
-    - get_asset_by_id
-
-openpype/tools/workfiles/model.py
-- PublishFilesModel
-    Query:
-    - get_subsets
-    - get_versions
-    - get_representations
-
-openpype/tools/workfiles/save_as_dialog.py
-- build_workfile_data
-    Query:
-    - get_project
-    - get_asset_by_name
-
-openpype/tools/workfiles/window.py
-- Window
-    Query:
-    - get_asset_by_id
-    - get_asset_by_name
-
-openpype/tools/utils/assets_widget.py
-- AssetModel
-    Query:
-    - get_project
-    - get_assets
-
-openpype/tools/utils/delegates.py
-- VersionDelegate
-    Query:
-    - get_versions
-    - get_hero_versions
-
-openpype/tools/utils/lib.py
-- GroupsConfig
-    Query:
-    - get_project
-- FamilyConfigCache
-    Query:
-    - get_asset_by_name
-
-openpype/tools/utils/tasks_widget.py
-- TasksModel
-    Query:
-    - get_project
-    - get_asset_by_id
 """

From 44611981d40b02065c0a03509b7d45c25900fe66 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 18 Jul 2022 10:37:16 +0200
Subject: [PATCH 1159/1227] modified return types in docstrings

---
 openpype/client/entities.py | 176 +++++++++++++++++++-----------------
 1 file changed, 91 insertions(+), 85 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index 38552d9a56..ebd9b4821d 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -117,8 +117,8 @@ def get_asset_by_id(project_name, asset_id, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        asset_id (str|ObjectId): Asset's id.
-        fields (list[str]): Fields that should be returned. All fields are
+        asset_id (Union[str, ObjectId]): Asset's id.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -141,7 +141,7 @@ def get_asset_by_name(project_name, asset_name, fields=None):
     Args:
         project_name (str): Name of project where to look for queried entities.
         asset_name (str): Asset's name.
-        fields (list[str]): Fields that should be returned. All fields are
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -178,12 +178,13 @@ def _get_assets(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        asset_ids (list[str|ObjectId]): Asset ids that should be found.
-        asset_names (list[str]): Name assets that should be found.
-        parent_ids (list[str|ObjectId]): Parent asset ids.
+        asset_ids (Iterable[Union[str, ObjectId]]): Asset ids that should
+            be found.
+        asset_names (Iterable[str]): Name assets that should be found.
+        parent_ids (Iterable[Union[str, ObjectId]]): Parent asset ids.
         standard (bool): Query standart assets (type 'asset').
         archived (bool): Query archived assets (type 'archived_asset').
-        fields (list[str]): Fields that should be returned. All fields are
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -244,11 +245,12 @@ def get_assets(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        asset_ids (list[str|ObjectId]): Asset ids that should be found.
-        asset_names (list[str]): Name assets that should be found.
-        parent_ids (list[str|ObjectId]): Parent asset ids.
+        asset_ids (Iterable[Union[str, ObjectId]]): Asset ids that should
+            be found.
+        asset_names (Iterable[str]): Name assets that should be found.
+        parent_ids (Iterable[Union[str, ObjectId]]): Parent asset ids.
         archived (bool): Add also archived assets.
-        fields (list[str]): Fields that should be returned. All fields are
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -283,10 +285,11 @@ def get_archived_assets(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        asset_ids (list[str|ObjectId]): Asset ids that should be found.
-        asset_names (list[str]): Name assets that should be found.
-        parent_ids (list[str|ObjectId]): Parent asset ids.
-        fields (list[str]): Fields that should be returned. All fields are
+        asset_ids (Iterable[Union[str, ObjectId]]): Asset ids that should
+            be found.
+        asset_names (Iterable[str]): Name assets that should be found.
+        parent_ids (Iterable[Union[str, ObjectId]]): Parent asset ids.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -304,10 +307,11 @@ def get_asset_ids_with_subsets(project_name, asset_ids=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        asset_ids (list[str|ObjectId]): Look only for entered asset ids.
+        asset_ids (Iterable[Union[str, ObjectId]]): Look only for entered
+            asset ids.
 
     Returns:
-        List[ObjectId]: Asset ids that have existing subsets.
+        Iterable[ObjectId]: Asset ids that have existing subsets.
     """
 
     subset_query = {
@@ -345,8 +349,8 @@ def get_subset_by_id(project_name, subset_id, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        subset_id (str|ObjectId): Id of subset which should be found.
-        fields (list[str]): Fields that should be returned. All fields are
+        subset_id (Union[str, ObjectId]): Id of subset which should be found.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -369,8 +373,8 @@ def get_subset_by_name(project_name, subset_name, asset_id, fields=None):
     Args:
         project_name (str): Name of project where to look for queried entities.
         subset_name (str): Name of subset.
-        asset_id (str|ObjectId): Id of parent asset.
-        fields (list[str]): Fields that should be returned. All fields are
+        asset_id (Union[str, ObjectId]): Id of parent asset.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -409,16 +413,16 @@ def get_subsets(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        subset_ids (list[str|ObjectId]): Subset ids that should be queried.
+        subset_ids (Iterable[Union[str, ObjectId]]): Subset ids that should be
+            queried. Filter ignored if 'None' is passed.
+        subset_names (Iterable[str]): Subset names that should be queried.
             Filter ignored if 'None' is passed.
-        subset_names (list[str]): Subset names that should be queried.
-            Filter ignored if 'None' is passed.
-        asset_ids (list[str|ObjectId]): Asset ids under which should look for
-            the subsets. Filter ignored if 'None' is passed.
-        names_by_asset_ids (dict[ObjectId, list[str]]): Complex filtering
+        asset_ids (Iterable[Union[str, ObjectId]]): Asset ids under which should
+            look for the subsets. Filter ignored if 'None' is passed.
+        names_by_asset_ids (dict[ObjectId, List[str]]): Complex filtering
             using asset ids and list of subset names under the asset.
         archived (bool): Look for archived subsets too.
-        fields (list[str]): Fields that should be returned. All fields are
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -472,8 +476,8 @@ def get_subset_families(project_name, subset_ids=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        subset_ids (list[str|ObjectId]): Subset ids that should be queried.
-            All subsets from project are used if 'None' is passed.
+        subset_ids (Iterable[Union[str, ObjectId]]): Subset ids that should
+            be queried. All subsets from project are used if 'None' is passed.
 
     Returns:
          set[str]: Main families of matching subsets.
@@ -508,8 +512,8 @@ def get_version_by_id(project_name, version_id, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        version_id (str|ObjectId): Id of version which should be found.
-        fields (list[str]): Fields that should be returned. All fields are
+        version_id (Union[str, ObjectId]): Id of version which should be found.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -535,8 +539,8 @@ def get_version_by_name(project_name, version, subset_id, fields=None):
     Args:
         project_name (str): Name of project where to look for queried entities.
         version (int): name of version entity (it's version).
-        subset_id (str|ObjectId): Id of version which should be found.
-        fields (list[str]): Fields that should be returned. All fields are
+        subset_id (Union[str, ObjectId]): Id of version which should be found.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -621,14 +625,14 @@ def get_versions(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        version_ids (list[str|ObjectId]): Version ids that will be queried.
+        version_ids (Iterable[Union[str, ObjectId]]): Version ids that will
+            be queried. Filter ignored if 'None' is passed.
+        subset_ids (Iterable[str]): Subset ids that will be queried.
             Filter ignored if 'None' is passed.
-        subset_ids (list[str]): Subset ids that will be queried.
-            Filter ignored if 'None' is passed.
-        versions (list[int]): Version names (as integers).
+        versions (Iterable[int]): Version names (as integers).
             Filter ignored if 'None' is passed.
         hero (bool): Look also for hero versions.
-        fields (list[str]): Fields that should be returned. All fields are
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -651,8 +655,9 @@ def get_hero_version_by_subset_id(project_name, subset_id, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        subset_id (str|ObjectId): Subset id under which is hero version.
-        fields (list[str]): Fields that should be returned. All fields are
+        subset_id (Union[str, ObjectId]): Subset id under which
+            is hero version.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -681,8 +686,8 @@ def get_hero_version_by_id(project_name, version_id, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        version_id (str|ObjectId): Hero version id.
-        fields (list[str]): Fields that should be returned. All fields are
+        version_id (Union[str, ObjectId]): Hero version id.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -716,11 +721,11 @@ def get_hero_versions(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        subset_ids (list[str|ObjectId]): Subset ids for which should look for
-            hero versions. Filter ignored if 'None' is passed.
-        version_ids (list[str|ObjectId]): Hero version ids. Filter ignored if
-            'None' is passed.
-        fields (list[str]): Fields that should be returned. All fields are
+        subset_ids (Iterable[Union[str, ObjectId]]): Subset ids for which
+            should look for hero versions. Filter ignored if 'None' is passed.
+        version_ids (Iterable[Union[str, ObjectId]]): Hero version ids. Filter
+            ignored if 'None' is passed.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -746,13 +751,13 @@ def get_output_link_versions(project_name, version_id, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        version_id (str|ObjectId): Version id which can be used as input link
-            for other versions.
-        fields (list[str]): Fields that should be returned. All fields are
+        version_id (Union[str, ObjectId]): Version id which can be used
+            as input link for other versions.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
-        Cursor|list: Iterable cursor yielding versions that are used as input
+        Iterable: Iterable cursor yielding versions that are used as input
             links for passed version.
     """
 
@@ -774,8 +779,8 @@ def get_last_versions(project_name, subset_ids, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        subset_ids (list): List of subset ids.
-        fields (list[str]): Fields that should be returned. All fields are
+        subset_ids (Iterable[Union[str, ObjectId]]): List of subset ids.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -859,8 +864,8 @@ def get_last_version_by_subset_id(project_name, subset_id, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        subset_id (str|ObjectId): Id of version which should be found.
-        fields (list[str]): Fields that should be returned. All fields are
+        subset_id (Union[str, ObjectId]): Id of version which should be found.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -889,10 +894,10 @@ def get_last_version_by_subset_name(
     Args:
         project_name (str): Name of project where to look for queried entities.
         subset_name (str): Name of subset.
-        asset_id (str|ObjectId): Asset id which is parent of passed
+        asset_id (Union[str, ObjectId]): Asset id which is parent of passed
             subset name.
         asset_name (str): Asset name which is parent of passed subset name.
-        fields (list[str]): Fields that should be returned. All fields are
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -923,8 +928,8 @@ def get_representation_by_id(project_name, representation_id, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        representation_id (str|ObjectId): Representation id.
-        fields (list[str]): Fields that should be returned. All fields are
+        representation_id (Union[str, ObjectId]): Representation id.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -956,8 +961,8 @@ def get_representation_by_name(
     Args:
         project_name (str): Name of project where to look for queried entities.
         representation_name (str): Representation name.
-        version_id (str|ObjectId): Id of parent version entity.
-        fields (list[str]): Fields that should be returned. All fields are
+        version_id (Union[str, ObjectId]): Id of parent version entity.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -1061,18 +1066,18 @@ def get_representations(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        representation_ids (list[str|ObjectId]): Representation ids used as
-            filter. Filter ignored if 'None' is passed.
-        representation_names (list[str]): Representations names used as filter.
-            Filter ignored if 'None' is passed.
-        version_ids (list[str]): Subset ids used as parent filter. Filter
+        representation_ids (Iterable[Union[str, ObjectId]]): Representation ids
+            used as filter. Filter ignored if 'None' is passed.
+        representation_names (Iterable[str]): Representations names used
+            as filter. Filter ignored if 'None' is passed.
+        version_ids (Iterable[str]): Subset ids used as parent filter. Filter
             ignored if 'None' is passed.
-        extensions (list[str]): Filter by extension of main representation
+        extensions (Iterable[str]): Filter by extension of main representation
             file (without dot).
         names_by_version_ids (dict[ObjectId, list[str]]): Complex filtering
             using version ids and list of names under the version.
         archived (bool): Output will also contain archived representations.
-        fields (list[str]): Fields that should be returned. All fields are
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -1107,17 +1112,17 @@ def get_archived_representations(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        representation_ids (list[str|ObjectId]): Representation ids used as
-            filter. Filter ignored if 'None' is passed.
-        representation_names (list[str]): Representations names used as filter.
-            Filter ignored if 'None' is passed.
-        version_ids (list[str]): Subset ids used as parent filter. Filter
+        representation_ids (Iterable[Union[str, ObjectId]]): Representation ids
+            used as filter. Filter ignored if 'None' is passed.
+        representation_names (Iterable[str]): Representations names used
+            as filter. Filter ignored if 'None' is passed.
+        version_ids (Iterable[str]): Subset ids used as parent filter. Filter
             ignored if 'None' is passed.
-        extensions (list[str]): Filter by extension of main representation
+        extensions (Iterable[str]): Filter by extension of main representation
             file (without dot).
-        names_by_version_ids (dict[ObjectId, list[str]]): Complex filtering
+        names_by_version_ids (dict[ObjectId, List[str]]): Complex filtering
             using version ids and list of names under the version.
-        fields (list[str]): Fields that should be returned. All fields are
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -1145,7 +1150,7 @@ def get_representations_parents(project_name, representations):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        representations (list[dict]): Representation entities with at least
+        representations (List[dict]): Representation entities with at least
             '_id' and 'parent' keys.
 
     Returns:
@@ -1238,7 +1243,7 @@ def get_thumbnail_id_from_source(project_name, src_type, src_id):
     Args:
         project_name (str): Name of project where to look for queried entities.
         src_type (str): Type of source entity ('asset', 'version').
-        src_id (str|objectId): Id of source entity.
+        src_id (Union[str, ObjectId]): Id of source entity.
 
     Returns:
         ObjectId: Thumbnail id assigned to entity.
@@ -1265,8 +1270,9 @@ def get_thumbnails(project_name, thumbnail_ids, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        thumbnail_ids (list[str|ObjectId]): Ids of thumbnail entities.
-        fields (list[str]): Fields that should be returned. All fields are
+        thumbnail_ids (Iterable[Union[str, ObjectId]]): Ids of thumbnail
+            entities.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -1291,8 +1297,8 @@ def get_thumbnail(project_name, thumbnail_id, fields=None):
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        thumbnail_id (str|ObjectId): Id of thumbnail entity.
-        fields (list[str]): Fields that should be returned. All fields are
+        thumbnail_id (Union[str, ObjectId]): Id of thumbnail entity.
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
 
     Returns:
@@ -1319,9 +1325,9 @@ def get_workfile_info(
 
     Args:
         project_name (str): Name of project where to look for queried entities.
-        asset_id (str|ObjectId): Id of asset entity.
+        asset_id (Union[str, ObjectId]): Id of asset entity.
         task_name (str): Task name on asset.
-        fields (list[str]): Fields that should be returned. All fields are
+        fields (Iterable[str]): Fields that should be returned. All fields are
             returned if 'None' is passed.
     """
 

From 340c20e64ca1e9239b9dc1d067fbdefac053be5e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 18 Jul 2022 10:43:20 +0200
Subject: [PATCH 1160/1227] fix line length

---
 openpype/client/entities.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/client/entities.py b/openpype/client/entities.py
index ebd9b4821d..e7eeadcf48 100644
--- a/openpype/client/entities.py
+++ b/openpype/client/entities.py
@@ -417,8 +417,8 @@ def get_subsets(
             queried. Filter ignored if 'None' is passed.
         subset_names (Iterable[str]): Subset names that should be queried.
             Filter ignored if 'None' is passed.
-        asset_ids (Iterable[Union[str, ObjectId]]): Asset ids under which should
-            look for the subsets. Filter ignored if 'None' is passed.
+        asset_ids (Iterable[Union[str, ObjectId]]): Asset ids under which
+            should look for the subsets. Filter ignored if 'None' is passed.
         names_by_asset_ids (dict[ObjectId, List[str]]): Complex filtering
             using asset ids and list of subset names under the asset.
         archived (bool): Look for archived subsets too.

From eed26c09fc0385a907703622ddfb6f29339b6860 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 18 Jul 2022 10:53:48 +0200
Subject: [PATCH 1161/1227] OP-3589 - renamed method

---
 openpype/plugins/publish/extract_thumbnail.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/extract_thumbnail.py b/openpype/plugins/publish/extract_thumbnail.py
index e6df5b3ee0..7933595b89 100644
--- a/openpype/plugins/publish/extract_thumbnail.py
+++ b/openpype/plugins/publish/extract_thumbnail.py
@@ -46,7 +46,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             self.log.info("Skipping - no review set on instance.")
             return
 
-        if self._has_thumbnail_already(instance):
+        if self._already_has_thumbnail(instance):
             self.log.info("Thumbnail representation already present.")
             return
 
@@ -106,7 +106,7 @@ class ExtractThumbnail(pyblish.api.InstancePlugin):
             # There is no need to create more then one thumbnail
             break
 
-    def _has_thumbnail_already(self, instance):
+    def _already_has_thumbnail(self, instance):
         for repre in instance.data.get("representations", []):
             self.log.info("repre {}".format(repre))
             if repre["name"] == "thumbnail":

From 247db779fe416c663d0b8e4ae100284fe9977476 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 18 Jul 2022 10:56:08 +0200
Subject: [PATCH 1162/1227] Update
 openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../traypublisher/plugins/publish/validate_frame_ranges.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
index 89289fc6d4..bb6b906e8d 100644
--- a/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
+++ b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
@@ -58,9 +58,10 @@ class ValidateFrameRange(OptionalPyblishPluginMixin,
             files = [files]
         frames = len(files)
 
-        msg = "Frame duration from DB:'{}' ". format(int(duration)) +\
-              " doesn't match number of files:'{}'".format(frames) +\
-              " Please change frame range for Asset or limit no. of files"
+        msg = (
+            "Frame duration from DB:'{}' doesn't match number of files:'{}'"
+            " Please change frame range for Asset or limit no. of files"
+        ). format(int(duration), frames)
 
         formatting_data = {"duration": duration,
                            "found": frames}

From cdabfbe6f9d0ea90df1a44525bf0ae88a45c825d Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 18 Jul 2022 10:56:25 +0200
Subject: [PATCH 1163/1227] Update
 openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../traypublisher/plugins/publish/validate_frame_ranges.py     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
index bb6b906e8d..0d7081139d 100644
--- a/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
+++ b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
@@ -35,7 +35,8 @@ class ValidateFrameRange(OptionalPyblishPluginMixin,
                for pattern in self.skip_timelines_check):
             self.log.info("Skipping for {} task".format(instance.data["task"]))
 
-        asset_data = lib.get_asset(instance.data["asset"])["data"]
+        asset_doc = instance.data["assetEntity"]
+        asset_data = asset_doc["data"]
         frame_start = asset_data["frameStart"]
         frame_end = asset_data["frameEnd"]
         handle_start = asset_data["handleStart"]

From ef2284e507cd43db6b14518244333d10db1091b6 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 18 Jul 2022 10:57:01 +0200
Subject: [PATCH 1164/1227] Update
 openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../plugins/publish/validate_frame_ranges.py          | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
index 0d7081139d..6d48e8352c 100644
--- a/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
+++ b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
@@ -43,18 +43,19 @@ class ValidateFrameRange(OptionalPyblishPluginMixin,
         handle_end = asset_data["handleEnd"]
         duration = (frame_end - frame_start + 1) + handle_start + handle_end
 
-        repre = instance.data.get("representations", [None])
-        if not repre:
+        repres = instance.data.get("representations")
+        if not repres:
             self.log.info("No representations, skipping.")
             return
-
-        ext = repre[0]['ext'].replace(".", '')
+            
+        first_repre = repres[0]
+        ext = first_repre['ext'].replace(".", '')
 
         if not ext or ext.lower() not in self.check_extensions:
             self.log.warning("Cannot check for extension {}".format(ext))
             return
 
-        files = instance.data.get("representations", [None])[0]["files"]
+        files = first_repre["files"]
         if isinstance(files, str):
             files = [files]
         frames = len(files)

From 247eaf792bb21fd294bf95bb64423965834a4b00 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 18 Jul 2022 11:01:30 +0200
Subject: [PATCH 1165/1227] Check only if skip_timelines_check is filled

---
 .../traypublisher/plugins/publish/validate_frame_ranges.py   | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
index 6d48e8352c..65b6128cbe 100644
--- a/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
+++ b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
@@ -31,8 +31,9 @@ class ValidateFrameRange(OptionalPyblishPluginMixin,
         if not self.is_active(instance.data):
             return
 
-        if any(re.search(pattern, instance.data["task"])
-               for pattern in self.skip_timelines_check):
+        if (self.skip_timelines_check and
+            any(re.search(pattern, instance.data["task"])
+                for pattern in self.skip_timelines_check)):
             self.log.info("Skipping for {} task".format(instance.data["task"]))
 
         asset_doc = instance.data["assetEntity"]

From e21338424ed92c4b59422f487de6de501d756c3c Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 18 Jul 2022 11:02:50 +0200
Subject: [PATCH 1166/1227] Hound

---
 .../traypublisher/plugins/publish/validate_frame_ranges.py     | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
index 65b6128cbe..947624100a 100644
--- a/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
+++ b/openpype/hosts/traypublisher/plugins/publish/validate_frame_ranges.py
@@ -3,7 +3,6 @@ import re
 import pyblish.api
 
 import openpype.api
-from openpype import lib
 from openpype.pipeline import (
     PublishXmlValidationError,
     OptionalPyblishPluginMixin
@@ -48,7 +47,7 @@ class ValidateFrameRange(OptionalPyblishPluginMixin,
         if not repres:
             self.log.info("No representations, skipping.")
             return
-            
+
         first_repre = repres[0]
         ext = first_repre['ext'].replace(".", '')
 

From 4f6646d6c7b712e8ad6678a410da41772642e868 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 18 Jul 2022 11:11:08 +0200
Subject: [PATCH 1167/1227] Update
 openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../hosts/traypublisher/plugins/publish/collect_mov_batch.py    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
index 99065d2408..d24659aa8b 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
@@ -19,7 +19,7 @@ class CollectMovBatch(
     hosts = ["traypublisher"]
 
     def process(self, instance):
-        if not instance.data.get("creator_identifier") == "render_mov_batch":
+        if instance.data.get("creator_identifier") != "render_mov_batch":
             return
 
         creator_attributes = instance.data["creator_attributes"]

From 9ef9c79e8fb7cf6e2a783abe3eba1ba13f1eaa6d Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Mon, 18 Jul 2022 11:34:30 +0200
Subject: [PATCH 1168/1227] move all hosts and families to the new integrator

---
 .../defaults/project_settings/global.json     | 83 ++++---------------
 .../schemas/schema_global_publish.json        |  4 +-
 2 files changed, 18 insertions(+), 69 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index 545c792d47..d923fc65c9 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -172,74 +172,8 @@
         },
         "IntegrateAssetNew": {
             "hosts": [
-                "aftereffects",
-                "blender",
-                "celaction",
-                "flame",
-                "fusion",
-                "harmony",
-                "hiero",
-                "houdini",
-                "nuke",
-                "photoshop",
-                "resolve",
-                "tvpaint",
-                "unreal",
-                "standalonepublisher",
-                "webpublisher"
             ],
             "families": [
-                "workfile",
-                "pointcache",
-                "camera",
-                "animation",
-                "model",
-                "mayaAscii",
-                "mayaScene",
-                "setdress",
-                "layout",
-                "ass",
-                "vdbcache",
-                "scene",
-                "vrayproxy",
-                "vrayscene_layer",
-                "render",
-                "prerender",
-                "imagesequence",
-                "review",
-                "rendersetup",
-                "rig",
-                "plate",
-                "look",
-                "audio",
-                "yetiRig",
-                "yeticache",
-                "nukenodes",
-                "gizmo",
-                "source",
-                "matchmove",
-                "image",
-                "assembly",
-                "fbx",
-                "textures",
-                "action",
-                "harmony.template",
-                "harmony.palette",
-                "editorial",
-                "background",
-                "camerarig",
-                "redshiftproxy",
-                "effect",
-                "xgen",
-                "hda",
-                "usd",
-                "staticMesh",
-                "skeletalMesh",
-                "mvLook",
-                "mvUsd",
-                "mvUsdComposition",
-                "mvUsdOverride",
-                "simpleUnrealTexture"
             ],
             "template_name_profiles": [
                 {
@@ -287,7 +221,22 @@
         },
         "IntegrateAsset": {
             "hosts": [
-                "maya"
+                "maya",
+                "aftereffects",
+                "blender",
+                "celaction",
+                "flame",
+                "fusion",
+                "harmony",
+                "hiero",
+                "houdini",
+                "nuke",
+                "photoshop",
+                "resolve",
+                "tvpaint",
+                "unreal",
+                "standalonepublisher",
+                "webpublisher"
             ],
             "families": [
                 "workfile",
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
index 71eed2e2de..5e3978a2df 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
@@ -584,7 +584,7 @@
             "type": "dict",
             "collapsible": true,
             "key": "IntegrateAssetNew",
-            "label": "IntegrateAssetNew",
+            "label": "IntegrateAsset (Legacy)",
             "is_group": true,
             "children": [
                 {
@@ -651,7 +651,7 @@
             "type": "dict",
             "collapsible": true,
             "key": "IntegrateAsset",
-            "label": "IntegrateAsset",
+            "label": "Integrate Asset",
             "is_group": true,
             "children": [
                 {

From 7646c54da87fe04570ba67027bbf5af308cc7b83 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Mon, 18 Jul 2022 11:36:09 +0200
Subject: [PATCH 1169/1227] move subset group collecting to early integrator

---
 ...{collect_subset_group.py => integrate_subset_group.py} | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)
 rename openpype/plugins/publish/{collect_subset_group.py => integrate_subset_group.py} (94%)

diff --git a/openpype/plugins/publish/collect_subset_group.py b/openpype/plugins/publish/integrate_subset_group.py
similarity index 94%
rename from openpype/plugins/publish/collect_subset_group.py
rename to openpype/plugins/publish/integrate_subset_group.py
index 56cd7de94e..4b566e8908 100644
--- a/openpype/plugins/publish/collect_subset_group.py
+++ b/openpype/plugins/publish/integrate_subset_group.py
@@ -17,12 +17,12 @@ from openpype.lib import (
 )
 
 
-class CollectSubsetGroup(pyblish.api.InstancePlugin):
-    """Collect Subset Group for publish."""
+class IntegrateSubsetGroup(pyblish.api.InstancePlugin):
+    """Integrate Subset Group for publish."""
 
     # Run after CollectAnatomyInstanceData
-    order = pyblish.api.CollectorOrder + 0.495
-    label = "Collect Subset Group"
+    order = pyblish.api.IntegratorOrder - 0.1
+    label = "Subset Group"
 
     # Attributes set by settings
     subset_grouping_profiles = None

From 0c59f1539872981ff896119ef7bb729c4c08064d Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Mon, 18 Jul 2022 11:38:28 +0200
Subject: [PATCH 1170/1227] rename old integrator to integrate legacy

---
 .../plugins/publish/{integrate_new.py => integrate_legacy.py}     | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename openpype/plugins/publish/{integrate_new.py => integrate_legacy.py} (100%)

diff --git a/openpype/plugins/publish/integrate_new.py b/openpype/plugins/publish/integrate_legacy.py
similarity index 100%
rename from openpype/plugins/publish/integrate_new.py
rename to openpype/plugins/publish/integrate_legacy.py

From ca2f554a1c4b167d444bbdde1c962f4f9bd7198d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 18 Jul 2022 17:27:49 +0200
Subject: [PATCH 1171/1227] escape html chars from label in widgets

---
 openpype/tools/publisher/publish_report_viewer/model.py | 4 +++-
 openpype/tools/publisher/widgets/card_view_widgets.py   | 3 ++-
 openpype/tools/publisher/widgets/list_view_widgets.py   | 7 +++++--
 3 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/openpype/tools/publisher/publish_report_viewer/model.py b/openpype/tools/publisher/publish_report_viewer/model.py
index a88129a358..bd03376c55 100644
--- a/openpype/tools/publisher/publish_report_viewer/model.py
+++ b/openpype/tools/publisher/publish_report_viewer/model.py
@@ -1,4 +1,5 @@
 import uuid
+import html
 from Qt import QtCore, QtGui
 
 import pyblish.api
@@ -45,7 +46,8 @@ class InstancesModel(QtGui.QStandardItemModel):
             all_removed = True
             for instance_item in instance_items:
                 item = QtGui.QStandardItem(instance_item.label)
-                item.setData(instance_item.label, ITEM_LABEL_ROLE)
+                instance_label = html.escape(instance_item.label)
+                item.setData(instance_label, ITEM_LABEL_ROLE)
                 item.setData(instance_item.errored, ITEM_ERRORED_ROLE)
                 item.setData(instance_item.id, ITEM_ID_ROLE)
                 item.setData(instance_item.removed, INSTANCE_REMOVED_ROLE)
diff --git a/openpype/tools/publisher/widgets/card_view_widgets.py b/openpype/tools/publisher/widgets/card_view_widgets.py
index b6fcee7edb..5a6878ddca 100644
--- a/openpype/tools/publisher/widgets/card_view_widgets.py
+++ b/openpype/tools/publisher/widgets/card_view_widgets.py
@@ -22,6 +22,7 @@ Only one item can be selected at a time.
 
 import re
 import collections
+import html
 
 from Qt import QtWidgets, QtCore
 
@@ -303,7 +304,7 @@ class InstanceCardWidget(CardWidget):
         self._last_variant = variant
         self._last_subset_name = subset_name
         # Make `variant` bold
-        label = self.instance.label
+        label = html.escape(self.instance.label)
         found_parts = set(re.findall(variant, label, re.IGNORECASE))
         if found_parts:
             for part in found_parts:
diff --git a/openpype/tools/publisher/widgets/list_view_widgets.py b/openpype/tools/publisher/widgets/list_view_widgets.py
index 3476ee487e..3e4fd5b72d 100644
--- a/openpype/tools/publisher/widgets/list_view_widgets.py
+++ b/openpype/tools/publisher/widgets/list_view_widgets.py
@@ -23,6 +23,7 @@ selection can be enabled disabled using checkbox or keyboard key presses:
 ```
 """
 import collections
+import html
 
 from Qt import QtWidgets, QtCore, QtGui
 
@@ -113,7 +114,9 @@ class InstanceListItemWidget(QtWidgets.QWidget):
 
         self.instance = instance
 
-        subset_name_label = QtWidgets.QLabel(instance.label, self)
+        instance_label = html.escape(instance.label)
+
+        subset_name_label = QtWidgets.QLabel(instance_label, self)
         subset_name_label.setObjectName("ListViewSubsetName")
 
         active_checkbox = NiceCheckbox(parent=self)
@@ -178,7 +181,7 @@ class InstanceListItemWidget(QtWidgets.QWidget):
         # Check subset name
         label = self.instance.label
         if label != self._instance_label_widget.text():
-            self._instance_label_widget.setText(label)
+            self._instance_label_widget.setText(html.escape(label))
         # Check active state
         self.set_active(self.instance["active"])
         # Check valid states

From ddf07d790886a54e21eb3af0358102bbfc693643 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 18 Jul 2022 17:30:02 +0200
Subject: [PATCH 1172/1227] handle cases when task is not set and subset name
 requires it

---
 .../plugins/create/create_mov_batch.py        | 37 ++++++++++++++-----
 1 file changed, 28 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
index 67f8848e05..840b0647f9 100644
--- a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
@@ -4,7 +4,12 @@ import re
 
 from openpype.client import get_assets, get_asset_by_name
 from openpype.hosts.traypublisher.api import pipeline
-from openpype.lib import FileDef, BoolDef, get_subset_name_with_asset_doc
+from openpype.lib import (
+    FileDef,
+    BoolDef,
+    get_subset_name_with_asset_doc,
+    TaskNotSetError,
+)
 from openpype.pipeline import (
     CreatedInstance,
     CreatorError
@@ -124,13 +129,27 @@ class BatchMovCreator(TrayPublishCreator):
         """Create subset name according to standard template process"""
         task_name = self._get_task_name(asset_doc)
 
-        subset_name = get_subset_name_with_asset_doc(
-            self.family,
-            variant,
-            task_name,
-            asset_doc,
-            project_name
-        )
+        try:
+            subset_name = get_subset_name_with_asset_doc(
+                self.family,
+                variant,
+                task_name,
+                asset_doc,
+                project_name
+            )
+        except TaskNotSetError:
+            # Create instance with fake task
+            # - instance will be marked as invalid so it can't be published
+            #   but user have ability to change it
+            # NOTE: This expect that there is not task 'Undefined' on asset
+            task_name = "Undefined"
+            subset_name = get_subset_name_with_asset_doc(
+                self.family,
+                variant,
+                task_name,
+                asset_doc,
+                project_name
+            )
 
         return subset_name, task_name
 
@@ -178,7 +197,7 @@ class BatchMovCreator(TrayPublishCreator):
 
     def get_detail_description(self):
         return """# Publish batch of .mov to multiple assets.
-        
+
         File names must then contain only asset name, or asset name + version.
         (eg. 'chair.mov', 'chair_v001.mov', not really safe `my_chair_v001.mov`
         """

From 84781c12e570b085f533421c5c8ef0712f611504 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 18 Jul 2022 18:12:04 +0200
Subject: [PATCH 1173/1227] call 'bulk_write' directly on legacy_io

---
 openpype/plugins/publish/integrate.py | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 5e86eb014a..790f96d419 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -79,12 +79,6 @@ def get_first_frame_padded(collection):
     return get_frame_padded(start_frame, padding=collection.padding)
 
 
-def bulk_write(writes):
-    """Convenience function to bulk write into active project database"""
-    project = legacy_io.Session["AVALON_PROJECT"]
-    return legacy_io._database[project].bulk_write(writes)
-
-
 class IntegrateAsset(pyblish.api.InstancePlugin):
     """Register publish in the database and transfer files to destinations.
 
@@ -288,7 +282,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
         # Transaction to reduce the chances of another publish trying to
         # publish to the same version number since that chance can greatly
         # increase if the file transaction takes a long time.
-        bulk_write(subset_writes + version_writes)
+        legacy_io.bulk_write(subset_writes + version_writes)
         self.log.info("Subset {subset[name]} and Version {version[name]} "
                       "written to database..".format(subset=subset,
                                                      version=version))
@@ -362,7 +356,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
                 ))
 
         # Write representations to the database
-        bulk_write(representation_writes)
+        legacy_io.bulk_write(representation_writes)
 
         # Backwards compatibility
         # todo: can we avoid the need to store this?

From 842cf06bf95458537d22eae3031bb7c64586e308 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 18 Jul 2022 18:13:33 +0200
Subject: [PATCH 1174/1227] new integrator can tell legacy one that should not
 process the instance

---
 openpype/plugins/publish/integrate.py        | 2 +-
 openpype/plugins/publish/integrate_legacy.py | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 790f96d419..71032a1d96 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -171,7 +171,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
     template_name_profiles = None
 
     def process(self, instance):
-
+        instance.data["processedWithNewIntegrator"] = True
         # Exclude instances that also contain families from exclude families
         families = set(get_instance_families(instance))
         exclude = families & set(self.exclude_families)
diff --git a/openpype/plugins/publish/integrate_legacy.py b/openpype/plugins/publish/integrate_legacy.py
index 797479af45..18e4035602 100644
--- a/openpype/plugins/publish/integrate_legacy.py
+++ b/openpype/plugins/publish/integrate_legacy.py
@@ -145,6 +145,10 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     subset_grouping_profiles = None
 
     def process(self, instance):
+        if instance.data.get("processedWithNewIntegrator"):
+            self.log.info("Instance was already processed with new integrator")
+            return
+
         for ef in self.exclude_families:
             if (
                     instance.data["family"] == ef or

From a1784fc25e2b433e1f32e35a36588205b9904e98 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 18 Jul 2022 18:26:27 +0200
Subject: [PATCH 1175/1227] representations are checked before instance
 registration begins

---
 openpype/plugins/publish/integrate.py | 80 +++++++++++++++++----------
 1 file changed, 50 insertions(+), 30 deletions(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 71032a1d96..97f99bdba7 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -14,6 +14,7 @@ from openpype.modules import ModulesManager
 from openpype.lib.profiles_filtering import filter_profiles
 from openpype.lib.file_transaction import FileTransaction
 from openpype.pipeline import legacy_io
+from openpype.pipeline.publish import KnownPublishError
 
 log = logging.getLogger(__name__)
 
@@ -172,6 +173,17 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
 
     def process(self, instance):
         instance.data["processedWithNewIntegrator"] = True
+
+        filtered_repres = self.filter_representations(instance)
+        # Skip instance if there are not representations to integrate
+        #   all representations should not be integrated
+        if not filtered_repres:
+            self.log.warning((
+                "Skipping, there are no representations"
+                " to integrate for instance {}"
+            ).format(instance.data["family"]))
+            return
+
         # Exclude instances that also contain families from exclude families
         families = set(get_instance_families(instance))
         exclude = families & set(self.exclude_families)
@@ -182,7 +194,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
 
         file_transactions = FileTransaction(log=self.log)
         try:
-            self.register(instance, file_transactions)
+            self.register(instance, file_transactions, filtered_repres)
         except Exception:
             # clean destination
             # todo: preferably we'd also rollback *any* changes to the database
@@ -194,8 +206,35 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
         # the try, except.
         file_transactions.finalize()
 
-    def register(self, instance, file_transactions):
+    def filter_representations(self, instance):
+        # Prepare repsentations that should be integrated
+        repres = instance.data.get("representations")
+        # Raise error if instance don't have any representations
+        if not repres:
+            raise KnownPublishError(
+                "Instance {} has no representations to integrate".format(
+                    instance.data["family"]
+                )
+            )
 
+        # Validate type of stored representations
+        if not isinstance(repres, (list, tuple)):
+            raise TypeError(
+                "Instance 'files' must be a list, got: {0} {1}".format(
+                    str(type(repres)), str(repres)
+                )
+            )
+
+        # Filter representations
+        filtered_repres = []
+        for repre in repres:
+            if "delete" in repre.get("tags", []):
+                continue
+            filtered_repres.append(repre)
+
+        return filtered_repres
+
+    def register(self, instance, file_transactions, filtered_repres):
         instance_stagingdir = instance.data.get("stagingDir")
         if not instance_stagingdir:
             self.log.info((
@@ -209,15 +248,6 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
                 "@ {0}".format(instance_stagingdir)
             )
 
-        # Ensure at least one representation is set up for registering.
-        repres = instance.data.get("representations")
-        assert repres, "Instance has no representations data"
-        assert isinstance(repres, (list, tuple)), (
-            "Instance 'representations' must be a list, got: {0} {1}".format(
-                str(type(repres)), str(repres)
-            )
-        )
-
         template_name = self.get_template_name(instance)
 
         subset, subset_writes = self.prepare_subset(instance)
@@ -238,20 +268,15 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
 
         # Prepare all representations
         prepared_representations = []
-        for repre in instance.data["representations"]:
-
-            if "delete" in repre.get("tags", []):
-                self.log.debug("Skipping representation marked for deletion: "
-                               "{}".format(repre))
-                continue
-
+        for repre in filtered_repres:
             # todo: reduce/simplify what is returned from this function
-            prepared = self.prepare_representation(repre,
-                                                   template_name,
-                                                   existing_repres_by_name,
-                                                   version,
-                                                   instance_stagingdir,
-                                                   instance)
+            prepared = self.prepare_representation(
+                repre,
+                template_name,
+                existing_repres_by_name,
+                version,
+                instance_stagingdir,
+                instance)
 
             for src, dst in prepared["transfers"]:
                 # todo: add support for hardlink transfers
@@ -259,12 +284,6 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
 
             prepared_representations.append(prepared)
 
-        if not prepared_representations:
-            # Even though we check `instance.data["representations"]` earlier
-            # this could still happen if all representations were tagged with
-            # "delete" and thus are skipped for integration
-            raise RuntimeError("No representations prepared to publish.")
-
         # Each instance can also have pre-defined transfers not explicitly
         # part of a representation - like texture resources used by a
         # .ma representation. Those destination paths are pre-defined, etc.
@@ -273,6 +292,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
         for src, dst in instance.data.get("transfers", []):
             file_transactions.add(src, dst, mode=FileTransaction.MODE_COPY)
             resource_destinations.add(os.path.abspath(dst))
+
         for src, dst in instance.data.get("hardlinks", []):
             file_transactions.add(src, dst, mode=FileTransaction.MODE_HARDLINK)
             resource_destinations.add(os.path.abspath(dst))

From 7016ca41f7809a1d3729e4999ddf4c1c0dfe1299 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 18 Jul 2022 18:27:37 +0200
Subject: [PATCH 1176/1227] use already prepared modules from context

---
 openpype/plugins/publish/integrate.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 97f99bdba7..8fe5138963 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -317,8 +317,8 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
         self.log.debug("Retrieving Representation Site Sync information ...")
 
         # Get the accessible sites for Site Sync
-        manager = ModulesManager()
-        sync_server_module = manager.modules_by_name["sync_server"]
+        modules_by_name = instance.context.data["openPypeModules"]
+        sync_server_module = modules_by_name["sync_server"]
         sites = sync_server_module.compute_resource_sync_sites(
             project_name=instance.data["projectEntity"]["name"]
         )

From d04abc3767f7c5990c6e0a8a420229bc034075f0 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 18 Jul 2022 18:27:54 +0200
Subject: [PATCH 1177/1227] use host name from context data

---
 openpype/plugins/publish/integrate.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 8fe5138963..e76adb55b8 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -310,10 +310,10 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
         # Process all file transfers of all integrations now
         self.log.debug("Integrating source files to destination ...")
         file_transactions.process()
-        self.log.debug("Backed up existing files: "
-                       "{}".format(file_transactions.backups))
-        self.log.debug("Transferred files: "
-                       "{}".format(file_transactions.transferred))
+        self.log.debug(
+            "Backed up existing files: {}".format(file_transactions.backups))
+        self.log.debug(
+            "Transferred files: {}".format(file_transactions.transferred))
         self.log.debug("Retrieving Representation Site Sync information ...")
 
         # Get the accessible sites for Site Sync
@@ -780,8 +780,8 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
         return {
             "families": anatomy_data["family"],
             "tasks": task.get("name"),
-            "hosts": anatomy_data["app"],
-            "task_types": task.get("type")
+            "task_types": task.get("type"),
+            "hosts": instance.context["hostName"],
         }
 
     def get_rootless_path(self, anatomy, path):

From 79c01bdf1a83f4b5d4b57ce0afcc237f696a6387 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 18 Jul 2022 18:28:29 +0200
Subject: [PATCH 1178/1227] skip instances marked to be integrated on farm

---
 openpype/plugins/publish/integrate.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index e76adb55b8..e3a81091ba 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -172,8 +172,15 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
     template_name_profiles = None
 
     def process(self, instance):
+        # Mark instance as processed for legacy integrator
         instance.data["processedWithNewIntegrator"] = True
 
+        # Instance should be integrated on a farm
+        if instance.data.get("farm"):
+            self.log.info(
+                "Instance is marked to be processed on farm. Skipping")
+            return
+
         filtered_repres = self.filter_representations(instance)
         # Skip instance if there are not representations to integrate
         #   all representations should not be integrated

From f398fae425d66c1b9934e9ec016fa1634761f633 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 19 Jul 2022 09:48:22 +0200
Subject: [PATCH 1179/1227] simplified settings for skipping of families

---
 .../defaults/project_settings/global.json     | 119 +-----------------
 .../schemas/schema_global_publish.json        |  60 +--------
 2 files changed, 7 insertions(+), 172 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index d923fc65c9..bdcf85d1b2 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -171,10 +171,6 @@
             ]
         },
         "IntegrateAssetNew": {
-            "hosts": [
-            ],
-            "families": [
-            ],
             "template_name_profiles": [
                 {
                     "families": [],
@@ -220,120 +216,7 @@
             ]
         },
         "IntegrateAsset": {
-            "hosts": [
-                "maya",
-                "aftereffects",
-                "blender",
-                "celaction",
-                "flame",
-                "fusion",
-                "harmony",
-                "hiero",
-                "houdini",
-                "nuke",
-                "photoshop",
-                "resolve",
-                "tvpaint",
-                "unreal",
-                "standalonepublisher",
-                "webpublisher"
-            ],
-            "families": [
-                "workfile",
-                "pointcache",
-                "camera",
-                "animation",
-                "model",
-                "mayaAscii",
-                "mayaScene",
-                "setdress",
-                "layout",
-                "ass",
-                "vdbcache",
-                "scene",
-                "vrayproxy",
-                "vrayscene_layer",
-                "render",
-                "prerender",
-                "imagesequence",
-                "review",
-                "rendersetup",
-                "rig",
-                "plate",
-                "look",
-                "audio",
-                "yetiRig",
-                "yeticache",
-                "nukenodes",
-                "gizmo",
-                "source",
-                "matchmove",
-                "image",
-                "assembly",
-                "fbx",
-                "textures",
-                "action",
-                "harmony.template",
-                "harmony.palette",
-                "editorial",
-                "background",
-                "camerarig",
-                "redshiftproxy",
-                "effect",
-                "xgen",
-                "hda",
-                "usd",
-                "staticMesh",
-                "skeletalMesh",
-                "mvLook",
-                "mvUsd",
-                "mvUsdComposition",
-                "mvUsdOverride",
-                "simpleUnrealTexture"
-            ],
-            "template_name_profiles": [
-                {
-                    "families": [],
-                    "hosts": [],
-                    "task_types": [],
-                    "tasks": [],
-                    "template_name": "publish"
-                },
-                {
-                    "families": [
-                        "review",
-                        "render",
-                        "prerender"
-                    ],
-                    "hosts": [],
-                    "task_types": [],
-                    "tasks": [],
-                    "template_name": "render"
-                },
-                {
-                    "families": [
-                        "simpleUnrealTexture"
-                    ],
-                    "hosts": [
-                        "standalonepublisher"
-                    ],
-                    "task_types": [],
-                    "tasks": [],
-                    "template_name": "simpleUnrealTexture"
-                },
-                {
-                    "families": [
-                        "staticMesh",
-                        "skeletalMesh"
-                    ],
-                    "hosts": [
-                        "maya"
-                    ],
-                    "task_types": [],
-                    "tasks": [],
-                    "template_name": "maya2unreal"
-                }
-            ]
+            "skip_host_families": []
         },
         "IntegrateHeroVersion": {
             "enabled": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
index 5e3978a2df..41eb04be4e 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
@@ -587,18 +587,6 @@
             "label": "IntegrateAsset (Legacy)",
             "is_group": true,
             "children": [
-                {
-                    "type": "list",
-                    "key": "hosts",
-                    "label": "Hosts",
-                    "object_type": "text"
-                },
-                {
-                    "key": "families",
-                    "label": "Families",
-                    "type": "list",
-                    "object_type": "text"
-                },
                 {
                     "type": "list",
                     "key": "template_name_profiles",
@@ -656,58 +644,22 @@
             "children": [
                 {
                     "type": "list",
-                    "key": "hosts",
-                    "label": "Hosts",
-                    "object_type": "text"
-                },
-                {
-                    "key": "families",
-                    "label": "Families",
-                    "type": "list",
-                    "object_type": "text"
-                },
-                {
-                    "type": "list",
-                    "key": "template_name_profiles",
-                    "label": "Template name profiles",
+                    "key": "skip_host_families",
+                    "label": "Skip hosts and families",
                     "use_label_wrap": true,
                     "object_type": {
                         "type": "dict",
                         "children": [
                             {
-                                "type": "label",
-                                "label": ""
+                                "type": "hosts-enum",
+                                "key": "host",
+                                "label": "Host"
                             },
                             {
+                                "type": "list",
                                 "key": "families",
                                 "label": "Families",
-                                "type": "list",
                                 "object_type": "text"
-                            },
-                            {
-                                "type": "hosts-enum",
-                                "key": "hosts",
-                                "label": "Hosts",
-                                "multiselection": true
-                            },
-                            {
-                                "key": "task_types",
-                                "label": "Task types",
-                                "type": "task-types-enum"
-                            },
-                            {
-                                "key": "tasks",
-                                "label": "Task names",
-                                "type": "list",
-                                "object_type": "text"
-                            },
-                            {
-                                "type": "separator"
-                            },
-                            {
-                                "type": "text",
-                                "key": "template_name",
-                                "label": "Template name"
                             }
                         ]
                     }

From 1a024d3552723245c273362793ecee6b99f29823 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 19 Jul 2022 09:56:52 +0200
Subject: [PATCH 1180/1227] use settings to decide if new integrator should
 skip instances

---
 openpype/plugins/publish/integrate.py | 37 +++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index e3a81091ba..0b725750aa 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -167,11 +167,15 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
         "project", "asset", "task", "subset", "version", "representation",
         "family", "hierarchy", "username"
     ]
+    skip_host_families = []
 
     # Attributes set by settings
     template_name_profiles = None
 
     def process(self, instance):
+        if self._temp_skip_instance_by_settings(instance):
+            return
+
         # Mark instance as processed for legacy integrator
         instance.data["processedWithNewIntegrator"] = True
 
@@ -213,6 +217,39 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
         # the try, except.
         file_transactions.finalize()
 
+    def _temp_skip_instance_by_settings(self, instance):
+        """Decide if instance will be processed with new or legacy integrator.
+
+        This is temporary solution until we test all usecases with new (this)
+        integrator plugin.
+        """
+
+        host_name = instance.context.data["hostName"]
+        instance_family = instance.data["family"]
+        instance_families = set(instance.data.get("families") or [])
+
+        skip = False
+        for item in self.skip_host_families:
+            if item["host"] != host_name:
+                continue
+
+            families = set(item["families"])
+            if instance_family in families:
+                skip = True
+                break
+
+            for family in instance_families:
+                if family in families:
+                    skip = True
+                    break
+
+            if skip:
+                break
+
+        if skip:
+            self.log.debug("Instance is marked to be skipped by settings.")
+        return skip
+
     def filter_representations(self, instance):
         # Prepare repsentations that should be integrated
         repres = instance.data.get("representations")

From 0ebd4b7c9afffa3174ae876f94ca22fa52f83627 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 19 Jul 2022 09:57:00 +0200
Subject: [PATCH 1181/1227] added remaining hosts to integrator hosts

---
 openpype/plugins/publish/integrate.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 0b725750aa..3c61d01858 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -105,7 +105,10 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
 
     label = "Integrate Asset"
     order = pyblish.api.IntegratorOrder
-    hosts = ["maya"]
+    hosts = ["aftereffects", "blender", "celaction", "flame", "harmony",
+             "hiero", "houdini", "nuke", "photoshop", "resolve",
+             "standalonepublisher", "traypublisher", "tvpaint", "unreal",
+             "webpublisher"]
     families = ["workfile",
                 "pointcache",
                 "camera",

From 6c457b2ed1331bb193a572803670836b40f16667 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 19 Jul 2022 10:10:22 +0200
Subject: [PATCH 1182/1227] use settings for publish templates from legacy
 integrator

---
 openpype/plugins/publish/integrate.py | 33 ++++++++++++++++++++-------
 1 file changed, 25 insertions(+), 8 deletions(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 3c61d01858..1b8015c946 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -172,9 +172,6 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
     ]
     skip_host_families = []
 
-    # Attributes set by settings
-    template_name_profiles = None
-
     def process(self, instance):
         if self._temp_skip_instance_by_settings(instance):
             return
@@ -807,13 +804,33 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
         """Return anatomy template name to use for integration"""
         # Define publish template name from profiles
         filter_criteria = self.get_profile_filter_criteria(instance)
-        profile = filter_profiles(self.template_name_profiles,
-                                  filter_criteria,
-                                  logger=self.log)
+        template_name_profiles = self._get_template_name_profiles(instance)
+        profile = filter_profiles(
+            template_name_profiles,
+            filter_criteria,
+            logger=self.log
+        )
+
         if profile:
             return profile["template_name"]
-        else:
-            return self.default_template_name
+        return self.default_template_name
+
+    def _get_template_name_profiles(self, instance):
+        """Receive profiles for publish template keys.
+
+        Reuse template name profiles from legacy integrator. Goal is to move
+        the profile settings out of plugin settings but until that happens we
+        want to be able set it at one place and don't break backwards
+        compatibility (more then once).
+        """
+
+        return (
+            instance.context["project_settings"]
+            ["global"]
+            ["publish"]
+            ["IntegrateAssetNew"]
+            ["template_name_profiles"]
+        )
 
     def get_profile_filter_criteria(self, instance):
         """Return filter criteria for `filter_profiles`"""

From 30db574170a526759ac6c40c574aac0ed41bcdea Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 19 Jul 2022 10:18:41 +0200
Subject: [PATCH 1183/1227] fixed data access

---
 openpype/plugins/publish/integrate.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 1b8015c946..c9eb26d0b7 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -825,7 +825,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
         """
 
         return (
-            instance.context["project_settings"]
+            instance.context.data["project_settings"]
             ["global"]
             ["publish"]
             ["IntegrateAssetNew"]
@@ -845,7 +845,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
             "families": anatomy_data["family"],
             "tasks": task.get("name"),
             "task_types": task.get("type"),
-            "hosts": instance.context["hostName"],
+            "hosts": instance.context.data["hostName"],
         }
 
     def get_rootless_path(self, anatomy, path):

From 3c35cbc700102270c55adfa8b249ad9f75ebd226 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 19 Jul 2022 10:23:13 +0200
Subject: [PATCH 1184/1227] make sure legacy integrator happens after new
 integrator

---
 openpype/plugins/publish/integrate.py        | 1 -
 openpype/plugins/publish/integrate_legacy.py | 3 ++-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index c9eb26d0b7..cfaff4067b 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -10,7 +10,6 @@ from pymongo import DeleteMany, ReplaceOne, InsertOne, UpdateOne
 import pyblish.api
 
 import openpype.api
-from openpype.modules import ModulesManager
 from openpype.lib.profiles_filtering import filter_profiles
 from openpype.lib.file_transaction import FileTransaction
 from openpype.pipeline import legacy_io
diff --git a/openpype/plugins/publish/integrate_legacy.py b/openpype/plugins/publish/integrate_legacy.py
index 18e4035602..34e81a3839 100644
--- a/openpype/plugins/publish/integrate_legacy.py
+++ b/openpype/plugins/publish/integrate_legacy.py
@@ -70,7 +70,8 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     """
 
     label = "Integrate Asset (legacy)"
-    order = pyblish.api.IntegratorOrder
+    # Make sure it happens after new integrator
+    order = pyblish.api.IntegratorOrder + 0.00001
     hosts = ["aftereffects", "blender", "celaction", "flame", "harmony",
              "hiero", "houdini", "nuke", "photoshop", "resolve",
              "standalonepublisher", "traypublisher", "tvpaint", "unreal",

From dc569c6d65e2a211681a4f0d17aea1874cef9268 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 19 Jul 2022 10:30:31 +0200
Subject: [PATCH 1185/1227] rename and move CollectSubsetGroup to
 IntegrateSubsetGroup in settings

---
 .../defaults/project_settings/global.json     |  22 ++--
 .../schemas/schema_global_publish.json        | 110 +++++++++---------
 2 files changed, 66 insertions(+), 66 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index bdcf85d1b2..9247c6ceb6 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -20,17 +20,6 @@
             ],
             "skip_hosts_headless_publish": []
         },
-        "CollectSubsetGroup": {
-            "subset_grouping_profiles": [
-                {
-                    "families": [],
-                    "hosts": [],
-                    "task_types": [],
-                    "tasks": [],
-                    "template": ""
-                }
-            ]
-        },
         "ValidateEditorialAssetName": {
             "enabled": true,
             "optional": false
@@ -170,6 +159,17 @@
                 }
             ]
         },
+        "IntegrateSubsetGroup": {
+            "subset_grouping_profiles": [
+                {
+                    "families": [],
+                    "hosts": [],
+                    "task_types": [],
+                    "tasks": [],
+                    "template": ""
+                }
+            ]
+        },
         "IntegrateAssetNew": {
             "template_name_profiles": [
                 {
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
index 41eb04be4e..af08bbec3c 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
@@ -39,61 +39,6 @@
                 }
             ]
         },
-        {
-            "type": "dict",
-            "collapsible": true,
-            "key": "CollectSubsetGroup",
-            "label": "Collect Subset Group",
-            "is_group": true,
-            "children": [
-                {
-                    "type": "list",
-                    "key": "subset_grouping_profiles",
-                    "label": "Subset grouping profiles",
-                    "use_label_wrap": true,
-                    "object_type": {
-                        "type": "dict",
-                        "children": [
-                            {
-                                "type": "label",
-                                "label": "Set all published instances as a part of specific group named according to 'Template'. <br>Implemented all variants of placeholders [{task},{family},{host},{subset},{renderlayer}]"
-                            },
-                            {
-                                "key": "families",
-                                "label": "Families",
-                                "type": "list",
-                                "object_type": "text"
-                            },
-                            {
-                                "type": "hosts-enum",
-                                "key": "hosts",
-                                "label": "Hosts",
-                                "multiselection": true
-                            },
-                            {
-                                "key": "task_types",
-                                "label": "Task types",
-                                "type": "task-types-enum"
-                            },
-                            {
-                                "key": "tasks",
-                                "label": "Task names",
-                                "type": "list",
-                                "object_type": "text"
-                            },
-                            {
-                                "type": "separator"
-                            },
-                            {
-                                "type": "text",
-                                "key": "template",
-                                "label": "Template"
-                            }
-                        ]
-                    }
-                }
-            ]
-        },
         {
             "type": "dict",
             "collapsible": true,
@@ -580,6 +525,61 @@
                 }
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "IntegrateSubsetGroup",
+            "label": "Integrate Subset Group",
+            "is_group": true,
+            "children": [
+                {
+                    "type": "list",
+                    "key": "subset_grouping_profiles",
+                    "label": "Subset grouping profiles",
+                    "use_label_wrap": true,
+                    "object_type": {
+                        "type": "dict",
+                        "children": [
+                            {
+                                "type": "label",
+                                "label": "Set all published instances as a part of specific group named according to 'Template'. <br>Implemented all variants of placeholders [{task},{family},{host},{subset},{renderlayer}]"
+                            },
+                            {
+                                "key": "families",
+                                "label": "Families",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "hosts-enum",
+                                "key": "hosts",
+                                "label": "Hosts",
+                                "multiselection": true
+                            },
+                            {
+                                "key": "task_types",
+                                "label": "Task types",
+                                "type": "task-types-enum"
+                            },
+                            {
+                                "key": "tasks",
+                                "label": "Task names",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "separator"
+                            },
+                            {
+                                "type": "text",
+                                "key": "template",
+                                "label": "Template"
+                            }
+                        ]
+                    }
+                }
+            ]
+        },
         {
             "type": "dict",
             "collapsible": true,

From 76c594af9a39f22bbbb00156c09d67bd9d0d2d0b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 19 Jul 2022 10:30:48 +0200
Subject: [PATCH 1186/1227] check for existence of subset group on instance
 before profiling

---
 .../plugins/publish/integrate_subset_group.py | 30 +++++++++++--------
 1 file changed, 17 insertions(+), 13 deletions(-)

diff --git a/openpype/plugins/publish/integrate_subset_group.py b/openpype/plugins/publish/integrate_subset_group.py
index 4b566e8908..910cb060a6 100644
--- a/openpype/plugins/publish/integrate_subset_group.py
+++ b/openpype/plugins/publish/integrate_subset_group.py
@@ -37,18 +37,22 @@ class IntegrateSubsetGroup(pyblish.api.InstancePlugin):
         if not self.subset_grouping_profiles:
             return
 
-        # Skip if there is no matching profile
-        filter_criteria = self.get_profile_filter_criteria(instance)
-        profile = filter_profiles(self.subset_grouping_profiles,
-                                  filter_criteria,
-                                  logger=self.log)
-        if not profile:
-            return
-
         if instance.data.get("subsetGroup"):
             # If subsetGroup is already set then allow that value to remain
-            self.log.debug("Skipping collect subset group due to existing "
-                           "value: {}".format(instance.data["subsetGroup"]))
+            self.log.debug((
+                "Skipping collect subset group due to existing value: {}"
+            ).format(instance.data["subsetGroup"]))
+            return
+
+        # Skip if there is no matching profile
+        filter_criteria = self.get_profile_filter_criteria(instance)
+        profile = filter_profiles(
+            self.subset_grouping_profiles,
+            filter_criteria,
+            logger=self.log
+        )
+
+        if not profile:
             return
 
         template = profile["template"]
@@ -68,9 +72,9 @@ class IntegrateSubsetGroup(pyblish.api.InstancePlugin):
             )
         except (KeyError, TemplateUnsolved):
             keys = fill_pairs.keys()
-            msg = "Subset grouping failed. " \
-                  "Only {} are expected in Settings".format(','.join(keys))
-            self.log.warning(msg)
+            self.log.warning((
+                "Subset grouping failed. Only {} are expected in Settings"
+            ).format(','.join(keys)))
 
         if filled_template:
             instance.data["subsetGroup"] = filled_template

From 508b3e7d8eccb554b5a6ed9f1660d611b780633d Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 19 Jul 2022 10:47:10 +0200
Subject: [PATCH 1187/1227] Update
 openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../hosts/traypublisher/plugins/publish/collect_mov_batch.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
index d24659aa8b..e6f33bc619 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
@@ -32,12 +32,11 @@ class CollectMovBatch(
             "name": ext[1:],
             "ext": ext[1:],
             "files": file_name,
-            "stagingDir": os.path.dirname(file_url)
+            "stagingDir": os.path.dirname(file_url),
+            "tags": []
         }
 
         if creator_attributes["add_review_family"]:
-            if not repre.get("tags"):
-                repre["tags"] = []
             repre["tags"].append("review")
             instance.data["families"].append("review")
 

From fa10d36f589d1961f9dcb425129a0a4a69399b86 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 19 Jul 2022 10:47:43 +0200
Subject: [PATCH 1188/1227] Better creation of instance

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../hosts/traypublisher/plugins/create/create_mov_batch.py   | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
index 840b0647f9..bbabd73415 100644
--- a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
@@ -64,10 +64,7 @@ class BatchMovCreator(TrayPublishCreator):
             # Create new instance
             new_instance = CreatedInstance(self.family, subset_name,
                                            instance_data, self)
-            # Host implementation of storing metadata about instance
-            pipeline.HostContext.add_instance(new_instance.data_to_store())
-            # Add instance to current context
-            self._add_instance_to_context(new_instance)
+            self._store_new_instance(new_instance)
 
     def get_asset_doc_from_file_name(self, source_filename, project_name):
         """Try to parse out asset name from file name provided.

From b4bd2542ff86dea9ce0a480ca6d1524900d6847f Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 19 Jul 2022 10:57:30 +0200
Subject: [PATCH 1189/1227] OP-3446 - renamed from mov to movie

Workflow should handle not only .mov, but .mp4s or any movie format.
---
 ...eate_mov_batch.py => create_movie_batch.py} | 18 +++++++++++-------
 ...ect_mov_batch.py => collect_movie_batch.py} |  4 ++--
 .../project_settings/traypublisher.json        |  2 +-
 .../schema_project_traypublisher.json          |  4 ++--
 4 files changed, 16 insertions(+), 12 deletions(-)
 rename openpype/hosts/traypublisher/plugins/create/{create_mov_batch.py => create_movie_batch.py} (94%)
 rename openpype/hosts/traypublisher/plugins/publish/{collect_mov_batch.py => collect_movie_batch.py} (97%)

diff --git a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py b/openpype/hosts/traypublisher/plugins/create/create_movie_batch.py
similarity index 94%
rename from openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
rename to openpype/hosts/traypublisher/plugins/create/create_movie_batch.py
index bbabd73415..63b9b2ef28 100644
--- a/openpype/hosts/traypublisher/plugins/create/create_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/create/create_movie_batch.py
@@ -18,21 +18,25 @@ from openpype.pipeline import (
 from openpype.hosts.traypublisher.api.plugin import TrayPublishCreator
 
 
-class BatchMovCreator(TrayPublishCreator):
-    """Creates instances from .mov file(s)."""
-    identifier = "render_mov_batch"
-    label = "Batch Mov"
+class BatchMovieCreator(TrayPublishCreator):
+    """Creates instances from movie file(s).
+
+    Intended for .mov files, but should work for any video file.
+    Doesn't handle image sequences though.
+    """
+    identifier = "render_movie_batch"
+    label = "Batch Movies"
     family = "render"
-    description = "Publish batch of movs"
+    description = "Publish batch of video files"
 
     create_allow_context_change = False
     version_regex = re.compile(r"^(.+)_v([0-9]+)$")
 
     def __init__(self, project_settings, *args, **kwargs):
-        super(BatchMovCreator, self).__init__(project_settings,
+        super(BatchMovieCreator, self).__init__(project_settings,
                                               *args, **kwargs)
         creator_settings = (
-            project_settings["traypublisher"]["BatchMovCreator"]
+            project_settings["traypublisher"]["BatchMovieCreator"]
         )
         self.default_variants = creator_settings["default_variants"]
         self.default_tasks = creator_settings["default_tasks"]
diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py b/openpype/hosts/traypublisher/plugins/publish/collect_movie_batch.py
similarity index 97%
rename from openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
rename to openpype/hosts/traypublisher/plugins/publish/collect_movie_batch.py
index e6f33bc619..45ccbd92d4 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_mov_batch.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_movie_batch.py
@@ -4,7 +4,7 @@ import pyblish.api
 from openpype.pipeline import OpenPypePyblishPluginMixin
 
 
-class CollectMovBatch(
+class CollectMovieBatch(
     pyblish.api.InstancePlugin, OpenPypePyblishPluginMixin
 ):
     """Collect file url for batch mov and create representation.
@@ -19,7 +19,7 @@ class CollectMovBatch(
     hosts = ["traypublisher"]
 
     def process(self, instance):
-        if instance.data.get("creator_identifier") != "render_mov_batch":
+        if instance.data.get("creator_identifier") != "render_movie_batch":
             return
 
         creator_attributes = instance.data["creator_attributes"]
diff --git a/openpype/settings/defaults/project_settings/traypublisher.json b/openpype/settings/defaults/project_settings/traypublisher.json
index cbe58f49d6..8bf3e3b306 100644
--- a/openpype/settings/defaults/project_settings/traypublisher.json
+++ b/openpype/settings/defaults/project_settings/traypublisher.json
@@ -236,7 +236,7 @@
             "extensions": []
         }
     ],
-    "BatchMovCreator": {
+    "BatchMovieCreator": {
         "default_variants": ["Main"],
         "default_tasks": ["Compositing"],
         "extensions": [
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
index 50ba246c97..e38aa64e04 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
@@ -87,8 +87,8 @@
          {
             "type": "dict",
             "collapsible": true,
-            "key": "BatchMovCreator",
-            "label": "Batch Mov Creator",
+            "key": "BatchMovieCreator",
+            "label": "Batch Movie Creator",
             "use_label_wrap": true,
             "collapsible_key": true,
             "children": [

From 96be94c0c2b3aa2657bfe832b28904fbaec8ff53 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 19 Jul 2022 11:27:16 +0200
Subject: [PATCH 1190/1227] OP-3446 - added label to Settings

Updated label for collector
---
 .../traypublisher/plugins/publish/collect_movie_batch.py     | 4 ++--
 .../projects_schema/schema_project_traypublisher.json        | 5 ++++-
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_movie_batch.py b/openpype/hosts/traypublisher/plugins/publish/collect_movie_batch.py
index 45ccbd92d4..f37e04d1c9 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_movie_batch.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_movie_batch.py
@@ -7,13 +7,13 @@ from openpype.pipeline import OpenPypePyblishPluginMixin
 class CollectMovieBatch(
     pyblish.api.InstancePlugin, OpenPypePyblishPluginMixin
 ):
-    """Collect file url for batch mov and create representation.
+    """Collect file url for batch movies and create representation.
 
     Adds review on instance and to repre.tags based on value of toggle button
     on creator.
     """
 
-    label = "Collect Mov Batch Files"
+    label = "Collect Movie Batch Files"
     order = pyblish.api.CollectorOrder
 
     hosts = ["traypublisher"]
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
index e38aa64e04..8f0f864dc2 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
@@ -89,9 +89,12 @@
             "collapsible": true,
             "key": "BatchMovieCreator",
             "label": "Batch Movie Creator",
-            "use_label_wrap": true,
             "collapsible_key": true,
             "children": [
+                {
+                    "type": "label",
+                    "label": "Allows to publish multiple video files in one go. <br />Name of matching asset is parsed from file names ('asset.mov', 'asset_v001.mov', 'my_asset_to_publish.mov')"
+                },
                 {
                     "type": "list",
                     "key": "default_variants",

From 505b42ace2a7e07bfff9cb191e0f5f873d6af181 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 19 Jul 2022 11:29:34 +0200
Subject: [PATCH 1191/1227] OP-3446 - Hound

---
 .../hosts/traypublisher/plugins/create/create_movie_batch.py   | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/create/create_movie_batch.py b/openpype/hosts/traypublisher/plugins/create/create_movie_batch.py
index 63b9b2ef28..c5f0d6b75e 100644
--- a/openpype/hosts/traypublisher/plugins/create/create_movie_batch.py
+++ b/openpype/hosts/traypublisher/plugins/create/create_movie_batch.py
@@ -3,7 +3,6 @@ import os
 import re
 
 from openpype.client import get_assets, get_asset_by_name
-from openpype.hosts.traypublisher.api import pipeline
 from openpype.lib import (
     FileDef,
     BoolDef,
@@ -34,7 +33,7 @@ class BatchMovieCreator(TrayPublishCreator):
 
     def __init__(self, project_settings, *args, **kwargs):
         super(BatchMovieCreator, self).__init__(project_settings,
-                                              *args, **kwargs)
+                                                *args, **kwargs)
         creator_settings = (
             project_settings["traypublisher"]["BatchMovieCreator"]
         )

From c59a9cb05f641ccf8ec3638d69b1cf764cee9262 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 19 Jul 2022 14:40:01 +0200
Subject: [PATCH 1192/1227] Fix: shot duplicate name using shot's hierarchy
 (ep, seq)

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 4695a49159..f43bf07e25 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -181,7 +181,7 @@ def update_op_assets(
             # Find root folder docs
             root_folder_docs = get_assets(
                 project_name,
-                asset_name=[entity_parent_folders[-1]],
+                asset_names=[entity_parent_folders[-1]],
                 fields=["_id", "data.root_of"]
             )
             # NOTE: Not sure why it's checking for entity type?
@@ -221,6 +221,14 @@ def update_op_assets(
             parent_entity = parent_doc["data"]["zou"]
             parent_zou_id = parent_entity["parent_id"]
 
+        # Item name
+        if item_type == "Asset":
+            item_name = item_doc["name"]
+        elif item_type == "Shot":  
+            # Name with parents hierarchy "({episode}_){sequence}_{shot}"
+            # to avoid duplicate name issue
+            item_name = "_".join(item_data["parents"] + [item_doc["name"]])
+
         # Set root folders parents
         item_data["parents"] = entity_parent_folders + item_data["parents"]
 
@@ -234,7 +242,7 @@ def update_op_assets(
                     item_doc["_id"],
                     {
                         "$set": {
-                            "name": item["name"],
+                            "name": item_name,
                             "data": item_data,
                             "parent": asset_doc_ids[item["project_id"]]["_id"],
                         }

From 9f41a512cb4ab27884ee2ad0465c23837f8ccad3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 19 Jul 2022 14:44:25 +0200
Subject: [PATCH 1193/1227] black

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index f43bf07e25..9a5dd7db61 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -14,7 +14,7 @@ from openpype.client import (
     get_project,
     get_assets,
     get_asset_by_id,
-    get_asset_by_name
+    get_asset_by_name,
 )
 from openpype.pipeline import AvalonMongoDB
 from openpype.api import get_project_settings
@@ -182,7 +182,7 @@ def update_op_assets(
             root_folder_docs = get_assets(
                 project_name,
                 asset_names=[entity_parent_folders[-1]],
-                fields=["_id", "data.root_of"]
+                fields=["_id", "data.root_of"],
             )
             # NOTE: Not sure why it's checking for entity type?
             #   OP3 does not support multiple assets with same names so type
@@ -224,7 +224,7 @@ def update_op_assets(
         # Item name
         if item_type == "Asset":
             item_name = item_doc["name"]
-        elif item_type == "Shot":  
+        elif item_type == "Shot":
             # Name with parents hierarchy "({episode}_){sequence}_{shot}"
             # to avoid duplicate name issue
             item_name = "_".join(item_data["parents"] + [item_doc["name"]])

From 2bf3cf1b3094bb7402e7e3a8de55267fd4440edf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Tue, 19 Jul 2022 14:54:36 +0200
Subject: [PATCH 1194/1227] Fix wrong name for sequence

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 9a5dd7db61..b2f0caf52b 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -221,13 +221,12 @@ def update_op_assets(
             parent_entity = parent_doc["data"]["zou"]
             parent_zou_id = parent_entity["parent_id"]
 
-        # Item name
-        if item_type == "Asset":
-            item_name = item_doc["name"]
-        elif item_type == "Shot":
+        if item_type in ["Shot", "Sequence"]:
             # Name with parents hierarchy "({episode}_){sequence}_{shot}"
             # to avoid duplicate name issue
             item_name = "_".join(item_data["parents"] + [item_doc["name"]])
+        else:
+            item_name = item_doc["name"]
 
         # Set root folders parents
         item_data["parents"] = entity_parent_folders + item_data["parents"]

From 5940fd0937941ba0fea391be0889bfa86bedc806 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Wed, 20 Jul 2022 03:58:48 +0000
Subject: [PATCH 1195/1227] [Automated] Bump version

---
 CHANGELOG.md        | 15 ++++++++-------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 95427e9ea9..e8da885473 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,23 +1,29 @@
 # Changelog
 
-## [3.12.2-nightly.1](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.2-nightly.2](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.1...HEAD)
 
 **🚀 Enhancements**
 
+- General: Interactive console in cli [\#3526](https://github.com/pypeclub/OpenPype/pull/3526)
 - Ftrack: Automatic daily review session creation can define trigger hour [\#3516](https://github.com/pypeclub/OpenPype/pull/3516)
 - Ftrack: add source into Note [\#3509](https://github.com/pypeclub/OpenPype/pull/3509)
 - Ftrack: Trigger custom ftrack topic of project structure creation [\#3506](https://github.com/pypeclub/OpenPype/pull/3506)
 - Settings UI: Add extract to file action on project view [\#3505](https://github.com/pypeclub/OpenPype/pull/3505)
+- Add pack and unpack convenience scripts [\#3502](https://github.com/pypeclub/OpenPype/pull/3502)
 - General: Event system [\#3499](https://github.com/pypeclub/OpenPype/pull/3499)
 - NewPublisher: Keep plugins with mismatch target in report [\#3498](https://github.com/pypeclub/OpenPype/pull/3498)
 - Nuke: load clip with options from settings [\#3497](https://github.com/pypeclub/OpenPype/pull/3497)
+- TrayPublisher: implemented render\_mov\_batch  [\#3486](https://github.com/pypeclub/OpenPype/pull/3486)
 - Migrate basic families to the new Tray Publisher [\#3469](https://github.com/pypeclub/OpenPype/pull/3469)
 
 **🐛 Bug fixes**
 
+- Additional fixes for powershell scripts [\#3525](https://github.com/pypeclub/OpenPype/pull/3525)
+- Maya: Added wrapper around cmds.setAttr [\#3523](https://github.com/pypeclub/OpenPype/pull/3523)
 - General: Fix hash of centos oiio archive [\#3519](https://github.com/pypeclub/OpenPype/pull/3519)
+- Maya: Renderman display output fix [\#3514](https://github.com/pypeclub/OpenPype/pull/3514)
 - TrayPublisher: Simple creation enhancements and fixes [\#3513](https://github.com/pypeclub/OpenPype/pull/3513)
 - NewPublisher: Publish attributes are properly collected [\#3510](https://github.com/pypeclub/OpenPype/pull/3510)
 - TrayPublisher: Make sure host name is filled [\#3504](https://github.com/pypeclub/OpenPype/pull/3504)
@@ -25,6 +31,7 @@
 
 **🔀 Refactored code**
 
+- General: Client docstrings cleanup [\#3529](https://github.com/pypeclub/OpenPype/pull/3529)
 - TimersManager: Use query functions [\#3495](https://github.com/pypeclub/OpenPype/pull/3495)
 
 ## [3.12.1](https://github.com/pypeclub/OpenPype/tree/3.12.1) (2022-07-13)
@@ -51,7 +58,6 @@
 - Blender: Bugfix - Set fps properly on open [\#3426](https://github.com/pypeclub/OpenPype/pull/3426)
 - Hiero: Add custom scripts menu [\#3425](https://github.com/pypeclub/OpenPype/pull/3425)
 - Blender: pre pyside install for all platforms [\#3400](https://github.com/pypeclub/OpenPype/pull/3400)
-- Maya: Add additional playblast options to review Extractor. [\#3384](https://github.com/pypeclub/OpenPype/pull/3384)
 
 **🐛 Bug fixes**
 
@@ -71,7 +77,6 @@
 - Maya: fix hashing in Python 3 for tile rendering [\#3447](https://github.com/pypeclub/OpenPype/pull/3447)
 - LogViewer: Escape html characters in log message [\#3443](https://github.com/pypeclub/OpenPype/pull/3443)
 - Nuke: Slate frame is integrated [\#3427](https://github.com/pypeclub/OpenPype/pull/3427)
-- Maya: Camera extra data - additional fix for \#3304 [\#3386](https://github.com/pypeclub/OpenPype/pull/3386)
 
 **🔀 Refactored code**
 
@@ -85,8 +90,6 @@
 - General: Move publish plugin and publish render abstractions [\#3442](https://github.com/pypeclub/OpenPype/pull/3442)
 - General: Use Anatomy after move to pipeline [\#3436](https://github.com/pypeclub/OpenPype/pull/3436)
 - General: Anatomy moved to pipeline [\#3435](https://github.com/pypeclub/OpenPype/pull/3435)
-- Fusion: Use client query functions [\#3380](https://github.com/pypeclub/OpenPype/pull/3380)
-- Resolve: Use client query functions [\#3379](https://github.com/pypeclub/OpenPype/pull/3379)
 
 ## [3.12.0](https://github.com/pypeclub/OpenPype/tree/3.12.0) (2022-06-28)
 
@@ -111,7 +114,6 @@
 - Nuke: Collect representation files based on Write [\#3407](https://github.com/pypeclub/OpenPype/pull/3407)
 - General: Filter representations before integration start [\#3398](https://github.com/pypeclub/OpenPype/pull/3398)
 - Maya: look collector typo [\#3392](https://github.com/pypeclub/OpenPype/pull/3392)
-- Maya: vray device aspect ratio fix [\#3381](https://github.com/pypeclub/OpenPype/pull/3381)
 
 **🔀 Refactored code**
 
@@ -121,7 +123,6 @@
 - Houdini: Use client query functions [\#3395](https://github.com/pypeclub/OpenPype/pull/3395)
 - Hiero: Use client query functions [\#3393](https://github.com/pypeclub/OpenPype/pull/3393)
 - Nuke: Use client query functions [\#3391](https://github.com/pypeclub/OpenPype/pull/3391)
-- Maya: Use client query functions [\#3385](https://github.com/pypeclub/OpenPype/pull/3385)
 
 ## [3.11.1](https://github.com/pypeclub/OpenPype/tree/3.11.1) (2022-06-20)
 
diff --git a/openpype/version.py b/openpype/version.py
index e9206379e1..dd5ad97449 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.2-nightly.1"
+__version__ = "3.12.2-nightly.2"
diff --git a/pyproject.toml b/pyproject.toml
index 19d65b50f9..9552242694 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.2-nightly.1" # OpenPype
+version = "3.12.2-nightly.2" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From fca8030092e9e9fd165d2bdf2039b662be218499 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 09:47:54 +0200
Subject: [PATCH 1196/1227] normalize path from get_workdir where needed

---
 .../hosts/flame/plugins/publish/integrate_batch_group.py    | 6 ++++--
 openpype/lib/applications.py                                | 1 +
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/integrate_batch_group.py b/openpype/hosts/flame/plugins/publish/integrate_batch_group.py
index da9553cc2a..032de99540 100644
--- a/openpype/hosts/flame/plugins/publish/integrate_batch_group.py
+++ b/openpype/hosts/flame/plugins/publish/integrate_batch_group.py
@@ -324,5 +324,7 @@ class IntegrateBatchGroup(pyblish.api.InstancePlugin):
         project_doc = instance.data["projectEntity"]
         asset_entity = instance.data["assetEntity"]
 
-        return get_workdir(
-            project_doc, asset_entity, task_data["name"], "flame")
+        workdir = get_workdir(
+            project_doc, asset_entity, task_data["name"], "flame"
+        )
+        return os.path.normpath(workdir)
diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index f46197e15f..dafc3b479b 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -1638,6 +1638,7 @@ def prepare_context_environments(data, env_group=None):
             "Error in anatomy.format: {}".format(str(exc))
         )
 
+    workdir = os.path.normpath(workdir)
     if not os.path.exists(workdir):
         log.debug(
             "Creating workdir folder: \"{}\"".format(workdir)

From 37a02fe8e19e4faeaa2a63e3cced19efe5aa1fce Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 09:48:21 +0200
Subject: [PATCH 1197/1227] 'get_workdir_with_workdir_data' returns
 'TemplateResult'

---
 openpype/lib/avalon_context.py | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 76ed6cbbd3..605ebb0b99 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -582,10 +582,7 @@ def get_workdir_with_workdir_data(
 
     anatomy_filled = anatomy.format(workdir_data)
     # Output is TemplateResult object which contain useful data
-    path = anatomy_filled[template_key]["folder"]
-    if path:
-        path = os.path.normpath(path)
-    return path
+    return anatomy_filled[template_key]["folder"]
 
 
 def get_workdir(

From afd26a82e376a6445177d63d7769394c22b5efa6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 09:48:42 +0200
Subject: [PATCH 1198/1227] pass anatomy to 'get_workdir' in flame integrator

---
 openpype/hosts/flame/plugins/publish/integrate_batch_group.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/plugins/publish/integrate_batch_group.py b/openpype/hosts/flame/plugins/publish/integrate_batch_group.py
index 032de99540..bf6e81523d 100644
--- a/openpype/hosts/flame/plugins/publish/integrate_batch_group.py
+++ b/openpype/hosts/flame/plugins/publish/integrate_batch_group.py
@@ -323,8 +323,9 @@ class IntegrateBatchGroup(pyblish.api.InstancePlugin):
     def _get_shot_task_dir_path(self, instance, task_data):
         project_doc = instance.data["projectEntity"]
         asset_entity = instance.data["assetEntity"]
+        anatomy = instance.context.data["anatomy"]
 
         workdir = get_workdir(
-            project_doc, asset_entity, task_data["name"], "flame"
+            project_doc, asset_entity, task_data["name"], "flame", anatomy
         )
         return os.path.normpath(workdir)

From 5963066a7e1ba2849092215697470e7e0ae734bd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 10:11:56 +0200
Subject: [PATCH 1199/1227] TemplateResult has 'normalized' method

---
 openpype/lib/path_templates.py | 13 +++++++++++++
 openpype/pipeline/anatomy.py   | 13 +++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/openpype/lib/path_templates.py b/openpype/lib/path_templates.py
index 5c40aa4549..c1282016ef 100644
--- a/openpype/lib/path_templates.py
+++ b/openpype/lib/path_templates.py
@@ -409,6 +409,19 @@ class TemplateResult(str):
             self.invalid_types
         )
 
+    def normalized(self):
+        """Convert to normalized path."""
+
+        cls = self.__class__
+        return cls(
+            os.path.normpath(self),
+            self.template,
+            self.solved,
+            self.used_values,
+            self.missing_keys,
+            self.invalid_types
+        )
+
 
 class TemplatesResultDict(dict):
     """Holds and wrap TemplateResults for easy bug report."""
diff --git a/openpype/pipeline/anatomy.py b/openpype/pipeline/anatomy.py
index 73081f18fb..08db4749b3 100644
--- a/openpype/pipeline/anatomy.py
+++ b/openpype/pipeline/anatomy.py
@@ -380,6 +380,19 @@ class AnatomyTemplateResult(TemplateResult):
         )
         return self.__class__(tmp, self.rootless)
 
+    def normalized(self):
+        """Convert to normalized path."""
+
+        tmp = TemplateResult(
+            os.path.normpath(self),
+            self.template,
+            self.solved,
+            self.used_values,
+            self.missing_keys,
+            self.invalid_types
+        )
+        return self.__class__(tmp, self.rootless)
+
 
 class AnatomyTemplates(TemplatesDict):
     inner_key_pattern = re.compile(r"(\{@.*?[^{}0]*\})")

From ab34b6f1cf1b1e56b770dcac4191ca69c3a58a5b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 10:12:56 +0200
Subject: [PATCH 1200/1227] use normalized 'TemplateResult' output in
 'get_workdir_with_workdir_data'

---
 .../hosts/flame/plugins/publish/integrate_batch_group.py     | 3 +--
 openpype/lib/applications.py                                 | 1 -
 openpype/lib/avalon_context.py                               | 5 ++++-
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/integrate_batch_group.py b/openpype/hosts/flame/plugins/publish/integrate_batch_group.py
index bf6e81523d..b59107f155 100644
--- a/openpype/hosts/flame/plugins/publish/integrate_batch_group.py
+++ b/openpype/hosts/flame/plugins/publish/integrate_batch_group.py
@@ -325,7 +325,6 @@ class IntegrateBatchGroup(pyblish.api.InstancePlugin):
         asset_entity = instance.data["assetEntity"]
         anatomy = instance.context.data["anatomy"]
 
-        workdir = get_workdir(
+        return get_workdir(
             project_doc, asset_entity, task_data["name"], "flame", anatomy
         )
-        return os.path.normpath(workdir)
diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index dafc3b479b..f46197e15f 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -1638,7 +1638,6 @@ def prepare_context_environments(data, env_group=None):
             "Error in anatomy.format: {}".format(str(exc))
         )
 
-    workdir = os.path.normpath(workdir)
     if not os.path.exists(workdir):
         log.debug(
             "Creating workdir folder: \"{}\"".format(workdir)
diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 605ebb0b99..2944b2506e 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -582,7 +582,10 @@ def get_workdir_with_workdir_data(
 
     anatomy_filled = anatomy.format(workdir_data)
     # Output is TemplateResult object which contain useful data
-    return anatomy_filled[template_key]["folder"]
+    output = anatomy_filled[template_key]["folder"]
+    if output:
+        return output.normalized()
+    return output
 
 
 def get_workdir(

From 6ed18c6250e083a827be395cfc9746ffe7bdd2fa Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 13:13:23 +0200
Subject: [PATCH 1201/1227] stop context timer when context is set

---
 openpype/tools/workfiles/window.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/tools/workfiles/window.py b/openpype/tools/workfiles/window.py
index c1efe026f2..f5edff2fa5 100644
--- a/openpype/tools/workfiles/window.py
+++ b/openpype/tools/workfiles/window.py
@@ -331,6 +331,7 @@ class Window(QtWidgets.QMainWindow):
         if self.assets_widget.refreshing:
             return
 
+        self._set_context_timer.stop()
         self._context_to_set, context = None, self._context_to_set
         if "asset" in context:
             asset_doc = get_asset_by_name(

From 58611f89bda27a745defb77a54fe27ff3555ffb7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 13:15:12 +0200
Subject: [PATCH 1202/1227] global function 'show_workfiles' just pass args and
 kwargs

---
 openpype/tools/utils/host_tools.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/tools/utils/host_tools.py b/openpype/tools/utils/host_tools.py
index ae23e4d089..41c4478d57 100644
--- a/openpype/tools/utils/host_tools.py
+++ b/openpype/tools/utils/host_tools.py
@@ -395,9 +395,9 @@ def show_tool_by_name(tool_name, parent=None, *args, **kwargs):
     _SingletonPoint.show_tool_by_name(tool_name, parent, *args, **kwargs)
 
 
-def show_workfiles(parent=None, use_context=None, save=None):
+def show_workfiles(*args, **kwargs):
     _SingletonPoint.show_tool_by_name(
-        "workfiles", parent, use_context=use_context, save=save
+        "workfiles", *args, **kwargs
     )
 
 

From 8e4627b44dd6e1a667b742415c6d00946dba3220 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 13:15:37 +0200
Subject: [PATCH 1203/1227] set icon of workfiles tool

---
 openpype/tools/workfiles/window.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/tools/workfiles/window.py b/openpype/tools/workfiles/window.py
index f5edff2fa5..e86b716765 100644
--- a/openpype/tools/workfiles/window.py
+++ b/openpype/tools/workfiles/window.py
@@ -1,6 +1,6 @@
 import os
 import datetime
-from Qt import QtCore, QtWidgets
+from Qt import QtCore, QtWidgets, QtGui
 
 from openpype.client import (
     get_asset_by_id,
@@ -8,6 +8,7 @@ from openpype.client import (
     get_workfile_info,
 )
 from openpype import style
+from openpype import resources
 from openpype.lib import (
     create_workfile_doc,
     save_workfile_data_to_doc,
@@ -153,6 +154,8 @@ class Window(QtWidgets.QMainWindow):
         if not parent:
             window_flags |= QtCore.Qt.WindowStaysOnTopHint
         self.setWindowFlags(window_flags)
+        icon = QtGui.QIcon(resources.get_openpype_icon_filepath())
+        self.setWindowIcon(icon)
 
         # Create pages widget and set it as central widget
         pages_widget = QtWidgets.QStackedWidget(self)

From 55ff302d21a49b13281972129a944adcb998bf89 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 13:15:58 +0200
Subject: [PATCH 1204/1227] changed workfiles window to QWidget

---
 openpype/tools/workfiles/window.py | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/openpype/tools/workfiles/window.py b/openpype/tools/workfiles/window.py
index e86b716765..588daf069f 100644
--- a/openpype/tools/workfiles/window.py
+++ b/openpype/tools/workfiles/window.py
@@ -143,23 +143,19 @@ class SidePanelWidget(QtWidgets.QWidget):
         return self._workfile_doc, data
 
 
-class Window(QtWidgets.QMainWindow):
+class Window(QtWidgets.QWidget):
     """Work Files Window"""
     title = "Work Files"
 
     def __init__(self, parent=None):
         super(Window, self).__init__(parent=parent)
         self.setWindowTitle(self.title)
-        window_flags = QtCore.Qt.Window | QtCore.Qt.WindowCloseButtonHint
-        if not parent:
-            window_flags |= QtCore.Qt.WindowStaysOnTopHint
-        self.setWindowFlags(window_flags)
         icon = QtGui.QIcon(resources.get_openpype_icon_filepath())
         self.setWindowIcon(icon)
+        self.setWindowFlags(self.windowFlags() | QtCore.Qt.Window)
 
         # Create pages widget and set it as central widget
         pages_widget = QtWidgets.QStackedWidget(self)
-        self.setCentralWidget(pages_widget)
 
         home_page_widget = QtWidgets.QWidget(pages_widget)
         home_body_widget = QtWidgets.QWidget(home_page_widget)
@@ -194,6 +190,9 @@ class Window(QtWidgets.QMainWindow):
         # the files widget has a filter field which tasks does not.
         tasks_widget.setContentsMargins(0, 32, 0, 0)
 
+        main_layout = QtWidgets.QHBoxLayout(self)
+        main_layout.addWidget(pages_widget, 1)
+
         # Set context after asset widget is refreshed
         # - to do so it is necessary to wait until refresh is done
         set_context_timer = QtCore.QTimer()

From 3fac738361abb9446424fcb244d9768c2706f070 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 13:16:15 +0200
Subject: [PATCH 1205/1227] show workfile just calls ensure visible on
 workfiles tool

---
 openpype/tools/utils/host_tools.py | 25 +++--------------
 openpype/tools/workfiles/window.py | 43 ++++++++++++++++++++++++++++++
 2 files changed, 47 insertions(+), 21 deletions(-)

diff --git a/openpype/tools/utils/host_tools.py b/openpype/tools/utils/host_tools.py
index 41c4478d57..52d15a59f7 100644
--- a/openpype/tools/utils/host_tools.py
+++ b/openpype/tools/utils/host_tools.py
@@ -60,31 +60,14 @@ class HostToolsHelper:
 
         return self._workfiles_tool
 
-    def show_workfiles(self, parent=None, use_context=None, save=None):
+    def show_workfiles(
+        self, parent=None, use_context=None, save=None, on_top=None
+    ):
         """Workfiles tool for changing context and saving workfiles."""
-        if use_context is None:
-            use_context = True
-
-        if save is None:
-            save = True
 
         with qt_app_context():
             workfiles_tool = self.get_workfiles_tool(parent)
-            workfiles_tool.set_save_enabled(save)
-
-            if not workfiles_tool.isVisible():
-                workfiles_tool.show()
-
-                if use_context:
-                    context = {
-                        "asset": legacy_io.Session["AVALON_ASSET"],
-                        "task": legacy_io.Session["AVALON_TASK"]
-                    }
-                    workfiles_tool.set_context(context)
-
-            # Pull window to the front.
-            workfiles_tool.raise_()
-            workfiles_tool.activateWindow()
+            workfiles_tool.ensure_visible(use_context, save, on_top)
 
     def get_loader_tool(self, parent):
         """Create, cache and return loader tool window."""
diff --git a/openpype/tools/workfiles/window.py b/openpype/tools/workfiles/window.py
index 588daf069f..0b0d67e589 100644
--- a/openpype/tools/workfiles/window.py
+++ b/openpype/tools/workfiles/window.py
@@ -229,6 +229,49 @@ class Window(QtWidgets.QWidget):
         self._first_show = True
         self._context_to_set = None
 
+    def ensure_visible(
+        self, use_context=None, save=None, on_top=None
+    ):
+        if save is None:
+            save = True
+
+        self.set_save_enabled(save)
+
+        if self.isVisible():
+            use_context = False
+        elif use_context is None:
+            use_context = True
+
+        if on_top is None and self._first_show:
+            on_top = self.parent() is None
+
+        window_flags = self.windowFlags()
+        new_window_flags = window_flags
+        if on_top is True:
+            new_window_flags = window_flags | QtCore.Qt.WindowStaysOnTopHint
+        elif on_top is False:
+            new_window_flags = window_flags & ~QtCore.Qt.WindowStaysOnTopHint
+
+        if new_window_flags != window_flags:
+            # Note this is not propagated after initialization of widget in
+            #   some Qt builds
+            self.setWindowFlags(new_window_flags)
+            self.show()
+
+        elif not self.isVisible():
+            self.show()
+
+        if use_context is None or use_context is True:
+            context = {
+                "asset": legacy_io.Session["AVALON_ASSET"],
+                "task": legacy_io.Session["AVALON_TASK"]
+            }
+            self.set_context(context)
+
+        # Pull window to the front.
+        self.raise_()
+        self.activateWindow()
+
     @property
     def project_name(self):
         return legacy_io.Session["AVALON_PROJECT"]

From b128e98c8f6269a779ec87a66d35cf8b4d8bf6d1 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 13:16:57 +0200
Subject: [PATCH 1206/1227] nuke does not pass parent widget for workfiles tool
 and tell it to change on top flag

---
 openpype/hosts/nuke/api/lib.py      | 10 ++++++----
 openpype/hosts/nuke/api/pipeline.py | 10 +++++++++-
 2 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 0929415c00..9b24c9fb38 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -2440,10 +2440,12 @@ def _launch_workfile_app():
     if starting_up or closing_down:
         return
 
-    from .pipeline import get_main_window
-
-    main_window = get_main_window()
-    host_tools.show_workfiles(parent=main_window)
+    # Make sure on top is enabled on first show so the window is not hidden
+    #   under main nuke window
+    #   - this happened on Centos 7 and it is because the focus of nuke
+    #       changes to the main window after showing because of initialization
+    #       which moves workfiles tool under it
+    host_tools.show_workfiles(parent=None, on_top=True)
 
 
 def process_workfile_builder():
diff --git a/openpype/hosts/nuke/api/pipeline.py b/openpype/hosts/nuke/api/pipeline.py
index 2e3621ba8f..0afc56d2f7 100644
--- a/openpype/hosts/nuke/api/pipeline.py
+++ b/openpype/hosts/nuke/api/pipeline.py
@@ -142,6 +142,14 @@ def uninstall():
     _uninstall_menu()
 
 
+def _show_workfiles():
+    # Make sure parent is not set
+    # - this makes Workfiles tool as separated window which
+    #   avoid issues with reopening
+    # - it is possible to explicitly change on top flag of the tool
+    host_tools.show_workfiles(parent=None, on_top=False)
+
+
 def _install_menu():
     # uninstall original avalon menu
     main_window = get_main_window()
@@ -158,7 +166,7 @@ def _install_menu():
     menu.addSeparator()
     menu.addCommand(
         "Work Files...",
-        lambda: host_tools.show_workfiles(parent=main_window)
+        _show_workfiles
     )
 
     menu.addSeparator()

From 037ed71f60eba9d5947aef8c973e8b791596b942 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 20 Jul 2022 13:52:15 +0200
Subject: [PATCH 1207/1227] keep subset group template settings but mark them
 as deprecated with hint where to move the value

---
 .../defaults/project_settings/global.json     |  9 ++++
 .../schemas/schema_global_publish.json        | 46 +++++++++++++++++++
 2 files changed, 55 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index 9247c6ceb6..e509db2791 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -171,6 +171,15 @@
             ]
         },
         "IntegrateAssetNew": {
+            "subset_grouping_profiles": [
+                {
+                    "families": [],
+                    "hosts": [],
+                    "task_types": [],
+                    "tasks": [],
+                    "template": ""
+                }
+            ],
             "template_name_profiles": [
                 {
                     "families": [],
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
index af08bbec3c..b9d0b7daba 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
@@ -587,6 +587,52 @@
             "label": "IntegrateAsset (Legacy)",
             "is_group": true,
             "children": [
+                {
+                    "type": "label",
+                    "label": "<b>NOTE:</b> Subset grouping profiles settings were moved to <a href=\"settings://project_settings/global/publish/IntegrateSubsetGroup/subset_grouping_profiles\"><b>Integrate Subset Group</b></a>. Please move values there."
+                },
+                {
+                    "type": "list",
+                    "key": "subset_grouping_profiles",
+                    "label": "Subset grouping profiles (DEPRECATED)",
+                    "use_label_wrap": true,
+                    "object_type": {
+                        "type": "dict",
+                        "children": [
+                            {
+                                "key": "families",
+                                "label": "Families",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "hosts-enum",
+                                "key": "hosts",
+                                "label": "Hosts",
+                                "multiselection": true
+                            },
+                            {
+                                "key": "task_types",
+                                "label": "Task types",
+                                "type": "task-types-enum"
+                            },
+                            {
+                                "key": "tasks",
+                                "label": "Task names",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "separator"
+                            },
+                            {
+                                "type": "text",
+                                "key": "template",
+                                "label": "Template"
+                            }
+                        ]
+                    }
+                },
                 {
                     "type": "list",
                     "key": "template_name_profiles",

From bedca7eaf98212d1a5450b097029d25dfdaf4d02 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?= <ondrej.samohel@pype.club>
Date: Wed, 20 Jul 2022 16:30:03 +0200
Subject: [PATCH 1208/1227] :wrench: add relevant Maya validators to Settings

add missing validators and add ability to set them optional if needed
---
 .../validate_review_subset_uniqueness.py      |   4 +-
 .../plugins/publish/validate_setdress_root.py |   3 +-
 .../defaults/project_settings/maya.json       | 178 +++++++++++++++++-
 .../schemas/schema_maya_publish.json          | 155 +++++++++++++++
 4 files changed, 329 insertions(+), 11 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_review_subset_uniqueness.py b/openpype/hosts/maya/plugins/publish/validate_review_subset_uniqueness.py
index d70096ee45..04cc9ab5fb 100644
--- a/openpype/hosts/maya/plugins/publish/validate_review_subset_uniqueness.py
+++ b/openpype/hosts/maya/plugins/publish/validate_review_subset_uniqueness.py
@@ -6,7 +6,7 @@ from openpype.pipeline import PublishXmlValidationError
 
 
 class ValidateReviewSubsetUniqueness(pyblish.api.ContextPlugin):
-    """Validates that nodes has common root."""
+    """Validates that review subset has unique name."""
 
     order = openpype.api.ValidateContentsOrder
     hosts = ["maya"]
@@ -17,7 +17,7 @@ class ValidateReviewSubsetUniqueness(pyblish.api.ContextPlugin):
         subset_names = []
 
         for instance in context:
-            self.log.info("instance:: {}".format(instance.data))
+            self.log.debug("Instance: {}".format(instance.data))
             if instance.data.get('publish'):
                 subset_names.append(instance.data.get('subset'))
 
diff --git a/openpype/hosts/maya/plugins/publish/validate_setdress_root.py b/openpype/hosts/maya/plugins/publish/validate_setdress_root.py
index 0b4842d208..8e23a7c04f 100644
--- a/openpype/hosts/maya/plugins/publish/validate_setdress_root.py
+++ b/openpype/hosts/maya/plugins/publish/validate_setdress_root.py
@@ -4,8 +4,7 @@ import openpype.api
 
 
 class ValidateSetdressRoot(pyblish.api.InstancePlugin):
-    """
-    """
+    """Validate if set dress top root node is published."""
 
     order = openpype.api.ValidateContentsOrder
     label = "SetDress Root"
diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 5976c6a823..c96acbff6d 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -205,10 +205,15 @@
             "enabled": true,
             "optional": true,
             "active": true,
-            "exclude_families": ["model", "rig", "staticMesh"]
+            "exclude_families": [
+                "model",
+                "rig",
+                "staticMesh"
+            ]
         },
         "ValidateShaderName": {
             "enabled": false,
+            "optional": true,
             "regex": "(?P<asset>.*)_(.*)_SHD"
         },
         "ValidateShadingEngine": {
@@ -222,6 +227,7 @@
         },
         "ValidateLoadedPlugin": {
             "enabled": false,
+            "optional": true,
             "whitelist_native_plugins": false,
             "authorized_plugins": []
         },
@@ -236,6 +242,7 @@
         },
         "ValidateUnrealStaticMeshName": {
             "enabled": true,
+            "optional": true,
             "validate_mesh": false,
             "validate_collision": true
         },
@@ -252,6 +259,81 @@
             "redshift_render_attributes": [],
             "renderman_render_attributes": []
         },
+        "ValidateCurrentRenderLayerIsRenderable": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateRenderImageRule": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateRenderNoDefaultCameras": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateRenderSingleCamera": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateRenderLayerAOVs": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateStepSize": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateVRayDistributedRendering": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateVrayReferencedAOVs": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateVRayTranslatorEnabled": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateVrayProxy": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateVrayProxyMembers": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateYetiRenderScriptCallbacks": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateYetiRigCacheState": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateYetiRigInputShapesInInstance": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateYetiRigSettings": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
         "ValidateModelName": {
             "enabled": false,
             "database": true,
@@ -270,6 +352,7 @@
         },
         "ValidateTransformNamingSuffix": {
             "enabled": true,
+            "optional": true,
             "SUFFIX_NAMING_TABLE": {
                 "mesh": [
                     "_GEO",
@@ -293,7 +376,7 @@
             "ALLOW_IF_NOT_IN_SUFFIX_TABLE": true
         },
         "ValidateColorSets": {
-            "enabled": false,
+            "enabled": true,
             "optional": true,
             "active": true
         },
@@ -337,6 +420,16 @@
             "optional": true,
             "active": true
         },
+        "ValidateMeshNoNegativeScale": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateMeshNonZeroEdgeLength": {
+            "enabled": true,
+            "optional": true,
+            "active": true
+        },
         "ValidateMeshNormalsUnlocked": {
             "enabled": false,
             "optional": true,
@@ -359,22 +452,22 @@
         },
         "ValidateNoNamespace": {
             "enabled": true,
-            "optional": true,
+            "optional": false,
             "active": true
         },
         "ValidateNoNullTransforms": {
             "enabled": true,
-            "optional": true,
+            "optional": false,
             "active": true
         },
         "ValidateNoUnknownNodes": {
             "enabled": true,
-            "optional": true,
+            "optional": false,
             "active": true
         },
         "ValidateNodeNoGhosting": {
             "enabled": false,
-            "optional": true,
+            "optional": false,
             "active": true
         },
         "ValidateShapeDefaultNames": {
@@ -402,6 +495,21 @@
             "optional": true,
             "active": true
         },
+        "ValidateNoVRayMesh": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateUnrealMeshTriangulated": {
+            "enabled": false,
+            "optional": true,
+            "active": true
+        },
+        "ValidateAlembicVisibleOnly": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
         "ExtractAlembic": {
             "enabled": true,
             "families": [
@@ -425,8 +533,34 @@
             "optional": true,
             "active": true
         },
+        "ValidateAnimationContent": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateOutRelatedNodeIds": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateRigControllersArnoldAttributes": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateSkeletalMeshHierarchy": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateSkinclusterDeformerSet": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
         "ValidateRigOutSetNodeIds": {
             "enabled": true,
+            "optional": false,
             "allow_history_only": false
         },
         "ValidateCameraAttributes": {
@@ -439,14 +573,44 @@
             "optional": true,
             "active": true
         },
+        "ValidateAssemblyNamespaces": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateAssemblyModelTransforms": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
         "ValidateAssRelativePaths": {
             "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateInstancerContent": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateInstancerFrameRanges": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateNoDefaultCameras": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
+        "ValidateUnrealUpAxis": {
+            "enabled": false,
             "optional": true,
             "active": true
         },
         "ValidateCameraContents": {
             "enabled": true,
-            "optional": true,
+            "optional": false,
             "validate_shapes": true
         },
         "ExtractPlayblast": {
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
index 84182973a1..53247f6bd4 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_publish.json
@@ -107,6 +107,11 @@
                     "key": "enabled",
                     "label": "Enabled"
                 },
+                {
+                    "type": "boolean",
+                    "key": "optional",
+                    "label": "Optional"
+                },
                 {
                     "type": "label",
                     "label": "Shader name regex can use named capture group <b>asset</b> to validate against current asset name.<p><b>Example:</b><br/><code>^.*(?P=&lt;asset&gt;.+)_SHD</code></p>"
@@ -159,6 +164,11 @@
                     "key": "enabled",
                     "label": "Enabled"
                 },
+                {
+                    "type": "boolean",
+                    "key": "optional",
+                    "label": "Optional"
+                },
                 {
                     "type": "boolean",
                     "key": "whitelist_native_plugins",
@@ -246,6 +256,11 @@
                     "key": "enabled",
                     "label": "Enabled"
                 },
+                {
+                    "type": "boolean",
+                    "key": "optional",
+                    "label": "Optional"
+                },
                 {
                     "type": "boolean",
                     "key": "validate_mesh",
@@ -332,6 +347,72 @@
                 }
             ]
         },
+        {
+            "type": "schema_template",
+            "name": "template_publish_plugin",
+            "template_data": [
+                {
+                    "key": "ValidateCurrentRenderLayerIsRenderable",
+                    "label": "Validate Current Render Layer Has Renderable Camera"
+                },
+                {
+                    "key": "ValidateRenderImageRule",
+                    "label": "Validate Images File Rule (Workspace)"
+                },
+                {
+                    "key": "ValidateRenderNoDefaultCameras",
+                    "label": "Validate No Default Cameras Renderable"
+                },
+                {
+                    "key": "ValidateRenderSingleCamera",
+                    "label": "Validate Render Single Camera"
+                },
+                {
+                    "key": "ValidateRenderLayerAOVs",
+                    "label": "Validate Render Passes / AOVs Are Registered"
+                },
+                {
+                    "key": "ValidateStepSize",
+                    "label": "Validate Step Size"
+                },
+                {
+                    "key": "ValidateVRayDistributedRendering",
+                    "label": "VRay Distributed Rendering"
+                },
+                {
+                    "key": "ValidateVrayReferencedAOVs",
+                    "label": "VRay Referenced AOVs"
+                },
+                {
+                    "key": "ValidateVRayTranslatorEnabled",
+                    "label": "VRay Translator Settings"
+                },
+                {
+                    "key": "ValidateVrayProxy",
+                    "label": "VRay Proxy Settings"
+                },
+                {
+                    "key": "ValidateVrayProxyMembers",
+                    "label": "VRay Proxy Members"
+                },
+                {
+                    "key": "ValidateYetiRenderScriptCallbacks",
+                    "label": "Yeti Render Script Callbacks"
+                },
+                {
+                    "key": "ValidateYetiRigCacheState",
+                    "label": "Yeti Rig Cache State"
+                },
+                {
+                    "key": "ValidateYetiRigInputShapesInInstance",
+                    "label": "Yeti Rig Input Shapes In Instance"
+                },
+                {
+                    "key": "ValidateYetiRigSettings",
+                    "label": "Yeti Rig Settings"
+                }
+            ]
+        },
         {
             "type": "collapsible-wrap",
             "label": "Model",
@@ -416,6 +497,11 @@
                             "key": "enabled",
                             "label": "Enabled"
                         },
+                        {
+                            "type": "boolean",
+                            "key": "optional",
+                            "label": "Optional"
+                        },
                         {
                             "type": "label",
                             "label": "Validates transform suffix based on the type of its children shapes."
@@ -472,6 +558,14 @@
                             "key": "ValidateMeshNonManifold",
                             "label": "ValidateMeshNonManifold"
                         },
+                        {
+                            "key": "ValidateMeshNoNegativeScale",
+                            "label": "Validate Mesh No Negative Scale"
+                        },
+                        {
+                            "key": "ValidateMeshNonZeroEdgeLength",
+                            "label": "Validate Mesh Edge Length Non Zero"
+                        },
                         {
                             "key": "ValidateMeshNormalsUnlocked",
                             "label": "ValidateMeshNormalsUnlocked"
@@ -525,6 +619,18 @@
                         {
                             "key": "ValidateUniqueNames",
                             "label": "ValidateUniqueNames"
+                        },
+                        {
+                            "key": "ValidateNoVRayMesh",
+                            "label": "Validate No V-Ray Proxies (VRayMesh)"
+                        },
+                        {
+                            "key": "ValidateUnrealMeshTriangulated",
+                            "label": "Validate if Mesh is Triangulated"
+                        },
+                        {
+                            "key": "ValidateAlembicVisibleOnly",
+                            "label": "Validate Alembic visible node"
                         }
                     ]
                 },
@@ -573,6 +679,26 @@
                         {
                             "key": "ValidateRigControllers",
                             "label": "Validate Rig Controllers"
+                        },
+                        {
+                            "key": "ValidateAnimationContent",
+                            "label": "Validate Animation Content"
+                        },
+                        {
+                            "key": "ValidateOutRelatedNodeIds",
+                            "label": "Validate Animation Out Set Related Node Ids"
+                        },
+                        {
+                            "key": "ValidateRigControllersArnoldAttributes",
+                            "label": "Validate Rig Controllers (Arnold Attributes)"
+                        },
+                        {
+                            "key": "ValidateSkeletalMeshHierarchy",
+                            "label": "Validate Skeletal Mesh Top Node"
+                        },
+                         {
+                            "key": "ValidateSkinclusterDeformerSet",
+                            "label": "Validate Skincluster Deformer Relationships"
                         }
                     ]
                 },
@@ -589,6 +715,11 @@
                             "key": "enabled",
                             "label": "Enabled"
                         },
+                        {
+                            "type": "boolean",
+                            "key": "optional",
+                            "label": "Optional"
+                        },
                         {
                             "type": "boolean",
                             "key": "allow_history_only",
@@ -611,9 +742,33 @@
                     "key": "ValidateAssemblyName",
                     "label": "Validate Assembly Name"
                 },
+                {
+                    "key": "ValidateAssemblyNamespaces",
+                    "label": "Validate Assembly Namespaces"
+                },
+                {
+                    "key": "ValidateAssemblyModelTransforms",
+                    "label": "Validate Assembly Model Transforms"
+                },
                 {
                     "key": "ValidateAssRelativePaths",
                     "label": "ValidateAssRelativePaths"
+                },
+                {
+                    "key": "ValidateInstancerContent",
+                    "label": "Validate Instancer Content"
+                },
+                {
+                    "key": "ValidateInstancerFrameRanges",
+                    "label": "Validate Instancer Cache Frame Ranges"
+                },
+                {
+                    "key": "ValidateNoDefaultCameras",
+                    "label": "Validate No Default Cameras"
+                },
+                {
+                    "key": "ValidateUnrealUpAxis",
+                    "label": "Validate Unreal Up-Axis check"
                 }
             ]
         },

From 59395883170cac8ec8c11ca7b66ccd40d499cbc4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 20 Jul 2022 17:30:40 +0200
Subject: [PATCH 1209/1227] Change: Asset is put under an AssetType folder

---
 .../modules/kitsu/utils/update_op_with_zou.py | 60 ++++++++++++-------
 1 file changed, 37 insertions(+), 23 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 4695a49159..e0ff87adf7 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -14,7 +14,7 @@ from openpype.client import (
     get_project,
     get_assets,
     get_asset_by_id,
-    get_asset_by_name
+    get_asset_by_name,
 )
 from openpype.pipeline import AvalonMongoDB
 from openpype.api import get_project_settings
@@ -154,17 +154,23 @@ def update_op_assets(
             parent_zou_id = substitute_parent_item["parent_id"]
         else:
             parent_zou_id = (
-                item.get("parent_id")
+                # For Asset, put under asset type directory
+                item.get("entity_type_id")
+                if item_type == "Asset"
+                else None
+                # Else, fallback on usual hierarchy
+                or item.get("parent_id")
                 or item.get("episode_id")
                 or item.get("source_id")
-            )  # TODO check consistency
+            )
 
-        # Substitute Episode and Sequence by Shot
-        substitute_item_type = (
-            "shots"
-            if item_type in ["Episode", "Sequence"]
-            else f"{item_type.lower()}s"
-        )
+        # Substitute item type for general classification (assets or shots)
+        if item_type in ["Asset", "AssetType"]:
+            substitute_item_type = "assets"
+        elif item_type in ["Episode", "Sequence"]:
+            substitute_item_type = "shots"
+        else:
+            substitute_item_type = f"{item_type.lower()}s"
         entity_parent_folders = [
             f
             for f in project_module_settings["entities_root"]
@@ -181,8 +187,8 @@ def update_op_assets(
             # Find root folder docs
             root_folder_docs = get_assets(
                 project_name,
-                asset_name=[entity_parent_folders[-1]],
-                fields=["_id", "data.root_of"]
+                asset_names=[entity_parent_folders[-1]],
+                fields=["_id", "data.root_of"],
             )
             # NOTE: Not sure why it's checking for entity type?
             #   OP3 does not support multiple assets with same names so type
@@ -219,7 +225,7 @@ def update_op_assets(
 
             # Get parent entity
             parent_entity = parent_doc["data"]["zou"]
-            parent_zou_id = parent_entity["parent_id"]
+            parent_zou_id = parent_entity.get("parent_id")
 
         # Set root folders parents
         item_data["parents"] = entity_parent_folders + item_data["parents"]
@@ -236,7 +242,7 @@ def update_op_assets(
                         "$set": {
                             "name": item["name"],
                             "data": item_data,
-                            "parent": asset_doc_ids[item["project_id"]]["_id"],
+                            "parent": project_doc["_id"],
                         }
                     },
                 )
@@ -327,6 +333,10 @@ def sync_all_projects(login: str, password: str):
 def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
     """Update OP project in DB with Zou data.
 
+    `root_of` is meant to sort entities by type for a better readability in the data tree. It
+    puts all shot like (Shot and Episode and Sequence) and asset entities under two different root
+    folders or hierarchy, defined in settings.
+
     Args:
         dbcon (AvalonMongoDB): MongoDB connection
         project (dict): Project dict got using gazu.
@@ -341,12 +351,17 @@ def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
 
     # Get all assets from zou
     all_assets = gazu.asset.all_assets_for_project(project)
+    all_asset_types = gazu.asset.all_asset_types_for_project(project)
     all_episodes = gazu.shot.all_episodes_for_project(project)
     all_seqs = gazu.shot.all_sequences_for_project(project)
     all_shots = gazu.shot.all_shots_for_project(project)
     all_entities = [
         item
-        for item in all_assets + all_episodes + all_seqs + all_shots
+        for item in all_assets
+        + all_asset_types
+        + all_episodes
+        + all_seqs
+        + all_shots
         if naming_pattern.match(item["name"])
     ]
 
@@ -401,21 +416,20 @@ def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
                         "data": {
                             "root_of": entity_type,
                             "parents": parent_folders[:i],
-                            "visualParent": direct_parent_doc,
+                            "visualParent": direct_parent_doc.inserted_id
+                            if direct_parent_doc
+                            else None,
                             "tasks": {},
                         },
                     }
                 )
 
     # Create
-    to_insert = []
-    to_insert.extend(
-        [
-            create_op_asset(item)
-            for item in all_entities
-            if item["id"] not in zou_ids_and_asset_docs.keys()
-        ]
-    )
+    to_insert = [
+        create_op_asset(item)
+        for item in all_entities
+        if item["id"] not in zou_ids_and_asset_docs.keys()
+    ]
     if to_insert:
         # Insert doc in DB
         dbcon.insert_many(to_insert)

From 02cc2166c1ee165b48d697c876675302c8cb77db Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 20 Jul 2022 17:37:19 +0200
Subject: [PATCH 1210/1227] docstring linting line length

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index e0ff87adf7..cabf4e4d18 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -333,9 +333,9 @@ def sync_all_projects(login: str, password: str):
 def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
     """Update OP project in DB with Zou data.
 
-    `root_of` is meant to sort entities by type for a better readability in the data tree. It
-    puts all shot like (Shot and Episode and Sequence) and asset entities under two different root
-    folders or hierarchy, defined in settings.
+    `root_of` is meant to sort entities by type for a better readability in 
+    the data tree. It puts all shot like (Shot and Episode and Sequence) and
+    asset entities under two different root folders or hierarchy, defined in settings.
 
     Args:
         dbcon (AvalonMongoDB): MongoDB connection

From a3144c9d75e3372e1d7a3008f54e2695c81a51d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 20 Jul 2022 17:40:16 +0200
Subject: [PATCH 1211/1227] docstring linting line length

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index cabf4e4d18..46e0fa38f3 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -333,7 +333,7 @@ def sync_all_projects(login: str, password: str):
 def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
     """Update OP project in DB with Zou data.
 
-    `root_of` is meant to sort entities by type for a better readability in 
+    `root_of` is meant to sort entities by type for a better readability in
     the data tree. It puts all shot like (Shot and Episode and Sequence) and
     asset entities under two different root folders or hierarchy, defined in settings.
 

From af45aff844ab2ff28ccc76ec99d3e5a9803c92e2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 20 Jul 2022 17:56:37 +0200
Subject: [PATCH 1212/1227] docstring linting line length

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 46e0fa38f3..7262d2ee1a 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -335,7 +335,8 @@ def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
 
     `root_of` is meant to sort entities by type for a better readability in
     the data tree. It puts all shot like (Shot and Episode and Sequence) and
-    asset entities under two different root folders or hierarchy, defined in settings.
+    asset entities under two different root folders or hierarchy, defined in 
+    settings.
 
     Args:
         dbcon (AvalonMongoDB): MongoDB connection

From 480d1968124ccf4fe2bc70b109145b016292fe25 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20David?= <felixg.david@gmail.com>
Date: Wed, 20 Jul 2022 17:56:55 +0200
Subject: [PATCH 1213/1227] docstring linting line length

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 7262d2ee1a..7bfbd42f6a 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -335,7 +335,7 @@ def sync_project_from_kitsu(dbcon: AvalonMongoDB, project: dict):
 
     `root_of` is meant to sort entities by type for a better readability in
     the data tree. It puts all shot like (Shot and Episode and Sequence) and
-    asset entities under two different root folders or hierarchy, defined in 
+    asset entities under two different root folders or hierarchy, defined in
     settings.
 
     Args:

From 92b611d76aabb35fefb3f34430a9679b5c9b28da Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 21 Jul 2022 09:58:17 +0200
Subject: [PATCH 1214/1227] Raise AttributeError instead of ImportError on
 missing attribute in 'openpype_interfaces'

---
 openpype/modules/base.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/base.py b/openpype/modules/base.py
index b9ccec13cc..1bd343fd07 100644
--- a/openpype/modules/base.py
+++ b/openpype/modules/base.py
@@ -49,6 +49,7 @@ class _ModuleClass(object):
     Object of this class can be stored to `sys.modules` and used for storing
     dynamically imported modules.
     """
+
     def __init__(self, name):
         # Call setattr on super class
         super(_ModuleClass, self).__setattr__("name", name)
@@ -116,12 +117,13 @@ class _InterfacesClass(_ModuleClass):
     - this is because interfaces must be available even if are missing
         implementation
     """
+
     def __getattr__(self, attr_name):
         if attr_name not in self.__attributes__:
             if attr_name in ("__path__", "__file__"):
                 return None
 
-            raise ImportError((
+            raise AttributeError((
                 "cannot import name '{}' from 'openpype_interfaces'"
             ).format(attr_name))
 

From 635164b00c6573396096c72268e71a4a062688ff Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 21 Jul 2022 10:40:39 +0200
Subject: [PATCH 1215/1227] added HiddenCreator description

---
 website/docs/dev_publishing.md | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/website/docs/dev_publishing.md b/website/docs/dev_publishing.md
index 8ee3b7e85f..c949fa8570 100644
--- a/website/docs/dev_publishing.md
+++ b/website/docs/dev_publishing.md
@@ -66,7 +66,7 @@ Another optional function is **get_current_context**. This function is handy in
 Main responsibility of create plugin is to create, update, collect and remove instance metadata and propagate changes to create context. Has access to **CreateContext** (`self.create_context`) that discovered the plugin so has also access to other creators and instances. Create plugins have a lot of responsibility so it is recommended to implement common code per host.
 
 #### *BaseCreator*
-Base implementation of creator plugin. It is not recommended to use this class as base for production plugins but rather use one of **AutoCreator** and **Creator** variants.
+Base implementation of creator plugin. It is not recommended to use this class as base for production plugins but rather use one of **HiddenCreator**, **AutoCreator** and **Creator** variants.
 
 **Abstractions**
 - **`family`** (class attr) - Tells what kind of instance will be created.
@@ -92,7 +92,7 @@ def collect_instances(self):
             self._add_instance_to_context(instance)
 ```
 
-- **`create`** (method) - Create a new object of **CreatedInstance** store its metadata to the workfile and add the instance into the created context. Failed Creating should raise **CreatorError** if an error happens that artists can fix or give them some useful information. Triggers and implementation differs for **Creator** and **AutoCreator**.
+- **`create`** (method) - Create a new object of **CreatedInstance** store its metadata to the workfile and add the instance into the created context. Failed Creating should raise **CreatorError** if an error happens that artists can fix or give them some useful information. Triggers and implementation differs for **Creator**, **HiddenCreator** and **AutoCreator**.
 
 - **`update_instances`** (method) - Update data of instances. Receives tuple with **instance** and **changes**.
 ```python
@@ -199,6 +199,20 @@ class RenderLayerCreator(Creator):
 - **`get_dynamic_data`** (method) - Can be used to extend data for subset templates which may be required in some cases.
 
 
+#### *HiddenCreator*
+Creator which is not showed in UI so artist can't trigger it directly but is available for other creators. This creator is primarily meant for cases when creation should create different types of instances. For example during editorial publishing where input is single edl file but should create 2 or more kind of instances each with different family, attributes and abilities. Arguments for creation were limited to `instance_data` and `source_data`. Data of `instance_data` should follow what is sent to other creators and `source_data` can be used to send custom data defined by main creator. It is expected that `HiddenCreator` has specific main or "parent" creator.
+
+```python
+def create(self, instance_data, source_data):
+    variant = instance_data["variant"]
+    task_name = instance_data["task"]
+    asset_name = instance_data["asset"]
+    asset_doc = get_asset_by_name(self.project_name, asset_name)
+    self.get_subset_name(
+        variant, task_name, asset_doc, self.project_name, self.host_name)
+```
+
+
 #### *AutoCreator*
 Creator that is triggered on reset of create context. Can be used for families that are expected to be created automatically without artist interaction (e.g. **workfile**). Method `create` is triggered after collecting all creators.
 

From a8d99a6f91d8fc44bda465a6a5f3f5425931eb75 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 21 Jul 2022 10:41:56 +0200
Subject: [PATCH 1216/1227] changed imports of 'attribute_deffinitions'

---
 website/docs/dev_publishing.md | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/website/docs/dev_publishing.md b/website/docs/dev_publishing.md
index c949fa8570..5266ece72c 100644
--- a/website/docs/dev_publishing.md
+++ b/website/docs/dev_publishing.md
@@ -172,11 +172,11 @@ class RenderLayerCreator(Creator):
     icon = "fa5.building"
 ```
 
-- **`get_instance_attr_defs`** (method) - Attribute definitions of instance. Creator can define attribute values with default values for each instance. These attributes may affect how instances will be instance processed during publishing. Attribute defiitions can be used from `openpype.pipeline.lib.attribute_definitions` (NOTE: Will be moved to `openpype.lib.attribute_definitions` soon). Attribute definitions define basic types of values for different cases e.g. boolean, number, string, enumerator, etc. Default implementation returns **instance_attr_defs**.
+- **`get_instance_attr_defs`** (method) - Attribute definitions of instance. Creator can define attribute values with default values for each instance. These attributes may affect how instances will be instance processed during publishing. Attribute defiitions can be used from `openpype.lib.attribute_definitions`. Attribute definitions define basic types of values for different cases e.g. boolean, number, string, enumerator, etc. Default implementation returns **instance_attr_defs**.
 - **`instance_attr_defs`** (attr) - Attribute for default implementation of **get_instance_attr_defs**.
 
 ```python
-from openpype.pipeline import attribute_definitions
+from openpype.lib import attribute_definitions
 
 
 class RenderLayerCreator(Creator):
@@ -311,7 +311,8 @@ class BulkRenderCreator(Creator):
 - **`pre_create_attr_defs`** (attr) - Attribute for default implementation of **get_pre_create_attr_defs**.
 
 ```python
-from openpype.pipeline import Creator, attribute_definitions
+from openpype.lib import attribute_definitions
+from openpype.pipeline.create import Creator
 
 
 class CreateRender(Creator):
@@ -484,10 +485,8 @@ Possible attribute definitions can be found in `openpype/pipeline/lib/attribute_
 
 ```python
 import pyblish.api
-from openpype.pipeline import (
-    OpenPypePyblishPluginMixin,
-    attribute_definitions,
-)
+from openpype.lib import attribute_definitions
+from openpype.pipeline import OpenPypePyblishPluginMixin
 
 
 # Example context plugin

From 6d093b92d9db498ab40dbc2b5bdc7a93f7581ebb Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 21 Jul 2022 10:42:12 +0200
Subject: [PATCH 1217/1227] changed queries and access to current session

---
 website/docs/dev_publishing.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/website/docs/dev_publishing.md b/website/docs/dev_publishing.md
index 5266ece72c..f11a2c3047 100644
--- a/website/docs/dev_publishing.md
+++ b/website/docs/dev_publishing.md
@@ -248,14 +248,14 @@ def create(self):
     # - variant can be filled from settings
     variant = self._variant_name
     # Only place where we can look for current context
-    project_name = io.Session["AVALON_PROJECT"]
-    asset_name = io.Session["AVALON_ASSET"]
-    task_name = io.Session["AVALON_TASK"]
-    host_name = io.Session["AVALON_APP"]
+    project_name = self.project_name
+    asset_name = legacy_io.Session["AVALON_ASSET"]
+    task_name = legacy_io.Session["AVALON_TASK"]
+    host_name = legacy_io.Session["AVALON_APP"]
 
     # Create new instance if does not exist yet
     if existing_instance is None:
-        asset_doc = io.find_one({"type": "asset", "name": asset_name})
+        asset_doc = get_asset_by_name(project_name, asset_name)
         subset_name = self.get_subset_name(
             variant, task_name, asset_doc, project_name, host_name
         )
@@ -278,7 +278,7 @@ def create(self):
         existing_instance["asset"] != asset_name
         or existing_instance["task"] != task_name
     ):
-        asset_doc = io.find_one({"type": "asset", "name": asset_name})
+        asset_doc = get_asset_by_name(project_name, asset_name)
         subset_name = self.get_subset_name(
             variant, task_name, asset_doc, project_name, host_name
         )

From dfa6328d74fbbd806769d3689ccc1b2f85dc757e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 21 Jul 2022 11:58:42 +0200
Subject: [PATCH 1218/1227] remove metadata from default environment values

---
 openpype/settings/defaults/system_settings/general.json | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/openpype/settings/defaults/system_settings/general.json b/openpype/settings/defaults/system_settings/general.json
index a06947ba77..909ffc1ee4 100644
--- a/openpype/settings/defaults/system_settings/general.json
+++ b/openpype/settings/defaults/system_settings/general.json
@@ -2,11 +2,7 @@
     "studio_name": "Studio name",
     "studio_code": "stu",
     "admin_password": "",
-    "environment": {
-        "__environment_keys__": {
-            "global": []
-        }
-    },
+    "environment": {},
     "log_to_server": true,
     "disk_mapping": {
         "windows": [],

From 78b4bbadc92ec29167af3487e1b597e07a40f35e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 22 Jul 2022 11:39:22 +0200
Subject: [PATCH 1219/1227] add continuos arguments next to each other

---
 openpype/plugins/publish/extract_review_slate.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 2edaf10e6b..28deb360be 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -295,12 +295,14 @@ class ExtractReviewSlate(openpype.api.Extractor):
             # this will reencode the output
             if input_audio:
                 fmap = [
+                    "-filter_complex",
                     "[0:v] [0:a] [1:v] [1:a] concat=n=2:v=1:a=1 [v] [a]",
                     "-map", '[v]',
                     "-map", '[a]'
                 ]
             else:
                 fmap = [
+                    "-filter_complex",
                     "[0:v] [1:v] concat=n=2:v=1:a=0 [v]",
                     "-map", '[v]'
                 ]
@@ -308,7 +310,6 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 ffmpeg_path,
                 "-i", slate_v_path,
                 "-i", input_path,
-                "-filter_complex",
             ]
             concat_args.extend(fmap)
             if offset_timecode:

From f99f811ddd4194caadd27a481aef766eae2e5727 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 22 Jul 2022 11:39:37 +0200
Subject: [PATCH 1220/1227] add `-y` into base of ffmpeg arguments

---
 openpype/plugins/publish/extract_review_slate.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 28deb360be..90dad00b97 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -308,6 +308,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
                 ]
             concat_args = [
                 ffmpeg_path,
+                "-y",
                 "-i", slate_v_path,
                 "-i", input_path,
             ]
@@ -319,6 +320,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
             # - keep format of output
             if format_args:
                 concat_args.extend(format_args)
+
             # Use arguments from ffmpeg preset
             source_ffmpeg_cmd = repre.get("ffmpeg_cmd")
             if source_ffmpeg_cmd:
@@ -334,7 +336,7 @@ class ExtractReviewSlate(openpype.api.Extractor):
                         concat_args.append(arg)
                         # assumes arg has one parameter
                         concat_args.append(args[indx + 1])
-            concat_args.append("-y")
+
             # add final output path
             concat_args.append(output_path)
 

From fcbf46d345bcef7363bc4f590d476136f478b6ce Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Fri, 22 Jul 2022 14:20:56 +0200
Subject: [PATCH 1221/1227] Add normaal animation

---
 website/src/css/custom.css          |   4 ++--
 website/src/pages/index.js          |  16 ++++++++++------
 website/static/img/logo_normaal.png | Bin 0 -> 13468 bytes
 3 files changed, 12 insertions(+), 8 deletions(-)
 create mode 100644 website/static/img/logo_normaal.png

diff --git a/website/src/css/custom.css b/website/src/css/custom.css
index e8dd86256b..58c9305bc7 100644
--- a/website/src/css/custom.css
+++ b/website/src/css/custom.css
@@ -196,12 +196,12 @@ html[data-theme='dark'] .header-github-link::before {
     padding: 20px
 }
 
-.showcase .client {
+.showcase .studio {
     display: flex;
     justify-content: space-between;
 }
 
-.showcase .client img {
+.showcase .studio img {
     max-height: 110px;
     padding: 20px;
     max-width: 160px;
diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index ae7119e928..52302ec285 100644
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -65,13 +65,17 @@ const collab = [
     image: '/img/clothcat.png',
     infoLink: 'https://www.clothcatanimation.com/'
   }, {
-    title: 'Ellipse Studio',
-    image: '/img/ellipse-studio.png',
-    infoLink: 'http://www.dargaudmedia.com'
+    title: 'Ellipse Animation',
+    image: '/img/ellipse_animation.svg',
+    infoLink: 'http://www.ellipseanimation.com'
   }, {
     title: 'J Cube Inc',
     image: '/img/jcube_logo_bw.png',
     infoLink: 'https://j-cube.jp'
+  }, {
+    title: 'Normaal Animation',
+    image: '/img/logo_normaal.png',
+    infoLink: 'https://j-cube.jp'
   }
 ];
 
@@ -191,10 +195,10 @@ function Service({imageUrl, title, description}) {
   );
 }
 
-function Client({title, image, infoLink}) {
+function Studio({title, image, infoLink}) {
   const imgUrl = useBaseUrl(image);
   return (
-    <a className="client" href={infoLink}>
+    <a className="studio" href={infoLink}>
       <img src={image} alt="" title={title}></img>
     </a>
   );
@@ -490,7 +494,7 @@ function Home() {
               <h2>Studios using openPype</h2>
               <div className="showcase">
                 {studios.map((props, idx) => (
-                  <Client key={idx} {...props} />
+                  <Studio key={idx} {...props} />
                 ))}
               </div>
             </div>
diff --git a/website/static/img/logo_normaal.png b/website/static/img/logo_normaal.png
new file mode 100644
index 0000000000000000000000000000000000000000..711847c9f2f95d77d46d4ab98a9287e5f0ef771d
GIT binary patch
literal 13468
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

literal 0
HcmV?d00001


From 0f135c9b38d52a1f75dffe334b01668f86462d82 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Fri, 22 Jul 2022 14:21:06 +0200
Subject: [PATCH 1222/1227] update Ellipse animation after re-brand

---
 website/static/img/ellipse_animation.svg | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 website/static/img/ellipse_animation.svg

diff --git a/website/static/img/ellipse_animation.svg b/website/static/img/ellipse_animation.svg
new file mode 100644
index 0000000000..c1caaa6726
--- /dev/null
+++ b/website/static/img/ellipse_animation.svg
@@ -0,0 +1,9 @@
+<svg width="168" height="64" viewBox="0 0 168 64" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<rect width="167.226" height="64" fill="url(#pattern0)"/>
+<defs>
+<pattern id="pattern0" patternContentUnits="objectBoundingBox" width="1" height="1">
+<use xlink:href="#image0_414_4035" transform="translate(0 -0.0652128) scale(0.000457754 0.00119607)"/>
+</pattern>
+<image id="image0_414_4035" width="2186" height="1053" xlink:href="data:image/png;base64,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AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABgmf4/FzMslTeAU8wAAAAASUVORK5CYII="/>
+</defs>
+</svg>

From 69246a76b4d6e494c563c828bdfb203fd0e80c44 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Fri, 22 Jul 2022 15:01:31 +0200
Subject: [PATCH 1223/1227] fixing the host condition

---
 openpype/plugins/publish/integrate.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index cfaff4067b..1ddb694f85 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -229,7 +229,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
 
         skip = False
         for item in self.skip_host_families:
-            if item["host"] != host_name:
+            if host_name not in item["host"]:
                 continue
 
             families = set(item["families"])

From abc5c9e69b6cbdd0627d229e7e8294c159cef0e0 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 22 Jul 2022 15:37:10 +0200
Subject: [PATCH 1224/1227] adding codec args for keeping continuity even wtih
 audio stream.

---
 openpype/plugins/publish/extract_review_slate.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/openpype/plugins/publish/extract_review_slate.py b/openpype/plugins/publish/extract_review_slate.py
index 90dad00b97..69043ee261 100644
--- a/openpype/plugins/publish/extract_review_slate.py
+++ b/openpype/plugins/publish/extract_review_slate.py
@@ -321,6 +321,9 @@ class ExtractReviewSlate(openpype.api.Extractor):
             if format_args:
                 concat_args.extend(format_args)
 
+            if codec_args:
+                concat_args.extend(codec_args)
+
             # Use arguments from ffmpeg preset
             source_ffmpeg_cmd = repre.get("ffmpeg_cmd")
             if source_ffmpeg_cmd:

From 4ac8da4ca047363005b1f0638c29584f847c8590 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 22 Jul 2022 18:14:26 +0200
Subject: [PATCH 1225/1227] remove hosts filter on integrator plugins

---
 openpype/plugins/publish/integrate.py        | 4 ----
 openpype/plugins/publish/integrate_legacy.py | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 1ddb694f85..8532691e61 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -104,10 +104,6 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
 
     label = "Integrate Asset"
     order = pyblish.api.IntegratorOrder
-    hosts = ["aftereffects", "blender", "celaction", "flame", "harmony",
-             "hiero", "houdini", "nuke", "photoshop", "resolve",
-             "standalonepublisher", "traypublisher", "tvpaint", "unreal",
-             "webpublisher"]
     families = ["workfile",
                 "pointcache",
                 "camera",
diff --git a/openpype/plugins/publish/integrate_legacy.py b/openpype/plugins/publish/integrate_legacy.py
index 34e81a3839..b90b61f587 100644
--- a/openpype/plugins/publish/integrate_legacy.py
+++ b/openpype/plugins/publish/integrate_legacy.py
@@ -72,10 +72,6 @@ class IntegrateAssetNew(pyblish.api.InstancePlugin):
     label = "Integrate Asset (legacy)"
     # Make sure it happens after new integrator
     order = pyblish.api.IntegratorOrder + 0.00001
-    hosts = ["aftereffects", "blender", "celaction", "flame", "harmony",
-             "hiero", "houdini", "nuke", "photoshop", "resolve",
-             "standalonepublisher", "traypublisher", "tvpaint", "unreal",
-             "webpublisher"]
     families = ["workfile",
                 "pointcache",
                 "camera",

From 5c0f0f260365423128e410712c18c1938e83777b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?=
 <33513211+antirotor@users.noreply.github.com>
Date: Fri, 22 Jul 2022 18:22:48 +0200
Subject: [PATCH 1226/1227] :heavy_minus_sign: remove invalid submodules

---
 vendor/powershell/BurntToast   | 1 -
 vendor/powershell/PSWriteColor | 1 -
 2 files changed, 2 deletions(-)
 delete mode 160000 vendor/powershell/BurntToast
 delete mode 160000 vendor/powershell/PSWriteColor

diff --git a/vendor/powershell/BurntToast b/vendor/powershell/BurntToast
deleted file mode 160000
index ae0acdd870..0000000000
--- a/vendor/powershell/BurntToast
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit ae0acdd870a2fd8d9f0d147de22dc36d6c5e399e
diff --git a/vendor/powershell/PSWriteColor b/vendor/powershell/PSWriteColor
deleted file mode 160000
index 12eda384eb..0000000000
--- a/vendor/powershell/PSWriteColor
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 12eda384ebd7a7954e15855e312215c009c97114

From e69d8e3ac65ee273e7d9a23c4bbd5f741baf01c9 Mon Sep 17 00:00:00 2001
From: OpenPype <info@openpype.io>
Date: Sat, 23 Jul 2022 03:53:23 +0000
Subject: [PATCH 1227/1227] [Automated] Bump version

---
 CHANGELOG.md        | 35 ++++++++++++++++++-----------------
 openpype/version.py |  2 +-
 pyproject.toml      |  2 +-
 3 files changed, 20 insertions(+), 19 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e8da885473..ec880b9c61 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,11 +1,17 @@
 # Changelog
 
-## [3.12.2-nightly.2](https://github.com/pypeclub/OpenPype/tree/HEAD)
+## [3.12.2-nightly.3](https://github.com/pypeclub/OpenPype/tree/HEAD)
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/3.12.1...HEAD)
 
+### 📖 Documentation
+
+- Update website with more studios [\#3554](https://github.com/pypeclub/OpenPype/pull/3554)
+- Documentation: Update publishing dev docs [\#3549](https://github.com/pypeclub/OpenPype/pull/3549)
+
 **🚀 Enhancements**
 
+- Maya: add additional validators to Settings [\#3540](https://github.com/pypeclub/OpenPype/pull/3540)
 - General: Interactive console in cli [\#3526](https://github.com/pypeclub/OpenPype/pull/3526)
 - Ftrack: Automatic daily review session creation can define trigger hour [\#3516](https://github.com/pypeclub/OpenPype/pull/3516)
 - Ftrack: add source into Note [\#3509](https://github.com/pypeclub/OpenPype/pull/3509)
@@ -20,8 +26,15 @@
 
 **🐛 Bug fixes**
 
+- Remove invalid submodules from `/vendor` [\#3557](https://github.com/pypeclub/OpenPype/pull/3557)
+- General: Remove hosts filter on integrator plugins [\#3556](https://github.com/pypeclub/OpenPype/pull/3556)
+- Settings: Clean default values of environments [\#3550](https://github.com/pypeclub/OpenPype/pull/3550)
+- Module interfaces: Fix import error [\#3547](https://github.com/pypeclub/OpenPype/pull/3547)
+- Workfiles tool: Show of tool and it's flags [\#3539](https://github.com/pypeclub/OpenPype/pull/3539)
+- General: Create workfile documents works again [\#3538](https://github.com/pypeclub/OpenPype/pull/3538)
 - Additional fixes for powershell scripts [\#3525](https://github.com/pypeclub/OpenPype/pull/3525)
 - Maya: Added wrapper around cmds.setAttr [\#3523](https://github.com/pypeclub/OpenPype/pull/3523)
+- Nuke: double slate [\#3521](https://github.com/pypeclub/OpenPype/pull/3521)
 - General: Fix hash of centos oiio archive [\#3519](https://github.com/pypeclub/OpenPype/pull/3519)
 - Maya: Renderman display output fix [\#3514](https://github.com/pypeclub/OpenPype/pull/3514)
 - TrayPublisher: Simple creation enhancements and fixes [\#3513](https://github.com/pypeclub/OpenPype/pull/3513)
@@ -31,8 +44,12 @@
 
 **🔀 Refactored code**
 
+- Refactor Integrate Asset [\#3530](https://github.com/pypeclub/OpenPype/pull/3530)
 - General: Client docstrings cleanup [\#3529](https://github.com/pypeclub/OpenPype/pull/3529)
+- General: Get current context document functions [\#3522](https://github.com/pypeclub/OpenPype/pull/3522)
+- Kitsu: Use query function from client [\#3496](https://github.com/pypeclub/OpenPype/pull/3496)
 - TimersManager: Use query functions [\#3495](https://github.com/pypeclub/OpenPype/pull/3495)
+- Deadline: Use query functions [\#3466](https://github.com/pypeclub/OpenPype/pull/3466)
 
 ## [3.12.1](https://github.com/pypeclub/OpenPype/tree/3.12.1) (2022-07-13)
 
@@ -57,7 +74,6 @@
 - Windows installer: Clean old files and add version subfolder [\#3445](https://github.com/pypeclub/OpenPype/pull/3445)
 - Blender: Bugfix - Set fps properly on open [\#3426](https://github.com/pypeclub/OpenPype/pull/3426)
 - Hiero: Add custom scripts menu [\#3425](https://github.com/pypeclub/OpenPype/pull/3425)
-- Blender: pre pyside install for all platforms [\#3400](https://github.com/pypeclub/OpenPype/pull/3400)
 
 **🐛 Bug fixes**
 
@@ -95,34 +111,19 @@
 
 [Full Changelog](https://github.com/pypeclub/OpenPype/compare/CI/3.12.0-nightly.3...3.12.0)
 
-### 📖 Documentation
-
-- Fix typo in documentation: pyenv on mac [\#3417](https://github.com/pypeclub/OpenPype/pull/3417)
-- Linux: update OIIO package [\#3401](https://github.com/pypeclub/OpenPype/pull/3401)
-
 **🚀 Enhancements**
 
 - Webserver: Added CORS middleware [\#3422](https://github.com/pypeclub/OpenPype/pull/3422)
-- Attribute Defs UI: Files widget show what is allowed to drop in [\#3411](https://github.com/pypeclub/OpenPype/pull/3411)
 
 **🐛 Bug fixes**
 
 - NewPublisher: Fix subset name change on change of creator plugin [\#3420](https://github.com/pypeclub/OpenPype/pull/3420)
 - Bug: fix invalid avalon import [\#3418](https://github.com/pypeclub/OpenPype/pull/3418)
-- Nuke: Fix keyword argument in query function [\#3414](https://github.com/pypeclub/OpenPype/pull/3414)
-- Houdini: fix loading and updating vbd/bgeo sequences [\#3408](https://github.com/pypeclub/OpenPype/pull/3408)
-- Nuke: Collect representation files based on Write [\#3407](https://github.com/pypeclub/OpenPype/pull/3407)
-- General: Filter representations before integration start [\#3398](https://github.com/pypeclub/OpenPype/pull/3398)
-- Maya: look collector typo [\#3392](https://github.com/pypeclub/OpenPype/pull/3392)
 
 **🔀 Refactored code**
 
 - Unreal: Use client query functions [\#3421](https://github.com/pypeclub/OpenPype/pull/3421)
 - General: Move editorial lib to pipeline [\#3419](https://github.com/pypeclub/OpenPype/pull/3419)
-- Kitsu: renaming to plural func sync\_all\_projects [\#3397](https://github.com/pypeclub/OpenPype/pull/3397)
-- Houdini: Use client query functions [\#3395](https://github.com/pypeclub/OpenPype/pull/3395)
-- Hiero: Use client query functions [\#3393](https://github.com/pypeclub/OpenPype/pull/3393)
-- Nuke: Use client query functions [\#3391](https://github.com/pypeclub/OpenPype/pull/3391)
 
 ## [3.11.1](https://github.com/pypeclub/OpenPype/tree/3.11.1) (2022-06-20)
 
diff --git a/openpype/version.py b/openpype/version.py
index dd5ad97449..9dda1eacce 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.12.2-nightly.2"
+__version__ = "3.12.2-nightly.3"
diff --git a/pyproject.toml b/pyproject.toml
index 9552242694..eebc8a5600 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.12.2-nightly.2" # OpenPype
+version = "3.12.2-nightly.3" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"